lavalink-client 1.1.9 → 1.1.11

package/dist/cjs/structures/CustomSearches/BandCampSearch.d.ts

@@ -0,0 +1,3 @@
+import { Player } from "../Player";
+import { UnresolvedSearchResult } from "../Utils";
+export declare const bandCampSearch: (player: Player, query: string, requestUser: unknown) => Promise<UnresolvedSearchResult>;

package/dist/cjs/structures/CustomSearches/BandCampSearch.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bandCampSearch = void 0;
+const undici_1 = require("undici");
+const http_1 = require("http");
+const bandCampSearch = async (player, query, requestUser) => {
+    let error = null;
+    let tracks = [];
+    try {
+        const data = await (0, undici_1.fetch)(`https://bandcamp.com/api/nusearch/2/autocomplete?q=${encodeURIComponent(query)}`, {
+            headers: {
+                'User-Agent': 'android-async-http/1.4.1 (http://loopj.com/android-async-http)',
+                'Cookie': '$Version=1'
+            }
+        });
+        const json = await data.json();
+        tracks = json?.results?.filter(x => !!x && typeof x === "object" && "type" in x && x.type === "t").map?.(item => player.LavalinkManager.utils.buildUnresolvedTrack({
+            uri: item.url || item.uri,
+            artworkUrl: item.img,
+            author: item.band_name,
+            title: item.name,
+            identifier: item.id ? `${item.id}` : item.url?.split("/").reverse()[0],
+        }, http_1.request));
+    }
+    catch (e) {
+        error = e;
+    }
+    return {
+        loadType: "search",
+        exception: error,
+        pluginInfo: {},
+        playlist: null,
+        tracks: tracks
+    };
+};
+exports.bandCampSearch = bandCampSearch;

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

