fix(clerk-js): Respect proxyUrl and domain in non-browser environments by brkalow · Pull Request #8095 · clerk/javascript

brkalow · 2026-03-17T03:16:19Z

Description

It's possible for non-browser environments to provide a domain or proxyUrl, but clerk-js currently ignores the provided values when not in a browser. This PR updates clerk-js so the provided value is now respected in non-browser environments.

The only caveat is that we cannot accept a function for the value in expo, as we are unable to provide the current base URL (window.location.href).

fixes AIE-644

Checklist

pnpm test runs as expected.
pnpm build runs as expected.
(If applicable) JSDoc comments have been added or updated for any package exports
(If applicable) Documentation has been updated

Type of change

Summary by CodeRabbit

New Features
- Support for providing proxy URLs and custom domains in non-browser environments.
Bug Fixes
- Native/runtime validation now enforces absolute HTTP(S) proxy URLs and rejects unsupported function-valued configurations, emitting warnings and graceful fallbacks.
Tests
- Added and expanded tests covering non-browser/native behavior for proxy URL and domain resolution.
Chores
- Bumped package patch versions via a changeset.

…ronments

vercel · 2026-03-17T03:16:25Z

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

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Mar 17, 2026 3:21pm

changeset-bot · 2026-03-17T03:16:28Z

🦋 Changeset detected

Latest commit: 51533d2

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

This PR includes changesets to release 21 packages

Name	Type
@clerk/clerk-js	Patch
@clerk/shared	Patch
@clerk/expo	Patch
@clerk/chrome-extension	Patch
@clerk/agent-toolkit	Patch
@clerk/astro	Patch
@clerk/backend	Patch
@clerk/expo-passkeys	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/hono	Patch
@clerk/localizations	Patch
@clerk/msw	Patch
@clerk/nextjs	Patch
@clerk/nuxt	Patch
@clerk/react-router	Patch
@clerk/react	Patch
@clerk/tanstack-react-start	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

pkg-pr-new · 2026-03-17T03:18:32Z

Open in StackBlitz

@clerk/agent-toolkit

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

@clerk/astro

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

@clerk/backend

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

@clerk/chrome-extension

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

@clerk/clerk-js

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

@clerk/dev-cli

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

@clerk/expo

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

@clerk/expo-passkeys

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

@clerk/express

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

@clerk/fastify

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

@clerk/hono

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

@clerk/localizations

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

@clerk/nextjs

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

@clerk/nuxt

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

@clerk/react

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

@clerk/react-router

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

@clerk/shared

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

@clerk/tanstack-react-start

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

@clerk/testing

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

@clerk/ui

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

@clerk/upgrade

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

@clerk/vue

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

commit: 51533d2

coderabbitai · 2026-03-17T03:21:35Z

📝 Walkthrough

Walkthrough

Adds a changeset and tests; treats function-valued domain and proxyUrl as unsupported in non-browser runtimes by logging warnings and returning empty string (clerk-js getters). Introduces assertValidProxyUrl (exported) which enforces native-only proxyUrl type and absolute HTTP(S) URLs and is invoked when creating/recreating the Expo Clerk instance. Adds warning helpers for function-valued properties and test cases covering non-browser baseUrl resolution and proxyUrl validation. No public API signatures were changed.

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.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
Title check	✅ Passed	The title 'fix(clerk-js): Respect proxyUrl and domain in non-browser environments' directly summarizes the main change: enabling clerk-js to respect proxyUrl and domain settings in non-browser environments, which aligns with the PR objectives and all file changes.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

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

📝 Coding Plan

Generate coding plan for human review comments

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

Tip

CodeRabbit can scan for known vulnerabilities in your dependencies using OSV Scanner.

OSV Scanner will automatically detect and report security vulnerabilities in your project's dependencies. No additional configuration is required.

jacekradko · 2026-03-17T14:23:06Z

+ if (typeof proxyUrl !== 'string') {
+ return errorThrower.throw('`proxyUrl` must be a string in non-browser environments.');
+ }
+
+ if (!isHttpOrHttps(proxyUrl)) {
+ errorThrower.throw('`proxyUrl` must be an absolute URL in non-browser environments.');
+ }


[nit] Just from a quick look at this, it feels weird to return the errorThrower.throw even though it presumably throws in one branch, and not in the other

true, this was to appease TS on L19 to narrow the type. Let me see if I can adjust

I figured it's static analysis related

jacekradko

Looks pretty safe

chriscanin

Looks good, tested on simulator and working as intended.

#8095) Co-authored-by: Jacek Radko <jacek@clerk.dev>

brkalow · 2026-03-17T03:16:19Z

Description

It's possible for non-browser environments to provide a domain or proxyUrl, but clerk-js currently ignores the provided values when not in a browser. This PR updates clerk-js so the provided value is now respected in non-browser environments.

The only caveat is that we cannot accept a function for the value in expo, as we are unable to provide the current base URL (window.location.href).

fixes AIE-644

Checklist

pnpm test runs as expected.
pnpm build runs as expected.
(If applicable) JSDoc comments have been added or updated for any package exports
(If applicable) Documentation has been updated

Type of change

Summary by CodeRabbit

New Features
- Support for providing proxy URLs and custom domains in non-browser environments.
Bug Fixes
- Native/runtime validation now enforces absolute HTTP(S) proxy URLs and rejects unsupported function-valued configurations, emitting warnings and graceful fallbacks.
Tests
- Added and expanded tests covering non-browser/native behavior for proxy URL and domain resolution.
Chores
- Bumped package patch versions via a changeset.

…ronments

vercel · 2026-03-17T03:16:25Z

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

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Mar 17, 2026 3:21pm

changeset-bot · 2026-03-17T03:16:28Z

🦋 Changeset detected

Latest commit: 51533d2

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

This PR includes changesets to release 21 packages

