ORPC v1.0.0-beta.2 发布：客户端重试机制与OpenAPI规范生成优化

ORPC（Open RPC）是一个现代化的RPC框架，旨在简化远程过程调用的开发体验。它提供了类型安全、高性能和可扩展的RPC解决方案，特别适合构建复杂的分布式系统。本次发布的v1.0.0-beta.2版本带来了两项重要改进：全新的客户端重试机制和对Valibot、ArkType的OpenAPI规范生成支持。

客户端重试机制重构

在分布式系统中，网络不稳定和服务暂时不可用是常见问题。ORPC v1.0.0-beta.2对重试机制进行了重要重构，将原先内置于RPCLink中的事件迭代器重试逻辑移除，取而代之的是一个更加灵活和强大的客户端重试插件。

新重试插件特性

新的客户端重试插件提供了细粒度的控制能力：

1. 可配置重试次数：开发者可以精确设置最大重试次数
2. 自定义重试延迟：支持设置每次重试之间的延迟时间
3. 智能重试决策：通过shouldRetry回调函数，开发者可以根据错误类型决定是否重试
4. 重试生命周期钩子：onRetry回调函数让开发者能够在每次重试时执行自定义逻辑

const planets = await client.planet.list({ limit: 10 }, {
  context: {
    retry: 3, // 最大重试次数
    retryDelay: 2000, // 重试间隔(毫秒)
    shouldRetry: options => true, // 基于错误决定是否重试
    onRetry: (options) => {}, // 每次重试时执行的回调
  }
})

这种设计使得重试逻辑更加透明和可控，同时也更容易在不同调用间共享和复用重试策略。

OpenAPI规范生成增强

ORPC一直致力于提供优秀的API文档生成体验。在v1.0.0-beta.2中，框架扩展了对流行验证库的支持，现在除了Zod外，还可以直接使用Valibot和ArkType来生成OpenAPI规范。

多验证库支持

开发者现在可以同时配置多个验证库转换器：

import { OpenAPIGenerator } from '@orpc/openapi'
import { ZodToJsonSchemaConverter } from '@orpc/zod'
import { experimental_ValibotToJsonSchemaConverter } from '@orpc/valibot'
import { experimental_ArkTypeToJsonSchemaConverter } from '@orpc/arktype'

const openAPIGenerator = new OpenAPIGenerator({
  schemaConverters: [
    new ZodToJsonSchemaConverter(), // Zod支持
    new ValibotToJsonSchemaConverter(), // Valibot支持
    new ArkTypeToJsonSchemaConverter(), // ArkType支持
  ],
})

这种设计使得团队可以根据技术栈偏好选择验证库，而不用担心API文档生成的兼容性问题。特别是对于已经在使用Valibot或ArkType的项目，现在可以无缝集成ORPC的OpenAPI生成功能。

升级建议

对于正在使用ORPC的项目，升级到v1.0.0-beta.2需要注意以下几点：

1. 如果项目中使用到了RPCLink的事件迭代器重试功能，需要迁移到新的客户端重试插件
2. 对于使用Valibot或ArkType的项目，现在可以移除自定义的转换逻辑，直接使用官方提供的转换器
3. 建议在测试环境中充分验证新的重试机制是否符合业务需求

ORPC v1.0.0-beta.2的这些改进进一步巩固了其作为现代化RPC框架的地位，特别是在类型安全和开发者体验方面。随着框架向1.0正式版迈进，我们可以期待更多稳定性和功能性的提升。