@fluxerjs/voice 1.2.2 → 1.2.3

package/README.md

@@ -11,12 +11,30 @@ pnpm add @fluxerjs/voice @fluxerjs/core
 ## Usage
 
 ```javascript
-import { getVoiceManager } from '@fluxerjs/voice';
+import { getVoiceManager, LiveKitRtcConnection } from '@fluxerjs/voice';
 
 const voiceManager = getVoiceManager(client);
 const connection = await voiceManager.join(channel);
 await connection.play(streamUrl);
 
+// Inbound transcription / speech-to-text pipeline
+if (connection instanceof LiveKitRtcConnection) {
+  const subs = voiceManager.subscribeChannelParticipants(channel.id);
+  connection.on('speakerStart', ({ participantId }) => {
+    console.log('speaker start', participantId);
+  });
+  connection.on('speakerStop', ({ participantId }) => {
+    console.log('speaker stop', participantId);
+  });
+  connection.on('audioFrame', (frame) => {
+    // frame.samples is Int16 PCM suitable for WAV/STT pipelines
+    console.log(frame.participantId, frame.sampleRate, frame.channels, frame.samples.length);
+  });
+
+  // cleanup subscriptions when done
+  for (const sub of subs) sub.stop();
+}
+
 connection.stop();
 voiceManager.leave(guildId);
 ```

package/dist/index.d.mts

@@ -67,6 +67,27 @@ type LiveKitRtcConnectionEvents = VoiceConnectionEvents & {
         self_stream?: boolean;
         self_video?: boolean;
     }];
+    /** Emitted when a remote participant starts speaking. */
+    speakerStart: [payload: {
+        participantId: string;
+    }];
+    /** Emitted when a remote participant stops speaking. */
+    speakerStop: [payload: {
+        participantId: string;
+    }];
+    /** Emitted for each decoded inbound audio frame. */
+    audioFrame: [frame: LiveKitAudioFrame];
+};
+type LiveKitAudioFrame = {
+    participantId: string;
+    trackSid?: string;
+    sampleRate: number;
+    channels: number;
+    samples: Int16Array;
+};
+type LiveKitReceiveSubscription = {
+    participantId: string;
+    stop: () => void;
 };
 /**
  * Options for video playback via {@link LiveKitRtcConnection.playVideo}.
@@ -133,6 +154,10 @@ declare class LiveKitRtcConnection extends EventEmitter {
     private lastServerEndpoint;
     private lastServerToken;
     private _disconnectEmitted;
+    private readonly receiveSubscriptions;
+    private readonly requestedSubscriptions;
+    private readonly participantTrackSids;
+    private readonly activeSpeakers;
     /**
      * @param client - The Fluxer client instance
      * @param channel - The voice channel to connect to
@@ -156,6 +181,13 @@ declare class LiveKitRtcConnection extends EventEmitter {
     setVolume(volumePercent: number): void;
     /** Get current volume (0-200). */
     getVolume(): number;
+    private isAudioTrack;
+    private getParticipantId;
+    private subscribeParticipantTrack;
+    subscribeParticipantAudio(participantId: string, options?: {
+        autoResubscribe?: boolean;
+    }): LiveKitReceiveSubscription;
+    private clearReceiveSubscriptions;
     playOpus(_stream: NodeJS.ReadableStream): void;
     /**
      * Connect to the LiveKit room using voice server and state from the gateway.
@@ -248,6 +280,17 @@ declare class VoiceManager extends EventEmitter {
      * @param userId - User ID to look up
      */
     getVoiceChannelId(guildId: string, userId: string): string | null;
+    /**
+     * List participant user IDs currently in a specific voice channel.
+     */
+    listParticipantsInChannel(guildId: string, channelId: string): string[];
+    /**
+     * Subscribe to inbound audio for all known participants currently in a voice channel.
+     * Only supported for LiveKit connections.
+     */
+    subscribeChannelParticipants(channelId: string, opts?: {
+        autoResubscribe?: boolean;
+    }): LiveKitReceiveSubscription[];
     private handleVoiceStateUpdate;
     private handleVoiceServerUpdate;
     private storeConnectionId;
