magmastream 2.10.3-alpha.5 → 2.10.3-alpha.7

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",
@@ -70,6 +72,42 @@ export declare enum SearchPlatform {
     YouTube = "ytsearch",
     YouTubeMusic = "ytmsearch"
 }
+/**
+ * NodeLink-only Search Platform Enum
+ */
+export declare enum NodeLinkSearchPlatform {
+    AmazonMusic = "amazonmusic",
+    AmazonMusicSearch = "azsearch",
+    Anghami = "agsearch",
+    Audiomack = "audiomack",
+    AudiomackSearch = "admsearch",
+    Audius = "ausearch",
+    Bilibili = "bilibili",
+    BilibiliSearch = "bilisearch",
+    Bluesky = "bksearch",
+    Flowery = "flowery",
+    FloweryTTS = "ftts",
+    Gaana = "gaanasearch",
+    GaanaSearch = "gnsearch",
+    GoogleDrive = "gdsearch",
+    GoogleTTS = "gtts",
+    IHeartRadio = "iheartradio",
+    IHeartRadioSearch = "ihsearch",
+    LastFM = "lfsearch",
+    LazyTTS = "lazypytts",
+    LazyTTSAlt = "lazytts",
+    LetrasMus = "lmsearch",
+    Mixcloud = "mixcloud",
+    MixcloudSearch = "mcsearch",
+    Netease = "ntsearch",
+    NicoVideo = "nicovideo",
+    NicoVideoSearch = "ncsearch",
+    Pandora = "pdsearch",
+    PiperTTS = "pipertts",
+    Shazam = "shsearch",
+    ShazamAlt = "szsearch",
+    SongLink = "slsearch"
+}
 /**
  * Player State Event Types Enum
  */
@@ -190,6 +228,10 @@ export declare enum ManagerEventTypes {
     TrackStart = "trackStart",
     TrackStuck = "trackStuck",
     /** Nodelink */
+    MixStarted = "mixStarted",
+    /** Nodelink */
+    MixEnded = "mixEnded",
+    /** Nodelink */
     VoiceReceiverDisconnect = "voiceReceiverDisconnect",
     /** Nodelink */
     VoiceReceiverConnect = "voiceReceiverConnect",
@@ -251,11 +293,21 @@ export declare enum AvailableFilters {
     Pop = "pop",
     Radio = "radio",
     PluginFilters = "pluginFilters",
+    SetChorus = "setChorus",
     SetChannelMix = "setChannelMix",
+    SetCompressor = "setCompressor",
     SetDistortion = "setDistortion",
+    SetEcho = "setEcho",
+    SetFlanger = "setFlanger",
+    SetHighPass = "setHighPass",
     SetKaraoke = "setKaraoke",
     SetLowPass = "setLowPass",
+    SetPhaser = "setPhaser",
+    SetPhonograph = "setPhonograph",
+    SetReverb = "setReverb",
     SetRotation = "setRotation",
+    SetSpatial = "setSpatial",
+    SetTape = "setTape",
     SetTimescale = "setTimescale",
     SetTremolo = "setTremolo",
     Slowmo = "slowmo",

package/dist/structures/Enums.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MagmaStreamErrorNumbers = exports.MagmaStreamErrorCode = exports.AvailableFilters = exports.SponsorBlockSegment = exports.SeverityTypes = exports.TrackEndReasonTypes = exports.ManagerEventTypes = exports.TrackPartial = exports.UseNodeOptions = exports.TrackSourceTypes = exports.PlayerStateEventTypes = exports.SearchPlatform = exports.LoadTypes = exports.StateTypes = exports.AutoPlayPlatform = exports.StateStorageType = void 0;
+exports.MagmaStreamErrorNumbers = exports.MagmaStreamErrorCode = exports.AvailableFilters = exports.SponsorBlockSegment = exports.SeverityTypes = exports.TrackEndReasonTypes = exports.ManagerEventTypes = exports.TrackPartial = exports.UseNodeOptions = exports.TrackSourceTypes = exports.PlayerStateEventTypes = exports.NodeLinkSearchPlatform = exports.SearchPlatform = exports.LoadTypes = exports.StateTypes = exports.AutoPlayPlatform = exports.StateStorageType = void 0;
 /**
  * State Storage Enum
  */
@@ -50,6 +50,8 @@ var LoadTypes;
     /** Nodelink */
     LoadTypes["Artist"] = "artist";
     /** Nodelink */
+    LoadTypes["Episode"] = "episode";
+    /** Nodelink */
     LoadTypes["Station"] = "station";
     /** Nodelink */
     LoadTypes["Podcast"] = "podcast";
@@ -78,6 +80,43 @@ var SearchPlatform;
     SearchPlatform["YouTube"] = "ytsearch";
     SearchPlatform["YouTubeMusic"] = "ytmsearch";
 })(SearchPlatform || (exports.SearchPlatform = SearchPlatform = {}));
