magmastream 2.9.0-dev.0 → 2.9.0-dev.10

package/dist/structures/Player.js

@@ -9,6 +9,7 @@ const Queue_1 = require("./Queue");
 const Utils_1 = require("./Utils");
 const _ = tslib_1.__importStar(require("lodash"));
 const playerCheck_1 = tslib_1.__importDefault(require("../utils/playerCheck"));
+const RedisQueue_1 = require("./RedisQueue");
 class Player {
     options;
     /** The Queue for the Player. */
@@ -50,7 +51,7 @@ class Player {
     /** The autoplay state of the player. */
     isAutoplay = false;
     /** The number of times to try autoplay before emitting queueEnd. */
-    autoplayTries = null;
+    autoplayTries = 3;
     static _manager;
     data = {};
     dynamicLoopInterval = null;
@@ -67,10 +68,6 @@ class Player {
             this.manager = Utils_1.Structure.get("Player")._manager;
         if (!this.manager)
             throw new RangeError("Manager has not been initiated.");
-        // If a player with the same guild ID already exists, return it.
-        if (this.manager.players.has(options.guildId)) {
-            return this.manager.players.get(options.guildId);
-        }
         // Check the player options for errors.
         (0, playerCheck_1.default)(options);
         // Set the guild ID and voice state.
@@ -91,8 +88,15 @@ class Player {
         if (!this.node)
             throw new RangeError("No available nodes.");
         // Initialize the queue with the guild ID and manager.
-        this.queue = new Queue_1.Queue(this.guildId, this.manager);
-        this.queue.previous = new Array();
+        if (this.manager.options.stateStorage.type === Manager_1.StateStorageType.Redis) {
+            this.queue = new RedisQueue_1.RedisQueue(this.guildId, this.manager);
+        }
+        else {
+            this.queue = new Queue_1.Queue(this.guildId, this.manager);
+        }
+        if (this.queue instanceof Queue_1.Queue) {
+            this.queue.previous = [];
+        }
         // Add the player to the manager's player collection.
         this.manager.players.set(options.guildId, this);
         // Set the initial volume.
@@ -225,7 +229,7 @@ class Player {
             await this.disconnect();
         }
         await this.node.rest.destroyPlayer(this.guildId);
-        this.queue.clear();
+        await this.queue.clear();
         this.manager.emit(Manager_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, null, {
             changeType: Manager_1.PlayerStateEventTypes.PlayerDestroy,
         });
@@ -307,9 +311,9 @@ class Player {
     }
     async play(optionsOrTrack, playOptions) {
         if (typeof optionsOrTrack !== "undefined" && Utils_1.TrackUtils.validate(optionsOrTrack)) {
-            this.queue.current = optionsOrTrack;
+            await this.queue.setCurrent(optionsOrTrack);
         }
-        if (!this.queue.current)
+        if (!(await this.queue.getCurrent()))
             throw new RangeError("No current track.");
         const finalOptions = playOptions
             ? playOptions
@@ -319,7 +323,7 @@ class Player {
         await this.node.rest.updatePlayer({
             guildId: this.guildId,
             data: {
-                encodedTrack: this.queue.current?.track,
+                encodedTrack: (await this.queue.getCurrent()).track,
                 ...finalOptions,
             },
         });
@@ -375,119 +379,9 @@ class Player {
      * @returns {Promise<Track[]>} - Array of recommended tracks.
      */
     async getRecommendedTracks(track) {
-        const tracks = await Utils_1.AutoPlayUtils.getRecommendedTracks(this, track);
+        const tracks = await Utils_1.AutoPlayUtils.getRecommendedTracks(track);
         return tracks;
-        // const node = this.manager.useableNode;
-        // if (!node) {
-        // 	throw new Error("No available nodes.");
-        // }
-        // if (!TrackUtils.validate(track)) {
-        // 	throw new RangeError('"Track must be a "Track" or "Track[]');
-        // }
-        // // Get the Last.fm API key and the available source managers
-        // const apiKey = this.manager.options.lastFmApiKey;
-        // const enabledSources = node.info.sourceManagers;
-        // // Determine if YouTube should be used
-        // if (!apiKey && enabledSources.includes("youtube")) {
-        // 	// Use YouTube-based autoplay
-        // 	return await this.handleYouTubeRecommendations(track);
-        // }
-        // if (!apiKey) return [];
-        // // Handle Last.fm-based autoplay (or other platforms)
-        // const selectedSource = node.selectPlatform(enabledSources);
-        // if (selectedSource) {
-        // 	// Use the selected source to handle autoplay
-        // 	return await this.handlePlatformAutoplay(track, selectedSource, apiKey);
-        // }
-        // // If no source is available, return false
-        // return [];
     }
-    // /**
-    //  * Handles YouTube-based recommendations.
-    //  * @param {Track} track - The track to find recommendations for.
-    //  * @returns {Promise<Track[]>} - Array of recommended tracks.
-    //  */
-    // private async handleYouTubeRecommendations(track: Track): Promise<Track[]> {
-    // 	// Check if the previous track has a YouTube URL
-    // 	const hasYouTubeURL = ["youtube.com", "youtu.be"].some((url) => track.uri.includes(url));
-    // 	// Get the video ID from the previous track's URL
-    // 	let videoID: string | null = null;
-    // 	if (hasYouTubeURL) {
-    // 		videoID = track.uri.split("=").pop();
-    // 	} else {
-    // 		const searchResult = await this.manager.search({ query: `${track.author} - ${track.title}`, source: SearchPlatform.YouTube }, track.requester);
-    // 		videoID = searchResult.tracks[0]?.uri.split("=").pop();
-    // 	}
-    // 	// If the video ID is not found, return false
-    // 	if (!videoID) return [];
-    // 	// Get a random video index between 2 and 24
-    // 	let randomIndex: number;
-    // 	let searchURI: string;
-    // 	do {
-    // 		// Generate a random index between 2 and 24
-    // 		randomIndex = Math.floor(Math.random() * 23) + 2;
-    // 		// Build the search URI
-    // 		searchURI = `https://www.youtube.com/watch?v=${videoID}&list=RD${videoID}&index=${randomIndex}`;
-    // 	} while (track.uri.includes(searchURI));
-    // 	// Search for the video and return false if the search fails
-    // 	const res = await this.manager.search({ query: searchURI, source: SearchPlatform.YouTube }, track.requester);
-    // 	if (res.loadType === LoadTypes.Empty || res.loadType === LoadTypes.Error) return [];
-    // 	// Return all track titles that do not have the same URI as the track.uri from before
-    // 	return res.tracks.filter((t) => t.uri !== track.uri);
-    // }
-    // /**
-    //  * Handles Last.fm-based autoplay (or other platforms).
-    //  * @param {Track} track - The track to find recommendations for.
-    //  * @param {SearchPlatform} source - The selected search platform.
-    //  * @param {string} apiKey - The Last.fm API key.
-    //  * @returns {Promise<Track[]>} - Array of recommended tracks.
-    //  */
-    // private async handlePlatformAutoplay(track: Track, source: SearchPlatform, apiKey: string): Promise<Track[]> {
-    // 	let { author: artist } = track;
-    // 	const { title } = track;
-    // 	if (!artist || !title) {
-    // 		if (!title) {
-    // 			// No title provided, search for the artist's top tracks
-    // 			const noTitleUrl = `https://ws.audioscrobbler.com/2.0/?method=artist.getTopTracks&artist=${artist}&autocorrect=1&api_key=${apiKey}&format=json`;
-    // 			const response = await axios.get(noTitleUrl);
-    // 			if (response.data.error || !response.data.toptracks?.track?.length) return [];
-    // 			const randomTrack = response.data.toptracks.track[Math.floor(Math.random() * response.data.toptracks.track.length)];
-    // 			const res = await this.manager.search({ query: `${randomTrack.artist.name} - ${randomTrack.name}`, source: source }, track.requester);
-    // 			if (res.loadType === LoadTypes.Empty || res.loadType === LoadTypes.Error) return [];
-    // 			const filteredTracks = res.tracks.filter((t) => t.uri !== track.uri);
-    // 			if (!filteredTracks) return [];
-    // 			return filteredTracks;
-    // 		}
-    // 		if (!artist) {
-    // 			// No artist provided, search for the track title
-    // 			const noArtistUrl = `https://ws.audioscrobbler.com/2.0/?method=track.search&track=${title}&api_key=${apiKey}&format=json`;
-    // 			const response = await axios.get(noArtistUrl);
-    // 			artist = response.data.results.trackmatches?.track?.[0]?.artist;
-    // 			if (!artist) return [];
-    // 		}
-    // 	}
-    // 	// Search for similar tracks to the current track
-    // 	const url = `https://ws.audioscrobbler.com/2.0/?method=track.getSimilar&artist=${artist}&track=${title}&limit=10&autocorrect=1&api_key=${apiKey}&format=json`;
-    // 	let response: axios.AxiosResponse;
-    // 	try {
-    // 		response = await axios.get(url);
-    // 	} catch (error) {
-    // 		if (error) return [];
-    // 	}
-    // 	if (response.data.error || !response.data.similartracks?.track?.length) {
-    // 		// Retry the request if the first attempt fails
-    // 		const retryUrl = `https://ws.audioscrobbler.com/2.0/?method=artist.getTopTracks&artist=${artist}&autocorrect=1&api_key=${apiKey}&format=json`;
-    // 		const retryResponse = await axios.get(retryUrl);
-    // 		if (retryResponse.data.error || !retryResponse.data.toptracks?.track?.length) return [];
-    // 		const randomTrack = retryResponse.data.toptracks.track[Math.floor(Math.random() * retryResponse.data.toptracks.track.length)];
-    // 		const res = await this.manager.search({ query: `${randomTrack.artist.name} - ${randomTrack.name}`, source: source }, track.requester);
-    // 		if (res.loadType === LoadTypes.Empty || res.loadType === LoadTypes.Error) return [];
-    // 		const filteredTracks = res.tracks.filter((t) => t.uri !== track.uri);
-    // 		if (!filteredTracks) return [];
-    // 		return filteredTracks;
-    // 	}
-    // 	return response.data.similartracks.track.filter((t: { uri: string }) => t.uri !== track.uri);
-    // }
     /**
      * Sets the volume of the player.
      * @param {number} volume - The new volume. Must be between 0 and 1000.
@@ -619,13 +513,13 @@ class Player {
      * @throws {TypeError} If the repeat parameter is not a boolean.
      * @throws {RangeError} If the queue size is less than or equal to 1.
      */
-    setDynamicRepeat(repeat, ms) {
+    async setDynamicRepeat(repeat, ms) {
         // Validate the repeat parameter
         if (typeof repeat !== "boolean") {
             throw new TypeError('Repeat can only be "true" or "false".');
         }
         // Ensure the queue has more than one track for dynamic repeat
-        if (this.queue.size <= 1) {
+        if ((await this.queue.size()) <= 1) {
             throw new RangeError("The queue size must be greater than 1.");
         }
         // Clone the current player state for comparison
@@ -636,15 +530,14 @@ class Player {
             this.queueRepeat = false;
             this.dynamicRepeat = true;
             // Set an interval to shuffle the queue periodically
-            this.dynamicLoopInterval = setInterval(() => {
+            this.dynamicLoopInterval = setInterval(async () => {
                 if (!this.dynamicRepeat)
                     return;
                 // Shuffle the queue and replace it with the shuffled tracks
-                const shuffled = _.shuffle(this.queue);
-                this.queue.clear();
-                shuffled.forEach((track) => {
-                    this.queue.add(track);
-                });
+                const tracks = await this.queue.getTracks();
+                const shuffled = _.shuffle(tracks);
+                await this.queue.clear();
+                await this.queue.add(shuffled);
             }, ms);
             // Store the ms value
             this.dynamicRepeatIntervalMs = ms;
@@ -675,9 +568,9 @@ class Player {
      */
     async restart() {
         // Check if there is a current track in the queue
-        if (!this.queue.current?.track) {
+        if (!(await this.queue.getCurrent())?.track) {
             // If the queue has tracks, play the next one
-            if (this.queue.length)
+            if (await this.queue.size())
                 await this.play();
             return this;
         }
@@ -686,7 +579,7 @@ class Player {
             guildId: this.guildId,
             data: {
                 position: 0,
-                encodedTrack: this.queue.current?.track,
+                encodedTrack: (await this.queue.getCurrent())?.track,
             },
         });
         return this;
@@ -701,10 +594,10 @@ class Player {
         const oldPlayer = { ...this };
         let removedTracks = [];
         if (typeof amount === "number" && amount > 1) {
-            if (amount > this.queue.length)
+            if (amount > (await this.queue.size()))
                 throw new RangeError("Cannot skip more than the queue length.");
-            removedTracks = this.queue.slice(0, amount - 1);
-            this.queue.splice(0, amount - 1);
+            removedTracks = await this.queue.getSlice(0, amount - 1);
+            await this.queue.modifyAt(0, amount - 1);
         }
         this.node.rest.updatePlayer({
             guildId: this.guildId,
@@ -764,7 +657,7 @@ class Player {
      */
     async previous() {
         // Check if there are previous tracks in the queue.
-        if (!this.queue.previous.length) {
+        if (!(await this.queue.getPrevious()).length) {
             throw new Error("No previous track available.");
         }
         // Capture the current state of the player before making changes.
@@ -772,7 +665,7 @@ class Player {
         // Store the current track before changing it.
         // let currentTrackBeforeChange: Track | null = this.queue.current ? (this.queue.current as Track) : null;
         // Get the last played track and remove it from the history
-        const lastTrack = this.queue.previous.pop();
+        const lastTrack = (await this.queue.getPrevious()).pop();
         // Set the skip flag to true to prevent the onTrackEnd event from playing the next track.
         this.set("skipFlag", true);
         await this.play(lastTrack);
@@ -798,7 +691,7 @@ class Player {
      * @emits {PlayerStateUpdate} - With {@link PlayerStateEventTypes.TrackChange} as the change type.
      */
     async seek(position) {
-        if (!this.queue.current)
+        if (!(await this.queue.getCurrent()))
             return undefined;
         position = Number(position);
         // Check if the position is valid.
@@ -808,8 +701,8 @@ class Player {
         // Get the old player state.
         const oldPlayer = this ? { ...this } : null;
         // Clamp the position to ensure it is within the valid range.
-        if (position < 0 || position > this.queue.current.duration) {
-            position = Math.max(Math.min(position, this.queue.current.duration), 0);
+        if (position < 0 || position > (await this.queue.getCurrent()).duration) {
+            position = Math.max(Math.min(position, (await this.queue.getCurrent()).duration), 0);
         }
         // Update the player's position.
         this.position = position;
@@ -874,7 +767,7 @@ class Player {
         try {
             const playerPosition = this.position;
             const { sessionId, event: { token, endpoint }, } = this.voiceState;
-            const currentTrack = this.queue.current ? this.queue.current : null;
+            const currentTrack = (await this.queue.getCurrent()) ? await this.queue.getCurrent() : null;
             await this.node.rest.destroyPlayer(this.guildId).catch(() => { });
             this.manager.players.delete(this.guildId);
             this.node = node;
@@ -905,7 +798,7 @@ class Player {
         if (!newOptions.textChannelId)
             throw new Error("Text channel ID is required");
         // Check if a player already exists for the new guild
-        let newPlayer = this.manager.players.get(newOptions.guildId);
+        let newPlayer = await this.manager.getPlayer(newOptions.guildId);
         // If the player already exists and force is false, return the existing player
         if (newPlayer && !force)
             return newPlayer;
@@ -916,9 +809,9 @@ class Player {
             volume: this.volume,
             position: this.position,
             queue: {
-                current: this.queue.current,
-                tracks: [...this.queue],
-                previous: [...this.queue.previous],
+                current: await this.queue.getCurrent(),
+                tracks: [...(await this.queue.getTracks())],
+                previous: [...(await this.queue.getPrevious())],
             },
             trackRepeat: this.trackRepeat,
             queueRepeat: this.queueRepeat,
@@ -938,7 +831,7 @@ class Player {
         newOptions.selfMute = newOptions.selfMute ?? oldPlayerProperties.selfMute;
         newOptions.volume = newOptions.volume ?? oldPlayerProperties.volume;
         // Deep clone the current player
-        const clonedPlayer = this.manager.create(newOptions);
+        const clonedPlayer = await this.manager.create(newOptions);
         // Connect the cloned player to the new voice channel
         clonedPlayer.connect();
         // Update the player's state on the Lavalink node
@@ -951,9 +844,9 @@ class Player {
                 encodedTrack: oldPlayerProperties.queue.current?.track,
             },
         });
-        clonedPlayer.queue.current = oldPlayerProperties.queue.current;
-        clonedPlayer.queue.previous = oldPlayerProperties.queue.previous;
-        clonedPlayer.queue.add(oldPlayerProperties.queue.tracks);
+        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;
@@ -968,7 +861,7 @@ class Player {
         // Debug information
         const debugInfo = {
             success: true,
-            message: `Transferred ${clonedPlayer.queue.length} tracks successfully to <#${newOptions.voiceChannelId}> bound to <#${newOptions.textChannelId}>.`,
+            message: `Transferred ${await clonedPlayer.queue.size()} tracks successfully to <#${newOptions.voiceChannelId}> bound to <#${newOptions.textChannelId}>.`,
             player: {
                 guildId: clonedPlayer.guildId,
                 voiceChannelId: clonedPlayer.voiceChannelId,
@@ -995,7 +888,7 @@ class Player {
             throw new RangeError(`There is no lavalyrics-plugin available in the Lavalink node: ${this.node.options.identifier}`);
         }
         // Fetch the lyrics for the current track from the Lavalink node
-        let result = (await this.node.getLyrics(this.queue.current, skipTrackSource));
+        let result = (await this.node.getLyrics(await this.queue.getCurrent(), skipTrackSource));
         // If no lyrics are found, return a default empty lyrics object
         if (!result) {
             result = {

package/dist/structures/Queue.js

@@ -6,14 +6,52 @@ const Manager_1 = require("./Manager"); // Import Manager to access emit method
  * The player's queue, the `current` property is the currently playing track, think of the rest as the up-coming tracks.
  */
 class Queue extends Array {
+    /** The current track */
+    current = null;
+    /** The previous tracks */
+    previous = [];
+    /** The Manager instance. */
+    manager;
+    /** The guild ID property. */
+    guildId;
+    /**
+     * Constructs a new Queue.
+     * @param guildId The guild ID.
+     * @param manager The Manager instance.
+     */
+    constructor(guildId, manager) {
+        super();
+        /** The Manager instance. */
+        this.manager = manager;
+        /** The guild property. */
+        this.guildId = guildId;
+    }
+    async getCurrent() {
+        return this.current;
+    }
+    async setCurrent(track) {
+        this.current = track;
+    }
+    async getPrevious() {
+        return this.previous;
+    }
+    async addPrevious(track) {
+        if (Array.isArray(track)) {
+            this.previous.unshift(...track);
+        }
+        else {
+            this.previous.unshift(track);
+        }
+    }
+    async clearPrevious() {
+        this.previous = [];
+    }
     /**
      * The total duration of the queue in milliseconds.
      * This includes the duration of the currently playing track.
      */
-    get duration() {
-        // Get the duration of the currently playing track, or 0 if there is none.
+    async duration() {
         const current = this.current?.duration ?? 0;
-        // Return the sum of all durations in the queue including the current track.
         return this.reduce((acc, cur) => acc + (cur.duration || 0), current);
     }
     /**
@@ -21,7 +59,7 @@ class Queue extends Array {
      * This includes the current track if it is not null.
      * @returns The total size of tracks in the queue including the current track.
      */
-    get totalSize() {
+    async totalSize() {
         return this.length + (this.current ? 1 : 0);
     }
     /**
@@ -29,40 +67,20 @@ class Queue extends Array {
      * This does not include the currently playing track.
      * @returns The size of tracks in the queue.
      */
-    get size() {
+    async size() {
         return this.length;
     }
-    /** The current track */
-    current = null;
-    /** The previous tracks */
-    previous = [];
-    /** The Manager instance. */
-    manager;
-    /** The guild ID property. */
-    guildId;
-    /**
-     * Constructs a new Queue.
-     * @param guildId The guild ID.
-     * @param manager The Manager instance.
-     */
-    constructor(guildId, manager) {
-        super();
-        /** The Manager instance. */
-        this.manager = manager;
-        /** The guild property. */
-        this.guildId = guildId;
-    }
     /**
      * Adds a track to the queue.
      * @param track The track or tracks to add. Can be a single `Track` or an array of `Track`s.
      * @param [offset=null] The position to add the track(s) at. If not provided, the track(s) will be added at the end of the queue.
      */
-    add(track, offset) {
+    async add(track, offset) {
         // Get the track info as a string
         const trackInfo = Array.isArray(track) ? track.map((t) => JSON.stringify(t, null, 2)).join(", ") : JSON.stringify(track, null, 2);
         // Emit a debug message
         this.manager.emit(Manager_1.ManagerEventTypes.Debug, `[QUEUE] Added ${Array.isArray(track) ? track.length : 1} track(s) to queue: ${trackInfo}`);
-        const oldPlayer = this.manager.players.get(this.guildId) ? { ...this.manager.players.get(this.guildId) } : null;
+        const oldPlayer = (await this.manager.players.get(this.guildId)) ? { ...(await this.manager.players.get(this.guildId)) } : null;
         // If the track is valid, add it to the queue
         // If the queue is empty, set the track as the current track
         if (!this.current) {
@@ -103,11 +121,11 @@ class Queue extends Array {
                 }
             }
         }
-        if (this.manager.players.has(this.guildId) && this.manager.players.get(this.guildId).isAutoplay) {
+        if ((await this.manager.players.has(this.guildId)) && (await this.manager.players.get(this.guildId)).isAutoplay) {
             if (!Array.isArray(track)) {
-                const botUser = this.manager.players.get(this.guildId).get("Internal_BotUser");
+                const botUser = (await (await this.manager.players.get(this.guildId)).get("Internal_BotUser"));
                 if (botUser && botUser.id === track.requester.id) {
-                    this.manager.emit(Manager_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this.manager.players.get(this.guildId), {
+                    this.manager.emit(Manager_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, await this.manager.players.get(this.guildId), {
                         changeType: Manager_1.PlayerStateEventTypes.QueueChange,
                         details: {
                             changeType: "autoPlayAdd",
@@ -119,7 +137,7 @@ class Queue extends Array {
             }
         }
         // Emit a player state update event with the added track(s)
-        this.manager.emit(Manager_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this.manager.players.get(this.guildId), {
+        this.manager.emit(Manager_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, await this.manager.players.get(this.guildId), {
             changeType: Manager_1.PlayerStateEventTypes.QueueChange,
             details: {
                 changeType: "add",
@@ -127,8 +145,8 @@ class Queue extends Array {
             },
         });
     }
-    remove(startOrPosition = 0, end) {
-        const oldPlayer = this.manager.players.get(this.guildId) ? { ...this.manager.players.get(this.guildId) } : null;
+    async remove(startOrPosition = 0, end) {
+        const oldPlayer = (await this.manager.players.get(this.guildId)) ? { ...(await this.manager.players.get(this.guildId)) } : null;
         if (typeof end !== "undefined") {
             // Validate input for `start` and `end`
             if (isNaN(Number(startOrPosition)) || isNaN(Number(end))) {
@@ -139,7 +157,7 @@ class Queue extends Array {
             }
             const removedTracks = this.splice(startOrPosition, end - startOrPosition);
             this.manager.emit(Manager_1.ManagerEventTypes.Debug, `[QUEUE] Removed ${removedTracks.length} track(s) from player: ${this.guildId} from position ${startOrPosition} to ${end}.`);
-            this.manager.emit(Manager_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this.manager.players.get(this.guildId), {
+            this.manager.emit(Manager_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, await this.manager.players.get(this.guildId), {
                 changeType: Manager_1.PlayerStateEventTypes.QueueChange,
                 details: {
                     changeType: "remove",
@@ -153,7 +171,7 @@ class Queue extends Array {
         this.manager.emit(Manager_1.ManagerEventTypes.Debug, `[QUEUE] Removed 1 track from player: ${this.guildId} from position ${startOrPosition}: ${JSON.stringify(removedTrack[0], null, 2)}`);
         // Ensure removedTrack is an array for consistency
         const tracksToEmit = removedTrack.length > 0 ? removedTrack : [];
-        this.manager.emit(Manager_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this.manager.players.get(this.guildId), {
+        this.manager.emit(Manager_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, await this.manager.players.get(this.guildId), {
             changeType: Manager_1.PlayerStateEventTypes.QueueChange,
             details: {
                 changeType: "remove",
@@ -166,13 +184,13 @@ class Queue extends Array {
      * Clears the queue.
      * This will remove all tracks from the queue and emit a state update event.
      */
-    clear() {
+    async clear() {
         // Capture the current state of the player for event emission.
-        const oldPlayer = this.manager.players.get(this.guildId) ? { ...this.manager.players.get(this.guildId) } : null;
+        const oldPlayer = (await this.manager.players.get(this.guildId)) ? { ...(await this.manager.players.get(this.guildId)) } : null;
         // Remove all items from the queue.
         this.splice(0);
         // Emit an event to update the player state indicating the queue has been cleared.
-        this.manager.emit(Manager_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this.manager.players.get(this.guildId), {
+        this.manager.emit(Manager_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, await this.manager.players.get(this.guildId), {
             changeType: Manager_1.PlayerStateEventTypes.QueueChange,
             details: {
                 changeType: "clear",
@@ -186,16 +204,16 @@ class Queue extends Array {
      * Shuffles the queue.
      * This will randomize the order of the tracks in the queue and emit a state update event.
      */
-    shuffle() {
+    async shuffle() {
         // Capture the current state of the player for event emission.
-        const oldPlayer = this.manager.players.get(this.guildId) ? { ...this.manager.players.get(this.guildId) } : null;
+        const oldPlayer = (await this.manager.players.get(this.guildId)) ? { ...(await this.manager.players.get(this.guildId)) } : null;
         // Shuffle the queue.
         for (let i = this.length - 1; i > 0; i--) {
             const j = Math.floor(Math.random() * (i + 1));
             [this[i], this[j]] = [this[j], this[i]];
         }
         // Emit an event to update the player state indicating the queue has been shuffled.
-        this.manager.emit(Manager_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this.manager.players.get(this.guildId), {
+        this.manager.emit(Manager_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, await this.manager.players.get(this.guildId), {
             changeType: Manager_1.PlayerStateEventTypes.QueueChange,
             details: {
                 changeType: "shuffle",
@@ -207,9 +225,9 @@ class Queue extends Array {
     /**
      * Shuffles the queue to play tracks requested by each user one block at a time.
      */
-    userBlockShuffle() {
+    async userBlockShuffle() {
         // Capture the current state of the player for event emission.
-        const oldPlayer = this.manager.players.get(this.guildId) ? { ...this.manager.players.get(this.guildId) } : null;
+        const oldPlayer = (await this.manager.players.get(this.guildId)) ? { ...(await this.manager.players.get(this.guildId)) } : null;
         // Group the tracks in the queue by the user that requested them.
         const userTracks = new Map();
         this.forEach((track) => {
@@ -235,7 +253,7 @@ class Queue extends Array {
         this.splice(0);
         this.add(shuffledQueue);
         // Emit an event to update the player state indicating the queue has been shuffled.
-        this.manager.emit(Manager_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this.manager.players.get(this.guildId), {
+        this.manager.emit(Manager_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, await this.manager.players.get(this.guildId), {
             changeType: Manager_1.PlayerStateEventTypes.QueueChange,
             details: {
                 changeType: "userBlock",
@@ -247,8 +265,8 @@ class Queue extends Array {
     /**
      * Shuffles the queue to play tracks requested by each user one by one.
      */
-    roundRobinShuffle() {
-        const oldPlayer = this.manager.players.get(this.guildId) ? { ...this.manager.players.get(this.guildId) } : null;
+    async roundRobinShuffle() {
+        const oldPlayer = (await this.manager.players.get(this.guildId)) ? { ...(await this.manager.players.get(this.guildId)) } : null;
         const userTracks = new Map();
         // Group the tracks in the queue by the user that requested them.
         this.forEach((track) => {
@@ -283,7 +301,7 @@ class Queue extends Array {
         this.splice(0);
         this.add(shuffledQueue);
         // Emit an event to update the player state indicating the queue has been shuffled.
-        this.manager.emit(Manager_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this.manager.players.get(this.guildId), {
+        this.manager.emit(Manager_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, await this.manager.players.get(this.guildId), {
             changeType: Manager_1.PlayerStateEventTypes.QueueChange,
             details: {
                 changeType: "roundRobin",
@@ -292,5 +310,40 @@ class Queue extends Array {
         // Emit a debug message indicating the queue has been shuffled for a specific guild ID.
         this.manager.emit(Manager_1.ManagerEventTypes.Debug, `[QUEUE] roundRobinShuffled the queue for: ${this.guildId}`);
     }
+    async dequeue() {
+        return super.shift();
+    }
+    async enqueueFront(track) {
+        if (Array.isArray(track)) {
+            this.unshift(...track);
+        }
+        else {
+            this.unshift(track);
+        }
+    }
+    async getTracks() {
+        return [...this]; // clone to avoid direct mutation
+    }
+    async getSlice(start, end) {
+        return this.slice(start, end); // Native sync method, still wrapped in a Promise
+    }
+    async modifyAt(start, deleteCount = 0, ...items) {
+        return super.splice(start, deleteCount, ...items);
+    }
+    async mapAsync(callback) {
+        return this.map(callback);
+    }
+    async filterAsync(callback) {
+        return this.filter(callback);
+    }
+    async findAsync(callback) {
+        return this.find(callback);
+    }
+    async someAsync(callback) {
+        return this.some(callback);
+    }
+    async everyAsync(callback) {
+        return this.every(callback);
+    }
 }
 exports.Queue = Queue;