@livepeer-frameworks/player-core 0.1.0 → 0.1.2

package/dist/cjs/core/PlayerInterface.js

@@ -0,0 +1,269 @@
+'use strict';
+
+/**
+ * Common Player Interface
+ *
+ * All player implementations must implement this interface to ensure
+ * consistent behavior and enable the PlayerManager selection system
+ */
+/**
+ * Error severity levels for the tiered error handling system.
+ *
+ * Tier 1 (TRANSIENT): Silent retry, no UI - network timeouts, brief stalls
+ * Tier 2 (RECOVERABLE): Protocol swap with toast - alternatives exist
+ * Tier 3 (DEGRADED): Quality drop with toast - playback continues at lower quality
+ * Tier 4 (FATAL): Blocking modal - all options exhausted
+ */
+exports.ErrorSeverity = void 0;
+(function (ErrorSeverity) {
+    /** Transient issues that self-resolve. User never sees UI. */
+    ErrorSeverity[ErrorSeverity["TRANSIENT"] = 1] = "TRANSIENT";
+    /** Current protocol failed but alternatives exist. Shows toast on swap. */
+    ErrorSeverity[ErrorSeverity["RECOVERABLE"] = 2] = "RECOVERABLE";
+    /** Quality degraded but playback continues. Shows informational toast. */
+    ErrorSeverity[ErrorSeverity["DEGRADED"] = 3] = "DEGRADED";
+    /** Cannot continue playback. Shows blocking error modal. */
+    ErrorSeverity[ErrorSeverity["FATAL"] = 4] = "FATAL";
+})(exports.ErrorSeverity || (exports.ErrorSeverity = {}));
+/**
+ * Error codes for classification. Maps to specific recovery strategies.
+ */
+exports.ErrorCode = void 0;
+(function (ErrorCode) {
+    // Tier 1: Silent recovery
+    ErrorCode["NETWORK_TIMEOUT"] = "NETWORK_TIMEOUT";
+    ErrorCode["WEBSOCKET_DISCONNECT"] = "WEBSOCKET_DISCONNECT";
+    ErrorCode["SEGMENT_LOAD_ERROR"] = "SEGMENT_LOAD_ERROR";
+    ErrorCode["ICE_DISCONNECTED"] = "ICE_DISCONNECTED";
+    ErrorCode["BUFFER_UNDERRUN"] = "BUFFER_UNDERRUN";
+    ErrorCode["CODEC_DECODE_ERROR"] = "CODEC_DECODE_ERROR";
+    // Tier 2: Protocol swap
+    ErrorCode["PROTOCOL_UNSUPPORTED"] = "PROTOCOL_UNSUPPORTED";
+    ErrorCode["CODEC_INCOMPATIBLE"] = "CODEC_INCOMPATIBLE";
+    ErrorCode["ICE_FAILED"] = "ICE_FAILED";
+    ErrorCode["MANIFEST_STALE"] = "MANIFEST_STALE";
+    ErrorCode["PLAYER_INIT_FAILED"] = "PLAYER_INIT_FAILED";
+    // Tier 3: Quality degraded
+    ErrorCode["QUALITY_DROPPED"] = "QUALITY_DROPPED";
+    ErrorCode["BANDWIDTH_LIMITED"] = "BANDWIDTH_LIMITED";
+    // Tier 4: Fatal
+    ErrorCode["ALL_PROTOCOLS_EXHAUSTED"] = "ALL_PROTOCOLS_EXHAUSTED";
+    ErrorCode["ALL_PROTOCOLS_BLACKLISTED"] = "ALL_PROTOCOLS_BLACKLISTED";
+    ErrorCode["STREAM_OFFLINE"] = "STREAM_OFFLINE";
+    ErrorCode["AUTH_REQUIRED"] = "AUTH_REQUIRED";
+    ErrorCode["GEO_BLOCKED"] = "GEO_BLOCKED";
+    ErrorCode["DRM_ERROR"] = "DRM_ERROR";
+    ErrorCode["CONTENT_UNAVAILABLE"] = "CONTENT_UNAVAILABLE";
+    ErrorCode["UNKNOWN"] = "UNKNOWN";
+})(exports.ErrorCode || (exports.ErrorCode = {}));
+/**
+ * Base class providing common functionality
+ */
+class BasePlayer {
+    constructor() {
+        this.listeners = new Map();
+        this.videoElement = null;
+    }
+    getVideoElement() {
+        return this.videoElement;
+    }
+    on(event, listener) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, new Set());
+        }
+        this.listeners.get(event).add(listener);
+    }
+    off(event, listener) {
+        const eventListeners = this.listeners.get(event);
+        if (eventListeners) {
+            eventListeners.delete(listener);
+        }
+    }
+    emit(event, data) {
+        const eventListeners = this.listeners.get(event);
+        if (eventListeners) {
+            eventListeners.forEach((listener) => {
+                try {
+                    listener(data);
+                }
+                catch (e) {
+                    console.error(`Error in ${event} listener:`, e);
+                }
+            });
+        }
+    }
+    setupVideoEventListeners(video, options) {
+        const handleEvent = (eventName, handler) => {
+            const listener = () => {
+                handler();
+                this.emit(eventName, undefined);
+            };
+            video.addEventListener(eventName, listener);
+        };
+        // Core playback events
+        handleEvent("play", () => options.onPlay?.());
+        handleEvent("pause", () => options.onPause?.());
+        handleEvent("ended", () => options.onEnded?.());
+        // Buffering/state events (previously duplicated in Player.tsx onReady)
+        video.addEventListener("waiting", () => options.onWaiting?.());
+        video.addEventListener("playing", () => options.onPlaying?.());
+        video.addEventListener("canplay", () => options.onCanPlay?.());
+        video.addEventListener("durationchange", () => {
+            options.onDurationChange?.(video.duration);
+        });
+        video.addEventListener("timeupdate", () => {
+            const currentTime = video.currentTime;
+            options.onTimeUpdate?.(currentTime);
+            this.emit("timeupdate", currentTime);
+        });
+        video.addEventListener("error", () => {
+            const error = video.error ? `Video error: ${video.error.message}` : "Unknown video error";
+            options.onError?.(error);
+            this.emit("error", error);
+        });
+        // Call onReady LAST - after all listeners are attached
+        // This prevents race conditions where events fire before handlers exist
+        this.emit("ready", video);
+        if (options.onReady) {
+            options.onReady(video);
+        }
+    }
+    // Default implementations for optional methods
+    getCurrentTime() {
+        return this.videoElement?.currentTime || 0;
+    }
+    getDuration() {
+        return this.videoElement?.duration || 0;
+    }
+    getSeekableRange() {
+        return null;
+    }
+    getBufferedRanges() {
+        return this.videoElement?.buffered ?? null;
+    }
+    isPaused() {
+        return this.videoElement?.paused ?? true;
+    }
+    isMuted() {
+        return this.videoElement?.muted ?? false;
+    }
+    async play() {
+        if (this.videoElement) {
+            return this.videoElement.play();
+        }
+    }
+    pause() {
+        this.videoElement?.pause();
+    }
+    seek(time) {
+        if (this.videoElement) {
+            this.videoElement.currentTime = time;
+        }
+    }
+    setVolume(volume) {
+        if (this.videoElement) {
+            this.videoElement.volume = Math.max(0, Math.min(1, volume));
+        }
+    }
+    setMuted(muted) {
+        if (this.videoElement) {
+            this.videoElement.muted = muted;
+        }
+    }
+    setPlaybackRate(rate) {
+        if (this.videoElement) {
+            this.videoElement.playbackRate = rate;
+        }
+    }
+    // Default captions/text tracks using native TextTrack API
+    getTextTracks() {
+        const video = this.videoElement;
+        if (!video || !video.textTracks)
+            return [];
+        const out = [];
+        const list = video.textTracks;
+        for (let i = 0; i < list.length; i++) {
+            const tt = list[i];
+            out.push({
+                id: String(i),
+                label: tt.label || `CC ${i + 1}`,
+                lang: tt.language,
+                active: tt.mode === "showing",
+            });
+        }
+        return out;
+    }
+    selectTextTrack(id) {
+        const video = this.videoElement;
+        if (!video || !video.textTracks)
+            return;
+        const list = video.textTracks;
+        for (let i = 0; i < list.length; i++) {
+            const tt = list[i];
+            if (id !== null && String(i) === id) {
+                tt.mode = "showing";
+            }
+            else {
+                tt.mode = "disabled";
+            }
+        }
+    }
+    // Default live helpers
+    isLive() {
+        const v = this.videoElement;
+        if (!v)
+            return false;
+        return !isFinite(v.duration) || v.duration === Infinity;
+    }
+    jumpToLive() {
+        const v = this.videoElement;
+        if (!v)
+            return;
+        const seekable = v.seekable;
+        if (seekable && seekable.length > 0) {
+            try {
+                v.currentTime = seekable.end(seekable.length - 1);
+            }
+            catch { }
+        }
+    }
+    // Default PiP helper
+    async requestPiP() {
+        const v = this.videoElement;
+        if (!v)
+            return;
+        // Exit if already in PiP
+        if (document.pictureInPictureElement === v) {
+            try {
+                await document.exitPictureInPicture?.();
+            }
+            catch { }
+            return;
+        }
+        try {
+            if (v.requestPictureInPicture) {
+                await v.requestPictureInPicture();
+            }
+            else if (v.webkitSetPresentationMode) {
+                v.webkitSetPresentationMode("picture-in-picture");
+            }
+        }
+        catch { }
+    }
+    setSize(width, height) {
+        if (this.videoElement) {
+            this.videoElement.style.width = `${width}px`;
+            this.videoElement.style.height = `${height}px`;
+        }
+    }
+    // Default optional stats methods
+    async getStats() {
+        return undefined;
+    }
+    async getLatency() {
+        return undefined;
+    }
+}
+
+exports.BasePlayer = BasePlayer;
+//# sourceMappingURL=PlayerInterface.js.map

