distube 3.0.0-beta.8 → 3.0.2

package/dist/type.d.ts

@@ -0,0 +1,159 @@
+import type ytdl from "@distube/ytdl-core";
+import type { CustomPlugin, DisTubeVoice, ExtractorPlugin, Playlist, Queue, SearchResult, Song } from ".";
+import type { Guild, GuildMember, Interaction, Message, Snowflake, StageChannel, TextChannel, User, VoiceChannel, VoiceState } from "discord.js";
+declare type Awaitable = Promise<void> | void;
+export declare type DisTubeVoiceEvents = {
+    disconnect: (error?: Error) => Awaitable;
+    error: (error: Error) => Awaitable;
+    finish: () => Awaitable;
+};
+export declare type DisTubeEvents = {
+    /** Emitted after DisTube add a new song to the playing {@link Queue}. */
+    addSong: (queue: Queue, song: Song) => Awaitable;
+    /**
+     * Emitted when DisTube play a song.
+     *
+     * If {@link DisTubeOptions.emitNewSongOnly} is `true`,
+     * this event is not emitted when looping a song or next song is the previous one.
+     */
+    playSong: (queue: Queue, song: Song) => Awaitable;
+    /** Emitted when DisTube finished a song. */
+    finishSong: (queue: Queue, song: Song) => Awaitable;
+    /**
+     * Emitted when there is no user in the voice channel,
+     * {@link DisTubeOptions.leaveOnEmpty} is `true` and there is a playing queue.
+     *
+     * If there is no playing queue (stopped and {@link DisTubeOptions.leaveOnStop} is `false`),
+     * it will leave the channel without emitting this event.
+     */
+    empty: (queue: Queue) => Awaitable;
+    /**
+     * Emitted when there is no more song in the queue and {@link Queue#autoplay} is `false`.
+     * DisTube will leave voice channel if {@link DisTubeOptions.leaveOnFinish} is `true`.
+     */
+    finish: (queue: Queue) => Awaitable;
+    /** Emitted when DisTube initialize a queue to change queue default properties. */
+    initQueue: (queue: Queue) => Awaitable;
+    /**
+     * Emitted when {@link Queue#autoplay} is `true`, {@link Queue#songs} is empty,
+     * and DisTube cannot find related songs to play.
+     */
+    noRelated: (queue: Queue) => Awaitable;
+    /** Emitted when the bot is disconnected to a voice channel. */
+    disconnect: (queue: Queue) => Awaitable;
+    /** Emitted when a {@link Queue} is deleted with any reasons. */
+    deleteQueue: (queue: Queue) => Awaitable;
+    /**
+     * Emitted when {@link DisTubeOptions.searchSongs} bigger than 0,
+     * and the search canceled due to {@link DisTubeOptions.searchTimeout}.
+     */
+    searchCancel: (message: Message, query: string) => Awaitable;
+    /** Emitted when DisTube cannot find any results for the query. */
+    searchNoResult: (message: Message, query: string) => Awaitable;
+    /**
+     * Emitted when {@link DisTubeOptions.searchSongs} bigger than 0,
+     * and after the user chose a search result to play.
+     */
+    searchDone: (message: Message, answer: Message, query: string) => Awaitable;
+    /**
+     * Emitted when {@link DisTubeOptions.searchSongs} bigger than 0,
+     * and the search canceled due to user's next message is not a number or out of results range.
+     */
+    searchInvalidAnswer: (message: Message, answer: Message, query: string) => Awaitable;
+    /** Emitted when DisTube encounters an error. */
+    error: (channel: TextChannel, error: Error) => Awaitable;
+    /** Emitted after DisTube add a new playlist to the playing {@link Queue}. */
+    addList: (queue: Queue, playlist: Playlist) => Awaitable;
+    /**
+     * Emitted when {@link DisTubeOptions.searchSongs} bigger than 0,
+     * and song param of {@link DisTube#playVoiceChannel} is invalid url.
+     * DisTube will wait for user's next message to choose a song manually.
+     *
+     * Safe search is enabled
+     * if {@link DisTubeOptions.nsfw} is disabled and the message's channel is not a nsfw channel.
+     */
+    searchResult: (message: Message, results: SearchResult[], query: string) => Awaitable;
+};
+export declare type Filters = Record<string, string>;
+export interface DisTubeOptions {
+    plugins?: (CustomPlugin | ExtractorPlugin)[];
+    emitNewSongOnly?: boolean;
+    leaveOnFinish?: boolean;
+    leaveOnStop?: boolean;
+    leaveOnEmpty?: boolean;
+    emptyCooldown?: number;
+    savePreviousSongs?: boolean;
+    searchSongs?: number;
+    searchCooldown?: number;
+    youtubeCookie?: string;
+    youtubeIdentityToken?: string;
+    youtubeDL?: boolean;
+    updateYouTubeDL?: boolean;
+    customFilters?: Filters;
+    ytdlOptions?: ytdl.downloadOptions;
+    nsfw?: boolean;
+    emitAddSongWhenCreatingQueue?: boolean;
+    emitAddListWhenCreatingQueue?: boolean;
+}
+export declare type GuildIDResolvable = Queue | DisTubeVoice | Snowflake | Message | VoiceChannel | StageChannel | VoiceState | Guild | TextChannel | GuildMember | Interaction | string;
+export interface OtherSongInfo {
+    src?: string;
+    id?: string;
+    title?: string;
+    name?: string;
+    is_live?: boolean;
+    isLive?: boolean;
+    _duration_raw?: string | number;
+    duration?: string | number;
+    webpage_url?: string;
+    url: string;
+    thumbnail?: string;
+    related?: Song[];
+    view_count?: string | number;
+    views?: string | number;
+    like_count?: string | number;
+    likes?: string | number;
+    dislike_count?: string | number;
+    dislikes?: string | number;
+    repost_count?: string | number;
+    reposts?: string | number;
+    uploader?: string;
+    uploader_url?: string;
+    age_limit?: string | number;
+    chapters?: Chapter[];
+    age_restricted?: boolean;
+}
+export interface Chapter {
+    /** Chapter title */
+    title: string;
+    /** Chapter start time in seconds */
+    start_time: number;
+}
+export interface PlaylistInfo {
+    /** The source of the playlist */
+    source: string;
+    /**
+     * User requested.
+     */
+    member?: GuildMember;
+    /**
+     * User requested.
+     */
+    user?: User;
+    /** Playlist songs. */
+    songs: Song[];
+    /**
+     * Playlist name.
+     */
+    name?: string;
+    /**
+     * Playlist URL.
+     */
+    url?: string;
+    /**
+     * Playlist thumbnail.
+     */
+    thumbnail?: string;
+}
+export {};
+//# sourceMappingURL=type.d.ts.map

