yukimu 2.0.8 → 3.0.0

package/dist/Yukimu.d.ts

@@ -0,0 +1,84 @@
+/** Yukimu v2.0.0 — Main Manager Class */
+import { EventEmitter } from "events";
+import { Node } from "./Node";
+import { Player } from "./Player";
+import { Resolver } from "./Resolver";
+import { ConnectionPool } from "./ConnectionPool";
+import { TrackCache } from "./TrackCache";
+import { Logger } from "./Logger";
+import type { Plugin } from "./Plugin";
+import type { Connector } from "./connector/Connector";
+import type { YukimuOptions, NodeOptions, PlayerOptions, YukimuEvents, SearchSource, SearchResult } from "./types";
+/**
+ * Main manager class — the entry point for Yukimu.
+ *
+ * Fixes from v1:
+ * 1. destroy() — properly destroys all players, cleans pool, removes listeners
+ * 2. handleVoiceStateUpdate — null-safe for partial updates (missing session_id)
+ * 3. Uses logger system instead of bare console calls
+ * 4. Graceful shutdown with timeout
+ * 5. isReady getter
+ * 6. Aggregated node stats
+ */
+export declare class Yukimu extends EventEmitter {
+    readonly options: YukimuOptions;
+    readonly nodes: Map<string, Node>;
+    readonly players: Map<string, Player>;
+    readonly connector: Connector;
+    readonly resolver: Resolver;
+    readonly pool: ConnectionPool;
+    readonly trackCache: TrackCache;
+    readonly logger: Logger;
+    private readonly plugins;
+    nodeResolver?: (nodes: Map<string, Node>) => Node | undefined;
+    constructor(options: YukimuOptions, connector: Connector, nodes: NodeOptions[], plugins?: Plugin[]);
+    /** Whether at least one node is connected and ready */
+    get isReady(): boolean;
+    use(plugin: Plugin): this;
+    unuse(name: string): this;
+    getPlugin<T extends Plugin>(name: string): T | undefined;
+    addNode(options: NodeOptions): Node;
+    removeNode(name: string): void;
+    getNode(name?: string): Node;
+    getBestNode(): Node;
+    createPlayer(options: PlayerOptions): Player;
+    getPlayer(guildId: string): Player | null;
+    destroyPlayer(guildId: string): Promise<void>;
+    search(query: string, options?: {
+        source?: SearchSource;
+        requester?: unknown;
+        node?: Node;
+    }): Promise<SearchResult>;
+    handleVoiceStateUpdate(data: Record<string, unknown>): void;
+    handleVoiceServerUpdate(data: Record<string, unknown>): void;
+    detectSource(url: string): SearchSource | null;
+    getStats(): {
+        nodes: number;
+        connectedNodes: number;
+        players: number;
+        playingPlayers: number;
+        cache: {
+            tracks: number;
+            searches: number;
+            hits: number;
+            misses: number;
+            hitRate: number;
+        };
+    };
+    /**
+     * Gracefully destroy the manager and all its resources.
+     * Unlike v1, this properly:
+     * - Destroys all players (leave voice, clean up on Lavalink)
+     * - Destroys all nodes (close WebSockets, clear timers)
+     * - Cleans up the connection pool
+     * - Clears the track cache
+     * - Unloads all plugins
+     * - Removes all event listeners
+     */
+    destroy(): Promise<void>;
+    on<K extends keyof YukimuEvents>(event: K, listener: (...args: YukimuEvents[K]) => void): this;
+    once<K extends keyof YukimuEvents>(event: K, listener: (...args: YukimuEvents[K]) => void): this;
+    off<K extends keyof YukimuEvents>(event: K, listener: (...args: YukimuEvents[K]) => void): this;
+    emit<K extends keyof YukimuEvents>(event: K, ...args: YukimuEvents[K]): boolean;
+}
+//# sourceMappingURL=Yukimu.d.ts.map

