swagger2api-v3 1.0.0

package/dist/api/usercontroller/index.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * UserController API 接口
+ * 此文件由 swagger2api 自动生成，请勿手动修改
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.userControllerDetail1 = exports.userControllerDetail = exports.userControllerUpdate = exports.userControllerCreate = exports.userControllerList = void 0;
+const request_1 = require("../../utils/request");
+/**
+ * 用户列表
+ *
+ * @param body
+ */
+const userControllerList = (data, config) => {
+    return request_1.request.post({
+        url: '/admin/system/user/list',
+        data,
+        ...config
+    });
+};
+exports.userControllerList = userControllerList;
+/**
+ * 创建用户
+ *
+ * @param body
+ */
+const userControllerCreate = (data, config) => {
+    return request_1.request.post({
+        url: '/admin/system/user/create',
+        data,
+        ...config
+    });
+};
+exports.userControllerCreate = userControllerCreate;
+/**
+ * 更新用户
+ *
+ * @param body
+ */
+const userControllerUpdate = (data, config) => {
+    return request_1.request.post({
+        url: '/admin/system/user/update',
+        data,
+        ...config
+    });
+};
+exports.userControllerUpdate = userControllerUpdate;
+/**
+ *
+ * @param pageNum 页码
+ * @param pageSize 每页数量
+ * @param username 用户名
+ */
+const userControllerDetail = (params, config) => {
+    return request_1.request.get({
+        url: '/admin/system/user/detail',
+        params,
+        ...config
+    });
+};
+exports.userControllerDetail = userControllerDetail;
+/**
+ *
+ * @param id
+ */
+const userControllerDetail1 = (params, config) => {
+    return request_1.request.get({
+        url: '/admin/system/user/detail1',
+        params,
+        ...config
+    });
+};
+exports.userControllerDetail1 = userControllerDetail1;

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/index.js

