@uscreen.de/fastify-app NPM

fastify-app

Opinionated feature pack (of packages) to bootstrap a fastify app

Features

decorates your app with name, version and root-path read from package.json
decorates your app with any given config
provides OpenAPI 3.0 docs by use of @fastify/swagger
enables extra security headers as provided by helmet @fastify/helmet
provides extra sensible defaults provided by @fastify/sensible
uses @fastify/autoload to load plugins, models, services, whatever from configurable directories
provides monitoring healthcheck endpoint by use of under-pressure

All those features are ready setup with defaults, that may be customized further to your likings.

Get Started (cli)

Easy start by yarn create cli command to create a new fastify-app from scratch instead of manually setting up a new fastify instance, like so:

$ yarn create @uscreen.de/fastify-app new-app

and follow instructions. It will create a directory called new-app inside the current folder. Inside that directory, it will generate the initial project structure and install any dependencies:

new-app
├── Makefile
├── README.md
├── app
│   ├── app.js
│   ├── config.js
│   ├── plugins
│   │   └── noop.js
│   ├── schemas.js
│   ├── server.js
│   └── services
│       └── noop.js
├── package.json
├── pm2-dev.config.js
├── pm2.config.js
├── test
│   ├── helper.js
│   └── noop.test.js
└── yarn.lock

Install (manual)

$ yarn add @uscreen.de/fastify-app # or use npm -i

Example (manual)

Minimal example:

import defaultApp from '@uscreen.de/fastify-app'

// register with defaults
fastify.register(defaultApp)

With default server options for logging, etc.

import Fastify from 'fastify'
import defaultApp, { options } from '@uscreen.de/fastify-app'

// create fastify instance with default options
const fastify = Fastify(options())

// register with defaults
fastify.register(defaultApp)

This enables all default features and exposes some extra routes, like:

GET /documentation - autogenerated OpenAPI 3.0 documentation of all endpoint
GET /status - healthcheck endpoint return HTTP 200 {"status":"ok"}

Options

All options get validated and defaulted to a defined json-schema you can check in config.js Overview of options:

option	Description	Default	Example
autoloads	array of directories @fastify/autoload should load your fastify plugins from. Please consider reading Loading order of your plugins	`[]`	`['./plugins', './services']`
swagger	object configuring @fastify/swagger to generate Swagger2/OpenAPI3 docs from your routes	`{exposeRoute: true, openapi:{}}`	`{exposeRoute: '/docs'}`
health (alias: `healthCheck`)	object configuring under-pressure to provide a monitoring healthcheck route for your app	`{exposeStatusRoute: true}`	`{exposeStatusRoute: '/health'}`
contentSecurityPolicy	object configuring helmet to set CSR headers on each response	`{contentSecurityPolicy: false}`	`{contentSecurityPolicy: {directives: {defaultSrc: ["'self'"]}}}`

Howto add custom healthchecks

decorate your healthCheck option with a custom function returning truthy on success, ie.:

import fastifyApp from '@uscreen.de/fastify-app'
import fp from 'fastify-plugin'
import schemas from './schemas.js'

export default fp(async (fastify, opts, next) => {
  /**
   * add schemas
   */
  fastify.register(schemas)

  /**
   * configure healthcheck
   */
  opts.healthCheck = {
    ...opts.healthCheck,

    healthCheck: async () => {
      /**
       * check for proper mongo conenction
       */
      const collections = await fastify.mongo.db.collections()

      /**
       * check for proper nats connection
       */
      const natsConnected = await fastify.nats.testConnection()

      /**
       * check for proper redis connection
       */
      const redisConnected = await fastify.redis.ping()

      /**
       * true if all tests passed
       */
      return collections && natsConnected && redisConnected && true
    }
  }

  /**
   * register app
   */
  fastify.register(fastifyApp, opts)

  next()
})