@xenia-martech/sdk-js 1.0.1-dev.1 → 1.1.0-dev.2

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, W as WidgetFormSubmit, d as WidgetSubmitResponse, e as XeniaAction, f as MessagePlacement } from '../actions-CcBYV--3.cjs';
-export { A as AnalyticsContext, g as AnalyticsEventName, h as AnalyticsIdentity, i as AnalyticsIngestResponse, C as ClientEvent, j as ConsentState, k as ContentSwap, l as IdentifyRequest, m as IdentifyResponse, n as Identity, J as JsonValue, o as MessageMountContext, p as MessageRenderContext, P as PersonalizationSwap, R as ResolveBatchItem, q as ResolveBatchResult, r as ResolveOptions, s as ResolveResult, T as TrackOptions, t as WebhookResponse, u as WidgetPrize, v as WidgetSegment, w as WidgetType, x as XeniaClient, y as XeniaClientOptions, z as createXeniaClient, B as extractContentSwaps, D as parseActions, E as spliceSlots } from '../actions-CcBYV--3.cjs';
+import { I as InteractionType, X as XeniaConfig, a as XeniaEvent, M as MessageCta, b as MessageTemplateFn, c as MessageComponentRenderer, W as WidgetFormSubmit, d as WidgetSubmitResponse, e as XeniaAction, f as MessagePlacement, C as ConsentState } from '../actions-CKeiofxJ.cjs';
+export { A as AnalyticsContext, g as AnalyticsEventName, h as AnalyticsIdentity, i as AnalyticsIngestResponse, j as ClientEvent, k as ContentSwap, l as IdentifyRequest, m as IdentifyResponse, n as Identity, J as JsonValue, o as MessageMountContext, p as MessageRenderContext, P as PersonalizationSwap, R as ResolveBatchItem, q as ResolveBatchResult, r as ResolveOptions, s as ResolveResult, T as TrackOptions, t as WebhookResponse, u as WidgetPrize, v as WidgetSegment, w as WidgetType, x as XeniaClient, y as XeniaClientOptions, z as createXeniaClient, B as extractContentSwaps, D as parseActions, E as spliceSlots } from '../actions-CKeiofxJ.cjs';
 
 interface Parsed {
     eventId: string;
@@ -322,4 +322,26 @@ declare function computeSpinRotation(segmentIndex: number, segmentCount: number,
  */
 declare const WIDGET_RENDERERS: Record<string, WidgetRenderer>;
 
-export { ActionRenderer, AnalyticsQueue, type AnalyticsQueueOptions, type AutoTrackOptions, AutoTracker, type CtaHandler, InteractionType, type MessageAction, MessageComponentRenderer, MessageCta, MessagePlacement, MessageTemplateFn, type SlotMeta, type SubmitWidgetFormHandler, TokenProvider, WIDGET_RENDERERS, WidgetFormSubmit, type WidgetRenderer, WidgetSubmitResponse, type WidgetWireContext, XeniaAction, XeniaConfig, XeniaEvent, collectFields, computeSpinRotation, hideContent, parseDataAttribute, readSlotMeta, resolveTarget, showContent, swapContent, wireFormSubmit };
+/**
+ * Cookie names shared by the browser and server halves of the SDK.
+ *
+ * The visitor cookie is the one channel where two runtimes must agree on a literal string: the
+ * browser writes it, a same-origin server reads it back, and that match is what lets a server-side
+ * conversion attribute to a browser-entered journey. `config.prefix` namespaces it — so two Xenia
+ * apps on one domain keep separate visitors — which means **both halves must derive the name the
+ * same way**. Deriving it on one side and hardcoding it on the other silently breaks the link for
+ * anyone using a custom prefix: the server just finds no cookie and falls back to no visitor.
+ *
+ * Always build the name with these helpers rather than interpolating it by hand.
+ */
+
+/** Name of the first-party cookie carrying consent scopes, for a given prefix. */
+declare function consentCookieName(prefix?: string): string;
+/**
+ * A `document.cookie` string carrying consent, in the JSON form the server SDK's `getConsent()`
+ * reads back. The browser client's `consent()` writes it; a page with its own consent banner and no
+ * browser client can write it directly, so server-side calls see the visitor's choice.
+ */
+declare function consentCookie(state: ConsentState, prefix?: string, maxAgeDays?: number): string;
+
+export { ActionRenderer, AnalyticsQueue, type AnalyticsQueueOptions, type AutoTrackOptions, AutoTracker, ConsentState, type CtaHandler, InteractionType, type MessageAction, MessageComponentRenderer, MessageCta, MessagePlacement, MessageTemplateFn, type SlotMeta, type SubmitWidgetFormHandler, TokenProvider, WIDGET_RENDERERS, WidgetFormSubmit, type WidgetRenderer, WidgetSubmitResponse, type WidgetWireContext, XeniaAction, XeniaConfig, XeniaEvent, collectFields, computeSpinRotation, consentCookie, consentCookieName, hideContent, parseDataAttribute, readSlotMeta, resolveTarget, showContent, swapContent, wireFormSubmit };

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, W as WidgetFormSubmit, d as WidgetSubmitResponse, e as XeniaAction, f as MessagePlacement } from '../actions-CcBYV--3.js';
-export { A as AnalyticsContext, g as AnalyticsEventName, h as AnalyticsIdentity, i as AnalyticsIngestResponse, C as ClientEvent, j as ConsentState, k as ContentSwap, l as IdentifyRequest, m as IdentifyResponse, n as Identity, J as JsonValue, o as MessageMountContext, p as MessageRenderContext, P as PersonalizationSwap, R as ResolveBatchItem, q as ResolveBatchResult, r as ResolveOptions, s as ResolveResult, T as TrackOptions, t as WebhookResponse, u as WidgetPrize, v as WidgetSegment, w as WidgetType, x as XeniaClient, y as XeniaClientOptions, z as createXeniaClient, B as extractContentSwaps, D as parseActions, E as spliceSlots } from '../actions-CcBYV--3.js';
+import { I as InteractionType, X as XeniaConfig, a as XeniaEvent, M as MessageCta, b as MessageTemplateFn, c as MessageComponentRenderer, W as WidgetFormSubmit, d as WidgetSubmitResponse, e as XeniaAction, f as MessagePlacement, C as ConsentState } from '../actions-CKeiofxJ.js';
+export { A as AnalyticsContext, g as AnalyticsEventName, h as AnalyticsIdentity, i as AnalyticsIngestResponse, j as ClientEvent, k as ContentSwap, l as IdentifyRequest, m as IdentifyResponse, n as Identity, J as JsonValue, o as MessageMountContext, p as MessageRenderContext, P as PersonalizationSwap, R as ResolveBatchItem, q as ResolveBatchResult, r as ResolveOptions, s as ResolveResult, T as TrackOptions, t as WebhookResponse, u as WidgetPrize, v as WidgetSegment, w as WidgetType, x as XeniaClient, y as XeniaClientOptions, z as createXeniaClient, B as extractContentSwaps, D as parseActions, E as spliceSlots } from '../actions-CKeiofxJ.js';
 
 interface Parsed {
     eventId: string;
@@ -322,4 +322,26 @@ declare function computeSpinRotation(segmentIndex: number, segmentCount: number,
  */
 declare const WIDGET_RENDERERS: Record<string, WidgetRenderer>;
 
-export { ActionRenderer, AnalyticsQueue, type AnalyticsQueueOptions, type AutoTrackOptions, AutoTracker, type CtaHandler, InteractionType, type MessageAction, MessageComponentRenderer, MessageCta, MessagePlacement, MessageTemplateFn, type SlotMeta, type SubmitWidgetFormHandler, TokenProvider, WIDGET_RENDERERS, WidgetFormSubmit, type WidgetRenderer, WidgetSubmitResponse, type WidgetWireContext, XeniaAction, XeniaConfig, XeniaEvent, collectFields, computeSpinRotation, hideContent, parseDataAttribute, readSlotMeta, resolveTarget, showContent, swapContent, wireFormSubmit };
+/**
+ * Cookie names shared by the browser and server halves of the SDK.
+ *
+ * The visitor cookie is the one channel where two runtimes must agree on a literal string: the
+ * browser writes it, a same-origin server reads it back, and that match is what lets a server-side
+ * conversion attribute to a browser-entered journey. `config.prefix` namespaces it — so two Xenia
+ * apps on one domain keep separate visitors — which means **both halves must derive the name the
+ * same way**. Deriving it on one side and hardcoding it on the other silently breaks the link for
+ * anyone using a custom prefix: the server just finds no cookie and falls back to no visitor.
+ *
+ * Always build the name with these helpers rather than interpolating it by hand.
+ */
+
+/** Name of the first-party cookie carrying consent scopes, for a given prefix. */
+declare function consentCookieName(prefix?: string): string;
+/**
+ * A `document.cookie` string carrying consent, in the JSON form the server SDK's `getConsent()`
+ * reads back. The browser client's `consent()` writes it; a page with its own consent banner and no
+ * browser client can write it directly, so server-side calls see the visitor's choice.
+ */
+declare function consentCookie(state: ConsentState, prefix?: string, maxAgeDays?: number): string;
+
+export { ActionRenderer, AnalyticsQueue, type AnalyticsQueueOptions, type AutoTrackOptions, AutoTracker, ConsentState, type CtaHandler, InteractionType, type MessageAction, MessageComponentRenderer, MessageCta, MessagePlacement, MessageTemplateFn, type SlotMeta, type SubmitWidgetFormHandler, TokenProvider, WIDGET_RENDERERS, WidgetFormSubmit, type WidgetRenderer, WidgetSubmitResponse, type WidgetWireContext, XeniaAction, XeniaConfig, XeniaEvent, collectFields, computeSpinRotation, consentCookie, consentCookieName, hideContent, parseDataAttribute, readSlotMeta, resolveTarget, showContent, swapContent, wireFormSubmit };

package/dist/client/index.js

@@ -161,12 +161,22 @@ var HttpError = class extends Error {
   status;
   data;
 };
+var CircuitOpenError = class extends Error {
+  constructor(endpoint) {
+    super(`Circuit open for ${endpoint}: failing fast until the cooldown passes`);
+    this.endpoint = endpoint;
+    this.name = "CircuitOpenError";
+  }
+  endpoint;
+};
+var breakers = /* @__PURE__ */ new Map();
 var HttpClient = class {
   baseUrl;
   defaultHeaders;
   timeout;
   retry;
   debug;
+  breaker;
   constructor(opts) {
     this.baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
     this.defaultHeaders = opts.defaultHeaders ?? {};
@@ -176,8 +186,37 @@ var HttpClient = class {
       baseDelayMs: opts.retry?.baseDelayMs ?? 300
     };
     this.debug = opts.debug ?? false;
+    const cb = opts.circuitBreaker === true ? {} : opts.circuitBreaker || null;
+    this.breaker = cb && { failureThreshold: cb.failureThreshold ?? 3, cooldownMs: cb.cooldownMs ?? 3e4 };
   }
   async request(opts) {
+    if (!this.breaker) return this.send(opts);
+    const key = buildUrl(this.baseUrl + opts.path, opts.query);
+    const b = breakers.get(key) ?? { failures: 0, openedAt: 0 };
+    if (b.openedAt) {
+      if (Date.now() - b.openedAt < this.breaker.cooldownMs) throw new CircuitOpenError(key);
+      b.openedAt = 0;
+      b.failures = this.breaker.failureThreshold - 1;
+    }
+    try {
+      const result = await this.send(opts);
+      breakers.delete(key);
+      return result;
+    } catch (err) {
+      if (err instanceof HttpError && !this.isRetryableStatus(err.status)) {
+        breakers.delete(key);
+        throw err;
+      }
+      b.failures += 1;
+      if (b.failures >= this.breaker.failureThreshold) {
+        b.openedAt = Date.now();
+        this.log(`circuit opened for ${opts.path} after ${b.failures} failures`);
+      }
+      breakers.set(key, b);
+      throw err;
+    }
+  }
+  async send(opts) {
     const url = buildUrl(this.baseUrl + opts.path, opts.query);
     const method = opts.method ?? "GET";
     const headers = {
@@ -330,6 +369,7 @@ var XeniaApi = class {
       defaultHeaders: config.headers,
       timeout: config.timeout,
       retry: config.retry,
+      circuitBreaker: config.circuitBreaker,
       debug: config.debug
     });
   }
@@ -502,6 +542,18 @@ var XeniaApi = class {
   }
 };
 
+// src/core/cookie-names.ts
+var DEFAULT_PREFIX = "xenia";
+function visitorCookieName(prefix = DEFAULT_PREFIX) {
+  return `${prefix || DEFAULT_PREFIX}_vid`;
+}
+function consentCookieName(prefix = DEFAULT_PREFIX) {
+  return `${prefix || DEFAULT_PREFIX}_consent`;
+}
+function consentCookie(state, prefix, maxAgeDays = 365) {
+  return `${consentCookieName(prefix)}=${encodeURIComponent(JSON.stringify(state))}; path=/; max-age=${Math.floor(maxAgeDays * 86400)}; SameSite=Lax`;
+}
+
 // src/core/event-payload.ts
 var RESERVED = /* @__PURE__ */ new Set([
   "eventId",
@@ -931,12 +983,6 @@ var AutoTracker = class {
   }
 };
 
-// src/core/cookie-names.ts
-var DEFAULT_PREFIX = "xenia";
-function visitorCookieName(prefix = DEFAULT_PREFIX) {
-  return `${prefix || DEFAULT_PREFIX}_vid`;
-}
-
 // src/client/identity.ts
 var SESSION_TIMEOUT_MS = 30 * 60 * 1e3;
 var Identity = class {
@@ -2214,6 +2260,12 @@ var XeniaClient = class {
   async consent(state) {
     const wasAllowed = this.analyticsAllowed();
     this.consentState = { ...this.consentState, ...state };
+    if (isBrowser()) {
+      try {
+        document.cookie = consentCookie(this.consentState, this.options.prefix);
+      } catch {
+      }
+    }
     if (this.analyticsAllowed() && !wasAllowed) {
       this.analyticsQueue.start();
       void this.analyticsQueue.flush();
@@ -2303,6 +2355,6 @@ function extractContentSwaps(body) {
   return Array.isArray(swaps) ? swaps : void 0;
 }
 
-export { ActionRenderer, AnalyticsQueue, AutoTracker, Identity, TokenProvider, WIDGET_RENDERERS, XeniaClient, collectFields, computeSpinRotation, createXeniaClient, extractContentSwaps, hideContent, parseActions, parseDataAttribute, readSlotMeta, resolveTarget, showContent, spliceSlots, swapContent, wireFormSubmit };
+export { ActionRenderer, AnalyticsQueue, AutoTracker, Identity, TokenProvider, WIDGET_RENDERERS, XeniaClient, collectFields, computeSpinRotation, consentCookie, consentCookieName, createXeniaClient, extractContentSwaps, hideContent, parseActions, parseDataAttribute, readSlotMeta, resolveTarget, showContent, spliceSlots, swapContent, wireFormSubmit };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map