magmastream 2.10.3-alpha.4 → 2.10.3-alpha.5

package/dist/structures/Enums.d.ts

@@ -250,10 +250,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

@@ -267,10 +267,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,18 @@ 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 {
     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;
@@ -112,6 +116,34 @@ 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.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    setPluginFilters(pluginFilters?: Record<string, unknown>): Promise<this>;
     /**
      * Sets the own rotation options effect to the audio.
      *

package/dist/structures/Filters.js

@@ -10,7 +10,11 @@ class Filters {
     karaoke;
     rotation;
     timescale;
+    tremoloOptions;
     vibrato;
+    channelMix;
+    lowPass;
+    pluginFilters;
     reverb;
     volume;
     bassBoostlevel;
@@ -23,7 +27,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 +56,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 +64,14 @@ class Filters {
                         distortion,
                         equalizer,
                         karaoke,
+                        lowPass,
+                        pluginFilters,
                         rotation,
                         timescale,
+                        tremolo: tremoloOptions,
                         vibrato,
                         volume,
+                        channelMix,
                     },
                 },
                 guildId: this.player.guildId,
@@ -146,7 +158,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 +231,59 @@ 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.
+     * @returns {Promise<this>} - Returns the current instance of the Filters class for method chaining.
+     */
+    async setPluginFilters(pluginFilters) {
+        const oldPlayer = { ...this };
+        const nextPluginFilters = pluginFilters ?? {};
+        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 +626,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

@@ -250,7 +250,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 +264,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 +407,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 +509,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 +606,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.js

@@ -1079,7 +1079,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.

package/dist/structures/Rest.d.ts

@@ -1,6 +1,6 @@
 import { Node } from "./Node";
 import { Manager } from "./Manager";
-import { LavalinkSession, LavaPlayer, RestPlayOptions } from "./Types";
+import { LavalinkInfo, LavalinkSession, LavaPlayer, NodeStats, RestPlayOptions, RoutePlannerStatus, TrackData } from "./Types";
 /** Handles the requests sent to the Lavalink REST API. */
 export declare class Rest {
     /** The Node that this Rest instance is connected to. */
@@ -32,6 +32,11 @@ export declare class Rest {
      * @returns {Promise<LavaPlayer>} Returns the player.
      */
     getPlayer(guildId: string): Promise<LavaPlayer>;
+    /**
+     * Retrieves all players that belong to the current session.
+     * @returns {Promise<LavaPlayer[]>} Returns the players.
+     */
+    getPlayers(): Promise<LavaPlayer[]>;
     /**
      * Sends a PATCH request to update player related data.
      * @param {RestPlayOptions} options The options to update the player with.
@@ -51,6 +56,44 @@ export declare class Rest {
      * @returns {Promise<LavalinkSession>} The updated session.
      */
     updateSession(resuming: boolean, timeout: number): Promise<LavalinkSession>;
+    /**
+     * Decodes a single Lavalink track.
+     * @param {string} encodedTrack The encoded track string.
+     * @returns {Promise<TrackData>} The decoded track.
+     */
+    decodeTrack(encodedTrack: string): Promise<TrackData>;
+    /**
+     * Decodes multiple Lavalink tracks.
+     * @param {string[]} encodedTracks The encoded track strings.
+     * @returns {Promise<TrackData[]>} The decoded tracks.
+     */
+    decodeTracks(encodedTracks: string[]): Promise<TrackData[]>;
+    /**
+     * Retrieves this node's Lavalink info.
+     * @returns {Promise<LavalinkInfo>} The node info.
+     */
+    getInfo(): Promise<LavalinkInfo>;
+    /**
+     * Retrieves this node's current stats.
+     * @returns {Promise<NodeStats>} The node stats.
+     */
+    getStats(): Promise<NodeStats>;
+    /**
+     * Retrieves the route planner status.
+     * @returns {Promise<RoutePlannerStatus>} The route planner status.
+     */
+    getRoutePlannerStatus(): Promise<RoutePlannerStatus>;
+    /**
+     * Unmarks a failed route planner address.
+     * @param {string} address The address to free.
+     * @returns {Promise<void>} Void.
+     */
+    freeRoutePlannerAddress(address: string): Promise<void>;
+    /**
+     * Unmarks all failed route planner addresses.
+     * @returns {Promise<void>} Void.
+     */
+    freeAllRoutePlannerAddresses(): Promise<void>;
     /**
      * Sends a request to the specified endpoint and returns the response data.
      * @param {string} method The HTTP method to use for the request.
@@ -78,7 +121,7 @@ export declare class Rest {
      * @param {unknown} body The data to send in the request body.
      * @returns {Promise<T>} The response data of the POST request.
      */
-    post<T>(endpoint: string, body: unknown): Promise<T>;
+    post<T>(endpoint: string, body?: unknown): Promise<T>;
     /**
      * Sends a PUT request to the specified endpoint and returns the response data.
      * @param {string} endpoint The endpoint to send the PUT request to.

package/dist/structures/Rest.js

@@ -55,6 +55,18 @@ class Rest {
         this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[REST] Getting player on node: ${this.node.options.identifier} : ${Utils_1.JSONUtils.safe(result, 2)}`);
         return result;
     }
+    /**
+     * Retrieves all players that belong to the current session.
+     * @returns {Promise<LavaPlayer[]>} Returns the players.
+     */
+    async getPlayers() {
+        if (!this.sessionId) {
+            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 ?? []);
+    }
     /**
      * Sends a PATCH request to update player related data.
      * @param {RestPlayOptions} options The options to update the player with.
@@ -95,6 +107,77 @@ class Rest {
         this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[REST] Updating session: ${this.sessionId}`);
         return await this.patch(`/v4/sessions/${this.sessionId}`, { resuming, timeout });
     }
+    /**
+     * Decodes a single Lavalink track.
+     * @param {string} encodedTrack The encoded track string.
+     * @returns {Promise<TrackData>} The decoded track.
+     */
+    async decodeTrack(encodedTrack) {
+        if (typeof encodedTrack !== "string" || encodedTrack.length === 0) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.REST_REQUEST_FAILED,
+                message: "Cannot decode an empty track.",
+            });
+        }
+        return await this.get(`/v4/decodetrack?encodedTrack=${encodeURIComponent(encodedTrack)}`);
+    }
+    /**
+     * Decodes multiple Lavalink tracks.
+     * @param {string[]} encodedTracks The encoded track strings.
+     * @returns {Promise<TrackData[]>} The decoded tracks.
+     */
+    async decodeTracks(encodedTracks) {
+        if (!Array.isArray(encodedTracks) || encodedTracks.length === 0) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.REST_REQUEST_FAILED,
+                message: "Cannot decode an empty track list.",
+            });
+        }
+        const result = await this.post("/v4/decodetracks", encodedTracks);
+        return Array.isArray(result) ? result : (result?.tracks ?? []);
+    }
+    /**
+     * Retrieves this node's Lavalink info.
+     * @returns {Promise<LavalinkInfo>} The node info.
+     */
+    async getInfo() {
+        return await this.get("/v4/info");
+    }
+    /**
+     * Retrieves this node's current stats.
+     * @returns {Promise<NodeStats>} The node stats.
+     */
+    async getStats() {
+        return await this.get("/v4/stats");
+    }
+    /**
+     * Retrieves the route planner status.
+     * @returns {Promise<RoutePlannerStatus>} The route planner status.
+     */
+    async getRoutePlannerStatus() {
+        return await this.get("/v4/routeplanner/status");
+    }
+    /**
+     * Unmarks a failed route planner address.
+     * @param {string} address The address to free.
+     * @returns {Promise<void>} Void.
+     */
+    async freeRoutePlannerAddress(address) {
+        if (typeof address !== "string" || address.length === 0) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.REST_REQUEST_FAILED,
+                message: "Cannot free an empty route planner address.",
+            });
+        }
+        await this.post("/v4/routeplanner/free/address", { address });
+    }
+    /**
+     * Unmarks all failed route planner addresses.
+     * @returns {Promise<void>} Void.
+     */
+    async freeAllRoutePlannerAddresses() {
+        await this.post("/v4/routeplanner/free/all");
+    }
     /**
      * Sends a request to the specified endpoint and returns the response data.
      * @param {string} method The HTTP method to use for the request.
@@ -132,7 +215,7 @@ class Rest {
             return data;
         }
         if (status === 404) {
-            if (data?.message === "Guild not found") {
+            if (data?.message === "Guild not found" || data?.message === "Player not found") {
                 return [];
             }
             if (data?.message === "Session not found") {

package/dist/structures/Types.d.ts

@@ -388,13 +388,13 @@ export interface Track {
     /** The duration of the track. */
     readonly duration: number;
     /** The ISRC of the track. */
