@oxyhq/services 30.0.0 → 30.1.0

package/lib/module/ui/hooks/useSurfaceHeader.js

@@ -0,0 +1,138 @@
+"use strict";
+
+import { createContext, useContext, useLayoutEffect, useRef } from 'react';
+
+/**
+ * The header content a mounted surface screen contributes at runtime: its
+ * (translated) title/subtitle and optional slot nodes. Back/close affordances
+ * are owned by the surface host (`SurfaceScreen`) — a screen never wires them.
+ *
+ * Alongside the classic slots (`left`/`right`) a screen can declare the rich
+ * design-system fields Bloom's nav header supports: the single trailing
+ * `primaryAction` CTA (Upload / Save), a trailing icon `actions` row, a header
+ * `search` / `segments` in the large-title zone, an `onImage` `tone` over media,
+ * and a wizard `progress` bar.
+ *
+ * Only the NODE fields (`left`/`right`/`titleContent`, and an action's `icon`)
+ * must be referentially stable — a node can only be compared by identity, so an
+ * inline one thrashes the header. The rich OBJECT fields are compared by value
+ * (see {@link surfaceHeaderContentEqual}), so an inline `primaryAction` /
+ * `actions` / `search` / `segments` / `progress` is safe to pass.
+ */
+
+/**
+ * Provided by {@link ../components/SurfaceScreen}. Bridges a screen's runtime
+ * header contribution up to the host, which merges it with the back/close
+ * wiring and drives the Dialog's own nav header. `null` outside a surface (or in
+ * a headerless surface), so {@link useSurfaceHeader} is a safe no-op there.
+ */
+export const SurfaceHeaderContext = /*#__PURE__*/createContext(null);
+function primaryActionEqual(a, b) {
+  if (a === b) return true;
+  if (!a || !b) return false;
+  // `onPress` is a fresh closure each render — its identity never changes what
+  // the button renders, so compare only the render-affecting scalars.
+  return a.label === b.label && !!a.disabled === !!b.disabled && !!a.loading === !!b.loading;
+}
+function actionsEqual(a, b) {
+  if (a === b) return true;
+  if (!a || !b || a.length !== b.length) return false;
+  for (let i = 0; i < a.length; i += 1) {
+    const x = a[i];
+    const y = b[i];
+    if (!x || !y) return false;
+    // `icon` is a node (identity); `onPress` is ignored, like `primaryAction`'s.
+    if (x.accessibilityLabel !== y.accessibilityLabel || !!x.disabled !== !!y.disabled || x.icon !== y.icon) {
+      return false;
+    }
+  }
+  return true;
+}
+function searchEqual(a, b) {
+  if (a === b) return true;
+  if (!a || !b) return false;
+  return a.value === b.value && a.placeholder === b.placeholder;
+}
+function segmentsEqual(a, b) {
+  if (a === b) return true;
+  if (!a || !b || a.value !== b.value || a.items.length !== b.items.length) return false;
+  for (let i = 0; i < a.items.length; i += 1) {
+    const x = a.items[i];
+    const y = b.items[i];
+    if (!x || !y || x.key !== y.key || x.label !== y.label) return false;
+  }
+  return true;
+}
+function progressEqual(a, b) {
+  if (a === b) return true;
+  if (!a || !b) return false;
+  return a.step === b.step && a.total === b.total;
+}
+
+/**
+ * Value-equality for a surface's header contribution.
+ *
+ * This MIRRORS Bloom's own `configsEqual` (`@oxyhq/bloom/dialog`), which guards
+ * the header store one layer down — deliberately field for field. The two must
+ * not diverge: this comparator is the gate that decides whether the host's
+ * `setContent` fires, so a comparator STRICTER than Bloom's re-introduces the
+ * update loop Bloom's own guard was written to prevent.
+ *
+ * Scalars (`title`/`subtitle`/`largeTitle`/`tone`) compare by value. The rich
+ * object fields (`primaryAction`/`actions`/`search`/`segments`/`progress`)
+ * compare by their render-affecting scalars, so a screen may build them inline:
+ * a fresh object with unchanged contents is NOT a change. Only the node fields
+ * (`titleContent`/`left`/`right`, and an action's `icon`) compare by identity —
+ * there is nothing else to compare a `ReactNode` by — so those, and only those,
+ * carry the memoize-me contract.
+ *
+ * Function-typed affordances compare by PRESENCE, never identity: `onBack`
+ * legitimately gets a fresh closure each render and its identity never changes
+ * what the header renders, so it must not count as a change (that is exactly
+ * what would drive the update loop).
+ */
+function surfaceHeaderContentEqual(a, b) {
+  if (a === b) return true;
+  if (!a || !b) return false;
+  return a.title === b.title && a.titleContent === b.titleContent && a.subtitle === b.subtitle && a.largeTitle === b.largeTitle && a.left === b.left && a.right === b.right && !!a.onBack === !!b.onBack && a.tone === b.tone && primaryActionEqual(a.primaryAction, b.primaryAction) && actionsEqual(a.actions, b.actions) && searchEqual(a.search, b.search) && segmentsEqual(a.segments, b.segments) && progressEqual(a.progress, b.progress);
+}
+
+/**
+ * Declare the Dialog nav header's content from within a surface screen — its
+ * title/subtitle and any action slot. Merges over nothing (the host owns
+ * back/close), replaces on change, and clears on unmount. Call it unconditionally;
+ * it is a no-op outside a header-mode surface.
+ *
+ * Screens pass an INLINE `content` object (a fresh reference every render), so the
+ * push is guarded by {@link surfaceHeaderContentEqual}: the host's `setContent` is
+ * called only when the VALUE actually changes. Without that guard the setState
+ * would fire every render → the screen re-renders → the effect runs again → an
+ * infinite update loop (React error #185) in any consumer that does not memoize
+ * the object for us (i.e. anything not compiled by the React Compiler).
+ */
+export function useSurfaceHeader(content) {
+  const ctx = useContext(SurfaceHeaderContext);
+  const set = ctx?.setContent;
+  const setRef = useRef(set);
+  setRef.current = set;
+  // The last value pushed to the host; `undefined` until the first push.
+  const lastRef = useRef(undefined);
+
+  // Runs after EVERY commit (no deps array) so the bar/title fill in the same
+  // layout phase — but only pushes on a real value change, never on reference churn.
+  useLayoutEffect(() => {
+    const s = setRef.current;
+    if (!s) return;
+    const next = content ?? null;
+    if (lastRef.current !== undefined && surfaceHeaderContentEqual(lastRef.current, next)) return;
+    lastRef.current = next;
+    s(next);
+  });
+
+  // Clear this surface's contribution when the screen unmounts.
+  useLayoutEffect(() => () => {
+    lastRef.current = undefined;
+    setRef.current?.(null);
+  }, []);
+}
+//# sourceMappingURL=useSurfaceHeader.js.map

