@btravstack/pothos

中文文档
0.58.0发布于 2026/11/08MITTypeScriptES Module零依赖构建来源已验证近 30 天下载 6633

Pothos 字段将 OLPC 程序调用, 每个已声明错误作为输入的 GraphQL 拒绝回答

中文使用文档

@btravstack/pothos (英语)

波索斯语Name 调用字段 oRPC 缩写: 程序,用于图形QL网关 合同第一服务。 默认导出是插件, 列在 @unthrown/pothos': plugins: [RelayPlugin, ErrorsPlugin, UnthrownPlugin, OrpcPlugin]。 。 。 .

  • t.procedureField(procedure, { type, call, input, output, refusals? }) 验证 字段在调用前通过程序本身的合同输入, 解码答案 output,并回答每个错误的程序 声明为其代码注册的 GraphQL 错误类 现场的结果结合。 外地-当地 refusals 覆盖建构器 共享 orpc: { refusals } 默认值。 地图必须覆盖每一个 错误 call 可返回并 InvalidInput; 缺少代码不编译. 由狭义处理的已声明错误 call 不需要输入 .
  • t.procedureConnection(procedure, { …, connection }) 对一个 中继连接, 已解码的页面折叠由 connection。 。 。 .
  • UNAUTHORIZED 财务报告和审定财务报表 FORBIDDEN 解答为 GraphQL 自己的错误, 以 extensions.code无论程序是否宣布.
  • loadProcedure 财务报告和审定财务报表 procedureErrors 通过一个 数据记录器; contractCall, (中文(简体) ), contractInput 财务报告和审定财务报表 contractOutput 这是 单干一半.

每个依赖都是对等点: Pothos 插件和 graphql 每个人需要一份副本. 安装 @btravstack/contract 与他们一起; contractInput 重新使用该物质 /orpc 输入-schema访问器.

pnpm add @btravstack/pothos @btravstack/contract @pothos/core @pothos/plugin-errors @pothos/plugin-relay \
  @unthrown/pothos@^0.1.2 graphql unthrown zod \
  @orpc/[email protected] @orpc/[email protected]

见 从 ORPC 程序中解析图QL 字段。 。 。 .

版本与发布记录

@btravstack/pothos 共发布 39 个版本,首次发布于 2026/10/11;过去 12 个月发布了 39 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.58.0latest2026/11/08今天
0.57.02026/11/071 天前
0.56.12026/11/062 天前
0.56.02026/11/062 天前
0.55.12026/11/035 天前
0.55.02026/11/035 天前

关于 @btravstack/pothos 的常见问题

@btravstack/pothos 是什么?

Pothos 字段将 OLPC 程序调用, 每个已声明错误作为输入的 GraphQL 拒绝回答

如何安装 @btravstack/pothos?

在项目目录运行 npm install @btravstack/pothos,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:zod(^4.3.0)、graphql(^16.10.0 || ^17.0.0)、unthrown(^5.12.1)、@orpc/client(^2.0.0-beta.28)、@pothos/core(^4.15.0)、@orpc/contract(^2.0.0-beta.28)、@unthrown/pothos(^0.1.2)、@btravstack/contract(^0.58.0)、@pothos/plugin-relay(^4.8.0)、@pothos/plugin-errors(^4.9.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@btravstack/pothos 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@btravstack/pothos 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@btravstack/pothos 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@btravstack/pothos 可以商用吗?

@btravstack/pothos 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@btravstack/pothos 的下载量有多少?

根据 npm 官方下载统计,@btravstack/pothos 在 2026/10/09 – 2026/11/07 这 30 天内被下载 6,633 次,日均约 221 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@btravstack/pothos 还在维护吗?

最新版本 0.58.0 发布于 2026/11/08(今天);至今共发布 39 个版本,其中过去 12 个月发布了 39 个;首次发布于 2026/10/11。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。