koa-66

Router middleware for koa v2.

feedbacks are welcome

Features

• Plugin middleware support
• Express like http verbs methods (including all)
• Express like use function
• Express like param function
• Automatic OPTIONS response
• Automatic HEAD when GET is present
• 501 and 405 status (throw capability with headers)
• Mount instance on specific path
• Multiple middleware as arguments
• Multiple middleware as array

Installation

# with npm 
$ npm install koa-66
 
$ with yarn
$ yarn add koa-66

Example

const Koa = require('koa');
const Router = require('koa-66');
const app = new Koa();
 
const router = new Router();
const mainRouter  = new Router();
 
router.param('id', (ctx, next, id) => {
        ctx.yolo = id;
        return next();
});
 
router.use(async function(ctx, next) {
    ctx.a = " ";
    await next();
});
 
router.get('/:id', (ctx, next) => {
    return next().then(() => {
        ctx.body += ctx.a + ctx.yolo;
   })
});
 
router.get('/:id', async function(ctx) {
    ctx.body = await Promise.resolve('hello');
});
 
mainRouter.mount('/pouet', router);
 
app.use(mainRouter.routes());
 
app.listen(1664);
// GET http://localhost:1664/pouet/world
// => hello world

Example with throw option

const Koa = require('koa');
const Router = require('koa-66');
const app = new Koa();
 
const router = new Router();
 
app.use(async function(ctx, next) {
    try {
        await next();
    }catch(e){
        if (e.status === 405) {
            ctx.status = 405;
            ctx.set(e.headers);
        }
    }
})
 
router.get('/', (ctx) => ctx.body = 'hello');
 
app.use(router.routes({throw: true}));
 
app.listen(1664);
 
// > curl http://localhost:1664/ -I -X POST
//
// HTTP/1.1 405 Method Not Allowed
// allow: HEAD, GET
// Content-Type: text/plain; charset=utf-8
// Content-Length: 18
// Date: Wed, 04 Nov 2015 10:29:06 GMT
// Connection: keep-alive
 

Plugin support

I don't know if Plugin is a good term for this feature. The goal was to add cappability to register some middleware on a main Router that will be inject via config object on different route. (ex: authentication or acl behaviour). Why? Because I am lazy to require some middleware in all my router script with generaly relatif path...

So I decided to add the possibility to inject an object at first parameter (that will be a config object) and adding an extra middleware that will be inject in middleware stack. To register this plugin just use a plugin()method.

const Router = require('koa-66');
const main = new Router();
 
// you can use multiple middleware as arguments or array
main.plugin('authent', (ctx, next) => {
    // pick plugin config object on ctx.state.plugins.
    // here ctx.state.plugins.authent === true;
    // do stuff inject user on context for example
    return next();
    //or throw or do nothing that will stop execution of router stack
})
 
main.plugin('acl', (ctx, next) => {
    // here ctx.state.plugins.acl === ['admin'];
    // do stuff check role via ctx.state.plugins.acl for example
    return next();
    //or throw or do nothing that will stop execution of router stack
})
 
const router = new Router();
 
router.use({authent: true});
//options here is a boolean,
//but you can pass everything you want,
//and it will be inject as options
 
router.get('/private', {acl:['admin']}, 
    ctx => ctx.body = 'private'
)
 
main.mount('/api', router);
...	
// order of call /api/private
// 1 plugin authent
// 2 plugin acl
// 3 real middleware 
 

Test

# npm test