package/lib/module/ui/hooks/useSurfaceHeader.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createContext","useContext","useLayoutEffect","useRef","SurfaceHeaderContext","primaryActionEqual","a","b","label","disabled","loading","actionsEqual","length","i","x","y","accessibilityLabel","icon","searchEqual","value","placeholder","segmentsEqual","items","key","progressEqual","step","total","surfaceHeaderContentEqual","title","titleContent","subtitle","largeTitle","left","right","onBack","tone","primaryAction","actions","search","segments","progress","useSurfaceHeader","content","ctx","set","setContent","setRef","current","lastRef","undefined","s","next"],"sourceRoot":"../../../../src","sources":["ui/hooks/useSurfaceHeader.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/ui/index.js

@@ -0,0 +1,48 @@
+"use strict";
+
+/**
+ * @oxyhq/services/ui — public subpath
+ *
+ * Tree-shakeable static re-exports of the most common UI surface. Backend
+ * environments (SSR) should import `@oxyhq/services/ui/server` instead;
+ * client-only callers can use `@oxyhq/services/ui/client` for a slightly
+ * narrower bundle.
+ *
+ * Static `export ... from` only — no runtime `require()`, no platform
+ * conditionals. The previous `if (isFrontend) require(...)` pattern was
+ * removed because it (a) violated the dual CJS/ESM build rule (ESM bundles
+ * cannot contain `require()` per CLAUDE.md) and (b) defeated tree-shaking.
+ */
+
+/// <reference path="../types/react-native-classname.d.ts" />
+/// <reference path="../types/react-native-web-style.d.ts" />
+
+// Components
+export { default as OxyProvider } from "./components/OxyProvider.js";
+export { default as OxySignInButton } from "./components/OxySignInButton.js";
+export { default as OxyAuthPrompt } from "./components/OxyAuthPrompt.js";
+export { LogoIcon } from "./components/logo/LogoIcon.js";
+export { LogoText } from "./components/logo/LogoText.js";
+export { RequireOxyAuth } from "./components/RequireOxyAuth.js";
+export { default as FollowButton } from "./components/FollowButton.js";
+export { default as OxyPayButton } from "./components/OxyPayButton.js";
+export { default as ProfileButton } from "./components/ProfileButton.js";
+
+// Context + hooks
+export { useOxy, useOptionalOxy, OxyProviderMissingError } from "./context/OxyContext.js";
+export { useAuth } from "./hooks/useAuth.js";
+export { useFollow, useSeedFollowStatuses } from "./hooks/useFollow.js";
+export { useStorage } from "./hooks/useStorage.js";
+// Screens
+export { default as ProfileScreen } from "./screens/ProfileScreen.js";
+export { default as ManageAccountScreen } from "./screens/ManageAccountScreen.js";
+export { default as CreateAccountScreen } from "./screens/CreateAccountScreen.js";
+export { default as AccountMembersScreen } from "./screens/AccountMembersScreen.js";
+export { default as AccountSettingsScreen } from "./screens/AccountSettingsScreen.js";
+
+// Stores
+export { useAuthStore } from "./stores/authStore.js";
+
+// Error handlers (pure functions)
+export { handleAuthError, isInvalidSessionError, isTimeoutOrNetworkError, extractErrorMessage } from "./utils/errorHandlers.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["default","OxyProvider","OxySignInButton","OxyAuthPrompt","LogoIcon","LogoText","RequireOxyAuth","FollowButton","OxyPayButton","ProfileButton","useOxy","useOptionalOxy","OxyProviderMissingError","useAuth","useFollow","useSeedFollowStatuses","useStorage","ProfileScreen","ManageAccountScreen","CreateAccountScreen","AccountMembersScreen","AccountSettingsScreen","useAuthStore","handleAuthError","isInvalidSessionError","isTimeoutOrNetworkError","extractErrorMessage"],"sourceRoot":"../../../src","sources":["ui/index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;;AAEA;AACA,SAASA,OAAO,IAAIC,WAAW,QAAQ,6BAA0B;AACjE,SAASD,OAAO,IAAIE,eAAe,QAAQ,iCAA8B;AACzE,SAASF,OAAO,IAAIG,aAAa,QAAQ,+BAA4B;AAErE,SAASC,QAAQ,QAAQ,+BAA4B;AACrD,SAASC,QAAQ,QAAQ,+BAA4B;AACrD,SAASC,cAAc,QAAQ,gCAA6B;AAE5D,SAASN,OAAO,IAAIO,YAAY,QAAQ,8BAA2B;AACnE,SAASP,OAAO,IAAIQ,YAAY,QAAQ,8BAA2B;AACnE,SAASR,OAAO,IAAIS,aAAa,QAAQ,+BAA4B;;AAErE;AACA,SAASC,MAAM,EAAEC,cAAc,EAAEC,uBAAuB,QAAQ,yBAAsB;AACtF,SAASC,OAAO,QAAQ,oBAAiB;AACzC,SAASC,SAAS,EAAEC,qBAAqB,QAAQ,sBAAmB;AACpE,SAASC,UAAU,QAAQ,uBAAoB;AAG/C;AACA,SAAShB,OAAO,IAAIiB,aAAa,QAAQ,4BAAyB;AAClE,SAASjB,OAAO,IAAIkB,mBAAmB,QAAQ,kCAA+B;AAC9E,SAASlB,OAAO,IAAImB,mBAAmB,QAAQ,kCAA+B;AAC9E,SAASnB,OAAO,IAAIoB,oBAAoB,QAAQ,mCAAgC;AAChF,SAASpB,OAAO,IAAIqB,qBAAqB,QAAQ,oCAAiC;;AAElF;AACA,SAASC,YAAY,QAAQ,uBAAoB;;AAEjD;AACA,SACIC,eAAe,EACfC,qBAAqB,EACrBC,uBAAuB,EACvBC,mBAAmB,QAChB,0BAAuB","ignoreList":[]}

