lavalink-client 1.0.1 → 1.0.3

package/README.md

@@ -14,21 +14,34 @@ npm install tomato6966/lavalink-client
 
 # Features
 
-- Player-Destroy Reasons like:
+- 💯 Lavalink v4 Supported only (with Lavalink Plugins)
+
+- ✅ Player-Destroy Reasons like:
   - Channel got deleted, Player got disconnected...
-- Choose able queue stores (maps, collections, redis, databases, ...)
+
+- ✨ Choose able queue stores (maps, collections, redis, databases, ...)
   - You can create your own queueStore, thus make it easy to sync queues accross multiple connections (e.g. dashboard-bot)
-- Included Filter & Equalizer Management
-- Multiple Player Options
+
+- 😍 Included Filter & Equalizer Management
+
+- 👍 Multiple Player Options *for easier use*
   - onDisconnect -> Player Destroy / auto Reconnect
   - onEmptyQueue -> Player Destroy / leave After x Time
   - instaFixFilter -> seek the player after applying a filter, to instantly apply it's effect (only works for little-durational-songs)
   - applyVolumeAsFilter -> instead of using lavalink.volume, it uses lavalink.filters.volume which is much different!
-- Lavalink Validations
+
+- 🛡️ Lavalink Validations
   - It only let's you use the filters / plugins / sources, if Lavalink actually has it enabled
-- Memory friendly and easy style
+
+- 🧑‍💻 Memory friendly and easy style
   - Only the required data is displayed, and the store-way & types match Lavalink#IMPLEMENTATION.md
-- Much much more!
+
+- 😘 Automated Handlings
+  - Skips the songs, on TrackEnd, TrackStuck, TrackError, 
+  - Destroys the player on channeldelete
+  - Pauses / resumes the player if it get's muted / unmuted (server-wide) [soon]
+  - ...
+- 😁 Much much more!
 
 # Documentation
 
@@ -113,4 +126,13 @@ await player.play(); // you can provide specific track, or let the manager choos
 
 ## Example (typescript)
 
