@burdenoff/website-sdk 2026.1104.1 → 2026.1104.2

package/README.md

@@ -301,6 +301,8 @@ publishes audio, video or data, and it sends the avatar nothing to say.
         manifestVersion: 'hb-en-1', // the version of `suggestedQuestions`
         // Optional: used only where the server checks for bots (see "The bot check is the server's setting").
         turnstileSiteKey: TURNSTILE_SITE_KEY,
+        // Optional, default false: end a session nobody attends to (see "A session nobody attends to").
+        endUnattended: true,
       },
     }}
   />
@@ -442,6 +444,28 @@ publishes audio, video or data, and it sends the avatar nothing to say.
   `text/plain;charset=UTF-8` (which the gateway accepts for this route), and on
   production nothing else is added, so no preflight has to complete while the
   page unloads. The server ends sessions on its own deadlines as well.
+- **A session nobody attends to (opt-in: `live.endUnattended: true`, or
+  `websiteAvatarLive({ …, endUnattended: true })`).** Out of sight (the Chat
+  tab, a hidden page) the answer under way still plays to its end, and then
+  the session ends, with reason `user`, once:
+  - **its answer has played out**: at once. This is the lifecycle rule for
+    every later stage: an idle tail after an answer runs only while the Avatar
+    view is in sight, and going out of sight during one ends the session then.
+    The answer counts as played out 5 s after its speech ends at the source
+    (the room's other voice, the server's speaker, leaves or unpublishes): the
+    server's 3 s tail allowance for the worker's lag, plus 2 s. Today the
+    server ends a session about 3 s after its answer, so its own end comes
+    first and the browser sends nothing.
+  - **the browser holds its sound back** (autoplay refused, or the audio
+    context suspended) once the avatar's voice has arrived: after a 5 s grace,
+    since "Tap to turn on sound" is out of sight. The view then says "The live avatar stopped early." and "The
+    full answer is in Chat.". Back in sight within the grace, the button shows
+    and nothing ends; in sight, a held-back sound never ends a session.
+
+  Unset (the default) or `false`: a session out of sight plays on to the
+  server's planned end. A browser that silences a background page without
+  telling the room (iOS Safari may) cannot be seen; the server's planned end
+  bounds that session either way.
 - **Consent copy is versioned.** The panel shows a consent card only when it
   holds reviewed copy for exactly the version the server names; otherwise the
   view stays as it was. `web-consent-2026-11-02` is product-neutral: its card

package/dist/avatar-live/index.d.mts

@@ -1,5 +1,5 @@
-import { R as ReceiveOnlyJoinOptions, a as ReceiveOnlySession } from '../types-CndbmBK-.mjs';
-export { A as AvatarLiveModule, b as ReceiveOnlyEvent } from '../types-CndbmBK-.mjs';
+import { R as ReceiveOnlyJoinOptions, a as ReceiveOnlySession } from '../types-CXqaLlNB.mjs';
+export { A as AvatarLiveModule, b as ReceiveOnlyEvent } from '../types-CXqaLlNB.mjs';
 
 /**
  * Join the room in `options.url` with the receive-only `options.token`, and play the avatar worker's video and voice

package/dist/avatar-live/index.d.ts

@@ -1,5 +1,5 @@
-import { R as ReceiveOnlyJoinOptions, a as ReceiveOnlySession } from '../types-CndbmBK-.js';
-export { A as AvatarLiveModule, b as ReceiveOnlyEvent } from '../types-CndbmBK-.js';
+import { R as ReceiveOnlyJoinOptions, a as ReceiveOnlySession } from '../types-CXqaLlNB.js';
+export { A as AvatarLiveModule, b as ReceiveOnlyEvent } from '../types-CXqaLlNB.js';
 
 /**
  * Join the room in `options.url` with the receive-only `options.token`, and play the avatar worker's video and voice

package/dist/avatar-live/index.js

@@ -35,15 +35,30 @@ async function joinReceiveOnly(options) {
   });
   let leaving = false;
   const isSpeaker = (participant) => participant.identity === workerIdentity;
+  const voiced = /* @__PURE__ */ new Set();
+  let speechEnded = false;
   const consider = (publication, participant) => {
-    if (leaving || !isSpeaker(participant) || !isMedia(publication)) return;
+    if (leaving) return;
+    if (!isSpeaker(participant)) {
+      if (publication.kind === livekitClient.Track.Kind.Audio) {
+        voiced.add(participant.identity);
+      }
+      return;
+    }
+    if (!isMedia(publication)) return;
     if (!publication.isSubscribed) publication.setSubscribed(true);
   };