@@ -317,4 +360,4 @@ declare function getVoiceManager(client: Client, options?: {
     shardId?: number;
 }): VoiceManager;
 
-export { LiveKitRtcConnection, type LiveKitRtcConnectionEvents, type VideoPlayOptions, VoiceConnection, type VoiceConnectionEvents, type VoiceConnectionLike, VoiceManager, type VoiceManagerOptions, type VoiceStateMap, getVoiceManager, joinVoiceChannel };
+export { type LiveKitAudioFrame, type LiveKitReceiveSubscription, LiveKitRtcConnection, type LiveKitRtcConnectionEvents, type VideoPlayOptions, VoiceConnection, type VoiceConnectionEvents, type VoiceConnectionLike, VoiceManager, type VoiceManagerOptions, type VoiceStateMap, getVoiceManager, joinVoiceChannel };

package/dist/index.d.ts

@@ -67,6 +67,27 @@ type LiveKitRtcConnectionEvents = VoiceConnectionEvents & {
         self_stream?: boolean;
         self_video?: boolean;
     }];
+    /** Emitted when a remote participant starts speaking. */
+    speakerStart: [payload: {
+        participantId: string;
+    }];
+    /** Emitted when a remote participant stops speaking. */
+    speakerStop: [payload: {
+        participantId: string;
+    }];
+    /** Emitted for each decoded inbound audio frame. */
+    audioFrame: [frame: LiveKitAudioFrame];
+};
+type LiveKitAudioFrame = {
+    participantId: string;
+    trackSid?: string;
+    sampleRate: number;
+    channels: number;
+    samples: Int16Array;
+};
+type LiveKitReceiveSubscription = {
+    participantId: string;
+    stop: () => void;
 };
 /**
  * Options for video playback via {@link LiveKitRtcConnection.playVideo}.
@@ -133,6 +154,10 @@ declare class LiveKitRtcConnection extends EventEmitter {
     private lastServerEndpoint;
     private lastServerToken;
     private _disconnectEmitted;
+    private readonly receiveSubscriptions;
+    private readonly requestedSubscriptions;
+    private readonly participantTrackSids;
+    private readonly activeSpeakers;
     /**
      * @param client - The Fluxer client instance
      * @param channel - The voice channel to connect to
@@ -156,6 +181,13 @@ declare class LiveKitRtcConnection extends EventEmitter {
     setVolume(volumePercent: number): void;
     /** Get current volume (0-200). */
     getVolume(): number;
+    private isAudioTrack;
+    private getParticipantId;
+    private subscribeParticipantTrack;
+    subscribeParticipantAudio(participantId: string, options?: {
+        autoResubscribe?: boolean;
+    }): LiveKitReceiveSubscription;
+    private clearReceiveSubscriptions;
     playOpus(_stream: NodeJS.ReadableStream): void;
     /**
      * Connect to the LiveKit room using voice server and state from the gateway.
@@ -248,6 +280,17 @@ declare class VoiceManager extends EventEmitter {
      * @param userId - User ID to look up
      */
     getVoiceChannelId(guildId: string, userId: string): string | null;
+    /**
+     * List participant user IDs currently in a specific voice channel.
+     */
+    listParticipantsInChannel(guildId: string, channelId: string): string[];
+    /**
+     * Subscribe to inbound audio for all known participants currently in a voice channel.
+     * Only supported for LiveKit connections.
+     */
+    subscribeChannelParticipants(channelId: string, opts?: {
+        autoResubscribe?: boolean;
+    }): LiveKitReceiveSubscription[];
     private handleVoiceStateUpdate;
     private handleVoiceServerUpdate;
     private storeConnectionId;
@@ -317,4 +360,4 @@ declare function getVoiceManager(client: Client, options?: {
     shardId?: number;
 }): VoiceManager;
 
