@arbidocs/react 0.5.110 → 0.5.112

package/dist/calls/livekit/useCallTranscriber.js

@@ -0,0 +1,309 @@
+import { useQueryClient } from "@tanstack/react-query";
+import { useArbi } from "../../useArbi.js";
+import { toProfileView } from "../../account/profile.js";
+import {
+  onCallEvent,
+  useCallTranscriptionAvailable,
+  CALL_CAPTION_TOPIC,
+  CALL_TRANSCRIPTION_TOPIC,
+  decodeCaptionPacket,
+  encodeCaptionPacket,
+  newSegmentId,
+  persistTranscriptSegment,
+  transcriptPersistRole
+} from "../index.js";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { RoomEvent } from "livekit-client";
+import { useLocalParticipant, useRoomContext } from "@livekit/components-react";
+import { CallApiError, calls, continuityPrompt } from "@arbidocs/sdk/browser";
+import { notify } from "../../notifications/notify-store.js";
+const MAX_CAPTIONS = 30;
+const FINAL_SEGMENT_GRACE_MS = 3e4;
+const PROMPT_HISTORY_CHARS = 400;
+function mayStillSend(params) {
+  if (params.sending) return true;
+  if (params.stoppedAt === null) return false;
+  return params.segmentStartedAt <= params.stoppedAt && params.now - params.stoppedAt <= FINAL_SEGMENT_GRACE_MS;
+}
+function storedSpeakerName(participantName, profileName, identity) {
+  return participantName?.trim() || profileName?.trim() || identity;
+}
+function useCallTranscriber({
+  callExtId,
+  callKey,
+  isCreator,
+  canPost,
+  linkVersion = null
+}) {
+  const room = useRoomContext();
+  const { localParticipant } = useLocalParticipant();
+  const myIdentity = localParticipant.identity;
+  const arbi = useArbi();
+  const queryClient = useQueryClient();
+  const profile = arbi.isLoggedIn ? arbi.user.profile() : null;
+  const myProfileName = profile && toProfileView(profile).fullName || null;
+  const deploymentAvailable = useCallTranscriptionAvailable();
+  const available = deploymentAvailable && !!callKey;
+  const [state, setState] = useState(null);
+  const [creatorExtId, setCreatorExtId] = useState(null);
+  const [busy, setBusy] = useState(false);
+  const [muted, setMuted] = useState(false);
+  const [indicatorShown, setIndicatorShown] = useState(false);
+  const [captions, setCaptions] = useState([]);
+  const liveUpdate = useRef(false);
+  const persisted = useRef(/* @__PURE__ */ new Set());
+  const saveFailureShown = useRef(false);
+  const selfPosts = useRef(canPost);
+  useEffect(() => {
+    selfPosts.current = canPost;
+  }, [canPost]);
+  const on = available && !!state?.on;
+  const shouldSend = on && indicatorShown && !muted;
+  const shouldSendRef = useRef(shouldSend);
+  const sendStoppedAtRef = useRef(null);
+  if (shouldSendRef.current !== shouldSend) {
+    sendStoppedAtRef.current = shouldSend ? null : Date.now();
+  }
+  shouldSendRef.current = shouldSend;
+  const myPreviousText = useRef("");
+  const applyState = useCallback((next) => {
+    liveUpdate.current = true;
+    setState(next);
+  }, []);
+  useEffect(() => {
+    if (!available) return;
+    let cancelled = false;
+    arbi.calls.get(callExtId).then((call) => {
+      if (cancelled) return;
+      setCreatorExtId(call.creator_ext_id ?? null);
+      if (!liveUpdate.current) {
+        setState(calls.transcriptionStateFrom(call.transcription));
+      }
+    }).catch((err) => console.warn("[calls] could not read the transcription state", err));
+    return () => {
+      cancelled = true;
+    };
+  }, [available, callExtId]);
+  useEffect(
+    () => onCallEvent("call.transcription", (message) => {
+      if (message.call_ext_id === callExtId) applyState(message);
+    }),
+    [callExtId, applyState]
+  );
+  const addCaption = useCallback((line) => {
+    setCaptions((prev) => {
+      if (prev.some((c) => c.segmentId === line.segmentId && c.identity === line.identity)) {
+        return prev;
+      }
+      return [...prev, line].sort((a, b) => a.t - b.t).slice(-MAX_CAPTIONS);
+    });
+  }, []);
+  const persist = useCallback(
+    (segment, speakerNeedsProxy) => {
+      if (!callKey || persisted.current.has(segment.segmentId)) return;
+      const role = transcriptPersistRole({
+        myIdentity,
+        canPost: canPost && (segment.speakerIdentity !== myIdentity || selfPosts.current),
+        hasCallKey: true,
+        speakerIdentity: segment.speakerIdentity,
+        speakerNeedsProxy
+      });
+      if (!role) return;
+      persisted.current.add(segment.segmentId);
+      persistTranscriptSegment(arbi, queryClient, callExtId, callKey, segment).catch(
+        (err) => {
+          persisted.current.delete(segment.segmentId);
+          if (role === "own" && err?.status === 403) {
+            selfPosts.current = false;
+          }
+          console.warn("[calls] could not keep the transcript line", err);
+          if (!saveFailureShown.current) {
+            saveFailureShown.current = true;
+            notify.warning(
+              `Transcript lines are not being saved to the meeting chat: ${err?.message ?? "unknown error"}`
+            );
+          }
+        }
+      );
+    },
+    [callExtId, callKey, myIdentity, canPost]
+  );
+  useEffect(() => {
+    const onData = (payload, participant, _kind, topic, _encryption, participantIdentity) => {
+      if (topic === CALL_TRANSCRIPTION_TOPIC) {
+        if (participant || participantIdentity) return;
+        try {
+          const next = calls.transcriptionStateFrom(JSON.parse(new TextDecoder().decode(payload)));
+          if (next) applyState(next);
+        } catch {
+        }
+        return;
+      }
+      if (topic !== CALL_CAPTION_TOPIC || !callKey) return;
+      const identity = participant?.identity ?? participantIdentity;
+      if (!identity || identity === myIdentity) return;
+      void decodeCaptionPacket(payload, callKey).then((packet) => {
+        if (!packet || packet.identity !== identity) return;
+        const name = participant?.name || packet.name || identity;
+        const t = Math.min(packet.t, Date.now());
+        addCaption({
+          segmentId: packet.segment_id,
+          identity,
+          name,
+          text: packet.text,
+          t,
+          mine: false,
+          receivedAt: Date.now()
+        });
+        persist(
+          {
+            segmentId: packet.segment_id,
+            text: packet.text,
+            speakerIdentity: identity,
+            speakerName: name,
+            startedAt: new Date(t).toISOString()
+          },
+          packet.proxy === true
+        );
+      });
+    };
+    room.on(RoomEvent.DataReceived, onData);
+    return () => {
+      room.off(RoomEvent.DataReceived, onData);
+    };
+  }, [room, callKey, myIdentity, addCaption, applyState, persist]);
+  const handleSegment = useCallback(
+    async (segment) => {
+      if (!callKey || !mayStillSend({
+        sending: shouldSendRef.current,
+        stoppedAt: sendStoppedAtRef.current,
+        segmentStartedAt: segment.startedAt,
+        now: Date.now()
+      })) {
+        return;
+      }
+      const segmentId = newSegmentId();
+      const startedAt = new Date(segment.startedAt).toISOString();
+      let text;
+      try {
+        const result = await arbi.calls.transcription.transcribe(callExtId, {
+          audio: segment.blob,
+          segmentId,
+          startedAt,
+          linkVersion,
+          prompt: continuityPrompt(myPreviousText.current)
+        });
+        text = result.text.trim();
+      } catch (err) {
+        if (err instanceof CallApiError && err.status === 409) {
+          applyState({ on: false, by_identity: null, by_name: null });
+        }
+        console.warn("[calls] could not transcribe a segment", err);
+        return;
+      }
+      if (!text) return;
+      myPreviousText.current = `${myPreviousText.current} ${text}`.slice(-PROMPT_HISTORY_CHARS);
+      const name = storedSpeakerName(localParticipant.name, myProfileName, myIdentity);
+      const proxy = !selfPosts.current;
+      addCaption({
+        segmentId,
+        identity: myIdentity,
+        name,
+        text,
+        t: segment.startedAt,
+        mine: true,
+        receivedAt: Date.now()
+      });
+      try {
+        await localParticipant.publishData(
+          await encodeCaptionPacket(
+            {
+              v: 1,
+              segment_id: segmentId,
+              text,
+              identity: myIdentity,
+              name,
+              t: segment.startedAt,
+              ...proxy ? { proxy: true } : {}
+            },
+            callKey
+          ),
+          { reliable: true, topic: CALL_CAPTION_TOPIC }
+        );
+      } catch (err) {
+        console.warn("[calls] could not broadcast a caption", err);
+      }
+      if (!proxy) {
+        persist(
+          { segmentId, text, speakerIdentity: myIdentity, speakerName: name, startedAt },
+          false
+        );
+      }
+    },
+    [
+      callExtId,
+      callKey,
+      linkVersion,
+      localParticipant,
+      myIdentity,
+      myProfileName,
+      addCaption,
+      applyState,
+      persist
+    ]
+  );
+  const startedByMe = !!state?.on && state.by_identity === myIdentity;
+  const canToggle = available && (isCreator || !!creatorExtId && creatorExtId === myIdentity);
+  const toggle = useCallback(async () => {
+    if (!canToggle) return;
+    const next = !on;
+    setBusy(true);
+    try {
+      const answer = await arbi.calls.transcription.set(callExtId, next);
+      applyState(
+        answer ?? (next ? { on: true, by_identity: myIdentity, by_name: localParticipant.name || null } : { on: false, by_identity: null, by_name: null })
+      );
+    } catch (err) {
+      notify.error(`Could not turn transcription ${next ? "on" : "off"}: ${err.message}`);
+    } finally {
+      setBusy(false);
+    }
+  }, [on, canToggle, callExtId, myIdentity, localParticipant, applyState]);
+  return useMemo(
+    () => ({
+      available,
+      on,
+      startedByName: on ? state?.by_name ?? null : null,
+      startedByMe,
+      canToggle,
+      busy,
+      muted,
+      setMuted,
+      toggle,
+      setIndicatorShown,
+      shouldSend,
+      captions,
+      handleSegment
+    }),
+    [
+      available,
+      on,
+      state,
+      startedByMe,
+      canToggle,
+      busy,
+      muted,
+      toggle,
+      shouldSend,
+      captions,
+      handleSegment
+    ]
+  );
+}
+export {
+  FINAL_SEGMENT_GRACE_MS,
+  mayStillSend,
+  storedSpeakerName,
+  useCallTranscriber
+};
+//# sourceMappingURL=useCallTranscriber.js.map