+  const voiceGone = (participant) => {
+    if (leaving || speechEnded || !voiced.has(participant.identity)) return;
+    speechEnded = true;
+    onEvent({ type: "speech-ended" });
+  };
   const reportPlayback = () => {
     if (leaving) return;
     onEvent({
       type: "playback-blocked",
-      blocked: !room.canPlaybackAudio || !room.canPlaybackVideo
+      blocked: !room.canPlaybackAudio || !room.canPlaybackVideo,
+      sound: !room.canPlaybackAudio
     });
   };
   room.on(livekitClient.RoomEvent.TrackPublished, consider).on(
@@ -64,9 +79,19 @@ async function joinReceiveOnly(options) {
     }
   ).on(livekitClient.RoomEvent.TrackUnsubscribed, (track) => {
     track.detach();
-  }).on(livekitClient.RoomEvent.ParticipantDisconnected, (participant) => {
-    if (!leaving && isSpeaker(participant)) {
+  }).on(
+    livekitClient.RoomEvent.TrackUnpublished,
+    (publication, participant) => {
+      if (!isSpeaker(participant) && publication.kind === livekitClient.Track.Kind.Audio) {
+        voiceGone(participant);
+      }
+    }
+  ).on(livekitClient.RoomEvent.ParticipantDisconnected, (participant) => {
+    if (leaving) return;
+    if (isSpeaker(participant)) {
       onEvent({ type: "speaker-left" });
+    } else {
+      voiceGone(participant);
     }
   }).on(livekitClient.RoomEvent.AudioPlaybackStatusChanged, reportPlayback).on(livekitClient.RoomEvent.VideoPlaybackStatusChanged, reportPlayback).on(livekitClient.RoomEvent.Disconnected, (reason) => {
     if (leaving) return;

package/dist/avatar-live/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/avatar-live/receive-only.ts"],"names":["DisconnectReason","Track","Room","RoomEvent"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * BOFF-9797. The live avatar's room, joined to watch and listen only.\n *\n * A visitor's browser on a product website holds a subscribe-only room token: it can receive the avatar worker's\n * video and voice and do nothing else. This adapter keeps to that from its side too:\n *\n * - **Nothing is subscribed automatically** (`autoSubscribe: false`). Only the tracks of `workerIdentity`, the avatar\n *   worker the create answer named, are subscribed, and only their video and audio. Any other participant's track\n *   (the server's own speaker included) is never asked for, and is dropped again should the server send it anyway.\n * - **Nothing is published.** No microphone, no camera, no data, no RPC method: this file never calls a publishing\n *   API, and the token would refuse one.\n * - **Safari and iOS** hold sound back until a gesture. The room reports it (`playback-blocked`) and the panel offers\n *   \"Tap to turn on sound\", whose tap calls `enablePlayback`.\n *\n * Written for the website from the media library's public API: nothing here is copied from the product apps.\n */\nimport {\n  DisconnectReason,\n  Room,\n  RoomEvent,\n  Track,\n  type RemoteParticipant,\n  type RemoteTrack,\n  type RemoteTrackPublication,\n} from \"livekit-client\";\n\nimport type { ReceiveOnlyJoinOptions, ReceiveOnlySession } from \"./types\";\n\n/** The reasons a room closes because the server closed it, rather than because the connection was lost. */\nconst CLOSED_BY_SERVER: ReadonlySet<DisconnectReason> = new Set([\n  DisconnectReason.ROOM_DELETED,\n  DisconnectReason.ROOM_CLOSED,\n  DisconnectReason.PARTICIPANT_REMOVED,\n]);\n\nfunction isMedia(publication: RemoteTrackPublication): boolean {\n  return (\n    publication.kind === Track.Kind.Video ||\n    publication.kind === Track.Kind.Audio\n  );\n}\n\n/**\n * Join the room in `options.url` with the receive-only `options.token`, and play the avatar worker's video and voice\n * in `options.video` and `options.audio`. Resolves once connected; rejects when the room cannot be joined (the panel\n * then ends the session).\n */\nexport async function joinReceiveOnly(\n  options: ReceiveOnlyJoinOptions,\n): Promise<ReceiveOnlySession> {\n  const { url, token, workerIdentity, video, audio, onEvent } = options;\n  let parsed: URL;\n  try {\n    parsed = new URL(url);\n  } catch {\n    throw new Error(\"live avatar: the room address is not a URL\");\n  }\n  if (parsed.protocol !== \"wss:\") {\n    throw new Error(\"live avatar: the room address must be wss:\");\n  }\n  if (!token || !workerIdentity) {\n    throw new Error(\"live avatar: the room token or speaker is missing\");\n  }\n\n  const room = new Room({\n    // One small video, always shown while the session lasts: no quality switching, no layer pausing.\n    adaptiveStream: false,\n    dynacast: false,\n    // Closing the tab or leaving the page leaves the room at once. Belt and braces with the panel's own page-hide\n    // handler, which also asks the server to end the session: either may run first, and both are safe to repeat.\n    disconnectOnPageLeave: true,\n  });\n  let leaving = false;\n\n  const isSpeaker = (participant: RemoteParticipant) =>\n    participant.identity === workerIdentity;\n\n  /** Subscribe to `publication` when it is the speaker's video or audio; leave everything else alone. */\n  const consider = (\n    publication: RemoteTrackPublication,\n    participant: RemoteParticipant,\n  ) => {\n    if (leaving || !isSpeaker(participant) || !isMedia(publication)) return;\n    if (!publication.isSubscribed) publication.setSubscribed(true);\n  };\n\n  const reportPlayback = () => {\n    if (leaving) return;\n    onEvent({\n      type: \"playback-blocked\",\n      blocked: !room.canPlaybackAudio || !room.canPlaybackVideo,\n    });\n  };\n\n  room\n    .on(RoomEvent.TrackPublished, consider)\n    .on(\n      RoomEvent.TrackSubscribed,\n      (\n        track: RemoteTrack,\n        publication: RemoteTrackPublication,\n        participant: RemoteParticipant,\n      ) => {\n        if (leaving) return;\n        if (!isSpeaker(participant) || !isMedia(publication)) {\n          // Never asked for: drop it rather than play it.\n          publication.setSubscribed(false);\n          return;\n        }\n        if (track.kind === Track.Kind.Video) {\n          track.attach(video);\n          onEvent({ type: \"speaker-track\", kind: \"video\" });\n        } else {\n          track.attach(audio);\n          onEvent({ type: \"speaker-track\", kind: \"audio\" });\n        }\n      },\n    )\n    .on(RoomEvent.TrackUnsubscribed, (track: RemoteTrack) => {\n      track.detach();\n    })\n    .on(RoomEvent.ParticipantDisconnected, (participant: RemoteParticipant) => {\n      if (!leaving && isSpeaker(participant)) {\n        onEvent({ type: \"speaker-left\" });\n      }\n    })\n    .on(RoomEvent.AudioPlaybackStatusChanged, reportPlayback)\n    .on(RoomEvent.VideoPlaybackStatusChanged, reportPlayback)\n    .on(RoomEvent.Disconnected, (reason?: DisconnectReason) => {\n      if (leaving) return;\n      onEvent({\n        type: \"disconnected\",\n        byServer: reason !== undefined && CLOSED_BY_SERVER.has(reason),\n      });\n    });\n\n  const detachAll = () => {\n    for (const participant of room.remoteParticipants.values()) {\n      for (const publication of participant.trackPublications.values()) {\n        publication.track?.detach();\n      }\n    }\n    video.srcObject = null;\n    audio.srcObject = null;\n  };\n\n  try {\n    await room.connect(url, token, { autoSubscribe: false });\n  } catch (error) {\n    leaving = true;\n    room.removeAllListeners();\n    detachAll();\n    throw error;\n  }\n\n  // Whoever was in the room before this viewer joined: their tracks were published before the listener above.\n  for (const participant of room.remoteParticipants.values()) {\n    for (const publication of participant.trackPublications.values()) {\n      consider(publication, participant);\n    }\n  }\n  reportPlayback();\n\n  return {\n    enablePlayback: async () => {\n      // Both started inside the visitor's gesture, before anything is awaited: Safari allows playback only there.\n      // A refusal leaves the room as it was, and the report below keeps the button offered.\n      await Promise.allSettled([room.startAudio(), room.startVideo()]);\n      reportPlayback();\n    },\n    leave: async () => {\n      if (leaving) return;\n      leaving = true;\n      detachAll();\n      try {\n        await room.disconnect();\n      } finally {\n        room.removeAllListeners();\n      }\n    },\n  };\n}\n"]}
+{"version":3,"sources":["../../src/avatar-live/receive-only.ts"],"names":["DisconnectReason","Track","Room","RoomEvent"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * BOFF-9797. The live avatar's room, joined to watch and listen only.\n *\n * A visitor's browser on a product website holds a subscribe-only room token: it can receive the avatar worker's\n * video and voice and do nothing else. This adapter keeps to that from its side too:\n *\n * - **Nothing is subscribed automatically** (`autoSubscribe: false`). Only the tracks of `workerIdentity`, the avatar\n *   worker the create answer named, are subscribed, and only their video and audio. Any other participant's track\n *   (the server's own speaker included) is never asked for, and is dropped again should the server send it anyway.\n * - **Nothing is published.** No microphone, no camera, no data, no RPC method: this file never calls a publishing\n *   API, and the token would refuse one.\n * - **Safari and iOS** hold sound back until a gesture. The room reports it (`playback-blocked`, with `sound` when the\n *   sound is held back and not only the video) and the panel offers \"Tap to turn on sound\", whose tap calls\n *   `enablePlayback`.\n * - **The end of the speech** is told (`speech-ended`) from what any viewer of the room sees: the other voice in it, the\n *   server's speaker that the worker follows, leaving the room or unpublishing its voice. Its track is never subscribed.\n *\n * Written for the website from the media library's public API: nothing here is copied from the product apps.\n */\nimport {\n  DisconnectReason,\n  Room,\n  RoomEvent,\n  Track,\n  type RemoteParticipant,\n  type RemoteTrack,\n  type RemoteTrackPublication,\n} from \"livekit-client\";\n\nimport type { ReceiveOnlyJoinOptions, ReceiveOnlySession } from \"./types\";\n\n/** The reasons a room closes because the server closed it, rather than because the connection was lost. */\nconst CLOSED_BY_SERVER: ReadonlySet<DisconnectReason> = new Set([\n  DisconnectReason.ROOM_DELETED,\n  DisconnectReason.ROOM_CLOSED,\n  DisconnectReason.PARTICIPANT_REMOVED,\n]);\n\nfunction isMedia(publication: RemoteTrackPublication): boolean {\n  return (\n    publication.kind === Track.Kind.Video ||\n    publication.kind === Track.Kind.Audio\n  );\n}\n\n/**\n * Join the room in `options.url` with the receive-only `options.token`, and play the avatar worker's video and voice\n * in `options.video` and `options.audio`. Resolves once connected; rejects when the room cannot be joined (the panel\n * then ends the session).\n */\nexport async function joinReceiveOnly(\n  options: ReceiveOnlyJoinOptions,\n): Promise<ReceiveOnlySession> {\n  const { url, token, workerIdentity, video, audio, onEvent } = options;\n  let parsed: URL;\n  try {\n    parsed = new URL(url);\n  } catch {\n    throw new Error(\"live avatar: the room address is not a URL\");\n  }\n  if (parsed.protocol !== \"wss:\") {\n    throw new Error(\"live avatar: the room address must be wss:\");\n  }\n  if (!token || !workerIdentity) {\n    throw new Error(\"live avatar: the room token or speaker is missing\");\n  }\n\n  const room = new Room({\n    // One small video, always shown while the session lasts: no quality switching, no layer pausing.\n    adaptiveStream: false,\n    dynacast: false,\n    // Closing the tab or leaving the page leaves the room at once. Belt and braces with the panel's own page-hide\n    // handler, which also asks the server to end the session: either may run first, and both are safe to repeat.\n    disconnectOnPageLeave: true,\n  });\n  let leaving = false;\n\n  const isSpeaker = (participant: RemoteParticipant) =>\n    participant.identity === workerIdentity;\n\n  /**\n   * Everyone else in the room seen publishing a voice: the server's speaker, whose speech the worker voices. Noted\n   * only, never subscribed to, so that the end of that speech can be told (`speech-ended`).\n   */\n  const voiced = new Set<string>();\n  let speechEnded = false;\n\n  /** Subscribe to `publication` when it is the speaker's video or audio; leave everything else alone. */\n  const consider = (\n    publication: RemoteTrackPublication,\n    participant: RemoteParticipant,\n  ) => {\n    if (leaving) return;\n    if (!isSpeaker(participant)) {\n      if (publication.kind === Track.Kind.Audio) {\n        voiced.add(participant.identity);\n      }\n      return;\n    }\n    if (!isMedia(publication)) return;\n    if (!publication.isSubscribed) publication.setSubscribed(true);\n  };\n\n  /** A voice seen published has gone (its track, or its participant): the speech has ended at its source. Once. */\n  const voiceGone = (participant: RemoteParticipant) => {\n    if (leaving || speechEnded || !voiced.has(participant.identity)) return;\n    speechEnded = true;\n    onEvent({ type: \"speech-ended\" });\n  };\n\n  const reportPlayback = () => {\n    if (leaving) return;\n    onEvent({\n      type: \"playback-blocked\",\n      blocked: !room.canPlaybackAudio || !room.canPlaybackVideo,\n      sound: !room.canPlaybackAudio,\n    });\n  };\n\n  room\n    .on(RoomEvent.TrackPublished, consider)\n    .on(\n      RoomEvent.TrackSubscribed,\n      (\n        track: RemoteTrack,\n        publication: RemoteTrackPublication,\n        participant: RemoteParticipant,\n      ) => {\n        if (leaving) return;\n        if (!isSpeaker(participant) || !isMedia(publication)) {\n          // Never asked for: drop it rather than play it.\n          publication.setSubscribed(false);\n          return;\n        }\n        if (track.kind === Track.Kind.Video) {\n          track.attach(video);\n          onEvent({ type: \"speaker-track\", kind: \"video\" });\n        } else {\n          track.attach(audio);\n          onEvent({ type: \"speaker-track\", kind: \"audio\" });\n        }\n      },\n    )\n    .on(RoomEvent.TrackUnsubscribed, (track: RemoteTrack) => {\n      track.detach();\n    })\n    .on(\n      RoomEvent.TrackUnpublished,\n      (publication: RemoteTrackPublication, participant: RemoteParticipant) => {\n        if (!isSpeaker(participant) && publication.kind === Track.Kind.Audio) {\n          voiceGone(participant);\n        }\n      },\n    )\n    .on(RoomEvent.ParticipantDisconnected, (participant: RemoteParticipant) => {\n      if (leaving) return;\n      if (isSpeaker(participant)) {\n        onEvent({ type: \"speaker-left\" });\n      } else {\n        voiceGone(participant);\n      }\n    })\n    .on(RoomEvent.AudioPlaybackStatusChanged, reportPlayback)\n    .on(RoomEvent.VideoPlaybackStatusChanged, reportPlayback)\n    .on(RoomEvent.Disconnected, (reason?: DisconnectReason) => {\n      if (leaving) return;\n      onEvent({\n        type: \"disconnected\",\n        byServer: reason !== undefined && CLOSED_BY_SERVER.has(reason),\n      });\n    });\n\n  const detachAll = () => {\n    for (const participant of room.remoteParticipants.values()) {\n      for (const publication of participant.trackPublications.values()) {\n        publication.track?.detach();\n      }\n    }\n    video.srcObject = null;\n    audio.srcObject = null;\n  };\n\n  try {\n    await room.connect(url, token, { autoSubscribe: false });\n  } catch (error) {\n    leaving = true;\n    room.removeAllListeners();\n    detachAll();\n    throw error;\n  }\n\n  // Whoever was in the room before this viewer joined: their tracks were published before the listener above.\n  for (const participant of room.remoteParticipants.values()) {\n    for (const publication of participant.trackPublications.values()) {\n      consider(publication, participant);\n    }\n  }\n  reportPlayback();\n\n  return {\n    enablePlayback: async () => {\n      // Both started inside the visitor's gesture, before anything is awaited: Safari allows playback only there.\n      // A refusal leaves the room as it was, and the report below keeps the button offered.\n      await Promise.allSettled([room.startAudio(), room.startVideo()]);\n      reportPlayback();\n    },\n    leave: async () => {\n      if (leaving) return;\n      leaving = true;\n      detachAll();\n      try {\n        await room.disconnect();\n      } finally {\n        room.removeAllListeners();\n      }\n    },\n  };\n}\n"]}

package/dist/avatar-live/index.mjs

@@ -33,15 +33,30 @@ async function joinReceiveOnly(options) {
   });
   let leaving = false;
   const isSpeaker = (participant) => participant.identity === workerIdentity;
+  const voiced = /* @__PURE__ */ new Set();
+  let speechEnded = false;
   const consider = (publication, participant) => {
-    if (leaving || !isSpeaker(participant) || !isMedia(publication)) return;
+    if (leaving) return;
+    if (!isSpeaker(participant)) {
+      if (publication.kind === Track.Kind.Audio) {
+        voiced.add(participant.identity);
+      }
+      return;
+    }
+    if (!isMedia(publication)) return;
     if (!publication.isSubscribed) publication.setSubscribed(true);
   };
+  const voiceGone = (participant) => {
+    if (leaving || speechEnded || !voiced.has(participant.identity)) return;
+    speechEnded = true;
+    onEvent({ type: "speech-ended" });
+  };
   const reportPlayback = () => {
     if (leaving) return;
     onEvent({
       type: "playback-blocked",
-      blocked: !room.canPlaybackAudio || !room.canPlaybackVideo
+      blocked: !room.canPlaybackAudio || !room.canPlaybackVideo,
+      sound: !room.canPlaybackAudio
     });
   };
   room.on(RoomEvent.TrackPublished, consider).on(
@@ -62,9 +77,19 @@ async function joinReceiveOnly(options) {
     }
   ).on(RoomEvent.TrackUnsubscribed, (track) => {
     track.detach();
-  }).on(RoomEvent.ParticipantDisconnected, (participant) => {
-    if (!leaving && isSpeaker(participant)) {
+  }).on(
+    RoomEvent.TrackUnpublished,
+    (publication, participant) => {
+      if (!isSpeaker(participant) && publication.kind === Track.Kind.Audio) {
+        voiceGone(participant);
+      }
+    }
+  ).on(RoomEvent.ParticipantDisconnected, (participant) => {
+    if (leaving) return;
+    if (isSpeaker(participant)) {
       onEvent({ type: "speaker-left" });
+    } else {
+      voiceGone(participant);
     }
   }).on(RoomEvent.AudioPlaybackStatusChanged, reportPlayback).on(RoomEvent.VideoPlaybackStatusChanged, reportPlayback).on(RoomEvent.Disconnected, (reason) => {
     if (leaving) return;

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/avatar-live/receive-only.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * BOFF-9797. The live avatar's room, joined to watch and listen only.\n *\n * A visitor's browser on a product website holds a subscribe-only room token: it can receive the avatar worker's\n * video and voice and do nothing else. This adapter keeps to that from its side too:\n *\n * - **Nothing is subscribed automatically** (`autoSubscribe: false`). Only the tracks of `workerIdentity`, the avatar\n *   worker the create answer named, are subscribed, and only their video and audio. Any other participant's track\n *   (the server's own speaker included) is never asked for, and is dropped again should the server send it anyway.\n * - **Nothing is published.** No microphone, no camera, no data, no RPC method: this file never calls a publishing\n *   API, and the token would refuse one.\n * - **Safari and iOS** hold sound back until a gesture. The room reports it (`playback-blocked`) and the panel offers\n *   \"Tap to turn on sound\", whose tap calls `enablePlayback`.\n *\n * Written for the website from the media library's public API: nothing here is copied from the product apps.\n */\nimport {\n  DisconnectReason,\n  Room,\n  RoomEvent,\n  Track,\n  type RemoteParticipant,\n  type RemoteTrack,\n  type RemoteTrackPublication,\n} from \"livekit-client\";\n\nimport type { ReceiveOnlyJoinOptions, ReceiveOnlySession } from \"./types\";\n\n/** The reasons a room closes because the server closed it, rather than because the connection was lost. */\nconst CLOSED_BY_SERVER: ReadonlySet<DisconnectReason> = new Set([\n  DisconnectReason.ROOM_DELETED,\n  DisconnectReason.ROOM_CLOSED,\n  DisconnectReason.PARTICIPANT_REMOVED,\n]);\n\nfunction isMedia(publication: RemoteTrackPublication): boolean {\n  return (\n    publication.kind === Track.Kind.Video ||\n    publication.kind === Track.Kind.Audio\n  );\n}\n\n/**\n * Join the room in `options.url` with the receive-only `options.token`, and play the avatar worker's video and voice\n * in `options.video` and `options.audio`. Resolves once connected; rejects when the room cannot be joined (the panel\n * then ends the session).\n */\nexport async function joinReceiveOnly(\n  options: ReceiveOnlyJoinOptions,\n): Promise<ReceiveOnlySession> {\n  const { url, token, workerIdentity, video, audio, onEvent } = options;\n  let parsed: URL;\n  try {\n    parsed = new URL(url);\n  } catch {\n    throw new Error(\"live avatar: the room address is not a URL\");\n  }\n  if (parsed.protocol !== \"wss:\") {\n    throw new Error(\"live avatar: the room address must be wss:\");\n  }\n  if (!token || !workerIdentity) {\n    throw new Error(\"live avatar: the room token or speaker is missing\");\n  }\n\n  const room = new Room({\n    // One small video, always shown while the session lasts: no quality switching, no layer pausing.\n    adaptiveStream: false,\n    dynacast: false,\n    // Closing the tab or leaving the page leaves the room at once. Belt and braces with the panel's own page-hide\n    // handler, which also asks the server to end the session: either may run first, and both are safe to repeat.\n    disconnectOnPageLeave: true,\n  });\n  let leaving = false;\n\n  const isSpeaker = (participant: RemoteParticipant) =>\n    participant.identity === workerIdentity;\n\n  /** Subscribe to `publication` when it is the speaker's video or audio; leave everything else alone. */\n  const consider = (\n    publication: RemoteTrackPublication,\n    participant: RemoteParticipant,\n  ) => {\n    if (leaving || !isSpeaker(participant) || !isMedia(publication)) return;\n    if (!publication.isSubscribed) publication.setSubscribed(true);\n  };\n\n  const reportPlayback = () => {\n    if (leaving) return;\n    onEvent({\n      type: \"playback-blocked\",\n      blocked: !room.canPlaybackAudio || !room.canPlaybackVideo,\n    });\n  };\n\n  room\n    .on(RoomEvent.TrackPublished, consider)\n    .on(\n      RoomEvent.TrackSubscribed,\n      (\n        track: RemoteTrack,\n        publication: RemoteTrackPublication,\n        participant: RemoteParticipant,\n      ) => {\n        if (leaving) return;\n        if (!isSpeaker(participant) || !isMedia(publication)) {\n          // Never asked for: drop it rather than play it.\n          publication.setSubscribed(false);\n          return;\n        }\n        if (track.kind === Track.Kind.Video) {\n          track.attach(video);\n          onEvent({ type: \"speaker-track\", kind: \"video\" });\n        } else {\n          track.attach(audio);\n          onEvent({ type: \"speaker-track\", kind: \"audio\" });\n        }\n      },\n    )\n    .on(RoomEvent.TrackUnsubscribed, (track: RemoteTrack) => {\n      track.detach();\n    })\n    .on(RoomEvent.ParticipantDisconnected, (participant: RemoteParticipant) => {\n      if (!leaving && isSpeaker(participant)) {\n        onEvent({ type: \"speaker-left\" });\n      }\n    })\n    .on(RoomEvent.AudioPlaybackStatusChanged, reportPlayback)\n    .on(RoomEvent.VideoPlaybackStatusChanged, reportPlayback)\n    .on(RoomEvent.Disconnected, (reason?: DisconnectReason) => {\n      if (leaving) return;\n      onEvent({\n        type: \"disconnected\",\n        byServer: reason !== undefined && CLOSED_BY_SERVER.has(reason),\n      });\n    });\n\n  const detachAll = () => {\n    for (const participant of room.remoteParticipants.values()) {\n      for (const publication of participant.trackPublications.values()) {\n        publication.track?.detach();\n      }\n    }\n    video.srcObject = null;\n    audio.srcObject = null;\n  };\n\n  try {\n    await room.connect(url, token, { autoSubscribe: false });\n  } catch (error) {\n    leaving = true;\n    room.removeAllListeners();\n    detachAll();\n    throw error;\n  }\n\n  // Whoever was in the room before this viewer joined: their tracks were published before the listener above.\n  for (const participant of room.remoteParticipants.values()) {\n    for (const publication of participant.trackPublications.values()) {\n      consider(publication, participant);\n    }\n  }\n  reportPlayback();\n\n  return {\n    enablePlayback: async () => {\n      // Both started inside the visitor's gesture, before anything is awaited: Safari allows playback only there.\n      // A refusal leaves the room as it was, and the report below keeps the button offered.\n      await Promise.allSettled([room.startAudio(), room.startVideo()]);\n      reportPlayback();\n    },\n    leave: async () => {\n      if (leaving) return;\n      leaving = true;\n      detachAll();\n      try {\n        await room.disconnect();\n      } finally {\n        room.removeAllListeners();\n      }\n    },\n  };\n}\n"]}
+{"version":3,"sources":["../../src/avatar-live/receive-only.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * BOFF-9797. The live avatar's room, joined to watch and listen only.\n *\n * A visitor's browser on a product website holds a subscribe-only room token: it can receive the avatar worker's\n * video and voice and do nothing else. This adapter keeps to that from its side too:\n *\n * - **Nothing is subscribed automatically** (`autoSubscribe: false`). Only the tracks of `workerIdentity`, the avatar\n *   worker the create answer named, are subscribed, and only their video and audio. Any other participant's track\n *   (the server's own speaker included) is never asked for, and is dropped again should the server send it anyway.\n * - **Nothing is published.** No microphone, no camera, no data, no RPC method: this file never calls a publishing\n *   API, and the token would refuse one.\n * - **Safari and iOS** hold sound back until a gesture. The room reports it (`playback-blocked`, with `sound` when the\n *   sound is held back and not only the video) and the panel offers \"Tap to turn on sound\", whose tap calls\n *   `enablePlayback`.\n * - **The end of the speech** is told (`speech-ended`) from what any viewer of the room sees: the other voice in it, the\n *   server's speaker that the worker follows, leaving the room or unpublishing its voice. Its track is never subscribed.\n *\n * Written for the website from the media library's public API: nothing here is copied from the product apps.\n */\nimport {\n  DisconnectReason,\n  Room,\n  RoomEvent,\n  Track,\n  type RemoteParticipant,\n  type RemoteTrack,\n  type RemoteTrackPublication,\n} from \"livekit-client\";\n\nimport type { ReceiveOnlyJoinOptions, ReceiveOnlySession } from \"./types\";\n\n/** The reasons a room closes because the server closed it, rather than because the connection was lost. */\nconst CLOSED_BY_SERVER: ReadonlySet<DisconnectReason> = new Set([\n  DisconnectReason.ROOM_DELETED,\n  DisconnectReason.ROOM_CLOSED,\n  DisconnectReason.PARTICIPANT_REMOVED,\n]);\n\nfunction isMedia(publication: RemoteTrackPublication): boolean {\n  return (\n    publication.kind === Track.Kind.Video ||\n    publication.kind === Track.Kind.Audio\n  );\n}\n\n/**\n * Join the room in `options.url` with the receive-only `options.token`, and play the avatar worker's video and voice\n * in `options.video` and `options.audio`. Resolves once connected; rejects when the room cannot be joined (the panel\n * then ends the session).\n */\nexport async function joinReceiveOnly(\n  options: ReceiveOnlyJoinOptions,\n): Promise<ReceiveOnlySession> {\n  const { url, token, workerIdentity, video, audio, onEvent } = options;\n  let parsed: URL;\n  try {\n    parsed = new URL(url);\n  } catch {\n    throw new Error(\"live avatar: the room address is not a URL\");\n  }\n  if (parsed.protocol !== \"wss:\") {\n    throw new Error(\"live avatar: the room address must be wss:\");\n  }\n  if (!token || !workerIdentity) {\n    throw new Error(\"live avatar: the room token or speaker is missing\");\n  }\n\n  const room = new Room({\n    // One small video, always shown while the session lasts: no quality switching, no layer pausing.\n    adaptiveStream: false,\n    dynacast: false,\n    // Closing the tab or leaving the page leaves the room at once. Belt and braces with the panel's own page-hide\n    // handler, which also asks the server to end the session: either may run first, and both are safe to repeat.\n    disconnectOnPageLeave: true,\n  });\n  let leaving = false;\n\n  const isSpeaker = (participant: RemoteParticipant) =>\n    participant.identity === workerIdentity;\n\n  /**\n   * Everyone else in the room seen publishing a voice: the server's speaker, whose speech the worker voices. Noted\n   * only, never subscribed to, so that the end of that speech can be told (`speech-ended`).\n   */\n  const voiced = new Set<string>();\n  let speechEnded = false;\n\n  /** Subscribe to `publication` when it is the speaker's video or audio; leave everything else alone. */\n  const consider = (\n    publication: RemoteTrackPublication,\n    participant: RemoteParticipant,\n  ) => {\n    if (leaving) return;\n    if (!isSpeaker(participant)) {\n      if (publication.kind === Track.Kind.Audio) {\n        voiced.add(participant.identity);\n      }\n      return;\n    }\n    if (!isMedia(publication)) return;\n    if (!publication.isSubscribed) publication.setSubscribed(true);\n  };\n\n  /** A voice seen published has gone (its track, or its participant): the speech has ended at its source. Once. */\n  const voiceGone = (participant: RemoteParticipant) => {\n    if (leaving || speechEnded || !voiced.has(participant.identity)) return;\n    speechEnded = true;\n    onEvent({ type: \"speech-ended\" });\n  };\n\n  const reportPlayback = () => {\n    if (leaving) return;\n    onEvent({\n      type: \"playback-blocked\",\n      blocked: !room.canPlaybackAudio || !room.canPlaybackVideo,\n      sound: !room.canPlaybackAudio,\n    });\n  };\n\n  room\n    .on(RoomEvent.TrackPublished, consider)\n    .on(\n      RoomEvent.TrackSubscribed,\n      (\n        track: RemoteTrack,\n        publication: RemoteTrackPublication,\n        participant: RemoteParticipant,\n      ) => {\n        if (leaving) return;\n        if (!isSpeaker(participant) || !isMedia(publication)) {\n          // Never asked for: drop it rather than play it.\n          publication.setSubscribed(false);\n          return;\n        }\n        if (track.kind === Track.Kind.Video) {\n          track.attach(video);\n          onEvent({ type: \"speaker-track\", kind: \"video\" });\n        } else {\n          track.attach(audio);\n          onEvent({ type: \"speaker-track\", kind: \"audio\" });\n        }\n      },\n    )\n    .on(RoomEvent.TrackUnsubscribed, (track: RemoteTrack) => {\n      track.detach();\n    })\n    .on(\n      RoomEvent.TrackUnpublished,\n      (publication: RemoteTrackPublication, participant: RemoteParticipant) => {\n        if (!isSpeaker(participant) && publication.kind === Track.Kind.Audio) {\n          voiceGone(participant);\n        }\n      },\n    )\n    .on(RoomEvent.ParticipantDisconnected, (participant: RemoteParticipant) => {\n      if (leaving) return;\n      if (isSpeaker(participant)) {\n        onEvent({ type: \"speaker-left\" });\n      } else {\n        voiceGone(participant);\n      }\n    })\n    .on(RoomEvent.AudioPlaybackStatusChanged, reportPlayback)\n    .on(RoomEvent.VideoPlaybackStatusChanged, reportPlayback)\n    .on(RoomEvent.Disconnected, (reason?: DisconnectReason) => {\n      if (leaving) return;\n      onEvent({\n        type: \"disconnected\",\n        byServer: reason !== undefined && CLOSED_BY_SERVER.has(reason),\n      });\n    });\n\n  const detachAll = () => {\n    for (const participant of room.remoteParticipants.values()) {\n      for (const publication of participant.trackPublications.values()) {\n        publication.track?.detach();\n      }\n    }\n    video.srcObject = null;\n    audio.srcObject = null;\n  };\n\n  try {\n    await room.connect(url, token, { autoSubscribe: false });\n  } catch (error) {\n    leaving = true;\n    room.removeAllListeners();\n    detachAll();\n    throw error;\n  }\n\n  // Whoever was in the room before this viewer joined: their tracks were published before the listener above.\n  for (const participant of room.remoteParticipants.values()) {\n    for (const publication of participant.trackPublications.values()) {\n      consider(publication, participant);\n    }\n  }\n  reportPlayback();\n\n  return {\n    enablePlayback: async () => {\n      // Both started inside the visitor's gesture, before anything is awaited: Safari allows playback only there.\n      // A refusal leaves the room as it was, and the report below keeps the button offered.\n      await Promise.allSettled([room.startAudio(), room.startVideo()]);\n      reportPlayback();\n    },\n    leave: async () => {\n      if (leaving) return;\n      leaving = true;\n      detachAll();\n      try {\n        await room.disconnect();\n      } finally {\n        room.removeAllListeners();\n      }\n    },\n  };\n}\n"]}

package/dist/avatar-live-view/index.d.mts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { E as ExplorePanelAvatarLive, a as ExploreLocale, A as AvatarConversation } from '../explore-avatar-live-config-N4WhJzgS.mjs';
-import '../types-CndbmBK-.mjs';
+import { E as ExplorePanelAvatarLive, a as ExploreLocale, A as AvatarConversation } from '../explore-avatar-live-config-B6_p0q1c.mjs';
+import '../types-CXqaLlNB.mjs';
 import '../use-explore-chat-CbfohA9O.mjs';
 import '../explore-types-Ol1Mm3dW.mjs';
 

package/dist/avatar-live-view/index.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { E as ExplorePanelAvatarLive, a as ExploreLocale, A as AvatarConversation } from '../explore-avatar-live-config-CAfN5eAX.js';
-import '../types-CndbmBK-.js';
+import { E as ExplorePanelAvatarLive, a as ExploreLocale, A as AvatarConversation } from '../explore-avatar-live-config-DRpS-mqQ.js';
+import '../types-CXqaLlNB.js';
 import '../use-explore-chat-B3dOOvJN.js';
 import '../explore-types-Ol1Mm3dW.js';
 

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

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk7O2I32ZN_js = require('../chunk-7O2I32ZN.js');
+var chunkWSEQ2I6I_js = require('../chunk-WSEQ2I6I.js');
 var chunkO4GS3XPZ_js = require('../chunk-O4GS3XPZ.js');
 var chunkC6OJIHNO_js = require('../chunk-C6OJIHNO.js');
 require('../chunk-ZSTFX7FV.js');
@@ -68,7 +68,7 @@ function readAvailability(status, body) {
     const { consentVersion, maxSessionSeconds } = body;
     const botCheck = readBotCheck(body.botCheck);
     const questions = readQuestions(body.questions);
-    if (available !== true || typeof consentVersion !== "string" || !chunk7O2I32ZN_js.isAvatarVersion(consentVersion) || typeof maxSessionSeconds !== "number" || !Number.isInteger(maxSessionSeconds) || maxSessionSeconds < 1 || botCheck === null || questions === null) {
+    if (available !== true || typeof consentVersion !== "string" || !chunkWSEQ2I6I_js.isAvatarVersion(consentVersion) || typeof maxSessionSeconds !== "number" || !Number.isInteger(maxSessionSeconds) || maxSessionSeconds < 1 || botCheck === null || questions === null) {
       return INERT;
     }
     return {
@@ -160,7 +160,7 @@ function deadline(timeoutMs, outer) {
   };
 }
 async function requestAvailability(target) {
-  if (!chunk7O2I32ZN_js.isAvatarSite(target.site) || !LOCALE.test(target.locale)) return INERT;
+  if (!chunkWSEQ2I6I_js.isAvatarSite(target.site) || !LOCALE.test(target.locale)) return INERT;
   const query = new URLSearchParams({
     site: target.site,
     locale: target.locale
@@ -737,7 +737,7 @@ var CONSENT = /* @__PURE__ */ new Map([
   ]
 ]);
 function avatarConsentCopy(version, locale) {
-  if (!chunk7O2I32ZN_js.isAvatarLiveLocaleReviewed(locale)) return null;
+  if (!chunkWSEQ2I6I_js.isAvatarLiveLocaleReviewed(locale)) return null;
   return CONSENT.get(version)?.[locale] ?? null;
 }
 
@@ -859,6 +859,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;
@@ -868,6 +870,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",
@@ -1151,6 +1159,7 @@ function AvatarLiveView({
       const handle = sessionRef.current;
       if (!handle || handle.done) return;
       handle.done = true;
+      stopAttending(handle);
       sessionRef.current = null;
       if (reason !== null) {
         sendEnd({
@@ -1180,6 +1189,33 @@ function AvatarLiveView({
     }
     go({ name: "live", session: current.session });
   }, [go]);
+  const attend = react.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 = react.useCallback((reason) => {
     const run = startRef.current;
     if (!run) return;
@@ -1207,7 +1243,7 @@ function AvatarLiveView({
         go(INERT2);
         return;
       }
-      if (result.offer.botCheck === "turnstile" && chunk7O2I32ZN_js.turnstileSiteKeyOf(live2) === null) {
+      if (result.offer.botCheck === "turnstile" && chunkWSEQ2I6I_js.turnstileSiteKeyOf(live2) === null) {
         setMode("suggested");
         go(INERT2);
         return;
@@ -1256,6 +1292,11 @@ function AvatarLiveView({
         joined: null,
         endsAt,
         speakerArrived: false,
+        voiceArrived: false,
+        soundHeld: false,
+        playedOut: false,
+        unheard: null,
+        tail: null,
         done: false
       };
       setBlocked(false);
@@ -1335,7 +1376,7 @@ function AvatarLiveView({
         return;
       }
       const refusedFrom = exchangeAtStart.offerUntil - ANSWER_OFFER_MS + SERVICE_MAX_AGE_MS;
-      const siteKey = offer.botCheck === "turnstile" ? chunk7O2I32ZN_js.turnstileSiteKeyOf(live2) : null;
+      const siteKey = offer.botCheck === "turnstile" ? chunkWSEQ2I6I_js.turnstileSiteKeyOf(live2) : null;
       if (offer.botCheck === "turnstile" && (siteKey === null || !canBindBotCheck())) {
         go(INERT2);
         return;
@@ -1581,6 +1622,9 @@ function AvatarLiveView({
       check();
     }
   }, [showing, behindChat, check, leave, offeredNow]);
+  react.useEffect(() => {
+    attend();
+  }, [showing, attend]);
   react.useEffect(() => {
     if (askedLocale.current === locale) return;
     askedLocale.current = locale;
@@ -1667,12 +1711,29 @@ function AvatarLiveView({
       const wasLive = phaseRef.current.name === "live";
       switch (event.type) {
         case "speaker-track":
-          if (event.kind !== "video") return;
+          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(
@@ -1686,7 +1747,7 @@ function AvatarLiveView({
           return;
       }
     },
-    [finish, goLive, inSight]
+    [attend, finish, goLive, inSight]
   );
   react.useEffect(() => {
     if (phase.name !== "pending") return;
@@ -1773,10 +1834,12 @@ function AvatarLiveView({
     const onVisibility = () => {
       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);
@@ -1784,7 +1847,7 @@ function AvatarLiveView({
       window.removeEventListener("pagehide", onPageHide);
       document.removeEventListener("visibilitychange", onVisibility);
     };
-  }, [leave]);
+  }, [attend, leave]);
   react.useEffect(
     () => () => {
       const controller = checkRef.current;
@@ -1803,6 +1866,7 @@ function AvatarLiveView({
       sessionRef.current = null;
       if (handle && !handle.done) {
         handle.done = true;
+        stopAttending(handle);
         sendEnd({
           base: handle.base,
           headers: handle.headers,