Hey API Client Fetch 0.6.0 版本发布：认证与响应处理优化

Hey API 是一个专注于 TypeScript 和 OpenAPI 规范的工具链项目，其核心目标是为开发者提供高效、类型安全的 API 客户端生成方案。本次发布的 @hey-api/client-fetch@0.6.0 版本带来了两项重要的改进，主要涉及认证机制和响应处理逻辑的优化。

认证机制重构：统一 auth 接口

新版本对认证系统进行了重大重构，将原先分散的 accessToken 和 apiKey 方法整合为一个统一的 auth 函数。这种设计变更体现了现代 API 认证的发展趋势，特别是对于支持多种认证机制的 API 服务而言。

变更细节

旧版代码中，开发者需要分别设置不同的认证方法：

client.setConfig({
  accessToken: () => '<my_token>',
  apiKey: () => '<my_token>',
});

在新版本中，这些方法被统一为单一的 auth 函数：

client.setConfig({
  auth: (auth) => '<my_token>',
});

技术优势

这种设计改进带来了几个显著优势：

1. 简化接口：减少了开发者需要记忆的配置项数量，降低了学习成本
2. 灵活性增强：通过 auth 参数可以动态判断当前请求所需的认证方式
3. 类型安全：TypeScript 类型系统能够更好地推断和验证认证参数
4. 一致性：统一了不同认证机制的处理方式，减少了代码分支

迁移建议

对于现有项目，升级时需要：

1. 检查所有使用 accessToken 和 apiKey 的地方
2. 将它们替换为统一的 auth 函数
3. 确保同时更新 @hey-api/openapi-ts 到最新版本

响应处理优化：原始流数据支持

另一个重要改进是对响应体的处理逻辑进行了优化，特别是当响应头中缺少 Content-Type 时的处理方式。

变更细节

当以下条件同时满足时：

• 响应头中未提供 Content-Type
• parseAs 选项设置为 auto

客户端现在会直接返回原始的 ReadableStream 响应体，而不是尝试进行解析。这种改变更符合 HTTP 协议的实际应用场景，特别是处理二进制数据或自定义数据格式时。

技术优势

这一改进带来了以下好处：

1. 更精确的数据处理：避免了在无法确定内容类型时的强制解析
2. 性能优化：对于不需要解析的二进制数据，减少了不必要的处理开销
3. 灵活性：开发者可以更灵活地处理特殊格式的响应数据
4. 错误减少：消除了因错误猜测内容类型导致的解析异常

实际应用场景

这种改进特别适用于以下情况：

• 处理自定义二进制协议
• 接收服务器推送的事件流
• 处理未明确指定类型但格式已知的数据
• 需要直接操作底层数据流的特殊场景

总结与升级建议

Hey API Client Fetch 0.6.0 版本的这两项改进，体现了项目对开发者体验和实际应用场景的深入思考。认证系统的统一简化了配置，而响应处理的优化则提供了更大的灵活性。

对于计划升级的项目，建议：

1. 完整阅读变更说明，理解破坏性变更的影响
2. 在测试环境中先行验证
3. 特别注意认证逻辑的修改
4. 检查是否有依赖未指定内容类型的响应处理

这些改进使得 Hey API 在构建现代化、类型安全的 API 客户端方面又向前迈进了一步，为开发者提供了更强大、更灵活的工具集。