@oxyhq/services 28.0.0 → 29.0.0

package/lib/module/ui/runtime/createOxyRuntime.js

@@ -0,0 +1,430 @@
+"use strict";
+
+import { accountIdsOf, activeSessionIdOf, activeUserOf, deviceStateToClientSessions, mergeSessions as mergeSessionLists, normalizeAndSortSessions, normalizeUserIdentity, resolveActiveContext, sessionsArraysEqual } from '@oxyhq/core';
+
+/**
+ * A change of SUBJECT — the account the session acts as.
+ *
+ * `previous === null` is an initial sign-in (nothing account-scoped is cached
+ * yet); `next === null` is a sign-out; both non-null and different is a switch,
+ * the only case that must invalidate a warm cache.
+ */
+
+/**
+ * The three seams the runtime reads, declared STRUCTURALLY rather than as the
+ * concrete `OxyServices` / `SessionClient` / `SessionClientHost` types.
+ *
+ * The real classes satisfy them, so nothing changes at the call site — but a
+ * test can hand the runtime three plain objects instead of casting a stub
+ * through `unknown`, which is how a stub silently drifts from the interface it
+ * pretends to implement.
+ */
+
+/**
+ * The headless session runtime (ADR 0004).
+ *
+ * It owns the session facts and the ORDER in which they become visible. React
+ * is an adapter: the provider hands components this object and they subscribe
+ * with selectors, so an unrelated change (a locale, a dialog opening) cannot
+ * rebuild an auth consumer's view.
+ */
+
+const EMPTY_SESSIONS = [];
+function deriveStatus(facts) {
+  if (!facts.authResolved) {
+    return 'booting';
+  }
+  if (facts.account !== null) {
+    return 'authenticated';
+  }
+  return facts.error !== null ? 'error' : 'signed_out';
+}
+function deriveTokenStatus(facts) {
+  if (facts.hasAccessToken && facts.tokenReady) {
+    return 'ready';
+  }
+  if (facts.account !== null || facts.hasAccessToken) {
+    return 'refreshing';
+  }
+  return 'missing';
+}
+
+/**
+ * The actor behind the active context, resolved to a full `User`.
+ *
+ * Falls back to the subject: on a device with no directory, and on any
+ * non-delegated context, the two ARE the same person, and saying so is more
+ * useful than a `null` every caller would have to special-case.
+ */
+function derivePrincipal(activeContext, profiles, account) {
+  if (activeContext === null) {
+    return account;
+  }
+  return profiles.get(activeContext.actor.userId) ?? account;
+}
+export function createOxyRuntime(config) {
+  const {
+    oxyServices,
+    sessionClient,
+    sessionClientHost,
+    identity,
+    onSubjectChange,
+    onDeviceEmpty,
+    onSessionsProjected,
+    onIdentityUnbound,
+    logger
+  } = config;
+  const facts = {
+    deviceState: null,
+    directory: null,
+    profiles: new Map(),
+    sessions: EMPTY_SESSIONS,
+    activeSessionId: null,
+    account: null,
+    pinnedAccountId: null,
+    isLoading: false,
+    error: null,
+    storageReady: false,
+    tokenReady: true,
+    hasAccessToken: Boolean(oxyServices.getAccessToken()),
+    authResolved: false,
+    switching: false
+  };
+  const listeners = new Set();
+  let snapshot = buildSnapshot();
+  /**
+   * Depth of the current transition. Nested mutations publish ONCE, at the
+   * outermost boundary — a projection that sets sessions, the active id and the
+   * account must not wake React three times with two of them half-applied.
+   */
+  let depth = 0;
+  let dirty = false;
+  /** The subject as it stood when the OUTERMOST transition opened. */
+  let subjectAtEntry = null;
+  function buildSnapshot() {
+    const activeContext = resolveActiveContext(facts.directory);
+    return Object.freeze({
+      status: deriveStatus(facts),
+      device: facts.directory,
+      deviceState: facts.deviceState,
+      activeContext,
+      principal: derivePrincipal(activeContext, facts.profiles, facts.account),
+      account: facts.account,
+      tokenStatus: deriveTokenStatus(facts),
+      authResolved: facts.authResolved,
+      switching: facts.switching,
+      error: facts.error === null ? null : {
+        message: facts.error,
+        code: 'oxy_runtime_error'
+      },
+      sessions: facts.sessions,
+      activeSessionId: facts.activeSessionId,
+      isLoading: facts.isLoading,
+      storageReady: facts.storageReady,
+      hasAccessToken: facts.hasAccessToken,
+      tokenReady: facts.tokenReady
+    });
+  }
+  function notify() {
+    for (const listener of [...listeners]) {
+      try {
+        listener();
+      } catch (error) {
+        logger('An OxyRuntime subscriber threw', error);
+      }
+    }
+  }
+
+  /**
+   * The ONE ordered transition. Every fact change goes through here, so the
+   * sequence ADR 0002 mandates holds for a local switch, a socket push, a cold
+   * boot and a cross-tab wake alike:
+   *
+   *   the bearer is already committed (SessionClient awaits its mint before it
+   *   calls us) → reset account-scoped caches → publish the snapshot → notify.
+   *
+   * Publishing before the reset would let a woken component read a cache entry
+   * belonging to the previous subject while holding the new subject's bearer,
+   * which is the account-switch race in its quietest form: no error, just the
+   * wrong person's data.
+   */
+  function transition(mutate) {
+    if (depth === 0) {
+      subjectAtEntry = facts.account?.id ?? null;
+    }
+    depth += 1;
+    try {
+      mutate();
+    } finally {
+      depth -= 1;
+    }
+    if (depth > 0) {
+      // A nested transition publishes nothing and fires no reset: the subject
+      // is compared once, at the outermost boundary, so a projection that
+      // touches the account twice cannot reset the caches twice.
+      return;
+    }
+    const nextSubject = facts.account?.id ?? null;
+    if (nextSubject !== subjectAtEntry) {
+      dirty = true;
+      onSubjectChange?.({
+        previous: subjectAtEntry,
+        next: nextSubject
+      });
+    }
+    if (!dirty) {
+      return;
+    }
+    dirty = false;
+    snapshot = buildSnapshot();
+    notify();
+  }
+
+  /** Mark the snapshot stale from inside a transition. */
+  function touch() {
+    dirty = true;
+  }
+  function setSessions(next) {
+    if (sessionsArraysEqual(facts.sessions, next)) {
+      return;
+    }
+    facts.sessions = next;
+    touch();
+  }
+  function setActiveSessionIdFact(sessionId) {
+    if (facts.activeSessionId === sessionId) {
+      return;
+    }
+    facts.activeSessionId = sessionId;
+    touch();
+  }
+
+  /**
+   * The one place a `User` becomes THE subject — and the one place identity is
+   * normalised, so a profile arriving as `_id` from one lane and `id` from
+   * another can never produce two accounts that are the same person.
+   */
+  function setAccountFact(user) {
+    if (user === null) {
+      if (facts.account === null) {
+        return;
+      }
+      facts.account = null;
+      touch();
+      return;
+    }
+    if (facts.account === user) {
+      return;
+    }
+    facts.account = normalizeUserIdentity(user);
+    touch();
+  }
+
+  // ── Projection ───────────────────────────────────────────────────────────
+
+  async function reconcileFromClient() {
+    const state = sessionClient.getState();
+    if (state === null) {
+      return;
+    }
+    if (state.accounts.length === 0) {
+      sessionClientHost.setCurrentAccountId(null);
+      await onDeviceEmpty();
+      return;
+    }
+    // Capture the revision this projection is for, then bail after the async
+    // profile fetch if a fresher state has landed — last-writer-wins, so two
+    // overlapping projections can never publish in the wrong order.
+    const capturedRevision = state.revision;
+    // Resolve the pin BEFORE the fetch (memoised: one storage + keychain read
+    // per boot) so the first pass over a freshly applied state is already bound.
+    // Deferring it would let a sibling app's switch render once as this
+    // client's user before the pin corrected it.
+    const pinnedAccountId = identity ? await identity.ensurePinnedAccountId() : null;
+    const ids = accountIdsOf(state);
+    let users = [];
+    try {
+      users = ids.length > 0 ? await oxyServices.getUsersByIds(ids) : [];
+    } catch (fetchError) {
+      logger('Failed to resolve account profiles during the device projection', fetchError);
+      return;
+    }
+    const latest = sessionClient.getState();
+    if (!latest || latest.revision !== capturedRevision) {
+      return;
+    }
+    if (identity && (pinnedAccountId === null || activeSessionIdOf(latest, pinnedAccountId) === null)) {
+      // Either no verified pin, or the pinned account left this device's session
+      // set. Leave the current projection untouched and re-derive from the key.
+      onIdentityUnbound?.(identity, latest.revision);
+      return;
+    }
+    const directory = sessionClient.getDirectory();
+    transition(() => {
+      facts.pinnedAccountId = pinnedAccountId;
+      if (facts.deviceState !== latest) {
+        facts.deviceState = latest;
+        touch();
+      }
+      if (facts.directory !== directory) {
+        facts.directory = directory;
+        touch();
+      }
+      for (const resolved of users) {
+        facts.profiles.set(resolved.id, resolved);
+      }
+      const projected = normalizeAndSortSessions(deviceStateToClientSessions(latest, facts.profiles, pinnedAccountId), facts.activeSessionId, false);
+      setSessions(projected);
+      onSessionsProjected?.(projected.map(session => session.sessionId));
+      setActiveSessionIdFact(activeSessionIdOf(latest, pinnedAccountId));
+      const activeUser = activeUserOf(latest, facts.profiles, pinnedAccountId);
+      if (activeUser) {
+        setAccountFact(activeUser);
+      }
+    });
+    // The host's current account feeds the socket handshake and the bearer's
+    // token-account comparisons, so it tracks the PIN — never the account
+    // another app switched the device to.
+    sessionClientHost.setCurrentAccountId(pinnedAccountId ?? latest.activeAccountId);
+  }
+  return {
+    getSnapshot: () => snapshot,
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    start() {
+      return sessionClient.subscribe(() => {
+        void reconcileFromClient().catch(error => {
+          logger('Failed to project a device-state transition', error);
+        });
+      });
+    },
+    reconcileFromClient,
+    batch(mutate) {
+      transition(mutate);
+    },
+    async activateContext(contextId) {
+      // `switching` is published BEFORE the request so a switcher can disable
+      // its rows for the whole round trip, and cleared in `finally` so a
+      // refused activation does not strand it on.
+      this.setSwitching(true);
+      try {
+        await sessionClient.activateContext(contextId);
+        await reconcileFromClient();
+      } finally {
+        this.setSwitching(false);
+      }
+    },
+    async signOutContext(contextId) {
+      await sessionClient.signOutContext(contextId);
+      await reconcileFromClient();
+    },
+    async signOutPrincipal(principalId) {
+      await sessionClient.signOutPrincipal(principalId);
+      await reconcileFromClient();
+    },
+    async refreshDirectory() {
+      await sessionClient.refreshDirectory();
+      const directory = sessionClient.getDirectory();
+      transition(() => {
+        if (facts.directory === directory) {
+          return;
+        }
+        facts.directory = directory;
+        touch();
+      });
+    },
+    setAccount(user) {
+      transition(() => {
+        setAccountFact(user);
+        if (facts.isLoading) {
+          facts.isLoading = false;
+          touch();
+        }
+        if (facts.error !== null) {
+          facts.error = null;
+          touch();
+        }
+        facts.profiles.set(user.id, user);
+      });
+    },
+    setLoading(loading) {
+      transition(() => {
+        if (facts.isLoading === loading) return;
+        facts.isLoading = loading;
+        touch();
+      });
+    },
+    setError(error) {
+      transition(() => {
+        if (facts.error === error) return;
+        facts.error = error;
+        touch();
+      });
+    },
+    setStorageReady(ready) {
+      transition(() => {
+        if (facts.storageReady === ready) return;
+        facts.storageReady = ready;
+        touch();
+      });
+    },
+    setTokenReady(ready) {
+      transition(() => {
+        if (facts.tokenReady === ready) return;
+        facts.tokenReady = ready;
+        touch();
+      });
+    },
+    setHasAccessToken(has) {
+      transition(() => {
+        if (facts.hasAccessToken === has) return;
+        facts.hasAccessToken = has;
+        touch();
+      });
+    },
+    setSwitching(switching) {
+      transition(() => {
+        if (facts.switching === switching) return;
+        facts.switching = switching;
+        touch();
+      });
+    },
+    markAuthResolved() {
+      transition(() => {
+        if (facts.authResolved) return;
+        facts.authResolved = true;
+        facts.tokenReady = true;
+        touch();
+      });
+    },
+    mergeSessions(incoming, options = {}) {
+      transition(() => {
+        const processed = options.merge ? mergeSessionLists(facts.sessions, incoming, facts.activeSessionId, false) : normalizeAndSortSessions(incoming, facts.activeSessionId, false);
+        onSessionsProjected?.([...processed.map(session => session.sessionId), ...(options.preserveSessionIds ?? [])]);
+        setSessions(processed);
+      });
+    },
+    setActiveSessionId(sessionId) {
+      transition(() => {
+        setActiveSessionIdFact(sessionId);
+      });
+    },
+    clearSession() {
+      transition(() => {
+        setSessions(EMPTY_SESSIONS);
+        setActiveSessionIdFact(null);
+        setAccountFact(null);
+        facts.deviceState = null;
+        facts.directory = null;
+        facts.profiles = new Map();
+        facts.pinnedAccountId = null;
+        touch();
+      });
+    }
+  };
+}
+//# sourceMappingURL=createOxyRuntime.js.map

