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

package/dist/client/index.cjs

@@ -966,6 +966,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
@@ -1429,10 +1463,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) {
@@ -1550,15 +1590,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;