magmastream 2.10.3-dev.2 → 2.10.3

package/dist/structures/Types.d.ts

@@ -6,7 +6,7 @@ import type { User as SeyfertUser, ClientUser as SeyfertClientUser, Message as S
 import { JsonQueue } from "../statestorage/JsonQueue";
 import { MemoryQueue } from "../statestorage/MemoryQueue";
 import { RedisQueue } from "../statestorage/RedisQueue";
-import { AutoPlayPlatform, LoadTypes, ManagerEventTypes, PlayerStateEventTypes, SearchPlatform, SeverityTypes, StateStorageType, TrackEndReasonTypes, TrackPartial, TrackSourceTypes, UseNodeOptions } from "./Enums";
+import { AutoPlayPlatform, LoadTypes, ManagerEventTypes, NodeLinkRecommendationPlatform, NodeLinkSearchPlatform, NodeLinkSearchType, PlayerStateEventTypes, SearchPlatform, SeverityTypes, StateStorageType, TrackEndReasonTypes, TrackPartial, TrackSourceTypes, UseNodeOptions } from "./Enums";
 import { Node } from "./Node";
 import { Player } from "./Player";
 import { Plugin } from "./Plugin";
@@ -51,7 +51,7 @@ export interface ManagerOptions {
      * Use enum `SearchPlatform`.
      * @default SearchPlatform.YouTube
      */
-    defaultSearchPlatform?: SearchPlatform;
+    defaultSearchPlatform?: SearchSource;
     /** The last.fm API key.
      * If you need to create one go here: https://www.last.fm/api/account/create.
      * If you already have one, get it from here: https://www.last.fm/api/accounts. */
@@ -388,13 +388,13 @@ export interface Track {
     /** The duration of the track. */
     readonly duration: number;
     /** The ISRC of the track. */
-    readonly isrc: string;
+    readonly isrc: string | null;
     /** If the track is seekable. */
     readonly isSeekable: boolean;
     /** If the track is a stream.. */
     readonly isStream: boolean;
     /** The uri of the track. */
-    readonly uri: string;
+    readonly uri: string | null;
     /** The thumbnail of the track or null if it's a unsupported source. */
     readonly thumbnail: string | null;
     /** The user that requested the track. */
@@ -412,6 +412,7 @@ export interface Track {
  * Track Plugin Info
  */
 export interface TrackPluginInfo {
+    [key: string]: unknown;
     albumName?: string;
     albumUrl?: string;
     artistArtworkUrl?: string;
@@ -424,16 +425,26 @@ export interface TrackPluginInfo {
  */
 export interface SearchQuery {
     /** The source to search from. */
-    source?: SearchPlatform;
+    source?: SearchSource;
+    /**
+     * NodeLink search type modifier.
+     *
+     * Builds identifiers like `ytsearch:playlist:query` and routes the search to a NodeLink node.
+     */
+    searchType?: NodeLinkSearchType | string;
     /** The query to search for. */
     query: string;
 }
+/**
+ * Search source.
+ */
+export type SearchSource = SearchPlatform | NodeLinkSearchPlatform | NodeLinkRecommendationPlatform;
 /**
  * Lavalink Response
  */
 export interface LavalinkResponse {
     loadType: LoadTypes;
-    data: TrackData[] | PlaylistRawData;
+    data: LavalinkLoadResultData;
 }
 /**
  * Track Data
@@ -444,7 +455,9 @@ export interface TrackData {
     /** The detailed information of the track. */
     info: TrackDataInfo;
     /** Additional track info provided by plugins. */
-    pluginInfo: Record<string, string>;
+    pluginInfo: Record<string, unknown>;
+    /** Additional track data sent back from Lavalink. */
+    userData?: Record<string, unknown>;
 }
 /**
  * Playlist Raw Data
@@ -453,12 +466,15 @@ export interface PlaylistRawData {
     info: {
         /** The playlist name. */
         name: string;
+        /** The selected track index, or -1 if none is selected. */
+        selectedTrack: number;
     };
     /** Addition info provided by plugins. */
-    pluginInfo: object;
+    pluginInfo: Record<string, unknown>;
     /** The tracks of the playlist */
     tracks: TrackData[];
 }
+export type LavalinkLoadResultData = TrackData | TrackData[] | PlaylistRawData | Exception | null;
 /**
  * Track Data Info
  */
@@ -467,19 +483,20 @@ export interface TrackDataInfo {
     isSeekable: boolean;
     author: string;
     length: number;
-    isrc?: string;
+    position: number;
+    isrc: string | null;
     isStream: boolean;
     title: string;
-    uri?: string;
-    artworkUrl?: string;
-    sourceName?: TrackSourceName;
+    uri: string | null;
+    artworkUrl: string | null;
+    sourceName: TrackSourceName;
 }
 /**
  * LavaPlayer
  */
 export interface LavaPlayer {
     guildId: string;
-    track: TrackData;
+    track: TrackData | null;
     volume: number;
     paused: boolean;
     state: {
@@ -489,7 +506,11 @@ export interface LavaPlayer {
         ping: number;
     };
     voice: LavalinkVoiceStateResponse;
-    filters: Record<string, unknown>;
+    filters: LavalinkFilters;
+    /** NodeLink playback fading configuration. */
+    fading?: NodeLinkFadingConfig;
+    /** NodeLink loudness normalizer state. */
+    loudnessNormalizer?: boolean;
 }
 /**
  * Error or Empty Search Result
@@ -509,6 +530,15 @@ export interface TrackSearchResult {
     /** The track obtained */
     tracks: [Track];
 }
+/**
+ * Episode Search Result
+ */
+export interface EpisodeSearchResult {
+    /** The load type is always 'episode' */
+    loadType: LoadTypes.Episode;
+    /** The episode obtained */
+    tracks: [Track];
+}
 /**
  * Search Result
  */
@@ -584,8 +614,10 @@ export interface PlaylistData {
     name: string;
     /** Requester of playlist. */
     requester: AnyUser;
-    /** More playlist information. */
-    playlistInfo: PlaylistInfoData[];
+    /** Lavalink playlist information. */
+    playlistInfo: PlaylistInfoData;
+    /** Additional playlist information provided by plugins. */
+    pluginInfo: PlaylistPluginInfo;
     /** The length of the playlist. */
     duration: number;
     /** The songs of the playlist. */
@@ -595,27 +627,28 @@ export interface PlaylistData {
  * Playlist Info Data
  */
 export interface PlaylistInfoData {
-    /** Url to playlist. */
-    url: string;
-    /** Type is always playlist in that case. */
-    type: string;
-    /** ArtworkUrl of playlist */
-    artworkUrl: string;
-    /** Number of total tracks in playlist */
-    totalTracks: number;
-    /** Author of playlist */
-    author: string;
+    /** The playlist name. */
+    name: string;
+    /** The selected track index, or -1 if none is selected. */
+    selectedTrack: number;
+}
+export interface PlaylistPluginInfo extends Record<string, unknown> {
+    url?: string;
+    type?: string;
+    artworkUrl?: string;
+    totalTracks?: number;
+    author?: string;
 }
 /**
  * Manager Events
  */
 export interface ManagerEvents {
-    [ManagerEventTypes.ChapterStarted]: [player: Player, track: Track, payload: SponsorBlockChapterStarted];
-    [ManagerEventTypes.ChaptersLoaded]: [player: Player, track: Track, payload: SponsorBlockChaptersLoaded];
+    [ManagerEventTypes.ChapterStarted]: [player: Player, track: Track | null, payload: SponsorBlockChapterStarted];
+    [ManagerEventTypes.ChaptersLoaded]: [player: Player, track: Track | null, payload: SponsorBlockChaptersLoaded];
     [ManagerEventTypes.Debug]: [info: string];
-    [ManagerEventTypes.LyricsFound]: [player: Player, track: Track, payload: LyricsFoundEvent];
-    [ManagerEventTypes.LyricsLine]: [player: Player, track: Track, payload: LyricsLineEvent];
-    [ManagerEventTypes.LyricsNotFound]: [player: Player, track: Track, payload: LyricsNotFoundEvent];
+    [ManagerEventTypes.LyricsFound]: [player: Player, track: Track | null, payload: LyricsFoundEvent];
+    [ManagerEventTypes.LyricsLine]: [player: Player, track: Track | null, payload: LyricsLineEvent];
+    [ManagerEventTypes.LyricsNotFound]: [player: Player, track: Track | null, payload: LyricsNotFoundEvent];
     [ManagerEventTypes.NodeConnect]: [node: Node];
     [ManagerEventTypes.NodeCreate]: [node: Node];
     [ManagerEventTypes.NodeDestroy]: [node: Node];
@@ -634,17 +667,35 @@ export interface ManagerEvents {
     [ManagerEventTypes.PlayerStateUpdate]: [oldPlayer: Player, newPlayer: Player, changeType: PlayerStateUpdateEvent];
     [ManagerEventTypes.QueueEnd]: [player: Player, track: Track, payload: TrackEndEvent];
     [ManagerEventTypes.RestoreComplete]: [node: Node];
-    [ManagerEventTypes.SegmentSkipped]: [player: Player, track: Track, payload: SponsorBlockSegmentSkipped];
-    [ManagerEventTypes.SegmentsLoaded]: [player: Player, track: Track, payload: SponsorBlockSegmentsLoaded];
+    [ManagerEventTypes.SegmentSkipped]: [player: Player, track: Track | null, payload: SponsorBlockSegmentSkipped];
+    [ManagerEventTypes.SegmentsLoaded]: [player: Player, track: Track | null, payload: SponsorBlockSegmentsLoaded];
     [ManagerEventTypes.SocketClosed]: [player: Player, payload: WebSocketClosedEvent];
     [ManagerEventTypes.TrackEnd]: [player: Player, track: Track, payload: TrackEndEvent];
     [ManagerEventTypes.TrackError]: [player: Player, track: Track, payload: TrackExceptionEvent];
     [ManagerEventTypes.TrackStart]: [player: Player, track: Track, payload: TrackStartEvent];
     [ManagerEventTypes.TrackStuck]: [player: Player, track: Track, payload: TrackStuckEvent];
+    [ManagerEventTypes.MixStarted]: [player: Player, payload: NodeLinkMixStartedEvent];
+    [ManagerEventTypes.MixEnded]: [player: Player, payload: NodeLinkMixEndedEvent];
+    [ManagerEventTypes.NodeLinkConnectionStatus]: [node: Node, payload: NodeLinkConnectionStatusEvent];
+    [ManagerEventTypes.NodeLinkEternalBoxInfo]: [player: Player, payload: NodeLinkEternalBoxInfoEvent];
+    [ManagerEventTypes.NodeLinkEternalBoxJump]: [player: Player, payload: NodeLinkEternalBoxJumpEvent];
+    [ManagerEventTypes.NodeLinkEvent]: [node: Node, payload: NodeLinkEvent];
+    [ManagerEventTypes.NodeLinkFiltersChanged]: [player: Player, payload: NodeLinkFiltersChangedEvent];
+    [ManagerEventTypes.NodeLinkPause]: [player: Player, payload: NodeLinkPauseEvent];
+    [ManagerEventTypes.NodeLinkPlayerConnected]: [player: Player, payload: NodeLinkPlayerConnectedEvent];
+    [ManagerEventTypes.NodeLinkPlayerCreated]: [player: Player, payload: NodeLinkPlayerCreatedEvent];
+    [ManagerEventTypes.NodeLinkPlayerDestroyed]: [player: Player, payload: NodeLinkPlayerDestroyedEvent];
+    [ManagerEventTypes.NodeLinkPlayerReconnecting]: [player: Player, payload: NodeLinkPlayerReconnectingEvent];
+    [ManagerEventTypes.NodeLinkSeek]: [player: Player, payload: NodeLinkSeekEvent];
+    [ManagerEventTypes.NodeLinkStreamMetadata]: [player: Player, payload: NodeLinkStreamMetadataEvent];
+    [ManagerEventTypes.NodeLinkVolumeChanged]: [player: Player, payload: NodeLinkVolumeChangedEvent];
+    [ManagerEventTypes.NodeLinkWorkerFailed]: [node: Node, payload: NodeLinkWorkerFailedEvent];
+    [ManagerEventTypes.PlayerUpdate]: [player: Player, payload: PlayerUpdateMessage];
     [ManagerEventTypes.VoiceReceiverDisconnect]: [player: Player];
     [ManagerEventTypes.VoiceReceiverConnect]: [player: Player];
     [ManagerEventTypes.VoiceReceiverError]: [player: Player, error: Error];
     [ManagerEventTypes.VoiceReceiverStartSpeaking]: [player: Player, data: unknown];
+    [ManagerEventTypes.VoiceReceiverData]: [player: Player, data: VoiceReceiverData];
     [ManagerEventTypes.VoiceReceiverEndSpeaking]: [player: Player, data: unknown];
 }
 /**
@@ -703,16 +754,33 @@ export interface NodeStats {
     /** The cpu stats for the node. */
     cpu: CPUStats;
     /** The frame stats for the node. */
-    frameStats: FrameStats;
+    frameStats: FrameStats | null;
 }
-/**
- * Node Message
- */
-export interface NodeMessage extends NodeStats {
-    type: PlayerEventType;
-    op: "stats" | "playerUpdate" | "event";
+/** Lavalink/NodeLink ready gateway payload. */
+export interface ReadyMessage {
+    op: "ready";
+    resumed: boolean;
+    sessionId: string;
+}
+/** Lavalink/NodeLink stats gateway payload. */
+export interface StatsMessage extends NodeStats {
+    op: "stats";
+}
+/** Player state carried by a playerUpdate gateway payload. */
+export interface PlayerUpdateState {
+    time: number;
+    position: number;
+    connected: boolean;
+    ping: number;
+}
+/** Lavalink/NodeLink playerUpdate gateway payload. */
+export interface PlayerUpdateMessage {
+    op: "playerUpdate";
     guildId: string;
+    state: PlayerUpdateState;
 }
+/** Discriminated gateway payload received from Lavalink or NodeLink. */
+export type NodeMessage = ReadyMessage | StatsMessage | PlayerUpdateMessage | PlayerEvents | NodeLinkEvent;
 /**
  * PlayerEvent interface
  */
@@ -725,9 +793,10 @@ export interface PlayerEvent {
  * Exception interface
  */
 export interface Exception {
-    message: string;
+    message: string | null;
     severity: SeverityTypes;
     cause: string;
+    causeStackTrace?: string;
 }
 /**
  * TrackStartEvent interface
@@ -735,6 +804,8 @@ export interface Exception {
 export interface TrackStartEvent extends PlayerEvent {
     type: "TrackStartEvent";
     track: TrackData;
+    /** NodeLink YouTube itag selected for playback, when available. */
+    playingQuality?: number | null;
 }
 /**
  * TrackEndEvent interface
@@ -751,6 +822,7 @@ export interface TrackExceptionEvent extends PlayerEvent {
     exception?: Exception;
     guildId: string;
     type: "TrackExceptionEvent";
+    track?: TrackData | null;
 }
 /**
  * TrackStuckEvent interface
@@ -758,6 +830,8 @@ export interface TrackExceptionEvent extends PlayerEvent {
 export interface TrackStuckEvent extends PlayerEvent {
     type: "TrackStuckEvent";
     thresholdMs: number;
+    track?: TrackData | null;
+    reason?: string;
 }
 /**
  * WebSocketClosedEvent interface
@@ -772,23 +846,39 @@ export interface WebSocketClosedEvent extends PlayerEvent {
  * SponsorBlockSegmentsLoaded interface
  */
 export interface SponsorBlockSegmentsLoaded extends PlayerEvent {
-    type: "SegmentsLoaded";
+    type: "SegmentsLoaded" | "SponsorBlockSegmentsLoadedEvent";
     segments: {
         category: string;
         start: number;
         end: number;
+        /** NodeLink SponsorBlock segment id. */
+        uuid?: string;
+        actionType?: string;
+        votes?: number;
+        locked?: boolean;
+        videoDuration?: number;
+        description?: string;
     }[];
 }
 /**
  * SponsorBlockSegmentSkipped interface
  */
 export interface SponsorBlockSegmentSkipped extends PlayerEvent {
-    type: "SegmentSkipped";
+    type: "SegmentSkipped" | "SponsorBlockSegmentSkippedEvent";
     segment: {
         category: string;
         start: number;
         end: number;
+        /** NodeLink SponsorBlock segment id. */
+        uuid?: string;
+        actionType?: string;
+        votes?: number;
+        locked?: boolean;
+        videoDuration?: number;
+        description?: string;
     };
+    /** Milliseconds skipped by NodeLink. */
+    skippedMs?: number;
 }
 /**
  * SponsorBlockChapterStarted interface
@@ -804,6 +894,204 @@ export interface SponsorBlockChapterStarted extends PlayerEvent {
         duration: number;
     };
 }
+/**
+ * NodeLink SponsorBlock segment data.
+ */
+export interface NodeLinkSponsorBlockSegment {
+    uuid: string;
+    start: number;
+    end: number;
+    category: string;
+    actionType: string;
+    votes: number;
+    locked: boolean;
+    videoDuration: number;
+    description: string;
+}
+/**
+ * NodeLink SponsorBlock state.
+ */
+export interface NodeLinkSponsorBlockState {
+    enabled: boolean;
+    categories: string[];
+    actionTypes: string[];
+    segments: NodeLinkSponsorBlockSegment[];
+    lastSkippedUuid: string | null;
+    skipMarginMs: number;
+}
+/** Mutable NodeLink SponsorBlock settings accepted by PATCH. */
+export interface NodeLinkSponsorBlockUpdate {
+    enabled?: boolean;
+    categories?: string[];
+    actionTypes?: string[];
+    skipMarginMs?: number;
+}
+/**
+ * NodeLink chapter data.
+ */
+export interface NodeLinkChapter {
+    title: string;
+    startTime: number;
+    thumbnails: Array<{
+        url: string;
+        width?: number;
+        height?: number;
+        [key: string]: unknown;
+    }>;
+    duration?: number;
+    endTime?: number;
+}
+/** Track metadata accepted by NodeLink's encode endpoints. */
+export interface NodeLinkTrackEncodeInput {
+    title: string;
+    author: string;
+    length: number;
+    identifier: string;
+    isStream: boolean;
+    uri: string | null;
+    artworkUrl: string | null;
+    isrc: string | null;
+    sourceName: string;
+    position: number;
+    details: Array<string | null>;
+}
+/** NodeLink connection diagnostics response. */
+export interface NodeLinkConnectionInfo {
+    status: string;
+    metrics: Record<string, unknown> | null;
+    reason?: string;
+}
+/** NodeLink meaning endpoint response. */
+export type NodeLinkMeaningResult = {
+    loadType: "meaning";
+    data: Record<string, unknown>;
+} | {
+    loadType: "empty";
+    data: Record<string, never>;
+} | {
+    loadType: "error";
+    data: {
+        message?: string;
+        severity?: string;
+    } & Record<string, unknown>;
+};
+/** NodeLink direct track stream URL response. */
+export interface NodeLinkTrackStreamResult {
+    url?: string;
+    protocol?: string | null;
+    format?: string | null;
+    hlsUrl?: string | null;
+    formats?: Array<Record<string, unknown>>;
+    additionalData?: Record<string, unknown>;
+    exception?: Exception | null;
+}
+/** Options accepted by NodeLink's raw PCM loadstream endpoint. */
+export interface NodeLinkLoadStreamOptions {
+    volume?: number;
+    position?: number;
+    filters?: LavalinkFilters;
+}
+/**
+ * NodeLink active mix layer.
+ */
+export interface NodeLinkMix {
+    id: string;
+    track: TrackData;
+    volume: number;
+    position?: number;
+    startTime?: number;
+}
+/**
+ * NodeLink mix started event.
+ */
+export interface NodeLinkMixStartedEvent extends PlayerEvent {
+    type: "MixStartedEvent";
+    mixId: string;
+    track?: TrackData;
+    volume?: number;
+}
+/**
+ * NodeLink mix ended event.
+ */
+export interface NodeLinkMixEndedEvent extends PlayerEvent {
+    type: "MixEndedEvent";
+    mixId: string;
+    reason: string;
+}
+/** NodeLink connection diagnostics broadcast. This event is node-wide. */
+export interface NodeLinkConnectionStatusEvent {
+    op: "event";
+    type: "ConnectionStatusEvent";
+    status: string;
+    metrics: Record<string, unknown>;
+}
+/** NodeLink worker failure broadcast. This event is node-wide. */
+export interface NodeLinkWorkerFailedEvent {
+    op: "event";
+    type: "WorkerFailedEvent";
+    affectedGuilds: string[];
+    message: string;
+}
+export interface NodeLinkVolumeChangedEvent extends PlayerEvent {
+    type: "VolumeChangedEvent";
+    volume: number;
+}
+export interface NodeLinkFiltersChangedEvent extends PlayerEvent {
+    type: "FiltersChangedEvent";
+    filters: LavalinkFilters | {
+        filters: LavalinkFilters;
+    };
+}
+export interface NodeLinkSeekEvent extends PlayerEvent {
+    type: "SeekEvent";
+    position: number;
+    duration: number;
+}
+export interface NodeLinkPauseEvent extends PlayerEvent {
+    type: "PauseEvent";
+    paused: boolean;
+}
+export interface NodeLinkPlayerCreatedEvent extends PlayerEvent {
+    type: "PlayerCreatedEvent";
+    player: LavaPlayer & {
+        fading?: NodeLinkFadingConfig;
+        loudnessNormalizer?: boolean;
+    };
+}
+export interface NodeLinkPlayerDestroyedEvent extends PlayerEvent {
+    type: "PlayerDestroyedEvent";
+}
+export interface NodeLinkPlayerConnectedEvent extends PlayerEvent {
+    type: "PlayerConnectedEvent";
+    voice: LavalinkVoiceStateResponse;
+}
+export interface NodeLinkPlayerReconnectingEvent extends PlayerEvent {
+    type: "PlayerReconnectingEvent";
+    voice: LavalinkVoiceStateResponse;
+}
+export interface NodeLinkEternalBoxInfoEvent extends PlayerEvent {
+    type: "EternalBoxInfoEvent";
+    track: TrackData | null;
+    eternalbox: Record<string, unknown>;
+}
+export interface NodeLinkEternalBoxJumpEvent extends PlayerEvent {
+    type: "EternalBoxJumpEvent";
+    track: TrackData | null;
+    eternalbox: unknown;
+}
+export interface NodeLinkStreamMetadataEvent extends PlayerEvent {
+    type: "StreamMetadataEvent";
+    track: TrackData | null;
+    stream: unknown;
+}
+export type NodeLinkPlayerEvent = NodeLinkVolumeChangedEvent | NodeLinkFiltersChangedEvent | NodeLinkSeekEvent | NodeLinkPauseEvent | NodeLinkPlayerCreatedEvent | NodeLinkPlayerDestroyedEvent | NodeLinkPlayerConnectedEvent | NodeLinkPlayerReconnectingEvent | NodeLinkMixStartedEvent | NodeLinkMixEndedEvent | NodeLinkEternalBoxInfoEvent | NodeLinkEternalBoxJumpEvent | NodeLinkStreamMetadataEvent;
+export type NodeLinkKnownEvent = NodeLinkConnectionStatusEvent | NodeLinkWorkerFailedEvent | NodeLinkPlayerEvent;
+/** Forward-compatible NodeLink event payload, including plugin-defined events. */
+export type NodeLinkEvent = NodeLinkKnownEvent | ({
+    op: "event";
+    type: string;
+    guildId?: string;
+} & Record<string, unknown>);
 /**
  * SponsorBlockChaptersLoaded interface
  */
@@ -818,23 +1106,6 @@ export interface SponsorBlockChaptersLoaded extends PlayerEvent {
         duration: number;
     }[];
 }
-/**
- * NodeStats interface
- */
-export interface NodeStats {
-    /** The amount of players on the node. */
-    players: number;
-    /** The amount of playing players on the node. */
-    playingPlayers: number;
-    /** The uptime for the node. */
-    uptime: number;
-    /** The memory stats for the node. */
-    memory: MemoryStats;
-    /** The cpu stats for the node. */
-    cpu: CPUStats;
-    /** The frame stats for the node. */
-    frameStats: FrameStats;
-}
 /**
  * MemoryStats interface
  */
@@ -856,8 +1127,10 @@ export interface CPUStats {
     cores: number;
     /** The system load. */
     systemLoad: number;
-    /** The lavalink load. */
+    /** The Lavalink process load. Normalized from nodelinkLoad on NodeLink. */
     lavalinkLoad: number;
+    /** The native NodeLink process load, when reported by NodeLink. */
+    nodelinkLoad?: number;
 }
 /**
  * FrameStats interface
@@ -869,6 +1142,8 @@ export interface FrameStats {
     nulled?: number;
     /** The amount of deficit frames. */
     deficit?: number;
+    /** The expected frame count reported by NodeLink. */
+    expected?: number;
 }
 /**
  * LavalinkInfo interface
@@ -879,7 +1154,7 @@ export interface LavalinkInfo {
         major: number;
         minor: number;
         patch: number;
-        preRelease: string;
+        preRelease: string | null;
     };
     buildTime: number;
     git: {
@@ -887,13 +1162,21 @@ export interface LavalinkInfo {
         commit: string;
         commitTime: number;
     };
-    jvm: string;
-    lavaplayer: string;
+    jvm?: string;
+    lavaplayer?: string;
+    node?: string;
+    voice?: {
+        name: string;
+        version: string;
+    };
+    isNodelink?: boolean;
     sourceManagers: string[];
     filters: string[];
     plugins: {
         name: string;
         version: string;
+        author?: string | null;
+        path?: string | null;
     }[];
 }
 /**
@@ -903,17 +1186,21 @@ export interface LyricsLine {
     timestamp: number;
     duration: number;
     line: string;
-    plugin: object;
+    words?: Array<Record<string, unknown>>;
+    plugin: Record<string, unknown>;
 }
 /**
  * Lyrics interface
  */
 export interface Lyrics {
-    source: string;
-    provider: string;
-    text?: string;
+    /** Lavalink lyrics plugin source field. */
+    source?: string | null;
+    /** NodeLink lyrics source field. */
+    sourceName?: string | null;
+    provider: string | null;
+    text?: string | null;
     lines: LyricsLine[];
-    plugin: object[];
+    plugin: Record<string, unknown> | Array<Record<string, unknown>>;
 }
 /**
  * LyricsFoundEvent interface
@@ -947,6 +1234,23 @@ export interface NodeLinkGetLyricsMultiple {
     loadType: "lyricsMultiple";
     data: NodeLinkGetLyricsData[];
 }
+/**
+ * NodeLink Get Lyrics interface
+ */
+export interface NodeLinkGetLyricsLyrics {
+    loadType: "lyrics";
+    data: {
+        name?: string;
+        synced?: boolean;
+        provider?: string;
+        lines?: {
+            time: number;
+            duration?: number;
+            text: string;
+            words?: Record<string, unknown>[];
+        }[];
+    };
+}
 /**
  * NodeLink Get Lyrics Empty interface
  */
@@ -981,11 +1285,22 @@ export interface NodeLinkGetLyricsError {
     loadType: "error";
     data: {
         message: string;
-        severity: Severity;
-        cause: string;
+        severity: Severity | string;
+        cause?: string;
         trace?: string;
     };
 }
+/** Audio format names used by NodeLink voice receive frames. */
+export type NodeLinkVoiceReceiveFormat = "opus" | "pcm_s16le" | "ogg";
+/** A single NodeLink voice receive audio frame. */
+export interface VoiceReceiverData {
+    userId: string;
+    guildId: string;
+    data: Buffer;
+    type: NodeLinkVoiceReceiveFormat;
+    ssrc: number;
+    timestamp: number;
+}
 /**
  * Start Speaking Event Voice Receiver Data interface
  */
@@ -998,6 +1313,12 @@ export interface StartSpeakingEventVoiceReceiverData {
      * The guild ID of the guild where the user started speaking.
      */
     guildId: string;
+    /** The SSRC identifier of the speaking user. */
+    ssrc?: number;
+    /** The audio frame type sent by NodeLink. */
+    type?: NodeLinkVoiceReceiveFormat;
+    /** The timestamp sent by NodeLink for the start frame. */
+    timestamp?: number;
 }
 /**
  * End Speaking Event Voice Receiver Data interface
@@ -1014,11 +1335,15 @@ export interface EndSpeakingEventVoiceReceiverData {
     /**
      * The audio data received from the user in base64.
      */
-    data: string;
+    data: string | Buffer;
     /**
      * The type of the audio data. Can be either opus or pcm. Older versions may include ogg/opus.
      */
-    type: "opus" | "pcm";
+    type: NodeLinkVoiceReceiveFormat;
+    /** The SSRC identifier of the speaking user. */
+    ssrc?: number;
+    /** The timestamp sent by NodeLink for the final frame. */
+    timestamp?: number;
 }
 /**
  * Base Voice Receiver Event interface
@@ -1073,6 +1398,33 @@ export interface PlayOptions {
     readonly endTime?: number;
     /** Whether to not replace the track if a play payload is sent. */
     readonly noReplace?: boolean;
+    /** NodeLink optional audio track id for alternate audio tracks. */
+    readonly audioTrackId?: string;
+    /** Legacy NodeLink alias for audioTrackId. */
+    readonly language?: string;
+    /** NodeLink loudness normalizer toggle. */
+    readonly loudnessNormalizer?: boolean;
+}
+/** NodeLink options for a preloaded next track. */
+export interface NodeLinkNextTrackOptions {
+    readonly audioTrackId?: string;
+    readonly language?: string;
+}
+/** NodeLink fade action configuration. */
+export interface NodeLinkFadingSection {
+    duration: number;
+    curve?: string;
+    type?: "volume" | "tape" | "scratch" | "both";
+}
+/** NodeLink fading configuration accepted by Update Player. */
+export interface NodeLinkFadingConfig {
+    enabled?: boolean;
+    trackStart?: NodeLinkFadingSection;
+    trackEnd?: NodeLinkFadingSection;
+    trackStop?: NodeLinkFadingSection;
+    seek?: NodeLinkFadingSection;
+    pause?: NodeLinkFadingSection;
+    resume?: NodeLinkFadingSection;
 }
 /**
  * RestPlayOptions interface
@@ -1091,7 +1443,23 @@ export interface RestPlayOptions {
             identifier?: string | null;
             /** The user data of the track. */
             userData?: object;
+            /** NodeLink optional audio track id for alternate audio tracks. */
+            audioTrackId?: string | null;
+            /** Legacy NodeLink alias for audioTrackId. */
+            language?: string | null;
         };
+        /** NodeLink next track preload payload. */
+        nextTrack?: {
+            encoded?: string | null;
+            identifier?: string | null;
+            userData?: object;
+            audioTrackId?: string | null;
+            language?: string | null;
+        } | null;
+        /** NodeLink loudness normalizer toggle. */
+        loudnessNormalizer?: boolean;
+        /** NodeLink playback fading configuration. */
+        fading?: NodeLinkFadingConfig;
         /** The player position in a track. */
         position?: number;
         /** The track time to end at. */
@@ -1101,7 +1469,7 @@ export interface RestPlayOptions {
         /** Whether the player is paused. */
         paused?: boolean;
         /** The audio effects. */
-        filters?: object;
+        filters?: LavalinkFilters;
         /** voice payload. */
         voice?: LavalinkVoiceStateUpdate;
     };
@@ -1140,12 +1508,25 @@ export interface SerializedPlayerState {
     filters: {
         bassBoostlevel: number | null;
         equalizer: EqualizerBand[];
-        distortion: DistortionOptions;
-        karaoke: KaraokeOptions;
-        timescale: TimescaleOptions;
-        vibrato: VibratoOptions;
-        rotation: RotationOptions;
-        reverb: ReverbOptions;
+        distortion: DistortionOptions | null;
+        karaoke: KaraokeOptions | null;
+        timescale: TimescaleOptions | null;
+        tremolo: TremoloOptions | null;
+        vibrato: VibratoOptions | null;
+        rotation: RotationOptions | null;
+        channelMix: ChannelMixOptions | null;
+        lowPass: LowPassOptions | null;
+        highpass: HighPassOptions | null;
+        echo: EchoOptions | null;
+        chorus: ChorusOptions | null;
+        compressor: CompressorOptions | null;
+        flanger: FlangerOptions | null;
+        phaser: PhaserOptions | null;
+        phonograph: PhonographOptions | null;
+        spatial: SpatialOptions | null;
+        tape: TapeOptions | null;
+        pluginFilters: Record<string, unknown>;
+        reverb: ReverbOptions | null;
         volume: number;
         filterStatus: Record<string, boolean>;
     } | null;
@@ -1183,6 +1564,26 @@ export interface LavalinkSession {
     resuming?: boolean;
     timeout?: number;
 }
+export interface RoutePlannerStatus {
+    class: "RotatingIpRoutePlanner" | "NanoIpRoutePlanner" | "RotatingNanoIpRoutePlanner" | "BalancingIpRoutePlanner";
+    details: RoutePlannerDetails;
+}
+export interface RoutePlannerDetails {
+    ipBlock: {
+        type: "Inet4Address" | "Inet6Address";
+        size: string;
+    };
+    failingAddresses: {
+        failingAddress: string;
+        failingTimestamp: number;
+        failingTime: string;
+    }[];
+    rotateIndex?: string;
+    ipIndex?: string;
+    currentAddress?: string;
+    currentAddressIndex?: string;
+    blockIndex?: string;
+}
 /**
  * ManagerInitOptions interface
  */
@@ -1199,20 +1600,36 @@ export interface EqualizerBand {
     /** The gain amount being -0.25 to 1.00, 0.25 being double. */
     gain: number;
 }
+export interface AnimationTransition {
+    durationMs: number;
+    curve?: string;
+}
 /** Options for adjusting the timescale of audio. */
 export interface TimescaleOptions {
     speed?: number;
     pitch?: number;
     rate?: number;
+    transition?: AnimationTransition;
+}
+/** Options for applying tremolo effect to audio. */
+export interface TremoloOptions {
+    frequency?: number;
+    depth?: number;
+    alpha?: number;
+    transition?: AnimationTransition;
 }
 /** Options for applying vibrato effect to audio. */
 export interface VibratoOptions {
-    frequency: number;
-    depth: number;
+    frequency?: number;
+    depth?: number;
+    alpha?: number;
+    transition?: AnimationTransition;
 }
 /** Options for applying rotation effect to audio. */
 export interface RotationOptions {
     rotationHz: number;
+    alpha?: number;
+    transition?: AnimationTransition;
 }
 /** Options for applying karaoke effect to audio. */
 export interface KaraokeOptions {
@@ -1220,6 +1637,8 @@ export interface KaraokeOptions {
     monoLevel?: number;
     filterBand?: number;
     filterWidth?: number;
+    alpha?: number;
+    transition?: AnimationTransition;
 }
 /** Options for applying distortion effect to audio. */
 export interface DistortionOptions {
@@ -1231,13 +1650,149 @@ export interface DistortionOptions {
     tanScale?: number;
     offset?: number;
     scale?: number;
-}
-/** Options for applying reverb effect to audio. */
+    alpha?: number;
+    transition?: AnimationTransition;
+}
+/** Options for mixing stereo channels. */
+export interface ChannelMixOptions {
+    leftToLeft?: number;
+    leftToRight?: number;
+    rightToLeft?: number;
+    rightToRight?: number;
+    transition?: AnimationTransition;
+}
+/** Options for applying a low pass filter. */
+export interface LowPassOptions {
+    smoothing?: number;
+    targetAlpha?: number;
+    logSmoothing?: number;
+    transition?: AnimationTransition;
+}
+/** Options for applying a high pass filter. */
+export interface HighPassOptions {
+    smoothing?: number;
+    targetAlpha?: number;
+    transition?: AnimationTransition;
+}
+/** Options for applying an echo filter. */
+export interface EchoOptions {
+    delay?: number;
+    feedback?: number;
+    mix?: number;
+    alpha?: number;
+    transition?: AnimationTransition;
+}
+/** Options for applying a reverb filter. */
 export interface ReverbOptions {
     wet?: number;
     dry?: number;
     roomSize?: number;
     damping?: number;
+    wetLevel?: number;
+    dryLevel?: number;
+    width?: number;
+    mix?: number;
+    alpha?: number;
+    transition?: AnimationTransition;
+}
+/** Options for applying a chorus filter. */
+export interface ChorusOptions {
+    rate?: number;
+    depth?: number;
+    feedback?: number;
+    delay?: number;
+    mix?: number;
+    alpha?: number;
+    transition?: AnimationTransition;
+}
+/** Options for applying a compressor filter. */
+export interface CompressorOptions {
+    threshold?: number;
+    ratio?: number;
+    attack?: number;
+    release?: number;
+    gain?: number;
+    makeupGain?: number;
+    alpha?: number;
+    transition?: AnimationTransition;
+}
+/** Options for applying a flanger filter. */
+export interface FlangerOptions {
+    rate?: number;
+    depth?: number;
+    feedback?: number;
+    delay?: number;
+    mix?: number;
+    alpha?: number;
+    transition?: AnimationTransition;
+}
+/** Options for applying a phaser filter. */
+export interface PhaserOptions {
+    rate?: number;
+    depth?: number;
+    feedback?: number;
+    delay?: number;
+    mix?: number;
+    stages?: number;
+    minFrequency?: number;
+    maxFrequency?: number;
+    alpha?: number;
+    transition?: AnimationTransition;
+}
+/** Options for applying a spatial audio filter. */
+export interface SpatialOptions {
+    x?: number;
+    y?: number;
+    z?: number;
+    depth?: number;
+    rate?: number;
+    alpha?: number;
+    transition?: AnimationTransition;
+}
+/** Options for applying a phonograph filter. */
+export interface PhonographOptions {
+    frequency?: number;
+    depth?: number;
+    crackle?: number;
+    flutter?: number;
+    room?: number;
+    micAgc?: number;
+    drive?: number;
+    alpha?: number;
+    transition?: AnimationTransition;
+}
+/** Options for applying a tape filter. */
+export interface TapeOptions {
+    duration?: number;
+    type?: "start" | "stop";
+    curve?: string;
+}
+export interface LavalinkFilters {
+    volume?: number;
+    equalizer?: EqualizerBand[] | {
+        bands?: EqualizerBand[];
+        transition?: AnimationTransition;
+    };
+    karaoke?: KaraokeOptions | null;
+    timescale?: TimescaleOptions | null;
+    tremolo?: TremoloOptions | null;
+    vibrato?: VibratoOptions | null;
+    distortion?: DistortionOptions | null;
+    rotation?: RotationOptions | null;
+    channelMix?: ChannelMixOptions | null;
+    lowPass?: LowPassOptions | null;
+    lowpass?: LowPassOptions | null;
+    highpass?: HighPassOptions | null;
+    echo?: EchoOptions | null;
+    reverb?: ReverbOptions | null;
+    chorus?: ChorusOptions | null;
+    compressor?: CompressorOptions | null;
+    flanger?: FlangerOptions | null;
+    phaser?: PhaserOptions | null;
+    phonograph?: PhonographOptions | null;
+    spatial?: SpatialOptions | null;
+    tape?: TapeOptions | null;
+    pluginFilters?: Record<string, unknown>;
 }
 export interface LastFmResponse {
     error?: number;
@@ -1305,7 +1860,7 @@ export type Sizes = "0" | "1" | "2" | "3" | "default" | "mqdefault" | "hqdefault
 /**
  * Track Source Name Enum type
  */
-export type TrackSourceName = keyof typeof TrackSourceTypes;
+export type TrackSourceName = `${TrackSourceTypes}` | string;
 /**
  * Use Node Option Enum type
  */
@@ -1317,7 +1872,7 @@ export type TrackEndReason = keyof typeof TrackEndReasonTypes;
 /**
  * Player Event Type Enum type
  */
-export type PlayerEventType = "TrackStartEvent" | "TrackEndEvent" | "TrackExceptionEvent" | "TrackStuckEvent" | "WebSocketClosedEvent" | "SegmentSkipped" | "SegmentsLoaded" | "ChaptersLoaded" | "ChapterStarted" | "LyricsFoundEvent" | "LyricsNotFoundEvent" | "LyricsLineEvent";
+export type PlayerEventType = "TrackStartEvent" | "TrackEndEvent" | "TrackExceptionEvent" | "TrackStuckEvent" | "MixStartedEvent" | "MixEndedEvent" | "WebSocketClosedEvent" | "SegmentSkipped" | "SegmentsLoaded" | "SponsorBlockSegmentSkippedEvent" | "SponsorBlockSegmentsLoadedEvent" | "ChaptersLoaded" | "ChapterStarted" | "LyricsFoundEvent" | "LyricsNotFoundEvent" | "LyricsLineEvent" | "VolumeChangedEvent" | "FiltersChangedEvent" | "SeekEvent" | "PauseEvent" | "PlayerCreatedEvent" | "PlayerDestroyedEvent" | "PlayerReconnectingEvent" | "PlayerConnectedEvent" | "EternalBoxInfoEvent" | "EternalBoxJumpEvent" | "StreamMetadataEvent";
 /**
  * Severity Types Enum type
  */
@@ -1329,11 +1884,11 @@ export type SponsorBlockSegmentEvents = SponsorBlockSegmentSkipped | SponsorBloc
 /**
  * SponsorBlock Segment Event Type Enum type
  */
-export type SponsorBlockSegmentEventType = "SegmentSkipped" | "SegmentsLoaded" | "ChapterStarted" | "ChaptersLoaded";
+export type SponsorBlockSegmentEventType = "SegmentSkipped" | "SegmentsLoaded" | "SponsorBlockSegmentSkippedEvent" | "SponsorBlockSegmentsLoadedEvent" | "ChapterStarted" | "ChaptersLoaded";
 /**
  * Player Events Enum type
  */
-export type PlayerEvents = TrackStartEvent | TrackEndEvent | TrackStuckEvent | TrackExceptionEvent | WebSocketClosedEvent | SponsorBlockSegmentEvents | LyricsEvent;
+export type PlayerEvents = TrackStartEvent | TrackEndEvent | TrackStuckEvent | TrackExceptionEvent | WebSocketClosedEvent | SponsorBlockSegmentEvents | LyricsEvent | NodeLinkPlayerEvent;
 /**
  * Load Type Enum type
  */
@@ -1341,7 +1896,7 @@ export type LoadType = keyof typeof LoadTypes;
 /**
  * NodeLink Get Lyrics Enum type
  */
-export type NodeLinkGetLyrics = NodeLinkGetLyricsSingle | NodeLinkGetLyricsMultiple | NodeLinkGetLyricsEmpty | NodeLinkGetLyricsError;
+export type NodeLinkGetLyrics = NodeLinkGetLyricsLyrics | NodeLinkGetLyricsSingle | NodeLinkGetLyricsMultiple | NodeLinkGetLyricsEmpty | NodeLinkGetLyricsError;
 /**
  * Voice Receiver Event Enum type
  */
@@ -1349,7 +1904,7 @@ export type VoiceReceiverEvent = StartSpeakingEventVoiceReceiver | EndSpeakingEv
 /**
  * Search Result Enum type
  */
-export type SearchResult = TrackSearchResult | SearchSearchResult | PlaylistSearchResult | ErrorOrEmptySearchResult | AlbumSearchResult | ArtistSearchResult | StationSearchResult | PodcastSearchResult | ShowSearchResult | ShortSearchResult;
+export type SearchResult = TrackSearchResult | EpisodeSearchResult | SearchSearchResult | PlaylistSearchResult | ErrorOrEmptySearchResult | AlbumSearchResult | ArtistSearchResult | StationSearchResult | PodcastSearchResult | ShowSearchResult | ShortSearchResult;
 /**
  * Lyrics Event Enum type
  */