@userflow-tech/react-native 0.2.0 → 0.3.1

package/lib/typescript/module/src/lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,cAAc,EAA2B,MAAM,cAAc,CAAC;AAE5E,2FAA2F;AAC3F,eAAO,MAAM,qBAAqB,QAAgB,CAAC;AAEnD,wEAAwE;AACxE,eAAO,MAAM,iCAAiC,QAAgB,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AAEtC,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,CAAC;IACzD,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B;;;;;OAKG;IACH,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,4EAA4E;IAC5E,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,MAAM,cAAc,CAAC;IAC1C,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CAC/E;AAYD;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAa;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAgB;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2B;IAC1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAuB;IAC1D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA4D;IAE9F,OAAO,CAAC,mBAAmB,CAA6B;IACxD,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,iFAAiF;IACjF,OAAO,CAAC,SAAS,CAAS;gBAEd,IAAI,EAAE,uBAAuB;IAczC,KAAK,IAAI,IAAI;IAYb,IAAI,IAAI,IAAI;IAWZ;;;OAGG;IACH,cAAc,IAAI,IAAI;IAOtB,yBAAyB;IACzB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAalD,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,YAAY;IAqCpB,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,cAAc;CAMvB"}
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,cAAc,EAA2B,MAAM,cAAc,CAAC;AAE5E,2FAA2F;AAC3F,eAAO,MAAM,qBAAqB,QAAgB,CAAC;AAEnD,wEAAwE;AACxE,eAAO,MAAM,iCAAiC,QAAgB,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AAEtC,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,CAAC;IACzD,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B;;;;;OAKG;IACH,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB;;;OAGG;IACH,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,MAAM,cAAc,CAAC;IAC1C,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CAC/E;AAYD;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAa;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAgB;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2B;IAC1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAuB;IAC1D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA4D;IAE9F,OAAO,CAAC,mBAAmB,CAA6B;IACxD,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,iFAAiF;IACjF,OAAO,CAAC,SAAS,CAAS;gBAEd,IAAI,EAAE,uBAAuB;IAczC,KAAK,IAAI,IAAI;IAYb,IAAI,IAAI,IAAI;IAWZ;;;OAGG;IACH,cAAc,IAAI,IAAI;IAOtB,yBAAyB;IACzB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAalD,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,YAAY;IAqCpB,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,cAAc;CAMvB"}