package/lib/module/ui/isFrontend.js

@@ -0,0 +1,6 @@
+"use strict";
+
+// Utility to detect if running in a frontend (browser or React Native) environment
+const isFrontend = typeof window !== 'undefined' || typeof navigator !== 'undefined' && navigator.product === 'ReactNative';
+export default isFrontend;
+//# sourceMappingURL=isFrontend.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["isFrontend","window","navigator","product"],"sourceRoot":"../../../src","sources":["ui/isFrontend.ts"],"mappings":";;AAAA;AACA,MAAMA,UAAU,GAAG,OAAOC,MAAM,KAAK,WAAW,IAC7C,OAAOC,SAAS,KAAK,WAAW,IAAIA,SAAS,CAACC,OAAO,KAAK,aAAc;AAE3E,eAAeH,UAAU","ignoreList":[]}

package/lib/module/ui/navigation/accountDialogManager.js

@@ -0,0 +1,94 @@
+"use strict";
+
+/**
+ * Imperative, outside-React entry points for the unified `OxyAccountDialogScreen`.
+ *
+ * These delegate to the live handles the mounted `OxyProvider` registers via
+ * {@link registerAccountDialogControls}. Under the hood `open`/`close` present
+ * and dismiss the `AccountDialog` surface on the shared Bloom surface stack
+ * (`OxyContext.openAccountDialog` → `presentDetached('AccountDialog', …)`), so
+ * whether the dialog is open is owned by that stack — this module is only the
+ * thin bridge that reaches the provider's controller (which sets the dialog
+ * view) from a non-React call site.
+ */
+
+/** An app-owned action rendered inside the shared account menu. */
+
+/**
+ * Live open/close handles registered by the mounted provider. `open` presents
+ * the `AccountDialog` surface (and points its view); `close` dismisses it. Both
+ * are stack operations — this interface never carries visibility state.
+ */
+
+/**
+ * Optional consumer overrides for account-dialog actions. `ProfileButton` (and
+ * similar hosts) register these while mounted so inbox/accounts can route
+ * "Manage" / "Add account" to app-local navigation instead of the SDK default.
+ */
+
+let controls = null;
+let consumerHooks = null;
+const visibilityListeners = new Set();
+const consumerHookListeners = new Set();
+function notifyConsumerHookListeners() {
+  for (const listener of consumerHookListeners) {
+    listener();
+  }
+}
+export function registerAccountDialogControls(next) {
+  controls = next;
+  return () => {
+    if (controls === next) {
+      controls = null;
+    }
+  };
+}
+
+/** Register app-local manage/add/profile handlers for the account dialog. */
+export function registerAccountDialogConsumerHooks(next) {
+  consumerHooks = next;
+  notifyConsumerHookListeners();
+  return () => {
+    if (consumerHooks === next) {
+      consumerHooks = null;
+      notifyConsumerHookListeners();
+    }
+  };
+}
+export function getAccountDialogConsumerHooks() {
+  return consumerHooks;
+}
+
+/** Subscribe to consumer-hook registration changes (menu items, manage/add overrides). */
+export function subscribeToAccountDialogConsumerHooks(listener) {
+  consumerHookListeners.add(listener);
+  return () => {
+    consumerHookListeners.delete(listener);
+  };
+}
+
+/** Open the account dialog on `view` (default `accounts`). No-op before mount. */
+export function openAccountDialog(view) {
+  controls?.open(view);
+}
+
+/** Close the account dialog. No-op before mount. */
+export function closeAccountDialog() {
+  controls?.close();
+}
+
+/** Report dialog visibility to subscribers (e.g. `OxySignInButton` loading state). */
+export function notifyAccountDialogVisibility(visible) {
+  for (const listener of visibilityListeners) {
+    listener(visible);
+  }
+}
+
+/** Subscribe to account dialog visibility changes. */
+export function subscribeToAccountDialog(listener) {
+  visibilityListeners.add(listener);
+  return () => {
+    visibilityListeners.delete(listener);
+  };
+}
+//# sourceMappingURL=accountDialogManager.js.map

