import {
  MediaFilePlayer,
  type MediaFilePlaybackHandle,
  type MediaFilePlaybackOptions,
  type MediaFilePlayerHooks,
} from "../media-playback/media-file-player.js";

/**
 * Options for `ProctoringClient.playVideoFile()`. Extends the shared
 * media surface ({@link MediaFilePlaybackOptions}) with the video-only
 * element knobs. Ownership rule: each knob is applied only when set, so
 * a host that passes its own `<video>` element keeps whatever it
 * configured unless an option explicitly overrides it. `playsInline`
 * additionally defaults to `true` for elements the helper creates, so
 * iOS Safari keeps playback inline instead of hijacking to native
 * fullscreen.
 */
export interface VideoFilePlaybackOptions
  extends MediaFilePlaybackOptions<HTMLVideoElement> {
  /** Poster image shown before first play. */
  poster?: string;
  /**
   * Mute the video's audio track. Browsers block un-muted autoplay
   * without a candidate gesture, so pass `muted: true` when you need
   * reliable autoplay.
   */
  muted?: boolean;
  playsInline?: boolean;
}

export type VideoFilePlaybackHandle = MediaFilePlaybackHandle<HTMLVideoElement>;

interface VideoFilePlayerOptions
  extends VideoFilePlaybackOptions,
    MediaFilePlayerHooks<HTMLVideoElement> {}

export class VideoFilePlayer extends MediaFilePlayer<HTMLVideoElement> {
  constructor(options: VideoFilePlayerOptions) {
    const createdElement = !options.element;
    super(options, {
      kindPrefix: "video-playback",
      mediaNoun: "Video",
      createElement: createVideoElement,
    });
    if (options.poster !== undefined) {
      this.element.poster = options.poster;
    }
    if (options.muted !== undefined) {
      this.element.muted = options.muted;
    }
    if (options.playsInline !== undefined) {
      this.element.playsInline = options.playsInline;
    } else if (createdElement) {
      this.element.playsInline = true;
    }
  }
}

function createVideoElement(): HTMLVideoElement {
  if (typeof document === "undefined") {
    throw new Error("Video playback is only available in a browser document");
  }
  return document.createElement("video");
}