swagger2api-v3 1.0.3 → 1.0.5

package/dist/cli/index.js

@@ -115,7 +115,7 @@ program
  */
 const config = {
   // Swagger JSON 文件路径或 URL
-  input: 'https://petstore.swagger.io/v2/swagger.json',
+  input: 'http://localhost:3000/admin/docs/json',
   
   // 输出目录
   output: './src/api',

package/dist/core/parser.js

@@ -61,7 +61,13 @@ class SwaggerParser {
             }
         }
         // 生成函数名
-        const functionName = operation.operationId || (0, utils_1.pathToFunctionName)(method, path);
+        let functionName = operation.operationId || (0, utils_1.pathToFunctionName)(method, path);
+        // 如果使用了operationId，需要手动添加HTTP方法后缀
+        if (operation.operationId) {
+            // 将HTTP方法转换为首字母大写的形式并添加到末尾
+            const methodSuffix = method.charAt(0).toUpperCase() + method.slice(1).toLowerCase();
+            functionName = functionName + methodSuffix;
+        }
         // 获取响应类型
         const responseType = (0, utils_1.getResponseType)(operation.responses);
         // 获取请求体类型

package/dist/utils/index.js

@@ -65,20 +65,21 @@ function pathToFunctionName(method, path) {
     // 移除路径参数的大括号
     const cleanPath = path.replace(/\{([^}]+)\}/g, '$1');
     // 分割路径并过滤空字符串
-    const segments = cleanPath.split('/').filter(segment => segment.length > 0);
-    // 将方法名添加到开头
-    const parts = [method.toLowerCase(), ...segments];
-    // 转换为小驼峰命名
-    return parts
-        .map((part, index) => {
+    const segments = cleanPath.split('/').filter((segment) => segment.length > 0);
+    // 将路径段转换为驼峰命名
+    const pathParts = segments.map((part, index) => {
         // 移除特殊字符并转换为小驼峰
         const cleanPart = part.replace(/[^a-zA-Z0-9]/g, '');
         if (index === 0) {
             return cleanPart.toLowerCase();
         }
         return cleanPart.charAt(0).toUpperCase() + cleanPart.slice(1).toLowerCase();
-    })
-        .join('');
+    });
+    // 将HTTP方法转换为首字母大写的形式并添加到末尾
+    const methodSuffix = method.charAt(0).toUpperCase() + method.slice(1).toLowerCase();
+    // 组合路径名称和方法名称
+    const baseName = pathParts.join('');
+    return baseName + methodSuffix;
 }
 /**
  * 将字符串转换为kebab-case
@@ -98,8 +99,8 @@ function toKebabCase(str) {
  */
 function toPascalCase(str) {
     return str
-        .replace(/[\s-_]+(.)?/g, (_, char) => char ? char.toUpperCase() : '')
-        .replace(/^(.)/, char => char.toUpperCase());
+        .replace(/[\s-_]+(.)?/g, (_, char) => (char ? char.toUpperCase() : ''))
+        .replace(/^(.)/, (char) => char.toUpperCase());
 }
 /**
  * 将字符串转换为camelCase
@@ -119,6 +120,20 @@ function swaggerTypeToTsType(schema) {
     if (!schema) {
         return 'any';
     }
+    // 处理 allOf 类型组合
+    if (schema.allOf && schema.allOf.length > 0) {
+        // 对于 allOf，通常第一个元素是引用类型
+        const firstSchema = schema.allOf[0];
+        if (firstSchema.$ref) {
+            const refName = firstSchema.$ref.split('/').pop();
+            return refName || 'any';
+        }
+        // 如果不是引用，尝试合并所有类型
+        const types = schema.allOf
+            .map((s) => swaggerTypeToTsType(s))
+            .filter((t) => t !== 'any');
+        return types.length > 0 ? types[0] : 'any';
+    }
     // 处理引用类型
     if (schema.$ref) {
         const refName = schema.$ref.split('/').pop();
@@ -150,7 +165,7 @@ function swaggerTypeToTsType(schema) {
             return 'number';
         case 'string':
             if (schema.enum) {
-                return schema.enum.map(value => `'${value}'`).join(' | ');
+                return schema.enum.map((value) => `'${value}'`).join(' | ');
             }
             return 'string';
         case 'boolean':
@@ -170,27 +185,27 @@ function generateParameterTypes(parameters) {
     if (!parameters || parameters.length === 0) {
         return '';
     }
-    const queryParams = parameters.filter(p => p.in === 'query');
-    const pathParams = parameters.filter(p => p.in === 'path');
-    const bodyParams = parameters.filter(p => p.in === 'body');
-    const formParams = parameters.filter(p => p.in === 'formData');
+    const queryParams = parameters.filter((p) => p.in === 'query');
+    const pathParams = parameters.filter((p) => p.in === 'path');
+    const bodyParams = parameters.filter((p) => p.in === 'body');
+    const formParams = parameters.filter((p) => p.in === 'formData');
     const types = [];
     // 路径参数
     if (pathParams.length > 0) {
         const pathType = pathParams
-            .map(p => `${p.name}: ${swaggerTypeToTsType({ type: p.type || 'string' })}`)
+            .map((p) => `${p.name}: ${swaggerTypeToTsType({ type: p.type || 'string' })}`)
             .join(', ');
         types.push(`pathParams: { ${pathType} }`);
     }
     // 查询参数
     if (queryParams.length > 0) {
         const queryType = queryParams
-            .map(p => {
+            .map((p) => {
             const optional = p.required ? '' : '?';
             return `${p.name}${optional}: ${swaggerTypeToTsType({ type: p.type || 'string' })}`;
         })
             .join(', ');
-        types.push(`queryParams${queryParams.every(p => !p.required) ? '?' : ''}: { ${queryType} }`);
+        types.push(`queryParams${queryParams.every((p) => !p.required) ? '?' : ''}: { ${queryType} }`);
     }
     // 请求体参数
     if (bodyParams.length > 0) {
@@ -201,7 +216,7 @@ function generateParameterTypes(parameters) {
     // 表单参数
     if (formParams.length > 0) {
         const formType = formParams
-            .map(p => {
+            .map((p) => {
             const optional = p.required ? '' : '?';
             return `${p.name}${optional}: ${swaggerTypeToTsType({ type: p.type || 'string' })}`;
         })
@@ -276,7 +291,7 @@ function generateApiComment(operation, parameters) {
     }
     if (parameters && parameters.length > 0) {
         comments.push(' *');
-        parameters.forEach(param => {
+        parameters.forEach((param) => {
             const description = param.description || '';
             comments.push(` * @param ${param.name} ${description}`);
         });
@@ -307,7 +322,9 @@ function getResponseType(responses) {
         return 'any';
     }
     // 支持OpenAPI 3.0格式 (content.application/json.schema)
-    if (successResponse.content && successResponse.content['application/json'] && successResponse.content['application/json'].schema) {
+    if (successResponse.content &&
+        successResponse.content['application/json'] &&
+        successResponse.content['application/json'].schema) {
         return swaggerTypeToTsType(successResponse.content['application/json'].schema);
     }
     // 支持Swagger 2.0格式 (直接schema)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "swagger2api-v3",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "从 Swagger/OpenAPI 文档生成 TypeScript API 接口的命令行工具",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",