package/dist/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../src/type.ts"],"names":[],"mappings":"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"}

package/dist/type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=type.js.map

package/dist/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../src/type.ts"],"names":[],"mappings":"","sourcesContent":["import type ytdl from \"@distube/ytdl-core\";\nimport type { CustomPlugin, DisTubeVoice, ExtractorPlugin, Playlist, Queue, SearchResult, Song } from \".\";\nimport type {\n  Guild,\n  GuildMember,\n  Interaction,\n  Message,\n  Snowflake,\n  StageChannel,\n  TextChannel,\n  User,\n  VoiceChannel,\n  VoiceState,\n} from \"discord.js\";\n\ntype Awaitable = Promise<void> | void;\n\nexport type DisTubeVoiceEvents = {\n  disconnect: (error?: Error) => Awaitable;\n  error: (error: Error) => Awaitable;\n  finish: () => Awaitable;\n};\n\nexport type DisTubeEvents = {\n  /** Emitted after DisTube add a new song to the playing {@link Queue}. */\n  addSong: (queue: Queue, song: Song) => Awaitable;\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  playSong: (queue: Queue, song: Song) => Awaitable;\n  /** Emitted when DisTube finished a song. */\n  finishSong: (queue: Queue, song: Song) => Awaitable;\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   */\n  empty: (queue: Queue) => Awaitable;\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  finish: (queue: Queue) => Awaitable;\n  /** Emitted when DisTube initialize a queue to change queue default properties. */\n  initQueue: (queue: Queue) => Awaitable;\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  noRelated: (queue: Queue) => Awaitable;\n  /** Emitted when the bot is disconnected to a voice channel. */\n  disconnect: (queue: Queue) => Awaitable;\n  /** Emitted when a {@link Queue} is deleted with any reasons. */\n  deleteQueue: (queue: Queue) => Awaitable;\n\n  /**\n   * Emitted when {@link DisTubeOptions.searchSongs} bigger than 0,\n   * and the search canceled due to {@link DisTubeOptions.searchTimeout}.\n   */\n  searchCancel: (message: Message, query: string) => Awaitable;\n  /** Emitted when DisTube cannot find any results for the query. */\n  searchNoResult: (message: Message, query: string) => Awaitable;\n\n  /**\n   * Emitted when {@link DisTubeOptions.searchSongs} bigger than 0,\n   * and after the user chose a search result to play.\n   */\n  searchDone: (message: Message, answer: Message, query: string) => Awaitable;\n  /**\n   * Emitted when {@link 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  searchInvalidAnswer: (message: Message, answer: Message, query: string) => Awaitable;\n\n  /** Emitted when DisTube encounters an error. */\n  error: (channel: TextChannel, error: Error) => Awaitable;\n  /** Emitted after DisTube add a new playlist to the playing {@link Queue}. */\n  addList: (queue: Queue, playlist: Playlist) => Awaitable;\n  /**\n   * Emitted when {@link DisTubeOptions.searchSongs} bigger than 0,\n   * and song param of {@link DisTube#playVoiceChannel} is invalid url.\n   * DisTube will wait for user's next message to choose a song manually.\n   *\n   * Safe search is enabled\n   * if {@link DisTubeOptions.nsfw} is disabled and the message's channel is not a nsfw channel.\n   */\n  searchResult: (message: Message, results: SearchResult[], query: string) => Awaitable;\n};\n\nexport type Filters = Record<string, string>;\n\nexport interface DisTubeOptions {\n  plugins?: (CustomPlugin | ExtractorPlugin)[];\n  emitNewSongOnly?: boolean;\n  leaveOnFinish?: boolean;\n  leaveOnStop?: boolean;\n  leaveOnEmpty?: boolean;\n  emptyCooldown?: number;\n  savePreviousSongs?: boolean;\n  searchSongs?: number;\n  searchCooldown?: number;\n  youtubeCookie?: string;\n  youtubeIdentityToken?: string;\n  youtubeDL?: boolean;\n  updateYouTubeDL?: boolean;\n  customFilters?: Filters;\n  ytdlOptions?: ytdl.downloadOptions;\n  nsfw?: boolean;\n  emitAddSongWhenCreatingQueue?: boolean;\n  emitAddListWhenCreatingQueue?: boolean;\n}\n\nexport type GuildIDResolvable =\n  | Queue\n  | DisTubeVoice\n  | Snowflake\n  | Message\n  | VoiceChannel\n  | StageChannel\n  | VoiceState\n  | Guild\n  | TextChannel\n  | GuildMember\n  | Interaction\n  | string;\n\nexport interface OtherSongInfo {\n  src?: string;\n  id?: string;\n  title?: string;\n  name?: string;\n  is_live?: boolean;\n  isLive?: boolean;\n  _duration_raw?: string | number;\n  duration?: string | number;\n  webpage_url?: string;\n  url: string;\n  thumbnail?: string;\n  related?: Song[];\n  view_count?: string | number;\n  views?: string | number;\n  like_count?: string | number;\n  likes?: string | number;\n  dislike_count?: string | number;\n  dislikes?: string | number;\n  repost_count?: string | number;\n  reposts?: string | number;\n  uploader?: string;\n  uploader_url?: string;\n  age_limit?: string | number;\n  chapters?: Chapter[];\n  age_restricted?: boolean;\n}\n\nexport interface Chapter {\n  /** Chapter title */\n  title: string;\n  /** Chapter start time in seconds */\n  start_time: number;\n}\n\nexport interface PlaylistInfo {\n  /** The source of the playlist */\n  source: string;\n  /**\n   * User requested.\n   */\n  member?: GuildMember;\n  /**\n   * User requested.\n   */\n  user?: User;\n  /** Playlist songs. */\n  songs: Song[];\n  /**\n   * Playlist name.\n   */\n  name?: string;\n  /**\n   * Playlist URL.\n   */\n  url?: string;\n  /**\n   * Playlist thumbnail.\n   */\n  thumbnail?: string;\n}\n"]}

