linkdave 0.1.6 → 0.2.0-dev.db8ab4a

package/dist/client.d.ts

@@ -24,7 +24,10 @@ export declare class LinkDaveClient extends EventEmitter {
     connectAll(): Promise<void>;
     disconnectAll(): void;
     getBestNode(): Node | undefined;
-    getPlayer(guildId: string, options?: Omit<PlayerOptions, "guildId">): Player;
+    private getPreferredNode;
+    getPlayer(guildId: string, options?: Omit<PlayerOptions, "guildId"> & {
+        nodeId?: string;
+    }): Player;
     removePlayer(guildId: string): boolean;
     get players(): ReadonlyMap<string, Player>;
     get clientId(): string;
@@ -33,4 +36,3 @@ export declare class LinkDaveClient extends EventEmitter {
     _onPlayerDestroy(guildId: string): void;
     _updatePlayerNode(guildId: string, oldNode: Node, newNode: Node): void;
 }
-//# sourceMappingURL=client.d.ts.map

package/dist/client.js

@@ -2,7 +2,7 @@ import { GatewayDispatchEvents } from "discord-api-types/v10";
 import { EventEmitter } from "node:events";
 import { Node } from "./node.js";
 import { Player } from "./player.js";
-import { EventName, ManagerEventName } from "./types.js";
+import { DisconnectReason, EventName, ManagerEventName } from "./types.js";
 const CLIENT_ID_REGEX = /^\d{15,21}$/;
 // eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
 export class LinkDaveClient extends EventEmitter {
@@ -63,20 +63,32 @@ export class LinkDaveClient extends EventEmitter {
             if (!node.connected || node.draining) {
                 continue;
             }
-            if (node.playerCount < lowestCount) {
-                lowestCount = node.playerCount;
+            if (node.stats.players < lowestCount) {
+                lowestCount = node.stats.players;
                 bestNode = node;
             }
         }
         return bestNode;
     }
+    getPreferredNode(nodeId) {
+        if (!nodeId) {
+            return this.getBestNode();
+        }
+        const node = this.#nodes.get(nodeId);
+        if (!node || !node.connected || node.draining) {
+            return undefined;
+        }
+        return node;
+    }
     getPlayer(guildId, options) {
         let player = this.#players.get(guildId);
         if (player)
             return player;
-        const node = this.getBestNode();
+        const node = this.getPreferredNode(options?.nodeId);
         if (!node) {
-            throw new Error("No available nodes to create player");
+            throw new Error(options?.nodeId
+                ? `Node "${options.nodeId}" is not available to create player`
+                : "No available nodes to create player");
         }
         player = new Player(this, guildId, node, options);
         this.#players.set(guildId, player);
@@ -104,7 +116,6 @@ export class LinkDaveClient extends EventEmitter {
     handleRaw({ t: event, d: data }) {
         switch (event) {
             case GatewayDispatchEvents.VoiceStateUpdate: {
-                // https://discord.com/developers/docs/resources/voice#voice-state-object
                 if (!data.guild_id)
                     return;
                 if (data.user_id !== this.#clientId)
@@ -134,9 +145,8 @@ export class LinkDaveClient extends EventEmitter {
         node.on(EventName.TrackEnd, (data) => this.#handleTrackEnd(node, data));
         node.on(EventName.TrackError, (data) => this.#forwardPlayerEvent(node, data.guild_id, EventName.TrackError, data));
         node.on(EventName.QueueError, (data) => this.#forwardPlayerEvent(node, data.guild_id, EventName.QueueError, data));
-        node.on(EventName.VoiceConnect, (data) => this.#forwardPlayerEvent(node, data.guild_id, EventName.VoiceConnect, data));
+        node.on(EventName.VoiceConnect, (data) => this.#handleVoiceConnect(node, data));
         node.on(EventName.VoiceDisconnect, (data) => this.#handleVoiceDisconnect(node, data));
-        node.on(EventName.Pong, () => this.emit(EventName.Pong, undefined));
         node.on(EventName.Stats, (data) => this.emit(EventName.Stats, data));
         node.on(EventName.NodeDraining, (data) => this.#handleNodeDraining(node, data));
         node.on(EventName.MigrateReady, (data) => this.#handleMigrateReady(node, data));
@@ -153,7 +163,7 @@ export class LinkDaveClient extends EventEmitter {
         const player = this.#players.get(data.guild_id);
         if (player?.node !== node)
             return;
-        player._updateState(data);
+        player._onPlayerUpdate(data);
         this.emit(EventName.PlayerUpdate, data);
     }
     #handleTrackStart(node, data) {
@@ -170,14 +180,37 @@ export class LinkDaveClient extends EventEmitter {
         player._onTrackEnd(data);
         this.emit(EventName.TrackEnd, data);
     }
+    #handleVoiceConnect(node, data) {
+        const player = this.#players.get(data.guild_id);
+        if (player?.node !== node)
+            return;
+        player._onVoiceConnect();
+        this.emit(EventName.VoiceConnect, data);
+    }
     #handleVoiceDisconnect(node, data) {
         const player = this.#players.get(data.guild_id);
         if (player?.node !== node)
             return;
+        if (data.reason === DisconnectReason.ConnectionLost) {
+            this.#handleConnectionLost(player);
+            return;
+        }
         player._onVoiceDisconnect();
-        this.emit(EventName.VoiceDisconnect, data);
         player.node.decrementPlayerCount();
         this.#players.delete(data.guild_id);
+        this.emit(EventName.VoiceDisconnect, data);
+    }
+    #handleConnectionLost(player) {
+        if (player.voiceChannelId)
+            player.disconnect();
+        else
+            player._onVoiceDisconnect();
+        player.node.decrementPlayerCount();
+        this.#players.delete(player.guildId);
+        this.emit(EventName.VoiceDisconnect, {
+            guild_id: player.guildId,
+            reason: DisconnectReason.ConnectionLost
+        });
     }
     _onPlayerDestroy(guildId) {
         const player = this.#players.get(guildId);
@@ -226,4 +259,3 @@ export class LinkDaveClient extends EventEmitter {
         newNode.incrementPlayerCount();
     }
 }
-//# sourceMappingURL=client.js.map

package/dist/filters.d.ts

@@ -0,0 +1,61 @@
+import type { Filter, FiltersPayload } from "./types.js";
+export declare class PlayerFilters {
+    #private;
+    /**
+     * Pitch multiplier applied on top of any preset pitch.
+     *
+     * - **Default:** `0` (no override — preset value is used as-is)
+     * - **Normal playback:** `1.0`
+     * - **Recommended range:** `0.5` – `2.0`
+     * - Values below `0` are clamped to `0`. Values above `2.0` will work
+     *   but progressively degrade audio quality due to resampling artifacts.
+     *
+     * When a preset like {@link Filter.Nightcore} is active (which sets pitch
+     * to `1.3×`), this value is **multiplied** on top: e.g. `pitch = 0.5`
+     * with Nightcore → effective pitch = `1.3 × 0.5 = 0.65`.
+     */
+    get pitch(): number;
+    set pitch(value: number);
+    /**
+     * Speed multiplier applied on top of any preset speed.
+     *
+     * - **Default:** `0` (no override — preset value is used as-is)
+     * - **Normal playback:** `1.0`
+     * - **Recommended range:** `0.25` – `3.0`
+     * - Values below `0` are clamped to `0`. Extreme values (e.g. `>5.0`)
+     *   will work but may cause audible quality loss since more source
+     *   samples are consumed per output frame.
+     *
+     * When a preset like {@link Filter.Vaporwave} is active (which sets speed
+     * to `0.8×`), this value is **multiplied** on top: e.g. `speed = 1.25`
+     * with Vaporwave → effective speed = `0.8 × 1.25 = 1.0`.
+     */
+    get speed(): number;
+    set speed(value: number);
+    /**
+     * Toggle a filter on or off. If `enabled` is omitted the filter is
+     * flipped from its current state.
+     *
+     * **Preset filters** ({@link Filter.Nightcore}, {@link Filter.Vaporwave})
+     * adjust both speed and pitch by fixed amounts (1.3× and 0.8×
+     * respectively). Enabling both simultaneously multiplies their effects
+     * together (effective speed = `1.3 × 0.8 = 1.04`).
+     *
+     * **DSP filters** ({@link Filter.Tremolo}, {@link Filter.Vibrato},
+     * {@link Filter.Rotation}, {@link Filter.LowPass}) modify the audio
+     * signal in-place and can all be enabled simultaneously — they are
+     * applied in sequence (tremolo → vibrato → rotation → lowpass).
+     */
+    toggle(filter: Filter, enabled?: boolean): this;
+    /**
+     * @returns `true` if any filter is active or if pitch or speed are non-zero.
+     */
+    get active(): boolean;
+    /**
+     * @returns an array of all active filters.
+     */
+    get activeFilters(): Filter[];
+    get(filter: Filter): boolean | undefined;
+    clear(): void;
+    toPayload(): FiltersPayload | undefined;
+}

package/dist/filters.js

@@ -0,0 +1,108 @@
+export class PlayerFilters {
+    #state = new Map();
+    #pitch = 0;
+    #speed = 0;
+    /**
+     * Pitch multiplier applied on top of any preset pitch.
+     *
+     * - **Default:** `0` (no override — preset value is used as-is)
+     * - **Normal playback:** `1.0`
+     * - **Recommended range:** `0.5` – `2.0`
+     * - Values below `0` are clamped to `0`. Values above `2.0` will work
+     *   but progressively degrade audio quality due to resampling artifacts.
+     *
+     * When a preset like {@link Filter.Nightcore} is active (which sets pitch
+     * to `1.3×`), this value is **multiplied** on top: e.g. `pitch = 0.5`
+     * with Nightcore → effective pitch = `1.3 × 0.5 = 0.65`.
+     */
+    get pitch() {
+        return this.#pitch;
+    }
+    set pitch(value) {
+        this.#pitch = Math.max(0, value);
+    }
+    /**
+     * Speed multiplier applied on top of any preset speed.
+     *
+     * - **Default:** `0` (no override — preset value is used as-is)
+     * - **Normal playback:** `1.0`
+     * - **Recommended range:** `0.25` – `3.0`
+     * - Values below `0` are clamped to `0`. Extreme values (e.g. `>5.0`)
+     *   will work but may cause audible quality loss since more source
+     *   samples are consumed per output frame.
+     *
+     * When a preset like {@link Filter.Vaporwave} is active (which sets speed
+     * to `0.8×`), this value is **multiplied** on top: e.g. `speed = 1.25`
+     * with Vaporwave → effective speed = `0.8 × 1.25 = 1.0`.
+     */
+    get speed() {
+        return this.#speed;
+    }
+    set speed(value) {
+        this.#speed = Math.max(0, value);
+    }
+    /**
+     * Toggle a filter on or off. If `enabled` is omitted the filter is
+     * flipped from its current state.
+     *
+     * **Preset filters** ({@link Filter.Nightcore}, {@link Filter.Vaporwave})
+     * adjust both speed and pitch by fixed amounts (1.3× and 0.8×
+     * respectively). Enabling both simultaneously multiplies their effects
+     * together (effective speed = `1.3 × 0.8 = 1.04`).
+     *
+     * **DSP filters** ({@link Filter.Tremolo}, {@link Filter.Vibrato},
+     * {@link Filter.Rotation}, {@link Filter.LowPass}) modify the audio
+     * signal in-place and can all be enabled simultaneously — they are
+     * applied in sequence (tremolo → vibrato → rotation → lowpass).
+     */
+    toggle(filter, enabled) {
+        const next = enabled ?? !this.#state.get(filter);
+        this.#state.set(filter, next);
+        return this;
+    }
+    /**
+     * @returns `true` if any filter is active or if pitch or speed are non-zero.
+     */
+    get active() {
+        for (const v of this.#state.values()) {
+            if (v)
+                return true;
+        }
+        return this.#pitch > 0 || this.#speed > 0;
+    }
+    /**
+     * @returns an array of all active filters.
+     */
+    get activeFilters() {
+        const result = [];
+        for (const [k, v] of this.#state)
+            if (v)
+                result.push(k);
+        return result;
+    }
+    get(filter) {
+        return this.#state.get(filter);
+    }
+    clear() {
+        this.#state.clear();
+        this.#pitch = 0;
+        this.#speed = 0;
+    }
+    toPayload() {
+        if (!this.active)
+            return undefined;
+        const enabled = [];
+        for (const [k, v] of this.#state) {
+            if (v)
+                enabled.push(k);
+        }
+        const payload = {};
+        if (enabled.length > 0)
+            payload.enabled = enabled;
+        if (this.#pitch > 0)
+            payload.pitch = this.#pitch;
+        if (this.#speed > 0)
+            payload.speed = this.#speed;
+        return payload;
+    }
+}

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 export * from "./client.js";
+export * from "./filters.js";
 export * from "./node.js";
 export * from "./player.js";
 export * from "./queue.js";
 export * from "./rest.js";
 export * from "./types.js";
 export * from "./utils.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,8 +1,8 @@
 export * from "./client.js";
+export * from "./filters.js";
 export * from "./node.js";
 export * from "./player.js";
 export * from "./queue.js";
 export * from "./rest.js";
 export * from "./types.js";
 export * from "./utils.js";
-//# sourceMappingURL=index.js.map

package/dist/node.d.ts

@@ -1,6 +1,6 @@
 import { EventEmitter } from "node:events";
 import { RESTClient } from "./rest.js";
-import type { Events, PlayPayload, SeekPayload, VoiceUpdatePayload, VolumePayload } from "./types.js";
+import type { Events, PlayPayload, SeekPayload, StatsPayload, VoiceUpdatePayload } from "./types.js";
 export interface NodeOptions {
     name: string;
     url: string;
@@ -23,7 +23,6 @@ export interface Node {
 }
 export declare class Node extends EventEmitter {
     #private;
-    private static readonly NODE_PING_INTERVAL;
     readonly name: string;
     readonly url: string;
     readonly rest: RESTClient;
@@ -32,7 +31,7 @@ export declare class Node extends EventEmitter {
     disconnect(): void;
     get state(): NodeState;
     get sessionId(): string | null;
-    get playerCount(): number;
+    get stats(): StatsPayload;
     get draining(): boolean;
     get connected(): boolean;
     incrementPlayerCount(): void;
@@ -44,7 +43,5 @@ export declare class Node extends EventEmitter {
     sendResume(guildId: string): Promise<void>;
     sendStop(guildId: string): Promise<void>;
     sendSeek(guildId: string, data: SeekPayload): Promise<void>;
-    sendVolume(guildId: string, data: VolumePayload): Promise<void>;
     sendDisconnect(guildId: string): Promise<void>;
 }
-//# sourceMappingURL=node.d.ts.map

package/dist/node.js

@@ -11,7 +11,6 @@ export var NodeState;
 })(NodeState || (NodeState = {}));
 // eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
 export class Node extends EventEmitter {
-    static NODE_PING_INTERVAL = 30_000;
     name;
     url;
     rest;
@@ -20,9 +19,8 @@ export class Node extends EventEmitter {
     #sessionId = null;
     #reconnectAttempts = 0;
     #reconnectTimeout = null;
-    #pingInterval = null;
     #state = NodeState.Disconnected;
-    #playerCount = 0;
+    #stats = { players: 0, playing_tracks: 0, uptime: 0, memory: 0 };
     constructor(options) {
         super();
         this.name = options.name;
@@ -53,7 +51,6 @@ export class Node extends EventEmitter {
             const onOpen = () => {
                 this.#state = NodeState.Connected;
                 this.#reconnectAttempts = 0;
-                this.#startPingInterval();
                 resolve(null);
             };
             const onError = (event) => {
@@ -70,7 +67,6 @@ export class Node extends EventEmitter {
     }
     disconnect() {
         this.#state = NodeState.Disconnected;
-        this.#stopPingInterval();
         this.#stopReconnect();
         if (this.#ws) {
             this.#ws.close(1_000, "Client disconnect");
@@ -84,8 +80,8 @@ export class Node extends EventEmitter {
     get sessionId() {
         return this.#sessionId;
     }
-    get playerCount() {
-        return this.#playerCount;
+    get stats() {
+        return this.#stats;
     }
     get draining() {
         return this.state === NodeState.Draining;
@@ -94,12 +90,12 @@ export class Node extends EventEmitter {
         return this.#state === NodeState.Connected || this.#state === NodeState.Draining;
     }
     incrementPlayerCount() {
-        this.#playerCount++;
+        this.#stats.players++;
     }
     decrementPlayerCount() {
-        if (this.#playerCount > 0) {
-            this.#playerCount--;
-        }
+        if (this.#stats.players <= 0)
+            return;
+        this.#stats.players--;
     }
     #onMessage(event) {
         try {
@@ -134,12 +130,8 @@ export class Node extends EventEmitter {
             case ServerOpCodes.VoiceDisconnect:
                 this.emit(EventName.VoiceDisconnect, message.d);
                 break;
-            case ServerOpCodes.Pong:
-                this.emit(EventName.Pong, undefined);
-                break;
             case ServerOpCodes.Stats:
-                this.#playerCount = message.d.players;
-                this.#state = message.d.draining ? NodeState.Draining : NodeState.Connected;
+                this.#stats = message.d;
                 this.emit(EventName.Stats, message.d);
                 break;
             case ServerOpCodes.NodeDraining:
@@ -153,7 +145,6 @@ export class Node extends EventEmitter {
     }
     #onClose(event) {
         this.#state = NodeState.Disconnected;
-        this.#stopPingInterval();
         this.emit(EventName.Close, { code: event.code, reason: event.reason });
         if (event.code !== 1_000 && this.#options.autoReconnect && !this.draining && this.#reconnectAttempts < this.#options.maxReconnectAttempts) {
             this.#scheduleReconnect();
@@ -176,15 +167,6 @@ export class Node extends EventEmitter {
         }
         this.#reconnectAttempts = 0;
     }
-    #startPingInterval() {
-        this.#pingInterval = setInterval(() => this.#send(ClientOpCodes.Ping, undefined), Node.NODE_PING_INTERVAL);
-    }
-    #stopPingInterval() {
-        if (!this.#pingInterval)
-            return;
-        clearInterval(this.#pingInterval);
-        this.#pingInterval = null;
-    }
     sendVoiceUpdate(data) {
         this.#send(ClientOpCodes.VoiceUpdate, data);
     }
@@ -206,9 +188,6 @@ export class Node extends EventEmitter {
     async sendSeek(guildId, data) {
         await this.rest.post(Routes.seek(this.#requireSession(), guildId), data);
     }
-    async sendVolume(guildId, data) {
-        await this.rest.patch(Routes.volume(this.#requireSession(), guildId), data);
-    }
     async sendDisconnect(guildId) {
         await this.rest.delete(Routes.disconnect(this.#requireSession(), guildId));
     }
@@ -226,4 +205,3 @@ export class Node extends EventEmitter {
         this.#ws.send(JSON.stringify(message));
     }
 }
-//# sourceMappingURL=node.js.map

package/dist/player.d.ts

@@ -1,17 +1,20 @@
 import { type GatewayVoiceServerUpdateDispatchData, type GatewayVoiceStateUpdateDispatchData } from "discord-api-types/v10";
 import type { LinkDaveClient } from "./client.js";
+import { PlayerFilters } from "./filters.js";
 import type { Node } from "./node.js";
 import { Queue } from "./queue.js";
-import type { MigrateReadyPayload, PlayerUpdatePayload, TrackEndPayload, TrackInfo, TrackStartPayload, VoiceConnectPayload } from "./types.js";
+import type { FiltersPayload, MigrateReadyPayload, PlayerUpdatePayload, TrackEndPayload, TrackInfo, TrackStartPayload, VoiceConnectPayload } from "./types.js";
 import { PlayerState } from "./types.js";
 export interface PlayOptions {
     startTime?: number;
-    volume?: number;
+    requesterId?: string;
+    filters?: FiltersPayload;
 }
 export interface PlayerOptions {
     voiceChannelId?: string;
     selfMute?: boolean;
     selfDeaf?: boolean;
+    inactivityTimeout?: number;
 }
 export type RawVoiceStateUpdate = Pick<GatewayVoiceStateUpdateDispatchData, "user_id" | "channel_id" | "session_id">;
 export type RawVoiceServerUpdate = Pick<GatewayVoiceServerUpdateDispatchData, "token" | "guild_id" | "endpoint">;
@@ -22,14 +25,13 @@ export declare class Player {
     get guildId(): string;
     get voiceChannelId(): string | null;
     get state(): PlayerState;
-    get position(): number;
-    get volume(): number;
     get current(): TrackInfo | null;
     get node(): Node;
     get queue(): Queue;
     get playing(): boolean;
     get paused(): boolean;
     get connected(): boolean;
+    get filters(): PlayerFilters;
     connect(channelId?: string, timeoutMs?: number): Promise<VoiceConnectPayload>;
     disconnect(): void;
     handleVoiceStateUpdate(data: RawVoiceStateUpdate): Promise<void>;
@@ -39,13 +41,12 @@ export declare class Player {
     resume(): Promise<void>;
     stop(): Promise<void>;
     seek(position: number): Promise<void>;
-    setVolume(volume: number): Promise<void>;
     destroy(): Promise<void>;
     moveNode(targetNode: Node): Promise<unknown>;
-    _updateState(data: PlayerUpdatePayload): void;
+    _onPlayerUpdate(data: PlayerUpdatePayload): void;
     _onTrackStart(data: TrackStartPayload): void;
     _onTrackEnd(data: TrackEndPayload): void;
+    _onVoiceConnect(): void;
     _onVoiceDisconnect(): void;
     _onMigrateReady(data: MigrateReadyPayload): void;
 }
-//# sourceMappingURL=player.d.ts.map