@route-forge/core 0.0.1

package/README.md

@@ -0,0 +1,34 @@
+# @route-forge/core
+
+框架无关的命名路由客户端核心:分级懒加载、隔离缓存、并发去重、登录态感知、拦截器。
+
+## 安装
+
+```bash
+pnpm add @route-forge/core
+# 可选:axios 适配器
+pnpm add axios
+```
+
+## 基本用法
+
+```ts
+import { createForge } from '@route-forge/core'
+
+const forge = createForge({
+  endpoint: '/_forge/routes',
+})
+
+const route = await forge.route('login.show')
+// → { method: 'GET', uri: '/login', level: 'public' }
+```
+
+## 文档
+
+- 仓库主页: https://github.com/xyj2156/route-forge
+- 设计文档: https://github.com/xyj2156/route-forge/blob/main/.docs/DESIGN.md
+- 规范: https://github.com/xyj2156/route-forge/blob/main/.docs/SPEC.md
+
+## License
+
+MIT

package/dist/codegen.cjs

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+'use strict';
+
+// src/codegen/index.ts
+var BODY_METHODS = /* @__PURE__ */ new Set(["POST", "PUT", "PATCH"]);
+function parseArgs(argv) {
+  const opts = {};
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    const next = () => {
+      const v = argv[++i];
+      if (v === void 0) {
+        throw new Error(`[route-forge/codegen] missing value for ${arg}`);
+      }
+      return v;
+    };
+    if (arg === "--endpoint") {
+      opts.endpoint = next();
+    } else if (arg?.startsWith("--endpoint=")) {
+      opts.endpoint = arg.slice("--endpoint=".length);
+    } else if (arg === "--levels") {
+      opts.levels = next().split(",").map((s) => s.trim()).filter(Boolean);
+    } else if (arg?.startsWith("--levels=")) {
+      opts.levels = arg.slice("--levels=".length).split(",").map((s) => s.trim()).filter(Boolean);
+    } else if (arg === "--out") {
+      opts.out = next();
+    } else if (arg?.startsWith("--out=")) {
+      opts.out = arg.slice("--out=".length);
+    } else if (arg === "--responseTypes") {
+      opts.responseTypes = next();
+    } else if (arg?.startsWith("--responseTypes=")) {
+      opts.responseTypes = arg.slice("--responseTypes=".length);
+    } else if (arg === "--help" || arg === "-h") {
+      printHelp();
+      process.exit(0);
+    }
+  }
+  if (!opts.endpoint) {
+    console.error("[route-forge/codegen] --endpoint is required");
+    printHelp();
+    process.exit(1);
+  }
+  if (!opts.out) {
+    console.error("[route-forge/codegen] --out is required");
+    printHelp();
+    process.exit(1);
+  }
+  return {
+    endpoint: opts.endpoint,
+    levels: opts.levels ?? [],
+    out: opts.out,
+    responseTypes: opts.responseTypes
+  };
+}
+function printHelp() {
+  console.log(`
+route-forge codegen - generate TS route types from backend summary endpoint
+
+Usage:
+  npx @route-forge/core codegen --endpoint URL --out PATH [--levels a,b,c] [--responseTypes PATH]
+
+Options:
+  --endpoint URL         Backend summary endpoint (e.g. http://localhost/_forge/routes)
+  --levels a,b,c         Optional: explicit level list (skip auto-discovery)
+  --out PATH              Output .d.ts file path
+  --responseTypes PATH    Optional: JSON file mapping route names to response types
+  -h, --help              Show this help
+`);
+}
+async function fetchSummary(endpoint) {
+  const resp = await fetch(endpoint, { method: "GET" });
+  if (!resp.ok) {
+    throw new Error(`summary endpoint ${endpoint} returned ${resp.status}`);
+  }
+  return await resp.json();
+}
+async function fetchLevel(endpoint, level) {
+  const base = endpoint.replace(/\/$/, "");
+  const url = `${base}/${encodeURIComponent(level)}`;
+  const resp = await fetch(url, { method: "GET" });
+  if (!resp.ok) {
+    throw new Error(`level endpoint ${url} returned ${resp.status}`);
+  }
+  const data = await resp.json();
+  return { routes: data.routes ?? {} };
+}
+function generateRouteTypes(routes) {
+  const entries = Object.entries(routes).map(([name, meta]) => {
+    const params = (meta.parameters ?? []).map((p) => `${p}: string | number;`).join(" ");
+    const method = meta.methods?.find((m) => m.toUpperCase() !== "HEAD") ?? "GET";
+    const methodUpper = method.toUpperCase();
+    const bodyField = BODY_METHODS.has(methodUpper) ? "\n    body: unknown;" : "";
+    return `  ${JSON.stringify(name)}: {
+    method: ${JSON.stringify(methodUpper)};
+    params: { ${params} };${bodyField}
+    response: unknown;
+  };`;
+  });
+  return `// AUTO-GENERATED by @route-forge/core codegen. Do not edit.
+export interface ForgeRoutes {
+${entries.join("\n")}
+}
+`;
+}
+async function main(argv = process.argv.slice(2)) {
+  const opts = parseArgs(argv);
+  let levels = opts.levels;
+  if (levels.length === 0) {
+    try {
+      const summary = await fetchSummary(opts.endpoint);
+      levels = Object.keys(summary.levels);
+    } catch (e) {
+      console.error(`[route-forge/codegen] failed to auto-discover levels from summary endpoint: ${e.message}`);
+      console.error("hint: pass --levels explicitly to skip auto-discovery");
+      process.exit(1);
+    }
+  }
+  if (levels.length === 0) {
+    console.error("[route-forge/codegen] no levels found; pass --levels explicitly");
+    process.exit(1);
+  }
+  const levelFetches = await Promise.allSettled(
+    levels.map((lvl) => fetchLevel(opts.endpoint, lvl))
+  );
+  const merged = {};
+  let failedLevels = 0;
+  levelFetches.forEach((res, idx) => {
+    if (res.status === "fulfilled") {
+      Object.assign(merged, res.value.routes);
+    } else {
+      failedLevels++;
+      console.warn(`[route-forge/codegen] failed to fetch level "${levels[idx]}": ${res.reason.message}`);
+    }
+  });
+  if (Object.keys(merged).length === 0) {
+    console.error("[route-forge/codegen] no routes collected from any level");
+    process.exit(1);
+  }
+  const dts = generateRouteTypes(merged);
+  const fs = await import('fs/promises');
+  const path = await import('path');
+  const outPath = path.resolve(opts.out);
+  const dir = path.dirname(outPath);
+  await fs.mkdir(dir, { recursive: true });
+  await fs.writeFile(outPath, dts, "utf8");
+  console.log(`[route-forge/codegen] written ${Object.keys(merged).length} routes to ${outPath}`);
+  if (failedLevels > 0) {
+    console.warn(`[route-forge/codegen] ${failedLevels} level(s) failed; output may be incomplete`);
+  }
+}
+var invokedFromCli = (() => {
+  try {
+    if (!process.argv[1]) return false;
+    const argv1 = process.argv[1].replace(/\\/g, "/");
+    return argv1.endsWith("/codegen.js") || argv1.endsWith("/codegen.cjs") || argv1.endsWith("/codegen");
+  } catch {
+    return false;
+  }
+})();
+if (invokedFromCli) {
+  main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+  });
+}
+
+exports.fetchLevel = fetchLevel;
+exports.fetchSummary = fetchSummary;
+exports.generateRouteTypes = generateRouteTypes;
+exports.main = main;
+exports.parseArgs = parseArgs;
+exports.runCodegen = main;
+//# sourceMappingURL=codegen.cjs.map
+//# sourceMappingURL=codegen.cjs.map

