@arbidocs/react 0.5.110 → 0.5.112

package/dist/calls/livekit/useWebinar.js

@@ -0,0 +1,239 @@
+import { useArbi } from "../../useArbi.js";
+import { onCallEvent } from "../index.js";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { RoomEvent } from "livekit-client";
+import {
+  useLocalParticipant,
+  useLocalParticipantPermissions,
+  useRoomContext
+} from "@livekit/components-react";
+import { calls } from "@arbidocs/sdk/browser";
+import { notify } from "../../notifications/notify-store.js";
+import {
+  CALL_WEBINAR_TOPIC,
+  markRejoining,
+  openQuestion,
+  parseWebinarPacket,
+  sealQuestionText
+} from "../webinar.js";
+const DEMOTE_REJOIN_FALLBACK_MS = 5e3;
+function failed(what) {
+  return (err) => {
+    notify.error(`Could not ${what}: ${err?.message ?? "unknown error"}`);
+    throw err;
+  };
+}
+function useWebinar({
+  role: roleHint = null,
+  callExtId,
+  linkVersion = null,
+  callKey
+}) {
+  const arbi = useArbi();
+  const webinarApi = useCallback(() => arbi.calls.webinar, [arbi]);
+  const enabled = !!roleHint;
+  const room = useRoomContext();
+  const { localParticipant } = useLocalParticipant();
+  const myIdentity = localParticipant.identity;
+  const permissions = useLocalParticipantPermissions();
+  const [state, setState] = useState(null);
+  const [questions, setQuestions] = useState([]);
+  const [stageCheck, setStageCheck] = useState(false);
+  const stateRead = useRef(0);
+  const questionsRead = useRef(0);
+  const refresh = useCallback(async () => {
+    if (!enabled) return;
+    const n = ++stateRead.current;
+    try {
+      const next = await webinarApi().get(callExtId, linkVersion);
+      if (n === stateRead.current) setState(next);
+    } catch (err) {
+      console.warn("[calls] could not read the webinar state", err);
+    }
+  }, [enabled, callExtId, linkVersion]);
+  const refreshQuestions = useCallback(async () => {
+    if (!enabled || !callKey) return;
+    const n = ++questionsRead.current;
+    try {
+      const rows = await webinarApi().questions.list(callExtId, linkVersion);
+      const opened = await Promise.all(rows.map((q) => openQuestion(q, callKey)));
+      if (n === questionsRead.current) setQuestions(opened);
+    } catch (err) {
+      console.warn("[calls] could not load the questions", err);
+    }
+  }, [enabled, callExtId, linkVersion, callKey]);
+  useEffect(() => {
+    void refresh();
+    void refreshQuestions();
+  }, [refresh, refreshQuestions]);
+  useEffect(() => {
+    if (!enabled) return;
+    return onCallEvent("call.webinar", (m) => {
+      if (m.call_ext_id !== callExtId) return;
+      setState((s) => s ? { ...s, live: m.live, chat: m.chat } : s);
+    });
+  }, [enabled, callExtId]);
+  const fallback = useRef(null);
+  useEffect(() => {
+    if (!enabled) return;
+    const onData = (payload, participant, _kind, topic, _encryption, participantIdentity) => {
+      if (topic !== CALL_WEBINAR_TOPIC) return;
+      const packet = parseWebinarPacket(payload, !!(participant || participantIdentity));
+      if (!packet) return;
+      switch (packet.type) {
+        case "state":
+          setState(
+            (s) => s ? { ...s, live: packet.live, live_at: packet.live_at, chat: packet.chat } : s
+          );
+          void refresh();
+          return;
+        case "hands":
+          setState((s) => s ? { ...s, hands: packet.hands } : s);
+          return;
+        case "questions":
+          void refreshQuestions();
+          return;
+        case "promoted":
+          setStageCheck(true);
+          void refresh();
+          return;
+        case "demoted":
+          setStageCheck(false);
+          markRejoining(callExtId);
+          if (fallback.current) clearTimeout(fallback.current);
+          fallback.current = setTimeout(() => void room.disconnect(), DEMOTE_REJOIN_FALLBACK_MS);
+          return;
+      }
+    };
+    room.on(RoomEvent.DataReceived, onData);
+    return () => {
+      room.off(RoomEvent.DataReceived, onData);
+    };
+  }, [enabled, room, callExtId, refresh, refreshQuestions]);
+  useEffect(
+    () => () => {
+      if (fallback.current) clearTimeout(fallback.current);
+    },
+    []
+  );
+  const role = enabled ? state?.my_role ?? null : null;
+  const onStage = !enabled || (permissions ? permissions.canPublish : state ? state.on_stage : roleHint !== "attendee");
+  const patch = useCallback(
+    async (body, what) => {
+      const next = await webinarApi().update(callExtId, body, linkVersion).catch(failed(what));
+      setState(next);
+    },
+    [callExtId, linkVersion]
+  );
+  const stepDown = useCallback(async () => {
+    markRejoining(callExtId);
+    setStageCheck(false);
+    try {
+      await webinarApi().demote(callExtId, myIdentity, linkVersion);
+    } catch (err) {
+      markRejoining(callExtId, false);
+      failed("leave the stage")(err);
+    }
+  }, [callExtId, myIdentity, linkVersion]);
+  const joinStage = useCallback(
+    async (choices) => {
+      const lp = room.localParticipant;
+      try {
+        await lp.setMicrophoneEnabled(
+          choices.audioEnabled,
+          choices.audioDeviceId ? { deviceId: choices.audioDeviceId } : void 0
+        );
+        await lp.setCameraEnabled(
+          choices.videoEnabled,
+          choices.videoDeviceId ? { deviceId: choices.videoDeviceId } : void 0
+        );
+      } catch (err) {
+        failed("turn on your microphone or camera")(err);
+      }
+      setStageCheck(false);
+    },
+    [room]
+  );
+  const questionAction = useCallback(
+    async (run, what) => {
+      await run().catch(failed(what));
+      void refreshQuestions();
+    },
+    [refreshQuestions]
+  );
+  return useMemo(
+    () => ({
+      enabled,
+      role,
+      moderator: !!role && calls.WEBINAR_MODERATORS.has(role),
+      team: !!role && calls.WEBINAR_TEAM.has(role),
+      live: !!state?.live,
+      chat: state?.chat ?? "panelists",
+      onStage,
+      handRaised: !!state?.hand_raised,
+      hands: state?.hands ?? [],
+      attendees: state?.attendees ?? [],
+      questions,
+      stageCheck: enabled && stageCheck,
+      refresh,
+      goLive: () => patch({ live: true }, "go live"),
+      end: () => patch({ live: false }, "end the webinar"),
+      setChat: (chat) => patch({ chat }, "change who can chat"),
+      setHand: async (raised) => {
+        const next = await webinarApi().setHand(callExtId, raised, linkVersion).catch(failed(raised ? "raise your hand" : "lower your hand"));
+        setState(next);
+      },
+      promote: (identity) => webinarApi().promote(callExtId, identity, linkVersion).catch(failed("bring them on stage")).then(refresh),
+      demote: (identity) => webinarApi().demote(callExtId, identity, linkVersion).catch(failed("move them to the audience")).then(refresh),
+      stepDown,
+      joinStage,
+      ask: (text) => questionAction(async () => {
+        if (!callKey) throw new Error("This call has no key.");
+        await webinarApi().questions.ask(
+          callExtId,
+          await sealQuestionText(text, callKey),
+          linkVersion
+        );
+      }, "ask the question"),
+      vote: (id, up) => questionAction(() => webinarApi().questions.vote(callExtId, id, up, linkVersion), "vote"),
+      setQuestionStatus: (id, status) => questionAction(
+        () => webinarApi().questions.update(callExtId, id, { status }, linkVersion),
+        "update the question"
+      ),
+      answer: (id, text) => questionAction(async () => {
+        if (!callKey) throw new Error("This call has no key.");
+        await webinarApi().questions.update(
+          callExtId,
+          id,
+          { answer: await sealQuestionText(text, callKey) },
+          linkVersion
+        );
+      }, "answer the question"),
+      removeQuestion: (id) => questionAction(
+        () => webinarApi().questions.delete(callExtId, id, linkVersion),
+        "delete the question"
+      )
+    }),
+    [
+      enabled,
+      role,
+      state,
+      onStage,
+      questions,
+      stageCheck,
+      refresh,
+      patch,
+      callExtId,
+      linkVersion,
+      callKey,
+      stepDown,
+      joinStage,
+      questionAction
+    ]
+  );
+}
+export {
+  DEMOTE_REJOIN_FALLBACK_MS,
+  useWebinar
+};
+//# sourceMappingURL=useWebinar.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/calls/livekit/useWebinar.ts"],
+  "sourcesContent": ["/**\n * The webinar state of a LiveKit room (ARBI `docs/webinars-plan.md`). Must run inside\n * <LiveKitRoom>; with `enabled` false (an ordinary call) it does nothing.\n *\n * - The state (live, chat, my role and stage, the moderators' hands and audience) comes from\n *   `GET /webinar`, then from the server's `arbi.webinar` data messages and WS `call.webinar`.\n *   Only server-sent packets count: one from a participant is ignored.\n * - Whether I am on stage is the room's own word (my publish permission), so it flips the moment\n *   the server promotes or demotes me.\n * - `promoted`: the \"You're on stage\" device check opens; joining it publishes my microphone (and\n *   camera) with the devices I picked. `demoted` (and stepping down myself): the server removes me\n *   from the room and the dock joins me again as the audience (`webinar-join.ts`).\n * - Q&A text is end-to-end under the call key K (`webinar-packets.ts`).\n */\n\nimport { useArbi } from '../../useArbi'\nimport { onCallEvent, type JoinChoices } from '..'\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react'\nimport { RoomEvent, type RemoteParticipant } from 'livekit-client'\nimport {\n  useLocalParticipant,\n  useLocalParticipantPermissions,\n  useRoomContext,\n} from '@livekit/components-react'\nimport { calls } from '@arbidocs/sdk/browser'\nimport { notify } from '../../notifications/notify-store'\nimport {\n  CALL_WEBINAR_TOPIC,\n  markRejoining,\n  openQuestion,\n  parseWebinarPacket,\n  sealQuestionText,\n  type OpenQuestion,\n} from '../webinar'\n\n/** After `demoted`, the server removes me at once; if it has not after this, I leave the room myself. */\nexport const DEMOTE_REJOIN_FALLBACK_MS = 5_000\n\nexport type WebinarHandRow = NonNullable<calls.WebinarState['hands']>[number]\nexport type WebinarAttendeeRow = NonNullable<calls.WebinarState['attendees']>[number]\n\nexport interface WebinarControl {\n  /** The call is a webinar (everything below is inert otherwise). */\n  enabled: boolean\n  role: calls.WebinarRole | null\n  /** Host or co-host: go live / end, chat setting, hands and audience, promote / demote. */\n  moderator: boolean\n  /** Host, co-host or panelist: moderates Q&A. */\n  team: boolean\n  live: boolean\n  chat: calls.WebinarChat\n  /** I may publish: on stage (always true outside a webinar). */\n  onStage: boolean\n  handRaised: boolean\n  /** Moderators: the raised hands, oldest first. */\n  hands: WebinarHandRow[]\n  /** Moderators: everyone in the room (hidden audience included). */\n  attendees: WebinarAttendeeRow[]\n  questions: OpenQuestion[]\n  /** A moderator brought me on stage: the device check is open. */\n  stageCheck: boolean\n  refresh(): Promise<void>\n  goLive(): Promise<void>\n  end(): Promise<void>\n  setChat(chat: calls.WebinarChat): Promise<void>\n  setHand(raised: boolean): Promise<void>\n  promote(identity: string): Promise<void>\n  demote(identity: string): Promise<void>\n  /** Leave the stage myself (also \"Stay in audience\" on the device check). */\n  stepDown(): Promise<void>\n  /** Go on stage with the devices picked in the check. */\n  joinStage(choices: JoinChoices): Promise<void>\n  ask(text: string): Promise<void>\n  vote(questionId: string, up: boolean): Promise<void>\n  setQuestionStatus(questionId: string, status: calls.CallQuestionStatus): Promise<void>\n  answer(questionId: string, text: string): Promise<void>\n  removeQuestion(questionId: string): Promise<void>\n}\n\n/** Toast a failed action, then reject (the blocks keep their state on a rejection). */\nfunction failed(what: string) {\n  return (err: unknown): never => {\n    notify.error(`Could not ${what}: ${(err as Error)?.message ?? 'unknown error'}`)\n    throw err\n  }\n}\n\nexport function useWebinar({\n  role: roleHint = null,\n  callExtId,\n  linkVersion = null,\n  callKey,\n}: {\n  /** My role from the call (null: not a webinar). Until the room says, the team counts as on stage. */\n  role?: calls.WebinarRole | null\n  callExtId: string\n  linkVersion?: number | null\n  callKey: Uint8Array | null\n}): WebinarControl {\n  const arbi = useArbi()\n  const webinarApi = useCallback(() => arbi.calls.webinar, [arbi])\n  const enabled = !!roleHint\n  const room = useRoomContext()\n  const { localParticipant } = useLocalParticipant()\n  const myIdentity = localParticipant.identity\n  const permissions = useLocalParticipantPermissions()\n  const [state, setState] = useState<calls.WebinarState | null>(null)\n  const [questions, setQuestions] = useState<OpenQuestion[]>([])\n  const [stageCheck, setStageCheck] = useState(false)\n  const stateRead = useRef(0)\n  const questionsRead = useRef(0)\n\n  const refresh = useCallback(async () => {\n    if (!enabled) return\n    const n = ++stateRead.current\n    try {\n      const next = await webinarApi().get(callExtId, linkVersion)\n      if (n === stateRead.current) setState(next)\n    } catch (err) {\n      console.warn('[calls] could not read the webinar state', err)\n    }\n  }, [enabled, callExtId, linkVersion])\n\n  const refreshQuestions = useCallback(async () => {\n    if (!enabled || !callKey) return\n    const n = ++questionsRead.current\n    try {\n      const rows = await webinarApi().questions.list(callExtId, linkVersion)\n      const opened = await Promise.all(rows.map((q) => openQuestion(q, callKey)))\n      if (n === questionsRead.current) setQuestions(opened)\n    } catch (err) {\n      console.warn('[calls] could not load the questions', err)\n    }\n  }, [enabled, callExtId, linkVersion, callKey])\n\n  useEffect(() => {\n    void refresh()\n    void refreshQuestions()\n  }, [refresh, refreshQuestions])\n\n  // Live / ended / chat setting, over WS (the room's own packet says the same).\n  useEffect(() => {\n    if (!enabled) return\n    return onCallEvent('call.webinar', (m) => {\n      if (m.call_ext_id !== callExtId) return\n      setState((s) => (s ? { ...s, live: m.live, chat: m.chat } : s))\n    })\n  }, [enabled, callExtId])\n\n  // The server's `arbi.webinar` messages.\n  const fallback = useRef<ReturnType<typeof setTimeout> | null>(null)\n  useEffect(() => {\n    if (!enabled) 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_WEBINAR_TOPIC) return\n      const packet = parseWebinarPacket(payload, !!(participant || participantIdentity))\n      if (!packet) return\n      switch (packet.type) {\n        case 'state':\n          setState((s) =>\n            s ? { ...s, live: packet.live, live_at: packet.live_at, chat: packet.chat } : s\n          )\n          // Roles may have changed too: read them again.\n          void refresh()\n          return\n        case 'hands':\n          setState((s) => (s ? { ...s, hands: packet.hands } : s))\n          return\n        case 'questions':\n          void refreshQuestions()\n          return\n        case 'promoted':\n          setStageCheck(true)\n          void refresh()\n          return\n        case 'demoted':\n          setStageCheck(false)\n          // The server removes me from the room now; the dock then joins me again as the audience.\n          markRejoining(callExtId)\n          if (fallback.current) clearTimeout(fallback.current)\n          fallback.current = setTimeout(() => void room.disconnect(), DEMOTE_REJOIN_FALLBACK_MS)\n          return\n      }\n    }\n    room.on(RoomEvent.DataReceived, onData)\n    return () => {\n      room.off(RoomEvent.DataReceived, onData)\n    }\n  }, [enabled, room, callExtId, refresh, refreshQuestions])\n  useEffect(\n    () => () => {\n      if (fallback.current) clearTimeout(fallback.current)\n    },\n    []\n  )\n\n  const role = enabled ? (state?.my_role ?? null) : null\n  // The room's word once connected, else the server's, else my role: the team starts on stage, so\n  // its UI (and the dock's placement) never flickers through the audience viewer while joining.\n  const onStage =\n    !enabled ||\n    (permissions ? permissions.canPublish : state ? state.on_stage : roleHint !== 'attendee')\n\n  const patch = useCallback(\n    async (body: { live?: boolean; chat?: calls.WebinarChat }, what: string) => {\n      const next = await webinarApi().update(callExtId, body, linkVersion).catch(failed(what))\n      setState(next)\n    },\n    [callExtId, linkVersion]\n  )\n\n  const stepDown = useCallback(async () => {\n    // The server removes me during the request: that disconnect is a rejoin, not a leave.\n    markRejoining(callExtId)\n    setStageCheck(false)\n    try {\n      await webinarApi().demote(callExtId, myIdentity, linkVersion)\n    } catch (err) {\n      markRejoining(callExtId, false)\n      failed('leave the stage')(err)\n    }\n  }, [callExtId, myIdentity, linkVersion])\n\n  const joinStage = useCallback(\n    async (choices: JoinChoices) => {\n      const lp = room.localParticipant\n      try {\n        await lp.setMicrophoneEnabled(\n          choices.audioEnabled,\n          choices.audioDeviceId ? { deviceId: choices.audioDeviceId } : undefined\n        )\n        await lp.setCameraEnabled(\n          choices.videoEnabled,\n          choices.videoDeviceId ? { deviceId: choices.videoDeviceId } : undefined\n        )\n      } catch (err) {\n        failed('turn on your microphone or camera')(err)\n      }\n      setStageCheck(false)\n    },\n    [room]\n  )\n\n  const questionAction = useCallback(\n    async (run: () => Promise<unknown>, what: string) => {\n      await run().catch(failed(what))\n      // Everyone (me too) also gets `questions` from the server; this makes my own change instant.\n      void refreshQuestions()\n    },\n    [refreshQuestions]\n  )\n\n  return useMemo<WebinarControl>(\n    () => ({\n      enabled,\n      role,\n      moderator: !!role && calls.WEBINAR_MODERATORS.has(role),\n      team: !!role && calls.WEBINAR_TEAM.has(role),\n      live: !!state?.live,\n      chat: state?.chat ?? 'panelists',\n      onStage,\n      handRaised: !!state?.hand_raised,\n      hands: state?.hands ?? [],\n      attendees: state?.attendees ?? [],\n      questions,\n      stageCheck: enabled && stageCheck,\n      refresh,\n      goLive: () => patch({ live: true }, 'go live'),\n      end: () => patch({ live: false }, 'end the webinar'),\n      setChat: (chat) => patch({ chat }, 'change who can chat'),\n      setHand: async (raised) => {\n        const next = await webinarApi()\n          .setHand(callExtId, raised, linkVersion)\n          .catch(failed(raised ? 'raise your hand' : 'lower your hand'))\n        setState(next)\n      },\n      promote: (identity) =>\n        webinarApi()\n          .promote(callExtId, identity, linkVersion)\n          .catch(failed('bring them on stage'))\n          .then(refresh),\n      demote: (identity) =>\n        webinarApi()\n          .demote(callExtId, identity, linkVersion)\n          .catch(failed('move them to the audience'))\n          .then(refresh),\n      stepDown,\n      joinStage,\n      ask: (text) =>\n        questionAction(async () => {\n          if (!callKey) throw new Error('This call has no key.')\n          await webinarApi().questions.ask(\n            callExtId,\n            await sealQuestionText(text, callKey),\n            linkVersion\n          )\n        }, 'ask the question'),\n      vote: (id, up) =>\n        questionAction(() => webinarApi().questions.vote(callExtId, id, up, linkVersion), 'vote'),\n      setQuestionStatus: (id, status) =>\n        questionAction(\n          () => webinarApi().questions.update(callExtId, id, { status }, linkVersion),\n          'update the question'\n        ),\n      answer: (id, text) =>\n        questionAction(async () => {\n          if (!callKey) throw new Error('This call has no key.')\n          await webinarApi().questions.update(\n            callExtId,\n            id,\n            { answer: await sealQuestionText(text, callKey) },\n            linkVersion\n          )\n        }, 'answer the question'),\n      removeQuestion: (id) =>\n        questionAction(\n          () => webinarApi().questions.delete(callExtId, id, linkVersion),\n          'delete the question'\n        ),\n    }),\n    [\n      enabled,\n      role,\n      state,\n      onStage,\n      questions,\n      stageCheck,\n      refresh,\n      patch,\n      callExtId,\n      linkVersion,\n      callKey,\n      stepDown,\n      joinStage,\n      questionAction,\n    ]\n  )\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/calls/meeting-chat.js

@@ -0,0 +1,149 @@
+import {
+  decryptCallTitle,
+  encryptWithChatKey,
+  generateChatKey,
+  sealCallKey,
+  sealChatKey
+} from "@arbidocs/client";
+import { chats } from "@arbidocs/sdk/browser";
+import { arbiQueryKeys } from "../hooks.js";
+import { cachedChats } from "../directmessages/chat-cache.js";
+import { invalidateConversationLists } from "../conversation-list.js";
+function meetingChatRefFrom(row) {
+  if (row.chat_ext_id) return { kind: "chat", chatExtId: row.chat_ext_id };
+  const workspaceExtId = row.workspace_ext_id ?? row.locked_workspace_ext_id;
+  if (row.meeting_conversation_ext_id && workspaceExtId) {
+    return {
+      kind: "thread",
+      conversationExtId: row.meeting_conversation_ext_id,
+      workspaceExtId
+    };
+  }
+  return null;
+}
+function callMemberKeys(call) {
+  const keys = /* @__PURE__ */ new Map();
+  if (call.creator_ext_id && call.creator_encryption_public_key) {
+    keys.set(call.creator_ext_id, call.creator_encryption_public_key);
+  }
+  for (const i of call.invitees ?? []) {
+    if (i.encryption_public_key) keys.set(i.user_ext_id, i.encryption_public_key);
+  }
+  return keys;
+}
+async function publicKeysFor(arbi, queryClient, userExtIds, known) {
+  const wanted = new Set(userExtIds);
+  const keys = new Map([...known].filter(([id]) => wanted.has(id)));
+  if (![...wanted].some((id) => !keys.has(id))) return keys;
+  for (const chat of cachedChats(queryClient)) {
+    for (const m of chat.members) {
+      if (wanted.has(m.user.external_id) && !keys.has(m.user.external_id) && m.user.encryption_public_key) {
+        keys.set(m.user.external_id, m.user.encryption_public_key);
+      }
+    }
+  }
+  if ([...wanted].some((id) => !keys.has(id))) {
+    try {
+      for (const c of await arbi.contacts.list()) {
+        const u = c.user;
+        if (u && wanted.has(u.external_id) && u.encryption_public_key && !keys.has(u.external_id)) {
+          keys.set(u.external_id, u.encryption_public_key);
+        }
+      }
+    } catch (err) {
+      console.warn("[calls] could not load contacts for the meeting chat", err);
+    }
+  }
+  return keys;
+}
+async function buildMeetingChatBody(arbi, queryClient, call, callKey, extraMembers = []) {
+  if (!arbi.isLoggedIn) throw new Error("Sign in to keep the meeting chat");
+  const { externalId: me, publicKey: myPublicKey } = await arbi.chats.identity();
+  const hosts = /* @__PURE__ */ new Set([
+    call.creator_ext_id,
+    ...(call.invitees ?? []).map((i) => i.user_ext_id)
+  ]);
+  const memberIds = [.../* @__PURE__ */ new Set([...hosts, ...extraMembers])].filter(
+    (id) => id && id !== me && !chats.isAgentExtId(id)
+  );
+  const pubKeys = await publicKeysFor(arbi, queryClient, memberIds, callMemberKeys(call));
+  const key = await generateChatKey();
+  try {
+    const members = [];
+    for (const id of memberIds) {
+      const pk = pubKeys.get(id);
+      if (!pk) {
+        console.warn("[calls] no public key for meeting-chat member", id);
+        continue;
+      }
+      members.push({
+        user_ext_id: id,
+        sealed_key: await sealChatKey(key, pk),
+        ...hosts.has(id) ? {} : { call_sealed_key: await sealCallKey(callKey, pk) }
+      });
+    }
+    const title = call.title ? await decryptCallTitle(call.title, callKey) : null;
+    return {
+      title: await encryptWithChatKey(title?.trim() || "Meeting", key),
+      creator_sealed_key: await sealChatKey(key, myPublicKey),
+      members
+    };
+  } finally {
+    key.fill(0);
+  }
+}
+const pending = /* @__PURE__ */ new Map();
+function ensureMeetingChat(arbi, queryClient, callExtId, callKey) {
+  const inFlight = pending.get(callExtId);
+  if (inFlight) return inFlight;
+  const run = (async () => {
+    const call = await arbi.calls.get(callExtId);
+    const existing = meetingChatRefFrom(call);
+    if (existing) return existing;
+    const body = call.workspace_locked ? void 0 : await buildMeetingChatBody(arbi, queryClient, call, callKey);
+    const answer = await arbi.calls.chat(callExtId, body);
+    const ref = meetingChatRefFrom({
+      ...answer,
+      locked_workspace_ext_id: call.locked_workspace_ext_id
+    });
+    if (!ref) throw new Error("The server did not return a meeting chat");
+    if (ref.kind === "chat")
+      void queryClient.invalidateQueries({ queryKey: arbiQueryKeys.chatList() });
+    else void invalidateConversationLists(queryClient);
+    return ref;
+  })();
+  pending.set(callExtId, run);
+  run.catch(() => pending.delete(callExtId));
+  return run;
+}
+function clearMeetingChatCache() {
+  pending.clear();
+}
+function knownMeetingChat(target) {
+  if (target.chatExtId) return { kind: "chat", chatExtId: target.chatExtId };
+  if (target.meetingConversationExtId && target.workspaceExtId) {
+    return {
+      kind: "thread",
+      conversationExtId: target.meetingConversationExtId,
+      workspaceExtId: target.workspaceExtId
+    };
+  }
+  return null;
+}
+async function resolveMeetingChat(arbi, queryClient, target) {
+  const known = knownMeetingChat(target);
+  if (known) return known;
+  const key = target.callKey ?? await arbi.calls.key(await arbi.calls.get(target.callExtId));
+  if (!key) throw new Error("You are not invited to this call");
+  return ensureMeetingChat(arbi, queryClient, target.callExtId, key);
+}
+export {
+  buildMeetingChatBody,
+  callMemberKeys,
+  clearMeetingChatCache,
+  ensureMeetingChat,
+  knownMeetingChat,
+  meetingChatRefFrom,
+  resolveMeetingChat
+};
+//# sourceMappingURL=meeting-chat.js.map

package/dist/calls/meeting-chat.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/calls/meeting-chat.ts"],
+  "sourcesContent": ["/**\n * The meeting chat of a call (ARBI `docs/meeting-chats-plan.md` \u00A73\u20134).\n *\n * Every call has one place its conversation persists:\n *   - an E2E `chats` row (`cht-`): the direct chat of a DM call, the group of a group call, or a\n *     `meeting` chat made lazily on first use \u2014 its key is a fresh random epoch key sealed in this\n *     browser to each member (creator + invitees by default), its title encrypted under it;\n *   - a shared thread (`con-`) in the locked workspace of a thread call \u2014 encrypted by the server\n *     with the workspace key like any thread, so @ARBI works there.\n *\n * `ensureMeetingChat` is get-or-create (`POST /v1/calls/{id}/chat`; the server serialises\n * concurrent creators, the loser gets the winner's chat).\n */\n\nimport {\n  decryptCallTitle,\n  encryptWithChatKey,\n  generateChatKey,\n  sealCallKey,\n  sealChatKey,\n} from '@arbidocs/client'\nimport type { QueryClient } from '@tanstack/react-query'\nimport { chats, type Arbi, type calls } from '@arbidocs/sdk/browser'\nimport { arbiQueryKeys } from '../hooks'\nimport { cachedChats } from '../directmessages/chat-cache'\nimport { invalidateConversationLists } from '../conversation-list'\n\nexport type MeetingChatRef =\n  | { kind: 'chat'; chatExtId: string }\n  | { kind: 'thread'; conversationExtId: string; workspaceExtId: string }\n\n/** The meeting chat a call (or a `POST /chat` answer) already names, or null. */\nexport function meetingChatRefFrom(\n  row: Pick<calls.CallResponse, 'chat_ext_id' | 'meeting_conversation_ext_id'> & {\n    locked_workspace_ext_id?: string | null\n    workspace_ext_id?: string | null\n  }\n): MeetingChatRef | null {\n  if (row.chat_ext_id) return { kind: 'chat', chatExtId: row.chat_ext_id }\n  const workspaceExtId = row.workspace_ext_id ?? row.locked_workspace_ext_id\n  if (row.meeting_conversation_ext_id && workspaceExtId) {\n    return {\n      kind: 'thread',\n      conversationExtId: row.meeting_conversation_ext_id,\n      workspaceExtId,\n    }\n  }\n  return null\n}\n\n/** The keys the call row itself carries: its creator's and each invitee's. */\nexport function callMemberKeys(\n  call: Pick<calls.CallResponse, 'creator_ext_id' | 'creator_encryption_public_key' | 'invitees'>\n): Map<string, string> {\n  const keys = new Map<string, string>()\n  if (call.creator_ext_id && call.creator_encryption_public_key) {\n    keys.set(call.creator_ext_id, call.creator_encryption_public_key)\n  }\n  for (const i of call.invitees ?? []) {\n    if (i.encryption_public_key) keys.set(i.user_ext_id, i.encryption_public_key)\n  }\n  return keys\n}\n\n/**\n * Public keys of the people a meeting chat is sealed to: the call row's own keys first (creator and\n * invitees \u2014 no dependence on my chat list or contacts), then, for extra members only, known chat\n * members and contacts.\n */\nasync function publicKeysFor(\n  arbi: Arbi,\n  queryClient: QueryClient,\n  userExtIds: string[],\n  known: Map<string, string>\n): Promise<Map<string, string>> {\n  const wanted = new Set(userExtIds)\n  const keys = new Map<string, string>([...known].filter(([id]) => wanted.has(id)))\n  if (![...wanted].some((id) => !keys.has(id))) return keys\n  for (const chat of cachedChats(queryClient)) {\n    for (const m of chat.members) {\n      if (\n        wanted.has(m.user.external_id) &&\n        !keys.has(m.user.external_id) &&\n        m.user.encryption_public_key\n      ) {\n        keys.set(m.user.external_id, m.user.encryption_public_key)\n      }\n    }\n  }\n  if ([...wanted].some((id) => !keys.has(id))) {\n    try {\n      for (const c of await arbi.contacts.list()) {\n        const u = c.user\n        if (u && wanted.has(u.external_id) && u.encryption_public_key && !keys.has(u.external_id)) {\n          keys.set(u.external_id, u.encryption_public_key)\n        }\n      }\n    } catch (err) {\n      console.warn('[calls] could not load contacts for the meeting chat', err)\n    }\n  }\n  return keys\n}\n\n/**\n * The E2E body for a new meeting chat: a fresh chat key sealed to me and to each member whose\n * public key is known (the call's creator and invitees by default, with the keys the call row\n * carries; `extraMembers` beyond them also get K sealed to them, so they can always join), and the\n * call's title under the chat key. A member without a key is left out (they can be added later);\n * `members` may be empty \u2014 a chat with only me is valid.\n */\nexport async function buildMeetingChatBody(\n  arbi: Arbi,\n  queryClient: QueryClient,\n  call: calls.CallResponse,\n  callKey: Uint8Array,\n  extraMembers: string[] = []\n): Promise<calls.CallChatCreate> {\n  if (!arbi.isLoggedIn) throw new Error('Sign in to keep the meeting chat')\n  const { externalId: me, publicKey: myPublicKey } = await arbi.chats.identity()\n  const hosts = new Set<string>([\n    call.creator_ext_id,\n    ...(call.invitees ?? []).map((i) => i.user_ext_id),\n  ])\n  const memberIds = [...new Set([...hosts, ...extraMembers])].filter(\n    (id) => id && id !== me && !chats.isAgentExtId(id)\n  )\n  const pubKeys = await publicKeysFor(arbi, queryClient, memberIds, callMemberKeys(call))\n  const key = await generateChatKey()\n  try {\n    const members: calls.CallChatCreate['members'] = []\n    for (const id of memberIds) {\n      const pk = pubKeys.get(id)\n      if (!pk) {\n        // Nobody to seal to: they can be added to the chat later.\n        console.warn('[calls] no public key for meeting-chat member', id)\n        continue\n      }\n      members.push({\n        user_ext_id: id,\n        sealed_key: await sealChatKey(key, pk),\n        ...(hosts.has(id) ? {} : { call_sealed_key: await sealCallKey(callKey, pk) }),\n      })\n    }\n    const title = call.title ? await decryptCallTitle(call.title, callKey) : null\n    return {\n      title: await encryptWithChatKey(title?.trim() || 'Meeting', key),\n      creator_sealed_key: await sealChatKey(key, myPublicKey),\n      members,\n    }\n  } finally {\n    key.fill(0)\n  }\n}\n\nconst pending = new Map<string, Promise<MeetingChatRef>>()\n\n/** The call's meeting chat, made now if it has none. Concurrent callers share one request. */\nexport function ensureMeetingChat(\n  arbi: Arbi,\n  queryClient: QueryClient,\n  callExtId: string,\n  callKey: Uint8Array\n): Promise<MeetingChatRef> {\n  const inFlight = pending.get(callExtId)\n  if (inFlight) return inFlight\n  const run = (async () => {\n    const call = await arbi.calls.get(callExtId)\n    const existing = meetingChatRefFrom(call)\n    if (existing) return existing\n    const body = call.workspace_locked\n      ? undefined\n      : await buildMeetingChatBody(arbi, queryClient, call, callKey)\n    const answer = await arbi.calls.chat(callExtId, body)\n    const ref = meetingChatRefFrom({\n      ...answer,\n      locked_workspace_ext_id: call.locked_workspace_ext_id,\n    })\n    if (!ref) throw new Error('The server did not return a meeting chat')\n    // The new chat or meeting thread joins its list.\n    if (ref.kind === 'chat')\n      void queryClient.invalidateQueries({ queryKey: arbiQueryKeys.chatList() })\n    else void invalidateConversationLists(queryClient)\n    return ref\n  })()\n  pending.set(callExtId, run)\n  // Keep a resolved ref cached for the session; forget failures so a retry can succeed.\n  run.catch(() => pending.delete(callExtId))\n  return run\n}\n\n/** Forget cached refs (tests; sign-out). */\nexport function clearMeetingChatCache(): void {\n  pending.clear()\n}\n\n/** A call whose meeting chat is to be shown, with what is already known about it. */\nexport interface MeetingChatTarget {\n  callExtId: string\n  /** The call's E2E chat (DM / group / meeting), when known. */\n  chatExtId?: string | null\n  /** A thread call's meeting thread, when known, and its workspace. */\n  meetingConversationExtId?: string | null\n  workspaceExtId?: string | null\n  /** K, when the caller already has it (else my sealed copy is opened). */\n  callKey?: Uint8Array | null\n}\n\n/** The ref for a target whose chat is already known, or null when it must be made / looked up. */\nexport function knownMeetingChat(target: MeetingChatTarget): MeetingChatRef | null {\n  if (target.chatExtId) return { kind: 'chat', chatExtId: target.chatExtId }\n  if (target.meetingConversationExtId && target.workspaceExtId) {\n    return {\n      kind: 'thread',\n      conversationExtId: target.meetingConversationExtId,\n      workspaceExtId: target.workspaceExtId,\n    }\n  }\n  return null\n}\n\n/** The target's meeting chat: the known one, else made on first use (needs K). */\nexport async function resolveMeetingChat(\n  arbi: Arbi,\n  queryClient: QueryClient,\n  target: MeetingChatTarget\n): Promise<MeetingChatRef> {\n  const known = knownMeetingChat(target)\n  if (known) return known\n  const key = target.callKey ?? (await arbi.calls.key(await arbi.calls.get(target.callExtId)))\n  if (!key) throw new Error('You are not invited to this call')\n  return ensureMeetingChat(arbi, queryClient, target.callExtId, key)\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/calls/moderation.js

@@ -0,0 +1,50 @@
+const CALL_MODERATION_TOPIC = "arbi.moderation";
+function trackOf(value) {
+  return value === "audio" || value === "video" ? value : null;
+}
+function mutedNoticeFromPacket(payload) {
+  try {
+    const parsed = JSON.parse(new TextDecoder().decode(payload));
+    if (!parsed || typeof parsed !== "object") return null;
+    const p = parsed;
+    const track = trackOf(p.track);
+    if (p.action !== "muted" || !track) return null;
+    return { track, byName: typeof p.by_name === "string" ? p.by_name : null };
+  } catch {
+    return null;
+  }
+}
+function mutedNoticeText(notice) {
+  return notice.track === "audio" ? "The host muted you" : "The host turned off your camera";
+}
+const MUTED_DEDUPE_MS = 5e3;
+function createMutedNotifier(show, now = Date.now) {
+  const last = /* @__PURE__ */ new Map();
+  return (notice) => {
+    const at = now();
+    const prev = last.get(notice.track);
+    if (prev !== void 0 && at - prev < MUTED_DEDUPE_MS) return;
+    last.set(notice.track, at);
+    show(mutedNoticeText(notice));
+  };
+}
+function mutedNoticeFromEvent(raw) {
+  if (!raw || typeof raw !== "object") return null;
+  const r = raw;
+  const track = trackOf(r.track);
+  if (typeof r.call_ext_id !== "string" || !track) return null;
+  return {
+    callExtId: r.call_ext_id,
+    track,
+    byName: typeof r.by_name === "string" ? r.by_name : null
+  };
+}
+export {
+  CALL_MODERATION_TOPIC,
+  MUTED_DEDUPE_MS,
+  createMutedNotifier,
+  mutedNoticeFromEvent,
+  mutedNoticeFromPacket,
+  mutedNoticeText
+};
+//# sourceMappingURL=moderation.js.map

package/dist/calls/moderation.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/calls/moderation.ts"],
+  "sourcesContent": ["/**\n * The host's moderation of a call, as the moderated participant sees it.\n *\n * `POST /v1/calls/{id}/participants/{identity}/mute` mutes one of my tracks server-side and tells me\n * twice: a SERVER-sent LiveKit data message on {@link CALL_MODERATION_TOPIC}\n * (`{action: \"muted\", track, by_identity, by_name}`, plaintext, no content) and WS `call.muted`\n * (`{call_ext_id, track, by_name}`). Either may arrive first (or alone); one toast is shown.\n */\n\nexport const CALL_MODERATION_TOPIC = 'arbi.moderation'\n\nexport type ModeratedTrack = 'audio' | 'video'\n\nexport interface CallMutedNotice {\n  track: ModeratedTrack\n  byName: string | null\n}\n\nfunction trackOf(value: unknown): ModeratedTrack | null {\n  return value === 'audio' || value === 'video' ? value : null\n}\n\n/** A moderation data packet's \"muted\" notice; null when malformed or another action. */\nexport function mutedNoticeFromPacket(payload: Uint8Array): CallMutedNotice | null {\n  try {\n    const parsed: unknown = JSON.parse(new TextDecoder().decode(payload))\n    if (!parsed || typeof parsed !== 'object') return null\n    const p = parsed as { action?: unknown; track?: unknown; by_name?: unknown }\n    const track = trackOf(p.track)\n    if (p.action !== 'muted' || !track) return null\n    return { track, byName: typeof p.by_name === 'string' ? p.by_name : null }\n  } catch {\n    return null\n  }\n}\n\n/** The toast for a notice. */\nexport function mutedNoticeText(notice: CallMutedNotice): string {\n  return notice.track === 'audio' ? 'The host muted you' : 'The host turned off your camera'\n}\n\n/** Both channels report one mute within this window; a later mute of the same track toasts again. */\nexport const MUTED_DEDUPE_MS = 5_000\n\n/**\n * A notifier that shows one toast per mute: the data message and the WS event for the same track\n * within {@link MUTED_DEDUPE_MS} collapse into one.\n */\nexport function createMutedNotifier(\n  show: (text: string) => void,\n  now: () => number = Date.now\n): (notice: CallMutedNotice) => void {\n  const last = new Map<ModeratedTrack, number>()\n  return (notice) => {\n    const at = now()\n    const prev = last.get(notice.track)\n    if (prev !== undefined && at - prev < MUTED_DEDUPE_MS) return\n    last.set(notice.track, at)\n    show(mutedNoticeText(notice))\n  }\n}\n\n/** A WS `call.muted` as a notice for the open room; null when malformed. */\nexport function mutedNoticeFromEvent(\n  raw: unknown\n): (CallMutedNotice & { callExtId: string }) | null {\n  if (!raw || typeof raw !== 'object') return null\n  const r = raw as { call_ext_id?: unknown; track?: unknown; by_name?: unknown }\n  const track = trackOf(r.track)\n  if (typeof r.call_ext_id !== 'string' || !track) return null\n  return {\n    callExtId: r.call_ext_id,\n    track,\n    byName: typeof r.by_name === 'string' ? r.by_name : null,\n  }\n}\n"],
+  "mappings": "AASO,MAAM,wBAAwB;AASrC,SAAS,QAAQ,OAAuC;AACtD,SAAO,UAAU,WAAW,UAAU,UAAU,QAAQ;AAC1D;AAGO,SAAS,sBAAsB,SAA6C;AACjF,MAAI;AACF,UAAM,SAAkB,KAAK,MAAM,IAAI,YAAY,EAAE,OAAO,OAAO,CAAC;AACpE,QAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,UAAM,IAAI;AACV,UAAM,QAAQ,QAAQ,EAAE,KAAK;AAC7B,QAAI,EAAE,WAAW,WAAW,CAAC,MAAO,QAAO;AAC3C,WAAO,EAAE,OAAO,QAAQ,OAAO,EAAE,YAAY,WAAW,EAAE,UAAU,KAAK;AAAA,EAC3E,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGO,SAAS,gBAAgB,QAAiC;AAC/D,SAAO,OAAO,UAAU,UAAU,uBAAuB;AAC3D;AAGO,MAAM,kBAAkB;AAMxB,SAAS,oBACd,MACA,MAAoB,KAAK,KACU;AACnC,QAAM,OAAO,oBAAI,IAA4B;AAC7C,SAAO,CAAC,WAAW;AACjB,UAAM,KAAK,IAAI;AACf,UAAM,OAAO,KAAK,IAAI,OAAO,KAAK;AAClC,QAAI,SAAS,UAAa,KAAK,OAAO,gBAAiB;AACvD,SAAK,IAAI,OAAO,OAAO,EAAE;AACzB,SAAK,gBAAgB,MAAM,CAAC;AAAA,EAC9B;AACF;AAGO,SAAS,qBACd,KACkD;AAClD,MAAI,CAAC,OAAO,OAAO,QAAQ,SAAU,QAAO;AAC5C,QAAM,IAAI;AACV,QAAM,QAAQ,QAAQ,EAAE,KAAK;AAC7B,MAAI,OAAO,EAAE,gBAAgB,YAAY,CAAC,MAAO,QAAO;AACxD,SAAO;AAAA,IACL,WAAW,EAAE;AAAA,IACb;AAAA,IACA,QAAQ,OAAO,EAAE,YAAY,WAAW,EAAE,UAAU;AAAA,EACtD;AACF;",
+  "names": []
+}

package/dist/calls/open-meeting-chat.js

@@ -0,0 +1,29 @@
+import { useCallback } from "react";
+import { useQueryClient } from "@tanstack/react-query";
+import { useArbi } from "../useArbi.js";
+import { useArbiHost } from "../host/config.js";
+import { notify } from "../notifications/notify-store.js";
+import { resolveMeetingChat } from "./meeting-chat.js";
+function useOpenCallMeetingChat() {
+  const arbi = useArbi();
+  const queryClient = useQueryClient();
+  const open = useArbiHost().calls?.openMeetingChat;
+  return useCallback(
+    async (target) => {
+      try {
+        const ref = await resolveMeetingChat(arbi, queryClient, target);
+        open?.(ref);
+      } catch (err) {
+        console.warn("[calls] could not open the meeting chat", err);
+        notify.error(
+          `Could not open the meeting chat: ${err instanceof Error ? err.message : "unknown error"}`
+        );
+      }
+    },
+    [arbi, queryClient, open]
+  );
+}
+export {
+  useOpenCallMeetingChat
+};
+//# sourceMappingURL=open-meeting-chat.js.map

package/dist/calls/open-meeting-chat.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/calls/open-meeting-chat.ts"],
+  "sourcesContent": ["/**\n * \"Open meeting chat\" for every link that has one (a thread's call log card, a calendar event): a\n * known chat or meeting thread opens directly; otherwise the call's meeting chat is made on first\n * use. It opens where the host shows meeting chats (`calls.openMeetingChat`).\n */\n\nimport { useCallback } from 'react'\nimport { useQueryClient } from '@tanstack/react-query'\nimport { useArbi } from '../useArbi'\nimport { useArbiHost } from '../host/config'\nimport { notify } from '../notifications/notify-store'\nimport { resolveMeetingChat, type MeetingChatTarget } from './meeting-chat'\n\nexport function useOpenCallMeetingChat(): (target: MeetingChatTarget) => Promise<void> {\n  const arbi = useArbi()\n  const queryClient = useQueryClient()\n  const open = useArbiHost().calls?.openMeetingChat\n  return useCallback(\n    async (target) => {\n      try {\n        const ref = await resolveMeetingChat(arbi, queryClient, target)\n        open?.(ref)\n      } catch (err) {\n        console.warn('[calls] could not open the meeting chat', err)\n        notify.error(\n          `Could not open the meeting chat: ${err instanceof Error ? err.message : 'unknown error'}`\n        )\n      }\n    },\n    [arbi, queryClient, open]\n  )\n}\n"],
+  "mappings": "AAMA,SAAS,mBAAmB;AAC5B,SAAS,sBAAsB;AAC/B,SAAS,eAAe;AACxB,SAAS,mBAAmB;AAC5B,SAAS,cAAc;AACvB,SAAS,0BAAkD;AAEpD,SAAS,yBAAuE;AACrF,QAAM,OAAO,QAAQ;AACrB,QAAM,cAAc,eAAe;AACnC,QAAM,OAAO,YAAY,EAAE,OAAO;AAClC,SAAO;AAAA,IACL,OAAO,WAAW;AAChB,UAAI;AACF,cAAM,MAAM,MAAM,mBAAmB,MAAM,aAAa,MAAM;AAC9D,eAAO,GAAG;AAAA,MACZ,SAAS,KAAK;AACZ,gBAAQ,KAAK,2CAA2C,GAAG;AAC3D,eAAO;AAAA,UACL,oCAAoC,eAAe,QAAQ,IAAI,UAAU,eAAe;AAAA,QAC1F;AAAA,MACF;AAAA,IACF;AAAA,IACA,CAAC,MAAM,aAAa,IAAI;AAAA,EAC1B;AACF;",
+  "names": []
+}

