@faapi/next 0.0.0-canary.0

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+import { FaapiPlugin } from '@faapi/faapi';
+
+/** 插件选项（来自 faapi.config.ts plugins 声明的第二个元素或 options 字段） */
+interface NextPluginOptions {
+    /** 开发模式，默认 NODE_ENV !== 'production' */
+    dev?: boolean;
+    /** Next.js 项目目录，默认 '.' */
+    dir?: string;
+    /** faapi API 路径前缀，默认 '/api'；匹配此前缀的请求走 faapi，其余走 Next.js */
+    apiPrefix?: string;
+}
+/**
+ * Next.js + faapi 集成插件
+ *
+ * 通过 faapi.config.ts 的 plugins 字段加载：
+ *
+ * ```ts
+ * export default {
+ *   plugins: [
+ *     ['@faapi/next', { dir: '.' }]  // 带选项的元组
+ *   ],
+ * } satisfies FaapiConfig;
+ * ```
+ *
+ * 启动时用 `faapi` 命令，自动集成 Next.js，无需写 custom server 代码。
+ */
+declare const nextPlugin: FaapiPlugin;
+
+export { type NextPluginOptions, nextPlugin as default };

package/dist/index.js

@@ -0,0 +1,61 @@
+// src/createNextServer.ts
+import path from "path";
+var DEFAULT_API_PREFIX = "/api";
+function isApiPath(pathname, apiPrefix) {
+  return pathname === apiPrefix || pathname.startsWith(apiPrefix + "/");
+}
+var nextPlugin = {
+  name: "@faapi/next",
+  async setup(ctx) {
+    const options = ctx.options ?? {};
+    const dev = options.dev ?? process.env.NODE_ENV !== "production";
+    const dir = path.resolve(ctx.rootDir, options.dir ?? ".");
+    const apiPrefix = options.apiPrefix ?? DEFAULT_API_PREFIX;
+    let nextFactory;
+    try {
+      nextFactory = (await import("next")).default;
+    } catch {
+      throw new Error("[faapi-next] next \u5305\u672A\u5B89\u88C5\u3002\u8BF7\u8FD0\u884C `pnpm add next` \u5B89\u88C5 Next.js\u3002");
+    }
+    const nextApp = nextFactory({ dev, dir });
+    const nextHandle = nextApp.getRequestHandler();
+    await nextApp.prepare();
+    const nextUpgradeHandler = typeof nextApp.getUpgradeHandler === "function" ? nextApp.getUpgradeHandler() : null;
+    ctx.wrapHandler?.((original) => {
+      return (req, res) => {
+        const { pathname } = new URL(req.url ?? "/", "http://localhost");
+        if (isApiPath(pathname, apiPrefix)) {
+          original(req, res);
+        } else {
+          Promise.resolve(nextHandle(req, res)).catch((err) => {
+            console.error("[faapi-next] Next.js handler error:", err);
+            if (!res.headersSent) {
+              res.statusCode = 500;
+              res.end("Next.js handler error");
+            }
+          });
+        }
+      };
+    });
+    ctx.wrapUpgradeHandler?.((original) => {
+      return (req, socket, head) => {
+        const { pathname } = new URL(req.url ?? "/", "http://localhost");
+        if (isApiPath(pathname, apiPrefix) && original) {
+          original(req, socket, head);
+        } else if (nextUpgradeHandler) {
+          nextUpgradeHandler(req, socket, head);
+        } else {
+          socket.destroy();
+        }
+      };
+    });
+    console.log(
+      `- Next.js integration: ${dev ? "dev" : "prod"} mode, dir=${dir}, apiPrefix=${apiPrefix}`
+    );
+  }
+};
+var createNextServer_default = nextPlugin;
+export {
+  createNextServer_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/createNextServer.ts"],"sourcesContent":["/**\n * @faapi/next — Next.js + faapi 集成插件\n *\n * 通过 faapi.config.ts 的 plugins 字段加载，在 server.listen 之前包装 handler：\n * - /api/* 走 faapi handler\n * - 其余走 Next.js getRequestHandler\n *\n * WS upgrade 同步分流：faapi WS 路由走原始 upgrade handler，其余走 Next.js HMR。\n *\n * @see createNextServer.md 设计要点与使用场景\n */\nimport path from 'node:path';\nimport type { IncomingMessage, ServerResponse } from 'node:http';\nimport type { FaapiPlugin, PluginContext, RequestHandler, UpgradeHandler } from '@faapi/faapi';\n\n/**\n * Next.js 应用最小类型定义\n *\n * next 作为 optional peerDependency，不强制安装；这里只声明插件用到的字段，\n * 避免直接依赖 next 包的类型。\n */\ninterface NextApp {\n  getRequestHandler(): (req: IncomingMessage, res: ServerResponse) => Promise<unknown>;\n  prepare(): Promise<void>;\n  getUpgradeHandler?(): (req: IncomingMessage, socket: unknown, head: Buffer) => void;\n}\n\n/** 插件选项（来自 faapi.config.ts plugins 声明的第二个元素或 options 字段） */\nexport interface NextPluginOptions {\n  /** 开发模式，默认 NODE_ENV !== 'production' */\n  dev?: boolean;\n  /** Next.js 项目目录，默认 '.' */\n  dir?: string;\n  /** faapi API 路径前缀，默认 '/api'；匹配此前缀的请求走 faapi，其余走 Next.js */\n  apiPrefix?: string;\n}\n\n/** 默认 API 前缀 */\nconst DEFAULT_API_PREFIX = '/api';\n\n/**\n * 判断 pathname 是否匹配 apiPrefix\n *\n * apiPrefix '/api' 匹配 '/api' 和 '/api/*'，不匹配 '/api2'\n */\nfunction isApiPath(pathname: string, apiPrefix: string): boolean {\n  return pathname === apiPrefix || pathname.startsWith(apiPrefix + '/');\n}\n\n/**\n * Next.js + faapi 集成插件\n *\n * 通过 faapi.config.ts 的 plugins 字段加载：\n *\n * ```ts\n * export default {\n *   plugins: [\n *     ['@faapi/next', { dir: '.' }]  // 带选项的元组\n *   ],\n * } satisfies FaapiConfig;\n * ```\n *\n * 启动时用 `faapi` 命令，自动集成 Next.js，无需写 custom server 代码。\n */\nconst nextPlugin: FaapiPlugin = {\n  name: '@faapi/next',\n\n  async setup(ctx: PluginContext): Promise<void> {\n    const options = (ctx.options as NextPluginOptions) ?? {};\n    const dev = options.dev ?? process.env.NODE_ENV !== 'production';\n    // dir 相对于项目根目录解析（CLI 形态下 rootDir === process.cwd()，行为不变；\n    // 库 API 形态下 rootDir 可能不同，按 rootDir 解析更合理）\n    const dir = path.resolve(ctx.rootDir, options.dir ?? '.');\n    const apiPrefix = options.apiPrefix ?? DEFAULT_API_PREFIX;\n\n    // 1. 动态 import next（peerDependency，未安装时报错）\n    let nextFactory: (opts: { dev: boolean; dir: string }) => NextApp;\n    try {\n      nextFactory = (await import('next')).default as typeof nextFactory;\n    } catch {\n      throw new Error('[faapi-next] next 包未安装。请运行 `pnpm add next` 安装 Next.js。');\n    }\n\n    // 2. 启动 Next.js\n    const nextApp = nextFactory({ dev, dir });\n    const nextHandle = nextApp.getRequestHandler();\n    await nextApp.prepare();\n\n    // 3. Next.js upgrade handler（dev 模式 HMR）\n    const nextUpgradeHandler =\n      typeof nextApp.getUpgradeHandler === 'function' ? nextApp.getUpgradeHandler() : null;\n\n    // 4. 包装 HTTP handler：/api/* 走 faapi，其余走 Next.js\n    ctx.wrapHandler?.((original: RequestHandler): RequestHandler => {\n      return (req, res) => {\n        const { pathname } = new URL(req.url ?? '/', 'http://localhost');\n        if (isApiPath(pathname, apiPrefix)) {\n          original(req, res);\n        } else {\n          // 不传 parsedUrl，让 Next.js 内部解析 req.url\n          // NextUrlWithParsedQuery 是 url.parse() 返回的结构，不是 URL 对象\n          // 用 Promise.resolve 包装，兼容 handler 返回 undefined 的情况\n          Promise.resolve(nextHandle(req, res)).catch((err: unknown) => {\n            console.error('[faapi-next] Next.js handler error:', err);\n            if (!res.headersSent) {\n              res.statusCode = 500;\n              res.end('Next.js handler error');\n            }\n          });\n        }\n      };\n    });\n\n    // 5. 包装 WS upgrade handler：/api/* 走 faapi，其余走 Next.js HMR\n    ctx.wrapUpgradeHandler?.((original: UpgradeHandler | undefined): UpgradeHandler => {\n      return (req, socket, head) => {\n        const { pathname } = new URL(req.url ?? '/', 'http://localhost');\n        if (isApiPath(pathname, apiPrefix) && original) {\n          original(req, socket, head);\n        } else if (nextUpgradeHandler) {\n          nextUpgradeHandler(req, socket, head);\n        } else {\n          socket.destroy();\n        }\n      };\n    });\n\n    console.log(\n      `- Next.js integration: ${dev ? 'dev' : 'prod'} mode, dir=${dir}, apiPrefix=${apiPrefix}`,\n    );\n  },\n};\n\nexport default nextPlugin;\nexport type { FaapiPlugin, PluginContext, RequestHandler, UpgradeHandler } from '@faapi/faapi';\n"],"mappings":";AAWA,OAAO,UAAU;AA2BjB,IAAM,qBAAqB;AAO3B,SAAS,UAAU,UAAkB,WAA4B;AAC/D,SAAO,aAAa,aAAa,SAAS,WAAW,YAAY,GAAG;AACtE;AAiBA,IAAM,aAA0B;AAAA,EAC9B,MAAM;AAAA,EAEN,MAAM,MAAM,KAAmC;AAC7C,UAAM,UAAW,IAAI,WAAiC,CAAC;AACvD,UAAM,MAAM,QAAQ,OAAO,QAAQ,IAAI,aAAa;AAGpD,UAAM,MAAM,KAAK,QAAQ,IAAI,SAAS,QAAQ,OAAO,GAAG;AACxD,UAAM,YAAY,QAAQ,aAAa;AAGvC,QAAI;AACJ,QAAI;AACF,qBAAe,MAAM,OAAO,MAAM,GAAG;AAAA,IACvC,QAAQ;AACN,YAAM,IAAI,MAAM,+GAAwD;AAAA,IAC1E;AAGA,UAAM,UAAU,YAAY,EAAE,KAAK,IAAI,CAAC;AACxC,UAAM,aAAa,QAAQ,kBAAkB;AAC7C,UAAM,QAAQ,QAAQ;AAGtB,UAAM,qBACJ,OAAO,QAAQ,sBAAsB,aAAa,QAAQ,kBAAkB,IAAI;AAGlF,QAAI,cAAc,CAAC,aAA6C;AAC9D,aAAO,CAAC,KAAK,QAAQ;AACnB,cAAM,EAAE,SAAS,IAAI,IAAI,IAAI,IAAI,OAAO,KAAK,kBAAkB;AAC/D,YAAI,UAAU,UAAU,SAAS,GAAG;AAClC,mBAAS,KAAK,GAAG;AAAA,QACnB,OAAO;AAIL,kBAAQ,QAAQ,WAAW,KAAK,GAAG,CAAC,EAAE,MAAM,CAAC,QAAiB;AAC5D,oBAAQ,MAAM,uCAAuC,GAAG;AACxD,gBAAI,CAAC,IAAI,aAAa;AACpB,kBAAI,aAAa;AACjB,kBAAI,IAAI,uBAAuB;AAAA,YACjC;AAAA,UACF,CAAC;AAAA,QACH;AAAA,MACF;AAAA,IACF,CAAC;AAGD,QAAI,qBAAqB,CAAC,aAAyD;AACjF,aAAO,CAAC,KAAK,QAAQ,SAAS;AAC5B,cAAM,EAAE,SAAS,IAAI,IAAI,IAAI,IAAI,OAAO,KAAK,kBAAkB;AAC/D,YAAI,UAAU,UAAU,SAAS,KAAK,UAAU;AAC9C,mBAAS,KAAK,QAAQ,IAAI;AAAA,QAC5B,WAAW,oBAAoB;AAC7B,6BAAmB,KAAK,QAAQ,IAAI;AAAA,QACtC,OAAO;AACL,iBAAO,QAAQ;AAAA,QACjB;AAAA,MACF;AAAA,IACF,CAAC;AAED,YAAQ;AAAA,MACN,0BAA0B,MAAM,QAAQ,MAAM,cAAc,GAAG,eAAe,SAAS;AAAA,IACzF;AAAA,EACF;AACF;AAEA,IAAO,2BAAQ;","names":[]}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@faapi/next",
+  "version": "0.0.0-canary.0",
+  "description": "Next.js integration for faapi — serve faapi APIs and Next.js pages from a single server",
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./src/index.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "pnpm build",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@faapi/faapi": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
+    "@types/ws": "^8.18.1",
+    "next": "^16.2.9",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.1.0",
+    "ws": "^8.21.0"
+  },
+  "peerDependencies": {
+    "next": ">=13.0.0"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/faapi/faapi.git",
+    "directory": "packages/next"
+  },
+  "publishConfig": {
+    "access": "public",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js"
+      }
+    }
+  }
+}