package/dist/codegen.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/codegen/index.ts"],"names":[],"mappings":"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","file":"codegen.cjs","sourcesContent":["#!/usr/bin/env node\n/**\n * @route-forge/core codegen CLI\n * @see .docs/SPEC.md §4.2\n *\n * 用法：\n *   npx @route-forge/core codegen \\\n *     --endpoint http://localhost/_forge/routes \\\n *     --levels public,client,manage,admin \\\n *     --out src/types/forge-routes.d.ts\n */\n\nimport type { RouteMeta } from '../types.js';\n\nexport interface CodegenOptions {\n  endpoint: string;\n  levels: string[];\n  out: string;\n  responseTypes?: string;\n}\n\nconst BODY_METHODS = new Set(['POST', 'PUT', 'PATCH']);\n\n/**\n * 解析 argv（最小手写实现，不引入 commander/yargs）\n * 支持：--endpoint VALUE / --endpoint=VALUE / --levels a,b,c / --out PATH / --responseTypes PATH\n */\nexport function parseArgs(argv: string[]): CodegenOptions {\n  const opts: Partial<CodegenOptions> = {};\n\n  for (let i = 0; i < argv.length; i++) {\n    const arg = argv[i];\n    const next = (): string => {\n      const v = argv[++i];\n      if (v === undefined) {\n        throw new Error(`[route-forge/codegen] missing value for ${arg}`);\n      }\n      return v;\n    };\n\n    if (arg === '--endpoint') {\n      opts.endpoint = next();\n    } else if (arg?.startsWith('--endpoint=')) {\n      opts.endpoint = arg.slice('--endpoint='.length);\n    } else if (arg === '--levels') {\n      opts.levels = next().split(',').map((s) => s.trim()).filter(Boolean);\n    } else if (arg?.startsWith('--levels=')) {\n      opts.levels = arg.slice('--levels='.length).split(',').map((s) => s.trim()).filter(Boolean);\n    } else if (arg === '--out') {\n      opts.out = next();\n    } else if (arg?.startsWith('--out=')) {\n      opts.out = arg.slice('--out='.length);\n    } else if (arg === '--responseTypes') {\n      opts.responseTypes = next();\n    } else if (arg?.startsWith('--responseTypes=')) {\n      opts.responseTypes = arg.slice('--responseTypes='.length);\n    } else if (arg === '--help' || arg === '-h') {\n      printHelp();\n      process.exit(0);\n    }\n  }\n\n  if (!opts.endpoint) {\n    console.error('[route-forge/codegen] --endpoint is required');\n    printHelp();\n    process.exit(1);\n  }\n  if (!opts.out) {\n    console.error('[route-forge/codegen] --out is required');\n    printHelp();\n    process.exit(1);\n  }\n\n  return {\n    endpoint: opts.endpoint,\n    levels: opts.levels ?? [],\n    out: opts.out,\n    responseTypes: opts.responseTypes,\n  };\n}\n\nfunction printHelp(): void {\n  console.log(`\nroute-forge codegen - generate TS route types from backend summary endpoint\n\nUsage:\n  npx @route-forge/core codegen --endpoint URL --out PATH [--levels a,b,c] [--responseTypes PATH]\n\nOptions:\n  --endpoint URL         Backend summary endpoint (e.g. http://localhost/_forge/routes)\n  --levels a,b,c         Optional: explicit level list (skip auto-discovery)\n  --out PATH              Output .d.ts file path\n  --responseTypes PATH    Optional: JSON file mapping route names to response types\n  -h, --help              Show this help\n`);\n}\n\n/**\n * 拉取摘要端点\n */\nexport async function fetchSummary(endpoint: string): Promise<{ levels: Record<string, unknown> }> {\n  const resp = await fetch(endpoint, { method: 'GET' });\n  if (!resp.ok) {\n    throw new Error(`summary endpoint ${endpoint} returned ${resp.status}`);\n  }\n  return (await resp.json()) as { levels: Record<string, unknown> };\n}\n\n/**\n * 拉取单个层级的路由元信息\n */\nexport async function fetchLevel(endpoint: string, level: string): Promise<{ routes: Record<string, RouteMeta> }> {\n  const base = endpoint.replace(/\\/$/, '');\n  const url = `${base}/${encodeURIComponent(level)}`;\n  const resp = await fetch(url, { method: 'GET' });\n  if (!resp.ok) {\n    throw new Error(`level endpoint ${url} returned ${resp.status}`);\n  }\n  const data = (await resp.json()) as { routes?: Record<string, RouteMeta> };\n  return { routes: data.routes ?? {} };\n}\n\n/**\n * 生成 d.ts 内容\n */\nexport function generateRouteTypes(routes: Record<string, RouteMeta>): string {\n  const entries = Object.entries(routes).map(([name, meta]) => {\n    const params = (meta.parameters ?? []).map((p) => `${p}: string | number;`).join(' ');\n    const method = meta.methods?.find((m) => m.toUpperCase() !== 'HEAD') ?? 'GET';\n    const methodUpper = method.toUpperCase();\n    const bodyField = BODY_METHODS.has(methodUpper) ? '\\n    body: unknown;' : '';\n    return `  ${JSON.stringify(name)}: {\n    method: ${JSON.stringify(methodUpper)};\n    params: { ${params} };${bodyField}\n    response: unknown;\n  };`;\n  });\n  return `// AUTO-GENERATED by @route-forge/core codegen. Do not edit.\nexport interface ForgeRoutes {\n${entries.join('\\n')}\n}\n`;\n}\n\n/**\n * CLI 主入口\n */\nexport async function main(argv: string[] = process.argv.slice(2)): Promise<void> {\n  const opts = parseArgs(argv);\n\n  let levels = opts.levels;\n  if (levels.length === 0) {\n    try {\n      const summary = await fetchSummary(opts.endpoint);\n      levels = Object.keys(summary.levels);\n    } catch (e) {\n      console.error(`[route-forge/codegen] failed to auto-discover levels from summary endpoint: ${(e as Error).message}`);\n      console.error('hint: pass --levels explicitly to skip auto-discovery');\n      process.exit(1);\n    }\n  }\n\n  if (levels.length === 0) {\n    console.error('[route-forge/codegen] no levels found; pass --levels explicitly');\n    process.exit(1);\n  }\n\n  const levelFetches = await Promise.allSettled(\n    levels.map((lvl) => fetchLevel(opts.endpoint, lvl)),\n  );\n\n  const merged: Record<string, RouteMeta> = {};\n  let failedLevels = 0;\n  levelFetches.forEach((res, idx) => {\n    if (res.status === 'fulfilled') {\n      Object.assign(merged, res.value.routes);\n    } else {\n      failedLevels++;\n      console.warn(`[route-forge/codegen] failed to fetch level \"${levels[idx]}\": ${(res.reason as Error).message}`);\n    }\n  });\n\n  if (Object.keys(merged).length === 0) {\n    console.error('[route-forge/codegen] no routes collected from any level');\n    process.exit(1);\n  }\n\n  const dts = generateRouteTypes(merged);\n\n  const fs = await import('node:fs/promises');\n  const path = await import('node:path');\n  const outPath = path.resolve(opts.out);\n  const dir = path.dirname(outPath);\n  await fs.mkdir(dir, { recursive: true });\n  await fs.writeFile(outPath, dts, 'utf8');\n\n  console.log(`[route-forge/codegen] written ${Object.keys(merged).length} routes to ${outPath}`);\n  if (failedLevels > 0) {\n    console.warn(`[route-forge/codegen] ${failedLevels} level(s) failed; output may be incomplete`);\n  }\n}\n\nconst invokedFromCli = (() => {\n  try {\n    if (!process.argv[1]) return false;\n    const argv1 = process.argv[1].replace(/\\\\/g, '/');\n    return argv1.endsWith('/codegen.js') || argv1.endsWith('/codegen.cjs') || argv1.endsWith('/codegen');\n  } catch {\n    return false;\n  }\n})();\n\nif (invokedFromCli) {\n  main().catch((err) => {\n    console.error(err);\n    process.exit(1);\n  });\n}\n\nexport { main as runCodegen };\n"]}

