@erest/gen 0.1.0

package/README.md

@@ -0,0 +1,69 @@
+# @erest/gen
+
+erest codegen CLI：从 Zod schema 生成 handler 骨架等。
+
+> npm 包名为 `@erest/gen`，安装后通过 `erest-gen` 命令调用。
+
+## 安装
+
+```bash
+pnpm add -D @erest/gen
+```
+
+## 用法
+
+### handler 命令
+
+从 Zod schema 文件生成 `registerTyped` handler 骨架。
+
+**约定**：schema 文件中以 `export const XxxSchema = z.object({...})` 形式导出的 schema 会被识别，每个生成一个 handler 骨架。
+
+```bash
+# 输出到 stdout
+npx erest-gen handler --from ./schemas/user.ts --group user
+
+# 输出到文件
+npx erest-gen handler --from ./schemas/user.ts --group user --out ./handlers/user.ts
+```
+
+**示例输入** `schemas/user.ts`：
+
+```typescript
+import { z } from "zod";
+
+export const UserCreateSchema = z.object({
+  name: z.string(),
+  age: z.number().int(),
+});
+
+export const UserUpdateSchema = z.object({
+  name: z.string().optional(),
+});
+```
+
+**生成输出**：
+
+```typescript
+import type ERest from "erest";
+import { UserCreateSchema } from "./schemas/user.js";
+import { UserUpdateSchema } from "./schemas/user.js";
+
+export function registerUserHandlers(api: ERest["api"]) {
+  api
+    .post("/user-create")
+    .group("user")
+    .registerTyped(
+      { body: UserCreateSchema },
+      (req, reply) => {
+        // TODO: 实现 user-create 处理逻辑
+        return reply.json({ ok: true });
+      }
+    );
+  // ...
+}
+```
+
+## 后续计划
+
+- `test` 命令：为已注册 API 生成测试样板
+- `docs` 命令：从 ERest 实例导出 markdown

package/dist/handler.d.ts

@@ -0,0 +1,18 @@
+/**
+ * handler codegen：从 Zod schema 文件生成 registerTyped handler 骨架。
+ *
+ * 解析策略（轻量，不引入 TS AST 依赖）：
+ *   用正则识别 `export const XxxSchema = z.object({...})` 形式的导出。
+ *   对每个识别到的 schema，生成一个 handler 骨架。
+ */
+export interface GenerateHandlerOptions {
+    /** schema 文件路径（相对 CWD） */
+    schemaFile: string;
+    /** API 分组 */
+    group: string;
+}
+/** 从源码中提取 export const XxxSchema 名称列表 */
+export declare function extractSchemaNames(source: string): string[];
+/** 从 SchemaName 推导资源名（UserCreateSchema -> user-create） */
+export declare function schemaNameToResource(name: string): string;
+export declare function generateHandler(options: GenerateHandlerOptions): string;

package/dist/handler.js

