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

package/dist/chunk-TLTG3BTC.js

@@ -0,0 +1,104 @@
+// src/core/content-splice.ts
+function isPlainObject(v) {
+  return v !== null && typeof v === "object" && !Array.isArray(v);
+}
+function cloneJson(value) {
+  return value === null || typeof value !== "object" ? value : JSON.parse(JSON.stringify(value));
+}
+function setAtPath(node, path, value, mode) {
+  if (path.length === 0) {
+    if (mode === "merge" && isPlainObject(node) && isPlainObject(value)) {
+      return { ...node, ...value };
+    }
+    return value;
+  }
+  const [key, ...rest] = path;
+  if (Array.isArray(node)) {
+    const index = Number(key);
+    if (!Number.isInteger(index) || index < 0 || index >= node.length) return node;
+    const next = node.slice();
+    next[index] = setAtPath(next[index], rest, value, mode);
+    return next;
+  }
+  if (isPlainObject(node)) {
+    if (!(key in node)) return node;
+    return { ...node, [key]: setAtPath(node[key], rest, value, mode) };
+  }
+  return node;
+}
+function spliceSlots(slots, swaps) {
+  const result = {};
+  for (const [key, value] of Object.entries(slots)) {
+    result[key] = cloneJson(value);
+  }
+  if (!swaps) return result;
+  for (const swap of swaps) {
+    const [slotKey, ...pathParts] = swap.identifier.split(".");
+    if (!(slotKey in result)) continue;
+    result[slotKey] = setAtPath(result[slotKey], pathParts, swap.replacement, swap.mode ?? "replace");
+  }
+  return result;
+}
+function extractContentSwaps(body) {
+  if (!isPlainObject(body)) return void 0;
+  const swaps = body.xeniaContentSwaps;
+  return Array.isArray(swaps) ? swaps : void 0;
+}
+
+// src/core/response-store.ts
+var MemoryResponseStore = class {
+  map = /* @__PURE__ */ new Map();
+  set(key, value) {
+    this.map.set(key, value);
+  }
+  get(key) {
+    return this.map.get(key);
+  }
+  keys() {
+    return [...this.map.keys()];
+  }
+  clear() {
+    this.map.clear();
+  }
+};
+var LocalStorageResponseStore = class {
+  nsKey;
+  constructor(prefix = "xenia") {
+    this.nsKey = `${prefix}_responses`;
+  }
+  read() {
+    try {
+      const raw = localStorage.getItem(this.nsKey);
+      return raw ? JSON.parse(raw) : {};
+    } catch {
+      return {};
+    }
+  }
+  write(data) {
+    try {
+      localStorage.setItem(this.nsKey, JSON.stringify(data));
+    } catch {
+    }
+  }
+  set(key, value) {
+    const data = this.read();
+    data[key] = value;
+    this.write(data);
+  }
+  get(key) {
+    return this.read()[key];
+  }
+  keys() {
+    return Object.keys(this.read());
+  }
+  clear() {
+    try {
+      localStorage.removeItem(this.nsKey);
+    } catch {
+    }
+  }
+};
+
+export { LocalStorageResponseStore, MemoryResponseStore, extractContentSwaps, spliceSlots };
+//# sourceMappingURL=chunk-TLTG3BTC.js.map
+//# sourceMappingURL=chunk-TLTG3BTC.js.map

