@active-reach/web-sdk 1.27.3 → 1.29.0

package/dist/index.js

@@ -1,5 +1,5 @@
-import { S as Storage, l as logger, A as Aegis } from "./analytics-0p0p56H0.mjs";
-import { B, E, N, R, U, m } from "./analytics-0p0p56H0.mjs";
+import { S as Storage, l as logger, A as Aegis } from "./analytics-CCDZCnut.mjs";
+import { B, E, N, R, U, m } from "./analytics-CCDZCnut.mjs";
 import { AegisWebPush } from "./push/AegisWebPush.js";
 function debounce(func, wait) {
   let timeoutId = null;
@@ -25,6 +25,94 @@ function throttle(func, limit) {
     }
   };
 }
+const PDP_SKU_RE = /\/p\/([^/?#]+)/;
+function parseAction(actionUrl, meta) {
+  const url = (actionUrl ?? "").trim();
+  const m2 = meta ?? {};
+  if (url.startsWith("aegis://")) {
+    const rest = url.slice("aegis://".length);
+    const [verb, qs] = rest.split("?");
+    const params = new URLSearchParams(qs || "");
+    switch (verb) {
+      case "dismiss":
+        return { type: "dismiss" };
+      case "request-push":
+      case "request_push":
+        return { type: "request_push" };
+      case "cart-add":
+      case "add-to-cart":
+        return {
+          type: "add_to_cart",
+          sku: params.get("sku") || m2.sku || void 0,
+          productId: params.get("product_id") || m2.product_id || void 0,
+          platformProductId: m2.platform_product_id,
+          qty: Number(params.get("qty")) || 1,
+          title: m2.title,
+          price: m2.price,
+          imageUrl: m2.image_url,
+          url: m2.platform_url
+        };
+      case "open-cart":
+      case "cart":
+        return { type: "open_cart" };
+      case "open-login":
+      case "login":
+        return { type: "open_login" };
+      case "open-product":
+      case "product": {
+        const sku = params.get("sku") || m2.sku || void 0;
+        return { type: "open_product", sku, productId: m2.product_id, url: sku ? `/p/${sku}` : void 0 };
+      }
+      default:
+        return { type: "custom", name: verb || "unknown", payload: Object.fromEntries(params) };
+    }
+  }
+  const pdp = PDP_SKU_RE.exec(url);
+  if (pdp) {
+    return {
+      type: "open_product",
+      sku: decodeURIComponent(pdp[1]),
+      productId: m2.product_id,
+      url,
+      platformProductId: m2.platform_product_id,
+      platformUrl: m2.platform_url
+    };
+  }
+  if (url) {
+    return { type: "navigate", url };
+  }
+  if (m2.sku || m2.product_id) {
+    return {
+      type: "add_to_cart",
+      sku: m2.sku,
+      productId: m2.product_id,
+      platformProductId: m2.platform_product_id,
+      qty: 1,
+      title: m2.title,
+      price: m2.price,
+      imageUrl: m2.image_url,
+      url: m2.platform_url
+    };
+  }
+  return { type: "dismiss" };
+}
+function fallbackUrlForAction(a, productUrl = (sku) => `/p/${encodeURIComponent(sku)}`) {
+  switch (a.type) {
+    case "navigate":
+      return a.url;
+    case "open_product":
+      return a.url || (a.sku ? productUrl(a.sku) : void 0);
+    case "add_to_cart":
+      return a.url || (a.sku ? productUrl(a.sku) : void 0);
+    case "open_cart":
+      return "/cart";
+    case "open_login":
+      return void 0;
+    // host-only; no neutral fallback
+    default:
+      return void 0;
+  }
+}
 const ICONS = {
   x: [
     ["path", { d: "M18 6 6 18" }],
@@ -943,6 +1031,7 @@ function renderCardFromTemplate(card, opts) {
   const fg = contrastFg(frame.bg ? sanitizeColor(frame.bg) : "#ffffff");
   const muted = fg === "#ffffff" ? "rgba(255,255,255,0.72)" : "#6b7280";
   const tile = document.createElement("div");
+  tile.setAttribute("data-aegis-reaction-anchor", "");
   const cardFont = resolveCardFont(frame.fontFamily);
   ensureCardFontLoaded(cardFont);
   const radius = frame.radius !== void 0 ? `${parseInt(String(frame.radius), 10) || 12}px` : "12px";
@@ -957,7 +1046,7 @@ function renderCardFromTemplate(card, opts) {
     background:${frame.bg ? sanitizeColor(frame.bg) : "#ffffff"};
     border:1px solid ${frame.border ? sanitizeColor(frame.border) : "transparent"};
     border-radius:${radius}; padding:8px;
-    ${fLayout === "row" ? "" : "box-shadow:0 2px 10px rgba(0,0,0,0.12);"}
+    ${fLayout === "row" ? "" : "box-shadow:0 4px 16px rgba(0,0,0,0.18);"}
     ${frame.max_width ? `max-width:${frame.max_width}px;` : ""}${frame.min_width ? `min-width:${frame.min_width}px;` : ""}
     ${frame.height ? `height:${frame.height}px;` : ""}${frame.min_height ? `min-height:${frame.min_height}px;` : ""}
     ${sizing}
@@ -1123,15 +1212,30 @@ function renderCardFromTemplate(card, opts) {
             e.stopPropagation();
             trackEvent(campaign.id, "clicked", { stepId: el.id || "add" });
             if (inline) {
-              if (typeof window !== "undefined") {
+              const m2 = meta;
+              if (ctx.dispatchAction) {
+                ctx.dispatchAction({
+                  type: "add_to_cart",
+                  productId: m2.product_id,
+                  sku: m2.sku,
+                  // Platform-native id (catalog-sync C.2) — plugins use this for a
+                  // native add; undefined today → graceful product-search fallback.
+                  platformProductId: m2.platform_product_id,
+                  title: card.title,
+                  price: m2.price ?? card.body,
+                  imageUrl: card.image_url,
+                  url: m2.platform_url || card.cta_url,
+                  qty: 1
+                });
+              } else if (typeof window !== "undefined") {
                 window.dispatchEvent(
                   new CustomEvent("aegis:add-to-cart", {
                     detail: {
                       campaign_id: campaign.id,
-                      product_id: meta.product_id,
-                      sku: meta.sku,
+                      product_id: m2.product_id,
+                      sku: m2.sku,
                       title: card.title,
-                      price: meta.price ?? card.body,
+                      price: m2.price ?? card.body,
                       image_url: card.image_url,
                       cta_url: card.cta_url
                     }
@@ -1156,13 +1260,23 @@ function renderCardFromTemplate(card, opts) {
     e.stopPropagation();
     trackEvent(campaign.id, "clicked");
     if (inline) {
-      if (typeof window !== "undefined") {
+      const bm = meta;
+      if (ctx.dispatchAction) {
+        ctx.dispatchAction({
+          type: "open_product",
+          productId: bm.product_id,
+          sku: bm.sku,
+          url: bm.platform_url || card.cta_url,
+          platformProductId: bm.platform_product_id,
+          platformUrl: bm.platform_url
+        });
+      } else if (typeof window !== "undefined") {
         window.dispatchEvent(
           new CustomEvent("aegis:open-product", {
             detail: {
               campaign_id: campaign.id,
-              product_id: meta.product_id,
-              sku: meta.sku,
+              product_id: bm.product_id,
+              sku: bm.sku,
               cta_url: card.cta_url
             }
           })
@@ -1256,7 +1370,8 @@ function renderCarouselCards(ctx) {
   track.style.cssText = `
     display: flex; gap: 10px; overflow-x: auto; scroll-snap-type: x proximity;
     scroll-padding-left: 0; scrollbar-width: none; -ms-overflow-style: none;
-    padding-bottom: 4px; -webkit-overflow-scrolling: touch;
+    /* room so overflow-x: auto doesn't clip the card drop-shadow */
+    padding: 8px 6px 16px; margin: -8px -6px -6px; -webkit-overflow-scrolling: touch;
   `;
   track.style.msOverflowStyle = "none";
   const template = resolveGlobalTemplate(ic);
@@ -1921,12 +2036,12 @@ function renderProductRecommendation(ctx) {
   if (layout === "row") {
     grid.style.cssText = `
       display: flex; gap: 10px; overflow-x: auto;
-      scroll-snap-type: x mandatory; padding: 14px 0 4px;
+      scroll-snap-type: x mandatory; padding: 14px 2px 18px;
     `;
   } else {
     grid.style.cssText = `
       display: grid; grid-template-columns: repeat(2, 1fr); gap: 10px;
-      padding-top: 14px;
+      padding: 14px 2px 6px;
     `;
   }
   cards.forEach((c) => {
@@ -1985,7 +2100,7 @@ function renderProductRecommendationInline(ctx, target) {
   } else {
     grid.style.cssText = `
       display: flex; gap: 10px; overflow-x: auto;
-      scroll-snap-type: x proximity; padding: 0 0 6px;
+      scroll-snap-type: x proximity; padding: 10px 8px 18px; margin: -8px -8px -6px;
       -webkit-overflow-scrolling: touch; scrollbar-width: none;
     `;
     grid.style.msOverflowStyle = "none";
@@ -4921,6 +5036,7 @@ function svgNode(svg) {
 }
 const _AegisInAppManager = class _AegisInAppManager {
   constructor(config) {
+    this.productUrl = (sku) => `/p/${encodeURIComponent(sku)}`;
     this.campaigns = [];
     this.displayedCampaigns = /* @__PURE__ */ new Set();
     this._displaySizeMul = 1;
@@ -4950,6 +5066,8 @@ const _AegisInAppManager = class _AegisInAppManager {
     this.debugMode = config.debugMode || false;
     this.enableSSE = config.enableSSE === true;
     this.onInteractiveCampaign = config.onInteractiveCampaign;
+    this.onActionHandler = config.onAction;
+    if (config.productUrl) this.productUrl = config.productUrl;
     this.getWorkspaceId = config.getWorkspaceId;
     this.getCartState = config.getCartState;
   }
@@ -6115,8 +6233,8 @@ const _AegisInAppManager = class _AegisInAppManager {
           void this.trackEvent(campaign.id, "clicked");
           if (actionUrl) {
             window.open(actionUrl, "_blank", "noopener");
-          } else if (typeof window !== "undefined") {
-            window.dispatchEvent(new CustomEvent("aegis:open-login", { detail: { campaign_id: campaign.id } }));
+          } else {
+            this.dispatchAction({ type: "open_login" }, campaign.id);
           }
         });
         row.appendChild(btn);
@@ -7790,6 +7908,7 @@ const _AegisInAppManager = class _AegisInAppManager {
       },
       sanitizeUrl: (url) => this.sanitizeUrl(url),
       navigate: (url, buttonId) => this.navigateToCampaignAction(campaign, url, buttonId),
+      dispatchAction: (action) => this.dispatchAction(action, campaign.id),
       submitResponse: (responseType, payload) => this.submitWidgetResponse(campaign, responseType, payload),
       playReaction: (el, intent, lottieFile, scope) => this._playReaction(el, intent, lottieFile, campaign.interactive_config, scope),
       haptic: (pattern) => {
@@ -8565,13 +8684,79 @@ const _AegisInAppManager = class _AegisInAppManager {
       window.location.href = safeUrl;
     }
   }
+  /** Register/replace the canonical CTA-action handler after construction (the
+   *  config `onAction` is the construct-time equivalent). Idempotent. */
+  setOnAction(handler) {
+    this.onActionHandler = handler;
+  }
+  /**
+   * Canonical CTA-action dispatcher (CANONICAL_ACTION_MODEL_TRACKER.md). ONE path
+   * for every host-facing CTA action:
+   *   1. give the host's `onAction` handler first refusal (return `true` = handled);
+   *   2. ALSO fire the legacy `aegis:*` DOM event (cancelable) so existing
+   *      listeners (ACS) keep working unchanged during the migration;
+   *   3. if STILL unhandled → canonical fallback (navigate to the product/cart
+   *      page) so a CTA is never a dead no-op (the rail-"Add" 3rd-party gap).
+   * Both add-to-cart paths (card "Add" + the `aegis://cart-add` verb) funnel here,
+   * so they're one behaviour with one legacy event (`aegis:add-to-cart`).
+   */
+  dispatchAction(action, campaignId) {
+    var _a;
+    let handled = false;
+    try {
+      handled = ((_a = this.onActionHandler) == null ? void 0 : _a.call(this, action)) === true;
+    } catch {
+    }
+    if (typeof window !== "undefined") {
+      const legacy = this._legacyEventFor(action, campaignId);
+      if (legacy) {
+        const evt = new CustomEvent(legacy.name, { detail: legacy.detail, cancelable: true });
+        const proceed = window.dispatchEvent(evt);
+        if (!proceed || evt.defaultPrevented) handled = true;
+      }
+    }
+    if (!handled) {
+      const url = fallbackUrlForAction(action, this.productUrl);
+      if (url && typeof window !== "undefined") window.location.href = url;
+    }
+  }
+  /** Back-compat mapping: canonical action → the legacy DOM event hosts listen
+   *  for today. `add_to_cart` always emits `aegis:add-to-cart` (the one ACS
+   *  handles), collapsing the old `aegis:cart-add` divergence. */
+  _legacyEventFor(a, campaignId) {
+    const base = { campaign_id: campaignId };
+    switch (a.type) {
+      case "add_to_cart":
+        return {
+          name: "aegis:add-to-cart",
+          detail: {
+            ...base,
+            product_id: a.productId,
+            sku: a.sku,
+            title: a.title,
+            price: a.price,
+            image_url: a.imageUrl,
+            cta_url: a.url,
+            qty: a.qty ?? 1
+          }
+        };
+      case "open_product":
+        return { name: "aegis:open-product", detail: { ...base, sku: a.sku, product_id: a.productId, url: a.url } };
+      case "open_cart":
+        return { name: "aegis:open-cart", detail: base };
+      case "open_login":
+        return { name: "aegis:open-login", detail: base };
+      default:
+        return null;
+    }
+  }
   /**
    * Phase-2 CTA action verbs (`aegis://<verb>?<params>`). Performs an in-app
    * behaviour instead of navigating. Verbs:
    *   dismiss         — close the message (tracked as dismissed)
    *   request-push    — prompt for web-push permission, then close
-   *   cart-add?sku=X  — dispatch `aegis:cart-add` for the storefront to handle;
-   *                     if unhandled, fall back to the product page
+   *   cart-add?sku=X  — canonical `add_to_cart` action via dispatchAction
+   *                     (cancelable + product-page fallback)
    */
   runCampaignActionVerb(campaign, url) {
     const rest = url.slice("aegis://".length);
@@ -8594,14 +8779,7 @@ const _AegisInAppManager = class _AegisInAppManager {
       case "cart-add": {
         const sku = params.get("sku") || "";
         void this.trackEvent(campaign.id, "clicked", { meta: { verb: "cart-add", sku } });
-        const evt = new CustomEvent("aegis:cart-add", {
-          detail: { sku, qty: 1, campaign_id: campaign.id },
-          cancelable: true
-        });
-        const proceed = window.dispatchEvent(evt);
-        if (proceed && !evt.defaultPrevented && sku) {
-          window.location.href = `/p/${encodeURIComponent(sku)}`;
-        }
+        this.dispatchAction(parseAction(url, { sku }), campaign.id);
         break;
       }
       default:
@@ -9965,7 +10143,8 @@ const _AegisInAppManager = class _AegisInAppManager {
       this.addAnimationStyles();
       const reduce = typeof window !== "undefined" && window.matchMedia && window.matchMedia("(prefers-reduced-motion: reduce)").matches;
       const viewport = scope === "viewport";
-      const anchor = viewport ? document.body : host || document.body;
+      const cardAnchor = !viewport && (host == null ? void 0 : host.closest) ? host.closest("[data-aegis-reaction-anchor]") : null;
+      const anchor = viewport ? document.body : cardAnchor || host || document.body;
       const prevPos = anchor.style.position;
       if (!viewport && (!prevPos || prevPos === "static")) anchor.style.position = "relative";
       const layer = document.createElement("div");
@@ -10004,7 +10183,7 @@ const _AegisInAppManager = class _AegisInAppManager {
       g.style.cssText = `position: absolute; left: 50%; top: 50%; transform: translate(-50%, -50%); width: ${px}px; height: ${px}px; display: flex; align-items: center; justify-content: center; line-height: 0; filter: drop-shadow(0 8px 16px rgba(0,0,0,0.30)); ${motion}`;
       layer.appendChild(g);
       anchor.appendChild(layer);
-      if (festive && !reduce) this._fireConfetti(host);
+      if (festive && !reduce) this._fireConfetti(cardAnchor || host);
       const ra = ic && typeof ic === "object" ? ic.reaction_animations : void 0;
       const custom = ra && typeof ra[intent] === "string" ? ra[intent] : void 0;
       const file = custom || lottieFile || spec.file;
@@ -11498,6 +11677,7 @@ class AegisWidgetManager {
     this.onEvent = config.onEvent;
     this.sourcePlatform = config.sourcePlatform;
     this.getWorkspaceId = config.getWorkspaceId;
+    this.onCartDetected = config.onCartDetected;
   }
   updateCSSCustomization(customization) {
     this.cssCustomization = { ...this.cssCustomization, ...customization };
@@ -11609,24 +11789,18 @@ class AegisWidgetManager {
     this.log("AegisWidgets initialized successfully");
   }
   setCartData(cartData) {
+    var _a;
     this.cartData = cartData;
     this.log(`Cart data updated: ${cartData.cart_items.length} items, total: ${cartData.cart_currency} ${cartData.cart_total}`);
+    (_a = this.onCartDetected) == null ? void 0 : _a.call(this, cartData);
   }
   detectPlatformCart() {
-    const shopifyCart = this.normalizeShopifyCart();
-    if (shopifyCart) {
-      this.log("Detected Shopify cart via browser globals");
-      return shopifyCart;
-    }
-    const wooCart = this.normalizeWooCart();
-    if (wooCart) {
-      this.log("Detected WooCommerce cart via injected data");
-      return wooCart;
-    }
-    const magentoCart = this.normalizeMagentoCart();
-    if (magentoCart) {
-      this.log("Detected Magento cart via localStorage");
-      return magentoCart;
+    var _a;
+    const detected = this.normalizeShopifyCart() ?? this.normalizeWooCart() ?? this.normalizeMagentoCart();
+    if (detected) {
+      this.log("Detected platform cart (Shopify/Woo/Magento)");
+      (_a = this.onCartDetected) == null ? void 0 : _a.call(this, detected);
+      return detected;
     }
     if (this.cartData) {
       this.log("Using manually set cart data");
@@ -13611,7 +13785,16 @@ class AegisMessageRuntime {
       ownsTriggerEngine,
       enablePrefetch: config.enableWidgetPrefetch !== false,
       sourcePlatform: config.sourcePlatform,
-      getWorkspaceId: config.getWorkspaceId
+      getWorkspaceId: config.getWorkspaceId,
+      // Cart-store unification: when the widget subsystem detects a platform
+      // cart (Shopify/Woo/Magento) or the host calls `widgets.setCartData`, flow
+      // it UP into the ONE cart store so the Free-Delivery card / progress bar /
+      // rule eval see the same cart. See CART_STORE_UNIFICATION_TRACKER.md.
+      onCartDetected: (cart) => this.applyCart({
+        total: cart.cart_total,
+        itemCount: Array.isArray(cart.cart_items) ? cart.cart_items.reduce((s, it) => s + (Number(it.quantity) || 1), 0) : 0,
+        currency: cart.cart_currency
+      })
     });
     this.inApp = new AegisInAppManager({
       writeKey: config.writeKey,
@@ -13631,7 +13814,13 @@ class AegisMessageRuntime {
       getWorkspaceId: config.getWorkspaceId,
       // First-party cart reader — renderers (progress-bar) read live cart
       // state from here instead of `window.*` cart globals. See setCartState().
-      getCartState: () => this.deriveCartState()
+      getCartState: () => this.deriveCartState(),
+      // Canonical CTA-action handler + platform product-URL resolver
+      // (CANONICAL_ACTION_MODEL_TRACKER.md). A host (ACS / Shopify-Woo plugin /
+      // native) registers ONE `onAction` to handle add_to_cart/open_product/…;
+      // legacy `aegis:*` DOM events still fire for back-compat.
+      onAction: config.onAction,
+      productUrl: config.productUrl
     });
     this.intentRuleEvaluator = new IntentRuleEvaluator();
     if (config.governance) {
@@ -13781,11 +13970,42 @@ class AegisMessageRuntime {
    * feed for headless storefronts; prefer `updateContext` for new code.
    */
   setCartState(state) {
-    this.updateContext("cart", {
-      total: state.total,
-      items: state.itemCount,
-      currency: state.currency
-    });
+    this.applyCart(state);
+  }
+  /**
+   * Register the canonical CTA-action handler — the CEP-standard single callback
+   * that receives every in-app intent (add_to_cart / open_product / open_cart /
+   * open_login / navigate / custom). Return `true` when handled; otherwise the SDK
+   * applies the graceful fallback. The construct-time `onAction` config is the
+   * equivalent; this lets a host register/replace it once it holds the runtime.
+   * See CANONICAL_ACTION_MODEL_TRACKER.md.
+   */
+  onAction(handler) {
+    this.inApp.setOnAction(handler);
+  }
+  /**
+   * The ONE cart writer. Normalizes any cart-ish shape and funnels it into the
+   * single `cart` context namespace (read by the Free-Delivery progress card,
+   * the progress-bar widget, and rule eval via the `cart_value` signal). EVERY
+   * cart feed routes through here: ecommerce events (`bindEcommerce`), platform
+   * auto-detect + `widgets.setCartData` (`onCartDetected`), and the explicit
+   * `setCartState` escape hatch. See CART_STORE_UNIFICATION_TRACKER.md.
+   */
+  applyCart(cart) {
+    const total = Number(cart.total) || 0;
+    const itemCount = Number(cart.itemCount ?? cart.items) || 0;
+    const currency = typeof cart.currency === "string" && cart.currency ? cart.currency : "INR";
+    this.updateContext("cart", { total, items: itemCount, currency });
+  }
+  /**
+   * Wire the analytics ecommerce tracker into the cart store — the CEP-standard
+   * path. After this, a host firing `aegis.ecommerce.addToCart(...)` /
+   * `cartViewed(...)` automatically drives every cart-reactive surface; no
+   * separate `setCartState` call is needed. Call once after constructing both
+   * the analytics SDK and the runtime. Idempotent.
+   */
+  bindEcommerce(tracker) {
+    tracker.onCartChange((c) => this.applyCart(c));
   }
   // --- Qualifying-event refresh facade (DLR Tracker 1 / P1, 2026-05-28) ---
   //
@@ -13970,9 +14190,11 @@ export {
   debounce,
   aegis as default,
   deriveDeviceFingerprint,
+  fallbackUrlForAction,
   getCurrentLauncher,
   m as murmurhash3_x86_32,
   openChat,
+  parseAction,
   readFirstPartyCookie,
   renderPreview,
   throttle,