package/dist/codegen.d.cts

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+import { R as RouteMeta } from './types-UxdZAlmW.cjs';
+
+/**
+ * @route-forge/core codegen CLI
+ * @see .docs/SPEC.md §4.2
+ *
+ * 用法：
+ *   npx @route-forge/core codegen \
+ *     --endpoint http://localhost/_forge/routes \
+ *     --levels public,client,manage,admin \
+ *     --out src/types/forge-routes.d.ts
+ */
+
+interface CodegenOptions {
+    endpoint: string;
+    levels: string[];
+    out: string;
+    responseTypes?: string;
+}
+/**
+ * 解析 argv（最小手写实现，不引入 commander/yargs）
+ * 支持：--endpoint VALUE / --endpoint=VALUE / --levels a,b,c / --out PATH / --responseTypes PATH
+ */
+declare function parseArgs(argv: string[]): CodegenOptions;
+/**
+ * 拉取摘要端点
+ */
+declare function fetchSummary(endpoint: string): Promise<{
+    levels: Record<string, unknown>;
+}>;
+/**
+ * 拉取单个层级的路由元信息
+ */
+declare function fetchLevel(endpoint: string, level: string): Promise<{
+    routes: Record<string, RouteMeta>;
+}>;
+/**
+ * 生成 d.ts 内容
+ */
+declare function generateRouteTypes(routes: Record<string, RouteMeta>): string;
+/**
+ * CLI 主入口
+ */
+declare function main(argv?: string[]): Promise<void>;
+
+export { type CodegenOptions, fetchLevel, fetchSummary, generateRouteTypes, main, parseArgs, main as runCodegen };

