refactor(shared): rename clerk-rq directory to query by jacekradko · Pull Request #8445 · clerk/javascript

jacekradko · 2026-05-02T12:25:09Z

Summary

Renames packages/shared/src/react/clerk-rq/ → packages/shared/src/react/query/. The rq shorthand was opaque ("react-query"); query/ reads naturally and matches the existing function vocabulary (useClerkQuery, getClerkQueryClient, useClerkInfiniteQuery).

Pure directory rename — no behavior change, no public surface change. The clerk-rq path was internal to @clerk/shared (which itself is described as an internal SDK utility package); not exposed via subpath exports, not referenced in any CHANGELOG or docs.

11 files relocated, 16 import sites updated, two doc comments refreshed. The stable __tag: 'clerk-rq-client' runtime identifier in mocks/clerk.ts is intentionally untouched to avoid behavior churn.

Stacking

Based on jacek/clerk-rq-invert-ownership (#8434). Will need to be retargeted to main once that PR merges, or merged through it.

Test plan

pnpm --filter @clerk/shared test — 1076 tests pass, no type errors
pnpm --filter @clerk/shared build — clean
grep clerk-rq returns only the deliberate runtime tag and the parent PR's changeset

…rk/shared

…-ownership # Conflicts: # packages/clerk-js/package.json # packages/shared/package.json # pnpm-lock.yaml

vercel · 2026-05-02T12:25:14Z

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

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	May 5, 2026 1:06am

changeset-bot · 2026-05-02T12:25:14Z

🦋 Changeset detected

Latest commit: edca0c0

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

wobsoriano

🧹

…-dir # Conflicts: # packages/shared/src/react/hooks/__tests__/mocks/clerk.ts # packages/shared/src/react/index.ts # packages/shared/src/react/query/__tests__/clerk-query-client.spec.ts # packages/shared/src/react/query/clerk-query-client.ts

coderabbitai · 2026-05-05T00:45:52Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro

Run ID: b578d8d8-f282-4a21-acc7-1d71403c22a8

📥 Commits

Reviewing files that changed from the base of the PR and between e950f20 and edca0c0.

📒 Files selected for processing (12)

packages/shared/src/keyless/nodeFileStorage.ts
packages/shared/src/organization.ts
packages/shared/src/react/billing/useInitializePaymentMethod.tsx
packages/shared/src/react/billing/useStripeClerkLibs.tsx
packages/shared/src/react/billing/useStripeLoader.tsx
packages/shared/src/react/hooks/useOAuthConsent.tsx
packages/shared/src/react/hooks/useOrganizationCreationDefaults.tsx
packages/shared/src/react/hooks/usePaymentAttemptQuery.tsx
packages/shared/src/react/hooks/usePlanDetailsQuery.tsx
packages/shared/src/react/hooks/useStatementQuery.tsx
packages/shared/src/react/hooks/useSubscription.tsx
packages/shared/src/react/hooks/useUserEnterpriseConnections.tsx

✅ Files skipped from review due to trivial changes (11)

packages/shared/src/react/billing/useInitializePaymentMethod.tsx
packages/shared/src/react/hooks/useUserEnterpriseConnections.tsx
packages/shared/src/react/billing/useStripeClerkLibs.tsx
packages/shared/src/react/hooks/usePlanDetailsQuery.tsx
packages/shared/src/react/billing/useStripeLoader.tsx
packages/shared/src/react/hooks/usePaymentAttemptQuery.tsx
packages/shared/src/organization.ts
packages/shared/src/react/hooks/useOrganizationCreationDefaults.tsx
packages/shared/src/keyless/nodeFileStorage.ts
packages/shared/src/react/hooks/useSubscription.tsx
packages/shared/src/react/hooks/useStatementQuery.tsx

📝 Walkthrough

Walkthrough

This pull request renames internal React query import paths across the shared package: files that previously imported from ../clerk-rq/* now import from ../query/*. The change touches multiple hooks, billing utilities, test mocks, and the package re-exports; small JSDoc/comment formatting edits and an empty changeset file were also added. No runtime logic, function signatures, or exported API shapes were modified.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The PR title clearly and specifically describes the main change: renaming the clerk-rq directory to query, which matches the scope of the changeset.
Description check	✅ Passed	The PR description provides relevant context about the directory rename, rationale for the change, scope of updates, test results, and stacking information, all directly related to the changeset.
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

pkg-pr-new · 2026-05-05T00:46:44Z

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@8445

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@8445

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@8445

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@8445

@clerk/dev-cli

npm i https://pkg.pr.new/@clerk/dev-cli@8445

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@8445

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@8445

@clerk/express

npm i https://pkg.pr.new/@clerk/express@8445

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@8445

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@8445

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@8445

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@8445

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@8445

@clerk/react

npm i https://pkg.pr.new/@clerk/react@8445

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@8445

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@8445

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@8445

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@8445

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@8445

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@8445

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@8445

commit: edca0c0

jacekradko added 11 commits April 30, 2026 11:16

fix(shared,clerk-js): raise @tanstack/query-core floor to ^5.100.5

e491aca

refactor(shared,clerk-js,react): move QueryClient ownership into @cle…

36331b4

…rk/shared

Merge remote-tracking branch 'origin/main' into jacek/clerk-rq-invert…

67dad2b

…-ownership # Conflicts: # packages/clerk-js/package.json # packages/shared/package.json # pnpm-lock.yaml

chore: drop already-released changeset

c93141d

Merge branch 'main' into jacek/clerk-rq-invert-ownership

dbdfe39

fix(clerk-js): drop query-core-vendors chunk split

3021aaf

fix(ui): bump bundlewatch limits for query-core ownership inversion

b0a9abb

fix(shared): use @/ alias in mocks/clerk.ts to satisfy lint depth rule

a87be02

Merge branch 'main' into jacek/clerk-rq-invert-ownership

4ad3234

test(shared): cover clerk-rq QueryClient singleton invariants

affd00d

refactor(shared): rename clerk-rq directory to query

550cbdd

vercel Bot deployed to Preview May 2, 2026 12:25 View deployment

wobsoriano approved these changes May 2, 2026

View reviewed changes

Base automatically changed from jacek/clerk-rq-invert-ownership to main May 5, 2026 00:07

vercel Bot deployed to Preview May 5, 2026 00:44 View deployment

fix(shared): sort imports after clerk-rq → query rename

edca0c0

vercel Bot deployed to Preview May 5, 2026 01:06 View deployment

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

refactor(shared): rename clerk-rq directory to query#8445

refactor(shared): rename clerk-rq directory to query#8445
jacekradko wants to merge 13 commits intomainfrom
jacek/rename-clerk-rq-dir

jacekradko commented May 2, 2026

Uh oh!

vercel Bot commented May 2, 2026 •

edited

Loading

Uh oh!

changeset-bot Bot commented May 2, 2026 •

edited

Loading

Uh oh!

wobsoriano left a comment

Uh oh!

coderabbitai Bot commented May 5, 2026 •

edited

Loading

Walkthrough

Estimated code review effort

Uh oh!

pkg-pr-new Bot commented May 5, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

jacekradko commented May 2, 2026

Summary

Stacking

Test plan

Uh oh!

vercel Bot commented May 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot Bot commented May 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

wobsoriano left a comment

Choose a reason for hiding this comment

Uh oh!

coderabbitai Bot commented May 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Estimated code review effort

Uh oh!

pkg-pr-new Bot commented May 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

vercel Bot commented May 2, 2026 •

edited

Loading

changeset-bot Bot commented May 2, 2026 •

edited

Loading

coderabbitai Bot commented May 5, 2026 •

edited

Loading

pkg-pr-new Bot commented May 5, 2026 •

edited

Loading