Skip to content

Create Fastify handlers using Futures

License

Notifications You must be signed in to change notification settings

fluture-js/fluture-fastify

Repository files navigation

Fluture Fastify

Build Status Greenkeeper badge

Create Fastify handlers using Futures from Fluture.

Usage

npm install --save fluture fluture-fastify

Allows using pure functions as Fastify handlers. Expects actions to return Futures and the reply to be decorated with a property locals that will be passed to every action as its second argument.

import {handler, Typed} from 'fluture-fastify';
import {after} from 'fluture';
import createApp from 'fastify';

const app = createApp({logger: true});

const Json = Typed ('application/json; charset=utf-8');
const action = (req, {number}) => after (100, Json (200, number));

app.decorateReply ('locals', {number: 42});
app.get ('/number', handler ('getNumber', action));

app.listen (3000, '0.0.0.0');

API

Responses

A typed response requires status code, some content and the content type. The type defines how the value is serialized. In order to see all the possible combinations see reply.send docs.

Plain text

const Plain = Typed ('text/plain; charset=utf-8');

Plain (200, 'Number 42');

Json

const Json = Typed ('application/json; charset=utf-8');

Json (200, {number: 42});

Stream

const Stream = Typed ('application/octet-stream');

Stream (200, createReadStream ('file', 'utf8'));

A typed response with a custom serializer.

const Proto = Serialized (protoBuf.serialize, 'application/x-protobuf');

Proto (200, new protoBuf ());

A redirection consisting of a URL and the status code.

An empty response with status code 204.

The default NotFound response.

Functions

Creates a Fastify handler from a named action. The action needs to either resolve to a Response or reject with anything. The rejected value will be send as a response with status code 500. The status code can be overwritten by rejecting with an Error that contains the prop statusCode.