@burdenoff/website-sdk 2026.1102.3 → 2026.1104.2

package/dist/avatar-live-view/index.mjs

@@ -1,4 +1,4 @@
-import { turnstileSiteKeyOf, isAvatarLiveLocaleReviewed, isAvatarSite, isAvatarVersion } from '../chunk-K3QZGJEH.mjs';
+import { turnstileSiteKeyOf, isAvatarLiveLocaleReviewed, isAvatarSite, isAvatarVersion } from '../chunk-7MSB3EUI.mjs';
 import { fill } from '../chunk-TT3MHN42.mjs';
 import { cn } from '../chunk-R7G6TWIS.mjs';
 import '../chunk-VNS5WDWO.mjs';
@@ -857,6 +857,8 @@ var PRIVACY_HREF = "/privacy#live-avatar";
 var SPEAKER_WAIT_MS = 3e4;
 var END_GRACE_MS = 1e4;
 var CLOCK_TOLERANCE_MS = 5e3;
+var UNHEARD_GRACE_MS = 5e3;
+var PLAYOUT_TAIL_MS = 5e3;
 var SERVICE_MAX_AGE_MS = 15 * 6e4;
 var ANSWER_OFFER_MS = SERVICE_MAX_AGE_MS - 6e4;
 var MAX_TIMER_MS = 2147483647;
@@ -866,6 +868,12 @@ var USED_ON_KEY = "boff.explore.avatarUsedOn";
 var PRIMARY = '[data-avatar-primary], [data-boff-explore="panel-continue-chat"]';
 var IDLE = { name: "idle" };
 var INERT2 = { name: "inert" };
