@karry.sun/yapi-gen 0.1.0

package/README.md

@@ -0,0 +1,73 @@
+# yapi-gen
+
+基于 [yapi-to-typescript](https://github.com/fjc0k/yapi-to-typescript) 的 YApi 前端代码生成 CLI，支持可配置的请求适配器与多项目复用。适用于 Vite、Nuxt、Vue 等不同请求封装（axios、defHttp、Nuxt request 等）。
+
+## 安装
+
+```bash
+pnpm add -D yapi-gen yapi-to-typescript
+```
+
+## 快速开始
+
+### 1. 初始化配置
+
+在项目根目录执行：
+
+```bash
+pnpm yapi-gen init
+```
+
+会生成 `yapi-gen.config.ts`，按需修改 `serverUrl`、`token`、`requestAdapter`、`outputFilePath` 等。
+
+### 2. 选择请求适配方式
+
+- **内置预设（推荐）**：在配置中设置 `requestAdapter: 'axios'` 或 `requestAdapter: 'nuxt-bbm'`，无需在各仓库维护 `request.ts`，运行 `yapi-gen` 时会自动生成并写入 `src/yapi/request.ts`（路径可配）。
+  - **axios**：适用于封装了 axios 的项目（如 defHttp）。可选 `requestAdapter: { type: 'axios', axiosInstancePath: '/@/utils/http/axios' }` 指定实例路径，默认 `'/@/utils/http/axios'`（defHttp 常见路径）。
+  - **nuxt-bbm**：适用于 Nuxt 项目，使用 Layer 的 `#imports` 或 `@bitunix/bbm` 的 request。可选 `requestAdapter: { type: 'nuxt-bbm', requestImportPath: '#imports' }`，默认 `'#imports'`。
+- **自定义**：设置 `requestAdapter: 'custom'` 并配置 `requestFunctionFilePath`，在对应文件中自行实现适配逻辑；或参考包内 `templates/request-*.ts` 复制后修改。
+
+### 3. 生成接口代码
+
+```bash
+pnpm yapi-gen
+```
+
+会在当前目录查找 `yapi-gen.config.ts`（或 `.yapi-genrc.ts` 等），生成临时 ytt 配置并执行 `ytt`，输出到你在 `outputFilePath` 中配置的目录。
+
+## 配置说明
+
+`yapi-gen.config.ts` 使用 `defineYapiGenConfig` 导出单条配置（或数组，多条会合并为 `defineConfig([...])`）。主要字段与 [yapi-to-typescript 配置](https://fjc0k.github.io/yapi-to-typescript/handbook/config.html) 对齐：
+
+| 字段 | 说明 | 必填 |
+|------|------|------|
+| `serverUrl` | YApi 服务器地址 | 是 |
+| `serverType` | `'yapi'` \| `'swagger'` | 否，默认 `'yapi'` |
+| `requestAdapter` | 请求适配方式：`'axios'` / `'nuxt-bbm'` / `'custom'`，或对象形式带可选参数 | 否，与 `requestFunctionFilePath` 二选一 |
+| `requestFunctionFilePath` | 请求适配器文件路径；使用预设时可选（默认 `src/yapi/request.ts`），custom 时必填 | custom 时必填 |
+| `outputFilePath` | 生成文件路径或函数 `(interfaceInfo, changeCase) => string` | 是 |
+| `projects` | 项目列表，每项含 `token`、`categories` | 是 |
+| `dataKey` | 业务数据字段，如 `'result'`，适配器需据此解包 | 否 |
+| `prodEnvName` / `devEnvName` | 生产/测试环境名称（用于域名） | 否 |
+| `typesOnly` | 是否只生成类型 | 否，默认 `false` |
+| `target` | `'typescript'` \| `'javascript'` | 否，默认 `'typescript'` |
+| `reactHooks` | React Hooks 生成配置 | 否 |
+| `preproccessInterface` | 预处理/过滤接口 | 否 |
+| `getRequestFunctionName` | 请求函数命名 | 否 |
+
+YApi 的 **token** 建议通过环境变量注入，例如在 `projects[].token` 中写 `process.env.YAPI_TOKEN || 'fallback'`。
+
+## 在现有项目中使用
+
+- **web-finance-admin（defHttp）**：在 `yapi-gen.config.ts` 中设置 `requestAdapter: 'axios'`（或 `{ type: 'axios', axiosInstancePath: '/@/utils/http/axios' }`），无需再维护 `request.ts`；或继续使用 `requestAdapter: 'custom'` 并保留现有 `requestFunctionFilePath`。
+- **pc（Nuxt / @bitunix/bbm）**：设置 `requestAdapter: 'nuxt-bbm'`（或 `{ type: 'nuxt-bbm', requestImportPath: '#imports' }`），无需再维护 `request.ts`；或使用 `custom` 并指向现有文件。
+
+## 配置文件查找顺序
+
+CLI 会按以下顺序查找配置（找到即用）：
+
+`yapi-gen.config.ts`、`yapi-gen.config.mts`、`yapi-gen.config.cts`、`yapi-gen.config.js`、`yapi-gen.config.mjs`、`yapi-gen.config.cjs`、`.yapi-genrc.ts`、`.yapi-genrc.mts`、`.yapi-genrc.js`、`.yapi-genrc.mjs`。
+
+## License
+
+MIT

package/bin/yapi-gen.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { pathToFileURL } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const runPath = join(__dirname, '..', 'dist', 'run.js');
+const runUrl = pathToFileURL(runPath).href;
+
+const { run } = await import(runUrl);
+const init = process.argv.includes('init');
+const code = run({ cwd: process.cwd(), init });
+process.exit(code);

package/dist/adapters/axios.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 内置适配器：封装 axios / defHttp 的工厂
+ * 生成的 request 文件会 import 项目的 axios 实例并传入此工厂
+ */
+import type { RequestFunctionParams } from 'yapi-to-typescript';
+export type AxiosLikeInstance = {
+    get: (config: any) => Promise<any>;
+    post: (config: any) => Promise<any>;
+    put: (config: any) => Promise<any>;
+    delete: (config: any) => Promise<any>;
+    request?: (config: any) => Promise<any>;
+};
+export declare function createAxiosAdapter(instance: AxiosLikeInstance): <TResponseData>(payload: RequestFunctionParams) => Promise<TResponseData>;
+//# sourceMappingURL=axios.d.ts.map

package/dist/adapters/axios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axios.d.ts","sourceRoot":"","sources":["../../src/adapters/axios.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,GAAG,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CACzC,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,IAC9B,aAAa,EACzC,SAAS,qBAAqB,KAC7B,OAAO,CAAC,aAAa,CAAC,CA+C1B"}

package/dist/adapters/axios.js

@@ -0,0 +1,48 @@
+export function createAxiosAdapter(instance) {
+    return async function request(payload) {
+        const { method, path, data, hasFileData, getFormData } = payload;
+        const url = path;
+        const isGet = method === 'GET' || method === 'HEAD' || method === 'OPTIONS';
+        let config;
+        if (isGet) {
+            config = { url, params: {} };
+        }
+        else if (hasFileData && getFormData) {
+            config = { url, params: getFormData() };
+        }
+        else {
+            config = { url, params: data || {} };
+        }
+        let res;
+        switch (method) {
+            case 'GET':
+            case 'HEAD':
+            case 'OPTIONS':
+                res = await instance.get(config);
+                break;
+            case 'POST':
+                res = await instance.post(config);
+                break;
+            case 'PUT':
+                res = await instance.put(config);
+                break;
+            case 'DELETE':
+                res = await instance.delete(config);
+                break;
+            case 'PATCH':
+                res = await (instance.request ?? instance.post)({ ...config, method: 'PATCH' });
+                break;
+            default:
+                res = await instance.post(config);
+        }
+        const key = payload.dataKey;
+        if (res != null && typeof res === 'object' && key != null) {
+            const val = Array.isArray(key)
+                ? key.reduce((o, k) => o?.[k], res)
+                : res[key];
+            if (val !== undefined && val !== null)
+                return val;
+        }
+        return res;
+    };
+}

package/dist/adapters/nuxt-bbm.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 内置适配器：Nuxt Layer @bitunix/bbm 或 #imports 的 request 工厂
+ * 生成的 request 文件会 import 项目的 request 并传入此工厂
+ */
+import type { RequestFunctionParams } from 'yapi-to-typescript';
+export type NuxtRequestLike = <T = any>(path: string, options?: {
+    baseURL?: string;
+    method?: string;
+    body?: any;
+    query?: any;
+    tips?: boolean;
+}) => Promise<T>;
+export declare function createNuxtAdapter(requestFn: NuxtRequestLike): <TResponseData>(payload: RequestFunctionParams) => Promise<TResponseData>;
+//# sourceMappingURL=nuxt-bbm.d.ts.map

package/dist/adapters/nuxt-bbm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nuxt-bbm.d.ts","sourceRoot":"","sources":["../../src/adapters/nuxt-bbm.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,GAAG,GAAG,EACpC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,GAAG,CAAC;IAAC,KAAK,CAAC,EAAE,GAAG,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,KACrF,OAAO,CAAC,CAAC,CAAC,CAAC;AAEhB,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,eAAe,IACrB,aAAa,EAChD,SAAS,qBAAqB,KAC7B,OAAO,CAAC,aAAa,CAAC,CAsB1B"}

package/dist/adapters/nuxt-bbm.js

@@ -0,0 +1,23 @@
+export function createNuxtAdapter(requestFn) {
+    return async function requestAdapter(payload) {
+        const baseUrl = typeof import.meta !== 'undefined' && import.meta.dev
+            ? payload.devUrl
+            : payload.prodUrl;
+        const res = await requestFn(payload.path, {
+            baseURL: baseUrl || '',
+            method: payload.method.toLowerCase(),
+            ...(payload.requestBodyType === 'json' && payload.data ? { body: payload.data } : {}),
+            ...(payload.requestBodyType === 'query' && payload.data ? { query: payload.data } : {}),
+            tips: false,
+        });
+        const key = payload.dataKey;
+        if (res != null && typeof res === 'object' && key != null) {
+            const val = Array.isArray(key)
+                ? key.reduce((o, k) => o?.[k], res)
+                : res[key];
+            if (val !== undefined && val !== null)
+                return val;
+        }
+        return res;
+    };
+}

package/dist/config/index.d.ts

@@ -0,0 +1,14 @@
+import type { YapiGenUserConfig } from './schema';
+/**
+ * 合并用户配置与默认配置，返回可直接用于 defineConfig([...]) 的配置对象
+ */
+export declare function mergeConfig(user: YapiGenUserConfig): YapiGenUserConfig;
+/**
+ * 定义 yapi-gen 配置的辅助函数，带类型提示与默认值
+ * 在项目根目录的 yapi-gen.config.ts 中使用：
+ *   import { defineYapiGenConfig } from 'yapi-gen';
+ *   export default defineYapiGenConfig({ serverUrl: '...', ... });
+ */
+export declare function defineYapiGenConfig(config: YapiGenUserConfig): YapiGenUserConfig;
+export type { YapiGenUserConfig, YapiGenProjectConfig, YapiGenCategoryConfig, YapiGenReactHooksConfig, YapiGenRequestAdapter, } from './schema';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAGlD;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,iBAAiB,GAAG,iBAAiB,CAOtE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,CAEhF;AAED,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,UAAU,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,21 @@
+import { getDefaultConfig } from './schema';
+/**
+ * 合并用户配置与默认配置，返回可直接用于 defineConfig([...]) 的配置对象
+ */
+export function mergeConfig(user) {
+    const defaults = getDefaultConfig();
+    return {
+        ...defaults,
+        ...user,
+        reactHooks: user.reactHooks ?? defaults.reactHooks,
+    };
+}
+/**
+ * 定义 yapi-gen 配置的辅助函数，带类型提示与默认值
+ * 在项目根目录的 yapi-gen.config.ts 中使用：
+ *   import { defineYapiGenConfig } from 'yapi-gen';
+ *   export default defineYapiGenConfig({ serverUrl: '...', ... });
+ */
+export function defineYapiGenConfig(config) {
+    return mergeConfig(config);
+}

package/dist/config/schema.d.ts

@@ -0,0 +1,98 @@
+/**
+ * 用户配置类型定义
+ * 与 yapi-to-typescript 的 ServerConfig 对齐，便于透传
+ */
+export interface YapiGenCategoryConfig {
+    id: number | number[];
+    getRequestFunctionName?: (interfaceInfo: any, changeCase: {
+        camelCase: (s: string) => string;
+        paramCase: (s: string) => string;
+        pascalCase: (s: string) => string;
+    }) => string;
+}
+export interface YapiGenProjectConfig {
+    token: string | string[];
+    categories: YapiGenCategoryConfig[];
+}
+export interface YapiGenReactHooksConfig {
+    enabled: boolean;
+    requestHookMakerFilePath?: string;
+    getRequestHookName?: (interfaceInfo: any, changeCase: any) => string;
+}
+/** 请求适配方式：内置预设（关键字）或自定义 */
+export type YapiGenRequestAdapter = 'axios' | 'nuxt-bbm' | 'custom' | {
+    type: 'axios';
+    axiosInstancePath?: string;
+    axiosExportName?: 'defHttp' | 'default';
+} | {
+    type: 'nuxt-bbm';
+    requestImportPath?: string;
+} | {
+    type: 'custom';
+    requestFunctionFilePath: string;
+};
+/**
+ * 用户可在 yapi-gen.config.ts 中使用的配置项
+ * 未填的项将使用下方默认值
+ */
+export interface YapiGenUserConfig {
+    /** YApi 服务器地址（必填） */
+    serverUrl: string;
+    /** 服务器类型 */
+    serverType?: 'yapi' | 'swagger';
+    /** 是否只生成类型 */
+    typesOnly?: boolean;
+    /** 生成目标语言 */
+    target?: 'typescript' | 'javascript';
+    /** 生产环境名称（用于获取生产环境域名） */
+    prodEnvName?: string;
+    /** 测试环境名称 */
+    devEnvName?: string;
+    /** 业务数据字段，如 'result' / 'data'，请求函数需据此解包 */
+    dataKey?: string | string[];
+    /**
+     * 请求适配方式（与 requestFunctionFilePath 二选一）：
+     * - 'axios'：封装 axios/defHttp，可选 axiosInstancePath
+     * - 'nuxt-bbm'：Nuxt Layer @bitunix/bbm 或 #imports，可选 requestImportPath
+     * - 'custom'：使用 requestFunctionFilePath 指向的自定义 request.ts
+     * 使用预设时可不填 requestFunctionFilePath，默认生成到 src/yapi/request.ts
+     */
+    requestAdapter?: YapiGenRequestAdapter;
+    /** 项目内请求适配器文件路径（custom 时必填；使用预设时可选，默认 src/yapi/request.ts） */
+    requestFunctionFilePath?: string;
+    /** 输出文件路径或函数（必填） */
+    outputFilePath: string | ((interfaceInfo: any, changeCase: {
+        paramCase: (s: string) => string;
+        camelCase: (s: string) => string;
+        pascalCase: (s: string) => string;
+    }) => string);
+    /** 预处理接口，可过滤或改写 */
+    preproccessInterface?: (interfaceInfo: any, changeCase?: any, syntheticalConfig?: any) => any | false;
+    /** 请求函数命名 */
+    getRequestFunctionName?: (interfaceInfo: any, changeCase: any) => string;
+    /** 请求数据类型命名 */
+    getRequestDataTypeName?: (interfaceInfo: any, changeCase: any) => string;
+    /** 响应数据类型命名 */
+    getResponseDataTypeName?: (interfaceInfo: any, changeCase: any) => string;
+    /** React Hooks 相关 */
+    reactHooks?: YapiGenReactHooksConfig;
+    /** 项目列表（必填） */
+    projects: YapiGenProjectConfig[];
+    /** 不生成更新时间注释 */
+    noUpdateTimeComment?: boolean;
+    /** 注释配置 */
+    comment?: Record<string, boolean | unknown>;
+    /** JSON Schema 配置 */
+    jsonSchema?: Record<string, boolean | unknown>;
+    /** 查询字符串数组格式 */
+    queryStringArrayFormat?: 'brackets' | 'indices' | 'repeat' | 'comma' | 'json';
+    /** 自定义类型映射 */
+    customTypeMapping?: Record<string, string>;
+    /** 请求函数 extraInfo */
+    setRequestFunctionExtraInfo?: (interfaceInfo: any, changeCase: any) => Record<string, unknown>;
+}
+/**
+ * 默认配置（与 ytt 常用默认一致）
+ */
+export declare function getDefaultConfig(): Partial<YapiGenUserConfig>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"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"}

package/dist/config/schema.js

@@ -0,0 +1,15 @@
+const DEFAULT_REACT_HOOKS = {
+    enabled: false,
+};
+/**
+ * 默认配置（与 ytt 常用默认一致）
+ */
+export function getDefaultConfig() {
+    return {
+        serverType: 'yapi',
+        typesOnly: false,
+        target: 'typescript',
+        reactHooks: DEFAULT_REACT_HOOKS,
+        prodEnvName: 'production',
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * yapi-gen
+ * 基于 yapi-to-typescript 的 YApi 前端代码生成 CLI，支持可配置的请求适配器与多项目复用
+ */
+export { defineYapiGenConfig, mergeConfig } from './config';
+export { resolveConfig } from './resolve-config';
+export type { YapiGenUserConfig, YapiGenProjectConfig, YapiGenCategoryConfig, YapiGenReactHooksConfig, YapiGenRequestAdapter, } from './config/schema';
+export type { RequestFunctionParams } from 'yapi-to-typescript';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+/**
+ * yapi-gen
+ * 基于 yapi-to-typescript 的 YApi 前端代码生成 CLI，支持可配置的请求适配器与多项目复用
+ */
+export { defineYapiGenConfig, mergeConfig } from './config';
+export { resolveConfig } from './resolve-config';

package/dist/resolve-config.d.ts

@@ -0,0 +1,7 @@
+import type { YapiGenUserConfig } from './config/schema';
+/**
+ * 解析配置：若为预设（axios / nuxt-bbm），则生成并写入 request 文件，并补全 requestFunctionFilePath；
+ * 返回去掉 requestAdapter 等字段、可供 ytt defineConfig 使用的配置。
+ */
+export declare function resolveConfig(config: YapiGenUserConfig, cwd: string): YapiGenUserConfig;
+//# sourceMappingURL=resolve-config.d.ts.map

package/dist/resolve-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-config.d.ts","sourceRoot":"","sources":["../src/resolve-config.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAyB,MAAM,iBAAiB,CAAC;AAiFhF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,CA0CvF"}

package/dist/resolve-config.js

@@ -0,0 +1,115 @@
+/**
+ * 在运行 ytt 前解析配置：处理 requestAdapter 预设，生成并写入 request 文件，得到 ytt 可用的配置
+ */
+import { existsSync, mkdirSync, writeFileSync } from 'fs';
+import { resolve, dirname } from 'path';
+const DEFAULT_REQUEST_FILE_PATH = 'src/yapi/request.ts';
+const DEFAULT_AXIOS_INSTANCE_PATH = "/@/utils/http/axios";
+const DEFAULT_NUXT_REQUEST_IMPORT_PATH = '#imports';
+function normalizeRequestAdapter(adapter) {
+    if (adapter == null) {
+        return { type: 'custom' };
+    }
+    if (adapter === 'axios') {
+        return {
+            type: 'axios',
+            axiosInstancePath: DEFAULT_AXIOS_INSTANCE_PATH,
+            axiosExportName: 'defHttp',
+        };
+    }
+    if (adapter === 'nuxt-bbm') {
+        return { type: 'nuxt-bbm', requestImportPath: DEFAULT_NUXT_REQUEST_IMPORT_PATH };
+    }
+    if (adapter === 'custom') {
+        return { type: 'custom' };
+    }
+    if (typeof adapter === 'object') {
+        if (adapter.type === 'axios') {
+            return {
+                type: 'axios',
+                axiosInstancePath: adapter.axiosInstancePath ?? DEFAULT_AXIOS_INSTANCE_PATH,
+                axiosExportName: adapter.axiosExportName ?? 'defHttp',
+            };
+        }
+        if (adapter.type === 'nuxt-bbm') {
+            return {
+                type: 'nuxt-bbm',
+                requestImportPath: adapter.requestImportPath ?? DEFAULT_NUXT_REQUEST_IMPORT_PATH,
+            };
+        }
+        if (adapter.type === 'custom') {
+            return {
+                type: 'custom',
+                requestFunctionFilePath: adapter.requestFunctionFilePath,
+            };
+        }
+    }
+    return { type: 'custom' };
+}
+function getAxiosAdapterFileContent(axiosInstancePath, exportName) {
+    const importLine = exportName === 'default'
+        ? `import defHttp from '${axiosInstancePath}';`
+        : `import { defHttp } from '${axiosInstancePath}';`;
+    return `/**
+ * 由 yapi-gen 预设 "axios" 自动生成，请勿直接修改。
+ * 如需自定义请求逻辑，请将配置改为 requestAdapter: 'custom' 并维护 requestFunctionFilePath 指向的文件。
+ */
+import { createAxiosAdapter } from 'yapi-gen/adapters/axios';
+${importLine}
+
+export default createAxiosAdapter(defHttp);
+`;
+}
+function getNuxtBbmAdapterFileContent(requestImportPath) {
+    return `/**
+ * 由 yapi-gen 预设 "nuxt-bbm" 自动生成，请勿直接修改。
+ * 如需自定义请求逻辑，请将配置改为 requestAdapter: 'custom' 并维护 requestFunctionFilePath 指向的文件。
+ */
+import { createNuxtAdapter } from 'yapi-gen/adapters/nuxt-bbm';
+import { request } from '${requestImportPath}';
+
+export default createNuxtAdapter(request);
+`;
+}
+/**
+ * 解析配置：若为预设（axios / nuxt-bbm），则生成并写入 request 文件，并补全 requestFunctionFilePath；
+ * 返回去掉 requestAdapter 等字段、可供 ytt defineConfig 使用的配置。
+ */
+export function resolveConfig(config, cwd) {
+    const resolved = { ...config };
+    const adapter = normalizeRequestAdapter(resolved.requestAdapter);
+    const requestFilePath = resolved.requestFunctionFilePath ?? adapter.requestFunctionFilePath ?? DEFAULT_REQUEST_FILE_PATH;
+    if (adapter.type === 'axios') {
+        const content = getAxiosAdapterFileContent(adapter.axiosInstancePath, adapter.axiosExportName ?? 'defHttp');
+        const absolutePath = resolve(cwd, requestFilePath);
+        const dir = dirname(absolutePath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(absolutePath, content, 'utf-8');
+        resolved.requestFunctionFilePath = requestFilePath;
+        delete resolved.requestAdapter;
+        return resolved;
+    }
+    if (adapter.type === 'nuxt-bbm') {
+        const content = getNuxtBbmAdapterFileContent(adapter.requestImportPath);
+        const absolutePath = resolve(cwd, requestFilePath);
+        const dir = dirname(absolutePath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(absolutePath, content, 'utf-8');
+        resolved.requestFunctionFilePath = requestFilePath;
+        delete resolved.requestAdapter;
+        return resolved;
+    }
+    // custom 或未指定：必须已有 requestFunctionFilePath
+    if (!resolved.requestFunctionFilePath && !adapter.requestFunctionFilePath) {
+        throw new Error('[yapi-gen] requestAdapter 为 custom 或未指定时，必须配置 requestFunctionFilePath');
+    }
+    if (adapter.requestFunctionFilePath) {
+        resolved.requestFunctionFilePath = adapter.requestFunctionFilePath;
+    }
+    delete resolved.requestAdapter;
+    return resolved;
+}

package/dist/run.d.ts

@@ -0,0 +1,6 @@
+export declare function run(options?: {
+    cwd?: string;
+    configPath?: string;
+    init?: boolean;
+}): number;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAiGA,wBAAgB,GAAG,CAAC,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,CAkC/F"}

package/dist/run.js

@@ -0,0 +1,117 @@
+/**
+ * CLI 执行逻辑：解析用户配置、生成 ytt 包装配置并执行 ytt
+ */
+import { spawnSync } from 'child_process';
+import { existsSync, mkdirSync, writeFileSync } from 'fs';
+import { resolve, dirname, basename, relative } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const CONFIG_NAMES = [
+    'yapi-gen.config.ts',
+    'yapi-gen.config.mts',
+    'yapi-gen.config.cts',
+    'yapi-gen.config.js',
+    'yapi-gen.config.mjs',
+    'yapi-gen.config.cjs',
+    '.yapi-genrc.ts',
+    '.yapi-genrc.mts',
+    '.yapi-genrc.js',
+    '.yapi-genrc.mjs',
+];
+const WRAPPER_DIR = '.yapi-gen';
+const WRAPPER_FILENAME = 'ytt.config.ts';
+function findConfig(cwd) {
+    for (const name of CONFIG_NAMES) {
+        const p = resolve(cwd, name);
+        if (existsSync(p))
+            return p;
+    }
+    return null;
+}
+/**
+ * 生成包装用的 ytt.config.ts 内容
+ * 该文件会 import 用户配置并传入 defineConfig
+ */
+function getWrapperContent(cwd, configPath) {
+    const absoluteConfig = resolve(cwd, configPath);
+    const configDir = dirname(absoluteConfig);
+    const configBase = basename(absoluteConfig).replace(/\.[^.]+$/, '') || 'yapi-gen.config';
+    const wrapperDir = resolve(cwd, WRAPPER_DIR);
+    const rel = relative(wrapperDir, configDir).replace(/\\/g, '/');
+    const relativeImport = (rel ? rel + '/' : '') + configBase;
+    return `/* 由 yapi-gen 自动生成，请勿修改 */
+import { defineConfig } from 'yapi-to-typescript';
+import { resolveConfig } from 'yapi-gen';
+
+const userConfig = await import('${relativeImport}');
+const raw = userConfig.default ?? userConfig;
+const configList = Array.isArray(raw) ? raw : [raw];
+const resolvedList = configList.map((c) => resolveConfig(c, process.cwd()));
+
+export default defineConfig(resolvedList);
+`;
+}
+function runInit(cwd) {
+    const configPath = resolve(cwd, 'yapi-gen.config.ts');
+    if (existsSync(configPath)) {
+        console.log('[yapi-gen] 已存在 yapi-gen.config.ts，跳过创建');
+    }
+    else {
+        const tpl = `import { defineYapiGenConfig } from 'yapi-gen';
+
+export default defineYapiGenConfig({
+  serverUrl: 'https://yapi.example.com',
+  serverType: 'yapi',
+  // 请求适配：'axios' | 'nuxt-bbm' | 'custom'，使用预设时可不填 requestFunctionFilePath
+  requestAdapter: 'axios',
+  // requestFunctionFilePath: 'src/yapi/request.ts',  // custom 时必填；预设时可选，默认 src/yapi/request.ts
+  outputFilePath: (interfaceInfo, changeCase) => {
+    const catId = interfaceInfo.catid ?? 0;
+    return \`src/yapi/cat_\${catId}/index.ts\`;
+  },
+  dataKey: 'result',
+  projects: [
+    {
+      token: process.env.YAPI_TOKEN || 'your-project-token',
+      categories: [
+        {
+          id: 0,
+          getRequestFunctionName(interfaceInfo, changeCase) {
+            return changeCase.camelCase(interfaceInfo.path);
+          },
+        },
+      ],
+    },
+  ],
+});
+`;
+        writeFileSync(configPath, tpl, 'utf-8');
+        console.log('[yapi-gen] 已创建 yapi-gen.config.ts，请按需修改 serverUrl、token 等');
+    }
+    return 0;
+}
+export function run(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    if (options.init) {
+        return runInit(cwd);
+    }
+    const configPath = options.configPath ?? findConfig(cwd);
+    if (!configPath) {
+        console.error('[yapi-gen] 未找到配置文件。请在项目根目录创建以下之一：', CONFIG_NAMES.join(', '));
+        console.error('[yapi-gen] 或使用 init 子命令：pnpm yapi-gen init');
+        return 1;
+    }
+    const wrapperDir = resolve(cwd, WRAPPER_DIR);
+    if (!existsSync(wrapperDir)) {
+        mkdirSync(wrapperDir, { recursive: true });
+    }
+    const wrapperPath = resolve(wrapperDir, WRAPPER_FILENAME);
+    const content = getWrapperContent(cwd, configPath);
+    writeFileSync(wrapperPath, content, 'utf-8');
+    const result = spawnSync('npx', ['ytt', '-c', wrapperPath], {
+        cwd,
+        stdio: 'inherit',
+        shell: true,
+    });
+    return result.status ?? 1;
+}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@karry.sun/yapi-gen",
+  "version": "0.1.0",
+  "description": "基于 yapi-to-typescript 的 YApi 前端代码生成 CLI，支持可配置的请求适配器与多项目复用",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./adapters/axios": {
+      "types": "./dist/adapters/axios.d.ts",
+      "import": "./dist/adapters/axios.js",
+      "default": "./dist/adapters/axios.js"
+    },
+    "./adapters/nuxt-bbm": {
+      "types": "./dist/adapters/nuxt-bbm.d.ts",
+      "import": "./dist/adapters/nuxt-bbm.js",
+      "default": "./dist/adapters/nuxt-bbm.js"
+    }
+  },
+  "bin": {
+    "yapi-gen": "./bin/yapi-gen.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "templates",
+    "README.md"
+  ],
+  "dependencies": {
+    "yapi-to-typescript": "^3.38.0"
+  },
+  "peerDependencies": {
+    "yapi-to-typescript": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "yapi-to-typescript": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "keywords": [
+    "yapi",
+    "yapi-to-typescript",
+    "codegen",
+    "api",
+    "typescript"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc"
+  }
+}

package/templates/request-axios.ts

@@ -0,0 +1,33 @@
+/**
+ * 请求适配器模板：适配原生 axios 或封装后的 axios 实例
+ * 使用方式：复制到项目内 requestFunctionFilePath 指定路径，并修改 axios 的引用
+ */
+import type { RequestFunctionParams } from 'yapi-to-typescript';
+import axios from 'axios'; // 或项目内封装的实例，如 @/utils/request
+
+export default async function request<TResponseData>(
+  payload: RequestFunctionParams,
+): Promise<TResponseData> {
+  const baseURL = import.meta?.dev ? payload.devUrl : payload.prodUrl;
+  const isGet = payload.method === 'GET' || payload.method === 'HEAD' || payload.method === 'OPTIONS';
+
+  const config: any = {
+    baseURL: baseURL || '',
+    url: payload.path,
+    method: payload.method.toLowerCase(),
+  };
+
+  if (isGet && payload.data) {
+    config.params = payload.data;
+  } else if (!isGet && payload.data) {
+    config.data = payload.data;
+  }
+
+  const res = await axios.request(config);
+  const data = res?.data;
+
+  if (data != null && typeof data === 'object' && payload.dataKey != null && data[payload.dataKey] != null) {
+    return data[payload.dataKey] as TResponseData;
+  }
+  return data as TResponseData;
+}

package/templates/request-defhttp.ts

@@ -0,0 +1,53 @@
+/**
+ * 请求适配器模板：适配基于 axios 的 defHttp（如 Vite + Vue 项目）
+ * 使用方式：复制到项目内 requestFunctionFilePath 指定路径，并修改 defHttp 的引用路径
+ */
+import type { RequestFunctionParams } from 'yapi-to-typescript';
+// 请根据项目实际路径修改
+import { defHttp } from '/@/utils/http/axios';
+
+export default async function request<TResponseData>(
+  payload: RequestFunctionParams,
+): Promise<TResponseData> {
+  const { method, path, data, hasFileData, getFormData } = payload;
+  const url = path;
+  const isGet = method === 'GET' || method === 'HEAD' || method === 'OPTIONS';
+
+  let config: { url: string; params?: any; data?: any; headers?: Record<string, string> };
+
+  if (isGet) {
+    config = { url, params: {} };
+  } else if (hasFileData && getFormData) {
+    config = { url, params: getFormData() };
+  } else {
+    config = { url, params: data || {} };
+  }
+
+  let res: any;
+  switch (method) {
+    case 'GET':
+    case 'HEAD':
+    case 'OPTIONS':
+      res = await defHttp.get(config);
+      break;
+    case 'POST':
+      res = await defHttp.post(config);
+      break;
+    case 'PUT':
+      res = await defHttp.put(config);
+      break;
+    case 'DELETE':
+      res = await defHttp.delete(config);
+      break;
+    case 'PATCH':
+      res = await (defHttp as any).request({ ...config, method: 'PATCH' });
+      break;
+    default:
+      res = await defHttp.post(config);
+  }
+
+  if (res != null && typeof res === 'object' && payload.dataKey != null && (res as any)[payload.dataKey] != null) {
+    return (res as any)[payload.dataKey] as TResponseData;
+  }
+  return res as TResponseData;
+}

package/templates/request-nuxt.ts

@@ -0,0 +1,25 @@
+/**
+ * 请求适配器模板：适配 Nuxt 项目的 request（如 #imports 的 request / $fetch）
+ * 使用方式：复制到项目内 requestFunctionFilePath 指定路径，并修改 request 的引用（如 #imports）
+ */
+import type { RequestFunctionParams } from 'yapi-to-typescript';
+// Nuxt 项目通常从 #imports 或 useRequest 等引入，请根据项目修改
+import { request } from '#imports';
+
+export default async function requestAdapter<TResponseData>(
+  payload: RequestFunctionParams,
+): Promise<TResponseData> {
+  const baseUrl = import.meta.dev ? payload.devUrl : payload.prodUrl;
+  const res = await request<TResponseData>(payload.path, {
+    baseURL: baseUrl || '',
+    method: payload.method.toLowerCase() as 'get' | 'post' | 'put' | 'delete',
+    ...(payload.requestBodyType === 'json' && payload.data ? { body: payload.data } : {}),
+    ...(payload.requestBodyType === 'query' && payload.data ? { query: payload.data } : {}),
+    tips: false,
+  });
+
+  if (res != null && typeof res === 'object' && payload.dataKey != null && (res as any)[payload.dataKey] != null) {
+    return (res as any)[payload.dataKey] as TResponseData;
+  }
+  return res as TResponseData;
+}