apifox-mock-generator 1.0.0

package/dist/src/generators/templates/mock-template.js

@@ -0,0 +1,283 @@
+import { mapTypeToLodashCheck } from '../../utils/type-mapping.js';
+/**
+ * 生成 Mock 文件内容（新格式，ES Module 版本，支持增量更新）
+ */
+export function generateMockFileContent(endpoint, definitions) {
+    const method = endpoint.method.toUpperCase();
+    // 生成方法前缀和命名空间（用于注释标记）
+    const methodPrefix = endpoint.method.charAt(0).toUpperCase() + endpoint.method.slice(1).toLowerCase();
+    const pathSegments = endpoint.path.split('/').filter(s => s && !s.startsWith('{'));
+    const resourceName = pathSegments[pathSegments.length - 1]
+        ?.split(/[-_]/)
+        .map(part => part.charAt(0).toUpperCase() + part.slice(1))
+        .join('') || 'Api';
+    const namespaceName = `${methodPrefix}${resourceName}`;
+    // 生成参数校验数组
+    const mockParams = generateMockParams(endpoint);
+    // 生成 Mock.js 模板（用于响应数据）
+    const mockTemplate = generateMockTemplateForResponse(endpoint.responseBody, definitions);
+    // 生成注释标记
+    const commentTag = `${endpoint.path}[${method}]`;
+    const content = `//[start]${commentTag}
+/**
+ * @apiName ${endpoint.name}
+ * @apiURI ${endpoint.path}
+ * @apiRequestType ${method}
+ */
+import Mock from "mockjs";
+import lodash from "lodash";
+
+export const check_${namespaceName} = function () {
+\t//ture 本地数据， false 远程服务器数据
+\treturn false;
+};
+
+export function ${namespaceName}(query, body, ctx) {
+    const options = { req: { query, method: ctx.req.method }, data: JSON.stringify(body) }
+    
+    let apiMethod = lodash.get(options, 'req.method');
+    let originQuery = options.req.query;
+    let apiParams = apiMethod === 'GET' ? originQuery : JSON.parse(options.data || '{}');
+    
+    // ${endpoint.name}
+    
+    if (apiMethod === '${method}') {
+        ${mockParams ? `
+        let mockParams = ${mockParams};
+        for(let i = 0, len = mockParams.length; i < len; i++) {
+            let param =  mockParams[i];
+            if (param.paramIsRequired && !apiParams.hasOwnProperty(param.paramKey)) {
+                return {
+                    code: 1,
+                    msg: '缺少必要参数: ' + param.paramKey
+                }
+            }
+            if (apiParams.hasOwnProperty(param.paramKey) && lodash[param.paramType] && !lodash[param.paramType](apiParams[param.paramKey])) {
+                return {
+                    code: 1,
+                    msg: '参数类型错误: ' + param.paramKey
+                }
+            }
+        }
+        ` : ''}
+        return new Promise(res => {
+            setTimeout(() => {
+                res(Mock.mock(${mockTemplate}))
+            }, Math.random() * 3000)
+            
+        })
+        ;
+    }
+        
+
+    return {
+        code: 1,
+    msg: '请检查请求的method或者URI的query是否正确'
+  };
+}
+//[end]${commentTag}
+`;
+    return content;
+}
+/**
+ * 生成参数校验数组
+ */
+function generateMockParams(endpoint) {
+    const params = [];
+    // 收集请求体参数
+    if (endpoint.requestBody) {
+        const bodyParams = extractParamsFromSchema(endpoint.requestBody);
+        params.push(...bodyParams);
+    }
+    // 收集查询参数和路径参数
+    if (endpoint.parameters && endpoint.parameters.length > 0) {
+        endpoint.parameters.forEach(param => {
+            params.push({
+                paramKey: param.name,
+                paramType: mapTypeToLodashCheck(param.type),
+                paramIsRequired: param.required
+            });
+        });
+    }
+    if (params.length === 0) {
+        return null;
+    }
+    // 格式化为多行数组
+    const formattedParams = params.map(p => `\n            {\n                paramKey: '${p.paramKey}',\n                paramType: '${p.paramType}',\n                paramIsRequired: ${p.paramIsRequired}\n            }`).join(',');
+    return `[${formattedParams}\n        ]`;
+}
+/**
+ * 从 schema 提取参数配置
+ */
+function extractParamsFromSchema(schema, required = []) {
+    if (!schema)
+        return [];
+    const params = [];
+    const requiredFields = schema.required || required;
+    if (schema.type === 'object' && schema.properties) {
+        for (const [key, prop] of Object.entries(schema.properties)) {
+            const propSchema = prop;
+            params.push({
+                paramKey: key,
+                paramType: mapTypeToLodashCheck(propSchema.type),
+                paramIsRequired: requiredFields.includes(key)
+            });
+        }
+    }
+    return params;
+}
+/**
+ * 生成 Mock.js 响应模板（格式化为对象字面量）
+ */
+function generateMockTemplateForResponse(schema, definitions, indent = '\t\t\t\t\t') {
+    if (!schema)
+        return '{}';
+    // 处理引用
+    if (schema.$ref) {
+        const refName = schema.$ref.split('/').pop();
+        if (definitions?.[refName]) {
+            return generateMockTemplateForResponse(definitions[refName], definitions, indent);
+        }
+    }
+    // 根据类型生成模板
+    switch (schema.type) {
+        case 'object':
+            if (!schema.properties || Object.keys(schema.properties).length === 0) {
+                return '{}';
+            }
+            let objContent = '{';
+            const props = Object.entries(schema.properties);
+            props.forEach(([key, prop], index) => {
+                const propSchema = prop;
+                const mockValue = generateMockValueForField(key, propSchema, definitions);
+                const comma = index < props.length - 1 ? ',' : '';
+                objContent += `\n${indent}'${key}': ${mockValue}${comma}`;
+            });
+            objContent += `\n${indent.slice(0, -1)}}`; // 减少一级缩进
+            return objContent;
+        case 'array':
+            const itemTemplate = generateMockTemplateForResponse(schema.items, definitions, indent + '\t');
+            return `[${itemTemplate}]`;
+        default:
+            return generateMockValueForField('', schema, definitions);
+    }
+}
+/**
+ * 为单个字段生成 Mock 值
+ */
+function generateMockValueForField(fieldName, schema, definitions) {
+    if (!schema)
+        return 'null';
+    // 处理引用
+    if (schema.$ref) {
+        const refName = schema.$ref.split('/').pop();
+        if (definitions?.[refName]) {
+            return generateMockValueForField(fieldName, definitions[refName], definitions);
+        }
+    }
+    switch (schema.type) {
+        case 'string':
+            return inferStringMockValue(schema, fieldName);
+        case 'number':
+        case 'integer':
+            return inferNumberMockValue(schema, fieldName);
+        case 'boolean':
+            // 使用 Math.random() < 0.5 生成随机布尔值
+            return 'Boolean(Math.random() < 0.5)';
+        case 'array':
+            return `[${generateMockValueForField('', schema.items, definitions)}]`;
+        case 'object':
+            return generateMockTemplateForResponse(schema, definitions);
+        default:
+            return 'null';
+    }
+}
+/**
+ * 推断字符串类型的 Mock 值
+ */
+function inferStringMockValue(schema, fieldName) {
+    // 1. 枚举值
+    if (schema.enum)
+        return `"${schema.enum[0]}"`;
+    // 2. 格式
+    if (schema.format === 'date-time')
+        return '"@datetime"';
+    if (schema.format === 'date')
+        return '"@date"';
+    if (schema.format === 'email')
+        return '"@email"';
+    if (schema.format === 'url')
+        return '"@url"';
+    // 3. 根据字段名推断
+    const name = (fieldName || '').toLowerCase();
+    if (name.includes('code'))
+        return 'String(Math.random() < 1)'; // 状态码通常是字符串 "0" 或 "1"
+    if (name.includes('msg') || name.includes('message')) {
+        // 计算合适的字数范围
+        const minWords = 0;
+        const maxWords = 11;
+        return `'@cword(${minWords}, ${maxWords})'`;
+    }
+    if (name.includes('token'))
+        return '"@guid"';
+    if (name.includes('id') || name.includes('_id'))
+        return '"@guid"';
+    if (name.includes('email'))
+        return '"@email"';
+    if (name.includes('phone') || name.includes('mobile') || name.includes('tel'))
+        return '"/^1[3-9]\\\\d{9}$/"';
+    if (name.includes('name') && !name.includes('file'))
+        return '"@cname"';
+    if (name.includes('username'))
+        return '"@name"';
+    if (name.includes('address'))
+        return '"@county(true)"';
+    if (name.includes('city'))
+        return '"@city"';
+    if (name.includes('province'))
+        return '"@province"';
+    if (name.includes('url') || name.includes('link') || name.includes('href'))
+        return '"@url"';
+    if (name.includes('avatar') || name.includes('image') || name.includes('img') || name.includes('pic'))
+        return '"@image(\\"200x200\\")"';
+    if (name.includes('title'))
+        return '"@ctitle(5, 15)"';
+    if (name.includes('content') || name.includes('desc') || name.includes('description'))
+        return '"@cparagraph(1, 3)"';
+    // 4. 示例值
+    if (schema.example)
+        return `"${schema.example}"`;
+    // 5. 默认规则
+    return '"@string(5, 10)"';
+}
+/**
+ * 推断数字类型的 Mock 值
+ */
+function inferNumberMockValue(schema, fieldName) {
+    // 1. 如果有范围，使用范围
+    if (schema.minimum !== undefined && schema.maximum !== undefined) {
+        return `Number(Math.random() * ${schema.maximum - schema.minimum} + ${schema.minimum})`;
+    }
+    // 2. 根据字段名推断
+    const name = (fieldName || '').toLowerCase();
+    if (name.includes('code') || name.includes('status')) {
+        // code 字段通常 0 表示成功
+        return 'Number(Math.random() < 0)'; // 永远返回 0
+    }
+    if (name.includes('age'))
+        return 'Number(Math.random() * 42 + 18)';
+    if (name.includes('price') || name.includes('amount') || name.includes('money'))
+        return 'Number((Math.random() * 10000).toFixed(2))';
+    if (name.includes('count') || name.includes('num') || name.includes('total'))
+        return 'Math.floor(Math.random() * 1000)';
+    if (name.includes('page'))
+        return 'Math.floor(Math.random() * 100) + 1';
+    if (name.includes('size') || name.includes('limit'))
+        return 'Math.floor(Math.random() * 90) + 10';
+    // 3. 示例值
+    if (schema.example !== undefined)
+        return schema.example.toString();
+    // 4. 默认规则
+    return 'Math.floor(Math.random() * 100)';
+}
+//# sourceMappingURL=mock-template.js.map

