@userflow-tech/react-native 0.1.0 → 0.2.0

package/lib/commonjs/deviceContext.js

@@ -0,0 +1,158 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.SDK_USER_ATTRIBUTE = exports.DEVICE_TYPE_USER_ATTRIBUTE = exports.DEVICE_OS_USER_ATTRIBUTE = exports.ANDROID_TABLET_SMALLEST_WIDTH_DP = void 0;
+exports.cacheDeviceContextAtInit = cacheDeviceContextAtInit;
+exports.deviceContextUserAttributes = deviceContextUserAttributes;
+exports.formatDeviceContextLog = formatDeviceContextLog;
+exports.getCachedDeviceContext = getCachedDeviceContext;
+exports.logDeviceContext = logDeviceContext;
+exports.mergeDeviceContextUserAttributes = mergeDeviceContextUserAttributes;
+exports.resetCachedDeviceContextForTests = resetCachedDeviceContextForTests;
+exports.resolveDeviceContext = resolveDeviceContext;
+exports.resolveDeviceContextFromSources = resolveDeviceContextFromSources;
+exports.resolveDeviceOs = resolveDeviceOs;
+exports.resolveDeviceTypeFromSources = resolveDeviceTypeFromSources;
+exports.smallestScreenWidthDp = smallestScreenWidthDp;
+/**
+ * Resolve mobile platform metadata for Userflow user attributes.
+ *
+ * Cached once during {@link Userflow.init} and merged into identify attributes
+ * (same lifecycle as {@link hostAppVersion.ts}).
+ */
+
+/** Android `smallestScreenWidthDp` tablet threshold (sw600dp). */
+const ANDROID_TABLET_SMALLEST_WIDTH_DP = exports.ANDROID_TABLET_SMALLEST_WIDTH_DP = 600;
+const SDK_USER_ATTRIBUTE = exports.SDK_USER_ATTRIBUTE = 'sdk';
+const DEVICE_OS_USER_ATTRIBUTE = exports.DEVICE_OS_USER_ATTRIBUTE = 'device_os';
+const DEVICE_TYPE_USER_ATTRIBUTE = exports.DEVICE_TYPE_USER_ATTRIBUTE = 'device_type';
+/** Visible for tests: map `Platform.OS` to a supported device OS value. */
+function resolveDeviceOs(platformOs) {
+  if (platformOs === 'ios') return 'ios';
+  if (platformOs === 'android') return 'android';
+  return undefined;
+}
+
+/** Visible for tests: smallest screen width. `Dimensions` values are already dp. */
+function smallestScreenWidthDp(screen) {
+  return Math.min(screen.width, screen.height);
+}
+
+/** Visible for tests: classify phone vs tablet for the current platform. */
+function resolveDeviceTypeFromSources(sources) {
+  const os = sources.platform?.OS;
+  if (os === 'ios') {
+    return sources.platform?.isPad ? 'tablet' : 'phone';
+  }
+  if (os === 'android') {
+    const screen = sources.screen;
+    if (!screen) return undefined;
+    return smallestScreenWidthDp(screen) >= ANDROID_TABLET_SMALLEST_WIDTH_DP ? 'tablet' : 'phone';
+  }
+  return undefined;
+}
+
+/** Visible for tests: build the cached device context from RN platform APIs. */
+function resolveDeviceContextFromSources(sources) {
+  const deviceOs = resolveDeviceOs(sources.platform?.OS);
+  const deviceType = resolveDeviceTypeFromSources(sources);
+  return {
+    sdk: 'react_native',
+    ...(deviceOs ? {
+      deviceOs
+    } : {}),
+    ...(deviceType ? {
+      deviceType
+    } : {})
+  };
+}
+function loadReactNativePlatformApis() {
+  try {
+    // Lazy require so Node unit tests can inject sources without loading RN.
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
+    const rn = require('react-native');
+    const platform = rn.Platform;
+    const screen = rn.Dimensions?.get('screen');
+    return {
+      ...(platform ? {
+        platform
+      } : {}),
+      ...(screen ? {
+        screen
+      } : {})
+    };
+  } catch {
+    return {};
+  }
+}
+function resolveDeviceContext() {
+  return resolveDeviceContextFromSources(loadReactNativePlatformApis());
+}
+
+/** `undefined` until the first {@link cacheDeviceContextAtInit}; then resolved. */
+let cachedDeviceContext;
+
+/**
+ * Resolve and cache device metadata during {@link Userflow.init}.
+ * Re-running init replaces the cache.
+ */
+function cacheDeviceContextAtInit() {
+  cachedDeviceContext = resolveDeviceContext();
+  return cachedDeviceContext;
+}
+
+/** Returns the context cached at init, or `null` before init. */
+function getCachedDeviceContext() {
+  return cachedDeviceContext ?? null;
+}
+
+/** Returns cached device fields for UpsertUser, or `{}` before init. */
+function deviceContextUserAttributes() {
+  const cached = getCachedDeviceContext();
+  if (!cached) return {};
+  return {
+    [SDK_USER_ATTRIBUTE]: cached.sdk,
+    ...(cached.deviceOs ? {
+      [DEVICE_OS_USER_ATTRIBUTE]: cached.deviceOs
+    } : {}),
+    ...(cached.deviceType ? {
+      [DEVICE_TYPE_USER_ATTRIBUTE]: cached.deviceType
+    } : {})
+  };
+}
+
+/** Optional user-attribute keys added by {@link mergeDeviceContextUserAttributes}. */
+
+/** Merges cached device attrs into identify attributes; caller values win on key conflicts. */
+function mergeDeviceContextUserAttributes(attributes) {
+  const system = deviceContextUserAttributes();
+  if (Object.keys(system).length === 0) {
+    return attributes;
+  }
+  return {
+    ...system,
+    ...(attributes ?? {})
+  };
+}
+function formatDeviceContextLog(resolved) {
+  if (!resolved) {
+    return '[Userflow] device context is unavailable — call Userflow.init() first.';
+  }
+  const os = resolved.deviceOs ?? 'unknown';
+  const type = resolved.deviceType ?? 'unknown';
+  return `[Userflow] device context sdk=${resolved.sdk} device_os=${os} device_type=${type}`;
+}
+
+/** Log cached user-attribute values. Requires {@link cacheDeviceContextAtInit}. */
+function logDeviceContext() {
+  // eslint-disable-next-line no-console -- public logDeviceContext()
+  console.log(formatDeviceContextLog(getCachedDeviceContext()));
+}
+
+/** @internal Resets init cache between tests. */
+function resetCachedDeviceContextForTests() {
+  cachedDeviceContext = undefined;
+}
+//# sourceMappingURL=deviceContext.js.map

