stormcloud-video-player 0.8.25 → 0.8.26

package/lib/index.js

@@ -382,6 +382,8 @@ function createHlsAdPlayer(contentVideo, options) {
     var adHls;
     var adContainerEl;
     var currentAd;
+    var podAds = [];
+    var podIndex = 0;
     var sessionId;
     var preloadedAds = /* @__PURE__ */ new Map();
     var preloadingAds = /* @__PURE__ */ new Map();
@@ -546,14 +548,14 @@ function createHlsAdPlayer(contentVideo, options) {
             error: []
         };
     }
-    function extractTrackingUrls(xmlDoc) {
+    function extractTrackingUrls(scope) {
         var trackingUrls = createEmptyTrackingUrls();
-        xmlDoc.querySelectorAll("Impression").forEach(function(el) {
+        scope.querySelectorAll("Impression").forEach(function(el) {
             var _el_textContent;
             var url = (_el_textContent = el.textContent) === null || _el_textContent === void 0 ? void 0 : _el_textContent.trim();
             if (url) trackingUrls.impression.push(url);
         });
-        xmlDoc.querySelectorAll("Tracking").forEach(function(el) {
+        scope.querySelectorAll("Tracking").forEach(function(el) {
             var _el_textContent;
             var event = el.getAttribute("event");
             var url = (_el_textContent = el.textContent) === null || _el_textContent === void 0 ? void 0 : _el_textContent.trim();
@@ -564,7 +566,7 @@ function createHlsAdPlayer(contentVideo, options) {
                 }
             }
         });
-        xmlDoc.querySelectorAll("Error").forEach(function(el) {
+        scope.querySelectorAll("Error").forEach(function(el) {
             var _el_textContent;
             var url = (_el_textContent = el.textContent) === null || _el_textContent === void 0 ? void 0 : _el_textContent.trim();
             if (url) trackingUrls.error.push(url);
@@ -674,6 +676,75 @@ function createHlsAdPlayer(contentVideo, options) {
             };
         }
     }
+    function parseAdElement(adElement) {
+        try {
+            var _adElement_querySelector, _adElement_querySelector_textContent, _adElement_querySelector1, _adElement_querySelector_textContent1, _adElement_querySelector2, _adElement_querySelector3;
+            var adId = adElement.getAttribute("id") || "unknown";
+            var title = ((_adElement_querySelector = adElement.querySelector("AdTitle")) === null || _adElement_querySelector === void 0 ? void 0 : _adElement_querySelector.textContent) || "Ad";
+            var clickThrough = (_adElement_querySelector1 = adElement.querySelector("ClickThrough")) === null || _adElement_querySelector1 === void 0 ? void 0 : (_adElement_querySelector_textContent = _adElement_querySelector1.textContent) === null || _adElement_querySelector_textContent === void 0 ? void 0 : _adElement_querySelector_textContent.trim();
+            var wrapperUri = (_adElement_querySelector2 = adElement.querySelector("VASTAdTagURI")) === null || _adElement_querySelector2 === void 0 ? void 0 : (_adElement_querySelector_textContent1 = _adElement_querySelector2.textContent) === null || _adElement_querySelector_textContent1 === void 0 ? void 0 : _adElement_querySelector_textContent1.trim();
+            if (wrapperUri) {
+                return {
+                    type: "wrapper",
+                    vastAdTagUri: wrapperUri,
+                    trackingUrls: extractTrackingUrls(adElement),
+                    clickThrough: clickThrough
+                };
+            }
+            var isNoAdAvailable = adId === "empty" || title.toLowerCase().includes("no ad available") || title.toLowerCase() === "no ad available";
+            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);
+                }
+            });
+            if (mediaFiles.length === 0) {
+                if (isNoAdAvailable) {
+                    console.warn("[HlsAdPlayer] Pod <Ad> indicates no ad available");
+                } else {
+                    console.warn("[HlsAdPlayer] No supported media files in pod <Ad>");
+                }
+                return {
+                    type: "empty"
+                };
+            }
+            return {
+                type: "inline",
+                ad: {
+                    id: adId,
+                    title: title,
+                    duration: duration,
+                    mediaFiles: mediaFiles,
+                    trackingUrls: extractTrackingUrls(adElement),
+                    clickThrough: clickThrough
+                }
+            };
+        } catch (error) {
+            console.error("[HlsAdPlayer] Error parsing pod <Ad> element:", error);
+            return {
+                type: "empty"
+            };
+        }
+    }
     function fetchVastXml(vastTagUrl) {
         return _async_to_generator(function() {
             var response;
@@ -750,6 +821,146 @@ function createHlsAdPlayer(contentVideo, options) {
             });
         }).apply(this, arguments);
     }
+    function fetchAndParsePod(vastTagUrl) {
+        return _async_to_generator(function() {
+            var vastXml, parser, xmlDoc, adElements, ads, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, adElement, parsed, resolved, error, err;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        return [
+                            4,
+                            fetchVastXml(vastTagUrl)
+                        ];
+                    case 1:
+                        vastXml = _state.sent();
+                        console.log("[HlsAdPlayer] Pod VAST XML received");
+                        parser = new DOMParser();
+                        xmlDoc = parser.parseFromString(vastXml, "text/xml");
+                        if (xmlDoc.querySelector("parsererror")) {
+                            console.error("[HlsAdPlayer] Pod VAST XML parsing error (malformed)");
+                            return [
+                                2,
+                                []
+                            ];
+                        }
+                        adElements = Array.from(xmlDoc.querySelectorAll("Ad"));
+                        if (adElements.length === 0) {
+                            console.warn("[HlsAdPlayer] No <Ad> elements found in pod VAST response");
+                            return [
+                                2,
+                                []
+                            ];
+                        }
+                        adElements.sort(function(a, b) {
+                            var aSeq = parseInt(a.getAttribute("sequence") || "", 10);
+                            var bSeq = parseInt(b.getAttribute("sequence") || "", 10);
+                            var aVal = Number.isFinite(aSeq) ? aSeq : Number.MAX_SAFE_INTEGER;
+                            var bVal = Number.isFinite(bSeq) ? bSeq : Number.MAX_SAFE_INTEGER;
+                            return aVal - bVal;
+                        });
+                        ads = [];
+                        _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                        _state.label = 2;
+                    case 2:
+                        _state.trys.push([
+                            2,
+                            10,
+                            11,
+                            12
+                        ]);
+                        _iterator = adElements[Symbol.iterator]();
+                        _state.label = 3;
+                    case 3:
+                        if (!!(_iteratorNormalCompletion = (_step = _iterator.next()).done)) return [
+                            3,
+                            9
+                        ];
+                        adElement = _step.value;
+                        parsed = parseAdElement(adElement);
+                        if (!(parsed.type === "inline")) return [
+                            3,
+                            4
+                        ];
+                        ads.push(parsed.ad);
+                        return [
+                            3,
+                            8
+                        ];
+                    case 4:
+                        if (!(parsed.type === "wrapper")) return [
+                            3,
+                            8
+                        ];
+                        _state.label = 5;
+                    case 5:
+                        _state.trys.push([
+                            5,
+                            7,
+                            ,
+                            8
+                        ]);
+                        return [
+                            4,
+                            fetchAndParseVastAd(parsed.vastAdTagUri, 1, parsed.trackingUrls)
+                        ];
+                    case 6:
+                        resolved = _state.sent();
+                        if (resolved) {
+                            ads.push(resolved);
+                        }
+                        return [
+                            3,
+                            8
+                        ];
+                    case 7:
+                        error = _state.sent();
+                        console.warn("[HlsAdPlayer] Failed to resolve wrapper <Ad> in pod:", error);
+                        return [
+                            3,
+                            8
+                        ];
+                    case 8:
+                        _iteratorNormalCompletion = true;
+                        return [
+                            3,
+                            3
+                        ];
+                    case 9:
+                        return [
+                            3,
+                            12
+                        ];
+                    case 10:
+                        err = _state.sent();
+                        _didIteratorError = true;
+                        _iteratorError = err;
+                        return [
+                            3,
+                            12
+                        ];
+                    case 11:
+                        try {
+                            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                _iterator.return();
+                            }
+                        } finally{
+                            if (_didIteratorError) {
+                                throw _iteratorError;
+                            }
+                        }
+                        return [
+                            7
+                        ];
+                    case 12:
+                        console.log("[HlsAdPlayer] Parsed ".concat(ads.length, " ad(s) from pod VAST response"));
+                        return [
+                            2,
+                            ads
+                        ];
+                }
+            });
+        })();
+    }
     function createAdVideoElement() {
         var video = document.createElement("video");
         video.style.position = "absolute";
@@ -794,6 +1005,9 @@ function createHlsAdPlayer(contentVideo, options) {
             trackingFired.complete = true;
             fireTrackingPixels(currentAd.trackingUrls.complete);
             console.log("[HlsAdPlayer] Ad completed");
+            if (podIndex < podAds.length - 1 && advanceToNextPodAd()) {
+                return;
+            }
             handleAdComplete();
         });
         adVideoElement.addEventListener("error", function(e) {
@@ -802,6 +1016,9 @@ function createHlsAdPlayer(contentVideo, options) {
             if (currentAd) {
                 fireTrackingPixels(currentAd.trackingUrls.error);
             }
+            if (podIndex < podAds.length - 1 && advanceToNextPodAd()) {
+                return;
+            }
             handleAdError();
         });
         adVideoElement.addEventListener("volumechange", function() {
@@ -830,6 +1047,94 @@ function createHlsAdPlayer(contentVideo, options) {
             delete contentVideo.dataset.stormcloudAdPlaying;
         }
     }
+    function resetQuartileTracking(preserveImpression) {
+        trackingFired = {
+            impression: preserveImpression ? trackingFired.impression : false,
+            start: false,
+            firstQuartile: false,
+            midpoint: false,
+            thirdQuartile: false,
+            complete: false
+        };
+    }
+    function loadCurrentAdMedia() {
+        if (!adVideoElement || !currentAd) {
+            throw new Error("No ad video element or ad to load");
+        }
+        var mediaFile = selectBestMediaFile(currentAd.mediaFiles);
+        if (!mediaFile) {
+            throw new Error("No media file available for ad");
+        }
+        var isHlsAd = isHlsMediaFile(mediaFile);
+        console.log("[HlsAdPlayer] Loading ".concat(isHlsAd ? "HLS" : "progressive", " ad (pod ").concat(podIndex + 1, "/").concat(podAds.length || 1, ") from: ").concat(mediaFile.url));
+        if (isHlsAd && Hls.isSupported()) {
+            if (adHls) {
+                adHls.destroy();
+            }
+            adHls = new Hls({
+                enableWorker: true,
+                lowLatencyMode: false
+            });
+            adHls.loadSource(mediaFile.url);
+            adHls.attachMedia(adVideoElement);
+            adHls.on(Hls.Events.MANIFEST_PARSED, function() {
+                console.log("[HlsAdPlayer] HLS manifest parsed, starting playback");
+                adVideoElement.play().catch(function(error) {
+                    console.error("[HlsAdPlayer] Error starting ad playback:", error);
+                    handleAdError();
+                });
+            });
+            adHls.on(Hls.Events.ERROR, function(_event, data) {
+                console.error("[HlsAdPlayer] HLS error:", data);
+                if (data.fatal) {
+                    handleAdError();
+                }
+            });
+        } else if (isHlsAd && adVideoElement.canPlayType("application/vnd.apple.mpegurl")) {
+            adVideoElement.src = mediaFile.url;
+            adVideoElement.play().catch(function(error) {
+                console.error("[HlsAdPlayer] Error starting ad playback:", error);
+                handleAdError();
+            });
+        } else if (!isHlsAd && isProgressiveMediaFile(mediaFile)) {
+            if (adHls) {
+                adHls.destroy();
+                adHls = void 0;
+            }
+            adVideoElement.src = mediaFile.url;
+            adVideoElement.load();
+            adVideoElement.play().catch(function(error) {
+                console.error("[HlsAdPlayer] Error starting progressive ad playback:", error);
+                handleAdError();
+            });
+        } else {
+            throw new Error("Unsupported ad media file type: ".concat(mediaFile.type));
+        }
+    }
+    function advanceToNextPodAd() {
+        if (podIndex >= podAds.length - 1) {
+            return false;
+        }
+        podIndex++;
+        currentAd = podAds[podIndex];
+        resetQuartileTracking(false);
+        if (currentAd) {
+            fireTrackingPixels(currentAd.trackingUrls.impression);
+            trackingFired.impression = true;
+            console.log("[HlsAdPlayer] Advancing to next pod ad (".concat(podIndex + 1, "/").concat(podAds.length, "): ").concat(currentAd.title, ", duration: ").concat(currentAd.duration, "s"));
+        }
+        try {
+            loadCurrentAdMedia();
+            emit("pod_ad_started", {
+                index: podIndex,
+                total: podAds.length
+            });
+            return true;
+        } catch (error) {
+            console.error("[HlsAdPlayer] Failed to load next pod ad:", error);
+            return false;
+        }
+    }
     function handleAdComplete() {
         console.log("[HlsAdPlayer] Handling ad completion");
         adPlaying = false;
@@ -883,7 +1188,7 @@ function createHlsAdPlayer(contentVideo, options) {
         },
         requestAds: function requestAds(vastTagUrl) {
             return _async_to_generator(function() {
-                var ad, error;
+                var ads, preloaded, error;
                 return _ts_generator(this, function(_state) {
                     switch(_state.label){
                         case 0:
@@ -904,12 +1209,18 @@ function createHlsAdPlayer(contentVideo, options) {
                                 6
                             ]);
                             sessionId = generateSessionId();
+                            ads = [];
                             if (!preloadedAds.has(vastTagUrl)) return [
                                 3,
                                 2
                             ];
-                            ad = preloadedAds.get(vastTagUrl);
+                            preloaded = preloadedAds.get(vastTagUrl);
                             preloadedAds.delete(vastTagUrl);
+                            if (preloaded) {
+                                ads = [
+                                    preloaded
+                                ];
+                            }
                             console.log("[HlsAdPlayer] Using preloaded VAST response:", vastTagUrl);
                             return [
                                 3,
@@ -918,13 +1229,13 @@ function createHlsAdPlayer(contentVideo, options) {
                         case 2:
                             return [
                                 4,
-                                fetchAndParseVastAd(vastTagUrl)
+                                fetchAndParsePod(vastTagUrl)
                             ];
                         case 3:
-                            ad = _state.sent();
+                            ads = _state.sent();
                             _state.label = 4;
                         case 4:
-                            if (!ad) {
+                            if (!ads.length) {
                                 console.warn("[HlsAdPlayer] No ads available from VAST response");
                                 emit("ad_error");
                                 return [
@@ -932,10 +1243,14 @@ function createHlsAdPlayer(contentVideo, options) {
                                     Promise.reject(new Error("No ads available from VAST response"))
                                 ];
                             }
-                            currentAd = ad;
-                            console.log("[HlsAdPlayer] Ad parsed: ".concat(ad.title, ", duration: ").concat(ad.duration, "s"));
-                            fireTrackingPixels(ad.trackingUrls.impression);
-                            trackingFired.impression = true;
+                            podAds = ads;
+                            podIndex = 0;
+                            currentAd = ads[0];
+                            console.log("[HlsAdPlayer] Pod parsed: ".concat(ads.length, ' ad(s), first="').concat(currentAd === null || currentAd === void 0 ? void 0 : currentAd.title, '", duration=').concat(currentAd === null || currentAd === void 0 ? void 0 : currentAd.duration, "s"));
+                            if (currentAd) {
+                                fireTrackingPixels(currentAd.trackingUrls.impression);
+                                trackingFired.impression = true;
+                            }
                             return [
                                 2,
                                 Promise.resolve()
@@ -958,7 +1273,7 @@ function createHlsAdPlayer(contentVideo, options) {
         },
         play: function play() {
             return _async_to_generator(function() {
-                var contentVolume, mediaFile, isHlsAd;
+                var contentVolume;
                 return _ts_generator(this, function(_state) {
                     if (!currentAd) {
                         console.warn("[HlsAdPlayer] Cannot play: No ad loaded (no ads available)");
@@ -974,14 +1289,7 @@ function createHlsAdPlayer(contentVideo, options) {
                             adContainerEl === null || adContainerEl === void 0 ? void 0 : adContainerEl.appendChild(adVideoElement);
                             setupAdEventListeners();
                         }
-                        trackingFired = {
-                            impression: trackingFired.impression,
-                            start: false,
-                            firstQuartile: false,
-                            midpoint: false,
-                            thirdQuartile: false,
-                            complete: false
-                        };
+                        resetQuartileTracking(true);
                         contentVolume = contentVideo.volume;
                         originalVolume = Math.max(0, Math.min(1, contentVolume || originalVolume));
                         if (!(options === null || options === void 0 ? void 0 : options.continueLiveStreamDuringAds)) {
@@ -999,60 +1307,12 @@ function createHlsAdPlayer(contentVideo, options) {
                             adVideoElement.muted = originalMutedState;
                             console.log("[HlsAdPlayer] Set ad video volume to ".concat(adVideoElement.volume, ", muted: ").concat(adVideoElement.muted, ", originalMutedState: ").concat(originalMutedState, ", contentVolume: ").concat(contentVolume));
                         }
-                        mediaFile = selectBestMediaFile(currentAd.mediaFiles);
-                        if (!mediaFile) {
-                            throw new Error("No media file available for ad");
-                        }
                         if (adContainerEl) {
                             adContainerEl.style.display = "flex";
                             adContainerEl.style.pointerEvents = "auto";
                         }
                         emit("content_pause");
-                        isHlsAd = isHlsMediaFile(mediaFile);
-                        console.log("[HlsAdPlayer] Loading ".concat(isHlsAd ? "HLS" : "progressive", " ad from: ").concat(mediaFile.url));
-                        if (isHlsAd && Hls.isSupported()) {
-                            if (adHls) {
-                                adHls.destroy();
-                            }
-                            adHls = new Hls({
-                                enableWorker: true,
-                                lowLatencyMode: false
-                            });
-                            adHls.loadSource(mediaFile.url);
-                            adHls.attachMedia(adVideoElement);
-                            adHls.on(Hls.Events.MANIFEST_PARSED, function() {
-                                console.log("[HlsAdPlayer] HLS manifest parsed, starting playback");
-                                adVideoElement.play().catch(function(error) {
-                                    console.error("[HlsAdPlayer] Error starting ad playback:", error);
-                                    handleAdError();
-                                });
-                            });
-                            adHls.on(Hls.Events.ERROR, function(event, data) {
-                                console.error("[HlsAdPlayer] HLS error:", data);
-                                if (data.fatal) {
-                                    handleAdError();
-                                }
-                            });
-                        } else if (isHlsAd && adVideoElement.canPlayType("application/vnd.apple.mpegurl")) {
-                            adVideoElement.src = mediaFile.url;
-                            adVideoElement.play().catch(function(error) {
-                                console.error("[HlsAdPlayer] Error starting ad playback:", error);
-                                handleAdError();
-                            });
-                        } else if (!isHlsAd && isProgressiveMediaFile(mediaFile)) {
-                            if (adHls) {
-                                adHls.destroy();
-                                adHls = void 0;
-                            }
-                            adVideoElement.src = mediaFile.url;
-                            adVideoElement.load();
-                            adVideoElement.play().catch(function(error) {
-                                console.error("[HlsAdPlayer] Error starting progressive ad playback:", error);
-                                handleAdError();
-                            });
-                        } else {
-                            throw new Error("Unsupported ad media file type: ".concat(mediaFile.type));
-                        }
+                        loadCurrentAdMedia();
                         return [
                             2,
                             Promise.resolve()
@@ -1127,6 +1387,8 @@ function createHlsAdPlayer(contentVideo, options) {
                         adVideoElement.src = "";
                     }
                     currentAd = void 0;
+                    podAds = [];
+                    podIndex = 0;
                     return [
                         2
                     ];
@@ -1176,6 +1438,8 @@ function createHlsAdPlayer(contentVideo, options) {
             }
             adContainerEl = void 0;
             currentAd = void 0;
+            podAds = [];
+            podIndex = 0;
             listeners.clear();
             preloadedAds.clear();
             preloadingAds.clear();
@@ -1267,6 +1531,14 @@ function createHlsAdPlayer(contentVideo, options) {
         },
         getLoadedAdId: function getLoadedAdId() {
             return currentAd === null || currentAd === void 0 ? void 0 : currentAd.id;
+        },
+        getPodAdCount: function getPodAdCount() {
+            return podAds.length;
+        },
+        getPodTotalDurationMs: function getPodTotalDurationMs() {
+            return podAds.reduce(function(total, ad) {
+                return total + (ad.duration > 0 ? ad.duration * 1e3 : 0);
+            }, 0);
         }
     };
 }
@@ -3121,7 +3393,20 @@ function applyVastMacros(baseUrl, ctx) {
     if (ctx.pod != null) {
         params.set("pod", String(ctx.pod));
     }
-    if (ctx.adPosition != null) {
+    var optimizedPodMode = ctx.podMaxAds != null || ctx.podMinDurationMs != null || ctx.podMaxDurationMs != null;
+    if (optimizedPodMode) {
+        params.delete("ppos");
+        params.delete("lip");
+        if (ctx.podMinDurationMs != null) {
+            params.set("pmnd", String(Math.max(0, Math.round(ctx.podMinDurationMs))));
+        }
+        if (ctx.podMaxDurationMs != null) {
+            params.set("pmxd", String(Math.max(0, Math.round(ctx.podMaxDurationMs))));
+        }
+        if (ctx.podMaxAds != null) {
+            params.set("pmad", String(Math.max(1, Math.round(ctx.podMaxAds))));
+        }
+    } else if (ctx.adPosition != null) {
         params.set("ppos", String(ctx.adPosition));
     }
     var requestUrl = ctx.contentUrl || ctx.pageUrl;
@@ -4489,6 +4774,7 @@ var AdConfigManager = /*#__PURE__*/ function() {
         this.podAssignedByPrefetch = false;
         this.adRequestPositionInBreak = 0;
         this.lastHeartbeatTime = 0;
+        this.defaultPodMaxAds = 6;
         this.config = config;
         this.video = video;
     }
@@ -4944,6 +5230,52 @@ var AdConfigManager = /*#__PURE__*/ function() {
                 return urls;
             }
         },
+        {
+            key: "resolvePodParams",
+            value: function resolvePodParams(breakDurationMs) {
+                var maxDurationMs = breakDurationMs != null && breakDurationMs > 0 ? breakDurationMs : this.config.podMaxDurationMs;
+                var maxAds = this.config.podMaxAds && this.config.podMaxAds > 0 ? this.config.podMaxAds : this.apiNumberAds && this.apiNumberAds > 0 ? this.apiNumberAds : this.defaultPodMaxAds;
+                var minDurationMs = this.config.podExactDuration && maxDurationMs != null ? maxDurationMs : 0;
+                return {
+                    maxAds: maxAds,
+                    minDurationMs: minDurationMs,
+                    maxDurationMs: maxDurationMs
+                };
+            }
+        },
+        {
+            key: "generatePodVastUrl",
+            value: function generatePodVastUrl(baseUrl, podParams, adPlayer, palNonce, inAdBreak) {
+                var _podParams_maxDurationMs;
+                var adWillPlayMuted = inAdBreak ? adPlayer.getOriginalMutedState() : this.video.muted;
+                var envSignals = resolveVastEnvironmentSignals(!!this.config.ctvAdRequest);
+                var urlWithMacros = applyVastMacros(baseUrl, {
+                    correlator: generateCorrelator(),
+                    streamCorrelator: this.streamCorrelator,
+                    pod: this.podCounter > 0 ? this.podCounter : void 0,
+                    podMaxAds: podParams.maxAds,
+                    podMinDurationMs: podParams.minDurationMs,
+                    podMaxDurationMs: podParams.maxDurationMs,
+                    isCtv: envSignals.isCtv,
+                    contentUrl: envSignals.contentUrl,
+                    pageUrl: !envSignals.isCtv && typeof window !== "undefined" ? window.location.href : void 0,
+                    adWillPlayMuted: adWillPlayMuted,
+                    adWillAutoPlay: !!this.config.autoplay,
+                    appId: envSignals.appId,
+                    appName: envSignals.appName,
+                    sessionId: envSignals.sessionId,
+                    deviceId: envSignals.deviceId,
+                    deviceIdType: envSignals.deviceIdType,
+                    limitAdTracking: envSignals.limitAdTracking,
+                    deviceTypeHint: envSignals.deviceTypeHint,
+                    adTest: this.config.adTest,
+                    consent: this.consentSignals
+                });
+                var finalUrl = palNonce.injectNonce(urlWithMacros);
+                console.log("[StormcloudVideoPlayer] Resolved optimized-pod request URL (pod=".concat(this.podCounter, ", pmad=").concat(podParams.maxAds, ", pmnd=").concat(podParams.minDurationMs, ", pmxd=").concat((_podParams_maxDurationMs = podParams.maxDurationMs) !== null && _podParams_maxDurationMs !== void 0 ? _podParams_maxDurationMs : "?", "):"), finalUrl);
+                return finalUrl;
+            }
+        },
         {
             // --- Tracking ---
             key: "initializeTracking",
@@ -5250,6 +5582,13 @@ var AdTimingService = /*#__PURE__*/ function() {
                 this.lastAdRequestTime = Date.now();
             }
         },
+        {
+            key: "notePodAdStarted",
+            value: function notePodAdStarted() {
+                this.currentAdIndex++;
+                this.totalAdsInBreak = this.currentAdIndex;
+            }
+        },
         {
             key: "getRemainingAdMs",
             value: function getRemainingAdMs() {
@@ -6762,13 +7101,26 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
             }
         },
         {
-            // ───────────────────────────────────────────────────────────────
+            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",
@@ -6926,7 +7278,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:
@@ -6973,6 +7325,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) {
@@ -7014,21 +7386,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);
@@ -7036,12 +7408,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();
@@ -7066,7 +7438,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) {
@@ -7076,22 +7448,22 @@ 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",
@@ -7103,7 +7475,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                 }
                                 if (!!this.timing.ensureLoadedAdFitsBudget(adPlayer1)) return [
                                     3,
-                                    9
+                                    11
                                 ];
                                 this.timing.rejectLoadedAdForDuration(adPlayer1);
                                 this.recreateAdController();
@@ -7112,12 +7484,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) {
@@ -7127,7 +7499,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) {
@@ -7135,40 +7507,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);
@@ -7176,12 +7548,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);
@@ -7194,7 +7566,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) {
@@ -7205,16 +7577,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) {
@@ -7232,13 +7604,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
                                 ];
@@ -8321,6 +8817,9 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
             },
             generateVastUrls: function generateVastUrls(base, count) {
                 return _this.generateVastUrls(base, count);
+            },
+            generatePodVastUrl: function generatePodVastUrl(base, breakDurationMs) {
+                return _this.generatePodVastUrl(base, breakDurationMs);
             }
         }, this.timing, this.preloadPool, this.adConfig, this.cueManager, this.placeholder);
     }
@@ -8353,6 +8852,13 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
                 return this.adConfig.generateVastUrlsWithCorrelators(baseUrl, count, this.adPlayer, this.palNonce, this.adBreak.inAdBreak);
             }
         },
+        {
+            key: "generatePodVastUrl",
+            value: function generatePodVastUrl(baseUrl, breakDurationMs) {
+                var podParams = this.adConfig.resolvePodParams(breakDurationMs);
+                return this.adConfig.generatePodVastUrl(baseUrl, podParams, this.adPlayer, this.palNonce, this.adBreak.inAdBreak);
+            }
+        },
         {
             key: "load",
             value: // ───────────────────────────────────────────────────────────────
@@ -8741,7 +9247,11 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
                 }
                 this.adConfig.beginNewAdPod();
                 this.adConfig.podAssignedByPrefetch = true;
-                var generatedUrls = this.generateVastUrls(baseVastUrl, 1);
+                var optimizedPods = !!this.config.optimizedPods;
+                var breakDurationMs = marker.durationSeconds != null ? marker.durationSeconds * 1e3 : void 0;
+                var generatedUrls = optimizedPods ? [
+                    this.generatePodVastUrl(baseVastUrl, breakDurationMs)
+                ] : this.generateVastUrls(baseVastUrl, 1);
                 this.adBreak.pendingAdBreak = _object_spread_props(_object_spread({
                     marker: marker
                 }, fragmentSn !== void 0 ? {
@@ -8763,7 +9273,13 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
                 }, detectPayload), buildAnalyticsContext(this.config)).catch(function() {});
                 if (this.debug) {
                     console.log("[PREFETCH] Starting ad prefetch for upcoming ad break");
-                    console.log("[PREFETCH] Pre-generated ".concat(generatedUrls.length, " VAST URLs"));
+                    console.log("[PREFETCH] Pre-generated ".concat(generatedUrls.length, " ").concat(optimizedPods ? "pod" : "VAST", " URL(s)"));
+                }
+                if (optimizedPods) {
+                    if (this.debug) {
+                        console.log("[PREFETCH] Optimized pods enabled - skipping single-ad preload pool");
+                    }
+                    return;
                 }
                 this.preloadPool.startPreloadPool(baseVastUrl, generatedUrls.slice(0, 1), false);
             }