lavalink-client 2.7.5 → 2.7.7

package/dist/index.d.mts

@@ -1959,6 +1959,66 @@ interface PlayOptions extends LavalinkPlayOptions {
     clientTrack?: Track | UnresolvedTrack;
 }
 
+type NodeLinkEventTypes = "PlayerCreatedEvent" | "PlayerDestroyedEvent" | "PlayerConnectedEvent" | "PlayerReconnectingEvent" | "VolumeChangedEvent" | "FiltersChangedEvent" | "SeekEvent" | "PauseEvent" | "ConnectionStatusEvent" | "MixStartedEvent" | "MixEndedEvent";
+interface NodeLinkBaseEvent {
+    op: "event";
+    type: NodeLinkEventTypes;
+    guildId: string;
+}
+interface PlayerCreatedEvent extends NodeLinkBaseEvent {
+    type: "PlayerCreatedEvent";
+}
+interface PlayerDestroyedEvent extends NodeLinkBaseEvent {
+    type: "PlayerDestroyedEvent";
+}
+interface PlayerConnectedEvent extends NodeLinkBaseEvent {
+    type: "PlayerConnectedEvent";
+}
+interface PlayerReconnectingEvent extends NodeLinkBaseEvent {
+    type: "PlayerReconnectingEvent";
+}
+interface VolumeChangedEvent extends NodeLinkBaseEvent {
+    type: "VolumeChangedEvent";
+    /** New volume level (0-1000) */
+    volume: number;
+}
+interface FiltersChangedEvent extends NodeLinkBaseEvent {
+    type: "FiltersChangedEvent";
+    filters: LavalinkFilterData;
+}
+interface SeekEvent extends NodeLinkBaseEvent {
+    type: "SeekEvent";
+    /** New position in milliseconds */
+    position: number;
+}
+interface PauseEvent extends NodeLinkBaseEvent {
+    type: "PauseEvent";
+    /** Whether playback is now paused (true) or resumed (false) */
+    paused: boolean;
+}
+interface ConnectionStatusEvent extends NodeLinkBaseEvent {
+    type: "ConnectionStatusEvent";
+    /** Current connection status */
+    connected: boolean;
+}
+interface MixStartedEvent extends NodeLinkBaseEvent {
+    type: "MixStartedEvent";
+    /** Unique identifier for the mix layer */
+    mixId: string;
+    /** Full track information of the mixed layer */
+    track: LavalinkTrack;
+    /** Volume of the mixed layer (0.0 to 1.0) */
+    volume: number;
+}
+interface MixEndedEvent extends NodeLinkBaseEvent {
+    type: "MixEndedEvent";
+    /** Unique identifier for the mix layer */
+    mixId: string;
+    /** Reason the mix layer ended (FINISHED, REMOVED, ERROR, MAIN_ENDED) */
+    reason: "FINISHED" | "REMOVED" | "ERROR" | "MAIN_ENDED" | string;
+}
+type NodeLinkEventPayload<T extends NodeLinkEventTypes> = T extends "PlayerCreatedEvent" ? PlayerCreatedEvent : T extends "PlayerDestroyedEvent" ? PlayerDestroyedEvent : T extends "PlayerConnectedEvent" ? PlayerConnectedEvent : T extends "PlayerReconnectingEvent" ? PlayerReconnectingEvent : T extends "VolumeChangedEvent" ? VolumeChangedEvent : T extends "FiltersChangedEvent" ? FiltersChangedEvent : T extends "SeekEvent" ? SeekEvent : T extends "PauseEvent" ? PauseEvent : T extends "ConnectionStatusEvent" ? ConnectionStatusEvent : T extends "MixStartedEvent" ? MixStartedEvent : T extends "MixEndedEvent" ? MixEndedEvent : never;
+
 /** Ability to manipulate fetch requests */
 type ModifyRequest = (options: RequestInit & {
     path: string;
@@ -2050,12 +2110,41 @@ interface BaseNodeStats {
     /** The frame stats for the node. */
     frameStats: FrameStats;
 }
+interface NodeLinkConnectionMetrics {
+    status: string;
+    metrics: {
+        speed: {
+            bps: number;
+            kbps: number;
+            mbps: number;
+        };
+        downloadedBytes: number;
+        durationSeconds: number;
+        timestamp: number;
+    };
+}
 /**
  * Interface for nodeStats from lavalink
  */
 interface NodeStats extends BaseNodeStats {
     /** The frame stats for the node. */
     frameStats: FrameStats;
+    /** something from nodeLink https://nodelink.js.org/docs/differences#detailed-statistics */
+    detailedStats?: {
+        api: {
+            /** e.g. { "/v4/loadtracks": 150, "/v4/info": 5 }  */
+            requests: Record<string, number>;
+            errors: unknown;
+        };
+        /** e.g. { "youtube": 150, "soundcloud": 5 } */
+        sources: Record<string, number>;
+        playback: {
+            /** e.g. { "TrackStartEvent": 150, "TrackEndEvent": 5 } */
+            events: Record<string, number>;
+        };
+        /** and potential others */
+        [key: string]: unknown;
+    };
 }
 /**
  * Entire lavalink information object from lavalink
@@ -2077,6 +2166,8 @@ interface LavalinkInfo {
     filters: string[];
     /** The enabled plugins for this server */
     plugins: PluginObject[];
+    /** Something from NodeLink: https://nodelink.js.org/docs/differences#server-info */
+    isNodelink?: boolean;
 }
 /**
  * Lavalink's version object from lavalink
@@ -2193,6 +2284,25 @@ interface NodeManagerEvents {
         sessionId: string;
         op: "ready";
     }, players: LavalinkPlayer[] | InvalidLavalinkRestRequest) => void;
+    /**
+     * Event Handler for Nodelink specific events https://nodelink.js.org/docs/api/websocket Fully typed and generic based on the eventName.
+     * @event Manager.nodeManager#nodeLinkEvent
+     * @example
+     *
+     * ```ts
+     * this.nodeManager.on("nodeLinkEvent", (node, event, player, track, payload) => {
+     *   if (event === "SeekEvent") {
+     *       console.log("new position:", payload.position);
+     *   }
+     *   if (event === "FiltersChangedEvent") {
+     *       console.log("new filters state", payload.filters);
+     *   }
+     * });
+     * ```
+     */
+    "nodeLinkEvent": (...args: {
+        [K in NodeLinkEventTypes]: [node: LavalinkNode, event: K, player: Player, track: Track | null, payload: NodeLinkEventPayload<K>];
+    }[NodeLinkEventTypes]) => void;
 }
 declare enum ReconnectionState {
     IDLE = "IDLE",
@@ -2565,6 +2675,16 @@ declare class LavalinkNode {
      * ```
      */
     fetchStats(): Promise<BaseNodeStats>;
+    /**
+     * Request NodeLink connection metrics. https://nodelink.js.org/docs/differences#connection-metrics
+     * @returns the connection metrics of the node
+     *
+     * @example
+     * ```ts
+     * const connectionMetrics = await player.node.fetchConnectionMetrics();
+     * ```
+     */
+    fetchConnectionMetrics(): Promise<NodeLinkConnectionMetrics>;
     /**
      * Request Lavalink version.
      * @returns the current used lavalink version
@@ -2680,6 +2800,14 @@ declare class LavalinkNode {
     private message;
     /** @private middleware util function for handling all kind of events from websocket */
     private handleEvent;
+    /**
+     * nodeLink specific events handling https://nodelink.js.org/docs/api/websocket#incoming-events-server--client
+     * @param eventName
+     * @param player
+     * @param track
+     * @param payload
+     */
+    private nodeLinkEventHandler;
     private getTrackOfPayload;
     /** @private util function for handling trackStart event */
     private trackStart;
@@ -3387,4 +3515,4 @@ declare const LavalinkPlugins: {
 /** Lavalink Sources regexes for url validations */
 declare const SourceLinksRegexes: Record<SourcesRegex, RegExp>;
 
-export { type AudioOutputs, type Awaitable, type Base64, type BaseNodeStats, type BasePlayOptions, type BotClientOptions, type CPUStats, type ChannelDeletePacket, type ChannelMixFilter, type ClientCustomSearchPlatformUtils, type ClientSearchPlatform, DebugEvents, type DeepRequired, DefaultQueueStore, DefaultSources, DestroyReasons, type DestroyReasonsType, DisconnectReasons, type DisconnectReasonsType, type DistortionFilter, type DuncteSearchPlatform, type EQBand, EQList, type Exception, type FailingAddress, type FilterData, FilterManager, type FloatNumber, type FrameStats, type GitObject, type GuildShardPayload, type IntegerNumber, type InvalidLavalinkRestRequest, type JioSaavnSearchPlatform, type KaraokeFilter, type LavaSearchFilteredResponse, type LavaSearchQuery, type LavaSearchResponse, type LavaSearchType, type LavaSrcSearchPlatform, type LavaSrcSearchPlatformBase, type LavalinkClientSearchPlatform, type LavalinkClientSearchPlatformResolve, type LavalinkFilterData, type LavalinkInfo, LavalinkManager, type LavalinkManagerEvents, LavalinkNode, type LavalinkNodeIdentifier, type LavalinkNodeOptions, type LavalinkPlayOptions, type LavalinkPlayer, type LavalinkPlayerVoice, type LavalinkPlayerVoiceOptions, type LavalinkPlugin_JioSaavn_SourceNames, type LavalinkPlugin_LavaSrc_SourceNames, LavalinkPlugins, type LavalinkSearchPlatform, type LavalinkSourceNames, type LavalinkTrack, type LavalinkTrackInfo, type LoadTypes, type LowPassFilter, type LyricsEvent, type LyricsEventType, type LyricsFoundEvent, type LyricsLine, type LyricsLineEvent, type LyricsNotFoundEvent, type LyricsResult, type ManagerOptions, type ManagerPlayerOptions, type ManagerQueueOptions, ManagerUtils, type MemoryStats, MiniMap, type MiniMapConstructor, type ModifyRequest, NodeManager, type NodeManagerEvents, type NodeMessage, type NodeStats, NodeSymbol, type Opaque, type PlayOptions, Player, type PlayerEvent, type PlayerEventType, type PlayerEvents, type PlayerFilters, type PlayerJson, type PlayerOptions, type PlayerUpdateInfo, type PlaylistInfo, type PluginInfo, type PluginObject, Queue, type QueueChangesWatcher, QueueSaver, type QueueStoreManager, QueueSymbol, ReconnectionState, type RepeatMode, type RequiredManagerOptions, type RotationFilter, type RoutePlanner, type RoutePlannerTypes, type SearchPlatform, type SearchQuery, type SearchResult, type Session, type Severity, SourceLinksRegexes, type SourceNames, type SourcesRegex, type SponsorBlockChapterStarted, type SponsorBlockChaptersLoaded, type SponsorBlockSegment, type SponsorBlockSegmentEventType, type SponsorBlockSegmentEvents, type SponsorBlockSegmentSkipped, type SponsorBlockSegmentsLoaded, type State, type StoredQueue, type TimescaleFilter, type Track, type TrackEndEvent, type TrackEndReason, type TrackExceptionEvent, type TrackInfo, type TrackStartEvent, type TrackStuckEvent, TrackSymbol, type TremoloFilter, type UnresolvedQuery, type UnresolvedSearchResult, type UnresolvedTrack, type UnresolvedTrackInfo, UnresolvedTrackSymbol, type VersionObject, type VibratoFilter, type VoicePacket, type VoiceServer, type VoiceState, type WebSocketClosedEvent, type anyObject, audioOutputsData, parseLavalinkConnUrl, queueTrackEnd, safeStringify, validSponsorBlocks };
+export { type AudioOutputs, type Awaitable, type Base64, type BaseNodeStats, type BasePlayOptions, type BotClientOptions, type CPUStats, type ChannelDeletePacket, type ChannelMixFilter, type ClientCustomSearchPlatformUtils, type ClientSearchPlatform, DebugEvents, type DeepRequired, DefaultQueueStore, DefaultSources, DestroyReasons, type DestroyReasonsType, DisconnectReasons, type DisconnectReasonsType, type DistortionFilter, type DuncteSearchPlatform, type EQBand, EQList, type Exception, type FailingAddress, type FilterData, FilterManager, type FloatNumber, type FrameStats, type GitObject, type GuildShardPayload, type IntegerNumber, type InvalidLavalinkRestRequest, type JioSaavnSearchPlatform, type KaraokeFilter, type LavaSearchFilteredResponse, type LavaSearchQuery, type LavaSearchResponse, type LavaSearchType, type LavaSrcSearchPlatform, type LavaSrcSearchPlatformBase, type LavalinkClientSearchPlatform, type LavalinkClientSearchPlatformResolve, type LavalinkFilterData, type LavalinkInfo, LavalinkManager, type LavalinkManagerEvents, LavalinkNode, type LavalinkNodeIdentifier, type LavalinkNodeOptions, type LavalinkPlayOptions, type LavalinkPlayer, type LavalinkPlayerVoice, type LavalinkPlayerVoiceOptions, type LavalinkPlugin_JioSaavn_SourceNames, type LavalinkPlugin_LavaSrc_SourceNames, LavalinkPlugins, type LavalinkSearchPlatform, type LavalinkSourceNames, type LavalinkTrack, type LavalinkTrackInfo, type LoadTypes, type LowPassFilter, type LyricsEvent, type LyricsEventType, type LyricsFoundEvent, type LyricsLine, type LyricsLineEvent, type LyricsNotFoundEvent, type LyricsResult, type ManagerOptions, type ManagerPlayerOptions, type ManagerQueueOptions, ManagerUtils, type MemoryStats, MiniMap, type MiniMapConstructor, type ModifyRequest, type NodeLinkConnectionMetrics, NodeManager, type NodeManagerEvents, type NodeMessage, type NodeStats, NodeSymbol, type Opaque, type PlayOptions, Player, type PlayerEvent, type PlayerEventType, type PlayerEvents, type PlayerFilters, type PlayerJson, type PlayerOptions, type PlayerUpdateInfo, type PlaylistInfo, type PluginInfo, type PluginObject, Queue, type QueueChangesWatcher, QueueSaver, type QueueStoreManager, QueueSymbol, ReconnectionState, type RepeatMode, type RequiredManagerOptions, type RotationFilter, type RoutePlanner, type RoutePlannerTypes, type SearchPlatform, type SearchQuery, type SearchResult, type Session, type Severity, SourceLinksRegexes, type SourceNames, type SourcesRegex, type SponsorBlockChapterStarted, type SponsorBlockChaptersLoaded, type SponsorBlockSegment, type SponsorBlockSegmentEventType, type SponsorBlockSegmentEvents, type SponsorBlockSegmentSkipped, type SponsorBlockSegmentsLoaded, type State, type StoredQueue, type TimescaleFilter, type Track, type TrackEndEvent, type TrackEndReason, type TrackExceptionEvent, type TrackInfo, type TrackStartEvent, type TrackStuckEvent, TrackSymbol, type TremoloFilter, type UnresolvedQuery, type UnresolvedSearchResult, type UnresolvedTrack, type UnresolvedTrackInfo, UnresolvedTrackSymbol, type VersionObject, type VibratoFilter, type VoicePacket, type VoiceServer, type VoiceState, type WebSocketClosedEvent, type anyObject, audioOutputsData, parseLavalinkConnUrl, queueTrackEnd, safeStringify, validSponsorBlocks };

package/dist/index.d.ts

@@ -1959,6 +1959,66 @@ interface PlayOptions extends LavalinkPlayOptions {
     clientTrack?: Track | UnresolvedTrack;
 }
 
+type NodeLinkEventTypes = "PlayerCreatedEvent" | "PlayerDestroyedEvent" | "PlayerConnectedEvent" | "PlayerReconnectingEvent" | "VolumeChangedEvent" | "FiltersChangedEvent" | "SeekEvent" | "PauseEvent" | "ConnectionStatusEvent" | "MixStartedEvent" | "MixEndedEvent";
+interface NodeLinkBaseEvent {
+    op: "event";
+    type: NodeLinkEventTypes;
+    guildId: string;
+}
+interface PlayerCreatedEvent extends NodeLinkBaseEvent {
+    type: "PlayerCreatedEvent";
+}
+interface PlayerDestroyedEvent extends NodeLinkBaseEvent {
+    type: "PlayerDestroyedEvent";
+}
+interface PlayerConnectedEvent extends NodeLinkBaseEvent {
+    type: "PlayerConnectedEvent";
+}
+interface PlayerReconnectingEvent extends NodeLinkBaseEvent {
+    type: "PlayerReconnectingEvent";
+}
+interface VolumeChangedEvent extends NodeLinkBaseEvent {
+    type: "VolumeChangedEvent";
+    /** New volume level (0-1000) */
+    volume: number;
+}
+interface FiltersChangedEvent extends NodeLinkBaseEvent {
+    type: "FiltersChangedEvent";
+    filters: LavalinkFilterData;
+}
+interface SeekEvent extends NodeLinkBaseEvent {
+    type: "SeekEvent";
+    /** New position in milliseconds */
+    position: number;
+}
+interface PauseEvent extends NodeLinkBaseEvent {
+    type: "PauseEvent";
+    /** Whether playback is now paused (true) or resumed (false) */
+    paused: boolean;
+}
+interface ConnectionStatusEvent extends NodeLinkBaseEvent {
+    type: "ConnectionStatusEvent";
+    /** Current connection status */
+    connected: boolean;
+}
+interface MixStartedEvent extends NodeLinkBaseEvent {
+    type: "MixStartedEvent";
+    /** Unique identifier for the mix layer */
+    mixId: string;
+    /** Full track information of the mixed layer */
+    track: LavalinkTrack;
+    /** Volume of the mixed layer (0.0 to 1.0) */
+    volume: number;
+}
+interface MixEndedEvent extends NodeLinkBaseEvent {
+    type: "MixEndedEvent";
+    /** Unique identifier for the mix layer */
+    mixId: string;
+    /** Reason the mix layer ended (FINISHED, REMOVED, ERROR, MAIN_ENDED) */
+    reason: "FINISHED" | "REMOVED" | "ERROR" | "MAIN_ENDED" | string;
+}
+type NodeLinkEventPayload<T extends NodeLinkEventTypes> = T extends "PlayerCreatedEvent" ? PlayerCreatedEvent : T extends "PlayerDestroyedEvent" ? PlayerDestroyedEvent : T extends "PlayerConnectedEvent" ? PlayerConnectedEvent : T extends "PlayerReconnectingEvent" ? PlayerReconnectingEvent : T extends "VolumeChangedEvent" ? VolumeChangedEvent : T extends "FiltersChangedEvent" ? FiltersChangedEvent : T extends "SeekEvent" ? SeekEvent : T extends "PauseEvent" ? PauseEvent : T extends "ConnectionStatusEvent" ? ConnectionStatusEvent : T extends "MixStartedEvent" ? MixStartedEvent : T extends "MixEndedEvent" ? MixEndedEvent : never;
+
 /** Ability to manipulate fetch requests */
 type ModifyRequest = (options: RequestInit & {
     path: string;
@@ -2050,12 +2110,41 @@ interface BaseNodeStats {
     /** The frame stats for the node. */
     frameStats: FrameStats;
 }
+interface NodeLinkConnectionMetrics {
+    status: string;
+    metrics: {
+        speed: {
+            bps: number;
+            kbps: number;
+            mbps: number;
+        };
+        downloadedBytes: number;
+        durationSeconds: number;
+        timestamp: number;
+    };
+}
 /**
  * Interface for nodeStats from lavalink
  */
 interface NodeStats extends BaseNodeStats {
     /** The frame stats for the node. */
     frameStats: FrameStats;
+    /** something from nodeLink https://nodelink.js.org/docs/differences#detailed-statistics */
+    detailedStats?: {
+        api: {
+            /** e.g. { "/v4/loadtracks": 150, "/v4/info": 5 }  */
+            requests: Record<string, number>;
+            errors: unknown;
+        };
+        /** e.g. { "youtube": 150, "soundcloud": 5 } */
+        sources: Record<string, number>;
+        playback: {
+            /** e.g. { "TrackStartEvent": 150, "TrackEndEvent": 5 } */
+            events: Record<string, number>;
+        };
+        /** and potential others */
+        [key: string]: unknown;
+    };
 }
 /**
  * Entire lavalink information object from lavalink
@@ -2077,6 +2166,8 @@ interface LavalinkInfo {
     filters: string[];
     /** The enabled plugins for this server */
     plugins: PluginObject[];
+    /** Something from NodeLink: https://nodelink.js.org/docs/differences#server-info */
+    isNodelink?: boolean;
 }
 /**
  * Lavalink's version object from lavalink
@@ -2193,6 +2284,25 @@ interface NodeManagerEvents {
         sessionId: string;
         op: "ready";
     }, players: LavalinkPlayer[] | InvalidLavalinkRestRequest) => void;
+    /**
+     * Event Handler for Nodelink specific events https://nodelink.js.org/docs/api/websocket Fully typed and generic based on the eventName.
+     * @event Manager.nodeManager#nodeLinkEvent
+     * @example
+     *
+     * ```ts
+     * this.nodeManager.on("nodeLinkEvent", (node, event, player, track, payload) => {
+     *   if (event === "SeekEvent") {
+     *       console.log("new position:", payload.position);
+     *   }
+     *   if (event === "FiltersChangedEvent") {
+     *       console.log("new filters state", payload.filters);
+     *   }
+     * });
+     * ```
+     */
+    "nodeLinkEvent": (...args: {
+        [K in NodeLinkEventTypes]: [node: LavalinkNode, event: K, player: Player, track: Track | null, payload: NodeLinkEventPayload<K>];
+    }[NodeLinkEventTypes]) => void;
 }
 declare enum ReconnectionState {
     IDLE = "IDLE",
@@ -2565,6 +2675,16 @@ declare class LavalinkNode {
      * ```
      */
     fetchStats(): Promise<BaseNodeStats>;
+    /**
+     * Request NodeLink connection metrics. https://nodelink.js.org/docs/differences#connection-metrics
+     * @returns the connection metrics of the node
+     *
+     * @example
+     * ```ts
+     * const connectionMetrics = await player.node.fetchConnectionMetrics();
+     * ```
+     */
+    fetchConnectionMetrics(): Promise<NodeLinkConnectionMetrics>;
     /**
      * Request Lavalink version.
      * @returns the current used lavalink version
@@ -2680,6 +2800,14 @@ declare class LavalinkNode {
     private message;
     /** @private middleware util function for handling all kind of events from websocket */
     private handleEvent;
+    /**
+     * nodeLink specific events handling https://nodelink.js.org/docs/api/websocket#incoming-events-server--client
+     * @param eventName
+     * @param player
+     * @param track
+     * @param payload
+     */
+    private nodeLinkEventHandler;
     private getTrackOfPayload;
     /** @private util function for handling trackStart event */
     private trackStart;
@@ -3387,4 +3515,4 @@ declare const LavalinkPlugins: {
 /** Lavalink Sources regexes for url validations */
 declare const SourceLinksRegexes: Record<SourcesRegex, RegExp>;
 
-export { type AudioOutputs, type Awaitable, type Base64, type BaseNodeStats, type BasePlayOptions, type BotClientOptions, type CPUStats, type ChannelDeletePacket, type ChannelMixFilter, type ClientCustomSearchPlatformUtils, type ClientSearchPlatform, DebugEvents, type DeepRequired, DefaultQueueStore, DefaultSources, DestroyReasons, type DestroyReasonsType, DisconnectReasons, type DisconnectReasonsType, type DistortionFilter, type DuncteSearchPlatform, type EQBand, EQList, type Exception, type FailingAddress, type FilterData, FilterManager, type FloatNumber, type FrameStats, type GitObject, type GuildShardPayload, type IntegerNumber, type InvalidLavalinkRestRequest, type JioSaavnSearchPlatform, type KaraokeFilter, type LavaSearchFilteredResponse, type LavaSearchQuery, type LavaSearchResponse, type LavaSearchType, type LavaSrcSearchPlatform, type LavaSrcSearchPlatformBase, type LavalinkClientSearchPlatform, type LavalinkClientSearchPlatformResolve, type LavalinkFilterData, type LavalinkInfo, LavalinkManager, type LavalinkManagerEvents, LavalinkNode, type LavalinkNodeIdentifier, type LavalinkNodeOptions, type LavalinkPlayOptions, type LavalinkPlayer, type LavalinkPlayerVoice, type LavalinkPlayerVoiceOptions, type LavalinkPlugin_JioSaavn_SourceNames, type LavalinkPlugin_LavaSrc_SourceNames, LavalinkPlugins, type LavalinkSearchPlatform, type LavalinkSourceNames, type LavalinkTrack, type LavalinkTrackInfo, type LoadTypes, type LowPassFilter, type LyricsEvent, type LyricsEventType, type LyricsFoundEvent, type LyricsLine, type LyricsLineEvent, type LyricsNotFoundEvent, type LyricsResult, type ManagerOptions, type ManagerPlayerOptions, type ManagerQueueOptions, ManagerUtils, type MemoryStats, MiniMap, type MiniMapConstructor, type ModifyRequest, NodeManager, type NodeManagerEvents, type NodeMessage, type NodeStats, NodeSymbol, type Opaque, type PlayOptions, Player, type PlayerEvent, type PlayerEventType, type PlayerEvents, type PlayerFilters, type PlayerJson, type PlayerOptions, type PlayerUpdateInfo, type PlaylistInfo, type PluginInfo, type PluginObject, Queue, type QueueChangesWatcher, QueueSaver, type QueueStoreManager, QueueSymbol, ReconnectionState, type RepeatMode, type RequiredManagerOptions, type RotationFilter, type RoutePlanner, type RoutePlannerTypes, type SearchPlatform, type SearchQuery, type SearchResult, type Session, type Severity, SourceLinksRegexes, type SourceNames, type SourcesRegex, type SponsorBlockChapterStarted, type SponsorBlockChaptersLoaded, type SponsorBlockSegment, type SponsorBlockSegmentEventType, type SponsorBlockSegmentEvents, type SponsorBlockSegmentSkipped, type SponsorBlockSegmentsLoaded, type State, type StoredQueue, type TimescaleFilter, type Track, type TrackEndEvent, type TrackEndReason, type TrackExceptionEvent, type TrackInfo, type TrackStartEvent, type TrackStuckEvent, TrackSymbol, type TremoloFilter, type UnresolvedQuery, type UnresolvedSearchResult, type UnresolvedTrack, type UnresolvedTrackInfo, UnresolvedTrackSymbol, type VersionObject, type VibratoFilter, type VoicePacket, type VoiceServer, type VoiceState, type WebSocketClosedEvent, type anyObject, audioOutputsData, parseLavalinkConnUrl, queueTrackEnd, safeStringify, validSponsorBlocks };
+export { type AudioOutputs, type Awaitable, type Base64, type BaseNodeStats, type BasePlayOptions, type BotClientOptions, type CPUStats, type ChannelDeletePacket, type ChannelMixFilter, type ClientCustomSearchPlatformUtils, type ClientSearchPlatform, DebugEvents, type DeepRequired, DefaultQueueStore, DefaultSources, DestroyReasons, type DestroyReasonsType, DisconnectReasons, type DisconnectReasonsType, type DistortionFilter, type DuncteSearchPlatform, type EQBand, EQList, type Exception, type FailingAddress, type FilterData, FilterManager, type FloatNumber, type FrameStats, type GitObject, type GuildShardPayload, type IntegerNumber, type InvalidLavalinkRestRequest, type JioSaavnSearchPlatform, type KaraokeFilter, type LavaSearchFilteredResponse, type LavaSearchQuery, type LavaSearchResponse, type LavaSearchType, type LavaSrcSearchPlatform, type LavaSrcSearchPlatformBase, type LavalinkClientSearchPlatform, type LavalinkClientSearchPlatformResolve, type LavalinkFilterData, type LavalinkInfo, LavalinkManager, type LavalinkManagerEvents, LavalinkNode, type LavalinkNodeIdentifier, type LavalinkNodeOptions, type LavalinkPlayOptions, type LavalinkPlayer, type LavalinkPlayerVoice, type LavalinkPlayerVoiceOptions, type LavalinkPlugin_JioSaavn_SourceNames, type LavalinkPlugin_LavaSrc_SourceNames, LavalinkPlugins, type LavalinkSearchPlatform, type LavalinkSourceNames, type LavalinkTrack, type LavalinkTrackInfo, type LoadTypes, type LowPassFilter, type LyricsEvent, type LyricsEventType, type LyricsFoundEvent, type LyricsLine, type LyricsLineEvent, type LyricsNotFoundEvent, type LyricsResult, type ManagerOptions, type ManagerPlayerOptions, type ManagerQueueOptions, ManagerUtils, type MemoryStats, MiniMap, type MiniMapConstructor, type ModifyRequest, type NodeLinkConnectionMetrics, NodeManager, type NodeManagerEvents, type NodeMessage, type NodeStats, NodeSymbol, type Opaque, type PlayOptions, Player, type PlayerEvent, type PlayerEventType, type PlayerEvents, type PlayerFilters, type PlayerJson, type PlayerOptions, type PlayerUpdateInfo, type PlaylistInfo, type PluginInfo, type PluginObject, Queue, type QueueChangesWatcher, QueueSaver, type QueueStoreManager, QueueSymbol, ReconnectionState, type RepeatMode, type RequiredManagerOptions, type RotationFilter, type RoutePlanner, type RoutePlannerTypes, type SearchPlatform, type SearchQuery, type SearchResult, type Session, type Severity, SourceLinksRegexes, type SourceNames, type SourcesRegex, type SponsorBlockChapterStarted, type SponsorBlockChaptersLoaded, type SponsorBlockSegment, type SponsorBlockSegmentEventType, type SponsorBlockSegmentEvents, type SponsorBlockSegmentSkipped, type SponsorBlockSegmentsLoaded, type State, type StoredQueue, type TimescaleFilter, type Track, type TrackEndEvent, type TrackEndReason, type TrackExceptionEvent, type TrackInfo, type TrackStartEvent, type TrackStuckEvent, TrackSymbol, type TremoloFilter, type UnresolvedQuery, type UnresolvedSearchResult, type UnresolvedTrack, type UnresolvedTrackInfo, UnresolvedTrackSymbol, type VersionObject, type VibratoFilter, type VoicePacket, type VoiceServer, type VoiceState, type WebSocketClosedEvent, type anyObject, audioOutputsData, parseLavalinkConnUrl, queueTrackEnd, safeStringify, validSponsorBlocks };

package/dist/index.js

@@ -1070,6 +1070,17 @@ var LavalinkNode = class {
       used: 0
     },
     uptime: 0,
+    /** something from nodeLink https://nodelink.js.org/docs/differences#detailed-statistics */
+    detailedStats: {
+      api: {
+        requests: {},
+        errors: {}
+      },
+      sources: {},
+      playback: {
+        events: {}
+      }
+    },
     frameStats: {
       deficit: 0,
       nulled: 0,
@@ -1752,6 +1763,19 @@ var LavalinkNode = class {
   async fetchStats() {
     return await this.request(`/stats`);
   }
+  /**
+   * Request NodeLink connection metrics. https://nodelink.js.org/docs/differences#connection-metrics
+   * @returns the connection metrics of the node
+   *
+   * @example
+   * ```ts
+   * const connectionMetrics = await player.node.fetchConnectionMetrics();
+   * ```
+   */
+  async fetchConnectionMetrics() {
+    if (this.info && !this.info.isNodelink) throw new Error("There is no Information about wether you are using NodeLink instead of Lavalink, so this function won't work");
+    return await this.request(`/connection`);
+  }
   /**
    * Request Lavalink version.
    * @returns the current used lavalink version
@@ -2006,6 +2030,7 @@ var LavalinkNode = class {
       const errorString = `Lavalink Node (${this.restAddress}) does not provide any /${this.version}/info`;
       throw new Error(errorString);
     }
+    this.info.isNodelink = !!this.info.isNodelink;
     this.NodeManager.emit("connect", this);
   }
   /** @private util function for handling closing events from websocket */
@@ -2132,6 +2157,23 @@ var LavalinkNode = class {
     if (!payload?.guildId) return;
     const player = this._LManager.getPlayer(payload.guildId);
     if (!player) return;
+    const NodeLinkEventType = payload.type;
+    const NodeLinkExclusiveEvents = [
+      "PlayerCreatedEvent",
+      "PlayerDestroyedEvent",
+      "PlayerConnectedEvent",
+      "PlayerReconnectingEvent",
+      "VolumeChangedEvent",
+      "FiltersChangedEvent",
+      "SeekEvent",
+      "PauseEvent",
+      "ConnectionStatusEvent",
+      "MixStartedEvent",
+      "MixEndedEvent"
+    ];
+    if (NodeLinkExclusiveEvents.includes(NodeLinkEventType) && (!this.info || this.info.isNodelink)) {
+      return this.nodeLinkEventHandler(NodeLinkEventType, player, player.queue.current, payload);
+    }
     switch (payload.type) {
       case "TrackStartEvent":
         this.trackStart(player, player.queue.current, payload);
@@ -2175,6 +2217,16 @@ var LavalinkNode = class {
     }
     return;
   }
+  /**
+   * nodeLink specific events handling https://nodelink.js.org/docs/api/websocket#incoming-events-server--client
+   * @param eventName
+   * @param player
+   * @param track
+   * @param payload
+   */
+  async nodeLinkEventHandler(eventName, player, track, payload) {
+    this.NodeManager.emit("nodeLinkEvent", this, eventName, player, track, payload);
+  }
   getTrackOfPayload(payload) {
     return "track" in payload ? this._LManager.utils.buildTrack(payload.track, void 0) : null;
   }

package/dist/index.mjs

@@ -1009,6 +1009,17 @@ var LavalinkNode = class {
       used: 0
     },
     uptime: 0,
+    /** something from nodeLink https://nodelink.js.org/docs/differences#detailed-statistics */
+    detailedStats: {
+      api: {
+        requests: {},
+        errors: {}
+      },
+      sources: {},
+      playback: {
+        events: {}
+      }
+    },
     frameStats: {
       deficit: 0,
       nulled: 0,
@@ -1691,6 +1702,19 @@ var LavalinkNode = class {
   async fetchStats() {
     return await this.request(`/stats`);
   }
+  /**
+   * Request NodeLink connection metrics. https://nodelink.js.org/docs/differences#connection-metrics
+   * @returns the connection metrics of the node
+   *
+   * @example
+   * ```ts
+   * const connectionMetrics = await player.node.fetchConnectionMetrics();
+   * ```
+   */
+  async fetchConnectionMetrics() {
+    if (this.info && !this.info.isNodelink) throw new Error("There is no Information about wether you are using NodeLink instead of Lavalink, so this function won't work");
+    return await this.request(`/connection`);
+  }
   /**
    * Request Lavalink version.
    * @returns the current used lavalink version
@@ -1945,6 +1969,7 @@ var LavalinkNode = class {
       const errorString = `Lavalink Node (${this.restAddress}) does not provide any /${this.version}/info`;
       throw new Error(errorString);
     }
+    this.info.isNodelink = !!this.info.isNodelink;
     this.NodeManager.emit("connect", this);
   }
   /** @private util function for handling closing events from websocket */
@@ -2071,6 +2096,23 @@ var LavalinkNode = class {
     if (!payload?.guildId) return;
     const player = this._LManager.getPlayer(payload.guildId);
     if (!player) return;
+    const NodeLinkEventType = payload.type;
+    const NodeLinkExclusiveEvents = [
+      "PlayerCreatedEvent",
+      "PlayerDestroyedEvent",
+      "PlayerConnectedEvent",
+      "PlayerReconnectingEvent",
+      "VolumeChangedEvent",
+      "FiltersChangedEvent",
+      "SeekEvent",
+      "PauseEvent",
+      "ConnectionStatusEvent",
+      "MixStartedEvent",
+      "MixEndedEvent"
+    ];
+    if (NodeLinkExclusiveEvents.includes(NodeLinkEventType) && (!this.info || this.info.isNodelink)) {
+      return this.nodeLinkEventHandler(NodeLinkEventType, player, player.queue.current, payload);
+    }
     switch (payload.type) {
       case "TrackStartEvent":
         this.trackStart(player, player.queue.current, payload);
@@ -2114,6 +2156,16 @@ var LavalinkNode = class {
     }
     return;
   }
+  /**
+   * nodeLink specific events handling https://nodelink.js.org/docs/api/websocket#incoming-events-server--client
+   * @param eventName
+   * @param player
+   * @param track
+   * @param payload
+   */
+  async nodeLinkEventHandler(eventName, player, track, payload) {
+    this.NodeManager.emit("nodeLinkEvent", this, eventName, player, track, payload);
+  }
   getTrackOfPayload(payload) {
     return "track" in payload ? this._LManager.utils.buildTrack(payload.track, void 0) : null;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "lavalink-client",
-    "version": "2.7.5",
+    "version": "2.7.7",
     "description": "Easy, flexible and feature-rich lavalink@v4 Client. Both for Beginners and Proficients.",
     "main": "./dist/index.js",
     "module": "./dist/index.mjs",