@active-reach/web-sdk 1.13.0 → 1.14.1

package/dist/{analytics-Mh4H4ekQ.mjs → analytics-CjLItVo2.mjs}

@@ -56,7 +56,7 @@ function generateMessageId() {
 class Logger {
   constructor() {
     this.enabled = false;
-    this.prefix = "[Aegis SDK]";
+    this.prefix = "[Active Reach SDK]";
   }
   enable() {
     this.enabled = true;
@@ -216,6 +216,7 @@ class SessionManager {
     this.sessionStartTime = Date.now();
     this.lastActivityTime = Date.now();
     this.eventCount = 0;
+    this.sessionId = newSessionId;
     this.persistSession();
     logger.info("New session created:", newSessionId);
     return newSessionId;
@@ -824,7 +825,7 @@ class Storage {
         };
         localStorage.setItem(fullKey, JSON.stringify(item));
       } catch (error) {
-        console.warn("[Aegis Storage] localStorage.setItem failed:", error);
+        console.warn("[Active Reach Storage] localStorage.setItem failed:", error);
       }
     }
     this.setCookie(fullKey, value, expiryDays);
@@ -843,7 +844,7 @@ class Storage {
           }
         }
       } catch (error) {
-        console.warn("[Aegis Storage] localStorage.getItem failed:", error);
+        console.warn("[Active Reach Storage] localStorage.getItem failed:", error);
       }
     }
     return this.getCookie(fullKey);
@@ -854,7 +855,7 @@ class Storage {
       try {
         localStorage.removeItem(fullKey);
       } catch (error) {
-        console.warn("[Aegis Storage] localStorage.removeItem failed:", error);
+        console.warn("[Active Reach Storage] localStorage.removeItem failed:", error);
       }
     }
     this.deleteCookie(fullKey);
@@ -869,7 +870,7 @@ class Storage {
           }
         });
       } catch (error) {
-        console.warn("[Aegis Storage] localStorage.clear failed:", error);
+        console.warn("[Active Reach Storage] localStorage.clear failed:", error);
       }
     }
     const cookies = document.cookie.split(";");
@@ -900,7 +901,7 @@ class Storage {
       }
       document.cookie = cookieStr;
     } catch (error) {
-      console.warn("[Aegis Storage] setCookie failed:", error);
+      console.warn("[Active Reach Storage] setCookie failed:", error);
     }
   }
   getCookie(name) {
@@ -917,7 +918,7 @@ class Storage {
         }
       }
     } catch (error) {
-      console.warn("[Aegis Storage] getCookie failed:", error);
+      console.warn("[Active Reach Storage] getCookie failed:", error);
     }
     return null;
   }
@@ -934,7 +935,7 @@ class Storage {
       }
       document.cookie = cookieStr;
     } catch (error) {
-      console.warn("[Aegis Storage] deleteCookie failed:", error);
+      console.warn("[Active Reach Storage] deleteCookie failed:", error);
     }
   }
   getRootDomain() {
@@ -952,7 +953,7 @@ class Storage {
       }
       return `.${parts.slice(-2).join(".")}`;
     } catch (error) {
-      console.warn("[Aegis Storage] getRootDomain failed:", error);
+      console.warn("[Active Reach Storage] getRootDomain failed:", error);
       return null;
     }
   }
@@ -977,7 +978,7 @@ function parseUTMParameters(url) {
     });
     return utm;
   } catch (error) {
-    console.warn("[Aegis URL Parser] parseUTMParameters failed:", error);
+    console.warn("[Active Reach URL Parser] parseUTMParameters failed:", error);
     return {};
   }
 }
@@ -1001,7 +1002,7 @@ function parseAdClickIDs(url) {
     });
     return adClickIDs;
   } catch (error) {
-    console.warn("[Aegis URL Parser] parseAdClickIDs failed:", error);
+    console.warn("[Active Reach URL Parser] parseAdClickIDs failed:", error);
     return {};
   }
 }
@@ -1130,7 +1131,7 @@ function detectNetworkInfo() {
       };
     }
   } catch (error) {
-    console.warn("[Aegis Device] detectNetworkInfo failed:", error);
+    console.warn("[Active Reach Device] detectNetworkInfo failed:", error);
   }
   return void 0;
 }