package/dist/Yukimu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Yukimu.d.ts","sourceRoot":"","sources":["../src/Yukimu.ts"],"names":[],"mappings":"AAAA,yCAAyC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;GAUG;AACH,qBAAa,MAAO,SAAQ,YAAY;IACtC,SAAgB,OAAO,EAAE,aAAa,CAAC;IACvC,SAAgB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAa;IACrD,SAAgB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IACzD,SAAgB,SAAS,EAAE,SAAS,CAAC;IACrC,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IACnC,SAAgB,IAAI,EAAE,cAAc,CAAC;IACrC,SAAgB,UAAU,EAAE,UAAU,CAAC;IACvC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IACnD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,IAAI,GAAG,SAAS,CAAC;gBAGnE,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,WAAW,EAAE,EACpB,OAAO,GAAE,MAAM,EAAO;IAmCxB,uDAAuD;IACvD,IAAI,OAAO,IAAI,OAAO,CAErB;IAIM,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAUzB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAWzB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAMxD,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAUnC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAU9B,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAS5B,WAAW,IAAI,IAAI;IAkBnB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM;IAY5C,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAInC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7C,MAAM,CACjB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,YAAY,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,IAAI,CAAA;KAAE,GACpE,OAAO,CAAC,YAAY,CAAC;IAWjB,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IA8C3D,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAuB5D,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAO9C,QAAQ;;;;;;;;;;;;;IAWf;;;;;;;;;OASG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAsC9B,EAAE,CAAC,CAAC,SAAS,MAAM,YAAY,EACpC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,GAC3C,IAAI;IAIA,IAAI,CAAC,CAAC,SAAS,MAAM,YAAY,EACtC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,GAC3C,IAAI;IAIA,GAAG,CAAC,CAAC,SAAS,MAAM,YAAY,EACrC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,GAC3C,IAAI;IAIA,IAAI,CAAC,CAAC,SAAS,MAAM,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO;CAGvF"}

package/dist/Yukimu.js

