@userflow-tech/react-native 0.1.1 → 0.3.0

package/lib/module/evalJs/getWebView.js

@@ -0,0 +1,76 @@
+"use strict";
+
+import { NativeModules, TurboModuleRegistry } from 'react-native';
+
+/**
+ * Minimal surface of `react-native-webview` this spike uses.
+ * Defined locally so the package root never statically imports the optional peer.
+ */
+
+let cached;
+let warnedMissing = false;
+
+/**
+ * True when the native `react-native-webview` binary is linked. Do not
+ * `require('react-native-webview')` before this passes — the JS entry calls
+ * `TurboModuleRegistry.getEnforcing('RNCWebViewModule')` and can red-screen.
+ */
+export function isEvalJsWebViewNativeLinked() {
+  try {
+    if (typeof TurboModuleRegistry?.get === 'function') {
+      if (TurboModuleRegistry.get('RNCWebViewModule') != null) {
+        return true;
+      }
+    }
+    const legacy = NativeModules.RNCWebViewModule;
+    return legacy != null;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Lazy `require('react-native-webview')`, cached. Returns null when the package
+ * or native module is missing so Evaluate JavaScript can no-op instead of crashing.
+ */
+export function getEvalJsWebView() {
+  if (cached !== undefined) return cached;
+  if (typeof require !== 'function') {
+    cached = null;
+    warnMissing('unavailable');
+    return cached;
+  }
+  if (!isEvalJsWebViewNativeLinked()) {
+    cached = null;
+    warnMissing('native');
+    return cached;
+  }
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires -- peer probe
+    const mod = require('react-native-webview');
+    const component = mod?.WebView ?? mod?.default;
+    cached = component != null ? component : null;
+  } catch {
+    cached = null;
+  }
+  if (cached == null) {
+    warnMissing('js');
+  }
+  return cached;
+}
+function warnMissing(reason) {
+  if (warnedMissing) return;
+  warnedMissing = true;
+  if (reason === 'native') {
+    console.warn('Userflow: react-native-webview is listed in package.json but RNCWebViewModule is not in ' + 'this native build. Run npx expo install react-native-webview (or npm install), then ' + 'rebuild the dev client (expo prebuild + run:ios / run:android — not Expo Go). ' + 'Evaluate JavaScript and WebView banners will not run until then.');
+    return;
+  }
+  console.warn('Userflow: Evaluate JavaScript requires react-native-webview. Install it in your app ' + '(e.g. npx expo install react-native-webview), rebuild the native app, then retry. ' + 'The action was skipped.');
+}
+
+/** @internal */
+export function resetEvalJsWebViewCacheForTests() {
+  cached = undefined;
+  warnedMissing = false;
+}
+//# sourceMappingURL=getWebView.js.map

package/lib/module/evalJs/getWebView.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NativeModules","TurboModuleRegistry","cached","warnedMissing","isEvalJsWebViewNativeLinked","get","legacy","RNCWebViewModule","getEvalJsWebView","undefined","require","warnMissing","mod","component","WebView","default","reason","console","warn","resetEvalJsWebViewCacheForTests"],"sourceRoot":"../../../src","sources":["evalJs/getWebView.ts"],"mappings":";;AACA,SAASA,aAAa,EAAEC,mBAAmB,QAAQ,cAAc;;AAEjE;AACA;AACA;AACA;;AAmCA,IAAIC,MAAiD;AACrD,IAAIC,aAAa,GAAG,KAAK;;AAEzB;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,2BAA2BA,CAAA,EAAY;EACrD,IAAI;IACF,IAAI,OAAOH,mBAAmB,EAAEI,GAAG,KAAK,UAAU,EAAE;MAClD,IAAIJ,mBAAmB,CAACI,GAAG,CAAC,kBAAkB,CAAC,IAAI,IAAI,EAAE;QACvD,OAAO,IAAI;MACb;IACF;IACA,MAAMC,MAAM,GAAGN,aAAa,CAACO,gBAA2B;IACxD,OAAOD,MAAM,IAAI,IAAI;EACvB,CAAC,CAAC,MAAM;IACN,OAAO,KAAK;EACd;AACF;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,gBAAgBA,CAAA,EAAkC;EAChE,IAAIN,MAAM,KAAKO,SAAS,EAAE,OAAOP,MAAM;EAEvC,IAAI,OAAOQ,OAAO,KAAK,UAAU,EAAE;IACjCR,MAAM,GAAG,IAAI;IACbS,WAAW,CAAC,aAAa,CAAC;IAC1B,OAAOT,MAAM;EACf;EAEA,IAAI,CAACE,2BAA2B,CAAC,CAAC,EAAE;IAClCF,MAAM,GAAG,IAAI;IACbS,WAAW,CAAC,QAAQ,CAAC;IACrB,OAAOT,MAAM;EACf;EAEA,IAAI;IACF;IACA,MAAMU,GAAG,GAAGF,OAAO,CAAC,sBAAsB,CAGzC;IACD,MAAMG,SAAS,GAAGD,GAAG,EAAEE,OAAO,IAAIF,GAAG,EAAEG,OAAO;IAC9Cb,MAAM,GAAGW,SAAS,IAAI,IAAI,GAAGA,SAAS,GAAG,IAAI;EAC/C,CAAC,CAAC,MAAM;IACNX,MAAM,GAAG,IAAI;EACf;EAEA,IAAIA,MAAM,IAAI,IAAI,EAAE;IAClBS,WAAW,CAAC,IAAI,CAAC;EACnB;EACA,OAAOT,MAAM;AACf;AAEA,SAASS,WAAWA,CAACK,MAAuC,EAAQ;EAClE,IAAIb,aAAa,EAAE;EACnBA,aAAa,GAAG,IAAI;EACpB,IAAIa,MAAM,KAAK,QAAQ,EAAE;IACvBC,OAAO,CAACC,IAAI,CACV,0FAA0F,GACxF,sFAAsF,GACtF,gFAAgF,GAChF,kEACJ,CAAC;IACD;EACF;EACAD,OAAO,CAACC,IAAI,CACV,sFAAsF,GACpF,oFAAoF,GACpF,yBACJ,CAAC;AACH;;AAEA;AACA,OAAO,SAASC,+BAA+BA,CAAA,EAAS;EACtDjB,MAAM,GAAGO,SAAS;EAClBN,aAAa,GAAG,KAAK;AACvB","ignoreList":[]}

package/lib/module/evalJs/injectEvalPending.js

@@ -0,0 +1,15 @@
+"use strict";
+
+import { wrapCode } from "./bootstrap.js";
+import { evalJsController } from "./evalJsController.js";
+/** Inject queued Evaluate JavaScript into a WebView (same document as the banner). */
+export function injectEvalPendingIntoWebView(view) {
+  if (!view) {
+    return;
+  }
+  const codes = evalJsController.consumePending();
+  for (const code of codes) {
+    view.injectJavaScript(wrapCode(code));
+  }
+}
+//# sourceMappingURL=injectEvalPending.js.map

package/lib/module/evalJs/injectEvalPending.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["wrapCode","evalJsController","injectEvalPendingIntoWebView","view","codes","consumePending","code","injectJavaScript"],"sourceRoot":"../../../src","sources":["evalJs/injectEvalPending.ts"],"mappings":";;AAAA,SAASA,QAAQ,QAAQ,gBAAa;AACtC,SAASC,gBAAgB,QAAQ,uBAAoB;AAGrD;AACA,OAAO,SAASC,4BAA4BA,CAACC,IAA4C,EAAQ;EAC/F,IAAI,CAACA,IAAI,EAAE;IACT;EACF;EACA,MAAMC,KAAK,GAAGH,gBAAgB,CAACI,cAAc,CAAC,CAAC;EAC/C,KAAK,MAAMC,IAAI,IAAIF,KAAK,EAAE;IACxBD,IAAI,CAACI,gBAAgB,CAACP,QAAQ,CAACM,IAAI,CAAC,CAAC;EACvC;AACF","ignoreList":[]}