Name	Type
@clerk/clerk-js	Patch
@clerk/shared	Patch
@clerk/expo	Patch
@clerk/chrome-extension	Patch
@clerk/agent-toolkit	Patch
@clerk/astro	Patch
@clerk/backend	Patch
@clerk/expo-passkeys	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/hono	Patch
@clerk/localizations	Patch
@clerk/msw	Patch
@clerk/nextjs	Patch
@clerk/nuxt	Patch
@clerk/react-router	Patch
@clerk/react	Patch
@clerk/tanstack-react-start	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

pkg-pr-new · 2026-03-17T03:18:32Z

Open in StackBlitz

@clerk/agent-toolkit

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

@clerk/astro

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

@clerk/backend

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

@clerk/chrome-extension

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

@clerk/clerk-js

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

@clerk/dev-cli

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

@clerk/expo

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

@clerk/expo-passkeys

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

@clerk/express

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

@clerk/fastify

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

@clerk/hono

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

@clerk/localizations

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

@clerk/nextjs

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

@clerk/nuxt

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

@clerk/react

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

@clerk/react-router

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

@clerk/shared

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

@clerk/tanstack-react-start

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

@clerk/testing

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

@clerk/ui

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

@clerk/upgrade

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

@clerk/vue

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

commit: 51533d2

coderabbitai · 2026-03-17T03:21:35Z

📝 Walkthrough

Walkthrough

Adds a changeset and tests; treats function-valued domain and proxyUrl as unsupported in non-browser runtimes by logging warnings and returning empty string (clerk-js getters). Introduces assertValidProxyUrl (exported) which enforces native-only proxyUrl type and absolute HTTP(S) URLs and is invoked when creating/recreating the Expo Clerk instance. Adds warning helpers for function-valued properties and test cases covering non-browser baseUrl resolution and proxyUrl validation. No public API signatures were changed.

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.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
Title check	✅ Passed	The title 'fix(clerk-js): Respect proxyUrl and domain in non-browser environments' directly summarizes the main change: enabling clerk-js to respect proxyUrl and domain settings in non-browser environments, which aligns with the PR objectives and all file changes.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

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

📝 Coding Plan

Generate coding plan for human review comments

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

Tip

CodeRabbit can scan for known vulnerabilities in your dependencies using OSV Scanner.

OSV Scanner will automatically detect and report security vulnerabilities in your project's dependencies. No additional configuration is required.

jacekradko · 2026-03-17T14:23:06Z

+ if (typeof proxyUrl !== 'string') {
+ return errorThrower.throw('`proxyUrl` must be a string in non-browser environments.');
+ }
+
+ if (!isHttpOrHttps(proxyUrl)) {
+ errorThrower.throw('`proxyUrl` must be an absolute URL in non-browser environments.');
+ }


[nit] Just from a quick look at this, it feels weird to return the errorThrower.throw even though it presumably throws in one branch, and not in the other

true, this was to appease TS on L19 to narrow the type. Let me see if I can adjust

I figured it's static analysis related

jacekradko

Looks pretty safe

chriscanin

Looks good, tested on simulator and working as intended.

#8095) Co-authored-by: Jacek Radko <jacek@clerk.dev>

brkalow · 2026-03-17T03:16:19Z

Description

It's possible for non-browser environments to provide a domain or proxyUrl, but clerk-js currently ignores the provided values when not in a browser. This PR updates clerk-js so the provided value is now respected in non-browser environments.

The only caveat is that we cannot accept a function for the value in expo, as we are unable to provide the current base URL (window.location.href).

fixes AIE-644

Checklist

pnpm test runs as expected.
pnpm build runs as expected.
(If applicable) JSDoc comments have been added or updated for any package exports
(If applicable) Documentation has been updated

Type of change

Summary by CodeRabbit

New Features
- Support for providing proxy URLs and custom domains in non-browser environments.
Bug Fixes
- Native/runtime validation now enforces absolute HTTP(S) proxy URLs and rejects unsupported function-valued configurations, emitting warnings and graceful fallbacks.
Tests
- Added and expanded tests covering non-browser/native behavior for proxy URL and domain resolution.
Chores
- Bumped package patch versions via a changeset.

…ronments

vercel · 2026-03-17T03:16:25Z

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

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Mar 17, 2026 3:21pm

changeset-bot · 2026-03-17T03:16:28Z

🦋 Changeset detected

Latest commit: 51533d2

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

This PR includes changesets to release 21 packages

Name	Type
@clerk/clerk-js	Patch
@clerk/shared	Patch
@clerk/expo	Patch
@clerk/chrome-extension	Patch
@clerk/agent-toolkit	Patch
@clerk/astro	Patch
@clerk/backend	Patch
@clerk/expo-passkeys	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/hono	Patch
@clerk/localizations	Patch
@clerk/msw	Patch
@clerk/nextjs	Patch
@clerk/nuxt	Patch
@clerk/react-router	Patch
@clerk/react	Patch
@clerk/tanstack-react-start	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

pkg-pr-new · 2026-03-17T03:18:32Z

Open in StackBlitz

@clerk/agent-toolkit

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

@clerk/astro

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

@clerk/backend

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

@clerk/chrome-extension

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

@clerk/clerk-js

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

@clerk/dev-cli

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

@clerk/expo

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

@clerk/expo-passkeys

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

@clerk/express

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

@clerk/fastify

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

@clerk/hono

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

@clerk/localizations

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

@clerk/nextjs

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

@clerk/nuxt

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

@clerk/react

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

@clerk/react-router

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

@clerk/shared

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

@clerk/tanstack-react-start

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

@clerk/testing

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

@clerk/ui

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

@clerk/upgrade

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

@clerk/vue

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

commit: 51533d2

coderabbitai · 2026-03-17T03:21:35Z

📝 Walkthrough

Walkthrough

Adds a changeset and tests; treats function-valued domain and proxyUrl as unsupported in non-browser runtimes by logging warnings and returning empty string (clerk-js getters). Introduces assertValidProxyUrl (exported) which enforces native-only proxyUrl type and absolute HTTP(S) URLs and is invoked when creating/recreating the Expo Clerk instance. Adds warning helpers for function-valued properties and test cases covering non-browser baseUrl resolution and proxyUrl validation. No public API signatures were changed.

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.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
Title check	✅ Passed	The title 'fix(clerk-js): Respect proxyUrl and domain in non-browser environments' directly summarizes the main change: enabling clerk-js to respect proxyUrl and domain settings in non-browser environments, which aligns with the PR objectives and all file changes.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

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

