@burdenoff/website-sdk 2026.922.4 → 2026.923.1

package/dist/hooks/index.mjs

@@ -224,6 +224,10 @@ function useWebSDK() {
   }
   return client;
 }
+function useWebSDKConfig() {
+  const client = useWebSDK();
+  return client.getConfig();
+}
 
 // src/components/explore-types.ts
 var EXPLORE_MESSAGE_FIELDS = (
@@ -383,6 +387,22 @@ var SUBMIT_EXPLORE_FEEDBACK_MUTATION = (
   }
 `
 );
+var ESCALATE_EXPLORE_CONVERSATION_MUTATION = (
+  /* GraphQL */
+  `
+  mutation EscalateExploreConversation(
+    $input: EscalateExploreConversationInput!
+  ) {
+    escalateExploreConversation(input: $input) {
+      created
+      escalation {
+        email
+        createdAt
+      }
+    }
+  }
+`
+);
 var CREATE_EXPLORE_SHARE_LINK_MUTATION = (
   /* GraphQL */
   `
@@ -749,6 +769,25 @@ var VALIDATION_CODES = /* @__PURE__ */ new Set([
   "CONVERSATION_LIMIT",
   "INVALID_INPUT"
 ]);
+function escalateOutcomeForCode(code) {
+  switch (code) {
+    case "INVALID_EMAIL":
+      return "invalid-email";
+    case "RATE_LIMITED":
+    case "HTTP_429":
+      return "rate-limited";
+    case "CAPTCHA_REQUIRED":
+    case "CAPTCHA_FAILED":
+      return "captcha";
+    // The token owns nothing, or owns a different conversation. The server answers NOT_FOUND
+    // rather than FORBIDDEN so the endpoint is not an oracle for whether a thread exists;
+    // either way there is nothing this visitor can do about it, so it reads as a failure.
+    case "NOT_FOUND":
+      return "failed";
+    default:
+      return "failed";
+  }
+}
 function classifyExploreError(code, serverMessage) {
   const c = code ?? "UNKNOWN";
   if (RATE_LIMIT_CODES.has(c)) {
@@ -915,6 +954,7 @@ function useExploreChat(options = {}) {
     onSend
   } = options;
   const client = useWebSDK();
+  const { productId } = useWebSDKConfig();
   const promptKey = JSON.stringify(examplePrompts ?? []);
   const welcomeKey = JSON.stringify(fallbackWelcome ?? null);
   const fallbackCatalog = useMemo(
@@ -938,6 +978,7 @@ function useExploreChat(options = {}) {
   const pollGenerationRef = useRef(0);
   const pollTimerRef = useRef(null);
   const conversationTokenRef = useRef(null);
+  const [hasConversation, setHasConversation] = useState(false);
   const shareTokenRef = useRef(void 0);
   if (shareTokenRef.current === void 0) {
     shareTokenRef.current = readShareToken();
@@ -952,6 +993,10 @@ function useExploreChat(options = {}) {
   );
   const inFlightRef = useRef(false);
   catalogRef.current = catalog;
+  const rememberConversationToken = useCallback((token) => {
+    conversationTokenRef.current = token;
+    setHasConversation(token !== null);
+  }, []);
   const clearPollTimer = useCallback(() => {
     if (pollTimerRef.current !== null) {
       clearTimeout(pollTimerRef.current);
@@ -1018,7 +1063,7 @@ function useExploreChat(options = {}) {
     setArchive(readArchive(storageKey));
     const stored = readPersisted(storageKey);
     if (stored) {
-      conversationTokenRef.current = stored.conversationToken;
+      rememberConversationToken(stored.conversationToken);
       focusProductRef.current = stored.focusProduct;
       const settled = stored.messages.flatMap((m) => {
         if (m.role !== "ASSISTANT") return [m];
@@ -1034,7 +1079,7 @@ function useExploreChat(options = {}) {
       setTurnCount(turns);
     }
     setHydrated(true);
-  }, [persist, storageKey]);
+  }, [persist, rememberConversationToken, storageKey]);
   useEffect(() => {
     if (!persist || !hydrated || typeof window === "undefined") return;
     try {
@@ -1227,7 +1272,7 @@ function useExploreChat(options = {}) {
         setPhase(classified.kind === "rate-limit" ? "limited" : "error");
         return;
       }
-      conversationTokenRef.current = result.conversation.token;
+      rememberConversationToken(result.conversation.token);
       turnCountRef.current = result.conversation.turnCount;
       setTurnCount(result.conversation.turnCount);
       setRemainingToday(result.remainingToday ?? null);
@@ -1253,7 +1298,14 @@ function useExploreChat(options = {}) {
       setPhase("streaming");
       startPolling(result.conversation.token, assistantMessage.id);
     },
-    [client, locale, pageUrl, productSlug, startPolling]
+    [
+      client,
+      locale,
+      pageUrl,
+      productSlug,
+      rememberConversationToken,
+      startPolling
+    ]
   );
   const send = useCallback(
     async (message, attachments = []) => {
@@ -1370,7 +1422,7 @@ function useExploreChat(options = {}) {
     );
     cancelPolling();
     inFlightRef.current = false;
-    conversationTokenRef.current = null;
+    rememberConversationToken(null);
     lastSentTextRef.current = null;
     lastSentAttachmentsRef.current = [];
     turnCountRef.current = 0;
@@ -1385,7 +1437,7 @@ function useExploreChat(options = {}) {
       } catch {
       }
     }
-  }, [cancelPolling, storageKey]);
+  }, [cancelPolling, rememberConversationToken, storageKey]);
   const openConversation = useCallback(
     (token) => {
       const entry = readArchive(storageKey).find((e) => e.token === token);
@@ -1397,7 +1449,7 @@ function useExploreChat(options = {}) {
       });
       cancelPolling();
       inFlightRef.current = false;
-      conversationTokenRef.current = entry.token;
+      rememberConversationToken(entry.token);
       turnCountRef.current = entry.messages.filter(
         (m) => m.role === "USER"
       ).length;
@@ -1409,7 +1461,7 @@ function useExploreChat(options = {}) {
       setPhase(catalogRef.current.enabled ? "ready" : "disabled");
       setArchive(readArchive(storageKey));
     },
-    [cancelPolling, storageKey]
+    [cancelPolling, rememberConversationToken, storageKey]
   );
   const deleteConversation = useCallback(
     (token) => {
@@ -1498,6 +1550,69 @@ function useExploreChat(options = {}) {
     },
     [client]
   );
+  const escalate = useCallback(
+    async (email, note) => {
+      const token = conversationTokenRef.current;
+      if (!token) {
+        return { outcome: "no-conversation", email: null, createdAt: null };
+      }
+      const attempt = async (captchaAttempt) => {
+        const activeCatalog = catalogRef.current;
+        let recaptchaToken;
+        if (activeCatalog.captchaRequired && activeCatalog.recaptchaSiteKey) {
+          try {
+            recaptchaToken = await getRecaptchaV3Token(
+              activeCatalog.recaptchaSiteKey
+            );
+          } catch (err) {
+            console.warn(
+              "[WebSDK] reCAPTCHA v3 token could not be minted",
+              err
+            );
+          }
+        }
+        const input = {
+          conversationToken: token,
+          email: email.trim(),
+          note: note?.trim() ? note.trim() : null,
+          ...recaptchaToken ? { recaptchaToken } : {},
+          ...productId ? { productId } : {}
+        };
+        try {
+          const res = await client.mutate(
+            ESCALATE_EXPLORE_CONVERSATION_MUTATION,
+            { input }
+          );
+          const first = res?.errors?.[0];
+          const result = res?.data?.escalateExploreConversation;
+          if (first || !result) {
+            const code = typeof first?.extensions?.code === "string" ? first.extensions.code : "ESCALATION_FAILED";
+            if (code === "CAPTCHA_FAILED" && captchaAttempt === 0) {
+              return attempt(1);
+            }
+            return {
+              outcome: escalateOutcomeForCode(code),
+              email: null,
+              createdAt: null
+            };
+          }
+          return {
+            // `created: false` is the double-click, the retry, the reload. The handover
+            // exists, so this is a success — and the address comes from the SERVER, because
+            // on a repeat submit the reply goes to whatever the FIRST handover used.
+            outcome: result.created ? "sent" : "already-handed-over",
+            email: result.escalation?.email ?? null,
+            createdAt: result.escalation?.createdAt ?? null
+          };
+        } catch {
+          return { outcome: "failed", email: null, createdAt: null };
+        }
+      };
+      return attempt(0);
+    },
+    [client, productId]
+  );
+  const canEscalate = hasConversation && !isSharedView;
   return {
     phase,
     catalog,
@@ -1518,6 +1633,8 @@ function useExploreChat(options = {}) {
     clearHistory,
     recordClick,
     submitFeedback,
+    escalate,
+    canEscalate,
     createShareLink,
     isSharedView
   };
@@ -1745,7 +1862,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