@userflow-tech/react-native 0.2.0 → 0.3.0

package/src/surfaces/bannerWebView/buildCustomBannerHtml.ts

@@ -0,0 +1,178 @@
+import { interpolateVariables } from '@userflow-tech/core';
+import type { BannerFragment, BannerSessionFragment } from '@userflow-tech/protocol';
+import { BannerContentLayout } from '@userflow-tech/protocol';
+
+import { buildBootstrapHtml, wrapCode } from '../../evalJs/bootstrap';
+import type { EvalJsContext } from '../../evalJs/types';
+
+import { collectBannerAutoRunEvalCodes } from './bannerAutoRunEvalJs';
+import { bannerThemeStyleAttribute } from './bannerThemeStyles';
+import { BANNER_WEB_FRAME_CSS } from './bannerWebFrameCss';
+import { buttonClassName } from './buttonClassName';
+import { resolveCustomStylesheetUrl } from './resolveCdnHost';
+import { richContentDocToHtml } from './richContentDocToHtml';
+
+function contentLayoutClass(layout: BannerContentLayout): string {
+  switch (layout) {
+    case BannerContentLayout.CENTER:
+      return 'userflowjs-banner-root--content-layout-CENTER';
+    case BannerContentLayout.SPACE_BETWEEN:
+      return 'userflowjs-banner-root--content-layout-SPACE_BETWEEN';
+    case BannerContentLayout.START:
+    default:
+      return 'userflowjs-banner-root--content-layout-START';
+  }
+}
+
+function layoutMeasureScript(): string {
+  return `
+(function(){
+  function postLayout(){
+    var root=document.querySelector('.userflowjs-banner-root');
+    if(!root||!window.ReactNativeWebView||!window.ReactNativeWebView.postMessage)return;
+    var rectH=root.getBoundingClientRect().height;
+    var scrollH=root.scrollHeight;
+    var h=Math.ceil(Math.max(scrollH,rectH));
+    var vh=window.innerHeight||0;
+    if(vh>0&&h>=vh-2){
+      var sum=0;
+      for(var i=0;i<root.childNodes.length;i++){
+        var node=root.childNodes[i];
+        if(node&&node.nodeType===1){
+          var el=node;
+          sum+=el.scrollHeight||el.offsetHeight||0;
+        }
+      }
+      if(sum>0&&sum<h) h=Math.ceil(sum);
+    }
+    window.ReactNativeWebView.postMessage(JSON.stringify({__userflow:1,type:'bannerLayout',height:h}));
+  }
+  window.__userflowBannerLayout=postLayout;
+  if(typeof ResizeObserver!=='undefined'){
+    var root=document.querySelector('.userflowjs-banner-root');
+    if(root){new ResizeObserver(postLayout).observe(root);}
+  }
+  window.addEventListener('load',postLayout);
+  setTimeout(postLayout,0);
+})();
+`;
+}
+
+function bannerInteractionScript(): string {
+  return `
+(function(){
+  function post(msg){
+    if(window.ReactNativeWebView&&window.ReactNativeWebView.postMessage){
+      window.ReactNativeWebView.postMessage(JSON.stringify(Object.assign({__userflow:1},msg)));
+    }
+  }
+  document.addEventListener('click',function(ev){
+    var t=ev.target;
+    if(!t||!t.closest)return;
+    var btn=t.closest('[data-userflow-banner-button]');
+    if(btn){
+      ev.preventDefault();
+      post({type:'bannerButton',buttonId:btn.getAttribute('data-userflow-banner-button')});
+      return;
+    }
+    var close=t.closest('[data-userflow-banner-dismiss]');
+    if(close){
+      ev.preventDefault();
+      window.__userflowBannerEvalDismissed=true;
+      post({type:'bannerDismiss'});
+    }
+  });
+})();
+`;
+}
+
+/** Runs eval-only button scripts once the banner document (and `window.userflow`) exists. */
+function bannerAutoRunEvalScript(
+  banner: BannerFragment,
+  lookupAttribute: (fqn: string) => string | null,
+): string {
+  const codes = collectBannerAutoRunEvalCodes(banner, lookupAttribute);
+  if (codes.length === 0) {
+    return '';
+  }
+  const runs = codes.map((code) => wrapCode(code)).join('');
+  return `
+(function(){
+  if(window.__userflowBannerEvalDismissed||window.__userflowBannerEvalRan)return;
+  window.__userflowBannerEvalRan=true;
+  function run(){
+    if(window.__userflowBannerEvalDismissed)return;
+    ${runs}
+  }
+  if(document.readyState==='loading'){
+    document.addEventListener('DOMContentLoaded',run,{once:true});
+  }else{
+    run();
+  }
+})();
+`;
+}
+
+export interface BuildCustomBannerBodyOptions {
+  /** When true, omit eval-only auto-run (e.g. WebView remount while session is still active). */
+  skipAutoRunEval?: boolean;
+}
+
+export function buildCustomBannerBodyHtml(
+  session: BannerSessionFragment,
+  lookupAttribute: (fqn: string) => string | null,
+  serverEndpoint: string,
+  options?: BuildCustomBannerBodyOptions,
+): string {
+  const banner = session.version.banner as BannerFragment;
+  const theme = session.version.theme;
+  const layoutClass = contentLayoutClass(banner.contentLayout);
+  const themeStyle = bannerThemeStyleAttribute(theme);
+  const customCssUrl = resolveCustomStylesheetUrl(serverEndpoint, theme);
+  const maxInner =
+    banner.maxContentWidth != null ? ` style="max-width:${banner.maxContentWidth}px"` : '';
+  const contentHtml = richContentDocToHtml(banner.content, lookupAttribute);
+  const buttonsHtml = banner.buttons
+    .map((button) => {
+      const label = escapeAttr(interpolateVariables(button.text, lookupAttribute));
+      const classes = escapeAttr(buttonClassName(button.appearance));
+      return `<button type="button" class="${classes}" data-userflow-banner-button="${escapeAttr(button.id)}"><span class="userflowjs-bubble-button-text">${label}</span></button>`;
+    })
+    .join('');
+  const closeHtml = session.version.closeDisabled
+    ? '<div class="userflowjs-banner-start-spacer"></div>'
+    : '<button type="button" class="userflowjs-banner-close userflowjs-button-reset" data-userflow-banner-dismiss="1" aria-label="Dismiss">×</button>';
+
+  const customLink = customCssUrl
+    ? `<link rel="stylesheet" href="${escapeAttr(customCssUrl)}" />`
+    : '';
+
+  return `
+<style>${BANNER_WEB_FRAME_CSS}</style>
+${customLink}
+<div class="userflowjs-banner-root userflowjs-theme-root ${layoutClass}" style="${themeStyle}">
+  <div class="userflowjs-banner-start-spacer"></div>
+  <div class="userflowjs-banner-inner"${maxInner}>
+    <div class="userflowjs-banner-content">${contentHtml}</div>
+    ${buttonsHtml ? `<div class="userflowjs-banner-buttons">${buttonsHtml}</div>` : ''}
+  </div>
+  ${closeHtml}
+</div>
+<script>${layoutMeasureScript()}${bannerInteractionScript()}${options?.skipAutoRunEval ? '' : bannerAutoRunEvalScript(banner, lookupAttribute)}</script>
+`;
+}
+
+export function buildCustomBannerHtml(
+  context: EvalJsContext,
+  session: BannerSessionFragment,
+  lookupAttribute: (fqn: string) => string | null,
+  serverEndpoint: string,
+  options?: BuildCustomBannerBodyOptions,
+): string {
+  const body = buildCustomBannerBodyHtml(session, lookupAttribute, serverEndpoint, options);
+  return buildBootstrapHtml(context, body);
+}
+
+function escapeAttr(value: string): string {
+  return value.replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;');
+}