📝 Coding Plan

Generate coding plan for human review comments

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

Tip

CodeRabbit can scan for known vulnerabilities in your dependencies using OSV Scanner.

OSV Scanner will automatically detect and report security vulnerabilities in your project's dependencies. No additional configuration is required.

jacekradko · 2026-03-17T14:23:06Z

+ if (typeof proxyUrl !== 'string') {
+ return errorThrower.throw('`proxyUrl` must be a string in non-browser environments.');
+ }
+
+ if (!isHttpOrHttps(proxyUrl)) {
+ errorThrower.throw('`proxyUrl` must be an absolute URL in non-browser environments.');
+ }


[nit] Just from a quick look at this, it feels weird to return the errorThrower.throw even though it presumably throws in one branch, and not in the other

true, this was to appease TS on L19 to narrow the type. Let me see if I can adjust

I figured it's static analysis related

jacekradko

Looks pretty safe

chriscanin

Looks good, tested on simulator and working as intended.

#8095) Co-authored-by: Jacek Radko <jacek@clerk.dev>

brkalow · 2026-03-17T03:16:19Z

Description

It's possible for non-browser environments to provide a domain or proxyUrl, but clerk-js currently ignores the provided values when not in a browser. This PR updates clerk-js so the provided value is now respected in non-browser environments.

The only caveat is that we cannot accept a function for the value in expo, as we are unable to provide the current base URL (window.location.href).

fixes AIE-644

Checklist

pnpm test runs as expected.
pnpm build runs as expected.
(If applicable) JSDoc comments have been added or updated for any package exports
(If applicable) Documentation has been updated

Type of change

Summary by CodeRabbit

New Features
- Support for providing proxy URLs and custom domains in non-browser environments.
Bug Fixes
- Native/runtime validation now enforces absolute HTTP(S) proxy URLs and rejects unsupported function-valued configurations, emitting warnings and graceful fallbacks.
Tests
- Added and expanded tests covering non-browser/native behavior for proxy URL and domain resolution.
Chores
- Bumped package patch versions via a changeset.

…ronments

vercel · 2026-03-17T03:16:25Z

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

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Mar 17, 2026 3:21pm

changeset-bot · 2026-03-17T03:16:28Z

🦋 Changeset detected

Latest commit: 51533d2

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

This PR includes changesets to release 21 packages

Name	Type
@clerk/clerk-js	Patch
@clerk/shared	Patch
@clerk/expo	Patch
@clerk/chrome-extension	Patch
@clerk/agent-toolkit	Patch
@clerk/astro	Patch
@clerk/backend	Patch
@clerk/expo-passkeys	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/hono	Patch
@clerk/localizations	Patch
@clerk/msw	Patch
@clerk/nextjs	Patch
@clerk/nuxt	Patch
@clerk/react-router	Patch
@clerk/react	Patch
@clerk/tanstack-react-start	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

pkg-pr-new · 2026-03-17T03:18:32Z

Open in StackBlitz

@clerk/agent-toolkit

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

@clerk/astro

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

@clerk/backend

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

@clerk/chrome-extension

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

@clerk/clerk-js

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

@clerk/dev-cli

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

@clerk/expo

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

@clerk/expo-passkeys

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

@clerk/express

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

@clerk/fastify

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

@clerk/hono

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

@clerk/localizations

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

@clerk/nextjs

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

@clerk/nuxt

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

@clerk/react

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

@clerk/react-router

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

@clerk/shared

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

@clerk/tanstack-react-start

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

@clerk/testing

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

@clerk/ui

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

@clerk/upgrade

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

@clerk/vue

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

commit: 51533d2

coderabbitai · 2026-03-17T03:21:35Z

📝 Walkthrough

Walkthrough

Adds a changeset and tests; treats function-valued domain and proxyUrl as unsupported in non-browser runtimes by logging warnings and returning empty string (clerk-js getters). Introduces assertValidProxyUrl (exported) which enforces native-only proxyUrl type and absolute HTTP(S) URLs and is invoked when creating/recreating the Expo Clerk instance. Adds warning helpers for function-valued properties and test cases covering non-browser baseUrl resolution and proxyUrl validation. No public API signatures were changed.

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.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
Title check	✅ Passed	The title 'fix(clerk-js): Respect proxyUrl and domain in non-browser environments' directly summarizes the main change: enabling clerk-js to respect proxyUrl and domain settings in non-browser environments, which aligns with the PR objectives and all file changes.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

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

📝 Coding Plan

Generate coding plan for human review comments

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

Tip

CodeRabbit can scan for known vulnerabilities in your dependencies using OSV Scanner.

OSV Scanner will automatically detect and report security vulnerabilities in your project's dependencies. No additional configuration is required.

jacekradko · 2026-03-17T14:23:06Z

+ if (typeof proxyUrl !== 'string') {
+ return errorThrower.throw('`proxyUrl` must be a string in non-browser environments.');
+ }
+
+ if (!isHttpOrHttps(proxyUrl)) {
+ errorThrower.throw('`proxyUrl` must be an absolute URL in non-browser environments.');
+ }


[nit] Just from a quick look at this, it feels weird to return the errorThrower.throw even though it presumably throws in one branch, and not in the other

true, this was to appease TS on L19 to narrow the type. Let me see if I can adjust

I figured it's static analysis related

jacekradko

Looks pretty safe

chriscanin

Looks good, tested on simulator and working as intended.

#8095) Co-authored-by: Jacek Radko <jacek@clerk.dev>

brkalow · 2026-03-17T03:16:19Z

Description

It's possible for non-browser environments to provide a domain or proxyUrl, but clerk-js currently ignores the provided values when not in a browser. This PR updates clerk-js so the provided value is now respected in non-browser environments.

The only caveat is that we cannot accept a function for the value in expo, as we are unable to provide the current base URL (window.location.href).