package/dist/chunk-TLTG3BTC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/content-splice.ts","../src/core/response-store.ts"],"names":[],"mappings":"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","file":"chunk-TLTG3BTC.js","sourcesContent":["import type { JsonValue } from \"./types\";\n\n/**\n * A single content swap, as emitted in a webhook-response body's\n * `xeniaContentSwaps` array (the multi-slot personalization analogue of\n * `xeniaActions`). `identifier` is `\"<slotKey>\"` (whole-slot replace) or\n * `\"<slotKey>.<dotted.path>\"` addressing a node inside that slot's JSON\n * (object keys or array indices).\n *\n * NOTE: this field name/shape is a proposed contract, not yet emitted by any\n * journey node — confirm with the Journey Orchestrator (FE/BE) team before\n * relying on it in production.\n */\nexport interface ContentSwap {\n  identifier: string;\n  replacement: JsonValue;\n  /** `\"replace\"` (default) swaps the whole matched node; `\"merge\"` shallow-merges when both sides are objects. */\n  mode?: \"replace\" | \"merge\";\n}\n\nfunction isPlainObject(v: JsonValue): v is { [key: string]: JsonValue } {\n  return v !== null && typeof v === \"object\" && !Array.isArray(v);\n}\n\nfunction cloneJson<T extends JsonValue>(value: T): T {\n  return value === null || typeof value !== \"object\" ? value : (JSON.parse(JSON.stringify(value)) as T);\n}\n\nfunction setAtPath(node: JsonValue, path: string[], value: JsonValue, mode: \"replace\" | \"merge\"): JsonValue {\n  if (path.length === 0) {\n    if (mode === \"merge\" && isPlainObject(node) && isPlainObject(value)) {\n      return { ...node, ...value };\n    }\n    return value;\n  }\n\n  const [key, ...rest] = path;\n  if (Array.isArray(node)) {\n    const index = Number(key);\n    if (!Number.isInteger(index) || index < 0 || index >= node.length) return node;\n    const next = node.slice();\n    next[index] = setAtPath(next[index], rest, value, mode);\n    return next;\n  }\n  if (isPlainObject(node)) {\n    if (!(key in node)) return node;\n    return { ...node, [key]: setAtPath(node[key], rest, value, mode) };\n  }\n  return node;\n}\n\n/**\n * Splice `swaps` into a base map of named content slots, recursively at any\n * nesting depth. Defensive by design (mirrors the PHP SDK's personalization\n * client): a swap whose `identifier` doesn't resolve to an existing slot/path\n * is silently ignored rather than thrown — this never fails, it degrades to\n * the base slot value. Slots are deep-cloned; inputs are never mutated.\n */\nexport function spliceSlots(\n  slots: Record<string, JsonValue>,\n  swaps: ContentSwap[] | undefined,\n): Record<string, JsonValue> {\n  const result: Record<string, JsonValue> = {};\n  for (const [key, value] of Object.entries(slots)) {\n    result[key] = cloneJson(value);\n  }\n  if (!swaps) return result;\n\n  for (const swap of swaps) {\n    const [slotKey, ...pathParts] = swap.identifier.split(\".\");\n    if (!(slotKey in result)) continue;\n    result[slotKey] = setAtPath(result[slotKey], pathParts, swap.replacement, swap.mode ?? \"replace\");\n  }\n  return result;\n}\n\n/** Extract `xeniaContentSwaps` from a webhook-response body, if present and well-formed. */\nexport function extractContentSwaps(body: JsonValue): ContentSwap[] | undefined {\n  if (!isPlainObject(body)) return undefined;\n  const swaps = body.xeniaContentSwaps;\n  return Array.isArray(swaps) ? (swaps as unknown as ContentSwap[]) : undefined;\n}\n","import type { WebhookResponse } from \"./types\";\n\n/**\n * Persists webhook responses the SDK receives, keyed by an arbitrary string\n * (typically the eventId, triggerId, or journeyId). Lets the app read back the\n * last server response for a given interaction without re-firing it.\n */\nexport interface ResponseStore {\n  set(key: string, value: WebhookResponse): void;\n  get(key: string): WebhookResponse | undefined;\n  keys(): string[];\n  clear(): void;\n}\n\n/** In-memory store. Default; lost on reload. */\nexport class MemoryResponseStore implements ResponseStore {\n  private readonly map = new Map<string, WebhookResponse>();\n\n  set(key: string, value: WebhookResponse): void {\n    this.map.set(key, value);\n  }\n  get(key: string): WebhookResponse | undefined {\n    return this.map.get(key);\n  }\n  keys(): string[] {\n    return [...this.map.keys()];\n  }\n  clear(): void {\n    this.map.clear();\n  }\n}\n\n/**\n * localStorage-backed store — survives reloads. Falls back to memory semantics\n * (silent no-op reads/writes) when localStorage is unavailable or throws.\n */\nexport class LocalStorageResponseStore implements ResponseStore {\n  private readonly nsKey: string;\n\n  constructor(prefix = \"xenia\") {\n    this.nsKey = `${prefix}_responses`;\n  }\n\n  private read(): Record<string, WebhookResponse> {\n    try {\n      const raw = localStorage.getItem(this.nsKey);\n      return raw ? (JSON.parse(raw) as Record<string, WebhookResponse>) : {};\n    } catch {\n      return {};\n    }\n  }\n\n  private write(data: Record<string, WebhookResponse>): void {\n    try {\n      localStorage.setItem(this.nsKey, JSON.stringify(data));\n    } catch {\n      /* storage full / unavailable — ignore */\n    }\n  }\n\n  set(key: string, value: WebhookResponse): void {\n    const data = this.read();\n    data[key] = value;\n    this.write(data);\n  }\n  get(key: string): WebhookResponse | undefined {\n    return this.read()[key];\n  }\n  keys(): string[] {\n    return Object.keys(this.read());\n  }\n  clear(): void {\n    try {\n      localStorage.removeItem(this.nsKey);\n    } catch {\n      /* ignore */\n    }\n  }\n}\n"]}

package/dist/client/index.cjs

@@ -163,12 +163,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 ?? {};
@@ -178,8 +188,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 = {
@@ -332,6 +371,7 @@ var XeniaApi = class {
       defaultHeaders: config.headers,
       timeout: config.timeout,
       retry: config.retry,
+      circuitBreaker: config.circuitBreaker,
       debug: config.debug
     });
   }
@@ -504,6 +544,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",
@@ -933,12 +985,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 {
@@ -2216,6 +2262,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();
@@ -2314,6 +2366,8 @@ exports.WIDGET_RENDERERS = WIDGET_RENDERERS;
 exports.XeniaClient = XeniaClient;
 exports.collectFields = collectFields;
 exports.computeSpinRotation = computeSpinRotation;
+exports.consentCookie = consentCookie;
+exports.consentCookieName = consentCookieName;
 exports.createXeniaClient = createXeniaClient;
 exports.extractContentSwaps = extractContentSwaps;
 exports.hideContent = hideContent;