magmastream 2.9.2-dev.9 → 2.9.3-dev.0

package/dist/index.d.ts

@@ -83,6 +83,7 @@ declare enum SearchPlatform {
     SoundCloud = "scsearch",
     Spotify = "spsearch",
     Tidal = "tdsearch",
+    TTS = "speak",
     VKMusic = "vksearch",
     YouTube = "ytsearch",
     YouTubeMusic = "ytmsearch"
@@ -1181,7 +1182,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?: AnyUser;
+    requester: AnyUser;
     /** Displays the track thumbnail with optional size or null if it's a unsupported source. */
     displayThumbnail(size?: Sizes): string | null;
     /** Additional track info provided by plugins. */
@@ -1840,6 +1841,8 @@ interface PlayerOptions {
     selfDeafen?: boolean;
     /** Whether to apply the volume as a filter. */
     applyVolumeAsFilter?: boolean;
+    /** Whether to pause the player when the voice connection is disconnected. */
+    pauseOnDisconnect?: boolean;
 }
 /**
  * PlayOptions interface
@@ -2275,7 +2278,7 @@ declare class Player {
      * @throws {Error} If there are no previous tracks in the queue.
      * @emits {PlayerStateUpdate} - With {@link PlayerStateEventTypes.TrackChange} as the change type.
      */
-    previous(): Promise<this>;
+    previous(addBackToQueue?: boolean): Promise<this>;
     /**
      * Seeks to a given position in the currently playing track.
      * @param position - The position in milliseconds to seek to.

package/dist/statestorage/JsonQueue.js

@@ -100,7 +100,7 @@ class JsonQueue {
             if (!tracks.length)
                 return;
             const current = await this.getPrevious();
-            const newTracks = tracks.filter((t) => !current.some((p) => p.identifier === t.identifier));
+            const newTracks = tracks.filter((t) => !current.some((p) => p.uri === t.uri));
             if (!newTracks.length)
                 return;
             const updated = [...current, ...newTracks];
@@ -569,6 +569,8 @@ class JsonQueue {
     async readJSON(filePath) {
         try {
             const raw = await fs_1.promises.readFile(filePath, "utf-8");
+            if (!raw || !raw.trim())
+                return null;
             return JSON.parse(raw);
         }
         catch (err) {

package/dist/structures/Enums.js

@@ -71,6 +71,7 @@ var SearchPlatform;
     SearchPlatform["SoundCloud"] = "scsearch";
     SearchPlatform["Spotify"] = "spsearch";
     SearchPlatform["Tidal"] = "tdsearch";
+    SearchPlatform["TTS"] = "speak";
     SearchPlatform["VKMusic"] = "vksearch";
     SearchPlatform["YouTube"] = "ytsearch";
     SearchPlatform["YouTubeMusic"] = "ytmsearch";

package/dist/structures/Manager.js

@@ -1106,7 +1106,9 @@ class Manager extends events_1.EventEmitter {
         this.emit(Enums_1.ManagerEventTypes.PlayerDisconnect, player, player.voiceChannelId);
         player.voiceChannelId = null;
         player.voiceState = Object.assign({});
-        await player.pause(true);
+        if (player.options.pauseOnDisconnect) {
+            await player.pause(true);
+        }
         return;
     }
     /**

package/dist/structures/Player.js

@@ -91,6 +91,7 @@ class Player {
             selfMute: options.selfMute ?? false,
             selfDeafen: options.selfDeafen ?? false,
             volume: options.volume ?? 100,
+            pauseOnDisconnect: options.pauseOnDisconnect ?? true,
         };
         // Set the guild ID and voice state.
         this.guildId = options.guildId;
@@ -364,10 +365,12 @@ class Player {
             await this.queue.setCurrent(optionsOrTrack);
         }
         if (!(await this.queue.getCurrent())) {
-            throw new MagmastreamError_1.MagmaStreamError({
+            const error = new MagmastreamError_1.MagmaStreamError({
                 code: Enums_1.MagmaStreamErrorCode.PLAYER_QUEUE_EMPTY,
                 message: "The queue is empty.",
             });
+            console.error(error);
+            return this;
         }
         const finalOptions = playOptions
             ? playOptions
@@ -399,17 +402,21 @@ class Player {
      */
     setAutoplay(autoplayState, AutoplayUser, tries) {
         if (typeof autoplayState !== "boolean") {
-            throw new MagmastreamError_1.MagmaStreamError({
+            const error = new MagmastreamError_1.MagmaStreamError({
                 code: Enums_1.MagmaStreamErrorCode.PLAYER_INVALID_AUTOPLAY,
                 message: "autoplayState must be a boolean.",
             });
+            console.error(error);
+            return this;
         }
         if (autoplayState) {
             if (!AutoplayUser) {
-                throw new MagmastreamError_1.MagmaStreamError({
+                const error = new MagmastreamError_1.MagmaStreamError({
                     code: Enums_1.MagmaStreamErrorCode.PLAYER_INVALID_AUTOPLAY,
                     message: "AutoplayUser must be provided when enabling autoplay.",
                 });
+                console.error(error);
+                return this;
             }
             this.autoplayTries = tries && typeof tries === "number" && tries > 0 ? tries : 3; // Default to 3 if invalid
             this.isAutoplay = true;
@@ -775,21 +782,33 @@ class Player {
      * @throws {Error} If there are no previous tracks in the queue.
      * @emits {PlayerStateUpdate} - With {@link PlayerStateEventTypes.TrackChange} as the change type.
      */
-    async previous() {
+    async previous(addBackToQueue = true) {
         // Pop the most recent previous track (from tail)
         const lastTrack = await this.queue.popPrevious();
         if (!lastTrack) {
             await this.queue.clearPrevious();
-            throw new MagmastreamError_1.MagmaStreamError({
+            const error = new MagmastreamError_1.MagmaStreamError({
                 code: Enums_1.MagmaStreamErrorCode.PLAYER_PREVIOUS_EMPTY,
                 message: "Previous queue is empty.",
             });
+            console.error(error);
+            return this;
         }
         // Capture the current state of the player before making changes.
         const oldPlayer = { ...this };
         // Prevent re-adding the current track
         this.set("skipFlag", true);
-        await this.play(lastTrack);
+        // Add the current track to the queue if addBackToQueue is true
+        if (addBackToQueue) {
+            const currentPlayingTrack = await this.queue.getCurrent();
+            if (currentPlayingTrack) {
+                await this.queue.add(currentPlayingTrack, 0);
+            }
+            await this.play(lastTrack);
+        }
+        else {
+            await this.play(lastTrack);
+        }
         this.manager.emit(Enums_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this, {
             changeType: Enums_1.PlayerStateEventTypes.TrackChange,
             details: {

package/dist/utils/playerCheck.js

@@ -15,7 +15,7 @@ function playerCheck(options) {
             message: "PlayerOptions must not be empty.",
         });
     }
-    const { guildId, nodeIdentifier, selfDeafen, selfMute, textChannelId, voiceChannelId, volume, applyVolumeAsFilter } = options;
+    const { guildId, nodeIdentifier, selfDeafen, selfMute, textChannelId, voiceChannelId, volume, applyVolumeAsFilter, pauseOnDisconnect } = options;
     if (!/^\d+$/.test(guildId)) {
         throw new MagmastreamError_1.MagmaStreamError({
             code: Enums_1.MagmaStreamErrorCode.PLAYER_INVALID_CONFIG,
@@ -72,4 +72,11 @@ function playerCheck(options) {
             context: { applyVolumeAsFilter },
         });
     }
+    if (typeof pauseOnDisconnect !== "undefined" && typeof pauseOnDisconnect !== "boolean") {
+        throw new MagmastreamError_1.MagmaStreamError({
+            code: Enums_1.MagmaStreamErrorCode.PLAYER_INVALID_CONFIG,
+            message: 'Player option "pauseOnDisconnect" must be a boolean.',
+            context: { pauseOnDisconnect },
+        });
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "magmastream",
-	"version": "2.9.2-dev.9",
+	"version": "2.9.3-dev.0",
 	"description": "A user-friendly Lavalink client designed for NodeJS.",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",