Koa port of the popular express-openapi-validator library. See Intention

Intention

I was looking for a OpenAPI validation middleware solution for Koa. However, I was unable to find anything that (a) had the required functionality and (b) was actively maintained. Therefore, I wrote this library as a port to the popular express-openapi-validator which satisfies the requirements and with which I have worked before.

This does come with some drawbacks as the solution used in express-openapi-validator has been tailored for express and thus is not useable as koa-openapi-validator shows.

If there is any solution for Koa that is sufficient, I would recommend using this instead of this.

Usage

This library should be integrated as a normal Koa middleware. Error-Handling and everything else should be done the normal "Koa way".

1. Install the library

1npm i koa-x-oapi-validator

2. Initialize the middleware

1const validator = new KoaOpenAPIValidator({
2  apiSpec: OPENAPI_SPEC,
3  validateRequests: true,
4  validateResponses: true,
5});
6const validatorMw = validator.use();

3. Use the middleware

1router.post('/hello', validatorMw, async (ctx: Koa.Context) => {
2  ctx.status = 200;
3  ctx.body = {
4    message: 'Hello World!',
5  };
6});

Debugging

To enable debug logging set the environment variable DEBUG=validator.* (see debug).