lavalink-client 1.2.5 → 2.0.0

package/dist/esm/structures/Player.js

@@ -119,15 +119,38 @@ export class Player {
      * Play the next track from the queue / a specific track, with playoptions for Lavalink
      * @param options
      */
-    async play(options) {
+    async play(options = {}) {
         if (this.get("internal_queueempty")) {
             clearTimeout(this.get("internal_queueempty"));
             this.set("internal_queueempty", undefined);
         }
-        if (options?.track && (this.LavalinkManager.utils.isTrack(options?.track) || this.LavalinkManager.utils.isUnresolvedTrack(options.track))) {
-            if (this.LavalinkManager.utils.isUnresolvedTrack(options.track))
-                await options.track.resolve(this);
-            await this.queue.add(options?.track, 0);
+        // if clientTrack provided, play it
+        if (options?.clientTrack && (this.LavalinkManager.utils.isTrack(options?.clientTrack) || this.LavalinkManager.utils.isUnresolvedTrack(options.clientTrack))) {
+            if (this.LavalinkManager.utils.isUnresolvedTrack(options.clientTrack))
+                await options.clientTrack.resolve(this);
+            if (typeof options.track.userData === "object")
+                options.clientTrack.userData = { ...(options?.clientTrack.userData || {}), ...(options.track.userData || {}) };
+            await this.queue.add(options?.clientTrack, 0);
+            await queueTrackEnd(this);
+        }
+        else if (options?.track?.encoded) {
+            // handle play encoded options manually // TODO let it resolve by lavalink!
+            const track = await this.node.decode.singleTrack(options.track?.encoded, options.track?.requester || this.queue?.current?.requester || this.queue.previous?.[0]?.requester || this.queue.tracks?.[0]?.requester || this.LavalinkManager.options.client);
+            if (typeof options.track.userData === "object")
+                track.userData = { ...(track.userData || {}), ...(options.track.userData || {}) };
+            if (track)
+                this.queue.add(track, 0);
+            await queueTrackEnd(this);
+        }
+        else if (options?.track?.identifier) {
+            // handle play identifier options manually // TODO let it resolve by lavalink!
+            const res = await this.search({
+                query: options?.track?.identifier
+            }, options?.track?.identifier || this.queue?.current?.requester || this.queue.previous?.[0]?.requester || this.queue.tracks?.[0]?.requester || this.LavalinkManager.options.client);
+            if (typeof options.track.userData === "object")
+                res.tracks[0].userData = { ...(res.tracks[0].userData || {}), ...(options.track.userData || {}) };
+            if (res.tracks[0])
+                this.queue.add(res.tracks[0], 0);
             await queueTrackEnd(this);
         }
         if (!this.queue.current && this.queue.tracks.length)
@@ -136,20 +159,22 @@ export class Player {
             try {
                 // resolve the unresolved track
                 await this.queue.current.resolve(this);
+                if (typeof options.track.userData === "object")
+                    this.queue.current.userData = { ...(this.queue.current.userData || {}), ...(options.track.userData || {}) };
             }
             catch (error) {
                 this.LavalinkManager.emit("trackError", this, this.queue.current, error);
+                if (options && "clientTrack" in options)
+                    delete options.clientTrack;
                 if (options && "track" in options)
                     delete options.track;
-                if (options && "encodedTrack" in options)
-                    delete options.encodedTrack;
-                if (this.queue.tracks[0])
+                // try to play the next track if possible
+                if (this.LavalinkManager.options?.autoSkipOnResolveError === true && this.queue.tracks[0])
                     return this.play(options);
                 return this;
             }
         }
-        const track = this.queue.current;
-        if (!track)
+        if (!this.queue.current)
             throw new Error(`There is no Track in the Queue, nor provided in the PlayOptions`);
         if (typeof options?.volume === "number" && !isNaN(options?.volume)) {
             this.volume = Math.max(Math.min(options?.volume, 500), 0);
@@ -159,24 +184,27 @@ export class Player {
             this.lavalinkVolume = Math.round(vol);
             options.volume = this.lavalinkVolume;
         }
-        const finalOptions = {
-            encodedTrack: track.encoded,
+        const finalOptions = Object.fromEntries(Object.entries({
+            track: {
+                encoded: this.queue.current?.encoded || null,
+                // identifier: options.identifier,
+                userData: options?.track?.userData || {},
+            },
             volume: this.lavalinkVolume,
-            position: 0,
-            ...options,
-        };
-        if ("track" in finalOptions)
-            delete finalOptions.track;
-        if ((typeof finalOptions.position !== "undefined" && isNaN(finalOptions.position)) || (typeof finalOptions.position === "number" && (finalOptions.position < 0 || finalOptions.position >= track.info.duration)))
+            position: options?.position ?? 0,
+            endTime: options?.endTime ?? undefined,
+            filters: options?.filters ?? undefined,
+            paused: options?.paused ?? undefined,
+            voice: options?.voice ?? undefined
+        }).filter(v => typeof v[1] !== "undefined"));
+        if ((typeof finalOptions.position !== "undefined" && isNaN(finalOptions.position)) || (typeof finalOptions.position === "number" && (finalOptions.position < 0 || finalOptions.position >= this.queue.current.info.duration)))
             throw new Error("PlayerOption#position must be a positive number, less than track's duration");
         if ((typeof finalOptions.volume !== "undefined" && isNaN(finalOptions.volume) || (typeof finalOptions.volume === "number" && finalOptions.volume < 0)))
             throw new Error("PlayerOption#volume must be a positive number");
-        if ((typeof finalOptions.endTime !== "undefined" && isNaN(finalOptions.endTime)) || (typeof finalOptions.endTime === "number" && (finalOptions.endTime < 0 || finalOptions.endTime >= track.info.duration)))
+        if ((typeof finalOptions.endTime !== "undefined" && isNaN(finalOptions.endTime)) || (typeof finalOptions.endTime === "number" && (finalOptions.endTime < 0 || finalOptions.endTime >= this.queue.current.info.duration)))
             throw new Error("PlayerOption#endTime must be a positive number, less than track's duration");
         if (typeof finalOptions.position === "number" && typeof finalOptions.endTime === "number" && finalOptions.endTime < finalOptions.position)
             throw new Error("PlayerOption#endTime must be bigger than PlayerOption#position");
-        if ("noReplace" in finalOptions)
-            delete finalOptions.noReplace;
         const now = performance.now();
         await this.node.updatePlayer({
             guildId: this.guildId,
@@ -302,7 +330,7 @@ export class Player {
         if (!this.playing)
             return await this.play();
         const now = performance.now();
-        await this.node.updatePlayer({ guildId: this.guildId, playerOptions: { encodedTrack: null } });
+        await this.node.updatePlayer({ guildId: this.guildId, playerOptions: { track: { encoded: null } } });
         this.ping.lavalink = Math.round((performance.now() - now) / 10) / 100;
         return this;
     }
@@ -322,7 +350,7 @@ export class Player {
             this.set("internal_autoplayStopPlaying", undefined);
         const now = performance.now();
         // send to lavalink, that it should stop playing
-        await this.node.updatePlayer({ guildId: this.guildId, playerOptions: { encodedTrack: null } });
+        await this.node.updatePlayer({ guildId: this.guildId, playerOptions: { track: { encoded: null } } });
         this.ping.lavalink = Math.round((performance.now() - now) / 10) / 100;
         return this;
     }

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

@@ -1,4 +1,4 @@
-import { Player } from "./Player";
+import { anyObject, Player } from "./Player";
 import { Base64 } from "./Utils";
 /** Sourcenames provided by lavalink server */
 export type LavalinkSourceNames = "youtube" | "youtubemusic" | "soundcloud" | "bandcamp" | "twitch";
@@ -89,6 +89,8 @@ export interface LavalinkTrack {
     info: LavalinkTrackInfo;
     /** Plugin Information from Lavalink */
     pluginInfo: Partial<PluginInfo>;
+    /** The userData Object from when you provide to the lavalink request */
+    userData?: anyObject;
 }
 export interface Track {
     /** The Base 64 encoded String */
@@ -99,6 +101,8 @@ export interface Track {
     pluginInfo: Partial<PluginInfo>;
     /** The Track's Requester */
     requester?: unknown;
+    /** The userData Object from when you provide to the lavalink request */
+    userData?: anyObject;
 }
 export interface UnresolvedTrackInfo extends Partial<TrackInfo> {
     /** Required */
@@ -117,6 +121,8 @@ export interface UnresolvedTrack {
     info: UnresolvedTrackInfo;
     /** Plugin Information from Lavalink */
     pluginInfo: Partial<PluginInfo>;
+    /** The userData Object from when you provide to the lavalink request */
+    userData?: anyObject;
     /** The Track's Requester */
     requester?: unknown;
 }

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

@@ -1,7 +1,7 @@
 import { LavalinkFilterData } from "./Filters";
 import { LavalinkManager } from "./LavalinkManager";
 import { LavalinkNode, LavalinkNodeOptions, NodeStats } from "./Node";
-import { Player, PlayOptions } from "./Player";
+import { LavalinkPlayOptions, Player } from "./Player";
 import { LavalinkTrack, PluginInfo, Track, UnresolvedQuery, UnresolvedTrack } from "./Track";
 export declare const TrackSymbol: unique symbol;
 export declare const UnresolvedTrackSymbol: unique symbol;
@@ -247,17 +247,29 @@ export type State = "CONNECTED" | "CONNECTING" | "DISCONNECTED" | "DISCONNECTING
 export type PlayerEventType = "TrackStartEvent" | "TrackEndEvent" | "TrackExceptionEvent" | "TrackStuckEvent" | "WebSocketClosedEvent" | SponsorBlockSegmentEventType;
 export type TrackEndReason = "finished" | "loadFailed" | "stopped" | "replaced" | "cleanup";
 export interface InvalidLavalinkRestRequest {
+    /** Rest Request Data for when it was made */
     timestamp: number;
+    /** Status of the request */
     status: number;
+    /** Specific Errro which was sent */
     error: string;
+    /** Specific Message which was created */
     message?: string;
+    /** The specific error trace from the request */
+    trace?: unknown;
+    /** Path of where it's from */
     path: string;
 }
 export interface LavalinkPlayerVoice {
+    /** The Voice Token */
     token: string;
+    /** The Voice Server Endpoint  */
     endpoint: string;
+    /** The Voice SessionId */
     sessionId: string;
+    /** Wether or not the player is connected */
     connected?: boolean;
+    /** The Ping to the voice server */
     ping?: number;
 }
 export interface LavalinkPlayerVoiceOptions extends Omit<LavalinkPlayerVoice, 'connected' | 'ping'> {
@@ -296,84 +308,121 @@ export interface RoutePlanner {
     };
 }
 export interface Session {
+    /** Wether or not session is resuming or not */
     resuming: boolean;
+    /** For how long a session is lasting while not connected */
     timeout: number;
 }
 export interface GuildShardPayload {
     /** The OP code */
     op: number;
+    /** Data to send  */
     d: {
+        /** Guild id to apply voice settings */
         guild_id: string;
+        /** channel to move/connect to, or null to leave it */
         channel_id: string | null;
+        /** wether or not mute yourself */
         self_mute: boolean;
+        /** wether or not deafen yourself */
         self_deaf: boolean;
     };
 }
 export interface PlayerUpdateInfo {
+    /** guild id of the player */
     guildId: string;
-    playerOptions: PlayOptions;
+    /** Player options to provide to lavalink */
+    playerOptions: LavalinkPlayOptions;
+    /** Whether or not replace the current track with the new one (true is recommended) */
     noReplace?: boolean;
 }
 export interface LavalinkPlayer {
+    /** Guild Id of the player */
     guildId: string;
-    track?: {
-        encoded?: string;
-        info: {
-            identifier: string;
-            title: string;
-            author: string;
-            length: number;
-            artworkUrl: string | null;
-            uri: string;
-            sourceName: string;
-            isSeekable: boolean;
-            isStream: boolean;
-            isrc: string | null;
-            position?: number;
-        };
-    };
+    /** IF playing a track, all of the track information */
+    track?: LavalinkTrack;
+    /** Lavalink volume (mind volumedecrementer) */
     volume: number;
+    /** Wether it's paused or not */
     paused: boolean;
+    /** Voice Endpoint data */
     voice: LavalinkPlayerVoice;
+    /** All Audio Filters */
     filters: Partial<LavalinkFilterData>;
+    /** Lavalink-Voice-State Variables */
+    state: {
+        /** Time since connection established */
+        time: number;
+        /** Position of the track */
+        position: number;
+        /** COnnected or not */
+        connected: boolean;
+        /** Ping to voice server */
+        ping: number;
+    };
 }
 export interface ChannelDeletePacket {
+    /** Packet key for channel delete */
     t: "CHANNEL_DELETE";
+    /** data which is sent and relevant */
     d: {
+        /** guild id */
         guild_id: string;
+        /** Channel id */
         id: string;
     };
 }
 export interface VoiceState {
+    /** OP key from lavalink */
     op: "voiceUpdate";
+    /** GuildId provided by lavalink */
     guildId: string;
+    /** Event data */
     event: VoiceServer;
+    /** Session Id of the voice connection */
     sessionId?: string;
+    /** guild id of the voice channel */
     guild_id: string;
+    /** user id from the voice connection */
     user_id: string;
+    /** Session Id of the voice connection */
     session_id: string;
+    /** Voice Channel Id */
     channel_id: string;
 }
+/** The Base64 decodes tring by lavalink */
 export type Base64 = string;
 export interface VoiceServer {
+    /** Voice Token */
     token: string;
+    /** Guild Id of the voice server connection */
     guild_id: string;
+    /** Server Endpoint */
     endpoint: string;
 }
 export interface VoicePacket {
+    /** Voice Packet Keys to send */
     t?: "VOICE_SERVER_UPDATE" | "VOICE_STATE_UPDATE";
+    /** Voice Packets to send */
     d: VoiceState | VoiceServer;
 }
 export interface NodeMessage extends NodeStats {
+    /** The type of the event */
     type: PlayerEventType;
+    /** what ops are applying to that event */
     op: "stats" | "playerUpdate" | "event";
+    /** The specific guild id for that message */
     guildId: string;
 }
 export declare function queueTrackEnd(player: Player): Promise<Track>;
+/** Specific types to filter for lavasearch, will be filtered to correct types */
 export type LavaSearchType = "track" | "album" | "artist" | "playlist" | "text" | "tracks" | "albums" | "artists" | "playlists" | "texts";
 export interface LavaSearchFilteredResponse {
+    /** The Information of a playlist provided by lavasearch */
     info: PlaylistInfo;
+    /** additional plugin information */
     pluginInfo: PluginInfo;
+    /** List of tracks  */
     tracks: Track[];
 }
 export interface LavaSearchResponse {
@@ -393,13 +442,20 @@ export interface LavaSearchResponse {
     /** Addition result data provided by plugins */
     pluginInfo: PluginInfo;
 }
+/** SearchQuery Object for raw lavalink requests */
 export type SearchQuery = {
+    /** lavalink search Query / identifier string */
     query: string;
+    /** Source to append to the search query string */
     source?: SearchPlatform;
-} | string;
+} | /** Our just the search query / identifier string */ string;
+/** SearchQuery Object for Lavalink LavaSearch Plugin requests */
 export type LavaSearchQuery = {
+    /** lavalink search Query / identifier string */
     query: string;
+    /** Source to append to the search query string */
     source: LavaSrcSearchPlatformBase;
+    /** The Types to filter the search to */
     types?: LavaSearchType[];
 };
 export {};

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

@@ -56,6 +56,8 @@ export interface ManagerOptions {
     playerOptions?: ManagerPlayerOptions;
     /** If it should skip to the next Track on TrackEnd / TrackError etc. events */
     autoSkip?: boolean;
+    /** If it should skip to the next Track if track.resolve errors while trying to play a track. */
+    autoSkipOnResolveError?: boolean;
     /** If it should emit only new (unique) songs and not when a looping track (or similar) is plaid, default false */
     emitNewSongsOnly?: boolean;
     /** Only allow link requests with links either matching some of that regExp or including some of that string */

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

@@ -78,29 +78,49 @@ export interface NodeStats extends BaseNodeStats {
     frameStats: FrameStats;
 }
 export interface LavalinkInfo {
+    /** The version of this Lavalink server */
     version: VersionObject;
+    /** The millisecond unix timestamp when this Lavalink jar was built */
     buildTime: number;
+    /** The git information of this Lavalink server */
     git: GitObject;
+    /** The JVM version this Lavalink server runs on */
     jvm: string;
+    /** The Lavaplayer version being used by this server */
     lavaplayer: string;
+    /** The enabled source managers for this server */
     sourceManagers: string[];
+    /** The enabled filters for this server */
     filters: string[];
+    /** The enabled plugins for this server */
     plugins: PluginObject[];
 }
 export interface VersionObject {
+    /** The full version string of this Lavalink server */
     semver: string;
+    /** The major version of this Lavalink server */
     major: number;
+    /** The minor version of this Lavalink server */
     minor: number;
+    /** The patch version of this Lavalink server */
     patch: internal;
+    /** The pre-release version according to semver as a . separated list of identifiers */
     preRelease?: string;
+    /** The build metadata according to semver as a . separated list of identifiers */
+    build?: string;
 }
 export interface GitObject {
+    /** The branch this Lavalink server was built on */
     branch: string;
+    /** The commit this Lavalink server was built on */
     commit: string;
+    /** The millisecond unix timestamp for when the commit was created */
     commitTime: string;
 }
 export interface PluginObject {
+    /** The name of the plugin */
     name: string;
+    /** The version of the plugin */
     version: string;
 }
 export declare class LavalinkNode {
@@ -110,6 +130,11 @@ export declare class LavalinkNode {
     calls: number;
     stats: NodeStats;
     sessionId?: string | null;
+    /** Wether the node resuming is enabled or not */
+    resuming: {
+        enabled: boolean;
+        timeout: number | null;
+    };
     /** Actual Lavalink Information of the Node */
     info: LavalinkInfo | null;
     /** The Node Manager of this Node */
@@ -126,10 +151,17 @@ export declare class LavalinkNode {
     private version;
     /**
      * Create a new Node
-     * @param options
-     * @param manager
+     * @param options Lavalink Node Options
+     * @param manager Node Manager
      */
     constructor(options: LavalinkNodeOptions, manager: NodeManager);
+    /**
+     * Raw Request util function
+     * @param endpoint endpoint string
+     * @param modify modify the request
+     * @returns
+     */
+    private rawRequest;
     /**
      * Makes an API call to the Node
      * @param endpoint The endpoint that we will make the call to
@@ -137,8 +169,14 @@ export declare class LavalinkNode {
      * @returns The returned data
      */
     request(endpoint: string, modify?: ModifyRequest, parseAsText?: boolean): Promise<unknown>;
+    /**
+     * Search something raw on the node, please note only add tracks to players of that node
+     * @param query SearchQuery Object
+     * @param requestUser Request User for creating the player(s)
+     * @returns Searchresult
+     */
     search(query: SearchQuery, requestUser: unknown): Promise<SearchResult>;
-    lavaSearch(query: LavaSearchQuery, requestUser: unknown): Promise<SearchResult | LavaSearchResponse>;
+    lavaSearch(query: LavaSearchQuery, requestUser: unknown, throwOnEmpty?: boolean): Promise<SearchResult | LavaSearchResponse>;
     /**
      * Update the Player State on the Lavalink Server
      * @param data
@@ -179,7 +217,7 @@ export declare class LavalinkNode {
      * @param resuming Whether resuming is enabled for this session or not
      * @param timeout The timeout in seconds (default is 60s)
      */
-    updateSession(resuming?: boolean, timeout?: number): Promise<Session>;
+    updateSession(resuming?: boolean, timeout?: number): Promise<InvalidLavalinkRestRequest | Session>;
     /**
      * Decode Track or Tracks
      */

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

@@ -1,9 +1,9 @@
 /// <reference types="node" />
 import { EventEmitter } from "stream";
-import { LavalinkNode, LavalinkNodeOptions } from "./Node";
 import { LavalinkManager } from "./LavalinkManager";
-import { MiniMap } from "./Utils";
+import { LavalinkNode, LavalinkNodeOptions } from "./Node";
 import { DestroyReasonsType } from "./Player";
+import { LavalinkPlayer, MiniMap } from "./Utils";
 type LavalinkNodeIdentifier = string;
 interface NodeManagerEvents {
     /**
@@ -44,6 +44,16 @@ interface NodeManagerEvents {
      * @event Manager.nodeManager#raw
     */
     "raw": (node: LavalinkNode, payload: unknown) => void;
+    /**
+     * Emits when the node connects resumed. You then need to create all players within this event for your usecase.
+     * Aka for that you need to be able to save player data like vc channel + text channel in a db and then sync it again
+     * @event Manager.nodeManager#nodeResumed
+     */
+    "resumed": (node: LavalinkNode, paylaod: {
+        resumed: true;
+        sessionId: string;
+        op: "ready";
+    }, players: LavalinkPlayer[]) => void;
 }
 export declare interface NodeManager {
     on<U extends keyof NodeManagerEvents>(event: U, listener: NodeManagerEvents[U]): this;

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

@@ -3,7 +3,7 @@ import { LavalinkManager } from "./LavalinkManager";
 import { LavalinkNode, SponsorBlockSegment } from "./Node";
 import { Queue } from "./Queue";
 import { Track, UnresolvedTrack } from "./Track";
-import { LavalinkPlayerVoiceOptions, LavaSearchQuery, SearchQuery } from "./Utils";
+import { Base64, LavalinkPlayerVoiceOptions, LavaSearchQuery, SearchQuery } from "./Utils";
 type PlayerDestroyReasons = "QueueEmpty" | "NodeDestroy" | "NodeDeleted" | "LavalinkNoVoice" | "NodeReconnectFail" | "PlayerReconnectFail" | "Disconnected" | "ChannelDeleted" | "ReconnectAllNodes" | "DisconnectAllNodes";
 export type DestroyReasonsType = PlayerDestroyReasons | string;
 export declare const DestroyReasons: Record<PlayerDestroyReasons, PlayerDestroyReasons>;
@@ -51,27 +51,42 @@ export interface PlayerOptions {
     /** If a volume should be applied via filters instead of lavalink-volume */
     applyVolumeAsFilter?: boolean;
 }
-export interface PlayOptions {
-    /** Which Track to play | don't provide, if it should pick from the Queue */
-    track?: Track | UnresolvedTrack;
-    /** Encoded Track to use, instead of the queue system... */
-    encodedTrack?: string | null;
-    /** Encoded Track to use&search, instead of the queue system (yt only)... */
-    identifier?: string;
+export type anyObject = {
+    [key: string | number]: string | number | null | anyObject;
+};
+export interface BasePlayOptions {
     /** The position to start the track. */
     position?: number;
     /** The position to end the track. */
     endTime?: number;
-    /** Whether to not replace the track if a play payload is sent. */
-    noReplace?: boolean;
     /** If to start "paused" */
     paused?: boolean;
     /** The Volume to start with */
     volume?: number;
     /** The Lavalink Filters to use | only with the new REST API */
     filters?: Partial<LavalinkFilterData>;
+    /** Voice Update for Lavalink */
     voice?: LavalinkPlayerVoiceOptions;
 }
+export interface LavalinkPlayOptions extends BasePlayOptions {
+    /** Which Track to play | don't provide, if it should pick from the Queue */
+    track?: {
+        /** The track encoded base64 string to use instead of the one from the queue system */
+        encoded?: Base64 | null;
+        /** The identifier of the track to use */
+        identifier?: string;
+        /** Custom User Data for the track to provide, will then be on the userData object from the track */
+        userData?: anyObject;
+        /** The Track requester for when u provide encodedTrack / identifer */
+        requester?: unknown;
+    };
+}
+export interface PlayOptions extends LavalinkPlayOptions {
+    /** Whether to not replace the track if a play payload is sent. */
+    noReplace?: boolean;
+    /** Which Track to play | don't provide, if it should pick from the Queue */
+    clientTrack?: Track | UnresolvedTrack;
+}
 export interface Player {
     filterManager: FilterManager;
     LavalinkManager: LavalinkManager;

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

@@ -1,4 +1,4 @@
-import { Player } from "./Player";
+import { anyObject, Player } from "./Player";
 import { Base64 } from "./Utils";
 /** Sourcenames provided by lavalink server */
 export type LavalinkSourceNames = "youtube" | "youtubemusic" | "soundcloud" | "bandcamp" | "twitch";
@@ -89,6 +89,8 @@ export interface LavalinkTrack {
     info: LavalinkTrackInfo;
     /** Plugin Information from Lavalink */
     pluginInfo: Partial<PluginInfo>;
+    /** The userData Object from when you provide to the lavalink request */
+    userData?: anyObject;
 }
 export interface Track {
     /** The Base 64 encoded String */
@@ -99,6 +101,8 @@ export interface Track {
     pluginInfo: Partial<PluginInfo>;
     /** The Track's Requester */
     requester?: unknown;
+    /** The userData Object from when you provide to the lavalink request */
+    userData?: anyObject;
 }
 export interface UnresolvedTrackInfo extends Partial<TrackInfo> {
     /** Required */
@@ -117,6 +121,8 @@ export interface UnresolvedTrack {
     info: UnresolvedTrackInfo;
     /** Plugin Information from Lavalink */
     pluginInfo: Partial<PluginInfo>;
+    /** The userData Object from when you provide to the lavalink request */
+    userData?: anyObject;
     /** The Track's Requester */
     requester?: unknown;
 }