@active-reach/web-sdk 1.13.0 → 1.14.0

package/dist/{analytics-Mh4H4ekQ.mjs → analytics-DGt-CSgi.mjs}

@@ -1764,6 +1764,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 });
@@ -2362,6 +2380,8 @@ class Aegis {
     this._originalPushState = null;
     this._originalReplaceState = null;
     this._lastEventIds = /* @__PURE__ */ new Map();
+    this._workspaceCodes = /* @__PURE__ */ new Set();
+    this._runtimeWorkspace = null;
   }
   async init(writeKey, config) {
     if (this.initPromise) {
@@ -2543,6 +2563,137 @@ 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);
+  }
+  /**
+   * 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 +2706,7 @@ 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(),
       context: buildContext(this.config, this.session)
     };
     this._lastEventIds.set(eventName, messageId);
@@ -2563,7 +2714,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 +2725,7 @@ class Aegis {
       anonymousId: this.identity.getAnonymousId(),
       userId,
       sessionId: this.session.getSessionId(),
-      workspace_id: this.config.workspace_id || void 0,
+      workspace_id: this.getEffectiveWorkspaceId(),
       context: buildContext(this.config, this.session)
     };
     this.captureEvent(event);
@@ -2590,14 +2741,14 @@ 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(),
       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 +2798,7 @@ 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(),
       context: buildContext(this.config, this.session)
     };
     this.captureEvent(event);
@@ -2959,4 +3110,4 @@ export {
   logger as l,
   murmurhash3_x86_32 as m
 };
-//# sourceMappingURL=analytics-Mh4H4ekQ.mjs.map
+//# sourceMappingURL=analytics-DGt-CSgi.mjs.map