package/lib/module/evalJs/types.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=types.js.map

package/lib/module/evalJs/types.js.map

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

package/lib/module/evalJs/useEvalJsWebViewInjection.js

@@ -0,0 +1,35 @@
+"use strict";
+
+import * as React from 'react';
+import { contextUpdateScript, wrapCode } from "./bootstrap.js";
+import { evalJsController } from "./evalJsController.js";
+/**
+ * Keeps `userflowContext` fresh and drains the eval-js queue into one WebView.
+ */
+export function useEvalJsWebViewInjection(webRef, options) {
+  const {
+    pageReady,
+    context,
+    pendingCount
+  } = options;
+  React.useEffect(() => {
+    if (!pageReady) {
+      return;
+    }
+    webRef.current?.injectJavaScript(contextUpdateScript(context));
+  }, [context, pageReady, webRef]);
+  React.useEffect(() => {
+    if (!pageReady) {
+      return;
+    }
+    const view = webRef.current;
+    if (!view) {
+      return;
+    }
+    const codes = evalJsController.consumePending();
+    for (const code of codes) {
+      view.injectJavaScript(wrapCode(code));
+    }
+  }, [pageReady, pendingCount, webRef]);
+}
+//# sourceMappingURL=useEvalJsWebViewInjection.js.map