-    readonly isrc: string;
+    readonly isrc: string | null;
     /** If the track is seekable. */
     readonly isSeekable: boolean;
     /** If the track is a stream.. */
     readonly isStream: boolean;
     /** The uri of the track. */
-    readonly uri: string;
+    readonly uri: string | null;
     /** The thumbnail of the track or null if it's a unsupported source. */
     readonly thumbnail: string | null;
     /** The user that requested the track. */
@@ -412,6 +412,7 @@ export interface Track {
  * Track Plugin Info
  */
 export interface TrackPluginInfo {
+    [key: string]: unknown;
     albumName?: string;
     albumUrl?: string;
     artistArtworkUrl?: string;
@@ -433,7 +434,7 @@ export interface SearchQuery {
  */
 export interface LavalinkResponse {
     loadType: LoadTypes;
-    data: TrackData[] | PlaylistRawData;
+    data: LavalinkLoadResultData;
 }
 /**
  * Track Data
@@ -444,7 +445,9 @@ export interface TrackData {
     /** The detailed information of the track. */
     info: TrackDataInfo;
     /** Additional track info provided by plugins. */
-    pluginInfo: Record<string, string>;
+    pluginInfo: Record<string, unknown>;
+    /** Additional track data sent back from Lavalink. */
+    userData: Record<string, unknown>;
 }
 /**
  * Playlist Raw Data
@@ -453,12 +456,15 @@ export interface PlaylistRawData {
     info: {
         /** The playlist name. */
         name: string;
+        /** The selected track index, or -1 if none is selected. */
+        selectedTrack: number;
     };
     /** Addition info provided by plugins. */
-    pluginInfo: object;
+    pluginInfo: Record<string, unknown>;
     /** The tracks of the playlist */
     tracks: TrackData[];
 }