package/dist/src/generators/templates/mock-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-template.js","sourceRoot":"","sources":["../../../../src/generators/templates/mock-template.ts"],"names":[],"mappings":"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"}

package/dist/src/generators/templates/type-template.d.ts

@@ -0,0 +1,18 @@
+import type { ApiEndpoint } from '../../types/index.js';
+/**
+ * 为单个接口生成类型文件
+ */
+export declare function generateEndpointTypeFile(endpoint: ApiEndpoint, schemas: any): string;
+/**
+ * 生成接口体内容（属性名带引号）
+ */
+export declare function generateInterfaceBodyWithQuotes(schema: any, definitions: any, indent: string): string;
+/**
+ * 生成嵌套类型和接口（用于复杂请求参数）
+ */
+export declare function generateNestedTypesAndInterfaces(endpoint: ApiEndpoint, schemas: any, namespaceName: string): string;
+/**
+ * 生成请求体属性（带引号）
+ */
+export declare function generateRequestBodyPropertiesWithQuotes(schema: any, definitions: any, namespaceName: string, indent: string): string;
+//# sourceMappingURL=type-template.d.ts.map

package/dist/src/generators/templates/type-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-template.d.ts","sourceRoot":"","sources":["../../../../src/generators/templates/type-template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAGvD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,GAAG,MAAM,CAwDpF;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAmCrG;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAoFnH;AAED;;GAEG;AACH,wBAAgB,uCAAuC,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CA4CpI"}

