@craftedxp/voice-js 0.6.0 → 0.10.0

package/dist/room.d.ts

@@ -0,0 +1,156 @@
+import { RemoteTrack, LocalVideoTrack } from 'livekit-client';
+
+type SystemMessage = {
+    kind: 'room.starting';
+    at: string;
+} | {
+    kind: 'room.ending.soon';
+    minutesRemaining: 5 | 1;
+} | {
+    kind: 'room.ended';
+    reason: 'duration_reached' | 'manual' | 'empty';
+} | {
+    kind: 'role.promoted';
+    participantId: string;
+    name: string;
+} | {
+    kind: 'role.demoted';
+    participantId: string;
+    name: string;
+} | {
+    kind: 'participant.removed';
+    participantId: string;
+    name: string;
+    byHost?: string;
+} | {
+    kind: 'notetaker.connected';
+} | {
+    kind: 'notetaker.disconnected';
+} | {
+    kind: 'notetaker.partial_degraded';
+    participantId: string;
+};
+type TranscriptMessage = {
+    kind: 'partial';
+    participantId: string;
+    speakerName: string;
+    text: string;
+    startedAt: string;
+};
+type AnalysisMessage = {
+    kind: 'analysis';
+    participantId: string;
+    label: string;
+    score?: number;
+    note?: string;
+    producer?: string;
+};
+
+interface JoinRoomOptions {
+    /** Full HTTPS URL of the Voissia server. Same shape as VoiceClientConfig.apiBase. */
+    apiBase: string;
+    /** Server-generated room id (`rm_…`). */
+    roomId: string;
+    /** Shared room join token from the invite link. Mints a fresh participant each call. */
+    joinCode: string;
+    /** Display name the joiner registers under for this participant. */
+    name: string;
+}
+interface RoomParticipantInfo {
+    /** Stable participant id (`p_…`); strips any `guest:` LiveKit identity prefix. */
+    participantId: string;
+    /** Display name as the worker registered it; may be empty. */
+    name: string;
+}
+type RoomTrackKind = 'audio' | 'video';
+/** What a track is — lets consumers tell a camera apart from a screen share
+ *  (a participant can publish both at once). Mirrors livekit `Track.Source`. */
+type RoomTrackSource = 'camera' | 'microphone' | 'screen_share' | 'screen_share_audio' | 'unknown';
+interface RoomTrackEvent {
+    /** Stable participant id (`p_…`); `guest:` prefix stripped. */
+    participantId: string;
+    kind: RoomTrackKind;
+    /** Distinguishes camera vs screen_share so each can render as its own tile. */
+    source: RoomTrackSource;
+    /** livekit-client track — call `.attach(el)` / `.detach()` to render. */
+    track: RemoteTrack;
+}
+type RoomEventName = 'participant.joined' | 'participant.left' | 'transcript.partial' | 'transcript.final' | 'system.message' | 'room.ended' | 'track.subscribed' | 'track.unsubscribed' | 'active.speakers' | 'analysis';
+interface RoomEventPayloads {
+    'participant.joined': RoomParticipantInfo;
+    'participant.left': RoomParticipantInfo;
+    'transcript.partial': TranscriptMessage;
+    /**
+     * Reserved — the worker currently emits only partials over the transcript
+     * topic. Final-utterance events will land in Phase 8 once the worker
+     * publishes a `final` kind; the SDK keeps the slot reserved so consumers
+     * can register handlers today.
+     */
+    'transcript.final': {
+        participantId: string;
+        speakerName: string;
+        text: string;
+        startedAt: string;
+    };
+    'system.message': SystemMessage;
+    'room.ended': undefined;
+    'track.subscribed': RoomTrackEvent;
+    'track.unsubscribed': RoomTrackEvent;
+    /** participantIds currently speaking (drives an active-speaker UI). */
+    'active.speakers': string[];
+    /** Live analysis result (e.g. hirability). Delivered only to host
+     *  participants by the worker; non-host participants never receive it. */
+    analysis: AnalysisMessage;
+}
+type Handler<E extends RoomEventName> = (payload: RoomEventPayloads[E]) => void;
+interface RoomSession {
+    /** This session's own stable participant id (`p_…`). Useful to filter
+     *  yourself out of `active.speakers`, which includes the local participant. */
+    readonly participantId: string;
+    /** Room kind from the join exchange. 'audio' rooms are voice-only. */
+    readonly kind: 'audio' | 'video';
+    /** Snapshot of the remote participants currently connected. */
+    readonly participants: RoomParticipantInfo[];
+    /** Subscribe to a typed event. No unsubscribe surface yet (mirrors `Call.onX`). */
+    on<E extends RoomEventName>(event: E, handler: Handler<E>): void;
+    /** Publish the local mic track. Resolves once the track is live on LiveKit. */
+    publishMic(): Promise<void>;
+    /** Publish the local camera track. */
+    publishCamera(): Promise<void>;
+    /** Mid-call mute/unmute of the local mic. */
+    setMicEnabled(on: boolean): Promise<void>;
+    /** Mid-call camera on/off. */
+    setCameraEnabled(on: boolean): Promise<void>;
+    /** Current local mic state (for toggle UI). */
+    isMicEnabled(): boolean;
+    /** Current local camera state (for toggle UI). */
+    isCameraEnabled(): boolean;
+    /** The local camera track for self-view, or null before publishCamera resolves. */
+    getLocalCameraTrack(): LocalVideoTrack | null;
+    /**
+     * Remote tracks already subscribed at this moment. A late joiner misses the
+     * live `track.subscribed` events for tracks published before it connected
+     * (LiveKit delivers them during `connect`, before consumer listeners attach).
+     * Call this right after registering `track.subscribed` to backfill them.
+     */
+    getRemoteTracks(): RoomTrackEvent[];
+    /**
+     * Start/stop sharing the screen (via `getDisplayMedia`). Pass `{ audio: true }`
+     * to also capture shared/system audio where the browser allows it (Chrome:
+     * tab or system audio; macOS Chrome is tab-audio only; Safari/Firefox don't
+     * capture share audio). Publishes a `screen_share` video track (+ optional
+     * `screen_share_audio`); remote peers receive them via `track.subscribed`.
+     */
+    setScreenShareEnabled(on: boolean, opts?: {
+        audio?: boolean;
+    }): Promise<void>;
+    /** Current local screen-share state (for toggle UI). */
+    isScreenShareEnabled(): boolean;
+    /** The local screen-share video track for self-preview, or null when off. */
+    getLocalScreenTrack(): LocalVideoTrack | null;
+    /** Disconnect from LiveKit. Idempotent. Triggers `room.ended` via Disconnected. */
+    leave(): Promise<void>;
+}
+declare const joinRoom: (opts: JoinRoomOptions) => Promise<RoomSession>;
+
+export { type AnalysisMessage, type JoinRoomOptions, type RoomEventName, type RoomEventPayloads, type RoomParticipantInfo, type RoomSession, type SystemMessage, type TranscriptMessage, joinRoom };

