distube 3.2.0 → 3.3.0

package/dist/DisTube.d.ts

@@ -43,8 +43,12 @@ export declare class DisTube extends TypedEmitter<DisTubeEvents> {
      * @param {string|Song|SearchResult|Playlist} song URL | Search string |
      * {@link Song} | {@link SearchResult} | {@link Playlist}
      * @param {Object} [options] Optional options
-     * @param {boolean} [options.skip=false] Skip the playing song (if exists) and play the added song/playlist instantly
-     * @param {boolean} [options.unshift=false] Add the song/playlist to the beginning of the queue
+     * @param {boolean} [options.skip=false]
+     * Skip the playing song (if exists) and play the added song/playlist if `position` is 1.
+     * If `position` is defined and not equal to 1, it will skip to the next song instead of the added song
+     * @param {number} [options.position=0] Position of the song/playlist to add to the queue,
+     * <= 0 to add to the end of the queue.
+     * @param {boolean} [options.unshift=false] (DEPRECATED) Add the song/playlist to the beginning of the queue
      * (after the playing song if exists)
      * @param {Discord.GuildMember} [options.member] Requested user (default is your bot)
      * @param {Discord.BaseGuildTextChannel} [options.textChannel] Default {@link Queue#textChannel}
@@ -68,32 +72,29 @@ export declare class DisTube extends TypedEmitter<DisTubeEvents> {
      */
     play(voiceChannel: VoiceBasedChannel, song: string | Song | SearchResult | Playlist | null, options?: {
         skip?: boolean;
-        unshift?: boolean;
+        position?: number;
         member?: GuildMember;
         textChannel?: GuildTextBasedChannel;
         message?: Message;
         metadata?: any;
     }): Promise<void>;
-    /**
-     * Play / add a song or playlist from url. Search and play a song if it is not a valid url.
-     *
-     * @param {Discord.Message} message A message from guild channel
-     * @param {string|Song|SearchResult|Playlist} song URL | Search string |
-     * {@link Song} | {@link SearchResult} | {@link Playlist}
-     * @param {Object} [options] Optional options
-     * @param {boolean} [options.skip=false] Skip the playing song (if exists) and play the added song/playlist instantly
-     * @param {boolean} [options.unshift=false] Add the song/playlist to the beginning of the queue
-     * (after the playing song if exists)
-     * @param {*} [options.metadata] Optional metadata that can be attached to the song/playlist will be played,
-     * This is useful for identification purposes when the song/playlist is passed around in events.
-     * See {@link Song#metadata} or {@link Playlist#metadata}
-     * @deprecated Message parameter is deprecated, use VoiceChannel instead. See {@link DisTube#play}
-     */
+    /** @deprecated Message parameter is deprecated, use VoiceChannel instead. */
     play(message: Message<true>, song: string | Song | SearchResult | Playlist, options?: {
         skip?: boolean;
         unshift?: boolean;
         metadata?: any;
     }): Promise<void>;
+    /** @deprecated `options.unshift` is deprecated, use `options.position` instead */
+    play(voiceChannel: VoiceBasedChannel, song: string | Song | SearchResult | Playlist | null, options?: {
+        skip?: boolean;
+        /** @deprecated Use `options.position` instead */
+        unshift?: boolean;
+        position?: number;
+        member?: GuildMember;
+        textChannel?: GuildTextBasedChannel;
+        message?: Message;
+        metadata?: any;
+    }): Promise<void>;
     /**
      * Play / add a song or playlist from url. Search and play a song if it is not a valid url.
      *
@@ -102,8 +103,12 @@ export declare class DisTube extends TypedEmitter<DisTubeEvents> {
      * @param {string|Song|SearchResult|Playlist} song URL | Search string |
      * {@link Song} | {@link SearchResult} | {@link Playlist}
      * @param {Object} [options] Optional options
-     * @param {boolean} [options.skip=false] Skip the playing song (if exists) and play the added song/playlist instantly
-     * @param {boolean} [options.unshift=false] Add the song/playlist to the beginning of the queue
+     * @param {boolean} [options.skip=false]
+     * Skip the playing song (if exists) and play the added song/playlist if `position` is 1.
+     * If `position` is defined and not equal to 1, it will skip to the next song instead of the added song
+     * @param {number} [options.position=0] Position of the song/playlist to add to the queue,
+     * <= 0 to add to the end of the queue.
+     * @param {boolean} [options.unshift=false] (DEPRECATED) Add the song/playlist to the beginning of the queue
      * (after the playing song if exists)
      * @param {Discord.GuildMember} [options.member] Requested user (default is your bot)
      * @param {Discord.BaseGuildTextChannel} [options.textChannel] Default {@link Queue#textChannel}
@@ -116,6 +121,7 @@ export declare class DisTube extends TypedEmitter<DisTubeEvents> {
     playVoiceChannel(voiceChannel: VoiceBasedChannel, song: string | Song | SearchResult | Playlist | null, options?: {
         skip?: boolean;
         unshift?: boolean;
+        position?: number;
         member?: GuildMember;
         textChannel?: GuildTextBasedChannel;
         message?: Message;
@@ -168,7 +174,9 @@ export declare class DisTube extends TypedEmitter<DisTubeEvents> {
      */
     playCustomPlaylist(message: Message<true>, songs: Array<string | Song | SearchResult>, properties?: Record<string, any>, options?: {
         skip?: boolean;
+        /** @deprecated */
         unshift?: boolean;
+        position?: number;
         parallel?: boolean;
         metadata?: any;
     }): Promise<void>;

package/dist/DisTube.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DisTube.d.ts","sourceRoot":"","sources":["../src/DisTube.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAEL,cAAc,EACd,mBAAmB,EAGnB,OAAO,EACP,QAAQ,EACR,KAAK,EACL,YAAY,EACZ,YAAY,EACZ,IAAI,EAQL,MAAM,GAAG,CAAC;AACX,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,qBAAqB,EAAE,OAAO,EAAe,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACtH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,GAAG,CAAC;AAMlH,eAAO,MAAQ,OAAO,QAAoD,CAAC;AAE3E;;;GAGG;AACH,qBAAa,OAAQ,SAAQ,YAAY,CAAC,aAAa,CAAC;IACtD,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,gBAAgB,EAAE,eAAe,EAAE,CAAC;IAC7C,QAAQ,CAAC,aAAa,EAAE,YAAY,EAAE,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B;;;;;;;;;;;;OAYG;gBACS,MAAM,EAAE,MAAM,EAAE,GAAG,GAAE,cAAmB;IAuDpD,MAAM,KAAK,OAAO,WAEjB;IAED;;;OAGG;IACH,IAAI,OAAO,WAEV;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,IAAI,CACR,YAAY,EAAE,iBAAiB,EAC/B,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY,GAAG,QAAQ,GAAG,IAAI,EACpD,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,WAAW,CAAC,EAAE,qBAAqB,CAAC;QACpC,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,QAAQ,CAAC,EAAE,GAAG,CAAC;KAChB,GACA,OAAO,CAAC,IAAI,CAAC;IAChB;;;;;;;;;;;;;;OAcG;IACG,IAAI,CACR,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,EACtB,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY,GAAG,QAAQ,EAC7C,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,GAAG,CAAA;KAAE,GAC9D,OAAO,CAAC,IAAI,CAAC;IA+GhB;;;;;;;;;;;;;;;;;;OAkBG;IACG,gBAAgB,CACpB,YAAY,EAAE,iBAAiB,EAC/B,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY,GAAG,QAAQ,GAAG,IAAI,EACpD,OAAO,GAAE;QACP,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,WAAW,CAAC,EAAE,qBAAqB,CAAC;QACpC,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,QAAQ,CAAC,EAAE,GAAG,CAAC;KACX,GACL,OAAO,CAAC,IAAI,CAAC;IAKhB;;;;;;;;;;;;;;;;;OAiBG;IACG,oBAAoB,CACxB,KAAK,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,YAAY,CAAC,EAAE,EACvC,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,QAAQ,CAAC,EAAE,GAAG,CAAC;KACX,GACL,OAAO,CAAC,QAAQ,CAAC;IA4BpB;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,kBAAkB,CACtB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,EACtB,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,GAAG,YAAY,CAAC,EAC1C,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EACpC,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,GAAG,CAAA;KAAO,GACtF,OAAO,CAAC,IAAI,CAAC;IAsChB;;;;;;;;;;;OAWG;IACG,MAAM,CACV,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GACrG,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAuB/B;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,KAAK,GAAG,SAAS;IAIrD;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,KAAK;IAMtC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,KAAK;IAMvC;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK;IAM3D;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjD;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,KAAK,CAAC;IAMjD;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAI,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAM3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,aAAa,CAAC,KAAK,EAAE,iBAAiB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAM9D;;;;;;;;;;;;;;;OAeG;IACH,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO;IAOjD;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvD;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAS,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,KAAK,UAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;IAMzF;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK;IAOnD;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,IAAI;CAe/D;AAED,eAAe,OAAO,CAAC;AAEvB;;;;;;;;;;GAUG;AAEH;;;;;;;;;;GAUG;AAEH;;;;;;;;;;GAUG;AAEH;;;;;;;;;;GAUG;AAEH;;;;;;;;GAQG;AAEH;;;;;;;;;;GAUG;AAEH;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;GAaG;AAEH;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;GAWG;AAEH;;;;;;;;GAQG;AAEH;;;;;GAKG;AAEH;;;;;GAKG;AAEH;;;;;;GAMG"}
+{"version":3,"file":"DisTube.d.ts","sourceRoot":"","sources":["../src/DisTube.ts"],"names":[],"mappings":"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"}

package/dist/DisTube.js

@@ -99,7 +99,7 @@ class DisTube extends tiny_typed_emitter_1.TypedEmitter {
     }
     async play(voiceChannel, song, options = {}) {
         if ((0, _1.isMessageInstance)(voiceChannel)) {
-            process.emitWarning("Passing Message for DisTube#play is deprecated, use VoiceBasedChannel instead.", "DeprecationWarning");
+            process.emitWarning("Passing Message for DisTube#play is deprecated, use BaseGuildVoiceChannel instead.", "DeprecationWarning");
             const message = voiceChannel;
             if (!song)
                 throw new _1.DisTubeError("INVALID_TYPE", ["string", "Song", "SearchResult", "Playlist"], song, "song");
@@ -114,6 +114,7 @@ class DisTube extends tiny_typed_emitter_1.TypedEmitter {
             const vc = member.voice.channel;
             if (!vc)
                 throw new _1.DisTubeError("NOT_IN_VOICE");
+            // eslint-disable-next-line deprecation/deprecation
             return this.play(vc, song, {
                 member,
                 textChannel,
@@ -129,11 +130,23 @@ class DisTube extends tiny_typed_emitter_1.TypedEmitter {
         if (typeof options !== "object" || Array.isArray(options)) {
             throw new _1.DisTubeError("INVALID_TYPE", "object", options, "options");
         }
+        // eslint-disable-next-line deprecation/deprecation
         const { textChannel, member, skip, message, unshift, metadata } = Object.assign({
             member: voiceChannel.guild.me,
             skip: false,
             unshift: false,
         }, options);
+        let position = Number(options.position);
+        if (!position) {
+            if (skip && position !== 0)
+                position = 1;
+            else
+                position = 0;
+        }
+        if (unshift) {
+            process.emitWarning("'unshift' option in DisTube#play is deprecated, use 'position' instead.", "DeprecationWarning");
+            position = 1;
+        }
         if (message && !(0, _1.isMessageInstance)(message)) {
             throw new _1.DisTubeError("INVALID_TYPE", ["Discord.Message", "a falsy value"], message, "options.message");
         }
@@ -165,7 +178,7 @@ class DisTube extends tiny_typed_emitter_1.TypedEmitter {
                 if (!song)
                     return;
                 if (song instanceof _1.Playlist) {
-                    await this.handler.handlePlaylist(voiceChannel, song, { textChannel, skip, unshift });
+                    await this.handler.handlePlaylist(voiceChannel, song, { textChannel, skip, position });
                 }
                 else if (!this.options.nsfw && song.age_restricted && !textChannel?.nsfw) {
                     throw new _1.DisTubeError("NON_NSFW");
@@ -173,7 +186,7 @@ class DisTube extends tiny_typed_emitter_1.TypedEmitter {
                 else {
                     queue = this.getQueue(voiceChannel);
                     if (queue) {
-                        queue.addToQueue(song, skip || unshift ? 1 : -1);
+                        queue.addToQueue(song, position);
                         if (skip)
                             queue.skip();
                         else
@@ -213,8 +226,12 @@ class DisTube extends tiny_typed_emitter_1.TypedEmitter {
      * @param {string|Song|SearchResult|Playlist} song URL | Search string |
      * {@link Song} | {@link SearchResult} | {@link Playlist}
      * @param {Object} [options] Optional options
-     * @param {boolean} [options.skip=false] Skip the playing song (if exists) and play the added song/playlist instantly
-     * @param {boolean} [options.unshift=false] Add the song/playlist to the beginning of the queue
+     * @param {boolean} [options.skip=false]
+     * Skip the playing song (if exists) and play the added song/playlist if `position` is 1.
+     * If `position` is defined and not equal to 1, it will skip to the next song instead of the added song
+     * @param {number} [options.position=0] Position of the song/playlist to add to the queue,
+     * <= 0 to add to the end of the queue.
+     * @param {boolean} [options.unshift=false] (DEPRECATED) Add the song/playlist to the beginning of the queue
      * (after the playing song if exists)
      * @param {Discord.GuildMember} [options.member] Requested user (default is your bot)
      * @param {Discord.BaseGuildTextChannel} [options.textChannel] Default {@link Queue#textChannel}
@@ -301,11 +318,21 @@ class DisTube extends tiny_typed_emitter_1.TypedEmitter {
             if (typeof options !== "object" || Array.isArray(options)) {
                 throw new _1.DisTubeError("INVALID_TYPE", "object", options, "options");
             }
+            // eslint-disable-next-line deprecation/deprecation
             const { skip, unshift, parallel, metadata } = Object.assign({
                 skip: false,
                 unshift: false,
                 parallel: true,
             }, options);
+            let position = Number(options.position);
+            if (!position) {
+                if (skip && position !== 0)
+                    position = 1;
+                else
+                    position = 0;
+            }
+            if (unshift)
+                position = 1;
             const queue = this.getQueue(message);
             const queuing = queue && !queue.taskQueue.hasResolveTask;
             if (queuing)
@@ -320,7 +347,7 @@ class DisTube extends tiny_typed_emitter_1.TypedEmitter {
                 const voice = message.member?.voice?.channel;
                 if (!voice)
                     throw new _1.DisTubeError("NOT_IN_VOICE");
-                await this.play(voice, playlist, { textChannel: message.channel, skip, unshift, metadata });
+                await this.play(voice, playlist, { textChannel: message.channel, skip, position, metadata });
             }
             finally {
                 if (queuing)

package/dist/DisTube.js.map

@@ -1 +1 @@
-{"version":3,"file":"DisTube.js","sourceRoot":"","sources":["../src/DisTube.ts"],"names":[],"mappings":"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","sourcesContent":["import ytpl from \"@distube/ytpl\";\nimport ytsr from \"@distube/ytsr\";\nimport { checkIntents, isURL } from \"./util\";\nimport { TypedEmitter } from \"tiny-typed-emitter\";\nimport {\n  DisTubeError,\n  DisTubeHandler,\n  DisTubeVoiceManager,\n  HTTPPlugin,\n  HTTPSPlugin,\n  Options,\n  Playlist,\n  Queue,\n  QueueManager,\n  SearchResult,\n  Song,\n  YouTubeDLPlugin,\n  defaultFilters,\n  isClientInstance,\n  isMemberInstance,\n  isMessageInstance,\n  isSupportedVoiceChannel,\n  isTextChannelInstance,\n} from \".\";\nimport type { Client, GuildMember, GuildTextBasedChannel, Message, TextChannel, VoiceBasedChannel } from \"discord.js\";\nimport type { CustomPlugin, DisTubeEvents, DisTubeOptions, ExtractorPlugin, Filters, GuildIdResolvable } from \".\";\n\n// TODO: remove deprecated stuff on the next major version\n\n// Cannot be `import` as it's not under TS root dir\n// eslint-disable-next-line @typescript-eslint/no-var-requires, @typescript-eslint/no-require-imports\nexport const { version }: { version: string } = require(\"../package.json\");\n\n/**\n * DisTube class\n * @extends EventEmitter\n */\nexport class DisTube extends TypedEmitter<DisTubeEvents> {\n  readonly handler: DisTubeHandler;\n  readonly options: Options;\n  readonly client: Client;\n  readonly queues: QueueManager;\n  readonly voices: DisTubeVoiceManager;\n  readonly extractorPlugins: ExtractorPlugin[];\n  readonly customPlugins: CustomPlugin[];\n  readonly filters: Filters;\n  /**\n   * Create a new DisTube class.\n   * @param {Discord.Client} client Discord.JS client\n   * @param {DisTubeOptions} [otp] Custom DisTube options\n   * @example\n   * const Discord = require('discord.js'),\n   *     DisTube = require('distube'),\n   *     client = new Discord.Client();\n   * // Create a new DisTube\n   * const distube = new DisTube.default(client, { searchSongs: 10 });\n   * // client.DisTube = distube // make it access easily\n   * client.login(\"Your Discord Bot Token\")\n   */\n  constructor(client: Client, otp: DisTubeOptions = {}) {\n    super();\n    this.setMaxListeners(1);\n    if (!isClientInstance(client)) throw new DisTubeError(\"INVALID_TYPE\", \"Discord.Client\", client, \"client\");\n    /**\n     * Discord.JS client\n     * @type {Discord.Client}\n     */\n    this.client = client;\n    checkIntents(client.options);\n    /**\n     * DisTube options\n     * @type {DisTubeOptions}\n     */\n    this.options = new Options(otp);\n    /**\n     * Voice connections manager\n     * @type {DisTubeVoiceManager}\n     */\n    this.voices = new DisTubeVoiceManager(this);\n    /**\n     * DisTube's Handler\n     * @type {DisTubeHandler}\n     * @private\n     */\n    this.handler = new DisTubeHandler(this);\n    /**\n     * Queues manager\n     * @type {QueueManager}\n     */\n    this.queues = new QueueManager(this);\n    /**\n     * DisTube filters\n     * @type {Filters}\n     */\n    this.filters = defaultFilters;\n    Object.assign(this.filters, this.options.customFilters);\n    // Default plugin\n    this.options.plugins.push(new HTTPPlugin(), new HTTPSPlugin());\n    if (this.options.youtubeDL) this.options.plugins.push(new YouTubeDLPlugin(this.options.updateYouTubeDL));\n    this.options.plugins.map(p => p.init(this));\n    /**\n     * Extractor Plugins\n     * @type {ExtractorPlugin[]}\n     * @private\n     */\n    this.extractorPlugins = this.options.plugins.filter((p): p is ExtractorPlugin => p.type === \"extractor\");\n    /**\n     * Custom Plugins\n     * @type {CustomPlugin[]}\n     * @private\n     */\n    this.customPlugins = this.options.plugins.filter((p): p is CustomPlugin => p.type === \"custom\");\n  }\n\n  static get version() {\n    return version;\n  }\n\n  /**\n   * DisTube version\n   * @type {string}\n   */\n  get version() {\n    return version;\n  }\n\n  /**\n   * Play / add a song or playlist from url. Search and play a song if it is not a valid url.\n   *\n   * @param {Discord.BaseGuildVoiceChannel} voiceChannel The voice channel will be joined\n   * @param {string|Song|SearchResult|Playlist} song URL | Search string |\n   * {@link Song} | {@link SearchResult} | {@link Playlist}\n   * @param {Object} [options] Optional options\n   * @param {boolean} [options.skip=false] Skip the playing song (if exists) and play the added song/playlist instantly\n   * @param {boolean} [options.unshift=false] Add the song/playlist to the beginning of the queue\n   * (after the playing song if exists)\n   * @param {Discord.GuildMember} [options.member] Requested user (default is your bot)\n   * @param {Discord.BaseGuildTextChannel} [options.textChannel] Default {@link Queue#textChannel}\n   * @param {Discord.Message} [options.message] Called message (For built-in search events. If this is a {@link https://developer.mozilla.org/en-US/docs/Glossary/Falsy|falsy value}, it will play the first result instead)\n   * @param {*} [options.metadata] Optional metadata that can be attached to the song/playlist will be played,\n   * This is useful for identification purposes when the song/playlist is passed around in events.\n   * See {@link Song#metadata} or {@link Playlist#metadata}\n   * @example\n   * client.on('message', (message) => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if (command == \"play\")\n   *         distube.play(message.member.voice?.channel, args.join(\" \"), {\n   *             member: message.member,\n   *             textChannel: message.channel,\n   *             message\n   *         });\n   * });\n   * @returns {Promise<void>}\n   */\n  async play(\n    voiceChannel: VoiceBasedChannel,\n    song: string | Song | SearchResult | Playlist | null,\n    options?: {\n      skip?: boolean;\n      unshift?: boolean;\n      member?: GuildMember;\n      textChannel?: GuildTextBasedChannel;\n      message?: Message;\n      metadata?: any;\n    },\n  ): Promise<void>;\n  /**\n   * Play / add a song or playlist from url. Search and play a song if it is not a valid url.\n   *\n   * @param {Discord.Message} message A message from guild channel\n   * @param {string|Song|SearchResult|Playlist} song URL | Search string |\n   * {@link Song} | {@link SearchResult} | {@link Playlist}\n   * @param {Object} [options] Optional options\n   * @param {boolean} [options.skip=false] Skip the playing song (if exists) and play the added song/playlist instantly\n   * @param {boolean} [options.unshift=false] Add the song/playlist to the beginning of the queue\n   * (after the playing song if exists)\n   * @param {*} [options.metadata] Optional metadata that can be attached to the song/playlist will be played,\n   * This is useful for identification purposes when the song/playlist is passed around in events.\n   * See {@link Song#metadata} or {@link Playlist#metadata}\n   * @deprecated Message parameter is deprecated, use VoiceChannel instead. See {@link DisTube#play}\n   */\n  async play(\n    message: Message<true>,\n    song: string | Song | SearchResult | Playlist,\n    options?: { skip?: boolean; unshift?: boolean; metadata?: any },\n  ): Promise<void>;\n  async play(\n    voiceChannel: Message<true> | VoiceBasedChannel,\n    song: string | Song | SearchResult | Playlist | null,\n    options: {\n      skip?: boolean;\n      unshift?: boolean;\n      member?: GuildMember;\n      textChannel?: GuildTextBasedChannel;\n      message?: Message;\n      metadata?: any;\n    } = {},\n  ): Promise<void> {\n    if (isMessageInstance(voiceChannel)) {\n      process.emitWarning(\n        \"Passing Message for DisTube#play is deprecated, use VoiceBasedChannel instead.\",\n        \"DeprecationWarning\",\n      );\n      const message = voiceChannel;\n      if (!song) throw new DisTubeError(\"INVALID_TYPE\", [\"string\", \"Song\", \"SearchResult\", \"Playlist\"], song, \"song\");\n      if (!isMessageInstance(message)) throw new DisTubeError(\"INVALID_TYPE\", \"Discord.Message\", message, \"message\");\n      if (typeof options !== \"object\" || Array.isArray(options)) {\n        throw new DisTubeError(\"INVALID_TYPE\", \"object\", options, \"options\");\n      }\n\n      const textChannel = message.channel;\n      const { skip, unshift, metadata } = Object.assign({ skip: false, unshift: false }, options);\n      const member = message.member as GuildMember;\n      const vc = member.voice.channel;\n      if (!vc) throw new DisTubeError(\"NOT_IN_VOICE\");\n      return this.play(vc, song, {\n        member,\n        textChannel,\n        skip,\n        message,\n        unshift,\n        metadata,\n      });\n    }\n\n    if (!isSupportedVoiceChannel(voiceChannel)) {\n      throw new DisTubeError(\"INVALID_TYPE\", \"BaseGuildVoiceChannel\", voiceChannel, \"voiceChannel\");\n    }\n    if (typeof options !== \"object\" || Array.isArray(options)) {\n      throw new DisTubeError(\"INVALID_TYPE\", \"object\", options, \"options\");\n    }\n    const { textChannel, member, skip, message, unshift, metadata } = Object.assign(\n      {\n        member: voiceChannel.guild.me,\n        skip: false,\n        unshift: false,\n      },\n      options,\n    );\n    if (message && !isMessageInstance(message)) {\n      throw new DisTubeError(\"INVALID_TYPE\", [\"Discord.Message\", \"a falsy value\"], message, \"options.message\");\n    }\n    try {\n      if (typeof song === \"string\") {\n        for (const plugin of this.customPlugins) {\n          if (await plugin.validate(song)) {\n            return plugin.play(voiceChannel, song, options);\n          }\n        }\n      }\n      let queue = this.getQueue(voiceChannel);\n      const queuing = !!queue && !queue.taskQueue.hasResolveTask;\n      if (queuing) await queue?.taskQueue.queuing(true);\n      try {\n        if (song instanceof SearchResult && song.type === \"playlist\") song = song.url;\n        if (typeof song === \"string\" && ytpl.validateID(song)) {\n          song = await this.handler.resolvePlaylist(song, { member, metadata });\n        }\n        if (typeof song === \"string\" && !isURL(song)) {\n          if (!message) song = (await this.search(song, { limit: 1 }))[0];\n          else song = await this.handler.searchSong(message, song);\n        }\n        song = await this.handler.resolveSong(song, { member, metadata });\n        if (!song) return;\n        if (song instanceof Playlist) {\n          await this.handler.handlePlaylist(voiceChannel, song, { textChannel, skip, unshift });\n        } else if (!this.options.nsfw && song.age_restricted && !(textChannel as TextChannel)?.nsfw) {\n          throw new DisTubeError(\"NON_NSFW\");\n        } else {\n          queue = this.getQueue(voiceChannel);\n          if (queue) {\n            queue.addToQueue(song, skip || unshift ? 1 : -1);\n            if (skip) queue.skip();\n            else this.emit(\"addSong\", queue, song);\n          } else {\n            const newQueue = await this.queues.create(voiceChannel, song, textChannel);\n            if (newQueue instanceof Queue) {\n              if (this.options.emitAddSongWhenCreatingQueue) this.emit(\"addSong\", newQueue, song);\n              this.emit(\"playSong\", newQueue, song);\n            }\n          }\n        }\n      } finally {\n        if (queuing) queue?.taskQueue.resolve();\n      }\n    } catch (e: any) {\n      if (!(e instanceof DisTubeError)) {\n        try {\n          e.name = \"PlayError\";\n          e.message = `${(song as Song)?.url || song}\\n${e.message}`;\n        } catch {}\n      }\n      this.emitError(e, textChannel);\n    }\n  }\n\n  /**\n   * Play / add a song or playlist from url. Search and play a song if it is not a valid url.\n   *\n   * @returns {Promise<void>}\n   * @param {Discord.BaseGuildVoiceChannel} voiceChannel The voice channel will be joined\n   * @param {string|Song|SearchResult|Playlist} song URL | Search string |\n   * {@link Song} | {@link SearchResult} | {@link Playlist}\n   * @param {Object} [options] Optional options\n   * @param {boolean} [options.skip=false] Skip the playing song (if exists) and play the added song/playlist instantly\n   * @param {boolean} [options.unshift=false] Add the song/playlist to the beginning of the queue\n   * (after the playing song if exists)\n   * @param {Discord.GuildMember} [options.member] Requested user (default is your bot)\n   * @param {Discord.BaseGuildTextChannel} [options.textChannel] Default {@link Queue#textChannel}\n   * @param {Discord.Message} [options.message] Called message (For built-in search events. If this is a {@link https://developer.mozilla.org/en-US/docs/Glossary/Falsy|falsy value}, it will play the first result instead)\n   * @param {*} [options.metadata] Optional metadata that can be attached to the song/playlist will be played,\n   * This is useful for identification purposes when the song/playlist is passed around in events.\n   * See {@link Song#metadata} or {@link Playlist#metadata}\n   * @deprecated Use {@link DisTube#play} instead\n   */\n  async playVoiceChannel(\n    voiceChannel: VoiceBasedChannel,\n    song: string | Song | SearchResult | Playlist | null,\n    options: {\n      skip?: boolean;\n      unshift?: boolean;\n      member?: GuildMember;\n      textChannel?: GuildTextBasedChannel;\n      message?: Message;\n      metadata?: any;\n    } = {},\n  ): Promise<void> {\n    process.emitWarning(\"DisTube#playVoiceChannel is deprecated, use DisTube#play instead.\", \"DeprecationWarning\");\n    return this.play(voiceChannel, song, options);\n  }\n\n  /**\n   * Create a custom playlist\n   * @returns {Promise<Playlist>}\n   * @param {Array<string|Song|SearchResult>} songs Array of url, Song or SearchResult\n   * @param {Object} [options] Optional options\n   * @param {Discord.GuildMember} [options.message] A message from guild channel | A guild member\n   * @param {Object} [options.properties={}] Additional properties such as `name`\n   * @param {boolean} [options.parallel=true] Whether or not fetch the songs in parallel\n   * @param {*} [options.metadata] Metadata\n   * @example\n   * const songs = [\"https://www.youtube.com/watch?v=xxx\", \"https://www.youtube.com/watch?v=yyy\"];\n   * const playlist = await distube.createCustomPlaylist(songs, {\n   *     member: message.member,\n   *     properties: { name: \"My playlist name\" },\n   *     parallel: true\n   * });\n   * distube.play(voiceChannel, playlist, { ... });\n   */\n  async createCustomPlaylist(\n    songs: (string | Song | SearchResult)[],\n    options: {\n      member?: GuildMember;\n      properties?: Record<string, any>;\n      parallel?: boolean;\n      metadata?: any;\n    } = {},\n  ): Promise<Playlist> {\n    const { member, properties, parallel, metadata } = Object.assign({ parallel: true }, options);\n    if (!Array.isArray(songs)) throw new DisTubeError(\"INVALID_TYPE\", \"Array\", songs, \"songs\");\n    if (!songs.length) throw new DisTubeError(\"EMPTY_ARRAY\", \"songs\");\n    const filteredSongs = songs.filter(\n      song => song instanceof Song || (song instanceof SearchResult && song.type === \"video\") || isURL(song),\n    );\n    if (!filteredSongs.length) throw new DisTubeError(\"NO_VALID_SONG\");\n    if (member && !isMemberInstance(member)) {\n      throw new DisTubeError(\"INVALID_TYPE\", \"Discord.Member\", member, \"options.member\");\n    }\n    if (!filteredSongs.length) throw new DisTubeError(\"NO_VALID_SONG\");\n    let resolvedSongs: Song[];\n    if (parallel) {\n      const promises = filteredSongs.map((song: string | Song | SearchResult) =>\n        this.handler.resolveSong(song, { member, metadata }).catch(() => undefined),\n      );\n      resolvedSongs = (await Promise.all(promises)).filter((s: any): s is Song => !!s);\n    } else {\n      const resolved = [];\n      for (const song of filteredSongs) {\n        resolved.push(await this.handler.resolveSong(song, { member, metadata }).catch(() => undefined));\n      }\n      resolvedSongs = resolved.filter((s: any): s is Song => !!s);\n    }\n    return new Playlist(resolvedSongs, { member, properties, metadata });\n  }\n\n  /**\n   * <info>Shorthand method of {@link DisTube#createCustomPlaylist} and {@link DisTube#play}\n   *\n   * If you doesn't have a user message (interaction,...),\n   * see {@link DisTube#createCustomPlaylist} example</info>\n   *\n   * Play or add array of video urls.\n   * {@link DisTube#event:playSong} or {@link DisTube#event:addList} will be emitted\n   * with `playlist`'s properties include `properties` parameter's properties such as\n   * `user`, `songs`, `duration`, `formattedDuration`, `thumbnail` like {@link Playlist}\n   * @returns {Promise<void>}\n   * @param {Discord.Message} message A message from guild channel\n   * @param {Array<string|Song|SearchResult>} songs Array of url, Song or SearchResult\n   * @param {Object} [properties={}] Additional properties for playlist such as `name`\n   * @param {Object} [options] Optional options\n   * @param {boolean} [options.skip=false] Skip the playing song (if exists) and play the added song/playlist instantly\n   * @param {boolean} [options.unshift=false] Add the song/playlist to the beginning of the queue\n   * (after the playing song if exists)\n   * @param {boolean} [options.parallel=true] Whether or not fetch the songs in parallel\n   * @deprecated Use {@link DisTube#createCustomPlaylist} and {@link DisTube#play} instead\n   */\n  async playCustomPlaylist(\n    message: Message<true>,\n    songs: Array<string | Song | SearchResult>,\n    properties: Record<string, any> = {},\n    options: { skip?: boolean; unshift?: boolean; parallel?: boolean; metadata?: any } = {},\n  ): Promise<void> {\n    process.emitWarning(\n      \"DisTube#playCustomPlaylist is deprecated, use DisTube#createCustomPlaylist and DisTube#play instead.\",\n      \"DeprecationWarning\",\n    );\n    try {\n      if (typeof options !== \"object\" || Array.isArray(options)) {\n        throw new DisTubeError(\"INVALID_TYPE\", \"object\", options, \"options\");\n      }\n      const { skip, unshift, parallel, metadata } = Object.assign(\n        {\n          skip: false,\n          unshift: false,\n          parallel: true,\n        },\n        options,\n      );\n      const queue = this.getQueue(message);\n      const queuing = queue && !queue.taskQueue.hasResolveTask;\n      if (queuing) await queue?.taskQueue.queuing(true);\n      try {\n        const playlist = await this.createCustomPlaylist(songs, {\n          member: message.member ?? undefined,\n          properties,\n          parallel,\n          metadata,\n        });\n        const voice = message.member?.voice?.channel;\n        if (!voice) throw new DisTubeError(\"NOT_IN_VOICE\");\n        await this.play(voice, playlist, { textChannel: message.channel, skip, unshift, metadata });\n      } finally {\n        if (queuing) queue?.taskQueue.resolve();\n      }\n    } catch (e: any) {\n      this.emitError(e, message.channel);\n    }\n  }\n\n  /**\n   * Search for a song. You can customize how user answers instead of send a number.\n   * Then use {@link DisTube#play} to play it.\n   *\n   * @param {string} string The string search for\n   * @param {Object} options Search options\n   * @param {number} [options.limit=10] Limit the results\n   * @param {'video'|'playlist'} [options.type='video'] Type of results (`video` or `playlist`).\n   * @param {boolean} [options.safeSearch=false] Whether or not use safe search (YouTube restricted mode)\n   * @throws {Error}\n   * @returns {Promise<Array<SearchResult>>} Array of results\n   */\n  async search(\n    string: string,\n    options: { type?: \"video\" | \"playlist\"; limit?: number; safeSearch?: boolean; retried?: boolean } = {},\n  ): Promise<Array<SearchResult>> {\n    const opts = Object.assign({ type: \"video\", limit: 10, safeSearch: false }, options);\n    if (typeof opts.type !== \"string\" || ![\"video\", \"playlist\"].includes(opts.type)) {\n      throw new DisTubeError(\"INVALID_TYPE\", [\"video\", \"playlist\"], opts.type, \"options.type\");\n    }\n    if (typeof opts.limit !== \"number\") throw new DisTubeError(\"INVALID_TYPE\", \"number\", opts.limit, \"options.limit\");\n    if (opts.limit < 1) throw new DisTubeError(\"NUMBER_COMPARE\", \"option.limit\", \"bigger or equal to\", 1);\n    if (typeof opts.safeSearch !== \"boolean\") {\n      throw new DisTubeError(\"INVALID_TYPE\", \"boolean\", opts.safeSearch, \"options.safeSearch\");\n    }\n\n    try {\n      const search = await ytsr(string, opts);\n      const results = search.items.map(i => new SearchResult(i));\n      if (results.length === 0) throw new DisTubeError(\"NO_RESULT\");\n      return results;\n    } catch (e) {\n      if (options.retried) throw e;\n      options.retried = true;\n      return this.search(string, options);\n    }\n  }\n\n  /**\n   * Get the guild queue\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @returns {Queue?}\n   * @throws {Error}\n   * @example\n   * client.on('message', (message) => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if (command == \"queue\") {\n   *         const queue = distube.getQueue(message);\n   *         message.channel.send('Current queue:\\n' + queue.songs.map((song, id) =>\n   *             `**${id+1}**. [${song.name}](${song.url}) - \\`${song.formattedDuration}\\``\n   *         ).join(\"\\n\"));\n   *     }\n   * });\n   */\n  getQueue(queue: GuildIdResolvable): Queue | undefined {\n    return this.queues.get(queue);\n  }\n\n  /**\n   * Pause the guild stream\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @returns {Queue} The guild queue\n   * @throws {Error}\n   */\n  pause(queue: GuildIdResolvable): Queue {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.pause();\n  }\n\n  /**\n   * Resume the guild stream\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @returns {Queue} The guild queue\n   * @throws {Error}\n   */\n  resume(queue: GuildIdResolvable): Queue {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.resume();\n  }\n\n  /**\n   * Stop the guild stream\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @returns {Promise<void>}\n   * @throws {Error}\n   * @example\n   * client.on('message', (message) => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if (command == \"stop\") {\n   *         distube.stop(message);\n   *         message.channel.send(\"Stopped the queue!\");\n   *     }\n   * });\n   */\n  stop(queue: GuildIdResolvable): Promise<void> {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.stop();\n  }\n\n  /**\n   * Set the guild stream's volume\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @param {number} percent The percentage of volume you want to set\n   * @returns {Queue} The guild queue\n   * @throws {Error}\n   * @example\n   * client.on('message', (message) => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if (command == \"volume\")\n   *         distube.setVolume(message, Number(args[0]));\n   * });\n   */\n  setVolume(queue: GuildIdResolvable, percent: number): Queue {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.setVolume(percent);\n  }\n\n  /**\n   * Skip the playing song if there is a next song in the queue.\n   * <info>If {@link Queue#autoplay} is `true` and there is no up next song,\n   * DisTube will add and play a related song.</info>\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @returns {Promise<Song>} The new Song will be played\n   * @throws {Error}\n   * @example\n   * client.on('message', (message) => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if (command == \"skip\")\n   *         distube.skip(message);\n   * });\n   */\n  skip(queue: GuildIdResolvable): Promise<Song> {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.skip();\n  }\n\n  /**\n   * Play the previous song\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @returns {Promise<Song>} The new Song will be played\n   * @throws {Error}\n   * @example\n   * client.on('message', (message) => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if (command == \"previous\")\n   *         distube.previous(message);\n   * });\n   */\n  previous(queue: GuildIdResolvable): Promise<Song> {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.previous();\n  }\n\n  /**\n   * Shuffle the guild queue songs\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @returns {Promise<Queue>} The guild queue\n   * @example\n   * client.on('message', (message) => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if (command == \"shuffle\")\n   *         distube.shuffle(message);\n   * });\n   */\n  shuffle(queue: GuildIdResolvable): Promise<Queue> {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.shuffle();\n  }\n\n  /**\n   * Jump to the song number in the queue.\n   * The next one is 1, 2,...\n   * The previous one is -1, -2,...\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @param {number} num The song number to play\n   * @returns {Promise<Queue>} The guild queue\n   * @throws {Error} if `num` is invalid number (0 < num < {@link Queue#songs}.length)\n   * @example\n   * client.on('message', (message) => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if (command == \"jump\")\n   *         distube.jump(message, parseInt(args[0]))\n   *             .catch(err => message.channel.send(\"Invalid song number.\"));\n   * });\n   */\n  jump(queue: GuildIdResolvable, num: number): Promise<Queue> {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.jump(num);\n  }\n\n  /**\n   * Set the repeat mode of the guild queue.\\\n   * Toggle mode `(Disabled -> Song -> Queue -> Disabled ->...)` if `mode` is `undefined`\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @param {RepeatMode?} [mode] The repeat modes (toggle if `undefined`)\n   * @returns {RepeatMode} The new repeat mode\n   * @example\n   * client.on('message', (message) => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if (command == \"repeat\") {\n   *         let mode = distube.setRepeatMode(message, parseInt(args[0]));\n   *         mode = mode ? mode == 2 ? \"Repeat queue\" : \"Repeat song\" : \"Off\";\n   *         message.channel.send(\"Set repeat mode to `\" + mode + \"`\");\n   *     }\n   * });\n   * @example\n   * const { RepeatMode } = require(\"distube\");\n   * let mode;\n   * switch(distube.setRepeatMode(message, parseInt(args[0]))) {\n   *     case RepeatMode.DISABLED:\n   *         mode = \"Off\";\n   *         break;\n   *     case RepeatMode.SONG:\n   *         mode = \"Repeat a song\";\n   *         break;\n   *     case RepeatMode.QUEUE:\n   *         mode = \"Repeat all queue\";\n   *         break;\n   * }\n   * message.channel.send(\"Set repeat mode to `\" + mode + \"`\");\n   */\n  setRepeatMode(queue: GuildIdResolvable, mode?: number): number {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.setRepeatMode(mode);\n  }\n\n  /**\n   * Toggle autoplay mode\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @returns {boolean} Autoplay mode state\n   * @throws {Error}\n   * @example\n   * client.on('message', (message) => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if (command == \"autoplay\") {\n   *         const mode = distube.toggleAutoplay(message);\n   *         message.channel.send(\"Set autoplay mode to `\" + (mode ? \"On\" : \"Off\") + \"`\");\n   *     }\n   * });\n   */\n  toggleAutoplay(queue: GuildIdResolvable): boolean {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    q.autoplay = !q.autoplay;\n    return q.autoplay;\n  }\n\n  /**\n   * Add related song to the queue\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @returns {Promise<Song>} The guild queue\n   */\n  addRelatedSong(queue: GuildIdResolvable): Promise<Song> {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.addRelatedSong();\n  }\n\n  /**\n   * Enable or disable filter(s) of the queue.\n   * Available filters: {@link Filters}\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @param {string|false} filter A filter name, `false` to clear all the filters\n   * @param {boolean} [force=false] Force enable the input filter(s) even if it's enabled\n   * @returns {Array<string>} Enabled filters.\n   * @example\n   * client.on('message', (message) => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if ([`3d`, `bassboost`, `echo`, `karaoke`, `nightcore`, `vaporwave`].includes(command)) {\n   *         const filter = distube.setFilter(message, command);\n   *         message.channel.send(\"Current queue filter: \" + (filter.join(\", \") || \"Off\"));\n   *     }\n   * });\n   */\n  setFilter(queue: GuildIdResolvable, filter: string | false, force = false): Array<string> {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.setFilter(filter, force);\n  }\n\n  /**\n   * Set the playing time to another position\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @param {number} time Time in seconds\n   * @returns {Queue} Seeked queue\n   * @example\n   * client.on('message', message => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if (command = 'seek')\n   *         distube.seek(message, Number(args[0]));\n   * });\n   */\n  seek(queue: GuildIdResolvable, time: number): Queue {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.seek(time);\n  }\n\n  /* eslint-disable no-console */\n  /**\n   * Emit error event\n   * @param {Error} error error\n   * @param {Discord.BaseGuildTextChannel} [channel] Text channel where the error is encountered.\n   * @private\n   */\n  emitError(error: Error, channel?: GuildTextBasedChannel): void {\n    if (!channel || !isTextChannelInstance(channel)) {\n      console.error(error);\n      console.warn(\"This is logged because <Queue>.textChannel is undefined\");\n    } else if (this.listeners(\"error\").length) {\n      this.emit(\"error\", channel, error);\n    } else {\n      console.error(error);\n      console.warn(\"Unhandled 'error' event.\");\n      console.warn(\n        \"See: https://distube.js.org/#/docs/DisTube/stable/class/DisTube?scrollTo=e-error and https://nodejs.org/api/events.html#events_error_events\",\n      );\n    }\n  }\n  /* eslint-enable no-console */\n}\n\nexport default DisTube;\n\n/**\n * Emitted after DisTube add a new playlist to the playing {@link Queue}.\n *\n * @event DisTube#addList\n * @param {Queue} queue The guild queue\n * @param {Playlist} playlist Playlist info\n * @example\n * distube.on(\"addList\", (queue, playlist) => queue.textChannel.send(\n *     `Added \\`${playlist.name}\\` playlist (${playlist.songs.length} songs) to the queue!`\n * ));\n */\n\n/**\n * Emitted after DisTube add a new song to the playing {@link Queue}.\n *\n * @event DisTube#addSong\n * @param {Queue} queue The guild queue\n * @param {Song} song Added song\n * @example\n * distube.on(\"addSong\", (queue, song) => queue.textChannel.send(\n *     `Added ${song.name} - \\`${song.formattedDuration}\\` to the queue by ${song.user}.`\n * ));\n */\n\n/**\n * Emitted when there is no user in the voice channel,\n * {@link DisTubeOptions}.leaveOnEmpty is `true` and there is a playing queue.\n *\n * If there is no playing queue (stopped and {@link DisTubeOptions}.leaveOnStop is `false`),\n * it will leave the channel without emitting this event.\n * @event DisTube#empty\n * @param {Queue} queue The guild queue\n * @example\n * distube.on(\"empty\", queue => queue.textChannel.send(\"Channel is empty. Leaving the channel\"))\n */\n\n/**\n * Emitted when DisTube encounters an error.\n *\n * @event DisTube#error\n * @param {Discord.BaseGuildTextChannel} channel Text channel where the error is encountered.\n * @param {Error} error The error encountered\n * @example\n * distube.on(\"error\", (channel, error) => channel.send(\n *     \"An error encountered: \" + error\n * ));\n */\n\n/**\n * Emitted when there is no more song in the queue and {@link Queue#autoplay} is `false`.\n * DisTube will leave voice channel if {@link DisTubeOptions}.leaveOnFinish is `true`.\n *\n * @event DisTube#finish\n * @param {Queue} queue The guild queue\n * @example\n * distube.on(\"finish\", queue => queue.textChannel.send(\"No more song in queue\"));\n */\n\n/**\n * Emitted when DisTube initialize a queue to change queue default properties.\n *\n * @event DisTube#initQueue\n * @param {Queue} queue The guild queue\n * @example\n * distube.on(\"initQueue\", queue => {\n *     queue.autoplay = false;\n *     queue.volume = 100;\n * });\n */\n\n/**\n * Emitted when {@link Queue#autoplay} is `true`, {@link Queue#songs} is empty,\n * and DisTube cannot find related songs to play.\n *\n * @event DisTube#noRelated\n * @param {Queue} queue The guild queue\n * @example\n * distube.on(\"noRelated\", queue => queue.textChannel.send(\"Can't find related video to play.\"));\n */\n\n/**\n * Emitted when DisTube play a song.\n *\n * If {@link DisTubeOptions}.emitNewSongOnly is `true`,\n * this event is not emitted when looping a song or next song is the previous one.\n *\n * @event DisTube#playSong\n * @param {Queue} queue The guild queue\n * @param {Song} song Playing song\n * @example\n * distube.on(\"playSong\", (queue, song) => queue.textChannel.send(\n *     `Playing \\`${song.name}\\` - \\`${song.formattedDuration}\\`\\nRequested by: ${song.user}`\n * ));\n */\n\n/**\n * Emitted when DisTube cannot find any results for the query.\n *\n * @event DisTube#searchNoResult\n * @param {Discord.Message} message The user message called play method\n * @param {string} query The search query\n * @example\n * distube.on(\"searchNoResult\", (message, query) => message.channel.send(`No result found for ${query}!`));\n */\n\n/**\n * Emitted when {@link DisTubeOptions|DisTubeOptions.searchSongs} bigger than 0,\n * and song param of {@link DisTube#play} is invalid url.\n * DisTube will wait for user's next message to choose a song manually.\n * <info>{@link https://support.google.com/youtube/answer/7354993|Safe search} is enabled\n * if {@link DisTubeOptions}.nsfw is disabled and the message's channel is not a nsfw channel.</info>\n *\n * @event DisTube#searchResult\n * @param {Discord.Message} message The user message called play method\n * @param {Array<SearchResult>} results Searched results\n * @param {string} query The search query\n * @example\n * // DisTubeOptions.searchSongs > 0\n * distube.on(\"searchResult\", (message, results) => {\n *     message.channel.send(`**Choose an option from below**\\n${\n *         results.map((song, i) => `**${i + 1}**. ${song.name} - \\`${song.formattedDuration}\\``).join(\"\\n\")\n *     }\\n*Enter anything else or wait 60 seconds to cancel*`);\n * });\n */\n\n/**\n * Emitted when {@link DisTubeOptions|DisTubeOptions.searchSongs} bigger than 0,\n * and the search canceled due to {@link DisTubeOptions|DisTubeOptions.searchTimeout}.\n *\n * @event DisTube#searchCancel\n * @param {Discord.Message} message The user message called play method\n * @param {string} query The search query\n * @example\n * // DisTubeOptions.searchSongs > 0\n * distube.on(\"searchCancel\", (message) => message.channel.send(`Searching canceled`));\n */\n\n/**\n * Emitted when {@link DisTubeOptions|DisTubeOptions.searchSongs} bigger than 0,\n * and the search canceled due to user's next message is not a number or out of results range.\n *\n * @event DisTube#searchInvalidAnswer\n * @param {Discord.Message} message The user message called play method\n * @param {Discord.Message} answer The answered message of user\n * @param {string} query The search query\n * @example\n * // DisTubeOptions.searchSongs > 0\n * distube.on(\"searchInvalidAnswer\", (message) => message.channel.send(`You answered an invalid number!`));\n */\n\n/**\n * Emitted when {@link DisTubeOptions|DisTubeOptions.searchSongs} bigger than 0,\n * and after the user chose a search result to play.\n *\n * @event DisTube#searchDone\n * @param {Discord.Message} message The user message called play method\n * @param {Discord.Message} answer The answered message of user\n * @param {string} query The search query\n */\n\n/**\n * Emitted when the bot is disconnected to a voice channel.\n *\n * @event DisTube#disconnect\n * @param {Queue} queue The guild queue\n */\n\n/**\n * Emitted when a {@link Queue} is deleted with any reasons.\n *\n * @event DisTube#deleteQueue\n * @param {Queue} queue The guild queue\n */\n\n/**\n * Emitted when DisTube finished a song.\n *\n * @event DisTube#finishSong\n * @param {Queue} queue The guild queue\n * @param {Song} song Finished song\n */\n"]}
+{"version":3,"file":"DisTube.js","sourceRoot":"","sources":["../src/DisTube.ts"],"names":[],"mappings":"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","sourcesContent":["import ytpl from \"@distube/ytpl\";\nimport ytsr from \"@distube/ytsr\";\nimport { checkIntents, isURL } from \"./util\";\nimport { TypedEmitter } from \"tiny-typed-emitter\";\nimport {\n  DisTubeError,\n  DisTubeHandler,\n  DisTubeVoiceManager,\n  HTTPPlugin,\n  HTTPSPlugin,\n  Options,\n  Playlist,\n  Queue,\n  QueueManager,\n  SearchResult,\n  Song,\n  YouTubeDLPlugin,\n  defaultFilters,\n  isClientInstance,\n  isMemberInstance,\n  isMessageInstance,\n  isSupportedVoiceChannel,\n  isTextChannelInstance,\n} from \".\";\nimport type { Client, GuildMember, GuildTextBasedChannel, Message, TextChannel, VoiceBasedChannel } from \"discord.js\";\nimport type { CustomPlugin, DisTubeEvents, DisTubeOptions, ExtractorPlugin, Filters, GuildIdResolvable } from \".\";\n\n// TODO: remove deprecated stuff on the next major version\n\n// Cannot be `import` as it's not under TS root dir\n// eslint-disable-next-line @typescript-eslint/no-var-requires, @typescript-eslint/no-require-imports\nexport const { version }: { version: string } = require(\"../package.json\");\n\n/**\n * DisTube class\n * @extends EventEmitter\n */\nexport class DisTube extends TypedEmitter<DisTubeEvents> {\n  readonly handler: DisTubeHandler;\n  readonly options: Options;\n  readonly client: Client;\n  readonly queues: QueueManager;\n  readonly voices: DisTubeVoiceManager;\n  readonly extractorPlugins: ExtractorPlugin[];\n  readonly customPlugins: CustomPlugin[];\n  readonly filters: Filters;\n  /**\n   * Create a new DisTube class.\n   * @param {Discord.Client} client Discord.JS client\n   * @param {DisTubeOptions} [otp] Custom DisTube options\n   * @example\n   * const Discord = require('discord.js'),\n   *     DisTube = require('distube'),\n   *     client = new Discord.Client();\n   * // Create a new DisTube\n   * const distube = new DisTube.default(client, { searchSongs: 10 });\n   * // client.DisTube = distube // make it access easily\n   * client.login(\"Your Discord Bot Token\")\n   */\n  constructor(client: Client, otp: DisTubeOptions = {}) {\n    super();\n    this.setMaxListeners(1);\n    if (!isClientInstance(client)) throw new DisTubeError(\"INVALID_TYPE\", \"Discord.Client\", client, \"client\");\n    /**\n     * Discord.JS client\n     * @type {Discord.Client}\n     */\n    this.client = client;\n    checkIntents(client.options);\n    /**\n     * DisTube options\n     * @type {DisTubeOptions}\n     */\n    this.options = new Options(otp);\n    /**\n     * Voice connections manager\n     * @type {DisTubeVoiceManager}\n     */\n    this.voices = new DisTubeVoiceManager(this);\n    /**\n     * DisTube's Handler\n     * @type {DisTubeHandler}\n     * @private\n     */\n    this.handler = new DisTubeHandler(this);\n    /**\n     * Queues manager\n     * @type {QueueManager}\n     */\n    this.queues = new QueueManager(this);\n    /**\n     * DisTube filters\n     * @type {Filters}\n     */\n    this.filters = defaultFilters;\n    Object.assign(this.filters, this.options.customFilters);\n    // Default plugin\n    this.options.plugins.push(new HTTPPlugin(), new HTTPSPlugin());\n    if (this.options.youtubeDL) this.options.plugins.push(new YouTubeDLPlugin(this.options.updateYouTubeDL));\n    this.options.plugins.map(p => p.init(this));\n    /**\n     * Extractor Plugins\n     * @type {ExtractorPlugin[]}\n     * @private\n     */\n    this.extractorPlugins = this.options.plugins.filter((p): p is ExtractorPlugin => p.type === \"extractor\");\n    /**\n     * Custom Plugins\n     * @type {CustomPlugin[]}\n     * @private\n     */\n    this.customPlugins = this.options.plugins.filter((p): p is CustomPlugin => p.type === \"custom\");\n  }\n\n  static get version() {\n    return version;\n  }\n\n  /**\n   * DisTube version\n   * @type {string}\n   */\n  get version() {\n    return version;\n  }\n\n  /**\n   * Play / add a song or playlist from url. Search and play a song if it is not a valid url.\n   *\n   * @param {Discord.BaseGuildVoiceChannel} voiceChannel The voice channel will be joined\n   * @param {string|Song|SearchResult|Playlist} song URL | Search string |\n   * {@link Song} | {@link SearchResult} | {@link Playlist}\n   * @param {Object} [options] Optional options\n   * @param {boolean} [options.skip=false]\n   * Skip the playing song (if exists) and play the added song/playlist if `position` is 1.\n   * If `position` is defined and not equal to 1, it will skip to the next song instead of the added song\n   * @param {number} [options.position=0] Position of the song/playlist to add to the queue,\n   * <= 0 to add to the end of the queue.\n   * @param {boolean} [options.unshift=false] (DEPRECATED) Add the song/playlist to the beginning of the queue\n   * (after the playing song if exists)\n   * @param {Discord.GuildMember} [options.member] Requested user (default is your bot)\n   * @param {Discord.BaseGuildTextChannel} [options.textChannel] Default {@link Queue#textChannel}\n   * @param {Discord.Message} [options.message] Called message (For built-in search events. If this is a {@link https://developer.mozilla.org/en-US/docs/Glossary/Falsy|falsy value}, it will play the first result instead)\n   * @param {*} [options.metadata] Optional metadata that can be attached to the song/playlist will be played,\n   * This is useful for identification purposes when the song/playlist is passed around in events.\n   * See {@link Song#metadata} or {@link Playlist#metadata}\n   * @example\n   * client.on('message', (message) => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if (command == \"play\")\n   *         distube.play(message.member.voice?.channel, args.join(\" \"), {\n   *             member: message.member,\n   *             textChannel: message.channel,\n   *             message\n   *         });\n   * });\n   * @returns {Promise<void>}\n   */\n  async play(\n    voiceChannel: VoiceBasedChannel,\n    song: string | Song | SearchResult | Playlist | null,\n    options?: {\n      skip?: boolean;\n      position?: number;\n      member?: GuildMember;\n      textChannel?: GuildTextBasedChannel;\n      message?: Message;\n      metadata?: any;\n    },\n  ): Promise<void>;\n  /** @deprecated Message parameter is deprecated, use VoiceChannel instead. */\n  async play(\n    message: Message<true>,\n    song: string | Song | SearchResult | Playlist,\n    options?: { skip?: boolean; unshift?: boolean; metadata?: any },\n  ): Promise<void>;\n  /** @deprecated `options.unshift` is deprecated, use `options.position` instead */\n  async play(\n    voiceChannel: VoiceBasedChannel,\n    song: string | Song | SearchResult | Playlist | null,\n    options?: {\n      skip?: boolean;\n      /** @deprecated Use `options.position` instead */\n      unshift?: boolean;\n      position?: number;\n      member?: GuildMember;\n      textChannel?: GuildTextBasedChannel;\n      message?: Message;\n      metadata?: any;\n    },\n  ): Promise<void>;\n  async play(\n    voiceChannel: Message<true> | VoiceBasedChannel,\n    song: string | Song | SearchResult | Playlist | null,\n    options: {\n      skip?: boolean;\n      unshift?: boolean;\n      position?: number;\n      member?: GuildMember;\n      textChannel?: GuildTextBasedChannel;\n      message?: Message;\n      metadata?: any;\n    } = {},\n  ): Promise<void> {\n    if (isMessageInstance(voiceChannel)) {\n      process.emitWarning(\n        \"Passing Message for DisTube#play is deprecated, use BaseGuildVoiceChannel instead.\",\n        \"DeprecationWarning\",\n      );\n      const message = voiceChannel;\n      if (!song) throw new DisTubeError(\"INVALID_TYPE\", [\"string\", \"Song\", \"SearchResult\", \"Playlist\"], song, \"song\");\n      if (!isMessageInstance(message)) throw new DisTubeError(\"INVALID_TYPE\", \"Discord.Message\", message, \"message\");\n      if (typeof options !== \"object\" || Array.isArray(options)) {\n        throw new DisTubeError(\"INVALID_TYPE\", \"object\", options, \"options\");\n      }\n\n      const textChannel = message.channel;\n      const { skip, unshift, metadata } = Object.assign({ skip: false, unshift: false }, options);\n      const member = message.member as GuildMember;\n      const vc = member.voice.channel;\n      if (!vc) throw new DisTubeError(\"NOT_IN_VOICE\");\n      // eslint-disable-next-line deprecation/deprecation\n      return this.play(vc, song, {\n        member,\n        textChannel,\n        skip,\n        message,\n        unshift,\n        metadata,\n      });\n    }\n\n    if (!isSupportedVoiceChannel(voiceChannel)) {\n      throw new DisTubeError(\"INVALID_TYPE\", \"BaseGuildVoiceChannel\", voiceChannel, \"voiceChannel\");\n    }\n    if (typeof options !== \"object\" || Array.isArray(options)) {\n      throw new DisTubeError(\"INVALID_TYPE\", \"object\", options, \"options\");\n    }\n    // eslint-disable-next-line deprecation/deprecation\n    const { textChannel, member, skip, message, unshift, metadata } = Object.assign(\n      {\n        member: voiceChannel.guild.me,\n        skip: false,\n        unshift: false,\n      },\n      options,\n    );\n\n    let position = Number(options.position);\n    if (!position) {\n      if (skip && position !== 0) position = 1;\n      else position = 0;\n    }\n\n    if (unshift) {\n      process.emitWarning(\n        \"'unshift' option in DisTube#play is deprecated, use 'position' instead.\",\n        \"DeprecationWarning\",\n      );\n      position = 1;\n    }\n\n    if (message && !isMessageInstance(message)) {\n      throw new DisTubeError(\"INVALID_TYPE\", [\"Discord.Message\", \"a falsy value\"], message, \"options.message\");\n    }\n    try {\n      if (typeof song === \"string\") {\n        for (const plugin of this.customPlugins) {\n          if (await plugin.validate(song)) {\n            return plugin.play(voiceChannel, song, options);\n          }\n        }\n      }\n      let queue = this.getQueue(voiceChannel);\n      const queuing = !!queue && !queue.taskQueue.hasResolveTask;\n      if (queuing) await queue?.taskQueue.queuing(true);\n      try {\n        if (song instanceof SearchResult && song.type === \"playlist\") song = song.url;\n        if (typeof song === \"string\" && ytpl.validateID(song)) {\n          song = await this.handler.resolvePlaylist(song, { member, metadata });\n        }\n        if (typeof song === \"string\" && !isURL(song)) {\n          if (!message) song = (await this.search(song, { limit: 1 }))[0];\n          else song = await this.handler.searchSong(message, song);\n        }\n        song = await this.handler.resolveSong(song, { member, metadata });\n        if (!song) return;\n        if (song instanceof Playlist) {\n          await this.handler.handlePlaylist(voiceChannel, song, { textChannel, skip, position });\n        } else if (!this.options.nsfw && song.age_restricted && !(textChannel as TextChannel)?.nsfw) {\n          throw new DisTubeError(\"NON_NSFW\");\n        } else {\n          queue = this.getQueue(voiceChannel);\n          if (queue) {\n            queue.addToQueue(song, position);\n            if (skip) queue.skip();\n            else this.emit(\"addSong\", queue, song);\n          } else {\n            const newQueue = await this.queues.create(voiceChannel, song, textChannel);\n            if (newQueue instanceof Queue) {\n              if (this.options.emitAddSongWhenCreatingQueue) this.emit(\"addSong\", newQueue, song);\n              this.emit(\"playSong\", newQueue, song);\n            }\n          }\n        }\n      } finally {\n        if (queuing) queue?.taskQueue.resolve();\n      }\n    } catch (e: any) {\n      if (!(e instanceof DisTubeError)) {\n        try {\n          e.name = \"PlayError\";\n          e.message = `${(song as Song)?.url || song}\\n${e.message}`;\n        } catch {}\n      }\n      this.emitError(e, textChannel);\n    }\n  }\n\n  /**\n   * Play / add a song or playlist from url. Search and play a song if it is not a valid url.\n   *\n   * @returns {Promise<void>}\n   * @param {Discord.BaseGuildVoiceChannel} voiceChannel The voice channel will be joined\n   * @param {string|Song|SearchResult|Playlist} song URL | Search string |\n   * {@link Song} | {@link SearchResult} | {@link Playlist}\n   * @param {Object} [options] Optional options\n   * @param {boolean} [options.skip=false]\n   * Skip the playing song (if exists) and play the added song/playlist if `position` is 1.\n   * If `position` is defined and not equal to 1, it will skip to the next song instead of the added song\n   * @param {number} [options.position=0] Position of the song/playlist to add to the queue,\n   * <= 0 to add to the end of the queue.\n   * @param {boolean} [options.unshift=false] (DEPRECATED) Add the song/playlist to the beginning of the queue\n   * (after the playing song if exists)\n   * @param {Discord.GuildMember} [options.member] Requested user (default is your bot)\n   * @param {Discord.BaseGuildTextChannel} [options.textChannel] Default {@link Queue#textChannel}\n   * @param {Discord.Message} [options.message] Called message (For built-in search events. If this is a {@link https://developer.mozilla.org/en-US/docs/Glossary/Falsy|falsy value}, it will play the first result instead)\n   * @param {*} [options.metadata] Optional metadata that can be attached to the song/playlist will be played,\n   * This is useful for identification purposes when the song/playlist is passed around in events.\n   * See {@link Song#metadata} or {@link Playlist#metadata}\n   * @deprecated Use {@link DisTube#play} instead\n   */\n  async playVoiceChannel(\n    voiceChannel: VoiceBasedChannel,\n    song: string | Song | SearchResult | Playlist | null,\n    options: {\n      skip?: boolean;\n      unshift?: boolean;\n      position?: number;\n      member?: GuildMember;\n      textChannel?: GuildTextBasedChannel;\n      message?: Message;\n      metadata?: any;\n    } = {},\n  ): Promise<void> {\n    process.emitWarning(\"DisTube#playVoiceChannel is deprecated, use DisTube#play instead.\", \"DeprecationWarning\");\n    return this.play(voiceChannel, song, options);\n  }\n\n  /**\n   * Create a custom playlist\n   * @returns {Promise<Playlist>}\n   * @param {Array<string|Song|SearchResult>} songs Array of url, Song or SearchResult\n   * @param {Object} [options] Optional options\n   * @param {Discord.GuildMember} [options.message] A message from guild channel | A guild member\n   * @param {Object} [options.properties={}] Additional properties such as `name`\n   * @param {boolean} [options.parallel=true] Whether or not fetch the songs in parallel\n   * @param {*} [options.metadata] Metadata\n   * @example\n   * const songs = [\"https://www.youtube.com/watch?v=xxx\", \"https://www.youtube.com/watch?v=yyy\"];\n   * const playlist = await distube.createCustomPlaylist(songs, {\n   *     member: message.member,\n   *     properties: { name: \"My playlist name\" },\n   *     parallel: true\n   * });\n   * distube.play(voiceChannel, playlist, { ... });\n   */\n  async createCustomPlaylist(\n    songs: (string | Song | SearchResult)[],\n    options: {\n      member?: GuildMember;\n      properties?: Record<string, any>;\n      parallel?: boolean;\n      metadata?: any;\n    } = {},\n  ): Promise<Playlist> {\n    const { member, properties, parallel, metadata } = Object.assign({ parallel: true }, options);\n    if (!Array.isArray(songs)) throw new DisTubeError(\"INVALID_TYPE\", \"Array\", songs, \"songs\");\n    if (!songs.length) throw new DisTubeError(\"EMPTY_ARRAY\", \"songs\");\n    const filteredSongs = songs.filter(\n      song => song instanceof Song || (song instanceof SearchResult && song.type === \"video\") || isURL(song),\n    );\n    if (!filteredSongs.length) throw new DisTubeError(\"NO_VALID_SONG\");\n    if (member && !isMemberInstance(member)) {\n      throw new DisTubeError(\"INVALID_TYPE\", \"Discord.Member\", member, \"options.member\");\n    }\n    if (!filteredSongs.length) throw new DisTubeError(\"NO_VALID_SONG\");\n    let resolvedSongs: Song[];\n    if (parallel) {\n      const promises = filteredSongs.map((song: string | Song | SearchResult) =>\n        this.handler.resolveSong(song, { member, metadata }).catch(() => undefined),\n      );\n      resolvedSongs = (await Promise.all(promises)).filter((s: any): s is Song => !!s);\n    } else {\n      const resolved = [];\n      for (const song of filteredSongs) {\n        resolved.push(await this.handler.resolveSong(song, { member, metadata }).catch(() => undefined));\n      }\n      resolvedSongs = resolved.filter((s: any): s is Song => !!s);\n    }\n    return new Playlist(resolvedSongs, { member, properties, metadata });\n  }\n\n  /**\n   * <info>Shorthand method of {@link DisTube#createCustomPlaylist} and {@link DisTube#play}\n   *\n   * If you doesn't have a user message (interaction,...),\n   * see {@link DisTube#createCustomPlaylist} example</info>\n   *\n   * Play or add array of video urls.\n   * {@link DisTube#event:playSong} or {@link DisTube#event:addList} will be emitted\n   * with `playlist`'s properties include `properties` parameter's properties such as\n   * `user`, `songs`, `duration`, `formattedDuration`, `thumbnail` like {@link Playlist}\n   * @returns {Promise<void>}\n   * @param {Discord.Message} message A message from guild channel\n   * @param {Array<string|Song|SearchResult>} songs Array of url, Song or SearchResult\n   * @param {Object} [properties={}] Additional properties for playlist such as `name`\n   * @param {Object} [options] Optional options\n   * @param {boolean} [options.skip=false] Skip the playing song (if exists) and play the added song/playlist instantly\n   * @param {boolean} [options.unshift=false] Add the song/playlist to the beginning of the queue\n   * (after the playing song if exists)\n   * @param {boolean} [options.parallel=true] Whether or not fetch the songs in parallel\n   * @deprecated Use {@link DisTube#createCustomPlaylist} and {@link DisTube#play} instead\n   */\n  async playCustomPlaylist(\n    message: Message<true>,\n    songs: Array<string | Song | SearchResult>,\n    properties: Record<string, any> = {},\n    options: {\n      skip?: boolean;\n      /** @deprecated */\n      unshift?: boolean;\n      position?: number;\n      parallel?: boolean;\n      metadata?: any;\n    } = {},\n  ): Promise<void> {\n    process.emitWarning(\n      \"DisTube#playCustomPlaylist is deprecated, use DisTube#createCustomPlaylist and DisTube#play instead.\",\n      \"DeprecationWarning\",\n    );\n    try {\n      if (typeof options !== \"object\" || Array.isArray(options)) {\n        throw new DisTubeError(\"INVALID_TYPE\", \"object\", options, \"options\");\n      }\n      // eslint-disable-next-line deprecation/deprecation\n      const { skip, unshift, parallel, metadata } = Object.assign(\n        {\n          skip: false,\n          unshift: false,\n          parallel: true,\n        },\n        options,\n      );\n\n      let position = Number(options.position);\n      if (!position) {\n        if (skip && position !== 0) position = 1;\n        else position = 0;\n      }\n\n      if (unshift) position = 1;\n\n      const queue = this.getQueue(message);\n      const queuing = queue && !queue.taskQueue.hasResolveTask;\n      if (queuing) await queue?.taskQueue.queuing(true);\n      try {\n        const playlist = await this.createCustomPlaylist(songs, {\n          member: message.member ?? undefined,\n          properties,\n          parallel,\n          metadata,\n        });\n        const voice = message.member?.voice?.channel;\n        if (!voice) throw new DisTubeError(\"NOT_IN_VOICE\");\n        await this.play(voice, playlist, { textChannel: message.channel, skip, position, metadata });\n      } finally {\n        if (queuing) queue?.taskQueue.resolve();\n      }\n    } catch (e: any) {\n      this.emitError(e, message.channel);\n    }\n  }\n\n  /**\n   * Search for a song. You can customize how user answers instead of send a number.\n   * Then use {@link DisTube#play} to play it.\n   *\n   * @param {string} string The string search for\n   * @param {Object} options Search options\n   * @param {number} [options.limit=10] Limit the results\n   * @param {'video'|'playlist'} [options.type='video'] Type of results (`video` or `playlist`).\n   * @param {boolean} [options.safeSearch=false] Whether or not use safe search (YouTube restricted mode)\n   * @throws {Error}\n   * @returns {Promise<Array<SearchResult>>} Array of results\n   */\n  async search(\n    string: string,\n    options: { type?: \"video\" | \"playlist\"; limit?: number; safeSearch?: boolean; retried?: boolean } = {},\n  ): Promise<Array<SearchResult>> {\n    const opts = Object.assign({ type: \"video\", limit: 10, safeSearch: false }, options);\n    if (typeof opts.type !== \"string\" || ![\"video\", \"playlist\"].includes(opts.type)) {\n      throw new DisTubeError(\"INVALID_TYPE\", [\"video\", \"playlist\"], opts.type, \"options.type\");\n    }\n    if (typeof opts.limit !== \"number\") throw new DisTubeError(\"INVALID_TYPE\", \"number\", opts.limit, \"options.limit\");\n    if (opts.limit < 1) throw new DisTubeError(\"NUMBER_COMPARE\", \"option.limit\", \"bigger or equal to\", 1);\n    if (typeof opts.safeSearch !== \"boolean\") {\n      throw new DisTubeError(\"INVALID_TYPE\", \"boolean\", opts.safeSearch, \"options.safeSearch\");\n    }\n\n    try {\n      const search = await ytsr(string, opts);\n      const results = search.items.map(i => new SearchResult(i));\n      if (results.length === 0) throw new DisTubeError(\"NO_RESULT\");\n      return results;\n    } catch (e) {\n      if (options.retried) throw e;\n      options.retried = true;\n      return this.search(string, options);\n    }\n  }\n\n  /**\n   * Get the guild queue\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @returns {Queue?}\n   * @throws {Error}\n   * @example\n   * client.on('message', (message) => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if (command == \"queue\") {\n   *         const queue = distube.getQueue(message);\n   *         message.channel.send('Current queue:\\n' + queue.songs.map((song, id) =>\n   *             `**${id+1}**. [${song.name}](${song.url}) - \\`${song.formattedDuration}\\``\n   *         ).join(\"\\n\"));\n   *     }\n   * });\n   */\n  getQueue(queue: GuildIdResolvable): Queue | undefined {\n    return this.queues.get(queue);\n  }\n\n  /**\n   * Pause the guild stream\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @returns {Queue} The guild queue\n   * @throws {Error}\n   */\n  pause(queue: GuildIdResolvable): Queue {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.pause();\n  }\n\n  /**\n   * Resume the guild stream\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @returns {Queue} The guild queue\n   * @throws {Error}\n   */\n  resume(queue: GuildIdResolvable): Queue {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.resume();\n  }\n\n  /**\n   * Stop the guild stream\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @returns {Promise<void>}\n   * @throws {Error}\n   * @example\n   * client.on('message', (message) => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if (command == \"stop\") {\n   *         distube.stop(message);\n   *         message.channel.send(\"Stopped the queue!\");\n   *     }\n   * });\n   */\n  stop(queue: GuildIdResolvable): Promise<void> {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.stop();\n  }\n\n  /**\n   * Set the guild stream's volume\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @param {number} percent The percentage of volume you want to set\n   * @returns {Queue} The guild queue\n   * @throws {Error}\n   * @example\n   * client.on('message', (message) => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if (command == \"volume\")\n   *         distube.setVolume(message, Number(args[0]));\n   * });\n   */\n  setVolume(queue: GuildIdResolvable, percent: number): Queue {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.setVolume(percent);\n  }\n\n  /**\n   * Skip the playing song if there is a next song in the queue.\n   * <info>If {@link Queue#autoplay} is `true` and there is no up next song,\n   * DisTube will add and play a related song.</info>\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @returns {Promise<Song>} The new Song will be played\n   * @throws {Error}\n   * @example\n   * client.on('message', (message) => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if (command == \"skip\")\n   *         distube.skip(message);\n   * });\n   */\n  skip(queue: GuildIdResolvable): Promise<Song> {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.skip();\n  }\n\n  /**\n   * Play the previous song\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @returns {Promise<Song>} The new Song will be played\n   * @throws {Error}\n   * @example\n   * client.on('message', (message) => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if (command == \"previous\")\n   *         distube.previous(message);\n   * });\n   */\n  previous(queue: GuildIdResolvable): Promise<Song> {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.previous();\n  }\n\n  /**\n   * Shuffle the guild queue songs\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @returns {Promise<Queue>} The guild queue\n   * @example\n   * client.on('message', (message) => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if (command == \"shuffle\")\n   *         distube.shuffle(message);\n   * });\n   */\n  shuffle(queue: GuildIdResolvable): Promise<Queue> {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.shuffle();\n  }\n\n  /**\n   * Jump to the song number in the queue.\n   * The next one is 1, 2,...\n   * The previous one is -1, -2,...\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @param {number} num The song number to play\n   * @returns {Promise<Queue>} The guild queue\n   * @throws {Error} if `num` is invalid number (0 < num < {@link Queue#songs}.length)\n   * @example\n   * client.on('message', (message) => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if (command == \"jump\")\n   *         distube.jump(message, parseInt(args[0]))\n   *             .catch(err => message.channel.send(\"Invalid song number.\"));\n   * });\n   */\n  jump(queue: GuildIdResolvable, num: number): Promise<Queue> {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.jump(num);\n  }\n\n  /**\n   * Set the repeat mode of the guild queue.\\\n   * Toggle mode `(Disabled -> Song -> Queue -> Disabled ->...)` if `mode` is `undefined`\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @param {RepeatMode?} [mode] The repeat modes (toggle if `undefined`)\n   * @returns {RepeatMode} The new repeat mode\n   * @example\n   * client.on('message', (message) => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if (command == \"repeat\") {\n   *         let mode = distube.setRepeatMode(message, parseInt(args[0]));\n   *         mode = mode ? mode == 2 ? \"Repeat queue\" : \"Repeat song\" : \"Off\";\n   *         message.channel.send(\"Set repeat mode to `\" + mode + \"`\");\n   *     }\n   * });\n   * @example\n   * const { RepeatMode } = require(\"distube\");\n   * let mode;\n   * switch(distube.setRepeatMode(message, parseInt(args[0]))) {\n   *     case RepeatMode.DISABLED:\n   *         mode = \"Off\";\n   *         break;\n   *     case RepeatMode.SONG:\n   *         mode = \"Repeat a song\";\n   *         break;\n   *     case RepeatMode.QUEUE:\n   *         mode = \"Repeat all queue\";\n   *         break;\n   * }\n   * message.channel.send(\"Set repeat mode to `\" + mode + \"`\");\n   */\n  setRepeatMode(queue: GuildIdResolvable, mode?: number): number {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.setRepeatMode(mode);\n  }\n\n  /**\n   * Toggle autoplay mode\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @returns {boolean} Autoplay mode state\n   * @throws {Error}\n   * @example\n   * client.on('message', (message) => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if (command == \"autoplay\") {\n   *         const mode = distube.toggleAutoplay(message);\n   *         message.channel.send(\"Set autoplay mode to `\" + (mode ? \"On\" : \"Off\") + \"`\");\n   *     }\n   * });\n   */\n  toggleAutoplay(queue: GuildIdResolvable): boolean {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    q.autoplay = !q.autoplay;\n    return q.autoplay;\n  }\n\n  /**\n   * Add related song to the queue\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @returns {Promise<Song>} The guild queue\n   */\n  addRelatedSong(queue: GuildIdResolvable): Promise<Song> {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.addRelatedSong();\n  }\n\n  /**\n   * Enable or disable filter(s) of the queue.\n   * Available filters: {@link Filters}\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @param {string|false} filter A filter name, `false` to clear all the filters\n   * @param {boolean} [force=false] Force enable the input filter(s) even if it's enabled\n   * @returns {Array<string>} Enabled filters.\n   * @example\n   * client.on('message', (message) => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if ([`3d`, `bassboost`, `echo`, `karaoke`, `nightcore`, `vaporwave`].includes(command)) {\n   *         const filter = distube.setFilter(message, command);\n   *         message.channel.send(\"Current queue filter: \" + (filter.join(\", \") || \"Off\"));\n   *     }\n   * });\n   */\n  setFilter(queue: GuildIdResolvable, filter: string | false, force = false): Array<string> {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.setFilter(filter, force);\n  }\n\n  /**\n   * Set the playing time to another position\n   * @param {GuildIdResolvable} queue The type can be resolved to give a {@link Queue}\n   * @param {number} time Time in seconds\n   * @returns {Queue} Seeked queue\n   * @example\n   * client.on('message', message => {\n   *     if (!message.content.startsWith(config.prefix)) return;\n   *     const args = message.content.slice(config.prefix.length).trim().split(/ +/g);\n   *     const command = args.shift();\n   *     if (command = 'seek')\n   *         distube.seek(message, Number(args[0]));\n   * });\n   */\n  seek(queue: GuildIdResolvable, time: number): Queue {\n    const q = this.getQueue(queue);\n    if (!q) throw new DisTubeError(\"NO_QUEUE\");\n    return q.seek(time);\n  }\n\n  /* eslint-disable no-console */\n  /**\n   * Emit error event\n   * @param {Error} error error\n   * @param {Discord.BaseGuildTextChannel} [channel] Text channel where the error is encountered.\n   * @private\n   */\n  emitError(error: Error, channel?: GuildTextBasedChannel): void {\n    if (!channel || !isTextChannelInstance(channel)) {\n      console.error(error);\n      console.warn(\"This is logged because <Queue>.textChannel is undefined\");\n    } else if (this.listeners(\"error\").length) {\n      this.emit(\"error\", channel, error);\n    } else {\n      console.error(error);\n      console.warn(\"Unhandled 'error' event.\");\n      console.warn(\n        \"See: https://distube.js.org/#/docs/DisTube/stable/class/DisTube?scrollTo=e-error and https://nodejs.org/api/events.html#events_error_events\",\n      );\n    }\n  }\n  /* eslint-enable no-console */\n}\n\nexport default DisTube;\n\n/**\n * Emitted after DisTube add a new playlist to the playing {@link Queue}.\n *\n * @event DisTube#addList\n * @param {Queue} queue The guild queue\n * @param {Playlist} playlist Playlist info\n * @example\n * distube.on(\"addList\", (queue, playlist) => queue.textChannel.send(\n *     `Added \\`${playlist.name}\\` playlist (${playlist.songs.length} songs) to the queue!`\n * ));\n */\n\n/**\n * Emitted after DisTube add a new song to the playing {@link Queue}.\n *\n * @event DisTube#addSong\n * @param {Queue} queue The guild queue\n * @param {Song} song Added song\n * @example\n * distube.on(\"addSong\", (queue, song) => queue.textChannel.send(\n *     `Added ${song.name} - \\`${song.formattedDuration}\\` to the queue by ${song.user}.`\n * ));\n */\n\n/**\n * Emitted when there is no user in the voice channel,\n * {@link DisTubeOptions}.leaveOnEmpty is `true` and there is a playing queue.\n *\n * If there is no playing queue (stopped and {@link DisTubeOptions}.leaveOnStop is `false`),\n * it will leave the channel without emitting this event.\n * @event DisTube#empty\n * @param {Queue} queue The guild queue\n * @example\n * distube.on(\"empty\", queue => queue.textChannel.send(\"Channel is empty. Leaving the channel\"))\n */\n\n/**\n * Emitted when DisTube encounters an error.\n *\n * @event DisTube#error\n * @param {Discord.BaseGuildTextChannel} channel Text channel where the error is encountered.\n * @param {Error} error The error encountered\n * @example\n * distube.on(\"error\", (channel, error) => channel.send(\n *     \"An error encountered: \" + error\n * ));\n */\n\n/**\n * Emitted when there is no more song in the queue and {@link Queue#autoplay} is `false`.\n * DisTube will leave voice channel if {@link DisTubeOptions}.leaveOnFinish is `true`.\n *\n * @event DisTube#finish\n * @param {Queue} queue The guild queue\n * @example\n * distube.on(\"finish\", queue => queue.textChannel.send(\"No more song in queue\"));\n */\n\n/**\n * Emitted when DisTube initialize a queue to change queue default properties.\n *\n * @event DisTube#initQueue\n * @param {Queue} queue The guild queue\n * @example\n * distube.on(\"initQueue\", queue => {\n *     queue.autoplay = false;\n *     queue.volume = 100;\n * });\n */\n\n/**\n * Emitted when {@link Queue#autoplay} is `true`, {@link Queue#songs} is empty,\n * and DisTube cannot find related songs to play.\n *\n * @event DisTube#noRelated\n * @param {Queue} queue The guild queue\n * @example\n * distube.on(\"noRelated\", queue => queue.textChannel.send(\"Can't find related video to play.\"));\n */\n\n/**\n * Emitted when DisTube play a song.\n *\n * If {@link DisTubeOptions}.emitNewSongOnly is `true`,\n * this event is not emitted when looping a song or next song is the previous one.\n *\n * @event DisTube#playSong\n * @param {Queue} queue The guild queue\n * @param {Song} song Playing song\n * @example\n * distube.on(\"playSong\", (queue, song) => queue.textChannel.send(\n *     `Playing \\`${song.name}\\` - \\`${song.formattedDuration}\\`\\nRequested by: ${song.user}`\n * ));\n */\n\n/**\n * Emitted when DisTube cannot find any results for the query.\n *\n * @event DisTube#searchNoResult\n * @param {Discord.Message} message The user message called play method\n * @param {string} query The search query\n * @example\n * distube.on(\"searchNoResult\", (message, query) => message.channel.send(`No result found for ${query}!`));\n */\n\n/**\n * Emitted when {@link DisTubeOptions|DisTubeOptions.searchSongs} bigger than 0,\n * and song param of {@link DisTube#play} is invalid url.\n * DisTube will wait for user's next message to choose a song manually.\n * <info>{@link https://support.google.com/youtube/answer/7354993|Safe search} is enabled\n * if {@link DisTubeOptions}.nsfw is disabled and the message's channel is not a nsfw channel.</info>\n *\n * @event DisTube#searchResult\n * @param {Discord.Message} message The user message called play method\n * @param {Array<SearchResult>} results Searched results\n * @param {string} query The search query\n * @example\n * // DisTubeOptions.searchSongs > 0\n * distube.on(\"searchResult\", (message, results) => {\n *     message.channel.send(`**Choose an option from below**\\n${\n *         results.map((song, i) => `**${i + 1}**. ${song.name} - \\`${song.formattedDuration}\\``).join(\"\\n\")\n *     }\\n*Enter anything else or wait 60 seconds to cancel*`);\n * });\n */\n\n/**\n * Emitted when {@link DisTubeOptions|DisTubeOptions.searchSongs} bigger than 0,\n * and the search canceled due to {@link DisTubeOptions|DisTubeOptions.searchTimeout}.\n *\n * @event DisTube#searchCancel\n * @param {Discord.Message} message The user message called play method\n * @param {string} query The search query\n * @example\n * // DisTubeOptions.searchSongs > 0\n * distube.on(\"searchCancel\", (message) => message.channel.send(`Searching canceled`));\n */\n\n/**\n * Emitted when {@link DisTubeOptions|DisTubeOptions.searchSongs} bigger than 0,\n * and the search canceled due to user's next message is not a number or out of results range.\n *\n * @event DisTube#searchInvalidAnswer\n * @param {Discord.Message} message The user message called play method\n * @param {Discord.Message} answer The answered message of user\n * @param {string} query The search query\n * @example\n * // DisTubeOptions.searchSongs > 0\n * distube.on(\"searchInvalidAnswer\", (message) => message.channel.send(`You answered an invalid number!`));\n */\n\n/**\n * Emitted when {@link DisTubeOptions|DisTubeOptions.searchSongs} bigger than 0,\n * and after the user chose a search result to play.\n *\n * @event DisTube#searchDone\n * @param {Discord.Message} message The user message called play method\n * @param {Discord.Message} answer The answered message of user\n * @param {string} query The search query\n */\n\n/**\n * Emitted when the bot is disconnected to a voice channel.\n *\n * @event DisTube#disconnect\n * @param {Queue} queue The guild queue\n */\n\n/**\n * Emitted when a {@link Queue} is deleted with any reasons.\n *\n * @event DisTube#deleteQueue\n * @param {Queue} queue The guild queue\n */\n\n/**\n * Emitted when DisTube finished a song.\n *\n * @event DisTube#finishSong\n * @param {Queue} queue The guild queue\n * @param {Song} song Finished song\n */\n"]}

package/dist/constant.d.ts

@@ -68,12 +68,12 @@ export declare const defaultOptions: {
     emitAddListWhenCreatingQueue: boolean;
 };
 /**
- * Data that can be resolved to give a guild ID string. This can be:
- * - A guild ID string | a guild {@link https://discord.js.org/#/docs/main/stable/class/Snowflake|Snowflake}
+ * Data that can be resolved to give a guild id string. This can be:
+ * - A guild id string | a guild {@link https://discord.js.org/#/docs/main/stable/class/Snowflake|Snowflake}
  * - A {@link https://discord.js.org/#/docs/main/stable/class/Guild|Guild}
  * - A {@link https://discord.js.org/#/docs/main/stable/class/Message|Message}
- * - A {@link https://discord.js.org/#/docs/main/stable/class/VoiceBasedChannel|VoiceBasedChannel}
- * - A {@link https://discord.js.org/#/docs/main/stable/class/GuildTextBasedChannel|GuildTextBasedChannel}
+ * - A {@link https://discord.js.org/#/docs/main/stable/class/BaseGuildVoiceChannel|BaseGuildVoiceChannel}
+ * - A {@link https://discord.js.org/#/docs/main/stable/class/BaseGuildTextChannel|BaseGuildTextChannel}
  * - A {@link https://discord.js.org/#/docs/main/stable/class/VoiceState|VoiceState}
  * - A {@link https://discord.js.org/#/docs/main/stable/class/GuildMember|GuildMember}
  * - A {@link https://discord.js.org/#/docs/main/stable/class/Interaction|Interaction}

package/dist/constant.js

@@ -86,12 +86,12 @@ exports.defaultOptions = {
     emitAddListWhenCreatingQueue: true,
 };
 /**
- * Data that can be resolved to give a guild ID string. This can be:
- * - A guild ID string | a guild {@link https://discord.js.org/#/docs/main/stable/class/Snowflake|Snowflake}
+ * Data that can be resolved to give a guild id string. This can be:
+ * - A guild id string | a guild {@link https://discord.js.org/#/docs/main/stable/class/Snowflake|Snowflake}
  * - A {@link https://discord.js.org/#/docs/main/stable/class/Guild|Guild}
  * - A {@link https://discord.js.org/#/docs/main/stable/class/Message|Message}
- * - A {@link https://discord.js.org/#/docs/main/stable/class/VoiceBasedChannel|VoiceBasedChannel}
- * - A {@link https://discord.js.org/#/docs/main/stable/class/GuildTextBasedChannel|GuildTextBasedChannel}
+ * - A {@link https://discord.js.org/#/docs/main/stable/class/BaseGuildVoiceChannel|BaseGuildVoiceChannel}
+ * - A {@link https://discord.js.org/#/docs/main/stable/class/BaseGuildTextChannel|BaseGuildTextChannel}
  * - A {@link https://discord.js.org/#/docs/main/stable/class/VoiceState|VoiceState}
  * - A {@link https://discord.js.org/#/docs/main/stable/class/GuildMember|GuildMember}
  * - A {@link https://discord.js.org/#/docs/main/stable/class/Interaction|Interaction}

package/dist/constant.js.map

@@ -1 +1 @@
-{"version":3,"file":"constant.js","sourceRoot":"","sources":["../src/constant.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACU,QAAA,cAAc,GAAY;IACrC,IAAI,EAAE,oBAAoB;IAC1B,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,wBAAwB;IAC9B,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,sBAAsB;IAC/B,SAAS,EAAE,8CAA8C;IACzD,OAAO,EAAE,UAAU;IACnB,SAAS,EAAE,+CAA+C;IAC1D,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACU,QAAA,cAAc,GAAG;IAC5B,OAAO,EAAE,EAAE;IACX,eAAe,EAAE,KAAK;IACtB,YAAY,EAAE,IAAI;IAClB,aAAa,EAAE,KAAK;IACpB,WAAW,EAAE,IAAI;IACjB,iBAAiB,EAAE,IAAI;IACvB,SAAS,EAAE,IAAI;IACf,eAAe,EAAE,IAAI;IACrB,WAAW,EAAE,CAAC;IACd,aAAa,EAAE,EAAE;IACjB,WAAW,EAAE,EAAE;IACf,cAAc,EAAE,EAAE;IAClB,aAAa,EAAE,EAAE;IACjB,IAAI,EAAE,KAAK;IACX,4BAA4B,EAAE,IAAI;IAClC,4BAA4B,EAAE,IAAI;CACnC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH;;;;;;;;;;GAUG;AAEH;;;;;;GAMG;AACH,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,mDAAQ,CAAA;IACR,2CAAI,CAAA;IACJ,6CAAK,CAAA;AACP,CAAC,EAJW,UAAU,GAAV,kBAAU,KAAV,kBAAU,QAIrB;AAED;;;;;GAKG;AACH,IAAY,UAGX;AAHD,WAAY,UAAU;IACpB,+BAAiB,CAAA;IACjB,qCAAuB,CAAA;AACzB,CAAC,EAHW,UAAU,GAAV,kBAAU,KAAV,kBAAU,QAGrB","sourcesContent":["import type { Filters } from \".\";\n\n/**\n * Default DisTube audio filters.\n * @typedef {Object} defaultFilters\n * @prop {string} 3d 3d\n * @prop {string} bassboost bassboost\n * @prop {string} echo echo\n * @prop {string} karaoke karaoke\n * @prop {string} nightcore nightcore\n * @prop {string} vaporwave vaporwave\n * @prop {string} flanger flanger\n * @prop {string} gate gate\n * @prop {string} haas haas\n * @prop {string} reverse reverse\n * @prop {string} surround surround\n * @prop {string} mcompand mcompand\n * @prop {string} phaser phaser\n * @prop {string} tremolo tremolo\n * @prop {string} earwax earwax\n */\nexport const defaultFilters: Filters = {\n  \"3d\": \"apulsator=hz=0.125\",\n  bassboost: \"bass=g=10\",\n  echo: \"aecho=0.8:0.9:1000:0.3\",\n  flanger: \"flanger\",\n  gate: \"agate\",\n  haas: \"haas\",\n  karaoke: \"stereotools=mlev=0.1\",\n  nightcore: \"asetrate=48000*1.25,aresample=48000,bass=g=5\",\n  reverse: \"areverse\",\n  vaporwave: \"asetrate=48000*0.8,aresample=48000,atempo=1.1\",\n  mcompand: \"mcompand\",\n  phaser: \"aphaser\",\n  tremolo: \"tremolo\",\n  surround: \"surround\",\n  earwax: \"earwax\",\n};\n\n/**\n * DisTube options.\n * @typedef {Object} DisTubeOptions\n * @prop {Array<CustomPlugin|ExtractorPlugin>} [plugins] DisTube plugins.\n * @prop {boolean} [emitNewSongOnly=false] Whether or not emitting {@link DisTube#event:playSong} event\n * when looping a song or next song is the same as the previous one\n * @prop {boolean} [leaveOnEmpty=true] Whether or not leaving voice channel\n * if the voice channel is empty after {@link DisTubeOptions}.emptyCooldown seconds.\n * @prop {boolean} [leaveOnFinish=false] Whether or not leaving voice channel when the queue ends.\n * @prop {boolean} [leaveOnStop=true] Whether or not leaving voice channel after using {@link DisTube#stop} function.\n * @prop {boolean} [savePreviousSongs=true] Whether or not saving the previous songs of the queue\n * and enable {@link DisTube#previous} method\n * @prop {number} [searchSongs=0] Limit of search results emits in {@link DisTube#event:searchResult} event\n * when {@link DisTube#play} method executed. If `searchSongs <= 1`, play the first result\n * @prop {string} [youtubeCookie] YouTube cookies. Read how to get it in\n * {@link https://github.com/fent/node-ytdl-core/blob/997efdd5dd9063363f6ef668bb364e83970756e7/example/cookies.js#L6-L12|YTDL's Example}\n * @prop {string} [youtubeIdentityToken] If not given; ytdl-core will try to find it.\n * You can find this by going to a video's watch page; viewing the source; and searching for \"ID_TOKEN\".\n * @prop {boolean} [youtubeDL=true] Whether or not using youtube-dl.\n * @prop {boolean} [updateYouTubeDL=true] Whether or not updating youtube-dl automatically.\n * @prop {Filters} [customFilters] Override {@link defaultFilters} or add more ffmpeg filters.\n * Example=`{ \"Filter name\"=\"Filter value\"; \"8d\"=\"apulsator=hz=0.075\" }`\n * @prop {ytdl.getInfoOptions} [ytdlOptions] `ytdl-core` get info options\n * @prop {number} [searchCooldown=60] Built-in search cooldown in seconds (When searchSongs is bigger than 0)\n * @prop {number} [emptyCooldown=60] Built-in leave on empty cooldown in seconds (When leaveOnEmpty is true)\n * @prop {boolean} [nsfw=false] Whether or not playing age-restricted content\n * and disabling safe search in non-NSFW channel.\n * @prop {boolean} [emitAddListWhenCreatingQueue=true] Whether or not emitting `addList` event when creating a new Queue\n * @prop {boolean} [emitAddSongWhenCreatingQueue=true] Whether or not emitting `addSong` event when creating a new Queue\n */\nexport const defaultOptions = {\n  plugins: [],\n  emitNewSongOnly: false,\n  leaveOnEmpty: true,\n  leaveOnFinish: false,\n  leaveOnStop: true,\n  savePreviousSongs: true,\n  youtubeDL: true,\n  updateYouTubeDL: true,\n  searchSongs: 0,\n  customFilters: {},\n  ytdlOptions: {},\n  searchCooldown: 60,\n  emptyCooldown: 60,\n  nsfw: false,\n  emitAddSongWhenCreatingQueue: true,\n  emitAddListWhenCreatingQueue: true,\n};\n\n/**\n * Data that can be resolved to give a guild ID string. This can be:\n * - A guild ID string | a guild {@link https://discord.js.org/#/docs/main/stable/class/Snowflake|Snowflake}\n * - A {@link https://discord.js.org/#/docs/main/stable/class/Guild|Guild}\n * - A {@link https://discord.js.org/#/docs/main/stable/class/Message|Message}\n * - A {@link https://discord.js.org/#/docs/main/stable/class/VoiceBasedChannel|VoiceBasedChannel}\n * - A {@link https://discord.js.org/#/docs/main/stable/class/GuildTextBasedChannel|GuildTextBasedChannel}\n * - A {@link https://discord.js.org/#/docs/main/stable/class/VoiceState|VoiceState}\n * - A {@link https://discord.js.org/#/docs/main/stable/class/GuildMember|GuildMember}\n * - A {@link https://discord.js.org/#/docs/main/stable/class/Interaction|Interaction}\n * - A {@link DisTubeVoice}\n * - A {@link Queue}\n * @typedef {\n * Discord.Snowflake|\n * Discord.Guild|\n * Discord.Message|\n * Discord.BaseGuildVoiceChannel|\n * Discord.BaseGuildTextChannel|\n * Discord.VoiceState|\n * Discord.GuildMember|\n * Discord.Interaction|\n * DisTubeVoice|\n * Queue|\n * string\n * } GuildIdResolvable\n */\n/**\n * FFmpeg Filters\n * ```\n * {\n *   \"Filter Name\": \"Filter Value\",\n *   \"bassboost\":   \"bass=g=10\"\n * }\n * ```\n * @typedef {Object.<string, string>} Filters\n * @see {@link defaultFilters}\n */\n\n/**\n * The repeat mode of a {@link Queue} (enum)\n * * `DISABLED` = 0\n * * `SONG` = 1\n * * `QUEUE` = 2\n * @typedef {number} RepeatMode\n */\nexport enum RepeatMode {\n  DISABLED,\n  SONG,\n  QUEUE,\n}\n\n/**\n * All available plugin types:\n * * `custom`: {@link CustomPlugin}\n * * `extractor`: {@link ExtractorPlugin}\n * @typedef {\"custom\"|\"extractor\"} PluginType\n */\nexport enum PluginType {\n  CUSTOM = \"custom\",\n  EXTRACTOR = \"extractor\",\n}\n"]}
+{"version":3,"file":"constant.js","sourceRoot":"","sources":["../src/constant.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACU,QAAA,cAAc,GAAY;IACrC,IAAI,EAAE,oBAAoB;IAC1B,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,wBAAwB;IAC9B,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,sBAAsB;IAC/B,SAAS,EAAE,8CAA8C;IACzD,OAAO,EAAE,UAAU;IACnB,SAAS,EAAE,+CAA+C;IAC1D,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACU,QAAA,cAAc,GAAG;IAC5B,OAAO,EAAE,EAAE;IACX,eAAe,EAAE,KAAK;IACtB,YAAY,EAAE,IAAI;IAClB,aAAa,EAAE,KAAK;IACpB,WAAW,EAAE,IAAI;IACjB,iBAAiB,EAAE,IAAI;IACvB,SAAS,EAAE,IAAI;IACf,eAAe,EAAE,IAAI;IACrB,WAAW,EAAE,CAAC;IACd,aAAa,EAAE,EAAE;IACjB,WAAW,EAAE,EAAE;IACf,cAAc,EAAE,EAAE;IAClB,aAAa,EAAE,EAAE;IACjB,IAAI,EAAE,KAAK;IACX,4BAA4B,EAAE,IAAI;IAClC,4BAA4B,EAAE,IAAI;CACnC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH;;;;;;;;;;GAUG;AAEH;;;;;;GAMG;AACH,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,mDAAQ,CAAA;IACR,2CAAI,CAAA;IACJ,6CAAK,CAAA;AACP,CAAC,EAJW,UAAU,GAAV,kBAAU,KAAV,kBAAU,QAIrB;AAED;;;;;GAKG;AACH,IAAY,UAGX;AAHD,WAAY,UAAU;IACpB,+BAAiB,CAAA;IACjB,qCAAuB,CAAA;AACzB,CAAC,EAHW,UAAU,GAAV,kBAAU,KAAV,kBAAU,QAGrB","sourcesContent":["import type { Filters } from \".\";\n\n/**\n * Default DisTube audio filters.\n * @typedef {Object} defaultFilters\n * @prop {string} 3d 3d\n * @prop {string} bassboost bassboost\n * @prop {string} echo echo\n * @prop {string} karaoke karaoke\n * @prop {string} nightcore nightcore\n * @prop {string} vaporwave vaporwave\n * @prop {string} flanger flanger\n * @prop {string} gate gate\n * @prop {string} haas haas\n * @prop {string} reverse reverse\n * @prop {string} surround surround\n * @prop {string} mcompand mcompand\n * @prop {string} phaser phaser\n * @prop {string} tremolo tremolo\n * @prop {string} earwax earwax\n */\nexport const defaultFilters: Filters = {\n  \"3d\": \"apulsator=hz=0.125\",\n  bassboost: \"bass=g=10\",\n  echo: \"aecho=0.8:0.9:1000:0.3\",\n  flanger: \"flanger\",\n  gate: \"agate\",\n  haas: \"haas\",\n  karaoke: \"stereotools=mlev=0.1\",\n  nightcore: \"asetrate=48000*1.25,aresample=48000,bass=g=5\",\n  reverse: \"areverse\",\n  vaporwave: \"asetrate=48000*0.8,aresample=48000,atempo=1.1\",\n  mcompand: \"mcompand\",\n  phaser: \"aphaser\",\n  tremolo: \"tremolo\",\n  surround: \"surround\",\n  earwax: \"earwax\",\n};\n\n/**\n * DisTube options.\n * @typedef {Object} DisTubeOptions\n * @prop {Array<CustomPlugin|ExtractorPlugin>} [plugins] DisTube plugins.\n * @prop {boolean} [emitNewSongOnly=false] Whether or not emitting {@link DisTube#event:playSong} event\n * when looping a song or next song is the same as the previous one\n * @prop {boolean} [leaveOnEmpty=true] Whether or not leaving voice channel\n * if the voice channel is empty after {@link DisTubeOptions}.emptyCooldown seconds.\n * @prop {boolean} [leaveOnFinish=false] Whether or not leaving voice channel when the queue ends.\n * @prop {boolean} [leaveOnStop=true] Whether or not leaving voice channel after using {@link DisTube#stop} function.\n * @prop {boolean} [savePreviousSongs=true] Whether or not saving the previous songs of the queue\n * and enable {@link DisTube#previous} method\n * @prop {number} [searchSongs=0] Limit of search results emits in {@link DisTube#event:searchResult} event\n * when {@link DisTube#play} method executed. If `searchSongs <= 1`, play the first result\n * @prop {string} [youtubeCookie] YouTube cookies. Read how to get it in\n * {@link https://github.com/fent/node-ytdl-core/blob/997efdd5dd9063363f6ef668bb364e83970756e7/example/cookies.js#L6-L12|YTDL's Example}\n * @prop {string} [youtubeIdentityToken] If not given; ytdl-core will try to find it.\n * You can find this by going to a video's watch page; viewing the source; and searching for \"ID_TOKEN\".\n * @prop {boolean} [youtubeDL=true] Whether or not using youtube-dl.\n * @prop {boolean} [updateYouTubeDL=true] Whether or not updating youtube-dl automatically.\n * @prop {Filters} [customFilters] Override {@link defaultFilters} or add more ffmpeg filters.\n * Example=`{ \"Filter name\"=\"Filter value\"; \"8d\"=\"apulsator=hz=0.075\" }`\n * @prop {ytdl.getInfoOptions} [ytdlOptions] `ytdl-core` get info options\n * @prop {number} [searchCooldown=60] Built-in search cooldown in seconds (When searchSongs is bigger than 0)\n * @prop {number} [emptyCooldown=60] Built-in leave on empty cooldown in seconds (When leaveOnEmpty is true)\n * @prop {boolean} [nsfw=false] Whether or not playing age-restricted content\n * and disabling safe search in non-NSFW channel.\n * @prop {boolean} [emitAddListWhenCreatingQueue=true] Whether or not emitting `addList` event when creating a new Queue\n * @prop {boolean} [emitAddSongWhenCreatingQueue=true] Whether or not emitting `addSong` event when creating a new Queue\n */\nexport const defaultOptions = {\n  plugins: [],\n  emitNewSongOnly: false,\n  leaveOnEmpty: true,\n  leaveOnFinish: false,\n  leaveOnStop: true,\n  savePreviousSongs: true,\n  youtubeDL: true,\n  updateYouTubeDL: true,\n  searchSongs: 0,\n  customFilters: {},\n  ytdlOptions: {},\n  searchCooldown: 60,\n  emptyCooldown: 60,\n  nsfw: false,\n  emitAddSongWhenCreatingQueue: true,\n  emitAddListWhenCreatingQueue: true,\n};\n\n/**\n * Data that can be resolved to give a guild id string. This can be:\n * - A guild id string | a guild {@link https://discord.js.org/#/docs/main/stable/class/Snowflake|Snowflake}\n * - A {@link https://discord.js.org/#/docs/main/stable/class/Guild|Guild}\n * - A {@link https://discord.js.org/#/docs/main/stable/class/Message|Message}\n * - A {@link https://discord.js.org/#/docs/main/stable/class/BaseGuildVoiceChannel|BaseGuildVoiceChannel}\n * - A {@link https://discord.js.org/#/docs/main/stable/class/BaseGuildTextChannel|BaseGuildTextChannel}\n * - A {@link https://discord.js.org/#/docs/main/stable/class/VoiceState|VoiceState}\n * - A {@link https://discord.js.org/#/docs/main/stable/class/GuildMember|GuildMember}\n * - A {@link https://discord.js.org/#/docs/main/stable/class/Interaction|Interaction}\n * - A {@link DisTubeVoice}\n * - A {@link Queue}\n * @typedef {\n * Discord.Snowflake|\n * Discord.Guild|\n * Discord.Message|\n * Discord.BaseGuildVoiceChannel|\n * Discord.BaseGuildTextChannel|\n * Discord.VoiceState|\n * Discord.GuildMember|\n * Discord.Interaction|\n * DisTubeVoice|\n * Queue|\n * string\n * } GuildIdResolvable\n */\n/**\n * FFmpeg Filters\n * ```\n * {\n *   \"Filter Name\": \"Filter Value\",\n *   \"bassboost\":   \"bass=g=10\"\n * }\n * ```\n * @typedef {Object.<string, string>} Filters\n * @see {@link defaultFilters}\n */\n\n/**\n * The repeat mode of a {@link Queue} (enum)\n * * `DISABLED` = 0\n * * `SONG` = 1\n * * `QUEUE` = 2\n * @typedef {number} RepeatMode\n */\nexport enum RepeatMode {\n  DISABLED,\n  SONG,\n  QUEUE,\n}\n\n/**\n * All available plugin types:\n * * `custom`: {@link CustomPlugin}\n * * `extractor`: {@link ExtractorPlugin}\n * @typedef {\"custom\"|\"extractor\"} PluginType\n */\nexport enum PluginType {\n  CUSTOM = \"custom\",\n  EXTRACTOR = \"extractor\",\n}\n"]}

package/dist/core/DisTubeHandler.d.ts

@@ -77,6 +77,13 @@ export declare class DisTubeHandler extends DisTubeBase {
     handlePlaylist(voice: VoiceBasedChannel, playlist: Playlist, options?: {
         textChannel?: GuildTextBasedChannel;
         skip?: boolean;
+        position?: number;
+    }): Promise<void>;
+    /** @deprecated `options.unshift` is deprecated, use `options.position` instead */
+    handlePlaylist(voice: VoiceBasedChannel, playlist: Playlist, options?: {
+        textChannel?: GuildTextBasedChannel;
+        skip?: boolean;
+        position?: number;
         unshift?: boolean;
     }): Promise<void>;
     /**

package/dist/core/DisTubeHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DisTubeHandler.d.ts","sourceRoot":"","sources":["../../src/core/DisTubeHandler.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,oBAAoB,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,GAAG,CAAC;AAC/C,OAAO,EAEL,QAAQ,EACR,KAAK,EACL,YAAY,EACZ,IAAI,EAKL,MAAM,IAAI,CAAC;AACZ,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,OAAO,EAAe,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC9G;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C,WAAW,EAAE,IAAI,CAAC,eAAe,CAAC;gBACtB,OAAO,EAAE,OAAO;IA+C5B;;;;;;;;OAQG;IACG,WAAW,CACf,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,iBAAiB,EAC1C,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,EACnB,WAAW,CAAC,EAAE,qBAAqB,GAClC,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAiBxB;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;IAKnE;;;;;;;OAOG;IACG,WAAW,CACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,QAAQ,GAAG,YAAY,GAAG,aAAa,GAAG,IAAI,CAAC,YAAY,GAAG,IAAI,EACzG,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,QAAQ,CAAC,EAAE,GAAG,CAAC;KACX,GACL,OAAO,CAAC,IAAI,GAAG,QAAQ,GAAG,IAAI,CAAC;IAsBlC;;;;;;;;OAQG;IACG,eAAe,CACnB,QAAQ,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,MAAM,EACpC,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,GAAG,CAAC;KACX,GACL,OAAO,CAAC,QAAQ,CAAC;IAmBpB;;;;;;;;;OASG;IACG,oBAAoB,CACxB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,WAAW,EACpC,KAAK,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,YAAY,CAAC,EAAE,EACvC,UAAU,GAAE,GAAQ,EACpB,QAAQ,UAAO,EACf,QAAQ,CAAC,EAAE,GAAG,GACb,OAAO,CAAC,QAAQ,CAAC;IAapB;;;;;;;;;OASG;IACG,cAAc,CAClB,KAAK,EAAE,iBAAiB,EACxB,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE;QACP,WAAW,CAAC,EAAE,qBAAqB,CAAC;QACpC,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;KACd,GACL,OAAO,CAAC,IAAI,CAAC;IAyBhB;;;;;OAKG;IACG,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAqBrF;;;;;;;;;OASG;IACG,4BAA4B,CAAC,CAAC,SAAS,YAAY,GAAG,IAAI,GAAG,QAAQ,EACzE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,EACtB,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IA6DpB;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,aAAa;CAW1C"}
+{"version":3,"file":"DisTubeHandler.d.ts","sourceRoot":"","sources":["../../src/core/DisTubeHandler.ts"],"names":[],"mappings":"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"}