Add resource creator

Author: sergeysova

README.md

@@ -5,7 +5,7 @@ Declare your routes
 
 ## Warning!
 
-> That middleware now in development! Do not use it in production (only before v1 release)
+> Now in development! Do not use it in production (only before v1 release)
 
 
 ## Usage example

examples/test.js

@@ -9,6 +9,7 @@ const {
   scope,
   childs,
   resources,
+  resource,
   member,
 } = require('../dist/index')
 
@@ -37,7 +38,8 @@ const router = createRest({}, childs(
     get('foo'),
     member(
       get('bar', noop),
-      post('baz', [authByToken, noop])
+      post('baz', [authByToken, noop]),
+      resource('like', { before: [authByToken], after: [noop] }, Foo)
     )
   ))
 ))

lib/creators/index.js

@@ -5,7 +5,7 @@ export put from './put'
 export patch from './patch'
 export destroy from './destroy'
 export resources from './resources'
-// export resource from './resource'
+export resource from './resource'
 export scope from './scope'
 export member from './member'
 export childs from './childs'

lib/creators/resource.js

@@ -0,0 +1,71 @@
+import pluralize from 'pluralize'
+import { addRoute, createContext, addChildContext } from '../context'
+
+
+/**
+ * @typedef {Object} ResourceConfig
+ * @property {string[]} [only]            Create only that routes
+ * @property {string[]} [except]          That routes that will not be created
+ * @example
+ * { only: ['index', 'create'] }
+ * { except: ['update', 'destroy'] }
+ */
+
+
+
+const routes = [
+  ['index', 'GET'],
+  ['create', 'POST'],
+  ['update', 'PUT'],
+  ['destroy', 'DELETE'],
+]
+
+const defaultConfig = {
+}
+
+/**
+ * Creates a set of routes that describe single resource
+ * @param {string} name                         Base name in lowercase. From name a path will be created.
+ * @param {ResourceConfig} configuration        Setup for resource
+ * @param {Object} controller                   Object with handlers
+ * @param {Function} [createChilds]             Childs will be added to resource root
+ * @example
+ * resource('profile', {}, ProfileController)
+ */
+export default function resource(name, configuration, controller, createChilds) {
+  const config = Object.assign({}, defaultConfig, configuration)
+  const insetContext = createContext(name)
+  let targetRoutes = routes.concat([])
+
+  insetContext.controller = controller
+
+  if (config.only) {
+    targetRoutes = routes.filter(route => config.only.includes(route[0]))
+  }
+  else if (config.except) {
+    targetRoutes = routes.filter(route => !config.only.includes(route[0]))
+  }
+
+  targetRoutes.forEach(([methodName, httpMethod]) => {
+    const method = controller[methodName]
+    let handlers = []
+
+    if (config.before) {
+      handlers = handlers.concat(config.before)
+    }
+
+    handlers.push(method)
+
+    if (config.after) {
+      handlers = handlers.concat(config.after)
+    }
+
+    addRoute(httpMethod, '', handlers)(insetContext)
+  })
+
+  if (createChilds) {
+    createChilds(insetContext)
+  }
+
+  return addChildContext(insetContext)
+}

lib/index.js

@@ -1,6 +1,7 @@
 import { createContext } from './context'
 
 /**
+ * Defines your routes
  *
  * @param {Object} config Root configuration
  * @param {Function} applyRoot Main childs for root `childs()`
@@ -27,5 +28,6 @@ export {
   destroy,
   scope,
   resources,
+  resource,
   member,
 } from './creators'