feat(contract)!: replace contract caller with contract client factory

[dinwwwh]

createContractCaller is now createContractClientFactory: instead of calling a procedure directly, it returns a client for the passed contract — and it accepts router contracts too. Same for createContractJsonifiedCaller → createContractJsonifiedClientFactory in @orpc/openapi.

export const createClient = createContractClientFactory(link, { /** options */ })

const client = createClient(procedure)
const output = await client(input)

// router contracts (including sub-routers) work too
const users = createClient(usersRouter)
const output = await users.list(input)

• Paths resolve as a base path (derived from the first procedure defining meta.path) + the router shape, so sub-routers of the root contract work
• contractRef registers every procedure inside the passed contract at its resolved path
• createContractUtilsFactory / createContractJsonifiedUtilsFactory in @orpc/tanstack-query accept router contracts the same way
• New resolveBasePathMeta helper exported from @orpc/contract

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
orpc	Ready	Preview, Comment	Jul 21, 2026 2:30am

[pkg-pr-new]

More templates

• @orpc/bun-playground
• @orpc/cloudflare-playground
• @orpc/nest-playground
• @orpc/next-playground

@orpc/arktype

npm i https://pkg.pr.new/middleapi/orpc/@orpc/arktype@1699

@orpc/bun

npm i https://pkg.pr.new/middleapi/orpc/@orpc/bun@1699

@orpc/client

npm i https://pkg.pr.new/middleapi/orpc/@orpc/client@1699

@orpc/cloudflare

npm i https://pkg.pr.new/middleapi/orpc/@orpc/cloudflare@1699

@orpc/contract

npm i https://pkg.pr.new/middleapi/orpc/@orpc/contract@1699

@orpc/experimental-effect

npm i https://pkg.pr.new/middleapi/orpc/@orpc/experimental-effect@1699

@orpc/evlog

npm i https://pkg.pr.new/middleapi/orpc/@orpc/evlog@1699

@orpc/json-schema

npm i https://pkg.pr.new/middleapi/orpc/@orpc/json-schema@1699

@orpc/nest

npm i https://pkg.pr.new/middleapi/orpc/@orpc/nest@1699

@orpc/next

npm i https://pkg.pr.new/middleapi/orpc/@orpc/next@1699

@orpc/openapi

npm i https://pkg.pr.new/middleapi/orpc/@orpc/openapi@1699

@orpc/opentelemetry

npm i https://pkg.pr.new/middleapi/orpc/@orpc/opentelemetry@1699

@orpc/pinia-colada

npm i https://pkg.pr.new/middleapi/orpc/@orpc/pinia-colada@1699

@orpc/pino

npm i https://pkg.pr.new/middleapi/orpc/@orpc/pino@1699

@orpc/publisher

npm i https://pkg.pr.new/middleapi/orpc/@orpc/publisher@1699

@orpc/ratelimit

npm i https://pkg.pr.new/middleapi/orpc/@orpc/ratelimit@1699

@orpc/server

npm i https://pkg.pr.new/middleapi/orpc/@orpc/server@1699

@orpc/shared

npm i https://pkg.pr.new/middleapi/orpc/@orpc/shared@1699

@orpc/tanstack-query

npm i https://pkg.pr.new/middleapi/orpc/@orpc/tanstack-query@1699

@orpc/trpc

npm i https://pkg.pr.new/middleapi/orpc/@orpc/trpc@1699

@orpc/valibot

npm i https://pkg.pr.new/middleapi/orpc/@orpc/valibot@1699

@orpc/zod

npm i https://pkg.pr.new/middleapi/orpc/@orpc/zod@1699

commit: f4db018

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[codspeed-hq]

Merging this PR will not alter performance

✅ 18 untouched benchmarks

---

_{Comparing dinwwwh:claude/openapi-caller-contract-client-ceabed (f4db018) with main (d7648e4)}

[pullfrog]

✅ No new issues found.

Reviewed changes — replaced the single-procedure contract caller with a contract client factory that accepts router/sub-router contracts, threading base-path resolution through TanStack Query utils and the OpenAPI jsonified wrapper.

• Renamed contract entry points — createContractCaller → createContractClientFactory in @orpc/contract and createContractJsonifiedCaller → createContractJsonifiedClientFactory in @orpc/openapi.
• Router-contract support — factories now accept a RouterContract, return a RouterContractClient, and resolve procedure paths as basePath + shape.
• New helper — exported resolveBasePathMeta derives the base path from the first procedure contract that defines meta.path.
• TanStack Query alignment — createContractUtilsFactory and createContractJsonifiedUtilsFactory now take a ContractClientFactory, accept router contracts, and derive the query-key path from the contract (the path option is no longer exposed on factory options).
• Docs & cleanup — updated apps/content/docs/advanced/scaling-large-projects.md and removed the stale **/.claude/** exclusion from vitest.config.ts.

  ^{｜ View workflow run ｜ Using Kimi K2 (free via Pullfrog for OSS) ｜ 𝕏}