Koa-Joi-Router Docs Generator V2

Why v2?

This project is based on https://github.com/chuyik/koa-joi-router-docs which does not support latest Joi version.

1. This project uses latest koa-joi-router package. Also this package uses joi-to-swagger.

2. Also we can rename keys, like nullable to be x-nullable. For example for redoc

Example:

1    const spec = generator.generateSpec({
2      info: {
3        title: 'Example API',
4        version: '1.1'
5      },
6      basePath: '/'
7    }, undefined, { 'nullable': 'x-nullable' });

Migration from koa-joi-router-docs

No additional action required, it should be possible just to replace older package.

About the package

A node module for generating Swagger 2.0 JSON definitions from existing koa-joi-router routes.

Preview

Install

1# use npm
2npm install koa-joi-router-docs-v2 --save
3# use yarn
4yarn add koa-joi-router-docs-v2

Example

Visit example/ folder to see the full example.

API

new SwaggerAPI()

Creates a new SwaggerAPI instance.

swaggerAPI.addJoiRouter(router, options)

Add a joi-router instance to the API. The router should already have all its routes set up before calling this method (which pulls the route definitions from the router's .routes property).

Options:

• prefix: Prefix to add to Swagger path (use prefix from JoiRouter if not set)

swaggerAPI.generateSpec(baseSpec, options, renameKeys)

Create a Swagger specification for this API. A base specification should be provided with an info object (containing at least the title and version strings) and any other global descriptions.

baseSpec example:

1{
2  info: {
3    title: 'Example API',
4    version: '1.1'
5  },
6  basePath: '/'
7}

options example:

• defaultResponses: Custom default responses

1  {
2    200: {
3      description: 'Success'
4    }
5  }

renameKeys example:

1  { 'nullable': 'x-nullable' }