yukimu 2.0.8 → 3.0.0

package/dist/Node.js

@@ -0,0 +1,446 @@
+"use strict";
+/** Yukimu v2.0.0 — Lavalink Node Manager */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Node = void 0;
+const ws_1 = __importDefault(require("ws"));
+const Rest_1 = require("./Rest");
+const WsQueue_1 = require("./WsQueue");
+const Constants_1 = require("./Constants");
+const YukimuError_1 = require("./errors/YukimuError");
+const WS_CLOSE_NORMAL = 1000;
+/**
+ * Represents a connection to a single Lavalink node.
+ *
+ * Critical fixes from v1:
+ * 1. Session resume: waits for `ready` op before calling updateSession()
+ * 2. WsQueue race condition: no duplicate `open` listener, flush called explicitly after onOpen
+ * 3. Heartbeat memory leak: properly clears interval on all disconnect paths
+ * 4. Connection timeout: WebSocket connection has a 10s timeout
+ * 5. Reconnect jitter: prevents thundering herd on multi-node reconnect
+ * 6. playerPath() null-safety for missing sessionId
+ * 7. Uses CLIENT_NAME constant, not hardcoded string
+ * 8. Uses STOPPED_REASONS Set for track end handling
+ */
+class Node {
+    manager;
+    options;
+    rest;
+    wsQueue;
+    version;
+    ws = null;
+    state = Constants_1.State.DISCONNECTED;
+    stats = null;
+    info = null;
+    sessionId = null;
+    resumed = false;
+    penalties = 0;
+    ping = -1;
+    reconnectAttempts = 0;
+    reconnectTimeout;
+    heartbeatInterval;
+    connectionTimeout;
+    lastHeartbeatAt = 0;
+    constructor(manager, options) {
+        this.manager = manager;
+        this.options = {
+            secure: false,
+            retries: Constants_1.DEFAULTS.NODE_MAX_RETRIES,
+            version: 4,
+            resumeTimeout: 60,
+            priority: 0,
+            connectionTimeout: Constants_1.DEFAULTS.NODE_CONNECTION_TIMEOUT,
+            ...options,
+        };
+        this.version = (this.options.version ?? 4);
+        this.rest = new Rest_1.Rest(this);
+        this.wsQueue = new WsQueue_1.WsQueue();
+    }
+    // ─── Getters ────────────────────────────────────────────────────────────
+    get connected() {
+        return this.state === Constants_1.State.CONNECTED || this.state === Constants_1.State.NEARLY;
+    }
+    get wsUrl() {
+        const protocol = this.options.secure ? "wss" : "ws";
+        const base = `${protocol}://${this.options.host}:${this.options.port}`;
+        return this.version === 4 ? `${base}/v4/websocket` : base;
+    }
+    get wsHeaders() {
+        const h = {
+            Authorization: this.options.password,
+            "User-Id": this.manager.options.clientId,
+            "Client-Name": Constants_1.CLIENT_NAME,
+        };
+        if (this.version === 3)
+            h["Num-Shards"] = "1";
+        if (this.options.resumeKey)
+            h["Resume-Key"] = this.options.resumeKey;
+        return h;
+    }
+    // ─── Penalty Calculation ────────────────────────────────────────────────
+    calculatePenalties() {
+        if (!this.stats)
+            return Infinity;
+        const cpu = Math.pow(1.05, 100 * this.stats.cpu.systemLoad) * 10 - 10;
+        const fs = this.stats.frameStats;
+        const deficit = fs ? Math.pow(1.03, 500 * fs.deficit / 3000) * 600 - 600 : 0;
+        const nulled = fs ? Math.pow(1.03, 500 * fs.nulled / 3000) * 300 - 300 : 0;
+        const priority = (this.options.priority ?? 0) * 100;
+        this.penalties = Math.floor(cpu + deficit + nulled + this.stats.playingPlayers + priority);
+        return this.penalties;
+    }
+    // ─── Connection Lifecycle ───────────────────────────────────────────────
+    connect() {
+        if (this.ws?.readyState === ws_1.default.OPEN)
+            return;
+        this.state = Constants_1.State.CONNECTING;
+        this.manager.emit("nodeConnecting", this);
+        try {
+            this.ws = new ws_1.default(this.wsUrl, { headers: this.wsHeaders });
+        }
+        catch (err) {
+            this.manager.logger.error(`Failed to create WebSocket for "${this.options.name}":`, err);
+            this.state = Constants_1.State.DISCONNECTED;
+            this.scheduleReconnect();
+            return;
+        }
+        // Set the socket on the queue (but DON'T add an open listener — we flush manually)
+        this.wsQueue.setSocket(this.ws);
+        this.ws.on("open", () => this.onOpen());
+        this.ws.on("message", (d) => this.onMessage(d));
+        this.ws.on("close", (code, reason) => this.onClose(code, reason.toString()));
+        this.ws.on("error", (err) => this.onError(err));
+        // Connection timeout — if we don't get "open" within N ms, abort
+        const connTimeout = this.options.connectionTimeout ?? Constants_1.DEFAULTS.NODE_CONNECTION_TIMEOUT;
+        this.connectionTimeout = setTimeout(() => {
+            if (this.state === Constants_1.State.CONNECTING) {
+                this.manager.logger.warn(`Connection timeout for node "${this.options.name}" after ${connTimeout}ms`);
+                this.destroy(true);
+                this.scheduleReconnect();
+            }
+        }, connTimeout);
+    }
+    destroy(reconnect = false) {
+        // Clear all timers
+        if (this.reconnectTimeout) {
+            clearTimeout(this.reconnectTimeout);
+            this.reconnectTimeout = undefined;
+        }
+        if (this.heartbeatInterval) {
+            clearInterval(this.heartbeatInterval);
+            this.heartbeatInterval = undefined;
+        }
+        if (this.connectionTimeout) {
+            clearTimeout(this.connectionTimeout);
+            this.connectionTimeout = undefined;
+        }
+        // Clean up WS queue
+        this.wsQueue.clear();
+        this.wsQueue.setSocket(null);
+        // Close WebSocket
+        if (this.ws) {
+            this.ws.removeAllListeners();
+            try {
+                if (this.ws.readyState === ws_1.default.OPEN || this.ws.readyState === ws_1.default.CONNECTING) {
+                    this.ws.close(WS_CLOSE_NORMAL, "destroy");
+                }
+            }
+            catch {
+                // Ignore close errors
+            }
+            this.ws = null;
+        }
+        this.state = Constants_1.State.DISCONNECTED;
+        if (!reconnect)
+            this.sessionId = null;
+    }
+    // ─── WebSocket Event Handlers ───────────────────────────────────────────
+    async onOpen() {
+        // Clear connection timeout
+        if (this.connectionTimeout) {
+            clearTimeout(this.connectionTimeout);
+            this.connectionTimeout = undefined;
+        }
+        this.state = Constants_1.State.NEARLY;
+        this.reconnectAttempts = 0;
+        this.manager.emit("nodeConnect", this);
+        this.manager.logger.info(`Node "${this.options.name}" connected (v${this.version})`);
+        // Fetch node info (non-critical, don't block)
+        try {
+            this.info = await this.rest.getInfo();
+        }
+        catch {
+            // Non-critical — info is nice to have but not required
+        }
+        // For v3, there's no "ready" op — we're connected immediately
+        if (this.version === 3) {
+            this.state = Constants_1.State.CONNECTED;
+            this.sessionId = this.options.resumeKey ?? `v3-${Date.now()}`;
+            this.manager.emit("nodeReady", this);
+        }
+        // Flush any queued messages NOW (after auth is ready)
+        this.wsQueue.flush();
+        // Start heartbeat
+        this.startHeartbeat();
+    }
+    onMessage(raw) {
+        let payload;
+        try {
+            payload = JSON.parse(raw.toString());
+        }
+        catch {
+            return;
+        }
+        const op = payload["op"];
+        if (this.version === 4) {
+            switch (op) {
+                case "ready": {
+                    this.state = Constants_1.State.CONNECTED;
+                    this.sessionId = payload["sessionId"];
+                    this.resumed = payload["resumed"] ?? false;
+                    this.manager.emit("nodeReady", this);
+                    this.manager.logger.info(`Node "${this.options.name}" ready | session: ${this.sessionId} | resumed: ${this.resumed}`);
+                    // NOW that we have a sessionId, configure session resuming
+                    if (this.options.resumeKey) {
+                        this.rest
+                            .updateSession({ resuming: true, timeout: this.options.resumeTimeout ?? 60 })
+                            .catch((err) => {
+                            this.manager.logger.warn(`Failed to configure session resuming: ${err}`);
+                        });
+                    }
+                    if (this.resumed)
+                        this.reconnectPlayers();
+                    break;
+                }
+                case "stats":
+                    this.stats = payload;
+                    this.calculatePenalties();
+                    break;
+                case "playerUpdate":
+                    this.handlePlayerUpdate(payload);
+                    break;
+                case "event":
+                    this.handleEvent(payload);
+                    break;
+            }
+            return;
+        }
+        // Lavalink v3
+        switch (op) {
+            case "stats":
+                this.stats = payload;
+                this.calculatePenalties();
+                break;
+            case "playerUpdate":
+                this.handlePlayerUpdate(payload);
+                break;
+            case "event":
+                this.handleEvent(payload);
+                break;
+        }
+    }
+    onClose(code, reason) {
+        // Clear heartbeat
+        if (this.heartbeatInterval) {
+            clearInterval(this.heartbeatInterval);
+            this.heartbeatInterval = undefined;
+        }
+        this.state = Constants_1.State.DISCONNECTED;
+        const codeDesc = Constants_1.WS_CLOSE_CODES[code] ?? "Unknown";
+        this.manager.emit("nodeDisconnect", this, code, reason);
+        this.manager.logger.warn(`Node "${this.options.name}" disconnected (${code}: ${codeDesc}): ${reason || "No reason"}`);
+        if (code !== WS_CLOSE_NORMAL) {
+            this.scheduleReconnect();
+        }
+        else {
+            this.movePlayers();
+        }
+    }
+    onError(error) {
+        this.manager.emit("nodeError", this, error);
+        this.manager.logger.error(`Node "${this.options.name}" error: ${error.message}`);
+    }
+    // ─── Heartbeat ──────────────────────────────────────────────────────────
+    startHeartbeat() {
+        if (this.heartbeatInterval) {
+            clearInterval(this.heartbeatInterval);
+        }
+        this.heartbeatInterval = setInterval(async () => {
+            if (!this.connected || !this.ws || this.ws.readyState !== ws_1.default.OPEN)
+                return;
+            this.lastHeartbeatAt = Date.now();
+            try {
+                this.stats = await this.rest.getStats();
+                this.ping = Date.now() - this.lastHeartbeatAt;
+                this.calculatePenalties();
+            }
+            catch (err) {
+                this.manager.logger.debug(`Heartbeat failed for "${this.options.name}": ${err}`);
+                // Don't crash — the node might have briefly disconnected
+            }
+        }, Constants_1.DEFAULTS.HEARTBEAT_INTERVAL);
+        // Don't keep the process alive just for heartbeats
+        if (this.heartbeatInterval.unref) {
+            this.heartbeatInterval.unref();
+        }
+    }
+    // ─── Reconnection ──────────────────────────────────────────────────────
+    scheduleReconnect() {
+        const max = this.options.retries ?? Constants_1.DEFAULTS.NODE_MAX_RETRIES;
+        if (this.reconnectAttempts >= max) {
+            this.manager.emit("nodeError", this, new YukimuError_1.NodeError(`Node "${this.options.name}" max retries (${max}) reached`, YukimuError_1.ErrorCode.NODE_MAX_RETRIES));
+            this.movePlayers();
+            return;
+        }
+        // Exponential backoff with jitter
+        const baseDelay = Math.min(1000 * Math.pow(2, this.reconnectAttempts), Constants_1.DEFAULTS.NODE_MAX_RECONNECT_DELAY);
+        const jitter = Math.floor(Math.random() * baseDelay * 0.3); // ±30% jitter
+        const delay = baseDelay + jitter;
+        this.reconnectAttempts++;
+        this.state = Constants_1.State.RECONNECTING;
+        this.manager.logger.info(`Reconnecting "${this.options.name}" in ${delay}ms (${this.reconnectAttempts}/${max})`);
+        this.manager.emit("nodeReconnecting", this, this.reconnectAttempts, max);
+        this.reconnectTimeout = setTimeout(() => {
+            this.destroy(true);
+            this.connect();
+        }, delay);
+    }
+    // ─── Player Movement ───────────────────────────────────────────────────
+    movePlayers() {
+        const players = [...this.manager.players.values()].filter((p) => p.node === this);
+        if (!players.length)
+            return;
+        let best;
+        try {
+            best = this.manager.getBestNode();
+        }
+        catch {
+            this.manager.logger.warn(`No available nodes to move ${players.length} players from "${this.options.name}"`);
+            return;
+        }
+        if (best === this)
+            return;
+        this.manager.logger.info(`Moving ${players.length} players from "${this.options.name}" to "${best.options.name}"`);
+        for (const player of players) {
+            player.moveToNode(best).catch((err) => {
+                this.manager.logger.error(`Failed to move player ${player.guildId}: ${err}`);
+            });
+        }
+    }
+    reconnectPlayers() {
+        for (const player of this.manager.players.values()) {
+            if (player.node === this) {
+                player.checkVoiceReady();
+            }
+        }
+    }
+    // ─── Event Handlers ────────────────────────────────────────────────────
+    handlePlayerUpdate(payload) {
+        const guildId = payload["guildId"];
+        const player = this.manager.players.get(guildId);
+        if (!player)
+            return;
+        const state = (payload["state"] ?? {});
+        if (typeof state["position"] === "number")
+            player.position = state["position"];
+        if (typeof state["ping"] === "number")
+            player.ping = state["ping"];
+        player.lastUpdated = state["time"] ?? Date.now();
+        this.manager.emit("playerUpdate", player);
+    }
+    handleEvent(payload) {
+        const guildId = payload["guildId"];
+        const player = this.manager.players.get(guildId);
+        if (!player)
+            return;
+        // Resolve track
+        let track;
+        if (this.version === 3) {
+            track = {
+                encoded: payload["track"],
+                info: {},
+                pluginInfo: {},
+            };
+        }
+        else {
+            track = payload["track"];
+            if (track?.encoded) {
+                this.manager.trackCache.set(track.encoded, track);
+            }
+        }
+        switch (payload["type"]) {
+            case "TrackStartEvent":
+                player.playing = true;
+                player.paused = false;
+                player.lastUpdated = Date.now();
+                this.manager.emit("trackStart", player, track);
+                break;
+            case "TrackEndEvent": {
+                const reason = payload["reason"];
+                player.playing = false;
+                player.position = 0;
+                this.manager.emit("trackEnd", player, track, reason);
+                // Only auto-advance if not explicitly stopped/replaced
+                if (!Constants_1.STOPPED_REASONS.has(reason)) {
+                    if (player.loop === "track" && player.queue.current) {
+                        player.play(player.queue.current).catch((err) => {
+                            this.manager.logger.error(`Failed to loop track for guild ${guildId}: ${err}`);
+                        });
+                    }
+                    else {
+                        if (player.loop === "queue" && player.queue.current) {
+                            player.queue.add(player.queue.current);
+                        }
+                        const next = player.queue.next();
+                        if (next) {
+                            player.play(next).catch((err) => {
+                                this.manager.logger.error(`Failed to play next track for guild ${guildId}: ${err}`);
+                            });
+                        }
+                        else {
+                            this.manager.emit("queueEnd", player);
+                            if (player.autoplay && track?.info?.uri) {
+                                this.manager.emit("autoplayRequest", player, track);
+                            }
+                        }
+                    }
+                }
+                break;
+            }
+            case "TrackExceptionEvent":
+                this.manager.emit("trackError", player, track, payload["exception"]);
+                break;
+            case "TrackStuckEvent":
+                this.manager.emit("trackStuck", player, track, payload["thresholdMs"]);
+                // Auto-skip stuck tracks
+                player.skip().catch((err) => {
+                    this.manager.logger.error(`Failed to skip stuck track for guild ${guildId}: ${err}`);
+                });
+                break;
+            case "WebSocketClosedEvent":
+                this.manager.emit("socketClosed", player, payload["code"], payload["reason"], payload["byRemote"]);
+                break;
+        }
+    }
+    // ─── Public API ─────────────────────────────────────────────────────────
+    send(data, priority = false) {
+        return this.wsQueue.send(data, priority);
+    }
+    async loadTracks(identifier) {
+        return this.rest.loadTracks(identifier);
+    }
+    playerPath(guildId) {
+        if (this.version === 4) {
+            if (!this.sessionId) {
+                this.manager.logger.warn(`playerPath called but sessionId is null for node "${this.options.name}"`);
+                return `/sessions/unknown/players/${guildId}`;
+            }
+            return `/sessions/${this.sessionId}/players/${guildId}`;
+        }
+        return `/players/${guildId}`;
+    }
+}
+exports.Node = Node;
+//# sourceMappingURL=Node.js.map

