@burdenoff/website-sdk 2026.922.5 → 2026.923.2

package/dist/hooks/index.d.mts

@@ -1,5 +1,5 @@
-export { D as DEFAULT_EXPLORE_EXAMPLE_PROMPTS, E as ExploreChatError, a as ExploreChatErrorKind, b as ExploreChatPhase, F as FALLBACK_EXPLORE_LIMITS, U as UseExploreChatOptions, c as UseExploreChatResult, d as UseSpeechOutputOptions, e as UseSpeechOutputResult, f as classifyExploreError, s as stopSpeaking, u as useExploreChat, g as useProgressiveReveal, h as useSpeechOutput } from '../use-progressive-reveal-Ha3gYPfs.mjs';
-import '../explore-types-DvQPiL1t.mjs';
+export { D as DEFAULT_EXPLORE_EXAMPLE_PROMPTS, E as ExploreChatError, a as ExploreChatErrorKind, b as ExploreChatPhase, c as ExploreEscalateOutcome, d as ExploreEscalateResult, F as FALLBACK_EXPLORE_LIMITS, U as UseExploreChatOptions, e as UseExploreChatResult, f as UseSpeechOutputOptions, g as UseSpeechOutputResult, h as classifyExploreError, s as stopSpeaking, u as useExploreChat, i as useProgressiveReveal, j as useSpeechOutput } from '../use-progressive-reveal-Cmy8bA7L.mjs';
+import '../explore-types-B5sdOC5M.mjs';
 
 interface UseSpeechInputOptions {
     /** Receives settled text as it is recognised. Append it to the draft. */

package/dist/hooks/index.d.ts

@@ -1,5 +1,5 @@
-export { D as DEFAULT_EXPLORE_EXAMPLE_PROMPTS, E as ExploreChatError, a as ExploreChatErrorKind, b as ExploreChatPhase, F as FALLBACK_EXPLORE_LIMITS, U as UseExploreChatOptions, c as UseExploreChatResult, d as UseSpeechOutputOptions, e as UseSpeechOutputResult, f as classifyExploreError, s as stopSpeaking, u as useExploreChat, g as useProgressiveReveal, h as useSpeechOutput } from '../use-progressive-reveal-BfU_IHip.js';
-import '../explore-types-DvQPiL1t.js';
+export { D as DEFAULT_EXPLORE_EXAMPLE_PROMPTS, E as ExploreChatError, a as ExploreChatErrorKind, b as ExploreChatPhase, c as ExploreEscalateOutcome, d as ExploreEscalateResult, F as FALLBACK_EXPLORE_LIMITS, U as UseExploreChatOptions, e as UseExploreChatResult, f as UseSpeechOutputOptions, g as UseSpeechOutputResult, h as classifyExploreError, s as stopSpeaking, u as useExploreChat, i as useProgressiveReveal, j as useSpeechOutput } from '../use-progressive-reveal-DHPGGxZu.js';
+import '../explore-types-B5sdOC5M.js';
 
 interface UseSpeechInputOptions {
     /** Receives settled text as it is recognised. Append it to the draft. */

package/dist/hooks/index.js

@@ -226,6 +226,10 @@ function useWebSDK() {
   }
   return client;
 }
+function useWebSDKConfig() {
+  const client = useWebSDK();
+  return client.getConfig();
+}
 
 // src/components/explore-types.ts
 var EXPLORE_MESSAGE_FIELDS = (
@@ -385,6 +389,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 */
   `
@@ -751,6 +771,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)) {
@@ -917,6 +956,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 = react.useMemo(
@@ -940,6 +980,7 @@ function useExploreChat(options = {}) {
   const pollGenerationRef = react.useRef(0);
   const pollTimerRef = react.useRef(null);
   const conversationTokenRef = react.useRef(null);
+  const [hasConversation, setHasConversation] = react.useState(false);
   const shareTokenRef = react.useRef(void 0);
   if (shareTokenRef.current === void 0) {
     shareTokenRef.current = readShareToken();
@@ -954,6 +995,10 @@ function useExploreChat(options = {}) {
   );
   const inFlightRef = react.useRef(false);
   catalogRef.current = catalog;
+  const rememberConversationToken = react.useCallback((token) => {
+    conversationTokenRef.current = token;
+    setHasConversation(token !== null);
+  }, []);
   const clearPollTimer = react.useCallback(() => {
     if (pollTimerRef.current !== null) {
       clearTimeout(pollTimerRef.current);
@@ -1020,7 +1065,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];
@@ -1036,7 +1081,7 @@ function useExploreChat(options = {}) {
       setTurnCount(turns);
     }
     setHydrated(true);
-  }, [persist, storageKey]);
+  }, [persist, rememberConversationToken, storageKey]);
   react.useEffect(() => {
     if (!persist || !hydrated || typeof window === "undefined") return;
     try {
@@ -1229,7 +1274,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);
@@ -1255,7 +1300,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 = react.useCallback(
     async (message, attachments = []) => {
@@ -1372,7 +1424,7 @@ function useExploreChat(options = {}) {
     );
     cancelPolling();
     inFlightRef.current = false;
-    conversationTokenRef.current = null;
+    rememberConversationToken(null);
     lastSentTextRef.current = null;
     lastSentAttachmentsRef.current = [];
     turnCountRef.current = 0;
@@ -1387,7 +1439,7 @@ function useExploreChat(options = {}) {
       } catch {
       }
     }
-  }, [cancelPolling, storageKey]);
+  }, [cancelPolling, rememberConversationToken, storageKey]);
   const openConversation = react.useCallback(
     (token) => {
       const entry = readArchive(storageKey).find((e) => e.token === token);
@@ -1399,7 +1451,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;
@@ -1411,7 +1463,7 @@ function useExploreChat(options = {}) {
       setPhase(catalogRef.current.enabled ? "ready" : "disabled");
       setArchive(readArchive(storageKey));
     },
-    [cancelPolling, storageKey]
+    [cancelPolling, rememberConversationToken, storageKey]
   );
   const deleteConversation = react.useCallback(
     (token) => {
@@ -1500,6 +1552,69 @@ function useExploreChat(options = {}) {
     },
     [client]
   );
+  const escalate = react.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,
@@ -1520,6 +1635,8 @@ function useExploreChat(options = {}) {
     clearHistory,
     recordClick,
     submitFeedback,
+    escalate,
+    canEscalate,
     createShareLink,
     isSharedView
   };