-Can be found in the [/testBot](https://github.com/Tomato6966/lavalink-client/blob/main/testBot/README.md) Directory
+Can be found in the [`/testBot`](https://github.com/Tomato6966/lavalink-client/blob/main/testBot/README.md) Directory
+
+It contains the following features:
+
+- Example Use for `Redis based Queue`
+- Example Use for `Queue Changes Watcher Logger`
+- Example Use for `Filters`, `Audio Output`, `equalizers`
+- How to make an easy, yet advanced `Slash Commands Only Bot`
+- `Slim Memory Usage`
+- `All lavalink-client events` displayments

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

@@ -18,15 +18,26 @@ export interface BotClientOptions {
     [x: string | number | symbol | undefined]: any;
 }
 export interface LavalinkPlayerOptions {
+    /** If the Lavalink Volume should be decremented by x number */
     volumeDecrementer?: number;
-    clientBasedUpdateInterval?: number;
+    /** How often it should update the the player Position */
+    clientBasedPositionUpdateInterval?: number;
+    /** What should be used as a searchPlatform, if no source was provided during the query */
     defaultSearchPlatform?: SearchPlatform;
+    /** Applies the volume via a filter, not via the lavalink volume transformer */
     applyVolumeAsFilter?: boolean;
+    /** Transforms the saved data of a requested user */
+    requesterTransformer?: (requester: unknown) => unknown;
+    /** What lavalink-client should do when the player reconnects */
     onDisconnect?: {
+        /** Try to reconnect? -> If fails -> Destroy */
         autoReconnect?: boolean;
+        /** Instantly destroy player (overrides autoReconnect) */
         destroyPlayer?: boolean;
     };
     onEmptyQueue?: {
+        /** Get's executed onEmptyQueue -> You can do any track queue previous transformations, if you add a track to the queue -> it will play it, if not queueEnd will execute! */
+        autoPlayFunction?: (player: Player, lastPlayedTrack: Track) => Promise<void>;
         destroyAfterMs?: number;
     };
 }

package/dist/cjs/structures/LavalinkManagerStatics.js

@@ -40,6 +40,7 @@ exports.DefaultSources = {
     // speak PLUGIN
     "speak": "speak",
     "tts": "tts",
+    "ftts": "ftts"
 };
 exports.SourceLinksRegexes = {
     /** DEFAULT SUPPORTED BY LAVALINK */

package/dist/cjs/structures/Node.js

@@ -449,15 +449,15 @@ 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 (typeof this.NodeManager.LavalinkManager.options.playerOptions.clientBasedUpdateInterval === "number" && this.NodeManager.LavalinkManager.options.playerOptions.clientBasedUpdateInterval >= 10) {
+                if (typeof this.NodeManager.LavalinkManager.options.playerOptions.clientBasedPositionUpdateInterval === "number" && this.NodeManager.LavalinkManager.options.playerOptions.clientBasedPositionUpdateInterval >= 10) {
                     player.set("internal_updateInterval", setInterval(() => {
-                        player.position += this.NodeManager.LavalinkManager.options.playerOptions.clientBasedUpdateInterval || 250;
+                        player.position += this.NodeManager.LavalinkManager.options.playerOptions.clientBasedPositionUpdateInterval || 250;
                         if (player.filterManager.filterUpdatedState >= 1) {
                             player.filterManager.filterUpdatedState++;
                             const maxMins = 8;
                             const currentDuration = player.queue.current?.info?.duration || 0;
                             if (currentDuration <= maxMins * 6e4 || (0, path_1.isAbsolute)(player.queue.current?.info?.uri)) {
-                                if (player.filterManager.filterUpdatedState >= ((this.NodeManager.LavalinkManager.options.playerOptions.clientBasedUpdateInterval || 250) > 400 ? 2 : 3)) {
+                                if (player.filterManager.filterUpdatedState >= ((this.NodeManager.LavalinkManager.options.playerOptions.clientBasedPositionUpdateInterval || 250) > 400 ? 2 : 3)) {
                                     player.filterManager.filterUpdatedState = 0;
                                     player.seek(player.position);
                                 }
@@ -466,7 +466,7 @@ class LavalinkNode {
                                 player.filterManager.filterUpdatedState = 0;
                             }
                         }
-                    }, this.NodeManager.LavalinkManager.options.playerOptions.clientBasedUpdateInterval || 250));
+                    }, this.NodeManager.LavalinkManager.options.playerOptions.clientBasedPositionUpdateInterval || 250));
                 }
                 else {
                     if (player.filterManager.filterUpdatedState >= 1) { // if no interval but instafix available, findable via the "filterUpdatedState" property
@@ -495,7 +495,6 @@ class LavalinkNode {
         const player = this.NodeManager.LavalinkManager.getPlayer(payload.guildId);
         if (!player)
             return;
-        console.log(payload.type);
         switch (payload.type) {
             case "TrackStartEvent":
                 this.trackStart(player, player.queue.current, payload);
@@ -555,6 +554,13 @@ class LavalinkNode {
     async queueEnd(player, track, payload) {
         player.queue.current = null;
         player.playing = false;
+        if (typeof this.NodeManager.LavalinkManager.options?.playerOptions?.onEmptyQueue?.autoPlayFunction === "function") {
+            await this.NodeManager.LavalinkManager.options?.playerOptions?.onEmptyQueue?.autoPlayFunction(player, track);
+            if (player.queue.tracks.length > 0)
+                await (0, Utils_1.queueTrackEnd)(player.queue, player.repeatMode === "queue");
+            if (player.queue.current)
+                return player.play({ track: player.queue.current, noReplace: true, paused: false });
+        }
         if (payload?.reason !== "stopped") {
             await player.queue.utils.save();
         }

package/dist/cjs/structures/Player.js

@@ -203,8 +203,9 @@ class Player {
             Query.source = LavalinkManagerStatics_1.DefaultSources[foundSource]; // set the source to ytsearch:
             Query.query = Query.query.replace(`${foundSource}:`, ""); // remove ytsearch: from the query
         }
-        // request the data
-        const res = await this.node.request(`/loadtracks?identifier=${!/^https?:\/\//.test(Query.query) ? `${Query.source}:` : ""}${encodeURIComponent(Query.query)}`);
+        // 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)}`);
         // 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 {

package/dist/cjs/structures/Queue.js

@@ -74,7 +74,6 @@ class Queue {
         this.current = this.managerUtils.isTrack(data.current) ? data.current : null;
         this.previous = Array.isArray(data.previous) && data.previous.some(track => this.managerUtils.isTrack(track)) ? data.previous.filter(track => this.managerUtils.isTrack(track)) : [];
         this.tracks = Array.isArray(data.tracks) && data.tracks.some(track => this.managerUtils.isTrack(track)) ? data.tracks.filter(track => this.managerUtils.isTrack(track)) : [];
-        this.utils.sync(false, true);
     }
     /**
      * Utils for a Queue

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

@@ -1,4 +1,7 @@
 import { Base64 } from "./Utils";
+type LavalinkSourceNames = "youtube" | "youtubemusic" | "soundcloud" | "bandcamp" | "twitch";
+type LavalinkPlugin_LavaSrc_SourceNames = "deezer" | "spotify" | "applemusic" | "yandexmusic" | "flowery-tts";
+type SourceNames = LavalinkSourceNames | LavalinkPlugin_LavaSrc_SourceNames;
 export interface TrackInfo {
     identifier: string;
     title: string;
@@ -6,7 +9,7 @@ export interface TrackInfo {
     duration: number;
     artworkUrl: string | null;
     uri: string;
-    sourceName: string;
+    sourceName: SourceNames;
     isSeekable: boolean;
     isStream: boolean;
     isrc: string | null;
@@ -24,6 +27,10 @@ export interface PluginInfo {
     url?: string;
     /** The Url provided by a Plugin */
     uri?: string;
+    /** You can put specific track information here, to transform the tracks... */
+    clientData?: {
+        [key: string]: any;
+    };
 }
 export interface LavalinkTrack {
     /** The Base 64 encoded String */
@@ -45,3 +52,4 @@ export interface UnresolvedQuery {
     /** The Track's Requester */
     requester?: unknown;
 }
+export {};

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

@@ -8,7 +8,7 @@ export declare const TrackSymbol: unique symbol;
 export declare const UnresolvedTrackSymbol: unique symbol;
 export declare const QueueSymbol: unique symbol;
 export declare const NodeSymbol: unique symbol;
-export type LavalinkSearchPlatform = "ytsearch" | "ytmsearch" | "scsearch" | "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "sprec" | "ymsearch" | "speak" | "tts";
+export type LavalinkSearchPlatform = "ytsearch" | "ytmsearch" | "scsearch" | "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "sprec" | "ymsearch" | "speak" | "tts" | "ftts";
 export type ClientSearchPlatform = "youtube" | "yt" | "yt" | "youtube music" | "youtubemusic" | "ytm" | "soundcloud" | "sc" | "am" | "apple music" | "applemusic" | "apple" | "yandex music" | "sp" | "sprec" | "spsuggestion" | "spotify" | "dz" | "deezer" | "yandex" | "yandexmusic";
 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";

package/dist/cjs/structures/Utils.js

@@ -24,7 +24,7 @@ class ManagerUitls {
                     title: data.info?.title,
                     author: data.info?.author,
                     duration: data.info?.length,
-                    artworkUrl: data.info?.artworkUrl || data.pluginInfo?.artworkUrl || data.plugin?.artworkUrl || ["youtube.", "youtu.be"].some(d => data.info?.uri?.includes?.(d)) ? `https://img.youtube.com/vi/${data.info?.identifier}/mqdefault.jpg` : undefined,
+                    artworkUrl: data.info?.artworkUrl || data.pluginInfo?.artworkUrl || data.plugin?.artworkUrl,
                     uri: data.info?.uri,
                     sourceName: data.info?.sourceName,
                     isSeekable: data.info?.isSeekable,
@@ -32,7 +32,7 @@ class ManagerUitls {
                     isrc: data.info?.isrc,
                 },
                 pluginInfo: data.pluginInfo || data.plugin || {},
-                requester: data?.requester || requester,
+                requester: typeof this.manager.options?.playerOptions?.requesterTransformer === "function" ? this.manager.options?.playerOptions?.requesterTransformer(data?.requester || requester) : requester,
             };
             Object.defineProperty(r, exports.TrackSymbol, { configurable: true, value: true });
             return r;
@@ -121,6 +121,10 @@ class ManagerUitls {
         if (source === "tts" && !node.info.sourceManagers.includes("tts")) {
             throw new Error("Lavalink Node has not 'tts' enabled, which is required to have 'tts' work");
         }
+        if (source === "ftts" && !node.info.sourceManagers.includes("ftts")) {
+            console.log(node.info.sourceManagers);
+            throw new Error("Lavalink Node has not 'ftts' enabled, which is required to have 'ftts' work");
+        }
         if (source === "ymsearch" && !node.info.sourceManagers.includes("yandexmusic")) {
             throw new Error("Lavalink Node has not 'yandexmusic' enabled, which is required to have 'ymsearch' work");
         }

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

@@ -18,15 +18,26 @@ export interface BotClientOptions {
     [x: string | number | symbol | undefined]: any;
 }
 export interface LavalinkPlayerOptions {
+    /** If the Lavalink Volume should be decremented by x number */
     volumeDecrementer?: number;
-    clientBasedUpdateInterval?: number;
+    /** How often it should update the the player Position */
+    clientBasedPositionUpdateInterval?: number;
+    /** What should be used as a searchPlatform, if no source was provided during the query */
     defaultSearchPlatform?: SearchPlatform;
+    /** Applies the volume via a filter, not via the lavalink volume transformer */
     applyVolumeAsFilter?: boolean;
+    /** Transforms the saved data of a requested user */
+    requesterTransformer?: (requester: unknown) => unknown;
+    /** What lavalink-client should do when the player reconnects */
     onDisconnect?: {
+        /** Try to reconnect? -> If fails -> Destroy */
         autoReconnect?: boolean;
+        /** Instantly destroy player (overrides autoReconnect) */
         destroyPlayer?: boolean;
     };
     onEmptyQueue?: {
+        /** Get's executed onEmptyQueue -> You can do any track queue previous transformations, if you add a track to the queue -> it will play it, if not queueEnd will execute! */
+        autoPlayFunction?: (player: Player, lastPlayedTrack: Track) => Promise<void>;
         destroyAfterMs?: number;
     };
 }

package/dist/esm/structures/LavalinkManagerStatics.js

@@ -37,6 +37,7 @@ export const DefaultSources = {
     // speak PLUGIN
     "speak": "speak",
     "tts": "tts",
+    "ftts": "ftts"
 };
 export const SourceLinksRegexes = {
     /** DEFAULT SUPPORTED BY LAVALINK */

package/dist/esm/structures/Node.js

@@ -445,15 +445,15 @@ 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 (typeof this.NodeManager.LavalinkManager.options.playerOptions.clientBasedUpdateInterval === "number" && this.NodeManager.LavalinkManager.options.playerOptions.clientBasedUpdateInterval >= 10) {
+                if (typeof this.NodeManager.LavalinkManager.options.playerOptions.clientBasedPositionUpdateInterval === "number" && this.NodeManager.LavalinkManager.options.playerOptions.clientBasedPositionUpdateInterval >= 10) {
                     player.set("internal_updateInterval", setInterval(() => {
-                        player.position += this.NodeManager.LavalinkManager.options.playerOptions.clientBasedUpdateInterval || 250;
+                        player.position += this.NodeManager.LavalinkManager.options.playerOptions.clientBasedPositionUpdateInterval || 250;
                         if (player.filterManager.filterUpdatedState >= 1) {
                             player.filterManager.filterUpdatedState++;
                             const maxMins = 8;
                             const currentDuration = player.queue.current?.info?.duration || 0;
                             if (currentDuration <= maxMins * 6e4 || isAbsolute(player.queue.current?.info?.uri)) {
-                                if (player.filterManager.filterUpdatedState >= ((this.NodeManager.LavalinkManager.options.playerOptions.clientBasedUpdateInterval || 250) > 400 ? 2 : 3)) {
+                                if (player.filterManager.filterUpdatedState >= ((this.NodeManager.LavalinkManager.options.playerOptions.clientBasedPositionUpdateInterval || 250) > 400 ? 2 : 3)) {
                                     player.filterManager.filterUpdatedState = 0;
                                     player.seek(player.position);
                                 }
@@ -462,7 +462,7 @@ export class LavalinkNode {
                                 player.filterManager.filterUpdatedState = 0;
                             }
                         }
-                    }, this.NodeManager.LavalinkManager.options.playerOptions.clientBasedUpdateInterval || 250));
+                    }, this.NodeManager.LavalinkManager.options.playerOptions.clientBasedPositionUpdateInterval || 250));
                 }
                 else {
                     if (player.filterManager.filterUpdatedState >= 1) { // if no interval but instafix available, findable via the "filterUpdatedState" property
@@ -491,7 +491,6 @@ export class LavalinkNode {
         const player = this.NodeManager.LavalinkManager.getPlayer(payload.guildId);
         if (!player)
             return;
-        console.log(payload.type);
         switch (payload.type) {
             case "TrackStartEvent":
                 this.trackStart(player, player.queue.current, payload);
@@ -551,6 +550,13 @@ export class LavalinkNode {
     async queueEnd(player, track, payload) {
         player.queue.current = null;
         player.playing = false;
+        if (typeof this.NodeManager.LavalinkManager.options?.playerOptions?.onEmptyQueue?.autoPlayFunction === "function") {
+            await this.NodeManager.LavalinkManager.options?.playerOptions?.onEmptyQueue?.autoPlayFunction(player, track);
+            if (player.queue.tracks.length > 0)
+                await queueTrackEnd(player.queue, player.repeatMode === "queue");
+            if (player.queue.current)
+                return player.play({ track: player.queue.current, noReplace: true, paused: false });
+        }
         if (payload?.reason !== "stopped") {
             await player.queue.utils.save();
         }

package/dist/esm/structures/Player.js

@@ -200,8 +200,9 @@ export class Player {
             Query.source = DefaultSources[foundSource]; // set the source to ytsearch:
             Query.query = Query.query.replace(`${foundSource}:`, ""); // remove ytsearch: from the query
         }
-        // request the data
-        const res = await this.node.request(`/loadtracks?identifier=${!/^https?:\/\//.test(Query.query) ? `${Query.source}:` : ""}${encodeURIComponent(Query.query)}`);
+        // 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)}`);
         // 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 {

package/dist/esm/structures/Queue.js

@@ -68,7 +68,6 @@ export class Queue {
         this.current = this.managerUtils.isTrack(data.current) ? data.current : null;
         this.previous = Array.isArray(data.previous) && data.previous.some(track => this.managerUtils.isTrack(track)) ? data.previous.filter(track => this.managerUtils.isTrack(track)) : [];
         this.tracks = Array.isArray(data.tracks) && data.tracks.some(track => this.managerUtils.isTrack(track)) ? data.tracks.filter(track => this.managerUtils.isTrack(track)) : [];
-        this.utils.sync(false, true);
     }
     /**
      * Utils for a Queue

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

@@ -1,4 +1,7 @@
 import { Base64 } from "./Utils";
+type LavalinkSourceNames = "youtube" | "youtubemusic" | "soundcloud" | "bandcamp" | "twitch";
+type LavalinkPlugin_LavaSrc_SourceNames = "deezer" | "spotify" | "applemusic" | "yandexmusic" | "flowery-tts";
+type SourceNames = LavalinkSourceNames | LavalinkPlugin_LavaSrc_SourceNames;
 export interface TrackInfo {
     identifier: string;
     title: string;
@@ -6,7 +9,7 @@ export interface TrackInfo {
     duration: number;
     artworkUrl: string | null;
     uri: string;
-    sourceName: string;
+    sourceName: SourceNames;
     isSeekable: boolean;
     isStream: boolean;
     isrc: string | null;
@@ -24,6 +27,10 @@ export interface PluginInfo {
     url?: string;
     /** The Url provided by a Plugin */
     uri?: string;
+    /** You can put specific track information here, to transform the tracks... */
+    clientData?: {
+        [key: string]: any;
+    };
 }
 export interface LavalinkTrack {
     /** The Base 64 encoded String */
@@ -45,3 +52,4 @@ export interface UnresolvedQuery {
     /** The Track's Requester */
     requester?: unknown;
 }
+export {};

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

@@ -8,7 +8,7 @@ export declare const TrackSymbol: unique symbol;
 export declare const UnresolvedTrackSymbol: unique symbol;
 export declare const QueueSymbol: unique symbol;
 export declare const NodeSymbol: unique symbol;
-export type LavalinkSearchPlatform = "ytsearch" | "ytmsearch" | "scsearch" | "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "sprec" | "ymsearch" | "speak" | "tts";
+export type LavalinkSearchPlatform = "ytsearch" | "ytmsearch" | "scsearch" | "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "sprec" | "ymsearch" | "speak" | "tts" | "ftts";
 export type ClientSearchPlatform = "youtube" | "yt" | "yt" | "youtube music" | "youtubemusic" | "ytm" | "soundcloud" | "sc" | "am" | "apple music" | "applemusic" | "apple" | "yandex music" | "sp" | "sprec" | "spsuggestion" | "spotify" | "dz" | "deezer" | "yandex" | "yandexmusic";
 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";

package/dist/esm/structures/Utils.js

@@ -21,7 +21,7 @@ export class ManagerUitls {
                     title: data.info?.title,
                     author: data.info?.author,
                     duration: data.info?.length,
-                    artworkUrl: data.info?.artworkUrl || data.pluginInfo?.artworkUrl || data.plugin?.artworkUrl || ["youtube.", "youtu.be"].some(d => data.info?.uri?.includes?.(d)) ? `https://img.youtube.com/vi/${data.info?.identifier}/mqdefault.jpg` : undefined,
+                    artworkUrl: data.info?.artworkUrl || data.pluginInfo?.artworkUrl || data.plugin?.artworkUrl,
                     uri: data.info?.uri,
                     sourceName: data.info?.sourceName,
                     isSeekable: data.info?.isSeekable,
@@ -29,7 +29,7 @@ export class ManagerUitls {
                     isrc: data.info?.isrc,
                 },
                 pluginInfo: data.pluginInfo || data.plugin || {},
-                requester: data?.requester || requester,
+                requester: typeof this.manager.options?.playerOptions?.requesterTransformer === "function" ? this.manager.options?.playerOptions?.requesterTransformer(data?.requester || requester) : requester,
             };
             Object.defineProperty(r, TrackSymbol, { configurable: true, value: true });
             return r;
@@ -118,6 +118,10 @@ export class ManagerUitls {
         if (source === "tts" && !node.info.sourceManagers.includes("tts")) {
             throw new Error("Lavalink Node has not 'tts' enabled, which is required to have 'tts' work");
         }
+        if (source === "ftts" && !node.info.sourceManagers.includes("ftts")) {
+            console.log(node.info.sourceManagers);
+            throw new Error("Lavalink Node has not 'ftts' enabled, which is required to have 'ftts' work");
+        }
         if (source === "ymsearch" && !node.info.sourceManagers.includes("yandexmusic")) {
             throw new Error("Lavalink Node has not 'yandexmusic' enabled, which is required to have 'ymsearch' work");
         }

package/dist/structures/LavalinkManager.d.ts

@@ -17,7 +17,7 @@ export interface BotClientOptions {
 }
 export interface LavalinkPlayerOptions {
     volumeDecrementer?: number;
-    clientBasedUpdateInterval?: number;
+    clientBasedPositionUpdateInterval?: number;
     defaultSearchPlatform?: SearchPlatform;
     applyVolumeAsFilter?: boolean;
 }

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

@@ -18,15 +18,26 @@ export interface BotClientOptions {
     [x: string | number | symbol | undefined]: any;
 }
 export interface LavalinkPlayerOptions {
+    /** If the Lavalink Volume should be decremented by x number */
     volumeDecrementer?: number;
-    clientBasedUpdateInterval?: number;
+    /** How often it should update the the player Position */
+    clientBasedPositionUpdateInterval?: number;
+    /** What should be used as a searchPlatform, if no source was provided during the query */
     defaultSearchPlatform?: SearchPlatform;
+    /** Applies the volume via a filter, not via the lavalink volume transformer */
     applyVolumeAsFilter?: boolean;
+    /** Transforms the saved data of a requested user */
+    requesterTransformer?: (requester: unknown) => unknown;
+    /** What lavalink-client should do when the player reconnects */
     onDisconnect?: {
+        /** Try to reconnect? -> If fails -> Destroy */
         autoReconnect?: boolean;
+        /** Instantly destroy player (overrides autoReconnect) */
         destroyPlayer?: boolean;
     };
     onEmptyQueue?: {
+        /** Get's executed onEmptyQueue -> You can do any track queue previous transformations, if you add a track to the queue -> it will play it, if not queueEnd will execute! */
+        autoPlayFunction?: (player: Player, lastPlayedTrack: Track) => Promise<void>;
         destroyAfterMs?: number;
     };
 }

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

@@ -1,4 +1,7 @@
 import { Base64 } from "./Utils";
+type LavalinkSourceNames = "youtube" | "youtubemusic" | "soundcloud" | "bandcamp" | "twitch";
+type LavalinkPlugin_LavaSrc_SourceNames = "deezer" | "spotify" | "applemusic" | "yandexmusic" | "flowery-tts";
+type SourceNames = LavalinkSourceNames | LavalinkPlugin_LavaSrc_SourceNames;
 export interface TrackInfo {
     identifier: string;
     title: string;
@@ -6,7 +9,7 @@ export interface TrackInfo {
     duration: number;
     artworkUrl: string | null;
     uri: string;
-    sourceName: string;
+    sourceName: SourceNames;
     isSeekable: boolean;
     isStream: boolean;
     isrc: string | null;
@@ -24,6 +27,10 @@ export interface PluginInfo {
     url?: string;
     /** The Url provided by a Plugin */
     uri?: string;
+    /** You can put specific track information here, to transform the tracks... */
+    clientData?: {
+        [key: string]: any;
+    };
 }
 export interface LavalinkTrack {
     /** The Base 64 encoded String */
@@ -45,3 +52,4 @@ export interface UnresolvedQuery {
     /** The Track's Requester */
     requester?: unknown;
 }
+export {};

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

@@ -8,7 +8,7 @@ export declare const TrackSymbol: unique symbol;
 export declare const UnresolvedTrackSymbol: unique symbol;
 export declare const QueueSymbol: unique symbol;
 export declare const NodeSymbol: unique symbol;
-export type LavalinkSearchPlatform = "ytsearch" | "ytmsearch" | "scsearch" | "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "sprec" | "ymsearch" | "speak" | "tts";
+export type LavalinkSearchPlatform = "ytsearch" | "ytmsearch" | "scsearch" | "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "sprec" | "ymsearch" | "speak" | "tts" | "ftts";
 export type ClientSearchPlatform = "youtube" | "yt" | "yt" | "youtube music" | "youtubemusic" | "ytm" | "soundcloud" | "sc" | "am" | "apple music" | "applemusic" | "apple" | "yandex music" | "sp" | "sprec" | "spsuggestion" | "spotify" | "dz" | "deezer" | "yandex" | "yandexmusic";
 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";

package/package.json

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