Fastify

WARNING

Fastify plugin is currently in beta. The interface might change before it becomes stable. We encourage you to leave feedback on GitHub.

Fastify is a fast and low overhead web framework for Node.js.

Features

• seamless integration with @hey-api/openapi-ts ecosystem
• type-safe route handlers
• minimal learning curve thanks to extending the underlying technology

Installation

WARNING

To use this feature, you must opt in to the experimental parser.

Assuming you have already created a configuration file, simply add fastify to your plugins and you'll be ready to generate Fastify artifacts. 🎉

import { defaultPlugins } from '@hey-api/openapi-ts';

export default {
  client: '@hey-api/client-fetch',
  experimentalParser: true, 
  input: 'path/to/openapi.json',
  output: 'src/client',
  plugins: [
    ...defaultPlugins,
    'fastify', 
  ],
};

Output

The Fastify plugin will generate the following artifacts, depending on the input specification.

Route Handlers

Route handlers are generated from all endpoints. The generated interface follows the naming convention of SDK functions.

const fastify = Fastify();
const serviceHandlers: RouteHandlers = {
  createPets(request, reply) {
    reply.code(201).send();
  },
  listPets(request, reply) {
    reply.code(200).send([]);
  },
  showPetById(request, reply) {
    reply.code(200).send({
      id: Number(request.params.petId),
      name: 'Kitty',
    });
  },
};
fastify.register(glue, { serviceHandlers });

Examples

You can view live examples on StackBlitz.

Sponsors

Love Hey API? Become our sponsor.

•