package/dist/src/generators/templates/type-template.js

@@ -0,0 +1,201 @@
+import { getTypeScriptType, getTypeScriptTypeWithEnumCheck, mapSchemaTypeToTS } from '../../utils/type-mapping.js';
+/**
+ * 为单个接口生成类型文件
+ */
+export function generateEndpointTypeFile(endpoint, schemas) {
+    // 生成方法前缀（如 Post, Get, Put 等）
+    const methodPrefix = endpoint.method.charAt(0).toUpperCase() + endpoint.method.slice(1).toLowerCase();
+    // 生成命名空间名称（基于路径的最后一段，转为驼峰命名）
+    const pathSegments = endpoint.path.split('/').filter(s => s && !s.startsWith('{'));
+    const resourceName = pathSegments[pathSegments.length - 1]
+        ?.split(/[-_]/)
+        .map(part => part.charAt(0).toUpperCase() + part.slice(1))
+        .join('') || 'Api';
+    const namespaceName = `${methodPrefix}${resourceName}`;
+    // 生成注释标记
+    const commentTag = `${endpoint.path}[${endpoint.method}]`;
+    let content = `//[start]${commentTag}
+export namespace ${namespaceName} {`;
+    // 生成响应类型
+    content += `\n  export interface Res ${generateInterfaceBodyWithQuotes(endpoint.responseBody, schemas, '  ')}`;
+    // 生成嵌套类型和接口（用于请求参数）
+    const nestedTypes = generateNestedTypesAndInterfaces(endpoint, schemas, namespaceName);
+    if (nestedTypes) {
+        content += `\n\n${nestedTypes}`;
+    }
+    // 生成请求参数类型（合并 query, path params 和 body）
+    const hasParams = endpoint.parameters && endpoint.parameters.length > 0;
+    const hasBody = endpoint.requestBody;
+    if (hasParams || hasBody) {
+        content += `\n\n  export interface Request {`;
+        // 添加路径参数和查询参数
+        if (hasParams) {
+            endpoint.parameters?.forEach(param => {
+                const optional = param.required ? '' : '?';
+                const description = param.description ? `\n    /** ${param.description} */` : '';
+                content += `${description}\n    '${param.name}'${optional}: ${mapSchemaTypeToTS(param.type)};`;
+            });
+        }
+        // 添加请求体参数
+        if (hasBody) {
+            const bodyProps = generateRequestBodyPropertiesWithQuotes(endpoint.requestBody, schemas, namespaceName, '    ');
+            content += bodyProps;
+        }
+        content += `\n  }`;
+    }
+    content += `\n}\n//[end]${commentTag}\n`;
+    return content;
+}
+/**
+ * 生成接口体内容（属性名带引号）
+ */
+export function generateInterfaceBodyWithQuotes(schema, definitions, indent) {
+    if (!schema)
+        return '{}';
+    // 处理引用
+    if (schema.$ref) {
+        const refName = schema.$ref.split('/').pop();
+        if (definitions?.[refName]) {
+            return generateInterfaceBodyWithQuotes(definitions[refName], definitions, indent);
+        }
+    }
+    if (schema.type === 'object' && schema.properties) {
+        const props = Object.entries(schema.properties);
+        if (props.length === 0) {
+            return '{}';
+        }
+        let result = '{';
+        const required = schema.required || [];
+        for (const [propName, propSchema] of Object.entries(schema.properties)) {
+            const prop = propSchema;
+            const isRequired = required.includes(propName);
+            const optional = isRequired ? '' : '?';
+            const description = prop.description ? `\n${indent}  /** ${prop.description} */` : '';
+            const tsType = getTypeScriptType(prop);
+            result += `${description}\n${indent}  '${propName}'${optional}: ${tsType};`;
+        }
+        result += `\n${indent}}`;
+        return result;
+    }
+    return '{}';
+}
+/**
+ * 生成嵌套类型和接口（用于复杂请求参数）
+ */
+export function generateNestedTypesAndInterfaces(endpoint, schemas, namespaceName) {
+    if (!endpoint.requestBody)
+        return '';
+    const schema = endpoint.requestBody;
+    let result = '';
+    const generatedInterfaces = new Set();
+    // 递归处理 schema 中的嵌套对象
+    const processSchema = (s, parentName) => {
+        if (!s || !s.properties)
+            return;
+        for (const [propName, propSchema] of Object.entries(s.properties)) {
+            const prop = propSchema;
+            // 处理枚举类型
+            if (prop.type === 'string' && prop.enum && prop.enum.length > 0) {
+                const typeName = `${parentName}${propName.charAt(0).toUpperCase() + propName.slice(1).replace(/_([a-z])/g, (_, c) => c.toUpperCase())}`;
+                if (!generatedInterfaces.has(typeName)) {
+                    const enumValues = prop.enum.map((v) => typeof v === 'string' ? `'${v}'` : v).join(' | ');
+                    result += `  export type ${typeName} = ${enumValues};\n\n`;
+                    generatedInterfaces.add(typeName);
+                }
+            }
+            // 处理数字枚举类型
+            if ((prop.type === 'number' || prop.type === 'integer') && prop.enum && prop.enum.length > 0) {
+                const typeName = `${parentName}${propName.charAt(0).toUpperCase() + propName.slice(1).replace(/_([a-z])/g, (_, c) => c.toUpperCase())}`;
+                if (!generatedInterfaces.has(typeName)) {
+                    const enumValues = prop.enum.join(' | ');
+                    result += `  export type ${typeName} = ${enumValues};\n\n`;
+                    generatedInterfaces.add(typeName);
+                }
+            }
+            // 处理嵌套对象
+            if (prop.type === 'object' && prop.properties) {
+                const interfaceName = `${parentName}${propName.charAt(0).toUpperCase() + propName.slice(1).replace(/_([a-z])/g, (_, c) => c.toUpperCase())}`;
+                if (!generatedInterfaces.has(interfaceName)) {
+                    result += `  export interface ${interfaceName} {\n`;
+                    const required = prop.required || [];
+                    for (const [nestedPropName, nestedPropSchema] of Object.entries(prop.properties)) {
+                        const nestedProp = nestedPropSchema;
+                        const isRequired = required.includes(nestedPropName);
+                        const optional = isRequired ? '' : '?';
+                        const tsType = getTypeScriptTypeWithEnumCheck(nestedProp, `${interfaceName}${nestedPropName.charAt(0).toUpperCase() + nestedPropName.slice(1).replace(/_([a-z])/g, (_, c) => c.toUpperCase())}`);
+                        result += `    '${nestedPropName}'${optional}: ${tsType};\n`;
+                    }
+                    result += `  }\n\n`;
+                    generatedInterfaces.add(interfaceName);
+                    // 递归处理嵌套对象的属性
+                    processSchema(prop, interfaceName);
+                }
+            }
+            // 处理数组中的对象
+            if (prop.type === 'array' && prop.items?.type === 'object' && prop.items.properties) {
+                const interfaceName = `${parentName}${propName.charAt(0).toUpperCase() + propName.slice(1).replace(/_([a-z])/g, (_, c) => c.toUpperCase())}Item`;
+                if (!generatedInterfaces.has(interfaceName)) {
+                    result += `  export interface ${interfaceName} {\n`;
+                    const required = prop.items.required || [];
+                    for (const [itemPropName, itemPropSchema] of Object.entries(prop.items.properties)) {
+                        const itemProp = itemPropSchema;
+                        const isRequired = required.includes(itemPropName);
+                        const optional = isRequired ? '' : '?';
+                        const tsType = getTypeScriptType(itemProp);
+                        result += `    '${itemPropName}'${optional}: ${tsType};\n`;
+                    }
+                    result += `  }\n\n`;
+                    generatedInterfaces.add(interfaceName);
+                }
+            }
+        }
+    };
+    processSchema(schema, `${namespaceName}Request`);
+    return result.trimEnd();
+}
+/**
+ * 生成请求体属性（带引号）
+ */
+export function generateRequestBodyPropertiesWithQuotes(schema, definitions, namespaceName, indent) {
+    if (!schema)
+        return '';
+    // 处理引用
+    if (schema.$ref) {
+        const refName = schema.$ref.split('/').pop();
+        if (definitions?.[refName]) {
+            return generateRequestBodyPropertiesWithQuotes(definitions[refName], definitions, namespaceName, indent);
+        }
+    }
+    if (schema.type === 'object' && schema.properties) {
+        let result = '';
+        const required = schema.required || [];
+        for (const [propName, propSchema] of Object.entries(schema.properties)) {
+            const prop = propSchema;
+            const isRequired = required.includes(propName);
+            const optional = isRequired ? '' : '?';
+            const description = prop.description ? `\n${indent}/** ${prop.description} */` : '';
+            // 生成类型，对于嵌套对象使用接口名
+            let tsType;
+            if (prop.type === 'object' && prop.properties) {
+                const interfaceName = `${namespaceName}Request${propName.charAt(0).toUpperCase() + propName.slice(1).replace(/_([a-z])/g, (_, c) => c.toUpperCase())}`;
+                tsType = interfaceName;
+            }
+            else if (prop.type === 'array' && prop.items?.type === 'object' && prop.items.properties) {
+                const interfaceName = `${namespaceName}Request${propName.charAt(0).toUpperCase() + propName.slice(1).replace(/_([a-z])/g, (_, c) => c.toUpperCase())}Item`;
+                tsType = `${interfaceName}[]`;
+            }
+            else if (prop.enum && prop.enum.length > 0) {
+                // 使用枚举类型名
+                const enumTypeName = `${namespaceName}Request${propName.charAt(0).toUpperCase() + propName.slice(1).replace(/_([a-z])/g, (_, c) => c.toUpperCase())}`;
+                tsType = enumTypeName;
+            }
+            else {
+                tsType = getTypeScriptType(prop);
+            }
+            result += `${description}\n${indent}'${propName}'${optional}: ${tsType};`;
+        }
+        return result;
+    }
+    return '';
+}
+//# sourceMappingURL=type-template.js.map

