首页
/ ORPC v0.47.0 发布:全面重构 OpenAPI 生成器与 Zod 集成

ORPC v0.47.0 发布:全面重构 OpenAPI 生成器与 Zod 集成

2025-06-25 07:25:46作者:尤辰城Agatha

ORPC(Open RPC)是一个现代化的 TypeScript RPC 框架,专注于提供类型安全的远程过程调用解决方案。它通过强大的类型系统和对 OpenAPI 规范的支持,简化了前后端协作的开发流程。

重大更新:OpenAPIGenerator 与 @orpc/zod 完全重构

本次 v0.47.0 版本带来了两项核心组件的彻底重构:

  1. OpenAPIGenerator 重写:这个组件负责将 ORPC 的类型系统转换为 OpenAPI 规范,现在实现了 95% 的测试覆盖率,显著提升了可靠性。同时,通过优化代码结构,其打包体积从原来的 25.4 kB (gzip) 大幅减少到 8.64 kB (gzip),性能也得到了明显改善。

  2. @orpc/zod 重写:这个 Zod 集成库现在提供了更健壮的类型转换能力,能够更好地处理各种复杂的数据结构定义,为开发者提供更流畅的类型安全体验。

类型系统增强

新版本引入了 InferRouterInitialContextsInferRouterCurrentContexts 两个实用类型,它们能够自动推断路由器的上下文类型。这一改进使得开发者在使用 ORPC 的类型系统时能够获得更精确的类型提示,减少了手动类型定义的需要。

查询功能优化

修复了一个关于突变(mutation)上下文推断的问题。现在,即使 onMutate 方法带有参数,系统也能正确推断出突变操作的上下文类型。这一改进特别有利于在使用 ORPC 的查询功能时保持类型安全。

需要注意的破坏性变更

  1. 客户端和服务端:简化了链接(link)和处理程序(handler)的配置选项,使得 API 更加简洁。开发者需要检查现有代码中相关选项的使用方式。

  2. 查询和 Vue 集成:更新了工具函数的选项配置,可能需要相应调整现有代码。

总结

ORPC v0.47.0 通过对核心组件的重构,显著提升了框架的稳定性、性能和开发体验。特别是 OpenAPI 生成器和 Zod 集成的重写,为开发者提供了更可靠、更高效的开发工具。虽然包含一些破坏性变更,但迁移成本相对较低,且带来的长期收益显著。

对于正在使用 ORPC 的团队,建议尽快升级到这个版本,以享受更优的类型安全支持和性能表现。在升级过程中,重点关注配置选项的变化,并利用 TypeScript 编译器来识别需要调整的代码部分。

登录后查看全文
热门项目推荐
相关项目推荐