stormcloud-video-player 0.2.24 → 0.2.26

package/lib/player/StormcloudVideoPlayer.d.cts

@@ -1,4 +1,4 @@
-import { S as StormcloudVideoPlayerConfig } from '../types-D1xfSdLP.cjs';
+import { S as StormcloudVideoPlayerConfig } from '../types-t9jEJXZy.cjs';
 
 declare class StormcloudVideoPlayer {
     private readonly video;
@@ -26,6 +26,8 @@ declare class StormcloudVideoPlayer {
     private bufferedSegmentsCount;
     private shouldAutoplayAfterBuffering;
     private hasInitialBufferCompleted;
+    private adPodAllUrls;
+    private preloadingAdUrls;
     constructor(config: StormcloudVideoPlayerConfig);
     private createAdPlayer;
     load(): Promise<void>;
@@ -68,6 +70,10 @@ declare class StormcloudVideoPlayer {
     private startAdFailsafeTimer;
     private clearAdFailsafeTimer;
     private selectVastTagsForBreak;
+    private logQueuedAdUrls;
+    private enforceAdHoldState;
+    private releaseAdHoldState;
+    private preloadUpcomingAds;
     private getRemainingAdMs;
     private findBreakForTime;
     toggleMute(): void;

package/lib/players/HlsPlayer.cjs

@@ -202,7 +202,10 @@ function getBrowserConfigOverrides() {
 function createImaController(video, options) {
   let adPlaying = false;
   let originalMutedState = false;
+  let originalVolume = typeof video.volume === "number" && !Number.isNaN(video.volume) ? Math.max(0, Math.min(1, video.volume)) : 1;
   const listeners = /* @__PURE__ */ new Map();
+  const preloadedVast = /* @__PURE__ */ new Map();
+  const preloadingVast = /* @__PURE__ */ new Map();
   function setAdPlayingFlag(isPlaying) {
     if (isPlaying) {
       video.dataset.stormcloudAdPlaying = "true";
@@ -293,16 +296,70 @@ function createImaController(video, options) {
   let adsLoadedReject;
   function makeAdsRequest(google, vastTagUrl) {
     const adsRequest = new google.ima.AdsRequest();
-    adsRequest.adTagUrl = vastTagUrl;
+    const preloadedResponse = preloadedVast.get(vastTagUrl);
+    if (preloadedResponse) {
+      adsRequest.adsResponse = preloadedResponse;
+      console.log(
+        "[IMA] Using preloaded VAST response for immediate ad request"
+      );
+    } else {
+      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;
+    if (typeof adsRequest.setAdWillAutoPlay === "function") {
+      try {
+        const willAutoPlay = !video.paused || video.autoplay;
+        adsRequest.setAdWillAutoPlay(willAutoPlay);
+      } catch (error) {
+        console.warn("[IMA] Failed to call setAdWillAutoPlay:", error);
+      }
+    }
+    if (typeof adsRequest.setAdWillPlayMuted === "function") {
+      try {
+        const willPlayMuted = video.muted || video.volume === 0;
+        adsRequest.setAdWillPlayMuted(willPlayMuted);
+      } catch (error) {
+        console.warn("[IMA] Failed to call setAdWillPlayMuted:", error);
+      }
+    }
     adsRequest.vastLoadTimeout = 5e3;
     console.log(`[IMA] Ads request dimensions: ${videoWidth}x${videoHeight}`);
     adsLoader.requestAds(adsRequest);
+    if (preloadedResponse) {
+      preloadedVast.delete(vastTagUrl);
+    }
+  }
+  function ensurePlaceholderContainer() {
+    var _a;
+    if (adContainerEl) {
+      return;
+    }
+    const container = document.createElement("div");
+    container.style.position = "absolute";
+    container.style.left = "0";
+    container.style.top = "0";
+    container.style.right = "0";
+    container.style.bottom = "0";
+    container.style.display = "none";
+    container.style.alignItems = "center";
+    container.style.justifyContent = "center";
+    container.style.pointerEvents = "none";
+    container.style.zIndex = "10";
+    container.style.backgroundColor = "#000";
+    (_a = video.parentElement) == null ? void 0 : _a.appendChild(container);
+    adContainerEl = container;
+  }
+  async function fetchVastDocument(vastTagUrl) {
+    const response = await fetch(vastTagUrl, { mode: "cors" });
+    if (!response.ok) {
+      throw new Error(`Failed to preload VAST: ${response.status}`);
+    }
+    return response.text();
   }
   function destroyAdsManager() {
     if (adsManager) {
@@ -318,29 +375,16 @@ function createImaController(video, options) {
   return {
     initialize() {
       ensureImaLoaded().then(() => {
-        var _a, _b;
+        var _a;
         const google = window.google;
-        if (!adDisplayContainer) {
-          const container = document.createElement("div");
-          container.style.position = "absolute";
-          container.style.left = "0";
-          container.style.top = "0";
-          container.style.right = "0";
-          container.style.bottom = "0";
-          container.style.display = "none";
-          container.style.alignItems = "center";
-          container.style.justifyContent = "center";
-          container.style.pointerEvents = "none";
-          container.style.zIndex = "10";
-          container.style.backgroundColor = "#000";
-          (_a = video.parentElement) == null ? void 0 : _a.appendChild(container);
-          adContainerEl = container;
+        ensurePlaceholderContainer();
+        if (!adDisplayContainer && adContainerEl) {
           adDisplayContainer = new google.ima.AdDisplayContainer(
-            container,
+            adContainerEl,
             video
           );
           try {
-            (_b = adDisplayContainer.initialize) == null ? void 0 : _b.call(adDisplayContainer);
+            (_a = adDisplayContainer.initialize) == null ? void 0 : _a.call(adDisplayContainer);
           } catch {
           }
         }
@@ -644,6 +688,32 @@ function createImaController(video, options) {
         return Promise.reject(error);
       }
     },
+    async preloadAds(vastTagUrl) {
+      if (!vastTagUrl || vastTagUrl.trim() === "") {
+        return Promise.resolve();
+      }
+      if (preloadedVast.has(vastTagUrl)) {
+        return Promise.resolve();
+      }
+      const inflight = preloadingVast.get(vastTagUrl);
+      if (inflight) {
+        return inflight;
+      }
+      const preloadPromise = fetchVastDocument(vastTagUrl).then((xml) => {
+        preloadedVast.set(vastTagUrl, xml);
+        console.log("[IMA] Cached VAST response for preloading:", vastTagUrl);
+      }).catch((error) => {
+        console.warn("[IMA] Failed to preload VAST response:", error);
+        preloadedVast.delete(vastTagUrl);
+      }).finally(() => {
+        preloadingVast.delete(vastTagUrl);
+      });
+      preloadingVast.set(vastTagUrl, preloadPromise);
+      return preloadPromise;
+    },
+    hasPreloadedAd(vastTagUrl) {
+      return preloadedVast.has(vastTagUrl);
+    },
     async play() {
       var _a, _b;
       if (!((_a = window.google) == null ? void 0 : _a.ima) || !adDisplayContainer) {
@@ -662,7 +732,7 @@ 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;
+        const adVolume = originalMutedState ? 0 : originalVolume;
         try {
           adsManager.setVolume(adVolume);
           console.log(`[IMA] Set ad volume to ${adVolume}`);
@@ -704,6 +774,7 @@ function createImaController(video, options) {
       destroyAdsManager();
       adPlaying = false;
       video.muted = originalMutedState;
+      video.volume = originalVolume;
       setAdPlayingFlag(false);
       if (adContainerEl) {
         adContainerEl.style.pointerEvents = "none";
@@ -719,6 +790,8 @@ function createImaController(video, options) {
       adContainerEl = void 0;
       adDisplayContainer = void 0;
       adsLoader = void 0;
+      preloadedVast.clear();
+      preloadingVast.clear();
     },
     isAdPlaying() {
       return adPlaying;
@@ -746,15 +819,20 @@ function createImaController(video, options) {
       var _a;
       (_a = listeners.get(event)) == null ? void 0 : _a.delete(listener);
     },
-    updateOriginalMutedState(muted) {
+    updateOriginalMutedState(muted, volume) {
+      const nextVolume = typeof volume === "number" && !Number.isNaN(volume) ? Math.max(0, Math.min(1, volume)) : originalVolume;
       console.log(
-        `[IMA] updateOriginalMutedState called: ${originalMutedState} -> ${muted}`
+        `[IMA] updateOriginalMutedState called: { muted: ${originalMutedState} -> ${muted}, volume: ${originalVolume} -> ${nextVolume} }`
       );
       originalMutedState = muted;
+      originalVolume = nextVolume;
     },
     getOriginalMutedState() {
       return originalMutedState;
     },
+    getOriginalVolume() {
+      return originalVolume;
+    },
     setAdVolume(volume) {
       if (adsManager && adPlaying) {
         try {
@@ -774,6 +852,19 @@ function createImaController(video, options) {
         }
       }
       return 1;
+    },
+    showPlaceholder() {
+      ensurePlaceholderContainer();
+      if (adContainerEl) {
+        adContainerEl.style.display = "flex";
+        adContainerEl.style.pointerEvents = "auto";
+      }
+    },
+    hidePlaceholder() {
+      if (adContainerEl) {
+        adContainerEl.style.display = "none";
+        adContainerEl.style.pointerEvents = "none";
+      }
     }
   };
 }
@@ -783,6 +874,7 @@ var import_hls = __toESM(require("hls.js"), 1);
 function createHlsAdPlayer(contentVideo, options) {
   let adPlaying = false;
   let originalMutedState = false;
+  let originalVolume = Math.max(0, Math.min(1, contentVideo.volume || 1));
   const listeners = /* @__PURE__ */ new Map();
   const licenseKey = options == null ? void 0 : options.licenseKey;
   const mainHlsInstance = options == null ? void 0 : options.mainHlsInstance;
@@ -791,6 +883,8 @@ function createHlsAdPlayer(contentVideo, options) {
   let adContainerEl;
   let currentAd;
   let sessionId;
+  const preloadedAds = /* @__PURE__ */ new Map();
+  const preloadingAds = /* @__PURE__ */ new Map();
   let trackingFired = {
     impression: false,
     start: false,
@@ -1020,6 +1114,19 @@ function createHlsAdPlayer(contentVideo, options) {
       return null;
     }
   }
+  async function fetchAndParseVastAd(vastTagUrl) {
+    const response = await fetch(vastTagUrl);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch VAST: ${response.statusText}`);
+    }
+    const vastXml = await response.text();
+    console.log("[HlsAdPlayer] VAST XML received");
+    console.log(
+      "[HlsAdPlayer] VAST XML content (first 2000 chars):",
+      vastXml.substring(0, 2e3)
+    );
+    return parseVastXml(vastXml);
+  }
   function createAdVideoElement() {
     const video = document.createElement("video");
     video.style.position = "absolute";
@@ -1125,6 +1232,7 @@ function createHlsAdPlayer(contentVideo, options) {
     setAdPlayingFlag(false);
     const previousMutedState = contentVideo.muted;
     contentVideo.muted = originalMutedState;
+    contentVideo.volume = originalMutedState ? 0 : originalVolume;
     console.log(
       `[HlsAdPlayer] Restored mute state: ${previousMutedState} -> ${originalMutedState}`
     );
@@ -1171,17 +1279,17 @@ function createHlsAdPlayer(contentVideo, options) {
       }
       try {
         sessionId = generateSessionId();
-        const response = await fetch(vastTagUrl);
-        if (!response.ok) {
-          throw new Error(`Failed to fetch VAST: ${response.statusText}`);
+        let ad;
+        if (preloadedAds.has(vastTagUrl)) {
+          ad = preloadedAds.get(vastTagUrl);
+          preloadedAds.delete(vastTagUrl);
+          console.log(
+            "[HlsAdPlayer] Using preloaded VAST response:",
+            vastTagUrl
+          );
+        } else {
+          ad = await fetchAndParseVastAd(vastTagUrl);
         }
-        const vastXml = await response.text();
-        console.log("[HlsAdPlayer] VAST XML received");
-        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");
@@ -1200,6 +1308,37 @@ function createHlsAdPlayer(contentVideo, options) {
         return Promise.reject(error);
       }
     },
+    async preloadAds(vastTagUrl) {
+      if (!vastTagUrl || vastTagUrl.trim() === "") {
+        return Promise.resolve();
+      }
+      if (preloadedAds.has(vastTagUrl)) {
+        return Promise.resolve();
+      }
+      const inflight = preloadingAds.get(vastTagUrl);
+      if (inflight) {
+        return inflight;
+      }
+      const preloadPromise = fetchAndParseVastAd(vastTagUrl).then((ad) => {
+        if (ad) {
+          preloadedAds.set(vastTagUrl, ad);
+          console.log(
+            "[HlsAdPlayer] Cached VAST response for preloading:",
+            vastTagUrl
+          );
+        }
+      }).catch((error) => {
+        console.warn("[HlsAdPlayer] Failed to preload VAST response:", error);
+        preloadedAds.delete(vastTagUrl);
+      }).finally(() => {
+        preloadingAds.delete(vastTagUrl);
+      });
+      preloadingAds.set(vastTagUrl, preloadPromise);
+      return preloadPromise;
+    },
+    hasPreloadedAd(vastTagUrl) {
+      return preloadedAds.has(vastTagUrl);
+    },
     async play() {
       if (!currentAd) {
         console.warn(
@@ -1223,6 +1362,10 @@ function createHlsAdPlayer(contentVideo, options) {
           complete: false
         };
         const contentVolume = contentVideo.volume;
+        originalVolume = Math.max(
+          0,
+          Math.min(1, contentVolume || originalVolume)
+        );
         if (!(options == null ? void 0 : options.continueLiveStreamDuringAds)) {
           contentVideo.pause();
           console.log("[HlsAdPlayer] Content paused (VOD mode)");
@@ -1235,7 +1378,7 @@ function createHlsAdPlayer(contentVideo, options) {
         adPlaying = true;
         setAdPlayingFlag(true);
         if (adVideoElement) {
-          const adVolume = originalMutedState ? 0 : contentVolume;
+          const adVolume = originalMutedState ? 0 : originalVolume;
           adVideoElement.volume = Math.max(0, Math.min(1, adVolume));
           adVideoElement.muted = false;
           console.log(
@@ -1314,6 +1457,7 @@ function createHlsAdPlayer(contentVideo, options) {
       adPlaying = false;
       setAdPlayingFlag(false);
       contentVideo.muted = originalMutedState;
+      contentVideo.volume = originalMutedState ? 0 : originalVolume;
       if (adHls) {
         adHls.destroy();
         adHls = void 0;
@@ -1330,6 +1474,8 @@ function createHlsAdPlayer(contentVideo, options) {
       adContainerEl = void 0;
       currentAd = void 0;
       listeners.clear();
+      preloadedAds.clear();
+      preloadingAds.clear();
     },
     isAdPlaying() {
       return adPlaying;
@@ -1353,15 +1499,20 @@ function createHlsAdPlayer(contentVideo, options) {
       var _a;
       (_a = listeners.get(event)) == null ? void 0 : _a.delete(listener);
     },
-    updateOriginalMutedState(muted) {
+    updateOriginalMutedState(muted, volume) {
+      const nextVolume = typeof volume === "number" && !Number.isNaN(volume) ? Math.max(0, Math.min(1, volume)) : originalVolume;
       console.log(
-        `[HlsAdPlayer] updateOriginalMutedState called: ${originalMutedState} -> ${muted}`
+        `[HlsAdPlayer] updateOriginalMutedState called: { muted: ${originalMutedState} -> ${muted}, volume: ${originalVolume} -> ${nextVolume} }`
       );
       originalMutedState = muted;
+      originalVolume = nextVolume;
     },
     getOriginalMutedState() {
       return originalMutedState;
     },
+    getOriginalVolume() {
+      return originalVolume;
+    },
     setAdVolume(volume) {
       if (adVideoElement && adPlaying) {
         adVideoElement.volume = Math.max(0, Math.min(1, volume));
@@ -1372,6 +1523,35 @@ function createHlsAdPlayer(contentVideo, options) {
         return adVideoElement.volume;
       }
       return 1;
+    },
+    showPlaceholder() {
+      var _a;
+      if (!adContainerEl) {
+        const container = document.createElement("div");
+        container.style.position = "absolute";
+        container.style.left = "0";
+        container.style.top = "0";
+        container.style.right = "0";
+        container.style.bottom = "0";
+        container.style.display = "none";
+        container.style.alignItems = "center";
+        container.style.justifyContent = "center";
+        container.style.pointerEvents = "none";
+        container.style.zIndex = "10";
+        container.style.backgroundColor = "#000";
+        (_a = contentVideo.parentElement) == null ? void 0 : _a.appendChild(container);
+        adContainerEl = container;
+      }
+      if (adContainerEl) {
+        adContainerEl.style.display = "flex";
+        adContainerEl.style.pointerEvents = "auto";
+      }
+    },
+    hidePlaceholder() {
+      if (adContainerEl) {
+        adContainerEl.style.display = "none";
+        adContainerEl.style.pointerEvents = "none";
+      }
     }
   };
 }
@@ -1852,6 +2032,8 @@ var StormcloudVideoPlayer = class {
     this.bufferedSegmentsCount = 0;
     this.shouldAutoplayAfterBuffering = false;
     this.hasInitialBufferCompleted = false;
+    this.adPodAllUrls = [];
+    this.preloadingAdUrls = /* @__PURE__ */ new Set();
     initializePolyfills();
     const browserOverrides = getBrowserConfigOverrides();
     this.config = { ...config, ...browserOverrides };
@@ -2111,7 +2293,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.updateOriginalMutedState(this.video.muted, this.video.volume);
     this.ima.on("all_ads_completed", () => {
       if (this.config.debugAdTiming) {
         console.log(
@@ -2152,6 +2334,7 @@ var StormcloudVideoPlayer = class {
         console.log("[StormcloudVideoPlayer] IMA content_pause event received");
       }
       this.clearAdFailsafeTimer();
+      this.enforceAdHoldState();
     });
     this.ima.on("content_resume", () => {
       if (this.config.debugAdTiming) {
@@ -2176,9 +2359,7 @@ var StormcloudVideoPlayer = class {
       if (remaining > 500 && this.adPodQueue.length > 0) {
         const next = this.adPodQueue.shift();
         this.currentAdIndex++;
-        this.video.dataset.stormcloudAdPlaying = "true";
-        this.video.muted = true;
-        this.video.volume = 0;
+        this.enforceAdHoldState();
         if (this.config.debugAdTiming) {
           console.log(
             `[StormcloudVideoPlayer] Playing next ad in pod (${this.currentAdIndex}/${this.totalAdsInBreak}) - IMMEDIATELY starting next ad`
@@ -2790,11 +2971,16 @@ var StormcloudVideoPlayer = class {
       return;
     }
     if (vastTagUrls.length > 0) {
+      this.adPodAllUrls = [...vastTagUrls];
+      this.preloadingAdUrls.clear();
+      this.logQueuedAdUrls(this.adPodAllUrls);
       this.inAdBreak = true;
       this.showAds = true;
       this.currentAdIndex = 0;
       this.totalAdsInBreak = vastTagUrls.length;
       this.adPodQueue = [...vastTagUrls];
+      this.enforceAdHoldState();
+      this.preloadUpcomingAds();
       if (this.config.debugAdTiming) {
         console.log(
           `[StormcloudVideoPlayer] Starting ad pod with ${vastTagUrls.length} ads - will play continuously`
@@ -2865,6 +3051,7 @@ var StormcloudVideoPlayer = class {
         const first = tags[0];
         const rest = tags.slice(1);
         this.adPodQueue = rest;
+        this.enforceAdHoldState();
         await this.playSingleAd(first);
         this.inAdBreak = true;
         this.expectedAdBreakDurationMs = remainingMs;
@@ -2978,6 +3165,12 @@ var StormcloudVideoPlayer = class {
       }
       return;
     }
+    const wasPreloaded = this.ima.hasPreloadedAd(vastTagUrl);
+    if (wasPreloaded && this.config.debugAdTiming) {
+      console.log(
+        `[StormcloudVideoPlayer] IMA SDK preloaded this ad already: ${vastTagUrl}`
+      );
+    }
     if (!this.showAds) {
       if (this.config.debugAdTiming) {
         console.log(
@@ -2989,7 +3182,7 @@ var StormcloudVideoPlayer = class {
           }
         );
       }
-      this.ima.updateOriginalMutedState(this.video.muted);
+      this.ima.updateOriginalMutedState(this.video.muted, this.video.volume);
     } else if (this.config.debugAdTiming) {
       console.log(
         `[StormcloudVideoPlayer] Keeping existing original mute state (currently showing ads)`
@@ -2998,12 +3191,14 @@ var StormcloudVideoPlayer = class {
     this.startAdFailsafeTimer();
     try {
       await this.ima.requestAds(vastTagUrl);
+      this.preloadUpcomingAds();
       try {
         if (this.config.debugAdTiming) {
           console.log(
             "[StormcloudVideoPlayer] Ad request completed, attempting playback"
           );
         }
+        this.enforceAdHoldState();
         await this.ima.play();
         if (this.config.debugAdTiming) {
           console.log(
@@ -3033,6 +3228,8 @@ var StormcloudVideoPlayer = class {
         "[StormcloudVideoPlayer] Handling ad pod completion - resuming content and hiding ad layer"
       );
     }
+    this.releaseAdHoldState();
+    this.preloadingAdUrls.clear();
     this.inAdBreak = false;
     this.expectedAdBreakDurationMs = void 0;
     this.currentAdBreakStartWallClockMs = void 0;
@@ -3040,14 +3237,16 @@ var StormcloudVideoPlayer = class {
     this.clearAdStopTimer();
     this.clearAdFailsafeTimer();
     this.adPodQueue = [];
+    this.adPodAllUrls = [];
     this.showAds = false;
     this.currentAdIndex = 0;
     this.totalAdsInBreak = 0;
     this.ima.stop().catch(() => {
     });
     const originalMutedState = this.ima.getOriginalMutedState();
+    const originalVolume = typeof this.ima.getOriginalVolume === "function" ? this.ima.getOriginalVolume() : this.video.volume;
     this.video.muted = originalMutedState;
-    this.video.volume = originalMutedState ? 0 : 1;
+    this.video.volume = originalVolume;
     if (this.config.debugAdTiming) {
       console.log(
         `[StormcloudVideoPlayer] Restored main video - muted: ${originalMutedState}, volume: ${this.video.volume}`
@@ -3120,6 +3319,64 @@ var StormcloudVideoPlayer = class {
     }
     return [b.vastTagUrl];
   }
+  logQueuedAdUrls(urls) {
+    if (!this.config.debugAdTiming) {
+      return;
+    }
+    console.log("[StormcloudVideoPlayer] ALL ad URLs queued:", urls);
+  }
+  enforceAdHoldState() {
+    this.video.dataset.stormcloudAdPlaying = "true";
+    this.video.muted = true;
+    this.video.volume = 0;
+    if (typeof this.ima.showPlaceholder === "function") {
+      this.ima.showPlaceholder();
+    }
+  }
+  releaseAdHoldState() {
+    delete this.video.dataset.stormcloudAdPlaying;
+    if (typeof this.ima.hidePlaceholder === "function") {
+      this.ima.hidePlaceholder();
+    }
+  }
+  preloadUpcomingAds() {
+    if (!this.ima.preloadAds || this.adPodQueue.length === 0) {
+      return;
+    }
+    const upcoming = this.adPodQueue.slice(0, 2);
+    for (const url of upcoming) {
+      if (!url) continue;
+      if (this.ima.hasPreloadedAd(url)) {
+        this.preloadingAdUrls.delete(url);
+        continue;
+      }
+      if (this.preloadingAdUrls.has(url)) {
+        continue;
+      }
+      if (this.config.debugAdTiming) {
+        console.log(
+          `[StormcloudVideoPlayer] Scheduling IMA preload for upcoming ad: ${url}`
+        );
+      }
+      this.preloadingAdUrls.add(url);
+      this.ima.preloadAds(url).then(() => {
+        if (this.config.debugAdTiming) {
+          console.log(
+            `[StormcloudVideoPlayer] IMA preload complete for ad: ${url}`
+          );
+        }
+      }).catch((error) => {
+        if (this.config.debugAdTiming) {
+          console.warn(
+            `[StormcloudVideoPlayer] IMA preload failed for ad: ${url}`,
+            error
+          );
+        }
+      }).finally(() => {
+        this.preloadingAdUrls.delete(url);
+      });
+    }
+  }
   getRemainingAdMs() {
     if (this.expectedAdBreakDurationMs == null || this.currentAdBreakStartWallClockMs == null)
       return 0;
@@ -3140,7 +3397,7 @@ var StormcloudVideoPlayer = class {
     if (this.ima.isAdPlaying()) {
       const currentPerceptualState = this.isMuted();
       const newMutedState = !currentPerceptualState;
-      this.ima.updateOriginalMutedState(newMutedState);
+      this.ima.updateOriginalMutedState(newMutedState, this.video.volume);
       this.ima.setAdVolume(newMutedState ? 0 : 1);
       if (this.config.debugAdTiming) {
         console.log(
@@ -3150,7 +3407,7 @@ var StormcloudVideoPlayer = class {
       }
     } else {
       this.video.muted = !this.video.muted;
-      this.ima.updateOriginalMutedState(this.video.muted);
+      this.ima.updateOriginalMutedState(this.video.muted, this.video.volume);
       if (this.config.debugAdTiming) {
         console.log("[StormcloudVideoPlayer] Muted:", this.video.muted);
       }
@@ -3222,7 +3479,7 @@ var StormcloudVideoPlayer = class {
     }
     this.video.muted = muted;
     if (adPlaying) {
-      this.ima.updateOriginalMutedState(muted);
+      this.ima.updateOriginalMutedState(muted, this.video.volume);
       this.ima.setAdVolume(muted ? 0 : 1);
       if (this.config.debugAdTiming) {
         console.log("[StormcloudVideoPlayer] setMuted applied during ad", {
@@ -3231,7 +3488,7 @@ var StormcloudVideoPlayer = class {
       }
       return;
     }
-    this.ima.updateOriginalMutedState(muted);
+    this.ima.updateOriginalMutedState(muted, this.video.volume);
     if (this.config.debugAdTiming) {
       console.log("[StormcloudVideoPlayer] setMuted called:", muted);
     }
@@ -3271,6 +3528,9 @@ var StormcloudVideoPlayer = class {
     }
     (_a = this.hls) == null ? void 0 : _a.destroy();
     (_b = this.ima) == null ? void 0 : _b.destroy();
+    this.releaseAdHoldState();
+    this.preloadingAdUrls.clear();
+    this.adPodAllUrls = [];
   }
 };