@userflow-tech/react-native 0.1.1 → 0.3.0

package/lib/commonjs/pairing/elementPickerRelay.js

@@ -0,0 +1,91 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.bindElementPickerRelay = bindElementPickerRelay;
+var _core = require("@userflow-tech/core");
+var _elementPickerController = require("../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.
+ */
+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 _core.isPairingPushAckTimeout === 'function' && (0, _core.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.elementPickerController.beginSelection({
+        requestId: key,
+        onResult: result => sendResult(key, result),
+        onCancel: () => {
+          if (ignoreNextCancelSend) return;
+          sendCancel(key);
+        }
+      });
+      return;
+    }
+    if (event === 'selectElementCancel') {
+      ignoreNextCancelSend = true;
+      _elementPickerController.elementPickerController.cancel();
+      ignoreNextCancelSend = false;
+    }
+  });
+  return () => {
+    unsub();
+    ignoreNextCancelSend = true;
+    _elementPickerController.elementPickerController.cancel();
+    ignoreNextCancelSend = false;
+  };
+}
+//# sourceMappingURL=elementPickerRelay.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_core","require","_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","isPairingPushAckTimeout","sendCancel","catch","unsub","event","elementPickerController","beginSelection","requestId","onResult","onCancel","cancel"],"sourceRoot":"../../../src","sources":["pairing/elementPickerRelay.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/pairing/resolvePreviewChrome.js

@@ -0,0 +1,52 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.resolvePreviewChrome = resolvePreviewChrome;
+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.
+ */
+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/commonjs/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;AACO,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/commonjs/pairing/tokenStorage.js

@@ -3,27 +3,51 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+exports.PAIRING_TOKEN_STORAGE_KEY = exports.PAIRING_PURPOSE_STORAGE_KEY = void 0;
 exports.createMemoryPairingTokenStore = createMemoryPairingTokenStore;
 exports.createPairingTokenStore = createPairingTokenStore;
