@stella_project/stellalib 1.0.0

package/dist/Structures/Queue.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StellaQueue = void 0;
+const Utils_1 = require("./Utils");
+/**
+ * The player's queue. The `current` property is the currently playing track,
+ * think of the rest as the upcoming tracks.
+ */
+class StellaQueue extends Array {
+    /** The total duration of the queue including the current track. */
+    get duration() {
+        const current = this.current?.duration ?? 0;
+        return this.reduce((acc, cur) => acc + (cur.duration || 0), current);
+    }
+    /** The total size of tracks in the queue including the current track. */
+    get totalSize() {
+        return this.length + (this.current ? 1 : 0);
+    }
+    /** The size of tracks in the queue (excluding current). */
+    get size() {
+        return this.length;
+    }
+    /** The current track. */
+    current = null;
+    /** The previous track. */
+    previous = null;
+    /**
+     * Adds a track to the queue.
+     * @param track The track or array of tracks to add.
+     * @param offset Optional position to insert at.
+     */
+    add(track, offset) {
+        if (!Utils_1.TrackUtils.validate(track))
+            throw new RangeError('Track must be a "Track" or "Track[]".');
+        if (!this.current) {
+            if (Array.isArray(track)) {
+                this.current = track.shift() || null;
+                this.push(...track);
+            }
+            else {
+                this.current = track;
+            }
+        }
+        else {
+            if (typeof offset !== "undefined" && typeof offset === "number") {
+                if (isNaN(offset))
+                    throw new RangeError("Offset must be a number.");
+                if (offset < 0 || offset > this.length)
+                    throw new RangeError(`Offset must be between 0 and ${this.length}.`);
+                if (Array.isArray(track)) {
+                    this.splice(offset, 0, ...track);
+                }
+                else {
+                    this.splice(offset, 0, track);
+                }
+            }
+            else {
+                if (Array.isArray(track)) {
+                    this.push(...track);
+                }
+                else {
+                    this.push(track);
+                }
+            }
+        }
+    }
+    remove(startOrPosition = 0, end) {
+        if (typeof end !== "undefined") {
+            if (isNaN(Number(startOrPosition)) || isNaN(Number(end)))
+                throw new RangeError('Missing "start" or "end" parameter.');
+            if (startOrPosition >= end || startOrPosition >= this.length)
+                throw new RangeError("Invalid start or end values.");
+            return this.splice(startOrPosition, end - startOrPosition);
+        }
+        return this.splice(startOrPosition, 1);
+    }
+    /** Clears the queue. */
+    clear() {
+        this.splice(0);
+    }
+    /** Shuffles the queue using the Fisher-Yates algorithm. */
+    shuffle() {
+        for (let i = this.length - 1; i > 0; i--) {
+            const j = Math.floor(Math.random() * (i + 1));
+            [this[i], this[j]] = [this[j], this[i]];
+        }
+    }
+    /**
+     * Shuffles the queue but distributes tracks evenly by requester,
+     * so no single user dominates the upcoming tracks.
+     */
+    equalizedShuffle() {
+        const userTracks = new Map();
+        this.forEach((track) => {
+            const user = track.requester;
+            if (!userTracks.has(user))
+                userTracks.set(user, []);
+            userTracks.get(user).push(track);
+        });
+        const shuffledQueue = [];
+        const totalLength = this.length;
+        while (shuffledQueue.length < totalLength) {
+            userTracks.forEach((tracks) => {
+                const track = tracks.shift();
+                if (track)
+                    shuffledQueue.push(track);
+            });
+        }
+        this.clear();
+        this.add(shuffledQueue);
+    }
+}
+exports.StellaQueue = StellaQueue;
+//# sourceMappingURL=Queue.js.map

