@flowplayer/player 3.11.1 → 3.11.2-rc.1

package/plugins/chromecast.d.ts

@@ -0,0 +1,366 @@
+import type { MediaKeyFunc } from 'hls.js';
+
+declare type AnyPlugin<PluginOwnConfig extends KeyValue> = Plugin_2<PluginOwnConfig> | Loader<PluginOwnConfig>;
+
+declare namespace apps {
+    export {
+        STABLE,
+        CANARY,
+        LOCAL
+    }
+}
+
+declare type ArrayToIntersection<T extends Array<unknown>> = T extends [infer Current, ...infer Remaining] ? Current & ArrayToIntersection<Remaining> : unknown;
+
+declare enum AutoplayOpts {
+    OFF = 0,
+    ON = 1,
+    AUDIO_REQUIRED = 2
+}
+
+declare type BitOpts = number;
+
+declare const CANARY = "6F71FA7C";
+
+declare const CAST_AVAILABLE = "chromecast:available";
+
+declare const CAST_FIELD_UPDATE = "chromecast:field:update";
+
+declare const CAST_IDLE = "chromecast:idle";
+
+declare const CAST_MEDIA_LOAD_REQUEST = "chromecast:media";
+
+declare const CAST_SESSION_CHANGED = "chromecast:session:changed";
+
+declare const CAST_START_CASTING = "chromecast:start";
+
+declare const CAST_STATE_CHANGED = "chromecast:state:changed";
+
+declare const CAST_UNAVAILABLE = "chromecast:unavailable";
+
+declare namespace CastEvents {
+    export {
+        CAST_AVAILABLE,
+        CAST_UNAVAILABLE,
+        CAST_START_CASTING,
+        CAST_IDLE,
+        CAST_STATE_CHANGED,
+        CAST_SESSION_CHANGED,
+        CAST_FIELD_UPDATE,
+        CAST_MEDIA_LOAD_REQUEST
+    }
+}
+
+declare type ChromecastConfig = ConfigWith<{
+    chromecast?: ChromecastConfigObject;
+}>;
+
+declare interface ChromecastConfigObject {
+    crossOrigin?: boolean;
+    app?: string;
+}
+
+declare class ChromecastPlugin implements Plugin_2 {
+    static apps: typeof apps;
+    static events: typeof CastEvents;
+    flowplayer: FlowplayerUMD;
+    constructor(flowplayer: FlowplayerUMD);
+    init(config: ChromecastConfig, root: PlayerRoot, video: ChromePlayer): void;
+    reset_state(video: ChromePlayer): void;
+}
+
+declare type ChromePlayer = PlayerWith<{
+    chromecast: ChromecastPlugin;
+    sender?: Sender;
+    currentSessionTime: number;
+}>;
+
+declare type Component = {
+    onrender?: (config: Config, root: PlayerRoot, player: Player) => void;
+    onremove?: (config: Config, root: PlayerRoot, player: Player) => void;
+};
+
+declare interface Components {
+    render(key: string, args: any[]): void;
+    remove(key: string, args: any[]): void;
+    put(key: string, args: Component): void;
+}
+
+declare interface Config {
+    src?: UnsafeSource;
+    preload?: "none" | "metadata" | "auto";
+    controls?: boolean;
+    lang?: string;
+    start_time?: number;
+    autopause?: boolean;
+    rewind?: boolean;
+    loop?: boolean;
+    seamless?: boolean;
+    retry?: boolean;
+    autoplay?: BitOpts;
+    start_quality?: BitOpts;
+    live?: boolean;
+    poster?: string;
+    disabled?: boolean;
+    muted?: boolean;
+    /**
+     * is src handled by one of plugins loaders
+     */
+    is_native?: boolean;
+    /**
+     * bitflags for UI options
+     */
+    ui?: BitOpts;
+    /**
+     * your user access token
+     */
+    token?: string;
+    /**
+     * manually configured duration for pre-rendering usually
+     */
+    duration?: number;
+    /**
+     * can the content be seeked to any position
+     */
+    seekable?: boolean;
+    multiplay?: boolean;
+    ratio?: number | string;
+    logo?: string;
+    logo_href?: string;
+    logo_alt_text?: string;
+    title?: string;
+    description?: string;
+    /**
+     * the number of seconds to have in the buffer before dvr is activated
+     */
+    seconds_to_dvr?: number;
+}
+
+declare namespace Configs {
+    export {
+        BitOpts,
+        FlowplayerCustomElementRegistry,
+        Config,
+        CustomConfig,
+        PluginConfig
+    }
+}
+
+declare type ConfigWith<T> = Configs.Config & T;
+
+declare type CustomConfig<T> = Config & T;
+
+declare const _default: typeof ChromecastPlugin;
+export default _default;
+
+declare type DeviceId = string;
+
+declare type DRM_KEYSYSTEM = "com.widevine.alpha" | "com.microsoft.playready" | "org.w3.clearkey" | "com.apple.fps.1_0";
+
+declare type DRMConfiguration = {
+    license_server: string;
+    http_headers?: Record<string, string>;
+    certificate?: string;
+    vendor?: string | DRMVendorImplementation;
+    request_media_key_system_access_function?: MediaKeyFunc;
+    query_params?: Record<string, string>;
+};
+
+declare type DRMSourceConfiguration = {
+    [keysystem in DRM_KEYSYSTEM]?: DRMConfiguration;
+};
+
+declare type DRMVendorImplementation = {
+    fairplay_fetch_certificate: (url: string, cb: (certificate_data: Uint8Array) => void) => void;
+    fairplay_request_license: (url: string, params: {
+        message: any;
+        assetId: string;
+    }, cb: (license_data: Uint8Array) => void) => void;
+};
+
+declare type FlowplayerCustomElementRegistry = Map<string, string>;
+
+declare interface FlowplayerUMD extends FlowplayerUMDBase {
+    (selector: string, config?: Config): Player;
+    (element: HTMLElement, config?: Config): Player;
+    <T>(selector: string, config?: CustomConfig<T>): Player;
+    <T>(element: HTMLElement, config?: CustomConfig<T>): Player;
+    <PluginCtors extends PluginCtor[]>(...plugins: PluginCtors): FlowplayerUMDWithPlugins<CustomConfig<MergeConfigs<PluginCtors>>>;
+}
+
+declare interface FlowplayerUMDBase {
+    instances: Player[];
+    extensions: PluginCtor[];
+    events: Record<string, string>;
+    ads?: {
+        events: Record<string, string>;
+    };
+    states: Record<string, string>;
+    quality: typeof QualityOpts;
+    commit: string;
+    version: string;
+    customElements: FlowplayerCustomElementRegistry;
+    defaultElements: Record<string, string>;
+    components: Components;
+    support: any;
+    autoplay: typeof AutoplayOpts;
+    jwt: any;
+    loaders: any;
+}
+
+declare interface FlowplayerUMDWithPlugins<ConfigWithPlugins extends Config = Config> extends FlowplayerUMDBase {
+    (selector: string, config?: ConfigWithPlugins): Player;
+    (element: HTMLElement, config?: ConfigWithPlugins): Player;
+}
+
+declare interface FPEvent<T> extends CustomEvent<T> {
+    /**
+     * @deprecated
+     the data attribute has been migrated to details to match the CustomEvent spec
+     more info: https://developer.mozilla.org/en-US/docs/Web/API/CustomEvent/CustomEvent
+     */
+    data?: T;
+}
+
+declare type JSONPlayer = any;
+
+declare type KeyValue = Record<string, any>;
+
+declare interface Loader<PluginOwnConfig extends KeyValue = KeyValue> extends Plugin_2<PluginOwnConfig> {
+    onload<T = KeyValue>(config: PluginConfig<T>, root: PlayerRoot, video: Player, src?: SourceObj): void;
+    wants<S = SourceObj, T = KeyValue>(srcString: SourceStr, srcObj: S, config: PluginConfig<T>): boolean;
+    wants<S = KeyValue, T = KeyValue>(srcString: SourceStr, srcObj: SourceWith<S>, config: PluginConfig<T>): boolean;
+}
+
+declare const LOCAL = "5258CA32";
+
+declare type MapToConfigs<Arr extends PluginCtor[]> = {
+    [PluginType in keyof Arr]: Arr[PluginType] extends PluginCtor<infer ConfigType> ? ConfigType : never;
+};
+
+declare type MergeConfigs<Arr extends PluginCtor[]> = ArrayToIntersection<MapToConfigs<Arr>>;
+
+declare interface Player extends HTMLVideoElement {
+    renderPlugin: (pluginContainer: HTMLElement) => void;
+    toggleDisable: (flag: boolean) => void;
+    original_src: string;
+    root: PlayerRoot;
+    playerState: Record<string, boolean>;
+    reaper: Map<string, any> | 0;
+    hasState(state: PlayerState): boolean;
+    transitionState(to: PlayerState, from: PlayerState, timer?: number): void;
+    togglePlay(on?: boolean): Promise<void>;
+    toggleFullScreen(on?: boolean, state_only?: boolean): void;
+    toggleMute(on?: boolean): void;
+    destroy(): void;
+    render(): void;
+    render(component: string, args: any[]): void;
+    createComponents(...args: string[]): HTMLElement[];
+    setOpts(config: Config): void;
+    setSrc(sources: UnsafeSource): Player;
+    on<T>(event: string | string[], handler: (e: FPEvent<T>) => void): Player;
+    once<T>(event: string, handler: (e: FPEvent<T>) => void): Player;
+    off<T>(event: string, handler: (e: FPEvent<T>) => void): Player;
+    poll<T>(event: string, data?: T): FPEvent<T>;
+    emit<T>(event: string, data?: T): Player;
+    setAttrs(attrs: Config): Player;
+    opt<T>(key: string, fallback?: T): T;
+    enqueueSeek(offset: number): any;
+    setState(state: string, flag: boolean): Player;
+    toJSON(): JSONPlayer;
+    i18n(k: string, fallback?: string): string;
+    deviceId(): DeviceId;
+    live_state: {
+        dvr?: boolean;
+        dvr_window?: number;
+    };
+    opts: Config;
+    plugins: Array<Plugin_2 | Loader>;
+    dvr_offset?: number;
+    message?: {
+        events: Record<string, string>;
+    };
+    disabled: boolean;
+    started?: boolean;
+    token: string;
+    tracks?: VideoTrack[];
+    _customElements: FlowplayerCustomElementRegistry;
+    _storage: Storage;
+}
+
+declare type PlayerRoot = HTMLElement & {
+    prevWidth?: number;
+};
+
+declare namespace Players {
+    export {
+        VideoTrack,
+        PlayerState,
+        FPEvent,
+        DeviceId,
+        JSONPlayer,
+        PlayerRoot,
+        Player
+    }
+}
+
+declare type PlayerState = string;
+
+declare type PlayerWith<T> = Players.Player & T;
+
+declare type PlayerWithSender = PlayerWith<{
+    sender?: Sender;
+}>;
+
+declare interface Plugin_2<PluginOwnConfig extends KeyValue = KeyValue> {
+    /**
+     * a plugin must always implement the init method so a player instance knows how to initialize it
+     */
+    init<T>(config: PluginConfig<T>, container: PlayerRoot, player: Player): void;
+    init(config: PluginConfig<PluginOwnConfig>, container: PlayerRoot, player: Player): void;
+}
+
+declare type PluginConfig<T> = Config & T;
+
+declare interface PluginCtor<PluginOwnConfig extends KeyValue = KeyValue> {
+    new (umd: FlowplayerUMD, player: Player): AnyPlugin<PluginOwnConfig>;
+}
+
+declare enum QualityOpts {
+    LOW = 1,
+    MEDIUM = 2,
+    HIGH = 4
+}
+
+declare class Sender {
+    video?: Player;
+    constructor(video: PlayerWithSender);
+    static of(video: PlayerWithSender): Sender;
+    static maybe(video: PlayerWithSender, cb: (sender: Sender, video: PlayerWithSender) => void): void;
+    static getEstimatedTime(): number | undefined;
+    static load(video: PlayerWithSender, instances: Player[]): void;
+    static destroy(sender: Sender): void;
+}
+
+declare type SourceObj = {
+    src?: SourceStr;
+    type?: string;
+    drm?: DRMSourceConfiguration;
+};
+
+declare type SourceStr = string;
+
+declare type SourceWith<T> = SourceObj & T;
+
+declare const STABLE = "940D4BE4";
+
+declare type UnsafeSource = SourceStr | SourceObj | Array<SourceStr | SourceObj>;
+
+declare interface VideoTrack {
+    name: string;
+    data: any;
+    default: boolean;
+    selected: boolean;
+}
+
+export { }

