Create @fedify/nuxt with GPT-5.3-codex in one-shot

Author: 2chanhaeng

.hongdown.toml

@@ -28,6 +28,7 @@ proper_nouns = [
   "@fedify/koa",
   "@fedify/mysql",
   "@fedify/nestjs",
+  "@fedify/nuxt",
   "@fedify/postgres",
   "@fedify/redis",
   "@fedify/solidstart",

AGENTS.md

@@ -89,6 +89,7 @@ for the complete package list.
 
  -  *packages/init/*: Project initializer (`@fedify/init`) for Fedify.
     Separated from `@fedify/cli` to enable standalone use.
+ -  *packages/nuxt/*: Nuxt integration (`@fedify/nuxt`) for Fedify.
  -  *packages/create/*: Standalone CLI (`@fedify/create`)
     for creating new Fedify projects via `npm init @fedify`.
  -  *docs/*: Documentation built with VitePress (see *docs/README.md*)
@@ -329,7 +330,8 @@ The monorepo uses different build processes for different packages:
 3.  **Database adapters and integrations**: Use tsdown for TypeScript compilation:
      -  *packages/amqp/*, *packages/astro/*, *packages/elysia*,
         *packages/express/*, *packages/h3/*,
-        *packages/mysql/*, *packages/sqlite/*, *packages/postgres/*,
+        *packages/mysql/*, *packages/nuxt/*, *packages/sqlite/*,
+        *packages/postgres/*,
         *packages/redis/*, *packages/nestjs/*
      -  Built to support Node.js and Bun environments
 

CHANGES.md

@@ -47,6 +47,18 @@ To be released.
 [#601]: https://github.com/fedify-dev/fedify/pull/601
 [#652]: https://github.com/fedify-dev/fedify/pull/652
 
+### @fedify/nuxt
+
+ -  Added `@fedify/nuxt` package for integrating Fedify with [Nuxt].
+    It provides a Nuxt module that delegates non-federation requests to Nuxt,
+    supports shared-route content negotiation, and returns deferred
+    `406 Not acceptable` when Fedify routes are requested without
+    ActivityPub-compatible `Accept` headers and Nuxt has no matching page.
+    [[#149] by ChanHaeng Lee]
+
+[Nuxt]: https://nuxt.com/
+[#149]: https://github.com/fedify-dev/fedify/issues/149
+
 ### @fedify/init
 
  -  Fixed errors when using `fedify init` with certain web framework

CONTRIBUTING.md

@@ -392,6 +392,7 @@ The repository is organized as a monorepo with the following packages:
  -  *packages/mysql/*: MySQL/MariaDB drivers (@fedify/mysql) for Fedify.
  -  *packages/nestjs/*: NestJS integration (@fedify/nestjs) for Fedify.
  -  *packages/next/*: Next.js integration (@fedify/next) for Fedify.
+ -  *packages/nuxt/*: Nuxt integration (@fedify/nuxt) for Fedify.
  -  *packages/postgres/*: PostgreSQL drivers (@fedify/postgres) for Fedify.
  -  *packages/redis/*: Redis drivers (@fedify/redis) for Fedify.
  -  *packages/relay/*: ActivityPub relay support (@fedify/relay) for Fedify.

cspell.json

@@ -77,6 +77,8 @@
     "multitenancy",
     "Nexkey",
     "nodeinfo",
+    "nuxi",
+    "nuxt",
     "optique",
     "phensley",
     "Pico",

deno.json

@@ -17,6 +17,7 @@
     "./packages/koa",
     "./packages/lint",
     "./packages/mysql",
+    "./packages/nuxt",
     "./packages/postgres",
     "./packages/redis",
     "./packages/relay",

deno.lock

@@ -4,6 +4,8 @@ description: >-
   explains how to integrate Fedify with web frameworks.
 ---
 
+<!-- deno-fmt-ignore-file -->
+
 Integration
 ===========
 
@@ -359,6 +361,76 @@ app.use(router);
 [TanStack Start]: https://tanstack.com/start
 
 
+Nuxt
+----
+
+_This API is available since Fedify 2.2.0._
+
+[Nuxt] is a full-stack framework built on [Nitro] and [Vue]. The _@fedify/nuxt_
+package provides a Nuxt module that wires Fedify into Nitro middleware and
+performs deferred `406 Not Acceptable` handling for content negotiation:
+
+::: code-group
+
+~~~~ sh [Deno]
+deno add jsr:@fedify/nuxt
+~~~~
+
+~~~~ sh [npm]
+npm add @fedify/nuxt
+~~~~
+
+~~~~ sh [pnpm]
+pnpm add @fedify/nuxt
+~~~~
+
+~~~~ sh [Yarn]
+yarn add @fedify/nuxt
+~~~~
+
+~~~~ sh [Bun]
+bun add @fedify/nuxt
+~~~~
+
+:::
+
+Create your federation instance in _server/federation.ts_:
+
+~~~~ typescript
+import { createFederation, MemoryKvStore } from "@fedify/fedify";
+
+const federation = createFederation({
+  kv: new MemoryKvStore(),
+});
+
+export default federation;
+~~~~
+
+Then enable the module in _nuxt.config.ts_:
+
+~~~~ typescript
+export default defineNuxtConfig({
+  modules: ["@fedify/nuxt"],
+});
+~~~~
+
+By default, _@fedify/nuxt_ loads the federation instance from
+`~/server/federation`. You can customize module paths using `fedify` options:
+
+~~~~ typescript
+export default defineNuxtConfig({
+  modules: ["@fedify/nuxt"],
+  fedify: {
+    federationModule: "~/server/federation",
+    contextDataFactoryModule: "~/server/fedify-context",
+  },
+});
+~~~~
+
+[Nuxt]: https://nuxt.com/
+[Vue]: https://vuejs.org/
+
+
 SvelteKit
 ---------
 

docs/manual/integration.md

@@ -112,6 +112,7 @@ Here is the list of packages:
 | [@fedify/lint](/packages/lint/)                   | [JSR][jsr:@fedify/lint]          | [npm][npm:@fedify/lint]          | Linting utilities                        |
 | [@fedify/nestjs](/packages/nestjs/)               |                                  | [npm][npm:@fedify/nestjs]        | NestJS integration                       |
 | [@fedify/next](/packages/next/)                   |                                  | [npm][npm:@fedify/next]          | Next.js integration                      |
+| [@fedify/nuxt](/packages/nuxt/)                   | [JSR][jsr:@fedify/nuxt]          | [npm][npm:@fedify/nuxt]          | Nuxt integration                         |
 | [@fedify/mysql](/packages/mysql/)                 | [JSR][jsr:@fedify/mysql]         | [npm][npm:@fedify/mysql]         | MySQL/MariaDB driver                     |
 | [@fedify/postgres](/packages/postgres/)           | [JSR][jsr:@fedify/postgres]      | [npm][npm:@fedify/postgres]      | PostgreSQL driver                        |
 | [@fedify/redis](/packages/redis/)                 | [JSR][jsr:@fedify/redis]         | [npm][npm:@fedify/redis]         | Redis driver                             |
@@ -155,6 +156,8 @@ Here is the list of packages:
 [npm:@fedify/lint]: https://www.npmjs.com/package/@fedify/lint
 [npm:@fedify/nestjs]: https://www.npmjs.com/package/@fedify/nestjs
 [npm:@fedify/next]: https://www.npmjs.com/package/@fedify/next
+[jsr:@fedify/nuxt]: https://jsr.io/@fedify/nuxt
+[npm:@fedify/nuxt]: https://www.npmjs.com/package/@fedify/nuxt
 [jsr:@fedify/mysql]: https://jsr.io/@fedify/mysql
 [npm:@fedify/mysql]: https://www.npmjs.com/package/@fedify/mysql
 [jsr:@fedify/postgres]: https://jsr.io/@fedify/postgres

packages/fedify/README.md

@@ -0,0 +1,105 @@
+<!-- deno-fmt-ignore-file -->
+
+@fedify/nuxt: Integrate Fedify with Nuxt
+========================================
+
+[![JSR][JSR badge]][JSR]
+[![npm][npm badge]][npm]
+[![Matrix][Matrix badge]][Matrix]
+[![Follow @fedify@hollo.social][@fedify@hollo.social badge]][@fedify@hollo.social]
+
+This package provides a simple way to integrate [Fedify] with [Nuxt].
+
+Supported framework versions:
+
+ -  Nuxt 4.x
+ -  Nitro 2.x (Nuxt 4 runtime)
+
+[JSR badge]: https://jsr.io/badges/@fedify/nuxt
+[JSR]: https://jsr.io/@fedify/nuxt
+[npm badge]: https://img.shields.io/npm/v/@fedify/nuxt?logo=npm
+[npm]: https://www.npmjs.com/package/@fedify/nuxt
+[Matrix badge]: https://img.shields.io/matrix/fedify%3Amatrix.org
+[Matrix]: https://matrix.to/#/#fedify:matrix.org
+[@fedify@hollo.social badge]: https://fedi-badge.deno.dev/@fedify@hollo.social/followers.svg
+[@fedify@hollo.social]: https://hollo.social/@fedify
+[Fedify]: https://fedify.dev/
+[Nuxt]: https://nuxt.com/
+
+
+Installation
+------------
+
+~~~~ bash
+deno add jsr:@fedify/nuxt
+# or
+npm add @fedify/nuxt
+# or
+pnpm add @fedify/nuxt
+# or
+yarn add @fedify/nuxt
+# or
+bun add @fedify/nuxt
+~~~~
+
+
+Usage
+-----
+
+Create your `Federation` instance in *server/federation.ts*:
+
+~~~~ typescript
+import { createFederation, MemoryKvStore } from "@fedify/fedify";
+
+const federation = createFederation({
+  kv: new MemoryKvStore(),
+});
+
+// ... configure your federation ...
+
+export default federation;
+~~~~
+
+Then enable the Nuxt module in *nuxt.config.ts*:
+
+~~~~ typescript
+export default defineNuxtConfig({
+  modules: ["@fedify/nuxt"],
+});
+~~~~
+
+By default, `@fedify/nuxt` loads your Federation instance from
+`~/server/federation`.
+
+If your project uses a different file path or context data factory,
+configure the module options:
+
+~~~~ typescript
+export default defineNuxtConfig({
+  modules: ["@fedify/nuxt"],
+  fedify: {
+    federationModule: "~/server/federation",
+    contextDataFactoryModule: "~/server/fedify-context",
+  },
+});
+~~~~
+
+The context data factory module should export either:
+
+ -  default function, or
+ -  `contextDataFactory` named export
+
+with this signature:
+
+~~~~ typescript
+import type { ContextDataFactory } from "@fedify/nuxt";
+
+const contextDataFactory: ContextDataFactory<unknown> = async (event, request) => {
+  return {
+    ip: event.node.req.socket.remoteAddress,
+    method: request.method,
+  };
+};
+
+export default contextDataFactory;
+~~~~