package/dist/util.d.ts

@@ -0,0 +1,47 @@
+import type { GuildIDResolvable } from ".";
+import type { Client, ClientOptions, Guild, GuildMember, Message, Snowflake, StageChannel, TextChannel, VoiceChannel, VoiceState } from "discord.js";
+/**
+ * Format duration to string
+ * @param {number} sec Duration in seconds
+ * @returns {string}
+ */
+export declare function formatDuration(sec: number): string;
+/**
+ * Convert formatted duration to seconds
+ * @param {*} input Formatted duration string
+ * @returns {number}
+ */
+export declare function toSecond(input: any): number;
+/**
+ * Parse number from input
+ * @param {*} input Any
+ * @returns {number}
+ */
+export declare function parseNumber(input: any): number;
+/**
+ * Check if the string is an URL
+ * @param {string} input input
+ * @returns {boolean}
+ */
+export declare function isURL(input: any): boolean;
+/**
+ * Check if the Client has enough intents to using DisTube
+ * @param {ClientOptions} options options
+ */
+export declare function checkIntents(options: ClientOptions): void;
+/**
+ * Check if the voice channel is empty
+ * @param {Discord.VoiceState} voiceState voiceState
+ * @returns {boolean}
+ */
+export declare function isVoiceChannelEmpty(voiceState: VoiceState): boolean;
+export declare function isSnowflake(id: any): id is Snowflake;
+export declare function isMemberInstance(member: any): member is GuildMember;
+export declare function isTextChannelInstance(channel: any): channel is TextChannel;
+export declare function isMessageInstance(message: any): message is Message;
+export declare function isSupportedVoiceChannel(channel: any): channel is VoiceChannel | StageChannel;
+export declare function isGuildInstance(guild: any): guild is Guild;
+export declare function resolveGuildID(resolvable: GuildIDResolvable): Snowflake;
+export declare function isClientInstance(client: any): client is Client;
+export declare function checkInvalidKey(target: Record<string, any>, source: Record<string, any> | string[], sourceName: string): void;
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,GAAG,CAAC;AAC3C,OAAO,KAAK,EAEV,MAAM,EACN,aAAa,EACb,KAAK,EACL,WAAW,EAEX,OAAO,EACP,SAAS,EACT,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACX,MAAM,YAAY,CAAC;AAIpB;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQlD;AACD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAY3C;AACD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAG9C;AACD;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CASzC;AACD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAQzD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAKnE;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,GAAG,GAAG,EAAE,IAAI,SAAS,CAMpD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,WAAW,CAQnE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,IAAI,WAAW,CAQ1E;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,IAAI,OAAO,CAYlE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,IAAI,YAAY,GAAG,YAAY,CAgB5F;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,KAAK,CAE1D;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,iBAAiB,GAAG,SAAS,CAWvE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,MAAM,CAE9D;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,EACtC,UAAU,EAAE,MAAM,QAQnB"}

