@userflow-tech/react-native 0.1.0

package/lib/commonjs/deepLinking.js

@@ -0,0 +1,162 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.USERFLOW_URL_SCHEME_PREFIX = void 0;
+exports.__getPendingPreviewTokenForTests = __getPendingPreviewTokenForTests;
+exports.__resetDeepLinkingForTests = __resetDeepLinkingForTests;
+exports.didHandleURL = didHandleURL;
+exports.flushPendingPreviewToken = flushPendingPreviewToken;
+exports.parsePreviewDeepLink = parsePreviewDeepLink;
+exports.startDeepLinking = startDeepLinking;
+exports.stopDeepLinking = stopDeepLinking;
+var _reactNative = require("react-native");
+/**
+ * Inbound deep-link handling for builder preview.
+ *
+ * Host apps register their environment's `scheme_id` (e.g. `userflow-257587`) as
+ * a URL scheme at build time. The SDK matches inbound URLs by prefix + root
+ * query (no init config) and starts a draft flow via `StartFlowWithToken` once
+ * a user is identified.
+ */
+
+/** Scheme prefix required for Userflow deep links (build-time registration). */
+const USERFLOW_URL_SCHEME_PREFIX = exports.USERFLOW_URL_SCHEME_PREFIX = 'userflow-';
+let deps = null;
+let pendingToken = null;
+let lastHandledToken = null;
+let urlSubscription = null;
+let started = false;
+function getLinking() {
+  return deps?.linking ?? {
+    getInitialURL: () => _reactNative.Linking.getInitialURL(),
+    addEventListener: (type, handler) => _reactNative.Linking.addEventListener(type, handler)
+  };
+}
+
+/**
+ * Parse a Userflow preview deep link.
+ * Accepts `userflow-*://?token=...` (root form).
+ *
+ * A root URL carrying `pairing_token` instead of `token` is a pairing link —
+ * leave it for {@link inspectPairingDeepLink}.
+ */
+function parsePreviewDeepLink(url) {
+  const trimmed = url.trim();
+  if (!trimmed) return null;
+  const schemeMatch = /^([a-z][a-z0-9+.-]*):/i.exec(trimmed);
+  if (!schemeMatch?.[1]) return null;
+  const scheme = schemeMatch[1];
+  if (!scheme.toLowerCase().startsWith(USERFLOW_URL_SCHEME_PREFIX)) {
+    return null;
+  }
+
+  // Custom schemes need a rewrite so root forms (`://?token=…`) parse.
+  const remainder = trimmed.slice(scheme.length + 1).replace(/^\/\//, '');
+  let parsed;
+  try {
+    if (remainder === '' || remainder.startsWith('?') || remainder.startsWith('/')) {
+      parsed = new URL(remainder === '' ? '/' : remainder, 'https://userflow.local');
+    } else {
+      parsed = new URL(`https://${remainder}`);
+    }
+  } catch {
+    return null;
+  }
+
+  // Pairing wins at the root when both query shapes could apply.
+  if (parsed.searchParams.has('pairing_token')) {
+    return null;
+  }
+  const host = parsed.hostname.toLowerCase();
+  const path = parsed.pathname.replace(/\/+$/, '') || '/';
+  const isRoot = (host === '' || host === 'userflow.local') && (path === '' || path === '/');
+  if (!isRoot) {
+    return null;
+  }
+  const token = parsed.searchParams.get('token')?.trim() ?? '';
+  if (!token) {
+    return null;
+  }
+  return {
+    token
+  };
+}
+async function applyToken(token) {
+  if (!deps) return;
+  if (lastHandledToken === token) {
+    return;
+  }
+  if (!deps.isIdentified()) {
+    pendingToken = token;
+    return;
+  }
+  pendingToken = null;
+  lastHandledToken = token;
+  await deps.startFlowWithToken(token);
+}
+
+/**
+ * Handle an inbound URL. Returns true when it was a Userflow preview deep link.
+ */
+async function didHandleURL(url) {
+  const parsed = parsePreviewDeepLink(url);
+  if (!parsed) {
+    return false;
+  }
+  await applyToken(parsed.token);
+  return true;
+}
+
+/** Flush a buffered preview token after identify (no-op if none / not identified). */
+async function flushPendingPreviewToken() {
+  if (!deps || !pendingToken || !deps.isIdentified()) {
+    return;
+  }
+  const token = pendingToken;
+  pendingToken = null;
+  lastHandledToken = token;
+  await deps.startFlowWithToken(token);
+}
+
+/** Wire dependencies and start Listening for inbound URLs. Idempotent. */
+function startDeepLinking(nextDeps) {
+  deps = nextDeps;
+  if (started) {
+    return;
+  }
+  started = true;
+  const linking = getLinking();
+  void linking.getInitialURL().then(url => {
+    if (url) {
+      void didHandleURL(url);
+    }
+  });
+  urlSubscription = linking.addEventListener('url', ({
+    url
+  }) => {
+    void didHandleURL(url);
+  });
+}
+
+/** Stop Listening and clear buffered preview state. */
+function stopDeepLinking() {
+  urlSubscription?.remove();
+  urlSubscription = null;
+  started = false;
+  pendingToken = null;
+  lastHandledToken = null;
+  deps = null;
+}
+
+/** Test helper: inspect buffered token without flushing. */
+function __getPendingPreviewTokenForTests() {
+  return pendingToken;
+}
+
+/** Test helper: reset module state between suites. */
+function __resetDeepLinkingForTests() {
+  stopDeepLinking();
+}
+//# sourceMappingURL=deepLinking.js.map

package/lib/commonjs/deepLinking.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","USERFLOW_URL_SCHEME_PREFIX","exports","deps","pendingToken","lastHandledToken","urlSubscription","started","getLinking","linking","getInitialURL","Linking","addEventListener","type","handler","parsePreviewDeepLink","url","trimmed","trim","schemeMatch","exec","scheme","toLowerCase","startsWith","remainder","slice","length","replace","parsed","URL","searchParams","has","host","hostname","path","pathname","isRoot","token","get","applyToken","isIdentified","startFlowWithToken","didHandleURL","flushPendingPreviewToken","startDeepLinking","nextDeps","then","stopDeepLinking","remove","__getPendingPreviewTokenForTests","__resetDeepLinkingForTests"],"sourceRoot":"../../src","sources":["deepLinking.ts"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.UserflowExpoRouterScreenTracker = UserflowExpoRouterScreenTracker;
+var _useUserflowExpoRouter = require("./useUserflowExpoRouter.js");
+/** Invisible component that wires Expo Router pathname tracking into the SDK. */
+function UserflowExpoRouterScreenTracker() {
+  (0, _useUserflowExpoRouter.useUserflowExpoRouter)();
+  return null;
+}
+//# sourceMappingURL=UserflowExpoRouterScreenTracker.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_useUserflowExpoRouter","require","UserflowExpoRouterScreenTracker","useUserflowExpoRouter"],"sourceRoot":"../../../src","sources":["expo-router/UserflowExpoRouterScreenTracker.tsx"],"mappings":";;;;;;AAAA,IAAAA,sBAAA,GAAAC,OAAA;AAEA;AACO,SAASC,+BAA+BA,CAAA,EAAS;EACtD,IAAAC,4CAAqB,EAAC,CAAC;EACvB,OAAO,IAAI;AACb","ignoreList":[]}

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

@@ -0,0 +1,44 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getExpoRouterScreenTracker = getExpoRouterScreenTracker;
+exports.resetExpoRouterScreenTrackerCacheForTests = resetExpoRouterScreenTrackerCacheForTests;
+let cached;
+
+/**
+ * Returns the Expo Router screen tracker when a real `expo-router` peer is
+ * installed (both `usePathname` and `useRouter`), otherwise `null`.
+ *
+ * Not part of the public API — hosts mount {@link UserflowExpoRouterScreenTracker}
+ * from `@userflow-tech/react-native/expo-router`. Kept for unit tests that probe
+ * partial / absent `expo-router` stubs.
+ */
+function getExpoRouterScreenTracker() {
+  if (cached !== undefined) return cached;
+  if (typeof require !== 'function') {
+    cached = null;
+    return cached;
+  }
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires -- optional peer probe
+    const expoRouter = require('expo-router');
+    if (typeof expoRouter?.usePathname !== 'function' || typeof expoRouter?.useRouter !== 'function') {
+      cached = null;
+      return cached;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
+    const mod = require('./UserflowExpoRouterScreenTracker');
+    cached = mod.UserflowExpoRouterScreenTracker;
+  } catch {
+    cached = null;
+  }
+  return cached;
+}
+
+/** @internal Resets module cache between tests. */
+function resetExpoRouterScreenTrackerCacheForTests() {
+  cached = undefined;
+}
+//# sourceMappingURL=getExpoRouterScreenTracker.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["cached","getExpoRouterScreenTracker","undefined","require","expoRouter","usePathname","useRouter","mod","UserflowExpoRouterScreenTracker","resetExpoRouterScreenTrackerCacheForTests"],"sourceRoot":"../../../src","sources":["expo-router/getExpoRouterScreenTracker.ts"],"mappings":";;;;;;;AAEA,IAAIA,MAAwC;;AAE5C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,0BAA0BA,CAAA,EAAyB;EACjE,IAAID,MAAM,KAAKE,SAAS,EAAE,OAAOF,MAAM;EAEvC,IAAI,OAAOG,OAAO,KAAK,UAAU,EAAE;IACjCH,MAAM,GAAG,IAAI;IACb,OAAOA,MAAM;EACf;EAEA,IAAI;IACF;IACA,MAAMI,UAAU,GAAGD,OAAO,CAAC,aAAa,CAGvC;IACD,IACE,OAAOC,UAAU,EAAEC,WAAW,KAAK,UAAU,IAC7C,OAAOD,UAAU,EAAEE,SAAS,KAAK,UAAU,EAC3C;MACAN,MAAM,GAAG,IAAI;MACb,OAAOA,MAAM;IACf;IACA;IACA,MAAMO,GAAG,GAAGJ,OAAO,CAAC,mCAAmC,CAEtD;IACDH,MAAM,GAAGO,GAAG,CAACC,+BAA+B;EAC9C,CAAC,CAAC,MAAM;IACNR,MAAM,GAAG,IAAI;EACf;EAEA,OAAOA,MAAM;AACf;;AAEA;AACO,SAASS,yCAAyCA,CAAA,EAAS;EAChET,MAAM,GAAGE,SAAS;AACpB","ignoreList":[]}

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

@@ -0,0 +1,20 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "UserflowExpoRouterScreenTracker", {
+  enumerable: true,
+  get: function () {
+    return _UserflowExpoRouterScreenTracker.UserflowExpoRouterScreenTracker;
+  }
+});
+Object.defineProperty(exports, "useUserflowExpoRouter", {
+  enumerable: true,
+  get: function () {
+    return _useUserflowExpoRouter.useUserflowExpoRouter;
+  }
+});
+var _useUserflowExpoRouter = require("./useUserflowExpoRouter.js");
+var _UserflowExpoRouterScreenTracker = require("./UserflowExpoRouterScreenTracker.js");
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_useUserflowExpoRouter","require","_UserflowExpoRouterScreenTracker"],"sourceRoot":"../../../src","sources":["expo-router/index.ts"],"mappings":";;;;;;;;;;;;;;;;;AAAA,IAAAA,sBAAA,GAAAC,OAAA;AACA,IAAAC,gCAAA,GAAAD,OAAA","ignoreList":[]}

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