package/dist/src/generators/templates/type-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-template.js","sourceRoot":"","sources":["../../../../src/generators/templates/type-template.ts"],"names":[],"mappings":"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"}

package/dist/src/generators/type-generator.d.ts

@@ -0,0 +1,6 @@
+import type { ApifoxConfig, ApiEndpoint } from '../types/index.js';
+/**
+ * 生成 TypeScript 类型文件
+ */
+export declare function generateTypeFiles(config: ApifoxConfig, openapi: any, endpoints: ApiEndpoint[]): Promise<void>;
+//# sourceMappingURL=type-generator.d.ts.map

package/dist/src/generators/type-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-generator.d.ts","sourceRoot":"","sources":["../../../src/generators/type-generator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAElE;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BnH"}

package/dist/src/generators/type-generator.js

@@ -0,0 +1,31 @@
+import path from 'path';
+import { fileHelper } from '../utils/file-helper.js';
+import { logger } from '../utils/logger.js';
+import { groupEndpointsByPath } from '../utils/path-utils.js';
+import { generateEndpointTypeFile } from './templates/type-template.js';
+/**
+ * 生成 TypeScript 类型文件
+ */
+export async function generateTypeFiles(config, openapi, endpoints) {
+    logger.title('生成 TypeScript 类型文件...');
+    await fileHelper.ensureDir(config.typesDir);
+    const schemas = openapi.components?.schemas || {};
+    let generatedCount = 0;
+    // 按资源路径分组接口，使用增量更新
+    const groupedEndpoints = groupEndpointsByPath(endpoints);
+    for (const [groupPath, groupEndpoints] of Object.entries(groupedEndpoints)) {
+        const typeFilePath = path.join(config.typesDir, `${groupPath}.ts`);
+        // 为每个接口生成类型定义块
+        for (const endpoint of groupEndpoints) {
+            const typeContent = generateEndpointTypeFile(endpoint, schemas);
+            const blockIdentifier = `${endpoint.path}[${endpoint.method}]`;
+            // 使用增量更新，支持多个接口在同一文件
+            await fileHelper.updateFileWithBlock(typeFilePath, typeContent, blockIdentifier);
+            generatedCount++;
+        }
+        logger.info(`  ✓ ${typeFilePath} (${groupEndpoints.length} 个接口)`);
+    }
+    logger.success(`\n类型文件生成完成！`);
+    logger.info(`共生成 ${generatedCount} 个接口类型`);
+}
+//# sourceMappingURL=type-generator.js.map

