@xenia-martech/sdk-js 1.0.0-dev.26 → 1.0.0-dev.27

package/dist/client/index.d.cts

@@ -1,5 +1,5 @@
-import { I as InteractionType, X as XeniaConfig, a as XeniaEvent, M as MessageCta, b as MessageTemplateFn, c as MessageComponentRenderer, d as XeniaAction } from '../actions-DFLoSXO_.cjs';
-export { A as AnalyticsContext, e as AnalyticsEventName, f as AnalyticsIdentity, g as AnalyticsIngestResponse, C as ClientEvent, h as ConsentState, i as ContentSwap, j as IdentifyRequest, k as IdentifyResponse, l as Identity, J as JsonValue, m as MessageMountContext, n as MessagePlacement, o as MessageRenderContext, P as PersonalizationSwap, R as ResolveBatchItem, p as ResolveBatchResult, q as ResolveOptions, r as ResolveResult, T as TrackOptions, W as WebhookResponse, s as XeniaClient, t as XeniaClientOptions, u as createXeniaClient, v as extractContentSwaps, w as parseActions, x as spliceSlots } from '../actions-DFLoSXO_.cjs';
+import { I as InteractionType, X as XeniaConfig, a as XeniaEvent, M as MessageCta, b as MessageTemplateFn, c as MessageComponentRenderer, d as XeniaAction } from '../actions-CkiSdvSa.cjs';
+export { A as AnalyticsContext, e as AnalyticsEventName, f as AnalyticsIdentity, g as AnalyticsIngestResponse, C as ClientEvent, h as ConsentState, i as ContentSwap, j as IdentifyRequest, k as IdentifyResponse, l as Identity, J as JsonValue, m as MessageMountContext, n as MessagePlacement, o as MessageRenderContext, P as PersonalizationSwap, R as ResolveBatchItem, p as ResolveBatchResult, q as ResolveOptions, r as ResolveResult, T as TrackOptions, W as WebhookResponse, s as XeniaClient, t as XeniaClientOptions, u as createXeniaClient, v as extractContentSwaps, w as parseActions, x as spliceSlots } from '../actions-CkiSdvSa.cjs';
 
 interface Parsed {
     eventId: string;

package/dist/client/index.d.ts

@@ -1,5 +1,5 @@
-import { I as InteractionType, X as XeniaConfig, a as XeniaEvent, M as MessageCta, b as MessageTemplateFn, c as MessageComponentRenderer, d as XeniaAction } from '../actions-DFLoSXO_.js';
-export { A as AnalyticsContext, e as AnalyticsEventName, f as AnalyticsIdentity, g as AnalyticsIngestResponse, C as ClientEvent, h as ConsentState, i as ContentSwap, j as IdentifyRequest, k as IdentifyResponse, l as Identity, J as JsonValue, m as MessageMountContext, n as MessagePlacement, o as MessageRenderContext, P as PersonalizationSwap, R as ResolveBatchItem, p as ResolveBatchResult, q as ResolveOptions, r as ResolveResult, T as TrackOptions, W as WebhookResponse, s as XeniaClient, t as XeniaClientOptions, u as createXeniaClient, v as extractContentSwaps, w as parseActions, x as spliceSlots } from '../actions-DFLoSXO_.js';
+import { I as InteractionType, X as XeniaConfig, a as XeniaEvent, M as MessageCta, b as MessageTemplateFn, c as MessageComponentRenderer, d as XeniaAction } from '../actions-CkiSdvSa.js';
+export { A as AnalyticsContext, e as AnalyticsEventName, f as AnalyticsIdentity, g as AnalyticsIngestResponse, C as ClientEvent, h as ConsentState, i as ContentSwap, j as IdentifyRequest, k as IdentifyResponse, l as Identity, J as JsonValue, m as MessageMountContext, n as MessagePlacement, o as MessageRenderContext, P as PersonalizationSwap, R as ResolveBatchItem, p as ResolveBatchResult, q as ResolveOptions, r as ResolveResult, T as TrackOptions, W as WebhookResponse, s as XeniaClient, t as XeniaClientOptions, u as createXeniaClient, v as extractContentSwaps, w as parseActions, x as spliceSlots } from '../actions-CkiSdvSa.js';
 
 interface Parsed {
     eventId: string;

package/dist/client/index.js

@@ -964,6 +964,40 @@ var Identity = class {
       return null;
     }
   }
+  // ── Customer id / email ──────────────────────────────────────────────────
+  //
+  // Ambient, persisted the same way as the visitor id, so a value set once
+  // (typically alongside `identify()`) rides on every later `resolve()` call
+  // without the caller having to pass it again — the SDK-provided-fields
+  // parity list on the Personalization Resolve trigger includes both.
+  setCustomerId(customerId) {
+    try {
+      if (customerId) localStorage.setItem(this.key("customer_id"), customerId);
+      else localStorage.removeItem(this.key("customer_id"));
+    } catch {
+    }
+  }
+  getCustomerId() {
+    try {
+      return localStorage.getItem(this.key("customer_id"));
+    } catch {
+      return null;
+    }
+  }
+  setEmail(email) {
+    try {
+      if (email) localStorage.setItem(this.key("email"), email);
+      else localStorage.removeItem(this.key("email"));
+    } catch {
+    }
+  }
+  getEmail() {
+    try {
+      return localStorage.getItem(this.key("email"));
+    } catch {
+      return null;
+    }
+  }
   // ── Session id ───────────────────────────────────────────────────────────────
   /**
    * Resolve the current session id: reused while activity continues within
@@ -1427,10 +1461,16 @@ var XeniaClient = class {
    * Persist a visitor id, attached to every subsequent event, and bind it to
    * a known user server-side (`POST /api/events/v1/identify`, fire-and-
    * forget — resolves to an `"identify"` client event carrying `personId`).
+   *
+   * `extra.customerId`/`extra.email`, when supplied, are also persisted
+   * ambiently (like the visitor id) so they ride on every later `resolve()`
+   * call automatically — part of the SDK-provided-fields parity list.
    */
-  identify(visitorId) {
+  identify(visitorId, extra) {
     this.identity.identify(visitorId);
-    void this.api.identify({ xeniaVisitorId: visitorId }).then((res) => this.emit("identify", res)).catch((err) => this.emitError(err));
+    if (extra?.customerId !== void 0) this.identity.setCustomerId(extra.customerId);
+    if (extra?.email !== void 0) this.identity.setEmail(extra.email);
+    void this.api.identify({ xeniaVisitorId: visitorId, userId: extra?.customerId, email: extra?.email }).then((res) => this.emit("identify", res)).catch((err) => this.emitError(err));
   }
   /** Override the customer-journey UUID (else derived from utm_id). */
   setJourneyId(id) {
@@ -1548,15 +1588,40 @@ var XeniaClient = class {
     return this.identity.getVisitorId() ?? this.identity.getDeviceId() ?? void 0;
   }
   /**
-   * Stamp the SDK-owned visitor id into the resolve `data` under the reserved
-   * `_xenia_vid` key so the backend can bucket holdout experiments and record
-   * exposure per visitor (it reads visitor identity from `data`). Set last so a
-   * caller can't override it; a no-op when no visitor id is resolvable yet.
+   * Stamp the full set of SDK-provided fields into the resolve `data` —
+   * `path`, `query`, `deviceId`, `visitorId`, `customerId`, `email`, `url`,
+   * `referrer`, and the five `utm*` fields — the same field-name/type parity
+   * the webhook trigger's "SDK-provided fields" already promises, now native
+   * (always attached, no marketer toggle) for the Personalization Resolve
+   * trigger too. Plus the reserved `_xenia_vid` key the backend reads for
+   * holdout/exposure bucketing. All of these are spread LAST (after the
+   * caller's own `data`) so none can be overridden per call — the same
+   * override-protection guarantee `_xenia_vid` alone used to have, now
+   * widened to the full set. A no-op (returns `opts` unchanged) when nothing
+   * is resolvable yet (e.g. called before `init()` on a fresh visit with no
+   * page context available).
    */
   withVisitor(opts) {
+    const ctx = this.identity.collectContext();
     const vid = this.resolveVisitorId();
-    if (!vid) return opts;
-    return { ...opts, data: { ...opts?.data ?? {}, _xenia_vid: vid } };
+    const sdkFields = compact({
+      path: ctx.path,
+      query: ctx.query,
+      deviceId: this.identity.getDeviceId() ?? void 0,
+      visitorId: vid,
+      customerId: this.identity.getCustomerId() ?? void 0,
+      email: this.identity.getEmail() ?? void 0,
+      url: ctx.url,
+      referrer: ctx.referrer,
+      utmSource: ctx.utmSource,
+      utmMedium: ctx.utmMedium,
+      utmCampaign: ctx.utmCampaign,
+      utmContent: ctx.utmContent,
+      utmId: ctx.utmId
+    });
+    if (vid) sdkFields._xenia_vid = vid;
+    if (Object.keys(sdkFields).length === 0) return opts;
+    return { ...opts, data: { ...opts?.data ?? {}, ...sdkFields } };
   }
   dntBlocked() {
     if (this.options.respectDnt === false) return false;