@@ -0,0 +1,45 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useUserflowExpoRouter = useUserflowExpoRouter;
+var _expoRouter = require("expo-router");
+var _react = require("react");
+var _openFlowNavigateUrl = require("../navigation/openFlowNavigateUrl.js");
+var _screenTracker = require("../screenTracker.js");
+/**
+ * Tracks Expo Router pathname changes for Userflow screen detection and
+ * registers `router.push` for path-like flow NAVIGATE actions.
+ *
+ * Mount via {@link UserflowExpoRouterScreenTracker} from
+ * `@userflow-tech/react-native/expo-router` under {@link UserflowProvider}. Do not
+ * 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`).
+ *
+ * Screen tracking ≠ action routing: NAVIGATE for in-app paths uses the router
+ * handle registered here; http(s)/mailto/tel still go through Linking.
+ */
+function useUserflowExpoRouter() {
+  const pathname = (0, _expoRouter.usePathname)();
+  const router = (0, _expoRouter.useRouter)();
+  (0, _react.useEffect)(() => {
+    (0, _screenTracker.handleScreenChange)(pathname ? {
+      path: pathname
+    } : undefined);
+  }, [pathname]);
+  (0, _react.useEffect)(() => {
+    (0, _openFlowNavigateUrl.setExpoRouterNavigator)({
+      push: href => {
+        router.push(href);
+      }
+    });
+    return () => {
+      (0, _openFlowNavigateUrl.setExpoRouterNavigator)(null);
+    };
+  }, [router]);
+}
+//# sourceMappingURL=useUserflowExpoRouter.js.map

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

