@burdenoff/website-sdk 2026.1027.1 → 2026.1029.1

package/dist/index.js

@@ -6468,6 +6468,11 @@ function ConceptDetail({
   );
 }
 
+// src/components/explore-fill.ts
+function fill(template, values) {
+  return template.replace(/\{(\w+)\}/g, (match, key) => values[key] ?? match);
+}
+
 // src/components/explore-i18n.ts
 var EXPLORE_LOCALES = ["en", "zh", "hi", "es", "ar", "ta"];
 var RTL_LOCALES = /* @__PURE__ */ new Set(["ar"]);
@@ -7255,9 +7260,6 @@ function resolveExploreLocale(explicit) {
 function exploreStrings(locale) {
   return STRINGS[locale] ?? EN;
 }
-function fill(template, values) {
-  return template.replace(/\{(\w+)\}/g, (match, key) => values[key] ?? match);
-}
 
 // src/components/answers-i18n.ts
 var EN2 = {
@@ -11031,6 +11033,10 @@ function useExploreChat(options = {}) {
     [client, productId]
   );
   const canEscalate = hasConversation && !isSharedView;
+  const getConversationToken = React.useCallback(
+    () => conversationTokenRef.current,
+    []
+  );
   return {
     phase,
     catalog,
@@ -11055,7 +11061,8 @@ function useExploreChat(options = {}) {
     escalate,
     canEscalate,
     createShareLink,
-    isSharedView
+    isSharedView,
+    getConversationToken
   };
 }
 var optimisticCounter = 0;
@@ -15162,6 +15169,164 @@ var ExploreCta = React.forwardRef(
     );
   }
 );
+
+// src/components/explore-avatar-live-config.ts
+var AVATAR_WEB_API_PATH = "/api/web-avatar/v1";
+var SITE = /^[a-z][a-z0-9-]{1,31}$/;
+var VERSION = /^[A-Za-z0-9._-]{1,32}$/;
+var SITE_KEY = /^[A-Za-z0-9_-]{1,128}$/;
+var LOOPBACK_HOSTS2 = /* @__PURE__ */ new Set(["localhost", "127.0.0.1", "[::1]"]);
+function isAvatarSite(value) {
+  return SITE.test(value);
+}
+function isAvatarVersion(value) {
+  return VERSION.test(value);
+}
+function avatarApiBase(gatewayUrl) {
+  if (!gatewayUrl) return null;
+  let url;
+  try {
+    url = new URL(gatewayUrl);
+  } catch {
+    return null;
+  }
+  const local = url.protocol === "http:" && LOOPBACK_HOSTS2.has(url.hostname.toLowerCase());
+  if (url.protocol !== "https:" && !local) return null;
+  return `${url.origin}${AVATAR_WEB_API_PATH}`;
+}
+function liveConfigComplete(live) {
+  return typeof live.load === "function" && typeof live.site === "string" && isAvatarSite(live.site) && typeof live.manifestVersion === "string" && isAvatarVersion(live.manifestVersion) && typeof live.turnstileSiteKey === "string" && SITE_KEY.test(live.turnstileSiteKey);
+}
+var REVIEWED = /* @__PURE__ */ new Set(["en"]);
+function isAvatarLiveLocaleReviewed(locale) {
+  return REVIEWED.has(locale);
+}
+var VIEW_LOAD_TIMEOUT_MS = 8e3;
+function loadAvatarLiveView() {
+  return import('./avatar-live-view/index.js').then(
+    (loaded) => loaded.AvatarLiveView
+  );
+}
+function ExploreAvatarLive({
+  live,
+  active,
+  locale,
+  productName,
+  still,
+  fallback,
+  onContinueInChat,
+  loadView = loadAvatarLiveView
+}) {
+  const T = exploreStrings(locale);
+  const config = useWebSDKConfig();
+  const conversation = React.useContext(ExploreConversationContext);
+  const base = avatarApiBase(config.gatewayUrl);
+  const headers = React.useMemo(
+    () => cfAccessHeaders(config.gatewayUrl, config.cfAccess),
+    [config.gatewayUrl, config.cfAccess]
+  );
+  const complete = liveConfigComplete(live);
+  const off = !complete || base === null || conversation === null || conversation.isSharedView || !isAvatarLiveLocaleReviewed(locale);
+  React.useEffect(() => {
+    if (!complete) {
+      console.warn(
+        "[WebSDK] ExplorePanel: avatar.live needs site, load, turnstileSiteKey and manifestVersion; the live avatar stays off."
+      );
+    }
+  }, [complete]);
+  const [View, setView] = React.useState(null);
+  const [failed, setFailed] = React.useState(false);
+  const wanted = active && !off;
+  React.useEffect(() => {
+    if (!wanted || View !== null) return;
+    let cancelled = false;
+    let loading;
+    try {
+      loading = loadView();
+    } catch (error) {
+      loading = Promise.reject(error);
+    }
+    const patience = setTimeout(() => {
+      if (!cancelled) setFailed(true);
+    }, VIEW_LOAD_TIMEOUT_MS);
+    loading.then(
+      (component) => {
+        if (!cancelled) setView(() => component);
+      },
+      () => {
+        clearTimeout(patience);
+        if (!cancelled) setFailed(true);
+      }
+    );
+    return () => {
+      cancelled = true;
+      clearTimeout(patience);
+    };
+  }, [wanted, View, loadView]);
+  if (View !== null) {
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      View,
+      {
+        live,
+        active,
+        locale,
+        productName,
+        still,
+        fallback,
+        onContinueInChat,
+        continueInChat: T.continueInChat,
+        off,
+        base,
+        headers,
+        conversation
+      }
+    );
+  }
+  if (off || failed) {
+    return (
+      // `display: contents`: the earlier Avatar view's picture, line and button lay out in the pane exactly as before.
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "div",
+        {
+          style: { display: "contents" },
+          "data-boff-explore": "avatar-live",
+          "data-phase": off ? "off" : "inert",
+          children: fallback
+        }
+      )
+    );
+  }
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "div",
+    {
+      "data-boff-explore": "avatar-live",
+      "data-phase": "idle",
+      className: "flex max-h-full w-full flex-col items-center gap-4 overflow-y-auto",
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsx(
+          "img",
+          {
+            src: still.src,
+            alt: still.alt,
+            decoding: "async",
+            width: 128,
+            height: 128,
+            className: "shrink-0 rounded-full border border-border object-cover shadow-sm h-32 w-32"
+          }
+        ),
+        /* @__PURE__ */ jsxRuntime.jsx(
+          "p",
+          {
+            role: "status",
+            "data-boff-explore": "avatar-live-status",
+            className: "text-sm text-muted-foreground"
+          }
+        ),
+        /* @__PURE__ */ jsxRuntime.jsx("div", { "data-boff-explore": "avatar-live-bot-check" })
+      ]
+    }
+  );
+}
 var MARK_KEY = "boffExplorePanel";
 var POS_KEY = "boffExplorePanelPos";
 var DOC_KEY = "boffExplorePanelDoc";
