lavalink-client 2.7.2 → 2.7.4

package/dist/index.d.mts

@@ -41,7 +41,8 @@ declare class FilterManager {
      * ```
      */
     applyPlayerFilters(): Promise<void>;
-    privateNot0(value: number | undefined): boolean;
+    private privateNot0;
+    private getLavalinkFilterData;
     /**
      * Checks if the filters are correctly stated (active / not-active) - mostly used internally.
      * @param oldFilterTimescale
@@ -982,11 +983,15 @@ declare class Player {
      */
     changeNode(newNode: LavalinkNode | string, checkSources?: boolean): Promise<string>;
     /**
-     * Move the player to a different node. If no node is provided, it will find the least used node that is not the same as the current node.
+     * (Wrapper-FN for changeNode) Move the player to a different node. If no node is provided, it will find the least used node that is not the same as the current node.
      * @param node the id of the node to move to
      * @returns the player
      * @throws RangeError if there is no available nodes.
      * @throws Error if the node to move to is the same as the current node.
+     * @example
+     * ```ts
+     * const newNodeMovedTo = await player.moveNode(); // no need to specify the new node, it will find a least used node automatically, but you can ofc. use a custom node id.
+     * ```
      */
     moveNode(node?: string): Promise<string | this>;
     /** Converts the Player including Queue to a Json state */
@@ -2360,7 +2365,7 @@ declare class LavalinkNode {
      *
      * @example
      * ```ts
-     * player.node.destroy("custom Player Destroy Reason", true);
+     * player.node.disconnect("Forcefully disconnect the connection to the node.");
      * ```
      */
     disconnect(disconnectReason?: DisconnectReasonsType): void;

package/dist/index.d.ts

@@ -41,7 +41,8 @@ declare class FilterManager {
      * ```
      */
     applyPlayerFilters(): Promise<void>;
-    privateNot0(value: number | undefined): boolean;
+    private privateNot0;
+    private getLavalinkFilterData;
     /**
      * Checks if the filters are correctly stated (active / not-active) - mostly used internally.
      * @param oldFilterTimescale
@@ -982,11 +983,15 @@ declare class Player {
      */
     changeNode(newNode: LavalinkNode | string, checkSources?: boolean): Promise<string>;
     /**
-     * Move the player to a different node. If no node is provided, it will find the least used node that is not the same as the current node.
+     * (Wrapper-FN for changeNode) Move the player to a different node. If no node is provided, it will find the least used node that is not the same as the current node.
      * @param node the id of the node to move to
      * @returns the player
      * @throws RangeError if there is no available nodes.
      * @throws Error if the node to move to is the same as the current node.
+     * @example
+     * ```ts
+     * const newNodeMovedTo = await player.moveNode(); // no need to specify the new node, it will find a least used node automatically, but you can ofc. use a custom node id.
+     * ```
      */
     moveNode(node?: string): Promise<string | this>;
     /** Converts the Player including Queue to a Json state */
@@ -2360,7 +2365,7 @@ declare class LavalinkNode {
      *
      * @example
      * ```ts
-     * player.node.destroy("custom Player Destroy Reason", true);
+     * player.node.disconnect("Forcefully disconnect the connection to the node.");
      * ```
      */
     disconnect(disconnectReason?: DisconnectReasonsType): void;

package/dist/index.js

@@ -1422,6 +1422,7 @@ var LavalinkNode = class {
    * ```
    */
   destroy(destroyReason, deleteNode = true, movePlayers = false) {
+    this.reconnectionState = "IDLE" /* IDLE */;
     const players = this.NodeManager.LavalinkManager.players.filter((p) => p.node.id === this.id);
     if (players.size) {
       const enableDebugEvents = this.NodeManager.LavalinkManager.options?.advancedOptions?.enableDebugEvents;
@@ -1497,7 +1498,7 @@ var LavalinkNode = class {
    *
    * @example
    * ```ts
-   * player.node.destroy("custom Player Destroy Reason", true);
+   * player.node.disconnect("Forcefully disconnect the connection to the node.");
    * ```
    */
   disconnect(disconnectReason) {
@@ -1505,6 +1506,7 @@ var LavalinkNode = class {
     this.socket?.close(1e3, "Node-Disconnect");
     this.socket?.removeAllListeners();
     this.socket = null;
+    this.reconnectionState = "IDLE" /* IDLE */;
     this.resetReconnectionAttempts();
     this.NodeManager.emit("disconnect", this, { code: 1e3, reason: disconnectReason });
   }
@@ -1969,10 +1971,10 @@ var LavalinkNode = class {
       });
       this.heartBeatInterval = setInterval(() => {
         if (!this.socket) return console.error("Node-Heartbeat-Interval - Socket not available - maybe reconnecting?");
-        if (!this.isAlive) this.close(500, "Node-Heartbeat-Timeout");
+        if (!this.isAlive) return this.close(500, "Node-Heartbeat-Timeout");
         this.isAlive = false;
         this.heartBeatPingTimestamp = performance.now();
-        this.socket.ping();
+        this.socket?.ping?.();
       }, this.options.heartBeatInterval || 3e4);
     }
     this.info = await this.fetchInfo().catch((e) => (console.error(e, "ON-OPEN-FETCH"), null));
@@ -2021,6 +2023,7 @@ var LavalinkNode = class {
   error(error) {
     if (!error) return;
     this.NodeManager.emit("error", this, error);
+    this.reconnectionState = "IDLE" /* IDLE */;
     this.reconnect();
     if (this.options.closeOnError) {
       if (this.heartBeatInterval) clearInterval(this.heartBeatInterval);
@@ -2961,6 +2964,19 @@ var FilterManager = class {
   privateNot0(value) {
     return typeof value === "number" && value !== 0;
   }
+  getLavalinkFilterData() {
+    return this.data.pluginFilters?.["lavalink-filter-plugin"] || {
+      echo: {
+        decay: this.data.pluginFilters?.echo?.decay && !this.data.pluginFilters?.echo?.echoLength ? this.data.pluginFilters?.echo?.decay : 0,
+        delay: this.data.pluginFilters?.echo?.delay || 0
+      },
+      reverb: {
+        gains: [],
+        delays: [],
+        ...this.data.pluginFilters?.reverb
+      }
+    };
+  }
   /**
    * Checks if the filters are correctly stated (active / not-active) - mostly used internally.
    * @param oldFilterTimescale
@@ -2979,13 +2995,17 @@ var FilterManager = class {
     this.filters.rotation = this.privateNot0(this.data.rotation?.rotationHz);
     this.filters.vibrato = this.privateNot0(this.data.vibrato?.frequency) || this.privateNot0(this.data.vibrato?.depth);
     this.filters.tremolo = this.privateNot0(this.data.tremolo?.frequency) || this.privateNot0(this.data.tremolo?.depth);
-    const lavalinkFilterData = this.data.pluginFilters?.["lavalink-filter-plugin"] || { echo: { decay: this.data.pluginFilters?.echo?.decay && !this.data.pluginFilters?.echo?.echoLength ? this.data.pluginFilters.echo.decay : 0, delay: this.data.pluginFilters?.echo?.delay || 0 }, reverb: { gains: [], delays: [], ...this.data.pluginFilters.reverb } };
-    this.filters.lavalinkFilterPlugin.echo = lavalinkFilterData.echo.decay !== 0 || lavalinkFilterData.echo.delay !== 0;
-    this.filters.lavalinkFilterPlugin.reverb = lavalinkFilterData.reverb?.delays?.length !== 0 || lavalinkFilterData.reverb?.gains?.length !== 0;
-    this.filters.lavalinkLavaDspxPlugin.highPass = Object.values(this.data.pluginFilters?.["high-pass"] || {}).length > 0;
-    this.filters.lavalinkLavaDspxPlugin.lowPass = Object.values(this.data.pluginFilters?.["low-pass"] || {}).length > 0;
-    this.filters.lavalinkLavaDspxPlugin.normalization = Object.values(this.data.pluginFilters?.normalization || {}).length > 0;
-    this.filters.lavalinkLavaDspxPlugin.echo = Object.values(this.data.pluginFilters?.echo || {}).length > 0 && typeof this.data.pluginFilters?.echo?.delay === "undefined";
+    const lavalinkFilterData = this.getLavalinkFilterData();
+    this.filters.lavalinkFilterPlugin = {
+      echo: this.privateNot0(lavalinkFilterData?.echo?.decay) || this.privateNot0(lavalinkFilterData?.echo?.delay),
+      reverb: this.privateNot0(lavalinkFilterData?.reverb?.delays?.length) || this.privateNot0(lavalinkFilterData?.reverb?.gains?.length)
+    };
+    this.filters.lavalinkLavaDspxPlugin = {
+      lowPass: Object.values(this.data.pluginFilters?.["low-pass"] || {})?.length > 0,
+      highPass: Object.values(this.data.pluginFilters?.["high-pass"] || {})?.length > 0,
+      normalization: Object.values(this.data.pluginFilters?.normalization || {})?.length > 0,
+      echo: Object.values(this.data.pluginFilters?.echo || {})?.length > 0 && typeof this.data.pluginFilters?.echo?.delay === "undefined"
+    };
     this.filters.lowPass = this.privateNot0(this.data.lowPass?.smoothing);
     this.filters.karaoke = Object.values(this.data.karaoke ?? {}).some((v) => v !== 0);
     if ((this.filters.nightcore || this.filters.vaporwave) && oldFilterTimescale) {
@@ -4622,11 +4642,15 @@ var Player = class {
     }
   }
   /**
-   * Move the player to a different node. If no node is provided, it will find the least used node that is not the same as the current node.
+   * (Wrapper-FN for changeNode) Move the player to a different node. If no node is provided, it will find the least used node that is not the same as the current node.
    * @param node the id of the node to move to
    * @returns the player
    * @throws RangeError if there is no available nodes.
    * @throws Error if the node to move to is the same as the current node.
+   * @example
+   * ```ts
+   * const newNodeMovedTo = await player.moveNode(); // no need to specify the new node, it will find a least used node automatically, but you can ofc. use a custom node id.
+   * ```
    */
   async moveNode(node) {
     try {

package/dist/index.mjs

@@ -1361,6 +1361,7 @@ var LavalinkNode = class {
    * ```
    */
   destroy(destroyReason, deleteNode = true, movePlayers = false) {
+    this.reconnectionState = "IDLE" /* IDLE */;
     const players = this.NodeManager.LavalinkManager.players.filter((p) => p.node.id === this.id);
     if (players.size) {
       const enableDebugEvents = this.NodeManager.LavalinkManager.options?.advancedOptions?.enableDebugEvents;
@@ -1436,7 +1437,7 @@ var LavalinkNode = class {
    *
    * @example
    * ```ts
-   * player.node.destroy("custom Player Destroy Reason", true);
+   * player.node.disconnect("Forcefully disconnect the connection to the node.");
    * ```
    */
   disconnect(disconnectReason) {
@@ -1444,6 +1445,7 @@ var LavalinkNode = class {
     this.socket?.close(1e3, "Node-Disconnect");
     this.socket?.removeAllListeners();
     this.socket = null;
+    this.reconnectionState = "IDLE" /* IDLE */;
     this.resetReconnectionAttempts();
     this.NodeManager.emit("disconnect", this, { code: 1e3, reason: disconnectReason });
   }
@@ -1908,10 +1910,10 @@ var LavalinkNode = class {
       });
       this.heartBeatInterval = setInterval(() => {
         if (!this.socket) return console.error("Node-Heartbeat-Interval - Socket not available - maybe reconnecting?");
-        if (!this.isAlive) this.close(500, "Node-Heartbeat-Timeout");
+        if (!this.isAlive) return this.close(500, "Node-Heartbeat-Timeout");
         this.isAlive = false;
         this.heartBeatPingTimestamp = performance.now();
-        this.socket.ping();
+        this.socket?.ping?.();
       }, this.options.heartBeatInterval || 3e4);
     }
     this.info = await this.fetchInfo().catch((e) => (console.error(e, "ON-OPEN-FETCH"), null));
@@ -1960,6 +1962,7 @@ var LavalinkNode = class {
   error(error) {
     if (!error) return;
     this.NodeManager.emit("error", this, error);
+    this.reconnectionState = "IDLE" /* IDLE */;
     this.reconnect();
     if (this.options.closeOnError) {
       if (this.heartBeatInterval) clearInterval(this.heartBeatInterval);
@@ -2900,6 +2903,19 @@ var FilterManager = class {
   privateNot0(value) {
     return typeof value === "number" && value !== 0;
   }
+  getLavalinkFilterData() {
+    return this.data.pluginFilters?.["lavalink-filter-plugin"] || {
+      echo: {
+        decay: this.data.pluginFilters?.echo?.decay && !this.data.pluginFilters?.echo?.echoLength ? this.data.pluginFilters?.echo?.decay : 0,
+        delay: this.data.pluginFilters?.echo?.delay || 0
+      },
+      reverb: {
+        gains: [],
+        delays: [],
+        ...this.data.pluginFilters?.reverb
+      }
+    };
+  }
   /**
    * Checks if the filters are correctly stated (active / not-active) - mostly used internally.
    * @param oldFilterTimescale
@@ -2918,13 +2934,17 @@ var FilterManager = class {
     this.filters.rotation = this.privateNot0(this.data.rotation?.rotationHz);
     this.filters.vibrato = this.privateNot0(this.data.vibrato?.frequency) || this.privateNot0(this.data.vibrato?.depth);
     this.filters.tremolo = this.privateNot0(this.data.tremolo?.frequency) || this.privateNot0(this.data.tremolo?.depth);
-    const lavalinkFilterData = this.data.pluginFilters?.["lavalink-filter-plugin"] || { echo: { decay: this.data.pluginFilters?.echo?.decay && !this.data.pluginFilters?.echo?.echoLength ? this.data.pluginFilters.echo.decay : 0, delay: this.data.pluginFilters?.echo?.delay || 0 }, reverb: { gains: [], delays: [], ...this.data.pluginFilters.reverb } };
-    this.filters.lavalinkFilterPlugin.echo = lavalinkFilterData.echo.decay !== 0 || lavalinkFilterData.echo.delay !== 0;
-    this.filters.lavalinkFilterPlugin.reverb = lavalinkFilterData.reverb?.delays?.length !== 0 || lavalinkFilterData.reverb?.gains?.length !== 0;
-    this.filters.lavalinkLavaDspxPlugin.highPass = Object.values(this.data.pluginFilters?.["high-pass"] || {}).length > 0;
-    this.filters.lavalinkLavaDspxPlugin.lowPass = Object.values(this.data.pluginFilters?.["low-pass"] || {}).length > 0;
-    this.filters.lavalinkLavaDspxPlugin.normalization = Object.values(this.data.pluginFilters?.normalization || {}).length > 0;
-    this.filters.lavalinkLavaDspxPlugin.echo = Object.values(this.data.pluginFilters?.echo || {}).length > 0 && typeof this.data.pluginFilters?.echo?.delay === "undefined";
+    const lavalinkFilterData = this.getLavalinkFilterData();
+    this.filters.lavalinkFilterPlugin = {
+      echo: this.privateNot0(lavalinkFilterData?.echo?.decay) || this.privateNot0(lavalinkFilterData?.echo?.delay),
+      reverb: this.privateNot0(lavalinkFilterData?.reverb?.delays?.length) || this.privateNot0(lavalinkFilterData?.reverb?.gains?.length)
+    };
+    this.filters.lavalinkLavaDspxPlugin = {
+      lowPass: Object.values(this.data.pluginFilters?.["low-pass"] || {})?.length > 0,
+      highPass: Object.values(this.data.pluginFilters?.["high-pass"] || {})?.length > 0,
+      normalization: Object.values(this.data.pluginFilters?.normalization || {})?.length > 0,
+      echo: Object.values(this.data.pluginFilters?.echo || {})?.length > 0 && typeof this.data.pluginFilters?.echo?.delay === "undefined"
+    };
     this.filters.lowPass = this.privateNot0(this.data.lowPass?.smoothing);
     this.filters.karaoke = Object.values(this.data.karaoke ?? {}).some((v) => v !== 0);
     if ((this.filters.nightcore || this.filters.vaporwave) && oldFilterTimescale) {
@@ -4561,11 +4581,15 @@ var Player = class {
     }
   }
   /**
-   * Move the player to a different node. If no node is provided, it will find the least used node that is not the same as the current node.
+   * (Wrapper-FN for changeNode) Move the player to a different node. If no node is provided, it will find the least used node that is not the same as the current node.
    * @param node the id of the node to move to
    * @returns the player
    * @throws RangeError if there is no available nodes.
    * @throws Error if the node to move to is the same as the current node.
+   * @example
+   * ```ts
+   * const newNodeMovedTo = await player.moveNode(); // no need to specify the new node, it will find a least used node automatically, but you can ofc. use a custom node id.
+   * ```
    */
   async moveNode(node) {
     try {

package/package.json

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