@broberg/call 0.1.0 → 0.2.0

package/README.md

@@ -1,12 +1,12 @@
 # @broberg/call
 
-Voice calls for 2–10 people, like a Slack huddle: the app decides who may enter a room, the audio goes through a self-hosted LiveKit media server (SFU) in the EU, and the browser gets mute, output mute, device choice, per-person volume, who-is-speaking and the participant list. Audio only in 0.1.0. Epic F104.
+Voice calls for 2–10 people, like a Slack huddle: the app decides who may enter a room, the audio goes through a self-hosted LiveKit media server (SFU) in the EU, and the browser gets mute, output mute, device choice, per-person volume, who-is-speaking and the participant list. Camera and screen share since 0.2.0 (opt-in per ticket). Epic F104.
 
 ```bash
 npm i @broberg/call
 ```
 
-> **Renamed from `@broberg/voice` (F104.6).** `@broberg/call` 0.1.0 is `@broberg/voice` 0.2.0 under a new name — same API, same server. Moving over means changing the import path only: `@broberg/voice/server` → `@broberg/call/server`, `@broberg/voice/client` → `@broberg/call/client`. Camera and screen share come in 0.2.0 (F104.7); recording is planned (F104.9).
+> **Renamed from `@broberg/voice` (F104.6).** `@broberg/call` 0.1.0 is `@broberg/voice` 0.2.0 under a new name — same API, same server. Moving over means changing the import path only: `@broberg/voice/server` → `@broberg/call/server`, `@broberg/voice/client` → `@broberg/call/client`. Camera and screen share arrived in 0.2.0 (F104.7); recording is planned (F104.9).
 >
 > **Server:** the shared LiveKit media server `broberg-voice` (Fly `arn`, voice.broberg.ai, F104.2) with TURN over TLS on 443 in `broberg-voice-turn` (F104.5); both owned by components.
 
@@ -31,7 +31,8 @@ if (event.event === "participant_joined") { /* … */ }
 ```
 
 - **Listen-only (0.2.0):** `createRoomToken({ …, canPublish: false })` gives a ticket that can join and hear everyone but publish nothing — pair it with `joinVoice({ url, token, publish: false })`, which never opens the microphone (`call.muted` is `true`; `unmute()` would be refused by the server).
-- The ticket admits to **one room**, may **only publish the microphone** (no camera, screen or data channel), and may listen to everyone in the room.
+- The ticket admits to **one room**, may **only publish the microphone** unless you pass `sources` (never the data channel), and may listen to everyone in the room.
+- **Camera and screen share (0.2.0):** `createRoomToken({ …, sources: ["microphone", "camera", "screen_share", "screen_share_audio"] })` — the ticket allows exactly the sources named. Leave `sources` out and it is microphone-only, as before, so an app that never asks for video keeps a sound-only ticket. Empty or unknown sources, and `sources` together with `canPublish: false`, are refused (`VoiceError` `invalid_sources`).
 - Missing `apiKey`/`apiSecret` is refused (`VoiceError` `missing_credentials`) — LiveKit's SDK would otherwise silently fall back to `LIVEKIT_*` from the environment.
 - Every rejection of a webhook (changed body, wrong secret, missing header) is `VoiceError` `invalid_webhook`.
 
@@ -52,10 +53,20 @@ call.setVolume(identity, 0.5);                       // … each person's own vo
 await call.setInputDevice(deviceId);                 // from navigator.mediaDevices.enumerateDevices()
 await call.setOutputDevice(deviceId);
 await call.leave();                                  // disconnects; no callback fires after this
+
+// 0.2.0 — camera and screen share (the ticket must allow them, see `sources`)
+await call.setScreenShare(true);                     // the browser asks which screen/window/tab; { audio: true } offers tab sound
+await call.setCamera(true, { deviceId });            // deviceId optional
+call.localMedia;                                     // { camera, screenShare } — what you send now
+call.onLocalMedia((m) => setButtons(m));             // at once + on every change, INCLUDING the browser's own «stop sharing» button
+call.onVideos((videos) => renderTiles(videos));      // [{ id, identity, name, isLocal, source: "camera"|"screen_share", attach(el), detach(el) }]
+videos[0].attach(videoEl);                           // sets autoplay + playsinline; your own picture is muted
+call.setAudioOnly(true);                             // weak connection: stop receiving others' video, keep sound
 ```
 
 - The microphone opens with **noise suppression, echo cancellation and auto gain** on.
 - If joining fails — the microphone is refused, the ticket is rejected — `joinVoice` rejects AND disconnects first, so nobody is left in the room listening without a way to leave.
 - Other people's audio is attached to hidden `<audio>` elements and removed when they leave.
 - Reconnection after a network drop (ICE restart, resume) is LiveKit's own.
+- **2–10 people with video:** the room runs with simulcast (each camera is sent in several sizes), adaptive stream (you only receive the size your tile shows) and dynacast (sizes nobody watches are paused) — `VIDEO_ROOM_OPTIONS`. Video is never added to the page by the package; the app places each picture with `attach`.
 - The package draws no UI. If you build one, give every control a `data-testid`.

package/dist/client.cjs

@@ -3,9 +3,14 @@
 var livekitClient = require('livekit-client');
 
 // src/client.ts
+var VIDEO_ROOM_OPTIONS = { adaptiveStream: true, dynacast: true, publishDefaults: { simulcast: true } };
 var AUDIO_CAPTURE = { noiseSuppression: true, echoCancellation: true, autoGainControl: true };
 async function joinVoice({ url, token, publish = true }) {
-  const room = new livekitClient.Room({ audioCaptureDefaults: { ...AUDIO_CAPTURE } });
+  const room = new livekitClient.Room({ audioCaptureDefaults: { ...AUDIO_CAPTURE }, ...VIDEO_ROOM_OPTIONS, publishDefaults: { ...VIDEO_ROOM_OPTIONS.publishDefaults } });
+  const localMediaCbs = /* @__PURE__ */ new Set();
+  const videoCbs = /* @__PURE__ */ new Set();
+  const remoteVideos = /* @__PURE__ */ new Map();
+  let audioOnly = false;
   const speakingCbs = /* @__PURE__ */ new Set();
   const participantCbs = /* @__PURE__ */ new Set();
   const volumes = /* @__PURE__ */ new Map();
@@ -23,6 +28,35 @@ async function joinVoice({ url, token, publish = true }) {
     participantCbs.forEach((cb) => cb(list));
   };
   const applyVolume = (p) => p.setVolume(outputMuted ? 0 : volumes.get(p.identity) ?? 1);
+  const localMedia = () => ({
+    camera: room.localParticipant.isCameraEnabled,
+    screenShare: room.localParticipant.isScreenShareEnabled
+  });
+  const emitLocalMedia = () => {
+    if (left) return;
+    const m = localMedia();
+    localMediaCbs.forEach((cb) => cb(m));
+  };
+  const videos = () => {
+    const local = [];
+    for (const pub of room.localParticipant.videoTrackPublications.values()) {
+      const v = localVideo(pub, room.localParticipant);
+      if (v) local.push(v);
+    }
+    return [...local, ...remoteVideos.values()];
+  };
+  const emitVideos = () => {
+    if (left) return;
+    const list = videos();
+    videoCbs.forEach((cb) => cb(list));
+  };
+  const onLocalChange = () => {
+    emitLocalMedia();
+    emitVideos();
+  };
+  const applyAudioOnly = (pub) => {
+    if (pub.kind === livekitClient.Track.Kind.Video) pub.setSubscribed(!audioOnly);
+  };
   const handlers = [
     [livekitClient.RoomEvent.ParticipantConnected, (p) => {
       applyVolume(p);
@@ -35,6 +69,13 @@ async function joinVoice({ url, token, publish = true }) {
       speakingCbs.forEach((cb) => cb(ids));
     }],
     [livekitClient.RoomEvent.TrackSubscribed, (track, _pub, p) => {
+      if (track.kind === livekitClient.Track.Kind.Video) {
+        const source = toVideoSource(track.source);
+        if (!source) return;
+        remoteVideos.set(track, videoOf(`${p.identity}:${track.sid ?? source}`, p, false, source, track));
+        emitVideos();
+        return;
+      }
       if (track.kind !== livekitClient.Track.Kind.Audio) return;
       const el = track.attach();
       document.body.appendChild(el);
@@ -42,9 +83,22 @@ async function joinVoice({ url, token, publish = true }) {
       applyVolume(p);
     }],
     [livekitClient.RoomEvent.TrackUnsubscribed, (track) => {
+      if (remoteVideos.delete(track)) {
+        track.detach();
+        emitVideos();
+        return;
+      }
       track.detach().forEach((el) => el.remove());
       audioEls.delete(track);
-    }]
+    }],
+    [livekitClient.RoomEvent.TrackPublished, (pub) => {
+      if (audioOnly) applyAudioOnly(pub);
+    }],
+    // Fired for our own camera/screen going on or off — including when the
+    // person ends a screen share with the BROWSER's stop button, which never
+    // passes through setScreenShare.
+    [livekitClient.RoomEvent.LocalTrackPublished, onLocalChange],
+    [livekitClient.RoomEvent.LocalTrackUnpublished, onLocalChange]
   ];
   for (const [event, fn] of handlers) room.on(event, fn);
   try {
@@ -93,22 +147,83 @@ async function joinVoice({ url, token, publish = true }) {
       if (!left) cb(participants());
       return () => participantCbs.delete(cb);
     },
+    async setCamera(on, opts) {
+      await room.localParticipant.setCameraEnabled(on, opts?.deviceId ? { deviceId: opts.deviceId } : void 0);
+      onLocalChange();
+    },
+    async setScreenShare(on, opts) {
+      await room.localParticipant.setScreenShareEnabled(on, on ? { audio: opts?.audio === true } : void 0);
+      onLocalChange();
+    },
+    get localMedia() {
+      return localMedia();
+    },
+    onLocalMedia(cb) {
+      localMediaCbs.add(cb);
+      if (!left) cb(localMedia());
+      return () => localMediaCbs.delete(cb);
+    },
+    onVideos(cb) {
+      videoCbs.add(cb);
+      if (!left) cb(videos());
+      return () => videoCbs.delete(cb);
+    },
+    get audioOnly() {
+      return audioOnly;
+    },
+    setAudioOnly(on) {
+      audioOnly = on;
+      room.remoteParticipants.forEach((p) => p.trackPublications.forEach(applyAudioOnly));
+    },
     async leave() {
       left = true;
       for (const [event, fn] of handlers) room.off(event, fn);
       speakingCbs.clear();
       participantCbs.clear();
+      localMediaCbs.clear();
+      videoCbs.clear();
+      remoteVideos.forEach((_v, track) => track.detach());
+      remoteVideos.clear();
       audioEls.forEach((_els, track) => track.detach().forEach((el) => el.remove()));
       audioEls.clear();
       await room.disconnect();
     }
   };
 }
+function toVideoSource(source) {
+  if (source === livekitClient.Track.Source.Camera) return "camera";
+  if (source === livekitClient.Track.Source.ScreenShare) return "screen_share";
+  return void 0;
+}
+function localVideo(pub, p) {
+  const source = toVideoSource(pub.source);
+  if (!pub.track || !source) return void 0;
+  return videoOf(`${p.identity}:${pub.trackSid}`, p, true, source, pub.track);
+}
+function videoOf(id, p, isLocal, source, track) {
+  return {
+    id,
+    identity: p.identity,
+    name: p.name || p.identity,
+    isLocal,
+    source,
+    attach(el) {
+      el.autoplay = true;
+      el.playsInline = true;
+      if (isLocal) el.muted = true;
+      track.attach(el);
+    },
+    detach(el) {
+      track.detach(el);
+    }
+  };
+}
 function toVoiceParticipant(p, isLocal) {
   return { identity: p.identity, name: p.name || p.identity, isLocal };
 }
 
 exports.AUDIO_CAPTURE = AUDIO_CAPTURE;
+exports.VIDEO_ROOM_OPTIONS = VIDEO_ROOM_OPTIONS;
 exports.joinVoice = joinVoice;
 //# sourceMappingURL=client.cjs.map
 //# sourceMappingURL=client.cjs.map

