stormcloud-video-player 0.2.16 → 0.2.18

package/lib/index.cjs

@@ -267,6 +267,13 @@ function createImaController(video, options) {
   let adPlaying = false;
   let originalMutedState = false;
   const listeners = /* @__PURE__ */ new Map();
+  function setAdPlayingFlag(isPlaying) {
+    if (isPlaying) {
+      video.dataset.stormcloudAdPlaying = "true";
+    } else {
+      delete video.dataset.stormcloudAdPlaying;
+    }
+  }
   function emit(event, payload) {
     const set = listeners.get(event);
     if (!set) return;
@@ -351,6 +358,14 @@ function createImaController(video, options) {
   function makeAdsRequest(google, vastTagUrl) {
     const adsRequest = new google.ima.AdsRequest();
     adsRequest.adTagUrl = vastTagUrl;
+    const videoWidth = video.offsetWidth || video.clientWidth || 640;
+    const videoHeight = video.offsetHeight || video.clientHeight || 360;
+    adsRequest.linearAdSlotWidth = videoWidth;
+    adsRequest.linearAdSlotHeight = videoHeight;
+    adsRequest.nonLinearAdSlotWidth = videoWidth;
+    adsRequest.nonLinearAdSlotHeight = videoHeight;
+    adsRequest.vastLoadTimeout = 5e3;
+    console.log(`[IMA] Ads request dimensions: ${videoWidth}x${videoHeight}`);
     adsLoader.requestAds(adsRequest);
   }
   function destroyAdsManager() {
@@ -397,6 +412,18 @@ function createImaController(video, options) {
     },
     async requestAds(vastTagUrl) {
       console.log("[IMA] Requesting ads:", vastTagUrl);
+      if (!vastTagUrl || vastTagUrl.trim() === "") {
+        const error = new Error("VAST tag URL is empty or undefined");
+        console.warn("[IMA]", error.message);
+        return Promise.reject(error);
+      }
+      try {
+        new URL(vastTagUrl);
+      } catch (e) {
+        const error = new Error(`Invalid VAST tag URL format: ${vastTagUrl}`);
+        console.warn("[IMA]", error.message);
+        return Promise.reject(error);
+      }
       if (adPlaying) {
         console.warn(
           "[IMA] Cannot request new ads while an ad is playing. Call stop() first."
@@ -458,6 +485,18 @@ function createImaController(video, options) {
             );
           }
         }
+        const videoWidth = video.offsetWidth || video.clientWidth;
+        const videoHeight = video.offsetHeight || video.clientHeight;
+        if (!videoWidth || !videoHeight || videoWidth === 0 || videoHeight === 0) {
+          const error = new Error(
+            `Invalid video dimensions: ${videoWidth}x${videoHeight}. Cannot initialize ads.`
+          );
+          console.warn("[IMA]", error.message);
+          currentReject == null ? void 0 : currentReject(error);
+          adsLoadedReject = void 0;
+          adsLoadedResolve = void 0;
+          return Promise.reject(error);
+        }
         if (!adsLoader) {
           console.log("[IMA] Creating ads loader");
           const adsLoaderCls = new google.ima.AdsLoader(adDisplayContainer);
@@ -477,7 +516,12 @@ function createImaController(video, options) {
                     console.error("[IMA] Ad error:", errorEvent.getError());
                     destroyAdsManager();
                     adPlaying = false;
+                    const previousMutedState = video.muted;
                     video.muted = originalMutedState;
+                    setAdPlayingFlag(false);
+                    console.log(
+                      `[IMA] Restored mute state after ad error: ${previousMutedState} -> ${originalMutedState}`
+                    );
                     if (adContainerEl) {
                       adContainerEl.style.pointerEvents = "none";
                       adContainerEl.style.display = "none";
@@ -506,7 +550,9 @@ function createImaController(video, options) {
                       emit("ad_error");
                       if (!(options == null ? void 0 : options.continueLiveStreamDuringAds)) {
                         if (video.paused) {
-                          console.log("[IMA] Resuming paused video after ad error");
+                          console.log(
+                            "[IMA] Resuming paused video after ad error"
+                          );
                           (_a = video.play()) == null ? void 0 : _a.catch(() => {
                           });
                         }
@@ -528,11 +574,13 @@ function createImaController(video, options) {
                     }
                     video.muted = true;
                     adPlaying = true;
+                    setAdPlayingFlag(true);
                     emit("content_pause");
                   }
                 );
                 adsManager.addEventListener(AdEvent.STARTED, () => {
                   console.log("[IMA] Ad started playing");
+                  setAdPlayingFlag(true);
                   if (adContainerEl) {
                     adContainerEl.style.pointerEvents = "auto";
                     adContainerEl.style.display = "flex";
@@ -548,6 +596,7 @@ function createImaController(video, options) {
                     console.log("[IMA] Content resume requested");
                     adPlaying = false;
                     video.muted = originalMutedState;
+                    setAdPlayingFlag(false);
                     if (adContainerEl) {
                       adContainerEl.style.pointerEvents = "none";
                       adContainerEl.style.display = "none";
@@ -571,6 +620,7 @@ function createImaController(video, options) {
                   console.log("[IMA] All ads completed");
                   adPlaying = false;
                   video.muted = originalMutedState;
+                  setAdPlayingFlag(false);
                   if (adContainerEl) {
                     adContainerEl.style.pointerEvents = "none";
                     adContainerEl.style.display = "none";
@@ -601,6 +651,7 @@ function createImaController(video, options) {
                 console.error("[IMA] Error setting up ads manager:", e);
                 adPlaying = false;
                 video.muted = originalMutedState;
+                setAdPlayingFlag(false);
                 if (adContainerEl) {
                   adContainerEl.style.pointerEvents = "none";
                   adContainerEl.style.display = "none";
@@ -608,7 +659,9 @@ function createImaController(video, options) {
                 }
                 if (!(options == null ? void 0 : options.continueLiveStreamDuringAds)) {
                   if (video.paused) {
-                    console.log("[IMA] Resuming paused video after setup error");
+                    console.log(
+                      "[IMA] Resuming paused video after setup error"
+                    );
                     video.play().catch(() => {
                     });
                   }
@@ -628,7 +681,12 @@ function createImaController(video, options) {
             (adErrorEvent) => {
               console.error("[IMA] Ads loader error:", adErrorEvent.getError());
               adPlaying = false;
+              const previousMutedState = video.muted;
               video.muted = originalMutedState;
+              setAdPlayingFlag(false);
+              console.log(
+                `[IMA] Restored mute state: ${previousMutedState} -> ${originalMutedState}`
+              );
               if (adContainerEl) {
                 adContainerEl.style.pointerEvents = "none";
                 adContainerEl.style.display = "none";
@@ -680,12 +738,20 @@ function createImaController(video, options) {
         console.log(`[IMA] Initializing ads manager (${width}x${height})`);
         adsManager.init(width, height, window.google.ima.ViewMode.NORMAL);
         adPlaying = true;
+        const adVolume = originalMutedState ? 0 : video.volume;
+        try {
+          adsManager.setVolume(adVolume);
+          console.log(`[IMA] Set ad volume to ${adVolume}`);
+        } catch (error) {
+          console.warn("[IMA] Failed to set ad volume:", error);
+        }
         console.log("[IMA] Starting ad playback");
         adsManager.start();
         return Promise.resolve();
       } catch (error) {
         console.error("[IMA] Error starting ad playback:", error);
         adPlaying = false;
+        setAdPlayingFlag(false);
         if (!(options == null ? void 0 : options.continueLiveStreamDuringAds)) {
           (_b = video.play()) == null ? void 0 : _b.catch(() => {
           });
@@ -697,6 +763,7 @@ function createImaController(video, options) {
       var _a;
       adPlaying = false;
       video.muted = originalMutedState;
+      setAdPlayingFlag(false);
       if (adContainerEl) {
         adContainerEl.style.pointerEvents = "none";
         adContainerEl.style.display = "none";
@@ -720,6 +787,7 @@ function createImaController(video, options) {
       destroyAdsManager();
       adPlaying = false;
       video.muted = originalMutedState;
+      setAdPlayingFlag(false);
       if (adContainerEl) {
         adContainerEl.style.pointerEvents = "none";
         adContainerEl.style.display = "none";
@@ -762,6 +830,9 @@ function createImaController(video, options) {
       (_a = listeners.get(event)) == null ? void 0 : _a.delete(listener);
     },
     updateOriginalMutedState(muted) {
+      console.log(
+        `[IMA] updateOriginalMutedState called: ${originalMutedState} -> ${muted}`
+      );
       originalMutedState = muted;
     },
     getOriginalMutedState() {
@@ -818,7 +889,10 @@ function createHlsAdPlayer(contentVideo, options) {
       try {
         fn(payload);
       } catch (error) {
-        console.warn(`[HlsAdPlayer] Error in event listener for ${event}:`, error);
+        console.warn(
+          `[HlsAdPlayer] Error in event listener for ${event}:`,
+          error
+        );
       }
     }
   }
@@ -881,7 +955,9 @@ function createHlsAdPlayer(contentVideo, options) {
     }
     const mainQuality = getMainStreamQuality();
     if (!mainQuality) {
-      console.log("[HlsAdPlayer] No main stream quality info, using first media file");
+      console.log(
+        "[HlsAdPlayer] No main stream quality info, using first media file"
+      );
       return firstFile;
     }
     console.log("[HlsAdPlayer] Main stream quality:", mainQuality);
@@ -917,7 +993,10 @@ function createHlsAdPlayer(contentVideo, options) {
       const xmlDoc = parser.parseFromString(xmlString, "text/xml");
       const parserError = xmlDoc.querySelector("parsererror");
       if (parserError) {
-        console.error("[HlsAdPlayer] XML parsing error (malformed VAST XML):", parserError.textContent);
+        console.error(
+          "[HlsAdPlayer] XML parsing error (malformed VAST XML):",
+          parserError.textContent
+        );
         return null;
       }
       const adElement = xmlDoc.querySelector("Ad");
@@ -933,17 +1012,23 @@ function createHlsAdPlayer(contentVideo, options) {
       const duration = parseInt(durationParts[0] || "0", 10) * 3600 + parseInt(durationParts[1] || "0", 10) * 60 + parseInt(durationParts[2] || "0", 10);
       const mediaFileElements = xmlDoc.querySelectorAll("MediaFile");
       const mediaFiles = [];
-      console.log(`[HlsAdPlayer] Found ${mediaFileElements.length} MediaFile element(s) in VAST XML`);
+      console.log(
+        `[HlsAdPlayer] Found ${mediaFileElements.length} MediaFile element(s) in VAST XML`
+      );
       mediaFileElements.forEach((mf, index) => {
         var _a2;
         const type = mf.getAttribute("type") || "";
         const url = ((_a2 = mf.textContent) == null ? void 0 : _a2.trim()) || "";
         const width = mf.getAttribute("width") || "";
         const height = mf.getAttribute("height") || "";
-        console.log(`[HlsAdPlayer] MediaFile ${index}: type="${type}", url="${url}", width="${width}", height="${height}"`);
+        console.log(
+          `[HlsAdPlayer] MediaFile ${index}: type="${type}", url="${url}", width="${width}", height="${height}"`
+        );
         if (type === "application/x-mpegURL" || type.includes("m3u8")) {
           if (!url) {
-            console.warn(`[HlsAdPlayer] MediaFile ${index} has HLS type but empty URL`);
+            console.warn(
+              `[HlsAdPlayer] MediaFile ${index} has HLS type but empty URL`
+            );
             return;
           }
           const bitrateAttr = mf.getAttribute("bitrate");
@@ -957,12 +1042,16 @@ function createHlsAdPlayer(contentVideo, options) {
           });
           console.log(`[HlsAdPlayer] Added HLS MediaFile: ${url}`);
         } else {
-          console.log(`[HlsAdPlayer] MediaFile ${index} ignored (type="${type}" is not HLS)`);
+          console.log(
+            `[HlsAdPlayer] MediaFile ${index} ignored (type="${type}" is not HLS)`
+          );
         }
       });
       if (mediaFiles.length === 0) {
         if (isNoAdAvailable) {
-          console.warn("[HlsAdPlayer] No ads available (VAST response indicates no ads)");
+          console.warn(
+            "[HlsAdPlayer] No ads available (VAST response indicates no ads)"
+          );
         } else {
           console.warn("[HlsAdPlayer] No HLS media files found in VAST XML");
         }
@@ -1025,6 +1114,10 @@ function createHlsAdPlayer(contentVideo, options) {
     video.style.backgroundColor = "#000";
     video.playsInline = true;
     video.muted = false;
+    video.volume = 1;
+    console.log(
+      `[HlsAdPlayer] Created ad video element with volume ${video.volume}`
+    );
     return video;
   }
   function setupAdEventListeners() {
@@ -1084,10 +1177,22 @@ function createHlsAdPlayer(contentVideo, options) {
       }
     });
   }
+  function setAdPlayingFlag(isPlaying) {
+    if (isPlaying) {
+      contentVideo.dataset.stormcloudAdPlaying = "true";
+    } else {
+      delete contentVideo.dataset.stormcloudAdPlaying;
+    }
+  }
   function handleAdComplete() {
     console.log("[HlsAdPlayer] Handling ad completion");
     adPlaying = false;
+    setAdPlayingFlag(false);
+    const previousMutedState = contentVideo.muted;
     contentVideo.muted = originalMutedState;
+    console.log(
+      `[HlsAdPlayer] Restored mute state: ${previousMutedState} -> ${originalMutedState}`
+    );
     if (adContainerEl) {
       adContainerEl.style.display = "none";
       adContainerEl.style.pointerEvents = "none";
@@ -1105,7 +1210,12 @@ function createHlsAdPlayer(contentVideo, options) {
   function handleAdError() {
     console.log("[HlsAdPlayer] Handling ad error");
     adPlaying = false;
+    setAdPlayingFlag(false);
+    const previousMutedState = contentVideo.muted;
     contentVideo.muted = originalMutedState;
+    console.log(
+      `[HlsAdPlayer] Restored mute state: ${previousMutedState} -> ${originalMutedState}`
+    );
     if (adContainerEl) {
       adContainerEl.style.display = "none";
       adContainerEl.style.pointerEvents = "none";
@@ -1142,7 +1252,9 @@ function createHlsAdPlayer(contentVideo, options) {
     async requestAds(vastTagUrl) {
       console.log("[HlsAdPlayer] Requesting ads:", vastTagUrl);
       if (adPlaying) {
-        console.warn("[HlsAdPlayer] Cannot request new ads while an ad is playing");
+        console.warn(
+          "[HlsAdPlayer] Cannot request new ads while an ad is playing"
+        );
         return Promise.reject(new Error("Ad already playing"));
       }
       try {
@@ -1153,14 +1265,20 @@ function createHlsAdPlayer(contentVideo, options) {
         }
         const vastXml = await response.text();
         console.log("[HlsAdPlayer] VAST XML received");
-        console.log("[HlsAdPlayer] VAST XML content (first 2000 chars):", vastXml.substring(0, 2e3));
+        console.log(
+          "[HlsAdPlayer] VAST XML content (first 2000 chars):",
+          vastXml.substring(0, 2e3)
+        );
         const ad = parseVastXml(vastXml);
         if (!ad) {
           console.warn("[HlsAdPlayer] No ads available from VAST response");
+          emit("ad_error");
           return Promise.resolve();
         }
         currentAd = ad;
-        console.log(`[HlsAdPlayer] Ad parsed: ${ad.title}, duration: ${ad.duration}s`);
+        console.log(
+          `[HlsAdPlayer] Ad parsed: ${ad.title}, duration: ${ad.duration}s`
+        );
         fireTrackingPixels(ad.trackingUrls.impression);
         trackingFired.impression = true;
         return Promise.resolve();
@@ -1172,7 +1290,9 @@ function createHlsAdPlayer(contentVideo, options) {
     },
     async play() {
       if (!currentAd) {
-        console.warn("[HlsAdPlayer] Cannot play: No ad loaded (no ads available)");
+        console.warn(
+          "[HlsAdPlayer] Cannot play: No ad loaded (no ads available)"
+        );
         return Promise.reject(new Error("No ad loaded"));
       }
       console.log("[HlsAdPlayer] Starting ad playback");
@@ -1190,6 +1310,7 @@ function createHlsAdPlayer(contentVideo, options) {
           thirdQuartile: false,
           complete: false
         };
+        const contentVolume = contentVideo.volume;
         if (!(options == null ? void 0 : options.continueLiveStreamDuringAds)) {
           contentVideo.pause();
           console.log("[HlsAdPlayer] Content paused (VOD mode)");
@@ -1198,6 +1319,15 @@ function createHlsAdPlayer(contentVideo, options) {
         }
         contentVideo.muted = true;
         adPlaying = true;
+        setAdPlayingFlag(true);
+        if (adVideoElement) {
+          const adVolume = originalMutedState ? 0 : contentVolume;
+          adVideoElement.volume = Math.max(0, Math.min(1, adVolume));
+          adVideoElement.muted = false;
+          console.log(
+            `[HlsAdPlayer] Set ad video volume to ${adVideoElement.volume}, muted: ${adVideoElement.muted}, originalMutedState: ${originalMutedState}, contentVolume: ${contentVolume}`
+          );
+        }
         if (adContainerEl) {
           adContainerEl.style.display = "flex";
           adContainerEl.style.pointerEvents = "auto";
@@ -1250,6 +1380,7 @@ function createHlsAdPlayer(contentVideo, options) {
     async stop() {
       console.log("[HlsAdPlayer] Stopping ad");
       adPlaying = false;
+      setAdPlayingFlag(false);
       contentVideo.muted = originalMutedState;
       if (adContainerEl) {
         adContainerEl.style.display = "none";
@@ -1272,6 +1403,7 @@ function createHlsAdPlayer(contentVideo, options) {
     destroy() {
       console.log("[HlsAdPlayer] Destroying");
       adPlaying = false;
+      setAdPlayingFlag(false);
       contentVideo.muted = originalMutedState;
       if (adHls) {
         adHls.destroy();
@@ -1313,6 +1445,9 @@ function createHlsAdPlayer(contentVideo, options) {
       (_a = listeners.get(event)) == null ? void 0 : _a.delete(listener);
     },
     updateOriginalMutedState(muted) {
+      console.log(
+        `[HlsAdPlayer] updateOriginalMutedState called: ${originalMutedState} -> ${muted}`
+      );
       originalMutedState = muted;
     },
     getOriginalMutedState() {
@@ -1805,6 +1940,9 @@ var StormcloudVideoPlayer = class {
     this.isLiveStream = false;
     this.nativeHlsMode = false;
     this.videoSrcProtection = null;
+    this.bufferedSegmentsCount = 0;
+    this.shouldAutoplayAfterBuffering = false;
+    this.hasInitialBufferCompleted = false;
     initializePolyfills();
     const browserOverrides = getBrowserConfigOverrides();
     this.config = { ...config, ...browserOverrides };
@@ -1891,14 +2029,22 @@ var StormcloudVideoPlayer = class {
       liveDurationInfinity: true,
       lowLatencyMode: !!this.config.lowLatencyMode,
       maxLiveSyncPlaybackRate: this.config.lowLatencyMode ? 1.5 : 1,
-      ...this.config.lowLatencyMode ? { liveSyncDuration: 2 } : {}
+      ...this.config.lowLatencyMode ? { liveSyncDuration: 2 } : {},
+      maxBufferLength: 30,
+      maxMaxBufferLength: 600,
+      maxBufferSize: 60 * 1e3 * 1e3,
+      maxBufferHole: 0.5,
+      highBufferWatchdogPeriod: 2,
+      nudgeOffset: 0.1,
+      nudgeMaxRetry: 3,
+      startPosition: -1
     });
     this.hls.on(import_hls2.default.Events.MEDIA_ATTACHED, () => {
       var _a2;
       (_a2 = this.hls) == null ? void 0 : _a2.loadSource(this.config.src);
     });
     this.hls.on(import_hls2.default.Events.MANIFEST_PARSED, async (_, data) => {
-      var _a2, _b2, _c, _d;
+      var _a2, _b2, _c, _d, _e;
       this.isLiveStream = (_c = (_b2 = (_a2 = this.hls) == null ? void 0 : _a2.levels) == null ? void 0 : _b2.some(
         (level) => {
           var _a3, _b3;
@@ -1916,9 +2062,51 @@ var StormcloudVideoPlayer = class {
       this.ima.destroy();
       this.ima = this.createAdPlayer(this.shouldContinueLiveStreamDuringAds());
       this.ima.initialize();
-      if (this.config.autoplay) {
-        await ((_d = this.video.play()) == null ? void 0 : _d.catch(() => {
-        }));
+      this.bufferedSegmentsCount = 0;
+      this.hasInitialBufferCompleted = false;
+      this.shouldAutoplayAfterBuffering = !!this.config.autoplay;
+      const minSegments = (_d = this.config.minSegmentsBeforePlay) != null ? _d : 2;
+      if (this.config.debugAdTiming) {
+        console.log(
+          "[StormcloudVideoPlayer] Waiting for",
+          minSegments,
+          "segments to buffer before playback"
+        );
+      }
+      if (minSegments === 0 || !this.config.autoplay) {
+        this.hasInitialBufferCompleted = true;
+        if (this.config.autoplay) {
+          await ((_e = this.video.play()) == null ? void 0 : _e.catch(() => {
+          }));
+        }
+      }
+    });
+    this.hls.on(import_hls2.default.Events.FRAG_BUFFERED, async (_evt, data) => {
+      var _a2, _b2;
+      if (this.hasInitialBufferCompleted) {
+        return;
+      }
+      this.bufferedSegmentsCount++;
+      const minSegments = (_a2 = this.config.minSegmentsBeforePlay) != null ? _a2 : 2;
+      if (this.config.debugAdTiming) {
+        console.log(
+          `[StormcloudVideoPlayer] Buffered segment ${this.bufferedSegmentsCount}/${minSegments}`
+        );
+      }
+      if (this.bufferedSegmentsCount >= minSegments) {
+        this.hasInitialBufferCompleted = true;
+        if (this.shouldAutoplayAfterBuffering) {
+          if (this.config.debugAdTiming) {
+            console.log(
+              `[StormcloudVideoPlayer] Initial buffer complete (${this.bufferedSegmentsCount} segments). Starting playback.`
+            );
+          }
+          await ((_b2 = this.video.play()) == null ? void 0 : _b2.catch((err) => {
+            if (this.config.debugAdTiming) {
+              console.warn("[StormcloudVideoPlayer] Autoplay failed:", err);
+            }
+          }));
+        }
       }
     });
     this.hls.on(import_hls2.default.Events.FRAG_PARSING_METADATA, (_evt, data) => {
@@ -2014,6 +2202,7 @@ var StormcloudVideoPlayer = class {
     this.video.autoplay = !!this.config.autoplay;
     this.video.muted = !!this.config.muted;
     this.ima.initialize();
+    this.ima.updateOriginalMutedState(this.video.muted);
     this.ima.on("all_ads_completed", () => {
       if (this.config.debugAdTiming) {
         console.log(
@@ -2798,7 +2987,23 @@ var StormcloudVideoPlayer = class {
       }
       return;
     }
-    this.ima.updateOriginalMutedState(this.video.muted);
+    if (!this.showAds) {
+      if (this.config.debugAdTiming) {
+        console.log(
+          `[StormcloudVideoPlayer] Capturing original state before ad request:`,
+          {
+            videoMuted: this.video.muted,
+            videoVolume: this.video.volume,
+            showAds: this.showAds
+          }
+        );
+      }
+      this.ima.updateOriginalMutedState(this.video.muted);
+    } else if (this.config.debugAdTiming) {
+      console.log(
+        `[StormcloudVideoPlayer] Keeping existing original mute state (currently showing ads)`
+      );
+    }
     this.startAdFailsafeTimer();
     try {
       await this.ima.requestAds(vastTagUrl);
@@ -2853,11 +3058,12 @@ var StormcloudVideoPlayer = class {
     this.showAds = false;
     this.currentAdIndex = 0;
     this.totalAdsInBreak = 0;
+    const currentMutedState = this.video.muted;
     const originalMutedState = this.ima.getOriginalMutedState();
     this.video.muted = originalMutedState;
     if (this.config.debugAdTiming) {
       console.log(
-        `[StormcloudVideoPlayer] Restored mute state to: ${originalMutedState}`
+        `[StormcloudVideoPlayer] Restored mute state: ${currentMutedState} -> ${originalMutedState}`
       );
     }
     if (this.video.paused) {
@@ -2949,6 +3155,7 @@ var StormcloudVideoPlayer = class {
       }
     } else {
       this.video.muted = !this.video.muted;
+      this.ima.updateOriginalMutedState(this.video.muted);
       if (this.config.debugAdTiming) {
         console.log("[StormcloudVideoPlayer] Muted:", this.video.muted);
       }
@@ -2993,11 +3200,47 @@ var StormcloudVideoPlayer = class {
   }
   isMuted() {
     if (this.ima.isAdPlaying()) {
-      const adVolume = this.ima.getAdVolume();
-      return adVolume === 0;
+      if (this.config.debugAdTiming) {
+        console.log(
+          "[StormcloudVideoPlayer] isMuted() override during ad playback -> false"
+        );
+      }
+      return false;
+    }
+    if (this.config.debugAdTiming) {
+      console.log(
+        `[StormcloudVideoPlayer] isMuted() no ad playing: video.muted=${this.video.muted}`
+      );
     }
     return this.video.muted;
   }
+  setMuted(muted) {
+    const adPlaying = this.ima.isAdPlaying();
+    if (adPlaying && muted === this.video.muted) {
+      if (this.config.debugAdTiming) {
+        console.log(
+          "[StormcloudVideoPlayer] setMuted reflective update during ad ignored",
+          { muted }
+        );
+      }
+      return;
+    }
+    this.video.muted = muted;
+    if (adPlaying) {
+      this.ima.updateOriginalMutedState(muted);
+      this.ima.setAdVolume(muted ? 0 : 1);
+      if (this.config.debugAdTiming) {
+        console.log("[StormcloudVideoPlayer] setMuted applied during ad", {
+          muted
+        });
+      }
+      return;
+    }
+    this.ima.updateOriginalMutedState(muted);
+    if (this.config.debugAdTiming) {
+      console.log("[StormcloudVideoPlayer] setMuted called:", muted);
+    }
+  }
   isFullscreen() {
     return !!document.fullscreenElement;
   }
@@ -3076,10 +3319,12 @@ var StormcloudVideoPlayerComponent = import_react.default.memo(
       vastMode,
       vastTagUrl,
       adPlayerType,
+      minSegmentsBeforePlay,
       ...restVideoAttrs
     } = props;
     const videoRef = (0, import_react.useRef)(null);
     const playerRef = (0, import_react.useRef)(null);
+    const bufferingTimeoutRef = (0, import_react.useRef)(null);
     const [adStatus, setAdStatus] = import_react.default.useState({ showAds: false, currentIndex: 0, totalAds: 0 });
     const [shouldShowNativeControls, setShouldShowNativeControls] = import_react.default.useState(true);
     const [isMuted, setIsMuted] = import_react.default.useState(false);
@@ -3201,6 +3446,9 @@ var StormcloudVideoPlayerComponent = import_react.default.memo(
         return;
       }
       setShowLicenseWarning(false);
+      if (debugAdTiming) {
+        console.log("[StormcloudUI] Initializing player, isLoading=true");
+      }
       if (playerRef.current) {
         try {
           playerRef.current.destroy();
@@ -3231,17 +3479,25 @@ var StormcloudVideoPlayerComponent = import_react.default.memo(
       if (vastMode !== void 0) cfg.vastMode = vastMode;
       if (vastTagUrl !== void 0) cfg.vastTagUrl = vastTagUrl;
       if (adPlayerType !== void 0) cfg.adPlayerType = adPlayerType;
+      if (minSegmentsBeforePlay !== void 0)
+        cfg.minSegmentsBeforePlay = minSegmentsBeforePlay;
       const player = new StormcloudVideoPlayer(cfg);
       playerRef.current = player;
       player.load().then(() => {
         const showNative = player.shouldShowNativeControls();
         setShouldShowNativeControls(showNative);
+        if (debugAdTiming) {
+          console.log(
+            "[StormcloudUI] Player loaded successfully, waiting for video ready"
+          );
+        }
         onReady == null ? void 0 : onReady(player);
       }).catch((error) => {
         console.error(
           "StormcloudVideoPlayer: Failed to load player:",
           error
         );
+        setIsLoading(false);
         onReady == null ? void 0 : onReady(player);
       });
       return () => {
@@ -3258,8 +3514,8 @@ var StormcloudVideoPlayerComponent = import_react.default.memo(
         if (autoplay !== void 0 && playerRef.current.videoElement) {
           playerRef.current.videoElement.autoplay = autoplay;
         }
-        if (muted !== void 0 && playerRef.current.videoElement) {
-          playerRef.current.videoElement.muted = muted;
+        if (muted !== void 0) {
+          playerRef.current.setMuted(muted);
         }
       } catch (error) {
         console.warn("Failed to update player properties:", error);
@@ -3340,26 +3596,108 @@ var StormcloudVideoPlayerComponent = import_react.default.memo(
     (0, import_react.useEffect)(() => {
       if (!videoRef.current) return;
       const handleLoadedMetadata = () => {
+        var _a;
         if (videoRef.current) {
           const video2 = videoRef.current;
           void video2.offsetHeight;
         }
+        if (debugAdTiming) {
+          console.log(
+            "[StormcloudUI] Video event: loadedmetadata, readyState:",
+            (_a = videoRef.current) == null ? void 0 : _a.readyState
+          );
+        }
+      };
+      const handleLoadedData = () => {
+        var _a;
+        if (debugAdTiming) {
+          console.log(
+            "[StormcloudUI] Video event: loadeddata, readyState:",
+            (_a = videoRef.current) == null ? void 0 : _a.readyState
+          );
+        }
       };
       const handleLoadStart = () => {
-        setIsLoading(true);
-        setIsBuffering(false);
+        var _a;
+        if (debugAdTiming) {
+          console.log(
+            "[StormcloudUI] Video event: loadstart, readyState:",
+            (_a = videoRef.current) == null ? void 0 : _a.readyState
+          );
+        }
       };
       const handleCanPlay = () => {
+        var _a;
+        setIsLoading(false);
+        if (bufferingTimeoutRef.current) {
+          clearTimeout(bufferingTimeoutRef.current);
+          bufferingTimeoutRef.current = null;
+        }
+        setIsBuffering(false);
+        if (debugAdTiming) {
+          console.log(
+            "[StormcloudUI] Video event: canplay, readyState:",
+            (_a = videoRef.current) == null ? void 0 : _a.readyState,
+            "- clearing loading state, isLoading=false"
+          );
+        }
+      };
+      const handleCanPlayThrough = () => {
+        var _a;
         setIsLoading(false);
+        if (bufferingTimeoutRef.current) {
+          clearTimeout(bufferingTimeoutRef.current);
+          bufferingTimeoutRef.current = null;
+        }
         setIsBuffering(false);
+        if (debugAdTiming) {
+          console.log(
+            "[StormcloudUI] Video event: canplaythrough, readyState:",
+            (_a = videoRef.current) == null ? void 0 : _a.readyState,
+            "- clearing loading state, isLoading=false"
+          );
+        }
       };
       const handleWaiting = () => {
-        setIsBuffering(true);
+        var _a;
+        if (bufferingTimeoutRef.current) {
+          clearTimeout(bufferingTimeoutRef.current);
+        }
+        bufferingTimeoutRef.current = window.setTimeout(() => {
+          var _a2;
+          setIsBuffering(true);
+          if (debugAdTiming) {
+            console.log(
+              "[StormcloudUI] Video buffering detected (after 300ms delay), readyState:",
+              (_a2 = videoRef.current) == null ? void 0 : _a2.readyState,
+              "- showing spinner, isBuffering=true"
+            );
+          }
+        }, 300);
+        if (debugAdTiming) {
+          console.log(
+            "[StormcloudUI] Video event: waiting, readyState:",
+            (_a = videoRef.current) == null ? void 0 : _a.readyState,
+            "- buffering delay started (300ms)"
+          );
+        }
       };
       const handlePlaying = () => {
+        var _a;
         setIsLoading(false);
+        if (bufferingTimeoutRef.current) {
+          clearTimeout(bufferingTimeoutRef.current);
+          bufferingTimeoutRef.current = null;
+        }
         setIsBuffering(false);
         setShowCenterPlay(false);
+        if (debugAdTiming) {
+          console.log(
+            "[StormcloudUI] Video event: playing, readyState:",
+            (_a = videoRef.current) == null ? void 0 : _a.readyState,
+            "- playback started, isLoading=false, isBuffering=false"
+          );
+        }
       };
       const handlePause = () => {
         if (playerRef.current && !playerRef.current.isShowingAds()) {
@@ -3374,8 +3712,9 @@ var StormcloudVideoPlayerComponent = import_react.default.memo(
       const video = videoRef.current;
       video.addEventListener("loadstart", handleLoadStart);
       video.addEventListener("loadedmetadata", handleLoadedMetadata);
-      video.addEventListener("loadeddata", handleLoadedMetadata);
+      video.addEventListener("loadeddata", handleLoadedData);
       video.addEventListener("canplay", handleCanPlay);
+      video.addEventListener("canplaythrough", handleCanPlayThrough);
       video.addEventListener("waiting", handleWaiting);
       video.addEventListener("playing", handlePlaying);
       video.addEventListener("pause", handlePause);
@@ -3384,16 +3723,21 @@ var StormcloudVideoPlayerComponent = import_react.default.memo(
         setShowCenterPlay(true);
       }
       return () => {
+        if (bufferingTimeoutRef.current) {
+          clearTimeout(bufferingTimeoutRef.current);
+          bufferingTimeoutRef.current = null;
+        }
         video.removeEventListener("loadstart", handleLoadStart);
         video.removeEventListener("loadedmetadata", handleLoadedMetadata);
-        video.removeEventListener("loadeddata", handleLoadedMetadata);
+        video.removeEventListener("loadeddata", handleLoadedData);
         video.removeEventListener("canplay", handleCanPlay);
+        video.removeEventListener("canplaythrough", handleCanPlayThrough);
         video.removeEventListener("waiting", handleWaiting);
         video.removeEventListener("playing", handlePlaying);
         video.removeEventListener("pause", handlePause);
         video.removeEventListener("ended", handleEnded);
       };
-    }, []);
+    }, [debugAdTiming]);
     return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_jsx_runtime.Fragment, { children: [
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)("style", { children: `
               @keyframes spin {
@@ -3500,35 +3844,18 @@ var StormcloudVideoPlayerComponent = import_react.default.memo(
               }
             ),
             (isLoading || isBuffering) && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-              "div",
+              import_fa.FaSpinner,
               {
+                size: 42,
+                color: "white",
                 style: {
                   position: "absolute",
-                  top: "50%",
-                  left: "50%",
-                  transform: "translate(-50%, -50%)",
+                  top: "calc(50% - 21px)",
+                  left: "calc(50% - 21px)",
                   zIndex: 20,
-                  display: "flex",
-                  alignItems: "center",
-                  justifyContent: "center",
-                  background: "linear-gradient(135deg, rgba(0, 0, 0, 0.8) 0%, rgba(20, 20, 20, 0.6) 100%)",
-                  width: "80px",
-                  height: "80px",
-                  borderRadius: "50%",
-                  backdropFilter: "blur(20px)",
-                  boxShadow: "0 12px 40px rgba(0, 0, 0, 0.6), inset 0 2px 0 rgba(255, 255, 255, 0.1)"
-                },
-                children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-                  import_fa.FaSpinner,
-                  {
-                    size: 28,
-                    color: "white",
-                    style: {
-                      animation: "spin 1s linear infinite",
-                      filter: "drop-shadow(0 3px 6px rgba(0, 0, 0, 0.8))"
-                    }
-                  }
-                )
+                  animation: "spin 1s linear infinite",
+                  filter: "drop-shadow(0 3px 6px rgba(0, 0, 0, 0.8))"
+                }
               }
             ),
             showLicenseWarning && /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
@@ -4641,6 +4968,7 @@ var defaultProps = {
   showCustomControls: false,
   licenseKey: "",
   adFailsafeTimeoutMs: 1e4,
+  minSegmentsBeforePlay: 2,
   onStart: noop,
   onPlay: noop,
   onPause: noop,
@@ -4814,6 +5142,8 @@ var HlsPlayer = class extends import_react3.Component {
           config.licenseKey = this.props.licenseKey;
         if (this.props.adFailsafeTimeoutMs !== void 0)
           config.adFailsafeTimeoutMs = this.props.adFailsafeTimeoutMs;
+        if (this.props.minSegmentsBeforePlay !== void 0)
+          config.minSegmentsBeforePlay = this.props.minSegmentsBeforePlay;
         this.player = new StormcloudVideoPlayer(config);
         (_b = (_a = this.props).onMount) == null ? void 0 : _b.call(_a, this);
         await this.player.load();
@@ -5420,6 +5750,7 @@ var SUPPORTED_PROPS = [
   "showCustomControls",
   "licenseKey",
   "adFailsafeTimeoutMs",
+  "minSegmentsBeforePlay",
   "onReady",
   "onStart",
   "onPlay",