stormcloud-video-player/lib/players/index.cjs.map

Ad-first HLS video player with SCTE-35 support and Google IMA integration for precise ad break alignment

{"version":3,"sources":["../../src/players/index.ts","../../src/utils.ts","../../src/patterns.ts","../../src/players/HlsPlayer.tsx","../../src/player/StormcloudVideoPlayer.ts","../../src/sdk/ima.ts","../../src/utils/tracking.ts","../../src/players/FilePlayer.tsx"],"sourcesContent":["import { lazy } from \"../utils\";\nimport { canPlay } from \"../patterns\";\nimport HlsPlayer from \"./HlsPlayer\";\nimport FilePlayer from \"./FilePlayer\";\n\nexport interface PlayerConfig {\n  key: string;\n  name: string;\n  canPlay: (url: string) => boolean;\n  canEnablePIP?: (url: string) => boolean;\n  lazyPlayer?: any;\n}\n\nconst players: PlayerConfig[] = [\n  {\n    key: \"hls\",\n    name: \"HLS Player\",\n    canPlay: canPlay.hls,\n    lazyPlayer: lazy(() => Promise.resolve({ default: HlsPlayer })),\n  },\n  {\n    key: \"file\",\n    name: \"File Player\",\n    canPlay: canPlay.file,\n    canEnablePIP: (url: string) => {\n      return (\n        canPlay.file(url) &&\n        (document.pictureInPictureEnabled ||\n          typeof (document as any).webkitSupportsPresentationMode ===\n            \"function\")\n      );\n    },\n    lazyPlayer: lazy(() => Promise.resolve({ default: FilePlayer })),\n  },\n];\n\nexport default players;\n","import { lazy as reactLazy } from \"react\";\n\nexport const lazy = reactLazy;\n\nexport const omit = <T extends Record<string, any>, K extends keyof T>(\n  object: T,\n  keys: K[]\n): Omit<T, K> => {\n  const result = { ...object };\n  keys.forEach((key) => {\n    delete result[key];\n  });\n  return result;\n};\n\nexport const isMediaStream = (url: any): url is MediaStream => {\n  return (\n    typeof window !== \"undefined\" &&\n    window.MediaStream &&\n    url instanceof window.MediaStream\n  );\n};\n\nexport const supportsWebKitPresentationMode = (): boolean => {\n  if (typeof window === \"undefined\") return false;\n  const video = document.createElement(\"video\");\n  return \"webkitSupportsPresentationMode\" in video;\n};\n\nexport const randomString = (): string => {\n  return Math.random().toString(36).substr(2, 9);\n};\n\nexport const parseQuery = (url: string): Record<string, string> => {\n  const query: Record<string, string> = {};\n  const params = new URLSearchParams(url.split(\"?\")[1] || \"\");\n  params.forEach((value, key) => {\n    query[key] = value;\n  });\n  return query;\n};\n\nexport const merge = <T extends Record<string, any>>(\n  target: T,\n  ...sources: Partial<T>[]\n): T => {\n  if (!sources.length) return target;\n  const source = sources.shift();\n\n  if (isObject(target) && isObject(source)) {\n    for (const key in source) {\n      if (isObject(source[key])) {\n        if (!target[key]) Object.assign(target, { [key]: {} });\n        merge(target[key] as any, source[key] as any);\n      } else {\n        Object.assign(target, { [key]: source[key] });\n      }\n    }\n  }\n\n  return merge(target, ...sources);\n};\n\nconst isObject = (item: any): item is Record<string, any> => {\n  return item && typeof item === \"object\" && !Array.isArray(item);\n};\n\nexport const IS_BROWSER = typeof window !== \"undefined\" && window.document;\nexport const IS_GLOBAL =\n  typeof globalThis !== \"undefined\" &&\n  globalThis.window &&\n  globalThis.window.document;\nexport const IS_IOS =\n  IS_BROWSER && /iPad|iPhone|iPod/.test(navigator.userAgent);\nexport const IS_SAFARI =\n  IS_BROWSER && /^((?!chrome|android).)*safari/i.test(navigator.userAgent);\n\nexport const SUPPORTS_HLS = (): boolean => {\n  if (!IS_BROWSER) return false;\n  const video = document.createElement(\"video\");\n  return Boolean(video.canPlayType(\"application/vnd.apple.mpegurl\"));\n};\n\nexport const SUPPORTS_DASH = (): boolean => {\n  if (!IS_BROWSER) return false;\n  const video = document.createElement(\"video\");\n  return Boolean(video.canPlayType(\"application/dash+xml\"));\n};\n","export const HLS_EXTENSIONS = /\\.(m3u8)($|\\?)/i;\nexport const HLS_PATHS = /\\/hls\\//i;\nexport const DASH_EXTENSIONS = /\\.(mpd)($|\\?)/i;\nexport const VIDEO_EXTENSIONS = /\\.(mp4|webm|ogg|avi|mov|wmv|flv|mkv)($|\\?)/i;\nexport const AUDIO_EXTENSIONS = /\\.(mp3|wav|ogg|aac|wma|flac|m4a)($|\\?)/i;\n\nexport const canPlay = {\n  hls: (url: string): boolean => {\n    if (!url || typeof url !== \"string\") return false;\n    return HLS_EXTENSIONS.test(url) || HLS_PATHS.test(url);\n  },\n\n  dash: (url: string): boolean => {\n    if (!url || typeof url !== \"string\") return false;\n    return DASH_EXTENSIONS.test(url);\n  },\n\n  video: (url: string): boolean => {\n    if (!url || typeof url !== \"string\") return false;\n    return VIDEO_EXTENSIONS.test(url);\n  },\n\n  audio: (url: string): boolean => {\n    if (!url || typeof url !== \"string\") return false;\n    return AUDIO_EXTENSIONS.test(url);\n  },\n\n  file: (url: string): boolean => {\n    if (!url || typeof url !== \"string\") return false;\n    return VIDEO_EXTENSIONS.test(url) || AUDIO_EXTENSIONS.test(url);\n  },\n};\n","import { Component } from \"react\";\nimport { StormcloudVideoPlayer } from \"../player/StormcloudVideoPlayer\";\nimport type { StormcloudVideoPlayerConfig } from \"../types\";\nimport { canPlay } from \"../patterns\";\n\nexport interface HlsPlayerProps extends StormcloudVideoPlayerConfig {\n  onMount?: (player: any) => void;\n  onReady?: () => void;\n  onPlay?: () => void;\n  onPause?: () => void;\n  onEnded?: () => void;\n  onLoaded?: () => void;\n  onError?: (error: any) => void;\n}\n\nexport default class HlsPlayer extends Component<HlsPlayerProps> {\n  static displayName = \"HlsPlayer\";\n\n  static canPlay = canPlay.hls;\n\n  private player: StormcloudVideoPlayer | null = null;\n  private mounted = false;\n\n  componentDidMount() {\n    this.mounted = true;\n    this.load();\n  }\n\n  componentWillUnmount() {\n    this.mounted = false;\n    if (this.player) {\n      this.player.destroy();\n      this.player = null;\n    }\n  }\n\n  componentDidUpdate(prevProps: HlsPlayerProps) {\n    if (prevProps.src !== this.props.src) {\n      this.load();\n    }\n  }\n\n  load = async () => {\n    if (!this.props.videoElement || !this.props.src) return;\n\n    try {\n      if (this.player) {\n        this.player.destroy();\n        this.player = null;\n      }\n\n      const config: StormcloudVideoPlayerConfig = {\n        src: this.props.src,\n        videoElement: this.props.videoElement,\n      };\n\n      if (this.props.autoplay !== undefined)\n        config.autoplay = this.props.autoplay;\n      if (this.props.muted !== undefined) config.muted = this.props.muted;\n      if (this.props.lowLatencyMode !== undefined)\n        config.lowLatencyMode = this.props.lowLatencyMode;\n      if (this.props.allowNativeHls !== undefined)\n        config.allowNativeHls = this.props.allowNativeHls;\n      if (this.props.driftToleranceMs !== undefined)\n        config.driftToleranceMs = this.props.driftToleranceMs;\n      if (this.props.immediateManifestAds !== undefined)\n        config.immediateManifestAds = this.props.immediateManifestAds;\n      if (this.props.debugAdTiming !== undefined)\n        config.debugAdTiming = this.props.debugAdTiming;\n      if (this.props.showCustomControls !== undefined)\n        config.showCustomControls = this.props.showCustomControls;\n      if (this.props.onVolumeToggle !== undefined)\n        config.onVolumeToggle = this.props.onVolumeToggle;\n      if (this.props.onFullscreenToggle !== undefined)\n        config.onFullscreenToggle = this.props.onFullscreenToggle;\n      if (this.props.onControlClick !== undefined)\n        config.onControlClick = this.props.onControlClick;\n      if (this.props.licenseKey !== undefined)\n        config.licenseKey = this.props.licenseKey;\n      if (this.props.adFailsafeTimeoutMs !== undefined)\n        config.adFailsafeTimeoutMs = this.props.adFailsafeTimeoutMs;\n\n      this.player = new StormcloudVideoPlayer(config);\n\n      this.props.onMount?.(this);\n\n      await this.player.load();\n\n      if (this.mounted) {\n        this.props.onReady?.();\n      }\n    } catch (error) {\n      if (this.mounted) {\n        this.props.onError?.(error);\n      }\n    }\n  };\n\n  play = () => {\n    if (this.props.videoElement) {\n      this.props.videoElement.play();\n      this.props.onPlay?.();\n    }\n  };\n\n  pause = () => {\n    if (this.props.videoElement) {\n      this.props.videoElement.pause();\n      this.props.onPause?.();\n    }\n  };\n\n  stop = () => {\n    this.pause();\n    if (this.props.videoElement) {\n      this.props.videoElement.currentTime = 0;\n    }\n  };\n\n  seekTo = (seconds: number, keepPlaying?: boolean) => {\n    if (this.props.videoElement) {\n      this.props.videoElement.currentTime = seconds;\n      if (!keepPlaying) {\n        this.pause();\n      }\n    }\n  };\n\n  setVolume = (volume: number) => {\n    if (this.props.videoElement) {\n      this.props.videoElement.volume = Math.max(0, Math.min(1, volume));\n    }\n  };\n\n  mute = () => {\n    if (this.props.videoElement) {\n      this.props.videoElement.muted = true;\n    }\n  };\n\n  unmute = () => {\n    if (this.props.videoElement) {\n      this.props.videoElement.muted = false;\n    }\n  };\n\n  setPlaybackRate = (rate: number) => {\n    if (this.props.videoElement && rate > 0) {\n      this.props.videoElement.playbackRate = rate;\n    }\n  };\n\n  getDuration = (): number | null => {\n    if (this.props.videoElement && isFinite(this.props.videoElement.duration)) {\n      return this.props.videoElement.duration;\n    }\n    return null;\n  };\n\n  getCurrentTime = (): number | null => {\n    if (\n      this.props.videoElement &&\n      isFinite(this.props.videoElement.currentTime)\n    ) {\n      return this.props.videoElement.currentTime;\n    }\n    return null;\n  };\n\n  getSecondsLoaded = (): number | null => {\n    if (\n      this.props.videoElement &&\n      this.props.videoElement.buffered.length > 0\n    ) {\n      return this.props.videoElement.buffered.end(\n        this.props.videoElement.buffered.length - 1\n      );\n    }\n    return null;\n  };\n\n  getInternalPlayer = (key = \"player\") => {\n    if (key === \"player\") return this.player;\n    if (key === \"video\") return this.props.videoElement;\n    if (key === \"hls\" && this.player) return (this.player as any).hls;\n    return null;\n  };\n\n  render() {\n    return null;\n  }\n}\n","import Hls from \"hls.js\";\nimport type {\n  StormcloudVideoPlayerConfig,\n  Scte35Marker,\n  Id3TagInfo,\n  ImaController,\n  AdBreak,\n  StormcloudApiResponse,\n} from \"../types\";\nimport { createImaController } from \"../sdk/ima\";\nimport { sendInitialTracking, sendHeartbeat } from \"../utils/tracking\";\n\nexport class StormcloudVideoPlayer {\n  private readonly video: HTMLVideoElement;\n  private readonly config: StormcloudVideoPlayerConfig;\n  private hls?: Hls;\n  private ima: ImaController;\n  private attached = false;\n  private inAdBreak = false;\n  private currentAdBreakStartWallClockMs: number | undefined;\n  private expectedAdBreakDurationMs: number | undefined;\n  private adStopTimerId: number | undefined;\n  private adStartTimerId: number | undefined;\n  private adFailsafeTimerId: number | undefined;\n  private ptsDriftEmaMs = 0;\n  private adPodQueue: string[] = [];\n  private apiVastTagUrl: string | undefined;\n  private vastConfig:\n    | StormcloudApiResponse[\"response\"][\"options\"][\"vast\"]\n    | undefined;\n  private lastHeartbeatTime: number = 0;\n  private heartbeatInterval: number | undefined;\n  private currentAdIndex: number = 0;\n  private totalAdsInBreak: number = 0;\n  private showAds: boolean = false;\n  private isLiveStream: boolean = false;\n\n  constructor(config: StormcloudVideoPlayerConfig) {\n    this.config = config;\n    this.video = config.videoElement;\n\n    this.ima = createImaController(this.video, {\n      continueLiveStreamDuringAds: false,\n    });\n  }\n\n  async load(): Promise<void> {\n    if (!this.attached) {\n      this.attach();\n    }\n\n    try {\n      await this.fetchAdConfiguration();\n    } catch (error) {\n      if (this.config.debugAdTiming) {\n        console.warn(\n          \"[StormcloudVideoPlayer] Failed to fetch ad configuration:\",\n          error\n        );\n      }\n    }\n\n    this.initializeTracking();\n\n    if (this.shouldUseNativeHls()) {\n      this.video.src = this.config.src;\n\n      this.isLiveStream = this.config.lowLatencyMode ?? false;\n\n      if (this.config.debugAdTiming) {\n        console.log(\n          \"[StormcloudVideoPlayer] allowNativeHls: true - VOD mode detected:\",\n          {\n            isLive: this.isLiveStream,\n            allowNativeHls: this.config.allowNativeHls,\n            adBehavior: \"vod (main video pauses during ads)\",\n          }\n        );\n      }\n\n      this.ima.destroy();\n      this.ima = createImaController(this.video, {\n        continueLiveStreamDuringAds: false,\n      });\n      this.ima.initialize();\n\n      if (this.config.autoplay) {\n        await this.video.play().catch(() => {});\n      }\n      return;\n    }\n\n    this.hls = new Hls({\n      enableWorker: true,\n      backBufferLength: 30,\n      liveDurationInfinity: true,\n      lowLatencyMode: !!this.config.lowLatencyMode,\n      maxLiveSyncPlaybackRate: this.config.lowLatencyMode ? 1.5 : 1.0,\n      ...(this.config.lowLatencyMode ? { liveSyncDuration: 2 } : {}),\n    });\n\n    this.hls.on(Hls.Events.MEDIA_ATTACHED, () => {\n      this.hls?.loadSource(this.config.src);\n    });\n\n    this.hls.on(Hls.Events.MANIFEST_PARSED, async (_, data: any) => {\n      this.isLiveStream =\n        this.hls?.levels?.some(\n          (level) =>\n            level?.details?.live === true || level?.details?.type === \"LIVE\"\n        ) ?? false;\n\n      if (this.config.debugAdTiming) {\n        const adBehavior = this.shouldContinueLiveStreamDuringAds()\n          ? \"live (main video continues muted during ads)\"\n          : \"vod (main video pauses during ads)\";\n        console.log(\"[StormcloudVideoPlayer] Stream type detected:\", {\n          isLive: this.isLiveStream,\n          allowNativeHls: this.config.allowNativeHls,\n          adBehavior,\n        });\n      }\n\n      this.ima.destroy();\n      this.ima = createImaController(this.video, {\n        continueLiveStreamDuringAds: this.shouldContinueLiveStreamDuringAds(),\n      });\n      this.ima.initialize();\n\n      if (this.config.autoplay) {\n        await this.video.play().catch(() => {});\n      }\n    });\n\n    this.hls.on(Hls.Events.FRAG_PARSING_METADATA, (_evt, data: any) => {\n      const id3Tags: Id3TagInfo[] = (data?.samples || []).map((s: any) => ({\n        key: \"ID3\",\n        value: s?.data,\n        ptsSeconds: s?.pts,\n      }));\n      id3Tags.forEach((tag) => this.onId3Tag(tag));\n    });\n\n    this.hls.on(Hls.Events.FRAG_CHANGED, (_evt, data: any) => {\n      const frag = data?.frag;\n      const tagList: any[] | undefined = frag?.tagList;\n      if (!Array.isArray(tagList)) return;\n\n      for (const entry of tagList) {\n        let tag = \"\";\n        let value = \"\";\n        if (Array.isArray(entry)) {\n          tag = String(entry[0] ?? \"\");\n          value = String(entry[1] ?? \"\");\n        } else if (typeof entry === \"string\") {\n          const idx = entry.indexOf(\":\");\n          if (idx >= 0) {\n            tag = entry.substring(0, idx);\n            value = entry.substring(idx + 1);\n          } else {\n            tag = entry;\n            value = \"\";\n          }\n        }\n\n        if (!tag) continue;\n        if (tag.includes(\"EXT-X-CUE-OUT\")) {\n          const durationSeconds = this.parseCueOutDuration(value);\n          const marker: Scte35Marker = {\n            type: \"start\",\n            ...(durationSeconds !== undefined ? { durationSeconds } : {}),\n            raw: { tag, value },\n          } as Scte35Marker;\n          this.onScte35Marker(marker);\n        } else if (tag.includes(\"EXT-X-CUE-OUT-CONT\")) {\n          const prog = this.parseCueOutCont(value);\n          const marker: Scte35Marker = {\n            type: \"progress\",\n            ...(prog?.duration !== undefined\n              ? { durationSeconds: prog.duration }\n              : {}),\n            ...(prog?.elapsed !== undefined\n              ? { ptsSeconds: prog.elapsed }\n              : {}),\n            raw: { tag, value },\n          } as Scte35Marker;\n          this.onScte35Marker(marker);\n        } else if (tag.includes(\"EXT-X-CUE-IN\")) {\n          this.onScte35Marker({ type: \"end\", raw: { tag, value } });\n        } else if (tag.includes(\"EXT-X-DATERANGE\")) {\n          const attrs = this.parseAttributeList(value);\n          const hasScteOut =\n            \"SCTE35-OUT\" in attrs || attrs[\"SCTE35-OUT\"] !== undefined;\n          const hasScteIn =\n            \"SCTE35-IN\" in attrs || attrs[\"SCTE35-IN\"] !== undefined;\n          const klass = String(attrs[\"CLASS\"] ?? \"\");\n          const duration = this.toNumber(attrs[\"DURATION\"]);\n\n          if (hasScteOut || /com\\.apple\\.hls\\.cue/i.test(klass)) {\n            const marker: Scte35Marker = {\n              type: \"start\",\n              ...(duration !== undefined ? { durationSeconds: duration } : {}),\n              raw: { tag, value, attrs },\n            } as Scte35Marker;\n            this.onScte35Marker(marker);\n          }\n          if (hasScteIn) {\n            this.onScte35Marker({ type: \"end\", raw: { tag, value, attrs } });\n          }\n        }\n      }\n    });\n\n    this.hls.on(Hls.Events.ERROR, (_evt, data) => {\n      if (data?.fatal) {\n        switch (data.type) {\n          case Hls.ErrorTypes.NETWORK_ERROR:\n            this.hls?.startLoad();\n            break;\n          case Hls.ErrorTypes.MEDIA_ERROR:\n            this.hls?.recoverMediaError();\n            break;\n          default:\n            this.destroy();\n            break;\n        }\n      }\n    });\n\n    this.hls.attachMedia(this.video);\n  }\n\n  private attach(): void {\n    if (this.attached) return;\n    this.attached = true;\n    this.video.autoplay = !!this.config.autoplay;\n    this.video.muted = !!this.config.muted;\n\n    this.ima.initialize();\n    this.ima.on(\"all_ads_completed\", () => {\n      if (!this.inAdBreak) return;\n      const remaining = this.getRemainingAdMs();\n      if (remaining > 500 && this.adPodQueue.length > 0) {\n        const next = this.adPodQueue.shift()!;\n        this.currentAdIndex++;\n        this.playSingleAd(next).catch(() => {});\n      } else {\n        this.currentAdIndex = 0;\n        this.totalAdsInBreak = 0;\n        this.showAds = false;\n      }\n    });\n    this.ima.on(\"ad_error\", () => {\n      if (this.config.debugAdTiming) {\n        console.log(\"[StormcloudVideoPlayer] IMA ad_error event received\");\n      }\n      if (!this.inAdBreak) return;\n      const remaining = this.getRemainingAdMs();\n      if (remaining > 500 && this.adPodQueue.length > 0) {\n        const next = this.adPodQueue.shift()!;\n        this.currentAdIndex++;\n        this.playSingleAd(next).catch(() => {});\n      } else {\n        this.handleAdFailure();\n      }\n    });\n    this.ima.on(\"content_pause\", () => {\n      if (this.config.debugAdTiming) {\n        console.log(\"[StormcloudVideoPlayer] IMA content_pause event received\");\n      }\n      this.clearAdFailsafeTimer();\n    });\n    this.ima.on(\"content_resume\", () => {\n      if (this.config.debugAdTiming) {\n        console.log(\n          \"[StormcloudVideoPlayer] IMA content_resume event received\"\n        );\n      }\n      this.clearAdFailsafeTimer();\n    });\n\n    this.video.addEventListener(\"timeupdate\", () => {\n      this.onTimeUpdate(this.video.currentTime);\n    });\n  }\n\n  private shouldUseNativeHls(): boolean {\n    const streamType = this.getStreamType();\n\n    if (streamType === \"other\") {\n      return true;\n    }\n\n    const canNative = this.video.canPlayType(\"application/vnd.apple.mpegURL\");\n    return !!(this.config.allowNativeHls && canNative);\n  }\n\n  private onId3Tag(tag: Id3TagInfo): void {\n    if (typeof tag.ptsSeconds === \"number\") {\n      this.updatePtsDrift(tag.ptsSeconds);\n    }\n    const marker = this.parseScte35FromId3(tag);\n    if (marker) {\n      this.onScte35Marker(marker);\n    }\n  }\n\n  private parseScte35FromId3(tag: Id3TagInfo): Scte35Marker | undefined {\n    const text = this.decodeId3ValueToText(tag.value);\n    if (!text) return undefined;\n\n    const cueOutMatch =\n      text.match(/EXT-X-CUE-OUT(?::([^\\r\\n]*))?/i) ||\n      text.match(/CUE-OUT(?::([^\\r\\n]*))?/i);\n    if (cueOutMatch) {\n      const arg = (cueOutMatch[1] ?? \"\").trim();\n      const dur = this.parseCueOutDuration(arg);\n      const marker: Scte35Marker = {\n        type: \"start\",\n        ...(tag.ptsSeconds !== undefined ? { ptsSeconds: tag.ptsSeconds } : {}),\n        ...(dur !== undefined ? { durationSeconds: dur } : {}),\n        raw: { id3: text },\n      } as Scte35Marker;\n      return marker;\n    }\n\n    const cueOutContMatch = text.match(/EXT-X-CUE-OUT-CONT:([^\\r\\n]*)/i);\n    if (cueOutContMatch) {\n      const arg = (cueOutContMatch[1] ?? \"\").trim();\n      const cont = this.parseCueOutCont(arg);\n      const marker: Scte35Marker = {\n        type: \"progress\",\n        ...(tag.ptsSeconds !== undefined ? { ptsSeconds: tag.ptsSeconds } : {}),\n        ...(cont?.duration !== undefined\n          ? { durationSeconds: cont.duration }\n          : {}),\n        raw: { id3: text },\n      } as Scte35Marker;\n      return marker;\n    }\n\n    const cueInMatch = text.match(/EXT-X-CUE-IN\\b/i) || text.match(/CUE-IN\\b/i);\n    if (cueInMatch) {\n      const marker: Scte35Marker = {\n        type: \"end\",\n        ...(tag.ptsSeconds !== undefined ? { ptsSeconds: tag.ptsSeconds } : {}),\n        raw: { id3: text },\n      } as Scte35Marker;\n      return marker;\n    }\n\n    const daterangeMatch = text.match(/EXT-X-DATERANGE:([^\\r\\n]*)/i);\n    if (daterangeMatch) {\n      const attrs = this.parseAttributeList(daterangeMatch[1] ?? \"\");\n      const hasScteOut =\n        \"SCTE35-OUT\" in attrs || attrs[\"SCTE35-OUT\"] !== undefined;\n      const hasScteIn =\n        \"SCTE35-IN\" in attrs || attrs[\"SCTE35-IN\"] !== undefined;\n      const klass = String(attrs[\"CLASS\"] ?? \"\");\n      const duration = this.toNumber(attrs[\"DURATION\"]);\n      if (hasScteOut || /com\\.apple\\.hls\\.cue/i.test(klass)) {\n        const marker: Scte35Marker = {\n          type: \"start\",\n          ...(tag.ptsSeconds !== undefined\n            ? { ptsSeconds: tag.ptsSeconds }\n            : {}),\n          ...(duration !== undefined ? { durationSeconds: duration } : {}),\n          raw: { id3: text, attrs },\n        } as Scte35Marker;\n        return marker;\n      }\n      if (hasScteIn) {\n        const marker: Scte35Marker = {\n          type: \"end\",\n          ...(tag.ptsSeconds !== undefined\n            ? { ptsSeconds: tag.ptsSeconds }\n            : {}),\n          raw: { id3: text, attrs },\n        } as Scte35Marker;\n        return marker;\n      }\n    }\n\n    if (/SCTE35-OUT/i.test(text)) {\n      const marker: Scte35Marker = {\n        type: \"start\",\n        ...(tag.ptsSeconds !== undefined ? { ptsSeconds: tag.ptsSeconds } : {}),\n        raw: { id3: text },\n      } as Scte35Marker;\n      return marker;\n    }\n    if (/SCTE35-IN/i.test(text)) {\n      const marker: Scte35Marker = {\n        type: \"end\",\n        ...(tag.ptsSeconds !== undefined ? { ptsSeconds: tag.ptsSeconds } : {}),\n        raw: { id3: text },\n      } as Scte35Marker;\n      return marker;\n    }\n\n    if (tag.value instanceof Uint8Array) {\n      const bin = this.parseScte35Binary(tag.value);\n      if (bin) return bin;\n    }\n\n    return undefined;\n  }\n\n  private decodeId3ValueToText(value: string | Uint8Array): string | undefined {\n    try {\n      if (typeof value === \"string\") return value;\n      const decoder = new TextDecoder(\"utf-8\", { fatal: false });\n      const text = decoder.decode(value);\n      if (text && /[\\x20-\\x7E]/.test(text)) return text;\n      let out = \"\";\n      for (let i = 0; i < value.length; i++)\n        out += String.fromCharCode(value[i]!);\n      return out;\n    } catch {\n      return undefined;\n    }\n  }\n\n  private onScte35Marker(marker: Scte35Marker): void {\n    if (this.config.debugAdTiming) {\n      console.log(\"[StormcloudVideoPlayer] SCTE-35 marker detected:\", {\n        type: marker.type,\n        ptsSeconds: marker.ptsSeconds,\n        durationSeconds: marker.durationSeconds,\n        currentTime: this.video.currentTime,\n        raw: marker.raw,\n      });\n    }\n\n    if (marker.type === \"start\") {\n      this.inAdBreak = true;\n      const durationMs =\n        marker.durationSeconds != null\n          ? marker.durationSeconds * 1000\n          : undefined;\n      this.expectedAdBreakDurationMs = durationMs;\n      this.currentAdBreakStartWallClockMs = Date.now();\n\n      const isManifestMarker = this.isManifestBasedMarker(marker);\n      const forceImmediate = this.config.immediateManifestAds ?? true;\n\n      if (this.config.debugAdTiming) {\n        console.log(\"[StormcloudVideoPlayer] Ad start decision:\", {\n          isManifestMarker,\n          forceImmediate,\n          hasPts: typeof marker.ptsSeconds === \"number\",\n        });\n      }\n\n      if (isManifestMarker && forceImmediate) {\n        if (this.config.debugAdTiming) {\n          console.log(\n            \"[StormcloudVideoPlayer] Starting ad immediately (manifest-based)\"\n          );\n        }\n        this.clearAdStartTimer();\n        this.handleAdStart(marker);\n      } else if (typeof marker.ptsSeconds === \"number\") {\n        const tol = this.config.driftToleranceMs ?? 1000;\n        const nowMs = this.video.currentTime * 1000;\n        const estCurrentPtsMs = nowMs - this.ptsDriftEmaMs;\n        const deltaMs = Math.floor(marker.ptsSeconds * 1000 - estCurrentPtsMs);\n\n        if (this.config.debugAdTiming) {\n          console.log(\"[StormcloudVideoPlayer] PTS-based timing calculation:\", {\n            nowMs,\n            estCurrentPtsMs,\n            markerPtsMs: marker.ptsSeconds * 1000,\n            deltaMs,\n            tolerance: tol,\n          });\n        }\n\n        if (deltaMs > tol) {\n          if (this.config.debugAdTiming) {\n            console.log(\n              `[StormcloudVideoPlayer] Scheduling ad start in ${deltaMs}ms`\n            );\n          }\n          this.scheduleAdStartIn(deltaMs);\n        } else {\n          if (this.config.debugAdTiming) {\n            console.log(\n              \"[StormcloudVideoPlayer] Starting ad immediately (within tolerance)\"\n            );\n          }\n          this.clearAdStartTimer();\n          this.handleAdStart(marker);\n        }\n      } else {\n        if (this.config.debugAdTiming) {\n          console.log(\n            \"[StormcloudVideoPlayer] Starting ad immediately (fallback)\"\n          );\n        }\n        this.clearAdStartTimer();\n        this.handleAdStart(marker);\n      }\n      if (this.expectedAdBreakDurationMs != null) {\n        this.scheduleAdStopCountdown(this.expectedAdBreakDurationMs);\n      }\n      return;\n    }\n    if (marker.type === \"progress\" && this.inAdBreak) {\n      if (marker.durationSeconds != null) {\n        this.expectedAdBreakDurationMs = marker.durationSeconds * 1000;\n      }\n      if (\n        this.expectedAdBreakDurationMs != null &&\n        this.currentAdBreakStartWallClockMs != null\n      ) {\n        const elapsedMs = Date.now() - this.currentAdBreakStartWallClockMs;\n        const remainingMs = Math.max(\n          0,\n          this.expectedAdBreakDurationMs - elapsedMs\n        );\n        this.scheduleAdStopCountdown(remainingMs);\n      }\n      if (!this.ima.isAdPlaying()) {\n        const scheduled = this.findCurrentOrNextBreak(\n          this.video.currentTime * 1000\n        );\n        const tags =\n          this.selectVastTagsForBreak(scheduled) ||\n          (this.apiVastTagUrl ? [this.apiVastTagUrl] : undefined);\n        if (tags && tags.length > 0) {\n          const first = tags[0] as string;\n          const rest = tags.slice(1);\n          this.adPodQueue = rest;\n          this.playSingleAd(first).catch(() => {});\n        }\n      }\n      return;\n    }\n    if (marker.type === \"end\") {\n      this.inAdBreak = false;\n      this.expectedAdBreakDurationMs = undefined;\n      this.currentAdBreakStartWallClockMs = undefined;\n      this.clearAdStartTimer();\n      this.clearAdStopTimer();\n      if (this.ima.isAdPlaying()) {\n        this.ima.stop().catch(() => {});\n      }\n      return;\n    }\n  }\n\n  private parseCueOutDuration(value: string): number | undefined {\n    const num = parseFloat(value.trim());\n    if (!Number.isNaN(num)) return num;\n    const match =\n      value.match(/(?:^|[,\\s])DURATION\\s*=\\s*([0-9.]+)/i) ||\n      value.match(/Duration\\s*=\\s*([0-9.]+)/i);\n    if (match && match[1] != null) {\n      const dStr = match[1];\n      const d = parseFloat(dStr);\n      return Number.isNaN(d) ? undefined : d;\n    }\n    return undefined;\n  }\n\n  private parseCueOutCont(\n    value: string\n  ): { elapsed?: number; duration?: number } | undefined {\n    const elapsedMatch = value.match(/Elapsed\\s*=\\s*([0-9.]+)/i);\n    const durationMatch = value.match(/Duration\\s*=\\s*([0-9.]+)/i);\n    const res: { elapsed?: number; duration?: number } = {};\n    if (elapsedMatch && elapsedMatch[1] != null) {\n      const e = parseFloat(elapsedMatch[1]);\n      if (!Number.isNaN(e)) res.elapsed = e;\n    }\n    if (durationMatch && durationMatch[1] != null) {\n      const d = parseFloat(durationMatch[1]);\n      if (!Number.isNaN(d)) res.duration = d;\n    }\n    if (\"elapsed\" in res || \"duration\" in res) return res;\n    return undefined;\n  }\n\n  private parseAttributeList(value: string): Record<string, string> {\n    const attrs: Record<string, string> = {};\n    const regex = /([A-Z0-9-]+)=((\"[^\"]*\")|([^\",]*))(?:,|$)/gi;\n    let match: RegExpExecArray | null;\n    while ((match = regex.exec(value)) !== null) {\n      const key: string = (match[1] ?? \"\") as string;\n      let rawVal: string = (match[3] ?? match[4] ?? \"\") as string;\n      if (rawVal.startsWith('\"') && rawVal.endsWith('\"')) {\n        rawVal = rawVal.slice(1, -1);\n      }\n      if (key) {\n        attrs[key] = rawVal;\n      }\n    }\n    return attrs;\n  }\n\n  private toNumber(val: unknown): number | undefined {\n    if (val == null) return undefined;\n    const n = typeof val === \"string\" ? parseFloat(val) : Number(val);\n    return Number.isNaN(n) ? undefined : n;\n  }\n\n  private isManifestBasedMarker(marker: Scte35Marker): boolean {\n    const raw = marker.raw as any;\n    if (!raw) return false;\n\n    if (raw.tag) {\n      const tag = String(raw.tag);\n      return (\n        tag.includes(\"EXT-X-CUE-OUT\") ||\n        tag.includes(\"EXT-X-CUE-IN\") ||\n        tag.includes(\"EXT-X-DATERANGE\")\n      );\n    }\n\n    if (raw.id3) return false;\n\n    if (raw.splice_command_type) return false;\n\n    return false;\n  }\n\n  private parseScte35Binary(data: Uint8Array): Scte35Marker | undefined {\n    class BitReader {\n      private bytePos = 0;\n      private bitPos = 0;\n      constructor(private readonly buf: Uint8Array) {}\n      readBits(numBits: number): number {\n        let result = 0;\n        while (numBits > 0) {\n          if (this.bytePos >= this.buf.length) return result;\n          const remainingInByte = 8 - this.bitPos;\n          const toRead = Math.min(numBits, remainingInByte);\n          const currentByte = this.buf[this.bytePos]!;\n          const shift = remainingInByte - toRead;\n          const mask = ((1 << toRead) - 1) & 0xff;\n          const bits = (currentByte >> shift) & mask;\n          result = (result << toRead) | bits;\n          this.bitPos += toRead;\n          if (this.bitPos >= 8) {\n            this.bitPos = 0;\n            this.bytePos += 1;\n          }\n          numBits -= toRead;\n        }\n        return result >>> 0;\n      }\n      skipBits(n: number): void {\n        this.readBits(n);\n      }\n    }\n\n    const r = new BitReader(data);\n    const tableId = r.readBits(8);\n    if (tableId !== 0xfc) return undefined;\n    r.readBits(1);\n    r.readBits(1);\n    r.readBits(2);\n    const sectionLength = r.readBits(12);\n    r.readBits(8);\n    r.readBits(1);\n    r.readBits(6);\n    const ptsAdjHigh = r.readBits(1);\n    const ptsAdjLow = r.readBits(32);\n    void ptsAdjHigh;\n    void ptsAdjLow;\n    r.readBits(8);\n    r.readBits(12);\n    const spliceCommandLength = r.readBits(12);\n    const spliceCommandType = r.readBits(8);\n    if (spliceCommandType !== 5) {\n      return undefined;\n    }\n    r.readBits(32);\n    const cancel = r.readBits(1) === 1;\n    r.readBits(7);\n    if (cancel) return undefined;\n    const outOfNetwork = r.readBits(1) === 1;\n    const programSpliceFlag = r.readBits(1) === 1;\n    const durationFlag = r.readBits(1) === 1;\n    const spliceImmediateFlag = r.readBits(1) === 1;\n    r.readBits(4);\n    if (programSpliceFlag && !spliceImmediateFlag) {\n      const timeSpecifiedFlag = r.readBits(1) === 1;\n      if (timeSpecifiedFlag) {\n        r.readBits(6);\n        r.readBits(33);\n      } else {\n        r.readBits(7);\n      }\n    } else if (!programSpliceFlag) {\n      const componentCount = r.readBits(8);\n      for (let i = 0; i < componentCount; i++) {\n        r.readBits(8);\n        if (!spliceImmediateFlag) {\n          const timeSpecifiedFlag = r.readBits(1) === 1;\n          if (timeSpecifiedFlag) {\n            r.readBits(6);\n            r.readBits(33);\n          } else {\n            r.readBits(7);\n          }\n        }\n      }\n    }\n    let durationSeconds: number | undefined = undefined;\n    if (durationFlag) {\n      r.readBits(6);\n      r.readBits(1);\n      const high = r.readBits(1);\n      const low = r.readBits(32);\n      const durationTicks = high * 0x100000000 + low;\n      durationSeconds = durationTicks / 90000;\n    }\n    r.readBits(16);\n    r.readBits(8);\n    r.readBits(8);\n\n    if (outOfNetwork) {\n      const marker: Scte35Marker = {\n        type: \"start\",\n        ...(durationSeconds !== undefined ? { durationSeconds } : {}),\n        raw: { splice_command_type: 5 },\n      } as Scte35Marker;\n      return marker;\n    }\n    return undefined;\n  }\n\n  private initializeTracking(): void {\n    sendInitialTracking(this.config.licenseKey).catch((error) => {\n      if (this.config.debugAdTiming) {\n        console.warn(\n          \"[StormcloudVideoPlayer] Failed to send initial tracking:\",\n          error\n        );\n      }\n    });\n\n    this.heartbeatInterval = window.setInterval(() => {\n      this.sendHeartbeatIfNeeded();\n    }, 5000);\n  }\n\n  private sendHeartbeatIfNeeded(): void {\n    const now = Date.now();\n    if (!this.lastHeartbeatTime || now - this.lastHeartbeatTime > 30000) {\n      this.lastHeartbeatTime = now;\n      sendHeartbeat(this.config.licenseKey).catch((error) => {\n        if (this.config.debugAdTiming) {\n          console.warn(\n            \"[StormcloudVideoPlayer] Failed to send heartbeat:\",\n            error\n          );\n        }\n      });\n    }\n  }\n\n  private async fetchAdConfiguration(): Promise<void> {\n    const apiUrl = \"https://adstorm.co/api-adstorm-dev/adstorm/ads/web\";\n\n    if (this.config.debugAdTiming) {\n      console.log(\n        \"[StormcloudVideoPlayer] Fetching ad configuration from:\",\n        apiUrl\n      );\n    }\n\n    const headers: Record<string, string> = {};\n    if (this.config.licenseKey) {\n      headers[\"Authorization\"] = `Bearer ${this.config.licenseKey}`;\n    }\n\n    const response = await fetch(apiUrl, { headers });\n    if (!response.ok) {\n      throw new Error(`Failed to fetch ad configuration: ${response.status}`);\n    }\n\n    const data: StormcloudApiResponse = await response.json();\n\n    const imaPayload = data.response?.ima?.[\"publisherdesk.ima\"]?.payload;\n    if (imaPayload) {\n      this.apiVastTagUrl = decodeURIComponent(imaPayload);\n      if (this.config.debugAdTiming) {\n        console.log(\n          \"[StormcloudVideoPlayer] Extracted VAST tag URL:\",\n          this.apiVastTagUrl\n        );\n      }\n    }\n\n    this.vastConfig = data.response?.options?.vast;\n\n    if (this.config.debugAdTiming) {\n      console.log(\"[StormcloudVideoPlayer] Ad configuration loaded:\", {\n        vastTagUrl: this.apiVastTagUrl,\n        vastConfig: this.vastConfig,\n      });\n    }\n  }\n\n  getCurrentAdIndex(): number {\n    return this.currentAdIndex;\n  }\n\n  getTotalAdsInBreak(): number {\n    return this.totalAdsInBreak;\n  }\n\n  isAdPlaying(): boolean {\n    return this.inAdBreak && this.ima.isAdPlaying();\n  }\n\n  isShowingAds(): boolean {\n    return this.showAds;\n  }\n\n  getStreamType(): \"hls\" | \"other\" {\n    const url = this.config.src.toLowerCase();\n    if (\n      url.includes(\".m3u8\") ||\n      url.includes(\"/hls/\") ||\n      url.includes(\"application/vnd.apple.mpegurl\")\n    ) {\n      return \"hls\";\n    }\n    return \"other\";\n  }\n\n  shouldShowNativeControls(): boolean {\n    const streamType = this.getStreamType();\n    if (streamType === \"other\") {\n      return !(this.config.showCustomControls ?? false);\n    }\n    return !!(\n      this.config.allowNativeHls && !(this.config.showCustomControls ?? false)\n    );\n  }\n\n  private shouldContinueLiveStreamDuringAds(): boolean {\n    if (this.config.allowNativeHls) {\n      return false;\n    }\n\n    if (!this.isLiveStream) {\n      return false;\n    }\n\n    return true;\n  }\n\n  async loadDefaultVastFromAdstorm(\n    adstormApiUrl: string,\n    params?: Record<string, string>\n  ): Promise<void> {\n    const usp = new URLSearchParams(params || {});\n    const url = `${adstormApiUrl}?${usp.toString()}`;\n    const res = await fetch(url);\n    if (!res.ok) throw new Error(`Failed to fetch adstorm ads: ${res.status}`);\n    const data = await res.json();\n    const tag = data?.adTagUrl || data?.vastTagUrl || data?.tagUrl;\n    if (typeof tag === \"string\" && tag.length > 0) {\n      this.apiVastTagUrl = tag;\n    }\n  }\n\n  private async handleAdStart(_marker: Scte35Marker): Promise<void> {\n    const scheduled = this.findCurrentOrNextBreak(\n      this.video.currentTime * 1000\n    );\n    const tags = this.selectVastTagsForBreak(scheduled);\n\n    let vastTagUrl: string | undefined;\n    let adsNumber = 1;\n\n    if (this.apiVastTagUrl) {\n      vastTagUrl = this.apiVastTagUrl;\n\n      if (this.vastConfig) {\n        const isHls =\n          this.config.src.includes(\".m3u8\") || this.config.src.includes(\"hls\");\n        if (isHls && this.vastConfig.cue_tones?.number_ads) {\n          adsNumber = this.vastConfig.cue_tones.number_ads;\n        } else if (!isHls && this.vastConfig.timer_vod?.number_ads) {\n          adsNumber = this.vastConfig.timer_vod.number_ads;\n        }\n      }\n\n      this.adPodQueue = new Array(adsNumber - 1).fill(vastTagUrl);\n      this.currentAdIndex = 0;\n      this.totalAdsInBreak = adsNumber;\n\n      if (this.config.debugAdTiming) {\n        console.log(\n          `[StormcloudVideoPlayer] Using API VAST tag with ${adsNumber} ads:`,\n          vastTagUrl\n        );\n      }\n    } else if (tags && tags.length > 0) {\n      vastTagUrl = tags[0] as string;\n      const rest = tags.slice(1);\n      this.adPodQueue = rest;\n      this.currentAdIndex = 0;\n      this.totalAdsInBreak = tags.length;\n\n      if (this.config.debugAdTiming) {\n        console.log(\n          \"[StormcloudVideoPlayer] Using scheduled VAST tag:\",\n          vastTagUrl\n        );\n      }\n    } else {\n      if (this.config.debugAdTiming) {\n        console.log(\"[StormcloudVideoPlayer] No VAST tag available for ad\");\n      }\n      return;\n    }\n\n    if (vastTagUrl) {\n      this.showAds = true;\n      this.currentAdIndex++;\n      await this.playSingleAd(vastTagUrl);\n    }\n    if (\n      this.expectedAdBreakDurationMs == null &&\n      scheduled?.durationMs != null\n    ) {\n      this.expectedAdBreakDurationMs = scheduled.durationMs;\n      this.currentAdBreakStartWallClockMs =\n        this.currentAdBreakStartWallClockMs ?? Date.now();\n      this.scheduleAdStopCountdown(this.expectedAdBreakDurationMs);\n    }\n  }\n\n  private findCurrentOrNextBreak(nowMs: number): AdBreak | undefined {\n    const schedule: AdBreak[] = [];\n    let candidate: AdBreak | undefined;\n    for (const b of schedule) {\n      const tol = this.config.driftToleranceMs ?? 1000;\n      if (\n        b.startTimeMs <= nowMs + tol &&\n        (candidate == null || b.startTimeMs > (candidate.startTimeMs || 0))\n      ) {\n        candidate = b;\n      }\n    }\n    return candidate;\n  }\n\n  private onTimeUpdate(currentTimeSec: number): void {\n    if (this.ima.isAdPlaying()) return;\n    const nowMs = currentTimeSec * 1000;\n    const breakToPlay = this.findBreakForTime(nowMs);\n    if (breakToPlay) {\n      this.handleMidAdJoin(breakToPlay, nowMs);\n    }\n  }\n\n  private async handleMidAdJoin(\n    adBreak: AdBreak,\n    nowMs: number\n  ): Promise<void> {\n    const durationMs = adBreak.durationMs ?? 0;\n    const endMs = adBreak.startTimeMs + durationMs;\n    if (durationMs > 0 && nowMs > adBreak.startTimeMs && nowMs < endMs) {\n      const remainingMs = endMs - nowMs;\n      const tags =\n        this.selectVastTagsForBreak(adBreak) ||\n        (this.apiVastTagUrl ? [this.apiVastTagUrl] : undefined);\n      if (tags && tags.length > 0) {\n        const first = tags[0] as string;\n        const rest = tags.slice(1);\n        this.adPodQueue = rest;\n        await this.playSingleAd(first);\n        this.inAdBreak = true;\n        this.expectedAdBreakDurationMs = remainingMs;\n        this.currentAdBreakStartWallClockMs = Date.now();\n        this.scheduleAdStopCountdown(remainingMs);\n      }\n    }\n  }\n\n  private scheduleAdStopCountdown(remainingMs: number): void {\n    this.clearAdStopTimer();\n    const ms = Math.max(0, Math.floor(remainingMs));\n    if (ms === 0) {\n      this.ensureAdStoppedByTimer();\n      return;\n    }\n    this.adStopTimerId = window.setTimeout(() => {\n      this.ensureAdStoppedByTimer();\n    }, ms) as unknown as number;\n  }\n\n  private clearAdStopTimer(): void {\n    if (this.adStopTimerId != null) {\n      clearTimeout(this.adStopTimerId);\n      this.adStopTimerId = undefined;\n    }\n  }\n\n  private ensureAdStoppedByTimer(): void {\n    if (!this.inAdBreak) return;\n    this.inAdBreak = false;\n    this.expectedAdBreakDurationMs = undefined;\n    this.currentAdBreakStartWallClockMs = undefined;\n    this.adStopTimerId = undefined;\n    if (this.ima.isAdPlaying()) {\n      this.ima.stop().catch(() => {});\n    }\n  }\n\n  private scheduleAdStartIn(delayMs: number): void {\n    this.clearAdStartTimer();\n    const ms = Math.max(0, Math.floor(delayMs));\n    if (ms === 0) {\n      this.handleAdStart({ type: \"start\" } as Scte35Marker).catch(() => {});\n      return;\n    }\n    this.adStartTimerId = window.setTimeout(() => {\n      this.handleAdStart({ type: \"start\" } as Scte35Marker).catch(() => {});\n    }, ms) as unknown as number;\n  }\n\n  private clearAdStartTimer(): void {\n    if (this.adStartTimerId != null) {\n      clearTimeout(this.adStartTimerId);\n      this.adStartTimerId = undefined;\n    }\n  }\n\n  private updatePtsDrift(ptsSecondsSample: number): void {\n    const sampleMs = (this.video.currentTime - ptsSecondsSample) * 1000;\n    if (!Number.isFinite(sampleMs) || Math.abs(sampleMs) > 60000) return;\n    const alpha = 0.1;\n    this.ptsDriftEmaMs = this.ptsDriftEmaMs * (1 - alpha) + sampleMs * alpha;\n  }\n\n  private async playSingleAd(vastTagUrl: string): Promise<void> {\n    if (this.config.debugAdTiming) {\n      console.log(\"[StormcloudVideoPlayer] Attempting to play ad:\", vastTagUrl);\n    }\n\n    this.startAdFailsafeTimer();\n\n    try {\n      await this.ima.requestAds(vastTagUrl);\n      await this.ima.play();\n\n      if (this.config.debugAdTiming) {\n        console.log(\"[StormcloudVideoPlayer] Ad playback started successfully\");\n      }\n    } catch (error) {\n      if (this.config.debugAdTiming) {\n        console.error(\"[StormcloudVideoPlayer] Ad playback failed:\", error);\n      }\n\n      this.handleAdFailure();\n    }\n  }\n\n  private handleAdFailure(): void {\n    if (this.config.debugAdTiming) {\n      console.log(\n        \"[StormcloudVideoPlayer] Handling ad failure - resuming content\"\n      );\n    }\n\n    this.inAdBreak = false;\n    this.expectedAdBreakDurationMs = undefined;\n    this.currentAdBreakStartWallClockMs = undefined;\n    this.clearAdStartTimer();\n    this.clearAdStopTimer();\n    this.clearAdFailsafeTimer();\n    this.adPodQueue = [];\n    this.showAds = false;\n    this.currentAdIndex = 0;\n    this.totalAdsInBreak = 0;\n\n    if (this.video.paused) {\n      this.video.play().catch(() => {\n        if (this.config.debugAdTiming) {\n          console.error(\n            \"[StormcloudVideoPlayer] Failed to resume video after ad failure\"\n          );\n        }\n      });\n    }\n  }\n\n  private startAdFailsafeTimer(): void {\n    this.clearAdFailsafeTimer();\n\n    const failsafeMs = this.config.adFailsafeTimeoutMs ?? 10000;\n\n    if (this.config.debugAdTiming) {\n      console.log(\n        `[StormcloudVideoPlayer] Starting failsafe timer (${failsafeMs}ms)`\n      );\n    }\n\n    this.adFailsafeTimerId = window.setTimeout(() => {\n      if (this.video.paused) {\n        if (this.config.debugAdTiming) {\n          console.warn(\n            \"[StormcloudVideoPlayer] Failsafe timer triggered - forcing video resume\"\n          );\n        }\n        this.handleAdFailure();\n      }\n    }, failsafeMs) as unknown as number;\n  }\n\n  private clearAdFailsafeTimer(): void {\n    if (this.adFailsafeTimerId != null) {\n      clearTimeout(this.adFailsafeTimerId);\n      this.adFailsafeTimerId = undefined;\n    }\n  }\n\n  private selectVastTagsForBreak(b?: AdBreak): string[] | undefined {\n    if (!b || !b.vastTagUrl) return undefined;\n    if (b.vastTagUrl.includes(\",\")) {\n      return b.vastTagUrl\n        .split(\",\")\n        .map((s) => s.trim())\n        .filter((s) => s.length > 0);\n    }\n    return [b.vastTagUrl];\n  }\n\n  private getRemainingAdMs(): number {\n    if (\n      this.expectedAdBreakDurationMs == null ||\n      this.currentAdBreakStartWallClockMs == null\n    )\n      return 0;\n    const elapsed = Date.now() - this.currentAdBreakStartWallClockMs;\n    return Math.max(0, this.expectedAdBreakDurationMs - elapsed);\n  }\n\n  private findBreakForTime(nowMs: number): AdBreak | undefined {\n    const schedule: AdBreak[] = [];\n    for (const b of schedule) {\n      const end = (b.startTimeMs || 0) + (b.durationMs || 0);\n      if (\n        nowMs >= (b.startTimeMs || 0) &&\n        (b.durationMs ? nowMs < end : true)\n      ) {\n        return b;\n      }\n    }\n    return undefined;\n  }\n\n  toggleMute(): void {\n    if (this.ima.isAdPlaying()) {\n      const currentPerceptualState = this.isMuted();\n      const newMutedState = !currentPerceptualState;\n\n      this.ima.updateOriginalMutedState(newMutedState);\n      this.ima.setAdVolume(newMutedState ? 0 : 1);\n\n      if (this.config.debugAdTiming) {\n        console.log(\n          \"[StormcloudVideoPlayer] Mute toggle during ad - immediately applied:\",\n          newMutedState\n        );\n      }\n    } else {\n      this.video.muted = !this.video.muted;\n      if (this.config.debugAdTiming) {\n        console.log(\"[StormcloudVideoPlayer] Muted:\", this.video.muted);\n      }\n    }\n  }\n\n  toggleFullscreen(): Promise<void> {\n    return new Promise((resolve, reject) => {\n      if (!document.fullscreenElement) {\n        const container = this.video.parentElement;\n        if (!container) {\n          reject(new Error(\"No parent container found for fullscreen\"));\n          return;\n        }\n        container\n          .requestFullscreen()\n          .then(() => {\n            if (this.config.debugAdTiming) {\n              console.log(\"[StormcloudVideoPlayer] Entered fullscreen\");\n            }\n            resolve();\n          })\n          .catch((err) => {\n            if (this.config.debugAdTiming) {\n              console.error(\"[StormcloudVideoPlayer] Fullscreen error:\", err);\n            }\n            reject(err);\n          });\n      } else {\n        document\n          .exitFullscreen()\n          .then(() => {\n            if (this.config.debugAdTiming) {\n              console.log(\"[StormcloudVideoPlayer] Exited fullscreen\");\n            }\n            resolve();\n          })\n          .catch((err) => {\n            if (this.config.debugAdTiming) {\n              console.error(\n                \"[StormcloudVideoPlayer] Exit fullscreen error:\",\n                err\n              );\n            }\n            reject(err);\n          });\n      }\n    });\n  }\n\n  isMuted(): boolean {\n    if (this.ima.isAdPlaying()) {\n      const adVolume = this.ima.getAdVolume();\n      return adVolume === 0;\n    }\n    return this.video.muted;\n  }\n\n  isFullscreen(): boolean {\n    return !!document.fullscreenElement;\n  }\n\n  isLive(): boolean {\n    return this.isLiveStream;\n  }\n\n  get videoElement(): HTMLVideoElement {\n    return this.video;\n  }\n\n  resize(): void {\n    if (this.config.debugAdTiming) {\n      console.log(\"[StormcloudVideoPlayer] Resizing player\");\n    }\n\n    if (this.ima && this.ima.isAdPlaying()) {\n      const width = this.video.clientWidth || 640;\n      const height = this.video.clien