package/dist/Node.js.map

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

package/dist/Player.d.ts

@@ -0,0 +1,143 @@
+/** Yukimu v2.0.0 — Player with State Safety & Bitrate Optimization */
+import { Queue } from "./Queue";
+import { PlayerState } from "./Constants";
+import type { Yukimu } from "./Yukimu";
+import type { Node } from "./Node";
+import type { Track, PlayerOptions, FilterOptions, LoopMode, BoostTier } from "./types";
+/**
+ * Represents an audio player for a specific Discord guild.
+ *
+ * Critical fixes from v1:
+ * 1. play() — only sets playing=true AFTER the REST call succeeds
+ * 2. pause() — paused tracks are still "playing" from Lavalink's perspective
+ * 3. moveToNode() — properly re-sends voice state to the new node
+ * 4. sendVoicePayload() — deferred until connector is ready (safe for startup)
+ * 5. Proper cleanup in destroy() — all state, timers, and references
+ * 6. Input validation on filter values
+ * 7. Boost-tier-aware audio optimization
+ */
+export declare class Player {
+    readonly manager: Yukimu;
+    node: Node;
+    readonly queue: Queue;
+    readonly guildId: string;
+    voiceChannelId: string | null;
+    textChannelId?: string;
+    state: PlayerState;
+    playing: boolean;
+    paused: boolean;
+    position: number;
+    ping: number;
+    lastUpdated: number;
+    volume: number;
+    loop: LoopMode;
+    autoplay: boolean;
+    sessionId: string | null;
+    voiceToken: string | null;
+    voiceEndpoint: string | null;
+    selfDeaf: boolean;
+    selfMute: boolean;
+    filters: FilterOptions;
+    readonly data: Map<string, unknown>;
+    /** @internal Deferred resolver for voice connection readiness */
+    private _connectionResolve;
+    constructor(manager: Yukimu, node: Node, options: PlayerOptions);
+    get connected(): boolean;
+    /**
+     * Estimated real-time position accounting for time since last update.
+     * Returns the actual position (capped at track length).
+     */
+    get realPosition(): number;
+    /**
+     * Get the current boost tier of the guild this player is in.
+     */
+    get boostTier(): BoostTier;
+    sendVoicePayload(channelId: string | null, selfDeaf: boolean, selfMute: boolean): void;
+    /**
+     * Check if we have all voice connection data and send it to Lavalink.
+     */
+    checkVoiceReady(): void;
+    /**
+     * Play a track. If no track is provided, plays the current queue track.
+     *
+     * FIX: Only sets `playing = true` after the REST call succeeds.
+     * In v1, state was set before the REST call, causing ghost playing state on failure.
+     */
+    play(track?: Track, options?: {
+        startTime?: number;
+        endTime?: number;
+        noReplace?: boolean;
+    }): Promise<void>;
+    /**
+     * Wait for voice connection to be ready.
+     * Resolves immediately if already connected, otherwise waits up to timeoutMs.
+     * Does NOT reject on timeout — play() will proceed anyway and let Lavalink handle it.
+     */
+    private waitForConnection;
+    /**
+     * Pause or unpause playback.
+     *
+     * FIX: `playing` now reflects "has an active track" independently of pause state.
+     * A paused player is still "playing" (it has an active track, just paused).
+     */
+    pause(state?: boolean): Promise<void>;
+    resume(): Promise<void>;
+    stop(): Promise<void>;
+    skip(): Promise<Track | null>;
+    /**
+     * Play the previous track (from history).
+     * @returns The previous track, or null if no history exists
+     */
+    previous(): Promise<Track | null>;
+    /**
+     * Restart the currently playing track from the beginning.
+     */
+    replay(): Promise<void>;
+    seek(position: number): Promise<void>;
+    setVolume(volume: number): Promise<void>;
+    setFilters(filters: FilterOptions): Promise<void>;
+    clearFilters(): Promise<void>;
+    setBassBoost(level: "off" | "low" | "medium" | "high" | "extreme"): Promise<void>;
+    setNightcore(enabled: boolean): Promise<void>;
+    setVaporwave(enabled: boolean): Promise<void>;
+    set8D(enabled: boolean): Promise<void>;
+    setKaraoke(enabled: boolean): Promise<void>;
+    setTremolo(enabled: boolean, frequency?: number, depth?: number): Promise<void>;
+    setVibrato(enabled: boolean, frequency?: number, depth?: number): Promise<void>;
+    setLowPass(enabled: boolean, smoothing?: number): Promise<void>;
+    /** Set playback speed (1.0 = normal, 2.0 = double speed) */
+    setSpeed(speed: number): Promise<void>;
+    /** Set playback pitch (1.0 = normal) */
+    setPitch(pitch: number): Promise<void>;
+    /**
+     * Add track(s) to the queue. If nothing is currently playing, plays immediately.
+     */
+    add(tracks: Track | Track[], requester?: unknown): Promise<void>;
+    setLoop(mode: LoopMode): void;
+    setAutoplay(enabled: boolean): void;
+    /**
+     * Move this player to a different Lavalink node.
+     *
+     * FIX: Now properly re-sends the voice state to the new node.
+     * In v1, the new node didn't know about the voice connection.
+     */
+    moveToNode(node: Node): Promise<void>;
+    /** Move the bot to a different voice channel */
+    move(channelId: string): Promise<void>;
+    /**
+     * Apply optimal audio settings based on the guild's boost tier.
+     * Automatically adjusts EQ and filters for best clarity at the available bitrate.
+     */
+    applyOptimalQuality(): Promise<void>;
+    /** Maximum audio quality — crystal clear, enhanced bass & treble */
+    setHighQuality(): Promise<void>;
+    /** Studio quality — flat, neutral, most accurate */
+    setStudioQuality(): Promise<void>;
+    /** Concert hall effect — scaled for boost tier */
+    setConcertHall(): Promise<void>;
+    /**
+     * Destroy this player and clean up all resources.
+     */
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=Player.d.ts.map

package/dist/Player.d.ts.map

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