@fluxerjs/voice 1.1.7 → 1.1.8

package/dist/index.d.mts

@@ -82,6 +82,8 @@ type LiveKitRtcConnectionEvents = VoiceConnectionEvents & {
  * @property maxFramerate - Max framerate for encoding (default: 60).
  * @property width - Output width (default: source). FFmpeg path only.
  * @property height - Output height (default: source). FFmpeg path only.
+ * @property resolution - Output resolution. When set, overrides width/height and maxFramerate. FFmpeg path only.
+ *   480p, 720p, 1080p, 1440p, 4k = @ 30fps.
  */
 interface VideoPlayOptions {
     /** Track source hint - camera or screenshare (default: camera). */
@@ -98,6 +100,8 @@ interface VideoPlayOptions {
     width?: number;
     /** Output height for resolution override (FFmpeg path). */
     height?: number;
+    /** Output resolution. When set, overrides width/height and maxFramerate. FFmpeg path only. */
+    resolution?: '480p' | '720p' | '1080p' | '1440p' | '4k';
 }
 /**
  * Voice connection using LiveKit RTC. Used when Fluxer routes voice to LiveKit.
@@ -114,6 +118,7 @@ declare class LiveKitRtcConnection extends EventEmitter {
     readonly client: Client;
     readonly channel: VoiceChannel;
     readonly guildId: string;
+    private _volume;
     private _playing;
     private _playingVideo;
     private _destroyed;
@@ -147,6 +152,10 @@ declare class LiveKitRtcConnection extends EventEmitter {
      * @param token - Voice server token
      */
     isSameServer(endpoint: string | null, token: string): boolean;
+    /** Set playback volume (0-200, 100 = normal). Affects current and future playback. */
+    setVolume(volumePercent: number): void;
+    /** Get current volume (0-200). */
+    getVolume(): number;
     playOpus(_stream: NodeJS.ReadableStream): void;
     /**
      * Connect to the LiveKit room using voice server and state from the gateway.
@@ -222,11 +231,13 @@ interface VoiceManagerOptions {
 /** Manages voice connections. Use `getVoiceManager(client)` to obtain an instance. */
 declare class VoiceManager extends EventEmitter {
     readonly client: Client;
+    /** channel_id -> connection (Fluxer multi-channel: allows multiple connections per guild) */
     private readonly connections;
-    /** guild_id -> connection_id (from VoiceServerUpdate; required for voice state updates when in channel) */
+    /** channel_id -> connection_id (from VoiceServerUpdate; required for voice state updates) */
     private readonly connectionIds;
     /** guild_id -> user_id -> channel_id */
     readonly voiceStates: VoiceStateMap;
+    /** channel_id -> pending join */
     private readonly pending;
     private readonly shardId;
     constructor(client: Client, options?: VoiceManagerOptions);
@@ -246,29 +257,36 @@ declare class VoiceManager extends EventEmitter {
     private tryCompletePending;
     /**
      * Join a voice channel. Resolves when the connection is ready.
+     * Supports multiple connections per guild (Fluxer multi-channel).
      * @param channel - The voice channel to join
      * @returns The voice connection (LiveKitRtcConnection when Fluxer uses LiveKit)
      */
     join(channel: VoiceChannel): Promise<VoiceConnection | LiveKitRtcConnection>;
     /**
-     * Leave a guild's voice channel and disconnect.
+     * Leave all voice channels in a guild.
+     * With multi-channel support, disconnects from every channel in the guild.
      * @param guildId - Guild ID to leave
      */
     leave(guildId: string): void;
     /**
-     * Get the active voice connection for a guild, if any.
-     * @param guildId - Guild ID to look up
+     * Leave a specific voice channel by channel ID.
+     * @param channelId - Channel ID to leave
+     */
+    leaveChannel(channelId: string): void;
+    /**
+     * Get the active voice connection for a channel or guild.
+     * @param channelOrGuildId - Channel ID (primary) or guild ID (returns first connection in that guild)
      */
-    getConnection(guildId: string): VoiceConnection | LiveKitRtcConnection | undefined;
+    getConnection(channelOrGuildId: string): VoiceConnection | LiveKitRtcConnection | undefined;
     /**
      * Update voice state (e.g. self_stream, self_video) while in a channel.
      * Sends a VoiceStateUpdate to the gateway so the server and clients see the change.
      * Requires connection_id (from VoiceServerUpdate); without it, the gateway would treat
      * the update as a new join and trigger a new VoiceServerUpdate, causing connection loops.
-     * @param guildId - Guild ID
+     * @param channelId - Channel ID (connection key)
      * @param partial - Partial voice state to update (self_stream, self_video, self_mute, self_deaf)
      */
-    updateVoiceState(guildId: string, partial: {
+    updateVoiceState(channelId: string, partial: {
         self_stream?: boolean;
         self_video?: boolean;
         self_mute?: boolean;

package/dist/index.d.ts

@@ -82,6 +82,8 @@ type LiveKitRtcConnectionEvents = VoiceConnectionEvents & {
  * @property maxFramerate - Max framerate for encoding (default: 60).
  * @property width - Output width (default: source). FFmpeg path only.
  * @property height - Output height (default: source). FFmpeg path only.
+ * @property resolution - Output resolution. When set, overrides width/height and maxFramerate. FFmpeg path only.
+ *   480p, 720p, 1080p, 1440p, 4k = @ 30fps.
  */
 interface VideoPlayOptions {
     /** Track source hint - camera or screenshare (default: camera). */
@@ -98,6 +100,8 @@ interface VideoPlayOptions {
     width?: number;
     /** Output height for resolution override (FFmpeg path). */
     height?: number;
+    /** Output resolution. When set, overrides width/height and maxFramerate. FFmpeg path only. */
+    resolution?: '480p' | '720p' | '1080p' | '1440p' | '4k';
 }
 /**
  * Voice connection using LiveKit RTC. Used when Fluxer routes voice to LiveKit.
@@ -114,6 +118,7 @@ declare class LiveKitRtcConnection extends EventEmitter {
     readonly client: Client;
     readonly channel: VoiceChannel;
     readonly guildId: string;
+    private _volume;
     private _playing;
     private _playingVideo;
     private _destroyed;
@@ -147,6 +152,10 @@ declare class LiveKitRtcConnection extends EventEmitter {
      * @param token - Voice server token
      */
     isSameServer(endpoint: string | null, token: string): boolean;
+    /** Set playback volume (0-200, 100 = normal). Affects current and future playback. */
+    setVolume(volumePercent: number): void;
+    /** Get current volume (0-200). */
+    getVolume(): number;
     playOpus(_stream: NodeJS.ReadableStream): void;
     /**
      * Connect to the LiveKit room using voice server and state from the gateway.
@@ -222,11 +231,13 @@ interface VoiceManagerOptions {
 /** Manages voice connections. Use `getVoiceManager(client)` to obtain an instance. */
 declare class VoiceManager extends EventEmitter {
     readonly client: Client;
+    /** channel_id -> connection (Fluxer multi-channel: allows multiple connections per guild) */
     private readonly connections;
-    /** guild_id -> connection_id (from VoiceServerUpdate; required for voice state updates when in channel) */
+    /** channel_id -> connection_id (from VoiceServerUpdate; required for voice state updates) */
     private readonly connectionIds;
     /** guild_id -> user_id -> channel_id */
     readonly voiceStates: VoiceStateMap;
+    /** channel_id -> pending join */
     private readonly pending;
     private readonly shardId;
     constructor(client: Client, options?: VoiceManagerOptions);
@@ -246,29 +257,36 @@ declare class VoiceManager extends EventEmitter {
     private tryCompletePending;
     /**
      * Join a voice channel. Resolves when the connection is ready.
+     * Supports multiple connections per guild (Fluxer multi-channel).
      * @param channel - The voice channel to join
      * @returns The voice connection (LiveKitRtcConnection when Fluxer uses LiveKit)
      */
     join(channel: VoiceChannel): Promise<VoiceConnection | LiveKitRtcConnection>;
     /**
-     * Leave a guild's voice channel and disconnect.
+     * Leave all voice channels in a guild.
+     * With multi-channel support, disconnects from every channel in the guild.
      * @param guildId - Guild ID to leave
      */
     leave(guildId: string): void;
     /**
-     * Get the active voice connection for a guild, if any.
-     * @param guildId - Guild ID to look up
+     * Leave a specific voice channel by channel ID.
+     * @param channelId - Channel ID to leave
+     */
+    leaveChannel(channelId: string): void;
+    /**
+     * Get the active voice connection for a channel or guild.
+     * @param channelOrGuildId - Channel ID (primary) or guild ID (returns first connection in that guild)
      */
-    getConnection(guildId: string): VoiceConnection | LiveKitRtcConnection | undefined;
+    getConnection(channelOrGuildId: string): VoiceConnection | LiveKitRtcConnection | undefined;
     /**
      * Update voice state (e.g. self_stream, self_video) while in a channel.
      * Sends a VoiceStateUpdate to the gateway so the server and clients see the change.
      * Requires connection_id (from VoiceServerUpdate); without it, the gateway would treat
      * the update as a new join and trigger a new VoiceServerUpdate, causing connection loops.
-     * @param guildId - Guild ID
+     * @param channelId - Channel ID (connection key)
      * @param partial - Partial voice state to update (self_stream, self_video, self_mute, self_deaf)
      */
-    updateVoiceState(guildId: string, partial: {
+    updateVoiceState(channelId: string, partial: {
         self_stream?: boolean;
         self_video?: boolean;
         self_mute?: boolean;