package/dist/client.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts"],"names":["Room","RoomEvent","Track"],"mappings":"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","file":"client.cjs","sourcesContent":["// @broberg/call/client — the browser's half of a voice call (F104.3).\n//\n// A thin layer over livekit-client that does the four things every app would\n// otherwise get slightly wrong on its own: open the microphone with noise\n// suppression, echo cancellation and auto gain; actually PLAY the other people\n// (a subscribed audio track is silent until it is attached to an element);\n// keep \"mute everyone\" and per-person volume apart so unmuting restores what\n// each person was set to; and stop calling the app back after leave().\n// No node: imports.\n\nimport { Room, RoomEvent, Track } from \"livekit-client\";\nimport type { Participant, RemoteParticipant, RemoteTrack } from \"livekit-client\";\n\nexport interface VoiceParticipant {\n  identity: string;\n  name: string;\n  isLocal: boolean;\n}\n\nexport interface JoinOptions {\n  /** The media server, e.g. `wss://voice.broberg.ai`. */\n  url: string;\n  /** A ticket from `createRoomToken` on the app's server. */\n  token: string;\n  /**\n   * F104.4 — `false` joins as a listener: the microphone is never opened\n   * (a listen-only ticket would be refused if it tried). Default `true`.\n   */\n  publish?: boolean;\n}\n\nexport interface VoiceCall {\n  mute(): Promise<void>;\n  unmute(): Promise<void>;\n  readonly muted: boolean;\n  /** Silence everyone else (true) or bring back each person's own volume (false). */\n  setOutputMuted(muted: boolean): void;\n  setInputDevice(deviceId: string): Promise<void>;\n  setOutputDevice(deviceId: string): Promise<void>;\n  /** 0–1 for one person. Kept while output is muted and applied on unmute. */\n  setVolume(identity: string, volume: number): void;\n  /** Identities of the people speaking right now, loudest first. Returns an unsubscribe. */\n  onSpeaking(cb: (identities: string[]) => void): () => void;\n  /** Everyone in the call, you included; called at once and on every join/leave. Returns an unsubscribe. */\n  onParticipants(cb: (participants: VoiceParticipant[]) => void): () => void;\n  leave(): Promise<void>;\n}\n\nexport const AUDIO_CAPTURE = { noiseSuppression: true, echoCancellation: true, autoGainControl: true } as const;\n\nexport async function joinVoice({ url, token, publish = true }: JoinOptions): Promise<VoiceCall> {\n  const room = new Room({ audioCaptureDefaults: { ...AUDIO_CAPTURE } });\n  const speakingCbs = new Set<(ids: string[]) => void>();\n  const participantCbs = new Set<(ps: VoiceParticipant[]) => void>();\n  const volumes = new Map<string, number>();\n  const audioEls = new Map<RemoteTrack, HTMLMediaElement[]>();\n  let outputMuted = false;\n  let muted = !publish;\n  let left = false;\n\n  const participants = (): VoiceParticipant[] => [\n    toVoiceParticipant(room.localParticipant, true),\n    ...[...room.remoteParticipants.values()].map((p) => toVoiceParticipant(p, false)),\n  ];\n  const emitParticipants = () => {\n    if (left) return;\n    const list = participants();\n    participantCbs.forEach((cb) => cb(list));\n  };\n  const applyVolume = (p: RemoteParticipant) => p.setVolume(outputMuted ? 0 : (volumes.get(p.identity) ?? 1));\n\n  const handlers: [RoomEvent, (...args: any[]) => void][] = [\n    [RoomEvent.ParticipantConnected, (p: RemoteParticipant) => { applyVolume(p); emitParticipants(); }],\n    [RoomEvent.ParticipantDisconnected, () => emitParticipants()],\n    [RoomEvent.ActiveSpeakersChanged, (speakers: Participant[]) => {\n      if (left) return;\n      const ids = speakers.map((s) => s.identity);\n      speakingCbs.forEach((cb) => cb(ids));\n    }],\n    [RoomEvent.TrackSubscribed, (track: RemoteTrack, _pub: unknown, p: RemoteParticipant) => {\n      if (track.kind !== Track.Kind.Audio) return;\n      const el = track.attach();\n      document.body.appendChild(el);\n      audioEls.set(track, [el]);\n      applyVolume(p);\n    }],\n    [RoomEvent.TrackUnsubscribed, (track: RemoteTrack) => {\n      track.detach().forEach((el) => el.remove());\n      audioEls.delete(track);\n    }],\n  ];\n  for (const [event, fn] of handlers) room.on(event, fn);\n\n  try {\n    await room.connect(url, token);\n    if (publish) await room.localParticipant.setMicrophoneEnabled(true, { ...AUDIO_CAPTURE });\n    // joinVoice is called from a click; this is the gesture browsers require before audio may play.\n    await room.startAudio();\n  } catch (e) {\n    // A refused microphone must not leave the person connected and listening\n    // with no handle to leave — the caller only gets the rejection.\n    left = true;\n    for (const [event, fn] of handlers) room.off(event, fn);\n    await room.disconnect();\n    throw e;\n  }\n\n  return {\n    get muted() { return muted; },\n    async mute() { await room.localParticipant.setMicrophoneEnabled(false); muted = true; },\n    async unmute() { await room.localParticipant.setMicrophoneEnabled(true, { ...AUDIO_CAPTURE }); muted = false; },\n    setOutputMuted(m) {\n      outputMuted = m;\n      room.remoteParticipants.forEach(applyVolume);\n    },\n    async setInputDevice(deviceId) { await room.switchActiveDevice(\"audioinput\", deviceId); },\n    async setOutputDevice(deviceId) { await room.switchActiveDevice(\"audiooutput\", deviceId); },\n    setVolume(identity, volume) {\n      volumes.set(identity, Math.min(1, Math.max(0, volume)));\n      const p = room.remoteParticipants.get(identity);\n      if (p) applyVolume(p);\n    },\n    onSpeaking(cb) {\n      speakingCbs.add(cb);\n      return () => speakingCbs.delete(cb);\n    },\n    onParticipants(cb) {\n      participantCbs.add(cb);\n      if (!left) cb(participants());\n      return () => participantCbs.delete(cb);\n    },\n    async leave() {\n      left = true;\n      for (const [event, fn] of handlers) room.off(event, fn);\n      speakingCbs.clear();\n      participantCbs.clear();\n      audioEls.forEach((_els, track) => track.detach().forEach((el) => el.remove()));\n      audioEls.clear();\n      await room.disconnect();\n    },\n  };\n}\n\nfunction toVoiceParticipant(p: Participant, isLocal: boolean): VoiceParticipant {\n  return { identity: p.identity, name: p.name || p.identity, isLocal };\n}\n"]}
+{"version":3,"sources":["../src/client.ts"],"names":["Room","Track","RoomEvent"],"mappings":"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","file":"client.cjs","sourcesContent":["// @broberg/call/client — the browser's half of a call (F104.3; camera + screen share F104.7).\n//\n// A thin layer over livekit-client that does the four things every app would\n// otherwise get slightly wrong on its own: open the microphone with noise\n// suppression, echo cancellation and auto gain; actually PLAY the other people\n// (a subscribed audio track is silent until it is attached to an element);\n// keep \"mute everyone\" and per-person volume apart so unmuting restores what\n// each person was set to; and stop calling the app back after leave().\n// F104.7 adds camera and screen share: simulcast + adaptive stream + dynacast\n// so 2–10 people with video stay usable, the browser's own «stop sharing»\n// button is reported back to the app, and audio-only drops incoming video.\n// No node: imports.\n\nimport { Room, RoomEvent, Track } from \"livekit-client\";\nimport type { LocalTrackPublication, Participant, RemoteParticipant, RemoteTrack, RemoteTrackPublication } from \"livekit-client\";\n\nexport interface VoiceParticipant {\n  identity: string;\n  name: string;\n  isLocal: boolean;\n}\n\n/** F104.7 — one video picture in the call: a camera or a shared screen, yours or someone else's. */\nexport interface CallVideo {\n  /** Stable for as long as this picture exists — use it as a render key. */\n  id: string;\n  identity: string;\n  name: string;\n  isLocal: boolean;\n  source: \"camera\" | \"screen_share\";\n  /** Show it in a `<video>` element (autoplay + playsinline are set for you). */\n  attach(el: HTMLVideoElement): void;\n  detach(el: HTMLVideoElement): void;\n}\n\n/** F104.7 — what you are sending right now. */\nexport interface LocalMedia {\n  camera: boolean;\n  screenShare: boolean;\n}\n\nexport interface JoinOptions {\n  /** The media server, e.g. `wss://voice.broberg.ai`. */\n  url: string;\n  /** A ticket from `createRoomToken` on the app's server. */\n  token: string;\n  /**\n   * F104.4 — `false` joins as a listener: the microphone is never opened\n   * (a listen-only ticket would be refused if it tried). Default `true`.\n   */\n  publish?: boolean;\n}\n\nexport interface VoiceCall {\n  mute(): Promise<void>;\n  unmute(): Promise<void>;\n  readonly muted: boolean;\n  /** Silence everyone else (true) or bring back each person's own volume (false). */\n  setOutputMuted(muted: boolean): void;\n  setInputDevice(deviceId: string): Promise<void>;\n  setOutputDevice(deviceId: string): Promise<void>;\n  /** 0–1 for one person. Kept while output is muted and applied on unmute. */\n  setVolume(identity: string, volume: number): void;\n  /** Identities of the people speaking right now, loudest first. Returns an unsubscribe. */\n  onSpeaking(cb: (identities: string[]) => void): () => void;\n  /** Everyone in the call, you included; called at once and on every join/leave. Returns an unsubscribe. */\n  onParticipants(cb: (participants: VoiceParticipant[]) => void): () => void;\n  /** F104.7 — turn your camera on or off. Needs a ticket with `\"camera\"` in `sources`. */\n  setCamera(on: boolean, opts?: { deviceId?: string }): Promise<void>;\n  /**\n   * F104.7 — share your screen (the browser asks which screen/window/tab) or stop.\n   * `audio: true` also offers the tab's sound (needs `\"screen_share_audio\"` in the ticket).\n   * Stopping with the browser's own «stop sharing» button is reported through `onLocalMedia`.\n   */\n  setScreenShare(on: boolean, opts?: { audio?: boolean }): Promise<void>;\n  readonly localMedia: LocalMedia;\n  /** Called at once and whenever your camera/screen share turns on or off — also from the browser's own stop button. Returns an unsubscribe. */\n  onLocalMedia(cb: (media: LocalMedia) => void): () => void;\n  /** Every video picture in the call (yours included), at once and whenever one comes or goes. Returns an unsubscribe. */\n  onVideos(cb: (videos: CallVideo[]) => void): () => void;\n  /** F104.7 — `true` stops receiving other people's video (weak connection); sound is untouched. `false` brings it back. */\n  setAudioOnly(on: boolean): void;\n  readonly audioOnly: boolean;\n  leave(): Promise<void>;\n}\n\n/** F104.7 — the room settings that keep 2–10 people with video usable. */\nexport const VIDEO_ROOM_OPTIONS = { adaptiveStream: true, dynacast: true, publishDefaults: { simulcast: true } } as const;\n\nexport const AUDIO_CAPTURE = { noiseSuppression: true, echoCancellation: true, autoGainControl: true } as const;\n\nexport async function joinVoice({ url, token, publish = true }: JoinOptions): Promise<VoiceCall> {\n  const room = new Room({ audioCaptureDefaults: { ...AUDIO_CAPTURE }, ...VIDEO_ROOM_OPTIONS, publishDefaults: { ...VIDEO_ROOM_OPTIONS.publishDefaults } });\n  const localMediaCbs = new Set<(m: LocalMedia) => void>();\n  const videoCbs = new Set<(v: CallVideo[]) => void>();\n  const remoteVideos = new Map<RemoteTrack, CallVideo>();\n  let audioOnly = false;\n  const speakingCbs = new Set<(ids: string[]) => void>();\n  const participantCbs = new Set<(ps: VoiceParticipant[]) => void>();\n  const volumes = new Map<string, number>();\n  const audioEls = new Map<RemoteTrack, HTMLMediaElement[]>();\n  let outputMuted = false;\n  let muted = !publish;\n  let left = false;\n\n  const participants = (): VoiceParticipant[] => [\n    toVoiceParticipant(room.localParticipant, true),\n    ...[...room.remoteParticipants.values()].map((p) => toVoiceParticipant(p, false)),\n  ];\n  const emitParticipants = () => {\n    if (left) return;\n    const list = participants();\n    participantCbs.forEach((cb) => cb(list));\n  };\n  const applyVolume = (p: RemoteParticipant) => p.setVolume(outputMuted ? 0 : (volumes.get(p.identity) ?? 1));\n\n  const localMedia = (): LocalMedia => ({\n    camera: room.localParticipant.isCameraEnabled,\n    screenShare: room.localParticipant.isScreenShareEnabled,\n  });\n  const emitLocalMedia = () => {\n    if (left) return;\n    const m = localMedia();\n    localMediaCbs.forEach((cb) => cb(m));\n  };\n  const videos = (): CallVideo[] => {\n    const local: CallVideo[] = [];\n    for (const pub of room.localParticipant.videoTrackPublications.values()) {\n      const v = localVideo(pub, room.localParticipant);\n      if (v) local.push(v);\n    }\n    return [...local, ...remoteVideos.values()];\n  };\n  const emitVideos = () => {\n    if (left) return;\n    const list = videos();\n    videoCbs.forEach((cb) => cb(list));\n  };\n  const onLocalChange = () => { emitLocalMedia(); emitVideos(); };\n  // Audio-only only ever touches VIDEO publications — sound keeps flowing.\n  const applyAudioOnly = (pub: RemoteTrackPublication) => {\n    if (pub.kind === Track.Kind.Video) pub.setSubscribed(!audioOnly);\n  };\n\n  const handlers: [RoomEvent, (...args: any[]) => void][] = [\n    [RoomEvent.ParticipantConnected, (p: RemoteParticipant) => { applyVolume(p); emitParticipants(); }],\n    [RoomEvent.ParticipantDisconnected, () => emitParticipants()],\n    [RoomEvent.ActiveSpeakersChanged, (speakers: Participant[]) => {\n      if (left) return;\n      const ids = speakers.map((s) => s.identity);\n      speakingCbs.forEach((cb) => cb(ids));\n    }],\n    [RoomEvent.TrackSubscribed, (track: RemoteTrack, _pub: unknown, p: RemoteParticipant) => {\n      if (track.kind === Track.Kind.Video) {\n        const source = toVideoSource(track.source);\n        if (!source) return;\n        remoteVideos.set(track, videoOf(`${p.identity}:${track.sid ?? source}`, p, false, source, track));\n        emitVideos();\n        return;\n      }\n      if (track.kind !== Track.Kind.Audio) return;\n      const el = track.attach();\n      document.body.appendChild(el);\n      audioEls.set(track, [el]);\n      applyVolume(p);\n    }],\n    [RoomEvent.TrackUnsubscribed, (track: RemoteTrack) => {\n      if (remoteVideos.delete(track)) {\n        track.detach();\n        emitVideos();\n        return;\n      }\n      track.detach().forEach((el) => el.remove());\n      audioEls.delete(track);\n    }],\n    [RoomEvent.TrackPublished, (pub: RemoteTrackPublication) => { if (audioOnly) applyAudioOnly(pub); }],\n    // Fired for our own camera/screen going on or off — including when the\n    // person ends a screen share with the BROWSER's stop button, which never\n    // passes through setScreenShare.\n    [RoomEvent.LocalTrackPublished, onLocalChange],\n    [RoomEvent.LocalTrackUnpublished, onLocalChange],\n  ];\n  for (const [event, fn] of handlers) room.on(event, fn);\n\n  try {\n    await room.connect(url, token);\n    if (publish) await room.localParticipant.setMicrophoneEnabled(true, { ...AUDIO_CAPTURE });\n    // joinVoice is called from a click; this is the gesture browsers require before audio may play.\n    await room.startAudio();\n  } catch (e) {\n    // A refused microphone must not leave the person connected and listening\n    // with no handle to leave — the caller only gets the rejection.\n    left = true;\n    for (const [event, fn] of handlers) room.off(event, fn);\n    await room.disconnect();\n    throw e;\n  }\n\n  return {\n    get muted() { return muted; },\n    async mute() { await room.localParticipant.setMicrophoneEnabled(false); muted = true; },\n    async unmute() { await room.localParticipant.setMicrophoneEnabled(true, { ...AUDIO_CAPTURE }); muted = false; },\n    setOutputMuted(m) {\n      outputMuted = m;\n      room.remoteParticipants.forEach(applyVolume);\n    },\n    async setInputDevice(deviceId) { await room.switchActiveDevice(\"audioinput\", deviceId); },\n    async setOutputDevice(deviceId) { await room.switchActiveDevice(\"audiooutput\", deviceId); },\n    setVolume(identity, volume) {\n      volumes.set(identity, Math.min(1, Math.max(0, volume)));\n      const p = room.remoteParticipants.get(identity);\n      if (p) applyVolume(p);\n    },\n    onSpeaking(cb) {\n      speakingCbs.add(cb);\n      return () => speakingCbs.delete(cb);\n    },\n    onParticipants(cb) {\n      participantCbs.add(cb);\n      if (!left) cb(participants());\n      return () => participantCbs.delete(cb);\n    },\n    async setCamera(on, opts) {\n      await room.localParticipant.setCameraEnabled(on, opts?.deviceId ? { deviceId: opts.deviceId } : undefined);\n      onLocalChange();\n    },\n    async setScreenShare(on, opts) {\n      await room.localParticipant.setScreenShareEnabled(on, on ? { audio: opts?.audio === true } : undefined);\n      onLocalChange();\n    },\n    get localMedia() { return localMedia(); },\n    onLocalMedia(cb) {\n      localMediaCbs.add(cb);\n      if (!left) cb(localMedia());\n      return () => localMediaCbs.delete(cb);\n    },\n    onVideos(cb) {\n      videoCbs.add(cb);\n      if (!left) cb(videos());\n      return () => videoCbs.delete(cb);\n    },\n    get audioOnly() { return audioOnly; },\n    setAudioOnly(on) {\n      audioOnly = on;\n      room.remoteParticipants.forEach((p) => p.trackPublications.forEach(applyAudioOnly));\n    },\n    async leave() {\n      left = true;\n      for (const [event, fn] of handlers) room.off(event, fn);\n      speakingCbs.clear();\n      participantCbs.clear();\n      localMediaCbs.clear();\n      videoCbs.clear();\n      remoteVideos.forEach((_v, track) => track.detach());\n      remoteVideos.clear();\n      audioEls.forEach((_els, track) => track.detach().forEach((el) => el.remove()));\n      audioEls.clear();\n      await room.disconnect();\n    },\n  };\n}\n\nfunction toVideoSource(source: Track.Source): CallVideo[\"source\"] | undefined {\n  if (source === Track.Source.Camera) return \"camera\";\n  if (source === Track.Source.ScreenShare) return \"screen_share\";\n  return undefined;\n}\n\nfunction localVideo(pub: LocalTrackPublication, p: Participant): CallVideo | undefined {\n  const source = toVideoSource(pub.source);\n  if (!pub.track || !source) return undefined;\n  return videoOf(`${p.identity}:${pub.trackSid}`, p, true, source, pub.track);\n}\n\nfunction videoOf(\n  id: string,\n  p: Participant,\n  isLocal: boolean,\n  source: CallVideo[\"source\"],\n  track: { attach(el: HTMLMediaElement): HTMLMediaElement; detach(el: HTMLMediaElement): HTMLMediaElement },\n): CallVideo {\n  return {\n    id,\n    identity: p.identity,\n    name: p.name || p.identity,\n    isLocal,\n    source,\n    attach(el) {\n      el.autoplay = true;\n      el.playsInline = true;\n      // Your own camera would otherwise echo the room back through the page.\n      if (isLocal) el.muted = true;\n      track.attach(el);\n    },\n    detach(el) { track.detach(el); },\n  };\n}\n\nfunction toVoiceParticipant(p: Participant, isLocal: boolean): VoiceParticipant {\n  return { identity: p.identity, name: p.name || p.identity, isLocal };\n}\n"]}

