ORPC v0.51.0 发布：增强插件系统与请求处理能力

ORPC 是一个现代化的 RPC 框架，专注于提供简洁高效的远程过程调用解决方案。最新发布的 v0.51.0 版本带来了多项重要改进，特别是在插件系统和请求处理方面有了显著增强。

重大变更

事件迭代器保活配置迁移

本次版本将事件迭代器的保活配置从 .handle 方法迁移到了处理器选项（handler options）中。这意味着开发者现在需要在创建处理器时就定义这些配置，而不是在每次处理请求时指定。这种改变使得配置更加集中化，提高了代码的可维护性。

内部 API 重命名

为了提供更清晰的 API 命名规范，v0.51.0 对多个内部 API 进行了重命名：

• HandlerPlugin → StandardHandlerPlugin
• ClientOptions → FriendlyClientOptions
• ClientOptionsOut → ClientOptions
• ClientPlugin → StandardLinkPlugin
• StandardHandleOptions → FriendlyStandardHandleOptions

这些变更虽然属于破坏性变更，但新的命名更加准确地反映了这些 API 的用途和功能，有助于开发者更好地理解和使用框架。

新特性

请求体大小限制插件

v0.51.0 引入了一个重要的安全特性——请求体大小限制插件（Body Limit Plugin）。这个插件可以帮助开发者防止潜在的拒绝服务攻击（DoS），通过限制请求体的大小来保护服务器资源。

使用示例：

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

这个插件可以有效地防止恶意用户发送超大请求体消耗服务器资源，是构建健壮应用的重要工具。

自动前缀检查

新版本简化了路由前缀检查的流程。开发者不再需要手动检查请求路径是否匹配指定的前缀，框架现在会自动处理这一逻辑。这使得代码更加简洁：

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 })
}

其他改进

插件上下文验证

框架现在会在插件缺少必要上下文时抛出错误，这有助于开发者更早地发现配置问题，避免运行时错误。

响应头插件修复

修复了响应头插件（ResponseHeadersPlugin）中存在的上下文引用问题，提高了插件的稳定性和可靠性。

总结

ORPC v0.51.0 通过引入请求体大小限制等安全特性，优化了内部 API 命名，并简化了前缀检查流程，进一步提升了框架的易用性和安全性。这些改进使得 ORPC 更加适合构建生产级的 RPC 服务，特别是对于那些需要高度可定制化和安全性的应用场景。