+/**
+ * NodeLink-only Search Platform Enum
+ */
+var NodeLinkSearchPlatform;
+(function (NodeLinkSearchPlatform) {
+    NodeLinkSearchPlatform["AmazonMusic"] = "amazonmusic";
+    NodeLinkSearchPlatform["AmazonMusicSearch"] = "azsearch";
+    NodeLinkSearchPlatform["Anghami"] = "agsearch";
+    NodeLinkSearchPlatform["Audiomack"] = "audiomack";
+    NodeLinkSearchPlatform["AudiomackSearch"] = "admsearch";
+    NodeLinkSearchPlatform["Audius"] = "ausearch";
+    NodeLinkSearchPlatform["Bilibili"] = "bilibili";
+    NodeLinkSearchPlatform["BilibiliSearch"] = "bilisearch";
+    NodeLinkSearchPlatform["Bluesky"] = "bksearch";
+    NodeLinkSearchPlatform["Flowery"] = "flowery";
+    NodeLinkSearchPlatform["FloweryTTS"] = "ftts";
+    NodeLinkSearchPlatform["Gaana"] = "gaanasearch";
+    NodeLinkSearchPlatform["GaanaSearch"] = "gnsearch";
+    NodeLinkSearchPlatform["GoogleDrive"] = "gdsearch";
+    NodeLinkSearchPlatform["GoogleTTS"] = "gtts";
+    NodeLinkSearchPlatform["IHeartRadio"] = "iheartradio";
+    NodeLinkSearchPlatform["IHeartRadioSearch"] = "ihsearch";
+    NodeLinkSearchPlatform["LastFM"] = "lfsearch";
+    NodeLinkSearchPlatform["LazyTTS"] = "lazypytts";
+    NodeLinkSearchPlatform["LazyTTSAlt"] = "lazytts";
+    NodeLinkSearchPlatform["LetrasMus"] = "lmsearch";
+    NodeLinkSearchPlatform["Mixcloud"] = "mixcloud";
+    NodeLinkSearchPlatform["MixcloudSearch"] = "mcsearch";
+    NodeLinkSearchPlatform["Netease"] = "ntsearch";
+    NodeLinkSearchPlatform["NicoVideo"] = "nicovideo";
+    NodeLinkSearchPlatform["NicoVideoSearch"] = "ncsearch";
+    NodeLinkSearchPlatform["Pandora"] = "pdsearch";
+    NodeLinkSearchPlatform["PiperTTS"] = "pipertts";
+    NodeLinkSearchPlatform["Shazam"] = "shsearch";
+    NodeLinkSearchPlatform["ShazamAlt"] = "szsearch";
+    NodeLinkSearchPlatform["SongLink"] = "slsearch";
+})(NodeLinkSearchPlatform || (exports.NodeLinkSearchPlatform = NodeLinkSearchPlatform = {}));
 /**
  * Player State Event Types Enum
  */
@@ -203,6 +242,10 @@ var ManagerEventTypes;
     ManagerEventTypes["TrackStart"] = "trackStart";
     ManagerEventTypes["TrackStuck"] = "trackStuck";
     /** Nodelink */
+    ManagerEventTypes["MixStarted"] = "mixStarted";
+    /** Nodelink */
+    ManagerEventTypes["MixEnded"] = "mixEnded";
+    /** Nodelink */
     ManagerEventTypes["VoiceReceiverDisconnect"] = "voiceReceiverDisconnect";
     /** Nodelink */
     ManagerEventTypes["VoiceReceiverConnect"] = "voiceReceiverConnect";
@@ -268,11 +311,21 @@ var AvailableFilters;
     AvailableFilters["Pop"] = "pop";
     AvailableFilters["Radio"] = "radio";
     AvailableFilters["PluginFilters"] = "pluginFilters";
