hono

@objectstack/hono

Hono adapter for ObjectStack — edge-compatible REST API server for Cloudflare Workers, Deno, Bun, Vercel Edge, and Node.

Overview

Creates a ready-to-serve Hono app that routes all ObjectStack traffic through HttpDispatcher. Built-in CORS with wildcard origin pattern support (https://*.example.com, http://localhost:*), compatible with better-auth bearer token rotation (automatically exposes set-auth-token).

Installation

pnpm add @objectstack/hono hono

Quick Start

import { createHonoApp } from '@objectstack/hono';
import { kernel } from './my-kernel';

const app = createHonoApp({
  kernel,
  prefix: '/api',
  cors: {
    origin: ['https://app.example.com', 'https://*.example.com'],
    credentials: true,
  },
});

export default app; // Cloudflare Workers / Bun / Deno / Vercel Edge

Embed into an existing Hono app

import { Hono } from 'hono';
import { objectStackMiddleware } from '@objectstack/hono';

const app = new Hono();
app.use('/api/*', objectStackMiddleware(kernel));

Key Exports

Export	Kind	Description
createHonoApp(options)	function	New Hono instance with dispatcher + CORS installed.
objectStackMiddleware(kernel)	function	Reusable middleware for existing Hono apps.
ObjectStackHonoOptions	interface	Root options with kernel, prefix, cors.
ObjectStackHonoCorsOptions	interface	CORS configuration.

Configuration

Option	Type	Default	Notes
kernel	ObjectKernel	—	Bootstrapped kernel.
prefix	string	'/api'	Base path.
cors	ObjectStackHonoCorsOptions | false	Enabled	Set to false to disable.
cors.origin	string | string[]	env CORS_ORIGIN or '*'	Supports wildcard patterns.
cors.credentials	boolean	false	Required for cookie sessions.
cors.exposeHeaders	string[]	['set-auth-token'] merged	Always includes set-auth-token for better-auth.

Edge runtime notes

• Hono adapter is the preferred adapter for Cloudflare Workers, Deno Deploy, Bun, and Vercel Edge.
• Drivers differ by runtime: use @objectstack/driver-turso on edge; @objectstack/driver-sql on Node.
• Persist no long-lived state in module scope beyond the kernel instance.

When to use

• ✅ Edge, serverless, and multi-runtime deployments.
• ✅ Projects wanting built-in CORS with wildcard patterns.

When not to use

• ❌ Existing Express app — use @objectstack/express.
• ❌ NestJS enterprise stacks — use @objectstack/nestjs.

Related Packages

• @objectstack/plugin-hono-server — optional plugin that hosts a Hono server inside the kernel.
• @objectstack/runtime, @objectstack/rest.

Links

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

License

Apache-2.0 © ObjectStack