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

package/dist/index.d.ts

@@ -275,6 +275,53 @@ declare enum AvailableFilters {
     Vaporwave = "vaporwave",
     Vibrato = "vibrato"
 }
+/**
+ * MagmaStream Error Codes Enum
+ */
+declare enum MagmaStreamErrorCode {
+    GENERAL_UNKNOWN = "MS_GENERAL_UNKNOWN",
+    GENERAL_TIMEOUT = "MS_GENERAL_TIMEOUT",
+    GENERAL_INVALID_MANAGER = "MS_GENERAL_INVALID_MANAGER",
+    MANAGER_INIT_FAILED = "MS_MANAGER_INIT_FAILED",
+    MANAGER_INVALID_CONFIG = "MS_MANAGER_INVALID_CONFIG",
+    MANAGER_SHUTDOWN_FAILED = "MS_MANAGER_SHUTDOWN_FAILED",
+    MANAGER_NO_NODES = "MS_MANAGER_NO_NODES",
+    MANAGER_NODE_NOT_FOUND = "MS_MANAGER_NODE_NOT_FOUND",
+    MANAGER_SEARCH_FAILED = "MS_MANAGER_SEARCH_FAILED",
+    MANAGER_CLEANUP_INACTIVE_PLAYERS_FAILED = "MS_MANAGER_CLEANUP_INACTIVE_PLAYERS_FAILED",
+    NODE_INVALID_CONFIG = "MS_NODE_INVALID_CONFIG",
+    NODE_CONNECT_FAILED = "MS_NODE_CONNECT_FAILED",
+    NODE_RECONNECT_FAILED = "MS_NODE_RECONNECT_FAILED",
+    NODE_DISCONNECTED = "MS_NODE_DISCONNECTED",
+    NODE_PROTOCOL_ERROR = "MS_NODE_PROTOCOL_ERROR",
+    NODE_SESSION_IDS_LOAD_FAILED = "MS_NODE_SESSION_IDS_LOAD_FAILED",
+    NODE_SESSION_IDS_UPDATE_FAILED = "MS_NODE_SESSION_IDS_UPDATE_FAILED",
+    NODE_PLUGIN_ERROR = "MS_NODE_PLUGIN_ERROR",
+    PLAYER_INVALID_CONFIG = "MS_PLAYER_INVALID_CONFIG",
+    PLAYER_STATE_INVALID = "MS_PLAYER_STATE_INVALID",
+    PLAYER_QUEUE_EMPTY = "MS_PLAYER_QUEUE_EMPTY",
+    PLAYER_PREVIOUS_EMPTY = "MS_PLAYER_PREVIOUS_EMPTY",
+    PLAYER_INVALID_NOW_PLAYING_MESSAGE = "MS_PLAYER_INVALID_NOW_PLAYING_MESSAGE",
+    PLAYER_INVALID_AUTOPLAY = "MS_PLAYER_INVALID_AUTOPLAY",
+    PLAYER_INVALID_VOLUME = "MS_PLAYER_INVALID_VOLUME",
+    PLAYER_INVALID_REPEAT = "MS_PLAYER_INVALID_REPEAT",
+    PLAYER_INVALID_PAUSE = "MS_PLAYER_INVALID_PAUSE",
+    PLAYER_INVALID_SEEK = "MS_PLAYER_INVALID_SEEK",
+    PLAYER_MOVE_FAILED = "MS_PLAYER_MOVE_FAILED",
+    PLAYER_VOICE_RECEIVER_ERROR = "MS_PLAYER_VOICE_RECEIVER_ERROR",
+    QUEUE_REDIS_ERROR = "MS_QUEUE_REDIS_ERROR",
+    QUEUE_JSON_ERROR = "MS_QUEUE_JSON_ERROR",
+    QUEUE_MEMORY_ERROR = "MS_QUEUE_MEMORY_ERROR",
+    FILTER_APPLY_FAILED = "MS_FILTER_APPLY_FAILED",
+    REST_REQUEST_FAILED = "MS_REST_REQUEST_FAILED",
+    REST_UNAUTHORIZED = "MS_REST_UNAUTHORIZED",
+    UTILS_TRACK_PARTIAL_INVALID = "MS_UTILS_TRACK_PARTIAL_INVALID",
+    UTILS_TRACK_BUILD_FAILED = "MS_UTILS_TRACK_BUILD_FAILED",
+    UTILS_AUTOPLAY_BUILD_FAILED = "MS_UTILS_AUTOPLAY_BUILD_FAILED",
+    PLUGIN_LOAD_FAILED = "MS_PLUGIN_LOAD_FAILED",
+    PLUGIN_RUNTIME_ERROR = "MS_PLUGIN_RUNTIME_ERROR"
+}
+declare const MagmaStreamErrorNumbers: Record<MagmaStreamErrorCode, number>;
 
 /**
  * The player's queue, the `current` property is the currently playing track, think of the rest as the up-coming tracks.
@@ -2262,7 +2309,6 @@ declare class Player {
      * Retrieves the current lyrics for the playing track.
      * @param skipTrackSource - Indicates whether to skip the track source when fetching lyrics.
      * @returns {Promise<Lyrics>} - The lyrics of the current track.
-     * @throws {RangeError} - If the 'lavalyrics-plugin' is not available on the Lavalink node.
      */
     getCurrentLyrics(skipTrackSource?: boolean): Promise<Lyrics>;
     /**
@@ -2336,10 +2382,10 @@ declare class Rest {
      */
     setSessionId(sessionId: string): string;
     /**
-     * Retrieves all the players that are currently running on the node.
+     * Retrieves one the player that is currently running on the node.
      * @returns {Promise<unknown>} Returns the result of the GET request.
      */
