yukimu 2.0.0 → 2.0.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yukimu",
-  "version": "2.0.0",
+  "version": "2.0.8",
   "description": "A production-grade Lavalink v3/v4 wrapper for Discord bots — supports YouTube, Spotify, Deezer, Apple Music, SoundCloud, Tidal, Bandcamp, Twitch, Vimeo, TikTok, and 15+ more sources with adaptive bitrate, auto-reconnect, and typed events",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/dist/BitrateOptimizer.d.ts

@@ -1,52 +0,0 @@
-/** 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

@@ -1 +0,0 @@
-{"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

@@ -1,115 +0,0 @@
-"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

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

package/dist/ConnectionPool.d.ts

@@ -1,84 +0,0 @@
-/** 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;
-    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;
-    /**
-     * 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;
-}
-//# sourceMappingURL=ConnectionPool.d.ts.map

package/dist/ConnectionPool.d.ts.map

@@ -1 +0,0 @@
-{"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,203 +0,0 @@
-"use strict";
-/** Yukimu v2.0.0 — Voice Connection Pool with State Machine */
-Object.defineProperty(exports, "__esModule", { value: true });
-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.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,
-            state: VoiceConnectionState.CONNECTING,
-            timeout: null,
-            retryTimeout: null,
-            retries: 0,
-            createdAt: Date.now(),
-        };
-        this.connections.set(guildId, conn);
-        this.startTimeout(conn);
-        return conn;
-    }
-    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;
-        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;
-        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)
-            return;
-        conn.token = token;
-        conn.endpoint = endpoint;
-    }
-    /**
-     * Mark a connection as successfully established.
-     */
-    markConnected(guildId) {
-        const conn = this.connections.get(guildId);
-        if (!conn)
-            return;
-        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;
-        }
-        if (conn.retryTimeout) {
-            clearTimeout(conn.retryTimeout);
-            conn.retryTimeout = null;
-        }
-    }
-    startTimeout(conn) {
-        const timeoutMs = this.manager.options.voiceConnectionTimeout ?? Constants_1.DEFAULTS.VOICE_CONNECTION_TIMEOUT;
-        this.clearTimers(conn);
-        conn.timeout = setTimeout(() => {
-            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, 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);
-        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;
-    }
-}
-exports.ConnectionPool = ConnectionPool;
-//# sourceMappingURL=ConnectionPool.js.map

package/dist/ConnectionPool.js.map

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

package/dist/Constants.d.ts

@@ -1,45 +0,0 @@
-/** 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,
-    RECONNECTING = 5
-}
-export declare enum PlayerState {
-    CONNECTING = 0,
-    CONNECTED = 1,
-    DISCONNECTING = 2,
-    DISCONNECTED = 3
-}
-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 +0,0 @@
-{"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"}