lavalink-client 2.9.9 → 2.9.10

package/dist/index.cjs

@@ -3138,6 +3138,36 @@ var NodeLinkNode = class extends LavalinkNode {
     }
     this.nodeType = "NodeLink";
   }
+  /**
+   * Uses the gapless feature to set the next track to be played.
+   * @param player current player
+   * @param track if no track provided, it will use the next track from queue
+   */
+  async setNextTrackGapLess(player, track) {
+    if (!this.sessionId) throw new Error("The Lavalink Node is either not ready, or not up to date!");
+    const nextTrack = track || player.queue.tracks[0];
+    if (!nextTrack) throw new Error("No track provided");
+    await this.updatePlayer({
+      guildId: player.guildId,
+      // @ts-expect-error - nextTrack is not a valid property of LavalinkPlayOptions but for NodeLink it is
+      playerOptions: { nextTrack: { encoded: nextTrack.encoded, userData: nextTrack.userData || {} } }
+    });
+    return true;
+  }
+  /**
+   * Retrieves the meaning of a track.
+   * @param track
+   * @returns {MeaningResponse}
+   * @link {https://nodelink.js.org/docs/api/nodelink-features#meaning-system}
+   */
+  async getMeaning(track) {
+    if (!this.sessionId) throw new Error("The Lavalink Node is either not ready, or not up to date!");
+    const encodedTrack = track?.encoded;
+    if (!encodedTrack) throw new Error("No track provided");
+    return await this.request(`/meaning?encodedTrack=${encodedTrack}`, (m) => {
+      m.method = "GET";
+    });
+  }
   /**
    * Adds a new audio track to be mixed over the current playback.
    * @param player The player to add the mixer layer to.
@@ -3155,7 +3185,7 @@ var NodeLinkNode = class extends LavalinkNode {
           //identifier: trackToAdd.info?.identifier, // atm not supported
           userData: trackToAdd.userData
         },
-        volume: (volume / 100).toFixed(2)
+        volume: volume / 100
       });
     });
   }
@@ -3182,7 +3212,7 @@ var NodeLinkNode = class extends LavalinkNode {
     await this.request(`/sessions/${this.sessionId}/players/${player.guildId}/mix/${mixId}`, (m) => {
       m.method = "PATCH";
       m.body = safeStringify({
-        volume: (volume / 100).toFixed(2)
+        volume: volume / 100
       });
     });
     return true;
@@ -3354,7 +3384,7 @@ var NodeLinkNode = class extends LavalinkNode {
    */
   async loadDirectStream(track, volume, position, filters) {
     let requestPath = `/loadstream?encodedTrack=${track.encoded}`;
-    if (volume && volume > 0 && volume <= 100) requestPath += `&volume=${(volume / 100).toFixed(2)}`;
+    if (volume && volume > 0 && volume <= 100) requestPath += `&volume=${volume / 100}`;
     if (position && position > 0) requestPath += `&position=${position}`;
     if (filters) requestPath += `&filters=${typeof filters === "object" ? safeStringify(filters) : filters}`;
     const res = await this.rawRequest(requestPath, (m) => {

package/dist/index.d.cts

@@ -1514,6 +1514,17 @@ type YoutubeOAuthResponse = {
     scope: string;
     token_type: string;
 };
+type MeaningResponse = {
+    loadType: "meaning";
+    data: {
+        title: string;
+        description: string;
+        paragraphs: string[];
+        url: string;
+        provider: string;
+        type: string;
+    };
+};
 
 /** Ability to manipulate fetch requests */
 type ModifyRequest = (options: RequestInit & {
@@ -2882,6 +2893,19 @@ declare class Player {
 declare class NodeLinkNode extends LavalinkNode {
     nodeType: "NodeLink";
     constructor(options: LavalinkNodeOptions, manager: NodeManager);
+    /**
+     * Uses the gapless feature to set the next track to be played.
+     * @param player current player
+     * @param track if no track provided, it will use the next track from queue
+     */
+    setNextTrackGapLess(player: Player, track?: Track | UnresolvedTrack): Promise<boolean>;
+    /**
+     * Retrieves the meaning of a track.
+     * @param track
+     * @returns {MeaningResponse}
+     * @link {https://nodelink.js.org/docs/api/nodelink-features#meaning-system}
+     */
+    getMeaning(track?: Track | UnresolvedTrack): Promise<MeaningResponse>;
     /**
      * Adds a new audio track to be mixed over the current playback.
      * @param player The player to add the mixer layer to.

package/dist/index.d.ts

@@ -1514,6 +1514,17 @@ type YoutubeOAuthResponse = {
     scope: string;
     token_type: string;
 };
+type MeaningResponse = {
+    loadType: "meaning";
+    data: {
+        title: string;
+        description: string;
+        paragraphs: string[];
+        url: string;
+        provider: string;
+        type: string;
+    };
+};
 
 /** Ability to manipulate fetch requests */
 type ModifyRequest = (options: RequestInit & {
@@ -2882,6 +2893,19 @@ declare class Player {
 declare class NodeLinkNode extends LavalinkNode {
     nodeType: "NodeLink";
     constructor(options: LavalinkNodeOptions, manager: NodeManager);
+    /**
+     * Uses the gapless feature to set the next track to be played.
+     * @param player current player
+     * @param track if no track provided, it will use the next track from queue
+     */
+    setNextTrackGapLess(player: Player, track?: Track | UnresolvedTrack): Promise<boolean>;
+    /**
+     * Retrieves the meaning of a track.
+     * @param track
+     * @returns {MeaningResponse}
+     * @link {https://nodelink.js.org/docs/api/nodelink-features#meaning-system}
+     */
+    getMeaning(track?: Track | UnresolvedTrack): Promise<MeaningResponse>;
     /**
      * Adds a new audio track to be mixed over the current playback.
      * @param player The player to add the mixer layer to.

package/dist/index.js

@@ -3074,6 +3074,36 @@ var NodeLinkNode = class extends LavalinkNode {
     }
     this.nodeType = "NodeLink";
   }
+  /**
+   * Uses the gapless feature to set the next track to be played.
+   * @param player current player
+   * @param track if no track provided, it will use the next track from queue
+   */
+  async setNextTrackGapLess(player, track) {
+    if (!this.sessionId) throw new Error("The Lavalink Node is either not ready, or not up to date!");
+    const nextTrack = track || player.queue.tracks[0];
+    if (!nextTrack) throw new Error("No track provided");
+    await this.updatePlayer({
+      guildId: player.guildId,
+      // @ts-expect-error - nextTrack is not a valid property of LavalinkPlayOptions but for NodeLink it is
+      playerOptions: { nextTrack: { encoded: nextTrack.encoded, userData: nextTrack.userData || {} } }
+    });
+    return true;
+  }
+  /**
+   * Retrieves the meaning of a track.
+   * @param track
+   * @returns {MeaningResponse}
+   * @link {https://nodelink.js.org/docs/api/nodelink-features#meaning-system}
+   */
+  async getMeaning(track) {
+    if (!this.sessionId) throw new Error("The Lavalink Node is either not ready, or not up to date!");
+    const encodedTrack = track?.encoded;
+    if (!encodedTrack) throw new Error("No track provided");
+    return await this.request(`/meaning?encodedTrack=${encodedTrack}`, (m) => {
+      m.method = "GET";
+    });
+  }
   /**
    * Adds a new audio track to be mixed over the current playback.
    * @param player The player to add the mixer layer to.
@@ -3091,7 +3121,7 @@ var NodeLinkNode = class extends LavalinkNode {
           //identifier: trackToAdd.info?.identifier, // atm not supported
           userData: trackToAdd.userData
         },
-        volume: (volume / 100).toFixed(2)
+        volume: volume / 100
       });
     });
   }
@@ -3118,7 +3148,7 @@ var NodeLinkNode = class extends LavalinkNode {
     await this.request(`/sessions/${this.sessionId}/players/${player.guildId}/mix/${mixId}`, (m) => {
       m.method = "PATCH";
       m.body = safeStringify({
-        volume: (volume / 100).toFixed(2)
+        volume: volume / 100
       });
     });
     return true;
@@ -3290,7 +3320,7 @@ var NodeLinkNode = class extends LavalinkNode {
    */
   async loadDirectStream(track, volume, position, filters) {
     let requestPath = `/loadstream?encodedTrack=${track.encoded}`;
-    if (volume && volume > 0 && volume <= 100) requestPath += `&volume=${(volume / 100).toFixed(2)}`;
+    if (volume && volume > 0 && volume <= 100) requestPath += `&volume=${volume / 100}`;
     if (position && position > 0) requestPath += `&position=${position}`;
     if (filters) requestPath += `&filters=${typeof filters === "object" ? safeStringify(filters) : filters}`;
     const res = await this.rawRequest(requestPath, (m) => {

package/dist/index.mjs

@@ -3074,6 +3074,36 @@ var NodeLinkNode = class extends LavalinkNode {
     }
     this.nodeType = "NodeLink";
   }
+  /**
+   * Uses the gapless feature to set the next track to be played.
+   * @param player current player
+   * @param track if no track provided, it will use the next track from queue
+   */
+  async setNextTrackGapLess(player, track) {
+    if (!this.sessionId) throw new Error("The Lavalink Node is either not ready, or not up to date!");
+    const nextTrack = track || player.queue.tracks[0];
+    if (!nextTrack) throw new Error("No track provided");
+    await this.updatePlayer({
+      guildId: player.guildId,
+      // @ts-expect-error - nextTrack is not a valid property of LavalinkPlayOptions but for NodeLink it is
+      playerOptions: { nextTrack: { encoded: nextTrack.encoded, userData: nextTrack.userData || {} } }
+    });
+    return true;
+  }
+  /**
+   * Retrieves the meaning of a track.
+   * @param track
+   * @returns {MeaningResponse}
+   * @link {https://nodelink.js.org/docs/api/nodelink-features#meaning-system}
+   */
+  async getMeaning(track) {
+    if (!this.sessionId) throw new Error("The Lavalink Node is either not ready, or not up to date!");
+    const encodedTrack = track?.encoded;
+    if (!encodedTrack) throw new Error("No track provided");
+    return await this.request(`/meaning?encodedTrack=${encodedTrack}`, (m) => {
+      m.method = "GET";
+    });
+  }
   /**
    * Adds a new audio track to be mixed over the current playback.
    * @param player The player to add the mixer layer to.
@@ -3091,7 +3121,7 @@ var NodeLinkNode = class extends LavalinkNode {
           //identifier: trackToAdd.info?.identifier, // atm not supported
           userData: trackToAdd.userData
         },
-        volume: (volume / 100).toFixed(2)
+        volume: volume / 100
       });
     });
   }
@@ -3118,7 +3148,7 @@ var NodeLinkNode = class extends LavalinkNode {
     await this.request(`/sessions/${this.sessionId}/players/${player.guildId}/mix/${mixId}`, (m) => {
       m.method = "PATCH";
       m.body = safeStringify({
-        volume: (volume / 100).toFixed(2)
+        volume: volume / 100
       });
     });
     return true;
@@ -3290,7 +3320,7 @@ var NodeLinkNode = class extends LavalinkNode {
    */
   async loadDirectStream(track, volume, position, filters) {
     let requestPath = `/loadstream?encodedTrack=${track.encoded}`;
-    if (volume && volume > 0 && volume <= 100) requestPath += `&volume=${(volume / 100).toFixed(2)}`;
+    if (volume && volume > 0 && volume <= 100) requestPath += `&volume=${volume / 100}`;
     if (position && position > 0) requestPath += `&position=${position}`;
     if (filters) requestPath += `&filters=${typeof filters === "object" ? safeStringify(filters) : filters}`;
     const res = await this.rawRequest(requestPath, (m) => {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "lavalink-client",
-    "version": "2.9.9",
+    "version": "2.9.10",
     "description": "Easy, flexible and feature-rich lavalink@v4 Client. Both for Beginners and Proficients. - Supports NodeLink@v3 too.",
     "keywords": [
         "advanced",