@@ -1764,6 +1765,24 @@ class EcommerceTracker {
       variant_id: wishlist.product.variant_id
     });
   }
+  // -- Back-in-stock waitlist --
+  //
+  // Server-side substrate: contact_events row keyed on
+  // (organization_id, contact_id, event_name='product_waitlisted',
+  //  event_properties['product_id']). Resolved by
+  // product_event_trigger_service._get_waitlisted_contacts and fanned out via
+  // catalog.back_in_stock journey trigger when stock_event_handler_worker
+  // detects the SKU flipping back into stock.
+  productWaitlisted(waitlist) {
+    this.aegis.track("product_waitlisted", {
+      product_id: waitlist.product.product_id,
+      sku: waitlist.product.sku ?? waitlist.product.product_id,
+      variant_id: waitlist.product.variant_id,
+      name: waitlist.product.name,
+      price: waitlist.product.price,
+      channels: waitlist.channels
+    });
+  }
   // -- Promotions --
   promotionViewed(promo) {
     this.aegis.track("promotion_viewed", { ...promo });
@@ -1837,7 +1856,7 @@ class RateLimiter {
       try {
         this.onDropBatch(this.droppedThisWindow, this.firstDroppedName);
       } catch (err) {
-        logger.warn("[Aegis] RateLimiter.onDropBatch threw:", err);
+        logger.warn("[Active Reach] RateLimiter.onDropBatch threw:", err);
       }
     }
     this.droppedThisWindow = 0;
@@ -2209,7 +2228,7 @@ const _TraitGovernor = class _TraitGovernor {
     if (count >= _TraitGovernor.WARN_CAP) return;
     perVerdict.set(drop.verdict, count + 1);
     warnOnConsole(
-      `[Aegis SDK] trait ${drop.verdict}: ${drop.reason} (original key: ${JSON.stringify(drop.originalKey)}). Backend will reject; fix the SDK call to silence this warning.`
+      `[Active Reach SDK] trait ${drop.verdict}: ${drop.reason} (original key: ${JSON.stringify(drop.originalKey)}). Backend will reject; fix the SDK call to silence this warning.`
     );
   }
 };
