apifox-mock-generator 1.4.6 → 2.0.0

package/CHANGELOG.md

@@ -5,6 +5,109 @@
 格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
 版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [2.0.0] - 2026-01-08
+
+### 🎯 重大更新
+
+这是一个重大版本更新，引入了全新的架构设计和多项核心功能改进。
+
+### ✨ 新增功能
+
+#### 🏗️ 项目架构重构
+
+- **依赖注入容器** - 引入依赖注入（DI）容器，优化服务注册和解析
+  - 实现基于接口的服务注册机制，提升代码解耦和可测试性
+  - 支持服务标识符常量管理，统一服务注册和解析
+  - 提供容器设置和初始化功能，简化依赖管理
+
+- **用例模式（Use Cases）** - 新增多个用例类，负责处理核心业务逻辑
+  - `FetchApifoxDataUseCase` - 处理从 Apifox 获取 OpenAPI 文档
+  - `GenerateMockUseCase` - 处理 Mock 文件生成
+  - `GenerateTypesUseCase` - 处理 TypeScript 类型生成
+  - `ServeMockUseCase` - 处理 Mock 服务器启动
+  - 每个用例专注于单一职责，提升代码可维护性
+
+- **领域驱动设计（DDD）架构** - 重构项目结构，采用分层架构
+  - **domain/** - 领域层：实体、服务接口、业务逻辑
+  - **application/** - 应用层：用例实现
+  - **infrastructure/** - 基础设施层：具体实现（文件系统、日志、HTTP 客户端等）
+  - **presentation/** - 表现层：HTTP 服务器、中间件等
+  - 清晰的层次划分，提升代码组织性和可维护性
+
+- **统一文件系统接口** - 实现统一的文件系统操作接口
+  - 新增 `IFileSystem` 接口和 `FileSystemImpl` 实现
+  - 替代原有的分散文件操作工具，统一文件操作方式
+  - 支持依赖注入，便于测试和替换
+
+#### 🛡️ 统一错误处理机制
+
+- **错误类体系** - 新增统一的错误处理类
+  - `ApifoxError` - 基础错误类
+  - `ConfigError` - 配置错误类
+  - `NetworkError` - 网络错误类
+  - `ApifoxApiError` - Apifox API 错误类
+  - 所有错误类支持详细的错误信息和建议
+
+- **错误码系统** - 引入错误码常量定义
+  - 统一的错误码管理（`ERROR_CODES`）
+  - 错误码到 HTTP 状态码的映射（`ERROR_TO_HTTP_STATUS`）
+  - 便于错误管理和调试
+
+- **错误处理中间件** - 新增 Express 错误处理中间件
+  - 统一的错误响应格式
+  - 自动转换错误码为 HTTP 状态码
+  - 提供详细的错误信息和建议
+
+#### 📝 类型安全增强
+
+- **OpenAPI 类型定义** - 引入完整的 OpenAPI 类型定义
+  - `OpenAPIDocument` - OpenAPI 文档类型
+  - `OpenAPISchema` - Schema 类型定义
+  - 将多个函数的参数和返回值类型从 `any` 修改为具体的 OpenAPI 类型
+  - 提升类型安全，减少类型不匹配的风险
+
+#### 🧪 测试支持
+
+- **E2E 测试框架** - 新增端到端测试支持
+  - 使用 Vitest 作为测试框架
+  - 支持配置测试、生成文件测试、Mock 服务器测试
+  - 提供测试辅助工具和帮助函数
+  - 新增测试脚本：`test:e2e`、`test:e2e:config`、`test:e2e:mock`
+
+### 🔄 重构改进
+
+- **路由管理器重构** - 将路由管理器迁移到基础设施层
+  - 实现 `IRouteManager` 接口
+  - 支持依赖注入，便于测试和替换
+
+- **日志系统重构** - 重构日志系统为接口实现
+  - 新增 `ILogger` 接口和 `ConsoleLoggerImpl` 实现
+  - 支持依赖注入，便于替换日志实现
+
+- **服务接口抽象** - 新增多个服务接口
+  - `IApifoxClient` - Apifox 客户端接口
+  - `IRouteManager` - 路由管理器接口
+  - `IFileSystem` - 文件系统接口
+  - `ILogger` - 日志接口
+  - `IHttpClient` - HTTP 客户端接口
+
+- **代码组织优化** - 优化代码组织结构
+  - 多个模块文件路径发生变化（内部重构，不影响用户使用）
+    - `src/server/` → `src/infrastructure/server/` 或 `src/presentation/http/`
+    - `src/utils/logger.ts` → `src/infrastructure/logger/console-logger.impl.ts`
+    - `src/utils/file-operations.ts` → `src/infrastructure/file-system/file-system.impl.ts`
+  - 移除不再使用的代码和模块
+  - 统一导出文件，简化导入路径
+  - 提升代码整洁度和可维护性
+  - 注意：这些是内部重构，用户通过配置文件（`apifox.config.json`、`mock.config.js`）和命令行工具使用，不受影响
+
+### 📖 文档更新
+
+- **架构设计文档** - 新增架构设计文档（`doc/ARCHITECTURE_DESIGN.md`）
+  - 提供项目整体结构说明
+  - 详细的功能模块介绍
+  - 依赖注入使用指南
+
 ## [1.4.6] - 2025-12-09
 
 ### 🐛 修复

package/README.md

@@ -69,7 +69,7 @@ export default {
   // 本地服务的端口
   port: 10000,
   // 默认代理至系统测试环境, 请配置本地host
-  target: 'http://36.133.230.52:9101',
+  target: 'http://172.24.7.99:8082',
   // 开始remote参数, 通过url中remote=xxx来代理多个后端地址, 需要mock直接在url中设置remote=mock即可
   remoteTarget: true,
   // 按接口粒度控制 Mock/Proxy（可选）

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "apifox-mock-generator",
-    "version": "1.4.6",
+    "version": "2.0.0",
     "description": "从Apifox拉取API接口并生成本地mock和TypeScript类型文件，并提供mock服务器",
     "main": "dist/src/index.js",
     "type": "module",
@@ -15,10 +15,26 @@
         "dev:generate": "tsx src/scripts/generate-mock.ts",
         "dev:serve": "tsx src/scripts/serve-mock.ts",
         "dev:full": "npm run dev:generate && npm run dev:serve",
+        "test:e2e": "vitest run tests/e2e",
+        "test:e2e:config": "vitest run tests/e2e/apifox-config.e2e.test.ts tests/e2e/generated-files.e2e.test.ts",
+        "test:e2e:mock": "vitest run tests/e2e/mock-config.e2e.test.ts tests/e2e/mock-server.e2e.test.ts",
         "prepublishOnly": "npm run build"
     },
-    "files": ["dist", "README.md", "LICENSE", "CHANGELOG.md"],
-    "keywords": ["apifox", "mock", "api", "typescript", "mock-server", "openapi", "code-generator"],
+    "files": [
+        "dist",
+        "README.md",
+        "LICENSE",
+        "CHANGELOG.md"
+    ],
+    "keywords": [
+        "apifox",
+        "mock",
+        "api",
+        "typescript",
+        "mock-server",
+        "openapi",
+        "code-generator"
+    ],
     "author": "liujun",
     "license": "MIT",
     "repository": {
@@ -42,8 +58,10 @@
         "eslint-plugin-unicorn": "^61.0.2",
         "eslint-plugin-vue": "^10.5.1",
         "glob": "^11.0.3",
+        "puppeteer": "^24.34.0",
         "tsx": "^4.7.0",
-        "typescript": "^5.3.3"
+        "typescript": "^5.3.3",
+        "vitest": "^1.0.0"
     },
     "peerDependencies": {
         "lodash": "^4.17.21",

package/dist/src/application/use-cases/fetch-apifox-data.use-case.d.ts

@@ -0,0 +1,19 @@
+import type { IApifoxClient, ILogger } from '../../domain/interfaces.js';
+import type { ApifoxConfig } from '../../types/index.js';
+import type { OpenAPIDocument } from '../../types/openapi.js';
+/**
+ * 获取 Apifox 数据用例
+ * 负责从 Apifox 获取 OpenAPI 文档
+ */
+export declare class FetchApifoxDataUseCase {
+    private readonly apifoxClient;
+    private readonly logger;
+    constructor(apifoxClient: IApifoxClient, logger: ILogger);
+    /**
+     * 执行用例
+     * @param config Apifox 配置
+     * @returns OpenAPI 文档
+     */
+    execute(config: ApifoxConfig): Promise<OpenAPIDocument>;
+}
+//# sourceMappingURL=fetch-apifox-data.use-case.d.ts.map