-    getAllPlayers(): Promise<unknown>;
+    getPlayer(guildId: string): Promise<LavaPlayer>;
     /**
      * Sends a PATCH request to update player related data.
      * @param {RestPlayOptions} options The options to update the player with.
@@ -3525,6 +3571,19 @@ declare abstract class JSONUtils {
     static serializeTrack(track: Track): string;
 }
 
+interface MagmaStreamErrorOptions<T = unknown> {
+    code: MagmaStreamErrorCode;
+    message?: string;
+    cause?: Error;
+    context?: T;
+}
+declare class MagmaStreamError<T = unknown> extends Error {
+    readonly code: MagmaStreamErrorCode;
+    readonly number: number;
+    readonly context?: T;
+    constructor({ code, message, cause, context }: MagmaStreamErrorOptions<T>);
+}
+
 /**
  * Discord.js wrapper for Magmastream.
  */
@@ -3597,5 +3656,5 @@ declare class SeyfertManager extends Manager {
     resolveUser(user: PortableUser | string): Promise<User$3 | PortableUser>;
 }
 
-export { AutoPlayPlatform, AutoPlayUtils, AvailableFilters, DetritusManager, DiscordJSManager, ErisManager, Filters, JSONUtils, JsonQueue, LoadTypes, Manager, ManagerEventTypes, MemoryQueue, Node, OceanicManager, Player, PlayerStateEventTypes, PlayerUtils, Plugin, RedisQueue, Rest, SearchPlatform, SeverityTypes, SeyfertManager, SponsorBlockSegment, StateStorageType, StateTypes, Structure, TrackEndReasonTypes, TrackPartial, TrackSourceTypes, TrackUtils, UseNodeOptions };
+export { AutoPlayPlatform, AutoPlayUtils, AvailableFilters, DetritusManager, DiscordJSManager, ErisManager, Filters, JSONUtils, JsonQueue, LoadTypes, MagmaStreamError, MagmaStreamErrorCode, MagmaStreamErrorNumbers, Manager, ManagerEventTypes, MemoryQueue, Node, OceanicManager, Player, PlayerStateEventTypes, PlayerUtils, Plugin, RedisQueue, Rest, SearchPlatform, SeverityTypes, SeyfertManager, SponsorBlockSegment, StateStorageType, StateTypes, Structure, TrackEndReasonTypes, TrackPartial, TrackSourceTypes, TrackUtils, UseNodeOptions };
 export type { AlbumSearchResult, ArtistSearchResult, CPUStats, DiscordPacket, DistortionOptions, EndSpeakingEventVoiceReceiver, EndSpeakingEventVoiceReceiverData, EqualizerBand, ErrorOrEmptySearchResult, Exception, Extendable, FrameStats, IQueue, JsonConfig, KaraokeOptions, LavaPlayer, LavalinkInfo, LavalinkResponse, LoadType, Lyrics, LyricsEvent, LyricsEventType, LyricsFoundEvent, LyricsLine, LyricsLineEvent, LyricsNotFoundEvent, ManagerEvents, ManagerInitOptions, ManagerOptions, MemoryStats, NodeLinkGetLyrics, NodeLinkGetLyricsEmpty, NodeLinkGetLyricsError, NodeLinkGetLyricsMultiple, NodeLinkGetLyricsSingle, NodeMessage, NodeOptions, NodeStats, PlayOptions, PlayerEvent, PlayerEventType, PlayerEvents, PlayerOptions, PlayerStateUpdateEvent, PlayerUpdateVoiceState, PlaylistData, PlaylistInfoData, PlaylistRawData, PlaylistSearchResult, PodcastSearchResult, PortableUser, RedisConfig, RestPlayOptions, ReverbOptions, RotationOptions, SearchQuery, SearchResult, SearchSearchResult, Severity, ShortSearchResult, ShowSearchResult, Sizes, SponsorBlockChapterStarted, SponsorBlockChaptersLoaded, SponsorBlockSegmentEventType, SponsorBlockSegmentEvents, SponsorBlockSegmentSkipped, SponsorBlockSegmentsLoaded, StartSpeakingEventVoiceReceiver, StartSpeakingEventVoiceReceiverData, StateStorageOptions, StationSearchResult, TimescaleOptions, Track, TrackData, TrackDataInfo, TrackEndEvent, TrackEndReason, TrackExceptionEvent, TrackPluginInfo, TrackSearchResult, TrackSourceName, TrackStartEvent, TrackStuckEvent, UseNodeOption, VibratoOptions, VoicePacket, VoiceReceiverEvent, VoiceServer, VoiceServerUpdate, VoiceState, WebSocketClosedEvent };