package/dist/util.js

@@ -0,0 +1,205 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkInvalidKey = exports.isClientInstance = exports.resolveGuildID = exports.isGuildInstance = exports.isSupportedVoiceChannel = exports.isMessageInstance = exports.isTextChannelInstance = exports.isMemberInstance = exports.isSnowflake = exports.isVoiceChannelEmpty = exports.checkIntents = exports.isURL = exports.parseNumber = exports.toSecond = exports.formatDuration = void 0;
+const url_1 = require("url");
+const _1 = require(".");
+const discord_js_1 = require("discord.js");
+const formatInt = (int) => (int < 10 ? `0${int}` : int);
+/**
+ * Format duration to string
+ * @param {number} sec Duration in seconds
+ * @returns {string}
+ */
+function formatDuration(sec) {
+    if (!sec || !Number(sec))
+        return "00:00";
+    const seconds = Math.round(sec % 60);
+    const minutes = Math.floor((sec % 3600) / 60);
+    const hours = Math.floor(sec / 3600);
+    if (hours > 0)
+        return `${formatInt(hours)}:${formatInt(minutes)}:${formatInt(seconds)}`;
+    if (minutes > 0)
+        return `${formatInt(minutes)}:${formatInt(seconds)}`;
+    return `00:${formatInt(seconds)}`;
+}
+exports.formatDuration = formatDuration;
+/**
+ * Convert formatted duration to seconds
+ * @param {*} input Formatted duration string
+ * @returns {number}
+ */
+function toSecond(input) {
+    if (!input)
+        return 0;
+    if (typeof input !== "string")
+        return Number(input) || 0;
+    if (input.match(/:/g)) {
+        const time = input.split(":").reverse();
+        let s = 0;
+        for (let i = 0; i < 3; i++)
+            if (time[i])
+                s += Number(time[i].replace(/[^\d.]+/g, "")) * Math.pow(60, i);
+        if (time.length > 3)
+            s += Number(time[3].replace(/[^\d.]+/g, "")) * 24 * 60 * 60;
+        return s;
+    }
+    else {
+        return Number(input.replace(/[^\d.]+/g, "")) || 0;
+    }
+}
+exports.toSecond = toSecond;
+/**
+ * Parse number from input
+ * @param {*} input Any
+ * @returns {number}
+ */
+function parseNumber(input) {
+    if (typeof input === "string")
+        return Number(input.replace(/[^\d.]+/g, "")) || 0;
+    return Number(input) || 0;
+}
+exports.parseNumber = parseNumber;
+/**
+ * Check if the string is an URL
+ * @param {string} input input
+ * @returns {boolean}
+ */
+function isURL(input) {
+    if (typeof input !== "string" || input.includes(" "))
+        return false;
+    try {
+        const url = new url_1.URL(input);
+        if (!["https:", "http:"].includes(url.protocol) || !url.host)
+            return false;
+    }
+    catch {
+        return false;
+    }
+    return true;
+}
+exports.isURL = isURL;
+/**
+ * Check if the Client has enough intents to using DisTube
+ * @param {ClientOptions} options options
+ */
+function checkIntents(options) {
+    var _a, _b;
+    const requiredIntents = ["GUILD_VOICE_STATES"];
+    const bitfield = (_a = options.intents) !== null && _a !== void 0 ? _a : (_b = options === null || options === void 0 ? void 0 : options.ws) === null || _b === void 0 ? void 0 : _b.intents;
+    if (typeof bitfield === "undefined")
+        return;
+    const intents = new discord_js_1.Intents(bitfield);
+    for (const intent of requiredIntents) {
+        if (!intents.has(intent))
+            throw new _1.DisTubeError("MISSING_INTENTS", intent.toString());
+    }
+}
+exports.checkIntents = checkIntents;
+/**
+ * Check if the voice channel is empty
+ * @param {Discord.VoiceState} voiceState voiceState
+ * @returns {boolean}
+ */
+function isVoiceChannelEmpty(voiceState) {
+    var _a, _b, _c;
+    const voiceChannel = (_c = (_b = (_a = voiceState.guild) === null || _a === void 0 ? void 0 : _a.me) === null || _b === void 0 ? void 0 : _b.voice) === null || _c === void 0 ? void 0 : _c.channel;
+    if (!voiceChannel)
+        return false;
+    const members = voiceChannel.members.filter(m => !m.user.bot);
+    return !members.size;
+}
+exports.isVoiceChannelEmpty = isVoiceChannelEmpty;
+function isSnowflake(id) {
+    try {
+        return discord_js_1.SnowflakeUtil.deconstruct(id).timestamp > discord_js_1.SnowflakeUtil.EPOCH;
+    }
+    catch {
+        return false;
+    }
+}
+exports.isSnowflake = isSnowflake;
+function isMemberInstance(member) {
+    var _a, _b;
+    return (!!member &&
+        isSnowflake(member.id) &&
+        isSnowflake((_a = member.guild) === null || _a === void 0 ? void 0 : _a.id) &&
+        isSnowflake((_b = member.user) === null || _b === void 0 ? void 0 : _b.id) &&
+        member.id === member.user.id);
+}
+exports.isMemberInstance = isMemberInstance;
+function isTextChannelInstance(channel) {
+    var _a;
+    return (!!channel &&
+        isSnowflake(channel.id) &&
+        isSnowflake((_a = channel.guild) === null || _a === void 0 ? void 0 : _a.id) &&
+        typeof channel.send === "function" &&
+        typeof channel.awaitMessages === "function");
+}
+exports.isTextChannelInstance = isTextChannelInstance;
+function isMessageInstance(message) {
+    var _a, _b;
+    // Simple check for using distube normally
+    return (!!message &&
+        isSnowflake(message.id) &&
+        isSnowflake((_a = message.guild) === null || _a === void 0 ? void 0 : _a.id) &&
+        isTextChannelInstance(message.channel) &&
+        isMemberInstance(message.member) &&
+        isSnowflake((_b = message.author) === null || _b === void 0 ? void 0 : _b.id) &&
+        message.member.id === message.author.id &&
+        message.guild.id === message.channel.guild.id);
+}
+exports.isMessageInstance = isMessageInstance;
+function isSupportedVoiceChannel(channel) {
+    var _a;
+    return (!!channel &&
+        channel.deleted === false &&
+        isSnowflake(channel.id) &&
+        isSnowflake((_a = channel.guild) === null || _a === void 0 ? void 0 : _a.id) &&
+        typeof channel.full === "boolean" &&
+        [
+            // Djs v12
+            "voice",
+            "stage",
+            // Djs v13
+            "GUILD_VOICE",
+            "GUILD_STAGE_VOICE",
+        ].includes(channel.type));
+}
+exports.isSupportedVoiceChannel = isSupportedVoiceChannel;
+function isGuildInstance(guild) {
+    return !!guild && isSnowflake(guild.id) && typeof guild.fetchAuditLogs === "function";
+}
+exports.isGuildInstance = isGuildInstance;
+function resolveGuildID(resolvable) {
+    let guildID;
+    if (typeof resolvable === "string") {
+        guildID = resolvable;
+    }
+    else if (typeof resolvable === "object") {
+        if (resolvable instanceof _1.Queue || resolvable instanceof _1.DisTubeVoice)
+            guildID = resolvable.id;
+        else if ("guild" in resolvable && isGuildInstance(resolvable.guild))
+            guildID = resolvable.guild.id;
+        else if ("id" in resolvable && isGuildInstance(resolvable))
+            guildID = resolvable.id;
+    }
+    if (!isSnowflake(guildID))
+        throw new _1.DisTubeError("INVALID_TYPE", "GuildIDResolvable", resolvable);
+    return guildID;
+}
+exports.resolveGuildID = resolveGuildID;
+function isClientInstance(client) {
+    return !!client && typeof client.login === "function";
+}
+exports.isClientInstance = isClientInstance;
+function checkInvalidKey(target, source, sourceName) {
+    if (typeof target !== "object" || Array.isArray(target)) {
+        throw new _1.DisTubeError("INVALID_TYPE", "object", target, sourceName);
+    }
+    const sourceKeys = Array.isArray(source) ? source : Object.keys(source);
+    const invalidKey = Object.keys(target).find(key => !sourceKeys.includes(key));
+    if (invalidKey)
+        throw new _1.DisTubeError("INVALID_KEY", sourceName, invalidKey);
+}
+exports.checkInvalidKey = checkInvalidKey;
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"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","sourcesContent":["import { URL } from \"url\";\nimport { DisTubeError, DisTubeVoice, Queue } from \".\";\nimport { Intents, SnowflakeUtil } from \"discord.js\";\nimport type { GuildIDResolvable } from \".\";\nimport type {\n  BitFieldResolvable,\n  Client,\n  ClientOptions,\n  Guild,\n  GuildMember,\n  IntentsString,\n  Message,\n  Snowflake,\n  StageChannel,\n  TextChannel,\n  VoiceChannel,\n  VoiceState,\n} from \"discord.js\";\n\nconst formatInt = (int: number) => (int < 10 ? `0${int}` : int);\n\n/**\n * Format duration to string\n * @param {number} sec Duration in seconds\n * @returns {string}\n */\nexport function formatDuration(sec: number): string {\n  if (!sec || !Number(sec)) return \"00:00\";\n  const seconds = Math.round(sec % 60);\n  const minutes = Math.floor((sec % 3600) / 60);\n  const hours = Math.floor(sec / 3600);\n  if (hours > 0) return `${formatInt(hours)}:${formatInt(minutes)}:${formatInt(seconds)}`;\n  if (minutes > 0) return `${formatInt(minutes)}:${formatInt(seconds)}`;\n  return `00:${formatInt(seconds)}`;\n}\n/**\n * Convert formatted duration to seconds\n * @param {*} input Formatted duration string\n * @returns {number}\n */\nexport function toSecond(input: any): number {\n  if (!input) return 0;\n  if (typeof input !== \"string\") return Number(input) || 0;\n  if (input.match(/:/g)) {\n    const time = input.split(\":\").reverse();\n    let s = 0;\n    for (let i = 0; i < 3; i++) if (time[i]) s += Number(time[i].replace(/[^\\d.]+/g, \"\")) * Math.pow(60, i);\n    if (time.length > 3) s += Number(time[3].replace(/[^\\d.]+/g, \"\")) * 24 * 60 * 60;\n    return s;\n  } else {\n    return Number(input.replace(/[^\\d.]+/g, \"\")) || 0;\n  }\n}\n/**\n * Parse number from input\n * @param {*} input Any\n * @returns {number}\n */\nexport function parseNumber(input: any): number {\n  if (typeof input === \"string\") return Number(input.replace(/[^\\d.]+/g, \"\")) || 0;\n  return Number(input) || 0;\n}\n/**\n * Check if the string is an URL\n * @param {string} input input\n * @returns {boolean}\n */\nexport function isURL(input: any): boolean {\n  if (typeof input !== \"string\" || input.includes(\" \")) return false;\n  try {\n    const url = new URL(input);\n    if (![\"https:\", \"http:\"].includes(url.protocol) || !url.host) return false;\n  } catch {\n    return false;\n  }\n  return true;\n}\n/**\n * Check if the Client has enough intents to using DisTube\n * @param {ClientOptions} options options\n */\nexport function checkIntents(options: ClientOptions): void {\n  const requiredIntents: BitFieldResolvable<IntentsString, number>[] = [\"GUILD_VOICE_STATES\"];\n  const bitfield: BitFieldResolvable<IntentsString, number> = options.intents ?? (options?.ws as any)?.intents;\n  if (typeof bitfield === \"undefined\") return;\n  const intents = new Intents(bitfield);\n  for (const intent of requiredIntents) {\n    if (!intents.has(intent)) throw new DisTubeError(\"MISSING_INTENTS\", intent.toString());\n  }\n}\n\n/**\n * Check if the voice channel is empty\n * @param {Discord.VoiceState} voiceState voiceState\n * @returns {boolean}\n */\nexport function isVoiceChannelEmpty(voiceState: VoiceState): boolean {\n  const voiceChannel = voiceState.guild?.me?.voice?.channel;\n  if (!voiceChannel) return false;\n  const members = voiceChannel.members.filter(m => !m.user.bot);\n  return !members.size;\n}\n\nexport function isSnowflake(id: any): id is Snowflake {\n  try {\n    return SnowflakeUtil.deconstruct(id).timestamp > SnowflakeUtil.EPOCH;\n  } catch {\n    return false;\n  }\n}\n\nexport function isMemberInstance(member: any): member is GuildMember {\n  return (\n    !!member &&\n    isSnowflake(member.id) &&\n    isSnowflake(member.guild?.id) &&\n    isSnowflake(member.user?.id) &&\n    member.id === member.user.id\n  );\n}\n\nexport function isTextChannelInstance(channel: any): channel is TextChannel {\n  return (\n    !!channel &&\n    isSnowflake(channel.id) &&\n    isSnowflake(channel.guild?.id) &&\n    typeof channel.send === \"function\" &&\n    typeof channel.awaitMessages === \"function\"\n  );\n}\n\nexport function isMessageInstance(message: any): message is Message {\n  // Simple check for using distube normally\n  return (\n    !!message &&\n    isSnowflake(message.id) &&\n    isSnowflake(message.guild?.id) &&\n    isTextChannelInstance(message.channel) &&\n    isMemberInstance(message.member) &&\n    isSnowflake(message.author?.id) &&\n    message.member.id === message.author.id &&\n    message.guild.id === message.channel.guild.id\n  );\n}\n\nexport function isSupportedVoiceChannel(channel: any): channel is VoiceChannel | StageChannel {\n  return (\n    !!channel &&\n    channel.deleted === false &&\n    isSnowflake(channel.id) &&\n    isSnowflake(channel.guild?.id) &&\n    typeof channel.full === \"boolean\" &&\n    [\n      // Djs v12\n      \"voice\",\n      \"stage\",\n      // Djs v13\n      \"GUILD_VOICE\",\n      \"GUILD_STAGE_VOICE\",\n    ].includes(channel.type)\n  );\n}\n\nexport function isGuildInstance(guild: any): guild is Guild {\n  return !!guild && isSnowflake(guild.id) && typeof guild.fetchAuditLogs === \"function\";\n}\n\nexport function resolveGuildID(resolvable: GuildIDResolvable): Snowflake {\n  let guildID: string | undefined;\n  if (typeof resolvable === \"string\") {\n    guildID = resolvable;\n  } else if (typeof resolvable === \"object\") {\n    if (resolvable instanceof Queue || resolvable instanceof DisTubeVoice) guildID = resolvable.id;\n    else if (\"guild\" in resolvable && isGuildInstance(resolvable.guild)) guildID = resolvable.guild.id;\n    else if (\"id\" in resolvable && isGuildInstance(resolvable)) guildID = resolvable.id;\n  }\n  if (!isSnowflake(guildID)) throw new DisTubeError(\"INVALID_TYPE\", \"GuildIDResolvable\", resolvable);\n  return guildID;\n}\n\nexport function isClientInstance(client: any): client is Client {\n  return !!client && typeof client.login === \"function\";\n}\n\nexport function checkInvalidKey(\n  target: Record<string, any>,\n  source: Record<string, any> | string[],\n  sourceName: string,\n) {\n  if (typeof target !== \"object\" || Array.isArray(target)) {\n    throw new DisTubeError(\"INVALID_TYPE\", \"object\", target, sourceName);\n  }\n  const sourceKeys = Array.isArray(source) ? source : Object.keys(source);\n  const invalidKey = Object.keys(target).find(key => !sourceKeys.includes(key));\n  if (invalidKey) throw new DisTubeError(\"INVALID_KEY\", sourceName, invalidKey);\n}\n"]}

