lavalink-client 1.0.3 → 1.0.4

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

@@ -1,7 +1,7 @@
 /// <reference types="node" />
 import { EventEmitter } from "events";
 import { NodeManager } from "./NodeManager";
-import { QueueChangesWatcher, QueueSaverOptions, StoreManager } from "./Queue";
+import { QueueSaverOptions } from "./Queue";
 import { GuildShardPayload, LavalinkSearchPlatform, ManagerUitls, MiniMap, SearchPlatform, TrackEndEvent, TrackExceptionEvent, TrackStartEvent, TrackStuckEvent, VoicePacket, VoiceServer, VoiceState, WebSocketClosedEvent } from "./Utils";
 import { LavalinkNodeOptions } from "./Node";
 import { DestroyReasonsType, Player, PlayerOptions } from "./Player";
@@ -44,11 +44,11 @@ export interface LavalinkPlayerOptions {
 export interface ManagerOptions {
     nodes: LavalinkNodeOptions[];
     queueOptions?: QueueSaverOptions;
-    queueStore?: StoreManager;
-    queueChangesWatcher?: QueueChangesWatcher;
     client?: BotClientOptions;
     playerOptions?: LavalinkPlayerOptions;
     autoSkip?: boolean;
+    defaultLeastUsedNodeSortType?: "memory" | "calls" | "players";
+    defaultLeastLoadNodeSortType?: "cpu" | "memory";
     /** @async */
     sendToShard: (guildId: string, payload: GuildShardPayload) => void;
 }

package/dist/cjs/structures/LavalinkManager.js

@@ -13,36 +13,97 @@ class LavalinkManager extends events_1.EventEmitter {
     initiated = false;
     players = new Utils_1.MiniMap();
     applyDefaultOptions() {
+        if (!this.options.playerOptions)
+            this.options.playerOptions = {
+                applyVolumeAsFilter: false,
+                clientBasedPositionUpdateInterval: 100,
+                defaultSearchPlatform: "ytsearch",
+                onDisconnect: {
+                    destroyPlayer: true,
+                    autoReconnect: false
+                },
+                onEmptyQueue: {
+                    autoPlayFunction: null,
+                    destroyAfterMs: undefined
+                },
+                requesterTransformer: (requester) => {
+                    // if it's already the transformed requester
+                    if (typeof requester === "object" && "avatar" in requester && Object.keys(requester).length === 3)
+                        return requester;
+                    // if it's still a discord.js User
+                    if (typeof requester === "object" && "displayAvatarURL" in requester) { // it's a user
+                        return {
+                            id: requester.id,
+                            username: requester.username,
+                            avatar: requester.displayAvatarURL(),
+                        };
+                    }
+                    // if it's non of the above
+                    return { id: requester.toString(), username: "unknown" }; // reteurn something that makes sense for you!
+                },
+                volumeDecrementer: 1
+            };
+        if (!this.options.autoSkip)
+            this.options.autoSkip = true;
+        if (!this.options.defaultLeastLoadNodeSortType)
+            this.options.defaultLeastLoadNodeSortType = "memory";
+        if (!this.options.defaultLeastUsedNodeSortType)
+            this.options.defaultLeastUsedNodeSortType = "players";
         if (!this.options.playerOptions.defaultSearchPlatform)
             this.options.playerOptions.defaultSearchPlatform = "ytsearch";
+        // default queue options
+        if (!this.options.queueOptions)
+            this.options.queueOptions = {
+                maxPreviousTracks: 25,
+                queueChangesWatcher: null,
+                queueStore: new Queue_1.DefaultQueueStore()
+            };
         if (typeof this.options?.queueOptions?.maxPreviousTracks !== "number" || this.options.queueOptions.maxPreviousTracks < 0)
             this.options.queueOptions.maxPreviousTracks = 25;
         return;
     }
     validateAndApply(options) {
+        if (typeof options.sendToShard !== "function")
+            throw new SyntaxError("ManagerOption.sendToShard was not provided, which is required!");
+        // only check in .init()
+        // if(typeof options.client !== "object" || typeof options.client.id !== "string") throw new SyntaxError("ManagerOption.client = { id: string, username?:string, shards?: 'auto'|number } was not provided, which is required");
+        if (options.autoSkip && typeof options.autoSkip !== "boolean")
+            throw new SyntaxError("ManagerOption.autoSkip must be either false | true aka boolean");
+        if (options.defaultLeastLoadNodeSortType && !["memory", "cpu"].includes(options.defaultLeastLoadNodeSortType))
+            throw new SyntaxError("ManagerOption.defaultLeastLoadNodeSortType must be 'memory' | 'cpu'");
+        if (options.defaultLeastUsedNodeSortType && !["memory", "players", "calls"].includes(options.defaultLeastUsedNodeSortType))
+            throw new SyntaxError("ManagerOption.defaultLeastLoadNodeSortType must be 'memory' | 'calls' | 'players'");
+        if (!options.nodes || !Array.isArray(options.nodes) || !options.nodes.every(node => this.utils.isNodeOptions(node)))
+            throw new SyntaxError("ManagerOption.nodes must be an Array of NodeOptions and is required of at least 1 Node");
         /* QUEUE STORE */
-        if (options.queueStore) {
-            const keys = Object.getOwnPropertyNames(Object.getPrototypeOf(options.queueStore));
+        if (options.queueOptions?.queueStore) {
+            const keys = Object.getOwnPropertyNames(Object.getPrototypeOf(options.queueOptions?.queueStore));
             const requiredKeys = ["get", "set", "stringify", "parse", "delete"];
-            if (!requiredKeys.every(v => keys.includes(v)) || !requiredKeys.every(v => typeof options.queueStore[v] === "function"))
-                throw new SyntaxError(`The provided QueueStore, does not have all required functions: ${requiredKeys.join(", ")}`);
+            if (!requiredKeys.every(v => keys.includes(v)) || !requiredKeys.every(v => typeof options.queueOptions?.queueStore[v] === "function"))
+                throw new SyntaxError(`The provided ManagerOption.QueueStore, does not have all required functions: ${requiredKeys.join(", ")}`);
         }
         else
-            this.options.queueStore = new Queue_1.DefaultQueueStore();
+            this.options.queueOptions.queueStore = new Queue_1.DefaultQueueStore();
+        /* QUEUE WATCHER */
+        if (options.queueOptions?.queueChangesWatcher) {
+            const keys = Object.getOwnPropertyNames(Object.getPrototypeOf(options.queueOptions?.queueChangesWatcher));
+            const requiredKeys = ["tracksAdd", "tracksRemoved", "shuffled"];
+            if (!requiredKeys.every(v => keys.includes(v)) || !requiredKeys.every(v => typeof options.queueOptions?.queueChangesWatcher[v] === "function"))
+                throw new SyntaxError(`The provided ManagerOption.QueueChangesWatcher, does not have all required functions: ${requiredKeys.join(", ")}`);
+        }
     }
     constructor(options) {
         super();
+        if (!options)
+            throw new SyntaxError("No Manager Options Provided");
         // create options
-        this.options = {
-            autoSkip: true,
-            ...options
-        };
+        this.options = options;
+        this.utils = new Utils_1.ManagerUitls(this);
         // use the validators
-        this.applyDefaultOptions();
         this.validateAndApply(options);
+        this.applyDefaultOptions();
         // create classes
         this.nodeManager = new NodeManager_1.NodeManager(this);
-        this.utils = new Utils_1.ManagerUitls(this);
     }
     createPlayer(options) {
         if (this.players.has(options.guildId))

package/dist/cjs/structures/Node.js

@@ -153,7 +153,7 @@ class LavalinkNode {
     }
     /** Get the id of the node */
     get id() {
-        return this.options.id || this.options.host;
+        return this.options.id || `${this.options.host}:${this.options.port}`;
     }
     /**
      * Destroys the Node-Connection (Websocket) and all player's of the node
@@ -531,14 +531,14 @@ class LavalinkNode {
             return this.NodeManager.LavalinkManager.emit("trackEnd", player, track, payload);
         // If a track had an error while starting
         if (["loadFailed", "cleanup"].includes(payload.reason)) {
-            await (0, Utils_1.queueTrackEnd)(player.queue);
+            await (0, Utils_1.queueTrackEnd)(player.queue, false);
             // if no track available, end queue
             if (!player.queue.current)
                 return this.queueEnd(player, track, payload);
             // fire event
             this.NodeManager.LavalinkManager.emit("trackEnd", player, track, payload);
             // play track if autoSkip is true
-            return this.NodeManager.LavalinkManager.options.autoSkip && player.play({ track: player.queue.current, noReplace: true });
+            return this.NodeManager.LavalinkManager.options.autoSkip && player.play({ noReplace: true });
         }
         // remove tracks from the queue
         if (player.repeatMode !== "track")
@@ -549,7 +549,7 @@ class LavalinkNode {
         // fire event
         this.NodeManager.LavalinkManager.emit("trackEnd", player, track, payload);
         // play track if autoSkip is true
-        return this.NodeManager.LavalinkManager.options.autoSkip && player.play({ track: player.queue.current, noReplace: true });
+        return this.NodeManager.LavalinkManager.options.autoSkip && player.play({ noReplace: true });
     }
     async queueEnd(player, track, payload) {
         player.queue.current = null;
@@ -559,7 +559,7 @@ class LavalinkNode {
             if (player.queue.tracks.length > 0)
                 await (0, Utils_1.queueTrackEnd)(player.queue, player.repeatMode === "queue");
             if (player.queue.current)
-                return player.play({ track: player.queue.current, noReplace: true, paused: false });
+                return player.play({ noReplace: true, paused: false });
         }
         if (payload?.reason !== "stopped") {
             await player.queue.utils.save();
@@ -590,7 +590,7 @@ class LavalinkNode {
         if (!player.queue.current)
             return this.queueEnd(player, track, payload);
         // play track if autoSkip is true
-        return (this.NodeManager.LavalinkManager.options.autoSkip && player.queue.current) && player.play({ track: player.queue.current, noReplace: true });
+        return (this.NodeManager.LavalinkManager.options.autoSkip && player.queue.current) && player.play({ noReplace: true });
     }
     async trackError(player, track, payload) {
         this.NodeManager.LavalinkManager.emit("trackError", player, track, payload);
@@ -600,7 +600,7 @@ class LavalinkNode {
         if (!player.queue.current)
             return this.queueEnd(player, track, payload);
         // play track if autoSkip is true
-        return (this.NodeManager.LavalinkManager.options.autoSkip && player.queue.current) && player.play({ track: player.queue.current, noReplace: true });
+        return (this.NodeManager.LavalinkManager.options.autoSkip && player.queue.current) && player.play({ noReplace: true });
     }
     socketClosed(player, payload) {
         return this.NodeManager.LavalinkManager.emit("playerSocketClosed", player, payload);

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

@@ -56,6 +56,17 @@ export declare class NodeManager extends EventEmitter {
     constructor(LavalinkManager: LavalinkManager);
     createNode(options: LavalinkNodeOptions): LavalinkNode;
     get leastUsedNodes(): LavalinkNode[];
+    /** Returns the least used Nodes sorted by amount of calls. */
+    private get leastUsedNodesCalls();
+    /** Returns the least used Nodes sorted by amount of players. */
+    private get leastUsedNodesPlayers();
+    /** Returns the least used Nodes sorted by amount of memory usage. */
+    private get leastUsedNodesMemory();
+    /** Returns the least system load Nodes. */
+    get leastLoadNodes(): LavalinkNode[];
+    get leastLoadNodesMemory(): LavalinkNode[];
+    /** Returns the least system load Nodes. */
+    get leastLoadNodesCpu(): LavalinkNode[];
     deleteNode(node: LavalinkNodeIdentifier | LavalinkNode): void;
 }
 export {};

package/dist/cjs/structures/NodeManager.js

@@ -14,14 +14,71 @@ class NodeManager extends stream_1.EventEmitter {
             this.LavalinkManager.options.nodes.forEach(node => this.createNode(node));
     }
     createNode(options) {
-        if (this.nodes.has(options.id || options.host))
-            return this.nodes.get(options.id || options.host);
+        if (this.nodes.has(options.id || `${options.host}:${options.port}`))
+            return this.nodes.get(options.id || `${options.host}:${options.port}`);
         const newNode = new Node_1.LavalinkNode(options, this);
         this.nodes.set(newNode.id, newNode);
         return newNode;
     }
     get leastUsedNodes() {
-        return [...this.nodes.values()].filter(v => v);
+        if (this.LavalinkManager.options.defaultLeastUsedNodeSortType === "memory")
+            return this.leastUsedNodesMemory;
+        else if (this.LavalinkManager.options.defaultLeastUsedNodeSortType === "calls")
+            return this.leastUsedNodesCalls;
+        else
+            return this.leastUsedNodesPlayers; // this.options.defaultLeastUsedNodeSortType === "players"
+    }
+    /** Returns the least used Nodes sorted by amount of calls. */
+    get leastUsedNodesCalls() {
+        return [...this.nodes.values()]
+            .filter((node) => node.connected)
+            .sort((a, b) => b.calls - a.calls); // client sided sorting
+    }
+    /** Returns the least used Nodes sorted by amount of players. */
+    get leastUsedNodesPlayers() {
+        return [...this.nodes.values()]
+            .filter((node) => node.connected)
+            .sort((a, b) => (a.stats?.players || 0) - (b.stats?.players || 0));
+    }
+    /** Returns the least used Nodes sorted by amount of memory usage. */
+    get leastUsedNodesMemory() {
+        return [...this.nodes.values()]
+            .filter((node) => node.connected)
+            .sort((a, b) => (b.stats?.memory?.used || 0) - (a.stats?.memory?.used || 0)); // sort after memory
+    }
+    /** Returns the least system load Nodes. */
+    get leastLoadNodes() {
+        if (this.LavalinkManager.options.defaultLeastLoadNodeSortType === "cpu")
+            return this.leastLoadNodesCpu;
+        else
+            return this.leastLoadNodesMemory; // this.options.defaultLeastLoadNodeSortType === "memory"
+    }
+    get leastLoadNodesMemory() {
+        return [...this.nodes.values()]
+            .filter((node) => node.connected)
+            .sort((a, b) => {
+            const aload = a.stats.memory?.used
+                ? a.stats.memory.used
+                : 0;
+            const bload = b.stats.memory?.used
+                ? b.stats.memory.used
+                : 0;
+            return aload - bload;
+        });
+    }
+    /** Returns the least system load Nodes. */
+    get leastLoadNodesCpu() {
+        return [...this.nodes.values()]
+            .filter((node) => node.connected)
+            .sort((a, b) => {
+            const aload = a.stats.cpu
+                ? (a.stats.cpu.systemLoad / a.stats.cpu.cores) * 100
+                : 0;
+            const bload = b.stats.cpu
+                ? (b.stats.cpu.systemLoad / b.stats.cpu.cores) * 100
+                : 0;
+            return aload - bload;
+        });
     }
     deleteNode(node) {
         const decodeNode = typeof node === "string" ? this.nodes.get(node) : node || this.leastUsedNodes[0];

package/dist/cjs/structures/Player.js

@@ -66,7 +66,9 @@ class Player {
         this.guildId = this.options.guildId;
         this.voiceChannelId = this.options.voiceChannelId;
         this.textChannelId = this.options.textChannelId || null;
-        this.node = this.LavalinkManager.nodeManager.leastUsedNodes.filter(v => options.vcRegion ? v.options?.regions?.includes(options.vcRegion) : true)[0] || this.LavalinkManager.nodeManager.leastUsedNodes[0] || null;
+        this.node = typeof this.options.node === "string" ? this.LavalinkManager.nodeManager.nodes.get(this.options.node) : this.options.node;
+        if (!this.node || typeof this.node?.request !== "function")
+            this.node = this.LavalinkManager.nodeManager.leastUsedNodes.filter(v => options.vcRegion ? v.options?.regions?.includes(options.vcRegion) : true)[0] || this.LavalinkManager.nodeManager.leastUsedNodes[0] || null;
         if (!this.node)
             throw new Error("No available Node was found, please add a LavalinkNode to the Manager via Manager.NodeManager#createNode");
         if (this.LavalinkManager.options.playerOptions.volumeDecrementer)
@@ -74,7 +76,7 @@ class Player {
         this.LavalinkManager.emit("playerCreate", this);
         if (typeof options.volume === "number" && !isNaN(options.volume))
             this.setVolume(options.volume);
-        this.queue = new Queue_1.Queue(this.guildId, {}, new Queue_1.QueueSaver(this.LavalinkManager.options.queueStore, this.LavalinkManager.options.queueOptions), this.LavalinkManager.options.queueChangesWatcher);
+        this.queue = new Queue_1.Queue(this.guildId, {}, new Queue_1.QueueSaver(this.LavalinkManager.options.queueOptions), this.LavalinkManager.options.queueOptions);
     }
     /**
      * Set custom data.

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

@@ -18,6 +18,8 @@ export interface StoreManager extends Record<any, any> {
 }
 export interface QueueSaverOptions {
     maxPreviousTracks: number;
+    queueStore?: StoreManager;
+    queueChangesWatcher?: QueueChangesWatcher;
 }
 export interface QueueSaver {
     /** @private */
@@ -26,7 +28,7 @@ export interface QueueSaver {
     options: QueueSaverOptions;
 }
 export declare class QueueSaver {
-    constructor(storeManager: StoreManager, options: QueueSaverOptions);
+    constructor(options: QueueSaverOptions);
     get(guildId: string): Promise<Partial<StoredQueue>>;
     delete(guildId: string): Promise<any>;
     set(guildId: string, value: any): Promise<any>;
@@ -59,7 +61,7 @@ export declare class Queue {
     static readonly StaticSymbol: Symbol;
     private managerUtils;
     private queueChanges;
-    constructor(guildId: string, data?: Partial<StoredQueue>, QueueSaver?: QueueSaver, queueChangesWatcher?: QueueChangesWatcher);
+    constructor(guildId: string, data?: Partial<StoredQueue>, QueueSaver?: QueueSaver, queueOptions?: QueueSaverOptions);
     /**
      * Utils for a Queue
      */

package/dist/cjs/structures/Queue.js

@@ -3,9 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Queue = exports.QueueChangesWatcher = exports.DefaultQueueStore = exports.QueueSaver = void 0;
 const Utils_1 = require("./Utils");
 class QueueSaver {
-    constructor(storeManager, options) {
-        this._ = storeManager;
-        this.options = options;
+    constructor(options) {
+        this._ = options.queueStore || new DefaultQueueStore();
+        this.options = {
+            maxPreviousTracks: options.maxPreviousTracks
+        };
     }
     async get(guildId) {
         return await this._.parse(await this._.get(guildId));
@@ -66,8 +68,8 @@ class Queue {
     static StaticSymbol = Utils_1.QueueSymbol;
     managerUtils = new Utils_1.ManagerUitls();
     queueChanges;
-    constructor(guildId, data = {}, QueueSaver, queueChangesWatcher) {
-        this.queueChanges = queueChangesWatcher || null;
+    constructor(guildId, data = {}, QueueSaver, queueOptions) {
+        this.queueChanges = queueOptions.queueChangesWatcher || null;
         this.guildId = guildId;
         this.QueueSaver = QueueSaver;
         this.options.maxPreviousTracks = this.QueueSaver?.options?.maxPreviousTracks ?? this.options.maxPreviousTracks;

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

@@ -1,6 +1,6 @@
 import { LavalinkFilterData } from "./Filters";
 import { LavalinkManager } from "./LavalinkManager";
-import { LavalinkNode, NodeStats } from "./Node";
+import { LavalinkNode, LavalinkNodeOptions, NodeStats } from "./Node";
 import { PlayOptions } from "./Player";
 import { Queue } from "./Queue";
 import { PluginInfo, Track } from "./Track";
@@ -40,10 +40,20 @@ export interface ManagerUitls {
 export declare class ManagerUitls {
     constructor(LavalinkManager?: LavalinkManager);
     buildTrack(data: any, requester: any): Track;
+    /**
+     * Validate if a data is equal to a node
+     * @param data
+     */
+    isNode(data: LavalinkNode): boolean;
+    /**
+     * Validate if a data is equal to node options
+     * @param data
+     */
+    isNodeOptions(data: LavalinkNodeOptions | any): boolean;
     /**
      * Validate if a data is euqal to a track
-     * @param {Track|any} data the Track to validate
-     * @returns {boolean}
+     * @param data the Track to validate
+     * @returns
      */
     isTrack(data: Track | any): boolean;
     validatedQuery(queryString: string, node: LavalinkNode): void;
@@ -85,6 +95,8 @@ export declare class MiniMap<K, V> extends Map<K, V> {
     filter<This, K2 extends K>(fn: (this: This, value: V, key: K, miniMap: this) => key is K2, thisArg: This): MiniMap<K2, V>;
     filter<This, V2 extends V>(fn: (this: This, value: V, key: K, miniMap: this) => value is V2, thisArg: This): MiniMap<K, V2>;
     filter<This>(fn: (this: This, value: V, key: K, miniMap: this) => boolean, thisArg: This): MiniMap<K, V>;
+    toJSON(): V[];
+    private static defaultSort;
     /**
      * Maps each item to another value into an array. Identical in behavior to
      * [Array.map()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map).

package/dist/cjs/structures/Utils.js

@@ -41,10 +41,58 @@ class ManagerUitls {
             throw new RangeError(`Argument "data" is not a valid track: ${error.message}`);
         }
     }
+    /**
+     * Validate if a data is equal to a node
+     * @param data
+     */
+    isNode(data) {
+        if (!data)
+            return false;
+        const keys = Object.getOwnPropertyNames(Object.getPrototypeOf(data));
+        if (!keys.includes("constructor"))
+            return false;
+        if (!keys.length)
+            return false;
+        // all required functions
+        if (!["connect", "destroy", "destroyPlayer", "fetchAllPlayers", "fetchInfo", "fetchPlayer", "fetchStats", "fetchVersion", "request", "updatePlayer", "updateSession"].every(v => keys.includes(v)))
+            return false;
+        return true;
+    }
+    /**
+     * Validate if a data is equal to node options
+     * @param data
+     */
+    isNodeOptions(data) {
+        if (!data || typeof data !== "object" || Array.isArray(data))
+            return false;
+        if (typeof data.host !== "string" || !data.host.length)
+            return false;
+        if (typeof data.port !== "number" || isNaN(data.port) || data.port < 0 || data.port > 65535)
+            return false;
+        if (typeof data.authorization !== "string" || !data.authorization.length)
+            return false;
+        if ("secure" in data && typeof data.secure !== "boolean")
+            return false;
+        if ("sessionId" in data && typeof data.sessionId !== "string")
+            return false;
+        if ("id" in data && typeof data.id !== "string")
+            return false;
+        if ("regions" in data && (!Array.isArray(data.regions) || !data.regions.every(v => typeof v === "string")))
+            return false;
+        if ("poolOptions" in data && typeof data.poolOptions !== "object")
+            return false;
+        if ("retryAmount" in data && (typeof data.retryAmount !== "number" || isNaN(data.retryAmount) || data.retryAmount <= 0))
+            return false;
+        if ("retryDelay" in data && (typeof data.retryDelay !== "number" || isNaN(data.retryDelay) || data.retryDelay <= 0))
+            return false;
+        if ("requestTimeout" in data && (typeof data.requestTimeout !== "number" || isNaN(data.requestTimeout) || data.requestTimeout <= 0))
+            return false;
+        return true;
+    }
     /**
      * Validate if a data is euqal to a track
-     * @param {Track|any} data the Track to validate
-     * @returns {boolean}
+     * @param data the Track to validate
+     * @returns
      */
     isTrack(data) {
         return typeof data?.encoded === "string" && typeof data?.info === "object";
@@ -152,6 +200,13 @@ class MiniMap extends Map {
         }
         return results;
     }
+    toJSON() {
+        // toJSON is called recursively by JSON.stringify.
+        return [...this.values()];
+    }
+    static defaultSort(firstValue, secondValue) {
+        return Number(firstValue > secondValue) || Number(firstValue === secondValue) - 1;
+    }
     map(fn, thisArg) {
         if (typeof thisArg !== 'undefined')
             fn = fn.bind(thisArg);
@@ -170,11 +225,11 @@ async function queueTrackEnd(queue, addBackToQueue = false) {
         if (queue.previous.length > queue.options.maxPreviousTracks)
             queue.previous.splice(queue.options.maxPreviousTracks, queue.previous.length);
     }
-    // change the current Track to the next upcoming one
-    queue.current = queue.tracks.shift() || null;
     // and if repeatMode == queue, add it back to the queue!
     if (addBackToQueue && queue.current)
         queue.tracks.push(queue.current);
+    // change the current Track to the next upcoming one
+    queue.current = queue.tracks.shift() || null;
     // save it in the DB
     await queue.utils.save();
     // return the new current Track

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

@@ -1,7 +1,7 @@
 /// <reference types="node" />
 import { EventEmitter } from "events";
 import { NodeManager } from "./NodeManager";
-import { QueueChangesWatcher, QueueSaverOptions, StoreManager } from "./Queue";
+import { QueueSaverOptions } from "./Queue";
 import { GuildShardPayload, LavalinkSearchPlatform, ManagerUitls, MiniMap, SearchPlatform, TrackEndEvent, TrackExceptionEvent, TrackStartEvent, TrackStuckEvent, VoicePacket, VoiceServer, VoiceState, WebSocketClosedEvent } from "./Utils";
 import { LavalinkNodeOptions } from "./Node";
 import { DestroyReasonsType, Player, PlayerOptions } from "./Player";
@@ -44,11 +44,11 @@ export interface LavalinkPlayerOptions {
 export interface ManagerOptions {
     nodes: LavalinkNodeOptions[];
     queueOptions?: QueueSaverOptions;
-    queueStore?: StoreManager;
-    queueChangesWatcher?: QueueChangesWatcher;
     client?: BotClientOptions;
     playerOptions?: LavalinkPlayerOptions;
     autoSkip?: boolean;
+    defaultLeastUsedNodeSortType?: "memory" | "calls" | "players";
+    defaultLeastLoadNodeSortType?: "cpu" | "memory";
     /** @async */
     sendToShard: (guildId: string, payload: GuildShardPayload) => void;
 }

package/dist/esm/structures/LavalinkManager.js

@@ -10,36 +10,97 @@ export class LavalinkManager extends EventEmitter {
     initiated = false;
     players = new MiniMap();
     applyDefaultOptions() {
+        if (!this.options.playerOptions)
+            this.options.playerOptions = {
+                applyVolumeAsFilter: false,
+                clientBasedPositionUpdateInterval: 100,
+                defaultSearchPlatform: "ytsearch",
+                onDisconnect: {
+                    destroyPlayer: true,
+                    autoReconnect: false
+                },
+                onEmptyQueue: {
+                    autoPlayFunction: null,
+                    destroyAfterMs: undefined
+                },
+                requesterTransformer: (requester) => {
+                    // if it's already the transformed requester
+                    if (typeof requester === "object" && "avatar" in requester && Object.keys(requester).length === 3)
+                        return requester;
+                    // if it's still a discord.js User
+                    if (typeof requester === "object" && "displayAvatarURL" in requester) { // it's a user
+                        return {
+                            id: requester.id,
+                            username: requester.username,
+                            avatar: requester.displayAvatarURL(),
+                        };
+                    }
+                    // if it's non of the above
+                    return { id: requester.toString(), username: "unknown" }; // reteurn something that makes sense for you!
+                },
+                volumeDecrementer: 1
+            };
+        if (!this.options.autoSkip)
+            this.options.autoSkip = true;
+        if (!this.options.defaultLeastLoadNodeSortType)
+            this.options.defaultLeastLoadNodeSortType = "memory";
+        if (!this.options.defaultLeastUsedNodeSortType)
+            this.options.defaultLeastUsedNodeSortType = "players";
         if (!this.options.playerOptions.defaultSearchPlatform)
             this.options.playerOptions.defaultSearchPlatform = "ytsearch";
+        // default queue options
+        if (!this.options.queueOptions)
+            this.options.queueOptions = {
+                maxPreviousTracks: 25,
+                queueChangesWatcher: null,
+                queueStore: new DefaultQueueStore()
+            };
         if (typeof this.options?.queueOptions?.maxPreviousTracks !== "number" || this.options.queueOptions.maxPreviousTracks < 0)
             this.options.queueOptions.maxPreviousTracks = 25;
         return;
     }
     validateAndApply(options) {
+        if (typeof options.sendToShard !== "function")
+            throw new SyntaxError("ManagerOption.sendToShard was not provided, which is required!");
+        // only check in .init()
+        // if(typeof options.client !== "object" || typeof options.client.id !== "string") throw new SyntaxError("ManagerOption.client = { id: string, username?:string, shards?: 'auto'|number } was not provided, which is required");
+        if (options.autoSkip && typeof options.autoSkip !== "boolean")
+            throw new SyntaxError("ManagerOption.autoSkip must be either false | true aka boolean");
+        if (options.defaultLeastLoadNodeSortType && !["memory", "cpu"].includes(options.defaultLeastLoadNodeSortType))
+            throw new SyntaxError("ManagerOption.defaultLeastLoadNodeSortType must be 'memory' | 'cpu'");
+        if (options.defaultLeastUsedNodeSortType && !["memory", "players", "calls"].includes(options.defaultLeastUsedNodeSortType))
+            throw new SyntaxError("ManagerOption.defaultLeastLoadNodeSortType must be 'memory' | 'calls' | 'players'");
+        if (!options.nodes || !Array.isArray(options.nodes) || !options.nodes.every(node => this.utils.isNodeOptions(node)))
+            throw new SyntaxError("ManagerOption.nodes must be an Array of NodeOptions and is required of at least 1 Node");
         /* QUEUE STORE */
-        if (options.queueStore) {
-            const keys = Object.getOwnPropertyNames(Object.getPrototypeOf(options.queueStore));
+        if (options.queueOptions?.queueStore) {
+            const keys = Object.getOwnPropertyNames(Object.getPrototypeOf(options.queueOptions?.queueStore));
             const requiredKeys = ["get", "set", "stringify", "parse", "delete"];
-            if (!requiredKeys.every(v => keys.includes(v)) || !requiredKeys.every(v => typeof options.queueStore[v] === "function"))
-                throw new SyntaxError(`The provided QueueStore, does not have all required functions: ${requiredKeys.join(", ")}`);
+            if (!requiredKeys.every(v => keys.includes(v)) || !requiredKeys.every(v => typeof options.queueOptions?.queueStore[v] === "function"))
+                throw new SyntaxError(`The provided ManagerOption.QueueStore, does not have all required functions: ${requiredKeys.join(", ")}`);
         }
         else
-            this.options.queueStore = new DefaultQueueStore();
+            this.options.queueOptions.queueStore = new DefaultQueueStore();
+        /* QUEUE WATCHER */
+        if (options.queueOptions?.queueChangesWatcher) {
+            const keys = Object.getOwnPropertyNames(Object.getPrototypeOf(options.queueOptions?.queueChangesWatcher));
+            const requiredKeys = ["tracksAdd", "tracksRemoved", "shuffled"];
+            if (!requiredKeys.every(v => keys.includes(v)) || !requiredKeys.every(v => typeof options.queueOptions?.queueChangesWatcher[v] === "function"))
+                throw new SyntaxError(`The provided ManagerOption.QueueChangesWatcher, does not have all required functions: ${requiredKeys.join(", ")}`);
+        }
     }
     constructor(options) {
         super();
+        if (!options)
+            throw new SyntaxError("No Manager Options Provided");
         // create options
-        this.options = {
-            autoSkip: true,
-            ...options
-        };
+        this.options = options;
+        this.utils = new ManagerUitls(this);
         // use the validators
-        this.applyDefaultOptions();
         this.validateAndApply(options);
+        this.applyDefaultOptions();
         // create classes
         this.nodeManager = new NodeManager(this);
-        this.utils = new ManagerUitls(this);
     }
     createPlayer(options) {
         if (this.players.has(options.guildId))

package/dist/esm/structures/Node.js

@@ -149,7 +149,7 @@ export class LavalinkNode {
     }
     /** Get the id of the node */
     get id() {
-        return this.options.id || this.options.host;
+        return this.options.id || `${this.options.host}:${this.options.port}`;
     }
     /**
      * Destroys the Node-Connection (Websocket) and all player's of the node
@@ -527,14 +527,14 @@ export class LavalinkNode {
             return this.NodeManager.LavalinkManager.emit("trackEnd", player, track, payload);
         // If a track had an error while starting
         if (["loadFailed", "cleanup"].includes(payload.reason)) {
-            await queueTrackEnd(player.queue);
+            await queueTrackEnd(player.queue, false);
             // if no track available, end queue
             if (!player.queue.current)
                 return this.queueEnd(player, track, payload);
             // fire event
             this.NodeManager.LavalinkManager.emit("trackEnd", player, track, payload);
             // play track if autoSkip is true
-            return this.NodeManager.LavalinkManager.options.autoSkip && player.play({ track: player.queue.current, noReplace: true });
+            return this.NodeManager.LavalinkManager.options.autoSkip && player.play({ noReplace: true });
         }
         // remove tracks from the queue
         if (player.repeatMode !== "track")
@@ -545,7 +545,7 @@ export class LavalinkNode {
         // fire event
         this.NodeManager.LavalinkManager.emit("trackEnd", player, track, payload);
         // play track if autoSkip is true
-        return this.NodeManager.LavalinkManager.options.autoSkip && player.play({ track: player.queue.current, noReplace: true });
+        return this.NodeManager.LavalinkManager.options.autoSkip && player.play({ noReplace: true });
     }
     async queueEnd(player, track, payload) {
         player.queue.current = null;
@@ -555,7 +555,7 @@ export class LavalinkNode {
             if (player.queue.tracks.length > 0)
                 await queueTrackEnd(player.queue, player.repeatMode === "queue");
             if (player.queue.current)
-                return player.play({ track: player.queue.current, noReplace: true, paused: false });
+                return player.play({ noReplace: true, paused: false });
         }
         if (payload?.reason !== "stopped") {
             await player.queue.utils.save();
@@ -586,7 +586,7 @@ export class LavalinkNode {
         if (!player.queue.current)
             return this.queueEnd(player, track, payload);
         // play track if autoSkip is true
-        return (this.NodeManager.LavalinkManager.options.autoSkip && player.queue.current) && player.play({ track: player.queue.current, noReplace: true });
+        return (this.NodeManager.LavalinkManager.options.autoSkip && player.queue.current) && player.play({ noReplace: true });
     }
     async trackError(player, track, payload) {
         this.NodeManager.LavalinkManager.emit("trackError", player, track, payload);
@@ -596,7 +596,7 @@ export class LavalinkNode {
         if (!player.queue.current)
             return this.queueEnd(player, track, payload);
         // play track if autoSkip is true
-        return (this.NodeManager.LavalinkManager.options.autoSkip && player.queue.current) && player.play({ track: player.queue.current, noReplace: true });
+        return (this.NodeManager.LavalinkManager.options.autoSkip && player.queue.current) && player.play({ noReplace: true });
     }
     socketClosed(player, payload) {
         return this.NodeManager.LavalinkManager.emit("playerSocketClosed", player, payload);

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

@@ -56,6 +56,17 @@ export declare class NodeManager extends EventEmitter {
     constructor(LavalinkManager: LavalinkManager);
     createNode(options: LavalinkNodeOptions): LavalinkNode;
     get leastUsedNodes(): LavalinkNode[];
+    /** Returns the least used Nodes sorted by amount of calls. */
+    private get leastUsedNodesCalls();
+    /** Returns the least used Nodes sorted by amount of players. */
+    private get leastUsedNodesPlayers();
+    /** Returns the least used Nodes sorted by amount of memory usage. */
+    private get leastUsedNodesMemory();
+    /** Returns the least system load Nodes. */
+    get leastLoadNodes(): LavalinkNode[];
+    get leastLoadNodesMemory(): LavalinkNode[];
+    /** Returns the least system load Nodes. */
+    get leastLoadNodesCpu(): LavalinkNode[];
     deleteNode(node: LavalinkNodeIdentifier | LavalinkNode): void;
 }
 export {};

package/dist/esm/structures/NodeManager.js

@@ -11,14 +11,71 @@ export class NodeManager extends EventEmitter {
             this.LavalinkManager.options.nodes.forEach(node => this.createNode(node));
     }
     createNode(options) {
-        if (this.nodes.has(options.id || options.host))
-            return this.nodes.get(options.id || options.host);
+        if (this.nodes.has(options.id || `${options.host}:${options.port}`))
+            return this.nodes.get(options.id || `${options.host}:${options.port}`);
         const newNode = new LavalinkNode(options, this);
         this.nodes.set(newNode.id, newNode);
         return newNode;
     }
     get leastUsedNodes() {
-        return [...this.nodes.values()].filter(v => v);
+        if (this.LavalinkManager.options.defaultLeastUsedNodeSortType === "memory")
+            return this.leastUsedNodesMemory;
+        else if (this.LavalinkManager.options.defaultLeastUsedNodeSortType === "calls")
+            return this.leastUsedNodesCalls;
+        else
+            return this.leastUsedNodesPlayers; // this.options.defaultLeastUsedNodeSortType === "players"
+    }
+    /** Returns the least used Nodes sorted by amount of calls. */
+    get leastUsedNodesCalls() {
+        return [...this.nodes.values()]
+            .filter((node) => node.connected)
+            .sort((a, b) => b.calls - a.calls); // client sided sorting
+    }
+    /** Returns the least used Nodes sorted by amount of players. */
+    get leastUsedNodesPlayers() {
+        return [...this.nodes.values()]
+            .filter((node) => node.connected)
+            .sort((a, b) => (a.stats?.players || 0) - (b.stats?.players || 0));
+    }
+    /** Returns the least used Nodes sorted by amount of memory usage. */
+    get leastUsedNodesMemory() {
+        return [...this.nodes.values()]
+            .filter((node) => node.connected)
+            .sort((a, b) => (b.stats?.memory?.used || 0) - (a.stats?.memory?.used || 0)); // sort after memory
+    }
+    /** Returns the least system load Nodes. */
+    get leastLoadNodes() {
+        if (this.LavalinkManager.options.defaultLeastLoadNodeSortType === "cpu")
+            return this.leastLoadNodesCpu;
+        else
+            return this.leastLoadNodesMemory; // this.options.defaultLeastLoadNodeSortType === "memory"
+    }
+    get leastLoadNodesMemory() {
+        return [...this.nodes.values()]
+            .filter((node) => node.connected)
+            .sort((a, b) => {
+            const aload = a.stats.memory?.used
+                ? a.stats.memory.used
+                : 0;
+            const bload = b.stats.memory?.used
+                ? b.stats.memory.used
+                : 0;
+            return aload - bload;
+        });
+    }
+    /** Returns the least system load Nodes. */
+    get leastLoadNodesCpu() {
+        return [...this.nodes.values()]
+            .filter((node) => node.connected)
+            .sort((a, b) => {
+            const aload = a.stats.cpu
+                ? (a.stats.cpu.systemLoad / a.stats.cpu.cores) * 100
+                : 0;
+            const bload = b.stats.cpu
+                ? (b.stats.cpu.systemLoad / b.stats.cpu.cores) * 100
+                : 0;
+            return aload - bload;
+        });
     }
     deleteNode(node) {
         const decodeNode = typeof node === "string" ? this.nodes.get(node) : node || this.leastUsedNodes[0];

package/dist/esm/structures/Player.js

@@ -63,7 +63,9 @@ export class Player {
         this.guildId = this.options.guildId;
         this.voiceChannelId = this.options.voiceChannelId;
         this.textChannelId = this.options.textChannelId || null;
-        this.node = this.LavalinkManager.nodeManager.leastUsedNodes.filter(v => options.vcRegion ? v.options?.regions?.includes(options.vcRegion) : true)[0] || this.LavalinkManager.nodeManager.leastUsedNodes[0] || null;
+        this.node = typeof this.options.node === "string" ? this.LavalinkManager.nodeManager.nodes.get(this.options.node) : this.options.node;
+        if (!this.node || typeof this.node?.request !== "function")
+            this.node = this.LavalinkManager.nodeManager.leastUsedNodes.filter(v => options.vcRegion ? v.options?.regions?.includes(options.vcRegion) : true)[0] || this.LavalinkManager.nodeManager.leastUsedNodes[0] || null;
         if (!this.node)
             throw new Error("No available Node was found, please add a LavalinkNode to the Manager via Manager.NodeManager#createNode");
         if (this.LavalinkManager.options.playerOptions.volumeDecrementer)
@@ -71,7 +73,7 @@ export class Player {
         this.LavalinkManager.emit("playerCreate", this);
         if (typeof options.volume === "number" && !isNaN(options.volume))
             this.setVolume(options.volume);
-        this.queue = new Queue(this.guildId, {}, new QueueSaver(this.LavalinkManager.options.queueStore, this.LavalinkManager.options.queueOptions), this.LavalinkManager.options.queueChangesWatcher);
+        this.queue = new Queue(this.guildId, {}, new QueueSaver(this.LavalinkManager.options.queueOptions), this.LavalinkManager.options.queueOptions);
     }
     /**
      * Set custom data.

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

@@ -18,6 +18,8 @@ export interface StoreManager extends Record<any, any> {
 }
 export interface QueueSaverOptions {
     maxPreviousTracks: number;
+    queueStore?: StoreManager;
+    queueChangesWatcher?: QueueChangesWatcher;
 }
 export interface QueueSaver {
     /** @private */
@@ -26,7 +28,7 @@ export interface QueueSaver {
     options: QueueSaverOptions;
 }
 export declare class QueueSaver {
-    constructor(storeManager: StoreManager, options: QueueSaverOptions);
+    constructor(options: QueueSaverOptions);
     get(guildId: string): Promise<Partial<StoredQueue>>;
     delete(guildId: string): Promise<any>;
     set(guildId: string, value: any): Promise<any>;
@@ -59,7 +61,7 @@ export declare class Queue {
     static readonly StaticSymbol: Symbol;
     private managerUtils;
     private queueChanges;
-    constructor(guildId: string, data?: Partial<StoredQueue>, QueueSaver?: QueueSaver, queueChangesWatcher?: QueueChangesWatcher);
+    constructor(guildId: string, data?: Partial<StoredQueue>, QueueSaver?: QueueSaver, queueOptions?: QueueSaverOptions);
     /**
      * Utils for a Queue
      */

package/dist/esm/structures/Queue.js

@@ -1,8 +1,10 @@
 import { ManagerUitls, QueueSymbol } from "./Utils";
 export class QueueSaver {
-    constructor(storeManager, options) {
-        this._ = storeManager;
-        this.options = options;
+    constructor(options) {
+        this._ = options.queueStore || new DefaultQueueStore();
+        this.options = {
+            maxPreviousTracks: options.maxPreviousTracks
+        };
     }
     async get(guildId) {
         return await this._.parse(await this._.get(guildId));
@@ -60,8 +62,8 @@ export class Queue {
     static StaticSymbol = QueueSymbol;
     managerUtils = new ManagerUitls();
     queueChanges;
-    constructor(guildId, data = {}, QueueSaver, queueChangesWatcher) {
-        this.queueChanges = queueChangesWatcher || null;
+    constructor(guildId, data = {}, QueueSaver, queueOptions) {
+        this.queueChanges = queueOptions.queueChangesWatcher || null;
         this.guildId = guildId;
         this.QueueSaver = QueueSaver;
         this.options.maxPreviousTracks = this.QueueSaver?.options?.maxPreviousTracks ?? this.options.maxPreviousTracks;

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

@@ -1,6 +1,6 @@
 import { LavalinkFilterData } from "./Filters";
 import { LavalinkManager } from "./LavalinkManager";
-import { LavalinkNode, NodeStats } from "./Node";
+import { LavalinkNode, LavalinkNodeOptions, NodeStats } from "./Node";
 import { PlayOptions } from "./Player";
 import { Queue } from "./Queue";
 import { PluginInfo, Track } from "./Track";
@@ -40,10 +40,20 @@ export interface ManagerUitls {
 export declare class ManagerUitls {
     constructor(LavalinkManager?: LavalinkManager);
     buildTrack(data: any, requester: any): Track;
+    /**
+     * Validate if a data is equal to a node
+     * @param data
+     */
+    isNode(data: LavalinkNode): boolean;
+    /**
+     * Validate if a data is equal to node options
+     * @param data
+     */
+    isNodeOptions(data: LavalinkNodeOptions | any): boolean;
     /**
      * Validate if a data is euqal to a track
-     * @param {Track|any} data the Track to validate
-     * @returns {boolean}
+     * @param data the Track to validate
+     * @returns
      */
     isTrack(data: Track | any): boolean;
     validatedQuery(queryString: string, node: LavalinkNode): void;
@@ -85,6 +95,8 @@ export declare class MiniMap<K, V> extends Map<K, V> {
     filter<This, K2 extends K>(fn: (this: This, value: V, key: K, miniMap: this) => key is K2, thisArg: This): MiniMap<K2, V>;
     filter<This, V2 extends V>(fn: (this: This, value: V, key: K, miniMap: this) => value is V2, thisArg: This): MiniMap<K, V2>;
     filter<This>(fn: (this: This, value: V, key: K, miniMap: this) => boolean, thisArg: This): MiniMap<K, V>;
+    toJSON(): V[];
+    private static defaultSort;
     /**
      * Maps each item to another value into an array. Identical in behavior to
      * [Array.map()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map).

package/dist/esm/structures/Utils.js

@@ -38,10 +38,58 @@ export class ManagerUitls {
             throw new RangeError(`Argument "data" is not a valid track: ${error.message}`);
         }
     }
+    /**
+     * Validate if a data is equal to a node
+     * @param data
+     */
+    isNode(data) {
+        if (!data)
+            return false;
+        const keys = Object.getOwnPropertyNames(Object.getPrototypeOf(data));
+        if (!keys.includes("constructor"))
+            return false;
+        if (!keys.length)
+            return false;
+        // all required functions
+        if (!["connect", "destroy", "destroyPlayer", "fetchAllPlayers", "fetchInfo", "fetchPlayer", "fetchStats", "fetchVersion", "request", "updatePlayer", "updateSession"].every(v => keys.includes(v)))
+            return false;
+        return true;
+    }
+    /**
+     * Validate if a data is equal to node options
+     * @param data
+     */
+    isNodeOptions(data) {
+        if (!data || typeof data !== "object" || Array.isArray(data))
+            return false;
+        if (typeof data.host !== "string" || !data.host.length)
+            return false;
+        if (typeof data.port !== "number" || isNaN(data.port) || data.port < 0 || data.port > 65535)
+            return false;
+        if (typeof data.authorization !== "string" || !data.authorization.length)
+            return false;
+        if ("secure" in data && typeof data.secure !== "boolean")
+            return false;
+        if ("sessionId" in data && typeof data.sessionId !== "string")
+            return false;
+        if ("id" in data && typeof data.id !== "string")
+            return false;
+        if ("regions" in data && (!Array.isArray(data.regions) || !data.regions.every(v => typeof v === "string")))
+            return false;
+        if ("poolOptions" in data && typeof data.poolOptions !== "object")
+            return false;
+        if ("retryAmount" in data && (typeof data.retryAmount !== "number" || isNaN(data.retryAmount) || data.retryAmount <= 0))
+            return false;
+        if ("retryDelay" in data && (typeof data.retryDelay !== "number" || isNaN(data.retryDelay) || data.retryDelay <= 0))
+            return false;
+        if ("requestTimeout" in data && (typeof data.requestTimeout !== "number" || isNaN(data.requestTimeout) || data.requestTimeout <= 0))
+            return false;
+        return true;
+    }
     /**
      * Validate if a data is euqal to a track
-     * @param {Track|any} data the Track to validate
-     * @returns {boolean}
+     * @param data the Track to validate
+     * @returns
      */
     isTrack(data) {
         return typeof data?.encoded === "string" && typeof data?.info === "object";
@@ -148,6 +196,13 @@ export class MiniMap extends Map {
         }
         return results;
     }
+    toJSON() {
+        // toJSON is called recursively by JSON.stringify.
+        return [...this.values()];
+    }
+    static defaultSort(firstValue, secondValue) {
+        return Number(firstValue > secondValue) || Number(firstValue === secondValue) - 1;
+    }
     map(fn, thisArg) {
         if (typeof thisArg !== 'undefined')
             fn = fn.bind(thisArg);
@@ -165,11 +220,11 @@ export async function queueTrackEnd(queue, addBackToQueue = false) {
         if (queue.previous.length > queue.options.maxPreviousTracks)
             queue.previous.splice(queue.options.maxPreviousTracks, queue.previous.length);
     }
-    // change the current Track to the next upcoming one
-    queue.current = queue.tracks.shift() || null;
     // and if repeatMode == queue, add it back to the queue!
     if (addBackToQueue && queue.current)
         queue.tracks.push(queue.current);
+    // change the current Track to the next upcoming one
+    queue.current = queue.tracks.shift() || null;
     // save it in the DB
     await queue.utils.save();
     // return the new current Track

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

@@ -1,7 +1,7 @@
 /// <reference types="node" />
 import { EventEmitter } from "events";
 import { NodeManager } from "./NodeManager";
-import { QueueChangesWatcher, QueueSaverOptions, StoreManager } from "./Queue";
+import { QueueSaverOptions } from "./Queue";
 import { GuildShardPayload, LavalinkSearchPlatform, ManagerUitls, MiniMap, SearchPlatform, TrackEndEvent, TrackExceptionEvent, TrackStartEvent, TrackStuckEvent, VoicePacket, VoiceServer, VoiceState, WebSocketClosedEvent } from "./Utils";
 import { LavalinkNodeOptions } from "./Node";
 import { DestroyReasonsType, Player, PlayerOptions } from "./Player";
@@ -44,11 +44,11 @@ export interface LavalinkPlayerOptions {
 export interface ManagerOptions {
     nodes: LavalinkNodeOptions[];
     queueOptions?: QueueSaverOptions;
-    queueStore?: StoreManager;
-    queueChangesWatcher?: QueueChangesWatcher;
     client?: BotClientOptions;
     playerOptions?: LavalinkPlayerOptions;
     autoSkip?: boolean;
+    defaultLeastUsedNodeSortType?: "memory" | "calls" | "players";
+    defaultLeastLoadNodeSortType?: "cpu" | "memory";
     /** @async */
     sendToShard: (guildId: string, payload: GuildShardPayload) => void;
 }

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

@@ -56,6 +56,17 @@ export declare class NodeManager extends EventEmitter {
     constructor(LavalinkManager: LavalinkManager);
     createNode(options: LavalinkNodeOptions): LavalinkNode;
     get leastUsedNodes(): LavalinkNode[];
+    /** Returns the least used Nodes sorted by amount of calls. */
+    private get leastUsedNodesCalls();
+    /** Returns the least used Nodes sorted by amount of players. */
+    private get leastUsedNodesPlayers();
+    /** Returns the least used Nodes sorted by amount of memory usage. */
+    private get leastUsedNodesMemory();
+    /** Returns the least system load Nodes. */
+    get leastLoadNodes(): LavalinkNode[];
+    get leastLoadNodesMemory(): LavalinkNode[];
+    /** Returns the least system load Nodes. */
+    get leastLoadNodesCpu(): LavalinkNode[];
     deleteNode(node: LavalinkNodeIdentifier | LavalinkNode): void;
 }
 export {};

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

@@ -18,6 +18,8 @@ export interface StoreManager extends Record<any, any> {
 }
 export interface QueueSaverOptions {
     maxPreviousTracks: number;
+    queueStore?: StoreManager;
+    queueChangesWatcher?: QueueChangesWatcher;
 }
 export interface QueueSaver {
     /** @private */
@@ -26,7 +28,7 @@ export interface QueueSaver {
     options: QueueSaverOptions;
 }
 export declare class QueueSaver {
-    constructor(storeManager: StoreManager, options: QueueSaverOptions);
+    constructor(options: QueueSaverOptions);
     get(guildId: string): Promise<Partial<StoredQueue>>;
     delete(guildId: string): Promise<any>;
     set(guildId: string, value: any): Promise<any>;
@@ -59,7 +61,7 @@ export declare class Queue {
     static readonly StaticSymbol: Symbol;
     private managerUtils;
     private queueChanges;
-    constructor(guildId: string, data?: Partial<StoredQueue>, QueueSaver?: QueueSaver, queueChangesWatcher?: QueueChangesWatcher);
+    constructor(guildId: string, data?: Partial<StoredQueue>, QueueSaver?: QueueSaver, queueOptions?: QueueSaverOptions);
     /**
      * Utils for a Queue
      */

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

@@ -1,6 +1,6 @@
 import { LavalinkFilterData } from "./Filters";
 import { LavalinkManager } from "./LavalinkManager";
-import { LavalinkNode, NodeStats } from "./Node";
+import { LavalinkNode, LavalinkNodeOptions, NodeStats } from "./Node";
 import { PlayOptions } from "./Player";
 import { Queue } from "./Queue";
 import { PluginInfo, Track } from "./Track";
@@ -40,10 +40,20 @@ export interface ManagerUitls {
 export declare class ManagerUitls {
     constructor(LavalinkManager?: LavalinkManager);
     buildTrack(data: any, requester: any): Track;
+    /**
+     * Validate if a data is equal to a node
+     * @param data
+     */
+    isNode(data: LavalinkNode): boolean;
+    /**
+     * Validate if a data is equal to node options
+     * @param data
+     */
+    isNodeOptions(data: LavalinkNodeOptions | any): boolean;
     /**
      * Validate if a data is euqal to a track
-     * @param {Track|any} data the Track to validate
-     * @returns {boolean}
+     * @param data the Track to validate
+     * @returns
      */
     isTrack(data: Track | any): boolean;
     validatedQuery(queryString: string, node: LavalinkNode): void;
@@ -85,6 +95,8 @@ export declare class MiniMap<K, V> extends Map<K, V> {
     filter<This, K2 extends K>(fn: (this: This, value: V, key: K, miniMap: this) => key is K2, thisArg: This): MiniMap<K2, V>;
     filter<This, V2 extends V>(fn: (this: This, value: V, key: K, miniMap: this) => value is V2, thisArg: This): MiniMap<K, V2>;
     filter<This>(fn: (this: This, value: V, key: K, miniMap: this) => boolean, thisArg: This): MiniMap<K, V>;
+    toJSON(): V[];
+    private static defaultSort;
     /**
      * Maps each item to another value into an array. Identical in behavior to
      * [Array.map()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lavalink-client",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Easy and advanced lavalink client. Use it with lavalink plugins as well as latest lavalink versions",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",