@oxyhq/services 30.0.0 → 30.1.0

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

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","_interopRequireWildcard","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","screenComponents","ManageAccount","lazy","Promise","resolve","then","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","exports","isValidRoute"],"sourceRoot":"../../../../src","sources":["ui/navigation/routes.ts"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,68 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.__invokeTopSurfaceBackForTests = __invokeTopSurfaceBackForTests;
+exports.__resetSurfaceBackBridgeForTests = __resetSurfaceBackBridgeForTests;
+exports.pushSurfaceBackHandler = pushSurfaceBackHandler;
+var _reactNative = require("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 || _reactNative.Platform.OS !== 'android') return;
+  androidInstalled = true;
+  _reactNative.BackHandler.addEventListener('hardwareBackPress', () => {
+    if (handlerStack.length === 0) return false;
+    return invokeTopHandler();
+  });
+}
+function installEscapeHandler() {
+  if (escapeInstalled || _reactNative.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. */
+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. */
+function __invokeTopSurfaceBackForTests() {
+  return invokeTopHandler();
+}
+
+/** Test-only reset. */
+function __resetSurfaceBackBridgeForTests() {
+  handlerStack.length = 0;
+}
+//# sourceMappingURL=surfaceBackBridge.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","handlerStack","androidInstalled","escapeInstalled","invokeTopHandler","handler","length","installAndroidHandler","Platform","OS","BackHandler","addEventListener","installEscapeHandler","window","event","key","stopImmediatePropagation","preventDefault","pushSurfaceBackHandler","push","index","lastIndexOf","splice","__invokeTopSurfaceBackForTests","__resetSurfaceBackBridgeForTests"],"sourceRoot":"../../../../src","sources":["ui/navigation/surfaceBackBridge.ts"],"mappings":";;;;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAEA;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,IAAIM,qBAAQ,CAACC,EAAE,KAAK,SAAS,EAAE;EACnDP,gBAAgB,GAAG,IAAI;EACvBQ,wBAAW,CAACC,gBAAgB,CAAC,mBAAmB,EAAE,MAAM;IACtD,IAAIV,YAAY,CAACK,MAAM,KAAK,CAAC,EAAE,OAAO,KAAK;IAC3C,OAAOF,gBAAgB,CAAC,CAAC;EAC3B,CAAC,CAAC;AACJ;AAEA,SAASQ,oBAAoBA,CAAA,EAAS;EACpC,IAAIT,eAAe,IAAIK,qBAAQ,CAACC,EAAE,KAAK,KAAK,EAAE;EAC9C,IAAI,OAAOI,MAAM,KAAK,WAAW,EAAE;EACnCV,eAAe,GAAG,IAAI;EACtBU,MAAM,CAACF,gBAAgB,CACrB,SAAS,EACRG,KAAK,IAAK;IACT,IAAIA,KAAK,CAACC,GAAG,KAAK,QAAQ,IAAId,YAAY,CAACK,MAAM,KAAK,CAAC,EAAE;IACzDF,gBAAgB,CAAC,CAAC;IAClBU,KAAK,CAACE,wBAAwB,CAAC,CAAC;IAChCF,KAAK,CAACG,cAAc,CAAC,CAAC;EACxB,CAAC,EACD,IACF,CAAC;AACH;;AAEA;AACAL,oBAAoB,CAAC,CAAC;;AAEtB;AACO,SAASM,sBAAsBA,CAACb,OAA2B,EAAc;EAC9EJ,YAAY,CAACkB,IAAI,CAACd,OAAO,CAAC;EAC1BE,qBAAqB,CAAC,CAAC;EACvB,OAAO,MAAM;IACX,MAAMa,KAAK,GAAGnB,YAAY,CAACoB,WAAW,CAAChB,OAAO,CAAC;IAC/C,IAAIe,KAAK,IAAI,CAAC,EAAEnB,YAAY,CAACqB,MAAM,CAACF,KAAK,EAAE,CAAC,CAAC;EAC/C,CAAC;AACH;;AAEA;AACO,SAASG,8BAA8BA,CAAA,EAAY;EACxD,OAAOnB,gBAAgB,CAAC,CAAC;AAC3B;;AAEA;AACO,SAASoB,gCAAgCA,CAAA,EAAS;EACvDvB,YAAY,CAACK,MAAM,GAAG,CAAC;AACzB","ignoreList":[]}

package/lib/commonjs/ui/navigation/surfaceNavStack.js

@@ -0,0 +1,146 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createSurfaceNavStack = createSurfaceNavStack;
+var _vanilla = require("zustand/vanilla");
+/**
+ * Per-surface route history — the NAV-WITHIN axis.
+ *
+ * Bloom's surface stack owns DEPTH (a surface presented on top of another). This
+ * store owns the ORTHOGONAL axis: the route history INSIDE one SDK surface. Each
+ * SDK surface holds its own {@link SurfaceNavStack}; `navigate`/`replace`/`goBack`
+ * mutate it and the SAME Bloom surface re-renders its content from the new top
+ * frame. It is the per-surface reincarnation of the old global
+ * `bottomSheetStore`'s `history` + `currentStep`.
+ *
+ * `closing`/`closeResult` model a pending dismissal: the surface's `SurfaceScreen`
+ * watches them and calls the Bloom surface's `dismiss(result)` from an effect —
+ * so a dismiss requested BEFORE the surface has mounted still resolves once it
+ * does, with no controls-capture race and no render-phase side effect.
+ */
+
+/** One frame in a surface's route history. */
+
+function makeFrame(route, props) {
+  const resolved = props ?? {};
+  const step = typeof resolved.initialStep === 'number' ? resolved.initialStep : 0;
+  return {
+    route,
+    props: resolved,
+    step
+  };
+}
+function createSurfaceNavStack(route, props) {
+  const store = (0, _vanilla.createStore)(() => ({
+    frames: [makeFrame(route, props)],
+    closing: false,
+    closeResult: undefined
+  }));
+  const getTop = () => {
+    const {
+      frames
+    } = store.getState();
+    return frames[frames.length - 1];
+  };
+
+  // Result-bearing sub-flows currently running in this surface (e.g. the morphed-
+  // in avatar flow, whose `ChangeAvatar → FileManagement picker → AvatarCrop`
+  // frames are plain forward pushes ON TOP of the ONE flow entry frame). Held as a
+  // STACK so flows can nest generically, and OUTSIDE the store (resolvers are
+  // functions; flow presence must not re-render frames). Each flow's `returnLength`
+  // is the frame count BEFORE its entry frame was pushed, so settling pops back to
+  // exactly the frame that started it. `flowStack` is ordered outer → inner; the
+  // top is the innermost.
+  const flowStack = [];
+  const requestDismiss = result => {
+    // Dismissing the whole surface abandons EVERY pending sub-flow — settle each
+    // promise so an awaiting caller (the avatar picker) never hangs.
+    while (flowStack.length) flowStack.pop()?.resolve(undefined);
+    if (store.getState().closing) return;
+    store.setState({
+      closing: true,
+      closeResult: result
+    });
+  };
+  const goBack = () => {
+    const {
+      frames
+    } = store.getState();
+    if (frames.length <= 1) return false;
+    const nextLength = frames.length - 1;
+    store.setState({
+      frames: frames.slice(0, -1)
+    });
+    // Backing out past a sub-flow's entry frame cancels it (resolve undefined).
+    // A single pop crosses at most one boundary, but loop for safety.
+    while (flowStack.length && nextLength <= flowStack[flowStack.length - 1].returnLength) {
+      flowStack.pop()?.resolve(undefined);
+    }
+    return true;
+  };
+  return {
+    store,
+    getTop,
+    requestDismiss,
+    goBack,
+    navigate(nextRoute, nextProps) {
+      store.setState(state => ({
+        frames: [...state.frames, makeFrame(nextRoute, nextProps)]
+      }));
+    },
+    replace(nextRoute, nextProps) {
+      store.setState(state => ({
+        frames: [...state.frames.slice(0, -1), makeFrame(nextRoute, nextProps)]
+      }));
+    },
+    canGoBack() {
+      const {
+        frames
+      } = store.getState();
+      return frames.length > 1 || (frames[frames.length - 1]?.step ?? 0) > 0;
+    },
+    setStep(step) {
+      store.setState(state => {
+        const frames = state.frames.slice();
+        const index = frames.length - 1;
+        frames[index] = {
+          ...frames[index],
+          step
+        };
+        return {
+          frames
+        };
+      });
+    },
+    beginFlow(nextRoute, nextProps) {
+      const returnLength = store.getState().frames.length;
+      store.setState(state => ({
+        frames: [...state.frames, makeFrame(nextRoute, nextProps)]
+      }));
+      return new Promise(resolve => {
+        flowStack.push({
+          returnLength,
+          resolve
+        });
+      });
+    },
+    resolveFlowOrDismiss(result) {
+      const flow = flowStack.pop();
+      if (!flow) {
+        // No flow → this screen owns its surface; dismiss it as before.
+        requestDismiss(result);
+        return;
+      }
+      store.setState(state => ({
+        frames: state.frames.slice(0, flow.returnLength)
+      }));
+      flow.resolve(result);
+    },
+    abandonActiveFlow() {
+      while (flowStack.length) flowStack.pop()?.resolve(undefined);
+    }
+  };
+}
+//# sourceMappingURL=surfaceNavStack.js.map

package/lib/commonjs/ui/navigation/surfaceNavStack.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_vanilla","require","makeFrame","route","props","resolved","step","initialStep","createSurfaceNavStack","store","createStore","frames","closing","closeResult","undefined","getTop","getState","length","flowStack","requestDismiss","result","pop","resolve","setState","goBack","nextLength","slice","returnLength","navigate","nextRoute","nextProps","state","replace","canGoBack","setStep","index","beginFlow","Promise","push","resolveFlowOrDismiss","flow","abandonActiveFlow"],"sourceRoot":"../../../../src","sources":["ui/navigation/surfaceNavStack.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/ui/navigation/surfaceRegistry.js

@@ -0,0 +1,147 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getSurfacePresentation = exports.getSurfaceConfig = void 0;
+/**
+ * The SDK's typed surface registry — the contract layer the SDK stacks on top of
+ * Bloom's content-agnostic surface stack (`@oxyhq/bloom/surfaces`). One entry per
+ * route describing its `props` (what the presenter must pass) and its `result`
+ * (what awaiting `present()` resolves with). Hand-maintained, contract-first:
+ * adding a route here is the single edit that types it end to end.
+ *
+ * For P1 most routes keep permissive `Record<string, unknown>` props + a `void`
+ * result — the historical grab-bag `showBottomSheet`/`navigate` props are
+ * unchanged. Later phases tighten individual routes without changing this shape.
+ */
+
+/** One registry entry: the props a route is presented with + its dismissal result. */
+
+/**
+ * Compile-time guard: the registry keys must be EXACTLY the route names. If a new
+ * `RouteName` is added without a registry entry (or vice-versa) this alias
+ * resolves to `never` and the `satisfies` assertion below fails to type-check.
+ */
+
+const _registryCoversRoutes = true;
+void _registryCoversRoutes;
+
+/** Typed props a route is presented with. */
+
+/** What awaiting a route's `present()` resolves with when it is dismissed. */
+
+/**
+ * How a surface renders — the SDK's presentation taxonomy. Each value maps to a
+ * concrete Bloom `Dialog` placement/chrome in `surfaces.ts`:
+ *
+ *   - `'sheet'`      → responsive `{ base: 'bottom', md: 'center' }` (the default,
+ *                      and — since every screen morphs — the presentation of EVERY
+ *                      route today: a bottom sheet on narrow, a centered card wide).
+ *   - `'center'`     → a plain centered modal at every width. Currently unused.
+ *   - `'drawer'`     → responsive `{ base: 'bottom', md: 'left' }` side drawer.
+ *                      Currently unused.
+ *   - `'fullScreen'` → a flush black-canvas surface (`contentPadding: 0`,
+ *                      programmatic-only dismiss). Currently unused: the flagship
+ *                      photo picker now MORPHS in place as a `sheet` (it paints its
+ *                      own black canvas + bar inside the themed panel), so nothing
+ *                      needs a stacked full-bleed surface. Retained for a future
+ *                      route that genuinely must be full-bleed.
+ */
+
+/**
+ * Per-route surface configuration. Merges the historical `SheetRouteConfig`
+ * knobs with the new {@link SurfacePresentation}.
+ *
+ * NOTE: `scrollable` is LIVE — it is threaded through `bloomOptionsFor` onto the
+ * Bloom `Dialog` surface (`scrollable` prop), so a route that owns its own scroll
+ * container opts OUT of the Dialog's internal ScrollView. `manualActivation` /
+ * `dynamicBackdrop` / `handleComponent` remain informational — reserved for a
+ * future Bloom bottom-placement passthrough; the shared `DialogBottomSheet`
+ * currently owns pan coordination itself.
+ */
+
+/** Defaults shared across all routes — the canonical responsive "sheet". */
+const DEFAULT_SURFACE_CONFIG = {
+  presentation: 'sheet',
+  scrollable: true,
+  header: true,
+  morph: true,
+  stacks: false,
+  manualActivation: true,
+  dynamicBackdrop: true
+};
+
+/**
+ * Predicate matching `FileManagementScreen`'s internal `isImageOnlyPicker`
+ * derivation. When the consumer restricts to image MIME types (no videos, no
+ * audio, no documents), FileManagement renders the flagship `PhotoPickerView`,
+ * which owns its own FlatList and reads best as a full-bleed picker. Kept in sync
+ * with `FileManagementScreen` — both check the same disabled MIME type families.
+ */
+const isFileManagementImageOnlyPicker = props => {
+  if (!props.selectMode) return false;
+  const disabled = props.disabledMimeTypes;
+  if (!Array.isArray(disabled) || disabled.length === 0) return false;
+  const has = predicate => disabled.some(mt => typeof mt === 'string' && predicate(mt));
+  const blocksVideos = has(mt => mt === 'video/' || mt.startsWith('video/'));
+  const blocksAudio = has(mt => mt === 'audio/' || mt.startsWith('audio/'));
+  const blocksDocs = has(mt => mt === 'application/pdf' || mt === 'application/' || mt.startsWith('application/'));
+  return blocksVideos && blocksAudio && blocksDocs;
+};
+
+/**
+ * Routes whose screen owns its OWN scroll container — a FlatList /
+ * VirtualizedList (`ConnectedApps`, `TrustLeaderboard`, `FollowersList` /
+ * `FollowingList` via `UserListScreen`) or its own vertical `ScrollView`
+ * (`FileManagement`). These MUST opt out of the Dialog's internal ScrollView
+ * (`scrollable: false`) so there is exactly ONE scroll container — otherwise a
+ * VirtualizedList nests inside a plain ScrollView (RN warning) or a nested
+ * vertical scroll-in-scroll breaks windowing. Screens with only a HORIZONTAL
+ * ScrollView (FAQ's category row, Premium's plan carousel) are NOT listed — a
+ * horizontal scroller does not conflict with the Dialog's vertical scroll.
+ */
+const OWN_SCROLL_CONTAINER_ROUTES = new Set(['FileManagement', 'ConnectedApps', 'TrustLeaderboard', 'FollowersList', 'FollowingList']);
+
+/**
+ * Resolve the surface configuration for a route + props. Every route defaults to
+ * the responsive sheet, renders the SHARED Dialog nav header, and MORPHS in place
+ * when navigated to from within a surface (no route stacks — genuine overlays are
+ * Bloom-raw `surfaces.present`/`confirm` calls, outside this registry). The
+ * image-only FileManagement picker is a normal sheet that owns its own scroll and
+ * grows to a large morph target; every other own-scroller is `scrollable: false`.
+ */
+const getSurfaceConfig = (route, props) => {
+  if (route === 'FileManagement' && isFileManagementImageOnlyPicker(props)) {
+    // The flagship photo picker MORPHS in place like every other screen. It is an
+    // own-scroller (`PhotoPickerView`'s FlatList) that paints its full-bleed black
+    // photo canvas as CONTENT under the SHARED Dialog nav header (Cancel / title /
+    // Upload), exactly like the crop stage under the same bar. It needs ROOM for
+    // the photo grid, so it declares an explicit LARGE morph target — the panel
+    // grows UP to a near-full-height, wider card on entry (and back down on
+    // pick→crop), the grid scrolling within.
+    return {
+      ...DEFAULT_SURFACE_CONFIG,
+      scrollable: false,
+      frameSize: {
+        heightRatio: 0.9,
+        maxWidth: 640
+      }
+    };
+  }
+  if (OWN_SCROLL_CONTAINER_ROUTES.has(route)) {
+    // Own-scroller list screens keep the nav header (static, non-collapsing —
+    // there is no Dialog scroll offset to drive the large-title collapse).
+    return {
+      ...DEFAULT_SURFACE_CONFIG,
+      scrollable: false
+    };
+  }
+  return DEFAULT_SURFACE_CONFIG;
+};
+
+/** Convenience: just the presentation taxonomy for a route + props. */
+exports.getSurfaceConfig = getSurfaceConfig;
+const getSurfacePresentation = (route, props) => getSurfaceConfig(route, props).presentation;
+exports.getSurfacePresentation = getSurfacePresentation;
+//# sourceMappingURL=surfaceRegistry.js.map

package/lib/commonjs/ui/navigation/surfaceRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_registryCoversRoutes","DEFAULT_SURFACE_CONFIG","presentation","scrollable","header","morph","stacks","manualActivation","dynamicBackdrop","isFileManagementImageOnlyPicker","props","selectMode","disabled","disabledMimeTypes","Array","isArray","length","has","predicate","some","mt","blocksVideos","startsWith","blocksAudio","blocksDocs","OWN_SCROLL_CONTAINER_ROUTES","Set","getSurfaceConfig","route","frameSize","heightRatio","maxWidth","exports","getSurfacePresentation"],"sourceRoot":"../../../../src","sources":["ui/navigation/surfaceRegistry.ts"],"mappings":"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","ignoreList":[]}