package/lib/module/evalJs/useEvalJsWebViewInjection.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","contextUpdateScript","wrapCode","evalJsController","useEvalJsWebViewInjection","webRef","options","pageReady","context","pendingCount","useEffect","current","injectJavaScript","view","codes","consumePending","code"],"sourceRoot":"../../../src","sources":["evalJs/useEvalJsWebViewInjection.ts"],"mappings":";;AAAA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAE9B,SAASC,mBAAmB,EAAEC,QAAQ,QAAQ,gBAAa;AAC3D,SAASC,gBAAgB,QAAQ,uBAAoB;AAIrD;AACA;AACA;AACA,OAAO,SAASC,yBAAyBA,CACvCC,MAAmD,EACnDC,OAA6E,EACvE;EACN,MAAM;IAAEC,SAAS;IAAEC,OAAO;IAAEC;EAAa,CAAC,GAAGH,OAAO;EAEpDN,KAAK,CAACU,SAAS,CAAC,MAAM;IACpB,IAAI,CAACH,SAAS,EAAE;MACd;IACF;IACAF,MAAM,CAACM,OAAO,EAAEC,gBAAgB,CAACX,mBAAmB,CAACO,OAAO,CAAC,CAAC;EAChE,CAAC,EAAE,CAACA,OAAO,EAAED,SAAS,EAAEF,MAAM,CAAC,CAAC;EAEhCL,KAAK,CAACU,SAAS,CAAC,MAAM;IACpB,IAAI,CAACH,SAAS,EAAE;MACd;IACF;IACA,MAAMM,IAAI,GAAGR,MAAM,CAACM,OAAO;IAC3B,IAAI,CAACE,IAAI,EAAE;MACT;IACF;IACA,MAAMC,KAAK,GAAGX,gBAAgB,CAACY,cAAc,CAAC,CAAC;IAC/C,KAAK,MAAMC,IAAI,IAAIF,KAAK,EAAE;MACxBD,IAAI,CAACD,gBAAgB,CAACV,QAAQ,CAACc,IAAI,CAAC,CAAC;IACvC;EACF,CAAC,EAAE,CAACT,SAAS,EAAEE,YAAY,EAAEJ,MAAM,CAAC,CAAC;AACvC","ignoreList":[]}

package/lib/module/expo-router/index.js

@@ -2,4 +2,5 @@
 
 export { useUserflowExpoRouter } from "./useUserflowExpoRouter.js";
 export { UserflowExpoRouterScreenTracker } from "./UserflowExpoRouterScreenTracker.js";
+export { createRedirectSystemPath, isUserflowLinkPath, redirectSystemPath } from "./redirectSystemPath.js";
 //# sourceMappingURL=index.js.map

package/lib/module/expo-router/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["useUserflowExpoRouter","UserflowExpoRouterScreenTracker"],"sourceRoot":"../../../src","sources":["expo-router/index.ts"],"mappings":";;AAAA,SAASA,qBAAqB,QAAQ,4BAAyB;AAC/D,SAASC,+BAA+B,QAAQ,sCAAmC","ignoreList":[]}
+{"version":3,"names":["useUserflowExpoRouter","UserflowExpoRouterScreenTracker","createRedirectSystemPath","isUserflowLinkPath","redirectSystemPath"],"sourceRoot":"../../../src","sources":["expo-router/index.ts"],"mappings":";;AAAA,SAASA,qBAAqB,QAAQ,4BAAyB;AAC/D,SAASC,+BAA+B,QAAQ,sCAAmC;AACnF,SACEC,wBAAwB,EACxBC,kBAAkB,EAClBC,kBAAkB,QAIb,yBAAsB","ignoreList":[]}

package/lib/module/expo-router/redirectSystemPath.js

