fix(clerk-js): Fix broken transitive state when switching organization

[Ephem]

Description

This PR fixes a bug that was introduced when we migrated to useSyncExternalStore. The bug is that when switching orgs and navigating to a new page, the current page re-rendered with the new organization before the navigation, which can cause problems.

Alternative solution: #7815

Compared to that solution, this touches more code, but is scoped to only block updateClient from emitting for the specific setActive call that triggered it, it does not block all updateClient calls to keep the splash radius as small as possible.

We want to refactor this more heavily to have better guarantees, but now is not the time.

I went with a version where a __internal_touch() does not call updateClient and instead returns a client resource, expecting the caller to then call updateClient with the result. updateClient now takes an option to skip emitting.

If we want to refactor further in the future, this approach let's us move the updateClient call around, and also do things with the intermediary client if necessary.

Another version would be to thread a skipUiEmit option all the way through the base resource calls, but in total that's 6 stacks deep and couples UI concerns to resources in a way I did not like.

I have verified this fix works in the dashboard.

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

• 🐛 Bug fix
• 🌟 New feature
• 🔨 Breaking change
• 📖 Refactoring / dependency upgrade / documentation
• other:

Summary by CodeRabbit

• New Features

  • Added Organization switcher and User switcher pages with an "Emission log" view showing navigation/state entries.

• Bug Fixes

  • Improved authentication state synchronization to avoid premature emissions during organization or user switches and navigations.

• Tests

  • Added integration tests validating emission behavior when switching organizations and users across navigation.

• Chores

  • Recorded a patch release entry to trigger a version update.

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Feb 11, 2026 8:40pm

[changeset-bot]

🦋 Changeset detected

Latest commit: d593212

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

This PR includes changesets to release 3 packages

Name	Type
@clerk/clerk-js	Patch
@clerk/chrome-extension	Patch
@clerk/expo	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

[coderabbitai]

📝 Walkthrough

Walkthrough

This pull request adds a skip-emission mechanism to Clerk by extending updateClient with an __internal_dangerouslySkipEmit option, introduces Session.__internal_touch for server-side touch requests that can return a piggybacked ClientResource without updating the client, and adds skipUpdateClient to fetch options. The setActive flow is refactored to perform navigation-aware, batched updates that may call the new internal touch path. New Next.js pages, layouts, integration tests for transitive state, unit tests, and a changeset for a patch release are included.

🚥 Pre-merge checks | ✅ 4 | ❌ 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 (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'fix(clerk-js): Fix broken transitive state when switching organization' directly matches the core change: fixing transitive state issues during organization switching.
Linked Issues check	✅ Passed	The PR implements all coding requirements from USER-4666: prevents org-change emissions before undefined emissions, preserves transitive state during org switches via __internal_touch, and provides comprehensive tests validating the fix.
Out of Scope Changes check	✅ Passed	All code changes are directly scoped to fixing transitive state: internal touch method, emission skipping mechanics, integration tests, and bundle size update are all necessary for the fix.
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.}

---

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

[pkg-pr-new]

Open in StackBlitz

@clerk/agent-toolkit

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

@clerk/astro

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

@clerk/backend

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

@clerk/chrome-extension

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

@clerk/clerk-js

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

@clerk/dev-cli

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

@clerk/expo

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

@clerk/expo-passkeys

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

@clerk/express

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

@clerk/fastify

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

@clerk/hono

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

@clerk/localizations

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

@clerk/nextjs

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

@clerk/nuxt

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

@clerk/react

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

@clerk/react-router

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

@clerk/shared

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

@clerk/tanstack-react-start

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

@clerk/testing

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

@clerk/ui

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

@clerk/upgrade

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

@clerk/vue

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

commit: d593212