lavalink-client 2.3.5 → 2.4.0

package/dist/esm/structures/Node.js

@@ -13,6 +13,7 @@ export class LavalinkNode {
     }
     heartBeatInterval;
     pingTimeout;
+    isAlive = false;
     /** The provided Options of the Node */
     options;
     /** The amount of rest calls the node has made. */
@@ -74,7 +75,7 @@ export class LavalinkNode {
             retryAmount: 5,
             retryDelay: 10e3,
             requestSignalTimeoutMS: 10000,
-            heartBeatInterval: 30000,
+            heartBeatInterval: 30_000,
             closeOnError: true,
             enablePingOnStatsCheck: true,
             ...options
@@ -137,32 +138,22 @@ export class LavalinkNode {
         const url = new URL(`${this.restAddress}${options.path}`);
         url.searchParams.append("trace", "true");
         const urlToUse = this.getRequestingUrl(url, options?.extraQueryUrlParams);
+        const originalOptions = structuredClone(options);
         delete options.path;
         delete options.extraQueryUrlParams;
-        const request = await fetch(urlToUse, options);
+        const response = await fetch(urlToUse, options);
         this.calls++;
-        return { request, options };
+        return { response, options: originalOptions };
     }
-    /**
-     * Makes an API call to the Node. Should only be used for manual parsing like for not supported plugins
-     * @param endpoint The endpoint that we will make the call to
-     * @param modify Used to modify the request before being sent
-     * @returns The returned data
-     *
-     * @example
-     * ```ts
-     * player.node.request(`/loadtracks?identifier=Never gonna give you up`, (options) => options.method = "GET", false);
-     * ```
-     */
-    async request(endpoint, modify, parseAsText = false) {
+    async request(endpoint, modify, parseAsText) {
         if (!this.connected)
             throw new Error("The node is not connected to the Lavalink Server!, Please call node.connect() first!");
-        const { request, options } = await this.rawRequest(endpoint, modify);
+        const { response, options } = await this.rawRequest(endpoint, modify);
         if (["DELETE", "PUT"].includes(options.method))
             return;
-        if (request.status === 404)
-            throw new Error(`Node Request resulted into an error, request-PATH: ${options.path} | headers: ${JSON.stringify(request.headers)}`);
-        return parseAsText ? await request.text() : await request.json();
+        if (response.status === 404)
+            throw new Error(`Node Request resulted into an error, request-PATH: ${options.path} | headers: ${JSON.stringify(response.headers)}`);
+        return parseAsText ? await response.text() : await response.json();
     }
     /**
      * Search something raw on the node, please note only add tracks to players of that node
@@ -237,7 +228,7 @@ export class LavalinkNode {
      * @param query LavaSearchQuery Object
      * @param requestUser Request User for creating the player(s)
      * @param throwOnEmpty Wether to throw on an empty result or not
-     * @returns LavaSearchresult
+     * @returns LavaSearchresult (SearchResult if link is provided)
      *
      * @example
      * ```ts
@@ -257,8 +248,8 @@ export class LavalinkNode {
             throw new RangeError(`there is no lavasearch-plugin available in the lavalink node: ${this.id}`);
         if (!this.info.plugins.find(v => v.name === "lavasrc-plugin"))
             throw new RangeError(`there is no lavasrc-plugin available in the lavalink node: ${this.id}`);
-        const { request } = await this.rawRequest(`/loadsearch?query=${Query.source ? `${Query.source}:` : ""}${encodeURIComponent(Query.query)}${Query.types?.length ? `&types=${Query.types.join(",")}` : ""}`);
-        const res = (request.status === 204 ? {} : await request.json());
+        const { response } = await this.rawRequest(`/loadsearch?query=${Query.source ? `${Query.source}:` : ""}${encodeURIComponent(Query.query)}${Query.types?.length ? `&types=${Query.types.join(",")}` : ""}`);
+        const res = (response.status === 204 ? {} : await response.json());
         if (throwOnEmpty === true && !Object.entries(res).flat().filter(Boolean).length) {
             if (this.NodeManager.LavalinkManager.options?.advancedOptions?.enableDebugEvents) {
                 this.NodeManager.LavalinkManager.emit("debug", DebugEvents.LavaSearchNothingFound, {
@@ -295,7 +286,6 @@ export class LavalinkNode {
         this.syncPlayerData(data);
         const res = await this.request(`/sessions/${this.sessionId}/players/${data.guildId}`, r => {
             r.method = "PATCH";
-            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
             r.headers["Content-Type"] = "application/json";
             r.body = JSON.stringify(data.playerOptions);
             if (data.noReplace) {
@@ -311,7 +301,8 @@ export class LavalinkNode {
                 functionLayer: "LavalinkNode > node > updatePlayer()",
             });
         }
-        return this.syncPlayerData({}, res), res;
+        this.syncPlayerData({}, res);
+        return res;
     }
     /**
      * Destroys the Player on the Lavalink Server
@@ -380,6 +371,7 @@ export class LavalinkNode {
         if (this.pingTimeout)
             clearTimeout(this.pingTimeout);
         this.pingTimeout = setTimeout(() => {
+            this.pingTimeout = null;
             if (!this.socket) {
                 if (this.NodeManager.LavalinkManager.options?.advancedOptions?.enableDebugEvents) {
                     this.NodeManager.LavalinkManager.emit("debug", DebugEvents.NoSocketOnDestroy, {
@@ -399,7 +391,7 @@ export class LavalinkNode {
             }
             this.isAlive = false;
             this.socket.terminate();
-        }, 65000); // the stats endpoint get's sent every 60s. se wee add a 5s buffer to make sure we don't miss any stats message
+        }, 65_000); // the stats endpoint get's sent every 60s. se wee add a 5s buffer to make sure we don't miss any stats message
     }
     /**
      * Get the id of the node
@@ -415,7 +407,7 @@ export class LavalinkNode {
     }
     /**
      * Destroys the Node-Connection (Websocket) and all player's of the node
-     * @param destroyReason Destroyreason to use when destroying the players
+     * @param destroyReason Destroy Reason to use when destroying the players
      * @param deleteNode wether to delete the nodte from the nodes list too, if false it will emit a disconnect. @default true
      * @returns void
      *
@@ -446,6 +438,28 @@ export class LavalinkNode {
         }
         return;
     }
+    /**
+     * Disconnects the Node-Connection (Websocket)
+     * @param disconnectReason Disconnect Reason to use when disconnecting Node
+     * @returns void
+     *
+     * Also the node will not get re-connected again.
+     *
+     * @example
+     * ```ts
+     * player.node.destroy("custom Player Destroy Reason", true);
+     * ```
+     */
+    disconnect(disconnectReason) {
+        if (!this.connected)
+            return;
+        this.socket.close(1000, "Node-Disconnect");
+        this.socket.removeAllListeners();
+        this.socket = null;
+        this.reconnectAttempts = 1;
+        clearTimeout(this.reconnectTimeout);
+        this.NodeManager.emit("disconnect", this, { code: 1000, reason: disconnectReason });
+    }
     /**
      * Returns if connected to the Node.
      *
@@ -456,11 +470,8 @@ export class LavalinkNode {
      * ```
      */
     get connected() {
-        if (!this.socket)
-            return false;
-        return this.socket.readyState === WebSocket.OPEN;
+        return this.socket && this.socket.readyState === WebSocket.OPEN;
     }
-    isAlive = false;
     /**
      * Returns the current ConnectionStatus
      *
@@ -581,11 +592,108 @@ export class LavalinkNode {
             return await this.request(`/decodetracks`, r => {
                 r.method = "POST";
                 r.body = JSON.stringify(encodeds);
-                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
                 r.headers["Content-Type"] = "application/json";
             }).then((r) => r.map(track => this.NodeManager.LavalinkManager.utils.buildTrack(track, requester)));
         }
     };
+    lyrics = {
+        /**
+         * Get the lyrics of a track
+         * @param track the track to get the lyrics for
+         * @param skipTrackSource wether to skip the track source or not
+         * @returns the lyrics of the track
+         * @example
+         *
+         * ```ts
+         * const lyrics = await player.node.lyrics.get(track, true);
+         * // use it of player instead:
+         * // const lyrics = await player.getLyrics(track, true);
+         * ```
+         */
+        get: async (track, skipTrackSource = false) => {
+            if (!this.sessionId)
+                throw new Error("the Lavalink-Node is either not ready, or not up to date!");
+            if (!this.info.plugins.find(v => v.name === "lavalyrics-plugin"))
+                throw new RangeError(`there is no lavalyrics-plugin available in the lavalink node (required for lyrics): ${this.id}`);
+            if (!this.info.plugins.find(v => v.name === "lavasrc-plugin") &&
+                !this.info.plugins.find(v => v.name === "java-lyrics-plugin"))
+                throw new RangeError(`there is no lyrics source (via lavasrc-plugin / java-lyrics-plugin) available in the lavalink node (required for lyrics): ${this.id}`);
+            const url = `/lyrics?track=${track.encoded}&skipTrackSource=${skipTrackSource}`;
+            return (await this.request(url));
+        },
+        /**
+         * Get the lyrics of the current playing track
+         *
+         * @param guildId the guild id of the player
+         * @param skipTrackSource wether to skip the track source or not
+         * @returns the lyrics of the current playing track
+         * @example
+         * ```ts
+         * const lyrics = await player.node.lyrics.getCurrent(guildId);
+         * // use it of player instead:
+         * // const lyrics = await player.getCurrentLyrics();
+         * ```
+         */
+        getCurrent: async (guildId, skipTrackSource = false) => {
+            if (!this.sessionId)
+                throw new Error("the Lavalink-Node is either not ready, or not up to date!");
+            if (!this.info.plugins.find(v => v.name === "lavalyrics-plugin"))
+                throw new RangeError(`there is no lavalyrics-plugin available in the lavalink node (required for lyrics): ${this.id}`);
+            if (!this.info.plugins.find(v => v.name === "lavasrc-plugin") &&
+                !this.info.plugins.find(v => v.name === "java-lyrics-plugin"))
+                throw new RangeError(`there is no lyrics source (via lavasrc-plugin / java-lyrics-plugin) available in the lavalink node (required for lyrics): ${this.id}`);
+            const url = `/sessions/${this.sessionId}/players/${guildId}/track/lyrics?skipTrackSource=${skipTrackSource}`;
+            return (await this.request(url));
+        },
+        /**
+         * subscribe to lyrics updates for a guild
+         * @param guildId the guild id of the player
+         * @returns request data of the request
+         *
+         * @example
+         * ```ts
+         * await player.node.lyrics.subscribe(guildId);
+         * // use it of player instead:
+         * // const lyrics = await player.subscribeLyrics();
+         * ```
+         */
+        subscribe: async (guildId) => {
+            if (!this.sessionId)
+                throw new Error("the Lavalink-Node is either not ready, or not up to date!");
+            if (!this.info.plugins.find(v => v.name === "lavalyrics-plugin"))
+                throw new RangeError(`there is no lavalyrics-plugin available in the lavalink node (required for lyrics): ${this.id}`);
+            if (!this.info.plugins.find(v => v.name === "lavasrc-plugin") &&
+                !this.info.plugins.find(v => v.name === "java-lyrics-plugin"))
+                throw new RangeError(`there is no lyrics source (via lavasrc-plugin / java-lyrics-plugin) available in the lavalink node (required for lyrics): ${this.id}`);
+            return await this.request(`/sessions/${this.sessionId}/players/${guildId}/lyrics/subscribe`, (options) => {
+                options.method = "POST";
+            });
+        },
+        /**
+         * unsubscribe from lyrics updates for a guild
+         * @param guildId the guild id of the player
+         * @returns request data of the request
+         *
+         * @example
+         * ```ts
+         * await player.node.lyrics.unsubscribe(guildId);
+         * // use it of player instead:
+         * // const lyrics = await player.unsubscribeLyrics();
+         * ```
+         */
+        unsubscribe: async (guildId) => {
+            if (!this.sessionId)
+                throw new Error("the Lavalink-Node is either not ready, or not up to date!");
+            if (!this.info.plugins.find(v => v.name === "lavalyrics-plugin"))
+                throw new RangeError(`there is no lavalyrics-plugin available in the lavalink node (required for lyrics): ${this.id}`);
+            if (!this.info.plugins.find(v => v.name === "lavasrc-plugin") &&
+                !this.info.plugins.find(v => v.name === "java-lyrics-plugin"))
+                throw new RangeError(`there is no lyrics source (via lavasrc-plugin / java-lyrics-plugin) available in the lavalink node (required for lyrics): ${this.id}`);
+            return await this.request(`/sessions/${this.sessionId}/players/${guildId}/lyrics/unsubscribe`, (options) => {
+                options.method = "DELETE";
+            });
+        },
+    };
     /**
      * Request Lavalink statistics.
      * @returns the lavalink node stats
@@ -658,9 +766,8 @@ export class LavalinkNode {
         unmarkFailedAddress: async (address) => {
             if (!this.sessionId)
                 throw new Error("the Lavalink-Node is either not ready, or not up to date!");
-            await this.request(`/routeplanner/free/address`, r => {
+            return await this.request(`/routeplanner/free/address`, r => {
                 r.method = "POST";
-                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
                 r.headers["Content-Type"] = "application/json";
                 r.body = JSON.stringify({ address });
             });
@@ -679,7 +786,6 @@ export class LavalinkNode {
                 throw new Error("the Lavalink-Node is either not ready, or not up to date!");
             return await this.request(`/routeplanner/free/all`, r => {
                 r.method = "POST";
-                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
                 r.headers["Content-Type"] = "application/json";
             });
         }
@@ -692,6 +798,7 @@ export class LavalinkNode {
             throw new SyntaxError("LavalinkNode requires 'host'");
         if (!this.options.port)
             throw new SyntaxError("LavalinkNode requires 'port'");
+        // TODO add more validations
     }
     /**
      * Sync the data of the player you make an action to lavalink to
@@ -756,11 +863,13 @@ export class LavalinkNode {
             const player = this.NodeManager.LavalinkManager.getPlayer(data.guildId);
             if (!player)
                 return;
-            if (typeof res?.voice?.connected === "boolean" && res.voice.connected === false)
-                return player.destroy(DestroyReasons.LavalinkNoVoice);
+            if (typeof res?.voice?.connected === "boolean" && res.voice.connected === false) {
+                player.destroy(DestroyReasons.LavalinkNoVoice);
+                return;
+            }
             player.ping.ws = res?.voice?.ping || player?.ping.ws;
         }
-        return true;
+        return;
     }
     /**
      * Get the rest Adress for making requests
@@ -794,6 +903,7 @@ export class LavalinkNode {
             return;
         }
         this.reconnectTimeout = setTimeout(() => {
+            this.reconnectTimeout = null;
             if (this.reconnectAttempts >= this.options.retryAmount) {
                 const error = new Error(`Unable to connect after ${this.options.retryAmount} attempts.`);
                 this.NodeManager.emit("error", this, error);
@@ -829,7 +939,7 @@ export class LavalinkNode {
                 this.isAlive = false;
                 this.heartBeatPingTimestamp = performance.now();
                 this.socket.ping();
-            }, this.options.heartBeatInterval || 30000);
+            }, this.options.heartBeatInterval || 30_000);
         }
         if (this.reconnectTimeout)
             clearTimeout(this.reconnectTimeout);
@@ -850,6 +960,8 @@ export class LavalinkNode {
             clearInterval(this.heartBeatInterval);
         if (code === 1006 && !reason)
             reason = "Socket got terminated due to no ping connection";
+        if (code === 1000 && reason === "Node-Disconnect")
+            return; // manually disconnected and already emitted the event.
         this.NodeManager.emit("disconnect", this, { code, reason });
         if (code !== 1000 || reason !== "Node-Destroy")
             this.reconnect();
@@ -874,7 +986,14 @@ export class LavalinkNode {
             d = Buffer.concat(d);
         else if (d instanceof ArrayBuffer)
             d = Buffer.from(d);
-        const payload = JSON.parse(d.toString());
+        let payload;
+        try {
+            payload = JSON.parse(d.toString());
+        }
+        catch (e) {
+            this.NodeManager.emit("error", this, e);
+            return;
+        }
         if (!payload.op)
             return;
         this.NodeManager.emit("raw", this, payload);
@@ -905,7 +1024,7 @@ export class LavalinkNode {
                     player.ping.ws = payload.state.ping >= 0 ? payload.state.ping : player.ping.ws <= 0 && player.connected ? null : player.ping.ws || 0;
                     if (!player.createdTimeStamp && payload.state.time)
                         player.createdTimeStamp = payload.state.time;
-                    if (player.filterManager.filterUpdatedState === true && ((player.queue.current?.info?.duration || 0) <= (player.LavalinkManager.options.advancedOptions.maxFilterFixDuration || 600000) || isAbsolute(player.queue.current?.info?.uri))) {
+                    if (player.filterManager.filterUpdatedState === true && ((player.queue.current?.info?.duration || 0) <= (player.LavalinkManager.options.advancedOptions.maxFilterFixDuration || 600_000) || isAbsolute(player.queue.current?.info?.uri))) {
                         player.filterManager.filterUpdatedState = false;
                         if (this.NodeManager.LavalinkManager.options?.advancedOptions?.enableDebugEvents) {
                             this.NodeManager.LavalinkManager.emit("debug", DebugEvents.PlayerUpdateFilterFixApply, {
@@ -982,13 +1101,22 @@ export class LavalinkNode {
             case "ChapterStarted":
                 this.SponsorBlockChapterStarted(player, player.queue.current, payload);
                 break;
+            case "LyricsLineEvent":
+                this.LyricsLine(player, player.queue.current, payload);
+                break;
+            case "LyricsFoundEvent":
+                this.LyricsFound(player, player.queue.current, payload);
+                break;
+            case "LyricsNotFoundEvent":
+                this.LyricsNotFound(player, player.queue.current, payload);
+                break;
             default:
                 this.NodeManager.emit("error", this, new Error(`Node#event unknown event '${payload.type}'.`), payload);
                 break;
         }
         return;
     }
-    async getTrackOfPayload(payload) {
+    getTrackOfPayload(payload) {
         return "track" in payload
             ? this.NodeManager.LavalinkManager.utils.buildTrack(payload.track, undefined)
             : null;
@@ -1009,7 +1137,7 @@ export class LavalinkNode {
             return;
         }
         if (!player.queue.current) {
-            player.queue.current = await this.getTrackOfPayload(payload);
+            player.queue.current = this.getTrackOfPayload(payload);
             if (player.queue.current) {
                 await player.queue.utils.save();
             }
@@ -1023,11 +1151,12 @@ export class LavalinkNode {
                 }
             }
         }
-        return this.NodeManager.LavalinkManager.emit("trackStart", player, player.queue.current, payload);
+        this.NodeManager.LavalinkManager.emit("trackStart", player, player.queue.current, payload);
+        return;
     }
     /** @private util function for handling trackEnd event */
     async trackEnd(player, track, payload) {
-        const trackToUse = track || await this.getTrackOfPayload(payload);
+        const trackToUse = track || this.getTrackOfPayload(payload);
         // If a track was forcibly played
         if (payload.reason === "replaced") {
             if (this.NodeManager.LavalinkManager.options?.advancedOptions?.enableDebugEvents) {
@@ -1037,7 +1166,8 @@ export class LavalinkNode {
                     functionLayer: "LavalinkNode > trackEnd()",
                 });
             }
-            return this.NodeManager.LavalinkManager.emit("trackEnd", player, trackToUse, payload);
+            this.NodeManager.LavalinkManager.emit("trackEnd", player, trackToUse, payload);
+            return;
         }
         // If there are no songs in the queue
         if (!player.queue.tracks.length && (player.repeatMode === "off" || player.get("internal_stopPlaying")))
@@ -1051,7 +1181,10 @@ export class LavalinkNode {
             // fire event
             this.NodeManager.LavalinkManager.emit("trackEnd", player, trackToUse, payload);
             // play track if autoSkip is true
-            return this.NodeManager.LavalinkManager.options.autoSkip && player.play({ noReplace: true });
+            if (this.NodeManager.LavalinkManager.options.autoSkip && player.queue.current) {
+                player.play({ noReplace: true });
+            }
+            return;
         }
         // remove tracks from the queue
         if (player.repeatMode !== "track" || player.get("internal_skipped"))
@@ -1069,7 +1202,10 @@ export class LavalinkNode {
         // fire event
         this.NodeManager.LavalinkManager.emit("trackEnd", player, trackToUse, payload);
         // play track if autoSkip is true
-        return this.NodeManager.LavalinkManager.options.autoSkip && player.play({ noReplace: true });
+        if (this.NodeManager.LavalinkManager.options.autoSkip && player.queue.current) {
+            player.play({ noReplace: true });
+        }
+        return;
     }
     /** @private util function for handling trackStuck event */
     async trackStuck(player, track, payload) {
@@ -1085,21 +1221,25 @@ export class LavalinkNode {
                         functionLayer: "LavalinkNode > trackStuck()",
                     });
                 }