package/lib/typescript/module/src/navigation/WithUserflowReactNavigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WithUserflowReactNavigation.d.ts","sourceRoot":"","sources":["../../../../../src/navigation/WithUserflowReactNavigation.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,aAAa,EACd,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAS/B,KAAK,6BAA6B,GAAG;IACnC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC,CAAC;IACvD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,aAAa,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,eAAe,KAAK,IAAI,CAAC;CACnD,CAAC;AAEF,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,6BAA6B,CAAC,CAAC;CAC7D;AAkBD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,EAC1C,QAAQ,GACT,EAAE,gCAAgC,GAAG,KAAK,CAAC,YAAY,CAkDvD"}
+{"version":3,"file":"WithUserflowReactNavigation.d.ts","sourceRoot":"","sources":["../../../../../src/navigation/WithUserflowReactNavigation.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,aAAa,EACd,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAU/B,KAAK,6BAA6B,GAAG;IACnC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC,CAAC;IACvD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,aAAa,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,eAAe,KAAK,IAAI,CAAC;CACnD,CAAC;AAEF,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,6BAA6B,CAAC,CAAC;CAC7D;AAkBD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,EAC1C,QAAQ,GACT,EAAE,gCAAgC,GAAG,KAAK,CAAC,YAAY,CAoDvD"}

package/lib/typescript/module/src/navigation/openFlowNavigateUrl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openFlowNavigateUrl.d.ts","sourceRoot":"","sources":["../../../../../src/navigation/openFlowNavigateUrl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAKtF,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC;AAE5F,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B,CAAC;AAMF,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAEvF;AAED,2FAA2F;AAC3F,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,sBAAsB,CAAC,aAAa,CAAC,GAAG,IAAI,GAAG,SAAS,GAC5D,IAAI,CAEN;AAED,gEAAgE;AAChE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAEtF;AAED,kDAAkD;AAClD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAMvD;AAcD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCpE;AAED,gBAAgB;AAChB,wBAAgB,iCAAiC,IAAI,IAAI,CAIxD"}
+{"version":3,"file":"openFlowNavigateUrl.d.ts","sourceRoot":"","sources":["../../../../../src/navigation/openFlowNavigateUrl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAMtF,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC;AAE5F,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B,CAAC;AAMF,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAEvF;AAED,2FAA2F;AAC3F,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,sBAAsB,CAAC,aAAa,CAAC,GAAG,IAAI,GAAG,SAAS,GAC5D,IAAI,CAEN;AAED,gEAAgE;AAChE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAEtF;AAED,kDAAkD;AAClD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAMvD;AAcD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuCpE;AAED,gBAAgB;AAChB,wBAAgB,iCAAiC,IAAI,IAAI,CAIxD"}

package/lib/typescript/module/src/pairing/PairingController.d.ts

@@ -1,4 +1,4 @@
-import { PairingEngine, type PairingEngineState, type UserflowCore } from '@userflow-tech/core';
+import { PairingEngine, type PairingEngineState, type PairingPurpose, type UserflowCore } from '@userflow-tech/core';
 import { type AppStateStatus } from 'react-native';
 import { type PairingLogger } from './diagnostics';
 import { type PairingTokenStore } from './tokenStorage';
@@ -10,6 +10,13 @@ export interface PairingControllerOptions {
     tokenStore?: PairingTokenStore;
     /** Clear mid-flow session when exiting preview. */
     clearLocalSession?: () => void;
+    /** End the previewed draft on the server when exiting preview. */
+    endDraftSession?: () => Promise<void>;
+    /**
+     * Drop an end that is waiting for a draft identify has not delivered.
+     * A new preview must call this so that draft is not ended when it arrives.
+     */
+    cancelPendingDraftEnd?: () => void;
     LinkingModule?: {
         getInitialURL(): Promise<string | null>;
         addEventListener(type: 'url', handler: (event: {
@@ -25,6 +32,11 @@ export interface PairingControllerOptions {
     };
     /** Sink for pairing diagnostics. Injected in tests. */
     logger?: PairingLogger;
+    /**
+     * Stable pairing device id. Defaults to the persisted install id.
+     * Injected in tests.
+     */
+    deviceIdProvider?: () => Promise<string>;
 }
 /**
  * Inbound deep links → pairing session → preview mode.
@@ -41,13 +53,33 @@ export declare class PairingController {
     private readonly LinkingModule;
     private readonly AppStateModule;
     private readonly clearLocalSession;
+    private readonly endDraftSession;
+    private readonly cancelPendingDraftEnd;
     private readonly core;
     private readonly pairingEndpoint;
     private readonly logger;
+    private readonly deviceIdProvider;
+    private pairingDeviceId;
+    /** A link or resume already claimed this launch, so a stored token must not. */
+    private acceptedPairingToken;
+    /**
+     * Bumped by exitPreview. An in-flight resume or connect checks it after
+     * every await and does not write the token or leave the socket up.
+     */
+    private launchEpoch;
+    /** Latest enterPreview. An older attempt must not clear a newer token. */
+    private enterAttempt;
+    /**
+     * Orders token and purpose writes. Two scans can overlap on the awaits, and
+     * the slower one's purpose must not land on the token the faster one saved.
+     */
+    private previewSaveQueue;
     private initPhase;
     private initFailureReason;
     /** Pairing token captured before init resolved, replayed once it does. */
     private deferredPairingToken;
+    /** Purpose of {@link deferredPairingToken}, so the held banner already honours it. */
+    private deferredPurpose;
     /** Diagnostics already emitted for the current init attempt. */
     private readonly loggedOnce;
     private relayUnsub;
@@ -61,6 +93,11 @@ export declare class PairingController {
      * this the host app shows no sign that a pairing link was ever received.
      */
     private blockedState;
+    /**
+     * A link or resumed token is waiting for init. Report connecting so the
+     * banner is visible during credential validation instead of looking idle.
+     */
+    private heldState;
     onStateChange(listener: PairingControllerListener): () => void;
     /**
      * Start deep-link listeners. Safe to call multiple times, and never rejects —
@@ -69,19 +106,31 @@ export declare class PairingController {
      */
     start(): Promise<void>;
     private startListening;
+    /**
+     * Rejoin the Builder session after a relaunch when no new pairing link won.
+     * An expired or undecodable token is cleared so the next launch stays idle.
+     */
+    private resumeStoredToken;
     stop(): void;
     /**
      * Host apps that intercept deep links themselves can forward them here.
      */
     handleUrl(url: string): Promise<boolean>;
+    /**
+     * Connect now, or hold the token until init resolves or fails. Links and
+     * resumed sessions share this gate so both are deferred, replayed, and
+     * shown the same way.
+     */
+    private connectWhenReady;
     /**
      * Called when `Userflow.init()` begins. Clears a previous failure so a retried
      * init does not keep reporting the old error.
      */
     notifyInitStarted(): void;
     /**
-     * Called when `Userflow.init()` resolves. Connects a link that arrived while
-     * init was still in flight.
+     * Called when `Userflow.init()` resolves. Connects a link or resumed session
+     * that arrived while init was still in flight. `Userflow.init` does not await
+     * this — the pairing socket must not block identify.
      */
     notifyInitialized(): Promise<void>;
     /**
@@ -95,7 +144,25 @@ export declare class PairingController {
      */
     private warnOnce;
     /** Explicit entry with a raw pairing JWT (tests / advanced hosts). */
-    enterPreview(pairingToken: string): Promise<void>;
+    enterPreview(pairingToken: string, purpose?: PairingPurpose | null): Promise<void>;
+    /**
+     * Write the token and its purpose as one attempt. Writes are queued so an
+     * older scan cannot finish its purpose after a newer scan has saved its own.
+     * Returns false when this attempt lost the race; storage then still belongs
+     * to whoever connected, or is cleared if this attempt was the last writer.
+     */
+    private savePreviewCredentials;
+    /**
+     * Drop credentials this attempt wrote, when they are still the ones stored.
+     * A newer scan may already have replaced them; those stay.
+     */
+    private revertPreviewCredentials;
+    /**
+     * Remove the token this attempt wrote. A newer pair may already have
+     * replaced it; that token stays.
+     */
+    private discardPreviewToken;
+    private resolveDeviceId;
     exitPreview(): Promise<void>;
     /**
      * Replay the last previewed flow from step 1. No-ops when nothing has been

package/lib/typescript/module/src/pairing/PairingController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PairingController.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/PairingController.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PairingController.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/PairingController.ts"],"names":[],"mappings":"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"}

package/lib/typescript/module/src/pairing/PreviewModeBanner.d.ts

@@ -1,5 +1,7 @@
 import type { PairingEngineState } from '@userflow-tech/core';
 import * as React from 'react';
+/** A short blip stays quiet. Longer than this, the hidden bar comes back until the socket recovers. */
+export declare const RECONNECT_REVEAL_DELAY_MS = 2000;
 export interface PreviewModeBannerProps {
     state: PairingEngineState;
     onExit: () => void;
@@ -8,9 +10,15 @@ export interface PreviewModeBannerProps {
     onConfirmingChange?: (open: boolean) => void;
     /** Hide the preview bar while the element picker is using the same top slot. */
     suppressed?: boolean | undefined;
+    /**
+     * Hide default-tone chrome without giving the top slot to the picker.
+     * Error tone still shows. Set for the brief intro after a new pairing and
+     * for the stretch after element selection until the Builder starts a preview.
+     */
+    held?: boolean | undefined;
 }
 /**
  * Overlay chrome for Builder pairing preview mode.
  */
-export declare function PreviewModeBanner({ state, onExit, onRestart, onConfirmingChange, suppressed, }: PreviewModeBannerProps): React.ReactElement | null;
+export declare function PreviewModeBanner({ state, onExit, onRestart, onConfirmingChange, suppressed, held, }: PreviewModeBannerProps): React.ReactElement | null;
 //# sourceMappingURL=PreviewModeBanner.d.ts.map

package/lib/typescript/module/src/pairing/PreviewModeBanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PreviewModeBanner.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/PreviewModeBanner.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAkB/B,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,gFAAgF;IAChF,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,MAAM,EACN,SAAS,EACT,kBAAkB,EAClB,UAAkB,GACnB,EAAE,sBAAsB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAmOpD"}
+{"version":3,"file":"PreviewModeBanner.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/PreviewModeBanner.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAiB/B,uGAAuG;AACvG,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,gFAAgF;IAChF,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,MAAM,EACN,SAAS,EACT,kBAAkB,EAClB,UAAkB,EAClB,IAAY,GACb,EAAE,sBAAsB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAmRpD"}

package/lib/typescript/module/src/pairing/deepLink.d.ts

@@ -1,13 +1,17 @@
+import type { PairingPurpose } from '@userflow-tech/core';
 /**
  * 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.
  */
 export interface PairingDeepLink {
     scheme: string;
     pairingToken: string;
+    /** Absent when the link has no `purpose`, or one this SDK does not know. */
+    purpose?: PairingPurpose;
 }
+export declare function parsePairingPurpose(value: string | null | undefined): PairingPurpose | null;
 /**
  * Why a URL was not treated as a pairing link.
  *

package/lib/typescript/module/src/pairing/deepLink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deepLink.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/deepLink.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD;;;;;;;GAOG;AACH,MAAM,MAAM,wBAAwB,GAChC,cAAc,GACd,gBAAgB,GAChB,kBAAkB,GAClB,aAAa,GACb,eAAe,GACf,eAAe,CAAC;AAEpB;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,eAAe,CAAC;AAE9F,MAAM,MAAM,qBAAqB,GAC7B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GACnC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,wBAAwB,CAAA;CAAE,CAAC;AAEpD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,wBAAwB,GAC/B,MAAM,IAAI,uBAAuB,CAEnC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,qBAAqB,CAqD5F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,eAAe,GAAG,IAAI,CAG3F;AAED,iEAAiE;AACjE,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE5E"}
+{"version":3,"file":"deepLink.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/deepLink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAID,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,cAAc,GAAG,IAAI,CAE3F;AAaD;;;;;;;GAOG;AACH,MAAM,MAAM,wBAAwB,GAChC,cAAc,GACd,gBAAgB,GAChB,kBAAkB,GAClB,aAAa,GACb,eAAe,GACf,eAAe,CAAC;AAEpB;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,eAAe,CAAC;AAE9F,MAAM,MAAM,qBAAqB,GAC7B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GACnC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,wBAAwB,CAAA;CAAE,CAAC;AAEpD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,wBAAwB,GAC/B,MAAM,IAAI,uBAAuB,CAEnC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,qBAAqB,CAsD5F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,eAAe,GAAG,IAAI,CAG3F;AAED,iEAAiE;AACjE,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE5E"}

package/lib/typescript/module/src/pairing/deviceId.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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 declare const PAIRING_DEVICE_ID_STORAGE_KEY = "userflow:pairingDeviceId";
+export declare function getOrCreatePairingDeviceId(): Promise<string>;
+/** @internal Clears the process memo so tests can simulate a new launch. */
+export declare function resetPairingDeviceIdForTests(): void;
+//# sourceMappingURL=deviceId.d.ts.map

package/lib/typescript/module/src/pairing/deviceId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceId.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/deviceId.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,6BAA6B,CAAC;AAIxE,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,MAAM,CAAC,CA0BlE;AAED,4EAA4E;AAC5E,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD"}

package/lib/typescript/module/src/pairing/diagnostics.d.ts

@@ -50,8 +50,9 @@ export declare function pairingTokenStoreClearFailedMessage(reason: string): str
 export declare function pairingListenerSetupFailedMessage(reason: string): string;
 /**
  * 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 declare function pairingSchemeShapeMessage(url: string): string;
 //# sourceMappingURL=diagnostics.d.ts.map

package/lib/typescript/module/src/pairing/diagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAY1D,uDAAuD;AACvD,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAGlC,CAAC;AAEF,0EAA0E;AAC1E,wBAAgB,0BAA0B,IAAI,MAAM,CAKnD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKlE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,0EAA0E;AAC1E,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS/D;AAED,4DAA4D;AAC5D,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,uBAAuB,EAC/B,GAAG,EAAE,MAAM,GACV,MAAM,CASR;AAED,6EAA6E;AAC7E,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK1E;AAED,iFAAiF;AACjF,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKxE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM7D"}
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAY1D,uDAAuD;AACvD,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAGlC,CAAC;AAEF,0EAA0E;AAC1E,wBAAgB,0BAA0B,IAAI,MAAM,CAKnD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKlE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,0EAA0E;AAC1E,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS/D;AAED,4DAA4D;AAC5D,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,uBAAuB,EAC/B,GAAG,EAAE,MAAM,GACV,MAAM,CASR;AAED,6EAA6E;AAC7E,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK1E;AAED,iFAAiF;AACjF,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKxE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO7D"}

package/lib/typescript/module/src/pairing/tokenStorage.d.ts

@@ -1,11 +1,23 @@
 /**
- * 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.
  */
+import type { PairingPurpose } from '@userflow-tech/core';
+export declare const PAIRING_TOKEN_STORAGE_KEY = "userflow.pairingToken";
+export declare const PAIRING_PURPOSE_STORAGE_KEY = "userflow.pairingPurpose";
 export interface PairingTokenStore {
     get(): Promise<string | null>;
     set(token: string): Promise<void>;
+    /** Clears the token and its purpose. */
     clear(): Promise<void>;
+    /**
+     * Purpose of the link that wrote the token, so a resume keeps the same
+     * preview chrome. Optional so custom stores keep working; a store without
+     * it resumes with no purpose.
+     */
+    getPurpose?(): Promise<PairingPurpose | null>;
+    setPurpose?(purpose: PairingPurpose | null): Promise<void>;
 }
 /** In-memory store used when SecureStore is unavailable (and in tests). */
 export declare function createMemoryPairingTokenStore(): PairingTokenStore;

package/lib/typescript/module/src/pairing/tokenStorage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokenStorage.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/tokenStorage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,iBAAiB;IAChC,GAAG,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9B,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AA0CD,2EAA2E;AAC3E,wBAAgB,6BAA6B,IAAI,iBAAiB,CAajE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CA2B3D;AAED,mDAAmD;AACnD,wBAAgB,mCAAmC,IAAI,IAAI,CAE1D"}
+{"version":3,"file":"tokenStorage.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/tokenStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAK1D,eAAO,MAAM,yBAAyB,0BAA0B,CAAC;AACjE,eAAO,MAAM,2BAA2B,4BAA4B,CAAC;AAErE,MAAM,WAAW,iBAAiB;IAChC,GAAG,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9B,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,wCAAwC;IACxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB;;;;OAIG;IACH,UAAU,CAAC,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC9C,UAAU,CAAC,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AA0CD,2EAA2E;AAC3E,wBAAgB,6BAA6B,IAAI,iBAAiB,CAqBjE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CAyD3D;AAED,mDAAmD;AACnD,wBAAgB,mCAAmC,IAAI,IAAI,CAE1D"}

package/lib/typescript/module/src/pairing/usePairingState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePairingState.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/usePairingState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAkB9D,2EAA2E;AAC3E,wBAAgB,eAAe,IAAI,kBAAkB,CAyBpD"}
+{"version":3,"file":"usePairingState.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/usePairingState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAoB9D,2EAA2E;AAC3E,wBAAgB,eAAe,IAAI,kBAAkB,CAyBpD"}

package/lib/typescript/module/src/pairing/usePreviewBarHold.d.ts

@@ -0,0 +1,19 @@
+import type { PairingEngineState } from '@userflow-tech/core';
+/**
+ * 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 declare const INITIAL_REVEAL_DELAY_MS = 2000;
+/**
+ * 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 declare function usePreviewBarHold(state: PairingEngineState, pickerActive: boolean): boolean;
+//# sourceMappingURL=usePreviewBarHold.d.ts.map

package/lib/typescript/module/src/pairing/usePreviewBarHold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePreviewBarHold.d.ts","sourceRoot":"","sources":["../../../../../src/pairing/usePreviewBarHold.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAkB,MAAM,qBAAqB,CAAC;AAK9E;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,OAAO,CAAC;AA2F5C;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAgD3F"}

package/lib/typescript/module/src/runtime/BannerHost.d.ts

@@ -0,0 +1,16 @@
+import type { BannerSessionEngine } from '@userflow-tech/core';
+import * as React from 'react';
+/**
+ * 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.
+ */
+export declare function BannerHost({ engine, hidden, placement, edge: edgeFilter, }: {
+    engine: BannerSessionEngine;
+    hidden?: boolean;
+    placement?: 'overlay' | 'flow';
+    /** When set, render only the banner pinned to this edge. */
+    edge?: 'top' | 'bottom';
+}): React.ReactElement | null;
+//# sourceMappingURL=BannerHost.d.ts.map

package/lib/typescript/module/src/runtime/BannerHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BannerHost.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/BannerHost.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAa/B;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,MAAM,EACN,SAAqB,EACrB,IAAI,EAAE,UAAU,GACjB,EAAE;IACD,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC/B,4DAA4D;IAC5D,IAAI,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;CACzB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAsD5B"}

package/lib/typescript/module/src/runtime/EmbedBannerPlaceholder.d.ts

@@ -0,0 +1,18 @@
+import * as React from 'react';
+export interface EmbedBannerPlaceholderProps {
+    /**
+     * Matches the banner's manual embed selector. `#welcome-banner` and
+     * `welcome-banner` both match this id.
+     */
+    id: string;
+}
+/**
+ * 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 declare function EmbedBannerPlaceholder({ id, }: EmbedBannerPlaceholderProps): React.ReactElement | null;
+//# sourceMappingURL=EmbedBannerPlaceholder.d.ts.map

package/lib/typescript/module/src/runtime/EmbedBannerPlaceholder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmbedBannerPlaceholder.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/EmbedBannerPlaceholder.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAc/B,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,EAAE,GACH,EAAE,2BAA2B,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAkEzD"}

package/lib/typescript/module/src/runtime/SdkErrorBoundary.d.ts

@@ -0,0 +1,34 @@
+import * as React from 'react';
+export interface SdkErrorBoundaryProps {
+    /** Label included in the isolated-error log (for example `overlay`). */
+    scope: string;
+    /**
+     * When this value changes after a caught error, the boundary retries its
+     * children — but only if that identity has not already failed. A reconnect
+     * that restores the same session/step stays blank. Does not remount children
+     * while they are healthy.
+     */
+    resetKey?: string;
+    /** Called after a render error is isolated (for example to clear an a11y trap). */
+    onError?: (error: Error) => void;
+    children: React.ReactNode;
+}
+interface SdkErrorBoundaryState {
+    hasError: boolean;
+    resetKey: string | undefined;
+    failedKeys: string[];
+}
+/**
+ * Contains React render/lifecycle errors in SDK UI so they cannot unmount the
+ * host app tree. Event handlers and async work are not covered — those use
+ * {@link isolateSync} / {@link isolateAsync}.
+ */
+export declare class SdkErrorBoundary extends React.Component<SdkErrorBoundaryProps, SdkErrorBoundaryState> {
+    state: SdkErrorBoundaryState;
+    static getDerivedStateFromError(): Partial<SdkErrorBoundaryState>;
+    static getDerivedStateFromProps(props: SdkErrorBoundaryProps, state: SdkErrorBoundaryState): Partial<SdkErrorBoundaryState> | null;
+    componentDidCatch(error: Error, info: React.ErrorInfo): void;
+    render(): React.ReactNode;
+}
+export {};
+//# sourceMappingURL=SdkErrorBoundary.d.ts.map

package/lib/typescript/module/src/runtime/SdkErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SdkErrorBoundary.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/SdkErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,UAAU,qBAAqB;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,KAAK,CAAC,SAAS,CACnD,qBAAqB,EACrB,qBAAqB,CACtB;IACU,KAAK,EAAE,qBAAqB,CAInC;IAEF,MAAM,CAAC,wBAAwB,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAIjE,MAAM,CAAC,wBAAwB,CAC7B,KAAK,EAAE,qBAAqB,EAC5B,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,qBAAqB,CAAC,GAAG,IAAI;IAW/B,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI;IAY5D,MAAM,IAAI,KAAK,CAAC,SAAS;CAMnC"}

package/lib/typescript/module/src/runtime/TargetPressBridge.d.ts

@@ -9,7 +9,8 @@ export interface TargetPressBridgeProps {
  *
  * The Userflow overlay is a sibling above the app, so hole Pressables would
  * intercept presses. Instead we hit-test bubbled `onTouchStart` / `onTouchEnd`
- * against the rect registered by {@link TooltipSurface}.
+ * against the rect registered by {@link TooltipSurface}, and — while an
+ * element click condition is tracked — against the fiber under the finger.
  *
  * Preview-chrome double taps are observed by `DoubleTapBridge` around the
  * whole provider tree — this bridge never sees overlay touches.

package/lib/typescript/module/src/runtime/TargetPressBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TargetPressBridge.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/TargetPressBridge.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE,sBAAsB,GAAG,KAAK,CAAC,YAAY,CAoC1F"}
+{"version":3,"file":"TargetPressBridge.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/TargetPressBridge.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAU/B,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE,sBAAsB,GAAG,KAAK,CAAC,YAAY,CAuD1F"}

package/lib/typescript/module/src/runtime/UserflowOverlay.d.ts

@@ -0,0 +1,15 @@
+import type { BannerSessionEngine, FlowSessionEngine } from '@userflow-tech/core';
+import * as React from 'react';
+export interface UserflowOverlayProps {
+    engine: FlowSessionEngine;
+    bannerEngine: BannerSessionEngine;
+    /** Keep the host a11y trap in the provider (outside this error boundary). */
+    onTrapChange: (trap: boolean) => void;
+}
+/**
+ * SDK overlay chrome: preview banner, active flow surface, element picker.
+ * Mounted inside {@link SdkErrorBoundary} so a render throw here cannot
+ * unmount host children of {@link UserflowProvider}.
+ */
+export declare function UserflowOverlay({ engine, bannerEngine, onTrapChange, }: UserflowOverlayProps): React.ReactElement;
+//# sourceMappingURL=UserflowOverlay.d.ts.map

package/lib/typescript/module/src/runtime/UserflowOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserflowOverlay.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/UserflowOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAe/B,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,YAAY,EAAE,mBAAmB,CAAC;IAClC,6EAA6E;IAC7E,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACvC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,YAAY,EACZ,YAAY,GACb,EAAE,oBAAoB,GAAG,KAAK,CAAC,YAAY,CAqF3C"}

package/lib/typescript/module/src/runtime/UserflowProvider.d.ts

@@ -1,12 +1,14 @@
-import type { FlowSessionEngine } from '@userflow-tech/core';
+import type { BannerSessionEngine, FlowSessionEngine } from '@userflow-tech/core';
 import * as React from 'react';
 export interface UserflowContextValue {
     engine: FlowSessionEngine;
 }
 export interface UserflowProviderProps {
     children: React.ReactNode;
-    /** Override the module singleton engine (tests). */
+    /** Override the module singleton tour engine (tests). */
     engine?: FlowSessionEngine;
+    /** Override the module singleton banner engine (tests). */
+    bannerEngine?: BannerSessionEngine;
 }
 /**
  * Mount once at the application root, above the navigation container
@@ -19,6 +21,10 @@ export interface UserflowProviderProps {
  * We deliberately do not use RN `<Modal>` — it is the wrong primitive for
  * non-modal tooltips (WS6).
  *
+ * Overlay render errors are contained by {@link SdkErrorBoundary}; host
+ * children are never inside that boundary. See
+ * `packages/react-native/docs/isolation.md`.
+ *
  * **Expo Router:** also mount `UserflowExpoRouterScreenTracker` from
  * `@userflow-tech/react-native/expo-router` under this provider so pathname and
  * navigation-state changes and path-like NAVIGATE actions are wired. The tracker
@@ -28,7 +34,7 @@ export interface UserflowProviderProps {
  * **React Navigation:** wrap `NavigationContainer` with
  * {@link WithUserflowReactNavigation} from `@userflow-tech/react-native/navigation`.
  */
-export declare function UserflowProvider({ children, engine: engineProp, }: UserflowProviderProps): React.ReactElement;
+export declare function UserflowProvider({ children, engine: engineProp, bannerEngine: bannerEngineProp, }: UserflowProviderProps): React.ReactElement;
 /** Access the flow session engine from inside {@link UserflowProvider}. */
 export declare function useUserflow(): UserflowContextValue;
 //# sourceMappingURL=UserflowProvider.d.ts.map

package/lib/typescript/module/src/runtime/UserflowProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UserflowProvider.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/UserflowProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAmB/B,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAID,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,oDAAoD;IACpD,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,MAAM,EAAE,UAAU,GACnB,EAAE,qBAAqB,GAAG,KAAK,CAAC,YAAY,CA2E5C;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,IAAI,oBAAoB,CAMlD"}
+{"version":3,"file":"UserflowProvider.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/UserflowProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AA2B/B,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAID,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,yDAAyD;IACzD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,2DAA2D;IAC3D,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AA0CD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE,gBAAgB,GAC/B,EAAE,qBAAqB,GAAG,KAAK,CAAC,YAAY,CAoF5C;AAoBD,2EAA2E;AAC3E,wBAAgB,WAAW,IAAI,oBAAoB,CAMlD"}

package/lib/typescript/module/src/runtime/bannerEngine.d.ts

@@ -0,0 +1,12 @@
+import { BannerSessionEngine, type UserflowCore } from '@userflow-tech/core';
+/** Build (once) the module-level banner session engine over a {@link UserflowCore} transport. */
+export declare function getBannerSessionEngine(core: UserflowCore): BannerSessionEngine;
+/** Subscribe the engine to inbound server messages. Call after identify. */
+export declare function attachBannerSessionEngine(core: UserflowCore): BannerSessionEngine;
+/** Clear the banner session and detach. Call from {@link Userflow.reset}. */
+export declare function resetBannerSessionEngine(): void;
+/** Drop the local banner without detaching (preview exit, user switch). */
+export declare function clearBannerSessionEngineLocalSession(): void;
+/** Test helper: drop the singleton so the next get recreates it. */
+export declare function __resetBannerSessionEngineForTests(): void;
+//# sourceMappingURL=bannerEngine.d.ts.map

package/lib/typescript/module/src/runtime/bannerEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bannerEngine.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/bannerEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAU7E,iGAAiG;AACjG,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,YAAY,GAAG,mBAAmB,CAoB9E;AAED,4EAA4E;AAC5E,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,YAAY,GAAG,mBAAmB,CAIjF;AAED,6EAA6E;AAC7E,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED,2EAA2E;AAC3E,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D;AAED,oEAAoE;AACpE,wBAAgB,kCAAkC,IAAI,IAAI,CAGzD"}

package/lib/typescript/module/src/runtime/bannerEngineContext.d.ts

@@ -0,0 +1,5 @@
+import type { BannerSessionEngine } from '@userflow-tech/core';
+import * as React from 'react';
+/** Banner engine for host slots. Null outside {@link UserflowProvider}. */
+export declare const BannerEngineContext: React.Context<BannerSessionEngine | null>;
+//# sourceMappingURL=bannerEngineContext.d.ts.map

package/lib/typescript/module/src/runtime/bannerEngineContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bannerEngineContext.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/bannerEngineContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,2CAAwD,CAAC"}

package/lib/typescript/module/src/runtime/bannerPlacement.d.ts

@@ -0,0 +1,12 @@
+import type { BannerEmbedMode, BannerFragment } from '@userflow-tech/protocol';
+/** Body-first is the top edge; body-last is the bottom. Element modes use a placeholder. */
+export declare function bannerEdge(mode: BannerEmbedMode | string): 'top' | 'bottom' | null;
+/**
+ * Id of the {@link EmbedBannerPlaceholder} an element-mode banner fills.
+ * Manual selectors use `#welcome-banner` or `welcome-banner`. Body modes
+ * return null so a top/bottom bar never occupies a host slot.
+ */
+export declare function embedBannerPlaceholderId(banner: BannerFragment): string | null;
+export declare function warnBannerOnce(key: string, message: string, warn?: (message: string) => void): void;
+export declare function resetBannerWarningsForTests(): void;
+//# sourceMappingURL=bannerPlacement.d.ts.map

package/lib/typescript/module/src/runtime/bannerPlacement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bannerPlacement.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/bannerPlacement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAM/E,4FAA4F;AAC5F,wBAAgB,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,IAAI,CAIlF;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAG9E;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAmB,GAC7C,IAAI,CAIN;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAElD"}

package/lib/typescript/module/src/runtime/embedBannerRegistry.d.ts

@@ -0,0 +1,5 @@
+/** Record a mounted {@link EmbedBannerPlaceholder}. Returns the unregister function. */
+export declare function registerEmbedBannerPlaceholder(id: string): () => void;
+export declare function hasEmbedBannerPlaceholder(id: string): boolean;
+export declare function resetEmbedBannerPlaceholdersForTests(): void;
+//# sourceMappingURL=embedBannerRegistry.d.ts.map

package/lib/typescript/module/src/runtime/embedBannerRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedBannerRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/embedBannerRegistry.ts"],"names":[],"mappings":"AAIA,wFAAwF;AACxF,wBAAgB,8BAA8B,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,IAAI,CAcrE;AAED,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D"}

package/lib/typescript/module/src/runtime/flowEngine.d.ts

@@ -10,8 +10,32 @@ export declare function resetFlowSessionEngine(): void;
  * Used after a long background when mid-flow resume would be stale.
  */
 export declare function clearFlowSessionEngineLocalSession(): void;
-/** Whether any mid-flow session (live or draft/preview) is currently on screen. */
+/**
+ * Whether a mid-flow session is held (live, draft, or suppressed by Temporarily
+ * Hide). Foreground idle uses this so a hidden session keeps the socket that
+ * can deliver the attribute update which shows it again.
+ */
 export declare function hasActiveFlowSession(): boolean;
+/**
+ * End the current flow on the server if it is a Builder preview draft. The
+ * server restores every active draft on identify, so clearing it locally is
+ * not enough to keep it from returning on the next launch.
+ *
+ * A draft Temporarily Hide is suppressing is still ended. `getFlowSession()`
+ * hides it, but the server will send it again. When exit runs before identify
+ * has delivered the draft, the next draft session is ended when it arrives.
+ * {@link cancelPendingDraftEnd} drops that wait; a new preview must call it
+ * so the preview's own draft is not ended.
+ */
+export declare function endDraftFlowSession(): Promise<void>;
+/** Drop a pending end from {@link endDraftFlowSession}. A new preview calls this. */
+export declare function cancelPendingDraftEnd(): void;
+/**
+ * `userflow.endFlow()` from an Evaluate JavaScript page. Ends the current
+ * session only if one of the page's scripts came from it, so a stale page
+ * cannot end a flow that started later.
+ */
+export declare function endEvalJsFlowSession(sessionIds: ReadonlySet<string>): Promise<void>;
 /** Test helper: drop the singleton so the next get recreates it. */
 export declare function __resetFlowSessionEngineForTests(): void;
 //# sourceMappingURL=flowEngine.d.ts.map

package/lib/typescript/module/src/runtime/flowEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flowEngine.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/flowEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAM3E,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,iBAAiB,CAgB1E;AAED,4EAA4E;AAC5E,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,GAAG,iBAAiB,CAI7E;AAED,qEAAqE;AACrE,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,IAAI,IAAI,CAEzD;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,oEAAoE;AACpE,wBAAgB,gCAAgC,IAAI,IAAI,CAGvD"}
+{"version":3,"file":"flowEngine.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/flowEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAa3E,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,iBAAiB,CAsB1E;AAED,4EAA4E;AAC5E,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,GAAG,iBAAiB,CAI7E;AAED,qEAAqE;AACrE,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,IAAI,IAAI,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQzD;AAED,qFAAqF;AACrF,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C;AAkBD;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzF;AAED,oEAAoE;AACpE,wBAAgB,gCAAgC,IAAI,IAAI,CAIvD"}