package/src/surfaces/bannerWebView/buttonClassName.ts

@@ -0,0 +1,15 @@
+/** Mirrors web `TreeDoc.buttonClassName`. */
+export function buttonClassName(appearance: string | null | undefined): string {
+  const value = appearance || 'default';
+  const known =
+    value === 'primary' ||
+    value === 'PRIMARY' ||
+    value === 'default' ||
+    value === 'DEFAULT' ||
+    value === 'banner-primary' ||
+    value === 'banner-secondary';
+  return (
+    'userflowjs-bubble-button ' +
+    (known ? `userflowjs-bubble-button--${value.toLowerCase()}` : value)
+  );
+}

package/src/surfaces/bannerWebView/resolveCdnHost.ts

@@ -0,0 +1,47 @@
+import type { ThemeFragment } from '@userflow-tech/protocol';
+
+/**
+ * Map the end-user websocket host to the theme stylesheet CDN host
+ * (same convention as web userflow.js).
+ */
+export function resolveCdnHost(serverEndpoint: string): string {
+  const trimmed = serverEndpoint.replace(/\/$/, '');
+  let host = trimmed;
+  if (host.startsWith('https://')) {
+    host = host.slice('https://'.length);
+  } else if (host.startsWith('http://')) {
+    host = host.slice('http://'.length);
+  }
+  if (host.startsWith('e.')) {
+    return `cdn.${host.slice(2)}`;
+  }
+  if (host.includes('localhost') || host.includes('127.0.0.1')) {
+    return 'cdn.userflow.com';
+  }
+  return `cdn.${host}`;
+}
+
+export function themePublishedCssVersion(theme: ThemeFragment): string | null {
+  const cssVersion = theme.cssVersion;
+  if (typeof cssVersion !== 'string' && typeof cssVersion !== 'number') {
+    return null;
+  }
+  const version = String(cssVersion);
+  return version ? version : null;
+}
+
+export function themeHasPublishedCustomCss(theme: ThemeFragment): boolean {
+  return themePublishedCssVersion(theme) != null;
+}
+
+export function resolveCustomStylesheetUrl(
+  serverEndpoint: string,
+  theme: ThemeFragment,
+): string | null {
+  const version = themePublishedCssVersion(theme);
+  if (!version) {
+    return null;
+  }
+  const cdnHost = resolveCdnHost(serverEndpoint);
+  return `https://${cdnHost}/themes/${theme.id}/stylesheets/${version}/custom.css`;
+}