@@ -95,11 +95,11 @@ export declare class FilterManager {
     toggleEcho(delay?: number, decay?: number): Promise<boolean>;
     /**
      * Enabels / Disables the Echo effect, IMPORTANT! Only works with the correct Lavalink Plugin installed. (Optional: provide your Own Data)
-     * @param delay
-     * @param decay
+     * @param delays
+     * @param gains
      * @returns
      */
-    toggleReverb(delay?: number, decay?: number): Promise<boolean>;
+    toggleReverb(delays?: number[], gains?: number[]): Promise<boolean>;
     /**
      * Enables / Disabels a Nightcore-like filter Effect. Disables/Overwrides both: custom and Vaporwave Filter
      * @param speed
@@ -276,8 +276,8 @@ export interface EchoFilter {
  * A Plugin Filter
  */
 export interface ReverbFilter {
-    delay: number;
-    decay: number;
+    delays: number[];
+    gains: number[];
 }
 /**
  * Filter Data stored in the Client and partially sent to Lavalink
@@ -292,6 +292,13 @@ export interface FilterData {
     distortion?: DistortionFilter;
     channelMix?: ChannelMixFilter;
     lowPass?: LowPassFilter;
+    pluginFilters?: Record<PluginFiltersKey, PluginFiltersValues>;
+}
+export type PluginFiltersKey = "lavalink-filter-plugin" | string;
+export interface PluginFiltersValues extends LavalinkFiltersPlugin {
+    [key: string]: any;
+}
+export interface LavalinkFiltersPlugin {
     echo: EchoFilter;
     reverb: ReverbFilter;
 }

package/dist/cjs/structures/Filters.js

@@ -40,14 +40,6 @@ class FilterManager {
             pitch: 1,
             rate: 1 // 0 = x
         },
-        echo: {
-            delay: 0,
-            decay: 0
-        },
-        reverb: {
-            delay: 0,
-            decay: 0
-        },
         rotation: {
             rotationHz: 0
         },
@@ -59,6 +51,18 @@ class FilterManager {
             frequency: 0,
             depth: 0 // 0 < x = 1
         },
+        pluginFilters: {
+        /*"lavalink-filter-plugin": {
+            echo: {
+                delay: 0,
+                decay: 0
+            },
+            reverb: {
+                delays: [0.037, 0.042, 0.048, 0.053],
+                gains: [0.84, 0.83, 0.82, 0.81]
+            }
+        }*/
+        },
         channelMix: exports.audioOutputsData.stereo,
         /*distortion: {
             sinOffset: 0,
@@ -83,24 +87,27 @@ class FilterManager {
      */
     async applyPlayerFilters() {
         const sendData = { ...this.data };
+        this.checkFiltersState();
         if (!this.filters.volume)
             delete sendData.volume;
         if (!this.filters.tremolo)
             delete sendData.tremolo;
         if (!this.filters.vibrato)
             delete sendData.vibrato;
-        //if(!this.filters.karaoke) delete sendData.karaoke;
         if (!this.filters.echo)
-            delete sendData.echo;
+            delete sendData.pluginFilters?.["lavalink-filter-plugin"]?.echo;
         if (!this.filters.reverb)
-            delete sendData.reverb;
+            delete sendData.pluginFilters?.["lavalink-filter-plugin"]?.reverb;
         if (!this.filters.lowPass)
             delete sendData.lowPass;
         if (!this.filters.karaoke)
             delete sendData.karaoke;
-        //if(!this.filters.rotating) delete sendData.rotating;
+        if (!this.filters.rotation)
+            delete sendData.rotation;
         if (this.filters.audioOutput === "stereo")
             delete sendData.channelMix;
+        if (Object.values(this.data.timescale).every(v => v === 1))
+            delete sendData.timescale;
         if (!this.player.node.sessionId)
             throw new Error("The Lavalink-Node is either not ready or not up to date");
         sendData.equalizer = [...this.equalizerBands];
@@ -130,8 +137,9 @@ class FilterManager {
         this.filters.rotation = this.data.rotation.rotationHz !== 0;
         this.filters.vibrato = this.data.vibrato.frequency !== 0 || this.data.vibrato.depth !== 0;
         this.filters.tremolo = this.data.tremolo.frequency !== 0 || this.data.tremolo.depth !== 0;
-        this.filters.echo = this.data.echo.decay !== 0 || this.data.echo.delay !== 0;
-        this.filters.reverb = this.data.reverb.decay !== 0 || this.data.reverb.delay !== 0;
+        const lavalinkFilterData = (this.data.pluginFilters?.["lavalink-filter-plugin"] || { echo: { decay: 0, delay: 0 }, reverb: { gains: [], delays: [] } });
+        this.filters.echo = lavalinkFilterData.echo.decay !== 0 || lavalinkFilterData.echo.delay !== 0;
+        this.filters.reverb = lavalinkFilterData.reverb?.delays?.length !== 0 || lavalinkFilterData.reverb?.gains?.length !== 0;
         this.filters.lowPass = this.data.lowPass.smoothing !== 0;
         this.filters.karaoke = Object.values(this.data.karaoke).some(v => v !== 0);
         if ((this.filters.nightcore || this.filters.vaporwave) && oldFilterTimescale) {
@@ -180,8 +188,8 @@ class FilterManager {
                 decay: 0
             },
             reverb: {
-                delay: 0,
-                decay: 0
+                delays: [],
+                gains: []
             },
             rotation: {
                 rotationHz: 0
@@ -358,23 +366,35 @@ class FilterManager {
     async toggleEcho(delay = 1, decay = 0.5) {
         if (this.player.node.info && !this.player.node.info?.filters?.includes("echo"))
             throw new Error("Node#Info#filters does not include the 'echo' Filter (Node has it not enable aka not installed!)");
-        this.data.echo.delay = this.filters.echo ? 0 : delay;
-        this.data.echo.decay = this.filters.echo ? 0 : decay;
+        if (!this.data)
+            this.data = {};
+        if (!this.data.pluginFilters)
+            this.data.pluginFilters = {};
+        if (!this.data.pluginFilters["lavalink-filter-plugin"])
+            this.data.pluginFilters["lavalink-filter-plugin"] = { echo: { decay: 0, delay: 0 }, reverb: { delays: [], gains: [] } };
+        this.data.pluginFilters["lavalink-filter-plugin"].echo.delay = this.filters.echo ? 0 : delay;
+        this.data.pluginFilters["lavalink-filter-plugin"].echo.decay = this.filters.echo ? 0 : decay;
         this.filters.echo = !this.filters.echo;
         await this.applyPlayerFilters();
         return this.filters.echo;
     }
     /**
      * Enabels / Disables the Echo effect, IMPORTANT! Only works with the correct Lavalink Plugin installed. (Optional: provide your Own Data)
-     * @param delay
-     * @param decay
+     * @param delays
+     * @param gains
      * @returns
      */
-    async toggleReverb(delay = 1, decay = 0.5) {
+    async toggleReverb(delays = [0.037, 0.042, 0.048, 0.053], gains = [0.84, 0.83, 0.82, 0.81]) {
         if (this.player.node.info && !this.player.node.info?.filters?.includes("reverb"))
             throw new Error("Node#Info#filters does not include the 'reverb' Filter (Node has it not enable aka not installed!)");
-        this.data.reverb.delay = this.filters.reverb ? 0 : delay;
-        this.data.reverb.decay = this.filters.reverb ? 0 : decay;
+        if (!this.data)
+            this.data = {};
+        if (!this.data.pluginFilters)
+            this.data.pluginFilters = {};
+        if (!this.data.pluginFilters["lavalink-filter-plugin"])
+            this.data.pluginFilters["lavalink-filter-plugin"] = { echo: { decay: 0, delay: 0 }, reverb: { delays: [], gains: [] } };
+        this.data.pluginFilters["lavalink-filter-plugin"].reverb.delays = this.filters.reverb ? [] : delays;
+        this.data.pluginFilters["lavalink-filter-plugin"].reverb.gains = this.filters.reverb ? [] : gains;
         this.filters.reverb = !this.filters.reverb;
         await this.applyPlayerFilters();
         return this.filters.reverb;

package/dist/cjs/structures/LavalinkManagerStatics.js

@@ -40,7 +40,10 @@ exports.DefaultSources = {
     // speak PLUGIN
     "speak": "speak",
     "tts": "tts",
-    "ftts": "ftts"
+    "ftts": "ftts",
+    // Client sided search platforms
+    "bandcamp": "bcsearch",
+    "bcsearch": "bcsearch",
 };
 exports.LavalinkPlugins = {
     DuncteBot_Plugin: "DuncteBot-plugin",

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

@@ -2,7 +2,7 @@
 import { Dispatcher, Pool } from "undici";
 import { NodeManager } from "./NodeManager";
 import internal from "stream";
-import { InvalidLavalinkRestRequest, LavalinkPlayer, PlayerUpdateInfo, RoutePlanner, Session, Base64 } from "./Utils";
+import { InvalidLavalinkRestRequest, LavalinkPlayer, PlayerUpdateInfo, RoutePlanner, Session, Base64, SearchResult } from "./Utils";
 import { DestroyReasonsType } from "./Player";
 import { Track } from "./Track";
 /** Modifies any outgoing REST requests. */
@@ -135,6 +135,7 @@ export declare class LavalinkNode {
      * @returns The returned data
      */
     request(endpoint: string, modify?: ModifyRequest, parseAsText?: boolean): Promise<unknown>;
+    search(querySourceString: string, requestUser: unknown): Promise<SearchResult>;
     /**
      * Update the Player State on the Lavalink Server
      * @param data

package/dist/cjs/structures/Node.js

@@ -96,6 +96,25 @@ class LavalinkNode {
             throw new Error(`Node Request resulted into an error, request-URL: ${url} | headers: ${JSON.stringify(request.headers)}`);
         return parseAsText ? await request.body.text() : await request.body.json();
     }
+    async search(querySourceString, requestUser) {
+        const res = await this.request(`/loadsearch?query=${encodeURIComponent(decodeURIComponent(querySourceString))}`);
+        // transform the data which can be Error, Track or Track[] to enfore [Track] 
+        const resTracks = res.loadType === "playlist" ? res.data?.tracks : res.loadType === "track" ? [res.data] : res.loadType === "search" ? Array.isArray(res.data) ? res.data : [res.data] : [];
+        return {
+            loadType: res.loadType,
+            exception: res.loadType === "error" ? res.data : null,
+            pluginInfo: res.pluginInfo || {},
+            playlist: res.loadType === "playlist" ? {
+                title: res.data.info?.name || res.data.pluginInfo?.name || null,
+                author: res.data.info?.author || res.data.pluginInfo?.author || null,
+                thumbnail: (res.data.info?.artworkUrl) || (res.data.pluginInfo?.artworkUrl) || ((typeof res.data?.info?.selectedTrack !== "number" || res.data?.info?.selectedTrack === -1) ? null : resTracks[res.data?.info?.selectedTrack] ? (resTracks[res.data?.info?.selectedTrack]?.info?.artworkUrl || resTracks[res.data?.info?.selectedTrack]?.info?.pluginInfo?.artworkUrl) : null) || null,
+                uri: res.data.info?.url || res.data.info?.uri || res.data.info?.link || res.data.pluginInfo?.url || res.data.pluginInfo?.uri || res.data.pluginInfo?.link || null,
+                selectedTrack: typeof res.data?.info?.selectedTrack !== "number" || res.data?.info?.selectedTrack === -1 ? null : resTracks[res.data?.info?.selectedTrack] ? this.NodeManager.LavalinkManager.utils.buildTrack(resTracks[res.data?.info?.selectedTrack], requestUser) : null,
+                duration: resTracks.length ? resTracks.reduce((acc, cur) => acc + (cur?.info?.duration || 0), 0) : 0,
+            } : null,
+            tracks: (resTracks.length ? resTracks.map(t => this.NodeManager.LavalinkManager.utils.buildTrack(t, requestUser)) : [])
+        };
+    }
     /**
      * Update the Player State on the Lavalink Server
      * @param data
@@ -339,12 +358,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") {
@@ -354,8 +373,8 @@ class LavalinkNode {
                     player.filterManager.data.timescale = data.playerOptions.filters.timescale;
                 if (data.playerOptions.filters.distortion)
                     player.filterManager.data.distortion = data.playerOptions.filters.distortion;
-                if (data.playerOptions.filters.echo)
-                    player.filterManager.data.echo = data.playerOptions.filters.echo;
+                if (data.playerOptions.filters.pluginFilters)
+                    player.filterManager.data.pluginFilters = data.playerOptions.filters.pluginFilters;
                 if (data.playerOptions.filters.vibrato)
                     player.filterManager.data.vibrato = data.playerOptions.filters.vibrato;
                 if (data.playerOptions.filters.volume)

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

@@ -142,7 +142,7 @@ export declare class Player {
         query: string;
         source: LavaSrcSearchPlatformBase;
         types?: LavaSearchType[];
-    }, requestUser: unknown): Promise<SearchResult | LavaSearchResponse>;
+    }, requestUser: unknown): Promise<import("./Utils").UnresolvedSearchResult | SearchResult | LavaSearchResponse>;
     /**
      *
      * @param query Query for your data
@@ -151,7 +151,7 @@ export declare class Player {
     search(query: {
         query: string;
         source?: SearchPlatform;
-    } | string, requestUser: unknown): Promise<SearchResult>;
+    } | string, requestUser: unknown): Promise<import("./Utils").UnresolvedSearchResult | SearchResult>;
     /**
      * Pause the player
      */

package/dist/cjs/structures/Player.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Player = exports.DestroyReasons = void 0;
+const BandCampSearch_1 = require("./CustomSearches/BandCampSearch");
 const Filters_1 = require("./Filters");
 const LavalinkManagerStatics_1 = require("./LavalinkManagerStatics");
 const Queue_1 = require("./Queue");
@@ -73,11 +74,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 +158,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 +196,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;
@@ -260,6 +262,9 @@ class Player {
             this.LavalinkManager.utils.validateQueryString(this.node, Query.source);
         else if (Query.source)
             this.LavalinkManager.utils.validateSourceString(this.node, Query.source);
+        if (["bcsearch", "bandcamp"].includes(Query.source)) {
+            return await (0, BandCampSearch_1.bandCampSearch)(this, Query.query, requestUser);
+        }
         // ftts query parameters: ?voice=Olivia&audio_format=ogg_opus&translate=False&silence=1000&speed=1.0 | example raw get query: https://api.flowery.pw/v1/tts?voice=Olivia&audio_format=ogg_opus&translate=False&silence=0&speed=1.0&text=Hello%20World
         // request the data 
         const res = await this.node.request(`/loadtracks?identifier=${!/^https?:\/\//.test(Query.query) ? `${Query.source}:${Query.source === "ftts" ? "//" : ""}` : ""}${encodeURIComponent(Query.query)}`);
@@ -413,16 +418,17 @@ class Player {
         const data = this.toJSON();
         await this.node.destroyPlayer(this.guildId);
         this.node = updateNode;
-        await this.connect();
         const now = performance.now();
         await this.node.updatePlayer({
             guildId: this.guildId,
             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 },
+                voice: this.voice,
+                // track: this.queue.current,
             },
         });
         this.ping.lavalink = Math.round((performance.now() - now) / 10) / 100;

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

@@ -15,8 +15,10 @@ export type FloatNumber = Opaque<number, 'Float'>;
 export type LavaSrcSearchPlatformBase = "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "ymsearch";
 export type LavaSrcSearchPlatform = LavaSrcSearchPlatformBase | "ftts";
 export type DuncteSearchPlatform = "speak" | "tts";
-export type LavalinkSearchPlatform = "ytsearch" | "ytmsearch" | "scsearch" | LavaSrcSearchPlatform | DuncteSearchPlatform;
-export type ClientSearchPlatform = "youtube" | "yt" | "youtube music" | "youtubemusic" | "ytm" | "soundcloud" | "sc" | "am" | "apple music" | "applemusic" | "apple" | "sp" | "spsuggestion" | "spotify" | "dz" | "deezer" | "yandex" | "yandex music" | "yandexmusic";
+export type LavalinkClientSearchPlatform = "bcsearch";
+export type LavalinkClientSearchPlatformResolve = "bandcamp";
+export type LavalinkSearchPlatform = "ytsearch" | "ytmsearch" | "scsearch" | LavaSrcSearchPlatform | DuncteSearchPlatform | LavalinkClientSearchPlatform;
+export type ClientSearchPlatform = "youtube" | "yt" | "youtube music" | "youtubemusic" | "ytm" | "soundcloud" | "sc" | "am" | "apple music" | "applemusic" | "apple" | "sp" | "spsuggestion" | "spotify" | "dz" | "deezer" | "yandex" | "yandex music" | "yandexmusic" | LavalinkClientSearchPlatformResolve | LavalinkClientSearchPlatform;
 export type SearchPlatform = LavalinkSearchPlatform | ClientSearchPlatform;
 export type SourcesRegex = "YoutubeRegex" | "YoutubeMusicRegex" | "SoundCloudRegex" | "SoundCloudMobileRegex" | "DeezerTrackRegex" | "DeezerArtistRegex" | "DeezerEpisodeRegex" | "DeezerMixesRegex" | "DeezerPageLinkRegex" | "DeezerPlaylistRegex" | "DeezerAlbumRegex" | "AllDeezerRegex" | "AllDeezerRegexWithoutPageLink" | "SpotifySongRegex" | "SpotifyPlaylistRegex" | "SpotifyArtistRegex" | "SpotifyEpisodeRegex" | "SpotifyShowRegex" | "SpotifyAlbumRegex" | "AllSpotifyRegex" | "mp3Url" | "m3uUrl" | "m3u8Url" | "mp4Url" | "m4aUrl" | "wavUrl" | "aacpUrl" | "tiktok" | "mixcloud" | "musicYandex" | "radiohost" | "bandcamp" | "appleMusic" | "TwitchTv" | "vimeo";
 export interface PlaylistInfo {
@@ -42,6 +44,13 @@ export interface SearchResult {
     playlist: PlaylistInfo | null;
     tracks: Track[];
 }
+export interface UnresolvedSearchResult {
+    loadType: LoadTypes;
+    exception: Exception | null;
+    pluginInfo: PluginInfo;
+    playlist: PlaylistInfo | null;
+    tracks: UnresolvedTrack[];
+}
 export declare class ManagerUtils {
     LavalinkManager: LavalinkManager | null;
     constructor(LavalinkManager?: LavalinkManager);

package/dist/cjs/structures/Utils.js

@@ -56,7 +56,7 @@ class ManagerUtils {
             info: query.info ? query.info : query.title ? query : undefined,
             requester: typeof this.LavalinkManager?.options?.playerOptions?.requesterTransformer === "function" ? this.LavalinkManager?.options?.playerOptions?.requesterTransformer((query?.requester || requester)) : requester,
             async resolve(player) {
-                const closest = await getClosestTrack(this, player, player.LavalinkManager.utils);
+                const closest = await getClosestTrack(this, player);
                 if (!closest)
                     throw new SyntaxError("No closest Track found");
                 Object.getOwnPropertyNames(this).forEach(prop => delete this[prop]);
@@ -148,7 +148,7 @@ class ManagerUtils {
         return typeof data === "object" && !("info" in data) && typeof data.title === "string";
     }
     async getClosestTrack(data, player) {
-        return getClosestTrack(data, player, this);
+        return getClosestTrack(data, player);
     }
     validateQueryString(node, queryString) {
         if (!node.info)
@@ -315,12 +315,12 @@ async function applyUnresolvedData(resTrack, data, utils) {
             resTrack.info[key] = data.info[key]; // add non-existing values
     return resTrack;
 }
-async function getClosestTrack(data, player, utils) {
+async function getClosestTrack(data, player) {
     if (!player || !player.node)
         throw new RangeError("No player with a lavalink node was provided");
-    if (utils.isTrack(data))
-        return utils.buildTrack(data, data.requester);
-    if (!utils.isUnresolvedTrack(data))
+    if (player.LavalinkManager.utils.isTrack(data))
+        return player.LavalinkManager.utils.buildTrack(data, data.requester);
+    if (!player.LavalinkManager.utils.isUnresolvedTrack(data))
         throw new RangeError("Track is not an unresolved Track");
     if (!data?.info?.title && typeof data.encoded !== "string" && !data.info.uri)
         throw new SyntaxError("the track uri / title / encoded Base64 string is required for unresolved tracks");
@@ -330,31 +330,31 @@ async function getClosestTrack(data, player, utils) {
     if (typeof data.encoded === "string") {
         const r = await player.node.decode.singleTrack(data.encoded, data.requester);
         if (r)
-            return applyUnresolvedData(r, data, utils);
+            return applyUnresolvedData(r, data, player.LavalinkManager.utils);
     }
     // try to fetch the track via a uri if possible
     if (typeof data.info.uri === "string") {
-        const r = await player.search({ query: data?.info?.uri }, data.requester).then(v => v.tracks[0]);
+        const r = await player.search({ query: data?.info?.uri }, data.requester).then(v => v.tracks?.[0]);
         if (r)
-            return applyUnresolvedData(r, data, utils);
+            return applyUnresolvedData(r, data, player.LavalinkManager.utils);
     }
     // search the track as closely as possible
     const query = [data.info?.title, data.info?.author].filter(str => !!str).join(" by ");
     const sourceName = data.info?.sourceName;
     return await player.search({
-        query, source: sourceName !== "bandcamp" && sourceName !== "twitch" && sourceName !== "flowery-tts" ? sourceName : player.LavalinkManager.options?.playerOptions?.defaultSearchPlatform,
-    }, data.requester).then(res => {
+        query, source: sourceName !== "twitch" && sourceName !== "flowery-tts" ? sourceName : player.LavalinkManager.options?.playerOptions?.defaultSearchPlatform,
+    }, data.requester).then((res) => {
         let trackToUse = null;
         // try to find via author name
         if (data.info.author && !trackToUse)
-            trackToUse = res.tracks.find(track => [data.info.author, `${data.info.author} - Topic`].some(name => new RegExp(`^${escapeRegExp(name)}$`, "i").test(track.info.author)) || new RegExp(`^${escapeRegExp(data.info.title)}$`, "i").test(track.info.title));
+            trackToUse = res.tracks.find(track => [data.info?.author || "", `${data.info?.author} - Topic`].some(name => new RegExp(`^${escapeRegExp(name)}$`, "i").test(track.info?.author)) || new RegExp(`^${escapeRegExp(data.info?.title)}$`, "i").test(track.info?.title));
         // try to find via duration
         if (data.info.duration && !trackToUse)
-            trackToUse = res.tracks.find(track => (track.info.duration >= (data.info.duration - 1500)) && (track.info.duration <= (data.info.duration + 1500)));
+            trackToUse = res.tracks.find(track => (track.info?.duration >= (data.info?.duration - 1500)) && (track?.info.duration <= (data.info?.duration + 1500)));
         // try to find via isrc
         if (data.info.isrc && !trackToUse)
-            trackToUse = res.tracks.find(track => track.info.isrc === data.info.isrc);
+            trackToUse = res.tracks.find(track => track.info?.isrc === data.info?.isrc);
         // apply unresolved data and return the track
-        return applyUnresolvedData(trackToUse || res.tracks[0], data, utils);
+        return applyUnresolvedData(trackToUse || res.tracks[0], data, player.LavalinkManager.utils);
     });
 }

package/dist/esm/structures/CustomSearches/BandCampSearch.d.ts

@@ -0,0 +1,3 @@
+import { Player } from "../Player";
+import { UnresolvedSearchResult } from "../Utils";
+export declare const bandCampSearch: (player: Player, query: string, requestUser: unknown) => Promise<UnresolvedSearchResult>;

package/dist/esm/structures/CustomSearches/BandCampSearch.js

@@ -0,0 +1,32 @@
+import { fetch } from "undici";
+import { request } from "http";
+export const bandCampSearch = async (player, query, requestUser) => {
+    let error = null;
+    let tracks = [];
+    try {
+        const data = await fetch(`https://bandcamp.com/api/nusearch/2/autocomplete?q=${encodeURIComponent(query)}`, {
+            headers: {
+                'User-Agent': 'android-async-http/1.4.1 (http://loopj.com/android-async-http)',
+                'Cookie': '$Version=1'
+            }
+        });
+        const json = await data.json();
+        tracks = json?.results?.filter(x => !!x && typeof x === "object" && "type" in x && x.type === "t").map?.(item => player.LavalinkManager.utils.buildUnresolvedTrack({
+            uri: item.url || item.uri,
+            artworkUrl: item.img,
+            author: item.band_name,
+            title: item.name,
+            identifier: item.id ? `${item.id}` : item.url?.split("/").reverse()[0],
+        }, request));
+    }
+    catch (e) {
+        error = e;
+    }
+    return {
+        loadType: "search",
+        exception: error,
+        pluginInfo: {},
+        playlist: null,
+        tracks: tracks
+    };
+};

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

@@ -95,11 +95,11 @@ export declare class FilterManager {
     toggleEcho(delay?: number, decay?: number): Promise<boolean>;
     /**
      * Enabels / Disables the Echo effect, IMPORTANT! Only works with the correct Lavalink Plugin installed. (Optional: provide your Own Data)
-     * @param delay
-     * @param decay
+     * @param delays
+     * @param gains
      * @returns
      */
-    toggleReverb(delay?: number, decay?: number): Promise<boolean>;
+    toggleReverb(delays?: number[], gains?: number[]): Promise<boolean>;
     /**
      * Enables / Disabels a Nightcore-like filter Effect. Disables/Overwrides both: custom and Vaporwave Filter
      * @param speed
@@ -276,8 +276,8 @@ export interface EchoFilter {
  * A Plugin Filter
  */
 export interface ReverbFilter {
-    delay: number;
-    decay: number;
+    delays: number[];
+    gains: number[];
 }
 /**
  * Filter Data stored in the Client and partially sent to Lavalink
@@ -292,6 +292,13 @@ export interface FilterData {
     distortion?: DistortionFilter;
     channelMix?: ChannelMixFilter;
     lowPass?: LowPassFilter;
+    pluginFilters?: Record<PluginFiltersKey, PluginFiltersValues>;
+}
+export type PluginFiltersKey = "lavalink-filter-plugin" | string;
+export interface PluginFiltersValues extends LavalinkFiltersPlugin {
+    [key: string]: any;
+}
+export interface LavalinkFiltersPlugin {
     echo: EchoFilter;
     reverb: ReverbFilter;
 }

package/dist/esm/structures/Filters.js

@@ -37,14 +37,6 @@ export class FilterManager {
             pitch: 1,
             rate: 1 // 0 = x
         },
-        echo: {
-            delay: 0,
-            decay: 0
-        },
-        reverb: {
-            delay: 0,
-            decay: 0
-        },
         rotation: {
             rotationHz: 0
         },
@@ -56,6 +48,18 @@ export class FilterManager {
             frequency: 0,
             depth: 0 // 0 < x = 1
         },
+        pluginFilters: {
+        /*"lavalink-filter-plugin": {
+            echo: {
+                delay: 0,
+                decay: 0
+            },
+            reverb: {
+                delays: [0.037, 0.042, 0.048, 0.053],
+                gains: [0.84, 0.83, 0.82, 0.81]
+            }
+        }*/
+        },
         channelMix: audioOutputsData.stereo,
         /*distortion: {
             sinOffset: 0,
@@ -80,24 +84,27 @@ export class FilterManager {
      */
     async applyPlayerFilters() {
         const sendData = { ...this.data };
+        this.checkFiltersState();
         if (!this.filters.volume)
             delete sendData.volume;
         if (!this.filters.tremolo)
             delete sendData.tremolo;
         if (!this.filters.vibrato)
             delete sendData.vibrato;
-        //if(!this.filters.karaoke) delete sendData.karaoke;
         if (!this.filters.echo)
-            delete sendData.echo;
+            delete sendData.pluginFilters?.["lavalink-filter-plugin"]?.echo;
         if (!this.filters.reverb)
-            delete sendData.reverb;
+            delete sendData.pluginFilters?.["lavalink-filter-plugin"]?.reverb;
         if (!this.filters.lowPass)
             delete sendData.lowPass;
         if (!this.filters.karaoke)
             delete sendData.karaoke;
-        //if(!this.filters.rotating) delete sendData.rotating;
+        if (!this.filters.rotation)
+            delete sendData.rotation;
         if (this.filters.audioOutput === "stereo")
             delete sendData.channelMix;
+        if (Object.values(this.data.timescale).every(v => v === 1))
+            delete sendData.timescale;
         if (!this.player.node.sessionId)
             throw new Error("The Lavalink-Node is either not ready or not up to date");
         sendData.equalizer = [...this.equalizerBands];
@@ -127,8 +134,9 @@ export class FilterManager {
         this.filters.rotation = this.data.rotation.rotationHz !== 0;
         this.filters.vibrato = this.data.vibrato.frequency !== 0 || this.data.vibrato.depth !== 0;
         this.filters.tremolo = this.data.tremolo.frequency !== 0 || this.data.tremolo.depth !== 0;
-        this.filters.echo = this.data.echo.decay !== 0 || this.data.echo.delay !== 0;
-        this.filters.reverb = this.data.reverb.decay !== 0 || this.data.reverb.delay !== 0;
+        const lavalinkFilterData = (this.data.pluginFilters?.["lavalink-filter-plugin"] || { echo: { decay: 0, delay: 0 }, reverb: { gains: [], delays: [] } });
+        this.filters.echo = lavalinkFilterData.echo.decay !== 0 || lavalinkFilterData.echo.delay !== 0;
+        this.filters.reverb = lavalinkFilterData.reverb?.delays?.length !== 0 || lavalinkFilterData.reverb?.gains?.length !== 0;
         this.filters.lowPass = this.data.lowPass.smoothing !== 0;
         this.filters.karaoke = Object.values(this.data.karaoke).some(v => v !== 0);
         if ((this.filters.nightcore || this.filters.vaporwave) && oldFilterTimescale) {
@@ -177,8 +185,8 @@ export class FilterManager {
                 decay: 0
             },
             reverb: {
-                delay: 0,
-                decay: 0
+                delays: [],
+                gains: []
             },
             rotation: {
                 rotationHz: 0
@@ -355,23 +363,35 @@ export class FilterManager {
     async toggleEcho(delay = 1, decay = 0.5) {
         if (this.player.node.info && !this.player.node.info?.filters?.includes("echo"))
             throw new Error("Node#Info#filters does not include the 'echo' Filter (Node has it not enable aka not installed!)");
-        this.data.echo.delay = this.filters.echo ? 0 : delay;
-        this.data.echo.decay = this.filters.echo ? 0 : decay;
+        if (!this.data)
+            this.data = {};
+        if (!this.data.pluginFilters)
+            this.data.pluginFilters = {};
+        if (!this.data.pluginFilters["lavalink-filter-plugin"])
+            this.data.pluginFilters["lavalink-filter-plugin"] = { echo: { decay: 0, delay: 0 }, reverb: { delays: [], gains: [] } };
+        this.data.pluginFilters["lavalink-filter-plugin"].echo.delay = this.filters.echo ? 0 : delay;
+        this.data.pluginFilters["lavalink-filter-plugin"].echo.decay = this.filters.echo ? 0 : decay;
         this.filters.echo = !this.filters.echo;
         await this.applyPlayerFilters();
         return this.filters.echo;
     }
     /**
      * Enabels / Disables the Echo effect, IMPORTANT! Only works with the correct Lavalink Plugin installed. (Optional: provide your Own Data)
-     * @param delay
-     * @param decay
+     * @param delays
+     * @param gains
      * @returns
      */
-    async toggleReverb(delay = 1, decay = 0.5) {
+    async toggleReverb(delays = [0.037, 0.042, 0.048, 0.053], gains = [0.84, 0.83, 0.82, 0.81]) {
         if (this.player.node.info && !this.player.node.info?.filters?.includes("reverb"))
             throw new Error("Node#Info#filters does not include the 'reverb' Filter (Node has it not enable aka not installed!)");
-        this.data.reverb.delay = this.filters.reverb ? 0 : delay;
-        this.data.reverb.decay = this.filters.reverb ? 0 : decay;
+        if (!this.data)
+            this.data = {};
+        if (!this.data.pluginFilters)
+            this.data.pluginFilters = {};
+        if (!this.data.pluginFilters["lavalink-filter-plugin"])
+            this.data.pluginFilters["lavalink-filter-plugin"] = { echo: { decay: 0, delay: 0 }, reverb: { delays: [], gains: [] } };
+        this.data.pluginFilters["lavalink-filter-plugin"].reverb.delays = this.filters.reverb ? [] : delays;
+        this.data.pluginFilters["lavalink-filter-plugin"].reverb.gains = this.filters.reverb ? [] : gains;
         this.filters.reverb = !this.filters.reverb;
         await this.applyPlayerFilters();
         return this.filters.reverb;

package/dist/esm/structures/LavalinkManagerStatics.js

@@ -37,7 +37,10 @@ export const DefaultSources = {
     // speak PLUGIN
     "speak": "speak",
     "tts": "tts",
-    "ftts": "ftts"
+    "ftts": "ftts",
+    // Client sided search platforms
+    "bandcamp": "bcsearch",
+    "bcsearch": "bcsearch",
 };
 export const LavalinkPlugins = {
     DuncteBot_Plugin: "DuncteBot-plugin",

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

@@ -2,7 +2,7 @@
 import { Dispatcher, Pool } from "undici";
 import { NodeManager } from "./NodeManager";
 import internal from "stream";
-import { InvalidLavalinkRestRequest, LavalinkPlayer, PlayerUpdateInfo, RoutePlanner, Session, Base64 } from "./Utils";
+import { InvalidLavalinkRestRequest, LavalinkPlayer, PlayerUpdateInfo, RoutePlanner, Session, Base64, SearchResult } from "./Utils";
 import { DestroyReasonsType } from "./Player";
 import { Track } from "./Track";
 /** Modifies any outgoing REST requests. */
@@ -135,6 +135,7 @@ export declare class LavalinkNode {
      * @returns The returned data
      */
     request(endpoint: string, modify?: ModifyRequest, parseAsText?: boolean): Promise<unknown>;
+    search(querySourceString: string, requestUser: unknown): Promise<SearchResult>;
     /**
      * Update the Player State on the Lavalink Server
      * @param data

package/dist/esm/structures/Node.js

@@ -92,6 +92,25 @@ export class LavalinkNode {
             throw new Error(`Node Request resulted into an error, request-URL: ${url} | headers: ${JSON.stringify(request.headers)}`);
         return parseAsText ? await request.body.text() : await request.body.json();
     }
+    async search(querySourceString, requestUser) {
+        const res = await this.request(`/loadsearch?query=${encodeURIComponent(decodeURIComponent(querySourceString))}`);
+        // transform the data which can be Error, Track or Track[] to enfore [Track] 
+        const resTracks = res.loadType === "playlist" ? res.data?.tracks : res.loadType === "track" ? [res.data] : res.loadType === "search" ? Array.isArray(res.data) ? res.data : [res.data] : [];
+        return {
+            loadType: res.loadType,
+            exception: res.loadType === "error" ? res.data : null,
+            pluginInfo: res.pluginInfo || {},
+            playlist: res.loadType === "playlist" ? {
+                title: res.data.info?.name || res.data.pluginInfo?.name || null,
+                author: res.data.info?.author || res.data.pluginInfo?.author || null,
+                thumbnail: (res.data.info?.artworkUrl) || (res.data.pluginInfo?.artworkUrl) || ((typeof res.data?.info?.selectedTrack !== "number" || res.data?.info?.selectedTrack === -1) ? null : resTracks[res.data?.info?.selectedTrack] ? (resTracks[res.data?.info?.selectedTrack]?.info?.artworkUrl || resTracks[res.data?.info?.selectedTrack]?.info?.pluginInfo?.artworkUrl) : null) || null,
+                uri: res.data.info?.url || res.data.info?.uri || res.data.info?.link || res.data.pluginInfo?.url || res.data.pluginInfo?.uri || res.data.pluginInfo?.link || null,
+                selectedTrack: typeof res.data?.info?.selectedTrack !== "number" || res.data?.info?.selectedTrack === -1 ? null : resTracks[res.data?.info?.selectedTrack] ? this.NodeManager.LavalinkManager.utils.buildTrack(resTracks[res.data?.info?.selectedTrack], requestUser) : null,
+                duration: resTracks.length ? resTracks.reduce((acc, cur) => acc + (cur?.info?.duration || 0), 0) : 0,
+            } : null,
+            tracks: (resTracks.length ? resTracks.map(t => this.NodeManager.LavalinkManager.utils.buildTrack(t, requestUser)) : [])
+        };
+    }
     /**
      * Update the Player State on the Lavalink Server
      * @param data
@@ -335,12 +354,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") {
@@ -350,8 +369,8 @@ export class LavalinkNode {
                     player.filterManager.data.timescale = data.playerOptions.filters.timescale;
                 if (data.playerOptions.filters.distortion)
                     player.filterManager.data.distortion = data.playerOptions.filters.distortion;
-                if (data.playerOptions.filters.echo)
-                    player.filterManager.data.echo = data.playerOptions.filters.echo;
+                if (data.playerOptions.filters.pluginFilters)
+                    player.filterManager.data.pluginFilters = data.playerOptions.filters.pluginFilters;
                 if (data.playerOptions.filters.vibrato)
                     player.filterManager.data.vibrato = data.playerOptions.filters.vibrato;
                 if (data.playerOptions.filters.volume)

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

@@ -142,7 +142,7 @@ export declare class Player {
         query: string;
         source: LavaSrcSearchPlatformBase;
         types?: LavaSearchType[];
-    }, requestUser: unknown): Promise<SearchResult | LavaSearchResponse>;
+    }, requestUser: unknown): Promise<import("./Utils").UnresolvedSearchResult | SearchResult | LavaSearchResponse>;
     /**
      *
      * @param query Query for your data
@@ -151,7 +151,7 @@ export declare class Player {
     search(query: {
         query: string;
         source?: SearchPlatform;
-    } | string, requestUser: unknown): Promise<SearchResult>;
+    } | string, requestUser: unknown): Promise<import("./Utils").UnresolvedSearchResult | SearchResult>;
     /**
      * Pause the player
      */

package/dist/esm/structures/Player.js

@@ -1,3 +1,4 @@
+import { bandCampSearch } from "./CustomSearches/BandCampSearch";
 import { FilterManager } from "./Filters";
 import { DefaultSources } from "./LavalinkManagerStatics";
 import { Queue, QueueSaver } from "./Queue";
@@ -70,11 +71,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 +155,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 +193,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;
@@ -257,6 +259,9 @@ export class Player {
             this.LavalinkManager.utils.validateQueryString(this.node, Query.source);
         else if (Query.source)
             this.LavalinkManager.utils.validateSourceString(this.node, Query.source);
+        if (["bcsearch", "bandcamp"].includes(Query.source)) {
+            return await bandCampSearch(this, Query.query, requestUser);
+        }
         // ftts query parameters: ?voice=Olivia&audio_format=ogg_opus&translate=False&silence=1000&speed=1.0 | example raw get query: https://api.flowery.pw/v1/tts?voice=Olivia&audio_format=ogg_opus&translate=False&silence=0&speed=1.0&text=Hello%20World
         // request the data 
         const res = await this.node.request(`/loadtracks?identifier=${!/^https?:\/\//.test(Query.query) ? `${Query.source}:${Query.source === "ftts" ? "//" : ""}` : ""}${encodeURIComponent(Query.query)}`);
@@ -410,16 +415,17 @@ export class Player {
         const data = this.toJSON();
         await this.node.destroyPlayer(this.guildId);
         this.node = updateNode;
-        await this.connect();
         const now = performance.now();
         await this.node.updatePlayer({
             guildId: this.guildId,
             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 },
+                voice: this.voice,
+                // track: this.queue.current,
             },
         });
         this.ping.lavalink = Math.round((performance.now() - now) / 10) / 100;

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

@@ -15,8 +15,10 @@ export type FloatNumber = Opaque<number, 'Float'>;
 export type LavaSrcSearchPlatformBase = "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "ymsearch";
 export type LavaSrcSearchPlatform = LavaSrcSearchPlatformBase | "ftts";
 export type DuncteSearchPlatform = "speak" | "tts";
-export type LavalinkSearchPlatform = "ytsearch" | "ytmsearch" | "scsearch" | LavaSrcSearchPlatform | DuncteSearchPlatform;
-export type ClientSearchPlatform = "youtube" | "yt" | "youtube music" | "youtubemusic" | "ytm" | "soundcloud" | "sc" | "am" | "apple music" | "applemusic" | "apple" | "sp" | "spsuggestion" | "spotify" | "dz" | "deezer" | "yandex" | "yandex music" | "yandexmusic";
+export type LavalinkClientSearchPlatform = "bcsearch";
+export type LavalinkClientSearchPlatformResolve = "bandcamp";
+export type LavalinkSearchPlatform = "ytsearch" | "ytmsearch" | "scsearch" | LavaSrcSearchPlatform | DuncteSearchPlatform | LavalinkClientSearchPlatform;
+export type ClientSearchPlatform = "youtube" | "yt" | "youtube music" | "youtubemusic" | "ytm" | "soundcloud" | "sc" | "am" | "apple music" | "applemusic" | "apple" | "sp" | "spsuggestion" | "spotify" | "dz" | "deezer" | "yandex" | "yandex music" | "yandexmusic" | LavalinkClientSearchPlatformResolve | LavalinkClientSearchPlatform;
 export type SearchPlatform = LavalinkSearchPlatform | ClientSearchPlatform;
 export type SourcesRegex = "YoutubeRegex" | "YoutubeMusicRegex" | "SoundCloudRegex" | "SoundCloudMobileRegex" | "DeezerTrackRegex" | "DeezerArtistRegex" | "DeezerEpisodeRegex" | "DeezerMixesRegex" | "DeezerPageLinkRegex" | "DeezerPlaylistRegex" | "DeezerAlbumRegex" | "AllDeezerRegex" | "AllDeezerRegexWithoutPageLink" | "SpotifySongRegex" | "SpotifyPlaylistRegex" | "SpotifyArtistRegex" | "SpotifyEpisodeRegex" | "SpotifyShowRegex" | "SpotifyAlbumRegex" | "AllSpotifyRegex" | "mp3Url" | "m3uUrl" | "m3u8Url" | "mp4Url" | "m4aUrl" | "wavUrl" | "aacpUrl" | "tiktok" | "mixcloud" | "musicYandex" | "radiohost" | "bandcamp" | "appleMusic" | "TwitchTv" | "vimeo";
 export interface PlaylistInfo {
@@ -42,6 +44,13 @@ export interface SearchResult {
     playlist: PlaylistInfo | null;
     tracks: Track[];
 }
+export interface UnresolvedSearchResult {
+    loadType: LoadTypes;
+    exception: Exception | null;
+    pluginInfo: PluginInfo;
+    playlist: PlaylistInfo | null;
+    tracks: UnresolvedTrack[];
+}
 export declare class ManagerUtils {
     LavalinkManager: LavalinkManager | null;
     constructor(LavalinkManager?: LavalinkManager);

package/dist/esm/structures/Utils.js

@@ -53,7 +53,7 @@ export class ManagerUtils {
             info: query.info ? query.info : query.title ? query : undefined,
             requester: typeof this.LavalinkManager?.options?.playerOptions?.requesterTransformer === "function" ? this.LavalinkManager?.options?.playerOptions?.requesterTransformer((query?.requester || requester)) : requester,
             async resolve(player) {
-                const closest = await getClosestTrack(this, player, player.LavalinkManager.utils);
+                const closest = await getClosestTrack(this, player);
                 if (!closest)
                     throw new SyntaxError("No closest Track found");
                 Object.getOwnPropertyNames(this).forEach(prop => delete this[prop]);
@@ -145,7 +145,7 @@ export class ManagerUtils {
         return typeof data === "object" && !("info" in data) && typeof data.title === "string";
     }
     async getClosestTrack(data, player) {
-        return getClosestTrack(data, player, this);
+        return getClosestTrack(data, player);
     }
     validateQueryString(node, queryString) {
         if (!node.info)
@@ -309,12 +309,12 @@ async function applyUnresolvedData(resTrack, data, utils) {
             resTrack.info[key] = data.info[key]; // add non-existing values
     return resTrack;
 }
-async function getClosestTrack(data, player, utils) {
+async function getClosestTrack(data, player) {
     if (!player || !player.node)
         throw new RangeError("No player with a lavalink node was provided");
-    if (utils.isTrack(data))
-        return utils.buildTrack(data, data.requester);
-    if (!utils.isUnresolvedTrack(data))
+    if (player.LavalinkManager.utils.isTrack(data))
+        return player.LavalinkManager.utils.buildTrack(data, data.requester);
+    if (!player.LavalinkManager.utils.isUnresolvedTrack(data))
         throw new RangeError("Track is not an unresolved Track");
     if (!data?.info?.title && typeof data.encoded !== "string" && !data.info.uri)
         throw new SyntaxError("the track uri / title / encoded Base64 string is required for unresolved tracks");
@@ -324,31 +324,31 @@ async function getClosestTrack(data, player, utils) {
     if (typeof data.encoded === "string") {
         const r = await player.node.decode.singleTrack(data.encoded, data.requester);
         if (r)
-            return applyUnresolvedData(r, data, utils);
+            return applyUnresolvedData(r, data, player.LavalinkManager.utils);
     }
     // try to fetch the track via a uri if possible
     if (typeof data.info.uri === "string") {
-        const r = await player.search({ query: data?.info?.uri }, data.requester).then(v => v.tracks[0]);
+        const r = await player.search({ query: data?.info?.uri }, data.requester).then(v => v.tracks?.[0]);
         if (r)
-            return applyUnresolvedData(r, data, utils);
+            return applyUnresolvedData(r, data, player.LavalinkManager.utils);
     }
     // search the track as closely as possible
     const query = [data.info?.title, data.info?.author].filter(str => !!str).join(" by ");
     const sourceName = data.info?.sourceName;
     return await player.search({
-        query, source: sourceName !== "bandcamp" && sourceName !== "twitch" && sourceName !== "flowery-tts" ? sourceName : player.LavalinkManager.options?.playerOptions?.defaultSearchPlatform,
-    }, data.requester).then(res => {
+        query, source: sourceName !== "twitch" && sourceName !== "flowery-tts" ? sourceName : player.LavalinkManager.options?.playerOptions?.defaultSearchPlatform,
+    }, data.requester).then((res) => {
         let trackToUse = null;
         // try to find via author name
         if (data.info.author && !trackToUse)
-            trackToUse = res.tracks.find(track => [data.info.author, `${data.info.author} - Topic`].some(name => new RegExp(`^${escapeRegExp(name)}$`, "i").test(track.info.author)) || new RegExp(`^${escapeRegExp(data.info.title)}$`, "i").test(track.info.title));
+            trackToUse = res.tracks.find(track => [data.info?.author || "", `${data.info?.author} - Topic`].some(name => new RegExp(`^${escapeRegExp(name)}$`, "i").test(track.info?.author)) || new RegExp(`^${escapeRegExp(data.info?.title)}$`, "i").test(track.info?.title));
         // try to find via duration
         if (data.info.duration && !trackToUse)
-            trackToUse = res.tracks.find(track => (track.info.duration >= (data.info.duration - 1500)) && (track.info.duration <= (data.info.duration + 1500)));
+            trackToUse = res.tracks.find(track => (track.info?.duration >= (data.info?.duration - 1500)) && (track?.info.duration <= (data.info?.duration + 1500)));
         // try to find via isrc
         if (data.info.isrc && !trackToUse)
-            trackToUse = res.tracks.find(track => track.info.isrc === data.info.isrc);
+            trackToUse = res.tracks.find(track => track.info?.isrc === data.info?.isrc);
         // apply unresolved data and return the track
-        return applyUnresolvedData(trackToUse || res.tracks[0], data, utils);
+        return applyUnresolvedData(trackToUse || res.tracks[0], data, player.LavalinkManager.utils);
     });
 }

package/dist/types/structures/CustomSearches/BandCampSearch.d.ts

@@ -0,0 +1,3 @@
+import { Player } from "../Player";
+import { UnresolvedSearchResult } from "../Utils";
+export declare const bandCampSearch: (player: Player, query: string, requestUser: unknown) => Promise<UnresolvedSearchResult>;

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

@@ -95,11 +95,11 @@ export declare class FilterManager {
     toggleEcho(delay?: number, decay?: number): Promise<boolean>;
     /**
      * Enabels / Disables the Echo effect, IMPORTANT! Only works with the correct Lavalink Plugin installed. (Optional: provide your Own Data)
-     * @param delay
-     * @param decay
+     * @param delays
+     * @param gains
      * @returns
      */
-    toggleReverb(delay?: number, decay?: number): Promise<boolean>;
+    toggleReverb(delays?: number[], gains?: number[]): Promise<boolean>;
     /**
      * Enables / Disabels a Nightcore-like filter Effect. Disables/Overwrides both: custom and Vaporwave Filter
      * @param speed
@@ -276,8 +276,8 @@ export interface EchoFilter {
  * A Plugin Filter
  */
 export interface ReverbFilter {
-    delay: number;
-    decay: number;
+    delays: number[];
+    gains: number[];
 }
 /**
  * Filter Data stored in the Client and partially sent to Lavalink
@@ -292,6 +292,13 @@ export interface FilterData {
     distortion?: DistortionFilter;
     channelMix?: ChannelMixFilter;
     lowPass?: LowPassFilter;
+    pluginFilters?: Record<PluginFiltersKey, PluginFiltersValues>;
+}
+export type PluginFiltersKey = "lavalink-filter-plugin" | string;
+export interface PluginFiltersValues extends LavalinkFiltersPlugin {
+    [key: string]: any;
+}
+export interface LavalinkFiltersPlugin {
     echo: EchoFilter;
     reverb: ReverbFilter;
 }

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

@@ -2,7 +2,7 @@
 import { Dispatcher, Pool } from "undici";
 import { NodeManager } from "./NodeManager";
 import internal from "stream";
-import { InvalidLavalinkRestRequest, LavalinkPlayer, PlayerUpdateInfo, RoutePlanner, Session, Base64 } from "./Utils";
+import { InvalidLavalinkRestRequest, LavalinkPlayer, PlayerUpdateInfo, RoutePlanner, Session, Base64, SearchResult } from "./Utils";
 import { DestroyReasonsType } from "./Player";
 import { Track } from "./Track";
 /** Modifies any outgoing REST requests. */
@@ -135,6 +135,7 @@ export declare class LavalinkNode {
      * @returns The returned data
      */
     request(endpoint: string, modify?: ModifyRequest, parseAsText?: boolean): Promise<unknown>;
+    search(querySourceString: string, requestUser: unknown): Promise<SearchResult>;
     /**
      * Update the Player State on the Lavalink Server
      * @param data

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

@@ -142,7 +142,7 @@ export declare class Player {
         query: string;
         source: LavaSrcSearchPlatformBase;
         types?: LavaSearchType[];
-    }, requestUser: unknown): Promise<SearchResult | LavaSearchResponse>;
+    }, requestUser: unknown): Promise<import("./Utils").UnresolvedSearchResult | SearchResult | LavaSearchResponse>;
     /**
      *
      * @param query Query for your data
@@ -151,7 +151,7 @@ export declare class Player {
     search(query: {
         query: string;
         source?: SearchPlatform;
-    } | string, requestUser: unknown): Promise<SearchResult>;
+    } | string, requestUser: unknown): Promise<import("./Utils").UnresolvedSearchResult | SearchResult>;
     /**
      * Pause the player
      */

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

@@ -15,8 +15,10 @@ export type FloatNumber = Opaque<number, 'Float'>;
 export type LavaSrcSearchPlatformBase = "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "ymsearch";
 export type LavaSrcSearchPlatform = LavaSrcSearchPlatformBase | "ftts";
 export type DuncteSearchPlatform = "speak" | "tts";
-export type LavalinkSearchPlatform = "ytsearch" | "ytmsearch" | "scsearch" | LavaSrcSearchPlatform | DuncteSearchPlatform;
-export type ClientSearchPlatform = "youtube" | "yt" | "youtube music" | "youtubemusic" | "ytm" | "soundcloud" | "sc" | "am" | "apple music" | "applemusic" | "apple" | "sp" | "spsuggestion" | "spotify" | "dz" | "deezer" | "yandex" | "yandex music" | "yandexmusic";
+export type LavalinkClientSearchPlatform = "bcsearch";
+export type LavalinkClientSearchPlatformResolve = "bandcamp";
+export type LavalinkSearchPlatform = "ytsearch" | "ytmsearch" | "scsearch" | LavaSrcSearchPlatform | DuncteSearchPlatform | LavalinkClientSearchPlatform;
+export type ClientSearchPlatform = "youtube" | "yt" | "youtube music" | "youtubemusic" | "ytm" | "soundcloud" | "sc" | "am" | "apple music" | "applemusic" | "apple" | "sp" | "spsuggestion" | "spotify" | "dz" | "deezer" | "yandex" | "yandex music" | "yandexmusic" | LavalinkClientSearchPlatformResolve | LavalinkClientSearchPlatform;
 export type SearchPlatform = LavalinkSearchPlatform | ClientSearchPlatform;
 export type SourcesRegex = "YoutubeRegex" | "YoutubeMusicRegex" | "SoundCloudRegex" | "SoundCloudMobileRegex" | "DeezerTrackRegex" | "DeezerArtistRegex" | "DeezerEpisodeRegex" | "DeezerMixesRegex" | "DeezerPageLinkRegex" | "DeezerPlaylistRegex" | "DeezerAlbumRegex" | "AllDeezerRegex" | "AllDeezerRegexWithoutPageLink" | "SpotifySongRegex" | "SpotifyPlaylistRegex" | "SpotifyArtistRegex" | "SpotifyEpisodeRegex" | "SpotifyShowRegex" | "SpotifyAlbumRegex" | "AllSpotifyRegex" | "mp3Url" | "m3uUrl" | "m3u8Url" | "mp4Url" | "m4aUrl" | "wavUrl" | "aacpUrl" | "tiktok" | "mixcloud" | "musicYandex" | "radiohost" | "bandcamp" | "appleMusic" | "TwitchTv" | "vimeo";
 export interface PlaylistInfo {
@@ -42,6 +44,13 @@ export interface SearchResult {
     playlist: PlaylistInfo | null;
     tracks: Track[];
 }
+export interface UnresolvedSearchResult {
+    loadType: LoadTypes;
+    exception: Exception | null;
+    pluginInfo: PluginInfo;
+    playlist: PlaylistInfo | null;
+    tracks: UnresolvedTrack[];
+}
 export declare class ManagerUtils {
     LavalinkManager: LavalinkManager | null;
     constructor(LavalinkManager?: LavalinkManager);

package/package.json

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