@@ -0,0 +1,290 @@
+"use strict";
+/** Yukimu v2.0.0 — Main Manager Class */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Yukimu = void 0;
+const events_1 = require("events");
+const Node_1 = require("./Node");
+const Player_1 = require("./Player");
+const Resolver_1 = require("./Resolver");
+const ConnectionPool_1 = require("./ConnectionPool");
+const TrackCache_1 = require("./TrackCache");
+const Logger_1 = require("./Logger");
+const Constants_1 = require("./Constants");
+const YukimuError_1 = require("./errors/YukimuError");
+/**
+ * Main manager class — the entry point for Yukimu.
+ *
+ * Fixes from v1:
+ * 1. destroy() — properly destroys all players, cleans pool, removes listeners
+ * 2. handleVoiceStateUpdate — null-safe for partial updates (missing session_id)
+ * 3. Uses logger system instead of bare console calls
+ * 4. Graceful shutdown with timeout
+ * 5. isReady getter
+ * 6. Aggregated node stats
+ */
+class Yukimu extends events_1.EventEmitter {
+    options;
+    nodes = new Map();
+    players = new Map();
+    connector;
+    resolver;
+    pool;
+    trackCache;
+    logger;
+    plugins = new Map();
+    nodeResolver;
+    constructor(options, connector, nodes, plugins = []) {
+        super();
+        this.options = {
+            moveOnDisconnect: true,
+            voiceConnectionTimeout: Constants_1.DEFAULTS.VOICE_CONNECTION_TIMEOUT,
+            ...options,
+        };
+        // Initialize logger
+        this.logger = new Logger_1.Logger(options.logLevel ?? "info", options.logger);
+        // Initialize subsystems
+        this.connector = connector.set(this);
+        this.resolver = new Resolver_1.Resolver(this);
+        this.pool = new ConnectionPool_1.ConnectionPool(this);
+        this.trackCache = new TrackCache_1.TrackCache(options.cacheTTL ?? Constants_1.DEFAULTS.CACHE_TTL, options.maxCacheSize ?? Constants_1.DEFAULTS.MAX_CACHE_SIZE);
+        // Load plugins
+        for (const plugin of plugins)
+            this.use(plugin);
+        // Start listening for voice events
+        this.connector.listen();
+        // Connect to all nodes
+        for (const node of nodes)
+            this.addNode(node);
+        this.logger.info(`Yukimu v2.0.0 initialized with ${nodes.length} node(s) and ${plugins.length} plugin(s)`);
+    }
+    // ─── State ──────────────────────────────────────────────────────────────
+    /** Whether at least one node is connected and ready */
+    get isReady() {
+        return [...this.nodes.values()].some((n) => n.connected);
+    }
+    // ─── Plugin System ────────────────────────────────────────────────────
+    use(plugin) {
+        if (this.plugins.has(plugin.name)) {
+            throw new YukimuError_1.YukimuError(`Plugin "${plugin.name}" already loaded`, YukimuError_1.ErrorCode.PLUGIN_ALREADY_LOADED);
+        }
+        plugin.load(this);
+        this.plugins.set(plugin.name, plugin);
+        this.logger.info(`Plugin "${plugin.name}" loaded`);
+        return this;
+    }
+    unuse(name) {
+        const plugin = this.plugins.get(name);
+        if (!plugin) {
+            throw new YukimuError_1.YukimuError(`Plugin "${name}" not found`, YukimuError_1.ErrorCode.PLUGIN_NOT_FOUND);
+        }
+        plugin.unload?.(this);
+        this.plugins.delete(name);
+        this.logger.info(`Plugin "${name}" unloaded`);
+        return this;
+    }
+    getPlugin(name) {
+        return this.plugins.get(name);
+    }
+    // ─── Node Management ──────────────────────────────────────────────────
+    addNode(options) {
+        if (this.nodes.has(options.name)) {
+            throw new YukimuError_1.YukimuError(`Node "${options.name}" already exists`, YukimuError_1.ErrorCode.NODE_ALREADY_EXISTS);
+        }
+        const node = new Node_1.Node(this, options);
+        this.nodes.set(options.name, node);
+        node.connect();
+        return node;
+    }
+    removeNode(name) {
+        const node = this.nodes.get(name);
+        if (!node) {
+            throw new YukimuError_1.YukimuError(`Node "${name}" not found`, YukimuError_1.ErrorCode.NODE_NOT_FOUND);
+        }
+        node.destroy();
+        this.nodes.delete(name);
+        this.logger.info(`Node "${name}" removed`);
+    }
+    getNode(name) {
+        if (name) {
+            const node = this.nodes.get(name);
+            if (!node)
+                throw new YukimuError_1.YukimuError(`Node "${name}" not found`, YukimuError_1.ErrorCode.NODE_NOT_FOUND);
+            return node;
+        }
+        return this.getBestNode();
+    }
+    getBestNode() {
+        const connected = [...this.nodes.values()].filter((n) => n.connected);
+        if (!connected.length) {
+            throw new YukimuError_1.YukimuError("No connected Lavalink nodes available", YukimuError_1.ErrorCode.NODE_DISCONNECTED);
+        }
+        // Try custom resolver first
+        if (this.nodeResolver) {
+            const resolved = this.nodeResolver(this.nodes);
+            if (resolved?.connected)
+                return resolved;
+        }
+        // Sort by penalties (lowest = best)
+        return connected.sort((a, b) => a.calculatePenalties() - b.calculatePenalties())[0];
+    }
+    // ─── Player Management ────────────────────────────────────────────────
+    createPlayer(options) {
+        const existing = this.players.get(options.guildId);
+        if (existing)
+            return existing;
+        const node = options.nodeName ? this.getNode(options.nodeName) : this.getBestNode();
+        const player = new Player_1.Player(this, node, options);
+        this.players.set(options.guildId, player);
+        this.pool.add(options.guildId, options.voiceChannelId);
+        this.emit("playerCreate", player);
+        return player;
+    }
+    getPlayer(guildId) {
+        return this.players.get(guildId) ?? null;
+    }
+    async destroyPlayer(guildId) {
+        const player = this.players.get(guildId);
+        if (!player)
+            return;
+        await player.destroy();
+        this.players.delete(guildId);
+        this.pool.remove(guildId);
+        this.emit("playerDestroy", player);
+    }
+    // ─── Search ───────────────────────────────────────────────────────────
+    async search(query, options) {
+        return this.resolver.resolve(query, options?.source ?? this.options.defaultSource ?? "youtube", options?.requester, options?.node);
+    }
+    // ─── Voice Gateway ────────────────────────────────────────────────────
+    handleVoiceStateUpdate(data) {
+        const userId = data["user_id"];
+        const guildId = data["guild_id"];
+        if (userId !== this.options.clientId)
+            return;
+        if (!guildId)
+            return;
+        const player = this.players.get(guildId);
+        const channelId = data["channel_id"];
+        // Bot left the voice channel
+        if (!channelId) {
+            this.pool.remove(guildId);
+            if (player && this.options.moveOnDisconnect) {
+                this.destroyPlayer(guildId).catch(() => { });
+            }
+            return;
+        }
+        // Update session — null-safe for partial updates
+        const sessionId = data["session_id"];
+        this.pool.updateSession(guildId, sessionId, channelId);
+        if (player) {
+            const oldChannel = player.voiceChannelId;
+            player.voiceChannelId = channelId;
+            if (sessionId)
+                player.sessionId = sessionId;
+            // Detect channel move
+            if (oldChannel && oldChannel !== channelId) {
+                this.emit("playerMove", player, oldChannel, channelId);
+            }
+            // Check if voice connection is fully ready
+            if (this.pool.isReady(guildId)) {
+                const vs = this.pool.getVoiceState(guildId);
+                if (vs) {
+                    player.voiceToken = vs.token;
+                    player.voiceEndpoint = vs.endpoint;
+                    player.checkVoiceReady();
+                    this.pool.markConnected(guildId);
+                }
+            }
+        }
+    }
+    handleVoiceServerUpdate(data) {
+        const endpoint = data["endpoint"];
+        const guildId = data["guild_id"];
+        const token = data["token"];
+        if (!endpoint || !guildId || !token)
+            return;
+        this.pool.updateServer(guildId, token, endpoint);
+        const player = this.players.get(guildId);
+        if (!player)
+            return;
+        player.voiceToken = token;
+        player.voiceEndpoint = endpoint;
+        if (this.pool.isReady(guildId)) {
+            player.checkVoiceReady();
+            this.pool.markConnected(guildId);
+        }
+    }
+    // ─── Utility ─────────────────────────────────────────────────────────
+    detectSource(url) {
+        for (const [source, patterns] of Object.entries(Constants_1.URL_PATTERNS)) {
+            if (patterns.some((p) => p.test(url)))
+                return source;
+        }
+        return null;
+    }
+    getStats() {
+        const nodes = [...this.nodes.values()];
+        return {
+            nodes: nodes.length,
+            connectedNodes: nodes.filter((n) => n.connected).length,
+            players: this.players.size,
+            playingPlayers: [...this.players.values()].filter((p) => p.playing).length,
+            cache: this.trackCache.stats,
+        };
+    }
+    /**
+     * Gracefully destroy the manager and all its resources.
+     * Unlike v1, this properly:
+     * - Destroys all players (leave voice, clean up on Lavalink)
+     * - Destroys all nodes (close WebSockets, clear timers)
+     * - Cleans up the connection pool
+     * - Clears the track cache
+     * - Unloads all plugins
+     * - Removes all event listeners
+     */
+    async destroy() {
+        this.logger.info("Destroying Yukimu instance...");
+        // Destroy all players first
+        const destroyPromises = [];
+        for (const guildId of this.players.keys()) {
+            destroyPromises.push(this.destroyPlayer(guildId).catch(() => { }));
+        }
+        await Promise.allSettled(destroyPromises);
+        // Unload all plugins
+        for (const [name, plugin] of this.plugins) {
+            try {
+                plugin.unload?.(this);
+            }
+            catch (err) {
+                this.logger.warn(`Error unloading plugin "${name}": ${err}`);
+            }
+        }
+        this.plugins.clear();
+        // Destroy all nodes
+        for (const node of this.nodes.values()) {
+            node.destroy();
+        }
+        this.nodes.clear();
+        // Clean up pool and cache
+        this.pool.destroy();
+        this.trackCache.destroy();
+        // Remove all event listeners
+        this.removeAllListeners();
+        this.logger.info("Yukimu destroyed");
+    }
+    // ─── Typed EventEmitter ───────────────────────────────────────────────
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    once(event, listener) {
+        return super.once(event, listener);
+    }
+    off(event, listener) {
+        return super.off(event, listener);
+    }
+    emit(event, ...args) {
+        return super.emit(event, ...args);
+    }
+}
+exports.Yukimu = Yukimu;
+//# sourceMappingURL=Yukimu.js.map