package/dist/client.d.cts

@@ -3,6 +3,23 @@ interface VoiceParticipant {
     name: string;
     isLocal: boolean;
 }
+/** F104.7 — one video picture in the call: a camera or a shared screen, yours or someone else's. */
+interface CallVideo {
+    /** Stable for as long as this picture exists — use it as a render key. */
+    id: string;
+    identity: string;
+    name: string;
+    isLocal: boolean;
+    source: "camera" | "screen_share";
+    /** Show it in a `<video>` element (autoplay + playsinline are set for you). */
+    attach(el: HTMLVideoElement): void;
+    detach(el: HTMLVideoElement): void;
+}
+/** F104.7 — what you are sending right now. */
+interface LocalMedia {
+    camera: boolean;
+    screenShare: boolean;
+}
 interface JoinOptions {
     /** The media server, e.g. `wss://voice.broberg.ai`. */
     url: string;
@@ -28,8 +45,36 @@ interface VoiceCall {
     onSpeaking(cb: (identities: string[]) => void): () => void;
     /** Everyone in the call, you included; called at once and on every join/leave. Returns an unsubscribe. */
     onParticipants(cb: (participants: VoiceParticipant[]) => void): () => void;
+    /** F104.7 — turn your camera on or off. Needs a ticket with `"camera"` in `sources`. */
+    setCamera(on: boolean, opts?: {
+        deviceId?: string;
+    }): Promise<void>;
+    /**
+     * F104.7 — share your screen (the browser asks which screen/window/tab) or stop.
+     * `audio: true` also offers the tab's sound (needs `"screen_share_audio"` in the ticket).
+     * Stopping with the browser's own «stop sharing» button is reported through `onLocalMedia`.
+     */
+    setScreenShare(on: boolean, opts?: {
+        audio?: boolean;
+    }): Promise<void>;
+    readonly localMedia: LocalMedia;
+    /** Called at once and whenever your camera/screen share turns on or off — also from the browser's own stop button. Returns an unsubscribe. */
+    onLocalMedia(cb: (media: LocalMedia) => void): () => void;
+    /** Every video picture in the call (yours included), at once and whenever one comes or goes. Returns an unsubscribe. */
+    onVideos(cb: (videos: CallVideo[]) => void): () => void;
+    /** F104.7 — `true` stops receiving other people's video (weak connection); sound is untouched. `false` brings it back. */
+    setAudioOnly(on: boolean): void;
+    readonly audioOnly: boolean;
     leave(): Promise<void>;
 }
+/** F104.7 — the room settings that keep 2–10 people with video usable. */
+declare const VIDEO_ROOM_OPTIONS: {
+    readonly adaptiveStream: true;
+    readonly dynacast: true;
+    readonly publishDefaults: {
+        readonly simulcast: true;
+    };
+};
 declare const AUDIO_CAPTURE: {
     readonly noiseSuppression: true;
     readonly echoCancellation: true;
@@ -37,4 +82,4 @@ declare const AUDIO_CAPTURE: {
 };
 declare function joinVoice({ url, token, publish }: JoinOptions): Promise<VoiceCall>;
 
-export { AUDIO_CAPTURE, type JoinOptions, type VoiceCall, type VoiceParticipant, joinVoice };
+export { AUDIO_CAPTURE, type CallVideo, type JoinOptions, type LocalMedia, VIDEO_ROOM_OPTIONS, type VoiceCall, type VoiceParticipant, joinVoice };

package/dist/client.d.ts

@@ -3,6 +3,23 @@ interface VoiceParticipant {
     name: string;
     isLocal: boolean;
 }
+/** F104.7 — one video picture in the call: a camera or a shared screen, yours or someone else's. */
+interface CallVideo {
+    /** Stable for as long as this picture exists — use it as a render key. */
+    id: string;
+    identity: string;
+    name: string;
+    isLocal: boolean;
+    source: "camera" | "screen_share";
+    /** Show it in a `<video>` element (autoplay + playsinline are set for you). */
+    attach(el: HTMLVideoElement): void;
+    detach(el: HTMLVideoElement): void;
+}
+/** F104.7 — what you are sending right now. */
+interface LocalMedia {
+    camera: boolean;
+    screenShare: boolean;
+}
 interface JoinOptions {
     /** The media server, e.g. `wss://voice.broberg.ai`. */
     url: string;
@@ -28,8 +45,36 @@ interface VoiceCall {
     onSpeaking(cb: (identities: string[]) => void): () => void;
     /** Everyone in the call, you included; called at once and on every join/leave. Returns an unsubscribe. */
     onParticipants(cb: (participants: VoiceParticipant[]) => void): () => void;
+    /** F104.7 — turn your camera on or off. Needs a ticket with `"camera"` in `sources`. */
+    setCamera(on: boolean, opts?: {
+        deviceId?: string;
+    }): Promise<void>;
+    /**
+     * F104.7 — share your screen (the browser asks which screen/window/tab) or stop.
+     * `audio: true` also offers the tab's sound (needs `"screen_share_audio"` in the ticket).
+     * Stopping with the browser's own «stop sharing» button is reported through `onLocalMedia`.
+     */
+    setScreenShare(on: boolean, opts?: {
+        audio?: boolean;
+    }): Promise<void>;
+    readonly localMedia: LocalMedia;
+    /** Called at once and whenever your camera/screen share turns on or off — also from the browser's own stop button. Returns an unsubscribe. */
+    onLocalMedia(cb: (media: LocalMedia) => void): () => void;
+    /** Every video picture in the call (yours included), at once and whenever one comes or goes. Returns an unsubscribe. */
+    onVideos(cb: (videos: CallVideo[]) => void): () => void;
+    /** F104.7 — `true` stops receiving other people's video (weak connection); sound is untouched. `false` brings it back. */
+    setAudioOnly(on: boolean): void;
+    readonly audioOnly: boolean;
     leave(): Promise<void>;
 }
+/** F104.7 — the room settings that keep 2–10 people with video usable. */
+declare const VIDEO_ROOM_OPTIONS: {
+    readonly adaptiveStream: true;
+    readonly dynacast: true;
+    readonly publishDefaults: {
+        readonly simulcast: true;
+    };
+};
 declare const AUDIO_CAPTURE: {
     readonly noiseSuppression: true;
     readonly echoCancellation: true;
@@ -37,4 +82,4 @@ declare const AUDIO_CAPTURE: {
 };
 declare function joinVoice({ url, token, publish }: JoinOptions): Promise<VoiceCall>;
 
-export { AUDIO_CAPTURE, type JoinOptions, type VoiceCall, type VoiceParticipant, joinVoice };
+export { AUDIO_CAPTURE, type CallVideo, type JoinOptions, type LocalMedia, VIDEO_ROOM_OPTIONS, type VoiceCall, type VoiceParticipant, joinVoice };

package/dist/client.js

@@ -1,9 +1,14 @@
 import { Room, RoomEvent, Track } from 'livekit-client';
 
 // src/client.ts
+var VIDEO_ROOM_OPTIONS = { adaptiveStream: true, dynacast: true, publishDefaults: { simulcast: true } };
 var AUDIO_CAPTURE = { noiseSuppression: true, echoCancellation: true, autoGainControl: true };
 async function joinVoice({ url, token, publish = true }) {
-  const room = new Room({ audioCaptureDefaults: { ...AUDIO_CAPTURE } });
+  const room = new Room({ audioCaptureDefaults: { ...AUDIO_CAPTURE }, ...VIDEO_ROOM_OPTIONS, publishDefaults: { ...VIDEO_ROOM_OPTIONS.publishDefaults } });
+  const localMediaCbs = /* @__PURE__ */ new Set();
+  const videoCbs = /* @__PURE__ */ new Set();
+  const remoteVideos = /* @__PURE__ */ new Map();
+  let audioOnly = false;
   const speakingCbs = /* @__PURE__ */ new Set();
   const participantCbs = /* @__PURE__ */ new Set();
   const volumes = /* @__PURE__ */ new Map();
@@ -21,6 +26,35 @@ async function joinVoice({ url, token, publish = true }) {
     participantCbs.forEach((cb) => cb(list));
   };
   const applyVolume = (p) => p.setVolume(outputMuted ? 0 : volumes.get(p.identity) ?? 1);
+  const localMedia = () => ({
+    camera: room.localParticipant.isCameraEnabled,
+    screenShare: room.localParticipant.isScreenShareEnabled
+  });
+  const emitLocalMedia = () => {
+    if (left) return;
+    const m = localMedia();
+    localMediaCbs.forEach((cb) => cb(m));
+  };
+  const videos = () => {
+    const local = [];
+    for (const pub of room.localParticipant.videoTrackPublications.values()) {
+      const v = localVideo(pub, room.localParticipant);
+      if (v) local.push(v);
+    }
+    return [...local, ...remoteVideos.values()];
+  };
+  const emitVideos = () => {
+    if (left) return;
+    const list = videos();
+    videoCbs.forEach((cb) => cb(list));
+  };
+  const onLocalChange = () => {
+    emitLocalMedia();
+    emitVideos();
+  };
+  const applyAudioOnly = (pub) => {
+    if (pub.kind === Track.Kind.Video) pub.setSubscribed(!audioOnly);
+  };
   const handlers = [
     [RoomEvent.ParticipantConnected, (p) => {
       applyVolume(p);
@@ -33,6 +67,13 @@ async function joinVoice({ url, token, publish = true }) {
       speakingCbs.forEach((cb) => cb(ids));
     }],
     [RoomEvent.TrackSubscribed, (track, _pub, p) => {
+      if (track.kind === Track.Kind.Video) {
+        const source = toVideoSource(track.source);
+        if (!source) return;
+        remoteVideos.set(track, videoOf(`${p.identity}:${track.sid ?? source}`, p, false, source, track));
+        emitVideos();
+        return;
+      }
       if (track.kind !== Track.Kind.Audio) return;
       const el = track.attach();
       document.body.appendChild(el);
@@ -40,9 +81,22 @@ async function joinVoice({ url, token, publish = true }) {
       applyVolume(p);
     }],
     [RoomEvent.TrackUnsubscribed, (track) => {
+      if (remoteVideos.delete(track)) {
+        track.detach();
+        emitVideos();
+        return;
+      }
       track.detach().forEach((el) => el.remove());
       audioEls.delete(track);
-    }]
+    }],
+    [RoomEvent.TrackPublished, (pub) => {
+      if (audioOnly) applyAudioOnly(pub);
+    }],
+    // Fired for our own camera/screen going on or off — including when the
+    // person ends a screen share with the BROWSER's stop button, which never
+    // passes through setScreenShare.
+    [RoomEvent.LocalTrackPublished, onLocalChange],
+    [RoomEvent.LocalTrackUnpublished, onLocalChange]
   ];
   for (const [event, fn] of handlers) room.on(event, fn);
   try {
@@ -91,21 +145,81 @@ async function joinVoice({ url, token, publish = true }) {
       if (!left) cb(participants());
       return () => participantCbs.delete(cb);
     },
+    async setCamera(on, opts) {
+      await room.localParticipant.setCameraEnabled(on, opts?.deviceId ? { deviceId: opts.deviceId } : void 0);
+      onLocalChange();
+    },
+    async setScreenShare(on, opts) {
+      await room.localParticipant.setScreenShareEnabled(on, on ? { audio: opts?.audio === true } : void 0);
+      onLocalChange();
+    },
+    get localMedia() {
+      return localMedia();
+    },
+    onLocalMedia(cb) {
+      localMediaCbs.add(cb);
+      if (!left) cb(localMedia());
+      return () => localMediaCbs.delete(cb);
+    },
+    onVideos(cb) {
+      videoCbs.add(cb);
+      if (!left) cb(videos());
+      return () => videoCbs.delete(cb);
+    },
+    get audioOnly() {
+      return audioOnly;
+    },
+    setAudioOnly(on) {
+      audioOnly = on;
+      room.remoteParticipants.forEach((p) => p.trackPublications.forEach(applyAudioOnly));
+    },
     async leave() {
       left = true;
       for (const [event, fn] of handlers) room.off(event, fn);
       speakingCbs.clear();
       participantCbs.clear();
+      localMediaCbs.clear();
+      videoCbs.clear();
+      remoteVideos.forEach((_v, track) => track.detach());
+      remoteVideos.clear();
       audioEls.forEach((_els, track) => track.detach().forEach((el) => el.remove()));
       audioEls.clear();
       await room.disconnect();
     }
   };
 }
+function toVideoSource(source) {
+  if (source === Track.Source.Camera) return "camera";
+  if (source === Track.Source.ScreenShare) return "screen_share";
+  return void 0;
+}
+function localVideo(pub, p) {
+  const source = toVideoSource(pub.source);
+  if (!pub.track || !source) return void 0;
+  return videoOf(`${p.identity}:${pub.trackSid}`, p, true, source, pub.track);
+}
+function videoOf(id, p, isLocal, source, track) {
+  return {
+    id,
+    identity: p.identity,
+    name: p.name || p.identity,
+    isLocal,
+    source,
+    attach(el) {
+      el.autoplay = true;
+      el.playsInline = true;
+      if (isLocal) el.muted = true;
+      track.attach(el);
+    },
+    detach(el) {
+      track.detach(el);
+    }
+  };
+}
 function toVoiceParticipant(p, isLocal) {
   return { identity: p.identity, name: p.name || p.identity, isLocal };
 }
 
-export { AUDIO_CAPTURE, joinVoice };
+export { AUDIO_CAPTURE, VIDEO_ROOM_OPTIONS, joinVoice };
 //# sourceMappingURL=client.js.map
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":"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","file":"client.js","sourcesContent":["// @broberg/call/client — the browser's half of a voice call (F104.3).\n//\n// A thin layer over livekit-client that does the four things every app would\n// otherwise get slightly wrong on its own: open the microphone with noise\n// suppression, echo cancellation and auto gain; actually PLAY the other people\n// (a subscribed audio track is silent until it is attached to an element);\n// keep \"mute everyone\" and per-person volume apart so unmuting restores what\n// each person was set to; and stop calling the app back after leave().\n// No node: imports.\n\nimport { Room, RoomEvent, Track } from \"livekit-client\";\nimport type { Participant, RemoteParticipant, RemoteTrack } from \"livekit-client\";\n\nexport interface VoiceParticipant {\n  identity: string;\n  name: string;\n  isLocal: boolean;\n}\n\nexport interface JoinOptions {\n  /** The media server, e.g. `wss://voice.broberg.ai`. */\n  url: string;\n  /** A ticket from `createRoomToken` on the app's server. */\n  token: string;\n  /**\n   * F104.4 — `false` joins as a listener: the microphone is never opened\n   * (a listen-only ticket would be refused if it tried). Default `true`.\n   */\n  publish?: boolean;\n}\n\nexport interface VoiceCall {\n  mute(): Promise<void>;\n  unmute(): Promise<void>;\n  readonly muted: boolean;\n  /** Silence everyone else (true) or bring back each person's own volume (false). */\n  setOutputMuted(muted: boolean): void;\n  setInputDevice(deviceId: string): Promise<void>;\n  setOutputDevice(deviceId: string): Promise<void>;\n  /** 0–1 for one person. Kept while output is muted and applied on unmute. */\n  setVolume(identity: string, volume: number): void;\n  /** Identities of the people speaking right now, loudest first. Returns an unsubscribe. */\n  onSpeaking(cb: (identities: string[]) => void): () => void;\n  /** Everyone in the call, you included; called at once and on every join/leave. Returns an unsubscribe. */\n  onParticipants(cb: (participants: VoiceParticipant[]) => void): () => void;\n  leave(): Promise<void>;\n}\n\nexport const AUDIO_CAPTURE = { noiseSuppression: true, echoCancellation: true, autoGainControl: true } as const;\n\nexport async function joinVoice({ url, token, publish = true }: JoinOptions): Promise<VoiceCall> {\n  const room = new Room({ audioCaptureDefaults: { ...AUDIO_CAPTURE } });\n  const speakingCbs = new Set<(ids: string[]) => void>();\n  const participantCbs = new Set<(ps: VoiceParticipant[]) => void>();\n  const volumes = new Map<string, number>();\n  const audioEls = new Map<RemoteTrack, HTMLMediaElement[]>();\n  let outputMuted = false;\n  let muted = !publish;\n  let left = false;\n\n  const participants = (): VoiceParticipant[] => [\n    toVoiceParticipant(room.localParticipant, true),\n    ...[...room.remoteParticipants.values()].map((p) => toVoiceParticipant(p, false)),\n  ];\n  const emitParticipants = () => {\n    if (left) return;\n    const list = participants();\n    participantCbs.forEach((cb) => cb(list));\n  };\n  const applyVolume = (p: RemoteParticipant) => p.setVolume(outputMuted ? 0 : (volumes.get(p.identity) ?? 1));\n\n  const handlers: [RoomEvent, (...args: any[]) => void][] = [\n    [RoomEvent.ParticipantConnected, (p: RemoteParticipant) => { applyVolume(p); emitParticipants(); }],\n    [RoomEvent.ParticipantDisconnected, () => emitParticipants()],\n    [RoomEvent.ActiveSpeakersChanged, (speakers: Participant[]) => {\n      if (left) return;\n      const ids = speakers.map((s) => s.identity);\n      speakingCbs.forEach((cb) => cb(ids));\n    }],\n    [RoomEvent.TrackSubscribed, (track: RemoteTrack, _pub: unknown, p: RemoteParticipant) => {\n      if (track.kind !== Track.Kind.Audio) return;\n      const el = track.attach();\n      document.body.appendChild(el);\n      audioEls.set(track, [el]);\n      applyVolume(p);\n    }],\n    [RoomEvent.TrackUnsubscribed, (track: RemoteTrack) => {\n      track.detach().forEach((el) => el.remove());\n      audioEls.delete(track);\n    }],\n  ];\n  for (const [event, fn] of handlers) room.on(event, fn);\n\n  try {\n    await room.connect(url, token);\n    if (publish) await room.localParticipant.setMicrophoneEnabled(true, { ...AUDIO_CAPTURE });\n    // joinVoice is called from a click; this is the gesture browsers require before audio may play.\n    await room.startAudio();\n  } catch (e) {\n    // A refused microphone must not leave the person connected and listening\n    // with no handle to leave — the caller only gets the rejection.\n    left = true;\n    for (const [event, fn] of handlers) room.off(event, fn);\n    await room.disconnect();\n    throw e;\n  }\n\n  return {\n    get muted() { return muted; },\n    async mute() { await room.localParticipant.setMicrophoneEnabled(false); muted = true; },\n    async unmute() { await room.localParticipant.setMicrophoneEnabled(true, { ...AUDIO_CAPTURE }); muted = false; },\n    setOutputMuted(m) {\n      outputMuted = m;\n      room.remoteParticipants.forEach(applyVolume);\n    },\n    async setInputDevice(deviceId) { await room.switchActiveDevice(\"audioinput\", deviceId); },\n    async setOutputDevice(deviceId) { await room.switchActiveDevice(\"audiooutput\", deviceId); },\n    setVolume(identity, volume) {\n      volumes.set(identity, Math.min(1, Math.max(0, volume)));\n      const p = room.remoteParticipants.get(identity);\n      if (p) applyVolume(p);\n    },\n    onSpeaking(cb) {\n      speakingCbs.add(cb);\n      return () => speakingCbs.delete(cb);\n    },\n    onParticipants(cb) {\n      participantCbs.add(cb);\n      if (!left) cb(participants());\n      return () => participantCbs.delete(cb);\n    },\n    async leave() {\n      left = true;\n      for (const [event, fn] of handlers) room.off(event, fn);\n      speakingCbs.clear();\n      participantCbs.clear();\n      audioEls.forEach((_els, track) => track.detach().forEach((el) => el.remove()));\n      audioEls.clear();\n      await room.disconnect();\n    },\n  };\n}\n\nfunction toVoiceParticipant(p: Participant, isLocal: boolean): VoiceParticipant {\n  return { identity: p.identity, name: p.name || p.identity, isLocal };\n}\n"]}
+{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":";;;AAuFO,IAAM,kBAAA,GAAqB,EAAE,cAAA,EAAgB,IAAA,EAAM,QAAA,EAAU,MAAM,eAAA,EAAiB,EAAE,SAAA,EAAW,IAAA,EAAK;AAEtG,IAAM,gBAAgB,EAAE,gBAAA,EAAkB,MAAM,gBAAA,EAAkB,IAAA,EAAM,iBAAiB,IAAA;AAEhG,eAAsB,UAAU,EAAE,GAAA,EAAK,KAAA,EAAO,OAAA,GAAU,MAAK,EAAoC;AAC/F,EAAA,MAAM,OAAO,IAAI,IAAA,CAAK,EAAE,oBAAA,EAAsB,EAAE,GAAG,aAAA,EAAc,EAAG,GAAG,oBAAoB,eAAA,EAAiB,EAAE,GAAG,kBAAA,CAAmB,eAAA,IAAmB,CAAA;AACvJ,EAAA,MAAM,aAAA,uBAAoB,GAAA,EAA6B;AACvD,EAAA,MAAM,QAAA,uBAAe,GAAA,EAA8B;AACnD,EAAA,MAAM,YAAA,uBAAmB,GAAA,EAA4B;AACrD,EAAA,IAAI,SAAA,GAAY,KAAA;AAChB,EAAA,MAAM,WAAA,uBAAkB,GAAA,EAA6B;AACrD,EAAA,MAAM,cAAA,uBAAqB,GAAA,EAAsC;AACjE,EAAA,MAAM,OAAA,uBAAc,GAAA,EAAoB;AACxC,EAAA,MAAM,QAAA,uBAAe,GAAA,EAAqC;AAC1D,EAAA,IAAI,WAAA,GAAc,KAAA;AAClB,EAAA,IAAI,QAAQ,CAAC,OAAA;AACb,EAAA,IAAI,IAAA,GAAO,KAAA;AAEX,EAAA,MAAM,eAAe,MAA0B;AAAA,IAC7C,kBAAA,CAAmB,IAAA,CAAK,gBAAA,EAAkB,IAAI,CAAA;AAAA,IAC9C,GAAG,CAAC,GAAG,IAAA,CAAK,mBAAmB,MAAA,EAAQ,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA,KAAM,kBAAA,CAAmB,CAAA,EAAG,KAAK,CAAC;AAAA,GAClF;AACA,EAAA,MAAM,mBAAmB,MAAM;AAC7B,IAAA,IAAI,IAAA,EAAM;AACV,IAAA,MAAM,OAAO,YAAA,EAAa;AAC1B,IAAA,cAAA,CAAe,OAAA,CAAQ,CAAC,EAAA,KAAO,EAAA,CAAG,IAAI,CAAC,CAAA;AAAA,EACzC,CAAA;AACA,EAAA,MAAM,WAAA,GAAc,CAAC,CAAA,KAAyB,CAAA,CAAE,SAAA,CAAU,WAAA,GAAc,CAAA,GAAK,OAAA,CAAQ,GAAA,CAAI,CAAA,CAAE,QAAQ,CAAA,IAAK,CAAE,CAAA;AAE1G,EAAA,MAAM,aAAa,OAAmB;AAAA,IACpC,MAAA,EAAQ,KAAK,gBAAA,CAAiB,eAAA;AAAA,IAC9B,WAAA,EAAa,KAAK,gBAAA,CAAiB;AAAA,GACrC,CAAA;AACA,EAAA,MAAM,iBAAiB,MAAM;AAC3B,IAAA,IAAI,IAAA,EAAM;AACV,IAAA,MAAM,IAAI,UAAA,EAAW;AACrB,IAAA,aAAA,CAAc,OAAA,CAAQ,CAAC,EAAA,KAAO,EAAA,CAAG,CAAC,CAAC,CAAA;AAAA,EACrC,CAAA;AACA,EAAA,MAAM,SAAS,MAAmB;AAChC,IAAA,MAAM,QAAqB,EAAC;AAC5B,IAAA,KAAA,MAAW,GAAA,IAAO,IAAA,CAAK,gBAAA,CAAiB,sBAAA,CAAuB,QAAO,EAAG;AACvE,MAAA,MAAM,CAAA,GAAI,UAAA,CAAW,GAAA,EAAK,IAAA,CAAK,gBAAgB,CAAA;AAC/C,MAAA,IAAI,CAAA,EAAG,KAAA,CAAM,IAAA,CAAK,CAAC,CAAA;AAAA,IACrB;AACA,IAAA,OAAO,CAAC,GAAG,KAAA,EAAO,GAAG,YAAA,CAAa,QAAQ,CAAA;AAAA,EAC5C,CAAA;AACA,EAAA,MAAM,aAAa,MAAM;AACvB,IAAA,IAAI,IAAA,EAAM;AACV,IAAA,MAAM,OAAO,MAAA,EAAO;AACpB,IAAA,QAAA,CAAS,OAAA,CAAQ,CAAC,EAAA,KAAO,EAAA,CAAG,IAAI,CAAC,CAAA;AAAA,EACnC,CAAA;AACA,EAAA,MAAM,gBAAgB,MAAM;AAAE,IAAA,cAAA,EAAe;AAAG,IAAA,UAAA,EAAW;AAAA,EAAG,CAAA;AAE9D,EAAA,MAAM,cAAA,GAAiB,CAAC,GAAA,KAAgC;AACtD,IAAA,IAAI,GAAA,CAAI,SAAS,KAAA,CAAM,IAAA,CAAK,OAAO,GAAA,CAAI,aAAA,CAAc,CAAC,SAAS,CAAA;AAAA,EACjE,CAAA;AAEA,EAAA,MAAM,QAAA,GAAoD;AAAA,IACxD,CAAC,SAAA,CAAU,oBAAA,EAAsB,CAAC,CAAA,KAAyB;AAAE,MAAA,WAAA,CAAY,CAAC,CAAA;AAAG,MAAA,gBAAA,EAAiB;AAAA,IAAG,CAAC,CAAA;AAAA,IAClG,CAAC,SAAA,CAAU,uBAAA,EAAyB,MAAM,kBAAkB,CAAA;AAAA,IAC5D,CAAC,SAAA,CAAU,qBAAA,EAAuB,CAAC,QAAA,KAA4B;AAC7D,MAAA,IAAI,IAAA,EAAM;AACV,MAAA,MAAM,MAAM,QAAA,CAAS,GAAA,CAAI,CAAC,CAAA,KAAM,EAAE,QAAQ,CAAA;AAC1C,MAAA,WAAA,CAAY,OAAA,CAAQ,CAAC,EAAA,KAAO,EAAA,CAAG,GAAG,CAAC,CAAA;AAAA,IACrC,CAAC,CAAA;AAAA,IACD,CAAC,SAAA,CAAU,eAAA,EAAiB,CAAC,KAAA,EAAoB,MAAe,CAAA,KAAyB;AACvF,MAAA,IAAI,KAAA,CAAM,IAAA,KAAS,KAAA,CAAM,IAAA,CAAK,KAAA,EAAO;AACnC,QAAA,MAAM,MAAA,GAAS,aAAA,CAAc,KAAA,CAAM,MAAM,CAAA;AACzC,QAAA,IAAI,CAAC,MAAA,EAAQ;AACb,QAAA,YAAA,CAAa,GAAA,CAAI,KAAA,EAAO,OAAA,CAAQ,CAAA,EAAG,EAAE,QAAQ,CAAA,CAAA,EAAI,KAAA,CAAM,GAAA,IAAO,MAAM,CAAA,CAAA,EAAI,CAAA,EAAG,KAAA,EAAO,MAAA,EAAQ,KAAK,CAAC,CAAA;AAChG,QAAA,UAAA,EAAW;AACX,QAAA;AAAA,MACF;AACA,MAAA,IAAI,KAAA,CAAM,IAAA,KAAS,KAAA,CAAM,IAAA,CAAK,KAAA,EAAO;AACrC,MAAA,MAAM,EAAA,GAAK,MAAM,MAAA,EAAO;AACxB,MAAA,QAAA,CAAS,IAAA,CAAK,YAAY,EAAE,CAAA;AAC5B,MAAA,QAAA,CAAS,GAAA,CAAI,KAAA,EAAO,CAAC,EAAE,CAAC,CAAA;AACxB,MAAA,WAAA,CAAY,CAAC,CAAA;AAAA,IACf,CAAC,CAAA;AAAA,IACD,CAAC,SAAA,CAAU,iBAAA,EAAmB,CAAC,KAAA,KAAuB;AACpD,MAAA,IAAI,YAAA,CAAa,MAAA,CAAO,KAAK,CAAA,EAAG;AAC9B,QAAA,KAAA,CAAM,MAAA,EAAO;AACb,QAAA,UAAA,EAAW;AACX,QAAA;AAAA,MACF;AACA,MAAA,KAAA,CAAM,QAAO,CAAE,OAAA,CAAQ,CAAC,EAAA,KAAO,EAAA,CAAG,QAAQ,CAAA;AAC1C,MAAA,QAAA,CAAS,OAAO,KAAK,CAAA;AAAA,IACvB,CAAC,CAAA;AAAA,IACD,CAAC,SAAA,CAAU,cAAA,EAAgB,CAAC,GAAA,KAAgC;AAAE,MAAA,IAAI,SAAA,iBAA0B,GAAG,CAAA;AAAA,IAAG,CAAC,CAAA;AAAA;AAAA;AAAA;AAAA,IAInG,CAAC,SAAA,CAAU,mBAAA,EAAqB,aAAa,CAAA;AAAA,IAC7C,CAAC,SAAA,CAAU,qBAAA,EAAuB,aAAa;AAAA,GACjD;AACA,EAAA,KAAA,MAAW,CAAC,OAAO,EAAE,CAAA,IAAK,UAAU,IAAA,CAAK,EAAA,CAAG,OAAO,EAAE,CAAA;AAErD,EAAA,IAAI;AACF,IAAA,MAAM,IAAA,CAAK,OAAA,CAAQ,GAAA,EAAK,KAAK,CAAA;AAC7B,IAAA,IAAI,OAAA,QAAe,IAAA,CAAK,gBAAA,CAAiB,qBAAqB,IAAA,EAAM,EAAE,GAAG,aAAA,EAAe,CAAA;AAExF,IAAA,MAAM,KAAK,UAAA,EAAW;AAAA,EACxB,SAAS,CAAA,EAAG;AAGV,IAAA,IAAA,GAAO,IAAA;AACP,IAAA,KAAA,MAAW,CAAC,OAAO,EAAE,CAAA,IAAK,UAAU,IAAA,CAAK,GAAA,CAAI,OAAO,EAAE,CAAA;AACtD,IAAA,MAAM,KAAK,UAAA,EAAW;AACtB,IAAA,MAAM,CAAA;AAAA,EACR;AAEA,EAAA,OAAO;AAAA,IACL,IAAI,KAAA,GAAQ;AAAE,MAAA,OAAO,KAAA;AAAA,IAAO,CAAA;AAAA,IAC5B,MAAM,IAAA,GAAO;AAAE,MAAA,MAAM,IAAA,CAAK,gBAAA,CAAiB,oBAAA,CAAqB,KAAK,CAAA;AAAG,MAAA,KAAA,GAAQ,IAAA;AAAA,IAAM,CAAA;AAAA,IACtF,MAAM,MAAA,GAAS;AAAE,MAAA,MAAM,KAAK,gBAAA,CAAiB,oBAAA,CAAqB,MAAM,EAAE,GAAG,eAAe,CAAA;AAAG,MAAA,KAAA,GAAQ,KAAA;AAAA,IAAO,CAAA;AAAA,IAC9G,eAAe,CAAA,EAAG;AAChB,MAAA,WAAA,GAAc,CAAA;AACd,MAAA,IAAA,CAAK,kBAAA,CAAmB,QAAQ,WAAW,CAAA;AAAA,IAC7C,CAAA;AAAA,IACA,MAAM,eAAe,QAAA,EAAU;AAAE,MAAA,MAAM,IAAA,CAAK,kBAAA,CAAmB,YAAA,EAAc,QAAQ,CAAA;AAAA,IAAG,CAAA;AAAA,IACxF,MAAM,gBAAgB,QAAA,EAAU;AAAE,MAAA,MAAM,IAAA,CAAK,kBAAA,CAAmB,aAAA,EAAe,QAAQ,CAAA;AAAA,IAAG,CAAA;AAAA,IAC1F,SAAA,CAAU,UAAU,MAAA,EAAQ;AAC1B,MAAA,OAAA,CAAQ,GAAA,CAAI,QAAA,EAAU,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,KAAK,GAAA,CAAI,CAAA,EAAG,MAAM,CAAC,CAAC,CAAA;AACtD,MAAA,MAAM,CAAA,GAAI,IAAA,CAAK,kBAAA,CAAmB,GAAA,CAAI,QAAQ,CAAA;AAC9C,MAAA,IAAI,CAAA,cAAe,CAAC,CAAA;AAAA,IACtB,CAAA;AAAA,IACA,WAAW,EAAA,EAAI;AACb,MAAA,WAAA,CAAY,IAAI,EAAE,CAAA;AAClB,MAAA,OAAO,MAAM,WAAA,CAAY,MAAA,CAAO,EAAE,CAAA;AAAA,IACpC,CAAA;AAAA,IACA,eAAe,EAAA,EAAI;AACjB,MAAA,cAAA,CAAe,IAAI,EAAE,CAAA;AACrB,MAAA,IAAI,CAAC,IAAA,EAAM,EAAA,CAAG,YAAA,EAAc,CAAA;AAC5B,MAAA,OAAO,MAAM,cAAA,CAAe,MAAA,CAAO,EAAE,CAAA;AAAA,IACvC,CAAA;AAAA,IACA,MAAM,SAAA,CAAU,EAAA,EAAI,IAAA,EAAM;AACxB,MAAA,MAAM,IAAA,CAAK,gBAAA,CAAiB,gBAAA,CAAiB,EAAA,EAAI,IAAA,EAAM,QAAA,GAAW,EAAE,QAAA,EAAU,IAAA,CAAK,QAAA,EAAS,GAAI,MAAS,CAAA;AACzG,MAAA,aAAA,EAAc;AAAA,IAChB,CAAA;AAAA,IACA,MAAM,cAAA,CAAe,EAAA,EAAI,IAAA,EAAM;AAC7B,MAAA,MAAM,IAAA,CAAK,gBAAA,CAAiB,qBAAA,CAAsB,EAAA,EAAI,EAAA,GAAK,EAAE,KAAA,EAAO,IAAA,EAAM,KAAA,KAAU,IAAA,EAAK,GAAI,MAAS,CAAA;AACtG,MAAA,aAAA,EAAc;AAAA,IAChB,CAAA;AAAA,IACA,IAAI,UAAA,GAAa;AAAE,MAAA,OAAO,UAAA,EAAW;AAAA,IAAG,CAAA;AAAA,IACxC,aAAa,EAAA,EAAI;AACf,MAAA,aAAA,CAAc,IAAI,EAAE,CAAA;AACpB,MAAA,IAAI,CAAC,IAAA,EAAM,EAAA,CAAG,UAAA,EAAY,CAAA;AAC1B,MAAA,OAAO,MAAM,aAAA,CAAc,MAAA,CAAO,EAAE,CAAA;AAAA,IACtC,CAAA;AAAA,IACA,SAAS,EAAA,EAAI;AACX,MAAA,QAAA,CAAS,IAAI,EAAE,CAAA;AACf,MAAA,IAAI,CAAC,IAAA,EAAM,EAAA,CAAG,MAAA,EAAQ,CAAA;AACtB,MAAA,OAAO,MAAM,QAAA,CAAS,MAAA,CAAO,EAAE,CAAA;AAAA,IACjC,CAAA;AAAA,IACA,IAAI,SAAA,GAAY;AAAE,MAAA,OAAO,SAAA;AAAA,IAAW,CAAA;AAAA,IACpC,aAAa,EAAA,EAAI;AACf,MAAA,SAAA,GAAY,EAAA;AACZ,MAAA,IAAA,CAAK,kBAAA,CAAmB,QAAQ,CAAC,CAAA,KAAM,EAAE,iBAAA,CAAkB,OAAA,CAAQ,cAAc,CAAC,CAAA;AAAA,IACpF,CAAA;AAAA,IACA,MAAM,KAAA,GAAQ;AACZ,MAAA,IAAA,GAAO,IAAA;AACP,MAAA,KAAA,MAAW,CAAC,OAAO,EAAE,CAAA,IAAK,UAAU,IAAA,CAAK,GAAA,CAAI,OAAO,EAAE,CAAA;AACtD,MAAA,WAAA,CAAY,KAAA,EAAM;AAClB,MAAA,cAAA,CAAe,KAAA,EAAM;AACrB,MAAA,aAAA,CAAc,KAAA,EAAM;AACpB,MAAA,QAAA,CAAS,KAAA,EAAM;AACf,MAAA,YAAA,CAAa,QAAQ,CAAC,EAAA,EAAI,KAAA,KAAU,KAAA,CAAM,QAAQ,CAAA;AAClD,MAAA,YAAA,CAAa,KAAA,EAAM;AACnB,MAAA,QAAA,CAAS,OAAA,CAAQ,CAAC,IAAA,EAAM,KAAA,KAAU,KAAA,CAAM,MAAA,EAAO,CAAE,OAAA,CAAQ,CAAC,EAAA,KAAO,EAAA,CAAG,MAAA,EAAQ,CAAC,CAAA;AAC7E,MAAA,QAAA,CAAS,KAAA,EAAM;AACf,MAAA,MAAM,KAAK,UAAA,EAAW;AAAA,IACxB;AAAA,GACF;AACF;AAEA,SAAS,cAAc,MAAA,EAAuD;AAC5E,EAAA,IAAI,MAAA,KAAW,KAAA,CAAM,MAAA,CAAO,MAAA,EAAQ,OAAO,QAAA;AAC3C,EAAA,IAAI,MAAA,KAAW,KAAA,CAAM,MAAA,CAAO,WAAA,EAAa,OAAO,cAAA;AAChD,EAAA,OAAO,MAAA;AACT;AAEA,SAAS,UAAA,CAAW,KAA4B,CAAA,EAAuC;AACrF,EAAA,MAAM,MAAA,GAAS,aAAA,CAAc,GAAA,CAAI,MAAM,CAAA;AACvC,EAAA,IAAI,CAAC,GAAA,CAAI,KAAA,IAAS,CAAC,QAAQ,OAAO,MAAA;AAClC,EAAA,OAAO,OAAA,CAAQ,CAAA,EAAG,CAAA,CAAE,QAAQ,CAAA,CAAA,EAAI,GAAA,CAAI,QAAQ,CAAA,CAAA,EAAI,CAAA,EAAG,IAAA,EAAM,MAAA,EAAQ,GAAA,CAAI,KAAK,CAAA;AAC5E;AAEA,SAAS,OAAA,CACP,EAAA,EACA,CAAA,EACA,OAAA,EACA,QACA,KAAA,EACW;AACX,EAAA,OAAO;AAAA,IACL,EAAA;AAAA,IACA,UAAU,CAAA,CAAE,QAAA;AAAA,IACZ,IAAA,EAAM,CAAA,CAAE,IAAA,IAAQ,CAAA,CAAE,QAAA;AAAA,IAClB,OAAA;AAAA,IACA,MAAA;AAAA,IACA,OAAO,EAAA,EAAI;AACT,MAAA,EAAA,CAAG,QAAA,GAAW,IAAA;AACd,MAAA,EAAA,CAAG,WAAA,GAAc,IAAA;AAEjB,MAAA,IAAI,OAAA,KAAY,KAAA,GAAQ,IAAA;AACxB,MAAA,KAAA,CAAM,OAAO,EAAE,CAAA;AAAA,IACjB,CAAA;AAAA,IACA,OAAO,EAAA,EAAI;AAAE,MAAA,KAAA,CAAM,OAAO,EAAE,CAAA;AAAA,IAAG;AAAA,GACjC;AACF;AAEA,SAAS,kBAAA,CAAmB,GAAgB,OAAA,EAAoC;AAC9E,EAAA,OAAO,EAAE,UAAU,CAAA,CAAE,QAAA,EAAU,MAAM,CAAA,CAAE,IAAA,IAAQ,CAAA,CAAE,QAAA,EAAU,OAAA,EAAQ;AACrE","file":"client.js","sourcesContent":["// @broberg/call/client — the browser's half of a call (F104.3; camera + screen share F104.7).\n//\n// A thin layer over livekit-client that does the four things every app would\n// otherwise get slightly wrong on its own: open the microphone with noise\n// suppression, echo cancellation and auto gain; actually PLAY the other people\n// (a subscribed audio track is silent until it is attached to an element);\n// keep \"mute everyone\" and per-person volume apart so unmuting restores what\n// each person was set to; and stop calling the app back after leave().\n// F104.7 adds camera and screen share: simulcast + adaptive stream + dynacast\n// so 2–10 people with video stay usable, the browser's own «stop sharing»\n// button is reported back to the app, and audio-only drops incoming video.\n// No node: imports.\n\nimport { Room, RoomEvent, Track } from \"livekit-client\";\nimport type { LocalTrackPublication, Participant, RemoteParticipant, RemoteTrack, RemoteTrackPublication } from \"livekit-client\";\n\nexport interface VoiceParticipant {\n  identity: string;\n  name: string;\n  isLocal: boolean;\n}\n\n/** F104.7 — one video picture in the call: a camera or a shared screen, yours or someone else's. */\nexport interface CallVideo {\n  /** Stable for as long as this picture exists — use it as a render key. */\n  id: string;\n  identity: string;\n  name: string;\n  isLocal: boolean;\n  source: \"camera\" | \"screen_share\";\n  /** Show it in a `<video>` element (autoplay + playsinline are set for you). */\n  attach(el: HTMLVideoElement): void;\n  detach(el: HTMLVideoElement): void;\n}\n\n/** F104.7 — what you are sending right now. */\nexport interface LocalMedia {\n  camera: boolean;\n  screenShare: boolean;\n}\n\nexport interface JoinOptions {\n  /** The media server, e.g. `wss://voice.broberg.ai`. */\n  url: string;\n  /** A ticket from `createRoomToken` on the app's server. */\n  token: string;\n  /**\n   * F104.4 — `false` joins as a listener: the microphone is never opened\n   * (a listen-only ticket would be refused if it tried). Default `true`.\n   */\n  publish?: boolean;\n}\n\nexport interface VoiceCall {\n  mute(): Promise<void>;\n  unmute(): Promise<void>;\n  readonly muted: boolean;\n  /** Silence everyone else (true) or bring back each person's own volume (false). */\n  setOutputMuted(muted: boolean): void;\n  setInputDevice(deviceId: string): Promise<void>;\n  setOutputDevice(deviceId: string): Promise<void>;\n  /** 0–1 for one person. Kept while output is muted and applied on unmute. */\n  setVolume(identity: string, volume: number): void;\n  /** Identities of the people speaking right now, loudest first. Returns an unsubscribe. */\n  onSpeaking(cb: (identities: string[]) => void): () => void;\n  /** Everyone in the call, you included; called at once and on every join/leave. Returns an unsubscribe. */\n  onParticipants(cb: (participants: VoiceParticipant[]) => void): () => void;\n  /** F104.7 — turn your camera on or off. Needs a ticket with `\"camera\"` in `sources`. */\n  setCamera(on: boolean, opts?: { deviceId?: string }): Promise<void>;\n  /**\n   * F104.7 — share your screen (the browser asks which screen/window/tab) or stop.\n   * `audio: true` also offers the tab's sound (needs `\"screen_share_audio\"` in the ticket).\n   * Stopping with the browser's own «stop sharing» button is reported through `onLocalMedia`.\n   */\n  setScreenShare(on: boolean, opts?: { audio?: boolean }): Promise<void>;\n  readonly localMedia: LocalMedia;\n  /** Called at once and whenever your camera/screen share turns on or off — also from the browser's own stop button. Returns an unsubscribe. */\n  onLocalMedia(cb: (media: LocalMedia) => void): () => void;\n  /** Every video picture in the call (yours included), at once and whenever one comes or goes. Returns an unsubscribe. */\n  onVideos(cb: (videos: CallVideo[]) => void): () => void;\n  /** F104.7 — `true` stops receiving other people's video (weak connection); sound is untouched. `false` brings it back. */\n  setAudioOnly(on: boolean): void;\n  readonly audioOnly: boolean;\n  leave(): Promise<void>;\n}\n\n/** F104.7 — the room settings that keep 2–10 people with video usable. */\nexport const VIDEO_ROOM_OPTIONS = { adaptiveStream: true, dynacast: true, publishDefaults: { simulcast: true } } as const;\n\nexport const AUDIO_CAPTURE = { noiseSuppression: true, echoCancellation: true, autoGainControl: true } as const;\n\nexport async function joinVoice({ url, token, publish = true }: JoinOptions): Promise<VoiceCall> {\n  const room = new Room({ audioCaptureDefaults: { ...AUDIO_CAPTURE }, ...VIDEO_ROOM_OPTIONS, publishDefaults: { ...VIDEO_ROOM_OPTIONS.publishDefaults } });\n  const localMediaCbs = new Set<(m: LocalMedia) => void>();\n  const videoCbs = new Set<(v: CallVideo[]) => void>();\n  const remoteVideos = new Map<RemoteTrack, CallVideo>();\n  let audioOnly = false;\n  const speakingCbs = new Set<(ids: string[]) => void>();\n  const participantCbs = new Set<(ps: VoiceParticipant[]) => void>();\n  const volumes = new Map<string, number>();\n  const audioEls = new Map<RemoteTrack, HTMLMediaElement[]>();\n  let outputMuted = false;\n  let muted = !publish;\n  let left = false;\n\n  const participants = (): VoiceParticipant[] => [\n    toVoiceParticipant(room.localParticipant, true),\n    ...[...room.remoteParticipants.values()].map((p) => toVoiceParticipant(p, false)),\n  ];\n  const emitParticipants = () => {\n    if (left) return;\n    const list = participants();\n    participantCbs.forEach((cb) => cb(list));\n  };\n  const applyVolume = (p: RemoteParticipant) => p.setVolume(outputMuted ? 0 : (volumes.get(p.identity) ?? 1));\n\n  const localMedia = (): LocalMedia => ({\n    camera: room.localParticipant.isCameraEnabled,\n    screenShare: room.localParticipant.isScreenShareEnabled,\n  });\n  const emitLocalMedia = () => {\n    if (left) return;\n    const m = localMedia();\n    localMediaCbs.forEach((cb) => cb(m));\n  };\n  const videos = (): CallVideo[] => {\n    const local: CallVideo[] = [];\n    for (const pub of room.localParticipant.videoTrackPublications.values()) {\n      const v = localVideo(pub, room.localParticipant);\n      if (v) local.push(v);\n    }\n    return [...local, ...remoteVideos.values()];\n  };\n  const emitVideos = () => {\n    if (left) return;\n    const list = videos();\n    videoCbs.forEach((cb) => cb(list));\n  };\n  const onLocalChange = () => { emitLocalMedia(); emitVideos(); };\n  // Audio-only only ever touches VIDEO publications — sound keeps flowing.\n  const applyAudioOnly = (pub: RemoteTrackPublication) => {\n    if (pub.kind === Track.Kind.Video) pub.setSubscribed(!audioOnly);\n  };\n\n  const handlers: [RoomEvent, (...args: any[]) => void][] = [\n    [RoomEvent.ParticipantConnected, (p: RemoteParticipant) => { applyVolume(p); emitParticipants(); }],\n    [RoomEvent.ParticipantDisconnected, () => emitParticipants()],\n    [RoomEvent.ActiveSpeakersChanged, (speakers: Participant[]) => {\n      if (left) return;\n      const ids = speakers.map((s) => s.identity);\n      speakingCbs.forEach((cb) => cb(ids));\n    }],\n    [RoomEvent.TrackSubscribed, (track: RemoteTrack, _pub: unknown, p: RemoteParticipant) => {\n      if (track.kind === Track.Kind.Video) {\n        const source = toVideoSource(track.source);\n        if (!source) return;\n        remoteVideos.set(track, videoOf(`${p.identity}:${track.sid ?? source}`, p, false, source, track));\n        emitVideos();\n        return;\n      }\n      if (track.kind !== Track.Kind.Audio) return;\n      const el = track.attach();\n      document.body.appendChild(el);\n      audioEls.set(track, [el]);\n      applyVolume(p);\n    }],\n    [RoomEvent.TrackUnsubscribed, (track: RemoteTrack) => {\n      if (remoteVideos.delete(track)) {\n        track.detach();\n        emitVideos();\n        return;\n      }\n      track.detach().forEach((el) => el.remove());\n      audioEls.delete(track);\n    }],\n    [RoomEvent.TrackPublished, (pub: RemoteTrackPublication) => { if (audioOnly) applyAudioOnly(pub); }],\n    // Fired for our own camera/screen going on or off — including when the\n    // person ends a screen share with the BROWSER's stop button, which never\n    // passes through setScreenShare.\n    [RoomEvent.LocalTrackPublished, onLocalChange],\n    [RoomEvent.LocalTrackUnpublished, onLocalChange],\n  ];\n  for (const [event, fn] of handlers) room.on(event, fn);\n\n  try {\n    await room.connect(url, token);\n    if (publish) await room.localParticipant.setMicrophoneEnabled(true, { ...AUDIO_CAPTURE });\n    // joinVoice is called from a click; this is the gesture browsers require before audio may play.\n    await room.startAudio();\n  } catch (e) {\n    // A refused microphone must not leave the person connected and listening\n    // with no handle to leave — the caller only gets the rejection.\n    left = true;\n    for (const [event, fn] of handlers) room.off(event, fn);\n    await room.disconnect();\n    throw e;\n  }\n\n  return {\n    get muted() { return muted; },\n    async mute() { await room.localParticipant.setMicrophoneEnabled(false); muted = true; },\n    async unmute() { await room.localParticipant.setMicrophoneEnabled(true, { ...AUDIO_CAPTURE }); muted = false; },\n    setOutputMuted(m) {\n      outputMuted = m;\n      room.remoteParticipants.forEach(applyVolume);\n    },\n    async setInputDevice(deviceId) { await room.switchActiveDevice(\"audioinput\", deviceId); },\n    async setOutputDevice(deviceId) { await room.switchActiveDevice(\"audiooutput\", deviceId); },\n    setVolume(identity, volume) {\n      volumes.set(identity, Math.min(1, Math.max(0, volume)));\n      const p = room.remoteParticipants.get(identity);\n      if (p) applyVolume(p);\n    },\n    onSpeaking(cb) {\n      speakingCbs.add(cb);\n      return () => speakingCbs.delete(cb);\n    },\n    onParticipants(cb) {\n      participantCbs.add(cb);\n      if (!left) cb(participants());\n      return () => participantCbs.delete(cb);\n    },\n    async setCamera(on, opts) {\n      await room.localParticipant.setCameraEnabled(on, opts?.deviceId ? { deviceId: opts.deviceId } : undefined);\n      onLocalChange();\n    },\n    async setScreenShare(on, opts) {\n      await room.localParticipant.setScreenShareEnabled(on, on ? { audio: opts?.audio === true } : undefined);\n      onLocalChange();\n    },\n    get localMedia() { return localMedia(); },\n    onLocalMedia(cb) {\n      localMediaCbs.add(cb);\n      if (!left) cb(localMedia());\n      return () => localMediaCbs.delete(cb);\n    },\n    onVideos(cb) {\n      videoCbs.add(cb);\n      if (!left) cb(videos());\n      return () => videoCbs.delete(cb);\n    },\n    get audioOnly() { return audioOnly; },\n    setAudioOnly(on) {\n      audioOnly = on;\n      room.remoteParticipants.forEach((p) => p.trackPublications.forEach(applyAudioOnly));\n    },\n    async leave() {\n      left = true;\n      for (const [event, fn] of handlers) room.off(event, fn);\n      speakingCbs.clear();\n      participantCbs.clear();\n      localMediaCbs.clear();\n      videoCbs.clear();\n      remoteVideos.forEach((_v, track) => track.detach());\n      remoteVideos.clear();\n      audioEls.forEach((_els, track) => track.detach().forEach((el) => el.remove()));\n      audioEls.clear();\n      await room.disconnect();\n    },\n  };\n}\n\nfunction toVideoSource(source: Track.Source): CallVideo[\"source\"] | undefined {\n  if (source === Track.Source.Camera) return \"camera\";\n  if (source === Track.Source.ScreenShare) return \"screen_share\";\n  return undefined;\n}\n\nfunction localVideo(pub: LocalTrackPublication, p: Participant): CallVideo | undefined {\n  const source = toVideoSource(pub.source);\n  if (!pub.track || !source) return undefined;\n  return videoOf(`${p.identity}:${pub.trackSid}`, p, true, source, pub.track);\n}\n\nfunction videoOf(\n  id: string,\n  p: Participant,\n  isLocal: boolean,\n  source: CallVideo[\"source\"],\n  track: { attach(el: HTMLMediaElement): HTMLMediaElement; detach(el: HTMLMediaElement): HTMLMediaElement },\n): CallVideo {\n  return {\n    id,\n    identity: p.identity,\n    name: p.name || p.identity,\n    isLocal,\n    source,\n    attach(el) {\n      el.autoplay = true;\n      el.playsInline = true;\n      // Your own camera would otherwise echo the room back through the page.\n      if (isLocal) el.muted = true;\n      track.attach(el);\n    },\n    detach(el) { track.detach(el); },\n  };\n}\n\nfunction toVoiceParticipant(p: Participant, isLocal: boolean): VoiceParticipant {\n  return { identity: p.identity, name: p.name || p.identity, isLocal };\n}\n"]}

package/dist/server.cjs

@@ -11,6 +11,12 @@ var VoiceError = class extends Error {
   }
   code;
 };
+var SOURCE_TO_LIVEKIT = {
+  microphone: livekitServerSdk.TrackSource.MICROPHONE,
+  camera: livekitServerSdk.TrackSource.CAMERA,
+  screen_share: livekitServerSdk.TrackSource.SCREEN_SHARE,
+  screen_share_audio: livekitServerSdk.TrackSource.SCREEN_SHARE_AUDIO
+};
 var DEFAULT_TTL_SECONDS = 600;
 var MAX_TTL_SECONDS = 3600;
 function requireCredentials({ apiKey, apiSecret }) {
@@ -26,18 +32,29 @@ async function createRoomToken(opts) {
   if (!Number.isInteger(ttl) || ttl <= 0 || ttl > MAX_TTL_SECONDS) {
     throw new VoiceError("invalid_ttl", `ttl must be a whole number of seconds between 1 and ${MAX_TTL_SECONDS}`);
   }
-  const token = new livekitServerSdk.AccessToken(opts.apiKey, opts.apiSecret, { identity: opts.identity, name: opts.name, ttl });
   const speak = opts.canPublish !== false;
+  const sources = resolveSources(opts.sources, speak);
+  const token = new livekitServerSdk.AccessToken(opts.apiKey, opts.apiSecret, { identity: opts.identity, name: opts.name, ttl });
   token.addGrant({
     room: opts.room,
     roomJoin: true,
     canSubscribe: true,
     canPublish: speak,
-    ...speak ? { canPublishSources: [livekitServerSdk.TrackSource.MICROPHONE] } : {},
+    ...speak ? { canPublishSources: sources.map((src) => SOURCE_TO_LIVEKIT[src]) } : {},
     canPublishData: false
   });
   return token.toJwt();
 }
+function resolveSources(sources, speak) {
+  if (sources === void 0) return ["microphone"];
+  if (!speak) throw new VoiceError("invalid_sources", "sources cannot be given with canPublish: false \u2014 a listener sends nothing");
+  if (!Array.isArray(sources) || sources.length === 0) {
+    throw new VoiceError("invalid_sources", "sources must name at least one of microphone, camera, screen_share, screen_share_audio");
+  }
+  const unknown = sources.filter((src) => !Object.hasOwn(SOURCE_TO_LIVEKIT, src));
+  if (unknown.length) throw new VoiceError("invalid_sources", `unknown source(s): ${unknown.join(", ")}`);
+  return [...new Set(sources)];
+}
 async function verifyWebhook(body, authHeader, credentials) {
   requireCredentials(credentials);
   try {

package/dist/server.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/server.ts"],"names":["AccessToken","TrackSource","WebhookReceiver"],"mappings":";;;;;AAmBO,IAAM,UAAA,GAAN,cAAyB,KAAA,CAAM;AAAA,EACpC,WAAA,CACW,MACT,OAAA,EACA;AACA,IAAA,KAAA,CAAM,OAAO,CAAA;AAHJ,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAIT,IAAA,IAAA,CAAK,IAAA,GAAO,YAAA;AAAA,EACd;AAAA,EALW,IAAA;AAMb;AAwBO,IAAM,mBAAA,GAAsB;AAC5B,IAAM,eAAA,GAAkB;AAE/B,SAAS,kBAAA,CAAmB,EAAE,MAAA,EAAQ,SAAA,EAAU,EAA+B;AAI7E,EAAA,IAAI,CAAC,MAAA,IAAU,CAAC,SAAA,EAAW;AACzB,IAAA,MAAM,IAAI,UAAA,CAAW,qBAAA,EAAuB,mCAAmC,CAAA;AAAA,EACjF;AACF;AAGA,eAAsB,gBAAgB,IAAA,EAAyC;AAC7E,EAAA,kBAAA,CAAmB,IAAI,CAAA;AACvB,EAAA,IAAI,CAAC,KAAK,IAAA,EAAM,IAAA,IAAQ,MAAM,IAAI,UAAA,CAAW,cAAA,EAAgB,kBAAkB,CAAA;AAC/E,EAAA,IAAI,CAAC,KAAK,QAAA,EAAU,IAAA,IAAQ,MAAM,IAAI,UAAA,CAAW,kBAAA,EAAoB,sBAAsB,CAAA;AAC3F,EAAA,MAAM,GAAA,GAAM,KAAK,GAAA,IAAO,mBAAA;AACxB,EAAA,IAAI,CAAC,OAAO,SAAA,CAAU,GAAG,KAAK,GAAA,IAAO,CAAA,IAAK,MAAM,eAAA,EAAiB;AAC/D,IAAA,MAAM,IAAI,UAAA,CAAW,aAAA,EAAe,CAAA,oDAAA,EAAuD,eAAe,CAAA,CAAE,CAAA;AAAA,EAC9G;AAEA,EAAA,MAAM,KAAA,GAAQ,IAAIA,4BAAA,CAAY,IAAA,CAAK,QAAQ,IAAA,CAAK,SAAA,EAAW,EAAE,QAAA,EAAU,KAAK,QAAA,EAAU,IAAA,EAAM,IAAA,CAAK,IAAA,EAAM,KAAK,CAAA;AAC5G,EAAA,MAAM,KAAA,GAAQ,KAAK,UAAA,KAAe,KAAA;AAClC,EAAA,KAAA,CAAM,QAAA,CAAS;AAAA,IACb,MAAM,IAAA,CAAK,IAAA;AAAA,IACX,QAAA,EAAU,IAAA;AAAA,IACV,YAAA,EAAc,IAAA;AAAA,IACd,UAAA,EAAY,KAAA;AAAA,IACZ,GAAI,QAAQ,EAAE,iBAAA,EAAmB,CAACC,4BAAA,CAAY,UAAU,CAAA,EAAE,GAAI,EAAC;AAAA,IAC/D,cAAA,EAAgB;AAAA,GACjB,CAAA;AACD,EAAA,OAAO,MAAM,KAAA,EAAM;AACrB;AAMA,eAAsB,aAAA,CACpB,IAAA,EACA,UAAA,EACA,WAAA,EACuB;AACvB,EAAA,kBAAA,CAAmB,WAAW,CAAA;AAC9B,EAAA,IAAI;AAEF,IAAA,OAAO,MAAM,IAAIC,gCAAA,CAAgB,WAAA,CAAY,MAAA,EAAQ,WAAA,CAAY,SAAS,CAAA,CAAE,OAAA,CAAQ,IAAA,EAAM,UAAA,IAAc,KAAA,CAAS,CAAA;AAAA,EACnH,SAAS,CAAA,EAAG;AACV,IAAA,MAAM,IAAI,UAAA,CAAW,iBAAA,EAAmB,CAAA,kBAAA,EAAsB,CAAA,CAAY,OAAO,CAAA,CAAE,CAAA;AAAA,EACrF;AACF","file":"server.cjs","sourcesContent":["// @broberg/call/server — the app's half of a voice call (F104.3).\n//\n// The app never carries audio. It decides who may enter a room, signs a short\n// ticket for that one room, and hears from the media server (LiveKit) through a\n// signed webhook when people join and leave. Built on LiveKit's own SDK so the\n// ticket format and the webhook signature are LiveKit's, not ours.\n\nimport { AccessToken, TrackSource, WebhookReceiver } from \"livekit-server-sdk\";\nimport type { WebhookEvent } from \"livekit-server-sdk\";\n\nexport type { WebhookEvent };\n\nexport type VoiceErrorCode =\n  | \"missing_credentials\"\n  | \"invalid_room\"\n  | \"invalid_identity\"\n  | \"invalid_ttl\"\n  | \"invalid_webhook\";\n\nexport class VoiceError extends Error {\n  constructor(\n    readonly code: VoiceErrorCode,\n    message: string,\n  ) {\n    super(message);\n    this.name = \"VoiceError\";\n  }\n}\n\nexport interface Credentials {\n  apiKey: string;\n  apiSecret: string;\n}\n\nexport interface RoomTokenOptions extends Credentials {\n  /** One room, e.g. `jam:<jam-id>`. The ticket admits to this room only. */\n  room: string;\n  /** Stable id of the person — the same person joining twice replaces the first connection. */\n  identity: string;\n  /** Display name other participants see. */\n  name?: string;\n  /** Seconds the ticket can be used to ENTER. Default 600, max 3600. A call in progress is not cut off when it expires. */\n  ttl?: number;\n  /**\n   * F104.4 — `false` makes a LISTEN-ONLY ticket: the person can join and hear\n   * everyone but publish nothing (no microphone, no data). Default `true`.\n   * Pair it with `joinVoice({ publish: false })` in the browser.\n   */\n  canPublish?: boolean;\n}\n\nexport const DEFAULT_TTL_SECONDS = 600;\nexport const MAX_TTL_SECONDS = 3600;\n\nfunction requireCredentials({ apiKey, apiSecret }: Partial<Credentials>): void {\n  // LiveKit's AccessToken falls back to LIVEKIT_API_KEY/SECRET from the\n  // environment when these are missing — a ticket signed with a key the caller\n  // never chose. Refuse instead.\n  if (!apiKey || !apiSecret) {\n    throw new VoiceError(\"missing_credentials\", \"apiKey and apiSecret are required\");\n  }\n}\n\n/** Sign a microphone-only ticket for one room. Check the person's access BEFORE calling this. */\nexport async function createRoomToken(opts: RoomTokenOptions): Promise<string> {\n  requireCredentials(opts);\n  if (!opts.room?.trim()) throw new VoiceError(\"invalid_room\", \"room is required\");\n  if (!opts.identity?.trim()) throw new VoiceError(\"invalid_identity\", \"identity is required\");\n  const ttl = opts.ttl ?? DEFAULT_TTL_SECONDS;\n  if (!Number.isInteger(ttl) || ttl <= 0 || ttl > MAX_TTL_SECONDS) {\n    throw new VoiceError(\"invalid_ttl\", `ttl must be a whole number of seconds between 1 and ${MAX_TTL_SECONDS}`);\n  }\n\n  const token = new AccessToken(opts.apiKey, opts.apiSecret, { identity: opts.identity, name: opts.name, ttl });\n  const speak = opts.canPublish !== false;\n  token.addGrant({\n    room: opts.room,\n    roomJoin: true,\n    canSubscribe: true,\n    canPublish: speak,\n    ...(speak ? { canPublishSources: [TrackSource.MICROPHONE] } : {}),\n    canPublishData: false,\n  });\n  return token.toJwt();\n}\n\n/**\n * Verify a webhook from the media server and return its event.\n * `body` must be the RAW request body — re-serialised JSON changes the hash.\n */\nexport async function verifyWebhook(\n  body: string,\n  authHeader: string | null | undefined,\n  credentials: Credentials,\n): Promise<WebhookEvent> {\n  requireCredentials(credentials);\n  try {\n    // A missing header is refused by LiveKit itself (\"authorization header is empty\").\n    return await new WebhookReceiver(credentials.apiKey, credentials.apiSecret).receive(body, authHeader ?? undefined);\n  } catch (e) {\n    throw new VoiceError(\"invalid_webhook\", `webhook rejected: ${(e as Error).message}`);\n  }\n}\n"]}
+{"version":3,"sources":["../src/server.ts"],"names":["TrackSource","AccessToken","WebhookReceiver"],"mappings":"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","file":"server.cjs","sourcesContent":["// @broberg/call/server — the app's half of a call (F104.3; video and screen share F104.7).\n//\n// The app never carries audio. It decides who may enter a room, signs a short\n// ticket for that one room, and hears from the media server (LiveKit) through a\n// signed webhook when people join and leave. Built on LiveKit's own SDK so the\n// ticket format and the webhook signature are LiveKit's, not ours.\n\nimport { AccessToken, TrackSource, WebhookReceiver } from \"livekit-server-sdk\";\nimport type { WebhookEvent } from \"livekit-server-sdk\";\n\nexport type { WebhookEvent };\n\nexport type VoiceErrorCode =\n  | \"missing_credentials\"\n  | \"invalid_room\"\n  | \"invalid_identity\"\n  | \"invalid_ttl\"\n  | \"invalid_sources\"\n  | \"invalid_webhook\";\n\nexport class VoiceError extends Error {\n  constructor(\n    readonly code: VoiceErrorCode,\n    message: string,\n  ) {\n    super(message);\n    this.name = \"VoiceError\";\n  }\n}\n\nexport interface Credentials {\n  apiKey: string;\n  apiSecret: string;\n}\n\nexport interface RoomTokenOptions extends Credentials {\n  /** One room, e.g. `jam:<jam-id>`. The ticket admits to this room only. */\n  room: string;\n  /** Stable id of the person — the same person joining twice replaces the first connection. */\n  identity: string;\n  /** Display name other participants see. */\n  name?: string;\n  /** Seconds the ticket can be used to ENTER. Default 600, max 3600. A call in progress is not cut off when it expires. */\n  ttl?: number;\n  /**\n   * F104.4 — `false` makes a LISTEN-ONLY ticket: the person can join and hear\n   * everyone but publish nothing (no microphone, no data). Default `true`.\n   * Pair it with `joinVoice({ publish: false })` in the browser.\n   */\n  canPublish?: boolean;\n  /**\n   * F104.7 — what the person may send. Default `[\"microphone\"]`, so an app that\n   * never asks for video still mints a sound-only ticket. Add `\"camera\"`,\n   * `\"screen_share\"` and/or `\"screen_share_audio\"` (the sound of a shared tab).\n   * Refused together with `canPublish: false` — a listener sends nothing.\n   */\n  sources?: CallSource[];\n}\n\n/** F104.7 — the kinds of media a ticket may allow a person to send. */\nexport type CallSource = \"microphone\" | \"camera\" | \"screen_share\" | \"screen_share_audio\";\n\nconst SOURCE_TO_LIVEKIT: Record<CallSource, TrackSource> = {\n  microphone: TrackSource.MICROPHONE,\n  camera: TrackSource.CAMERA,\n  screen_share: TrackSource.SCREEN_SHARE,\n  screen_share_audio: TrackSource.SCREEN_SHARE_AUDIO,\n};\n\nexport const DEFAULT_TTL_SECONDS = 600;\nexport const MAX_TTL_SECONDS = 3600;\n\nfunction requireCredentials({ apiKey, apiSecret }: Partial<Credentials>): void {\n  // LiveKit's AccessToken falls back to LIVEKIT_API_KEY/SECRET from the\n  // environment when these are missing — a ticket signed with a key the caller\n  // never chose. Refuse instead.\n  if (!apiKey || !apiSecret) {\n    throw new VoiceError(\"missing_credentials\", \"apiKey and apiSecret are required\");\n  }\n}\n\n/**\n * Sign a ticket for one room — microphone only unless `sources` says more.\n * Check the person's access BEFORE calling this.\n */\nexport async function createRoomToken(opts: RoomTokenOptions): Promise<string> {\n  requireCredentials(opts);\n  if (!opts.room?.trim()) throw new VoiceError(\"invalid_room\", \"room is required\");\n  if (!opts.identity?.trim()) throw new VoiceError(\"invalid_identity\", \"identity is required\");\n  const ttl = opts.ttl ?? DEFAULT_TTL_SECONDS;\n  if (!Number.isInteger(ttl) || ttl <= 0 || ttl > MAX_TTL_SECONDS) {\n    throw new VoiceError(\"invalid_ttl\", `ttl must be a whole number of seconds between 1 and ${MAX_TTL_SECONDS}`);\n  }\n\n  const speak = opts.canPublish !== false;\n  const sources = resolveSources(opts.sources, speak);\n\n  const token = new AccessToken(opts.apiKey, opts.apiSecret, { identity: opts.identity, name: opts.name, ttl });\n  token.addGrant({\n    room: opts.room,\n    roomJoin: true,\n    canSubscribe: true,\n    canPublish: speak,\n    ...(speak ? { canPublishSources: sources.map((src) => SOURCE_TO_LIVEKIT[src]) } : {}),\n    canPublishData: false,\n  });\n  return token.toJwt();\n}\n\nfunction resolveSources(sources: CallSource[] | undefined, speak: boolean): CallSource[] {\n  if (sources === undefined) return [\"microphone\"];\n  if (!speak) throw new VoiceError(\"invalid_sources\", \"sources cannot be given with canPublish: false — a listener sends nothing\");\n  if (!Array.isArray(sources) || sources.length === 0) {\n    throw new VoiceError(\"invalid_sources\", \"sources must name at least one of microphone, camera, screen_share, screen_share_audio\");\n  }\n  const unknown = sources.filter((src) => !Object.hasOwn(SOURCE_TO_LIVEKIT, src));\n  if (unknown.length) throw new VoiceError(\"invalid_sources\", `unknown source(s): ${unknown.join(\", \")}`);\n  return [...new Set(sources)];\n}\n\n/**\n * Verify a webhook from the media server and return its event.\n * `body` must be the RAW request body — re-serialised JSON changes the hash.\n */\nexport async function verifyWebhook(\n  body: string,\n  authHeader: string | null | undefined,\n  credentials: Credentials,\n): Promise<WebhookEvent> {\n  requireCredentials(credentials);\n  try {\n    // A missing header is refused by LiveKit itself (\"authorization header is empty\").\n    return await new WebhookReceiver(credentials.apiKey, credentials.apiSecret).receive(body, authHeader ?? undefined);\n  } catch (e) {\n    throw new VoiceError(\"invalid_webhook\", `webhook rejected: ${(e as Error).message}`);\n  }\n}\n"]}

package/dist/server.d.cts

@@ -1,7 +1,7 @@
 import { WebhookEvent } from 'livekit-server-sdk';
 export { WebhookEvent } from 'livekit-server-sdk';
 
-type VoiceErrorCode = "missing_credentials" | "invalid_room" | "invalid_identity" | "invalid_ttl" | "invalid_webhook";
+type VoiceErrorCode = "missing_credentials" | "invalid_room" | "invalid_identity" | "invalid_ttl" | "invalid_sources" | "invalid_webhook";
 declare class VoiceError extends Error {
     readonly code: VoiceErrorCode;
     constructor(code: VoiceErrorCode, message: string);
@@ -25,10 +25,22 @@ interface RoomTokenOptions extends Credentials {
      * Pair it with `joinVoice({ publish: false })` in the browser.
      */
     canPublish?: boolean;
+    /**
+     * F104.7 — what the person may send. Default `["microphone"]`, so an app that
+     * never asks for video still mints a sound-only ticket. Add `"camera"`,
+     * `"screen_share"` and/or `"screen_share_audio"` (the sound of a shared tab).
+     * Refused together with `canPublish: false` — a listener sends nothing.
+     */
+    sources?: CallSource[];
 }
+/** F104.7 — the kinds of media a ticket may allow a person to send. */
+type CallSource = "microphone" | "camera" | "screen_share" | "screen_share_audio";
 declare const DEFAULT_TTL_SECONDS = 600;
 declare const MAX_TTL_SECONDS = 3600;
-/** Sign a microphone-only ticket for one room. Check the person's access BEFORE calling this. */
+/**
+ * Sign a ticket for one room — microphone only unless `sources` says more.
+ * Check the person's access BEFORE calling this.
+ */
 declare function createRoomToken(opts: RoomTokenOptions): Promise<string>;
 /**
  * Verify a webhook from the media server and return its event.
@@ -36,4 +48,4 @@ declare function createRoomToken(opts: RoomTokenOptions): Promise<string>;
  */
 declare function verifyWebhook(body: string, authHeader: string | null | undefined, credentials: Credentials): Promise<WebhookEvent>;
 
-export { type Credentials, DEFAULT_TTL_SECONDS, MAX_TTL_SECONDS, type RoomTokenOptions, VoiceError, type VoiceErrorCode, createRoomToken, verifyWebhook };
+export { type CallSource, type Credentials, DEFAULT_TTL_SECONDS, MAX_TTL_SECONDS, type RoomTokenOptions, VoiceError, type VoiceErrorCode, createRoomToken, verifyWebhook };

package/dist/server.d.ts

@@ -1,7 +1,7 @@
 import { WebhookEvent } from 'livekit-server-sdk';
 export { WebhookEvent } from 'livekit-server-sdk';
 
-type VoiceErrorCode = "missing_credentials" | "invalid_room" | "invalid_identity" | "invalid_ttl" | "invalid_webhook";
+type VoiceErrorCode = "missing_credentials" | "invalid_room" | "invalid_identity" | "invalid_ttl" | "invalid_sources" | "invalid_webhook";
 declare class VoiceError extends Error {
     readonly code: VoiceErrorCode;
     constructor(code: VoiceErrorCode, message: string);
@@ -25,10 +25,22 @@ interface RoomTokenOptions extends Credentials {
      * Pair it with `joinVoice({ publish: false })` in the browser.
      */
     canPublish?: boolean;
+    /**
+     * F104.7 — what the person may send. Default `["microphone"]`, so an app that
+     * never asks for video still mints a sound-only ticket. Add `"camera"`,
+     * `"screen_share"` and/or `"screen_share_audio"` (the sound of a shared tab).
+     * Refused together with `canPublish: false` — a listener sends nothing.
+     */
+    sources?: CallSource[];
 }
+/** F104.7 — the kinds of media a ticket may allow a person to send. */
+type CallSource = "microphone" | "camera" | "screen_share" | "screen_share_audio";
 declare const DEFAULT_TTL_SECONDS = 600;
 declare const MAX_TTL_SECONDS = 3600;
-/** Sign a microphone-only ticket for one room. Check the person's access BEFORE calling this. */
+/**
+ * Sign a ticket for one room — microphone only unless `sources` says more.
+ * Check the person's access BEFORE calling this.
+ */
 declare function createRoomToken(opts: RoomTokenOptions): Promise<string>;
 /**
  * Verify a webhook from the media server and return its event.
@@ -36,4 +48,4 @@ declare function createRoomToken(opts: RoomTokenOptions): Promise<string>;
  */
 declare function verifyWebhook(body: string, authHeader: string | null | undefined, credentials: Credentials): Promise<WebhookEvent>;
 
-export { type Credentials, DEFAULT_TTL_SECONDS, MAX_TTL_SECONDS, type RoomTokenOptions, VoiceError, type VoiceErrorCode, createRoomToken, verifyWebhook };
+export { type CallSource, type Credentials, DEFAULT_TTL_SECONDS, MAX_TTL_SECONDS, type RoomTokenOptions, VoiceError, type VoiceErrorCode, createRoomToken, verifyWebhook };

package/dist/server.js

@@ -1,4 +1,4 @@
-import { AccessToken, TrackSource, WebhookReceiver } from 'livekit-server-sdk';
+import { TrackSource, AccessToken, WebhookReceiver } from 'livekit-server-sdk';
 
 // src/server.ts
 var VoiceError = class extends Error {
@@ -9,6 +9,12 @@ var VoiceError = class extends Error {
   }
   code;
 };
+var SOURCE_TO_LIVEKIT = {
+  microphone: TrackSource.MICROPHONE,
+  camera: TrackSource.CAMERA,
+  screen_share: TrackSource.SCREEN_SHARE,
+  screen_share_audio: TrackSource.SCREEN_SHARE_AUDIO
+};
 var DEFAULT_TTL_SECONDS = 600;
 var MAX_TTL_SECONDS = 3600;
 function requireCredentials({ apiKey, apiSecret }) {
@@ -24,18 +30,29 @@ async function createRoomToken(opts) {
   if (!Number.isInteger(ttl) || ttl <= 0 || ttl > MAX_TTL_SECONDS) {
     throw new VoiceError("invalid_ttl", `ttl must be a whole number of seconds between 1 and ${MAX_TTL_SECONDS}`);
   }
-  const token = new AccessToken(opts.apiKey, opts.apiSecret, { identity: opts.identity, name: opts.name, ttl });
   const speak = opts.canPublish !== false;
+  const sources = resolveSources(opts.sources, speak);
+  const token = new AccessToken(opts.apiKey, opts.apiSecret, { identity: opts.identity, name: opts.name, ttl });
   token.addGrant({
     room: opts.room,
     roomJoin: true,
     canSubscribe: true,
     canPublish: speak,
-    ...speak ? { canPublishSources: [TrackSource.MICROPHONE] } : {},
+    ...speak ? { canPublishSources: sources.map((src) => SOURCE_TO_LIVEKIT[src]) } : {},
     canPublishData: false
   });
   return token.toJwt();
 }
+function resolveSources(sources, speak) {
+  if (sources === void 0) return ["microphone"];
+  if (!speak) throw new VoiceError("invalid_sources", "sources cannot be given with canPublish: false \u2014 a listener sends nothing");
+  if (!Array.isArray(sources) || sources.length === 0) {
+    throw new VoiceError("invalid_sources", "sources must name at least one of microphone, camera, screen_share, screen_share_audio");
+  }
+  const unknown = sources.filter((src) => !Object.hasOwn(SOURCE_TO_LIVEKIT, src));
+  if (unknown.length) throw new VoiceError("invalid_sources", `unknown source(s): ${unknown.join(", ")}`);
+  return [...new Set(sources)];
+}
 async function verifyWebhook(body, authHeader, credentials) {
   requireCredentials(credentials);
   try {

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/server.ts"],"names":[],"mappings":";;;AAmBO,IAAM,UAAA,GAAN,cAAyB,KAAA,CAAM;AAAA,EACpC,WAAA,CACW,MACT,OAAA,EACA;AACA,IAAA,KAAA,CAAM,OAAO,CAAA;AAHJ,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAIT,IAAA,IAAA,CAAK,IAAA,GAAO,YAAA;AAAA,EACd;AAAA,EALW,IAAA;AAMb;AAwBO,IAAM,mBAAA,GAAsB;AAC5B,IAAM,eAAA,GAAkB;AAE/B,SAAS,kBAAA,CAAmB,EAAE,MAAA,EAAQ,SAAA,EAAU,EAA+B;AAI7E,EAAA,IAAI,CAAC,MAAA,IAAU,CAAC,SAAA,EAAW;AACzB,IAAA,MAAM,IAAI,UAAA,CAAW,qBAAA,EAAuB,mCAAmC,CAAA;AAAA,EACjF;AACF;AAGA,eAAsB,gBAAgB,IAAA,EAAyC;AAC7E,EAAA,kBAAA,CAAmB,IAAI,CAAA;AACvB,EAAA,IAAI,CAAC,KAAK,IAAA,EAAM,IAAA,IAAQ,MAAM,IAAI,UAAA,CAAW,cAAA,EAAgB,kBAAkB,CAAA;AAC/E,EAAA,IAAI,CAAC,KAAK,QAAA,EAAU,IAAA,IAAQ,MAAM,IAAI,UAAA,CAAW,kBAAA,EAAoB,sBAAsB,CAAA;AAC3F,EAAA,MAAM,GAAA,GAAM,KAAK,GAAA,IAAO,mBAAA;AACxB,EAAA,IAAI,CAAC,OAAO,SAAA,CAAU,GAAG,KAAK,GAAA,IAAO,CAAA,IAAK,MAAM,eAAA,EAAiB;AAC/D,IAAA,MAAM,IAAI,UAAA,CAAW,aAAA,EAAe,CAAA,oDAAA,EAAuD,eAAe,CAAA,CAAE,CAAA;AAAA,EAC9G;AAEA,EAAA,MAAM,KAAA,GAAQ,IAAI,WAAA,CAAY,IAAA,CAAK,QAAQ,IAAA,CAAK,SAAA,EAAW,EAAE,QAAA,EAAU,KAAK,QAAA,EAAU,IAAA,EAAM,IAAA,CAAK,IAAA,EAAM,KAAK,CAAA;AAC5G,EAAA,MAAM,KAAA,GAAQ,KAAK,UAAA,KAAe,KAAA;AAClC,EAAA,KAAA,CAAM,QAAA,CAAS;AAAA,IACb,MAAM,IAAA,CAAK,IAAA;AAAA,IACX,QAAA,EAAU,IAAA;AAAA,IACV,YAAA,EAAc,IAAA;AAAA,IACd,UAAA,EAAY,KAAA;AAAA,IACZ,GAAI,QAAQ,EAAE,iBAAA,EAAmB,CAAC,WAAA,CAAY,UAAU,CAAA,EAAE,GAAI,EAAC;AAAA,IAC/D,cAAA,EAAgB;AAAA,GACjB,CAAA;AACD,EAAA,OAAO,MAAM,KAAA,EAAM;AACrB;AAMA,eAAsB,aAAA,CACpB,IAAA,EACA,UAAA,EACA,WAAA,EACuB;AACvB,EAAA,kBAAA,CAAmB,WAAW,CAAA;AAC9B,EAAA,IAAI;AAEF,IAAA,OAAO,MAAM,IAAI,eAAA,CAAgB,WAAA,CAAY,MAAA,EAAQ,WAAA,CAAY,SAAS,CAAA,CAAE,OAAA,CAAQ,IAAA,EAAM,UAAA,IAAc,KAAA,CAAS,CAAA;AAAA,EACnH,SAAS,CAAA,EAAG;AACV,IAAA,MAAM,IAAI,UAAA,CAAW,iBAAA,EAAmB,CAAA,kBAAA,EAAsB,CAAA,CAAY,OAAO,CAAA,CAAE,CAAA;AAAA,EACrF;AACF","file":"server.js","sourcesContent":["// @broberg/call/server — the app's half of a voice call (F104.3).\n//\n// The app never carries audio. It decides who may enter a room, signs a short\n// ticket for that one room, and hears from the media server (LiveKit) through a\n// signed webhook when people join and leave. Built on LiveKit's own SDK so the\n// ticket format and the webhook signature are LiveKit's, not ours.\n\nimport { AccessToken, TrackSource, WebhookReceiver } from \"livekit-server-sdk\";\nimport type { WebhookEvent } from \"livekit-server-sdk\";\n\nexport type { WebhookEvent };\n\nexport type VoiceErrorCode =\n  | \"missing_credentials\"\n  | \"invalid_room\"\n  | \"invalid_identity\"\n  | \"invalid_ttl\"\n  | \"invalid_webhook\";\n\nexport class VoiceError extends Error {\n  constructor(\n    readonly code: VoiceErrorCode,\n    message: string,\n  ) {\n    super(message);\n    this.name = \"VoiceError\";\n  }\n}\n\nexport interface Credentials {\n  apiKey: string;\n  apiSecret: string;\n}\n\nexport interface RoomTokenOptions extends Credentials {\n  /** One room, e.g. `jam:<jam-id>`. The ticket admits to this room only. */\n  room: string;\n  /** Stable id of the person — the same person joining twice replaces the first connection. */\n  identity: string;\n  /** Display name other participants see. */\n  name?: string;\n  /** Seconds the ticket can be used to ENTER. Default 600, max 3600. A call in progress is not cut off when it expires. */\n  ttl?: number;\n  /**\n   * F104.4 — `false` makes a LISTEN-ONLY ticket: the person can join and hear\n   * everyone but publish nothing (no microphone, no data). Default `true`.\n   * Pair it with `joinVoice({ publish: false })` in the browser.\n   */\n  canPublish?: boolean;\n}\n\nexport const DEFAULT_TTL_SECONDS = 600;\nexport const MAX_TTL_SECONDS = 3600;\n\nfunction requireCredentials({ apiKey, apiSecret }: Partial<Credentials>): void {\n  // LiveKit's AccessToken falls back to LIVEKIT_API_KEY/SECRET from the\n  // environment when these are missing — a ticket signed with a key the caller\n  // never chose. Refuse instead.\n  if (!apiKey || !apiSecret) {\n    throw new VoiceError(\"missing_credentials\", \"apiKey and apiSecret are required\");\n  }\n}\n\n/** Sign a microphone-only ticket for one room. Check the person's access BEFORE calling this. */\nexport async function createRoomToken(opts: RoomTokenOptions): Promise<string> {\n  requireCredentials(opts);\n  if (!opts.room?.trim()) throw new VoiceError(\"invalid_room\", \"room is required\");\n  if (!opts.identity?.trim()) throw new VoiceError(\"invalid_identity\", \"identity is required\");\n  const ttl = opts.ttl ?? DEFAULT_TTL_SECONDS;\n  if (!Number.isInteger(ttl) || ttl <= 0 || ttl > MAX_TTL_SECONDS) {\n    throw new VoiceError(\"invalid_ttl\", `ttl must be a whole number of seconds between 1 and ${MAX_TTL_SECONDS}`);\n  }\n\n  const token = new AccessToken(opts.apiKey, opts.apiSecret, { identity: opts.identity, name: opts.name, ttl });\n  const speak = opts.canPublish !== false;\n  token.addGrant({\n    room: opts.room,\n    roomJoin: true,\n    canSubscribe: true,\n    canPublish: speak,\n    ...(speak ? { canPublishSources: [TrackSource.MICROPHONE] } : {}),\n    canPublishData: false,\n  });\n  return token.toJwt();\n}\n\n/**\n * Verify a webhook from the media server and return its event.\n * `body` must be the RAW request body — re-serialised JSON changes the hash.\n */\nexport async function verifyWebhook(\n  body: string,\n  authHeader: string | null | undefined,\n  credentials: Credentials,\n): Promise<WebhookEvent> {\n  requireCredentials(credentials);\n  try {\n    // A missing header is refused by LiveKit itself (\"authorization header is empty\").\n    return await new WebhookReceiver(credentials.apiKey, credentials.apiSecret).receive(body, authHeader ?? undefined);\n  } catch (e) {\n    throw new VoiceError(\"invalid_webhook\", `webhook rejected: ${(e as Error).message}`);\n  }\n}\n"]}
+{"version":3,"sources":["../src/server.ts"],"names":[],"mappings":"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","file":"server.js","sourcesContent":["// @broberg/call/server — the app's half of a call (F104.3; video and screen share F104.7).\n//\n// The app never carries audio. It decides who may enter a room, signs a short\n// ticket for that one room, and hears from the media server (LiveKit) through a\n// signed webhook when people join and leave. Built on LiveKit's own SDK so the\n// ticket format and the webhook signature are LiveKit's, not ours.\n\nimport { AccessToken, TrackSource, WebhookReceiver } from \"livekit-server-sdk\";\nimport type { WebhookEvent } from \"livekit-server-sdk\";\n\nexport type { WebhookEvent };\n\nexport type VoiceErrorCode =\n  | \"missing_credentials\"\n  | \"invalid_room\"\n  | \"invalid_identity\"\n  | \"invalid_ttl\"\n  | \"invalid_sources\"\n  | \"invalid_webhook\";\n\nexport class VoiceError extends Error {\n  constructor(\n    readonly code: VoiceErrorCode,\n    message: string,\n  ) {\n    super(message);\n    this.name = \"VoiceError\";\n  }\n}\n\nexport interface Credentials {\n  apiKey: string;\n  apiSecret: string;\n}\n\nexport interface RoomTokenOptions extends Credentials {\n  /** One room, e.g. `jam:<jam-id>`. The ticket admits to this room only. */\n  room: string;\n  /** Stable id of the person — the same person joining twice replaces the first connection. */\n  identity: string;\n  /** Display name other participants see. */\n  name?: string;\n  /** Seconds the ticket can be used to ENTER. Default 600, max 3600. A call in progress is not cut off when it expires. */\n  ttl?: number;\n  /**\n   * F104.4 — `false` makes a LISTEN-ONLY ticket: the person can join and hear\n   * everyone but publish nothing (no microphone, no data). Default `true`.\n   * Pair it with `joinVoice({ publish: false })` in the browser.\n   */\n  canPublish?: boolean;\n  /**\n   * F104.7 — what the person may send. Default `[\"microphone\"]`, so an app that\n   * never asks for video still mints a sound-only ticket. Add `\"camera\"`,\n   * `\"screen_share\"` and/or `\"screen_share_audio\"` (the sound of a shared tab).\n   * Refused together with `canPublish: false` — a listener sends nothing.\n   */\n  sources?: CallSource[];\n}\n\n/** F104.7 — the kinds of media a ticket may allow a person to send. */\nexport type CallSource = \"microphone\" | \"camera\" | \"screen_share\" | \"screen_share_audio\";\n\nconst SOURCE_TO_LIVEKIT: Record<CallSource, TrackSource> = {\n  microphone: TrackSource.MICROPHONE,\n  camera: TrackSource.CAMERA,\n  screen_share: TrackSource.SCREEN_SHARE,\n  screen_share_audio: TrackSource.SCREEN_SHARE_AUDIO,\n};\n\nexport const DEFAULT_TTL_SECONDS = 600;\nexport const MAX_TTL_SECONDS = 3600;\n\nfunction requireCredentials({ apiKey, apiSecret }: Partial<Credentials>): void {\n  // LiveKit's AccessToken falls back to LIVEKIT_API_KEY/SECRET from the\n  // environment when these are missing — a ticket signed with a key the caller\n  // never chose. Refuse instead.\n  if (!apiKey || !apiSecret) {\n    throw new VoiceError(\"missing_credentials\", \"apiKey and apiSecret are required\");\n  }\n}\n\n/**\n * Sign a ticket for one room — microphone only unless `sources` says more.\n * Check the person's access BEFORE calling this.\n */\nexport async function createRoomToken(opts: RoomTokenOptions): Promise<string> {\n  requireCredentials(opts);\n  if (!opts.room?.trim()) throw new VoiceError(\"invalid_room\", \"room is required\");\n  if (!opts.identity?.trim()) throw new VoiceError(\"invalid_identity\", \"identity is required\");\n  const ttl = opts.ttl ?? DEFAULT_TTL_SECONDS;\n  if (!Number.isInteger(ttl) || ttl <= 0 || ttl > MAX_TTL_SECONDS) {\n    throw new VoiceError(\"invalid_ttl\", `ttl must be a whole number of seconds between 1 and ${MAX_TTL_SECONDS}`);\n  }\n\n  const speak = opts.canPublish !== false;\n  const sources = resolveSources(opts.sources, speak);\n\n  const token = new AccessToken(opts.apiKey, opts.apiSecret, { identity: opts.identity, name: opts.name, ttl });\n  token.addGrant({\n    room: opts.room,\n    roomJoin: true,\n    canSubscribe: true,\n    canPublish: speak,\n    ...(speak ? { canPublishSources: sources.map((src) => SOURCE_TO_LIVEKIT[src]) } : {}),\n    canPublishData: false,\n  });\n  return token.toJwt();\n}\n\nfunction resolveSources(sources: CallSource[] | undefined, speak: boolean): CallSource[] {\n  if (sources === undefined) return [\"microphone\"];\n  if (!speak) throw new VoiceError(\"invalid_sources\", \"sources cannot be given with canPublish: false — a listener sends nothing\");\n  if (!Array.isArray(sources) || sources.length === 0) {\n    throw new VoiceError(\"invalid_sources\", \"sources must name at least one of microphone, camera, screen_share, screen_share_audio\");\n  }\n  const unknown = sources.filter((src) => !Object.hasOwn(SOURCE_TO_LIVEKIT, src));\n  if (unknown.length) throw new VoiceError(\"invalid_sources\", `unknown source(s): ${unknown.join(\", \")}`);\n  return [...new Set(sources)];\n}\n\n/**\n * Verify a webhook from the media server and return its event.\n * `body` must be the RAW request body — re-serialised JSON changes the hash.\n */\nexport async function verifyWebhook(\n  body: string,\n  authHeader: string | null | undefined,\n  credentials: Credentials,\n): Promise<WebhookEvent> {\n  requireCredentials(credentials);\n  try {\n    // A missing header is refused by LiveKit itself (\"authorization header is empty\").\n    return await new WebhookReceiver(credentials.apiKey, credentials.apiSecret).receive(body, authHeader ?? undefined);\n  } catch (e) {\n    throw new VoiceError(\"invalid_webhook\", `webhook rejected: ${(e as Error).message}`);\n  }\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@broberg/call",
-  "version": "0.1.0",
-  "description": "Calls (audio today; video + screen share next) for 2–10 people on a self-hosted LiveKit SFU: the app's server mints a short-lived, room-bound, microphone-only ticket and verifies LiveKit's signed webhooks; the browser joins with noise suppression, echo cancellation and auto gain, and gets mute, output mute, device choice, per-person volume, who-is-speaking and the participant list.",
+  "version": "0.2.0",
+  "description": "Calls for 2–10 people on a self-hosted LiveKit SFU in the EU — audio, camera and screen share: the app's server mints a short-lived, room-bound ticket that allows exactly the sources it names (microphone only by default) and verifies LiveKit's signed webhooks; the browser joins with noise suppression, echo cancellation and auto gain, and gets mute, devices, per-person volume, who-is-speaking, the participant list, camera and screen share on/off (incl. the browser's own stop button), every video picture to attach, and an audio-only mode — with simulcast, adaptive stream and dynacast.",
   "type": "module",
   "license": "MIT",
   "sideEffects": false,