lavalink-client 2.4.6 → 2.5.0

package/README.md

@@ -819,3 +819,27 @@ if(previousTrack) {
   - remove structuredClone so that it works in bun more stable
   - Player Options Validation also allows single property objects
   - Some typos were fixed
+
+
+
+## **Version 2.5.0**
+- Deps got updated
+- Handling of parsing url got updated to use the URL object
+- Flowerytts requests needs to be changed now:
+
+```js
+const query = "Hello World How are you?";
+const voice = "Ava";
+const speed = "1.0";
+
+const fttsParams = new URLSearchParams();
+if(voice) fttsParams.append("voice", voice);
+if(speed) fttsParams.append("speed", speed);
+
+const response = await player.search({
+    // For flowerytts you need to send a URL
+    // and if you want to add optiojns, this is how you add the params to the query..
+    query: `${encodeURI(query)}${fttsParams.size ? `?${fttsParams.toString()}` : ""}`,
+    source: "ftts"
+}, interaction.user);
+```

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

@@ -8,7 +8,9 @@ const bandCampSearch = async (player, query, requestUser) => {
         console.log(`Lavalink-Client-Debug | SEARCHING | - ${query} on lavalink-client`);
     player.LavalinkManager.utils.validateQueryString(player.node, query);
     try {
-        const data = await fetch(`https://bandcamp.com/api/nusearch/2/autocomplete?q=${encodeURIComponent(query)}`, {
+        const requestUrl = new URL("https://bandcamp.com/api/nusearch/2/autocomplete");
+        requestUrl.searchParams.append("q", query);
+        const data = await fetch(requestUrl.toString(), {
             headers: {
                 'User-Agent': 'android-async-http/1.4.1 (http://loopj.com/android-async-http)',
                 'Cookie': '$Version=1'

package/dist/cjs/structures/LavalinkManagerStatics.js

@@ -39,11 +39,18 @@ exports.DefaultSources = {
     "dz": "dzsearch",
     "dzsearch": "dzsearch",
     "dzisrc": "dzisrc",
+    "dzrec": "dzrec",
     // yandexmusic
     "yandex music": "ymsearch",
     "yandexmusic": "ymsearch",
     "yandex": "ymsearch",
     "ymsearch": "ymsearch",
+    "ymrec": "ymrec",
+    // VK Music (lavasrc)
+    "vksearch": "vksearch",
+    "vkmusic": "vksearch",
+    "vk music": "vksearch",
+    "vkrec": "vkrec",
     // speak PLUGIN
     "speak": "speak",
     "tts": "tts",

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

@@ -53,18 +53,6 @@ export declare class LavalinkNode {
      * ```
      */
     constructor(options: LavalinkNodeOptions, manager: NodeManager);
-    /**
-     * Parse url params correctly for lavalink requests, including support for urls and uris.
-     * @param url input url object
-     * @param extraQueryUrlParams UrlSearchParams to use in a encodedURI, useful for example for flowertts
-     * @returns the url as a valid string
-     *
-     * @example
-     * ```ts
-     * player.node.getRequestingUrl(new URL(`http://localhost:2333/v4/loadtracks?identifier=Never gonna give you up`));
-     * ```
-     */
-    private getRequestingUrl;
     /**
      * Raw Request util function
      * @param endpoint endpoint string

package/dist/cjs/structures/Node.js

@@ -91,32 +91,6 @@ class LavalinkNode {
         this.options.regions = (this.options.regions || []).map(a => a.toLowerCase());
         Object.defineProperty(this, Utils_1.NodeSymbol, { configurable: true, value: true });
     }
-    /**
-     * Parse url params correctly for lavalink requests, including support for urls and uris.
-     * @param url input url object
-     * @param extraQueryUrlParams UrlSearchParams to use in a encodedURI, useful for example for flowertts
-     * @returns the url as a valid string
-     *
-     * @example
-     * ```ts
-     * player.node.getRequestingUrl(new URL(`http://localhost:2333/v4/loadtracks?identifier=Never gonna give you up`));
-     * ```
-     */
-    getRequestingUrl(url, extraQueryUrlParams) {
-        if (!url.searchParams.size)
-            return `${url.origin}${url.pathname}`;
-        const keysToAdd = [];
-        for (const [paramKey, paramValue] of url.searchParams.entries()) {
-            const decoded = decodeURIComponent(paramValue).trim(); // double decoding, once internally, a second time if decoded by provided user.
-            if (decoded.includes("://") && !/^https?:\/\//.test(decoded)) { // uri, but not url.
-                const [key, ...values] = decoded.split("://");
-                keysToAdd.push(`${paramKey}=${encodeURI(`${key}://${encodeURIComponent(values.join("://"))}${extraQueryUrlParams && extraQueryUrlParams?.size > 0 ? `?${extraQueryUrlParams.toString()}` : ""}`)}`);
-                continue;
-            }
-            keysToAdd.push(`${paramKey}=${encodeURIComponent(decoded)}`);
-        }
-        return `${url.origin}${url.pathname}?${keysToAdd.join("&")}`;
-    }
     /**
      * Raw Request util function
      * @param endpoint endpoint string
@@ -131,7 +105,7 @@ class LavalinkNode {
      */
     async rawRequest(endpoint, modify) {
         const options = {
-            path: `/${this.version}/${endpoint.replace(/^\//gm, "")}`,
+            path: `/${this.version}/${endpoint.startsWith("/") ? endpoint.slice(1) : endpoint}`,
             method: "GET",
             headers: {
                 "Authorization": this.options.authorization
@@ -141,7 +115,12 @@ class LavalinkNode {
         modify?.(options);
         const url = new URL(`${this.restAddress}${options.path}`);
         url.searchParams.append("trace", "true");
-        const urlToUse = this.getRequestingUrl(url, options?.extraQueryUrlParams);
+        if (options.extraQueryUrlParams && options.extraQueryUrlParams?.size > 0) {
+            for (const [paramKey, paramValue] of options.extraQueryUrlParams.entries()) {
+                url.searchParams.append(paramKey, paramValue);
+            }
+        }
+        const urlToUse = url.toString();
         // eslint-disable-next-line @typescript-eslint/no-unused-vars
         const { path, extraQueryUrlParams, ...fetchOptions } = options; // destructure fetch only options
         const response = await fetch(urlToUse, fetchOptions);
@@ -180,20 +159,17 @@ class LavalinkNode {
         if (["bcsearch", "bandcamp"].includes(Query.source) && !this.info.sourceManagers.includes("bandcamp")) {
             throw new Error("Bandcamp Search only works on the player (lavaplayer version < 2.2.0!");
         }
-        let uri = `/loadtracks?identifier=`;
+        const requestUrl = new URL(`${this.restAddress}/loadtracks`);
         if (/^https?:\/\//.test(Query.query) || ["http", "https", "link", "uri"].includes(Query.source)) { // if it's a link simply encode it
-            const url = encodeURIComponent(Query.query);
-            uri += url;
+            requestUrl.searchParams.append("identifier", Query.query);
         }
         else { // if not make a query out of it
-            if (Query.source !== "local")
-                uri += `${Query.source}:`; // only add the query source string if it's not a local track
-            if (Query.source === "ftts")
-                uri += `//${encodeURIComponent(Query.query)}`;
-            else
-                uri += encodeURIComponent(Query.query);
+            const fttsPrefix = Query.source === "ftts" ? "//" : "";
+            const prefix = Query.source !== "local" ? `${Query.source}:${fttsPrefix}` : "";
+            requestUrl.searchParams.append("identifier", `${prefix}${Query.query}`);
         }
-        const res = await this.request(uri, (options) => {
+        const requestPathAndSearch = requestUrl.pathname + requestUrl.search;
+        const res = await this.request(requestPathAndSearch, (options) => {
             if (typeof query === "object" && typeof query.extraQueryUrlParams?.size === "number" && query.extraQueryUrlParams?.size > 0) {
                 options.extraQueryUrlParams = query.extraQueryUrlParams;
             }
@@ -221,7 +197,7 @@ class LavalinkNode {
                 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?.length || 0), 0) : 0,
+                duration: resTracks.length ? resTracks.reduce((acc, cur) => acc + (cur?.info?.duration || cur?.info?.length || 0), 0) : 0,
             } : null,
             tracks: (resTracks.length ? resTracks.map(t => this.NodeManager.LavalinkManager.utils.buildTrack(t, requestUser)) : [])
         };
@@ -754,9 +730,7 @@ class LavalinkNode {
             if (!this.info.plugins.find(v => v.name === "lavasrc-plugin") &&
                 !this.info.plugins.find(v => v.name === "java-lyrics-plugin"))
                 throw new RangeError(`there is no lyrics source (via lavasrc-plugin / java-lyrics-plugin) available in the lavalink node (required for lyrics): ${this.id}`);
-            return await this.request(`/sessions/${this.sessionId}/players/${guildId}/lyrics/unsubscribe`, (options) => {
-                options.method = "DELETE";
-            });
+            return await this.request(`/sessions/${this.sessionId}/players/${guildId}/unsubscribe`);
         },
     };
     /**
@@ -1092,7 +1066,7 @@ class LavalinkNode {
                     player.ping.ws = payload.state.ping >= 0 ? payload.state.ping : player.ping.ws <= 0 && player.connected ? null : player.ping.ws || 0;
                     if (!player.createdTimeStamp && payload.state.time)
                         player.createdTimeStamp = payload.state.time;
-                    if (player.filterManager.filterUpdatedState === true && ((player.queue.current?.info?.duration || 0) <= (player.LavalinkManager.options.advancedOptions.maxFilterFixDuration || 600_000) || (0, path_1.isAbsolute)(player.queue.current?.info?.uri))) {
+                    if (player.filterManager.filterUpdatedState === true && ((player.queue.current?.info?.duration || 0) <= (player.LavalinkManager.options.advancedOptions.maxFilterFixDuration || 600_000) || (player.queue.current?.info?.uri && (0, path_1.isAbsolute)(player.queue.current?.info?.uri)))) {
                         player.filterManager.filterUpdatedState = false;
                         if (this.NodeManager.LavalinkManager.options?.advancedOptions?.enableDebugEvents) {
                             this.NodeManager.LavalinkManager.emit("debug", Constants_1.DebugEvents.PlayerUpdateFilterFixApply, {
@@ -1338,22 +1312,22 @@ class LavalinkNode {
         return;
     }
     /** @private util function for handling SponsorBlock Segmentloaded event */
-    async SponsorBlockSegmentLoaded(player, track, payload) {
+    SponsorBlockSegmentLoaded(player, track, payload) {
         this.NodeManager.LavalinkManager.emit("SegmentsLoaded", player, track || this.getTrackOfPayload(payload), payload);
         return;
     }
     /** @private util function for handling SponsorBlock SegmentSkipped event */
-    async SponsorBlockSegmentSkipped(player, track, payload) {
+    SponsorBlockSegmentSkipped(player, track, payload) {
         this.NodeManager.LavalinkManager.emit("SegmentSkipped", player, track || this.getTrackOfPayload(payload), payload);
         return;
     }
     /** @private util function for handling SponsorBlock Chaptersloaded event */
-    async SponsorBlockChaptersLoaded(player, track, payload) {
+    SponsorBlockChaptersLoaded(player, track, payload) {
         this.NodeManager.LavalinkManager.emit("ChaptersLoaded", player, track || this.getTrackOfPayload(payload), payload);
         return;
     }
     /** @private util function for handling SponsorBlock Chaptersstarted event */
-    async SponsorBlockChapterStarted(player, track, payload) {
+    SponsorBlockChapterStarted(player, track, payload) {
         this.NodeManager.LavalinkManager.emit("ChapterStarted", player, track || this.getTrackOfPayload(payload), payload);
         return;
     }
@@ -1479,7 +1453,8 @@ class LavalinkNode {
                 if (player.queue.current) {
                     if (payload.type === "TrackEndEvent")
                         this.NodeManager.LavalinkManager.emit("trackEnd", player, track, payload);
-                    return player.play({ noReplace: true, paused: false });
+                    if (this.NodeManager.LavalinkManager.options.autoSkip)
+                        return player.play({ noReplace: true, paused: false });
                 }
             }
             else {

package/dist/cjs/structures/Player.js

@@ -74,6 +74,9 @@ class Player {
      * @param LavalinkManager
      */
     constructor(options, LavalinkManager) {
+        if (typeof options?.customData === "object")
+            for (const [key, value] of Object.entries(options.customData))
+                this.set(key, value);
         this.options = options;
         this.filterManager = new Filters_1.FilterManager(this);
         this.LavalinkManager = LavalinkManager;

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

@@ -73,6 +73,8 @@ export interface PlayerOptions {
     instaUpdateFiltersFix?: boolean;
     /** If a volume should be applied via filters instead of lavalink-volume */
     applyVolumeAsFilter?: boolean;
+    /** Custom Data for the player get/set datastorage */
+    customData?: anyObject;
 }
 export type anyObject = {
     [key: string | number]: string | number | null | anyObject;

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

@@ -11,7 +11,7 @@ export type Opaque<T, K> = T & {
 export type IntegerNumber = Opaque<number, 'Int'>;
 /** Opqaue tyep for floatnumber */
 export type FloatNumber = Opaque<number, 'Float'>;
-export type LavaSrcSearchPlatformBase = "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "ymsearch";
+export type LavaSrcSearchPlatformBase = "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "dzrec" | "ymsearch" | "ymrec" | "vksearch" | "vkrec";
 export type LavaSrcSearchPlatform = LavaSrcSearchPlatformBase | "ftts";
 export type JioSaavnSearchPlatform = "jssearch" | "jsrec";
 export type DuncteSearchPlatform = "speak" | "phsearch" | "pornhub" | "porn" | "tts";
@@ -20,7 +20,7 @@ export type LavalinkClientSearchPlatformResolve = "bandcamp" | "bc";
 export type LavalinkSearchPlatform = "ytsearch" | "ytmsearch" | "scsearch" | "bcsearch" | LavaSrcSearchPlatform | DuncteSearchPlatform | JioSaavnSearchPlatform | LavalinkClientSearchPlatform;
 export type ClientCustomSearchPlatformUtils = "local" | "http" | "https" | "link" | "uri";
 export type ClientSearchPlatform = ClientCustomSearchPlatformUtils | // for file/link requests
-"youtube" | "yt" | "youtube music" | "youtubemusic" | "ytm" | "musicyoutube" | "music youtube" | "soundcloud" | "sc" | "am" | "apple music" | "applemusic" | "apple" | "musicapple" | "music apple" | "sp" | "spsuggestion" | "spotify" | "spotify.com" | "spotifycom" | "dz" | "deezer" | "yandex" | "yandex music" | "yandexmusic" | "flowerytts" | "flowery" | "flowery.tts" | LavalinkClientSearchPlatformResolve | LavalinkClientSearchPlatform | "js" | "jiosaavn";
+"youtube" | "yt" | "youtube music" | "youtubemusic" | "ytm" | "musicyoutube" | "music youtube" | "soundcloud" | "sc" | "am" | "apple music" | "applemusic" | "apple" | "musicapple" | "music apple" | "sp" | "spsuggestion" | "spotify" | "spotify.com" | "spotifycom" | "dz" | "deezer" | "yandex" | "yandex music" | "yandexmusic" | "vk music" | "vkmusic" | "flowerytts" | "flowery" | "flowery.tts" | LavalinkClientSearchPlatformResolve | LavalinkClientSearchPlatform | "js" | "jiosaavn";
 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" | "jiosaavn" | "appleMusic" | "TwitchTv" | "vimeo";
 export interface PlaylistInfo {

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

@@ -20,7 +20,7 @@ export declare function parseLavalinkConnUrl(connectionUrl: string): {
     port: number;
 };
 export declare class ManagerUtils {
-    LavalinkManager: LavalinkManager | null;
+    LavalinkManager: LavalinkManager | undefined;
     constructor(LavalinkManager?: LavalinkManager);
     buildPluginInfo(data: any, clientData?: any): any;
     buildTrack(data: LavalinkTrack | Track, requester: unknown): Track;

package/dist/cjs/structures/Utils.js

@@ -30,7 +30,7 @@ function parseLavalinkConnUrl(connectionUrl) {
     };
 }
 class ManagerUtils {
-    LavalinkManager = null;
+    LavalinkManager = undefined;
     constructor(LavalinkManager) {
         this.LavalinkManager = LavalinkManager;
     }

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

@@ -5,7 +5,9 @@ export const bandCampSearch = async (player, query, requestUser) => {
         console.log(`Lavalink-Client-Debug | SEARCHING | - ${query} on lavalink-client`);
     player.LavalinkManager.utils.validateQueryString(player.node, query);
     try {
-        const data = await fetch(`https://bandcamp.com/api/nusearch/2/autocomplete?q=${encodeURIComponent(query)}`, {
+        const requestUrl = new URL("https://bandcamp.com/api/nusearch/2/autocomplete");
+        requestUrl.searchParams.append("q", query);
+        const data = await fetch(requestUrl.toString(), {
             headers: {
                 'User-Agent': 'android-async-http/1.4.1 (http://loopj.com/android-async-http)',
                 'Cookie': '$Version=1'

package/dist/esm/structures/LavalinkManagerStatics.js

@@ -36,11 +36,18 @@ export const DefaultSources = {
     "dz": "dzsearch",
     "dzsearch": "dzsearch",
     "dzisrc": "dzisrc",
+    "dzrec": "dzrec",
     // yandexmusic
     "yandex music": "ymsearch",
     "yandexmusic": "ymsearch",
     "yandex": "ymsearch",
     "ymsearch": "ymsearch",
+    "ymrec": "ymrec",
+    // VK Music (lavasrc)
+    "vksearch": "vksearch",
+    "vkmusic": "vksearch",
+    "vk music": "vksearch",
+    "vkrec": "vkrec",
     // speak PLUGIN
     "speak": "speak",
     "tts": "tts",

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

@@ -53,18 +53,6 @@ export declare class LavalinkNode {
      * ```
      */
     constructor(options: LavalinkNodeOptions, manager: NodeManager);
-    /**
-     * Parse url params correctly for lavalink requests, including support for urls and uris.
-     * @param url input url object
-     * @param extraQueryUrlParams UrlSearchParams to use in a encodedURI, useful for example for flowertts
-     * @returns the url as a valid string
-     *
-     * @example
-     * ```ts
-     * player.node.getRequestingUrl(new URL(`http://localhost:2333/v4/loadtracks?identifier=Never gonna give you up`));
-     * ```
-     */
-    private getRequestingUrl;
     /**
      * Raw Request util function
      * @param endpoint endpoint string

package/dist/esm/structures/Node.js

@@ -87,32 +87,6 @@ export class LavalinkNode {
         this.options.regions = (this.options.regions || []).map(a => a.toLowerCase());
         Object.defineProperty(this, NodeSymbol, { configurable: true, value: true });
     }
-    /**
-     * Parse url params correctly for lavalink requests, including support for urls and uris.
-     * @param url input url object
-     * @param extraQueryUrlParams UrlSearchParams to use in a encodedURI, useful for example for flowertts
-     * @returns the url as a valid string
-     *
-     * @example
-     * ```ts
-     * player.node.getRequestingUrl(new URL(`http://localhost:2333/v4/loadtracks?identifier=Never gonna give you up`));
-     * ```
-     */
-    getRequestingUrl(url, extraQueryUrlParams) {
-        if (!url.searchParams.size)
-            return `${url.origin}${url.pathname}`;
-        const keysToAdd = [];
-        for (const [paramKey, paramValue] of url.searchParams.entries()) {
-            const decoded = decodeURIComponent(paramValue).trim(); // double decoding, once internally, a second time if decoded by provided user.
-            if (decoded.includes("://") && !/^https?:\/\//.test(decoded)) { // uri, but not url.
-                const [key, ...values] = decoded.split("://");
-                keysToAdd.push(`${paramKey}=${encodeURI(`${key}://${encodeURIComponent(values.join("://"))}${extraQueryUrlParams && extraQueryUrlParams?.size > 0 ? `?${extraQueryUrlParams.toString()}` : ""}`)}`);
-                continue;
-            }
-            keysToAdd.push(`${paramKey}=${encodeURIComponent(decoded)}`);
-        }
-        return `${url.origin}${url.pathname}?${keysToAdd.join("&")}`;
-    }
     /**
      * Raw Request util function
      * @param endpoint endpoint string
@@ -127,7 +101,7 @@ export class LavalinkNode {
      */
     async rawRequest(endpoint, modify) {
         const options = {
-            path: `/${this.version}/${endpoint.replace(/^\//gm, "")}`,
+            path: `/${this.version}/${endpoint.startsWith("/") ? endpoint.slice(1) : endpoint}`,
             method: "GET",
             headers: {
                 "Authorization": this.options.authorization
@@ -137,7 +111,12 @@ export class LavalinkNode {
         modify?.(options);
         const url = new URL(`${this.restAddress}${options.path}`);
         url.searchParams.append("trace", "true");
-        const urlToUse = this.getRequestingUrl(url, options?.extraQueryUrlParams);
+        if (options.extraQueryUrlParams && options.extraQueryUrlParams?.size > 0) {
+            for (const [paramKey, paramValue] of options.extraQueryUrlParams.entries()) {
+                url.searchParams.append(paramKey, paramValue);
+            }
+        }
+        const urlToUse = url.toString();
         // eslint-disable-next-line @typescript-eslint/no-unused-vars
         const { path, extraQueryUrlParams, ...fetchOptions } = options; // destructure fetch only options
         const response = await fetch(urlToUse, fetchOptions);
@@ -176,20 +155,17 @@ export class LavalinkNode {
         if (["bcsearch", "bandcamp"].includes(Query.source) && !this.info.sourceManagers.includes("bandcamp")) {
             throw new Error("Bandcamp Search only works on the player (lavaplayer version < 2.2.0!");
         }
-        let uri = `/loadtracks?identifier=`;
+        const requestUrl = new URL(`${this.restAddress}/loadtracks`);
         if (/^https?:\/\//.test(Query.query) || ["http", "https", "link", "uri"].includes(Query.source)) { // if it's a link simply encode it
-            const url = encodeURIComponent(Query.query);
-            uri += url;
+            requestUrl.searchParams.append("identifier", Query.query);
         }
         else { // if not make a query out of it
-            if (Query.source !== "local")
-                uri += `${Query.source}:`; // only add the query source string if it's not a local track
-            if (Query.source === "ftts")
-                uri += `//${encodeURIComponent(Query.query)}`;
-            else
-                uri += encodeURIComponent(Query.query);
+            const fttsPrefix = Query.source === "ftts" ? "//" : "";
+            const prefix = Query.source !== "local" ? `${Query.source}:${fttsPrefix}` : "";
+            requestUrl.searchParams.append("identifier", `${prefix}${Query.query}`);
         }
-        const res = await this.request(uri, (options) => {
+        const requestPathAndSearch = requestUrl.pathname + requestUrl.search;
+        const res = await this.request(requestPathAndSearch, (options) => {
             if (typeof query === "object" && typeof query.extraQueryUrlParams?.size === "number" && query.extraQueryUrlParams?.size > 0) {
                 options.extraQueryUrlParams = query.extraQueryUrlParams;
             }
@@ -217,7 +193,7 @@ export class LavalinkNode {
                 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?.length || 0), 0) : 0,
+                duration: resTracks.length ? resTracks.reduce((acc, cur) => acc + (cur?.info?.duration || cur?.info?.length || 0), 0) : 0,
             } : null,
             tracks: (resTracks.length ? resTracks.map(t => this.NodeManager.LavalinkManager.utils.buildTrack(t, requestUser)) : [])
         };
@@ -750,9 +726,7 @@ export class LavalinkNode {
             if (!this.info.plugins.find(v => v.name === "lavasrc-plugin") &&
                 !this.info.plugins.find(v => v.name === "java-lyrics-plugin"))
                 throw new RangeError(`there is no lyrics source (via lavasrc-plugin / java-lyrics-plugin) available in the lavalink node (required for lyrics): ${this.id}`);
-            return await this.request(`/sessions/${this.sessionId}/players/${guildId}/lyrics/unsubscribe`, (options) => {
-                options.method = "DELETE";
-            });
+            return await this.request(`/sessions/${this.sessionId}/players/${guildId}/unsubscribe`);
         },
     };
     /**
@@ -1088,7 +1062,7 @@ export class LavalinkNode {
                     player.ping.ws = payload.state.ping >= 0 ? payload.state.ping : player.ping.ws <= 0 && player.connected ? null : player.ping.ws || 0;
                     if (!player.createdTimeStamp && payload.state.time)
                         player.createdTimeStamp = payload.state.time;
-                    if (player.filterManager.filterUpdatedState === true && ((player.queue.current?.info?.duration || 0) <= (player.LavalinkManager.options.advancedOptions.maxFilterFixDuration || 600_000) || isAbsolute(player.queue.current?.info?.uri))) {
+                    if (player.filterManager.filterUpdatedState === true && ((player.queue.current?.info?.duration || 0) <= (player.LavalinkManager.options.advancedOptions.maxFilterFixDuration || 600_000) || (player.queue.current?.info?.uri && isAbsolute(player.queue.current?.info?.uri)))) {
                         player.filterManager.filterUpdatedState = false;
                         if (this.NodeManager.LavalinkManager.options?.advancedOptions?.enableDebugEvents) {
                             this.NodeManager.LavalinkManager.emit("debug", DebugEvents.PlayerUpdateFilterFixApply, {
@@ -1334,22 +1308,22 @@ export class LavalinkNode {
         return;
     }
     /** @private util function for handling SponsorBlock Segmentloaded event */
-    async SponsorBlockSegmentLoaded(player, track, payload) {
+    SponsorBlockSegmentLoaded(player, track, payload) {
         this.NodeManager.LavalinkManager.emit("SegmentsLoaded", player, track || this.getTrackOfPayload(payload), payload);
         return;
     }
     /** @private util function for handling SponsorBlock SegmentSkipped event */
-    async SponsorBlockSegmentSkipped(player, track, payload) {
+    SponsorBlockSegmentSkipped(player, track, payload) {
         this.NodeManager.LavalinkManager.emit("SegmentSkipped", player, track || this.getTrackOfPayload(payload), payload);
         return;
     }
     /** @private util function for handling SponsorBlock Chaptersloaded event */
-    async SponsorBlockChaptersLoaded(player, track, payload) {
+    SponsorBlockChaptersLoaded(player, track, payload) {
         this.NodeManager.LavalinkManager.emit("ChaptersLoaded", player, track || this.getTrackOfPayload(payload), payload);
         return;
     }
     /** @private util function for handling SponsorBlock Chaptersstarted event */
-    async SponsorBlockChapterStarted(player, track, payload) {
+    SponsorBlockChapterStarted(player, track, payload) {
         this.NodeManager.LavalinkManager.emit("ChapterStarted", player, track || this.getTrackOfPayload(payload), payload);
         return;
     }
@@ -1475,7 +1449,8 @@ export class LavalinkNode {
                 if (player.queue.current) {
                     if (payload.type === "TrackEndEvent")
                         this.NodeManager.LavalinkManager.emit("trackEnd", player, track, payload);
-                    return player.play({ noReplace: true, paused: false });
+                    if (this.NodeManager.LavalinkManager.options.autoSkip)
+                        return player.play({ noReplace: true, paused: false });
                 }
             }
             else {

package/dist/esm/structures/Player.js

@@ -71,6 +71,9 @@ export class Player {
      * @param LavalinkManager
      */
     constructor(options, LavalinkManager) {
+        if (typeof options?.customData === "object")
+            for (const [key, value] of Object.entries(options.customData))
+                this.set(key, value);
         this.options = options;
         this.filterManager = new FilterManager(this);
         this.LavalinkManager = LavalinkManager;

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

@@ -73,6 +73,8 @@ export interface PlayerOptions {
     instaUpdateFiltersFix?: boolean;
     /** If a volume should be applied via filters instead of lavalink-volume */
     applyVolumeAsFilter?: boolean;
+    /** Custom Data for the player get/set datastorage */
+    customData?: anyObject;
 }
 export type anyObject = {
     [key: string | number]: string | number | null | anyObject;

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

@@ -11,7 +11,7 @@ export type Opaque<T, K> = T & {
 export type IntegerNumber = Opaque<number, 'Int'>;
 /** Opqaue tyep for floatnumber */
 export type FloatNumber = Opaque<number, 'Float'>;
-export type LavaSrcSearchPlatformBase = "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "ymsearch";
+export type LavaSrcSearchPlatformBase = "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "dzrec" | "ymsearch" | "ymrec" | "vksearch" | "vkrec";
 export type LavaSrcSearchPlatform = LavaSrcSearchPlatformBase | "ftts";
 export type JioSaavnSearchPlatform = "jssearch" | "jsrec";
 export type DuncteSearchPlatform = "speak" | "phsearch" | "pornhub" | "porn" | "tts";
@@ -20,7 +20,7 @@ export type LavalinkClientSearchPlatformResolve = "bandcamp" | "bc";
 export type LavalinkSearchPlatform = "ytsearch" | "ytmsearch" | "scsearch" | "bcsearch" | LavaSrcSearchPlatform | DuncteSearchPlatform | JioSaavnSearchPlatform | LavalinkClientSearchPlatform;
 export type ClientCustomSearchPlatformUtils = "local" | "http" | "https" | "link" | "uri";
 export type ClientSearchPlatform = ClientCustomSearchPlatformUtils | // for file/link requests
-"youtube" | "yt" | "youtube music" | "youtubemusic" | "ytm" | "musicyoutube" | "music youtube" | "soundcloud" | "sc" | "am" | "apple music" | "applemusic" | "apple" | "musicapple" | "music apple" | "sp" | "spsuggestion" | "spotify" | "spotify.com" | "spotifycom" | "dz" | "deezer" | "yandex" | "yandex music" | "yandexmusic" | "flowerytts" | "flowery" | "flowery.tts" | LavalinkClientSearchPlatformResolve | LavalinkClientSearchPlatform | "js" | "jiosaavn";
+"youtube" | "yt" | "youtube music" | "youtubemusic" | "ytm" | "musicyoutube" | "music youtube" | "soundcloud" | "sc" | "am" | "apple music" | "applemusic" | "apple" | "musicapple" | "music apple" | "sp" | "spsuggestion" | "spotify" | "spotify.com" | "spotifycom" | "dz" | "deezer" | "yandex" | "yandex music" | "yandexmusic" | "vk music" | "vkmusic" | "flowerytts" | "flowery" | "flowery.tts" | LavalinkClientSearchPlatformResolve | LavalinkClientSearchPlatform | "js" | "jiosaavn";
 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" | "jiosaavn" | "appleMusic" | "TwitchTv" | "vimeo";
 export interface PlaylistInfo {

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

@@ -20,7 +20,7 @@ export declare function parseLavalinkConnUrl(connectionUrl: string): {
     port: number;
 };
 export declare class ManagerUtils {
-    LavalinkManager: LavalinkManager | null;
+    LavalinkManager: LavalinkManager | undefined;
     constructor(LavalinkManager?: LavalinkManager);
     buildPluginInfo(data: any, clientData?: any): any;
     buildTrack(data: LavalinkTrack | Track, requester: unknown): Track;

package/dist/esm/structures/Utils.js

@@ -25,7 +25,7 @@ export function parseLavalinkConnUrl(connectionUrl) {
     };
 }
 export class ManagerUtils {
-    LavalinkManager = null;
+    LavalinkManager = undefined;
     constructor(LavalinkManager) {
         this.LavalinkManager = LavalinkManager;
     }

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

@@ -53,18 +53,6 @@ export declare class LavalinkNode {
      * ```
      */
     constructor(options: LavalinkNodeOptions, manager: NodeManager);
-    /**
-     * Parse url params correctly for lavalink requests, including support for urls and uris.
-     * @param url input url object
-     * @param extraQueryUrlParams UrlSearchParams to use in a encodedURI, useful for example for flowertts
-     * @returns the url as a valid string
-     *
-     * @example
-     * ```ts
-     * player.node.getRequestingUrl(new URL(`http://localhost:2333/v4/loadtracks?identifier=Never gonna give you up`));
-     * ```
-     */
-    private getRequestingUrl;
     /**
      * Raw Request util function
      * @param endpoint endpoint string

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

@@ -73,6 +73,8 @@ export interface PlayerOptions {
     instaUpdateFiltersFix?: boolean;
     /** If a volume should be applied via filters instead of lavalink-volume */
     applyVolumeAsFilter?: boolean;
+    /** Custom Data for the player get/set datastorage */
+    customData?: anyObject;
 }
 export type anyObject = {
     [key: string | number]: string | number | null | anyObject;

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

@@ -11,7 +11,7 @@ export type Opaque<T, K> = T & {
 export type IntegerNumber = Opaque<number, 'Int'>;
 /** Opqaue tyep for floatnumber */
 export type FloatNumber = Opaque<number, 'Float'>;
-export type LavaSrcSearchPlatformBase = "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "ymsearch";
+export type LavaSrcSearchPlatformBase = "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "dzrec" | "ymsearch" | "ymrec" | "vksearch" | "vkrec";
 export type LavaSrcSearchPlatform = LavaSrcSearchPlatformBase | "ftts";
 export type JioSaavnSearchPlatform = "jssearch" | "jsrec";
 export type DuncteSearchPlatform = "speak" | "phsearch" | "pornhub" | "porn" | "tts";
@@ -20,7 +20,7 @@ export type LavalinkClientSearchPlatformResolve = "bandcamp" | "bc";
 export type LavalinkSearchPlatform = "ytsearch" | "ytmsearch" | "scsearch" | "bcsearch" | LavaSrcSearchPlatform | DuncteSearchPlatform | JioSaavnSearchPlatform | LavalinkClientSearchPlatform;
 export type ClientCustomSearchPlatformUtils = "local" | "http" | "https" | "link" | "uri";
 export type ClientSearchPlatform = ClientCustomSearchPlatformUtils | // for file/link requests
-"youtube" | "yt" | "youtube music" | "youtubemusic" | "ytm" | "musicyoutube" | "music youtube" | "soundcloud" | "sc" | "am" | "apple music" | "applemusic" | "apple" | "musicapple" | "music apple" | "sp" | "spsuggestion" | "spotify" | "spotify.com" | "spotifycom" | "dz" | "deezer" | "yandex" | "yandex music" | "yandexmusic" | "flowerytts" | "flowery" | "flowery.tts" | LavalinkClientSearchPlatformResolve | LavalinkClientSearchPlatform | "js" | "jiosaavn";
+"youtube" | "yt" | "youtube music" | "youtubemusic" | "ytm" | "musicyoutube" | "music youtube" | "soundcloud" | "sc" | "am" | "apple music" | "applemusic" | "apple" | "musicapple" | "music apple" | "sp" | "spsuggestion" | "spotify" | "spotify.com" | "spotifycom" | "dz" | "deezer" | "yandex" | "yandex music" | "yandexmusic" | "vk music" | "vkmusic" | "flowerytts" | "flowery" | "flowery.tts" | LavalinkClientSearchPlatformResolve | LavalinkClientSearchPlatform | "js" | "jiosaavn";
 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" | "jiosaavn" | "appleMusic" | "TwitchTv" | "vimeo";
 export interface PlaylistInfo {

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

@@ -20,7 +20,7 @@ export declare function parseLavalinkConnUrl(connectionUrl: string): {
     port: number;
 };
 export declare class ManagerUtils {
-    LavalinkManager: LavalinkManager | null;
+    LavalinkManager: LavalinkManager | undefined;
     constructor(LavalinkManager?: LavalinkManager);
     buildPluginInfo(data: any, clientData?: any): any;
     buildTrack(data: LavalinkTrack | Track, requester: unknown): Track;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lavalink-client",
-  "version": "2.4.6",
+  "version": "2.5.0",
   "description": "Easy, flexible and feature-rich lavalink@v4 Client. Both for Beginners and Proficients.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -59,12 +59,12 @@
   "homepage": "https://tomato6966.github.io/lavalink-client/",
   "devDependencies": {
     "@eslint/eslintrc": "^3.2.0",
-    "@eslint/js": "^9.18.0",
-    "@types/node": "^22.10.5",
-    "@types/ws": "^8.5.13",
-    "@typescript-eslint/eslint-plugin": "^8.20.0",
-    "@typescript-eslint/parser": "^8.20.0",
-    "eslint": "^9.18.0",
+    "@eslint/js": "^9.20.0",
+    "@types/node": "^22.13.4",
+    "@types/ws": "^8.5.14",
+    "@typescript-eslint/eslint-plugin": "^8.24.1",
+    "@typescript-eslint/parser": "^8.24.1",
+    "eslint": "^9.20.1",
     "tsc-alias": "^1.8.10",
     "typescript": "^5.7.3"
   },