package/lib/module/ui/runtime/createOxyRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["accountIdsOf","activeSessionIdOf","activeUserOf","deviceStateToClientSessions","mergeSessions","mergeSessionLists","normalizeAndSortSessions","normalizeUserIdentity","resolveActiveContext","sessionsArraysEqual","EMPTY_SESSIONS","deriveStatus","facts","authResolved","account","error","deriveTokenStatus","hasAccessToken","tokenReady","derivePrincipal","activeContext","profiles","get","actor","userId","createOxyRuntime","config","oxyServices","sessionClient","sessionClientHost","identity","onSubjectChange","onDeviceEmpty","onSessionsProjected","onIdentityUnbound","logger","deviceState","directory","Map","sessions","activeSessionId","pinnedAccountId","isLoading","storageReady","Boolean","getAccessToken","switching","listeners","Set","snapshot","buildSnapshot","depth","dirty","subjectAtEntry","Object","freeze","status","device","principal","tokenStatus","message","code","notify","listener","transition","mutate","id","nextSubject","previous","next","touch","setSessions","setActiveSessionIdFact","sessionId","setAccountFact","user","reconcileFromClient","state","getState","accounts","length","setCurrentAccountId","capturedRevision","revision","ensurePinnedAccountId","ids","users","getUsersByIds","fetchError","latest","getDirectory","resolved","set","projected","map","session","activeUser","activeAccountId","getSnapshot","subscribe","add","delete","start","catch","batch","activateContext","contextId","setSwitching","signOutContext","signOutPrincipal","principalId","refreshDirectory","setAccount","setLoading","loading","setError","setStorageReady","ready","setTokenReady","setHasAccessToken","has","markAuthResolved","incoming","options","processed","merge","preserveSessionIds","setActiveSessionId","clearSession"],"sourceRoot":"../../../../src","sources":["ui/runtime/createOxyRuntime.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/ui/runtime/index.js

@@ -0,0 +1,15 @@
+"use strict";
+
+/**
+ * The headless session runtime (ADR 0004).
+ *
+ * `createOxyRuntime` owns the session facts and the order in which they become
+ * visible; `useRuntimeSnapshot` / `useRuntimeSelector` are the React adapter
+ * over it. Nothing here imports React except the adapter, and nothing in the
+ * runtime reads React state — which is what lets the provider hold ONE stable
+ * reference and stop rebuilding a 58-field context value on every keystroke.
+ */
+export { createOxyRuntime } from "./createOxyRuntime.js";
+export { useRuntimeSnapshot, useRuntimeSelector } from "./useRuntimeSnapshot.js";
+export { OxyRuntimeHandleProvider, OxyRuntimeMissingError, useActiveAccount, useDeviceDirectory, useOxyRuntime, useOxySnapshot } from "./runtimeContext.js";
+//# sourceMappingURL=index.js.map

package/lib/module/ui/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createOxyRuntime","useRuntimeSnapshot","useRuntimeSelector","OxyRuntimeHandleProvider","OxyRuntimeMissingError","useActiveAccount","useDeviceDirectory","useOxyRuntime","useOxySnapshot"],"sourceRoot":"../../../../src","sources":["ui/runtime/index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASA,gBAAgB,QAAQ,uBAAoB;AASrD,SAASC,kBAAkB,EAAEC,kBAAkB,QAAQ,yBAAsB;AAC7E,SACEC,wBAAwB,EACxBC,sBAAsB,EACtBC,gBAAgB,EAChBC,kBAAkB,EAClBC,aAAa,EACbC,cAAc,QACT,qBAAkB","ignoreList":[]}

package/lib/module/ui/runtime/runtimeContext.js

@@ -0,0 +1,75 @@
+"use strict";
+
+import { createContext, useContext } from 'react';
+import { useRuntimeSelector, useRuntimeSnapshot } from "./useRuntimeSnapshot.js";
+
+/**
+ * The runtime reference itself, as a context value that NEVER changes identity
+ * (ADR 0004).
+ *
+ * It is deliberately a second context beside the big `OxyContextState` one.
+ * That value is rebuilt whenever any of its fifty-odd members moves — a locale,
+ * a dialog opening — and every hook reading it re-renders with it. Hooks
+ * hanging off this one subscribe to the runtime with a selector instead, so
+ * only a change to what they actually selected wakes them. Retiring the wide
+ * context is Phase 8; this is what its replacements are built on.
+ */
+const OxyRuntimeHandleContext = /*#__PURE__*/createContext(null);
+export const OxyRuntimeHandleProvider = OxyRuntimeHandleContext.Provider;
+const RUNTIME_MISSING_MESSAGE = 'useOxyRuntime() was called outside <OxyProvider>. Mount <OxyProvider clientId="…"> above this component.';
+export class OxyRuntimeMissingError extends Error {
+  code = 'oxy_runtime_missing';
+  constructor() {
+    super(RUNTIME_MISSING_MESSAGE);
+    this.name = 'OxyRuntimeMissingError';
+  }
+}
+
+/** The runtime this provider owns. THROWS when no `<OxyProvider>` is mounted. */
+export function useOxyRuntime() {
+  const runtime = useContext(OxyRuntimeHandleContext);
+  if (runtime === null) {
+    throw new OxyRuntimeMissingError();
+  }
+  return runtime;
+}
+function selectActiveAccount(snapshot) {
+  return {
+    principal: snapshot.principal,
+    account: snapshot.account,
+    context: snapshot.activeContext,
+    isDelegated: snapshot.activeContext?.isDelegated ?? false,
+    status: snapshot.status
+  };
+}
+function activeAccountsEqual(a, b) {
+  return a.principal === b.principal && a.account === b.account && a.context === b.context && a.isDelegated === b.isDelegated && a.status === b.status;
+}
+
+/**
+ * Who this app is running as, with the actor and the subject kept apart.
+ *
+ * Unlike `useOxy()`, this re-renders only when one of those five facts moves —
+ * a locale change, a dialog opening or a session-list refresh does not reach it.
+ */
+export function useActiveAccount() {
+  return useRuntimeSelector(useOxyRuntime(), selectActiveAccount, activeAccountsEqual);
+}
+const selectDirectory = snapshot => snapshot.device;
+
+/**
+ * The device directory — every principal on this device and the contexts each
+ * may act as (ADR 0002).
+ *
+ * `null` until something calls `runtime.refreshDirectory()`. A client that
+ * never asks for one never pays for the round trip.
+ */
+export function useDeviceDirectory() {
+  return useRuntimeSelector(useOxyRuntime(), selectDirectory);
+}
+
+/** The whole runtime snapshot. Prefer a narrower hook where one exists. */
+export function useOxySnapshot() {
+  return useRuntimeSnapshot(useOxyRuntime());
+}
+//# sourceMappingURL=runtimeContext.js.map

package/lib/module/ui/runtime/runtimeContext.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createContext","useContext","useRuntimeSelector","useRuntimeSnapshot","OxyRuntimeHandleContext","OxyRuntimeHandleProvider","Provider","RUNTIME_MISSING_MESSAGE","OxyRuntimeMissingError","Error","code","constructor","name","useOxyRuntime","runtime","selectActiveAccount","snapshot","principal","account","context","activeContext","isDelegated","status","activeAccountsEqual","a","b","useActiveAccount","selectDirectory","device","useDeviceDirectory","useOxySnapshot"],"sourceRoot":"../../../../src","sources":["ui/runtime/runtimeContext.tsx"],"mappings":";;AAAA,SAASA,aAAa,EAAEC,UAAU,QAAQ,OAAO;AAKjD,SAASC,kBAAkB,EAAEC,kBAAkB,QAAQ,yBAAsB;;AAE7E;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,uBAAuB,gBAAGJ,aAAa,CAAoB,IAAI,CAAC;AAEtE,OAAO,MAAMK,wBAAwB,GAAGD,uBAAuB,CAACE,QAAQ;AAExE,MAAMC,uBAAuB,GAC3B,0GAA0G;AAE5G,OAAO,MAAMC,sBAAsB,SAASC,KAAK,CAAC;EACvCC,IAAI,GAAG,qBAAqB;EAErCC,WAAWA,CAAA,EAAG;IACZ,KAAK,CAACJ,uBAAuB,CAAC;IAC9B,IAAI,CAACK,IAAI,GAAG,wBAAwB;EACtC;AACF;;AAEA;AACA,OAAO,SAASC,aAAaA,CAAA,EAAe;EAC1C,MAAMC,OAAO,GAAGb,UAAU,CAACG,uBAAuB,CAAC;EACnD,IAAIU,OAAO,KAAK,IAAI,EAAE;IACpB,MAAM,IAAIN,sBAAsB,CAAC,CAAC;EACpC;EACA,OAAOM,OAAO;AAChB;AAiBA,SAASC,mBAAmBA,CAACC,QAK5B,EAAiB;EAChB,OAAO;IACLC,SAAS,EAAED,QAAQ,CAACC,SAAS;IAC7BC,OAAO,EAAEF,QAAQ,CAACE,OAAO;IACzBC,OAAO,EAAEH,QAAQ,CAACI,aAAa;IAC/BC,WAAW,EAAEL,QAAQ,CAACI,aAAa,EAAEC,WAAW,IAAI,KAAK;IACzDC,MAAM,EAAEN,QAAQ,CAACM;EACnB,CAAC;AACH;AAEA,SAASC,mBAAmBA,CAACC,CAAgB,EAAEC,CAAgB,EAAW;EACxE,OACED,CAAC,CAACP,SAAS,KAAKQ,CAAC,CAACR,SAAS,IAC3BO,CAAC,CAACN,OAAO,KAAKO,CAAC,CAACP,OAAO,IACvBM,CAAC,CAACL,OAAO,KAAKM,CAAC,CAACN,OAAO,IACvBK,CAAC,CAACH,WAAW,KAAKI,CAAC,CAACJ,WAAW,IAC/BG,CAAC,CAACF,MAAM,KAAKG,CAAC,CAACH,MAAM;AAEzB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASI,gBAAgBA,CAAA,EAAkB;EAChD,OAAOxB,kBAAkB,CAACW,aAAa,CAAC,CAAC,EAAEE,mBAAmB,EAAEQ,mBAAmB,CAAC;AACtF;AAEA,MAAMI,eAAe,GAAIX,QAA4C,IACnEA,QAAQ,CAACY,MAAM;;AAEjB;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAAA,EAA2B;EAC3D,OAAO3B,kBAAkB,CAACW,aAAa,CAAC,CAAC,EAAEc,eAAe,CAAC;AAC7D;;AAEA;AACA,OAAO,SAASG,cAAcA,CAAA,EAA0C;EACtE,OAAO3B,kBAAkB,CAACU,aAAa,CAAC,CAAC,CAAC;AAC5C","ignoreList":[]}

package/lib/module/ui/runtime/types.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=types.js.map

package/lib/module/ui/runtime/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["ui/runtime/types.ts"],"mappings":"","ignoreList":[]}

