⚡一键生成，全栈贯通 - Fetcher v2.3.0 发布！
🚀 Fetcher 超轻量级 • 模块化 • TypeScript 优先 • 拦截器驱动 • LLM 流式 API 支持 Fetcher v2.3.0 发布日志 🎊激动人心的时刻到了！Fetcher v2.3.0 正式发布！这个版本带来了革命性的代码生成器和一系列强大的新特性，让您的开发体验更加流畅高效！ ✨ 重磅新功能 🚀全新代码生成器（Generator） 🎯 OpenAPI 3.0+ 支持：完整支持 OpenAPI 3.0+ 规范（JSON/YAML） 📦 TypeScript 代码生成：生成类型安全的 TypeScript 接口、枚举和类 🏗️ 领域驱动设计：专为Wow框架打造，支持聚合、命令、查询和领域事件 🔧 CLI 工具：易用的命令行界面，用于代码生成 🎨 装饰器式 API：生成装饰器式的客户端类，实现清晰的 API 交互 📋 全面的模型：处理复杂的模式，包括联合、交集、枚举和引用 🚀 Fetcher 生态集成：无缝集成 Fetcher 生态系统包 📊 进度日志：生成过程中的友好日志记录和进度指示器 📁 自动索引生成：自动生成 index.ts 文件，实现清晰的模块组织 🌐 远程规范支持：直接从 HTTP/HTTPS URL 加载 OpenAPI 规范 🎭 事件流：生成常规和事件流命令客户端 📖 生成器使用示例 从本地 OpenAPI 规范生成代码 fetcher-generator generate -i ./api-spec.json -o ./src/generated 从远程规范生成代码 fetcher-generator generate -i https://api.example.com/openapi.json -o ./src/generated 生成的代码结构： output/ ├── {bounded-context}/ │ ├── index.ts # 自动生成的索引文件，导出所有聚合 │ ├── boundedContext.ts # 有界上下文别名常量 │ ├── types.ts # 有界上下文的共享类型 │ └── {aggregate}/ # 聚合特定文件 │ ├── index.ts # 聚合的自动生成索引文件 │ ├── types.ts # 聚合特定类型、模型和枚举 │ ├── queryClient.ts # 查询客户端工厂，用于状态和事件查询 │ └── commandClient.ts # 命令客户端类（常规和流式） ├── index.ts # 根索引文件，导出所有有界上下文 └── tsconfig.json # 生成代码的 TypeScript 配置 🔥OpenAPI 全面增强 全新 OpenAPI 包：独立的 OpenAPI 规范支持包 扩展支持：OpenAPI 规范接口现在支持扩展功能 类型优化：SchemaType 新增 'null' 类型支持，字段可选性优化 💪装饰器（Decorator）全面升级 生命周期钩子：为 API 服务添加完整的生命周期钩子支持 参数装饰器增强：支持对象展开功能，简化参数处理 元数据管理：新增 API 元数据和请求执行器能力 类型安全：端点返回类型能力增强，提升开发体验 🎯查询系统重大改进 泛型类型支持：Condition 接口和查询接口全面支持泛型类型参数 领域事件流增强：新增状态和操作符能力，支持更复杂的数据处理 类型安全查询：事件流查询的类型安全性大幅提升 🔧核心功能优化 TRACE 方法支持：HTTP TRACE 方法现在得到完整支持 命令系统增强：新增批处理结果接口和等待信号机制 类型定义完善：新增 MessageHeaderSqlType 枚举和 WowMetadata 接口 📚 文档与工具 🎨代码质量提升 统一代码风格：ESLint 和 Prettier 自动化代码格式化 测试优化：使用 MSW 替换模拟 fetch，提升测试可靠性 ⚡ 性能与稳定性 依赖更新：所有工作区依赖更新至最新版本 Docker 支持：Wow 示例服务器更新至 v6.1.12 MongoDB 支持：MongoDB 客户端更新至 v8.0.14 🎉 破坏性变更 移除过时功能：废弃的@attributes参数装饰器已被移除 类型重命名：PathParams重命名为UrlPathParams，提升语义清晰度 架构优化：查询客户端迁移至 fetcher-decorator，架构更加统一 🚀 开始使用 这次更新为 Fetcher 生态系统带来了前所未有的开发体验！无论是全新的代码生成器，还是全面增强的类型系统，都将显著提升您的开发效率。 立即升级到 v2.3.0，体验下一代 API 开发工具的强大功能！ 🌟 为什么选择 Fetcher? Fetcher 不仅仅是一个 HTTP 客户端——它是一个为现代 Web 开发设计的完整生态系统，原生支持 LLM 流式 API。基于原生 Fetch API 构建，Fetcher 提供了类似 Axios 的体验，同时保持极小的体积。 🚀 核心特性 🎯@ahoo-wang/fetcher- 基础核心 轻量级核心，驱动整个生态系统： ⚡ 超轻量级: 仅 3KiB min+gzip - 比大多数替代品更小 🧭 路径和查询参数: 内置支持路径 ({id}/:id) 和查询参数 🔗 拦截器系统: 请求、响应和错误拦截器，支持有序执行的灵活中间件模式 ⏱️ 超时控制: 可配置的请求超时和适当的错误处理 🔄 Fetch API 兼容: 完全兼容原生 Fetch API 🛡️ TypeScript 支持: 完整的 TypeScript 定义，实现类型安全开发 🧩 模块化架构: 轻量级核心和可选扩展包 📦 命名 Fetcher 支持: 自动注册和检索 fetcher 实例 ⚙️ 默认 Fetcher: 预配置的默认 fetcher 实例，快速上手 🎨@ahoo-wang/fetcher-decorator- 声明式 API 使用简洁的声明式服务定义转换您的 API 交互： 🎨 清晰的 API 定义: 使用直观的装饰器定义 HTTP 服务 🧭 自动参数绑定: 路径、查询、头部和正文参数自动绑定 ⏱️ 可配置超时: 每方法和每类的超时设置 🔗 Fetcher 集成: 与 Fetcher 的命名 fetcher 系统无缝集成 ⚡ 自动实现: 方法自动实现 HTTP 调用 📦 元数据系统: 丰富的元数据支持，用于高级自定义 📡@ahoo-wang/fetcher-eventstream- 实时流和 LLM 支持 为您的实时应用提供 Server-Sent Events 支持，专为大型语言模型流式 API 设计： 📡 事件流转换：将text/event-stream响应转换为ServerSentEvent对象的异步生成器 🔌 自动扩展：模块导入时自动扩展Response原型，添加事件流方法 📋 SSE 解析：根据规范解析服务器发送事件，包括数据、事件、ID 和重试字段 🔄 流支持：正确处理分块数据和多行事件 💬 注释处理：正确忽略注释行（以:开头的行） 🛡️ TypeScript 支持：完整的 TypeScript 类型定义 ⚡ 性能优化：高效的解析和流处理，适用于高性能应用 🤖 LLM 流准备就绪: 原生支持来自流行 LLM API（如 OpenAI GPT、Claude 等）的流式响应 LLM 集成示例 LlmClient演示了如何创建具有流支持的 LLM API 专用客户端： import { createLlmFetcher, LlmClient } from './llmClient'; // 使用您的 API 配置初始化 LLM 客户端 const llmFetcher = createLlmFetcher({ baseURL: 'https://api.openai.com/v1', apiKey: process.env.OPENAI_API_KEY || 'your-api-key', model: 'gpt-3.5-turbo', }); const llmClient = new LlmClient(); // 流式聊天完成，逐个令牌输出 async function streamChatExample() { const stream = await llmClient.streamChat({ messages: [ { role: 'system', content: 'You are a helpful assistant.' }, { role: 'user', content: 'Explain quantum computing in simple terms.' }, ], stream: true, }); for await (const event of stream) { if (event.data) { const chunk = event.data; const content = chunk.choices[0]?.delta?.content || ''; process.stdout.write(content); // 实时输出 } } } 🔧@ahoo-wang/fetcher-generator- OpenAPI 代码生成器 从 OpenAPI 规范生成 TypeScript 代码，专为 WOW 领域驱动设计框架打造： 🎯 OpenAPI 3.0+ 支持：完整支持 OpenAPI 3.0+ 规范（JSON/YAML） 📦 TypeScript 代码生成：生成类型安全的 TypeScript 接口、枚举和类 🏗️ 领域驱动设计：专为 WOW 框架打造，支持聚合、命令、查询和领域事件 🔧 CLI 工具：易用的命令行界面，用于代码生成 🎨 装饰器式 API：生成装饰器式的客户端类，实现清晰的 API 交互 📋 全面的模型：处理复杂的模式，包括联合、交集、枚举和引用 🚀 Fetcher 生态集成：无缝集成 Fetcher 生态系统包 📊 进度日志：生成过程中的友好日志记录和进度指示器 📁 自动索引生成：自动生成 index.ts 文件，实现清晰的模块组织 🌐 远程规范支持：直接从 HTTP/HTTPS URL 加载 OpenAPI 规范 🎭 事件流：生成常规和事件流命令客户端 💾@ahoo-wang/fetcher-storage- 跨环境存储 轻量级跨环境存储库，具有变更事件监听功能： 🌐 跨环境支持：为浏览器 localStorage/sessionStorage 和内存存储提供一致的 API 📦 超轻量级：仅 ~1KB gzip - 最小化占用空间 🔔 存储变更事件：通过事件驱动架构监听存储变更 🔄 自动环境检测：自动选择合适的存储实现 🛠️ 基于键的存储：高效的基于键的存储，内置缓存 🔧 自定义序列化：支持自定义序列化策略 📝 TypeScript 支持：完整的 TypeScript 定义，实现类型安全的存储操作 🧩@ahoo-wang/fetcher-wow- CQRS/DDD 框架支持 与WowCQRS/DDD 框架的一流集成： 📦 完整的 TypeScript 支持：为所有 Wow 框架实体提供完整的类型定义，包括命令、事件和查询 🚀 命令客户端：用于向 Wow 服务发送命令的高级客户端，支持同步和流式响应 🔍 强大的查询 DSL：丰富的查询条件构建器，支持全面的操作符用于复杂查询 📡 实时事件流：内置对服务器发送事件的支持，用于接收实时命令结果和数据更新 🔄 CQRS 模式实现：对命令查询责任分离架构模式的一流支持 🧱 DDD 基础构件：基本的领域驱动设计构建块，包括聚合、事件和值对象 🔍 查询客户端：专门用于查询快照和事件流数据的客户端，支持全面的查询操作： 资源计数 资源列表查询 以服务器发送事件形式流式传输资源 资源分页 单个资源检索 🔐@ahoo-wang/fetcher-cosec- 企业安全 使用集成认证保护您的应用： 🔐 自动认证: 自动 CoSec 认证头部 📱 设备管理: 使用 localStorage 持久化的设备 ID 管理 🔄 令牌刷新: 基于响应代码 (401) 的自动令牌刷新 🌈 请求跟踪: 用于跟踪的唯一请求 ID 生成 💾 令牌存储: 安全的令牌存储管理 📦 包生态系统 包 描述 版本 大小 @ahoo-wang/fetcher 核心 HTTP 客户端 具有 Axios 类似 API 的超轻量级基础 @ahoo-wang/fetcher-decorator 装饰器支持 声明式 API 服务定义 @ahoo-wang/fetcher-eventstream 实时流和 LLM 支持 Server-Sent Events (SSE) 支持，原生 LLM 流式 API 集成 @ahoo-wang/fetcher-generator OpenAPI 代码生成器 从 OpenAPI 规范生成 TypeScript 代码，专为 WOW 领域驱动设计框架打造 @ahoo-wang/fetcher-openapi OpenAPI TypeScript 类型 OpenAPI 3.0+ 规范的完整 TypeScript 类型定义 @ahoo-wang/fetcher-storage 跨环境存储 轻量级存储库，具有浏览器和 Node.js 的变更事件监听功能 @ahoo-wang/fetcher-react React 集成 React hooks 和组件，实现无缝数据获取和自动重新渲染 @ahoo-wang/fetcher-wow CQRS/DDD 框架支持 与 Wow CQRS/DDD 框架的一流集成 @ahoo-wang/fetcher-cosec 企业安全 CoSec 认证集成 🚀 快速开始 📦 安装 # 安装核心包 npm install @ahoo-wang/fetcher # 或安装所有扩展，包括 LLM 流支持 npm install @ahoo-wang/fetcher @ahoo-wang/fetcher-decorator @ahoo-wang/fetcher-eventstream @ahoo-wang/fetcher-cosec # 使用 pnpm (推荐) pnpm add @ahoo-wang/fetcher # 使用 yarn yarn add @ahoo-wang/fetcher ⚡ 快速示例 基础 HTTP 客户端 import { Fetcher } from '@ahoo-wang/fetcher'; // 创建 fetcher 实例 const fetcher = new Fetcher({ baseURL: 'https://api.example.com', timeout: 5000, }); // 带路径和查询参数的 GET 请求 const response = await fetcher.get('/users/{id}', { urlParams: { path: { id: 123 }, query: { include: 'profile' }, }, }); const userData = await response.json<User>(); // 自动 JSON 转换的 POST 请求 const createUserResponse = await fetcher.post('/users', { body: { name: 'John Doe', email: 'john@example.com' }, }); 声明式 API 服务 import { NamedFetcher } from '@ahoo-wang/fetcher'; import { api, get, post, path, query, body, } from '@ahoo-wang/fetcher-decorator'; // 注册命名 fetcher const apiFetcher = new NamedFetcher('api', { baseURL: 'https://api.example.com', }); // 使用装饰器定义服务 @api('/users', { fetcher: 'api' }) class UserService { @get('/') getUsers(@query('limit') limit?: number): Promise<User[]> { throw autoGeneratedError(limit); } @post('/') createUser(@body() user: User): Promise<User> { throw autoGeneratedError(user); } @get('/{id}') getUser(@path('id') id: number): Promise<User> { throw autoGeneratedError(id); } } // 使用服务 const userService = new UserService(); const users = await userService.getUsers(10); 强大的拦截器 import { Fetcher } from '@ahoo-wang/fetcher'; const fetcher = new Fetcher({ baseURL: 'https://api.example.com' }); // 添加带排序的请求拦截器 fetcher.interceptors.request.use({ name: 'auth-interceptor', order: 100, intercept(exchange) { exchange.request.headers.Authorization = 'Bearer ' + getAuthToken(); }, }); // 添加响应拦截器用于日志记录 fetcher.interceptors.response.use({ name: 'logging-interceptor', order: 10, intercept(exchange) { console.log('Response:', exchange.response.status); }, }); 实时流和 LLM 支持 import { Fetcher } from '@ahoo-wang/fetcher'; import { EventStreamInterceptor } from '@ahoo-wang/fetcher-eventstream'; const fetcher = new Fetcher({ baseURL: 'https://api.example.com' }); fetcher.interceptors.response.use(new EventStreamInterceptor()); // 流式实时事件 (通用 SSE) const response = await fetcher.get('/events'); if (response.eventStream) { for await (const event of response.eventStream()) { console.log('Real-time event:', event); } } // 流式 LLM 响应，逐个令牌输出 const llmResponse = await fetcher.post('/chat/completions', { body: { model: 'gpt-3.5-turbo', messages: [{ role: 'user', content: 'Hello!' }], stream: true, }, }); if (llmResponse.jsonEventStream) { // 专门用于 LLM API 的 JSON SSE 事件 for await (const event of llmResponse.jsonEventStream<ChatCompletionChunk>()) { const content = event.data.choices[0]?.delta?.content || ''; process.stdout.write(content); // 实时令牌输出 } } 🎯 集成测试示例 在我们的integration-test目录中探索全面、可用于生产的实现： 🌐 HTTP 操作 Typicode API 集成- 与 JSONPlaceholder API 的完整集成，演示实际使用 参数处理- 高级路径、查询和正文参数管理 错误处理- 全面的错误处理模式 🔧 高级模式 COSEC 认证- 具有令牌管理的企业级安全集成 拦截器链- 具有有序执行的复杂中间件模式 超时策略- 自适应超时配置 📡 实时特性 LLM 流式 API- 原生支持从大型语言模型流式响应 Server-Sent Events- 实时通知和更新 流数据- 具有自动重新连接的连续数据流 🎨 装饰器模式 声明式服务- 使用 TypeScript 装饰器的清晰、可维护的 API 服务层 元数据扩展- 用于高级用例的自定义元数据 类型安全 API- 完整的 TypeScript 集成和自动类型推断 🏗️ 开发和贡献 🛠️ 先决条件 Node.js >= 16 pnpm >= 8 🚀 开发命令 # 安装依赖 pnpm install # 构建所有包 pnpm build # 运行单元测试和覆盖率 pnpm test:unit # 格式化代码 pnpm format # 清理构建产物 pnpm clean # 运行集成测试 #pnpm test:it 📦 版本管理 同时更新所有包： pnpm update-version <new-version> 这会更新单体仓库中所有package.json文件的版本字段。 🤝 贡献 欢迎贡献！请查看我们的贡献指南获取详情： Fork 仓库 创建您的功能分支 (git checkout -b feature/AmazingFeature) 提交您的更改 (git commit -m 'Add some AmazingFeature') 推送到分支 (git push origin feature/AmazingFeature) 打开拉取请求 🧪 质量保证 代码覆盖率: 所有包保持在 95% 以上 TypeScript: 启用严格类型检查 代码检查: 使用 Prettier 的 ESLint 保证一致的代码风格 测试: 全面的单元和集成测试
