lavalink-client 2.6.3 → 2.6.4

package/dist/index.d.mts

@@ -1404,6 +1404,24 @@ declare class ManagerUtils {
      * @param data
      */
     isNodeOptions(data: LavalinkNodeOptions): boolean;
+    /**
+     * Validate tracks based on duration wether they are playble or broken tracks.
+     * most tracks should be longer than 30s, so you can put a minDuration of 29e3 (cause preview tracks are exactly 30s) or put 0.
+     * This check is not done automatically, you need to check it yourself by doing:
+     * @example
+     * ```ts
+     * const tracks = await player.search("Adele");
+     *
+     * // short hand:
+     * const validTracks = tracks.filter(client.lavalink.utils.isNotBrokenTrack)
+     * // or with options:
+     * const vaildTracks = tracks.filter(t => client.lavalink.utils.isNotBrokenTrack(t, 29e3));
+     *
+     * // then you can add it to the queue.
+     * await player.queue.add(validTracks);
+     * ```
+     */
+    isNotBrokenTrack(data: Track, minDuration?: number): data is Track;
     /**
      * Validate if a data is equal to a track
      * @param data the Track to validate

package/dist/index.d.ts

@@ -1404,6 +1404,24 @@ declare class ManagerUtils {
      * @param data
      */
     isNodeOptions(data: LavalinkNodeOptions): boolean;
+    /**
+     * Validate tracks based on duration wether they are playble or broken tracks.
+     * most tracks should be longer than 30s, so you can put a minDuration of 29e3 (cause preview tracks are exactly 30s) or put 0.
+     * This check is not done automatically, you need to check it yourself by doing:
+     * @example
+     * ```ts
+     * const tracks = await player.search("Adele");
+     *
+     * // short hand:
+     * const validTracks = tracks.filter(client.lavalink.utils.isNotBrokenTrack)
+     * // or with options:
+     * const vaildTracks = tracks.filter(t => client.lavalink.utils.isNotBrokenTrack(t, 29e3));
+     *
+     * // then you can add it to the queue.
+     * await player.queue.add(validTracks);
+     * ```
+     */
+    isNotBrokenTrack(data: Track, minDuration?: number): data is Track;
     /**
      * Validate if a data is equal to a track
      * @param data the Track to validate

package/dist/index.js

@@ -671,6 +671,29 @@ var ManagerUtils = class {
     if ("requestTimeout" in data && (typeof data.requestTimeout !== "number" || isNaN(data.requestTimeout) || data.requestTimeout <= 0 && data.requestTimeout !== void 0)) return false;
     return true;
   }
+  /**
+   * Validate tracks based on duration wether they are playble or broken tracks.
+   * most tracks should be longer than 30s, so you can put a minDuration of 29e3 (cause preview tracks are exactly 30s) or put 0.
+   * This check is not done automatically, you need to check it yourself by doing:
+   * @example
+   * ```ts
+   * const tracks = await player.search("Adele");
+   *
+   * // short hand:
+   * const validTracks = tracks.filter(client.lavalink.utils.isNotBrokenTrack)
+   * // or with options:
+   * const vaildTracks = tracks.filter(t => client.lavalink.utils.isNotBrokenTrack(t, 29e3));
+   *
+   * // then you can add it to the queue.
+   * await player.queue.add(validTracks);
+   * ```
+   */
+  isNotBrokenTrack(data, minDuration = 29e3) {
+    if (typeof data?.info?.duration !== "number" || isNaN(data?.info?.duration)) return false;
+    if (data.info.duration <= Math.max(minDuration, 0)) return false;
+    if (!data.info) return false;
+    return this.isTrack(data);
+  }
   /**
    * Validate if a data is equal to a track
    * @param data the Track to validate

package/dist/index.mjs

@@ -611,6 +611,29 @@ var ManagerUtils = class {
     if ("requestTimeout" in data && (typeof data.requestTimeout !== "number" || isNaN(data.requestTimeout) || data.requestTimeout <= 0 && data.requestTimeout !== void 0)) return false;
     return true;
   }
+  /**
+   * Validate tracks based on duration wether they are playble or broken tracks.
+   * most tracks should be longer than 30s, so you can put a minDuration of 29e3 (cause preview tracks are exactly 30s) or put 0.
+   * This check is not done automatically, you need to check it yourself by doing:
+   * @example
+   * ```ts
+   * const tracks = await player.search("Adele");
+   *
+   * // short hand:
+   * const validTracks = tracks.filter(client.lavalink.utils.isNotBrokenTrack)
+   * // or with options:
+   * const vaildTracks = tracks.filter(t => client.lavalink.utils.isNotBrokenTrack(t, 29e3));
+   *
+   * // then you can add it to the queue.
+   * await player.queue.add(validTracks);
+   * ```
+   */
+  isNotBrokenTrack(data, minDuration = 29e3) {
+    if (typeof data?.info?.duration !== "number" || isNaN(data?.info?.duration)) return false;
+    if (data.info.duration <= Math.max(minDuration, 0)) return false;
+    if (!data.info) return false;
+    return this.isTrack(data);
+  }
   /**
    * Validate if a data is equal to a track
    * @param data the Track to validate

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lavalink-client",
-  "version": "2.6.3",
+  "version": "2.6.4",
   "description": "Easy, flexible and feature-rich lavalink@v4 Client. Both for Beginners and Proficients.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",