magmastream 2.9.1-dev.2 → 2.9.1-dev.4

package/dist/index.d.ts

@@ -1,13 +1,13 @@
 import { Collection } from '@discordjs/collection';
 import { GatewayVoiceStateUpdate } from 'discord-api-types/v10';
 import { EventEmitter } from 'events';
-import { User, ClientUser, Message, Client } from 'discord.js';
+import { Message, User, ClientUser, Client } from 'discord.js';
 import WebSocket$1, { WebSocket } from 'ws';
 import { Redis } from 'ioredis';
-import { Client as Client$1 } from 'eris';
+import { Client as Client$1, User as User$1 } from 'eris';
 import { ClusterClient, ShardClient } from 'detritus-client';
-import { Client as Client$2 } from 'oceanic.js';
-import { Client as Client$3, WorkerClient } from 'seyfert';
+import { Client as Client$2, User as User$2 } from 'oceanic.js';
+import { Client as Client$3, WorkerClient, User as User$3 } from 'seyfert';
 
 /** Represents an equalizer band. */
 interface Band {
@@ -897,6 +897,13 @@ interface NodeOptions {
      */
     isBackup?: boolean;
 }
+/**
+ * Portable User
+ */
+interface PortableUser {
+    id: string;
+    username?: string;
+}
 /**
  * Discord Packet
  */
@@ -1102,7 +1109,7 @@ interface Track {
     /** The thumbnail of the track or null if it's a unsupported source. */
     readonly thumbnail: string | null;
     /** The user that requested the track. */
-    requester?: User | ClientUser;
+    requester?: PortableUser;
     /** Displays the track thumbnail with optional size or null if it's a unsupported source. */
     displayThumbnail(size?: Sizes): string;
     /** Additional track info provided by plugins. */
@@ -1287,7 +1294,7 @@ interface PlaylistData {
     /** The playlist name. */
     name: string;
     /** Requester of playlist. */
-    requester: User | ClientUser;
+    requester: PortableUser;
     /** More playlist information. */
     playlistInfo: PlaylistInfoData[];
     /** The length of the playlist. */
@@ -2103,12 +2110,12 @@ declare class Player {
      * track when the current track ends.
      *
      * @param {boolean} autoplayState - Whether or not autoplay should be enabled.
-     * @param {object} botUser - The user-object that should be used as the bot-user.
+     * @param {object} AutoplayUser - The user-object that should be used as the bot-user.
      * @param {number} [tries=3] - The number of times the player should try to find a
      * recommended track if the first one doesn't work.
      * @returns {this} - The player instance.
      */
-    setAutoplay<T = unknown>(autoplayState: boolean, botUser?: T, tries?: number): this;
+    setAutoplay<T = unknown>(autoplayState: boolean, AutoplayUser?: T, tries?: number): this;
     /**
      * Gets recommended tracks and returns an array of tracks.
      * @param {Track} track - The track to find recommendations for.
@@ -2998,6 +3005,11 @@ declare class Manager extends EventEmitter {
     private get priorityNode();
     protected send(packet: GatewayVoiceStateUpdate): unknown;
     sendPacket(packet: GatewayVoiceStateUpdate): unknown;
+    /**
+     * Resolves a PortableUser or ID to a real user object.
+     * Can be overridden by wrapper managers to return wrapper-specific User classes.
+     */
+    resolveUser(user: PortableUser | string): Promise<PortableUser>;
 }
 
 declare class Filters {
@@ -3376,7 +3388,7 @@ declare abstract class TrackUtils {
      * @param requester The user who requested the track, if any.
      * @returns The built Track.
      */
-    static build<T = User | ClientUser>(data: TrackData, requester?: T): Track;
+    static build<T = PortableUser | User | ClientUser>(data: TrackData, requester?: T): Track;
     /**
      * Validates a search result.
      * @param result The search result to validate.
@@ -3487,6 +3499,9 @@ declare abstract class Structure {
      */
     static get<K extends keyof Extendable>(name: K): Extendable[K];
 }
+declare abstract class JSONUtils {
+    static safe<T>(obj: T, space?: number): string;
+}
 
 /**
  * Discord.js wrapper for Magmastream.
@@ -3495,6 +3510,7 @@ declare class DiscordJSManager extends Manager {
     readonly client: Client;
     constructor(client: Client, options?: ManagerOptions);
     protected send(packet: GatewayVoiceStateUpdate): void;
+    resolveUser(user: PortableUser | string): Promise<User | PortableUser>;
 }
 
 /**
@@ -3504,6 +3520,7 @@ declare class ErisManager extends Manager {
     readonly client: Client$1;
     constructor(client: Client$1, options?: ManagerOptions);
     protected send(packet: GatewayVoiceStateUpdate): void;
+    resolveUser(user: PortableUser | string): Promise<User$1 | PortableUser>;
 }
 
 /**
@@ -3513,6 +3530,7 @@ declare class DetritusManager extends Manager {
     readonly client: ClusterClient | ShardClient;
     constructor(client: ClusterClient | ShardClient, options?: ManagerOptions);
     protected send(packet: GatewayVoiceStateUpdate): void;
+    resolveUser(user: PortableUser | string): Promise<PortableUser>;
 }
 
 /**
@@ -3522,6 +3540,7 @@ declare class OceanicManager extends Manager {
     readonly client: Client$2;
     constructor(client: Client$2, options?: ManagerOptions);
     protected send(packet: GatewayVoiceStateUpdate): void;
+    resolveUser(user: PortableUser | string): Promise<User$2 | PortableUser>;
 }
 
 /**
@@ -3553,7 +3572,8 @@ declare class SeyfertManager extends Manager {
     readonly client: Client$3 | WorkerClient;
     constructor(client: Client$3 | WorkerClient, options?: ManagerOptions);
     protected send(packet: GatewayVoiceStateUpdate): void;
+    resolveUser(user: PortableUser | string): Promise<User$3 | PortableUser>;
 }
 
-export { AutoPlayPlatform, AutoPlayUtils, AvailableFilters, DetritusManager, DiscordJSManager, ErisManager, Filters, 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 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, 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 };
+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 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/statestorage/JsonQueue.js

@@ -5,6 +5,7 @@ const tslib_1 = require("tslib");
 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");
 /**
  * The player's queue, the `current` property is the currently playing track, think of the rest as the up-coming tracks.
  */
@@ -53,8 +54,8 @@ class JsonQueue {
         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 botUser = (await this.manager.players.get(this.guildId).get("Internal_BotUser"));
-                if (botUser && botUser.id === track.requester.id) {
+                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: {
@@ -437,7 +438,7 @@ class JsonQueue {
      */
     async writeJSON(filePath, data) {
         await this.ensureDir();
-        await fs_1.promises.writeFile(filePath, JSON.stringify(data, null, 2), "utf-8");
+        await fs_1.promises.writeFile(filePath, Utils_1.JSONUtils.safe(data, 2), "utf-8");
     }
 }
 exports.JsonQueue = JsonQueue;

package/dist/statestorage/MemoryQueue.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MemoryQueue = void 0;
 const Enums_1 = require("../structures/Enums");
+const Utils_1 = require("../structures/Utils");
 /**
  * The player's queue, the `current` property is the currently playing track, think of the rest as the up-coming tracks.
  */
@@ -36,7 +37,7 @@ class MemoryQueue extends Array {
         const isArray = Array.isArray(track);
         const tracks = isArray ? [...track] : [track];
         // Get the track info as a string
-        const trackInfo = isArray ? tracks.map((t) => JSON.stringify(t, null, 2)).join(", ") : JSON.stringify(track, null, 2);
+        const trackInfo = isArray ? tracks.map((t) => Utils_1.JSONUtils.safe(t, 2)).join(", ") : Utils_1.JSONUtils.safe(track, 2);
         // Emit a debug message
         this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[QUEUE] Added ${tracks.length} track(s) to queue: ${trackInfo}`);
         const oldPlayer = this.manager.players.get(this.guildId) ? { ...this.manager.players.get(this.guildId) } : null;
@@ -81,8 +82,8 @@ class MemoryQueue extends Array {
         }
         if (this.manager.players.has(this.guildId) && this.manager.players.get(this.guildId).isAutoplay) {
             if (!isArray) {
-                const botUser = this.manager.players.get(this.guildId).get("Internal_BotUser");
-                if (botUser && botUser.id === track.requester.id) {
+                const AutoplayUser = 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: {
@@ -262,7 +263,7 @@ class MemoryQueue extends Array {
         }
         // Single item removal when no end specified
         const removedTrack = this.splice(startOrPosition, 1);
-        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[QUEUE] Removed 1 track from player: ${this.guildId} from position ${startOrPosition}: ${JSON.stringify(removedTrack[0], null, 2)}`);
+        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[QUEUE] Removed 1 track from player: ${this.guildId} from position ${startOrPosition}: ${Utils_1.JSONUtils.safe(removedTrack[0], 2)}`);
         // Ensure removedTrack is an array for consistency
         const tracksToEmit = removedTrack.length > 0 ? removedTrack : [];
         this.manager.emit(Enums_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this.manager.players.get(this.guildId), {

package/dist/statestorage/RedisQueue.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RedisQueue = void 0;
 const Enums_1 = require("../structures/Enums");
+const Utils_1 = require("../structures/Utils");
 /**
  * The player's queue, the `current` property is the currently playing track, think of the rest as the up-coming tracks.
  */
@@ -61,8 +62,8 @@ class RedisQueue {
         this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[QUEUE] Added ${tracks.length} track(s) to queue`);
         if (this.manager.players.has(this.guildId) && this.manager.players.get(this.guildId).isAutoplay) {
             if (!Array.isArray(track)) {
-                const botUser = (await this.manager.players.get(this.guildId).get("Internal_BotUser"));
-                if (botUser && botUser.id === track.requester.id) {
+                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: {
@@ -441,7 +442,7 @@ class RedisQueue {
      * Helper to serialize/deserialize Track
      */
     serialize(track) {
-        return JSON.stringify(track);
+        return Utils_1.JSONUtils.safe(track, 2);
     }
 }
 exports.RedisQueue = RedisQueue;

package/dist/structures/Manager.js

@@ -180,22 +180,26 @@ class Manager extends events_1.EventEmitter {
             throw new Error("No available nodes.");
         const _query = typeof query === "string" ? { query } : query;
         const _source = _query.source ?? this.options.defaultSearchPlatform;
-        let search = /^https?:\/\//.test(_query.query) ? _query.query : `${_source}:${_query.query}`;
-        this.emit(Enums_1.ManagerEventTypes.Debug, `[MANAGER] Performing ${_source} search for: ${_query.query}`);
+        const isUrl = /^https?:\/\//.test(_query.query);
+        const search = isUrl ? _query.query : `${_source}:${_query.query}`;
+        this.emit(Enums_1.ManagerEventTypes.Debug, isUrl ? `[MANAGER] Performing search for: ${_query.query}` : `[MANAGER] Performing ${_source} search for: ${_query.query}`);
         try {
             const res = (await node.rest.get(`/v4/loadtracks?identifier=${encodeURIComponent(search)}`));
             if (!res)
                 throw new Error("Query not found.");
-            let tracks = [];
-            let playlist = null;
+            let result;
             switch (res.loadType) {
-                case Enums_1.LoadTypes.Search:
-                    tracks = res.data.map((track) => Utils_1.TrackUtils.build(track, requester));
+                case Enums_1.LoadTypes.Search: {
+                    const tracks = res.data.map((t) => Utils_1.TrackUtils.build(t, requester));
+                    result = { loadType: res.loadType, tracks };
                     break;
+                }
                 case Enums_1.LoadTypes.Short:
-                case Enums_1.LoadTypes.Track:
-                    tracks = [Utils_1.TrackUtils.build(res.data, requester)];
+                case Enums_1.LoadTypes.Track: {
+                    const track = Utils_1.TrackUtils.build(res.data, requester);
+                    result = { loadType: res.loadType, tracks: [track] };
                     break;
+                }
                 case Enums_1.LoadTypes.Album:
                 case Enums_1.LoadTypes.Artist:
                 case Enums_1.LoadTypes.Station:
@@ -203,18 +207,24 @@ class Manager extends events_1.EventEmitter {
                 case Enums_1.LoadTypes.Show:
                 case Enums_1.LoadTypes.Playlist: {
                     const playlistData = res.data;
-                    tracks = playlistData.tracks.map((track) => Utils_1.TrackUtils.build(track, requester));
-                    playlist = {
-                        name: playlistData.info.name,
-                        playlistInfo: playlistData.pluginInfo,
-                        requester: requester,
+                    const tracks = playlistData.tracks.map((t) => Utils_1.TrackUtils.build(t, requester));
+                    result = {
+                        loadType: res.loadType,
                         tracks,
-                        duration: tracks.reduce((acc, cur) => acc + (cur.duration || 0), 0),
+                        playlist: {
+                            name: playlistData.info.name,
+                            playlistInfo: playlistData.pluginInfo,
+                            requester: requester,
+                            tracks,
+                            duration: tracks.reduce((acc, cur) => acc + (cur.duration || 0), 0),
+                        },
                     };
                     break;
                 }
+                default:
+                    result = { loadType: res.loadType };
             }
-            if (this.options.normalizeYouTubeTitles) {
+            if (this.options.normalizeYouTubeTitles && "tracks" in result) {
                 const processTrack = (track) => {
                     if (!/(youtube\.com|youtu\.be)/.test(track.uri))
                         return track;
@@ -223,34 +233,15 @@ class Manager extends events_1.EventEmitter {
                     track.author = cleanAuthor;
                     return track;
                 };
-                if (playlist) {
-                    playlist.tracks = playlist.tracks.map(processTrack);
-                }
-                else {
-                    tracks = tracks.map(processTrack);
+                result.tracks = result.tracks.map(processTrack);
+                if ("playlist" in result && result.playlist) {
+                    result.playlist.tracks = result.playlist.tracks.map(processTrack);
                 }
             }
-            let result;
-            switch (res.loadType) {
-                case Enums_1.LoadTypes.Album:
-                case Enums_1.LoadTypes.Artist:
-                case Enums_1.LoadTypes.Station:
-                case Enums_1.LoadTypes.Podcast:
-                case Enums_1.LoadTypes.Show:
-                case Enums_1.LoadTypes.Playlist:
-                    result = { loadType: res.loadType, tracks, playlist };
-                    break;
-                case Enums_1.LoadTypes.Search:
-                    result = { loadType: res.loadType, tracks };
-                    break;
-                case Enums_1.LoadTypes.Short:
-                case Enums_1.LoadTypes.Track:
-                    result = { loadType: res.loadType, tracks: [tracks[0]] };
-                    break;
-                default:
-                    return { loadType: res.loadType };
-            }
-            this.emit(Enums_1.ManagerEventTypes.Debug, `[MANAGER] Result ${_source} search for: ${_query.query}: ${JSON.stringify(result)}`);
+            const summary = "tracks" in result
+                ? result.tracks.map((t) => Object.fromEntries(Object.entries(t).filter(([key]) => key !== "requester")))
+                : [];
+            this.emit(Enums_1.ManagerEventTypes.Debug, `[MANAGER] Result search for ${_query.query}: ${Utils_1.JSONUtils.safe(summary, 2)}`);
             return result;
         }
         catch (err) {
@@ -275,7 +266,7 @@ class Manager extends events_1.EventEmitter {
             return this.players.get(options.guildId);
         }
         // Create a new player with the given options
-        this.emit(Enums_1.ManagerEventTypes.Debug, `[MANAGER] Creating new player with options: ${JSON.stringify(options)}`);
+        this.emit(Enums_1.ManagerEventTypes.Debug, `[MANAGER] Creating new player with options: ${Utils_1.JSONUtils.safe(options, 2)}`);
         return new (Utils_1.Structure.get("Player"))(options);
     }
     /**
@@ -306,7 +297,7 @@ class Manager extends events_1.EventEmitter {
         // Set the node in the manager's collection
         this.nodes.set(key, node);
         // Emit a debug event for node creation
-        this.emit(Enums_1.ManagerEventTypes.Debug, `[MANAGER] Creating new node with options: ${JSON.stringify(options)}`);
+        this.emit(Enums_1.ManagerEventTypes.Debug, `[MANAGER] Creating new node with options: ${Utils_1.JSONUtils.safe(options, 2)}`);
         // Return the created node
         return node;
     }
@@ -350,7 +341,7 @@ class Manager extends events_1.EventEmitter {
         const player = this.getPlayer(update.guild_id);
         if (!player)
             return;
-        this.emit(Enums_1.ManagerEventTypes.Debug, `[MANAGER] Updating voice state: ${JSON.stringify(update)}`);
+        this.emit(Enums_1.ManagerEventTypes.Debug, `[MANAGER] Updating voice state: ${Utils_1.JSONUtils.safe(update, 2)}`);
         if ("token" in update) {
             return await this.handleVoiceServerUpdate(player, update);
         }
@@ -366,12 +357,12 @@ class Manager extends events_1.EventEmitter {
      * @throws Will throw an error if no nodes are available or if the API request fails.
      */
     async decodeTracks(tracks) {
-        this.emit(Enums_1.ManagerEventTypes.Debug, `[MANAGER] Decoding tracks: ${JSON.stringify(tracks)}`);
+        this.emit(Enums_1.ManagerEventTypes.Debug, `[MANAGER] Decoding tracks: ${Utils_1.JSONUtils.safe(tracks, 2)}`);
         return new Promise(async (resolve, reject) => {
             const node = this.nodes.first();
             if (!node)
                 throw new Error("No available nodes.");
-            const res = (await node.rest.post("/v4/decodetracks", JSON.stringify(tracks)).catch((err) => reject(err)));
+            const res = (await node.rest.post("/v4/decodetracks", Utils_1.JSONUtils.safe(tracks, 2)).catch((err) => reject(err)));
             if (!res) {
                 return reject(new Error("No data returned from query."));
             }
@@ -407,7 +398,7 @@ class Manager extends events_1.EventEmitter {
                         }
                         const serializedPlayer = await Utils_1.PlayerUtils.serializePlayer(player);
                         await promises_1.default.mkdir(path_1.default.dirname(playerStateFilePath), { recursive: true });
-                        await promises_1.default.writeFile(playerStateFilePath, JSON.stringify(serializedPlayer, null, 2), "utf-8");
+                        await promises_1.default.writeFile(playerStateFilePath, Utils_1.JSONUtils.safe(serializedPlayer, 2), "utf-8");
                         this.emit(Enums_1.ManagerEventTypes.Debug, `[MANAGER] Player state saved: ${guildId}`);
                     }
                     catch (error) {
@@ -427,7 +418,7 @@ class Manager extends events_1.EventEmitter {
                         const redisKey = `${this.options.stateStorage.redisConfig.prefix?.endsWith(":")
                             ? this.options.stateStorage.redisConfig.prefix
                             : this.options.stateStorage.redisConfig.prefix ?? "magmastream:"}playerstore:${guildId}`;
-                        await this.redis.set(redisKey, JSON.stringify(serializedPlayer));
+                        await this.redis.set(redisKey, Utils_1.JSONUtils.safe(serializedPlayer, 2));
                         this.emit(Enums_1.ManagerEventTypes.Debug, `[MANAGER] Player state saved to Redis: ${guildId}`);
                     }
                     catch (error) {
@@ -497,7 +488,7 @@ class Manager extends events_1.EventEmitter {
                                     volume: lavaPlayer.volume || state.options.volume,
                                     nodeIdentifier: nodeId,
                                 };
-                                this.emit(Enums_1.ManagerEventTypes.Debug, `[MANAGER] Recreating player: ${state.guildId} from saved file: ${JSON.stringify(state.options)}`);
+                                this.emit(Enums_1.ManagerEventTypes.Debug, `[MANAGER] Recreating player: ${state.guildId} from saved file: ${Utils_1.JSONUtils.safe(state.options, 2)}`);
                                 const player = this.create(playerOptions);
                                 await player.node.rest.updatePlayer({
                                     guildId: state.options.guildId,
@@ -514,8 +505,11 @@ class Manager extends events_1.EventEmitter {
                                 const currentTrack = state.queue.current;
                                 const queueTracks = state.queue.tracks;
                                 if (state.isAutoplay) {
-                                    Object.setPrototypeOf(state.data.clientUser, { constructor: { name: "User" } });
-                                    player.setAutoplay(true, state.data.clientUser, state.autoplayTries);
+                                    const savedUser = state.data.clientUser;
+                                    if (savedUser) {
+                                        const autoPlayUser = await player.manager.resolveUser(savedUser);
+                                        player.setAutoplay(true, autoPlayUser, state.autoplayTries);
+                                    }
                                 }
                                 if (lavaPlayer?.track) {
                                     tracks.push(...queueTracks);
@@ -705,8 +699,11 @@ class Manager extends events_1.EventEmitter {
                                     const currentTrack = state.queue.current;
                                     const queueTracks = state.queue.tracks;
                                     if (state.isAutoplay) {
-                                        Object.setPrototypeOf(state.data.clientUser, { constructor: { name: "User" } });
-                                        player.setAutoplay(true, state.data.clientUser, state.autoplayTries);
+                                        const savedUser = state.data.clientUser;
+                                        if (savedUser) {
+                                            const autoPlayUser = await player.manager.resolveUser(savedUser);
+                                            player.setAutoplay(true, autoPlayUser, state.autoplayTries);
+                                        }
                                     }
                                     if (lavaPlayer?.track) {
                                         // If lavaPlayer has a track, push all queue tracks
@@ -1310,5 +1307,16 @@ class Manager extends events_1.EventEmitter {
     sendPacket(packet) {
         return this.send(packet);
     }
+    /**
+     * Resolves a PortableUser or ID to a real user object.
+     * Can be overridden by wrapper managers to return wrapper-specific User classes.
+     */
+    async resolveUser(user) {
+        if (!user)
+            return null;
+        if (typeof user === "string")
+            return { id: user }; // fallback by ID only
+        return user; // default: just return the portable user
+    }
 }
 exports.Manager = Manager;

package/dist/structures/Node.js

@@ -128,7 +128,7 @@ class Node {
     createSessionIdsFile() {
         if (!fs_1.default.existsSync(this.sessionIdsFilePath)) {
             this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Creating sessionId file at: ${this.sessionIdsFilePath}`);
-            fs_1.default.writeFileSync(this.sessionIdsFilePath, JSON.stringify({}), "utf-8");
+            fs_1.default.writeFileSync(this.sessionIdsFilePath, Utils_1.JSONUtils.safe({}), "utf-8");
         }
     }
     /**
@@ -178,7 +178,7 @@ class Node {
                 }
                 else {
                     this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] No sessionIds found in Redis — creating new key.`);
-                    await this.manager.redis.set(key, JSON.stringify({}));
+                    await this.manager.redis.set(key, Utils_1.JSONUtils.safe({}));
                     this.sessionIdsMap = new Map();
                 }
                 break;
@@ -219,7 +219,7 @@ class Node {
                         }
                         fileData[compositeKey] = this.sessionId;
                         const tmpPath = `${filePath}.tmp`;
-                        fs_1.default.writeFileSync(tmpPath, JSON.stringify(fileData, null, 2), "utf-8");
+                        fs_1.default.writeFileSync(tmpPath, Utils_1.JSONUtils.safe(fileData, 2), "utf-8");
                         fs_1.default.renameSync(tmpPath, filePath);
                         this.sessionIdsMap = new Map(Object.entries(fileData));
                         updated = true;
@@ -259,7 +259,7 @@ class Node {
                 }
                 sessionIds[compositeKey] = this.sessionId;
                 this.sessionIdsMap = new Map(Object.entries(sessionIds));
-                await this.manager.redis.set(key, JSON.stringify(sessionIds));
+                await this.manager.redis.set(key, Utils_1.JSONUtils.safe(sessionIds));
                 break;
             }
         }
@@ -307,7 +307,7 @@ class Node {
                 identifier: this.options.identifier,
             },
         };
-        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Connecting ${JSON.stringify(debugInfo)}`);
+        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Connecting ${Utils_1.JSONUtils.safe(debugInfo, 2)}`);
     }
     /**
      * Destroys the node and cleans up associated resources.
@@ -329,7 +329,7 @@ class Node {
             sessionId: this.sessionId,
             playerCount: this.manager.players.filter((p) => p.node == this).size,
         };
-        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Destroying node: ${JSON.stringify(debugInfo)}`);
+        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Destroying node: ${Utils_1.JSONUtils.safe(debugInfo, 2)}`);
         // Automove all players connected to that node
         const players = this.manager.players.filter((p) => p.node == this);
         if (players.size) {
@@ -368,7 +368,7 @@ class Node {
             maxRetryAttempts: this.options.maxRetryAttempts,
             retryDelayMs: this.options.retryDelayMs,
         };
-        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Reconnecting node: ${JSON.stringify(debugInfo)}`);
+        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.`);
@@ -405,7 +405,7 @@ class Node {
             identifier: this.options.identifier,
             connected: this.connected,
         };
-        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Connected node: ${JSON.stringify(debugInfo)}`);
+        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Connected node: ${Utils_1.JSONUtils.safe(debugInfo, 2)}`);
         this.manager.emit(Enums_1.ManagerEventTypes.NodeConnect, this);
         const playersOnBackupNode = this.manager.players.filter((p) => p.node.options.isBackup);
         if (playersOnBackupNode.size) {
@@ -432,7 +432,7 @@ class Node {
             reason,
         };
         this.manager.emit(Enums_1.ManagerEventTypes.NodeDisconnect, this, { code, reason });
-        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Disconnected node: ${JSON.stringify(debugInfo)}`);
+        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Disconnected node: ${Utils_1.JSONUtils.safe(debugInfo, 2)}`);
         if (this.manager.useableNode) {
             const players = this.manager.players.filter((p) => p.node.options.identifier == this.options.identifier);
             if (players.size) {
@@ -464,7 +464,7 @@ class Node {
             identifier: this.options.identifier,
             error: error.message,
         };
-        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Error on node: ${JSON.stringify(debugInfo)}`);
+        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Error on node: ${Utils_1.JSONUtils.safe(debugInfo, 2)}`);
         this.manager.emit(Enums_1.ManagerEventTypes.NodeError, this, error);
     }
     /**
@@ -504,11 +504,11 @@ class Node {
                 if (player && player.node.options.identifier !== this.options.identifier) {
                     return;
                 }
-                this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Node message: ${JSON.stringify(payload)}`);
+                this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Node message: ${Utils_1.JSONUtils.safe(payload, 2)}`);
                 await this.handleEvent(payload);
                 break;
             case "ready":
-                this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Node message: ${JSON.stringify(payload)}`);
+                this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Node message: ${Utils_1.JSONUtils.safe(payload, 2)}`);
                 this.rest.setSessionId(payload.sessionId);
                 this.sessionId = payload.sessionId;
                 await this.updateSessionId();
@@ -601,8 +601,8 @@ class Node {
         player.playing = true;
         player.paused = false;
         this.manager.emit(Enums_1.ManagerEventTypes.TrackStart, player, track, payload);
-        const botUser = player.get("Internal_BotUser");
-        if (botUser && botUser.id === track.requester.id) {
+        const AutoplayUser = player.get("Internal_AutoplayUser");
+        if (AutoplayUser && AutoplayUser.id === track.requester.id) {
             this.manager.emit(Enums_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, player, {
                 changeType: Enums_1.PlayerStateEventTypes.TrackChange,
                 details: {
@@ -702,7 +702,7 @@ class Node {
             return false;
         const PreviousQueue = await player.queue.getPrevious();
         const lastTrack = PreviousQueue?.at(-1);
-        lastTrack.requester = player.get("Internal_BotUser");
+        lastTrack.requester = player.get("Internal_AutoplayUser");
         if (!lastTrack)
             return false;
         const tracks = await Utils_1.AutoPlayUtils.getRecommendedTracks(lastTrack);
@@ -934,7 +934,7 @@ class Node {
      */
     socketClosed(player, payload) {
         this.manager.emit(Enums_1.ManagerEventTypes.SocketClosed, player, payload);
-        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Websocket closed for player: ${player.guildId} with payload: ${JSON.stringify(payload)}`);
+        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[NODE] Websocket closed for player: ${player.guildId} with payload: ${Utils_1.JSONUtils.safe(payload, 2)}`);
     }
     /**
      * Emitted when the segments for a track are loaded.
@@ -1045,7 +1045,7 @@ class Node {
             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`, JSON.stringify(segments.map((v) => v.toLowerCase())));
+        await this.rest.put(`/v4/sessions/${this.sessionId}/players/${player.guildId}/sponsorblock/categories`, Utils_1.JSONUtils.safe(segments.map((v) => v.toLowerCase()), 2));
         return;
     }
     /**

package/dist/structures/Player.js

@@ -355,30 +355,27 @@ class Player {
      * track when the current track ends.
      *
      * @param {boolean} autoplayState - Whether or not autoplay should be enabled.
-     * @param {object} botUser - The user-object that should be used as the bot-user.
+     * @param {object} AutoplayUser - The user-object that should be used as the bot-user.
      * @param {number} [tries=3] - The number of times the player should try to find a
      * recommended track if the first one doesn't work.
      * @returns {this} - The player instance.
      */
-    setAutoplay(autoplayState, botUser, tries) {
+    setAutoplay(autoplayState, AutoplayUser, tries) {
         if (typeof autoplayState !== "boolean") {
             throw new Error("autoplayState must be a boolean.");
         }
         if (autoplayState) {
-            if (!botUser) {
-                throw new Error("botUser must be provided when enabling autoplay.");
-            }
-            if (!["ClientUser", "User"].includes(botUser.constructor.name)) {
-                throw new Error("botUser must be a user-object.");
+            if (!AutoplayUser) {
+                throw new Error("AutoplayUser must be provided when enabling autoplay.");
             }
             this.autoplayTries = tries && typeof tries === "number" && tries > 0 ? tries : 3; // Default to 3 if invalid
             this.isAutoplay = true;
-            this.set("Internal_BotUser", botUser);
+            this.set("Internal_AutoplayUser", AutoplayUser);
         }
         else {
             this.isAutoplay = false;
             this.autoplayTries = null;
-            this.set("Internal_BotUser", null);
+            this.set("Internal_AutoplayUser", null);
         }
         const oldPlayer = { ...this };
         this.manager.emit(Enums_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this, {
@@ -852,7 +849,7 @@ class Player {
             queueRepeat: this.queueRepeat,
             dynamicRepeat: this.dynamicRepeat,
             dynamicRepeatIntervalMs: this.dynamicRepeatIntervalMs,
-            ClientUser: this.get("Internal_BotUser"),
+            ClientUser: this.get("Internal_AutoplayUser"),
             filters: this.filters,
             nowPlayingMessage: this.nowPlayingMessage,
             isAutoplay: this.isAutoplay,
@@ -889,7 +886,7 @@ class Player {
         clonedPlayer.queueRepeat = oldPlayerProperties.queueRepeat;
         clonedPlayer.dynamicRepeat = oldPlayerProperties.dynamicRepeat;
         clonedPlayer.dynamicRepeatIntervalMs = oldPlayerProperties.dynamicRepeatIntervalMs;
-        clonedPlayer.set("Internal_BotUser", oldPlayerProperties.ClientUser);
+        clonedPlayer.set("Internal_AutoplayUser", oldPlayerProperties.ClientUser);
         clonedPlayer.paused = oldPlayerProperties.paused;
         // Update filters for the cloned player
         await clonedPlayer.filters.updateFilters();
@@ -906,7 +903,7 @@ class Player {
                 queueSize: clonedPlayer.queue.size,
             },
         };
-        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[PLAYER] Transferred player to a new server: ${JSON.stringify(debugInfo)}.`);
+        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;
     }
@@ -1035,7 +1032,7 @@ class Player {
         const packet = JSON.parse(payload);
         if (!packet?.op)
             return;
-        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `VoiceReceiver recieved a payload: ${JSON.stringify(payload)}`);
+        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `VoiceReceiver recieved a payload: ${Utils_1.JSONUtils.safe(payload, 2)}`);
         switch (packet.type) {
             case "startSpeakingEvent": {
                 this.manager.emit(Enums_1.ManagerEventTypes.VoiceReceiverStartSpeaking, this, packet.data);
@@ -1050,7 +1047,7 @@ class Player {
                 break;
             }
             default: {
-                this.manager.emit(Enums_1.ManagerEventTypes.Debug, `VoiceReceiver recieved an unknown payload: ${JSON.stringify(payload)}`);
+                this.manager.emit(Enums_1.ManagerEventTypes.Debug, `VoiceReceiver recieved an unknown payload: ${Utils_1.JSONUtils.safe(payload, 2)}`);
                 break;
             }
         }

package/dist/structures/Rest.js

@@ -4,6 +4,7 @@ exports.Rest = void 0;
 const tslib_1 = require("tslib");
 const axios_1 = tslib_1.__importDefault(require("axios"));
 const Enums_1 = require("./Enums");
+const Utils_1 = require("./Utils");
 /** Handles the requests sent to the Lavalink REST API. */
 class Rest {
     /** The Node that this Rest instance is connected to. */
@@ -44,7 +45,7 @@ class Rest {
         // Send a GET request to the Lavalink Node to retrieve all the players.
         const result = await this.get(`/v4/sessions/${this.sessionId}/players`);
         // Log the result of the request.
-        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[REST] Getting all players on node: ${this.node.options.identifier} : ${JSON.stringify(result)}`);
+        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[REST] Getting all players on node: ${this.node.options.identifier} : ${Utils_1.JSONUtils.safe(result, 2)}`);
         // Return the result of the request.
         return result;
     }
@@ -55,7 +56,7 @@ class Rest {
      */
     async updatePlayer(options) {
         // Log the request.
-        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[REST] Updating player: ${options.guildId}: ${JSON.stringify(options)}`);
+        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[REST] Updating player: ${options.guildId}: ${Utils_1.JSONUtils.safe(options, 2)}`);
         // Send the PATCH request.
         return await this.patch(`/v4/sessions/${this.sessionId}/players/${options.guildId}?noReplace=false`, options.data);
     }
@@ -92,7 +93,7 @@ class Rest {
      * @returns {Promise<unknown>} The response data of the request.
      */
     async request(method, endpoint, body) {
-        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[REST] ${method} api call for endpoint: ${endpoint} with data: ${JSON.stringify(body)}`);
+        this.manager.emit(Enums_1.ManagerEventTypes.Debug, `[REST] ${method} api call for endpoint: ${endpoint} with data: ${Utils_1.JSONUtils.safe(body, 2)}`);
         const config = {
             method,
             url: this.url + endpoint,

package/dist/structures/Utils.js

@@ -1,12 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Structure = exports.PlayerUtils = exports.AutoPlayUtils = exports.TrackUtils = void 0;
+exports.JSONUtils = exports.Structure = exports.PlayerUtils = exports.AutoPlayUtils = exports.TrackUtils = void 0;
 const tslib_1 = require("tslib");
 /* eslint-disable @typescript-eslint/no-require-imports */
 const axios_1 = tslib_1.__importDefault(require("axios"));
 const jsdom_1 = require("jsdom");
 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"));
 // import playwright from "playwright";
 /** @hidden */
 const SIZES = ["0", "1", "2", "3", "default", "mqdefault", "hqdefault", "maxresdefault"];
@@ -601,58 +602,52 @@ class PlayerUtils {
      * @returns The serialized Player instance
      */
     static async serializePlayer(player) {
-        const seen = new WeakSet();
-        // Fetch async queue data once before serializing
         const current = await player.queue.getCurrent();
         const tracks = Array.isArray(await player.queue.getTracks()) ? await player.queue.getTracks() : [];
         const previous = Array.isArray(await player.queue.getPrevious()) ? await player.queue.getPrevious() : [];
-        /**
-         * Recursively serializes an object, avoiding circular references.
-         * @param obj The object to serialize
-         * @returns The serialized object
-         */
-        const serialize = (obj) => {
-            if (obj && typeof obj === "object") {
-                if (seen.has(obj))
+        const seen = new WeakSet();
+        // The replacer function
+        const replacer = (key, value) => {
+            if (value && typeof value === "object") {
+                if (seen.has(value))
                     return;
-                seen.add(obj);
+                seen.add(value);
             }
-            return obj;
-        };
-        return JSON.parse(JSON.stringify(player, (key, value) => {
-            if (key === "manager") {
+            if (key === "manager")
                 return null;
-            }
             if (key === "filters") {
                 if (!value || typeof value !== "object")
                     return null;
+                const filters = value;
                 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 } : {},
+                    distortion: filters.distortion ?? null,
+                    equalizer: filters.equalizer ?? [],
+                    karaoke: filters.karaoke ?? null,
+                    rotation: filters.rotation ?? null,
+                    timescale: filters.timescale ?? null,
+                    vibrato: filters.vibrato ?? null,
+                    reverb: filters.reverb ?? null,
+                    volume: filters.volume ?? 1.0,
+                    bassBoostlevel: filters.bassBoostlevel ?? null,
+                    filterStatus: filters.filtersStatus ? { ...filters.filtersStatus } : {},
                 };
             }
             if (key === "queue") {
-                return {
-                    current,
-                    tracks,
-                    previous,
-                };
+                return { current, tracks, previous };
             }
             if (key === "data") {
+                const data = value;
+                const AutoplayUser = data?.Internal_AutoplayUser;
+                const serializedUser = AutoplayUser ? { id: AutoplayUser.id, username: AutoplayUser.username } : null;
                 return {
-                    clientUser: value?.Internal_BotUser ?? null,
+                    clientUser: serializedUser,
+                    autoplayTries: data?.autoplayTries ?? null,
                 };
             }
-            return serialize(value);
-        }));
+            return value;
+        };
+        const jsonString = (0, safe_stable_stringify_1.default)(player, replacer, 2);
+        return JSON.parse(jsonString);
     }
     /**
      * Gets the base directory for player data.
@@ -718,6 +713,12 @@ class Structure {
     }
 }
 exports.Structure = Structure;
+class JSONUtils {
+    static safe(obj, space) {
+        return (0, safe_stable_stringify_1.default)(obj, null, space);
+    }
+}
+exports.JSONUtils = JSONUtils;
 const structures = {
     Player: require("./Player").Player,
     Queue: require("../statestorage/MemoryQueue").MemoryQueue,

package/dist/wrappers/detritus.js

@@ -32,5 +32,21 @@ class DetritusManager extends Manager_1.Manager {
                 shard.gateway.send(packet.op, packet.d);
         }
     }
+    async resolveUser(user) {
+        const id = typeof user === "string" ? user : user.id;
+        if (this.client instanceof detritus_client_1.ShardClient) {
+            const cached = this.client.users.get(id);
+            if (cached)
+                return { id: cached.id, username: cached.username };
+        }
+        else if (this.client instanceof detritus_client_1.ClusterClient) {
+            for (const [, shard] of this.client.shards) {
+                const cached = shard.users.get(id);
+                if (cached)
+                    return { id: cached.id, username: cached.username };
+            }
+        }
+        return typeof user === "string" ? { id: user } : user;
+    }
 }
 exports.DetritusManager = DetritusManager;

package/dist/wrappers/discord.js.js

@@ -38,5 +38,18 @@ class DiscordJSManager extends Manager_1.Manager {
         if (guild)
             guild.shard.send(packet);
     }
+    async resolveUser(user) {
+        const id = typeof user === "string" ? user : user.id;
+        const cached = this.client.users.cache.get(id);
+        if (cached)
+            return cached;
+        try {
+            const fetched = await this.client.users.fetch(id);
+            return fetched;
+        }
+        catch {
+            return { id, username: typeof user === "string" ? undefined : user.username };
+        }
+    }
 }
 exports.DiscordJSManager = DiscordJSManager;

package/dist/wrappers/eris.js

@@ -25,5 +25,15 @@ class ErisManager extends Manager_1.Manager {
         if (guild)
             guild.shard.sendWS(packet.op, packet.d);
     }
+    async resolveUser(user) {
+        const id = typeof user === "string" ? user : user.id;
+        const cached = this.client.users.get(id);
+        if (cached)
+            return cached;
+        return {
+            id,
+            username: typeof user === "string" ? undefined : user.username,
+        };
+    }
 }
 exports.ErisManager = ErisManager;

package/dist/wrappers/oceanic.js

@@ -25,5 +25,15 @@ class OceanicManager extends Manager_1.Manager {
         if (guild)
             guild.shard.send(packet.op, packet.d);
     }
+    async resolveUser(user) {
+        const id = typeof user === "string" ? user : user.id;
+        const cached = this.client.users.get(id);
+        if (cached)
+            return cached;
+        return {
+            id,
+            username: typeof user === "string" ? undefined : user.username,
+        };
+    }
 }
 exports.OceanicManager = OceanicManager;

package/dist/wrappers/seyfert.js

@@ -38,11 +38,23 @@ class SeyfertManager extends Manager_1.Manager {
         this.client = client;
     }
     send(packet) {
-        if (this.client instanceof seyfert_1.WorkerClient) {
-            this.client.shards.get((0, common_1.calculateShardId)(packet.d.guild_id))?.send(true, packet);
+        if (this.client instanceof seyfert_1.Client) {
+            this.client.gateway.send((0, common_1.calculateShardId)(packet.d.guild_id), packet);
         }
         else {
-            this.client.gateway.send((0, common_1.calculateShardId)(packet.d.guild_id), packet);
+            this.client.shards.get((0, common_1.calculateShardId)(packet.d.guild_id))?.send(true, packet);
+        }
+    }
+    async resolveUser(user) {
+        const id = typeof user === "string" ? user : user.id;
+        const cached = this.client.cache.users?.get(id);
+        if (cached)
+            return cached;
+        try {
+            return await this.client.users.fetch(id);
+        }
+        catch {
+            return { id, username: typeof user === "string" ? undefined : user.username };
         }
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "magmastream",
-	"version": "2.9.1-dev.2",
+	"version": "2.9.1-dev.4",
 	"description": "A user-friendly Lavalink client designed for NodeJS.",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -35,6 +35,7 @@
 		"ioredis": "^5.6.1",
 		"jsdom": "^26.1.0",
 		"lodash": "^4.17.21",
+		"safe-stable-stringify": "^2.5.0",
 		"tslib": "^2.8.1",
 		"ws": "^8.18.3"
 	},