+export type LavalinkLoadResultData = TrackData | TrackData[] | PlaylistRawData | Exception | null;
 /**
  * Track Data Info
  */
@@ -467,19 +473,20 @@ export interface TrackDataInfo {
     isSeekable: boolean;
     author: string;
     length: number;
-    isrc?: string;
+    position: number;
+    isrc: string | null;
     isStream: boolean;
     title: string;
-    uri?: string;
-    artworkUrl?: string;
-    sourceName?: TrackSourceName;
+    uri: string | null;
+    artworkUrl: string | null;
+    sourceName: TrackSourceName;
 }
 /**
  * LavaPlayer
  */
 export interface LavaPlayer {
     guildId: string;
-    track: TrackData;
+    track: TrackData | null;
     volume: number;
     paused: boolean;
     state: {
@@ -489,7 +496,7 @@ export interface LavaPlayer {
         ping: number;
     };
     voice: LavalinkVoiceStateResponse;
-    filters: Record<string, unknown>;
+    filters: LavalinkFilters;
 }
 /**
  * Error or Empty Search Result
@@ -584,8 +591,10 @@ export interface PlaylistData {
     name: string;
     /** Requester of playlist. */
     requester: AnyUser;
-    /** More playlist information. */
-    playlistInfo: PlaylistInfoData[];
+    /** Lavalink playlist information. */
+    playlistInfo: PlaylistInfoData;
+    /** Additional playlist information provided by plugins. */
+    pluginInfo: PlaylistPluginInfo;
     /** The length of the playlist. */
     duration: number;
     /** The songs of the playlist. */
@@ -595,16 +604,17 @@ export interface PlaylistData {
  * Playlist Info Data
  */
 export interface PlaylistInfoData {
-    /** Url to playlist. */
-    url: string;
-    /** Type is always playlist in that case. */
-    type: string;
-    /** ArtworkUrl of playlist */
-    artworkUrl: string;
-    /** Number of total tracks in playlist */
-    totalTracks: number;
-    /** Author of playlist */
-    author: string;
+    /** The playlist name. */
+    name: string;
+    /** The selected track index, or -1 if none is selected. */
+    selectedTrack: number;
+}
+export interface PlaylistPluginInfo extends Record<string, unknown> {
+    url?: string;
+    type?: string;
+    artworkUrl?: string;
+    totalTracks?: number;
+    author?: string;
 }
 /**
  * Manager Events
@@ -703,7 +713,7 @@ export interface NodeStats {
     /** The cpu stats for the node. */
     cpu: CPUStats;
     /** The frame stats for the node. */
-    frameStats: FrameStats;
+    frameStats: FrameStats | null;
 }
 /**
  * Node Message
@@ -725,9 +735,10 @@ export interface PlayerEvent {
  * Exception interface
  */
 export interface Exception {
-    message: string;
+    message: string | null;
     severity: SeverityTypes;
     cause: string;
+    causeStackTrace?: string;
 }
 /**
  * TrackStartEvent interface
@@ -833,7 +844,7 @@ export interface NodeStats {
     /** The cpu stats for the node. */
     cpu: CPUStats;
     /** The frame stats for the node. */
-    frameStats: FrameStats;
+    frameStats: FrameStats | null;
 }
 /**
  * MemoryStats interface
@@ -879,7 +890,7 @@ export interface LavalinkInfo {
         major: number;
         minor: number;
         patch: number;
-        preRelease: string;
+        preRelease: string | null;
     };
     buildTime: number;
     git: {
@@ -1101,7 +1112,7 @@ export interface RestPlayOptions {
         /** Whether the player is paused. */
         paused?: boolean;
         /** The audio effects. */
