@burdenoff/website-sdk 2026.1028.1 → 2026.1029.1

package/README.md

@@ -243,6 +243,162 @@ a product-scoped panel still share one conversation. Without a `productSlug`,
 development build logs a warning). The default, `scope="portfolio"`, renders
 exactly what it always has.
 
+#### Live avatar (opt-in, receive-only)
+
+The site-wide `ExplorePanel`'s Avatar view shows the avatar's picture, "Live
+avatar coming soon" and "Continue in Chat". A site can opt in to a live avatar
+there instead: an AI avatar that reads the conversation's first answer aloud,
+which the visitor watches and listens to. Their browser only receives: it never
+publishes audio, video or data, and it sends the avatar nothing to say.
+
+```tsx
+<ExploreChatProvider enabled={started} productSlug="healthybowl" shareToken={shareToken}>
+  <ExplorePanel
+    open={open}
+    onOpenChange={setOpen}
+    productSlug="healthybowl"
+    scope="product"
+    examplePrompts={suggestedQuestions}
+    avatar={{
+      src: '/avatar.webp',
+      live: {
+        site: 'healthybowl',
+        load: () => import('@burdenoff/website-sdk/avatar-live'),
+        turnstileSiteKey: TURNSTILE_SITE_KEY,
+        manifestVersion: 'hb-en-1', // the version of `suggestedQuestions`
+      },
+    }}
+  />
+</ExploreChatProvider>
+```
+
+- **Opt-in, and inert without it.** Without `avatar.live` the panel renders
+  and behaves exactly as before and asks no server anything. With it, nothing
+  happens on page load: the first request is made when the visitor opens the
+  Avatar view.
+- **A chunk of its own, so a site that does not use it does not carry it.** The
+  live avatar's view, its state machine and its words in six locales are a
+  separate file in the package (`dist/avatar-live-view/`, not a public entry:
+  it is in no `exports`), which the panel loads with a dynamic `import()` the
+  first time the Avatar view opens on a site that passes `avatar.live`. The
+  root entry carries only the few lines that decide whether it is wanted and
+  what the Avatar view shows until it arrives (the same picture, and the same
+  bytes in a server render or a prerendered page, as before). A site that never
+  passes `avatar.live` never downloads it: its bundle grows by under a kilobyte
+  gzipped, instead of the roughly twelve the view weighs. Your bundler needs
+  to split dynamic imports, as Vite, webpack and Rollup do. If the file cannot
+  be fetched (offline, or a deploy has replaced it), or has not arrived after
+  eight seconds, the Avatar view shows what it showed before the live avatar,
+  also while it asks again, which it does each time the view opens. Whether
+  that fetches the file again is the browser's call: Safari and Firefox fetch a
+  module that failed once again, but Chromium-based browsers (Chrome, Edge,
+  Chrome on Android) keep the failed fetch for as long as the page lives, so
+  there the Avatar view stays as it was until the page is reloaded. A file that
+  arrives after the eight seconds is used if the visitor is still on the Avatar
+  view. `bun run build` checks the layout.
+- **Install `livekit-client` (^2.22.3) on that site only.** It is an optional
+  peer dependency of this package, used by the separate
+  `@burdenoff/website-sdk/avatar-live` entry and nowhere else. Pass that entry
+  as `live.load`, as above, so your bundler splits it into its own chunk; the
+  panel calls it only after the visitor presses Start. The package's own build
+  checks that no other entry refers to the library.
+- **Needs the panel under an `ExploreChatProvider`.** The live avatar reads the
+  provider's conversation. Without a provider, on a shared (read-only)
+  conversation, in a locale whose strings have not been reviewed yet (English
+  only, for now), or with an incomplete `live`, the Avatar view stays as it was.
+- **One answer: the first, to a suggested question.** The avatar service
+  accepts a conversation only when it holds exactly two messages: the first user
+  message (a suggested question) and the first assistant answer, completed. The
+  view applies the same rule before it offers anything. With no question asked
+  yet, or its answer still on its way, it asks the visitor to choose a suggested
+  question in Chat first. After a failed first answer, or once the chat has gone
+  past that first question and answer (a second question, or a failed answer
+  asked again without Retry), it asks the visitor to start a new chat and choose
+  a suggested question. Whether the first question really is one of the
+  suggested ones is the service's to judge (`not_eligible`).
+- **What the visitor sees.** Opening the Avatar view asks the gateway (the
+  origin of your configured `gatewayUrl`, at `/api/web-avatar/v1/availability`)
+  whether the live avatar is offered for this site and locale. When it is and
+  the conversation has its first answer, a consent card explains what happens
+  and links to `/privacy#live-avatar`; with no answer yet, the view asks the
+  visitor to choose a suggested question in Chat first. Start runs a
+  Cloudflare Turnstile check (action `avatar_start`), creates the session and
+  joins its room: the video, the captions, an "AI avatar · not a real person"
+  badge, a countdown, Stop and Continue in Chat. Where a browser holds sound
+  back (Safari, iOS), a "Tap to turn on sound" button appears. A refusal (busy,
+  limits, region, language, paused, a question the avatar cannot read) is one
+  short sentence and "Continue in Chat". A network or CORS failure, or a route
+  that is not there, shows the view as it was before.
+- **Ending.** Stop, switching to Chat, closing the panel, hiding the page, and
+  the live avatar going off under a session (the panel's locale changing to one
+  whose strings have not been reviewed) all end the session with a `keepalive`
+  request and leave the room. The end is a simple CORS request: its body is a
+  string and the SDK sets no `content-type`, so the browser sends it as
+  `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.
+- **Consent copy is versioned.** The panel shows a consent card only when it
+  holds reviewed copy for exactly the version the server names (the current
+  English copy is `web-consent-2026-11`); otherwise the view stays as it was.
+- **Requests.** All three go to the gateway without credentials. The create
+  request carries `content-type: application/json`, `idempotency-key` (a UUID
+  v4) and `x-web-avatar-bot-token` (the Turnstile token, which the gateway
+  verifies and does not forward); the availability request and the end request
+  carry no header of the SDK's own. The conversation token is sent in the create
+  body only. Neither it, nor the session's end secret, nor the room token, nor
+  the bot check's token is ever written into the page, the console or storage by
+  the live avatar (the chat keeps its own copy of the conversation in
+  `localStorage`, as it always has).
+- **Bot-check binding (web API contract v1.1, additive).** The Turnstile widget
+  is rendered with `cData` set to
+  `base64url_nopad(SHA-256(UTF-8("boff-web-avatar-cdata/v1\n" + site + "\n" + locale + "\n" + conversationToken + "\n" + messageId)))`,
+  made with WebCrypto from the exact values the create body then carries, before
+  the widget is rendered, so the gateway can check that the token was minted for
+  this request. The action stays `avatar_start`, and nothing else in v1
+  changes. A browser without WebCrypto (a page that is not a secure context)
+  cannot start the live avatar: Start loads neither the room module nor the bot
+  check's script there, and shows the view as it was. Pinned vector: site
+  `healthybowl`, locale `en`, conversation token
+  `ct_vector_0123456789abcdefghijklmnopqrstuvwx`, message id
+  `11111111-2222-4333-8444-555555555555` give
+  `si4b6TQ3lxnlbdqG3IzgjbHrnlD8SMo1E0of1c6uZFY`.
+- **Alpha builds.** On the alpha gateway hosts the configured Cloudflare Access
+  headers (`cf-access-client-id`, `cf-access-client-secret`) are added to all
+  three requests, as on every SDK request, so each of them is a preflighted
+  request there. An alpha build that sends them relies on the gateway's web
+  preflight allowing exactly those two headers on non-production hosts. A
+  production build sets no Access headers, and its end request makes no
+  preflight.
+- **Your page's headers.** A site with a Content Security Policy must allow:
+  - `script-src` and `frame-src`: `https://challenges.cloudflare.com` (the
+    Turnstile bot check);
+  - `connect-src`, the gateway origin (the three requests);
+  - `connect-src`, the media room: `wss://<project>.livekit.cloud`. For a
+    LiveKit Cloud room the media library also asks
+    `https://<project>.livekit.cloud/settings/regions` (sending the room token as
+    a Bearer header) and, when the first host cannot be reached, fails over to
+    the regional hosts and uses the room's `/rtc/validate` check. So allow
+    `https://<project>.livekit.cloud` too, and the regional hosts, in practice
+    `wss://*.livekit.cloud` and `https://*.livekit.cloud`. Under a strict
+    `connect-src` those are only console warnings, but region failover is lost.
+    A self-hosted room needs its own `wss://` origin, and the `https://` origin
+    of the same host for the validation check.
+- **Not verified in this package.** Every test here uses fakes: nothing reaches
+  Turnstile, the gateway, the avatar service or the media room. Left to the
+  alpha test: real playback on iPhone Safari and Android Chrome; that
+  `page_hide` ends actually arrive from those browsers; and that the receive-only
+  token has `canPublish=false` and `canPublishData=false`, and a worker RPC
+  addressed to the viewer is dropped without disconnecting it (the media client
+  answers incoming RPC requests on its own, so "never publishes" holds only as
+  far as the token's permissions do).
+
+Testing hooks (`data-boff-explore`): `avatar-live` (with `data-phase`),
+`avatar-live-status`, `avatar-live-consent`, `avatar-live-privacy`,
+`avatar-live-start`, `avatar-live-not-now`, `avatar-live-stop`,
+`avatar-live-video`, `avatar-live-audio`, `avatar-live-badge`,
+`avatar-live-captions`, `avatar-live-countdown`, `avatar-live-sound`,
+`avatar-live-continue`, `avatar-live-back`, `avatar-live-bot-check`.
+
 **`ExploreCta` props**: `variant` (`'header' \| 'mobile' \| 'floating'`, required),
 `href` (default `/explore`), `label` (default `Ask AI`), `className`,
 `onNavigate`, `onClick`, `currentPath`. The `floating` variant hides itself on
@@ -265,7 +421,9 @@ with it. This is separate from the v2 checkbox used by `ContactPage`.
 **Headless use.** `useExploreChat(options)` exposes the whole state machine —
 `{ phase, catalog, messages, activity, remainingToday, error, focusProduct,
 setFocusProduct, send, stop, retry, reset, canSend }` — if you want to build a
-different shell around it.
+different shell around it. `getConversationToken()` returns the visitor's
+conversation token at the moment of the call (a function, so it is never
+rendered or serialised with the rest).
 
 **Inline concept illustrations.** An answer may embed images from the product
 sites' concept pages (`![alt](url)`, followed by the backend's own caption

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

@@ -0,0 +1,11 @@
+import { R as ReceiveOnlyJoinOptions, a as ReceiveOnlySession } from '../types-CndbmBK-.mjs';
+export { A as AvatarLiveModule, b as ReceiveOnlyEvent } from '../types-CndbmBK-.mjs';
+
+/**
+ * Join the room in `options.url` with the receive-only `options.token`, and play the avatar worker's video and voice
+ * in `options.video` and `options.audio`. Resolves once connected; rejects when the room cannot be joined (the panel
+ * then ends the session).
+ */
+declare function joinReceiveOnly(options: ReceiveOnlyJoinOptions): Promise<ReceiveOnlySession>;
+
+export { ReceiveOnlyJoinOptions, ReceiveOnlySession, joinReceiveOnly };

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

@@ -0,0 +1,11 @@
+import { R as ReceiveOnlyJoinOptions, a as ReceiveOnlySession } from '../types-CndbmBK-.js';
+export { A as AvatarLiveModule, b as ReceiveOnlyEvent } from '../types-CndbmBK-.js';
+
+/**
+ * Join the room in `options.url` with the receive-only `options.token`, and play the avatar worker's video and voice
+ * in `options.video` and `options.audio`. Resolves once connected; rejects when the room cannot be joined (the panel
+ * then ends the session).
+ */
+declare function joinReceiveOnly(options: ReceiveOnlyJoinOptions): Promise<ReceiveOnlySession>;
+
+export { ReceiveOnlyJoinOptions, ReceiveOnlySession, joinReceiveOnly };

package/dist/avatar-live/index.js

@@ -0,0 +1,120 @@
+'use strict';
+
+var livekitClient = require('livekit-client');
+
+var CLOSED_BY_SERVER = /* @__PURE__ */ new Set([
+  livekitClient.DisconnectReason.ROOM_DELETED,
+  livekitClient.DisconnectReason.ROOM_CLOSED,
+  livekitClient.DisconnectReason.PARTICIPANT_REMOVED
+]);
+function isMedia(publication) {
+  return publication.kind === livekitClient.Track.Kind.Video || publication.kind === livekitClient.Track.Kind.Audio;
+}
+async function joinReceiveOnly(options) {
+  const { url, token, workerIdentity, video, audio, onEvent } = options;
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    throw new Error("live avatar: the room address is not a URL");
+  }
+  if (parsed.protocol !== "wss:") {
+    throw new Error("live avatar: the room address must be wss:");
+  }
+  if (!token || !workerIdentity) {
+    throw new Error("live avatar: the room token or speaker is missing");
+  }
+  const room = new livekitClient.Room({
+    // One small video, always shown while the session lasts: no quality switching, no layer pausing.
+    adaptiveStream: false,
+    dynacast: false,
+    // Closing the tab or leaving the page leaves the room at once. Belt and braces with the panel's own page-hide
+    // handler, which also asks the server to end the session: either may run first, and both are safe to repeat.
+    disconnectOnPageLeave: true
+  });
+  let leaving = false;
+  const isSpeaker = (participant) => participant.identity === workerIdentity;
+  const consider = (publication, participant) => {
+    if (leaving || !isSpeaker(participant) || !isMedia(publication)) return;
+    if (!publication.isSubscribed) publication.setSubscribed(true);
+  };
+  const reportPlayback = () => {
+    if (leaving) return;
+    onEvent({
+      type: "playback-blocked",
+      blocked: !room.canPlaybackAudio || !room.canPlaybackVideo
+    });
+  };
+  room.on(livekitClient.RoomEvent.TrackPublished, consider).on(
+    livekitClient.RoomEvent.TrackSubscribed,
+    (track, publication, participant) => {
+      if (leaving) return;
+      if (!isSpeaker(participant) || !isMedia(publication)) {
+        publication.setSubscribed(false);
+        return;
+      }
+      if (track.kind === livekitClient.Track.Kind.Video) {
+        track.attach(video);
+        onEvent({ type: "speaker-track", kind: "video" });
+      } else {
+        track.attach(audio);
+        onEvent({ type: "speaker-track", kind: "audio" });
+      }
+    }
+  ).on(livekitClient.RoomEvent.TrackUnsubscribed, (track) => {
+    track.detach();
+  }).on(livekitClient.RoomEvent.ParticipantDisconnected, (participant) => {
+    if (!leaving && isSpeaker(participant)) {
+      onEvent({ type: "speaker-left" });
+    }
+  }).on(livekitClient.RoomEvent.AudioPlaybackStatusChanged, reportPlayback).on(livekitClient.RoomEvent.VideoPlaybackStatusChanged, reportPlayback).on(livekitClient.RoomEvent.Disconnected, (reason) => {
+    if (leaving) return;
+    onEvent({
+      type: "disconnected",
+      byServer: reason !== void 0 && CLOSED_BY_SERVER.has(reason)
+    });
+  });
+  const detachAll = () => {
+    for (const participant of room.remoteParticipants.values()) {
+      for (const publication of participant.trackPublications.values()) {
+        publication.track?.detach();
+      }
+    }
+    video.srcObject = null;
+    audio.srcObject = null;
+  };
+  try {
+    await room.connect(url, token, { autoSubscribe: false });
+  } catch (error) {
+    leaving = true;
+    room.removeAllListeners();
+    detachAll();
+    throw error;
+  }
+  for (const participant of room.remoteParticipants.values()) {
+    for (const publication of participant.trackPublications.values()) {
+      consider(publication, participant);
+    }
+  }
+  reportPlayback();
+  return {
+    enablePlayback: async () => {
+      await Promise.allSettled([room.startAudio(), room.startVideo()]);
+      reportPlayback();
+    },
+    leave: async () => {
+      if (leaving) return;
+      leaving = true;
+      detachAll();
+      try {
+        await room.disconnect();
+      } finally {
+        room.removeAllListeners();
+      }
+    }
+  };
+}
+
+exports.joinReceiveOnly = joinReceiveOnly;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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"]}