package/dist/room.js

@@ -0,0 +1,236 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/roomEntry.ts
+var roomEntry_exports = {};
+__export(roomEntry_exports, {
+  joinRoom: () => joinRoom
+});
+module.exports = __toCommonJS(roomEntry_exports);
+
+// src/roomProtocol.ts
+var SYSTEM_TOPIC = "system";
+var TRANSCRIPT_TOPIC = "transcript";
+var ANALYSIS_TOPIC = "analysis";
+var decodeSystem = (bytes) => {
+  try {
+    const v = JSON.parse(new TextDecoder().decode(bytes));
+    if (v && typeof v.kind === "string") return v;
+    return null;
+  } catch {
+    return null;
+  }
+};
+var decodeTranscript = (bytes) => {
+  try {
+    const v = JSON.parse(new TextDecoder().decode(bytes));
+    if (v && v.kind === "partial") return v;
+    return null;
+  } catch {
+    return null;
+  }
+};
+var decodeAnalysis = (bytes) => {
+  try {
+    const v = JSON.parse(new TextDecoder().decode(bytes));
+    if (v && v.kind === "analysis" && typeof v.participantId === "string" && typeof v.label === "string") {
+      return v;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+};
+
+// src/room.ts
+var lkPromise;
+var loadLiveKit = () => {
+  lkPromise ?? (lkPromise = import("livekit-client").catch((e) => {
+    lkPromise = void 0;
+    const msg = "joinRoom requires the optional peer dependency 'livekit-client' \u2014 npm install livekit-client";
+    const wrapped = new Error(msg);
+    wrapped.cause = e;
+    throw wrapped;
+  }));
+  return lkPromise;
+};
+var identityToPid = (identity) => identity.startsWith("guest:") ? identity.slice("guest:".length) : identity;
+var joinRoom = async (opts) => {
+  const exchangeUrl = `${opts.apiBase.replace(/\/+$/, "")}/v1/rooms/${encodeURIComponent(
+    opts.roomId
+  )}/join`;
+  const exchangeRes = await fetch(exchangeUrl, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ code: opts.joinCode, name: opts.name })
+  });
+  if (!exchangeRes.ok) {
+    const err = await exchangeRes.json().catch(() => ({}));
+    throw new Error(err.error?.code ?? `join_failed_${exchangeRes.status}`);
+  }
+  const exchange = await exchangeRes.json();
+  const handlers = /* @__PURE__ */ new Map();
+  const emit = (e, payload) => {
+    handlers.get(e)?.forEach((h) => {
+      try {
+        h(payload);
+      } catch {
+      }
+    });
+  };
+  const lk = await loadLiveKit();
+  const trackKind = (t) => t.kind === lk.Track.Kind.Video ? "video" : "audio";
+  const trackSource = (s) => {
+    switch (s) {
+      case lk.Track.Source.Camera:
+        return "camera";
+      case lk.Track.Source.Microphone:
+        return "microphone";
+      case lk.Track.Source.ScreenShare:
+        return "screen_share";
+      case lk.Track.Source.ScreenShareAudio:
+        return "screen_share_audio";
+      default:
+        return "unknown";
+    }
+  };
+  const room = new lk.Room({ adaptiveStream: true, dynacast: true });
+  room.on(
+    lk.RoomEvent.ParticipantConnected,
+    (p) => emit("participant.joined", {
+      participantId: identityToPid(p.identity),
+      name: p.name ?? ""
+    })
+  );
+  room.on(
+    lk.RoomEvent.ParticipantDisconnected,
+    (p) => emit("participant.left", {
+      participantId: identityToPid(p.identity),
+      name: p.name ?? ""
+    })
+  );
+  room.on(lk.RoomEvent.Disconnected, () => emit("room.ended", void 0));
+  room.on(lk.RoomEvent.DataReceived, (data, _participant, _kind, topic) => {
+    if (topic === SYSTEM_TOPIC) {
+      const m = decodeSystem(data);
+      if (m) emit("system.message", m);
+    } else if (topic === TRANSCRIPT_TOPIC) {
+      const m = decodeTranscript(data);
+      if (m) emit("transcript.partial", m);
+    } else if (topic === ANALYSIS_TOPIC) {
+      const m = decodeAnalysis(data);
+      if (m) emit("analysis", m);
+    }
+  });
+  room.on(
+    lk.RoomEvent.TrackSubscribed,
+    (track, pub, participant) => emit("track.subscribed", {
+      participantId: identityToPid(participant.identity),
+      kind: trackKind(track),
+      source: trackSource(pub.source),
+      track
+    })
+  );
+  room.on(
+    lk.RoomEvent.TrackUnsubscribed,
+    (track, pub, participant) => emit("track.unsubscribed", {
+      participantId: identityToPid(participant.identity),
+      kind: trackKind(track),
+      source: trackSource(pub.source),
+      track
+    })
+  );
+  room.on(
+    lk.RoomEvent.ActiveSpeakersChanged,
+    (speakers) => emit(
+      "active.speakers",
+      speakers.map((p) => identityToPid(p.identity))
+    )
+  );
+  await room.connect(exchange.livekit.url, exchange.livekit.token);
+  return {
+    participantId: exchange.participantId,
+    kind: exchange.kind ?? "video",
+    get participants() {
+      return [...room.remoteParticipants.values()].map((p) => ({
+        participantId: identityToPid(p.identity),
+        name: p.name ?? ""
+      }));
+    },
+    on(event, handler) {
+      const set = handlers.get(event) ?? /* @__PURE__ */ new Set();
+      set.add(handler);
+      handlers.set(event, set);
+    },
+    publishMic: async () => {
+      await room.localParticipant.setMicrophoneEnabled(true);
+    },
+    publishCamera: async () => {
+      await room.localParticipant.setCameraEnabled(true);
+    },
+    setMicEnabled: async (on) => {
+      await room.localParticipant.setMicrophoneEnabled(on);
+    },
+    setCameraEnabled: async (on) => {
+      await room.localParticipant.setCameraEnabled(on);
+    },
+    isMicEnabled: () => room.localParticipant.isMicrophoneEnabled,
+    isCameraEnabled: () => room.localParticipant.isCameraEnabled,
+    getLocalCameraTrack: () => room.localParticipant.getTrackPublication(lk.Track.Source.Camera)?.videoTrack ?? null,
+    getRemoteTracks: () => {
+      const out = [];
+      for (const p of room.remoteParticipants.values()) {
+        for (const pub of p.trackPublications.values()) {
+          const track = pub.track;
+          if (!track) continue;
+          out.push({
+            participantId: identityToPid(p.identity),
+            kind: trackKind(track),
+            source: trackSource(pub.source),
+            track
+          });
+        }
+      }
+      return out;
+    },
+    setScreenShareEnabled: async (on, opts2) => {
+      await room.localParticipant.setScreenShareEnabled(on, { audio: opts2?.audio ?? false });
+    },
+    isScreenShareEnabled: () => room.localParticipant.isScreenShareEnabled,
+    getLocalScreenTrack: () => room.localParticipant.getTrackPublication(lk.Track.Source.ScreenShare)?.videoTrack ?? null,
+    leave: async () => {
+      await room.disconnect();
+    }
+  };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  joinRoom
+});
+//# sourceMappingURL=room.js.map