-export { LiveKitRtcConnection, type LiveKitRtcConnectionEvents, type VideoPlayOptions, VoiceConnection, type VoiceConnectionEvents, type VoiceConnectionLike, VoiceManager, type VoiceManagerOptions, type VoiceStateMap, getVoiceManager, joinVoiceChannel };
+export { type LiveKitAudioFrame, type LiveKitReceiveSubscription, LiveKitRtcConnection, type LiveKitRtcConnectionEvents, type VideoPlayOptions, VoiceConnection, type VoiceConnectionEvents, type VoiceConnectionLike, VoiceManager, type VoiceManagerOptions, type VoiceStateMap, getVoiceManager, joinVoiceChannel };

package/dist/index.js

@@ -499,6 +499,7 @@ var import_node_util = require("util");
 var import_mp4box = require("mp4box");
 var SAMPLE_RATE = 48e3;
 var CHANNELS2 = 1;
+var RECEIVE_READ_TIMEOUT_MS = 100;
 function getNaluByteLength(nalu) {
   if (ArrayBuffer.isView(nalu)) return nalu.byteLength;
   if (nalu instanceof ArrayBuffer) return nalu.byteLength;
@@ -605,6 +606,10 @@ var LiveKitRtcConnection = class extends import_events2.EventEmitter {
   lastServerEndpoint = null;
   lastServerToken = null;
   _disconnectEmitted = false;
+  receiveSubscriptions = /* @__PURE__ */ new Map();
+  requestedSubscriptions = /* @__PURE__ */ new Map();
+  participantTrackSids = /* @__PURE__ */ new Map();
+  activeSpeakers = /* @__PURE__ */ new Set();
   /**
    * @param client - The Fluxer client instance
    * @param channel - The voice channel to connect to
@@ -655,6 +660,110 @@ var LiveKitRtcConnection = class extends import_events2.EventEmitter {
   getVolume() {
     return this._volume ?? 100;
   }
+  isAudioTrack(track) {
+    return track.kind === import_rtc_node.TrackKind.KIND_AUDIO;
+  }
+  getParticipantId(participant) {
+    return participant.identity;
+  }
+  subscribeParticipantTrack(participant, track, options = {}) {
+    if (!this.isAudioTrack(track)) return;
+    const participantId = this.getParticipantId(participant);
+    if (!options.autoSubscribe && !this.requestedSubscriptions.has(participantId)) return;
+    const current = this.receiveSubscriptions.get(participantId);
+    if (current) current.stop();
+    const audioStream = new import_rtc_node.AudioStream(track, {
+      sampleRate: SAMPLE_RATE,
+      numChannels: CHANNELS2,
+      frameSizeMs: 10
+    });
+    let stopped = false;
+    let reader = null;
+    const pump = async () => {
+      try {
+        reader = audioStream.getReader();
+        while (!stopped) {
+          let readTimeout = null;
+          const next = await Promise.race([
+            reader.read(),
+            new Promise((resolve) => {
+              readTimeout = setTimeout(() => resolve(null), RECEIVE_READ_TIMEOUT_MS);
+            })
+          ]);
+          if (readTimeout) clearTimeout(readTimeout);
+          if (next === null) continue;
+          const { done, value } = next;
+          if (done || !value) break;
+          this.emit("audioFrame", {
+            participantId,
+            trackSid: track.sid,
+            sampleRate: value.sampleRate,
+            channels: value.channels,
+            samples: value.data
+          });
+        }
+      } catch (err) {
+        if (!stopped) {
+          this.emit("error", err instanceof Error ? err : new Error(String(err)));
+        }
+      } finally {
+        if (reader) {
+          try {
+            reader.releaseLock();
+          } catch {
+          }
+          reader = null;
+        }
+      }
+    };
+    const stop = () => {
+      if (stopped) return;
+      stopped = true;
+      if (reader) {
+        reader.cancel().catch(() => {
+        });
+        try {
+          reader.releaseLock();
+        } catch {
+        }
+      }
+      audioStream.cancel().catch(() => {
+      });
+      this.receiveSubscriptions.delete(participantId);
+    };
+    this.receiveSubscriptions.set(participantId, { participantId, stop });
+    this.participantTrackSids.set(participantId, track.sid ?? "");
+    void pump();
+  }
+  subscribeParticipantAudio(participantId, options = {}) {
+    const autoResubscribe = options.autoResubscribe === true;
+    const stop = () => {
+      this.receiveSubscriptions.get(participantId)?.stop();
+      this.receiveSubscriptions.delete(participantId);
+      this.participantTrackSids.delete(participantId);
+      this.requestedSubscriptions.delete(participantId);
+    };
+    this.requestedSubscriptions.set(participantId, autoResubscribe);
+    const room = this.room;
+    if (!room || !room.isConnected) return { participantId, stop };
+    const participant = room.remoteParticipants.get(participantId);
+    if (!participant) return { participantId, stop };
+    for (const pub of participant.trackPublications.values()) {
+      const maybeTrack = pub.track;
+      if (maybeTrack && this.isAudioTrack(maybeTrack)) {
+        this.subscribeParticipantTrack(participant, maybeTrack);
+        break;
+      }
+    }
+    return { participantId, stop };
+  }
+  clearReceiveSubscriptions() {
+    for (const sub of this.receiveSubscriptions.values()) sub.stop();
+    this.receiveSubscriptions.clear();
+    this.requestedSubscriptions.clear();
+    this.participantTrackSids.clear();
+    this.activeSpeakers.clear();
+  }
   playOpus(_stream) {
     this.emit(
       "error",
@@ -693,7 +802,48 @@ var LiveKitRtcConnection = class extends import_events2.EventEmitter {
       room.on(import_rtc_node.RoomEvent.Reconnected, () => {
         this.debug("Room reconnected");
       });
-      await room.connect(url, token, { autoSubscribe: false, dynacast: false });
+      room.on(import_rtc_node.RoomEvent.TrackSubscribed, (track, _publication, participant) => {
+        if (!this.isAudioTrack(track)) return;
+        this.subscribeParticipantTrack(participant, track);
+      });
+      room.on(import_rtc_node.RoomEvent.TrackUnsubscribed, (track, _publication, participant) => {
+        if (!this.isAudioTrack(track)) return;
+        const participantId = this.getParticipantId(participant);
+        this.receiveSubscriptions.get(participantId)?.stop();
+        this.receiveSubscriptions.delete(participantId);
+        if (this.requestedSubscriptions.get(participantId) !== true) {
+          this.requestedSubscriptions.delete(participantId);
+        }
+        this.participantTrackSids.delete(participantId);
+      });
+      room.on(import_rtc_node.RoomEvent.ParticipantDisconnected, (participant) => {
+        const participantId = this.getParticipantId(participant);
+        this.receiveSubscriptions.get(participantId)?.stop();
+        this.receiveSubscriptions.delete(participantId);
+        if (this.requestedSubscriptions.get(participantId) !== true) {
+          this.requestedSubscriptions.delete(participantId);
+        }
+        this.participantTrackSids.delete(participantId);
+        if (this.activeSpeakers.delete(participantId)) {
+          this.emit("speakerStop", { participantId });
+        }
+      });
+      room.on(import_rtc_node.RoomEvent.ActiveSpeakersChanged, (speakers) => {
+        const next = new Set(speakers.map((speaker) => speaker.identity));
+        for (const participantId of next) {
+          if (!this.activeSpeakers.has(participantId)) {
+            this.emit("speakerStart", { participantId });
+          }
+        }
+        for (const participantId of this.activeSpeakers) {
+          if (!next.has(participantId)) {
+            this.emit("speakerStop", { participantId });
+          }
+        }
+        this.activeSpeakers.clear();
+        for (const participantId of next) this.activeSpeakers.add(participantId);
+      });
+      await room.connect(url, token, { autoSubscribe: true, dynacast: false });
       this.lastServerEndpoint = raw;
       this.lastServerToken = token;
       this.debug("connected to room");
@@ -1704,6 +1854,7 @@ var LiveKitRtcConnection = class extends import_events2.EventEmitter {
   stop() {
     this._playing = false;
     this.stopVideo();
+    this.clearReceiveSubscriptions();
     if (this.currentStream?.destroy) this.currentStream.destroy();
     this.currentStream = null;
     if (this.audioTrack) {
@@ -1787,6 +1938,31 @@ var VoiceManager = class extends import_events3.EventEmitter {
     if (!guildMap) return null;
     return guildMap.get(userId) ?? null;
   }
+  /**
+   * List participant user IDs currently in a specific voice channel.
+   */
+  listParticipantsInChannel(guildId, channelId) {
+    const guildMap = this.voiceStates.get(guildId);
+    if (!guildMap) return [];
+    const participants = [];
+    for (const [userId, voiceChannelId] of guildMap.entries()) {
+      if (voiceChannelId === channelId) participants.push(userId);
+    }
+    return participants;
+  }
+  /**
+   * Subscribe to inbound audio for all known participants currently in a voice channel.
+   * Only supported for LiveKit connections.
+   */
+  subscribeChannelParticipants(channelId, opts) {
+    const conn = this.connections.get(channelId);
+    if (!(conn instanceof LiveKitRtcConnection)) return [];
+    const guildId = conn.channel.guildId;
+    const participants = this.listParticipantsInChannel(guildId, channelId).filter(
+      (participantId) => participantId !== this.client.user?.id
+    );
+    return participants.map((participantId) => conn.subscribeParticipantAudio(participantId, opts));
+  }
   handleVoiceStateUpdate(data) {
     const guildId = data.guild_id ?? "";
     if (!guildId) return;

package/dist/index.mjs

@@ -365,6 +365,7 @@ var VoiceConnection = class extends EventEmitter {
 import { execFile, spawn } from "child_process";
 import { EventEmitter as EventEmitter2 } from "events";
 import {
+  AudioStream,
   Room,
   RoomEvent,
   AudioSource,
@@ -375,7 +376,8 @@ import {
   TrackSource,
   VideoBufferType,
   VideoFrame,
-  VideoSource
+  VideoSource,
+  TrackKind
 } from "@livekit/rtc-node";
 
 // src/livekit.ts
@@ -471,6 +473,7 @@ import { promisify } from "util";
 import { createFile } from "mp4box";
 var SAMPLE_RATE = 48e3;
 var CHANNELS2 = 1;
+var RECEIVE_READ_TIMEOUT_MS = 100;
 function getNaluByteLength(nalu) {
   if (ArrayBuffer.isView(nalu)) return nalu.byteLength;
   if (nalu instanceof ArrayBuffer) return nalu.byteLength;
@@ -577,6 +580,10 @@ var LiveKitRtcConnection = class extends EventEmitter2 {
   lastServerEndpoint = null;
   lastServerToken = null;
   _disconnectEmitted = false;
+  receiveSubscriptions = /* @__PURE__ */ new Map();
+  requestedSubscriptions = /* @__PURE__ */ new Map();
+  participantTrackSids = /* @__PURE__ */ new Map();
+  activeSpeakers = /* @__PURE__ */ new Set();
   /**
    * @param client - The Fluxer client instance
    * @param channel - The voice channel to connect to
@@ -627,6 +634,110 @@ var LiveKitRtcConnection = class extends EventEmitter2 {
   getVolume() {
     return this._volume ?? 100;
   }
+  isAudioTrack(track) {
+    return track.kind === TrackKind.KIND_AUDIO;
+  }
+  getParticipantId(participant) {
+    return participant.identity;
+  }
+  subscribeParticipantTrack(participant, track, options = {}) {
+    if (!this.isAudioTrack(track)) return;
+    const participantId = this.getParticipantId(participant);
+    if (!options.autoSubscribe && !this.requestedSubscriptions.has(participantId)) return;
+    const current = this.receiveSubscriptions.get(participantId);
+    if (current) current.stop();
+    const audioStream = new AudioStream(track, {
+      sampleRate: SAMPLE_RATE,
+      numChannels: CHANNELS2,
+      frameSizeMs: 10
+    });
+    let stopped = false;
+    let reader = null;
+    const pump = async () => {
+      try {
+        reader = audioStream.getReader();
+        while (!stopped) {
+          let readTimeout = null;
+          const next = await Promise.race([
+            reader.read(),
+            new Promise((resolve) => {
+              readTimeout = setTimeout(() => resolve(null), RECEIVE_READ_TIMEOUT_MS);
+            })
+          ]);
+          if (readTimeout) clearTimeout(readTimeout);
+          if (next === null) continue;
+          const { done, value } = next;
+          if (done || !value) break;
+          this.emit("audioFrame", {
+            participantId,
+            trackSid: track.sid,
+            sampleRate: value.sampleRate,
+            channels: value.channels,
+            samples: value.data
+          });
+        }
+      } catch (err) {
+        if (!stopped) {
+          this.emit("error", err instanceof Error ? err : new Error(String(err)));
+        }
+      } finally {
+        if (reader) {
+          try {
+            reader.releaseLock();
+          } catch {
+          }
+          reader = null;
+        }
+      }
+    };
+    const stop = () => {
+      if (stopped) return;
+      stopped = true;
+      if (reader) {
+        reader.cancel().catch(() => {
+        });
+        try {
+          reader.releaseLock();
+        } catch {
+        }
+      }
+      audioStream.cancel().catch(() => {
+      });
+      this.receiveSubscriptions.delete(participantId);
+    };
+    this.receiveSubscriptions.set(participantId, { participantId, stop });
+    this.participantTrackSids.set(participantId, track.sid ?? "");
+    void pump();
+  }
+  subscribeParticipantAudio(participantId, options = {}) {
+    const autoResubscribe = options.autoResubscribe === true;
+    const stop = () => {
+      this.receiveSubscriptions.get(participantId)?.stop();
+      this.receiveSubscriptions.delete(participantId);
+      this.participantTrackSids.delete(participantId);
+      this.requestedSubscriptions.delete(participantId);
+    };
+    this.requestedSubscriptions.set(participantId, autoResubscribe);
+    const room = this.room;
+    if (!room || !room.isConnected) return { participantId, stop };
+    const participant = room.remoteParticipants.get(participantId);
+    if (!participant) return { participantId, stop };
+    for (const pub of participant.trackPublications.values()) {
+      const maybeTrack = pub.track;
+      if (maybeTrack && this.isAudioTrack(maybeTrack)) {
+        this.subscribeParticipantTrack(participant, maybeTrack);
+        break;
+      }
+    }
+    return { participantId, stop };
+  }
+  clearReceiveSubscriptions() {
+    for (const sub of this.receiveSubscriptions.values()) sub.stop();
+    this.receiveSubscriptions.clear();
+    this.requestedSubscriptions.clear();
+    this.participantTrackSids.clear();
+    this.activeSpeakers.clear();
+  }
   playOpus(_stream) {
     this.emit(
       "error",
@@ -665,7 +776,48 @@ var LiveKitRtcConnection = class extends EventEmitter2 {
       room.on(RoomEvent.Reconnected, () => {
         this.debug("Room reconnected");
       });
-      await room.connect(url, token, { autoSubscribe: false, dynacast: false });
+      room.on(RoomEvent.TrackSubscribed, (track, _publication, participant) => {
+        if (!this.isAudioTrack(track)) return;
+        this.subscribeParticipantTrack(participant, track);
+      });
+      room.on(RoomEvent.TrackUnsubscribed, (track, _publication, participant) => {
+        if (!this.isAudioTrack(track)) return;
+        const participantId = this.getParticipantId(participant);
+        this.receiveSubscriptions.get(participantId)?.stop();
+        this.receiveSubscriptions.delete(participantId);
+        if (this.requestedSubscriptions.get(participantId) !== true) {
+          this.requestedSubscriptions.delete(participantId);
+        }
+        this.participantTrackSids.delete(participantId);
+      });
+      room.on(RoomEvent.ParticipantDisconnected, (participant) => {
+        const participantId = this.getParticipantId(participant);
+        this.receiveSubscriptions.get(participantId)?.stop();
+        this.receiveSubscriptions.delete(participantId);
+        if (this.requestedSubscriptions.get(participantId) !== true) {
+          this.requestedSubscriptions.delete(participantId);
+        }
+        this.participantTrackSids.delete(participantId);
+        if (this.activeSpeakers.delete(participantId)) {
+          this.emit("speakerStop", { participantId });
+        }
+      });
+      room.on(RoomEvent.ActiveSpeakersChanged, (speakers) => {
+        const next = new Set(speakers.map((speaker) => speaker.identity));
+        for (const participantId of next) {
+          if (!this.activeSpeakers.has(participantId)) {
+            this.emit("speakerStart", { participantId });
+          }
+        }
+        for (const participantId of this.activeSpeakers) {
+          if (!next.has(participantId)) {
+            this.emit("speakerStop", { participantId });
+          }
+        }
+        this.activeSpeakers.clear();
+        for (const participantId of next) this.activeSpeakers.add(participantId);
+      });
+      await room.connect(url, token, { autoSubscribe: true, dynacast: false });
       this.lastServerEndpoint = raw;
       this.lastServerToken = token;
       this.debug("connected to room");
@@ -1676,6 +1828,7 @@ var LiveKitRtcConnection = class extends EventEmitter2 {
   stop() {
     this._playing = false;
     this.stopVideo();
+    this.clearReceiveSubscriptions();
     if (this.currentStream?.destroy) this.currentStream.destroy();
     this.currentStream = null;
     if (this.audioTrack) {
@@ -1759,6 +1912,31 @@ var VoiceManager = class extends EventEmitter3 {
     if (!guildMap) return null;
     return guildMap.get(userId) ?? null;
   }
+  /**
+   * List participant user IDs currently in a specific voice channel.
+   */
+  listParticipantsInChannel(guildId, channelId) {
+    const guildMap = this.voiceStates.get(guildId);
+    if (!guildMap) return [];
+    const participants = [];
+    for (const [userId, voiceChannelId] of guildMap.entries()) {
+      if (voiceChannelId === channelId) participants.push(userId);
+    }
+    return participants;
+  }
+  /**
+   * Subscribe to inbound audio for all known participants currently in a voice channel.
+   * Only supported for LiveKit connections.
+   */
+  subscribeChannelParticipants(channelId, opts) {
+    const conn = this.connections.get(channelId);
+    if (!(conn instanceof LiveKitRtcConnection)) return [];
+    const guildId = conn.channel.guildId;
+    const participants = this.listParticipantsInChannel(guildId, channelId).filter(
+      (participantId) => participantId !== this.client.user?.id
+    );
+    return participants.map((participantId) => conn.subscribeParticipantAudio(participantId, opts));
+  }
   handleVoiceStateUpdate(data) {
     const guildId = data.guild_id ?? "";
     if (!guildId) return;

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "Voice support for Fluxer bots",
   "repository": {
     "type": "git",
@@ -39,9 +39,9 @@
     "prism-media": "^1.3.5",
     "tweetnacl": "^1.0.3",
     "ws": "^8.18.0",
-    "@fluxerjs/collection": "1.2.1",
-    "@fluxerjs/types": "1.2.1",
-    "@fluxerjs/core": "1.2.1"
+    "@fluxerjs/collection": "1.2.3",
+    "@fluxerjs/core": "1.2.3",
+    "@fluxerjs/types": "1.2.3"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",