magmastream 2.9.2-dev.1 → 2.9.2-dev.3

package/dist/structures/Node.js

@@ -9,6 +9,7 @@ const ws_1 = tslib_1.__importDefault(require("ws"));
 const fs_1 = tslib_1.__importDefault(require("fs"));
 const path_1 = tslib_1.__importDefault(require("path"));
 const Enums_1 = require("./Enums");
+const MagmastreamError_1 = require("./MagmastreamError");
 const validSponsorBlocks = Object.values(Enums_1.SponsorBlockSegment).map((v) => v.toLowerCase());
 class Node {
     manager;
@@ -40,8 +41,12 @@ class Node {
     constructor(manager, options) {
         this.manager = manager;
         this.options = options;
-        if (!this.manager)
-            throw new RangeError("Manager instance is required.");
+        if (!this.manager) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.GENERAL_INVALID_MANAGER,
+                message: "Manager instance is required.",
+            });
+        }
         if (this.manager.nodes.has(options.identifier || options.host)) {
             return this.manager.nodes.get(options.identifier || options.host);
         }
@@ -162,7 +167,11 @@ class Node {
                     try {
                         const sessionIds = JSON.parse(currentRaw);
                         if (typeof sessionIds !== "object" || Array.isArray(sessionIds)) {
-                            throw new Error("[NODE] loadSessionIds invalid data type from Redis.");
+                            throw new MagmastreamError_1.MagmaStreamError({
+                                code: Enums_1.MagmaStreamErrorCode.NODE_SESSION_IDS_LOAD_FAILED,
+                                message: "Invalid sessionIds data type from Redis.",
+                                context: { sessionIds },
+                            });
                         }
                         this.sessionIdsMap = new Map(Object.entries(sessionIds));
                         const compositeKey = `${this.options.identifier}::${this.manager.options.clusterId}`;
@@ -199,9 +208,9 @@ class Node {
         switch (this.manager.options.stateStorage.type) {
             case Enums_1.StateStorageType.Memory:
             case Enums_1.StateStorageType.JSON: {
-                this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Updating sessionIds to file: ${this.sessionIdsFilePath}`);
                 const compositeKey = `${this.options.identifier}::${this.manager.options.clusterId}`;
                 const filePath = this.sessionIdsFilePath;
+                this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Updating sessionIds to file: ${filePath}`);
                 let updated = false;
                 let retries = 3;
                 while (!updated && retries > 0) {
@@ -227,8 +236,12 @@ class Node {
                     catch (err) {
                         retries--;
                         if (retries === 0) {
-                            this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Failed to update sessionIds after retries: ${err.message}`);
-                            throw err;
+                            throw new MagmastreamError_1.MagmaStreamError({
+                                code: Enums_1.MagmaStreamErrorCode.NODE_SESSION_IDS_UPDATE_FAILED,
+                                message: `Failed to update sessionIds after retries.`,
+                                cause: err instanceof Error ? err : undefined,
+                                context: { filePath, compositeKey, storage: "file" },
+                            });
                         }
                         await new Promise((r) => setTimeout(r, 50));
                     }
@@ -239,27 +252,37 @@ class Node {
                 const key = `${this.redisPrefix}node:sessionIds`;
                 const compositeKey = `${this.options.identifier}::${this.manager.options.clusterId}`;
                 this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Updating sessionIds in Redis key: ${key}`);
-                const currentRaw = await this.manager.redis.get(key);
-                let sessionIds;
-                if (currentRaw) {
-                    try {
+                let sessionIds = {};
+                try {
+                    const currentRaw = await this.manager.redis.get(key);
+                    if (currentRaw) {
                         sessionIds = JSON.parse(currentRaw);
                         if (typeof sessionIds !== "object" || Array.isArray(sessionIds)) {
                             throw new Error("Invalid data type in Redis");
                         }
                     }
-                    catch (err) {
-                        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Corrupted Redis sessionIds, reinitializing: ${err.message}`);
+                    else {
+                        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Redis key not found — creating new sessionIds key.`);
                         sessionIds = {};
                     }
                 }
-                else {
-                    this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Redis key not found — creating new sessionIds key.`);
+                catch (err) {
+                    this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Corrupted Redis sessionIds, reinitializing: ${err.message}`);
                     sessionIds = {};
                 }
-                sessionIds[compositeKey] = this.sessionId;
-                this.sessionIdsMap = new Map(Object.entries(sessionIds));
-                await this.manager.redis.set(key, Utils_1.JSONUtils.safe(sessionIds));
+                try {
+                    sessionIds[compositeKey] = this.sessionId;
+                    this.sessionIdsMap = new Map(Object.entries(sessionIds));
+                    await this.manager.redis.set(key, Utils_1.JSONUtils.safe(sessionIds));
+                }
+                catch (err) {
+                    throw new MagmastreamError_1.MagmaStreamError({
+                        code: Enums_1.MagmaStreamErrorCode.NODE_SESSION_IDS_UPDATE_FAILED,
+                        message: `Failed to update sessionIds in Redis.`,
+                        cause: err instanceof Error ? err : undefined,
+                        context: { key, compositeKey, storage: "redis" },
+                    });
+                }
                 break;
             }
         }
@@ -371,7 +394,11 @@ class Node {
         this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Reconnecting node: ${Utils_1.JSONUtils.safe(debugInfo, 2)}`);
         this.reconnectTimeout = setTimeout(async () => {
             if (this.reconnectAttempts >= this.options.maxRetryAttempts) {
-                const error = new Error(`Unable to connect after ${this.options.maxRetryAttempts} attempts.`);
+                const error = new MagmastreamError_1.MagmaStreamError({
+                    code: Enums_1.MagmaStreamErrorCode.NODE_RECONNECT_FAILED,
+                    message: `Unable to reconnect after ${this.options.maxRetryAttempts} attempts.`,
+                    context: { ...debugInfo },
+                });
                 this.manager.emit(Enums_1.ManagerEventTypes.NodeError, this, error);
                 return await this.destroy();
             }
@@ -634,7 +661,8 @@ class Node {
         const skipFlag = player.get("skipFlag");
         const previous = await player.queue.getPrevious();
         const current = await player.queue.getCurrent();
-        if (!skipFlag && (previous.length === 0 || (previous[0] && previous[0].track !== current?.track))) {
+        // Only add current to previous if it's not already the newest
+        if (!skipFlag && (previous.length === 0 || (previous.at(-1)?.track !== current?.track))) {
             await player.queue.addPrevious(current);
         }
         player.set("skipFlag", false);
@@ -696,10 +724,10 @@ class Node {
         if (!player.isAutoplay || attempt > player.autoplayTries || !(await player.queue.getPrevious()).length)
             return false;
         const PreviousQueue = await player.queue.getPrevious();
-        const lastTrack = PreviousQueue?.at(-1);
-        lastTrack.requester = player.get("Internal_AutoplayUser");
+        const lastTrack = PreviousQueue.at(-1); // newest is at tail
         if (!lastTrack)
             return false;
+        lastTrack.requester = player.get("Internal_AutoplayUser");
         const tracks = await Utils_1.AutoPlayUtils.getRecommendedTracks(lastTrack);
         const normalize = (str) => str
             .toLowerCase()
@@ -708,6 +736,7 @@ class Node {
         const filteredTracks = tracks.filter((track) => track.identifier !== lastTrack.identifier && track.uri !== lastTrack.uri && normalize(track.title) !== normalize(lastTrack.title));
         if (filteredTracks.length) {
             const randomTrack = filteredTracks[Math.floor(Math.random() * filteredTracks.length)];
+            console.log(randomTrack);
             await player.queue.add(randomTrack);
             await player.play();
             return true;
@@ -838,24 +867,35 @@ class Node {
      * @returns {Promise<Lyrics | NodeLinkGetLyrics>} A promise that resolves with the lyrics data.
      */
     async getLyrics(track, skipTrackSource = false, language) {
-        if (!this.connected)
-            throw new RangeError(`The node is not connected to the lavalink server: ${this.options.identifier}`);
+        if (!this.connected) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.NODE_DISCONNECTED,
+                message: `The node is not connected to the lavalink server.`,
+                context: { identifier: this.options.identifier },
+            });
+        }
         if (this.isNodeLink) {
             return (await this.rest.get(`/v4/loadlyrics?encodedTrack=${encodeURIComponent(track.track)}${language ? `&language=${language}` : ""}`));
         }
-        if (!this.info.plugins.some((plugin) => plugin.name === "lavalyrics-plugin")) {
-            throw new RangeError(`The plugin "lavalyrics-plugin" must be present in the lavalink node: ${this.options.identifier}`);
+        const requiredPlugins = ["lavalyrics-plugin"];
+        for (const plugin of requiredPlugins) {
+            if (!this.info.plugins.some((p) => p.name === plugin)) {
+                throw new MagmastreamError_1.MagmaStreamError({
+                    code: Enums_1.MagmaStreamErrorCode.NODE_PLUGIN_ERROR,
+                    message: `The plugin "${plugin}" must be present in the lavalink node.`,
+                    context: { identifier: this.options.identifier },
+                });
+            }
         }
-        if (!this.info.plugins.some((plugin) => plugin.name === "lavasrc-plugin" || plugin.name === "java-lyrics-plugin")) {
-            throw new RangeError(`One of the following plugins must also be present in the lavalink node: "lavasrc-plugin" or "java-lyrics-plugin" (Node: ${this.options.identifier})`);
+        if (!this.info.plugins.some((p) => p.name === "lavasrc-plugin" || p.name === "java-lyrics-plugin")) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.NODE_PLUGIN_ERROR,
+                message: `One of the following plugins must also be present in the lavalink node: "lavasrc-plugin" or "java-lyrics-plugin".`,
+                context: { identifier: this.options.identifier },
+            });
         }
-        return ((await this.rest.get(`/v4/lyrics?track=${encodeURIComponent(track.track)}&skipTrackSource=${skipTrackSource}`)) || {
-            source: null,
-            provider: null,
-            text: null,
-            lines: [],
-            plugin: [],
-        });
+        const lyrics = (await this.rest.get(`/v4/lyrics?track=${encodeURIComponent(track.track)}&skipTrackSource=${skipTrackSource}`));
+        return lyrics || { source: null, provider: null, text: null, lines: [], plugin: [] };
     }
     /**
      * Subscribes to lyrics for a player.
@@ -865,17 +905,50 @@ class Node {
      * @throws {RangeError} If the node is not connected to the lavalink server or if the java-lyrics-plugin is not available.
      */
     async lyricsSubscribe(guildId, skipTrackSource = false) {
-        if (!this.connected)
-            throw new RangeError(`The node is not connected to the lavalink server: ${this.options.identifier}`);
-        if (this.isNodeLink)
-            throw new RangeError(`The node is a node link: ${this.options.identifier}`);
-        if (!this.info.plugins.some((plugin) => plugin.name === "lavalyrics-plugin")) {
-            throw new RangeError(`The plugin "lavalyrics-plugin" must be present in the lavalink node: ${this.options.identifier}`);
+        if (!this.connected) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.NODE_DISCONNECTED,
+                message: `The node is not connected to the lavalink server.`,
+                context: { identifier: this.options.identifier },
+            });
+        }
+        if (this.isNodeLink) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.NODE_PROTOCOL_ERROR,
+                message: `The node is a NodeLink, cannot subscribe to lyrics.`,
+                context: { identifier: this.options.identifier },
+            });
+        }
+        const requiredPlugins = ["lavalyrics-plugin"];
+        for (const plugin of requiredPlugins) {
+            if (!this.info.plugins.some((p) => p.name === plugin)) {
+                throw new MagmastreamError_1.MagmaStreamError({
+                    code: Enums_1.MagmaStreamErrorCode.NODE_PLUGIN_ERROR,
+                    message: `The plugin "${plugin}" must be present in the lavalink node.`,
+                    context: { identifier: this.options.identifier },
+                });
+            }
+        }
+        if (!this.info.plugins.some((p) => p.name === "lavasrc-plugin" || p.name === "java-lyrics-plugin")) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.NODE_PLUGIN_ERROR,
+                message: `One of the following plugins must also be present in the lavalink node: "lavasrc-plugin" or "java-lyrics-plugin".`,
+                context: { identifier: this.options.identifier },
+            });
         }
-        if (!this.info.plugins.some((plugin) => plugin.name === "lavasrc-plugin" || plugin.name === "java-lyrics-plugin")) {
-            throw new RangeError(`One of the following plugins must also be present in the lavalink node: "lavasrc-plugin" or "java-lyrics-plugin" (Node: ${this.options.identifier})`);
+        try {
+            return await this.rest.post(`/v4/sessions/${this.sessionId}/players/${guildId}/lyrics/subscribe?skipTrackSource=${skipTrackSource}`, {});
+        }
+        catch (err) {
+            throw err instanceof MagmastreamError_1.MagmaStreamError
+                ? err
+                : new MagmastreamError_1.MagmaStreamError({
+                    code: Enums_1.MagmaStreamErrorCode.NODE_PROTOCOL_ERROR,
+                    message: "Failed to subscribe to lyrics session.",
+                    cause: err instanceof Error ? err : undefined,
+                    context: { identifier: this.options.identifier, guildId, skipTrackSource },
+                });
         }
-        return await this.rest.post(`/v4/sessions/${this.sessionId}/players/${guildId}/lyrics/subscribe?skipTrackSource=${skipTrackSource}`, {});
     }
     /**
      * Unsubscribes from lyrics for a player.
@@ -884,14 +957,40 @@ class Node {
      * @throws {RangeError} If the node is not connected to the lavalink server or if the java-lyrics-plugin is not available.
      */
     async lyricsUnsubscribe(guildId) {
-        if (!this.connected)
-            throw new RangeError(`The node is not connected to the lavalink server: ${this.options.identifier}`);
-        if (this.isNodeLink)
-            throw new RangeError(`The node is a node link: ${this.options.identifier}`);
+        if (!this.connected) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.NODE_DISCONNECTED,
+                message: `The node is not connected to the lavalink server.`,
+                context: { identifier: this.options.identifier },
+            });
+        }
+        if (this.isNodeLink) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.NODE_PROTOCOL_ERROR,
+                message: `The node is a NodeLink, cannot unsubscribe from lyrics.`,
+                context: { identifier: this.options.identifier },
+            });
+        }
         if (!this.info.plugins.some((plugin) => plugin.name === "java-lyrics-plugin")) {
-            throw new RangeError(`there is no java-lyrics-plugin available in the lavalink node: ${this.options.identifier}`);
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.NODE_PLUGIN_ERROR,
+                message: `The plugin "java-lyrics-plugin" must be present in the lavalink node to unsubscribe.`,
+                context: { identifier: this.options.identifier },
+            });
+        }
+        try {
+            return await this.rest.delete(`/v4/sessions/${this.sessionId}/players/${guildId}/lyrics/subscribe`);
+        }
+        catch (err) {
+            throw err instanceof MagmastreamError_1.MagmaStreamError
+                ? err
+                : new MagmastreamError_1.MagmaStreamError({
+                    code: Enums_1.MagmaStreamErrorCode.NODE_PROTOCOL_ERROR,
+                    message: "Failed to unsubscribe from lyrics session.",
+                    cause: err instanceof Error ? err : undefined,
+                    context: { identifier: this.options.identifier, guildId },
+                });
         }
-        return await this.rest.delete(`/v4/sessions/${this.sessionId}/players/${guildId}/lyrics/subscribe`);
     }
     /**
      * Handles the event when a track becomes stuck during playback.
@@ -1015,9 +1114,26 @@ class Node {
      * @throws {RangeError} If the sponsorblock-plugin is not available in the Lavalink node.
      */
     async getSponsorBlock(player) {
-        if (!this.info.plugins.some((plugin) => plugin.name === "sponsorblock-plugin"))
-            throw new RangeError(`there is no sponsorblock-plugin available in the lavalink node: ${this.options.identifier}`);
-        return (await this.rest.get(`/v4/sessions/${this.sessionId}/players/${player.guildId}/sponsorblock/categories`));
+        if (!this.info.plugins.some((plugin) => plugin.name === "sponsorblock-plugin")) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.NODE_PLUGIN_ERROR,
+                message: `The plugin "sponsorblock-plugin" must be present in the lavalink node to fetch SponsorBlock data.`,
+                context: { identifier: this.options.identifier, guildId: player.guildId },
+            });
+        }
+        try {
+            return (await this.rest.get(`/v4/sessions/${this.sessionId}/players/${player.guildId}/sponsorblock/categories`));
+        }
+        catch (err) {
+            throw err instanceof MagmastreamError_1.MagmaStreamError
+                ? err
+                : new MagmastreamError_1.MagmaStreamError({
+                    code: Enums_1.MagmaStreamErrorCode.NODE_PROTOCOL_ERROR,
+                    message: "Failed to fetch SponsorBlock segments.",
+                    cause: err instanceof Error ? err : undefined,
+                    context: { identifier: this.options.identifier, guildId: player.guildId },
+                });
+        }
     }
     /**
      * Sets the sponsorblock segments for a player.
@@ -1034,14 +1150,40 @@ class Node {
      * ```
      */
     async setSponsorBlock(player, segments = [Enums_1.SponsorBlockSegment.Sponsor, Enums_1.SponsorBlockSegment.SelfPromo]) {
-        if (!this.info.plugins.some((plugin) => plugin.name === "sponsorblock-plugin"))
-            throw new RangeError(`there is no sponsorblock-plugin available in the lavalink node: ${this.options.identifier}`);
-        if (!segments.length)
-            throw new RangeError("No Segments provided. Did you mean to use 'deleteSponsorBlock'?");
-        if (segments.some((v) => !validSponsorBlocks.includes(v.toLowerCase())))
-            throw new SyntaxError(`You provided a sponsorblock which isn't valid, valid ones are: ${validSponsorBlocks.map((v) => `'${v}'`).join(", ")}`);
-        await this.rest.put(`/v4/sessions/${this.sessionId}/players/${player.guildId}/sponsorblock/categories`, Utils_1.JSONUtils.safe(segments.map((v) => v.toLowerCase()), 2));
-        return;
+        if (!this.info.plugins.some((plugin) => plugin.name === "sponsorblock-plugin")) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.NODE_PLUGIN_ERROR,
+                message: `The plugin "sponsorblock-plugin" must be present in the lavalink node to set SponsorBlock segments.`,
+                context: { identifier: this.options.identifier, guildId: player.guildId },
+            });
+        }
+        if (!segments.length) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.NODE_PROTOCOL_ERROR,
+                message: "No segments provided. Did you mean to use 'deleteSponsorBlock'?",
+                context: { identifier: this.options.identifier, guildId: player.guildId },
+            });
+        }
+        if (segments.some((v) => !validSponsorBlocks.includes(v.toLowerCase()))) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.NODE_PROTOCOL_ERROR,
+                message: `Invalid SponsorBlock segments provided. Valid ones are: ${validSponsorBlocks.map((v) => `'${v}'`).join(", ")}`,
+                context: { identifier: this.options.identifier, guildId: player.guildId, invalidSegments: segments },
+            });
+        }
+        try {
+            await this.rest.put(`/v4/sessions/${this.sessionId}/players/${player.guildId}/sponsorblock/categories`, Utils_1.JSONUtils.safe(segments.map((v) => v.toLowerCase()), 2));
+        }
+        catch (err) {
+            throw err instanceof MagmastreamError_1.MagmaStreamError
+                ? err
+                : new MagmastreamError_1.MagmaStreamError({
+                    code: Enums_1.MagmaStreamErrorCode.NODE_PROTOCOL_ERROR,
+                    message: "Failed to set SponsorBlock segments.",
+                    cause: err instanceof Error ? err : undefined,
+                    context: { identifier: this.options.identifier, guildId: player.guildId, segments },
+                });
+        }
     }
     /**
      * Deletes the sponsorblock segments for a player.
@@ -1050,10 +1192,26 @@ class Node {
      * @throws {RangeError} If the sponsorblock-plugin is not available in the Lavalink node.
      */
     async deleteSponsorBlock(player) {
-        if (!this.info.plugins.some((plugin) => plugin.name === "sponsorblock-plugin"))
-            throw new RangeError(`there is no sponsorblock-plugin available in the lavalink node: ${this.options.identifier}`);
-        await this.rest.delete(`/v4/sessions/${this.sessionId}/players/${player.guildId}/sponsorblock/categories`);
-        return;
+        if (!this.info.plugins.some((plugin) => plugin.name === "sponsorblock-plugin")) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.NODE_PLUGIN_ERROR,
+                message: `The plugin "sponsorblock-plugin" must be present in the lavalink node to delete SponsorBlock segments.`,
+                context: { identifier: this.options.identifier, guildId: player.guildId },
+            });
+        }
+        try {
+            await this.rest.delete(`/v4/sessions/${this.sessionId}/players/${player.guildId}/sponsorblock/categories`);
+        }
+        catch (err) {
+            throw err instanceof MagmastreamError_1.MagmaStreamError
+                ? err
+                : new MagmastreamError_1.MagmaStreamError({
+                    code: Enums_1.MagmaStreamErrorCode.NODE_PROTOCOL_ERROR,
+                    message: "Failed to delete SponsorBlock segments.",
+                    cause: err instanceof Error ? err : undefined,
+                    context: { identifier: this.options.identifier, guildId: player.guildId },
+                });
+        }
     }
     /**
      * Creates a README.md or README.txt file in the magmastream directory