This package is available since Fedify 1.9.0.
This package provides a simple way to integrate Fedify with Hono.
The integration code looks like this:
import { createFederation } from "@fedify/fedify";
import { federation } from "@fedify/hono";
import { Hono } from "hono";
const fedi = createFederation<string>({
// Omitted for brevity; see the related section for details.
});
const app = new Hono();
app.use(federation(fedi, (ctx) => "context data"));Fedify behaves as a middleware that wraps around the Hono request handler.
The middleware intercepts the incoming HTTP requests and dispatches them to
the appropriate handler based on the request path and the Accept header
(i.e., content negotiation). This architecture allows Fedify and your Hono
application to coexist in the same domain and port.
For example, if you make a request to /.well-known/webfinger Fedify will
handle the request by itself, but if you make a request to /users/alice
(assuming your Hono app has a handler for /users/:handle) with
Accept: text/html header, Fedify will dispatch the request to the Hono app's
appropriate handler for /users/:handle. Or if you define an actor dispatcher
for /users/{handle} in Fedify, and the request is made with
Accept: application/activity+json header, Fedify will dispatch the request to
the appropriate actor dispatcher.
deno add jsr:@fedify/hono # Deno
npm add @fedify/hono # npm
pnpm add @fedify/hono # pnpm
yarn add @fedify/hono # Yarn
bun add @fedify/hono # Bun