@@ -15353,15 +15518,15 @@ function ExplorePanel({
   const rtl = isRtlLocale(resolvedLocale);
   const catalogProducts = React.useContext(ExploreCatalogProductsContext);
   const pinnedSlug = pinnedProductSlug(scope, productSlug);
-  const title = React.useMemo(() => {
-    if (pinnedSlug === null) return T.panelTitle;
-    const name = productNameFor(
+  const pinnedName = React.useMemo(
+    () => pinnedSlug === null ? null : productNameFor(
       catalogProducts ?? ECOSYSTEM_PRODUCTS,
       pinnedSlug,
       productName
-    );
-    return name === null ? T.panelTitle : fill(T.panelTitleProduct, { product: name });
-  }, [T, catalogProducts, pinnedSlug, productName]);
+    ),
+    [catalogProducts, pinnedSlug, productName]
+  );
+  const title = pinnedName === null ? T.panelTitle : fill(T.panelTitleProduct, { product: pinnedName });
   const uid = React.useId();
   const titleId = `${uid}-title`;
   const chatTabId = `${uid}-chat-tab`;
@@ -15682,6 +15847,32 @@ function ExplorePanel({
   const tabButton = "rounded-md px-3 py-1.5 text-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring";
   const expanded = size === "expanded";
   const sizeLabel = expanded ? T.exitFullScreen : T.enterFullScreen;
+  const avatarAlt = avatar?.name ? `${avatar.name}, ${T.liveAvatar}` : T.liveAvatar;
+  const comingSoon = avatar ? /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+    /* @__PURE__ */ jsxRuntime.jsx(
+      "img",
+      {
+        src: avatar.src,
+        alt: avatarAlt,
+        loading: "lazy",
+        decoding: "async",
+        width: 128,
+        height: 128,
+        className: "h-32 w-32 rounded-full border border-border object-cover shadow-sm"
+      }
+    ),
+    /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-base font-semibold", children: T.avatarComingSoon }),
+    /* @__PURE__ */ jsxRuntime.jsx(
+      "button",
+      {
+        type: "button",
+        "data-boff-explore": "panel-continue-chat",
+        className: "inline-flex items-center justify-center rounded-md bg-primary px-4 py-2 text-sm font-medium text-primary-foreground transition-opacity hover:opacity-90 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background",
+        onClick: continueInChat,
+        children: T.continueInChat
+      }
+    )
+  ] }) : null;
   const tabs = [
     { key: "chat", id: chatTabId, pane: chatPaneId, label: T.tabChat },
     { key: "avatar", id: avatarTabId, pane: avatarPaneId, label: T.tabAvatar }
@@ -15811,7 +16002,7 @@ function ExplorePanel({
               )
             }
           ),
-          avatar ? /* @__PURE__ */ jsxRuntime.jsxs(
+          avatar ? /* @__PURE__ */ jsxRuntime.jsx(
             "div",
             {
               id: avatarPaneId,
@@ -15822,31 +16013,18 @@ function ExplorePanel({
                 "absolute inset-0 flex-col items-center justify-center gap-4 overflow-y-auto bg-background p-6 text-center",
                 view === "avatar" ? "flex" : "hidden"
               ),
-              children: [
-                /* @__PURE__ */ jsxRuntime.jsx(
-                  "img",
-                  {
-                    src: avatar.src,
-                    alt: avatar.name ? `${avatar.name}, ${T.liveAvatar}` : T.liveAvatar,
-                    loading: "lazy",
-                    decoding: "async",
-                    width: 128,
-                    height: 128,
-                    className: "h-32 w-32 rounded-full border border-border object-cover shadow-sm"
-                  }
-                ),
-                /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-base font-semibold", children: T.avatarComingSoon }),
-                /* @__PURE__ */ jsxRuntime.jsx(
-                  "button",
-                  {
-                    type: "button",
-                    "data-boff-explore": "panel-continue-chat",
-                    className: "inline-flex items-center justify-center rounded-md bg-primary px-4 py-2 text-sm font-medium text-primary-foreground transition-opacity hover:opacity-90 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background",
-                    onClick: continueInChat,
-                    children: T.continueInChat
-                  }
-                )
-              ]
+              children: avatar.live ? /* @__PURE__ */ jsxRuntime.jsx(
+                ExploreAvatarLive,
+                {
+                  live: avatar.live,
+                  active: open && view === "avatar",
+                  locale: resolvedLocale,
+                  productName: pinnedName,
+                  still: { src: avatar.src, alt: avatarAlt },
+                  fallback: comingSoon,
+                  onContinueInChat: continueInChat
+                }
+              ) : comingSoon
             }
           ) : null
         ] })
