Pitico NPM | npm.io

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.