package/dist/Structures/Queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue.js","sourceRoot":"","sources":["../../src/Structures/Queue.ts"],"names":[],"mappings":";;;AAOA,mCAAqC;AAErC;;;GAGG;AACH,MAAa,WAAY,SAAQ,KAA8B;IAC9D,mEAAmE;IACnE,IAAW,QAAQ;QAClB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,IAAI,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAED,yEAAyE;IACzE,IAAW,SAAS;QACnB,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,2DAA2D;IAC3D,IAAW,IAAI;QACd,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAED,yBAAyB;IAClB,OAAO,GAAmC,IAAI,CAAC;IAEtD,0BAA0B;IACnB,QAAQ,GAAmC,IAAI,CAAC;IAEvD;;;;OAIG;IACI,GAAG,CACT,KAA8D,EAC9D,MAAe;QAEf,IAAI,CAAC,kBAAU,CAAC,QAAQ,CAAC,KAAK,CAAC;YAC9B,MAAM,IAAI,UAAU,CAAC,uCAAuC,CAAC,CAAC;QAE/D,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACnB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC;gBACrC,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACP,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;YACtB,CAAC;QACF,CAAC;aAAM,CAAC;YACP,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACjE,IAAI,KAAK,CAAC,MAAM,CAAC;oBAChB,MAAM,IAAI,UAAU,CAAC,0BAA0B,CAAC,CAAC;gBAClD,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM;oBACrC,MAAM,IAAI,UAAU,CAAC,gCAAgC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;gBAEtE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC1B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC;gBAClC,CAAC;qBAAM,CAAC;oBACP,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;gBAC/B,CAAC;YACF,CAAC;iBAAM,CAAC;gBACP,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC1B,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;gBACrB,CAAC;qBAAM,CAAC;oBACP,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAClB,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IAaM,MAAM,CAAC,eAAe,GAAG,CAAC,EAAE,GAAY;QAC9C,IAAI,OAAO,GAAG,KAAK,WAAW,EAAE,CAAC;YAChC,IAAI,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACvD,MAAM,IAAI,UAAU,CAAC,qCAAqC,CAAC,CAAC;YAC7D,IAAI,eAAe,IAAI,GAAG,IAAI,eAAe,IAAI,IAAI,CAAC,MAAM;gBAC3D,MAAM,IAAI,UAAU,CAAC,8BAA8B,CAAC,CAAC;YACtD,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,GAAG,GAAG,eAAe,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,wBAAwB;IACjB,KAAK;QACX,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAChB,CAAC;IAED,2DAA2D;IACpD,OAAO;QACb,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC9C,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC;IACF,CAAC;IAED;;;OAGG;IACI,gBAAgB;QACtB,MAAM,UAAU,GAAG,IAAI,GAAG,EAA6D,CAAC;QACxF,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACtB,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC;YAC7B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACpD,UAAU,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,MAAM,aAAa,GAAmC,EAAE,CAAC;QACzD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC;QAChC,OAAO,aAAa,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;YAC3C,UAAU,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;gBAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;gBAC7B,IAAI,KAAK;oBAAE,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACzB,CAAC;CACD;AA3HD,kCA2HC"}

