magmastream 2.10.3-alpha.4 → 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",
@@ -250,10 +252,14 @@ export declare enum AvailableFilters {
     Party = "party",
     Pop = "pop",
     Radio = "radio",
+    PluginFilters = "pluginFilters",
+    SetChannelMix = "setChannelMix",
     SetDistortion = "setDistortion",
     SetKaraoke = "setKaraoke",
+    SetLowPass = "setLowPass",
     SetRotation = "setRotation",
     SetTimescale = "setTimescale",
+    SetTremolo = "setTremolo",
     Slowmo = "slowmo",
     Soft = "soft",
     TrebleBass = "trebleBass",

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";
@@ -267,10 +269,14 @@ var AvailableFilters;
     AvailableFilters["Party"] = "party";
     AvailableFilters["Pop"] = "pop";
     AvailableFilters["Radio"] = "radio";
+    AvailableFilters["PluginFilters"] = "pluginFilters";
+    AvailableFilters["SetChannelMix"] = "setChannelMix";
     AvailableFilters["SetDistortion"] = "setDistortion";
     AvailableFilters["SetKaraoke"] = "setKaraoke";
+    AvailableFilters["SetLowPass"] = "setLowPass";
     AvailableFilters["SetRotation"] = "setRotation";
     AvailableFilters["SetTimescale"] = "setTimescale";
+    AvailableFilters["SetTremolo"] = "setTremolo";
     AvailableFilters["Slowmo"] = "slowmo";
     AvailableFilters["Soft"] = "soft";
     AvailableFilters["TrebleBass"] = "trebleBass";

package/dist/structures/Filters.d.ts

@@ -2,14 +2,19 @@ import { Band } from "../utils/filtersEqualizers";
 import { AvailableFilters } from "./Enums";
 import { Manager } from "./Manager";
 import { Player } from "./Player";
-import { DistortionOptions, KaraokeOptions, ReverbOptions, RotationOptions, TimescaleOptions, VibratoOptions } from "./Types";
+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;
     rotation: RotationOptions | null;
     timescale: TimescaleOptions | null;
+    tremoloOptions: TremoloOptions | null;
     vibrato: VibratoOptions | null;
+    channelMix: ChannelMixOptions | null;
+    lowPass: LowPassOptions | null;
+    pluginFilters: Record<string, unknown>;
     reverb: ReverbOptions | null;
     volume: number;
     bassBoostlevel: number;
@@ -42,6 +47,7 @@ export declare class Filters {
      */
     private applyFilter;
     private emitPlayersTasteUpdate;
+    private assertPluginFiltersSupported;
     /**
      * Sets the status of a specific filter.
      *
@@ -112,6 +118,35 @@ export declare class Filters {
      * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
      */
     setVibrato(vibrato?: VibratoOptions): Promise<this>;
+    /**
+     * Sets the tremolo options on the audio.
+     *
+     * @param {TremoloOptions} [tremolo] - The tremolo settings to apply (frequency, depth).
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    setTremolo(tremolo?: TremoloOptions): Promise<this>;
+    /**
+     * Sets the stereo channel mix options on the audio.
+     *
+     * @param {ChannelMixOptions} [channelMix] - The channel mix settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    setChannelMix(channelMix?: ChannelMixOptions): Promise<this>;
+    /**
+     * Sets the low pass filter options on the audio.
+     *
+     * @param {LowPassOptions} [lowPass] - The low pass settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    setLowPass(lowPass?: LowPassOptions): Promise<this>;
+    /**
+     * 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>, requiredPluginNames?: string | string[]): Promise<this>;
     /**
      * Sets the own rotation options effect to the audio.
      *

package/dist/structures/Filters.js

@@ -5,12 +5,17 @@ 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;
     rotation;
     timescale;
+    tremoloOptions;
     vibrato;
+    channelMix;
+    lowPass;
+    pluginFilters;
     reverb;
     volume;
     bassBoostlevel;
@@ -23,7 +28,11 @@ class Filters {
         this.karaoke = null;
         this.rotation = null;
         this.timescale = null;
+        this.tremoloOptions = null;
         this.vibrato = null;
+        this.channelMix = null;
+        this.lowPass = null;
+        this.pluginFilters = {};
         this.reverb = null;
         this.volume = 1.0;
         this.bassBoostlevel = 0;
@@ -48,7 +57,7 @@ class Filters {
      * of the Filters class for method chaining.
      */
     async updateFilters() {
-        const { distortion, equalizer, karaoke, rotation, timescale, vibrato, volume } = this;
+        const { channelMix, distortion, equalizer, karaoke, lowPass, pluginFilters, rotation, timescale, tremoloOptions, vibrato, volume } = this;
         try {
             await this.player.node.rest.updatePlayer({
                 data: {
@@ -56,10 +65,14 @@ class Filters {
                         distortion,
                         equalizer,
                         karaoke,
+                        lowPass,
+                        pluginFilters,
                         rotation,
                         timescale,
+                        tremolo: tremoloOptions,
                         vibrato,
                         volume,
+                        channelMix,
                     },
                 },
                 guildId: this.player.guildId,
@@ -101,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.
      *
@@ -146,7 +171,11 @@ class Filters {
         await this.setKaraoke(null);
         await this.setRotation(null);
         await this.setTimescale(null);
+        await this.setTremolo(null);
         await this.setVibrato(null);
+        await this.setChannelMix(null);
+        await this.setLowPass(null);
+        await this.setPluginFilters({});
         await this.updateFilters();
         this.emitPlayersTasteUpdate(oldPlayer);
         return this;
@@ -215,6 +244,63 @@ class Filters {
         this.emitPlayersTasteUpdate(oldPlayer);
         return this;
     }
+    /**
+     * Sets the tremolo options on the audio.
+     *
+     * @param {TremoloOptions} [tremolo] - The tremolo settings to apply (frequency, depth).
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    async setTremolo(tremolo) {
+        const oldPlayer = { ...this };
+        await this.applyFilter({ property: "tremoloOptions", value: tremolo ?? null });
+        this.setFilterStatus(Enums_1.AvailableFilters.SetTremolo, !!tremolo);
+        this.emitPlayersTasteUpdate(oldPlayer);
+        return this;
+    }
+    /**
+     * Sets the stereo channel mix options on the audio.
+     *
+     * @param {ChannelMixOptions} [channelMix] - The channel mix settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    async setChannelMix(channelMix) {
+        const oldPlayer = { ...this };
+        await this.applyFilter({ property: "channelMix", value: channelMix ?? null });
+        this.setFilterStatus(Enums_1.AvailableFilters.SetChannelMix, !!channelMix);
+        this.emitPlayersTasteUpdate(oldPlayer);
+        return this;
+    }
+    /**
+     * Sets the low pass filter options on the audio.
+     *
+     * @param {LowPassOptions} [lowPass] - The low pass settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    async setLowPass(lowPass) {
+        const oldPlayer = { ...this };
+        await this.applyFilter({ property: "lowPass", value: lowPass ?? null });
+        this.setFilterStatus(Enums_1.AvailableFilters.SetLowPass, !!lowPass);
+        this.emitPlayersTasteUpdate(oldPlayer);
+        return this;
+    }
+    /**
+     * 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, 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);
+        return this;
+    }
     /**
      * Sets the own rotation options effect to the audio.
      *
@@ -557,7 +643,7 @@ class Filters {
      */
     async tremolo(status) {
         const oldPlayer = { ...this };
-        await this.applyFilter({ property: "vibrato", value: status ? { frequency: 5, depth: 0.5 } : null });
+        await this.applyFilter({ property: "tremoloOptions", value: status ? { frequency: 5, depth: 0.5 } : null });
         this.setFilterStatus(Enums_1.AvailableFilters.Tremolo, status);
         this.emitPlayersTasteUpdate(oldPlayer);
         return this;

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);
@@ -250,7 +251,8 @@ class Manager extends events_1.EventEmitter {
                         tracks,
                         playlist: {
                             name: playlistData.info.name,
-                            playlistInfo: playlistData.pluginInfo,
+                            playlistInfo: playlistData.info,
+                            pluginInfo: playlistData.pluginInfo,
                             requester: requester,
                             tracks,
                             duration: tracks.reduce((acc, cur) => acc + (cur.duration || 0), 0),
@@ -263,7 +265,7 @@ class Manager extends events_1.EventEmitter {
             }
             if (this.options.normalizeYouTubeTitles && "tracks" in result) {
                 const processTrack = (track) => {
-                    if (!YOUTUBE_URL_PATTERN.test(track.uri))
+                    if (!track.uri || !YOUTUBE_URL_PATTERN.test(track.uri))
                         return track;
                     const { cleanTitle, cleanAuthor } = this.parseYouTubeTitle(track.title, track.author);
                     track.title = cleanTitle;
@@ -406,23 +408,21 @@ class Manager extends events_1.EventEmitter {
      */
     async decodeTracks(tracks) {
         this.emit(Enums_1.ManagerEventTypes.Debug, `[MANAGER] Decoding tracks: ${Utils_1.JSONUtils.safe(tracks, 2)}`);
-        return new Promise(async (resolve, reject) => {
-            const node = this.useableNode;
-            if (!node) {
-                throw new MagmastreamError_1.MagmaStreamError({
-                    code: Enums_1.MagmaStreamErrorCode.MANAGER_NO_NODES,
-                    message: "No available nodes to decode tracks.",
-                });
-            }
-            const decodedTrackData = (await node.rest.post("/v4/decodetracks", Utils_1.JSONUtils.safe(tracks, 2)).catch((err) => reject(err)));
-            if (!decodedTrackData) {
-                throw new MagmastreamError_1.MagmaStreamError({
-                    code: Enums_1.MagmaStreamErrorCode.REST_REQUEST_FAILED,
-                    message: "No decoded tracks returned from node.",
-                });
-            }
-            return resolve(decodedTrackData);
-        });
+        const node = this.useableNode;
+        if (!node) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.MANAGER_NO_NODES,
+                message: "No available nodes to decode tracks.",
+            });
+        }
+        const decodedTrackData = await node.rest.decodeTracks(tracks);
+        if (!decodedTrackData) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.REST_REQUEST_FAILED,
+                message: "No decoded tracks returned from node.",
+            });
+        }
+        return decodedTrackData;
     }
     /**
      * Decodes a base64 encoded track and returns a TrackData.
@@ -510,7 +510,7 @@ class Manager extends events_1.EventEmitter {
         const player = this.create(playerOptions);
         this.emit(Enums_1.ManagerEventTypes.Debug, `[MANAGER] Recreating player: ${guildId}`);
         if (state.isAutoplay) {
-            const savedUser = state.data?.clientUser;
+            const savedUser = (state.data?.Internal_AutoplayUser || state.data?.clientUser);
             if (savedUser) {
                 const autoPlayUser = await player.manager.resolveUser(savedUser);
                 player.setAutoplay(true, autoPlayUser, state.autoplayTries);
@@ -607,14 +607,18 @@ class Manager extends events_1.EventEmitter {
         const filterActions = {
             bassboost: () => player.filters.bassBoost(state.filters.bassBoostlevel),
             distort: (isEnabled) => player.filters.distort(isEnabled),
+            pluginFilters: () => player.filters.setPluginFilters(state.filters.pluginFilters),
+            setChannelMix: () => player.filters.setChannelMix(state.filters.channelMix),
             setDistortion: () => player.filters.setDistortion(state.filters.distortion),
             eightD: (isEnabled) => player.filters.eightD(isEnabled),
             setKaraoke: () => player.filters.setKaraoke(state.filters.karaoke),
+            setLowPass: () => player.filters.setLowPass(state.filters.lowPass),
             nightcore: (isEnabled) => player.filters.nightcore(isEnabled),
             slowmo: (isEnabled) => player.filters.slowmo(isEnabled),
             soft: (isEnabled) => player.filters.soft(isEnabled),
             trebleBass: (isEnabled) => player.filters.trebleBass(isEnabled),
             setTimescale: () => player.filters.setTimescale(state.filters.timescale),
+            setTremolo: () => player.filters.setTremolo(state.filters.tremolo),
             tv: (isEnabled) => player.filters.tv(isEnabled),
             vibrato: () => player.filters.setVibrato(state.filters.vibrato),
             vaporwave: (isEnabled) => player.filters.vaporwave(isEnabled),

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,
@@ -1079,7 +1134,7 @@ class Node {
      * @returns {Promise<LavalinkInfo>} A promise that resolves to the Lavalink node information.
      */
     async fetchInfo() {
-        return (await this.rest.get(`/v4/info`));
+        return await this.rest.getInfo();
     }
     /**
      * Gets the current sponsorblock segments for a player.
@@ -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.