lavalink-client 2.3.6 → 2.4.0

package/README.md

@@ -13,7 +13,7 @@ Easy, flexible and feature-rich lavalink@v4 Client. Both for Beginners and Profi
     <a href="https://www.npmjs.com/package/lavalink-client">
       <img src="https://img.shields.io/npm/dt/lavalink-client.svg?maxAge=3600&style=for-the-badge&logo=npm&logoColor=red" alt="NPM downloads" />
     </a>
-    <a href="https://lc4.gitbook.io/lavalink-client/">
+    <a href="https://tomato6966.github.io/lavalink-client/">
       <img src="https://img.shields.io/badge/Documation-%230288D1.svg?style=for-the-badge&logo=gitbook&logoColor=white" alt="Get Started Now">
     </a>
   </p>
@@ -24,7 +24,7 @@ Easy, flexible and feature-rich lavalink@v4 Client. Both for Beginners and Profi
 
 # Install
 
-Latest stable Version: **`v2.1.3`**
+Latest stable Version: **`v2.4.0`**
 
 <details><summary>👉 via NPM</summary>
 
@@ -36,7 +36,7 @@ npm install --save lavalink-client
 Dev Version: (Current)
 
 ```bash
-npm install tomato6966/lavalink-client
+npm install --save  tomato6966/lavalink-client
 ```
 
 </details>
@@ -57,9 +57,10 @@ yarn add tomato6966/lavalink-client
 
 # Documentation
 