package/dist/codegen.d.ts

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+import { R as RouteMeta } from './types-UxdZAlmW.js';
+
+/**
+ * @route-forge/core codegen CLI
+ * @see .docs/SPEC.md §4.2
+ *
+ * 用法：
+ *   npx @route-forge/core codegen \
+ *     --endpoint http://localhost/_forge/routes \
+ *     --levels public,client,manage,admin \
+ *     --out src/types/forge-routes.d.ts
+ */
+
+interface CodegenOptions {
+    endpoint: string;
+    levels: string[];
+    out: string;
+    responseTypes?: string;
+}
+/**
+ * 解析 argv（最小手写实现，不引入 commander/yargs）
+ * 支持：--endpoint VALUE / --endpoint=VALUE / --levels a,b,c / --out PATH / --responseTypes PATH
+ */
+declare function parseArgs(argv: string[]): CodegenOptions;
+/**
+ * 拉取摘要端点
+ */
+declare function fetchSummary(endpoint: string): Promise<{
+    levels: Record<string, unknown>;
+}>;
+/**
+ * 拉取单个层级的路由元信息
+ */
+declare function fetchLevel(endpoint: string, level: string): Promise<{
+    routes: Record<string, RouteMeta>;
+}>;
+/**
+ * 生成 d.ts 内容
+ */
+declare function generateRouteTypes(routes: Record<string, RouteMeta>): string;
+/**
+ * CLI 主入口
+ */
+declare function main(argv?: string[]): Promise<void>;
+
+export { type CodegenOptions, fetchLevel, fetchSummary, generateRouteTypes, main, parseArgs, main as runCodegen };

