magmastream 2.9.0-dev.36 → 2.9.0-dev.37

package/dist/index.d.ts

@@ -31,7 +31,7 @@ declare class Rest {
     manager: Manager;
     /** Whether the node is a NodeLink. */
     isNodeLink: boolean;
-    constructor(node: Node$1, manager: Manager);
+    constructor(node: Node, manager: Manager);
     /**
      * Sets the session ID.
      * This method is used to set the session ID after a resume operation is done.
@@ -137,218 +137,56 @@ interface playOptions {
     };
 }
 
-/**
- * State Storage Enum
- */
-declare enum StateStorageType {
-    Memory = "memory",
-    Redis = "redis",
-    JSON = "json"
-}
-/**
- * AutoPlay Platform Enum
- */
-declare enum AutoPlayPlatform {
-    Spotify = "spotify",
-    Deezer = "deezer",
-    SoundCloud = "soundcloud",
-    Tidal = "tidal",
-    VKMusic = "vkmusic",
-    Qobuz = "qobuz",
-    YouTube = "youtube"
-}
-/**
- * State Types Enum
- */
-declare enum StateTypes {
-    Connected = "CONNECTED",
-    Connecting = "CONNECTING",
-    Disconnected = "DISCONNECTED",
-    Disconnecting = "DISCONNECTING",
-    Destroying = "DESTROYING"
-}
-/**
- * Load Types Enum
- */
-declare enum LoadTypes {
-    Track = "track",
-    Playlist = "playlist",
-    Search = "search",
-    Empty = "empty",
-    Error = "error"
-}
-/**
- * Search Platform Enum
- */
-declare enum SearchPlatform {
-    AppleMusic = "amsearch",
-    Bandcamp = "bcsearch",
-    Deezer = "dzsearch",
-    Jiosaavn = "jssearch",
-    Qobuz = "qbsearch",
-    SoundCloud = "scsearch",
-    Spotify = "spsearch",
-    Tidal = "tdsearch",
-    VKMusic = "vksearch",
-    YouTube = "ytsearch",
-    YouTubeMusic = "ytmsearch"
-}
-/**
- * Player State Event Types Enum
- */
-declare enum PlayerStateEventTypes {
-    AutoPlayChange = "playerAutoplay",
-    ConnectionChange = "playerConnection",
-    RepeatChange = "playerRepeat",
-    PauseChange = "playerPause",
-    QueueChange = "queueChange",
-    TrackChange = "trackChange",
-    VolumeChange = "volumeChange",
-    ChannelChange = "channelChange",
-    PlayerCreate = "playerCreate",
-    PlayerDestroy = "playerDestroy"
-}
-/**
- * Track Source Types Enum
- */
-declare enum TrackSourceTypes {
-    AppleMusic = "applemusic",
-    Bandcamp = "bandcamp",
-    Deezer = "deezer",
-    Jiosaavn = "jiosaavn",
-    SoundCloud = "soundcloud",
-    Spotify = "spotify",
-    Tidal = "tidal",
-    VKMusic = "vkmusic",
-    YouTube = "youtube"
-}
-/**
- * Use Node Options Enum
- */
-declare enum UseNodeOptions {
-    LeastLoad = "leastLoad",
-    LeastPlayers = "leastPlayers"
-}
-/**
- * Track Partial Enum
- */
-declare enum TrackPartial {
-    /** The base64 encoded string of the track */
-    Track = "track",
-    /** The title of the track */
-    Title = "title",
-    /** The track identifier */
-    Identifier = "identifier",
-    /** The author of the track */
-    Author = "author",
-    /** The length of the track in milliseconds */
-    Duration = "duration",
-    /** The ISRC of the track */
-    Isrc = "isrc",
-    /** Whether the track is seekable */
-    IsSeekable = "isSeekable",
-    /** Whether the track is a stream */
-    IsStream = "isStream",
-    /** The URI of the track */
-    Uri = "uri",
-    /** The artwork URL of the track */
-    ArtworkUrl = "artworkUrl",
-    /** The source name of the track */
-    SourceName = "sourceName",
-    /** The thumbnail of the track */
-    ThumbNail = "thumbnail",
-    /** The requester of the track */
-    Requester = "requester",
-    /** The plugin info of the track */
-    PluginInfo = "pluginInfo",
-    /** The custom data of the track */
-    CustomData = "customData"
-}
-declare enum ManagerEventTypes {
-    ChapterStarted = "chapterStarted",
-    ChaptersLoaded = "chaptersLoaded",
-    Debug = "debug",
-    LyricsFoundEvent = "lyricsFoundEvent",
-    LyricsLineEvent = "lyricsLineEvent",
-    LyricsNotFoundEvent = "lyricsNotFoundEvent",
-    NodeConnect = "nodeConnect",
-    NodeCreate = "nodeCreate",
-    NodeDestroy = "nodeDestroy",
-    NodeDisconnect = "nodeDisconnect",
-    NodeError = "nodeError",
-    NodeRaw = "nodeRaw",
-    NodeReconnect = "nodeReconnect",
-    PlayerCreate = "playerCreate",
-    PlayerDestroy = "playerDestroy",
-    PlayerDisconnect = "playerDisconnect",
-    PlayerMove = "playerMove",
-    PlayerRestored = "playerRestored",
-    PlayerStateUpdate = "playerStateUpdate",
-    QueueEnd = "queueEnd",
-    RestoreComplete = "restoreComplete",
-    SegmentSkipped = "segmentSkipped",
-    SegmentsLoaded = "segmentsLoaded",
-    SocketClosed = "socketClosed",
-    TrackEnd = "trackEnd",
-    TrackError = "trackError",
-    TrackStart = "trackStart",
-    TrackStuck = "trackStuck",
-    VoiceReceiverDisconnect = "voiceReceiverDisconnect",
-    VoiceReceiverConnect = "voiceReceiverConnect",
-    VoiceReceiverError = "voiceReceiverError",
-    VoiceReceiverStartSpeaking = "voiceReceiverStartSpeaking",
-    VoiceReceiverEndSpeaking = "voiceReceiverEndSpeaking"
-}
-/**
- * Track End Reason Enum
- */
-declare enum TrackEndReasonTypes {
-    Finished = "finished",
-    LoadFailed = "loadFailed",
-    Stopped = "stopped",
-    Replaced = "replaced",
-    Cleanup = "cleanup"
-}
-/**
- * Severity Types Enum
- */
-declare enum SeverityTypes {
-    Common = "common",
-    Suspicious = "suspicious",
-    Fault = "fault"
-}
-/**
- * SponsorBlock Segment Enum
- */
-declare enum SponsorBlockSegment {
-    Sponsor = "sponsor",
-    SelfPromo = "selfpromo",
-    Interaction = "interaction",
-    Intro = "intro",
-    Outro = "outro",
-    Preview = "preview",
-    MusicOfftopic = "music_offtopic",
-    Filler = "filler"
-}
-
 /**
  * The player's queue, the `current` property is the currently playing track, think of the rest as the up-coming tracks.
  */
-declare class MemoryQueue extends Array<Track> implements IQueue {
-    /** The current track */
-    current: Track | null;
-    /** The previous tracks */
-    previous: Track[];
-    /** The Manager instance. */
-    manager: Manager;
-    /** The guild ID property. */
-    guildId: string;
+declare class JsonQueue implements IQueue {
+    readonly guildId: string;
+    readonly manager: Manager;
+    private basePath;
     /**
-     * Constructs a new Queue.
      * @param guildId The guild ID.
-     * @param manager The Manager instance.
+     * @param manager The manager.
      */
     constructor(guildId: string, manager: Manager);
+    /**
+     * @returns The queue path.
+     */
+    private get queuePath();
+    /**
+     * @returns The current path.
+     */
+    private get currentPath();
+    /**
+     * @returns The previous path.
+     */
+    private get previousPath();
+    /**
+     * Ensures the directory exists.
+     */
+    private ensureDir;
+    /**
+     * @returns The queue.
+     */
+    private getQueue;
+    /**
+     * @param queue The queue.
+     */
+    private setQueue;
+    /**
+     * @param filePath The file path.
+     * @returns The JSON data.
+     */
+    private readJSON;
+    /**
+     * @param filePath The file path.
+     * @param data The data to write.
+     */
+    private writeJSON;
+    /**
+     * @param filePath The file path.
+     */
+    private deleteFile;
     /**
      * @returns The current track.
      */
@@ -361,11 +199,14 @@ declare class MemoryQueue extends Array<Track> implements IQueue {
      * @returns The previous tracks.
      */
     getPrevious(): Promise<Track[]>;
+    /**
+     * @param track The track to add.
+     */
     addPrevious(track: Track | Track[]): Promise<void>;
     /**
-     * @param tracks The tracks to set.
+     * @param track The track to set.
      */
-    setPrevious(tracks: Track[]): Promise<void>;
+    setPrevious(track: Track | Track[]): Promise<void>;
     /**
      * @returns The newest track.
      */
@@ -375,98 +216,83 @@ declare class MemoryQueue extends Array<Track> implements IQueue {
      */
     clearPrevious(): Promise<void>;
     /**
-     * The total duration of the queue in milliseconds.
-     * This includes the duration of the currently playing track.
-     */
-    duration(): Promise<number>;
-    /**
-     * The total size of tracks in the queue including the current track.
-     * This includes the current track if it is not null.
-     * @returns The total size of tracks in the queue including the current track.
-     */
-    totalSize(): Promise<number>;
-    /**
-     * The size of tracks in the queue.
-     * This does not include the currently playing track.
-     * @returns The size of tracks in the queue.
-     */
-    size(): Promise<number>;
-    /**
-     * Adds a track to the queue.
      * @param track The track or tracks to add. Can be a single `Track` or an array of `Track`s.
      * @param [offset=null] The position to add the track(s) at. If not provided, the track(s) will be added at the end of the queue.
      */
     add(track: Track | Track[], offset?: number): Promise<void>;
     /**
-     * Removes track(s) from the queue.
-     * @param startOrPosition If a single number is provided, it will be treated as the position of the track to remove.
-     *                         If two numbers are provided, they will be used as the start and end of a range of tracks to remove.
-     * @param end Optional, end of the range of tracks to remove.
-     * @returns The removed track(s).
+     * Removes a track from the queue.
+     * @param position The position to remove the track at.
+     * @param end The end position to remove the track at.
      */
     remove(position?: number): Promise<Track[]>;
     remove(start: number, end: number): Promise<Track[]>;
     /**
      * Clears the queue.
-     * This will remove all tracks from the queue and emit a state update event.
      */
     clear(): Promise<void>;
+    /**
+     * @returns The size of the queue.
+     */
+    size(): Promise<number>;
+    /**
+     * @returns The total size of the queue.
+     */
+    totalSize(): Promise<number>;
+    /**
+     * @returns The total duration of the queue.
+     */
+    duration(): Promise<number>;
     /**
      * Shuffles the queue.
-     * This will randomize the order of the tracks in the queue and emit a state update event.
      */
     shuffle(): Promise<void>;
     /**
-     * Shuffles the queue to play tracks requested by each user one block at a time.
+     * Shuffles the queue by user.
      */
     userBlockShuffle(): Promise<void>;
     /**
-     * Shuffles the queue to play tracks requested by each user one by one.
+     * Shuffles the queue by round-robin.
      */
     roundRobinShuffle(): Promise<void>;
     /**
-     * Removes the first element from the queue.
+     * Removes the first track from the queue.
      */
     dequeue(): Promise<Track | undefined>;
     /**
-     * Adds the specified track or tracks to the front of the queue.
-     * @param track The track or tracks to add.
+     * Adds a track to the front of the queue.
      */
     enqueueFront(track: Track | Track[]): Promise<void>;
     /**
-     * @returns A shallow copy of the queue.
+     * @returns The tracks in the queue.
      */
     getTracks(): Promise<Track[]>;
     /**
-     * @returns A shallow copy of the queue.
+     * @returns The tracks in the queue from start to end.
      */
     getSlice(start?: number, end?: number): Promise<Track[]>;
     /**
      * Modifies the queue at the specified index.
-     * @param start The index at which to start modifying the queue.
-     * @param deleteCount The number of elements to remove from the queue.
-     * @param items The elements to add to the queue.
-     * @returns The modified queue.
      */
     modifyAt(start: number, deleteCount?: number, ...items: Track[]): Promise<Track[]>;
     /**
-     * @returns A new array with the results of calling a provided function on every element in the queue.
+     * Maps the queue to a new array.
      */
     mapAsync<T>(callback: (track: Track, index: number, array: Track[]) => T): Promise<T[]>;
     /**
-     * @returns A new array with all elements that pass the test implemented by the provided function.
+     * Filters the queue.
      */
     filterAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<Track[]>;
     /**
-     * @returns The first element in the queue that satisfies the provided testing function.
+     * Finds the first track in the queue that satisfies the provided testing function.
      */
     findAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<Track | undefined>;
     /**
-     * @returns Whether at least one element in the queue satisfies the provided testing function.
+     * Tests whether at least one element in the queue passes the test implemented by the provided function.
      */
     someAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<boolean>;
     /**
-     * @returns Whether all elements in the queue satisfy the provided testing function.
+     * Tests whether all elements in the queue pass the test implemented by the provided function.
      */
     everyAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<boolean>;
 }
@@ -474,43 +300,21 @@ declare class MemoryQueue extends Array<Track> implements IQueue {
 /**
  * The player's queue, the `current` property is the currently playing track, think of the rest as the up-coming tracks.
  */
-declare class RedisQueue implements IQueue {
-    readonly guildId: string;
-    readonly manager: Manager;
-    /**
-     * The Redis instance.
-     */
-    private redis;
-    /**
-     * The prefix for the Redis keys.
-     */
-    redisPrefix: string;
+declare class MemoryQueue extends Array<Track> implements IQueue {
+    /** The current track */
+    current: Track | null;
+    /** The previous tracks */
+    previous: Track[];
+    /** The Manager instance. */
+    manager: Manager;
+    /** The guild ID property. */
+    guildId: string;
     /**
-     * Constructs a new RedisQueue.
+     * Constructs a new Queue.
      * @param guildId The guild ID.
      * @param manager The Manager instance.
      */
     constructor(guildId: string, manager: Manager);
-    /**
-     * @returns The queue key.
-     */
-    private get queueKey();
-    /**
-     * @returns The current key.
-     */
-    private get currentKey();
-    /**
-     * @returns The previous key.
-     */
-    private get previousKey();
-    /**
-     * Helper to serialize/deserialize Track
-     */
-    private serialize;
-    /**
-     * Helper to serialize/deserialize Track
-     */
-    private deserialize;
     /**
      * @returns The current track.
      */
@@ -523,14 +327,11 @@ declare class RedisQueue implements IQueue {
      * @returns The previous tracks.
      */
     getPrevious(): Promise<Track[]>;
-    /**
-     * @param track The track to add.
-     */
     addPrevious(track: Track | Track[]): Promise<void>;
     /**
-     * @param track The track to set.
+     * @param tracks The tracks to set.
      */
-    setPrevious(track: Track | Track[]): Promise<void>;
+    setPrevious(tracks: Track[]): Promise<void>;
     /**
      * @returns The newest track.
      */
@@ -540,83 +341,98 @@ declare class RedisQueue implements IQueue {
      */
     clearPrevious(): Promise<void>;
     /**
+     * The total duration of the queue in milliseconds.
+     * This includes the duration of the currently playing track.
+     */
+    duration(): Promise<number>;
+    /**
+     * The total size of tracks in the queue including the current track.
+     * This includes the current track if it is not null.
+     * @returns The total size of tracks in the queue including the current track.
+     */
+    totalSize(): Promise<number>;
+    /**
+     * The size of tracks in the queue.
+     * This does not include the currently playing track.
+     * @returns The size of tracks in the queue.
+     */
+    size(): Promise<number>;
+    /**
+     * Adds a track to the queue.
      * @param track The track or tracks to add. Can be a single `Track` or an array of `Track`s.
      * @param [offset=null] The position to add the track(s) at. If not provided, the track(s) will be added at the end of the queue.
      */
     add(track: Track | Track[], offset?: number): Promise<void>;
     /**
-     * @param position The position to remove the track at.
-     * @param end The end position to remove the track at.
+     * Removes track(s) from the queue.
+     * @param startOrPosition If a single number is provided, it will be treated as the position of the track to remove.
+     *                         If two numbers are provided, they will be used as the start and end of a range of tracks to remove.
+     * @param end Optional, end of the range of tracks to remove.
+     * @returns The removed track(s).
      */
     remove(position?: number): Promise<Track[]>;
     remove(start: number, end: number): Promise<Track[]>;
     /**
      * Clears the queue.
+     * This will remove all tracks from the queue and emit a state update event.
      */
     clear(): Promise<void>;
-    /**
-     * @returns The size of the queue.
-     */
-    size(): Promise<number>;
-    /**
-     * @returns The total size of tracks in the queue including the current track.
-     */
-    totalSize(): Promise<number>;
-    /**
-     * @returns The total duration of the queue in milliseconds.
-     * This includes the duration of the currently playing track.
-     */
-    duration(): Promise<number>;
     /**
      * Shuffles the queue.
+     * This will randomize the order of the tracks in the queue and emit a state update event.
      */
     shuffle(): Promise<void>;
     /**
-     * Shuffles the queue, but keeps the tracks of the same user together.
+     * Shuffles the queue to play tracks requested by each user one block at a time.
      */
     userBlockShuffle(): Promise<void>;
     /**
-     * Shuffles the queue round-robin style.
+     * Shuffles the queue to play tracks requested by each user one by one.
      */
     roundRobinShuffle(): Promise<void>;
     /**
-     * Removes the first track from the queue.
+     * Removes the first element from the queue.
      */
     dequeue(): Promise<Track | undefined>;
     /**
-     * Adds a track to the front of the queue.
+     * Adds the specified track or tracks to the front of the queue.
+     * @param track The track or tracks to add.
      */
     enqueueFront(track: Track | Track[]): Promise<void>;
     /**
-     * @returns The tracks in the queue.
+     * @returns A shallow copy of the queue.
      */
     getTracks(): Promise<Track[]>;
     /**
-     * @returns The tracks in the queue from the start to the end.
+     * @returns A shallow copy of the queue.
      */
     getSlice(start?: number, end?: number): Promise<Track[]>;
     /**
      * Modifies the queue at the specified index.
+     * @param start The index at which to start modifying the queue.
+     * @param deleteCount The number of elements to remove from the queue.
+     * @param items The elements to add to the queue.
+     * @returns The modified queue.
      */
     modifyAt(start: number, deleteCount?: number, ...items: Track[]): Promise<Track[]>;
     /**
-     * @returns The tracks in the queue after the specified index.
+     * @returns A new array with the results of calling a provided function on every element in the queue.
      */
     mapAsync<T>(callback: (track: Track, index: number, array: Track[]) => T): Promise<T[]>;
     /**
-     * @returns The tracks in the queue that match the specified condition.
+     * @returns A new array with all elements that pass the test implemented by the provided function.
      */
     filterAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<Track[]>;
     /**
-     * @returns The first track in the queue that matches the specified condition.
+     * @returns The first element in the queue that satisfies the provided testing function.
      */
     findAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<Track | undefined>;
     /**
-     * @returns Whether any tracks in the queue match the specified condition.
+     * @returns Whether at least one element in the queue satisfies the provided testing function.
      */
     someAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<boolean>;
     /**
-     * @returns Whether all tracks in the queue match the specified condition.
+     * @returns Whether all elements in the queue satisfy the provided testing function.
      */
     everyAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<boolean>;
 }
@@ -624,53 +440,43 @@ declare class RedisQueue implements IQueue {
 /**
  * The player's queue, the `current` property is the currently playing track, think of the rest as the up-coming tracks.
  */
-declare class JsonQueue implements IQueue {
+declare class RedisQueue implements IQueue {
     readonly guildId: string;
     readonly manager: Manager;
-    private basePath;
-    /**
-     * @param guildId The guild ID.
-     * @param manager The manager.
-     */
-    constructor(guildId: string, manager: Manager);
     /**
-     * @returns The queue path.
-     */
-    private get queuePath();
-    /**
-     * @returns The current path.
+     * The Redis instance.
      */
-    private get currentPath();
+    private redis;
     /**
-     * @returns The previous path.
+     * The prefix for the Redis keys.
      */
-    private get previousPath();
+    redisPrefix: string;
     /**
-     * Ensures the directory exists.
+     * Constructs a new RedisQueue.
+     * @param guildId The guild ID.
+     * @param manager The Manager instance.
      */
-    private ensureDir;
+    constructor(guildId: string, manager: Manager);
     /**
-     * @returns The queue.
+     * @returns The queue key.
      */
-    private getQueue;
+    private get queueKey();
     /**
-     * @param queue The queue.
+     * @returns The current key.
      */
-    private setQueue;
+    private get currentKey();
     /**
-     * @param filePath The file path.
-     * @returns The JSON data.
+     * @returns The previous key.
      */
-    private readJSON;
+    private get previousKey();
     /**
-     * @param filePath The file path.
-     * @param data The data to write.
+     * Helper to serialize/deserialize Track
      */
-    private writeJSON;
+    private serialize;
     /**
-     * @param filePath The file path.
+     * Helper to serialize/deserialize Track
      */
-    private deleteFile;
+    private deserialize;
     /**
      * @returns The current track.
      */
@@ -705,7 +511,6 @@ declare class JsonQueue implements IQueue {
      */
     add(track: Track | Track[], offset?: number): Promise<void>;
     /**
-     * Removes a track from the queue.
      * @param position The position to remove the track at.
      * @param end The end position to remove the track at.
      */
@@ -720,11 +525,12 @@ declare class JsonQueue implements IQueue {
      */
     size(): Promise<number>;
     /**
-     * @returns The total size of the queue.
+     * @returns The total size of tracks in the queue including the current track.
      */
     totalSize(): Promise<number>;
     /**
-     * @returns The total duration of the queue.
+     * @returns The total duration of the queue in milliseconds.
+     * This includes the duration of the currently playing track.
      */
     duration(): Promise<number>;
     /**
@@ -732,11 +538,11 @@ declare class JsonQueue implements IQueue {
      */
     shuffle(): Promise<void>;
     /**
-     * Shuffles the queue by user.
+     * Shuffles the queue, but keeps the tracks of the same user together.
      */
     userBlockShuffle(): Promise<void>;
     /**
-     * Shuffles the queue by round-robin.
+     * Shuffles the queue round-robin style.
      */
     roundRobinShuffle(): Promise<void>;
     /**
@@ -752,7 +558,7 @@ declare class JsonQueue implements IQueue {
      */
     getTracks(): Promise<Track[]>;
     /**
-     * @returns The tracks in the queue from start to end.
+     * @returns The tracks in the queue from the start to the end.
      */
     getSlice(start?: number, end?: number): Promise<Track[]>;
     /**
@@ -760,27 +566,261 @@ declare class JsonQueue implements IQueue {
      */
     modifyAt(start: number, deleteCount?: number, ...items: Track[]): Promise<Track[]>;
     /**
-     * Maps the queue to a new array.
+     * @returns The tracks in the queue after the specified index.
      */
     mapAsync<T>(callback: (track: Track, index: number, array: Track[]) => T): Promise<T[]>;
     /**
-     * Filters the queue.
+     * @returns The tracks in the queue that match the specified condition.
      */
     filterAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<Track[]>;
     /**
-     * Finds the first track in the queue that satisfies the provided testing function.
+     * @returns The first track in the queue that matches the specified condition.
      */
     findAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<Track | undefined>;
     /**
-     * Tests whether at least one element in the queue passes the test implemented by the provided function.
+     * @returns Whether any tracks in the queue match the specified condition.
      */
     someAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<boolean>;
     /**
-     * Tests whether all elements in the queue pass the test implemented by the provided function.
+     * @returns Whether all tracks in the queue match the specified condition.
      */
     everyAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<boolean>;
 }
 
+/**
+ * State Storage Enum
+ */
+declare enum StateStorageType {
+    Memory = "memory",
+    Redis = "redis",
+    JSON = "json"
+}
+/**
+ * AutoPlay Platform Enum
+ */
+declare enum AutoPlayPlatform {
+    Spotify = "spotify",
+    Deezer = "deezer",
+    SoundCloud = "soundcloud",
+    Tidal = "tidal",
+    VKMusic = "vkmusic",
+    Qobuz = "qobuz",
+    YouTube = "youtube"
+}
+/**
+ * State Types Enum
+ */
+declare enum StateTypes {
+    Connected = "CONNECTED",
+    Connecting = "CONNECTING",
+    Disconnected = "DISCONNECTED",
+    Disconnecting = "DISCONNECTING",
+    Destroying = "DESTROYING"
+}
+/**
+ * Load Types Enum
+ */
+declare enum LoadTypes {
+    Track = "track",
+    Playlist = "playlist",
+    Search = "search",
+    Empty = "empty",
+    Error = "error",
+    /** Nodelink */
+    Album = "album",
+    /** Nodelink */
+    Artist = "artist",
+    /** Nodelink */
+    Station = "station",
+    /** Nodelink */
+    Podcast = "podcast",
+    /** Nodelink */
+    Show = "show",
+    /** Nodelink */
+    Short = "short"
+}
+/**
+ * Search Platform Enum
+ */
+declare enum SearchPlatform {
+    AppleMusic = "amsearch",
+    Bandcamp = "bcsearch",
+    Deezer = "dzsearch",
+    Jiosaavn = "jssearch",
+    Qobuz = "qbsearch",
+    SoundCloud = "scsearch",
+    Spotify = "spsearch",
+    Tidal = "tdsearch",
+    VKMusic = "vksearch",
+    YouTube = "ytsearch",
+    YouTubeMusic = "ytmsearch"
+}
+/**
+ * Player State Event Types Enum
+ */
+declare enum PlayerStateEventTypes {
+    AutoPlayChange = "playerAutoplay",
+    ConnectionChange = "playerConnection",
+    RepeatChange = "playerRepeat",
+    PauseChange = "playerPause",
+    QueueChange = "queueChange",
+    TrackChange = "trackChange",
+    VolumeChange = "volumeChange",
+    ChannelChange = "channelChange",
+    PlayerCreate = "playerCreate",
+    PlayerDestroy = "playerDestroy"
+}
+/**
+ * Track Source Types Enum
+ */
+declare enum TrackSourceTypes {
+    AppleMusic = "applemusic",
+    Bandcamp = "bandcamp",
+    Deezer = "deezer",
+    Jiosaavn = "jiosaavn",
+    SoundCloud = "soundcloud",
+    Spotify = "spotify",
+    Tidal = "tidal",
+    VKMusic = "vkmusic",
+    YouTube = "youtube"
+}
+/**
+ * Use Node Options Enum
+ */
+declare enum UseNodeOptions {
+    LeastLoad = "leastLoad",
+    LeastPlayers = "leastPlayers"
+}
+/**
+ * Track Partial Enum
+ */
+declare enum TrackPartial {
+    /** The base64 encoded string of the track */
+    Track = "track",
+    /** The title of the track */
+    Title = "title",
+    /** The track identifier */
+    Identifier = "identifier",
+    /** The author of the track */
+    Author = "author",
+    /** The length of the track in milliseconds */
+    Duration = "duration",
+    /** The ISRC of the track */
+    Isrc = "isrc",
+    /** Whether the track is seekable */
+    IsSeekable = "isSeekable",
+    /** Whether the track is a stream */
+    IsStream = "isStream",
+    /** The URI of the track */
+    Uri = "uri",
+    /** The artwork URL of the track */
+    ArtworkUrl = "artworkUrl",
+    /** The source name of the track */
+    SourceName = "sourceName",
+    /** The thumbnail of the track */
+    ThumbNail = "thumbnail",
+    /** The requester of the track */
+    Requester = "requester",
+    /** The plugin info of the track */
+    PluginInfo = "pluginInfo",
+    /** The custom data of the track */
+    CustomData = "customData"
+}
+declare enum ManagerEventTypes {
+    ChapterStarted = "chapterStarted",
+    ChaptersLoaded = "chaptersLoaded",
+    Debug = "debug",
+    LyricsFoundEvent = "lyricsFoundEvent",
+    LyricsLineEvent = "lyricsLineEvent",
+    LyricsNotFoundEvent = "lyricsNotFoundEvent",
+    NodeConnect = "nodeConnect",
+    NodeCreate = "nodeCreate",
+    NodeDestroy = "nodeDestroy",
+    NodeDisconnect = "nodeDisconnect",
+    NodeError = "nodeError",
+    NodeRaw = "nodeRaw",
+    NodeReconnect = "nodeReconnect",
+    PlayerCreate = "playerCreate",
+    PlayerDestroy = "playerDestroy",
+    PlayerDisconnect = "playerDisconnect",
+    PlayerMove = "playerMove",
+    PlayerRestored = "playerRestored",
+    PlayerStateUpdate = "playerStateUpdate",
+    QueueEnd = "queueEnd",
+    RestoreComplete = "restoreComplete",
+    SegmentSkipped = "segmentSkipped",
+    SegmentsLoaded = "segmentsLoaded",
+    SocketClosed = "socketClosed",
+    TrackEnd = "trackEnd",
+    TrackError = "trackError",
+    TrackStart = "trackStart",
+    TrackStuck = "trackStuck",
+    /** Nodelink */
+    VoiceReceiverDisconnect = "voiceReceiverDisconnect",
+    /** Nodelink */
+    VoiceReceiverConnect = "voiceReceiverConnect",
+    /** Nodelink */
+    VoiceReceiverError = "voiceReceiverError",
+    /** Nodelink */
+    VoiceReceiverStartSpeaking = "voiceReceiverStartSpeaking",
+    /** Nodelink */
+    VoiceReceiverEndSpeaking = "voiceReceiverEndSpeaking"
+}
+/**
+ * Track End Reason Enum
+ */
+declare enum TrackEndReasonTypes {
+    Finished = "finished",
+    LoadFailed = "loadFailed",
+    Stopped = "stopped",
+    Replaced = "replaced",
+    Cleanup = "cleanup"
+}
+/**
+ * Severity Types Enum
+ */
+declare enum SeverityTypes {
+    Common = "common",
+    Suspicious = "suspicious",
+    Fault = "fault"
+}
+/**
+ * SponsorBlock Segment Enum
+ */
+declare enum SponsorBlockSegment {
+    Sponsor = "sponsor",
+    SelfPromo = "selfpromo",
+    Interaction = "interaction",
+    Intro = "intro",
+    Outro = "outro",
+    Preview = "preview",
+    MusicOfftopic = "music_offtopic",
+    Filler = "filler"
+}
+
+/**
+ * Base abstract class for all plugins.
+ * Users must extend this and implement load and unload methods.
+ */
+declare abstract class Plugin {
+    readonly name: string;
+    /**
+     * @param name The name of the plugin
+     */
+    constructor(name: string);
+    /**
+     * Load the plugin.
+     * @param manager The MagmaStream Manager instance
+     */
+    abstract load(manager: Manager): void;
+    /**
+     * Unload the plugin.
+     * Called on shutdown to gracefully cleanup resources or detach listeners.
+     * @param manager The MagmaStream Manager instance
+     */
+    abstract unload(manager: Manager): void;
+}
+
 /**
  * Manager Options
  */
@@ -805,7 +845,11 @@ interface ManagerOptions {
     autoPlaySearchPlatforms?: AutoPlayPlatform[];
     /** The client ID to use. */
     clientId?: string;
-    /** Value to use for the `Client-Name` header. */
+    /** Value to use for the `Client-Name` header.
+     *  @default "Magmastream"
+     *
+     * For NodeLink, leave it empty.
+     */
     clientName?: string;
     /** The array of shard IDs connected to this manager instance.
      * @default 0
@@ -1252,6 +1296,35 @@ interface PlaylistSearchResult {
     /** The playlist info */
     playlist: PlaylistData;
 }
+interface AlbumSearchResult {
+    loadType: LoadTypes.Album;
+    tracks: Track[];
+    playlist: PlaylistData;
+}
+interface ArtistSearchResult {
+    loadType: LoadTypes.Artist;
+    tracks: Track[];
+    playlist: PlaylistData;
+}
+interface StationSearchResult {
+    loadType: LoadTypes.Station;
+    tracks: Track[];
+    playlist: PlaylistData;
+}
+interface PodcastSearchResult {
+    loadType: LoadTypes.Podcast;
+    tracks: Track[];
+    playlist: PlaylistData;
+}
+interface ShowSearchResult {
+    loadType: LoadTypes.Show;
+    tracks: Track[];
+    playlist: PlaylistData;
+}
+interface ShortSearchResult {
+    loadType: LoadTypes.Short;
+    tracks: [Track];
+}
 /**
  * Playlist Data
  */
@@ -1848,7 +1921,7 @@ type VoiceReceiverEvent = StartSpeakingEventVoiceReceiver | EndSpeakingEventVoic
 /**
  * Search Result Enum type
  */
-type SearchResult = TrackSearchResult | SearchSearchResult | PlaylistSearchResult | ErrorOrEmptySearchResult;
+type SearchResult = TrackSearchResult | SearchSearchResult | PlaylistSearchResult | ErrorOrEmptySearchResult | AlbumSearchResult | ArtistSearchResult | StationSearchResult | PodcastSearchResult | ShowSearchResult | ShortSearchResult;
 /**
  * Lyrics Event Enum type
  */
@@ -1858,7 +1931,7 @@ type LyricsEvent = LyricsFoundEvent | LyricsNotFoundEvent | LyricsLineEvent;
  */
 type LyricsEventType = "LyricsFoundEvent" | "LyricsNotFoundEvent" | "LyricsLineEvent";
 
-declare class Node$1 {
+declare class Node {
     manager: Manager;
     options: NodeOptions;
     /** The socket for the node. */
@@ -2091,9 +2164,10 @@ declare class Node$1 {
      *
      * @param {Track} track - The track to fetch the lyrics for.
      * @param {boolean} [skipTrackSource=false] - Whether to skip using the track's source URL.
+     * @param {string} [language="en"] - The language of the lyrics.
      * @returns {Promise<Lyrics | NodeLinkGetLyrics>} A promise that resolves with the lyrics data.
      */
-    getLyrics(track: Track, skipTrackSource?: boolean): Promise<Lyrics | NodeLinkGetLyrics>;
+    getLyrics(track: Track, skipTrackSource?: boolean, language?: string): Promise<Lyrics | NodeLinkGetLyrics>;
     /**
      * Subscribes to lyrics for a player.
      * @param {string} guildId - The ID of the guild to subscribe to lyrics for.
@@ -2244,12 +2318,13 @@ declare class Manager extends EventEmitter {
     /** The map of players. */
     readonly players: Collection<string, Player>;
     /** The map of nodes. */
-    readonly nodes: Collection<string, Node$1>;
+    readonly nodes: Collection<string, Node>;
     /** The options that were set. */
     readonly options: ManagerOptions;
     initiated: boolean;
     redis?: Redis;
     private _send?;
+    private loadedPlugins;
     /**
      * Initiates the Manager class.
      * @param options
@@ -2310,7 +2385,7 @@ declare class Manager extends EventEmitter {
      * @param options - The options to create the node with.
      * @returns The created node.
      */
-    createNode(options: NodeOptions): Node$1;
+    createNode(options: NodeOptions): Node;
     /**
      * Destroys a node if it exists. Emits a debug event if the node is found and destroyed.
      * @param identifier - The identifier of the node to destroy.
@@ -2371,7 +2446,7 @@ declare class Manager extends EventEmitter {
      * If `enablePriorityMode` is false and `useNode` is not set, the node with the lowest load is chosen.
      * @returns {Node} The node to use.
      */
-    get useableNode(): Node$1;
+    get useableNode(): Node;
     /**
      * Handles the shutdown of the process by saving all active players' states and optionally cleaning up inactive players.
      * This function is called when the process is about to exit.
@@ -2452,6 +2527,14 @@ declare class Manager extends EventEmitter {
      * @param guildId The guild ID of the player to clean up.
      */
     cleanupInactivePlayer(guildId: string): Promise<void>;
+    /**
+     * Loads the enabled plugins.
+     */
+    private loadPlugins;
+    /**
+     * Unloads the enabled plugins.
+     */
+    private unloadPlugins;
     /**
      * Clears all player states from the file system.
      * This is done to prevent stale state files from accumulating on the file system.
@@ -2506,7 +2589,7 @@ declare class Player {
     /** The volume for the player */
     volume: number;
     /** The Node for the Player. */
-    node: Node$1;
+    node: Node;
     /** The guild ID for the player. */
     guildId: string;
     /** The voice channel for the player. */
@@ -3232,15 +3315,6 @@ declare enum AvailableFilters {
     Demon = "demon"
 }
 
-declare class Plugin$1 {
-    name: string;
-    /**
-     * @param name The name of the plugin
-     */
-    constructor(name: string);
-    load(manager: Manager): void;
-}
-
 declare abstract class TrackUtils {
     static trackPartial: TrackPartial[] | null;
     private static manager;
@@ -3305,6 +3379,23 @@ declare abstract class AutoPlayUtils {
      * @returns An array of recommended tracks.
      */
     static getRecommendedTracksFromSource(track: Track, platform: AutoPlayPlatform): Promise<Track[]>;
+    /**
+     * Searches for a track using the manager and returns resolved tracks.
+     * @param query The search query (artist - title).
+     * @param requester The requester who initiated the search.
+     * @returns An array of resolved tracks, or an empty array if not found or error occurred.
+     */
+    private static resolveTracksFromQuery;
+    /**
+     * Resolves the first available track from a search query using the specified source.
+     * Useful for normalizing tracks that lack platform-specific metadata or URIs.
+     *
+     * @param query - The search query string (usually "Artist - Title").
+     * @param source - The search platform to use (e.g., Spotify, Deezer, YouTube).
+     * @param requester - The requester object, used for context or attribution.
+     * @returns A single resolved {@link Track} object if found, or `null` if the search fails or returns no results.
+     */
+    private static resolveFirstTrackFromQuery;
     static buildTracksFromResponse<T>(recommendedResult: LavalinkResponse, requester?: T): Track[];
 }
 /** Gets or extends structures to extend the built in, or already extended, classes to add more functionality. */
@@ -3389,5 +3480,5 @@ declare class SeyfertManager extends Manager {
     protected send(packet: GatewayVoiceStateUpdate): void;
 }
 
-export { AutoPlayPlatform, AutoPlayUtils, AvailableFilters, DetritusManager, DiscordJSManager, ErisManager, Filters, JsonQueue, LoadTypes, Manager, ManagerEventTypes, MemoryQueue, Node$1 as Node, OceanicManager, Player, PlayerStateEventTypes, Plugin$1 as Plugin, RedisQueue, Rest, SearchPlatform, SeverityTypes, SeyfertManager, SponsorBlockSegment, StateStorageType, StateTypes, Structure, TrackEndReasonTypes, TrackPartial, TrackSourceTypes, TrackUtils, UseNodeOptions };
-export type { CPUStats, DiscordPacket, EndSpeakingEventVoiceReceiver, EndSpeakingEventVoiceReceiverData, EqualizerBand, ErrorOrEmptySearchResult, Exception, Extendable, FrameStats, IQueue, JsonConfig, LavaPlayer, LavalinkInfo, LavalinkResponse, LoadType, Lyrics, LyricsEvent, LyricsEventType, LyricsFoundEvent, LyricsLine, LyricsLineEvent, LyricsNotFoundEvent, ManagerEvents, ManagerInitOptions, ManagerOptions, MemoryStats, NodeLinkGetLyrics, NodeLinkGetLyricsEmpty, NodeLinkGetLyricsError, NodeLinkGetLyricsMultiple, NodeLinkGetLyricsSingle, NodeMessage, NodeOptions, NodeStats, Payload, PlayOptions, PlayerEvent, PlayerEventType, PlayerEvents, PlayerOptions, PlayerStateChangeData, PlayerStateUpdateEvent, PlayerUpdate, PlayerUpdateVoiceState, PlaylistData, PlaylistInfoData, PlaylistRawData, PlaylistSearchResult, RedisConfig, SearchQuery, SearchResult, SearchSearchResult, Severity, Sizes, SponsorBlockChapterStarted, SponsorBlockChaptersLoaded, SponsorBlockSegmentEventType, SponsorBlockSegmentEvents, SponsorBlockSegmentSkipped, SponsorBlockSegmentsLoaded, StartSpeakingEventVoiceReceiver, StartSpeakingEventVoiceReceiverData, StateStorageOptions, Track, TrackData, TrackDataInfo, TrackEndEvent, TrackEndReason, TrackExceptionEvent, TrackPluginInfo, TrackSearchResult, TrackSourceName, TrackStartEvent, TrackStuckEvent, UseNodeOption, VoicePacket, VoiceReceiverEvent, VoiceServer, VoiceServerUpdate, VoiceState, WebSocketClosedEvent };
+export { AutoPlayPlatform, AutoPlayUtils, AvailableFilters, DetritusManager, DiscordJSManager, ErisManager, Filters, JsonQueue, LoadTypes, Manager, ManagerEventTypes, MemoryQueue, Node, OceanicManager, Player, PlayerStateEventTypes, Plugin, RedisQueue, Rest, SearchPlatform, SeverityTypes, SeyfertManager, SponsorBlockSegment, StateStorageType, StateTypes, Structure, TrackEndReasonTypes, TrackPartial, TrackSourceTypes, TrackUtils, UseNodeOptions };
+export type { AlbumSearchResult, ArtistSearchResult, CPUStats, DiscordPacket, EndSpeakingEventVoiceReceiver, EndSpeakingEventVoiceReceiverData, EqualizerBand, ErrorOrEmptySearchResult, Exception, Extendable, FrameStats, IQueue, JsonConfig, LavaPlayer, LavalinkInfo, LavalinkResponse, LoadType, Lyrics, LyricsEvent, LyricsEventType, LyricsFoundEvent, LyricsLine, LyricsLineEvent, LyricsNotFoundEvent, ManagerEvents, ManagerInitOptions, ManagerOptions, MemoryStats, NodeLinkGetLyrics, NodeLinkGetLyricsEmpty, NodeLinkGetLyricsError, NodeLinkGetLyricsMultiple, NodeLinkGetLyricsSingle, NodeMessage, NodeOptions, NodeStats, Payload, PlayOptions, PlayerEvent, PlayerEventType, PlayerEvents, PlayerOptions, PlayerStateChangeData, PlayerStateUpdateEvent, PlayerUpdate, PlayerUpdateVoiceState, PlaylistData, PlaylistInfoData, PlaylistRawData, PlaylistSearchResult, PodcastSearchResult, RedisConfig, SearchQuery, SearchResult, SearchSearchResult, Severity, ShortSearchResult, ShowSearchResult, Sizes, SponsorBlockChapterStarted, SponsorBlockChaptersLoaded, SponsorBlockSegmentEventType, SponsorBlockSegmentEvents, SponsorBlockSegmentSkipped, SponsorBlockSegmentsLoaded, StartSpeakingEventVoiceReceiver, StartSpeakingEventVoiceReceiverData, StateStorageOptions, StationSearchResult, Track, TrackData, TrackDataInfo, TrackEndEvent, TrackEndReason, TrackExceptionEvent, TrackPluginInfo, TrackSearchResult, TrackSourceName, TrackStartEvent, TrackStuckEvent, UseNodeOption, VoicePacket, VoiceReceiverEvent, VoiceServer, VoiceServerUpdate, VoiceState, WebSocketClosedEvent };