hoshimi 0.3.1 → 0.3.3

package/dist/index.d.mts

@@ -1738,6 +1738,11 @@ declare class FilterManager {
      * @returns {Promise<this>} The instance of the filter manager.
      */
     setTimescale(settings: Partial<TimescaleSettings>): Promise<this>;
+    /**
+     * Convert the filter settings to a JSON object.
+     * @returns {FilterSettings} The filter settings as a JSON object.
+     */
+    toJSON(): FilterSettings;
 }
 
 /**
@@ -1916,10 +1921,21 @@ declare class Player {
      */
     createdTimestamp: number;
     /**
-     * The position of the player.
+     * The last position received from Lavalink.
      * @type {number}
      */
-    position: number;
+    lastPosition: number;
+    /**
+     * The timestamp when the last position change update happened.
+     * @type {number | null}
+     */
+    lastPositionUpdate: number | null;
+    /**
+     * The current calculated position of the player.
+     * @type {number}
+     * @readonly
+     */
+    get position(): number;
     /**
      * The voice connection details.
      * @type {PlayerVoice}
@@ -3266,16 +3282,46 @@ interface PlayerJson {
      * @type {string | undefined}
      */
     textId?: string;
+    /**
+     * The last position received from Lavalink.
+     * @type {number}
+     */
+    lastPosition: number;
+    /**
+     * The timestamp when the last position change update happened.
+     * @type {number | null}
+     */
+    lastPositionUpdate: number | null;
+    /**
+     * The current calculated position of the player.
+     * @type {number}
+     */
+    position: number;
+    /**
+     * The timestamp when the player was created.
+     * @type {number}
+     */
+    createdTimestamp: number;
+    /**
+     * The ping of the player.
+     * @type {number}
+     */
+    ping: number;
     /**
      * The queue of the player.
-     * @type {QueueJson | undefined}
+     * @type {QueueJson}
      */
-    queue?: QueueJson;
+    queue: QueueJson;
     /**
      * The node of the player.
-     * @type {NodeJson | undefined}
+     * @type {NodeJson}
      */
-    node?: NodeJson;
+    node: NodeJson;
+    /**
+     * The filter settings of the player.
+     * @type {FilterSettings}
+     */
+    filters: FilterSettings;
 }
 /**
  * The lyrics methods for the player.

package/dist/index.d.ts

@@ -1738,6 +1738,11 @@ declare class FilterManager {
      * @returns {Promise<this>} The instance of the filter manager.
      */
     setTimescale(settings: Partial<TimescaleSettings>): Promise<this>;
+    /**
+     * Convert the filter settings to a JSON object.
+     * @returns {FilterSettings} The filter settings as a JSON object.
+     */
+    toJSON(): FilterSettings;
 }
 
 /**
@@ -1916,10 +1921,21 @@ declare class Player {
      */
     createdTimestamp: number;
     /**
-     * The position of the player.
+     * The last position received from Lavalink.
      * @type {number}
      */
-    position: number;
+    lastPosition: number;
+    /**
+     * The timestamp when the last position change update happened.
+     * @type {number | null}
+     */
+    lastPositionUpdate: number | null;
+    /**
+     * The current calculated position of the player.
+     * @type {number}
+     * @readonly
+     */
+    get position(): number;
     /**
      * The voice connection details.
      * @type {PlayerVoice}
@@ -3266,16 +3282,46 @@ interface PlayerJson {
      * @type {string | undefined}
      */
     textId?: string;
+    /**
+     * The last position received from Lavalink.
+     * @type {number}
+     */
+    lastPosition: number;
+    /**
+     * The timestamp when the last position change update happened.
+     * @type {number | null}
+     */
+    lastPositionUpdate: number | null;
+    /**
+     * The current calculated position of the player.
+     * @type {number}
+     */
+    position: number;
+    /**
+     * The timestamp when the player was created.
+     * @type {number}
+     */
+    createdTimestamp: number;
+    /**
+     * The ping of the player.
+     * @type {number}
+     */
+    ping: number;
     /**
      * The queue of the player.
-     * @type {QueueJson | undefined}
+     * @type {QueueJson}
      */
-    queue?: QueueJson;
+    queue: QueueJson;
     /**
      * The node of the player.
-     * @type {NodeJson | undefined}
+     * @type {NodeJson}
      */