fixes AIE-644

Checklist

pnpm test runs as expected.
pnpm build runs as expected.
(If applicable) JSDoc comments have been added or updated for any package exports
(If applicable) Documentation has been updated

Type of change

Summary by CodeRabbit

New Features
- Support for providing proxy URLs and custom domains in non-browser environments.
Bug Fixes
- Native/runtime validation now enforces absolute HTTP(S) proxy URLs and rejects unsupported function-valued configurations, emitting warnings and graceful fallbacks.
Tests
- Added and expanded tests covering non-browser/native behavior for proxy URL and domain resolution.
Chores
- Bumped package patch versions via a changeset.

…ronments

vercel · 2026-03-17T03:16:25Z

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

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Mar 17, 2026 3:21pm

changeset-bot · 2026-03-17T03:16:28Z

🦋 Changeset detected

Latest commit: 51533d2

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

This PR includes changesets to release 21 packages

Name	Type
@clerk/clerk-js	Patch
@clerk/shared	Patch
@clerk/expo	Patch
@clerk/chrome-extension	Patch
@clerk/agent-toolkit	Patch
@clerk/astro	Patch
@clerk/backend	Patch
@clerk/expo-passkeys	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/hono	Patch
@clerk/localizations	Patch
@clerk/msw	Patch
@clerk/nextjs	Patch
@clerk/nuxt	Patch
@clerk/react-router	Patch
@clerk/react	Patch
@clerk/tanstack-react-start	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

pkg-pr-new · 2026-03-17T03:18:32Z

Open in StackBlitz

@clerk/agent-toolkit

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

@clerk/astro

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

@clerk/backend

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

@clerk/chrome-extension

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

@clerk/clerk-js

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

@clerk/dev-cli

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

@clerk/expo

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

@clerk/expo-passkeys

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

@clerk/express

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

@clerk/fastify

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

@clerk/hono

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

@clerk/localizations

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

@clerk/nextjs

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

@clerk/nuxt

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

@clerk/react

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

@clerk/react-router

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

@clerk/shared

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

@clerk/tanstack-react-start

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

@clerk/testing

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

@clerk/ui

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

@clerk/upgrade

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

@clerk/vue

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

commit: 51533d2

coderabbitai · 2026-03-17T03:21:35Z

📝 Walkthrough

Walkthrough

Adds a changeset and tests; treats function-valued domain and proxyUrl as unsupported in non-browser runtimes by logging warnings and returning empty string (clerk-js getters). Introduces assertValidProxyUrl (exported) which enforces native-only proxyUrl type and absolute HTTP(S) URLs and is invoked when creating/recreating the Expo Clerk instance. Adds warning helpers for function-valued properties and test cases covering non-browser baseUrl resolution and proxyUrl validation. No public API signatures were changed.

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.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
Title check	✅ Passed	The title 'fix(clerk-js): Respect proxyUrl and domain in non-browser environments' directly summarizes the main change: enabling clerk-js to respect proxyUrl and domain settings in non-browser environments, which aligns with the PR objectives and all file changes.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

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

📝 Coding Plan

Generate coding plan for human review comments

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

Tip

CodeRabbit can scan for known vulnerabilities in your dependencies using OSV Scanner.

OSV Scanner will automatically detect and report security vulnerabilities in your project's dependencies. No additional configuration is required.

jacekradko · 2026-03-17T14:23:06Z

+ if (typeof proxyUrl !== 'string') {
+ return errorThrower.throw('`proxyUrl` must be a string in non-browser environments.');
+ }
+
+ if (!isHttpOrHttps(proxyUrl)) {
+ errorThrower.throw('`proxyUrl` must be an absolute URL in non-browser environments.');
+ }


[nit] Just from a quick look at this, it feels weird to return the errorThrower.throw even though it presumably throws in one branch, and not in the other

true, this was to appease TS on L19 to narrow the type. Let me see if I can adjust

I figured it's static analysis related

jacekradko

Looks pretty safe

chriscanin

Looks good, tested on simulator and working as intended.

#8095) Co-authored-by: Jacek Radko <jacek@clerk.dev>

brkalow · 2026-03-17T03:16:19Z

Description

It's possible for non-browser environments to provide a domain or proxyUrl, but clerk-js currently ignores the provided values when not in a browser. This PR updates clerk-js so the provided value is now respected in non-browser environments.

The only caveat is that we cannot accept a function for the value in expo, as we are unable to provide the current base URL (window.location.href).

fixes AIE-644

Checklist

pnpm test runs as expected.
pnpm build runs as expected.
(If applicable) JSDoc comments have been added or updated for any package exports
(If applicable) Documentation has been updated

Type of change

Summary by CodeRabbit

New Features
- Support for providing proxy URLs and custom domains in non-browser environments.
Bug Fixes
- Native/runtime validation now enforces absolute HTTP(S) proxy URLs and rejects unsupported function-valued configurations, emitting warnings and graceful fallbacks.
Tests
- Added and expanded tests covering non-browser/native behavior for proxy URL and domain resolution.
Chores
- Bumped package patch versions via a changeset.

…ronments

vercel · 2026-03-17T03:16:25Z

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

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Mar 17, 2026 3:21pm

changeset-bot · 2026-03-17T03:16:28Z

🦋 Changeset detected

Latest commit: 51533d2

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

This PR includes changesets to release 21 packages

Name	Type
@clerk/clerk-js	Patch
@clerk/shared	Patch
@clerk/expo	Patch
@clerk/chrome-extension	Patch
@clerk/agent-toolkit	Patch
@clerk/astro	Patch
@clerk/backend	Patch
@clerk/expo-passkeys	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/hono	Patch
@clerk/localizations	Patch
@clerk/msw	Patch
@clerk/nextjs	Patch
@clerk/nuxt	Patch
@clerk/react-router	Patch
@clerk/react	Patch
@clerk/tanstack-react-start	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

pkg-pr-new · 2026-03-17T03:18:32Z

Open in StackBlitz

@clerk/agent-toolkit

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

@clerk/astro

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