package/lib/module/ui/runtime/useRuntimeSnapshot.js

@@ -0,0 +1,52 @@
+"use strict";
+
+import { useCallback, useRef, useSyncExternalStore } from 'react';
+/**
+ * Subscribe to the whole runtime snapshot.
+ *
+ * The runtime publishes a frozen object only when a fact actually changed, so
+ * identity comparison is exact: a locale change, a dialog opening or an
+ * unrelated query settling does not wake anything subscribed here.
+ */
+export function useRuntimeSnapshot(runtime) {
+  return useSyncExternalStore(runtime.subscribe, runtime.getSnapshot, runtime.getSnapshot);
+}
+
+/**
+ * Subscribe to one derived value of the runtime snapshot.
+ *
+ * The selection is cached against the snapshot it was computed from, which is
+ * what makes a selector returning a fresh object (`{user, isAuthenticated}`)
+ * safe here: `useSyncExternalStore` calls `getSnapshot` several times per
+ * commit and would otherwise see a new object every call and loop.
+ *
+ * `selector` must be stable — hoist it to module scope or wrap it in
+ * `useCallback`. An inline arrow re-subscribes on every render.
+ */
+export function useRuntimeSelector(runtime, selector, isEqual) {
+  const cache = useRef(null);
+  const getSelection = useCallback(() => {
+    const snapshot = runtime.getSnapshot();
+    const cached = cache.current;
+    if (cached !== null && cached.snapshot === snapshot) {
+      return cached.value;
+    }
+    const value = selector(snapshot);
+    if (cached !== null && isEqual?.(cached.value, value) === true) {
+      // Same value under the caller's equality: keep the PREVIOUS reference so a
+      // structurally-equal recomputation does not read as a change.
+      cache.current = {
+        snapshot,
+        value: cached.value
+      };
+      return cached.value;
+    }
+    cache.current = {
+      snapshot,
+      value
+    };
+    return value;
+  }, [runtime, selector, isEqual]);
+  return useSyncExternalStore(runtime.subscribe, getSelection, getSelection);
+}
+//# sourceMappingURL=useRuntimeSnapshot.js.map

