@arbidocs/react 0.5.110 → 0.5.112

package/dist/calls/actions.js

@@ -0,0 +1,226 @@
+import { buildCallLink } from "@arbidocs/client";
+import { CallApiError } from "@arbidocs/sdk/browser";
+import { notify } from "../notifications/notify-store.js";
+import {
+  callSession,
+  DEFAULT_JOIN_CHOICES
+} from "./session.js";
+function callLink(callExtId, key, linkVersion) {
+  return buildCallLink(window.location.origin, callExtId, key, linkVersion);
+}
+function alreadyInCall(callExtId) {
+  const active = callSession.getState().active;
+  if (!active || active.callExtId === callExtId) return false;
+  notify.warning("You are already in a call. Leave it first.");
+  return true;
+}
+function fail(err, what = "start the call") {
+  console.error(`[calls] failed to ${what}`, err);
+  const message = err instanceof Error ? err.message : "Unknown error";
+  notify.error(`Could not ${what}: ${message}`);
+}
+function callContext(call) {
+  return {
+    chatExtId: call.chat_ext_id ?? null,
+    logConversationExtId: call.log_conversation_ext_id ?? null,
+    meetingConversationExtId: call.meeting_conversation_ext_id ?? null,
+    lockedWorkspaceExtId: call.locked_workspace_ext_id ?? null
+  };
+}
+async function sendInviteLinks(arbi, callExtId, key, linkVersion, invites) {
+  let sent = 0;
+  for (const invite of invites) {
+    try {
+      await arbi.calls.inviteLinks.create(callExtId, {
+        contact_ext_id: invite.contactExtId,
+        link: callLink(callExtId, key, linkVersion)
+      });
+      sent += 1;
+    } catch (err) {
+      fail(err, `invite ${invite.name || "a contact"}`);
+    }
+  }
+  if (sent) notify.success(`Sent ${sent} ${sent === 1 ? "invitation" : "invitations"}`);
+  return sent;
+}
+async function startCall(arbi, opts) {
+  if (alreadyInCall()) return false;
+  try {
+    const {
+      call,
+      key,
+      title,
+      sealedKeys: ringOnJoin
+    } = await arbi.calls.start({ ...opts.context, title: opts.title, invitees: opts.ring });
+    callSession.setActiveCall({
+      callExtId: call.external_id,
+      key,
+      linkVersion: call.link_version,
+      title,
+      isCreator: call.is_creator,
+      ...callContext(call),
+      phase: "prejoin",
+      tokenResponse: null,
+      choices: null,
+      knock: null,
+      ringOnJoin: Object.keys(ringOnJoin).length ? ringOnJoin : null
+    });
+    if (opts.invites?.length) {
+      void sendInviteLinks(arbi, call.external_id, key, call.link_version, opts.invites);
+    }
+    return true;
+  } catch (err) {
+    fail(err);
+    return false;
+  }
+}
+function startThreadCall(arbi, opts) {
+  return startCall(arbi, {
+    context: { threadExtId: opts.threadExtId },
+    title: opts.title,
+    ring: opts.ring
+  });
+}
+function startChatCall(arbi, opts) {
+  return startCall(arbi, {
+    context: { chatExtId: opts.chatExtId },
+    title: opts.title,
+    ring: opts.ring
+  });
+}
+async function startDmCall(arbi, peer) {
+  if (alreadyInCall()) return false;
+  if (!peer.encryption_public_key) {
+    fail(new Error("This person cannot receive encrypted calls"));
+    return false;
+  }
+  let chatExtId;
+  try {
+    chatExtId = (await arbi.chats.openDirect(peer.external_id)).external_id;
+  } catch (err) {
+    fail(err);
+    return false;
+  }
+  return startChatCall(arbi, { chatExtId, title: peer.name ?? null, ring: [peer] });
+}
+function startContactsCall(arbi, opts) {
+  return startCall(arbi, { context: {}, title: opts.title, ring: opts.ring, invites: opts.invites });
+}
+async function openCall(arbi, opts) {
+  if (alreadyInCall(opts.callExtId)) return false;
+  try {
+    const { call, key, title } = await arbi.calls.open(opts.callExtId, opts.key);
+    callSession.setActiveCall({
+      callExtId: call.external_id,
+      key,
+      linkVersion: opts.linkVersion ?? call.link_version,
+      title,
+      isCreator: call.is_creator,
+      ...callContext(call),
+      phase: "prejoin",
+      tokenResponse: null,
+      choices: null,
+      knock: null,
+      ringOnJoin: null,
+      inviteToken: opts.inviteToken ?? null
+    });
+    return true;
+  } catch (err) {
+    fail(err, "open the call");
+    return false;
+  }
+}
+async function acceptRing(arbi, ring) {
+  const current = callSession.getState().active;
+  if (current && current.callExtId !== ring.call_ext_id) callSession.endActiveCall();
+  try {
+    const { key, token, title } = await arbi.calls.answer(ring);
+    callSession.setActiveCall({
+      callExtId: ring.call_ext_id,
+      key,
+      linkVersion: ring.link_version,
+      title: title || ring.caller_name,
+      isCreator: false,
+      chatExtId: ring.chat_ext_id ?? null,
+      logConversationExtId: ring.log_conversation_ext_id ?? null,
+      meetingConversationExtId: ring.meeting_conversation_ext_id ?? null,
+      lockedWorkspaceExtId: ring.context === "thread" ? ring.workspace_ext_id ?? null : null,
+      phase: "connected",
+      tokenResponse: token,
+      choices: DEFAULT_JOIN_CHOICES,
+      knock: null,
+      ringOnJoin: null
+    });
+    return true;
+  } catch (err) {
+    fail(err, "join the call");
+    callSession.removeIncomingCall(ring.call_ext_id);
+    return false;
+  }
+}
+function declineRing(arbi, ring) {
+  callSession.removeIncomingCall(ring.call_ext_id);
+  arbi.calls.decline(ring.call_ext_id).catch((err) => console.warn("[calls] decline failed", err));
+}
+const KNOCK_POLL_MS = 2e3;
+async function waitForAdmission(arbi, callExtId, knock, signal) {
+  for (; ; ) {
+    if (signal.aborted) throw new DOMException("Stopped waiting", "AbortError");
+    await new Promise((resolve) => setTimeout(resolve, KNOCK_POLL_MS));
+    if (signal.aborted) throw new DOMException("Stopped waiting", "AbortError");
+    const state = await arbi.calls.pollKnock(callExtId, knock.knock_id);
+    if (state.status === "admitted" && state.token) return state.token;
+    if (state.status === "denied") throw new CallApiError("The host declined your request.", 403);
+    if (state.status === "expired") throw new CallApiError("Nobody let you in. Try again.", 410);
+  }
+}
+async function joinFromPreJoin(arbi, choices) {
+  const active = callSession.getState().active;
+  if (!active) return;
+  const { callExtId, linkVersion, inviteToken } = active;
+  const update = (patch) => callSession.updateActiveCall(callExtId, patch);
+  try {
+    let tokenResponse;
+    try {
+      tokenResponse = await arbi.calls.token(callExtId, linkVersion, inviteToken);
+    } catch (err) {
+      if (!(err instanceof CallApiError && err.code === "knock_required")) throw err;
+      const knock = await arbi.calls.knock(callExtId, linkVersion);
+      if (knock.status === "admitted" && knock.token) tokenResponse = knock.token;
+      else {
+        const controller = new AbortController();
+        update({ phase: "knocking", choices, knock: { abort: () => controller.abort() } });
+        tokenResponse = await waitForAdmission(arbi, callExtId, knock, controller.signal);
+      }
+    }
+    if (callSession.getState().active?.callExtId !== callExtId) return;
+    update({ phase: "connected", tokenResponse, choices, knock: null });
+    const ring = active.ringOnJoin;
+    if (ring && Object.keys(ring).length) {
+      update({ ringOnJoin: null });
+      await arbi.calls.ring(callExtId, ring, linkVersion).catch((err) => console.warn("[calls] ring failed", err));
+    }
+  } catch (err) {
+    if (err instanceof DOMException && err.name === "AbortError") return;
+    if (err instanceof CallApiError && err.code === "webinar_not_live") {
+      update({ phase: "webinar-waiting", choices, knock: null });
+      return;
+    }
+    fail(err, "join the call");
+    if (callSession.getState().active?.callExtId === callExtId) {
+      callSession.endActiveCall();
+    }
+  }
+}
+export {
+  acceptRing,
+  callLink,
+  declineRing,
+  joinFromPreJoin,
+  openCall,
+  startChatCall,
+  startContactsCall,
+  startDmCall,
+  startThreadCall
+};
+//# sourceMappingURL=actions.js.map

