SuperAPI AI 工具集

web-data-fetching-trpc

数据与分析

查看项目

更新于 10-15 19:52

技能介绍

用途:整理 tRPC 的类型安全 API 模式,覆盖路由与过程定义、输入校验、每请求上下文与中间件、错误码、类型化客户端桥接,以及订阅、文件输入和游标分页。

主要能力:通过 export type AppRouter = typeof appRouter 把服务端类型传给客户端,无需生成 schema;过程用 .input() 校验并推导处理函数参数类型;中间件可收窄上下文类型,使受保护过程的 ctx.user 非空;TRPCError 的 code 映射为 HTTP 状态;v11 中 transformer 移入 link,订阅为异步生成器,React 集成使用 @trpc/tanstack-react-query。

使用方式:用 initTRPC.context<Context>().create() 初始化并导出 router、publicProcedure、middleware;过程链式调用 .input() 与 .mutation()/.query();用 createTRPCContext 得到 useTRPC,过程提供 queryOptions()、mutationOptions()、infiniteQueryOptions() 和 queryKey() 供标准查询钩子使用。乐观更新需取消、快照、写入、失败回滚、完成后失效五步齐全。

适用场景:单一 TypeScript 代码库中的内部 API。

限制:不适用于面向第三方或非 TypeScript 消费者的公开 API;默认 POST 调用不利于 CDN 缓存;缓存策略、重试与失效语义由查询客户端决定;会话与令牌签发不在范围内。资料未提供具体版本要求、安装命令与价格信息。