package/dist/codegen.js

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+// src/codegen/index.ts
+var BODY_METHODS = /* @__PURE__ */ new Set(["POST", "PUT", "PATCH"]);
+function parseArgs(argv) {
+  const opts = {};
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    const next = () => {
+      const v = argv[++i];
+      if (v === void 0) {
+        throw new Error(`[route-forge/codegen] missing value for ${arg}`);
+      }
+      return v;
+    };
+    if (arg === "--endpoint") {
+      opts.endpoint = next();
+    } else if (arg?.startsWith("--endpoint=")) {
+      opts.endpoint = arg.slice("--endpoint=".length);
+    } else if (arg === "--levels") {
+      opts.levels = next().split(",").map((s) => s.trim()).filter(Boolean);
+    } else if (arg?.startsWith("--levels=")) {
+      opts.levels = arg.slice("--levels=".length).split(",").map((s) => s.trim()).filter(Boolean);
+    } else if (arg === "--out") {
+      opts.out = next();
+    } else if (arg?.startsWith("--out=")) {
+      opts.out = arg.slice("--out=".length);
+    } else if (arg === "--responseTypes") {
+      opts.responseTypes = next();
+    } else if (arg?.startsWith("--responseTypes=")) {
+      opts.responseTypes = arg.slice("--responseTypes=".length);
+    } else if (arg === "--help" || arg === "-h") {
+      printHelp();
+      process.exit(0);
+    }
+  }
+  if (!opts.endpoint) {
+    console.error("[route-forge/codegen] --endpoint is required");
+    printHelp();
+    process.exit(1);
+  }
+  if (!opts.out) {
+    console.error("[route-forge/codegen] --out is required");
+    printHelp();
+    process.exit(1);
+  }
+  return {
+    endpoint: opts.endpoint,
+    levels: opts.levels ?? [],
+    out: opts.out,
+    responseTypes: opts.responseTypes
+  };
+}
+function printHelp() {
+  console.log(`
+route-forge codegen - generate TS route types from backend summary endpoint
+
+Usage:
+  npx @route-forge/core codegen --endpoint URL --out PATH [--levels a,b,c] [--responseTypes PATH]
+
+Options:
+  --endpoint URL         Backend summary endpoint (e.g. http://localhost/_forge/routes)
+  --levels a,b,c         Optional: explicit level list (skip auto-discovery)
+  --out PATH              Output .d.ts file path
+  --responseTypes PATH    Optional: JSON file mapping route names to response types
+  -h, --help              Show this help
+`);
+}
+async function fetchSummary(endpoint) {
+  const resp = await fetch(endpoint, { method: "GET" });
+  if (!resp.ok) {
+    throw new Error(`summary endpoint ${endpoint} returned ${resp.status}`);
+  }
+  return await resp.json();
+}
+async function fetchLevel(endpoint, level) {
+  const base = endpoint.replace(/\/$/, "");
+  const url = `${base}/${encodeURIComponent(level)}`;
+  const resp = await fetch(url, { method: "GET" });
+  if (!resp.ok) {
+    throw new Error(`level endpoint ${url} returned ${resp.status}`);
+  }
+  const data = await resp.json();
+  return { routes: data.routes ?? {} };
+}
+function generateRouteTypes(routes) {
+  const entries = Object.entries(routes).map(([name, meta]) => {
+    const params = (meta.parameters ?? []).map((p) => `${p}: string | number;`).join(" ");
+    const method = meta.methods?.find((m) => m.toUpperCase() !== "HEAD") ?? "GET";
+    const methodUpper = method.toUpperCase();
+    const bodyField = BODY_METHODS.has(methodUpper) ? "\n    body: unknown;" : "";
+    return `  ${JSON.stringify(name)}: {
+    method: ${JSON.stringify(methodUpper)};
+    params: { ${params} };${bodyField}
+    response: unknown;
+  };`;
+  });
+  return `// AUTO-GENERATED by @route-forge/core codegen. Do not edit.
+export interface ForgeRoutes {
+${entries.join("\n")}
+}
+`;
+}
+async function main(argv = process.argv.slice(2)) {
+  const opts = parseArgs(argv);
+  let levels = opts.levels;
+  if (levels.length === 0) {
+    try {
+      const summary = await fetchSummary(opts.endpoint);
+      levels = Object.keys(summary.levels);
+    } catch (e) {
+      console.error(`[route-forge/codegen] failed to auto-discover levels from summary endpoint: ${e.message}`);
+      console.error("hint: pass --levels explicitly to skip auto-discovery");
+      process.exit(1);
+    }
+  }
+  if (levels.length === 0) {
+    console.error("[route-forge/codegen] no levels found; pass --levels explicitly");
+    process.exit(1);
+  }
+  const levelFetches = await Promise.allSettled(
+    levels.map((lvl) => fetchLevel(opts.endpoint, lvl))
+  );
+  const merged = {};
+  let failedLevels = 0;
+  levelFetches.forEach((res, idx) => {
+    if (res.status === "fulfilled") {
+      Object.assign(merged, res.value.routes);
+    } else {
+      failedLevels++;
+      console.warn(`[route-forge/codegen] failed to fetch level "${levels[idx]}": ${res.reason.message}`);
+    }
+  });
+  if (Object.keys(merged).length === 0) {
+    console.error("[route-forge/codegen] no routes collected from any level");
+    process.exit(1);
+  }
+  const dts = generateRouteTypes(merged);
+  const fs = await import('fs/promises');
+  const path = await import('path');
+  const outPath = path.resolve(opts.out);
+  const dir = path.dirname(outPath);
+  await fs.mkdir(dir, { recursive: true });
+  await fs.writeFile(outPath, dts, "utf8");
+  console.log(`[route-forge/codegen] written ${Object.keys(merged).length} routes to ${outPath}`);
+  if (failedLevels > 0) {
+    console.warn(`[route-forge/codegen] ${failedLevels} level(s) failed; output may be incomplete`);
+  }
+}
+var invokedFromCli = (() => {
+  try {
+    if (!process.argv[1]) return false;
+    const argv1 = process.argv[1].replace(/\\/g, "/");
+    return argv1.endsWith("/codegen.js") || argv1.endsWith("/codegen.cjs") || argv1.endsWith("/codegen");
+  } catch {
+    return false;
+  }
+})();
+if (invokedFromCli) {
+  main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+  });
+}
+
+export { fetchLevel, fetchSummary, generateRouteTypes, main, parseArgs, main as runCodegen };
+//# sourceMappingURL=codegen.js.map
+//# sourceMappingURL=codegen.js.map