package/dist/index.js

@@ -9,6 +9,7 @@ tslib_1.__exportStar(require("./structures/Plugin"), exports);
 tslib_1.__exportStar(require("./statestorage/MemoryQueue"), exports);
 tslib_1.__exportStar(require("./structures/Rest"), exports);
 tslib_1.__exportStar(require("./structures/Utils"), exports);
+tslib_1.__exportStar(require("./structures/MagmastreamError"), exports);
 // wrappers
 tslib_1.__exportStar(require("./wrappers/discord.js"), exports);
 tslib_1.__exportStar(require("./wrappers/eris"), exports);

package/dist/statestorage/JsonQueue.js

@@ -6,6 +6,7 @@ const Enums_1 = require("../structures/Enums");
 const path_1 = tslib_1.__importDefault(require("path"));
 const fs_1 = require("fs");
 const Utils_1 = require("../structures/Utils");
+const MagmastreamError_1 = require("../structures/MagmastreamError");
 /**
  * The player's queue, the `current` property is the currently playing track, think of the rest as the up-coming tracks.
  */
@@ -32,82 +33,106 @@ class JsonQueue {
      * @param [offset=null] The position to add the track(s) at. If not provided, the track(s) will be added at the end of the queue.
      */
     async add(track, offset) {
-        const isArray = Array.isArray(track);
-        const inputTracks = isArray ? track : [track];
-        const tracks = [...inputTracks];
-        const queue = await this.getQueue();
-        const oldPlayer = this.manager.players.get(this.guildId) ? { ...this.manager.players.get(this.guildId) } : null;
-        // Set first track as current if none is active
-        if (!(await this.getCurrent())) {
-            const current = tracks.shift();
-            if (current) {
-                await this.setCurrent(current);
+        try {
+            const isArray = Array.isArray(track);
+            const inputTracks = isArray ? track : [track];
+            const tracks = [...inputTracks];
+            const queue = await this.getQueue();
+            const oldPlayer = this.manager.players.get(this.guildId) ? { ...this.manager.players.get(this.guildId) } : null;
+            // Set first track as current if none is active
+            if (!(await this.getCurrent())) {
+                const current = tracks.shift();
+                if (current) {
+                    await this.setCurrent(current);
+                }
             }
-        }
-        if (typeof offset === "number" && !isNaN(offset)) {
-            queue.splice(offset, 0, ...tracks);
-        }
-        else {
-            queue.push(...tracks);
-        }
-        await this.setQueue(queue);
-        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[JSONQUEUE] Added ${tracks.length} track(s) to queue`);
-        if (this.manager.players.has(this.guildId) && this.manager.players.get(this.guildId).isAutoplay) {
-            if (!isArray) {
-                const AutoplayUser = (await this.manager.players.get(this.guildId).get("Internal_AutoplayUser"));
-                if (AutoplayUser && AutoplayUser.id === track.requester.id) {
-                    this.manager.emit(Enums_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this.manager.players.get(this.guildId), {
-                        changeType: Enums_1.PlayerStateEventTypes.QueueChange,
-                        details: {
-                            type: "queue",
-                            action: "autoPlayAdd",
-                            tracks: [track],
-                        },
-                    });
-                    return;
+            if (typeof offset === "number" && !isNaN(offset)) {
+                queue.splice(offset, 0, ...tracks);
+            }
+            else {
+                queue.push(...tracks);
+            }
+            await this.setQueue(queue);
+            this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[JSONQUEUE] Added ${tracks.length} track(s) to queue`);
+            if (this.manager.players.has(this.guildId) && this.manager.players.get(this.guildId).isAutoplay) {
+                if (!isArray) {
+                    const AutoplayUser = (await this.manager.players.get(this.guildId).get("Internal_AutoplayUser"));
+                    if (AutoplayUser && AutoplayUser.id === track.requester.id) {
+                        this.manager.emit(Enums_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this.manager.players.get(this.guildId), {
+                            changeType: Enums_1.PlayerStateEventTypes.QueueChange,
+                            details: {
+                                type: "queue",
+                                action: "autoPlayAdd",
+                                tracks: [track],
+                            },
+                        });
+                        return;
+                    }
                 }
             }
+            this.manager.emit(Enums_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this.manager.players.get(this.guildId), {
+                changeType: Enums_1.PlayerStateEventTypes.QueueChange,
+                details: {
+                    type: "queue",
+                    action: "add",
+                    tracks,
+                },
+            });
+        }
+        catch (err) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.QUEUE_JSON_ERROR,
+                message: `Failed to add tracks to JSON queue for guild ${this.guildId}: ${err.message}`,
+            });
         }