package/dist/avatar-live/index.mjs

@@ -0,0 +1,118 @@
+import { DisconnectReason, Room, RoomEvent, Track } from 'livekit-client';
+
+var CLOSED_BY_SERVER = /* @__PURE__ */ new Set([
+  DisconnectReason.ROOM_DELETED,
+  DisconnectReason.ROOM_CLOSED,
+  DisconnectReason.PARTICIPANT_REMOVED
+]);
+function isMedia(publication) {
+  return publication.kind === Track.Kind.Video || publication.kind === Track.Kind.Audio;
+}
+async function joinReceiveOnly(options) {
+  const { url, token, workerIdentity, video, audio, onEvent } = options;
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    throw new Error("live avatar: the room address is not a URL");
+  }
+  if (parsed.protocol !== "wss:") {
+    throw new Error("live avatar: the room address must be wss:");
+  }
+  if (!token || !workerIdentity) {
+    throw new Error("live avatar: the room token or speaker is missing");
+  }
+  const room = new Room({
+    // One small video, always shown while the session lasts: no quality switching, no layer pausing.
+    adaptiveStream: false,
+    dynacast: false,
+    // Closing the tab or leaving the page leaves the room at once. Belt and braces with the panel's own page-hide
+    // handler, which also asks the server to end the session: either may run first, and both are safe to repeat.
+    disconnectOnPageLeave: true
+  });
+  let leaving = false;
+  const isSpeaker = (participant) => participant.identity === workerIdentity;
+  const consider = (publication, participant) => {
+    if (leaving || !isSpeaker(participant) || !isMedia(publication)) return;
+    if (!publication.isSubscribed) publication.setSubscribed(true);
+  };
+  const reportPlayback = () => {
+    if (leaving) return;
+    onEvent({
+      type: "playback-blocked",
+      blocked: !room.canPlaybackAudio || !room.canPlaybackVideo
+    });
+  };
+  room.on(RoomEvent.TrackPublished, consider).on(
+    RoomEvent.TrackSubscribed,
+    (track, publication, participant) => {
+      if (leaving) return;
+      if (!isSpeaker(participant) || !isMedia(publication)) {
+        publication.setSubscribed(false);
+        return;
+      }
+      if (track.kind === Track.Kind.Video) {
+        track.attach(video);
+        onEvent({ type: "speaker-track", kind: "video" });
+      } else {
+        track.attach(audio);
+        onEvent({ type: "speaker-track", kind: "audio" });
+      }
+    }
+  ).on(RoomEvent.TrackUnsubscribed, (track) => {
+    track.detach();
+  }).on(RoomEvent.ParticipantDisconnected, (participant) => {
+    if (!leaving && isSpeaker(participant)) {
+      onEvent({ type: "speaker-left" });
+    }
+  }).on(RoomEvent.AudioPlaybackStatusChanged, reportPlayback).on(RoomEvent.VideoPlaybackStatusChanged, reportPlayback).on(RoomEvent.Disconnected, (reason) => {
+    if (leaving) return;
+    onEvent({
+      type: "disconnected",
+      byServer: reason !== void 0 && CLOSED_BY_SERVER.has(reason)
+    });
+  });
+  const detachAll = () => {
+    for (const participant of room.remoteParticipants.values()) {
+      for (const publication of participant.trackPublications.values()) {
+        publication.track?.detach();
+      }
+    }
+    video.srcObject = null;
+    audio.srcObject = null;
+  };
+  try {
+    await room.connect(url, token, { autoSubscribe: false });
+  } catch (error) {
+    leaving = true;
+    room.removeAllListeners();
+    detachAll();
+    throw error;
+  }
+  for (const participant of room.remoteParticipants.values()) {
+    for (const publication of participant.trackPublications.values()) {
+      consider(publication, participant);
+    }
+  }
+  reportPlayback();
+  return {
+    enablePlayback: async () => {
+      await Promise.allSettled([room.startAudio(), room.startVideo()]);
+      reportPlayback();
+    },
+    leave: async () => {
+      if (leaving) return;
+      leaving = true;
+      detachAll();
+      try {
+        await room.disconnect();
+      } finally {
+        room.removeAllListeners();
+      }
+    }
+  };
+}
+
+export { joinReceiveOnly };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,42 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { E as ExplorePanelAvatarLive, a as ExploreLocale, A as AvatarConversation } from '../explore-avatar-live-config-BGsGwbcq.mjs';
+import '../types-CndbmBK-.mjs';
+import '../use-explore-chat-zRuoAin6.mjs';
+import '../explore-types-Bb2Ih3d8.mjs';
+
+interface AvatarLiveViewProps {
+    live: ExplorePanelAvatarLive;
+    /** The Avatar view is showing: the panel is open and its Avatar tab is selected. */
+    active: boolean;
+    locale: ExploreLocale;
+    /** The product the panel speaks for, when it is one product's own; null on the portfolio's. */
+    productName: string | null;
+    /** The approved still picture. */
+    still: {
+        src: string;
+        alt: string;
+    };
+    /** The Avatar tab as it was before the live avatar: shown whenever the live avatar is not offered or not reachable. */
+    fallback: ReactNode;
+    /** Back to the Chat tab. Leaving the Avatar tab ends a session, like any other way out of it. */
+    onContinueInChat: () => void;
+    /** "Continue in Chat" in the panel's language: the panel's own word for it, so this chunk carries none of the panel's. */
+    continueInChat: string;
+    /**
+     * Nothing to ask the server about: an incomplete config, no gateway, no shared conversation to read (no provider, or a
+     * read-only shared one), or a locale whose strings have not been reviewed. The tab stays as it was. Decided by
+     * `ExploreAvatarLive`, which also decides whether this view is loaded at all; it can change while this view is
+     * mounted (the panel's locale switching), and what is under way then ends.
+     */
+    off: boolean;
+    /** {@link avatarApiBase} of the SDK's gateway, null when there is none to use. */
+    base: string | null;
+    /** Headers every request carries: the alpha gateway's access headers, and nothing on production. */
+    headers: Readonly<Record<string, string>>;
+    /** The panel's conversation, null when there is no provider. */
+    conversation: AvatarConversation | null;
+}
+declare function AvatarLiveView({ live, active, locale, productName, still, fallback, onContinueInChat, continueInChat, off, base, headers, conversation, }: AvatarLiveViewProps): react.JSX.Element;
+
+export { AvatarLiveView, type AvatarLiveViewProps };

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

