feat(shared): make clerkJSUrl, clerkJSVersion, clerkUIUrl internal by jacekradko · Pull Request #7879 · clerk/javascript

jacekradko · 2026-02-18T19:55:27Z

Summary

Remove clerkUIVersion prop from IsomorphicClerkOptions and all framework packages (no longer needed as a public option)
Deprecate clerkJSVersion prop (SDK auto-selects the correct version)
Rename clerkJSUrl, clerkJSVersion, and clerkUIUrl to __internal_clerkJSUrl, __internal_clerkJSVersion, and __internal_clerkUIUrl to indicate they are internal-only options
Update all framework packages (@clerk/nextjs, @clerk/astro, @clerk/react-router, @clerk/tanstack-react-start, @clerk/express, @clerk/nuxt) to use the new internal prop names
Internal variable names (env reading, wire format, constants) remain unchanged

Checklist

pnpm build passes (21/21 packages)
@clerk/shared tests pass (977 tests)
@clerk/nextjs tests pass (391 tests)
@clerk/react-router tests pass (23 tests)
@clerk/astro tests pass (2 tests)
@clerk/tanstack-react-start tests pass (16 tests)
Only intended files changed (git diff main --stat)

Summary by CodeRabbit

Breaking Changes
- Public configuration props clerkJSUrl, clerkJSVersion, clerkUIUrl and clerkUIVersion have been removed and replaced by internal-only _internal* equivalents.
Deprecations
- clerkJSVersion and clerkUIVersion deprecated; migrate to __internal_clerkJSVersion and __internal_clerkUIVersion.
New Features
- Migration codemod added to help update existing projects.
Chores
- Version/changeset bumps across multiple SDK packages.

@deprecated

…xt): remove clerkUIVersion and deprecate clerkJSVersion Remove the `clerkUIVersion` prop from all SDKs and deprecate the `clerkJSVersion` prop with @deprecated JSDoc annotations.

…xt): rename clerkJSUrl, clerkJSVersion, clerkUIUrl to __internal_ prefix

changeset-bot · 2026-02-18T19:55:32Z

🦋 Changeset detected

Latest commit: a292b67

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

This PR includes changesets to release 20 packages

Name	Type
@clerk/shared	Minor
@clerk/nextjs	Minor
@clerk/astro	Minor
@clerk/react-router	Minor
@clerk/tanstack-react-start	Minor
@clerk/express	Minor
@clerk/nuxt	Minor
@clerk/agent-toolkit	Patch
@clerk/backend	Patch
@clerk/chrome-extension	Patch
@clerk/clerk-js	Patch
@clerk/expo-passkeys	Patch
@clerk/expo	Patch
@clerk/fastify	Patch
@clerk/localizations	Patch
@clerk/msw	Patch
@clerk/react	Patch
@clerk/testing	Patch
@clerk/ui	Patch
@clerk/vue	Patch

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

vercel · 2026-02-18T19:55:32Z

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

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Feb 19, 2026 4:33am

pkg-pr-new · 2026-02-18T19:59:31Z

Open in StackBlitz

@clerk/agent-toolkit

npm i https://pkg.pr.new/@clerk/agent-toolkit@7879

@clerk/astro

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

@clerk/backend

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

@clerk/chrome-extension

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

@clerk/clerk-js

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

@clerk/dev-cli

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

@clerk/expo

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

@clerk/expo-passkeys

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

@clerk/express

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

@clerk/fastify

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

@clerk/hono

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

@clerk/localizations

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

@clerk/nextjs

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

@clerk/nuxt

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

@clerk/react

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

@clerk/react-router

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

@clerk/shared

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

@clerk/tanstack-react-start

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

@clerk/testing

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

@clerk/ui

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

@clerk/upgrade

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

@clerk/vue

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

commit: a292b67

coderabbitai · 2026-02-18T20:03:29Z

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

@coderabbitai resume to resume automatic reviews.
@coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

▶️ Resume reviews
🔍 Trigger review