-        this.manager.emit(Enums_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this.manager.players.get(this.guildId), {
-            changeType: Enums_1.PlayerStateEventTypes.QueueChange,
-            details: {
-                type: "queue",
-                action: "add",
-                tracks,
-            },
-        });
     }
     /**
      * @param track The track to add.
      */
     async addPrevious(track) {
-        const max = this.manager.options.maxPreviousTracks;
-        const tracks = Array.isArray(track) ? track : [track];
-        if (!tracks.length)
-            return;
-        const current = await this.getPrevious();
-        const newTracks = tracks.filter((t) => !current.some((p) => p.identifier === t.identifier));
-        if (!newTracks.length)
-            return;
-        const updated = [...newTracks.reverse(), ...current];
-        const trimmed = updated.slice(0, max);
-        await this.writeJSON(this.previousPath, trimmed);
+        try {
+            const max = this.manager.options.maxPreviousTracks;
+            const tracks = Array.isArray(track) ? track : [track];
+            if (!tracks.length)
+                return;
+            const current = await this.getPrevious();
+            const newTracks = tracks.filter((t) => !current.some((p) => p.identifier === t.identifier));
+            if (!newTracks.length)
+                return;
+            const updated = [...current, ...newTracks];
+            const trimmed = updated.slice(-max);
+            await this.writeJSON(this.previousPath, trimmed);
+        }
+        catch (err) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.QUEUE_JSON_ERROR,
+                message: `Failed to add tracks to JSON queue for guild ${this.guildId}: ${err.message}`,
+            });
+        }
     }
     /**
      * Clears the queue.
      */
     async clear() {
-        const oldPlayer = this.manager.players.get(this.guildId) ? { ...this.manager.players.get(this.guildId) } : null;
-        await this.deleteFile(this.queuePath);
-        this.manager.emit(Enums_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this.manager.players.get(this.guildId), {
-            changeType: Enums_1.PlayerStateEventTypes.QueueChange,
-            details: {
-                type: "queue",
-                action: "clear",
-                tracks: [],
-            },
-        });
-        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[JSONQUEUE] Cleared the queue for: ${this.guildId}`);
+        try {
+            const oldPlayer = this.manager.players.get(this.guildId) ? { ...this.manager.players.get(this.guildId) } : null;
+            await this.deleteFile(this.queuePath);
+            this.manager.emit(Enums_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this.manager.players.get(this.guildId), {
+                changeType: Enums_1.PlayerStateEventTypes.QueueChange,
+                details: {
+                    type: "queue",
+                    action: "clear",
+                    tracks: [],
+                },
+            });
+            this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[JSONQUEUE] Cleared the queue for: ${this.guildId}`);
+        }
+        catch (err) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.QUEUE_JSON_ERROR,
+                message: `Failed to clear JSON queue for guild ${this.guildId}: ${err.message}`,
+            });
+        }
     }
     /**
      * Clears the previous tracks.
@@ -119,28 +144,52 @@ class JsonQueue {
      * Removes the first track from the queue.
      */
     async dequeue() {
-        const queue = await this.getQueue();
-        const track = queue.shift();
-        await this.setQueue(queue);
-        return track;
+        try {
+            const queue = await this.getQueue();
+            const track = queue.shift();
+            await this.setQueue(queue);
+            return track;
+        }
+        catch (err) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.QUEUE_JSON_ERROR,
+                message: `Failed to dequeue track for guild ${this.guildId}: ${err.message}`,
+            });
+        }
     }
     /**
      * @returns The total duration of the queue.
      */
     async duration() {
-        const queue = await this.getQueue();
-        const current = await this.getCurrent();
-        const currentDuration = current?.duration || 0;
-        const total = queue.reduce((acc, track) => acc + (track.duration || 0), currentDuration);
-        return total;
+        try {
+            const queue = await this.getQueue();
+            const current = await this.getCurrent();
+            const currentDuration = current?.duration || 0;
+            const total = queue.reduce((acc, track) => acc + (track.duration || 0), currentDuration);
+            return total;
+        }
+        catch (err) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.QUEUE_JSON_ERROR,
+                message: `Failed to get duration for guild ${this.guildId}: ${err.message}`,
+            });
+        }
     }
     /**
      * Adds a track to the front of the queue.
      */
     async enqueueFront(track) {
-        const tracks = Array.isArray(track) ? track : [track];
-        const queue = await this.getQueue();
-        await this.setQueue([...tracks.reverse(), ...queue]);
+        try {
+            const tracks = Array.isArray(track) ? track : [track];
+            const queue = await this.getQueue();
+            await this.setQueue([...tracks.reverse(), ...queue]);
+        }
+        catch (err) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.QUEUE_JSON_ERROR,
+                message: `Failed to enqueue front track for guild ${this.guildId}: ${err.message}`,
+            });
+        }
     }
     /**
      * Tests whether all elements in the queue pass the test implemented by the provided function.
@@ -211,76 +260,100 @@ class JsonQueue {
      * @returns The newest track.
      */
     async popPrevious() {
-        const current = await this.getPrevious();
-        if (!current.length)
-            return null;
-        const popped = current.shift();
-        await this.writeJSON(this.previousPath, current);
-        return popped;
+        try {
+            const current = await this.getPrevious();
+            if (!current.length)
+                return null;
+            const popped = current.pop();
+            await this.writeJSON(this.previousPath, current);
+            return popped;
+        }
+        catch (err) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.QUEUE_JSON_ERROR,
+                message: `Failed to pop previous track for guild ${this.guildId}: ${err.message}`,
+            });
+        }
     }
     async remove(startOrPos = 0, end) {
-        const oldPlayer = this.manager.players.get(this.guildId) ? { ...this.manager.players.get(this.guildId) } : null;
-        const queue = await this.getQueue();
-        let removed = [];
-        if (typeof end === "number") {
-            if (startOrPos >= end || startOrPos >= queue.length)
-                throw new RangeError("Invalid range.");
-            removed = queue.splice(startOrPos, end - startOrPos);
+        try {
+            const oldPlayer = this.manager.players.get(this.guildId) ? { ...this.manager.players.get(this.guildId) } : null;
+            const queue = await this.getQueue();
+            let removed = [];
+            if (typeof end === "number") {
+                if (startOrPos >= end || startOrPos >= queue.length)
+                    throw new RangeError("Invalid range.");
+                removed = queue.splice(startOrPos, end - startOrPos);
+            }
+            else {
+                removed = queue.splice(startOrPos, 1);
+            }
+            await this.setQueue(queue);
+            this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[JSONQUEUE] Removed ${removed.length} track(s) from position ${startOrPos}${end ? ` to ${end}` : ""}`);
+            this.manager.emit(Enums_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this.manager.players.get(this.guildId), {
+                changeType: Enums_1.PlayerStateEventTypes.QueueChange,
+                details: {
+                    type: "queue",
+                    action: "remove",
+                    tracks: removed,
+                },
+            });
+            return removed;
         }
-        else {
-            removed = queue.splice(startOrPos, 1);
+        catch (err) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.QUEUE_JSON_ERROR,
+                message: `Failed to remove track for guild ${this.guildId}: ${err.message}`,
+            });
         }
-        await this.setQueue(queue);
-        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[JSONQUEUE] Removed ${removed.length} track(s) from position ${startOrPos}${end ? ` to ${end}` : ""}`);
-        this.manager.emit(Enums_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this.manager.players.get(this.guildId), {
-            changeType: Enums_1.PlayerStateEventTypes.QueueChange,
-            details: {
-                type: "queue",
-                action: "remove",
-                tracks: removed,
-            },
-        });
-        return removed;
     }
     /**
      * Shuffles the queue by round-robin.
      */
     async roundRobinShuffle() {
-        const oldPlayer = this.manager.players.get(this.guildId) ? { ...this.manager.players.get(this.guildId) } : null;
-        const queue = await this.getQueue();
-        const userMap = new Map();
-        for (const track of queue) {
-            const userId = track.requester.id;
-            if (!userMap.has(userId))
-                userMap.set(userId, []);
-            userMap.get(userId).push(track);
-        }
-        // Shuffle each user's tracks
-        for (const tracks of userMap.values()) {
-            for (let i = tracks.length - 1; i > 0; i--) {
-                const j = Math.floor(Math.random() * (i + 1));
-                [tracks[i], tracks[j]] = [tracks[j], tracks[i]];
+        try {
+            const oldPlayer = this.manager.players.get(this.guildId) ? { ...this.manager.players.get(this.guildId) } : null;
+            const queue = await this.getQueue();
+            const userMap = new Map();
+            for (const track of queue) {
+                const userId = track.requester.id;
+                if (!userMap.has(userId))
+                    userMap.set(userId, []);
+                userMap.get(userId).push(track);
             }
-        }
-        const users = [...userMap.keys()];
-        const queues = users.map((id) => userMap.get(id));
-        const shuffledQueue = [];
-        while (queues.some((q) => q.length > 0)) {
-            for (const q of queues) {
-                const track = q.shift();
-                if (track)
-                    shuffledQueue.push(track);
+            // Shuffle each user's tracks
+            for (const tracks of userMap.values()) {
+                for (let i = tracks.length - 1; i > 0; i--) {
+                    const j = Math.floor(Math.random() * (i + 1));
+                    [tracks[i], tracks[j]] = [tracks[j], tracks[i]];
+                }
+            }
+            const users = [...userMap.keys()];
+            const queues = users.map((id) => userMap.get(id));
+            const shuffledQueue = [];
+            while (queues.some((q) => q.length > 0)) {
+                for (const q of queues) {
+                    const track = q.shift();
+                    if (track)
+                        shuffledQueue.push(track);
+                }
             }
+            await this.setQueue(shuffledQueue);
+            this.manager.emit(Enums_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this.manager.players.get(this.guildId), {
+                changeType: Enums_1.PlayerStateEventTypes.QueueChange,
+                details: {
+                    type: "queue",
+                    action: "roundRobin",
+                },
+            });
+            this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[JSONQUEUE] roundRobinShuffled the queue for: ${this.guildId}`);
+        }
+        catch (err) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.QUEUE_JSON_ERROR,
+                message: `Failed to round robin shuffle queue for guild ${this.guildId}: ${err.message}`,
+            });
         }
-        await this.setQueue(shuffledQueue);
-        this.manager.emit(Enums_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this.manager.players.get(this.guildId), {
-            changeType: Enums_1.PlayerStateEventTypes.QueueChange,
-            details: {
-                type: "queue",
-                action: "roundRobin",
-            },
-        });
-        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[JSONQUEUE] roundRobinShuffled the queue for: ${this.guildId}`);
     }
     /**
      * @param track The track to set.
@@ -306,21 +379,29 @@ class JsonQueue {
      * Shuffles the queue.
      */
     async shuffle() {
-        const oldPlayer = this.manager.players.get(this.guildId) ? { ...this.manager.players.get(this.guildId) } : null;
-        const queue = await this.getQueue();
-        for (let i = queue.length - 1; i > 0; i--) {
-            const j = Math.floor(Math.random() * (i + 1));
-            [queue[i], queue[j]] = [queue[j], queue[i]];
+        try {
+            const oldPlayer = this.manager.players.get(this.guildId) ? { ...this.manager.players.get(this.guildId) } : null;
+            const queue = await this.getQueue();
+            for (let i = queue.length - 1; i > 0; i--) {
+                const j = Math.floor(Math.random() * (i + 1));
+                [queue[i], queue[j]] = [queue[j], queue[i]];
+            }
+            await this.setQueue(queue);
+            this.manager.emit(Enums_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this.manager.players.get(this.guildId), {
+                changeType: Enums_1.PlayerStateEventTypes.QueueChange,
+                details: {
+                    type: "queue",
+                    action: "shuffle",
+                },
+            });
+            this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[JSONQUEUE] Shuffled the queue for: ${this.guildId}`);
+        }
+        catch (err) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.QUEUE_JSON_ERROR,
+                message: `Failed to shuffle queue for guild ${this.guildId}: ${err.message}`,
+            });
         }
-        await this.setQueue(queue);
-        this.manager.emit(Enums_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this.manager.players.get(this.guildId), {
-            changeType: Enums_1.PlayerStateEventTypes.QueueChange,
-            details: {
-                type: "queue",
-                action: "shuffle",
-            },
-        });
-        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[JSONQUEUE] Shuffled the queue for: ${this.guildId}`);
     }
     /**
      * @returns The size of the queue.
@@ -347,32 +428,40 @@ class JsonQueue {
      * Shuffles the queue by user.
      */
     async userBlockShuffle() {
-        const oldPlayer = this.manager.players.get(this.guildId) ? { ...this.manager.players.get(this.guildId) } : null;
-        const queue = await this.getQueue();
-        const userMap = new Map();
-        for (const track of queue) {
-            const userId = track.requester.id;
-            if (!userMap.has(userId))
-                userMap.set(userId, []);
-            userMap.get(userId).push(track);
-        }
-        const shuffledQueue = [];
-        while (shuffledQueue.length < queue.length) {
-            for (const [, tracks] of userMap) {
-                const track = tracks.shift();
-                if (track)
-                    shuffledQueue.push(track);
+        try {
+            const oldPlayer = this.manager.players.get(this.guildId) ? { ...this.manager.players.get(this.guildId) } : null;
+            const queue = await this.getQueue();
+            const userMap = new Map();
+            for (const track of queue) {
+                const userId = track.requester.id;
+                if (!userMap.has(userId))
+                    userMap.set(userId, []);
+                userMap.get(userId).push(track);
             }
+            const shuffledQueue = [];
+            while (shuffledQueue.length < queue.length) {
+                for (const [, tracks] of userMap) {
+                    const track = tracks.shift();
+                    if (track)
+                        shuffledQueue.push(track);
+                }
+            }
+            await this.setQueue(shuffledQueue);
+            this.manager.emit(Enums_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this.manager.players.get(this.guildId), {
+                changeType: Enums_1.PlayerStateEventTypes.QueueChange,
+                details: {
+                    type: "queue",
+                    action: "userBlock",
+                },
+            });
+            this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[JSONQUEUE] userBlockShuffled the queue for: ${this.guildId}`);
+        }
+        catch (err) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.QUEUE_JSON_ERROR,
+                message: `Failed to user block shuffle queue for guild ${this.guildId}: ${err.message}`,
+            });
         }
-        await this.setQueue(shuffledQueue);
-        this.manager.emit(Enums_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this.manager.players.get(this.guildId), {
-            changeType: Enums_1.PlayerStateEventTypes.QueueChange,
-            details: {
-                type: "queue",
-                action: "userBlock",
-            },
-        });
-        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[JSONQUEUE] userBlockShuffled the queue for: ${this.guildId}`);
     }
     // #endregion Public
     // #region Private
@@ -391,6 +480,10 @@ class JsonQueue {
         }
         catch {
             this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[JSONQUEUE] Failed to delete file: ${filePath}`);
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.QUEUE_JSON_ERROR,
+                message: `Failed to delete file: ${filePath}`,
+            });
         }
     }
     /**
@@ -427,7 +520,16 @@ class JsonQueue {
             const raw = await fs_1.promises.readFile(filePath, "utf-8");
             return JSON.parse(raw);
         }
-        catch {
+        catch (err) {
+            const error = err instanceof MagmastreamError_1.MagmaStreamError
+                ? err
+                : new MagmastreamError_1.MagmaStreamError({
+                    code: Enums_1.MagmaStreamErrorCode.QUEUE_JSON_ERROR,
+                    message: "An unknown error occurred.",
+                    cause: err,
+                    context: { stage: "SIGINT" },
+                });
+            console.error(error);
             return null;
         }
     }