package/lib/module/ui/navigation/accountDialogManager.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["controls","consumerHooks","visibilityListeners","Set","consumerHookListeners","notifyConsumerHookListeners","listener","registerAccountDialogControls","next","registerAccountDialogConsumerHooks","getAccountDialogConsumerHooks","subscribeToAccountDialogConsumerHooks","add","delete","openAccountDialog","view","open","closeAccountDialog","close","notifyAccountDialogVisibility","visible","subscribeToAccountDialog"],"sourceRoot":"../../../../src","sources":["ui/navigation/accountDialogManager.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA;;AAQA;AACA;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA;AACA;;AAQA,IAAIA,QAAsC,GAAG,IAAI;AACjD,IAAIC,aAAgD,GAAG,IAAI;AAC3D,MAAMC,mBAAmB,GAAG,IAAIC,GAAG,CAA6B,CAAC;AACjE,MAAMC,qBAAqB,GAAG,IAAID,GAAG,CAAa,CAAC;AAEnD,SAASE,2BAA2BA,CAAA,EAAS;EAC3C,KAAK,MAAMC,QAAQ,IAAIF,qBAAqB,EAAE;IAC5CE,QAAQ,CAAC,CAAC;EACZ;AACF;AAEA,OAAO,SAASC,6BAA6BA,CAACC,IAA2B,EAAc;EACrFR,QAAQ,GAAGQ,IAAI;EACf,OAAO,MAAM;IACX,IAAIR,QAAQ,KAAKQ,IAAI,EAAE;MACrBR,QAAQ,GAAG,IAAI;IACjB;EACF,CAAC;AACH;;AAEA;AACA,OAAO,SAASS,kCAAkCA,CAChDD,IAAuC,EAC3B;EACZP,aAAa,GAAGO,IAAI;EACpBH,2BAA2B,CAAC,CAAC;EAC7B,OAAO,MAAM;IACX,IAAIJ,aAAa,KAAKO,IAAI,EAAE;MAC1BP,aAAa,GAAG,IAAI;MACpBI,2BAA2B,CAAC,CAAC;IAC/B;EACF,CAAC;AACH;AAEA,OAAO,SAASK,6BAA6BA,CAAA,EAAsC;EACjF,OAAOT,aAAa;AACtB;;AAEA;AACA,OAAO,SAASU,qCAAqCA,CAACL,QAAoB,EAAc;EACtFF,qBAAqB,CAACQ,GAAG,CAACN,QAAQ,CAAC;EACnC,OAAO,MAAM;IACXF,qBAAqB,CAACS,MAAM,CAACP,QAAQ,CAAC;EACxC,CAAC;AACH;;AAEA;AACA,OAAO,SAASQ,iBAAiBA,CAACC,IAAwB,EAAQ;EAChEf,QAAQ,EAAEgB,IAAI,CAACD,IAAI,CAAC;AACtB;;AAEA;AACA,OAAO,SAASE,kBAAkBA,CAAA,EAAS;EACzCjB,QAAQ,EAAEkB,KAAK,CAAC,CAAC;AACnB;;AAEA;AACA,OAAO,SAASC,6BAA6BA,CAACC,OAAgB,EAAQ;EACpE,KAAK,MAAMd,QAAQ,IAAIJ,mBAAmB,EAAE;IAC1CI,QAAQ,CAACc,OAAO,CAAC;EACnB;AACF;;AAEA;AACA,OAAO,SAASC,wBAAwBA,CAACf,QAAoC,EAAc;EACzFJ,mBAAmB,CAACU,GAAG,CAACN,QAAQ,CAAC;EACjC,OAAO,MAAM;IACXJ,mBAAmB,CAACW,MAAM,CAACP,QAAQ,CAAC;EACtC,CAAC;AACH","ignoreList":[]}