-                return player.destroy(DestroyReasons.TrackStuckMaxTracksErroredPerTime);
+                player.destroy(DestroyReasons.TrackStuckMaxTracksErroredPerTime);
+                return;
             }
         }
-        this.NodeManager.LavalinkManager.emit("trackStuck", player, track || await this.getTrackOfPayload(payload), payload);
+        this.NodeManager.LavalinkManager.emit("trackStuck", player, track || this.getTrackOfPayload(payload), payload);
         // If there are no songs in the queue
         if (!player.queue.tracks.length && (player.repeatMode === "off" || player.get("internal_stopPlaying")))
-            return this.queueEnd(player, track || await this.getTrackOfPayload(payload), payload);
+            return this.queueEnd(player, track || this.getTrackOfPayload(payload), payload);
         // remove the current track, and enqueue the next one
         await queueTrackEnd(player);
         // if no track available, end queue
         if (!player.queue.current) {
-            return this.queueEnd(player, track || await this.getTrackOfPayload(payload), payload);
+            return this.queueEnd(player, track || this.getTrackOfPayload(payload), payload);
         }
         // play track if autoSkip is true
-        return (this.NodeManager.LavalinkManager.options.autoSkip && player.queue.current) && player.play({ noReplace: true });
+        if (this.NodeManager.LavalinkManager.options.autoSkip && player.queue.current) {
+            player.play({ noReplace: true });
+        }
+        return;
     }
     /** @private util function for handling trackError event */
     async trackError(player, track, payload) {
@@ -1115,46 +1255,37 @@ export class LavalinkNode {
                         functionLayer: "LavalinkNode > trackError()",
                     });
                 }
