@xenia-martech/sdk-js 1.2.0-dev.6 → 1.2.0-dev.7

package/README.md

@@ -900,7 +900,7 @@ The page behind the rewrite reads the swaps back with `decodeVariant(token, secr
 
 **Debugging and QA.** `xeniaEdgeProxy({ debug, qa })` — turn both on only in development or on a QA deploy (e.g. `debug: process.env.NODE_ENV === "development"`):
 
-- `debug: true` writes what was decided for each of the last few pages to the `xenia_debug` cookie. Render `<XeniaDebugPanel />` from `/client/react` behind the same flag: a round Xenia launcher in the corner opens a small white card, like Next.js's dev tools menu, with the status, page, source and location, the decision per content key (click a key for the journey path it took), and the visitor profile. `position` picks the corner (default bottom-right, away from Next.js's own dev tools).
+- `debug: true` writes what was decided for each of the last few pages to the `xenia_debug` cookie. Render `<XeniaDebugPanel />` from `/client/react` behind the same flag: a round Xenia launcher in the corner opens a small white card, like Next.js's dev tools menu, with the status, page, source and location, the decision per content key (click a key for the journey path it took), and the visitor profile. `position` picks the corner (default bottom-right, away from Next.js's own dev tools), and `defaultOpen` opens the card on page load (default closed; once the visitor opens or closes it, that sticks for the session).
 - Your own data: return `custom` from `debugInfo(info)` — `{ Moment: "thursday 12:00", Household: ["Emma: blue, shoes", "John: no taste"] }` — and the card shows each key as a row (a list one line per item). `renderExtra(page)` remains for anything else.
 - `qa: true` lets a tester place the visitor in a city (`?xn_geo=london`, from `QA_CITIES` or your own `qa: { cities }`), decide as of a day (`?xn_date=2026-12-24`), and forget both with `?xn_geo=off`; under `next dev`, `?xn_country=GB` too. The overrides last the visit.
 

package/dist/{actions-C18Kv-4w.d.cts → actions-35V37IT0.d.cts}

@@ -1238,4 +1238,5 @@ declare function extractContentSwaps(body: JsonValue): ContentSwap[] | undefined
  */
 declare function parseActions(body: JsonValue): XeniaAction[];
 
-export { type AnalyticsContext as A, type WidgetType as B, type ConsentState as C, XeniaClient as D, type XeniaClientOptions as E, type XeniaMarker as F, createXeniaClient as G, extractContentSwaps as H, type InteractionType as I, type JsonValue as J, parseActions as K, pendingTargets as L, type MessageCta as M, personalizeContent as N, personalizePage as O, type PagePersonalizeOptions as P, spliceSlots as Q, type ResolveBatchItem as R, type TrackOptions as T, type WidgetFormSubmit as W, type XeniaConfig as X, type XeniaEvent as a, type MessageTemplateFn as b, type MessageComponentRenderer as c, type WidgetSubmitResponse as d, type XeniaAction as e, type MessagePlacement as f, type AnalyticsEventName as g, type AnalyticsIdentity as h, type AnalyticsIngestResponse as i, type AppliedSwap as j, type ClientEvent as k, type CmsAdapter as l, type ContentSwap as m, type IdentifyRequest as n, type IdentifyResponse as o, Identity as p, type MessageMountContext as q, type MessageRenderContext as r, type PageRef as s, type PersonalizationSwap as t, type ResolveBatchResult as u, type ResolveOptions as v, type ResolveResult as w, type WebhookResponse as x, type WidgetPrize as y, type WidgetSegment as z };
+export { XeniaClient as D, createXeniaClient as G, extractContentSwaps as H, parseActions as K, pendingTargets as L, personalizeContent as N, personalizePage as O, spliceSlots as Q, Identity as p };
+export type { AnalyticsContext as A, WidgetType as B, ConsentState as C, XeniaClientOptions as E, XeniaMarker as F, InteractionType as I, JsonValue as J, MessageCta as M, PagePersonalizeOptions as P, ResolveBatchItem as R, TrackOptions as T, WidgetFormSubmit as W, XeniaConfig as X, XeniaEvent as a, MessageTemplateFn as b, MessageComponentRenderer as c, WidgetSubmitResponse as d, XeniaAction as e, MessagePlacement as f, AnalyticsEventName as g, AnalyticsIdentity as h, AnalyticsIngestResponse as i, AppliedSwap as j, ClientEvent as k, CmsAdapter as l, ContentSwap as m, IdentifyRequest as n, IdentifyResponse as o, MessageMountContext as q, MessageRenderContext as r, PageRef as s, PersonalizationSwap as t, ResolveBatchResult as u, ResolveOptions as v, ResolveResult as w, WebhookResponse as x, WidgetPrize as y, WidgetSegment as z };

package/dist/{actions-C18Kv-4w.d.ts → actions-35V37IT0.d.ts}

@@ -1238,4 +1238,5 @@ declare function extractContentSwaps(body: JsonValue): ContentSwap[] | undefined
  */
 declare function parseActions(body: JsonValue): XeniaAction[];
 
-export { type AnalyticsContext as A, type WidgetType as B, type ConsentState as C, XeniaClient as D, type XeniaClientOptions as E, type XeniaMarker as F, createXeniaClient as G, extractContentSwaps as H, type InteractionType as I, type JsonValue as J, parseActions as K, pendingTargets as L, type MessageCta as M, personalizeContent as N, personalizePage as O, type PagePersonalizeOptions as P, spliceSlots as Q, type ResolveBatchItem as R, type TrackOptions as T, type WidgetFormSubmit as W, type XeniaConfig as X, type XeniaEvent as a, type MessageTemplateFn as b, type MessageComponentRenderer as c, type WidgetSubmitResponse as d, type XeniaAction as e, type MessagePlacement as f, type AnalyticsEventName as g, type AnalyticsIdentity as h, type AnalyticsIngestResponse as i, type AppliedSwap as j, type ClientEvent as k, type CmsAdapter as l, type ContentSwap as m, type IdentifyRequest as n, type IdentifyResponse as o, Identity as p, type MessageMountContext as q, type MessageRenderContext as r, type PageRef as s, type PersonalizationSwap as t, type ResolveBatchResult as u, type ResolveOptions as v, type ResolveResult as w, type WebhookResponse as x, type WidgetPrize as y, type WidgetSegment as z };
+export { XeniaClient as D, createXeniaClient as G, extractContentSwaps as H, parseActions as K, pendingTargets as L, personalizeContent as N, personalizePage as O, spliceSlots as Q, Identity as p };
+export type { AnalyticsContext as A, WidgetType as B, ConsentState as C, XeniaClientOptions as E, XeniaMarker as F, InteractionType as I, JsonValue as J, MessageCta as M, PagePersonalizeOptions as P, ResolveBatchItem as R, TrackOptions as T, WidgetFormSubmit as W, XeniaConfig as X, XeniaEvent as a, MessageTemplateFn as b, MessageComponentRenderer as c, WidgetSubmitResponse as d, XeniaAction as e, MessagePlacement as f, AnalyticsEventName as g, AnalyticsIdentity as h, AnalyticsIngestResponse as i, AppliedSwap as j, ClientEvent as k, CmsAdapter as l, ContentSwap as m, IdentifyRequest as n, IdentifyResponse as o, MessageMountContext as q, MessageRenderContext as r, PageRef as s, PersonalizationSwap as t, ResolveBatchResult as u, ResolveOptions as v, ResolveResult as w, WebhookResponse as x, WidgetPrize as y, WidgetSegment as z };

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, C as ConsentState } from '../actions-C18Kv-4w.cjs';
-export { A as AnalyticsContext, g as AnalyticsEventName, h as AnalyticsIdentity, i as AnalyticsIngestResponse, j as AppliedSwap, k as ClientEvent, l as CmsAdapter, m as ContentSwap, n as IdentifyRequest, o as IdentifyResponse, p as Identity, J as JsonValue, q as MessageMountContext, r as MessageRenderContext, P as PagePersonalizeOptions, s as PageRef, t as PersonalizationSwap, R as ResolveBatchItem, u as ResolveBatchResult, v as ResolveOptions, w as ResolveResult, T as TrackOptions, x as WebhookResponse, y as WidgetPrize, z as WidgetSegment, B as WidgetType, D as XeniaClient, E as XeniaClientOptions, F as XeniaMarker, G as createXeniaClient, H as extractContentSwaps, K as parseActions, L as pendingTargets, N as personalizeContent, O as personalizePage, Q as spliceSlots } from '../actions-C18Kv-4w.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-35V37IT0.cjs';
+export { A as AnalyticsContext, g as AnalyticsEventName, h as AnalyticsIdentity, i as AnalyticsIngestResponse, j as AppliedSwap, k as ClientEvent, l as CmsAdapter, m as ContentSwap, n as IdentifyRequest, o as IdentifyResponse, p as Identity, J as JsonValue, q as MessageMountContext, r as MessageRenderContext, P as PagePersonalizeOptions, s as PageRef, t as PersonalizationSwap, R as ResolveBatchItem, u as ResolveBatchResult, v as ResolveOptions, w as ResolveResult, T as TrackOptions, x as WebhookResponse, y as WidgetPrize, z as WidgetSegment, B as WidgetType, D as XeniaClient, E as XeniaClientOptions, F as XeniaMarker, G as createXeniaClient, H as extractContentSwaps, K as parseActions, L as pendingTargets, N as personalizeContent, O as personalizePage, Q as spliceSlots } from '../actions-35V37IT0.cjs';
 
 interface Parsed {
     eventId: string;
@@ -355,4 +355,5 @@ declare function consentCookieName(prefix?: string): string;
  */
 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 };
+export { ActionRenderer, AnalyticsQueue, AutoTracker, ConsentState, InteractionType, MessageComponentRenderer, MessageCta, MessagePlacement, MessageTemplateFn, TokenProvider, WIDGET_RENDERERS, WidgetFormSubmit, WidgetSubmitResponse, XeniaAction, XeniaConfig, XeniaEvent, collectFields, computeSpinRotation, consentCookie, consentCookieName, hideContent, parseDataAttribute, readSlotMeta, resolveTarget, showContent, swapContent, wireFormSubmit };
+export type { AnalyticsQueueOptions, AutoTrackOptions, CtaHandler, MessageAction, SlotMeta, SubmitWidgetFormHandler, WidgetRenderer, WidgetWireContext };

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, C as ConsentState } from '../actions-C18Kv-4w.js';
-export { A as AnalyticsContext, g as AnalyticsEventName, h as AnalyticsIdentity, i as AnalyticsIngestResponse, j as AppliedSwap, k as ClientEvent, l as CmsAdapter, m as ContentSwap, n as IdentifyRequest, o as IdentifyResponse, p as Identity, J as JsonValue, q as MessageMountContext, r as MessageRenderContext, P as PagePersonalizeOptions, s as PageRef, t as PersonalizationSwap, R as ResolveBatchItem, u as ResolveBatchResult, v as ResolveOptions, w as ResolveResult, T as TrackOptions, x as WebhookResponse, y as WidgetPrize, z as WidgetSegment, B as WidgetType, D as XeniaClient, E as XeniaClientOptions, F as XeniaMarker, G as createXeniaClient, H as extractContentSwaps, K as parseActions, L as pendingTargets, N as personalizeContent, O as personalizePage, Q as spliceSlots } from '../actions-C18Kv-4w.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-35V37IT0.js';
+export { A as AnalyticsContext, g as AnalyticsEventName, h as AnalyticsIdentity, i as AnalyticsIngestResponse, j as AppliedSwap, k as ClientEvent, l as CmsAdapter, m as ContentSwap, n as IdentifyRequest, o as IdentifyResponse, p as Identity, J as JsonValue, q as MessageMountContext, r as MessageRenderContext, P as PagePersonalizeOptions, s as PageRef, t as PersonalizationSwap, R as ResolveBatchItem, u as ResolveBatchResult, v as ResolveOptions, w as ResolveResult, T as TrackOptions, x as WebhookResponse, y as WidgetPrize, z as WidgetSegment, B as WidgetType, D as XeniaClient, E as XeniaClientOptions, F as XeniaMarker, G as createXeniaClient, H as extractContentSwaps, K as parseActions, L as pendingTargets, N as personalizeContent, O as personalizePage, Q as spliceSlots } from '../actions-35V37IT0.js';
 
 interface Parsed {
     eventId: string;
@@ -355,4 +355,5 @@ declare function consentCookieName(prefix?: string): string;
  */
 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 };
+export { ActionRenderer, AnalyticsQueue, AutoTracker, ConsentState, InteractionType, MessageComponentRenderer, MessageCta, MessagePlacement, MessageTemplateFn, TokenProvider, WIDGET_RENDERERS, WidgetFormSubmit, WidgetSubmitResponse, XeniaAction, XeniaConfig, XeniaEvent, collectFields, computeSpinRotation, consentCookie, consentCookieName, hideContent, parseDataAttribute, readSlotMeta, resolveTarget, showContent, swapContent, wireFormSubmit };
+export type { AnalyticsQueueOptions, AutoTrackOptions, CtaHandler, MessageAction, SlotMeta, SubmitWidgetFormHandler, WidgetRenderer, WidgetWireContext };

package/dist/client/react/index.cjs

@@ -3302,6 +3302,7 @@ function view(e) {
   };
 }
 var changed = (result) => !/^(base|control|suppressed)\b/.test(result);
+var heldOut = (d) => d.reason === "holdout" || d.result === "control";
 function debugStatus(entry) {
   const v = view(entry);
   if (v.source === "timeout" || v.source === "error") return "attention";
@@ -3345,7 +3346,7 @@ function Id({ value }) {
   ] }) : /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: value });
 }
 var percent = (n) => `${Math.round(n <= 1 ? n * 100 : n)}%`;
-function XeniaDebugPanel({ prefix = DEFAULT_PREFIX, position = "bottom-right", renderExtra }) {
+function XeniaDebugPanel({ prefix = DEFAULT_PREFIX, position = "bottom-right", defaultOpen = false, renderExtra }) {
   const [entry, setEntry] = react.useState(null);
   const [open, setOpen] = react.useState(false);
   const [tab, setTab] = react.useState("Decision");
@@ -3353,6 +3354,7 @@ function XeniaDebugPanel({ prefix = DEFAULT_PREFIX, position = "bottom-right", r
   const launcher = react.useRef(null);
   const card = react.useRef(null);
   const tabRefs = react.useRef({});
+  const focusOnOpen = react.useRef(false);
   const id = react.useId();
   react.useEffect(() => {
     let timer;
@@ -3364,25 +3366,28 @@ function XeniaDebugPanel({ prefix = DEFAULT_PREFIX, position = "bottom-right", r
     };
     read();
     try {
-      setOpen(sessionStorage.getItem(OPEN_KEY) === "1");
-      const saved = sessionStorage.getItem(TAB_KEY);
-      if (saved === "Decision" || saved === "Visitor" || saved === "Request" || saved === "Site") setTab(saved);
+      const saved = sessionStorage.getItem(OPEN_KEY);
+      setOpen(saved === null ? defaultOpen : saved === "1");
+      const savedTab = sessionStorage.getItem(TAB_KEY);
+      if (savedTab === "Decision" || savedTab === "Visitor" || savedTab === "Request" || savedTab === "Site") setTab(savedTab);
     } catch {
+      setOpen(defaultOpen);
     }
     const unwatch = watchNavigation(onNavigate);
     return () => {
       clearTimeout(timer);
       unwatch();
     };
-  }, [prefix]);
+  }, [prefix, defaultOpen]);
   const toggle = react.useCallback((next, focusLauncher = false) => {
     setOpen(next);
+    focusOnOpen.current = next;
     if (focusLauncher) launcher.current?.focus();
     remember(OPEN_KEY, next ? "1" : "0");
   }, []);
   react.useEffect(() => {
     if (!open) return;
-    card.current?.focus();
+    if (focusOnOpen.current) card.current?.focus();
     const onKey = (e) => {
       if (e.key === "Escape" && root.current?.contains(document.activeElement)) toggle(false, true);
     };
@@ -3436,6 +3441,7 @@ function XeniaDebugPanel({ prefix = DEFAULT_PREFIX, position = "bottom-right", r
         /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "xdp-head-row", children: [
           /* @__PURE__ */ jsxRuntime.jsx("span", { className: "xdp-pill", "data-status": status, children: status === "personalized" ? "Personalized" : "Base content" }),
           /* @__PURE__ */ jsxRuntime.jsx("span", { className: "xdp-chip", title: v.source, children: sourceChip(v.source) }),
+          v.decisions.some(heldOut) ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: "xdp-chip", "data-tone": "holdout", title: "This visitor is in the holdout: they see base content on purpose, to measure the lift", children: "Holdout" }) : null,
           typeof v.ms === "number" && v.source === "xenia" ? /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "xdp-ms", children: [
             v.ms,
             " ms"
@@ -3499,7 +3505,7 @@ function DecisionTab({ v }) {
       /* @__PURE__ */ jsxRuntime.jsx("code", { className: "xdp-key", children: d.key }),
       /* @__PURE__ */ jsxRuntime.jsx("span", { className: "xdp-result", "data-result": changed(d.result) ? "changed" : "base", children: d.result })
     ] }),
-    d.reason ? /* @__PURE__ */ jsxRuntime.jsx("p", { className: "xdp-reason", children: d.reason }) : null,
+    d.reason && d.reason !== "holdout" ? /* @__PURE__ */ jsxRuntime.jsx("p", { className: "xdp-reason", children: d.reason }) : null,
     d.trace.length ? /* @__PURE__ */ jsxRuntime.jsx("ol", { className: "xdp-steps", "aria-label": "Journey path", children: d.trace.map(([step, outcome]) => /* @__PURE__ */ jsxRuntime.jsxs("li", { children: [
       /* @__PURE__ */ jsxRuntime.jsx("code", { children: step }),
       /* @__PURE__ */ jsxRuntime.jsx("span", { children: /* @__PURE__ */ jsxRuntime.jsx(Id, { value: outcome }) })
@@ -3606,6 +3612,7 @@ var STYLES2 = `
 .xdp-pill[data-status=attention]{background:var(--xdp-warn-tint);color:var(--xdp-warn)}
 .xdp-chip{display:inline-flex;align-items:center;padding:2px 8px;border-radius:6px;background:var(--xdp-soft);color:var(--xdp-muted);font-size:12px;white-space:nowrap}
 code.xdp-chip{font-size:11.5px}
+.xdp-chip[data-tone=holdout]{background:var(--xdp-warn-tint);color:var(--xdp-warn);font-weight:600}
 .xdp-ms{margin-left:auto;color:var(--xdp-faint)}
 .xdp-path{display:block;margin-top:8px;font-size:13px;color:var(--xdp-ink);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .xdp-alert{margin:8px 0 0;padding:8px 10px;border-radius:8px;background:var(--xdp-warn-tint);color:var(--xdp-warn)}