oas-codegen 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wuchao
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,142 @@
+# oas-codegen
+
+基于 OpenAPI 规范生成 TypeScript 客户端代码的**配方化 CLI**——薄封装 [orval](https://orval.dev)，把「拉取规范 → 生成 vue-query 客户端」收敛成一个命令。
+
+> **设计取舍**：不重写 OpenAPI→TS 编译器，而是把 orval 8 作为版本锁定的引擎，由本包提供规范获取、默认配方（vue-query + 自定义 axios mutator）与清晰配置。生成逻辑全部透传给 orval，天然继承其全部特性。
+
+## 安装
+
+```bash
+pnpm add -D oas-codegen
+```
+
+要求 Node.js ≥ 18（使用全局 `fetch`）。
+
+## 快速开始
+
+```bash
+oas-codegen init      # 生成 oas-codegen.config.ts（含注释）
+oas-codegen fetch     # 从后端拉取 OpenAPI 规范 → specs/openapi.json
+oas-codegen generate  # 生成 TS 类型 + vue-query hooks → src/api/generated/
+```
+
+**零配置默认值**刻意等价于旧手写流程的行为，什么都不写也能跑：
+
+| 默认项 | 值 |
+| --- | --- |
+| 规范来源 | springdoc 后端，`${API_BASE_URL || http://localhost:8082}/v3/api-docs` |
+| 规范落盘 | `specs/openapi.json` |
+| 生成入口 | `src/api/generated/endpoints.ts` |
+| 类型目录 | `src/api/generated/models` |
+| 客户端 | `vue-query` |
+| mutator | `./src/api/customInstance.ts` 的 `customInstance` |
+
+### 命令
+
+```
+oas-codegen <fetch|generate|init> [options]
+
+fetch     从后端拉取 OpenAPI 规范并保存为 JSON
+generate  根据规范生成 TypeScript 类型与请求代码
+init      生成默认的 oas-codegen.config.ts
+```
+
+公共选项：`--config <path>`（配置文件路径，默认自动探测 `oas-codegen.config.ts` → `.mts`/`.cts`/`.js`/`.mjs`/`.cjs`/`.json`）。
+`init` 另支持 `--force` 覆盖已存在配置。
+
+## 配置参考
+
+```ts
+import { defineConfig } from 'oas-codegen'
+
+export default defineConfig({
+  source: {
+    type: 'springdoc',          // 'springdoc' | 'url' | 'file'
+    baseUrl: 'http://localhost:8082', // 后端地址；环境变量优先
+    specPath: '/v3/api-docs',   // springdoc 规范接口路径
+    url: 'http://x/api-docs',   // type='url' 时直接指定规范地址
+    envFile: '.env.local',      // 先读该文件（dotenv），再取环境变量
+    envBaseUrl: 'API_BASE_URL', // 覆盖 baseUrl 的环境变量名
+    output: 'specs/openapi.json',   // 规范保存路径（相对项目根）
+  },
+  generate: {
+    input: 'specs/openapi.json',    // 缺省取 source.output
+    target: 'src/api/generated/endpoints.ts',
+    schemas: 'src/api/generated/models',
+    client: 'vue-query',            // 'vue-query' | 'react-query' | 'axios' | 'fetch'
+    // queryVersion: 5,             // 显式锁定 TanStack Query 大版本；缺省由 orval 探测
+    mutator: {
+      name: 'customInstance',
+      path: './src/api/customInstance.ts',
+    },
+  },
+})
+```
+
+## source 类型
+
+| 类型 | 语义 | `fetch` 行为 |
+| --- | --- | --- |
+| `springdoc`（默认） | 从后端 `base + specPath` 拉规范 | 网络拉取，写入 `output` |
+| `url` | 直接指定规范地址 | 网络拉取，写入 `output` |
+| `file` | `output` 就是本地规范文件路径 | 读取并校验 JSON，**不重写**文件 |
+
+`file` 类型适用于离线 / CI / 私有源场景：把 spec 提交进仓库（有版本历史），`oas-codegen fetch` 只做校验、`oas-codegen generate` 直接读本地文件，全程不联网、无鉴权负担。
+
+## Mutator 契约（重要）
+
+orval 8 对自定义 HTTP 客户端采用 **axios 式 `(url, config)` 双参约定**（与 orval 7 的「单对象 config」不同）。你的 `customInstance` 必须长这样：
+
+```ts
+import request from './request'
+
+export const customInstance = <T>(
+  url: string,
+  config: {
+    method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'
+    headers?: Record<string, string>
+    body?: string        // orval 8 传 JSON.stringify 后的字符串（旧版是对象，注意）
+    params?: Record<string, any>
+    signal?: AbortSignal
+  },
+): Promise<T> => request({ url, ...config }) as Promise<T>
+```
+
+生成代码的调用形态：
+
+```ts
+// GET（query 已拼进 URL）
+customInstance<GetTaskResponse>(getGetTaskUrl(id), { ...options, method: 'GET' })
+// POST / PUT / PATCH / DELETE（body 已序列化）
+customInstance<LoginResponse>(getLoginUrl(), { ...options, method: 'POST', headers: { 'Content-Type': 'application/json', ... }, body: JSON.stringify(loginDTO) })
+```
+
+如果你的底层客户端（如 axios）期望 `data` 而不是 `body`，在 mutator 里自行映射即可。
+
+## 配置解析
+
+- 支持 `.ts` / `.js` / `.json` 等，`.ts` 通过 [jiti](https://github.com/unjs/jiti) 加载，无额外构建步骤
+- 找不到配置文件时返回全默认配置（即兼容旧 `export-api.mjs` + `orval.config.ts` 的行为）
+- `--config` 指向不存在的文件会直接报错，不会静默回退
+
+## 开发
+
+```bash
+pnpm dev          # tsx 直接跑 CLI
+pnpm typecheck    # tsc --noEmit
+pnpm test         # vitest
+pnpm build        # tsup 构建 dist/
+```
+
+## 说明
+
+- 生成过程中会在项目根目录短暂出现 `oas-codegen.orval.config.<pid>.mjs`（orval 把配置相对路径解析为配置文件所在目录，必须放在项目内），结束后自动删除；若进程被强杀可能残留，忽略或删除即可。
+- 版本号通过 `package.json` 读取，`--version` 无需手动同步。
+
+## 路线图
+
+- [x] M0 提取：`fetch` + `generate` 复刻旧流程
+- [x] M1 CLI + 配置 schema（zod 校验、默认值、`defineConfig` 类型提示）
+- [ ] M2 配方/模板系统：`customInstance` 脚手架、`init` 一键接入现有项目
+- [ ] M3 发布：semantic-release、npm provenance、publint / arethetypeswrong 校验
+- [ ] M4 文档站点与更丰富配方（react-query / fetch / 请求 mock）

package/dist/chunk-AWDG5OSK.js

@@ -0,0 +1,359 @@
+// src/config/schema.ts
+import { z } from "zod";
+var DEFAULT_MUTATOR = {
+  name: "customInstance",
+  path: "./src/api/customInstance.ts"
+};
+var DEFAULT_GENERATE = {
+  target: "src/api/generated/endpoints.ts",
+  schemas: "src/api/generated/models",
+  client: "vue-query"
+};
+var DEFAULT_SOURCE = {
+  type: "springdoc",
+  specPath: "/v3/api-docs",
+  envBaseUrl: "API_BASE_URL",
+  output: "specs/openapi.json"
+};
+var sourceSchema = z.object({
+  /** 来源类型：springdoc 后端接口 / 直接 URL / 本地文件 */
+  type: z.enum(["springdoc", "url", "file"]).default(DEFAULT_SOURCE.type),
+  /** 后端地址（springdoc 类型使用），环境变量优先 */
+  baseUrl: z.string().optional(),
+  /** springdoc 规范接口路径 */
+  specPath: z.string().default(DEFAULT_SOURCE.specPath),
+  /** url 类型时直接指定规范地址 */
+  url: z.string().optional(),
+  /** 读取该文件中的环境变量（如 .env.local），相对项目根目录 */
+  envFile: z.string().optional(),
+  /** 覆盖 baseUrl 的环境变量名 */
+  envBaseUrl: z.string().default(DEFAULT_SOURCE.envBaseUrl),
+  /** 规范保存路径，相对项目根目录 */
+  output: z.string().default(DEFAULT_SOURCE.output)
+});
+var generateSchema = z.object({
+  /** spec 输入路径，默认取 source.output */
+  input: z.string().optional(),
+  /** 生成的 API 入口文件 */
+  target: z.string().default(DEFAULT_GENERATE.target),
+  /** 生成的类型定义目录 */
+  schemas: z.string().default(DEFAULT_GENERATE.schemas),
+  /** 客户端配方 */
+  client: z.enum(["vue-query", "react-query", "axios", "fetch"]).default(DEFAULT_GENERATE.client),
+  /** 请求 mutator（axios 封装约定） */
+  mutator: z.object({
+    name: z.string().default(DEFAULT_MUTATOR.name),
+    path: z.string().default(DEFAULT_MUTATOR.path)
+  }).optional(),
+  /** TanStack Query 大版本；缺省时由 orval 从项目依赖探测（探测不到会回退 v4） */
+  queryVersion: z.union([z.literal(4), z.literal(5)]).optional()
+});
+var configSchema = z.object({
+  source: sourceSchema.default(DEFAULT_SOURCE),
+  generate: generateSchema.default(DEFAULT_GENERATE)
+});
+
+// src/config/load.ts
+import fs from "fs";
+import path from "path";
+import { createJiti } from "jiti";
+var DEFAULT_CONFIG_FILE = "oas-codegen.config.ts";
+var CONFIG_FILE_EXTS = [".ts", ".mts", ".cts", ".js", ".mjs", ".cjs", ".json"];
+function resolveConfigFile(cwd, configFile) {
+  if (configFile) return path.resolve(cwd, configFile);
+  for (const ext of CONFIG_FILE_EXTS) {
+    const candidate = path.resolve(cwd, `oas-codegen.config${ext}`);
+    if (fs.existsSync(candidate)) return candidate;
+  }
+  return void 0;
+}
+function firstLine(err) {
+  const msg = err instanceof Error ? err.message : String(err);
+  return msg.split("\n")[0] ?? msg;
+}
+async function loadConfig(cwd, configFile) {
+  const abs = resolveConfigFile(cwd, configFile);
+  if (!abs) return configSchema.parse({});
+  if (!fs.existsSync(abs)) {
+    throw new Error(`\u914D\u7F6E\u6587\u4EF6\u4E0D\u5B58\u5728: ${abs}
+\uFF08\u53EF\u7528 "oas-codegen init" \u751F\u6210\u9ED8\u8BA4\u914D\u7F6E\uFF09`);
+  }
+  let raw;
+  if (abs.endsWith(".json")) {
+    try {
+      raw = JSON.parse(fs.readFileSync(abs, "utf8"));
+    } catch (err) {
+      throw new Error(`\u914D\u7F6E\u6587\u4EF6\u4E0D\u662F\u5408\u6CD5 JSON: ${abs}
+\u539F\u56E0: ${firstLine(err)}`);
+    }
+  } else {
+    try {
+      const jiti = createJiti(import.meta.url, { interopDefault: true });
+      const mod = await jiti.import(abs);
+      raw = mod?.default ?? mod;
+    } catch (err) {
+      throw new Error(`\u52A0\u8F7D\u914D\u7F6E\u6587\u4EF6\u5931\u8D25: ${abs}
+\u539F\u56E0: ${firstLine(err)}`);
+    }
+  }
+  return configSchema.parse(raw);
+}
+
+// src/spec/fetch.ts
+import fs2 from "fs";
+import path2 from "path";
+async function fetchSpec(url) {
+  let res;
+  try {
+    res = await fetch(url);
+  } catch (err) {
+    throw new Error(`\u65E0\u6CD5\u8FDE\u63A5 ${url}: ${err.message}`);
+  }
+  if (!res.ok) {
+    throw new Error(`\u62C9\u53D6 OpenAPI \u5931\u8D25: ${res.status} ${res.statusText}
+${url}
+\u8BF7\u786E\u8BA4\u540E\u7AEF\u5DF2\u542F\u52A8\u3002`);
+  }
+  return res.json();
+}
+function writeSpec(spec, output) {
+  fs2.mkdirSync(path2.dirname(output), { recursive: true });
+  fs2.writeFileSync(output, JSON.stringify(spec, null, 2));
+}
+function readLocalSpec(file) {
+  let raw;
+  try {
+    raw = fs2.readFileSync(file, "utf8");
+  } catch (err) {
+    throw new Error(`\u8BFB\u53D6\u672C\u5730 OpenAPI \u89C4\u8303\u5931\u8D25: ${file}
+\u539F\u56E0: ${err.message}`);
+  }
+  try {
+    return JSON.parse(raw);
+  } catch (err) {
+    throw new Error(`\u672C\u5730\u89C4\u8303\u4E0D\u662F\u5408\u6CD5 JSON: ${file}
+\u539F\u56E0: ${err.message}`);
+  }
+}
+
+// src/spec/source.ts
+import fs3 from "fs";
+import path3 from "path";
+import dotenv from "dotenv";
+function loadEnvFile(envFile, cwd) {
+  if (!envFile) return;
+  const file = path3.resolve(cwd, envFile);
+  if (!fs3.existsSync(file)) return;
+  dotenv.config({ path: file });
+}
+function resolveSource(source, cwd) {
+  const output = path3.resolve(cwd, source.output);
+  if (source.type === "url") {
+    if (!source.url) throw new Error('source.type = "url" \u65F6\u5FC5\u987B\u63D0\u4F9B source.url');
+    return { url: source.url, output };
+  }
+  if (source.type === "springdoc") {
+    const base = process.env[source.envBaseUrl] || source.baseUrl || "http://localhost:8082";
+    const url = `${base.replace(/\/+$/, "")}${source.specPath}`;
+    return { url, output };
+  }
+  return { url: void 0, output };
+}
+
+// src/commands/fetch.ts
+async function runFetch(opts = {}) {
+  const cwd = opts.cwd ?? process.cwd();
+  const config = await loadConfig(cwd, opts.config);
+  loadEnvFile(config.source.envFile, cwd);
+  const { url, output } = resolveSource(config.source, cwd);
+  if (url === void 0) {
+    if (!opts.silent) console.log(`Reading OpenAPI spec from ${output} ...`);
+    const spec2 = readLocalSpec(output);
+    if (!opts.silent) console.log(`Validated ${output}`);
+    return { url, output, spec: spec2 };
+  }
+  if (!opts.silent) console.log(`Fetching OpenAPI spec from ${url} ...`);
+  const spec = await fetchSpec(url);
+  writeSpec(spec, output);
+  if (!opts.silent) console.log(`Saved to ${output}`);
+  return { url, output, spec };
+}
+
+// src/generate/orval.ts
+import fs4 from "fs";
+import path4 from "path";
+import { spawn } from "child_process";
+import { createRequire } from "module";
+var require2 = createRequire(import.meta.url);
+var ORVAL_PROJECT = "generated";
+function resolveMutator(g) {
+  return g.mutator ?? (g.client === "vue-query" ? { ...DEFAULT_MUTATOR } : void 0);
+}
+function renderOrvalConfig(config) {
+  const g = config.generate;
+  const input = toPosix(g.input ?? config.source.output);
+  const mutator = resolveMutator(g);
+  return {
+    [ORVAL_PROJECT]: {
+      input,
+      output: {
+        target: toPosix(g.target),
+        schemas: toPosix(g.schemas),
+        client: g.client,
+        mock: false,
+        override: {
+          ...mutator ? { mutator: { name: mutator.name, path: toPosix(mutator.path) } } : {},
+          query: {
+            useQuery: true,
+            ...g.queryVersion !== void 0 ? { version: g.queryVersion } : {}
+          }
+        }
+      }
+    }
+  };
+}
+function toPosix(p) {
+  return p.replace(/\\/g, "/");
+}
+function resolveOrvalBin() {
+  const entry = require2.resolve("orval");
+  let dir = path4.dirname(entry);
+  for (; ; ) {
+    const pkgJson = path4.join(dir, "package.json");
+    if (fs4.existsSync(pkgJson)) {
+      const pkg = JSON.parse(fs4.readFileSync(pkgJson, "utf8"));
+      if (pkg.name === "orval" && pkg.bin) {
+        const bin = typeof pkg.bin === "string" ? pkg.bin : pkg.bin.orval;
+        if (bin) return path4.join(dir, bin);
+      }
+    }
+    const parent = path4.dirname(dir);
+    if (parent === dir) {
+      throw new Error("\u672A\u627E\u5230 orval \u53EF\u6267\u884C\u6587\u4EF6\uFF0C\u8BF7\u786E\u8BA4\u4F9D\u8D56\u5DF2\u5B89\u88C5\uFF08pnpm install\uFF09");
+    }
+    dir = parent;
+  }
+}
+function runOrval(args, cwd) {
+  const bin = resolveOrvalBin();
+  return new Promise((resolve, reject) => {
+    const child = spawn(process.execPath, [bin, ...args], { cwd, stdio: "inherit" });
+    let settled = false;
+    const finish = (fn) => {
+      if (!settled) {
+        settled = true;
+        fn();
+      }
+    };
+    child.once("error", (err) => finish(() => reject(new Error(`\u65E0\u6CD5\u542F\u52A8 orval: ${err.message}`))));
+    child.once(
+      "exit",
+      (code) => finish(() => {
+        if (code === 0) resolve();
+        else reject(new Error(`orval \u9000\u51FA\uFF0C\u9000\u51FA\u7801 ${code}`));
+      })
+    );
+  });
+}
+
+// src/commands/generate.ts
+import fs5 from "fs";
+import path5 from "path";
+function tempConfigPath(cwd) {
+  return path5.join(cwd, `oas-codegen.orval.config.${process.pid}.mjs`);
+}
+async function runGenerate(opts = {}) {
+  const cwd = opts.cwd ?? process.cwd();
+  const config = await loadConfig(cwd, opts.config);
+  const input = path5.resolve(cwd, config.generate.input ?? config.source.output);
+  if (!fs5.existsSync(input)) {
+    throw new Error(`\u627E\u4E0D\u5230 OpenAPI spec: ${input}
+\u8BF7\u5148\u8FD0\u884C "oas-codegen fetch"\u3002`);
+  }
+  const mutator = resolveMutator(config.generate);
+  if (mutator) {
+    const mutatorFile = path5.resolve(cwd, mutator.path);
+    if (!fs5.existsSync(mutatorFile)) {
+      throw new Error(
+        `\u627E\u4E0D\u5230 mutator \u6587\u4EF6: ${mutatorFile}
+\u81EA\u5B9A\u4E49 HTTP \u5BA2\u6237\u7AEF\u9700\u8981\u5148\u521B\u5EFA\u8BE5\u6587\u4EF6\uFF08\u7B7E\u540D\u89C1 README\u300CMutator \u5951\u7EA6\u300D\uFF09\uFF0C\u6216\u8C03\u6574 generate.mutator \u6307\u5411\u5DF2\u6709\u6587\u4EF6\u3002`
+      );
+    }
+  }
+  const tmpFile = tempConfigPath(cwd);
+  fs5.writeFileSync(tmpFile, `export default ${JSON.stringify(renderOrvalConfig(config), null, 2)}
+`);
+  console.log(`Generating TypeScript from ${input} ...`);
+  try {
+    await runOrval(["--config", tmpFile], cwd);
+    console.log("Done.");
+  } finally {
+    fs5.rmSync(tmpFile, { force: true });
+  }
+}
+
+// src/commands/init.ts
+import fs6 from "fs";
+import path6 from "path";
+var CONFIG_TEMPLATE = `import { defineConfig } from 'oas-codegen'
+
+export default defineConfig({
+  source: {
+    type: 'springdoc',
+    // \u540E\u7AEF\u5730\u5740\uFF1A\u4F18\u5148\u8BFB\u73AF\u5883\u53D8\u91CF API_BASE_URL\uFF0C\u672A\u8BBE\u7F6E\u65F6\u7528 baseUrl
+    baseUrl: 'http://localhost:8082',
+    specPath: '/v3/api-docs',
+    envFile: '.env.local',
+    output: 'specs/openapi.json',
+  },
+  generate: {
+    target: 'src/api/generated/endpoints.ts',
+    schemas: 'src/api/generated/models',
+    client: 'vue-query',
+    // \u663E\u5F0F\u9501\u5B9A TanStack Query \u5927\u7248\u672C\uFF084 \u6216 5\uFF09\uFF1B\u4E0D\u5199\u5219\u6309\u9879\u76EE\u4F9D\u8D56\u81EA\u52A8\u63A2\u6D4B
+    // queryVersion: 5,
+    // mutator \u9700\u4E3A (url, config) \u53CC\u53C2\u7EA6\u5B9A\uFF08orval 8 \u6807\u51C6\uFF09\uFF0C\u5B57\u6BB5\u89C1 README
+    mutator: {
+      name: 'customInstance',
+      path: './src/api/customInstance.ts',
+    },
+  },
+})
+`;
+function runInit(opts = {}) {
+  const cwd = opts.cwd ?? process.cwd();
+  const file = path6.join(cwd, DEFAULT_CONFIG_FILE);
+  if (fs6.existsSync(file) && !opts.force) {
+    console.log(`\u5DF2\u5B58\u5728 ${DEFAULT_CONFIG_FILE}\uFF0C\u8DF3\u8FC7\uFF08\u52A0 --force \u8986\u76D6\uFF09`);
+    return;
+  }
+  fs6.writeFileSync(file, CONFIG_TEMPLATE);
+  console.log(`\u5DF2\u521B\u5EFA ${DEFAULT_CONFIG_FILE}`);
+  console.log("\u63A5\u4E0B\u6765\uFF1Aoas-codegen fetch && oas-codegen generate");
+}
+
+export {
+  DEFAULT_MUTATOR,
+  DEFAULT_GENERATE,
+  DEFAULT_SOURCE,
+  sourceSchema,
+  generateSchema,
+  configSchema,
+  DEFAULT_CONFIG_FILE,
+  loadConfig,
+  fetchSpec,
+  writeSpec,
+  readLocalSpec,
+  loadEnvFile,
+  resolveSource,
+  runFetch,
+  ORVAL_PROJECT,
+  resolveMutator,
+  renderOrvalConfig,
+  resolveOrvalBin,
+  runOrval,
+  runGenerate,
+  CONFIG_TEMPLATE,
+  runInit
+};
+//# sourceMappingURL=chunk-AWDG5OSK.js.map

package/dist/chunk-AWDG5OSK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/schema.ts","../src/config/load.ts","../src/spec/fetch.ts","../src/spec/source.ts","../src/commands/fetch.ts","../src/generate/orval.ts","../src/commands/generate.ts","../src/commands/init.ts"],"sourcesContent":["import { z } from 'zod'\n\n/** 默认 mutator：生成的调用统一走项目自己的 axios 封装。 */\nexport const DEFAULT_MUTATOR = {\n  name: 'customInstance',\n  path: './src/api/customInstance.ts',\n} as const\n\n/** 未配置 generate 时的默认配方（daily-task 的 orval 约定）。 */\nexport const DEFAULT_GENERATE = {\n  target: 'src/api/generated/endpoints.ts',\n  schemas: 'src/api/generated/models',\n  client: 'vue-query',\n} as const\n\n/**\n * 未配置 source 时的默认值。刻意等价于 daily-task 旧 export-api.mjs 的行为，\n * 这样「什么都不写」就是历史行为，迁移零成本。\n */\nexport const DEFAULT_SOURCE = {\n  type: 'springdoc',\n  specPath: '/v3/api-docs',\n  envBaseUrl: 'API_BASE_URL',\n  output: 'specs/openapi.json',\n} as const\n\n/** spec 来源配置：从哪拿 OpenAPI 规范。 */\nexport const sourceSchema = z.object({\n  /** 来源类型：springdoc 后端接口 / 直接 URL / 本地文件 */\n  type: z.enum(['springdoc', 'url', 'file']).default(DEFAULT_SOURCE.type),\n  /** 后端地址（springdoc 类型使用），环境变量优先 */\n  baseUrl: z.string().optional(),\n  /** springdoc 规范接口路径 */\n  specPath: z.string().default(DEFAULT_SOURCE.specPath),\n  /** url 类型时直接指定规范地址 */\n  url: z.string().optional(),\n  /** 读取该文件中的环境变量（如 .env.local），相对项目根目录 */\n  envFile: z.string().optional(),\n  /** 覆盖 baseUrl 的环境变量名 */\n  envBaseUrl: z.string().default(DEFAULT_SOURCE.envBaseUrl),\n  /** 规范保存路径，相对项目根目录 */\n  output: z.string().default(DEFAULT_SOURCE.output),\n})\n\n/** 生成配置：spec → TypeScript 客户端代码的产出约定。 */\nexport const generateSchema = z.object({\n  /** spec 输入路径，默认取 source.output */\n  input: z.string().optional(),\n  /** 生成的 API 入口文件 */\n  target: z.string().default(DEFAULT_GENERATE.target),\n  /** 生成的类型定义目录 */\n  schemas: z.string().default(DEFAULT_GENERATE.schemas),\n  /** 客户端配方 */\n  client: z\n    .enum(['vue-query', 'react-query', 'axios', 'fetch'])\n    .default(DEFAULT_GENERATE.client),\n  /** 请求 mutator（axios 封装约定） */\n  mutator: z\n    .object({\n      name: z.string().default(DEFAULT_MUTATOR.name),\n      path: z.string().default(DEFAULT_MUTATOR.path),\n    })\n    .optional(),\n  /** TanStack Query 大版本；缺省时由 orval 从项目依赖探测（探测不到会回退 v4） */\n  queryVersion: z.union([z.literal(4), z.literal(5)]).optional(),\n})\n\nexport type SourceConfig = z.infer<typeof sourceSchema>\nexport type SourceConfigInput = z.input<typeof sourceSchema>\nexport type GenerateConfig = z.infer<typeof generateSchema>\nexport type GenerateConfigInput = z.input<typeof generateSchema>\n\nexport const configSchema = z.object({\n  source: sourceSchema.default(DEFAULT_SOURCE),\n  generate: generateSchema.default(DEFAULT_GENERATE),\n})\n\nexport type OasConfig = z.infer<typeof configSchema>\n","import fs from 'node:fs'\nimport path from 'node:path'\nimport { createJiti } from 'jiti'\nimport { configSchema, type OasConfig } from './schema.js'\n\nexport const DEFAULT_CONFIG_FILE = 'oas-codegen.config.ts'\n\n/** 未显式指定 --config 时按顺序探测的配置文件后缀（对齐 vite/tsup 的习惯）。 */\nconst CONFIG_FILE_EXTS = ['.ts', '.mts', '.cts', '.js', '.mjs', '.cjs', '.json']\n\n/** 解析配置文件绝对路径；显式指定但不存在时返回该路径，由调用方报错。 */\nfunction resolveConfigFile(cwd: string, configFile?: string): string | undefined {\n  if (configFile) return path.resolve(cwd, configFile)\n  for (const ext of CONFIG_FILE_EXTS) {\n    const candidate = path.resolve(cwd, `oas-codegen.config${ext}`)\n    if (fs.existsSync(candidate)) return candidate\n  }\n  return undefined\n}\n\nfunction firstLine(err: unknown): string {\n  const msg = err instanceof Error ? err.message : String(err)\n  return msg.split('\\n')[0] ?? msg\n}\n\n/**\n * 加载 oas-codegen 配置文件，返回「生效配置」（默认值已填充）。\n * 未找到配置文件时返回全默认配置，即兼容旧 export-api.mjs + orval.config.ts 的行为。\n * 支持 .ts / .mts / .cts / .js / .mjs / .cjs / .json。\n */\nexport async function loadConfig(cwd: string, configFile?: string): Promise<OasConfig> {\n  const abs = resolveConfigFile(cwd, configFile)\n\n  if (!abs) return configSchema.parse({})\n  if (!fs.existsSync(abs)) {\n    throw new Error(`配置文件不存在: ${abs}\\n（可用 \"oas-codegen init\" 生成默认配置）`)\n  }\n\n  let raw: unknown\n  if (abs.endsWith('.json')) {\n    try {\n      raw = JSON.parse(fs.readFileSync(abs, 'utf8'))\n    } catch (err) {\n      throw new Error(`配置文件不是合法 JSON: ${abs}\\n原因: ${firstLine(err)}`)\n    }\n  } else {\n    try {\n      const jiti = createJiti(import.meta.url, { interopDefault: true })\n      const mod = (await jiti.import(abs)) as Record<string, unknown> | undefined\n      raw = mod?.default ?? mod\n    } catch (err) {\n      throw new Error(`加载配置文件失败: ${abs}\\n原因: ${firstLine(err)}`)\n    }\n  }\n\n  return configSchema.parse(raw)\n}\n","import fs from 'node:fs'\nimport path from 'node:path'\n\n/** 从指定 URL 拉取 OpenAPI 规范并解析为 JSON。 */\nexport async function fetchSpec(url: string): Promise<unknown> {\n  let res: Response\n  try {\n    res = await fetch(url)\n  } catch (err) {\n    throw new Error(`无法连接 ${url}: ${(err as Error).message}`)\n  }\n  if (!res.ok) {\n    throw new Error(`拉取 OpenAPI 失败: ${res.status} ${res.statusText}\\n${url}\\n请确认后端已启动。`)\n  }\n  return res.json() as Promise<unknown>\n}\n\n/** 将规范以 2 空格缩进的 JSON 写入磁盘（自动创建目录）。 */\nexport function writeSpec(spec: unknown, output: string): void {\n  fs.mkdirSync(path.dirname(output), { recursive: true })\n  fs.writeFileSync(output, JSON.stringify(spec, null, 2))\n}\n\n/** 读取本地 OpenAPI 规范文件并解析为 JSON（file 类型使用，不重写文件）。 */\nexport function readLocalSpec(file: string): unknown {\n  let raw: string\n  try {\n    raw = fs.readFileSync(file, 'utf8')\n  } catch (err) {\n    throw new Error(`读取本地 OpenAPI 规范失败: ${file}\\n原因: ${(err as Error).message}`)\n  }\n  try {\n    return JSON.parse(raw)\n  } catch (err) {\n    throw new Error(`本地规范不是合法 JSON: ${file}\\n原因: ${(err as Error).message}`)\n  }\n}\n","import fs from 'node:fs'\nimport path from 'node:path'\nimport dotenv from 'dotenv'\nimport type { SourceConfig } from '../config/schema.js'\n\nexport interface ResolvedSource {\n  /** 最终请求的 spec 地址；file 类型为 undefined */\n  url: string | undefined\n  /** 保存 spec 的绝对路径 */\n  output: string\n}\n\n/** 加载 envFile（如 .env.local）中的变量到 process.env，缺省静默跳过。 */\nexport function loadEnvFile(envFile: string | undefined, cwd: string): void {\n  if (!envFile) return\n  const file = path.resolve(cwd, envFile)\n  if (!fs.existsSync(file)) return\n  dotenv.config({ path: file })\n}\n\n/** 将配置的 source 解析成具体的请求地址与输出路径（处理环境变量优先级与默认值）。 */\nexport function resolveSource(source: SourceConfig, cwd: string): ResolvedSource {\n  const output = path.resolve(cwd, source.output)\n\n  if (source.type === 'url') {\n    if (!source.url) throw new Error('source.type = \"url\" 时必须提供 source.url')\n    return { url: source.url, output }\n  }\n\n  if (source.type === 'springdoc') {\n    const base = process.env[source.envBaseUrl] || source.baseUrl || 'http://localhost:8082'\n    const url = `${base.replace(/\\/+$/, '')}${source.specPath}`\n    return { url, output }\n  }\n\n  // file 类型：output 就是本地规范文件路径，无网络请求\n  return { url: undefined, output }\n}\n","import { loadConfig } from '../config/load.js'\nimport { fetchSpec, readLocalSpec, writeSpec } from '../spec/fetch.js'\nimport { loadEnvFile, resolveSource } from '../spec/source.js'\n\nexport interface FetchOptions {\n  config?: string\n  cwd?: string\n  /** 静默模式（供编程调用时使用），默认打印过程日志 */\n  silent?: boolean\n}\n\nexport interface FetchResult {\n  url: string | undefined\n  output: string\n  spec: unknown\n}\n\n/** 获取 OpenAPI 规范：springdoc/url 从网络拉取并落盘，file 类型读取本地文件校验。 */\nexport async function runFetch(opts: FetchOptions = {}): Promise<FetchResult> {\n  const cwd = opts.cwd ?? process.cwd()\n  const config = await loadConfig(cwd, opts.config)\n  loadEnvFile(config.source.envFile, cwd)\n  const { url, output } = resolveSource(config.source, cwd)\n\n  if (url === undefined) {\n    // file 类型：规范已在本地，读取校验即可（不重写，避免污染提交的文件）\n    if (!opts.silent) console.log(`Reading OpenAPI spec from ${output} ...`)\n    const spec = readLocalSpec(output)\n    if (!opts.silent) console.log(`Validated ${output}`)\n    return { url, output, spec }\n  }\n\n  if (!opts.silent) console.log(`Fetching OpenAPI spec from ${url} ...`)\n  const spec = await fetchSpec(url)\n  writeSpec(spec, output)\n  if (!opts.silent) console.log(`Saved to ${output}`)\n\n  return { url, output, spec }\n}\n","import fs from 'node:fs'\nimport path from 'node:path'\nimport { spawn } from 'node:child_process'\nimport { createRequire } from 'node:module'\nimport { DEFAULT_MUTATOR, type GenerateConfig, type OasConfig } from '../config/schema.js'\n\nconst require = createRequire(import.meta.url)\n\n/** orval 配置里的统一项目名。 */\nexport const ORVAL_PROJECT = 'generated'\n\n/**\n * 解析生效的 mutator：显式配置优先；缺省时仅默认配方（vue-query）注入 customInstance。\n * react-query / axios / fetch 不自动绑 mutator，避免凭空要求 customInstance 文件存在。\n */\nexport function resolveMutator(g: GenerateConfig): { name: string; path: string } | undefined {\n  return g.mutator ?? (g.client === 'vue-query' ? { ...DEFAULT_MUTATOR } : undefined)\n}\n\n/** 将 oas-codegen 配置渲染成 orval 可执行的配置对象。 */\nexport function renderOrvalConfig(config: OasConfig): Record<string, unknown> {\n  const g = config.generate\n  const input = toPosix(g.input ?? config.source.output)\n  const mutator = resolveMutator(g)\n\n  return {\n    [ORVAL_PROJECT]: {\n      input,\n      output: {\n        target: toPosix(g.target),\n        schemas: toPosix(g.schemas),\n        client: g.client,\n        mock: false,\n        override: {\n          ...(mutator ? { mutator: { name: mutator.name, path: toPosix(mutator.path) } } : {}),\n          query: {\n            useQuery: true,\n            ...(g.queryVersion !== undefined ? { version: g.queryVersion } : {}),\n          },\n        },\n      },\n    },\n  }\n}\n\nfunction toPosix(p: string): string {\n  return p.replace(/\\\\/g, '/')\n}\n\n/**\n * 解析包内置 orval 的可执行入口（读取依赖包 package.json 的 bin 字段）。\n * 不依赖 exports map，向上遍历目录定位 orval 包根。\n */\nexport function resolveOrvalBin(): string {\n  const entry = require.resolve('orval')\n  let dir = path.dirname(entry)\n  for (;;) {\n    const pkgJson = path.join(dir, 'package.json')\n    if (fs.existsSync(pkgJson)) {\n      const pkg = JSON.parse(fs.readFileSync(pkgJson, 'utf8'))\n      if (pkg.name === 'orval' && pkg.bin) {\n        const bin = typeof pkg.bin === 'string' ? pkg.bin : pkg.bin.orval\n        if (bin) return path.join(dir, bin)\n      }\n    }\n    const parent = path.dirname(dir)\n    if (parent === dir) {\n      throw new Error('未找到 orval 可执行文件，请确认依赖已安装（pnpm install）')\n    }\n    dir = parent\n  }\n}\n\n/** 以指定 cwd 运行 orval，stdio 直接透传，失败时 reject。 */\nexport function runOrval(args: string[], cwd: string): Promise<void> {\n  const bin = resolveOrvalBin()\n  return new Promise((resolve, reject) => {\n    const child = spawn(process.execPath, [bin, ...args], { cwd, stdio: 'inherit' })\n    let settled = false\n    const finish = (fn: () => void) => {\n      if (!settled) {\n        settled = true\n        fn()\n      }\n    }\n    child.once('error', (err) => finish(() => reject(new Error(`无法启动 orval: ${err.message}`))))\n    child.once('exit', (code) =>\n      finish(() => {\n        if (code === 0) resolve()\n        else reject(new Error(`orval 退出，退出码 ${code}`))\n      }),\n    )\n  })\n}\n","import fs from 'node:fs'\nimport path from 'node:path'\nimport { loadConfig } from '../config/load.js'\nimport { renderOrvalConfig, resolveMutator, runOrval } from '../generate/orval.js'\n\nexport interface GenerateOptions {\n  config?: string\n  cwd?: string\n}\n\n/**\n * 临时 orval 配置写在项目根目录，而不是系统临时目录：\n * orval 把配置里的相对路径解析为「相对于配置文件所在目录」，\n * 写到 tmpdir 会让 spec / 输出路径全部指向错误的目录。\n */\nfunction tempConfigPath(cwd: string): string {\n  return path.join(cwd, `oas-codegen.orval.config.${process.pid}.mjs`)\n}\n\n/** 根据本地 spec 生成 TypeScript 客户端代码。 */\nexport async function runGenerate(opts: GenerateOptions = {}): Promise<void> {\n  const cwd = opts.cwd ?? process.cwd()\n  const config = await loadConfig(cwd, opts.config)\n\n  const input = path.resolve(cwd, config.generate.input ?? config.source.output)\n  if (!fs.existsSync(input)) {\n    throw new Error(`找不到 OpenAPI spec: ${input}\\n请先运行 \"oas-codegen fetch\"。`)\n  }\n\n  // orval 会读取 mutator 文件来确定生成代码的签名；缺失时给它一个可读错误而不是 ENOENT。\n  const mutator = resolveMutator(config.generate)\n  if (mutator) {\n    const mutatorFile = path.resolve(cwd, mutator.path)\n    if (!fs.existsSync(mutatorFile)) {\n      throw new Error(\n        `找不到 mutator 文件: ${mutatorFile}\\n` +\n          `自定义 HTTP 客户端需要先创建该文件（签名见 README「Mutator 契约」），或调整 generate.mutator 指向已有文件。`,\n      )\n    }\n  }\n\n  const tmpFile = tempConfigPath(cwd)\n  fs.writeFileSync(tmpFile, `export default ${JSON.stringify(renderOrvalConfig(config), null, 2)}\\n`)\n\n  console.log(`Generating TypeScript from ${input} ...`)\n  try {\n    await runOrval(['--config', tmpFile], cwd)\n    console.log('Done.')\n  } finally {\n    fs.rmSync(tmpFile, { force: true })\n  }\n}\n","import fs from 'node:fs'\nimport path from 'node:path'\nimport { DEFAULT_CONFIG_FILE } from '../config/load.js'\n\nexport interface InitOptions {\n  cwd?: string\n  force?: boolean\n}\n\n/** 默认的 oas-codegen.config.ts 模板（与 daily-task 现行约定一致）。 */\nexport const CONFIG_TEMPLATE = `import { defineConfig } from 'oas-codegen'\n\nexport default defineConfig({\n  source: {\n    type: 'springdoc',\n    // 后端地址：优先读环境变量 API_BASE_URL，未设置时用 baseUrl\n    baseUrl: 'http://localhost:8082',\n    specPath: '/v3/api-docs',\n    envFile: '.env.local',\n    output: 'specs/openapi.json',\n  },\n  generate: {\n    target: 'src/api/generated/endpoints.ts',\n    schemas: 'src/api/generated/models',\n    client: 'vue-query',\n    // 显式锁定 TanStack Query 大版本（4 或 5）；不写则按项目依赖自动探测\n    // queryVersion: 5,\n    // mutator 需为 (url, config) 双参约定（orval 8 标准），字段见 README\n    mutator: {\n      name: 'customInstance',\n      path: './src/api/customInstance.ts',\n    },\n  },\n})\n`\n\n/** 在目标项目根目录生成配置文件。 */\nexport function runInit(opts: InitOptions = {}): void {\n  const cwd = opts.cwd ?? process.cwd()\n  const file = path.join(cwd, DEFAULT_CONFIG_FILE)\n\n  if (fs.existsSync(file) && !opts.force) {\n    console.log(`已存在 ${DEFAULT_CONFIG_FILE}，跳过（加 --force 覆盖）`)\n    return\n  }\n\n  fs.writeFileSync(file, CONFIG_TEMPLATE)\n  console.log(`已创建 ${DEFAULT_CONFIG_FILE}`)\n  console.log('接下来：oas-codegen fetch && oas-codegen generate')\n}\n"],"mappings":"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","names":["fs","path","fs","path","spec","fs","path","require","path","fs","fs","path","path","fs","fs","path","path","fs"]}

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+import {
+  runFetch,
+  runGenerate,
+  runInit
+} from "./chunk-AWDG5OSK.js";
+
+// src/cli.ts
+import { readFileSync } from "fs";
+import { defineCommand, runMain, showUsage } from "citty";
+function readVersion() {
+  try {
+    const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+    return typeof pkg.version === "string" ? pkg.version : void 0;
+  } catch {
+    return void 0;
+  }
+}
+var configArg = {
+  type: "string",
+  description: "\u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84\uFF08\u9ED8\u8BA4 ./oas-codegen.config.ts\uFF09",
+  valueHint: "path"
+};
+var subCommands = {
+  fetch: defineCommand({
+    meta: { name: "fetch", description: "\u4ECE\u540E\u7AEF\u62C9\u53D6 OpenAPI \u89C4\u8303\u5E76\u4FDD\u5B58\u4E3A JSON" },
+    args: { config: configArg },
+    async run({ args }) {
+      await runFetch({ config: args.config });
+    }
+  }),
+  generate: defineCommand({
+    meta: { name: "generate", description: "\u6839\u636E\u89C4\u8303\u751F\u6210 TypeScript \u7C7B\u578B\u4E0E\u8BF7\u6C42\u4EE3\u7801" },
+    args: { config: configArg },
+    async run({ args }) {
+      await runGenerate({ config: args.config });
+    }
+  }),
+  init: defineCommand({
+    meta: { name: "init", description: "\u751F\u6210\u9ED8\u8BA4\u7684 oas-codegen.config.ts" },
+    args: {
+      force: { type: "boolean", description: "\u8986\u76D6\u5DF2\u5B58\u5728\u7684\u914D\u7F6E\u6587\u4EF6" }
+    },
+    run({ args }) {
+      runInit({ force: args.force });
+    }
+  })
+};
+var main = defineCommand({
+  meta: {
+    name: "oas-codegen",
+    version: readVersion(),
+    description: "OpenAPI \u2192 TypeScript \u5BA2\u6237\u7AEF\u4EE3\u7801\u751F\u6210\uFF08\u5C01\u88C5 orval \u7684\u914D\u65B9\u5316 CLI\uFF09"
+  },
+  subCommands,
+  async run(ctx) {
+    const first = ctx.rawArgs.find((arg) => !arg.startsWith("-"));
+    if (first && first in subCommands) return;
+    await showUsage(ctx.cmd);
+    process.exit(1);
+  }
+});
+runMain(main);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { readFileSync } from 'node:fs'\nimport { defineCommand, runMain, showUsage } from 'citty'\nimport { runFetch } from './commands/fetch.js'\nimport { runGenerate } from './commands/generate.js'\nimport { runInit } from './commands/init.js'\n\n/** 读取包根 package.json 的版本号（src/ 与 dist/ 上移一级都是包根）。 */\nfunction readVersion(): string | undefined {\n  try {\n    const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'))\n    return typeof pkg.version === 'string' ? pkg.version : undefined\n  } catch {\n    return undefined\n  }\n}\n\nconst configArg = {\n  type: 'string' as const,\n  description: '配置文件路径（默认 ./oas-codegen.config.ts）',\n  valueHint: 'path',\n}\n\nconst subCommands = {\n  fetch: defineCommand({\n    meta: { name: 'fetch', description: '从后端拉取 OpenAPI 规范并保存为 JSON' },\n    args: { config: configArg },\n    async run({ args }) {\n      await runFetch({ config: args.config })\n    },\n  }),\n  generate: defineCommand({\n    meta: { name: 'generate', description: '根据规范生成 TypeScript 类型与请求代码' },\n    args: { config: configArg },\n    async run({ args }) {\n      await runGenerate({ config: args.config })\n    },\n  }),\n  init: defineCommand({\n    meta: { name: 'init', description: '生成默认的 oas-codegen.config.ts' },\n    args: {\n      force: { type: 'boolean' as const, description: '覆盖已存在的配置文件' },\n    },\n    run({ args }) {\n      runInit({ force: args.force })\n    },\n  }),\n}\n\nconst main = defineCommand({\n  meta: {\n    name: 'oas-codegen',\n    version: readVersion(),\n    description: 'OpenAPI → TypeScript 客户端代码生成（封装 orval 的配方化 CLI）',\n  },\n  subCommands,\n  async run(ctx) {\n    // citty 在子命令执行完毕后仍会调用主命令的 run，所以这里只在「没跑任何子命令」时打印帮助\n    const first = ctx.rawArgs.find((arg) => !arg.startsWith('-'))\n    if (first && first in subCommands) return\n    await showUsage(ctx.cmd)\n    process.exit(1)\n  },\n})\n\nrunMain(main)\n"],"mappings":";;;;;;;;AACA,SAAS,oBAAoB;AAC7B,SAAS,eAAe,SAAS,iBAAiB;AAMlD,SAAS,cAAkC;AACzC,MAAI;AACF,UAAM,MAAM,KAAK,MAAM,aAAa,IAAI,IAAI,mBAAmB,YAAY,GAAG,GAAG,MAAM,CAAC;AACxF,WAAO,OAAO,IAAI,YAAY,WAAW,IAAI,UAAU;AAAA,EACzD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,IAAM,YAAY;AAAA,EAChB,MAAM;AAAA,EACN,aAAa;AAAA,EACb,WAAW;AACb;AAEA,IAAM,cAAc;AAAA,EAClB,OAAO,cAAc;AAAA,IACnB,MAAM,EAAE,MAAM,SAAS,aAAa,mFAA4B;AAAA,IAChE,MAAM,EAAE,QAAQ,UAAU;AAAA,IAC1B,MAAM,IAAI,EAAE,KAAK,GAAG;AAClB,YAAM,SAAS,EAAE,QAAQ,KAAK,OAAO,CAAC;AAAA,IACxC;AAAA,EACF,CAAC;AAAA,EACD,UAAU,cAAc;AAAA,IACtB,MAAM,EAAE,MAAM,YAAY,aAAa,6FAA4B;AAAA,IACnE,MAAM,EAAE,QAAQ,UAAU;AAAA,IAC1B,MAAM,IAAI,EAAE,KAAK,GAAG;AAClB,YAAM,YAAY,EAAE,QAAQ,KAAK,OAAO,CAAC;AAAA,IAC3C;AAAA,EACF,CAAC;AAAA,EACD,MAAM,cAAc;AAAA,IAClB,MAAM,EAAE,MAAM,QAAQ,aAAa,uDAA8B;AAAA,IACjE,MAAM;AAAA,MACJ,OAAO,EAAE,MAAM,WAAoB,aAAa,+DAAa;AAAA,IAC/D;AAAA,IACA,IAAI,EAAE,KAAK,GAAG;AACZ,cAAQ,EAAE,OAAO,KAAK,MAAM,CAAC;AAAA,IAC/B;AAAA,EACF,CAAC;AACH;AAEA,IAAM,OAAO,cAAc;AAAA,EACzB,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,SAAS,YAAY;AAAA,IACrB,aAAa;AAAA,EACf;AAAA,EACA;AAAA,EACA,MAAM,IAAI,KAAK;AAEb,UAAM,QAAQ,IAAI,QAAQ,KAAK,CAAC,QAAQ,CAAC,IAAI,WAAW,GAAG,CAAC;AAC5D,QAAI,SAAS,SAAS,YAAa;AACnC,UAAM,UAAU,IAAI,GAAG;AACvB,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF,CAAC;AAED,QAAQ,IAAI;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,174 @@
+import { z } from 'zod';
+
+/** 默认 mutator：生成的调用统一走项目自己的 axios 封装。 */
+declare const DEFAULT_MUTATOR: {
+    readonly name: "customInstance";
+    readonly path: "./src/api/customInstance.ts";
+};
+/** 未配置 generate 时的默认配方（daily-task 的 orval 约定）。 */
+declare const DEFAULT_GENERATE: {
+    readonly target: "src/api/generated/endpoints.ts";
+    readonly schemas: "src/api/generated/models";
+    readonly client: "vue-query";
+};
+/**
+ * 未配置 source 时的默认值。刻意等价于 daily-task 旧 export-api.mjs 的行为，
+ * 这样「什么都不写」就是历史行为，迁移零成本。
+ */
+declare const DEFAULT_SOURCE: {
+    readonly type: "springdoc";
+    readonly specPath: "/v3/api-docs";
+    readonly envBaseUrl: "API_BASE_URL";
+    readonly output: "specs/openapi.json";
+};
+/** spec 来源配置：从哪拿 OpenAPI 规范。 */
+declare const sourceSchema: z.ZodObject<{
+    type: z.ZodDefault<z.ZodEnum<{
+        springdoc: "springdoc";
+        url: "url";
+        file: "file";
+    }>>;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    specPath: z.ZodDefault<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    envFile: z.ZodOptional<z.ZodString>;
+    envBaseUrl: z.ZodDefault<z.ZodString>;
+    output: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+/** 生成配置：spec → TypeScript 客户端代码的产出约定。 */
+declare const generateSchema: z.ZodObject<{
+    input: z.ZodOptional<z.ZodString>;
+    target: z.ZodDefault<z.ZodString>;
+    schemas: z.ZodDefault<z.ZodString>;
+    client: z.ZodDefault<z.ZodEnum<{
+        fetch: "fetch";
+        "vue-query": "vue-query";
+        "react-query": "react-query";
+        axios: "axios";
+    }>>;
+    mutator: z.ZodOptional<z.ZodObject<{
+        name: z.ZodDefault<z.ZodString>;
+        path: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
+    queryVersion: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<4>, z.ZodLiteral<5>]>>;
+}, z.core.$strip>;
+type SourceConfig = z.infer<typeof sourceSchema>;
+type SourceConfigInput = z.input<typeof sourceSchema>;
+type GenerateConfig = z.infer<typeof generateSchema>;
+type GenerateConfigInput = z.input<typeof generateSchema>;
+declare const configSchema: z.ZodObject<{
+    source: z.ZodDefault<z.ZodObject<{
+        type: z.ZodDefault<z.ZodEnum<{
+            springdoc: "springdoc";
+            url: "url";
+            file: "file";
+        }>>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        specPath: z.ZodDefault<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        envFile: z.ZodOptional<z.ZodString>;
+        envBaseUrl: z.ZodDefault<z.ZodString>;
+        output: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
+    generate: z.ZodDefault<z.ZodObject<{
+        input: z.ZodOptional<z.ZodString>;
+        target: z.ZodDefault<z.ZodString>;
+        schemas: z.ZodDefault<z.ZodString>;
+        client: z.ZodDefault<z.ZodEnum<{
+            fetch: "fetch";
+            "vue-query": "vue-query";
+            "react-query": "react-query";
+            axios: "axios";
+        }>>;
+        mutator: z.ZodOptional<z.ZodObject<{
+            name: z.ZodDefault<z.ZodString>;
+            path: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>>;
+        queryVersion: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<4>, z.ZodLiteral<5>]>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type OasConfig = z.infer<typeof configSchema>;
+
+/**
+ * 类型安全的配置助手，与 orval 的 defineConfig 用法一致。
+ * 支持直接传对象，或传一个返回配置的函数（便于按环境派生）。
+ */
+declare function defineConfig(config: OasConfig | (() => OasConfig)): OasConfig | (() => OasConfig);
+
+declare const DEFAULT_CONFIG_FILE = "oas-codegen.config.ts";
+/**
+ * 加载 oas-codegen 配置文件，返回「生效配置」（默认值已填充）。
+ * 未找到配置文件时返回全默认配置，即兼容旧 export-api.mjs + orval.config.ts 的行为。
+ * 支持 .ts / .mts / .cts / .js / .mjs / .cjs / .json。
+ */
+declare function loadConfig(cwd: string, configFile?: string): Promise<OasConfig>;
+
+/** 从指定 URL 拉取 OpenAPI 规范并解析为 JSON。 */
+declare function fetchSpec(url: string): Promise<unknown>;
+/** 将规范以 2 空格缩进的 JSON 写入磁盘（自动创建目录）。 */
+declare function writeSpec(spec: unknown, output: string): void;
+/** 读取本地 OpenAPI 规范文件并解析为 JSON（file 类型使用，不重写文件）。 */
+declare function readLocalSpec(file: string): unknown;
+
+interface ResolvedSource {
+    /** 最终请求的 spec 地址；file 类型为 undefined */
+    url: string | undefined;
+    /** 保存 spec 的绝对路径 */
+    output: string;
+}
+/** 加载 envFile（如 .env.local）中的变量到 process.env，缺省静默跳过。 */
+declare function loadEnvFile(envFile: string | undefined, cwd: string): void;
+/** 将配置的 source 解析成具体的请求地址与输出路径（处理环境变量优先级与默认值）。 */
+declare function resolveSource(source: SourceConfig, cwd: string): ResolvedSource;
+
+/** orval 配置里的统一项目名。 */
+declare const ORVAL_PROJECT = "generated";
+/**
+ * 解析生效的 mutator：显式配置优先；缺省时仅默认配方（vue-query）注入 customInstance。
+ * react-query / axios / fetch 不自动绑 mutator，避免凭空要求 customInstance 文件存在。
+ */
+declare function resolveMutator(g: GenerateConfig): {
+    name: string;
+    path: string;
+} | undefined;
+/** 将 oas-codegen 配置渲染成 orval 可执行的配置对象。 */
+declare function renderOrvalConfig(config: OasConfig): Record<string, unknown>;
+/**
+ * 解析包内置 orval 的可执行入口（读取依赖包 package.json 的 bin 字段）。
+ * 不依赖 exports map，向上遍历目录定位 orval 包根。
+ */
+declare function resolveOrvalBin(): string;
+/** 以指定 cwd 运行 orval，stdio 直接透传，失败时 reject。 */
+declare function runOrval(args: string[], cwd: string): Promise<void>;
+
+interface FetchOptions {
+    config?: string;
+    cwd?: string;
+    /** 静默模式（供编程调用时使用），默认打印过程日志 */
+    silent?: boolean;
+}
+interface FetchResult {
+    url: string | undefined;
+    output: string;
+    spec: unknown;
+}
+/** 获取 OpenAPI 规范：springdoc/url 从网络拉取并落盘，file 类型读取本地文件校验。 */
+declare function runFetch(opts?: FetchOptions): Promise<FetchResult>;
+
+interface GenerateOptions {
+    config?: string;
+    cwd?: string;
+}
+/** 根据本地 spec 生成 TypeScript 客户端代码。 */
+declare function runGenerate(opts?: GenerateOptions): Promise<void>;
+
+interface InitOptions {
+    cwd?: string;
+    force?: boolean;
+}
+/** 默认的 oas-codegen.config.ts 模板（与 daily-task 现行约定一致）。 */
+declare const CONFIG_TEMPLATE = "import { defineConfig } from 'oas-codegen'\n\nexport default defineConfig({\n  source: {\n    type: 'springdoc',\n    // \u540E\u7AEF\u5730\u5740\uFF1A\u4F18\u5148\u8BFB\u73AF\u5883\u53D8\u91CF API_BASE_URL\uFF0C\u672A\u8BBE\u7F6E\u65F6\u7528 baseUrl\n    baseUrl: 'http://localhost:8082',\n    specPath: '/v3/api-docs',\n    envFile: '.env.local',\n    output: 'specs/openapi.json',\n  },\n  generate: {\n    target: 'src/api/generated/endpoints.ts',\n    schemas: 'src/api/generated/models',\n    client: 'vue-query',\n    // \u663E\u5F0F\u9501\u5B9A TanStack Query \u5927\u7248\u672C\uFF084 \u6216 5\uFF09\uFF1B\u4E0D\u5199\u5219\u6309\u9879\u76EE\u4F9D\u8D56\u81EA\u52A8\u63A2\u6D4B\n    // queryVersion: 5,\n    // mutator \u9700\u4E3A (url, config) \u53CC\u53C2\u7EA6\u5B9A\uFF08orval 8 \u6807\u51C6\uFF09\uFF0C\u5B57\u6BB5\u89C1 README\n    mutator: {\n      name: 'customInstance',\n      path: './src/api/customInstance.ts',\n    },\n  },\n})\n";
+/** 在目标项目根目录生成配置文件。 */
+declare function runInit(opts?: InitOptions): void;
+
+export { CONFIG_TEMPLATE, DEFAULT_CONFIG_FILE, DEFAULT_GENERATE, DEFAULT_MUTATOR, DEFAULT_SOURCE, type GenerateConfig, type GenerateConfigInput, ORVAL_PROJECT, type OasConfig, type SourceConfig, type SourceConfigInput, configSchema, defineConfig, fetchSpec, generateSchema, loadConfig, loadEnvFile, readLocalSpec, renderOrvalConfig, resolveMutator, resolveOrvalBin, resolveSource, runFetch, runGenerate, runInit, runOrval, sourceSchema, writeSpec };

package/dist/index.js

@@ -0,0 +1,55 @@
+import {
+  CONFIG_TEMPLATE,
+  DEFAULT_CONFIG_FILE,
+  DEFAULT_GENERATE,
+  DEFAULT_MUTATOR,
+  DEFAULT_SOURCE,
+  ORVAL_PROJECT,
+  configSchema,
+  fetchSpec,
+  generateSchema,
+  loadConfig,
+  loadEnvFile,
+  readLocalSpec,
+  renderOrvalConfig,
+  resolveMutator,
+  resolveOrvalBin,
+  resolveSource,
+  runFetch,
+  runGenerate,
+  runInit,
+  runOrval,
+  sourceSchema,
+  writeSpec
+} from "./chunk-AWDG5OSK.js";
+
+// src/config/define.ts
+function defineConfig(config) {
+  return config;
+}
+export {
+  CONFIG_TEMPLATE,
+  DEFAULT_CONFIG_FILE,
+  DEFAULT_GENERATE,
+  DEFAULT_MUTATOR,
+  DEFAULT_SOURCE,
+  ORVAL_PROJECT,
+  configSchema,
+  defineConfig,
+  fetchSpec,
+  generateSchema,
+  loadConfig,
+  loadEnvFile,
+  readLocalSpec,
+  renderOrvalConfig,
+  resolveMutator,
+  resolveOrvalBin,
+  resolveSource,
+  runFetch,
+  runGenerate,
+  runInit,
+  runOrval,
+  sourceSchema,
+  writeSpec
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/define.ts"],"sourcesContent":["import type { OasConfig } from './schema.js'\n\n/**\n * 类型安全的配置助手，与 orval 的 defineConfig 用法一致。\n * 支持直接传对象，或传一个返回配置的函数（便于按环境派生）。\n */\nexport function defineConfig(config: OasConfig | (() => OasConfig)): OasConfig | (() => OasConfig) {\n  return config\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAMO,SAAS,aAAa,QAAsE;AACjG,SAAO;AACT;","names":[]}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "oas-codegen",
+  "version": "0.1.0",
+  "description": "Opinionated OpenAPI → TypeScript + TanStack Query codegen, built on top of orval. Spec fetching + recipe-based generate pipeline.",
+  "type": "module",
+  "license": "MIT",
+  "author": "wuchao",
+  "repository": {
+    "type": "git",
+    "url": "https://gitee.com/big-bear-frontend/oas-codegen.git"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "bin": {
+    "oas-codegen": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm typecheck && pnpm test && pnpm build"
+  },
+  "dependencies": {
+    "citty": "^0.2.2",
+    "dotenv": "^17.4.2",
+    "jiti": "^2.7.0",
+    "orval": "^8.33.0",
+    "zod": "^4.6.5"
+  },
+  "devDependencies": {
+    "@types/node": "^26.5.1",
+    "tsup": "^8.5.1",
+    "tsx": "^4.23.13",
+    "typescript": "^5.9.3",
+    "vitest": "^5.0.0"
+  }
+}