@userflow-tech/react-native 0.2.0 → 0.3.0

package/lib/module/pairing/deepLink.js

@@ -2,14 +2,26 @@
 
 /**
  * Parse Builder pairing deep links:
- *   {scheme_id}://?pairing_token=<jwt>
+ *   {scheme_id}://?pairing_token=<jwt>[&purpose=preview|select_element]
  *
- * `scheme_id` is typically `userflow-<digits>`.
+ * `scheme_id` is `userflow-` followed by an opaque, backend-generated id.
  */
 
+const PAIRING_PURPOSES = ['preview', 'select_element'];
+export function parsePairingPurpose(value) {
+  return PAIRING_PURPOSES.find(purpose => purpose === value) ?? null;
+}
+
 /** Scheme prefix shared by preview and pairing links. */
 const USERFLOW_SCHEME_PREFIX = 'userflow-';
-const USERFLOW_SCHEME = /^userflow-\d+$/i;
+/**
+ * Environment scheme_id shape — must match Expo plugin registration
+ * (`packages/expo/plugin/withUserflow.ts`). Everything after `userflow-` is an
+ * opaque id owned by the backend (today 26 base32 chars), so only check that it
+ * is one or more alphanumeric segments joined by single hyphens. Digit-only ids
+ * used in local configs also pass.
+ */
+const USERFLOW_SCHEME = /^userflow-[a-z0-9]+(?:-[a-z0-9]+)*$/i;
 
 /**
  * Why a URL was not treated as a pairing link.
@@ -100,7 +112,7 @@ export function inspectPairingDeepLink(url) {
   };
 
   // Only once the URL is known to target pairing does the scheme shape matter.
-  // Checking it earlier would misreport preview links on non-numeric schemes.
+  // Checking it earlier would misreport preview links on malformed schemes.
   if (!USERFLOW_SCHEME.test(scheme)) return {
     ok: false,
     reason: 'bad-scheme-shape'
@@ -109,11 +121,15 @@ export function inspectPairingDeepLink(url) {
     ok: false,
     reason: 'missing-token'
   };
+  const purpose = parsePairingPurpose(parsed.searchParams.get('purpose'));
   return {
     ok: true,
     link: {
       scheme,
-      pairingToken
+      pairingToken,
+      ...(purpose ? {
+        purpose
+      } : {})
     }
   };
 }

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

@@ -1 +1 @@
-{"version":3,"names":["USERFLOW_SCHEME_PREFIX","USERFLOW_SCHEME","isPairingAttempt","reason","inspectPairingDeepLink","url","length","ok","schemeMatch","exec","scheme","isUserflowScheme","toLowerCase","startsWith","remainder","slice","replace","parsed","URL","pairingToken","searchParams","get","hasPairingTokenParam","has","isRoot","hostname","pathname","isPair","test","link","parsePairingDeepLink","result","isUserflowPairingUrl"],"sourceRoot":"../../../src","sources":["pairing/deepLink.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["PAIRING_PURPOSES","parsePairingPurpose","value","find","purpose","USERFLOW_SCHEME_PREFIX","USERFLOW_SCHEME","isPairingAttempt","reason","inspectPairingDeepLink","url","length","ok","schemeMatch","exec","scheme","isUserflowScheme","toLowerCase","startsWith","remainder","slice","replace","parsed","URL","pairingToken","searchParams","get","hasPairingTokenParam","has","isRoot","hostname","pathname","isPair","test","link","parsePairingDeepLink","result","isUserflowPairingUrl"],"sourceRoot":"../../../src","sources":["pairing/deepLink.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;;AASA,MAAMA,gBAA2C,GAAG,CAAC,SAAS,EAAE,gBAAgB,CAAC;AAEjF,OAAO,SAASC,mBAAmBA,CAACC,KAAgC,EAAyB;EAC3F,OAAOF,gBAAgB,CAACG,IAAI,CAAEC,OAAO,IAAKA,OAAO,KAAKF,KAAK,CAAC,IAAI,IAAI;AACtE;;AAEA;AACA,MAAMG,sBAAsB,GAAG,WAAW;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,eAAe,GAAG,sCAAsC;;AAE9D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AASA;AACA;AACA;AACA;;AAOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAC9BC,MAAgC,EACG;EACnC,OAAOA,MAAM,KAAK,gBAAgB,IAAIA,MAAM,KAAK,kBAAkB,IAAIA,MAAM,KAAK,eAAe;AACnG;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,sBAAsBA,CAACC,GAA8B,EAAyB;EAC5F,IAAI,OAAOA,GAAG,KAAK,QAAQ,IAAIA,GAAG,CAACC,MAAM,KAAK,CAAC,EAAE;IAC/C,OAAO;MAAEC,EAAE,EAAE,KAAK;MAAEJ,MAAM,EAAE;IAAe,CAAC;EAC9C;EAEA,MAAMK,WAAW,GAAG,wBAAwB,CAACC,IAAI,CAACJ,GAAG,CAAC;EACtD,IAAI,CAACG,WAAW,GAAG,CAAC,CAAC,EAAE,OAAO;IAAED,EAAE,EAAE,KAAK;IAAEJ,MAAM,EAAE;EAAe,CAAC;EACnE,MAAMO,MAAM,GAAGF,WAAW,CAAC,CAAC,CAAC;EAC7B,MAAMG,gBAAgB,GAAGD,MAAM,CAACE,WAAW,CAAC,CAAC,CAACC,UAAU,CAACb,sBAAsB,CAAC;;EAEhF;EACA;EACA;EACA;EACA;EACA;EACA,MAAMc,SAAS,GAAGT,GAAG,CAACU,KAAK,CAACL,MAAM,CAACJ,MAAM,GAAG,CAAC,CAAC,CAACU,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;EACnE,IAAIC,MAAW;EACf,IAAI;IACF,IAAIH,SAAS,KAAK,EAAE,IAAIA,SAAS,CAACD,UAAU,CAAC,GAAG,CAAC,IAAIC,SAAS,CAACD,UAAU,CAAC,GAAG,CAAC,EAAE;MAC9EI,MAAM,GAAG,IAAIC,GAAG,CAACJ,SAAS,KAAK,EAAE,GAAG,GAAG,GAAGA,SAAS,EAAE,wBAAwB,CAAC;IAChF,CAAC,MAAM;MACLG,MAAM,GAAG,IAAIC,GAAG,CAAC,WAAWJ,SAAS,EAAE,CAAC;IAC1C;EACF,CAAC,CAAC,MAAM;IACN,OAAO;MAAEP,EAAE,EAAE,KAAK;MAAEJ,MAAM,EAAEQ,gBAAgB,GAAG,aAAa,GAAG;IAAe,CAAC;EACjF;EAEA,MAAMQ,YAAY,GAAGF,MAAM,CAACG,YAAY,CAACC,GAAG,CAAC,eAAe,CAAC;EAC7D,MAAMC,oBAAoB,GAAGL,MAAM,CAACG,YAAY,CAACG,GAAG,CAAC,eAAe,CAAC;EACrE,MAAMC,MAAM,GACV,CAACP,MAAM,CAACQ,QAAQ,KAAK,EAAE,IAAIR,MAAM,CAACQ,QAAQ,KAAK,gBAAgB,MAC9DR,MAAM,CAACS,QAAQ,KAAK,EAAE,IAAIT,MAAM,CAACS,QAAQ,KAAK,GAAG,CAAC;EACrD;EACA;EACA,MAAMC,MAAM,GAAGH,MAAM,IAAIF,oBAAoB;EAE7C,IAAI,CAACX,gBAAgB,EAAE;IACrB;IACA;IACA;IACA,OAAOgB,MAAM,GAAG;MAAEpB,EAAE,EAAE,KAAK;MAAEJ,MAAM,EAAE;IAAiB,CAAC,GAAG;MAAEI,EAAE,EAAE,KAAK;MAAEJ,MAAM,EAAE;IAAe,CAAC;EACjG;EAEA,IAAI,CAACwB,MAAM,EAAE,OAAO;IAAEpB,EAAE,EAAE,KAAK;IAAEJ,MAAM,EAAE;EAAgB,CAAC;;EAE1D;EACA;EACA,IAAI,CAACF,eAAe,CAAC2B,IAAI,CAAClB,MAAM,CAAC,EAAE,OAAO;IAAEH,EAAE,EAAE,KAAK;IAAEJ,MAAM,EAAE;EAAmB,CAAC;EAEnF,IAAI,CAACgB,YAAY,EAAE,OAAO;IAAEZ,EAAE,EAAE,KAAK;IAAEJ,MAAM,EAAE;EAAgB,CAAC;EAEhE,MAAMJ,OAAO,GAAGH,mBAAmB,CAACqB,MAAM,CAACG,YAAY,CAACC,GAAG,CAAC,SAAS,CAAC,CAAC;EACvE,OAAO;IAAEd,EAAE,EAAE,IAAI;IAAEsB,IAAI,EAAE;MAAEnB,MAAM;MAAES,YAAY;MAAE,IAAIpB,OAAO,GAAG;QAAEA;MAAQ,CAAC,GAAG,CAAC,CAAC;IAAE;EAAE,CAAC;AACtF;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAAS+B,oBAAoBA,CAACzB,GAA8B,EAA0B;EAC3F,MAAM0B,MAAM,GAAG3B,sBAAsB,CAACC,GAAG,CAAC;EAC1C,OAAO0B,MAAM,CAACxB,EAAE,GAAGwB,MAAM,CAACF,IAAI,GAAG,IAAI;AACvC;;AAEA;AACA,OAAO,SAASG,oBAAoBA,CAAC3B,GAA8B,EAAW;EAC5E,OAAOyB,oBAAoB,CAACzB,GAAG,CAAC,IAAI,IAAI;AAC1C","ignoreList":[]}

package/lib/module/pairing/deviceId.js

@@ -0,0 +1,41 @@
+"use strict";
+
+import AsyncStorage from '@react-native-async-storage/async-storage';
+import { uuid } from "../anonymousId.js";
+
+/**
+ * Stable id for this install on the pairing channel.
+ *
+ * The server allows one device per pairing topic and only the same id may
+ * rejoin while the previous presence lingers. The id identifies the device,
+ * not the user, so `reset()` and `exitPreview()` must not clear it.
+ */
+export const PAIRING_DEVICE_ID_STORAGE_KEY = 'userflow:pairingDeviceId';
+let memoized = null;
+export async function getOrCreatePairingDeviceId() {
+  if (memoized !== null) return memoized;
+  try {
+    const stored = await AsyncStorage.getItem(PAIRING_DEVICE_ID_STORAGE_KEY);
+    if (typeof stored === 'string' && stored.length > 0) {
+      memoized = stored;
+      return stored;
+    }
+  } catch {
+    memoized = uuid();
+    return memoized;
+  }
+  const created = uuid();
+  memoized = created;
+  try {
+    await AsyncStorage.setItem(PAIRING_DEVICE_ID_STORAGE_KEY, created);
+  } catch {
+    // Keep the in-memory id for this process. A later launch may mint another.
+  }
+  return created;
+}
+
+/** @internal Clears the process memo so tests can simulate a new launch. */
+export function resetPairingDeviceIdForTests() {
+  memoized = null;
+}
+//# sourceMappingURL=deviceId.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["AsyncStorage","uuid","PAIRING_DEVICE_ID_STORAGE_KEY","memoized","getOrCreatePairingDeviceId","stored","getItem","length","created","setItem","resetPairingDeviceIdForTests"],"sourceRoot":"../../../src","sources":["pairing/deviceId.ts"],"mappings":";;AAAA,OAAOA,YAAY,MAAM,2CAA2C;AAEpE,SAASC,IAAI,QAAQ,mBAAgB;;AAErC;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,6BAA6B,GAAG,0BAA0B;AAEvE,IAAIC,QAAuB,GAAG,IAAI;AAElC,OAAO,eAAeC,0BAA0BA,CAAA,EAAoB;EAClE,IAAID,QAAQ,KAAK,IAAI,EAAE,OAAOA,QAAQ;EAEtC,IAAI;IACF,MAAME,MAAM,GAAG,MAAML,YAAY,CAACM,OAAO,CAACJ,6BAA6B,CAAC;IACxE,IAAI,OAAOG,MAAM,KAAK,QAAQ,IAAIA,MAAM,CAACE,MAAM,GAAG,CAAC,EAAE;MACnDJ,QAAQ,GAAGE,MAAM;MACjB,OAAOA,MAAM;IACf;EACF,CAAC,CAAC,MAAM;IACNF,QAAQ,GAAGF,IAAI,CAAC,CAAC;IACjB,OAAOE,QAAQ;EACjB;EAEA,MAAMK,OAAO,GAAGP,IAAI,CAAC,CAAC;EACtBE,QAAQ,GAAGK,OAAO;EAClB,IAAI;IACF,MAAMR,YAAY,CAACS,OAAO,CAACP,6BAA6B,EAAEM,OAAO,CAAC;EACpE,CAAC,CAAC,MAAM;IACN;EAAA;EAEF,OAAOA,OAAO;AAChB;;AAEA;AACA,OAAO,SAASE,4BAA4BA,CAAA,EAAS;EACnDP,QAAQ,GAAG,IAAI;AACjB","ignoreList":[]}