📝 Walkthrough

Walkthrough

This pull request renames four UI configuration properties from public to internal-only across the SDKs: clerkJSUrl, clerkJSVersion, clerkUIUrl, and clerkUIVersion → __internal_clerkJSUrl, __internal_clerkJSVersion, __internal_clerkUIUrl, and __internal_clerkUIVersion. Changes touch type definitions, runtime code, tests, integration templates, a codemod and its fixtures, and upgrade configuration across multiple packages. JSDoc/internal annotations mark the new keys as internal and codemods/tests cover automated migration.

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 10.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately describes the main change: converting clerkJSUrl, clerkJSVersion, and clerkUIUrl from public to internal props across the Clerk SDK.

_{✏️ 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.}

coderabbitai

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)

packages/astro/src/integration/create-integration.ts (1)
22-66: ⚠️ Potential issue | 🟠 Major

Missing env mapping for __internal_clerkUIUrl parameter

The __internal_clerkUIUrl parameter is defined in AstroClerkIntegrationParams and used in build-clerk-hotload-script, but it's never extracted from params or mapped to the PUBLIC_CLERK_UI_URL env variable in create-integration.ts. This inconsistency with how __internal_clerkJSUrl and __internal_clerkJSVersion are handled breaks UI URL overrides passed through integration params—the server-side code won't have access to the custom UI URL.

Add the missing extraction and env mapping:
    const clerkJSUrl = (params as any)?.__internal_clerkJSUrl as string | undefined;
    const clerkJSVersion = (params as any)?.__internal_clerkJSVersion as string | undefined;
+   const clerkUIUrl = (params as any)?.__internal_clerkUIUrl as string | undefined;
    const prefetchUI = (params as any)?.prefetchUI as boolean | undefined;
                ...buildEnvVarFromOption(clerkJSUrl, 'PUBLIC_CLERK_JS_URL'),
                ...buildEnvVarFromOption(clerkJSVersion, 'PUBLIC_CLERK_JS_VERSION'),