@@ -0,0 +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":[]}

package/lib/commonjs/index.js

@@ -0,0 +1,356 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "INACTIVITY_TIMEOUT_MS", {
+  enumerable: true,
+  get: function () {
+    return _lifecycle.INACTIVITY_TIMEOUT_MS;
+  }
+});
+Object.defineProperty(exports, "PreviewModeBanner", {
+  enumerable: true,
+  get: function () {
+    return _index.PreviewModeBanner;
+  }
+});
+Object.defineProperty(exports, "SDK_VERSION", {
+  enumerable: true,
+  get: function () {
+    return _version.SDK_VERSION;
+  }
+});
+Object.defineProperty(exports, "SESSION_STALE_AFTER_BACKGROUND_MS", {
+  enumerable: true,
+  get: function () {
+    return _lifecycle.SESSION_STALE_AFTER_BACKGROUND_MS;
+  }
+});
+Object.defineProperty(exports, "SUSPEND_GRACE_MS", {
+  enumerable: true,
+  get: function () {
+    return _lifecycle.SUSPEND_GRACE_MS;
+  }
+});
+exports.Userflow = void 0;
+Object.defineProperty(exports, "UserflowProvider", {
+  enumerable: true,
+  get: function () {
+    return _UserflowProvider.UserflowProvider;
+  }
+});
+Object.defineProperty(exports, "__userflowAutoAnchor", {
+  enumerable: true,
+  get: function () {
+    return _autoAnchor.__userflowAutoAnchor;
+  }
+});
+Object.defineProperty(exports, "inspectPairingDeepLink", {
+  enumerable: true,
+  get: function () {
+    return _index.inspectPairingDeepLink;
+  }
+});
+Object.defineProperty(exports, "isPairingAttempt", {
+  enumerable: true,
+  get: function () {
+    return _index.isPairingAttempt;
+  }
+});
+Object.defineProperty(exports, "isUserflowPairingUrl", {
+  enumerable: true,
+  get: function () {
+    return _index.isUserflowPairingUrl;
+  }
+});
+Object.defineProperty(exports, "parsePairingDeepLink", {
+  enumerable: true,
+  get: function () {
+    return _index.parsePairingDeepLink;
+  }
+});
+Object.defineProperty(exports, "useFlowSessionState", {
+  enumerable: true,
+  get: function () {
+    return _useFlowSessionState.useFlowSessionState;
+  }
+});
+Object.defineProperty(exports, "useUserflow", {
+  enumerable: true,
+  get: function () {
+    return _UserflowProvider.useUserflow;
+  }
+});
+Object.defineProperty(exports, "useUserflowAnchor", {
+  enumerable: true,
+  get: function () {
+    return _useUserflowAnchor.useUserflowAnchor;
+  }
+});
+Object.defineProperty(exports, "useUserflowScreen", {
+  enumerable: true,
+  get: function () {
+    return _useUserflowScreen.useUserflowScreen;
+  }
+});
+Object.defineProperty(exports, "useUserflowScrollContainer", {
+  enumerable: true,
+  get: function () {
+    return _useUserflowScrollContainer.useUserflowScrollContainer;
+  }
+});
+var _autoAnchor = require("./anchors/autoAnchor.js");
+var _anchorChangeTicker = require("./anchors/anchorChangeTicker.js");
+var _resolveAnchorHost = require("./anchors/resolveAnchorHost.js");
+var _scrollConfig = require("./anchors/scrollConfig.js");
+var _anonymousId = require("./anonymousId.js");
+var _deepLinking = require("./deepLinking.js");
+var _lifecycle = require("./lifecycle.js");
+var _openFlowNavigateUrl = require("./navigation/openFlowNavigateUrl.js");
+var _network = require("./network.js");
+var _pairingRuntime = require("./pairing/pairingRuntime.js");
+var _clientConditions = require("./runtime/clientConditions.js");
+var _flowEngine = require("./runtime/flowEngine.js");
+var _userflowCore = require("./runtime/userflowCore.js");
+var _screenTracker = require("./screenTracker.js");
+var _version = require("./version.js");
+var _UserflowProvider = require("./runtime/UserflowProvider.js");
+var _useFlowSessionState = require("./runtime/useFlowSessionState.js");
+var _useUserflowScreen = require("./useUserflowScreen.js");
+var _useUserflowAnchor = require("./anchors/useUserflowAnchor.js");
+var _useUserflowScrollContainer = require("./anchors/useUserflowScrollContainer.js");
+var _index = require("./pairing/index.js");
+/**
+ * @userflow-tech/react-native — public API for the Userflow React Native SDK.
+ *
+ * Exposes the `Userflow` singleton host apps import. Auth/identity and the
+ * transport live in `@userflow-tech/core`; this binding is a thin facade that
+ * delegates to the core engine, wires React Native app lifecycle
+ * (background/foreground + idle) to the connection, hosts the flow session
+ * engine + provider overlay for Phase 3 rendering, and tracks screen changes.
+ */
+
+/** Configuration passed to {@link Userflow.init}. */
+
+const core = (0, _userflowCore.getUserflowCore)();
+const lifecycle = new _lifecycle.LifecycleController({
+  suspend: () => core.suspend(),
+  resume: () => {
+    core.resume();
+    // After reconnect, flush mid-flow client messages that failed while offline.
+    void (0, _flowEngine.getFlowSessionEngine)(core).flushPendingSends();
+  },
+  clearLocalSession: () => {
+    (0, _flowEngine.clearFlowSessionEngineLocalSession)();
+    // Engine may not exist yet; still clear any transport join resume id.
+    core.setFlowSessionId(null);
+  },
+  ensureAlive: () => core.ensureAlive(),
+  hasActiveSession: () => (0, _flowEngine.hasActiveFlowSession)()
+});
+const network = new _network.NetworkController({
+  // Probe if still "connected" (half-open) or reconnect eagerly if already dropped.
+  ensureAlive: () => core.ensureAlive()
+});
+function wireScreenChangeReporter() {
+  (0, _screenTracker.setScreenChangeReporter)(location => {
+    lifecycle.reportActivity();
+    const screenKey = 'path' in location ? `path:${location.path}` : `screen:${location.screen}`;
+    (0, _resolveAnchorHost.notifyAnchorScreenChange)(screenKey);
+    _anchorChangeTicker.anchorChangeTicker.notify();
+    if (__DEV__) {
+      const identified = core.getUserId() != null;
+      // eslint-disable-next-line no-console -- intentional development diagnostic
+      console.log('[Userflow] updateScreen', location, identified ? '(push UpdateClientContext)' : '(buffered until identify)');
+    }
+    // Mirrors web: only pushes UpdateClientContext after identify; before that the
+    // location is remembered and included on the next end-user channel join.
+    void core.updateScreen(location).catch(() => {
+      // Screen updates are best-effort; connection drops / rate limits should not
+      // surface to the host app's navigation path.
+    });
+  });
+}
+wireScreenChangeReporter();
+function wireDeepLinking() {
+  (0, _deepLinking.startDeepLinking)({
+    isIdentified: () => core.getUserId() != null,
+    startFlowWithToken: token => core.startFlowWithToken(token)
+  });
+}
+async function afterIdentify() {
+  (0, _flowEngine.attachFlowSessionEngine)(core);
+  (0, _clientConditions.attachClientConditionEngine)(core);
+  (0, _pairingRuntime.getPairingController)(core).notifyIdentified();
+  lifecycle.reportActivity();
+  try {
+    await (0, _deepLinking.flushPendingPreviewToken)();
+  } catch {
+    // Preview start is best-effort; identify must still succeed for the host app.
+  }
+}
+
+/**
+ * Public SDK entry point. Delegates to the platform-agnostic engine in
+ * `@userflow-tech/core` and manages the app-lifecycle subscription.
+ */
+const Userflow = exports.Userflow = {
+  /** Validate credentials, store configuration, and wire app-lifecycle handling. */
+  init(config) {
+    (0, _openFlowNavigateUrl.setHostOnNavigate)(config.onNavigate);
+    lifecycle.start();
+    network.start();
+    wireScreenChangeReporter();
+    wireDeepLinking();
+    // Builder pairing (QR deep links) — active in all builds.
+    //
+    // Listeners attach *before* core.init so an inbound QR link is captured even
+    // when init is still in flight or ends up rejecting. The OS launches the app
+    // from the deep link regardless of SDK state, so a listener installed only on
+    // the success path makes a failed init look like a broken deep link.
+    const pairing = (0, _pairingRuntime.installPairingController)(core, {
+      ...(config.pairingEndpoint !== undefined ? {
+        pairingEndpoint: config.pairingEndpoint
+      } : {}),
+      clearLocalSession: () => {
+        (0, _flowEngine.clearFlowSessionEngineLocalSession)();
+        core.setFlowSessionId(null);
+      }
+    });
+    pairing.notifyInitStarted();
+    void pairing.start();
+    return core.init(config).then(async resolved => {
+      (0, _screenTracker.enableScreenTracking)();
+      await pairing.notifyInitialized();
+      return resolved;
+    }, error => {
+      pairing.notifyInitFailed(error);
+      throw error;
+    });
+  },
+  /**
+   * Forward a Userflow pairing deep link into the SDK.
+   * Prefer automatic Linking interception from {@link Userflow.init}; use this
+   * when the host app owns URL routing.
+   */
+  handlePairingUrl(url) {
+    return (0, _pairingRuntime.getPairingController)(core).handleUrl(url);
+  },
+  /** Exit Builder preview mode and disconnect the pairing websocket. */
+  exitPreview() {
+    return (0, _pairingRuntime.getPairingController)(core).exitPreview();
+  },
+  /**
+   * Override or clear the host NAVIGATE handler (same as `init({ onNavigate })`).
+   * Wins over React Navigation / Expo Router / Linking when set.
+   */
+  setOnNavigate(handler) {
+    (0, _openFlowNavigateUrl.setHostOnNavigate)(handler);
+  },
+  /** Identify the current user and upsert their attributes. */
+  async identify(userId, attributes, options) {
+    const previousId = core.getUserId();
+    // Clear before join so the new channel is not seeded with another user's
+    // client-condition snapshot.
+    if (previousId != null && previousId !== userId) {
+      (0, _clientConditions.resetClientConditionEngine)();
+      core.setClientConditions([]);
+      await (0, _anonymousId.clearAnonymousId)();
+    }
+    await core.identify(userId, attributes, options);
+    await afterIdentify();
+  },
+  /** Identify an anonymous user with a stable auto-generated id stored on device. */
+  async identifyAnonymous(attributes, options) {
+    const anonymousId = await (0, _anonymousId.getOrCreateAnonymousId)();
+    const previousId = core.getUserId();
+    if (previousId != null && previousId !== anonymousId) {
+      (0, _clientConditions.resetClientConditionEngine)();
+      core.setClientConditions([]);
+    }
+    await core.identify(anonymousId, attributes, options);
+    await afterIdentify();
+  },
+  /**
+   * Handle an inbound URL. Returns `true` when it was a Userflow preview deep
+   * link (`userflow-*://?token=...`).
+   * Prefer letting {@link init} auto-listen; call this when the host app already
+   * owns Linking.
+   */
+  didHandleURL(url) {
+    return (0, _deepLinking.didHandleURL)(url);
+  },
+  /** Associate the current user with a group and upsert group/membership attributes. */
+  group(groupId, attributes, options) {
+    lifecycle.reportActivity();
+    return core.group(groupId, attributes, options);
+  },
+  /** Record a custom analytics event for the current user (and group, unless `userOnly`). */
+  track(name, attributes, options) {
+    lifecycle.reportActivity();
+    return core.track(name, attributes, options);
+  },
+  /** The currently identified user id, or `null` before identify. */
+  getUserId() {
+    return core.getUserId();
+  },
+  /** A copy of the attributes recorded for the current user. */
+  getAttributes() {
+    return core.getAttributes();
+  },
+  /** The flow session engine (created lazily; attach runs after identify). */
+  getFlowSessionEngine() {
+    return (0, _flowEngine.getFlowSessionEngine)(core);
+  },
+  /** Clears the current user identity and disconnects from Userflow. */
+  async reset() {
+    (0, _clientConditions.resetClientConditionEngine)();
+    (0, _flowEngine.resetFlowSessionEngine)();
+    core.reset();
+    await (0, _anonymousId.clearAnonymousId)();
+  },
+  /** Remove app-lifecycle, network, and deep-link subscriptions (call on unmount / teardown). */
+  teardown() {
+    (0, _pairingRuntime.getPairingController)(core).stop();
+    lifecycle.stop();
+    network.stop();
+    (0, _screenTracker.disableScreenTracking)();
+    (0, _deepLinking.stopDeepLinking)();
+  },
+  /**
+   * Signal user activity so the foreground idle timer resets and an
+   * idle-suspended socket reconnects. Prefer automatic signals from
+   * {@link updateScreen} / identify / group; call this for touch or other
+   * host-app activity the SDK does not observe.
+   */
+  reportActivity() {
+    lifecycle.reportActivity();
+  },
+  /**
+   * Report the active React Navigation (or manual) screen name. Prefer
+   * {@link useUserflowScreen} in React trees; use this for imperative updates
+   * outside hooks. When a user is identified, pushes `UpdateClientContext`
+   * with `screen` set (Expo Router pathnames use `path` via the Expo helper).
+   */
+  updateScreen(screenName) {
+    (0, _screenTracker.handleScreenChange)(screenName ? {
+      screen: screenName
+    } : undefined);
+  },
+  /**
+   * Sticky header/footer insets applied when scrolling tooltip targets into
+   * view (mirrors web `userflow.setScrollPadding`).
+   */
+  setScrollPadding(padding) {
+    (0, _scrollConfig.setScrollPadding)(padding);
+  },
+  /**
+   * Replace the SDK's scroll-into-view behavior. Pass `null` to restore the
+   * default fiber / registry path (mirrors web `userflow.setCustomScrollIntoView`).
+   */
+  setCustomScrollIntoView(fn) {
+    (0, _scrollConfig.setCustomScrollIntoView)(fn);
+  }
+};
+//# sourceMappingURL=index.js.map