package/dist/Yukimu.js.map

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

package/dist/connector/Connector.d.ts

@@ -0,0 +1,34 @@
+/** Yukimu v2.0.0 — Base Connector */
+import type { Yukimu } from "../Yukimu";
+import type { BoostTier } from "../types";
+/**
+ * Abstract base class for Discord library connectors.
+ *
+ * Connectors bridge Yukimu to a specific Discord library (discord.js, Eris, Oceanic)
+ * by forwarding voice gateway events and sending voice payloads.
+ *
+ * v2 additions:
+ * - getGuildBoostTier(): Get the boost level for bitrate optimization
+ * - getChannelBitrate(): Get the current voice channel bitrate
+ */
+export declare abstract class Connector {
+    protected manager: Yukimu;
+    set(manager: Yukimu): this;
+    /** Start listening for voice gateway events (VOICE_STATE_UPDATE, VOICE_SERVER_UPDATE) */
+    abstract listen(): void;
+    /** Send a voice gateway payload to Discord */
+    abstract sendPayload(guildId: string, payload: unknown): void;
+    /**
+     * Get the Discord server's boost tier.
+     * Override in subclass for boost-tier-aware bitrate optimization.
+     * @returns 0 | 1 | 2 | 3
+     */
+    getGuildBoostTier(_guildId: string): BoostTier;
+    /**
+     * Get the current bitrate of a voice channel in kbps.
+     * Override in subclass for accurate bitrate information.
+     * @returns Bitrate in kbps, or null if unavailable
+     */
+    getChannelBitrate(_guildId: string, _channelId: string): number | null;
+}
+//# sourceMappingURL=Connector.d.ts.map

