distube 4.0.4 → 4.0.6

package/README.md

@@ -3,7 +3,7 @@
     <a href="https://www.npmjs.com/package/distube" target="_blank"><img src="https://nodei.co/npm/distube.png?downloads=true&downloadRank=true&stars=true"></a>
   </p>
   <p>
-    <a href="https://github.com/skick1234/DisTube/actions" target="_blank"><img alt="GitHub Workflow Status" src="https://img.shields.io/github/workflow/status/skick1234/DisTube/Testing?label=Tests&logo=github&style=flat-square"></a>
+    <a href="https://github.com/skick1234/DisTube/actions" target="_blank"><img alt="GitHub Workflow Status" src="https://img.shields.io/github/actions/workflow/status/skick1234/DisTube/test.yml?branch=main&label=Tests&logo=github&style=flat-square"></a>
     <a href="https://nodejs.org/" target="_blank"><img alt="node-current" src="https://img.shields.io/node/v/distube?logo=node.js&logoColor=white&style=flat-square"></a>
     <a href="https://discord.js.org/" target="_blank"><img alt="npm peer dependency version" src="https://img.shields.io/npm/dependency-version/distube/peer/discord.js?label=discord.js&logo=discord&logoColor=white&style=flat-square"></a>
     <a href="https://depfu.com/github/skick1234/DisTube?project_id=36112" target="_blank"><img alt="Depfu" src="https://img.shields.io/depfu/dependencies/github/skick1234/DisTube?style=flat-square"></a>
@@ -49,14 +49,9 @@ npm install distube@latest
 
 Read DisTube's definitions, properties and events details in the [Documentation page](https://distube.js.org/).
 