package/src/surfaces/bannerWebView/richContentDocToHtml.ts

@@ -0,0 +1,99 @@
+import { interpolateVariables } from '@userflow-tech/core';
+
+import {
+  deserializeRichContentDoc,
+  isText,
+  stringifyPlaintextDoc,
+} from '../../content/deserialize';
+import type {
+  LookupAttribute,
+  RichContentBlockElement,
+  RichContentDoc,
+  RichContentInlineNode,
+} from '../../content/types';
+
+function escapeHtml(text: string): string {
+  return text
+    .replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;');
+}
+
+function inlineNodesToHtml(
+  nodes: RichContentInlineNode[],
+  lookupAttribute: LookupAttribute,
+): string {
+  let html = '';
+  for (const node of nodes) {
+    if (isText(node)) {
+      let text = node.text;
+      if (node.silent) {
+        continue;
+      }
+      text = interpolateVariables(text, lookupAttribute);
+      let chunk = escapeHtml(text);
+      if (node.bold) {
+        chunk = `<strong>${chunk}</strong>`;
+      }
+      if (node.italic) {
+        chunk = `<em>${chunk}</em>`;
+      }
+      if (node.underline) {
+        chunk = `<u>${chunk}</u>`;
+      }
+      if (node.code) {
+        chunk = `<code>${chunk}</code>`;
+      }
+      html += chunk;
+      continue;
+    }
+    if (node.type === 'link') {
+      const href = escapeHtml(stringifyPlaintextDoc(node.href, { lookupAttribute }));
+      const inner = inlineNodesToHtml(node.children, lookupAttribute);
+      const target = node.target === 'new' ? ' target="_blank" rel="noopener noreferrer"' : '';
+      html += `<a href="${href}"${target}>${inner}</a>`;
+      continue;
+    }
+    if (node.type === 'attribute') {
+      const value = lookupAttribute(node.attributeName ?? '') ?? node.fallback ?? '';
+      html += escapeHtml(value);
+    }
+  }
+  return html;
+}
+
+function blockToHtml(node: RichContentBlockElement, lookupAttribute: LookupAttribute): string {
+  switch (node.type) {
+    case 'paragraph':
+      return `<p>${inlineNodesToHtml(node.children, lookupAttribute)}</p>`;
+    case 'heading1':
+      return `<h1>${inlineNodesToHtml(node.children, lookupAttribute)}</h1>`;
+    case 'heading2':
+      return `<h2>${inlineNodesToHtml(node.children, lookupAttribute)}</h2>`;
+    case 'quote':
+      return `<blockquote>${inlineNodesToHtml(node.children, lookupAttribute)}</blockquote>`;
+    case 'unordered-list':
+      return `<ul>${node.children.map((item) => `<li>${inlineNodesToHtml(item.children, lookupAttribute)}</li>`).join('')}</ul>`;
+    case 'ordered-list':
+      return `<ol>${node.children.map((item) => `<li>${inlineNodesToHtml(item.children, lookupAttribute)}</li>`).join('')}</ol>`;
+    case 'code-block':
+      return `<pre><code>${inlineNodesToHtml(node.children, lookupAttribute)}</code></pre>`;
+    case 'container': {
+      const extra = node.className ? ` ${escapeHtml(node.className)}` : '';
+      const inner = node.children.map((child) => blockToHtml(child, lookupAttribute)).join('');
+      return `<div class="p-like${extra}">${inner}</div>`;
+    }
+    default:
+      return '';
+  }
+}
+
+export function richContentDocToHtml(
+  content: string | RichContentDoc | null | undefined,
+  lookupAttribute: LookupAttribute,
+): string {
+  const doc =
+    typeof content === 'string' || content == null ? deserializeRichContentDoc(content) : content;
+  return doc.children.map((block) => blockToHtml(block, lookupAttribute)).join('');
+}

