stormcloud-video-player 0.8.48 → 0.8.49

package/lib/types-iDjS8f_7.d.cts

@@ -0,0 +1,133 @@
+interface AdBreak {
+    id?: string;
+    startTimeMs: number;
+    durationMs?: number;
+    vastTagUrl?: string;
+}
+interface StormcloudVideoPlayerConfig {
+    videoElement: HTMLVideoElement;
+    src: string;
+    autoplay?: boolean;
+    muted?: boolean;
+    allowNativeHls?: boolean;
+    lowLatencyMode?: boolean;
+    isLiveStream?: boolean;
+    pauseContentDuringAds?: boolean;
+    driftToleranceMs?: number;
+    immediateManifestAds?: boolean;
+    debugAdTiming?: boolean;
+    adFailsafeTimeoutMs?: number;
+    adBreakCheckIntervalMs?: number;
+    maxAdBreakExtensionMs?: number;
+    minRemainingMsToStartAd?: number;
+    showCustomControls?: boolean;
+    hideLoadingIndicator?: boolean;
+    onVolumeToggle?: () => void;
+    onFullscreenToggle?: () => void;
+    onControlClick?: () => void;
+    licenseKey?: string;
+    vastTagUrl?: string;
+    isVmap?: boolean;
+    vmapUrl?: string;
+    vastMode?: 'adstorm' | 'default';
+    minSegmentsBeforePlay?: number;
+    ctvAdRequest?: boolean;
+    adTest?: boolean;
+    podMaxAds?: number;
+    podMaxDurationMs?: number;
+    podExactDuration?: boolean;
+}
+interface Scte35Marker {
+    type: "start" | "end" | "progress";
+    ptsSeconds?: number;
+    durationSeconds?: number;
+    raw?: unknown;
+}
+interface Id3TagInfo {
+    key: string;
+    value: string | Uint8Array;
+    ptsSeconds?: number;
+}
+interface AdController {
+    initialize: () => void;
+    requestAds: (vastTagUrl: string) => Promise<void>;
+    play: () => Promise<void>;
+    pause: () => void;
+    resume: () => void;
+    stop: () => Promise<void>;
+    destroy: () => void;
+    isAdPlaying: () => boolean;
+    resize: (width: number, height: number) => void;
+    on: (event: string, listener: (payload?: any) => void) => void;
+    off: (event: string, listener: (payload?: any) => void) => void;
+    updateOriginalMutedState: (muted: boolean, volume?: number) => void;
+    getOriginalMutedState: () => boolean;
+    getOriginalVolume: () => number;
+    setAdVolume: (volume: number) => void;
+    getAdVolume: () => number;
+    showPlaceholder: () => void;
+    hidePlaceholder: () => void;
+    getLoadedAdDuration?: () => number | undefined;
+    getLoadedAdId?: () => string | undefined;
+    getPodAdCount?: () => number;
+    getPodTotalDurationMs?: () => number;
+}
+interface ClientInfo {
+    brand: string;
+    os: string;
+    model: string;
+    deviceType: "tv" | "mobile" | "tablet" | "desktop";
+    isSmartTV: boolean;
+    isAndroid: boolean;
+    isWebView: boolean;
+    isWebApp: boolean;
+    domain: string;
+    origin: string;
+    path: string;
+    userAgent: string;
+    vendor: string;
+    platform: string;
+    screen: {
+        width?: number;
+        height?: number;
+        availWidth?: number;
+        availHeight?: number;
+        orientation?: string;
+        pixelDepth?: number;
+    };
+    hardwareConcurrency: number;
+    deviceMemory: number | null;
+    maxTouchPoints: number;
+    language: string;
+    languages: string;
+    cookieEnabled: boolean;
+    doNotTrack: string;
+    referrer: string;
+    visibilityState: string;
+}
+interface PlayerAnalyticsContext {
+    inputStreamType?: string;
+    debugAdTiming?: boolean;
+}
+interface AdDetectInfo {
+    source: "scte35";
+    durationSeconds?: number;
+    ptsSeconds?: number;
+    detectedAtFragmentSn?: number;
+    timestamp: string;
+}
+interface AdLoadedInfo {
+    source: "vast" | "hls";
+    vastUrl?: string;
+    durationSeconds?: number;
+    timestamp: string;
+}
+interface AdImpressionInfo {
+    source: "vast" | "hls";
+    adIndex: number;
+    adUrl?: string;
+    durationSeconds?: number;
+    timestamp: string;
+}
+
+export type { AdController as A, ClientInfo as C, Id3TagInfo as I, PlayerAnalyticsContext as P, StormcloudVideoPlayerConfig as S, Scte35Marker as a, AdBreak as b, AdDetectInfo as c, AdImpressionInfo as d, AdLoadedInfo as e };

package/lib/ui/StormcloudVideoPlayer.cjs

@@ -411,9 +411,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,
@@ -594,6 +596,11 @@ function createHlsAdPlayer(contentVideo, options) {
                 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) {
@@ -1061,6 +1068,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;
@@ -1112,6 +1127,10 @@ function createHlsAdPlayer(contentVideo, options) {
                 type: "timeupdate",
                 handler: onTimeUpdate
             },
+            {
+                type: "loadedmetadata",
+                handler: onLoadedMetadata
+            },
             {
                 type: "playing",
                 handler: onPlaying
@@ -1301,13 +1320,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;