lavalink-client 2.9.8 → 2.9.10

package/dist/index.cjs

@@ -589,11 +589,12 @@ var QueueSymbol = /* @__PURE__ */ Symbol("LC-Queue");
 var NodeSymbol = /* @__PURE__ */ Symbol("LC-Node");
 var escapeRegExp = (str) => str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 function parseLavalinkConnUrl(connectionUrl) {
-  if (!connectionUrl.startsWith("lavalink://"))
-    throw new Error(`ConnectionUrl (${connectionUrl}) must start with 'lavalink://'`);
+  if (!connectionUrl.startsWith("lavalink://") && !connectionUrl.startsWith("nodelink://"))
+    throw new Error(`ConnectionUrl (${connectionUrl}) must start with 'lavalink://' or 'nodelink://'`);
   const parsed = new import_node_url.URL(connectionUrl);
   return {
     authorization: parsed.password,
+    nodeType: connectionUrl.startsWith("lavalink://") ? "Lavalink" : "NodeLink",
     id: parsed.username,
     host: parsed.hostname,
     port: Number(parsed.port)
@@ -3137,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.
@@ -3154,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
       });
     });
   }
@@ -3181,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;
@@ -3353,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

@@ -404,12 +404,13 @@ declare const UnresolvedTrackSymbol: unique symbol;
 declare const QueueSymbol: unique symbol;
 declare const NodeSymbol: unique symbol;
 /**
- * Parses Node Connection Url: "lavalink://<nodeId>:<nodeAuthorization(Password)>@<NodeHost>:<NodePort>"
+ * Parses Node Connection Url: "lavalink://<nodeId>:<nodeAuthorization(Password)>@<NodeHost>:<NodePort>" or "nodelink://<nodeId>:<nodeAuthorization(Password)>@<NodeHost>:<NodePort>"
  * @param connectionUrl
  * @returns
  */
 declare function parseLavalinkConnUrl(connectionUrl: string): {
     authorization: string;
+    nodeType: NodeTypes;
     id: string;
     host: string;
     port: number;
@@ -1513,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 & {
@@ -2881,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

@@ -404,12 +404,13 @@ declare const UnresolvedTrackSymbol: unique symbol;
 declare const QueueSymbol: unique symbol;
 declare const NodeSymbol: unique symbol;
 /**
- * Parses Node Connection Url: "lavalink://<nodeId>:<nodeAuthorization(Password)>@<NodeHost>:<NodePort>"
+ * Parses Node Connection Url: "lavalink://<nodeId>:<nodeAuthorization(Password)>@<NodeHost>:<NodePort>" or "nodelink://<nodeId>:<nodeAuthorization(Password)>@<NodeHost>:<NodePort>"
  * @param connectionUrl
  * @returns
  */
 declare function parseLavalinkConnUrl(connectionUrl: string): {
     authorization: string;
+    nodeType: NodeTypes;
     id: string;
     host: string;
     port: number;
@@ -1513,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 & {
@@ -2881,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

@@ -525,11 +525,12 @@ var QueueSymbol = /* @__PURE__ */ Symbol("LC-Queue");
 var NodeSymbol = /* @__PURE__ */ Symbol("LC-Node");
 var escapeRegExp = (str) => str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 function parseLavalinkConnUrl(connectionUrl) {
-  if (!connectionUrl.startsWith("lavalink://"))
-    throw new Error(`ConnectionUrl (${connectionUrl}) must start with 'lavalink://'`);
+  if (!connectionUrl.startsWith("lavalink://") && !connectionUrl.startsWith("nodelink://"))
+    throw new Error(`ConnectionUrl (${connectionUrl}) must start with 'lavalink://' or 'nodelink://'`);
   const parsed = new URL2(connectionUrl);
   return {
     authorization: parsed.password,
+    nodeType: connectionUrl.startsWith("lavalink://") ? "Lavalink" : "NodeLink",
     id: parsed.username,
     host: parsed.hostname,
     port: Number(parsed.port)
@@ -3073,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.
@@ -3090,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
       });
     });
   }
@@ -3117,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;
@@ -3289,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

@@ -525,11 +525,12 @@ var QueueSymbol = /* @__PURE__ */ Symbol("LC-Queue");
 var NodeSymbol = /* @__PURE__ */ Symbol("LC-Node");
 var escapeRegExp = (str) => str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 function parseLavalinkConnUrl(connectionUrl) {
-  if (!connectionUrl.startsWith("lavalink://"))
-    throw new Error(`ConnectionUrl (${connectionUrl}) must start with 'lavalink://'`);
+  if (!connectionUrl.startsWith("lavalink://") && !connectionUrl.startsWith("nodelink://"))
+    throw new Error(`ConnectionUrl (${connectionUrl}) must start with 'lavalink://' or 'nodelink://'`);
   const parsed = new URL2(connectionUrl);
   return {
     authorization: parsed.password,
+    nodeType: connectionUrl.startsWith("lavalink://") ? "Lavalink" : "NodeLink",
     id: parsed.username,
     host: parsed.hostname,
     port: Number(parsed.port)
@@ -3073,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.
@@ -3090,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
       });
     });
   }
@@ -3117,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;
@@ -3289,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.8",
+    "version": "2.9.10",
     "description": "Easy, flexible and feature-rich lavalink@v4 Client. Both for Beginners and Proficients. - Supports NodeLink@v3 too.",
     "keywords": [
         "advanced",