package/plugins/consent.d.ts

@@ -0,0 +1,305 @@
+import type { MediaKeyFunc } from 'hls.js';
+
+declare type AnyPlugin<PluginOwnConfig extends KeyValue> = Plugin_2<PluginOwnConfig> | Loader<PluginOwnConfig>;
+
+declare type ArrayToIntersection<T extends Array<unknown>> = T extends [infer Current, ...infer Remaining] ? Current & ArrayToIntersection<Remaining> : unknown;
+
+declare enum AutoplayOpts {
+    OFF = 0,
+    ON = 1,
+    AUDIO_REQUIRED = 2
+}
+
+declare type BitOpts = number;
+
+declare type Component = {
+    onrender?: (config: Config, root: PlayerRoot, player: Player) => void;
+    onremove?: (config: Config, root: PlayerRoot, player: Player) => void;
+};
+
+declare interface Components {
+    render(key: string, args: any[]): void;
+    remove(key: string, args: any[]): void;
+    put(key: string, args: Component): void;
+}
+
+declare interface Config {
+    src?: UnsafeSource;
+    preload?: "none" | "metadata" | "auto";
+    controls?: boolean;
+    lang?: string;
+    start_time?: number;
+    autopause?: boolean;
+    rewind?: boolean;
+    loop?: boolean;
+    seamless?: boolean;
+    retry?: boolean;
+    autoplay?: BitOpts;
+    start_quality?: BitOpts;
+    live?: boolean;
+    poster?: string;
+    disabled?: boolean;
+    muted?: boolean;
+    /**
+     * is src handled by one of plugins loaders
+     */
+    is_native?: boolean;
+    /**
+     * bitflags for UI options
+     */
+    ui?: BitOpts;
+    /**
+     * your user access token
+     */
+    token?: string;
+    /**
+     * manually configured duration for pre-rendering usually
+     */
+    duration?: number;
+    /**
+     * can the content be seeked to any position
+     */
+    seekable?: boolean;
+    multiplay?: boolean;
+    ratio?: number | string;
+    logo?: string;
+    logo_href?: string;
+    logo_alt_text?: string;
+    title?: string;
+    description?: string;
+    /**
+     * the number of seconds to have in the buffer before dvr is activated
+     */
+    seconds_to_dvr?: number;
+}
+
+declare namespace Configs {
+    export {
+        BitOpts,
+        FlowplayerCustomElementRegistry,
+        Config,
+        CustomConfig,
+        PluginConfig
+    }
+}
+
+declare type ConfigWith<T> = Configs.Config & T;
+
+declare type ConsentConfig = ConfigWith<{
+    consent?: number;
+}>;
+
+declare class ConsentPlugin implements Plugin_2 {
+    static tracking: typeof TrackingConfig;
+    static storage: typeof StorageConfig;
+    player: PlayerWithHealthAPI;
+    current_value: number;
+    constructor(_umd: FlowplayerUMD, player: Player);
+    init(config: ConsentConfig, _container: PlayerRoot, player: Player): void;
+    adapt(config: ConsentConfig): void;
+    setStorage(flag: StorageConfig): void;
+    setTracking(flag: TrackingConfig): void;
+}
+
+declare type CustomConfig<T> = Config & T;
+
+declare const _default: typeof ConsentPlugin;
+export default _default;
+
+declare type DeviceId = string;
+
+declare type DRM_KEYSYSTEM = "com.widevine.alpha" | "com.microsoft.playready" | "org.w3.clearkey" | "com.apple.fps.1_0";
+
+declare type DRMConfiguration = {
+    license_server: string;
+    http_headers?: Record<string, string>;
+    certificate?: string;
+    vendor?: string | DRMVendorImplementation;
+    request_media_key_system_access_function?: MediaKeyFunc;
+    query_params?: Record<string, string>;
+};
+
+declare type DRMSourceConfiguration = {
+    [keysystem in DRM_KEYSYSTEM]?: DRMConfiguration;
+};
+
+declare type DRMVendorImplementation = {
+    fairplay_fetch_certificate: (url: string, cb: (certificate_data: Uint8Array) => void) => void;
+    fairplay_request_license: (url: string, params: {
+        message: any;
+        assetId: string;
+    }, cb: (license_data: Uint8Array) => void) => void;
+};
+
+declare type FlowplayerCustomElementRegistry = Map<string, string>;
+
+declare interface FlowplayerUMD extends FlowplayerUMDBase {
+    (selector: string, config?: Config): Player;
+    (element: HTMLElement, config?: Config): Player;
+    <T>(selector: string, config?: CustomConfig<T>): Player;
+    <T>(element: HTMLElement, config?: CustomConfig<T>): Player;
+    <PluginCtors extends PluginCtor[]>(...plugins: PluginCtors): FlowplayerUMDWithPlugins<CustomConfig<MergeConfigs<PluginCtors>>>;
+}
+
+declare interface FlowplayerUMDBase {
+    instances: Player[];
+    extensions: PluginCtor[];
+    events: Record<string, string>;
+    ads?: {
+        events: Record<string, string>;
+    };
+    states: Record<string, string>;
+    quality: typeof QualityOpts;
+    commit: string;
+    version: string;
+    customElements: FlowplayerCustomElementRegistry;
+    defaultElements: Record<string, string>;
+    components: Components;
+    support: any;
+    autoplay: typeof AutoplayOpts;
+    jwt: any;
+    loaders: any;
+}
+
+declare interface FlowplayerUMDWithPlugins<ConfigWithPlugins extends Config = Config> extends FlowplayerUMDBase {
+    (selector: string, config?: ConfigWithPlugins): Player;
+    (element: HTMLElement, config?: ConfigWithPlugins): Player;
+}
+
+declare interface FPEvent<T> extends CustomEvent<T> {
+    /**
+     * @deprecated
+     the data attribute has been migrated to details to match the CustomEvent spec
+     more info: https://developer.mozilla.org/en-US/docs/Web/API/CustomEvent/CustomEvent
+     */
+    data?: T;
+}
+
+declare type JSONPlayer = any;
+
+declare type KeyValue = Record<string, any>;
+
+declare interface Loader<PluginOwnConfig extends KeyValue = KeyValue> extends Plugin_2<PluginOwnConfig> {
+    onload<T = KeyValue>(config: PluginConfig<T>, root: PlayerRoot, video: Player, src?: SourceObj): void;
+    wants<S = SourceObj, T = KeyValue>(srcString: SourceStr, srcObj: S, config: PluginConfig<T>): boolean;
+    wants<S = KeyValue, T = KeyValue>(srcString: SourceStr, srcObj: SourceWith<S>, config: PluginConfig<T>): boolean;
+}
+
+declare type MapToConfigs<Arr extends PluginCtor[]> = {
+    [PluginType in keyof Arr]: Arr[PluginType] extends PluginCtor<infer ConfigType> ? ConfigType : never;
+};
+
+declare type MergeConfigs<Arr extends PluginCtor[]> = ArrayToIntersection<MapToConfigs<Arr>>;
+
+declare interface Player extends HTMLVideoElement {
+    renderPlugin: (pluginContainer: HTMLElement) => void;
+    toggleDisable: (flag: boolean) => void;
+    original_src: string;
+    root: PlayerRoot;
+    playerState: Record<string, boolean>;
+    reaper: Map<string, any> | 0;
+    hasState(state: PlayerState): boolean;
+    transitionState(to: PlayerState, from: PlayerState, timer?: number): void;
+    togglePlay(on?: boolean): Promise<void>;
+    toggleFullScreen(on?: boolean, state_only?: boolean): void;
+    toggleMute(on?: boolean): void;
+    destroy(): void;
+    render(): void;
+    render(component: string, args: any[]): void;
+    createComponents(...args: string[]): HTMLElement[];
+    setOpts(config: Config): void;
+    setSrc(sources: UnsafeSource): Player;
+    on<T>(event: string | string[], handler: (e: FPEvent<T>) => void): Player;
+    once<T>(event: string, handler: (e: FPEvent<T>) => void): Player;
+    off<T>(event: string, handler: (e: FPEvent<T>) => void): Player;
+    poll<T>(event: string, data?: T): FPEvent<T>;
+    emit<T>(event: string, data?: T): Player;
+    setAttrs(attrs: Config): Player;
+    opt<T>(key: string, fallback?: T): T;
+    enqueueSeek(offset: number): any;
+    setState(state: string, flag: boolean): Player;
+    toJSON(): JSONPlayer;
+    i18n(k: string, fallback?: string): string;
+    deviceId(): DeviceId;
+    live_state: {
+        dvr?: boolean;
+        dvr_window?: number;
+    };
+    opts: Config;
+    plugins: Array<Plugin_2 | Loader>;
+    dvr_offset?: number;
+    message?: {
+        events: Record<string, string>;
+    };
+    disabled: boolean;
+    started?: boolean;
+    token: string;
+    tracks?: VideoTrack[];
+    _customElements: FlowplayerCustomElementRegistry;
+    _storage: Storage;
+}
+
+declare type PlayerRoot = HTMLElement & {
+    prevWidth?: number;
+};
+
+declare type PlayerState = string;
+
+declare type PlayerWithHealthAPI = Player & {
+    health?: {
+        media_session_id: string;
+        session_id: string;
+        toggle: (flag: boolean) => void;
+    };
+};
+
+declare interface Plugin_2<PluginOwnConfig extends KeyValue = KeyValue> {
+    /**
+     * a plugin must always implement the init method so a player instance knows how to initialize it
+     */
+    init<T>(config: PluginConfig<T>, container: PlayerRoot, player: Player): void;
+    init(config: PluginConfig<PluginOwnConfig>, container: PlayerRoot, player: Player): void;
+}
+
+declare type PluginConfig<T> = Config & T;
+
+declare interface PluginCtor<PluginOwnConfig extends KeyValue = KeyValue> {
+    new (umd: FlowplayerUMD, player: Player): AnyPlugin<PluginOwnConfig>;
+}
+
+declare enum QualityOpts {
+    LOW = 1,
+    MEDIUM = 2,
+    HIGH = 4
+}
+
+declare type SourceObj = {
+    src?: SourceStr;
+    type?: string;
+    drm?: DRMSourceConfiguration;
+};
+
+declare type SourceStr = string;
+
+declare type SourceWith<T> = SourceObj & T;
+
+declare enum StorageConfig {
+    ALL = 8,
+    NONE = 16
+}
+
+declare enum TrackingConfig {
+    ALL = 1,
+    NONE = 2
+}
+
+declare type UnsafeSource = SourceStr | SourceObj | Array<SourceStr | SourceObj>;
+
+declare interface VideoTrack {
+    name: string;
+    data: any;
+    default: boolean;
+    selected: boolean;
+}
+
+export { }