magmastream 2.9.3-dev.13 → 2.9.3-dev.15

package/dist/index.d.ts

@@ -3,12 +3,11 @@ import { GatewayVoiceStateUpdate } from 'discord-api-types/v10';
 import { EventEmitter } from 'events';
 import { User, ClientUser, Message, Client } from 'discord.js';
 import { User as User$1, Message as Message$1, Client as Client$2 } from 'oceanic.js';
-import { User as User$2, Message as Message$2 } from 'detritus-client/lib/structures';
+import { User as User$2, Message as Message$2, Bot } from '@discordeno/bot';
 import { User as User$3, Message as Message$3, Client as Client$1 } from 'eris';
 import { User as User$4, ClientUser as ClientUser$1, Message as Message$4, Client as Client$3, WorkerClient } from 'seyfert';
 import WebSocket$1, { WebSocket } from 'ws';
 import { Redis } from 'ioredis';
-import { ClusterClient, ShardClient } from 'detritus-client';
 
 /** Represents an equalizer band. */
 interface Band {
@@ -286,6 +285,7 @@ declare enum MagmaStreamErrorCode {
     GENERAL_UNKNOWN = "MS_GENERAL_UNKNOWN",
     GENERAL_TIMEOUT = "MS_GENERAL_TIMEOUT",
     GENERAL_INVALID_MANAGER = "MS_GENERAL_INVALID_MANAGER",
+    INTENT_MISSING = "MS_INTENT_MISSING",
     MANAGER_INIT_FAILED = "MS_MANAGER_INIT_FAILED",
     MANAGER_INVALID_CONFIG = "MS_MANAGER_INVALID_CONFIG",
     MANAGER_SHUTDOWN_FAILED = "MS_MANAGER_SHUTDOWN_FAILED",
@@ -322,6 +322,7 @@ declare enum MagmaStreamErrorCode {
     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",
+    UTILS_PLAYER_SERIALIZE_FAILED = "MS_UTILS_PLAYER_SERIALIZE_FAILED",
     PLUGIN_LOAD_FAILED = "MS_PLUGIN_LOAD_FAILED",
     PLUGIN_RUNTIME_ERROR = "MS_PLUGIN_RUNTIME_ERROR"
 }
@@ -920,6 +921,12 @@ interface ManagerOptions {
      * @param payload The payload to send.
      */
     send?: (packet: DiscordPacket) => unknown;
+    /**
+     * Optional user cache getter.
+     * When resolving a user from a partial ID, this function will be called first.
+     * Should return the full user object if cached, or undefined if not.
+     */
+    getUser?: (id: string) => AnyUser | undefined;
 }
 /**
  * State Storage Options
@@ -2355,6 +2362,11 @@ declare class Player {
      * @returns {NodeJS.Timeout | null} - The dynamic loop interval of the player.
      */
     getDynamicLoopIntervalPublic(): NodeJS.Timeout | null;
+    /**
+     * Retrieves the data associated with the player.
+     * @returns {Record<string, unknown>} - The data associated with the player.
+     */
+    getSerializableData(): Record<string, unknown>;
     /**
      * Retrieves the current lyrics for the playing track.
      * @param skipTrackSource - Indicates whether to skip the track source when fetching lyrics.
@@ -2899,6 +2911,7 @@ declare class Manager extends EventEmitter {
     initiated: boolean;
     redis?: Redis;
     private _send;
+    private _getUser?;
     private loadedPlugins;
     /**
      * Initiates the Manager class.
@@ -3121,6 +3134,7 @@ declare class Manager extends EventEmitter {
      */
     private get priorityNode();
     protected send(packet: GatewayVoiceStateUpdate): unknown;
+    protected getUserFromCache(id: string): AnyUser | undefined;
     sendPacket(packet: GatewayVoiceStateUpdate): unknown;
     /**
      * Resolves a PortableUser or ID to a real user object.
@@ -3594,7 +3608,7 @@ declare abstract class PlayerUtils {
      * @param player The Player instance to serialize
      * @returns The serialized Player instance
      */
-    static serializePlayer(player: Player): Promise<Record<string, unknown>>;
+    static serializePlayer(player: Player): Promise<Record<string, unknown> | null>;
     /**
      * Gets the base directory for player data.
      */
@@ -3652,6 +3666,20 @@ declare class MagmaStreamError<T = unknown> extends Error {
     constructor({ code, message, cause, context }: MagmaStreamErrorOptions<T>);
 }
 
+/**
+ * Discordeno wrapper for Magmastream.
+ */
+declare class DiscordenoManager extends Manager {
+    readonly client: Bot;
+    constructor(client: Bot, options?: ManagerOptions);
+    protected send(packet: GatewayVoiceStateUpdate): void;
+    /**
+     * Resolve a user by ID or partial info.
+     * Uses user-provided cache getter if available, otherwise falls back to minimal info.
+     */
+    resolveUser(user: AnyUser | string): Promise<User$2 | AnyUser>;
+}
+
 /**
  * Discord.js wrapper for Magmastream.
  */
@@ -3672,16 +3700,6 @@ declare class ErisManager extends Manager {
     resolveUser(user: AnyUser | string): Promise<User$3 | AnyUser>;
 }
 
-/**
- * Detritus wrapper for Magmastream.
- */
-declare class DetritusManager extends Manager {
-    readonly client: ClusterClient | ShardClient;
-    constructor(client: ClusterClient | ShardClient, options?: ManagerOptions);
-    protected send(packet: GatewayVoiceStateUpdate): void;
-    resolveUser(user: AnyUser | string): Promise<AnyUser>;
-}
-
 /**
  * Oceanic wrapper for Magmastream.
  */
@@ -3724,5 +3742,5 @@ declare class SeyfertManager extends Manager {
     resolveUser(user: AnyUser | string): Promise<User$4 | AnyUser>;
 }
 
-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 { AutoPlayPlatform, AutoPlayUtils, AvailableFilters, DiscordJSManager, DiscordenoManager, 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, AnyMessage, AnyUser, 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, PortableMessage, 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

@@ -11,9 +11,9 @@ 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/discordeno"), exports);
 tslib_1.__exportStar(require("./wrappers/discord.js"), exports);
 tslib_1.__exportStar(require("./wrappers/eris"), exports);
-tslib_1.__exportStar(require("./wrappers/detritus"), exports);
 tslib_1.__exportStar(require("./wrappers/oceanic"), exports);
 tslib_1.__exportStar(require("./wrappers/seyfert"), exports);
 // types

package/dist/statestorage/JsonQueue.js

@@ -373,7 +373,7 @@ class JsonQueue {
             const queue = await this.getQueue();
             const userMap = new Map();
             for (const track of queue) {
-                const userId = track.requester.id;
+                const userId = track.requester.id.toString();
                 if (!userMap.has(userId))
                     userMap.set(userId, []);
                 userMap.get(userId).push(track);
@@ -498,7 +498,7 @@ class JsonQueue {
             const queue = await this.getQueue();
             const userMap = new Map();
             for (const track of queue) {
-                const userId = track.requester.id;
+                const userId = track.requester.id.toString();
                 if (!userMap.has(userId))
                     userMap.set(userId, []);
                 userMap.get(userId).push(track);

package/dist/statestorage/MemoryQueue.js

@@ -355,11 +355,11 @@ class MemoryQueue extends Array {
             const userTracks = new Map();
             // Group the tracks in the queue by the user that requested them.
             this.forEach((track) => {
-                const user = track.requester.id;
-                if (!userTracks.has(user)) {
-                    userTracks.set(user, []);
+                const userId = track.requester.id.toString();
+                if (!userTracks.has(userId)) {
+                    userTracks.set(userId, []);
                 }
-                userTracks.get(user).push(track);
+                userTracks.get(userId).push(track);
             });
             // Shuffle the tracks of each user.
             userTracks.forEach((tracks) => {
@@ -486,11 +486,11 @@ class MemoryQueue extends Array {
             // Group the tracks in the queue by the user that requested them.
             const userTracks = new Map();
             this.forEach((track) => {
-                const user = track.requester.id;
-                if (!userTracks.has(user)) {
-                    userTracks.set(user, []);
+                const userId = track.requester.id.toString();
+                if (!userTracks.has(userId)) {
+                    userTracks.set(userId, []);
                 }
-                userTracks.get(user).push(track);
+                userTracks.get(userId).push(track);
             });
             // Create a new array for the shuffled queue.
             const shuffledQueue = [];

package/dist/statestorage/RedisQueue.js

@@ -513,7 +513,7 @@ class RedisQueue {
             const deserialized = rawTracks.map(this.deserialize);
             const userMap = new Map();
             for (const track of deserialized) {
-                const userId = track.requester.id;
+                const userId = track.requester.id.toString();
                 if (!userMap.has(userId))
                     userMap.set(userId, []);
                 userMap.get(userId).push(track);
@@ -684,7 +684,7 @@ class RedisQueue {
             const deserialized = rawTracks.map(this.deserialize);
             const userMap = new Map();
             for (const track of deserialized) {
-                const userId = track.requester.id;
+                const userId = track.requester.id.toString();
                 if (!userMap.has(userId))
                     userMap.set(userId, []);
                 userMap.get(userId).push(track);

package/dist/structures/Enums.js

@@ -285,6 +285,7 @@ var MagmaStreamErrorCode;
     MagmaStreamErrorCode["GENERAL_UNKNOWN"] = "MS_GENERAL_UNKNOWN";
     MagmaStreamErrorCode["GENERAL_TIMEOUT"] = "MS_GENERAL_TIMEOUT";
     MagmaStreamErrorCode["GENERAL_INVALID_MANAGER"] = "MS_GENERAL_INVALID_MANAGER";
+    MagmaStreamErrorCode["INTENT_MISSING"] = "MS_INTENT_MISSING";
     // MANAGER (1100)
     MagmaStreamErrorCode["MANAGER_INIT_FAILED"] = "MS_MANAGER_INIT_FAILED";
     MagmaStreamErrorCode["MANAGER_INVALID_CONFIG"] = "MS_MANAGER_INVALID_CONFIG";
@@ -328,6 +329,7 @@ var MagmaStreamErrorCode;
     MagmaStreamErrorCode["UTILS_TRACK_PARTIAL_INVALID"] = "MS_UTILS_TRACK_PARTIAL_INVALID";
     MagmaStreamErrorCode["UTILS_TRACK_BUILD_FAILED"] = "MS_UTILS_TRACK_BUILD_FAILED";
     MagmaStreamErrorCode["UTILS_AUTOPLAY_BUILD_FAILED"] = "MS_UTILS_AUTOPLAY_BUILD_FAILED";
+    MagmaStreamErrorCode["UTILS_PLAYER_SERIALIZE_FAILED"] = "MS_UTILS_PLAYER_SERIALIZE_FAILED";
     // PLUGIN (1800)
     MagmaStreamErrorCode["PLUGIN_LOAD_FAILED"] = "MS_PLUGIN_LOAD_FAILED";
     MagmaStreamErrorCode["PLUGIN_RUNTIME_ERROR"] = "MS_PLUGIN_RUNTIME_ERROR";
@@ -338,6 +340,7 @@ exports.MagmaStreamErrorNumbers = {
     [MagmaStreamErrorCode.GENERAL_UNKNOWN]: 1000,
     [MagmaStreamErrorCode.GENERAL_TIMEOUT]: 1001,
     [MagmaStreamErrorCode.GENERAL_INVALID_MANAGER]: 1002,
+    [MagmaStreamErrorCode.INTENT_MISSING]: 1003,
     // MANAGER
     [MagmaStreamErrorCode.MANAGER_INIT_FAILED]: 1100,
     [MagmaStreamErrorCode.MANAGER_INVALID_CONFIG]: 1101,
@@ -381,6 +384,7 @@ exports.MagmaStreamErrorNumbers = {
     [MagmaStreamErrorCode.UTILS_TRACK_PARTIAL_INVALID]: 1700,
     [MagmaStreamErrorCode.UTILS_TRACK_BUILD_FAILED]: 1701,
     [MagmaStreamErrorCode.UTILS_AUTOPLAY_BUILD_FAILED]: 1702,
+    [MagmaStreamErrorCode.UTILS_PLAYER_SERIALIZE_FAILED]: 1703,
     // PLUGIN
     [MagmaStreamErrorCode.PLUGIN_LOAD_FAILED]: 1800,
     [MagmaStreamErrorCode.PLUGIN_RUNTIME_ERROR]: 1801,

package/dist/structures/Manager.js

@@ -28,6 +28,7 @@ class Manager extends events_1.EventEmitter {
     initiated = false;
     redis;
     _send;
+    _getUser;
     loadedPlugins = new Set();
     /**
      * Initiates the Manager class.
@@ -61,6 +62,8 @@ class Manager extends events_1.EventEmitter {
             this.options.clusterId = options.clusterId;
         if (options.send && !this._send)
             this._send = options.send;
+        if (options.getUser && !this._getUser)
+            this._getUser = options.getUser;
         this.options = {
             ...options,
             enabledPlugins: options.enabledPlugins ?? [],
@@ -1439,6 +1442,9 @@ class Manager extends events_1.EventEmitter {
         }
         return this._send(packet);
     }
+    getUserFromCache(id) {
+        return this._getUser?.(id);
+    }
     sendPacket(packet) {
         return this.send(packet);
     }

package/dist/structures/Player.js

@@ -1082,6 +1082,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/Utils.js

@@ -9,7 +9,7 @@ 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");
-const lodash_1 = require("lodash");
+// import { isPlainObject } from "lodash";
 // import playwright from "playwright";
 /** @hidden */
 const SIZES = ["0", "1", "2", "3", "default", "mqdefault", "hqdefault", "maxresdefault"];
@@ -623,20 +623,6 @@ class PlayerUtils {
      * @returns The serialized Player instance
      */
     static async serializePlayer(player) {
-        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;
         const isNonSerializable = (value) => {
             if (typeof value === "function" || typeof value === "symbol")
                 return true;
@@ -653,59 +639,99 @@ class PlayerUtils {
             }
             return false;
         };
-        const safeReplacer = (key, value) => {
-            if (isNonSerializable(value))
-                return undefined;
-            if (key === "manager")
-                return null;
-            if (key === "node")
-                return safeNode;
-            if (key === "filters") {
-                const filters = { ...value };
-                delete filters.player;
-                return {
-                    distortion: filters["distortion"] ?? null,
-                    equalizer: filters["equalizer"] ?? [],
-                    karaoke: filters["karaoke"] ?? null,
-                    rotation: filters["rotation"] ?? null,
-                    timescale: value["timescale"] ?? null,
-                    vibrato: value["vibrato"] ?? null,
-                    reverb: value["reverb"] ?? null,
-                    volume: value["volume"] ?? 1.0,
-                    bassBoostlevel: value["bassBoostlevel"] ?? null,
-                    filterStatus: (0, lodash_1.isPlainObject)(value["filtersStatus"]) ? { ...value["filtersStatus"] } : {},
-                };
-            }
-            if (key === "queue") {
-                return {
-                    current: current ? serializeTrack(current) : null,
-                    tracks: tracks.map(serializeTrack),
-                    previous: previous.map(serializeTrack),
-                };
-            }
-            if (key === "data" && (0, lodash_1.isPlainObject)(value)) {
-                return {
-                    clientUser: value["Internal_AutoplayUser"] ?? null,
-                    nowPlayingMessage: value["nowPlayingMessage"] ?? null,
-                };
+        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 value;
+            return result;
         };
-        let serialized;
         try {
-            serialized = JSON.stringify(player, safeReplacer);
+            const [current, tracks, previous] = await Promise.all([player.queue.getCurrent(), player.queue.getTracks(), player.queue.getPrevious()]);
+            const serializeTrack = (track) => {
+                try {
+                    return {
+                        ...track,
+                        requester: track.requester ? { id: track.requester.id, username: track.requester.username } : null,
+                    };
+                }
+                catch {
+                    return 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;
+                    }));
+                }
+                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) {
             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;
         }
-        return JSON.parse(serialized);
     }
     /**
      * Gets the base directory for player data.

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;

package/dist/wrappers/discordeno.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiscordenoManager = void 0;
+const tslib_1 = require("tslib");
+const Manager_1 = require("../structures/Manager");
+const bot_1 = require("@discordeno/bot");
+const Enums_1 = require("../structures/Enums");
+const MagmastreamError_1 = require("../structures/MagmastreamError");
+tslib_1.__exportStar(require("../index"), exports);
+/**
+ * Discordeno wrapper for Magmastream.
+ */
+class DiscordenoManager extends Manager_1.Manager {
+    client;
+    constructor(client, options) {
+        super(options);
+        this.client = client;
+        // Ensure GuildVoiceStates intent is enabled
+        const intents = this.client.gateway.intents;
+        if (!(intents & bot_1.GatewayIntents.GuildVoiceStates)) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.INTENT_MISSING,
+                message: "[Custom Wrapper] Your Discordeno client must have the GuildVoiceStates intent enabled.",
+            });
+        }
+        // Chain READY event
+        const oldReady = this.client.handlers.READY;
+        this.client.handlers.READY = (bot, payload, shardId) => {
+            if (oldReady)
+                oldReady(bot, payload, shardId);
+            if (!this.options?.clientId)
+                this.options.clientId = this.client.applicationId.toString();
+        };
+        // Chain VOICE_STATE_UPDATE event
+        const oldVoiceState = this.client.handlers.VOICE_STATE_UPDATE;
+        this.client.handlers.VOICE_STATE_UPDATE = (bot, payload, shardId) => {
+            if (oldVoiceState)
+                oldVoiceState(bot, payload, shardId);
+            this.updateVoiceState(payload);
+        };
+        // Chain VOICE_SERVER_UPDATE event
+        const oldVoiceServer = this.client.handlers.VOICE_SERVER_UPDATE;
+        this.client.handlers.VOICE_SERVER_UPDATE = (bot, payload, shardId) => {
+            if (oldVoiceServer)
+                oldVoiceServer(bot, payload, shardId);
+            this.updateVoiceState(payload);
+        };
+    }
+    // Send voice state updates to the guild shard
+    send(packet) {
+        this.client.gateway.sendPayload(this.client.gateway.calculateShardId(packet.d.guild_id), {
+            op: bot_1.GatewayOpcodes.VoiceStateUpdate,
+            d: packet.d,
+        });
+    }
+    /**
+     * Resolve a user by ID or partial info.
+     * Uses user-provided cache getter if available, otherwise falls back to minimal info.
+     */
+    async resolveUser(user) {
+        const id = typeof user === "string" ? user : String(user.id);
+        // Try user-provided cache getter
+        const cached = this.getUserFromCache(id);
+        if (cached)
+            return cached;
+        // Fallback: return minimal info
+        return {
+            id,
+            username: typeof user === "string" ? undefined : user.username,
+        };
+    }
+}
+exports.DiscordenoManager = DiscordenoManager;

package/dist/wrappers/eris.js

@@ -2,7 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ErisManager = void 0;
 const tslib_1 = require("tslib");
+const v10_1 = require("discord-api-types/v10");
 const Manager_1 = require("../structures/Manager");
+const Enums_1 = require("../structures/Enums");
+const MagmastreamError_1 = require("../structures/MagmastreamError");
 tslib_1.__exportStar(require("../index"), exports);
 /**
  * Eris wrapper for Magmastream.
@@ -12,11 +15,19 @@ class ErisManager extends Manager_1.Manager {
     constructor(client, options) {
         super(options);
         this.client = client;
-        client.once("ready", () => {
+        const intents = this.client.options.intents;
+        const hasGuildVoiceStates = typeof intents === "number" ? (intents & v10_1.GatewayIntentBits.GuildVoiceStates) === v10_1.GatewayIntentBits.GuildVoiceStates : intents.includes("guildVoiceStates");
+        if (!hasGuildVoiceStates) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.INTENT_MISSING,
+                message: "[Custom Wrapper] Your Eris client must have the guildVoiceStates intent enabled.",
+            });
+        }
+        this.client.once("ready", () => {
             if (!this.options.clientId)
                 this.options.clientId = client.user.id;
         });
-        client.on("rawWS", async (packet) => {
+        this.client.on("rawWS", async (packet) => {
             await this.updateVoiceState(packet);
         });
     }
@@ -26,7 +37,7 @@ class ErisManager extends Manager_1.Manager {
             guild.shard.sendWS(packet.op, packet.d);
     }
     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.get(id);
         if (cached)
             return cached;

package/dist/wrappers/oceanic.js

@@ -3,6 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OceanicManager = void 0;
 const tslib_1 = require("tslib");
 const Manager_1 = require("../structures/Manager");
+const oceanic_js_1 = require("oceanic.js");
+const Enums_1 = require("../structures/Enums");
+const MagmastreamError_1 = require("../structures/MagmastreamError");
 tslib_1.__exportStar(require("../index"), exports);
 /**
  * Oceanic wrapper for Magmastream.
@@ -12,11 +15,20 @@ class OceanicManager extends Manager_1.Manager {
     constructor(client, options) {
         super(options);
         this.client = client;
-        client.once("ready", () => {
+        const intents = this.client.shards.options.intents;
+        const { Intents } = oceanic_js_1.Constants;
+        const hasGuildVoiceStates = typeof intents === "number" ? (intents & Intents.GUILD_VOICE_STATES) === Intents.GUILD_VOICE_STATES : intents.includes("GUILD_VOICE_STATES");
+        if (!hasGuildVoiceStates) {
+            throw new MagmastreamError_1.MagmaStreamError({
+                code: Enums_1.MagmaStreamErrorCode.INTENT_MISSING,
+                message: "[Custom Wrapper] Your Oceanic client must have the GUILD_VOICE_STATES intent enabled.",
+            });
+        }
+        this.client.once("ready", () => {
             if (!this.options.clientId)
-                this.options.clientId = client.user.id;
+                this.options.clientId = this.client.user.id;
         });
-        client.on("packet", async (packet) => {
+        this.client.on("packet", async (packet) => {
             await this.updateVoiceState(packet);
         });
     }
@@ -26,7 +38,7 @@ class OceanicManager extends Manager_1.Manager {
             guild.shard.send(packet.op, packet.d);
     }
     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.get(id);
         if (cached)
             return cached;

package/dist/wrappers/seyfert.js

@@ -4,7 +4,10 @@ exports.SeyfertManager = void 0;
 const tslib_1 = require("tslib");
 const Manager_1 = require("../structures/Manager");
 const seyfert_1 = require("seyfert");
+const types_1 = require("seyfert/lib/types");
 const common_1 = require("seyfert/lib/common");
+const MagmastreamError_1 = require("../structures/MagmastreamError");
+const Enums_1 = require("../structures/Enums");
 tslib_1.__exportStar(require("../index"), exports);
 /**
  * Seyfert wrapper for Magmastream.
@@ -36,6 +39,21 @@ class SeyfertManager extends Manager_1.Manager {
     constructor(client, options) {
         super(options);
         this.client = client;
+        this.client
+            .getRC()
+            .then((rc) => {
+            if (!(rc.intents & types_1.GatewayIntentBits.GuildVoiceStates)) {
+                throw new MagmastreamError_1.MagmaStreamError({
+                    code: Enums_1.MagmaStreamErrorCode.INTENT_MISSING,
+                    message: "[Custom Wrapper] Your Seyfert client must have the GuildVoiceStates intent enabled.",
+                });
+            }
+        })
+            .catch((error) => {
+            queueMicrotask(() => {
+                throw error;
+            });
+        });
     }
     send(packet) {
         if (this.client instanceof seyfert_1.Client) {
@@ -46,7 +64,7 @@ class SeyfertManager extends Manager_1.Manager {
         }
     }
     async resolveUser(user) {
-        const id = typeof user === "string" ? user : user.id;
+        const id = typeof user === "string" ? user : String(user.id);
         const cached = this.client.cache.users?.get(id);
         if (cached)
             return cached;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "magmastream",
-	"version": "2.9.3-dev.13",
+	"version": "2.9.3-dev.15",
 	"description": "A user-friendly Lavalink client designed for NodeJS.",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -44,7 +44,7 @@
 		"ws": "^8.19.0"
 	},
 	"optionalDependencies": {
-		"detritus-client": "0.16.x",
+		"discordeno": "21.x",
 		"discord.js": "14.x",
 		"eris": "0.18.x",
 		"oceanic.js": "^1.13.0",

package/dist/wrappers/detritus.js

@@ -1,52 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DetritusManager = void 0;
-const tslib_1 = require("tslib");
-const Manager_1 = require("../structures/Manager");
-const detritus_client_1 = require("detritus-client");
-tslib_1.__exportStar(require("../index"), exports);
-/**
- * Detritus wrapper for Magmastream.
- */
-class DetritusManager extends Manager_1.Manager {
-    client;
-    constructor(client, options) {
-        super(options);
-        this.client = client;
-        client.once("ready", () => {
-            if (!this.options.clientId)
-                this.options.clientId = client instanceof detritus_client_1.ClusterClient ? client.applicationId : client.clientId;
-        });
-        client.on("raw", async (packet) => {
-            await this.updateVoiceState(packet);
-        });
-    }
-    send(packet) {
-        const asCluster = this.client;
-        const asShard = this.client;
-        if (asShard.guilds)
-            return asShard.gateway.send(packet.op, packet.d);
-        if (asCluster.shards) {
-            const shard = asCluster.shards.find((c) => c.guilds.has(packet.d.guild_id));
-            if (shard)
-                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;