@@ -0,0 +1,70 @@
+"use strict";
+
+import { parsePreviewDeepLink } from "../deepLinking.js";
+import { inspectPairingDeepLink, isPairingAttempt } from "../pairing/deepLink.js";
+
+/**
+ * Arguments Expo Router passes to `redirectSystemPath` from `+native-intent`.
+ * @see https://docs.expo.dev/router/advanced/native-intent/
+ */
+
+/**
+ * True when `path` is a full Userflow pairing or preview URL that Expo Router
+ * should not navigate to.
+ *
+ * Only full URLs are claimed. Expo Router passes the raw URL to
+ * `redirectSystemPath` for both the initial URL and later URL events, so a
+ * bare `?token=` or `?pairing_token=` must be left alone — it may belong to
+ * the host.
+ */
+export function isUserflowLinkPath(path) {
+  if (typeof path !== 'string' || path.length === 0) return false;
+  if (!/^[a-z][a-z0-9+.-]*:/i.test(path)) return false;
+  const pairing = inspectPairingDeepLink(path);
+  if (pairing.ok || isPairingAttempt(pairing.reason)) return true;
+  return parsePreviewDeepLink(path) != null;
+}
+
+/**
+ * Build a `redirectSystemPath` that yields Userflow links and otherwise
+ * forwards to `next` (or returns the path unchanged).
+ */
+export function createRedirectSystemPath(options = {}) {
+  const {
+    next
+  } = options;
+  return event => {
+    try {
+      if (isUserflowLinkPath(event.path)) {
+        return null;
+      }
+    } catch {
+      // Expo warns that throwing here can crash the app. Fall through and let
+      // the router handle the original path.
+    }
+    if (next) {
+      return next(event);
+    }
+    return event.path;
+  };
+}
+
+/**
+ * Expo Router `redirectSystemPath` that swallows Userflow deep links.
+ *
+ * Returning `null` tells Expo Router to stay on the current path. The original
+ * URL remains available to React Native `Linking`, which the SDK already
+ * listens on.
+ *
+ * Mount from the host app:
+ *
+ * ```ts
+ * // app/+native-intent.ts
+ * export { redirectSystemPath } from '@userflow-tech/react-native/expo-router';
+ * ```
+ *
+ * Hosts that already export `redirectSystemPath` should wrap it with
+ * {@link createRedirectSystemPath}.
+ */
+export const redirectSystemPath = createRedirectSystemPath();
+//# sourceMappingURL=redirectSystemPath.js.map

package/lib/module/expo-router/redirectSystemPath.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["parsePreviewDeepLink","inspectPairingDeepLink","isPairingAttempt","isUserflowLinkPath","path","length","test","pairing","ok","reason","createRedirectSystemPath","options","next","event","redirectSystemPath"],"sourceRoot":"../../../src","sources":["expo-router/redirectSystemPath.ts"],"mappings":";;AAAA,SAASA,oBAAoB,QAAQ,mBAAgB;AACrD,SAASC,sBAAsB,EAAEC,gBAAgB,QAAQ,wBAAqB;;AAE9E;AACA;AACA;AACA;;AAkBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAACC,IAAY,EAAW;EACxD,IAAI,OAAOA,IAAI,KAAK,QAAQ,IAAIA,IAAI,CAACC,MAAM,KAAK,CAAC,EAAE,OAAO,KAAK;EAC/D,IAAI,CAAC,sBAAsB,CAACC,IAAI,CAACF,IAAI,CAAC,EAAE,OAAO,KAAK;EAEpD,MAAMG,OAAO,GAAGN,sBAAsB,CAACG,IAAI,CAAC;EAC5C,IAAIG,OAAO,CAACC,EAAE,IAAIN,gBAAgB,CAACK,OAAO,CAACE,MAAM,CAAC,EAAE,OAAO,IAAI;EAC/D,OAAOT,oBAAoB,CAACI,IAAI,CAAC,IAAI,IAAI;AAC3C;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASM,wBAAwBA,CACtCC,OAAwC,GAAG,CAAC,CAAC,EACzB;EACpB,MAAM;IAAEC;EAAK,CAAC,GAAGD,OAAO;EAExB,OAAQE,KAAK,IAAK;IAChB,IAAI;MACF,IAAIV,kBAAkB,CAACU,KAAK,CAACT,IAAI,CAAC,EAAE;QAClC,OAAO,IAAI;MACb;IACF,CAAC,CAAC,MAAM;MACN;MACA;IAAA;IAGF,IAAIQ,IAAI,EAAE;MACR,OAAOA,IAAI,CAACC,KAAK,CAAC;IACpB;IACA,OAAOA,KAAK,CAACT,IAAI;EACnB,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMU,kBAAsC,GAAGJ,wBAAwB,CAAC,CAAC","ignoreList":[]}

package/lib/module/expo-router/useUserflowExpoRouter.js

@@ -1,7 +1,8 @@
 "use strict";
 
