express-crud

Easily route a resource's crud methods to express apps!

##Example Here's a User resource that exposes some CRUD methods:

1module.exports = {
2  create:   function(query, model, cb){
3  ....
4  cb(null, ["create"]); //first argument is response status, second is array of response data
5  },
6  delete:   function(id, query, cb){},
7  read:     function(query, cb){},
8  readById: function(id, query, cb){},
9  update:   function(id, query, model, cb){}
10};

Here's how you add the routes to your express app:

1var app = require('express')();
2var User = require('./models/User');
3
4require('express-crud')(app);
5
6app.crud('users', User);

Here's how you add the routes to your express app using a formatted response object:

1var app = require('express')();
2var User = require('./models/User');
3var opts = {
4	formatResponse: function(result) {
5		return {
6			timestamp: Date.now(),
7			payload: result
8		};
9	}
10};
11
12require('express-crud')(app, opts);
13
14app.crud('users', User);

Now your express app has the following routes:

DELETE /users/:id
GET /users
GET /users/:id
POST /users
PUT /users/:id

Changing the param name

You can change the param name by specifying it at the end of your route:

1app.crud('users/:userId', User);

Now your express app has the following routes:

DELETE /users/:userId
GET /users
GET /users/:userId
POST /users
PUT /users/:userId

###With some middleware

1var authorizeMiddleware = function(req, res, next){//arity matters!
2  if(req.query.username !== 'foo')return next(new Error('user not foo!'));
3  next();
4};
5var fooMiddleware = function(req, res, next){next();};
6
7app.crud('users', authorizeMiddleware, fooMiddleware, User);

Restrict access to resources by user

1app.crud('settings/:settingId', authorizeMiddleware, function(req, res, next){
2  //ensure that the resource get's the username.
3  req.query.username = req.user.name;
4  next();
5}, SettingsResource);

Format your response

With any path

1app.crud('/any/old/path/for/users', User);

Status Codes

When you call the callback given to resource methods without an error object as the first arg, express-crud will use either 204 or 200 depending on the context. If you wish to pass a non 2xx status code up to your application the preferred way is to assign a status property to your error object I.E. cb({status: 404}).