eov-handler-adapter v0.1.2

eov-handler-adapter

An adapter for express-openapi-validator to auto-extract OpenAPI defined parameters, simplifying route handlers to (input) => output.

Warning
eov-handler-adapter@^0 will have breaking changes within minor version changes.

Install

npm install eov-handler-adapter

Usage

Create a signature for each api.
This may be generated with openapi-generator. See /samples/templates/apis.mustache

type HelloApi = (args: { name: string; lang: string }) => {
  text: string;
  lang: string;
};

Define handlers along the signature.

import { Handler, HandlerResponse } from "eov-handler-adapter";

const helloHandler: Handler<HelloApi> = async ({ name, lang }) => {
  return HandlerResponse.resolve({ text: `こんにちは、${name}`, lang }, 200);
};

Create routes with EOVHandlerAdapter.

import {
  EOVHandlerAdapter,
  typeScriptNodeGenCoordinator,
} from "eov-handler-adapter";

// `typeScriptNodeGenCoordinator` matches parameter structure to `typescript-node` generator of openapi-generator
// You can also create custom coordinators.
const adapter = new EOVHandlerAdapter(typeScriptNodeGenCoordinator());

module.exports = {
  hello: EOVHandlerAdapter.createController(helloHandler),
};