package/dist/connector/Connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Connector.d.ts","sourceRoot":"","sources":["../../src/connector/Connector.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAErC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;;;;;;GASG;AACH,8BAAsB,SAAS;IAC7B,SAAS,CAAC,OAAO,EAAG,MAAM,CAAC;IAEpB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKjC,yFAAyF;aACzE,MAAM,IAAI,IAAI;IAE9B,8CAA8C;aAC9B,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAEpE;;;;OAIG;IACI,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS;IAIrD;;;;OAIG;IACI,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAG9E"}

package/dist/connector/Connector.js

@@ -0,0 +1,39 @@
+"use strict";
+/** Yukimu v2.0.0 — Base Connector */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Connector = void 0;
+/**
+ * Abstract base class for Discord library connectors.
+ *
+ * Connectors bridge Yukimu to a specific Discord library (discord.js, Eris, Oceanic)
+ * by forwarding voice gateway events and sending voice payloads.
+ *
+ * v2 additions:
+ * - getGuildBoostTier(): Get the boost level for bitrate optimization
+ * - getChannelBitrate(): Get the current voice channel bitrate
+ */
+class Connector {
+    manager;
+    set(manager) {
+        this.manager = manager;
+        return this;
+    }
+    /**
+     * Get the Discord server's boost tier.
+     * Override in subclass for boost-tier-aware bitrate optimization.
+     * @returns 0 | 1 | 2 | 3
+     */
+    getGuildBoostTier(_guildId) {
+        return 0;
+    }
+    /**
+     * Get the current bitrate of a voice channel in kbps.
+     * Override in subclass for accurate bitrate information.
+     * @returns Bitrate in kbps, or null if unavailable
+     */
+    getChannelBitrate(_guildId, _channelId) {
+        return null;
+    }
+}
+exports.Connector = Connector;
+//# sourceMappingURL=Connector.js.map

