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

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

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode, ElementType, ComponentType } from 'react';
-import { E as XeniaClientOptions, D as XeniaClient, w as ResolveResult, u as ResolveBatchResult, J as JsonValue, x as WebhookResponse, R as ResolveBatchItem, g as AnalyticsEventName, T as TrackOptions, P as PagePersonalizeOptions, j as AppliedSwap, s as PageRef, e as XeniaAction, I as InteractionType, q as MessageMountContext, c as MessageComponentRenderer } from '../../actions-C18Kv-4w.cjs';
-export { A as AnalyticsContext, h as AnalyticsIdentity, i as AnalyticsIngestResponse, k as ClientEvent, l as CmsAdapter, C as ConsentState, m as ContentSwap, n as IdentifyRequest, o as IdentifyResponse, M as MessageCta, f as MessagePlacement, r as MessageRenderContext, b as MessageTemplateFn, t as PersonalizationSwap, v as ResolveOptions, X as XeniaConfig, a as XeniaEvent, 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 { E as XeniaClientOptions, D as XeniaClient, w as ResolveResult, u as ResolveBatchResult, J as JsonValue, x as WebhookResponse, R as ResolveBatchItem, g as AnalyticsEventName, T as TrackOptions, P as PagePersonalizeOptions, j as AppliedSwap, s as PageRef, e as XeniaAction, I as InteractionType, q as MessageMountContext, c as MessageComponentRenderer } from '../../actions-35V37IT0.cjs';
+export { A as AnalyticsContext, h as AnalyticsIdentity, i as AnalyticsIngestResponse, k as ClientEvent, l as CmsAdapter, C as ConsentState, m as ContentSwap, n as IdentifyRequest, o as IdentifyResponse, M as MessageCta, f as MessagePlacement, r as MessageRenderContext, b as MessageTemplateFn, t as PersonalizationSwap, v as ResolveOptions, X as XeniaConfig, a as XeniaEvent, 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 XeniaProviderProps extends XeniaClientOptions {
     children: ReactNode;
@@ -235,6 +235,11 @@ interface XeniaDebugPanelProps {
     prefix?: string;
     /** Corner for the launcher. Default `bottom-right` (Next.js's own dev tools sit bottom-left). */
     position?: "bottom-right" | "bottom-left" | "top-right" | "top-left";
+    /**
+     * Open the card on page load instead of only the launcher. Default `false`. Once the visitor opens
+     * or closes it, their choice wins for the rest of the session.
+     */
+    defaultOpen?: boolean;
     /**
      * Content of your own for the Site tab, beyond `custom` (which the panel shows by itself), from
      * the fields your proxy's `debugInfo` added.
@@ -250,6 +255,7 @@ declare function debugStatus(entry: DebugEntry): DebugStatus;
  * site's own rows (`debugInfo`'s `custom`). Reads the debug cookie `xeniaEdgeProxy({ debug: true })`
  * writes; renders nothing without an entry for this page.
  */
-declare function XeniaDebugPanel({ prefix, position, renderExtra }: XeniaDebugPanelProps): react.JSX.Element | null;
+declare function XeniaDebugPanel({ prefix, position, defaultOpen, renderExtra }: XeniaDebugPanelProps): react.JSX.Element | null;
 
-export { AnalyticsEventName, AppliedSwap, type DebugStatus, type EntryStatus, InteractionType, JsonValue, MessageComponentRenderer, MessageMountContext, PagePersonalizeOptions, PageRef, ResolveBatchItem, ResolveBatchResult, ResolveResult, TrackOptions, type UsePersonalizationResolveResult, type UsePersonalizationResolveSlotsResult, type UsePersonalizationResult, type UsePersonalizationSlotsResult, type UsePersonalizedContentOptions, type UsePersonalizedContentResult, type UseWebhookResult, WebhookResponse, XeniaAction, XeniaClient, XeniaClientOptions, XeniaContentProvider, XeniaContext, XeniaDebugPanel, type XeniaDebugPanelProps, XeniaMessage, type XeniaMessageComponentProps, type XeniaMessageProps, XeniaProvider, type XeniaProviderProps, XeniaTrack, type XeniaTrackProps, debugStatus, reactMessageComponent, usePersonalization, usePersonalizationResolve, usePersonalizationResolveSlots, usePersonalizationSlots, usePersonalizedContent, usePersonalizedPage, useTrack, useWebhook, useXenia, useXeniaEntry, useXeniaResponse };
+export { AnalyticsEventName, AppliedSwap, InteractionType, JsonValue, MessageComponentRenderer, MessageMountContext, PagePersonalizeOptions, PageRef, ResolveBatchItem, ResolveBatchResult, ResolveResult, TrackOptions, WebhookResponse, XeniaAction, XeniaClient, XeniaClientOptions, XeniaContentProvider, XeniaContext, XeniaDebugPanel, XeniaMessage, XeniaProvider, XeniaTrack, debugStatus, reactMessageComponent, usePersonalization, usePersonalizationResolve, usePersonalizationResolveSlots, usePersonalizationSlots, usePersonalizedContent, usePersonalizedPage, useTrack, useWebhook, useXenia, useXeniaEntry, useXeniaResponse };
+export type { DebugStatus, EntryStatus, UsePersonalizationResolveResult, UsePersonalizationResolveSlotsResult, UsePersonalizationResult, UsePersonalizationSlotsResult, UsePersonalizedContentOptions, UsePersonalizedContentResult, UseWebhookResult, XeniaDebugPanelProps, XeniaMessageComponentProps, XeniaMessageProps, XeniaProviderProps, XeniaTrackProps };

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

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode, ElementType, ComponentType } from 'react';
-import { E as XeniaClientOptions, D as XeniaClient, w as ResolveResult, u as ResolveBatchResult, J as JsonValue, x as WebhookResponse, R as ResolveBatchItem, g as AnalyticsEventName, T as TrackOptions, P as PagePersonalizeOptions, j as AppliedSwap, s as PageRef, e as XeniaAction, I as InteractionType, q as MessageMountContext, c as MessageComponentRenderer } from '../../actions-C18Kv-4w.js';
-export { A as AnalyticsContext, h as AnalyticsIdentity, i as AnalyticsIngestResponse, k as ClientEvent, l as CmsAdapter, C as ConsentState, m as ContentSwap, n as IdentifyRequest, o as IdentifyResponse, M as MessageCta, f as MessagePlacement, r as MessageRenderContext, b as MessageTemplateFn, t as PersonalizationSwap, v as ResolveOptions, X as XeniaConfig, a as XeniaEvent, 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 { E as XeniaClientOptions, D as XeniaClient, w as ResolveResult, u as ResolveBatchResult, J as JsonValue, x as WebhookResponse, R as ResolveBatchItem, g as AnalyticsEventName, T as TrackOptions, P as PagePersonalizeOptions, j as AppliedSwap, s as PageRef, e as XeniaAction, I as InteractionType, q as MessageMountContext, c as MessageComponentRenderer } from '../../actions-35V37IT0.js';
+export { A as AnalyticsContext, h as AnalyticsIdentity, i as AnalyticsIngestResponse, k as ClientEvent, l as CmsAdapter, C as ConsentState, m as ContentSwap, n as IdentifyRequest, o as IdentifyResponse, M as MessageCta, f as MessagePlacement, r as MessageRenderContext, b as MessageTemplateFn, t as PersonalizationSwap, v as ResolveOptions, X as XeniaConfig, a as XeniaEvent, 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 XeniaProviderProps extends XeniaClientOptions {
     children: ReactNode;
@@ -235,6 +235,11 @@ interface XeniaDebugPanelProps {
     prefix?: string;
     /** Corner for the launcher. Default `bottom-right` (Next.js's own dev tools sit bottom-left). */
     position?: "bottom-right" | "bottom-left" | "top-right" | "top-left";
+    /**
+     * Open the card on page load instead of only the launcher. Default `false`. Once the visitor opens
+     * or closes it, their choice wins for the rest of the session.
+     */
+    defaultOpen?: boolean;
     /**
      * Content of your own for the Site tab, beyond `custom` (which the panel shows by itself), from
      * the fields your proxy's `debugInfo` added.
@@ -250,6 +255,7 @@ declare function debugStatus(entry: DebugEntry): DebugStatus;
  * site's own rows (`debugInfo`'s `custom`). Reads the debug cookie `xeniaEdgeProxy({ debug: true })`
  * writes; renders nothing without an entry for this page.
  */
-declare function XeniaDebugPanel({ prefix, position, renderExtra }: XeniaDebugPanelProps): react.JSX.Element | null;
+declare function XeniaDebugPanel({ prefix, position, defaultOpen, renderExtra }: XeniaDebugPanelProps): react.JSX.Element | null;
 
-export { AnalyticsEventName, AppliedSwap, type DebugStatus, type EntryStatus, InteractionType, JsonValue, MessageComponentRenderer, MessageMountContext, PagePersonalizeOptions, PageRef, ResolveBatchItem, ResolveBatchResult, ResolveResult, TrackOptions, type UsePersonalizationResolveResult, type UsePersonalizationResolveSlotsResult, type UsePersonalizationResult, type UsePersonalizationSlotsResult, type UsePersonalizedContentOptions, type UsePersonalizedContentResult, type UseWebhookResult, WebhookResponse, XeniaAction, XeniaClient, XeniaClientOptions, XeniaContentProvider, XeniaContext, XeniaDebugPanel, type XeniaDebugPanelProps, XeniaMessage, type XeniaMessageComponentProps, type XeniaMessageProps, XeniaProvider, type XeniaProviderProps, XeniaTrack, type XeniaTrackProps, debugStatus, reactMessageComponent, usePersonalization, usePersonalizationResolve, usePersonalizationResolveSlots, usePersonalizationSlots, usePersonalizedContent, usePersonalizedPage, useTrack, useWebhook, useXenia, useXeniaEntry, useXeniaResponse };
+export { AnalyticsEventName, AppliedSwap, InteractionType, JsonValue, MessageComponentRenderer, MessageMountContext, PagePersonalizeOptions, PageRef, ResolveBatchItem, ResolveBatchResult, ResolveResult, TrackOptions, WebhookResponse, XeniaAction, XeniaClient, XeniaClientOptions, XeniaContentProvider, XeniaContext, XeniaDebugPanel, XeniaMessage, XeniaProvider, XeniaTrack, debugStatus, reactMessageComponent, usePersonalization, usePersonalizationResolve, usePersonalizationResolveSlots, usePersonalizationSlots, usePersonalizedContent, usePersonalizedPage, useTrack, useWebhook, useXenia, useXeniaEntry, useXeniaResponse };
+export type { DebugStatus, EntryStatus, UsePersonalizationResolveResult, UsePersonalizationResolveSlotsResult, UsePersonalizationResult, UsePersonalizationSlotsResult, UsePersonalizedContentOptions, UsePersonalizedContentResult, UseWebhookResult, XeniaDebugPanelProps, XeniaMessageComponentProps, XeniaMessageProps, XeniaProviderProps, XeniaTrackProps };

package/dist/client/react/index.js

@@ -3300,6 +3300,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";
@@ -3343,7 +3344,7 @@ function Id({ value }) {
   ] }) : /* @__PURE__ */ jsx(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] = useState(null);
   const [open, setOpen] = useState(false);
   const [tab, setTab] = useState("Decision");
@@ -3351,6 +3352,7 @@ function XeniaDebugPanel({ prefix = DEFAULT_PREFIX, position = "bottom-right", r
   const launcher = useRef(null);
   const card = useRef(null);
   const tabRefs = useRef({});
+  const focusOnOpen = useRef(false);
   const id = useId();
   useEffect(() => {
     let timer;
@@ -3362,25 +3364,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 = useCallback((next, focusLauncher = false) => {
     setOpen(next);
+    focusOnOpen.current = next;
     if (focusLauncher) launcher.current?.focus();
     remember(OPEN_KEY, next ? "1" : "0");
   }, []);
   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);
     };
@@ -3434,6 +3439,7 @@ function XeniaDebugPanel({ prefix = DEFAULT_PREFIX, position = "bottom-right", r
         /* @__PURE__ */ jsxs("div", { className: "xdp-head-row", children: [
           /* @__PURE__ */ jsx("span", { className: "xdp-pill", "data-status": status, children: status === "personalized" ? "Personalized" : "Base content" }),
           /* @__PURE__ */ jsx("span", { className: "xdp-chip", title: v.source, children: sourceChip(v.source) }),
+          v.decisions.some(heldOut) ? /* @__PURE__ */ 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__ */ jsxs("span", { className: "xdp-ms", children: [
             v.ms,
             " ms"
@@ -3497,7 +3503,7 @@ function DecisionTab({ v }) {
       /* @__PURE__ */ jsx("code", { className: "xdp-key", children: d.key }),
       /* @__PURE__ */ jsx("span", { className: "xdp-result", "data-result": changed(d.result) ? "changed" : "base", children: d.result })
     ] }),
-    d.reason ? /* @__PURE__ */ jsx("p", { className: "xdp-reason", children: d.reason }) : null,
+    d.reason && d.reason !== "holdout" ? /* @__PURE__ */ jsx("p", { className: "xdp-reason", children: d.reason }) : null,
     d.trace.length ? /* @__PURE__ */ jsx("ol", { className: "xdp-steps", "aria-label": "Journey path", children: d.trace.map(([step, outcome]) => /* @__PURE__ */ jsxs("li", { children: [
       /* @__PURE__ */ jsx("code", { children: step }),
       /* @__PURE__ */ jsx("span", { children: /* @__PURE__ */ jsx(Id, { value: outcome }) })
@@ -3604,6 +3610,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)}