HeyAPI OpenAPI-TS 0.69.1版本发布：Valibot日期处理与类型生成优化

OpenAPI-TS是一个强大的TypeScript工具库，专门用于处理OpenAPI规范。它能够将OpenAPI文档转换为类型安全的TypeScript代码，为开发者提供更好的开发体验和类型安全保障。最新发布的0.69.1版本带来了几项重要改进，特别是在Valibot日期处理和复杂类型生成方面。

Valibot日期字符串处理优化

在0.69.1版本中，团队修复了Valibot模式下日期字符串的处理方式。原先使用的是date验证器，现在改为使用isoDate验证器。这一变更带来了几个显著优势：

1. 更严格的格式验证：isoDate会强制验证ISO 8601格式的日期字符串，确保数据的规范性
2. 更好的类型安全：使用标准格式可以减少前后端交互中的日期解析问题
3. 一致性提升：与大多数现代API设计规范保持一致，使用ISO格式作为日期交换标准

复杂类型生成改进

新版本对嵌套oneOf结构的数组类型生成进行了优化。当OpenAPI规范中定义了包含嵌套oneOf结构的数组时，现在能够正确生成联合类型的数组定义。例如：

// 之前可能生成的类型
type MyArray = Array<TypeA> | Array<TypeB>;

// 现在生成的更精确类型
type MyArray = (TypeA | TypeB)[];

这种改进使得生成的类型更加精确和实用，特别是在处理复杂数据结构时，能够提供更好的类型提示和编译时检查。

构建器功能增强

0.69.1版本还对名称构建器功能进行了两项重要改进：

1. 字符串支持：现在nameBuilder配置项不仅支持函数，也可以直接使用字符串，简化了简单场景下的配置
2. 服务名称构建器：serviceNameBuilder现在明确支持函数类型，为自定义服务命名提供了更大的灵活性

这些改进使得配置更加灵活，既支持简单场景的快速配置，也支持复杂场景的高度定制。

实际应用价值

这些改进虽然看似细微，但在实际开发中能带来显著效益：

1. 减少运行时错误：更严格的日期验证可以提前捕获格式问题
2. 提升开发效率：更精确的类型定义意味着更好的IDE自动补全和类型检查
3. 降低维护成本：灵活的配置选项使得项目更容易适应不同的命名规范和架构要求

对于正在使用OpenAPI-TS的团队，建议尽快升级到0.69.1版本以利用这些改进。特别是那些处理大量日期字段或复杂数据结构的项目，这些优化将显著提升开发体验和代码质量。