@@ -16628,6 +16806,10 @@ function BlogPostPage(props) {
   ] });
 }
 var CASE_STUDY_TAG = "case-study";
+function hasCustomerSignOff(page) {
+  const signedAt = page.customerSignOff?.signedAt;
+  return typeof signedAt === "string" && !Number.isNaN(new Date(signedAt).getTime());
+}
 var ANIMATION_STYLES = `
 @keyframes csFadeUp { from { opacity: 0; transform: translateY(16px); } to { opacity: 1; transform: translateY(0); } }
 @keyframes csFloat { 0%, 100% { transform: translateY(0); } 50% { transform: translateY(-14px); } }
@@ -16657,6 +16839,9 @@ var CASE_STUDIES_QUERY = `
         readingTime
         featured
         category
+        customerSignOff {
+          signedAt
+        }
       }
       total
       hasMore
@@ -16683,6 +16868,9 @@ var CASE_STUDY_QUERY = `
       readingTime
       featured
       category
+      customerSignOff {
+        signedAt
+      }
     }
   }
 `;
@@ -17053,11 +17241,15 @@ function CaseStudiesListPage(props) {
         setPosts([]);
         return;
       }
-      const caseStudies = (result.data?.publicContentPages?.items || []).filter(
-        (p) => p.tags?.includes(CASE_STUDY_TAG)
+      const items = result.data?.publicContentPages?.items || [];
+      const caseStudies = items.filter(
+        (p) => p.tags?.includes(CASE_STUDY_TAG) && hasCustomerSignOff(p)
       );
       setPosts(caseStudies);
-      setTotal(result.data?.publicContentPages?.total || 0);
+      const dropped = items.length - caseStudies.length;
+      setTotal(
+        Math.max(0, (result.data?.publicContentPages?.total || 0) - dropped)
+      );
       setError(null);
     } catch {
       setError("load-failed");
@@ -17239,7 +17431,8 @@ function CaseStudyPage(props) {
           setError(result.errors[0]?.message ?? "Failed to load case study");
           return;
         }
-        setPost(result.data?.publicContentPage ?? null);
+        const page = result.data?.publicContentPage ?? null;
+        setPost(page && hasCustomerSignOff(page) ? page : null);
         setError(null);
       } catch {
         setError("Failed to load case study");
@@ -17308,6 +17501,7 @@ function CaseStudyPage(props) {
     ] }) });
   }
   const formattedDate = formatDate(post.publishedAt || post.lastUpdated);
