oRPC v0.28.0发布：端到端类型安全的错误处理机制

oRPC是一个现代化的RPC框架，专注于为TypeScript开发者提供类型安全的远程过程调用体验。在最新发布的v0.28.0版本中，oRPC引入了一个令人兴奋的新特性——端到端类型安全的错误处理机制，这极大地提升了开发者在处理API错误时的开发体验。

类型安全的错误处理

新版本的核心特性是引入了完全类型化的错误处理系统。开发者现在可以明确定义API可能抛出的各种错误类型及其数据结构，这些类型信息会在整个调用链中保持完整，从后端到前端都能获得完全的类型提示。

const createPost = os
  .errors({
    CONFLICT: {
      data: z.object({
        why: z.string(),
      }),
    },
  })
  .handler(({ errors }) => {
    throw errors.CONFLICT({ data: { why: 'some reason' } })
  })

在这个示例中，我们定义了一个createPost操作，它可能抛出CONFLICT错误，并且这个错误携带一个包含why字符串字段的数据对象。通过这种方式，错误类型和数据结构都被明确地定义和类型化。

客户端错误处理

在客户端，开发者可以方便地处理这些类型化的错误：

const [data, error] = await safe(createPost({ title: 'title' }))

if (error && isDefinedError(error)) {
  const data = error.data // 类型安全地访问错误数据
}

对于使用React Query的开发者，错误处理也同样简单：

const mutation = useMutation(orpc.createPost.mutationOptions({
  onError(error) {
    if (isDefinedError(error)) {
      const data = error.data // 类型安全地访问错误数据
    }
  },
}))

架构调整

为了简化维护和提升稳定性，v0.28.0版本做出了一些架构调整：

1. 移除了@orpc/react包，因为它的维护复杂度较高，而@orpc/react-query提供了更简单且功能相同的解决方案。

2. 暂时移除了@orpc/next包，这是由于Next.js中存在一些意外行为导致的。开发团队正在与Next.js团队合作解决这些问题，计划在未来的oRPC版本中重新引入这个包。

技术价值

这个版本的更新为开发者带来了几个重要的技术优势：

1. 更好的开发体验：类型安全的错误处理减少了运行时错误，IDE可以提供更好的代码补全和类型检查。

2. 更健壮的代码：明确定义的错误类型使开发者能够更全面地处理各种错误场景。

3. 前后端一致性：错误类型和数据结构的定义在后端和前端保持一致，减少了沟通成本和潜在的错误。

4. 简化维护：通过移除复杂度高的包，框架变得更加精简和易于维护。

oRPC v0.28.0的这些改进展示了团队对开发者体验和代码质量的持续关注，为构建更可靠、更易维护的应用程序提供了坚实的基础。