@clerk/backend

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

@clerk/chrome-extension

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

@clerk/clerk-js

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

@clerk/dev-cli

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

@clerk/expo

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

@clerk/expo-passkeys

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

@clerk/express

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

@clerk/fastify

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

@clerk/hono

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

@clerk/localizations

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

@clerk/nextjs

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

@clerk/nuxt

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

@clerk/react

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

@clerk/react-router

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

@clerk/shared

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

@clerk/tanstack-react-start

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

@clerk/testing

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

@clerk/ui

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

@clerk/upgrade

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

@clerk/vue

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

commit: 51533d2

coderabbitai · 2026-03-17T03:21:35Z

📝 Walkthrough

Walkthrough

Adds a changeset and tests; treats function-valued domain and proxyUrl as unsupported in non-browser runtimes by logging warnings and returning empty string (clerk-js getters). Introduces assertValidProxyUrl (exported) which enforces native-only proxyUrl type and absolute HTTP(S) URLs and is invoked when creating/recreating the Expo Clerk instance. Adds warning helpers for function-valued properties and test cases covering non-browser baseUrl resolution and proxyUrl validation. No public API signatures were changed.

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.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
Title check	✅ Passed	The title 'fix(clerk-js): Respect proxyUrl and domain in non-browser environments' directly summarizes the main change: enabling clerk-js to respect proxyUrl and domain settings in non-browser environments, which aligns with the PR objectives and all file changes.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

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

📝 Coding Plan

Generate coding plan for human review comments

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

Tip

CodeRabbit can scan for known vulnerabilities in your dependencies using OSV Scanner.

OSV Scanner will automatically detect and report security vulnerabilities in your project's dependencies. No additional configuration is required.

jacekradko · 2026-03-17T14:23:06Z

+ if (typeof proxyUrl !== 'string') {
+ return errorThrower.throw('`proxyUrl` must be a string in non-browser environments.');
+ }
+
+ if (!isHttpOrHttps(proxyUrl)) {
+ errorThrower.throw('`proxyUrl` must be an absolute URL in non-browser environments.');
+ }


[nit] Just from a quick look at this, it feels weird to return the errorThrower.throw even though it presumably throws in one branch, and not in the other

true, this was to appease TS on L19 to narrow the type. Let me see if I can adjust

I figured it's static analysis related

jacekradko

Looks pretty safe

chriscanin

Looks good, tested on simulator and working as intended.

#8095) Co-authored-by: Jacek Radko <jacek@clerk.dev>

brkalow · 2026-03-17T03:16:19Z

Description

It's possible for non-browser environments to provide a domain or proxyUrl, but clerk-js currently ignores the provided values when not in a browser. This PR updates clerk-js so the provided value is now respected in non-browser environments.

The only caveat is that we cannot accept a function for the value in expo, as we are unable to provide the current base URL (window.location.href).

fixes AIE-644

Checklist

pnpm test runs as expected.
pnpm build runs as expected.
(If applicable) JSDoc comments have been added or updated for any package exports
(If applicable) Documentation has been updated

Type of change

Summary by CodeRabbit

New Features
- Support for providing proxy URLs and custom domains in non-browser environments.
Bug Fixes
- Native/runtime validation now enforces absolute HTTP(S) proxy URLs and rejects unsupported function-valued configurations, emitting warnings and graceful fallbacks.
Tests
- Added and expanded tests covering non-browser/native behavior for proxy URL and domain resolution.
Chores
- Bumped package patch versions via a changeset.

…ronments

vercel · 2026-03-17T03:16:25Z

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

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Mar 17, 2026 3:21pm

changeset-bot · 2026-03-17T03:16:28Z

🦋 Changeset detected

Latest commit: 51533d2

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

This PR includes changesets to release 21 packages

Name	Type
@clerk/clerk-js	Patch
@clerk/shared	Patch
@clerk/expo	Patch
@clerk/chrome-extension	Patch
@clerk/agent-toolkit	Patch
@clerk/astro	Patch
@clerk/backend	Patch
@clerk/expo-passkeys	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/hono	Patch
@clerk/localizations	Patch
@clerk/msw	Patch
@clerk/nextjs	Patch
@clerk/nuxt	Patch
@clerk/react-router	Patch
@clerk/react	Patch
@clerk/tanstack-react-start	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

pkg-pr-new · 2026-03-17T03:18:32Z

Open in StackBlitz

@clerk/agent-toolkit

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

@clerk/astro

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

@clerk/backend

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

@clerk/chrome-extension

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

@clerk/clerk-js

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

@clerk/dev-cli

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

@clerk/expo

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

@clerk/expo-passkeys

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

@clerk/express

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

@clerk/fastify

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

@clerk/hono

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

@clerk/localizations

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

@clerk/nextjs

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

@clerk/nuxt

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

@clerk/react

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

@clerk/react-router

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

@clerk/shared

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

@clerk/tanstack-react-start

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

@clerk/testing

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

@clerk/ui

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

@clerk/upgrade

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

@clerk/vue

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

commit: 51533d2

coderabbitai · 2026-03-17T03:21:35Z

📝 Walkthrough

Walkthrough

Adds a changeset and tests; treats function-valued domain and proxyUrl as unsupported in non-browser runtimes by logging warnings and returning empty string (clerk-js getters). Introduces assertValidProxyUrl (exported) which enforces native-only proxyUrl type and absolute HTTP(S) URLs and is invoked when creating/recreating the Expo Clerk instance. Adds warning helpers for function-valued properties and test cases covering non-browser baseUrl resolution and proxyUrl validation. No public API signatures were changed.

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.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
Title check	✅ Passed	The title 'fix(clerk-js): Respect proxyUrl and domain in non-browser environments' directly summarizes the main change: enabling clerk-js to respect proxyUrl and domain settings in non-browser environments, which aligns with the PR objectives and all file changes.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

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

📝 Coding Plan

Generate coding plan for human review comments

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

Tip

CodeRabbit can scan for known vulnerabilities in your dependencies using OSV Scanner.

