yukimu 1.2.0 → 2.0.0

package/dist/BitrateOptimizer.d.ts

@@ -0,0 +1,52 @@
+/** Yukimu v2.0.0 — Bitrate Optimizer for Discord Boost Tiers */
+import type { BoostTier, BitrateConfig, FilterOptions, EqualizerBand } from "./types";
+/**
+ * Provides optimal audio quality settings based on the Discord server's boost tier.
+ *
+ * Discord bitrate caps by tier:
+ * - Tier 0 (no boost): 96 kbps max
+ * - Tier 1:            128 kbps max
+ * - Tier 2:            256 kbps max
+ * - Tier 3:            384 kbps max
+ *
+ * Note: The actual voice channel bitrate is set via Discord's API (by the bot or server admin).
+ * Yukimu optimizes the Lavalink-side audio processing (filters, EQ) to complement the
+ * available bitrate — preventing quality degradation, clipping, and distortion.
+ */
+export declare class BitrateOptimizer {
+    /**
+     * Get the bitrate configuration for a given boost tier.
+     */
+    static getConfig(tier: BoostTier): BitrateConfig;
+    /**
+     * Get the maximum bitrate (in kbps) for a given boost tier.
+     */
+    static getMaxBitrate(tier: BoostTier): number;
+    /**
+     * Get recommended filter settings optimized for the given boost tier.
+     *
+     * - Tier 0–1: Minimal processing to avoid quality loss on low bitrate
+     * - Tier 2–3: Enhanced EQ for richer sound, taking advantage of higher bitrate
+     */
+    static getOptimalFilters(tier: BoostTier): FilterOptions;
+    /**
+     * Get optimal volume for a given boost tier.
+     * Lower tiers should stay at 100 to avoid clipping on lower bitrate.
+     */
+    static getOptimalVolume(tier: BoostTier): number;
+    /**
+     * Flat EQ — no modification, prevents quality loss on low bitrate.
+     */
+    static getFlatEQ(): EqualizerBand[];
+    /**
+     * Clarity EQ — subtle boost to presence and air frequencies
+     * for enhanced vocal clarity and sparkle on high-bitrate connections.
+     */
+    static getClarityEQ(): EqualizerBand[];
+    /**
+     * Bass-heavy EQ — tuned for each tier to prevent distortion.
+     * Lower tiers get less bass boost to prevent clipping.
+     */
+    static getBassEQ(tier: BoostTier): EqualizerBand[];
+}
+//# sourceMappingURL=BitrateOptimizer.d.ts.map

package/dist/BitrateOptimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BitrateOptimizer.d.ts","sourceRoot":"","sources":["../src/BitrateOptimizer.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAGhE,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEtF;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;WACW,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,aAAa;IAIvD;;OAEG;WACW,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM;IAIpD;;;;;OAKG;WACW,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,aAAa;IAiB/D;;;OAGG;WACW,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM;IAIvD;;OAEG;WACW,SAAS,IAAI,aAAa,EAAE;IAI1C;;;OAGG;WACW,YAAY,IAAI,aAAa,EAAE;IAoB7C;;;OAGG;WACW,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,aAAa,EAAE;CAsB1D"}

package/dist/BitrateOptimizer.js