@@ -0,0 +1,200 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const index_1 = require("../index");
+const program = new commander_1.Command();
+// 版本信息
+const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, '../../package.json'), 'utf-8'));
+program
+    .name('swagger2api')
+    .description('从 Swagger/OpenAPI 文档生成 TypeScript API 接口')
+    .version(packageJson.version);
+// generate 命令
+program
+    .command('generate')
+    .alias('gen')
+    .description('根据配置文件生成 API 接口')
+    .option('-c, --config <path>', '配置文件路径', '.swagger.config.ts')
+    .option('-i, --input <path>', 'Swagger JSON 文件路径或 URL')
+    .option('-o, --output <path>', '输出目录')
+    .option('--no-types', '不生成类型文件')
+    .option('--no-group', '不按标签分组')
+    .action(async (options) => {
+    try {
+        if (options.input && options.output) {
+            // 使用命令行参数直接生成
+            const config = {
+                input: options.input,
+                output: options.output,
+                generator: 'typescript',
+                groupByTags: options.group !== false,
+                options: {
+                    generateModels: options.types !== false,
+                    generateApis: true,
+                    generateIndex: true,
+                    useAxios: true,
+                    addComments: true,
+                    prettify: true
+                }
+            };
+            const { generate } = await Promise.resolve().then(() => __importStar(require('../index')));
+            await generate(config);
+        }
+        else {
+            // 使用配置文件生成
+            await (0, index_1.generateFromConfig)(options.config);
+        }
+    }
+    catch (error) {
+        console.error('❌ 生成失败:', error);
+        process.exit(1);
+    }
+});
+// init 命令
+program
+    .command('init')
+    .description('初始化配置文件')
+    .option('-f, --force', '强制覆盖已存在的配置文件')
+    .action(async (options) => {
+    const configPath = path.resolve(process.cwd(), '.swagger.config.ts');
+    if (fs.existsSync(configPath) && !options.force) {
+        console.error('❌ 配置文件已存在，使用 --force 参数强制覆盖');
+        process.exit(1);
+    }
+    const configTemplate = `/**
+ * Swagger2API 配置文件
+ * 用于配置从 Swagger JSON 生成前端接口的参数
+ */
+const config = {
+  // Swagger JSON 文件路径或 URL
+  input: 'https://petstore.swagger.io/v2/swagger.json',
+  
+  // 输出目录
+  output: './src/api',
+  
+  // request 导入路径模板
+  importTemplate: "import { request } from '@/utils/request';",
+  
+  // 生成器类型
+  generator: 'typescript',
+  
+  // 按标签分组生成文件
+  groupByTags: true,
+  
+  // 是否覆盖更新，默认为true。为true时会先删除输出目录下的所有文件
+  overwrite: true,
+  
+  // 接口路径公共前缀，默认为空字符串
+  prefix: '',
+  
+  // 代码格式化命令（可选）
+  lint: 'prettier --write',
+  
+  // 生成选项
+  options: {
+    // 是否添加注释
+    addComments: true
+  }
+};
+
+module.exports = config;
+`;
+    try {
+        fs.writeFileSync(configPath, configTemplate, 'utf-8');
+        console.log('✅ 配置文件已创建:', configPath);
+        console.log('💡 请根据需要修改配置文件，然后运行 swagger2api generate');
+    }
+    catch (error) {
+        console.error('❌ 创建配置文件失败:', error);
+        process.exit(1);
+    }
+});
+// validate 命令
+program
+    .command('validate')
+    .description('验证配置文件')
+    .option('-c, --config <path>', '配置文件路径', '.swagger.config.ts')
+    .action(async (options) => {
+    const configPath = path.resolve(process.cwd(), options.config);
+    try {
+        const configModule = await Promise.resolve(`${configPath}`).then(s => __importStar(require(s)));
+        const config = configModule.default || configModule;
+        const { Swagger2API } = await Promise.resolve().then(() => __importStar(require('../index')));
+        const swagger2api = new Swagger2API(config);
+        if (swagger2api.validateConfig()) {
+            console.log('✅ 配置文件验证通过');
+            // 尝试加载 Swagger 文档
+            try {
+                const { loadSwaggerDocument } = await Promise.resolve().then(() => __importStar(require('../utils')));
+                const document = await loadSwaggerDocument(config.input);
+                console.log(`✅ Swagger 文档加载成功: ${document.info.title} v${document.info.version}`);
+            }
+            catch (error) {
+                console.warn('⚠️  Swagger 文档加载失败:', error);
+            }
+        }
+        else {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error('❌ 配置文件验证失败:', error);
+        process.exit(1);
+    }
+});
+// run 命令（别名，兼容性）
+program
+    .command('run')
+    .description('运行生成器（generate 命令的别名）')
+    .option('-c, --config <path>', '配置文件路径', '.swagger.config.ts')
+    .action(async (options) => {
+    try {
+        await (0, index_1.generateFromConfig)(options.config);
+    }
+    catch (error) {
+        console.error('❌ 生成失败:', error);
+        process.exit(1);
+    }
+});
+// 解析命令行参数
+program.parse();
+// 如果没有提供命令，显示帮助信息
+if (!process.argv.slice(2).length) {
+    program.outputHelp();
+}

package/dist/core/generator.d.ts

@@ -0,0 +1,97 @@
+import { SwaggerConfig, ApiInfo, TypeInfo } from '../types';
+/**
+ * 代码生成器
+ */
+export declare class CodeGenerator {
+    private config;
+    constructor(config: SwaggerConfig);
+    /**
+     * 生成所有文件
+     * @param apis API接口数组
+     * @param types 类型定义数组
+     * @param groupedApis 按标签分组的API
+     */
+    generateAll(apis: ApiInfo[], types: TypeInfo[], groupedApis: Map<string, ApiInfo[]>): Promise<void>;
+    /**
+     * 生成类型定义文件
+     * @param types 类型定义数组
+     */
+    private generateTypesFile;
+    /**
+     * 生成类型文件内容
+     * @param types 类型定义数组
+     * @returns 类型文件内容
+     */
+    private generateTypesContent;
+    /**
+     * 按标签生成API文件
+     * @param groupedApis 按标签分组的API
+     * @param types 类型定义数组
+     */
+    private generateApiFilesByTags;
+    /**
+     * 生成单个API文件
+     * @param apis API接口数组
+     * @param types 类型定义数组
+     */
+    private generateSingleApiFile;
+    /**
+     * 生成API文件内容
+     * @param apis API接口数组
+     * @param types 类型定义数组
+     * @param tag 标签名称（可选）
+     * @returns API文件内容
+     */
+    private generateApiFileContent;
+    /**
+     * 生成单个API函数
+     * @param api API接口信息
+     * @returns API函数代码
+     */
+    private generateApiFunction;
+    /**
+     * 生成直接参数形式
+     * @param parameters Swagger参数数组
+     * @returns 函数参数字符串
+     */
+    private generateDirectParameters;
+    /**
+     * 从schema获取类型
+     * @param schema Swagger schema
+     * @returns 类型字符串
+     */
+    private getTypeFromSchema;
+    /**
+     * 收集API数组中实际使用的类型
+     * @param apis API接口数组
+     * @returns 使用的类型名称数组
+     */
+    private collectUsedTypes;
+    /**
+     * 判断是否为基础类型
+     * @param type 类型名称
+     * @returns 是否为基础类型
+     */
+    private isPrimitiveType;
+    /**
+     * 生成请求配置
+     * @param api API接口信息
+     * @returns 请求配置代码
+     */
+    private generateRequestConfig;
+    /**
+     * 生成入口文件
+     * @param groupedApis 按标签分组的API
+     */
+    private generateIndexFile;
+    /**
+     * 获取标签对应的文件名
+     * @param tag 标签名
+     * @returns 文件名
+     */
+    private getTagFileName;
+    /**
+     * 在所有文件生成完成后运行lint命令
+     */
+    private runLintOnAllFiles;
+}