stormcloud-video-player 0.8.47 → 0.8.49

package/lib/player/StormcloudVideoPlayer.d.cts

@@ -1,4 +1,4 @@
-import { a as StormcloudVideoPlayerConfig } from '../types-cTqIKw_D.cjs';
+import { S as StormcloudVideoPlayerConfig } from '../types-iDjS8f_7.cjs';
 
 declare class StormcloudVideoPlayer {
     private readonly video;

package/lib/player/playerTypes.d.cts

@@ -1,4 +1,4 @@
-import { S as Scte35Marker } from '../types-cTqIKw_D.cjs';
+import { a as Scte35Marker } from '../types-iDjS8f_7.cjs';
 
 type Scte35CueSource = "manifest" | "id3" | "ts";
 type Scte35CueReadiness = "early" | "playback";

package/lib/players/HlsPlayer.cjs

@@ -425,9 +425,11 @@ function createHlsAdPlayer(contentVideo, options) {
     var pendingTimeouts = [];
     var STALL_TIMEOUT_MS = 4e3;
     var STALL_CHECK_INTERVAL_MS = 1e3;
+    var BLACKFRAME_MIN_PLAYBACK_S = 1.5;
     var stallWatchdogId;
     var lastAdProgressTime = 0;
     var lastAdProgressPosition = 0;
+    var sawDecodedVideoFrame = false;
     var trackingFired = {
         impression: false,
         start: false,
@@ -569,6 +571,61 @@ function createHlsAdPlayer(contentVideo, options) {
         var url = mediaFile.url.toLowerCase();
         return type.startsWith("video/") || url.endsWith(".mp4") || url.includes(".mp4?");
     }
+    function isAudioMediaFile(mediaFile) {
+        var type = mediaFile.type.toLowerCase();
+        var url = (mediaFile.url.toLowerCase().split("?")[0] || "").trim();
+        return type.startsWith("audio/") || url.endsWith(".mp3") || url.endsWith(".aac") || url.endsWith(".m4a") || url.endsWith(".ogg") || url.endsWith(".oga") || url.endsWith(".opus") || url.endsWith(".wav") || url.endsWith(".weba");
+    }
+    function collectVideoMediaFiles(scope, verbose) {
+        var mediaFileElements = scope.querySelectorAll("MediaFile");
+        var mediaFiles = [];
+        if (verbose) {
+            console.log("[HlsAdPlayer] Found ".concat(mediaFileElements.length, " MediaFile element(s) in VAST XML"));
+        }
+        mediaFileElements.forEach(function(mf, index) {
+            var _mf_textContent;
+            var type = mf.getAttribute("type") || "";
+            var url = ((_mf_textContent = mf.textContent) === null || _mf_textContent === void 0 ? void 0 : _mf_textContent.trim()) || "";
+            var width = mf.getAttribute("width") || "";
+            var height = mf.getAttribute("height") || "";
+            if (verbose) {
+                console.log("[HlsAdPlayer] MediaFile ".concat(index, ': type="').concat(type, '", url="').concat(url, '", width="').concat(width, '", height="').concat(height, '"'));
+            }
+            if (!url) {
+                if (verbose) {
+                    console.warn("[HlsAdPlayer] MediaFile ".concat(index, " has empty URL"));
+                }
+                return;
+            }
+            var bitrateAttr = mf.getAttribute("bitrate");
+            var bitrateValue = bitrateAttr ? parseInt(bitrateAttr, 10) : void 0;
+            var mediaFile = {
+                url: url,
+                type: type,
+                width: parseInt(width || "1920", 10),
+                height: parseInt(height || "1080", 10),
+                bitrate: bitrateValue && bitrateValue > 0 ? bitrateValue : void 0
+            };
+            if (isAudioMediaFile(mediaFile)) {
+                console.warn("[HlsAdPlayer] MediaFile ".concat(index, ' skipped (audio-only, type="').concat(type, '") — audio ads are not played to avoid a black screen'));
+                return;
+            }
+            var hasExplicitDimensions = mf.getAttribute("width") != null && mf.getAttribute("height") != null;
+            if (!isHlsMediaFile(mediaFile) && hasExplicitDimensions && (mediaFile.width <= 1 || mediaFile.height <= 1)) {
+                console.warn("[HlsAdPlayer] MediaFile ".concat(index, " skipped (degenerate dimensions ").concat(mediaFile.width, "x").concat(mediaFile.height, ', type="').concat(type, '") — likely an audio-only placeholder rendition'));
+                return;
+            }
+            if (isHlsMediaFile(mediaFile) || isProgressiveMediaFile(mediaFile)) {
+                mediaFiles.push(mediaFile);
+                if (verbose) {
+                    console.log("[HlsAdPlayer] Added ".concat(isHlsMediaFile(mediaFile) ? "HLS" : "progressive", " MediaFile: ").concat(url));
+                }
+            } else if (verbose) {
+                console.log("[HlsAdPlayer] MediaFile ".concat(index, ' ignored (type="').concat(type, '" is not supported)'));
+            }
+        });
+        return mediaFiles;
+    }
     function createEmptyTrackingUrls() {
         return {
             impression: [],
@@ -656,37 +713,7 @@ function createHlsAdPlayer(contentVideo, options) {
             var durationText = ((_xmlDoc_querySelector3 = xmlDoc.querySelector("Duration")) === null || _xmlDoc_querySelector3 === void 0 ? void 0 : _xmlDoc_querySelector3.textContent) || "00:00:30";
             var durationParts = durationText.split(":");
             var duration = parseInt(durationParts[0] || "0", 10) * 3600 + parseInt(durationParts[1] || "0", 10) * 60 + parseInt(durationParts[2] || "0", 10);
-            var mediaFileElements = xmlDoc.querySelectorAll("MediaFile");
-            var mediaFiles = [];
-            console.log("[HlsAdPlayer] Found ".concat(mediaFileElements.length, " MediaFile element(s) in VAST XML"));
-            mediaFileElements.forEach(function(mf, index) {
-                var _mf_textContent;
-                var type = mf.getAttribute("type") || "";
-                var url = ((_mf_textContent = mf.textContent) === null || _mf_textContent === void 0 ? void 0 : _mf_textContent.trim()) || "";
-                var width = mf.getAttribute("width") || "";
-                var height = mf.getAttribute("height") || "";
-                console.log("[HlsAdPlayer] MediaFile ".concat(index, ': type="').concat(type, '", url="').concat(url, '", width="').concat(width, '", height="').concat(height, '"'));
-                var mediaFile = {
-                    url: url,
-                    type: type,
-                    width: parseInt(width || "1920", 10),
-                    height: parseInt(height || "1080", 10),
-                    bitrate: void 0
-                };
-                if (!url) {
-                    console.warn("[HlsAdPlayer] MediaFile ".concat(index, " has empty URL"));
-                    return;
-                }
-                var bitrateAttr = mf.getAttribute("bitrate");
-                var bitrateValue = bitrateAttr ? parseInt(bitrateAttr, 10) : void 0;
-                mediaFile.bitrate = bitrateValue && bitrateValue > 0 ? bitrateValue : void 0;
-                if (isHlsMediaFile(mediaFile) || isProgressiveMediaFile(mediaFile)) {
-                    mediaFiles.push(mediaFile);
-                    console.log("[HlsAdPlayer] Added ".concat(isHlsMediaFile(mediaFile) ? "HLS" : "progressive", " MediaFile: ").concat(url));
-                } else {
-                    console.log("[HlsAdPlayer] MediaFile ".concat(index, ' ignored (type="').concat(type, '" is not supported)'));
-                }
-            });
+            var mediaFiles = collectVideoMediaFiles(xmlDoc, true);
             if (mediaFiles.length === 0) {
                 if (isNoAdAvailable) {
                     console.warn("[HlsAdPlayer] No ads available (VAST response indicates no ads)");
@@ -734,28 +761,7 @@ function createHlsAdPlayer(contentVideo, options) {
             var durationText = ((_adElement_querySelector3 = adElement.querySelector("Duration")) === null || _adElement_querySelector3 === void 0 ? void 0 : _adElement_querySelector3.textContent) || "00:00:30";
             var durationParts = durationText.split(":");
             var duration = parseInt(durationParts[0] || "0", 10) * 3600 + parseInt(durationParts[1] || "0", 10) * 60 + parseInt(durationParts[2] || "0", 10);
-            var mediaFileElements = adElement.querySelectorAll("MediaFile");
-            var mediaFiles = [];
-            mediaFileElements.forEach(function(mf) {
-                var _mf_textContent;
-                var type = mf.getAttribute("type") || "";
-                var url = ((_mf_textContent = mf.textContent) === null || _mf_textContent === void 0 ? void 0 : _mf_textContent.trim()) || "";
-                var width = mf.getAttribute("width") || "";
-                var height = mf.getAttribute("height") || "";
-                if (!url) return;
-                var bitrateAttr = mf.getAttribute("bitrate");
-                var bitrateValue = bitrateAttr ? parseInt(bitrateAttr, 10) : void 0;
-                var mediaFile = {
-                    url: url,
-                    type: type,
-                    width: parseInt(width || "1920", 10),
-                    height: parseInt(height || "1080", 10),
-                    bitrate: bitrateValue && bitrateValue > 0 ? bitrateValue : void 0
-                };
-                if (isHlsMediaFile(mediaFile) || isProgressiveMediaFile(mediaFile)) {
-                    mediaFiles.push(mediaFile);
-                }
-            });
+            var mediaFiles = collectVideoMediaFiles(adElement, false);
             if (mediaFiles.length === 0) {
                 if (isNoAdAvailable) {
                     console.warn("[HlsAdPlayer] Pod <Ad> indicates no ad available");
@@ -1076,6 +1082,14 @@ function createHlsAdPlayer(contentVideo, options) {
                 fireTrackingPixels(currentAd.trackingUrls.thirdQuartile);
             }
         };
+        var onLoadedMetadata = function onLoadedMetadata() {
+            if (!adPlaying || !adVideoElement) return;
+            var videoWidth = adVideoElement.videoWidth, videoHeight = adVideoElement.videoHeight;
+            if (videoWidth <= 1 || videoHeight <= 1) {
+                console.warn("[HlsAdPlayer] Ad creative has no usable video dimensions (".concat(videoWidth, "x").concat(videoHeight, ") - skipping this creative"));
+                handleVideoDecodeFailure();
+            }
+        };
         var onPlaying = function onPlaying() {
             startStallWatchdog();
             if (!currentAd || trackingFired.start) return;
@@ -1127,6 +1141,10 @@ function createHlsAdPlayer(contentVideo, options) {
                 type: "timeupdate",
                 handler: onTimeUpdate
             },
+            {
+                type: "loadedmetadata",
+                handler: onLoadedMetadata
+            },
             {
                 type: "playing",
                 handler: onPlaying
@@ -1316,13 +1334,51 @@ function createHlsAdPlayer(contentVideo, options) {
         }
         handleAdError();
     }
+    function getDecodedVideoFrameCount(video) {
+        try {
+            if (typeof video.getVideoPlaybackQuality === "function") {
+                var quality = video.getVideoPlaybackQuality();
+                if (quality && typeof quality.totalVideoFrames === "number") {
+                    return quality.totalVideoFrames;
+                }
+            }
+            var legacyCount = video.webkitDecodedFrameCount;
+            if (typeof legacyCount === "number") {
+                return legacyCount;
+            }
+        } catch (error) {
+            console.warn("[HlsAdPlayer] Unable to read decoded video frame count:", error);
+        }
+        return void 0;
+    }
+    function handleVideoDecodeFailure() {
+        console.warn("[HlsAdPlayer] Ad audio is advancing but no video frames decoded (black screen) - skipping this creative");
+        clearStallWatchdog();
+        if (currentAd) {
+            fireTrackingPixels(currentAd.trackingUrls.error);
+        }
+        if (podIndex < podAds.length - 1 && advanceToNextPodAd()) {
+            return;
+        }
+        handleAdError();
+    }
     function startStallWatchdog() {
         clearStallWatchdog();
         noteAdProgress();
+        sawDecodedVideoFrame = false;
         stallWatchdogId = window.setInterval(function() {
             if (!adPlaying || !adVideoElement) {
                 return;
             }
+            if (!sawDecodedVideoFrame && !adVideoElement.paused) {
+                var decodedFrames = getDecodedVideoFrameCount(adVideoElement);
+                if (decodedFrames !== void 0 && decodedFrames > 0) {
+                    sawDecodedVideoFrame = true;
+                } else if (decodedFrames === 0 && adVideoElement.currentTime >= BLACKFRAME_MIN_PLAYBACK_S) {
+                    handleVideoDecodeFailure();
+                    return;
+                }
+            }
             if (adVideoElement.currentTime > lastAdProgressPosition + 0.05) {
                 noteAdProgress();
                 return;