package/dist/Structures/Rest.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @license
+ * StellaLib — Copyright (c) 2026 AntonyZ, x2sadddDM, SynX, Astel (OSL-3.0)
+ * Derived from LithiumX — Copyright (c) 2025 Anantix Network (MIT)
+ * See LICENSE and THIRD-PARTY-NOTICES.md for full license details.
+ */
+import type { RestPlayOptions, LavalinkResponse, LavalinkInfo, LavalinkVersion } from "./Types";
+/**
+ * Handles the requests sent to the Lavalink REST API.
+ * Automatically adapts to Lavalink v3 and v4 protocols.
+ */
+declare class StellaRest {
+    /** The Node that this Rest instance is connected to. */
+    private node;
+    /** The ID of the current session (v4) or resume key (v3). */
+    private sessionId;
+    /** The password for the Node. */
+    private readonly password;
+    /** The base URL for REST requests. */
+    private readonly baseUrl;
+    /** Request timeout in ms. */
+    private readonly timeout;
+    /** In-flight request deduplication for GET requests. */
+    private readonly inflightGets;
+    /** Total number of requests made. */
+    requestCount: number;
+    /** Total number of failed requests. */
+    failedCount: number;
+    /** Detected Lavalink version for protocol adaptation. */
+    private version;
+    constructor(node: any);
+    /** Sets the Lavalink version for protocol adaptation. */
+    setVersion(v: LavalinkVersion): void;
+    /** Gets the detected Lavalink version. */
+    getVersion(): LavalinkVersion;
+    /**
+     * Sets the session ID.
+     * @returns The session ID.
+     */
+    setSessionId(sessionId: string): string;
+    /**
+     * Load tracks — normalizes v3 response to v4 format automatically.
+     * @param identifier The search query or URL identifier.
+     */
+    loadTracks(identifier: string): Promise<LavalinkResponse>;
+    /** Normalize v3 loadtracks response to v4 LavalinkResponse format. */
+    private normalizeV3LoadResponse;
+    /**
+     * Fetch Lavalink server info.
+     * v3: GET /version (returns minimal info), v4: GET /v4/info.
+     */
+    getInfo(): Promise<LavalinkInfo>;
+    /** Decode tracks — version-aware endpoint. */
+    decodeTracks(tracks: string[]): Promise<unknown>;
+    /**
+     * Configure session resume.
+     * v3: sends configureResuming WS op, v4: REST PATCH /v4/sessions/{id}.
+     */
+    configureResume(timeout: number): Promise<void>;
+    /**
+     * Get all players on this node.
+     * v3: not supported (returns empty array), v4: REST GET.
+     */
+    getAllPlayers(): Promise<unknown>;
+    /**
+     * Get a single player's state.
+     * v3: not supported (returns null), v4: REST GET.
+     */
+    getPlayer(guildId: string): Promise<unknown>;
+    /**
+     * Update player state.
+     * v3: translates to WebSocket ops, v4: REST PATCH.
+     */
+    updatePlayer(options: RestPlayOptions): Promise<unknown>;
+    /**
+     * v3 player updates via WebSocket ops.
+     * Decomposes the v4-style data into individual v3 WS ops.
+     */
+    private updatePlayerV3;
+    /**
+     * Destroy a player.
+     * v3: WS destroy op, v4: REST DELETE.
+     */
+    destroyPlayer(guildId: string): Promise<unknown>;
+    /**
+     * Core request method with:
+     * - AbortController timeout
+     * - Automatic retry on 429 (rate limit) with Retry-After
+     * - Proper error wrapping
+     */
+    private request;
+    /**
+     * Sends a GET request with deduplication.
+     * If an identical GET is already in-flight, returns the same promise.
+     */
+    get(endpoint: string): Promise<unknown>;
+    /** Sends a PATCH request. */
+    patch(endpoint: string, body: unknown): Promise<unknown>;
+    /** Sends a POST request. */
+    post(endpoint: string, body: unknown): Promise<unknown>;
+    /** Sends a DELETE request. */
+    delete(endpoint: string): Promise<unknown>;
+}
+export { StellaRest };
+//# sourceMappingURL=Rest.d.ts.map