-        filters?: object;
+        filters?: LavalinkFilters;
         /** voice payload. */
         voice?: LavalinkVoiceStateUpdate;
     };
@@ -1140,11 +1151,15 @@ export interface SerializedPlayerState {
     filters: {
         bassBoostlevel: number | null;
         equalizer: EqualizerBand[];
-        distortion: DistortionOptions;
-        karaoke: KaraokeOptions;
-        timescale: TimescaleOptions;
-        vibrato: VibratoOptions;
-        rotation: RotationOptions;
+        distortion: DistortionOptions | null;
+        karaoke: KaraokeOptions | null;
+        timescale: TimescaleOptions | null;
+        tremolo: TremoloOptions | null;
+        vibrato: VibratoOptions | null;
+        rotation: RotationOptions | null;
+        channelMix: ChannelMixOptions | null;
+        lowPass: LowPassOptions | null;
+        pluginFilters: Record<string, unknown>;
         reverb: ReverbOptions;
         volume: number;
         filterStatus: Record<string, boolean>;
@@ -1183,6 +1198,26 @@ export interface LavalinkSession {
     resuming?: boolean;
     timeout?: number;
 }
+export interface RoutePlannerStatus {
+    class: "RotatingIpRoutePlanner" | "NanoIpRoutePlanner" | "RotatingNanoIpRoutePlanner" | "BalancingIpRoutePlanner";
+    details: RoutePlannerDetails;
+}
+export interface RoutePlannerDetails {
+    ipBlock: {
+        type: "Inet4Address" | "Inet6Address";
+        size: string;
+    };
+    failingAddresses: {
+        failingAddress: string;
+        failingTimestamp: number;
+        failingTime: string;
+    }[];
+    rotateIndex?: string;
+    ipIndex?: string;
+    currentAddress?: string;
+    currentAddressIndex?: string;
+    blockIndex?: string;
+}
 /**
  * ManagerInitOptions interface
  */
@@ -1205,10 +1240,15 @@ export interface TimescaleOptions {
     pitch?: number;
     rate?: number;
 }
+/** Options for applying tremolo effect to audio. */
+export interface TremoloOptions {
+    frequency?: number;
+    depth?: number;
+}
 /** Options for applying vibrato effect to audio. */
 export interface VibratoOptions {
-    frequency: number;
-    depth: number;
+    frequency?: number;
+    depth?: number;
 }
 /** Options for applying rotation effect to audio. */
 export interface RotationOptions {
@@ -1232,6 +1272,30 @@ export interface DistortionOptions {
     offset?: number;
     scale?: number;
 }
+/** Options for mixing stereo channels. */
+export interface ChannelMixOptions {
+    leftToLeft?: number;
+    leftToRight?: number;
+    rightToLeft?: number;
+    rightToRight?: number;
+}
+/** Options for applying a low pass filter. */
+export interface LowPassOptions {
+    smoothing?: number;
+}
+export interface LavalinkFilters {
+    volume?: number;
+    equalizer?: EqualizerBand[];
+    karaoke?: KaraokeOptions | null;
+    timescale?: TimescaleOptions | null;
+    tremolo?: TremoloOptions | null;
+    vibrato?: VibratoOptions | null;
+    distortion?: DistortionOptions | null;
+    rotation?: RotationOptions | null;
+    channelMix?: ChannelMixOptions | null;
+    lowPass?: LowPassOptions | null;
+    pluginFilters?: Record<string, unknown>;
+}
 /** Options for applying reverb effect to audio. */
 export interface ReverbOptions {
     wet?: number;
@@ -1305,7 +1369,7 @@ export type Sizes = "0" | "1" | "2" | "3" | "default" | "mqdefault" | "hqdefault
 /**
  * Track Source Name Enum type
  */
-export type TrackSourceName = keyof typeof TrackSourceTypes;
+export type TrackSourceName = `${TrackSourceTypes}` | string;
 /**
  * Use Node Option Enum type
  */

package/dist/structures/Utils.js

@@ -63,7 +63,7 @@ class TrackUtils {
         if (typeof track !== "object" || track === null)
             return false;
         const trackRecord = track;
-        return REQUIRED_TRACK_KEYS.every((key) => typeof trackRecord[key] === "string");
+        return REQUIRED_TRACK_KEYS.every((key) => (key === "uri" ? typeof trackRecord[key] === "string" || trackRecord[key] === null : typeof trackRecord[key] === "string"));
     }
     /**
      * Checks if the provided argument is a valid Track array.
@@ -131,14 +131,14 @@ class TrackUtils {
                 uri: data.info.uri,
                 artworkUrl: data.info?.artworkUrl ?? null,
                 sourceName: sourceNameMap[data.info?.sourceName?.toLowerCase() ?? ""] ?? data.info?.sourceName,
-                thumbnail: data.info.uri.includes("youtube") ? `https://img.youtube.com/vi/${data.info.identifier}/default.jpg` : null,
+                thumbnail: data.info.uri?.includes("youtube") ? `https://img.youtube.com/vi/${data.info.identifier}/default.jpg` : null,
                 displayThumbnail(size = "default") {
                     const finalSize = SIZES.find((s) => s === size) ?? "default";
-                    return this.uri.includes("youtube") ? `https://img.youtube.com/vi/${data.info.identifier}/${finalSize}.jpg` : null;
+                    return this.uri?.includes("youtube") ? `https://img.youtube.com/vi/${data.info.identifier}/${finalSize}.jpg` : null;
                 },
                 requester: requester,
                 pluginInfo: data.pluginInfo,
-                customData: {},
+                customData: data.userData ?? {},
                 isAutoplay: isAutoplay,
             };
             track.displayThumbnail = track.displayThumbnail.bind(track);
@@ -180,7 +180,7 @@ class TrackUtils {
             return track;
         track.displayThumbnail = function (size = "default") {
             const finalSize = SIZES.find((s) => s === size) ?? "default";
-            return this.uri.includes("youtube") ? `https://img.youtube.com/vi/${this.identifier}/${finalSize}.jpg` : null;
+            return this.uri?.includes("youtube") ? `https://img.youtube.com/vi/${this.identifier}/${finalSize}.jpg` : null;
         }.bind(track);
         return track;
     }
@@ -318,6 +318,8 @@ class AutoPlayUtils {
      */
     static async getRecommendedTracksFromSource(track, platform) {
         const requester = track.requester;
+        if (!track.uri)
+            return [];
         const parsedURL = new URL(track.uri);
         switch (platform) {
             case Enums_1.AutoPlayPlatform.Spotify: {
@@ -412,14 +414,14 @@ class AutoPlayUtils {
             }
             case Enums_1.AutoPlayPlatform.YouTube: {
                 const allowedYouTubeHosts = ["youtube.com", "youtu.be"];
-                const hasYouTubeURL = allowedYouTubeHosts.some((url) => track.uri.includes(url));
+                const hasYouTubeURL = allowedYouTubeHosts.some((url) => track.uri?.includes(url));
                 let videoID = null;
                 if (hasYouTubeURL) {
-                    videoID = track.uri.split("=").pop();
+                    videoID = track.uri?.split("=").pop() ?? null;
                 }
                 else {
                     const resolvedTrack = await this.resolveFirstTrackFromQuery(`${track.author} - ${track.title}`, Enums_1.SearchPlatform.YouTube, requester);
-                    if (!resolvedTrack)
+                    if (!resolvedTrack?.uri)
                         return [];
                     videoID = resolvedTrack.uri.split("=").pop();
                 }
@@ -431,7 +433,7 @@ class AutoPlayUtils {
                 do {
                     randomIndex = Math.floor(Math.random() * 23) + 2;
                     searchURI = `https://www.youtube.com/watch?v=${videoID}&list=RD${videoID}&index=${randomIndex}`;
-                } while (track.uri.includes(searchURI));
+                } while (track.uri?.includes(searchURI));
                 const resolvedTracks = await this.resolveTracksFromQuery(searchURI, Enums_1.SearchPlatform.YouTube, requester);
                 const filteredTracks = resolvedTracks.filter((resolvedTrack) => resolvedTrack.uri !== track.uri);
                 return filteredTracks;
@@ -721,6 +723,8 @@ class PlayerUtils {
                 paused: player.paused,
                 playing: player.playing,
                 position: player.position,
+                isAutoplay: player.isAutoplay,
+                autoplayTries: player.autoplayTries,
                 trackRepeat: player.trackRepeat,
                 queueRepeat: player.queueRepeat,
                 dynamicRepeat: player.dynamicRepeat,
@@ -737,7 +741,11 @@ class PlayerUtils {
                         karaoke: player.filters.karaoke ?? null,
                         rotation: player.filters.rotation ?? null,
                         timescale: player.filters.timescale ?? null,
+                        tremolo: player.filters.tremoloOptions ?? null,
                         vibrato: player.filters.vibrato ?? null,
+                        channelMix: player.filters.channelMix ?? null,
+                        lowPass: player.filters.lowPass ?? null,
+                        pluginFilters: player.filters.pluginFilters ?? {},
                         reverb: player.filters.reverb ?? null,
                         volume: player.filters.volume ?? 1.0,
                         bassBoostlevel: player.filters.bassBoostlevel ?? null,

package/package.json

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