Hono

Void handlers run on Hono. Void depends on Hono internally, but if your app imports from hono/* directly, add hono to your app's dependencies first.

npm install hono

Once hono is installed in your app, you can use built-in middleware, helpers, and third-party Hono packages directly.

Built-in Middleware

Use Hono's built-in middleware in your global middleware files or per-route:

// middleware/01.cors.ts
import { defineMiddleware } from 'void';
import { cors } from 'hono/cors';

export default defineMiddleware(cors({ origin: 'https://example.com' }));

// middleware/02.cache.ts
import { defineMiddleware } from 'void';
import { cache } from 'hono/cache';

export default defineMiddleware(cache({ cacheName: 'my-app', cacheControl: 'max-age=3600' }));

// routes/api/webhooks/stripe.ts (per-route usage)
import { defineHandler } from 'void';
import { bearerAuth } from 'hono/bearer-auth';

export const POST = defineHandler(bearerAuth({ token: 'webhook-secret' }), async (c) => {
  const body = await c.req.json();
  return { received: true };
});

Response Helpers

Hono's context helpers are available on c in every handler:

// routes/api/download.ts
import { defineHandler } from 'void';
import { stream } from 'hono/streaming';

export const GET = defineHandler((c) => {
  return stream(c, async (stream) => {
    await stream.write('chunk 1');
    await stream.write('chunk 2');
  });
});

// routes/api/data.ts
import { defineHandler } from 'void';

export const GET = defineHandler((c) => {
  c.header('X-Custom', 'value');
  c.status(201);
  return c.json({ created: true });
});

Third-party Middleware

Any hono/* or @hono/* package works. Install the package in your app, then use it directly:

// middleware/01.rate-limit.ts
import { defineMiddleware } from 'void';
import { rateLimiter } from 'hono-rate-limiter';

export default defineMiddleware(rateLimiter({ windowMs: 60_000, limit: 100 }));

Utilities

Hono's standalone helpers work anywhere:

import { HTTPException } from 'hono/http-exception';

// Throw typed HTTP errors
throw new HTTPException(404, { message: 'User not found' });

For the full list of built-in middleware, see the Hono documentation.