package/src/surfaces/resolveBannerTheme.ts

@@ -0,0 +1,18 @@
+import type { ThemeFragment } from '@userflow-tech/protocol';
+
+/** Default banner chrome when theme banner tokens are unset (matches product / web debugger palette). */
+export const DEFAULT_BANNER_BACKGROUND_COLOR = '#0A1A24';
+export const DEFAULT_BANNER_FOREGROUND_COLOR = '#FFFFFF';
+
+function readThemeColor(theme: ThemeFragment, key: string): string | undefined {
+  const value = theme[key];
+  return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
+}
+
+export function resolveBannerBackgroundColor(theme: ThemeFragment): string {
+  return readThemeColor(theme, 'bannerBackgroundColor') ?? DEFAULT_BANNER_BACKGROUND_COLOR;
+}
+
+export function resolveBannerForegroundColor(theme: ThemeFragment): string {
+  return readThemeColor(theme, 'bannerForegroundColor') ?? DEFAULT_BANNER_FOREGROUND_COLOR;
+}

package/src/surfaces/safeArea.ts

@@ -1,3 +1,5 @@
+import type { Context } from 'react';
+
 export interface EdgeInsets {
   top: number;
   right: number;
@@ -10,6 +12,7 @@ const ZERO_INSETS: EdgeInsets = { top: 0, right: 0, bottom: 0, left: 0 };
 type UseSafeAreaInsetsFn = () => EdgeInsets;
 
 let cachedHook: UseSafeAreaInsetsFn | null | undefined;
+let cachedInsetsContext: Context<EdgeInsets | null> | null | undefined;
 
 /**
  * Resolve `useSafeAreaInsets` from the optional peer `react-native-safe-area-context`.
@@ -42,7 +45,33 @@ export function useUserflowSafeAreaInsets(): EdgeInsets {
   return resolveUseSafeAreaInsets()();
 }
 
+/**
+ * `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 {
+  if (cachedInsetsContext !== undefined) return cachedInsetsContext;
+
+  if (typeof require !== 'function') {
+    cachedInsetsContext = null;
+    return null;
+  }
+
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const mod = require('react-native-safe-area-context') as {
+      SafeAreaInsetsContext?: Context<EdgeInsets | null>;
+    };
+    cachedInsetsContext = mod.SafeAreaInsetsContext ?? null;
+  } catch {
+    cachedInsetsContext = null;
+  }
+
+  return cachedInsetsContext;
+}
+
 /** @internal */
 export function resetSafeAreaInsetsCacheForTests(): void {
   cachedHook = undefined;
+  cachedInsetsContext = undefined;
 }

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.0';

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/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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"}