-Check out the [Documentation](https://lc4.gitbook.io/lavalink-client) | or the [TSDocumentation](https://tomato6966.github.io/lavalink-client/) for **Examples**, and **__detailled__ Docs**, and to figure out **how to get started**. *note: it's not fully done yet (see the docs)*
-
-- __**INFO Note**__: Please use the **[TSDocumentation (auto generated, folder `/tsDocs`)](https://tomato6966.github.io/lavalink-client/)** to get the entire information of lavalink-client, *I don't have time to update the [custom written gitbook-documentation](https://lc4.gitbook.io/lavalink-client) (folder `/docs`, feel free to update it)*
+Check out the [Documentation](https://tomato6966.github.io/lavalink-client/)
+- See all [Manager-Events, e.g. for Track / player and general errors / logs](https://tomato6966.github.io/lavalink-client/extra/manager-events)
+- See all [NodeManager-Events e.g. for Node Errors / logs](https://tomato6966.github.io/lavalink-client/extra/node-events)
+- See the Guide on [How to do resuming](https://tomato6966.github.io/lavalink-client/extra/resuming)
 
 # Used in:
 
@@ -724,7 +725,7 @@ if(previousTrack) {
 - Added more samples to the Testbot related configuration
 
 
-## **Version 2.3.6
+## **Version 2.3.6**
 - Added Lyrics Support:
   - New Player Functions:
     - **` const lyrics = await player.getCurrentLyrics(false); `** -> *Get lyrics of current playing track*
@@ -740,3 +741,51 @@ if(previousTrack) {
     - **` lavalink.on("LyricsLine", (player, track, lyricsLine) => {}); `**
     - **` lavalink.on("LyricsFound", (player, track, data) => {}); `**
     - **` lavalink.on("LyricsNotFound", (player, track, lyricsLine) => {}); `**
+
+
+## **Version 2.4.0**
+- Refactored a little the project folder Structure
+- Added PR Packages to install all commits / packages at once `https://pkg.pr.new/Tomato6966/lavalink-client`
+- Removed the dist folder, and added prepare Scripts
+- Added attributes for git linting
+- Removed the old (gitbook) documentation, and swapped it to a NEW TSDOC Themed Documentation via astro.dev and mdx
+- Added new player events:
+    - **`playerMuteChange`**** ➡️ **`(player, selfMuted, serverMuted) => {}`
+    *Triggered when the player's voice state related to muting changed*
+
+    - **`playerDeafChange`** ➡️ `(player, selfDeafed, serverDeafed) => {}`
+    *Triggered when the player's voice state related to deafing changed*
+
+    - **`playerSuppressChange`** ➡️ `(player, suppress) => {}`
+    *Triggered when the player's voice state related to suppressing changed*
+
+    - **`playerQueueEmptyStart`** ➡️ `(player, timeoutMs) => {}`
+    *Triggered when the queue empty handler started (the timeout)*
+
+    - **`playerQueueEmptyEnd`** ➡️ `(player) => {}`
+    *Triggered when the queue empty handler finished (successfully) and thus destroyed the player*
+
+    - **`playerQueueEmptyCancel`** ➡️ `(player) => {}`
+    *Triggered when the queue empty handler cancelled (e.g. because a new track got added)*
+
+    ~~- **`playerVoiceEmptyStart`** ➡️ `(player, timeoutMs) => {}`~~
+    ~~*Triggered when the voice empty handler started (the timeout)*~~
+    *Removed again because of memory overhall and not wanting to handle voice states*
+
+    ~~- **`playerVoiceEmptyEnd`** ➡️ `(player) => {}`~~
+    ~~*Triggered when the voice empty handler finished (successfully) and thus destroyed the player*~~
+    *Removed again because of memory overhall and not wanting to handle voice states*
+
+    ~~- **`playerVoiceEmptyCancel`** ➡️ `(player, userId) => {}`~~
+    ~~*Triggered when the voice empty handler cancelled (e.g. when a user rejoined)*~~
+    *Removed again because of memory overhall and not wanting to handle voice states*
+
+    - **`playerVoiceJoin`** ➡️ `(player, userId) => {}`~~
+    *Added instead of the playerVoiceEmpty handler, emitted when a user joins the player-vc while there is a player*
+    *Allows you to inmplement a custom playerVoiceEmpty handler*
+
+    - **`playerVoiceLeave`** ➡️ `(player, userId) => {}`~~
+    *Added instead of the playerVoiceEmpty handler, emitted when a user leaves (or. switches away) the player-vc while there is a player*
+    *Allows you to inmplement a custom playerVoiceEmpty handler*
+
+- Added the new events and configuration to the docs

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

@@ -55,6 +55,10 @@ export declare enum DestroyReasons {
     TrackErrorMaxTracksErroredPerTime = "TrackErrorMaxTracksErroredPerTime",
     TrackStuckMaxTracksErroredPerTime = "TrackStuckMaxTracksErroredPerTime"
 }
+export declare enum DisconnectReasons {
+    Disconnected = "Disconnected",
+    DisconnectAllNodes = "DisconnectAllNodes"
+}
 export declare const validSponsorBlocks: string[];
 /**  The audio Outputs Data map declaration */
 export declare const audioOutputsData: Record<AudioOutputs, ChannelMixFilter>;

package/dist/cjs/structures/Constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EQList = exports.audioOutputsData = exports.validSponsorBlocks = exports.DestroyReasons = exports.DebugEvents = void 0;
+exports.EQList = exports.audioOutputsData = exports.validSponsorBlocks = exports.DisconnectReasons = exports.DestroyReasons = exports.DebugEvents = void 0;
 var DebugEvents;
 (function (DebugEvents) {
     DebugEvents["SetSponsorBlock"] = "SetSponsorBlock";
@@ -60,11 +60,16 @@ var DestroyReasons;
     DestroyReasons["TrackStuckMaxTracksErroredPerTime"] = "TrackStuckMaxTracksErroredPerTime";
 })(DestroyReasons || (exports.DestroyReasons = DestroyReasons = {}));
 ;
+var DisconnectReasons;
+(function (DisconnectReasons) {
+    DisconnectReasons["Disconnected"] = "Disconnected";
+    DisconnectReasons["DisconnectAllNodes"] = "DisconnectAllNodes";
+})(DisconnectReasons || (exports.DisconnectReasons = DisconnectReasons = {}));
 exports.validSponsorBlocks = ["sponsor", "selfpromo", "interaction", "intro", "outro", "preview", "music_offtopic", "filler"];
 /**  The audio Outputs Data map declaration */
 exports.audioOutputsData = {
     mono: {
-        leftToLeft: 0.5,
+        leftToLeft: 0.5, //each channel should in total 0 | 1, 0 === off, 1 === on, 0.5+0.5 === 1
         leftToRight: 0.5,
         rightToLeft: 0.5,
         rightToRight: 0.5,

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

@@ -87,9 +87,33 @@ export declare class FilterManager {
      */
     toggleLowPass(smoothing?: number): Promise<boolean>;
     lavalinkLavaDspxPlugin: {
+        /**
+         * Enables / Disables the LowPass effect, (Optional: provide your Own Data)
+         * @param boostFactor
+         * @param cutoffFrequency
+         * @returns
+         */
         toggleLowPass: (boostFactor?: number, cutoffFrequency?: number) => Promise<boolean>;
+        /**
+         * Enables / Disables the HighPass effect, (Optional: provide your Own Data)
+         * @param boostFactor
+         * @param cutoffFrequency
+         * @returns
+         */
         toggleHighPass: (boostFactor?: number, cutoffFrequency?: number) => Promise<boolean>;
+        /**
+         * Enables / Disables the Normalization effect.
+         * @param {number} [maxAmplitude=0.75] - The maximum amplitude of the audio.
+         * @param {boolean} [adaptive=true] - Whether to use adaptive normalization or not.
+         * @returns {Promise<boolean>} - The state of the filter after execution.
+         */
         toggleNormalization: (maxAmplitude?: number, adaptive?: boolean) => Promise<boolean>;
+        /**
+         * Enables / Disables the Echo effect, IMPORTANT! Only works with the correct Lavalink Plugin installed. (Optional: provide your Own Data)
+         * @param {number} [decay=0.5] - The decay of the echo effect.
+         * @param {number} [echoLength=0.5] - The length of the echo effect.
+         * @returns {Promise<boolean>} - The state of the filter after execution.
+         */
         toggleEcho: (decay?: number, echoLength?: number) => Promise<boolean>;
     };
     lavalinkFilterPlugin: {

package/dist/cjs/structures/Filters.js

@@ -45,29 +45,29 @@ class FilterManager {
             filterWidth: 0
         },
         timescale: {
-            speed: 1,
-            pitch: 1,
+            speed: 1, // 0 = x
+            pitch: 1, // 0 = x
             rate: 1 // 0 = x
         },
         rotation: {
             rotationHz: 0
         },
         tremolo: {
-            frequency: 0,
+            frequency: 0, // 0 < x
             depth: 0 // 0 < x = 1
         },
         vibrato: {
-            frequency: 0,
+            frequency: 0, // 0 < x <= 14
             depth: 0 // 0 < x <= 1
         },
         pluginFilters: {
             "lavalink-filter-plugin": {
                 echo: {
-                    delay: 0,
+                    delay: 0, // in seconds
                     decay: 0 // 0 < 1
                 },
                 reverb: {
-                    delays: [],
+                    delays: [], // [0.037, 0.042, 0.048, 0.053]
                     gains: [] // [0.84, 0.83, 0.82, 0.81]
                 }
             },
@@ -231,8 +231,8 @@ class FilterManager {
                 filterWidth: 0
             },
             timescale: {
-                speed: 1,
-                pitch: 1,
+                speed: 1, // 0 = x
+                pitch: 1, // 0 = x
                 rate: 1 // 0 = x
             },
             pluginFilters: {
@@ -267,11 +267,11 @@ class FilterManager {
                 rotationHz: 0
             },
             tremolo: {
-                frequency: 0,
+                frequency: 0, // 0 < x
                 depth: 0 // 0 < x = 1
             },
             vibrato: {
-                frequency: 0,
+                frequency: 0, // 0 < x = 14
                 depth: 0 // 0 < x = 1
             },
             channelMix: Constants_1.audioOutputsData.stereo,
@@ -431,6 +431,12 @@ class FilterManager {
         return this.filters.lowPass;
     }
     lavalinkLavaDspxPlugin = {
+        /**
+         * Enables / Disables the LowPass effect, (Optional: provide your Own Data)
+         * @param boostFactor
+         * @param cutoffFrequency
+         * @returns
+         */
         toggleLowPass: async (boostFactor = 1.0, cutoffFrequency = 80) => {
             if (this.player.node.info && !this.player.node.info?.plugins?.find(v => v.name === "lavadspx-plugin"))
                 throw new Error("Node#Info#plugins does not include the lavadspx plugin");
@@ -455,6 +461,12 @@ class FilterManager {
             await this.applyPlayerFilters();
             return this.filters.lavalinkLavaDspxPlugin.lowPass;
         },
+        /**
+         * Enables / Disables the HighPass effect, (Optional: provide your Own Data)
+         * @param boostFactor
+         * @param cutoffFrequency
+         * @returns
+         */
         toggleHighPass: async (boostFactor = 1.0, cutoffFrequency = 80) => {
             if (this.player.node.info && !this.player.node.info?.plugins?.find(v => v.name === "lavadspx-plugin"))
                 throw new Error("Node#Info#plugins does not include the lavadspx plugin");
@@ -479,6 +491,12 @@ class FilterManager {
             await this.applyPlayerFilters();
             return this.filters.lavalinkLavaDspxPlugin.highPass;
         },
+        /**
+         * Enables / Disables the Normalization effect.
+         * @param {number} [maxAmplitude=0.75] - The maximum amplitude of the audio.
+         * @param {boolean} [adaptive=true] - Whether to use adaptive normalization or not.
+         * @returns {Promise<boolean>} - The state of the filter after execution.
+         */
         toggleNormalization: async (maxAmplitude = 0.75, adaptive = true) => {
             if (this.player.node.info && !this.player.node.info?.plugins?.find(v => v.name === "lavadspx-plugin"))
                 throw new Error("Node#Info#plugins does not include the lavadspx plugin");
@@ -503,6 +521,12 @@ class FilterManager {
             await this.applyPlayerFilters();
             return this.filters.lavalinkLavaDspxPlugin.normalization;
         },
+        /**
+         * Enables / Disables the Echo effect, IMPORTANT! Only works with the correct Lavalink Plugin installed. (Optional: provide your Own Data)
+         * @param {number} [decay=0.5] - The decay of the echo effect.
+         * @param {number} [echoLength=0.5] - The length of the echo effect.
+         * @returns {Promise<boolean>} - The state of the filter after execution.
+         */
         toggleEcho: async (decay = 0.5, echoLength = 0.5) => {
             if (this.player.node.info && !this.player.node.info?.plugins?.find(v => v.name === "lavadspx-plugin"))
                 throw new Error("Node#Info#plugins does not include the lavadspx plugin");

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

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import { EventEmitter } from "events";
 import { NodeManager } from "./NodeManager.js";
 import { Player } from "./Player.js";
@@ -137,7 +136,7 @@ export declare class LavalinkManager extends EventEmitter {
      * ```
      * @returns
      */
-    getPlayer(guildId: string): Player;
+    getPlayer(guildId: string): Player | undefined;
     /**
      * Create a Music-Player. If a player exists, then it returns it before creating a new one
      * @param options
@@ -175,7 +174,7 @@ export declare class LavalinkManager extends EventEmitter {
      * // recommend to do it on the player tho: player.destroy("forcefully destroyed the player");
      * ```
      */
-    destroyPlayer(guildId: string, destroyReason?: string): Promise<Player>;
+    destroyPlayer(guildId: string, destroyReason?: string): Promise<void | Player>;
     /**
      * Delete's a player from the cache without destroying it on lavalink (only works when it's disconnected)
      * @param guildId
@@ -187,7 +186,7 @@ export declare class LavalinkManager extends EventEmitter {
      * // shouldn't be used except you know what you are doing.
      * ```
      */
-    deletePlayer(guildId: string): boolean;
+    deletePlayer(guildId: string): boolean | void;
     /**
      * Checks wether the the lib is useable based on if any node is connected
      *
@@ -213,7 +212,7 @@ export declare class LavalinkManager extends EventEmitter {
      * });
      * ```
      */
-    init(clientData: BotClientOptions): Promise<this>;
+    init(clientData: BotClientOptions): Promise<LavalinkManager>;
     /**
      * Sends voice data to the Lavalink server.
      * ! Without this the library won't work

package/dist/cjs/structures/LavalinkManager.js

@@ -92,9 +92,9 @@ class LavalinkManager extends events_1.EventEmitter {
                 volumeDecrementer: options?.playerOptions?.volumeDecrementer ?? 1,
                 requesterTransformer: options?.playerOptions?.requesterTransformer ?? null,
                 useUnresolvedData: options?.playerOptions?.useUnresolvedData ?? false,
-                minAutoPlayMs: options?.playerOptions?.minAutoPlayMs ?? 10000,
+                minAutoPlayMs: options?.playerOptions?.minAutoPlayMs ?? 10_000,
                 maxErrorsPerTime: {
-                    threshold: options?.playerOptions?.maxErrorsPerTime?.threshold ?? 35000,
+                    threshold: options?.playerOptions?.maxErrorsPerTime?.threshold ?? 35_000,
                     maxAmount: options?.playerOptions?.maxErrorsPerTime?.maxAmount ?? 3
                 }
             },
@@ -111,7 +111,7 @@ class LavalinkManager extends events_1.EventEmitter {
             },
             advancedOptions: {
                 enableDebugEvents: options?.advancedOptions?.enableDebugEvents ?? false,
-                maxFilterFixDuration: options?.advancedOptions?.maxFilterFixDuration ?? 600000,
+                maxFilterFixDuration: options?.advancedOptions?.maxFilterFixDuration ?? 600_000,
                 debugOptions: {
                     logCustomSearches: options?.advancedOptions?.debugOptions?.logCustomSearches ?? false,
                     noAudio: options?.advancedOptions?.debugOptions?.noAudio ?? false,
@@ -509,11 +509,16 @@ class LavalinkManager extends events_1.EventEmitter {
             }
             /* voice state update */
             if (update.user_id !== this.options?.client.id) {
-                this.emit("debug", Constants_1.DebugEvents.NoAudioDebug, {
-                    state: "warn",
-                    message: `voice update user is not equal to provided client id of the LavalinkManager.options.client.id :: user: "${update.user_id}" manager client id: "${this.options?.client.id}"`,
-                    functionLayer: "LavalinkManager > sendRawData()",
-                });
+                if (update.user_id && player.voiceChannelId) {
+                    this.emit(update.channel_id === player.voiceChannelId ? "playerVoiceJoin" : "playerVoiceLeave", player, update.user_id);
+                }
+                if (this.options?.advancedOptions?.enableDebugEvents) {
+                    this.emit("debug", Constants_1.DebugEvents.NoAudioDebug, {
+                        state: "warn",
+                        message: `voice update user is not equal to provided client id of the LavalinkManager.options.client.id :: user: "${update.user_id}" manager client id: "${this.options?.client.id}"`,
+                        functionLayer: "LavalinkManager > sendRawData()",
+                    });
+                }
                 if (this.options?.advancedOptions?.debugOptions?.noAudio === true)
                     console.debug("Lavalink-Client-Debug | NO-AUDIO [::] sendRawData function, voice update user is not equal to provided client id of the manageroptions#client#id", "user:", update.user_id, "manager client id:", this.options?.client.id);
                 return;
@@ -523,6 +528,22 @@ class LavalinkManager extends events_1.EventEmitter {
                     this.emit("playerMove", player, player.voiceChannelId, update.channel_id);
                 player.voice.sessionId = update.session_id;
                 player.voiceChannelId = update.channel_id;
+                const selfMuteChanged = typeof update.self_mute === "boolean" && player.voiceState.selfMute !== update.self_mute;
+                const serverMuteChanged = typeof update.mute === "boolean" && player.voiceState.serverMute !== update.mute;
+                const selfDeafChanged = typeof update.self_deaf === "boolean" && player.voiceState.selfDeaf !== update.self_deaf;
+                const serverDeafChanged = typeof update.deaf === "boolean" && player.voiceState.serverDeaf !== update.deaf;
+                const suppressChange = typeof update.suppress === "boolean" && player.voiceState.suppress !== update.suppress;
+                player.voiceState.selfDeaf = update.self_deaf ?? player.voiceState?.selfDeaf;
+                player.voiceState.selfMute = update.self_mute ?? player.voiceState?.selfMute;
+                player.voiceState.serverDeaf = update.deaf ?? player.voiceState?.serverDeaf;
+                player.voiceState.serverMute = update.mute ?? player.voiceState?.serverMute;
+                player.voiceState.suppress = update.suppress ?? player.voiceState?.suppress;
+                if (selfMuteChanged || serverMuteChanged)
+                    this.emit("playerMuteChange", player, player.voiceState.selfMute, player.voiceState.serverMute);
+                if (selfDeafChanged || serverDeafChanged)
+                    this.emit("playerDeafChange", player, player.voiceState.selfDeaf, player.voiceState.serverDeaf);
+                if (suppressChange)
+                    this.emit("playerSuppressChange", player, player.voiceState.suppress);
             }
             else {
                 if (this.options?.playerOptions?.onDisconnect?.destroyPlayer === true) {
@@ -532,11 +553,13 @@ class LavalinkManager extends events_1.EventEmitter {
                 if (this.options?.playerOptions?.onDisconnect?.autoReconnect === true) {
                     try {
                         const positionPrevios = player.position;
-                        this.emit("debug", Constants_1.DebugEvents.PlayerAutoReconnect, {
-                            state: "log",
-                            message: `Auto reconnecting player because LavalinkManager.options.playerOptions.onDisconnect.autoReconnect is true`,
-                            functionLayer: "LavalinkManager > sendRawData()",
-                        });
+                        if (this.options?.advancedOptions?.enableDebugEvents) {
+                            this.emit("debug", Constants_1.DebugEvents.PlayerAutoReconnect, {
+                                state: "log",
+                                message: `Auto reconnecting player because LavalinkManager.options.playerOptions.onDisconnect.autoReconnect is true`,
+                                functionLayer: "LavalinkManager > sendRawData()",
+                            });
+                        }
                         await player.connect();
                         // replay the current playing stream
                         await player.play({
@@ -554,7 +577,6 @@ class LavalinkManager extends events_1.EventEmitter {
                 player.voice = Object.assign({});
                 return;
             }
-            return;
         }
     }
 }

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

@@ -1,5 +1,5 @@
 import type { Player } from "./Player.js";
-import type { DestroyReasonsType } from "./Types/Player.js";
+import type { DestroyReasonsType, DisconnectReasonsType } from "./Types/Player.js";
 import type { Track } from "./Types/Track.js";
 import type { Base64, InvalidLavalinkRestRequest, LavalinkPlayer, LavaSearchQuery, LavaSearchResponse, PlayerUpdateInfo, RoutePlanner, SearchQuery, SearchResult, Session } from "./Types/Utils.js";
 import type { NodeManager } from "./NodeManager.js";
@@ -13,6 +13,7 @@ export declare class LavalinkNode {
     get heartBeatPing(): number;
     private heartBeatInterval?;
     private pingTimeout?;
+    isAlive: boolean;
     /** The provided Options of the Node */
     options: LavalinkNodeOptions;
     /** The amount of rest calls the node has made. */
@@ -88,7 +89,8 @@ export declare class LavalinkNode {
      * player.node.request(`/loadtracks?identifier=Never gonna give you up`, (options) => options.method = "GET", false);
      * ```
      */
-    request(endpoint: string, modify?: ModifyRequest, parseAsText?: boolean): Promise<any>;
+    request(endpoint: string, modify: ModifyRequest | undefined, parseAsText: true): Promise<string>;
+    request(endpoint: string, modify?: ModifyRequest, parseAsText?: false): Promise<any>;
     /**
      * Search something raw on the node, please note only add tracks to players of that node
      * @param query SearchQuery Object
@@ -109,7 +111,7 @@ export declare 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
@@ -117,7 +119,7 @@ export declare class LavalinkNode {
      * player.node.lavaSearch({ types: ["playlist", "album"], query: "Rick Astley", source: "spotify" }, interaction.user);
      * ```
      */
-    lavaSearch(query: LavaSearchQuery, requestUser: unknown, throwOnEmpty?: boolean): Promise<SearchResult | LavaSearchResponse>;
+    lavaSearch(query: LavaSearchQuery, requestUser: unknown, throwOnEmpty?: boolean): Promise<LavaSearchResponse | SearchResult>;
     /**
      * Update the Player State on the Lavalink Server
      * @param data data to send to lavalink and sync locally
@@ -141,7 +143,7 @@ export declare class LavalinkNode {
      * player.node.destroyPlayer(player.guildId);
      * ```
      */
-    destroyPlayer(guildId: any): Promise<any>;
+    destroyPlayer(guildId: any): Promise<void>;
     /**
      * Connect to the Lavalink Node
      * @param sessionId Provide the Session Id of the previous connection, to resume the node and it's player(s)
@@ -169,7 +171,7 @@ export declare class LavalinkNode {
     get id(): string;
     /**
      * 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
      *
@@ -179,6 +181,19 @@ export declare class LavalinkNode {
      * ```
      */
     destroy(destroyReason?: DestroyReasonsType, deleteNode?: boolean): void;
+    /**
+     * 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?: DisconnectReasonsType): void;
     /**
      * Returns if connected to the Node.
      *
@@ -189,7 +204,6 @@ export declare class LavalinkNode {
      * ```
      */
     get connected(): boolean;
-    isAlive: boolean;
     /**
      * Returns the current ConnectionStatus
      *
@@ -214,7 +228,7 @@ export declare class LavalinkNode {
      * const playersOfLavalink = await node?.fetchAllPlayers();
      * ```
      */
-    fetchAllPlayers(): Promise<LavalinkPlayer[] | InvalidLavalinkRestRequest>;
+    fetchAllPlayers(): Promise<LavalinkPlayer[] | InvalidLavalinkRestRequest | null>;
     /**
      * Gets specific Player Information
      * @returns lavalink player object if player exists on lavalink
@@ -225,7 +239,7 @@ export declare class LavalinkNode {
      * const playerInformation = await node?.fetchPlayer("guildId");
      * ```
      */
-    fetchPlayer(guildId: string): Promise<LavalinkPlayer | InvalidLavalinkRestRequest>;
+    fetchPlayer(guildId: string): Promise<LavalinkPlayer | InvalidLavalinkRestRequest | null>;
     /**
      * Updates the session with and enables/disables resuming and timeout
      * @param resuming Whether resuming is enabled for this session or not
@@ -238,7 +252,7 @@ export declare class LavalinkNode {
      * await node?.updateSession(true, 180e3); // will enable resuming for 180seconds
      * ```
      */
-    updateSession(resuming?: boolean, timeout?: number): Promise<InvalidLavalinkRestRequest | Session>;
+    updateSession(resuming?: boolean, timeout?: number): Promise<Session | InvalidLavalinkRestRequest | null>;
     /**
      * Decode Track or Tracks
      */
@@ -285,7 +299,7 @@ export declare class LavalinkNode {
          * // const lyrics = await player.getLyrics(track, true);
          * ```
          */
-        get: (track: Track, skipTrackSource?: boolean) => Promise<LyricsResult>;
+        get: (track: Track, skipTrackSource?: boolean) => Promise<LyricsResult | null>;
         /**
          * Get the lyrics of the current playing track
          *
@@ -299,7 +313,7 @@ export declare class LavalinkNode {
          * // const lyrics = await player.getCurrentLyrics();
          * ```
          */
-        getCurrent: (guildId: string, skipTrackSource?: boolean) => Promise<LyricsResult>;
+        getCurrent: (guildId: string, skipTrackSource?: boolean) => Promise<LyricsResult | null>;
         /**
          * subscribe to lyrics updates for a guild
          * @param guildId the guild id of the player
@@ -312,7 +326,7 @@ export declare class LavalinkNode {
          * // const lyrics = await player.subscribeLyrics();
          * ```
          */
-        subscribe: (guildId: string) => Promise<any>;
+        subscribe: (guildId: string) => Promise<unknown>;
         /**
          * unsubscribe from lyrics updates for a guild
          * @param guildId the guild id of the player
@@ -325,7 +339,7 @@ export declare class LavalinkNode {
          * // const lyrics = await player.unsubscribeLyrics();
          * ```
          */
-        unsubscribe: (guildId: string) => Promise<any>;
+        unsubscribe: (guildId: string) => Promise<void>;
     };
     /**
      * Request Lavalink statistics.
@@ -385,7 +399,7 @@ export declare class LavalinkNode {
          * await player.node.routePlannerApi.unmarkFailedAddress("ipv6address");
          * ```
          */
-        unmarkFailedAddress: (address: string) => Promise<void>;
+        unmarkFailedAddress: (address: string) => Promise<unknown>;
         /**
          * Release all blacklisted IP addresses into pool of IPs
          * @returns request data of the request
@@ -395,7 +409,7 @@ export declare class LavalinkNode {
          * await player.node.routePlannerApi.unmarkAllFailedAddresses();
          * ```
          */
-        unmarkAllFailedAddresses: () => Promise<any>;
+        unmarkAllFailedAddresses: () => Promise<unknown>;
     };
     /** @private Utils for validating the */
     private validate;