@active-reach/web-sdk 1.4.0 → 1.5.0

package/dist/index.js

@@ -1,5 +1,5 @@
-import { l as logger, A as Aegis } from "./analytics-D9BAnJAu.mjs";
-import { B, E, N, R, m } from "./analytics-D9BAnJAu.mjs";
+import { l as logger, A as Aegis } from "./analytics-C00PJUSy.mjs";
+import { B, E, N, R, m } from "./analytics-C00PJUSy.mjs";
 import { AegisWebPush } from "./push/AegisWebPush.js";
 function debounce(func, wait) {
   let timeoutId = null;
@@ -25,6 +25,715 @@ function throttle(func, limit) {
     }
   };
 }
+const MAX_CARDS_RENDERED = 10;
+function renderCarouselCards(ctx) {
+  const { campaign, trackEvent, sanitizeUrl, sanitizeColor, log, addAnimationStyles } = ctx;
+  const ic = campaign.interactive_config || {};
+  const rawCards = Array.isArray(ic.cards) ? ic.cards : [];
+  const cards = rawCards.slice(0, MAX_CARDS_RENDERED);
+  if (cards.length === 0) {
+    log("carousel_cards rendered with zero cards — skipping", "warn");
+    return;
+  }
+  const autoplay = Number(ic.autoplay_ms) || 0;
+  const loop = ic.loop !== false;
+  addAnimationStyles();
+  const bg = sanitizeColor(campaign.background_color || "#ffffff");
+  const fg = sanitizeColor(campaign.text_color || "#0f172a");
+  const overlay = document.createElement("div");
+  overlay.className = "aegis-in-app-carousel-overlay";
+  overlay.setAttribute("data-campaign-id", campaign.id);
+  overlay.style.cssText = `
+    position: fixed; left: 0; right: 0; bottom: 0;
+    z-index: 99999; padding: 12px 12px 20px;
+    background: rgba(0,0,0,0.12); backdrop-filter: blur(8px);
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+    animation: aegisSlideInFromBottom 0.3s ease-out;
+  `;
+  const card = document.createElement("div");
+  card.style.cssText = `
+    background: ${bg}; color: ${fg}; border-radius: 16px;
+    box-shadow: 0 8px 20px rgba(0,0,0,0.08); padding: 16px;
+    max-width: 520px; margin: 0 auto; position: relative;
+  `;
+  const header = document.createElement("div");
+  header.style.cssText = "display: flex; justify-content: space-between; align-items: flex-start; gap: 12px; margin-bottom: 12px;";
+  const headerText = document.createElement("div");
+  const title = document.createElement("div");
+  title.textContent = campaign.title;
+  title.style.cssText = "font-weight: 700; font-size: 15px; margin-bottom: 2px;";
+  const body = document.createElement("div");
+  body.textContent = campaign.body;
+  body.style.cssText = "font-size: 13px; opacity: 0.75;";
+  headerText.appendChild(title);
+  headerText.appendChild(body);
+  header.appendChild(headerText);
+  const closeBtn = document.createElement("button");
+  closeBtn.textContent = "✕";
+  closeBtn.setAttribute("aria-label", "Close");
+  closeBtn.style.cssText = `
+    background: transparent; border: none; color: inherit;
+    font-size: 16px; cursor: pointer; opacity: 0.6; padding: 2px 6px;
+  `;
+  closeBtn.addEventListener("click", () => {
+    trackEvent(campaign.id, "dismissed");
+    overlay.remove();
+  });
+  header.appendChild(closeBtn);
+  card.appendChild(header);
+  const track = document.createElement("div");
+  track.style.cssText = `
+    display: flex; gap: 10px; overflow-x: auto; scroll-snap-type: x mandatory;
+    scrollbar-width: none; -ms-overflow-style: none; padding-bottom: 4px;
+  `;
+  track.style.msOverflowStyle = "none";
+  track.addEventListener("wheel", (e) => {
+    if (Math.abs(e.deltaX) < Math.abs(e.deltaY)) return;
+    track.scrollLeft += e.deltaX;
+  });
+  cards.forEach((c, i) => {
+    const tile = document.createElement("div");
+    tile.setAttribute("data-card-index", String(i));
+    tile.style.cssText = `
+      flex: 0 0 auto; width: 140px; scroll-snap-align: start;
+      background: ${fg}0a; border-radius: 12px; padding: 10px;
+      display: flex; flex-direction: column; gap: 6px;
+      cursor: ${c.cta_url ? "pointer" : "default"};
+    `;
+    if (c.image_url) {
+      const img = document.createElement("img");
+      const safe = sanitizeUrl(c.image_url);
+      if (safe) {
+        img.src = safe;
+        img.alt = "";
+        img.loading = "lazy";
+        img.style.cssText = "width: 100%; height: 96px; border-radius: 8px; object-fit: cover;";
+        tile.appendChild(img);
+      }
+    }
+    if (c.title) {
+      const t = document.createElement("div");
+      t.textContent = c.title;
+      t.style.cssText = "font-weight: 600; font-size: 13px; line-height: 1.3;";
+      tile.appendChild(t);
+    }
+    if (c.body) {
+      const b = document.createElement("div");
+      b.textContent = c.body;
+      b.style.cssText = "font-size: 11.5px; opacity: 0.72; line-height: 1.3;";
+      tile.appendChild(b);
+    }
+    if (c.cta_text && c.cta_url) {
+      const cta = document.createElement("button");
+      cta.textContent = c.cta_text;
+      cta.style.cssText = `
+        margin-top: auto; background: ${fg}; color: ${bg};
+        border: none; padding: 6px 10px; border-radius: 999px;
+        font-size: 12px; font-weight: 600; cursor: pointer;
+      `;
+      const goto2 = (e) => {
+        e.stopPropagation();
+        trackEvent(campaign.id, "clicked");
+        const safe = sanitizeUrl(c.cta_url);
+        if (safe) window.location.href = safe;
+      };
+      cta.addEventListener("click", goto2);
+      tile.appendChild(cta);
+      tile.addEventListener("click", goto2);
+    }
+    track.appendChild(tile);
+  });
+  card.appendChild(track);
+  const dots = document.createElement("div");
+  dots.style.cssText = "display: flex; justify-content: center; gap: 6px; margin-top: 10px;";
+  const dotEls = [];
+  cards.forEach(() => {
+    const dot = document.createElement("span");
+    dot.style.cssText = `
+      width: 6px; height: 6px; border-radius: 999px; background: ${fg};
+      opacity: 0.25; transition: opacity 0.2s;
+    `;
+    dotEls.push(dot);
+    dots.appendChild(dot);
+  });
+  card.appendChild(dots);
+  const setActive = (idx) => {
+    dotEls.forEach((d, i) => d.style.opacity = i === idx ? "0.9" : "0.25");
+  };
+  setActive(0);
+  let activeIdx = 0;
+  const tiles = track.querySelectorAll("[data-card-index]");
+  const goto = (idx) => {
+    activeIdx = (idx % cards.length + cards.length) % cards.length;
+    const el = tiles[activeIdx];
+    if (el) {
+      el.scrollIntoView({ behavior: "smooth", inline: "start", block: "nearest" });
+      setActive(activeIdx);
+    }
+  };
+  let autoplayTimer = null;
+  if (autoplay > 0 && cards.length > 1) {
+    autoplayTimer = setInterval(() => {
+      const next = activeIdx + 1;
+      if (next >= cards.length && !loop) {
+        if (autoplayTimer) clearInterval(autoplayTimer);
+        return;
+      }
+      goto(next);
+    }, autoplay);
+  }
+  overlay.addEventListener("remove", () => {
+    if (autoplayTimer) clearInterval(autoplayTimer);
+  });
+  track.addEventListener("scroll", () => {
+    const approx = Math.round(track.scrollLeft / 150);
+    if (approx !== activeIdx && approx >= 0 && approx < cards.length) {
+      activeIdx = approx;
+      setActive(activeIdx);
+    }
+  });
+  overlay.appendChild(card);
+  document.body.appendChild(overlay);
+}
+const DISMISS_STORAGE_PREFIX = "aegis_sticky_dismissed:";
+function renderStickyBar(ctx) {
+  const { campaign, trackEvent, sanitizeUrl, sanitizeColor, log, addAnimationStyles } = ctx;
+  const ic = campaign.interactive_config || {};
+  const position = ic.sticky_position === "top" ? "top" : "bottom";
+  const dismissible = ic.sticky_dismissible !== false;
+  const autoHide = Number(ic.sticky_auto_hide_ms) || 0;
+  try {
+    if (typeof localStorage !== "undefined" && localStorage.getItem(DISMISS_STORAGE_PREFIX + campaign.id)) {
+      log(`sticky_bar ${campaign.id} suppressed — user dismissed earlier`);
+      return;
+    }
+  } catch {
+  }
+  addAnimationStyles();
+  const bg = sanitizeColor(
+    ic.sticky_bg_color || campaign.background_color || "#4169e1"
+  );
+  const fg = sanitizeColor(campaign.text_color || "#ffffff");
+  const bar = document.createElement("div");
+  bar.className = "aegis-in-app-sticky-bar";
+  bar.setAttribute("data-campaign-id", campaign.id);
+  const positionCss = position === "top" ? "top: 0; left: 0; right: 0; animation: aegisSlideDown 0.3s ease-out;" : "bottom: 0; left: 0; right: 0; animation: aegisSlideInFromBottom 0.3s ease-out;";
+  bar.style.cssText = `
+    position: fixed; ${positionCss}
+    background: ${bg}; color: ${fg};
+    padding: 10px 14px; z-index: 999998;
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+    display: flex; align-items: center; gap: 12px; justify-content: center;
+    box-shadow: 0 ${position === "top" ? "2px" : "-2px"} 8px rgba(0,0,0,0.08);
+  `;
+  const label = document.createElement("div");
+  label.style.cssText = "flex: 0 1 auto; font-size: 13px; font-weight: 500; text-align: center;";
+  const strong = document.createElement("strong");
+  strong.textContent = campaign.title;
+  strong.style.cssText = "margin-right: 6px; font-weight: 700;";
+  label.appendChild(strong);
+  label.appendChild(document.createTextNode(campaign.body));
+  bar.appendChild(label);
+  if (campaign.action_url && campaign.button_text) {
+    const cta = document.createElement("button");
+    cta.textContent = campaign.button_text;
+    cta.style.cssText = `
+      background: ${fg}; color: ${bg};
+      border: none; padding: 6px 14px; border-radius: 999px;
+      font-size: 12px; font-weight: 700; cursor: pointer; white-space: nowrap;
+    `;
+    cta.addEventListener("click", () => {
+      trackEvent(campaign.id, "clicked");
+      const safe = sanitizeUrl(campaign.action_url);
+      if (safe) window.location.href = safe;
+    });
+    bar.appendChild(cta);
+  }
+  let autoHideTimer = null;
+  const remove = (persist) => {
+    if (autoHideTimer) clearTimeout(autoHideTimer);
+    if (persist) {
+      try {
+        if (typeof localStorage !== "undefined") {
+          localStorage.setItem(DISMISS_STORAGE_PREFIX + campaign.id, "1");
+        }
+      } catch {
+      }
+    }
+    bar.remove();
+  };
+  if (dismissible) {
+    const close = document.createElement("button");
+    close.textContent = "✕";
+    close.setAttribute("aria-label", "Dismiss");
+    close.style.cssText = `
+      background: transparent; border: none; color: inherit;
+      font-size: 16px; cursor: pointer; padding: 0 4px; opacity: 0.75;
+    `;
+    close.addEventListener("click", () => {
+      trackEvent(campaign.id, "dismissed");
+      remove(true);
+    });
+    bar.appendChild(close);
+  }
+  if (autoHide > 0) {
+    autoHideTimer = setTimeout(() => remove(false), autoHide);
+  }
+  document.body.appendChild(bar);
+}
+function renderProgressBar(ctx) {
+  const { campaign, trackEvent, sanitizeColor, log, addAnimationStyles } = ctx;
+  const ic = campaign.interactive_config || {};
+  const goalType = ic.progress_goal_type || "cart_total";
+  const threshold = Number(ic.progress_threshold);
+  if (!(threshold > 0)) {
+    log("progress_bar requires a positive progress_threshold — skipping", "warn");
+    return;
+  }
+  const rewardText = ic.progress_reward_text || campaign.body || "Unlocked!";
+  const source = ic.progress_source === "sse" ? "sse" : "client";
+  addAnimationStyles();
+  const bg = sanitizeColor(campaign.background_color || "#f8fafc");
+  const fill = sanitizeColor(campaign.text_color || "#4169e1");
+  const fg = "#0f172a";
+  const bar = document.createElement("div");
+  bar.className = "aegis-in-app-progress-bar";
+  bar.setAttribute("data-campaign-id", campaign.id);
+  bar.style.cssText = `
+    position: fixed; left: 12px; right: 12px; bottom: 12px;
+    max-width: 540px; margin: 0 auto;
+    background: ${bg}; color: ${fg}; border-radius: 12px;
+    padding: 10px 14px; z-index: 999997;
+    box-shadow: 0 8px 20px rgba(0,0,0,0.08);
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+    animation: aegisSlideInFromBottom 0.3s ease-out;
+  `;
+  const label = document.createElement("div");
+  label.style.cssText = "display: flex; justify-content: space-between; font-size: 13px; font-weight: 600; margin-bottom: 6px;";
+  const leading = document.createElement("span");
+  leading.textContent = campaign.title;
+  label.appendChild(leading);
+  const numeric = document.createElement("span");
+  numeric.style.cssText = "opacity: 0.7; font-weight: 500;";
+  label.appendChild(numeric);
+  bar.appendChild(label);
+  const shell = document.createElement("div");
+  shell.style.cssText = `
+    height: 8px; border-radius: 999px; background: ${fill}22;
+    overflow: hidden;
+  `;
+  const fillEl = document.createElement("div");
+  fillEl.style.cssText = `
+    height: 100%; border-radius: 999px; background: ${fill};
+    width: 0%; transition: width 0.4s cubic-bezier(.4,0,.2,1);
+  `;
+  shell.appendChild(fillEl);
+  bar.appendChild(shell);
+  const footnote = document.createElement("div");
+  footnote.style.cssText = "font-size: 11.5px; opacity: 0.65; margin-top: 6px;";
+  bar.appendChild(footnote);
+  const readCurrentValue = () => {
+    var _a, _b;
+    if (source === "sse") {
+      const hook = window.__aegisProgressSSE;
+      return hook && typeof hook[campaign.id] === "number" ? hook[campaign.id] : 0;
+    }
+    try {
+      if (goalType === "cart_total" || goalType === "items_in_cart") {
+        const win = window;
+        if ((_a = win.Shopify) == null ? void 0 : _a.checkout) {
+          const v = parseFloat(String(win.Shopify.checkout.total_price || 0));
+          return goalType === "cart_total" ? v : 0;
+        }
+        if (win.aegis_cart) {
+          if (goalType === "items_in_cart") {
+            return Array.isArray(win.aegis_cart.cart_items) ? win.aegis_cart.cart_items.length : 0;
+          }
+          return Number(win.aegis_cart.cart_total || 0);
+        }
+        try {
+          const cacheStr = (_b = window.localStorage) == null ? void 0 : _b.getItem("mage-cache-storage");
+          if (cacheStr) {
+            const cache = JSON.parse(cacheStr);
+            const cart = cache.cart;
+            if (cart) {
+              return goalType === "cart_total" ? Number(cart.subtotalAmount || 0) : Array.isArray(cart.items) ? cart.items.length : 0;
+            }
+          }
+        } catch {
+        }
+      }
+      return 0;
+    } catch {
+      return 0;
+    }
+  };
+  let lastFiredUnlock = false;
+  const update = () => {
+    const cur = readCurrentValue();
+    const pct = Math.max(0, Math.min(100, cur / threshold * 100));
+    fillEl.style.width = `${pct}%`;
+    numeric.textContent = `${cur.toFixed(0)} / ${threshold.toFixed(0)}`;
+    if (pct >= 100) {
+      footnote.textContent = rewardText;
+      if (!lastFiredUnlock) {
+        lastFiredUnlock = true;
+        trackEvent(campaign.id, "clicked");
+      }
+    } else {
+      const remaining = Math.max(0, threshold - cur);
+      footnote.textContent = `Add ${remaining.toFixed(0)} more to unlock: ${rewardText}`;
+    }
+  };
+  update();
+  const pollTimer = setInterval(update, 1e3);
+  const cleanup = () => clearInterval(pollTimer);
+  window.addEventListener("beforeunload", cleanup, { once: true });
+  bar.addEventListener("remove", cleanup);
+  document.body.appendChild(bar);
+}
+const RESUME_PREFIX = "aegis_coachmark_progress:";
+function readResumeIdx(resumeKey) {
+  try {
+    if (typeof localStorage === "undefined") return 0;
+    const raw = localStorage.getItem(RESUME_PREFIX + resumeKey);
+    const n = raw ? parseInt(raw, 10) : 0;
+    return Number.isFinite(n) && n >= 0 ? n : 0;
+  } catch {
+    return 0;
+  }
+}
+function writeResumeIdx(resumeKey, idx) {
+  try {
+    if (typeof localStorage !== "undefined") {
+      localStorage.setItem(RESUME_PREFIX + resumeKey, String(idx));
+    }
+  } catch {
+  }
+}
+function clearResume(resumeKey) {
+  try {
+    if (typeof localStorage !== "undefined") {
+      localStorage.removeItem(RESUME_PREFIX + resumeKey);
+    }
+  } catch {
+  }
+}
+function renderCoachmarkTour(ctx) {
+  const { campaign, trackEvent, sanitizeColor, log, addAnimationStyles } = ctx;
+  const ic = campaign.interactive_config || {};
+  const resumeKey = ic.resume_key;
+  if (!resumeKey) {
+    log("coachmark_tour requires interactive_config.resume_key — skipping", "warn");
+    return;
+  }
+  const steps = Array.isArray(ic.steps) ? ic.steps : [];
+  if (steps.length === 0) {
+    log("coachmark_tour has no steps — skipping", "warn");
+    return;
+  }
+  const allowSkip = ic.allow_skip !== false;
+  const showDots = ic.show_progress_dots !== false;
+  addAnimationStyles();
+  const bg = sanitizeColor(campaign.background_color || "#0f172a");
+  const fg = sanitizeColor(campaign.text_color || "#ffffff");
+  let current = readResumeIdx(resumeKey);
+  if (current >= steps.length) {
+    log(`coachmark_tour ${resumeKey} already complete — not re-showing`);
+    return;
+  }
+  trackEvent(campaign.id, "impression");
+  let pointerEl = null;
+  let tipEl = null;
+  let highlightEl = null;
+  const cleanupOne = () => {
+    pointerEl == null ? void 0 : pointerEl.remove();
+    tipEl == null ? void 0 : tipEl.remove();
+    highlightEl == null ? void 0 : highlightEl.remove();
+    pointerEl = null;
+    tipEl = null;
+    highlightEl = null;
+  };
+  const finish = (opts) => {
+    cleanupOne();
+    if (opts.skipped) {
+      trackEvent(campaign.id, "dismissed");
+    } else {
+      trackEvent(campaign.id, "clicked");
+    }
+    writeResumeIdx(resumeKey, steps.length);
+  };
+  const showStep = (idx) => {
+    cleanupOne();
+    const step = steps[idx];
+    if (!step) {
+      finish({ skipped: false });
+      return;
+    }
+    writeResumeIdx(resumeKey, idx);
+    const selector = step.anchor_web;
+    let anchor = null;
+    if (selector) {
+      try {
+        anchor = document.querySelector(selector);
+      } catch {
+        anchor = null;
+      }
+    }
+    if (!anchor) {
+      log(`coachmark step ${idx} — selector '${selector}' not found; advancing`, "warn");
+      showStep(idx + 1);
+      return;
+    }
+    const rect = anchor.getBoundingClientRect();
+    highlightEl = document.createElement("div");
+    highlightEl.style.cssText = `
+      position: fixed;
+      top: ${rect.top - 6}px; left: ${rect.left - 6}px;
+      width: ${rect.width + 12}px; height: ${rect.height + 12}px;
+      border-radius: 10px; z-index: 999998;
+      box-shadow: 0 0 0 2px ${fg}, 0 0 0 9999px rgba(0,0,0,0.4);
+      pointer-events: none;
+      transition: all 0.2s ease;
+    `;
+    document.body.appendChild(highlightEl);
+    const placement = step.placement || "bottom";
+    tipEl = document.createElement("div");
+    tipEl.setAttribute("data-campaign-id", campaign.id);
+    tipEl.style.cssText = `
+      position: fixed; z-index: 999999;
+      background: ${bg}; color: ${fg};
+      padding: 12px 14px; border-radius: 12px;
+      max-width: 260px;
+      box-shadow: 0 8px 24px rgba(0,0,0,0.25);
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+      animation: aegisFadeIn 0.2s ease;
+    `;
+    const titleEl = document.createElement("div");
+    titleEl.textContent = step.title;
+    titleEl.style.cssText = "font-weight: 700; font-size: 13px; margin-bottom: 4px;";
+    tipEl.appendChild(titleEl);
+    const bodyEl = document.createElement("div");
+    bodyEl.textContent = step.body;
+    bodyEl.style.cssText = "font-size: 12.5px; line-height: 1.4; opacity: 0.9;";
+    tipEl.appendChild(bodyEl);
+    const controls = document.createElement("div");
+    controls.style.cssText = "display: flex; align-items: center; justify-content: space-between; margin-top: 10px; gap: 8px;";
+    if (showDots) {
+      const dots = document.createElement("div");
+      dots.style.cssText = "display: flex; gap: 4px;";
+      steps.forEach((_, i) => {
+        const d = document.createElement("span");
+        d.style.cssText = `
+          width: 5px; height: 5px; border-radius: 999px;
+          background: ${fg}; opacity: ${i === idx ? "0.95" : "0.3"};
+        `;
+        dots.appendChild(d);
+      });
+      controls.appendChild(dots);
+    } else {
+      controls.appendChild(document.createElement("span"));
+    }
+    const buttons = document.createElement("div");
+    buttons.style.cssText = "display: flex; gap: 6px;";
+    if (allowSkip && idx < steps.length - 1) {
+      const skip = document.createElement("button");
+      skip.textContent = "Skip";
+      skip.style.cssText = `
+        background: transparent; color: inherit; opacity: 0.7;
+        border: none; font-size: 12px; cursor: pointer; padding: 6px 8px;
+      `;
+      skip.addEventListener("click", () => finish({ skipped: true }));
+      buttons.appendChild(skip);
+    }
+    const next = document.createElement("button");
+    const isLast = idx === steps.length - 1;
+    next.textContent = step.cta_text || (isLast ? "Done" : "Next");
+    next.style.cssText = `
+      background: ${fg}; color: ${bg};
+      border: none; padding: 6px 12px; border-radius: 999px;
+      font-size: 12px; font-weight: 700; cursor: pointer;
+    `;
+    next.addEventListener("click", () => {
+      if (isLast) {
+        finish({ skipped: false });
+      } else {
+        showStep(idx + 1);
+      }
+    });
+    buttons.appendChild(next);
+    controls.appendChild(buttons);
+    tipEl.appendChild(controls);
+    document.body.appendChild(tipEl);
+    const tipRect = tipEl.getBoundingClientRect();
+    const margin = 12;
+    let top = rect.bottom + margin;
+    let left = rect.left;
+    if (placement === "top") {
+      top = rect.top - tipRect.height - margin;
+    } else if (placement === "left") {
+      top = rect.top;
+      left = rect.left - tipRect.width - margin;
+    } else if (placement === "right") {
+      top = rect.top;
+      left = rect.right + margin;
+    }
+    top = Math.max(8, Math.min(window.innerHeight - tipRect.height - 8, top));
+    left = Math.max(8, Math.min(window.innerWidth - tipRect.width - 8, left));
+    tipEl.style.top = `${top}px`;
+    tipEl.style.left = `${left}px`;
+  };
+  showStep(current);
+  window.aegisResetTour = (key) => clearResume(key);
+}
+const MAX_PRODUCTS = 24;
+function renderProductRecommendation(ctx) {
+  const { campaign, trackEvent, sanitizeUrl, sanitizeColor, log, addAnimationStyles } = ctx;
+  const ic = campaign.interactive_config || {};
+  const rawCards = Array.isArray(ic.cards) ? ic.cards : [];
+  const cards = rawCards.slice(0, MAX_PRODUCTS);
+  if (cards.length === 0) {
+    log("product_recommendation rendered with zero products — skipping", "warn");
+    return;
+  }
+  const layout = ic.rec_layout || "grid";
+  const ctaDefault = ic.rec_cta_text || "Shop now";
+  addAnimationStyles();
+  const bg = sanitizeColor(campaign.background_color || "#ffffff");
+  const fg = sanitizeColor(campaign.text_color || "#0f172a");
+  const accent = sanitizeColor("#4169e1");
+  const overlay = document.createElement("div");
+  overlay.className = "aegis-in-app-product-rec";
+  overlay.setAttribute("data-campaign-id", campaign.id);
+  overlay.style.cssText = `
+    position: fixed; inset: 0;
+    background: rgba(15,23,42,0.55); backdrop-filter: blur(4px);
+    display: flex; align-items: flex-end; justify-content: center;
+    z-index: 99999; animation: aegisFadeIn 0.25s ease;
+  `;
+  const sheet = document.createElement("div");
+  sheet.style.cssText = `
+    background: ${bg}; color: ${fg};
+    max-width: 560px; width: 100%; max-height: 80vh; overflow-y: auto;
+    border-radius: 20px 20px 0 0;
+    padding: 18px 16px 22px;
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+    animation: aegisSlideInFromBottom 0.3s ease-out;
+    box-shadow: 0 -12px 30px rgba(0,0,0,0.12);
+  `;
+  const handle = document.createElement("div");
+  handle.style.cssText = `
+    width: 36px; height: 4px; border-radius: 999px; background: ${fg}1f;
+    margin: 0 auto 12px;
+  `;
+  sheet.appendChild(handle);
+  const header = document.createElement("div");
+  header.style.cssText = "display: flex; justify-content: space-between; align-items: flex-start; gap: 12px;";
+  const headerText = document.createElement("div");
+  const title = document.createElement("div");
+  title.textContent = campaign.title;
+  title.style.cssText = "font-weight: 700; font-size: 16px; margin-bottom: 2px;";
+  const body = document.createElement("div");
+  body.textContent = campaign.body;
+  body.style.cssText = "font-size: 13px; opacity: 0.7; line-height: 1.4;";
+  headerText.appendChild(title);
+  headerText.appendChild(body);
+  header.appendChild(headerText);
+  const close = document.createElement("button");
+  close.textContent = "✕";
+  close.setAttribute("aria-label", "Close");
+  close.style.cssText = `
+    background: transparent; border: none; color: inherit;
+    font-size: 18px; cursor: pointer; padding: 4px 8px; opacity: 0.7;
+  `;
+  close.addEventListener("click", () => {
+    trackEvent(campaign.id, "dismissed");
+    overlay.remove();
+  });
+  header.appendChild(close);
+  sheet.appendChild(header);
+  const grid = document.createElement("div");
+  if (layout === "row" || layout === "carousel") {
+    grid.style.cssText = `
+      display: flex; gap: 10px; overflow-x: auto;
+      scroll-snap-type: x mandatory; padding: 14px 0 4px;
+    `;
+  } else {
+    grid.style.cssText = `
+      display: grid; grid-template-columns: repeat(2, 1fr); gap: 10px;
+      padding-top: 14px;
+    `;
+  }
+  cards.forEach((c) => {
+    const tile = document.createElement("div");
+    const isRow = layout === "row" || layout === "carousel";
+    tile.style.cssText = `
+      background: ${fg}08; border-radius: 12px;
+      padding: 10px; display: flex; flex-direction: column; gap: 6px;
+      cursor: ${c.cta_url ? "pointer" : "default"};
+      ${isRow ? "flex: 0 0 150px; scroll-snap-align: start;" : ""}
+      transition: transform 0.15s ease;
+    `;
+    if (c.image_url) {
+      const img = document.createElement("img");
+      const safe = sanitizeUrl(c.image_url);
+      if (safe) {
+        img.src = safe;
+        img.alt = "";
+        img.loading = "lazy";
+        img.style.cssText = "width: 100%; aspect-ratio: 1 / 1; border-radius: 8px; object-fit: cover;";
+        tile.appendChild(img);
+      }
+    }
+    if (c.title) {
+      const t = document.createElement("div");
+      t.textContent = c.title;
+      t.style.cssText = "font-weight: 600; font-size: 13px; line-height: 1.3;";
+      tile.appendChild(t);
+    }
+    const price = c.metadata && typeof c.metadata === "object" ? c.metadata.price : void 0;
+    if (price !== void 0) {
+      const p = document.createElement("div");
+      p.textContent = String(price);
+      p.style.cssText = `color: ${accent}; font-weight: 700; font-size: 13px;`;
+      tile.appendChild(p);
+    } else if (c.body) {
+      const b = document.createElement("div");
+      b.textContent = c.body;
+      b.style.cssText = "font-size: 11.5px; opacity: 0.72; line-height: 1.3;";
+      tile.appendChild(b);
+    }
+    const cta = document.createElement("button");
+    cta.textContent = c.cta_text || ctaDefault;
+    cta.style.cssText = `
+      margin-top: auto;
+      background: ${accent}; color: #fff;
+      border: none; padding: 7px 10px; border-radius: 999px;
+      font-size: 12px; font-weight: 600; cursor: pointer;
+    `;
+    const go = (e) => {
+      e.stopPropagation();
+      trackEvent(campaign.id, "clicked");
+      if (c.cta_url) {
+        const safe = sanitizeUrl(c.cta_url);
+        if (safe) window.location.href = safe;
+      }
+    };
+    cta.addEventListener("click", go);
+    tile.appendChild(cta);
+    if (c.cta_url) tile.addEventListener("click", go);
+    grid.appendChild(tile);
+  });
+  sheet.appendChild(grid);
+  overlay.appendChild(sheet);
+  overlay.addEventListener("click", (e) => {
+    if (e.target === overlay) {
+      trackEvent(campaign.id, "dismissed");
+      overlay.remove();
+    }
+  });
+  document.body.appendChild(overlay);
+}
 class AegisInAppManager {
   constructor(config) {
     this.campaigns = [];
@@ -213,11 +922,60 @@ class AegisInAppManager {
     return assignments[campaignId] ?? void 0;
   }
   tryDisplayNextCampaign() {
-    const campaign = this.campaigns.find((c) => !this.displayedCampaigns.has(c.id));
+    const campaign = this.campaigns.find(
+      (c) => !this.displayedCampaigns.has(c.id) && !c.client_trigger
+    );
     if (campaign) {
       this.displayCampaign(campaign);
     }
   }
+  /**
+   * Evaluate the currently armed campaigns against a client-side event
+   * and render any that match their `client_trigger`.
+   *
+   * Called by the host app (e.g., the EcommerceTracker on product_viewed),
+   * or by future TriggerEngine bridges. Safe to call repeatedly for the
+   * same event — dedup happens via `displayedCampaigns`.
+   *
+   * Supported trigger types (align with the cell-plane server-side
+   * `display_rules.trigger_type`):
+   *   - `custom_event`  : fire when eventName matches config.event
+   *   - `product_match` : fire on `product_viewed` when eventData.product_id
+   *                       matches config.product_id (string or string[])
+   *   - `delay`         : client-side setTimeout — evaluated at armeng
+   *                       time (kicked off from `displayCampaign`), not here.
+   */
+  onClientEvent(eventName, eventData = {}) {
+    for (const c of this.campaigns) {
+      if (this.displayedCampaigns.has(c.id)) continue;
+      if (!c.client_trigger) continue;
+      if (this.matchesClientTrigger(c.client_trigger, eventName, eventData)) {
+        this.displayCampaign(c);
+      }
+    }
+  }
+  matchesClientTrigger(trigger, eventName, eventData) {
+    var _a;
+    const cfg = trigger.config || {};
+    switch (trigger.type) {
+      case "custom_event":
+        return typeof cfg.event === "string" && cfg.event === eventName;
+      case "product_match": {
+        if (eventName !== "product_viewed" && eventName !== "product_view") {
+          return false;
+        }
+        const wantedRaw = cfg.product_id;
+        const wanted = Array.isArray(wantedRaw) ? wantedRaw : typeof wantedRaw === "string" ? [wantedRaw] : [];
+        if (wanted.length === 0) return false;
+        const actual = String(
+          eventData.product_id ?? eventData.productId ?? ((_a = eventData.product) == null ? void 0 : _a.id) ?? ""
+        );
+        return wanted.includes(actual);
+      }
+      default:
+        return false;
+    }
+  }
   displayCampaign(campaign) {
     this.displayedCampaigns.add(campaign.id);
     const interactiveSubTypes = /* @__PURE__ */ new Set([
@@ -256,9 +1014,49 @@ class AegisInAppManager {
       case "tooltip":
         this.renderTooltip(campaign);
         break;
+      // Preload-first display types (2026-04-22). These renderers own their
+      // own impression tracking so we don't double-count alongside the
+      // trailing `this.trackEvent(... 'impression')` below — return early.
+      case "carousel_cards":
+        renderCarouselCards(this.buildRenderContext(campaign));
+        this.trackEvent(campaign.id, "impression");
+        return;
+      case "sticky_bar":
+        renderStickyBar(this.buildRenderContext(campaign));
+        this.trackEvent(campaign.id, "impression");
+        return;
+      case "progress_bar":
+        renderProgressBar(this.buildRenderContext(campaign));
+        this.trackEvent(campaign.id, "impression");
+        return;
+      case "coachmark_tour":
+        renderCoachmarkTour(this.buildRenderContext(campaign));
+        return;
+      case "product_recommendation":
+        renderProductRecommendation(this.buildRenderContext(campaign));
+        this.trackEvent(campaign.id, "impression");
+        return;
     }
     this.trackEvent(campaign.id, "impression");
   }
+  /**
+   * Build the shared context passed into the preload-first renderers.
+   * Matches the interface in `./renderers/types.ts`. Kept as a private
+   * method (rather than inlined at each call-site) so future renderer
+   * additions stay consistent and easy to audit.
+   */
+  buildRenderContext(campaign) {
+    return {
+      campaign,
+      trackEvent: (id, evt) => {
+        void this.trackEvent(id, evt);
+      },
+      sanitizeUrl: (url) => this.sanitizeUrl(url),
+      sanitizeColor: (color) => this.sanitizeColor(color),
+      log: (msg, level) => this.log(msg, level),
+      addAnimationStyles: () => this.addAnimationStyles()
+    };
+  }
   /**
    * Renders interactive sub-type campaigns (spin wheel, NPS, quiz, etc.)
    * using DOM-safe rendering. These sub-types use the campaign's
@@ -1341,6 +2139,14 @@ class AegisInAppManager {
         from { transform: scale(0.9); opacity: 0; }
         to { transform: scale(1); opacity: 1; }
       }
+
+      /* Bottom-anchored slide IN (opposite of aegisSlideUp which slides OUT).
+         Used by the preload-first renderers: sticky_bar (bottom),
+         progress_bar, carousel_cards, product_recommendation. */
+      @keyframes aegisSlideInFromBottom {
+        from { transform: translateY(100%); opacity: 0; }
+        to { transform: translateY(0); opacity: 1; }
+      }
     `;
     document.head.appendChild(style);
   }
@@ -1401,6 +2207,10 @@ class AegisInAppManager {
           event_type: eventType,
           user_id: this.userId,
           contact_id: this.contactId,
+          // Property ID so the cell-plane's in_app.rendered emitter can
+          // fan the event out to the property-scoped inbox_writer. Without
+          // this, inbox materialization cannot target the right property.
+          property_id: this.propertyId,
           platform: "web",
           variant_id: this.getVariantId(campaignId) ?? void 0
         },
@@ -4351,6 +5161,495 @@ class SdkConfigPoller {
     }
   }
 }
+const DEFAULT_POLL_MS = 3e5;
+class PrefetchBundleClient {
+  constructor(options) {
+    this.currentETag = null;
+    this.currentBundle = null;
+    this.pollTimer = null;
+    this.listeners = [];
+    this.inflightRefetch = null;
+    this.apiHost = options.apiHost;
+    this.writeKey = options.writeKey;
+    this.organizationId = options.organizationId;
+    this.contactId = options.contactId;
+    this.userId = options.userId;
+    this.propertyId = options.propertyId;
+    this.abAssignments = options.abAssignments ?? {};
+    this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_MS;
+    this.contextProvider = options.contextProvider ?? (() => ({}));
+  }
+  /**
+   * Initial fetch + start the background ETag poll. Resolves to the bundle
+   * (or `null` if the first fetch failed — callers should fall back to an
+   * empty campaign list, not abort SDK init).
+   */
+  async start() {
+    const bundle = await this.fetch();
+    this.pollTimer = setInterval(() => {
+      this.fetch().catch((err) => logger.warn("prefetch-bundle poll failed:", err));
+    }, this.pollIntervalMs);
+    return bundle;
+  }
+  stop() {
+    if (this.pollTimer) {
+      clearInterval(this.pollTimer);
+      this.pollTimer = null;
+    }
+  }
+  getBundle() {
+    return this.currentBundle;
+  }
+  getCampaigns() {
+    var _a;
+    return ((_a = this.currentBundle) == null ? void 0 : _a.campaigns) ?? [];
+  }
+  getInbox() {
+    var _a;
+    return ((_a = this.currentBundle) == null ? void 0 : _a.inbox) ?? { unread_count: 0, page: [], cursor: null };
+  }
+  /** Force a refresh (dedupes concurrent calls). Exposed so inbox mutations
+   *  and campaign-activation SSE messages can trigger a refetch on demand. */
+  async refresh() {
+    if (this.inflightRefetch) return this.inflightRefetch;
+    this.inflightRefetch = this.fetch();
+    try {
+      return await this.inflightRefetch;
+    } finally {
+      this.inflightRefetch = null;
+    }
+  }
+  /** Subscribe to bundle changes (emits on first fetch + on any content
+   *  change — ETag 304 does NOT fire the listener). Returns an unsubscribe. */
+  onChange(listener) {
+    this.listeners.push(listener);
+    return () => {
+      const idx = this.listeners.indexOf(listener);
+      if (idx >= 0) this.listeners.splice(idx, 1);
+    };
+  }
+  /**
+   * Update the identity tuple — called by AegisInAppManager when the host
+   * app resolves a contactId post-init (e.g., after login). Triggers an
+   * immediate refresh since the eligible campaigns + inbox will differ.
+   */
+  updateIdentity(partial) {
+    let changed = false;
+    if (partial.contactId !== void 0 && partial.contactId !== this.contactId) {
+      this.contactId = partial.contactId;
+      changed = true;
+    }
+    if (partial.userId !== void 0 && partial.userId !== this.userId) {
+      this.userId = partial.userId;
+      changed = true;
+    }
+    if (partial.organizationId !== void 0 && partial.organizationId !== this.organizationId) {
+      this.organizationId = partial.organizationId;
+      changed = true;
+    }
+    if (partial.propertyId !== void 0 && partial.propertyId !== this.propertyId) {
+      this.propertyId = partial.propertyId;
+      changed = true;
+    }
+    if (changed) {
+      this.currentETag = null;
+      this.refresh().catch(
+        (err) => logger.warn("prefetch-bundle identity-refresh failed:", err)
+      );
+    }
+  }
+  /** Update cached AB assignments. Called by downstream renderers after
+   *  they display a variant. Persisted to localStorage by higher layers. */
+  setAbAssignments(assignments) {
+    this.abAssignments = { ...assignments };
+  }
+  // ── internals ──────────────────────────────────────────────────────────
+  async fetch() {
+    const ctx = this.contextProvider();
+    const qs = new URLSearchParams();
+    if (ctx.device_type) qs.set("device_type", ctx.device_type);
+    if (ctx.page_url) qs.set("page_url", ctx.page_url);
+    if (ctx.geo) qs.set("geo", ctx.geo);
+    qs.set("is_new_user", ctx.is_new_user ? "true" : "false");
+    const url = `${this.apiHost}/v1/sdk/prefetch-bundle?${qs.toString()}`;
+    const headers = {
+      "X-Aegis-Write-Key": this.writeKey,
+      Accept: "application/json"
+    };
+    if (this.organizationId) headers["X-Organization-ID"] = this.organizationId;
+    if (this.contactId) headers["X-Contact-ID"] = this.contactId;
+    if (this.userId) headers["X-User-ID"] = this.userId;
+    if (this.propertyId) headers["X-Property-Id"] = this.propertyId;
+    if (this.currentETag) headers["If-None-Match"] = this.currentETag;
+    if (Object.keys(this.abAssignments).length > 0) {
+      try {
+        headers["X-AB-Assignments"] = btoa(JSON.stringify(this.abAssignments));
+      } catch {
+      }
+    }
+    let response;
+    try {
+      response = await fetch(url, { method: "GET", headers });
+    } catch (err) {
+      logger.warn("prefetch-bundle fetch network error:", err);
+      return this.currentBundle;
+    }
+    if (response.status === 304) {
+      return this.currentBundle;
+    }
+    if (!response.ok) {
+      logger.warn(`prefetch-bundle fetch failed: HTTP ${response.status}`);
+      return this.currentBundle;
+    }
+    const etag = response.headers.get("ETag");
+    let bundle;
+    try {
+      bundle = await response.json();
+    } catch (err) {
+      logger.warn("prefetch-bundle invalid JSON:", err);
+      return this.currentBundle;
+    }
+    if (etag) this.currentETag = etag;
+    this.currentBundle = bundle;
+    for (const l of this.listeners) {
+      try {
+        l(bundle);
+      } catch (err) {
+        logger.warn("prefetch-bundle listener threw:", err);
+      }
+    }
+    return bundle;
+  }
+}
+const DEFAULT_UNREAD_POLL = 6e4;
+const IDB_NAME = "aegis-inbox";
+const IDB_STORE = "messages";
+const IDB_VERSION = 1;
+class AegisInbox {
+  constructor(config) {
+    this.entries = [];
+    this.unreadCount = 0;
+    this.cursor = null;
+    this.listeners = [];
+    this.pollTimer = null;
+    this.bundleUnsub = null;
+    this.apiHost = config.apiHost;
+    this.writeKey = config.writeKey;
+    this.organizationId = config.organizationId;
+    this.contactId = config.contactId;
+    this.propertyId = config.propertyId;
+    this.bundleClient = config.bundleClient;
+    this.unreadPollIntervalMs = config.unreadPollIntervalMs ?? DEFAULT_UNREAD_POLL;
+  }
+  /** Hydrate from bundle (if available), restore the IDB cache (if any),
+   *  then start the background unread-count poll. */
+  async initialize() {
+    if (!this.contactId || !this.propertyId) {
+      logger.warn("AegisInbox: no contact/property yet — staying dormant");
+      return;
+    }
+    const cached = await this.readCache();
+    if (cached.length > 0) {
+      this.entries = cached;
+      this.recomputeUnread();
+      this.emit();
+    }
+    if (this.bundleClient) {
+      const inbox = this.bundleClient.getInbox();
+      this.seedFromBundle(inbox.page, inbox.unread_count);
+      this.bundleUnsub = this.bundleClient.onChange((bundle) => {
+        this.seedFromBundle(bundle.inbox.page, bundle.inbox.unread_count);
+      });
+    } else {
+      await this.refreshList();
+    }
+    this.pollTimer = setInterval(() => {
+      this.refreshUnreadCount().catch(
+        (err) => logger.warn("inbox unread-count poll failed:", err)
+      );
+    }, this.unreadPollIntervalMs);
+  }
+  stop() {
+    if (this.pollTimer) {
+      clearInterval(this.pollTimer);
+      this.pollTimer = null;
+    }
+    if (this.bundleUnsub) {
+      this.bundleUnsub();
+      this.bundleUnsub = null;
+    }
+  }
+  /** Update identity after login / property switch. Clears the local
+   *  inbox since it's intrinsically contact+property scoped. */
+  setIdentity(partial) {
+    let changed = false;
+    if (partial.contactId !== void 0 && partial.contactId !== this.contactId) {
+      this.contactId = partial.contactId;
+      changed = true;
+    }
+    if (partial.propertyId !== void 0 && partial.propertyId !== this.propertyId) {
+      this.propertyId = partial.propertyId;
+      changed = true;
+    }
+    if (partial.organizationId !== void 0 && partial.organizationId !== this.organizationId) {
+      this.organizationId = partial.organizationId;
+      changed = true;
+    }
+    if (changed) {
+      this.entries = [];
+      this.unreadCount = 0;
+      this.cursor = null;
+      this.emit();
+      void this.clearCache();
+      void this.refreshList();
+    }
+  }
+  // ── Read-side API ────────────────────────────────────────────────────
+  getEntries() {
+    return this.entries;
+  }
+  getUnreadCount() {
+    return this.unreadCount;
+  }
+  /** Pagination cursor (ISO-8601 timestamp of the oldest entry currently
+   *  held). Pass it back via `loadMore()` to fetch older history. */
+  getCursor() {
+    return this.cursor;
+  }
+  /** Append one more page of older entries using the current cursor. */
+  async loadMore() {
+    if (!this.contactId || !this.propertyId || !this.cursor) return;
+    try {
+      const url = `${this.apiHost}/v1/in-app/inbox?limit=20&cursor=${encodeURIComponent(this.cursor)}`;
+      const resp = await fetch(url, { headers: this.headers() });
+      if (!resp.ok) return;
+      const body = await resp.json();
+      const byId = new Set(this.entries.map((e) => e.id));
+      for (const e of body.entries) {
+        if (!byId.has(e.id)) this.entries.push(e);
+      }
+      this.cursor = body.cursor;
+      void this.writeCache();
+      this.emit();
+    } catch (err) {
+      logger.warn("inbox loadMore failed:", err);
+    }
+  }
+  onChange(l) {
+    this.listeners.push(l);
+    return () => {
+      const i = this.listeners.indexOf(l);
+      if (i >= 0) this.listeners.splice(i, 1);
+    };
+  }
+  async refreshList() {
+    if (!this.contactId || !this.propertyId) return;
+    try {
+      const resp = await fetch(
+        `${this.apiHost}/v1/in-app/inbox?limit=20`,
+        { headers: this.headers() }
+      );
+      if (!resp.ok) {
+        logger.warn(`inbox list fetch failed: HTTP ${resp.status}`);
+        return;
+      }
+      const body = await resp.json();
+      this.entries = body.entries;
+      this.unreadCount = body.unread_count;
+      this.cursor = body.cursor;
+      void this.writeCache();
+      this.emit();
+    } catch (err) {
+      logger.warn("inbox list fetch error:", err);
+    }
+  }
+  async refreshUnreadCount() {
+    if (!this.contactId || !this.propertyId) return;
+    try {
+      const resp = await fetch(
+        `${this.apiHost}/v1/in-app/inbox/unread-count`,
+        { headers: this.headers() }
+      );
+      if (!resp.ok) return;
+      const body = await resp.json();
+      if (body.unread_count !== this.unreadCount) {
+        this.unreadCount = body.unread_count;
+        this.emit();
+        if (this.unreadCount > 0) {
+          void this.refreshList();
+        }
+      }
+    } catch {
+    }
+  }
+  // ── Mutations (optimistic + beacon) ──────────────────────────────────
+  async markRead(messageId) {
+    const entry = this.entries.find((e) => e.id === messageId);
+    if (!entry || entry.read) return;
+    entry.read = true;
+    entry.read_at = (/* @__PURE__ */ new Date()).toISOString();
+    this.recomputeUnread();
+    void this.writeCache();
+    this.emit();
+    await this.postBeacon(`/v1/in-app/inbox/${messageId}/read`);
+  }
+  async dismiss(messageId) {
+    const idx = this.entries.findIndex((e) => e.id === messageId);
+    if (idx < 0) return;
+    const [entry] = this.entries.splice(idx, 1);
+    if (entry && !entry.read) {
+      this.recomputeUnread();
+    }
+    void this.writeCache();
+    this.emit();
+    await this.postBeacon(`/v1/in-app/inbox/${messageId}/dismiss`);
+  }
+  async markAllRead() {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    for (const e of this.entries) {
+      if (!e.read) {
+        e.read = true;
+        e.read_at = now;
+      }
+    }
+    this.unreadCount = 0;
+    void this.writeCache();
+    this.emit();
+    await this.postBeacon("/v1/in-app/inbox/read-all");
+  }
+  // ── Internals ────────────────────────────────────────────────────────
+  seedFromBundle(page, unreadCount) {
+    const byId = new Map(this.entries.map((e) => [e.id, e]));
+    const merged = page.map((incoming) => {
+      const existing = byId.get(incoming.id);
+      if (existing && existing.read && !incoming.read) {
+        return { ...incoming, read: true, read_at: existing.read_at };
+      }
+      return incoming;
+    });
+    for (const [id, e] of byId) {
+      if (!merged.find((m2) => m2.id === id)) merged.push(e);
+    }
+    merged.sort((a, b) => (b.created_at || "").localeCompare(a.created_at || ""));
+    this.entries = merged;
+    this.unreadCount = unreadCount;
+    void this.writeCache();
+    this.emit();
+  }
+  recomputeUnread() {
+    this.unreadCount = this.entries.filter((e) => !e.read).length;
+  }
+  emit() {
+    const snapshot = { entries: [...this.entries], unreadCount: this.unreadCount };
+    for (const l of this.listeners) {
+      try {
+        l(snapshot);
+      } catch (err) {
+        logger.warn("inbox listener threw:", err);
+      }
+    }
+  }
+  headers() {
+    const h = {
+      "X-Aegis-Write-Key": this.writeKey,
+      Accept: "application/json"
+    };
+    if (this.organizationId) h["X-Organization-ID"] = this.organizationId;
+    if (this.contactId) h["X-Contact-ID"] = this.contactId;
+    if (this.propertyId) h["X-Property-Id"] = this.propertyId;
+    return h;
+  }
+  /** Best-effort beacon-style POST. Uses `keepalive: true` so it survives
+   *  a navigation away from the current page (e.g., user taps the CTA
+   *  which takes them to another URL right after dismiss). */
+  async postBeacon(path) {
+    if (!this.contactId || !this.propertyId) return;
+    try {
+      await fetch(`${this.apiHost}${path}`, {
+        method: "POST",
+        headers: this.headers(),
+        keepalive: true
+      });
+    } catch (err) {
+      logger.warn(`inbox mutation POST ${path} failed:`, err);
+    }
+  }
+  // ── IndexedDB cache (non-critical) ───────────────────────────────────
+  async openDb() {
+    if (typeof indexedDB === "undefined") return null;
+    return new Promise((resolve) => {
+      try {
+        const req = indexedDB.open(IDB_NAME, IDB_VERSION);
+        req.onerror = () => resolve(null);
+        req.onupgradeneeded = () => {
+          const db = req.result;
+          if (!db.objectStoreNames.contains(IDB_STORE)) {
+            db.createObjectStore(IDB_STORE);
+          }
+        };
+        req.onsuccess = () => resolve(req.result);
+      } catch {
+        resolve(null);
+      }
+    });
+  }
+  cacheKey() {
+    if (!this.contactId || !this.propertyId) return null;
+    return `${this.organizationId || "default"}:${this.propertyId}:${this.contactId}`;
+  }
+  async writeCache() {
+    const key = this.cacheKey();
+    if (!key) return;
+    const db = await this.openDb();
+    if (!db) return;
+    try {
+      const tx = db.transaction(IDB_STORE, "readwrite");
+      tx.objectStore(IDB_STORE).put(this.entries, key);
+      await new Promise((res, rej) => {
+        tx.oncomplete = () => res();
+        tx.onerror = () => rej(tx.error);
+      });
+    } catch {
+    } finally {
+      db.close();
+    }
+  }
+  async readCache() {
+    const key = this.cacheKey();
+    if (!key) return [];
+    const db = await this.openDb();
+    if (!db) return [];
+    try {
+      const tx = db.transaction(IDB_STORE, "readonly");
+      const req = tx.objectStore(IDB_STORE).get(key);
+      return await new Promise((res) => {
+        req.onsuccess = () => res(req.result || []);
+        req.onerror = () => res([]);
+      });
+    } catch {
+      return [];
+    } finally {
+      db.close();
+    }
+  }
+  async clearCache() {
+    const key = this.cacheKey();
+    if (!key) return;
+    const db = await this.openDb();
+    if (!db) return;
+    try {
+      const tx = db.transaction(IDB_STORE, "readwrite");
+      tx.objectStore(IDB_STORE).delete(key);
+      await new Promise((res) => {
+        tx.oncomplete = () => res();
+        tx.onerror = () => res();
+      });
+    } catch {
+    } finally {
+      db.close();
+    }
+  }
+}
 const COOKIE_NAME = "aegis_fpc";
 const COOKIE_MAX_AGE_DAYS = 365 * 2;
 class BootstrapError extends Error {
@@ -4428,6 +5727,7 @@ const aegis = new Aegis();
 export {
   Aegis,
   AegisInAppManager,
+  AegisInbox,
   AegisPlacementManager,
   AegisWebPush,
   AegisWidgetManager,
@@ -4435,6 +5735,7 @@ export {
   BootstrapError,
   E as EcommerceTracker,
   N as NameGovernor,
+  PrefetchBundleClient,
   R as RateLimiter,
   SdkConfigPoller,
   TriggerEngine,