Pitico

Pitico is a tiny wrapper for the Node.js standard library http module.

It is intended for writing really small internal API servers where all you need is moving JSON payloads in and out, and think even Fastify might be overkill for your needs. It is of course inspired by Fastify, and offers a very limited degree of compatibility at the moment.

Features

• Ergonomic API for defining JSON endpoints
  • Along with their request and response schemas
  • Using jsontypedef under the hood for setting types
• Minimal compatibility with Fastify plugins
  • register() works but will completely ignore encapsulation
  • decorate() extends the server instance
  • decorateRequest() extends http.IncomingMessage directly
  • inject() behaves the same way for testing
• Ajv-optimized JSON parsing and validation based on JTD schemas
• Ajv-optimized JSON serialization based on JTD schemas

Limitations

It is a radically minimal server so a few contraints are embraced:

• Only JSON request payloads supported.
• No URL parsing, routing is just absolute paths in a Map.

Install

npm i pitico --save

Usage

Bootstrap: server.js

import Pitico from 'pitico'

import * as serialize from './serialize.js'

const server = Pitico([serialize])

await server.listen({ port: 3000 })

Route: serialize.js

export const path = '/serialize'

export default (server, { object, string }) => ({
  parse: object({
    foobar: string()
  }),
  serialize: object({
    foobar: string(),
  }),
  handle (req, res) {
    return {
      foobar: req.body.foobar,
    }
  },
})

See jsontypedef for the full list of helpers available for defining JTD types.

License

MIT