hoshimi 0.2.5 → 0.3.1

package/dist/index.mjs

@@ -250,6 +250,11 @@ var HttpMethods = /* @__PURE__ */ ((HttpMethods2) => {
   HttpMethods2["Head"] = "HEAD";
   return HttpMethods2;
 })(HttpMethods || {});
+var RestPathType = /* @__PURE__ */ ((RestPathType2) => {
+  RestPathType2["Raw"] = "/";
+  RestPathType2["V4"] = "/v4";
+  return RestPathType2;
+})(RestPathType || {});
 var HttpStatusCodes = /* @__PURE__ */ ((HttpStatusCodes2) => {
   HttpStatusCodes2[HttpStatusCodes2["OK"] = 200] = "OK";
   HttpStatusCodes2[HttpStatusCodes2["Created"] = 201] = "Created";
@@ -459,12 +464,12 @@ var UnresolvedTrack = class {
 // package.json
 var package_default = {
   name: "hoshimi",
-  version: "0.2.5",
+  version: "0.3.1",
   description: "A lavalink@v4 client easy to use, up-to-date and all ears.",
   main: "./dist/index.js",
   module: "./dist/index.mjs",
   types: "./dist/index.d.ts",
-  packageManager: "pnpm@10.20.0+sha512.cf9998222162dd85864d0a8102e7892e7ba4ceadebbf5a31f9c2fce48dfce317a9c53b9f6464d1ef9042cba2e02ae02a9f7c143a2b438cd93c91840f0192b9dd",
+  packageManager: "pnpm@10.24.0+sha512.01ff8ae71b4419903b65c60fb2dc9d34cf8bb6e06d03bde112ef38f7a34d6904c424ba66bea5cdcf12890230bf39f9580473140ed9c946fef328b6e5238a345a",
   files: [
     "dist"
   ],
@@ -500,13 +505,13 @@ var package_default = {
   author: "Ganyu Studios",
   license: "MIT",
   devDependencies: {
-    "@biomejs/biome": "^2.3.2",
-    "@types/node": "^24.9.2",
+    "@biomejs/biome": "^2.3.8",
+    "@types/node": "^24.10.1",
     "@types/ws": "^8.18.1",
     husky: "^9.1.7",
-    "lint-staged": "^16.2.6",
-    tsup: "^8.5.0",
-    tsx: "^4.20.6",
+    "lint-staged": "^16.2.7",
+    tsup: "^8.5.1",
+    tsx: "^4.21.0",
     typescript: "^5.9.3"
   },
   dependencies: {
@@ -572,7 +577,7 @@ var ValidSources = new Map(
     ["pornhub" /* PornHub */]: "phsearch" /* PornHub */
   })
 );
-var AudioOutputData = {
+var AudioOutputData = Object.freeze({
   ["mono" /* Mono */]: {
     leftToLeft: 0.5,
     leftToRight: 0.5,
@@ -597,7 +602,7 @@ var AudioOutputData = {
     rightToLeft: 0,
     rightToRight: 1
   }
-};
+});
 var DefaultFilterPreset = Object.freeze({
   Karaoke: { level: 1, monoLevel: 1, filterBand: 220, filterWidth: 100 },
   Vaporwave: { speed: 0.8500000238418579, pitch: 0.800000011920929, rate: 1 },
@@ -615,6 +620,8 @@ var DefaultFilterPreset = Object.freeze({
 });
 var DefaultPlayerFilters = Object.freeze({
   volume: 1,
+  equalizer: [],
+  channelMix: AudioOutputData.mono,
   lowPass: {
     smoothing: 0
   },
@@ -669,7 +676,6 @@ var DefaultPlayerFilters = Object.freeze({
       maxAmplitude: 0
     }
   },
-  equalizer: [],
   distortion: {
     cosOffset: 0,
     sinOffset: 0,
@@ -679,8 +685,7 @@ var DefaultPlayerFilters = Object.freeze({
     cosScale: 1,
     sinScale: 1,
     tanScale: 1
-  },
-  channelMix: AudioOutputData.mono
+  }
 });
 
 // src/util/functions/utils.ts
@@ -787,6 +792,24 @@ function isUnresolvedTrack(track) {
 function isValid(value) {
   return typeof value !== "undefined" && value !== null;
 }
+function stringify(value, space) {
+  const seen = /* @__PURE__ */ new WeakSet();
+  return JSON.stringify(
+    value,
+    (_, value2) => {
+      if (typeof value2 === "function") return void 0;
+      if (typeof value2 === "symbol") return void 0;
+      if (typeof value2 === "bigint") return value2.toString();
+      if (typeof value2 === "object" && value2 !== null) {
+        if (seen.has(value2)) return void 0;
+        seen.add(value2);
+        return value2;
+      }
+      return value2;
+    },
+    space
+  );
+}
 function isNode(options) {
   return typeof options.host === "string" && typeof options.port === "number" && typeof options.password === "string" && (typeof options.id === "string" || typeof options.id === "undefined") && (typeof options.secure === "boolean" || typeof options.secure === "undefined") && (typeof options.sessionId === "string" || typeof options.sessionId === "undefined") && (typeof options.retryAmount === "number" || typeof options.retryAmount === "undefined") && (typeof options.retryDelay === "number" || typeof options.retryDelay === "undefined");
 }
@@ -1020,7 +1043,7 @@ var NodeManager = class {
   /**
    *
    * Delete the node.
-   * @param {string} id The id of the node to delete.
+   * @param {NodeIdentifier} node The node or node id to delete.
    * @returns {boolean} If the node was deleted.
    * @example
    * ```ts
@@ -1028,23 +1051,122 @@ var NodeManager = class {
    * if (node) manager.nodeManager.delete(node.id); // true if the node was deleted
    * ```
    */
-  delete(id) {
+  delete(node) {
+    const id = typeof node === "string" ? node : node.id;
     return this.nodes.delete(id);
   }
   /**
    *
    * Get the node by id.
-   * @param {string} id The id of the node.
+   * @param {NodeIdentifier} node The node or node id to get.
    * @returns {NodeStructure | undefined} The node or undefined if not found.
    * @example
    * ```ts
    * const node = manager.nodeManager.get("node1");
-   * if (node) console.log(node.id); // node1
+   * if (node) {
+   * 	console.log(node.id); // node1
+   * } else {
+   * 	console.log("Node not found");
+   * }
    * ```
    */
-  get(id) {
+  get(node) {
+    const id = typeof node === "string" ? node : node.id;
     return this.nodes.get(id);
   }
+  /**
+   *
+   * Create a new node.
+   * @param {NodeOptions} options The options for the node.
+   * @returns {NodeStructure} The created node.
+   * @example
+   * ```ts
+   * const node = manager.nodeManager.create({
+   * 	host: "localhost",
+   * 	port: 2333,
+   * 	password: "password",
+   * 	secure: false,
+   * });
+   *
+   * console.log(node.id); // localhost:2333
+   */
+  create(options) {
+    options.id ??= `${options.host}:${options.port}`;
+    const oldNode = this.nodes.get(options.id);
+    if (oldNode) return oldNode;
+    const node = Structures.Node(this, options);
+    this.nodes.set(node.id, node);
+    this.manager.emit("nodeCreate" /* NodeCreate */, node);
+    return node;
+  }
+  /**
+   *
+   * Destroy a node.
+   * @param {NodeIdentifier} node The node or node id to destroy.
+   * @returns {void}
+   * @example
+   * ```ts
+   * const node = manager.nodeManager.get("node1");
+   * if (node) node.destroy();
+   * ```
+   */
+  destroy(node) {
+    const id = typeof node === "string" ? node : node.id;
+    const target = this.nodes.get(id);
+    if (!target) return;
+    target.destroy();
+  }
+  /**
+   *
+   * Reconnect a node.
+   * @param {NodeIdentifier} node The node or node id to reconnect.
+   * @returns {void}
+   * @example
+   * ```ts
+   * const node = manager.nodeManager.get("node1");
+   * if (node) node.reconnect();
+   * ```
+   */
+  reconnect(node) {
+    const id = typeof node === "string" ? node : node.id;
+    const target = this.nodes.get(id);
+    if (!target) return;
+    target.reconnect();
+  }
+  /**
+   *
+   * Disconnect a node.
+   * @param {NodeIdentifier} node The node or node id to disconnect.
+   * @returns {void}
+   * @example
+   * ```ts
+   * const node = manager.nodeManager.get("node1");
+   * if (node) node.disconnect();
+   * ```
+   */
+  disconnect(node) {
+    const id = typeof node === "string" ? node : node.id;
+    const target = this.nodes.get(id);
+    if (!target) return;
+    target.disconnect();
+  }
+  /**
+   *
+   * Connect a node.
+   * @param {NodeIdentifier} node The node or node id to connect.
+   * @returns {void}
+   * @example
+   * ```ts
+   * const node = manager.nodeManager.get("node1");
+   * if (node) node.connect();
+   * ```
+   */
+  connect(node) {
+    const id = typeof node === "string" ? node : node.id;
+    const target = this.nodes.get(id);
+    if (!target) return;
+    target.connect();
+  }
   /**
    *
    * Get the least used node.
@@ -1087,31 +1209,6 @@ var NodeManager = class {
         });
     }
   }
-  /**
-   *
-   * Create a new node.
-   * @param {NodeOptions} options The options for the node.
-   * @returns {NodeStructure} The created node.
-   * @example
-   * ```ts
-   * const node = manager.nodeManager.create({
-   * 	host: "localhost",
-   * 	port: 2333,
-   * 	password: "password",
-   * 	secure: false,
-   * });
-   *
-   * console.log(node.id); // localhost:2333
-   */
-  create(options) {
-    options.id ??= `${options.host}:${options.port}`;
-    const oldNode = this.nodes.get(options.id);
-    if (oldNode) return oldNode;
-    const node = Structures.Node(this, options);
-    this.nodes.set(node.id, node);
-    this.manager.emit("nodeCreate" /* NodeCreate */, node);
-    return node;
-  }
   /**
    *
    * Reconnect the nodes.
@@ -1119,10 +1216,10 @@ var NodeManager = class {
    * @example
    * ```ts
    * const node = manager.nodeManager.get("node1");
-   * if (node) node.reconnect();
+   * if (node) node.reconnectAll();
    * ```
    */
-  reconnect() {
+  reconnectAll() {
     if (!this.nodes.size) return;
     for (const node of this.nodes.filter((node2) => node2.state !== 2 /* Connected */)) {
       node.reconnect();
@@ -1134,10 +1231,10 @@ var NodeManager = class {
    * @example
    * ```ts
    * const node = manager.nodeManager.get("node1");
-   * if (node) node.disconnect();
+   * if (node) node.disconnectAll();
    * ```
    */
-  disconnect() {
+  disconnectAll() {
     if (!this.nodes.size) return;
     for (const node of this.nodes.filter((node2) => node2.state !== 3 /* Disconnected */)) {
       node.disconnect();
@@ -1152,7 +1249,7 @@ var NodeManager = class {
    * if (node) node.connect();
    * ```
    */
-  connect() {
+  connectAll() {
     if (!this.nodes.size) return;
     for (const node of this.nodes.filter((node2) => node2.state !== 2 /* Connected */)) {
       node.connect();
@@ -1167,7 +1264,7 @@ var NodeManager = class {
    * if (node) node.destroy();
    * ```
    */
-  destroy() {
+  destroyAll() {
     if (!this.nodes.size) return;
     for (const node of this.nodes.values()) {
       node.destroy();
@@ -1333,7 +1430,7 @@ async function playerUpdate(payload) {
   this.nodeManager.manager.emit(
     "debug" /* Debug */,
     2 /* Node */,
-    `[Player] -> [Update] Player updated: ${player.guildId} | Payload: ${JSON.stringify(payload)}`
+    `[Player] -> [Update] Player updated: ${player.guildId} | Payload: ${stringify(payload)}`
   );
 }
 async function lyricsFound(track, payload) {
@@ -1341,7 +1438,7 @@ async function lyricsFound(track, payload) {
   this.manager.emit(
     "debug" /* Debug */,
     3 /* Player */,
-    `[Player] -> [Lyrics] The lyrics have been found: ${this.guildId} | Payload: ${JSON.stringify(payload)}`
+    `[Player] -> [Lyrics] The lyrics have been found: ${this.guildId} | Payload: ${stringify(payload)}`
   );
 }
 async function lyricsLine(track, payload) {
@@ -1349,7 +1446,7 @@ async function lyricsLine(track, payload) {
   this.manager.emit(
     "debug" /* Debug */,
     3 /* Player */,
-    `[Player] -> [Lyrics] The lyrics line has been found: ${this.guildId} | Payload: ${JSON.stringify(payload)}`
+    `[Player] -> [Lyrics] The lyrics line has been found: ${this.guildId} | Payload: ${stringify(payload)}`
   );
 }
 async function lyricsNotFound(track, payload) {
@@ -1357,7 +1454,7 @@ async function lyricsNotFound(track, payload) {
   this.manager.emit(
     "debug" /* Debug */,
     3 /* Player */,
-    `[Player] -> [Lyrics] The lyrics were not found: ${this.guildId} | Payload: ${JSON.stringify(payload)}`
+    `[Player] -> [Lyrics] The lyrics were not found: ${this.guildId} | Payload: ${stringify(payload)}`
   );
 }
 async function socketClosed(payload) {
@@ -1365,7 +1462,7 @@ async function socketClosed(payload) {
   this.manager.emit(
     "debug" /* Debug */,
     3 /* Player */,
-    `[Player] -> [Socket] The socket has closed: ${this.guildId} | Payload: ${JSON.stringify(payload)}`
+    `[Player] -> [Socket] The socket has closed: ${this.guildId} | Payload: ${stringify(payload)}`
   );
 }
 
@@ -1515,11 +1612,7 @@ async function onMessage(message) {
         break;
       }
     }
-    this.nodeManager.manager.emit(
-      "debug" /* Debug */,
-      2 /* Node */,
-      `[Socket] -> [${this.id}]: Received payload: ${JSON.stringify(payload)}`
-    );
+    this.nodeManager.manager.emit("debug" /* Debug */, 2 /* Node */, `[Socket] -> [${this.id}]: Received payload: ${stringify(payload)}`);
   } catch (error) {
     this.nodeManager.manager.emit("nodeError" /* NodeError */, this, error);
   }
@@ -1654,7 +1747,7 @@ var Node = class {
       const raw = await this.rest.request({
         endpoint: "/decodetracks",
         method: "POST" /* Post */,
-        body: JSON.stringify(tracks)
+        body: stringify(tracks)
       }) ?? [];
       return raw.map((track) => new Track(track, requester));
     }
@@ -1751,6 +1844,7 @@ var Node = class {
    * ```
    */
   connect() {
+    if (this.state === 2 /* Connected */ || this.state === 1 /* Connecting */) return;
     if (!this.nodeManager.manager.options.client)
       throw new NodeError({
         message: "No valid client data provided.",
@@ -1785,7 +1879,7 @@ var Node = class {
     this.nodeManager.manager.emit(
       "debug" /* Debug */,
       2 /* Node */,
-      `[Socket] -> [${this.id}]: Connecting to ${this.address} | State: ${this.state} | Session: ${this.sessionId} | Resumed: ${this.session.resuming} | Penalties: ${this.penalties} | Reconnects: ${this.retryAmount} | Headers: ${JSON.stringify(headers)}`
+      `[Socket] -> [${this.id}]: Connecting to ${this.address} | State: ${this.state} | Session: ${this.sessionId} | Resumed: ${this.session.resuming} | Penalties: ${this.penalties} | Reconnects: ${this.retryAmount} | Headers: ${stringify(headers)}`
     );
   }
   /**
@@ -1926,6 +2020,7 @@ var Node = class {
    * ```
    */
   reconnect() {
+    if (this.state === 3 /* Disconnected */ || this.state === 6 /* Destroyed */) return;
     this.state = 7 /* Idle */;
     this.nodeManager.manager.emit("nodeReconnecting" /* NodeReconnecting */, this, this.retryAmount, this.retryDelay);
     this.reconnectTimeout = setTimeout(() => {
@@ -2062,7 +2157,7 @@ var Rest = class {
    */
   constructor(node) {
     const manager = node.nodeManager.manager;
-    this.url = `${node.options.secure ? "https" : "http"}://${node.options.host}:${node.options.port}/${this.version}`;
+    this.url = `${node.options.secure ? "https" : "http"}://${node.options.host}:${node.options.port}`;
     this.restTimeout = node.options.restTimeout ?? manager.options.restOptions.resumeTimeout ?? 1e4;
     this.userAgent = manager.options.nodeOptions.userAgent ?? HoshimiAgent;
     this.node = node;
@@ -2095,7 +2190,9 @@ var Rest = class {
       Authorization: this.node.options.password
     };
     options.method ??= "GET" /* Get */;
-    const url = new URL(`${this.url}${options.endpoint}`);
+    options.pathType ??= "/v4" /* V4 */;
+    const path = `${options.pathType}${options.endpoint}`.replace(/\/+/g, "/");
+    const url = new URL(`${this.url}${path}`);
     if (options.params) {
       for (const [key, value] of Object.entries(options.params)) {
         url.searchParams.append(key, value);
@@ -2111,12 +2208,12 @@ var Rest = class {
     };
     if (!["GET" /* Get */, "HEAD" /* Head */].includes(options.method) && options.body) {
       if (typeof options.body === "string") fetchOptions.body = options.body;
-      else fetchOptions.body = JSON.stringify(options.body);
+      else fetchOptions.body = stringify(options.body);
     }
     this.node.nodeManager.manager.emit(
       "debug" /* Debug */,
       4 /* Rest */,
-      `[Rest] -> [${this.node.id} : ${options.method}]: Url: ${this.restUrl} | Endpoint: ${options.endpoint} | Params: ${url.search} | Body: ${options.body ? JSON.stringify(options.body) : "None"} | Headers: ${JSON.stringify(headers)}`
+      `[Rest] -> [${this.node.id} : ${options.method}]: Url: ${this.restUrl} | Endpoint: ${options.endpoint} | Params: ${url.search} | Body: ${options.body ? stringify(options.body) : "None"} | Headers: ${stringify(headers)}`
     );
     const response = await fetch(url.toString(), fetchOptions).finally(() => clearTimeout(timeout));
     if (!response.ok) {
@@ -2158,7 +2255,7 @@ var Rest = class {
     this.node.nodeManager.manager.emit(
       "debug" /* Debug */,
       4 /* Rest */,
-      `[Rest] -> [${this.node.id}]: Updated player data for guild: ${data.guildId} | Payload: ${JSON.stringify(data)}`
+      `[Rest] -> [${this.node.id}]: Updated player data for guild: ${data.guildId} | Payload: ${stringify(data)}`
     );
     validatePlayerData.call(this.node, data);
     return this.request({
@@ -2263,7 +2360,7 @@ var DSPXPluginFilter = class {
    *
    * Set the low-pass filter with the given settings.
    * @param {FilterPluginPassSettings} [settings=DefaultFilter.DSPXLowPass] The settings for the low-pass filter.
-   * @returns {Promise<boolean>} Whether the filter is now active.
+   * @returns {Promise<this>} The instance of the filter manager.
    */
   async setLowPass(settings = DefaultFilterPreset.DSPXLowPass) {
     validateNodePlugins(this.manager.player.node, ["lavadspx-plugin" /* LavaDspx */]);
@@ -2279,13 +2376,13 @@ var DSPXPluginFilter = class {
     }
     this.manager.filters.lavalinkLavaDspxPlugin.lowPass = !this.manager.filters.lavalinkLavaDspxPlugin.lowPass;
     await this.manager.apply();
-    return this.manager.filters.lavalinkLavaDspxPlugin.lowPass;
+    return this;
   }
   /**
    *
    * Set the high-pass filter with the given settings.
    * @param {FilterPluginPassSettings} [settings=DefaultFilter.DSPXHighPass] The settings for the high-pass filter.
-   * @returns {Promise<boolean>} Whether the filter is now active.
+   * @returns {Promise<this>} The instance of the filter manager.
    */
   async setHighPass(settings = DefaultFilterPreset.DSPXHighPass) {
     validateNodePlugins(this.manager.player.node, ["lavadspx-plugin" /* LavaDspx */]);
@@ -2301,13 +2398,13 @@ var DSPXPluginFilter = class {
     }
     this.manager.filters.lavalinkLavaDspxPlugin.highPass = !this.manager.filters.lavalinkLavaDspxPlugin.highPass;
     await this.manager.apply();
-    return this.manager.filters.lavalinkLavaDspxPlugin.highPass;
+    return this;
   }
   /**
    *
    * Set the normalization filter with the given settings.
    * @param {NormalizationSettings} [settings=DefaultFilter.DSPXNormalization] The settings for the normalization filter.
-   * @returns {Promise<boolean>} Whether the filter is now active.
+   * @returns {Promise<this>} The instance of the filter manager.
    */
   async setNormalization(settings = DefaultFilterPreset.DSPXNormalization) {
     validateNodePlugins(this.manager.player.node, ["lavadspx-plugin" /* LavaDspx */]);
@@ -2323,13 +2420,13 @@ var DSPXPluginFilter = class {
     }
     this.manager.filters.lavalinkLavaDspxPlugin.normalization = !this.manager.filters.lavalinkLavaDspxPlugin.normalization;
     await this.manager.apply();
-    return this.manager.filters.lavalinkLavaDspxPlugin.normalization;
+    return this;
   }
   /**
    *
    * Set the echo filter with the given settings.
    * @param {EchoSettings} [settings=DefaultFilter.DSPXEcho] The settings for the echo filter.
-   * @returns {Promise<boolean>} Whether the filter is now active.
+   * @returns {Promise<this>} The instance of the filter manager.
    */
   async setEcho(settings = DefaultFilterPreset.DSPXEcho) {
     validateNodePlugins(this.manager.player.node, ["lavadspx-plugin" /* LavaDspx */]);
@@ -2345,7 +2442,7 @@ var DSPXPluginFilter = class {
     }
     this.manager.filters.lavalinkLavaDspxPlugin.echo = !this.manager.filters.lavalinkLavaDspxPlugin.echo;
     await this.manager.apply();
-    return this.manager.filters.lavalinkLavaDspxPlugin.echo;
+    return this;
   }
 };
 
@@ -2369,7 +2466,7 @@ var LavalinkPluginFilter = class {
    *
    * Set the echo filter with the given settings.
    * @param {Omit<EchoSettings, "echoLength">} [settings=DefaultFilter.PluginEcho] The settings for the echo filter.
-   * @returns {Promise<boolean>} Whether the filter is now active.
+   * @returns {Promise<this>} The instance of the filter manager.
    */
   async setEcho(settings = DefaultFilterPreset.PluginEcho) {
     validateNodePlugins(this.manager.player.node, ["lavalink-filter-plugin" /* FilterPlugin */]);
@@ -2385,13 +2482,13 @@ var LavalinkPluginFilter = class {
     this.manager.data.pluginFilters["lavalink-filter-plugin"].echo.decay = this.manager.filters.lavalinkFilterPlugin.echo ? 0 : settings.decay;
     this.manager.filters.lavalinkFilterPlugin.echo = !this.manager.filters.lavalinkFilterPlugin.echo;
     await this.manager.apply();
-    return this.manager.filters.lavalinkFilterPlugin.echo;
+    return this;
   }
   /**
    *
    * Set the reverb filter with the given settings.
    * @param {Partial<LavalinkFilterPluginReverbSettings>} [settings=DefaultFilter.PluginReverb] The settings for the reverb filter.
-   * @returns {Promise<boolean>} Whether the filter is now active.
+   * @returns {Promise<this>} The instance of the filter manager.
    */
   async setReverb(settings = DefaultFilterPreset.PluginReverb) {
     validateNodePlugins(this.manager.player.node, ["lavalink-filter-plugin" /* FilterPlugin */]);
@@ -2407,7 +2504,7 @@ var LavalinkPluginFilter = class {
     this.manager.data.pluginFilters["lavalink-filter-plugin"].reverb.gains = this.manager.filters.lavalinkFilterPlugin.reverb ? [] : settings.gains;
     this.manager.filters.lavalinkFilterPlugin.reverb = !this.manager.filters.lavalinkFilterPlugin.reverb;
     await this.manager.apply();
-    return this.manager.filters.lavalinkFilterPlugin.reverb;
+    return this;
   }
 };
 
@@ -2482,18 +2579,9 @@ var FilterManager = class {
     this.plugin = new LavalinkPluginFilter(this);
     this.dspx = new DSPXPluginFilter(this);
   }
-  /**
-   *
-   * Checks if a custom filter is active.
-   * @returns {boolean} True if a custom filter is active, false otherwise.
-   */
-  isCustom() {
-    this.filters.custom = !this.filters.nightcore && !this.filters.vaporwave && Object.values(this.data.timescale ?? {}).some((d) => d !== 1);
-    return this.filters.custom;
-  }
   /**
    * Resets all filters to their default values.
-   * @returns {Promise<void>} A promise that resolves when the filters have been reset.
+   * @returns {Promise<this>} A promise that resolves to the instance of the filter manager.
    */
   async reset() {
     this.filters = {
@@ -2520,20 +2608,17 @@ var FilterManager = class {
         echo: false
       }
     };
-    for (const [key, value] of Object.entries(DefaultPlayerFilters)) {
-      this.data[key] = value;
-    }
-    await this.apply();
+    this.data = { ...DefaultPlayerFilters };
+    return this.apply();
   }
   /**
    *
    * Applies the current filters to the player.
-   * @returns {Promise<void>} A promise that resolves when the filters have been applied.
+   * @returns {Promise<this>} A promise that resolves to the instance of the filter manager.
    */
   async apply() {
-    if (!this.player.node.sessionId) return;
+    if (!this.player.node.sessionId) return this;
     this.check();
-    this.isCustom();
     const filters = { ...this.data };
     if (!this.filters.volume) delete filters.volume;
     if (!this.filters.tremolo) delete filters.tremolo;
@@ -2560,6 +2645,7 @@ var FilterManager = class {
       if (!this.player.node.info?.filters?.includes(key)) delete filters[key];
     }
     await this.player.updatePlayer({ playerOptions: { filters } });
+    return this;
   }
   /**
    * Checks if the current filters are active.
@@ -2581,6 +2667,7 @@ var FilterManager = class {
     this.filters.karaoke = Object.values(this.data.karaoke ?? {}).some((v) => v !== 0);
     this.filters.distortion = Object.values(this.data.distortion ?? {}).some((v) => v !== 0 && v !== 1);
     this.filters.timescale = Object.values(this.data.timescale ?? {}).some((v) => v !== 1);
+    this.filters.custom = !this.filters.nightcore && !this.filters.vaporwave && Object.values(this.data.timescale ?? {}).some((d) => d !== 1);
     if ((this.filters.nightcore || this.filters.vaporwave) && timescale) {
       if (timescale.pitch !== this.data.timescale?.pitch || timescale.rate !== this.data.timescale?.rate || timescale.speed !== this.data.timescale?.speed) {
         this.filters.custom = Object.values(this.data.timescale ?? {}).some((v) => v !== 1);
@@ -2609,34 +2696,32 @@ var FilterManager = class {
    *
    * Sets the volume for the player.
    * @param {number} volume The volume level to set (between 0 and 5).
-   * @returns {Promise<boolean>} A promise that resolves to true if the volume was changed, false otherwise.
+   * @returns {Promise<this>} A promise that resolves to the player instance.
    */
   async setVolume(volume) {
     if (typeof volume !== "number" || Number.isNaN(volume) || volume < 0 || volume > 5)
       throw new PlayerError("Volume must be a number between 0 and 5.");
     this.data = { volume };
     this.filters.volume = volume !== 1;
-    await this.apply();
-    return this.filters.volume;
+    return this.apply();
   }
   /**
    * Sets the audio output for the player.
    * @param {AudioOutput} output The audio output to set.
-   * @returns {Promise<AudioOutput>} A promise that resolves to the set audio output.
+   * @returns {Promise<this>} A promise that resolves to the player instance.
    */
   async setAudioOutput(output) {
     const outputs = Object.values(AudioOutput);
     if (!outputs.includes(output)) throw new PlayerError(`Audio output must be one of the following: ${outputs.join(", ")}.`);
     this.filters.audioOutput = output;
     this.data.channelMix = AudioOutputData[output];
-    await this.apply();
-    return this.filters.audioOutput;
+    return this.apply();
   }
   /**
    *
    * Sets the speed for the player.
    * @param {number} speed The speed to set (default is 1).
-   * @returns {Promise<boolean>} A promise that resolves to true if a custom filter is active, false otherwise.
+   * @returns {Promise<this>} A promise that resolves to the player instance.
    */
   async setSpeed(speed = 1) {
     if (!this.player.node.info?.filters?.includes("timescale" /* Timescale */))
@@ -2651,14 +2736,13 @@ var FilterManager = class {
       this.filters.vaporwave = false;
     }
     this.data.timescale.speed = speed;
-    await this.apply();
-    return this.filters.custom;
+    return this.apply();
   }
   /**
    *
    * Sets the rate for the player.
    * @param {number} rate The rate to set (default is 1).
-   * @returns {Promise<boolean>} A promise that resolves to true if a custom filter is active, false otherwise.
+   * @returns {Promise<this>} A promise that resolves to the player instance.
    */
   async setRate(rate = 1) {
     if (!this.player.node.info?.filters?.includes("timescale" /* Timescale */))
@@ -2673,14 +2757,13 @@ var FilterManager = class {
       this.filters.vaporwave = false;
     }
     this.data.timescale.rate = rate;
-    await this.apply();
-    return this.filters.custom;
+    return this.apply();
   }
   /**
    *
    * Sets the pitch for the player.
    * @param {number} pitch The pitch
-   * @returns {Promise<boolean>} A promise that resolves to true if a custom filter is active, false otherwise.
+   * @returns {Promise<this>} A promise that resolves to the player instance.
    */
   async setPitch(pitch = 1) {
     if (!this.player.node.info?.filters?.includes("timescale" /* Timescale */))
@@ -2695,8 +2778,7 @@ var FilterManager = class {
       this.filters.vaporwave = false;
     }
     this.data.timescale.pitch = pitch;
-    await this.apply();
-    return this.filters.custom;
+    return this.apply();
   }
   /**
    *
@@ -2709,8 +2791,7 @@ var FilterManager = class {
     if (!bands.length || !bands.every((band) => typeof band.band === "number" && typeof band.gain === "number"))
       throw new PlayerError("Bands must be a non-empty object array containing 'band' and 'gain' properties.");
     for (const { band, gain } of bands) this.bands[band] = { band, gain };
-    await this.apply();
-    return this;
+    return this.apply();
   }
   /**
    *
@@ -2724,7 +2805,7 @@ var FilterManager = class {
    *
    * Set the vibrato filter with the given settings.
    * @param {TremoloSettings} [settings=DefaultFilterPreset.Vibrato] The settings for the vibrato filter.
-   * @returns {Promise<boolean>} Whether the filter is now active.
+   * @returns {Promise<this>} The instance of the filter manager.
    */
   async setVibrato(settings = DefaultFilterPreset.Vibrato) {
     if (!this.player.node.info?.filters?.includes("vibrato" /* Vibrato */))
@@ -2734,14 +2815,13 @@ var FilterManager = class {
       depth: this.filters.vibrato ? 0 : settings.depth
     };
     this.filters.vibrato = !this.filters.vibrato;
-    await this.apply();
-    return this.filters.vibrato;
+    return this.apply();
   }
   /**
    *
    * Set the tremolo filter with the given settings.
    * @param {TremoloSettings} [settings=DefaultFilterPreset.Tremolo] The settings for the tremolo filter.
-   * @returns {Promise<boolean>} Whether the filter is now active.
+   * @returns {Promise<this>} The instance of the filter manager.
    */
   async setTremolo(settings = DefaultFilterPreset.Tremolo) {
     if (!this.player.node.info?.filters?.includes("tremolo" /* Tremolo */))
@@ -2751,27 +2831,25 @@ var FilterManager = class {
       depth: this.filters.tremolo ? 0 : settings.depth
     };
     this.filters.tremolo = !this.filters.tremolo;
-    await this.apply();
-    return this.filters.tremolo;
+    return this.apply();
   }
   /**
    *
    * Set the low-pass filter with the given settings.
    * @param {LowPassSettings} [settings=DefaultFilterPreset.Lowpass] The settings for the low-pass filter.
-   * @returns {Promise<boolean>} Whether the filter is now active.
+   * @returns {Promise<this>} The instance of the filter manager.
    */
   async setLowPass(settings = DefaultFilterPreset.Lowpass) {
     if (!this.player.node.info?.filters?.includes("lowPass" /* LowPass */))
       throw new PlayerError("Node filters does not include the 'lowPass' filter. (Or the node doesn't have it enabled)");
     this.data.lowPass = { smoothing: this.filters.lowPass ? 0 : settings.smoothing };
     this.filters.lowPass = !this.filters.lowPass;
-    await this.apply();
-    return this.filters.lowPass;
+    return this.apply();
   }
   /**
    * Set the nightcore filter with the given settings.
    * @param {Partial<TimescaleSettings>} [settings=DefaultFilterPreset.Nightcore] The settings for the nightcore filter.
-   * @returns {Promise<boolean>} Whether the filter is now active.
+   * @returns {Promise<this>} The instance of the filter manager.
    */
   async setNightcore(settings = DefaultFilterPreset.Nightcore) {
     if (!this.player.node.info?.filters?.includes("timescale" /* Timescale */))
@@ -2784,14 +2862,13 @@ var FilterManager = class {
     this.filters.nightcore = !this.filters.nightcore;
     this.filters.vaporwave = false;
     this.filters.custom = false;
-    await this.apply();
-    return this.filters.nightcore;
+    return this.apply();
   }
   /**
    *
    * Set the vaporwave filter with the given settings.
    * @param {Partial<TimescaleSettings>} [settings=DefaultFilterPreset.Vaporwave] The settings for the vaporwave filter.
-   * @returns {Promise<boolean>} Whether the filter is now active.
+   * @returns {Promise<this>} The instance of the filter manager.
    */
   async setVaporwave(settings = DefaultFilterPreset.Vaporwave) {
     if (!this.player.node.info?.filters?.includes("timescale" /* Timescale */))
@@ -2804,14 +2881,13 @@ var FilterManager = class {
     this.filters.vaporwave = !this.filters.vaporwave;
     this.filters.nightcore = false;
     this.filters.custom = false;
-    await this.apply();
-    return this.filters.vaporwave;
+    return this.apply();
   }
   /**
    *
    * Set the karaoke filter with the given settings.
    * @param {KaraokeSettings} [settings=DefaultFilterPreset.Karaoke] The settings for the karaoke filter.
-   * @returns {Promise<boolean>} Whether the filter is now active.
+   * @returns {Promise<this>} The instance of the filter manager.
    */
   async setKaraoke(settings = DefaultFilterPreset.Karaoke) {
     if (!this.player.node.info?.filters?.includes("karaoke" /* Karaoke */))
@@ -2823,14 +2899,13 @@ var FilterManager = class {
       filterWidth: this.data.karaoke.filterWidth ? 0 : settings.filterWidth
     };
     this.filters.karaoke = !this.filters.karaoke;
-    await this.apply();
-    return this.filters.karaoke;
+    return this.apply();
   }
   /**
    *
    * Set the distortion filter with the given settings.
    * @param {Partial<DistortionSettings>} [settings=DefaultFilterPreset.Distortion] The settings for the distortion filter.
-   * @returns {Promise<boolean>} Whether the filter is now active.
+   * @returns {Promise<this>} The instance of the filter manager.
    */
   async setDistortion(settings = DefaultFilterPreset.Distortion) {
     if (!this.player.node.info?.filters?.includes("distortion" /* Distortion */))
@@ -2845,13 +2920,12 @@ var FilterManager = class {
       scale: this.filters.distortion ? 1 : settings.scale
     };
     this.filters.distortion = !this.filters.distortion;
-    await this.apply();
-    return this.filters.distortion;
+    return this.apply();
   }
   /**
    * Set the timescale filter with the given settings.
    * @param {Partial<TimescaleSettings>} settings The timescale settings to set.
-   * @returns {Promise<boolean>} Whether the filter is now active.
+   * @returns {Promise<this>} The instance of the filter manager.
    */
   async setTimescale(settings) {
     if (!this.player.node.info?.filters?.includes("timescale" /* Timescale */))
@@ -2862,8 +2936,7 @@ var FilterManager = class {
       speed: settings.speed ?? 1
     };
     this.filters.timescale = !this.filters.timescale;
-    await this.apply();
-    return this.filters.timescale;
+    return this.apply();
   }
 };
 
@@ -3623,7 +3696,7 @@ var QueueUtils = class {
     this.queue.player.manager.emit(
       "debug" /* Debug */,
       5 /* Queue */,
-      `[Queue] -> [Adapter] Saving queue for ${this.queue.player.guildId} | Object: ${JSON.stringify(json)}`
+      `[Queue] -> [Adapter] Saving queue for ${this.queue.player.guildId} | Object: ${stringify(json)}`
     );
     return this.store.set(this.queue.player.guildId, json);
   }
@@ -3665,7 +3738,7 @@ var QueueUtils = class {
     this.queue.player.manager.emit(
       "debug" /* Debug */,
       5 /* Queue */,
-      `[Queue] -> [Adapter] Syncing queue for ${this.queue.player.guildId} | Object: ${JSON.stringify(data)}`
+      `[Queue] -> [Adapter] Syncing queue for ${this.queue.player.guildId} | Object: ${stringify(data)}`
     );
     await this.save();
   }
@@ -4419,7 +4492,7 @@ var Hoshimi = class extends EventEmitter {
     this.emit(
       "debug" /* Debug */,
       1 /* Manager */,
-      `[Manager] -> [Search] Searching for: ${options.query} (${options.engine ?? "unknown"}) | Result: ${JSON.stringify(res)}`
+      `[Manager] -> [Search] Searching for: ${options.query} (${options.engine ?? "unknown"}) | Result: ${stringify(res)}`
     );
     switch (res.loadType) {
       case "empty" /* Empty */: {
@@ -4503,6 +4576,7 @@ export {
   Queue,
   ResolveError,
   Rest,
+  RestPathType,
   SearchEngines,
   Severity,
   SourceNames,