+Learn how to build a music bot from scratch with [DisTube Guide](https://distube.js.org/guide)
+
 ## Example Bot
 
 - [DisTube Bot](https://skick.xyz/DisTube) - A music bot with reaction controller, filters, DJ mode, user's custom playlist and voting.
 - [DisTube Example](https://github.com/distubejs/example) - Example bot with simple command handler.
-- [DisTube Guide](https://distube.js.org/guide) - How to build a music bot from scratch.
-
-## Dependencies
-
-- [node-ytdl-core](https://github.com/fent/node-ytdl-core): YouTube scraper ([DisTube Fork](https://github.com/distubejs/node-ytdl-core))
-- [node-ytsr](https://github.com/TimeForANinja/node-ytsr): YouTube search scraper ([DisTube Fork](https://github.com/distubejs/ytsr))
-- [node-ytpl](https://github.com/TimeForANinja/node-ytpl): YouTube playlist resolver ([DisTube Fork](https://github.com/distubejs/ytpl))

package/dist/index.d.ts

@@ -8,13 +8,13 @@ import { AudioPlayer, VoiceConnection, AudioResource, StreamType as StreamType$1
 import { FFmpeg } from 'prism-media';
 import * as _discordjs_collection from '@discordjs/collection';
 
-declare type Awaitable<T = any> = T | PromiseLike<T>;
-declare type DisTubeVoiceEvents = {
+type Awaitable<T = any> = T | PromiseLike<T>;
+type DisTubeVoiceEvents = {
     disconnect: (error?: Error) => Awaitable;
     error: (error: Error) => Awaitable;
     finish: () => Awaitable;
 };
-declare type DisTubeEvents = {
+type DisTubeEvents = {
     error: [channel: GuildTextBasedChannel | undefined, error: Error];
     addList: [queue: Queue, playlist: Playlist];
     addSong: [queue: Queue, song: Song];
@@ -32,15 +32,15 @@ declare type DisTubeEvents = {
     searchInvalidAnswer: [message: Message<true>, answer: Message<true>, query: string];
     searchResult: [message: Message<true>, results: SearchResult[], query: string];
 };
-declare type TypedDisTubeEvents = {
+type TypedDisTubeEvents = {
     [K in keyof DisTubeEvents]: (...args: DisTubeEvents[K]) => Awaitable;
 };
 interface Filter {
     name: string;
     value: string;
 }
-declare type FilterResolvable = string | Filter;
-declare type Filters = Record<string, string>;
+type FilterResolvable = string | Filter;
+type Filters = Record<string, string>;
 interface DisTubeOptions {
     plugins?: (CustomPlugin | ExtractorPlugin)[];
     emitNewSongOnly?: boolean;
@@ -62,7 +62,7 @@ interface DisTubeOptions {
     streamType?: StreamType;
     directLink?: boolean;
 }
-declare type GuildIdResolvable = Queue | DisTubeVoice | Snowflake | Message | GuildTextBasedChannel | VoiceBasedChannel | VoiceState | Guild | GuildMember | Interaction | string;
+type GuildIdResolvable = Queue | DisTubeVoice | Snowflake | Message | GuildTextBasedChannel | VoiceBasedChannel | VoiceState | Guild | GuildMember | Interaction | string;
 interface OtherSongInfo {
     src: string;
     id?: string;
@@ -107,8 +107,8 @@ interface PlaylistInfo {
     title?: string;
     webpage_url?: string;
 }
-declare type RelatedSong = Omit<Song, "related">;
-declare type PlayHandlerOptions = {
+type RelatedSong = Omit<Song, "related">;
+type PlayHandlerOptions = {
     skip?: boolean;
     position?: number;
     textChannel?: GuildTextBasedChannel;
@@ -224,12 +224,12 @@ declare const ERROR_MESSAGES: {
     EMPTY_FILTERED_PLAYLIST: string;
     EMPTY_PLAYLIST: string;
 };
-declare type ErrorMessage = typeof ERROR_MESSAGES;
-declare type ErrorCode = keyof ErrorMessage;
-declare type StaticErrorCode = {
+type ErrorMessage = typeof ERROR_MESSAGES;
+type ErrorCode = keyof ErrorMessage;
+type StaticErrorCode = {
     [K in ErrorCode]-?: ErrorMessage[K] extends string ? K : never;
 }[ErrorCode];
-declare type TemplateErrorCode = Exclude<keyof typeof ERROR_MESSAGES, StaticErrorCode>;
+type TemplateErrorCode = Exclude<keyof typeof ERROR_MESSAGES, StaticErrorCode>;
 declare class DisTubeError<T extends string> extends Error {
     errorCode: string;
     constructor(code: StaticErrorCode);
@@ -291,7 +291,7 @@ declare class SearchResultVideo extends ISearchResult {
     thumbnail: string;
     constructor(info: Video);
 }
-declare type SearchResult = SearchResultVideo | SearchResultPlaylist;
+type SearchResult = SearchResultVideo | SearchResultPlaylist;
 declare class SearchResultPlaylist extends ISearchResult {
     type: SearchResultType.PLAYLIST;
     length: number;
@@ -378,6 +378,22 @@ declare class DisTubeVoice extends TypedEmitter<DisTubeVoiceEvents> {
     get voiceState(): VoiceState | undefined;
 }
 
+interface StreamOptions {
+    seek?: number;
+    ffmpegArgs?: string[];
+    isLive?: boolean;
+    type?: StreamType;
+}
+declare const chooseBestVideoFormat: (formats: ytdl.videoFormat[], isLive?: boolean) => ytdl.videoFormat;
+declare class DisTubeStream {
+    static YouTube(formats: ytdl.videoFormat[] | undefined, options?: StreamOptions): DisTubeStream;
+    static DirectLink(url: string, options?: StreamOptions): DisTubeStream;
+    type: StreamType$1;
+    stream: FFmpeg;
+    url: string;
+    constructor(url: string, options: StreamOptions);
+}
+
 declare class DisTubeHandler extends DisTubeBase {
     constructor(distube: DisTube);
     get ytdlOptions(): ytdl.getInfoOptions;
@@ -395,6 +411,7 @@ declare class DisTubeHandler extends DisTubeBase {
     createSearchMessageCollector<R extends SearchResult | Song | Playlist>(message: Message<true>, results: Array<R>, query?: string): Promise<R | null>;
     playPlaylist(voiceChannel: VoiceBasedChannel, playlist: Playlist, options?: PlayHandlerOptions): Promise<void>;
     playSong(voiceChannel: VoiceBasedChannel, song: Song, options?: PlayHandlerOptions): Promise<void>;
+    attachStreamInfo(song: Song): Promise<void>;
 }
 
 declare class Options {
@@ -421,22 +438,6 @@ declare class Options {
     constructor(options: DisTubeOptions);
 }
 
-interface StreamOptions {
-    seek?: number;
-    ffmpegArgs?: string[];
-    isLive?: boolean;
-    type?: StreamType;
-}
-declare const chooseBestVideoFormat: (formats: ytdl.videoFormat[], isLive?: boolean) => ytdl.videoFormat;
-declare class DisTubeStream {
-    static YouTube(formats: ytdl.videoFormat[] | undefined, options?: StreamOptions): DisTubeStream;
-    static DirectLink(url: string, options?: StreamOptions): DisTubeStream;
-    type: StreamType$1;
-    stream: FFmpeg;
-    url: string;
-    constructor(url: string, options: StreamOptions);
-}
-
 declare abstract class BaseManager<V> extends DisTubeBase {
     collection: Collection<string, V>;
     get size(): number;
@@ -455,7 +456,7 @@ declare class DisTubeVoiceManager extends GuildIdManager<DisTubeVoice> {
     leave(guild: GuildIdResolvable): void;
 }
 
-declare class FilterManager extends BaseManager<FilterResolvable> {
+declare class FilterManager extends BaseManager<Filter> {
     #private;
     queue: Queue;
     constructor(queue: Queue);
@@ -465,7 +466,8 @@ declare class FilterManager extends BaseManager<FilterResolvable> {
     remove(filterOrFilters: FilterResolvable | FilterResolvable[]): this;
     has(filter: FilterResolvable): boolean;
     get names(): string[];
-    get values(): string[];
+    get values(): Filter[];
+    get ffmpegArgs(): string[];
     toString(): string;
 }
 
@@ -552,7 +554,8 @@ declare abstract class ExtractorPlugin extends Plugin {
 declare function formatDuration(sec: number): string;
 declare function toSecond(input: any): number;
 declare function parseNumber(input: any): number;
-declare function isURL(input: any): input is `http://${string}` | `https://${string}`;
+declare const SUPPORTED_PROTOCOL: readonly ["https:", "http:", "file:"];
+declare function isURL(input: any): input is `${(typeof SUPPORTED_PROTOCOL)[number]}//${string}`;
 declare function checkIntents(options: ClientOptions): void;
 declare function isVoiceChannelEmpty(voiceState: VoiceState): boolean;
 declare function isSnowflake(id: any): id is Snowflake;
@@ -566,8 +569,9 @@ declare function isClientInstance(client: any): client is Client;
 declare function checkInvalidKey(target: Record<string, any>, source: Record<string, any> | string[], sourceName: string): void;
 declare function isObject(obj: any): obj is object;
 declare function isRecord<T = unknown>(obj: any): obj is Record<string, T>;
-declare type KeyOf<T> = T extends object ? (keyof T)[] : [];
+type KeyOf<T> = T extends object ? (keyof T)[] : [];
 declare function objectKeys<T>(obj: T): KeyOf<T>;
+declare function isNsfwChannel(channel?: GuildTextBasedChannel): boolean;
 
 declare class DirectLinkPlugin extends ExtractorPlugin {
     validate(url: string): Promise<boolean>;
@@ -626,4 +630,4 @@ declare class DisTube extends TypedEmitter<TypedDisTubeEvents> {
     emitError(error: Error, channel?: GuildTextBasedChannel): void;
 }
 
-export { Awaitable, BaseManager, Chapter, CustomPlaylistOptions, CustomPlugin, DirectLinkPlugin, DisTube, DisTubeBase, DisTubeError, DisTubeEvents, DisTubeHandler, DisTubeOptions, DisTubeStream, DisTubeVoice, DisTubeVoiceEvents, DisTubeVoiceManager, Events, ExtractorPlugin, Filter, FilterManager, FilterResolvable, Filters, GuildIdManager, GuildIdResolvable, Options, OtherSongInfo, PlayHandlerOptions, PlayOptions, Playlist, PlaylistInfo, Plugin, PluginType, Queue, QueueManager, RelatedSong, RepeatMode, ResolveOptions, ResolvePlaylistOptions, SearchResult, SearchResultPlaylist, SearchResultType, SearchResultVideo, Song, StreamType, TaskQueue, TypedDisTubeEvents, checkIntents, checkInvalidKey, chooseBestVideoFormat, DisTube as default, defaultFilters, defaultOptions, formatDuration, isClientInstance, isGuildInstance, isMemberInstance, isMessageInstance, isObject, isRecord, isSnowflake, isSupportedVoiceChannel, isTextChannelInstance, isURL, isVoiceChannelEmpty, objectKeys, parseNumber, resolveGuildId, toSecond, version };
+export { Awaitable, BaseManager, Chapter, CustomPlaylistOptions, CustomPlugin, DirectLinkPlugin, DisTube, DisTubeBase, DisTubeError, DisTubeEvents, DisTubeHandler, DisTubeOptions, DisTubeStream, DisTubeVoice, DisTubeVoiceEvents, DisTubeVoiceManager, Events, ExtractorPlugin, Filter, FilterManager, FilterResolvable, Filters, GuildIdManager, GuildIdResolvable, Options, OtherSongInfo, PlayHandlerOptions, PlayOptions, Playlist, PlaylistInfo, Plugin, PluginType, Queue, QueueManager, RelatedSong, RepeatMode, ResolveOptions, ResolvePlaylistOptions, SearchResult, SearchResultPlaylist, SearchResultType, SearchResultVideo, Song, StreamType, TaskQueue, TypedDisTubeEvents, checkIntents, checkInvalidKey, chooseBestVideoFormat, DisTube as default, defaultFilters, defaultOptions, formatDuration, isClientInstance, isGuildInstance, isMemberInstance, isMessageInstance, isNsfwChannel, isObject, isRecord, isSnowflake, isSupportedVoiceChannel, isTextChannelInstance, isURL, isVoiceChannelEmpty, objectKeys, parseNumber, resolveGuildId, toSecond, version };