package/package.json

@@ -1,62 +1,88 @@
-{
-  "name": "distube",
-  "version": "3.0.0-beta.8",
-  "description": "A Discord.js v12 module to simplify your music commands and play songs with audio filters on Discord without any API key. Support YouTube, SoundCloud, Bandcamp, Facebook, and 700+ more sites",
-  "main": "src/DisTube.js",
-  "typings": "typings/DisTube.d.ts",
-  "scripts": {
-    "docgen": "npx docgen --source src --output docs/beta.json",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "types": "tsc -p ."
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/skick1234/DisTube.git"
-  },
-  "keywords": [
-    "youtube",
-    "music",
-    "discord",
-    "discordjs",
-    "bot",
-    "distube",
-    "queue",
-    "musicbot",
-    "discord-music-bot",
-    "music-bot",
-    "discord-js"
-  ],
-  "author": "Skick (https://github.com/skick1234/)",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/skick1234/DisTube/issues"
-  },
-  "funding": {
-    "url": "https://patreon.com/DisTube"
-  },
-  "homepage": "https://distube.js.org/",
-  "dependencies": {
-    "@distube/youtube-dl": "^2.0.0",
-    "@distube/ytdl": "^2.0.5",
-    "@distube/ytpl": "^1.0.11",
-    "@distube/ytsr": "^1.0.9",
-    "ytdl-core": "^4.5.0"
-  },
-  "devDependencies": {
-    "@discordjs/opus": "^0.5.0",
-    "@types/node": "^15.0.1",
-    "discord.js": "github:discordjs/discord.js",
-    "discord.js-docgen": "github:distubejs/docgen",
-    "eslint": "^7.25.0",
-    "eslint-plugin-jsdoc": "^33.0.0",
-    "typescript": "^4.2.4"
-  },
-  "peerDependencies": {
-    "@discordjs/opus": "*",
-    "discord.js": "12.x"
-  },
-  "engines": {
-    "node": ">=12"
-  }
-}
+{
+  "name": "distube",
+  "version": "3.0.2",
+  "description": "A Discord.js module to simplify your music commands and play songs with audio filters on Discord without any API key. Support YouTube, SoundCloud, Bandcamp, Facebook, and 700+ more sites",
+  "main": "dist/index.js",
+  "typings": "dist/index.d.ts",
+  "scripts": {
+    "test": "jest --config .jestrc.json",
+    "docs": "docgen -s src/*.ts src/**/*.ts -o docs/docs.json -c pages/index.yml -g -j .jsconfig.json",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "prettier": "prettier --write **/*.{js,ts,json,yml,yaml}",
+    "build": "tsc",
+    "build:check": "tsc --noEmit --incremental false",
+    "publish:stable": "npm publish",
+    "ncu": "ncu -u --dep dev,prod",
+    "_postinstall": "husky install",
+    "prepublishOnly": "pinst -d",
+    "postpublish": "pinst -e"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/skick1234/DisTube.git"
+  },
+  "keywords": [
+    "youtube",
+    "music",
+    "discord",
+    "discordjs",
+    "bot",
+    "distube",
+    "queue",
+    "musicbot",
+    "discord-music-bot",
+    "music-bot",
+    "discord-js"
+  ],
+  "author": "Skick (https://github.com/skick1234/)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/skick1234/DisTube/issues"
+  },
+  "funding": {
+    "url": "https://patreon.com/DisTube"
+  },
+  "homepage": "https://distube.js.org/",
+  "dependencies": {
+    "@distube/youtube-dl": "^2.2.4",
+    "@distube/ytdl-core": "^4.9.3",
+    "@distube/ytpl": "^1.1.1",
+    "@distube/ytsr": "^1.1.5",
+    "prism-media": "https://codeload.github.com/distubejs/prism-media/tar.gz/main",
+    "tiny-typed-emitter": "^2.1.0"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.16.0",
+    "@babel/plugin-proposal-class-properties": "^7.16.0",
+    "@babel/plugin-proposal-object-rest-spread": "^7.16.0",
+    "@babel/preset-env": "^7.16.0",
+    "@babel/preset-typescript": "^7.16.0",
+    "@commitlint/cli": "^14.1.0",
+    "@commitlint/config-conventional": "^14.1.0",
+    "@discordjs/voice": "^0.7.2",
+    "@distube/docgen": "github:distubejs/docgen",
+    "@types/jest": "^27.0.2",
+    "@types/node": "^16.11.7",
+    "babel-jest": "^27.3.1",
+    "discord.js": "^13.3.1",
+    "eslint": "^7.32.0",
+    "eslint-config-distube": "^1.4.0",
+    "husky": "^7.0.4",
+    "jest": "^27.3.1",
+    "jsdoc-babel": "^0.5.0",
+    "lint-staged": "^11.2.6",
+    "npm-check-updates": "^12.0.2",
+    "pinst": "^2.1.6",
+    "prettier": "^2.4.1",
+    "typescript": "^4.4.4"
+  },
+  "peerDependencies": {
+    "@discordjs/opus": "*",
+    "@discordjs/voice": ">=0.5.6",
+    "discord.js": "^12.5.0||13.x"
+  },
+  "engines": {
+    "node": ">=12.0.0"
+  }
+}