@pylonsync/react 0.3.140 → 0.3.144

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.3.140",
+  "version": "0.3.144",
   "type": "module",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -12,8 +12,8 @@
     "check": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@pylonsync/sdk": "0.3.140",
-    "@pylonsync/sync": "0.3.140"
+    "@pylonsync/sdk": "0.3.144",
+    "@pylonsync/sync": "0.3.144"
   },
   "peerDependencies": {
     "react": ">=19.0.0"

package/src/useSession.ts

@@ -14,9 +14,22 @@ export interface UseSessionReturn {
   isAdmin: boolean;
   isAuthenticated: boolean;
   /**
-   * Force a refresh of the cached session. Call after sign-in, sign-out,
-   * or `/api/auth/select-org` so the UI and sync engine pick up the
-   * change before the next pull/reconnect.
+   * Switch the active tenant. POSTs to /api/auth/select-org, verifies
+   * membership server-side, resets the local replica so stale rows
+   * from the previous tenant disappear, and refreshes the cached
+   * session — all in one await. Throws (with `.code`/`.status`) on
+   * NOT_A_MEMBER and other server errors.
+   */
+  selectOrg: (orgId: string) => Promise<void>;
+  /** Drop the active tenant (back to no-org state). */
+  clearOrg: () => Promise<void>;
+  /** Revoke the current session server-side and refresh. */
+  signOut: () => Promise<void>;
+  /**
+   * Escape hatch — refresh the cached session without mutating it.
+   * Most apps shouldn't need this; the helpers above already include
+   * a refresh. Useful when app code calls /api/auth/* via its own
+   * client and needs the engine to observe the change.
    */
   refresh: () => Promise<void>;
 }
@@ -26,9 +39,10 @@ export interface UseSessionReturn {
  *
  * The engine fetches `/api/auth/me` on start and on token flips, caches
  * the result, and notifies the store on change — so this hook is
- * purely a reader. Mutations (login/logout/select-org) are still the
- * caller's responsibility; after them, invoke `refresh()` (or
- * `engine.notifySessionChanged()`) to pull the new session immediately.
+ * purely a reader. The exposed helpers (selectOrg, clearOrg, signOut)
+ * combine the server fetch + cache refresh + replica reset into one
+ * call so app code doesn't need to remember the manual
+ * `notifySessionChanged()` step after every auth mutation.
  */
 export function useSession(sync: SyncEngine): UseSessionReturn {
   const session = useSyncExternalStore(
@@ -68,6 +82,9 @@ export function useSession(sync: SyncEngine): UseSessionReturn {
     tenantId: session.tenantId,
     isAdmin: session.isAdmin,
     isAuthenticated: session.userId != null,
+    selectOrg: (orgId: string) => sync.selectOrg(orgId),
+    clearOrg: () => sync.clearOrg(),
+    signOut: () => sync.signOut(),
     refresh: () => sync.notifySessionChanged(),
   };
 }