express-yaschema-api-handler
TypeScript icon, indicating that this package has built-in type declarations

2.8.3 • Public • Published

express-yaschema-api-handler

Downloads Size

Express support for handling APIs declared using yaschema-api.

Basic Example

// API schema and metadata
// You'll typically define this in a separate package shared by your server and clients
export const postPing = makeHttpApi({
  method: 'POST',
  routeType: 'rest',
  url: '/ping',
  isSafeToRetry: true,
  schemas: {
    request: {
      body: schema.object({
        echo: schema.string().allowEmptyString().optional()
      })
    },
    successResponse: {
      status: schema.number(StatusCodes.OK),
      body: schema.string()
    }
  }
});
// Register the API handler with Express
export const register = (app: Express) =>
  registerHttpApiHandler(app, postPing, {}, async ({ express: _express, input, output }) => {
    output.success(200, { body: (input.body.echo?.length ?? 0) > 0 ? `PONG ${input.body.echo ?? ''}` : 'PONG' });
  });

The options object passed to registerHttpApiHandler lets you override the validation mode and/or specify middleware.

Thanks

Thanks for checking it out. Feel free to create issues or otherwise provide feedback.

API Docs

Be sure to check out our other TypeScript OSS projects as well.

Package Sidebar

Install

npm i express-yaschema-api-handler

Weekly Downloads

18

Version

2.8.3

License

MIT

Unpacked Size

167 kB

Total Files

163

Last publish

Collaborators

  • bwestphal