OSV Scanner will automatically detect and report security vulnerabilities in your project's dependencies. No additional configuration is required.

jacekradko · 2026-03-17T14:23:06Z

+ if (typeof proxyUrl !== 'string') {
+ return errorThrower.throw('`proxyUrl` must be a string in non-browser environments.');
+ }
+
+ if (!isHttpOrHttps(proxyUrl)) {
+ errorThrower.throw('`proxyUrl` must be an absolute URL in non-browser environments.');
+ }


[nit] Just from a quick look at this, it feels weird to return the errorThrower.throw even though it presumably throws in one branch, and not in the other

true, this was to appease TS on L19 to narrow the type. Let me see if I can adjust

I figured it's static analysis related

jacekradko

Looks pretty safe

chriscanin

Looks good, tested on simulator and working as intended.

#8095) Co-authored-by: Jacek Radko <jacek@clerk.dev>

brkalow · 2026-03-17T03:16:19Z

Description

It's possible for non-browser environments to provide a domain or proxyUrl, but clerk-js currently ignores the provided values when not in a browser. This PR updates clerk-js so the provided value is now respected in non-browser environments.

The only caveat is that we cannot accept a function for the value in expo, as we are unable to provide the current base URL (window.location.href).

fixes AIE-644

Checklist

pnpm test runs as expected.
pnpm build runs as expected.
(If applicable) JSDoc comments have been added or updated for any package exports
(If applicable) Documentation has been updated

Type of change

Summary by CodeRabbit

New Features
- Support for providing proxy URLs and custom domains in non-browser environments.
Bug Fixes
- Native/runtime validation now enforces absolute HTTP(S) proxy URLs and rejects unsupported function-valued configurations, emitting warnings and graceful fallbacks.
Tests
- Added and expanded tests covering non-browser/native behavior for proxy URL and domain resolution.
Chores
- Bumped package patch versions via a changeset.

…ronments

vercel · 2026-03-17T03:16:25Z

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

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Mar 17, 2026 3:21pm

changeset-bot · 2026-03-17T03:16:28Z

🦋 Changeset detected

Latest commit: 51533d2

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

This PR includes changesets to release 21 packages

Name	Type
@clerk/clerk-js	Patch
@clerk/shared	Patch
@clerk/expo	Patch
@clerk/chrome-extension	Patch
@clerk/agent-toolkit	Patch
@clerk/astro	Patch
@clerk/backend	Patch
@clerk/expo-passkeys	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/hono	Patch
@clerk/localizations	Patch
@clerk/msw	Patch
@clerk/nextjs	Patch
@clerk/nuxt	Patch
@clerk/react-router	Patch
@clerk/react	Patch
@clerk/tanstack-react-start	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

pkg-pr-new · 2026-03-17T03:18:32Z

Open in StackBlitz

@clerk/agent-toolkit

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

@clerk/astro

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

@clerk/backend

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

@clerk/chrome-extension

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

@clerk/clerk-js

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

@clerk/dev-cli

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

@clerk/expo

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

@clerk/expo-passkeys

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

@clerk/express

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

@clerk/fastify

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

@clerk/hono

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

@clerk/localizations

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

@clerk/nextjs

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

@clerk/nuxt

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

@clerk/react

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

@clerk/react-router

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

@clerk/shared

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

@clerk/tanstack-react-start

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

@clerk/testing

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

@clerk/ui

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

@clerk/upgrade

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

@clerk/vue

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

commit: 51533d2

coderabbitai · 2026-03-17T03:21:35Z

📝 Walkthrough

Walkthrough

Adds a changeset and tests; treats function-valued domain and proxyUrl as unsupported in non-browser runtimes by logging warnings and returning empty string (clerk-js getters). Introduces assertValidProxyUrl (exported) which enforces native-only proxyUrl type and absolute HTTP(S) URLs and is invoked when creating/recreating the Expo Clerk instance. Adds warning helpers for function-valued properties and test cases covering non-browser baseUrl resolution and proxyUrl validation. No public API signatures were changed.

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.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
Title check	✅ Passed	The title 'fix(clerk-js): Respect proxyUrl and domain in non-browser environments' directly summarizes the main change: enabling clerk-js to respect proxyUrl and domain settings in non-browser environments, which aligns with the PR objectives and all file changes.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

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

📝 Coding Plan

Generate coding plan for human review comments

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

Tip

CodeRabbit can scan for known vulnerabilities in your dependencies using OSV Scanner.

OSV Scanner will automatically detect and report security vulnerabilities in your project's dependencies. No additional configuration is required.

jacekradko · 2026-03-17T14:23:06Z

+ if (typeof proxyUrl !== 'string') {
+ return errorThrower.throw('`proxyUrl` must be a string in non-browser environments.');
+ }
+
+ if (!isHttpOrHttps(proxyUrl)) {
+ errorThrower.throw('`proxyUrl` must be an absolute URL in non-browser environments.');
+ }


[nit] Just from a quick look at this, it feels weird to return the errorThrower.throw even though it presumably throws in one branch, and not in the other

true, this was to appease TS on L19 to narrow the type. Let me see if I can adjust

I figured it's static analysis related

jacekradko

Looks pretty safe

chriscanin

Looks good, tested on simulator and working as intended.

#8095) Co-authored-by: Jacek Radko <jacek@clerk.dev>

brkalow added 2 commits March 16, 2026 22:03

Ensure proxyUrl is respected when clerk is loaded in non-browser envi…
870b2b9
…ronments

add stripeScheme()
3219675

github-actionsBot added clerk-js expo labels Mar 17, 2026

jacekradko reviewed Mar 17, 2026
View reviewed changes

jacekradko approved these changes Mar 17, 2026
View reviewed changes

improve type narrowing using assert()
2ee7fdb

vercelBotdeployed to Preview March 17, 2026 15:02 View deployment

Merge branch 'main' into brk.fix/proxy-url-non-browser
51533d2

vercelBotdeployed to Preview March 17, 2026 15:21 View deployment

chriscanin approved these changes Mar 17, 2026
View reviewed changes