package/dist/Structures/Rest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Rest.d.ts","sourceRoot":"","sources":["../../src/Structures/Rest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,eAAe,EAAU,gBAAgB,EAAE,YAAY,EAAuB,eAAe,EAAE,MAAM,SAAS,CAAC;AAK7H;;;GAGG;AACH,cAAM,UAAU;IACf,wDAAwD;IACxD,OAAO,CAAC,IAAI,CAAM;IAClB,6DAA6D;IAC7D,OAAO,CAAC,SAAS,CAAS;IAC1B,iCAAiC;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,sCAAsC;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,6BAA6B;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,wDAAwD;IACxD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuC;IACpE,qCAAqC;IAC9B,YAAY,SAAK;IACxB,uCAAuC;IAChC,WAAW,SAAK;IACvB,yDAAyD;IACzD,OAAO,CAAC,OAAO,CAAsB;gBAEzB,IAAI,EAAE,GAAG;IAQrB,yDAAyD;IAClD,UAAU,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI;IAI3C,0CAA0C;IACnC,UAAU,IAAI,eAAe;IAIpC;;;OAGG;IACI,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAO9C;;;OAGG;IACU,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAMtE,sEAAsE;IACtE,OAAO,CAAC,uBAAuB;IAuC/B;;;OAGG;IACU,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;IAsB7C,8CAA8C;IACjC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAK7D;;;OAGG;IACU,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5D;;;OAGG;IACU,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IAK9C;;;OAGG;IACU,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKzD;;;OAGG;IACU,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IASrE;;;OAGG;IACH,OAAO,CAAC,cAAc;IA2DtB;;;OAGG;IACU,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU7D;;;;;OAKG;YACW,OAAO;IA8ErB;;;OAGG;IACU,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYpD,6BAA6B;IAChB,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrE,4BAA4B;IACf,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpE,8BAA8B;IACjB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGvD;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/Structures/Rest.js