+function stopAttending(handle) {
+  if (handle.unheard !== null) clearTimeout(handle.unheard);
+  if (handle.tail !== null) clearTimeout(handle.tail);
+  handle.unheard = null;
+  handle.tail = null;
+}
 var REFUSAL_TEXT = {
   busy: "busy",
   limits: "limits",
@@ -1024,11 +1032,13 @@ function clock(seconds) {
 function AvatarLiveView({
   live,
   active,
+  open,
   locale,
   productName,
   still,
   fallback,
   onContinueInChat,
+  onVoiceHold,
   continueInChat,
   newChat,
   send,
@@ -1076,9 +1086,19 @@ function AvatarLiveView({
   const askMaxLength = chatMaxLength !== void 0 && Number.isFinite(chatMaxLength) && chatMaxLength >= 1 ? Math.min(ASK_MAX_LENGTH, Math.floor(chatMaxLength)) : ASK_MAX_LENGTH;
   const [note, setNote] = useState(null);
   const [usedToday, setUsedToday] = useState(false);
+  const showing = active && !off;
+  const behindChat = open && !active && !off;
   const phaseRef = useRef(IDLE);
-  const latest = useRef({ live, locale, base, headers, off, currentPath });
-  latest.current = { live, locale, base, headers, off, currentPath };
+  const latest = useRef({
+    live,
+    locale,
+    base,
+    headers,
+    off,
+    currentPath,
+    showing
+  });
+  latest.current = { live, locale, base, headers, off, currentPath, showing };
   const conversationRef = useRef(conversation);
   conversationRef.current = conversation;
   const waitRef = useRef(null);
@@ -1097,6 +1117,10 @@ function AvatarLiveView({
     phaseRef.current = next;
     setPhase(next);
   }, []);
+  const inSight = useCallback(
+    () => latest.current.showing && (typeof document === "undefined" || document.visibilityState !== "hidden"),
+    []
+  );
   const setMode = useCallback((next) => {
     questionsRef.current = next;
     setQuestions(next);
@@ -1133,6 +1157,7 @@ function AvatarLiveView({
       const handle = sessionRef.current;
       if (!handle || handle.done) return;
       handle.done = true;
+      stopAttending(handle);
       sessionRef.current = null;
       if (reason !== null) {
         sendEnd({
@@ -1151,6 +1176,44 @@ function AvatarLiveView({
     },
     [go]
   );
+  const goLive = useCallback(() => {
+    const current = phaseRef.current;
+    const handle = sessionRef.current;
+    if (current.name !== "pending" || !handle) return;
+    handle.speakerArrived = true;
+    if (questionsRef.current === "any") {
+      noteUsedToday();
+      setUsedToday(true);
+    }
+    go({ name: "live", session: current.session });
+  }, [go]);
+  const attend = useCallback(() => {
+    const handle = sessionRef.current;
+    if (!handle || handle.done || latest.current.live.endUnattended !== true) {
+      return;
+    }
+    const current = phaseRef.current.name;
+    if (current !== "pending" && current !== "live") return;
+    const away = !inSight();
+    if (away && handle.playedOut && current === "live") {
+      finish("finished", "user");
+      return;
+    }
+    if (!(away && handle.soundHeld && handle.voiceArrived)) {
+      if (handle.unheard !== null) {
+        clearTimeout(handle.unheard);
+        handle.unheard = null;
+      }
+      return;
+    }
+    if (handle.unheard !== null) return;
+    handle.unheard = setTimeout(() => {
+      handle.unheard = null;
+      if (sessionRef.current === handle && !handle.done && latest.current.live.endUnattended === true && handle.soundHeld && handle.voiceArrived && !inSight()) {
+        finish("interrupted", "user");
+      }
+    }, UNHEARD_GRACE_MS);
+  }, [finish, inSight]);
   const cancelStart = useCallback((reason) => {
     const run = startRef.current;
     if (!run) return;
@@ -1227,6 +1290,11 @@ function AvatarLiveView({
         joined: null,
         endsAt,
         speakerArrived: false,
+        voiceArrived: false,
+        soundHeld: false,
+        playedOut: false,
+        unheard: null,
+        tail: null,
         done: false
       };
       setBlocked(false);
@@ -1487,9 +1555,11 @@ function AvatarLiveView({
     }
   }, [cancelStart, cancelWaiting, finish, go, reoffer]);
   const leave = useCallback(
-    (reason) => {
+    (event) => {
       const current = phaseRef.current;
+      const reason = event === "user" || event === "chat" ? "user" : "page_hide";
       const how = reason === "user" ? "stopped" : "interrupted";
+      const keepsSession = event === "chat" || event === "hidden";
       switch (current.name) {
         case "checking": {
           if (reason !== "user") return;
@@ -1507,26 +1577,36 @@ function AvatarLiveView({
           go(reason === "user" ? IDLE : reoffer(current.offer));
           return;
         case "creating":
+          if (keepsSession) return;
           cancelStart(reason);
           go({ name: "ended", how });
           return;
         case "pending":
         case "live":
+          if (keepsSession) {
+            if (current.name === "pending" && sessionRef.current?.speakerArrived) {
+              goLive();
+            }
+            return;
+          }
           finish(how, reason);
           return;
         default:
           return;
       }
     },
-    [cancelStart, cancelWaiting, finish, go, reoffer]
+    [cancelStart, cancelWaiting, finish, go, goLive, reoffer]
   );
-  const showing = active && !off;
   useEffect(() => {
     if (!showing) {
-      leave("user");
+      leave(behindChat ? "chat" : "user");
       return;
     }
     const current = phaseRef.current;
+    if (current.name === "creating" || current.name === "pending" || current.name === "live") {
+      setNow(Date.now());
+      return;
+    }
     const offered = offeredNow();
     const used = offered !== null && claimedRef.current.has(offered);
     if (current.name === "ended" && used) return;
@@ -1539,7 +1619,10 @@ function AvatarLiveView({
     current.name === "checking" && checkRef.current === null) {
       check();
     }
-  }, [showing, check, leave, offeredNow]);
+  }, [showing, behindChat, check, leave, offeredNow]);
+  useEffect(() => {
+    attend();
+  }, [showing, attend]);
   useEffect(() => {
     if (askedLocale.current === locale) return;
     askedLocale.current = locale;
@@ -1626,10 +1709,29 @@ function AvatarLiveView({
       const wasLive = phaseRef.current.name === "live";
       switch (event.type) {
         case "speaker-track":
-          if (event.kind === "video") handle.speakerArrived = true;
+          if (event.kind !== "video") {
+            handle.voiceArrived = true;
+            attend();
+            return;
+          }
+          handle.speakerArrived = true;
+          if (!inSight()) goLive();
           return;
         case "playback-blocked":
           setBlocked(event.blocked);
+          handle.soundHeld = event.sound ?? event.blocked;
+          attend();
+          return;
+        case "speech-ended":
+          if (latest.current.live.endUnattended !== true || handle.tail !== null || handle.playedOut) {
+            return;
+          }
+          handle.tail = setTimeout(() => {
+            handle.tail = null;
+            if (sessionRef.current !== handle || handle.done) return;
+            handle.playedOut = true;
+            attend();
+          }, PLAYOUT_TAIL_MS);
           return;
         case "speaker-left":
           finish(
@@ -1643,7 +1745,7 @@ function AvatarLiveView({
           return;
       }
     },
-    [finish]
+    [attend, finish, goLive, inSight]
   );
   useEffect(() => {
     if (phase.name !== "pending") return;
@@ -1717,11 +1819,25 @@ function AvatarLiveView({
     const timer = setInterval(() => setNow(Date.now()), 1e3);
     return () => clearInterval(timer);
   }, [ticking]);
+  const voiceLine = phase.name === "live" ? S.speaking : phase.name === "creating" || phase.name === "pending" ? S.connecting : null;
+  const onVoiceHoldRef = useRef(onVoiceHold);
+  onVoiceHoldRef.current = onVoiceHold;
+  useEffect(() => {
+    onVoiceHoldRef.current?.(voiceLine);
+  }, [voiceLine]);
+  useEffect(() => () => onVoiceHoldRef.current?.(null), []);
   useEffect(() => {
     if (typeof window === "undefined") return;
     const onPageHide = () => leave("page_hide");
     const onVisibility = () => {
-      if (document.visibilityState === "hidden") leave("page_hide");
+      if (document.visibilityState === "hidden") {
+        leave("hidden");
+        attend();
+        return;
+      }
+      const current = phaseRef.current.name;
+      if (current === "pending" || current === "live") setNow(Date.now());
+      attend();
     };
     window.addEventListener("pagehide", onPageHide);
     document.addEventListener("visibilitychange", onVisibility);
@@ -1729,7 +1845,7 @@ function AvatarLiveView({
       window.removeEventListener("pagehide", onPageHide);
       document.removeEventListener("visibilitychange", onVisibility);
     };
-  }, [leave]);
+  }, [attend, leave]);
   useEffect(
     () => () => {
       const controller = checkRef.current;
@@ -1748,6 +1864,7 @@ function AvatarLiveView({
       sessionRef.current = null;
       if (handle && !handle.done) {
         handle.done = true;
+        stopAttending(handle);
         sendEnd({
           base: handle.base,
           headers: handle.headers,
@@ -1827,17 +1944,7 @@ function AvatarLiveView({
     if (focused && focused !== document.body && focused.isConnected) return;
     rootRef.current?.querySelector(PRIMARY)?.focus();
   }, [active, phase.name, askState, shown.pendingAnswerId, blocked]);
-  const onPlaying = useCallback(() => {
-    const current = phaseRef.current;
-    const handle = sessionRef.current;
-    if (current.name !== "pending" || !handle) return;
-    handle.speakerArrived = true;
-    if (questionsRef.current === "any") {
-      noteUsedToday();
-      setUsedToday(true);
-    }
-    go({ name: "live", session: current.session });
-  }, [go]);
+  const onPlaying = goLive;
   const enablePlayback = useCallback(() => {
     void sessionRef.current?.joined?.enablePlayback().catch(() => void 0);
   }, []);