brkalow enabled auto-merge (squash) March 17, 2026 16:12

brkalow merged commit b9cb6e5 into mainMar 17, 2026
73 of 74 checks passed

brkalow deleted the brk.fix/proxy-url-non-browser branch March 17, 2026 16:19

clerk-cookie mentioned this pull request Mar 17, 2026
ci(repo): Version packages #8041
Merged

wobsoriano pushed a commit that referenced this pull request Mar 26, 2026
fix(clerk-js): Respect proxyUrl and domain in non-browser environments (
17a5a69
#8095) Co-authored-by: Jacek Radko <jacek@clerk.dev>

brkalow added 2 commits March 16, 2026 22:03

Ensure proxyUrl is respected when clerk is loaded in non-browser envi…
870b2b9
…ronments

add stripeScheme()
3219675

github-actionsBot added clerk-js expo labels Mar 17, 2026

jacekradko reviewed Mar 17, 2026
View reviewed changes

jacekradko approved these changes Mar 17, 2026
View reviewed changes

improve type narrowing using assert()
2ee7fdb

vercelBotdeployed to Preview March 17, 2026 15:02 View deployment

Merge branch 'main' into brk.fix/proxy-url-non-browser
51533d2

vercelBotdeployed to Preview March 17, 2026 15:21 View deployment

chriscanin approved these changes Mar 17, 2026
View reviewed changes

brkalow enabled auto-merge (squash) March 17, 2026 16:12

brkalow merged commit b9cb6e5 into mainMar 17, 2026
73 of 74 checks passed

brkalow deleted the brk.fix/proxy-url-non-browser branch March 17, 2026 16:19

clerk-cookie mentioned this pull request Mar 17, 2026
ci(repo): Version packages #8041
Merged

wobsoriano pushed a commit that referenced this pull request Mar 26, 2026
fix(clerk-js): Respect proxyUrl and domain in non-browser environments (
17a5a69
#8095) Co-authored-by: Jacek Radko <jacek@clerk.dev>

brkalow added 2 commits March 16, 2026 22:03

Ensure proxyUrl is respected when clerk is loaded in non-browser envi…
870b2b9
…ronments

add stripeScheme()
3219675

github-actionsBot added clerk-js expo labels Mar 17, 2026

jacekradko reviewed Mar 17, 2026
View reviewed changes

jacekradko approved these changes Mar 17, 2026
View reviewed changes

improve type narrowing using assert()
2ee7fdb

vercelBotdeployed to Preview March 17, 2026 15:02 View deployment

Merge branch 'main' into brk.fix/proxy-url-non-browser
51533d2

vercelBotdeployed to Preview March 17, 2026 15:21 View deployment

chriscanin approved these changes Mar 17, 2026
View reviewed changes

brkalow enabled auto-merge (squash) March 17, 2026 16:12

brkalow merged commit b9cb6e5 into mainMar 17, 2026
73 of 74 checks passed

brkalow deleted the brk.fix/proxy-url-non-browser branch March 17, 2026 16:19

clerk-cookie mentioned this pull request Mar 17, 2026
ci(repo): Version packages #8041
Merged

wobsoriano pushed a commit that referenced this pull request Mar 26, 2026
fix(clerk-js): Respect proxyUrl and domain in non-browser environments (
17a5a69
#8095) Co-authored-by: Jacek Radko <jacek@clerk.dev>

brkalow added 2 commits March 16, 2026 22:03

Ensure proxyUrl is respected when clerk is loaded in non-browser envi…
870b2b9
…ronments

add stripeScheme()
3219675

github-actionsBot added clerk-js expo labels Mar 17, 2026

jacekradko reviewed Mar 17, 2026
View reviewed changes

jacekradko approved these changes Mar 17, 2026
View reviewed changes

improve type narrowing using assert()
2ee7fdb

vercelBotdeployed to Preview March 17, 2026 15:02 View deployment

Merge branch 'main' into brk.fix/proxy-url-non-browser
51533d2

vercelBotdeployed to Preview March 17, 2026 15:21 View deployment

chriscanin approved these changes Mar 17, 2026
View reviewed changes

brkalow enabled auto-merge (squash) March 17, 2026 16:12

brkalow merged commit b9cb6e5 into mainMar 17, 2026
73 of 74 checks passed

brkalow deleted the brk.fix/proxy-url-non-browser branch March 17, 2026 16:19

clerk-cookie mentioned this pull request Mar 17, 2026
ci(repo): Version packages #8041
Merged

wobsoriano pushed a commit that referenced this pull request Mar 26, 2026
fix(clerk-js): Respect proxyUrl and domain in non-browser environments (
17a5a69
#8095) Co-authored-by: Jacek Radko <jacek@clerk.dev>

brkalow added 2 commits March 16, 2026 22:03

Ensure proxyUrl is respected when clerk is loaded in non-browser envi…
870b2b9
…ronments

add stripeScheme()
3219675

github-actionsBot added clerk-js expo labels Mar 17, 2026

jacekradko reviewed Mar 17, 2026
View reviewed changes

jacekradko approved these changes Mar 17, 2026
View reviewed changes

improve type narrowing using assert()
2ee7fdb

vercelBotdeployed to Preview March 17, 2026 15:02 View deployment

Merge branch 'main' into brk.fix/proxy-url-non-browser
51533d2

vercelBotdeployed to Preview March 17, 2026 15:21 View deployment

chriscanin approved these changes Mar 17, 2026
View reviewed changes

brkalow enabled auto-merge (squash) March 17, 2026 16:12

brkalow merged commit b9cb6e5 into mainMar 17, 2026
73 of 74 checks passed

brkalow deleted the brk.fix/proxy-url-non-browser branch March 17, 2026 16:19

clerk-cookie mentioned this pull request Mar 17, 2026
ci(repo): Version packages #8041
Merged

wobsoriano pushed a commit that referenced this pull request Mar 26, 2026
fix(clerk-js): Respect proxyUrl and domain in non-browser environments (
17a5a69
#8095) Co-authored-by: Jacek Radko <jacek@clerk.dev>

brkalow added 2 commits March 16, 2026 22:03

Ensure proxyUrl is respected when clerk is loaded in non-browser envi…
870b2b9
…ronments

add stripeScheme()
3219675

github-actionsBot added clerk-js expo labels Mar 17, 2026

jacekradko reviewed Mar 17, 2026
View reviewed changes

jacekradko approved these changes Mar 17, 2026
View reviewed changes

improve type narrowing using assert()
2ee7fdb

vercelBotdeployed to Preview March 17, 2026 15:02 View deployment

Merge branch 'main' into brk.fix/proxy-url-non-browser
51533d2

vercelBotdeployed to Preview March 17, 2026 15:21 View deployment

chriscanin approved these changes Mar 17, 2026
View reviewed changes

brkalow enabled auto-merge (squash) March 17, 2026 16:12

brkalow merged commit b9cb6e5 into mainMar 17, 2026
73 of 74 checks passed

brkalow deleted the brk.fix/proxy-url-non-browser branch March 17, 2026 16:19

clerk-cookie mentioned this pull request Mar 17, 2026
ci(repo): Version packages #8041
Merged

wobsoriano pushed a commit that referenced this pull request Mar 26, 2026
fix(clerk-js): Respect proxyUrl and domain in non-browser environments (
17a5a69
#8095) Co-authored-by: Jacek Radko <jacek@clerk.dev>

brkalow added 2 commits March 16, 2026 22:03

Ensure proxyUrl is respected when clerk is loaded in non-browser envi…
870b2b9
…ronments

add stripeScheme()
3219675

github-actionsBot added clerk-js expo labels Mar 17, 2026

jacekradko reviewed Mar 17, 2026
View reviewed changes

jacekradko approved these changes Mar 17, 2026
View reviewed changes

improve type narrowing using assert()
2ee7fdb

vercelBotdeployed to Preview March 17, 2026 15:02 View deployment

Merge branch 'main' into brk.fix/proxy-url-non-browser
51533d2

vercelBotdeployed to Preview March 17, 2026 15:21 View deployment

chriscanin approved these changes Mar 17, 2026
View reviewed changes

brkalow enabled auto-merge (squash) March 17, 2026 16:12

brkalow merged commit b9cb6e5 into mainMar 17, 2026
73 of 74 checks passed

brkalow deleted the brk.fix/proxy-url-non-browser branch March 17, 2026 16:19

clerk-cookie mentioned this pull request Mar 17, 2026
ci(repo): Version packages #8041
Merged

wobsoriano pushed a commit that referenced this pull request Mar 26, 2026
fix(clerk-js): Respect proxyUrl and domain in non-browser environments (
17a5a69
#8095) Co-authored-by: Jacek Radko <jacek@clerk.dev>

brkalow added 2 commits March 16, 2026 22:03

Ensure proxyUrl is respected when clerk is loaded in non-browser envi…
870b2b9
…ronments

add stripeScheme()
3219675

github-actionsBot added clerk-js expo labels Mar 17, 2026

jacekradko reviewed Mar 17, 2026
View reviewed changes

jacekradko approved these changes Mar 17, 2026
View reviewed changes

improve type narrowing using assert()
2ee7fdb

vercelBotdeployed to Preview March 17, 2026 15:02 View deployment

Merge branch 'main' into brk.fix/proxy-url-non-browser
51533d2

vercelBotdeployed to Preview March 17, 2026 15:21 View deployment

chriscanin approved these changes Mar 17, 2026
View reviewed changes

brkalow enabled auto-merge (squash) March 17, 2026 16:12

brkalow merged commit b9cb6e5 into mainMar 17, 2026
73 of 74 checks passed

brkalow deleted the brk.fix/proxy-url-non-browser branch March 17, 2026 16:19

clerk-cookie mentioned this pull request Mar 17, 2026
ci(repo): Version packages #8041
Merged

wobsoriano pushed a commit that referenced this pull request Mar 26, 2026
fix(clerk-js): Respect proxyUrl and domain in non-browser environments (
17a5a69
#8095) Co-authored-by: Jacek Radko <jacek@clerk.dev>

Uh oh!

Conversation

brkalow commented Mar 17, 2026• edited by chriscanin Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Checklist

Type of change

Summary by CodeRabbit

Uh oh!

vercelBot commented Mar 17, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-botBot commented Mar 17, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

pkg-pr-newBot commented Mar 17, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitaiBot commented Mar 17, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

❌ Failed checks (1 warning)

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

jacekradko left a comment

Choose a reason for hiding this comment

Uh oh!

chriscanin left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

brkalow commented Mar 17, 2026• edited by chriscanin Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Checklist

Type of change

Summary by CodeRabbit

Uh oh!

vercelBot commented Mar 17, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-botBot commented Mar 17, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

pkg-pr-newBot commented Mar 17, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitaiBot commented Mar 17, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

❌ Failed checks (1 warning)

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

jacekradko left a comment

Choose a reason for hiding this comment

Uh oh!

chriscanin left a comment

Choose a reason for hiding this comment

brkalow commented Mar 17, 2026•
edited by chriscanin
Loading

vercelBot commented Mar 17, 2026•
edited
Loading

changeset-botBot commented Mar 17, 2026•
edited
Loading

pkg-pr-newBot commented Mar 17, 2026•
edited
Loading

coderabbitaiBot commented Mar 17, 2026•
edited
Loading

brkalow commented Mar 17, 2026•
edited by chriscanin
Loading

vercelBot commented Mar 17, 2026•
edited
Loading

changeset-botBot commented Mar 17, 2026•
edited
Loading

pkg-pr-newBot commented Mar 17, 2026•
edited
Loading

coderabbitaiBot commented Mar 17, 2026•
edited
Loading

brkalow commented Mar 17, 2026•
edited by chriscanin
Loading

vercelBot commented Mar 17, 2026•
edited
Loading

changeset-botBot commented Mar 17, 2026•
edited
Loading

pkg-pr-newBot commented Mar 17, 2026•
edited
Loading

coderabbitaiBot commented Mar 17, 2026•
edited
Loading