package/dist/cjs/core/PlayerInterface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlayerInterface.js","sources":["../../../../src/core/PlayerInterface.ts"],"sourcesContent":["/**\n * Common Player Interface\n *\n * All player implementations must implement this interface to ensure\n * consistent behavior and enable the PlayerManager selection system\n */\n\nexport interface StreamSource {\n  url: string;\n  type: string;\n  index?: number;\n  streamName?: string;\n  mistPlayerUrl?: string;\n}\n\nexport interface StreamTrack {\n  type: \"video\" | \"audio\" | \"meta\";\n  codec: string;\n  codecstring?: string;\n  init?: string;\n  /** Track index from MistServer (used for binary chunk routing) */\n  idx?: number;\n  // Video-specific\n  width?: number;\n  height?: number;\n  fpks?: number; // frames per kilosecond\n  // Audio-specific\n  channels?: number;\n  rate?: number; // sample rate\n  size?: number; // bits per sample\n}\n\nexport interface StreamInfo {\n  source: StreamSource[];\n  meta: {\n    tracks: StreamTrack[];\n  };\n  type?: \"live\" | \"vod\";\n}\n\nexport interface PlayerOptions {\n  autoplay?: boolean;\n  muted?: boolean;\n  controls?: boolean;\n  loop?: boolean;\n  poster?: string;\n  width?: number;\n  height?: number;\n  /** Enable dev mode - for Legacy player, uses MistServer's dev skin with source selection */\n  devMode?: boolean;\n  /** Enable debug logging in player implementations */\n  debug?: boolean;\n  onReady?: (element: HTMLVideoElement) => void;\n  onError?: (error: string | Error) => void;\n  onPlay?: () => void;\n  onPause?: () => void;\n  onEnded?: () => void;\n  onTimeUpdate?: (currentTime: number) => void;\n  // New callbacks for buffering/state management\n  onWaiting?: () => void;\n  onPlaying?: () => void;\n  onCanPlay?: () => void;\n  onDurationChange?: (duration: number) => void;\n  /** HLS.js configuration override (merged with defaults) */\n  hlsConfig?: Record<string, unknown>;\n  /** DASH.js configuration override (merged with defaults) */\n  dashConfig?: Record<string, unknown>;\n  /** Video.js VHS configuration override (merged with defaults) */\n  vhsConfig?: Record<string, unknown>;\n}\n\nexport interface PlayerCapability {\n  /** Player name for display */\n  name: string;\n  /** Unique identifier */\n  shortname: string;\n  /** Priority (lower number = higher priority) */\n  priority: number;\n  /** MIME types this player can handle */\n  mimes: string[];\n}\n\nexport interface PlayerEvents {\n  ready: HTMLVideoElement;\n  error: string | Error;\n  play: void;\n  pause: void;\n  ended: void;\n  timeupdate: number;\n  /** Request to reload the player (e.g., Firefox segment error recovery) */\n  reloadrequested: { reason: string };\n  /** Seekable range changed */\n  seekablechange: { start: number; end: number; bufferWindow: number };\n}\n\n/**\n * Error severity levels for the tiered error handling system.\n *\n * Tier 1 (TRANSIENT): Silent retry, no UI - network timeouts, brief stalls\n * Tier 2 (RECOVERABLE): Protocol swap with toast - alternatives exist\n * Tier 3 (DEGRADED): Quality drop with toast - playback continues at lower quality\n * Tier 4 (FATAL): Blocking modal - all options exhausted\n */\nexport enum ErrorSeverity {\n  /** Transient issues that self-resolve. User never sees UI. */\n  TRANSIENT = 1,\n  /** Current protocol failed but alternatives exist. Shows toast on swap. */\n  RECOVERABLE = 2,\n  /** Quality degraded but playback continues. Shows informational toast. */\n  DEGRADED = 3,\n  /** Cannot continue playback. Shows blocking error modal. */\n  FATAL = 4,\n}\n\n/**\n * Error codes for classification. Maps to specific recovery strategies.\n */\nexport enum ErrorCode {\n  // Tier 1: Silent recovery\n  NETWORK_TIMEOUT = \"NETWORK_TIMEOUT\",\n  WEBSOCKET_DISCONNECT = \"WEBSOCKET_DISCONNECT\",\n  SEGMENT_LOAD_ERROR = \"SEGMENT_LOAD_ERROR\",\n  ICE_DISCONNECTED = \"ICE_DISCONNECTED\",\n  BUFFER_UNDERRUN = \"BUFFER_UNDERRUN\",\n  CODEC_DECODE_ERROR = \"CODEC_DECODE_ERROR\",\n\n  // Tier 2: Protocol swap\n  PROTOCOL_UNSUPPORTED = \"PROTOCOL_UNSUPPORTED\",\n  CODEC_INCOMPATIBLE = \"CODEC_INCOMPATIBLE\",\n  ICE_FAILED = \"ICE_FAILED\",\n  MANIFEST_STALE = \"MANIFEST_STALE\",\n  PLAYER_INIT_FAILED = \"PLAYER_INIT_FAILED\",\n\n  // Tier 3: Quality degraded\n  QUALITY_DROPPED = \"QUALITY_DROPPED\",\n  BANDWIDTH_LIMITED = \"BANDWIDTH_LIMITED\",\n\n  // Tier 4: Fatal\n  ALL_PROTOCOLS_EXHAUSTED = \"ALL_PROTOCOLS_EXHAUSTED\",\n  ALL_PROTOCOLS_BLACKLISTED = \"ALL_PROTOCOLS_BLACKLISTED\",\n  STREAM_OFFLINE = \"STREAM_OFFLINE\",\n  AUTH_REQUIRED = \"AUTH_REQUIRED\",\n  GEO_BLOCKED = \"GEO_BLOCKED\",\n  DRM_ERROR = \"DRM_ERROR\",\n  CONTENT_UNAVAILABLE = \"CONTENT_UNAVAILABLE\",\n  UNKNOWN = \"UNKNOWN\",\n}\n\n/**\n * Classified error with severity and recovery metadata.\n * Used by ErrorClassifier to track retry state and decide next action.\n */\nexport interface ClassifiedError {\n  /** Severity tier determining UI behavior */\n  severity: ErrorSeverity;\n  /** Specific error code for recovery strategy lookup */\n  code: ErrorCode;\n  /** Human-readable error message */\n  message: string;\n  /** Number of retries remaining for this error type */\n  retriesRemaining: number;\n  /** Number of alternative protocols/players remaining */\n  alternativesRemaining: number;\n  /** Original error if available */\n  originalError?: Error | string;\n  /** Timestamp when error occurred */\n  timestamp: number;\n  /** Diagnostic details for operators/debugging */\n  details?: {\n    incompatibilityReasons?: string[];\n    blacklistedProtocols?: string[];\n    originalCode?: ErrorCode;\n    originalMessage?: string;\n  };\n}\n\n/**\n * Events emitted by the error handling system.\n * UI layers listen to these for toast/modal display.\n */\nexport interface ErrorHandlingEvents {\n  /** Silent recovery attempted (Tier 1) - for telemetry only */\n  recoveryAttempted: {\n    code: ErrorCode;\n    attempt: number;\n    maxAttempts: number;\n  };\n  /** Protocol or player swapped (Tier 2) - shows toast */\n  protocolSwapped: {\n    fromPlayer: string;\n    toPlayer: string;\n    fromProtocol: string;\n    toProtocol: string;\n    reason: string;\n  };\n  /** Quality changed (Tier 3) - shows toast */\n  qualityChanged: {\n    direction: \"up\" | \"down\";\n    reason: string;\n  };\n  /** All recovery options exhausted (Tier 4) - shows modal */\n  playbackFailed: ClassifiedError;\n}\n\n/**\n * Base interface all players must implement\n */\nexport interface IPlayer {\n  /** Player metadata */\n  readonly capability: PlayerCapability;\n\n  /**\n   * Check if this player supports the given MIME type\n   */\n  isMimeSupported(mimetype: string): boolean;\n\n  /**\n   * Check if this player can play in the current browser environment\n   * @param mimetype - MIME type to test\n   * @param source - Source information\n   * @param streamInfo - Stream metadata\n   * @returns false if not supported, true if supported (no track info),\n   *          or array of supported track types\n   */\n  isBrowserSupported(\n    mimetype: string,\n    source: StreamSource,\n    streamInfo: StreamInfo\n  ): boolean | string[];\n\n  /**\n   * Initialize the player with given source and options\n   * @param container - Container element to render in\n   * @param source - Source to play\n   * @param options - Player options\n   * @param streamInfo - Full stream metadata (optional, for players that need track details)\n   * @returns Promise resolving to video element\n   */\n  initialize(\n    container: HTMLElement,\n    source: StreamSource,\n    options: PlayerOptions,\n    streamInfo?: StreamInfo\n  ): Promise<HTMLVideoElement>;\n\n  /**\n   * Clean up and destroy the player.\n   * May be async if cleanup requires network requests (e.g., WHEP session DELETE).\n   */\n  destroy(): void | Promise<void>;\n\n  /**\n   * Get the underlying video element (if available)\n   */\n  getVideoElement(): HTMLVideoElement | null;\n\n  /**\n   * Set video size\n   */\n  setSize?(width: number, height: number): void;\n\n  /**\n   * Add event listener\n   */\n  on<K extends keyof PlayerEvents>(event: K, listener: (data: PlayerEvents[K]) => void): void;\n\n  /**\n   * Remove event listener\n   */\n  off<K extends keyof PlayerEvents>(event: K, listener: (data: PlayerEvents[K]) => void): void;\n\n  /**\n   * Get current playback state\n   */\n  getCurrentTime?(): number;\n  getDuration?(): number;\n  isPaused?(): boolean;\n  isMuted?(): boolean;\n  /** Optional: provide an override seekable range (seconds) */\n  getSeekableRange?(): { start: number; end: number } | null;\n  /** Optional: provide buffered ranges override */\n  getBufferedRanges?(): TimeRanges | null;\n\n  /**\n   * Control playback\n   */\n  play?(): Promise<void>;\n  pause?(): void;\n  seek?(time: number): void;\n  setVolume?(volume: number): void;\n  setMuted?(muted: boolean): void;\n  setPlaybackRate?(rate: number): void;\n\n  // Optional: captions/text tracks\n  getTextTracks?(): Array<{ id: string; label: string; lang?: string; active: boolean }>;\n  selectTextTrack?(id: string | null): void;\n\n  // Optional: quality/level selection\n  getQualities?(): Array<{\n    id: string;\n    label: string;\n    bitrate?: number;\n    width?: number;\n    height?: number;\n    isAuto?: boolean;\n    active?: boolean;\n  }>;\n  selectQuality?(id: string): void; // use 'auto' to enable ABR\n  getCurrentQuality?(): string | null;\n\n  // Optional: live edge helpers\n  isLive?(): boolean;\n  jumpToLive?(): void;\n  /** Optional: frame step (direction -1/1, optional step seconds) */\n  frameStep?(direction: -1 | 1, seconds?: number): void;\n\n  // Optional: PiP\n  requestPiP?(): Promise<void>;\n\n  /**\n   * Optional: Retrieve player-specific stats (e.g., WebRTC inbound-rtp)\n   */\n  getStats?(): Promise<any>;\n\n  /**\n   * Optional: Retrieve approximate playback latency stats\n   */\n  getLatency?(): Promise<any>;\n}\n\n/**\n * Base class providing common functionality\n */\nexport abstract class BasePlayer implements IPlayer {\n  abstract readonly capability: PlayerCapability;\n\n  protected listeners: Map<string, Set<Function>> = new Map();\n  protected videoElement: HTMLVideoElement | null = null;\n\n  abstract isMimeSupported(mimetype: string): boolean;\n  abstract isBrowserSupported(\n    mimetype: string,\n    source: StreamSource,\n    streamInfo: StreamInfo\n  ): boolean | string[];\n  abstract initialize(\n    container: HTMLElement,\n    source: StreamSource,\n    options: PlayerOptions,\n    streamInfo?: StreamInfo\n  ): Promise<HTMLVideoElement>;\n  abstract destroy(): void | Promise<void>;\n\n  getVideoElement(): HTMLVideoElement | null {\n    return this.videoElement;\n  }\n\n  on<K extends keyof PlayerEvents>(event: K, listener: (data: PlayerEvents[K]) => void): void {\n    if (!this.listeners.has(event)) {\n      this.listeners.set(event, new Set());\n    }\n    this.listeners.get(event)!.add(listener);\n  }\n\n  off<K extends keyof PlayerEvents>(event: K, listener: (data: PlayerEvents[K]) => void): void {\n    const eventListeners = this.listeners.get(event);\n    if (eventListeners) {\n      eventListeners.delete(listener);\n    }\n  }\n\n  protected emit<K extends keyof PlayerEvents>(event: K, data: PlayerEvents[K]): void {\n    const eventListeners = this.listeners.get(event);\n    if (eventListeners) {\n      eventListeners.forEach((listener) => {\n        try {\n          listener(data);\n        } catch (e) {\n          console.error(`Error in ${event} listener:`, e);\n        }\n      });\n    }\n  }\n\n  protected setupVideoEventListeners(video: HTMLVideoElement, options: PlayerOptions): void {\n    const handleEvent = (eventName: keyof PlayerEvents, handler: () => void) => {\n      const listener = () => {\n        handler();\n        this.emit(eventName as any, undefined as any);\n      };\n      video.addEventListener(eventName, listener);\n    };\n\n    // Core playback events\n    handleEvent(\"play\", () => options.onPlay?.());\n    handleEvent(\"pause\", () => options.onPause?.());\n    handleEvent(\"ended\", () => options.onEnded?.());\n\n    // Buffering/state events (previously duplicated in Player.tsx onReady)\n    video.addEventListener(\"waiting\", () => options.onWaiting?.());\n    video.addEventListener(\"playing\", () => options.onPlaying?.());\n    video.addEventListener(\"canplay\", () => options.onCanPlay?.());\n\n    video.addEventListener(\"durationchange\", () => {\n      options.onDurationChange?.(video.duration);\n    });\n\n    video.addEventListener(\"timeupdate\", () => {\n      const currentTime = video.currentTime;\n      options.onTimeUpdate?.(currentTime);\n      this.emit(\"timeupdate\", currentTime);\n    });\n\n    video.addEventListener(\"error\", () => {\n      const error = video.error ? `Video error: ${video.error.message}` : \"Unknown video error\";\n      options.onError?.(error);\n      this.emit(\"error\", error);\n    });\n\n    // Call onReady LAST - after all listeners are attached\n    // This prevents race conditions where events fire before handlers exist\n    this.emit(\"ready\", video);\n    if (options.onReady) {\n      options.onReady(video);\n    }\n  }\n\n  // Default implementations for optional methods\n  getCurrentTime(): number {\n    return this.videoElement?.currentTime || 0;\n  }\n\n  getDuration(): number {\n    return this.videoElement?.duration || 0;\n  }\n\n  getSeekableRange(): { start: number; end: number } | null {\n    return null;\n  }\n\n  getBufferedRanges(): TimeRanges | null {\n    return this.videoElement?.buffered ?? null;\n  }\n\n  isPaused(): boolean {\n    return this.videoElement?.paused ?? true;\n  }\n\n  isMuted(): boolean {\n    return this.videoElement?.muted ?? false;\n  }\n\n  async play(): Promise<void> {\n    if (this.videoElement) {\n      return this.videoElement.play();\n    }\n  }\n\n  pause(): void {\n    this.videoElement?.pause();\n  }\n\n  seek(time: number): void {\n    if (this.videoElement) {\n      this.videoElement.currentTime = time;\n    }\n  }\n\n  setVolume(volume: number): void {\n    if (this.videoElement) {\n      this.videoElement.volume = Math.max(0, Math.min(1, volume));\n    }\n  }\n\n  setMuted(muted: boolean): void {\n    if (this.videoElement) {\n      this.videoElement.muted = muted;\n    }\n  }\n  setPlaybackRate(rate: number): void {\n    if (this.videoElement) {\n      this.videoElement.playbackRate = rate;\n    }\n  }\n\n  // Default captions/text tracks using native TextTrack API\n  getTextTracks(): Array<{ id: string; label: string; lang?: string; active: boolean }> {\n    const video = this.videoElement;\n    if (!video || !video.textTracks) return [];\n    const out: Array<{ id: string; label: string; lang?: string; active: boolean }> = [];\n    const list = video.textTracks as any as TextTrackList;\n    for (let i = 0; i < list.length; i++) {\n      const tt = list[i];\n      out.push({\n        id: String(i),\n        label: tt.label || `CC ${i + 1}`,\n        lang: (tt as any).language,\n        active: tt.mode === \"showing\",\n      });\n    }\n    return out;\n  }\n\n  selectTextTrack(id: string | null): void {\n    const video = this.videoElement;\n    if (!video || !video.textTracks) return;\n    const list = video.textTracks as any as TextTrackList;\n    for (let i = 0; i < list.length; i++) {\n      const tt = list[i];\n      if (id !== null && String(i) === id) {\n        tt.mode = \"showing\";\n      } else {\n        tt.mode = \"disabled\";\n      }\n    }\n  }\n\n  // Default live helpers\n  isLive(): boolean {\n    const v = this.videoElement;\n    if (!v) return false;\n    return !isFinite(v.duration) || v.duration === Infinity;\n  }\n\n  jumpToLive(): void {\n    const v = this.videoElement;\n    if (!v) return;\n    const seekable = v.seekable;\n    if (seekable && seekable.length > 0) {\n      try {\n        v.currentTime = seekable.end(seekable.length - 1);\n      } catch {}\n    }\n  }\n\n  // Default PiP helper\n  async requestPiP(): Promise<void> {\n    const v: any = this.videoElement as any;\n    if (!v) return;\n    // Exit if already in PiP\n    if (document.pictureInPictureElement === v) {\n      try {\n        await (document as any).exitPictureInPicture?.();\n      } catch {}\n      return;\n    }\n    try {\n      if (v.requestPictureInPicture) {\n        await v.requestPictureInPicture();\n      } else if (v.webkitSetPresentationMode) {\n        v.webkitSetPresentationMode(\"picture-in-picture\");\n      }\n    } catch {}\n  }\n\n  setSize(width: number, height: number): void {\n    if (this.videoElement) {\n      this.videoElement.style.width = `${width}px`;\n      this.videoElement.style.height = `${height}px`;\n    }\n  }\n\n  // Default optional stats methods\n  async getStats(): Promise<any> {\n    return undefined;\n  }\n\n  async getLatency(): Promise<any> {\n    return undefined;\n  }\n}\n"],"names":["ErrorSeverity","ErrorCode"],"mappings":"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"}