@@ -0,0 +1,65 @@
+/**
+ * handler codegen：从 Zod schema 文件生成 registerTyped handler 骨架。
+ *
+ * 解析策略（轻量，不引入 TS AST 依赖）：
+ *   用正则识别 `export const XxxSchema = z.object({...})` 形式的导出。
+ *   对每个识别到的 schema，生成一个 handler 骨架。
+ */
+import { readFileSync } from "node:fs";
+/** 从源码中提取 export const XxxSchema 名称列表 */
+export function extractSchemaNames(source) {
+    const names = [];
+    // 匹配 export const XxxSchema = z.object（不要求完整 object 体，只要赋值为 z.object 调用）
+    const re = /export\s+const\s+([A-Z]\w*Schema)\s*=\s*z\.object/g;
+    let m;
+    while ((m = re.exec(source)) !== null) {
+        names.push(m[1]);
+    }
+    return names;
+}
+/** 从 SchemaName 推导资源名（UserCreateSchema -> user-create） */
+export function schemaNameToResource(name) {
+    return name
+        .replace(/Schema$/, "")
+        .replace(/([A-Z])/g, "-$1")
+        .replace(/^-/, "")
+        .toLowerCase();
+}
+export function generateHandler(options) {
+    const { schemaFile, group } = options;
+    const source = readFileSync(schemaFile, "utf-8");
+    const schemaNames = extractSchemaNames(source);
+    if (schemaNames.length === 0) {
+        throw new Error(`erest-gen: 未在 ${schemaFile} 中找到 \`export const XxxSchema = z.object(...)\` 形式的导出`);
+    }
+    const handlers = schemaNames
+        .map((name) => {
+        const resource = schemaNameToResource(name);
+        return `  api
+    .post("/${resource}")
+    .group("${group}")
+    .registerTyped(
+      { body: ${name} },
+      (req, reply) => {
+        // TODO: 实现 ${resource} 处理逻辑
+        // req.body 类型由 ${name} 推导
+        return reply.json({ ok: true });
+      }
+    );`;
+    })
+        .join("\n\n");
+    const importPath = schemaFile.replace(/\.ts$/, ".js");
+    const baseName = schemaFile.split("/").pop().replace(/\.ts$/, "");
+    const capitalizedBase = capitalize(baseName);
+    return `// 由 erest-gen 生成，请按需修改
+import type ERest from "erest";
+${schemaNames.map((n) => `import { ${n} } from "./${importPath}";`).join("\n")}
+
+export function register${capitalizedBase}Handlers(api: ERest["api"]) {
+${handlers}
+}
+`;
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * erest-gen: erest codegen CLI
+ *
+ * 首版命令：
+ *   handler --from <schema-file> --group <group> [--out <output>]
+ *     从 Zod schema 文件读取导出的 *Schema 常量，生成 registerTyped handler 骨架。
+ *
+ * 约定：schema 文件中 `export const XxxSchema = z.object({...})` 会被识别。
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+/**
+ * erest-gen: erest codegen CLI
+ *
+ * 首版命令：
+ *   handler --from <schema-file> --group <group> [--out <output>]
+ *     从 Zod schema 文件读取导出的 *Schema 常量，生成 registerTyped handler 骨架。
+ *
+ * 约定：schema 文件中 `export const XxxSchema = z.object({...})` 会被识别。
+ */
+import { generateHandler } from "./handler.js";
+import { writeFileSync } from "node:fs";
+function parseArgs(argv) {
+    const [, , command, ...rest] = argv;
+    if (!command)
+        return null;
+    const args = { command };
+    for (let i = 0; i < rest.length; i++) {
+        if (rest[i] === "--from")
+            args.from = rest[++i];
+        else if (rest[i] === "--group")
+            args.group = rest[++i];
+        else if (rest[i] === "--out")
+            args.out = rest[++i];
+    }
+    return args;
+}
+function main() {
+    const args = parseArgs(process.argv);
+    if (!args || !args.from) {
+        console.error(`erest-gen: 用法见 README
+  erest-gen handler --from ./schemas/user.ts --group user [--out ./handlers/user.ts]`);
+        process.exit(1);
+    }
+    if (args.command === "handler") {
+        const code = generateHandler({
+            schemaFile: args.from,
+            group: args.group || "Index",
+        });
+        if (args.out) {
+            writeFileSync(args.out, code);
+            console.error(`erest-gen: 已生成 ${args.out}`);
+        }
+        else {
+            process.stdout.write(code);
+        }
+    }
+    else {
+        console.error(`erest-gen: 未知命令 ${args.command}（首版仅支持 handler）`);
+        process.exit(1);
+    }
+}
+main();

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@erest/gen",
+  "version": "0.1.0",
+  "description": "erest codegen CLI：从 Zod schema 生成 handler 骨架等（实验性，独立于 erest 主版本演进）",
+  "type": "module",
+  "bin": {
+    "erest-gen": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5.8.0"
+  }
+}