@userflow-tech/react-native 0.1.1 → 0.3.0

package/lib/module/pairing/elementPickerRelay.js

@@ -0,0 +1,87 @@
+"use strict";
+
+import { isPairingPushAckTimeout } from '@userflow-tech/core';
+import { elementPickerController } from "../authoring/elementPickerController.js";
+function asRecord(payload) {
+  return payload && typeof payload === 'object' ? payload : {};
+}
+function idempotencyKeyOf(payload) {
+  const key = asRecord(payload)['idempotency_key'];
+  return typeof key === 'string' && key.length > 0 ? key : null;
+}
+function resultPayload(key, result) {
+  return {
+    idempotency_key: key,
+    ok: true,
+    autoData: result.autoData,
+    text: result.text ?? null,
+    ...(result.screenshot ? {
+      screenshot: {
+        dataUrl: result.screenshot.dataUrl,
+        width: result.screenshot.width,
+        height: result.screenshot.height,
+        targetX1: result.screenshot.targetX1,
+        targetY1: result.screenshot.targetY1,
+        targetX2: result.screenshot.targetX2,
+        targetY2: result.screenshot.targetY2
+      }
+    } : {})
+  };
+}
+
+/**
+ * Bridge pairing-channel `selectElement*` events onto {@link elementPickerController}.
+ * UI-free: the overlay (and QA harness) own the actual picking.
+ */
+export function bindElementPickerRelay(engine) {
+  if (typeof engine.onRelay !== 'function' || typeof engine.sendRelay !== 'function') {
+    return () => undefined;
+  }
+  let ignoreNextCancelSend = false;
+
+  /** Result delivery: ignore ack timeouts; surface connection failures. */
+  const sendResult = async (key, result) => {
+    try {
+      await engine.sendRelay('selectElementResult', resultPayload(key, result));
+    } catch (error) {
+      if (typeof isPairingPushAckTimeout === 'function' && isPairingPushAckTimeout(error)) {
+        return;
+      }
+      throw error;
+    }
+  };
+
+  /** Cancel is best-effort: ignore timeout and disconnect. */
+  const sendCancel = key => {
+    void engine.sendRelay('selectElementCancel', {
+      idempotency_key: key
+    }).catch(() => undefined);
+  };
+  const unsub = engine.onRelay((event, payload) => {
+    if (event === 'selectElement') {
+      const key = idempotencyKeyOf(payload);
+      if (!key) return;
+      elementPickerController.beginSelection({
+        requestId: key,
+        onResult: result => sendResult(key, result),
+        onCancel: () => {
+          if (ignoreNextCancelSend) return;
+          sendCancel(key);
+        }
+      });
+      return;
+    }
+    if (event === 'selectElementCancel') {
+      ignoreNextCancelSend = true;
+      elementPickerController.cancel();
+      ignoreNextCancelSend = false;
+    }
+  });
+  return () => {
+    unsub();
+    ignoreNextCancelSend = true;
+    elementPickerController.cancel();
+    ignoreNextCancelSend = false;
+  };
+}
+//# sourceMappingURL=elementPickerRelay.js.map

package/lib/module/pairing/elementPickerRelay.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isPairingPushAckTimeout","elementPickerController","asRecord","payload","idempotencyKeyOf","key","length","resultPayload","result","idempotency_key","ok","autoData","text","screenshot","dataUrl","width","height","targetX1","targetY1","targetX2","targetY2","bindElementPickerRelay","engine","onRelay","sendRelay","undefined","ignoreNextCancelSend","sendResult","error","sendCancel","catch","unsub","event","beginSelection","requestId","onResult","onCancel","cancel"],"sourceRoot":"../../../src","sources":["pairing/elementPickerRelay.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/pairing/resolvePreviewChrome.js

@@ -0,0 +1,48 @@
+"use strict";
+
+function isBannerVisible(state) {
+  if (!state.previewActive && state.status === 'idle') return false;
+  if (!state.previewActive && state.status !== 'token_expired' && state.status !== 'device_already_paired' && state.status !== 'error') {
+    return false;
+  }
+  return true;
+}
+function shown(tone, label, numberOfLines = 1) {
+  return {
+    visible: true,
+    tone,
+    label,
+    numberOfLines
+  };
+}
+
+/**
+ * Maps pairing-engine state onto the preview top-bar chrome.
+ * Pure: no React, so the nine-case table can be asserted without a renderer.
+ */
+export function resolvePreviewChrome(state) {
+  if (!isBannerVisible(state)) return {
+    visible: false
+  };
+  switch (state.status) {
+    case 'connecting':
+      return shown('default', 'Connecting to Builder…');
+    case 'reconnecting':
+      return shown('default', 'Reconnecting…');
+    case 'token_expired':
+      return shown('error', 'Pairing ended - rescan to continue', 2);
+    case 'device_already_paired':
+      return shown('error', 'Another device is already paired', 2);
+    case 'error':
+      if (state.pairingId === null) {
+        return shown('error', 'Preview unavailable');
+      }
+      return shown('error', 'Pairing ended - rescan to continue', 2);
+    default:
+      if (state.awaitingStartCondition) {
+        return shown('default', 'Waiting for auto-start condition…');
+      }
+      return shown('default', 'Preview mode');
+  }
+}
+//# sourceMappingURL=resolvePreviewChrome.js.map

