linkdave 0.1.6-dev.87f1a64 → 0.1.6-dev.974add6

package/dist/client.js

@@ -2,8 +2,9 @@ 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 {
     #clientId;
     #sendToShard;
@@ -172,10 +173,26 @@ export class LinkDaveClient extends EventEmitter {
         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);

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.js

@@ -9,6 +9,7 @@ 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;
@@ -106,6 +107,7 @@ export class Node extends EventEmitter {
             this.#handleMessage(message);
         }
         catch {
+            // Invalid messages are silently ignored
         }
     }
     #handleMessage(message) {

package/dist/player.d.ts

@@ -1,12 +1,15 @@
 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;
@@ -30,6 +33,7 @@ export declare class Player {
     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>;

package/dist/player.js

@@ -1,12 +1,14 @@
 import { GatewayOpcodes } from "discord-api-types/v10";
+import { PlayerFilters } from "./filters.js";
 import { Queue } from "./queue.js";
-import { EventName, PlayerState, TrackEndReason } from "./types.js";
+import { DisconnectReason, EventName, PlayerState, TrackEndReason } from "./types.js";
 import { unwrap } from "./utils.js";
 export class Player {
     static CONNECT_TIMEOUT = 10_000;
     #client;
     #guildId;
     #queue;
+    #filters = new PlayerFilters();
     #node;
     #voiceChannelId = null;
     #selfMute;
@@ -61,12 +63,16 @@ 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) {
             throw new RangeError("No voice channel ID provided");
         }
         this.#voiceChannelId = targetChannel;
+        this.#state = PlayerState.Connecting;
         this.#client._sendToShard(this.#guildId, {
             op: GatewayOpcodes.VoiceStateUpdate,
             d: {
@@ -78,6 +84,9 @@ export class Player {
         });
         return new Promise((resolve, reject) => {
             const cleanup = () => {
+                if (this.#state === PlayerState.Connecting) {
+                    this.#state = PlayerState.Idle;
+                }
                 this.#node.off(EventName.VoiceConnect, onConnect);
                 this.#node.off(EventName.VoiceDisconnect, onDisconnect);
                 clearTimeout(timer);
@@ -96,6 +105,8 @@ export class Player {
             const onDisconnect = (event) => {
                 if (event.guild_id !== this.#guildId)
                     return;
+                if (event.reason === DisconnectReason.Requested)
+                    return;
                 cleanup();
                 reject(new Error(`Voice connection failed for guild "${this.#guildId}": ${event.reason ?? "unknown"}`));
             };
@@ -117,8 +128,9 @@ export class Player {
     }
     async handleVoiceStateUpdate(data) {
         if (!data.channel_id) {
+            const hadVoiceState = this.#voiceState !== null;
             this.#cleanup();
-            if (this.#node.connected) {
+            if (hadVoiceState && this.#node.connected) {
                 const [, err] = await unwrap(this.#node.sendDisconnect(this.#guildId));
                 if (err)
                     this.#node.emit(EventName.Error, err);
@@ -144,7 +156,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,
@@ -177,10 +189,13 @@ 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.volume !== undefined && { volume: options.volume }),
+            ...(options.requesterId !== undefined && { requester_id: options.requesterId }),
+            ...(filters !== undefined && { filters })
         });
     }
     async pause() {
@@ -211,9 +226,8 @@ export class Player {
         }
         const waitForVoiceDisconnect = this.#waitForNodeVoiceDisconnect(Player.CONNECT_TIMEOUT);
         await unwrap(this.#node.sendDisconnect(this.#guildId));
-        if (!(await waitForVoiceDisconnect)) {
-            this.#client._onPlayerDestroy(this.#guildId);
-        }
+        await waitForVoiceDisconnect;
+        this.#client._onPlayerDestroy(this.#guildId);
     }
     #waitForNodeVoiceDisconnect(timeoutMs) {
         return new Promise((resolve) => {
@@ -259,7 +273,7 @@ export class Player {
             this.#current = null;
             this.#state = PlayerState.Idle;
         }
-        this.#queue._onTrackEnd(data.reason !== TrackEndReason.Stopped);
+        this.#queue._onTrackEnd(data.reason !== TrackEndReason.Stopped && data.reason !== TrackEndReason.Replaced);
     }
     #cleanup() {
         this.#voiceChannelId = null;
@@ -279,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) {
@@ -291,16 +306,17 @@ 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,
+                    volume: data.volume,
+                    ...(data.requester_id !== undefined && { requester_id: data.requester_id }),
+                    ...(data.filters !== undefined && { filters: data.filters })
+                });
             };
             this.#node.on(EventName.VoiceConnect, onVoiceConnect);
         }

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

@@ -26,7 +26,27 @@ export declare enum TrackEndReason {
 export declare enum PlayerState {
     Idle = "idle",
     Playing = "playing",
-    Paused = "paused"
+    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;
@@ -88,6 +108,8 @@ export interface PlayPayload {
     url: string;
     start_time?: number;
     volume?: number;
+    requester_id?: string;
+    filters?: FiltersPayload;
 }
 export interface GuildPayload {
     guild_id: string;
@@ -112,6 +134,7 @@ export interface TrackInfo {
     url: string;
     title?: string;
     duration: number;
+    requester_id?: string;
 }
 export interface TrackStartPayload {
     guild_id: string;
@@ -132,13 +155,18 @@ export interface QueueErrorPayload {
     url: string;
     error: Error;
 }
+export declare enum DisconnectReason {
+    ConnectionLost = "connection_lost",
+    ConnectionFailed = "connection_failed",
+    Requested = "requested"
+}
 export interface VoiceConnectPayload {
     guild_id: string;
     channel_id: string;
 }
 export interface VoiceDisconnectPayload {
     guild_id: string;
-    reason?: string;
+    reason?: DisconnectReason;
 }
 export interface StatsPayload {
     players: number;
@@ -160,6 +188,8 @@ export interface MigrateReadyPayload {
     position: number;
     volume: number;
     state: PlayerState;
+    requester_id?: string;
+    filters?: FiltersPayload;
 }
 export interface ClosePayload {
     code: number;

package/dist/types.js

@@ -30,7 +30,29 @@ export var PlayerState;
     PlayerState["Idle"] = "idle";
     PlayerState["Playing"] = "playing";
     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 || (DisconnectReason = {}));
 export var EventName;
 (function (EventName) {
     EventName["Ready"] = "ready";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "linkdave",
-    "version": "0.1.6-dev.87f1a64",
+    "version": "0.1.6-dev.974add6",
     "author": "Luna Seemann <luna@wamellow.com> (http://shi.gg)",
     "description": "TypeScript client library for linkdave Discord audio streaming server",
     "repository": {