@@ -0,0 +1,115 @@
+"use strict";
+/** Yukimu v2.0.0 — Bitrate Optimizer for Discord Boost Tiers */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BitrateOptimizer = void 0;
+const Constants_1 = require("./Constants");
+/**
+ * Provides optimal audio quality settings based on the Discord server's boost tier.
+ *
+ * Discord bitrate caps by tier:
+ * - Tier 0 (no boost): 96 kbps max
+ * - Tier 1:            128 kbps max
+ * - Tier 2:            256 kbps max
+ * - Tier 3:            384 kbps max
+ *
+ * Note: The actual voice channel bitrate is set via Discord's API (by the bot or server admin).
+ * Yukimu optimizes the Lavalink-side audio processing (filters, EQ) to complement the
+ * available bitrate — preventing quality degradation, clipping, and distortion.
+ */
+class BitrateOptimizer {
+    /**
+     * Get the bitrate configuration for a given boost tier.
+     */
+    static getConfig(tier) {
+        return Constants_1.BITRATE_BY_BOOST_TIER[tier];
+    }
+    /**
+     * Get the maximum bitrate (in kbps) for a given boost tier.
+     */
+    static getMaxBitrate(tier) {
+        return Constants_1.BITRATE_BY_BOOST_TIER[tier].maxBitrate;
+    }
+    /**
+     * Get recommended filter settings optimized for the given boost tier.
+     *
+     * - Tier 0–1: Minimal processing to avoid quality loss on low bitrate
+     * - Tier 2–3: Enhanced EQ for richer sound, taking advantage of higher bitrate
+     */
+    static getOptimalFilters(tier) {
+        const config = Constants_1.BITRATE_BY_BOOST_TIER[tier];
+        if (!config.enhancedEQ) {
+            // Low bitrate tiers: flat EQ, no processing overhead
+            return {
+                equalizer: BitrateOptimizer.getFlatEQ(),
+            };
+        }
+        // High bitrate tiers: subtle enhancement for clarity
+        return {
+            equalizer: BitrateOptimizer.getClarityEQ(),
+            lowPass: { smoothing: 3.0 }, // Very gentle low-pass for smoothness
+        };
+    }
+    /**
+     * Get optimal volume for a given boost tier.
+     * Lower tiers should stay at 100 to avoid clipping on lower bitrate.
+     */
+    static getOptimalVolume(tier) {
+        return Constants_1.BITRATE_BY_BOOST_TIER[tier].recommendedVolume;
+    }
+    /**
+     * Flat EQ — no modification, prevents quality loss on low bitrate.
+     */
+    static getFlatEQ() {
+        return Array.from({ length: 15 }, (_, i) => ({ band: i, gain: 0 }));
+    }
+    /**
+     * Clarity EQ — subtle boost to presence and air frequencies
+     * for enhanced vocal clarity and sparkle on high-bitrate connections.
+     */
+    static getClarityEQ() {
+        return [
+            { band: 0, gain: 0.10 }, // Sub bass: gentle warmth
+            { band: 1, gain: 0.08 }, // Bass: subtle body
+            { band: 2, gain: 0.05 }, // Low mid
+            { band: 3, gain: 0.02 }, // Mid bass
+            { band: 4, gain: 0.0 }, // Low mid: flat
+            { band: 5, gain: 0.0 }, // Mid: flat
+            { band: 6, gain: 0.0 }, // Upper mid: flat
+            { band: 7, gain: 0.03 }, // Presence: slight lift
+            { band: 8, gain: 0.06 }, // Upper presence: clarity
+            { band: 9, gain: 0.08 }, // Treble: sparkle
+            { band: 10, gain: 0.06 }, // Upper treble: air
+            { band: 11, gain: 0.04 }, // Air
+            { band: 12, gain: 0.02 }, // Brilliance
+            { band: 13, gain: 0.0 }, // Ultra high
+            { band: 14, gain: 0.0 }, // Ultra high
+        ];
+    }
+    /**
+     * Bass-heavy EQ — tuned for each tier to prevent distortion.
+     * Lower tiers get less bass boost to prevent clipping.
+     */
+    static getBassEQ(tier) {
+        // Scale bass boost based on available bitrate headroom
+        const scale = tier >= 2 ? 1.0 : tier === 1 ? 0.7 : 0.4;
+        return [
+            { band: 0, gain: 0.6 * scale },
+            { band: 1, gain: 0.5 * scale },
+            { band: 2, gain: 0.4 * scale },
+            { band: 3, gain: 0.25 * scale },
+            { band: 4, gain: 0.1 * scale },
+            { band: 5, gain: -0.05 * scale },
+            { band: 6, gain: 0.0 },
+            { band: 7, gain: 0.0 },
+            { band: 8, gain: 0.0 },
+            { band: 9, gain: 0.0 },
+            { band: 10, gain: 0.0 },
+            { band: 11, gain: 0.0 },
+            { band: 12, gain: 0.0 },
+            { band: 13, gain: 0.0 },
+            { band: 14, gain: 0.0 },
+        ];
+    }
+}
+exports.BitrateOptimizer = BitrateOptimizer;
+//# sourceMappingURL=BitrateOptimizer.js.map

package/dist/BitrateOptimizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BitrateOptimizer.js","sourceRoot":"","sources":["../src/BitrateOptimizer.ts"],"names":[],"mappings":"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"}