package/lib/module/ui/navigation/bottomSheetManager.js

@@ -0,0 +1,56 @@
+"use strict";
+
+import { isValidRoute } from "./routes.js";
+import { getSurfaceConfig } from "./surfaceRegistry.js";
+import { closeAllRouteSurfaces, presentRoute, topRouteSurface } from "./surfaces.js";
+
+/**
+ * Bottom-sheet manager — the INTERNAL adapter that keeps the historical
+ * `showBottomSheet` / `closeBottomSheet` API working on top of the new Bloom
+ * surface stack (`navigation/surfaces.ts`). The public signatures are unchanged;
+ * this file just re-expresses them as thin calls into the typed surface layer.
+ *
+ * The old single-surface store is gone: `showBottomSheet` now open-or-navigates
+ * the "base" (top-most) route surface, and cross-presentation targets (the
+ * full-bleed image picker) stack a NEW surface on top — Bloom coordinates the
+ * z-order / backdrop / dismiss so nothing clashes.
+ */
+
+/**
+ * Open a bottom-sheet route. By DEFAULT it drills into the top-most active
+ * surface — morphing it in place (every screen morphs). A NEW surface is stacked
+ * on top only when the target route declares `stacks` (reserved for genuine
+ * overlays — none today). Opening with no active surface presents the first one.
+ *
+ * `fullScreen` is accepted for signature compatibility and ignored — a route's
+ * surface is now derived from its registry config, not a per-call flag.
+ */
+export const showBottomSheet = screenOrConfig => {
+  const screen = typeof screenOrConfig === 'string' ? screenOrConfig : screenOrConfig.screen;
+  const props = typeof screenOrConfig === 'string' ? {} : screenOrConfig.props ?? {};
+  if (!isValidRoute(screen)) {
+    if (__DEV__) console.warn(`[BottomSheet] Invalid route: ${screen}`);
+    return;
+  }
+  const top = topRouteSurface();
+  if (top && !getSurfaceConfig(screen, props).stacks) {
+    top.navigate(screen, props);
+  } else {
+    presentRoute(screen, props);
+  }
+};
+
+/** Dismiss the whole bottom-sheet session (every active route surface). */
+export const closeBottomSheet = () => {
+  closeAllRouteSurfaces();
+};
+
+/**
+ * Step back within the top-most surface's route history. Returns `true` when a
+ * frame was popped, `false` when the surface is already at its root frame.
+ */
+export const goBack = () => {
+  const top = topRouteSurface();
+  return top ? top.goBack() : false;
+};
+//# sourceMappingURL=bottomSheetManager.js.map

package/lib/module/ui/navigation/bottomSheetManager.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isValidRoute","getSurfaceConfig","closeAllRouteSurfaces","presentRoute","topRouteSurface","showBottomSheet","screenOrConfig","screen","props","__DEV__","console","warn","top","stacks","navigate","closeBottomSheet","goBack"],"sourceRoot":"../../../../src","sources":["ui/navigation/bottomSheetManager.ts"],"mappings":";;AACA,SAASA,YAAY,QAAQ,aAAU;AACvC,SAASC,gBAAgB,QAAQ,sBAAmB;AACpD,SAASC,qBAAqB,EAAEC,YAAY,EAAEC,eAAe,QAAQ,eAAY;;AAEjF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,eAAe,GAC1BC,cAEgF,IACvE;EACT,MAAMC,MAAM,GAAG,OAAOD,cAAc,KAAK,QAAQ,GAAGA,cAAc,GAAGA,cAAc,CAACC,MAAM;EAC1F,MAAMC,KAAK,GAAG,OAAOF,cAAc,KAAK,QAAQ,GAAG,CAAC,CAAC,GAAGA,cAAc,CAACE,KAAK,IAAI,CAAC,CAAC;EAElF,IAAI,CAACR,YAAY,CAACO,MAAM,CAAC,EAAE;IACzB,IAAIE,OAAO,EAAEC,OAAO,CAACC,IAAI,CAAC,gCAAgCJ,MAAM,EAAE,CAAC;IACnE;EACF;EAEA,MAAMK,GAAG,GAAGR,eAAe,CAAC,CAAC;EAC7B,IAAIQ,GAAG,IAAI,CAACX,gBAAgB,CAACM,MAAM,EAAEC,KAAK,CAAC,CAACK,MAAM,EAAE;IAClDD,GAAG,CAACE,QAAQ,CAACP,MAAM,EAAEC,KAAK,CAAC;EAC7B,CAAC,MAAM;IACLL,YAAY,CAACI,MAAM,EAAEC,KAAK,CAAC;EAC7B;AACF,CAAC;;AAED;AACA,OAAO,MAAMO,gBAAgB,GAAGA,CAAA,KAAY;EAC1Cb,qBAAqB,CAAC,CAAC;AACzB,CAAC;;AAED;AACA;AACA;AACA;AACA,OAAO,MAAMc,MAAM,GAAGA,CAAA,KAAe;EACnC,MAAMJ,GAAG,GAAGR,eAAe,CAAC,CAAC;EAC7B,OAAOQ,GAAG,GAAGA,GAAG,CAACI,MAAM,CAAC,CAAC,GAAG,KAAK;AACnC,CAAC","ignoreList":[]}

