lavalink-client 2.7.6 → 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;
@@ -2224,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",
@@ -2721,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;

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;
@@ -2224,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",
@@ -2721,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;

package/dist/index.js

@@ -2157,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);
@@ -2200,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

@@ -2096,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);
@@ -2139,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.6",
+    "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",