feat(*): Rename setActive to setSelected

.changeset/rename-setactive-to-setselected.md

@@ -0,0 +1,35 @@
+---
+"@clerk/clerk-js": major
+"@clerk/shared": major
+"@clerk/react": major
+"@clerk/nextjs": major
+"@clerk/vue": major
+"@clerk/expo": major
+"@clerk/ui": major
+"@clerk/testing": major
+"@clerk/upgrade": patch
+---
+
+Rename `setActive` to `setSelected`
+
+**BREAKING CHANGE:** The `setActive` method has been renamed to `setSelected` to better reflect its behavior with pending sessions.
+
+### Method Rename
+- `clerk.setActive()` → `clerk.setSelected()`
+- Hooks now return `setSelected` instead of `setActive`:
+  - `useSignIn()`
+  - `useSignUp()`
+  - `useSessionList()`
+  - `useOrganizationList()`
+
+### Type Renames
+- `SetActive` → `SetSelected`
+- `SetActiveParams` → `SetSelectedParams`
+- `SetActiveNavigate` → `SetSelectedNavigate`
+- `SetActiveHook` → `SetSelectedHook`
+
+### Migration
+Use the `@clerk/upgrade` codemod for automatic migration:
+```bash
+npx @clerk/upgrade
+```

integration/tests/session-token-cache/multi-session.test.ts

@@ -117,7 +117,7 @@ testAgainstRunningApps({ withEnv: [appConfigs.envs.withSessionTasks] })(
               password: password,
             });
 
-            await clerk.setActive({
+            await clerk.setSelected({
               session: signIn.createdSessionId,
             });
 
@@ -191,10 +191,10 @@ testAgainstRunningApps({ withEnv: [appConfigs.envs.withSessionTasks] })(
         async ({ user1SessionId, user2SessionId }) => {
           const clerk = (window as any).Clerk;
 
-          await clerk.setActive({ session: user1SessionId });
+          await clerk.setSelected({ session: user1SessionId });
           const user1Token = await clerk.session?.getToken();
 
-          await clerk.setActive({ session: user2SessionId });
+          await clerk.setSelected({ session: user2SessionId });
           const user2Token = await clerk.session?.getToken();
 
           return {