package/dist/calls/livekit/useCallTranscriber.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/calls/livekit/useCallTranscriber.ts"],
+  "sourcesContent": ["/**\n * Live transcription state of a LiveKit room (ARBI `docs/meeting-chats-plan.md` \u00A75). Must run inside\n * <LiveKitRoom>.\n *\n * - Transcription is the HOST's setting: only the call's creator can turn it on or off.\n * - The state comes from the call row on join, then from the server's `arbi.transcription` data\n *   message and WS `call.transcription`. A participant cannot fake it: only a server-sent packet\n *   (no sender) is accepted.\n * - My audio is sent only while transcription is on AND its indicator is on screen\n *   (`indicatorShown`, set by the indicator itself once mounted) AND I have not muted my\n *   transcription AND (checked by <TranscriptionSender>) my microphone is on.\n * - Each of my transcribed segments becomes a caption for everyone (data channel, under K) and a\n *   transcript line in the meeting chat \u2014 stored by me, or, when I cannot post there (a workspace\n *   guest), by the members who receive my `proxy` caption. It is stored under my real display name\n *   (the UI shows \"You\" for my own lines; the stored line never says \"You\").\n * - The line being spoken when sending stops (transcription off, my transcription muted, hang-up,\n *   page hide) is still flushed and sent: the server takes a segment for {@link FINAL_SEGMENT_GRACE_MS}\n *   after transcription went off if it started before that.\n * - Every clip carries the user's language and my previous line (a continuity prompt).\n */\n\nimport { useQueryClient } from '@tanstack/react-query'\nimport { useArbi } from '../../useArbi'\nimport { useAudioRecorder, type AudioSegment } from '../../documents/useAudioRecorder'\nimport { toProfileView } from '../../account/profile'\nimport {\n  onCallEvent,\n  useCallTranscriptionAvailable,\n  CALL_CAPTION_TOPIC,\n  CALL_TRANSCRIPTION_TOPIC,\n  decodeCaptionPacket,\n  encodeCaptionPacket,\n  newSegmentId,\n  persistTranscriptSegment,\n  transcriptPersistRole,\n  type CaptionLine,\n  type TranscriptSegment,\n} from '..'\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react'\nimport { RoomEvent, type RemoteParticipant } from 'livekit-client'\nimport { useLocalParticipant, useRoomContext } from '@livekit/components-react'\nimport { CallApiError, calls, continuityPrompt } from '@arbidocs/sdk/browser'\nimport { notify } from '../../notifications/notify-store'\n\n/** Captions kept in memory (the overlay shows the last few). */\nconst MAX_CAPTIONS = 30\n/**\n * After sending stops, the segment that was open then is still sent (the server's grace for a final\n * segment is 30 s after transcription is turned off, for a segment that started before).\n */\nexport const FINAL_SEGMENT_GRACE_MS = 30_000\n/** My previous text kept for the continuity prompt (a little more than it sends). */\nconst PROMPT_HISTORY_CHARS = 400\n\n/**\n * Whether one of my segments may still be sent: while sending, always; after sending stopped, only\n * the segment that was open then (it started before the stop) and within the server's grace.\n */\nexport function mayStillSend(params: {\n  sending: boolean\n  /** When sending last stopped (ms since epoch); null if it never did. */\n  stoppedAt: number | null\n  segmentStartedAt: number\n  now: number\n}): boolean {\n  if (params.sending) return true\n  if (params.stoppedAt === null) return false\n  return (\n    params.segmentStartedAt <= params.stoppedAt &&\n    params.now - params.stoppedAt <= FINAL_SEGMENT_GRACE_MS\n  )\n}\n\n/**\n * The name my transcript lines are stored under: my LiveKit name, else my profile's display name,\n * else my identity \u2014 never \"You\" (that is only how the UI shows my own lines to me).\n */\nexport function storedSpeakerName(\n  participantName: string | null | undefined,\n  profileName: string | null | undefined,\n  identity: string\n): string {\n  return participantName?.trim() || profileName?.trim() || identity\n}\n\nexport interface CallTranscription {\n  /** The deployment has a transcriber and the call has a key. */\n  available: boolean\n  on: boolean\n  startedByName: string | null\n  startedByMe: boolean\n  /** I host the call: only I see and use the on/off control. */\n  canToggle: boolean\n  busy: boolean\n  /** I muted my own transcription (nothing of mine is sent). */\n  muted: boolean\n  setMuted(muted: boolean): void\n  /** Turn on / off (the host only). */\n  toggle(): Promise<void>\n  /** The indicator reports itself on screen; nothing is sent before it is. */\n  setIndicatorShown(shown: boolean): void\n  /** On, shown and not muted: <TranscriptionSender> records while this (and the mic) is on. */\n  shouldSend: boolean\n  captions: CaptionLine[]\n  /** <TranscriptionSender> hands each of my speech segments here. */\n  handleSegment(segment: AudioSegment): Promise<void>\n}\n\nexport function useCallTranscriber({\n  callExtId,\n  callKey,\n  isCreator,\n  canPost,\n  linkVersion = null,\n}: {\n  callExtId: string\n  /** The link version I joined with (sent with each segment). */\n  linkVersion?: number | null\n  callKey: Uint8Array | null\n  isCreator: boolean\n  /** I can post to the meeting chat (false for a workspace guest on a thread call). */\n  canPost: boolean\n}): CallTranscription {\n  const room = useRoomContext()\n  const { localParticipant } = useLocalParticipant()\n  const myIdentity = localParticipant.identity\n  const arbi = useArbi()\n  const queryClient = useQueryClient()\n  const profile = arbi.isLoggedIn ? arbi.user.profile() : null\n  const myProfileName = (profile && toProfileView(profile).fullName) || null\n  const deploymentAvailable = useCallTranscriptionAvailable()\n  const available = deploymentAvailable && !!callKey\n\n  const [state, setState] = useState<calls.CallTranscriptionState | null>(null)\n  const [creatorExtId, setCreatorExtId] = useState<string | null>(null)\n  const [busy, setBusy] = useState(false)\n  const [muted, setMuted] = useState(false)\n  const [indicatorShown, setIndicatorShown] = useState(false)\n  const [captions, setCaptions] = useState<CaptionLine[]>([])\n  const liveUpdate = useRef(false)\n  const persisted = useRef(new Set<string>())\n  const saveFailureShown = useRef(false)\n  // Whether my own segments are stored by me; flips off if the meeting chat refuses my posts.\n  const selfPosts = useRef(canPost)\n  useEffect(() => {\n    selfPosts.current = canPost\n  }, [canPost])\n\n  const on = available && !!state?.on\n  const shouldSend = on && indicatorShown && !muted\n  const shouldSendRef = useRef(shouldSend)\n  // When sending last stopped: the segment open then is still flushed and sent (see mayStillSend).\n  const sendStoppedAtRef = useRef<number | null>(null)\n  if (shouldSendRef.current !== shouldSend) {\n    sendStoppedAtRef.current = shouldSend ? null : Date.now()\n  }\n  shouldSendRef.current = shouldSend\n  // My previous text, for the continuity prompt of my next segment.\n  const myPreviousText = useRef('')\n\n  const applyState = useCallback((next: calls.CallTranscriptionState | null) => {\n    liveUpdate.current = true\n    setState(next)\n  }, [])\n\n  // Join: the call row says whether transcription is already on (and who created the call).\n  useEffect(() => {\n    if (!available) return\n    let cancelled = false\n    arbi.calls\n      .get(callExtId)\n      .then((call) => {\n        if (cancelled) return\n        setCreatorExtId(call.creator_ext_id ?? null)\n        // A live announcement that already arrived is newer than this read.\n        if (!liveUpdate.current) {\n          setState(calls.transcriptionStateFrom(call.transcription))\n        }\n      })\n      .catch((err: unknown) => console.warn('[calls] could not read the transcription state', err))\n    return () => {\n      cancelled = true\n    }\n  }, [available, callExtId])\n\n  // WS `call.transcription`.\n  useEffect(\n    () =>\n      onCallEvent('call.transcription', (message) => {\n        if (message.call_ext_id === callExtId) applyState(message)\n      }),\n    [callExtId, applyState]\n  )\n\n  const addCaption = useCallback((line: CaptionLine) => {\n    setCaptions((prev) => {\n      if (prev.some((c) => c.segmentId === line.segmentId && c.identity === line.identity)) {\n        return prev\n      }\n      return [...prev, line].sort((a, b) => a.t - b.t).slice(-MAX_CAPTIONS)\n    })\n  }, [])\n\n  /** Store a segment when it is mine to store (see `transcriptPersistRole`). */\n  const persist = useCallback(\n    (segment: TranscriptSegment, speakerNeedsProxy: boolean) => {\n      if (!callKey || persisted.current.has(segment.segmentId)) return\n      const role = transcriptPersistRole({\n        myIdentity,\n        canPost: canPost && (segment.speakerIdentity !== myIdentity || selfPosts.current),\n        hasCallKey: true,\n        speakerIdentity: segment.speakerIdentity,\n        speakerNeedsProxy,\n      })\n      if (!role) return\n      persisted.current.add(segment.segmentId)\n      persistTranscriptSegment(arbi, queryClient, callExtId, callKey, segment).catch(\n        (err: unknown) => {\n          persisted.current.delete(segment.segmentId)\n          // Refused (not a member of the meeting chat): members store my next segments.\n          if (role === 'own' && (err as { status?: number } | null)?.status === 403) {\n            selfPosts.current = false\n          }\n          console.warn('[calls] could not keep the transcript line', err)\n          // Never silently: say so once per call (captions keep working).\n          if (!saveFailureShown.current) {\n            saveFailureShown.current = true\n            notify.warning(\n              `Transcript lines are not being saved to the meeting chat: ${(err as Error)?.message ?? 'unknown error'}`\n            )\n          }\n        }\n      )\n    },\n    [callExtId, callKey, myIdentity, canPost]\n  )\n\n  // Data channel: the server's state announcements and everyone's captions.\n  useEffect(() => {\n    const onData = (\n      payload: Uint8Array,\n      participant?: RemoteParticipant,\n      _kind?: unknown,\n      topic?: string,\n      _encryption?: unknown,\n      participantIdentity?: string\n    ) => {\n      if (topic === CALL_TRANSCRIPTION_TOPIC) {\n        // Only the server may announce the state: a packet from a participant is ignored.\n        if (participant || participantIdentity) return\n        try {\n          const next = calls.transcriptionStateFrom(JSON.parse(new TextDecoder().decode(payload)))\n          if (next) applyState(next)\n        } catch {\n          // Not ours.\n        }\n        return\n      }\n      if (topic !== CALL_CAPTION_TOPIC || !callKey) return\n      const identity = participant?.identity ?? participantIdentity\n      if (!identity || identity === myIdentity) return\n      void decodeCaptionPacket(payload, callKey).then((packet) => {\n        // A caption speaks for its sender only.\n        if (!packet || packet.identity !== identity) return\n        const name = participant?.name || packet.name || identity\n        const t = Math.min(packet.t, Date.now())\n        addCaption({\n          segmentId: packet.segment_id,\n          identity,\n          name,\n          text: packet.text,\n          t,\n          mine: false,\n          receivedAt: Date.now(),\n        })\n        persist(\n          {\n            segmentId: packet.segment_id,\n            text: packet.text,\n            speakerIdentity: identity,\n            speakerName: name,\n            startedAt: new Date(t).toISOString(),\n          },\n          packet.proxy === true\n        )\n      })\n    }\n    room.on(RoomEvent.DataReceived, onData)\n    return () => {\n      room.off(RoomEvent.DataReceived, onData)\n    }\n  }, [room, callKey, myIdentity, addCaption, applyState, persist])\n\n  const handleSegment = useCallback(\n    async (segment: AudioSegment) => {\n      // While sending, or the segment that was open when sending stopped (transcription off, my\n      // transcription muted, hang-up): flushed then, still sent within the server's grace.\n      // Anything that started after the stop is dropped.\n      if (\n        !callKey ||\n        !mayStillSend({\n          sending: shouldSendRef.current,\n          stoppedAt: sendStoppedAtRef.current,\n          segmentStartedAt: segment.startedAt,\n          now: Date.now(),\n        })\n      ) {\n        return\n      }\n      const segmentId = newSegmentId()\n      const startedAt = new Date(segment.startedAt).toISOString()\n      let text: string\n      try {\n        const result = await arbi.calls.transcription.transcribe(callExtId, {\n          audio: segment.blob,\n          segmentId,\n          startedAt,\n          linkVersion,\n          prompt: continuityPrompt(myPreviousText.current),\n        })\n        text = result.text.trim()\n      } catch (err) {\n        if (err instanceof CallApiError && err.status === 409) {\n          applyState({ on: false, by_identity: null, by_name: null })\n        }\n        console.warn('[calls] could not transcribe a segment', err)\n        return\n      }\n      if (!text) return\n      myPreviousText.current = `${myPreviousText.current} ${text}`.slice(-PROMPT_HISTORY_CHARS)\n      // Stored (and shown to others) under my real name; my own caption reads \"You\" on screen.\n      const name = storedSpeakerName(localParticipant.name, myProfileName, myIdentity)\n      const proxy = !selfPosts.current\n      addCaption({\n        segmentId,\n        identity: myIdentity,\n        name,\n        text,\n        t: segment.startedAt,\n        mine: true,\n        receivedAt: Date.now(),\n      })\n      try {\n        await localParticipant.publishData(\n          await encodeCaptionPacket(\n            {\n              v: 1,\n              segment_id: segmentId,\n              text,\n              identity: myIdentity,\n              name,\n              t: segment.startedAt,\n              ...(proxy ? { proxy: true } : {}),\n            },\n            callKey\n          ),\n          { reliable: true, topic: CALL_CAPTION_TOPIC }\n        )\n      } catch (err) {\n        console.warn('[calls] could not broadcast a caption', err)\n      }\n      if (!proxy) {\n        persist(\n          { segmentId, text, speakerIdentity: myIdentity, speakerName: name, startedAt },\n          false\n        )\n      }\n    },\n    [\n      callExtId,\n      callKey,\n      linkVersion,\n      localParticipant,\n      myIdentity,\n      myProfileName,\n      addCaption,\n      applyState,\n      persist,\n    ]\n  )\n\n  const startedByMe = !!state?.on && state.by_identity === myIdentity\n  const canToggle = available && (isCreator || (!!creatorExtId && creatorExtId === myIdentity))\n\n  const toggle = useCallback(async () => {\n    if (!canToggle) return\n    const next = !on\n    setBusy(true)\n    try {\n      const answer = await arbi.calls.transcription.set(callExtId, next)\n      applyState(\n        answer ??\n          (next\n            ? { on: true, by_identity: myIdentity, by_name: localParticipant.name || null }\n            : { on: false, by_identity: null, by_name: null })\n      )\n    } catch (err) {\n      notify.error(`Could not turn transcription ${next ? 'on' : 'off'}: ${(err as Error).message}`)\n    } finally {\n      setBusy(false)\n    }\n  }, [on, canToggle, callExtId, myIdentity, localParticipant, applyState])\n\n  return useMemo(\n    () => ({\n      available,\n      on,\n      startedByName: on ? (state?.by_name ?? null) : null,\n      startedByMe,\n      canToggle,\n      busy,\n      muted,\n      setMuted,\n      toggle,\n      setIndicatorShown,\n      shouldSend,\n      captions,\n      handleSegment,\n    }),\n    [\n      available,\n      on,\n      state,\n      startedByMe,\n      canToggle,\n      busy,\n      muted,\n      toggle,\n      shouldSend,\n      captions,\n      handleSegment,\n    ]\n  )\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/calls/livekit/useHostMuteNotice.js

@@ -0,0 +1,29 @@
+import { useEffect } from "react";
+import { RoomEvent } from "livekit-client";
+import { useRoomContext } from "@livekit/components-react";
+import { notify } from "../../notifications/notify-store.js";
+import { CALL_MODERATION_TOPIC, createMutedNotifier, mutedNoticeFromPacket, onCallEvent } from "../index.js";
+function useHostMuteNotice(callExtId) {
+  const room = useRoomContext();
+  useEffect(() => {
+    const notifyMuted = createMutedNotifier((text) => notify.info(text));
+    const onData = (payload, participant, _kind, topic, _encryption, participantIdentity) => {
+      if (topic !== CALL_MODERATION_TOPIC) return;
+      if (participant || participantIdentity) return;
+      const notice = mutedNoticeFromPacket(payload);
+      if (notice) notifyMuted(notice);
+    };
+    room.on(RoomEvent.DataReceived, onData);
+    const offWs = onCallEvent("call.muted", (message) => {
+      if (message.callExtId === callExtId) notifyMuted(message);
+    });
+    return () => {
+      room.off(RoomEvent.DataReceived, onData);
+      offWs();
+    };
+  }, [room, callExtId]);
+}
+export {
+  useHostMuteNotice
+};
+//# sourceMappingURL=useHostMuteNotice.js.map

package/dist/calls/livekit/useHostMuteNotice.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/calls/livekit/useHostMuteNotice.ts"],
+  "sourcesContent": ["/**\n * Inside <LiveKitRoom>: tell me when the host muted my mic or turned off my camera. Listens to the\n * server's `arbi.moderation` data messages (a packet sent by a participant is ignored \u2014 only the\n * server may moderate) and to WS `call.muted` for this call; one toast per mute.\n */\n\nimport { useEffect } from 'react'\nimport { RoomEvent, type RemoteParticipant } from 'livekit-client'\nimport { useRoomContext } from '@livekit/components-react'\nimport { notify } from '../../notifications/notify-store'\nimport { CALL_MODERATION_TOPIC, createMutedNotifier, mutedNoticeFromPacket, onCallEvent } from '..'\n\nexport function useHostMuteNotice(callExtId: string): void {\n  const room = useRoomContext()\n  useEffect(() => {\n    const notifyMuted = createMutedNotifier((text) => notify.info(text))\n    const onData = (\n      payload: Uint8Array,\n      participant?: RemoteParticipant,\n      _kind?: unknown,\n      topic?: string,\n      _encryption?: unknown,\n      participantIdentity?: string\n    ) => {\n      if (topic !== CALL_MODERATION_TOPIC) return\n      // Only the server moderates: a packet from a participant is ignored.\n      if (participant || participantIdentity) return\n      const notice = mutedNoticeFromPacket(payload)\n      if (notice) notifyMuted(notice)\n    }\n    room.on(RoomEvent.DataReceived, onData)\n    const offWs = onCallEvent('call.muted', (message) => {\n      if (message.callExtId === callExtId) notifyMuted(message)\n    })\n    return () => {\n      room.off(RoomEvent.DataReceived, onData)\n      offWs()\n    }\n  }, [room, callExtId])\n}\n"],
+  "mappings": "AAMA,SAAS,iBAAiB;AAC1B,SAAS,iBAAyC;AAClD,SAAS,sBAAsB;AAC/B,SAAS,cAAc;AACvB,SAAS,uBAAuB,qBAAqB,uBAAuB,mBAAmB;AAExF,SAAS,kBAAkB,WAAyB;AACzD,QAAM,OAAO,eAAe;AAC5B,YAAU,MAAM;AACd,UAAM,cAAc,oBAAoB,CAAC,SAAS,OAAO,KAAK,IAAI,CAAC;AACnE,UAAM,SAAS,CACb,SACA,aACA,OACA,OACA,aACA,wBACG;AACH,UAAI,UAAU,sBAAuB;AAErC,UAAI,eAAe,oBAAqB;AACxC,YAAM,SAAS,sBAAsB,OAAO;AAC5C,UAAI,OAAQ,aAAY,MAAM;AAAA,IAChC;AACA,SAAK,GAAG,UAAU,cAAc,MAAM;AACtC,UAAM,QAAQ,YAAY,cAAc,CAAC,YAAY;AACnD,UAAI,QAAQ,cAAc,UAAW,aAAY,OAAO;AAAA,IAC1D,CAAC;AACD,WAAO,MAAM;AACX,WAAK,IAAI,UAAU,cAAc,MAAM;AACvC,YAAM;AAAA,IACR;AAAA,EACF,GAAG,CAAC,MAAM,SAAS,CAAC;AACtB;",
+  "names": []
+}