package/lib/module/ui/runtime/useRuntimeSnapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useRef","useSyncExternalStore","useRuntimeSnapshot","runtime","subscribe","getSnapshot","useRuntimeSelector","selector","isEqual","cache","getSelection","snapshot","cached","current","value"],"sourceRoot":"../../../../src","sources":["ui/runtime/useRuntimeSnapshot.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,MAAM,EAAEC,oBAAoB,QAAQ,OAAO;AAIjE;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAACC,OAAmB,EAAsB;EAC1E,OAAOF,oBAAoB,CAACE,OAAO,CAACC,SAAS,EAAED,OAAO,CAACE,WAAW,EAAEF,OAAO,CAACE,WAAW,CAAC;AAC1F;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAChCH,OAAmB,EACnBI,QAA6C,EAC7CC,OAAiC,EAC9B;EACH,MAAMC,KAAK,GAAGT,MAAM,CAAoD,IAAI,CAAC;EAE7E,MAAMU,YAAY,GAAGX,WAAW,CAAC,MAAS;IACxC,MAAMY,QAAQ,GAAGR,OAAO,CAACE,WAAW,CAAC,CAAC;IACtC,MAAMO,MAAM,GAAGH,KAAK,CAACI,OAAO;IAC5B,IAAID,MAAM,KAAK,IAAI,IAAIA,MAAM,CAACD,QAAQ,KAAKA,QAAQ,EAAE;MACnD,OAAOC,MAAM,CAACE,KAAK;IACrB;IACA,MAAMA,KAAK,GAAGP,QAAQ,CAACI,QAAQ,CAAC;IAChC,IAAIC,MAAM,KAAK,IAAI,IAAIJ,OAAO,GAAGI,MAAM,CAACE,KAAK,EAAEA,KAAK,CAAC,KAAK,IAAI,EAAE;MAC9D;MACA;MACAL,KAAK,CAACI,OAAO,GAAG;QAAEF,QAAQ;QAAEG,KAAK,EAAEF,MAAM,CAACE;MAAM,CAAC;MACjD,OAAOF,MAAM,CAACE,KAAK;IACrB;IACAL,KAAK,CAACI,OAAO,GAAG;MAAEF,QAAQ;MAAEG;IAAM,CAAC;IACnC,OAAOA,KAAK;EACd,CAAC,EAAE,CAACX,OAAO,EAAEI,QAAQ,EAAEC,OAAO,CAAC,CAAC;EAEhC,OAAOP,oBAAoB,CAACE,OAAO,CAACC,SAAS,EAAEM,YAAY,EAAEA,YAAY,CAAC;AAC5E","ignoreList":[]}