-                return player.destroy(DestroyReasons.TrackErrorMaxTracksErroredPerTime);
+                player.destroy(DestroyReasons.TrackErrorMaxTracksErroredPerTime);
+                return;
             }
         }
-        this.NodeManager.LavalinkManager.emit("trackError", player, track || await this.getTrackOfPayload(payload), payload);
-        return; // get's handled by trackEnd
-        // If there are no songs in the queue
-        if (!player.queue.tracks.length && (player.repeatMode === "off" || player.get("internal_stopPlaying")))
-            return this.queueEnd(player, track || await this.getTrackOfPayload(payload), payload);
-        // remove the current track, and enqueue the next one
-        await queueTrackEnd(player);
-        // if no track available, end queue
-        if (!player.queue.current)
-            return this.queueEnd(player, track || await this.getTrackOfPayload(payload), payload);
-        // play track if autoSkip is true
-        return (this.NodeManager.LavalinkManager.options.autoSkip && player.queue.current) && player.play({ noReplace: true });
+        this.NodeManager.LavalinkManager.emit("trackError", player, track || this.getTrackOfPayload(payload), payload);
+        return;
     }
     /** @private util function for handling socketClosed event */
     socketClosed(player, payload) {
         this.NodeManager.LavalinkManager.emit("playerSocketClosed", player, payload);
-        // i don't think this is needed.
-        // this.socket = null;
-        // // causing a socket reconnect
-        // this.connect();
         return;
     }
     /** @private util function for handling SponsorBlock Segmentloaded event */
     async SponsorBlockSegmentLoaded(player, track, payload) {
-        return this.NodeManager.LavalinkManager.emit("SegmentsLoaded", player, track || await this.getTrackOfPayload(payload), payload);
+        this.NodeManager.LavalinkManager.emit("SegmentsLoaded", player, track || this.getTrackOfPayload(payload), payload);
+        return;
     }
     /** @private util function for handling SponsorBlock SegmentSkipped event */
     async SponsorBlockSegmentSkipped(player, track, payload) {
-        return this.NodeManager.LavalinkManager.emit("SegmentSkipped", player, track || await this.getTrackOfPayload(payload), payload);
+        this.NodeManager.LavalinkManager.emit("SegmentSkipped", player, track || this.getTrackOfPayload(payload), payload);
+        return;
     }
     /** @private util function for handling SponsorBlock Chaptersloaded event */
     async SponsorBlockChaptersLoaded(player, track, payload) {
-        return this.NodeManager.LavalinkManager.emit("ChaptersLoaded", player, track || await this.getTrackOfPayload(payload), payload);
+        this.NodeManager.LavalinkManager.emit("ChaptersLoaded", player, track || this.getTrackOfPayload(payload), payload);
+        return;
     }
     /** @private util function for handling SponsorBlock Chaptersstarted event */
     async SponsorBlockChapterStarted(player, track, payload) {
-        return this.NodeManager.LavalinkManager.emit("ChapterStarted", player, track || await this.getTrackOfPayload(payload), payload);
+        this.NodeManager.LavalinkManager.emit("ChapterStarted", player, track || this.getTrackOfPayload(payload), payload);
+        return;
     }
     /**
      * Get the current sponsorblocks for the sponsorblock plugin
@@ -1301,8 +1432,10 @@ export class LavalinkNode {
             await player.queue.utils.save();
         }
         if (typeof this.NodeManager.LavalinkManager.options.playerOptions?.onEmptyQueue?.destroyAfterMs === "number" && !isNaN(this.NodeManager.LavalinkManager.options.playerOptions.onEmptyQueue?.destroyAfterMs) && this.NodeManager.LavalinkManager.options.playerOptions.onEmptyQueue?.destroyAfterMs >= 0) {
-            if (this.NodeManager.LavalinkManager.options.playerOptions.onEmptyQueue?.destroyAfterMs === 0)
-                return player.destroy(DestroyReasons.QueueEmpty);
+            if (this.NodeManager.LavalinkManager.options.playerOptions.onEmptyQueue?.destroyAfterMs === 0) {
+                player.destroy(DestroyReasons.QueueEmpty);
+                return;
+            }
             else {
                 if (this.NodeManager.LavalinkManager.options?.advancedOptions?.enableDebugEvents) {
                     this.NodeManager.LavalinkManager.emit("debug", DebugEvents.TriggerQueueEmptyInterval, {
@@ -1311,15 +1444,100 @@ export class LavalinkNode {
                         functionLayer: "LavalinkNode > queueEnd() > destroyAfterMs",
                     });
                 }
+                this.NodeManager.LavalinkManager.emit("playerQueueEmptyStart", player, this.NodeManager.LavalinkManager.options.playerOptions.onEmptyQueue?.destroyAfterMs);
                 if (player.get("internal_queueempty")) {
                     clearTimeout(player.get("internal_queueempty"));
                     player.set("internal_queueempty", undefined);
                 }
                 player.set("internal_queueempty", setTimeout(() => {
+                    player.set("internal_queueempty", undefined);
+                    if (player.queue.current) {
+                        return this.NodeManager.LavalinkManager.emit("playerQueueEmptyCancel", player);
+                    }
+                    this.NodeManager.LavalinkManager.emit("playerQueueEmptyEnd", player);
                     player.destroy(DestroyReasons.QueueEmpty);
                 }, this.NodeManager.LavalinkManager.options.playerOptions.onEmptyQueue?.destroyAfterMs));
             }
         }
-        return this.NodeManager.LavalinkManager.emit("queueEnd", player, track, payload);
+        this.NodeManager.LavalinkManager.emit("queueEnd", player, track, payload);
+        return;
+    }
+    /**
+     * Emitted whenever a line of lyrics gets emitted
+     * @event
+     * @param {Player} player The player that emitted the event
+     * @param {Track} track The track that emitted the event
+     * @param {LyricsLineEvent} payload The payload of the event
+     */
+    async LyricsLine(player, track, payload) {
+        if (!player.queue.current) {
+            player.queue.current = this.getTrackOfPayload(payload);
+            if (player.queue.current) {
+                await player.queue.utils.save();
+            }
+            else {
+                if (this.NodeManager.LavalinkManager.options?.advancedOptions?.enableDebugEvents) {
+                    this.NodeManager.LavalinkManager.emit("debug", DebugEvents.TrackStartNoTrack, {
+                        state: "warn",
+                        message: `Trackstart emitted but there is no track on player.queue.current, trying to get the track of the payload failed too.`,
+                        functionLayer: "LavalinkNode > trackStart()",
+                    });
+                }
+            }
+        }
+        this.NodeManager.LavalinkManager.emit("LyricsLine", player, track, payload);
+        return;
+    }
+    /**
+     * Emitted whenever the lyrics for a track got found
+     * @event
+     * @param {Player} player The player that emitted the event
+     * @param {Track} track The track that emitted the event
+     * @param {LyricsFoundEvent} payload The payload of the event
+     */
+    async LyricsFound(player, track, payload) {
+        if (!player.queue.current) {
+            player.queue.current = this.getTrackOfPayload(payload);
+            if (player.queue.current) {
+                await player.queue.utils.save();
+            }
+            else {
+                if (this.NodeManager.LavalinkManager.options?.advancedOptions?.enableDebugEvents) {
+                    this.NodeManager.LavalinkManager.emit("debug", DebugEvents.TrackStartNoTrack, {
+                        state: "warn",
+                        message: `Trackstart emitted but there is no track on player.queue.current, trying to get the track of the payload failed too.`,
+                        functionLayer: "LavalinkNode > trackStart()",
+                    });
+                }
+            }
+        }
+        this.NodeManager.LavalinkManager.emit("LyricsFound", player, track, payload);
+        return;
+    }
+    /**
+     * Emitted whenever the lyrics for a track got not found
+     * @event
+     * @param {Player} player The player that emitted the event
+     * @param {Track} track The track that emitted the event
+     * @param {LyricsNotFoundEvent} payload The payload of the event
+     */
+    async LyricsNotFound(player, track, payload) {
+        if (!player.queue.current) {
+            player.queue.current = this.getTrackOfPayload(payload);
+            if (player.queue.current) {
+                await player.queue.utils.save();
+            }
+            else {
+                if (this.NodeManager.LavalinkManager.options?.advancedOptions?.enableDebugEvents) {
+                    this.NodeManager.LavalinkManager.emit("debug", DebugEvents.TrackStartNoTrack, {
+                        state: "warn",
+                        message: `Trackstart emitted but there is no track on player.queue.current, trying to get the track of the payload failed too.`,
+                        functionLayer: "LavalinkNode > trackStart()",
+                    });
+                }
+            }
+        }
+        this.NodeManager.LavalinkManager.emit("LyricsNotFound", player, track, payload);
+        return;
     }
 }

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

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import { EventEmitter } from "events";
 import { LavalinkNode } from "./Node.js";
 import { MiniMap } from "./Utils.js";
@@ -55,9 +54,10 @@ export declare class NodeManager extends EventEmitter {
     /**
      * Disconnects all Nodes from lavalink ws sockets
      * @param deleteAllNodes if the nodes should also be deleted from nodeManager.nodes
+     * @param destroyPlayers if the players should be destroyed
      * @returns amount of disconnected Nodes
      */
-    disconnectAll(deleteAllNodes?: boolean): Promise<number>;
+    disconnectAll(deleteAllNodes?: boolean, destroyPlayers?: boolean): Promise<number>;
     /**
      * Connects all not connected nodes
      * @returns Amount of connected Nodes