avbridge 2.2.0 → 2.3.0

package/dist/{player-DUyvltvy.d.cts → player-B6WB74RD.d.cts}

@@ -17,7 +17,7 @@ type ContainerKind = "mp4" | "mov" | "mkv" | "webm" | "avi" | "asf" | "flv" | "r
 /** Video codec families. Strings, not enums, so plugins can extend. */
 type VideoCodec = "h264" | "h265" | "vp8" | "vp9" | "av1" | "mpeg4" | "wmv3" | "vc1" | "rv10" | "rv20" | "rv30" | "rv40" | "mpeg2" | "mpeg1" | "theora" | (string & {});
 /** Audio codec families. */
-type AudioCodec = "aac" | "mp3" | "opus" | "vorbis" | "flac" | "pcm" | "ac3" | "eac3" | "wmav2" | "wmapro" | "alac" | "cook" | "ra_144" | "ra_288" | "sipr" | "atrac3" | (string & {});
+type AudioCodec = "aac" | "mp3" | "opus" | "vorbis" | "flac" | "pcm" | "ac3" | "eac3" | "wmav2" | "wmapro" | "alac" | "cook" | "ra_144" | "ra_288" | "sipr" | "atrac3" | "dts" | "truehd" | (string & {});
 interface VideoTrackInfo {
     id: number;
     codec: VideoCodec;
@@ -156,7 +156,7 @@ interface Plugin {
     name: string;
     canHandle(context: MediaContext): boolean;
     /** Returns a session if it claims the context, otherwise throws. */
-    execute(context: MediaContext, target: HTMLVideoElement): Promise<PlaybackSession>;
+    execute(context: MediaContext, target: HTMLVideoElement, transport?: TransportConfig): Promise<PlaybackSession>;
 }
 /** Player creation options. */
 interface CreatePlayerOptions {
@@ -196,6 +196,36 @@ interface CreatePlayerOptions {
      * strategy in the fallback chain on failure or stall.
      */
     autoEscalate?: boolean;
+    /**
+     * Behavior when the browser tab becomes hidden.
+     * - `"pause"` (default): auto-pause on hide, auto-resume on visible
+     *   if the user had been playing. Matches YouTube, Netflix, and
+     *   native media players. Prevents degraded playback from Chrome's
+     *   background throttling of requestAnimationFrame and setTimeout.
+     * - `"continue"`: keep playing. Playback will degrade anyway due to
+     *   browser throttling, but useful for consumers who want full
+     *   control of visibility handling themselves.
+     */
+    backgroundBehavior?: "pause" | "continue";
+    /**
+     * Extra {@link RequestInit} merged into every HTTP request the player
+     * makes (probe Range requests, subtitle fetches, libav HTTP reader).
+     * Headers are merged, not overwritten — so you can add `Authorization`
+     * without losing the player's `Range` header.
+     */
+    requestInit?: RequestInit;
+    /**
+     * Custom fetch implementation. Defaults to `globalThis.fetch`. Useful
+     * for interceptors, logging, or environments without a global fetch.
+     */
+    fetchFn?: FetchFn;
+}
+/** Signature-compatible with `globalThis.fetch`. */
+type FetchFn = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+/** Internal transport config bundle. Not part of the public API. */
+interface TransportConfig {
+    requestInit?: RequestInit;
+    fetchFn?: FetchFn;
 }
 /** Events emitted by {@link UnifiedPlayer}. Strongly typed. */
 interface PlayerEventMap {
@@ -236,6 +266,24 @@ interface ConvertOptions {
     onProgress?: (info: ProgressInfo) => void;
     /** When true, reject on any uncertain codec/container combo. Default: `false` (best-effort). */
     strict?: boolean;
+    /**
+     * Write output progressively to a `WritableStream` instead of accumulating
+     * in memory. Use with the File System Access API (`showSaveFilePicker()`) to
+     * transcode files larger than available memory.
+     *
+     * When set, the returned `ConvertResult.blob` will be an empty Blob (the
+     * real data went to the stream). The caller is responsible for closing the
+     * stream after the returned promise resolves.
+     *
+     * @example
+     * ```ts
+     * const handle = await showSaveFilePicker({ suggestedName: "output.mp4" });
+     * const writable = await handle.createWritable();
+     * const result = await transcode(file, { outputStream: writable });
+     * await writable.close();
+     * ```
+     */
+    outputStream?: WritableStream;
 }
 /** Progress information passed to {@link ConvertOptions.onProgress}. */
 interface ProgressInfo {
@@ -324,8 +372,13 @@ declare class UnifiedPlayer {
     private lastProgressTime;
     private lastProgressPosition;
     private errorListener;
+    private endedListener;
+    private userIntent;
+    private autoPausedForVisibility;
+    private visibilityListener;
     private switchingPromise;
     private subtitleResources;
+    private readonly transport;
     /**
      * @internal Use {@link createPlayer} or {@link UnifiedPlayer.create} instead.
      */
@@ -353,6 +406,13 @@ declare class UnifiedPlayer {
     play(): Promise<void>;
     /** Pause playback. No-op if the player is not ready or already paused. */
     pause(): void;
+    /**
+     * Handle browser tab visibility changes. On hide: pause if the user
+     * had been playing. On show: resume if we were the one who paused.
+     * Skips when `backgroundBehavior: "continue"` is set (listener isn't
+     * installed in that case).
+     */
+    private onVisibilityChange;
     /** Seek to the given time in seconds. Throws if the player is not ready. */
     seek(time: number): Promise<void>;
     /** Switch the active audio track by track ID. Throws if the player is not ready. */
@@ -370,4 +430,4 @@ declare class UnifiedPlayer {
 }
 declare function createPlayer(options: CreatePlayerOptions): Promise<UnifiedPlayer>;
 
-export { type AudioCodec as A, type Classification as C, type DiagnosticsSnapshot as D, type HardwareAccelerationHint as H, type MediaContext as M, type OutputAudioCodec as O, type PlaybackSession as P, type StrategyClass as S, type TranscodeOptions as T, UnifiedPlayer as U, type VideoCodec as V, type MediaInput as a, type ConvertOptions as b, type ConvertResult as c, type AudioTrackInfo as d, type ContainerKind as e, type CreatePlayerOptions as f, type OutputFormat as g, type OutputVideoCodec as h, type PlayerEventMap as i, type PlayerEventName as j, type Plugin as k, type ProgressInfo as l, type StrategyName as m, type SubtitleTrackInfo as n, type TranscodeQuality as o, type VideoTrackInfo as p, createPlayer as q };
+export { type AudioCodec as A, type Classification as C, type DiagnosticsSnapshot as D, type FetchFn as F, type HardwareAccelerationHint as H, type MediaContext as M, type OutputAudioCodec as O, type PlaybackSession as P, type StrategyClass as S, type TransportConfig as T, UnifiedPlayer as U, type VideoCodec as V, type MediaInput as a, type ConvertOptions as b, type ConvertResult as c, type TranscodeOptions as d, type AudioTrackInfo as e, type ContainerKind as f, type CreatePlayerOptions as g, type OutputFormat as h, type OutputVideoCodec as i, type PlayerEventMap as j, type PlayerEventName as k, type Plugin as l, type ProgressInfo as m, type StrategyName as n, type SubtitleTrackInfo as o, type TranscodeQuality as p, type VideoTrackInfo as q, createPlayer as r };

package/dist/{player-DUyvltvy.d.ts → player-B6WB74RD.d.ts}

@@ -17,7 +17,7 @@ type ContainerKind = "mp4" | "mov" | "mkv" | "webm" | "avi" | "asf" | "flv" | "r
 /** Video codec families. Strings, not enums, so plugins can extend. */
 type VideoCodec = "h264" | "h265" | "vp8" | "vp9" | "av1" | "mpeg4" | "wmv3" | "vc1" | "rv10" | "rv20" | "rv30" | "rv40" | "mpeg2" | "mpeg1" | "theora" | (string & {});
 /** Audio codec families. */
-type AudioCodec = "aac" | "mp3" | "opus" | "vorbis" | "flac" | "pcm" | "ac3" | "eac3" | "wmav2" | "wmapro" | "alac" | "cook" | "ra_144" | "ra_288" | "sipr" | "atrac3" | (string & {});
+type AudioCodec = "aac" | "mp3" | "opus" | "vorbis" | "flac" | "pcm" | "ac3" | "eac3" | "wmav2" | "wmapro" | "alac" | "cook" | "ra_144" | "ra_288" | "sipr" | "atrac3" | "dts" | "truehd" | (string & {});
 interface VideoTrackInfo {
     id: number;
     codec: VideoCodec;
@@ -156,7 +156,7 @@ interface Plugin {
     name: string;
     canHandle(context: MediaContext): boolean;
     /** Returns a session if it claims the context, otherwise throws. */
-    execute(context: MediaContext, target: HTMLVideoElement): Promise<PlaybackSession>;
+    execute(context: MediaContext, target: HTMLVideoElement, transport?: TransportConfig): Promise<PlaybackSession>;
 }
 /** Player creation options. */
 interface CreatePlayerOptions {
@@ -196,6 +196,36 @@ interface CreatePlayerOptions {
      * strategy in the fallback chain on failure or stall.
      */
     autoEscalate?: boolean;
+    /**
+     * Behavior when the browser tab becomes hidden.
+     * - `"pause"` (default): auto-pause on hide, auto-resume on visible
+     *   if the user had been playing. Matches YouTube, Netflix, and
+     *   native media players. Prevents degraded playback from Chrome's
+     *   background throttling of requestAnimationFrame and setTimeout.
+     * - `"continue"`: keep playing. Playback will degrade anyway due to
+     *   browser throttling, but useful for consumers who want full
+     *   control of visibility handling themselves.
+     */
+    backgroundBehavior?: "pause" | "continue";
+    /**
+     * Extra {@link RequestInit} merged into every HTTP request the player
+     * makes (probe Range requests, subtitle fetches, libav HTTP reader).
+     * Headers are merged, not overwritten — so you can add `Authorization`
+     * without losing the player's `Range` header.
+     */
+    requestInit?: RequestInit;
+    /**
+     * Custom fetch implementation. Defaults to `globalThis.fetch`. Useful
+     * for interceptors, logging, or environments without a global fetch.
+     */
+    fetchFn?: FetchFn;
+}
+/** Signature-compatible with `globalThis.fetch`. */
+type FetchFn = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+/** Internal transport config bundle. Not part of the public API. */
+interface TransportConfig {
+    requestInit?: RequestInit;
+    fetchFn?: FetchFn;
 }
 /** Events emitted by {@link UnifiedPlayer}. Strongly typed. */
 interface PlayerEventMap {
@@ -236,6 +266,24 @@ interface ConvertOptions {
     onProgress?: (info: ProgressInfo) => void;
     /** When true, reject on any uncertain codec/container combo. Default: `false` (best-effort). */
     strict?: boolean;
+    /**
+     * Write output progressively to a `WritableStream` instead of accumulating
+     * in memory. Use with the File System Access API (`showSaveFilePicker()`) to
+     * transcode files larger than available memory.
+     *
+     * When set, the returned `ConvertResult.blob` will be an empty Blob (the
+     * real data went to the stream). The caller is responsible for closing the
+     * stream after the returned promise resolves.
+     *
+     * @example
+     * ```ts
+     * const handle = await showSaveFilePicker({ suggestedName: "output.mp4" });
+     * const writable = await handle.createWritable();
+     * const result = await transcode(file, { outputStream: writable });
+     * await writable.close();
+     * ```
+     */
+    outputStream?: WritableStream;
 }
 /** Progress information passed to {@link ConvertOptions.onProgress}. */
 interface ProgressInfo {
@@ -324,8 +372,13 @@ declare class UnifiedPlayer {
     private lastProgressTime;
     private lastProgressPosition;
     private errorListener;
+    private endedListener;
+    private userIntent;
+    private autoPausedForVisibility;
+    private visibilityListener;
     private switchingPromise;
     private subtitleResources;
+    private readonly transport;
     /**
      * @internal Use {@link createPlayer} or {@link UnifiedPlayer.create} instead.
      */
@@ -353,6 +406,13 @@ declare class UnifiedPlayer {
     play(): Promise<void>;
     /** Pause playback. No-op if the player is not ready or already paused. */
     pause(): void;
+    /**
+     * Handle browser tab visibility changes. On hide: pause if the user
+     * had been playing. On show: resume if we were the one who paused.
+     * Skips when `backgroundBehavior: "continue"` is set (listener isn't
+     * installed in that case).
+     */
+    private onVisibilityChange;
     /** Seek to the given time in seconds. Throws if the player is not ready. */
     seek(time: number): Promise<void>;
     /** Switch the active audio track by track ID. Throws if the player is not ready. */
@@ -370,4 +430,4 @@ declare class UnifiedPlayer {
 }
 declare function createPlayer(options: CreatePlayerOptions): Promise<UnifiedPlayer>;
 
-export { type AudioCodec as A, type Classification as C, type DiagnosticsSnapshot as D, type HardwareAccelerationHint as H, type MediaContext as M, type OutputAudioCodec as O, type PlaybackSession as P, type StrategyClass as S, type TranscodeOptions as T, UnifiedPlayer as U, type VideoCodec as V, type MediaInput as a, type ConvertOptions as b, type ConvertResult as c, type AudioTrackInfo as d, type ContainerKind as e, type CreatePlayerOptions as f, type OutputFormat as g, type OutputVideoCodec as h, type PlayerEventMap as i, type PlayerEventName as j, type Plugin as k, type ProgressInfo as l, type StrategyName as m, type SubtitleTrackInfo as n, type TranscodeQuality as o, type VideoTrackInfo as p, createPlayer as q };
+export { type AudioCodec as A, type Classification as C, type DiagnosticsSnapshot as D, type FetchFn as F, type HardwareAccelerationHint as H, type MediaContext as M, type OutputAudioCodec as O, type PlaybackSession as P, type StrategyClass as S, type TransportConfig as T, UnifiedPlayer as U, type VideoCodec as V, type MediaInput as a, type ConvertOptions as b, type ConvertResult as c, type TranscodeOptions as d, type AudioTrackInfo as e, type ContainerKind as f, type CreatePlayerOptions as g, type OutputFormat as h, type OutputVideoCodec as i, type PlayerEventMap as j, type PlayerEventName as k, type Plugin as l, type ProgressInfo as m, type StrategyName as n, type SubtitleTrackInfo as o, type TranscodeQuality as p, type VideoTrackInfo as q, createPlayer as r };