yukimu 2.0.8 → 3.0.0

package/dist/connector/Eris.js

@@ -0,0 +1,62 @@
+"use strict";
+/** Yukimu v2.0.0 — Eris Connector */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Eris = void 0;
+const Connector_1 = require("./Connector");
+/**
+ * Connector for Eris.
+ *
+ * Improvements from v1:
+ * - Safe shard access
+ * - Boost tier detection
+ */
+class Eris extends Connector_1.Connector {
+    client; // Eris Client
+    constructor(client) {
+        super();
+        this.client = client;
+    }
+    listen() {
+        this.client.on("rawWS", (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?.get(guildId);
+        if (!guild) {
+            this.manager.logger.warn(`Cannot send payload — guild ${guildId} not found`);
+            return;
+        }
+        const shard = this.client.shards?.get(guild.shard?.id);
+        if (!shard) {
+            this.manager.logger.warn(`Cannot send payload — shard for guild ${guildId} not found`);
+            return;
+        }
+        try {
+            shard.sendWS(4, payload.d);
+        }
+        catch (err) {
+            this.manager.logger.error(`Failed to send payload to guild ${guildId}:`, err);
+        }
+    }
+    getGuildBoostTier(guildId) {
+        const guild = this.client.guilds?.get(guildId);
+        if (!guild)
+            return 0;
+        const tier = guild.premiumTier ?? 0;
+        return (Math.min(Math.max(tier, 0), 3));
+    }
+    getChannelBitrate(_guildId, channelId) {
+        const channel = this.client.getChannel?.(channelId);
+        if (!channel || !channel.bitrate)
+            return null;
+        return Math.floor(channel.bitrate / 1000);
+    }
+}
+exports.Eris = Eris;
+//# sourceMappingURL=Eris.js.map

package/dist/connector/Eris.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Eris.js","sourceRoot":"","sources":["../../src/connector/Eris.ts"],"names":[],"mappings":";AAAA,qCAAqC;;;AAErC,2CAAwC;AAGxC;;;;;;GAMG;AACH,MAAa,IAAK,SAAQ,qBAAS;IAChB,MAAM,CAAM,CAAC,cAAc;IAE5C,YAAY,MAAW;QACrB,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAEM,MAAM;QACX,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,MAAW,EAAE,EAAE;YACtC,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,GAAG,CAAC,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,OAAO,YAAY,CAAC,CAAC;YAC7E,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,yCAAyC,OAAO,YAAY,CAAC,CAAC;YACvF,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,KAAK,CAAC,MAAM,CAAC,CAAC,EAAG,OAAe,CAAC,CAAC,CAAC,CAAC;QACtC,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;IAEe,iBAAiB,CAAC,OAAe;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QAC/C,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;IAEe,iBAAiB,CAAC,QAAgB,EAAE,SAAiB;QACnE,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC5C,CAAC;CACF;AAjDD,oBAiDC"}

package/dist/connector/Oceanic.d.ts

@@ -0,0 +1,19 @@
+/** Yukimu v2.0.0 — Oceanic.js Connector */
+import { Connector } from "./Connector";
+import type { BoostTier } from "../types";
+/**
+ * Connector for Oceanic.js.
+ *
+ * Improvements from v1:
+ * - Safe guild/shard access
+ * - Boost tier detection
+ */
+export declare class Oceanic 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=Oceanic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Oceanic.d.ts","sourceRoot":"","sources":["../../src/connector/Oceanic.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAE3C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;;;GAMG;AACH,qBAAa,OAAQ,SAAQ,SAAS;IACpC,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;IAa3C,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAO7C,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAOrF"}

package/dist/connector/Oceanic.js

@@ -0,0 +1,60 @@
+"use strict";
+/** Yukimu v2.0.0 — Oceanic.js Connector */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Oceanic = void 0;
+const Connector_1 = require("./Connector");
+/**
+ * Connector for Oceanic.js.
+ *
+ * Improvements from v1:
+ * - Safe guild/shard access
+ * - Boost tier detection
+ */
+class Oceanic extends Connector_1.Connector {
+    client; // Oceanic Client
+    constructor(client) {
+        super();
+        this.client = client;
+    }
+    listen() {
+        this.client.on("packet", (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?.get(guildId);
+        if (!guild?.shard) {
+            this.manager.logger.warn(`Cannot send payload — guild ${guildId} or shard not found`);
+            return;
+        }
+        try {
+            guild.shard.send(payload);
+        }
+        catch (err) {
+            this.manager.logger.error(`Failed to send payload to guild ${guildId}:`, err);
+        }
+    }
+    getGuildBoostTier(guildId) {
+        const guild = this.client.guilds?.get(guildId);
+        if (!guild)
+            return 0;
+        const tier = guild.premiumTier ?? 0;
+        return (Math.min(Math.max(tier, 0), 3));
+    }
+    getChannelBitrate(guildId, channelId) {
+        const guild = this.client.guilds?.get(guildId);
+        if (!guild)
+            return null;
+        const channel = guild.channels?.get(channelId);
+        if (!channel || !channel.bitrate)
+            return null;
+        return Math.floor(channel.bitrate / 1000);
+    }
+}
+exports.Oceanic = Oceanic;
+//# sourceMappingURL=Oceanic.js.map

package/dist/connector/Oceanic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Oceanic.js","sourceRoot":"","sources":["../../src/connector/Oceanic.ts"],"names":[],"mappings":";AAAA,2CAA2C;;;AAE3C,2CAAwC;AAGxC;;;;;;GAMG;AACH,MAAa,OAAQ,SAAQ,qBAAS;IACnB,MAAM,CAAM,CAAC,iBAAiB;IAE/C,YAAY,MAAW;QACrB,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAEM,MAAM;QACX,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAW,EAAE,EAAE;YACvC,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,GAAG,CAAC,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,OAAO,qBAAqB,CAAC,CAAC;YACtF,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;IAEe,iBAAiB,CAAC,OAAe;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QAC/C,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;IAEe,iBAAiB,CAAC,OAAe,EAAE,SAAiB;QAClE,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC5C,CAAC;CACF;AA9CD,0BA8CC"}

package/dist/errors/YukimuError.d.ts

@@ -0,0 +1,51 @@
+/** Yukimu v2.0.0 — Error System with Error Codes */
+export declare enum ErrorCode {
+    UNKNOWN = "UNKNOWN",
+    INVALID_ARGUMENT = "INVALID_ARGUMENT",
+    NODE_NOT_FOUND = "NODE_NOT_FOUND",
+    NODE_ALREADY_EXISTS = "NODE_ALREADY_EXISTS",
+    NODE_DISCONNECTED = "NODE_DISCONNECTED",
+    NODE_MAX_RETRIES = "NODE_MAX_RETRIES",
+    NODE_CONNECTION_TIMEOUT = "NODE_CONNECTION_TIMEOUT",
+    PLAYER_NOT_FOUND = "PLAYER_NOT_FOUND",
+    PLAYER_ALREADY_EXISTS = "PLAYER_ALREADY_EXISTS",
+    PLAYER_NO_TRACK = "PLAYER_NO_TRACK",
+    PLAYER_NOT_SEEKABLE = "PLAYER_NOT_SEEKABLE",
+    PLAYER_INVALID_VOLUME = "PLAYER_INVALID_VOLUME",
+    PLAYER_INVALID_FILTER = "PLAYER_INVALID_FILTER",
+    VOICE_CONNECTION_TIMEOUT = "VOICE_CONNECTION_TIMEOUT",
+    VOICE_CONNECTION_FAILED = "VOICE_CONNECTION_FAILED",
+    REST_ERROR = "REST_ERROR",
+    REST_TIMEOUT = "REST_TIMEOUT",
+    REST_RATE_LIMITED = "REST_RATE_LIMITED",
+    RESOLVER_NO_NODE = "RESOLVER_NO_NODE",
+    RESOLVER_LOAD_FAILED = "RESOLVER_LOAD_FAILED",
+    RESOLVER_SPOTIFY_ERROR = "RESOLVER_SPOTIFY_ERROR",
+    PLUGIN_ALREADY_LOADED = "PLUGIN_ALREADY_LOADED",
+    PLUGIN_NOT_FOUND = "PLUGIN_NOT_FOUND"
+}
+export declare class YukimuError extends Error {
+    readonly code: ErrorCode;
+    constructor(message: string, code?: ErrorCode);
+}
+export declare class NodeError extends YukimuError {
+    constructor(message: string, code?: ErrorCode);
+}
+export declare class PlayerError extends YukimuError {
+    constructor(message: string, code?: ErrorCode);
+}
+export declare class RestError extends YukimuError {
+    readonly status: number;
+    readonly path: string;
+    readonly retryAfter?: number;
+    constructor(message: string, status: number, path: string, retryAfter?: number);
+}
+export declare class VoiceConnectionError extends YukimuError {
+    readonly guildId: string;
+    constructor(message: string, guildId: string, code?: ErrorCode);
+}
+export declare class ResolverError extends YukimuError {
+    readonly query: string;
+    constructor(message: string, query: string, code?: ErrorCode);
+}
+//# sourceMappingURL=YukimuError.d.ts.map

package/dist/errors/YukimuError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"YukimuError.d.ts","sourceRoot":"","sources":["../../src/errors/YukimuError.ts"],"names":[],"mappings":"AAAA,oDAAoD;AAIpD,oBAAY,SAAS;IAEnB,OAAO,YAAY;IACnB,gBAAgB,qBAAqB;IAGrC,cAAc,mBAAmB;IACjC,mBAAmB,wBAAwB;IAC3C,iBAAiB,sBAAsB;IACvC,gBAAgB,qBAAqB;IACrC,uBAAuB,4BAA4B;IAGnD,gBAAgB,qBAAqB;IACrC,qBAAqB,0BAA0B;IAC/C,eAAe,oBAAoB;IACnC,mBAAmB,wBAAwB;IAC3C,qBAAqB,0BAA0B;IAC/C,qBAAqB,0BAA0B;IAG/C,wBAAwB,6BAA6B;IACrD,uBAAuB,4BAA4B;IAGnD,UAAU,eAAe;IACzB,YAAY,iBAAiB;IAC7B,iBAAiB,sBAAsB;IAGvC,gBAAgB,qBAAqB;IACrC,oBAAoB,yBAAyB;IAC7C,sBAAsB,2BAA2B;IAGjD,qBAAqB,0BAA0B;IAC/C,gBAAgB,qBAAqB;CACtC;AAID,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAgB,IAAI,EAAE,SAAS,CAAC;gBAEpB,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,SAA6B;CASjE;AAID,qBAAa,SAAU,SAAQ,WAAW;gBAC5B,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,SAAuC;CAI3E;AAID,qBAAa,WAAY,SAAQ,WAAW;gBAC9B,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,SAAqC;CAIzE;AAID,qBAAa,SAAU,SAAQ,WAAW;IACxC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAY/E;AAID,qBAAa,oBAAqB,SAAQ,WAAW;IACnD,SAAgB,OAAO,EAAE,MAAM,CAAC;gBAEpB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,SAA6C;CAKlG;AAID,qBAAa,aAAc,SAAQ,WAAW;IAC5C,SAAgB,KAAK,EAAE,MAAM,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,SAA0C;CAK7F"}

package/dist/errors/YukimuError.js

@@ -0,0 +1,105 @@
+"use strict";
+/** Yukimu v2.0.0 — Error System with Error Codes */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResolverError = exports.VoiceConnectionError = exports.RestError = exports.PlayerError = exports.NodeError = exports.YukimuError = exports.ErrorCode = void 0;
+// ─── Error Codes ────────────────────────────────────────────────────────────
+var ErrorCode;
+(function (ErrorCode) {
+    // General
+    ErrorCode["UNKNOWN"] = "UNKNOWN";
+    ErrorCode["INVALID_ARGUMENT"] = "INVALID_ARGUMENT";
+    // Node errors
+    ErrorCode["NODE_NOT_FOUND"] = "NODE_NOT_FOUND";
+    ErrorCode["NODE_ALREADY_EXISTS"] = "NODE_ALREADY_EXISTS";
+    ErrorCode["NODE_DISCONNECTED"] = "NODE_DISCONNECTED";
+    ErrorCode["NODE_MAX_RETRIES"] = "NODE_MAX_RETRIES";
+    ErrorCode["NODE_CONNECTION_TIMEOUT"] = "NODE_CONNECTION_TIMEOUT";
+    // Player errors
+    ErrorCode["PLAYER_NOT_FOUND"] = "PLAYER_NOT_FOUND";
+    ErrorCode["PLAYER_ALREADY_EXISTS"] = "PLAYER_ALREADY_EXISTS";
+    ErrorCode["PLAYER_NO_TRACK"] = "PLAYER_NO_TRACK";
+    ErrorCode["PLAYER_NOT_SEEKABLE"] = "PLAYER_NOT_SEEKABLE";
+    ErrorCode["PLAYER_INVALID_VOLUME"] = "PLAYER_INVALID_VOLUME";
+    ErrorCode["PLAYER_INVALID_FILTER"] = "PLAYER_INVALID_FILTER";
+    // Voice errors
+    ErrorCode["VOICE_CONNECTION_TIMEOUT"] = "VOICE_CONNECTION_TIMEOUT";
+    ErrorCode["VOICE_CONNECTION_FAILED"] = "VOICE_CONNECTION_FAILED";
+    // REST errors
+    ErrorCode["REST_ERROR"] = "REST_ERROR";
+    ErrorCode["REST_TIMEOUT"] = "REST_TIMEOUT";
+    ErrorCode["REST_RATE_LIMITED"] = "REST_RATE_LIMITED";
+    // Resolver errors
+    ErrorCode["RESOLVER_NO_NODE"] = "RESOLVER_NO_NODE";
+    ErrorCode["RESOLVER_LOAD_FAILED"] = "RESOLVER_LOAD_FAILED";
+    ErrorCode["RESOLVER_SPOTIFY_ERROR"] = "RESOLVER_SPOTIFY_ERROR";
+    // Plugin errors
+    ErrorCode["PLUGIN_ALREADY_LOADED"] = "PLUGIN_ALREADY_LOADED";
+    ErrorCode["PLUGIN_NOT_FOUND"] = "PLUGIN_NOT_FOUND";
+})(ErrorCode || (exports.ErrorCode = ErrorCode = {}));
+// ─── Base Error ─────────────────────────────────────────────────────────────
+class YukimuError extends Error {
+    code;
+    constructor(message, code = ErrorCode.UNKNOWN) {
+        super(message);
+        this.name = "YukimuError";
+        this.code = code;
+        // Maintain proper stack trace in V8
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}
+exports.YukimuError = YukimuError;
+// ─── Node Error ─────────────────────────────────────────────────────────────
+class NodeError extends YukimuError {
+    constructor(message, code = ErrorCode.NODE_DISCONNECTED) {
+        super(message, code);
+        this.name = "NodeError";
+    }
+}
+exports.NodeError = NodeError;
+// ─── Player Error ───────────────────────────────────────────────────────────
+class PlayerError extends YukimuError {
+    constructor(message, code = ErrorCode.PLAYER_NO_TRACK) {
+        super(message, code);
+        this.name = "PlayerError";
+    }
+}
+exports.PlayerError = PlayerError;
+// ─── REST Error ─────────────────────────────────────────────────────────────
+class RestError extends YukimuError {
+    status;
+    path;
+    retryAfter;
+    constructor(message, status, path, retryAfter) {
+        super(message, status === 408 ? ErrorCode.REST_TIMEOUT
+            : status === 429 ? ErrorCode.REST_RATE_LIMITED
+                : ErrorCode.REST_ERROR);
+        this.name = "RestError";
+        this.status = status;
+        this.path = path;
+        this.retryAfter = retryAfter;
+    }
+}
+exports.RestError = RestError;
+// ─── Voice Connection Error ─────────────────────────────────────────────────
+class VoiceConnectionError extends YukimuError {
+    guildId;
+    constructor(message, guildId, code = ErrorCode.VOICE_CONNECTION_FAILED) {
+        super(message, code);
+        this.name = "VoiceConnectionError";
+        this.guildId = guildId;
+    }
+}
+exports.VoiceConnectionError = VoiceConnectionError;
+// ─── Resolver Error ─────────────────────────────────────────────────────────
+class ResolverError extends YukimuError {
+    query;
+    constructor(message, query, code = ErrorCode.RESOLVER_LOAD_FAILED) {
+        super(message, code);
+        this.name = "ResolverError";
+        this.query = query;
+    }
+}
+exports.ResolverError = ResolverError;
+//# sourceMappingURL=YukimuError.js.map

package/dist/errors/YukimuError.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+/** Yukimu v2.0.0 — Public API Exports */
+export { Yukimu } from "./Yukimu";
+export { Node } from "./Node";
+export { Player } from "./Player";
+export { Queue } from "./Queue";
+export { Rest } from "./Rest";
+export { Resolver } from "./Resolver";
+export { ConnectionPool, VoiceConnectionState } from "./ConnectionPool";
+export type { VoiceConnection } from "./ConnectionPool";
+export { TrackCache } from "./TrackCache";
+export { WsQueue } from "./WsQueue";
+export { Plugin } from "./Plugin";
+export { Logger } from "./Logger";
+export { BitrateOptimizer } from "./BitrateOptimizer";
+export { Connector } from "./connector/Connector";
+export { DiscordJS } from "./connector/DiscordJS";
+export { Eris } from "./connector/Eris";
+export { Oceanic } from "./connector/Oceanic";
+export { PlayerMoved } from "./plugins/PlayerMoved";
+export type { PlayerMovedOptions } from "./plugins/PlayerMoved";
+export { AutoResume } from "./plugins/AutoResume";
+export { AutoplayPlugin } from "./plugins/AutoplayPlugin";
+export type { AutoplayStrategy, AutoplayOptions } from "./plugins/AutoplayPlugin";
+export { InactivityPlugin } from "./plugins/InactivityPlugin";
+export type { InactivityOptions } from "./plugins/InactivityPlugin";
+export { YukimuError, NodeError, PlayerError, RestError, VoiceConnectionError, ResolverError, ErrorCode, } from "./errors/YukimuError";
+export { VERSION, CLIENT_NAME, State, PlayerState, SOURCE_PREFIXES, URL_PATTERNS, STOPPED_REASONS, WS_CLOSE_CODES, BITRATE_BY_BOOST_TIER, DEFAULTS, } from "./Constants";
+export type { YukimuOptions, NodeOptions, NodeStats, NodeInfo, PlayerOptions, SpotifyOptions, SearchSource, Track, TrackInfo, SearchResult, LoadType, PlaylistInfo, LavalinkException, VoiceState, FilterOptions, EqualizerBand, KaraokeSettings, TimescaleSettings, TremoloSettings, VibratoSettings, RotationSettings, DistortionSettings, ChannelMixSettings, LowPassSettings, BoostTier, BitrateConfig, LogLevel, YukimuLogger, LoopMode, YukimuEvents, RetryOptions, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AAGzC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAG9C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,YAAY,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,OAAO,EACL,WAAW,EACX,SAAS,EACT,WAAW,EACX,SAAS,EACT,oBAAoB,EACpB,aAAa,EACb,SAAS,GACV,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,OAAO,EACP,WAAW,EACX,KAAK,EACL,WAAW,EACX,eAAe,EACf,YAAY,EACZ,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,QAAQ,GACT,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,aAAa,EACb,WAAW,EACX,SAAS,EACT,QAAQ,EACR,aAAa,EACb,cAAc,EACd,YAAY,EACZ,KAAK,EACL,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,SAAS,EACT,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,YAAY,GACb,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,70 @@
+"use strict";
+/** Yukimu v2.0.0 — Public API Exports */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULTS = exports.BITRATE_BY_BOOST_TIER = exports.WS_CLOSE_CODES = exports.STOPPED_REASONS = exports.URL_PATTERNS = exports.SOURCE_PREFIXES = exports.PlayerState = exports.State = exports.CLIENT_NAME = exports.VERSION = exports.ErrorCode = exports.ResolverError = exports.VoiceConnectionError = exports.RestError = exports.PlayerError = exports.NodeError = exports.YukimuError = exports.InactivityPlugin = exports.AutoplayPlugin = exports.AutoResume = exports.PlayerMoved = exports.Oceanic = exports.Eris = exports.DiscordJS = exports.Connector = exports.BitrateOptimizer = exports.Logger = exports.Plugin = exports.WsQueue = exports.TrackCache = exports.VoiceConnectionState = exports.ConnectionPool = exports.Resolver = exports.Rest = exports.Queue = exports.Player = exports.Node = exports.Yukimu = void 0;
+// ─── Core Classes ────────────────────────────────────────────────────────────
+var Yukimu_1 = require("./Yukimu");
+Object.defineProperty(exports, "Yukimu", { enumerable: true, get: function () { return Yukimu_1.Yukimu; } });
+var Node_1 = require("./Node");
+Object.defineProperty(exports, "Node", { enumerable: true, get: function () { return Node_1.Node; } });
+var Player_1 = require("./Player");
+Object.defineProperty(exports, "Player", { enumerable: true, get: function () { return Player_1.Player; } });
+var Queue_1 = require("./Queue");
+Object.defineProperty(exports, "Queue", { enumerable: true, get: function () { return Queue_1.Queue; } });
+var Rest_1 = require("./Rest");
+Object.defineProperty(exports, "Rest", { enumerable: true, get: function () { return Rest_1.Rest; } });
+var Resolver_1 = require("./Resolver");
+Object.defineProperty(exports, "Resolver", { enumerable: true, get: function () { return Resolver_1.Resolver; } });
+var ConnectionPool_1 = require("./ConnectionPool");
+Object.defineProperty(exports, "ConnectionPool", { enumerable: true, get: function () { return ConnectionPool_1.ConnectionPool; } });
+Object.defineProperty(exports, "VoiceConnectionState", { enumerable: true, get: function () { return ConnectionPool_1.VoiceConnectionState; } });
+var TrackCache_1 = require("./TrackCache");
+Object.defineProperty(exports, "TrackCache", { enumerable: true, get: function () { return TrackCache_1.TrackCache; } });
+var WsQueue_1 = require("./WsQueue");
+Object.defineProperty(exports, "WsQueue", { enumerable: true, get: function () { return WsQueue_1.WsQueue; } });
+var Plugin_1 = require("./Plugin");
+Object.defineProperty(exports, "Plugin", { enumerable: true, get: function () { return Plugin_1.Plugin; } });
+var Logger_1 = require("./Logger");
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return Logger_1.Logger; } });
+var BitrateOptimizer_1 = require("./BitrateOptimizer");
+Object.defineProperty(exports, "BitrateOptimizer", { enumerable: true, get: function () { return BitrateOptimizer_1.BitrateOptimizer; } });
+// ─── Connectors ──────────────────────────────────────────────────────────────
+var Connector_1 = require("./connector/Connector");
+Object.defineProperty(exports, "Connector", { enumerable: true, get: function () { return Connector_1.Connector; } });
+var DiscordJS_1 = require("./connector/DiscordJS");
+Object.defineProperty(exports, "DiscordJS", { enumerable: true, get: function () { return DiscordJS_1.DiscordJS; } });
+var Eris_1 = require("./connector/Eris");
+Object.defineProperty(exports, "Eris", { enumerable: true, get: function () { return Eris_1.Eris; } });
+var Oceanic_1 = require("./connector/Oceanic");
+Object.defineProperty(exports, "Oceanic", { enumerable: true, get: function () { return Oceanic_1.Oceanic; } });
+// ─── Plugins ─────────────────────────────────────────────────────────────────
+var PlayerMoved_1 = require("./plugins/PlayerMoved");
+Object.defineProperty(exports, "PlayerMoved", { enumerable: true, get: function () { return PlayerMoved_1.PlayerMoved; } });
+var AutoResume_1 = require("./plugins/AutoResume");
+Object.defineProperty(exports, "AutoResume", { enumerable: true, get: function () { return AutoResume_1.AutoResume; } });
+var AutoplayPlugin_1 = require("./plugins/AutoplayPlugin");
+Object.defineProperty(exports, "AutoplayPlugin", { enumerable: true, get: function () { return AutoplayPlugin_1.AutoplayPlugin; } });
+var InactivityPlugin_1 = require("./plugins/InactivityPlugin");
+Object.defineProperty(exports, "InactivityPlugin", { enumerable: true, get: function () { return InactivityPlugin_1.InactivityPlugin; } });
+// ─── Errors ──────────────────────────────────────────────────────────────────
+var YukimuError_1 = require("./errors/YukimuError");
+Object.defineProperty(exports, "YukimuError", { enumerable: true, get: function () { return YukimuError_1.YukimuError; } });
+Object.defineProperty(exports, "NodeError", { enumerable: true, get: function () { return YukimuError_1.NodeError; } });
+Object.defineProperty(exports, "PlayerError", { enumerable: true, get: function () { return YukimuError_1.PlayerError; } });
+Object.defineProperty(exports, "RestError", { enumerable: true, get: function () { return YukimuError_1.RestError; } });
+Object.defineProperty(exports, "VoiceConnectionError", { enumerable: true, get: function () { return YukimuError_1.VoiceConnectionError; } });
+Object.defineProperty(exports, "ResolverError", { enumerable: true, get: function () { return YukimuError_1.ResolverError; } });
+Object.defineProperty(exports, "ErrorCode", { enumerable: true, get: function () { return YukimuError_1.ErrorCode; } });
+// ─── Constants ───────────────────────────────────────────────────────────────
+var Constants_1 = require("./Constants");
+Object.defineProperty(exports, "VERSION", { enumerable: true, get: function () { return Constants_1.VERSION; } });
+Object.defineProperty(exports, "CLIENT_NAME", { enumerable: true, get: function () { return Constants_1.CLIENT_NAME; } });
+Object.defineProperty(exports, "State", { enumerable: true, get: function () { return Constants_1.State; } });
+Object.defineProperty(exports, "PlayerState", { enumerable: true, get: function () { return Constants_1.PlayerState; } });
+Object.defineProperty(exports, "SOURCE_PREFIXES", { enumerable: true, get: function () { return Constants_1.SOURCE_PREFIXES; } });
+Object.defineProperty(exports, "URL_PATTERNS", { enumerable: true, get: function () { return Constants_1.URL_PATTERNS; } });
+Object.defineProperty(exports, "STOPPED_REASONS", { enumerable: true, get: function () { return Constants_1.STOPPED_REASONS; } });
+Object.defineProperty(exports, "WS_CLOSE_CODES", { enumerable: true, get: function () { return Constants_1.WS_CLOSE_CODES; } });
+Object.defineProperty(exports, "BITRATE_BY_BOOST_TIER", { enumerable: true, get: function () { return Constants_1.BITRATE_BY_BOOST_TIER; } });
+Object.defineProperty(exports, "DEFAULTS", { enumerable: true, get: function () { return Constants_1.DEFAULTS; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,yCAAyC;;;AAEzC,gFAAgF;AAChF,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AACf,+BAA8B;AAArB,4FAAA,IAAI,OAAA;AACb,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AACf,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AACd,+BAA8B;AAArB,4FAAA,IAAI,OAAA;AACb,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AACjB,mDAAwE;AAA/D,gHAAA,cAAc,OAAA;AAAE,sHAAA,oBAAoB,OAAA;AAE7C,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AACf,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AACf,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AAEzB,gFAAgF;AAChF,mDAAkD;AAAzC,sGAAA,SAAS,OAAA;AAClB,mDAAkD;AAAzC,sGAAA,SAAS,OAAA;AAClB,yCAAwC;AAA/B,4FAAA,IAAI,OAAA;AACb,+CAA8C;AAArC,kGAAA,OAAO,OAAA;AAEhB,gFAAgF;AAChF,qDAAoD;AAA3C,0GAAA,WAAW,OAAA;AAEpB,mDAAkD;AAAzC,wGAAA,UAAU,OAAA;AACnB,2DAA0D;AAAjD,gHAAA,cAAc,OAAA;AAEvB,+DAA8D;AAArD,oHAAA,gBAAgB,OAAA;AAGzB,gFAAgF;AAChF,oDAQ8B;AAP5B,0GAAA,WAAW,OAAA;AACX,wGAAA,SAAS,OAAA;AACT,0GAAA,WAAW,OAAA;AACX,wGAAA,SAAS,OAAA;AACT,mHAAA,oBAAoB,OAAA;AACpB,4GAAA,aAAa,OAAA;AACb,wGAAA,SAAS,OAAA;AAGX,gFAAgF;AAChF,yCAWqB;AAVnB,oGAAA,OAAO,OAAA;AACP,wGAAA,WAAW,OAAA;AACX,kGAAA,KAAK,OAAA;AACL,wGAAA,WAAW,OAAA;AACX,4GAAA,eAAe,OAAA;AACf,yGAAA,YAAY,OAAA;AACZ,4GAAA,eAAe,OAAA;AACf,2GAAA,cAAc,OAAA;AACd,kHAAA,qBAAqB,OAAA;AACrB,qGAAA,QAAQ,OAAA"}

package/dist/plugins/AutoResume.d.ts

@@ -0,0 +1,25 @@
+/** Yukimu v2.0.0 — AutoResume Plugin */
+import { Plugin } from "../Plugin";
+import type { Yukimu } from "../Yukimu";
+/**
+ * Automatically resumes playback after a Lavalink node reconnects.
+ *
+ * Improvements from v1:
+ * - Saves full queue state, not just current track
+ * - Saves filter state
+ * - Max snapshot limit to prevent memory growth
+ * - Periodic cleanup of stale snapshots
+ * - Proper unload() to clean up listeners
+ * - Error handling on resume
+ */
+export declare class AutoResume extends Plugin {
+    readonly name = "AutoResume";
+    private states;
+    private cleanupInterval?;
+    private boundListeners;
+    load(manager: Yukimu): void;
+    unload(manager: Yukimu): void;
+    private saveSnapshot;
+    private updatePosition;
+}
+//# sourceMappingURL=AutoResume.d.ts.map

package/dist/plugins/AutoResume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoResume.d.ts","sourceRoot":"","sources":["../../src/plugins/AutoResume.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAqBxC;;;;;;;;;;GAUG;AACH,qBAAa,UAAW,SAAQ,MAAM;IACpC,SAAgB,IAAI,gBAAgB;IACpC,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,eAAe,CAAC,CAAiC;IACzD,OAAO,CAAC,cAAc,CAAoD;IAEnE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IA2E3B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAcpC,OAAO,CAAC,YAAY;IAqBpB,OAAO,CAAC,cAAc;CAOvB"}

package/dist/plugins/AutoResume.js

@@ -0,0 +1,132 @@
+"use strict";
+/** Yukimu v2.0.0 — AutoResume Plugin */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutoResume = void 0;
+const Plugin_1 = require("../Plugin");
+const MAX_SNAPSHOTS = 500;
+const SNAPSHOT_STALE_MS = 3_600_000; // 1 hour
+/**
+ * Automatically resumes playback after a Lavalink node reconnects.
+ *
+ * Improvements from v1:
+ * - Saves full queue state, not just current track
+ * - Saves filter state
+ * - Max snapshot limit to prevent memory growth
+ * - Periodic cleanup of stale snapshots
+ * - Proper unload() to clean up listeners
+ * - Error handling on resume
+ */
+class AutoResume extends Plugin_1.Plugin {
+    name = "AutoResume";
+    states = new Map();
+    cleanupInterval;
+    boundListeners = new Map();
+    load(manager) {
+        const onTrackStart = (player, _track) => {
+            if (!player.queue.current)
+                return;
+            this.saveSnapshot(player);
+        };
+        const onNodeReady = async (node) => {
+            if (!node.resumed)
+                return;
+            manager.logger.info(`[AutoResume] Node "${node.options.name}" resumed, restoring players...`);
+            for (const [guildId, state] of this.states) {
+                const player = manager.players.get(guildId);
+                if (!player || player.node !== node || !state.trackEncoded)
+                    continue;
+                try {
+                    const result = await node.rest.decodeTrack(state.trackEncoded);
+                    if (result) {
+                        await player.play(result, { startTime: state.position });
+                        // Restore queue
+                        if (state.queueTracks.length > 0) {
+                            const decoded = await node.rest.decodeTracks(state.queueTracks).catch(() => []);
+                            if (decoded.length > 0)
+                                player.queue.add(decoded);
+                        }
+                        // Restore volume and filters
+                        if (state.volume !== 100)
+                            await player.setVolume(state.volume).catch(() => { });
+                        if (Object.keys(state.filters).length > 0) {
+                            await player.setFilters(state.filters).catch(() => { });
+                        }
+                        manager.logger.info(`[AutoResume] Restored player for guild ${guildId}`);
+                    }
+                }
+                catch (err) {
+                    manager.logger.warn(`[AutoResume] Failed to restore player for guild ${guildId}: ${err}`);
+                }
+            }
+        };
+        const onPlayerDestroy = (player) => {
+            this.states.delete(player.guildId);
+        };
+        const onPlayerUpdate = (player) => {
+            if (player.playing && player.queue.current) {
+                this.updatePosition(player.guildId, player.position);
+            }
+        };
+        // Store references for cleanup
+        this.boundListeners.set("trackStart", onTrackStart);
+        this.boundListeners.set("nodeReady", onNodeReady);
+        this.boundListeners.set("playerDestroy", onPlayerDestroy);
+        this.boundListeners.set("playerUpdate", onPlayerUpdate);
+        manager.on("trackStart", onTrackStart);
+        manager.on("nodeReady", onNodeReady);
+        manager.on("playerDestroy", onPlayerDestroy);
+        manager.on("playerUpdate", onPlayerUpdate);
+        // Periodic cleanup of stale snapshots
+        this.cleanupInterval = setInterval(() => {
+            const now = Date.now();
+            for (const [guildId, state] of this.states) {
+                if (now - state.updatedAt > SNAPSHOT_STALE_MS) {
+                    this.states.delete(guildId);
+                }
+            }
+        }, 300_000); // Every 5 minutes
+        if (this.cleanupInterval.unref) {
+            this.cleanupInterval.unref();
+        }
+    }
+    unload(manager) {
+        for (const [event, listener] of this.boundListeners) {
+            manager.off(event, listener);
+        }
+        this.boundListeners.clear();
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = undefined;
+        }
+        this.states.clear();
+    }
+    saveSnapshot(player) {
+        // Enforce max snapshots
+        if (this.states.size >= MAX_SNAPSHOTS && !this.states.has(player.guildId)) {
+            const oldest = this.states.keys().next().value;
+            if (oldest)
+                this.states.delete(oldest);
+        }
+        this.states.set(player.guildId, {
+            guildId: player.guildId,
+            voiceChannelId: player.voiceChannelId,
+            textChannelId: player.textChannelId,
+            volume: player.volume,
+            loop: player.loop,
+            position: player.position,
+            trackEncoded: player.queue.current.encoded,
+            queueTracks: player.queue.list.map((t) => t.encoded),
+            filters: { ...player.filters },
+            updatedAt: Date.now(),
+        });
+    }
+    updatePosition(guildId, position) {
+        const state = this.states.get(guildId);
+        if (state) {
+            state.position = position;
+            state.updatedAt = Date.now();
+        }
+    }
+}
+exports.AutoResume = AutoResume;
+//# sourceMappingURL=AutoResume.js.map

package/dist/plugins/AutoResume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoResume.js","sourceRoot":"","sources":["../../src/plugins/AutoResume.ts"],"names":[],"mappings":";AAAA,wCAAwC;;;AAExC,sCAAmC;AAmBnC,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,iBAAiB,GAAG,SAAS,CAAC,CAAC,SAAS;AAE9C;;;;;;;;;;GAUG;AACH,MAAa,UAAW,SAAQ,eAAM;IACpB,IAAI,GAAG,YAAY,CAAC;IAC5B,MAAM,GAAgC,IAAI,GAAG,EAAE,CAAC;IAChD,eAAe,CAAkC;IACjD,cAAc,GAA0C,IAAI,GAAG,EAAE,CAAC;IAEnE,IAAI,CAAC,OAAe;QACzB,MAAM,YAAY,GAAG,CAAC,MAAc,EAAE,MAAa,EAAE,EAAE;YACrD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO;gBAAE,OAAO;YAClC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC,CAAC;QAEF,MAAM,WAAW,GAAG,KAAK,EAAE,IAAU,EAAE,EAAE;YACvC,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,OAAO;YAC1B,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,IAAI,CAAC,OAAO,CAAC,IAAI,iCAAiC,CAAC,CAAC;YAE9F,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC5C,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY;oBAAE,SAAS;gBAErE,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;oBAC/D,IAAI,MAAM,EAAE,CAAC;wBACX,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;wBAEzD,gBAAgB;wBAChB,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BACjC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;4BAChF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;gCAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;wBACpD,CAAC;wBAED,6BAA6B;wBAC7B,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG;4BAAE,MAAM,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;wBAC/E,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BAC1C,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;wBACzD,CAAC;wBAED,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,0CAA0C,OAAO,EAAE,CAAC,CAAC;oBAC3E,CAAC;gBACH,CAAC;gBAAC,OAAO,GAAY,EAAE,CAAC;oBACtB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,mDAAmD,OAAO,KAAK,GAAG,EAAE,CAAC,CAAC;gBAC5F,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,eAAe,GAAG,CAAC,MAAc,EAAE,EAAE;YACzC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC,CAAC;QAEF,MAAM,cAAc,GAAG,CAAC,MAAc,EAAE,EAAE;YACxC,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBAC3C,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;YACvD,CAAC;QACH,CAAC,CAAC;QAEF,+BAA+B;QAC/B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QACpD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAClD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;QAC1D,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;QAExD,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QACvC,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACrC,OAAO,CAAC,EAAE,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;QAC7C,OAAO,CAAC,EAAE,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;QAE3C,sCAAsC;QACtC,IAAI,CAAC,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE;YACtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC3C,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,iBAAiB,EAAE,CAAC;oBAC9C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;QACH,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,kBAAkB;QAE/B,IAAI,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC;IAEM,MAAM,CAAC,OAAe;QAC3B,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACpD,OAAO,CAAC,GAAG,CAAC,KAAY,EAAE,QAAe,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAE5B,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACpC,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QACnC,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAEO,YAAY,CAAC,MAAc;QACjC,wBAAwB;QACxB,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,aAAa,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC/C,IAAI,MAAM;gBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE;YAC9B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,OAAQ,CAAC,OAAO;YAC3C,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACpD,OAAO,EAAE,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE;YAC9B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAEO,cAAc,CAAC,OAAe,EAAE,QAAgB;QACtD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;YAC1B,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC;CACF;AA3HD,gCA2HC"}