lavalink-client 2.6.6 → 2.7.0

package/README.md

@@ -108,15 +108,19 @@ pnpm add tomato6966/lavalink-client
 ## 💖 Used In
 This client powers various Discord bots:
 - **[Mivator](https://discord.gg/5dUb7M2qCj)** (Public Bot by @Tomato6966)
-- **[Betty](https://betty.cx/)** (Public Bot by fb_sean)
+- **[Betty](https://betty.bot/?utm_source=lavalink-client)** (Public Bot by @fb_sean)
+- **[Nero](https://betty.bot/?utm_source=lavalink-client)** (Public Bot by @fb_sean)
 - **Bots by Contributors:**
   - [Mintone](https://mintone.tech/) (@appujet)
   - [Stelle](https://github.com/Ganyu-Studios/stelle-music) (@EvilG-MC)
   - [Panais](https://panais.xyz/) (@LucasB25)
   - [Akyn](https://akynbot.vercel.app/) (@notdeltaxd)
+  - [ARINO](https://site.arinoapp.qzz.io/) (@ryanwtf88)
+  - [iHorizon](https://github.com/ihrz/ihrz) (@iHorizon)
 - **Bots Community (Users):**
   - [Soundy](https://github.com/idMJA/Soundy) (@idMJA)
   - [BeatBot ](https://getbeatbot.vercel.app/) (@zenitsujs)
+  - [Atom Music](https://top.gg/bot/1320469557411971165) (@sakshamyep)
 
 ***
 
@@ -457,3 +461,6 @@ if (response.tracks.length > 0) {
 </details>
 
 </div>
+
+
+

package/dist/index.d.mts

@@ -210,6 +210,7 @@ declare enum DebugEvents {
     PlayerUpdateSuccess = "PlayerUpdateSuccess",
     HeartBeatTriggered = "HeartBeatTriggered",
     NoSocketOnDestroy = "NoSocketOnDestroy",
+    SocketCleanupError = "SocketCleanupError",
     SocketTerminateHeartBeatTimeout = "SocketTerminateHeartBeatTimeout",
     TryingConnectWhileConnected = "TryingConnectWhileConnected",
     LavaSearchNothingFound = "LavaSearchNothingFound",
@@ -332,6 +333,7 @@ declare class FilterManager {
      * ```
      */
     applyPlayerFilters(): Promise<void>;
+    privateNot0(value: number | undefined): boolean;
     /**
      * Checks if the filters are correctly stated (active / not-active) - mostly used internally.
      * @param oldFilterTimescale
@@ -703,138 +705,6 @@ declare class FilterManager {
     clearEQ(): Promise<this>;
 }
 
-/** Sourcenames provided by lavalink server */
-type LavalinkSourceNames = "youtube" | "youtubemusic" | "soundcloud" | "bandcamp" | "twitch";
-/** Source Names provided by lava src plugin */
-type LavalinkPlugin_LavaSrc_SourceNames = "deezer" | "spotify" | "applemusic" | "yandexmusic" | "flowery-tts" | "vkmusic" | "tidal" | "qobuz" | "pandora";
-/** Source Names provided by jiosaavan plugin */
-type LavalinkPlugin_JioSaavn_SourceNames = "jiosaavn";
-/** The SourceNames provided by lavalink */
-type SourceNames = LavalinkSourceNames | LavalinkPlugin_LavaSrc_SourceNames | LavalinkPlugin_JioSaavn_SourceNames;
-interface LavalinkTrackInfo {
-    /** The Identifier of the Track */
-    identifier: string;
-    /** The Track Title / Name */
-    title: string;
-    /** The Name of the Author */
-    author: string;
-    /** The duration of the Track */
-    length: number;
-    /** The URL of the artwork if available */
-    artworkUrl: string | null;
-    /** The URL (aka Link) of the Track called URI */
-    uri: string;
-    /** The Source name of the Track, e.g. soundcloud, youtube, spotify */
-    sourceName: SourceNames;
-    /** Wether the audio is seekable */
-    isSeekable: boolean;
-    /** Wether the audio is of a live stream */
-    isStream: boolean;
-    /** If isrc code is available, it's provided */
-    isrc: string | null;
-}
-interface TrackInfo {
-    /** The Identifier of the Track */
-    identifier: string;
-    /** The Track Title / Name */
-    title: string;
-    /** The Name of the Author */
-    author: string;
-    /** The duration of the Track */
-    duration: number;
-    /** The URL of the artwork if available */
-    artworkUrl: string | null;
-    /** The URL (aka Link) of the Track called URI */
-    uri: string;
-    /** The Source name of the Track, e.g. soundcloud, youtube, spotify */
-    sourceName: SourceNames;
-    /** Wether the audio is seekable */
-    isSeekable: boolean;
-    /** Wether the audio is of a live stream */
-    isStream: boolean;
-    /** If isrc code is available, it's provided */
-    isrc: string | null;
-}
-interface PluginInfo {
-    /** The Type provided by a plugin */
-    type?: "album" | "playlist" | "artist" | "recommendations" | string;
-    /** The Identifier provided by a plugin */
-    albumName?: string;
-    /** The url of the album */
-    albumUrl?: string;
-    /** The url of the album art */
-    albumArtUrl?: string;
-    /** The url of the artist */
-    artistUrl?: string;
-    /** The url of the artist artwork */
-    artistArtworkUrl?: string;
-    /** The url of the preview */
-    previewUrl?: string;
-    /** Whether the track is a preview */
-    isPreview?: boolean;
-    /** The total number of tracks in the playlist */
-    totalTracks?: number;
-    /** The Identifier provided by a plugin */
-    identifier?: string;
-    /** The ArtworkUrl provided by a plugin */
-    artworkUrl?: string;
-    /** The Author Information provided by a plugin */
-    author?: string;
-    /** The Url provided by a Plugin */
-    url?: string;
-    /** The Url provided by a Plugin */
-    uri?: string;
-    /** You can put specific track information here, to transform the tracks... */
-    clientData?: {
-        previousTrack?: boolean;
-        [key: string]: any;
-    };
-}
-interface LavalinkTrack {
-    /** The Base 64 encoded String */
-    encoded?: Base64;
-    /** Track Information */
-    info: LavalinkTrackInfo;
-    /** Plugin Information from Lavalink */
-    pluginInfo: Partial<PluginInfo>;
-    /** The userData Object from when you provide to the lavalink request */
-    userData?: anyObject;
-}
-interface Track {
-    /** The Base 64 encoded String */
-    encoded?: Base64;
-    /** Track Information */
-    info: TrackInfo;
-    /** Plugin Information from Lavalink */
-    pluginInfo: Partial<PluginInfo>;
-    /** The Track's Requester */
-    requester?: unknown;
-    /** The userData Object from when you provide to the lavalink request */
-    userData?: anyObject;
-}
-interface UnresolvedTrackInfo extends Partial<TrackInfo> {
-    /** Required */
-    title: string;
-}
-interface UnresolvedQuery extends UnresolvedTrackInfo {
-    /** The base64 of the unresolved track to "encode" */
-    encoded?: Base64;
-}
-interface UnresolvedTrack {
-    /** Required */
-    resolve: (player: Player) => Promise<void>;
-    /** The Base 64 encoded String */
-    encoded?: Base64;
-    /** Track Information */
-    info: UnresolvedTrackInfo;
-    /** Plugin Information from Lavalink */
-    pluginInfo: Partial<PluginInfo>;
-    /** The userData Object from when you provide to the lavalink request */
-    userData?: anyObject;
-    /** The Track's Requester */
-    requester?: unknown;
-}
-
 declare class QueueSaver {
     /**
      * The queue store manager
@@ -976,6 +846,7 @@ declare class Queue {
      *  - single Track | UnresolvedTrack
      *  - multiple Track | UnresovedTrack
      *  - at the index or multiple indexes
+     *  - Since v2.7 the removed tracks get unshifted into the previous queue state instead of pushed (indexed at the start instead of end - as it should)
      * @param removeQueryTrack
      * @returns null (if nothing was removed) / { removed } where removed is an array with all removed elements
      *
@@ -1248,6 +1119,138 @@ declare class Player {
     toJSON(): PlayerJson;
 }
 
+/** Sourcenames provided by lavalink server */
+type LavalinkSourceNames = "youtube" | "youtubemusic" | "soundcloud" | "bandcamp" | "twitch";
+/** Source Names provided by lava src plugin */
+type LavalinkPlugin_LavaSrc_SourceNames = "deezer" | "spotify" | "applemusic" | "yandexmusic" | "flowery-tts" | "vkmusic" | "tidal" | "qobuz" | "pandora";
+/** Source Names provided by jiosaavan plugin */
+type LavalinkPlugin_JioSaavn_SourceNames = "jiosaavn";
+/** The SourceNames provided by lavalink */
+type SourceNames = LavalinkSourceNames | LavalinkPlugin_LavaSrc_SourceNames | LavalinkPlugin_JioSaavn_SourceNames;
+interface LavalinkTrackInfo {
+    /** The Identifier of the Track */
+    identifier: string;
+    /** The Track Title / Name */
+    title: string;
+    /** The Name of the Author */
+    author: string;
+    /** The duration of the Track */
+    length: number;
+    /** The URL of the artwork if available */
+    artworkUrl: string | null;
+    /** The URL (aka Link) of the Track called URI */
+    uri: string;
+    /** The Source name of the Track, e.g. soundcloud, youtube, spotify */
+    sourceName: SourceNames;
+    /** Wether the audio is seekable */
+    isSeekable: boolean;
+    /** Wether the audio is of a live stream */
+    isStream: boolean;
+    /** If isrc code is available, it's provided */
+    isrc: string | null;
+}
+interface TrackInfo {
+    /** The Identifier of the Track */
+    identifier: string;
+    /** The Track Title / Name */
+    title: string;
+    /** The Name of the Author */
+    author: string;
+    /** The duration of the Track */
+    duration: number;
+    /** The URL of the artwork if available */
+    artworkUrl: string | null;
+    /** The URL (aka Link) of the Track called URI */
+    uri: string;
+    /** The Source name of the Track, e.g. soundcloud, youtube, spotify */
+    sourceName: SourceNames;
+    /** Wether the audio is seekable */
+    isSeekable: boolean;
+    /** Wether the audio is of a live stream */
+    isStream: boolean;
+    /** If isrc code is available, it's provided */
+    isrc: string | null;
+}
+interface PluginInfo {
+    /** The Type provided by a plugin */
+    type?: "album" | "playlist" | "artist" | "recommendations" | string;
+    /** The Identifier provided by a plugin */
+    albumName?: string;
+    /** The url of the album */
+    albumUrl?: string;
+    /** The url of the album art */
+    albumArtUrl?: string;
+    /** The url of the artist */
+    artistUrl?: string;
+    /** The url of the artist artwork */
+    artistArtworkUrl?: string;
+    /** The url of the preview */
+    previewUrl?: string;
+    /** Whether the track is a preview */
+    isPreview?: boolean;
+    /** The total number of tracks in the playlist */
+    totalTracks?: number;
+    /** The Identifier provided by a plugin */
+    identifier?: string;
+    /** The ArtworkUrl provided by a plugin */
+    artworkUrl?: string;
+    /** The Author Information provided by a plugin */
+    author?: string;
+    /** The Url provided by a Plugin */
+    url?: string;
+    /** The Url provided by a Plugin */
+    uri?: string;
+    /** You can put specific track information here, to transform the tracks... */
+    clientData?: {
+        previousTrack?: boolean;
+        [key: string]: any;
+    };
+}
+interface LavalinkTrack {
+    /** The Base 64 encoded String */
+    encoded?: Base64;
+    /** Track Information */
+    info: LavalinkTrackInfo;
+    /** Plugin Information from Lavalink */
+    pluginInfo: Partial<PluginInfo>;
+    /** The userData Object from when you provide to the lavalink request */
+    userData?: anyObject;
+}
+interface Track {
+    /** The Base 64 encoded String */
+    encoded?: Base64;
+    /** Track Information */
+    info: TrackInfo;
+    /** Plugin Information from Lavalink */
+    pluginInfo: Partial<PluginInfo>;
+    /** The Track's Requester */
+    requester?: unknown;
+    /** The userData Object from when you provide to the lavalink request */
+    userData?: anyObject;
+}
+interface UnresolvedTrackInfo extends Partial<TrackInfo> {
+    /** Required */
+    title: string;
+}
+interface UnresolvedQuery extends UnresolvedTrackInfo {
+    /** The base64 of the unresolved track to "encode" */
+    encoded?: Base64;
+}
+interface UnresolvedTrack {
+    /** Required */
+    resolve: (player: Player) => Promise<void>;
+    /** The Base 64 encoded String */
+    encoded?: Base64;
+    /** Track Information */
+    info: UnresolvedTrackInfo;
+    /** Plugin Information from Lavalink */
+    pluginInfo: Partial<PluginInfo>;
+    /** The userData Object from when you provide to the lavalink request */
+    userData?: anyObject;
+    /** The Track's Requester */
+    requester?: unknown;
+}
+
 interface StoredQueue {
     current: Track | null;
     previous: Track[];
@@ -1265,7 +1268,7 @@ interface QueueStoreManager {
     /** @async Parse the saved value back to the Queue (IF YOU DON'T NEED PARSING/STRINGIFY, then just return the value) */
     parse: (value: StoredQueue | string) => Awaitable<Partial<StoredQueue>>;
 }
-interface ManagerQueueOptions<CustomPlayerT extends Player = Player> {
+interface ManagerQueueOptions {
     /** Maximum Amount of tracks for the queue.previous array. Set to 0 to not save previous songs. Defaults to 25 Tracks */
     maxPreviousTracks?: number;
     /** Custom Queue Store option */
@@ -1915,38 +1918,12 @@ interface LyricsFoundEvent extends PlayerEvent {
     /** The lyrics */
     lyrics: LyricsResult;
 }
-interface LyricsFoundEvent extends PlayerEvent {
-    /** The lyricsfound event */
-    type: "LyricsFoundEvent";
-    /** The guildId */
-    guildId: string;
-    /** The lyrics */
-    lyrics: LyricsResult;
-}
 interface LyricsNotFoundEvent extends PlayerEvent {
     /**The lyricsnotfound event*/
     type: "LyricsNotFoundEvent";
     /**The guildId*/
     guildId: string;
 }
-interface LyricsNotFoundEvent extends PlayerEvent {
-    /**The lyricsnotfound event*/
-    type: "LyricsNotFoundEvent";
-    /**The guildId*/
-    guildId: string;
-}
-interface LyricsLineEvent extends PlayerEvent {
-    /**The lyricsline event*/
-    type: "LyricsLineEvent";
-    /** The guildId */
-    guildId: string;
-    /** The line number */
-    lineIndex: number;
-    /** The line */
-    line: LyricsLine;
-    /**skipped is true if the line was skipped */
-    skipped: boolean;
-}
 interface LyricsLineEvent extends PlayerEvent {
     /**The lyricsline event*/
     type: "LyricsLineEvent";
@@ -3039,7 +3016,7 @@ interface ManagerOptions<CustomPlayerT extends Player = Player> {
     /** The Bot Client's Data for Authorization */
     client?: BotClientOptions;
     /** QueueOptions for all Queues */
-    queueOptions?: ManagerQueueOptions<CustomPlayerT>;
+    queueOptions?: ManagerQueueOptions;
     /** PlayerOptions for all Players */
     playerOptions?: ManagerPlayerOptions<CustomPlayerT>;
     /** The player class you want to use when creating a player. (can be extendable) */

package/dist/index.d.ts

@@ -210,6 +210,7 @@ declare enum DebugEvents {
     PlayerUpdateSuccess = "PlayerUpdateSuccess",
     HeartBeatTriggered = "HeartBeatTriggered",
     NoSocketOnDestroy = "NoSocketOnDestroy",
+    SocketCleanupError = "SocketCleanupError",
     SocketTerminateHeartBeatTimeout = "SocketTerminateHeartBeatTimeout",
     TryingConnectWhileConnected = "TryingConnectWhileConnected",
     LavaSearchNothingFound = "LavaSearchNothingFound",
@@ -332,6 +333,7 @@ declare class FilterManager {
      * ```
      */
     applyPlayerFilters(): Promise<void>;
+    privateNot0(value: number | undefined): boolean;
     /**
      * Checks if the filters are correctly stated (active / not-active) - mostly used internally.
      * @param oldFilterTimescale
@@ -703,138 +705,6 @@ declare class FilterManager {
     clearEQ(): Promise<this>;
 }
 
-/** Sourcenames provided by lavalink server */
-type LavalinkSourceNames = "youtube" | "youtubemusic" | "soundcloud" | "bandcamp" | "twitch";
-/** Source Names provided by lava src plugin */
-type LavalinkPlugin_LavaSrc_SourceNames = "deezer" | "spotify" | "applemusic" | "yandexmusic" | "flowery-tts" | "vkmusic" | "tidal" | "qobuz" | "pandora";
-/** Source Names provided by jiosaavan plugin */
-type LavalinkPlugin_JioSaavn_SourceNames = "jiosaavn";
-/** The SourceNames provided by lavalink */
-type SourceNames = LavalinkSourceNames | LavalinkPlugin_LavaSrc_SourceNames | LavalinkPlugin_JioSaavn_SourceNames;
-interface LavalinkTrackInfo {
-    /** The Identifier of the Track */
-    identifier: string;
-    /** The Track Title / Name */
-    title: string;
-    /** The Name of the Author */
-    author: string;
-    /** The duration of the Track */
-    length: number;
-    /** The URL of the artwork if available */
-    artworkUrl: string | null;
-    /** The URL (aka Link) of the Track called URI */
-    uri: string;
-    /** The Source name of the Track, e.g. soundcloud, youtube, spotify */
-    sourceName: SourceNames;
-    /** Wether the audio is seekable */
-    isSeekable: boolean;
-    /** Wether the audio is of a live stream */
-    isStream: boolean;
-    /** If isrc code is available, it's provided */
-    isrc: string | null;
-}
-interface TrackInfo {
-    /** The Identifier of the Track */
-    identifier: string;
-    /** The Track Title / Name */
-    title: string;
-    /** The Name of the Author */
-    author: string;
-    /** The duration of the Track */
-    duration: number;
-    /** The URL of the artwork if available */
-    artworkUrl: string | null;
-    /** The URL (aka Link) of the Track called URI */
-    uri: string;
-    /** The Source name of the Track, e.g. soundcloud, youtube, spotify */
-    sourceName: SourceNames;
-    /** Wether the audio is seekable */
-    isSeekable: boolean;
-    /** Wether the audio is of a live stream */
-    isStream: boolean;
-    /** If isrc code is available, it's provided */
-    isrc: string | null;
-}
-interface PluginInfo {
-    /** The Type provided by a plugin */
-    type?: "album" | "playlist" | "artist" | "recommendations" | string;
-    /** The Identifier provided by a plugin */
-    albumName?: string;
-    /** The url of the album */
-    albumUrl?: string;
-    /** The url of the album art */
-    albumArtUrl?: string;
-    /** The url of the artist */
-    artistUrl?: string;
-    /** The url of the artist artwork */
-    artistArtworkUrl?: string;
-    /** The url of the preview */
-    previewUrl?: string;
-    /** Whether the track is a preview */
-    isPreview?: boolean;
-    /** The total number of tracks in the playlist */
-    totalTracks?: number;
-    /** The Identifier provided by a plugin */
-    identifier?: string;
-    /** The ArtworkUrl provided by a plugin */
-    artworkUrl?: string;
-    /** The Author Information provided by a plugin */
-    author?: string;
-    /** The Url provided by a Plugin */
-    url?: string;
-    /** The Url provided by a Plugin */
-    uri?: string;
-    /** You can put specific track information here, to transform the tracks... */
-    clientData?: {
-        previousTrack?: boolean;
-        [key: string]: any;
-    };
-}
-interface LavalinkTrack {
-    /** The Base 64 encoded String */
-    encoded?: Base64;
-    /** Track Information */
-    info: LavalinkTrackInfo;
-    /** Plugin Information from Lavalink */
-    pluginInfo: Partial<PluginInfo>;
-    /** The userData Object from when you provide to the lavalink request */
-    userData?: anyObject;
-}
-interface Track {
-    /** The Base 64 encoded String */
-    encoded?: Base64;
-    /** Track Information */
-    info: TrackInfo;
-    /** Plugin Information from Lavalink */
-    pluginInfo: Partial<PluginInfo>;
-    /** The Track's Requester */
-    requester?: unknown;
-    /** The userData Object from when you provide to the lavalink request */
-    userData?: anyObject;
-}
-interface UnresolvedTrackInfo extends Partial<TrackInfo> {
-    /** Required */
-    title: string;
-}
-interface UnresolvedQuery extends UnresolvedTrackInfo {
-    /** The base64 of the unresolved track to "encode" */
-    encoded?: Base64;
-}
-interface UnresolvedTrack {
-    /** Required */
-    resolve: (player: Player) => Promise<void>;
-    /** The Base 64 encoded String */
-    encoded?: Base64;
-    /** Track Information */
-    info: UnresolvedTrackInfo;
-    /** Plugin Information from Lavalink */
-    pluginInfo: Partial<PluginInfo>;
-    /** The userData Object from when you provide to the lavalink request */
-    userData?: anyObject;
-    /** The Track's Requester */
-    requester?: unknown;
-}
-
 declare class QueueSaver {
     /**
      * The queue store manager
@@ -976,6 +846,7 @@ declare class Queue {
      *  - single Track | UnresolvedTrack
      *  - multiple Track | UnresovedTrack
      *  - at the index or multiple indexes
+     *  - Since v2.7 the removed tracks get unshifted into the previous queue state instead of pushed (indexed at the start instead of end - as it should)
      * @param removeQueryTrack
      * @returns null (if nothing was removed) / { removed } where removed is an array with all removed elements
      *
@@ -1248,6 +1119,138 @@ declare class Player {
     toJSON(): PlayerJson;
 }
 
+/** Sourcenames provided by lavalink server */
+type LavalinkSourceNames = "youtube" | "youtubemusic" | "soundcloud" | "bandcamp" | "twitch";
+/** Source Names provided by lava src plugin */
+type LavalinkPlugin_LavaSrc_SourceNames = "deezer" | "spotify" | "applemusic" | "yandexmusic" | "flowery-tts" | "vkmusic" | "tidal" | "qobuz" | "pandora";
+/** Source Names provided by jiosaavan plugin */
+type LavalinkPlugin_JioSaavn_SourceNames = "jiosaavn";
+/** The SourceNames provided by lavalink */
+type SourceNames = LavalinkSourceNames | LavalinkPlugin_LavaSrc_SourceNames | LavalinkPlugin_JioSaavn_SourceNames;
+interface LavalinkTrackInfo {
+    /** The Identifier of the Track */
+    identifier: string;
+    /** The Track Title / Name */
+    title: string;
+    /** The Name of the Author */
+    author: string;
+    /** The duration of the Track */
+    length: number;
+    /** The URL of the artwork if available */
+    artworkUrl: string | null;
+    /** The URL (aka Link) of the Track called URI */
+    uri: string;
+    /** The Source name of the Track, e.g. soundcloud, youtube, spotify */
+    sourceName: SourceNames;
+    /** Wether the audio is seekable */
+    isSeekable: boolean;
+    /** Wether the audio is of a live stream */
+    isStream: boolean;
+    /** If isrc code is available, it's provided */
+    isrc: string | null;
+}
+interface TrackInfo {
+    /** The Identifier of the Track */
+    identifier: string;
+    /** The Track Title / Name */
+    title: string;
+    /** The Name of the Author */
+    author: string;
+    /** The duration of the Track */
+    duration: number;
+    /** The URL of the artwork if available */
+    artworkUrl: string | null;
+    /** The URL (aka Link) of the Track called URI */
+    uri: string;
+    /** The Source name of the Track, e.g. soundcloud, youtube, spotify */
+    sourceName: SourceNames;
+    /** Wether the audio is seekable */
+    isSeekable: boolean;
+    /** Wether the audio is of a live stream */
+    isStream: boolean;
+    /** If isrc code is available, it's provided */
+    isrc: string | null;
+}
+interface PluginInfo {
+    /** The Type provided by a plugin */
+    type?: "album" | "playlist" | "artist" | "recommendations" | string;
+    /** The Identifier provided by a plugin */
+    albumName?: string;
+    /** The url of the album */
+    albumUrl?: string;
+    /** The url of the album art */
+    albumArtUrl?: string;
+    /** The url of the artist */
+    artistUrl?: string;
+    /** The url of the artist artwork */
+    artistArtworkUrl?: string;
+    /** The url of the preview */
+    previewUrl?: string;
+    /** Whether the track is a preview */
+    isPreview?: boolean;
+    /** The total number of tracks in the playlist */
+    totalTracks?: number;
+    /** The Identifier provided by a plugin */
+    identifier?: string;
+    /** The ArtworkUrl provided by a plugin */
+    artworkUrl?: string;
+    /** The Author Information provided by a plugin */
+    author?: string;
+    /** The Url provided by a Plugin */
+    url?: string;
+    /** The Url provided by a Plugin */
+    uri?: string;
+    /** You can put specific track information here, to transform the tracks... */
+    clientData?: {
+        previousTrack?: boolean;
+        [key: string]: any;
+    };
+}
+interface LavalinkTrack {
+    /** The Base 64 encoded String */
+    encoded?: Base64;
+    /** Track Information */
+    info: LavalinkTrackInfo;
+    /** Plugin Information from Lavalink */
+    pluginInfo: Partial<PluginInfo>;
+    /** The userData Object from when you provide to the lavalink request */
+    userData?: anyObject;
+}
+interface Track {
+    /** The Base 64 encoded String */
+    encoded?: Base64;
+    /** Track Information */
+    info: TrackInfo;
+    /** Plugin Information from Lavalink */
+    pluginInfo: Partial<PluginInfo>;
+    /** The Track's Requester */
+    requester?: unknown;
+    /** The userData Object from when you provide to the lavalink request */
+    userData?: anyObject;
+}
+interface UnresolvedTrackInfo extends Partial<TrackInfo> {
+    /** Required */
+    title: string;
+}
+interface UnresolvedQuery extends UnresolvedTrackInfo {
+    /** The base64 of the unresolved track to "encode" */
+    encoded?: Base64;
+}
+interface UnresolvedTrack {
+    /** Required */
+    resolve: (player: Player) => Promise<void>;
+    /** The Base 64 encoded String */
+    encoded?: Base64;
+    /** Track Information */
+    info: UnresolvedTrackInfo;
+    /** Plugin Information from Lavalink */
+    pluginInfo: Partial<PluginInfo>;
+    /** The userData Object from when you provide to the lavalink request */
+    userData?: anyObject;
+    /** The Track's Requester */
+    requester?: unknown;
+}
+
 interface StoredQueue {
     current: Track | null;
     previous: Track[];
@@ -1265,7 +1268,7 @@ interface QueueStoreManager {
     /** @async Parse the saved value back to the Queue (IF YOU DON'T NEED PARSING/STRINGIFY, then just return the value) */
     parse: (value: StoredQueue | string) => Awaitable<Partial<StoredQueue>>;
 }
-interface ManagerQueueOptions<CustomPlayerT extends Player = Player> {
+interface ManagerQueueOptions {
     /** Maximum Amount of tracks for the queue.previous array. Set to 0 to not save previous songs. Defaults to 25 Tracks */
     maxPreviousTracks?: number;
     /** Custom Queue Store option */
@@ -1915,38 +1918,12 @@ interface LyricsFoundEvent extends PlayerEvent {
     /** The lyrics */
     lyrics: LyricsResult;
 }
-interface LyricsFoundEvent extends PlayerEvent {
-    /** The lyricsfound event */
-    type: "LyricsFoundEvent";
-    /** The guildId */
-    guildId: string;
-    /** The lyrics */
-    lyrics: LyricsResult;
-}
 interface LyricsNotFoundEvent extends PlayerEvent {
     /**The lyricsnotfound event*/
     type: "LyricsNotFoundEvent";
     /**The guildId*/
     guildId: string;
 }
-interface LyricsNotFoundEvent extends PlayerEvent {
-    /**The lyricsnotfound event*/
-    type: "LyricsNotFoundEvent";
-    /**The guildId*/
-    guildId: string;
-}
-interface LyricsLineEvent extends PlayerEvent {
-    /**The lyricsline event*/
-    type: "LyricsLineEvent";
-    /** The guildId */
-    guildId: string;
-    /** The line number */
-    lineIndex: number;
-    /** The line */
-    line: LyricsLine;
-    /**skipped is true if the line was skipped */
-    skipped: boolean;
-}
 interface LyricsLineEvent extends PlayerEvent {
     /**The lyricsline event*/
     type: "LyricsLineEvent";
@@ -3039,7 +3016,7 @@ interface ManagerOptions<CustomPlayerT extends Player = Player> {
     /** The Bot Client's Data for Authorization */
     client?: BotClientOptions;
     /** QueueOptions for all Queues */
-    queueOptions?: ManagerQueueOptions<CustomPlayerT>;
+    queueOptions?: ManagerQueueOptions;
     /** PlayerOptions for all Players */
     playerOptions?: ManagerPlayerOptions<CustomPlayerT>;
     /** The player class you want to use when creating a player. (can be extendable) */

package/dist/index.js

@@ -79,6 +79,7 @@ var DebugEvents = /* @__PURE__ */ ((DebugEvents2) => {
   DebugEvents2["PlayerUpdateSuccess"] = "PlayerUpdateSuccess";
   DebugEvents2["HeartBeatTriggered"] = "HeartBeatTriggered";
   DebugEvents2["NoSocketOnDestroy"] = "NoSocketOnDestroy";
+  DebugEvents2["SocketCleanupError"] = "SocketCleanupError";
   DebugEvents2["SocketTerminateHeartBeatTimeout"] = "SocketTerminateHeartBeatTimeout";
   DebugEvents2["TryingConnectWhileConnected"] = "TryingConnectWhileConnected";
   DebugEvents2["LavaSearchNothingFound"] = "LavaSearchNothingFound";
@@ -481,7 +482,7 @@ var SourceLinksRegexes = {
   /** DEFAULT SUPPORTED BY LAVALINK */
   YoutubeRegex: /https?:\/\/?(?:www\.)?(?:(m|www)\.)?(?:youtu\.be\/|youtube\.com\/(?:embed\/|v\/|shorts|playlist\?|watch\?v=|watch\?.+(?:&|&);v=))([a-zA-Z0-9\-_]{11})?(?:(?:\?|&|&)index=((?:\d){1,3}))?(?:(?:\?|&|&)?list=([a-zA-Z\-_0-9]{34}))?(?:\S+)?/,
   YoutubeMusicRegex: /https?:\/\/?(?:www\.)?(?:(music|m|www)\.)?(?:youtu\.be\/|youtube\.com\/(?:embed\/|v\/|shorts|playlist\?|watch\?v=|watch\?.+(?:&|&);v=))([a-zA-Z0-9\-_]{11})?(?:(?:\?|&|&)index=((?:\d){1,3}))?(?:(?:\?|&|&)?list=([a-zA-Z\-_0-9]{34}))?(?:\S+)?/,
-  SoundCloudRegex: /https:\/\/(?:on\.)?soundcloud\.com\//,
+  SoundCloudRegex: /https?:\/\/(?:on\.)?soundcloud\.com\//,
   SoundCloudMobileRegex: /https?:\/\/(soundcloud\.app\.goo\.gl)\/(\S+)/,
   bandcamp: /https?:\/\/?(?:www\.)?([\d|\w]+)\.bandcamp\.com\/(\S+)/,
   TwitchTv: /https?:\/\/?(?:www\.)?twitch\.tv\/\w+/,
@@ -1001,9 +1002,15 @@ async function getClosestTrack(data, player) {
     source: sourceName !== "twitch" && sourceName !== "flowery-tts" ? sourceName : player.LavalinkManager.options?.playerOptions?.defaultSearchPlatform
   }, data.requester).then((res) => {
     let trackToUse = null;
-    if (data.info.author && !trackToUse) trackToUse = res.tracks.find((track) => [data.info?.author || "", `${data.info?.author} - Topic`].some((name) => new RegExp(`^${escapeRegExp(name)}$`, "i").test(track.info?.author)) || new RegExp(`^${escapeRegExp(data.info?.title)}$`, "i").test(track.info?.title));
-    if (data.info.duration && !trackToUse) trackToUse = res.tracks.find((track) => track.info?.duration >= data.info?.duration - 1500 && track?.info.duration <= data.info?.duration + 1500);
-    if (data.info.isrc && !trackToUse) trackToUse = res.tracks.find((track) => track.info?.isrc === data.info?.isrc);
+    if ((data.info?.title || data.info?.author) && !trackToUse) trackToUse = res.tracks.find(
+      (track) => (
+        // find via author name (i ... case insensitve)
+        [data.info?.author || "", `${data.info?.author} - Topic`].some((name) => new RegExp(`^${escapeRegExp(name)}$`, "i").test(track.info?.author)) || // find via title (i ... case insensitve)
+        new RegExp(`^${escapeRegExp(data.info?.title)}$`, "i").test(track.info?.title)
+      )
+    );
+    if (data.info?.isrc && !trackToUse) trackToUse = res.tracks.find((track) => track.info?.isrc === data.info?.isrc);
+    if (data.info?.duration && !trackToUse) trackToUse = res.tracks.find((track) => track.info?.duration >= data.info?.duration - 1500 && track?.info.duration <= data.info?.duration + 1500);
     return applyUnresolvedData(trackToUse || res.tracks[0], data, player.LavalinkManager.utils);
   });
 }
@@ -1440,8 +1447,8 @@ var LavalinkNode = class {
         }
       };
       handlePlayerOperations().finally(() => {
-        this.socket.close(1e3, "Node-Destroy");
-        this.socket.removeAllListeners();
+        this.socket?.close(1e3, "Node-Destroy");
+        this.socket?.removeAllListeners();
         this.socket = null;
         this.reconnectAttempts = 1;
         clearTimeout(this.reconnectTimeout);
@@ -1455,8 +1462,8 @@ var LavalinkNode = class {
         }
       });
     } else {
-      this.socket.close(1e3, "Node-Destroy");
-      this.socket.removeAllListeners();
+      this.socket?.close(1e3, "Node-Destroy");
+      this.socket?.removeAllListeners();
       this.socket = null;
       this.reconnectAttempts = 1;
       clearTimeout(this.reconnectTimeout);
@@ -1485,8 +1492,8 @@ var LavalinkNode = class {
    */
   disconnect(disconnectReason) {
     if (!this.connected) return;
-    this.socket.close(1e3, "Node-Disconnect");
-    this.socket.removeAllListeners();
+    this.socket?.close(1e3, "Node-Disconnect");
+    this.socket?.removeAllListeners();
     this.socket = null;
     this.reconnectAttempts = 1;
     clearTimeout(this.reconnectTimeout);
@@ -1877,8 +1884,6 @@ var LavalinkNode = class {
         this.NodeManager.emit("error", this, error);
         return this.destroy("NodeReconnectFail" /* NodeReconnectFail */);
       }
-      this.socket.removeAllListeners();
-      this.socket = null;
       this.NodeManager.emit("reconnecting", this);
       this.connect();
       this.reconnectAttempts++;
@@ -1891,8 +1896,6 @@ var LavalinkNode = class {
         this.NodeManager.emit("error", this, error);
         return this.destroy("NodeReconnectFail" /* NodeReconnectFail */);
       }
-      this.socket.removeAllListeners();
-      this.socket = null;
       this.NodeManager.emit("reconnecting", this);
       this.connect();
       this.reconnectAttempts++;
@@ -1901,6 +1904,8 @@ var LavalinkNode = class {
   /** @private util function for handling opening events from websocket */
   async open() {
     this.isAlive = true;
+    this.reconnectAttempts = 1;
+    if (this.reconnectTimeout) clearTimeout(this.reconnectTimeout);
     if (this.options.enablePingOnStatsCheck) this.heartBeat();
     if (this.heartBeatInterval) clearInterval(this.heartBeatInterval);
     if (this.options.heartBeatInterval > 0) {
@@ -1916,8 +1921,6 @@ var LavalinkNode = class {
         this.socket.ping();
       }, this.options.heartBeatInterval || 3e4);
     }
-    if (this.reconnectTimeout) clearTimeout(this.reconnectTimeout);
-    this.reconnectAttempts = 1;
     this.info = await this.fetchInfo().catch((e) => (console.error(e, "ON-OPEN-FETCH"), null));
     if (!this.info && ["v3", "v4"].includes(this.version)) {
       const errorString = `Lavalink Node (${this.restAddress}) does not provide any /${this.version}/info`;
@@ -1928,6 +1931,21 @@ var LavalinkNode = class {
   /** @private util function for handling closing events from websocket */
   close(code, reason) {
     if (this.pingTimeout) clearTimeout(this.pingTimeout);
+    try {
+      if (this.socket) {
+        this.socket.removeAllListeners();
+        this.socket = null;
+      }
+    } catch (e) {
+      if (this.NodeManager?.LavalinkManager?.options?.advancedOptions?.enableDebugEvents) {
+        this.NodeManager.LavalinkManager.emit("debug", "SocketCleanupError" /* SocketCleanupError */, {
+          state: "warn",
+          message: `An error occurred during socket cleanup in close() (likely a race condition): ${e.message}`,
+          functionLayer: "LavalinkNode > close()"
+        });
+      }
+    }
+    this.isAlive = false;
     if (this.heartBeatInterval) clearInterval(this.heartBeatInterval);
     if (code === 1006 && !reason) reason = "Socket got terminated due to no ping connection";
     if (code === 1e3 && reason === "Node-Disconnect") return;
@@ -2697,7 +2715,7 @@ var bandCampSearch = async (player, query, requestUser) => {
       artworkUrl: item.img,
       author: item.band_name,
       title: item.name,
-      identifier: item.id ? `${item.id}` : item.url?.split("/").reverse()[0]
+      identifier: item.id ? `${item.id}` : item.url?.split("/")?.reverse()[0]
     }, requestUser));
   } catch (e) {
     error = e;
@@ -2882,6 +2900,9 @@ var FilterManager = class {
     this.player.ping.lavalink = Math.round((performance.now() - now) / 10) / 100;
     return;
   }
+  privateNot0(value) {
+    return typeof value === "number" && value !== 0;
+  }
   /**
    * Checks if the filters are correctly stated (active / not-active) - mostly used internally.
    * @param oldFilterTimescale
@@ -2896,9 +2917,10 @@ var FilterManager = class {
    * ```
    */
   checkFiltersState(oldFilterTimescale) {
-    this.filters.rotation = this.data.rotation.rotationHz !== 0;
-    this.filters.vibrato = this.data.vibrato.frequency !== 0 || this.data.vibrato.depth !== 0;
-    this.filters.tremolo = this.data.tremolo.frequency !== 0 || this.data.tremolo.depth !== 0;
+    this.data = this.data ?? {};
+    this.filters.rotation = this.privateNot0(this.data.rotation?.rotationHz);
+    this.filters.vibrato = this.privateNot0(this.data.vibrato?.frequency) || this.privateNot0(this.data.vibrato?.depth);
+    this.filters.tremolo = this.privateNot0(this.data.tremolo?.frequency) || this.privateNot0(this.data.tremolo?.depth);
     const lavalinkFilterData = this.data.pluginFilters?.["lavalink-filter-plugin"] || { echo: { decay: this.data.pluginFilters?.echo?.decay && !this.data.pluginFilters?.echo?.echoLength ? this.data.pluginFilters.echo.decay : 0, delay: this.data.pluginFilters?.echo?.delay || 0 }, reverb: { gains: [], delays: [], ...this.data.pluginFilters.reverb } };
     this.filters.lavalinkFilterPlugin.echo = lavalinkFilterData.echo.decay !== 0 || lavalinkFilterData.echo.delay !== 0;
     this.filters.lavalinkFilterPlugin.reverb = lavalinkFilterData.reverb?.delays?.length !== 0 || lavalinkFilterData.reverb?.gains?.length !== 0;
@@ -3737,6 +3759,7 @@ var Queue = class {
    *  - single Track | UnresolvedTrack
    *  - multiple Track | UnresovedTrack
    *  - at the index or multiple indexes
+   *  - Since v2.7 the removed tracks get unshifted into the previous queue state instead of pushed (indexed at the start instead of end - as it should)
    * @param removeQueryTrack
    * @returns null (if nothing was removed) / { removed } where removed is an array with all removed elements
    *
@@ -3782,9 +3805,10 @@ var Queue = class {
     if (Array.isArray(removeQueryTrack)) {
       if (removeQueryTrack.every((v) => typeof v === "number")) {
         const removed3 = [];
-        for (const i of removeQueryTrack) {
+        const sortedIndexes = removeQueryTrack.sort((a, b) => b - a);
+        for (const i of sortedIndexes) {
           if (this.tracks[i]) {
-            removed3.push(...this.tracks.splice(i, 1));
+            removed3.unshift(...this.tracks.splice(i, 1));
           }
         }
         if (!removed3.length) return null;
@@ -3800,9 +3824,10 @@ var Queue = class {
       ));
       if (!tracksToRemove.length) return null;
       const removed2 = [];
+      tracksToRemove.sort((a, b) => b.i - a.i);
       for (const { i } of tracksToRemove) {
         if (this.tracks[i]) {
-          removed2.push(...this.tracks.splice(i, 1));
+          removed2.unshift(...this.tracks.splice(i, 1));
         }
       }
       if (typeof this.queueChanges?.tracksRemoved === "function") try {
@@ -4025,7 +4050,7 @@ var Player = class {
       this.queue.current = options.clientTrack || null;
       this.queue.utils.save();
       if (typeof options?.volume === "number" && !isNaN(options?.volume)) {
-        this.volume = Math.max(Math.min(options?.volume, 500), 0);
+        this.volume = Math.max(Math.min(options?.volume, 1e3), 0);
         let vol = Number(this.volume);
         if (this.LavalinkManager.options.playerOptions.volumeDecrementer) vol *= this.LavalinkManager.options.playerOptions.volumeDecrementer;
         this.lavalinkVolume = Math.round(vol);
@@ -4095,7 +4120,7 @@ var Player = class {
     }
     if (!this.queue.current) throw new Error(`There is no Track in the Queue, nor provided in the PlayOptions`);
     if (typeof options?.volume === "number" && !isNaN(options?.volume)) {
-      this.volume = Math.max(Math.min(options?.volume, 500), 0);
+      this.volume = Math.max(Math.min(options?.volume, 1e3), 0);
       let vol = Number(this.volume);
       if (this.LavalinkManager.options.playerOptions.volumeDecrementer) vol *= this.LavalinkManager.options.playerOptions.volumeDecrementer;
       this.lavalinkVolume = Math.round(vol);
@@ -4118,9 +4143,9 @@ var Player = class {
       paused: options?.paused ?? void 0,
       voice: options?.voice ?? void 0
     }).filter((v) => typeof v[1] !== "undefined"));
-    if (typeof finalOptions.position !== "undefined" && isNaN(finalOptions.position) || typeof finalOptions.position === "number" && (finalOptions.position < 0 || finalOptions.position >= this.queue.current.info.duration)) throw new Error("PlayerOption#position must be a positive number, less than track's duration");
+    if (typeof finalOptions.position !== "undefined" && isNaN(finalOptions.position) || typeof finalOptions.position === "number" && finalOptions.position < 0 || typeof finalOptions.position === "number" && this.queue.current.info.duration > 0 && finalOptions.position >= this.queue.current.info.duration) throw new Error("PlayerOption#position must be a positive number, less than track's duration");
     if (typeof finalOptions.volume !== "undefined" && isNaN(finalOptions.volume) || typeof finalOptions.volume === "number" && finalOptions.volume < 0) throw new Error("PlayerOption#volume must be a positive number");
-    if (typeof finalOptions.endTime !== "undefined" && isNaN(finalOptions.endTime) || typeof finalOptions.endTime === "number" && (finalOptions.endTime < 0 || finalOptions.endTime >= this.queue.current.info.duration)) throw new Error("PlayerOption#endTime must be a positive number, less than track's duration");
+    if (typeof finalOptions.endTime !== "undefined" && isNaN(finalOptions.endTime) || typeof finalOptions.endTime === "number" && finalOptions.endTime < 0 || typeof finalOptions.endTime === "number" && this.queue.current.info.duration > 0 && finalOptions.endTime >= this.queue.current.info.duration) throw new Error("PlayerOption#endTime must be a positive number, less than track's duration");
     if (typeof finalOptions.position === "number" && typeof finalOptions.endTime === "number" && finalOptions.endTime < finalOptions.position) throw new Error("PlayerOption#endTime must be bigger than PlayerOption#position");
     const now = performance.now();
     await this.node.updatePlayer({
@@ -4195,7 +4220,7 @@ var Player = class {
    */
   async search(query, requestUser, throwOnEmpty = false) {
     const Query = this.LavalinkManager.utils.transformQuery(query);
-    if (["bcsearch", "bandcamp"].includes(Query.source) && !this.node.info.sourceManagers.includes("bandcamp")) {
+    if (["bcsearch", "bandcamp"].includes(Query.source) && !this.node.info?.sourceManagers.includes("bandcamp")) {
       if (this.LavalinkManager.options?.advancedOptions?.enableDebugEvents) {
         this.LavalinkManager.emit("debug", "BandcampSearchLokalEngine" /* BandcampSearchLokalEngine */, {
           state: "log",
@@ -4450,7 +4475,7 @@ var Player = class {
       if (this.queue.current || this.queue.tracks.length) {
         const trackSources = new Set([this.queue.current, ...this.queue.tracks].map((track) => track.info.sourceName));
         const missingSources = [...trackSources].filter(
-          (source) => !updateNode.info.sourceManagers.includes(source)
+          (source) => !updateNode.info?.sourceManagers.includes(source)
         );
         if (missingSources.length)
           throw new RangeError(`Sources missing for Node ${updateNode.id}: ${missingSources.join(", ")}`);
@@ -4872,7 +4897,7 @@ var LavalinkManager = class extends import_events2.EventEmitter {
   deletePlayer(guildId) {
     const oldPlayer = this.getPlayer(guildId);
     if (!oldPlayer) return;
-    if (oldPlayer.voiceChannelId === "string" && oldPlayer.connected && !oldPlayer.get("internal_destroywithoutdisconnect")) {
+    if (typeof oldPlayer.voiceChannelId === "string" && oldPlayer.connected && !oldPlayer.get("internal_destroywithoutdisconnect")) {
       if (!this.options?.advancedOptions?.debugOptions?.playerDestroy?.dontThrowError) throw new Error(`Use Player#destroy() not LavalinkManager#deletePlayer() to stop the Player ${safeStringify(oldPlayer.toJSON?.())}`);
       else if (this.options?.advancedOptions?.enableDebugEvents) {
         this.emit("debug", "PlayerDeleteInsteadOfDestroy" /* PlayerDeleteInsteadOfDestroy */, {
@@ -5135,6 +5160,7 @@ var LavalinkManager = class extends import_events2.EventEmitter {
               message: `Auto reconnected, but nothing to play`,
               functionLayer: "LavalinkManager > sendRawData()"
             });
+            return;
           } catch (e) {
             console.error(e);
             return void await player.destroy("PlayerReconnectFail" /* PlayerReconnectFail */);

package/dist/index.mjs

@@ -19,6 +19,7 @@ var DebugEvents = /* @__PURE__ */ ((DebugEvents2) => {
   DebugEvents2["PlayerUpdateSuccess"] = "PlayerUpdateSuccess";
   DebugEvents2["HeartBeatTriggered"] = "HeartBeatTriggered";
   DebugEvents2["NoSocketOnDestroy"] = "NoSocketOnDestroy";
+  DebugEvents2["SocketCleanupError"] = "SocketCleanupError";
   DebugEvents2["SocketTerminateHeartBeatTimeout"] = "SocketTerminateHeartBeatTimeout";
   DebugEvents2["TryingConnectWhileConnected"] = "TryingConnectWhileConnected";
   DebugEvents2["LavaSearchNothingFound"] = "LavaSearchNothingFound";
@@ -421,7 +422,7 @@ var SourceLinksRegexes = {
   /** DEFAULT SUPPORTED BY LAVALINK */
   YoutubeRegex: /https?:\/\/?(?:www\.)?(?:(m|www)\.)?(?:youtu\.be\/|youtube\.com\/(?:embed\/|v\/|shorts|playlist\?|watch\?v=|watch\?.+(?:&|&);v=))([a-zA-Z0-9\-_]{11})?(?:(?:\?|&|&)index=((?:\d){1,3}))?(?:(?:\?|&|&)?list=([a-zA-Z\-_0-9]{34}))?(?:\S+)?/,
   YoutubeMusicRegex: /https?:\/\/?(?:www\.)?(?:(music|m|www)\.)?(?:youtu\.be\/|youtube\.com\/(?:embed\/|v\/|shorts|playlist\?|watch\?v=|watch\?.+(?:&|&);v=))([a-zA-Z0-9\-_]{11})?(?:(?:\?|&|&)index=((?:\d){1,3}))?(?:(?:\?|&|&)?list=([a-zA-Z\-_0-9]{34}))?(?:\S+)?/,
-  SoundCloudRegex: /https:\/\/(?:on\.)?soundcloud\.com\//,
+  SoundCloudRegex: /https?:\/\/(?:on\.)?soundcloud\.com\//,
   SoundCloudMobileRegex: /https?:\/\/(soundcloud\.app\.goo\.gl)\/(\S+)/,
   bandcamp: /https?:\/\/?(?:www\.)?([\d|\w]+)\.bandcamp\.com\/(\S+)/,
   TwitchTv: /https?:\/\/?(?:www\.)?twitch\.tv\/\w+/,
@@ -941,9 +942,15 @@ async function getClosestTrack(data, player) {
     source: sourceName !== "twitch" && sourceName !== "flowery-tts" ? sourceName : player.LavalinkManager.options?.playerOptions?.defaultSearchPlatform
   }, data.requester).then((res) => {
     let trackToUse = null;
-    if (data.info.author && !trackToUse) trackToUse = res.tracks.find((track) => [data.info?.author || "", `${data.info?.author} - Topic`].some((name) => new RegExp(`^${escapeRegExp(name)}$`, "i").test(track.info?.author)) || new RegExp(`^${escapeRegExp(data.info?.title)}$`, "i").test(track.info?.title));
-    if (data.info.duration && !trackToUse) trackToUse = res.tracks.find((track) => track.info?.duration >= data.info?.duration - 1500 && track?.info.duration <= data.info?.duration + 1500);
-    if (data.info.isrc && !trackToUse) trackToUse = res.tracks.find((track) => track.info?.isrc === data.info?.isrc);
+    if ((data.info?.title || data.info?.author) && !trackToUse) trackToUse = res.tracks.find(
+      (track) => (
+        // find via author name (i ... case insensitve)
+        [data.info?.author || "", `${data.info?.author} - Topic`].some((name) => new RegExp(`^${escapeRegExp(name)}$`, "i").test(track.info?.author)) || // find via title (i ... case insensitve)
+        new RegExp(`^${escapeRegExp(data.info?.title)}$`, "i").test(track.info?.title)
+      )
+    );
+    if (data.info?.isrc && !trackToUse) trackToUse = res.tracks.find((track) => track.info?.isrc === data.info?.isrc);
+    if (data.info?.duration && !trackToUse) trackToUse = res.tracks.find((track) => track.info?.duration >= data.info?.duration - 1500 && track?.info.duration <= data.info?.duration + 1500);
     return applyUnresolvedData(trackToUse || res.tracks[0], data, player.LavalinkManager.utils);
   });
 }
@@ -1380,8 +1387,8 @@ var LavalinkNode = class {
         }
       };
       handlePlayerOperations().finally(() => {
-        this.socket.close(1e3, "Node-Destroy");
-        this.socket.removeAllListeners();
+        this.socket?.close(1e3, "Node-Destroy");
+        this.socket?.removeAllListeners();
         this.socket = null;
         this.reconnectAttempts = 1;
         clearTimeout(this.reconnectTimeout);
@@ -1395,8 +1402,8 @@ var LavalinkNode = class {
         }
       });
     } else {
-      this.socket.close(1e3, "Node-Destroy");
-      this.socket.removeAllListeners();
+      this.socket?.close(1e3, "Node-Destroy");
+      this.socket?.removeAllListeners();
       this.socket = null;
       this.reconnectAttempts = 1;
       clearTimeout(this.reconnectTimeout);
@@ -1425,8 +1432,8 @@ var LavalinkNode = class {
    */
   disconnect(disconnectReason) {
     if (!this.connected) return;
-    this.socket.close(1e3, "Node-Disconnect");
-    this.socket.removeAllListeners();
+    this.socket?.close(1e3, "Node-Disconnect");
+    this.socket?.removeAllListeners();
     this.socket = null;
     this.reconnectAttempts = 1;
     clearTimeout(this.reconnectTimeout);
@@ -1817,8 +1824,6 @@ var LavalinkNode = class {
         this.NodeManager.emit("error", this, error);
         return this.destroy("NodeReconnectFail" /* NodeReconnectFail */);
       }
-      this.socket.removeAllListeners();
-      this.socket = null;
       this.NodeManager.emit("reconnecting", this);
       this.connect();
       this.reconnectAttempts++;
@@ -1831,8 +1836,6 @@ var LavalinkNode = class {
         this.NodeManager.emit("error", this, error);
         return this.destroy("NodeReconnectFail" /* NodeReconnectFail */);
       }
-      this.socket.removeAllListeners();
-      this.socket = null;
       this.NodeManager.emit("reconnecting", this);
       this.connect();
       this.reconnectAttempts++;
@@ -1841,6 +1844,8 @@ var LavalinkNode = class {
   /** @private util function for handling opening events from websocket */
   async open() {
     this.isAlive = true;
+    this.reconnectAttempts = 1;
+    if (this.reconnectTimeout) clearTimeout(this.reconnectTimeout);
     if (this.options.enablePingOnStatsCheck) this.heartBeat();
     if (this.heartBeatInterval) clearInterval(this.heartBeatInterval);
     if (this.options.heartBeatInterval > 0) {
@@ -1856,8 +1861,6 @@ var LavalinkNode = class {
         this.socket.ping();
       }, this.options.heartBeatInterval || 3e4);
     }
-    if (this.reconnectTimeout) clearTimeout(this.reconnectTimeout);
-    this.reconnectAttempts = 1;
     this.info = await this.fetchInfo().catch((e) => (console.error(e, "ON-OPEN-FETCH"), null));
     if (!this.info && ["v3", "v4"].includes(this.version)) {
       const errorString = `Lavalink Node (${this.restAddress}) does not provide any /${this.version}/info`;
@@ -1868,6 +1871,21 @@ var LavalinkNode = class {
   /** @private util function for handling closing events from websocket */
   close(code, reason) {
     if (this.pingTimeout) clearTimeout(this.pingTimeout);
+    try {
+      if (this.socket) {
+        this.socket.removeAllListeners();
+        this.socket = null;
+      }
+    } catch (e) {
+      if (this.NodeManager?.LavalinkManager?.options?.advancedOptions?.enableDebugEvents) {
+        this.NodeManager.LavalinkManager.emit("debug", "SocketCleanupError" /* SocketCleanupError */, {
+          state: "warn",
+          message: `An error occurred during socket cleanup in close() (likely a race condition): ${e.message}`,
+          functionLayer: "LavalinkNode > close()"
+        });
+      }
+    }
+    this.isAlive = false;
     if (this.heartBeatInterval) clearInterval(this.heartBeatInterval);
     if (code === 1006 && !reason) reason = "Socket got terminated due to no ping connection";
     if (code === 1e3 && reason === "Node-Disconnect") return;
@@ -2637,7 +2655,7 @@ var bandCampSearch = async (player, query, requestUser) => {
       artworkUrl: item.img,
       author: item.band_name,
       title: item.name,
-      identifier: item.id ? `${item.id}` : item.url?.split("/").reverse()[0]
+      identifier: item.id ? `${item.id}` : item.url?.split("/")?.reverse()[0]
     }, requestUser));
   } catch (e) {
     error = e;
@@ -2822,6 +2840,9 @@ var FilterManager = class {
     this.player.ping.lavalink = Math.round((performance.now() - now) / 10) / 100;
     return;
   }
+  privateNot0(value) {
+    return typeof value === "number" && value !== 0;
+  }
   /**
    * Checks if the filters are correctly stated (active / not-active) - mostly used internally.
    * @param oldFilterTimescale
@@ -2836,9 +2857,10 @@ var FilterManager = class {
    * ```
    */
   checkFiltersState(oldFilterTimescale) {
-    this.filters.rotation = this.data.rotation.rotationHz !== 0;
-    this.filters.vibrato = this.data.vibrato.frequency !== 0 || this.data.vibrato.depth !== 0;
-    this.filters.tremolo = this.data.tremolo.frequency !== 0 || this.data.tremolo.depth !== 0;
+    this.data = this.data ?? {};
+    this.filters.rotation = this.privateNot0(this.data.rotation?.rotationHz);
+    this.filters.vibrato = this.privateNot0(this.data.vibrato?.frequency) || this.privateNot0(this.data.vibrato?.depth);
+    this.filters.tremolo = this.privateNot0(this.data.tremolo?.frequency) || this.privateNot0(this.data.tremolo?.depth);
     const lavalinkFilterData = this.data.pluginFilters?.["lavalink-filter-plugin"] || { echo: { decay: this.data.pluginFilters?.echo?.decay && !this.data.pluginFilters?.echo?.echoLength ? this.data.pluginFilters.echo.decay : 0, delay: this.data.pluginFilters?.echo?.delay || 0 }, reverb: { gains: [], delays: [], ...this.data.pluginFilters.reverb } };
     this.filters.lavalinkFilterPlugin.echo = lavalinkFilterData.echo.decay !== 0 || lavalinkFilterData.echo.delay !== 0;
     this.filters.lavalinkFilterPlugin.reverb = lavalinkFilterData.reverb?.delays?.length !== 0 || lavalinkFilterData.reverb?.gains?.length !== 0;
@@ -3677,6 +3699,7 @@ var Queue = class {
    *  - single Track | UnresolvedTrack
    *  - multiple Track | UnresovedTrack
    *  - at the index or multiple indexes
+   *  - Since v2.7 the removed tracks get unshifted into the previous queue state instead of pushed (indexed at the start instead of end - as it should)
    * @param removeQueryTrack
    * @returns null (if nothing was removed) / { removed } where removed is an array with all removed elements
    *
@@ -3722,9 +3745,10 @@ var Queue = class {
     if (Array.isArray(removeQueryTrack)) {
       if (removeQueryTrack.every((v) => typeof v === "number")) {
         const removed3 = [];
-        for (const i of removeQueryTrack) {
+        const sortedIndexes = removeQueryTrack.sort((a, b) => b - a);
+        for (const i of sortedIndexes) {
           if (this.tracks[i]) {
-            removed3.push(...this.tracks.splice(i, 1));
+            removed3.unshift(...this.tracks.splice(i, 1));
           }
         }
         if (!removed3.length) return null;
@@ -3740,9 +3764,10 @@ var Queue = class {
       ));
       if (!tracksToRemove.length) return null;
       const removed2 = [];
+      tracksToRemove.sort((a, b) => b.i - a.i);
       for (const { i } of tracksToRemove) {
         if (this.tracks[i]) {
-          removed2.push(...this.tracks.splice(i, 1));
+          removed2.unshift(...this.tracks.splice(i, 1));
         }
       }
       if (typeof this.queueChanges?.tracksRemoved === "function") try {
@@ -3965,7 +3990,7 @@ var Player = class {
       this.queue.current = options.clientTrack || null;
       this.queue.utils.save();
       if (typeof options?.volume === "number" && !isNaN(options?.volume)) {
-        this.volume = Math.max(Math.min(options?.volume, 500), 0);
+        this.volume = Math.max(Math.min(options?.volume, 1e3), 0);
         let vol = Number(this.volume);
         if (this.LavalinkManager.options.playerOptions.volumeDecrementer) vol *= this.LavalinkManager.options.playerOptions.volumeDecrementer;
         this.lavalinkVolume = Math.round(vol);
@@ -4035,7 +4060,7 @@ var Player = class {
     }
     if (!this.queue.current) throw new Error(`There is no Track in the Queue, nor provided in the PlayOptions`);
     if (typeof options?.volume === "number" && !isNaN(options?.volume)) {
-      this.volume = Math.max(Math.min(options?.volume, 500), 0);
+      this.volume = Math.max(Math.min(options?.volume, 1e3), 0);
       let vol = Number(this.volume);
       if (this.LavalinkManager.options.playerOptions.volumeDecrementer) vol *= this.LavalinkManager.options.playerOptions.volumeDecrementer;
       this.lavalinkVolume = Math.round(vol);
@@ -4058,9 +4083,9 @@ var Player = class {
       paused: options?.paused ?? void 0,
       voice: options?.voice ?? void 0
     }).filter((v) => typeof v[1] !== "undefined"));
-    if (typeof finalOptions.position !== "undefined" && isNaN(finalOptions.position) || typeof finalOptions.position === "number" && (finalOptions.position < 0 || finalOptions.position >= this.queue.current.info.duration)) throw new Error("PlayerOption#position must be a positive number, less than track's duration");
+    if (typeof finalOptions.position !== "undefined" && isNaN(finalOptions.position) || typeof finalOptions.position === "number" && finalOptions.position < 0 || typeof finalOptions.position === "number" && this.queue.current.info.duration > 0 && finalOptions.position >= this.queue.current.info.duration) throw new Error("PlayerOption#position must be a positive number, less than track's duration");
     if (typeof finalOptions.volume !== "undefined" && isNaN(finalOptions.volume) || typeof finalOptions.volume === "number" && finalOptions.volume < 0) throw new Error("PlayerOption#volume must be a positive number");
-    if (typeof finalOptions.endTime !== "undefined" && isNaN(finalOptions.endTime) || typeof finalOptions.endTime === "number" && (finalOptions.endTime < 0 || finalOptions.endTime >= this.queue.current.info.duration)) throw new Error("PlayerOption#endTime must be a positive number, less than track's duration");
+    if (typeof finalOptions.endTime !== "undefined" && isNaN(finalOptions.endTime) || typeof finalOptions.endTime === "number" && finalOptions.endTime < 0 || typeof finalOptions.endTime === "number" && this.queue.current.info.duration > 0 && finalOptions.endTime >= this.queue.current.info.duration) throw new Error("PlayerOption#endTime must be a positive number, less than track's duration");
     if (typeof finalOptions.position === "number" && typeof finalOptions.endTime === "number" && finalOptions.endTime < finalOptions.position) throw new Error("PlayerOption#endTime must be bigger than PlayerOption#position");
     const now = performance.now();
     await this.node.updatePlayer({
@@ -4135,7 +4160,7 @@ var Player = class {
    */
   async search(query, requestUser, throwOnEmpty = false) {
     const Query = this.LavalinkManager.utils.transformQuery(query);
-    if (["bcsearch", "bandcamp"].includes(Query.source) && !this.node.info.sourceManagers.includes("bandcamp")) {
+    if (["bcsearch", "bandcamp"].includes(Query.source) && !this.node.info?.sourceManagers.includes("bandcamp")) {
       if (this.LavalinkManager.options?.advancedOptions?.enableDebugEvents) {
         this.LavalinkManager.emit("debug", "BandcampSearchLokalEngine" /* BandcampSearchLokalEngine */, {
           state: "log",
@@ -4390,7 +4415,7 @@ var Player = class {
       if (this.queue.current || this.queue.tracks.length) {
         const trackSources = new Set([this.queue.current, ...this.queue.tracks].map((track) => track.info.sourceName));
         const missingSources = [...trackSources].filter(
-          (source) => !updateNode.info.sourceManagers.includes(source)
+          (source) => !updateNode.info?.sourceManagers.includes(source)
         );
         if (missingSources.length)
           throw new RangeError(`Sources missing for Node ${updateNode.id}: ${missingSources.join(", ")}`);
@@ -4812,7 +4837,7 @@ var LavalinkManager = class extends EventEmitter2 {
   deletePlayer(guildId) {
     const oldPlayer = this.getPlayer(guildId);
     if (!oldPlayer) return;
-    if (oldPlayer.voiceChannelId === "string" && oldPlayer.connected && !oldPlayer.get("internal_destroywithoutdisconnect")) {
+    if (typeof oldPlayer.voiceChannelId === "string" && oldPlayer.connected && !oldPlayer.get("internal_destroywithoutdisconnect")) {
       if (!this.options?.advancedOptions?.debugOptions?.playerDestroy?.dontThrowError) throw new Error(`Use Player#destroy() not LavalinkManager#deletePlayer() to stop the Player ${safeStringify(oldPlayer.toJSON?.())}`);
       else if (this.options?.advancedOptions?.enableDebugEvents) {
         this.emit("debug", "PlayerDeleteInsteadOfDestroy" /* PlayerDeleteInsteadOfDestroy */, {
@@ -5075,6 +5100,7 @@ var LavalinkManager = class extends EventEmitter2 {
               message: `Auto reconnected, but nothing to play`,
               functionLayer: "LavalinkManager > sendRawData()"
             });
+            return;
           } catch (e) {
             console.error(e);
             return void await player.destroy("PlayerReconnectFail" /* PlayerReconnectFail */);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lavalink-client",
-  "version": "2.6.6",
+  "version": "2.7.0",
   "description": "Easy, flexible and feature-rich lavalink@v4 Client. Both for Beginners and Proficients.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -57,12 +57,12 @@
   "devDependencies": {
     "@eslint/eslintrc": "^3.3.1",
     "@eslint/js": "^9.39.1",
-    "@types/node": "^24.10.0",
+    "@types/node": "^24.10.1",
     "@types/ws": "^8.18.1",
-    "@typescript-eslint/eslint-plugin": "^8.46.3",
-    "@typescript-eslint/parser": "^8.46.3",
+    "@typescript-eslint/eslint-plugin": "^8.46.4",
+    "@typescript-eslint/parser": "^8.46.4",
     "eslint": "^9.39.1",
-    "tsup": "^8.5.0",
+    "tsup": "^8.5.1",
     "typescript": "^5.9.3"
   },
   "dependencies": {