lavalink-client 1.1.7 → 1.1.10

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

@@ -56,6 +56,11 @@ export interface ManagerOptions {
     playerOptions?: ManagerPlayerOptions;
     /** If it should skip to the next Track on TrackEnd / TrackError etc. events */
     autoSkip?: boolean;
+    /** optional */
+    debugOptions?: {
+        /** logs for debugging the "no-Audio" playing error */
+        noAudio: boolean;
+    };
 }
 interface LavalinkManagerEvents {
     /**
@@ -124,8 +129,8 @@ export declare class LavalinkManager extends EventEmitter {
     static SourceLinksRegexes: Record<import("./Utils").SourcesRegex, RegExp>;
     initiated: boolean;
     readonly players: MiniMap<string, Player>;
-    private applyDefaultOptions;
-    private validateAndApply;
+    private applyOptions;
+    private validateOptions;
     constructor(options: ManagerOptions);
     createPlayer(options: PlayerOptions): Player;
     getPlayer(guildId: string): Player;

package/dist/cjs/structures/LavalinkManager.js

@@ -12,94 +12,83 @@ class LavalinkManager extends events_1.EventEmitter {
     static SourceLinksRegexes = LavalinkManagerStatics_1.SourceLinksRegexes;
     initiated = false;
     players = new Utils_1.MiniMap();
-    applyDefaultOptions() {
-        if (!this.options.playerOptions)
-            this.options.playerOptions = {
-                applyVolumeAsFilter: false,
-                clientBasedPositionUpdateInterval: 100,
-                defaultSearchPlatform: "ytsearch",
+    applyOptions(options) {
+        this.options = {
+            client: {
+                ...(options?.client || {}),
+                id: options?.client?.id,
+                username: options?.client?.username ?? "lavalink-client"
+            },
+            sendToShard: options?.sendToShard,
+            nodes: options?.nodes,
+            playerOptions: {
+                applyVolumeAsFilter: options?.playerOptions?.applyVolumeAsFilter ?? false,
+                clientBasedPositionUpdateInterval: options?.playerOptions?.clientBasedPositionUpdateInterval ?? 100,
+                defaultSearchPlatform: options?.playerOptions?.defaultSearchPlatform ?? "ytsearch",
                 onDisconnect: {
-                    destroyPlayer: true,
-                    autoReconnect: false
+                    destroyPlayer: options?.playerOptions?.onDisconnect?.destroyPlayer ?? true,
+                    autoReconnect: options?.playerOptions?.onDisconnect?.autoReconnect ?? false
                 },
                 onEmptyQueue: {
-                    autoPlayFunction: null,
-                    destroyAfterMs: undefined
+                    autoPlayFunction: options?.playerOptions?.onEmptyQueue?.autoPlayFunction ?? null,
+                    destroyAfterMs: options?.playerOptions?.onEmptyQueue?.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.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;
+                volumeDecrementer: options?.playerOptions?.volumeDecrementer ?? 1,
+                requesterTransformer: options?.playerOptions?.requesterTransformer ?? null,
+                useUnresolvedData: options?.playerOptions?.useUnresolvedData ?? false,
+            },
+            autoSkip: options?.autoSkip ?? true,
+            queueOptions: {
+                maxPreviousTracks: options?.queueOptions?.maxPreviousTracks ?? 25,
+                queueChangesWatcher: options?.queueOptions?.queueChangesWatcher ?? null,
+                queueStore: options?.queueOptions?.queueStore ?? new Queue_1.DefaultQueueStore(),
+            },
+            debugOptions: {
+                noAudio: options?.debugOptions?.noAudio ?? false
+            }
+        };
         return;
     }
-    validateAndApply(options) {
-        if (typeof options.sendToShard !== "function")
+    validateOptions(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 } was not provided, which is required");
-        if (options.autoSkip && typeof options.autoSkip !== "boolean")
+        // if(typeof options?.client !== "object" || typeof options?.client.id !== "string") throw new SyntaxError("ManagerOption.client = { id: string, username?:string } 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.nodes || !Array.isArray(options.nodes) || !options.nodes.every(node => this.utils.isNodeOptions(node)))
+        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.queueOptions?.queueStore) {
-            const keys = Object.getOwnPropertyNames(Object.getPrototypeOf(options.queueOptions?.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.queueOptions?.queueStore[v] === "function"))
+            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.queueOptions.queueStore = new Queue_1.DefaultQueueStore();
         /* QUEUE WATCHER */
-        if (options.queueOptions?.queueChangesWatcher) {
-            const keys = Object.getOwnPropertyNames(Object.getPrototypeOf(options.queueOptions?.queueChangesWatcher));
+        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"))
+            if (!requiredKeys.every(v => keys.includes(v)) || !requiredKeys.every(v => typeof options?.queueOptions?.queueChangesWatcher[v] === "function"))
                 throw new SyntaxError(`The provided ManagerOption.DefaultQueueChangesWatcher, does not have all required functions: ${requiredKeys.join(", ")}`);
         }
+        if (typeof options?.queueOptions?.maxPreviousTracks !== "number" || options?.queueOptions?.maxPreviousTracks < 0)
+            options.queueOptions.maxPreviousTracks = 25;
     }
     constructor(options) {
         super();
         if (!options)
             throw new SyntaxError("No Manager Options Provided");
-        // create options
-        this.options = options;
         this.utils = new Utils_1.ManagerUtils(this);
         // use the validators
-        this.validateAndApply(options);
-        this.applyDefaultOptions();
+        this.applyOptions(options);
+        this.validateOptions(options);
         // create classes
         this.nodeManager = new NodeManager_1.NodeManager(this);
     }
     createPlayer(options) {
-        if (this.players.has(options.guildId))
-            return this.players.get(options.guildId);
+        if (this.players.has(options?.guildId))
+            return this.players.get(options?.guildId);
         const newPlayer = new Player_1.Player(options, this);
         this.players.set(newPlayer.guildId, newPlayer);
         return newPlayer;
@@ -122,10 +111,11 @@ class LavalinkManager extends events_1.EventEmitter {
     async init(clientData) {
         if (this.initiated)
             return this;
-        this.options.client = { ...(this.options.client || {}), ...clientData };
-        if (!this.options.client.id)
+        clientData = clientData ?? {};
+        this.options.client = { ...(this.options?.client || {}), ...clientData };
+        if (!this.options?.client.id)
             throw new Error('"client.id" is not set. Pass it in Manager#init() or as a option in the constructor.');
-        if (typeof this.options.client.id !== "string")
+        if (typeof this.options?.client.id !== "string")
             throw new Error('"client.id" set is not type of "string"');
         let success = 0;
         for (const node of [...this.nodeManager.nodes.values()]) {
@@ -149,8 +139,16 @@ class LavalinkManager extends events_1.EventEmitter {
      * @param data
      */
     async sendRawData(data) {
-        if (!this.initiated || !("t" in data))
+        if (!this.initiated) {
+            if (this.options?.debugOptions?.noAudio === true)
+                console.debug("Lavalink-Client-Debug | NO-AUDIO [::] sendRawData function, manager is not initated yet");
+            return;
+        }
+        if (!("t" in data)) {
+            if (this.options?.debugOptions?.noAudio === true)
+                console.debug("Lavalink-Client-Debug | NO-AUDIO [::] sendRawData function, no 't' in payload-data of the raw event:", data);
             return;
+        }
         // for channel Delete
         if ("CHANNEL_DELETE" === data.t) {
             const update = "d" in data ? data.d : data;
@@ -163,11 +161,22 @@ class LavalinkManager extends events_1.EventEmitter {
         // for voice updates
         if (["VOICE_STATE_UPDATE", "VOICE_SERVER_UPDATE"].includes(data.t)) {
             const update = "d" in data ? data.d : data;
-            if (!update || !("token" in update) && !("session_id" in update))
+            if (!update) {
+                if (this.options?.debugOptions?.noAudio === true)
+                    console.debug("Lavalink-Client-Debug | NO-AUDIO [::] sendRawData function, no update data found in payload:", data);
+                return;
+            }
+            if (!("token" in update) && !("session_id" in update)) {
+                if (this.options?.debugOptions?.noAudio === true)
+                    console.debug("Lavalink-Client-Debug | NO-AUDIO [::] sendRawData function, no 'token' nor 'session_id' found in payload:", data);
                 return;
+            }
             const player = this.getPlayer(update.guild_id);
-            if (!player)
+            if (!player) {
+                if (this.options?.debugOptions?.noAudio === true)
+                    console.debug("Lavalink-Client-Debug | NO-AUDIO [::] sendRawData function, No Lavalink Player found via key: 'guild_id' of update-data:", update);
                 return;
+            }
             if ("token" in update) {
                 if (!player.node?.sessionId)
                     throw new Error("Lavalink Node is either not ready or not up to date");
@@ -181,11 +190,16 @@ class LavalinkManager extends events_1.EventEmitter {
                         }
                     }
                 });
+                if (this.options?.debugOptions?.noAudio === true)
+                    console.debug("Lavalink-Client-Debug | NO-AUDIO [::] sendRawData function, Sent updatePlayer for voice token session", { voice: { token: update.token, endpoint: update.endpoint, sessionId: player.voice?.sessionId, } });
                 return;
             }
             /* voice state update */
-            if (update.user_id !== this.options.client.id)
+            if (update.user_id !== this.options?.client.id) {
+                if (this.options?.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;
+            }
             if (update.channel_id) {
                 if (player.voiceChannelId !== update.channel_id)
                     this.emit("playerMove", player, player.voiceChannelId, update.channel_id);
@@ -193,12 +207,12 @@ class LavalinkManager extends events_1.EventEmitter {
                 player.voiceChannelId = update.channel_id;
             }
             else {
-                if (this.options.playerOptions.onDisconnect?.destroyPlayer === true) {
+                if (this.options?.playerOptions?.onDisconnect?.destroyPlayer === true) {
                     return await player.destroy(Player_1.DestroyReasons.Disconnected);
                 }
                 this.emit("playerDisconnect", player, player.voiceChannelId);
                 await player.pause();
-                if (this.options.playerOptions.onDisconnect?.autoReconnect === true) {
+                if (this.options?.playerOptions?.onDisconnect?.autoReconnect === true) {
                     try {
                         await player.connect();
                     }

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

@@ -1,3 +1,10 @@
 import { LavalinkSearchPlatform, SearchPlatform, SourcesRegex } from "./Utils";
 export declare const DefaultSources: Record<SearchPlatform, LavalinkSearchPlatform>;
+export declare const LavalinkPlugins: {
+    DuncteBot_Plugin: string;
+    LavaSrc: string;
+    GoogleCloudTTS: string;
+    LavaSearch: string;
+    LavalinkFilterPlugin: string;
+};
 export declare const SourceLinksRegexes: Record<SourcesRegex, RegExp>;

package/dist/cjs/structures/LavalinkManagerStatics.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SourceLinksRegexes = exports.DefaultSources = void 0;
+exports.SourceLinksRegexes = exports.LavalinkPlugins = exports.DefaultSources = void 0;
 exports.DefaultSources = {
     // youtubemusic
     "youtube music": "ytmsearch",
@@ -42,6 +42,13 @@ exports.DefaultSources = {
     "tts": "tts",
     "ftts": "ftts"
 };
+exports.LavalinkPlugins = {
+    DuncteBot_Plugin: "DuncteBot-plugin",
+    LavaSrc: "lavasrc-plugin",
+    GoogleCloudTTS: "tts-plugin",
+    LavaSearch: "lavasearch-plugin",
+    LavalinkFilterPlugin: "lavalink-filter-plugin"
+};
 exports.SourceLinksRegexes = {
     /** DEFAULT SUPPORTED BY LAVALINK */
     YoutubeRegex: /https?:\/\/?(?:www\.)?(?:(m|www)\.)?(?:youtu\.be\/|youtube\.com\/(?:embed\/|v\/|shorts|playlist\?|watch\?v=|watch\?.+(?:&|&);v=))([a-zA-Z0-9\-_]{11})?(?:(?:\?|&|&)index=((?:\d){1,3}))?(?:(?:\?|&|&)?list=([a-zA-Z\-_0-9]{34}))?(?:\S+)?/,

package/dist/cjs/structures/Node.js

@@ -339,12 +339,12 @@ class LavalinkNode {
                 player.voice = data.playerOptions.voice;
             if (typeof data.playerOptions.volume !== "undefined") {
                 if (this.NodeManager.LavalinkManager.options.playerOptions.volumeDecrementer) {
-                    player.volume = data.playerOptions.volume / this.NodeManager.LavalinkManager.options.playerOptions.volumeDecrementer;
-                    player.lavalinkVolume = data.playerOptions.volume;
+                    player.volume = Math.round(data.playerOptions.volume / this.NodeManager.LavalinkManager.options.playerOptions.volumeDecrementer);
+                    player.lavalinkVolume = Math.round(data.playerOptions.volume);
                 }
                 else {
-                    player.volume = data.playerOptions.volume;
-                    player.lavalinkVolume = data.playerOptions.volume;
+                    player.volume = Math.round(data.playerOptions.volume);
+                    player.lavalinkVolume = Math.round(data.playerOptions.volume);
                 }
             }
             if (typeof data.playerOptions.filters !== "undefined") {

package/dist/cjs/structures/Player.js

@@ -73,11 +73,13 @@ class Player {
         }
         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)
-            this.volume *= this.LavalinkManager.options.playerOptions.volumeDecrementer;
-        this.LavalinkManager.emit("playerCreate", this);
         if (typeof options.volume === "number" && !isNaN(options.volume))
-            this.setVolume(options.volume);
+            this.volume = Number(options.volume);
+        this.volume = Math.round(Math.max(Math.min(this.volume, 1000), 0));
+        this.lavalinkVolume = Math.round(Math.max(Math.min(Math.round(this.LavalinkManager.options.playerOptions.volumeDecrementer
+            ? this.volume * this.LavalinkManager.options.playerOptions.volumeDecrementer
+            : this.volume), 1000), 0));
+        this.LavalinkManager.emit("playerCreate", this);
         this.queue = new Queue_1.Queue(this.guildId, {}, new Queue_1.QueueSaver(this.LavalinkManager.options.queueOptions), this.LavalinkManager.options.queueOptions);
     }
     /**
@@ -155,8 +157,8 @@ class Player {
             let vol = Number(this.volume);
             if (this.LavalinkManager.options.playerOptions.volumeDecrementer)
                 vol *= this.LavalinkManager.options.playerOptions.volumeDecrementer;
-            this.lavalinkVolume = Math.floor(vol * 100) / 100;
-            options.volume = vol;
+            this.lavalinkVolume = Math.round(vol);
+            options.volume = this.lavalinkVolume;
         }
         const finalOptions = {
             encodedTrack: track.encoded,
@@ -193,17 +195,16 @@ class Player {
         volume = Number(volume);
         if (isNaN(volume))
             throw new TypeError("Volume must be a number.");
-        this.volume = Math.max(Math.min(volume, 500), 0);
-        volume = Number(this.volume);
-        if (this.LavalinkManager.options.playerOptions.volumeDecrementer && !ignoreVolumeDecrementer)
-            volume *= this.LavalinkManager.options.playerOptions.volumeDecrementer;
-        this.lavalinkVolume = Math.floor(volume * 100) / 100;
+        this.volume = Math.round(Math.max(Math.min(volume, 1000), 0));
+        this.lavalinkVolume = Math.round(Math.max(Math.min(Math.round(this.LavalinkManager.options.playerOptions.volumeDecrementer && !ignoreVolumeDecrementer
+            ? this.volume * this.LavalinkManager.options.playerOptions.volumeDecrementer
+            : this.volume), 1000), 0));
         const now = performance.now();
         if (this.LavalinkManager.options.playerOptions.applyVolumeAsFilter) {
-            await this.node.updatePlayer({ guildId: this.guildId, playerOptions: { filters: { volume: volume / 100 } } });
+            await this.node.updatePlayer({ guildId: this.guildId, playerOptions: { filters: { volume: this.lavalinkVolume / 100 } } });
         }
         else {
-            await this.node.updatePlayer({ guildId: this.guildId, playerOptions: { volume } });
+            await this.node.updatePlayer({ guildId: this.guildId, playerOptions: { volume: this.lavalinkVolume } });
         }
         this.ping.lavalink = Math.round((performance.now() - now) / 10) / 100;
         return;
@@ -420,7 +421,7 @@ class Player {
             noReplace: false,
             playerOptions: {
                 position: data.position,
-                volume: data.volume,
+                volume: Math.round(Math.max(Math.min(data.volume, 1000), 0)),
                 paused: data.paused,
                 filters: { ...data.filters, equalizer: data.equalizer },
             },

package/dist/cjs/structures/Utils.js

@@ -218,15 +218,14 @@ class ManagerUtils {
         if (source === "scsearch" && !node.info.sourceManagers.includes("soundcloud")) {
             throw new Error("Lavalink Node has not 'soundcloud' enabled, which is required to have 'scsearch' work");
         }
-        if (source === "speak" && !node.info.sourceManagers.includes("speak")) {
+        if (source === "speak" && !node.info.plugins.find(c => c.name.toLowerCase().includes(LavalinkManagerStatics_1.LavalinkPlugins.DuncteBot_Plugin.toLowerCase()))) {
             throw new Error("Lavalink Node has not 'speak' enabled, which is required to have 'speak' work");
         }
-        if (source === "tts" && !node.info.sourceManagers.includes("tts")) {
+        if (source === "tts" && !node.info.plugins.find(c => c.name.toLowerCase().includes(LavalinkManagerStatics_1.LavalinkPlugins.GoogleCloudTTS.toLowerCase()))) {
             throw new Error("Lavalink Node has not 'tts' enabled, which is required to have 'tts' work");
         }
-        if (source === "ftts" && !node.info.sourceManagers.includes("ftts") && !node.info.sourceManagers.includes("flowerytts")) {
-            console.log(node.info.sourceManagers);
-            throw new Error("Lavalink Node has not 'ftts' enabled, which is required to have 'ftts' work");
+        if (source === "ftts" && !(node.info.sourceManagers.includes("ftts") || node.info.sourceManagers.includes("flowery-tts") || node.info.sourceManagers.includes("flowerytts"))) {
+            throw new Error("Lavalink Node has not 'flowery-tts' enabled, which is required to have 'ftts' work");
         }
         if (source === "ymsearch" && !node.info.sourceManagers.includes("yandexmusic")) {
             throw new Error("Lavalink Node has not 'yandexmusic' enabled, which is required to have 'ymsearch' work");
@@ -293,9 +292,9 @@ exports.queueTrackEnd = queueTrackEnd;
 async function applyUnresolvedData(resTrack, data, utils) {
     if (!resTrack?.info || !data?.info)
         return;
+    if (data.info.uri)
+        resTrack.info.uri = data.info.uri;
     if (utils?.LavalinkManager?.options?.playerOptions?.useUnresolvedData === true) { // overwrite values
-        if (data.info.uri)
-            resTrack.info.uri = data.info.uri;
         if (data.info.artworkUrl?.length)
             resTrack.info.artworkUrl = data.info.artworkUrl;
         if (data.info.title?.length)

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

@@ -56,6 +56,11 @@ export interface ManagerOptions {
     playerOptions?: ManagerPlayerOptions;
     /** If it should skip to the next Track on TrackEnd / TrackError etc. events */
     autoSkip?: boolean;
+    /** optional */
+    debugOptions?: {
+        /** logs for debugging the "no-Audio" playing error */
+        noAudio: boolean;
+    };
 }
 interface LavalinkManagerEvents {
     /**
@@ -124,8 +129,8 @@ export declare class LavalinkManager extends EventEmitter {
     static SourceLinksRegexes: Record<import("./Utils").SourcesRegex, RegExp>;
     initiated: boolean;
     readonly players: MiniMap<string, Player>;
-    private applyDefaultOptions;
-    private validateAndApply;
+    private applyOptions;
+    private validateOptions;
     constructor(options: ManagerOptions);
     createPlayer(options: PlayerOptions): Player;
     getPlayer(guildId: string): Player;

package/dist/esm/structures/LavalinkManager.js

@@ -9,94 +9,83 @@ export class LavalinkManager extends EventEmitter {
     static SourceLinksRegexes = SourceLinksRegexes;
     initiated = false;
     players = new MiniMap();
-    applyDefaultOptions() {
-        if (!this.options.playerOptions)
-            this.options.playerOptions = {
-                applyVolumeAsFilter: false,
-                clientBasedPositionUpdateInterval: 100,
-                defaultSearchPlatform: "ytsearch",
+    applyOptions(options) {
+        this.options = {
+            client: {
+                ...(options?.client || {}),
+                id: options?.client?.id,
+                username: options?.client?.username ?? "lavalink-client"
+            },
+            sendToShard: options?.sendToShard,
+            nodes: options?.nodes,
+            playerOptions: {
+                applyVolumeAsFilter: options?.playerOptions?.applyVolumeAsFilter ?? false,
+                clientBasedPositionUpdateInterval: options?.playerOptions?.clientBasedPositionUpdateInterval ?? 100,
+                defaultSearchPlatform: options?.playerOptions?.defaultSearchPlatform ?? "ytsearch",
                 onDisconnect: {
-                    destroyPlayer: true,
-                    autoReconnect: false
+                    destroyPlayer: options?.playerOptions?.onDisconnect?.destroyPlayer ?? true,
+                    autoReconnect: options?.playerOptions?.onDisconnect?.autoReconnect ?? false
                 },
                 onEmptyQueue: {
-                    autoPlayFunction: null,
-                    destroyAfterMs: undefined
+                    autoPlayFunction: options?.playerOptions?.onEmptyQueue?.autoPlayFunction ?? null,
+                    destroyAfterMs: options?.playerOptions?.onEmptyQueue?.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.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;
+                volumeDecrementer: options?.playerOptions?.volumeDecrementer ?? 1,
+                requesterTransformer: options?.playerOptions?.requesterTransformer ?? null,
+                useUnresolvedData: options?.playerOptions?.useUnresolvedData ?? false,
+            },
+            autoSkip: options?.autoSkip ?? true,
+            queueOptions: {
+                maxPreviousTracks: options?.queueOptions?.maxPreviousTracks ?? 25,
+                queueChangesWatcher: options?.queueOptions?.queueChangesWatcher ?? null,
+                queueStore: options?.queueOptions?.queueStore ?? new DefaultQueueStore(),
+            },
+            debugOptions: {
+                noAudio: options?.debugOptions?.noAudio ?? false
+            }
+        };
         return;
     }
-    validateAndApply(options) {
-        if (typeof options.sendToShard !== "function")
+    validateOptions(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 } was not provided, which is required");
-        if (options.autoSkip && typeof options.autoSkip !== "boolean")
+        // if(typeof options?.client !== "object" || typeof options?.client.id !== "string") throw new SyntaxError("ManagerOption.client = { id: string, username?:string } 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.nodes || !Array.isArray(options.nodes) || !options.nodes.every(node => this.utils.isNodeOptions(node)))
+        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.queueOptions?.queueStore) {
-            const keys = Object.getOwnPropertyNames(Object.getPrototypeOf(options.queueOptions?.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.queueOptions?.queueStore[v] === "function"))
+            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.queueOptions.queueStore = new DefaultQueueStore();
         /* QUEUE WATCHER */
-        if (options.queueOptions?.queueChangesWatcher) {
-            const keys = Object.getOwnPropertyNames(Object.getPrototypeOf(options.queueOptions?.queueChangesWatcher));
+        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"))
+            if (!requiredKeys.every(v => keys.includes(v)) || !requiredKeys.every(v => typeof options?.queueOptions?.queueChangesWatcher[v] === "function"))
                 throw new SyntaxError(`The provided ManagerOption.DefaultQueueChangesWatcher, does not have all required functions: ${requiredKeys.join(", ")}`);
         }
+        if (typeof options?.queueOptions?.maxPreviousTracks !== "number" || options?.queueOptions?.maxPreviousTracks < 0)
+            options.queueOptions.maxPreviousTracks = 25;
     }
     constructor(options) {
         super();
         if (!options)
             throw new SyntaxError("No Manager Options Provided");
-        // create options
-        this.options = options;
         this.utils = new ManagerUtils(this);
         // use the validators
-        this.validateAndApply(options);
-        this.applyDefaultOptions();
+        this.applyOptions(options);
+        this.validateOptions(options);
         // create classes
         this.nodeManager = new NodeManager(this);
     }
     createPlayer(options) {
-        if (this.players.has(options.guildId))
-            return this.players.get(options.guildId);
+        if (this.players.has(options?.guildId))
+            return this.players.get(options?.guildId);
         const newPlayer = new Player(options, this);
         this.players.set(newPlayer.guildId, newPlayer);
         return newPlayer;
@@ -119,10 +108,11 @@ export class LavalinkManager extends EventEmitter {
     async init(clientData) {
         if (this.initiated)
             return this;
-        this.options.client = { ...(this.options.client || {}), ...clientData };
-        if (!this.options.client.id)
+        clientData = clientData ?? {};
+        this.options.client = { ...(this.options?.client || {}), ...clientData };
+        if (!this.options?.client.id)
             throw new Error('"client.id" is not set. Pass it in Manager#init() or as a option in the constructor.');
-        if (typeof this.options.client.id !== "string")
+        if (typeof this.options?.client.id !== "string")
             throw new Error('"client.id" set is not type of "string"');
         let success = 0;
         for (const node of [...this.nodeManager.nodes.values()]) {
@@ -146,8 +136,16 @@ export class LavalinkManager extends EventEmitter {
      * @param data
      */
     async sendRawData(data) {
-        if (!this.initiated || !("t" in data))
+        if (!this.initiated) {
+            if (this.options?.debugOptions?.noAudio === true)
+                console.debug("Lavalink-Client-Debug | NO-AUDIO [::] sendRawData function, manager is not initated yet");
+            return;
+        }
+        if (!("t" in data)) {
+            if (this.options?.debugOptions?.noAudio === true)
+                console.debug("Lavalink-Client-Debug | NO-AUDIO [::] sendRawData function, no 't' in payload-data of the raw event:", data);
             return;
+        }
         // for channel Delete
         if ("CHANNEL_DELETE" === data.t) {
             const update = "d" in data ? data.d : data;
@@ -160,11 +158,22 @@ export class LavalinkManager extends EventEmitter {
         // for voice updates
         if (["VOICE_STATE_UPDATE", "VOICE_SERVER_UPDATE"].includes(data.t)) {
             const update = "d" in data ? data.d : data;
-            if (!update || !("token" in update) && !("session_id" in update))
+            if (!update) {
+                if (this.options?.debugOptions?.noAudio === true)
+                    console.debug("Lavalink-Client-Debug | NO-AUDIO [::] sendRawData function, no update data found in payload:", data);
+                return;
+            }
+            if (!("token" in update) && !("session_id" in update)) {
+                if (this.options?.debugOptions?.noAudio === true)
+                    console.debug("Lavalink-Client-Debug | NO-AUDIO [::] sendRawData function, no 'token' nor 'session_id' found in payload:", data);
                 return;
+            }
             const player = this.getPlayer(update.guild_id);
-            if (!player)
+            if (!player) {
+                if (this.options?.debugOptions?.noAudio === true)
+                    console.debug("Lavalink-Client-Debug | NO-AUDIO [::] sendRawData function, No Lavalink Player found via key: 'guild_id' of update-data:", update);
                 return;
+            }
             if ("token" in update) {
                 if (!player.node?.sessionId)
                     throw new Error("Lavalink Node is either not ready or not up to date");
@@ -178,11 +187,16 @@ export class LavalinkManager extends EventEmitter {
                         }
                     }
                 });
+                if (this.options?.debugOptions?.noAudio === true)
+                    console.debug("Lavalink-Client-Debug | NO-AUDIO [::] sendRawData function, Sent updatePlayer for voice token session", { voice: { token: update.token, endpoint: update.endpoint, sessionId: player.voice?.sessionId, } });
                 return;
             }
             /* voice state update */
-            if (update.user_id !== this.options.client.id)
+            if (update.user_id !== this.options?.client.id) {
+                if (this.options?.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;
+            }
             if (update.channel_id) {
                 if (player.voiceChannelId !== update.channel_id)
                     this.emit("playerMove", player, player.voiceChannelId, update.channel_id);
@@ -190,12 +204,12 @@ export class LavalinkManager extends EventEmitter {
                 player.voiceChannelId = update.channel_id;
             }
             else {
-                if (this.options.playerOptions.onDisconnect?.destroyPlayer === true) {
+                if (this.options?.playerOptions?.onDisconnect?.destroyPlayer === true) {
                     return await player.destroy(DestroyReasons.Disconnected);
                 }
                 this.emit("playerDisconnect", player, player.voiceChannelId);
                 await player.pause();
-                if (this.options.playerOptions.onDisconnect?.autoReconnect === true) {
+                if (this.options?.playerOptions?.onDisconnect?.autoReconnect === true) {
                     try {
                         await player.connect();
                     }

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

@@ -1,3 +1,10 @@
 import { LavalinkSearchPlatform, SearchPlatform, SourcesRegex } from "./Utils";
 export declare const DefaultSources: Record<SearchPlatform, LavalinkSearchPlatform>;
+export declare const LavalinkPlugins: {
+    DuncteBot_Plugin: string;
+    LavaSrc: string;
+    GoogleCloudTTS: string;
+    LavaSearch: string;
+    LavalinkFilterPlugin: string;
+};
 export declare const SourceLinksRegexes: Record<SourcesRegex, RegExp>;

package/dist/esm/structures/LavalinkManagerStatics.js

@@ -39,6 +39,13 @@ export const DefaultSources = {
     "tts": "tts",
     "ftts": "ftts"
 };
+export const LavalinkPlugins = {
+    DuncteBot_Plugin: "DuncteBot-plugin",
+    LavaSrc: "lavasrc-plugin",
+    GoogleCloudTTS: "tts-plugin",
+    LavaSearch: "lavasearch-plugin",
+    LavalinkFilterPlugin: "lavalink-filter-plugin"
+};
 export const SourceLinksRegexes = {
     /** DEFAULT SUPPORTED BY LAVALINK */
     YoutubeRegex: /https?:\/\/?(?:www\.)?(?:(m|www)\.)?(?:youtu\.be\/|youtube\.com\/(?:embed\/|v\/|shorts|playlist\?|watch\?v=|watch\?.+(?:&|&);v=))([a-zA-Z0-9\-_]{11})?(?:(?:\?|&|&)index=((?:\d){1,3}))?(?:(?:\?|&|&)?list=([a-zA-Z\-_0-9]{34}))?(?:\S+)?/,

package/dist/esm/structures/Node.js

@@ -335,12 +335,12 @@ export class LavalinkNode {
                 player.voice = data.playerOptions.voice;
             if (typeof data.playerOptions.volume !== "undefined") {
                 if (this.NodeManager.LavalinkManager.options.playerOptions.volumeDecrementer) {
-                    player.volume = data.playerOptions.volume / this.NodeManager.LavalinkManager.options.playerOptions.volumeDecrementer;
-                    player.lavalinkVolume = data.playerOptions.volume;
+                    player.volume = Math.round(data.playerOptions.volume / this.NodeManager.LavalinkManager.options.playerOptions.volumeDecrementer);
+                    player.lavalinkVolume = Math.round(data.playerOptions.volume);
                 }
                 else {
-                    player.volume = data.playerOptions.volume;
-                    player.lavalinkVolume = data.playerOptions.volume;
+                    player.volume = Math.round(data.playerOptions.volume);
+                    player.lavalinkVolume = Math.round(data.playerOptions.volume);
                 }
             }
             if (typeof data.playerOptions.filters !== "undefined") {

package/dist/esm/structures/Player.js

@@ -70,11 +70,13 @@ export class Player {
         }
         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)
-            this.volume *= this.LavalinkManager.options.playerOptions.volumeDecrementer;
-        this.LavalinkManager.emit("playerCreate", this);
         if (typeof options.volume === "number" && !isNaN(options.volume))
-            this.setVolume(options.volume);
+            this.volume = Number(options.volume);
+        this.volume = Math.round(Math.max(Math.min(this.volume, 1000), 0));
+        this.lavalinkVolume = Math.round(Math.max(Math.min(Math.round(this.LavalinkManager.options.playerOptions.volumeDecrementer
+            ? this.volume * this.LavalinkManager.options.playerOptions.volumeDecrementer
+            : this.volume), 1000), 0));
+        this.LavalinkManager.emit("playerCreate", this);
         this.queue = new Queue(this.guildId, {}, new QueueSaver(this.LavalinkManager.options.queueOptions), this.LavalinkManager.options.queueOptions);
     }
     /**
@@ -152,8 +154,8 @@ export class Player {
             let vol = Number(this.volume);
             if (this.LavalinkManager.options.playerOptions.volumeDecrementer)
                 vol *= this.LavalinkManager.options.playerOptions.volumeDecrementer;
-            this.lavalinkVolume = Math.floor(vol * 100) / 100;
-            options.volume = vol;
+            this.lavalinkVolume = Math.round(vol);
+            options.volume = this.lavalinkVolume;
         }
         const finalOptions = {
             encodedTrack: track.encoded,
@@ -190,17 +192,16 @@ export class Player {
         volume = Number(volume);
         if (isNaN(volume))
             throw new TypeError("Volume must be a number.");
-        this.volume = Math.max(Math.min(volume, 500), 0);
-        volume = Number(this.volume);
-        if (this.LavalinkManager.options.playerOptions.volumeDecrementer && !ignoreVolumeDecrementer)
-            volume *= this.LavalinkManager.options.playerOptions.volumeDecrementer;
-        this.lavalinkVolume = Math.floor(volume * 100) / 100;
+        this.volume = Math.round(Math.max(Math.min(volume, 1000), 0));
+        this.lavalinkVolume = Math.round(Math.max(Math.min(Math.round(this.LavalinkManager.options.playerOptions.volumeDecrementer && !ignoreVolumeDecrementer
+            ? this.volume * this.LavalinkManager.options.playerOptions.volumeDecrementer
+            : this.volume), 1000), 0));
         const now = performance.now();
         if (this.LavalinkManager.options.playerOptions.applyVolumeAsFilter) {
-            await this.node.updatePlayer({ guildId: this.guildId, playerOptions: { filters: { volume: volume / 100 } } });
+            await this.node.updatePlayer({ guildId: this.guildId, playerOptions: { filters: { volume: this.lavalinkVolume / 100 } } });
         }
         else {
-            await this.node.updatePlayer({ guildId: this.guildId, playerOptions: { volume } });
+            await this.node.updatePlayer({ guildId: this.guildId, playerOptions: { volume: this.lavalinkVolume } });
         }
         this.ping.lavalink = Math.round((performance.now() - now) / 10) / 100;
         return;
@@ -417,7 +418,7 @@ export class Player {
             noReplace: false,
             playerOptions: {
                 position: data.position,
-                volume: data.volume,
+                volume: Math.round(Math.max(Math.min(data.volume, 1000), 0)),
                 paused: data.paused,
                 filters: { ...data.filters, equalizer: data.equalizer },
             },

package/dist/esm/structures/Utils.js

@@ -1,4 +1,4 @@
-import { DefaultSources, SourceLinksRegexes } from "./LavalinkManagerStatics";
+import { DefaultSources, LavalinkPlugins, SourceLinksRegexes } from "./LavalinkManagerStatics";
 export const TrackSymbol = Symbol("LC-Track");
 export const UnresolvedTrackSymbol = Symbol("LC-Track-Unresolved");
 export const QueueSymbol = Symbol("LC-Queue");
@@ -215,15 +215,14 @@ export class ManagerUtils {
         if (source === "scsearch" && !node.info.sourceManagers.includes("soundcloud")) {
             throw new Error("Lavalink Node has not 'soundcloud' enabled, which is required to have 'scsearch' work");
         }
-        if (source === "speak" && !node.info.sourceManagers.includes("speak")) {
+        if (source === "speak" && !node.info.plugins.find(c => c.name.toLowerCase().includes(LavalinkPlugins.DuncteBot_Plugin.toLowerCase()))) {
             throw new Error("Lavalink Node has not 'speak' enabled, which is required to have 'speak' work");
         }
-        if (source === "tts" && !node.info.sourceManagers.includes("tts")) {
+        if (source === "tts" && !node.info.plugins.find(c => c.name.toLowerCase().includes(LavalinkPlugins.GoogleCloudTTS.toLowerCase()))) {
             throw new Error("Lavalink Node has not 'tts' enabled, which is required to have 'tts' work");
         }
-        if (source === "ftts" && !node.info.sourceManagers.includes("ftts") && !node.info.sourceManagers.includes("flowerytts")) {
-            console.log(node.info.sourceManagers);
-            throw new Error("Lavalink Node has not 'ftts' enabled, which is required to have 'ftts' work");
+        if (source === "ftts" && !(node.info.sourceManagers.includes("ftts") || node.info.sourceManagers.includes("flowery-tts") || node.info.sourceManagers.includes("flowerytts"))) {
+            throw new Error("Lavalink Node has not 'flowery-tts' enabled, which is required to have 'ftts' work");
         }
         if (source === "ymsearch" && !node.info.sourceManagers.includes("yandexmusic")) {
             throw new Error("Lavalink Node has not 'yandexmusic' enabled, which is required to have 'ymsearch' work");
@@ -287,9 +286,9 @@ export async function queueTrackEnd(player) {
 async function applyUnresolvedData(resTrack, data, utils) {
     if (!resTrack?.info || !data?.info)
         return;
+    if (data.info.uri)
+        resTrack.info.uri = data.info.uri;
     if (utils?.LavalinkManager?.options?.playerOptions?.useUnresolvedData === true) { // overwrite values
-        if (data.info.uri)
-            resTrack.info.uri = data.info.uri;
         if (data.info.artworkUrl?.length)
             resTrack.info.artworkUrl = data.info.artworkUrl;
         if (data.info.title?.length)

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

@@ -56,6 +56,11 @@ export interface ManagerOptions {
     playerOptions?: ManagerPlayerOptions;
     /** If it should skip to the next Track on TrackEnd / TrackError etc. events */
     autoSkip?: boolean;
+    /** optional */
+    debugOptions?: {
+        /** logs for debugging the "no-Audio" playing error */
+        noAudio: boolean;
+    };
 }
 interface LavalinkManagerEvents {
     /**
@@ -124,8 +129,8 @@ export declare class LavalinkManager extends EventEmitter {
     static SourceLinksRegexes: Record<import("./Utils").SourcesRegex, RegExp>;
     initiated: boolean;
     readonly players: MiniMap<string, Player>;
-    private applyDefaultOptions;
-    private validateAndApply;
+    private applyOptions;
+    private validateOptions;
     constructor(options: ManagerOptions);
     createPlayer(options: PlayerOptions): Player;
     getPlayer(guildId: string): Player;

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

@@ -1,3 +1,10 @@
 import { LavalinkSearchPlatform, SearchPlatform, SourcesRegex } from "./Utils";
 export declare const DefaultSources: Record<SearchPlatform, LavalinkSearchPlatform>;
+export declare const LavalinkPlugins: {
+    DuncteBot_Plugin: string;
+    LavaSrc: string;
+    GoogleCloudTTS: string;
+    LavaSearch: string;
+    LavalinkFilterPlugin: string;
+};
 export declare const SourceLinksRegexes: Record<SourcesRegex, RegExp>;

package/package.json

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