package/lib/module/pairing/resolvePreviewChrome.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isBannerVisible","state","previewActive","status","shown","tone","label","numberOfLines","visible","resolvePreviewChrome","pairingId","awaitingStartCondition"],"sourceRoot":"../../../src","sources":["pairing/resolvePreviewChrome.ts"],"mappings":";;AAQA,SAASA,eAAeA,CAACC,KAAyB,EAAW;EAC3D,IAAI,CAACA,KAAK,CAACC,aAAa,IAAID,KAAK,CAACE,MAAM,KAAK,MAAM,EAAE,OAAO,KAAK;EACjE,IACE,CAACF,KAAK,CAACC,aAAa,IACpBD,KAAK,CAACE,MAAM,KAAK,eAAe,IAChCF,KAAK,CAACE,MAAM,KAAK,uBAAuB,IACxCF,KAAK,CAACE,MAAM,KAAK,OAAO,EACxB;IACA,OAAO,KAAK;EACd;EACA,OAAO,IAAI;AACb;AAEA,SAASC,KAAKA,CACZC,IAAsB,EACtBC,KAAa,EACbC,aAAa,GAAG,CAAC,EAC0B;EAC3C,OAAO;IAAEC,OAAO,EAAE,IAAI;IAAEH,IAAI;IAAEC,KAAK;IAAEC;EAAc,CAAC;AACtD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,oBAAoBA,CAACR,KAAyB,EAAiB;EAC7E,IAAI,CAACD,eAAe,CAACC,KAAK,CAAC,EAAE,OAAO;IAAEO,OAAO,EAAE;EAAM,CAAC;EAEtD,QAAQP,KAAK,CAACE,MAAM;IAClB,KAAK,YAAY;MACf,OAAOC,KAAK,CAAC,SAAS,EAAE,wBAAwB,CAAC;IACnD,KAAK,cAAc;MACjB,OAAOA,KAAK,CAAC,SAAS,EAAE,eAAe,CAAC;IAC1C,KAAK,eAAe;MAClB,OAAOA,KAAK,CAAC,OAAO,EAAE,oCAAoC,EAAE,CAAC,CAAC;IAChE,KAAK,uBAAuB;MAC1B,OAAOA,KAAK,CAAC,OAAO,EAAE,kCAAkC,EAAE,CAAC,CAAC;IAC9D,KAAK,OAAO;MACV,IAAIH,KAAK,CAACS,SAAS,KAAK,IAAI,EAAE;QAC5B,OAAON,KAAK,CAAC,OAAO,EAAE,qBAAqB,CAAC;MAC9C;MACA,OAAOA,KAAK,CAAC,OAAO,EAAE,oCAAoC,EAAE,CAAC,CAAC;IAChE;MACE,IAAIH,KAAK,CAACU,sBAAsB,EAAE;QAChC,OAAOP,KAAK,CAAC,SAAS,EAAE,mCAAmC,CAAC;MAC9D;MACA,OAAOA,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC;EAC3C;AACF","ignoreList":[]}

package/lib/module/pairing/tokenStorage.js

@@ -1,24 +1,47 @@
 "use strict";
 
 /**
- * Persist the pairing JWT for reconnect within the current app session.
- * Cleared on SDK init / exit preview / app restart (pairing exits on restart).
+ * Persist the pairing JWT so a relaunch can resume Builder pairing until the
+ * token expires or preview is exited. Resume requires `expo-secure-store`;
+ * the in-memory fallback does not survive a process restart.
  */
 