package/dist/calls/read-only.js

@@ -0,0 +1,24 @@
+import { useWorkspaces } from "../hooks.js";
+import { useArbi } from "../useArbi.js";
+function isWorkspaceGuestOf(workspaces, workspaceExtId, me) {
+  if (!workspaceExtId || !me || !workspaces) return false;
+  const workspace = workspaces.find((w) => w.external_id === workspaceExtId);
+  return workspace?.users?.find((wu) => wu.user.external_id === me)?.role === "guest";
+}
+function useMeetingReadOnly(lockedWorkspaceExtId) {
+  const arbi = useArbi();
+  const me = arbi.isLoggedIn ? arbi.user.identity()?.externalId ?? null : null;
+  const { data: workspaces } = useWorkspaces({
+    enabled: !!lockedWorkspaceExtId && arbi.isLoggedIn
+  });
+  return isWorkspaceGuestOf(
+    workspaces,
+    lockedWorkspaceExtId,
+    me
+  );
+}
+export {
+  isWorkspaceGuestOf,
+  useMeetingReadOnly
+};
+//# sourceMappingURL=read-only.js.map

package/dist/calls/read-only.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/calls/read-only.ts"],
+  "sourcesContent": ["/**\n * Workspace guests may join a thread call (and are transcribed) but its meeting chat is read-only\n * for them: no in-call chat composer, no meeting-thread composer. Their transcript lines are stored\n * by a member's client (see `transcriptPersistRole`).\n */\n\nimport { useWorkspaces } from '../hooks'\nimport { useArbi } from '../useArbi'\n\ninterface WorkspaceRoster {\n  external_id: string\n  users?: { role?: string | null; user: { external_id: string } }[] | null\n}\n\n/** Whether I am a guest of `workspaceExtId` (pure, for tests). */\nexport function isWorkspaceGuestOf(\n  workspaces: readonly WorkspaceRoster[] | undefined,\n  workspaceExtId: string | null | undefined,\n  me: string | null | undefined\n): boolean {\n  if (!workspaceExtId || !me || !workspaces) return false\n  const workspace = workspaces.find((w) => w.external_id === workspaceExtId)\n  return workspace?.users?.find((wu) => wu.user.external_id === me)?.role === 'guest'\n}\n\n/** True when I am a guest of the workspace a thread call is locked to (null: not a thread call). */\nexport function useMeetingReadOnly(lockedWorkspaceExtId: string | null | undefined): boolean {\n  const arbi = useArbi()\n  const me = arbi.isLoggedIn ? (arbi.user.identity()?.externalId ?? null) : null\n  const { data: workspaces } = useWorkspaces({\n    enabled: !!lockedWorkspaceExtId && arbi.isLoggedIn,\n  })\n  return isWorkspaceGuestOf(\n    workspaces as readonly WorkspaceRoster[] | undefined,\n    lockedWorkspaceExtId,\n    me\n  )\n}\n"],
+  "mappings": "AAMA,SAAS,qBAAqB;AAC9B,SAAS,eAAe;AAQjB,SAAS,mBACd,YACA,gBACA,IACS;AACT,MAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,WAAY,QAAO;AAClD,QAAM,YAAY,WAAW,KAAK,CAAC,MAAM,EAAE,gBAAgB,cAAc;AACzE,SAAO,WAAW,OAAO,KAAK,CAAC,OAAO,GAAG,KAAK,gBAAgB,EAAE,GAAG,SAAS;AAC9E;AAGO,SAAS,mBAAmB,sBAA0D;AAC3F,QAAM,OAAO,QAAQ;AACrB,QAAM,KAAK,KAAK,aAAc,KAAK,KAAK,SAAS,GAAG,cAAc,OAAQ;AAC1E,QAAM,EAAE,MAAM,WAAW,IAAI,cAAc;AAAA,IACzC,SAAS,CAAC,CAAC,wBAAwB,KAAK;AAAA,EAC1C,CAAC;AACD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;",
+  "names": []
+}