magmastream 2.9.1-dev.5 → 2.9.1-dev.6

package/dist/index.d.ts

@@ -1776,6 +1776,8 @@ interface PlayerOptions {
     selfMute?: boolean;
     /** If the player should deaf itself. */
     selfDeafen?: boolean;
+    /** Whether to apply the volume as a filter. */
+    applyVolumeAsFilter?: boolean;
 }
 /**
  * PlayOptions interface

package/dist/structures/Player.js

@@ -80,6 +80,13 @@ class Player {
         this.clusterId = this.manager.options.clusterId || 0;
         // Check the player options for errors.
         (0, playerCheck_1.default)(options);
+        this.options = {
+            ...options,
+            applyVolumeAsFilter: options.applyVolumeAsFilter ?? false,
+            selfMute: options.selfMute ?? false,
+            selfDeafen: options.selfDeafen ?? false,
+            volume: options.volume ?? 100,
+        };
         // Set the guild ID and voice state.
         this.guildId = options.guildId;
         this.voiceState = Object.assign({
@@ -112,7 +119,7 @@ class Player {
         // Add the player to the manager's player collection.
         this.manager.players.set(options.guildId, this);
         // Set the initial volume.
-        this.setVolume(options.volume ?? 100);
+        this.setVolume(options.volume);
         // Initialize the filters.
         this.filters = new Filters_1.Filters(this, this.manager);
         // Emit the playerCreate event.
@@ -416,9 +423,10 @@ class Player {
             throw new RangeError("Volume must be between 0 and 1000.");
         const oldVolume = this.volume;
         const oldPlayer = { ...this };
+        const data = this.options.applyVolumeAsFilter ? { filters: { volume } } : { volume };
         await this.node.rest.updatePlayer({
             guildId: this.options.guildId,
-            data: { volume },
+            data,
         });
         this.volume = volume;
         this.manager.emit(Enums_1.ManagerEventTypes.PlayerStateUpdate, oldPlayer, this, {
@@ -853,6 +861,7 @@ class Player {
             filters: this.filters,
             nowPlayingMessage: this.nowPlayingMessage,
             isAutoplay: this.isAutoplay,
+            applyVolumeAsFilter: this.options.applyVolumeAsFilter,
         };
         // If force is true, destroy the existing player for the new guild
         if (force && newPlayer) {
@@ -862,6 +871,7 @@ class Player {
         newOptions.selfDeafen = newOptions.selfDeafen ?? oldPlayerProperties.selfDeafen;
         newOptions.selfMute = newOptions.selfMute ?? oldPlayerProperties.selfMute;
         newOptions.volume = newOptions.volume ?? oldPlayerProperties.volume;
+        newOptions.applyVolumeAsFilter = newOptions.applyVolumeAsFilter ?? oldPlayerProperties.applyVolumeAsFilter;
         // Deep clone the current player
         const clonedPlayer = this.manager.create(newOptions);
         // Connect the cloned player to the new voice channel

package/dist/utils/playerCheck.js

@@ -11,8 +11,8 @@ function playerCheck(options) {
     if (!options) {
         throw new TypeError("PlayerOptions must not be empty.");
     }
-    // Get the guild ID, node, selfDeafen, selfMute, textChannelId, voiceChannelId, and volume from the options.
-    const { guildId, nodeIdentifier, selfDeafen, selfMute, textChannelId, voiceChannelId, volume } = options;
+    // Get the guild ID, node, selfDeafen, selfMute, textChannelId, voiceChannelId, volume, and applyVolumeAsFilter from the options.
+    const { guildId, nodeIdentifier, selfDeafen, selfMute, textChannelId, voiceChannelId, volume, applyVolumeAsFilter } = options;
     // Validate the guild ID option
     // The guild ID option must be a non-empty string.
     if (!/^\d+$/.test(guildId)) {
@@ -48,4 +48,9 @@ function playerCheck(options) {
     if (typeof volume !== "undefined" && typeof volume !== "number") {
         throw new TypeError('Player option "volume" must be a number.');
     }
+    // Validate the applyVolumeAsFilter option
+    // The applyVolumeAsFilter option must be a boolean.
+    if (typeof applyVolumeAsFilter !== "undefined" && typeof applyVolumeAsFilter !== "boolean") {
+        throw new TypeError('Player option "applyVolumeAsFilter" must be a boolean.');
+    }
 }

package/package.json

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