package/dist/calls/actions.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/calls/actions.ts"],
+  "sourcesContent": ["/**\n * Call actions \u2014 usable outside React (buttons, notification actions, the WS\n * ringer). One call system: every call has a random key K made in the\n * creator's browser (see `@arbidocs/client` call-keys):\n *\n *   - start (thread / chat / contacts): generate K, create the call with K\n *     sealed to ourselves and to the people picked, show the pre-join; on\n *     join, ring them. Nobody else is rung: a thread call rings only the\n *     members picked, never the whole workspace. Unregistered contacts get a\n *     personal invite link by e-mail instead (register, then straight into the\n *     call \u2014 there are no anonymous guests);\n *   - accept a ring: open K from the ring's sealed blob and join at once;\n *   - open a call (link / calendar event / notification): K from the link fragment,\n *     else our sealed copy on the server.\n *\n * A thread call is get-or-create: if the thread already has a running call we\n * hold the key for, we join that one instead of starting another.\n */\n\nimport { buildCallLink, type CallPeer } from '@arbidocs/client'\nimport { CallApiError, type Arbi, type calls } from '@arbidocs/sdk/browser'\nimport { notify } from '../notifications/notify-store'\nimport {\n  callSession,\n  DEFAULT_JOIN_CHOICES,\n  type ActiveCall,\n  type IncomingCall,\n  type JoinChoices,\n} from './session'\n\nexport type { CallPeer }\n\n/** `https://<host>/call/<id>#k=\u2026&v=\u2026` \u2014 the shareable link. */\nexport function callLink(callExtId: string, key: Uint8Array, linkVersion: number): string {\n  return buildCallLink(window.location.origin, callExtId, key, linkVersion)\n}\n\nfunction alreadyInCall(callExtId?: string): boolean {\n  const active = callSession.getState().active\n  if (!active || active.callExtId === callExtId) return false\n  notify.warning('You are already in a call. Leave it first.')\n  return true\n}\n\nfunction fail(err: unknown, what = 'start the call') {\n  console.error(`[calls] failed to ${what}`, err)\n  const message = err instanceof Error ? err.message : 'Unknown error'\n  notify.error(`Could not ${what}: ${message}`)\n}\n\n/** Where a call belongs, for the active call (and the in-call chat). */\nfunction callContext(\n  call: Pick<\n    calls.CallResponse,\n    | 'chat_ext_id'\n    | 'log_conversation_ext_id'\n    | 'meeting_conversation_ext_id'\n    | 'locked_workspace_ext_id'\n  >\n): Pick<\n  ActiveCall,\n  'chatExtId' | 'logConversationExtId' | 'meetingConversationExtId' | 'lockedWorkspaceExtId'\n> {\n  return {\n    chatExtId: call.chat_ext_id ?? null,\n    logConversationExtId: call.log_conversation_ext_id ?? null,\n    meetingConversationExtId: call.meeting_conversation_ext_id ?? null,\n    lockedWorkspaceExtId: call.locked_workspace_ext_id ?? null,\n  }\n}\n\n/** An unregistered contact who gets a personal invite link by e-mail. */\nexport interface CallInviteContact {\n  contactExtId: string\n  /** The name they are invited under; encrypted under K. */\n  name: string\n}\n\n/**\n * Mail each contact a personal invite link: an ARBI registration link that, once they have an\n * account, opens `/call/<id>?i=<token>#k=\u2026` and admits them straight into the call. Best effort: a\n * failure for one contact is reported and does not stop the others. Resolves to how many went out.\n */\nasync function sendInviteLinks(\n  arbi: Arbi,\n  callExtId: string,\n  key: Uint8Array,\n  linkVersion: number,\n  invites: CallInviteContact[]\n): Promise<number> {\n  let sent = 0\n  for (const invite of invites) {\n    try {\n      await arbi.calls.inviteLinks.create(callExtId, {\n        contact_ext_id: invite.contactExtId,\n        link: callLink(callExtId, key, linkVersion),\n      })\n      sent += 1\n    } catch (err) {\n      fail(err, `invite ${invite.name || 'a contact'}`)\n    }\n  }\n  if (sent) notify.success(`Sent ${sent} ${sent === 1 ? 'invitation' : 'invitations'}`)\n  return sent\n}\n\n/**\n * Create a call and open its pre-join. `ring` are invited now (K sealed to each) and rung when we\n * join; `invites` get a personal invite link by e-mail straight away.\n */\nasync function startCall(\n  arbi: Arbi,\n  opts: {\n    context: { chatExtId?: string | null; threadExtId?: string | null }\n    title?: string | null\n    ring: CallPeer[]\n    invites?: CallInviteContact[]\n  }\n): Promise<boolean> {\n  if (alreadyInCall()) return false\n  try {\n    const {\n      call,\n      key,\n      title,\n      sealedKeys: ringOnJoin,\n    } = await arbi.calls.start({ ...opts.context, title: opts.title, invitees: opts.ring })\n    callSession.setActiveCall({\n      callExtId: call.external_id,\n      key,\n      linkVersion: call.link_version,\n      title,\n      isCreator: call.is_creator,\n      ...callContext(call),\n      phase: 'prejoin',\n      tokenResponse: null,\n      choices: null,\n      knock: null,\n      ringOnJoin: Object.keys(ringOnJoin).length ? ringOnJoin : null,\n    })\n    if (opts.invites?.length) {\n      void sendInviteLinks(arbi, call.external_id, key, call.link_version, opts.invites)\n    }\n    return true\n  } catch (err) {\n    fail(err)\n    return false\n  }\n}\n\n/**\n * A thread call (shared threads only): locked to the thread's workspace and logged in the thread.\n * Get-or-create: a running call on the thread is joined. Only `ring` (the members picked) are rung.\n */\nexport function startThreadCall(\n  arbi: Arbi,\n  opts: {\n    threadExtId: string\n    title?: string | null\n    ring: CallPeer[]\n  }\n): Promise<boolean> {\n  return startCall(arbi, {\n    context: { threadExtId: opts.threadExtId },\n    title: opts.title,\n    ring: opts.ring,\n  })\n}\n\n/** A chat's call (a DM or a group): the chat is its meeting chat. `ring` are rung when we join. */\nexport function startChatCall(\n  arbi: Arbi,\n  opts: {\n    chatExtId: string\n    title?: string | null\n    ring: CallPeer[]\n  }\n): Promise<boolean> {\n  return startCall(arbi, {\n    context: { chatExtId: opts.chatExtId },\n    title: opts.title,\n    ring: opts.ring,\n  })\n}\n\n/** Call a person: the call of our direct chat (made if missing), ringing them. */\nexport async function startDmCall(\n  arbi: Arbi,\n  peer: CallPeer & { name?: string | null }\n): Promise<boolean> {\n  if (alreadyInCall()) return false\n  if (!peer.encryption_public_key) {\n    fail(new Error('This person cannot receive encrypted calls'))\n    return false\n  }\n  let chatExtId: string\n  try {\n    chatExtId = (await arbi.chats.openDirect(peer.external_id)).external_id\n  } catch (err) {\n    fail(err)\n    return false\n  }\n  return startChatCall(arbi, { chatExtId, title: peer.name ?? null, ring: [peer] })\n}\n\n/**\n * A contacts call (\"New call\"): registered contacts are rung, unregistered ones get a personal invite\n * link. Its meeting chat is made on first use.\n */\nexport function startContactsCall(\n  arbi: Arbi,\n  opts: {\n    title?: string | null\n    ring: CallPeer[]\n    invites: CallInviteContact[]\n  }\n): Promise<boolean> {\n  return startCall(arbi, { context: {}, title: opts.title, ring: opts.ring, invites: opts.invites })\n}\n\n/**\n * Open a call by id (link, upcoming list, notification) into the pre-join.\n * `key` comes from the link fragment; without it we use our sealed copy.\n * `inviteToken` (a personal invite link's `?i=`) is redeemed on join: straight in, no lobby.\n */\nexport async function openCall(\n  arbi: Arbi,\n  opts: {\n    callExtId: string\n    key?: Uint8Array | null\n    linkVersion?: number | null\n    inviteToken?: string | null\n  }\n): Promise<boolean> {\n  if (alreadyInCall(opts.callExtId)) return false\n  try {\n    const { call, key, title } = await arbi.calls.open(opts.callExtId, opts.key)\n    callSession.setActiveCall({\n      callExtId: call.external_id,\n      key,\n      linkVersion: opts.linkVersion ?? call.link_version,\n      title,\n      isCreator: call.is_creator,\n      ...callContext(call),\n      phase: 'prejoin',\n      tokenResponse: null,\n      choices: null,\n      knock: null,\n      ringOnJoin: null,\n      inviteToken: opts.inviteToken ?? null,\n    })\n    return true\n  } catch (err) {\n    fail(err, 'open the call')\n    return false\n  }\n}\n\n/** Answer a ring: open K from the ring and join straight away (no pre-join). */\nexport async function acceptRing(arbi: Arbi, ring: IncomingCall): Promise<boolean> {\n  // Accepting while in another call switches to the new one.\n  const current = callSession.getState().active\n  if (current && current.callExtId !== ring.call_ext_id) callSession.endActiveCall()\n  try {\n    const { key, token, title } = await arbi.calls.answer(ring)\n    callSession.setActiveCall({\n      callExtId: ring.call_ext_id,\n      key,\n      linkVersion: ring.link_version,\n      title: title || ring.caller_name,\n      isCreator: false,\n      chatExtId: ring.chat_ext_id ?? null,\n      logConversationExtId: ring.log_conversation_ext_id ?? null,\n      meetingConversationExtId: ring.meeting_conversation_ext_id ?? null,\n      lockedWorkspaceExtId: ring.context === 'thread' ? (ring.workspace_ext_id ?? null) : null,\n      phase: 'connected',\n      tokenResponse: token,\n      choices: DEFAULT_JOIN_CHOICES,\n      knock: null,\n      ringOnJoin: null,\n    })\n    return true\n  } catch (err) {\n    fail(err, 'join the call')\n    callSession.removeIncomingCall(ring.call_ext_id)\n    return false\n  }\n}\n\nexport function declineRing(arbi: Arbi, ring: IncomingCall): void {\n  callSession.removeIncomingCall(ring.call_ext_id)\n  arbi.calls\n    .decline(ring.call_ext_id)\n    .catch((err: unknown) => console.warn('[calls] decline failed', err))\n}\n\nconst KNOCK_POLL_MS = 2_000\n\n/**\n * Wait in the lobby: poll a knock until it is admitted (\u2192 token), denied or\n * expired (\u2192 throws). `signal` aborts the wait (the user gave up).\n */\nasync function waitForAdmission(\n  arbi: Arbi,\n  callExtId: string,\n  knock: Pick<calls.CallKnockResponse, 'knock_id'>,\n  signal: AbortSignal\n): Promise<calls.CallTokenResponse> {\n  for (;;) {\n    if (signal.aborted) throw new DOMException('Stopped waiting', 'AbortError')\n    await new Promise((resolve) => setTimeout(resolve, KNOCK_POLL_MS))\n    if (signal.aborted) throw new DOMException('Stopped waiting', 'AbortError')\n    const state = await arbi.calls.pollKnock(callExtId, knock.knock_id)\n    if (state.status === 'admitted' && state.token) return state.token\n    if (state.status === 'denied') throw new CallApiError('The host declined your request.', 403)\n    if (state.status === 'expired') throw new CallApiError('Nobody let you in. Try again.', 410)\n  }\n}\n\n/**\n * Pre-join done: get a token (or knock when the policy says so), connect, and\n * ring whoever this call was started for.\n */\nexport async function joinFromPreJoin(arbi: Arbi, choices: JoinChoices): Promise<void> {\n  const active = callSession.getState().active\n  if (!active) return\n  const { callExtId, linkVersion, inviteToken } = active\n  const update = (patch: Partial<ActiveCall>) => callSession.updateActiveCall(callExtId, patch)\n  try {\n    let tokenResponse: calls.CallTokenResponse\n    try {\n      // A personal invite link admits its account straight in (no lobby).\n      tokenResponse = await arbi.calls.token(callExtId, linkVersion, inviteToken)\n    } catch (err) {\n      if (!(err instanceof CallApiError && err.code === 'knock_required')) throw err\n      // Knock as the signed-in user (the server names me to the hosts from my account); the\n      // token comes at once when the policy lets us straight in.\n      const knock = await arbi.calls.knock(callExtId, linkVersion)\n      if (knock.status === 'admitted' && knock.token) tokenResponse = knock.token\n      else {\n        const controller = new AbortController()\n        update({ phase: 'knocking', choices, knock: { abort: () => controller.abort() } })\n        tokenResponse = await waitForAdmission(arbi, callExtId, knock, controller.signal)\n      }\n    }\n    if (callSession.getState().active?.callExtId !== callExtId) return // left meanwhile\n    update({ phase: 'connected', tokenResponse, choices, knock: null })\n    const ring = active.ringOnJoin\n    if (ring && Object.keys(ring).length) {\n      update({ ringOnJoin: null })\n      await arbi.calls\n        .ring(callExtId, ring, linkVersion)\n        .catch((err: unknown) => console.warn('[calls] ring failed', err))\n    }\n  } catch (err) {\n    if (err instanceof DOMException && err.name === 'AbortError') return\n    // A webinar's audience before go-live: \"Starting soon\", joining by itself once it is live.\n    if (err instanceof CallApiError && err.code === 'webinar_not_live') {\n      update({ phase: 'webinar-waiting', choices, knock: null })\n      return\n    }\n    fail(err, 'join the call')\n    if (callSession.getState().active?.callExtId === callExtId) {\n      callSession.endActiveCall()\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/calls/events.js

@@ -0,0 +1,138 @@
+import { calls } from "@arbidocs/sdk/browser";
+import { notify } from "../notifications/notify-store.js";
+import { callQueryKeys, invalidateCall, serverCallsExperimental } from "./keys.js";
+import { mutedNoticeFromEvent } from "./moderation.js";
+import { callSession } from "./session.js";
+const listeners = /* @__PURE__ */ new Map();
+function onCallEvent(type, listener) {
+  let set = listeners.get(type);
+  if (!set) listeners.set(type, set = /* @__PURE__ */ new Set());
+  set.add(listener);
+  return () => {
+    set.delete(listener);
+  };
+}
+function relay(type, message) {
+  if (!message) return;
+  for (const listener of listeners.get(type) ?? []) {
+    ;
+    listener(message);
+  }
+}
+const str = (value) => typeof value === "string" && value ? value : null;
+function applyCallEvent(queryClient, event, options = {}) {
+  const m = event;
+  const callExtId = str(m.call_ext_id);
+  switch (m.type) {
+    case "call.ringing": {
+      const ring = m;
+      const optedOut = options.acceptRings === false && serverCallsExperimental(queryClient);
+      if (optedOut || !callExtId || !ring.sealed_key) return true;
+      if (options.me && ring.caller_ext_id === options.me) return true;
+      callSession.enqueueIncomingCall({
+        call_ext_id: ring.call_ext_id,
+        room_name: ring.room_name,
+        caller_ext_id: ring.caller_ext_id,
+        caller_name: ring.caller_name,
+        chat_ext_id: ring.chat_ext_id ?? null,
+        log_conversation_ext_id: ring.log_conversation_ext_id ?? null,
+        meeting_conversation_ext_id: ring.meeting_conversation_ext_id ?? null,
+        workspace_ext_id: ring.workspace_ext_id ?? null,
+        context: ring.context ?? null,
+        sealed_key: ring.sealed_key,
+        link_version: ring.link_version,
+        title: ring.title ?? null
+      });
+      return true;
+    }
+    case "call.declined":
+      if (callExtId && callSession.getState().active?.callExtId === callExtId) {
+        notify.info("Call declined", { record: false, ambient: false });
+      }
+      return true;
+    case "call.started":
+      if (!callExtId) return true;
+      callSession.markCallLive(callExtId, {
+        chatExtId: str(m.chat_ext_id),
+        logConversationExtId: str(m.log_conversation_ext_id),
+        meetingConversationExtId: str(m.meeting_conversation_ext_id)
+      });
+      invalidateCall(queryClient, {
+        call_ext_id: callExtId,
+        log_conversation_ext_id: str(m.log_conversation_ext_id)
+      });
+      return true;
+    case "call.ended":
+      if (!callExtId) return true;
+      callSession.markCallEnded(callExtId);
+      invalidateCall(queryClient, {
+        call_ext_id: callExtId,
+        log_conversation_ext_id: str(m.log_conversation_ext_id)
+      });
+      return true;
+    case "call.knock": {
+      const knock = m;
+      if (!callExtId) return true;
+      callSession.addKnock({
+        callExtId,
+        knockId: knock.knock_id,
+        displayName: knock.display_name,
+        userExtId: knock.user_ext_id
+      });
+      return true;
+    }
+    case "call.knock_resolved": {
+      const knockId = str(m.knock_id);
+      if (knockId) callSession.removeKnock(knockId);
+      return true;
+    }
+    case "call.recording": {
+      if (callExtId)
+        void queryClient.invalidateQueries({ queryKey: callQueryKeys.recordingsOf(callExtId) });
+      const state = calls.recordingStateFrom(m);
+      relay("call.recording", callExtId && state ? { ...state, call_ext_id: callExtId } : null);
+      return true;
+    }
+    case "call.recording_updated": {
+      if (callExtId)
+        void queryClient.invalidateQueries({ queryKey: callQueryKeys.recordingsOf(callExtId) });
+      return true;
+    }
+    case "call.recording_deleted": {
+      if (callExtId)
+        void queryClient.invalidateQueries({ queryKey: callQueryKeys.recordingsOf(callExtId) });
+      const recordingExtId = str(m.recording_ext_id);
+      relay(
+        "call.recording_deleted",
+        callExtId && recordingExtId ? { call_ext_id: callExtId, recording_ext_id: recordingExtId } : null
+      );
+      return true;
+    }
+    case "call.transcription": {
+      const state = calls.transcriptionStateFrom(m);
+      relay("call.transcription", callExtId && state ? { ...state, call_ext_id: callExtId } : null);
+      return true;
+    }
+    case "call.webinar":
+      relay(
+        "call.webinar",
+        callExtId && typeof m.live === "boolean" ? {
+          type: "call.webinar",
+          call_ext_id: callExtId,
+          live: m.live,
+          chat: m.chat === "everyone" ? "everyone" : "panelists"
+        } : null
+      );
+      return true;
+    case "call.muted":
+      relay("call.muted", mutedNoticeFromEvent(m));
+      return true;
+    default:
+      return false;
+  }
+}
+export {
+  applyCallEvent,
+  onCallEvent
+};
+//# sourceMappingURL=events.js.map

package/dist/calls/events.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/calls/events.ts"],
+  "sourcesContent": ["/**\n * The calls' WebSocket events, applied in one place ({@link applyCallEvent}):\n *\n *   - rings, declines, lobby knocks and live/ended calls update the call session and the cache\n *     (the thread log card and chat call cards re-read their call);\n *   - what only an open view cares about \u2014 recording, transcription, webinar and moderation\n *     changes \u2014 is relayed to whoever listens ({@link onCallEvent}: the call room, recording cards,\n *     the webinar waiting screen).\n *\n * `<ArbiWebSocketProvider>` applies them to every `call.*` message; a host with its own socket\n * passes each one to `applyCallEvent`.\n */\n\nimport type { QueryClient } from '@tanstack/react-query'\nimport { calls } from '@arbidocs/sdk/browser'\nimport { notify } from '../notifications/notify-store'\nimport { callQueryKeys, invalidateCall, serverCallsExperimental } from './keys'\nimport { mutedNoticeFromEvent, type CallMutedNotice } from './moderation'\nimport { callSession } from './session'\n\n/** What each relayed event carries to its listeners. */\nexport interface CallRoomEvents {\n  'call.recording': calls.CallRecordingState & { call_ext_id: string }\n  'call.recording_deleted': { call_ext_id: string; recording_ext_id: string }\n  'call.transcription': calls.CallTranscriptionState & { call_ext_id: string }\n  'call.webinar': calls.CallWebinarMessage\n  'call.muted': CallMutedNotice & { callExtId: string }\n}\n\ntype RoomEventType = keyof CallRoomEvents\ntype Listener = (message: never) => void\nconst listeners = new Map<RoomEventType, Set<Listener>>()\n\n/** Listen to one relayed call event while a view is open. Returns the unsubscribe. */\nexport function onCallEvent<K extends RoomEventType>(\n  type: K,\n  listener: (message: CallRoomEvents[K]) => void\n): () => void {\n  let set = listeners.get(type)\n  if (!set) listeners.set(type, (set = new Set()))\n  set.add(listener as Listener)\n  return () => {\n    set.delete(listener as Listener)\n  }\n}\n\nfunction relay<K extends RoomEventType>(type: K, message: CallRoomEvents[K] | null): void {\n  if (!message) return\n  for (const listener of listeners.get(type) ?? []) {\n    ;(listener as (m: CallRoomEvents[K]) => void)(message)\n  }\n}\n\nexport interface ApplyCallEventOptions {\n  /** My user id: my own ring echoed to another tab or device of mine is not a ring. */\n  me?: string | null\n  /**\n   * Whether this person is rung. A host that keeps calls behind a switch passes false while it\n   * is off: the caller then just sees no answer, and a call link still opens. Ignored where the\n   * deployment made calls a regular feature (`experimental: false`): everyone is rung there.\n   */\n  acceptRings?: boolean\n}\n\nconst str = (value: unknown): string | null => (typeof value === 'string' && value ? value : null)\n\n/**\n * Apply one WebSocket event. Returns false for an event that is not a call event (so a host's\n * dispatcher can go on), true otherwise.\n */\nexport function applyCallEvent(\n  queryClient: QueryClient,\n  event: { type: string },\n  options: ApplyCallEventOptions = {}\n): boolean {\n  const m = event as Record<string, unknown> & { type: string }\n  const callExtId = str(m.call_ext_id)\n  switch (m.type) {\n    case 'call.ringing': {\n      const ring = m as unknown as calls.CallRingingMessage\n      const optedOut = options.acceptRings === false && serverCallsExperimental(queryClient)\n      if (optedOut || !callExtId || !ring.sealed_key) return true\n      if (options.me && ring.caller_ext_id === options.me) return true\n      callSession.enqueueIncomingCall({\n        call_ext_id: ring.call_ext_id,\n        room_name: ring.room_name,\n        caller_ext_id: ring.caller_ext_id,\n        caller_name: ring.caller_name,\n        chat_ext_id: ring.chat_ext_id ?? null,\n        log_conversation_ext_id: ring.log_conversation_ext_id ?? null,\n        meeting_conversation_ext_id: ring.meeting_conversation_ext_id ?? null,\n        workspace_ext_id: ring.workspace_ext_id ?? null,\n        context: ring.context ?? null,\n        sealed_key: ring.sealed_key,\n        link_version: ring.link_version,\n        title: ring.title ?? null,\n      })\n      return true\n    }\n    case 'call.declined':\n      if (callExtId && callSession.getState().active?.callExtId === callExtId) {\n        notify.info('Call declined', { record: false, ambient: false })\n      }\n      return true\n    case 'call.started':\n      if (!callExtId) return true\n      callSession.markCallLive(callExtId, {\n        chatExtId: str(m.chat_ext_id),\n        logConversationExtId: str(m.log_conversation_ext_id),\n        meetingConversationExtId: str(m.meeting_conversation_ext_id),\n      })\n      invalidateCall(queryClient, {\n        call_ext_id: callExtId,\n        log_conversation_ext_id: str(m.log_conversation_ext_id),\n      })\n      return true\n    case 'call.ended':\n      if (!callExtId) return true\n      callSession.markCallEnded(callExtId)\n      invalidateCall(queryClient, {\n        call_ext_id: callExtId,\n        log_conversation_ext_id: str(m.log_conversation_ext_id),\n      })\n      return true\n    case 'call.knock': {\n      // Lobby: someone asks to join the call we are in (we are its creator or an invitee).\n      const knock = m as unknown as calls.CallKnockMessage\n      if (!callExtId) return true\n      callSession.addKnock({\n        callExtId,\n        knockId: knock.knock_id,\n        displayName: knock.display_name,\n        userExtId: knock.user_ext_id,\n      })\n      return true\n    }\n    case 'call.knock_resolved': {\n      // Another host answered: clear the prompt here too.\n      const knockId = str(m.knock_id)\n      if (knockId) callSession.removeKnock(knockId)\n      return true\n    }\n    case 'call.recording': {\n      // The call's recording cards re-read their recordings.\n      if (callExtId)\n        void queryClient.invalidateQueries({ queryKey: callQueryKeys.recordingsOf(callExtId) })\n      const state = calls.recordingStateFrom(m)\n      relay('call.recording', callExtId && state ? { ...state, call_ext_id: callExtId } : null)\n      return true\n    }\n    case 'call.recording_updated': {\n      // A stopped recording's tail landed (a part committed after the stop): its cards re-read it.\n      if (callExtId)\n        void queryClient.invalidateQueries({ queryKey: callQueryKeys.recordingsOf(callExtId) })\n      return true\n    }\n    case 'call.recording_deleted': {\n      if (callExtId)\n        void queryClient.invalidateQueries({ queryKey: callQueryKeys.recordingsOf(callExtId) })\n      const recordingExtId = str(m.recording_ext_id)\n      relay(\n        'call.recording_deleted',\n        callExtId && recordingExtId\n          ? { call_ext_id: callExtId, recording_ext_id: recordingExtId }\n          : null\n      )\n      return true\n    }\n    case 'call.transcription': {\n      const state = calls.transcriptionStateFrom(m)\n      relay('call.transcription', callExtId && state ? { ...state, call_ext_id: callExtId } : null)\n      return true\n    }\n    case 'call.webinar':\n      relay(\n        'call.webinar',\n        callExtId && typeof m.live === 'boolean'\n          ? {\n              type: 'call.webinar',\n              call_ext_id: callExtId,\n              live: m.live,\n              chat: m.chat === 'everyone' ? 'everyone' : 'panelists',\n            }\n          : null\n      )\n      return true\n    case 'call.muted':\n      relay('call.muted', mutedNoticeFromEvent(m))\n      return true\n    default:\n      return false\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/calls/gate.js

@@ -0,0 +1,19 @@
+import { useFeature } from "../host/features.js";
+import { useIsEntitled } from "../account/entitlements.js";
+import { useServerCallsEnabled, useServerCallsExperimental } from "./hooks.js";
+function useCallsEnabled() {
+  const serverEnabled = useServerCallsEnabled();
+  const experimental = useServerCallsExperimental();
+  const switchedOn = useFeature("calls");
+  return serverEnabled && (switchedOn || !experimental);
+}
+function useCanHostCalls() {
+  const callsEnabled = useCallsEnabled();
+  const entitled = useIsEntitled("host_calls");
+  return callsEnabled && entitled;
+}
+export {
+  useCallsEnabled,
+  useCanHostCalls
+};
+//# sourceMappingURL=gate.js.map

package/dist/calls/gate.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/calls/gate.ts"],
+  "sourcesContent": ["/**\n * The call-UI gate. The call UI (call buttons, the incoming-call ringer, upcoming calls) shows only\n * when the server has calls enabled AND the host's `calls` feature is on (`useFeature('calls')`:\n * ARBI's Settings \u2192 Experimental toggle; a host that does not list it, on). The switch is an\n * experimental opt-in: on a deployment where calls are not experimental (`experimental: false`) the\n * call UI shows whatever it says. A call link opens whenever the server has calls enabled.\n */\n\nimport { useFeature } from '../host/features'\nimport { useIsEntitled } from '../account/entitlements'\nimport { useServerCallsEnabled, useServerCallsExperimental } from './hooks'\n\n/** The call UI shows: the server has calls AND (they are not experimental there OR the host's switch is on). */\nexport function useCallsEnabled(): boolean {\n  const serverEnabled = useServerCallsEnabled()\n  const experimental = useServerCallsExperimental()\n  const switchedOn = useFeature('calls')\n  return serverEnabled && (switchedOn || !experimental)\n}\n\n/**\n * Whether the person may HOST calls (start or schedule one, record one): the call UI is on and they\n * are entitled (Pro on the hosted service, an internal user on a Box). Joining a call someone else\n * hosts needs only `useCallsEnabled`.\n */\nexport function useCanHostCalls(): boolean {\n  const callsEnabled = useCallsEnabled()\n  const entitled = useIsEntitled('host_calls')\n  return callsEnabled && entitled\n}\n"],
+  "mappings": "AAQA,SAAS,kBAAkB;AAC3B,SAAS,qBAAqB;AAC9B,SAAS,uBAAuB,kCAAkC;AAG3D,SAAS,kBAA2B;AACzC,QAAM,gBAAgB,sBAAsB;AAC5C,QAAM,eAAe,2BAA2B;AAChD,QAAM,aAAa,WAAW,OAAO;AACrC,SAAO,kBAAkB,cAAc,CAAC;AAC1C;AAOO,SAAS,kBAA2B;AACzC,QAAM,eAAe,gBAAgB;AACrC,QAAM,WAAW,cAAc,YAAY;AAC3C,SAAO,gBAAgB;AACzB;",
+  "names": []
+}

package/dist/calls/hooks.js

@@ -0,0 +1,115 @@
+import { useCallback, useMemo } from "react";
+import { useQuery, useQueryClient } from "@tanstack/react-query";
+import { useArbi } from "../useArbi.js";
+import { callQueryKeys } from "./keys.js";
+import { meetingRefForCall } from "./recording.js";
+import { openRecording, transcribeRecording } from "./recording-media.js";
+import { recordingWindowsOf } from "./transcript-format.js";
+function useCallsConfig() {
+  const arbi = useArbi();
+  const { data } = useQuery({
+    queryKey: callQueryKeys.config(),
+    queryFn: () => arbi.calls.config(),
+    enabled: arbi.isLoggedIn,
+    staleTime: 5 * 6e4,
+    retry: false
+  });
+  return data;
+}
+function useServerCallsEnabled() {
+  return useCallsConfig()?.enabled === true;
+}
+function useServerCallsExperimental() {
+  return useCallsConfig()?.experimental !== false;
+}
+function useCallTranscriptionAvailable() {
+  return useCallsConfig()?.transcription_available === true;
+}
+function useCall(callExtId) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: callQueryKeys.call(callExtId ?? ""),
+    queryFn: () => arbi.calls.get(callExtId),
+    enabled: !!callExtId && arbi.isLoggedIn,
+    staleTime: 6e4,
+    retry: false
+  });
+}
+function useCallRecordings(callExtId, enabled = true) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: callQueryKeys.recordings(callExtId ?? ""),
+    queryFn: () => arbi.calls.recording.list(callExtId),
+    enabled: !!callExtId && enabled && arbi.isLoggedIn,
+    retry: false
+  });
+}
+function useCallRecording(callExtId, recordingExtId) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: callQueryKeys.recording(callExtId ?? "", recordingExtId ?? ""),
+    queryFn: () => arbi.calls.recording.get(callExtId, recordingExtId),
+    enabled: !!callExtId && !!recordingExtId && arbi.isLoggedIn,
+    retry: false
+  });
+}
+const NO_WINDOWS = [];
+function useRecordingWindows(callExtId, enabled) {
+  const { data } = useCallRecordings(callExtId, enabled);
+  return useMemo(() => data ? recordingWindowsOf(data) : NO_WINDOWS, [data]);
+}
+function useCallInviteLinks(callExtId) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: callQueryKeys.inviteLinks(callExtId ?? ""),
+    queryFn: () => arbi.calls.inviteLinks.list(callExtId),
+    enabled: !!callExtId && arbi.isLoggedIn,
+    retry: false
+  });
+}
+function useRecordingActions(call) {
+  const arbi = useArbi();
+  const queryClient = useQueryClient();
+  return useMemo(
+    () => ({
+      refresh: () => void queryClient.invalidateQueries({
+        queryKey: callQueryKeys.recordingsOf(call.external_id)
+      }),
+      open: (recording) => openRecording(arbi, queryClient, call, recording.external_id, recording),
+      transcribe: async (opened, onProgress) => transcribeRecording({
+        arbi,
+        queryClient,
+        callExtId: call.external_id,
+        opened,
+        ref: await meetingRefForCall(arbi, queryClient, call),
+        onProgress
+      })
+    }),
+    [arbi, queryClient, call]
+  );
+}
+function useRevokeCallInviteLink(callExtId) {
+  const arbi = useArbi();
+  const queryClient = useQueryClient();
+  return useCallback(
+    async (inviteExtId) => {
+      await arbi.calls.inviteLinks.revoke(callExtId, inviteExtId);
+      void queryClient.invalidateQueries({ queryKey: callQueryKeys.inviteLinks(callExtId) });
+    },
+    [arbi, queryClient, callExtId]
+  );
+}
+export {
+  useCall,
+  useCallInviteLinks,
+  useCallRecording,
+  useCallRecordings,
+  useCallTranscriptionAvailable,
+  useCallsConfig,
+  useRecordingActions,
+  useRecordingWindows,
+  useRevokeCallInviteLink,
+  useServerCallsEnabled,
+  useServerCallsExperimental
+};
+//# sourceMappingURL=hooks.js.map

