@active-reach/web-sdk 1.14.0 → 1.15.0

package/dist/core/analytics.d.ts.map

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

package/dist/core/bootstrap.d.ts

@@ -38,14 +38,30 @@ export interface BootstrapResult {
      */
     eventGovernance: EventGovernanceHint | null;
     /**
-     * Plugin-handshake P1 — workspace_code allowlist for SDK path-segment
-     * detection. Empty array = no workspace codes registered for this org
-     * (single-outlet tenant). SDK uses this set to decide whether
-     * `location.pathname.split('/')[1]` is a valid workspace slug vs a
-     * generic route (e.g. `/products`, `/collections`). Pass to
-     * `aegis.ingestWorkspaceCodes()` after bootstrap completes.
+     * @deprecated since P15.1 (2026-05-26) — use `locationCodes` instead.
+     * Pre-2026-05-26 the path segment after the brand subdomain was a
+     * workspace_code; the canonical hierarchy reversal made it a
+     * location_code (outlet under a brand). Field name retained for
+     * backward compat with SDK consumers that haven't migrated; new
+     * consumers MUST read `locationCodes`. Server still populates BOTH
+     * with the same array during the deprecation window so a stale
+     * SDK keeps working.
      */
     workspaceCodes: string[];
+    /**
+     * P15.1 — outlet-code allowlist for SDK path-segment detection.
+     * Empty array = no outlet codes registered for this org (single-
+     * outlet tenant). SDK uses this set to decide whether
+     * `location.pathname.split('/')[1]` is a valid outlet code vs a
+     * generic route (`/products`, `/collections`). Pass to
+     * `aegis.ingestLocationCodes()` after bootstrap completes.
+     *
+     * Same array contents as `workspaceCodes` during the deprecation
+     * window — renaming the field gives semantic clarity (these ARE
+     * location codes under the new hierarchy) without breaking
+     * existing consumers.
+     */
+    locationCodes: string[];
 }
 export declare class BootstrapError extends Error {
     readonly status: number;

package/dist/core/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/core/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,eAAe,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,YAAY,CAAC;IACpF,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,eAAe,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC5C;;;;;;;OAOG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,qBAAa,cAAe,SAAQ,KAAK;aACX,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI5D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAIpD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAqB5D;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,eAAe,CAAC,CAoC1B;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBzF"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/core/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,eAAe,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,YAAY,CAAC;IACpF,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,eAAe,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC5C;;;;;;;;;OASG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB;;;;;;;;;;;;OAYG;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,qBAAa,cAAe,SAAQ,KAAK;aACX,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI5D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAIpD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAqB5D;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,eAAe,CAAC,CAoC1B;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBzF"}

package/dist/core/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAG3C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,kBAAkB,CAAa;IACvC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,WAAW,CAAC,CAAS;gBAEjB,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAE,MAAW;IAuBhE,OAAO,CAAC,WAAW;IAyBnB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,qBAAqB;IAgB7B,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,kBAAkB;IAS1B,YAAY,IAAI,MAAM;IAItB,mBAAmB,IAAI,IAAI;IAM3B,kBAAkB,IAAI,MAAM;IAI5B,aAAa,IAAI,MAAM;IAIvB,QAAQ,IAAI,YAAY;IAWxB,aAAa,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAWjE,aAAa,IAAI,UAAU;IAI3B,cAAc,IAAI,MAAM,GAAG,SAAS;IAIpC,OAAO,IAAI,IAAI;CAMhB"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAG3C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,kBAAkB,CAAa;IACvC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,WAAW,CAAC,CAAS;gBAEjB,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAE,MAAW;IAuBhE,OAAO,CAAC,WAAW;IAyBnB,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,qBAAqB;IAgB7B,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,kBAAkB;IAS1B,YAAY,IAAI,MAAM;IAItB,mBAAmB,IAAI,IAAI;IAM3B,kBAAkB,IAAI,MAAM;IAI5B,aAAa,IAAI,MAAM;IAIvB,QAAQ,IAAI,YAAY;IAWxB,aAAa,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAWjE,aAAa,IAAI,UAAU;IAI3B,cAAc,IAAI,MAAM,GAAG,SAAS;IAIpC,OAAO,IAAI,IAAI;CAMhB"}