package/dist/room.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/roomEntry.ts","../src/roomProtocol.ts","../src/room.ts"],"sourcesContent":["// Room entry — `import { joinRoom } from '@craftedxp/voice-js/room'`.\n// The only entry that touches livekit-client (lazy, optional peer).\nexport { joinRoom } from './room'\nexport type {\n  JoinRoomOptions,\n  RoomEventName,\n  RoomEventPayloads,\n  RoomParticipantInfo,\n  RoomSession,\n} from './room'\nexport type { SystemMessage, TranscriptMessage, AnalysisMessage } from './roomProtocol'\n","// DO NOT EDIT — single source of truth is server/src/room/protocol.ts.\n// Re-vendor (byte-for-byte copy) when the upstream changes.\n//\n// Why vendored: when this package is published to npm, its build artifacts\n// (`dist/`) cannot reach across to `server/src/room/protocol.ts`. Importing\n// via a cross-package relative path resolves at compile time but breaks at\n// consumer install time. Followup: extract to `@craftedxp/room-protocol`\n// and depend on it from both server and SDK so drift is impossible.\n\n// server/src/room/protocol.ts\n//\n// Wire format for LiveKit data-message topics \"system\", \"transcript\", and \"analysis\".\n// Worker publishes; SDK consumes. Single source of truth — do not duplicate\n// in the SDK package.\n\nexport const SYSTEM_TOPIC = 'system'\nexport const TRANSCRIPT_TOPIC = 'transcript'\nexport const ANALYSIS_TOPIC = 'analysis'\n\nexport type SystemMessage =\n  | { kind: 'room.starting'; at: string }\n  | { kind: 'room.ending.soon'; minutesRemaining: 5 | 1 }\n  | { kind: 'room.ended'; reason: 'duration_reached' | 'manual' | 'empty' }\n  | { kind: 'role.promoted'; participantId: string; name: string }\n  | { kind: 'role.demoted'; participantId: string; name: string }\n  | { kind: 'participant.removed'; participantId: string; name: string; byHost?: string }\n  | { kind: 'notetaker.connected' }\n  | { kind: 'notetaker.disconnected' }\n  | { kind: 'notetaker.partial_degraded'; participantId: string }\n\nexport type TranscriptMessage = {\n  kind: 'partial'\n  participantId: string\n  speakerName: string\n  text: string\n  startedAt: string\n}\n\n// Reserved for future live per-utterance analysis (e.g. interview \"technical\n// depth\" gauge). No worker publishes this today — clients may subscribe\n// defensively. See docs/superpowers/specs/2026-06-02-audio-call-rooms-design.md.\nexport type AnalysisMessage = {\n  kind: 'analysis'\n  participantId: string\n  label: string\n  score?: number\n  note?: string\n  producer?: string\n}\n\nexport const encode = <T>(msg: T): Uint8Array => new TextEncoder().encode(JSON.stringify(msg))\n\nexport const decodeSystem = (bytes: Uint8Array): SystemMessage | null => {\n  try {\n    const v = JSON.parse(new TextDecoder().decode(bytes))\n    if (v && typeof v.kind === 'string') return v as SystemMessage\n    return null\n  } catch {\n    return null\n  }\n}\n\nexport const decodeTranscript = (bytes: Uint8Array): TranscriptMessage | null => {\n  try {\n    const v = JSON.parse(new TextDecoder().decode(bytes))\n    if (v && v.kind === 'partial') return v as TranscriptMessage\n    return null\n  } catch {\n    return null\n  }\n}\n\nexport const decodeAnalysis = (bytes: Uint8Array): AnalysisMessage | null => {\n  try {\n    const v = JSON.parse(new TextDecoder().decode(bytes))\n    if (\n      v &&\n      v.kind === 'analysis' &&\n      typeof v.participantId === 'string' &&\n      typeof v.label === 'string'\n    ) {\n      return v as AnalysisMessage\n    }\n    return null\n  } catch {\n    return null\n  }\n}\n","// Multi-party room support: exchange a joinCode for a LiveKit JWT, connect,\n// expose typed events.\n//\n// Auth flow (mirrors server/src/routes/v1/roomsJoinRoutes.ts):\n//   POST {apiBase}/v1/rooms/:roomId/join  { code, name }\n//     → { roomId, participantId, name, role, livekit: { url, token, identity } }\n//   The endpoint is AUTH-EXEMPT — the shared joinCode is the only credential.\n//   It mints a FRESH participant each call (shared-room-link join model).\n//\n// Once the JWT is in hand, we hand it to livekit-client's `Room` and surface\n// a small typed event surface on top: participant.{joined,left},\n// transcript.{partial,final}, system.message, room.ended.\n//\n// Wire format for the system / transcript data-messages lives in\n// `./roomProtocol` (vendored copy of server/src/room/protocol.ts — see\n// the header note there).\n\nimport type {\n  Track,\n  RemoteParticipant,\n  RemoteTrack,\n  RemoteTrackPublication,\n  LocalVideoTrack,\n  Participant,\n} from 'livekit-client'\n\n// livekit-client is an OPTIONAL peer dependency — loaded on first joinRoom()\n// so assistant/transcribe consumers (and the deprecated root barrel) never\n// pull it into their module graph or bundle.\ntype LiveKit = typeof import('livekit-client')\nlet lkPromise: Promise<LiveKit> | undefined\nconst loadLiveKit = (): Promise<LiveKit> => {\n  lkPromise ??= import('livekit-client').catch((e: unknown) => {\n    lkPromise = undefined\n    const msg =\n      \"joinRoom requires the optional peer dependency 'livekit-client' — npm install livekit-client\"\n    const wrapped = new Error(msg)\n    ;(wrapped as Error & { cause?: unknown }).cause = e\n    throw wrapped\n  })\n  return lkPromise\n}\n\nimport {\n  decodeSystem,\n  decodeTranscript,\n  decodeAnalysis,\n  SYSTEM_TOPIC,\n  TRANSCRIPT_TOPIC,\n  ANALYSIS_TOPIC,\n  type SystemMessage,\n  type TranscriptMessage,\n  type AnalysisMessage,\n} from './roomProtocol'\n\nexport interface JoinRoomOptions {\n  /** Full HTTPS URL of the Voissia server. Same shape as VoiceClientConfig.apiBase. */\n  apiBase: string\n  /** Server-generated room id (`rm_…`). */\n  roomId: string\n  /** Shared room join token from the invite link. Mints a fresh participant each call. */\n  joinCode: string\n  /** Display name the joiner registers under for this participant. */\n  name: string\n}\n\nexport interface RoomParticipantInfo {\n  /** Stable participant id (`p_…`); strips any `guest:` LiveKit identity prefix. */\n  participantId: string\n  /** Display name as the worker registered it; may be empty. */\n  name: string\n}\n\nexport type RoomTrackKind = 'audio' | 'video'\n\n/** What a track is — lets consumers tell a camera apart from a screen share\n *  (a participant can publish both at once). Mirrors livekit `Track.Source`. */\nexport type RoomTrackSource =\n  | 'camera'\n  | 'microphone'\n  | 'screen_share'\n  | 'screen_share_audio'\n  | 'unknown'\n\nexport interface RoomTrackEvent {\n  /** Stable participant id (`p_…`); `guest:` prefix stripped. */\n  participantId: string\n  kind: RoomTrackKind\n  /** Distinguishes camera vs screen_share so each can render as its own tile. */\n  source: RoomTrackSource\n  /** livekit-client track — call `.attach(el)` / `.detach()` to render. */\n  track: RemoteTrack\n}\n\nexport type RoomEventName =\n  | 'participant.joined'\n  | 'participant.left'\n  | 'transcript.partial'\n  | 'transcript.final'\n  | 'system.message'\n  | 'room.ended'\n  | 'track.subscribed'\n  | 'track.unsubscribed'\n  | 'active.speakers'\n  | 'analysis'\n\nexport interface RoomEventPayloads {\n  'participant.joined': RoomParticipantInfo\n  'participant.left': RoomParticipantInfo\n  'transcript.partial': TranscriptMessage\n  /**\n   * Reserved — the worker currently emits only partials over the transcript\n   * topic. Final-utterance events will land in Phase 8 once the worker\n   * publishes a `final` kind; the SDK keeps the slot reserved so consumers\n   * can register handlers today.\n   */\n  'transcript.final': {\n    participantId: string\n    speakerName: string\n    text: string\n    startedAt: string\n  }\n  'system.message': SystemMessage\n  'room.ended': undefined\n  'track.subscribed': RoomTrackEvent\n  'track.unsubscribed': RoomTrackEvent\n  /** participantIds currently speaking (drives an active-speaker UI). */\n  'active.speakers': string[]\n  /** Live analysis result (e.g. hirability). Delivered only to host\n   *  participants by the worker; non-host participants never receive it. */\n  analysis: AnalysisMessage\n}\n\ntype Handler<E extends RoomEventName> = (payload: RoomEventPayloads[E]) => void\n\nexport interface RoomSession {\n  /** This session's own stable participant id (`p_…`). Useful to filter\n   *  yourself out of `active.speakers`, which includes the local participant. */\n  readonly participantId: string\n  /** Room kind from the join exchange. 'audio' rooms are voice-only. */\n  readonly kind: 'audio' | 'video'\n  /** Snapshot of the remote participants currently connected. */\n  readonly participants: RoomParticipantInfo[]\n  /** Subscribe to a typed event. No unsubscribe surface yet (mirrors `Call.onX`). */\n  on<E extends RoomEventName>(event: E, handler: Handler<E>): void\n  /** Publish the local mic track. Resolves once the track is live on LiveKit. */\n  publishMic(): Promise<void>\n  /** Publish the local camera track. */\n  publishCamera(): Promise<void>\n  /** Mid-call mute/unmute of the local mic. */\n  setMicEnabled(on: boolean): Promise<void>\n  /** Mid-call camera on/off. */\n  setCameraEnabled(on: boolean): Promise<void>\n  /** Current local mic state (for toggle UI). */\n  isMicEnabled(): boolean\n  /** Current local camera state (for toggle UI). */\n  isCameraEnabled(): boolean\n  /** The local camera track for self-view, or null before publishCamera resolves. */\n  getLocalCameraTrack(): LocalVideoTrack | null\n  /**\n   * Remote tracks already subscribed at this moment. A late joiner misses the\n   * live `track.subscribed` events for tracks published before it connected\n   * (LiveKit delivers them during `connect`, before consumer listeners attach).\n   * Call this right after registering `track.subscribed` to backfill them.\n   */\n  getRemoteTracks(): RoomTrackEvent[]\n  /**\n   * Start/stop sharing the screen (via `getDisplayMedia`). Pass `{ audio: true }`\n   * to also capture shared/system audio where the browser allows it (Chrome:\n   * tab or system audio; macOS Chrome is tab-audio only; Safari/Firefox don't\n   * capture share audio). Publishes a `screen_share` video track (+ optional\n   * `screen_share_audio`); remote peers receive them via `track.subscribed`.\n   */\n  setScreenShareEnabled(on: boolean, opts?: { audio?: boolean }): Promise<void>\n  /** Current local screen-share state (for toggle UI). */\n  isScreenShareEnabled(): boolean\n  /** The local screen-share video track for self-preview, or null when off. */\n  getLocalScreenTrack(): LocalVideoTrack | null\n  /** Disconnect from LiveKit. Idempotent. Triggers `room.ended` via Disconnected. */\n  leave(): Promise<void>\n}\n\n/**\n * LiveKit identities are minted as `guest:p_xxx` by the server-side\n * RoomService. SDK consumers only care about the stable `p_xxx` half.\n */\nconst identityToPid = (identity: string): string =>\n  identity.startsWith('guest:') ? identity.slice('guest:'.length) : identity\n\ninterface JoinExchangeResponse {\n  roomId: string\n  participantId: string\n  name: string\n  role: 'host' | 'guest' | 'observer' | 'notetaker'\n  kind?: 'audio' | 'video'\n  livekit: {\n    url: string\n    token: string\n    identity: string\n  }\n}\n\nexport const joinRoom = async (opts: JoinRoomOptions): Promise<RoomSession> => {\n  // 1. Exchange the join code for a LiveKit JWT.\n  const exchangeUrl = `${opts.apiBase.replace(/\\/+$/, '')}/v1/rooms/${encodeURIComponent(\n    opts.roomId,\n  )}/join`\n\n  const exchangeRes = await fetch(exchangeUrl, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify({ code: opts.joinCode, name: opts.name }),\n  })\n\n  if (!exchangeRes.ok) {\n    const err = (await exchangeRes.json().catch(() => ({}))) as {\n      error?: { code?: string; message?: string }\n    }\n    throw new Error(err.error?.code ?? `join_failed_${exchangeRes.status}`)\n  }\n\n  const exchange = (await exchangeRes.json()) as JoinExchangeResponse\n\n  // 2. Build the typed event surface (simple Map<event, Set<handler>>).\n  const handlers = new Map<RoomEventName, Set<(p: unknown) => void>>()\n  const emit = <E extends RoomEventName>(e: E, payload: RoomEventPayloads[E]) => {\n    handlers.get(e)?.forEach((h) => {\n      try {\n        h(payload)\n      } catch {\n        // Swallow handler errors — one bad subscriber shouldn't take down\n        // the rest. Consumers are expected to handle their own throws.\n      }\n    })\n  }\n\n  // 3. Lazy-load livekit-client (optional peer dep) then connect.\n  const lk = await loadLiveKit()\n\n  const trackKind = (t: RemoteTrack): RoomTrackKind =>\n    t.kind === lk.Track.Kind.Video ? 'video' : 'audio'\n\n  const trackSource = (s: Track.Source): RoomTrackSource => {\n    switch (s) {\n      case lk.Track.Source.Camera:\n        return 'camera'\n      case lk.Track.Source.Microphone:\n        return 'microphone'\n      case lk.Track.Source.ScreenShare:\n        return 'screen_share'\n      case lk.Track.Source.ScreenShareAudio:\n        return 'screen_share_audio'\n      default:\n        return 'unknown'\n    }\n  }\n\n  // adaptiveStream + dynacast are the recommended defaults for multi-party video.\n  const room = new lk.Room({ adaptiveStream: true, dynacast: true })\n\n  room.on(lk.RoomEvent.ParticipantConnected, (p: RemoteParticipant) =>\n    emit('participant.joined', {\n      participantId: identityToPid(p.identity),\n      name: p.name ?? '',\n    }),\n  )\n\n  room.on(lk.RoomEvent.ParticipantDisconnected, (p: RemoteParticipant) =>\n    emit('participant.left', {\n      participantId: identityToPid(p.identity),\n      name: p.name ?? '',\n    }),\n  )\n\n  room.on(lk.RoomEvent.Disconnected, () => emit('room.ended', undefined))\n\n  // DataReceived signature in livekit-client@2.x:\n  //   (payload: Uint8Array, participant?: RemoteParticipant,\n  //    kind?: DataPacket_Kind, topic?: string, encryptionType?: Encryption_Type) => void\n  // We only key off `topic` and `payload`.\n  room.on(lk.RoomEvent.DataReceived, (data: Uint8Array, _participant, _kind, topic?: string) => {\n    if (topic === SYSTEM_TOPIC) {\n      const m = decodeSystem(data)\n      if (m) emit('system.message', m)\n    } else if (topic === TRANSCRIPT_TOPIC) {\n      const m = decodeTranscript(data)\n      if (m) emit('transcript.partial', m)\n    } else if (topic === ANALYSIS_TOPIC) {\n      const m = decodeAnalysis(data)\n      if (m) emit('analysis', m)\n    }\n  })\n\n  room.on(\n    lk.RoomEvent.TrackSubscribed,\n    (track: RemoteTrack, pub: RemoteTrackPublication, participant: RemoteParticipant) =>\n      emit('track.subscribed', {\n        participantId: identityToPid(participant.identity),\n        kind: trackKind(track),\n        source: trackSource(pub.source),\n        track,\n      }),\n  )\n\n  room.on(\n    lk.RoomEvent.TrackUnsubscribed,\n    (track: RemoteTrack, pub: RemoteTrackPublication, participant: RemoteParticipant) =>\n      emit('track.unsubscribed', {\n        participantId: identityToPid(participant.identity),\n        kind: trackKind(track),\n        source: trackSource(pub.source),\n        track,\n      }),\n  )\n\n  room.on(lk.RoomEvent.ActiveSpeakersChanged, (speakers: Participant[]) =>\n    emit(\n      'active.speakers',\n      speakers.map((p) => identityToPid(p.identity)),\n    ),\n  )\n\n  await room.connect(exchange.livekit.url, exchange.livekit.token)\n\n  return {\n    participantId: exchange.participantId,\n    kind: exchange.kind ?? 'video',\n    get participants(): RoomParticipantInfo[] {\n      return [...room.remoteParticipants.values()].map((p) => ({\n        participantId: identityToPid(p.identity),\n        name: p.name ?? '',\n      }))\n    },\n    on<E extends RoomEventName>(event: E, handler: Handler<E>) {\n      const set = handlers.get(event) ?? new Set<(p: unknown) => void>()\n      set.add(handler as (p: unknown) => void)\n      handlers.set(event, set)\n    },\n    publishMic: async () => {\n      await room.localParticipant.setMicrophoneEnabled(true)\n    },\n    publishCamera: async () => {\n      await room.localParticipant.setCameraEnabled(true)\n    },\n    setMicEnabled: async (on: boolean) => {\n      await room.localParticipant.setMicrophoneEnabled(on)\n    },\n    setCameraEnabled: async (on: boolean) => {\n      await room.localParticipant.setCameraEnabled(on)\n    },\n    isMicEnabled: () => room.localParticipant.isMicrophoneEnabled,\n    isCameraEnabled: () => room.localParticipant.isCameraEnabled,\n    getLocalCameraTrack: () =>\n      (room.localParticipant.getTrackPublication(lk.Track.Source.Camera)?.videoTrack as\n        | LocalVideoTrack\n        | undefined) ?? null,\n    getRemoteTracks: (): RoomTrackEvent[] => {\n      const out: RoomTrackEvent[] = []\n      for (const p of room.remoteParticipants.values()) {\n        for (const pub of p.trackPublications.values()) {\n          const track = pub.track\n          if (!track) continue\n          out.push({\n            participantId: identityToPid(p.identity),\n            kind: trackKind(track),\n            source: trackSource(pub.source),\n            track,\n          })\n        }\n      }\n      return out\n    },\n    setScreenShareEnabled: async (on: boolean, opts?: { audio?: boolean }) => {\n      await room.localParticipant.setScreenShareEnabled(on, { audio: opts?.audio ?? false })\n    },\n    isScreenShareEnabled: () => room.localParticipant.isScreenShareEnabled,\n    getLocalScreenTrack: () =>\n      (room.localParticipant.getTrackPublication(lk.Track.Source.ScreenShare)?.videoTrack as\n        | LocalVideoTrack\n        | undefined) ?? null,\n    leave: async () => {\n      await room.disconnect()\n    },\n  }\n}\n"],"mappings":"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","names":["opts"]}

