stormcloud-video-player 0.8.9 → 0.8.10

package/lib/index.d.cts

@@ -27,6 +27,7 @@ interface StormcloudVideoPlayerConfig {
     adFailsafeTimeoutMs?: number;
     adBreakCheckIntervalMs?: number;
     maxAdBreakExtensionMs?: number;
+    minRemainingMsToStartAd?: number;
     showCustomControls?: boolean;
     hideLoadingIndicator?: boolean;
     onVolumeToggle?: () => void;
@@ -202,6 +203,7 @@ declare class StormcloudVideoPlayer {
     private readonly maxConsecutiveFailures;
     private lastAdRequestTime;
     private readonly minAdRequestIntervalMs;
+    private readonly defaultMinRemainingMsToStartAd;
     private readonly backoffBaseMs;
     private readonly maxBackoffMs;
     private placeholderContainer;
@@ -337,6 +339,8 @@ declare class StormcloudVideoPlayer {
     private selectVastTagsForBreak;
     private logAdState;
     private getRemainingAdMs;
+    private getMinRemainingMsToStartAd;
+    private hasTimeToStartAnotherAd;
     private findBreakForTime;
     toggleMute(): void;
     toggleFullscreen(): Promise<void>;

package/lib/index.d.ts

@@ -27,6 +27,7 @@ interface StormcloudVideoPlayerConfig {
     adFailsafeTimeoutMs?: number;
     adBreakCheckIntervalMs?: number;
     maxAdBreakExtensionMs?: number;
+    minRemainingMsToStartAd?: number;
     showCustomControls?: boolean;
     hideLoadingIndicator?: boolean;
     onVolumeToggle?: () => void;
@@ -202,6 +203,7 @@ declare class StormcloudVideoPlayer {
     private readonly maxConsecutiveFailures;
     private lastAdRequestTime;
     private readonly minAdRequestIntervalMs;
+    private readonly defaultMinRemainingMsToStartAd;
     private readonly backoffBaseMs;
     private readonly maxBackoffMs;
     private placeholderContainer;
@@ -337,6 +339,8 @@ declare class StormcloudVideoPlayer {
     private selectVastTagsForBreak;
     private logAdState;
     private getRemainingAdMs;
+    private getMinRemainingMsToStartAd;
+    private hasTimeToStartAnotherAd;
     private findBreakForTime;
     toggleMute(): void;
     toggleFullscreen(): Promise<void>;

package/lib/index.js

@@ -2708,6 +2708,7 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
         this.maxConsecutiveFailures = 5;
         this.lastAdRequestTime = 0;
         this.minAdRequestIntervalMs = 3e3;
+        this.defaultMinRemainingMsToStartAd = 4e3;
         this.backoffBaseMs = 1e3;
         this.maxBackoffMs = 15e3;
         this.globalConsecutiveNoFills = 0;
@@ -3227,7 +3228,7 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
                         } : {});
                     }
                     if (_this.inAdBreak) {
-                        if (remaining > 500) {
+                        if (_this.hasTimeToStartAnotherAd()) {
                             _this.tryNextAvailableAdWithRateLimit();
                         } else {
                             _this.handleAdPodComplete();
@@ -3300,7 +3301,7 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
                             queuedUrls: _to_consumable_array(_this.adRequestQueue)
                         } : {});
                     }
-                    if (remaining > 500) {
+                    if (_this.hasTimeToStartAnotherAd()) {
                         _this.tryNextAvailableAdWithRateLimit();
                     } else {
                         _this.handleAdPodComplete();
@@ -4000,7 +4001,7 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
                         var remainingMs1 = Math.max(0, this.expectedAdBreakDurationMs - elapsedMs1);
                         this.scheduleAdStopCountdown(remainingMs1);
                     }
-                    if (!this.adPlayer.isAdPlaying() && this.activeAdRequestToken === null && this.adRequestQueue.length > 0) {
+                    if (!this.adPlayer.isAdPlaying() && this.activeAdRequestToken === null && this.adRequestQueue.length > 0 && this.hasTimeToStartAnotherAd()) {
                         this.tryNextAvailableAdWithRateLimit();
                     }
                     return;
@@ -5459,7 +5460,7 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
             key: "preloadPoolLoop",
             value: function preloadPoolLoop(baseVastUrl) {
                 return _async_to_generator(function() {
-                    var epoch, remaining, newUrls, newUrl;
+                    var epoch, newUrls, newUrl;
                     return _ts_generator(this, function(_state) {
                         switch(_state.label){
                             case 0:
@@ -5526,14 +5527,14 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
                                         8
                                     ];
                                 }
-                                if (this.inAdBreak) {
-                                    remaining = this.getRemainingAdMs();
-                                    if (remaining <= 0) {
-                                        return [
-                                            3,
-                                            8
-                                        ];
+                                if (this.inAdBreak && !this.hasTimeToStartAnotherAd()) {
+                                    if (this.config.debugAdTiming) {
+                                        console.log("[PRELOAD-POOL] Not enough ad break time left, stopping preload");
                                     }
+                                    return [
+                                        3,
+                                        8
+                                    ];
                                 }
                                 newUrls = this.generateVastUrlsWithCorrelators(baseVastUrl, 1);
                                 newUrl = newUrls[0];
@@ -5963,9 +5964,9 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
                                         switch(_state.label){
                                             case 0:
                                                 remaining = _this.getRemainingAdMs();
-                                                if (remaining <= 0) {
+                                                if (remaining <= _this.getMinRemainingMsToStartAd()) {
                                                     if (_this.config.debugAdTiming) {
-                                                        console.log("[CONTINUOUS-FETCH] \u23F9\uFE0F Ad break time expired, stopping URL generation");
+                                                        console.log("[CONTINUOUS-FETCH] ⏹️ Not enough ad break time left (".concat(remaining, "ms), stopping URL generation"));
                                                     }
                                                     return [
                                                         2,
@@ -6185,9 +6186,9 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
                                     ];
                                 }
                                 remaining = this.getRemainingAdMs();
-                                if (remaining <= 500) {
+                                if (!this.hasTimeToStartAnotherAd()) {
                                     if (this.config.debugAdTiming) {
-                                        console.log("[CONTINUOUS-FETCH] \u23F9\uFE0F No time remaining, ending ad break");
+                                        console.log("[CONTINUOUS-FETCH] ⏹️ Not enough time remaining (".concat(remaining, "ms) to start another ad, ending ad break"));
                                     }
                                     this.handleAdPodComplete();
                                     return [
@@ -6459,12 +6460,27 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
                                         10
                                     ];
                                 }
+                                if (!this.hasTimeToStartAnotherAd()) {
+                                    if (this.config.debugAdTiming) {
+                                        console.log("[CONTINUOUS-FETCH] \u23F9\uFE0F Not enough time remaining during placeholder wait, ending ad break");
+                                    }
+                                    return [
+                                        3,
+                                        10
+                                    ];
+                                }
                                 _state.label = 3;
                             case 3:
                                 if (!(this.adRequestQueue.length > 0)) return [
                                     3,
                                     9
                                 ];
+                                if (!this.hasTimeToStartAnotherAd()) {
+                                    return [
+                                        3,
+                                        9
+                                    ];
+                                }
                                 nextAdUrl = this.adRequestQueue.shift();
                                 if (!nextAdUrl) {
                                     return [
@@ -6747,21 +6763,23 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
                 if (!this.inAdBreak) return;
                 this.adStopTimerId = void 0;
                 var adPlaying = this.adPlayer.isAdPlaying();
-                var pendingAds = this.adPodQueue.length > 0;
                 var checkIntervalMs = Math.max(250, Math.floor((_this_config_adBreakCheckIntervalMs = this.config.adBreakCheckIntervalMs) !== null && _this_config_adBreakCheckIntervalMs !== void 0 ? _this_config_adBreakCheckIntervalMs : 1e3));
                 var maxExtensionMsConfig = this.config.maxAdBreakExtensionMs;
-                var maxExtensionMs = typeof maxExtensionMsConfig === "number" && maxExtensionMsConfig > 0 ? maxExtensionMsConfig : 6e4;
+                var maxExtensionMs = typeof maxExtensionMsConfig === "number" && maxExtensionMsConfig > 0 ? maxExtensionMsConfig : 0;
                 var elapsedSinceStartMs = 0;
                 if (this.currentAdBreakStartWallClockMs != null) {
                     elapsedSinceStartMs = Date.now() - this.currentAdBreakStartWallClockMs;
                 }
                 var expectedDurationMs = (_this_expectedAdBreakDurationMs = this.expectedAdBreakDurationMs) !== null && _this_expectedAdBreakDurationMs !== void 0 ? _this_expectedAdBreakDurationMs : 0;
                 var overrunMs = Math.max(0, elapsedSinceStartMs - expectedDurationMs);
-                var shouldExtendAdBreak = (adPlaying || pendingAds || this.showAds) && overrunMs < maxExtensionMs;
+                var shouldExtendAdBreak = adPlaying && overrunMs < maxExtensionMs;
                 if (shouldExtendAdBreak) {
                     this.scheduleAdStopCountdown(checkIntervalMs);
                     return;
                 }
+                if (this.config.debugAdTiming) {
+                    console.log("[StormcloudVideoPlayer] ⏱️ Ad break boundary reached (overrun=".concat(overrunMs, "ms) - hard-stopping ads and resuming stream"));
+                }
                 if (adPlaying) {
                     this.adPlayer.stop().catch(function() {});
                 }
@@ -7267,11 +7285,11 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
                     this.handleAdPodComplete();
                     return;
                 }
-                if (remaining > 500) {
+                if (this.hasTimeToStartAnotherAd()) {
                     this.tryNextAvailableAdWithRateLimit();
                 } else {
                     if (this.config.debugAdTiming) {
-                        console.log("[AD-ERROR] Ad failed and no time remaining. Failed URLs:", this.failedVastUrls.size);
+                        console.log("[AD-ERROR] Ad failed and not enough time remaining for another ad. Failed URLs:", this.failedVastUrls.size);
                     }
                     this.handleAdPodComplete();
                 }
@@ -7406,6 +7424,22 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
                 return Math.max(0, this.expectedAdBreakDurationMs - elapsed);
             }
         },
+        {
+            key: "getMinRemainingMsToStartAd",
+            value: function getMinRemainingMsToStartAd() {
+                var configured = this.config.minRemainingMsToStartAd;
+                if (typeof configured === "number" && configured >= 0) {
+                    return configured;
+                }
+                return this.defaultMinRemainingMsToStartAd;
+            }
+        },
+        {
+            key: "hasTimeToStartAnotherAd",
+            value: function hasTimeToStartAnotherAd() {
+                return this.getRemainingAdMs() > this.getMinRemainingMsToStartAd();
+            }
+        },
         {
             key: "findBreakForTime",
             value: function findBreakForTime(nowMs) {