-const STORAGE_KEY = 'userflow:pairingToken';
+import { parsePairingPurpose } from "./deepLink.js";
+
+// SecureStore rejects keys outside [A-Za-z0-9._-], so no `userflow:` prefix here.
+export const PAIRING_TOKEN_STORAGE_KEY = 'userflow.pairingToken';
+export const PAIRING_PURPOSE_STORAGE_KEY = 'userflow.pairingPurpose';
+let cachedSecureStore;
+
+/** Expo modules must be installed natively — not just the JS package. */
+function isExpoModulesRuntimeAvailable() {
+  const expo = globalThis.expo;
+  return typeof expo?.EventEmitter === 'function';
+}
 function tryLoadExpoSecureStore() {
+  if (cachedSecureStore !== undefined) return cachedSecureStore;
+  if (typeof require !== 'function' || !isExpoModulesRuntimeAvailable()) {
+    cachedSecureStore = null;
+    return cachedSecureStore;
+  }
   try {
     // Optional peer — absent in bare RN without expo-secure-store.
     // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires -- optional peer at import time
-    return require('expo-secure-store');
+    cachedSecureStore = require('expo-secure-store');
   } catch {
-    return null;
+    cachedSecureStore = null;
+    if (__DEV__) {
+      // eslint-disable-next-line no-console -- intentional missing-optional-peer diagnostic
+      console.warn('[Userflow] Optional peer expo-secure-store is unavailable; ' + 'pairing JWT persistence falls back to in-memory storage.');
+    }
   }
+  return cachedSecureStore;
 }
 
 /** In-memory store used when SecureStore is unavailable (and in tests). */
 export function createMemoryPairingTokenStore() {
   let value = null;
+  let purposeValue = null;
   return {
     async get() {
       return value;
@@ -28,6 +51,13 @@ export function createMemoryPairingTokenStore() {
     },
     async clear() {
       value = null;
+      purposeValue = null;
+    },
+    async getPurpose() {
+      return purposeValue;
+    },
+    async setPurpose(purpose) {
+      purposeValue = purpose;
     }
   };
 }
@@ -41,25 +71,57 @@ export function createPairingTokenStore() {
   return {
     async get() {
       try {
-        return await secure.getItemAsync(STORAGE_KEY);
+        return await secure.getItemAsync(PAIRING_TOKEN_STORAGE_KEY);
       } catch {
         return null;
       }
     },
     async set(token) {
       try {
-        await secure.setItemAsync(STORAGE_KEY, token);
-      } catch {
+        await secure.setItemAsync(PAIRING_TOKEN_STORAGE_KEY, token);
+      } catch (error) {
         // Best-effort; reconnect still works from in-memory PairingEngine token.
+        if (__DEV__) {
+          // eslint-disable-next-line no-console -- intentional persistence diagnostic
+          console.warn('[Userflow] Could not save the pairing token, so preview will not resume after a relaunch:', error instanceof Error ? error.message : String(error));
+        }
       }
     },
     async clear() {
       try {
-        await secure.deleteItemAsync(STORAGE_KEY);
+        await secure.deleteItemAsync(PAIRING_TOKEN_STORAGE_KEY);
+      } catch {
+        // ignore
+      }
+      try {
+        await secure.deleteItemAsync(PAIRING_PURPOSE_STORAGE_KEY);
       } catch {
         // ignore
       }
+    },
+    async getPurpose() {
+      try {
+        return parsePairingPurpose(await secure.getItemAsync(PAIRING_PURPOSE_STORAGE_KEY));
+      } catch {
+        return null;
+      }
+    },
+    async setPurpose(purpose) {
+      try {
+        if (purpose) {
+          await secure.setItemAsync(PAIRING_PURPOSE_STORAGE_KEY, purpose);
+        } else {
+          await secure.deleteItemAsync(PAIRING_PURPOSE_STORAGE_KEY);
+        }
+      } catch {
+        // Best-effort; a resume without it falls back to the default reveal.
+      }
     }
   };
 }
+
+/** @internal Resets module cache between tests. */
+export function resetPairingTokenStoreCacheForTests() {
+  cachedSecureStore = undefined;
+}
 //# sourceMappingURL=tokenStorage.js.map

package/lib/module/pairing/tokenStorage.js.map

@@ -1 +1 @@
-{"version":3,"names":["STORAGE_KEY","tryLoadExpoSecureStore","require","createMemoryPairingTokenStore","value","get","set","token","clear","createPairingTokenStore","secure","getItemAsync","setItemAsync","deleteItemAsync"],"sourceRoot":"../../../src","sources":["pairing/tokenStorage.ts"],"mappings":";;AAAA;AACA;AACA;AACA;;AAEA,MAAMA,WAAW,GAAG,uBAAuB;AAc3C,SAASC,sBAAsBA,CAAA,EAA6B;EAC1D,IAAI;IACF;IACA;IACA,OAAOC,OAAO,CAAC,mBAAmB,CAAC;EACrC,CAAC,CAAC,MAAM;IACN,OAAO,IAAI;EACb;AACF;;AAEA;AACA,OAAO,SAASC,6BAA6BA,CAAA,EAAsB;EACjE,IAAIC,KAAoB,GAAG,IAAI;EAC/B,OAAO;IACL,MAAMC,GAAGA,CAAA,EAAG;MACV,OAAOD,KAAK;IACd,CAAC;IACD,MAAME,GAAGA,CAACC,KAAa,EAAE;MACvBH,KAAK,GAAGG,KAAK;IACf,CAAC;IACD,MAAMC,KAAKA,CAAA,EAAG;MACZJ,KAAK,GAAG,IAAI;IACd;EACF,CAAC;AACH;;AAEA;AACA;AACA;AACA,OAAO,SAASK,uBAAuBA,CAAA,EAAsB;EAC3D,MAAMC,MAAM,GAAGT,sBAAsB,CAAC,CAAC;EACvC,IAAI,CAACS,MAAM,EAAE,OAAOP,6BAA6B,CAAC,CAAC;EAEnD,OAAO;IACL,MAAME,GAAGA,CAAA,EAAG;MACV,IAAI;QACF,OAAO,MAAMK,MAAM,CAACC,YAAY,CAACX,WAAW,CAAC;MAC/C,CAAC,CAAC,MAAM;QACN,OAAO,IAAI;MACb;IACF,CAAC;IACD,MAAMM,GAAGA,CAACC,KAAa,EAAE;MACvB,IAAI;QACF,MAAMG,MAAM,CAACE,YAAY,CAACZ,WAAW,EAAEO,KAAK,CAAC;MAC/C,CAAC,CAAC,MAAM;QACN;MAAA;IAEJ,CAAC;IACD,MAAMC,KAAKA,CAAA,EAAG;MACZ,IAAI;QACF,MAAME,MAAM,CAACG,eAAe,CAACb,WAAW,CAAC;MAC3C,CAAC,CAAC,MAAM;QACN;MAAA;IAEJ;EACF,CAAC;AACH","ignoreList":[]}
+{"version":3,"names":["parsePairingPurpose","PAIRING_TOKEN_STORAGE_KEY","PAIRING_PURPOSE_STORAGE_KEY","cachedSecureStore","isExpoModulesRuntimeAvailable","expo","globalThis","EventEmitter","tryLoadExpoSecureStore","undefined","require","__DEV__","console","warn","createMemoryPairingTokenStore","value","purposeValue","get","set","token","clear","getPurpose","setPurpose","purpose","createPairingTokenStore","secure","getItemAsync","setItemAsync","error","Error","message","String","deleteItemAsync","resetPairingTokenStoreCacheForTests"],"sourceRoot":"../../../src","sources":["pairing/tokenStorage.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/pairing/usePairingState.js

@@ -9,7 +9,11 @@ const IDLE = {
   previewActive: false,
   lastError: null,
   needsRescan: false,
-  awaitingStartCondition: false
+  awaitingStartCondition: false,
+  canRestartPreview: false,
+  previewRestartGeneration: 0,
+  pairingSessionGeneration: 0,
+  previewStartGeneration: 0
 };
 
 /** Subscribe to Builder pairing / preview-mode state (dev builds only). */

package/lib/module/pairing/usePairingState.js.map

@@ -1 +1 @@
-{"version":3,"names":["React","onPairingController","peekPairingController","IDLE","status","pairingId","deviceId","previewActive","lastError","needsRescan","awaitingStartCondition","usePairingState","state","setState","useState","getState","useEffect","unsubState","bind","controller","onStateChange","existing","unsubInstall"],"sourceRoot":"../../../src","sources":["pairing/usePairingState.ts"],"mappings":";;AACA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAG9B,SAASC,mBAAmB,EAAEC,qBAAqB,QAAQ,qBAAkB;AAE7E,MAAMC,IAAwB,GAAG;EAC/BC,MAAM,EAAE,MAAM;EACdC,SAAS,EAAE,IAAI;EACfC,QAAQ,EAAE,IAAI;EACdC,aAAa,EAAE,KAAK;EACpBC,SAAS,EAAE,IAAI;EACfC,WAAW,EAAE,KAAK;EAClBC,sBAAsB,EAAE;AAC1B,CAAC;;AAED;AACA,OAAO,SAASC,eAAeA,CAAA,EAAuB;EACpD,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAGb,KAAK,CAACc,QAAQ,CACtC,MAAMZ,qBAAqB,CAAC,CAAC,EAAEa,QAAQ,CAAC,CAAC,IAAIZ,IAC/C,CAAC;EAEDH,KAAK,CAACgB,SAAS,CAAC,MAAM;IACpB,IAAIC,UAAoC;IAExC,MAAMC,IAAI,GAAIC,UAA6B,IAAK;MAC9CF,UAAU,GAAG,CAAC;MACdJ,QAAQ,CAACM,UAAU,CAACJ,QAAQ,CAAC,CAAC,CAAC;MAC/BE,UAAU,GAAGE,UAAU,CAACC,aAAa,CAACP,QAAQ,CAAC;IACjD,CAAC;IAED,MAAMQ,QAAQ,GAAGnB,qBAAqB,CAAC,CAAC;IACxC,IAAImB,QAAQ,EAAEH,IAAI,CAACG,QAAQ,CAAC;IAC5B,MAAMC,YAAY,GAAGrB,mBAAmB,CAACiB,IAAI,CAAC;IAE9C,OAAO,MAAM;MACXI,YAAY,CAAC,CAAC;MACdL,UAAU,GAAG,CAAC;IAChB,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;EAEN,OAAOL,KAAK;AACd","ignoreList":[]}
+{"version":3,"names":["React","onPairingController","peekPairingController","IDLE","status","pairingId","deviceId","previewActive","lastError","needsRescan","awaitingStartCondition","canRestartPreview","previewRestartGeneration","pairingSessionGeneration","previewStartGeneration","usePairingState","state","setState","useState","getState","useEffect","unsubState","bind","controller","onStateChange","existing","unsubInstall"],"sourceRoot":"../../../src","sources":["pairing/usePairingState.ts"],"mappings":";;AACA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAG9B,SAASC,mBAAmB,EAAEC,qBAAqB,QAAQ,qBAAkB;AAE7E,MAAMC,IAAwB,GAAG;EAC/BC,MAAM,EAAE,MAAM;EACdC,SAAS,EAAE,IAAI;EACfC,QAAQ,EAAE,IAAI;EACdC,aAAa,EAAE,KAAK;EACpBC,SAAS,EAAE,IAAI;EACfC,WAAW,EAAE,KAAK;EAClBC,sBAAsB,EAAE,KAAK;EAC7BC,iBAAiB,EAAE,KAAK;EACxBC,wBAAwB,EAAE,CAAC;EAC3BC,wBAAwB,EAAE,CAAC;EAC3BC,sBAAsB,EAAE;AAC1B,CAAC;;AAED;AACA,OAAO,SAASC,eAAeA,CAAA,EAAuB;EACpD,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAGjB,KAAK,CAACkB,QAAQ,CACtC,MAAMhB,qBAAqB,CAAC,CAAC,EAAEiB,QAAQ,CAAC,CAAC,IAAIhB,IAC/C,CAAC;EAEDH,KAAK,CAACoB,SAAS,CAAC,MAAM;IACpB,IAAIC,UAAoC;IAExC,MAAMC,IAAI,GAAIC,UAA6B,IAAK;MAC9CF,UAAU,GAAG,CAAC;MACdJ,QAAQ,CAACM,UAAU,CAACJ,QAAQ,CAAC,CAAC,CAAC;MAC/BE,UAAU,GAAGE,UAAU,CAACC,aAAa,CAACP,QAAQ,CAAC;IACjD,CAAC;IAED,MAAMQ,QAAQ,GAAGvB,qBAAqB,CAAC,CAAC;IACxC,IAAIuB,QAAQ,EAAEH,IAAI,CAACG,QAAQ,CAAC;IAC5B,MAAMC,YAAY,GAAGzB,mBAAmB,CAACqB,IAAI,CAAC;IAE9C,OAAO,MAAM;MACXI,YAAY,CAAC,CAAC;MACdL,UAAU,GAAG,CAAC;IAChB,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;EAEN,OAAOL,KAAK;AACd","ignoreList":[]}

package/lib/module/pairing/usePreviewBarHold.js

@@ -0,0 +1,134 @@
+"use strict";
+
+import * as React from 'react';
+import { resolvePreviewChrome } from "./resolvePreviewChrome.js";
+
+/**
+ * How long a new pairing session with no `purpose` on its link keeps the
+ * default preview bar hidden, so a `selectElement` that arrives after the join
+ * never flashes "Preview mode". Restarts once when the socket first reaches
+ * `connected` while the hold is still up: a slow connect still shows
+ * "Connecting…" after this delay, and a pick that starts shortly after the
+ * join stays inside the window.
+ */
+export const INITIAL_REVEAL_DELAY_MS = 2000;
+/**
+ * A new session (or chrome appearing) is decided by the link's purpose:
+ * `select_element` starts in the selection hold, `preview` is never held, and
+ * no purpose falls back to the intro hold. The intro hold hides the bar when
+ * preview chrome appears, and again when the session changes while a hold is
+ * already hiding it. A bar that is already showing stays up across a re-scan
+ * with no purpose. Selection hold replaces the intro once the picker is active
+ * and outlives the picker until a Builder preview, a `preview` re-scan, or a
+ * re-scan with no purpose. A `select_element` re-scan starts held, including
+ * when the bar is already up.
+ */
+function decideHold(prev, holds, input) {
+  let introHeld = holds.introHeld;
+  let selectionHeld = holds.selectionHeld;
+  let connectRestarted = prev.connectRestarted;
+  let restartTimer = false;
+  const armIntro = () => {
+    introHeld = true;
+    connectRestarted = false;
+    restartTimer = true;
+  };
+  if (!input.chromeVisible) {
+    return {
+      introHeld: false,
+      selectionHeld: false,
+      restartTimer: false,
+      inputs: {
+        ...input,
+        connectRestarted: false
+      }
+    };
+  }
+  const sessionChanged = input.session !== prev.session;
+  const previewStarted = input.previewStart > prev.previewStart;
+  if (previewStarted) {
+    introHeld = false;
+    selectionHeld = false;
+    connectRestarted = true;
+  } else if (input.pickerActive) {
+    selectionHeld = true;
+    introHeld = false;
+  } else if (sessionChanged || !prev.chromeVisible) {
+    if (input.purpose === 'select_element') {
+      selectionHeld = true;
+      introHeld = false;
+    } else if (input.purpose === 'preview') {
+      selectionHeld = false;
+      introHeld = false;
+    } else if (introHeld || selectionHeld || !prev.chromeVisible) {
+      selectionHeld = false;
+      armIntro();
+    }
+  }
+  if (introHeld && input.status === 'connected' && !connectRestarted) {
+    connectRestarted = true;
+    restartTimer = true;
+  }
+  return {
+    introHeld,
+    selectionHeld,
+    restartTimer,
+    inputs: {
+      ...input,
+      connectRestarted
+    }
+  };
+}
+
+/**
+ * Whether the preview top bar should stay down.
+ *
+ * The decision is applied during render. Waiting for an effect would mount
+ * the bar for a frame and play its slide-in before the hold could hide it.
+ * The reveal timer stays in an effect.
+ */
+export function usePreviewBarHold(state, pickerActive) {
+  const chromeVisible = resolvePreviewChrome(state).visible;
+  const [introHeld, setIntroHeld] = React.useState(false);
+  const [selectionHeld, setSelectionHeld] = React.useState(false);
+  const [introEpoch, setIntroEpoch] = React.useState(0);
+  const purpose = state.pairingPurpose ?? null;
+  const inputsRef = React.useRef({
+    session: state.pairingSessionGeneration,
+    previewStart: state.previewStartGeneration,
+    chromeVisible: false,
+    pickerActive: false,
+    status: state.status,
+    purpose,
+    connectRestarted: false
+  });
+  const decision = decideHold(inputsRef.current, {
+    introHeld,
+    selectionHeld
+  }, {
+    session: state.pairingSessionGeneration,
+    previewStart: state.previewStartGeneration,
+    chromeVisible,
+    pickerActive,
+    status: state.status,
+    purpose,
+    connectRestarted: false
+  });
+  inputsRef.current = decision.inputs;
+  if (decision.introHeld !== introHeld) {
+    setIntroHeld(decision.introHeld);
+  }
+  if (decision.selectionHeld !== selectionHeld) {
+    setSelectionHeld(decision.selectionHeld);
+  }
+  if (decision.restartTimer) {
+    setIntroEpoch(epoch => epoch + 1);
+  }
+  React.useEffect(() => {
+    if (!introHeld) return;
+    const timer = setTimeout(() => setIntroHeld(false), INITIAL_REVEAL_DELAY_MS);
+    return () => clearTimeout(timer);
+  }, [introEpoch, introHeld]);
+  return decision.introHeld || decision.selectionHeld;
+}
+//# sourceMappingURL=usePreviewBarHold.js.map

package/lib/module/pairing/usePreviewBarHold.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","resolvePreviewChrome","INITIAL_REVEAL_DELAY_MS","decideHold","prev","holds","input","introHeld","selectionHeld","connectRestarted","restartTimer","armIntro","chromeVisible","inputs","sessionChanged","session","previewStarted","previewStart","pickerActive","purpose","status","usePreviewBarHold","state","visible","setIntroHeld","useState","setSelectionHeld","introEpoch","setIntroEpoch","pairingPurpose","inputsRef","useRef","pairingSessionGeneration","previewStartGeneration","decision","current","epoch","useEffect","timer","setTimeout","clearTimeout"],"sourceRoot":"../../../src","sources":["pairing/usePreviewBarHold.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/runtime/BannerHost.js

@@ -0,0 +1,92 @@
+"use strict";
+
+import * as React from 'react';
+import { StyleSheet, View } from 'react-native';
+import { BannerSurface } from "../surfaces/BannerSurface.js";
+import { bannerOverlayHostPadding } from "../surfaces/bannerBarLayout.js";
+import { resolveBannerBackgroundColor } from "../surfaces/resolveBannerTheme.js";
+import { useUserflowSafeAreaInsets } from "../surfaces/safeArea.js";
+import { SdkErrorBoundary } from "./SdkErrorBoundary.js";
+import { bannerEdge, embedBannerPlaceholderId, warnBannerOnce } from "./bannerPlacement.js";
+import { hasEmbedBannerPlaceholder } from "./embedBannerRegistry.js";
+import { useBannerSession } from "./useBannerSession.js";
+
+/**
+ * Top or bottom banner bar. Element modes render in {@link EmbedBannerPlaceholder}.
+ *
+ * `overlay` floats over the host. `flow` sits in layout and pushes the app.
+ * The bar does not participate in the host accessibility trap.
+ */
+import { jsx as _jsx } from "react/jsx-runtime";
+export function BannerHost({
+  engine,
+  hidden,
+  placement = 'overlay',
+  edge: edgeFilter
+}) {
+  const session = useBannerSession(engine);
+  const banner = session?.version.banner ?? null;
+  const edge = banner ? bannerEdge(banner.embedMode) : null;
+  const insets = useUserflowSafeAreaInsets();
+  React.useEffect(() => {
+    if (!session || !banner || edge) return;
+    const placeholderId = embedBannerPlaceholderId(banner);
+    if (placeholderId && hasEmbedBannerPlaceholder(placeholderId)) return;
+    const message = placeholderId ? `Userflow: no EmbedBannerPlaceholder with id "${placeholderId}" is mounted; the banner is not shown` : `Userflow: banner embed mode ${banner.embedMode} needs a manual embed selector and an EmbedBannerPlaceholder with that id`;
+    warnBannerOnce(`embed:${session.id}:${banner.embedMode}:${placeholderId ?? 'none'}`, message);
+  }, [banner, edge, session]);
+  if (hidden || !session || !banner || !edge) return null;
+  if (edgeFilter && edge !== edgeFilter) return null;
+  const floats = banner.overlay !== false;
+  if (placement === 'overlay' !== floats) return null;
+  const bar = /*#__PURE__*/_jsx(SdkErrorBoundary, {
+    scope: "banner",
+    resetKey: session.id,
+    children: /*#__PURE__*/_jsx(BannerSurface, {
+      session: session,
+      onActions: actions => engine.handleActions(actions),
+      onDismiss: endReason => {
+        void engine.endBanner(endReason);
+      }
+    })
+  });
+  if (placement === 'flow') {
+    const backgroundColor = bannerBackground(session);
+    const safePad = edge === 'top' ? {
+      paddingTop: insets.top
+    } : {
+      paddingBottom: insets.bottom
+    };
+    return /*#__PURE__*/_jsx(View, {
+      testID: "userflow-banner-flow",
+      style: [styles.flow, safePad, {
+        backgroundColor
+      }],
+      children: bar
+    });
+  }
+  const edgeStyle = edge === 'top' ? {
+    top: insets.top
+  } : {
+    bottom: insets.bottom
+  };
+  return /*#__PURE__*/_jsx(View, {
+    pointerEvents: "box-none",
+    style: [styles.pin, edgeStyle, bannerOverlayHostPadding(insets)],
+    children: bar
+  });
+}
+function bannerBackground(session) {
+  return resolveBannerBackgroundColor(session.version.theme);
+}
+const styles = StyleSheet.create({
+  pin: {
+    position: 'absolute',
+    left: 0,
+    right: 0
+  },
+  flow: {
+    alignSelf: 'stretch'
+  }
+});
+//# sourceMappingURL=BannerHost.js.map

package/lib/module/runtime/BannerHost.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","StyleSheet","View","BannerSurface","bannerOverlayHostPadding","resolveBannerBackgroundColor","useUserflowSafeAreaInsets","SdkErrorBoundary","bannerEdge","embedBannerPlaceholderId","warnBannerOnce","hasEmbedBannerPlaceholder","useBannerSession","jsx","_jsx","BannerHost","engine","hidden","placement","edge","edgeFilter","session","banner","version","embedMode","insets","useEffect","placeholderId","message","id","floats","overlay","bar","scope","resetKey","children","onActions","actions","handleActions","onDismiss","endReason","endBanner","backgroundColor","bannerBackground","safePad","paddingTop","top","paddingBottom","bottom","testID","style","styles","flow","edgeStyle","pointerEvents","pin","theme","create","position","left","right","alignSelf"],"sourceRoot":"../../../src","sources":["runtime/BannerHost.tsx"],"mappings":";;AAEA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAC9B,SAASC,UAAU,EAAEC,IAAI,QAAQ,cAAc;AAE/C,SAASC,aAAa,QAAQ,8BAA2B;AACzD,SAASC,wBAAwB,QAAQ,gCAA6B;AACtE,SAASC,4BAA4B,QAAQ,mCAAgC;AAC7E,SAASC,yBAAyB,QAAQ,yBAAsB;AAEhE,SAASC,gBAAgB,QAAQ,uBAAoB;AACrD,SAASC,UAAU,EAAEC,wBAAwB,EAAEC,cAAc,QAAQ,sBAAmB;AACxF,SAASC,yBAAyB,QAAQ,0BAAuB;AACjE,SAASC,gBAAgB,QAAQ,uBAAoB;;AAErD;AACA;AACA;AACA;AACA;AACA;AALA,SAAAC,GAAA,IAAAC,IAAA;AAMA,OAAO,SAASC,UAAUA,CAAC;EACzBC,MAAM;EACNC,MAAM;EACNC,SAAS,GAAG,SAAS;EACrBC,IAAI,EAAEC;AAOR,CAAC,EAA6B;EAC5B,MAAMC,OAAO,GAAGT,gBAAgB,CAACI,MAAM,CAAC;EACxC,MAAMM,MAAM,GAAGD,OAAO,EAAEE,OAAO,CAACD,MAAM,IAAI,IAAI;EAC9C,MAAMH,IAAI,GAAGG,MAAM,GAAGd,UAAU,CAACc,MAAM,CAACE,SAAS,CAAC,GAAG,IAAI;EACzD,MAAMC,MAAM,GAAGnB,yBAAyB,CAAC,CAAC;EAE1CN,KAAK,CAAC0B,SAAS,CAAC,MAAM;IACpB,IAAI,CAACL,OAAO,IAAI,CAACC,MAAM,IAAIH,IAAI,EAAE;IACjC,MAAMQ,aAAa,GAAGlB,wBAAwB,CAACa,MAAM,CAAC;IACtD,IAAIK,aAAa,IAAIhB,yBAAyB,CAACgB,aAAa,CAAC,EAAE;IAC/D,MAAMC,OAAO,GAAGD,aAAa,GACzB,gDAAgDA,aAAa,uCAAuC,GACpG,+BAA+BL,MAAM,CAACE,SAAS,2EAA2E;IAC9Hd,cAAc,CAAC,SAASW,OAAO,CAACQ,EAAE,IAAIP,MAAM,CAACE,SAAS,IAAIG,aAAa,IAAI,MAAM,EAAE,EAAEC,OAAO,CAAC;EAC/F,CAAC,EAAE,CAACN,MAAM,EAAEH,IAAI,EAAEE,OAAO,CAAC,CAAC;EAE3B,IAAIJ,MAAM,IAAI,CAACI,OAAO,IAAI,CAACC,MAAM,IAAI,CAACH,IAAI,EAAE,OAAO,IAAI;EACvD,IAAIC,UAAU,IAAID,IAAI,KAAKC,UAAU,EAAE,OAAO,IAAI;EAElD,MAAMU,MAAM,GAAGR,MAAM,CAACS,OAAO,KAAK,KAAK;EACvC,IAAKb,SAAS,KAAK,SAAS,KAAMY,MAAM,EAAE,OAAO,IAAI;EAErD,MAAME,GAAG,gBACPlB,IAAA,CAACP,gBAAgB;IAAC0B,KAAK,EAAC,QAAQ;IAACC,QAAQ,EAAEb,OAAO,CAACQ,EAAG;IAAAM,QAAA,eACpDrB,IAAA,CAACX,aAAa;MACZkB,OAAO,EAAEA,OAAQ;MACjBe,SAAS,EAAGC,OAAO,IAAKrB,MAAM,CAACsB,aAAa,CAACD,OAAO,CAAE;MACtDE,SAAS,EAAGC,SAAS,IAAK;QACxB,KAAKxB,MAAM,CAACyB,SAAS,CAACD,SAAS,CAAC;MAClC;IAAE,CACH;EAAC,CACc,CACnB;EAED,IAAItB,SAAS,KAAK,MAAM,EAAE;IACxB,MAAMwB,eAAe,GAAGC,gBAAgB,CAACtB,OAAO,CAAC;IACjD,MAAMuB,OAAO,GAAGzB,IAAI,KAAK,KAAK,GAAG;MAAE0B,UAAU,EAAEpB,MAAM,CAACqB;IAAI,CAAC,GAAG;MAAEC,aAAa,EAAEtB,MAAM,CAACuB;IAAO,CAAC;IAC9F,oBACElC,IAAA,CAACZ,IAAI;MAAC+C,MAAM,EAAC,sBAAsB;MAACC,KAAK,EAAE,CAACC,MAAM,CAACC,IAAI,EAAER,OAAO,EAAE;QAAEF;MAAgB,CAAC,CAAE;MAAAP,QAAA,EACpFH;IAAG,CACA,CAAC;EAEX;EAEA,MAAMqB,SAAS,GAAGlC,IAAI,KAAK,KAAK,GAAG;IAAE2B,GAAG,EAAErB,MAAM,CAACqB;EAAI,CAAC,GAAG;IAAEE,MAAM,EAAEvB,MAAM,CAACuB;EAAO,CAAC;EAElF,oBACElC,IAAA,CAACZ,IAAI;IACHoD,aAAa,EAAC,UAAU;IACxBJ,KAAK,EAAE,CAACC,MAAM,CAACI,GAAG,EAAEF,SAAS,EAAEjD,wBAAwB,CAACqB,MAAM,CAAC,CAAE;IAAAU,QAAA,EAEhEH;EAAG,CACA,CAAC;AAEX;AAEA,SAASW,gBAAgBA,CAACtB,OAA8B,EAAU;EAChE,OAAOhB,4BAA4B,CAACgB,OAAO,CAACE,OAAO,CAACiC,KAAK,CAAC;AAC5D;AAEA,MAAML,MAAM,GAAGlD,UAAU,CAACwD,MAAM,CAAC;EAC/BF,GAAG,EAAE;IACHG,QAAQ,EAAE,UAAU;IACpBC,IAAI,EAAE,CAAC;IACPC,KAAK,EAAE;EACT,CAAC;EACDR,IAAI,EAAE;IACJS,SAAS,EAAE;EACb;AACF,CAAC,CAAC","ignoreList":[]}

package/lib/module/runtime/EmbedBannerPlaceholder.js

@@ -0,0 +1,94 @@
+"use strict";
+
+import * as React from 'react';
+import { StyleSheet, View } from 'react-native';
+import { elementPickerController } from "../authoring/elementPickerController.js";
+import { BannerSurface } from "../surfaces/BannerSurface.js";
+import { bannerOverlayHostPadding } from "../surfaces/bannerBarLayout.js";
+import { useUserflowSafeAreaInsets } from "../surfaces/safeArea.js";
+import { SdkErrorBoundary } from "./SdkErrorBoundary.js";
+import { BannerEngineContext } from "./bannerEngineContext.js";
+import { embedBannerPlaceholderId, warnBannerOnce } from "./bannerPlacement.js";
+import { registerEmbedBannerPlaceholder } from "./embedBannerRegistry.js";
+import { useBannerSession } from "./useBannerSession.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Host slot for an element-mode banner (`ELEMENT_BEFORE`, `ELEMENT_AFTER`,
+ * `ELEMENT_FIRST`, `ELEMENT_LAST`). Mount it where the bar should appear.
+ * Until a matching banner is active the slot renders nothing, so it takes no
+ * space and is not visible. Top and bottom bars ignore this slot.
+ * `overlay: false` keeps the bar in layout; `overlay: true` paints it over
+ * the content below the slot.
+ */
+export function EmbedBannerPlaceholder({
+  id
+}) {
+  const engine = React.useContext(BannerEngineContext);
+  const placeholderId = id.trim();
+  const session = useBannerSession(engine);
+  const insets = useUserflowSafeAreaInsets();
+  const [pickerActive, setPickerActive] = React.useState(() => elementPickerController.getState().active);
+  React.useEffect(() => {
+    return elementPickerController.subscribe(next => {
+      setPickerActive(next.active);
+    });
+  }, []);
+  React.useLayoutEffect(() => {
+    if (!placeholderId) {
+      warnBannerOnce('embed-banner-empty-id', 'Userflow: EmbedBannerPlaceholder requires an id');
+      return;
+    }
+    return registerEmbedBannerPlaceholder(placeholderId);
+  }, [placeholderId]);
+  React.useEffect(() => {
+    if (engine) return;
+    warnBannerOnce('embed-banner-outside-provider', 'Userflow: EmbedBannerPlaceholder must be rendered inside UserflowProvider');
+  }, [engine]);
+
+  // No host view until a banner is actually shown. An empty slot would still
+  // participate in flex gap and stretch layout.
+  if (!engine || !placeholderId || pickerActive || !session) return null;
+  const banner = session.version.banner ?? null;
+  if (!banner || embedBannerPlaceholderId(banner) !== placeholderId) return null;
+  const bar = /*#__PURE__*/_jsx(BannerSurface, {
+    session: session,
+    onActions: actions => engine.handleActions(actions),
+    onDismiss: endReason => {
+      void engine.endBanner(endReason);
+    }
+  });
+  return /*#__PURE__*/_jsx(SdkErrorBoundary, {
+    scope: "banner",
+    resetKey: session.id,
+    children: banner.overlay !== false ? /*#__PURE__*/_jsx(View, {
+      pointerEvents: "box-none",
+      testID: "userflow-embed-banner",
+      style: styles.overlaySlot,
+      children: /*#__PURE__*/_jsx(View, {
+        pointerEvents: "box-none",
+        style: [styles.overlayBar, bannerOverlayHostPadding(insets)],
+        children: bar
+      })
+    }) : /*#__PURE__*/_jsx(View, {
+      testID: "userflow-embed-banner",
+      style: styles.slot,
+      children: bar
+    })
+  });
+}
+const styles = StyleSheet.create({
+  slot: {
+    alignSelf: 'stretch'
+  },
+  overlaySlot: {
+    height: 0,
+    alignSelf: 'stretch'
+  },
+  overlayBar: {
+    position: 'absolute',
+    left: 0,
+    right: 0,
+    top: 0
+  }
+});
+//# sourceMappingURL=EmbedBannerPlaceholder.js.map