package/dist/calls/livekit/useInCallChat.js

@@ -0,0 +1,161 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { RoomEvent } from "livekit-client";
+import { useLocalParticipant, useRoomContext } from "@livekit/components-react";
+import { notify } from "../../notifications/notify-store.js";
+import {
+  CALL_CHAT_MAX_CHARS,
+  CALL_CHAT_TOPIC,
+  decodeCallChatPacket,
+  encodeCallChatPacket,
+  loadMeetingHistory,
+  mergeChatLines,
+  newPacketId,
+  persistMeetingMessage,
+  ensureMeetingChat
+} from "../index.js";
+import { useQueryClient } from "@tanstack/react-query";
+import { useArbi } from "../../useArbi.js";
+import { useArbiHost } from "../../host/config.js";
+function useInCallChat({
+  callExtId,
+  callKey,
+  open,
+  readOnly = false,
+  persist = true
+}) {
+  const room = useRoomContext();
+  const { localParticipant } = useLocalParticipant();
+  const myIdentity = localParticipant.identity;
+  const arbi = useArbi();
+  const queryClient = useQueryClient();
+  const openMeetingChat = useArbiHost().calls?.openMeetingChat;
+  const signedIn = arbi.isLoggedIn;
+  const persists = !!callKey && signedIn && !readOnly && persist;
+  const [live, setLive] = useState([]);
+  const [history, setHistory] = useState([]);
+  const [historyLoading, setHistoryLoading] = useState(false);
+  const [historyError, setHistoryError] = useState(null);
+  const [meetingChat, setMeetingChat] = useState(null);
+  const [unread, setUnread] = useState(0);
+  const openRef = useRef(open);
+  openRef.current = open;
+  const historyRequested = useRef(false);
+  const seen = useRef(/* @__PURE__ */ new Set());
+  useEffect(() => {
+    if (open) setUnread(0);
+  }, [open]);
+  useEffect(() => {
+    if (!callKey) return;
+    const onData = (payload, participant, _kind, topic, _encryption, participantIdentity) => {
+      if (topic !== CALL_CHAT_TOPIC) return;
+      const identity = participant?.identity ?? participantIdentity;
+      if (!identity || identity === myIdentity) return;
+      void decodeCallChatPacket(payload, callKey).then((packet) => {
+        if (!packet) return;
+        const key = `${identity}:${packet.id}`;
+        if (seen.current.has(key)) return;
+        seen.current.add(key);
+        setLive((prev) => [
+          ...prev,
+          {
+            id: packet.id,
+            senderIdentity: identity,
+            senderName: participant?.name || identity,
+            text: packet.text,
+            at: Math.min(packet.at, Date.now()),
+            mine: false,
+            status: "live"
+          }
+        ]);
+        if (!openRef.current) setUnread((n) => n + 1);
+      });
+    };
+    room.on(RoomEvent.DataReceived, onData);
+    return () => {
+      room.off(RoomEvent.DataReceived, onData);
+    };
+  }, [room, callKey, myIdentity]);
+  const canRead = !!callKey && signedIn && persist;
+  useEffect(() => {
+    if (!open || !canRead || historyRequested.current) return;
+    historyRequested.current = true;
+    setHistoryLoading(true);
+    loadMeetingHistory(arbi, queryClient, callExtId).then((result) => {
+      if (!result) return;
+      setMeetingChat(result.ref);
+      setHistory(result.messages);
+    }).catch((err) => {
+      console.warn("[calls] could not load the meeting chat", err);
+      setHistoryError("Earlier messages could not be loaded.");
+    }).finally(() => setHistoryLoading(false));
+  }, [open, canRead, callExtId]);
+  const send = useCallback(
+    async (raw) => {
+      const text = raw.trim().slice(0, CALL_CHAT_MAX_CHARS);
+      if (!text || !callKey || readOnly) return;
+      const id = newPacketId();
+      const at = Date.now();
+      await localParticipant.publishData(
+        await encodeCallChatPacket({ v: 1, id, text, at }, callKey),
+        { reliable: true, topic: CALL_CHAT_TOPIC }
+      );
+      setLive((prev) => [
+        ...prev,
+        {
+          id,
+          senderIdentity: myIdentity,
+          senderName: localParticipant.name || "You",
+          text,
+          at,
+          mine: true,
+          status: persists ? "saving" : "live"
+        }
+      ]);
+      if (!persists) return;
+      const mark = (status) => setLive(
+        (prev) => prev.map((l) => l.id === id && l.senderIdentity === myIdentity ? { ...l, status } : l)
+      );
+      try {
+        setMeetingChat(await persistMeetingMessage(arbi, queryClient, callExtId, callKey, text));
+        mark("saved");
+      } catch (err) {
+        console.warn("[calls] could not keep the message in the meeting chat", err);
+        mark("unsaved");
+      }
+    },
+    [callKey, callExtId, localParticipant, myIdentity, persists, readOnly]
+  );
+  const openMeeting = useCallback(async () => {
+    if (!callKey) return;
+    try {
+      const ref = meetingChat ?? await ensureMeetingChat(arbi, queryClient, callExtId, callKey);
+      setMeetingChat(ref);
+      openMeetingChat?.(ref);
+    } catch (err) {
+      notify.error(`Could not open the meeting chat: ${err.message}`);
+    }
+  }, [callExtId, callKey, meetingChat]);
+  const lines = useMemo(
+    () => mergeChatLines(history, live, {
+      myIdentity,
+      nameOf: (identity) => identity === myIdentity ? localParticipant.name || "You" : room.remoteParticipants.get(identity)?.name || null
+    }),
+    [history, live, myIdentity, localParticipant, room]
+  );
+  return {
+    lines,
+    unread,
+    available: !!callKey,
+    persists,
+    readOnly,
+    historyLoading,
+    historyError,
+    meetingChat,
+    send,
+    openMeeting
+  };
+}
+export {
+  useInCallChat
+};
+//# sourceMappingURL=useInCallChat.js.map

