@oxyhq/services 22.8.7 → 22.10.0

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

@@ -0,0 +1,98 @@
+"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];
+  };
+  return {
+    store,
+    getTop,
+    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)]
+      }));
+    },
+    goBack() {
+      const {
+        frames
+      } = store.getState();
+      if (frames.length <= 1) return false;
+      store.setState({
+        frames: frames.slice(0, -1)
+      });
+      return true;
+    },
+    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
+        };
+      });
+    },
+    requestDismiss(result) {
+      if (store.getState().closing) return;
+      store.setState({
+        closing: true,
+        closeResult: result
+      });
+    }
+  };
+}
+//# 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","navigate","nextRoute","nextProps","setState","state","replace","slice","goBack","canGoBack","setStep","index","requestDismiss","result"],"sourceRoot":"../../../../src","sources":["ui/navigation/surfaceNavStack.ts"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,152 @@
+"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:
+ *                      a bottom sheet on narrow viewports, a centered card on wide).
+ *   - `'center'`     → a plain centered modal at every width.
+ *   - `'drawer'`     → responsive `{ base: 'bottom', md: 'left' }` side drawer.
+ *   - `'fullScreen'` → approximated with the shared `Dialog`: a full-height sheet /
+ *                      large centered card, flush (`contentPadding: 0`) content, a
+ *                      black canvas and programmatic-only dismiss (the flagship
+ *                      image picker). A real Bloom `'fullScreen'` placement is a
+ *                      follow-up if the approximation reads wrong on device.
+ */
+
+/**
+ * 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,
+  manualActivation: true,
+  dynamicBackdrop: true
+};
+
+/**
+ * Routes that render NO Dialog nav header — they own their chrome:
+ * - `AvatarCrop` — its own translucent Cancel / title / Done top bar.
+ * - `PaymentGateway` — the payment surface owns its controls.
+ * - `WelcomeNewUser` — a full-bleed onboarding wizard with its own step chrome.
+ * - `Profile` — a full profile view, no nav-header chrome.
+ * (The flagship full-bleed image picker is handled separately below.)
+ *
+ * `AccountDialog` used to be here — it now uses the SHARED Dialog nav header like
+ * every other screen (its per-view title/subtitle + view-back go through
+ * `useSurfaceHeader`), so the account/sign-in surface no longer feels bespoke.
+ */
+const HEADERLESS_ROUTES = new Set(['AvatarCrop', 'PaymentGateway', 'WelcomeNewUser', 'Profile']);
+
+/**
+ * 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. Defaults to the
+ * responsive sheet; the image-only FileManagement picker upgrades to a full-bleed
+ * `'fullScreen'` surface, and every route that owns its own scroll container is
+ * marked `scrollable: false`.
+ */
+const getSurfaceConfig = (route, props) => {
+  if (route === 'FileManagement' && isFileManagementImageOnlyPicker(props)) {
+    // The full-bleed image picker owns its own translucent top bar — no nav header.
+    return {
+      ...DEFAULT_SURFACE_CONFIG,
+      presentation: 'fullScreen',
+      scrollable: false,
+      header: false
+    };
+  }
+  if (HEADERLESS_ROUTES.has(route)) {
+    return {
+      ...DEFAULT_SURFACE_CONFIG,
+      header: false
+    };
+  }
+  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","manualActivation","dynamicBackdrop","HEADERLESS_ROUTES","Set","isFileManagementImageOnlyPicker","props","selectMode","disabled","disabledMimeTypes","Array","isArray","length","has","predicate","some","mt","blocksVideos","startsWith","blocksAudio","blocksDocs","OWN_SCROLL_CONTAINER_ROUTES","getSurfaceConfig","route","exports","getSurfacePresentation"],"sourceRoot":"../../../../src","sources":["ui/navigation/surfaceRegistry.ts"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,256 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.closeAllRouteSurfaces = closeAllRouteSurfaces;
+exports.navigateWithinOrPresent = navigateWithinOrPresent;
+exports.present = present;
+exports.presentDetached = presentDetached;
+exports.presentRoute = presentRoute;
+exports.replaceWithinOrPresent = replaceWithinOrPresent;
+exports.surfaces = void 0;
+exports.topRouteSurface = topRouteSurface;
+exports.useSurfaces = useSurfaces;
+var _react = require("react");
+var _surfaces = require("@oxyhq/bloom/surfaces");
+var _SurfaceScreen = _interopRequireDefault(require("../components/SurfaceScreen.js"));
+var _surfaceRegistry = require("./surfaceRegistry.js");
+var _surfaceNavStack = require("./surfaceNavStack.js");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * The SDK's typed surface API — a route registry layered on top of Bloom's
+ * content-agnostic surface stack (`@oxyhq/bloom/surfaces`).
+ *
+ * `present(route)` opens a NEW Bloom surface (the DEPTH axis) whose content is a
+ * {@link SurfaceScreen} driven by the route's own {@link SurfaceNavStack} (the
+ * NAV-WITHIN axis). Navigating within that surface mutates its nav stack and
+ * re-renders the SAME Bloom surface; presenting stacks another surface on top.
+ *
+ * Bloom coordinates z-order / backdrop / dismiss across every surface (SDK's and
+ * apps'), so nothing clashes.
+ */
+
+/** Responsive "sheet": bottom sheet on narrow, centered card on wide. */
+const SHEET_PLACEMENT = {
+  base: 'bottom',
+  md: 'center'
+};
+
+/** Full-bleed black canvas for the `'fullScreen'` approximation (image picker). */
+const FULLSCREEN_SURFACE_STYLE = {
+  backgroundColor: '#000000',
+  overflow: 'hidden'
+};
+
+/**
+ * Every SDK screen owns its own background + content padding + scroll region
+ * (they were authored for the bare `BottomSheet`). So the shared `Dialog` must
+ * NOT add its own `contentPadding` on top (that double-pads) — it owns only the
+ * structural chrome: the surface card, the size cap (`maxHeightRatio`) and the
+ * scroll boundary. `contentPadding: 0` makes the screen's own padding the single
+ * source, matching the image-picker (`fullScreen`) surface.
+ */
+const SDK_SURFACE_CHROME = {
+  contentPadding: 0,
+  maxHeightRatio: 0.9
+};
+
+/** Map a route's presentation taxonomy onto concrete Bloom `Dialog` options. */
+function bloomOptionsFor(config) {
+  // Threaded onto every placement so a route that owns its own scroll container
+  // (`scrollable: false`) opts out of the Dialog's internal ScrollView.
+  const scrollable = config.scrollable;
+  // Nav-header mode marker: turns on the Dialog's OWN sticky gradient nav bar +
+  // large collapsing title over its scroll content. The title/subtitle/action
+  // slots are contributed at runtime by the mounted screen via `useSurfaceHeader`
+  // (resolved in `SurfaceScreen`), so the seed here just enables the scaffold.
+  const header = config.header ? {
+    largeTitle: true
+  } : undefined;
+  switch (config.presentation) {
+    case 'center':
+      return {
+        placement: 'center',
+        scrollable,
+        header,
+        ...SDK_SURFACE_CHROME
+      };
+    case 'drawer':
+      return {
+        placement: {
+          base: 'bottom',
+          md: 'left'
+        },
+        scrollable,
+        header,
+        ...SDK_SURFACE_CHROME
+      };
+    case 'fullScreen':
+      // Approximate a full-screen surface with the shared `Dialog`: a tall
+      // sheet / large centered card, flush content, a black canvas and
+      // programmatic-only dismiss — matching the shipped image-picker Dialog.
+      return {
+        placement: SHEET_PLACEMENT,
+        contentPadding: 0,
+        maxWidth: 640,
+        maxHeightRatio: 0.9,
+        dismissOnBackdrop: false,
+        scrollable,
+        style: FULLSCREEN_SURFACE_STYLE,
+        panelStyle: FULLSCREEN_SURFACE_STYLE
+      };
+    default:
+      return {
+        placement: SHEET_PLACEMENT,
+        scrollable,
+        header,
+        ...SDK_SURFACE_CHROME
+      };
+  }
+}
+
+/**
+ * A live handle to a presented SDK surface. Exposes DEPTH controls (`dismiss`,
+ * `result`) and NAV-WITHIN controls (`navigate`/`replace`/`goBack`/`setStep`) that
+ * drive this surface's own nav stack. Held by the `showBottomSheet` adapter (base
+ * surface) and by `OxyContext` (the AccountDialog surface).
+ */
+
+/**
+ * The type-erased handle the `showBottomSheet` adapter needs from a tracked
+ * surface: what it hosts, and how to drive/dismiss it. Kept result-type-free so
+ * the (generic) `SurfaceInstance<K>` never has to be widened into a shared array.
+ */
+
+/**
+ * Active SDK "route" surfaces (the `showBottomSheet` lineage), bottom → top.
+ * `present`/`presentRoute` register here; `presentDetached` (AccountDialog) does
+ * NOT, so the base-sheet navigation logic never treats the account modal as a
+ * navigable base. Entries self-remove when their surface is dismissed.
+ */
+const activeRouteSurfaces = [];
+function presentInternal(route, props, opts, track) {
+  const navStack = (0, _surfaceNavStack.createSurfaceNavStack)(route, props);
+  const config = (0, _surfaceRegistry.getSurfaceConfig)(route, props);
+  const bloomOpts = {
+    label: route,
+    ...bloomOptionsFor(config),
+    ...opts
+  };
+  const result = _surfaces.surfaces.present(surface => /*#__PURE__*/(0, _react.createElement)(_SurfaceScreen.default, {
+    navStack,
+    surface,
+    presentation: config.presentation,
+    dismissOnBackdrop: bloomOpts.dismissOnBackdrop ?? true
+  }), bloomOpts);
+  const instance = {
+    route,
+    presentation: config.presentation,
+    navigate: (nextRoute, nextProps) => {
+      const top = navStack.getTop();
+      if (top.route === nextRoute) navStack.replace(nextRoute, nextProps);else navStack.navigate(nextRoute, nextProps);
+    },
+    replace: (nextRoute, nextProps) => navStack.replace(nextRoute, nextProps),
+    goBack: () => navStack.goBack(),
+    canGoBack: () => navStack.canGoBack(),
+    setStep: step => navStack.setStep(step),
+    dismiss: dismissResult => navStack.requestDismiss(dismissResult),
+    result
+  };
+  if (track) {
+    const tracked = {
+      route: instance.route,
+      presentation: instance.presentation,
+      navigate: instance.navigate,
+      goBack: instance.goBack,
+      dismiss: () => instance.dismiss()
+    };
+    activeRouteSurfaces.push(tracked);
+    result.finally(() => {
+      const index = activeRouteSurfaces.indexOf(tracked);
+      if (index >= 0) activeRouteSurfaces.splice(index, 1);
+    });
+  }
+  return instance;
+}
+
+/**
+ * Present a NEW route surface on top of the stack (the DEPTH axis). Resolves with
+ * the value the surface is dismissed with. Registered in the route-surface stack.
+ */
+function present(route, props, opts) {
+  return presentInternal(route, props ?? {}, opts, true);
+}
+
+/**
+ * Present a surface that is NOT part of the `showBottomSheet` base-navigation
+ * lineage (the AccountDialog modal). Otherwise identical to {@link present}.
+ */
+function presentDetached(route, props, opts) {
+  return presentInternal(route, props ?? {}, opts, false);
+}
+
+/**
+ * Untyped present for the adapter, the nav helpers, and the `SurfaceScreen`
+ * binding (where the route is a runtime value and its props are already erased).
+ */
+function presentRoute(route, props) {
+  return presentInternal(route, props ?? {}, undefined, true);
+}
+
+/** The top-most active route surface, or `undefined` when none are open. */
+function topRouteSurface() {
+  return activeRouteSurfaces[activeRouteSurfaces.length - 1];
+}
+
+/**
+ * Dismiss every active route surface (the whole `showBottomSheet` session). The
+ * AccountDialog is untracked, so it is untouched. Iterates a snapshot because
+ * `dismiss` mutates `activeRouteSurfaces` asynchronously as surfaces settle.
+ */
+function closeAllRouteSurfaces() {
+  for (const instance of [...activeRouteSurfaces].reverse()) instance.dismiss();
+}
+
+/**
+ * Drill in from a screen: navigate WITHIN the current surface when the target's
+ * presentation matches, else present the target as a NEW surface on top (so a
+ * sheet screen opening the full-bleed picker gets the right chrome).
+ */
+function navigateWithinOrPresent(currentPresentation, navStack, route, props) {
+  const nextProps = props ?? {};
+  if ((0, _surfaceRegistry.getSurfacePresentation)(route, nextProps) === currentPresentation) {
+    navStack.navigate(route, nextProps);
+  } else {
+    presentRoute(route, nextProps);
+  }
+}
+
+/** Replace variant of {@link navigateWithinOrPresent}. */
+function replaceWithinOrPresent(currentPresentation, navStack, route, props) {
+  const nextProps = props ?? {};
+  if ((0, _surfaceRegistry.getSurfacePresentation)(route, nextProps) === currentPresentation) {
+    navStack.replace(route, nextProps);
+  } else {
+    presentRoute(route, nextProps);
+  }
+}
+
+/**
+ * The SDK's imperative surface API (a module singleton). `present` is the typed
+ * route presenter; `dismissAll` unwinds the whole session. Not yet exported from
+ * the package root — the public `surfaces`/`useSurfaces` API lands in a later
+ * phase; for P1 the internal adapters (`showBottomSheet`, `openAccountDialog`)
+ * are the only public entry points.
+ */
+const surfaces = exports.surfaces = {
+  present: (route, props, opts) => present(route, props, opts).result,
+  dismissAll: closeAllRouteSurfaces
+};
+
+/** Hook form of {@link surfaces} (stable singleton). */
+function useSurfaces() {
+  return surfaces;
+}
+//# sourceMappingURL=surfaces.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","_surfaces","_SurfaceScreen","_interopRequireDefault","_surfaceRegistry","_surfaceNavStack","e","__esModule","default","SHEET_PLACEMENT","base","md","FULLSCREEN_SURFACE_STYLE","backgroundColor","overflow","SDK_SURFACE_CHROME","contentPadding","maxHeightRatio","bloomOptionsFor","config","scrollable","header","largeTitle","undefined","presentation","placement","maxWidth","dismissOnBackdrop","style","panelStyle","activeRouteSurfaces","presentInternal","route","props","opts","track","navStack","createSurfaceNavStack","getSurfaceConfig","bloomOpts","label","result","bloomSurfaces","present","surface","createElement","SurfaceScreen","instance","navigate","nextRoute","nextProps","top","getTop","replace","goBack","canGoBack","setStep","step","dismiss","dismissResult","requestDismiss","tracked","push","finally","index","indexOf","splice","presentDetached","presentRoute","topRouteSurface","length","closeAllRouteSurfaces","reverse","navigateWithinOrPresent","currentPresentation","getSurfacePresentation","replaceWithinOrPresent","surfaces","exports","dismissAll","useSurfaces"],"sourceRoot":"../../../../src","sources":["ui/navigation/surfaces.ts"],"mappings":"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","ignoreList":[]}