package/dist/src/generators/type-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-generator.js","sourceRoot":"","sources":["../../../src/generators/type-generator.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAA;AAGvE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAoB,EAAE,OAAY,EAAE,SAAwB;IAClG,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAA;IAErC,MAAM,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAE3C,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,OAAO,IAAI,EAAE,CAAA;IACjD,IAAI,cAAc,GAAG,CAAC,CAAA;IAEtB,mBAAmB;IACnB,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAA;IAExD,KAAK,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC3E,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,SAAS,KAAK,CAAC,CAAA;QAElE,eAAe;QACf,KAAK,MAAM,QAAQ,IAAI,cAAc,EAAE,CAAC;YACtC,MAAM,WAAW,GAAG,wBAAwB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;YAC/D,MAAM,eAAe,GAAG,GAAG,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAA;YAE9D,qBAAqB;YACrB,MAAM,UAAU,CAAC,mBAAmB,CAAC,YAAY,EAAE,WAAW,EAAE,eAAe,CAAC,CAAA;YAChF,cAAc,EAAE,CAAA;QAClB,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,OAAO,YAAY,KAAK,cAAc,CAAC,MAAM,OAAO,CAAC,CAAA;IACnE,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;IAC7B,MAAM,CAAC,IAAI,CAAC,OAAO,cAAc,QAAQ,CAAC,CAAA;AAC5C,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types/index.js';
+export * from './utils/logger.js';
+export declare const version: any;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AAMjC,eAAO,MAAM,OAAO,KAAc,CAAA"}

package/dist/src/index.js

@@ -0,0 +1,9 @@
+// 主入口文件 - 导出公共 API
+export * from './types/index.js';
+export * from './utils/logger.js';
+// 版本信息 - 从 package.json 读取
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+export const version = pkg.version;
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AAEjC,2BAA2B;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AACtC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;AACtC,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAA"}

package/dist/src/scripts/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/src/scripts/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/scripts/cli.ts"],"names":[],"mappings":""}