stormcloud-video-player 0.8.24 → 0.8.26

package/lib/player/AdBreakOrchestrator.cjs

@@ -722,6 +722,16 @@ function normalizeBoolean(value) {
 }
 // src/utils/tracking.ts
 var cachedBrowserId = null;
+function buildAnalyticsContext(config) {
+    var context = {};
+    if (config.debugAdTiming) {
+        context.debugAdTiming = true;
+    }
+    if (config.isLiveStream !== void 0) {
+        context.inputStreamType = config.isLiveStream ? "live" : "vod";
+    }
+    return context;
+}
 function getClientInfo() {
     var _screen, _screen1, _screen2, _screen3, _screen_orientation, _screen4, _screen5, _window, _window1, _window_screen_orientation, _window_screen, _navigator_languages;
     var ua = navigator.userAgent;
@@ -980,19 +990,26 @@ function canPublish(licenseKey) {
 }
 function buildPlayerMetricEvent() {
     return _async_to_generator(function() {
-        var context, flags, _flags_captureAt, _flags_adLoaded, _flags_adDetect, clientInfo, playerId, captureAt;
+        var context, flags, _flags_captureAt, _flags_adLoaded, _flags_adDetect, clientInfo, debugAdTiming, playerId, captureAt;
         var _arguments = arguments;
         return _ts_generator(this, function(_state) {
             switch(_state.label){
                 case 0:
                     context = _arguments.length > 0 && _arguments[0] !== void 0 ? _arguments[0] : {}, flags = _arguments.length > 1 && _arguments[1] !== void 0 ? _arguments[1] : {};
                     clientInfo = getClientInfo();
+                    debugAdTiming = !!context.debugAdTiming;
+                    if (debugAdTiming) {
+                        console.log("[StormcloudVideoPlayer] clientInfo: ", JSON.stringify(clientInfo, null, 2));
+                    }
                     return [
                         4,
                         getBrowserID(clientInfo)
                     ];
                 case 1:
                     playerId = _state.sent();
+                    if (debugAdTiming) {
+                        console.log("[StormcloudVideoPlayer] playerId: ", playerId);
+                    }
                     captureAt = (_flags_captureAt = flags.captureAt) !== null && _flags_captureAt !== void 0 ? _flags_captureAt : /* @__PURE__ */ new Date().toISOString();
                     return [
                         2,
@@ -1194,19 +1211,38 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
             }
         },
         {
-            // ───────────────────────────────────────────────────────────────
+            key: "analyticsContext",
+            get: function get() {
+                return buildAnalyticsContext(this.host.config);
+            }
+        },
+        {
+            key: "optimizedPodsEnabled",
+            get: // ───────────────────────────────────────────────────────────────
             //  IMA event listeners
             // ───────────────────────────────────────────────────────────────
+            function get() {
+                return !!this.host.config.optimizedPods;
+            }
+        },
+        {
             key: "attachImaEventListeners",
             value: function attachImaEventListeners() {
                 var _this = this;
                 var adPlayer = this.host.getAdPlayer();
+                adPlayer.on("pod_ad_started", function(payload) {
+                    _this.timing.notePodAdStarted();
+                    if (_this.debug) {
+                        var _ref;
+                        console.log("[POD] Playing pod ad ".concat((payload === null || payload === void 0 ? void 0 : payload.index) != null ? payload.index + 1 : "?", "/").concat((_ref = payload === null || payload === void 0 ? void 0 : payload.total) !== null && _ref !== void 0 ? _ref : "?"));
+                    }
+                });
                 adPlayer.on("all_ads_completed", function() {
                     sendAdImpressionTracking(_this.host.config.licenseKey, {
                         source: "hls",
                         adIndex: _this.timing.currentAdIndex,
                         timestamp: /* @__PURE__ */ new Date().toISOString()
-                    }).catch(function() {});
+                    }, _this.analyticsContext).catch(function() {});
                     _this.timing.recordPlayedAdDuration(_this.host.getAdPlayer());
                     var remaining = _this.timing.getRemainingAdMs();
                     _this.timing.consecutiveFailures = 0;
@@ -1268,7 +1304,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                         source: "hls",
                         adIndex: _this.timing.currentAdIndex,
                         timestamp: /* @__PURE__ */ new Date().toISOString()
-                    }).catch(function() {});
+                    }, _this.analyticsContext).catch(function() {});
                     if (!_this.host.video.muted) {
                         _this.host.video.muted = true;
                         if (_this.debug) {
@@ -1358,7 +1394,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
             // ───────────────────────────────────────────────────────────────
             function handleAdStart(_marker) {
                 return _async_to_generator(function() {
-                    var scheduled, tags, baseVastUrl, adBreakDurationMs, mode, currentMuted, currentVolume, firstAdUrl, usePreloadedAd, preloadedController, preloaded, firstAdUrlArray, adPlayer, preservedMuted, preservedVolume, adVolume, adPlayer1, adVolume1, error, fallbackPreloaded, ap, adVolume2, fallbackError;
+                    var scheduled, tags, baseVastUrl, adBreakDurationMs, mode, currentMuted, currentVolume, podPlayed, firstAdUrl, usePreloadedAd, preloadedController, preloaded, firstAdUrlArray, adPlayer, preservedMuted, preservedVolume, adVolume, adPlayer1, adVolume1, error, fallbackPreloaded, ap, adVolume2, fallbackError;
                     return _ts_generator(this, function(_state) {
                         switch(_state.label){
                             case 0:
@@ -1405,6 +1441,26 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                 if (this.timing.expectedAdBreakDurationMs == null && adBreakDurationMs != null) {
                                     this.timing.expectedAdBreakDurationMs = adBreakDurationMs;
                                 }
+                                if (!this.optimizedPodsEnabled) return [
+                                    3,
+                                    2
+                                ];
+                                return [
+                                    4,
+                                    this.startOptimizedPod(baseVastUrl, adBreakDurationMs, currentMuted, currentVolume)
+                                ];
+                            case 1:
+                                podPlayed = _state.sent();
+                                if (podPlayed) {
+                                    return [
+                                        2
+                                    ];
+                                }
+                                if (this.debug) {
+                                    console.log("[POD] Optimized pod unavailable, falling back to sequential single-ad path");
+                                }
+                                _state.label = 2;
+                            case 2:
                                 usePreloadedAd = false;
                                 preloaded = this.preloadPool.getPreloadedAd();
                                 if (preloaded) {
@@ -1415,7 +1471,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                         source: "hls",
                                         vastUrl: firstAdUrl,
                                         timestamp: /* @__PURE__ */ new Date().toISOString()
-                                    }).catch(function() {});
+                                    }, this.analyticsContext).catch(function() {});
                                     if (this.debug) {
                                         console.log("[CONTINUOUS-FETCH] Using preloaded ad from pool (preloaded in advance, ready immediately!)");
                                     }
@@ -1446,21 +1502,21 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                 if (this.debug) {
                                     console.log("[CONTINUOUS-FETCH] First VAST URL:", firstAdUrl);
                                 }
-                                _state.label = 1;
-                            case 1:
+                                _state.label = 3;
+                            case 3:
                                 _state.trys.push([
-                                    1,
-                                    12,
+                                    3,
+                                    14,
                                     ,
-                                    20
+                                    22
                                 ]);
                                 if (!(usePreloadedAd && preloadedController)) return [
                                     3,
-                                    5
+                                    7
                                 ];
                                 if (!!this.timing.ensureLoadedAdFitsBudget(preloadedController)) return [
                                     3,
-                                    3
+                                    5
                                 ];
                                 this.timing.rejectLoadedAdForDuration(preloadedController);
                                 this.startContinuousFetching(baseVastUrl);
@@ -1468,12 +1524,12 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                     4,
                                     this.tryNextAvailableAdWithRateLimit()
                                 ];
-                            case 2:
+                            case 4:
                                 _state.sent();
                                 return [
                                     2
                                 ];
-                            case 3:
+                            case 5:
                                 adPlayer = this.host.getAdPlayer();
                                 preservedMuted = adPlayer.getOriginalMutedState();
                                 preservedVolume = adPlayer.getOriginalVolume();
@@ -1498,7 +1554,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                     4,
                                     preloadedController.play()
                                 ];
-                            case 4:
+                            case 6:
                                 _state.sent();
                                 this.timing.markAdStarted();
                                 if (this.timing.expectedAdBreakDurationMs != null && this.timing.getAdBreakEndWallClockMs() == null) {
@@ -1508,34 +1564,34 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                 preloadedController.setAdVolume(adVolume);
                                 return [
                                     3,
-                                    11
+                                    13
                                 ];
-                            case 5:
+                            case 7:
                                 adPlayer1 = this.host.getAdPlayer();
                                 return [
                                     4,
                                     this.timing.enforceGlobalRateLimit()
                                 ];
-                            case 6:
+                            case 8:
                                 _state.sent();
                                 this.timing.lastAdRequestTime = Date.now();
                                 return [
                                     4,
                                     adPlayer1.requestAds(firstAdUrl)
                                 ];
-                            case 7:
+                            case 9:
                                 _state.sent();
                                 sendAdLoadedTracking(this.host.config.licenseKey, {
                                     source: "hls",
                                     vastUrl: firstAdUrl,
                                     timestamp: /* @__PURE__ */ new Date().toISOString()
-                                }).catch(function() {});
+                                }, this.analyticsContext).catch(function() {});
                                 if (this.debug) {
                                     console.log("[CONTINUOUS-FETCH] First ad request successful, starting playback");
                                 }
                                 if (!!this.timing.ensureLoadedAdFitsBudget(adPlayer1)) return [
                                     3,
-                                    9
+                                    11
                                 ];
                                 this.timing.rejectLoadedAdForDuration(adPlayer1);
                                 this.recreateAdController();
@@ -1544,12 +1600,12 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                     4,
                                     this.tryNextAvailableAdWithRateLimit()
                                 ];
-                            case 8:
+                            case 10:
                                 _state.sent();
                                 return [
                                     2
                                 ];
-                            case 9:
+                            case 11:
                                 this.timing.consecutiveFailures = 0;
                                 this.startContinuousFetching(baseVastUrl);
                                 if (!this.preloadPool.active) {
@@ -1559,7 +1615,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                     4,
                                     adPlayer1.play()
                                 ];
-                            case 10:
+                            case 12:
                                 _state.sent();
                                 this.timing.markAdStarted();
                                 if (this.timing.expectedAdBreakDurationMs != null && this.timing.getAdBreakEndWallClockMs() == null) {
@@ -1567,40 +1623,40 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                 }
                                 adVolume1 = currentMuted ? 0 : currentVolume;
                                 adPlayer1.setAdVolume(adVolume1);
-                                _state.label = 11;
-                            case 11:
+                                _state.label = 13;
+                            case 13:
                                 return [
                                     3,
-                                    20
+                                    22
                                 ];
-                            case 12:
+                            case 14:
                                 error = _state.sent();
                                 if (this.debug) {
                                     console.warn("[CONTINUOUS-FETCH] First ad request failed:", error);
                                 }
                                 if (!!usePreloadedAd) return [
                                     3,
-                                    18
+                                    20
                                 ];
                                 fallbackPreloaded = this.preloadPool.getPreloadedAd();
                                 if (!fallbackPreloaded) return [
                                     3,
-                                    18
+                                    20
                                 ];
                                 if (this.debug) {
                                     console.log("[CONTINUOUS-FETCH] First ad failed, using preloaded fallback");
                                 }
-                                _state.label = 13;
-                            case 13:
+                                _state.label = 15;
+                            case 15:
                                 _state.trys.push([
-                                    13,
-                                    17,
+                                    15,
+                                    19,
                                     ,
-                                    18
+                                    20
                                 ]);
                                 if (!!this.timing.ensureLoadedAdFitsBudget(fallbackPreloaded.adController)) return [
                                     3,
-                                    15
+                                    17
                                 ];
                                 this.timing.rejectLoadedAdForDuration(fallbackPreloaded.adController);
                                 this.startContinuousFetching(baseVastUrl);
@@ -1608,12 +1664,12 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                     4,
                                     this.tryNextAvailableAdWithRateLimit()
                                 ];
-                            case 14:
+                            case 16:
                                 _state.sent();
                                 return [
                                     2
                                 ];
-                            case 15:
+                            case 17:
                                 this.swapToPreloadedAdPlayer(fallbackPreloaded.adController);
                                 this.timing.consecutiveFailures = 0;
                                 this.startContinuousFetching(baseVastUrl);
@@ -1626,7 +1682,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                     4,
                                     ap.play()
                                 ];
-                            case 16:
+                            case 18:
                                 _state.sent();
                                 this.timing.markAdStarted();
                                 if (this.timing.expectedAdBreakDurationMs != null && this.timing.getAdBreakEndWallClockMs() == null) {
@@ -1637,16 +1693,16 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                 return [
                                     2
                                 ];
-                            case 17:
+                            case 19:
                                 fallbackError = _state.sent();
                                 if (this.debug) {
                                     console.warn("[CONTINUOUS-FETCH] Preloaded fallback also failed:", fallbackError);
                                 }
                                 return [
                                     3,
-                                    18
+                                    20
                                 ];
-                            case 18:
+                            case 20:
                                 if (this.timing.isTemporaryAdError(error)) {
                                     this.timing.temporaryFailureUrls.set(firstAdUrl, Date.now());
                                     if (this.debug) {
@@ -1664,13 +1720,137 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                     4,
                                     this.tryNextAvailableAdWithRateLimit()
                                 ];
-                            case 19:
+                            case 21:
                                 _state.sent();
                                 return [
                                     3,
-                                    20
+                                    22
                                 ];
-                            case 20:
+                            case 22:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        },
+        {
+            key: "startOptimizedPod",
+            value: // ───────────────────────────────────────────────────────────────
+            //  Optimized pod (single multi-ad request)
+            // ───────────────────────────────────────────────────────────────
+            function startOptimizedPod(baseVastUrl, breakDurationMs, currentMuted, currentVolume) {
+                return _async_to_generator(function() {
+                    var podUrl, adPlayer, requestToken, _ref, _adPlayer_getPodAdCount, podCount, error;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                if (this.pendingAdBreak && this.pendingAdBreak.vastUrls.length > 0) {
+                                    podUrl = this.pendingAdBreak.vastUrls[0];
+                                    this.clearPendingAdBreak();
+                                } else {
+                                    podUrl = this.host.generatePodVastUrl(baseVastUrl, breakDurationMs);
+                                }
+                                if (!podUrl) {
+                                    return [
+                                        2,
+                                        false
+                                    ];
+                                }
+                                this.continuousFetchingActive = false;
+                                this.recreateAdController();
+                                adPlayer = this.host.getAdPlayer();
+                                requestToken = ++this.timing.adRequestTokenCounter;
+                                this.timing.activeAdRequestToken = requestToken;
+                                this.timing.startAdRequestWatchdog(requestToken);
+                                _state.label = 1;
+                            case 1:
+                                _state.trys.push([
+                                    1,
+                                    5,
+                                    ,
+                                    6
+                                ]);
+                                return [
+                                    4,
+                                    this.timing.enforceGlobalRateLimit()
+                                ];
+                            case 2:
+                                _state.sent();
+                                this.timing.lastAdRequestTime = Date.now();
+                                return [
+                                    4,
+                                    adPlayer.requestAds(podUrl)
+                                ];
+                            case 3:
+                                _state.sent();
+                                this.timing.clearAdRequestWatchdog();
+                                if (this.timing.activeAdRequestToken !== requestToken) {
+                                    return [
+                                        2,
+                                        true
+                                    ];
+                                }
+                                podCount = (_ref = (_adPlayer_getPodAdCount = adPlayer.getPodAdCount) === null || _adPlayer_getPodAdCount === void 0 ? void 0 : _adPlayer_getPodAdCount.call(adPlayer)) !== null && _ref !== void 0 ? _ref : 1;
+                                if (podCount < 1) {
+                                    return [
+                                        2,
+                                        false
+                                    ];
+                                }
+                                if (this.debug) {
+                                    console.log(podCount === 1 ? "[POD] Response contained a single ad; playing it and enabling sequential top-up" : "[POD] Optimized pod returned ".concat(podCount, " ads; playing pod in one controller"));
+                                }
+                                sendAdLoadedTracking(this.host.config.licenseKey, {
+                                    source: "hls",
+                                    vastUrl: podUrl,
+                                    timestamp: /* @__PURE__ */ new Date().toISOString()
+                                }, this.analyticsContext).catch(function() {});
+                                this.timing.startAdFailsafeTimer(requestToken);
+                                return [
+                                    4,
+                                    adPlayer.play()
+                                ];
+                            case 4:
+                                _state.sent();
+                                this.timing.markAdStarted();
+                                if (this.timing.expectedAdBreakDurationMs != null && this.timing.getAdBreakEndWallClockMs() == null) {
+                                    this.timing.scheduleAdStopAtBreakBoundary();
+                                }
+                                adPlayer.setAdVolume(currentMuted ? 0 : currentVolume);
+                                this.timing.consecutiveFailures = 0;
+                                if (podCount === 1) {
+                                    this.continuousFetchingActive = true;
+                                    this.startContinuousFetching(baseVastUrl);
+                                    if (!this.preloadPool.active) {
+                                        this.preloadPool.startPreloadPool(baseVastUrl, []);
+                                    }
+                                }
+                                return [
+                                    2,
+                                    true
+                                ];
+                            case 5:
+                                error = _state.sent();
+                                this.timing.clearAdRequestWatchdog();
+                                this.timing.clearAdFailsafeTimer();
+                                if (this.timing.activeAdRequestToken === requestToken) {
+                                    this.timing.activeAdRequestToken = null;
+                                }
+                                if (this.debug) {
+                                    console.warn("[POD] Optimized pod request/play failed:", error);
+                                }
+                                if (this.timing.isTemporaryAdError(error)) {
+                                    this.timing.temporaryFailureUrls.set(podUrl, Date.now());
+                                }
+                                this.continuousFetchingActive = true;
+                                this.recreateAdController();
+                                return [
+                                    2,
+                                    false
+                                ];
+                            case 6:
                                 return [
                                     2
                                 ];
@@ -1993,7 +2173,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                     source: "hls",
                                     vastUrl: preloaded.vastUrl,
                                     timestamp: /* @__PURE__ */ new Date().toISOString()
-                                }).catch(function() {});
+                                }, this.analyticsContext).catch(function() {});
                                 _state.label = 1;
                             case 1:
                                 _state.trys.push([
@@ -2226,7 +2406,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                     source: "hls",
                                     vastUrl: vastTagUrl,
                                     timestamp: /* @__PURE__ */ new Date().toISOString()
-                                }).catch(function() {});
+                                }, this.analyticsContext).catch(function() {});
                                 this.timing.clearAdRequestWatchdog();
                                 if (this.timing.activeAdRequestToken !== requestToken) return [
                                     2