@userflow-tech/react-native 0.2.0 → 0.3.1

package/src/surfaces/safeArea.ts

@@ -1,3 +1,5 @@
+import React, { type Context } from 'react';
+
 export interface EdgeInsets {
   top: number;
   right: number;
@@ -7,42 +9,109 @@ export interface EdgeInsets {
 
 const ZERO_INSETS: EdgeInsets = { top: 0, right: 0, bottom: 0, left: 0 };
 
-type UseSafeAreaInsetsFn = () => EdgeInsets;
-
-let cachedHook: UseSafeAreaInsetsFn | null | undefined;
-
 /**
- * Resolve `useSafeAreaInsets` from the optional peer `react-native-safe-area-context`.
- * Returns a zero-inset hook when the peer is not installed.
+ * Used only when `react-native-safe-area-context` is not installed, so
+ * {@link useUserflowSafeAreaInsets} can call `useContext` unconditionally.
  */
-function resolveUseSafeAreaInsets(): UseSafeAreaInsetsFn {
-  if (cachedHook !== undefined) return cachedHook ?? (() => ZERO_INSETS);
+const FallbackInsetsContext = React.createContext<EdgeInsets | null>(null);
+
+export const MISSING_SAFE_AREA_PROVIDER_WARNING =
+  '[Userflow] UserflowProvider is not inside a <SafeAreaProvider>, so flow cards use the ' +
+  "device's initial safe-area insets. Wrap your app in <SafeAreaProvider> from " +
+  'react-native-safe-area-context.';
+
+interface SafeAreaModule {
+  SafeAreaInsetsContext?: Context<EdgeInsets | null>;
+  initialWindowMetrics?: { insets?: Partial<EdgeInsets> } | null;
+}
+
+let cachedModule: SafeAreaModule | null | undefined;
+let warnedMissingProvider = false;
+
+function loadSafeAreaModule(): SafeAreaModule | null {
+  if (cachedModule !== undefined) return cachedModule;
 
   if (typeof require !== 'function') {
-    cachedHook = null;
-    return () => ZERO_INSETS;
+    cachedModule = null;
+    return null;
   }
 
   try {
     // Optional peer — Expo / React Navigation apps usually have it.
     // eslint-disable-next-line @typescript-eslint/no-var-requires
-    const mod = require('react-native-safe-area-context') as {
-      useSafeAreaInsets?: UseSafeAreaInsetsFn;
-    };
-    cachedHook = typeof mod.useSafeAreaInsets === 'function' ? mod.useSafeAreaInsets : null;
+    const mod = require('react-native-safe-area-context') as SafeAreaModule;
+    cachedModule = mod?.SafeAreaInsetsContext ? mod : null;
   } catch {
-    cachedHook = null;
+    cachedModule = null;
+  }
+
+  return cachedModule;
+}
+
+function copyInsets(insets: Partial<EdgeInsets> | null | undefined): EdgeInsets | null {
+  if (!insets) return null;
+  const top = insets.top;
+  const right = insets.right;
+  const bottom = insets.bottom;
+  const left = insets.left;
+  if (
+    typeof top !== 'number' ||
+    typeof right !== 'number' ||
+    typeof bottom !== 'number' ||
+    typeof left !== 'number'
+  ) {
+    return null;
   }
+  return { top, right, bottom, left };
+}
 
-  return cachedHook ?? (() => ZERO_INSETS);
+/** Device insets from the optional peer, before any provider has measured. */
+function readInitialInsets(): EdgeInsets | null {
+  return copyInsets(loadSafeAreaModule()?.initialWindowMetrics?.insets);
+}
+
+function warnMissingProvider(): void {
+  if (warnedMissingProvider || !__DEV__) return;
+  warnedMissingProvider = true;
+  // eslint-disable-next-line no-console -- intentional missing-provider diagnostic
+  console.warn(MISSING_SAFE_AREA_PROVIDER_WARNING);
+}
+
+/**
+ * Safe-area insets for flow chrome.
+ *
+ * Reads `SafeAreaInsetsContext` directly. `useSafeAreaInsets()` throws when the
+ * peer is installed but no `SafeAreaProvider` is mounted, which would take down
+ * the host tree. A missing provider falls back to `initialWindowMetrics`, then
+ * zero, and warns once in development.
+ */
+function insetsContext(): Context<EdgeInsets | null> {
+  return loadSafeAreaModule()?.SafeAreaInsetsContext ?? FallbackInsetsContext;
+}
+
+/** Value from the nearest provider, or `null` when the peer or provider is absent. */
+export function useParentSafeAreaInsets(): EdgeInsets | null {
+  return copyInsets(React.useContext(insetsContext()));
 }
 
-/** Safe-area insets with a zero fallback when the optional peer is missing. */
 export function useUserflowSafeAreaInsets(): EdgeInsets {
-  return resolveUseSafeAreaInsets()();
+  const fromProvider = useParentSafeAreaInsets();
+  if (fromProvider) return fromProvider;
+  if (!loadSafeAreaModule()) return ZERO_INSETS;
+  warnMissingProvider();
+  return readInitialInsets() ?? ZERO_INSETS;
+}
+
+/**
+ * `SafeAreaInsetsContext` from the optional peer, or `null` when it is not installed.
+ * In-flow banners override this so host screens do not add the inset the banner already consumed.
+ */
+export function getSafeAreaInsetsContext(): Context<EdgeInsets | null> | null {
+  return loadSafeAreaModule()?.SafeAreaInsetsContext ?? null;
 }
 
 /** @internal */
 export function resetSafeAreaInsetsCacheForTests(): void {
-  cachedHook = undefined;
+  cachedModule = undefined;
+  warnedMissingProvider = false;
 }

package/src/version.ts

@@ -1,2 +1,2 @@
 /** Generated by scripts/write-version.mjs — do not edit. */
-export const SDK_VERSION = '0.2.0';
+export const SDK_VERSION = '0.3.1';

package/vendor/core/dist/attributes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../src/attributes.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,kBAAkB,GAAG,OAAO,CAAC;AAE7E,6FAA6F;AAC7F,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,gEAAgE;AAChE,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAczC,kFAAkF;AAClF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAcxF;AAED,qEAAqE;AACrE,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,cAAc,EACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,IAAI,CAQN;AAED,oDAAoD;AACpD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAcvD"}
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../src/attributes.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,kBAAkB,GAAG,OAAO,CAAC;AAE7E,6FAA6F;AAC7F,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,gEAAgE;AAChE,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAczC,kFAAkF;AAClF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAcxF;AAED,qEAAqE;AACrE,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,cAAc,EACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,IAAI,CAQN;AAED,oDAAoD;AACpD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAgBvD"}

package/vendor/core/dist/attributes.js

@@ -36,20 +36,20 @@ export function assertValidAttributeNames(scope, attributes) {
             continue;
         const error = validateAttributeName(scope, name);
         if (error) {
-            throw new UserflowAuthError(error);
+            throw new UserflowAuthError(error, { isHostContract: true });
         }
     }
 }
 /** Throws when the custom event name is invalid. */
 export function assertValidEventName(name) {
     if (!name) {
-        throw new UserflowAuthError('Missing name');
+        throw new UserflowAuthError('Missing name', { isHostContract: true });
     }
     if (!EVENT_NAME_PATTERN.test(name)) {
-        throw new UserflowAuthError('Invalid event name. Event names must consist of only a-z, A-Z, 0-9, underscores, dashes, periods(.), parentheses and spaces.');
+        throw new UserflowAuthError('Invalid event name. Event names must consist of only a-z, A-Z, 0-9, underscores, dashes, periods(.), parentheses and spaces.', { isHostContract: true });
     }
     if (name.length > MAX_EVENT_NAME_LENGTH) {
-        throw new UserflowAuthError(`Event names must not be longer than ${MAX_EVENT_NAME_LENGTH} characters.`);
+        throw new UserflowAuthError(`Event names must not be longer than ${MAX_EVENT_NAME_LENGTH} characters.`, { isHostContract: true });
     }
 }
 //# sourceMappingURL=attributes.js.map

package/vendor/core/dist/attributes.js.map

@@ -1 +1 @@
-{"version":3,"file":"attributes.js","sourceRoot":"","sources":["../src/attributes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAKhD,6FAA6F;AAC7F,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAE7C,gEAAgE;AAChE,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC,MAAM,sBAAsB,GAAG,sBAAsB,CAAC;AAEtD,wFAAwF;AACxF,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AAEjD,MAAM,wBAAwB,GAAwD;IACpF,IAAI,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAChC,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;IACT,gBAAgB,EAAE,EAAE;CACrB,CAAC;AAEF,kFAAkF;AAClF,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACvE,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,qBAAqB,CAAC,KAAqB,EAAE,IAAY;IACvE,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO,GAAG,IAAI,wKAAwK,CAAC;IACzL,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,GAAG,yBAAyB,EAAE,CAAC;QAC5C,OAAO,GAAG,IAAI,6CAA6C,yBAAyB,cAAc,CAAC;IACrG,CAAC;IAED,IAAI,wBAAwB,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,GAAG,IAAI,yDAAyD,CAAC;IAC1E,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,yBAAyB,CACvC,KAAqB,EACrB,UAAmC;IAEnC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC;YAAE,SAAS;QACtE,MAAM,KAAK,GAAG,qBAAqB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACjD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;AACH,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,iBAAiB,CACzB,8HAA8H,CAC/H,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,qBAAqB,EAAE,CAAC;QACxC,MAAM,IAAI,iBAAiB,CACzB,uCAAuC,qBAAqB,cAAc,CAC3E,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"attributes.js","sourceRoot":"","sources":["../src/attributes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAKhD,6FAA6F;AAC7F,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAE7C,gEAAgE;AAChE,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC,MAAM,sBAAsB,GAAG,sBAAsB,CAAC;AAEtD,wFAAwF;AACxF,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AAEjD,MAAM,wBAAwB,GAAwD;IACpF,IAAI,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAChC,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;IACT,gBAAgB,EAAE,EAAE;CACrB,CAAC;AAEF,kFAAkF;AAClF,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACvE,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,qBAAqB,CAAC,KAAqB,EAAE,IAAY;IACvE,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO,GAAG,IAAI,wKAAwK,CAAC;IACzL,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,GAAG,yBAAyB,EAAE,CAAC;QAC5C,OAAO,GAAG,IAAI,6CAA6C,yBAAyB,cAAc,CAAC;IACrG,CAAC;IAED,IAAI,wBAAwB,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,GAAG,IAAI,yDAAyD,CAAC;IAC1E,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,yBAAyB,CACvC,KAAqB,EACrB,UAAmC;IAEnC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC;YAAE,SAAS;QACtE,MAAM,KAAK,GAAG,qBAAqB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACjD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,IAAI,iBAAiB,CAAC,KAAK,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;AACH,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,iBAAiB,CAAC,cAAc,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,iBAAiB,CACzB,8HAA8H,EAC9H,EAAE,cAAc,EAAE,IAAI,EAAE,CACzB,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,qBAAqB,EAAE,CAAC;QACxC,MAAM,IAAI,iBAAiB,CACzB,uCAAuC,qBAAqB,cAAc,EAC1E,EAAE,cAAc,EAAE,IAAI,EAAE,CACzB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/vendor/core/dist/constants.d.ts

@@ -10,6 +10,8 @@
  * default and the transport once Publish lands.
  */
 export declare const DEFAULT_SERVER_ENDPOINT = "https://e.userflow.com";
+/** End-user socket for EU-hosted environments. Pairing stays on the US host. */
+export declare const EU_SERVER_ENDPOINT = "https://e.eu.userflow.com";
 /**
  * US-pinned host for the Builder pairing websocket (`/socket/pairing`).
  * The builder dashboard and pairing PubSub are US-only; do not use a regional

package/vendor/core/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,2BAA2B,CAAC;AAEhE;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,2BAA2B,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,2BAA2B,CAAC;AAEhE,gFAAgF;AAChF,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAE9D;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,2BAA2B,CAAC"}

package/vendor/core/dist/constants.js

@@ -10,6 +10,8 @@
  * default and the transport once Publish lands.
  */
 export const DEFAULT_SERVER_ENDPOINT = 'https://e.userflow.com';
+/** End-user socket for EU-hosted environments. Pairing stays on the US host. */
+export const EU_SERVER_ENDPOINT = 'https://e.eu.userflow.com';
 /**
  * US-pinned host for the Builder pairing websocket (`/socket/pairing`).
  * The builder dashboard and pairing PubSub are US-only; do not use a regional

package/vendor/core/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,wBAAwB,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,wBAAwB,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,wBAAwB,CAAC;AAEhE,gFAAgF;AAChF,MAAM,CAAC,MAAM,kBAAkB,GAAG,2BAA2B,CAAC;AAE9D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,wBAAwB,CAAC"}

package/vendor/core/dist/engine/BannerSessionEngine.d.ts

@@ -0,0 +1,73 @@
+import type { BannerSessionFragment, ClientMessage, EndFlowReasonInput, FlowActionFragment, ServerMessage } from '@userflow-tech/protocol';
+import type { PublicAttributes } from '../types.js';
+import type { FlowActionRunner, HandleActionsDeps } from './handleActions.js';
+/** Narrow transport surface the banner session engine depends on. */
+export interface BannerTransport {
+    send(message: ClientMessage): Promise<void>;
+    onServerMessage(handler: (message: ServerMessage) => void): () => void;
+    setBannerSessionId(bannerSessionId: string | null): void;
+}
+export interface BannerSessionEngineDeps {
+    transport: BannerTransport;
+    /**
+     * Tour engine for actions that are not banner-scoped. `START_FLOW` replaces
+     * the tour; `CLOSE_FLOW` still ends this banner.
+     */
+    flowActions?: () => FlowActionRunner;
+    onOpenExternalUrl?: (url: string) => void;
+    onEvalJs?: HandleActionsDeps['onEvalJs'];
+    updateUser?: (attributes: PublicAttributes) => Promise<void>;
+    updateGroup?: (attributes: PublicAttributes, options?: {
+        membership?: PublicAttributes;
+    }) => Promise<void>;
+    warn?: (message: string) => void;
+}
+/**
+ * One banner session, independent of the tour. Web banners have no session
+ * clock: a later Set replaces the current bar, and Unset clears only a
+ * matching id.
+ */
+export declare class BannerSessionEngine {
+    private readonly transport;
+    private readonly flowActions;
+    private readonly onOpenExternalUrl;
+    private readonly onEvalJs;
+    private readonly updateUserImpl;
+    private readonly updateGroupImpl;
+    private readonly warn;
+    private readonly listeners;
+    private readonly pendingSends;
+    private session;
+    private unsubscribe;
+    private flushingPending;
+    constructor(deps: BannerSessionEngineDeps);
+    attach(): void;
+    detach(): void;
+    on(listener: () => void): () => void;
+    getBannerSession(): BannerSessionFragment | null;
+    handleServerMessage(message: ServerMessage): void;
+    /** Dismiss the banner. Does not touch a tour session held elsewhere. */
+    endBanner(endReason: EndFlowReasonInput): Promise<void>;
+    endFlow(endReason: EndFlowReasonInput): Promise<void>;
+    handleActions(actions: FlowActionFragment[]): Promise<void>;
+    /** Drop the local banner without detaching from transport (preview / user switch). */
+    clearLocalSession(): void;
+    reset(): void;
+    flushPendingSends(): Promise<void>;
+    private actionDeps;
+    private setSession;
+    /**
+     * Banner `CLOSE_FLOW` ends this session. Other actions delegate to the tour
+     * engine when one was provided, so `START_FLOW` replaces the tour.
+     */
+    private actionRunner;
+    private trackButtonEvent;
+    private startFlow;
+    private updateUser;
+    private updateGroup;
+    private beginBatch;
+    private endBatch;
+    private enqueuePendingSend;
+    private sendTracked;
+}
+//# sourceMappingURL=BannerSessionEngine.d.ts.map

package/vendor/core/dist/engine/BannerSessionEngine.d.ts.map

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

package/vendor/core/dist/engine/BannerSessionEngine.js

@@ -0,0 +1,236 @@
+import { handleActions } from './handleActions.js';
+/** Cap for in-memory client-message retry after transport failure. */
+const MAX_PENDING_SENDS = 20;
+function isValidBannerSession(session) {
+    if (session == null || typeof session !== 'object')
+        return false;
+    const candidate = session;
+    if (typeof candidate.id !== 'string' || candidate.id.length === 0)
+        return false;
+    if (candidate.flow == null || typeof candidate.flow.id !== 'string')
+        return false;
+    if (candidate.kind != null && candidate.kind !== 'banner')
+        return false;
+    const banner = candidate.version?.banner;
+    if (banner == null || typeof banner !== 'object')
+        return false;
+    if (typeof banner.embedMode !== 'string')
+        return false;
+    if (!Array.isArray(banner.buttons))
+        return false;
+    return true;
+}
+function normalize(session) {
+    return {
+        ...session,
+        kind: 'banner',
+        draftMode: session.draftMode === true,
+        data: Array.isArray(session.data) ? session.data : [],
+        version: {
+            ...session.version,
+            steps: Array.isArray(session.version.steps) ? session.version.steps : [],
+        },
+    };
+}
+/**
+ * One banner session, independent of the tour. Web banners have no session
+ * clock: a later Set replaces the current bar, and Unset clears only a
+ * matching id.
+ */
+export class BannerSessionEngine {
+    constructor(deps) {
+        this.listeners = new Set();
+        this.pendingSends = [];
+        this.session = null;
+        this.unsubscribe = null;
+        this.flushingPending = false;
+        this.transport = deps.transport;
+        this.flowActions = deps.flowActions;
+        this.onOpenExternalUrl = deps.onOpenExternalUrl;
+        this.onEvalJs = deps.onEvalJs;
+        this.updateUserImpl = deps.updateUser;
+        this.updateGroupImpl = deps.updateGroup;
+        this.warn = deps.warn ?? ((message) => console.warn(message));
+    }
+    attach() {
+        if (this.unsubscribe)
+            return;
+        this.unsubscribe = this.transport.onServerMessage((message) => {
+            this.handleServerMessage(message);
+        });
+    }
+    detach() {
+        this.unsubscribe?.();
+        this.unsubscribe = null;
+    }
+    on(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    getBannerSession() {
+        return this.session;
+    }
+    handleServerMessage(message) {
+        switch (message.kind) {
+            case 'SetBannerSession': {
+                if (!isValidBannerSession(message.session)) {
+                    this.warn('Userflow: ignoring malformed SetBannerSession (missing version.banner)');
+                    return;
+                }
+                this.setSession(normalize(message.session));
+                return;
+            }
+            case 'UnsetBannerSession': {
+                if (this.session?.id === message.sessionId) {
+                    this.setSession(null);
+                }
+                return;
+            }
+            default:
+                return;
+        }
+    }
+    /** Dismiss the banner. Does not touch a tour session held elsewhere. */
+    async endBanner(endReason) {
+        const current = this.session;
+        if (!current)
+            return;
+        const sessionId = current.id;
+        this.setSession(null);
+        await this.sendTracked({
+            kind: 'EndFlow',
+            sessionId,
+            endReason,
+        });
+    }
+    endFlow(endReason) {
+        return this.endBanner(endReason);
+    }
+    handleActions(actions) {
+        const session = this.session;
+        if (!session || actions.length === 0)
+            return Promise.resolve();
+        return handleActions(session, actions, this.actionDeps()).catch((error) => {
+            const detail = error instanceof Error ? error.message : String(error);
+            this.warn(`Userflow: banner actions failed: ${detail}`);
+        });
+    }
+    /** Drop the local banner without detaching from transport (preview / user switch). */
+    clearLocalSession() {
+        this.setSession(null);
+    }
+    reset() {
+        this.detach();
+        this.pendingSends.length = 0;
+        this.setSession(null);
+    }
+    async flushPendingSends() {
+        if (this.flushingPending || this.pendingSends.length === 0)
+            return;
+        this.flushingPending = true;
+        try {
+            while (this.pendingSends.length > 0) {
+                const message = this.pendingSends[0];
+                try {
+                    await this.transport.send(message);
+                    this.pendingSends.shift();
+                }
+                catch {
+                    return;
+                }
+            }
+        }
+        finally {
+            this.flushingPending = false;
+        }
+    }
+    actionDeps() {
+        return {
+            engine: this.actionRunner(),
+            ...(this.onOpenExternalUrl !== undefined
+                ? { onOpenExternalUrl: this.onOpenExternalUrl }
+                : {}),
+            ...(this.onEvalJs !== undefined ? { onEvalJs: this.onEvalJs } : {}),
+            warn: this.warn,
+        };
+    }
+    setSession(session) {
+        this.session = session;
+        this.transport.setBannerSessionId(session?.id ?? null);
+        for (const listener of this.listeners) {
+            listener();
+        }
+    }
+    /**
+     * Banner `CLOSE_FLOW` ends this session. Other actions delegate to the tour
+     * engine when one was provided, so `START_FLOW` replaces the tour.
+     */
+    actionRunner() {
+        const delegated = this.flowActions?.();
+        return {
+            goToStep: async () => {
+                // Banners have no steps. handleActions already no-ops GO_TO_STEP.
+            },
+            endFlow: (endReason) => this.endBanner(endReason),
+            trackButtonEvent: (eventName, token, stepCvid, sessionId) => delegated
+                ? delegated.trackButtonEvent(eventName, token, stepCvid, sessionId)
+                : this.trackButtonEvent(eventName, token, stepCvid, sessionId),
+            startFlow: (options) => (delegated ? delegated.startFlow(options) : this.startFlow(options)),
+            updateUser: (attributes) => delegated ? delegated.updateUser(attributes) : this.updateUser(attributes),
+            updateGroup: (attributes, options) => delegated
+                ? delegated.updateGroup(attributes, options)
+                : this.updateGroup(attributes, options),
+            beginBatch: () => (delegated ? delegated.beginBatch() : this.beginBatch()),
+            endBatch: () => (delegated ? delegated.endBatch() : this.endBatch()),
+        };
+    }
+    async trackButtonEvent(eventName, token, stepCvid, sessionId) {
+        await this.sendTracked({
+            kind: 'TrackButtonEvent',
+            eventName,
+            token,
+            stepCvid,
+            sessionId,
+        });
+    }
+    async startFlow(options) {
+        await this.sendTracked({
+            kind: 'StartFlow',
+            flowId: options.flowId,
+            stepCvid: options.stepCvid,
+            startReason: options.startReason,
+            once: false,
+        });
+    }
+    async updateUser(attributes) {
+        await this.updateUserImpl?.(attributes);
+    }
+    async updateGroup(attributes, options) {
+        await this.updateGroupImpl?.(attributes, options);
+    }
+    async beginBatch() {
+        await this.sendTracked({ kind: 'BeginBatch' });
+    }
+    async endBatch() {
+        await this.sendTracked({ kind: 'EndBatch' });
+    }
+    enqueuePendingSend(message) {
+        if (this.pendingSends.length >= MAX_PENDING_SENDS) {
+            this.pendingSends.shift();
+        }
+        this.pendingSends.push(message);
+    }
+    async sendTracked(message) {
+        try {
+            await this.transport.send(message);
+            void this.flushPendingSends();
+        }
+        catch {
+            this.enqueuePendingSend(message);
+            this.warn(`Userflow: failed to send ${message.kind}; queued for retry on reconnect`);
+        }
+    }
+}
+//# sourceMappingURL=BannerSessionEngine.js.map

package/vendor/core/dist/engine/BannerSessionEngine.js.map

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

package/vendor/core/dist/engine/ClientConditionEngine.d.ts

@@ -6,12 +6,31 @@ export interface ClientConditionTransport {
     onServerMessage(handler: (message: ServerMessage) => void): () => void;
     setClientConditions(clientConditions: JoinPayloadClientCondition[]): void;
 }
+/** Options for one truthiness report from a {@link ConditionEvaluator}. */
+export interface ConditionReportOptions {
+    /**
+     * Send ToggleClientCondition immediately, skipping the trailing debounce.
+     * Used for latched clicks so the toggle is not reordered behind a screen
+     * update caused by the same tap.
+     */
+    immediate?: boolean;
+}
+export type ConditionReport = (isTrue: boolean | null, options?: ConditionReportOptions) => void;
+/**
+ * State handed to an evaluator each time it is bound. `previousIsTrue` is the
+ * value already known to the engine, so a re-attach (same user re-identify)
+ * can restore a latched click instead of reporting the unclicked default.
+ * A fresh track and a re-track after Untrack both pass `null`.
+ */
+export interface ConditionEvaluatorContext {
+    previousIsTrue: boolean | null;
+}
 /**
  * Platform-specific evaluator for one condition type. Calls `report` whenever
  * truthiness changes (including the initial evaluation). Returns an untrack
  * function that tears down listeners. `null` means "unknown / cannot evaluate".
  */
-export type ConditionEvaluator = (condition: FlowConditionFragment, report: (isTrue: boolean | null) => void) => () => void;
+export type ConditionEvaluator = (condition: FlowConditionFragment, report: ConditionReport, context: ConditionEvaluatorContext) => () => void;
 export interface ClientConditionEngineDeps {
     transport: ClientConditionTransport;
     /** Per-type evaluators. Types without an entry stay unknown and warn once. */

package/vendor/core/dist/engine/ClientConditionEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClientConditionEngine.d.ts","sourceRoot":"","sources":["../../src/engine/ClientConditionEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,0BAA0B,EAC1B,aAAa,EACd,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAoB,KAAK,SAAS,EAAoB,MAAM,2BAA2B,CAAC;AAK/F,uEAAuE;AACvE,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,eAAe,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACvE,mBAAmB,CAAC,gBAAgB,EAAE,0BAA0B,EAAE,GAAG,IAAI,CAAC;CAC3E;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,SAAS,EAAE,qBAAqB,EAChC,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,KACrC,MAAM,IAAI,CAAC;AAEhB,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,wBAAwB,CAAC;IACpC,8EAA8E;IAC9E,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,CAAC,CAAC;IACpE,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAWD;;;;;;;;;;GAUG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyD;IACpF,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAE1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0C;IACrE,OAAO,CAAC,yBAAyB,CAA6B;gBAElD,IAAI,EAAE,yBAAyB;IAQ3C;;;OAGG;IACH,MAAM,IAAI,MAAM,IAAI;IAapB;;;OAGG;IACH,MAAM,IAAI,IAAI;IAWd,oEAAoE;IACpE,KAAK,IAAI,IAAI;IASb,yEAAyE;IACzE,WAAW,IAAI,0BAA0B,EAAE;IAO3C,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,oBAAoB;IAiB5B,OAAO,CAAC,sBAAsB;IAS9B,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,MAAM;IA+Cd,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,aAAa;CAMtB"}
+{"version":3,"file":"ClientConditionEngine.d.ts","sourceRoot":"","sources":["../../src/engine/ClientConditionEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,0BAA0B,EAC1B,aAAa,EACd,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAoB,KAAK,SAAS,EAAoB,MAAM,2BAA2B,CAAC;AAK/F,uEAAuE;AACvE,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,eAAe,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACvE,mBAAmB,CAAC,gBAAgB,EAAE,0BAA0B,EAAE,GAAG,IAAI,CAAC;CAC3E;AAED,2EAA2E;AAC3E,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,sBAAsB,KAAK,IAAI,CAAC;AAEjG;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,OAAO,GAAG,IAAI,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,SAAS,EAAE,qBAAqB,EAChC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,yBAAyB,KAC/B,MAAM,IAAI,CAAC;AAEhB,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,wBAAwB,CAAC;IACpC,8EAA8E;IAC9E,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,CAAC,CAAC;IACpE,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAWD;;;;;;;;;;GAUG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyD;IACpF,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAE1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0C;IACrE,OAAO,CAAC,yBAAyB,CAA6B;gBAElD,IAAI,EAAE,yBAAyB;IAQ3C;;;OAGG;IACH,MAAM,IAAI,MAAM,IAAI;IAapB;;;OAGG;IACH,MAAM,IAAI,IAAI;IAWd,oEAAoE;IACpE,KAAK,IAAI,IAAI;IASb,yEAAyE;IACzE,WAAW,IAAI,0BAA0B,EAAE;IAO3C,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,oBAAoB;IAiB5B,OAAO,CAAC,sBAAsB;IAS9B,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,MAAM;IAqDd,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,aAAa;CAMtB"}

package/vendor/core/dist/engine/ClientConditionEngine.js

@@ -121,11 +121,11 @@ export class ClientConditionEngine {
             }
             return;
         }
-        meta.untrack = evaluator(meta.condition, (isTrue) => {
-            this.report(meta.condition.id, isTrue);
-        });
+        meta.untrack = evaluator(meta.condition, (isTrue, reportOptions) => {
+            this.report(meta.condition.id, isTrue, reportOptions);
+        }, { previousIsTrue: meta.isTrue });
     }
-    report(conditionId, isTrue) {
+    report(conditionId, isTrue, options) {
         const meta = this.conditions.get(conditionId);
         if (!meta)
             return;
@@ -141,19 +141,22 @@ export class ClientConditionEngine {
             }
             return;
         }
-        if (meta.isTrue === isTrue && meta.pendingReport === undefined) {
-            return;
-        }
-        // First resolution from unknown: send immediately so gated flows are not
-        // delayed by the remount-churn debounce.
-        if (meta.isTrue === null) {
+        // First resolution from unknown, or an explicit immediate report (a
+        // latched click): send now so a tap is not reordered behind a screen
+        // update caused by the same gesture.
+        if (meta.isTrue === null || options?.immediate) {
             this.clearDebounce(meta);
             meta.pendingReport = undefined;
+            if (meta.isTrue === isTrue)
+                return;
             meta.isTrue = isTrue;
             this.pushSnapshot();
             this.sendToggle(conditionId, isTrue);
             return;
         }
+        if (meta.isTrue === isTrue && meta.pendingReport === undefined) {
+            return;
+        }
         // Subsequent flips: trailing debounce to absorb anchor remount churn.
         meta.pendingReport = isTrue;
         this.clearDebounce(meta);