package/dist/connector/Connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Connector.js","sourceRoot":"","sources":["../../src/connector/Connector.ts"],"names":[],"mappings":";AAAA,qCAAqC;;;AAKrC;;;;;;;;;GASG;AACH,MAAsB,SAAS;IACnB,OAAO,CAAU;IAEpB,GAAG,CAAC,OAAe;QACxB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAQD;;;;OAIG;IACI,iBAAiB,CAAC,QAAgB;QACvC,OAAO,CAAC,CAAC;IACX,CAAC;IAED;;;;OAIG;IACI,iBAAiB,CAAC,QAAgB,EAAE,UAAkB;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AA/BD,8BA+BC"}

package/dist/connector/DiscordJS.d.ts

@@ -0,0 +1,27 @@
+/** Yukimu v2.0.0 — Discord.js Connector */
+import { Connector } from "./Connector";
+import type { BoostTier } from "../types";
+/**
+ * Connector for discord.js v14+.
+ *
+ * Improvements from v1:
+ * - Safe shard access (handles undefined guild/shard)
+ * - Boost tier detection for adaptive bitrate
+ * - Channel bitrate detection
+ */
+export declare class DiscordJS extends Connector {
+    private readonly client;
+    constructor(client: any);
+    listen(): void;
+    sendPayload(guildId: string, payload: unknown): void;
+    /**
+     * Get the Discord server boost tier (0–3).
+     * Uses discord.js Guild.premiumTier.
+     */
+    getGuildBoostTier(guildId: string): BoostTier;
+    /**
+     * Get the current bitrate of a voice channel in kbps.
+     */
+    getChannelBitrate(guildId: string, channelId: string): number | null;
+}
+//# sourceMappingURL=DiscordJS.d.ts.map

package/dist/connector/DiscordJS.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiscordJS.d.ts","sourceRoot":"","sources":["../../src/connector/DiscordJS.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAE3C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;;;;GAOG;AACH,qBAAa,SAAU,SAAQ,SAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAM;gBAEjB,MAAM,EAAE,GAAG;IAKhB,MAAM,IAAI,IAAI;IAWd,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAa3D;;;OAGG;IACa,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAO7D;;OAEG;IACa,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAQrF"}

package/dist/connector/DiscordJS.js

