@burdenoff/website-sdk 2026.922.3 → 2026.922.5

package/dist/hooks/index.mjs

@@ -275,11 +275,9 @@ var EXPLORE_OWN_MESSAGE_FIELDS = (
   }
 `
 );
-var EXPLORE_CATALOG_QUERY = (
+var EXPLORE_CATALOG_ESTABLISHED_FIELDS = (
   /* GraphQL */
   `
-  query ExploreCatalog($productSlug: String) {
-    exploreCatalog(productSlug: $productSlug) {
       enabled
       products {
         slug
@@ -297,11 +295,35 @@ var EXPLORE_CATALOG_QUERY = (
         historyTurns
       }
       captchaRequired
-      recaptchaSiteKey
+      recaptchaSiteKey`
+);
+var EXPLORE_CATALOG_HIGHLIGHT_FIELD = (
+  /* GraphQL */
+  `
+      conceptHighlights {
+        product
+        productName
+        title
+        url
+        imageUrl
+        alt
+      }`
+);
+function exploreCatalogDocument(extraFields) {
+  return (
+    /* GraphQL */
+    `
+  query ExploreCatalog($productSlug: String) {
+    exploreCatalog(productSlug: $productSlug) {${EXPLORE_CATALOG_ESTABLISHED_FIELDS}${extraFields}
     }
   }
 `
+  );
+}
+var EXPLORE_CATALOG_QUERY = exploreCatalogDocument(
+  EXPLORE_CATALOG_HIGHLIGHT_FIELD
 );
+var EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS = exploreCatalogDocument("");
 var EXPLORE_MESSAGE_QUERY = (
   /* GraphQL */
   `
@@ -665,7 +687,12 @@ function buildFallbackCatalog(examplePrompts, welcome) {
     welcomeBody: welcome?.body ?? FALLBACK_WELCOME_BODY,
     limits: FALLBACK_EXPLORE_LIMITS,
     captchaRequired: false,
-    recaptchaSiteKey: null
+    recaptchaSiteKey: null,
+    // Empty, and deliberately not synthesised from `ECOSYSTEM_PRODUCTS`: a concept highlight
+    // needs a real published illustration URL, and this SDK has no registry of them. An
+    // invented path would render 38 broken frames on the one screen every prerender captures.
+    // The strip renders nothing at all when the list is empty, which is the honest fallback.
+    conceptHighlights: []
   };
 }
 function normalizeCatalog(raw, fallback) {
@@ -682,9 +709,27 @@ function normalizeCatalog(raw, fallback) {
       historyTurns: raw.limits?.historyTurns || fallback.limits.historyTurns
     },
     captchaRequired: raw.captchaRequired === true,
-    recaptchaSiteKey: raw.recaptchaSiteKey ?? null
+    recaptchaSiteKey: raw.recaptchaSiteKey ?? null,
+    // `[ExploreConceptHighlight!]!` on the wire, so a gateway that KNOWS the field always
+    // sends an array. The one response that arrives without it is the retry against an older
+    // supergraph (`EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS`) — that gateway does not answer
+    // the full document at all, it refuses it. Either way
+    // `catalog.conceptHighlights.filter(...)` on `undefined` would throw inside render,
+    // blanking the welcome screen over a decorative strip.
+    conceptHighlights: raw.conceptHighlights?.length ? raw.conceptHighlights : fallback.conceptHighlights
   };
 }
+var CATALOG_DOCUMENT_REJECTED_CODES = /* @__PURE__ */ new Set([
+  "GRAPHQL_VALIDATION_FAILED",
+  "HTTP_400"
+]);
+function catalogRejectedTheHighlightField(res) {
+  if (res.data?.exploreCatalog) return false;
+  return (res.errors ?? []).some((error) => {
+    const code = error.extensions?.code;
+    return typeof code === "string" && CATALOG_DOCUMENT_REJECTED_CODES.has(code) || error.message.includes("conceptHighlights");
+  });
+}
 var RATE_LIMIT_CODES = /* @__PURE__ */ new Set([
   "RATE_LIMITED",
   "HTTP_429",
@@ -1024,11 +1069,19 @@ function useExploreChat(options = {}) {
   useEffect(() => {
     let cancelled = false;
     const load = async () => {
-      const res = await client.query(
+      const variables = { productSlug: productSlug ?? null };
+      let res = await client.query(
         EXPLORE_CATALOG_QUERY,
-        { productSlug: productSlug ?? null }
+        variables
       );
       if (cancelled || !mountedRef.current) return;
+      if (catalogRejectedTheHighlightField(res)) {
+        res = await client.query(
+          EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS,
+          variables
+        );
+        if (cancelled || !mountedRef.current) return;
+      }
       const raw = res.data?.exploreCatalog;
       if (res.errors?.length || !raw) {
         console.warn(
@@ -1692,7 +1745,360 @@ function useSpeechInput({
   );
   return { supported, listening, interim, error, start, stop, toggle };
 }
+var SILENT_FAILURE_MS = 1500;
+function speechPlatform() {
+  if (typeof window === "undefined") return null;
+  const scope = window;
+  const synth = scope.speechSynthesis;
+  const Utterance = scope.SpeechSynthesisUtterance;
+  if (!synth || typeof synth.speak !== "function") return null;
+  if (typeof Utterance !== "function") return null;
+  return { synth, Utterance };
+}
+function normaliseTag(tag) {
+  return tag.trim().toLowerCase().replace(/_/g, "-");
+}
+function primaryOf(tag) {
+  return normaliseTag(tag).split("-")[0] ?? "";
+}
+function pickVoice(voices, lang) {
+  const wanted = normaliseTag(lang);
+  if (wanted === "") return null;
+  const primary = primaryOf(wanted);
+  const exact = voices.filter((voice) => normaliseTag(voice.lang) === wanted);
+  const related = voices.filter((voice) => primaryOf(voice.lang) === primary);
+  return exact.find((voice) => voice.default) ?? exact[0] ?? related.find((voice) => voice.default) ?? related[0] ?? null;
+}
+var activeOwner = null;
+var activeStop = null;
+function stopSpeaking() {
+  activeStop?.();
+}
+function useSpeechOutput({
+  lang
+} = {}) {
+  const [available, setAvailable] = useState(() => speechPlatform() !== null);
+  const [speaking, setSpeaking] = useState(false);
+  const utteranceRef = useRef(null);
+  const watchdogRef = useRef(null);
+  const ownerRef = useRef({});
+  const stopRef = useRef(() => void 0);
+  const langRef = useRef(lang);
+  langRef.current = lang;
+  const clearWatchdog = useCallback(() => {
+    if (watchdogRef.current === null) return;
+    clearTimeout(watchdogRef.current);
+    watchdogRef.current = null;
+  }, []);
+  const settle = useCallback(() => {
+    clearWatchdog();
+    utteranceRef.current = null;
+    if (activeOwner === ownerRef.current) {
+      activeOwner = null;
+      activeStop = null;
+    }
+    setSpeaking(false);
+  }, [clearWatchdog]);
+  const stop = useCallback(() => {
+    const owned = utteranceRef.current !== null;
+    settle();
+    if (owned) speechPlatform()?.synth.cancel();
+  }, [settle]);
+  stopRef.current = stop;
+  const speak = useCallback(
+    (text) => {
+      const platform = speechPlatform();
+      if (!platform) {
+        setAvailable(false);
+        return;
+      }
+      const spoken = text.trim();
+      if (spoken === "") return;
+      if (activeStop && activeOwner !== ownerRef.current) activeStop();
+      platform.synth.cancel();
+      const utterance = new platform.Utterance(spoken);
+      const wanted = langRef.current;
+      if (wanted !== void 0 && wanted !== "") {
+        const voice = pickVoice(platform.synth.getVoices(), wanted);
+        utterance.lang = voice?.lang ?? wanted;
+        if (voice) utterance.voice = voice;
+      }
+      const mine = () => utteranceRef.current === utterance;
+      utterance.onstart = () => {
+        if (!mine()) return;
+        clearWatchdog();
+        setSpeaking(true);
+      };
+      utterance.onend = () => {
+        if (!mine()) return;
+        settle();
+      };
+      utterance.onerror = (event) => {
+        if (!mine()) return;
+        const code = typeof event?.error === "string" ? event.error : "";
+        settle();
+        if (code !== "interrupted" && code !== "canceled") setAvailable(false);
+      };
+      utteranceRef.current = utterance;
+      activeOwner = ownerRef.current;
+      activeStop = () => {
+        stopRef.current();
+      };
+      setSpeaking(true);
+      platform.synth.speak(utterance);
+      clearWatchdog();
+      watchdogRef.current = setTimeout(() => {
+        watchdogRef.current = null;
+        if (!mine()) return;
+        if (platform.synth.speaking) return;
+        settle();
+        setAvailable(false);
+      }, SILENT_FAILURE_MS);
+    },
+    [clearWatchdog, settle]
+  );
+  const toggle = useCallback(
+    (text) => {
+      if (speaking) stop();
+      else speak(text);
+    },
+    [speak, speaking, stop]
+  );
+  useEffect(() => {
+    if (!speaking || typeof window === "undefined") return;
+    const onHide = () => {
+      stopRef.current();
+    };
+    window.addEventListener("pagehide", onHide);
+    return () => window.removeEventListener("pagehide", onHide);
+  }, [speaking]);
+  useEffect(
+    () => () => {
+      stopRef.current();
+    },
+    []
+  );
+  return { supported: available, speaking, speak, stop, toggle };
+}
+var DRAIN_TARGET_MS = 1200;
+var MIN_CHARS_PER_SECOND = 90;
+var MAX_CHARS_PER_SECOND = 2200;
+var MAX_STEP_MS = 250;
+var COMMIT_INTERVAL_MS = 45;
+var FALLBACK_STEP_MS = 50;
+var FENCE = /^ {0,3}(?:```|~~~)/;
+var TABLE_ROW = /^ {0,3}\|/;
+var EMPTY_BLOCK_MARKER = /^ {0,3}(?:[-+>]|#{1,6}|\d{1,9}[.)])\s*$/;
+function isWordCharacter(char) {
+  return char !== void 0 && /[\p{L}\p{N}]/u.test(char);
+}
+function clamp(value, min, max) {
+  return Math.min(Math.max(value, min), max);
+}
+function now() {
+  return typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
+}
+function isHighSurrogate(code) {
+  return code >= 55296 && code <= 56319;
+}
+function safeInlineEnd(line) {
+  let codeSpan = null;
+  let link = null;
+  const emphasis = [];
+  let at = 0;
+  while (at < line.length) {
+    const char = line[at] ?? "";
+    if (char === "\\") {
+      at += 2;
+      continue;
+    }
+    if (char === "`") {
+      let run = 1;
+      while (line[at + run] === "`") run += 1;
+      codeSpan = codeSpan === null ? at : null;
+      at += run;
+      continue;
+    }
+    if (codeSpan !== null) {
+      at += 1;
+      continue;
+    }
+    if (char === "[") {
+      if (link === null) link = line[at - 1] === "!" ? at - 1 : at;
+      at += 1;
+      continue;
+    }
+    if (char === "]") {
+      if (link !== null && line[at + 1] !== "(") link = null;
+      at += 1;
+      continue;
+    }
+    if (char === ")") {
+      link = null;
+      at += 1;
+      continue;
+    }
+    if (char === "*" || char === "_" || char === "~") {
+      let run = 1;
+      while (line[at + run] === char) run += 1;
+      const start = at;
+      at += run;
+      const before = line[start - 1];
+      const after = line[start + run];
+      if (run < 2) continue;
+      if (char === "_" && isWordCharacter(before) && isWordCharacter(after)) {
+        continue;
+      }
+      const marker = char.repeat(run);
+      const open2 = emphasis.findIndex((entry) => entry.marker === marker);
+      if (open2 !== -1) {
+        emphasis.splice(open2, 1);
+        continue;
+      }
+      if (after !== void 0 && /\s/.test(after)) continue;
+      emphasis.push({ marker, start });
+      continue;
+    }
+    at += 1;
+  }
+  const open = [codeSpan, link, emphasis[0]?.start ?? null].filter(
+    (value) => value !== null
+  );
+  return open.length === 0 ? line.length : Math.min(...open);
+}
+function revealBoundary(text, limit) {
+  if (limit <= 0) return 0;
+  const caughtUp = limit >= text.length;
+  const head = caughtUp ? text : text.slice(0, limit);
+  const lineStart = head.lastIndexOf("\n") + 1;
+  const line = head.slice(lineStart);
+  let fenceStart = null;
+  let tableStart = null;
+  let tableRows = 0;
+  let at = 0;
+  while (at < lineStart) {
+    const breakAt = head.indexOf("\n", at);
+    const end = breakAt === -1 ? lineStart : breakAt;
+    const row = head.slice(at, end);
+    if (fenceStart !== null) {
+      if (FENCE.test(row)) fenceStart = null;
+    } else if (FENCE.test(row)) {
+      fenceStart = at;
+    } else if (TABLE_ROW.test(row)) {
+      if (tableStart === null) {
+        tableStart = at;
+        tableRows = 0;
+      }
+      tableRows += 1;
+    } else if (tableStart !== null) {
+      tableStart = null;
+      tableRows = 0;
+    }
+    at = end + 1;
+  }
+  if (fenceStart === null) {
+    const lastIsRow = TABLE_ROW.test(line);
+    if (lastIsRow && tableStart === null) {
+      tableStart = lineStart;
+      tableRows = 0;
+    } else if (!lastIsRow && line !== "") {
+      tableStart = null;
+      tableRows = 0;
+    }
+    if (tableStart !== null && tableRows < 2) return tableStart;
+  }
+  if (caughtUp) return text.length;
+  if (fenceStart !== null) return fenceStart;
+  if (TABLE_ROW.test(line)) return lineStart;
+  if (EMPTY_BLOCK_MARKER.test(line)) return lineStart;
+  const cut = lineStart + safeInlineEnd(line);
+  return isHighSurrogate(text.charCodeAt(cut - 1)) ? cut - 1 : cut;
+}
+function prefersReducedMotion() {
+  if (typeof window === "undefined") return true;
+  try {
+    return window.matchMedia?.("(prefers-reduced-motion: reduce)").matches === true;
+  } catch {
+    return false;
+  }
+}
+function useProgressiveReveal(text, settled) {
+  const [, setFrame] = useState(0);
+  const [reduced] = useState(prefersReducedMotion);
+  const immediate = settled || reduced;
+  const textRef = useRef(text);
+  const cursorRef = useRef(immediate ? text.length : 0);
+  const cutRef = useRef(immediate ? text.length : 0);
+  const committedRef = useRef(0);
+  if (text !== textRef.current) {
+    const revealed = textRef.current.slice(0, Math.floor(cursorRef.current));
+    if (revealed !== "" && !text.startsWith(revealed)) {
+      cursorRef.current = text.length;
+    }
+    cursorRef.current = Math.min(cursorRef.current, text.length);
+    cutRef.current = Math.min(cutRef.current, text.length);
+    textRef.current = text;
+  }
+  if (immediate) cursorRef.current = text.length;
+  const cut = immediate ? text.length : Math.max(
+    cutRef.current,
+    revealBoundary(text, Math.floor(cursorRef.current))
+  );
+  cutRef.current = cut;
+  useEffect(() => {
+    if (immediate) return;
+    if (cursorRef.current >= text.length) return;
+    let cancelled = false;
+    let cancelStep = null;
+    let previous = now();
+    const commit = (at, force) => {
+      if (!force && at - committedRef.current < COMMIT_INTERVAL_MS) return;
+      committedRef.current = at;
+      setFrame((value) => value + 1);
+    };
+    const step = () => {
+      cancelStep = null;
+      if (cancelled) return;
+      const at = now();
+      const elapsed = clamp(at - previous, 0, MAX_STEP_MS);
+      previous = at;
+      const length = textRef.current.length;
+      const pending = length - cursorRef.current;
+      if (pending <= 0) {
+        commit(at, true);
+        return;
+      }
+      const perSecond = clamp(
+        pending / (DRAIN_TARGET_MS / 1e3),
+        MIN_CHARS_PER_SECOND,
+        MAX_CHARS_PER_SECOND
+      );
+      cursorRef.current = Math.min(
+        length,
+        cursorRef.current + perSecond * elapsed / 1e3
+      );
+      const done = cursorRef.current >= length;
+      commit(at, done);
+      if (!done) schedule();
+    };
+    const schedule = () => {
+      if (typeof window.requestAnimationFrame === "function") {
+        const id2 = window.requestAnimationFrame(step);
+        cancelStep = () => window.cancelAnimationFrame(id2);
+        return;
+      }
+      const id = setTimeout(step, FALLBACK_STEP_MS);
+      cancelStep = () => clearTimeout(id);
+    };
+    schedule();
+    return () => {
+      cancelled = true;
+      cancelStep?.();
+    };
+  }, [text, immediate]);
+  return text.slice(0, cut);
+}
 
-export { DEFAULT_EXPLORE_EXAMPLE_PROMPTS, FALLBACK_EXPLORE_LIMITS, classifyExploreError, useExploreChat, useSpeechInput };
+export { DEFAULT_EXPLORE_EXAMPLE_PROMPTS, FALLBACK_EXPLORE_LIMITS, classifyExploreError, stopSpeaking, useExploreChat, useProgressiveReveal, useSpeechInput, useSpeechOutput };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map