magmastream 2.9.3-dev.2 → 2.9.3-dev.21

package/dist/structures/Player.js

@@ -82,7 +82,7 @@ class Player {
                 message: "Manager instance is required.",
             });
         }
-        this.clusterId = this.manager.options.clusterId || 0;
+        this.clusterId = this.manager.options.clusterId ?? 0;
         // Check the player options for errors.
         (0, playerCheck_1.default)(options);
         this.options = {
@@ -260,21 +260,30 @@ class Player {
      */
     async destroy(disconnect = true) {
         this.state = Enums_1.StateTypes.Destroying;
+        if (this.dynamicLoopInterval) {
+            clearInterval(this.dynamicLoopInterval);
+            this.dynamicLoopInterval = null;
+        }
+        if (this.voiceReceiverReconnectTimeout) {
+            clearTimeout(this.voiceReceiverReconnectTimeout);
+            this.voiceReceiverReconnectTimeout = null;
+        }
+        if (this.voiceReceiverWsClient) {
+            this.voiceReceiverWsClient.removeAllListeners();
+            this.voiceReceiverWsClient.close();
+            this.voiceReceiverWsClient = null;
+        }
         if (disconnect) {
-            await this.disconnect().catch((err) => {
-                console.warn(`[Player#destroy] Failed to disconnect player ${this.guildId}:`, err);
-            });
+            await this.disconnect().catch(() => { });
         }
-        await this.node.rest.destroyPlayer(this.guildId).catch((err) => {
-            console.warn(`[Player#destroy] REST failed to destroy player ${this.guildId}:`, err);
-        });
-        await this.queue.clear();
-        await this.queue.clearPrevious();
-        await this.queue.setCurrent(null);
+        await this.node.rest.destroyPlayer(this.guildId).catch(() => { });
+        await this.queue.destroy();
+        this.nowPlayingMessage = undefined;
         this.manager.emit(Enums_1.ManagerEventTypes.PlayerDestroy, this);
         const deleted = this.manager.players.delete(this.guildId);
-        if (this.manager.options.stateStorage.deleteInactivePlayers)
+        if (this.manager.options.stateStorage.deleteInactivePlayers) {
             await this.manager.cleanupInactivePlayer(this.guildId);
+        }
         return deleted;
     }
     /**
@@ -806,11 +815,8 @@ class Player {
             if (currentPlayingTrack) {
                 await this.queue.add(currentPlayingTrack, 0);
             }
-            await this.play(lastTrack);
-        }
-        else {
-            await this.play(lastTrack);
         }
+        await this.play(lastTrack);
         this.manager.emit(Enums_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this, {
             changeType: Enums_1.PlayerStateEventTypes.TrackChange,
             details: {
@@ -922,7 +928,8 @@ class Player {
             const sessionId = this.voiceState?.sessionId;
             const token = this.voiceState?.event?.token;
             const endpoint = this.voiceState?.event?.endpoint;
-            if (!sessionId || !token || !endpoint) {
+            const channelId = this.voiceState?.channelId;
+            if (!sessionId || !token || !endpoint || !channelId) {
                 this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[MANAGER] Voice state is not properly initialized for player ${this.guildId}. The bot might not be connected to a voice channel.`);
                 throw new MagmastreamError_1.MagmaStreamError({
                     code: Enums_1.MagmaStreamErrorCode.PLAYER_STATE_INVALID,
@@ -936,7 +943,7 @@ class Player {
             this.manager.players.set(this.guildId, this);
             await this.node.rest.updatePlayer({
                 guildId: this.guildId,
-                data: { paused: this.paused, volume: this.volume, position: playerPosition, encodedTrack: currentTrack?.track, voice: { token, endpoint, sessionId } },
+                data: { paused: this.paused, volume: this.volume, position: playerPosition, encodedTrack: currentTrack?.track, voice: { token, endpoint, sessionId, channelId } },
             });
             await this.filters.updateFilters();
         }
@@ -953,113 +960,6 @@ class Player {
             console.error(error);
         }
     }
-    /**
-     * Transfers the player to a new server. If the player already exists on the new server
-     * and force is false, this method will return the existing player. Otherwise, a new player
-     * will be created and the current player will be destroyed.
-     * @param {PlayerOptions} newOptions - The new options for the player.
-     * @param {boolean} force - Whether to force the creation of a new player.
-     * @returns {Promise<Player>} - The new player instance.
-     */
-    async switchGuild(newOptions, force = false) {
-        if (!newOptions.guildId) {
-            throw new MagmastreamError_1.MagmaStreamError({
-                code: Enums_1.MagmaStreamErrorCode.PLAYER_INVALID_CONFIG,
-                message: "guildId is required for switchGuild",
-            });
-        }
-        if (!newOptions.voiceChannelId) {
-            throw new MagmastreamError_1.MagmaStreamError({
-                code: Enums_1.MagmaStreamErrorCode.PLAYER_INVALID_CONFIG,
-                message: "voiceChannelId is required for switchGuild",
-            });
-        }
-        if (!newOptions.textChannelId) {
-            throw new MagmastreamError_1.MagmaStreamError({
-                code: Enums_1.MagmaStreamErrorCode.PLAYER_INVALID_CONFIG,
-                message: "textChannelId is required for switchGuild",
-            });
-        }
-        // Check if a player already exists for the new guild
-        let newPlayer = this.manager.getPlayer(newOptions.guildId);
-        // If the player already exists and force is false, return the existing player
-        if (newPlayer && !force)
-            return newPlayer;
-        const oldPlayerProperties = {
-            paused: this.paused,
-            selfMute: this.options.selfMute,
-            selfDeafen: this.options.selfDeafen,
-            volume: this.volume,
-            position: this.position,
-            queue: {
-                current: await this.queue.getCurrent(),
-                tracks: [...(await this.queue.getTracks())],
-                previous: [...(await this.queue.getPrevious())],
-            },
-            trackRepeat: this.trackRepeat,
-            queueRepeat: this.queueRepeat,
-            dynamicRepeat: this.dynamicRepeat,
-            dynamicRepeatIntervalMs: this.dynamicRepeatIntervalMs,
-            ClientUser: this.get("Internal_AutoplayUser"),
-            filters: this.filters,
-            nowPlayingMessage: this.nowPlayingMessage,
-            isAutoplay: this.isAutoplay,
-            applyVolumeAsFilter: this.options.applyVolumeAsFilter,
-        };
-        // If force is true, destroy the existing player for the new guild
-        if (force && newPlayer) {
-            await newPlayer.destroy();
-        }
-        newOptions.nodeIdentifier = newOptions.nodeIdentifier ?? this.options.nodeIdentifier;
-        newOptions.selfDeafen = newOptions.selfDeafen ?? oldPlayerProperties.selfDeafen;
-        newOptions.selfMute = newOptions.selfMute ?? oldPlayerProperties.selfMute;
-        newOptions.volume = newOptions.volume ?? oldPlayerProperties.volume;
-        newOptions.applyVolumeAsFilter = newOptions.applyVolumeAsFilter ?? oldPlayerProperties.applyVolumeAsFilter;
-        // Deep clone the current player
-        const clonedPlayer = this.manager.create(newOptions);
-        // Connect the cloned player to the new voice channel
-        clonedPlayer.connect();
-        // Update the player's state on the Lavalink node
-        await clonedPlayer.node.rest.updatePlayer({
-            guildId: clonedPlayer.guildId,
-            data: {
-                paused: oldPlayerProperties.paused,
-                volume: oldPlayerProperties.volume,
-                position: oldPlayerProperties.position,
-                encodedTrack: oldPlayerProperties.queue.current?.track,
-            },
-        });
-        await clonedPlayer.queue.setCurrent(oldPlayerProperties.queue.current);
-        await clonedPlayer.queue.addPrevious(oldPlayerProperties.queue.previous);
-        await clonedPlayer.queue.add(oldPlayerProperties.queue.tracks);
-        clonedPlayer.filters = oldPlayerProperties.filters;
-        clonedPlayer.isAutoplay = oldPlayerProperties.isAutoplay;
-        clonedPlayer.nowPlayingMessage = oldPlayerProperties.nowPlayingMessage;
-        clonedPlayer.trackRepeat = oldPlayerProperties.trackRepeat;
-        clonedPlayer.queueRepeat = oldPlayerProperties.queueRepeat;
-        clonedPlayer.dynamicRepeat = oldPlayerProperties.dynamicRepeat;
-        clonedPlayer.dynamicRepeatIntervalMs = oldPlayerProperties.dynamicRepeatIntervalMs;
-        clonedPlayer.set("Internal_AutoplayUser", oldPlayerProperties.ClientUser);
-        clonedPlayer.paused = oldPlayerProperties.paused;
-        // Update filters for the cloned player
-        await clonedPlayer.filters.updateFilters();
-        // Debug information
-        const debugInfo = {
-            success: true,
-            message: `Transferred ${await clonedPlayer.queue.size()} tracks successfully to <#${newOptions.voiceChannelId}> bound to <#${newOptions.textChannelId}>.`,
-            player: {
-                guildId: clonedPlayer.guildId,
-                voiceChannelId: clonedPlayer.voiceChannelId,
-                textChannelId: clonedPlayer.textChannelId,
-                volume: clonedPlayer.volume,
-                playing: clonedPlayer.playing,
-                queueSize: clonedPlayer.queue.size,
-            },
-        };
-        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[PLAYER] Transferred player to a new server: ${Utils_1.JSONUtils.safe(debugInfo, 2)}.`);
-        // Return the cloned player
-        return clonedPlayer;
-    }
     /**
      * Retrieves the data associated with the player.
      * @returns {Record<string, unknown>} - The data associated with the player.
@@ -1074,6 +974,13 @@ class Player {
     getDynamicLoopIntervalPublic() {
         return this.dynamicLoopInterval;
     }
+    /**
+     * Retrieves the data associated with the player.
+     * @returns {Record<string, unknown>} - The data associated with the player.
+     */
+    getSerializableData() {
+        return { ...this.data };
+    }
     /**
      * Retrieves the current lyrics for the playing track.
      * @param skipTrackSource - Indicates whether to skip the track source when fetching lyrics.

package/dist/structures/Rest.js

@@ -104,35 +104,55 @@ class Rest {
             },
             data: body,
             timeout: this.node.options.apiRequestTimeoutMs,
+            validateStatus: () => true,
         };
+        let response;
         try {
-            const response = await (0, axios_1.default)(config);
-            return response.data;
+            response = await (0, axios_1.default)(config);
         }
         catch (err) {
-            const error = err;
-            if (!error.response) {
-                throw new MagmastreamError_1.MagmaStreamError({
-                    code: Enums_1.MagmaStreamErrorCode.REST_REQUEST_FAILED,
-                    message: `No response from node ${this.node.options.identifier}: ${error.message}`,
-                });
-            }
-            const data = error.response.data;
-            if (data?.message === "Guild not found") {
-                return [];
-            }
-            if (error.response.status === 401) {
-                throw new MagmastreamError_1.MagmaStreamError({
-                    code: Enums_1.MagmaStreamErrorCode.REST_UNAUTHORIZED,
-                    message: `Unauthorized access to node ${this.node.options.identifier}`,
-                });
-            }
-            const dataMessage = typeof data === "string" ? data : data?.message ? data.message : Utils_1.JSONUtils.safe(data, 2);
+            const message = err instanceof Error ? err.message : "Unknown error";
             throw new MagmastreamError_1.MagmaStreamError({
                 code: Enums_1.MagmaStreamErrorCode.REST_REQUEST_FAILED,
-                message: `Request to node ${this.node.options.identifier} failed with status ${error.response.status}: ${dataMessage}`,
+                message: `No response from node ${this.node.options.identifier}: ${message}`,
             });
         }
+        const { status, data } = response;
+        if (status >= 200 && status < 300) {
+            return data;
+        }
+        // Lavalink sometimes returns "Guild not found" for inactive players
+        if (status === 404 && data?.message === "Guild not found") {
+            return [];
+        }
+        if (status === 401) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.REST_UNAUTHORIZED,
+                message: `Unauthorized access to node ${this.node.options.identifier}`,
+            });
+        }
+        if (status >= 400 && status < 500) {
+            const message = typeof data === "string"
+                ? data
+                : typeof data === "object" && data !== null && "message" in data && typeof data.message === "string"
+                    ? data.message
+                    : "Unknown client error";
+            return {
+                status,
+                error: true,
+                message,
+                data,
+            };
+        }
+        const safeMessage = typeof data === "string"
+            ? data
+            : typeof data === "object" && data !== null && "message" in data && typeof data.message === "string"
+                ? data.message
+                : Utils_1.JSONUtils.safe(data, 2);
+        throw new MagmastreamError_1.MagmaStreamError({
+            code: Enums_1.MagmaStreamErrorCode.REST_REQUEST_FAILED,
+            message: `Request to node ${this.node.options.identifier} failed (${status}): ${safeMessage}`,
+        });
     }
     /**
      * Sends a GET request to the specified endpoint and returns the response data.

package/dist/structures/Utils.js

@@ -9,9 +9,11 @@ const Enums_1 = require("./Enums");
 const path_1 = tslib_1.__importDefault(require("path"));
 const safe_stable_stringify_1 = tslib_1.__importDefault(require("safe-stable-stringify"));
 const MagmastreamError_1 = require("./MagmastreamError");
+// import { isPlainObject } from "lodash";
 // import playwright from "playwright";
 /** @hidden */
 const SIZES = ["0", "1", "2", "3", "default", "mqdefault", "hqdefault", "maxresdefault"];
+const REQUIRED_TRACK_KEYS = ["track", "title", "uri"];
 class TrackUtils {
     static trackPartial = null;
     static manager;
@@ -39,19 +41,12 @@ class TrackUtils {
         const defaultProperties = [
             Enums_1.TrackPartial.Track,
             Enums_1.TrackPartial.Title,
-            Enums_1.TrackPartial.Identifier,
             Enums_1.TrackPartial.Author,
             Enums_1.TrackPartial.Duration,
-            Enums_1.TrackPartial.Isrc,
-            Enums_1.TrackPartial.IsSeekable,
-            Enums_1.TrackPartial.IsStream,
             Enums_1.TrackPartial.Uri,
-            Enums_1.TrackPartial.ArtworkUrl,
             Enums_1.TrackPartial.SourceName,
-            Enums_1.TrackPartial.ThumbNail,
+            Enums_1.TrackPartial.ArtworkUrl,
             Enums_1.TrackPartial.Requester,
-            Enums_1.TrackPartial.PluginInfo,
-            Enums_1.TrackPartial.CustomData,
         ];
         /** The array of property names that will be removed from the Track class */
         this.trackPartial = Array.from(new Set([...defaultProperties, ...partial]));
@@ -61,33 +56,39 @@ class TrackUtils {
     }
     /**
      * Checks if the provided argument is a valid Track.
-     * If provided an array then every element will be checked.
-     * @param trackOrTracks The Track or array of Tracks to check.
+     * @param value The value to check.
      * @returns {boolean} Whether the provided argument is a valid Track.
      */
-    static validate(trackOrTracks) {
-        if (typeof trackOrTracks !== "object" || trackOrTracks === null) {
+    static isTrack(track) {
+        if (typeof track !== "object" || track === null)
             return false;
-        }
-        const isValidTrack = (track) => {
-            if (typeof track !== "object" || track === null) {
-                return false;
-            }
-            const t = track;
-            return (typeof t.track === "string" && typeof t.title === "string" && typeof t.identifier === "string" && typeof t.isrc === "string" && typeof t.uri === "string");
-        };
-        if (Array.isArray(trackOrTracks)) {
-            return trackOrTracks.every(isValidTrack);
-        }
-        return isValidTrack(trackOrTracks);
+        const t = track;
+        return REQUIRED_TRACK_KEYS.every((key) => typeof t[key] === "string");
+    }
+    /**
+     * Checks if the provided argument is a valid Track array.
+     * @param value The value to check.
+     * @returns {boolean} Whether the provided argument is a valid Track array.
+     */
+    static isTrackArray(value) {
+        return Array.isArray(value) && value.every(this.isTrack);
+    }
+    /**
+     * Checks if the provided argument is a valid Track or Track array.
+     * @param value The value to check.
+     * @returns {boolean} Whether the provided argument is a valid Track or Track array.
+     */
+    static validate(value) {
+        return this.isTrack(value) || this.isTrackArray(value);
     }
     /**
      * Builds a Track from the raw data from Lavalink and a optional requester.
      * @param data The raw data from Lavalink to build the Track from.
      * @param requester The user who requested the track, if any.
+     * @param isAutoPlay Whether the track is autoplayed. Defaults to false.
      * @returns The built Track.
      */
-    static build(data, requester) {
+    static build(data, requester, isAutoplay = false) {
         if (typeof data === "undefined") {
             throw new MagmastreamError_1.MagmaStreamError({
                 code: Enums_1.MagmaStreamErrorCode.UTILS_TRACK_BUILD_FAILED,
@@ -138,6 +139,7 @@ class TrackUtils {
                 requester: requester,
                 pluginInfo: data.pluginInfo,
                 customData: {},
+                isAutoplay: isAutoplay,
             };
             track.displayThumbnail = track.displayThumbnail.bind(track);
             if (this.trackPartial) {
@@ -542,8 +544,7 @@ class AutoPlayUtils {
         return typeof data === "object" && data !== null && "encoded" in data && "info" in data;
     }
     static isTrackDataArray(data) {
-        return (Array.isArray(data) &&
-            data.every((track) => typeof track === "object" && track !== null && "encoded" in track && "info" in track && typeof track.encoded === "string"));
+        return (Array.isArray(data) && data.every((track) => typeof track === "object" && track !== null && "encoded" in track && "info" in track && typeof track.encoded === "string"));
     }
     static buildTracksFromResponse(recommendedResult, requester) {
         if (!recommendedResult)
@@ -560,7 +561,7 @@ class AutoPlayUtils {
                         context: { recommendedResult },
                     });
                 }
-                return [TrackUtils.build(data, requester)];
+                return [TrackUtils.build(data, requester, true)];
             }
             case Enums_1.LoadTypes.Short:
             case Enums_1.LoadTypes.Search: {
@@ -572,7 +573,7 @@ class AutoPlayUtils {
                         context: { recommendedResult },
                     });
                 }
-                return data.map((d) => TrackUtils.build(d, requester));
+                return data.map((d) => TrackUtils.build(d, requester, true));
             }
             case Enums_1.LoadTypes.Album:
             case Enums_1.LoadTypes.Artist:
@@ -582,7 +583,7 @@ class AutoPlayUtils {
             case Enums_1.LoadTypes.Playlist: {
                 const data = recommendedResult.data;
                 if (this.isPlaylistRawData(data)) {
-                    return data.tracks.map((d) => TrackUtils.build(d, requester));
+                    return data.tracks.map((d) => TrackUtils.build(d, requester, true));
                 }
                 throw new MagmastreamError_1.MagmaStreamError({
                     code: Enums_1.MagmaStreamErrorCode.UTILS_AUTOPLAY_BUILD_FAILED,
@@ -622,64 +623,114 @@ class PlayerUtils {
      * @returns The serialized Player instance
      */
     static async serializePlayer(player) {
+        const isNonSerializable = (value) => {
+            if (typeof value === "function" || typeof value === "symbol")
+                return true;
+            if (typeof value === "object" && value !== null) {
+                const ctorName = value.constructor?.name ?? "";
+                return (value instanceof Map ||
+                    value instanceof Set ||
+                    value instanceof WeakMap ||
+                    value instanceof WeakSet ||
+                    ctorName === "Timeout" ||
+                    ctorName === "Socket" ||
+                    ctorName === "TLSSocket" ||
+                    ctorName === "EventEmitter");
+            }
+            return false;
+        };
+        const safeSerialize = (obj) => {
+            if (!obj || typeof obj !== "object")
+                return obj;
+            const result = {};
+            for (const [k, v] of Object.entries(obj)) {
+                if (!isNonSerializable(v)) {
+                    result[k] = v;
+                }
+            }
+            return result;
+        };
         try {
-            const current = await player.queue.getCurrent();
-            const tracks = await player.queue.getTracks();
-            const previous = await player.queue.getPrevious();
-            const serializeTrack = (track) => ({
-                ...track,
-                requester: track.requester ? { id: track.requester.id, username: track.requester.username } : null,
-            });
-            const safeNode = player.node
-                ? JSON.parse(JSON.stringify(player.node, (key, value) => {
-                    if (key === "rest" || key === "players" || key === "shards" || key === "manager")
-                        return undefined;
-                    return value;
-                }))
-                : null;
-            return JSON.parse(JSON.stringify(player, (key, value) => {
-                if (key === "manager")
-                    return null;
-                if (key === "node")
-                    return safeNode;
-                if (key === "filters") {
+            const [current, tracks, previous] = await Promise.all([player.queue.getCurrent(), player.queue.getTracks(), player.queue.getPrevious()]);
+            const serializeTrack = (track) => {
+                try {
                     return {
-                        distortion: value?.distortion ?? null,
-                        equalizer: value?.equalizer ?? [],
-                        karaoke: value?.karaoke ?? null,
-                        rotation: value?.rotation ?? null,
-                        timescale: value?.timescale ?? null,
-                        vibrato: value?.vibrato ?? null,
-                        reverb: value?.reverb ?? null,
-                        volume: value?.volume ?? 1.0,
-                        bassBoostlevel: value?.bassBoostlevel ?? null,
-                        filterStatus: value?.filtersStatus ? { ...value.filtersStatus } : {},
+                        ...track,
+                        requester: track.requester ? { id: track.requester.id, username: track.requester.username } : null,
                     };
                 }
-                if (key === "queue") {
-                    return {
-                        current: current ? serializeTrack(current) : null,
-                        tracks: tracks.map(serializeTrack),
-                        previous: previous.map(serializeTrack),
-                    };
+                catch {
+                    return null;
                 }
-                if (key === "data") {
-                    return {
-                        clientUser: value?.Internal_AutoplayUser ?? null,
-                        nowPlayingMessage: value?.nowPlayingMessage ?? null,
-                    };
+            };
+            const safeCurrent = current ? serializeTrack(current) : null;
+            const safeTracks = tracks.map(serializeTrack).filter((t) => t !== null);
+            const safePrevious = previous.map(serializeTrack).filter((t) => t !== null);
+            let safeNode = null;
+            if (player.node) {
+                try {
+                    safeNode = JSON.parse(JSON.stringify(player.node, (key, value) => {
+                        if (["rest", "players", "shards", "manager"].includes(key))
+                            return undefined;
+                        if (isNonSerializable(value))
+                            return undefined;
+                        return value;
+                    }));
                 }
-                return value;
-            }));
+                catch {
+                    safeNode = null;
+                }
+            }
+            const snapshot = {
+                options: player.options,
+                voiceState: player.voiceState,
+                clusterId: player.clusterId,
+                guildId: player.guildId,
+                voiceChannelId: player.voiceChannelId ?? null,
+                textChannelId: player.textChannelId ?? null,
+                volume: player.volume,
+                paused: player.paused,
+                playing: player.playing,
+                position: player.position,
+                trackRepeat: player.trackRepeat,
+                queueRepeat: player.queueRepeat,
+                dynamicRepeat: player.dynamicRepeat,
+                node: safeNode,
+                queue: {
+                    current: safeCurrent,
+                    tracks: safeTracks,
+                    previous: safePrevious,
+                },
+                filters: player.filters
+                    ? {
+                        distortion: player.filters.distortion ?? null,
+                        equalizer: player.filters.equalizer ?? [],
+                        karaoke: player.filters.karaoke ?? null,
+                        rotation: player.filters.rotation ?? null,
+                        timescale: player.filters.timescale ?? null,
+                        vibrato: player.filters.vibrato ?? null,
+                        reverb: player.filters.reverb ?? null,
+                        volume: player.filters.volume ?? 1.0,
+                        bassBoostlevel: player.filters.bassBoostlevel ?? null,
+                        filterStatus: { ...player.filters.filtersStatus },
+                    }
+                    : null,
+                data: safeSerialize(player.getSerializableData()),
+            };
+            // Sanity check
+            JSON.stringify(snapshot);
+            return snapshot;
         }
         catch (err) {
-            throw err instanceof MagmastreamError_1.MagmaStreamError
+            const error = err instanceof MagmastreamError_1.MagmaStreamError
                 ? err
                 : new MagmastreamError_1.MagmaStreamError({
-                    code: Enums_1.MagmaStreamErrorCode.MANAGER_SEARCH_FAILED,
-                    message: `An error occurred while searching: ${err instanceof Error ? err.message : String(err)}`,
+                    code: Enums_1.MagmaStreamErrorCode.UTILS_PLAYER_SERIALIZE_FAILED,
+                    message: `An error occurred while serializing player: ${err instanceof Error ? err.message : String(err)}`,
                     cause: err instanceof Error ? err : undefined,
                 });
+            console.error(error);
+            return null;
         }
     }
     /**
@@ -718,6 +769,16 @@ class PlayerUtils {
     static getPlayerPreviousPath(guildId) {
         return path_1.default.join(this.getGuildDir(guildId), "previous.json");
     }
+    /**
+     * Gets the Redis key for player storage.
+     */
+    static getRedisKey() {
+        const cfg = this.manager.options.stateStorage.redisConfig;
+        // Default prefix
+        let prefix = (cfg.prefix ?? "magmastream:").trim();
+        prefix = prefix.replace(/:+$/g, "") + ":";
+        return prefix;
+    }
 }
 exports.PlayerUtils = PlayerUtils;
 /** Gets or extends structures to extend the built in, or already extended, classes to add more functionality. */

package/dist/wrappers/discord.js.js

@@ -4,7 +4,10 @@ exports.DiscordJSManager = void 0;
 const tslib_1 = require("tslib");
 const Manager_1 = require("../structures/Manager");
 const discord_js_1 = require("discord.js");
-const [major, minor] = discord_js_1.version.split(".").map(Number);
+const discord_js_2 = require("discord.js");
+const MagmastreamError_1 = require("../structures/MagmastreamError");
+const Enums_1 = require("../structures/Enums");
+const [major, minor] = discord_js_2.version.split(".").map(Number);
 tslib_1.__exportStar(require("../index"), exports);
 /**
  * Discord.js wrapper for Magmastream.
@@ -14,6 +17,12 @@ class DiscordJSManager extends Manager_1.Manager {
     constructor(client, options) {
         super(options);
         this.client = client;
+        if (!this.client.options.intents.has(discord_js_1.GatewayIntentBits.GuildVoiceStates)) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.INTENT_MISSING,
+                message: "[Custom Wrapper] Your Discord.js client must have the GuildVoiceStates intent enabled.",
+            });
+        }
         const attachReadyHandler = () => {
             const handler = () => {
                 if (!this.options.clientId)
@@ -21,11 +30,11 @@ class DiscordJSManager extends Manager_1.Manager {
             };
             // Only attach clientReady if Discord.js >= 14.22.0
             if (major > 14 || (major === 14 && minor >= 22)) {
-                client.once("clientReady", handler);
+                this.client.once("clientReady", handler);
             }
             // Only attach ready if Discord.js < 14.22.0
             if (major < 14 || (major === 14 && minor < 22)) {
-                client.once("ready", handler);
+                this.client.once("ready", handler);
             }
         };
         attachReadyHandler();
@@ -39,7 +48,7 @@ class DiscordJSManager extends Manager_1.Manager {
             guild.shard.send(packet);
     }
     async resolveUser(user) {
-        const id = typeof user === "string" ? user : user.id;
+        const id = typeof user === "string" ? user : String(user.id);
         const cached = this.client.users.cache.get(id);
         if (cached)
             return cached;
@@ -51,5 +60,11 @@ class DiscordJSManager extends Manager_1.Manager {
             return { id, username: typeof user === "string" ? undefined : user.username };
         }
     }
+    resolveGuild(guildId) {
+        const cached = this.client.guilds.cache.get(guildId);
+        if (cached)
+            return cached;
+        return null;
+    }
 }
 exports.DiscordJSManager = DiscordJSManager;