@@ -0,0 +1,42 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { E as ExplorePanelAvatarLive, a as ExploreLocale, A as AvatarConversation } from '../explore-avatar-live-config-B171o1Yo.js';
+import '../types-CndbmBK-.js';
+import '../use-explore-chat-DunjG-3p.js';
+import '../explore-types-Bb2Ih3d8.js';
+
+interface AvatarLiveViewProps {
+    live: ExplorePanelAvatarLive;
+    /** The Avatar view is showing: the panel is open and its Avatar tab is selected. */
+    active: boolean;
+    locale: ExploreLocale;
+    /** The product the panel speaks for, when it is one product's own; null on the portfolio's. */
+    productName: string | null;
+    /** The approved still picture. */
+    still: {
+        src: string;
+        alt: string;
+    };
+    /** The Avatar tab as it was before the live avatar: shown whenever the live avatar is not offered or not reachable. */
+    fallback: ReactNode;
+    /** Back to the Chat tab. Leaving the Avatar tab ends a session, like any other way out of it. */
+    onContinueInChat: () => void;
+    /** "Continue in Chat" in the panel's language: the panel's own word for it, so this chunk carries none of the panel's. */
+    continueInChat: string;
+    /**
+     * Nothing to ask the server about: an incomplete config, no gateway, no shared conversation to read (no provider, or a
+     * read-only shared one), or a locale whose strings have not been reviewed. The tab stays as it was. Decided by
+     * `ExploreAvatarLive`, which also decides whether this view is loaded at all; it can change while this view is
+     * mounted (the panel's locale switching), and what is under way then ends.
+     */
+    off: boolean;
+    /** {@link avatarApiBase} of the SDK's gateway, null when there is none to use. */
+    base: string | null;
+    /** Headers every request carries: the alpha gateway's access headers, and nothing on production. */
+    headers: Readonly<Record<string, string>>;
+    /** The panel's conversation, null when there is no provider. */
+    conversation: AvatarConversation | null;
+}
+declare function AvatarLiveView({ live, active, locale, productName, still, fallback, onContinueInChat, continueInChat, off, base, headers, conversation, }: AvatarLiveViewProps): react.JSX.Element;
+
+export { AvatarLiveView, type AvatarLiveViewProps };