@@ -0,0 +1,343 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StellaRest = void 0;
+/** Maximum number of retries for rate-limited (429) requests. */
+const MAX_RATE_LIMIT_RETRIES = 3;
+/**
+ * Handles the requests sent to the Lavalink REST API.
+ * Automatically adapts to Lavalink v3 and v4 protocols.
+ */
+class StellaRest {
+    /** The Node that this Rest instance is connected to. */
+    node;
+    /** The ID of the current session (v4) or resume key (v3). */
+    sessionId;
+    /** The password for the Node. */
+    password;
+    /** The base URL for REST requests. */
+    baseUrl;
+    /** Request timeout in ms. */
+    timeout;
+    /** In-flight request deduplication for GET requests. */
+    inflightGets = new Map();
+    /** Total number of requests made. */
+    requestCount = 0;
+    /** Total number of failed requests. */
+    failedCount = 0;
+    /** Detected Lavalink version for protocol adaptation. */
+    version = 4;
+    constructor(node) {
+        this.node = node;
+        this.sessionId = node.sessionId;
+        this.password = node.options.password;
+        this.baseUrl = `http${node.options.secure ? "s" : ""}://${node.options.host}:${node.options.port}`;
+        this.timeout = node.options.requestTimeout ?? 15000;
+    }
+    /** Sets the Lavalink version for protocol adaptation. */
+    setVersion(v) {
+        this.version = v;
+    }
+    /** Gets the detected Lavalink version. */
+    getVersion() {
+        return this.version;
+    }
+    /**
+     * Sets the session ID.
+     * @returns The session ID.
+     */
+    setSessionId(sessionId) {
+        this.sessionId = sessionId;
+        return this.sessionId;
+    }
+    // ── Version-aware high-level methods ────────────────────────────────
+    /**
+     * Load tracks — normalizes v3 response to v4 format automatically.
+     * @param identifier The search query or URL identifier.
+     */
+    async loadTracks(identifier) {
+        const prefix = this.version === 3 ? "" : "/v4";
+        const raw = await this.get(`${prefix}/loadtracks?identifier=${encodeURIComponent(identifier)}`);
+        return this.version === 3 ? this.normalizeV3LoadResponse(raw) : raw;
+    }
+    /** Normalize v3 loadtracks response to v4 LavalinkResponse format. */
+    normalizeV3LoadResponse(raw) {
+        const V3_TYPE_MAP = {
+            TRACK_LOADED: "track",
+            PLAYLIST_LOADED: "playlist",
+            SEARCH_RESULT: "search",
+            NO_MATCHES: "empty",
+            LOAD_FAILED: "error",
+        };
+        const loadType = V3_TYPE_MAP[raw.loadType] ?? "empty";
+        const normTrack = (t) => ({
+            encoded: t.track ?? t.encoded ?? "",
+            info: t.info ?? {},
+            pluginInfo: t.pluginInfo ?? {},
+        });
+        let data;
+        switch (loadType) {
+            case "track":
+                data = raw.tracks?.length ? normTrack(raw.tracks[0]) : { encoded: "", info: {}, pluginInfo: {} };
+                break;
+            case "search":
+                data = (raw.tracks ?? []).map(normTrack);
+                break;
+            case "playlist":
+                data = {
+                    info: { name: raw.playlistInfo?.name ?? "Unknown" },
+                    pluginInfo: {},
+                    tracks: (raw.tracks ?? []).map(normTrack),
+                };
+                break;
+            default:
+                data = (raw.tracks ?? []).map(normTrack);
+        }
+        return { loadType, data };
+    }
+    /**
+     * Fetch Lavalink server info.
+     * v3: GET /version (returns minimal info), v4: GET /v4/info.
+     */
+    async getInfo() {
+        if (this.version === 3) {
+            const url = `${this.baseUrl}/version`;
+            const res = await fetch(url, {
+                headers: { Authorization: this.password },
+                signal: AbortSignal.timeout(this.timeout),
+            });
+            const text = (await res.text()).trim();
+            return {
+                version: { semver: text, major: 3, minor: 0, patch: 0, preRelease: "" },
+                buildTime: 0,
+                git: { branch: "", commit: "", commitTime: 0 },
+                jvm: "",
+                lavaplayer: "",
+                sourceManagers: [],
+                filters: [],
+                plugins: [],
+            };
+        }
+        return (await this.get("/v4/info"));
+    }
+    /** Decode tracks — version-aware endpoint. */
+    async decodeTracks(tracks) {
+        const prefix = this.version === 3 ? "" : "/v4";
+        return await this.post(`${prefix}/decodetracks`, tracks);
+    }
+    /**
+     * Configure session resume.
+     * v3: sends configureResuming WS op, v4: REST PATCH /v4/sessions/{id}.
+     */
+    async configureResume(timeout) {
+        if (this.version === 3) {
+            this.node.sendWs({
+                op: "configureResuming",
+                key: this.sessionId,
+                timeout,
+            });
+        }
+        else {
+            await this.patch(`/v4/sessions/${this.sessionId}`, {
+                resuming: true,
+                timeout,
+            });
+        }
+    }
+    /**
+     * Get all players on this node.
+     * v3: not supported (returns empty array), v4: REST GET.
+     */
+    async getAllPlayers() {
+        if (this.version === 3)
+            return [];
+        return await this.get(`/v4/sessions/${this.sessionId}/players`);
+    }
+    /**
+     * Get a single player's state.
+     * v3: not supported (returns null), v4: REST GET.
+     */
+    async getPlayer(guildId) {
+        if (this.version === 3)
+            return null;
+        return await this.get(`/v4/sessions/${this.sessionId}/players/${guildId}`);
+    }
+    /**
+     * Update player state.
+     * v3: translates to WebSocket ops, v4: REST PATCH.
+     */
+    async updatePlayer(options) {
+        if (this.version === 3)
+            return this.updatePlayerV3(options);
+        const noReplace = options.data?.noReplace ?? false;
+        return await this.patch(`/v4/sessions/${this.sessionId}/players/${options.guildId}?noReplace=${noReplace}`, options.data);
+    }
+    /**
+     * v3 player updates via WebSocket ops.
+     * Decomposes the v4-style data into individual v3 WS ops.
+     */
+    updatePlayerV3(options) {
+        const { guildId, data } = options;
+        if (!data)
+            return {};
+        // Voice update → voiceUpdate op
+        if (data.voice) {
+            this.node.sendWs({
+                op: "voiceUpdate",
+                guildId,
+                sessionId: data.voice.sessionId,
+                event: {
+                    token: data.voice.token,
+                    guild_id: guildId,
+                    endpoint: data.voice.endpoint,
+                },
+            });
+        }
+        // Play or Stop
+        if (data.encodedTrack !== undefined) {
+            if (data.encodedTrack === null) {
+                this.node.sendWs({ op: "stop", guildId });
+            }
+            else {
+                const playOp = {
+                    op: "play",
+                    guildId,
+                    track: data.encodedTrack,
+                    noReplace: data.noReplace ?? false,
+                };
+                if (data.startTime !== undefined)
+                    playOp.startTime = data.startTime;
+                if (data.endTime !== undefined)
+                    playOp.endTime = data.endTime;
+                if (data.position !== undefined)
+                    playOp.startTime = data.position;
+                this.node.sendWs(playOp);
+            }
+        }
+        // Pause
+        if (data.paused !== undefined) {
+            this.node.sendWs({ op: "pause", guildId, pause: data.paused });
+        }
+        // Seek (only if not changing track)
+        if (data.position !== undefined && data.encodedTrack === undefined) {
+            this.node.sendWs({ op: "seek", guildId, position: data.position });
+        }
+        // Volume
+        if (data.volume !== undefined) {
+            this.node.sendWs({ op: "volume", guildId, volume: data.volume });
+        }
+        // Filters
+        if (data.filters) {
+            this.node.sendWs({ op: "filters", guildId, ...data.filters });
+        }
+        return {};
+    }
+    /**
+     * Destroy a player.
+     * v3: WS destroy op, v4: REST DELETE.
+     */
+    async destroyPlayer(guildId) {
+        if (this.version === 3) {
+            this.node.sendWs({ op: "destroy", guildId });
+            return {};
+        }
+        return await this.delete(`/v4/sessions/${this.sessionId}/players/${guildId}`);
+    }
+    // ── Core HTTP methods ───────────────────────────────────────────────
+    /**
+     * Core request method with:
+     * - AbortController timeout
+     * - Automatic retry on 429 (rate limit) with Retry-After
+     * - Proper error wrapping
+     */
+    async request(method, endpoint, body, retryCount = 0) {
+        const url = `${this.baseUrl}${endpoint}`;
+        this.requestCount++;
+        this.node.manager.emit("Debug", `[REST] ${method} ${url}${retryCount > 0 ? ` (retry ${retryCount})` : ""}`);
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        const config = {
+            method,
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: this.password,
+            },
+            body: body ? JSON.stringify(body) : null,
+            signal: controller.signal,
+        };
+        try {
+            const response = await fetch(url, config);
+            clearTimeout(timeoutId);
+            // Handle rate limiting with automatic retry
+            if (response.status === 429 && retryCount < MAX_RATE_LIMIT_RETRIES) {
+                const retryAfter = response.headers.get("Retry-After");
+                const delay = retryAfter ? parseInt(retryAfter, 10) * 1000 : 1000 * (retryCount + 1);
+                this.node.manager.emit("Debug", `[REST] Rate limited on ${method} ${endpoint}, retrying in ${delay}ms`);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                return this.request(method, endpoint, body, retryCount + 1);
+            }
+            const contentType = response.headers.get("content-type");
+            if (!response.ok) {
+                this.failedCount++;
+                let errorBody = "";
+                try {
+                    errorBody = await response.text();
+                }
+                catch { /* ignore */ }
+                const error = new Error(`REST ${method} ${endpoint} returned ${response.status}: ${errorBody}`);
+                this.node.manager.emit("NodeError", this.node, error);
+                throw error;
+            }
+            if (!contentType || !contentType.includes("application/json")) {
+                return response.status >= 200 && response.status < 300 ? {} : null;
+            }
+            const text = await response.text();
+            if (!text || text.trim() === "")
+                return {};
+            return JSON.parse(text);
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            // Handle abort (timeout)
+            if (error.name === "AbortError") {
+                this.failedCount++;
+                const wrapped = new Error(`REST ${method} ${endpoint} timed out after ${this.timeout}ms`);
+                this.node.manager.emit("NodeError", this.node, wrapped);
+                throw wrapped;
+            }
+            if (error.message?.startsWith("REST "))
+                throw error;
+            this.failedCount++;
+            const wrapped = new Error(`REST ${method} ${endpoint} failed: ${error.message}`);
+            this.node.manager.emit("NodeError", this.node, wrapped);
+            throw wrapped;
+        }
+    }
+    /**
+     * Sends a GET request with deduplication.
+     * If an identical GET is already in-flight, returns the same promise.
+     */
+    async get(endpoint) {
+        const existing = this.inflightGets.get(endpoint);
+        if (existing)
+            return existing;
+        const promise = this.request("GET", endpoint).finally(() => {
+            this.inflightGets.delete(endpoint);
+        });
+        this.inflightGets.set(endpoint, promise);
+        return promise;
+    }
+    /** Sends a PATCH request. */
+    async patch(endpoint, body) {
+        return await this.request("PATCH", endpoint, body);
+    }
+    /** Sends a POST request. */
+    async post(endpoint, body) {
+        return await this.request("POST", endpoint, body);
+    }
+    /** Sends a DELETE request. */
+    async delete(endpoint) {
+        return await this.request("DELETE", endpoint);
+    }
+}
+exports.StellaRest = StellaRest;
+//# sourceMappingURL=Rest.js.map

