linkdave 0.1.6-dev.d8a9fae → 0.2.0-dev.67c58c7

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;

package/dist/client.js

@@ -4,6 +4,7 @@ import { Node } from "./node.js";
 import { Player } from "./player.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 {
     #clientId;
     #sendToShard;
@@ -69,13 +70,25 @@ export class LinkDaveClient extends EventEmitter {
         }
         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);
@@ -132,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));
@@ -151,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) {
@@ -168,6 +180,13 @@ 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)

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,4 +1,5 @@
 export * from "./client.js";
+export * from "./filters.js";
 export * from "./node.js";
 export * from "./player.js";
 export * from "./queue.js";

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from "./client.js";
+export * from "./filters.js";
 export * from "./node.js";
 export * from "./player.js";
 export * from "./queue.js";

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, 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;
@@ -44,6 +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>;
 }

package/dist/node.js

@@ -9,8 +9,8 @@ export var NodeState;
     NodeState[NodeState["Connected"] = 2] = "Connected";
     NodeState[NodeState["Draining"] = 3] = "Draining";
 })(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;
@@ -19,7 +19,6 @@ export class Node extends EventEmitter {
     #sessionId = null;
     #reconnectAttempts = 0;
     #reconnectTimeout = null;
-    #pingInterval = null;
     #state = NodeState.Disconnected;
     #playerCount = 0;
     constructor(options) {
@@ -52,7 +51,6 @@ export class Node extends EventEmitter {
             const onOpen = () => {
                 this.#state = NodeState.Connected;
                 this.#reconnectAttempts = 0;
-                this.#startPingInterval();
                 resolve(null);
             };
             const onError = (event) => {
@@ -69,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");
@@ -106,6 +103,7 @@ export class Node extends EventEmitter {
             this.#handleMessage(message);
         }
         catch {
+            // Invalid messages are silently ignored
         }
     }
     #handleMessage(message) {
@@ -132,9 +130,6 @@ 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;
@@ -151,7 +146,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();
@@ -174,15 +168,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);
     }
@@ -204,9 +189,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));
     }

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,12 +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;
 }

package/dist/player.js

@@ -1,4 +1,5 @@
 import { GatewayOpcodes } from "discord-api-types/v10";
+import { PlayerFilters } from "./filters.js";
 import { Queue } from "./queue.js";
 import { DisconnectReason, EventName, PlayerState, TrackEndReason } from "./types.js";
 import { unwrap } from "./utils.js";