@@ -2362,6 +2381,9 @@ class Aegis {
     this._originalPushState = null;
     this._originalReplaceState = null;
     this._lastEventIds = /* @__PURE__ */ new Map();
+    this._workspaceCodes = /* @__PURE__ */ new Set();
+    this._runtimeWorkspace = null;
+    this._runtimeLocation = null;
   }
   async init(writeKey, config) {
     if (this.initPromise) {
@@ -2388,7 +2410,7 @@ class Aegis {
     if (this.config.debug) {
       logger.enable();
     }
-    logger.info("Initializing Aegis SDK...", this.config);
+    logger.info("Initializing Active Reach SDK...", this.config);
     this.storage = new Storage({
       cookieDomain: this.config.cookie_domain,
       secureCookie: this.config.secure_cookie,
@@ -2448,7 +2470,7 @@ class Aegis {
       this.page();
       this.startSPATracking();
     }
-    logger.info("Aegis SDK initialized successfully");
+    logger.info("Active Reach SDK initialized successfully");
   }
   /**
    * SPA navigation tracking — monkey-patches pushState/replaceState and
@@ -2543,6 +2565,244 @@ class Aegis {
   removePlugin(name) {
     this.plugins.unregister(name);
   }
+  /**
+   * Plugin-handshake P1 — ingest the workspace_code allowlist from the
+   * bootstrap response. Pass `result.workspaceCodes` from `bootstrap()`
+   * here so the SDK can do path-segment workspace detection on
+   * customer-facing pages like `/south/rewards`, `/ghatkopar/feedback`.
+   *
+   * Empty array is the right answer for single-outlet tenants — SDK
+   * will skip the path cascade and fall through to query param /
+   * setWorkspace() / gateway origin lookup.
+   *
+   * Safe to call before init() — the set is consulted at event-fire time.
+   */
+  ingestWorkspaceCodes(codes) {
+    this._workspaceCodes = new Set(
+      (codes ?? []).filter((c) => typeof c === "string" && c.length > 0)
+    );
+    logger.debug("Workspace codes ingested", { count: this._workspaceCodes.size });
+  }
+  /**
+   * Plugin-handshake P1 (Track E) — explicitly set the workspace for
+   * subsequent events. Used by:
+   *   - SPAs where workspace context changes via in-app routing
+   *   - Mobile / RN apps that have no URL
+   *   - Custom integrations that resolve workspace from their own state
+   *
+   * Pass null to clear (or call clearWorkspace()).
+   *
+   * Persisted to sessionStorage so SPA reloads / page transitions on the
+   * same outlet inherit it without re-calling.
+   */
+  setWorkspace(codeOrId) {
+    this._runtimeWorkspace = codeOrId;
+    if (typeof window !== "undefined" && window.sessionStorage) {
+      try {
+        if (codeOrId) {
+          window.sessionStorage.setItem("aegis_runtime_ws", codeOrId);
+        } else {
+          window.sessionStorage.removeItem("aegis_runtime_ws");
+        }
+      } catch {
+      }
+    }
+    logger.debug("Runtime workspace set", { value: codeOrId });
+  }
+  /** Symmetric helper to clear the runtime workspace. */
+  clearWorkspace() {
+    this.setWorkspace(null);
+  }
+  // ── P15.1 — location (outlet) facade ─────────────────────────
+  //
+  // Under the post-2026-05-26 canonical hierarchy:
+  //   workspace_id = brand-tenant (one per brand)
+  //   location_id  = outlet within a brand
+  // The two are distinct dimensions. Both can be stamped on the
+  // same event. These methods mirror the workspace facade but
+  // resolve the outlet specifically.
+  /**
+   * P15.1 — ingest the outlet-code allowlist from bootstrap. The
+   * SDK consults this set when reading the URL path segment to
+   * decide whether `location.pathname.split('/')[1]` is a valid
+   * outlet code vs a generic route.
+   *
+   * Empty array = single-outlet tenant; SDK skips the path-segment
+   * cascade for location resolution.
+   *
+   * Safe to call before init(); the set is consulted at event-
+   * fire time.
+   */
+  ingestLocationCodes(codes) {
+    this._workspaceCodes = new Set(
+      (codes ?? []).filter((c) => typeof c === "string" && c.length > 0)
+    );
+    logger.debug("Location codes ingested", { count: this._workspaceCodes.size });
+  }
+  /**
+   * P15.1 — explicitly set the active outlet for subsequent events.
+   * Used by:
+   *   - Storefronts where outlet picker fires `aegis.setLocation()`
+   *     on selection (so events that follow carry that outlet's
+   *     location_id without the SDK having to re-parse the URL).
+   *   - SPAs where outlet context changes via in-app routing.
+   *   - Mobile/RN apps that have no URL.
+   *
+   * Pass null to clear (or call clearLocation()).
+   *
+   * Persisted to sessionStorage so SPA reloads + route transitions
+   * on the same outlet inherit it without re-calling.
+   */
+  setLocation(codeOrId) {
+    this._runtimeLocation = codeOrId;
+    if (typeof window !== "undefined" && window.sessionStorage) {
+      try {
+        if (codeOrId) {
+          window.sessionStorage.setItem("aegis_runtime_location", codeOrId);
+        } else {
+          window.sessionStorage.removeItem("aegis_runtime_location");
+        }
+      } catch {
+      }
+    }
+    logger.debug("Runtime location set", { value: codeOrId });
+  }
+  /** Symmetric helper to clear the runtime location. */
+  clearLocation() {
+    this.setLocation(null);
+  }
+  /**
+   * P15.1 — same logic as `getPathWorkspaceCode()` but expresses
+   * the semantic correctly: under the new hierarchy, the first
+   * path segment after the brand subdomain IS the outlet code.
+   * Returns `undefined` when no outlet code matches the allowlist.
+   */
+  getPathLocationCode() {
+    return this.getPathWorkspaceCode();
+  }
+  /**
+   * P15.1 — resolve the effective `location_id` for the next event.
+   * Independent of `getEffectiveWorkspaceId()`: both run on every
+   * event so workspace_id (brand) and location_id (outlet) land
+   * on the same event when both are resolvable.
+   *
+   * Cascade (highest precedence first):
+   *   1. `this.config.location_id` — explicit operator config.
+   *   2. `?location=` query param (also accepts `?ws=` for back-
+   *      compat with storefronts that pass outlet via the old
+   *      param name — the value is the same; param naming only).
+   *   3. URL path segment matching the outlet-code allowlist.
+   *   4. Runtime `aegis.setLocation()` (in-memory).
+   *   5. sessionStorage `aegis_runtime_location`.
+   *   6. `undefined` — event-ingress treats as brand-tier
+   *      (no outlet attribution).
+   */
+  getEffectiveLocationId() {
+    var _a;
+    const configured = (_a = this.config) == null ? void 0 : _a.location_id;
+    if (configured) return configured;
+    if (typeof window === "undefined") return void 0;
+    try {
+      const search = new URLSearchParams(window.location.search);
+      const loc = search.get("location") || search.get("ws");
+      if (loc && loc.length > 0) return loc;
+    } catch {
+    }
+    const pathLoc = this.getPathLocationCode();
+    if (pathLoc) return pathLoc;
+    if (this._runtimeLocation) return this._runtimeLocation;
+    try {
+      if (window.sessionStorage) {
+        const cached = window.sessionStorage.getItem("aegis_runtime_location");
+        if (cached && cached.length > 0) return cached;
+      }
+    } catch {
+    }
+    return void 0;
+  }
+  /**
+   * Inspect the URL's first path segment and return it if it's in the
+   * org's workspace_code allowlist. Skips well-known non-workspace prefixes
+   * (e.g. `b` for bill short codes; `s` is the storefront app slug).
+   *
+   * Returns undefined when:
+   *   - window is undefined (SSR / Node)
+   *   - path is empty / root
+   *   - first segment isn't in `_workspaceCodes` (e.g. /products, /cart)
+   *
+   * The returned value is a workspace CODE (slug like "south"), not a
+   * UUID. The gateway normalizes code → UUID server-side via
+   * workspace_subaccounts lookup with Redis cache.
+   */
+  getPathWorkspaceCode() {
+    if (typeof window === "undefined") return void 0;
+    if (this._workspaceCodes.size === 0) return void 0;
+    try {
+      const segments = window.location.pathname.split("/").filter(Boolean);
+      if (segments.length === 0) return void 0;
+      const first = segments[0].toLowerCase();
+      return this._workspaceCodes.has(first) ? first : void 0;
+    } catch {
+      return void 0;
+    }
+  }
+  /**
+   * Resolve the effective `workspace_id` for the next event.
+   *
+   * Cascade (highest precedence first):
+   *   1. `this.config.workspace_id` — explicit operator config (headless
+   *      SDK usage, server-rendered apps, native shells).
+   *   2. `?ws=` query param on the current URL — the P3 storefront URL
+   *      contract. The outlet picker writes this via `router.replace`.
+   *   3. URL path segment (P1 Track A) — `/south/rewards` → "south" when
+   *      "south" is in the org's workspace_code allowlist.
+   *   4. `aegis.setWorkspace()` runtime override (P1 Track E) — SPAs +
+   *      mobile + custom integrations.
+   *   5. sessionStorage `aegis_runtime_ws` — persists setWorkspace across
+   *      reloads/SPA route changes.
+   *   6. `undefined` — gateway falls back to `resolveByOrigin` lookup
+   *      against the property's allowed_origins.
+   *
+   * The returned value can be EITHER a UUID (from config / ?ws=) or a
+   * workspace CODE slug (from path / setWorkspace). The gateway
+   * normalizes slug → UUID server-side; analytics layer never needs to
+   * worry about the difference.
+   *
+   * See docs/architecture/MULTI_OUTLET_URL_STRATEGY.md §2.3 and
+   * docs/architecture/PLUGIN_HANDSHAKE_AUTOMATION.md §2.
+   */
+  /**
+   * Public so peer SDK surfaces (AegisMessageRuntime / AegisInAppManager /
+   * AegisPlacementManager / AegisWidgetManager) can plumb the same
+   * resolved workspace into their own gateway POSTs. Each manager calls
+   * the gateway on its own endpoint (`/v1/in_app/events`,
+   * `/v1/placements/track`, `/v1/widgets/track-event`); without this,
+   * those events arrive at event-ingress with no workspace_id stamped
+   * → impressions/clicks fall back to the org's primary workspace and
+   * cross-outlet attribution breaks.
+   */
+  getEffectiveWorkspaceId() {
+    var _a;
+    const configured = (_a = this.config) == null ? void 0 : _a.workspace_id;
+    if (configured) return configured;
+    if (typeof window === "undefined") return void 0;
+    try {
+      const ws = new URLSearchParams(window.location.search).get("ws");
+      if (ws && ws.length > 0) return ws;
+    } catch {
+    }
+    const pathWs = this.getPathWorkspaceCode();
+    if (pathWs) return pathWs;
+    if (this._runtimeWorkspace) return this._runtimeWorkspace;
+    try {
+      if (window.sessionStorage) {
+        const cached = window.sessionStorage.getItem("aegis_runtime_ws");
+        if (cached && cached.length > 0) return cached;
+      }
+    } catch {
+    }
+    return void 0;
+  }
   track(eventName, properties) {
     if (!this.assertInitialized()) return;
     const messageId = generateMessageId();
@@ -2555,7 +2815,8 @@ class Aegis {
       anonymousId: this.identity.getAnonymousId(),
       userId: this.identity.getUserId() || void 0,
       sessionId: this.session.getSessionId(),
-      workspace_id: this.config.workspace_id || void 0,
+      workspace_id: this.getEffectiveWorkspaceId(),
+      location_id: this.getEffectiveLocationId(),
       context: buildContext(this.config, this.session)
     };
     this._lastEventIds.set(eventName, messageId);
@@ -2563,7 +2824,7 @@ class Aegis {
   }
   identify(userId, traits) {
     if (!this.assertInitialized()) return;
-    const wsForGovernor = this.config.workspace_id || null;
+    const wsForGovernor = this.getEffectiveWorkspaceId() || null;
     const { sanitized: governedTraits } = this.traitGovernor.process(traits, wsForGovernor);
     this.identity.setUserId(userId, governedTraits);
     const event = {
@@ -2574,7 +2835,8 @@ class Aegis {
       anonymousId: this.identity.getAnonymousId(),
       userId,
       sessionId: this.session.getSessionId(),
-      workspace_id: this.config.workspace_id || void 0,
+      workspace_id: this.getEffectiveWorkspaceId(),
+      location_id: this.getEffectiveLocationId(),
       context: buildContext(this.config, this.session)
     };
     this.captureEvent(event);
@@ -2590,14 +2852,15 @@ class Aegis {
       anonymousId: this.identity.getAnonymousId(),
       userId: this.identity.getUserId() || void 0,
       sessionId: this.session.getSessionId(),
-      workspace_id: this.config.workspace_id || void 0,
+      workspace_id: this.getEffectiveWorkspaceId(),
+      location_id: this.getEffectiveLocationId(),
       context: buildContext(this.config, this.session)
     };
     this.captureEvent(event);
   }
   group(groupId, traits) {
     if (!this.assertInitialized()) return;
-    const wsForGovernor = this.config.workspace_id || null;
+    const wsForGovernor = this.getEffectiveWorkspaceId() || null;
     const { sanitized: governedTraits } = this.traitGovernor.process(traits, wsForGovernor);
     const event = {
       type: "group",
@@ -2647,7 +2910,8 @@ class Aegis {
       anonymousId: this.identity.getAnonymousId(),
       userId: this.identity.getUserId() || void 0,
       sessionId: this.session.getSessionId(),
-      workspace_id: this.config.workspace_id || void 0,
+      workspace_id: this.getEffectiveWorkspaceId(),
+      location_id: this.getEffectiveLocationId(),
       context: buildContext(this.config, this.session)
     };
     this.captureEvent(event);
@@ -2959,4 +3223,4 @@ export {
   logger as l,
   murmurhash3_x86_32 as m
 };
-//# sourceMappingURL=analytics-Mh4H4ekQ.mjs.map
+//# sourceMappingURL=analytics-CjLItVo2.mjs.map