ORPC v1.0.0-beta.4 版本发布：重大变更与新特性解析

ORPC（Object Remote Procedure Call）是一个现代化的远程过程调用框架，它通过简洁的API设计和强大的插件系统，为开发者提供了构建高效RPC服务的工具。本次发布的v1.0.0-beta.4版本带来了一些重要的架构调整和新功能，值得开发者关注。

架构重构：更合理的API设计

本次版本对内部API进行了大规模的重命名和结构调整，这是框架走向成熟的重要一步。这些变更包括：

• 将HandlerPlugin重命名为StandardHandlerPlugin，更准确地反映了其作为标准处理器插件的角色
• 客户端相关配置从ClientOptions调整为FriendlyClientOptions，同时将内部使用的ClientOptionsOut简化为ClientOptions
• 将ClientPlugin更名为StandardLinkPlugin，更好地描述了其在连接建立中的作用
• 处理选项StandardHandleOptions更名为FriendlyStandardHandleOptions

这些命名上的调整虽然带来了破坏性变更，但使得API的语义更加清晰，长期来看将提升代码的可读性和维护性。

事件迭代器保活机制优化

框架对事件迭代器的保活机制进行了重要改进，将相关配置从.handle方法移动到了处理器选项（handler options）中。这意味着开发者现在需要在创建处理器时定义这些配置，而不是在每次调用处理时指定。

这种调整带来了几个优势：

1. 配置更加集中，减少了重复代码
2. 提高了运行时效率，避免了每次处理请求时的配置解析
3. 使API设计更加一致，符合"配置在创建时完成"的最佳实践

新增请求体限制插件

v1.0.0-beta.4引入了一个重要的安全特性——Body Limit Plugin（请求体限制插件）。这个插件允许开发者限制请求体的大小，防止恶意用户发送过大的请求导致服务资源耗尽。

使用示例：

const handler = new RPCHandler(router, {
  plugins: [
    new BodyLimitPlugin({
      maxBodySize: 1024 * 1024, // 限制为1MB
    }),
  ],
})

这个插件特别适合在公共API服务中使用，可以有效防止DoS攻击。开发者可以根据实际需求调整maxBodySize参数，平衡安全性和功能性。

路由前缀处理简化

新版本简化了路由前缀的处理逻辑。开发者不再需要手动检查URL路径是否匹配前缀，框架会自动处理这一逻辑。这使得代码更加简洁，减少了样板代码。

改进后的处理流程更加直观：

export async function fetch(request: Request): Promise<Response> {
  const { response } = await handler.handle(request, {
    prefix: '/rpc',
    context: {} // 初始上下文
  })

  if (response) return response

  return new Response('Not found', { status: 404 })
}

这种改进不仅减少了代码量，还降低了出错的可能性，使开发者能够更专注于业务逻辑的实现。

升级建议

对于正在使用ORPC的开发者，升级到v1.0.0-beta.4版本需要注意以下几点：

1. 检查所有使用了事件迭代器保活机制的代码，将相关配置迁移到处理器选项中
2. 更新所有引用重命名API的代码
3. 考虑在安全敏感的应用中添加Body Limit Plugin
4. 简化路由前缀处理逻辑，移除手动检查前缀的代码

虽然这些变更带来了一定的迁移成本，但它们使框架更加健壮和易用。对于新项目，建议直接采用这个版本开始开发，以利用最新的改进和优化。