package/lib/module/ui/navigation/routes.js

@@ -0,0 +1,104 @@
+"use strict";
+
+import { lazy } from 'react';
+
+// Define all available route names
+
+// Unified account switcher + sign-in surface (OxyAccountDialogScreen body)
+
+/**
+ * The component for each route, loaded on demand.
+ *
+ * Every entry is `lazy(() => import(...))`: the screen module is fetched and
+ * evaluated the first time its surface is presented, never at import time. That
+ * matters twice over — screens import `OxyContext`, which reaches back here, so
+ * eager evaluation would run screens mid-cycle; and it keeps native-only screen
+ * dependencies out of the evaluation path of every consumer that merely touches
+ * the SDK.
+ *
+ * What defers the load must NOT be `require()`. `@oxyhq/services` ships an ESM
+ * build, and a `require()` in ESM output forces web bundlers into CommonJS
+ * interop: rolldown-vite defers every module in the required subgraph behind a
+ * lazy initializer and then hands a consumer that statically imported one of
+ * them the still-`undefined` binding. That is how `OxySignInRequestSurface`
+ * reached auth.oxy.so/authorize as `undefined` and blanked the page with React
+ * error #130 — this registry pulled `OxyAccountDialogScreen`, and the whole
+ * sign-in surface subgraph with it, through `require()`.
+ *
+ * The value type is `ComponentType<never>`, which every screen satisfies. A few
+ * screens (`Profile`, `PaymentGateway`, `UserLinks`, `FollowersList`,
+ * `FollowingList`) declare props BEYOND {@link BaseScreenProps} — `userId`,
+ * `amount` — that only reach them through the route's untyped props bag
+ * (`present(route, props)`), so this map cannot prove they are satisfied. The
+ * previous `require()` returned `any` and hid that entirely; stating it here
+ * confines the gap to one documented widening in {@link getScreenComponent}.
+ */
+const screenComponents = {
+  ManageAccount: /*#__PURE__*/lazy(() => import('../screens/ManageAccountScreen')),
+  AccountVerification: /*#__PURE__*/lazy(() => import('../screens/AccountVerificationScreen')),
+  PaymentGateway: /*#__PURE__*/lazy(() => import('../screens/PaymentGatewayScreen')),
+  Profile: /*#__PURE__*/lazy(() => import('../screens/ProfileScreen')),
+  LanguageSelector: /*#__PURE__*/lazy(() => import('../screens/LanguageSelectorScreen')),
+  PrivacySettings: /*#__PURE__*/lazy(() => import('../screens/PrivacySettingsScreen')),
+  SearchSettings: /*#__PURE__*/lazy(() => import('../screens/SearchSettingsScreen')),
+  FileManagement: /*#__PURE__*/lazy(() => import('../screens/FileManagementScreen')),
+  HelpSupport: /*#__PURE__*/lazy(() => import('../screens/HelpSupportScreen')),
+  FAQ: /*#__PURE__*/lazy(() => import('../screens/FAQScreen')),
+  Feedback: /*#__PURE__*/lazy(() => import('../screens/FeedbackScreen')),
+  LegalDocuments: /*#__PURE__*/lazy(() => import('../screens/LegalDocumentsScreen')),
+  AppInfo: /*#__PURE__*/lazy(() => import('../screens/AppInfoScreen')),
+  PremiumSubscription: /*#__PURE__*/lazy(() => import('../screens/PremiumSubscriptionScreen')),
+  WelcomeNewUser: /*#__PURE__*/lazy(() => import('../screens/WelcomeNewUserScreen')),
+  UserLinks: /*#__PURE__*/lazy(() => import('../screens/UserLinksScreen')),
+  HistoryView: /*#__PURE__*/lazy(() => import('../screens/HistoryViewScreen')),
+  SavesCollections: /*#__PURE__*/lazy(() => import('../screens/SavesCollectionsScreen')),
+  EditProfile: /*#__PURE__*/lazy(() => import('../screens/EditProfileScreen')),
+  EditProfileField: /*#__PURE__*/lazy(() => import('../screens/EditProfileFieldScreen')),
+  // Informational screens
+  LearnMoreUsernames: /*#__PURE__*/lazy(() => import('../screens/LearnMoreUsernamesScreen')),
+  // Oxy Trust screens
+  TrustCenter: /*#__PURE__*/lazy(() => import('../screens/trust/TrustCenterScreen')),
+  TrustLeaderboard: /*#__PURE__*/lazy(() => import('../screens/trust/TrustLeaderboardScreen')),
+  TrustRewards: /*#__PURE__*/lazy(() => import('../screens/trust/TrustRewardsScreen')),
+  TrustRules: /*#__PURE__*/lazy(() => import('../screens/trust/TrustRulesScreen')),
+  AboutTrust: /*#__PURE__*/lazy(() => import('../screens/trust/TrustAboutScreen')),
+  TrustFAQ: /*#__PURE__*/lazy(() => import('../screens/trust/TrustFAQScreen')),
+  // User list screens (followers/following)
+  FollowersList: /*#__PURE__*/lazy(() => import('../screens/FollowersListScreen')),
+  FollowingList: /*#__PURE__*/lazy(() => import('../screens/FollowingListScreen')),
+  CreateAccount: /*#__PURE__*/lazy(() => import('../screens/CreateAccountScreen')),
+  AccountMembers: /*#__PURE__*/lazy(() => import('../screens/AccountMembersScreen')),
+  AccountSettings: /*#__PURE__*/lazy(() => import('../screens/AccountSettingsScreen')),
+  ChangeAvatar: /*#__PURE__*/lazy(() => import('../screens/ChangeAvatarScreen')),
+  AvatarCrop: /*#__PURE__*/lazy(() => import('../screens/AvatarCropScreen')),
+  Notifications: /*#__PURE__*/lazy(() => import('../screens/NotificationsScreen')),
+  ConnectedApps: /*#__PURE__*/lazy(() => import('../screens/ConnectedAppsScreen')),
+  Preferences: /*#__PURE__*/lazy(() => import('../screens/PreferencesScreen')),
+  // Unified account switcher + sign-in surface. Its body lives in the
+  // `OxyAccountDialogScreen` component (folded from the standalone dialog); the
+  // surface stack provides the Dialog chrome around it.
+  AccountDialog: /*#__PURE__*/lazy(() => import('../components/OxyAccountDialogScreen'))
+};
+
+/**
+ * Resolve the component for a route.
+ *
+ * The map is total over {@link RouteName} — the compiler enforces that at its
+ * declaration — so this returns `undefined` only for a caller that reached here
+ * with an unchecked string; {@link isValidRoute} is how such a caller narrows.
+ *
+ * The surface host renders the result with {@link BaseScreenProps} merged with
+ * the route's own props bag, so that is the type it is handed back as. This one
+ * widening is where the gap documented on {@link screenComponents} lives: the map
+ * dispatches on a string key, so a screen's extra prop requirements are met at
+ * `present(route, props)` call sites, not provable here. No caching is needed —
+ * React memoizes each `lazy()` component's module after its first load.
+ */
+export const getScreenComponent = routeName => screenComponents[routeName];
+
+// Helper function to check if a route exists
+// Uses the screenComponents map to check existence without loading the screen
+export const isValidRoute = routeName => {
+  return routeName in screenComponents;
+};
+//# sourceMappingURL=routes.js.map

