lavalink-client 1.1.22 → 1.1.24

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

@@ -59,7 +59,14 @@ export interface ManagerOptions {
     /** optional */
     debugOptions?: {
         /** logs for debugging the "no-Audio" playing error */
-        noAudio: boolean;
+        noAudio?: boolean;
+        /** For Logging the Destroy function */
+        playerDestroy?: {
+            /** To show the debug reason at all times. */
+            debugLog?: boolean;
+            /** If you get 'Error: Use Player#destroy(true) not PlayerManager#deletePlayer() to stop the Player' put it on true */
+            dontThrowError?: boolean;
+        };
     };
 }
 interface LavalinkManagerEvents {
@@ -134,7 +141,7 @@ export declare class LavalinkManager extends EventEmitter {
     constructor(options: ManagerOptions);
     createPlayer(options: PlayerOptions): Player;
     getPlayer(guildId: string): Player;
-    deletePlayer(guildId: string): boolean;
+    deletePlayer(guildId: string, throwError?: boolean): boolean;
     get useable(): boolean;
     /**
      * Initiates the Manager.

package/dist/cjs/structures/LavalinkManager.js

@@ -44,7 +44,11 @@ class LavalinkManager extends events_1.EventEmitter {
                 queueStore: options?.queueOptions?.queueStore ?? new Queue_1.DefaultQueueStore(),
             },
             debugOptions: {
-                noAudio: options?.debugOptions?.noAudio ?? false
+                noAudio: options?.debugOptions?.noAudio ?? false,
+                playerDestroy: {
+                    dontThrowError: options?.debugOptions?.playerDestroy?.dontThrowError ?? false,
+                    debugLog: options?.debugOptions?.playerDestroy?.debugLog ?? false,
+                }
             }
         };
         return;
@@ -87,8 +91,9 @@ class LavalinkManager extends events_1.EventEmitter {
         this.nodeManager = new NodeManager_1.NodeManager(this);
     }
     createPlayer(options) {
-        if (this.players.has(options?.guildId))
-            return this.players.get(options?.guildId);
+        const oldPlayer = this.getPlayer(options?.guildId);
+        if (oldPlayer)
+            return oldPlayer;
         const newPlayer = new Player_1.Player(options, this);
         this.players.set(newPlayer.guildId, newPlayer);
         return newPlayer;
@@ -96,9 +101,16 @@ class LavalinkManager extends events_1.EventEmitter {
     getPlayer(guildId) {
         return this.players.get(guildId);
     }
-    deletePlayer(guildId) {
-        if (typeof this.players.get(guildId)?.voiceChannelId === "string")
-            throw new Error("Use Player#destroy(true) not PlayerManager#deletePlayer() to stop the Player");
+    deletePlayer(guildId, throwError = true) {
+        const oldPlayer = this.getPlayer(guildId);
+        if (!oldPlayer)
+            return;
+        if (oldPlayer.voiceChannelId === "string" && oldPlayer.connected) {
+            if (throwError)
+                throw new Error(`Use Player#destroy(true) not PlayerManager#deletePlayer() to stop the Player ${JSON.stringify(oldPlayer.toJSON?.())}`);
+            else
+                console.error("Use Player#destroy(true) not PlayerManager#deletePlayer() to stop the Player", oldPlayer.toJSON?.());
+        }
         return this.players.delete(guildId);
     }
     get useable() {
@@ -177,6 +189,11 @@ class LavalinkManager extends events_1.EventEmitter {
                     console.debug("Lavalink-Client-Debug | NO-AUDIO [::] sendRawData function, No Lavalink Player found via key: 'guild_id' of update-data:", update);
                 return;
             }
+            if (player.get("internal_destroystatus") === true) {
+                if (this.options?.debugOptions?.noAudio === true)
+                    console.debug("Lavalink-Client-Debug | NO-AUDIO [::] sendRawData function, Player is in a destroying state. can't signal the voice states");
+                return;
+            }
             if ("token" in update) {
                 if (!player.node?.sessionId)
                     throw new Error("Lavalink Node is either not ready or not up to date");

package/dist/cjs/structures/Player.js

@@ -346,11 +346,27 @@ class Player {
      * Destroy the player and disconnect from the voice channel
      */
     async destroy(reason) {
+        if (this.LavalinkManager.options.debugOptions.playerDestroy.debugLog)
+            console.log(`Lavalink-Client-Debug | PlayerDestroy [::] destroy Function, [guildId ${this.guildId}] - Destroy-Reason: ${String(reason)}`);
+        if (this.get("internal_destroystatus") === true) {
+            if (this.LavalinkManager.options.debugOptions.playerDestroy.debugLog)
+                console.log(`Lavalink-Client-Debug | PlayerDestroy [::] destroy Function, [guildId ${this.guildId}] - Already destroying somewhere else..`);
+            return;
+        }
+        this.set("internal_destroystatus", true);
+        // disconnect player and set VoiceChannel to Null
         await this.disconnect(true);
+        // Destroy the queue
         await this.queue.utils.destroy();
-        this.LavalinkManager.deletePlayer(this.guildId);
+        // delete the player from cache
+        this.LavalinkManager.deletePlayer(this.guildId, !this.LavalinkManager.options.debugOptions.playerDestroy.dontThrowError);
+        // destroy the player on lavalink side
         await this.node.destroyPlayer(this.guildId);
+        if (this.LavalinkManager.options.debugOptions.playerDestroy.debugLog)
+            console.log(`Lavalink-Client-Debug | PlayerDestroy [::] destroy Function, [guildId ${this.guildId}] - Player got destroyed successfully`);
+        // emit the event
         this.LavalinkManager.emit("playerDestroy", this, reason);
+        // return smt
         return this;
     }
     /**

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

@@ -59,7 +59,14 @@ export interface ManagerOptions {
     /** optional */
     debugOptions?: {
         /** logs for debugging the "no-Audio" playing error */
-        noAudio: boolean;
+        noAudio?: boolean;
+        /** For Logging the Destroy function */
+        playerDestroy?: {
+            /** To show the debug reason at all times. */
+            debugLog?: boolean;
+            /** If you get 'Error: Use Player#destroy(true) not PlayerManager#deletePlayer() to stop the Player' put it on true */
+            dontThrowError?: boolean;
+        };
     };
 }
 interface LavalinkManagerEvents {
@@ -134,7 +141,7 @@ export declare class LavalinkManager extends EventEmitter {
     constructor(options: ManagerOptions);
     createPlayer(options: PlayerOptions): Player;
     getPlayer(guildId: string): Player;
-    deletePlayer(guildId: string): boolean;
+    deletePlayer(guildId: string, throwError?: boolean): boolean;
     get useable(): boolean;
     /**
      * Initiates the Manager.

package/dist/esm/structures/LavalinkManager.js

@@ -41,7 +41,11 @@ export class LavalinkManager extends EventEmitter {
                 queueStore: options?.queueOptions?.queueStore ?? new DefaultQueueStore(),
             },
             debugOptions: {
-                noAudio: options?.debugOptions?.noAudio ?? false
+                noAudio: options?.debugOptions?.noAudio ?? false,
+                playerDestroy: {
+                    dontThrowError: options?.debugOptions?.playerDestroy?.dontThrowError ?? false,
+                    debugLog: options?.debugOptions?.playerDestroy?.debugLog ?? false,
+                }
             }
         };
         return;
@@ -84,8 +88,9 @@ export class LavalinkManager extends EventEmitter {
         this.nodeManager = new NodeManager(this);
     }
     createPlayer(options) {
-        if (this.players.has(options?.guildId))
-            return this.players.get(options?.guildId);
+        const oldPlayer = this.getPlayer(options?.guildId);
+        if (oldPlayer)
+            return oldPlayer;
         const newPlayer = new Player(options, this);
         this.players.set(newPlayer.guildId, newPlayer);
         return newPlayer;
@@ -93,9 +98,16 @@ export class LavalinkManager extends EventEmitter {
     getPlayer(guildId) {
         return this.players.get(guildId);
     }
-    deletePlayer(guildId) {
-        if (typeof this.players.get(guildId)?.voiceChannelId === "string")
-            throw new Error("Use Player#destroy(true) not PlayerManager#deletePlayer() to stop the Player");
+    deletePlayer(guildId, throwError = true) {
+        const oldPlayer = this.getPlayer(guildId);
+        if (!oldPlayer)
+            return;
+        if (oldPlayer.voiceChannelId === "string" && oldPlayer.connected) {
+            if (throwError)
+                throw new Error(`Use Player#destroy(true) not PlayerManager#deletePlayer() to stop the Player ${JSON.stringify(oldPlayer.toJSON?.())}`);
+            else
+                console.error("Use Player#destroy(true) not PlayerManager#deletePlayer() to stop the Player", oldPlayer.toJSON?.());
+        }
         return this.players.delete(guildId);
     }
     get useable() {
@@ -174,6 +186,11 @@ export class LavalinkManager extends EventEmitter {
                     console.debug("Lavalink-Client-Debug | NO-AUDIO [::] sendRawData function, No Lavalink Player found via key: 'guild_id' of update-data:", update);
                 return;
             }
+            if (player.get("internal_destroystatus") === true) {
+                if (this.options?.debugOptions?.noAudio === true)
+                    console.debug("Lavalink-Client-Debug | NO-AUDIO [::] sendRawData function, Player is in a destroying state. can't signal the voice states");
+                return;
+            }
             if ("token" in update) {
                 if (!player.node?.sessionId)
                     throw new Error("Lavalink Node is either not ready or not up to date");

package/dist/esm/structures/Player.js

@@ -343,11 +343,27 @@ export class Player {
      * Destroy the player and disconnect from the voice channel
      */
     async destroy(reason) {
+        if (this.LavalinkManager.options.debugOptions.playerDestroy.debugLog)
+            console.log(`Lavalink-Client-Debug | PlayerDestroy [::] destroy Function, [guildId ${this.guildId}] - Destroy-Reason: ${String(reason)}`);
+        if (this.get("internal_destroystatus") === true) {
+            if (this.LavalinkManager.options.debugOptions.playerDestroy.debugLog)
+                console.log(`Lavalink-Client-Debug | PlayerDestroy [::] destroy Function, [guildId ${this.guildId}] - Already destroying somewhere else..`);
+            return;
+        }
+        this.set("internal_destroystatus", true);
+        // disconnect player and set VoiceChannel to Null
         await this.disconnect(true);
+        // Destroy the queue
         await this.queue.utils.destroy();
-        this.LavalinkManager.deletePlayer(this.guildId);
+        // delete the player from cache
+        this.LavalinkManager.deletePlayer(this.guildId, !this.LavalinkManager.options.debugOptions.playerDestroy.dontThrowError);
+        // destroy the player on lavalink side
         await this.node.destroyPlayer(this.guildId);
+        if (this.LavalinkManager.options.debugOptions.playerDestroy.debugLog)
+            console.log(`Lavalink-Client-Debug | PlayerDestroy [::] destroy Function, [guildId ${this.guildId}] - Player got destroyed successfully`);
+        // emit the event
         this.LavalinkManager.emit("playerDestroy", this, reason);
+        // return smt
         return this;
     }
     /**

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

@@ -59,7 +59,14 @@ export interface ManagerOptions {
     /** optional */
     debugOptions?: {
         /** logs for debugging the "no-Audio" playing error */
-        noAudio: boolean;
+        noAudio?: boolean;
+        /** For Logging the Destroy function */
+        playerDestroy?: {
+            /** To show the debug reason at all times. */
+            debugLog?: boolean;
+            /** If you get 'Error: Use Player#destroy(true) not PlayerManager#deletePlayer() to stop the Player' put it on true */
+            dontThrowError?: boolean;
+        };
     };
 }
 interface LavalinkManagerEvents {
@@ -134,7 +141,7 @@ export declare class LavalinkManager extends EventEmitter {
     constructor(options: ManagerOptions);
     createPlayer(options: PlayerOptions): Player;
     getPlayer(guildId: string): Player;
-    deletePlayer(guildId: string): boolean;
+    deletePlayer(guildId: string, throwError?: boolean): boolean;
     get useable(): boolean;
     /**
      * Initiates the Manager.

package/package.json

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