lavalink-client 1.1.2 → 1.1.4

package/dist/cjs/structures/Player.js

@@ -216,7 +216,7 @@ class Player {
             source: LavalinkManagerStatics_1.DefaultSources[(typeof query === "string" ? undefined : query.source?.trim?.()?.toLowerCase?.()) ?? this.LavalinkManager.options.playerOptions.defaultSearchPlatform.toLowerCase()] ?? (typeof query === "string" ? undefined : query.source?.trim?.()?.toLowerCase?.()) ?? this.LavalinkManager.options.playerOptions.defaultSearchPlatform
         };
         // if user does player.search("ytsearch:Hello")
-        const foundSource = [...Object.keys(LavalinkManagerStatics_1.DefaultSources)].find(source => Query.query.toLowerCase().startsWith(`${source}:`.toLowerCase()))?.trim?.()?.toLowerCase?.();
+        const foundSource = Object.keys(LavalinkManagerStatics_1.DefaultSources).find(source => Query.query.toLowerCase().startsWith(`${source}:`.toLowerCase()))?.trim?.()?.toLowerCase?.();
         if (foundSource && LavalinkManagerStatics_1.DefaultSources[foundSource]) {
             Query.source = LavalinkManagerStatics_1.DefaultSources[foundSource]; // set the source to ytsearch:
             Query.query = Query.query.slice(`${foundSource}:`.length, Query.query.length); // remove ytsearch: from the query
@@ -251,13 +251,13 @@ class Player {
             source: LavalinkManagerStatics_1.DefaultSources[(typeof query === "string" ? undefined : query.source?.trim?.()?.toLowerCase?.()) ?? this.LavalinkManager.options.playerOptions.defaultSearchPlatform.toLowerCase()] ?? (typeof query === "string" ? undefined : query.source?.trim?.()?.toLowerCase?.()) ?? this.LavalinkManager.options.playerOptions.defaultSearchPlatform
         };
         // if user does player.search("ytsearch:Hello")
-        const foundSource = [...Object.keys(LavalinkManagerStatics_1.DefaultSources)].find(source => Query.query?.toLowerCase?.()?.startsWith(`${source}:`.toLowerCase()))?.trim?.()?.toLowerCase?.();
+        const foundSource = Object.keys(LavalinkManagerStatics_1.DefaultSources).find(source => Query.query?.toLowerCase?.()?.startsWith(`${source}:`.toLowerCase()))?.trim?.()?.toLowerCase?.();
         if (foundSource && LavalinkManagerStatics_1.DefaultSources[foundSource]) {
             Query.source = LavalinkManagerStatics_1.DefaultSources[foundSource]; // set the source to ytsearch:
             Query.query = Query.query.slice(`${foundSource}:`.length, Query.query.length); // remove ytsearch: from the query
         }
         if (/^https?:\/\//.test(Query.query))
-            this.LavalinkManager.utils.validatedQueryString(this.node, Query.source);
+            this.LavalinkManager.utils.validateQueryString(this.node, Query.source);
         else if (Query.source)
             this.LavalinkManager.utils.validateSourceString(this.node, Query.source);
         // 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

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

@@ -3,6 +3,18 @@ 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 LavalinkTrackInfo {
+    identifier: string;
+    title: string;
+    author: string;
+    length: number;
+    artworkUrl: string | null;
+    uri: string;
+    sourceName: SourceNames;
+    isSeekable: boolean;
+    isStream: boolean;
+    isrc: string | null;
+}
 export interface TrackInfo {
     identifier: string;
     title: string;
@@ -51,11 +63,17 @@ export interface LavalinkTrack {
     /** The Base 64 encoded String */
     encoded?: Base64;
     /** Track Information */
-    info: TrackInfo;
+    info: LavalinkTrackInfo;
     /** Plugin Information from Lavalink */
     pluginInfo: Partial<PluginInfo>;
 }
-export interface Track extends LavalinkTrack {
+export interface Track {
+    /** The Base 64 encoded String */
+    encoded?: Base64;
+    /** Track Information */
+    info: TrackInfo;
+    /** Plugin Information from Lavalink */
+    pluginInfo: Partial<PluginInfo>;
     /** The Track's Requester */
     requester?: unknown;
 }

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

@@ -2,7 +2,7 @@ import { LavalinkFilterData } from "./Filters";
 import { LavalinkManager } from "./LavalinkManager";
 import { LavalinkNode, LavalinkNodeOptions, NodeStats } from "./Node";
 import { PlayOptions, Player } from "./Player";
-import { PluginInfo, Track, UnresolvedTrack, UnresolvedQuery } from "./Track";
+import { PluginInfo, Track, UnresolvedTrack, UnresolvedQuery, LavalinkTrack } from "./Track";
 export declare const TrackSymbol: unique symbol;
 export declare const UnresolvedTrackSymbol: unique symbol;
 export declare const QueueSymbol: unique symbol;
@@ -37,13 +37,16 @@ export interface SearchResult {
     playlist: PlaylistInfo | null;
     tracks: Track[];
 }
-export interface ManagerUitls {
-    /** @private */
-    manager: LavalinkManager;
-}
 export declare class ManagerUitls {
+    LavalinkManager: LavalinkManager | null;
     constructor(LavalinkManager?: LavalinkManager);
-    buildTrack(data: any, requester: any): Track;
+    buildTrack(data: LavalinkTrack | Track, requester: unknown): Track;
+    /**
+     * Builds a UnresolvedTrack to be resolved before being played  .
+     * @param query
+     * @param requester
+     */
+    buildUnresolvedTrack(query: UnresolvedQuery | UnresolvedTrack, requester: unknown): UnresolvedTrack;
     /**
      * Validate if a data is equal to a node
      * @param data
@@ -69,15 +72,9 @@ export declare class ManagerUitls {
      * Checks if the provided argument is a valid UnresolvedTrack.
      * @param track
      */
-    isUnresolvedTrackQuery(data: UnresolvedTrack | any): boolean;
-    getClosestTrack(data: UnresolvedTrack, player: Player): Promise<Track>;
-    /**
-     * Builds a UnresolvedTrack to be resolved before being played  .
-     * @param query
-     * @param requester
-     */
-    buildUnresolvedTrack(query: UnresolvedQuery | UnresolvedTrack, requester: unknown): UnresolvedTrack;
-    validatedQueryString(node: LavalinkNode, queryString: string): void;
+    isUnresolvedTrackQuery(data: UnresolvedQuery | any): boolean;
+    getClosestTrack(data: UnresolvedTrack, player: Player): Promise<Track | undefined>;
+    validateQueryString(node: LavalinkNode, queryString: string): void;
     validateSourceString(node: LavalinkNode, sourceString: SearchPlatform): void;
 }
 /**

package/dist/cjs/structures/Utils.js

@@ -9,32 +9,32 @@ exports.NodeSymbol = Symbol("LC-Node");
 /** @hidden */
 const escapeRegExp = (str) => str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 class ManagerUitls {
+    LavalinkManager = null;
     constructor(LavalinkManager) {
-        this.manager = LavalinkManager;
+        this.LavalinkManager = LavalinkManager;
     }
     buildTrack(data, requester) {
-        const encoded = data.encoded || data.encoded;
-        if (!encoded)
-            throw new RangeError("Argument 'data.encoded' / 'data.encoded' / 'data.track' must be present.");
+        if (!data?.encoded || typeof data.encoded !== "string")
+            throw new RangeError("Argument 'data.encoded' must be present.");
         if (!data.info)
-            data.info = {};
+            throw new RangeError("Argument 'data.info' must be present.");
         try {
             const r = {
-                encoded,
+                encoded: data.encoded,
                 info: {
-                    identifier: data.info?.identifier,
-                    title: data.info?.title,
-                    author: data.info?.author,
-                    duration: data.info?.length || data.info?.duration,
-                    artworkUrl: data.info?.artworkUrl || data.pluginInfo?.artworkUrl || data.plugin?.artworkUrl,
-                    uri: data.info?.uri,
-                    sourceName: data.info?.sourceName,
-                    isSeekable: data.info?.isSeekable,
-                    isStream: data.info?.isStream,
-                    isrc: data.info?.isrc,
+                    identifier: data.info.identifier,
+                    title: data.info.title,
+                    author: data.info.author,
+                    duration: data.info.length || data.info.duration,
+                    artworkUrl: data.info.artworkUrl || data.pluginInfo?.artworkUrl || data.plugin?.artworkUrl,
+                    uri: data.info.uri,
+                    sourceName: data.info.sourceName,
+                    isSeekable: data.info.isSeekable,
+                    isStream: data.info.isStream,
+                    isrc: data.info.isrc,
                 },
                 pluginInfo: data.pluginInfo || data.plugin || {},
-                requester: typeof this.manager.options?.playerOptions?.requesterTransformer === "function" ? this.manager.options?.playerOptions?.requesterTransformer(data?.requester || requester) : requester,
+                requester: typeof this.LavalinkManager?.options?.playerOptions?.requesterTransformer === "function" ? this.LavalinkManager?.options?.playerOptions?.requesterTransformer(data?.requester || requester) : requester,
             };
             Object.defineProperty(r, exports.TrackSymbol, { configurable: true, value: true });
             return r;
@@ -43,6 +43,32 @@ class ManagerUitls {
             throw new RangeError(`Argument "data" is not a valid track: ${error.message}`);
         }
     }
+    /**
+     * Builds a UnresolvedTrack to be resolved before being played  .
+     * @param query
+     * @param requester
+     */
+    buildUnresolvedTrack(query, requester) {
+        if (typeof query === "undefined")
+            throw new RangeError('Argument "query" must be present.');
+        const unresolvedTrack = {
+            encoded: query.encoded || undefined,
+            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);
+                if (!closest)
+                    throw new SyntaxError("No closest Track found");
+                Object.getOwnPropertyNames(this).forEach(prop => delete this[prop]);
+                Object.assign(this, closest);
+                return;
+            }
+        };
+        if (!this.isUnresolvedTrack(unresolvedTrack))
+            throw SyntaxError("Could not build Unresolved Track");
+        Object.defineProperty(unresolvedTrack, exports.UnresolvedTrackSymbol, { configurable: true, value: true });
+        return unresolvedTrack;
+    }
     /**
      * Validate if a data is equal to a node
      * @param data
@@ -112,7 +138,7 @@ class ManagerUitls {
             return false;
         if (data[exports.UnresolvedTrackSymbol] === true)
             return true;
-        return typeof data === "object" && "info" in data && typeof data.info.title === "string" && typeof data.resolve === "function";
+        return typeof data === "object" && (("info" in data && typeof data.info.title === "string") || typeof data.encoded === "string") && typeof data.resolve === "function";
     }
     /**
      * Checks if the provided argument is a valid UnresolvedTrack.
@@ -124,31 +150,7 @@ class ManagerUitls {
     async getClosestTrack(data, player) {
         return getClosestTrack(data, player, this);
     }
-    /**
-     * Builds a UnresolvedTrack to be resolved before being played  .
-     * @param query
-     * @param requester
-     */
-    buildUnresolvedTrack(query, requester) {
-        if (typeof query === "undefined")
-            throw new RangeError('Argument "query" must be present.');
-        const unresolvedTrack = {
-            encoded: query.encoded || undefined,
-            info: query.info ?? query,
-            requester: typeof this.manager.options?.playerOptions?.requesterTransformer === "function" ? this.manager.options?.playerOptions?.requesterTransformer((query?.requester || requester)) : requester,
-            async resolve(player) {
-                const closest = await getClosestTrack(this, player, player.LavalinkManager.utils);
-                if (!closest)
-                    throw new SyntaxError("No closest Track found");
-                Object.getOwnPropertyNames(this).forEach(prop => delete this[prop]);
-                Object.assign(this, closest);
-                return;
-            }
-        };
-        Object.defineProperty(unresolvedTrack, exports.UnresolvedTrackSymbol, { configurable: true, value: true });
-        return unresolvedTrack;
-    }
-    validatedQueryString(node, queryString) {
+    validateQueryString(node, queryString) {
         if (!node.info)
             throw new Error("No Lavalink Node was provided");
         if (!node.info.sourceManagers?.length)
@@ -195,7 +197,7 @@ class ManagerUitls {
     validateSourceString(node, sourceString) {
         if (!sourceString)
             throw new Error(`No SourceString was provided`);
-        const source = LavalinkManagerStatics_1.DefaultSources[sourceString.toLowerCase()] || Object.values(LavalinkManagerStatics_1.DefaultSources).find(v => v.toLowerCase() === sourceString?.toLowerCase());
+        const source = LavalinkManagerStatics_1.DefaultSources[sourceString.toLowerCase()] || Object.keys(LavalinkManagerStatics_1.DefaultSources).find(v => v.toLowerCase() === sourceString?.toLowerCase());
         if (!source)
             throw new Error(`Lavalink Node SearchQuerySource: '${sourceString}' is not available`);
         if (source === "amsearch" && !node.info.sourceManagers.includes("applemusic")) {
@@ -292,7 +294,7 @@ exports.queueTrackEnd = queueTrackEnd;
 async function applyUnresolvedData(resTrack, data, utils) {
     if (!resTrack?.info || !data?.info)
         return;
-    if (utils.manager.options.playerOptions?.useUnresolvedData === true) { // overwrite values
+    if (utils?.LavalinkManager?.options?.playerOptions?.useUnresolvedData === true) { // overwrite values
         if (data.info.uri)
             resTrack.info.uri = data.info.uri;
         if (data.info.artworkUrl?.length)
@@ -322,8 +324,8 @@ async function getClosestTrack(data, player, utils) {
         return utils.buildTrack(data, data.requester);
     if (!utils.isUnresolvedTrack(data))
         throw new RangeError("Track is not an unresolved Track");
-    if (!data?.info?.title)
-        throw new SyntaxError("the track title is required for unresolved tracks");
+    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");
     if (!data.requester)
         throw new SyntaxError("The requester is required");
     // try to decode the track, if possible

package/dist/esm/structures/Player.js

@@ -213,7 +213,7 @@ export class Player {
             source: DefaultSources[(typeof query === "string" ? undefined : query.source?.trim?.()?.toLowerCase?.()) ?? this.LavalinkManager.options.playerOptions.defaultSearchPlatform.toLowerCase()] ?? (typeof query === "string" ? undefined : query.source?.trim?.()?.toLowerCase?.()) ?? this.LavalinkManager.options.playerOptions.defaultSearchPlatform
         };
         // if user does player.search("ytsearch:Hello")
-        const foundSource = [...Object.keys(DefaultSources)].find(source => Query.query.toLowerCase().startsWith(`${source}:`.toLowerCase()))?.trim?.()?.toLowerCase?.();
+        const foundSource = Object.keys(DefaultSources).find(source => Query.query.toLowerCase().startsWith(`${source}:`.toLowerCase()))?.trim?.()?.toLowerCase?.();
         if (foundSource && DefaultSources[foundSource]) {
             Query.source = DefaultSources[foundSource]; // set the source to ytsearch:
             Query.query = Query.query.slice(`${foundSource}:`.length, Query.query.length); // remove ytsearch: from the query
@@ -248,13 +248,13 @@ export class Player {
             source: DefaultSources[(typeof query === "string" ? undefined : query.source?.trim?.()?.toLowerCase?.()) ?? this.LavalinkManager.options.playerOptions.defaultSearchPlatform.toLowerCase()] ?? (typeof query === "string" ? undefined : query.source?.trim?.()?.toLowerCase?.()) ?? this.LavalinkManager.options.playerOptions.defaultSearchPlatform
         };
         // if user does player.search("ytsearch:Hello")
-        const foundSource = [...Object.keys(DefaultSources)].find(source => Query.query?.toLowerCase?.()?.startsWith(`${source}:`.toLowerCase()))?.trim?.()?.toLowerCase?.();
+        const foundSource = Object.keys(DefaultSources).find(source => Query.query?.toLowerCase?.()?.startsWith(`${source}:`.toLowerCase()))?.trim?.()?.toLowerCase?.();
         if (foundSource && DefaultSources[foundSource]) {
             Query.source = DefaultSources[foundSource]; // set the source to ytsearch:
             Query.query = Query.query.slice(`${foundSource}:`.length, Query.query.length); // remove ytsearch: from the query
         }
         if (/^https?:\/\//.test(Query.query))
-            this.LavalinkManager.utils.validatedQueryString(this.node, Query.source);
+            this.LavalinkManager.utils.validateQueryString(this.node, Query.source);
         else if (Query.source)
             this.LavalinkManager.utils.validateSourceString(this.node, Query.source);
         // 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

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

@@ -3,6 +3,18 @@ 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 LavalinkTrackInfo {
+    identifier: string;
+    title: string;
+    author: string;
+    length: number;
+    artworkUrl: string | null;
+    uri: string;
+    sourceName: SourceNames;
+    isSeekable: boolean;
+    isStream: boolean;
+    isrc: string | null;
+}
 export interface TrackInfo {
     identifier: string;
     title: string;
@@ -51,11 +63,17 @@ export interface LavalinkTrack {
     /** The Base 64 encoded String */
     encoded?: Base64;
     /** Track Information */
-    info: TrackInfo;
+    info: LavalinkTrackInfo;
     /** Plugin Information from Lavalink */
     pluginInfo: Partial<PluginInfo>;
 }
-export interface Track extends LavalinkTrack {
+export interface Track {
+    /** The Base 64 encoded String */
+    encoded?: Base64;
+    /** Track Information */
+    info: TrackInfo;
+    /** Plugin Information from Lavalink */
+    pluginInfo: Partial<PluginInfo>;
     /** The Track's Requester */
     requester?: unknown;
 }

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

@@ -2,7 +2,7 @@ import { LavalinkFilterData } from "./Filters";
 import { LavalinkManager } from "./LavalinkManager";
 import { LavalinkNode, LavalinkNodeOptions, NodeStats } from "./Node";
 import { PlayOptions, Player } from "./Player";
-import { PluginInfo, Track, UnresolvedTrack, UnresolvedQuery } from "./Track";
+import { PluginInfo, Track, UnresolvedTrack, UnresolvedQuery, LavalinkTrack } from "./Track";
 export declare const TrackSymbol: unique symbol;
 export declare const UnresolvedTrackSymbol: unique symbol;
 export declare const QueueSymbol: unique symbol;
@@ -37,13 +37,16 @@ export interface SearchResult {
     playlist: PlaylistInfo | null;
     tracks: Track[];
 }
-export interface ManagerUitls {
-    /** @private */
-    manager: LavalinkManager;
-}
 export declare class ManagerUitls {
+    LavalinkManager: LavalinkManager | null;
     constructor(LavalinkManager?: LavalinkManager);
-    buildTrack(data: any, requester: any): Track;
+    buildTrack(data: LavalinkTrack | Track, requester: unknown): Track;
+    /**
+     * Builds a UnresolvedTrack to be resolved before being played  .
+     * @param query
+     * @param requester
+     */
+    buildUnresolvedTrack(query: UnresolvedQuery | UnresolvedTrack, requester: unknown): UnresolvedTrack;
     /**
      * Validate if a data is equal to a node
      * @param data
@@ -69,15 +72,9 @@ export declare class ManagerUitls {
      * Checks if the provided argument is a valid UnresolvedTrack.
      * @param track
      */
-    isUnresolvedTrackQuery(data: UnresolvedTrack | any): boolean;
-    getClosestTrack(data: UnresolvedTrack, player: Player): Promise<Track>;
-    /**
-     * Builds a UnresolvedTrack to be resolved before being played  .
-     * @param query
-     * @param requester
-     */
-    buildUnresolvedTrack(query: UnresolvedQuery | UnresolvedTrack, requester: unknown): UnresolvedTrack;
-    validatedQueryString(node: LavalinkNode, queryString: string): void;
+    isUnresolvedTrackQuery(data: UnresolvedQuery | any): boolean;
+    getClosestTrack(data: UnresolvedTrack, player: Player): Promise<Track | undefined>;
+    validateQueryString(node: LavalinkNode, queryString: string): void;
     validateSourceString(node: LavalinkNode, sourceString: SearchPlatform): void;
 }
 /**

package/dist/esm/structures/Utils.js

@@ -6,32 +6,32 @@ export const NodeSymbol = Symbol("LC-Node");
 /** @hidden */
 const escapeRegExp = (str) => str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 export class ManagerUitls {
+    LavalinkManager = null;
     constructor(LavalinkManager) {
-        this.manager = LavalinkManager;
+        this.LavalinkManager = LavalinkManager;
     }
     buildTrack(data, requester) {
-        const encoded = data.encoded || data.encoded;
-        if (!encoded)
-            throw new RangeError("Argument 'data.encoded' / 'data.encoded' / 'data.track' must be present.");
+        if (!data?.encoded || typeof data.encoded !== "string")
+            throw new RangeError("Argument 'data.encoded' must be present.");
         if (!data.info)
-            data.info = {};
+            throw new RangeError("Argument 'data.info' must be present.");
         try {
             const r = {
-                encoded,
+                encoded: data.encoded,
                 info: {
-                    identifier: data.info?.identifier,
-                    title: data.info?.title,
-                    author: data.info?.author,
-                    duration: data.info?.length || data.info?.duration,
-                    artworkUrl: data.info?.artworkUrl || data.pluginInfo?.artworkUrl || data.plugin?.artworkUrl,
-                    uri: data.info?.uri,
-                    sourceName: data.info?.sourceName,
-                    isSeekable: data.info?.isSeekable,
-                    isStream: data.info?.isStream,
-                    isrc: data.info?.isrc,
+                    identifier: data.info.identifier,
+                    title: data.info.title,
+                    author: data.info.author,
+                    duration: data.info.length || data.info.duration,
+                    artworkUrl: data.info.artworkUrl || data.pluginInfo?.artworkUrl || data.plugin?.artworkUrl,
+                    uri: data.info.uri,
+                    sourceName: data.info.sourceName,
+                    isSeekable: data.info.isSeekable,
+                    isStream: data.info.isStream,
+                    isrc: data.info.isrc,
                 },
                 pluginInfo: data.pluginInfo || data.plugin || {},
-                requester: typeof this.manager.options?.playerOptions?.requesterTransformer === "function" ? this.manager.options?.playerOptions?.requesterTransformer(data?.requester || requester) : requester,
+                requester: typeof this.LavalinkManager?.options?.playerOptions?.requesterTransformer === "function" ? this.LavalinkManager?.options?.playerOptions?.requesterTransformer(data?.requester || requester) : requester,
             };
             Object.defineProperty(r, TrackSymbol, { configurable: true, value: true });
             return r;
@@ -40,6 +40,32 @@ export class ManagerUitls {
             throw new RangeError(`Argument "data" is not a valid track: ${error.message}`);
         }
     }
+    /**
+     * Builds a UnresolvedTrack to be resolved before being played  .
+     * @param query
+     * @param requester
+     */
+    buildUnresolvedTrack(query, requester) {
+        if (typeof query === "undefined")
+            throw new RangeError('Argument "query" must be present.');
+        const unresolvedTrack = {
+            encoded: query.encoded || undefined,
+            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);
+                if (!closest)
+                    throw new SyntaxError("No closest Track found");
+                Object.getOwnPropertyNames(this).forEach(prop => delete this[prop]);
+                Object.assign(this, closest);
+                return;
+            }
+        };
+        if (!this.isUnresolvedTrack(unresolvedTrack))
+            throw SyntaxError("Could not build Unresolved Track");
+        Object.defineProperty(unresolvedTrack, UnresolvedTrackSymbol, { configurable: true, value: true });
+        return unresolvedTrack;
+    }
     /**
      * Validate if a data is equal to a node
      * @param data
@@ -109,7 +135,7 @@ export class ManagerUitls {
             return false;
         if (data[UnresolvedTrackSymbol] === true)
             return true;
-        return typeof data === "object" && "info" in data && typeof data.info.title === "string" && typeof data.resolve === "function";
+        return typeof data === "object" && (("info" in data && typeof data.info.title === "string") || typeof data.encoded === "string") && typeof data.resolve === "function";
     }
     /**
      * Checks if the provided argument is a valid UnresolvedTrack.
@@ -121,31 +147,7 @@ export class ManagerUitls {
     async getClosestTrack(data, player) {
         return getClosestTrack(data, player, this);
     }
-    /**
-     * Builds a UnresolvedTrack to be resolved before being played  .
-     * @param query
-     * @param requester
-     */
-    buildUnresolvedTrack(query, requester) {
-        if (typeof query === "undefined")
-            throw new RangeError('Argument "query" must be present.');
-        const unresolvedTrack = {
-            encoded: query.encoded || undefined,
-            info: query.info ?? query,
-            requester: typeof this.manager.options?.playerOptions?.requesterTransformer === "function" ? this.manager.options?.playerOptions?.requesterTransformer((query?.requester || requester)) : requester,
-            async resolve(player) {
-                const closest = await getClosestTrack(this, player, player.LavalinkManager.utils);
-                if (!closest)
-                    throw new SyntaxError("No closest Track found");
-                Object.getOwnPropertyNames(this).forEach(prop => delete this[prop]);
-                Object.assign(this, closest);
-                return;
-            }
-        };
-        Object.defineProperty(unresolvedTrack, UnresolvedTrackSymbol, { configurable: true, value: true });
-        return unresolvedTrack;
-    }
-    validatedQueryString(node, queryString) {
+    validateQueryString(node, queryString) {
         if (!node.info)
             throw new Error("No Lavalink Node was provided");
         if (!node.info.sourceManagers?.length)
@@ -192,7 +194,7 @@ export class ManagerUitls {
     validateSourceString(node, sourceString) {
         if (!sourceString)
             throw new Error(`No SourceString was provided`);
-        const source = DefaultSources[sourceString.toLowerCase()] || Object.values(DefaultSources).find(v => v.toLowerCase() === sourceString?.toLowerCase());
+        const source = DefaultSources[sourceString.toLowerCase()] || Object.keys(DefaultSources).find(v => v.toLowerCase() === sourceString?.toLowerCase());
         if (!source)
             throw new Error(`Lavalink Node SearchQuerySource: '${sourceString}' is not available`);
         if (source === "amsearch" && !node.info.sourceManagers.includes("applemusic")) {
@@ -286,7 +288,7 @@ export async function queueTrackEnd(player) {
 async function applyUnresolvedData(resTrack, data, utils) {
     if (!resTrack?.info || !data?.info)
         return;
-    if (utils.manager.options.playerOptions?.useUnresolvedData === true) { // overwrite values
+    if (utils?.LavalinkManager?.options?.playerOptions?.useUnresolvedData === true) { // overwrite values
         if (data.info.uri)
             resTrack.info.uri = data.info.uri;
         if (data.info.artworkUrl?.length)
@@ -316,8 +318,8 @@ async function getClosestTrack(data, player, utils) {
         return utils.buildTrack(data, data.requester);
     if (!utils.isUnresolvedTrack(data))
         throw new RangeError("Track is not an unresolved Track");
-    if (!data?.info?.title)
-        throw new SyntaxError("the track title is required for unresolved tracks");
+    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");
     if (!data.requester)
         throw new SyntaxError("The requester is required");
     // try to decode the track, if possible

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

@@ -3,6 +3,18 @@ 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 LavalinkTrackInfo {
+    identifier: string;
+    title: string;
+    author: string;
+    length: number;
+    artworkUrl: string | null;
+    uri: string;
+    sourceName: SourceNames;
+    isSeekable: boolean;
+    isStream: boolean;
+    isrc: string | null;
+}
 export interface TrackInfo {
     identifier: string;
     title: string;
@@ -51,11 +63,17 @@ export interface LavalinkTrack {
     /** The Base 64 encoded String */
     encoded?: Base64;
     /** Track Information */
-    info: TrackInfo;
+    info: LavalinkTrackInfo;
     /** Plugin Information from Lavalink */
     pluginInfo: Partial<PluginInfo>;
 }
-export interface Track extends LavalinkTrack {
+export interface Track {
+    /** The Base 64 encoded String */
+    encoded?: Base64;
+    /** Track Information */
+    info: TrackInfo;
+    /** Plugin Information from Lavalink */
+    pluginInfo: Partial<PluginInfo>;
     /** The Track's Requester */
     requester?: unknown;
 }

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

@@ -2,7 +2,7 @@ import { LavalinkFilterData } from "./Filters";
 import { LavalinkManager } from "./LavalinkManager";
 import { LavalinkNode, LavalinkNodeOptions, NodeStats } from "./Node";
 import { PlayOptions, Player } from "./Player";
-import { PluginInfo, Track, UnresolvedTrack, UnresolvedQuery } from "./Track";
+import { PluginInfo, Track, UnresolvedTrack, UnresolvedQuery, LavalinkTrack } from "./Track";
 export declare const TrackSymbol: unique symbol;
 export declare const UnresolvedTrackSymbol: unique symbol;
 export declare const QueueSymbol: unique symbol;
@@ -37,13 +37,16 @@ export interface SearchResult {
     playlist: PlaylistInfo | null;
     tracks: Track[];
 }
-export interface ManagerUitls {
-    /** @private */
-    manager: LavalinkManager;
-}
 export declare class ManagerUitls {
+    LavalinkManager: LavalinkManager | null;
     constructor(LavalinkManager?: LavalinkManager);
-    buildTrack(data: any, requester: any): Track;
+    buildTrack(data: LavalinkTrack | Track, requester: unknown): Track;
+    /**
+     * Builds a UnresolvedTrack to be resolved before being played  .
+     * @param query
+     * @param requester
+     */
+    buildUnresolvedTrack(query: UnresolvedQuery | UnresolvedTrack, requester: unknown): UnresolvedTrack;
     /**
      * Validate if a data is equal to a node
      * @param data
@@ -69,15 +72,9 @@ export declare class ManagerUitls {
      * Checks if the provided argument is a valid UnresolvedTrack.
      * @param track
      */
-    isUnresolvedTrackQuery(data: UnresolvedTrack | any): boolean;
-    getClosestTrack(data: UnresolvedTrack, player: Player): Promise<Track>;
-    /**
-     * Builds a UnresolvedTrack to be resolved before being played  .
-     * @param query
-     * @param requester
-     */
-    buildUnresolvedTrack(query: UnresolvedQuery | UnresolvedTrack, requester: unknown): UnresolvedTrack;
-    validatedQueryString(node: LavalinkNode, queryString: string): void;
+    isUnresolvedTrackQuery(data: UnresolvedQuery | any): boolean;
+    getClosestTrack(data: UnresolvedTrack, player: Player): Promise<Track | undefined>;
+    validateQueryString(node: LavalinkNode, queryString: string): void;
     validateSourceString(node: LavalinkNode, sourceString: SearchPlatform): void;
 }
 /**

package/package.json

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