magmastream 2.10.3-alpha.5 → 2.10.3-alpha.6

package/dist/structures/Enums.d.ts

@@ -43,6 +43,8 @@ export declare enum LoadTypes {
     /** Nodelink */
     Artist = "artist",
     /** Nodelink */
+    Episode = "episode",
+    /** Nodelink */
     Station = "station",
     /** Nodelink */
     Podcast = "podcast",

package/dist/structures/Enums.js

@@ -50,6 +50,8 @@ var LoadTypes;
     /** Nodelink */
     LoadTypes["Artist"] = "artist";
     /** Nodelink */
+    LoadTypes["Episode"] = "episode";
+    /** Nodelink */
     LoadTypes["Station"] = "station";
     /** Nodelink */
     LoadTypes["Podcast"] = "podcast";

package/dist/structures/Filters.d.ts

@@ -4,6 +4,7 @@ import { Manager } from "./Manager";
 import { Player } from "./Player";
 import { ChannelMixOptions, DistortionOptions, KaraokeOptions, LowPassOptions, ReverbOptions, RotationOptions, TimescaleOptions, TremoloOptions, VibratoOptions } from "./Types";
 export declare class Filters {
+    private static readonly defaultPluginFilterPlugins;
     distortion: DistortionOptions | null;
     equalizer: Band[];
     karaoke: KaraokeOptions | null;
@@ -46,6 +47,7 @@ export declare class Filters {
      */
     private applyFilter;
     private emitPlayersTasteUpdate;
+    private assertPluginFiltersSupported;
     /**
      * Sets the status of a specific filter.
      *
@@ -141,9 +143,10 @@ export declare class Filters {
      * Sets plugin-provided filter options on the audio.
      *
      * @param {Record<string, unknown>} [pluginFilters] - Plugin filter settings keyed by plugin filter name.
+     * @param {string | string[]} [requiredPluginNames] - The plugin name(s) that can handle the provided filters. Defaults to LavaDSPX.
      * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
      */
-    setPluginFilters(pluginFilters?: Record<string, unknown>): Promise<this>;
+    setPluginFilters(pluginFilters?: Record<string, unknown>, requiredPluginNames?: string | string[]): Promise<this>;
     /**
      * Sets the own rotation options effect to the audio.
      *

package/dist/structures/Filters.js

@@ -5,6 +5,7 @@ const filtersEqualizers_1 = require("../utils/filtersEqualizers");
 const Enums_1 = require("./Enums");
 const MagmastreamError_1 = require("./MagmastreamError");
 class Filters {
+    static defaultPluginFilterPlugins = ["lavadspx-plugin", "LavaDSPX-Plugin"];
     distortion;
     equalizer;
     karaoke;
@@ -113,6 +114,18 @@ class Filters {
             details: { action: "change" },
         });
     }
+    assertPluginFiltersSupported(pluginNames) {
+        const requiredPlugins = Array.isArray(pluginNames) ? pluginNames : [pluginNames];
+        const availablePlugins = this.player.node.info?.plugins ?? [];
+        const hasRequiredPlugin = requiredPlugins.some((name) => availablePlugins.some((plugin) => plugin.name.toLowerCase() === name.toLowerCase()));
+        if (!hasRequiredPlugin) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.NODE_PLUGIN_ERROR,
+                message: `One of the following plugins must be present in the lavalink node: ${requiredPlugins.map((name) => `"${name}"`).join(" or ")}.`,
+                context: { identifier: this.player.node.options.identifier },
+            });
+        }
+    }
     /**
      * Sets the status of a specific filter.
      *
@@ -274,11 +287,15 @@ class Filters {
      * Sets plugin-provided filter options on the audio.
      *
      * @param {Record<string, unknown>} [pluginFilters] - Plugin filter settings keyed by plugin filter name.
+     * @param {string | string[]} [requiredPluginNames] - The plugin name(s) that can handle the provided filters. Defaults to LavaDSPX.
      * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
      */
-    async setPluginFilters(pluginFilters) {
+    async setPluginFilters(pluginFilters, requiredPluginNames = Filters.defaultPluginFilterPlugins) {
         const oldPlayer = { ...this };
         const nextPluginFilters = pluginFilters ?? {};
+        if (Object.keys(nextPluginFilters).length > 0) {
+            this.assertPluginFiltersSupported(requiredPluginNames);
+        }
         await this.applyFilter({ property: "pluginFilters", value: nextPluginFilters });
         this.setFilterStatus(Enums_1.AvailableFilters.PluginFilters, Object.keys(nextPluginFilters).length > 0);
         this.emitPlayersTasteUpdate(oldPlayer);

package/dist/structures/Manager.js

@@ -231,6 +231,7 @@ class Manager extends events_1.EventEmitter {
                     result = { loadType: lavalinkResponse.loadType, tracks };
                     break;
                 }
+                case Enums_1.LoadTypes.Episode:
                 case Enums_1.LoadTypes.Short:
                 case Enums_1.LoadTypes.Track: {
                     const track = Utils_1.TrackUtils.build(lavalinkResponse.data, requester);

package/dist/structures/Node.d.ts

@@ -158,6 +158,7 @@ export declare class Node {
      * @private
      */
     protected handleEvent(payload: PlayerEvent & PlayerEvents): Promise<void>;
+    private handleNodeLinkEvent;
     /**
      * Emitted when a new track starts playing.
      * @param {Player} player The player that started playing the track.

package/dist/structures/Node.js

@@ -371,7 +371,10 @@ class Node {
      * @param request - The incoming message.
      */
     upgrade(request) {
-        this.isNodeLink = this.options.isNodeLink ?? Boolean(request.headers.isnodelink) ?? false;
+        const nodeLinkHeader = request.headers.iamnodelink ?? request.headers.isnodelink;
+        const isNodeLinkHeader = Array.isArray(nodeLinkHeader) ? nodeLinkHeader.some((value) => value === "true") : nodeLinkHeader === "true";
+        this.isNodeLink = Boolean(this.options.isNodeLink) || isNodeLinkHeader;
+        this.rest.isNodeLink = this.isNodeLink;
     }
     /**
      * Handles the "open" event emitted by the WebSocket connection.
@@ -507,6 +510,8 @@ class Node {
                 this.sessionId = payload.sessionId;
                 await this.updateSessionId();
                 this.info = await this.fetchInfo();
+                this.isNodeLink = this.isNodeLink || Boolean(this.info.isNodelink);
+                this.rest.isNodeLink = this.isNodeLink;
                 if (payload.resumed || !hadPreviousSession) {
                     await this.manager.loadPlayerStates(this.options.identifier);
                 }
@@ -587,11 +592,71 @@ class Node {
                 this.lyricsLine(player, track, payload);
                 break;
             default:
+                if (this.isNodeLink && this.handleNodeLinkEvent(player, payload))
+                    return;
                 error = new Error(`Node#event unknown event '${type}'.`);
                 this.manager.emit(Enums_1.ManagerEventTypes.NodeError, this, error);
                 break;
         }
     }
+    handleNodeLinkEvent(player, payload) {
+        switch (payload.type) {
+            case "VolumeChangedEvent": {
+                if (typeof payload.volume === "number") {
+                    const oldVolume = player.volume;
+                    const oldPlayer = { ...player };
+                    player.volume = payload.volume;
+                    this.manager.emit(Enums_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, player, {
+                        changeType: Enums_1.PlayerStateEventTypes.VolumeChange,
+                        details: {
+                            type: "volume",
+                            action: "adjust",
+                            previousVolume: oldVolume,
+                            currentVolume: player.volume,
+                        },
+                    });
+                }
+                return true;
+            }
+            case "PauseEvent": {
+                if (typeof payload.paused === "boolean") {
+                    const oldPaused = player.paused;
+                    const oldPlayer = { ...player };
+                    player.paused = payload.paused;
+                    player.playing = !payload.paused;
+                    this.manager.emit(Enums_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, player, {
+                        changeType: Enums_1.PlayerStateEventTypes.PauseChange,
+                        details: {
+                            type: "pause",
+                            action: payload.paused ? "pause" : "resume",
+                            previousPause: oldPaused,
+                            currentPause: player.paused,
+                        },
+                    });
+                }
+                return true;
+            }
+            case "SeekEvent":
+                if (typeof payload.position === "number")
+                    player.position = payload.position;
+                return true;
+            case "PlayerCreatedEvent":
+            case "PlayerDestroyedEvent":
+            case "PlayerConnectedEvent":
+            case "PlayerReconnectingEvent":
+            case "ConnectionStatusEvent":
+            case "FiltersChangedEvent":
+            case "MixStartedEvent":
+            case "MixEndedEvent":
+            case "EternalBoxInfoEvent":
+            case "EternalBoxJumpEvent":
+            case "StreamMetadataEvent":
+                this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] NodeLink player event for guild ${player.guildId}: ${Utils_1.JSONUtils.safe(payload, 2)}`);
+                return true;
+            default:
+                return false;
+        }
+    }
     /**
      * Emitted when a new track starts playing.
      * @param {Player} player The player that started playing the track.
@@ -849,7 +914,7 @@ class Node {
             });
         }
         if (this.isNodeLink) {
-            return (await this.rest.get(`/v4/loadlyrics?encodedTrack=${encodeURIComponent(track.track)}${language ? `&language=${language}` : ""}`));
+            return (await this.rest.get(`/v4/loadlyrics?encodedTrack=${encodeURIComponent(track.track)}${language ? `&lang=${encodeURIComponent(language)}` : ""}`));
         }
         const requiredPlugins = ["lavalyrics-plugin"];
         for (const plugin of requiredPlugins) {
@@ -886,13 +951,8 @@ class Node {
                 context: { identifier: this.options.identifier },
             });
         }
-        if (this.isNodeLink) {
-            throw new MagmastreamError_1.MagmaStreamError({
-                code: Enums_1.MagmaStreamErrorCode.NODE_PROTOCOL_ERROR,
-                message: `The node is a NodeLink, cannot subscribe to lyrics.`,
-                context: { identifier: this.options.identifier },
-            });
-        }
+        if (this.isNodeLink)
+            return await this.rest.post(`/v4/sessions/${this.sessionId}/players/${guildId}/lyrics/subscribe?skipTrackSource=${skipTrackSource}`, {});
         const requiredPlugins = ["lavalyrics-plugin"];
         for (const plugin of requiredPlugins) {
             if (!this.info.plugins.some((p) => p.name === plugin)) {
@@ -938,13 +998,8 @@ class Node {
                 context: { identifier: this.options.identifier },
             });
         }
-        if (this.isNodeLink) {
-            throw new MagmastreamError_1.MagmaStreamError({
-                code: Enums_1.MagmaStreamErrorCode.NODE_PROTOCOL_ERROR,
-                message: `The node is a NodeLink, cannot unsubscribe from lyrics.`,
-                context: { identifier: this.options.identifier },
-            });
-        }
+        if (this.isNodeLink)
+            return await this.rest.delete(`/v4/sessions/${this.sessionId}/players/${guildId}/lyrics/subscribe`);
         if (!this.info.plugins.some((plugin) => plugin.name === "java-lyrics-plugin")) {
             throw new MagmastreamError_1.MagmaStreamError({
                 code: Enums_1.MagmaStreamErrorCode.NODE_PLUGIN_ERROR,
@@ -1088,6 +1143,22 @@ class Node {
      * @throws {RangeError} If the sponsorblock-plugin is not available in the Lavalink node.
      */
     async getSponsorBlock(player) {
+        if (this.isNodeLink) {
+            try {
+                const state = (await this.rest.get(`/v4/sessions/${this.sessionId}/players/${player.guildId}/sponsorblock`));
+                return state.categories.map((segment) => segment);
+            }
+            catch (err) {
+                throw err instanceof MagmastreamError_1.MagmaStreamError
+                    ? err
+                    : new MagmastreamError_1.MagmaStreamError({
+                        code: Enums_1.MagmaStreamErrorCode.NODE_PROTOCOL_ERROR,
+                        message: "Failed to fetch NodeLink SponsorBlock state.",
+                        cause: err instanceof Error ? err : undefined,
+                        context: { identifier: this.options.identifier, guildId: player.guildId },
+                    });
+            }
+        }
         if (!this.info.plugins.some((plugin) => plugin.name === "sponsorblock-plugin")) {
             throw new MagmastreamError_1.MagmaStreamError({
                 code: Enums_1.MagmaStreamErrorCode.NODE_PLUGIN_ERROR,
@@ -1124,13 +1195,6 @@ class Node {
      * ```
      */
     async setSponsorBlock(player, segments = [Enums_1.SponsorBlockSegment.Sponsor, Enums_1.SponsorBlockSegment.SelfPromo]) {
-        if (!this.info.plugins.some((plugin) => plugin.name === "sponsorblock-plugin")) {
-            throw new MagmastreamError_1.MagmaStreamError({
-                code: Enums_1.MagmaStreamErrorCode.NODE_PLUGIN_ERROR,
-                message: `The plugin "sponsorblock-plugin" must be present in the lavalink node to set SponsorBlock segments.`,
-                context: { identifier: this.options.identifier, guildId: player.guildId },
-            });
-        }
         if (!segments.length) {
             throw new MagmastreamError_1.MagmaStreamError({
                 code: Enums_1.MagmaStreamErrorCode.NODE_PROTOCOL_ERROR,
@@ -1145,8 +1209,35 @@ class Node {
                 context: { identifier: this.options.identifier, guildId: player.guildId, invalidSegments: segments },
             });
         }
+        const categories = segments.map((segment) => segment.toLowerCase());
+        if (this.isNodeLink) {
+            try {
+                await this.rest.patch(`/v4/sessions/${this.sessionId}/players/${player.guildId}/sponsorblock`, {
+                    enabled: true,
+                    categories,
+                });
+                return;
+            }
+            catch (err) {
+                throw err instanceof MagmastreamError_1.MagmaStreamError
+                    ? err
+                    : new MagmastreamError_1.MagmaStreamError({
+                        code: Enums_1.MagmaStreamErrorCode.NODE_PROTOCOL_ERROR,
+                        message: "Failed to set NodeLink SponsorBlock categories.",
+                        cause: err instanceof Error ? err : undefined,
+                        context: { identifier: this.options.identifier, guildId: player.guildId, segments },
+                    });
+            }
+        }
+        if (!this.info.plugins.some((plugin) => plugin.name === "sponsorblock-plugin")) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.NODE_PLUGIN_ERROR,
+                message: `The plugin "sponsorblock-plugin" must be present in the lavalink node to set SponsorBlock segments.`,
+                context: { identifier: this.options.identifier, guildId: player.guildId },
+            });
+        }
         try {
-            await this.rest.put(`/v4/sessions/${this.sessionId}/players/${player.guildId}/sponsorblock/categories`, segments.map((segment) => segment.toLowerCase()));
+            await this.rest.put(`/v4/sessions/${this.sessionId}/players/${player.guildId}/sponsorblock/categories`, categories);
         }
         catch (err) {
             throw err instanceof MagmastreamError_1.MagmaStreamError
@@ -1166,6 +1257,22 @@ class Node {
      * @throws {RangeError} If the sponsorblock-plugin is not available in the Lavalink node.
      */
     async deleteSponsorBlock(player) {
+        if (this.isNodeLink) {
+            try {
+                await this.rest.delete(`/v4/sessions/${this.sessionId}/players/${player.guildId}/sponsorblock`);
+                return;
+            }
+            catch (err) {
+                throw err instanceof MagmastreamError_1.MagmaStreamError
+                    ? err
+                    : new MagmastreamError_1.MagmaStreamError({
+                        code: Enums_1.MagmaStreamErrorCode.NODE_PROTOCOL_ERROR,
+                        message: "Failed to delete NodeLink SponsorBlock state.",
+                        cause: err instanceof Error ? err : undefined,
+                        context: { identifier: this.options.identifier, guildId: player.guildId },
+                    });
+            }
+        }
         if (!this.info.plugins.some((plugin) => plugin.name === "sponsorblock-plugin")) {
             throw new MagmastreamError_1.MagmaStreamError({
                 code: Enums_1.MagmaStreamErrorCode.NODE_PLUGIN_ERROR,

package/dist/structures/Player.d.ts

@@ -58,6 +58,7 @@ export declare class Player {
     protected voiceReceiverReconnectTimeout?: NodeJS.Timeout;
     protected voiceReceiverAttempt: number;
     protected voiceReceiverReconnectTries: number;
+    private readonly voiceReceiverStreams;
     /**
      * Creates a new player, returns one if it already exists.
      * @param options The player options.
@@ -329,10 +330,13 @@ export declare class Player {
     private openVoiceReceiver;
     /**
      * Handles a voice receiver message.
-     * @param {string} payload - The payload to handle.
+     * @param {RawData} payload - The payload to handle.
      * @returns {Promise<void>} - A promise that resolves when the voice receiver message is handled.
      */
     private onVoiceReceiverMessage;
+    private toVoiceReceiverBuffer;
+    private parseNodeLinkVoiceFrame;
+    private handleNodeLinkVoiceFrame;
     /**
      * Handles a voice receiver error.
      * @param {Error} error - The error to handle.

package/dist/structures/Player.js

@@ -61,11 +61,12 @@ class Player {
     dynamicRepeatIntervalMs = null;
     static _manager;
     /** Should only be used when the node is a NodeLink */
-    voiceReceiverWsClient;
-    isConnectToVoiceReceiver;
+    voiceReceiverWsClient = null;
+    isConnectToVoiceReceiver = false;
     voiceReceiverReconnectTimeout;
-    voiceReceiverAttempt;
-    voiceReceiverReconnectTries;
+    voiceReceiverAttempt = 1;
+    voiceReceiverReconnectTries = 30;
+    voiceReceiverStreams = new Map();
     /**
      * Creates a new player, returns one if it already exists.
      * @param options The player options.
@@ -270,6 +271,7 @@ class Player {
             this.voiceReceiverWsClient.close();
             this.voiceReceiverWsClient = null;
         }
+        this.voiceReceiverStreams.clear();
         if (disconnect) {
             await this.disconnect().catch(() => { });
         }
@@ -1040,10 +1042,11 @@ class Player {
             "Client-Name": this.manager.options.clientName,
         };
         const { host, useSSL, port } = this.node.options;
-        this.voiceReceiverWsClient = new ws_1.WebSocket(`${useSSL ? "wss" : "ws"}://${host}:${port}/connection/data`, { headers });
+        this.voiceReceiverReconnectTries = this.node.options.maxRetryAttempts ?? this.voiceReceiverReconnectTries;
+        this.voiceReceiverWsClient = new ws_1.WebSocket(`${useSSL ? "wss" : "ws"}://${host}:${port}/v4/websocket/voice/${this.guildId}`, { headers });
         this.voiceReceiverWsClient.on("open", () => this.openVoiceReceiver());
         this.voiceReceiverWsClient.on("error", (err) => this.onVoiceReceiverError(err));
-        this.voiceReceiverWsClient.on("message", (rawMessage) => this.onVoiceReceiverMessage(rawMessage.toString()));
+        this.voiceReceiverWsClient.on("message", (rawMessage) => this.onVoiceReceiverMessage(rawMessage));
         this.voiceReceiverWsClient.on("close", (code, reason) => this.closeVoiceReceiver(code, reason.toString()));
     }
     /**
@@ -1065,6 +1068,7 @@ class Player {
             this.voiceReceiverWsClient = null;
         }
         this.isConnectToVoiceReceiver = false;
+        this.voiceReceiverStreams.clear();
     }
     /**
      * Closes the voice receiver for the player.
@@ -1108,6 +1112,8 @@ class Player {
         this.voiceReceiverWsClient?.close(1000, "destroy");
         this.voiceReceiverWsClient?.removeAllListeners();
         this.voiceReceiverWsClient = null;
+        this.voiceReceiverStreams.clear();
+        this.isConnectToVoiceReceiver = false;
         this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[PLAYER] Disconnected from voice receiver for player ${this.guildId}`);
         this.manager.emit(Enums_1.ManagerEventTypes.VoiceReceiverDisconnect, this);
     }
@@ -1125,14 +1131,28 @@ class Player {
     }
     /**
      * Handles a voice receiver message.
-     * @param {string} payload - The payload to handle.
+     * @param {RawData} payload - The payload to handle.
      * @returns {Promise<void>} - A promise that resolves when the voice receiver message is handled.
      */
     async onVoiceReceiverMessage(payload) {
-        const packet = JSON.parse(payload);
+        const buffer = this.toVoiceReceiverBuffer(payload);
+        const parsedFrame = this.parseNodeLinkVoiceFrame(buffer);
+        if (parsedFrame) {
+            this.handleNodeLinkVoiceFrame(parsedFrame);
+            return;
+        }
+        const textPayload = buffer.toString();
+        let packet;
+        try {
+            packet = JSON.parse(textPayload);
+        }
+        catch {
+            this.manager.emit(Enums_1.ManagerEventTypes.Debug, `VoiceReceiver recieved an unknown binary payload for player ${this.guildId}`);
+            return;
+        }
         if (!packet?.op)
             return;
-        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `VoiceReceiver recieved a payload: ${Utils_1.JSONUtils.safe(payload, 2)}`);
+        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `VoiceReceiver recieved a payload: ${Utils_1.JSONUtils.safe(textPayload, 2)}`);
         switch (packet.type) {
             case "startSpeakingEvent": {
                 this.manager.emit(Enums_1.ManagerEventTypes.VoiceReceiverStartSpeaking, this, packet.data);
@@ -1141,17 +1161,86 @@ class Player {
             case "endSpeakingEvent": {
                 const data = {
                     ...packet.data,
-                    data: Buffer.from(packet.data.data, "base64"),
+                    data: Buffer.isBuffer(packet.data.data) ? packet.data.data : Buffer.from(packet.data.data, "base64"),
                 };
                 this.manager.emit(Enums_1.ManagerEventTypes.VoiceReceiverEndSpeaking, this, data);
                 break;
             }
             default: {
-                this.manager.emit(Enums_1.ManagerEventTypes.Debug, `VoiceReceiver recieved an unknown payload: ${Utils_1.JSONUtils.safe(payload, 2)}`);
+                this.manager.emit(Enums_1.ManagerEventTypes.Debug, `VoiceReceiver recieved an unknown payload: ${Utils_1.JSONUtils.safe(textPayload, 2)}`);
                 break;
             }
         }
     }
+    toVoiceReceiverBuffer(payload) {
+        if (Buffer.isBuffer(payload))
+            return payload;
+        if (payload instanceof ArrayBuffer)
+            return Buffer.from(payload);
+        return Buffer.concat(payload);
+    }
+    parseNodeLinkVoiceFrame(payload) {
+        if (payload.length < 12)
+            return null;
+        let offset = 0;
+        const op = payload.readUInt8(offset++);
+        if (op < 1 || op > 3)
+            return null;
+        const format = payload.readUInt8(offset++);
+        const guildLength = payload.readUInt8(offset++);
+        if (offset + guildLength > payload.length)
+            return null;
+        const guildId = payload.toString("utf8", offset, offset + guildLength);
+        offset += guildLength;
+        if (offset >= payload.length)
+            return null;
+        const userLength = payload.readUInt8(offset++);
+        if (offset + userLength + 8 > payload.length)
+            return null;
+        const userId = payload.toString("utf8", offset, offset + userLength);
+        offset += userLength;
+        const ssrc = payload.readUInt32BE(offset);
+        offset += 4;
+        const timestamp = payload.readUInt32BE(offset);
+        offset += 4;
+        const type = format === 2 ? "pcm" : format === 1 ? "ogg" : "opus";
+        return { op, type, guildId, userId, ssrc, timestamp, data: payload.subarray(offset) };
+    }
+    handleNodeLinkVoiceFrame(frame) {
+        const key = `${frame.guildId}:${frame.ssrc}`;
+        if (frame.op === 1) {
+            this.voiceReceiverStreams.set(key, { guildId: frame.guildId, userId: frame.userId, type: frame.type, chunks: [] });
+            this.manager.emit(Enums_1.ManagerEventTypes.VoiceReceiverStartSpeaking, this, {
+                userId: frame.userId,
+                guildId: frame.guildId,
+                ssrc: frame.ssrc,
+                type: frame.type,
+                timestamp: frame.timestamp,
+            });
+            return;
+        }
+        if (frame.op === 3) {
+            const stream = this.voiceReceiverStreams.get(key) ?? { guildId: frame.guildId, userId: frame.userId, type: frame.type, chunks: [] };
+            stream.chunks.push(frame.data);
+            this.voiceReceiverStreams.set(key, stream);
+            return;
+        }
+        if (frame.op === 2) {
+            const stream = this.voiceReceiverStreams.get(key);
+            const chunks = stream?.chunks ?? [];
+            if (frame.data.length > 0)
+                chunks.push(frame.data);
+            this.voiceReceiverStreams.delete(key);
+            this.manager.emit(Enums_1.ManagerEventTypes.VoiceReceiverEndSpeaking, this, {
+                userId: stream?.userId ?? frame.userId,
+                guildId: stream?.guildId ?? frame.guildId,
+                data: Buffer.concat(chunks),
+                type: stream?.type ?? frame.type,
+                ssrc: frame.ssrc,
+                timestamp: frame.timestamp,
+            });
+        }
+    }
     /**
      * Handles a voice receiver error.
      * @param {Error} error - The error to handle.

package/dist/structures/Rest.js

@@ -64,8 +64,26 @@ class Rest {
             this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[REST] Skipping getPlayers - no session ID on node ${this.node.options.identifier}`);
             return [];
         }
-        const result = await this.get(`/v4/sessions/${this.sessionId}/players`);
-        return Array.isArray(result) ? result : (result?.players ?? []);
+        try {
+            const result = await this.get(`/v4/sessions/${this.sessionId}/players`);
+            return Array.isArray(result) ? result : (result?.players ?? []);
+        }
+        catch (err) {
+            const shouldFallback = err instanceof MagmastreamError_1.MagmaStreamError && err.code === Enums_1.MagmaStreamErrorCode.REST_REQUEST_FAILED && err.message.includes("(400)");
+            if (!shouldFallback)
+                throw err;
+            this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[REST] getPlayers bulk endpoint failed on node ${this.node.options.identifier}; falling back to individual player fetches.`);
+            const players = this.manager.players.filter((player) => player.node.options.identifier === this.node.options.identifier);
+            const results = await Promise.all(players.map(async (player) => {
+                try {
+                    return await this.getPlayer(player.guildId);
+                }
+                catch {
+                    return null;
+                }
+            }));
+            return results.filter((player) => player !== null);
+        }
     }
     /**
      * Sends a PATCH request to update player related data.

package/dist/structures/Types.d.ts

@@ -447,7 +447,7 @@ export interface TrackData {
     /** Additional track info provided by plugins. */
     pluginInfo: Record<string, unknown>;
     /** Additional track data sent back from Lavalink. */
-    userData: Record<string, unknown>;
+    userData?: Record<string, unknown>;
 }
 /**
  * Playlist Raw Data
@@ -516,6 +516,15 @@ export interface TrackSearchResult {
     /** The track obtained */
     tracks: [Track];
 }
+/**
+ * Episode Search Result
+ */
+export interface EpisodeSearchResult {
+    /** The load type is always 'episode' */
+    loadType: LoadTypes.Episode;
+    /** The episode obtained */
+    tracks: [Track];
+}
 /**
  * Search Result
  */
@@ -815,6 +824,31 @@ export interface SponsorBlockChapterStarted extends PlayerEvent {
         duration: number;
     };
 }
+/**
+ * NodeLink SponsorBlock segment data.
+ */
+export interface NodeLinkSponsorBlockSegment {
+    uuid: string;
+    start: number;
+    end: number;
+    category: string;
+    actionType: string;
+    votes: number;
+    locked: boolean;
+    videoDuration: number;
+    description: string;
+}
+/**
+ * NodeLink SponsorBlock state.
+ */
+export interface NodeLinkSponsorBlockState {
+    enabled: boolean;
+    categories: string[];
+    actionTypes: string[];
+    segments: NodeLinkSponsorBlockSegment[];
+    lastSkippedUuid: string | null;
+    skipMarginMs: number;
+}
 /**
  * SponsorBlockChaptersLoaded interface
  */
@@ -898,13 +932,21 @@ export interface LavalinkInfo {
         commit: string;
         commitTime: number;
     };
-    jvm: string;
-    lavaplayer: string;
+    jvm?: string;
+    lavaplayer?: string;
+    node?: string;
+    voice?: {
+        name: string;
+        version: string;
+    };
+    isNodelink?: boolean;
     sourceManagers: string[];
     filters: string[];
     plugins: {
         name: string;
         version: string;
+        author?: string | null;
+        path?: string | null;
     }[];
 }
 /**
@@ -958,6 +1000,21 @@ export interface NodeLinkGetLyricsMultiple {
     loadType: "lyricsMultiple";
     data: NodeLinkGetLyricsData[];
 }
+/**
+ * NodeLink Get Lyrics interface
+ */
+export interface NodeLinkGetLyricsLyrics {
+    loadType: "lyrics";
+    data: {
+        provider: string;
+        lines: {
+            time: number;
+            duration?: number;
+            text: string;
+            words?: Record<string, unknown>[];
+        }[];
+    };
+}
 /**
  * NodeLink Get Lyrics Empty interface
  */
@@ -1009,6 +1066,12 @@ export interface StartSpeakingEventVoiceReceiverData {
      * The guild ID of the guild where the user started speaking.
      */
     guildId: string;
+    /** The SSRC identifier of the speaking user. */
+    ssrc?: number;
+    /** The audio frame type sent by NodeLink. */
+    type?: "opus" | "pcm" | "ogg";
+    /** The timestamp sent by NodeLink for the start frame. */
+    timestamp?: number;
 }
 /**
  * End Speaking Event Voice Receiver Data interface
@@ -1025,11 +1088,15 @@ export interface EndSpeakingEventVoiceReceiverData {
     /**
      * The audio data received from the user in base64.
      */
-    data: string;
+    data: string | Buffer;
     /**
      * The type of the audio data. Can be either opus or pcm. Older versions may include ogg/opus.
      */
-    type: "opus" | "pcm";
+    type: "opus" | "pcm" | "ogg";
+    /** The SSRC identifier of the speaking user. */
+    ssrc?: number;
+    /** The timestamp sent by NodeLink for the final frame. */
+    timestamp?: number;
 }
 /**
  * Base Voice Receiver Event interface
@@ -1405,7 +1472,7 @@ export type LoadType = keyof typeof LoadTypes;
 /**
  * NodeLink Get Lyrics Enum type
  */
-export type NodeLinkGetLyrics = NodeLinkGetLyricsSingle | NodeLinkGetLyricsMultiple | NodeLinkGetLyricsEmpty | NodeLinkGetLyricsError;
+export type NodeLinkGetLyrics = NodeLinkGetLyricsLyrics | NodeLinkGetLyricsSingle | NodeLinkGetLyricsMultiple | NodeLinkGetLyricsEmpty | NodeLinkGetLyricsError;
 /**
  * Voice Receiver Event Enum type
  */
@@ -1413,7 +1480,7 @@ export type VoiceReceiverEvent = StartSpeakingEventVoiceReceiver | EndSpeakingEv
 /**
  * Search Result Enum type
  */
-export type SearchResult = TrackSearchResult | SearchSearchResult | PlaylistSearchResult | ErrorOrEmptySearchResult | AlbumSearchResult | ArtistSearchResult | StationSearchResult | PodcastSearchResult | ShowSearchResult | ShortSearchResult;
+export type SearchResult = TrackSearchResult | EpisodeSearchResult | SearchSearchResult | PlaylistSearchResult | ErrorOrEmptySearchResult | AlbumSearchResult | ArtistSearchResult | StationSearchResult | PodcastSearchResult | ShowSearchResult | ShortSearchResult;
 /**
  * Lyrics Event Enum type
  */

package/dist/structures/Utils.js

@@ -228,7 +228,14 @@ class AutoPlayUtils {
         // Iterate over autoplay platforms in order of priority
         for (const platform of autoPlaySearchPlatforms) {
             if (enabledSources.includes(platform)) {
-                const recommendedTracks = await this.getRecommendedTracksFromSource(track, platform);
+                let recommendedTracks;
+                try {
+                    recommendedTracks = await this.getRecommendedTracksFromSource(track, platform);
+                }
+                catch (error) {
+                    this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[AUTOPLAY] Failed to fetch recommendations from ${platform}: ${error instanceof Error ? error.message : String(error)}`);
+                    continue;
+                }
                 // If tracks are found, return them immediately
                 if (recommendedTracks.length > 0) {
                     return recommendedTracks;
@@ -336,7 +343,7 @@ class AutoPlayUtils {
                 // 	return match ? match[1] : null;
                 // };
                 // const identifier = `sprec:seed_artists=${extractSpotifyArtistID(track.pluginInfo.artistUrl)}&seed_tracks=${track.identifier}`;
-                const identifier = `sprec:mix:track:${track.identifier}`;
+                const identifier = this.manager.useableNode.isNodeLink ? `sprec:seed_tracks=${track.identifier}` : `sprec:mix:track:${track.identifier}`;
                 const recommendedResult = (await this.manager.useableNode.rest.get(`/v4/loadtracks?identifier=${encodeURIComponent(identifier)}`));
                 const tracks = this.buildTracksFromResponse(recommendedResult, requester);
                 return tracks;
@@ -515,6 +522,7 @@ class AutoPlayUtils {
                 case Enums_1.LoadTypes.Playlist:
                     return searchResult.playlist.tracks;
                 case Enums_1.LoadTypes.Track:
+                case Enums_1.LoadTypes.Episode:
                 case Enums_1.LoadTypes.Search:
                 case Enums_1.LoadTypes.Short:
                     return searchResult.tracks;
@@ -550,6 +558,7 @@ class AutoPlayUtils {
                 case Enums_1.LoadTypes.Playlist:
                     return searchResult.playlist.tracks[0] || null;
                 case Enums_1.LoadTypes.Track:
+                case Enums_1.LoadTypes.Episode:
                 case Enums_1.LoadTypes.Search:
                 case Enums_1.LoadTypes.Short:
                     return searchResult.tracks[0] || null;
@@ -577,6 +586,7 @@ class AutoPlayUtils {
         if (TrackUtils.isErrorOrEmptySearchResult(recommendedResult))
             return [];
         switch (recommendedResult.loadType) {
+            case Enums_1.LoadTypes.Episode:
             case Enums_1.LoadTypes.Track: {
                 const data = recommendedResult.data;
                 if (!this.isTrackData(data)) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "magmastream",
-    "version": "2.10.3-alpha.5",
+    "version": "2.10.3-alpha.6",
     "description": "A user-friendly Lavalink client designed for NodeJS.",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",