package/lib/module/ui/server.js

@@ -39,7 +39,6 @@ export const ProfileScreen = noopComponent;
 
 // Stores (return empty objects)
 export const useAuthStore = noopHook;
-export const useAccountStore = noopHook;
 
 // Toast (noop)
 export const toast = Object.assign(() => {}, {

package/lib/module/ui/server.js.map

@@ -1 +1 @@
-{"version":3,"names":["noopComponent","noopHook","noopStorageResult","storage","isReady","OxyProvider","OxySignInButton","LogoIcon","LogoText","FollowButton","OxyPayButton","useOxy","useAuth","useFollow","useStorage","ProfileScreen","useAuthStore","useAccountStore","toast","Object","assign","success","error","info","warning","loading","dismiss","handleAuthError","isInvalidSessionError","isTimeoutOrNetworkError","extractErrorMessage"],"sourceRoot":"../../../src","sources":["ui/server.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,MAAMA,aAAa,GAAGA,CAAA,KAAM,IAAI;AAChC,MAAMC,QAAQ,GAAGA,CAAA,MAAO,CAAC,CAAC,CAAC;AAC3B,MAAMC,iBAAiB,GAAG;EAAEC,OAAO,EAAE,IAAI;EAAEC,OAAO,EAAE;AAAM,CAAC;;AAE3D;AACA,OAAO,MAAMC,WAAW,GAAGL,aAAa;AACxC,OAAO,MAAMM,eAAe,GAAGN,aAAa;AAC5C,OAAO,MAAMO,QAAQ,GAAGP,aAAa;AACrC,OAAO,MAAMQ,QAAQ,GAAGR,aAAa;AACrC,OAAO,MAAMS,YAAY,GAAGT,aAAa;AACzC,OAAO,MAAMU,YAAY,GAAGV,aAAa;;AAEzC;AACA,OAAO,MAAMW,MAAM,GAAGV,QAAQ;;AAE9B;AACA,OAAO,MAAMW,OAAO,GAAGX,QAAQ;AAC/B,OAAO,MAAMY,SAAS,GAAGZ,QAAQ;AACjC,OAAO,MAAMa,UAAU,GAAGA,CAAA,KAAMZ,iBAAiB;;AAEjD;AACA,OAAO,MAAMa,aAAa,GAAGf,aAAa;;AAE1C;AACA,OAAO,MAAMgB,YAAY,GAAGf,QAAQ;AACpC,OAAO,MAAMgB,eAAe,GAAGhB,QAAQ;;AAEvC;AACA,OAAO,MAAMiB,KAAK,GAAGC,MAAM,CAACC,MAAM,CAC9B,MAAM,CAAC,CAAC,EACR;EACIC,OAAO,EAAEA,CAAA,KAAM,CAAC,CAAC;EACjBC,KAAK,EAAEA,CAAA,KAAM,CAAC,CAAC;EACfC,IAAI,EAAEA,CAAA,KAAM,CAAC,CAAC;EACdC,OAAO,EAAEA,CAAA,KAAM,CAAC,CAAC;EACjBC,OAAO,EAAEA,CAAA,KAAM,CAAC,CAAC;EACjBC,OAAO,EAAEA,CAAA,KAAM,CAAC;AACpB,CACJ,CAAC;;AAED;AACA,SACIC,eAAe,EACfC,qBAAqB,EACrBC,uBAAuB,EACvBC,mBAAmB,QAChB,0BAAuB","ignoreList":[]}
+{"version":3,"names":["noopComponent","noopHook","noopStorageResult","storage","isReady","OxyProvider","OxySignInButton","LogoIcon","LogoText","FollowButton","OxyPayButton","useOxy","useAuth","useFollow","useStorage","ProfileScreen","useAuthStore","toast","Object","assign","success","error","info","warning","loading","dismiss","handleAuthError","isInvalidSessionError","isTimeoutOrNetworkError","extractErrorMessage"],"sourceRoot":"../../../src","sources":["ui/server.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,MAAMA,aAAa,GAAGA,CAAA,KAAM,IAAI;AAChC,MAAMC,QAAQ,GAAGA,CAAA,MAAO,CAAC,CAAC,CAAC;AAC3B,MAAMC,iBAAiB,GAAG;EAAEC,OAAO,EAAE,IAAI;EAAEC,OAAO,EAAE;AAAM,CAAC;;AAE3D;AACA,OAAO,MAAMC,WAAW,GAAGL,aAAa;AACxC,OAAO,MAAMM,eAAe,GAAGN,aAAa;AAC5C,OAAO,MAAMO,QAAQ,GAAGP,aAAa;AACrC,OAAO,MAAMQ,QAAQ,GAAGR,aAAa;AACrC,OAAO,MAAMS,YAAY,GAAGT,aAAa;AACzC,OAAO,MAAMU,YAAY,GAAGV,aAAa;;AAEzC;AACA,OAAO,MAAMW,MAAM,GAAGV,QAAQ;;AAE9B;AACA,OAAO,MAAMW,OAAO,GAAGX,QAAQ;AAC/B,OAAO,MAAMY,SAAS,GAAGZ,QAAQ;AACjC,OAAO,MAAMa,UAAU,GAAGA,CAAA,KAAMZ,iBAAiB;;AAEjD;AACA,OAAO,MAAMa,aAAa,GAAGf,aAAa;;AAE1C;AACA,OAAO,MAAMgB,YAAY,GAAGf,QAAQ;;AAEpC;AACA,OAAO,MAAMgB,KAAK,GAAGC,MAAM,CAACC,MAAM,CAC9B,MAAM,CAAC,CAAC,EACR;EACIC,OAAO,EAAEA,CAAA,KAAM,CAAC,CAAC;EACjBC,KAAK,EAAEA,CAAA,KAAM,CAAC,CAAC;EACfC,IAAI,EAAEA,CAAA,KAAM,CAAC,CAAC;EACdC,OAAO,EAAEA,CAAA,KAAM,CAAC,CAAC;EACjBC,OAAO,EAAEA,CAAA,KAAM,CAAC,CAAC;EACjBC,OAAO,EAAEA,CAAA,KAAM,CAAC;AACpB,CACJ,CAAC;;AAED;AACA,SACIC,eAAe,EACfC,qBAAqB,EACrBC,uBAAuB,EACvBC,mBAAmB,QAChB,0BAAuB","ignoreList":[]}