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

package/dist/client/react/index.d.cts

@@ -1,8 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode, ElementType, ComponentType } from 'react';
-import { t as XeniaClientOptions, s as XeniaClient, r as ResolveResult, p as ResolveBatchResult, J as JsonValue, W as WebhookResponse, R as ResolveBatchItem, e as AnalyticsEventName, T as TrackOptions, d as XeniaAction, I as InteractionType, m as MessageMountContext, c as MessageComponentRenderer } from '../../actions-DfuHrjUL.cjs';
-export { A as AnalyticsContext, f as AnalyticsIdentity, g as AnalyticsIngestResponse, C as ClientEvent, h as ConsentState, i as ContentSwap, j as IdentifyRequest, k as IdentifyResponse, M as MessageCta, n as MessagePlacement, o as MessageRenderContext, b as MessageTemplateFn, P as PersonalizationSwap, q as ResolveOptions, X as XeniaConfig, a as XeniaEvent, u as createXeniaClient, v as extractContentSwaps, w as parseActions, x as spliceSlots } from '../../actions-DfuHrjUL.cjs';
+import { t as XeniaClientOptions, s as XeniaClient, r as ResolveResult, p as ResolveBatchResult, J as JsonValue, W as WebhookResponse, R as ResolveBatchItem, e as AnalyticsEventName, T as TrackOptions, d as XeniaAction, I as InteractionType, m as MessageMountContext, c as MessageComponentRenderer } from '../../actions-CkiSdvSa.cjs';
+export { A as AnalyticsContext, f as AnalyticsIdentity, g as AnalyticsIngestResponse, C as ClientEvent, h as ConsentState, i as ContentSwap, j as IdentifyRequest, k as IdentifyResponse, M as MessageCta, n as MessagePlacement, o as MessageRenderContext, b as MessageTemplateFn, P as PersonalizationSwap, q as ResolveOptions, X as XeniaConfig, a as XeniaEvent, u as createXeniaClient, v as extractContentSwaps, w as parseActions, x as spliceSlots } from '../../actions-CkiSdvSa.cjs';
 
 interface XeniaProviderProps extends XeniaClientOptions {
     children: ReactNode;
@@ -19,7 +19,7 @@ interface XeniaProviderProps extends XeniaClientOptions {
  *
  * @example
  * ```tsx
- * <XeniaProvider baseUrl="/xenia" tenantId="t1" environmentKey="prod">
+ * <XeniaProvider tenantId="t1" environmentKey="prod">
  *   <App />
  * </XeniaProvider>
  * ```

package/dist/client/react/index.d.ts

@@ -1,8 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode, ElementType, ComponentType } from 'react';
-import { t as XeniaClientOptions, s as XeniaClient, r as ResolveResult, p as ResolveBatchResult, J as JsonValue, W as WebhookResponse, R as ResolveBatchItem, e as AnalyticsEventName, T as TrackOptions, d as XeniaAction, I as InteractionType, m as MessageMountContext, c as MessageComponentRenderer } from '../../actions-DfuHrjUL.js';
-export { A as AnalyticsContext, f as AnalyticsIdentity, g as AnalyticsIngestResponse, C as ClientEvent, h as ConsentState, i as ContentSwap, j as IdentifyRequest, k as IdentifyResponse, M as MessageCta, n as MessagePlacement, o as MessageRenderContext, b as MessageTemplateFn, P as PersonalizationSwap, q as ResolveOptions, X as XeniaConfig, a as XeniaEvent, u as createXeniaClient, v as extractContentSwaps, w as parseActions, x as spliceSlots } from '../../actions-DfuHrjUL.js';
+import { t as XeniaClientOptions, s as XeniaClient, r as ResolveResult, p as ResolveBatchResult, J as JsonValue, W as WebhookResponse, R as ResolveBatchItem, e as AnalyticsEventName, T as TrackOptions, d as XeniaAction, I as InteractionType, m as MessageMountContext, c as MessageComponentRenderer } from '../../actions-CkiSdvSa.js';
+export { A as AnalyticsContext, f as AnalyticsIdentity, g as AnalyticsIngestResponse, C as ClientEvent, h as ConsentState, i as ContentSwap, j as IdentifyRequest, k as IdentifyResponse, M as MessageCta, n as MessagePlacement, o as MessageRenderContext, b as MessageTemplateFn, P as PersonalizationSwap, q as ResolveOptions, X as XeniaConfig, a as XeniaEvent, u as createXeniaClient, v as extractContentSwaps, w as parseActions, x as spliceSlots } from '../../actions-CkiSdvSa.js';
 
 interface XeniaProviderProps extends XeniaClientOptions {
     children: ReactNode;
@@ -19,7 +19,7 @@ interface XeniaProviderProps extends XeniaClientOptions {
  *
  * @example
  * ```tsx
- * <XeniaProvider baseUrl="/xenia" tenantId="t1" environmentKey="prod">
+ * <XeniaProvider tenantId="t1" environmentKey="prod">
  *   <App />
  * </XeniaProvider>
  * ```

package/dist/client/react/index.js

@@ -92,6 +92,7 @@ function parseActions(body) {
 }
 
 // src/core/http-client.ts
+var DEFAULT_BASE_URL = "https://engine.xeniamartech.com/xenia";
 function isBrowser() {
   return typeof window !== "undefined" && typeof document !== "undefined";
 }
@@ -121,7 +122,7 @@ var HttpClient = class {
   retry;
   debug;
   constructor(opts) {
-    this.baseUrl = opts.baseUrl.replace(/\/+$/, "");
+    this.baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
     this.defaultHeaders = opts.defaultHeaders ?? {};
     this.timeout = opts.timeout ?? 8e3;
     this.retry = {
@@ -970,6 +971,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
@@ -1433,10 +1468,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) {
@@ -1554,15 +1595,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;