package/dist/room.mjs

@@ -0,0 +1,7 @@
+import {
+  joinRoom
+} from "./chunk-LV7JGPYW.mjs";
+export {
+  joinRoom
+};
+//# sourceMappingURL=room.mjs.map

package/dist/room.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/transcribe.d.mts

@@ -0,0 +1,14 @@
+import { m as StartCallOptions, V as VoiceClientConfig } from './config-D2TbvIqT.mjs';
+export { f as CallState, o as TranscriptEntry } from './config-D2TbvIqT.mjs';
+
+interface DictationSession {
+    end: () => void;
+    mute: () => void;
+    unmute: () => void;
+}
+type StartDictationOptions = Pick<StartCallOptions, 'agentId' | 'userId' | 'onTranscript' | 'onError' | 'onStateChange' | 'onEnd'>;
+declare function configureTranscribeClient(config: VoiceClientConfig): {
+    startDictation: (opts: StartDictationOptions) => Promise<DictationSession>;
+};
+
+export { type DictationSession, type StartDictationOptions, configureTranscribeClient };

package/dist/transcribe.d.ts

@@ -0,0 +1,14 @@
+import { m as StartCallOptions, V as VoiceClientConfig } from './config-D2TbvIqT.js';
+export { f as CallState, o as TranscriptEntry } from './config-D2TbvIqT.js';
+
+interface DictationSession {
+    end: () => void;
+    mute: () => void;
+    unmute: () => void;
+}
+type StartDictationOptions = Pick<StartCallOptions, 'agentId' | 'userId' | 'onTranscript' | 'onError' | 'onStateChange' | 'onEnd'>;
+declare function configureTranscribeClient(config: VoiceClientConfig): {
+    startDictation: (opts: StartDictationOptions) => Promise<DictationSession>;
+};
+
+export { type DictationSession, type StartDictationOptions, configureTranscribeClient };