@@ -0,0 +1,69 @@
+"use strict";
+/** Yukimu v2.0.0 — Discord.js Connector */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiscordJS = void 0;
+const Connector_1 = require("./Connector");
+/**
+ * Connector for discord.js v14+.
+ *
+ * Improvements from v1:
+ * - Safe shard access (handles undefined guild/shard)
+ * - Boost tier detection for adaptive bitrate
+ * - Channel bitrate detection
+ */
+class DiscordJS extends Connector_1.Connector {
+    client; // discord.js Client
+    constructor(client) {
+        super();
+        this.client = client;
+    }
+    listen() {
+        this.client.on("raw", (packet) => {
+            if (packet.t === "VOICE_STATE_UPDATE") {
+                this.manager.handleVoiceStateUpdate(packet.d);
+            }
+            if (packet.t === "VOICE_SERVER_UPDATE") {
+                this.manager.handleVoiceServerUpdate(packet.d);
+            }
+        });
+    }
+    sendPayload(guildId, payload) {
+        const guild = this.client.guilds?.cache?.get(guildId);
+        if (!guild?.shard) {
+            this.manager.logger.warn(`Cannot send payload — guild ${guildId} not found or shard unavailable`);
+            return;
+        }
+        try {
+            guild.shard.send(payload);
+        }
+        catch (err) {
+            this.manager.logger.error(`Failed to send payload to guild ${guildId}:`, err);
+        }
+    }
+    /**
+     * Get the Discord server boost tier (0–3).
+     * Uses discord.js Guild.premiumTier.
+     */
+    getGuildBoostTier(guildId) {
+        const guild = this.client.guilds?.cache?.get(guildId);
+        if (!guild)
+            return 0;
+        const tier = guild.premiumTier ?? 0;
+        return (Math.min(Math.max(tier, 0), 3));
+    }
+    /**
+     * Get the current bitrate of a voice channel in kbps.
+     */
+    getChannelBitrate(guildId, channelId) {
+        const guild = this.client.guilds?.cache?.get(guildId);
+        if (!guild)
+            return null;
+        const channel = guild.channels?.cache?.get(channelId);
+        if (!channel || !channel.bitrate)
+            return null;
+        // discord.js returns bitrate in bps, convert to kbps
+        return Math.floor(channel.bitrate / 1000);
+    }
+}
+exports.DiscordJS = DiscordJS;
+//# sourceMappingURL=DiscordJS.js.map

package/dist/connector/DiscordJS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiscordJS.js","sourceRoot":"","sources":["../../src/connector/DiscordJS.ts"],"names":[],"mappings":";AAAA,2CAA2C;;;AAE3C,2CAAwC;AAGxC;;;;;;;GAOG;AACH,MAAa,SAAU,SAAQ,qBAAS;IACrB,MAAM,CAAM,CAAC,oBAAoB;IAElD,YAAY,MAAW;QACrB,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAEM,MAAM;QACX,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,MAAW,EAAE,EAAE;YACpC,IAAI,MAAM,CAAC,CAAC,KAAK,oBAAoB,EAAE,CAAC;gBACtC,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAChD,CAAC;YACD,IAAI,MAAM,CAAC,CAAC,KAAK,qBAAqB,EAAE,CAAC;gBACvC,IAAI,CAAC,OAAO,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACjD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,WAAW,CAAC,OAAe,EAAE,OAAgB;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,OAAO,iCAAiC,CAAC,CAAC;YAClG,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,OAAO,GAAG,EAAE,GAAG,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;IAED;;;OAGG;IACa,iBAAiB,CAAC,OAAe;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,CAAC;QACrB,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAc,CAAC;IACvD,CAAC;IAED;;OAEG;IACa,iBAAiB,CAAC,OAAe,EAAE,SAAiB;QAClE,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;QACtD,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC9C,qDAAqD;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC5C,CAAC;CACF;AAtDD,8BAsDC"}

package/dist/connector/Eris.d.ts

@@ -0,0 +1,19 @@
+/** Yukimu v2.0.0 — Eris Connector */
+import { Connector } from "./Connector";
+import type { BoostTier } from "../types";
+/**
+ * Connector for Eris.
+ *
+ * Improvements from v1:
+ * - Safe shard access
+ * - Boost tier detection
+ */
+export declare class Eris extends Connector {
+    private readonly client;
+    constructor(client: any);
+    listen(): void;
+    sendPayload(guildId: string, payload: unknown): void;
+    getGuildBoostTier(guildId: string): BoostTier;
+    getChannelBitrate(_guildId: string, channelId: string): number | null;
+}
+//# sourceMappingURL=Eris.d.ts.map

package/dist/connector/Eris.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Eris.d.ts","sourceRoot":"","sources":["../../src/connector/Eris.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAErC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;;;GAMG;AACH,qBAAa,IAAK,SAAQ,SAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAM;gBAEjB,MAAM,EAAE,GAAG;IAKhB,MAAM,IAAI,IAAI;IAWd,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAkB3C,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAO7C,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAKtF"}