package/lib/module/pairing/diagnostics.js

@@ -73,7 +73,7 @@ export function pairingMissingTokenMessage(url) {
  * host app's own scheme substituted for the environment's `scheme_id`.
  */
 export function pairingForeignSchemeMessage(url) {
-  return `${PREFIX} Ignoring "${redactPairingToken(url)}": this is a Builder pairing ` + `link, but it was opened with a scheme Userflow does not own. Use your ` + `environment's scheme_id ("userflow-" followed by digits) exactly as the ` + `pairing QR code provides it — do not substitute your app's own scheme. ` + `Register it via the @userflow-tech/react-native plugin ({ schemeId: 'userflow-…' }) and ` + `rebuild the native app; a Metro reload is not enough.`;
+  return `${PREFIX} Ignoring "${redactPairingToken(url)}": this is a Builder pairing ` + `link, but it was opened with a scheme Userflow does not own. Use your ` + `environment's scheme_id ("userflow-" followed by its id) exactly as the ` + `pairing QR code provides it — do not substitute your app's own scheme. ` + `Register it via the @userflow-tech/react-native plugin ({ schemeId: 'userflow-…' }) and ` + `rebuild the native app; a Metro reload is not enough.`;
 }
 
 /** Message for a pairing attempt that could not be used. */
@@ -100,10 +100,11 @@ export function pairingListenerSetupFailedMessage(reason) {
 
 /**
  * The URL used a `userflow-` scheme that is not a valid `scheme_id`. Pairing
- * requires `userflow-` followed by digits, so an arbitrary `userflow-*` scheme
- * can match preview links but not pairing ones.
+ * requires `userflow-` followed by one or more alphanumeric segments joined by
+ * single hyphens. A malformed `userflow-*` scheme can match preview links but
+ * not pairing ones.
  */
 export function pairingSchemeShapeMessage(url) {
-  return `${PREFIX} Ignoring Builder pairing link "${redactPairingToken(url)}": the scheme must be your ` + `environment's scheme_id — "userflow-" followed by digits (e.g. userflow-257587). ` + `Check the schemeId passed to the @userflow-tech/react-native plugin.`;
+  return `${PREFIX} Ignoring Builder pairing link "${redactPairingToken(url)}": the scheme must be your ` + `environment's scheme_id — "userflow-" followed by letters and digits, optionally ` + `split by single hyphens (e.g. userflow-v7twv2fw2ja2jaco7kesvowmem). ` + `Check the schemeId passed to the @userflow-tech/react-native plugin.`;
 }
 //# sourceMappingURL=diagnostics.js.map

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

@@ -1 +1 @@
-{"version":3,"names":["PREFIX","redactPairingToken","url","replace","defaultPairingLogger","message","console","warn","pairingLinkDeferredMessage","pairingLinkInitFailedMessage","reason","pairingConnectFailedMessage","pairingPreviewErrorMessage","pairingMissingTokenMessage","pairingForeignSchemeMessage","pairingAttemptRejectionMessage","pairingSchemeShapeMessage","pairingTokenStoreClearFailedMessage","pairingListenerSetupFailedMessage"],"sourceRoot":"../../../src","sources":["pairing/diagnostics.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,MAAMA,MAAM,GAAG,YAAY;;AAE3B;AACA;AACA;AACA;AACA,SAASC,kBAAkBA,CAACC,GAAW,EAAU;EAC/C,OAAOA,GAAG,CAACC,OAAO,CAAC,wBAAwB,EAAE,cAAc,CAAC;AAC9D;;AAEA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,oBAAmC,GAAIC,OAAO,IAAK;EAC9D;EACAC,OAAO,CAACC,IAAI,CAACF,OAAO,CAAC;AACvB,CAAC;;AAED;AACA,OAAO,SAASG,0BAA0BA,CAAA,EAAW;EACnD,OACE,GAAGR,MAAM,kEAAkE,GAC3E,uDAAuD;AAE3D;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASS,4BAA4BA,CAACC,MAAc,EAAU;EACnE,OACE,GAAGV,MAAM,wEAAwE,GACjF,iBAAiBU,MAAM,2DAA2D,GAClF,mEAAmE;AAEvE;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,2BAA2BA,CAACD,MAAc,EAAU;EAClE,OACE,GAAGV,MAAM,uCAAuCU,MAAM,4BAA4B,GAClF,yDAAyD;AAE7D;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,0BAA0BA,CAACF,MAAc,EAAU;EACjE,OAAO,GAAGV,MAAM,qBAAqBU,MAAM,EAAE;AAC/C;;AAEA;AACA,OAAO,SAASG,0BAA0BA,CAACX,GAAW,EAAU;EAC9D,OACE,GAAGF,MAAM,mCAAmCC,kBAAkB,CAACC,GAAG,CAAC,QAAQ,GAC3E,8EAA8E,GAC9E,6CAA6C;AAEjD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASY,2BAA2BA,CAACZ,GAAW,EAAU;EAC/D,OACE,GAAGF,MAAM,cAAcC,kBAAkB,CAACC,GAAG,CAAC,+BAA+B,GAC7E,wEAAwE,GACxE,0EAA0E,GAC1E,yEAAyE,GACzE,0FAA0F,GAC1F,uDAAuD;AAE3D;;AAEA;AACA,OAAO,SAASa,8BAA8BA,CAC5CL,MAA+B,EAC/BR,GAAW,EACH;EACR,QAAQQ,MAAM;IACZ,KAAK,gBAAgB;MACnB,OAAOI,2BAA2B,CAACZ,GAAG,CAAC;IACzC,KAAK,kBAAkB;MACrB,OAAOc,yBAAyB,CAACd,GAAG,CAAC;IACvC,KAAK,eAAe;MAClB,OAAOW,0BAA0B,CAACX,GAAG,CAAC;EAC1C;AACF;;AAEA;AACA,OAAO,SAASe,mCAAmCA,CAACP,MAAc,EAAU;EAC1E,OACE,GAAGV,MAAM,8CAA8CU,MAAM,iBAAiB,GAC9E,6EAA6E;AAEjF;;AAEA;AACA,OAAO,SAASQ,iCAAiCA,CAACR,MAAc,EAAU;EACxE,OACE,GAAGV,MAAM,+CAA+CU,MAAM,iBAAiB,GAC/E,4EAA4E;AAEhF;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASM,yBAAyBA,CAACd,GAAW,EAAU;EAC7D,OACE,GAAGF,MAAM,mCAAmCC,kBAAkB,CAACC,GAAG,CAAC,6BAA6B,GAChG,mFAAmF,GACnF,sEAAsE;AAE1E","ignoreList":[]}
+{"version":3,"names":["PREFIX","redactPairingToken","url","replace","defaultPairingLogger","message","console","warn","pairingLinkDeferredMessage","pairingLinkInitFailedMessage","reason","pairingConnectFailedMessage","pairingPreviewErrorMessage","pairingMissingTokenMessage","pairingForeignSchemeMessage","pairingAttemptRejectionMessage","pairingSchemeShapeMessage","pairingTokenStoreClearFailedMessage","pairingListenerSetupFailedMessage"],"sourceRoot":"../../../src","sources":["pairing/diagnostics.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,MAAMA,MAAM,GAAG,YAAY;;AAE3B;AACA;AACA;AACA;AACA,SAASC,kBAAkBA,CAACC,GAAW,EAAU;EAC/C,OAAOA,GAAG,CAACC,OAAO,CAAC,wBAAwB,EAAE,cAAc,CAAC;AAC9D;;AAEA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,oBAAmC,GAAIC,OAAO,IAAK;EAC9D;EACAC,OAAO,CAACC,IAAI,CAACF,OAAO,CAAC;AACvB,CAAC;;AAED;AACA,OAAO,SAASG,0BAA0BA,CAAA,EAAW;EACnD,OACE,GAAGR,MAAM,kEAAkE,GAC3E,uDAAuD;AAE3D;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASS,4BAA4BA,CAACC,MAAc,EAAU;EACnE,OACE,GAAGV,MAAM,wEAAwE,GACjF,iBAAiBU,MAAM,2DAA2D,GAClF,mEAAmE;AAEvE;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,2BAA2BA,CAACD,MAAc,EAAU;EAClE,OACE,GAAGV,MAAM,uCAAuCU,MAAM,4BAA4B,GAClF,yDAAyD;AAE7D;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,0BAA0BA,CAACF,MAAc,EAAU;EACjE,OAAO,GAAGV,MAAM,qBAAqBU,MAAM,EAAE;AAC/C;;AAEA;AACA,OAAO,SAASG,0BAA0BA,CAACX,GAAW,EAAU;EAC9D,OACE,GAAGF,MAAM,mCAAmCC,kBAAkB,CAACC,GAAG,CAAC,QAAQ,GAC3E,8EAA8E,GAC9E,6CAA6C;AAEjD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASY,2BAA2BA,CAACZ,GAAW,EAAU;EAC/D,OACE,GAAGF,MAAM,cAAcC,kBAAkB,CAACC,GAAG,CAAC,+BAA+B,GAC7E,wEAAwE,GACxE,0EAA0E,GAC1E,yEAAyE,GACzE,0FAA0F,GAC1F,uDAAuD;AAE3D;;AAEA;AACA,OAAO,SAASa,8BAA8BA,CAC5CL,MAA+B,EAC/BR,GAAW,EACH;EACR,QAAQQ,MAAM;IACZ,KAAK,gBAAgB;MACnB,OAAOI,2BAA2B,CAACZ,GAAG,CAAC;IACzC,KAAK,kBAAkB;MACrB,OAAOc,yBAAyB,CAACd,GAAG,CAAC;IACvC,KAAK,eAAe;MAClB,OAAOW,0BAA0B,CAACX,GAAG,CAAC;EAC1C;AACF;;AAEA;AACA,OAAO,SAASe,mCAAmCA,CAACP,MAAc,EAAU;EAC1E,OACE,GAAGV,MAAM,8CAA8CU,MAAM,iBAAiB,GAC9E,6EAA6E;AAEjF;;AAEA;AACA,OAAO,SAASQ,iCAAiCA,CAACR,MAAc,EAAU;EACxE,OACE,GAAGV,MAAM,+CAA+CU,MAAM,iBAAiB,GAC/E,4EAA4E;AAEhF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASM,yBAAyBA,CAACd,GAAW,EAAU;EAC7D,OACE,GAAGF,MAAM,mCAAmCC,kBAAkB,CAACC,GAAG,CAAC,6BAA6B,GAChG,mFAAmF,GACnF,sEAAsE,GACtE,sEAAsE;AAE1E","ignoreList":[]}

package/lib/module/pairing/tokenStorage.js

@@ -1,11 +1,16 @@
 "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. */
@@ -36,6 +41,7 @@ function tryLoadExpoSecureStore() {
 /** 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;
@@ -45,6 +51,13 @@ export function createMemoryPairingTokenStore() {
     },
     async clear() {
       value = null;
+      purposeValue = null;
+    },
+    async getPurpose() {
+      return purposeValue;
+    },
+    async setPurpose(purpose) {
+      purposeValue = purpose;
     }
   };
 }
@@ -58,24 +71,51 @@ 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.
+      }
     }
   };
 }

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

@@ -1 +1 @@
-{"version":3,"names":["STORAGE_KEY","cachedSecureStore","isExpoModulesRuntimeAvailable","expo","globalThis","EventEmitter","tryLoadExpoSecureStore","undefined","require","__DEV__","console","warn","createMemoryPairingTokenStore","value","get","set","token","clear","createPairingTokenStore","secure","getItemAsync","setItemAsync","deleteItemAsync","resetPairingTokenStoreCacheForTests"],"sourceRoot":"../../../src","sources":["pairing/tokenStorage.ts"],"mappings":";;AAAA;AACA;AACA;AACA;;AAEA,MAAMA,WAAW,GAAG,uBAAuB;AAc3C,IAAIC,iBAAuD;;AAE3D;AACA,SAASC,6BAA6BA,CAAA,EAAY;EAChD,MAAMC,IAAI,GAAIC,UAAU,CAA2CD,IAAI;EACvE,OAAO,OAAOA,IAAI,EAAEE,YAAY,KAAK,UAAU;AACjD;AAEA,SAASC,sBAAsBA,CAAA,EAA6B;EAC1D,IAAIL,iBAAiB,KAAKM,SAAS,EAAE,OAAON,iBAAiB;EAE7D,IAAI,OAAOO,OAAO,KAAK,UAAU,IAAI,CAACN,6BAA6B,CAAC,CAAC,EAAE;IACrED,iBAAiB,GAAG,IAAI;IACxB,OAAOA,iBAAiB;EAC1B;EAEA,IAAI;IACF;IACA;IACAA,iBAAiB,GAAGO,OAAO,CAAC,mBAAmB,CAAsB;EACvE,CAAC,CAAC,MAAM;IACNP,iBAAiB,GAAG,IAAI;IACxB,IAAIQ,OAAO,EAAE;MACX;MACAC,OAAO,CAACC,IAAI,CACV,6DAA6D,GAC3D,0DACJ,CAAC;IACH;EACF;EAEA,OAAOV,iBAAiB;AAC1B;;AAEA;AACA,OAAO,SAASW,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,GAAGb,sBAAsB,CAAC,CAAC;EACvC,IAAI,CAACa,MAAM,EAAE,OAAOP,6BAA6B,CAAC,CAAC;EAEnD,OAAO;IACL,MAAME,GAAGA,CAAA,EAAG;MACV,IAAI;QACF,OAAO,MAAMK,MAAM,CAACC,YAAY,CAACpB,WAAW,CAAC;MAC/C,CAAC,CAAC,MAAM;QACN,OAAO,IAAI;MACb;IACF,CAAC;IACD,MAAMe,GAAGA,CAACC,KAAa,EAAE;MACvB,IAAI;QACF,MAAMG,MAAM,CAACE,YAAY,CAACrB,WAAW,EAAEgB,KAAK,CAAC;MAC/C,CAAC,CAAC,MAAM;QACN;MAAA;IAEJ,CAAC;IACD,MAAMC,KAAKA,CAAA,EAAG;MACZ,IAAI;QACF,MAAME,MAAM,CAACG,eAAe,CAACtB,WAAW,CAAC;MAC3C,CAAC,CAAC,MAAM;QACN;MAAA;IAEJ;EACF,CAAC;AACH;;AAEA;AACA,OAAO,SAASuB,mCAAmCA,CAAA,EAAS;EAC1DtB,iBAAiB,GAAGM,SAAS;AAC/B","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

@@ -11,7 +11,9 @@ const IDLE = {
   needsRescan: false,
   awaitingStartCondition: false,
   canRestartPreview: false,
-  previewRestartGeneration: 0
+  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","canRestartPreview","previewRestartGeneration","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;AAC5B,CAAC;;AAED;AACA,OAAO,SAASC,eAAeA,CAAA,EAAuB;EACpD,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAGf,KAAK,CAACgB,QAAQ,CACtC,MAAMd,qBAAqB,CAAC,CAAC,EAAEe,QAAQ,CAAC,CAAC,IAAId,IAC/C,CAAC;EAEDH,KAAK,CAACkB,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,GAAGrB,qBAAqB,CAAC,CAAC;IACxC,IAAIqB,QAAQ,EAAEH,IAAI,CAACG,QAAQ,CAAC;IAC5B,MAAMC,YAAY,GAAGvB,mBAAmB,CAACmB,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":"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","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

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

@@ -0,0 +1 @@
+{"version":3,"names":["React","StyleSheet","View","elementPickerController","BannerSurface","bannerOverlayHostPadding","useUserflowSafeAreaInsets","SdkErrorBoundary","BannerEngineContext","embedBannerPlaceholderId","warnBannerOnce","registerEmbedBannerPlaceholder","useBannerSession","jsx","_jsx","EmbedBannerPlaceholder","id","engine","useContext","placeholderId","trim","session","insets","pickerActive","setPickerActive","useState","getState","active","useEffect","subscribe","next","useLayoutEffect","banner","version","bar","onActions","actions","handleActions","onDismiss","endReason","endBanner","scope","resetKey","children","overlay","pointerEvents","testID","style","styles","overlaySlot","overlayBar","slot","create","alignSelf","height","position","left","right","top"],"sourceRoot":"../../../src","sources":["runtime/EmbedBannerPlaceholder.tsx"],"mappings":"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","ignoreList":[]}