-    node?: NodeJson;
+    node: NodeJson;
+    /**
+     * The filter settings of the player.
+     * @type {FilterSettings}
+     */
+    filters: FilterSettings;
 }
 /**
  * The lyrics methods for the player.

package/dist/index.js

@@ -531,12 +531,12 @@ var UnresolvedTrack = class {
 // package.json
 var package_default = {
   name: "hoshimi",
-  version: "0.3.1",
+  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.24.0+sha512.01ff8ae71b4419903b65c60fb2dc9d34cf8bb6e06d03bde112ef38f7a34d6904c424ba66bea5cdcf12890230bf39f9580473140ed9c946fef328b6e5238a345a",
+  packageManager: "pnpm@10.25.0+sha512.5e82639027af37cf832061bcc6d639c219634488e0f2baebe785028a793de7b525ffcd3f7ff574f5e9860654e098fe852ba8ac5dd5cefe1767d23a020a92f501",
   files: [
     "dist"
   ],
@@ -573,7 +573,7 @@ var package_default = {
   license: "MIT",
   devDependencies: {
     "@biomejs/biome": "^2.3.8",
-    "@types/node": "^24.10.1",
+    "@types/node": "^25.0.1",
     "@types/ws": "^8.18.1",
     husky: "^9.1.7",
     "lint-staged": "^16.2.7",
@@ -818,7 +818,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) {
@@ -1492,7 +1495,8 @@ 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 */,
@@ -3005,6 +3009,13 @@ var FilterManager = class {
     this.filters.timescale = !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 };
+  }
 };
 
 // src/classes/player/Storage.ts
@@ -3197,10 +3208,23 @@ var Player = class {
    */
   createdTimestamp = 0;
   /**
-   * The position of the player.
+   * The last position received from Lavalink.
+   * @type {number}
+   */
+  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
    */
-  position = 0;
+  get position() {
+    return this.lastPosition + (this.lastPositionUpdate ? Date.now() - this.lastPositionUpdate : 0);
+  }
   /**
    * The voice connection details.
    * @type {PlayerVoice}
@@ -3322,6 +3346,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 } });
   }
   /**
@@ -3395,10 +3421,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
@@ -3448,7 +3479,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;
   }
@@ -3468,6 +3500,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;
   }
@@ -3635,6 +3673,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()
     };

package/dist/index.mjs

@@ -464,12 +464,12 @@ var UnresolvedTrack = class {
 // package.json
 var package_default = {
   name: "hoshimi",
-  version: "0.3.1",
+  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.24.0+sha512.01ff8ae71b4419903b65c60fb2dc9d34cf8bb6e06d03bde112ef38f7a34d6904c424ba66bea5cdcf12890230bf39f9580473140ed9c946fef328b6e5238a345a",
+  packageManager: "pnpm@10.25.0+sha512.5e82639027af37cf832061bcc6d639c219634488e0f2baebe785028a793de7b525ffcd3f7ff574f5e9860654e098fe852ba8ac5dd5cefe1767d23a020a92f501",
   files: [
     "dist"
   ],
@@ -506,7 +506,7 @@ var package_default = {
   license: "MIT",
   devDependencies: {
     "@biomejs/biome": "^2.3.8",
-    "@types/node": "^24.10.1",
+    "@types/node": "^25.0.1",
     "@types/ws": "^8.18.1",
     husky: "^9.1.7",
     "lint-staged": "^16.2.7",
@@ -751,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) {
@@ -1425,7 +1428,8 @@ 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 */,
@@ -2938,6 +2942,13 @@ var FilterManager = class {
     this.filters.timescale = !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 };
+  }
 };
 
 // src/classes/player/Storage.ts
@@ -3130,10 +3141,23 @@ var Player = class {
    */
   createdTimestamp = 0;
   /**
-   * The position of the player.
+   * The last position received from Lavalink.
+   * @type {number}
+   */
+  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
    */
-  position = 0;
+  get position() {
+    return this.lastPosition + (this.lastPositionUpdate ? Date.now() - this.lastPositionUpdate : 0);
+  }
   /**
    * The voice connection details.
    * @type {PlayerVoice}
@@ -3255,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 } });
   }
   /**
@@ -3328,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
@@ -3381,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;
   }
@@ -3401,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;
   }
@@ -3568,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()
     };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "hoshimi",
-    "version": "0.3.1",
+    "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",