stormcloud-video-player 0.2.36 → 0.3.0

package/lib/index.d.cts

@@ -116,6 +116,7 @@ declare class StormcloudVideoPlayer {
     private ptsDriftEmaMs;
     private adPodQueue;
     private apiVastTagUrl;
+    private apiNumberAds;
     private lastHeartbeatTime;
     private heartbeatInterval;
     private currentAdIndex;
@@ -137,6 +138,9 @@ declare class StormcloudVideoPlayer {
     private adRequestWatchdogId;
     private adRequestWatchdogToken;
     private adFailsafeToken;
+    private fetchedAdDurations;
+    private targetAdBreakDurationMs;
+    private isAdaptiveMode;
     constructor(config: StormcloudVideoPlayerConfig);
     private createAdPlayer;
     load(): Promise<void>;
@@ -157,6 +161,7 @@ declare class StormcloudVideoPlayer {
     private fetchAdConfiguration;
     getCurrentAdIndex(): number;
     getTotalAdsInBreak(): number;
+    private generateVastUrlsWithCorrelators;
     isAdPlaying(): boolean;
     isShowingAds(): boolean;
     getStreamType(): "hls" | "other";
@@ -184,6 +189,9 @@ declare class StormcloudVideoPlayer {
     private logAdState;
     private fetchAndParseVastXml;
     private extractMediaUrlsFromVast;
+    private fetchVastDuration;
+    private calculateAdditionalAdsNeeded;
+    private addAdaptiveAdsToQueue;
     private preloadMediaFile;
     private preloadAllAdsInBackground;
     private preloadSingleAd;

package/lib/index.d.ts

@@ -116,6 +116,7 @@ declare class StormcloudVideoPlayer {
     private ptsDriftEmaMs;
     private adPodQueue;
     private apiVastTagUrl;
+    private apiNumberAds;
     private lastHeartbeatTime;
     private heartbeatInterval;
     private currentAdIndex;
@@ -137,6 +138,9 @@ declare class StormcloudVideoPlayer {
     private adRequestWatchdogId;
     private adRequestWatchdogToken;
     private adFailsafeToken;
+    private fetchedAdDurations;
+    private targetAdBreakDurationMs;
+    private isAdaptiveMode;
     constructor(config: StormcloudVideoPlayerConfig);
     private createAdPlayer;
     load(): Promise<void>;
@@ -157,6 +161,7 @@ declare class StormcloudVideoPlayer {
     private fetchAdConfiguration;
     getCurrentAdIndex(): number;
     getTotalAdsInBreak(): number;
+    private generateVastUrlsWithCorrelators;
     isAdPlaying(): boolean;
     isShowingAds(): boolean;
     getStreamType(): "hls" | "other";
@@ -184,6 +189,9 @@ declare class StormcloudVideoPlayer {
     private logAdState;
     private fetchAndParseVastXml;
     private extractMediaUrlsFromVast;
+    private fetchVastDuration;
+    private calculateAdditionalAdsNeeded;
+    private addAdaptiveAdsToQueue;
     private preloadMediaFile;
     private preloadAllAdsInBackground;
     private preloadSingleAd;

package/lib/index.js

@@ -2157,6 +2157,9 @@ var StormcloudVideoPlayer = class {
     this.activeAdRequestToken = null;
     this.adRequestWatchdogToken = null;
     this.adFailsafeToken = null;
+    this.fetchedAdDurations = /* @__PURE__ */ new Map();
+    this.targetAdBreakDurationMs = null;
+    this.isAdaptiveMode = false;
     initializePolyfills();
     const browserOverrides = getBrowserConfigOverrides();
     this.config = { ...config, ...browserOverrides };
@@ -2963,7 +2966,7 @@ var StormcloudVideoPlayer = class {
     }
   }
   async fetchAdConfiguration() {
-    var _a, _b, _c;
+    var _a, _b, _c, _d, _e, _f, _g;
     const vastMode = this.config.vastMode || "default";
     if (this.config.debugAdTiming) {
       console.log("[StormcloudVideoPlayer] VAST mode:", vastMode);
@@ -3034,6 +3037,16 @@ var StormcloudVideoPlayer = class {
         );
       }
     }
+    const numberAds = (_g = (_f = (_e = (_d = data.response) == null ? void 0 : _d.options) == null ? void 0 : _e.vast) == null ? void 0 : _f.cue_tones) == null ? void 0 : _g.number_ads;
+    if (numberAds != null && numberAds > 0) {
+      this.apiNumberAds = numberAds;
+      if (this.config.debugAdTiming) {
+        console.log(
+          "[StormcloudVideoPlayer] Number of ads per break from API:",
+          this.apiNumberAds
+        );
+      }
+    }
   }
   getCurrentAdIndex() {
     return this.currentAdIndex;
@@ -3041,6 +3054,27 @@ var StormcloudVideoPlayer = class {
   getTotalAdsInBreak() {
     return this.totalAdsInBreak;
   }
+  generateVastUrlsWithCorrelators(baseUrl, count) {
+    const urls = [];
+    for (let i = 0; i < count; i++) {
+      try {
+        const url = new URL(baseUrl);
+        const timestamp = Date.now();
+        const random = Math.floor(Math.random() * 1e6);
+        const uniqueCorrelator = `${timestamp}${random}${i}`;
+        url.searchParams.set("correlator", uniqueCorrelator);
+        urls.push(url.toString());
+      } catch (error) {
+        console.warn(
+          "[StormcloudVideoPlayer] Failed to parse VAST URL:",
+          baseUrl,
+          error
+        );
+        urls.push(`${baseUrl}${baseUrl.includes("?") ? "&" : "?"}correlator=${Date.now()}${i}`);
+      }
+    }
+    return urls;
+  }
   isAdPlaying() {
     return this.inAdBreak && this.ima.isAdPlaying();
   }
@@ -3079,7 +3113,52 @@ var StormcloudVideoPlayer = class {
     const tags = this.selectVastTagsForBreak(scheduled);
     let vastTagUrls = [];
     if (this.apiVastTagUrl) {
-      vastTagUrls = [this.apiVastTagUrl];
+      let numberOfAds = 1;
+      if (this.isLiveStream) {
+        const adBreakDurationMs = _marker.durationSeconds != null ? _marker.durationSeconds * 1e3 : scheduled == null ? void 0 : scheduled.durationMs;
+        if (adBreakDurationMs != null && adBreakDurationMs > 0) {
+          this.isAdaptiveMode = true;
+          this.targetAdBreakDurationMs = adBreakDurationMs;
+          this.fetchedAdDurations.clear();
+          numberOfAds = 2;
+          if (this.config.debugAdTiming) {
+            console.log(
+              `[ADAPTIVE-POD] \u{1F4FA} LIVE MODE (ADAPTIVE): Target duration=${adBreakDurationMs}ms | Starting with ${numberOfAds} ads, will fetch actual durations and add more dynamically`
+            );
+          }
+        } else {
+          if (this.config.debugAdTiming) {
+            console.warn(
+              "[DEBUG-POD] \u26A0\uFE0F LIVE MODE: No duration available, defaulting to 1 ad"
+            );
+          }
+        }
+      } else {
+        this.isAdaptiveMode = false;
+        this.targetAdBreakDurationMs = null;
+        this.fetchedAdDurations.clear();
+        if (this.apiNumberAds && this.apiNumberAds > 1) {
+          numberOfAds = this.apiNumberAds;
+          if (this.config.debugAdTiming) {
+            console.log(
+              `[DEBUG-POD] \u{1F3AC} VOD MODE (FIXED): Using number_ads=${numberOfAds} from API`
+            );
+          }
+        }
+      }
+      if (numberOfAds > 1) {
+        vastTagUrls = this.generateVastUrlsWithCorrelators(
+          this.apiVastTagUrl,
+          numberOfAds
+        );
+        if (this.config.debugAdTiming) {
+          console.log(
+            `[DEBUG-POD] \u{1F504} Generated ${vastTagUrls.length} initial VAST URLs with unique correlators`
+          );
+        }
+      } else {
+        vastTagUrls = [this.apiVastTagUrl];
+      }
     } else if (tags && tags.length > 0) {
       vastTagUrls = tags;
     } else {
@@ -3498,6 +3577,99 @@ var StormcloudVideoPlayer = class {
     }
     return mediaUrls;
   }
+  async fetchVastDuration(vastTagUrl) {
+    var _a;
+    try {
+      const response = await fetch(vastTagUrl, { mode: "cors" });
+      if (!response.ok) {
+        if (this.config.debugAdTiming) {
+          console.warn(
+            `[ADAPTIVE-POD] Failed to fetch VAST: ${response.status}`
+          );
+        }
+        return null;
+      }
+      const xmlText = await response.text();
+      const parser = new DOMParser();
+      const xmlDoc = parser.parseFromString(xmlText, "text/xml");
+      const durationText = (_a = xmlDoc.querySelector("Duration")) == null ? void 0 : _a.textContent;
+      if (!durationText) {
+        if (this.config.debugAdTiming) {
+          console.warn("[ADAPTIVE-POD] No Duration element found in VAST");
+        }
+        return null;
+      }
+      const durationParts = durationText.split(":");
+      const durationSeconds = parseInt(durationParts[0] || "0", 10) * 3600 + parseInt(durationParts[1] || "0", 10) * 60 + parseInt(durationParts[2] || "0", 10);
+      return durationSeconds;
+    } catch (error) {
+      if (this.config.debugAdTiming) {
+        console.warn(
+          `[ADAPTIVE-POD] Error fetching VAST duration from ${vastTagUrl}:`,
+          error
+        );
+      }
+      return null;
+    }
+  }
+  calculateAdditionalAdsNeeded() {
+    if (!this.isAdaptiveMode || this.targetAdBreakDurationMs === null) {
+      return 0;
+    }
+    let totalFetchedDurationMs = 0;
+    for (const duration of this.fetchedAdDurations.values()) {
+      totalFetchedDurationMs += duration * 1e3;
+    }
+    const remainingTimeMs = this.targetAdBreakDurationMs - totalFetchedDurationMs;
+    if (remainingTimeMs <= 0) {
+      if (this.config.debugAdTiming) {
+        console.log(
+          `[ADAPTIVE-POD] \u2705 Target duration reached: ${totalFetchedDurationMs}ms / ${this.targetAdBreakDurationMs}ms`
+        );
+      }
+      return 0;
+    }
+    const fetchedCount = this.fetchedAdDurations.size;
+    const averageDurationMs = fetchedCount > 0 ? totalFetchedDurationMs / fetchedCount : 30 * 1e3;
+    const additionalAds = Math.ceil(remainingTimeMs / averageDurationMs);
+    if (this.config.debugAdTiming) {
+      console.log(
+        `[ADAPTIVE-POD] \u{1F4CA} Need ${additionalAds} more ads | Fetched: ${totalFetchedDurationMs}ms / Target: ${this.targetAdBreakDurationMs}ms | Remaining: ${remainingTimeMs}ms | Avg duration: ${averageDurationMs}ms`
+      );
+    }
+    return additionalAds;
+  }
+  async addAdaptiveAdsToQueue() {
+    if (!this.isAdaptiveMode || !this.apiVastTagUrl) {
+      return;
+    }
+    const additionalAds = this.calculateAdditionalAdsNeeded();
+    if (additionalAds <= 0) {
+      return;
+    }
+    const newUrls = this.generateVastUrlsWithCorrelators(
+      this.apiVastTagUrl,
+      additionalAds
+    );
+    if (this.config.debugAdTiming) {
+      console.log(
+        `[ADAPTIVE-POD] \u{1F504} Adding ${newUrls.length} additional VAST URLs to queue`
+      );
+    }
+    this.adPodAllUrls.push(...newUrls);
+    this.adPodQueue.push(...newUrls);
+    this.totalAdsInBreak += newUrls.length;
+    for (const url of newUrls) {
+      this.preloadSingleAd(url).catch((error) => {
+        if (this.config.debugAdTiming) {
+          console.warn(
+            `[ADAPTIVE-POD] Failed to preload adaptive ad:`,
+            error
+          );
+        }
+      });
+    }
+  }
   async preloadMediaFile(mediaUrl) {
     if (this.preloadedMediaUrls.has(mediaUrl)) {
       return;
@@ -3567,6 +3739,18 @@ var StormcloudVideoPlayer = class {
   async preloadSingleAd(vastTagUrl) {
     if (!vastTagUrl) return;
     try {
+      if (this.isAdaptiveMode && !this.fetchedAdDurations.has(vastTagUrl)) {
+        const duration = await this.fetchVastDuration(vastTagUrl);
+        if (duration !== null) {
+          this.fetchedAdDurations.set(vastTagUrl, duration);
+          if (this.config.debugAdTiming) {
+            console.log(
+              `[ADAPTIVE-POD] \u2713 Fetched ad duration: ${duration}s (${this.fetchedAdDurations.size} ads fetched so far)`
+            );
+          }
+          await this.addAdaptiveAdsToQueue();
+        }
+      }
       if (this.ima.preloadAds && !this.ima.hasPreloadedAd(vastTagUrl)) {
         if (!this.preloadingAdUrls.has(vastTagUrl)) {
           if (this.config.debugAdTiming) {