@@ -7,18 +8,19 @@ export class Player {
     #client;
     #guildId;
     #queue;
+    #filters = new PlayerFilters();
     #node;
     #voiceChannelId = null;
     #selfMute;
     #selfDeaf;
     #state = PlayerState.Idle;
-    #position = 0;
-    #volume = 100;
     #current = null;
     #voiceState = null;
     #pendingVoice = null;
     #migrationTarget = null;
     #migrationResolve = null;
+    #inactivityTimeout;
+    #inactivityTimer = null;
     constructor(client, guildId, node, options) {
         this.#client = client;
         this.#guildId = guildId;
@@ -27,6 +29,7 @@ export class Player {
         this.#voiceChannelId = options?.voiceChannelId ?? null;
         this.#selfMute = options?.selfMute ?? false;
         this.#selfDeaf = options?.selfDeaf ?? true;
+        this.#inactivityTimeout = options?.inactivityTimeout ?? 0;
     }
     get guildId() {
         return this.#guildId;
@@ -37,12 +40,6 @@ export class Player {
     get state() {
         return this.#state;
     }
-    get position() {
-        return this.#position;
-    }
-    get volume() {
-        return this.#volume;
-    }
     get current() {
         return this.#current;
     }
@@ -61,6 +58,9 @@ export class Player {
     get connected() {
         return this.#voiceState !== null;
     }
+    get filters() {
+        return this.#filters;
+    }
     connect(channelId, timeoutMs = Player.CONNECT_TIMEOUT) {
         const targetChannel = channelId ?? this.#voiceChannelId;
         if (!targetChannel) {
@@ -151,7 +151,7 @@ export class Player {
         this.#pendingVoice ??= {};
         const endpoint = data.endpoint || this.#pendingVoice.serverEvent?.endpoint;
         if (!endpoint)
-            throw new Error("Missing voice server endpoint");
+            throw new Error("Missing voice server endpoint"); // TODO
         this.#pendingVoice.serverEvent = {
             token: data.token,
             guild_id: data.guild_id,
@@ -184,10 +184,12 @@ export class Player {
         await this.#sendPlay(url, options);
     }
     async #sendPlay(url, options = {}) {
+        const filters = options.filters ?? this.#filters.toPayload();
         await this.#node.sendPlay(this.#guildId, {
             url,
             ...(options.startTime !== undefined && { start_time: options.startTime }),
-            ...(options.volume !== undefined && { volume: options.volume })
+            ...(options.requesterId !== undefined && { requester_id: options.requesterId }),
+            ...(filters !== undefined && { filters })
         });
     }
     async pause() {
@@ -199,17 +201,12 @@ export class Player {
     async stop() {
         this.#queue._deactivate();
         await this.#node.sendStop(this.#guildId);
-        this.#current = null;
         this.#state = PlayerState.Idle;
-        this.#position = 0;
+        this.#current = null;
     }
     async seek(position) {
         await this.#node.sendSeek(this.#guildId, { position });
     }
-    async setVolume(volume) {
-        this.#volume = Math.max(0, Math.min(1_000, volume));
-        await this.#node.sendVolume(this.#guildId, { volume: this.#volume });
-    }
     async destroy() {
         this.disconnect();
         if (!this.#node.connected) {
@@ -252,20 +249,31 @@ export class Player {
             this.#migrationResolve = resolve;
         });
     }
-    _updateState(data) {
+    _onPlayerUpdate(data) {
+        if (data.state === PlayerState.Playing)
+            this.#stopTimer();
+        else if (this.#state === PlayerState.Playing)
+            this.#startTimer();
         this.#state = data.state;
-        this.#position = data.position;
-        this.#volume = data.volume;
     }
     _onTrackStart(data) {
         this.#current = data.track;
+        this.#state = PlayerState.Playing;
+        this.#stopTimer();
     }
     _onTrackEnd(data) {
         if (!this.#queue.active || this.#queue.size === 0) {
-            this.#current = null;
             this.#state = PlayerState.Idle;
+            this.#current = null;
+            this.#startTimer();
         }
-        this.#queue._onTrackEnd(data.reason !== TrackEndReason.Stopped);
+        this.#queue._onTrackEnd(data.reason !== TrackEndReason.Stopped && data.reason !== TrackEndReason.Replaced);
+    }
+    _onVoiceConnect() {
+        if (this.#state !== PlayerState.Connecting)
+            return;
+        this.#state = PlayerState.Idle;
+        this.#startTimer();
     }
     #cleanup() {
         this.#voiceChannelId = null;
@@ -274,7 +282,7 @@ export class Player {
         this.#pendingVoice = null;
         this.#state = PlayerState.Idle;
         this.#current = null;
-        this.#position = 0;
+        this.#stopTimer();
     }
     _onVoiceDisconnect() {
         this.#cleanup();
@@ -285,6 +293,7 @@ export class Player {
         }
         const targetNode = this.#migrationTarget;
         const oldNode = this.#node;
+        // Don't send disconnect to old node - we're migrating
         this.#client._updatePlayerNode(this.#guildId, oldNode, targetNode);
         this.#node = targetNode;
         if (this.#voiceState) {
@@ -297,16 +306,16 @@ export class Player {
             });
         }
         if (data.state === PlayerState.Playing && data.url) {
-            const playData = {
-                url: data.url,
-                start_time: data.position,
-                volume: data.volume
-            };
             const onVoiceConnect = (event) => {
                 if (event.guild_id !== this.#guildId)
                     return;
                 this.#node.off(EventName.VoiceConnect, onVoiceConnect);
-                void this.#node.sendPlay(this.#guildId, playData);
+                void this.#node.sendPlay(this.#guildId, {
+                    url: data.url,
+                    start_time: data.position,
+                    ...(data.requester_id !== undefined && { requester_id: data.requester_id }),
+                    ...(data.filters !== undefined && { filters: data.filters })
+                });
             };
             this.#node.on(EventName.VoiceConnect, onVoiceConnect);
         }
@@ -316,4 +325,28 @@ export class Player {
         this.#migrationResolve(null);
         this.#migrationResolve = null;
     }
+    #startTimer() {
+        if (this.#inactivityTimeout <= 0)
+            return;
+        this.#stopTimer();
+        this.#inactivityTimer = setTimeout(() => {
+            if (this.#state === PlayerState.Playing)
+                return;
+            this.disconnect();
+            if (this.#node.connected) {
+                void this.#node.sendDisconnect(this.#guildId);
+            }
+            this.#client._onPlayerDestroy(this.#guildId);
+            this.#client.emit(EventName.VoiceDisconnect, {
+                guild_id: this.#guildId,
+                reason: DisconnectReason.Inactivity
+            });
+        }, this.#inactivityTimeout);
+    }
+    #stopTimer() {
+        if (this.#inactivityTimer === null)
+            return;
+        clearTimeout(this.#inactivityTimer);
+        this.#inactivityTimer = null;
+    }
 }

package/dist/queue.d.ts

@@ -1,13 +1,17 @@
-import type { Player } from "./player.js";
+import type { Player, PlayOptions } from "./player.js";
+export interface QueueItem {
+    uri: string;
+    options: PlayOptions;
+}
 export declare class Queue {
     #private;
     constructor(player: Player);
-    add(uri: string): this;
+    add(uri: string, options?: PlayOptions): this;
     start(): Promise<void>;
     skip(): Promise<void>;
-    remove(index: number): string | undefined;
+    remove(index: number): QueueItem | undefined;
     clear(): void;
-    get tracks(): readonly string[];
+    get tracks(): readonly QueueItem[];
     get size(): number;
     get active(): boolean;
     _onTrackEnd(finished: boolean): void;

package/dist/queue.js

@@ -6,8 +6,8 @@ export class Queue {
     constructor(player) {
         this.#player = player;
     }
-    add(uri) {
-        this.#tracks.push(uri);
+    add(uri, options = {}) {
+        this.#tracks.push({ uri, options });
         return this;
     }
     async start() {
@@ -56,10 +56,10 @@ export class Queue {
         if (!item)
             return;
         this.#player
-            .play(item, undefined, true)
+            .play(item.uri, item.options, true)
             .then(() => null, (error_) => {
             const error = error_ instanceof Error ? error_ : new Error(String(error_));
-            const payload = { guild_id: this.#player.guildId, url: item, error };
+            const payload = { guild_id: this.#player.guildId, url: item.uri, error };
             this.#player.node.emit(EventName.QueueError, payload);
             this._onTrackEnd(true);
         });
@@ -71,6 +71,6 @@ export class Queue {
         const item = this.#tracks.shift();
         if (!item)
             return;
-        await this.#player.play(item, undefined, true);
+        await this.#player.play(item.uri, item.options, true);
     }
 }

package/dist/types.d.ts

@@ -1,21 +1,19 @@
 import type { Node } from "./node.js";
 export declare enum ClientOpCodes {
-    Ping = 0,
-    VoiceUpdate = 1,
-    PlayerMigrate = 2
+    VoiceUpdate = 0,
+    PlayerMigrate = 1
 }
 export declare enum ServerOpCodes {
-    Pong = 0,
-    Ready = 1,
-    VoiceConnect = 2,
-    VoiceDisconnect = 3,
-    PlayerUpdate = 4,
-    TrackStart = 5,
-    TrackEnd = 6,
-    TrackError = 7,
-    Stats = 8,
-    NodeDraining = 9,
-    MigrateReady = 10
+    Ready = 0,
+    VoiceConnect = 1,
+    VoiceDisconnect = 2,
+    PlayerUpdate = 3,
+    TrackStart = 4,
+    TrackEnd = 5,
+    TrackError = 6,
+    Stats = 7,
+    NodeDraining = 8,
+    MigrateReady = 9
 }
 export declare enum TrackEndReason {
     Finished = "finished",
@@ -29,6 +27,25 @@ export declare enum PlayerState {
     Paused = "paused",
     Connecting = "connecting"
 }
+export declare enum Filter {
+    /** Slows and lowers pitch (speed ×0.8, pitch ×0.8). */
+    Vaporwave = 0,
+    /** Speeds up and raises pitch (speed ×1.3, pitch ×1.3). */
+    Nightcore = 1,
+    /** Rotates audio around the stereo field at 0.2 Hz. */
+    Rotation = 2,
+    /** Oscillates volume at 4 Hz with 0.6 depth. */
+    Tremolo = 3,
+    /** Oscillates pitch at 4 Hz with 0.5 depth. */
+    Vibrato = 4,
+    /** Suppresses high frequencies (smoothing factor 20). */
+    LowPass = 5
+}
+export interface FiltersPayload {
+    enabled?: Filter[];
+    pitch?: number;
+    speed?: number;
+}
 export type ServerMessage = {
     op: ServerOpCodes.Ready;
     d: ReadyPayload;
@@ -50,9 +67,6 @@ export type ServerMessage = {
 } | {
     op: ServerOpCodes.VoiceDisconnect;
     d: VoiceDisconnectPayload;
-} | {
-    op: ServerOpCodes.Pong;
-    d?: undefined;
 } | {
     op: ServerOpCodes.Stats;
     d: StatsPayload;
@@ -66,9 +80,6 @@ export type ServerMessage = {
 export type ClientMessage = {
     op: ClientOpCodes.VoiceUpdate;
     d: VoiceUpdatePayload;
-} | {
-    op: ClientOpCodes.Ping;
-    d?: undefined;
 } | {
     op: ClientOpCodes.PlayerMigrate;
     d: PlayerMigratePayload;
@@ -88,7 +99,8 @@ export interface VoiceUpdatePayload {
 export interface PlayPayload {
     url: string;
     start_time?: number;
-    volume?: number;
+    requester_id?: string;
+    filters?: FiltersPayload;
 }
 export interface GuildPayload {
     guild_id: string;
@@ -96,9 +108,6 @@ export interface GuildPayload {
 export interface SeekPayload {
     position: number;
 }
-export interface VolumePayload {
-    volume: number;
-}
 export interface ReadyPayload {
     session_id: string;
     resumed: boolean;
@@ -106,13 +115,12 @@ export interface ReadyPayload {
 export interface PlayerUpdatePayload {
     guild_id: string;
     state: PlayerState;
-    position: number;
-    volume: number;
 }
 export interface TrackInfo {
     url: string;
     title?: string;
     duration: number;
+    requester_id?: string;
 }
 export interface TrackStartPayload {
     guild_id: string;
@@ -136,7 +144,8 @@ export interface QueueErrorPayload {
 export declare enum DisconnectReason {
     ConnectionLost = "connection_lost",
     ConnectionFailed = "connection_failed",
-    Requested = "requested"
+    Requested = "requested",
+    Inactivity = "inactivity"
 }
 export interface VoiceConnectPayload {
     guild_id: string;
@@ -164,8 +173,9 @@ export interface MigrateReadyPayload {
     guild_id: string;
     url: string;
     position: number;
-    volume: number;
     state: PlayerState;
+    requester_id?: string;
+    filters?: FiltersPayload;
 }
 export interface ClosePayload {
     code: number;
@@ -180,7 +190,6 @@ export declare enum EventName {
     QueueError = "queueError",
     VoiceConnect = "voiceConnect",
     VoiceDisconnect = "voiceDisconnect",
-    Pong = "pong",
     Stats = "stats",
     NodeDraining = "nodeDraining",
     MigrateReady = "migrateReady",
@@ -196,7 +205,6 @@ export interface Events {
     [EventName.QueueError]: QueueErrorPayload;
     [EventName.VoiceConnect]: VoiceConnectPayload;
     [EventName.VoiceDisconnect]: VoiceDisconnectPayload;
-    [EventName.Pong]: undefined;
     [EventName.Stats]: StatsPayload;
     [EventName.NodeDraining]: NodeDrainingPayload;
     [EventName.MigrateReady]: MigrateReadyPayload;
@@ -230,6 +238,5 @@ export declare const Routes: {
     readonly resume: (sessionId: string, guildId: string) => `/sessions/${string}/players/${string}/resume`;
     readonly stop: (sessionId: string, guildId: string) => `/sessions/${string}/players/${string}/stop`;
     readonly seek: (sessionId: string, guildId: string) => `/sessions/${string}/players/${string}/seek`;
-    readonly volume: (sessionId: string, guildId: string) => `/sessions/${string}/players/${string}/volume`;
     readonly disconnect: (sessionId: string, guildId: string) => `/sessions/${string}/players/${string}`;
 };

package/dist/types.js

@@ -1,22 +1,20 @@
 export var ClientOpCodes;
 (function (ClientOpCodes) {
-    ClientOpCodes[ClientOpCodes["Ping"] = 0] = "Ping";
-    ClientOpCodes[ClientOpCodes["VoiceUpdate"] = 1] = "VoiceUpdate";
-    ClientOpCodes[ClientOpCodes["PlayerMigrate"] = 2] = "PlayerMigrate";
+    ClientOpCodes[ClientOpCodes["VoiceUpdate"] = 0] = "VoiceUpdate";
+    ClientOpCodes[ClientOpCodes["PlayerMigrate"] = 1] = "PlayerMigrate";
 })(ClientOpCodes || (ClientOpCodes = {}));
 export var ServerOpCodes;
 (function (ServerOpCodes) {
-    ServerOpCodes[ServerOpCodes["Pong"] = 0] = "Pong";
-    ServerOpCodes[ServerOpCodes["Ready"] = 1] = "Ready";
-    ServerOpCodes[ServerOpCodes["VoiceConnect"] = 2] = "VoiceConnect";
-    ServerOpCodes[ServerOpCodes["VoiceDisconnect"] = 3] = "VoiceDisconnect";
-    ServerOpCodes[ServerOpCodes["PlayerUpdate"] = 4] = "PlayerUpdate";
-    ServerOpCodes[ServerOpCodes["TrackStart"] = 5] = "TrackStart";
-    ServerOpCodes[ServerOpCodes["TrackEnd"] = 6] = "TrackEnd";
-    ServerOpCodes[ServerOpCodes["TrackError"] = 7] = "TrackError";
-    ServerOpCodes[ServerOpCodes["Stats"] = 8] = "Stats";
-    ServerOpCodes[ServerOpCodes["NodeDraining"] = 9] = "NodeDraining";
-    ServerOpCodes[ServerOpCodes["MigrateReady"] = 10] = "MigrateReady";
+    ServerOpCodes[ServerOpCodes["Ready"] = 0] = "Ready";
+    ServerOpCodes[ServerOpCodes["VoiceConnect"] = 1] = "VoiceConnect";
+    ServerOpCodes[ServerOpCodes["VoiceDisconnect"] = 2] = "VoiceDisconnect";
+    ServerOpCodes[ServerOpCodes["PlayerUpdate"] = 3] = "PlayerUpdate";
+    ServerOpCodes[ServerOpCodes["TrackStart"] = 4] = "TrackStart";
+    ServerOpCodes[ServerOpCodes["TrackEnd"] = 5] = "TrackEnd";
+    ServerOpCodes[ServerOpCodes["TrackError"] = 6] = "TrackError";
+    ServerOpCodes[ServerOpCodes["Stats"] = 7] = "Stats";
+    ServerOpCodes[ServerOpCodes["NodeDraining"] = 8] = "NodeDraining";
+    ServerOpCodes[ServerOpCodes["MigrateReady"] = 9] = "MigrateReady";
 })(ServerOpCodes || (ServerOpCodes = {}));
 export var TrackEndReason;
 (function (TrackEndReason) {
@@ -32,11 +30,27 @@ export var PlayerState;
     PlayerState["Paused"] = "paused";
     PlayerState["Connecting"] = "connecting";
 })(PlayerState || (PlayerState = {}));
+export var Filter;
+(function (Filter) {
+    /** Slows and lowers pitch (speed ×0.8, pitch ×0.8). */
+    Filter[Filter["Vaporwave"] = 0] = "Vaporwave";
+    /** Speeds up and raises pitch (speed ×1.3, pitch ×1.3). */
+    Filter[Filter["Nightcore"] = 1] = "Nightcore";
+    /** Rotates audio around the stereo field at 0.2 Hz. */
+    Filter[Filter["Rotation"] = 2] = "Rotation";
+    /** Oscillates volume at 4 Hz with 0.6 depth. */
+    Filter[Filter["Tremolo"] = 3] = "Tremolo";
+    /** Oscillates pitch at 4 Hz with 0.5 depth. */
+    Filter[Filter["Vibrato"] = 4] = "Vibrato";
+    /** Suppresses high frequencies (smoothing factor 20). */
+    Filter[Filter["LowPass"] = 5] = "LowPass";
+})(Filter || (Filter = {}));
 export var DisconnectReason;
 (function (DisconnectReason) {
     DisconnectReason["ConnectionLost"] = "connection_lost";
     DisconnectReason["ConnectionFailed"] = "connection_failed";
     DisconnectReason["Requested"] = "requested";
+    DisconnectReason["Inactivity"] = "inactivity";
 })(DisconnectReason || (DisconnectReason = {}));
 export var EventName;
 (function (EventName) {
@@ -48,7 +62,6 @@ export var EventName;
     EventName["QueueError"] = "queueError";
     EventName["VoiceConnect"] = "voiceConnect";
     EventName["VoiceDisconnect"] = "voiceDisconnect";
-    EventName["Pong"] = "pong";
     EventName["Stats"] = "stats";
     EventName["NodeDraining"] = "nodeDraining";
     EventName["MigrateReady"] = "migrateReady";
@@ -67,6 +80,5 @@ export const Routes = {
     resume: (sessionId, guildId) => `/sessions/${sessionId}/players/${guildId}/resume`,
     stop: (sessionId, guildId) => `/sessions/${sessionId}/players/${guildId}/stop`,
     seek: (sessionId, guildId) => `/sessions/${sessionId}/players/${guildId}/seek`,
-    volume: (sessionId, guildId) => `/sessions/${sessionId}/players/${guildId}/volume`,
     disconnect: (sessionId, guildId) => `/sessions/${sessionId}/players/${guildId}`
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "linkdave",
-    "version": "0.1.6-dev.d8a9fae",
+    "version": "0.2.0-dev.67c58c7",
     "author": "Luna Seemann <luna@wamellow.com> (http://shi.gg)",
     "description": "TypeScript client library for linkdave Discord audio streaming server",
     "repository": {
@@ -31,9 +31,9 @@
     "packageManager": "bun@1.3.10",
     "devDependencies": {
         "@mwlica/eslint": "^1.2.0",
-        "@types/node": "^25.6.0",
+        "@types/node": "^25.9.1",
         "typescript": "^6.0.3",
-        "typescript-eslint": "^8.59.0"
+        "typescript-eslint": "^8.60.0"
     },
     "keywords": [
         "discord",
@@ -44,6 +44,6 @@
     ],
     "license": "AGPL-3.0-only",
     "dependencies": {
-        "discord-api-types": "^0.38.47"
+        "discord-api-types": "^0.38.48"
     }
 }