package/dist/Structures/Rest.js.map

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

package/dist/Structures/SessionStore.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @license
+ * StellaLib — Copyright (c) 2026 AntonyZ, x2sadddDM, SynX, Astel (OSL-3.0)
+ * See LICENSE and THIRD-PARTY-NOTICES.md for full license details.
+ */
+import type { SessionStore } from "./Types";
+/**
+ * File-based session store that persists Lavalink session IDs to disk.
+ * This allows session resume after bot restarts — players keep playing seamlessly.
+ *
+ * Usage:
+ * ```ts
+ * const manager = new StellaManager({
+ *   sessionStore: new FileSessionStore("./sessions.json"),
+ *   // ...
+ * });
+ * ```
+ */
+export declare class FileSessionStore implements SessionStore {
+    private readonly filePath;
+    private readonly flushInterval;
+    private data;
+    private dirty;
+    private writeTimer;
+    /**
+     * @param filePath Path to the JSON file for storing sessions.
+     * @param flushInterval How often to write to disk in ms (default: 1000). Set to 0 for immediate writes.
+     */
+    constructor(filePath: string, flushInterval?: number);
+    /** Load sessions from disk. */
+    private load;
+    /** Schedule a write to disk (debounced). */
+    private scheduleFlush;
+    /** Write sessions to disk immediately. */
+    flush(): void;
+    get(nodeId: string): string | null;
+    set(nodeId: string, sessionId: string): void;
+    delete(nodeId: string): void;
+    /** Flush and clean up timers. Call on shutdown. */
+    destroy(): void;
+}
+//# sourceMappingURL=SessionStore.d.ts.map

package/dist/Structures/SessionStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionStore.d.ts","sourceRoot":"","sources":["../../src/Structures/SessionStore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAI5C;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IAUnD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAV/B,OAAO,CAAC,IAAI,CAA8B;IAC1C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAA8C;IAEhE;;;OAGG;gBAEe,QAAQ,EAAE,MAAM,EAChB,aAAa,SAAO;IAKtC,+BAA+B;IAC/B,OAAO,CAAC,IAAI;IAWZ,4CAA4C;IAC5C,OAAO,CAAC,aAAa;IAarB,0CAA0C;IACnC,KAAK,IAAI,IAAI;IAWb,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIlC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAK5C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKnC,mDAAmD;IAC5C,OAAO,IAAI,IAAI;CAOtB"}