lavalink-client 2.2.1 → 2.2.2

package/README.md

@@ -2,7 +2,7 @@
 Easy, flexible and feature-rich lavalink@v4 Client. Both for Beginners and Proficients.
 
 <div align="center">
-  <p> 
+  <p>
     <img src="https://madewithlove.now.sh/at?heart=true&template=for-the-badge" alt="Made with love in Austria">
     <img alt="Made with TypeScript" src="https://img.shields.io/badge/typescript-%23007ACC.svg?style=for-the-badge&logo=typescript&logoColor=white">
   </p>
@@ -75,7 +75,7 @@ Check out the [Documentation](https://lc4.gitbook.io/lavalink-client) | or the [
 
 - ✨ Choose able queue stores (maps, collections, redis, databases, ...)
   - You can create your own queueStore, thus make it easy to sync queues accross multiple connections (e.g. dashboard-bot)
-  - Automated Queue Sync methods 
+  - Automated Queue Sync methods
   - Automated unresolveable Tracks (save the queries as Partial Track Objects -> Fetch the tracks only once they are gonna play)
 
 - 😍 Included Filter & Equalizer Management
@@ -91,20 +91,20 @@ Check out the [Documentation](https://lc4.gitbook.io/lavalink-client) | or the [
 
 - 🛡️ Client Validations
   - Allows you to whitelist links and even blacklist links / words / domain names, so that it doesn't allow requests you don't want!
-  - Checks almost all Lavalink Requests for out of bound errors, right before the request is made to prevent process breaking errors. 
+  - Checks almost all Lavalink Requests for out of bound errors, right before the request is made to prevent process breaking errors.
 
 - 🧑‍💻 Memory friendly and easy style
   - Only the required data is displayed, and the store-way & types match Lavalink#IMPLEMENTATION.md
 
 - 😘 Automated Handlings
-  - Skips the songs, on TrackEnd, TrackStuck, TrackError, 
+  - Skips the songs, on TrackEnd, TrackStuck, TrackError,
   - Destroys the player on channeldelete
   - Pauses / resumes the player if it get's muted / unmuted (server-wide) [soon]
   - ...
 
 - 😁 Much much more!
 
-*** 
+***
 
 # All Events:
 
@@ -169,10 +169,10 @@ class myCustomWatcher implements QueueChangesWatcher {
         this.client = client;
     }
     shuffled(guildId, oldStoredQueue, newStoredQueue) {
-        console.log(`${this.client.guilds.cache.get(guildId)?.name || guildId}: Queue got shuffled`)    
+        console.log(`${this.client.guilds.cache.get(guildId)?.name || guildId}: Queue got shuffled`)
     }
     tracksAdd(guildId, tracks, position, oldStoredQueue, newStoredQueue) {
-        console.log(`${this.client.guilds.cache.get(guildId)?.name || guildId}: ${tracks.length} Tracks got added into the Queue at position #${position}`);    
+        console.log(`${this.client.guilds.cache.get(guildId)?.name || guildId}: ${tracks.length} Tracks got added into the Queue at position #${position}`);
     }
     tracksRemoved(guildId, tracks, position, oldStoredQueue, newStoredQueue) {
         console.log(`${this.client.guilds.cache.get(guildId)?.name || guildId}: ${tracks.length} Tracks got removed from the Queue at position #${position}`);
@@ -208,9 +208,9 @@ client.lavalink.nodeManager.on("resumed", (node, payload, fetchedPlayers) => {
     await player.queue.utils.sync(); // only works with a queuestore
     // you can now overwride the player.queue.current track from the fetchedPlayer, or use the one from the queue.uztils.sync function
     // continue with your resuming code...
-  } 
+  }
 })
-``` 
+```
 
 ***
 
@@ -228,7 +228,7 @@ const extraParams = new URLSearchParams();
 if(voice) extraParams.append(`voice`, voice);
 
 // all params for flowertts can be found here: https://flowery.pw/docs
-const response = await player.search({ 
+const response = await player.search({
   query: `${query}`,
   extraQueryUrlParams: extraParams, // as of my knowledge this is currently only used for flowertts, adjusting the playback url dynamically mid-request
   source: "ftts"
@@ -236,7 +236,7 @@ const response = await player.search({
 ```
 
 
-*** 
+***
 
 
 # UpdateLog
@@ -254,8 +254,8 @@ const response = await player.search({
   - `player.deleteSponsorBlock()` / `node.deleteSponsorBlock()`
     - That Plugin adds following **Events** to the **Manager**: `"SegmentsLoaded"`, `"SegmentSkipped"`, `"ChapterStarted"`, `"ChaptersLoaded"`
 - Example Bot show example in autoplayFunction how to "disable" / "enable" Autoplay with bot data variables.
-- Added `ManagerOptions#emitNewSongsOnly`. If set to true, it won't emit "trackStart" Event, when track.loop is active, or the new current track == the previous (current) track. 
-- Added `ManagerOptions#linksBlacklist` which allows user to specify an array of regExp / strings to match query strings (for links / words) and if a match happens it doesn't allow the request (blacklist) 
+- Added `ManagerOptions#emitNewSongsOnly`. If set to true, it won't emit "trackStart" Event, when track.loop is active, or the new current track == the previous (current) track.
+- Added `ManagerOptions#linksBlacklist` which allows user to specify an array of regExp / strings to match query strings (for links / words) and if a match happens it doesn't allow the request (blacklist)
 - Added `ManagerOptions#linksWhitelist` which allows user to specify an array of regExp / strings to match query strings (for links only) and if a match does NOT HAPPEN it doesn't allow the request (whitelist)
 - Added `ManagerOptions#linksAllowed` if set to false, it does not allow requests which are links
 - Moved `ManaagerOptions#debugOptions` to `ManaagerOptions#advancedOptions.debugOptions`
@@ -263,10 +263,10 @@ const response = await player.search({
 ### **Version 1.2.1**
 - Adjusted `player.stopPlaying()`
   - There are now following parameters. `stopPlaying(clearQueue:boolean = true, executeAutoplay:boolean = false)`.
-    - On Default it now clears the queue and stops playing. Also it does not execute Autoplay on default. IF you want the function to behave differently, you can use the 2 states for that. 
+    - On Default it now clears the queue and stops playing. Also it does not execute Autoplay on default. IF you want the function to behave differently, you can use the 2 states for that.
   - Fixed that it looped the current track if repeatmode === "track" / "queue". (it stops playing and loop stays)
 - Implemented a `parseLavalinkConnUrl(connectionUrl:string)` Util Function.
-  - It allows you to parse Lavalink Connection Data of a Lavalink Connection Url. 
+  - It allows you to parse Lavalink Connection Data of a Lavalink Connection Url.
   Pattern: `lavalink://<nodeId>:<nodeAuthorization(Password)>@<NodeHost>:<NodePort>`
   - Note that the nodeId and NodeAuthorization must be encoded via encodeURIComponents before you provide it into the function.
   - The function will return the following: `{ id: string, authorization: string, host: string, port: number }`
@@ -298,10 +298,10 @@ const response = await player.search({
 # and after  connecting the nodeManager.on("resumed", (node, payload, players) => {}) will be executed, where you can sync the players!
 
 # Node Options got adjusted # It's a property not a method should be treated readonly
-+ node.resuming: { enabled: boolean, timeout: number | null }; 
++ node.resuming: { enabled: boolean, timeout: number | null };
 
 # Player function got added to stop playing without disconnecting
-+ player.stopPlaying(clearQueue:boolean = true, executeAutoplay:boolean = false); 
++ player.stopPlaying(clearQueue:boolean = true, executeAutoplay:boolean = false);
 
 # Node functions for sponsorBlock Plugin (https://github.com/topi314/Sponsorblock-Plugin) got added
 + deleteSponsorBlock(player:Player)
@@ -321,7 +321,7 @@ const response = await player.search({
 # Lavalink track.userData got added (basically same feature as my custom pluginInfo.clientData system)
 # You only get the track.userData data through playerUpdate object
 ```
-In one of the next updates, there will be more queueWatcher options and more custom nodeevents to trace 
+In one of the next updates, there will be more queueWatcher options and more custom nodeevents to trace
 
 Most features of this update got tested, but if you encounter any bugs feel free to open an issue!
 
@@ -378,9 +378,35 @@ const extraParams = new URLSearchParams();
 if(voice) extraParams.append(`voice`, voice);
 
 // all params for flowertts can be found here: https://flowery.pw/docs
-const response = await player.search({ 
+const response = await player.search({
   query: `${query}`,
   extraQueryUrlParams: extraParams, // as of my knowledge this is currently only used for flowertts, adjusting the playback url dynamically mid-request
   source: "ftts"
 }, interaction.user);
 ```
+
+
+## **Version 2.2.2**
+- Fixed a bug in player.pause() where when you pause the track longer than the left over currentTrack.info.duration is, then it would auto skip the track on resume.
+- Fixed the handling of the previous track array ( sometimes it adds "null", due to lavalink errors )
+- Added new functions for the queue, to make migrations and coding easier for beginners,
+  - ` const previousTrack = await player.queue.shiftPrevious() ` -> removes the previously played track from the player.queue.previous array, and returns it, so you can use it for something like "play previous"
+    - *Neat 1-liner: ` await player.queue.shiftPrevious().then(clientTrack => player.play({ clientTrack })) `*
+  - ` await player.queue.remove(removeQuery) ` -> Remove function to remove stuff from the queue.tracks array., following params are valid:
+    - Array of Tracks / UnresolvedTracks, e.g. ` await player.queue.remove( player.queue.tracks.slice(4, 10) ) ` *(would remove tracks from #4 (incl.) to #10 (excl.) aka those indexes: 4, 5, 6, 7, 8, 9 - this is how array.slice works)*
+    - Single Track / UnresolveTrack, e.g. ` await player.queue.remove(player.queue.tracks[player.queue.tracks.length - 1]); ` *(would remove the last track)*
+    - Array of track-indexes, e.g. ` await player.queue.remove([1, 4, 5]) ` *(Would remove track #1, #4 and #5)*
+    - Single track index, e.g. ` await player.queue.remove(5) ` *(would remove the #5 track from the queue)*
+    - **NOTE:** I still highly recommend, to use the ` player.queue.splice() ` function for mutating the queue:
+       - it is possible to remove single tracks, multiple tracks and insert tracks at specific positions!
+    - *the remove function haven't been fully tested yet*
+  - Added `track.pluginInfo.clientData?.previousTrack` handling:
+    - If a track has this property in the pluginInfo in the clientData object set to "true" then it won't get added to the previous track array. Example:
+```js
+const previousTrack = await player.queue.shiftPrevious();
+if(previousTrack) {
+    const previousClientData = previousTrack.pluginInfo.clientData || {};
+    previousTrack.pluginInfo.clientData = { previousTrack: true, ...previousClientData }
+    await player.play({ clientTrack: previousTrack });
+}
+```

package/dist/cjs/structures/Filters.js

@@ -78,9 +78,9 @@ class FilterManager {
             // "cutoffFrequency": 284, // Integer, higher than zero, in Hz.
             // "boostFactor": 1.24389    // Float, higher than 0.0. This alters volume output. A value of 1.0 means no volume change.
             },
-            "normalization": { // Attenuates peaking where peaks are defined as having a higher value than {maxAmplitude}. 
+            "normalization": { // Attenuates peaking where peaks are defined as having a higher value than {maxAmplitude}.
             // "maxAmplitude": 0.6327, // Float, within the range of 0.0 - 1.0. A value of 0.0 mutes the output.
-            // "adaptive": true    // false 
+            // "adaptive": true    // false
             },
             "echo": { // Self-explanatory; provides an echo effect.
             // "echoLength": 0.5649, // Float, higher than 0.0, in seconds (1.0 = 1 second).
@@ -253,9 +253,9 @@ class FilterManager {
                 // "cutoffFrequency": 284, // Integer, higher than zero, in Hz.
                 // "boostFactor": 1.24389    // Float, higher than 0.0. This alters volume output. A value of 1.0 means no volume change.
                 },
-                "normalization": { // Attenuates peaking where peaks are defined as having a higher value than {maxAmplitude}. 
+                "normalization": { // Attenuates peaking where peaks are defined as having a higher value than {maxAmplitude}.
                 // "maxAmplitude": 0.6327, // Float, within the range of 0.0 - 1.0. A value of 0.0 mutes the output.
-                // "adaptive": true    // false 
+                // "adaptive": true    // false
                 },
                 "echo": { // Self-explanatory; provides an echo effect.
                 // "echoLength": 0.5649, // Float, higher than 0.0, in seconds (1.0 = 1 second).

package/dist/cjs/structures/LavalinkManager.d.ts

@@ -95,7 +95,7 @@ export interface LavalinkManagerEvents {
      * Emitted when a Track finished.
      * @event Manager#trackEnd
      */
-    "trackEnd": (player: Player, track: Track, payload: TrackEndEvent) => void;
+    "trackEnd": (player: Player, track: Track | null, payload: TrackEndEvent) => void;
     /**
      * Emitted when a Track got stuck while playing.
      * @event Manager#trackStuck
@@ -110,7 +110,7 @@ export interface LavalinkManagerEvents {
      * Emitted when the Playing finished and no more tracks in the queue.
      * @event Manager#queueEnd
      */
-    "queueEnd": (player: Player, track: Track, payload: TrackEndEvent | TrackStuckEvent | TrackExceptionEvent) => void;
+    "queueEnd": (player: Player, track: Track | UnresolvedTrack | null, payload: TrackEndEvent | TrackStuckEvent | TrackExceptionEvent) => void;
     /**
      * Emitted when a Player is created.
      * @event Manager#playerCreate
@@ -147,28 +147,28 @@ export interface LavalinkManagerEvents {
      * @link https://github.com/topi314/Sponsorblock-Plugin#segmentsloaded
      * @event Manager#trackError
      */
-    "SegmentsLoaded": (player: Player, track: Track | UnresolvedTrack, payload: SponsorBlockSegmentsLoaded) => void;
+    "SegmentsLoaded": (player: Player, track: Track | UnresolvedTrack | null, payload: SponsorBlockSegmentsLoaded) => void;
     /**
      * SPONSORBLOCK-PLUGIN EVENT
      * Emitted when a specific Segment was skipped
      * @link https://github.com/topi314/Sponsorblock-Plugin#segmentskipped
      * @event Manager#trackError
      */
-    "SegmentSkipped": (player: Player, track: Track | UnresolvedTrack, payload: SponsorBlockSegmentSkipped) => void;
+    "SegmentSkipped": (player: Player, track: Track | UnresolvedTrack | null, payload: SponsorBlockSegmentSkipped) => void;
     /**
      * SPONSORBLOCK-PLUGIN EVENT
      * Emitted when a specific Chapter starts playing
      * @link https://github.com/topi314/Sponsorblock-Plugin#chapterstarted
      * @event Manager#trackError
      */
-    "ChapterStarted": (player: Player, track: Track | UnresolvedTrack, payload: SponsorBlockChapterStarted) => void;
+    "ChapterStarted": (player: Player, track: Track | UnresolvedTrack | null, payload: SponsorBlockChapterStarted) => void;
     /**
      * SPONSORBLOCK-PLUGIN EVENT
      * Emitted when Chapters are loaded
      * @link https://github.com/topi314/Sponsorblock-Plugin#chaptersloaded
      * @event Manager#trackError
      */
-    "ChaptersLoaded": (player: Player, track: Track | UnresolvedTrack, payload: SponsorBlockChaptersLoaded) => void;
+    "ChaptersLoaded": (player: Player, track: Track | UnresolvedTrack | null, payload: SponsorBlockChaptersLoaded) => void;
 }
 export interface LavalinkManager {
     /** @private */

package/dist/cjs/structures/LavalinkManager.js

@@ -257,7 +257,7 @@ class LavalinkManager extends events_1.EventEmitter {
         const oldPlayer = this.getPlayer(guildId);
         if (!oldPlayer)
             return;
-        // oldPlayer.connected is operational. you could also do oldPlayer.voice?.token 
+        // oldPlayer.connected is operational. you could also do oldPlayer.voice?.token
         if (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 ${JSON.stringify(oldPlayer.toJSON?.())}`);

package/dist/cjs/structures/LavalinkManagerStatics.js

@@ -26,7 +26,7 @@ exports.DefaultSources = {
     "am": "amsearch",
     "musicapple": "amsearch",
     "music apple": "amsearch",
-    // spotify 
+    // spotify
     "spotify": "spsearch",
     "spsearch": "spsearch",
     "sp": "spsearch",

package/dist/cjs/structures/Node.js

@@ -355,9 +355,11 @@ class LavalinkNode {
     destroy(destroyReason, deleteNode = true) {
         if (!this.connected)
             return;
-        const players = this.NodeManager.LavalinkManager.players.filter(p => p.node.id == this.id);
+        const players = this.NodeManager.LavalinkManager.players.filter(p => p.node.id === this.id);
         if (players)
-            players.forEach(p => p.destroy(destroyReason || Player_1.DestroyReasons.NodeDestroy));
+            players.forEach(p => {
+                p.destroy(destroyReason || Player_1.DestroyReasons.NodeDestroy);
+            });
         this.socket.close(1000, "Node-Destroy");
         this.socket.removeAllListeners();
         this.socket = null;
@@ -880,7 +882,7 @@ class LavalinkNode {
         // remove tracks from the queue
         if (player.repeatMode !== "track" || player.get("internal_skipped"))
             await (0, Utils_1.queueTrackEnd)(player);
-        else if (player.queue.current) { // If there was a current Track already and repeatmode === true, add it to the queue.
+        else if (player.queue.current && !player.queue.current?.pluginInfo?.clientData?.previousTrack) { // If there was a current Track already and repeatmode === true, add it to the queue.
             player.queue.previous.unshift(player.queue.current);
             if (player.queue.previous.length > player.queue.options.maxPreviousTracks)
                 player.queue.previous.splice(player.queue.options.maxPreviousTracks, player.queue.previous.length);
@@ -1029,7 +1031,12 @@ class LavalinkNode {
             }
         }
         player.set("internal_autoplayStopPlaying", undefined);
-        player.queue.previous.unshift(track);
+        if (track && !track?.pluginInfo?.clientData?.previousTrack) { // If there was a current Track already and repeatmode === true, add it to the queue.
+            player.queue.previous.unshift(track);
+            if (player.queue.previous.length > player.queue.options.maxPreviousTracks)
+                player.queue.previous.splice(player.queue.options.maxPreviousTracks, player.queue.previous.length);
+            await player.queue.utils.save();
+        }
         if (payload?.reason !== "stopped") {
             await player.queue.utils.save();
         }

package/dist/cjs/structures/NodeManager.js

@@ -11,7 +11,9 @@ class NodeManager extends stream_1.EventEmitter {
         super();
         this.LavalinkManager = LavalinkManager;
         if (this.LavalinkManager.options.nodes)
-            this.LavalinkManager.options.nodes.forEach(node => this.createNode(node));
+            this.LavalinkManager.options.nodes.forEach(node => {
+                this.createNode(node);
+            });
     }
     /**
      * Disconnects all Nodes from lavalink ws sockets

package/dist/cjs/structures/Player.js

@@ -281,6 +281,7 @@ class Player {
         if (this.paused && !this.playing)
             throw new Error("Player is already paused - not able to pause.");
         this.paused = true;
+        this.lastPositionChange = null; // needs to removed to not cause issues
         const now = performance.now();
         await this.node.updatePlayer({ guildId: this.guildId, playerOptions: { paused: true } });
         this.ping.lavalink = Math.round((performance.now() - now) / 10) / 100;

package/dist/cjs/structures/Queue.d.ts

@@ -113,4 +113,51 @@ export declare class Queue {
      * @returns {Track} Spliced Track
      */
     splice(index: number, amount: number, TrackOrTracks?: Track | UnresolvedTrack | (Track | UnresolvedTrack)[]): any;
+    /**
+     * Remove stuff from the queue.tracks array
+     *  - single Track | UnresolvedTrack
+     *  - multiple Track | UnresovedTrack
+     *  - at the index or multiple indexes
+     * @param removeQueryTrack
+     * @returns null (if nothing was removed) / { removed } where removed is an array with all removed elements
+     *
+     * @example
+     * ```js
+     * // remove single track
+     *
+     * const track = player.queue.tracks[4];
+     * await player.queue.remove(track);
+     *
+     * // if you already have the index you can straight up pass it too
+     * await player.queue.remove(4);
+     *
+     *
+     * // if you want to remove multiple tracks, e.g. from position 4 to position 10 you can do smt like this
+     * await player.queue.remove(player.queue.tracks.slice(4, 10)) // get's the tracks from 4 - 10, which then get's found in the remove function to be removed
+     *
+     * // I still highly suggest to use .splice!
+     *
+     * await player.queue.splice(4, 10); // removes at index 4, 10 tracks
+     *
+     * await player.queue.splice(1, 1); // removes at index 1, 1 track
+     *
+     * await player.queue.splice(4, 0, ...tracks) // removes 0 tracks at position 4, and then inserts all tracks after position 4.
+     * ```
+     */
+    remove<T extends Track | UnresolvedTrack | number | Track[] | UnresolvedTrack[] | number[] | (number | Track | UnresolvedTrack)[]>(removeQueryTrack: T): Promise<{
+        removed: (Track | UnresolvedTrack)[];
+    } | null>;
+    /**
+     * Shifts the previous array, to return the last previous track & thus remove it from the previous queue
+     * @returns
+     *
+     * @example
+     * ```js
+     * // example on how to play the previous track again
+     * const previous = await player.queue.shiftPrevious(); // get the previous track and remove it from the previous queue array!!
+     * if(!previous) return console.error("No previous track found");
+     * await player.play({ clientTrack: previous }); // play it again
+     * ```
+     */
+    shiftPrevious(): Promise<Track>;
 }

package/dist/cjs/structures/Queue.js

@@ -123,7 +123,7 @@ class Queue {
         if (this.tracks.length <= 1)
             return this.tracks.length;
         // swap #1 and #2 if only 2 tracks.
-        if (this.tracks.length == 2) {
+        if (this.tracks.length === 2) {
             [this.tracks[0], this.tracks[1]] = [this.tracks[1], this.tracks[0]];
         }
         else { // randomly swap places.
@@ -197,5 +197,108 @@ class Queue {
         // return the things
         return spliced.length === 1 ? spliced[0] : spliced;
     }
+    /**
+     * Remove stuff from the queue.tracks array
+     *  - single Track | UnresolvedTrack
+     *  - multiple Track | UnresovedTrack
+     *  - at the index or multiple indexes
+     * @param removeQueryTrack
+     * @returns null (if nothing was removed) / { removed } where removed is an array with all removed elements
+     *
+     * @example
+     * ```js
+     * // remove single track
+     *
+     * const track = player.queue.tracks[4];
+     * await player.queue.remove(track);
+     *
+     * // if you already have the index you can straight up pass it too
+     * await player.queue.remove(4);
+     *
+     *
+     * // if you want to remove multiple tracks, e.g. from position 4 to position 10 you can do smt like this
+     * await player.queue.remove(player.queue.tracks.slice(4, 10)) // get's the tracks from 4 - 10, which then get's found in the remove function to be removed
+     *
+     * // I still highly suggest to use .splice!
+     *
+     * await player.queue.splice(4, 10); // removes at index 4, 10 tracks
+     *
+     * await player.queue.splice(1, 1); // removes at index 1, 1 track
+     *
+     * await player.queue.splice(4, 0, ...tracks) // removes 0 tracks at position 4, and then inserts all tracks after position 4.
+     * ```
+     */
+    async remove(removeQueryTrack) {
+        if (typeof removeQueryTrack === "number") {
+            const toRemove = this.tracks[removeQueryTrack];
+            if (!toRemove)
+                return null;
+            const removed = this.tracks.splice(removeQueryTrack, 1);
+            await this.utils.save();
+            console.log("0st", removed, toRemove);
+            return { removed };
+        }
+        if (Array.isArray(removeQueryTrack)) {
+            if (removeQueryTrack.every(v => typeof v === "number")) {
+                const removed = [];
+                for (const i of removeQueryTrack) {
+                    if (this.tracks[i])
+                        removed.push(...this.tracks.splice(i, 1));
+                }
+                console.log("1st", removed, removeQueryTrack);
+                if (!removed.length)
+                    return null;
+                await this.utils.save();
+                return { removed };
+            }
+            const tracksToRemove = this.tracks.map((v, i) => ({ v, i })).filter(({ v, i }) => removeQueryTrack.find(t => typeof t === "number" && (t === i) ||
+                typeof t === "object" && (t.encoded && t.encoded === v.encoded ||
+                    t.info?.identifier && t.info.identifier === v.info?.identifier ||
+                    t.info?.uri && t.info.uri === v.info?.uri ||
+                    t.info?.title && t.info.title === v.info?.title ||
+                    t.info?.isrc && t.info.isrc === v.info?.isrc ||
+                    t.info?.artworkUrl && t.info.artworkUrl === v.info?.artworkUrl)));
+            if (!tracksToRemove.length)
+                return null;
+            const removed = [];
+            for (const { i } of tracksToRemove) {
+                if (this.tracks[i])
+                    removed.push(...this.tracks.splice(i, 1));
+            }
+            await this.utils.save();
+            console.log("2nd", removed, tracksToRemove);
+            return { removed };
+        }
+        const toRemove = this.tracks.findIndex((v) => removeQueryTrack.encoded && removeQueryTrack.encoded === v.encoded ||
+            removeQueryTrack.info?.identifier && removeQueryTrack.info.identifier === v.info?.identifier ||
+            removeQueryTrack.info?.uri && removeQueryTrack.info.uri === v.info?.uri ||
+            removeQueryTrack.info?.title && removeQueryTrack.info.title === v.info?.title ||
+            removeQueryTrack.info?.isrc && removeQueryTrack.info.isrc === v.info?.isrc ||
+            removeQueryTrack.info?.artworkUrl && removeQueryTrack.info.artworkUrl === v.info?.artworkUrl);
+        if (toRemove < 0)
+            return null;
+        const removed = this.tracks.splice(toRemove, 1);
+        await this.utils.save();
+        console.log("3rd", removed, toRemove);
+        return { removed };
+    }
+    /**
+     * Shifts the previous array, to return the last previous track & thus remove it from the previous queue
+     * @returns
+     *
+     * @example
+     * ```js
+     * // example on how to play the previous track again
+     * const previous = await player.queue.shiftPrevious(); // get the previous track and remove it from the previous queue array!!
+     * if(!previous) return console.error("No previous track found");
+     * await player.play({ clientTrack: previous }); // play it again
+     * ```
+     */
+    async shiftPrevious() {
+        const removed = this.previous.shift();
+        if (removed)
+            await this.utils.save();
+        return removed ?? null;
+    }
 }
 exports.Queue = Queue;

package/dist/cjs/structures/Track.d.ts

@@ -81,6 +81,7 @@ export interface PluginInfo {
     uri?: string;
     /** You can put specific track information here, to transform the tracks... */
     clientData?: {
+        previousTrack?: boolean;
         [key: string]: any;
     };
 }

package/dist/cjs/structures/Utils.js

@@ -345,10 +345,11 @@ class MiniMap extends Map {
 }
 exports.MiniMap = MiniMap;
 async function queueTrackEnd(player) {
-    if (player.queue.current) { // if there was a current Track -> Add it
+    if (player.queue.current && !player.queue.current?.pluginInfo?.clientData?.previousTrack) { // If there was a current Track already and repeatmode === true, add it to the queue.
         player.queue.previous.unshift(player.queue.current);
         if (player.queue.previous.length > player.queue.options.maxPreviousTracks)
             player.queue.previous.splice(player.queue.options.maxPreviousTracks, player.queue.previous.length);
+        await player.queue.utils.save();
     }
     // and if repeatMode == queue, add it back to the queue!
     if (player.repeatMode === "queue" && player.queue.current)
@@ -378,11 +379,11 @@ async function applyUnresolvedData(resTrack, data, utils) {
             resTrack.info.author = data.info.author;
     }
     else { // only overwrite if undefined / invalid
-        if ((resTrack.info.title == 'Unknown title' || resTrack.info.title == "Unspecified description") && resTrack.info.title != data.info.title)
+        if ((resTrack.info.title === 'Unknown title' || resTrack.info.title === "Unspecified description") && resTrack.info.title != data.info.title)
             resTrack.info.title = data.info.title;
-        if (resTrack.info.author != data.info.author)
+        if (resTrack.info.author !== data.info.author)
             resTrack.info.author = data.info.author;
-        if (resTrack.info.artworkUrl != data.info.artworkUrl)
+        if (resTrack.info.artworkUrl !== data.info.artworkUrl)
             resTrack.info.artworkUrl = data.info.artworkUrl;
     }
     for (const key of Object.keys(data.info))

package/dist/esm/structures/Filters.js

@@ -75,9 +75,9 @@ export class FilterManager {
             // "cutoffFrequency": 284, // Integer, higher than zero, in Hz.
             // "boostFactor": 1.24389    // Float, higher than 0.0. This alters volume output. A value of 1.0 means no volume change.
             },
-            "normalization": { // Attenuates peaking where peaks are defined as having a higher value than {maxAmplitude}. 
+            "normalization": { // Attenuates peaking where peaks are defined as having a higher value than {maxAmplitude}.
             // "maxAmplitude": 0.6327, // Float, within the range of 0.0 - 1.0. A value of 0.0 mutes the output.
-            // "adaptive": true    // false 
+            // "adaptive": true    // false
             },
             "echo": { // Self-explanatory; provides an echo effect.
             // "echoLength": 0.5649, // Float, higher than 0.0, in seconds (1.0 = 1 second).
@@ -250,9 +250,9 @@ export class FilterManager {
                 // "cutoffFrequency": 284, // Integer, higher than zero, in Hz.
                 // "boostFactor": 1.24389    // Float, higher than 0.0. This alters volume output. A value of 1.0 means no volume change.
                 },
-                "normalization": { // Attenuates peaking where peaks are defined as having a higher value than {maxAmplitude}. 
+                "normalization": { // Attenuates peaking where peaks are defined as having a higher value than {maxAmplitude}.
                 // "maxAmplitude": 0.6327, // Float, within the range of 0.0 - 1.0. A value of 0.0 mutes the output.
-                // "adaptive": true    // false 
+                // "adaptive": true    // false
                 },
                 "echo": { // Self-explanatory; provides an echo effect.
                 // "echoLength": 0.5649, // Float, higher than 0.0, in seconds (1.0 = 1 second).

package/dist/esm/structures/LavalinkManager.d.ts

@@ -95,7 +95,7 @@ export interface LavalinkManagerEvents {
      * Emitted when a Track finished.
      * @event Manager#trackEnd
      */
-    "trackEnd": (player: Player, track: Track, payload: TrackEndEvent) => void;
+    "trackEnd": (player: Player, track: Track | null, payload: TrackEndEvent) => void;
     /**
      * Emitted when a Track got stuck while playing.
      * @event Manager#trackStuck
@@ -110,7 +110,7 @@ export interface LavalinkManagerEvents {
      * Emitted when the Playing finished and no more tracks in the queue.
      * @event Manager#queueEnd
      */
-    "queueEnd": (player: Player, track: Track, payload: TrackEndEvent | TrackStuckEvent | TrackExceptionEvent) => void;
+    "queueEnd": (player: Player, track: Track | UnresolvedTrack | null, payload: TrackEndEvent | TrackStuckEvent | TrackExceptionEvent) => void;
     /**
      * Emitted when a Player is created.
      * @event Manager#playerCreate
@@ -147,28 +147,28 @@ export interface LavalinkManagerEvents {
      * @link https://github.com/topi314/Sponsorblock-Plugin#segmentsloaded
      * @event Manager#trackError
      */
-    "SegmentsLoaded": (player: Player, track: Track | UnresolvedTrack, payload: SponsorBlockSegmentsLoaded) => void;
+    "SegmentsLoaded": (player: Player, track: Track | UnresolvedTrack | null, payload: SponsorBlockSegmentsLoaded) => void;
     /**
      * SPONSORBLOCK-PLUGIN EVENT
      * Emitted when a specific Segment was skipped
      * @link https://github.com/topi314/Sponsorblock-Plugin#segmentskipped
      * @event Manager#trackError
      */
-    "SegmentSkipped": (player: Player, track: Track | UnresolvedTrack, payload: SponsorBlockSegmentSkipped) => void;
+    "SegmentSkipped": (player: Player, track: Track | UnresolvedTrack | null, payload: SponsorBlockSegmentSkipped) => void;
     /**
      * SPONSORBLOCK-PLUGIN EVENT
      * Emitted when a specific Chapter starts playing
      * @link https://github.com/topi314/Sponsorblock-Plugin#chapterstarted
      * @event Manager#trackError
      */
-    "ChapterStarted": (player: Player, track: Track | UnresolvedTrack, payload: SponsorBlockChapterStarted) => void;
+    "ChapterStarted": (player: Player, track: Track | UnresolvedTrack | null, payload: SponsorBlockChapterStarted) => void;
     /**
      * SPONSORBLOCK-PLUGIN EVENT
      * Emitted when Chapters are loaded
      * @link https://github.com/topi314/Sponsorblock-Plugin#chaptersloaded
      * @event Manager#trackError
      */
-    "ChaptersLoaded": (player: Player, track: Track | UnresolvedTrack, payload: SponsorBlockChaptersLoaded) => void;
+    "ChaptersLoaded": (player: Player, track: Track | UnresolvedTrack | null, payload: SponsorBlockChaptersLoaded) => void;
 }
 export interface LavalinkManager {
     /** @private */

package/dist/esm/structures/LavalinkManager.js

@@ -254,7 +254,7 @@ export class LavalinkManager extends EventEmitter {
         const oldPlayer = this.getPlayer(guildId);
         if (!oldPlayer)
             return;
-        // oldPlayer.connected is operational. you could also do oldPlayer.voice?.token 
+        // oldPlayer.connected is operational. you could also do oldPlayer.voice?.token
         if (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 ${JSON.stringify(oldPlayer.toJSON?.())}`);

package/dist/esm/structures/LavalinkManagerStatics.js

@@ -23,7 +23,7 @@ export const DefaultSources = {
     "am": "amsearch",
     "musicapple": "amsearch",
     "music apple": "amsearch",
-    // spotify 
+    // spotify
     "spotify": "spsearch",
     "spsearch": "spsearch",
     "sp": "spsearch",

package/dist/esm/structures/Node.js

@@ -351,9 +351,11 @@ export class LavalinkNode {
     destroy(destroyReason, deleteNode = true) {
         if (!this.connected)
             return;
-        const players = this.NodeManager.LavalinkManager.players.filter(p => p.node.id == this.id);
+        const players = this.NodeManager.LavalinkManager.players.filter(p => p.node.id === this.id);
         if (players)
-            players.forEach(p => p.destroy(destroyReason || DestroyReasons.NodeDestroy));
+            players.forEach(p => {
+                p.destroy(destroyReason || DestroyReasons.NodeDestroy);
+            });
         this.socket.close(1000, "Node-Destroy");
         this.socket.removeAllListeners();
         this.socket = null;
@@ -876,7 +878,7 @@ export class LavalinkNode {
         // remove tracks from the queue
         if (player.repeatMode !== "track" || player.get("internal_skipped"))
             await queueTrackEnd(player);
-        else if (player.queue.current) { // If there was a current Track already and repeatmode === true, add it to the queue.
+        else if (player.queue.current && !player.queue.current?.pluginInfo?.clientData?.previousTrack) { // If there was a current Track already and repeatmode === true, add it to the queue.
             player.queue.previous.unshift(player.queue.current);
             if (player.queue.previous.length > player.queue.options.maxPreviousTracks)
                 player.queue.previous.splice(player.queue.options.maxPreviousTracks, player.queue.previous.length);
@@ -1025,7 +1027,12 @@ export class LavalinkNode {
             }
         }
         player.set("internal_autoplayStopPlaying", undefined);
-        player.queue.previous.unshift(track);
+        if (track && !track?.pluginInfo?.clientData?.previousTrack) { // If there was a current Track already and repeatmode === true, add it to the queue.
+            player.queue.previous.unshift(track);
+            if (player.queue.previous.length > player.queue.options.maxPreviousTracks)
+                player.queue.previous.splice(player.queue.options.maxPreviousTracks, player.queue.previous.length);
+            await player.queue.utils.save();
+        }
         if (payload?.reason !== "stopped") {
             await player.queue.utils.save();
         }

package/dist/esm/structures/NodeManager.js

@@ -8,7 +8,9 @@ export class NodeManager extends EventEmitter {
         super();
         this.LavalinkManager = LavalinkManager;
         if (this.LavalinkManager.options.nodes)
-            this.LavalinkManager.options.nodes.forEach(node => this.createNode(node));
+            this.LavalinkManager.options.nodes.forEach(node => {
+                this.createNode(node);
+            });
     }
     /**
      * Disconnects all Nodes from lavalink ws sockets

package/dist/esm/structures/Player.js

@@ -278,6 +278,7 @@ export class Player {
         if (this.paused && !this.playing)
             throw new Error("Player is already paused - not able to pause.");
         this.paused = true;
+        this.lastPositionChange = null; // needs to removed to not cause issues
         const now = performance.now();
         await this.node.updatePlayer({ guildId: this.guildId, playerOptions: { paused: true } });
         this.ping.lavalink = Math.round((performance.now() - now) / 10) / 100;

package/dist/esm/structures/Queue.d.ts

@@ -113,4 +113,51 @@ export declare class Queue {
      * @returns {Track} Spliced Track
      */
     splice(index: number, amount: number, TrackOrTracks?: Track | UnresolvedTrack | (Track | UnresolvedTrack)[]): any;
+    /**
+     * Remove stuff from the queue.tracks array
+     *  - single Track | UnresolvedTrack
+     *  - multiple Track | UnresovedTrack
+     *  - at the index or multiple indexes
+     * @param removeQueryTrack
+     * @returns null (if nothing was removed) / { removed } where removed is an array with all removed elements
+     *
+     * @example
+     * ```js
+     * // remove single track
+     *
+     * const track = player.queue.tracks[4];
+     * await player.queue.remove(track);
+     *
+     * // if you already have the index you can straight up pass it too
+     * await player.queue.remove(4);
+     *
+     *
+     * // if you want to remove multiple tracks, e.g. from position 4 to position 10 you can do smt like this
+     * await player.queue.remove(player.queue.tracks.slice(4, 10)) // get's the tracks from 4 - 10, which then get's found in the remove function to be removed
+     *
+     * // I still highly suggest to use .splice!
+     *
+     * await player.queue.splice(4, 10); // removes at index 4, 10 tracks
+     *
+     * await player.queue.splice(1, 1); // removes at index 1, 1 track
+     *
+     * await player.queue.splice(4, 0, ...tracks) // removes 0 tracks at position 4, and then inserts all tracks after position 4.
+     * ```
+     */
+    remove<T extends Track | UnresolvedTrack | number | Track[] | UnresolvedTrack[] | number[] | (number | Track | UnresolvedTrack)[]>(removeQueryTrack: T): Promise<{
+        removed: (Track | UnresolvedTrack)[];
+    } | null>;
+    /**
+     * Shifts the previous array, to return the last previous track & thus remove it from the previous queue
+     * @returns
+     *
+     * @example
+     * ```js
+     * // example on how to play the previous track again
+     * const previous = await player.queue.shiftPrevious(); // get the previous track and remove it from the previous queue array!!
+     * if(!previous) return console.error("No previous track found");
+     * await player.play({ clientTrack: previous }); // play it again
+     * ```
+     */
+    shiftPrevious(): Promise<Track>;
 }

package/dist/esm/structures/Queue.js

@@ -118,7 +118,7 @@ export class Queue {
         if (this.tracks.length <= 1)
             return this.tracks.length;
         // swap #1 and #2 if only 2 tracks.
-        if (this.tracks.length == 2) {
+        if (this.tracks.length === 2) {
             [this.tracks[0], this.tracks[1]] = [this.tracks[1], this.tracks[0]];
         }
         else { // randomly swap places.
@@ -192,4 +192,107 @@ export class Queue {
         // return the things
         return spliced.length === 1 ? spliced[0] : spliced;
     }
+    /**
+     * Remove stuff from the queue.tracks array
+     *  - single Track | UnresolvedTrack
+     *  - multiple Track | UnresovedTrack
+     *  - at the index or multiple indexes
+     * @param removeQueryTrack
+     * @returns null (if nothing was removed) / { removed } where removed is an array with all removed elements
+     *
+     * @example
+     * ```js
+     * // remove single track
+     *
+     * const track = player.queue.tracks[4];
+     * await player.queue.remove(track);
+     *
+     * // if you already have the index you can straight up pass it too
+     * await player.queue.remove(4);
+     *
+     *
+     * // if you want to remove multiple tracks, e.g. from position 4 to position 10 you can do smt like this
+     * await player.queue.remove(player.queue.tracks.slice(4, 10)) // get's the tracks from 4 - 10, which then get's found in the remove function to be removed
+     *
+     * // I still highly suggest to use .splice!
+     *
+     * await player.queue.splice(4, 10); // removes at index 4, 10 tracks
+     *
+     * await player.queue.splice(1, 1); // removes at index 1, 1 track
+     *
+     * await player.queue.splice(4, 0, ...tracks) // removes 0 tracks at position 4, and then inserts all tracks after position 4.
+     * ```
+     */
+    async remove(removeQueryTrack) {
+        if (typeof removeQueryTrack === "number") {
+            const toRemove = this.tracks[removeQueryTrack];
+            if (!toRemove)
+                return null;
+            const removed = this.tracks.splice(removeQueryTrack, 1);
+            await this.utils.save();
+            console.log("0st", removed, toRemove);
+            return { removed };
+        }
+        if (Array.isArray(removeQueryTrack)) {
+            if (removeQueryTrack.every(v => typeof v === "number")) {
+                const removed = [];
+                for (const i of removeQueryTrack) {
+                    if (this.tracks[i])
+                        removed.push(...this.tracks.splice(i, 1));
+                }
+                console.log("1st", removed, removeQueryTrack);
+                if (!removed.length)
+                    return null;
+                await this.utils.save();
+                return { removed };
+            }
+            const tracksToRemove = this.tracks.map((v, i) => ({ v, i })).filter(({ v, i }) => removeQueryTrack.find(t => typeof t === "number" && (t === i) ||
+                typeof t === "object" && (t.encoded && t.encoded === v.encoded ||
+                    t.info?.identifier && t.info.identifier === v.info?.identifier ||
+                    t.info?.uri && t.info.uri === v.info?.uri ||
+                    t.info?.title && t.info.title === v.info?.title ||
+                    t.info?.isrc && t.info.isrc === v.info?.isrc ||
+                    t.info?.artworkUrl && t.info.artworkUrl === v.info?.artworkUrl)));
+            if (!tracksToRemove.length)
+                return null;
+            const removed = [];
+            for (const { i } of tracksToRemove) {
+                if (this.tracks[i])
+                    removed.push(...this.tracks.splice(i, 1));
+            }
+            await this.utils.save();
+            console.log("2nd", removed, tracksToRemove);
+            return { removed };
+        }
+        const toRemove = this.tracks.findIndex((v) => removeQueryTrack.encoded && removeQueryTrack.encoded === v.encoded ||
+            removeQueryTrack.info?.identifier && removeQueryTrack.info.identifier === v.info?.identifier ||
+            removeQueryTrack.info?.uri && removeQueryTrack.info.uri === v.info?.uri ||
+            removeQueryTrack.info?.title && removeQueryTrack.info.title === v.info?.title ||
+            removeQueryTrack.info?.isrc && removeQueryTrack.info.isrc === v.info?.isrc ||
+            removeQueryTrack.info?.artworkUrl && removeQueryTrack.info.artworkUrl === v.info?.artworkUrl);
+        if (toRemove < 0)
+            return null;
+        const removed = this.tracks.splice(toRemove, 1);
+        await this.utils.save();
+        console.log("3rd", removed, toRemove);
+        return { removed };
+    }
+    /**
+     * Shifts the previous array, to return the last previous track & thus remove it from the previous queue
+     * @returns
+     *
+     * @example
+     * ```js
+     * // example on how to play the previous track again
+     * const previous = await player.queue.shiftPrevious(); // get the previous track and remove it from the previous queue array!!
+     * if(!previous) return console.error("No previous track found");
+     * await player.play({ clientTrack: previous }); // play it again
+     * ```
+     */
+    async shiftPrevious() {
+        const removed = this.previous.shift();
+        if (removed)
+            await this.utils.save();
+        return removed ?? null;
+    }
 }

package/dist/esm/structures/Track.d.ts

@@ -81,6 +81,7 @@ export interface PluginInfo {
     uri?: string;
     /** You can put specific track information here, to transform the tracks... */
     clientData?: {
+        previousTrack?: boolean;
         [key: string]: any;
     };
 }

package/dist/esm/structures/Utils.js

@@ -339,10 +339,11 @@ export class MiniMap extends Map {
     }
 }
 export async function queueTrackEnd(player) {
-    if (player.queue.current) { // if there was a current Track -> Add it
+    if (player.queue.current && !player.queue.current?.pluginInfo?.clientData?.previousTrack) { // If there was a current Track already and repeatmode === true, add it to the queue.
         player.queue.previous.unshift(player.queue.current);
         if (player.queue.previous.length > player.queue.options.maxPreviousTracks)
             player.queue.previous.splice(player.queue.options.maxPreviousTracks, player.queue.previous.length);
+        await player.queue.utils.save();
     }
     // and if repeatMode == queue, add it back to the queue!
     if (player.repeatMode === "queue" && player.queue.current)
@@ -371,11 +372,11 @@ async function applyUnresolvedData(resTrack, data, utils) {
             resTrack.info.author = data.info.author;
     }
     else { // only overwrite if undefined / invalid
-        if ((resTrack.info.title == 'Unknown title' || resTrack.info.title == "Unspecified description") && resTrack.info.title != data.info.title)
+        if ((resTrack.info.title === 'Unknown title' || resTrack.info.title === "Unspecified description") && resTrack.info.title != data.info.title)
             resTrack.info.title = data.info.title;
-        if (resTrack.info.author != data.info.author)
+        if (resTrack.info.author !== data.info.author)
             resTrack.info.author = data.info.author;
-        if (resTrack.info.artworkUrl != data.info.artworkUrl)
+        if (resTrack.info.artworkUrl !== data.info.artworkUrl)
             resTrack.info.artworkUrl = data.info.artworkUrl;
     }
     for (const key of Object.keys(data.info))

package/dist/types/structures/LavalinkManager.d.ts

@@ -95,7 +95,7 @@ export interface LavalinkManagerEvents {
      * Emitted when a Track finished.
      * @event Manager#trackEnd
      */
-    "trackEnd": (player: Player, track: Track, payload: TrackEndEvent) => void;
+    "trackEnd": (player: Player, track: Track | null, payload: TrackEndEvent) => void;
     /**
      * Emitted when a Track got stuck while playing.
      * @event Manager#trackStuck
@@ -110,7 +110,7 @@ export interface LavalinkManagerEvents {
      * Emitted when the Playing finished and no more tracks in the queue.
      * @event Manager#queueEnd
      */
-    "queueEnd": (player: Player, track: Track, payload: TrackEndEvent | TrackStuckEvent | TrackExceptionEvent) => void;
+    "queueEnd": (player: Player, track: Track | UnresolvedTrack | null, payload: TrackEndEvent | TrackStuckEvent | TrackExceptionEvent) => void;
     /**
      * Emitted when a Player is created.
      * @event Manager#playerCreate
@@ -147,28 +147,28 @@ export interface LavalinkManagerEvents {
      * @link https://github.com/topi314/Sponsorblock-Plugin#segmentsloaded
      * @event Manager#trackError
      */
-    "SegmentsLoaded": (player: Player, track: Track | UnresolvedTrack, payload: SponsorBlockSegmentsLoaded) => void;
+    "SegmentsLoaded": (player: Player, track: Track | UnresolvedTrack | null, payload: SponsorBlockSegmentsLoaded) => void;
     /**
      * SPONSORBLOCK-PLUGIN EVENT
      * Emitted when a specific Segment was skipped
      * @link https://github.com/topi314/Sponsorblock-Plugin#segmentskipped
      * @event Manager#trackError
      */
-    "SegmentSkipped": (player: Player, track: Track | UnresolvedTrack, payload: SponsorBlockSegmentSkipped) => void;
+    "SegmentSkipped": (player: Player, track: Track | UnresolvedTrack | null, payload: SponsorBlockSegmentSkipped) => void;
     /**
      * SPONSORBLOCK-PLUGIN EVENT
      * Emitted when a specific Chapter starts playing
      * @link https://github.com/topi314/Sponsorblock-Plugin#chapterstarted
      * @event Manager#trackError
      */
-    "ChapterStarted": (player: Player, track: Track | UnresolvedTrack, payload: SponsorBlockChapterStarted) => void;
+    "ChapterStarted": (player: Player, track: Track | UnresolvedTrack | null, payload: SponsorBlockChapterStarted) => void;
     /**
      * SPONSORBLOCK-PLUGIN EVENT
      * Emitted when Chapters are loaded
      * @link https://github.com/topi314/Sponsorblock-Plugin#chaptersloaded
      * @event Manager#trackError
      */
-    "ChaptersLoaded": (player: Player, track: Track | UnresolvedTrack, payload: SponsorBlockChaptersLoaded) => void;
+    "ChaptersLoaded": (player: Player, track: Track | UnresolvedTrack | null, payload: SponsorBlockChaptersLoaded) => void;
 }
 export interface LavalinkManager {
     /** @private */

package/dist/types/structures/Queue.d.ts

@@ -113,4 +113,51 @@ export declare class Queue {
      * @returns {Track} Spliced Track
      */
     splice(index: number, amount: number, TrackOrTracks?: Track | UnresolvedTrack | (Track | UnresolvedTrack)[]): any;
+    /**
+     * Remove stuff from the queue.tracks array
+     *  - single Track | UnresolvedTrack
+     *  - multiple Track | UnresovedTrack
+     *  - at the index or multiple indexes
+     * @param removeQueryTrack
+     * @returns null (if nothing was removed) / { removed } where removed is an array with all removed elements
+     *
+     * @example
+     * ```js
+     * // remove single track
+     *
+     * const track = player.queue.tracks[4];
+     * await player.queue.remove(track);
+     *
+     * // if you already have the index you can straight up pass it too
+     * await player.queue.remove(4);
+     *
+     *
+     * // if you want to remove multiple tracks, e.g. from position 4 to position 10 you can do smt like this
+     * await player.queue.remove(player.queue.tracks.slice(4, 10)) // get's the tracks from 4 - 10, which then get's found in the remove function to be removed
+     *
+     * // I still highly suggest to use .splice!
+     *
+     * await player.queue.splice(4, 10); // removes at index 4, 10 tracks
+     *
+     * await player.queue.splice(1, 1); // removes at index 1, 1 track
+     *
+     * await player.queue.splice(4, 0, ...tracks) // removes 0 tracks at position 4, and then inserts all tracks after position 4.
+     * ```
+     */
+    remove<T extends Track | UnresolvedTrack | number | Track[] | UnresolvedTrack[] | number[] | (number | Track | UnresolvedTrack)[]>(removeQueryTrack: T): Promise<{
+        removed: (Track | UnresolvedTrack)[];
+    } | null>;
+    /**
+     * Shifts the previous array, to return the last previous track & thus remove it from the previous queue
+     * @returns
+     *
+     * @example
+     * ```js
+     * // example on how to play the previous track again
+     * const previous = await player.queue.shiftPrevious(); // get the previous track and remove it from the previous queue array!!
+     * if(!previous) return console.error("No previous track found");
+     * await player.play({ clientTrack: previous }); // play it again
+     * ```
+     */
+    shiftPrevious(): Promise<Track>;
 }

package/dist/types/structures/Track.d.ts

@@ -81,6 +81,7 @@ export interface PluginInfo {
     uri?: string;
     /** You can put specific track information here, to transform the tracks... */
     clientData?: {
+        previousTrack?: boolean;
         [key: string]: any;
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lavalink-client",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "Easy, flexible and feature-rich lavalink@v4 Client. Both for Beginners and Proficients.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",