-import { usePathname, useRouter } from 'expo-router';
-import { useEffect } from 'react';
+import { useNavigationContainerRef, usePathname, useRouter } from 'expo-router';
+import { useCallback, useEffect, useRef } from 'react';
+import { isOverlayPresentation, readNavigationPresentation, subscribeNavigationState } from "../navigation/isOverlayPresentation.js";
 import { setExpoRouterNavigator } from "../navigation/openFlowNavigateUrl.js";
 import { handleScreenChange } from "../screenTracker.js";
 
@@ -14,8 +15,8 @@ import { handleScreenChange } from "../screenTracker.js";
  * import this hook from the package root — that would force every host app to
  * install the `expo-router` peer.
  *
- * Pathnames are reported as `{ path }` and mapped to wire `screenPath`
- * (not `screenName`).
+ * Pathnames are reported as `{ path }` and sent as wire `screenName` (the
+ * backend has no separate path field).
  *
  * Screen tracking ≠ action routing: NAVIGATE for in-app paths uses the router
  * handle registered here; http(s)/mailto/tel still go through Linking.
@@ -23,11 +24,46 @@ import { handleScreenChange } from "../screenTracker.js";
 export function useUserflowExpoRouter() {
   const pathname = usePathname();
   const router = useRouter();
-  useEffect(() => {
-    handleScreenChange(pathname ? {
-      path: pathname
+  // Root container ref — `useNavigation()` is the route prop and has no getCurrentOptions.
+  const navigationRef = useNavigationContainerRef();
+  const overlayWasFocusedRef = useRef(false);
+  const pathnameRef = useRef(pathname);
+  pathnameRef.current = pathname;
+  const subscribedToStateRef = useRef(false);
+  const reportPath = useCallback(() => {
+    if (isOverlayPresentation(readNavigationPresentation(navigationRef))) {
+      overlayWasFocusedRef.current = true;
+      return;
+    }
+    handleScreenChange(pathnameRef.current ? {
+      path: pathnameRef.current
+    } : undefined, overlayWasFocusedRef.current ? {
+      force: true
     } : undefined);
-  }, [pathname]);
+    overlayWasFocusedRef.current = false;
+  }, [navigationRef]);
+  useEffect(() => {
+    // Pathname is the fallback when the container ref has no `state` listener
+    // (tests, or before the root container mounts). Once subscribed, navigation
+    // state is the source of truth so overlay options are read on the same tick
+    // as the transition — a pathname-only update can still see the previous
+    // route's options.
+    if (!subscribedToStateRef.current) {
+      reportPath();
+    }
+  }, [pathname, reportPath]);
+  useEffect(() => {
+    const unsubscribe = subscribeNavigationState(navigationRef, () => {
+      queueMicrotask(() => {
+        reportPath();
+      });
+    });
+    subscribedToStateRef.current = typeof unsubscribe === 'function';
+    return () => {
+      subscribedToStateRef.current = false;
+      unsubscribe?.();
+    };
+  }, [navigationRef, reportPath]);
   useEffect(() => {
     setExpoRouterNavigator({
       push: href => {

package/lib/module/expo-router/useUserflowExpoRouter.js.map

@@ -1 +1 @@
-{"version":3,"names":["usePathname","useRouter","useEffect","setExpoRouterNavigator","handleScreenChange","useUserflowExpoRouter","pathname","router","path","undefined","push","href"],"sourceRoot":"../../../src","sources":["expo-router/useUserflowExpoRouter.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,SAAS,QAAQ,aAAa;AACpD,SAASC,SAAS,QAAQ,OAAO;AAEjC,SAASC,sBAAsB,QAAQ,sCAAmC;AAC1E,SAASC,kBAAkB,QAAQ,qBAAkB;;AAErD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,qBAAqBA,CAAA,EAAS;EAC5C,MAAMC,QAAQ,GAAGN,WAAW,CAAC,CAAC;EAC9B,MAAMO,MAAM,GAAGN,SAAS,CAAC,CAAC;EAE1BC,SAAS,CAAC,MAAM;IACdE,kBAAkB,CAACE,QAAQ,GAAG;MAAEE,IAAI,EAAEF;IAAS,CAAC,GAAGG,SAAS,CAAC;EAC/D,CAAC,EAAE,CAACH,QAAQ,CAAC,CAAC;EAEdJ,SAAS,CAAC,MAAM;IACdC,sBAAsB,CAAC;MACrBO,IAAI,EAAGC,IAAI,IAAK;QACdJ,MAAM,CAACG,IAAI,CAACC,IAAa,CAAC;MAC5B;IACF,CAAC,CAAC;IACF,OAAO,MAAM;MACXR,sBAAsB,CAAC,IAAI,CAAC;IAC9B,CAAC;EACH,CAAC,EAAE,CAACI,MAAM,CAAC,CAAC;AACd","ignoreList":[]}
+{"version":3,"names":["useNavigationContainerRef","usePathname","useRouter","useCallback","useEffect","useRef","isOverlayPresentation","readNavigationPresentation","subscribeNavigationState","setExpoRouterNavigator","handleScreenChange","useUserflowExpoRouter","pathname","router","navigationRef","overlayWasFocusedRef","pathnameRef","current","subscribedToStateRef","reportPath","path","undefined","force","unsubscribe","queueMicrotask","push","href"],"sourceRoot":"../../../src","sources":["expo-router/useUserflowExpoRouter.ts"],"mappings":";;AAAA,SAASA,yBAAyB,EAAEC,WAAW,EAAEC,SAAS,QAAQ,aAAa;AAC/E,SAASC,WAAW,EAAEC,SAAS,EAAEC,MAAM,QAAQ,OAAO;AAEtD,SACEC,qBAAqB,EACrBC,0BAA0B,EAC1BC,wBAAwB,QACnB,wCAAqC;AAC5C,SAASC,sBAAsB,QAAQ,sCAAmC;AAC1E,SAASC,kBAAkB,QAAQ,qBAAkB;;AAErD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,qBAAqBA,CAAA,EAAS;EAC5C,MAAMC,QAAQ,GAAGX,WAAW,CAAC,CAAC;EAC9B,MAAMY,MAAM,GAAGX,SAAS,CAAC,CAAC;EAC1B;EACA,MAAMY,aAAa,GAAGd,yBAAyB,CAAC,CAAC;EACjD,MAAMe,oBAAoB,GAAGV,MAAM,CAAC,KAAK,CAAC;EAC1C,MAAMW,WAAW,GAAGX,MAAM,CAACO,QAAQ,CAAC;EACpCI,WAAW,CAACC,OAAO,GAAGL,QAAQ;EAC9B,MAAMM,oBAAoB,GAAGb,MAAM,CAAC,KAAK,CAAC;EAE1C,MAAMc,UAAU,GAAGhB,WAAW,CAAC,MAAM;IACnC,IAAIG,qBAAqB,CAACC,0BAA0B,CAACO,aAAa,CAAC,CAAC,EAAE;MACpEC,oBAAoB,CAACE,OAAO,GAAG,IAAI;MACnC;IACF;IACAP,kBAAkB,CAChBM,WAAW,CAACC,OAAO,GAAG;MAAEG,IAAI,EAAEJ,WAAW,CAACC;IAAQ,CAAC,GAAGI,SAAS,EAC/DN,oBAAoB,CAACE,OAAO,GAAG;MAAEK,KAAK,EAAE;IAAK,CAAC,GAAGD,SACnD,CAAC;IACDN,oBAAoB,CAACE,OAAO,GAAG,KAAK;EACtC,CAAC,EAAE,CAACH,aAAa,CAAC,CAAC;EAEnBV,SAAS,CAAC,MAAM;IACd;IACA;IACA;IACA;IACA;IACA,IAAI,CAACc,oBAAoB,CAACD,OAAO,EAAE;MACjCE,UAAU,CAAC,CAAC;IACd;EACF,CAAC,EAAE,CAACP,QAAQ,EAAEO,UAAU,CAAC,CAAC;EAE1Bf,SAAS,CAAC,MAAM;IACd,MAAMmB,WAAW,GAAGf,wBAAwB,CAACM,aAAa,EAAE,MAAM;MAChEU,cAAc,CAAC,MAAM;QACnBL,UAAU,CAAC,CAAC;MACd,CAAC,CAAC;IACJ,CAAC,CAAC;IACFD,oBAAoB,CAACD,OAAO,GAAG,OAAOM,WAAW,KAAK,UAAU;IAChE,OAAO,MAAM;MACXL,oBAAoB,CAACD,OAAO,GAAG,KAAK;MACpCM,WAAW,GAAG,CAAC;IACjB,CAAC;EACH,CAAC,EAAE,CAACT,aAAa,EAAEK,UAAU,CAAC,CAAC;EAE/Bf,SAAS,CAAC,MAAM;IACdK,sBAAsB,CAAC;MACrBgB,IAAI,EAAGC,IAAI,IAAK;QACdb,MAAM,CAACY,IAAI,CAACC,IAAa,CAAC;MAC5B;IACF,CAAC,CAAC;IACF,OAAO,MAAM;MACXjB,sBAAsB,CAAC,IAAI,CAAC;IAC9B,CAAC;EACH,CAAC,EAAE,CAACI,MAAM,CAAC,CAAC;AACd","ignoreList":[]}

package/lib/module/hostAppVersion.js

@@ -0,0 +1,225 @@
+"use strict";
+
+/**
+ * Read the host app's native marketing version (store version), not the
+ * SDK package version. React Native does not expose the store version on
+ * `Platform`; Expo hosts may use optional expo modules; bare RN reads
+ * `NativeModules.RNDeviceInfo` constants from the bundled device-info native
+ * module (after autolink + rebuild). The OS name is `Platform.OS`.
+ *
+ * Do not `require('react-native-device-info')` — that package throws at import
+ * when the native module is missing, and Metro/Hermes may surface it as uncaught
+ * even inside try/catch.
+ */
+
+function nonEmptyString(value) {
+  return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function unwrapModule(mod) {
+  if (typeof mod !== 'object' || mod === null) return null;
+  const record = mod;
+  const nested = record['default'];
+  if (typeof nested === 'object' && nested !== null) {
+    return {
+      ...record,
+      ...nested
+    };
+  }
+  return record;
+}
+function tryRequireExpoApplication() {
+  try {
+    // Optional on bare RN — Metro requires a string literal.
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
+    return require('expo-application');
+  } catch {
+    return undefined;
+  }
+}
+function tryRequireExpoConstants() {
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
+    return require('expo-constants');
+  } catch {
+    return undefined;
+  }
+}
+function loadLinkedDeviceInfoNativeModule() {
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
+    const {
+      NativeModules
+    } = require('react-native');
+    return NativeModules.RNDeviceInfo ?? null;
+  } catch {
+    return null;
+  }
+}
+
+/** Visible for tests: map an `expo-application` module shape to a version. */
+export function readExpoApplication(mod) {
+  const record = unwrapModule(mod);
+  if (!record) return null;
+  const version = nonEmptyString(record['nativeApplicationVersion']);
+  if (!version) return null;
+  const build = nonEmptyString(record['nativeBuildVersion']);
+  return {
+    version,
+    source: 'expo-application',
+    ...(build ? {
+      build
+    } : {})
+  };
+}
+
+/** Visible for tests: map an `expo-constants` module shape to a version. */
+export function readExpoConstants(mod) {
+  const record = unwrapModule(mod);
+  if (!record) return null;
+  const expoConfig = record['expoConfig'];
+  const configVersion = typeof expoConfig === 'object' && expoConfig !== null ? nonEmptyString(expoConfig['version']) : undefined;
+  const version = nonEmptyString(record['nativeAppVersion']) ?? configVersion;
+  if (!version) return null;
+  const build = nonEmptyString(record['nativeBuildVersion']);
+  return {
+    version,
+    source: 'expo-constants',
+    ...(build ? {
+      build
+    } : {})
+  };
+}
+
+/** Visible for tests: map linked RNDeviceInfo native constants to a version. */
+export function readDeviceInfoFromNativeModule(module) {
+  if (!module) return null;
+  const version = nonEmptyString(module.appVersion);
+  if (!version || version === 'unknown') return null;
+  const build = nonEmptyString(module.buildNumber);
+  return {
+    version,
+    source: 'react-native-device-info',
+    ...(build && build !== 'unknown' ? {
+      build
+    } : {})
+  };
+}
+
+/** Visible for tests: first non-null reader wins (Expo modules, then RNDeviceInfo). */
+export function resolveHostAppVersionFromSources(sources) {
+  return readExpoApplication(sources.expoApplication) ?? readExpoConstants(sources.expoConstants) ?? readDeviceInfoFromNativeModule(sources.deviceInfoNative);
+}
+export function resolveHostAppVersion() {
+  return resolveHostAppVersionFromSources({
+    expoApplication: tryRequireExpoApplication(),
+    expoConstants: tryRequireExpoConstants(),
+    deviceInfoNative: loadLinkedDeviceInfoNativeModule()
+  });
+}
+/** Visible for tests: resolve version for init, honoring an optional client override. */
+export function resolveHostAppVersionForInit(options = {}) {
+  const overrideVersion = nonEmptyString(options.appVersion);
+  if (overrideVersion) {
+    const build = nonEmptyString(options.appBuild);
+    return {
+      version: overrideVersion,
+      source: 'init-override',
+      ...(build ? {
+        build
+      } : {})
+    };
+  }
+  return resolveHostAppVersion();
+}
+
+/** `undefined` until the first {@link cacheHostAppVersionAtInit}; then resolved or null. */
+let cachedHostAppVersion;
+
+/**
+ * Resolve and cache the host app version during {@link Userflow.init}.
+ * Re-running init replaces the cache.
+ */
+export function cacheHostAppVersionAtInit(options = {}) {
+  cachedHostAppVersion = resolveHostAppVersionForInit(options);
+  return cachedHostAppVersion;
+}
+
+/** Returns the version cached at init, or `null` before init or when unavailable. */
+export function getCachedHostAppVersion() {
+  return cachedHostAppVersion ?? null;
+}
+
+/** User attribute keys for the host app's native store version. */
+export const HOST_APP_VERSION_USER_ATTRIBUTE = 'app_version';
+export const HOST_APP_BUILD_USER_ATTRIBUTE = 'app_build';
+
+/** Returns cached host version fields for UpsertUser, or `{}` when unavailable. */
+export function hostAppVersionUserAttributes() {
+  const cached = getCachedHostAppVersion();
+  if (!cached) return {};
+  return {
+    [HOST_APP_VERSION_USER_ATTRIBUTE]: cached.version,
+    ...(cached.build ? {
+      [HOST_APP_BUILD_USER_ATTRIBUTE]: cached.build
+    } : {})
+  };
+}
+
+/** Optional user-attribute keys added by {@link mergeHostAppVersionUserAttributes}. */
+
+/** Merges cached host version attrs into identify attributes; caller values win on key conflicts. */
+export function mergeHostAppVersionUserAttributes(attributes) {
+  const system = hostAppVersionUserAttributes();
+  if (Object.keys(system).length === 0) {
+    return attributes;
+  }
+  return {
+    ...system,
+    ...(attributes ?? {})
+  };
+}
+
+/** @internal Resets init cache between tests. */
+export function resetCachedHostAppVersionForTests() {
+  cachedHostAppVersion = undefined;
+}
+function readPlatformOS() {
+  try {
+    // Lazy require so Node unit tests can format messages without loading RN.
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
+    const os = require('react-native').Platform?.OS;
+    return typeof os === 'string' && os.length > 0 ? os : 'unknown';
+  } catch {
+    return 'unknown';
+  }
+}
+export function formatHostAppVersionLog(resolved, os) {
+  if (!resolved) {
+    return {
+      level: 'warn',
+      message: `[Userflow] host app version is unavailable on ${os}. Rebuild the native app ` + '(for example `cd ios && pod install`) so the bundled version module is linked.'
+    };
+  }
+  const build = resolved.build ? ` (build ${resolved.build})` : '';
+  return {
+    level: 'log',
+    message: `[Userflow] host app version ${resolved.version}${build} on ${os}`
+  };
+}
+
+/** Log the host app's native version and platform OS to the console. */
+export function logHostAppVersion() {
+  const resolved = cachedHostAppVersion !== undefined ? cachedHostAppVersion : resolveHostAppVersion();
+  const {
+    level,
+    message
+  } = formatHostAppVersionLog(resolved, readPlatformOS());
+  if (level === 'warn') {
+    // eslint-disable-next-line no-console -- public logHostAppVersion()
+    console.warn(message);
+    return;
+  }
+  // eslint-disable-next-line no-console -- public logHostAppVersion()
+  console.log(message);
+}
+//# sourceMappingURL=hostAppVersion.js.map

package/lib/module/hostAppVersion.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["nonEmptyString","value","length","undefined","unwrapModule","mod","record","nested","tryRequireExpoApplication","require","tryRequireExpoConstants","loadLinkedDeviceInfoNativeModule","NativeModules","RNDeviceInfo","readExpoApplication","version","build","source","readExpoConstants","expoConfig","configVersion","readDeviceInfoFromNativeModule","module","appVersion","buildNumber","resolveHostAppVersionFromSources","sources","expoApplication","expoConstants","deviceInfoNative","resolveHostAppVersion","resolveHostAppVersionForInit","options","overrideVersion","appBuild","cachedHostAppVersion","cacheHostAppVersionAtInit","getCachedHostAppVersion","HOST_APP_VERSION_USER_ATTRIBUTE","HOST_APP_BUILD_USER_ATTRIBUTE","hostAppVersionUserAttributes","cached","mergeHostAppVersionUserAttributes","attributes","system","Object","keys","resetCachedHostAppVersionForTests","readPlatformOS","os","Platform","OS","formatHostAppVersionLog","resolved","level","message","logHostAppVersion","console","warn","log"],"sourceRoot":"../../src","sources":["hostAppVersion.ts"],"mappings":"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","ignoreList":[]}