hoshimi 0.2.5 → 0.3.3

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.3",
   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.25.0+sha512.5e82639027af37cf832061bcc6d639c219634488e0f2baebe785028a793de7b525ffcd3f7ff574f5e9860654e098fe852ba8ac5dd5cefe1767d23a020a92f501",
   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": "^25.0.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
@@ -746,7 +751,10 @@ function validatePlayerData(data) {
       player.playing = !data.playerOptions.paused;
     }
     if (typeof data.playerOptions.volume === "number") player.volume = data.playerOptions.volume;
-    if (typeof data.playerOptions.position === "number") player.position = data.playerOptions.position;
+    if (typeof data.playerOptions.position === "number") {
+      player.lastPosition = data.playerOptions.position;
+      player.lastPositionUpdate = Date.now();
+    }
   }
 }
 function validateNodePlugins(node, plugins) {
@@ -787,6 +795,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 +1046,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 +1054,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 +1212,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 +1219,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 +1234,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 +1252,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 +1267,7 @@ var NodeManager = class {
    * if (node) node.destroy();
    * ```
    */
-  destroy() {
+  destroyAll() {
     if (!this.nodes.size) return;
     for (const node of this.nodes.values()) {
       node.destroy();
@@ -1328,12 +1428,13 @@ async function playerUpdate(payload) {
   player.ping = payload.state.ping;
   player.connected = payload.state.connected;
   player.createdTimestamp = payload.state.time;
-  player.position = payload.state.position;
+  player.lastPosition = payload.state.position || 0;
+  player.lastPositionUpdate = Date.now();
   this.nodeManager.manager.emit("playerUpdate" /* PlayerUpdate */, player, oldPlayer, 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 +1442,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 +1450,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 +1458,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 +1466,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 +1616,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 +1751,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 +1848,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 +1883,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 +2024,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 +2161,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 +2194,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 +2212,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 +2259,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 +2364,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 +2380,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 +2402,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 +2424,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 +2446,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 +2470,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 +2486,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 +2508,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 +2583,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 +2612,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 +2649,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 +2671,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 +2700,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 +2740,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 +2761,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 +2782,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 +2795,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 +2809,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 +2819,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 +2835,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 +2866,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 +2885,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 +2903,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 +2924,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 +2940,14 @@ var FilterManager = class {
       speed: settings.speed ?? 1
     };
     this.filters.timescale = !this.filters.timescale;
-    await this.apply();
-    return this.filters.timescale;
+    return this.apply();
+  }
+  /**
+   * Convert the filter settings to a JSON object.
+   * @returns {FilterSettings} The filter settings as a JSON object.
+   */
+  toJSON() {
+    return { ...this.data };
   }
 };
 
@@ -3057,10 +3141,23 @@ var Player = class {
    */
   createdTimestamp = 0;
   /**
-   * The position of the player.
+   * The last position received from Lavalink.
    * @type {number}
    */
-  position = 0;
+  lastPosition = 0;
+  /**
+   * The timestamp when the last position change update happened.
+   * @type {number | null}
+   */
+  lastPositionUpdate = null;
+  /**
+   * The current calculated position of the player.
+   * @type {number}
+   * @readonly
+   */
+  get position() {
+    return this.lastPosition + (this.lastPositionUpdate ? Date.now() - this.lastPositionUpdate : 0);
+  }
   /**
    * The voice connection details.
    * @type {PlayerVoice}
@@ -3182,6 +3279,8 @@ var Player = class {
     if (typeof position !== "number" || Number.isNaN(position) || position < 0)
       throw new PlayerError("Position must be a positive number.");
     this.manager.emit("debug" /* Debug */, 3 /* Player */, `[Player] -> [Seek] Seeking to ${position} for guild: ${this.guildId}`);
+    this.lastPosition = position;
+    this.lastPositionUpdate = Date.now();
     await this.updatePlayer({ playerOptions: { position } });
   }
   /**
@@ -3255,10 +3354,15 @@ var Player = class {
     if (!isTrack(this.queue.current) && !isUnresolvedTrack(this.queue.current))
       throw new PlayerError("The track must be a valid Track or UnresolvedTrack instance.");
     this.manager.emit("debug" /* Debug */, 3 /* Player */, `[Player] -> [Play] A new track is playing: ${this.queue.current.info.title}`);
+    const position = options.position ?? 0;
+    this.lastPosition = position;
+    this.lastPositionUpdate = Date.now();
     await this.updatePlayer({
       noReplace: options.noReplace,
       playerOptions: {
         ...options,
+        position,
+        // Ensure position is sent to Lavalink
         track: {
           userData: this.queue.current.userData,
           encoded: this.queue.current.encoded
@@ -3308,7 +3412,8 @@ var Player = class {
     this.manager.emit("debug" /* Debug */, 3 /* Player */, `[Player] -> [Stop] Player stopped for guild: ${this.guildId}`);
     this.playing = false;
     this.paused = false;
-    this.position = 0;
+    this.lastPosition = 0;
+    this.lastPositionUpdate = null;
     this.queue.current = null;
     return;
   }
@@ -3328,6 +3433,12 @@ var Player = class {
       3 /* Player */,
       `[Player] -> [Pause] Player is now ${paused ? "paused" : "resumed"} for guild: ${this.guildId}`
     );
+    if (paused) {
+      this.lastPositionUpdate = null;
+    } else {
+      this.lastPosition = this.position;
+      this.lastPositionUpdate = Date.now();
+    }
     await this.updatePlayer({ playerOptions: { paused } });
     return paused;
   }
@@ -3495,6 +3606,13 @@ var Player = class {
       selfDeaf: this.selfDeaf,
       options: this.options,
       voice: this.voice,
+      textId: this.textId,
+      lastPosition: this.lastPosition,
+      lastPositionUpdate: this.lastPositionUpdate,
+      position: this.position,
+      createdTimestamp: this.createdTimestamp,
+      ping: this.ping,
+      filters: this.filterManager.toJSON(),
       queue: this.queue.toJSON(),
       node: this.node.toJSON()
     };
@@ -3623,7 +3741,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 +3783,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 +4537,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 +4621,7 @@ export {
   Queue,
   ResolveError,
   Rest,
+  RestPathType,
   SearchEngines,
   Severity,
   SourceNames,