+exports.resetPairingTokenStoreCacheForTests = resetPairingTokenStoreCacheForTests;
+var _deepLink = require("./deepLink.js");
 /**
- * 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';
+// SecureStore rejects keys outside [A-Za-z0-9._-], so no `userflow:` prefix here.
+const PAIRING_TOKEN_STORAGE_KEY = exports.PAIRING_TOKEN_STORAGE_KEY = 'userflow.pairingToken';
+const PAIRING_PURPOSE_STORAGE_KEY = exports.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). */
 function createMemoryPairingTokenStore() {
   let value = null;
+  let purposeValue = null;
   return {
     async get() {
       return value;
@@ -33,6 +57,13 @@ function createMemoryPairingTokenStore() {
     },
     async clear() {
       value = null;
+      purposeValue = null;
+    },
+    async getPurpose() {
+      return purposeValue;
+    },
+    async setPurpose(purpose) {
+      purposeValue = purpose;
     }
   };
 }
@@ -46,25 +77,57 @@ 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 (0, _deepLink.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. */
+function resetPairingTokenStoreCacheForTests() {
+  cachedSecureStore = undefined;
+}
 //# sourceMappingURL=tokenStorage.js.map

package/lib/commonjs/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;AACO,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;AACO,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":["_deepLink","require","PAIRING_TOKEN_STORAGE_KEY","exports","PAIRING_PURPOSE_STORAGE_KEY","cachedSecureStore","isExpoModulesRuntimeAvailable","expo","globalThis","EventEmitter","tryLoadExpoSecureStore","undefined","__DEV__","console","warn","createMemoryPairingTokenStore","value","purposeValue","get","set","token","clear","getPurpose","setPurpose","purpose","createPairingTokenStore","secure","getItemAsync","setItemAsync","error","Error","message","String","deleteItemAsync","parsePairingPurpose","resetPairingTokenStoreCacheForTests"],"sourceRoot":"../../../src","sources":["pairing/tokenStorage.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/pairing/usePairingState.js

@@ -14,7 +14,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/commonjs/pairing/usePairingState.js.map

@@ -1 +1 @@
-{"version":3,"names":["React","_interopRequireWildcard","require","_pairingRuntime","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","IDLE","status","pairingId","deviceId","previewActive","lastError","needsRescan","awaitingStartCondition","usePairingState","state","setState","useState","peekPairingController","getState","useEffect","unsubState","bind","controller","onStateChange","existing","unsubInstall","onPairingController"],"sourceRoot":"../../../src","sources":["pairing/usePairingState.ts"],"mappings":";;;;;;AACA,IAAAA,KAAA,GAAAC,uBAAA,CAAAC,OAAA;AAGA,IAAAC,eAAA,GAAAD,OAAA;AAA8E,SAAAD,wBAAAG,CAAA,EAAAC,CAAA,6BAAAC,OAAA,MAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAL,uBAAA,YAAAA,CAAAG,CAAA,EAAAC,CAAA,SAAAA,CAAA,IAAAD,CAAA,IAAAA,CAAA,CAAAK,UAAA,SAAAL,CAAA,MAAAM,CAAA,EAAAC,CAAA,EAAAC,CAAA,KAAAC,SAAA,QAAAC,OAAA,EAAAV,CAAA,iBAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,SAAAQ,CAAA,MAAAF,CAAA,GAAAL,CAAA,GAAAG,CAAA,GAAAD,CAAA,QAAAG,CAAA,CAAAK,GAAA,CAAAX,CAAA,UAAAM,CAAA,CAAAM,GAAA,CAAAZ,CAAA,GAAAM,CAAA,CAAAO,GAAA,CAAAb,CAAA,EAAAQ,CAAA,gBAAAP,CAAA,IAAAD,CAAA,gBAAAC,CAAA,OAAAa,cAAA,CAAAC,IAAA,CAAAf,CAAA,EAAAC,CAAA,OAAAM,CAAA,IAAAD,CAAA,GAAAU,MAAA,CAAAC,cAAA,KAAAD,MAAA,CAAAE,wBAAA,CAAAlB,CAAA,EAAAC,CAAA,OAAAM,CAAA,CAAAK,GAAA,IAAAL,CAAA,CAAAM,GAAA,IAAAP,CAAA,CAAAE,CAAA,EAAAP,CAAA,EAAAM,CAAA,IAAAC,CAAA,CAAAP,CAAA,IAAAD,CAAA,CAAAC,CAAA,WAAAO,CAAA,KAAAR,CAAA,EAAAC,CAAA;AAE9E,MAAMkB,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;AACO,SAASC,eAAeA,CAAA,EAAuB;EACpD,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAGjC,KAAK,CAACkC,QAAQ,CACtC,MAAM,IAAAC,qCAAqB,EAAC,CAAC,EAAEC,QAAQ,CAAC,CAAC,IAAIb,IAC/C,CAAC;EAEDvB,KAAK,CAACqC,SAAS,CAAC,MAAM;IACpB,IAAIC,UAAoC;IAExC,MAAMC,IAAI,GAAIC,UAA6B,IAAK;MAC9CF,UAAU,GAAG,CAAC;MACdL,QAAQ,CAACO,UAAU,CAACJ,QAAQ,CAAC,CAAC,CAAC;MAC/BE,UAAU,GAAGE,UAAU,CAACC,aAAa,CAACR,QAAQ,CAAC;IACjD,CAAC;IAED,MAAMS,QAAQ,GAAG,IAAAP,qCAAqB,EAAC,CAAC;IACxC,IAAIO,QAAQ,EAAEH,IAAI,CAACG,QAAQ,CAAC;IAC5B,MAAMC,YAAY,GAAG,IAAAC,mCAAmB,EAACL,IAAI,CAAC;IAE9C,OAAO,MAAM;MACXI,YAAY,CAAC,CAAC;MACdL,UAAU,GAAG,CAAC;IAChB,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;EAEN,OAAON,KAAK;AACd","ignoreList":[]}
+{"version":3,"names":["React","_interopRequireWildcard","require","_pairingRuntime","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","IDLE","status","pairingId","deviceId","previewActive","lastError","needsRescan","awaitingStartCondition","canRestartPreview","previewRestartGeneration","pairingSessionGeneration","previewStartGeneration","usePairingState","state","setState","useState","peekPairingController","getState","useEffect","unsubState","bind","controller","onStateChange","existing","unsubInstall","onPairingController"],"sourceRoot":"../../../src","sources":["pairing/usePairingState.ts"],"mappings":";;;;;;AACA,IAAAA,KAAA,GAAAC,uBAAA,CAAAC,OAAA;AAGA,IAAAC,eAAA,GAAAD,OAAA;AAA8E,SAAAD,wBAAAG,CAAA,EAAAC,CAAA,6BAAAC,OAAA,MAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAL,uBAAA,YAAAA,CAAAG,CAAA,EAAAC,CAAA,SAAAA,CAAA,IAAAD,CAAA,IAAAA,CAAA,CAAAK,UAAA,SAAAL,CAAA,MAAAM,CAAA,EAAAC,CAAA,EAAAC,CAAA,KAAAC,SAAA,QAAAC,OAAA,EAAAV,CAAA,iBAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,SAAAQ,CAAA,MAAAF,CAAA,GAAAL,CAAA,GAAAG,CAAA,GAAAD,CAAA,QAAAG,CAAA,CAAAK,GAAA,CAAAX,CAAA,UAAAM,CAAA,CAAAM,GAAA,CAAAZ,CAAA,GAAAM,CAAA,CAAAO,GAAA,CAAAb,CAAA,EAAAQ,CAAA,gBAAAP,CAAA,IAAAD,CAAA,gBAAAC,CAAA,OAAAa,cAAA,CAAAC,IAAA,CAAAf,CAAA,EAAAC,CAAA,OAAAM,CAAA,IAAAD,CAAA,GAAAU,MAAA,CAAAC,cAAA,KAAAD,MAAA,CAAAE,wBAAA,CAAAlB,CAAA,EAAAC,CAAA,OAAAM,CAAA,CAAAK,GAAA,IAAAL,CAAA,CAAAM,GAAA,IAAAP,CAAA,CAAAE,CAAA,EAAAP,CAAA,EAAAM,CAAA,IAAAC,CAAA,CAAAP,CAAA,IAAAD,CAAA,CAAAC,CAAA,WAAAO,CAAA,KAAAR,CAAA,EAAAC,CAAA;AAE9E,MAAMkB,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;AACO,SAASC,eAAeA,CAAA,EAAuB;EACpD,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAGrC,KAAK,CAACsC,QAAQ,CACtC,MAAM,IAAAC,qCAAqB,EAAC,CAAC,EAAEC,QAAQ,CAAC,CAAC,IAAIjB,IAC/C,CAAC;EAEDvB,KAAK,CAACyC,SAAS,CAAC,MAAM;IACpB,IAAIC,UAAoC;IAExC,MAAMC,IAAI,GAAIC,UAA6B,IAAK;MAC9CF,UAAU,GAAG,CAAC;MACdL,QAAQ,CAACO,UAAU,CAACJ,QAAQ,CAAC,CAAC,CAAC;MAC/BE,UAAU,GAAGE,UAAU,CAACC,aAAa,CAACR,QAAQ,CAAC;IACjD,CAAC;IAED,MAAMS,QAAQ,GAAG,IAAAP,qCAAqB,EAAC,CAAC;IACxC,IAAIO,QAAQ,EAAEH,IAAI,CAACG,QAAQ,CAAC;IAC5B,MAAMC,YAAY,GAAG,IAAAC,mCAAmB,EAACL,IAAI,CAAC;IAE9C,OAAO,MAAM;MACXI,YAAY,CAAC,CAAC;MACdL,UAAU,GAAG,CAAC;IAChB,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;EAEN,OAAON,KAAK;AACd","ignoreList":[]}

package/lib/commonjs/pairing/usePreviewBarHold.js

@@ -0,0 +1,139 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.INITIAL_REVEAL_DELAY_MS = void 0;
+exports.usePreviewBarHold = usePreviewBarHold;
+var React = _interopRequireWildcard(require("react"));
+var _resolvePreviewChrome = require("./resolvePreviewChrome.js");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * 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.
+ */
+const INITIAL_REVEAL_DELAY_MS = exports.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.
+ */
+function usePreviewBarHold(state, pickerActive) {
+  const chromeVisible = (0, _resolvePreviewChrome.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/commonjs/pairing/usePreviewBarHold.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","_interopRequireWildcard","require","_resolvePreviewChrome","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","INITIAL_REVEAL_DELAY_MS","exports","decideHold","prev","holds","input","introHeld","selectionHeld","connectRestarted","restartTimer","armIntro","chromeVisible","inputs","sessionChanged","session","previewStarted","previewStart","pickerActive","purpose","status","usePreviewBarHold","state","resolvePreviewChrome","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/commonjs/runtime/BannerHost.js

@@ -0,0 +1,96 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.BannerHost = BannerHost;
+var React = _interopRequireWildcard(require("react"));
+var _reactNative = require("react-native");
+var _BannerSurface = require("../surfaces/BannerSurface.js");
+var _bannerBarLayout = require("../surfaces/bannerBarLayout.js");
+var _resolveBannerTheme = require("../surfaces/resolveBannerTheme.js");
+var _safeArea = require("../surfaces/safeArea.js");
+var _SdkErrorBoundary = require("./SdkErrorBoundary.js");
+var _bannerPlacement = require("./bannerPlacement.js");
+var _embedBannerRegistry = require("./embedBannerRegistry.js");
+var _useBannerSession = require("./useBannerSession.js");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * 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.
+ */
+function BannerHost({
+  engine,
+  hidden,
+  placement = 'overlay',
+  edge: edgeFilter
+}) {
+  const session = (0, _useBannerSession.useBannerSession)(engine);
+  const banner = session?.version.banner ?? null;
+  const edge = banner ? (0, _bannerPlacement.bannerEdge)(banner.embedMode) : null;
+  const insets = (0, _safeArea.useUserflowSafeAreaInsets)();
+  React.useEffect(() => {
+    if (!session || !banner || edge) return;
+    const placeholderId = (0, _bannerPlacement.embedBannerPlaceholderId)(banner);
+    if (placeholderId && (0, _embedBannerRegistry.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`;
+    (0, _bannerPlacement.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__*/(0, _jsxRuntime.jsx)(_SdkErrorBoundary.SdkErrorBoundary, {
+    scope: "banner",
+    resetKey: session.id,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_BannerSurface.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__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+      testID: "userflow-banner-flow",
+      style: [styles.flow, safePad, {
+        backgroundColor
+      }],
+      children: bar
+    });
+  }
+  const edgeStyle = edge === 'top' ? {
+    top: insets.top
+  } : {
+    bottom: insets.bottom
+  };
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+    pointerEvents: "box-none",
+    style: [styles.pin, edgeStyle, (0, _bannerBarLayout.bannerOverlayHostPadding)(insets)],
+    children: bar
+  });
+}
+function bannerBackground(session) {
+  return (0, _resolveBannerTheme.resolveBannerBackgroundColor)(session.version.theme);
+}
+const styles = _reactNative.StyleSheet.create({
+  pin: {
+    position: 'absolute',
+    left: 0,
+    right: 0
+  },
+  flow: {
+    alignSelf: 'stretch'
+  }
+});
+//# sourceMappingURL=BannerHost.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["React","_interopRequireWildcard","require","_reactNative","_BannerSurface","_bannerBarLayout","_resolveBannerTheme","_safeArea","_SdkErrorBoundary","_bannerPlacement","_embedBannerRegistry","_useBannerSession","_jsxRuntime","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","BannerHost","engine","hidden","placement","edge","edgeFilter","session","useBannerSession","banner","version","bannerEdge","embedMode","insets","useUserflowSafeAreaInsets","useEffect","placeholderId","embedBannerPlaceholderId","hasEmbedBannerPlaceholder","message","warnBannerOnce","id","floats","overlay","bar","jsx","SdkErrorBoundary","scope","resetKey","children","BannerSurface","onActions","actions","handleActions","onDismiss","endReason","endBanner","backgroundColor","bannerBackground","safePad","paddingTop","top","paddingBottom","bottom","View","testID","style","styles","flow","edgeStyle","pointerEvents","pin","bannerOverlayHostPadding","resolveBannerBackgroundColor","theme","StyleSheet","create","position","left","right","alignSelf"],"sourceRoot":"../../../src","sources":["runtime/BannerHost.tsx"],"mappings":"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","ignoreList":[]}