package/dist/calls/hooks.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/calls/hooks.ts"],
+  "sourcesContent": ["/**\n * Call data hooks over `arbi.calls`: the deployment's calls config and a call by id. They need no\n * LiveKit; the room hooks live in the `@arbidocs/react/calls` entry.\n *\n * Requires an `ArbiHost` (with an `arbi`) and a React Query client above it.\n */\n\nimport { useCallback, useMemo } from 'react'\nimport { useQuery, useQueryClient } from '@tanstack/react-query'\nimport type { calls } from '@arbidocs/sdk/browser'\nimport { useArbi } from '../useArbi'\nimport { callQueryKeys } from './keys'\nimport { meetingRefForCall } from './recording'\nimport { openRecording, transcribeRecording, type OpenedRecording } from './recording-media'\nimport { recordingWindowsOf, type RecordingWindow } from './transcript-format'\n\n/**\n * The deployment's calls config. Any error (404 on a backend without calls, 5xx) reads as\n * \"disabled\", so call buttons simply stay hidden.\n */\nexport function useCallsConfig(): calls.CallsConfig | undefined {\n  const arbi = useArbi()\n  // A plain query (no abort signal): the header buttons remount while the app boots, and an\n  // aborted request must not stick as \"disabled\".\n  const { data } = useQuery({\n    queryKey: callQueryKeys.config(),\n    queryFn: () => arbi.calls.config(),\n    enabled: arbi.isLoggedIn,\n    staleTime: 5 * 60_000,\n    retry: false,\n  })\n  return data\n}\n\n/** Calls are available on this deployment (the server has LiveKit configured). */\nexport function useServerCallsEnabled(): boolean {\n  return useCallsConfig()?.enabled === true\n}\n\n/**\n * Calls are still experimental on this deployment (the default): the call UI shows only to people\n * who opted in with the host's switch. A deployment that made calls a regular feature\n * (`CALLS_EXPERIMENTAL=false`, `experimental: false`) shows it to everyone. Unknown reads as\n * experimental.\n */\nexport function useServerCallsExperimental(): boolean {\n  return useCallsConfig()?.experimental !== false\n}\n\n/** Whether this deployment has a transcriber. Any error reads as \"no\": the controls stay hidden. */\nexport function useCallTranscriptionAvailable(): boolean {\n  return useCallsConfig()?.transcription_available === true\n}\n\n/** A call by id (the thread log card, a chat's call card); refreshed by `call.started/ended`. */\nexport function useCall(callExtId: string | null | undefined) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: callQueryKeys.call(callExtId ?? ''),\n    queryFn: () => arbi.calls.get(callExtId!),\n    enabled: !!callExtId && arbi.isLoggedIn,\n    staleTime: 60_000,\n    retry: false,\n  })\n}\n\n/**\n * A call's recordings (readers only: members of its meeting chat). Kept fresh by the recording\n * events (`applyCallEvent`).\n */\nexport function useCallRecordings(callExtId: string | null | undefined, enabled = true) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: callQueryKeys.recordings(callExtId ?? ''),\n    queryFn: () => arbi.calls.recording.list(callExtId!),\n    enabled: !!callExtId && enabled && arbi.isLoggedIn,\n    retry: false,\n  })\n}\n\n/** One recording of a call. */\nexport function useCallRecording(\n  callExtId: string | null | undefined,\n  recordingExtId: string | null | undefined\n) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: callQueryKeys.recording(callExtId ?? '', recordingExtId ?? ''),\n    queryFn: () => arbi.calls.recording.get(callExtId!, recordingExtId!),\n    enabled: !!callExtId && !!recordingExtId && arbi.isLoggedIn,\n    retry: false,\n  })\n}\n\nconst NO_WINDOWS: RecordingWindow[] = []\n\n/**\n * The call's recordings as windows: a recording's transcript supersedes the live lines spoken while\n * it recorded. Fetched only when `enabled` (the transcript has lines from a recording), sharing the\n * recordings list's cache. Empty while loading or when the list cannot be read.\n */\nexport function useRecordingWindows(\n  callExtId: string | null | undefined,\n  enabled: boolean\n): RecordingWindow[] {\n  const { data } = useCallRecordings(callExtId, enabled)\n  return useMemo(() => (data ? recordingWindowsOf(data) : NO_WINDOWS), [data])\n}\n\n/** The personal invite links sent for a call (the host's people picker). */\nexport function useCallInviteLinks(callExtId: string | null | undefined) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: callQueryKeys.inviteLinks(callExtId ?? ''),\n    queryFn: () => arbi.calls.inviteLinks.list(callExtId!),\n    enabled: !!callExtId && arbi.isLoggedIn,\n    retry: false,\n  })\n}\n\n/**\n * What a recording card does with a call's recordings: re-read them, open one (its track keys,\n * unwrapped under the meeting chat's or workspace's key), and transcribe one into the meeting chat.\n */\nexport function useRecordingActions(call: calls.CallResponse) {\n  const arbi = useArbi()\n  const queryClient = useQueryClient()\n  return useMemo(\n    () => ({\n      refresh: () =>\n        void queryClient.invalidateQueries({\n          queryKey: callQueryKeys.recordingsOf(call.external_id),\n        }),\n      open: (recording: calls.CallRecording): Promise<OpenedRecording> =>\n        openRecording(arbi, queryClient, call, recording.external_id, recording),\n      transcribe: async (\n        opened: OpenedRecording,\n        onProgress: (done: number, total: number) => void\n      ) =>\n        transcribeRecording({\n          arbi,\n          queryClient,\n          callExtId: call.external_id,\n          opened,\n          ref: await meetingRefForCall(arbi, queryClient, call),\n          onProgress,\n        }),\n    }),\n    [arbi, queryClient, call]\n  )\n}\n\n/** Revoke a personal invite link of a call I host; the list re-reads. */\nexport function useRevokeCallInviteLink(callExtId: string) {\n  const arbi = useArbi()\n  const queryClient = useQueryClient()\n  return useCallback(\n    async (inviteExtId: string) => {\n      await arbi.calls.inviteLinks.revoke(callExtId, inviteExtId)\n      void queryClient.invalidateQueries({ queryKey: callQueryKeys.inviteLinks(callExtId) })\n    },\n    [arbi, queryClient, callExtId]\n  )\n}\n"],
+  "mappings": "AAOA,SAAS,aAAa,eAAe;AACrC,SAAS,UAAU,sBAAsB;AAEzC,SAAS,eAAe;AACxB,SAAS,qBAAqB;AAC9B,SAAS,yBAAyB;AAClC,SAAS,eAAe,2BAAiD;AACzE,SAAS,0BAAgD;AAMlD,SAAS,iBAAgD;AAC9D,QAAM,OAAO,QAAQ;AAGrB,QAAM,EAAE,KAAK,IAAI,SAAS;AAAA,IACxB,UAAU,cAAc,OAAO;AAAA,IAC/B,SAAS,MAAM,KAAK,MAAM,OAAO;AAAA,IACjC,SAAS,KAAK;AAAA,IACd,WAAW,IAAI;AAAA,IACf,OAAO;AAAA,EACT,CAAC;AACD,SAAO;AACT;AAGO,SAAS,wBAAiC;AAC/C,SAAO,eAAe,GAAG,YAAY;AACvC;AAQO,SAAS,6BAAsC;AACpD,SAAO,eAAe,GAAG,iBAAiB;AAC5C;AAGO,SAAS,gCAAyC;AACvD,SAAO,eAAe,GAAG,4BAA4B;AACvD;AAGO,SAAS,QAAQ,WAAsC;AAC5D,QAAM,OAAO,QAAQ;AACrB,SAAO,SAAS;AAAA,IACd,UAAU,cAAc,KAAK,aAAa,EAAE;AAAA,IAC5C,SAAS,MAAM,KAAK,MAAM,IAAI,SAAU;AAAA,IACxC,SAAS,CAAC,CAAC,aAAa,KAAK;AAAA,IAC7B,WAAW;AAAA,IACX,OAAO;AAAA,EACT,CAAC;AACH;AAMO,SAAS,kBAAkB,WAAsC,UAAU,MAAM;AACtF,QAAM,OAAO,QAAQ;AACrB,SAAO,SAAS;AAAA,IACd,UAAU,cAAc,WAAW,aAAa,EAAE;AAAA,IAClD,SAAS,MAAM,KAAK,MAAM,UAAU,KAAK,SAAU;AAAA,IACnD,SAAS,CAAC,CAAC,aAAa,WAAW,KAAK;AAAA,IACxC,OAAO;AAAA,EACT,CAAC;AACH;AAGO,SAAS,iBACd,WACA,gBACA;AACA,QAAM,OAAO,QAAQ;AACrB,SAAO,SAAS;AAAA,IACd,UAAU,cAAc,UAAU,aAAa,IAAI,kBAAkB,EAAE;AAAA,IACvE,SAAS,MAAM,KAAK,MAAM,UAAU,IAAI,WAAY,cAAe;AAAA,IACnE,SAAS,CAAC,CAAC,aAAa,CAAC,CAAC,kBAAkB,KAAK;AAAA,IACjD,OAAO;AAAA,EACT,CAAC;AACH;AAEA,MAAM,aAAgC,CAAC;AAOhC,SAAS,oBACd,WACA,SACmB;AACnB,QAAM,EAAE,KAAK,IAAI,kBAAkB,WAAW,OAAO;AACrD,SAAO,QAAQ,MAAO,OAAO,mBAAmB,IAAI,IAAI,YAAa,CAAC,IAAI,CAAC;AAC7E;AAGO,SAAS,mBAAmB,WAAsC;AACvE,QAAM,OAAO,QAAQ;AACrB,SAAO,SAAS;AAAA,IACd,UAAU,cAAc,YAAY,aAAa,EAAE;AAAA,IACnD,SAAS,MAAM,KAAK,MAAM,YAAY,KAAK,SAAU;AAAA,IACrD,SAAS,CAAC,CAAC,aAAa,KAAK;AAAA,IAC7B,OAAO;AAAA,EACT,CAAC;AACH;AAMO,SAAS,oBAAoB,MAA0B;AAC5D,QAAM,OAAO,QAAQ;AACrB,QAAM,cAAc,eAAe;AACnC,SAAO;AAAA,IACL,OAAO;AAAA,MACL,SAAS,MACP,KAAK,YAAY,kBAAkB;AAAA,QACjC,UAAU,cAAc,aAAa,KAAK,WAAW;AAAA,MACvD,CAAC;AAAA,MACH,MAAM,CAAC,cACL,cAAc,MAAM,aAAa,MAAM,UAAU,aAAa,SAAS;AAAA,MACzE,YAAY,OACV,QACA,eAEA,oBAAoB;AAAA,QAClB;AAAA,QACA;AAAA,QACA,WAAW,KAAK;AAAA,QAChB;AAAA,QACA,KAAK,MAAM,kBAAkB,MAAM,aAAa,IAAI;AAAA,QACpD;AAAA,MACF,CAAC;AAAA,IACL;AAAA,IACA,CAAC,MAAM,aAAa,IAAI;AAAA,EAC1B;AACF;AAGO,SAAS,wBAAwB,WAAmB;AACzD,QAAM,OAAO,QAAQ;AACrB,QAAM,cAAc,eAAe;AACnC,SAAO;AAAA,IACL,OAAO,gBAAwB;AAC7B,YAAM,KAAK,MAAM,YAAY,OAAO,WAAW,WAAW;AAC1D,WAAK,YAAY,kBAAkB,EAAE,UAAU,cAAc,YAAY,SAAS,EAAE,CAAC;AAAA,IACvF;AAAA,IACA,CAAC,MAAM,aAAa,SAAS;AAAA,EAC/B;AACF;",
+  "names": []
+}