+               ...buildEnvVarFromOption(clerkUIUrl, 'PUBLIC_CLERK_UI_URL'),
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@packages/astro/src/integration/create-integration.ts` around lines 22 - 66,
The integration never extracts the __internal_clerkUIUrl param nor maps it to an
env var, so the server cannot see UI URL overrides; add a const like clerkUIUrl
= (params as any)?.__internal_clerkUIUrl as string | undefined alongside
clerkJSUrl/clerkJSVersion, then include ...buildEnvVarFromOption(clerkUIUrl,
'PUBLIC_CLERK_UI_URL') in the define block inside the 'astro:config:setup' hook
(near the other buildEnvVarFromOption calls) so the value is available
server-side for code that reads PUBLIC_CLERK_UI_URL (e.g.,
build-clerk-hotload-script).

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Outside diff comments:
In `@packages/astro/src/integration/create-integration.ts`:
- Around line 22-66: The integration never extracts the __internal_clerkUIUrl
param nor maps it to an env var, so the server cannot see UI URL overrides; add
a const like clerkUIUrl = (params as any)?.__internal_clerkUIUrl as string |
undefined alongside clerkJSUrl/clerkJSVersion, then include
...buildEnvVarFromOption(clerkUIUrl, 'PUBLIC_CLERK_UI_URL') in the define block
inside the 'astro:config:setup' hook (near the other buildEnvVarFromOption
calls) so the value is available server-side for code that reads
PUBLIC_CLERK_UI_URL (e.g., build-clerk-hotload-script).

…rop names Update all ClerkProvider usages in integration test templates and playground to use the renamed __internal_clerkJSUrl, __internal_clerkUIUrl, and __internal_clerkJSVersion props. Also deduplicate pnpm-lock.yaml.

@deprecated

Remove @deprecated annotations from internal props and add a jscodeshift codemod to rename clerkJSUrl, clerkJSVersion, clerkUIUrl, clerkUIVersion to their __internal_ prefixed equivalents. Update changesets to reflect full removal rather than deprecation.

Omit __internal_clerkJSUrl, __internal_clerkJSVersion, __internal_clerkUIUrl, and __internal_clerkUIVersion from consumer-facing ClerkProviderProps and framework SDK types. These props are now only accessible via InternalClerkProvider exported from @clerk/react/internal. - Add InternalClerkScriptProps type to @clerk/shared - Narrow ClerkProviderProps in @clerk/react via Omit - Export InternalClerkProvider from @clerk/react/internal with wider type - Switch all framework SDKs to use InternalClerkProvider - Clean up Vue PluginOptions, Astro, and Nuxt types

jacekradko added 2 commits February 18, 2026 10:29

feat(shared,nextjs,astro,react-router,tanstack-react-start,express,nu…

4d472a3

…xt): remove clerkUIVersion and deprecate clerkJSVersion Remove the `clerkUIVersion` prop from all SDKs and deprecate the `clerkJSVersion` prop with @deprecated JSDoc annotations.

feat(shared,nextjs,astro,react-router,tanstack-react-start,express,nu…

debeb36

…xt): rename clerkJSUrl, clerkJSVersion, clerkUIUrl to __internal_ prefix

github-actions bot added nextjs express tanstack astro react-router nuxt core-3 labels Feb 18, 2026

coderabbitai bot reviewed Feb 18, 2026

View reviewed changes

jacekradko changed the title ~~feat: make clerkJSUrl, clerkJSVersion, clerkUIUrl, clerkUIVersion internal~~ feat(shared): make clerkJSUrl, clerkJSVersion, clerkUIUrl internal Feb 18, 2026

github-actions bot added playground integration labels Feb 18, 2026

vercel bot deployed to Preview February 18, 2026 20:17 View deployment

style: format DynamicClerkScripts and clerk-script-tags

13aba37

vercel bot temporarily deployed to Preview February 18, 2026 20:20 Inactive

feat: add __internal_clerkUIVersion prop across all packages

a186242

vercel bot deployed to Preview February 18, 2026 20:55 View deployment

vercel bot deployed to Preview February 19, 2026 01:58 View deployment

github-actions bot added react expo chrome-extension vue labels Feb 19, 2026

vercel bot deployed to Preview February 19, 2026 04:33 View deployment

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(shared): make clerkJSUrl, clerkJSVersion, clerkUIUrl internal#7879

feat(shared): make clerkJSUrl, clerkJSVersion, clerkUIUrl internal#7879
jacekradko wants to merge 7 commits intomainfrom
jacek/remove-clerk-ui-version

jacekradko commented Feb 18, 2026 •

edited by coderabbitai bot

Loading

Uh oh!

changeset-bot bot commented Feb 18, 2026 •

edited

Loading

Uh oh!

vercel bot commented Feb 18, 2026 •

edited

Loading

Uh oh!

pkg-pr-new bot commented Feb 18, 2026 •

edited

Loading

Uh oh!

coderabbitai bot commented Feb 18, 2026 •

edited

Loading

Reviews paused

Walkthrough

❌ Failed checks (1 warning)

Uh oh!

coderabbitai bot left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Comments

Conversation

jacekradko commented Feb 18, 2026 • edited by coderabbitai bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Checklist

Summary by CodeRabbit

Uh oh!

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

Uh oh!

🦋 Changeset detected

Uh oh!

vercel bot commented Feb 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

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

Uh oh!

Uh oh!

coderabbitai bot commented Feb 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Reviews paused

Walkthrough

❌ Failed checks (1 warning)

Uh oh!

coderabbitai bot left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Comments

jacekradko commented Feb 18, 2026 •

edited by coderabbitai bot

Loading

changeset-bot bot commented Feb 18, 2026 •

edited

Loading

vercel bot commented Feb 18, 2026 •

edited

Loading

pkg-pr-new bot commented Feb 18, 2026 •

edited

Loading

coderabbitai bot commented Feb 18, 2026 •

edited

Loading