distube 3.0.0-beta.35 → 3.0.0-beta.39

package/dist/plugin/youtube-dl.js.map

@@ -1 +1 @@
-{"version":3,"file":"youtube-dl.js","sourceRoot":"","sources":["../../src/plugin/youtube-dl.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAAA,kEAA8D;AAC9D,gFAAwD;AACxD,sCAA2C;AAK3C,MAAa,eAAgB,SAAQ,yBAAe;IAClD,YAAY,eAAe,GAAG,IAAI;QAChC,KAAK,EAAE,CAAC;QACR,IAAI,eAAe,EAAE;YACnB,+BAA+B;YAC/B,qBAAQ,EAAE;iBACP,IAAI,CAAC,CAAC,OAAY,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,mCAAmC,OAAO,GAAG,CAAC,CAAC;iBAClF,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;iBACpB,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC,CAAC;YAC9F,8BAA8B;SAC/B;IACH,CAAC;IACD,4DAA4D;IAC5D,KAAK,CAAC,QAAQ;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,MAAmB;QAC5C,MAAM,IAAI,GAAQ,MAAM,oBAAa,CAAC,GAAG,EAAE;YACzC,cAAc,EAAE,IAAI;YACpB,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,IAAI;YAChB,iBAAiB,EAAE,IAAI;SACxB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;YACX,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QACH,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE;YAC1D,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAA6B,EAAE,EAAE,CAAC,IAAI,aAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;YACnG,OAAO,IAAI,iBAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;SACnC;QACD,OAAO,IAAI,aAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC;IACD,KAAK,CAAC,YAAY,CAAC,GAAW;QAC5B,MAAM,IAAI,GAAG,MAAM,oBAAa,CAAC,GAAG,EAAE;YACpC,cAAc,EAAE,IAAI;YACpB,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,IAAI;YAChB,iBAAiB,EAAE,IAAI;SACxB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;YACX,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;CACF;AA3CD,0CA2CC;AAED,kBAAe,eAAe,CAAC","sourcesContent":["import youtubeDlExec, { download } from \"@distube/youtube-dl\";\nimport ExtractorPlugin from \"../struct/ExtractorPlugin\";\nimport { Playlist, Song } from \"../struct\";\nimport type { OtherSongInfo } from \"../type\";\nimport type { GuildMember } from \"discord.js\";\nimport type { YtResponse } from \"@distube/youtube-dl\";\n\nexport class YouTubeDLPlugin extends ExtractorPlugin {\n  constructor(updateYouTubeDL = true) {\n    super();\n    if (updateYouTubeDL) {\n      /* eslint-disable no-console */\n      download()\n        .then((version: any) => console.log(`[DisTube] Updated youtube-dl to ${version}!`))\n        .catch(console.error)\n        .catch(() => console.warn(\"[DisTube] Unable to update youtube-dl, using default version.\"));\n      /* eslint-enable no-console */\n    }\n  }\n  // eslint-disable-next-line @typescript-eslint/require-await\n  async validate() {\n    return true;\n  }\n  async resolve(url: string, member: GuildMember) {\n    const info: any = await youtubeDlExec(url, {\n      dumpSingleJson: true,\n      noWarnings: true,\n      noCallHome: true,\n      preferFreeFormats: true,\n    }).catch(e => {\n      throw new Error(`[youtube-dl] ${e.stderr || e}`);\n    });\n    if (Array.isArray(info.entries) && info.entries.length > 0) {\n      info.source = info.extractor.match(/\\w+/)[0];\n      info.songs = info.entries.map((i: OtherSongInfo & YtResponse) => new Song(i, member, i.extractor));\n      return new Playlist(info, member);\n    }\n    return new Song(info, member, info.extractor);\n  }\n  async getStreamURL(url: string) {\n    const info = await youtubeDlExec(url, {\n      dumpSingleJson: true,\n      noWarnings: true,\n      noCallHome: true,\n      preferFreeFormats: true,\n    }).catch(e => {\n      throw new Error(`[youtube-dl] ${e.stderr || e}`);\n    });\n    return info.url;\n  }\n}\n\nexport default YouTubeDLPlugin;\n"]}
+{"version":3,"file":"youtube-dl.js","sourceRoot":"","sources":["../../src/plugin/youtube-dl.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAAA,kEAA8D;AAC9D,gFAAwD;AACxD,sCAA2C;AAK3C,MAAa,eAAgB,SAAQ,yBAAe;IAClD,YAAY,eAAe,GAAG,IAAI;QAChC,KAAK,EAAE,CAAC;QACR,IAAI,eAAe,EAAE;YACnB,+BAA+B;YAC/B,IAAA,qBAAQ,GAAE;iBACP,IAAI,CAAC,CAAC,OAAY,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,mCAAmC,OAAO,GAAG,CAAC,CAAC;iBAClF,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;iBACpB,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC,CAAC;YAC9F,8BAA8B;SAC/B;IACH,CAAC;IACD,4DAA4D;IAC5D,KAAK,CAAC,QAAQ;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,MAAmB;QAC5C,MAAM,IAAI,GAAQ,MAAM,IAAA,oBAAa,EAAC,GAAG,EAAE;YACzC,cAAc,EAAE,IAAI;YACpB,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,IAAI;YAChB,iBAAiB,EAAE,IAAI;SACxB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;YACX,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QACH,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE;YAC1D,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAA6B,EAAE,EAAE,CAAC,IAAI,aAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;YACnG,OAAO,IAAI,iBAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;SACnC;QACD,OAAO,IAAI,aAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC;IACD,KAAK,CAAC,YAAY,CAAC,GAAW;QAC5B,MAAM,IAAI,GAAG,MAAM,IAAA,oBAAa,EAAC,GAAG,EAAE;YACpC,cAAc,EAAE,IAAI;YACpB,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,IAAI;YAChB,iBAAiB,EAAE,IAAI;SACxB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;YACX,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;CACF;AA3CD,0CA2CC;AAED,kBAAe,eAAe,CAAC","sourcesContent":["import youtubeDlExec, { download } from \"@distube/youtube-dl\";\nimport ExtractorPlugin from \"../struct/ExtractorPlugin\";\nimport { Playlist, Song } from \"../struct\";\nimport type { OtherSongInfo } from \"..\";\nimport type { GuildMember } from \"discord.js\";\nimport type { YtResponse } from \"@distube/youtube-dl\";\n\nexport class YouTubeDLPlugin extends ExtractorPlugin {\n  constructor(updateYouTubeDL = true) {\n    super();\n    if (updateYouTubeDL) {\n      /* eslint-disable no-console */\n      download()\n        .then((version: any) => console.log(`[DisTube] Updated youtube-dl to ${version}!`))\n        .catch(console.error)\n        .catch(() => console.warn(\"[DisTube] Unable to update youtube-dl, using default version.\"));\n      /* eslint-enable no-console */\n    }\n  }\n  // eslint-disable-next-line @typescript-eslint/require-await\n  async validate() {\n    return true;\n  }\n  async resolve(url: string, member: GuildMember) {\n    const info: any = await youtubeDlExec(url, {\n      dumpSingleJson: true,\n      noWarnings: true,\n      noCallHome: true,\n      preferFreeFormats: true,\n    }).catch(e => {\n      throw new Error(`[youtube-dl] ${e.stderr || e}`);\n    });\n    if (Array.isArray(info.entries) && info.entries.length > 0) {\n      info.source = info.extractor.match(/\\w+/)[0];\n      info.songs = info.entries.map((i: OtherSongInfo & YtResponse) => new Song(i, member, i.extractor));\n      return new Playlist(info, member);\n    }\n    return new Song(info, member, info.extractor);\n  }\n  async getStreamURL(url: string) {\n    const info = await youtubeDlExec(url, {\n      dumpSingleJson: true,\n      noWarnings: true,\n      noCallHome: true,\n      preferFreeFormats: true,\n    }).catch(e => {\n      throw new Error(`[youtube-dl] ${e.stderr || e}`);\n    });\n    return info.url;\n  }\n}\n\nexport default YouTubeDLPlugin;\n"]}

package/dist/struct/CustomPlugin.d.ts

@@ -3,21 +3,24 @@ import type { GuildMember, StageChannel, TextChannel, VoiceChannel } from "disco
 /**
  * Custom Plugin
  * @extends Plugin
+ * @abstract
  */
-export declare class CustomPlugin extends Plugin {
-    /** Create a custom plugin */
-    constructor();
-    /**
-     * Execute if the url is validated
-     * @param {Discord.VoiceChannel|Discord.StageChannel} voiceChannel The voice channel will be joined
-     * @param {string} url Validated url
-     * @param {Discord.GuildMember} member Requested user
-     * @param {Discord.TextChannel?} textChannel Default {@link Queue#textChannel}
-     * @param {boolean} skip Skip the playing song (if exists) and play the added song/playlist instantly
-     * @param {boolean} unshift Add the song/playlist to the beginning of the queue (after the playing song if exists)
-     * @returns {Promise<void>}
-     */
-    play(voiceChannel: VoiceChannel | StageChannel, url: string, member: GuildMember, textChannel: TextChannel | undefined, skip: boolean, unshift: boolean): Promise<void>;
+export declare abstract class CustomPlugin extends Plugin {
+    type: "custom";
+    abstract play(voiceChannel: VoiceChannel | StageChannel, url: string, member: GuildMember, textChannel: TextChannel | undefined, skip: boolean, unshift: boolean): Promise<void>;
 }
+/**
+ * This method will be executed if the url is validated.
+ * @param {Discord.VoiceChannel|Discord.StageChannel} voiceChannel The voice channel will be joined
+ * @param {string} url Validated url
+ * @param {Discord.GuildMember} member Requested user
+ * @param {Discord.TextChannel?} textChannel Default {@link Queue#textChannel}
+ * @param {boolean} skip Skip the playing song (if exists) and play the added song/playlist instantly
+ * @param {boolean} unshift Add the song/playlist to the beginning of the queue (after the playing song if exists)
+ * @returns {Promise<void>}
+ * @method play
+ * @memberof CustomPlugin#
+ * @abstract
+ */
 export default CustomPlugin;
 //# sourceMappingURL=CustomPlugin.d.ts.map

package/dist/struct/CustomPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CustomPlugin.d.ts","sourceRoot":"","sources":["../../src/struct/CustomPlugin.ts"],"names":[],"mappings":"AACA,OAAO,MAAM,MAAM,UAAU,CAAC;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEvF;;;GAGG;AACH,qBAAa,YAAa,SAAQ,MAAM;IACtC,6BAA6B;;IAI7B;;;;;;;;;OASG;IACG,IAAI,CACR,YAAY,EAAE,YAAY,GAAG,YAAY,EACzC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC;CAGjB;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"CustomPlugin.d.ts","sourceRoot":"","sources":["../../src/struct/CustomPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,UAAU,CAAC;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEvF;;;;GAIG;AACH,8BAAsB,YAAa,SAAQ,MAAM;IAC/C,IAAI,WAAqB;IACzB,QAAQ,CAAC,IAAI,CACX,YAAY,EAAE,YAAY,GAAG,YAAY,EACzC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AAEH,eAAe,YAAY,CAAC"}

package/dist/struct/CustomPlugin.js

@@ -4,31 +4,31 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CustomPlugin = void 0;
-/* eslint-disable @typescript-eslint/no-unused-vars */
 const Plugin_1 = __importDefault(require("./Plugin"));
 /**
  * Custom Plugin
  * @extends Plugin
+ * @abstract
  */
 class CustomPlugin extends Plugin_1.default {
-    /** Create a custom plugin */
     constructor() {
-        super("custom");
-    }
-    /**
-     * Execute if the url is validated
-     * @param {Discord.VoiceChannel|Discord.StageChannel} voiceChannel The voice channel will be joined
-     * @param {string} url Validated url
-     * @param {Discord.GuildMember} member Requested user
-     * @param {Discord.TextChannel?} textChannel Default {@link Queue#textChannel}
-     * @param {boolean} skip Skip the playing song (if exists) and play the added song/playlist instantly
-     * @param {boolean} unshift Add the song/playlist to the beginning of the queue (after the playing song if exists)
-     * @returns {Promise<void>}
-     */
-    async play(voiceChannel, url, member, textChannel, skip, unshift) {
-        // Template
+        super(...arguments);
+        this.type = "custom";
     }
 }
 exports.CustomPlugin = CustomPlugin;
+/**
+ * This method will be executed if the url is validated.
+ * @param {Discord.VoiceChannel|Discord.StageChannel} voiceChannel The voice channel will be joined
+ * @param {string} url Validated url
+ * @param {Discord.GuildMember} member Requested user
+ * @param {Discord.TextChannel?} textChannel Default {@link Queue#textChannel}
+ * @param {boolean} skip Skip the playing song (if exists) and play the added song/playlist instantly
+ * @param {boolean} unshift Add the song/playlist to the beginning of the queue (after the playing song if exists)
+ * @returns {Promise<void>}
+ * @method play
+ * @memberof CustomPlugin#
+ * @abstract
+ */
 exports.default = CustomPlugin;
 //# sourceMappingURL=CustomPlugin.js.map

package/dist/struct/CustomPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"CustomPlugin.js","sourceRoot":"","sources":["../../src/struct/CustomPlugin.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAsD;AACtD,sDAA8B;AAG9B;;;GAGG;AACH,MAAa,YAAa,SAAQ,gBAAM;IACtC,6BAA6B;IAC7B;QACE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAClB,CAAC;IACD;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,CACR,YAAyC,EACzC,GAAW,EACX,MAAmB,EACnB,WAAoC,EACpC,IAAa,EACb,OAAgB;QAEhB,WAAW;IACb,CAAC;CACF;AAzBD,oCAyBC;AAED,kBAAe,YAAY,CAAC","sourcesContent":["/* eslint-disable @typescript-eslint/no-unused-vars */\nimport Plugin from \"./Plugin\";\nimport type { GuildMember, StageChannel, TextChannel, VoiceChannel } from \"discord.js\";\n\n/**\n * Custom Plugin\n * @extends Plugin\n */\nexport class CustomPlugin extends Plugin {\n  /** Create a custom plugin */\n  constructor() {\n    super(\"custom\");\n  }\n  /**\n   * Execute if the url is validated\n   * @param {Discord.VoiceChannel|Discord.StageChannel} voiceChannel The voice channel will be joined\n   * @param {string} url Validated url\n   * @param {Discord.GuildMember} member Requested user\n   * @param {Discord.TextChannel?} textChannel Default {@link Queue#textChannel}\n   * @param {boolean} skip Skip the playing song (if exists) and play the added song/playlist instantly\n   * @param {boolean} unshift Add the song/playlist to the beginning of the queue (after the playing song if exists)\n   * @returns {Promise<void>}\n   */\n  async play(\n    voiceChannel: VoiceChannel | StageChannel,\n    url: string,\n    member: GuildMember,\n    textChannel: TextChannel | undefined,\n    skip: boolean,\n    unshift: boolean,\n  ): Promise<void> {\n    // Template\n  }\n}\n\nexport default CustomPlugin;\n"]}
+{"version":3,"file":"CustomPlugin.js","sourceRoot":"","sources":["../../src/struct/CustomPlugin.ts"],"names":[],"mappings":";;;;;;AAAA,sDAA8B;AAG9B;;;;GAIG;AACH,MAAsB,YAAa,SAAQ,gBAAM;IAAjD;;QACE,SAAI,GAAG,QAAiB,CAAC;IAS3B,CAAC;CAAA;AAVD,oCAUC;AAED;;;;;;;;;;;;GAYG;AAEH,kBAAe,YAAY,CAAC","sourcesContent":["import Plugin from \"./Plugin\";\nimport type { GuildMember, StageChannel, TextChannel, VoiceChannel } from \"discord.js\";\n\n/**\n * Custom Plugin\n * @extends Plugin\n * @abstract\n */\nexport abstract class CustomPlugin extends Plugin {\n  type = \"custom\" as const;\n  abstract play(\n    voiceChannel: VoiceChannel | StageChannel,\n    url: string,\n    member: GuildMember,\n    textChannel: TextChannel | undefined,\n    skip: boolean,\n    unshift: boolean,\n  ): Promise<void>;\n}\n\n/**\n * This method will be executed if the url is validated.\n * @param {Discord.VoiceChannel|Discord.StageChannel} voiceChannel The voice channel will be joined\n * @param {string} url Validated url\n * @param {Discord.GuildMember} member Requested user\n * @param {Discord.TextChannel?} textChannel Default {@link Queue#textChannel}\n * @param {boolean} skip Skip the playing song (if exists) and play the added song/playlist instantly\n * @param {boolean} unshift Add the song/playlist to the beginning of the queue (after the playing song if exists)\n * @returns {Promise<void>}\n * @method play\n * @memberof CustomPlugin#\n * @abstract\n */\n\nexport default CustomPlugin;\n"]}

package/dist/struct/DisTubeError.d.ts

@@ -1,5 +1,5 @@
 declare const ERROR_MESSAGES: {
-    INVALID_TYPE: (expected: string | string[], got: any, name?: string | undefined) => string;
+    INVALID_TYPE: (expected: (number | string) | readonly (number | string)[], got: any, name?: string | undefined) => string;
     NUMBER_COMPARE: (name: string, expected: string, value: number) => string;
     EMPTY_ARRAY: (name: string) => string;
     EMPTY_FILTERED_ARRAY: (name: string, type: string) => string;
@@ -35,9 +35,18 @@ declare const ERROR_MESSAGES: {
     EMPTY_FILTERED_PLAYLIST: string;
     EMPTY_PLAYLIST: string;
 };
-export declare class DisTubeError extends Error {
+declare type ErrorMessages = typeof ERROR_MESSAGES;
+declare type ErrorCodes = keyof ErrorMessages;
+declare type ErrorCode = {
+    [K in ErrorCodes]-?: ErrorMessages[K] extends string ? K : never;
+}[ErrorCodes];
+declare type ErrorCodeTemplate = Exclude<keyof typeof ERROR_MESSAGES, ErrorCode>;
+export declare class DisTubeError<T extends string> extends Error {
     errorCode: string;
-    constructor(code: keyof typeof ERROR_MESSAGES, ...args: any);
+    constructor(code: ErrorCode);
+    constructor(code: T extends ErrorCodeTemplate ? T : never, ...args: Parameters<ErrorMessages[typeof code]>);
+    constructor(code: ErrorCodeTemplate, _: never);
+    constructor(code: T extends ErrorCodes ? "This is built-in error code" : T, message: string);
     get name(): string;
     get code(): string;
 }

package/dist/struct/DisTubeError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DisTubeError.d.ts","sourceRoot":"","sources":["../../src/struct/DisTubeError.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,cAAc;6BACO,MAAM,GAAG,MAAM,EAAE,OAAO,GAAG;2BAY7B,MAAM,YAAY,MAAM,SAAS,MAAM;wBAC1C,MAAM;iCACG,MAAM,QAAQ,MAAM;uBAC9B,MAAM,OAAO,MAAM;yBAEjB,MAAM;yBACN,MAAM;wBACP,MAAM;;;;8BAKA,MAAM;;;;;;;;;;;;;;;;;;;;6BAsBP,MAAM;;;;CAKhC,CAAC;AAOF,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAS,EAAE,MAAM,CAAC;gBACN,IAAI,EAAE,MAAM,OAAO,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG;IAQ3D,IAAI,IAAI,WAEP;IAED,IAAI,IAAI,WAEP;CACF;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"DisTubeError.d.ts","sourceRoot":"","sources":["../../src/struct/DisTubeError.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,cAAc;6BACO,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,OAAO,GAAG;2BAY5D,MAAM,YAAY,MAAM,SAAS,MAAM;wBAC1C,MAAM;iCACG,MAAM,QAAQ,MAAM;uBAC9B,MAAM,OAAO,MAAM;yBAEjB,MAAM;yBACN,MAAM;wBACP,MAAM;;;;8BAKA,MAAM;;;;;;;;;;;;;;;;;;;;6BAsBP,MAAM;;;;CAMhC,CAAC;AAEF,aAAK,aAAa,GAAG,OAAO,cAAc,CAAC;AAC3C,aAAK,UAAU,GAAG,MAAM,aAAa,CAAC;AACtC,aAAK,SAAS,GAAG;KAAG,CAAC,IAAI,UAAU,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,CAAC,GAAG,KAAK;CAAE,CAAC,UAAU,CAAC,CAAC;AAClG,aAAK,iBAAiB,GAAG,OAAO,CAAC,MAAM,OAAO,cAAc,EAAE,SAAS,CAAC,CAAC;AAMzE,qBAAa,YAAY,CAAC,CAAC,SAAS,MAAM,CAAE,SAAQ,KAAK;IACvD,SAAS,EAAE,MAAM,CAAC;gBACN,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,CAAC,SAAS,iBAAiB,GAAG,CAAC,GAAG,KAAK,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,CAAC;gBAC9F,IAAI,EAAE,iBAAiB,EAAE,CAAC,EAAE,KAAK;gBACjC,IAAI,EAAE,CAAC,SAAS,UAAU,GAAG,6BAA6B,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM;IAS3F,IAAI,IAAI,WAEP;IAED,IAAI,IAAI,WAEP;CACF;AAED,eAAe,YAAY,CAAC"}

package/dist/struct/DisTubeError.js

@@ -10,12 +10,12 @@ const ERROR_MESSAGES = {
                 ? got
                 : Array.isArray(got)
                     ? `Array<${got.length}>`
-                    : ((_a = got === null || got === void 0 ? void 0 : got.constructor) === null || _a === void 0 ? void 0 : _a.name) || typeof got}`;
+                    : ((_a = got === null || got === void 0 ? void 0 : got.constructor) === null || _a === void 0 ? void 0 : _a.name) || typeof got} (${typeof got})`;
     },
     NUMBER_COMPARE: (name, expected, value) => `'${name}' must be ${expected} ${value}`,
     EMPTY_ARRAY: (name) => `'${name}' is an empty array`,
     EMPTY_FILTERED_ARRAY: (name, type) => `There is no valid '${type}' in the '${name}' array`,
-    INVALID_KEY: (obj, key) => `"${key}" does not need to be provided in ${obj}`,
+    INVALID_KEY: (obj, key) => `'${key}' does not need to be provided in ${obj}`,
     MISSING_INTENTS: (i) => `${i} intent must be provided for the Client`,
     DISABLED_OPTION: (o) => `DisTubeOptions.${o} is disabled`,
     ENABLED_OPTION: (o) => `DisTubeOptions.${o} is enabled`,
@@ -44,25 +44,24 @@ const ERROR_MESSAGES = {
     NOT_SUPPORTED_URL: "This url is not supported",
     CANNOT_RESOLVE_SONG: (t) => `Cannot resolve ${t} to a Song`,
     NO_VALID_SONG: "'songs' array does not have any valid Song, SearchResult or url",
-    EMPTY_FILTERED_PLAYLIST: "There is no valid video in the playlist\nMaybe age-restricted contents is filtered because you are in non-NSFW channel",
+    EMPTY_FILTERED_PLAYLIST: "There is no valid video in the playlist\n" +
+        "Maybe age-restricted contents is filtered because you are in non-NSFW channel",
     EMPTY_PLAYLIST: "There is no valid video in the playlist",
 };
-const createMessage = (msg, ...args) => {
-    if (typeof msg === "string")
-        return msg;
-    return msg(...args);
-};
+const errMsg = (msg, ...args) => (typeof msg === "string" ? msg : msg(...args));
+const haveCode = (code) => Object.keys(ERROR_MESSAGES).includes(code);
 class DisTubeError extends Error {
     constructor(code, ...args) {
-        if (!Object.keys(ERROR_MESSAGES).includes(code))
-            throw new TypeError(`Error code '${code}' does not exist`);
-        super(createMessage(ERROR_MESSAGES[code], ...args));
+        if (haveCode(code))
+            super(errMsg(ERROR_MESSAGES[code], ...args));
+        else
+            super(...args);
         this.errorCode = code;
         if (Error.captureStackTrace)
             Error.captureStackTrace(this, DisTubeError);
     }
     get name() {
-        return `${super.name} [${this.errorCode}]`;
+        return `DisTubeError [${this.errorCode}]`;
     }
     get code() {
         return this.errorCode;

package/dist/struct/DisTubeError.js.map

@@ -1 +1 @@
-{"version":3,"file":"DisTubeError.js","sourceRoot":"","sources":["../../src/struct/DisTubeError.ts"],"names":[],"mappings":"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","sourcesContent":["const ERROR_MESSAGES = {\n  INVALID_TYPE: (expected: string | string[], got: any, name?: string) =>\n    `Expected ${\n      Array.isArray(expected) ? expected.map(e => (typeof e === \"number\" ? e : `'${e}'`)).join(\" or \") : `'${expected}'`\n    }${name ? ` for '${name}'` : \"\"}, but got ${\n      typeof got === \"string\"\n        ? `'${got}'`\n        : typeof got === \"number\"\n        ? got\n        : Array.isArray(got)\n        ? `Array<${got.length}>`\n        : got?.constructor?.name || typeof got\n    }`,\n  NUMBER_COMPARE: (name: string, expected: string, value: number) => `'${name}' must be ${expected} ${value}`,\n  EMPTY_ARRAY: (name: string) => `'${name}' is an empty array`,\n  EMPTY_FILTERED_ARRAY: (name: string, type: string) => `There is no valid '${type}' in the '${name}' array`,\n  INVALID_KEY: (obj: string, key: string) => `\"${key}\" does not need to be provided in ${obj}`,\n\n  MISSING_INTENTS: (i: string) => `${i} intent must be provided for the Client`,\n  DISABLED_OPTION: (o: string) => `DisTubeOptions.${o} is disabled`,\n  ENABLED_OPTION: (o: string) => `DisTubeOptions.${o} is enabled`,\n\n  NOT_IN_VOICE: \"User is not in any voice channel\",\n  NOT_SUPPORTED_VOICE: \"DisTubeVoice only supports VoiceChannel or a StageChannel\",\n  VOICE_FULL: \"The voice channel is full\",\n  VOICE_CONNECT_FAILED: (s: number) => `Cannot connect to the voice channel after ${s} seconds`,\n  VOICE_MISSING_PERMS: \"You do not have permission to join this voice channel\",\n  VOICE_RECONNECT_FAILED: \"Cannot reconnect to the voice channel\",\n  VOICE_CHANGE_GUILD: \"Cannot join a channel in a different guild\",\n\n  NO_QUEUE: \"There is no playing queue in this guild\",\n  QUEUE_EXIST: \"This guild has a Queue already\",\n  ADD_BEFORE_PLAYING: \"Cannot add Song before the playing Song\",\n  PAUSED: \"The queue has been paused already\",\n  RESUMED: \"The queue has been playing already\",\n  NO_PREVIOUS: \"There is no previous song in this queue\",\n  NO_UP_NEXT: \"There is no up next song\",\n  NO_SONG_POSITION: \"Does not have any song at this position\",\n  NO_PLAYING: \"There is no playing song in the queue\",\n\n  NO_RESULT: \"No result found\",\n  NO_RELATED: \"Cannot find any related songs\",\n  CANNOT_PLAY_RELATED: \"Cannot play the related song\",\n  UNAVAILABLE_VIDEO: \"This video is unavailable\",\n  UNPLAYABLE_FORMATS: \"No playable format found\",\n  NON_NSFW: \"Cannot play age-restricted content in non-NSFW channel\",\n  NOT_SUPPORTED_URL: \"This url is not supported\",\n  CANNOT_RESOLVE_SONG: (t: string) => `Cannot resolve ${t} to a Song`,\n  NO_VALID_SONG: \"'songs' array does not have any valid Song, SearchResult or url\",\n  EMPTY_FILTERED_PLAYLIST:\n    \"There is no valid video in the playlist\\nMaybe age-restricted contents is filtered because you are in non-NSFW channel\",\n  EMPTY_PLAYLIST: \"There is no valid video in the playlist\",\n};\n\nconst createMessage = (msg: string | ((...x: any) => string), ...args: any) => {\n  if (typeof msg === \"string\") return msg;\n  return msg(...args);\n};\n\nexport class DisTubeError extends Error {\n  errorCode: string;\n  constructor(code: keyof typeof ERROR_MESSAGES, ...args: any) {\n    if (!Object.keys(ERROR_MESSAGES).includes(code)) throw new TypeError(`Error code '${code}' does not exist`);\n\n    super(createMessage(ERROR_MESSAGES[code], ...args));\n    this.errorCode = code;\n    if (Error.captureStackTrace) Error.captureStackTrace(this, DisTubeError);\n  }\n\n  get name() {\n    return `${super.name} [${this.errorCode}]`;\n  }\n\n  get code() {\n    return this.errorCode;\n  }\n}\n\nexport default DisTubeError;\n"]}
+{"version":3,"file":"DisTubeError.js","sourceRoot":"","sources":["../../src/struct/DisTubeError.ts"],"names":[],"mappings":"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","sourcesContent":["const ERROR_MESSAGES = {\n  INVALID_TYPE: (expected: (number | string) | readonly (number | string)[], got: any, name?: string) =>\n    `Expected ${\n      Array.isArray(expected) ? expected.map(e => (typeof e === \"number\" ? e : `'${e}'`)).join(\" or \") : `'${expected}'`\n    }${name ? ` for '${name}'` : \"\"}, but got ${\n      typeof got === \"string\"\n        ? `'${got}'`\n        : typeof got === \"number\"\n        ? got\n        : Array.isArray(got)\n        ? `Array<${got.length}>`\n        : got?.constructor?.name || typeof got\n    } (${typeof got})`,\n  NUMBER_COMPARE: (name: string, expected: string, value: number) => `'${name}' must be ${expected} ${value}`,\n  EMPTY_ARRAY: (name: string) => `'${name}' is an empty array`,\n  EMPTY_FILTERED_ARRAY: (name: string, type: string) => `There is no valid '${type}' in the '${name}' array`,\n  INVALID_KEY: (obj: string, key: string) => `'${key}' does not need to be provided in ${obj}`,\n\n  MISSING_INTENTS: (i: string) => `${i} intent must be provided for the Client`,\n  DISABLED_OPTION: (o: string) => `DisTubeOptions.${o} is disabled`,\n  ENABLED_OPTION: (o: string) => `DisTubeOptions.${o} is enabled`,\n\n  NOT_IN_VOICE: \"User is not in any voice channel\",\n  NOT_SUPPORTED_VOICE: \"DisTubeVoice only supports VoiceChannel or a StageChannel\",\n  VOICE_FULL: \"The voice channel is full\",\n  VOICE_CONNECT_FAILED: (s: number) => `Cannot connect to the voice channel after ${s} seconds`,\n  VOICE_MISSING_PERMS: \"You do not have permission to join this voice channel\",\n  VOICE_RECONNECT_FAILED: \"Cannot reconnect to the voice channel\",\n  VOICE_CHANGE_GUILD: \"Cannot join a channel in a different guild\",\n\n  NO_QUEUE: \"There is no playing queue in this guild\",\n  QUEUE_EXIST: \"This guild has a Queue already\",\n  ADD_BEFORE_PLAYING: \"Cannot add Song before the playing Song\",\n  PAUSED: \"The queue has been paused already\",\n  RESUMED: \"The queue has been playing already\",\n  NO_PREVIOUS: \"There is no previous song in this queue\",\n  NO_UP_NEXT: \"There is no up next song\",\n  NO_SONG_POSITION: \"Does not have any song at this position\",\n  NO_PLAYING: \"There is no playing song in the queue\",\n\n  NO_RESULT: \"No result found\",\n  NO_RELATED: \"Cannot find any related songs\",\n  CANNOT_PLAY_RELATED: \"Cannot play the related song\",\n  UNAVAILABLE_VIDEO: \"This video is unavailable\",\n  UNPLAYABLE_FORMATS: \"No playable format found\",\n  NON_NSFW: \"Cannot play age-restricted content in non-NSFW channel\",\n  NOT_SUPPORTED_URL: \"This url is not supported\",\n  CANNOT_RESOLVE_SONG: (t: string) => `Cannot resolve ${t} to a Song`,\n  NO_VALID_SONG: \"'songs' array does not have any valid Song, SearchResult or url\",\n  EMPTY_FILTERED_PLAYLIST:\n    \"There is no valid video in the playlist\\n\" +\n    \"Maybe age-restricted contents is filtered because you are in non-NSFW channel\",\n  EMPTY_PLAYLIST: \"There is no valid video in the playlist\",\n};\n\ntype ErrorMessages = typeof ERROR_MESSAGES;\ntype ErrorCodes = keyof ErrorMessages;\ntype ErrorCode = { [K in ErrorCodes]-?: ErrorMessages[K] extends string ? K : never }[ErrorCodes];\ntype ErrorCodeTemplate = Exclude<keyof typeof ERROR_MESSAGES, ErrorCode>;\n\nconst errMsg = (msg: string | ((...x: any) => string), ...args: any) => (typeof msg === \"string\" ? msg : msg(...args));\n\nconst haveCode = (code: string): code is ErrorCodes => Object.keys(ERROR_MESSAGES).includes(code);\n\nexport class DisTubeError<T extends string> extends Error {\n  errorCode: string;\n  constructor(code: ErrorCode);\n  constructor(code: T extends ErrorCodeTemplate ? T : never, ...args: Parameters<ErrorMessages[typeof code]>);\n  constructor(code: ErrorCodeTemplate, _: never);\n  constructor(code: T extends ErrorCodes ? \"This is built-in error code\" : T, message: string);\n  constructor(code: string, ...args: any) {\n    if (haveCode(code)) super(errMsg(ERROR_MESSAGES[code], ...args));\n    else super(...args);\n\n    this.errorCode = code;\n    if (Error.captureStackTrace) Error.captureStackTrace(this, DisTubeError);\n  }\n\n  get name() {\n    return `DisTubeError [${this.errorCode}]`;\n  }\n\n  get code() {\n    return this.errorCode;\n  }\n}\n\nexport default DisTubeError;\n"]}

package/dist/struct/ExtractorPlugin.d.ts

@@ -4,17 +4,25 @@ import type { GuildMember } from "discord.js";
 /**
  * Extractor Plugin
  * @extends Plugin
+ * @abstract
  */
-export declare class ExtractorPlugin extends Plugin {
-    /** Create a extractor plugin */
-    constructor();
+export declare abstract class ExtractorPlugin extends Plugin {
+    type: "extractor";
     /**
-     * Execute if the url is validated (Not needed to add {@link Song#related} because it will be added with {@link Plugin#getRelatedSongs})
-     * @param {string} url URL
-     * @param {Discord.GuildMember} member Requested user
-     * @returns {Promise<Song|Song[]|Playlist>}
+     * Resolve the validated url to a {@link Song} or a {@link Playlist}.\
+     * Not needed to add {@link Song#related} because it will be added with {@link Plugin#getRelatedSongs}.
      */
-    resolve(url: string, member: GuildMember): Promise<Song | Playlist>;
+    abstract resolve(url: string, member: GuildMember): Promise<Song | Playlist>;
 }
+/**
+ * Resolve the validated url to a {@link Song} or a {@link Playlist}.\
+ * Not needed to add {@link Song#related} because it will be added with {@link Plugin#getRelatedSongs}.
+ * @param {string} url URL
+ * @param {Discord.GuildMember} member Requested user
+ * @returns {Promise<Song|Song[]|Playlist>}
+ * @method resolve
+ * @memberof ExtractorPlugin#
+ * @abstract
+ */
 export default ExtractorPlugin;
 //# sourceMappingURL=ExtractorPlugin.d.ts.map

package/dist/struct/ExtractorPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExtractorPlugin.d.ts","sourceRoot":"","sources":["../../src/struct/ExtractorPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,UAAU,CAAC;AAC9B,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,MAAM;IACzC,gCAAgC;;IAIhC;;;;;OAKG;IAEG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAC;CAG1E;AAED,eAAe,eAAe,CAAC"}
+{"version":3,"file":"ExtractorPlugin.d.ts","sourceRoot":"","sources":["../../src/struct/ExtractorPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,UAAU,CAAC;AAC9B,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;GAIG;AACH,8BAAsB,eAAgB,SAAQ,MAAM;IAClD,IAAI,cAAwB;IAC5B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAC;CAC7E;AAED;;;;;;;;;GASG;AAEH,eAAe,eAAe,CAAC"}

package/dist/struct/ExtractorPlugin.js

@@ -8,23 +8,24 @@ const Plugin_1 = __importDefault(require("./Plugin"));
 /**
  * Extractor Plugin
  * @extends Plugin
+ * @abstract
  */
 class ExtractorPlugin extends Plugin_1.default {
-    /** Create a extractor plugin */
     constructor() {
-        super("extractor");
-    }
-    /**
-     * Execute if the url is validated (Not needed to add {@link Song#related} because it will be added with {@link Plugin#getRelatedSongs})
-     * @param {string} url URL
-     * @param {Discord.GuildMember} member Requested user
-     * @returns {Promise<Song|Song[]|Playlist>}
-     */
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/require-await
-    async resolve(url, member) {
-        return undefined;
+        super(...arguments);
+        this.type = "extractor";
     }
 }
 exports.ExtractorPlugin = ExtractorPlugin;
+/**
+ * Resolve the validated url to a {@link Song} or a {@link Playlist}.\
+ * Not needed to add {@link Song#related} because it will be added with {@link Plugin#getRelatedSongs}.
+ * @param {string} url URL
+ * @param {Discord.GuildMember} member Requested user
+ * @returns {Promise<Song|Song[]|Playlist>}
+ * @method resolve
+ * @memberof ExtractorPlugin#
+ * @abstract
+ */
 exports.default = ExtractorPlugin;
 //# sourceMappingURL=ExtractorPlugin.js.map

package/dist/struct/ExtractorPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExtractorPlugin.js","sourceRoot":"","sources":["../../src/struct/ExtractorPlugin.ts"],"names":[],"mappings":";;;;;;AAAA,sDAA8B;AAI9B;;;GAGG;AACH,MAAa,eAAgB,SAAQ,gBAAM;IACzC,gCAAgC;IAChC;QACE,KAAK,CAAC,WAAW,CAAC,CAAC;IACrB,CAAC;IACD;;;;;OAKG;IACH,+FAA+F;IAC/F,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,MAAmB;QAC5C,OAAO,SAA4B,CAAC;IACtC,CAAC;CACF;AAfD,0CAeC;AAED,kBAAe,eAAe,CAAC","sourcesContent":["import Plugin from \"./Plugin\";\nimport type { Playlist, Song } from \".\";\nimport type { GuildMember } from \"discord.js\";\n\n/**\n * Extractor Plugin\n * @extends Plugin\n */\nexport class ExtractorPlugin extends Plugin {\n  /** Create a extractor plugin */\n  constructor() {\n    super(\"extractor\");\n  }\n  /**\n   * Execute if the url is validated (Not needed to add {@link Song#related} because it will be added with {@link Plugin#getRelatedSongs})\n   * @param {string} url URL\n   * @param {Discord.GuildMember} member Requested user\n   * @returns {Promise<Song|Song[]|Playlist>}\n   */\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/require-await\n  async resolve(url: string, member: GuildMember): Promise<Song | Playlist> {\n    return undefined as unknown as Song;\n  }\n}\n\nexport default ExtractorPlugin;\n"]}
+{"version":3,"file":"ExtractorPlugin.js","sourceRoot":"","sources":["../../src/struct/ExtractorPlugin.ts"],"names":[],"mappings":";;;;;;AAAA,sDAA8B;AAI9B;;;;GAIG;AACH,MAAsB,eAAgB,SAAQ,gBAAM;IAApD;;QACE,SAAI,GAAG,WAAoB,CAAC;IAM9B,CAAC;CAAA;AAPD,0CAOC;AAED;;;;;;;;;GASG;AAEH,kBAAe,eAAe,CAAC","sourcesContent":["import Plugin from \"./Plugin\";\nimport type { Playlist, Song } from \".\";\nimport type { GuildMember } from \"discord.js\";\n\n/**\n * Extractor Plugin\n * @extends Plugin\n * @abstract\n */\nexport abstract class ExtractorPlugin extends Plugin {\n  type = \"extractor\" as const;\n  /**\n   * Resolve the validated url to a {@link Song} or a {@link Playlist}.\\\n   * Not needed to add {@link Song#related} because it will be added with {@link Plugin#getRelatedSongs}.\n   */\n  abstract resolve(url: string, member: GuildMember): Promise<Song | Playlist>;\n}\n\n/**\n * Resolve the validated url to a {@link Song} or a {@link Playlist}.\\\n * Not needed to add {@link Song#related} because it will be added with {@link Plugin#getRelatedSongs}.\n * @param {string} url URL\n * @param {Discord.GuildMember} member Requested user\n * @returns {Promise<Song|Song[]|Playlist>}\n * @method resolve\n * @memberof ExtractorPlugin#\n * @abstract\n */\n\nexport default ExtractorPlugin;\n"]}

package/dist/struct/Playlist.d.ts

@@ -1,6 +1,5 @@
-import type Song from "./Song";
 import type ytpl from "@distube/ytpl";
-import type { PlaylistInfo } from "..";
+import type { PlaylistInfo, Song } from "..";
 import type { GuildMember, User } from "discord.js";
 /**
  * Class representing a playlist.
@@ -33,7 +32,7 @@ export declare class Playlist implements PlaylistInfo {
      */
     get formattedDuration(): string;
     /**
-     * @param {Discord.GuildMember} [member] Requested user
+     * @param {?Discord.GuildMember} [member] Requested user
      * @private
      * @returns {Playlist}
      */

package/dist/struct/Playlist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Playlist.d.ts","sourceRoot":"","sources":["../../src/struct/Playlist.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEpD;;;GAGG;AACH,qBAAa,QAAS,YAAW,YAAY;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IACjB;;;;;OAKG;gBACS,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,GAAG,YAAY,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,UAAU,GAAE,GAAQ;IA2CrG;;;OAGG;IACH,IAAI,QAAQ,WAEX;IAED;;;OAGG;IACH,IAAI,iBAAiB,WAEpB;IAED;;;;OAIG;IACH,YAAY,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,QAAQ;CAgB7C;AAED,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"Playlist.d.ts","sourceRoot":"","sources":["../../src/struct/Playlist.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEpD;;;GAGG;AACH,qBAAa,QAAS,YAAW,YAAY;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IACjB;;;;;OAKG;gBACS,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,GAAG,YAAY,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,UAAU,GAAE,GAAQ;IA8CrG;;;OAGG;IACH,IAAI,QAAQ,WAEX;IAED;;;OAGG;IACH,IAAI,iBAAiB,WAEpB;IAED;;;;OAIG;IACH,YAAY,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,QAAQ;CAgB7C;AAED,eAAe,QAAQ,CAAC"}

package/dist/struct/Playlist.js

@@ -41,7 +41,10 @@ class Playlist {
          * Playlist name.
          * @type {string}
          */
-        this.name = info.name || info.title || `${this.songs[0].name} and ${this.songs.length - 1} more songs.`;
+        this.name =
+            info.name || info.title || this.songs[0].name
+                ? `${this.songs[0].name} and ${this.songs.length - 1} more songs.`
+                : `${this.songs.length} songs playlist`;
         /**
          * Playlist URL.
          * @type {string}
@@ -49,7 +52,7 @@ class Playlist {
         this.url = info.url || info.webpage_url;
         /**
          * Playlist thumbnail.
-         * @type {string}
+         * @type {?string}
          */
         this.thumbnail = ((_a = info.thumbnail) === null || _a === void 0 ? void 0 : _a.url) || info.thumbnail || this.songs[0].thumbnail;
         for (const [key, value] of Object.entries(properties)) {
@@ -69,10 +72,10 @@ class Playlist {
      * @type {string}
      */
     get formattedDuration() {
-        return __1.formatDuration(this.duration);
+        return (0, __1.formatDuration)(this.duration);
     }
     /**
-     * @param {Discord.GuildMember} [member] Requested user
+     * @param {?Discord.GuildMember} [member] Requested user
      * @private
      * @returns {Playlist}
      */
@@ -81,12 +84,12 @@ class Playlist {
         if (member) {
             /**
              * User requested.
-             * @type {Discord.GuildMember}
+             * @type {?Discord.GuildMember}
              */
             this.member = member;
             /**
              * User requested.
-             * @type {Discord.User}
+             * @type {?Discord.User}
              */
             this.user = (_a = this.member) === null || _a === void 0 ? void 0 : _a.user;
         }

package/dist/struct/Playlist.js.map

@@ -1 +1 @@
-{"version":3,"file":"Playlist.js","sourceRoot":"","sources":["../../src/struct/Playlist.ts"],"names":[],"mappings":"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","sourcesContent":["import { DisTubeError, formatDuration } from \"..\";\nimport type Song from \"./Song\";\nimport type ytpl from \"@distube/ytpl\";\nimport type { PlaylistInfo } from \"..\";\nimport type { GuildMember, User } from \"discord.js\";\n\n/**\n * Class representing a playlist.\n * @prop {string} source Playlist source\n */\nexport class Playlist implements PlaylistInfo {\n  source: string;\n  member?: GuildMember;\n  user?: User;\n  songs: Song[];\n  name: string;\n  url?: string;\n  thumbnail?: string;\n  [x: string]: any;\n  /**\n   * Create a playlist\n   * @param {Song[]|PlaylistInfo} playlist Playlist\n   * @param {Discord.GuildMember} member Requested user\n   * @param {Object} properties Custom properties\n   */\n  constructor(playlist: Song[] | ytpl.result | PlaylistInfo, member?: GuildMember, properties: any = {}) {\n    if (typeof playlist !== \"object\") {\n      throw new DisTubeError(\"INVALID_TYPE\", [\"Array<Song>\", \"object\"], playlist, \"playlist\");\n    }\n    if (typeof properties !== \"object\") {\n      throw new DisTubeError(\"INVALID_TYPE\", \"object\", properties, \"properties\");\n    }\n    // FIXME\n    const info = playlist as any;\n    /**\n     * The source of the playlist\n     * @type {string}\n     */\n    this.source = (info.source || properties.source || \"youtube\").toLowerCase();\n    /**\n     * Playlist songs.\n     * @type {Array<Song>}\n     */\n    this.songs = Array.isArray(info) ? info : info.items || info.songs;\n    if (!Array.isArray(this.songs) || !this.songs.length) {\n      throw new DisTubeError(\"EMPTY_PLAYLIST\");\n    }\n    this._patchMember(member || info.member);\n    /**\n     * Playlist name.\n     * @type {string}\n     */\n    this.name = info.name || info.title || `${this.songs[0].name} and ${this.songs.length - 1} more songs.`;\n    /**\n     * Playlist URL.\n     * @type {string}\n     */\n    this.url = info.url || info.webpage_url;\n    /**\n     * Playlist thumbnail.\n     * @type {string}\n     */\n    this.thumbnail = info.thumbnail?.url || info.thumbnail || this.songs[0].thumbnail;\n    for (const [key, value] of Object.entries(properties)) {\n      this[key] = value;\n    }\n  }\n\n  /**\n   * Playlist duration in second.\n   * @type {number}\n   */\n  get duration() {\n    return this.songs?.reduce((prev, next) => prev + (next.duration || 0), 0) || 0;\n  }\n\n  /**\n   * Formatted duration string `hh:mm:ss`.\n   * @type {string}\n   */\n  get formattedDuration() {\n    return formatDuration(this.duration);\n  }\n\n  /**\n   * @param {Discord.GuildMember} [member] Requested user\n   * @private\n   * @returns {Playlist}\n   */\n  _patchMember(member?: GuildMember): Playlist {\n    if (member) {\n      /**\n       * User requested.\n       * @type {Discord.GuildMember}\n       */\n      this.member = member;\n      /**\n       * User requested.\n       * @type {Discord.User}\n       */\n      this.user = this.member?.user;\n    }\n    this.songs.map(s => s.constructor.name === \"Song\" && s._patchPlaylist(this, this.member));\n    return this;\n  }\n}\n\nexport default Playlist;\n"]}
+{"version":3,"file":"Playlist.js","sourceRoot":"","sources":["../../src/struct/Playlist.ts"],"names":[],"mappings":"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","sourcesContent":["import { DisTubeError, formatDuration } from \"..\";\nimport type ytpl from \"@distube/ytpl\";\nimport type { PlaylistInfo, Song } from \"..\";\nimport type { GuildMember, User } from \"discord.js\";\n\n/**\n * Class representing a playlist.\n * @prop {string} source Playlist source\n */\nexport class Playlist implements PlaylistInfo {\n  source: string;\n  member?: GuildMember;\n  user?: User;\n  songs: Song[];\n  name: string;\n  url?: string;\n  thumbnail?: string;\n  [x: string]: any;\n  /**\n   * Create a playlist\n   * @param {Song[]|PlaylistInfo} playlist Playlist\n   * @param {Discord.GuildMember} member Requested user\n   * @param {Object} properties Custom properties\n   */\n  constructor(playlist: Song[] | ytpl.result | PlaylistInfo, member?: GuildMember, properties: any = {}) {\n    if (typeof playlist !== \"object\") {\n      throw new DisTubeError(\"INVALID_TYPE\", [\"Array<Song>\", \"object\"], playlist, \"playlist\");\n    }\n    if (typeof properties !== \"object\") {\n      throw new DisTubeError(\"INVALID_TYPE\", \"object\", properties, \"properties\");\n    }\n    // FIXME\n    const info = playlist as any;\n    /**\n     * The source of the playlist\n     * @type {string}\n     */\n    this.source = (info.source || properties.source || \"youtube\").toLowerCase();\n    /**\n     * Playlist songs.\n     * @type {Array<Song>}\n     */\n    this.songs = Array.isArray(info) ? info : info.items || info.songs;\n    if (!Array.isArray(this.songs) || !this.songs.length) {\n      throw new DisTubeError(\"EMPTY_PLAYLIST\");\n    }\n    this._patchMember(member || info.member);\n    /**\n     * Playlist name.\n     * @type {string}\n     */\n    this.name =\n      info.name || info.title || this.songs[0].name\n        ? `${this.songs[0].name} and ${this.songs.length - 1} more songs.`\n        : `${this.songs.length} songs playlist`;\n    /**\n     * Playlist URL.\n     * @type {string}\n     */\n    this.url = info.url || info.webpage_url;\n    /**\n     * Playlist thumbnail.\n     * @type {?string}\n     */\n    this.thumbnail = info.thumbnail?.url || info.thumbnail || this.songs[0].thumbnail;\n    for (const [key, value] of Object.entries(properties)) {\n      this[key] = value;\n    }\n  }\n\n  /**\n   * Playlist duration in second.\n   * @type {number}\n   */\n  get duration() {\n    return this.songs?.reduce((prev, next) => prev + (next.duration || 0), 0) || 0;\n  }\n\n  /**\n   * Formatted duration string `hh:mm:ss`.\n   * @type {string}\n   */\n  get formattedDuration() {\n    return formatDuration(this.duration);\n  }\n\n  /**\n   * @param {?Discord.GuildMember} [member] Requested user\n   * @private\n   * @returns {Playlist}\n   */\n  _patchMember(member?: GuildMember): Playlist {\n    if (member) {\n      /**\n       * User requested.\n       * @type {?Discord.GuildMember}\n       */\n      this.member = member;\n      /**\n       * User requested.\n       * @type {?Discord.User}\n       */\n      this.user = this.member?.user;\n    }\n    this.songs.map(s => s.constructor.name === \"Song\" && s._patchPlaylist(this, this.member));\n    return this;\n  }\n}\n\nexport default Playlist;\n"]}

package/dist/struct/Plugin.d.ts

@@ -1,17 +1,68 @@
-import type DisTube from "../DisTube";
-import type { Song } from ".";
-import type { DisTubeHandler } from "../core";
+import type { Client, TextChannel } from "discord.js";
+import type { DisTube, DisTubeEvents, DisTubeHandler, DisTubeVoiceManager, Options, QueueManager, Song } from "..";
+/**
+ * All available plugin types:
+ * * `custom`: {@link CustomPlugin}
+ * * `extractor`: {@link ExtractorPlugin}
+ * @typedef {"custom"|"extractor"} PluginType
+ */
 /**
  * DisTube Plugin
+ * @abstract
  * @private
  */
-export declare class Plugin {
-    /** Type of the plugin */
+export declare abstract class Plugin {
     type: "custom" | "extractor";
     distube: DisTube;
-    handler: DisTubeHandler;
-    constructor(type: "custom" | "extractor");
     init(distube: DisTube): void;
+    /**
+     * Type of the plugin
+     * @name Plugin#type
+     * @type {PluginType}
+     */
+    /**
+     * Emit the {@link DisTube} of this base
+     * @param {string} eventName Event name
+     * @param {...any} args arguments
+     * @returns {boolean}
+     */
+    emit(eventName: keyof DisTubeEvents, ...args: any): boolean;
+    /**
+     * Emit error event
+     * @param {Error} error error
+     * @param {Discord.TextChannel?} channel Text channel where the error is encountered.
+     */
+    emitError(error: Error, channel?: TextChannel): void;
+    /**
+     * The queue manager
+     * @type {QueueManager}
+     * @readonly
+     */
+    get queues(): QueueManager;
+    /**
+     * The voice manager
+     * @type {DisTubeVoiceManager}
+     * @readonly
+     */
+    get voices(): DisTubeVoiceManager;
+    /**
+     * Discord.js client
+     * @type {Discord.Client}
+     * @readonly
+     */
+    get client(): Client;
+    /**
+     * DisTube options
+     * @type {DisTubeOptions}
+     * @readonly
+     */
+    get options(): Options;
+    /**
+     * DisTube handler
+     * @type {DisTubeHandler}
+     * @readonly
+     */
+    get handler(): DisTubeHandler;
     /**
      * Check if the url is working with this plugin
      * @param {string} url Input url
@@ -19,13 +70,15 @@ export declare class Plugin {
      */
     validate(url: string): Promise<boolean>;
     /**
-     * Get the stream url from {@link Song#url}. Returns {@link Song#url} by default. Not needed if the plugin plays song from YouTube.
+     * Get the stream url from {@link Song#url}. Returns {@link Song#url} by default.
+     * Not needed if the plugin plays song from YouTube.
      * @param {string} url Input url
      * @returns {Promise<string>}
      */
     getStreamURL(url: string): Promise<string>;
     /**
-     * (Optional) Get related songs from a supported url (Not needed to add {@link Song#related} and member is `null` because it will be added with this function later)
+     * (Optional) Get related songs from a supported url. {@link Song#member} should be `undefined`.
+     * Not needed to add {@link Song#related} because it will be added with this function later.
      * @param {string} url Input url
      * @returns {Promise<Song[]>}
      */

package/dist/struct/Plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../src/struct/Plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;GAGG;AACH,qBAAa,MAAM;IACjB,yBAAyB;IACzB,IAAI,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC7B,OAAO,EAAG,OAAO,CAAC;IAClB,OAAO,EAAG,cAAc,CAAC;gBACb,IAAI,EAAE,QAAQ,GAAG,WAAW;IAOxC,IAAI,CAAC,OAAO,EAAE,OAAO;IAYrB;;;;OAIG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAG7C;;;;OAIG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAGhD;;;;OAIG;IACG,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;CAGpD;AAED,eAAe,MAAM,CAAC"}
+{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../src/struct/Plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,mBAAmB,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAEnH;;;;;GAKG;AAEH;;;;GAIG;AACH,8BAAsB,MAAM;IAC1B,IAAI,EAAG,QAAQ,GAAG,WAAW,CAAC;IAC9B,OAAO,EAAG,OAAO,CAAC;IAClB,IAAI,CAAC,OAAO,EAAE,OAAO;IAOrB;;;;OAIG;IACH;;;;;OAKG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,aAAa,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,OAAO;IAG3D;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,WAAW;IAG7C;;;;OAIG;IACH,IAAI,MAAM,IAAI,YAAY,CAEzB;IACD;;;;OAIG;IACH,IAAI,MAAM,IAAI,mBAAmB,CAEhC;IACD;;;;OAIG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IACD;;;;OAIG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IACD;;;;OAIG;IACH,IAAI,OAAO,IAAI,cAAc,CAE5B;IACD;;;;OAIG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAG7C;;;;;OAKG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAGhD;;;;;OAKG;IACG,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;CAGpD;AAED,eAAe,MAAM,CAAC"}