package/dist/calls/livekit/useInCallChat.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/calls/livekit/useInCallChat.ts"],
+  "sourcesContent": ["/**\n * The in-call chat state of a LiveKit room: live data-channel messages (encrypted under the call\n * key), persisted to the meeting chat for signed-in members. Must run inside <LiveKitRoom>. A\n * webinar's live chat (when its audience may chat) is this; with no call key it stays inert.\n */\n\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react'\nimport { RoomEvent, type RemoteParticipant } from 'livekit-client'\nimport { useLocalParticipant, useRoomContext } from '@livekit/components-react'\nimport { notify } from '../../notifications/notify-store'\nimport {\n  CALL_CHAT_MAX_CHARS,\n  CALL_CHAT_TOPIC,\n  decodeCallChatPacket,\n  encodeCallChatPacket,\n  loadMeetingHistory,\n  mergeChatLines,\n  newPacketId,\n  persistMeetingMessage,\n  type CallChatLine,\n  type HistoryMessage,\n  ensureMeetingChat,\n  type MeetingChatRef,\n} from '..'\nimport { useQueryClient } from '@tanstack/react-query'\nimport { useArbi } from '../../useArbi'\nimport { useArbiHost } from '../../host/config'\n\nexport interface InCallChatState {\n  lines: CallChatLine[]\n  /** Messages from others received while the panel was closed. */\n  unread: number\n  /** False without a call key: nothing could be encrypted, so chat is off. */\n  available: boolean\n  /** My messages are kept in the meeting chat. */\n  persists: boolean\n  /** A workspace guest on a thread call: the meeting chat is read-only (no composer). */\n  readOnly: boolean\n  historyLoading: boolean\n  historyError: string | null\n  meetingChat: MeetingChatRef | null\n  send(text: string): Promise<void>\n  openMeeting(): Promise<void>\n}\n\n/** The room's chat state. `open` is whether the panel is showing (it clears unread). */\nexport function useInCallChat({\n  callExtId,\n  callKey,\n  open,\n  readOnly = false,\n  persist = true,\n}: {\n  callExtId: string\n  callKey: Uint8Array | null\n  open: boolean\n  /** Workspace guest on a thread call: read the meeting chat, never post. */\n  readOnly?: boolean\n  /**\n   * Keep messages in (and read history from) the meeting chat. Off for a webinar's attendees: they\n   * are not its members, so their chat is live only.\n   */\n  persist?: boolean\n}): InCallChatState {\n  const room = useRoomContext()\n  const { localParticipant } = useLocalParticipant()\n  const myIdentity = localParticipant.identity\n  const arbi = useArbi()\n  const queryClient = useQueryClient()\n  const openMeetingChat = useArbiHost().calls?.openMeetingChat\n  const signedIn = arbi.isLoggedIn\n  const persists = !!callKey && signedIn && !readOnly && persist\n\n  const [live, setLive] = useState<CallChatLine[]>([])\n  const [history, setHistory] = useState<HistoryMessage[]>([])\n  const [historyLoading, setHistoryLoading] = useState(false)\n  const [historyError, setHistoryError] = useState<string | null>(null)\n  const [meetingChat, setMeetingChat] = useState<MeetingChatRef | null>(null)\n  const [unread, setUnread] = useState(0)\n  const openRef = useRef(open)\n  openRef.current = open\n  const historyRequested = useRef(false)\n  const seen = useRef(new Set<string>())\n\n  useEffect(() => {\n    if (open) setUnread(0)\n  }, [open])\n\n  // Receive: open each packet with K; drop anything that is not ours.\n  useEffect(() => {\n    if (!callKey) return\n    const onData = (\n      payload: Uint8Array,\n      participant?: RemoteParticipant,\n      _kind?: unknown,\n      topic?: string,\n      _encryption?: unknown,\n      participantIdentity?: string\n    ) => {\n      if (topic !== CALL_CHAT_TOPIC) return\n      const identity = participant?.identity ?? participantIdentity\n      if (!identity || identity === myIdentity) return\n      void decodeCallChatPacket(payload, callKey).then((packet) => {\n        if (!packet) return\n        // A reliable packet can arrive twice (reconnect): count and show it once.\n        const key = `${identity}:${packet.id}`\n        if (seen.current.has(key)) return\n        seen.current.add(key)\n        setLive((prev) => [\n          ...prev,\n          {\n            id: packet.id,\n            senderIdentity: identity,\n            senderName: participant?.name || identity,\n            text: packet.text,\n            at: Math.min(packet.at, Date.now()),\n            mine: false,\n            status: 'live',\n          },\n        ])\n        if (!openRef.current) setUnread((n) => n + 1)\n      })\n    }\n    room.on(RoomEvent.DataReceived, onData)\n    return () => {\n      room.off(RoomEvent.DataReceived, onData)\n    }\n  }, [room, callKey, myIdentity])\n\n  // History: once, the first time the panel opens. Never creates the meeting chat.\n  const canRead = !!callKey && signedIn && persist\n  useEffect(() => {\n    if (!open || !canRead || historyRequested.current) return\n    historyRequested.current = true\n    setHistoryLoading(true)\n    loadMeetingHistory(arbi, queryClient, callExtId)\n      .then((result) => {\n        if (!result) return\n        setMeetingChat(result.ref)\n        setHistory(result.messages)\n      })\n      .catch((err: unknown) => {\n        console.warn('[calls] could not load the meeting chat', err)\n        setHistoryError('Earlier messages could not be loaded.')\n      })\n      .finally(() => setHistoryLoading(false))\n  }, [open, canRead, callExtId])\n\n  const send = useCallback(\n    async (raw: string) => {\n      const text = raw.trim().slice(0, CALL_CHAT_MAX_CHARS)\n      if (!text || !callKey || readOnly) return\n      const id = newPacketId()\n      const at = Date.now()\n      await localParticipant.publishData(\n        await encodeCallChatPacket({ v: 1, id, text, at }, callKey),\n        { reliable: true, topic: CALL_CHAT_TOPIC }\n      )\n      setLive((prev) => [\n        ...prev,\n        {\n          id,\n          senderIdentity: myIdentity,\n          senderName: localParticipant.name || 'You',\n          text,\n          at,\n          mine: true,\n          status: persists ? 'saving' : 'live',\n        },\n      ])\n      if (!persists) return\n      const mark = (status: CallChatLine['status']) =>\n        setLive((prev) =>\n          prev.map((l) => (l.id === id && l.senderIdentity === myIdentity ? { ...l, status } : l))\n        )\n      try {\n        setMeetingChat(await persistMeetingMessage(arbi, queryClient, callExtId, callKey, text))\n        mark('saved')\n      } catch (err) {\n        console.warn('[calls] could not keep the message in the meeting chat', err)\n        mark('unsaved')\n      }\n    },\n    [callKey, callExtId, localParticipant, myIdentity, persists, readOnly]\n  )\n\n  const openMeeting = useCallback(async () => {\n    if (!callKey) return\n    try {\n      const ref = meetingChat ?? (await ensureMeetingChat(arbi, queryClient, callExtId, callKey))\n      setMeetingChat(ref)\n      openMeetingChat?.(ref)\n    } catch (err) {\n      notify.error(`Could not open the meeting chat: ${(err as Error).message}`)\n    }\n  }, [callExtId, callKey, meetingChat])\n\n  const lines = useMemo(\n    () =>\n      mergeChatLines(history, live, {\n        myIdentity,\n        nameOf: (identity) =>\n          identity === myIdentity\n            ? localParticipant.name || 'You'\n            : room.remoteParticipants.get(identity)?.name || null,\n      }),\n    [history, live, myIdentity, localParticipant, room]\n  )\n\n  return {\n    lines,\n    unread,\n    available: !!callKey,\n    persists,\n    readOnly,\n    historyLoading,\n    historyError,\n    meetingChat,\n    send,\n    openMeeting,\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}