fastify

@objectstack/fastify

Fastify plugin for ObjectStack — registers the auto-generated REST API and dispatcher as a Fastify plugin.

Overview

Exposes ObjectStack as a standard Fastify plugin. Auth, storage, GraphQL, and discovery routes are handled explicitly; everything else is served by a catch-all delegating to HttpDispatcher, so protocol evolution does not require adapter changes.

Installation

pnpm add @objectstack/fastify fastify

Quick Start

import Fastify from 'fastify';
import { objectStackPlugin } from '@objectstack/fastify';
import { kernel } from './my-kernel';

const app = Fastify({ logger: true });
await app.register(objectStackPlugin, { kernel, prefix: '/api' });
await app.listen({ port: 3000 });

Decorator mode

import { objectStackDecorator } from '@objectstack/fastify';

app.decorate('objectstack', objectStackDecorator(kernel));

Key Exports

Export	Kind	Description
objectStackPlugin	fastify plugin	Registers all dispatcher routes under prefix.
objectStackDecorator(kernel)	function	Returns a decorator that exposes the dispatcher on the Fastify instance.
FastifyAdapterOptions	interface	{ kernel, prefix? }.

Configuration

Option	Type	Default
kernel	ObjectKernel	—
prefix	string	'/api'

Middleware order

Register the ObjectStack plugin after body parsing, CORS, and authentication preprocessors. Do not enable Fastify's automatic schema validation on ObjectStack routes — the protocol does its own Zod validation.

When to use

• ✅ Fastify applications needing high-throughput APIs.
• ✅ Teams already invested in Fastify's plugin ecosystem.

When not to use

• ❌ Edge / serverless Workers — use @objectstack/hono.

Related Packages

• @objectstack/runtime, @objectstack/rest, @objectstack/core.

Links

• 📖 Docs: https://objectstack.ai/docs
• 📚 API Reference: https://objectstack.ai/docs/references

License

Apache-2.0 © ObjectStack