package/lib/commonjs/deviceContext.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ANDROID_TABLET_SMALLEST_WIDTH_DP","exports","SDK_USER_ATTRIBUTE","DEVICE_OS_USER_ATTRIBUTE","DEVICE_TYPE_USER_ATTRIBUTE","resolveDeviceOs","platformOs","undefined","smallestScreenWidthDp","screen","Math","min","width","height","resolveDeviceTypeFromSources","sources","os","platform","OS","isPad","resolveDeviceContextFromSources","deviceOs","deviceType","sdk","loadReactNativePlatformApis","rn","require","Platform","Dimensions","get","resolveDeviceContext","cachedDeviceContext","cacheDeviceContextAtInit","getCachedDeviceContext","deviceContextUserAttributes","cached","mergeDeviceContextUserAttributes","attributes","system","Object","keys","length","formatDeviceContextLog","resolved","type","logDeviceContext","console","log","resetCachedDeviceContextForTests"],"sourceRoot":"../../src","sources":["deviceContext.ts"],"mappings":"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","ignoreList":[]}

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

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.useUserflowExpoRouter = useUserflowExpoRouter;
 var _expoRouter = require("expo-router");
 var _react = require("react");
+var _isOverlayPresentation = require("../navigation/isOverlayPresentation.js");
 var _openFlowNavigateUrl = require("../navigation/openFlowNavigateUrl.js");
 var _screenTracker = require("../screenTracker.js");
 /**
@@ -26,11 +27,46 @@ var _screenTracker = require("../screenTracker.js");
 function useUserflowExpoRouter() {
   const pathname = (0, _expoRouter.usePathname)();
   const router = (0, _expoRouter.useRouter)();
-  (0, _react.useEffect)(() => {
-    (0, _screenTracker.handleScreenChange)(pathname ? {
-      path: pathname
+  // Root container ref — `useNavigation()` is the route prop and has no getCurrentOptions.
+  const navigationRef = (0, _expoRouter.useNavigationContainerRef)();
+  const overlayWasFocusedRef = (0, _react.useRef)(false);
+  const pathnameRef = (0, _react.useRef)(pathname);
+  pathnameRef.current = pathname;
+  const subscribedToStateRef = (0, _react.useRef)(false);
+  const reportPath = (0, _react.useCallback)(() => {
+    if ((0, _isOverlayPresentation.isOverlayPresentation)((0, _isOverlayPresentation.readNavigationPresentation)(navigationRef))) {
+      overlayWasFocusedRef.current = true;
+      return;
+    }
+    (0, _screenTracker.handleScreenChange)(pathnameRef.current ? {
+      path: pathnameRef.current
+    } : undefined, overlayWasFocusedRef.current ? {
+      force: true
     } : undefined);
-  }, [pathname]);
+    overlayWasFocusedRef.current = false;
+  }, [navigationRef]);
+  (0, _react.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]);
+  (0, _react.useEffect)(() => {
+    const unsubscribe = (0, _isOverlayPresentation.subscribeNavigationState)(navigationRef, () => {
+      queueMicrotask(() => {
+        reportPath();
+      });
+    });
+    subscribedToStateRef.current = typeof unsubscribe === 'function';
+    return () => {
+      subscribedToStateRef.current = false;
+      unsubscribe?.();
+    };
+  }, [navigationRef, reportPath]);
   (0, _react.useEffect)(() => {
     (0, _openFlowNavigateUrl.setExpoRouterNavigator)({
       push: href => {

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

@@ -1 +1 @@
-{"version":3,"names":["_expoRouter","require","_react","_openFlowNavigateUrl","_screenTracker","useUserflowExpoRouter","pathname","usePathname","router","useRouter","useEffect","handleScreenChange","path","undefined","setExpoRouterNavigator","push","href"],"sourceRoot":"../../../src","sources":["expo-router/useUserflowExpoRouter.ts"],"mappings":";;;;;;AAAA,IAAAA,WAAA,GAAAC,OAAA;AACA,IAAAC,MAAA,GAAAD,OAAA;AAEA,IAAAE,oBAAA,GAAAF,OAAA;AACA,IAAAG,cAAA,GAAAH,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASI,qBAAqBA,CAAA,EAAS;EAC5C,MAAMC,QAAQ,GAAG,IAAAC,uBAAW,EAAC,CAAC;EAC9B,MAAMC,MAAM,GAAG,IAAAC,qBAAS,EAAC,CAAC;EAE1B,IAAAC,gBAAS,EAAC,MAAM;IACd,IAAAC,iCAAkB,EAACL,QAAQ,GAAG;MAAEM,IAAI,EAAEN;IAAS,CAAC,GAAGO,SAAS,CAAC;EAC/D,CAAC,EAAE,CAACP,QAAQ,CAAC,CAAC;EAEd,IAAAI,gBAAS,EAAC,MAAM;IACd,IAAAI,2CAAsB,EAAC;MACrBC,IAAI,EAAGC,IAAI,IAAK;QACdR,MAAM,CAACO,IAAI,CAACC,IAAa,CAAC;MAC5B;IACF,CAAC,CAAC;IACF,OAAO,MAAM;MACX,IAAAF,2CAAsB,EAAC,IAAI,CAAC;IAC9B,CAAC;EACH,CAAC,EAAE,CAACN,MAAM,CAAC,CAAC;AACd","ignoreList":[]}
+{"version":3,"names":["_expoRouter","require","_react","_isOverlayPresentation","_openFlowNavigateUrl","_screenTracker","useUserflowExpoRouter","pathname","usePathname","router","useRouter","navigationRef","useNavigationContainerRef","overlayWasFocusedRef","useRef","pathnameRef","current","subscribedToStateRef","reportPath","useCallback","isOverlayPresentation","readNavigationPresentation","handleScreenChange","path","undefined","force","useEffect","unsubscribe","subscribeNavigationState","queueMicrotask","setExpoRouterNavigator","push","href"],"sourceRoot":"../../../src","sources":["expo-router/useUserflowExpoRouter.ts"],"mappings":";;;;;;AAAA,IAAAA,WAAA,GAAAC,OAAA;AACA,IAAAC,MAAA,GAAAD,OAAA;AAEA,IAAAE,sBAAA,GAAAF,OAAA;AAKA,IAAAG,oBAAA,GAAAH,OAAA;AACA,IAAAI,cAAA,GAAAJ,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASK,qBAAqBA,CAAA,EAAS;EAC5C,MAAMC,QAAQ,GAAG,IAAAC,uBAAW,EAAC,CAAC;EAC9B,MAAMC,MAAM,GAAG,IAAAC,qBAAS,EAAC,CAAC;EAC1B;EACA,MAAMC,aAAa,GAAG,IAAAC,qCAAyB,EAAC,CAAC;EACjD,MAAMC,oBAAoB,GAAG,IAAAC,aAAM,EAAC,KAAK,CAAC;EAC1C,MAAMC,WAAW,GAAG,IAAAD,aAAM,EAACP,QAAQ,CAAC;EACpCQ,WAAW,CAACC,OAAO,GAAGT,QAAQ;EAC9B,MAAMU,oBAAoB,GAAG,IAAAH,aAAM,EAAC,KAAK,CAAC;EAE1C,MAAMI,UAAU,GAAG,IAAAC,kBAAW,EAAC,MAAM;IACnC,IAAI,IAAAC,4CAAqB,EAAC,IAAAC,iDAA0B,EAACV,aAAa,CAAC,CAAC,EAAE;MACpEE,oBAAoB,CAACG,OAAO,GAAG,IAAI;MACnC;IACF;IACA,IAAAM,iCAAkB,EAChBP,WAAW,CAACC,OAAO,GAAG;MAAEO,IAAI,EAAER,WAAW,CAACC;IAAQ,CAAC,GAAGQ,SAAS,EAC/DX,oBAAoB,CAACG,OAAO,GAAG;MAAES,KAAK,EAAE;IAAK,CAAC,GAAGD,SACnD,CAAC;IACDX,oBAAoB,CAACG,OAAO,GAAG,KAAK;EACtC,CAAC,EAAE,CAACL,aAAa,CAAC,CAAC;EAEnB,IAAAe,gBAAS,EAAC,MAAM;IACd;IACA;IACA;IACA;IACA;IACA,IAAI,CAACT,oBAAoB,CAACD,OAAO,EAAE;MACjCE,UAAU,CAAC,CAAC;IACd;EACF,CAAC,EAAE,CAACX,QAAQ,EAAEW,UAAU,CAAC,CAAC;EAE1B,IAAAQ,gBAAS,EAAC,MAAM;IACd,MAAMC,WAAW,GAAG,IAAAC,+CAAwB,EAACjB,aAAa,EAAE,MAAM;MAChEkB,cAAc,CAAC,MAAM;QACnBX,UAAU,CAAC,CAAC;MACd,CAAC,CAAC;IACJ,CAAC,CAAC;IACFD,oBAAoB,CAACD,OAAO,GAAG,OAAOW,WAAW,KAAK,UAAU;IAChE,OAAO,MAAM;MACXV,oBAAoB,CAACD,OAAO,GAAG,KAAK;MACpCW,WAAW,GAAG,CAAC;IACjB,CAAC;EACH,CAAC,EAAE,CAAChB,aAAa,EAAEO,UAAU,CAAC,CAAC;EAE/B,IAAAQ,gBAAS,EAAC,MAAM;IACd,IAAAI,2CAAsB,EAAC;MACrBC,IAAI,EAAGC,IAAI,IAAK;QACdvB,MAAM,CAACsB,IAAI,CAACC,IAAa,CAAC;MAC5B;IACF,CAAC,CAAC;IACF,OAAO,MAAM;MACX,IAAAF,2CAAsB,EAAC,IAAI,CAAC;IAC9B,CAAC;EACH,CAAC,EAAE,CAACrB,MAAM,CAAC,CAAC;AACd","ignoreList":[]}

package/lib/commonjs/hostAppVersion.js

@@ -0,0 +1,242 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.HOST_APP_VERSION_USER_ATTRIBUTE = exports.HOST_APP_BUILD_USER_ATTRIBUTE = void 0;
+exports.cacheHostAppVersionAtInit = cacheHostAppVersionAtInit;
+exports.formatHostAppVersionLog = formatHostAppVersionLog;
+exports.getCachedHostAppVersion = getCachedHostAppVersion;
+exports.hostAppVersionUserAttributes = hostAppVersionUserAttributes;
+exports.logHostAppVersion = logHostAppVersion;
+exports.mergeHostAppVersionUserAttributes = mergeHostAppVersionUserAttributes;
+exports.readDeviceInfoFromNativeModule = readDeviceInfoFromNativeModule;
+exports.readExpoApplication = readExpoApplication;
+exports.readExpoConstants = readExpoConstants;
+exports.resetCachedHostAppVersionForTests = resetCachedHostAppVersionForTests;
+exports.resolveHostAppVersion = resolveHostAppVersion;
+exports.resolveHostAppVersionForInit = resolveHostAppVersionForInit;
+exports.resolveHostAppVersionFromSources = resolveHostAppVersionFromSources;
+/**
+ * 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. */
+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. */
+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. */
+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). */
+function resolveHostAppVersionFromSources(sources) {
+  return readExpoApplication(sources.expoApplication) ?? readExpoConstants(sources.expoConstants) ?? readDeviceInfoFromNativeModule(sources.deviceInfoNative);
+}
+function resolveHostAppVersion() {
+  return resolveHostAppVersionFromSources({
+    expoApplication: tryRequireExpoApplication(),
+    expoConstants: tryRequireExpoConstants(),
+    deviceInfoNative: loadLinkedDeviceInfoNativeModule()
+  });
+}
+/** Visible for tests: resolve version for init, honoring an optional client override. */
+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.
+ */
+function cacheHostAppVersionAtInit(options = {}) {
+  cachedHostAppVersion = resolveHostAppVersionForInit(options);
+  return cachedHostAppVersion;
+}
+
+/** Returns the version cached at init, or `null` before init or when unavailable. */
+function getCachedHostAppVersion() {
+  return cachedHostAppVersion ?? null;
+}
+
+/** User attribute keys for the host app's native store version. */
+const HOST_APP_VERSION_USER_ATTRIBUTE = exports.HOST_APP_VERSION_USER_ATTRIBUTE = 'app_version';
+const HOST_APP_BUILD_USER_ATTRIBUTE = exports.HOST_APP_BUILD_USER_ATTRIBUTE = 'app_build';
+
+/** Returns cached host version fields for UpsertUser, or `{}` when unavailable. */
+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. */
+function mergeHostAppVersionUserAttributes(attributes) {
+  const system = hostAppVersionUserAttributes();
+  if (Object.keys(system).length === 0) {
+    return attributes;
+  }
+  return {
+    ...system,
+    ...(attributes ?? {})
+  };
+}
+
+/** @internal Resets init cache between tests. */
+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';
+  }
+}
+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. */
+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/commonjs/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","exports","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":[]}