+  const approvedDate = formatDate(post.customerSignOff?.signedAt);
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: `w-full ${className}`, children: [
     /* @__PURE__ */ jsxRuntime.jsx(ProseStyles, {}),
     /* @__PURE__ */ jsxRuntime.jsx(
@@ -17345,6 +17539,17 @@ function CaseStudyPage(props) {
           ] })
         ] }) : null
       ] }),
+      approvedDate && /* @__PURE__ */ jsxRuntime.jsxs(
+        "p",
+        {
+          className: "-mt-4 mb-8 text-xs text-muted-foreground",
+          "data-cs": "customer-signoff",
+          children: [
+            "Approved for publication by the customer on ",
+            approvedDate
+          ]
+        }
+      ),
       post.thumbnail && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "mb-10 aspect-[16/9] overflow-hidden rounded-xl", children: /* @__PURE__ */ jsxRuntime.jsx(
         "img",
         {
@@ -20637,6 +20842,112 @@ function shouldRenderSiteFooter(pathname) {
   return !isFooterlessPath(pathname);
 }
 
+// src/comparison/index.ts
+var DEFAULT_COMPARISON_MAX_AGE_DAYS = 180;
+var DAY_MS = 24 * 60 * 60 * 1e3;
+var ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
+function parseVerifiedAt(value) {
+  if (typeof value !== "string" || !ISO_DATE.test(value)) return null;
+  const date = /* @__PURE__ */ new Date(`${value}T00:00:00.000Z`);
+  if (Number.isNaN(date.getTime())) return null;
+  return date.toISOString().slice(0, 10) === value ? date : null;
+}
+function isHttpUrl(value) {
+  try {
+    const url = new URL(value);
+    return url.protocol === "https:" || url.protocol === "http:";
+  } catch {
+    return false;
+  }
+}
+function checkComparisonFreshness(claims, options = {}) {
+  const maxAgeDays = options.maxAgeDays ?? DEFAULT_COMPARISON_MAX_AGE_DAYS;
+  const now2 = options.now ?? /* @__PURE__ */ new Date();
+  const issues = [];
+  for (const claim of claims) {
+    const sources = claim.sources ?? [];
+    if (sources.length === 0) {
+      issues.push({
+        path: claim.path,
+        problem: "missing-source",
+        detail: "no source: add { url, verifiedAt } for the vendor page this claim was checked against"
+      });
+      continue;
+    }
+    let newest = null;
+    for (const source of sources) {
+      if (!isHttpUrl(source.url)) {
+        issues.push({
+          path: claim.path,
+          problem: "invalid-url",
+          detail: `source URL is not an http(s) URL: ${JSON.stringify(source.url)}`
+        });
+      }
+      const verified = parseVerifiedAt(source.verifiedAt);
+      if (!verified) {
+        issues.push({
+          path: claim.path,
+          problem: "invalid-date",
+          detail: `verifiedAt must be YYYY-MM-DD, got ${JSON.stringify(source.verifiedAt)}`
+        });
+        continue;
+      }
+      if (verified.getTime() > now2.getTime() + DAY_MS) {
+        issues.push({
+          path: claim.path,
+          problem: "future-date",
+          detail: `verifiedAt ${source.verifiedAt} is in the future`
+        });
+        continue;
+      }
+      if (!newest || verified.getTime() > newest.getTime()) newest = verified;
+    }
+    if (newest) {
+      const ageDays = Math.floor((now2.getTime() - newest.getTime()) / DAY_MS);
+      if (ageDays > maxAgeDays) {
+        issues.push({
+          path: claim.path,
+          problem: "stale",
+          detail: `last verified ${newest.toISOString().slice(0, 10)} (${ageDays} days ago, limit ${maxAgeDays}): re-read the vendor page and update verifiedAt or the claim`
+        });
+      }
+    }
+  }
+  return issues;
+}
+function latestVerification(claims) {
+  let latest = null;
+  for (const claim of claims) {
+    for (const source of claim.sources ?? []) {
+      if (parseVerifiedAt(source.verifiedAt) && (!latest || source.verifiedAt > latest)) {
+        latest = source.verifiedAt;
+      }
+    }
+  }
+  return latest;
+}
+function oldestVerification(claims) {
+  let oldest = null;
+  for (const claim of claims) {
+    for (const source of claim.sources ?? []) {
+      if (parseVerifiedAt(source.verifiedAt) && (!oldest || source.verifiedAt < oldest)) {
+        oldest = source.verifiedAt;
+      }
+    }
+  }
+  return oldest;
+}
+function formatFreshnessReport(issues) {
+  if (issues.length === 0)
+    return "Comparison sources: all claims sourced and fresh.";
+  const lines = issues.map((i) => `  - [${i.problem}] ${i.path}: ${i.detail}`);
+  return [
+    `Comparison sources: ${issues.length} problem(s) found.`,
+    ...lines,
+    "Re-check each claim against the vendor's current page, then update the claim and its verifiedAt."
+  ].join("\n");
+}
+
 exports.ANSWERS_PATH = ANSWERS_PATH;
 exports.ANSWER_HEADING_SHIFT = ANSWER_HEADING_SHIFT;
 exports.ANSWER_PATH_PREFIX = ANSWER_PATH_PREFIX;
@@ -20659,6 +20970,7 @@ exports.ConceptsPage = ConceptsPage;
 exports.ContactPage = ContactPage;
 exports.ContentRenderer = ContentRenderer;
 exports.ContractsPage = ContractsPage;
+exports.DEFAULT_COMPARISON_MAX_AGE_DAYS = DEFAULT_COMPARISON_MAX_AGE_DAYS;
 exports.DEFAULT_CONTACT_CATEGORIES = DEFAULT_CONTACT_CATEGORIES;
 exports.DEFAULT_EXPLORE_EXAMPLE_PROMPTS = DEFAULT_EXPLORE_EXAMPLE_PROMPTS;
 exports.DOMAINS_URL = DOMAINS_URL;
@@ -20726,6 +21038,7 @@ exports.answerSpeechText = answerSpeechText;
 exports.answerStrings = answerStrings;
 exports.availablePlanCurrencies = availablePlanCurrencies;
 exports.buttonVariants = buttonVariants;
+exports.checkComparisonFreshness = checkComparisonFreshness;
 exports.classifyExploreError = classifyExploreError;
 exports.cleanPlanDisplayName = cleanPlanDisplayName;
 exports.cn = cn;
@@ -20742,11 +21055,13 @@ exports.fetchPublicProduct = fetchPublicProduct;
 exports.findLegalDocument = findLegalDocument;
 exports.formatAnswerDate = formatAnswerDate;
 exports.formatDownloads = formatDownloads;
+exports.formatFreshnessReport = formatFreshnessReport;
 exports.formatLegalDate = formatLegalDate;
 exports.formatPrice = formatPrice2;
 exports.getAnswerBySlug = getAnswerBySlug;
 exports.getConceptBySlug = getConceptBySlug;
 exports.getRecaptchaV3Token = getRecaptchaV3Token;
+exports.hasCustomerSignOff = hasCustomerSignOff;
 exports.inlineImageOrigins = inlineImageOrigins;
 exports.isFooterlessPath = isFooterlessPath;
 exports.isInlineImageAllowed = isInlineImageAllowed;
@@ -20755,11 +21070,14 @@ exports.isPublishedSourceUrl = isPublishedSourceUrl;
 exports.isSameProductSlug = isSameProductSlug;
 exports.isUuidLike = isUuidLike;
 exports.isValidUrl = isValidUrl;
+exports.latestVerification = latestVerification;
 exports.legacyProductSlug = legacyProductSlug;
 exports.loadRecaptchaV3 = loadRecaptchaV3;
 exports.looksLikeDeliverableEmail = looksLikeDeliverableEmail;
 exports.normalizeProductSlug = normalizeProductSlug;
 exports.normalizeRoutePath = normalizeRoutePath;
+exports.oldestVerification = oldestVerification;
+exports.parseVerifiedAt = parseVerifiedAt;
 exports.planPriceIn = planPriceIn;
 exports.productSlugVariants = productSlugVariants;
 exports.productSlugsByOrigin = productSlugsByOrigin;