package/dist/codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/codegen/index.ts"],"names":[],"mappings":"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","file":"codegen.js","sourcesContent":["#!/usr/bin/env node\n/**\n * @route-forge/core codegen CLI\n * @see .docs/SPEC.md §4.2\n *\n * 用法：\n *   npx @route-forge/core codegen \\\n *     --endpoint http://localhost/_forge/routes \\\n *     --levels public,client,manage,admin \\\n *     --out src/types/forge-routes.d.ts\n */\n\nimport type { RouteMeta } from '../types.js';\n\nexport interface CodegenOptions {\n  endpoint: string;\n  levels: string[];\n  out: string;\n  responseTypes?: string;\n}\n\nconst BODY_METHODS = new Set(['POST', 'PUT', 'PATCH']);\n\n/**\n * 解析 argv（最小手写实现，不引入 commander/yargs）\n * 支持：--endpoint VALUE / --endpoint=VALUE / --levels a,b,c / --out PATH / --responseTypes PATH\n */\nexport function parseArgs(argv: string[]): CodegenOptions {\n  const opts: Partial<CodegenOptions> = {};\n\n  for (let i = 0; i < argv.length; i++) {\n    const arg = argv[i];\n    const next = (): string => {\n      const v = argv[++i];\n      if (v === undefined) {\n        throw new Error(`[route-forge/codegen] missing value for ${arg}`);\n      }\n      return v;\n    };\n\n    if (arg === '--endpoint') {\n      opts.endpoint = next();\n    } else if (arg?.startsWith('--endpoint=')) {\n      opts.endpoint = arg.slice('--endpoint='.length);\n    } else if (arg === '--levels') {\n      opts.levels = next().split(',').map((s) => s.trim()).filter(Boolean);\n    } else if (arg?.startsWith('--levels=')) {\n      opts.levels = arg.slice('--levels='.length).split(',').map((s) => s.trim()).filter(Boolean);\n    } else if (arg === '--out') {\n      opts.out = next();\n    } else if (arg?.startsWith('--out=')) {\n      opts.out = arg.slice('--out='.length);\n    } else if (arg === '--responseTypes') {\n      opts.responseTypes = next();\n    } else if (arg?.startsWith('--responseTypes=')) {\n      opts.responseTypes = arg.slice('--responseTypes='.length);\n    } else if (arg === '--help' || arg === '-h') {\n      printHelp();\n      process.exit(0);\n    }\n  }\n\n  if (!opts.endpoint) {\n    console.error('[route-forge/codegen] --endpoint is required');\n    printHelp();\n    process.exit(1);\n  }\n  if (!opts.out) {\n    console.error('[route-forge/codegen] --out is required');\n    printHelp();\n    process.exit(1);\n  }\n\n  return {\n    endpoint: opts.endpoint,\n    levels: opts.levels ?? [],\n    out: opts.out,\n    responseTypes: opts.responseTypes,\n  };\n}\n\nfunction printHelp(): void {\n  console.log(`\nroute-forge codegen - generate TS route types from backend summary endpoint\n\nUsage:\n  npx @route-forge/core codegen --endpoint URL --out PATH [--levels a,b,c] [--responseTypes PATH]\n\nOptions:\n  --endpoint URL         Backend summary endpoint (e.g. http://localhost/_forge/routes)\n  --levels a,b,c         Optional: explicit level list (skip auto-discovery)\n  --out PATH              Output .d.ts file path\n  --responseTypes PATH    Optional: JSON file mapping route names to response types\n  -h, --help              Show this help\n`);\n}\n\n/**\n * 拉取摘要端点\n */\nexport async function fetchSummary(endpoint: string): Promise<{ levels: Record<string, unknown> }> {\n  const resp = await fetch(endpoint, { method: 'GET' });\n  if (!resp.ok) {\n    throw new Error(`summary endpoint ${endpoint} returned ${resp.status}`);\n  }\n  return (await resp.json()) as { levels: Record<string, unknown> };\n}\n\n/**\n * 拉取单个层级的路由元信息\n */\nexport async function fetchLevel(endpoint: string, level: string): Promise<{ routes: Record<string, RouteMeta> }> {\n  const base = endpoint.replace(/\\/$/, '');\n  const url = `${base}/${encodeURIComponent(level)}`;\n  const resp = await fetch(url, { method: 'GET' });\n  if (!resp.ok) {\n    throw new Error(`level endpoint ${url} returned ${resp.status}`);\n  }\n  const data = (await resp.json()) as { routes?: Record<string, RouteMeta> };\n  return { routes: data.routes ?? {} };\n}\n\n/**\n * 生成 d.ts 内容\n */\nexport function generateRouteTypes(routes: Record<string, RouteMeta>): string {\n  const entries = Object.entries(routes).map(([name, meta]) => {\n    const params = (meta.parameters ?? []).map((p) => `${p}: string | number;`).join(' ');\n    const method = meta.methods?.find((m) => m.toUpperCase() !== 'HEAD') ?? 'GET';\n    const methodUpper = method.toUpperCase();\n    const bodyField = BODY_METHODS.has(methodUpper) ? '\\n    body: unknown;' : '';\n    return `  ${JSON.stringify(name)}: {\n    method: ${JSON.stringify(methodUpper)};\n    params: { ${params} };${bodyField}\n    response: unknown;\n  };`;\n  });\n  return `// AUTO-GENERATED by @route-forge/core codegen. Do not edit.\nexport interface ForgeRoutes {\n${entries.join('\\n')}\n}\n`;\n}\n\n/**\n * CLI 主入口\n */\nexport async function main(argv: string[] = process.argv.slice(2)): Promise<void> {\n  const opts = parseArgs(argv);\n\n  let levels = opts.levels;\n  if (levels.length === 0) {\n    try {\n      const summary = await fetchSummary(opts.endpoint);\n      levels = Object.keys(summary.levels);\n    } catch (e) {\n      console.error(`[route-forge/codegen] failed to auto-discover levels from summary endpoint: ${(e as Error).message}`);\n      console.error('hint: pass --levels explicitly to skip auto-discovery');\n      process.exit(1);\n    }\n  }\n\n  if (levels.length === 0) {\n    console.error('[route-forge/codegen] no levels found; pass --levels explicitly');\n    process.exit(1);\n  }\n\n  const levelFetches = await Promise.allSettled(\n    levels.map((lvl) => fetchLevel(opts.endpoint, lvl)),\n  );\n\n  const merged: Record<string, RouteMeta> = {};\n  let failedLevels = 0;\n  levelFetches.forEach((res, idx) => {\n    if (res.status === 'fulfilled') {\n      Object.assign(merged, res.value.routes);\n    } else {\n      failedLevels++;\n      console.warn(`[route-forge/codegen] failed to fetch level \"${levels[idx]}\": ${(res.reason as Error).message}`);\n    }\n  });\n\n  if (Object.keys(merged).length === 0) {\n    console.error('[route-forge/codegen] no routes collected from any level');\n    process.exit(1);\n  }\n\n  const dts = generateRouteTypes(merged);\n\n  const fs = await import('node:fs/promises');\n  const path = await import('node:path');\n  const outPath = path.resolve(opts.out);\n  const dir = path.dirname(outPath);\n  await fs.mkdir(dir, { recursive: true });\n  await fs.writeFile(outPath, dts, 'utf8');\n\n  console.log(`[route-forge/codegen] written ${Object.keys(merged).length} routes to ${outPath}`);\n  if (failedLevels > 0) {\n    console.warn(`[route-forge/codegen] ${failedLevels} level(s) failed; output may be incomplete`);\n  }\n}\n\nconst invokedFromCli = (() => {\n  try {\n    if (!process.argv[1]) return false;\n    const argv1 = process.argv[1].replace(/\\\\/g, '/');\n    return argv1.endsWith('/codegen.js') || argv1.endsWith('/codegen.cjs') || argv1.endsWith('/codegen');\n  } catch {\n    return false;\n  }\n})();\n\nif (invokedFromCli) {\n  main().catch((err) => {\n    console.error(err);\n    process.exit(1);\n  });\n}\n\nexport { main as runCodegen };\n"]}