+    AvailableFilters["SetChorus"] = "setChorus";
     AvailableFilters["SetChannelMix"] = "setChannelMix";
+    AvailableFilters["SetCompressor"] = "setCompressor";
     AvailableFilters["SetDistortion"] = "setDistortion";
+    AvailableFilters["SetEcho"] = "setEcho";
+    AvailableFilters["SetFlanger"] = "setFlanger";
+    AvailableFilters["SetHighPass"] = "setHighPass";
     AvailableFilters["SetKaraoke"] = "setKaraoke";
     AvailableFilters["SetLowPass"] = "setLowPass";
+    AvailableFilters["SetPhaser"] = "setPhaser";
+    AvailableFilters["SetPhonograph"] = "setPhonograph";
+    AvailableFilters["SetReverb"] = "setReverb";
     AvailableFilters["SetRotation"] = "setRotation";
+    AvailableFilters["SetSpatial"] = "setSpatial";
+    AvailableFilters["SetTape"] = "setTape";
     AvailableFilters["SetTimescale"] = "setTimescale";
     AvailableFilters["SetTremolo"] = "setTremolo";
     AvailableFilters["Slowmo"] = "slowmo";

package/dist/structures/Filters.d.ts

@@ -2,8 +2,9 @@ import { Band } from "../utils/filtersEqualizers";
 import { AvailableFilters } from "./Enums";
 import { Manager } from "./Manager";
 import { Player } from "./Player";
