discord-player 6.8.0-dev.0 → 6.8.0-dev.1

package/dist/index.d.ts

@@ -963,6 +963,7 @@ interface GuildNodeInit<Meta = unknown> {
     disableFilterer: boolean;
     disableBiquad: boolean;
     disableResampler: boolean;
+    disableFallbackStream: boolean;
 }
 interface VoiceConnectConfig {
     deaf?: boolean;
@@ -1606,6 +1607,8 @@ declare class Track<T = unknown> {
     private __reqMetadataFn;
     cleanTitle: string;
     live: boolean;
+    bridgedExtractor: BaseExtractor | null;
+    bridgedTrack: Track | null;
     /**
      * Track constructor
      * @param player The player that instantiated this Track
@@ -1776,10 +1779,165 @@ declare class Playlist {
     play<T = unknown>(channel: GuildVoiceChannelResolvable, options?: PlayerNodeInitializerOptions<T>): Promise<PlayerNodeInitializationResult<T>>;
 }
 
+type unsafe = any;
+/**
+ * The receiver function that will be called when the context is provided
+ */
+type ContextReceiver<R> = () => R;
+declare class Context<T> {
+    private defaultValue?;
+    private storage;
+    constructor(defaultValue?: T | undefined);
+    /**
+     * Exit out of this context
+     */
+    exit(scope: ContextReceiver<void>): void;
+    /**
+     * Whether the context is lost
+     */
+    get isLost(): boolean;
+    /**
+     * Get the current value of the context. If the context is lost and no default value is provided, undefined will be returned.
+     */
+    consume(): T | undefined;
+    /**
+     * Run a function within the context of this provider
+     */
+    provide<R = unsafe>(value: T, receiver: ContextReceiver<R>): R;
+}
+/**
+ * Create a new context. The default value is optional.
+ * @param defaultValue The default value of the context
+ * @example const userContext = createContext();
+ *
+ *  // the value to provide
+ *  const user = {
+ *   id: 1,
+ *   name: 'John Doe'
+ *  };
+ *
+ *  // provide the context value to the receiver
+ *  context.provide(user, handler);
+ *
+ *  function handler() {
+ *    // get the context value
+ *    const { id, name } = useContext(context);
+ *
+ *    console.log(id, name); // 1, John Doe
+ *  }
+ */
+declare function createContext<T = unsafe>(defaultValue?: T): Context<T>;
+/**
+ * Get the current value of the context. If the context is lost and no default value is provided, undefined will be returned.
+ * @param context The context to get the value from
+ * @example const value = useContext(context);
+ */
+declare function useContext<T = unsafe>(context: Context<T>): T | undefined;
+
+/**
+ * Fetch guild queue history
+ * @param node guild queue node resolvable
+ */
+declare function useHistory<Meta = unknown>(): GuildQueueHistory<Meta> | null;
+declare function useHistory<Meta = unknown>(node: NodeResolvable): GuildQueueHistory<Meta> | null;
+
+/**
+ * Fetch guild queue player node
+ * @param node Guild queue node resolvable
+ */
+declare function usePlayer<Meta = unknown>(): GuildQueuePlayerNode<Meta> | null;
+declare function usePlayer<Meta = unknown>(node: NodeResolvable): GuildQueuePlayerNode<Meta> | null;
+
+/**
+ * Fetch guild queue
+ * @param node Guild queue node resolvable
+ */
+declare function useQueue<Meta = unknown>(): GuildQueue<Meta> | null;
+declare function useQueue<Meta = unknown>(node: NodeResolvable): GuildQueue<Meta> | null;
+
+/**
+ * Fetch main player instance
+ * @deprecated
+ */
+declare function useMasterPlayer(): Player;
+/**
+ * Fetch main player instance
+ */
+declare function useMainPlayer(): Player;
+
+type SetterFN$1<T, P> = (previous: P) => T;
+type MetadataDispatch<T> = readonly [() => T, (metadata: T | SetterFN$1<T, T>) => void];
+/**
+ * Fetch or manipulate guild queue metadata
+ * @param node Guild queue node resolvable
+ */
+declare function useMetadata<T = unknown>(): MetadataDispatch<T>;
+declare function useMetadata<T = unknown>(node: NodeResolvable): MetadataDispatch<T>;
+
+interface TimelineDispatcherOptions {
+    ignoreFilters: boolean;
+}
+/**
+ * Fetch or manipulate current track
+ * @param node Guild queue node resolvable
+ * @param options Options for timeline dispatcher
+ */
+declare function useTimeline(node?: NodeResolvable, options?: Partial<TimelineDispatcherOptions>): {
+    readonly timestamp: PlayerTimestamp;
+    readonly volume: number;
+    readonly paused: boolean;
+    readonly track: Track<unknown> | null;
+    pause(): boolean;
+    resume(): boolean;
+    setVolume(vol: number): boolean;
+    setPosition(time: number): Promise<boolean>;
+} | null;
+
+/**
+ * Global onAfterCreateStream handler
+ * @param handler The handler callback
+ */
+declare function onAfterCreateStream(handler: OnAfterCreateStreamHandler): void;
+
+/**
+ * Global onBeforeCreateStream handler
+ * @param handler The handler callback
+ */
+declare function onBeforeCreateStream(handler: OnBeforeCreateStreamHandler): void;
+
+type SetterFN = (previous: number) => number;
+type VolumeDispatch = readonly [() => number, (volume: number | SetterFN) => boolean | undefined];
+/**
+ * Fetch or manipulate player volume
+ * @param node Guild queue node resolvable
+ */
+declare function useVolume(): VolumeDispatch;
+declare function useVolume(node: NodeResolvable): VolumeDispatch;
+
+declare const instances: Collection<string, Player>;
+
+declare const getPlayer: () => Player | null;
+interface HooksCtx {
+    guild: Guild;
+}
+declare const getQueue: <T = unknown>(node: NodeResolvable) => GuildQueue<T> | null;
+interface HookDeclarationContext {
+    getQueue: typeof getQueue;
+    getPlayer: typeof getPlayer;
+    instances: typeof instances;
+}
+type HookDeclaration<T extends (...args: any[]) => any> = (context: HookDeclarationContext) => T;
+declare function createHook<T extends HookDeclaration<(...args: any[]) => any>>(hook: T): ReturnType<T>;
+
 declare const knownExtractorKeys: readonly ["SpotifyExtractor", "AppleMusicExtractor", "SoundCloudExtractor", "YouTubeExtractor", "VimeoExtractor", "ReverbnationExtractor", "AttachmentExtractor"];
 type ExtractorLoaderOptionDict = {
     [K in (typeof knownExtractorKeys)[number]]?: ConstructorParameters<typeof _discord_player_extractor[K]>[1];
 };
+interface ExtractorSession {
+    id: string;
+    attemptedExtractors: Set<string>;
+    bridgeAttemptedExtractors: Set<string>;
+}
 interface ExtractorExecutionEvents {
     /**
      * Emitted when a extractor is registered
@@ -1818,7 +1976,16 @@ declare class ExtractorExecutionContext extends PlayerEventsEmitter<ExtractorExe
      * The extractors store
      */
     store: Collection<string, BaseExtractor<object>>;
+    readonly context: Context<ExtractorSession>;
     constructor(player: Player);
+    /**
+     * Get the current execution id
+     */
+    getExecutionId(): string | null;
+    /**
+     * Get the current execution context
+     */
+    getContext(): ExtractorSession | null;
     /**
      * Load default extractors from `@discord-player/extractor`
      */
@@ -1869,7 +2036,7 @@ declare class ExtractorExecutionContext extends PlayerEventsEmitter<ExtractorExe
      * @param track The track to request bridge for
      * @param sourceExtractor The source extractor of the track
      */
-    requestBridge(track: Track, sourceExtractor?: BaseExtractor | null): Promise<ExtractorExecutionResult<false> | ExtractorExecutionResult<ExtractorStreamable> | undefined>;
+    requestBridge(track: Track, sourceExtractor?: BaseExtractor | null): Promise<ExtractorExecutionResult<ExtractorStreamable>>;
     /**
      * Request bridge from the specified extractor
      * @param track The track to request bridge for
@@ -2212,156 +2379,6 @@ declare class IPRotator {
     static getRandomIP(address: string, start?: number, end?: number): string;
 }
 
-type unsafe = any;
-/**
- * The receiver function that will be called when the context is provided
- */
-type ContextReceiver<R> = () => R;
-declare class Context<T> {
-    private defaultValue?;
-    private storage;
-    constructor(defaultValue?: T | undefined);
-    /**
-     * Exit out of this context
-     */
-    exit(scope: ContextReceiver<void>): void;
-    /**
-     * Whether the context is lost
-     */
-    get isLost(): boolean;
-    /**
-     * Get the current value of the context. If the context is lost and no default value is provided, undefined will be returned.
-     */
-    consume(): T | undefined;
-    /**
-     * Run a function within the context of this provider
-     */
-    provide<R = unsafe>(value: T, receiver: ContextReceiver<R>): R;
-}
-/**
- * Create a new context. The default value is optional.
- * @param defaultValue The default value of the context
- * @example const userContext = createContext();
- *
- *  // the value to provide
- *  const user = {
- *   id: 1,
- *   name: 'John Doe'
- *  };
- *
- *  // provide the context value to the receiver
- *  context.provide(user, handler);
- *
- *  function handler() {
- *    // get the context value
- *    const { id, name } = useContext(context);
- *
- *    console.log(id, name); // 1, John Doe
- *  }
- */
-declare function createContext<T = unsafe>(defaultValue?: T): Context<T>;
-/**
- * Get the current value of the context. If the context is lost and no default value is provided, undefined will be returned.
- * @param context The context to get the value from
- * @example const value = useContext(context);
- */
-declare function useContext<T = unsafe>(context: Context<T>): T | undefined;
-
-/**
- * Fetch guild queue history
- * @param node guild queue node resolvable
- */
-declare function useHistory<Meta = unknown>(): GuildQueueHistory<Meta> | null;
-declare function useHistory<Meta = unknown>(node: NodeResolvable): GuildQueueHistory<Meta> | null;
-
-/**
- * Fetch guild queue player node
- * @param node Guild queue node resolvable
- */
-declare function usePlayer<Meta = unknown>(): GuildQueuePlayerNode<Meta> | null;
-declare function usePlayer<Meta = unknown>(node: NodeResolvable): GuildQueuePlayerNode<Meta> | null;
-
-/**
- * Fetch guild queue
- * @param node Guild queue node resolvable
- */
-declare function useQueue<Meta = unknown>(): GuildQueue<Meta> | null;
-declare function useQueue<Meta = unknown>(node: NodeResolvable): GuildQueue<Meta> | null;
-
-/**
- * Fetch main player instance
- * @deprecated
- */
-declare function useMasterPlayer(): Player;
-/**
- * Fetch main player instance
- */
-declare function useMainPlayer(): Player;
-
-type SetterFN$1<T, P> = (previous: P) => T;
-type MetadataDispatch<T> = readonly [() => T, (metadata: T | SetterFN$1<T, T>) => void];
-/**
- * Fetch or manipulate guild queue metadata
- * @param node Guild queue node resolvable
- */
-declare function useMetadata<T = unknown>(): MetadataDispatch<T>;
-declare function useMetadata<T = unknown>(node: NodeResolvable): MetadataDispatch<T>;
-
-interface TimelineDispatcherOptions {
-    ignoreFilters: boolean;
-}
-/**
- * Fetch or manipulate current track
- * @param node Guild queue node resolvable
- * @param options Options for timeline dispatcher
- */
-declare function useTimeline(node?: NodeResolvable, options?: Partial<TimelineDispatcherOptions>): {
-    readonly timestamp: PlayerTimestamp;
-    readonly volume: number;
-    readonly paused: boolean;
-    readonly track: Track<unknown> | null;
-    pause(): boolean;
-    resume(): boolean;
-    setVolume(vol: number): boolean;
-    setPosition(time: number): Promise<boolean>;
-} | null;
-
-/**
- * Global onAfterCreateStream handler
- * @param handler The handler callback
- */
-declare function onAfterCreateStream(handler: OnAfterCreateStreamHandler): void;
-
-/**
- * Global onBeforeCreateStream handler
- * @param handler The handler callback
- */
-declare function onBeforeCreateStream(handler: OnBeforeCreateStreamHandler): void;
-
-type SetterFN = (previous: number) => number;
-type VolumeDispatch = readonly [() => number, (volume: number | SetterFN) => boolean | undefined];
-/**
- * Fetch or manipulate player volume
- * @param node Guild queue node resolvable
- */
-declare function useVolume(): VolumeDispatch;
-declare function useVolume(node: NodeResolvable): VolumeDispatch;
-
-declare const instances: Collection<string, Player>;
-
-declare const getPlayer: () => Player | null;
-interface HooksCtx {
-    guild: Guild;
-}
-declare const getQueue: <T = unknown>(node: NodeResolvable) => GuildQueue<T> | null;
-interface HookDeclarationContext {
-    getQueue: typeof getQueue;
-    getPlayer: typeof getPlayer;
-    instances: typeof instances;
-}
-type HookDeclaration<T extends (...args: any[]) => any> = (context: HookDeclarationContext) => T;
-declare function createHook<T extends HookDeclaration<(...args: any[]) => any>>(hook: T): ReturnType<T>;
-
 interface PlayerNodeInitializationResult<T = unknown> {
     track: Track;
     extractor: BaseExtractor | null;
@@ -2621,6 +2638,7 @@ interface GuildNodeCreateOptions<T = unknown> {
     disableFilterer?: boolean;
     disableBiquad?: boolean;
     disableResampler?: boolean;
+    disableFallbackStream?: boolean;
 }
 type NodeResolvable = GuildQueue | GuildResolvable;
 declare class GuildNodeManager<Meta = unknown> {
@@ -3343,4 +3361,4 @@ declare class QueryResolver {
 
 declare const version: string;
 
-export { AFilterGraph, AsyncQueue, AsyncQueueAcquisitionOptions, AsyncQueueEntry, AsyncQueueExceptionHandler, AudioFilters, BaseExtractor, Context, ContextReceiver, CreateStreamOps, DiscordPlayerQueryResultCache, Encodable, EqualizerConfigurationPreset, ExtractorExecutionContext, ExtractorExecutionEvents, ExtractorExecutionFN, ExtractorExecutionResult, ExtractorInfo, ExtractorLoaderOptionDict, ExtractorResolvable, ExtractorSearchContext, ExtractorStreamable, FFMPEG_ARGS_PIPED, FFMPEG_ARGS_STRING, FFMPEG_SRATE_REGEX, FFmpegFilterer, FFmpegStreamOptions, FilterGraph, FiltersName, GuildNodeCreateOptions, GuildNodeInit, GuildNodeManager, GuildQueue, GuildQueueAFiltersCache, GuildQueueAudioFilters, GuildQueueEvent, GuildQueueEvents, GuildQueueHistory, GuildQueuePlayerNode, GuildQueueStatistics, GuildQueueStatisticsMetadata, HookDeclaration, HookDeclarationContext, IPBlock, IPRotationConfig, IPRotator, LrcGetParams, LrcGetResult, LrcLib, LrcSearchParams, LrcSearchResult, MetadataDispatch, NextFunction, NodeResolvable, OnAfterCreateStreamHandler, OnBeforeCreateStreamHandler, PlayOptions, Player, PlayerEvent, PlayerEvents, PlayerEventsEmitter, PlayerInitOptions, PlayerNodeInitializationResult, PlayerNodeInitializerOptions, PlayerProgressbarOptions, PlayerSearchResult, PlayerTimestamp, PlayerTriggeredReason, Playlist, PlaylistInitData, PlaylistJSON, PostProcessedResult, QueryCache, QueryCacheOptions, QueryCacheProvider, QueryCacheResolverContext, QueryExtractorSearch, QueryResolver, QueryType, QueueFilters, QueueRepeatMode, RawTrackData, RawTrackInit, RequestEntity, ResolvedQuery, ResourcePlayOptions, Runtime, RuntimeType, SearchOptions, SearchQueryType, SearchResult, SearchResultData, SequentialBucket, SerializedPlaylist, SerializedTrack, SerializedType, SetterFN$1 as SetterFN, SkipOptions, StreamConfig, StreamDispatcher, TimeData, TimelineDispatcherOptions, Track, TrackJSON, TrackLike, TrackResolvable, TrackSkipReason, TrackSource, TypeUtil, Util, VALIDATE_QUEUE_CAP, VoiceConnectConfig, VoiceEvents, VoiceReceiverNode, VoiceReceiverOptions, VoiceStateHandler, VoiceUtils, WithMetadata, createContext, createErisCompat, createFFmpegStream, createHook, decode, deserialize, encode, isErisProxy, onAfterCreateStream, onBeforeCreateStream, serialize, tryIntoThumbnailString, useContext, useHistory, useMainPlayer, useMasterPlayer, useMetadata, usePlayer, useQueue, useTimeline, useVolume, version };
+export { AFilterGraph, AsyncQueue, AsyncQueueAcquisitionOptions, AsyncQueueEntry, AsyncQueueExceptionHandler, AudioFilters, BaseExtractor, Context, ContextReceiver, CreateStreamOps, DiscordPlayerQueryResultCache, Encodable, EqualizerConfigurationPreset, ExtractorExecutionContext, ExtractorExecutionEvents, ExtractorExecutionFN, ExtractorExecutionResult, ExtractorInfo, ExtractorLoaderOptionDict, ExtractorResolvable, ExtractorSearchContext, ExtractorSession, ExtractorStreamable, FFMPEG_ARGS_PIPED, FFMPEG_ARGS_STRING, FFMPEG_SRATE_REGEX, FFmpegFilterer, FFmpegStreamOptions, FilterGraph, FiltersName, GuildNodeCreateOptions, GuildNodeInit, GuildNodeManager, GuildQueue, GuildQueueAFiltersCache, GuildQueueAudioFilters, GuildQueueEvent, GuildQueueEvents, GuildQueueHistory, GuildQueuePlayerNode, GuildQueueStatistics, GuildQueueStatisticsMetadata, HookDeclaration, HookDeclarationContext, IPBlock, IPRotationConfig, IPRotator, LrcGetParams, LrcGetResult, LrcLib, LrcSearchParams, LrcSearchResult, MetadataDispatch, NextFunction, NodeResolvable, OnAfterCreateStreamHandler, OnBeforeCreateStreamHandler, PlayOptions, Player, PlayerEvent, PlayerEvents, PlayerEventsEmitter, PlayerInitOptions, PlayerNodeInitializationResult, PlayerNodeInitializerOptions, PlayerProgressbarOptions, PlayerSearchResult, PlayerTimestamp, PlayerTriggeredReason, Playlist, PlaylistInitData, PlaylistJSON, PostProcessedResult, QueryCache, QueryCacheOptions, QueryCacheProvider, QueryCacheResolverContext, QueryExtractorSearch, QueryResolver, QueryType, QueueFilters, QueueRepeatMode, RawTrackData, RawTrackInit, RequestEntity, ResolvedQuery, ResourcePlayOptions, Runtime, RuntimeType, SearchOptions, SearchQueryType, SearchResult, SearchResultData, SequentialBucket, SerializedPlaylist, SerializedTrack, SerializedType, SetterFN$1 as SetterFN, SkipOptions, StreamConfig, StreamDispatcher, TimeData, TimelineDispatcherOptions, Track, TrackJSON, TrackLike, TrackResolvable, TrackSkipReason, TrackSource, TypeUtil, Util, VALIDATE_QUEUE_CAP, VoiceConnectConfig, VoiceEvents, VoiceReceiverNode, VoiceReceiverOptions, VoiceStateHandler, VoiceUtils, WithMetadata, createContext, createErisCompat, createFFmpegStream, createHook, decode, deserialize, encode, isErisProxy, onAfterCreateStream, onBeforeCreateStream, serialize, tryIntoThumbnailString, useContext, useHistory, useMainPlayer, useMasterPlayer, useMetadata, usePlayer, useQueue, useTimeline, useVolume, version };