@burdenoff/website-sdk 2026.922.5 → 2026.923.2

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
   };