package/dist/src/application/use-cases/fetch-apifox-data.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-apifox-data.use-case.d.ts","sourceRoot":"","sources":["../../../../src/application/use-cases/fetch-apifox-data.use-case.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;GAGG;AACH,qBAAa,sBAAsB;IAE/B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,YAAY,EAAE,aAAa,EAC3B,MAAM,EAAE,OAAO;IAGlC;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC;CAmB9D"}

package/dist/src/application/use-cases/fetch-apifox-data.use-case.js

@@ -0,0 +1,29 @@
+/**
+ * 获取 Apifox 数据用例
+ * 负责从 Apifox 获取 OpenAPI 文档
+ */
+export class FetchApifoxDataUseCase {
+    constructor(apifoxClient, logger) {
+        this.apifoxClient = apifoxClient;
+        this.logger = logger;
+    }
+    /**
+     * 执行用例
+     * @param config Apifox 配置
+     * @returns OpenAPI 文档
+     */
+    async execute(config) {
+        this.logger.info('从 Apifox 拉取 API 数据...');
+        try {
+            const openapi = await this.apifoxClient.fetchOpenAPI(config);
+            const endpointCount = Object.keys(openapi.paths || {}).length;
+            this.logger.success(`✓ 从 Apifox 拉取成功（${endpointCount} 个接口）`);
+            return openapi;
+        }
+        catch (error) {
+            this.logger.error(`❌ 拉取失败: ${error instanceof Error ? error.message : '未知错误'}`);
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=fetch-apifox-data.use-case.js.map

package/dist/src/application/use-cases/fetch-apifox-data.use-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-apifox-data.use-case.js","sourceRoot":"","sources":["../../../../src/application/use-cases/fetch-apifox-data.use-case.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,OAAO,sBAAsB;IACjC,YACmB,YAA2B,EAC3B,MAAe;QADf,iBAAY,GAAZ,YAAY,CAAe;QAC3B,WAAM,GAAN,MAAM,CAAS;IAC/B,CAAC;IAEJ;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,MAAoB;QAChC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAE1C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAE7D,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YAC9D,IAAI,CAAC,MAAM,CAAC,OAAO,CACjB,mBAAmB,aAAa,OAAO,CACxC,CAAC;YAEF,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,WAAW,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,CAC7D,CAAC;YACF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/src/application/use-cases/generate-mock.use-case.d.ts

@@ -0,0 +1,22 @@
+import type { ILogger } from '../../domain/interfaces.js';
+import type { ApifoxConfig } from '../../types/index.js';
+import type { OpenAPIDocument } from '../../types/openapi.js';
+import { EndpointFilterService } from '../../domain/services/endpoint-filter.service.js';
+import { OpenAPIConverterService } from '../../domain/services/openapi-converter.service.js';
+/**
+ * 生成 Mock 用例
+ * 负责生成 Mock 文件
+ */
+export declare class GenerateMockUseCase {
+    private readonly endpointFilter;
+    private readonly openapiConverter;
+    private readonly logger;
+    constructor(endpointFilter: EndpointFilterService, openapiConverter: OpenAPIConverterService, logger: ILogger);
+    /**
+     * 执行用例
+     * @param config Apifox 配置
+     * @param openapi OpenAPI 文档
+     */
+    execute(config: ApifoxConfig, openapi: OpenAPIDocument): Promise<void>;
+}
+//# sourceMappingURL=generate-mock.use-case.d.ts.map

package/dist/src/application/use-cases/generate-mock.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-mock.use-case.d.ts","sourceRoot":"","sources":["../../../../src/application/use-cases/generate-mock.use-case.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kDAAkD,CAAC;AACzF,OAAO,EAAE,uBAAuB,EAAE,MAAM,oDAAoD,CAAC;AAI7F;;;GAGG;AACH,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,cAAc,EAAE,qBAAqB,EACrC,gBAAgB,EAAE,uBAAuB,EACzC,MAAM,EAAE,OAAO;IAGlC;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CA+B7E"}

package/dist/src/application/use-cases/generate-mock.use-case.js

@@ -0,0 +1,42 @@
+import { generateMockFiles } from '../../generators/mock-generator.js';
+/**
+ * 生成 Mock 用例
+ * 负责生成 Mock 文件
+ */
+export class GenerateMockUseCase {
+    constructor(endpointFilter, openapiConverter, logger) {
+        this.endpointFilter = endpointFilter;
+        this.openapiConverter = openapiConverter;
+        this.logger = logger;
+    }
+    /**
+     * 执行用例
+     * @param config Apifox 配置
+     * @param openapi OpenAPI 文档
+     */
+    async execute(config, openapi) {
+        this.logger.title('生成 Mock 文件...');
+        // 转换为端点实体
+        const allEndpoints = this.openapiConverter.convert(openapi);
+        this.logger.success(`✓ 解析到 ${allEndpoints.length} 个 API 接口`);
+        // 应用过滤（转换为普通对象以兼容现有生成器）
+        const filteredEndpoints = this.endpointFilter.filter(allEndpoints, config.apiFilter);
+        if (config.apiFilter) {
+            const filteredCount = allEndpoints.length - filteredEndpoints.length;
+            if (filteredCount > 0) {
+                this.logger.info(`  应用客户端筛选规则，过滤掉 ${filteredCount} 个接口`);
+            }
+            this.logger.success(`✓ 保留 ${filteredEndpoints.length} 个接口用于生成`);
+        }
+        if (filteredEndpoints.length === 0) {
+            this.logger.warn('没有匹配的 API 接口，请检查筛选规则配置');
+            return;
+        }
+        // 转换为普通对象以兼容现有生成器
+        const endpoints = filteredEndpoints.map(e => e.toJSON());
+        // 生成 Mock 文件
+        await generateMockFiles(config, endpoints, openapi.components?.schemas);
+        this.logger.success('✓ Mock 文件生成完成');
+    }
+}
+//# sourceMappingURL=generate-mock.use-case.js.map

package/dist/src/application/use-cases/generate-mock.use-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-mock.use-case.js","sourceRoot":"","sources":["../../../../src/application/use-cases/generate-mock.use-case.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAGvE;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IAC9B,YACmB,cAAqC,EACrC,gBAAyC,EACzC,MAAe;QAFf,mBAAc,GAAd,cAAc,CAAuB;QACrC,qBAAgB,GAAhB,gBAAgB,CAAyB;QACzC,WAAM,GAAN,MAAM,CAAS;IAC/B,CAAC;IAEJ;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,MAAoB,EAAE,OAAwB;QAC1D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAEnC,UAAU;QACV,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,YAAY,CAAC,MAAM,WAAW,CAAC,CAAC;QAE7D,wBAAwB;QACxB,MAAM,iBAAiB,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAErF,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,MAAM,aAAa,GAAG,YAAY,CAAC,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC;YACrE,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;gBACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,aAAa,MAAM,CAAC,CAAC;YAC3D,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,iBAAiB,CAAC,MAAM,UAAU,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,kBAAkB;QAClB,MAAM,SAAS,GAAkB,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAExE,aAAa;QACb,MAAM,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAExE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/src/application/use-cases/generate-types.use-case.d.ts

@@ -0,0 +1,22 @@
+import type { ILogger } from '../../domain/interfaces.js';
+import type { ApifoxConfig } from '../../types/index.js';
+import type { OpenAPIDocument } from '../../types/openapi.js';
+import { EndpointFilterService } from '../../domain/services/endpoint-filter.service.js';
+import { OpenAPIConverterService } from '../../domain/services/openapi-converter.service.js';
+/**
+ * 生成类型用例
+ * 负责生成 TypeScript 类型文件
+ */
+export declare class GenerateTypesUseCase {
+    private readonly endpointFilter;
+    private readonly openapiConverter;
+    private readonly logger;
+    constructor(endpointFilter: EndpointFilterService, openapiConverter: OpenAPIConverterService, logger: ILogger);
+    /**
+     * 执行用例
+     * @param config Apifox 配置
+     * @param openapi OpenAPI 文档
+     */
+    execute(config: ApifoxConfig, openapi: OpenAPIDocument): Promise<void>;
+}
+//# sourceMappingURL=generate-types.use-case.d.ts.map

package/dist/src/application/use-cases/generate-types.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-types.use-case.d.ts","sourceRoot":"","sources":["../../../../src/application/use-cases/generate-types.use-case.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kDAAkD,CAAC;AACzF,OAAO,EAAE,uBAAuB,EAAE,MAAM,oDAAoD,CAAC;AAI7F;;;GAGG;AACH,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,cAAc,EAAE,qBAAqB,EACrC,gBAAgB,EAAE,uBAAuB,EACzC,MAAM,EAAE,OAAO;IAGlC;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CA+B7E"}

package/dist/src/application/use-cases/generate-types.use-case.js

@@ -0,0 +1,42 @@
+import { generateTypeFiles } from '../../generators/type-generator.js';
+/**
+ * 生成类型用例
+ * 负责生成 TypeScript 类型文件
+ */
+export class GenerateTypesUseCase {
+    constructor(endpointFilter, openapiConverter, logger) {
+        this.endpointFilter = endpointFilter;
+        this.openapiConverter = openapiConverter;
+        this.logger = logger;
+    }
+    /**
+     * 执行用例
+     * @param config Apifox 配置
+     * @param openapi OpenAPI 文档
+     */
+    async execute(config, openapi) {
+        this.logger.title('生成 TypeScript 类型文件...');
+        // 转换为端点实体
+        const allEndpoints = this.openapiConverter.convert(openapi);
+        this.logger.success(`✓ 解析到 ${allEndpoints.length} 个 API 接口`);
+        // 应用过滤（转换为普通对象以兼容现有生成器）
+        const filteredEndpoints = this.endpointFilter.filter(allEndpoints, config.apiFilter);
+        if (config.apiFilter) {
+            const filteredCount = allEndpoints.length - filteredEndpoints.length;
+            if (filteredCount > 0) {
+                this.logger.info(`  应用客户端筛选规则，过滤掉 ${filteredCount} 个接口`);
+            }
+            this.logger.success(`✓ 保留 ${filteredEndpoints.length} 个接口用于生成`);
+        }
+        if (filteredEndpoints.length === 0) {
+            this.logger.warn('没有匹配的 API 接口，请检查筛选规则配置');
+            return;
+        }
+        // 转换为普通对象以兼容现有生成器
+        const endpoints = filteredEndpoints.map(e => e.toJSON());
+        // 生成类型文件
+        await generateTypeFiles(config, openapi, endpoints);
+        this.logger.success('✓ 类型文件生成完成');
+    }
+}
+//# sourceMappingURL=generate-types.use-case.js.map

package/dist/src/application/use-cases/generate-types.use-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-types.use-case.js","sourceRoot":"","sources":["../../../../src/application/use-cases/generate-types.use-case.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAGvE;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IAC/B,YACmB,cAAqC,EACrC,gBAAyC,EACzC,MAAe;QAFf,mBAAc,GAAd,cAAc,CAAuB;QACrC,qBAAgB,GAAhB,gBAAgB,CAAyB;QACzC,WAAM,GAAN,MAAM,CAAS;IAC/B,CAAC;IAEJ;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,MAAoB,EAAE,OAAwB;QAC1D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAE3C,UAAU;QACV,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,YAAY,CAAC,MAAM,WAAW,CAAC,CAAC;QAE7D,wBAAwB;QACxB,MAAM,iBAAiB,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAErF,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,MAAM,aAAa,GAAG,YAAY,CAAC,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC;YACrE,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;gBACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,aAAa,MAAM,CAAC,CAAC;YAC3D,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,iBAAiB,CAAC,MAAM,UAAU,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,kBAAkB;QAClB,MAAM,SAAS,GAAkB,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAExE,SAAS;QACT,MAAM,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QAEpD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/src/application/use-cases/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 用例统一导出
+ */
+export * from './fetch-apifox-data.use-case.js';
+export * from './generate-mock.use-case.js';
+export * from './generate-types.use-case.js';
+export * from './serve-mock.use-case.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/application/use-cases/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/application/use-cases/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC"}

package/dist/src/application/use-cases/index.js

@@ -0,0 +1,8 @@
+/**
+ * 用例统一导出
+ */
+export * from './fetch-apifox-data.use-case.js';
+export * from './generate-mock.use-case.js';
+export * from './generate-types.use-case.js';
+export * from './serve-mock.use-case.js';
+//# sourceMappingURL=index.js.map

package/dist/src/application/use-cases/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/application/use-cases/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC"}

package/dist/src/application/use-cases/serve-mock.use-case.d.ts

@@ -0,0 +1,26 @@
+import type { ILogger } from '../../domain/interfaces.js';
+import type { ApifoxConfig } from '../../types/index.js';
+import type { MockConfig } from '../../core/mock-config-loader.js';
+/**
+ * 启动 Mock 服务器用例
+ * 负责启动 Mock 服务器并加载路由
+ *
+ * 注意：这里暂时直接使用 RouteManager 类，因为现有代码依赖具体类型
+ * Phase 4 中将重构服务器代码以使用接口
+ */
+export declare class ServeMockUseCase {
+    private readonly logger;
+    constructor(logger: ILogger);
+    /**
+     * 检查并清理端口占用
+     * @param port 端口号
+     */
+    checkAndCleanPort(port: number): Promise<void>;
+    /**
+     * 执行用例
+     * @param apifoxConfig Apifox 配置
+     * @param mockConfig Mock 配置
+     */
+    execute(apifoxConfig: ApifoxConfig, mockConfig: MockConfig): Promise<void>;
+}
+//# sourceMappingURL=serve-mock.use-case.d.ts.map

package/dist/src/application/use-cases/serve-mock.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-mock.use-case.d.ts","sourceRoot":"","sources":["../../../../src/application/use-cases/serve-mock.use-case.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAUnE;;;;;;GAMG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,OAAO;IAG5C;;;OAGG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCpD;;;;OAIG;IACG,OAAO,CACX,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,IAAI,CAAC;CA6CjB"}

package/dist/src/application/use-cases/serve-mock.use-case.js

@@ -0,0 +1,103 @@
+import { RouteManagerImpl } from '../../infrastructure/route-manager/route-manager.impl.js';
+import { loadMockRoutes } from '../../infrastructure/server/route-loader.js';
+import { setupMockServer } from '../../presentation/http/express-server.js';
+import { setupHotReload } from '../../infrastructure/server/hot-reload.js';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+/**
+ * 启动 Mock 服务器用例
+ * 负责启动 Mock 服务器并加载路由
+ *
+ * 注意：这里暂时直接使用 RouteManager 类，因为现有代码依赖具体类型
+ * Phase 4 中将重构服务器代码以使用接口
+ */
+export class ServeMockUseCase {
+    constructor(logger) {
+        this.logger = logger;
+    }
+    /**
+     * 检查并清理端口占用
+     * @param port 端口号
+     */
+    async checkAndCleanPort(port) {
+        try {
+            const { stdout } = await execAsync(`netstat -ano | findstr :${port}`);
+            if (stdout.trim()) {
+                this.logger.warn(`端口 ${port} 被占用，正在清理...`);
+                const lines = stdout.trim().split('\n');
+                const pids = new Set();
+                lines.forEach(line => {
+                    const parts = line.trim().split(/\s+/);
+                    if (parts.length >= 5) {
+                        const pid = parts[parts.length - 1];
+                        if (pid && pid !== '0') {
+                            pids.add(pid);
+                        }
+                    }
+                });
+                for (const pid of pids) {
+                    try {
+                        await execAsync(`taskkill /F /PID ${pid}`);
+                        this.logger.success(`✓ 已清理进程 ${pid}`);
+                    }
+                    catch (error) {
+                        this.logger.warn(`无法清理进程 ${pid}: ${error}`);
+                    }
+                }
+                // 等待端口释放
+                await new Promise(resolve => setTimeout(resolve, 1000));
+            }
+        }
+        catch (error) {
+            // 端口未被占用，这是正常情况
+        }
+    }
+    /**
+     * 执行用例
+     * @param apifoxConfig Apifox 配置
+     * @param mockConfig Mock 配置
+     */
+    async execute(apifoxConfig, mockConfig) {
+        // 检查并清理端口占用
+        await this.checkAndCleanPort(mockConfig.port);
+        this.logger.title('启动 Mock 服务器...');
+        // 初始加载所有 Mock 路由
+        const routes = await loadMockRoutes(apifoxConfig, mockConfig);
+        const routeManager = new RouteManagerImpl();
+        routes.forEach(route => {
+            const key = `${route.method} ${route.path}`;
+            routeManager.setRoute(key, route);
+        });
+        this.logger.success(`加载了 ${routes.length} 个 Mock 路由`);
+        // 创建并启动服务器
+        const app = setupMockServer(routeManager, mockConfig);
+        app.listen(mockConfig.port, 'localhost', () => {
+            this.logger.success(`\n🚀 Mock 服务器已启动！`);
+            this.logger.info(`   🌐 地址: http://localhost:${mockConfig.port}`);
+            this.logger.info(`   ⚙️  工作模式: ${mockConfig.model}`);
+            if (mockConfig.model === 'mock') {
+                // 纯 mock 模式：只在存在 proxyRoutes 时提示目标服务器
+                if (mockConfig.proxyRoutes?.length) {
+                    this.logger.info(`   🎯 目标服务器: ${mockConfig.target}`);
+                }
+                this.logger.info(`   📁 Mock 目录: ${apifoxConfig.mockDir}`);
+                this.logger.info(`   📊 已加载路由: ${routes.length} 个`);
+            }
+            else {
+                // 纯 proxy 模式：仅在存在 mockRoutes 时提示本地 Mock 目录和路由数
+                this.logger.info(`   🎯 目标服务器: ${mockConfig.target}`);
+                if (mockConfig.mockRoutes?.length) {
+                    this.logger.info(`   📁 Mock 目录: ${apifoxConfig.mockDir}`);
+                    this.logger.info(`   📊 已加载路由: ${routes.length} 个`);
+                }
+            }
+            this.logger.info('\n💡 提示:');
+            this.logger.info('  - 🔥 热重载已启用，修改 Mock 文件将自动生效');
+            this.logger.info('  - 🛑 按 Ctrl+C 停止服务器\n');
+            // 启动文件监听（热重载）
+            setupHotReload(apifoxConfig, routeManager, mockConfig);
+        });
+    }
+}
+//# sourceMappingURL=serve-mock.use-case.js.map

package/dist/src/application/use-cases/serve-mock.use-case.js.map

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

package/dist/src/core/apifox-client.d.ts

@@ -1,6 +1,10 @@
 import type { ApifoxConfig } from '../types/index.js';
+import type { OpenAPIDocument } from '../types/openapi.js';
 /**
  * 从 Apifox 拉取 OpenAPI 数据
+ *
+ * @deprecated 此函数已废弃，请使用 IApifoxClient 接口
+ * 此函数现在内部调用新的 ApifoxClientImpl 实现
  */
-export declare function fetchOpenAPIFromApifox(config: ApifoxConfig): Promise<any>;
+export declare function fetchOpenAPIFromApifox(config: ApifoxConfig): Promise<OpenAPIDocument>;
 //# sourceMappingURL=apifox-client.d.ts.map

package/dist/src/core/apifox-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apifox-client.d.ts","sourceRoot":"","sources":["../../../src/core/apifox-client.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,CAkC/E"}
+{"version":3,"file":"apifox-client.d.ts","sourceRoot":"","sources":["../../../src/core/apifox-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAK3D;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAI3F"}