@brendanbank/atrium-host-bundle-utils 0.17.0 → 0.19.0

package/README.md

@@ -87,9 +87,9 @@ function App() {
 }
 ```
 
-The hooks fetch atrium's fixed same-origin `/users/me/context`
-endpoint — no path is configurable, since a host bundle loads inside
-atrium's SPA and hits the same origin. `<AtriumProvider>` reads from
+The hooks fetch atrium's fixed same-origin `/api/users/me/context`
+endpoint (atrium >= 0.19) — no path is configurable, since a host
+bundle loads inside atrium's SPA and hits the same origin. `<AtriumProvider>` reads from
 your existing `<QueryClientProvider>` by default — no second
 QueryClient. Pass `client={hostQueryClient}` to wrap one inline; pass
 `fetchUserContext={...}` to inject a custom fetcher (useful for tests
@@ -97,8 +97,8 @@ or hosts that want axios-shaped retry).
 
 ## Versioning
 
-The package version tracks atrium's image version. Pin `^0.17` for
-"compatible with atrium 0.17.x"; bump together with the atrium image
+The package version tracks atrium's image version. Pin `^0.19` for
+"compatible with atrium 0.19.x"; bump together with the atrium image
 to pick up new registry slots and SDK helpers.
 
 ## See also

package/dist/react/index.d.ts

@@ -2,27 +2,29 @@
  * React hooks + provider for atrium host bundles.
  *
  * One TanStack Query subscription serves the whole host tree:
- * `useMe()` fetches `/users/me/context` once and shares the result
- * with every `usePerm()`, `useRole()`, and `useUserContext()` caller.
- *
- * The endpoint path is fixed by atrium — it's mounted at the SPA root
- * by `app.include_router(me_context_router)` and served from the same
- * origin as the bundle. There's no `apiBase` prop because there's
- * nothing for the host to configure: a host bundle that loads inside
- * atrium's SPA fetches a same-origin relative path. Hosts that want
- * to layer their own retry / headers / mock can pass `fetchUserContext`.
- *
- * The hooks reuse the host's enclosing `<QueryClientProvider>` if one
- * is already mounted; pass `client={hostQueryClient}` to
+ * `useMe()` fetches `/api/users/me/context` once and shares the
+ * result with every `usePerm()`, `useRole()`, and `useUserContext()`
+ * caller.
+ *
+ * The endpoint path is fixed by atrium — it's mounted under
+ * `/api/...` (atrium >= 0.19) and served from the same origin as the
+ * bundle. There's no `apiBase` prop because there's nothing for the
+ * host to configure: a host bundle that loads inside atrium's SPA
+ * fetches a same-origin relative path. Hosts that want to layer
+ * their own retry / headers / mock can pass `fetchUserContext`.
+ *
+ * The hooks reuse the host's enclosing `<QueryClientProvider>` if
+ * one is already mounted; pass `client={hostQueryClient}` to
  * `<AtriumProvider>` only if you want this provider to wrap the
  * QueryClient too. Two QueryClients (atrium's + the host's) is the
- * intended state — atrium clears its cache on logout via `qc.clear()`,
- * and a shared client would lose host queries the user still wants.
+ * intended state — atrium clears its cache on logout via
+ * `qc.clear()`, and a shared client would lose host queries the user
+ * still wants.
  */
 import { type ReactNode } from 'react';
 import { type QueryClient, type UseQueryResult } from '@tanstack/react-query';
-import type { UserContext } from '@brendanbank/atrium-host-types';
-export type { UserContext } from '@brendanbank/atrium-host-types';
+import type { AtriumUserChangeDetail, UserContext } from '@brendanbank/atrium-host-types';
+export type { AtriumUserChangeDetail, UserContext, } from '@brendanbank/atrium-host-types';
 export { __atrium_t__ } from '../i18n';
 interface AtriumContextValue {
     fetchUserContext: () => Promise<UserContext | null>;
@@ -33,10 +35,10 @@ export interface AtriumProviderProps {
      *  inherit the caller's enclosing one. Use this only when the host
      *  hasn't already set up its own provider. */
     client?: QueryClient;
-    /** Override the fetcher for `/users/me/context`. Useful for tests
-     *  and for hosts that want to layer an axios interceptor or extra
-     *  headers on top. The default uses `fetch` with `credentials:
-     *  'include'`. */
+    /** Override the fetcher for `/api/users/me/context`. Useful for
+     *  tests and for hosts that want to layer an axios interceptor or
+     *  extra headers on top. The default uses `fetch` with
+     *  `credentials: 'include'`. */
     fetchUserContext?: () => Promise<UserContext | null>;
     children: ReactNode;
 }
@@ -198,4 +200,47 @@ export declare function useAtriumNavigate(): (href: string, opts?: {
  *  `window.location` fresh. Production code never calls this — the
  *  cache is updated by the event subscription. */
 export declare function __resetAtriumLocationCacheForTests(): void;
+/** Subscribe to atrium's identity transitions from inside a host
+ *  bundle's React tree. Returns the most recent `atrium:userchange`
+ *  detail — `{previous, current, nonce}` — or a zeroed sentinel
+ *  (`{previous: null, current: null, nonce: 0}`) before any event has
+ *  fired. The hook does NOT report the initial signed-in state on
+ *  mount; use `useUserContext()` for that.
+ *
+ *  Bridges the `atrium:userchange` CustomEvent atrium dispatches on
+ *  `window` through `useSyncExternalStore`, so multiple subscribers in
+ *  the same tree share one event listener and the snapshot is
+ *  referentially stable when nothing has changed.
+ *
+ *  The canonical use is wiping a host's own QueryClient when the user
+ *  swaps — without it, user A's host cache renders for user B until
+ *  staleness forces a refetch:
+ *
+ *  ```tsx
+ *  function HostCacheGuard({ client }: { client: QueryClient }) {
+ *    const { nonce } = useAtriumUser();
+ *    useEffect(() => {
+ *      // nonce > 0 means at least one transition has fired; on the
+ *      // first paint we skip (the host already loaded against the
+ *      // current user).
+ *      if (nonce > 0) client.clear();
+ *    }, [nonce, client]);
+ *    return null;
+ *  }
+ *  ```
+ *
+ *  Hosts that don't use React (or want to clear the cache from outside
+ *  any component) can subscribe directly:
+ *  `window.addEventListener('atrium:userchange', () => client.clear())`.
+ *
+ *  Available on atrium 0.18+. On older atrium images the event is
+ *  never dispatched, so the hook stays at the zeroed sentinel — host
+ *  bundles that need to support pre-0.18 atrium can read
+ *  `window.__ATRIUM_VERSION__` and fall back to the in-component
+ *  watch-`useUserContext` workaround. */
+export declare function useAtriumUser(): AtriumUserChangeDetail;
+/** Test-only: drop the cached snapshot so the next `getSnapshot`
+ *  returns the zeroed sentinel. Production code never calls this — the
+ *  cache is updated by the event subscription. */
+export declare function __resetAtriumUserCacheForTests(): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAElE,YAAY,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,UAAU,kBAAkB;IAC1B,gBAAgB,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CACrD;AAmBD,MAAM,WAAW,mBAAmB;IAClC;;;kDAG8C;IAC9C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;sBAGkB;IAClB,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACrD,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;qCAGqC;AACrC,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,gBAAgB,EAChB,QAAQ,GACT,EAAE,mBAAmB,2MAYrB;AAED;;iEAEiE;AACjE,eAAO,MAAM,YAAY,2BAA4B,CAAC;AAmBtD;;;;;;;;8BAQ8B;AAC9B,wBAAgB,KAAK,IAAI,cAAc,CAAC,WAAW,GAAG,IAAI,CAAC,CAQ1D;AAED;;iBAEiB;AACjB,wBAAgB,cAAc,IAAI,cAAc,CAAC,WAAW,GAAG,IAAI,CAAC,CAEnE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,IAAI,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAMnD;AAED;sEACsE;AACtE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG7C;AAED;;;qBAGqB;AACrB,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;uCAQmC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAoEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aA6Ca;AACb,wBAAgB,iBAAiB,IAAI,cAAc,CAMlD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qEAyCqE;AACrE,wBAAgB,iBAAiB,IAAI,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,KACzB,IAAI,CAeR;AAED;;kDAEkD;AAClD,wBAAgB,kCAAkC,IAAI,IAAI,CAEzD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EACV,sBAAsB,EACtB,WAAW,EACZ,MAAM,gCAAgC,CAAC;AAExC,YAAY,EACV,sBAAsB,EACtB,WAAW,GACZ,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,UAAU,kBAAkB;IAC1B,gBAAgB,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CACrD;AAmBD,MAAM,WAAW,mBAAmB;IAClC;;;kDAG8C;IAC9C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;oCAGgC;IAChC,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACrD,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;qCAGqC;AACrC,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,gBAAgB,EAChB,QAAQ,GACT,EAAE,mBAAmB,2MAYrB;AAED;;iEAEiE;AACjE,eAAO,MAAM,YAAY,2BAA4B,CAAC;AAmBtD;;;;;;;;8BAQ8B;AAC9B,wBAAgB,KAAK,IAAI,cAAc,CAAC,WAAW,GAAG,IAAI,CAAC,CAQ1D;AAED;;iBAEiB;AACjB,wBAAgB,cAAc,IAAI,cAAc,CAAC,WAAW,GAAG,IAAI,CAAC,CAEnE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,IAAI,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAMnD;AAED;sEACsE;AACtE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG7C;AAED;;;qBAGqB;AACrB,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;uCAQmC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAoEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aA6Ca;AACb,wBAAgB,iBAAiB,IAAI,cAAc,CAMlD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qEAyCqE;AACrE,wBAAgB,iBAAiB,IAAI,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,KACzB,IAAI,CAeR;AAED;;kDAEkD;AAClD,wBAAgB,kCAAkC,IAAI,IAAI,CAEzD;AAkDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yCAqCyC;AACzC,wBAAgB,aAAa,IAAI,sBAAsB,CAMtD;AAED;;kDAEkD;AAClD,wBAAgB,8BAA8B,IAAI,IAAI,CAErD"}

package/dist/react/index.js

@@ -4,27 +4,29 @@
  * React hooks + provider for atrium host bundles.
  *
  * One TanStack Query subscription serves the whole host tree:
- * `useMe()` fetches `/users/me/context` once and shares the result
- * with every `usePerm()`, `useRole()`, and `useUserContext()` caller.
+ * `useMe()` fetches `/api/users/me/context` once and shares the
+ * result with every `usePerm()`, `useRole()`, and `useUserContext()`
+ * caller.
  *
- * The endpoint path is fixed by atrium — it's mounted at the SPA root
- * by `app.include_router(me_context_router)` and served from the same
- * origin as the bundle. There's no `apiBase` prop because there's
- * nothing for the host to configure: a host bundle that loads inside
- * atrium's SPA fetches a same-origin relative path. Hosts that want
- * to layer their own retry / headers / mock can pass `fetchUserContext`.
+ * The endpoint path is fixed by atrium — it's mounted under
+ * `/api/...` (atrium >= 0.19) and served from the same origin as the
+ * bundle. There's no `apiBase` prop because there's nothing for the
+ * host to configure: a host bundle that loads inside atrium's SPA
+ * fetches a same-origin relative path. Hosts that want to layer
+ * their own retry / headers / mock can pass `fetchUserContext`.
  *
- * The hooks reuse the host's enclosing `<QueryClientProvider>` if one
- * is already mounted; pass `client={hostQueryClient}` to
+ * The hooks reuse the host's enclosing `<QueryClientProvider>` if
+ * one is already mounted; pass `client={hostQueryClient}` to
  * `<AtriumProvider>` only if you want this provider to wrap the
  * QueryClient too. Two QueryClients (atrium's + the host's) is the
- * intended state — atrium clears its cache on logout via `qc.clear()`,
- * and a shared client would lose host queries the user still wants.
+ * intended state — atrium clears its cache on logout via
+ * `qc.clear()`, and a shared client would lose host queries the user
+ * still wants.
  */
 import { createContext, createElement, useCallback, useContext, useMemo, useSyncExternalStore, } from 'react';
 import { QueryClientProvider, useQuery, } from '@tanstack/react-query';
 export { __atrium_t__ } from '../i18n';
-const ME_CONTEXT_PATH = '/users/me/context';
+const ME_CONTEXT_PATH = '/api/users/me/context';
 async function defaultFetchUserContext() {
     const res = await fetch(ME_CONTEXT_PATH, {
         credentials: 'include',
@@ -296,4 +298,89 @@ export function useAtriumNavigate() {
 export function __resetAtriumLocationCacheForTests() {
     cachedLocation = null;
 }
+// ---------------------------------------------------------------------------
+// Identity transitions — `atrium:userchange`
+// ---------------------------------------------------------------------------
+const ATRIUM_USERCHANGE_EVENT = 'atrium:userchange';
+const NO_USERCHANGE = {
+    previous: null,
+    current: null,
+    nonce: 0,
+};
+// Module-level cache so `useSyncExternalStore.getSnapshot` returns a
+// referentially-stable object across renders. Updated only when an
+// `atrium:userchange` event lands; `null` until the first event.
+let cachedUserChange = null;
+function getUserChangeSnapshot() {
+    return cachedUserChange ?? NO_USERCHANGE;
+}
+function getServerUserChangeSnapshot() {
+    return NO_USERCHANGE;
+}
+function subscribeUserChange(onChange) {
+    if (typeof window === 'undefined')
+        return () => { };
+    const handler = (e) => {
+        const detail = e.detail;
+        if (detail &&
+            (detail.previous === null || typeof detail.previous === 'number') &&
+            (detail.current === null || typeof detail.current === 'number')) {
+            cachedUserChange = {
+                previous: detail.previous,
+                current: detail.current,
+                nonce: typeof detail.nonce === 'number' ? detail.nonce : 0,
+            };
+            onChange();
+        }
+    };
+    window.addEventListener(ATRIUM_USERCHANGE_EVENT, handler);
+    return () => window.removeEventListener(ATRIUM_USERCHANGE_EVENT, handler);
+}
+/** Subscribe to atrium's identity transitions from inside a host
+ *  bundle's React tree. Returns the most recent `atrium:userchange`
+ *  detail — `{previous, current, nonce}` — or a zeroed sentinel
+ *  (`{previous: null, current: null, nonce: 0}`) before any event has
+ *  fired. The hook does NOT report the initial signed-in state on
+ *  mount; use `useUserContext()` for that.
+ *
+ *  Bridges the `atrium:userchange` CustomEvent atrium dispatches on
+ *  `window` through `useSyncExternalStore`, so multiple subscribers in
+ *  the same tree share one event listener and the snapshot is
+ *  referentially stable when nothing has changed.
+ *
+ *  The canonical use is wiping a host's own QueryClient when the user
+ *  swaps — without it, user A's host cache renders for user B until
+ *  staleness forces a refetch:
+ *
+ *  ```tsx
+ *  function HostCacheGuard({ client }: { client: QueryClient }) {
+ *    const { nonce } = useAtriumUser();
+ *    useEffect(() => {
+ *      // nonce > 0 means at least one transition has fired; on the
+ *      // first paint we skip (the host already loaded against the
+ *      // current user).
+ *      if (nonce > 0) client.clear();
+ *    }, [nonce, client]);
+ *    return null;
+ *  }
+ *  ```
+ *
+ *  Hosts that don't use React (or want to clear the cache from outside
+ *  any component) can subscribe directly:
+ *  `window.addEventListener('atrium:userchange', () => client.clear())`.
+ *
+ *  Available on atrium 0.18+. On older atrium images the event is
+ *  never dispatched, so the hook stays at the zeroed sentinel — host
+ *  bundles that need to support pre-0.18 atrium can read
+ *  `window.__ATRIUM_VERSION__` and fall back to the in-component
+ *  watch-`useUserContext` workaround. */
+export function useAtriumUser() {
+    return useSyncExternalStore(subscribeUserChange, getUserChangeSnapshot, getServerUserChangeSnapshot);
+}
+/** Test-only: drop the cached snapshot so the next `getSnapshot`
+ *  returns the zeroed sentinel. Production code never calls this — the
+ *  cache is updated by the event subscription. */
+export function __resetAtriumUserCacheForTests() {
+    cachedUserChange = null;
+}
 //# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@brendanbank/atrium-host-bundle-utils",
-  "version": "0.17.0",
-  "description": "Runtime helpers, Vite preset, and React hooks for atrium host bundles. Wraps the dual-tree mount pattern, the host-bundle Vite library config, and the /users/me/context hook so a host's main.tsx is ~10 lines of registration calls.",
+  "version": "0.19.0",
+  "description": "Runtime helpers, Vite preset, and React hooks for atrium host bundles. Wraps the dual-tree mount pattern, the host-bundle Vite library config, and the /api/users/me/context hook so a host's main.tsx is ~10 lines of registration calls.",
   "license": "BSD-2-Clause",
   "type": "module",
   "files": [
@@ -25,7 +25,7 @@
     }
   },
   "dependencies": {
-    "@brendanbank/atrium-host-types": "0.17.0"
+    "@brendanbank/atrium-host-types": "0.19.0"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.0.0",