TypeScript-first expansion pack for TanStack Query that gives you Protobuf superpowers.
This is the runtime library package for Connect-Query. You'll find its code generator at @connectrpc/protoc-gen-connect-query.
Connect-Query is a wrapper around TanStack Query (react-query), written in TypeScript and thoroughly tested. It enables effortless communication with servers that speak the Connect Protocol.
To get started, head over to the docs for a tutorial, or take a look at our examples.
@connectrpc/connect-query 共发布 32 个版本，首次发布于 2023/08/22；过去 12 个月发布了 1 个版本。最新版本附带 npm provenance 构建来源证明，可追溯到公开的 CI 构建记录。
| 版本 | 发布日期 | 距今 |
|---|---|---|
2.3.1latest | 2026/08/09 | 3 个月前 |
2.2.0 | 2025/09/10 | 1.2 年前 |
2.1.1 | 2025/07/10 | 1.3 年前 |
2.1.0 | 2025/05/23 | 1.5 年前 |
2.0.1 | 2024/12/14 | 1.9 年前 |
2.0.0 | 2024/11/20 | 2 年前 |
其他发布通道：beta → 2.0.0-beta.3，rc → 2.0.0-rc.3。
TypeScript-first expansion pack for TanStack Query that gives you Protobuf superpowers.
在项目目录运行 npm install @connectrpc/connect-query，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@bufbuild/protobuf（2.x）、@connectrpc/connect（^2.0.1）、@tanstack/react-query（>=5.62.0）、react（^18 || ^19）、react-dom（^18 || ^19）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。
支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
同时提供 ES Module 与 CommonJS 入口，import 和 require() 都可以使用，打包工具会自动选择合适的版本。
@connectrpc/connect-query 使用 Apache-2.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。
根据 npm 官方下载统计，@connectrpc/connect-query 在 2026/10/11 – 2026/11/09 这 30 天内被下载 2,245,473 次，日均约 74,849 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
最新版本 2.3.1 发布于 2026/08/09（3 个月前）；至今共发布 32 个版本，其中过去 12 个月发布了 1 个；首次发布于 2023/08/22。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。