package/lib/module/ui/navigation/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["lazy","screenComponents","ManageAccount","AccountVerification","PaymentGateway","Profile","LanguageSelector","PrivacySettings","SearchSettings","FileManagement","HelpSupport","FAQ","Feedback","LegalDocuments","AppInfo","PremiumSubscription","WelcomeNewUser","UserLinks","HistoryView","SavesCollections","EditProfile","EditProfileField","LearnMoreUsernames","TrustCenter","TrustLeaderboard","TrustRewards","TrustRules","AboutTrust","TrustFAQ","FollowersList","FollowingList","CreateAccount","AccountMembers","AccountSettings","ChangeAvatar","AvatarCrop","Notifications","ConnectedApps","Preferences","AccountDialog","getScreenComponent","routeName","isValidRoute"],"sourceRoot":"../../../../src","sources":["ui/navigation/routes.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/ui/navigation/surfaceBackBridge.js

@@ -0,0 +1,63 @@
+"use strict";
+
+import { BackHandler, Platform } from 'react-native';
+
+/**
+ * Per-surface system-back handlers (Android hardware back + web Escape).
+ *
+ * Bloom's `SurfaceHost` dismisses the whole top surface on back/Escape. The SDK
+ * needs the old `BottomSheetRouter` semantics first: pop nav history, step a
+ * wizard back, then dismiss. A single global listener delegates to the topmost
+ * registered handler so stacked surfaces route correctly.
+ */
+
+const handlerStack = [];
+let androidInstalled = false;
+let escapeInstalled = false;
+function invokeTopHandler() {
+  const handler = handlerStack[handlerStack.length - 1];
+  return handler ? handler() : false;
+}
+function installAndroidHandler() {
+  if (androidInstalled || Platform.OS !== 'android') return;
+  androidInstalled = true;
+  BackHandler.addEventListener('hardwareBackPress', () => {
+    if (handlerStack.length === 0) return false;
+    return invokeTopHandler();
+  });
+}
+function installEscapeHandler() {
+  if (escapeInstalled || Platform.OS !== 'web') return;
+  if (typeof window === 'undefined') return;
+  escapeInstalled = true;
+  window.addEventListener('keydown', event => {
+    if (event.key !== 'Escape' || handlerStack.length === 0) return;
+    invokeTopHandler();
+    event.stopImmediatePropagation();
+    event.preventDefault();
+  }, true);
+}
+
+/** Register before Bloom's `SurfaceHost` mounts so Escape capture runs first. */
+installEscapeHandler();
+
+/** Push a handler for one live surface; returns unregister. */
+export function pushSurfaceBackHandler(handler) {
+  handlerStack.push(handler);
+  installAndroidHandler();
+  return () => {
+    const index = handlerStack.lastIndexOf(handler);
+    if (index >= 0) handlerStack.splice(index, 1);
+  };
+}
+
+/** Test-only: invoke the top handler. */
+export function __invokeTopSurfaceBackForTests() {
+  return invokeTopHandler();
+}
+
+/** Test-only reset. */
+export function __resetSurfaceBackBridgeForTests() {
+  handlerStack.length = 0;
+}
+//# sourceMappingURL=surfaceBackBridge.js.map

package/lib/module/ui/navigation/surfaceBackBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["BackHandler","Platform","handlerStack","androidInstalled","escapeInstalled","invokeTopHandler","handler","length","installAndroidHandler","OS","addEventListener","installEscapeHandler","window","event","key","stopImmediatePropagation","preventDefault","pushSurfaceBackHandler","push","index","lastIndexOf","splice","__invokeTopSurfaceBackForTests","__resetSurfaceBackBridgeForTests"],"sourceRoot":"../../../../src","sources":["ui/navigation/surfaceBackBridge.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,QAAQ,QAAQ,cAAc;;AAEpD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,MAAMC,YAAkC,GAAG,EAAE;AAC7C,IAAIC,gBAAgB,GAAG,KAAK;AAC5B,IAAIC,eAAe,GAAG,KAAK;AAE3B,SAASC,gBAAgBA,CAAA,EAAY;EACnC,MAAMC,OAAO,GAAGJ,YAAY,CAACA,YAAY,CAACK,MAAM,GAAG,CAAC,CAAC;EACrD,OAAOD,OAAO,GAAGA,OAAO,CAAC,CAAC,GAAG,KAAK;AACpC;AAEA,SAASE,qBAAqBA,CAAA,EAAS;EACrC,IAAIL,gBAAgB,IAAIF,QAAQ,CAACQ,EAAE,KAAK,SAAS,EAAE;EACnDN,gBAAgB,GAAG,IAAI;EACvBH,WAAW,CAACU,gBAAgB,CAAC,mBAAmB,EAAE,MAAM;IACtD,IAAIR,YAAY,CAACK,MAAM,KAAK,CAAC,EAAE,OAAO,KAAK;IAC3C,OAAOF,gBAAgB,CAAC,CAAC;EAC3B,CAAC,CAAC;AACJ;AAEA,SAASM,oBAAoBA,CAAA,EAAS;EACpC,IAAIP,eAAe,IAAIH,QAAQ,CAACQ,EAAE,KAAK,KAAK,EAAE;EAC9C,IAAI,OAAOG,MAAM,KAAK,WAAW,EAAE;EACnCR,eAAe,GAAG,IAAI;EACtBQ,MAAM,CAACF,gBAAgB,CACrB,SAAS,EACRG,KAAK,IAAK;IACT,IAAIA,KAAK,CAACC,GAAG,KAAK,QAAQ,IAAIZ,YAAY,CAACK,MAAM,KAAK,CAAC,EAAE;IACzDF,gBAAgB,CAAC,CAAC;IAClBQ,KAAK,CAACE,wBAAwB,CAAC,CAAC;IAChCF,KAAK,CAACG,cAAc,CAAC,CAAC;EACxB,CAAC,EACD,IACF,CAAC;AACH;;AAEA;AACAL,oBAAoB,CAAC,CAAC;;AAEtB;AACA,OAAO,SAASM,sBAAsBA,CAACX,OAA2B,EAAc;EAC9EJ,YAAY,CAACgB,IAAI,CAACZ,OAAO,CAAC;EAC1BE,qBAAqB,CAAC,CAAC;EACvB,OAAO,MAAM;IACX,MAAMW,KAAK,GAAGjB,YAAY,CAACkB,WAAW,CAACd,OAAO,CAAC;IAC/C,IAAIa,KAAK,IAAI,CAAC,EAAEjB,YAAY,CAACmB,MAAM,CAACF,KAAK,EAAE,CAAC,CAAC;EAC/C,CAAC;AACH;;AAEA;AACA,OAAO,SAASG,8BAA8BA,CAAA,EAAY;EACxD,OAAOjB,gBAAgB,CAAC,CAAC;AAC3B;;AAEA;AACA,OAAO,SAASkB,gCAAgCA,CAAA,EAAS;EACvDrB,YAAY,CAACK,MAAM,GAAG,CAAC;AACzB","ignoreList":[]}