Koa Handler

Configure a koa server with a provided configuration

Install

$ npm install koa-handler

Features

• Reuse configuration across projects (router, middleware, etc) with custom presets
• Automatically inject middlewares, context and routes to your server

Usage

const Koa = require('koa');
const serverLoader = require("koa-handler")(Koa);

// your own configuration
const { router1, router2 } = require("./modules/routers");
const db = require("./modules/db");
const preset1 = require("./modules/preset1");
const preset2 = require("./modules/preset2");

// configuration
const server_config = {
  routers: [router1, router2],
  ctx: { db }, // optional
  presets: [preset1, preset2] // optional
};

const server = serverLoader(server_config);

//  HTTP server listening
server.listen(config.SERVER_PORT, () => {
  console.info(`Server listening at ${config.SERVER_PORT}`);
});

Create a preset

• A preset is nothing else than returning a object.
• The returned object can have three type of fields :
  • routers: an array of koa routers
  • middlewares: an array of koa middlewares
  • ctx: A Koa context object
  • all these fields are optional

example :

const dummyPreset = () => ({
  ctx: { dummy: "dummy example" }
});

API

koaHandler(config) ⇒ Object

Configure a koa server with a provided configuration

Returns: Object - configured Koa server ready to by started

Param	Type	Default	Description
Koa	Object		Koa builder
config	Object		config object
[config.routers]	Object[]	[]	koa routers
[config.middleware]	Object[]	[]	koa middlewares
[config.ctx]	Object[]	[]	Items that must be added into koa context
[config.presets]	Object[]	[]	preconfigured set of middleware, routers and ctx

License

MIT © saxjst