package/dist/ConnectionPool.d.ts

@@ -1,32 +1,82 @@
+/** Yukimu v2.0.0 — Voice Connection Pool with State Machine */
 import type { Yukimu } from "./Yukimu";
+export declare enum VoiceConnectionState {
+    IDLE = 0,
+    CONNECTING = 1,
+    READY = 2,
+    DISCONNECTING = 3
+}
 export interface VoiceConnection {
     guildId: string;
     channelId: string;
     sessionId: string | null;
     token: string | null;
     endpoint: string | null;
+    state: VoiceConnectionState;
     timeout: ReturnType<typeof setTimeout> | null;
     retryTimeout: ReturnType<typeof setTimeout> | null;
-    connected: boolean;
     retries: number;
+    createdAt: number;
 }
+/**
+ * Manages voice connection state for all guilds.
+ *
+ * Fixes from v1:
+ * - Uses player's actual selfDeaf/selfMute in retries (was hardcoded)
+ * - Proper state machine (IDLE → CONNECTING → READY → DISCONNECTING)
+ * - Connection age tracking
+ * - Full cleanup on destroy()
+ * - Null safety on all methods
+ */
 export declare class ConnectionPool {
     private readonly manager;
     private readonly connections;
     constructor(manager: Yukimu);
+    /**
+     * Register a new voice connection or update an existing one.
+     */
     add(guildId: string, channelId: string): VoiceConnection;
     get(guildId: string): VoiceConnection | undefined;
+    /**
+     * Remove a voice connection and clean up its timers.
+     */
     remove(guildId: string): void;
     has(guildId: string): boolean;
-    updateSession(guildId: string, sessionId: string, channelId?: string): void;
+    /**
+     * Update session ID from VOICE_STATE_UPDATE.
+     * Null-safe: only updates if sessionId is provided.
+     */
+    updateSession(guildId: string, sessionId: string | undefined, channelId?: string): void;
+    /**
+     * Update voice server info from VOICE_SERVER_UPDATE.
+     */
     updateServer(guildId: string, token: string, endpoint: string): void;
+    /**
+     * Mark a connection as successfully established.
+     */
     markConnected(guildId: string): void;
+    /**
+     * Check if we have all the data needed to send a voice update to Lavalink.
+     */
     isReady(guildId: string): boolean;
+    /**
+     * Get the voice state payload for Lavalink.
+     */
     getVoiceState(guildId: string): {
         token: string;
         endpoint: string;
         sessionId: string;
+        channelId: string;
     } | null;
+    /**
+     * Get all active connections (for debugging/monitoring).
+     */
+    getAll(): ReadonlyMap<string, VoiceConnection>;
+    /**
+     * Clean up all connections and timers.
+     */
+    destroy(): void;
+    private clearTimers;
     private startTimeout;
     private handleConnectionFailure;
     get size(): number;

package/dist/ConnectionPool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConnectionPool.d.ts","sourceRoot":"","sources":["../src/ConnectionPool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;IAC9C,YAAY,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;IACnD,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAKD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2C;gBAE3D,OAAO,EAAE,MAAM;IAIpB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe;IAexD,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIjD,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQ7B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI7B,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAO3E,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAOpE,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IASpC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAKjC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAMpG,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,uBAAuB;IA+B/B,IAAI,IAAI,IAAI,MAAM,CAAkC;CACrD"}
+{"version":3,"file":"ConnectionPool.d.ts","sourceRoot":"","sources":["../src/ConnectionPool.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAE/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAOvC,oBAAY,oBAAoB;IAC9B,IAAI,IAAI;IACR,UAAU,IAAI;IACd,KAAK,IAAI;IACT,aAAa,IAAI;CAClB;AAID,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,oBAAoB,CAAC;IAC5B,OAAO,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;IAC9C,YAAY,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAKD;;;;;;;;;GASG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2C;gBAE3D,OAAO,EAAE,MAAM;IAI3B;;OAEG;IACI,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe;IA0BxD,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIxD;;OAEG;IACI,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO7B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIpC;;;OAGG;IACI,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAO9F;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAO3E;;OAEG;IACI,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQ3C;;OAEG;IACI,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAMxC;;OAEG;IACI,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG;QACrC,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,IAAI;IAWR;;OAEG;IACI,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC;IAIrD;;OAEG;IACI,OAAO,IAAI,IAAI;IAStB,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,uBAAuB;IA2C/B,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/ConnectionPool.js

@@ -1,24 +1,56 @@
 "use strict";
+/** Yukimu v2.0.0 — Voice Connection Pool with State Machine */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConnectionPool = void 0;
+exports.ConnectionPool = exports.VoiceConnectionState = void 0;
+const Constants_1 = require("./Constants");
+const YukimuError_1 = require("./errors/YukimuError");
+// ─── Connection State ───────────────────────────────────────────────────────
+var VoiceConnectionState;
+(function (VoiceConnectionState) {
+    VoiceConnectionState[VoiceConnectionState["IDLE"] = 0] = "IDLE";
+    VoiceConnectionState[VoiceConnectionState["CONNECTING"] = 1] = "CONNECTING";
+    VoiceConnectionState[VoiceConnectionState["READY"] = 2] = "READY";
+    VoiceConnectionState[VoiceConnectionState["DISCONNECTING"] = 3] = "DISCONNECTING";
+})(VoiceConnectionState || (exports.VoiceConnectionState = VoiceConnectionState = {}));
 const MAX_VOICE_RETRIES = 3;
 const VOICE_RETRY_DELAY = 5000;
+/**
+ * Manages voice connection state for all guilds.
+ *
+ * Fixes from v1:
+ * - Uses player's actual selfDeaf/selfMute in retries (was hardcoded)
+ * - Proper state machine (IDLE → CONNECTING → READY → DISCONNECTING)
+ * - Connection age tracking
+ * - Full cleanup on destroy()
+ * - Null safety on all methods
+ */
 class ConnectionPool {
+    manager;
+    connections = new Map();
     constructor(manager) {
-        this.connections = new Map();
         this.manager = manager;
     }
+    /**
+     * Register a new voice connection or update an existing one.
+     */
     add(guildId, channelId) {
         const existing = this.connections.get(guildId);
         if (existing) {
             existing.channelId = channelId;
+            existing.state = VoiceConnectionState.CONNECTING;
             return existing;
         }
         const conn = {
-            guildId, channelId,
-            sessionId: null, token: null, endpoint: null,
-            timeout: null, retryTimeout: null,
-            connected: false, retries: 0,
+            guildId,
+            channelId,
+            sessionId: null,
+            token: null,
+            endpoint: null,
+            state: VoiceConnectionState.CONNECTING,
+            timeout: null,
+            retryTimeout: null,
+            retries: 0,
+            createdAt: Date.now(),
         };
         this.connections.set(guildId, conn);
         this.startTimeout(conn);
@@ -27,27 +59,35 @@ class ConnectionPool {
     get(guildId) {
         return this.connections.get(guildId);
     }
+    /**
+     * Remove a voice connection and clean up its timers.
+     */
     remove(guildId) {
         const conn = this.connections.get(guildId);
         if (!conn)
             return;
-        if (conn.timeout)
-            clearTimeout(conn.timeout);
-        if (conn.retryTimeout)
-            clearTimeout(conn.retryTimeout);
+        this.clearTimers(conn);
         this.connections.delete(guildId);
     }
     has(guildId) {
         return this.connections.has(guildId);
     }
+    /**
+     * Update session ID from VOICE_STATE_UPDATE.
+     * Null-safe: only updates if sessionId is provided.
+     */
     updateSession(guildId, sessionId, channelId) {
         const conn = this.connections.get(guildId);
         if (!conn)
             return;
-        conn.sessionId = sessionId;
+        if (sessionId)
+            conn.sessionId = sessionId;
         if (channelId)
             conn.channelId = channelId;
     }
+    /**
+     * Update voice server info from VOICE_SERVER_UPDATE.
+     */
     updateServer(guildId, token, endpoint) {
         const conn = this.connections.get(guildId);
         if (!conn)
@@ -55,12 +95,57 @@ class ConnectionPool {
         conn.token = token;
         conn.endpoint = endpoint;
     }
+    /**
+     * Mark a connection as successfully established.
+     */
     markConnected(guildId) {
         const conn = this.connections.get(guildId);
         if (!conn)
             return;
-        conn.connected = true;
+        conn.state = VoiceConnectionState.READY;
         conn.retries = 0;
+        this.clearTimers(conn);
+    }
+    /**
+     * Check if we have all the data needed to send a voice update to Lavalink.
+     */
+    isReady(guildId) {
+        const conn = this.connections.get(guildId);
+        if (!conn)
+            return false;
+        return !!(conn.sessionId && conn.token && conn.endpoint);
+    }
+    /**
+     * Get the voice state payload for Lavalink.
+     */
+    getVoiceState(guildId) {
+        const conn = this.connections.get(guildId);
+        if (!conn?.sessionId || !conn.token || !conn.endpoint)
+            return null;
+        return {
+            token: conn.token,
+            endpoint: conn.endpoint,
+            sessionId: conn.sessionId,
+            channelId: conn.channelId,
+        };
+    }
+    /**
+     * Get all active connections (for debugging/monitoring).
+     */
+    getAll() {
+        return this.connections;
+    }
+    /**
+     * Clean up all connections and timers.
+     */
+    destroy() {
+        for (const conn of this.connections.values()) {
+            this.clearTimers(conn);
+        }
+        this.connections.clear();
+    }
+    // ─── Internal ───────────────────────────────────────────────────────────
+    clearTimers(conn) {
         if (conn.timeout) {
             clearTimeout(conn.timeout);
             conn.timeout = null;
@@ -70,55 +155,49 @@ class ConnectionPool {
             conn.retryTimeout = null;
         }
     }
-    isReady(guildId) {
-        const conn = this.connections.get(guildId);
-        return !!(conn?.sessionId && conn?.token && conn?.endpoint);
-    }
-    getVoiceState(guildId) {
-        const conn = this.connections.get(guildId);
-        if (!conn?.sessionId || !conn?.token || !conn?.endpoint)
-            return null;
-        return { token: conn.token, endpoint: conn.endpoint, sessionId: conn.sessionId };
-    }
     startTimeout(conn) {
-        const timeoutMs = this.manager.options.voiceConnectionTimeout ?? 15000;
-        if (conn.timeout)
-            clearTimeout(conn.timeout);
+        const timeoutMs = this.manager.options.voiceConnectionTimeout ?? Constants_1.DEFAULTS.VOICE_CONNECTION_TIMEOUT;
+        this.clearTimers(conn);
         conn.timeout = setTimeout(() => {
-            if (!conn.connected)
+            if (conn.state !== VoiceConnectionState.READY) {
                 this.handleConnectionFailure(conn);
+            }
         }, timeoutMs);
     }
     handleConnectionFailure(conn) {
         if (conn.retries >= MAX_VOICE_RETRIES) {
             const player = this.manager.players.get(conn.guildId);
+            const error = new YukimuError_1.VoiceConnectionError(`Voice connection failed after ${MAX_VOICE_RETRIES} retries for guild ${conn.guildId}`, conn.guildId, YukimuError_1.ErrorCode.VOICE_CONNECTION_TIMEOUT);
+            this.manager.logger.error(error.message);
             if (player) {
-                this.manager.emit("playerError", player, new Error(`Voice connection failed after ${MAX_VOICE_RETRIES} retries`));
+                this.manager.emit("playerError", player, error);
                 this.manager.destroyPlayer(conn.guildId).catch(() => { });
             }
             this.remove(conn.guildId);
             return;
         }
         conn.retries++;
+        this.manager.logger.warn(`Voice retry ${conn.retries}/${MAX_VOICE_RETRIES} for guild ${conn.guildId}`);
+        // Use the player's actual selfDeaf/selfMute settings
         const player = this.manager.players.get(conn.guildId);
-        if (player) {
-            console.warn(`[Yukimu] 🔄 Voice retry ${conn.retries}/${MAX_VOICE_RETRIES} for guild ${conn.guildId}`);
-            conn.retryTimeout = setTimeout(() => {
-                // Re-send join payload via connector
-                this.manager.connector.sendPayload(conn.guildId, {
-                    op: 4,
-                    d: {
-                        guild_id: conn.guildId,
-                        channel_id: conn.channelId,
-                        self_deaf: true,
-                        self_mute: false,
-                    },
-                });
-                this.startTimeout(conn);
-            }, VOICE_RETRY_DELAY * conn.retries);
-        }
+        const selfDeaf = player?.selfDeaf ?? true;
+        const selfMute = player?.selfMute ?? false;
+        conn.retryTimeout = setTimeout(() => {
+            this.manager.connector.sendPayload(conn.guildId, {
+                op: 4,
+                d: {
+                    guild_id: conn.guildId,
+                    channel_id: conn.channelId,
+                    self_deaf: selfDeaf,
+                    self_mute: selfMute,
+                },
+            });
+            this.startTimeout(conn);
+        }, VOICE_RETRY_DELAY * conn.retries);
+    }
+    get size() {
+        return this.connections.size;
     }
-    get size() { return this.connections.size; }
 }
 exports.ConnectionPool = ConnectionPool;
 //# sourceMappingURL=ConnectionPool.js.map

package/dist/ConnectionPool.js.map

@@ -1 +1 @@
-{"version":3,"file":"ConnectionPool.js","sourceRoot":"","sources":["../src/ConnectionPool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ConnectionPool.js","sourceRoot":"","sources":["../src/ConnectionPool.ts"],"names":[],"mappings":"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"}

package/dist/Constants.d.ts

@@ -1,9 +1,11 @@
-/** Lavalink v3/v4 supported ops and constants */
+/** Yukimu v2.0.0 — Constants & Enumerations */
 export declare const VERSION = "2.0.0";
 export declare const CLIENT_NAME = "Yukimu/2.0.0";
 export declare enum State {
     CONNECTING = 0,
+    /** WebSocket open, waiting for ready op */
     NEARLY = 1,
+    /** Fully connected and ready */
     CONNECTED = 2,
     DISCONNECTING = 3,
     DISCONNECTED = 4,
@@ -15,52 +17,29 @@ export declare enum PlayerState {
     DISCONNECTING = 2,
     DISCONNECTED = 3
 }
-export declare enum OpCodes {
-    PLAY = "play",
-    STOP = "stop",
-    PAUSE = "pause",
-    SEEK = "seek",
-    VOLUME = "volume",
-    FILTERS = "filters",
-    DESTROY = "destroy",
-    VOICE_UPDATE = "voiceUpdate",
-    EQUALIZER = "equalizer",
-    STATS = "stats",
-    PLAYER_UPDATE = "playerUpdate",
-    EVENT = "event",
-    READY = "ready"
-}
-export declare enum LoadType {
-    TRACK = "track",
-    PLAYLIST = "playlist",
-    SEARCH = "search",
-    EMPTY = "empty",
-    ERROR = "error",
-    TRACK_LOADED = "track_loaded",
-    PLAYLIST_LOADED = "playlist_loaded",
-    SEARCH_RESULT = "search_result",
-    NO_MATCHES = "no_matches",
-    LOAD_FAILED = "load_failed"
-}
-export declare enum EventType {
-    TRACK_START = "TrackStartEvent",
-    TRACK_END = "TrackEndEvent",
-    TRACK_EXCEPTION = "TrackExceptionEvent",
-    TRACK_STUCK = "TrackStuckEvent",
-    WS_CLOSED = "WebSocketClosedEvent"
-}
-export declare enum TrackEndReason {
-    FINISHED = "finished",
-    LOAD_FAILED = "loadFailed",
-    STOPPED = "stopped",
-    REPLACED = "replaced",
-    CLEANUP = "cleanup",
-    FINISHED_V3 = "FINISHED",
-    STOPPED_V3 = "STOPPED",
-    REPLACED_V3 = "REPLACED",
-    CLEANUP_V3 = "CLEANUP"
-}
-export declare const STOPPED_REASONS: Set<string>;
 export declare const SOURCE_PREFIXES: Record<string, string>;
 export declare const URL_PATTERNS: Record<string, RegExp[]>;
+export declare const STOPPED_REASONS: Set<string>;
+export declare const WS_CLOSE_CODES: Record<number, string>;
+import type { BitrateConfig, BoostTier } from "./types";
+export declare const BITRATE_BY_BOOST_TIER: Record<BoostTier, BitrateConfig>;
+export declare const DEFAULTS: {
+    readonly VOICE_CONNECTION_TIMEOUT: 15000;
+    readonly MAX_CACHE_SIZE: 1000;
+    readonly CACHE_TTL: 3600000;
+    readonly HEARTBEAT_INTERVAL: 30000;
+    readonly WS_SEND_TIMEOUT: 30000;
+    readonly WS_MAX_QUEUE: 100;
+    readonly REST_TIMEOUT: 30000;
+    readonly REST_MAX_RETRIES: 3;
+    readonly REST_RETRY_BASE_DELAY: 1000;
+    readonly REST_RETRY_MAX_DELAY: 15000;
+    readonly NODE_CONNECTION_TIMEOUT: 10000;
+    readonly NODE_MAX_RETRIES: 5;
+    readonly NODE_MAX_RECONNECT_DELAY: 30000;
+    readonly PREVIOUS_HISTORY_SIZE: 25;
+    readonly CACHE_SWEEP_INTERVAL: 300000;
+    readonly SPOTIFY_TOKEN_REFRESH_BUFFER: 30000;
+    readonly MAX_SEARCH_RETRIES: 2;
+};
 //# sourceMappingURL=Constants.d.ts.map

package/dist/Constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Constants.d.ts","sourceRoot":"","sources":["../src/Constants.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAEjD,eAAO,MAAM,OAAO,UAAU,CAAC;AAC/B,eAAO,MAAM,WAAW,iBAAsB,CAAC;AAE/C,oBAAY,KAAK;IACf,UAAU,IAAI;IACd,MAAM,IAAI;IACV,SAAS,IAAI;IACb,aAAa,IAAI;IACjB,YAAY,IAAI;IAChB,YAAY,IAAI;CACjB;AAED,oBAAY,WAAW;IACrB,UAAU,IAAI;IACd,SAAS,IAAI;IACb,aAAa,IAAI;IACjB,YAAY,IAAI;CACjB;AAED,oBAAY,OAAO;IAEjB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;IACf,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,YAAY,gBAAgB;IAC5B,SAAS,cAAc;IAEvB,KAAK,UAAU;IACf,aAAa,iBAAiB;IAC9B,KAAK,UAAU;IACf,KAAK,UAAU;CAChB;AAED,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,KAAK,UAAU;IAEf,YAAY,iBAAiB;IAC7B,eAAe,oBAAoB;IACnC,aAAa,kBAAkB;IAC/B,UAAU,eAAe;IACzB,WAAW,gBAAgB;CAC5B;AAED,oBAAY,SAAS;IACnB,WAAW,oBAAoB;IAC/B,SAAS,kBAAkB;IAC3B,eAAe,wBAAwB;IACvC,WAAW,oBAAoB;IAC/B,SAAS,yBAAyB;CACnC;AAED,oBAAY,cAAc;IACxB,QAAQ,aAAa;IACrB,WAAW,eAAe;IAC1B,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,OAAO,YAAY;IAEnB,WAAW,aAAa;IACxB,UAAU,YAAY;IACtB,WAAW,aAAa;IACxB,UAAU,YAAY;CACvB;AAED,eAAO,MAAM,eAAe,aAE1B,CAAC;AAEH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAWlD,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CASjD,CAAC"}
+{"version":3,"file":"Constants.d.ts","sourceRoot":"","sources":["../src/Constants.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAE/C,eAAO,MAAM,OAAO,UAAU,CAAC;AAC/B,eAAO,MAAM,WAAW,iBAAsB,CAAC;AAI/C,oBAAY,KAAK;IACf,UAAU,IAAI;IACd,2CAA2C;IAC3C,MAAM,IAAI;IACV,gCAAgC;IAChC,SAAS,IAAI;IACb,aAAa,IAAI;IACjB,YAAY,IAAI;IAChB,YAAY,IAAI;CACjB;AAID,oBAAY,WAAW;IACrB,UAAU,IAAI;IACd,SAAS,IAAI;IACb,aAAa,IAAI;IACjB,YAAY,IAAI;CACjB;AAMD,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAgBlD,CAAC;AAMF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAiEjD,CAAC;AAMF,eAAO,MAAM,eAAe,aAO1B,CAAC;AAIH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAajD,CAAC;AAIF,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAExD,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,SAAS,EAAE,aAAa,CAKlE,CAAC;AAIF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;CAkBX,CAAC"}