package/dist/ecommerce/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * E-Commerce helper methods for the Aegis SDK.
+ * E-Commerce helper methods for the Active Reach SDK.
  *
  * Provides standardized e-commerce event tracking that maps to the
  * Active Reach Intelligence data governance pipeline.

package/dist/inapp/AegisInAppManager.d.ts

@@ -187,6 +187,38 @@ export declare class AegisInAppManager {
     initialize(): Promise<void>;
     updateUserId(userId: string): void;
     updateContactId(contactId: string): void;
+    private refreshDebounceTimer?;
+    private static readonly REFRESH_DEBOUNCE_MS;
+    /**
+     * Qualifying-event refresh — schedule a debounced `refreshCampaigns()`
+     * call in response to a host-app SDK event (`aegis.page()`,
+     * `aegis.screen()`, `aegis.track(name)`). Matches CleverTap / MoEngage /
+     * WebEngage's "refresh on qualifying event" shape, translated to the
+     * browser session.
+     *
+     * Why: new server-side eligibility opens on these events (a `page` view
+     * arms route-targeted campaigns; a `track('product_viewed')` arms
+     * trigger-gated campaigns whose `client_trigger.config.event` matches).
+     * Pre-P1, the SDK only refreshed on `initialize()` + `updateContactId()`
+     * + the SSE update channel (which storefront has disabled by design),
+     * so newly armed campaigns were invisible until the next identity flip.
+     *
+     * Debounce: 300ms. Five `page()` calls inside the window coalesce to
+     * one fetch; a sixth call ≥300ms after the prior burst starts a new
+     * fetch. The trailing-edge schedule (re-arm on every call) is correct
+     * for storefront rage-clicks + SPA route bursts — we want the LATEST
+     * URL's eligibility, not the first.
+     *
+     * Safe to call on the server (no-op when `setTimeout` is unavailable
+     * — though that's vanishingly rare in any modern environment we ship to).
+     *
+     * `eventName` is currently used only for the debug log line; it's
+     * preserved on the signature so a future P-phase can pass it through
+     * to `/v1/in-app/active?trigger_event=<name>` for the optional
+     * server-side eligibility-on-this-event optimization noted in the
+     * P1 plan.
+     */
+    refreshOnEvent(eventName: string): void;
     /**
      * Conversion-aware suppression. Call this when the host app observes a
      * goal event (purchase, order_placed, checkout_completed, or any custom

package/dist/inapp/AegisInAppManager.d.ts.map

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

package/dist/index.js

@@ -1,5 +1,5 @@
-import { S as Storage, l as logger, A as Aegis } from "./analytics-DGt-CSgi.mjs";
-import { B, E, N, R, U, m } from "./analytics-DGt-CSgi.mjs";
+import { S as Storage, l as logger, A as Aegis } from "./analytics-CjLItVo2.mjs";
+import { B, E, N, R, U, m } from "./analytics-CjLItVo2.mjs";
 import { AegisWebPush } from "./push/AegisWebPush.js";
 function debounce(func, wait) {
   let timeoutId = null;
@@ -784,7 +784,7 @@ const _AegisInAppManager = class _AegisInAppManager {
   emitError(err, context) {
     const handlers = this.hooks.get("error");
     if (!handlers || handlers.size === 0) {
-      this.log(`Aegis SDK error: ${err instanceof Error ? err.message : String(err)}`, "error");
+      this.log(`Active Reach SDK error: ${err instanceof Error ? err.message : String(err)}`, "error");
       return;
     }
     for (const handler of handlers) {
@@ -880,6 +880,49 @@ const _AegisInAppManager = class _AegisInAppManager {
     }
     this.refreshCampaigns();
   }
+  /**
+   * Qualifying-event refresh — schedule a debounced `refreshCampaigns()`
+   * call in response to a host-app SDK event (`aegis.page()`,
+   * `aegis.screen()`, `aegis.track(name)`). Matches CleverTap / MoEngage /
+   * WebEngage's "refresh on qualifying event" shape, translated to the
+   * browser session.
+   *
+   * Why: new server-side eligibility opens on these events (a `page` view
+   * arms route-targeted campaigns; a `track('product_viewed')` arms
+   * trigger-gated campaigns whose `client_trigger.config.event` matches).
+   * Pre-P1, the SDK only refreshed on `initialize()` + `updateContactId()`
+   * + the SSE update channel (which storefront has disabled by design),
+   * so newly armed campaigns were invisible until the next identity flip.
+   *
+   * Debounce: 300ms. Five `page()` calls inside the window coalesce to
+   * one fetch; a sixth call ≥300ms after the prior burst starts a new
+   * fetch. The trailing-edge schedule (re-arm on every call) is correct
+   * for storefront rage-clicks + SPA route bursts — we want the LATEST
+   * URL's eligibility, not the first.
+   *
+   * Safe to call on the server (no-op when `setTimeout` is unavailable
+   * — though that's vanishingly rare in any modern environment we ship to).
+   *
+   * `eventName` is currently used only for the debug log line; it's
+   * preserved on the signature so a future P-phase can pass it through
+   * to `/v1/in-app/active?trigger_event=<name>` for the optional
+   * server-side eligibility-on-this-event optimization noted in the
+   * P1 plan.
+   */
+  refreshOnEvent(eventName) {
+    if (!this.isInitialized) {
+      this.log(`refreshOnEvent(${eventName}) before initialize — ignored`);
+      return;
+    }
+    if (this.refreshDebounceTimer) {
+      clearTimeout(this.refreshDebounceTimer);
+    }
+    this.refreshDebounceTimer = setTimeout(() => {
+      this.refreshDebounceTimer = void 0;
+      this.log(`refreshOnEvent(${eventName}) — firing refreshCampaigns()`);
+      void this.refreshCampaigns();
+    }, _AegisInAppManager.REFRESH_DEBOUNCE_MS);
+  }
   /**
    * Conversion-aware suppression. Call this when the host app observes a
    * goal event (purchase, order_placed, checkout_completed, or any custom
@@ -2814,6 +2857,10 @@ const _AegisInAppManager = class _AegisInAppManager {
   }
   destroy(options) {
     this.disconnectSSE();
+    if (this.refreshDebounceTimer) {
+      clearTimeout(this.refreshDebounceTimer);
+      this.refreshDebounceTimer = void 0;
+    }
     if (typeof document !== "undefined") {
       document.querySelectorAll(
         ".aegis-in-app-banner, .aegis-in-app-modal-overlay, .aegis-in-app-fullscreen-overlay, .aegis-in-app-half-interstitial-overlay, .aegis-in-app-alert-overlay, .aegis-in-app-pip, .aegis-in-app-nps-overlay, .aegis-in-app-countdown-overlay, .aegis-in-app-rating-overlay, .aegis-in-app-poll-overlay, .aegis-in-app-quiz-overlay, .aegis-in-app-rating-card, .aegis-in-app-nps-card"
@@ -2835,6 +2882,7 @@ const _AegisInAppManager = class _AegisInAppManager {
   }
 };
 _AegisInAppManager.CONVERSION_STORAGE_PREFIX = "aegis_conv_";
+_AegisInAppManager.REFRESH_DEBOUNCE_MS = 300;
 let AegisInAppManager = _AegisInAppManager;
 function renderPreview(config) {
   document.querySelectorAll(
@@ -4048,6 +4096,244 @@ class TriggerEngine {
     }
   }
 }
+function isIntentLeaf(expr) {
+  return "signal" in expr;
+}
+function evaluateLeaf(leaf, snapshot) {
+  const actual = snapshot[leaf.signal];
+  if (actual === void 0 || actual === null) {
+    return null;
+  }
+  const want = leaf.value;
+  switch (leaf.op) {
+    case "gte":
+    case "lte":
+    case "gt":
+    case "lt": {
+      if (typeof actual !== "number" || typeof want !== "number") return false;
+      if (leaf.op === "gte") return actual >= want;
+      if (leaf.op === "lte") return actual <= want;
+      if (leaf.op === "gt") return actual > want;
+      return actual < want;
+    }
+    case "eq":
+      return actual === want;
+    case "neq":
+      return actual !== want;
+    case "in":
+    case "nin": {
+      if (!Array.isArray(want)) return false;
+      const isMember = want.some((v) => v === actual);
+      return leaf.op === "in" ? isMember : !isMember;
+    }
+    default: {
+      leaf.op;
+      return false;
+    }
+  }
+}
+function evaluateExpr(expr, snapshot) {
+  if (isIntentLeaf(expr)) {
+    return evaluateLeaf(expr, snapshot);
+  }
+  switch (expr.op) {
+    case "AND": {
+      for (const operand of expr.operands) {
+        const v = evaluateExpr(operand, snapshot);
+        if (v === null) return false;
+        if (!v) return false;
+      }
+      return true;
+    }
+    case "OR": {
+      let allNull = true;
+      for (const operand of expr.operands) {
+        const v = evaluateExpr(operand, snapshot);
+        if (v === true) return true;
+        if (v !== null) allNull = false;
+      }
+      return allNull ? null : false;
+    }
+    case "NOT": {
+      const v = evaluateExpr(expr.operands[0], snapshot);
+      if (v === null) return null;
+      return !v;
+    }
+    default: {
+      return false;
+    }
+  }
+}
+function evaluateRule(rule, snapshot) {
+  const result = evaluateExpr(rule.when, snapshot);
+  return result === true;
+}
+class IntentRuleEvaluator {
+  constructor() {
+    this.armed = [];
+    this.snapshot = {};
+    this.firedThisSession = /* @__PURE__ */ new Set();
+    this.silencedThisSession = /* @__PURE__ */ new Set();
+  }
+  // ─── snapshot management ───
+  updateSignal(signal, value) {
+    this.snapshot[signal] = value;
+  }
+  updateSnapshot(partial) {
+    Object.assign(this.snapshot, partial);
+  }
+  getSnapshot() {
+    return this.snapshot;
+  }
+  // ─── armed-campaign management ───
+  setArmed(campaigns) {
+    this.armed = [...campaigns];
+  }
+  getArmed() {
+    return this.armed;
+  }
+  markFired(campaignId) {
+    this.firedThisSession.add(campaignId);
+  }
+  /** Clear all per-session state. Caller invokes on logout or explicit
+   *  session reset. */
+  reset() {
+    this.firedThisSession.clear();
+    this.silencedThisSession.clear();
+  }
+  // ─── the main dispatch ───
+  /**
+   * Called every time a signal value changes meaningfully (e.g. a
+   * TriggerEngine `exit_intent` event, or a `scroll_depth_50` crossing
+   * threshold, or the Layer-1 fetch finishing). Returns the decision the
+   * caller should act on.
+   *
+   * Algorithm:
+   *   1. Filter armed campaigns to those whose `fire_on` includes the
+   *      signal that just changed.
+   *   2. Drop already-fired and silenced campaigns.
+   *   3. Sort the remainder by priority DESC, tie-broken by campaign id
+   *      lexicographic (per plan §"Pattern ordering rules").
+   *   4. Walk the sorted list:
+   *      - If a suppress_competing rule matches, emit a 'suppress'
+   *        decision listing every lower-priority armed campaign id.
+   *        Mark those as silenced internally too.
+   *      - Otherwise the first matching rule emits 'fire'.
+   *   5. If nothing matches, return 'none'.
+   */
+  onSignalChanged(signal) {
+    const candidates = this.armed.filter((c) => c.rule.fire_on.includes(signal)).filter((c) => !this.firedThisSession.has(c.id)).filter((c) => !this.silencedThisSession.has(c.id)).sort((a, b) => {
+      if (b.rule.priority !== a.rule.priority) {
+        return b.rule.priority - a.rule.priority;
+      }
+      return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+    });
+    for (let i = 0; i < candidates.length; i++) {
+      const c = candidates[i];
+      if (!evaluateRule(c.rule, this.snapshot)) continue;
+      if (c.rule.suppress_competing) {
+        const suppressIds = this.armed.filter((other) => other.id !== c.id).map((other) => other.id);
+        suppressIds.forEach((id) => this.silencedThisSession.add(id));
+        return {
+          kind: "suppress",
+          campaignId: c.id,
+          suppressIds
+        };
+      }
+      return { kind: "fire", campaignId: c.id };
+    }
+    return { kind: "none" };
+  }
+}
+class ContactScoresFetcher {
+  constructor(cfg) {
+    this.lastFetchedAt = 0;
+    this.latestSnapshot = null;
+    this.apiHost = cfg.apiHost.replace(/\/$/, "");
+    this.writeKey = cfg.writeKey;
+    this.organizationId = cfg.organizationId;
+    this.evaluator = cfg.evaluator;
+    this.dedupWindowMs = cfg.dedupWindowMs ?? 6e4;
+    this.fetchImpl = cfg.fetchImpl ?? (typeof fetch !== "undefined" ? fetch.bind(globalThis) : (() => Promise.reject(new Error("fetch unavailable"))));
+    this.onError = cfg.onError;
+  }
+  /** Update the org so subsequent fetches scope correctly (e.g. when
+   *  the SDK resolves an org id after init). */
+  updateOrganizationId(organizationId) {
+    this.organizationId = organizationId;
+  }
+  /** Most recent successful response. `null` when no fetch has succeeded
+   *  yet, OR when the endpoint returned 204 (unscored). Consumers can
+   *  poll this for diagnostic UIs; campaign evaluation does not need to
+   *  read it directly because the evaluator (if configured) already has
+   *  the snapshot applied. */
+  getSnapshot() {
+    return this.latestSnapshot;
+  }
+  /** Fetch scores for `contactId` and apply to the configured evaluator
+   *  (if any). Returns the response on success, null on 204 / error.
+   *
+   *  Session-dedup: repeat calls for the same contactId within
+   *  `dedupWindowMs` are no-ops. Pass `force: true` to override. */
+  async fetchForContact(contactId, opts = {}) {
+    var _a;
+    if (!contactId) return null;
+    const now = Date.now();
+    if (!opts.force && this.lastFetchedContactId === contactId && now - this.lastFetchedAt < this.dedupWindowMs) {
+      return this.latestSnapshot;
+    }
+    this.lastFetchedContactId = contactId;
+    this.lastFetchedAt = now;
+    const headers = {
+      "X-Aegis-Write-Key": this.writeKey,
+      "X-Contact-ID": contactId,
+      "X-User-ID": contactId
+    };
+    if (this.organizationId) {
+      headers["X-Organization-ID"] = this.organizationId;
+    }
+    try {
+      const resp = await this.fetchImpl(
+        `${this.apiHost}/v1/sdk/contact-scores`,
+        {
+          method: "GET",
+          headers,
+          credentials: "include"
+        }
+      );
+      if (resp.status === 204) {
+        this.latestSnapshot = null;
+        return null;
+      }
+      if (!resp.ok) {
+        this.latestSnapshot = null;
+        return null;
+      }
+      const payload = await resp.json();
+      this.latestSnapshot = payload;
+      if (this.evaluator) {
+        this.evaluator.updateSnapshot(toIntentSnapshot(payload));
+      }
+      return payload;
+    } catch (err) {
+      (_a = this.onError) == null ? void 0 : _a.call(this, err, contactId);
+      return null;
+    }
+  }
+}
+function toIntentSnapshot(r) {
+  const snap = {};
+  if (r.rfm_segment) snap.rfm_segment = r.rfm_segment;
+  if (r.lifecycle_stage) snap.lifecycle_stage = r.lifecycle_stage;
+  if (r.churn_risk_tier) snap.churn_risk_tier = r.churn_risk_tier;
+  if (r.predicted_ltv_tier) snap.predicted_ltv_tier = r.predicted_ltv_tier;
+  if (typeof r.predicted_ltv === "number") snap.predicted_ltv = r.predicted_ltv;
+  if (typeof r.price_sensitivity_score === "number") {
+    snap.price_sensitivity_score = r.price_sensitivity_score;
+  }
+  if (r.scoring_tier) snap.scoring_tier = r.scoring_tier;
+  return snap;
+}
 class SdkConfigPoller {
   constructor(options) {
     this.currentETag = null;
@@ -6639,6 +6925,7 @@ class AegisMessageRuntime {
     this.initialized = false;
     const triggerEngine = config.triggerEngine ?? new TriggerEngine();
     const ownsTriggerEngine = !config.triggerEngine;
+    this.contactId = config.contactId;
     this.widgets = new AegisWidgetManager({
       writeKey: config.writeKey,
       apiHost: config.apiHost,
@@ -6669,6 +6956,16 @@ class AegisMessageRuntime {
       },
       getWorkspaceId: config.getWorkspaceId
     });
+    this.intentRuleEvaluator = new IntentRuleEvaluator();
+    this.contactScores = new ContactScoresFetcher({
+      // Falls back to same-origin when no apiHost configured (storefront
+      // typical case) — matches WidgetManager/InAppManager handling
+      // where `config.apiHost` is also `string | undefined`.
+      apiHost: config.apiHost ?? "",
+      writeKey: config.writeKey,
+      organizationId: config.organizationId,
+      evaluator: this.intentRuleEvaluator
+    });
   }
   /**
    * Boots both managers in parallel. Safe to call multiple times — the
@@ -6681,6 +6978,9 @@ class AegisMessageRuntime {
       this.inApp.initialize(),
       this.widgets.initialize()
     ]);
+    if (this.contactId) {
+      void this.contactScores.fetchForContact(this.contactId);
+    }
   }
   /**
    * Both managers carry contactId. Updates both so the server-side
@@ -6692,8 +6992,10 @@ class AegisMessageRuntime {
    */
   async updateContactId(contactId) {
     var _a, _b;
+    this.contactId = contactId;
     (_b = (_a = this.inApp).updateContactId) == null ? void 0 : _b.call(_a, contactId);
     await this.widgets.updateContactId(contactId);
+    void this.contactScores.fetchForContact(contactId);
   }
   /**
    * Forward a client-side event (product_viewed, cart_idle_90s, etc.)
@@ -6706,6 +7008,50 @@ class AegisMessageRuntime {
     var _a, _b;
     (_b = (_a = this.inApp).onClientEvent) == null ? void 0 : _b.call(_a, eventName, eventData);
   }
+  // --- Qualifying-event refresh facade (DLR Tracker 1 / P1, 2026-05-28) ---
+  //
+  // `track`, `page`, and `screen` here are thin trigger taps for the
+  // in-app subsystem — they tell `AegisInAppManager.refreshOnEvent` that
+  // a host-app event happened, and the debounced refresh re-fetches
+  // `/v1/in-app/active` so newly armed campaigns become visible without
+  // waiting for the next identity flip. They are NOT a substitute for
+  // the main analytics SDK (`Aegis` in `core/analytics.ts`) — those
+  // methods own the canonical capture path (batch uplink, governance,
+  // workspace resolution, etc.). Integrations that already call
+  // `aegis.track(...)` should also call `runtime.track(...)` to drive
+  // the in-app refresh. A future P-phase will bridge the two so a single
+  // call on the public analytics surface drives both behaviors.
+  /**
+   * Notify the in-app subsystem that a tracked event occurred. Schedules
+   * a debounced refresh of armed campaigns so newly eligible in-app
+   * messages (e.g., trigger-gated on `cart_item_added`) become visible
+   * within ~300ms — bursts coalesce. See
+   * `AegisInAppManager.refreshOnEvent` for debounce semantics and why
+   * this matters under storefront polling.
+   */
+  track(eventName) {
+    if (!eventName) return;
+    this.inApp.refreshOnEvent(eventName);
+  }
+  /**
+   * Notify the in-app subsystem that a URL-bound page view occurred.
+   * Mirrors `aegis.page()` semantics — fires `'page_view'` as the
+   * qualifying event so the trailing debounce covers SPA route bursts
+   * (history.pushState rapid-fire) without spamming the endpoint.
+   */
+  page(name) {
+    this.inApp.refreshOnEvent(name ?? "page_view");
+  }
+  /**
+   * Notify the in-app subsystem that a SPA-logical screen view occurred
+   * (cart drawer open, checkout step transition — anywhere `aegis.screen()`
+   * is called). Refresh-on-screen lets per-screen-targeted campaigns
+   * arm without a URL change.
+   */
+  screen(name) {
+    if (!name) return;
+    this.inApp.refreshOnEvent(name);
+  }
   /**
    * Conversion-aware suppression — call when the host app observes a
    * goal event (purchase / order_completed / checkout_completed / custom).