stormcloud-video-player 0.8.43 → 0.8.44

package/lib/sdk/hlsAdPlayer.d.cts

@@ -1,4 +1,4 @@
-import { A as AdController } from '../types-cTqIKw_D.cjs';
+import { A as AdController } from '../types-iDjS8f_7.cjs';
 import Hls from 'hls.js';
 
 declare function createHlsAdPlayer(contentVideo: HTMLVideoElement, options?: {

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

@@ -8083,6 +8083,34 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                 return 0;
             }
         },
+        {
+            key: "describeVideoState",
+            value: function describeVideoState() {
+                var _networkStates_v_networkState, _readyStates_v_readyState;
+                var v = this.host.video;
+                var networkStates = [
+                    "EMPTY",
+                    "IDLE",
+                    "LOADING",
+                    "NO_SOURCE"
+                ];
+                var readyStates = [
+                    "HAVE_NOTHING",
+                    "HAVE_METADATA",
+                    "HAVE_CURRENT_DATA",
+                    "HAVE_FUTURE_DATA",
+                    "HAVE_ENOUGH_DATA"
+                ];
+                var net = (_networkStates_v_networkState = networkStates[v.networkState]) !== null && _networkStates_v_networkState !== void 0 ? _networkStates_v_networkState : String(v.networkState);
+                var ready = (_readyStates_v_readyState = readyStates[v.readyState]) !== null && _readyStates_v_readyState !== void 0 ? _readyStates_v_readyState : String(v.readyState);
+                var err = v.error ? "code=".concat(v.error.code).concat(v.error.message ? " (".concat(v.error.message, ")") : "") : "none";
+                var ranges = [];
+                for(var i = 0; i < v.buffered.length; i++){
+                    ranges.push("[".concat(v.buffered.start(i).toFixed(2), "–").concat(v.buffered.end(i).toFixed(2), "]"));
+                }
+                return "t=".concat(v.currentTime.toFixed(2), "s paused=").concat(v.paused, " ended=").concat(v.ended, " seeking=").concat(v.seeking, " readyState=").concat(ready, " networkState=").concat(net, " error=").concat(err, " buffered=").concat(ranges.length ? ranges.join(",") : "none");
+            }
+        },
         {
             key: "monitorLiveResumeStall",
             value: function monitorLiveResumeStall(resumeBaseline) {
@@ -8096,18 +8124,93 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                 var baseline = resumeBaseline;
                 var recoveries = 0;
                 var lastRecoveryAt = 0;
+                var video = this.host.video;
+                var listenersAttached = false;
+                var onMediaEvent;
+                var diagEvents = [
+                    "loadstart",
+                    "loadedmetadata",
+                    "loadeddata",
+                    "canplay",
+                    "canplaythrough",
+                    "play",
+                    "playing",
+                    "pause",
+                    "waiting",
+                    "stalled",
+                    "suspend",
+                    "seeking",
+                    "seeked",
+                    "emptied",
+                    "error",
+                    "ended"
+                ];
+                if (this.debug) {
+                    onMediaEvent = function onMediaEvent(e) {
+                        var dt = ((Date.now() - startTime) / 1e3).toFixed(1);
+                        console.log("[ResumeDiag] +".concat(dt, "s event=").concat(e.type, " — ").concat(_this.describeVideoState()));
+                    };
+                    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                    try {
+                        for(var _iterator = diagEvents[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                            var name = _step.value;
+                            video.addEventListener(name, onMediaEvent);
+                        }
+                    } catch (err) {
+                        _didIteratorError = true;
+                        _iteratorError = err;
+                    } finally{
+                        try {
+                            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                _iterator.return();
+                            }
+                        } finally{
+                            if (_didIteratorError) {
+                                throw _iteratorError;
+                            }
+                        }
+                    }
+                    listenersAttached = true;
+                    console.log("[ResumeDiag] +0.0s monitor start — ".concat(this.describeVideoState()));
+                }
+                var cleanup = function cleanup() {
+                    if (listenersAttached && onMediaEvent) {
+                        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                        try {
+                            for(var _iterator = diagEvents[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                                var name = _step.value;
+                                video.removeEventListener(name, onMediaEvent);
+                            }
+                        } catch (err) {
+                            _didIteratorError = true;
+                            _iteratorError = err;
+                        } finally{
+                            try {
+                                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                    _iterator.return();
+                                }
+                            } finally{
+                                if (_didIteratorError) {
+                                    throw _iteratorError;
+                                }
+                            }
+                        }
+                        listenersAttached = false;
+                    }
+                };
                 var poll = function poll1() {
                     if (_this.inAdBreak) {
+                        cleanup();
                         return;
                     }
-                    var video = _this.host.video;
                     var currentTime = video.currentTime;
                     var advanced = currentTime > baseline + 0.5;
                     var playing = !video.paused && video.readyState >= 3;
                     if (advanced && playing) {
                         if (_this.debug) {
-                            console.log("[StormcloudVideoPlayer] Live stream resumed successfully after ad break");
+                            console.log("[StormcloudVideoPlayer] Live stream resumed successfully after ad break — ".concat(_this.describeVideoState()));
                         }
+                        cleanup();
                         return;
                     }
                     if (video.paused) {
@@ -8119,8 +8222,9 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                     var wedged = bufferedAhead < 0.5 && !advanced;
                     if (elapsed >= maxMonitorMs) {
                         if (_this.debug && !advanced) {
-                            console.warn("[StormcloudVideoPlayer] Live stream failed to resume after ".concat((maxMonitorMs / 1e3).toFixed(0), "s (t=").concat(currentTime.toFixed(2), "s, buffered=").concat(bufferedAhead.toFixed(2), "s)"));
+                            console.warn("[StormcloudVideoPlayer] Live stream failed to resume after ".concat((maxMonitorMs / 1e3).toFixed(0), "s — ").concat(_this.describeVideoState()));
                         }
+                        cleanup();
                         return;
                     }
                     var canRecover = wedged && elapsed >= graceMs && Date.now() - lastRecoveryAt >= recoveryCooldownMs && recoveries < maxRecoveries;
@@ -8132,7 +8236,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                             var liveSyncPos = _this.host.getLiveSyncPosition();
                             var reloadPos = liveSyncPos != null && liveSyncPos > currentTime ? liveSyncPos : currentTime;
                             if (_this.debug) {
-                                console.warn("[StormcloudVideoPlayer] Content wedged after ad break (t=".concat(currentTime.toFixed(2), "s, buffered=").concat(bufferedAhead.toFixed(2), "s) — restarting HLS load at ").concat(reloadPos.toFixed(2), "s (recovery ").concat(recoveries, "/").concat(maxRecoveries, ")"));
+                                console.warn("[StormcloudVideoPlayer] Content wedged after ad break — restarting HLS load at ".concat(reloadPos.toFixed(2), "s (recovery ").concat(recoveries, "/").concat(maxRecoveries, ") — ").concat(_this.describeVideoState()));
                             }
                             if (liveSyncPos != null && liveSyncPos > currentTime) {
                                 video.currentTime = liveSyncPos;
@@ -8140,7 +8244,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                             _this.host.restartHlsLoad(reloadPos);
                         } else {
                             if (_this.debug) {
-                                console.warn("[StormcloudVideoPlayer] Content still wedged after ad break (t=".concat(currentTime.toFixed(2), "s, buffered=").concat(bufferedAhead.toFixed(2), "s) — hard-reloading live stream (recovery ").concat(recoveries, "/").concat(maxRecoveries, ")"));
+                                console.warn("[StormcloudVideoPlayer] Content still wedged after ad break — hard-reloading live stream (recovery ".concat(recoveries, "/").concat(maxRecoveries, ") — ").concat(_this.describeVideoState()));
                             }
                             _this.host.reloadLiveStream();
                         }