feathers-rest/lib/wrappers.js

The Feathers REST API provider

'use strict';

Object.defineProperty(exports, "__esModule", {
  value: true
});

var _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; };

var _debug = require('debug');

var _debug2 = _interopRequireDefault(_debug);

var _feathersErrors = require('feathers-errors');

var _feathersErrors2 = _interopRequireDefault(_feathersErrors);

var _feathersCommons = require('feathers-commons');

function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }

var debug = (0, _debug2.default)('feathers:rest');
var hookObject = _feathersCommons.hooks.hookObject;
var statusCodes = {
  created: 201,
  noContent: 204,
  methodNotAllowed: 405
};
var methodMap = {
  find: 'GET',
  get: 'GET',
  create: 'POST',
  update: 'PUT',
  patch: 'PATCH',
  remove: 'DELETE'
};
var allowedMethods = function allowedMethods(service) {
  return Object.keys(methodMap).filter(function (method) {
    return typeof service[method] === 'function';
  }).map(function (method) {
    return methodMap[method];
  })
  // Filter out duplicates
  .filter(function (value, index, list) {
    return list.indexOf(value) === index;
  });
};

// A function that returns the middleware for a given method and service
// `getArgs` is a function that should return additional leading service arguments
function getHandler(method, getArgs, service) {
  return function (req, res, next) {
    res.setHeader('Allow', allowedMethods(service).join(','));

    // Check if the method exists on the service at all. Send 405 (Method not allowed) if not
    if (typeof service[method] !== 'function') {
      debug('Method \'' + method + '\' not allowed on \'' + req.url + '\'');
      res.status(statusCodes.methodNotAllowed);
      return next(new _feathersErrors2.default.MethodNotAllowed('Method `' + method + '` is not supported by this endpoint.'));
    }

    var params = _extends({}, req.params || {});
    delete params.__feathersId;

    // Grab the service parameters. Use req.feathers and set the query to req.query
    params = _extends({ query: req.query || {} }, params, req.feathers);

    // Run the getArgs callback, if available, for additional parameters
    var args = getArgs(req, res, next);

    // The service success callback which sets res.data or calls next() with the error
    var callback = function callback(error, data) {
      var hookArgs = args.concat([params, callback]);

      if (error) {
        debug('Error in REST handler: `' + (error.message || error) + '`');
        res.hook = hookObject(method, 'error', hookArgs);
        return next(error);
      }

      res.data = data;
      res.hook = hookObject(method, 'after', hookArgs);

      if (!data) {
        debug('No content returned for \'' + req.url + '\'');
        res.status(statusCodes.noContent);
      } else if (method === 'create') {
        res.status(statusCodes.created);
      }

      return next();
    };

    debug('REST handler calling `' + method + '` from `' + req.url + '`');
    service[method].apply(service, args.concat([params, callback]));
  };
}

// Returns no leading parameters
function reqNone() {
  return [];
}

// Returns the leading parameters for a `get` or `remove` request (the id)
function reqId(req) {
  return [req.params.__feathersId || null];
}

// Returns the leading parameters for an `update` or `patch` request (id, data)
function reqUpdate(req) {
  return [req.params.__feathersId || null, req.body];
}

// Returns the leading parameters for a `create` request (data)
function reqCreate(req) {
  return [req.body];
}

// Returns wrapped middleware for a service method.
// Doing some fancy ES 5 .bind argument currying for .getHandler()
// Basically what you are getting for each is a function(service) {}
exports.default = {
  find: getHandler.bind(null, 'find', reqNone),
  get: getHandler.bind(null, 'get', reqId),
  create: getHandler.bind(null, 'create', reqCreate),
  update: getHandler.bind(null, 'update', reqUpdate),
  patch: getHandler.bind(null, 'patch', reqUpdate),
  remove: getHandler.bind(null, 'remove', reqId)
};
module.exports = exports['default'];