-import { ChannelMixOptions, DistortionOptions, KaraokeOptions, LowPassOptions, ReverbOptions, RotationOptions, TimescaleOptions, TremoloOptions, VibratoOptions } from "./Types";
+import { ChannelMixOptions, ChorusOptions, CompressorOptions, DistortionOptions, EchoOptions, FlangerOptions, HighPassOptions, KaraokeOptions, LowPassOptions, PhaserOptions, PhonographOptions, ReverbOptions, RotationOptions, SpatialOptions, TapeOptions, TimescaleOptions, TremoloOptions, VibratoOptions } from "./Types";
 export declare class Filters {
+    private static readonly defaultPluginFilterPlugins;
     distortion: DistortionOptions | null;
     equalizer: Band[];
     karaoke: KaraokeOptions | null;
@@ -13,6 +14,15 @@ export declare class Filters {
     vibrato: VibratoOptions | null;
     channelMix: ChannelMixOptions | null;
     lowPass: LowPassOptions | null;
+    highpass: HighPassOptions | null;
+    echo: EchoOptions | null;
+    chorus: ChorusOptions | null;
+    compressor: CompressorOptions | null;
+    flanger: FlangerOptions | null;
+    phaser: PhaserOptions | null;
+    phonograph: PhonographOptions | null;
+    spatial: SpatialOptions | null;
+    tape: TapeOptions | null;
     pluginFilters: Record<string, unknown>;
     reverb: ReverbOptions | null;
     volume: number;
@@ -46,6 +56,8 @@ export declare class Filters {
      */
     private applyFilter;
     private emitPlayersTasteUpdate;
+    private assertPluginFiltersSupported;
+    private assertNodeLinkExtraFilterSupported;
     /**
      * Sets the status of a specific filter.
      *
@@ -137,13 +149,84 @@ export declare class Filters {
      * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
      */
     setLowPass(lowPass?: LowPassOptions): Promise<this>;
+    /**
+     * Sets the NodeLink high pass filter options on the audio.
+     * @param {HighPassOptions} [highpass] - The high pass settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    setHighPass(highpass?: HighPassOptions): Promise<this>;
+    /**
+     * Sets the NodeLink echo filter options on the audio.
+     * @param {EchoOptions} [echo] - The echo settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    setEcho(echo?: EchoOptions): Promise<this>;
+    /**
+     * Sets the NodeLink reverb filter options on the audio.
+     * @param {ReverbOptions} [reverb] - The reverb settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    setReverb(reverb?: ReverbOptions): Promise<this>;
+    /**
+     * Sets the NodeLink chorus filter options on the audio.
+     * @param {ChorusOptions} [chorus] - The chorus settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    setChorus(chorus?: ChorusOptions): Promise<this>;
+    /**
+     * Sets the NodeLink compressor filter options on the audio.
+     * @param {CompressorOptions} [compressor] - The compressor settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    setCompressor(compressor?: CompressorOptions): Promise<this>;
+    /**
+     * Sets the NodeLink flanger filter options on the audio.
+     * @param {FlangerOptions} [flanger] - The flanger settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    setFlanger(flanger?: FlangerOptions): Promise<this>;
+    /**
+     * Sets the NodeLink phaser filter options on the audio.
+     * @param {PhaserOptions} [phaser] - The phaser settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    setPhaser(phaser?: PhaserOptions): Promise<this>;
+    /**
+     * Sets the NodeLink phonograph filter options on the audio.
+     * @param {PhonographOptions} [phonograph] - The phonograph settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    setPhonograph(phonograph?: PhonographOptions): Promise<this>;
+    /**
+     * Sets the NodeLink spatial filter options on the audio.
+     * @param {SpatialOptions} [spatial] - The spatial settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    setSpatial(spatial?: SpatialOptions): Promise<this>;
+    /**
+     * Sets the NodeLink tape filter options on the audio.
+     * @param {TapeOptions} [tape] - The tape settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    setTape(tape?: TapeOptions): Promise<this>;
+    setNodeLinkHighPass(highpass?: HighPassOptions): Promise<this>;
+    setNodeLinkEcho(echo?: EchoOptions): Promise<this>;
+    setNodeLinkReverb(reverb?: ReverbOptions): Promise<this>;
+    setNodeLinkChorus(chorus?: ChorusOptions): Promise<this>;
+    setNodeLinkCompressor(compressor?: CompressorOptions): Promise<this>;
+    setNodeLinkFlanger(flanger?: FlangerOptions): Promise<this>;
+    setNodeLinkPhaser(phaser?: PhaserOptions): Promise<this>;
+    setNodeLinkPhonograph(phonograph?: PhonographOptions): Promise<this>;
+    setNodeLinkSpatial(spatial?: SpatialOptions): Promise<this>;
+    setNodeLinkTape(tape?: TapeOptions): 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>): 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;
@@ -14,6 +15,15 @@ class Filters {
     vibrato;
     channelMix;
     lowPass;
+    highpass;
+    echo;
+    chorus;
+    compressor;
+    flanger;
+    phaser;
+    phonograph;
+    spatial;
+    tape;
     pluginFilters;
     reverb;
     volume;
@@ -31,6 +41,15 @@ class Filters {
         this.vibrato = null;
         this.channelMix = null;
         this.lowPass = null;
+        this.highpass = null;
+        this.echo = null;
+        this.chorus = null;
+        this.compressor = null;
+        this.flanger = null;
+        this.phaser = null;
+        this.phonograph = null;
+        this.spatial = null;
+        this.tape = null;
         this.pluginFilters = {};
         this.reverb = null;
         this.volume = 1.0;
@@ -56,23 +75,38 @@ class Filters {
      * of the Filters class for method chaining.
      */
     async updateFilters() {
-        const { channelMix, distortion, equalizer, karaoke, lowPass, pluginFilters, rotation, timescale, tremoloOptions, vibrato, volume } = this;
+        const { channelMix, chorus, compressor, distortion, echo, equalizer, flanger, highpass, karaoke, lowPass, phaser, phonograph, pluginFilters, reverb, rotation, spatial, tape, timescale, tremoloOptions, vibrato, volume, } = this;
+        const filters = {
+            distortion,
+            equalizer,
+            karaoke,
+            lowPass,
+            pluginFilters,
+            rotation,
+            timescale,
+            tremolo: tremoloOptions,
+            vibrato,
+            volume,
+            channelMix,
+            ...(this.player.node.isNodeLink
+                ? {
+                    chorus,
+                    compressor,
+                    echo,
+                    flanger,
+                    highpass,
+                    phaser,
+                    phonograph,
+                    reverb,
+                    spatial,
+                    tape,
+                }
+                : {}),
+        };
         try {
             await this.player.node.rest.updatePlayer({
                 data: {
-                    filters: {
-                        distortion,
-                        equalizer,
-                        karaoke,
-                        lowPass,
-                        pluginFilters,
-                        rotation,
-                        timescale,
-                        tremolo: tremoloOptions,
-                        vibrato,
-                        volume,
-                        channelMix,
-                    },
+                    filters,
                 },
                 guildId: this.player.guildId,
             });
@@ -113,6 +147,27 @@ 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 },
+            });
+        }
+    }
+    assertNodeLinkExtraFilterSupported(filterName) {
+        if (this.player.node.isNodeLink)
+            return;
+        throw new MagmastreamError_1.MagmaStreamError({
+            code: Enums_1.MagmaStreamErrorCode.NODE_PROTOCOL_ERROR,
+            message: `The "${filterName}" filter is only supported on NodeLink nodes.`,
+            context: { identifier: this.player.node.options.identifier },
+        });
+    }
     /**
      * Sets the status of a specific filter.
      *
@@ -162,6 +217,16 @@ class Filters {
         await this.setVibrato(null);
         await this.setChannelMix(null);
         await this.setLowPass(null);
+        await this.setHighPass(null);
+        await this.setEcho(null);
+        await this.setReverb(null);
+        await this.setChorus(null);
+        await this.setCompressor(null);
+        await this.setFlanger(null);
+        await this.setPhaser(null);
+        await this.setPhonograph(null);
+        await this.setSpatial(null);
+        await this.setTape(null);
         await this.setPluginFilters({});
         await this.updateFilters();
         this.emitPlayersTasteUpdate(oldPlayer);
@@ -270,15 +335,189 @@ class Filters {
         this.emitPlayersTasteUpdate(oldPlayer);
         return this;
     }
+    /**
+     * Sets the NodeLink high pass filter options on the audio.
+     * @param {HighPassOptions} [highpass] - The high pass settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    async setHighPass(highpass) {
+        const oldPlayer = { ...this };
+        if (highpass)
+            this.assertNodeLinkExtraFilterSupported("highpass");
+        await this.applyFilter({ property: "highpass", value: highpass ?? null });
+        this.setFilterStatus(Enums_1.AvailableFilters.SetHighPass, !!highpass);
+        this.emitPlayersTasteUpdate(oldPlayer);
+        return this;
+    }
+    /**
+     * Sets the NodeLink echo filter options on the audio.
+     * @param {EchoOptions} [echo] - The echo settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    async setEcho(echo) {
+        const oldPlayer = { ...this };
+        if (echo)
+            this.assertNodeLinkExtraFilterSupported("echo");
+        await this.applyFilter({ property: "echo", value: echo ?? null });
+        this.setFilterStatus(Enums_1.AvailableFilters.SetEcho, !!echo);
+        this.emitPlayersTasteUpdate(oldPlayer);
+        return this;
+    }
+    /**
+     * Sets the NodeLink reverb filter options on the audio.
+     * @param {ReverbOptions} [reverb] - The reverb settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    async setReverb(reverb) {
+        const oldPlayer = { ...this };
+        if (reverb)
+            this.assertNodeLinkExtraFilterSupported("reverb");
+        await this.applyFilter({ property: "reverb", value: reverb ?? null });
+        this.setFilterStatus(Enums_1.AvailableFilters.SetReverb, !!reverb);
+        this.emitPlayersTasteUpdate(oldPlayer);
+        return this;
+    }
+    /**
+     * Sets the NodeLink chorus filter options on the audio.
+     * @param {ChorusOptions} [chorus] - The chorus settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    async setChorus(chorus) {
+        const oldPlayer = { ...this };
+        if (chorus)
+            this.assertNodeLinkExtraFilterSupported("chorus");
+        await this.applyFilter({ property: "chorus", value: chorus ?? null });
+        this.setFilterStatus(Enums_1.AvailableFilters.SetChorus, !!chorus);
+        this.emitPlayersTasteUpdate(oldPlayer);
+        return this;
+    }
+    /**
+     * Sets the NodeLink compressor filter options on the audio.
+     * @param {CompressorOptions} [compressor] - The compressor settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    async setCompressor(compressor) {
+        const oldPlayer = { ...this };
+        if (compressor)
+            this.assertNodeLinkExtraFilterSupported("compressor");
+        await this.applyFilter({ property: "compressor", value: compressor ?? null });
+        this.setFilterStatus(Enums_1.AvailableFilters.SetCompressor, !!compressor);
+        this.emitPlayersTasteUpdate(oldPlayer);
+        return this;
+    }
+    /**
+     * Sets the NodeLink flanger filter options on the audio.
+     * @param {FlangerOptions} [flanger] - The flanger settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    async setFlanger(flanger) {
+        const oldPlayer = { ...this };
+        if (flanger)
+            this.assertNodeLinkExtraFilterSupported("flanger");
+        await this.applyFilter({ property: "flanger", value: flanger ?? null });
+        this.setFilterStatus(Enums_1.AvailableFilters.SetFlanger, !!flanger);
+        this.emitPlayersTasteUpdate(oldPlayer);
+        return this;
+    }
+    /**
+     * Sets the NodeLink phaser filter options on the audio.
+     * @param {PhaserOptions} [phaser] - The phaser settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    async setPhaser(phaser) {
+        const oldPlayer = { ...this };
+        if (phaser)
+            this.assertNodeLinkExtraFilterSupported("phaser");
+        await this.applyFilter({ property: "phaser", value: phaser ?? null });
+        this.setFilterStatus(Enums_1.AvailableFilters.SetPhaser, !!phaser);
+        this.emitPlayersTasteUpdate(oldPlayer);
+        return this;
+    }
+    /**
+     * Sets the NodeLink phonograph filter options on the audio.
+     * @param {PhonographOptions} [phonograph] - The phonograph settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    async setPhonograph(phonograph) {
+        const oldPlayer = { ...this };
+        if (phonograph)
+            this.assertNodeLinkExtraFilterSupported("phonograph");
+        await this.applyFilter({ property: "phonograph", value: phonograph ?? null });
+        this.setFilterStatus(Enums_1.AvailableFilters.SetPhonograph, !!phonograph);
+        this.emitPlayersTasteUpdate(oldPlayer);
+        return this;
+    }
+    /**
+     * Sets the NodeLink spatial filter options on the audio.
+     * @param {SpatialOptions} [spatial] - The spatial settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    async setSpatial(spatial) {
+        const oldPlayer = { ...this };
+        if (spatial)
+            this.assertNodeLinkExtraFilterSupported("spatial");
+        await this.applyFilter({ property: "spatial", value: spatial ?? null });
+        this.setFilterStatus(Enums_1.AvailableFilters.SetSpatial, !!spatial);
+        this.emitPlayersTasteUpdate(oldPlayer);
+        return this;
+    }
+    /**
+     * Sets the NodeLink tape filter options on the audio.
+     * @param {TapeOptions} [tape] - The tape settings to apply.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    async setTape(tape) {
+        const oldPlayer = { ...this };
+        if (tape)
+            this.assertNodeLinkExtraFilterSupported("tape");
+        await this.applyFilter({ property: "tape", value: tape ?? null });
+        this.setFilterStatus(Enums_1.AvailableFilters.SetTape, !!tape);
+        this.emitPlayersTasteUpdate(oldPlayer);
+        return this;
+    }
+    async setNodeLinkHighPass(highpass) {
+        return this.setHighPass(highpass);
+    }
+    async setNodeLinkEcho(echo) {
+        return this.setEcho(echo);
+    }
+    async setNodeLinkReverb(reverb) {
+        return this.setReverb(reverb);
+    }
+    async setNodeLinkChorus(chorus) {
+        return this.setChorus(chorus);
+    }
+    async setNodeLinkCompressor(compressor) {
+        return this.setCompressor(compressor);
+    }
+    async setNodeLinkFlanger(flanger) {
+        return this.setFlanger(flanger);
+    }
+    async setNodeLinkPhaser(phaser) {
+        return this.setPhaser(phaser);
+    }
+    async setNodeLinkPhonograph(phonograph) {
+        return this.setPhonograph(phonograph);
+    }
+    async setNodeLinkSpatial(spatial) {
+        return this.setSpatial(spatial);
+    }
+    async setNodeLinkTape(tape) {
+        return this.setTape(tape);
+    }
     /**
      * 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.d.ts

@@ -135,6 +135,12 @@ export declare class Manager extends EventEmitter {
      * @returns A promise that resolves when the player states have been loaded.
      */
     loadPlayerStates(nodeId: string): Promise<void>;
+    private isNodeLinkSearchSource;
+    private isPrefixedLoadTracksIdentifier;
+    private requiresNodeLinkSearchNode;
+    private requiresLavalinkSearchNode;
+    private getSearchNode;
+    private getPreferredNode;
     /**
      * Returns the node to use based on the configured `useNode` and `enablePriorityMode` options.
      * If `enablePriorityMode` is true, the node is chosen based on priority, otherwise it is chosen based on the `useNode` option.