stormcloud-video-player 0.8.59 → 0.8.60

package/lib/index.cjs

@@ -798,6 +798,7 @@ var KNOWN_VAST_MACROS = /* @__PURE__ */ new Set([
     "PLAYERSIZE",
     "PLAYERSTATE",
     "PODSEQUENCE",
+    "REASON",
     "REGULATIONS",
     "SERVERSIDE",
     "SERVERUA",
@@ -856,6 +857,10 @@ function resolveMacroValues(ctx) {
     if (ctx.podSequence != null) {
         set("PODSEQUENCE", String(ctx.podSequence));
     }
+    set("ADSERVINGID", ctx.adServingId);
+    if (ctx.reason != null && ctx.reason !== "") {
+        set("REASON", String(ctx.reason));
+    }
     return values;
 }
 function substituteVastTrackingMacros(url) {
@@ -872,10 +877,72 @@ function substituteVastTrackingMacros(url) {
     });
 }
 // src/sdk/hlsAdPlayer.ts
+var LINEAR_TRACKING_EVENTS = [
+    "creativeView",
+    "loaded",
+    "start",
+    "firstQuartile",
+    "midpoint",
+    "thirdQuartile",
+    "complete",
+    "mute",
+    "unmute",
+    "pause",
+    "resume",
+    "fullscreen",
+    "exitFullscreen",
+    "playerExpand",
+    "playerCollapse",
+    "notUsed"
+];
+function textOf(el) {
+    var _el_textContent;
+    var value = el === null || el === void 0 ? void 0 : (_el_textContent = el.textContent) === null || _el_textContent === void 0 ? void 0 : _el_textContent.trim();
+    return value ? value : void 0;
+}
+function parseVastTime(value) {
+    if (!value) return void 0;
+    var parts = value.trim().split(":");
+    if (parts.length !== 3) return void 0;
+    var _parts_map = _sliced_to_array(parts.map(function(p) {
+        return parseFloat(p);
+    }), 3), h = _parts_map[0], m = _parts_map[1], s = _parts_map[2];
+    if (![
+        h,
+        m,
+        s
+    ].every(function(n) {
+        return n !== void 0 && Number.isFinite(n);
+    })) {
+        return void 0;
+    }
+    return h * 3600 + m * 60 + s;
+}
+function parseProgressOffset(offset) {
+    if (!offset) return void 0;
+    var trimmed = offset.trim();
+    if (trimmed.endsWith("%")) {
+        var percent = parseFloat(trimmed);
+        return Number.isFinite(percent) ? {
+            offsetPercent: percent
+        } : void 0;
+    }
+    var seconds = parseVastTime(trimmed);
+    return seconds !== void 0 ? {
+        offsetSeconds: seconds
+    } : void 0;
+}
 var MAX_VAST_WRAPPER_DEPTH = 5;
 var BEACON_TIMEOUT_MS = 3e4;
 var inFlightBeacons = /* @__PURE__ */ new Set();
 var VAST_ERROR_MEDIA_DISPLAY = 405;
+var VAST_ERROR_WRAPPER_TIMEOUT = 301;
+var VAST_ERROR_WRAPPER_LIMIT = 302;
+var VAST_ERROR_WRAPPER_NO_ADS = 303;
+var VAST_ERROR_NO_SUPPORTED_MEDIA = 403;
+var VERIFICATION_NOT_SUPPORTED_REASON = 2;
+var VIEWABLE_MIN_VISIBLE_RATIO = 0.5;
+var VIEWABLE_MIN_CONTINUOUS_S = 2;
 function toVastMediaErrorCode(error) {
     switch(error === null || error === void 0 ? void 0 : error.code){
         case 1:
@@ -903,6 +970,7 @@ function createHlsAdPlayer(contentVideo, options) {
     var adHls;
     var adContainerEl = (_contentVideo_AD_CONTAINER_PROP = contentVideo[AD_CONTAINER_PROP]) !== null && _contentVideo_AD_CONTAINER_PROP !== void 0 ? _contentVideo_AD_CONTAINER_PROP : void 0;
     var adEventHandlers = [];
+    var containerHandlers = [];
     var currentAd;
     var currentAdMediaFile;
     var podAds = [];
@@ -920,14 +988,28 @@ function createHlsAdPlayer(contentVideo, options) {
     var sawDecodedVideoFrame = false;
     var videoFrameCallbackHandle;
     var pendingPlayPromise;
-    var trackingFired = {
-        impression: false,
-        start: false,
-        firstQuartile: false,
-        midpoint: false,
-        thirdQuartile: false,
-        complete: false
-    };
+    function createTrackingState() {
+        return {
+            impression: false,
+            loaded: false,
+            start: false,
+            firstQuartile: false,
+            midpoint: false,
+            thirdQuartile: false,
+            complete: false,
+            viewabilitySettled: false,
+            lastMuted: void 0,
+            progressFired: /* @__PURE__ */ new Set()
+        };
+    }
+    var trackingFired = createTrackingState();
+    var resolvedAds = /* @__PURE__ */ new Set();
+    var viewObserver;
+    var visibleRatio = 0;
+    var continuousVisibleS = 0;
+    var lastViewSampleTime;
+    var lastPlayerExpanded = false;
+    var documentHandlers = [];
     function emit(event, payload) {
         var set = listeners.get(event);
         if (!set) return;
@@ -956,7 +1038,11 @@ function createHlsAdPlayer(contentVideo, options) {
             }
         }
     }
-    function buildTrackingMacroContext(errorCode) {
+    function buildTrackingMacroContext() {
+        var options2 = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
+        var _options2_ad;
+        var errorCode = options2.errorCode, reason = options2.reason;
+        var ad = (_options2_ad = options2.ad) !== null && _options2_ad !== void 0 ? _options2_ad : currentAd;
         var context = {
             adPlayheadSeconds: adVideoElement === null || adVideoElement === void 0 ? void 0 : adVideoElement.currentTime,
             contentPlayheadSeconds: contentVideo.currentTime,
@@ -977,11 +1063,17 @@ function createHlsAdPlayer(contentVideo, options) {
         if (podAds.length > 0) {
             context.podSequence = podIndex + 1;
         }
+        if (ad === null || ad === void 0 ? void 0 : ad.adServingId) {
+            context.adServingId = ad.adServingId;
+        }
+        if (reason != null) {
+            context.reason = reason;
+        }
         return context;
     }
     function fireTrackingPixels(urls, options2) {
         if (!urls || urls.length === 0) return;
-        var macroContext = buildTrackingMacroContext(options2 === null || options2 === void 0 ? void 0 : options2.errorCode);
+        var macroContext = buildTrackingMacroContext(options2);
         urls.forEach(function(url) {
             try {
                 var trackingUrl = substituteVastTrackingMacros(url, macroContext);
@@ -1092,8 +1184,8 @@ function createHlsAdPlayer(contentVideo, options) {
         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");
+    function collectVideoMediaFiles(linear, verbose) {
+        var mediaFileElements = linear.querySelectorAll(":scope > MediaFiles > MediaFile");
         var mediaFiles = [];
         if (verbose) {
             console.log("[HlsAdPlayer] Found ".concat(mediaFileElements.length, " MediaFile element(s) in VAST XML"));
@@ -1113,6 +1205,13 @@ function createHlsAdPlayer(contentVideo, options) {
                 }
                 return;
             }
+            var apiFramework = (mf.getAttribute("apiFramework") || "").toUpperCase();
+            if (apiFramework === "VPAID") {
+                if (verbose) {
+                    console.log("[HlsAdPlayer] MediaFile ".concat(index, " ignored (VPAID creatives are not supported)"));
+                }
+                return;
+            }
             var bitrateAttr = mf.getAttribute("bitrate");
             var bitrateValue = bitrateAttr ? parseInt(bitrateAttr, 10) : void 0;
             var mediaFile = {
@@ -1143,114 +1242,144 @@ function createHlsAdPlayer(contentVideo, options) {
         return mediaFiles;
     }
     function createEmptyTrackingUrls() {
-        return {
+        var urls = {
             impression: [],
-            start: [],
-            firstQuartile: [],
-            midpoint: [],
-            thirdQuartile: [],
-            complete: [],
-            mute: [],
-            unmute: [],
-            pause: [],
-            resume: [],
-            fullscreen: [],
-            exitFullscreen: [],
-            skip: [],
-            error: []
+            clickTracking: [],
+            error: [],
+            viewable: [],
+            notViewable: [],
+            viewUndetermined: [],
+            verificationNotExecuted: [],
+            progress: []
         };
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            for(var _iterator = LINEAR_TRACKING_EVENTS[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                var event = _step.value;
+                urls[event] = [];
+            }
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
+            }
+        }
+        return urls;
     }
-    function extractTrackingUrls(scope) {
-        var trackingUrls = createEmptyTrackingUrls();
-        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);
+    function pushUrls(target, elements) {
+        elements.forEach(function(el) {
+            var url = textOf(el);
+            if (url) target.push(url);
         });
-        scope.querySelectorAll("Tracking").forEach(function(el) {
-            var _el_textContent;
+    }
+    function collectLinearTracking(linear, into) {
+        linear.querySelectorAll(":scope > TrackingEvents > Tracking").forEach(function(el) {
             var event = el.getAttribute("event");
-            var url = (_el_textContent = el.textContent) === null || _el_textContent === void 0 ? void 0 : _el_textContent.trim();
-            if (event && url) {
-                var eventKey = event;
-                if (trackingUrls[eventKey]) {
-                    trackingUrls[eventKey].push(url);
-                }
+            var url = textOf(el);
+            if (!event || !url) return;
+            if (event === "progress") {
+                var offset = parseProgressOffset(el.getAttribute("offset"));
+                if (offset) into.progress.push(_object_spread({
+                    url: url
+                }, offset));
+                return;
+            }
+            if (LINEAR_TRACKING_EVENTS.indexOf(event) !== -1) {
+                into[event].push(url);
             }
         });
-        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);
+        pushUrls(into.clickTracking, linear.querySelectorAll(":scope > VideoClicks > ClickTracking"));
+    }
+    function collectAdLevelTracking(adBody, into) {
+        pushUrls(into.impression, adBody.querySelectorAll(":scope > Impression"));
+        pushUrls(into.error, adBody.querySelectorAll(":scope > Error"));
+        pushUrls(into.viewable, adBody.querySelectorAll(":scope > ViewableImpression > Viewable"));
+        pushUrls(into.notViewable, adBody.querySelectorAll(":scope > ViewableImpression > NotViewable"));
+        pushUrls(into.viewUndetermined, adBody.querySelectorAll(":scope > ViewableImpression > ViewUndetermined"));
+        adBody.querySelectorAll(':scope > AdVerifications > Verification, :scope > Extensions > Extension[type="AdVerifications"] > AdVerifications > Verification').forEach(function(verification) {
+            pushUrls(into.verificationNotExecuted, verification.querySelectorAll(':scope > TrackingEvents > Tracking[event="verificationNotExecuted"]'));
         });
-        return trackingUrls;
     }
     function mergeTrackingUrls(target, source) {
-        Object.keys(target).forEach(function(key) {
-            if (source[key] && source[key].length > 0) {
-                target[key] = target[key].concat(source[key]);
+        var targetLists = target;
+        var sourceLists = source;
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            for(var _iterator = Object.keys(targetLists)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                var key = _step.value;
+                var incoming = sourceLists[key];
+                if (incoming && incoming.length > 0) {
+                    targetLists[key] = targetLists[key].concat(incoming);
+                }
             }
-        });
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
+            }
+        }
         return target;
     }
+    function parseXml(xmlString) {
+        var xmlDoc = new DOMParser().parseFromString(xmlString, "text/xml");
+        var parserError = xmlDoc.querySelector("parsererror");
+        if (parserError) {
+            console.error("[HlsAdPlayer] XML parsing error (malformed VAST XML):", parserError.textContent);
+            return null;
+        }
+        return xmlDoc;
+    }
+    function getAdSequence(adElement) {
+        var sequence = parseInt(adElement.getAttribute("sequence") || "", 10);
+        return Number.isFinite(sequence) ? sequence : void 0;
+    }
+    function emptyVastResult(root) {
+        var errorUrls = [];
+        pushUrls(errorUrls, root.querySelectorAll(":scope > Error"));
+        return {
+            type: "empty",
+            errorUrls: errorUrls,
+            errorCode: VAST_ERROR_WRAPPER_NO_ADS
+        };
+    }
     function parseVastXml(xmlString) {
         try {
-            var _xmlDoc_querySelector, _xmlDoc_querySelector_textContent, _xmlDoc_querySelector1, _xmlDoc_querySelector_textContent1, _xmlDoc_querySelector2, _xmlDoc_querySelector3;
-            var parser = new DOMParser();
-            var xmlDoc = parser.parseFromString(xmlString, "text/xml");
-            var parserError = xmlDoc.querySelector("parsererror");
-            if (parserError) {
-                console.error("[HlsAdPlayer] XML parsing error (malformed VAST XML):", parserError.textContent);
-                return {
-                    type: "empty"
-                };
-            }
-            var adElement = xmlDoc.querySelector("Ad");
+            var _adElements_find;
+            var xmlDoc = parseXml(xmlString);
+            if (!xmlDoc) return {
+                type: "empty"
+            };
+            var root = xmlDoc.documentElement;
+            var adElements = Array.from(root.querySelectorAll(":scope > Ad"));
+            var adElement = (_adElements_find = adElements.find(function(el) {
+                return getAdSequence(el) === void 0;
+            })) !== null && _adElements_find !== void 0 ? _adElements_find : adElements[0];
             if (!adElement) {
-                console.warn("[HlsAdPlayer] No Ad element found in VAST XML");
-                return {
-                    type: "empty"
-                };
+                var _root_getAttribute;
+                console.warn("[HlsAdPlayer] No Ad element found in VAST ".concat((_root_getAttribute = root.getAttribute("version")) !== null && _root_getAttribute !== void 0 ? _root_getAttribute : "", " response"));
+                return emptyVastResult(root);
             }
-            var adId = adElement.getAttribute("id") || "unknown";
-            var title = ((_xmlDoc_querySelector = xmlDoc.querySelector("AdTitle")) === null || _xmlDoc_querySelector === void 0 ? void 0 : _xmlDoc_querySelector.textContent) || "Ad";
-            var clickThrough = (_xmlDoc_querySelector1 = xmlDoc.querySelector("ClickThrough")) === null || _xmlDoc_querySelector1 === void 0 ? void 0 : (_xmlDoc_querySelector_textContent = _xmlDoc_querySelector1.textContent) === null || _xmlDoc_querySelector_textContent === void 0 ? void 0 : _xmlDoc_querySelector_textContent.trim();
-            var wrapperUri = (_xmlDoc_querySelector2 = xmlDoc.querySelector("VASTAdTagURI")) === null || _xmlDoc_querySelector2 === void 0 ? void 0 : (_xmlDoc_querySelector_textContent1 = _xmlDoc_querySelector2.textContent) === null || _xmlDoc_querySelector_textContent1 === void 0 ? void 0 : _xmlDoc_querySelector_textContent1.trim();
-            if (wrapperUri) {
-                console.log("[HlsAdPlayer] VAST wrapper detected, following VASTAdTagURI: ".concat(wrapperUri));
-                return {
-                    type: "wrapper",
-                    vastAdTagUri: wrapperUri,
-                    trackingUrls: extractTrackingUrls(xmlDoc),
-                    clickThrough: clickThrough
-                };
+            var parsed = parseAdElement(adElement, true);
+            if (parsed.type === "wrapper") {
+                console.log("[HlsAdPlayer] VAST wrapper detected, following VASTAdTagURI: ".concat(parsed.vastAdTagUri));
             }
-            var isNoAdAvailable = adId === "empty" || title.toLowerCase().includes("no ad available") || title.toLowerCase() === "no ad available";
-            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 mediaFiles = collectVideoMediaFiles(xmlDoc, true);
-            if (mediaFiles.length === 0) {
-                if (isNoAdAvailable) {
-                    console.warn("[HlsAdPlayer] No ads available (VAST response indicates no ads)");
-                } else {
-                    console.warn("[HlsAdPlayer] No supported media files found in VAST XML");
-                }
-                return {
-                    type: "empty"
-                };
-            }
-            return {
-                type: "inline",
-                ad: {
-                    id: adId,
-                    title: title,
-                    duration: duration,
-                    mediaFiles: mediaFiles,
-                    trackingUrls: extractTrackingUrls(xmlDoc),
-                    clickThrough: clickThrough
-                }
-            };
+            return parsed;
         } catch (error) {
             console.error("[HlsAdPlayer] Error parsing VAST XML:", error);
             return {
@@ -1259,48 +1388,101 @@ function createHlsAdPlayer(contentVideo, options) {
         }
     }
     function parseAdElement(adElement) {
+        var verbose = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : false;
         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) {
+            var _parseVastTime;
+            var wrapper = adElement.querySelector(":scope > Wrapper");
+            if (wrapper) {
+                var vastAdTagUri = textOf(wrapper.querySelector(":scope > VASTAdTagURI"));
+                if (!vastAdTagUri) {
+                    console.warn("[HlsAdPlayer] <Wrapper> has no VASTAdTagURI");
+                    return {
+                        type: "empty"
+                    };
+                }
+                var trackingUrls2 = createEmptyTrackingUrls();
+                collectAdLevelTracking(wrapper, trackingUrls2);
+                wrapper.querySelectorAll(":scope > Creatives > Creative > Linear").forEach(function(linear2) {
+                    return collectLinearTracking(linear2, trackingUrls2);
+                });
                 return {
                     type: "wrapper",
-                    vastAdTagUri: wrapperUri,
-                    trackingUrls: extractTrackingUrls(adElement),
-                    clickThrough: clickThrough
+                    vastAdTagUri: vastAdTagUri,
+                    trackingUrls: trackingUrls2,
+                    rules: {
+                        followAdditionalWrappers: wrapper.getAttribute("followAdditionalWrappers") !== "false"
+                    }
                 };
             }
-            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 mediaFiles = collectVideoMediaFiles(adElement, false);
-            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>");
-                }
+            var inLine = adElement.querySelector(":scope > InLine");
+            if (!inLine) {
+                console.warn("[HlsAdPlayer] <Ad> has neither <InLine> nor <Wrapper>");
                 return {
                     type: "empty"
                 };
             }
+            var errorUrls = [];
+            pushUrls(errorUrls, inLine.querySelectorAll(":scope > Error"));
+            if (adElement.getAttribute("conditionalAd") === "true") {
+                console.warn("[HlsAdPlayer] Skipping conditional <Ad> (VPAID-only)");
+                return {
+                    type: "empty",
+                    errorUrls: errorUrls,
+                    errorCode: VAST_ERROR_NO_SUPPORTED_MEDIA
+                };
+            }
+            var linear;
+            var mediaFiles = [];
+            var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+            try {
+                for(var _iterator = Array.from(inLine.querySelectorAll(":scope > Creatives > Creative > Linear"))[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                    var candidate = _step.value;
+                    var files = collectVideoMediaFiles(candidate, verbose);
+                    if (files.length > 0) {
+                        linear = candidate;
+                        mediaFiles = files;
+                        break;
+                    }
+                }
+            } catch (err) {
+                _didIteratorError = true;
+                _iteratorError = err;
+            } finally{
+                try {
+                    if (!_iteratorNormalCompletion && _iterator.return != null) {
+                        _iterator.return();
+                    }
+                } finally{
+                    if (_didIteratorError) {
+                        throw _iteratorError;
+                    }
+                }
+            }
+            if (!linear) {
+                console.warn("[HlsAdPlayer] No supported linear media files in <Ad>");
+                return {
+                    type: "empty",
+                    errorUrls: errorUrls,
+                    errorCode: VAST_ERROR_NO_SUPPORTED_MEDIA
+                };
+            }
+            var trackingUrls = createEmptyTrackingUrls();
+            collectAdLevelTracking(inLine, trackingUrls);
+            collectLinearTracking(linear, trackingUrls);
             return {
                 type: "inline",
                 ad: {
-                    id: adId,
-                    title: title,
-                    duration: duration,
+                    id: adElement.getAttribute("id") || "unknown",
+                    title: textOf(inLine.querySelector(":scope > AdTitle")) || "Ad",
+                    duration: (_parseVastTime = parseVastTime(textOf(linear.querySelector(":scope > Duration")))) !== null && _parseVastTime !== void 0 ? _parseVastTime : 30,
                     mediaFiles: mediaFiles,
-                    trackingUrls: extractTrackingUrls(adElement),
-                    clickThrough: clickThrough
+                    trackingUrls: trackingUrls,
+                    clickThrough: textOf(linear.querySelector(":scope > VideoClicks > ClickThrough")),
+                    adServingId: textOf(inLine.querySelector(":scope > AdServingId"))
                 }
             };
         } catch (error) {
-            console.error("[HlsAdPlayer] Error parsing pod <Ad> element:", error);
+            console.error("[HlsAdPlayer] Error parsing <Ad> element:", error);
             return {
                 type: "empty"
             };
@@ -1379,30 +1561,63 @@ function createHlsAdPlayer(contentVideo, options) {
     }
     function fetchAndParseVastAd(_0) {
         return _async_to_generator(function(vastTagUrl) {
-            var depth, accumulatedTracking, vastXml, parsed;
+            var depth, accumulatedTracking, rules, vastXml, error, parsed, _parsed_errorUrls, _parsed_errorCode;
             var _arguments = arguments;
             return _ts_generator(this, function(_state) {
                 switch(_state.label){
                     case 0:
-                        depth = _arguments.length > 1 && _arguments[1] !== void 0 ? _arguments[1] : 0, accumulatedTracking = _arguments.length > 2 && _arguments[2] !== void 0 ? _arguments[2] : createEmptyTrackingUrls();
+                        depth = _arguments.length > 1 && _arguments[1] !== void 0 ? _arguments[1] : 0, accumulatedTracking = _arguments.length > 2 && _arguments[2] !== void 0 ? _arguments[2] : createEmptyTrackingUrls(), rules = _arguments.length > 3 && _arguments[3] !== void 0 ? _arguments[3] : {
+                            followAdditionalWrappers: true
+                        };
+                        _state.label = 1;
+                    case 1:
+                        _state.trys.push([
+                            1,
+                            3,
+                            ,
+                            4
+                        ]);
                         return [
                             4,
                             fetchVastXml(vastTagUrl, depth === 0 ? "include" : "omit")
                         ];
-                    case 1:
+                    case 2:
                         vastXml = _state.sent();
+                        return [
+                            3,
+                            4
+                        ];
+                    case 3:
+                        error = _state.sent();
+                        if (depth === 0) throw error;
+                        console.warn("[HlsAdPlayer] Wrapped VAST request failed:", error);
+                        fireTrackingPixels(accumulatedTracking.error, {
+                            errorCode: VAST_ERROR_WRAPPER_TIMEOUT
+                        });
+                        return [
+                            2,
+                            null
+                        ];
+                    case 4:
                         console.log("[HlsAdPlayer] VAST XML received");
                         console.log("[HlsAdPlayer] VAST XML content (first 2000 chars):", vastXml.substring(0, 2e3));
                         parsed = parseVastXml(vastXml);
                         if (parsed.type === "empty") {
+                            ;
+                            fireTrackingPixels(((_parsed_errorUrls = parsed.errorUrls) !== null && _parsed_errorUrls !== void 0 ? _parsed_errorUrls : []).concat(accumulatedTracking.error), {
+                                errorCode: (_parsed_errorCode = parsed.errorCode) !== null && _parsed_errorCode !== void 0 ? _parsed_errorCode : VAST_ERROR_WRAPPER_NO_ADS
+                            });
                             return [
                                 2,
                                 null
                             ];
                         }
                         if (parsed.type === "wrapper") {
-                            if (depth >= MAX_VAST_WRAPPER_DEPTH) {
-                                console.warn("[HlsAdPlayer] VAST wrapper depth limit (".concat(MAX_VAST_WRAPPER_DEPTH, ") reached, aborting redirect chain"));
+                            if (depth >= MAX_VAST_WRAPPER_DEPTH || !rules.followAdditionalWrappers) {
+                                console.warn(rules.followAdditionalWrappers ? "[HlsAdPlayer] VAST wrapper depth limit (".concat(MAX_VAST_WRAPPER_DEPTH, ") reached, aborting redirect chain") : '[HlsAdPlayer] Parent wrapper set followAdditionalWrappers="false"; rejecting nested wrapper');
+                                fireTrackingPixels(accumulatedTracking.error.concat(parsed.trackingUrls.error), {
+                                    errorCode: VAST_ERROR_WRAPPER_LIMIT
+                                });
                                 return [
                                     2,
                                     null
@@ -1411,7 +1626,7 @@ function createHlsAdPlayer(contentVideo, options) {
                             mergeTrackingUrls(accumulatedTracking, parsed.trackingUrls);
                             return [
                                 2,
-                                fetchAndParseVastAd(parsed.vastAdTagUri, depth + 1, accumulatedTracking)
+                                fetchAndParseVastAd(parsed.vastAdTagUri, depth + 1, accumulatedTracking, parsed.rules)
                             ];
                         }
                         mergeTrackingUrls(parsed.ad.trackingUrls, accumulatedTracking);
@@ -1425,7 +1640,7 @@ function createHlsAdPlayer(contentVideo, options) {
     }
     function fetchAndParsePod(vastTagUrl) {
         return _async_to_generator(function() {
-            var vastXml, trimmedXml, parser, xmlDoc, adElements, ads, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, adElement, parsed, resolved, error, err;
+            var _root_getAttribute, vastXml, trimmedXml, xmlDoc, root, adElements, _root_getAttribute1, _empty_errorUrls, empty, _empty_errorCode, resolveAd, podElements, buffet, ads, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, adElement, ad, err, _iteratorNormalCompletion1, _didIteratorError1, _iteratorError1, _iterator1, _step1, adElement1, ad1, err;
             return _ts_generator(this, function(_state) {
                 switch(_state.label){
                     case 0:
@@ -1444,125 +1659,212 @@ function createHlsAdPlayer(contentVideo, options) {
                                 []
                             ];
                         }
-                        parser = new DOMParser();
-                        xmlDoc = parser.parseFromString(vastXml, "text/xml");
-                        if (xmlDoc.querySelector("parsererror")) {
-                            console.error("[HlsAdPlayer] Pod VAST XML parsing error (malformed). Content (first 2000 chars):", vastXml.substring(0, 2e3));
+                        xmlDoc = parseXml(vastXml);
+                        if (!xmlDoc) {
+                            console.error("[HlsAdPlayer] Pod VAST XML content (first 2000 chars):", vastXml.substring(0, 2e3));
                             return [
                                 2,
                                 []
                             ];
                         }
-                        adElements = Array.from(xmlDoc.querySelectorAll("Ad"));
+                        root = xmlDoc.documentElement;
+                        adElements = Array.from(root.querySelectorAll(":scope > Ad"));
                         if (adElements.length === 0) {
-                            console.warn("[HlsAdPlayer] No <Ad> elements found in pod VAST response (no fill). Content (first 2000 chars):", vastXml.substring(0, 2e3));
+                            ;
+                            ;
+                            console.warn("[HlsAdPlayer] No <Ad> elements in VAST ".concat((_root_getAttribute1 = root.getAttribute("version")) !== null && _root_getAttribute1 !== void 0 ? _root_getAttribute1 : "", " pod response (no fill)"));
+                            empty = emptyVastResult(root);
+                            if (empty.type === "empty" && ((_empty_errorUrls = empty.errorUrls) === null || _empty_errorUrls === void 0 ? void 0 : _empty_errorUrls.length)) {
+                                ;
+                                fireTrackingPixels(empty.errorUrls, {
+                                    errorCode: (_empty_errorCode = empty.errorCode) !== null && _empty_errorCode !== void 0 ? _empty_errorCode : VAST_ERROR_WRAPPER_NO_ADS
+                                });
+                            }
                             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;
+                        resolveAd = function resolveAd(adElement) {
+                            return _async_to_generator(function() {
+                                var _parsed_errorUrls, parsed, _parsed_errorCode;
+                                return _ts_generator(this, function(_state) {
+                                    parsed = parseAdElement(adElement);
+                                    if (parsed.type === "inline") return [
+                                        2,
+                                        parsed.ad
+                                    ];
+                                    if (parsed.type === "wrapper") {
+                                        return [
+                                            2,
+                                            fetchAndParseVastAd(parsed.vastAdTagUri, 1, parsed.trackingUrls, parsed.rules)
+                                        ];
+                                    }
+                                    if ((_parsed_errorUrls = parsed.errorUrls) === null || _parsed_errorUrls === void 0 ? void 0 : _parsed_errorUrls.length) {
+                                        ;
+                                        fireTrackingPixels(parsed.errorUrls, {
+                                            errorCode: (_parsed_errorCode = parsed.errorCode) !== null && _parsed_errorCode !== void 0 ? _parsed_errorCode : VAST_ERROR_NO_SUPPORTED_MEDIA
+                                        });
+                                    }
+                                    return [
+                                        2,
+                                        null
+                                    ];
+                                });
+                            })();
+                        };
+                        podElements = adElements.filter(function(el) {
+                            return getAdSequence(el) !== void 0;
+                        }).sort(function(a, b) {
+                            return getAdSequence(a) - getAdSequence(b);
+                        });
+                        buffet = adElements.filter(function(el) {
+                            return getAdSequence(el) === void 0;
                         });
                         ads = [];
+                        if (!(podElements.length === 0)) return [
+                            3,
+                            10
+                        ];
                         _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
                         _state.label = 2;
                     case 2:
                         _state.trys.push([
                             2,
-                            10,
-                            11,
-                            12
+                            7,
+                            8,
+                            9
                         ]);
-                        _iterator = adElements[Symbol.iterator]();
+                        _iterator = buffet[Symbol.iterator]();
                         _state.label = 3;
                     case 3:
                         if (!!(_iteratorNormalCompletion = (_step = _iterator.next()).done)) return [
                             3,
-                            9
+                            6
                         ];
                         adElement = _step.value;
-                        parsed = parseAdElement(adElement);
-                        if (!(parsed.type === "inline")) return [
-                            3,
-                            4
-                        ];
-                        ads.push(parsed.ad);
                         return [
-                            3,
-                            8
+                            4,
+                            resolveAd(adElement)
                         ];
                     case 4:
-                        if (!(parsed.type === "wrapper")) return [
-                            3,
-                            8
-                        ];
+                        ad = _state.sent();
+                        if (ad) ads.push(ad);
                         _state.label = 5;
                     case 5:
-                        _state.trys.push([
-                            5,
-                            7,
-                            ,
-                            8
-                        ]);
+                        _iteratorNormalCompletion = true;
                         return [
-                            4,
-                            fetchAndParseVastAd(parsed.vastAdTagUri, 1, parsed.trackingUrls)
+                            3,
+                            3
                         ];
                     case 6:
-                        resolved = _state.sent();
-                        if (resolved) {
-                            ads.push(resolved);
-                        }
                         return [
                             3,
-                            8
+                            9
                         ];
                     case 7:
-                        error = _state.sent();
-                        console.warn("[HlsAdPlayer] Failed to resolve wrapper <Ad> in pod:", error);
+                        err = _state.sent();
+                        _didIteratorError = true;
+                        _iteratorError = err;
                         return [
                             3,
-                            8
+                            9
                         ];
                     case 8:
-                        _iteratorNormalCompletion = true;
+                        try {
+                            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                _iterator.return();
+                            }
+                        } finally{
+                            if (_didIteratorError) {
+                                throw _iteratorError;
+                            }
+                        }
                         return [
-                            3,
-                            3
+                            7
                         ];
                     case 9:
                         return [
                             3,
-                            12
+                            21
                         ];
                     case 10:
-                        err = _state.sent();
-                        _didIteratorError = true;
-                        _iteratorError = err;
+                        _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+                        _state.label = 11;
+                    case 11:
+                        _state.trys.push([
+                            11,
+                            19,
+                            20,
+                            21
+                        ]);
+                        _iterator1 = podElements[Symbol.iterator]();
+                        _state.label = 12;
+                    case 12:
+                        if (!!(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done)) return [
+                            3,
+                            18
+                        ];
+                        adElement1 = _step1.value;
+                        return [
+                            4,
+                            resolveAd(adElement1)
+                        ];
+                    case 13:
+                        ad1 = _state.sent();
+                        _state.label = 14;
+                    case 14:
+                        if (!(!ad1 && buffet.length > 0)) return [
+                            3,
+                            16
+                        ];
+                        return [
+                            4,
+                            resolveAd(buffet.shift())
+                        ];
+                    case 15:
+                        ad1 = _state.sent();
+                        return [
+                            3,
+                            14
+                        ];
+                    case 16:
+                        if (ad1) ads.push(ad1);
+                        _state.label = 17;
+                    case 17:
+                        _iteratorNormalCompletion1 = true;
                         return [
                             3,
                             12
                         ];
-                    case 11:
+                    case 18:
+                        return [
+                            3,
+                            21
+                        ];
+                    case 19:
+                        err = _state.sent();
+                        _didIteratorError1 = true;
+                        _iteratorError1 = err;
+                        return [
+                            3,
+                            21
+                        ];
+                    case 20:
                         try {
-                            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                                _iterator.return();
+                            if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                                _iterator1.return();
                             }
                         } finally{
-                            if (_didIteratorError) {
-                                throw _iteratorError;
+                            if (_didIteratorError1) {
+                                throw _iteratorError1;
                             }
                         }
                         return [
                             7
                         ];
-                    case 12:
-                        console.log("[HlsAdPlayer] Parsed ".concat(ads.length, " ad(s) from pod VAST response"));
+                    case 21:
+                        console.log("[HlsAdPlayer] Parsed ".concat(ads.length, " ad(s) from VAST ").concat((_root_getAttribute = root.getAttribute("version")) !== null && _root_getAttribute !== void 0 ? _root_getAttribute : "", " pod response"));
                         return [
                             2,
                             ads
@@ -1592,7 +1894,40 @@ function createHlsAdPlayer(contentVideo, options) {
         var onTimeUpdate = function onTimeUpdate() {
             if (!currentAd || !adVideoElement) return;
             noteAdProgress();
-            var progress = adVideoElement.currentTime / currentAd.duration;
+            sampleViewability();
+            var currentTime = adVideoElement.currentTime;
+            if (trackingFired.start) {
+                var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                try {
+                    for(var _iterator = currentAd.trackingUrls.progress[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                        var event = _step.value;
+                        var _event_offsetSeconds, _event_offsetPercent;
+                        if (trackingFired.progressFired.has(event)) continue;
+                        var threshold = (_event_offsetSeconds = event.offsetSeconds) !== null && _event_offsetSeconds !== void 0 ? _event_offsetSeconds : ((_event_offsetPercent = event.offsetPercent) !== null && _event_offsetPercent !== void 0 ? _event_offsetPercent : 0) / 100 * currentAd.duration;
+                        if (currentTime >= threshold) {
+                            trackingFired.progressFired.add(event);
+                            fireTrackingPixels([
+                                event.url
+                            ]);
+                        }
+                    }
+                } catch (err) {
+                    _didIteratorError = true;
+                    _iteratorError = err;
+                } finally{
+                    try {
+                        if (!_iteratorNormalCompletion && _iterator.return != null) {
+                            _iterator.return();
+                        }
+                    } finally{
+                        if (_didIteratorError) {
+                            throw _iteratorError;
+                        }
+                    }
+                }
+            }
+            if (!(currentAd.duration > 0)) return;
+            var progress = currentTime / currentAd.duration;
             if (progress >= 0.25 && !trackingFired.firstQuartile) {
                 trackingFired.firstQuartile = true;
                 fireTrackingPixels(currentAd.trackingUrls.firstQuartile);
@@ -1614,15 +1949,38 @@ function createHlsAdPlayer(contentVideo, options) {
                 handleVideoDecodeFailure();
             }
         };
+        var onCanPlay = function onCanPlay() {
+            if (!currentAd || trackingFired.loaded) return;
+            trackingFired.loaded = true;
+            fireTrackingPixels(currentAd.trackingUrls.loaded);
+        };
         var onPlaying = function onPlaying() {
             startStallWatchdog();
-            if (!currentAd || trackingFired.start) return;
+            if (!currentAd || !adVideoElement) return;
+            if (!trackingFired.impression) {
+                trackingFired.impression = true;
+                resolvedAds.add(currentAd);
+                fireTrackingPixels(currentAd.trackingUrls.impression);
+                fireTrackingPixels(currentAd.trackingUrls.creativeView);
+                fireTrackingPixels(currentAd.trackingUrls.verificationNotExecuted, {
+                    reason: VERIFICATION_NOT_SUPPORTED_REASON
+                });
+                emit("ad_impression", {
+                    adId: currentAd.id,
+                    index: podIndex,
+                    total: podAds.length || 1
+                });
+            }
+            if (trackingFired.start) return;
             trackingFired.start = true;
+            trackingFired.lastMuted = adVideoElement.muted || adVideoElement.volume === 0;
             fireTrackingPixels(currentAd.trackingUrls.start);
             console.log("[HlsAdPlayer] Ad started playing");
         };
         var onEnded = function onEnded() {
             if (!currentAd || trackingFired.complete) return;
+            sampleViewability();
+            settleViewability();
             trackingFired.complete = true;
             fireTrackingPixels(currentAd.trackingUrls.complete);
             console.log("[HlsAdPlayer] Ad completed");
@@ -1634,11 +1992,7 @@ function createHlsAdPlayer(contentVideo, options) {
         var onError = function onError(e) {
             if (!adPlaying) return;
             console.error("[HlsAdPlayer] Ad video error:", e);
-            if (currentAd) {
-                fireTrackingPixels(currentAd.trackingUrls.error, {
-                    errorCode: toVastMediaErrorCode(adVideoElement === null || adVideoElement === void 0 ? void 0 : adVideoElement.error)
-                });
-            }
+            reportCurrentAdError(toVastMediaErrorCode(adVideoElement === null || adVideoElement === void 0 ? void 0 : adVideoElement.error));
             if (podIndex < podAds.length - 1 && advanceToNextPodAd()) {
                 return;
             }
@@ -1646,19 +2000,26 @@ function createHlsAdPlayer(contentVideo, options) {
         };
         var onVolumeChange = function onVolumeChange() {
             if (!currentAd || !adVideoElement) return;
-            if (adVideoElement.muted) {
-                fireTrackingPixels(currentAd.trackingUrls.mute);
-            } else {
-                fireTrackingPixels(currentAd.trackingUrls.unmute);
+            var muted = adVideoElement.muted || adVideoElement.volume === 0;
+            if (!trackingFired.start) {
+                trackingFired.lastMuted = muted;
+                return;
             }
+            if (muted === trackingFired.lastMuted) return;
+            trackingFired.lastMuted = muted;
+            fireTrackingPixels(muted ? currentAd.trackingUrls.mute : currentAd.trackingUrls.unmute);
+        };
+        var isTrackablePlayback = function isTrackablePlayback() {
+            return adPlaying && !!currentAd && !!adVideoElement && trackingFired.start && !trackingFired.complete && !adVideoElement.ended;
         };
         var onPause = function onPause() {
-            if (currentAd && adVideoElement && !adVideoElement.ended) {
+            continuousVisibleS = 0;
+            if (isTrackablePlayback()) {
                 fireTrackingPixels(currentAd.trackingUrls.pause);
             }
         };
         var onPlay = function onPlay() {
-            if (currentAd && adVideoElement && adVideoElement.currentTime > 0) {
+            if (isTrackablePlayback()) {
                 fireTrackingPixels(currentAd.trackingUrls.resume);
             }
         };
@@ -1671,6 +2032,10 @@ function createHlsAdPlayer(contentVideo, options) {
                 type: "loadedmetadata",
                 handler: onLoadedMetadata
             },
+            {
+                type: "canplay",
+                handler: onCanPlay
+            },
             {
                 type: "playing",
                 handler: onPlaying
@@ -1742,6 +2107,229 @@ function createHlsAdPlayer(contentVideo, options) {
         }
         adEventHandlers = [];
     }
+    function handleAdClick() {
+        if (!adPlaying || !currentAd) return;
+        fireTrackingPixels(currentAd.trackingUrls.clickTracking);
+        emit("ad_click", {
+            adId: currentAd.id,
+            clickThrough: currentAd.clickThrough
+        });
+        if (currentAd.clickThrough) {
+            try {
+                window.open(currentAd.clickThrough, "_blank", "noopener");
+            } catch (error) {
+                console.warn("[HlsAdPlayer] Failed to open ClickThrough URL:", error);
+            }
+        }
+    }
+    function reportCurrentAdError(errorCode) {
+        if (!currentAd) return;
+        resolvedAds.add(currentAd);
+        fireTrackingPixels(currentAd.trackingUrls.error, {
+            errorCode: errorCode
+        });
+    }
+    function fireNotUsedForUnplayedAds() {
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            for(var _iterator = podAds[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                var ad = _step.value;
+                if (resolvedAds.has(ad)) continue;
+                resolvedAds.add(ad);
+                fireTrackingPixels(ad.trackingUrls.notUsed, {
+                    ad: ad
+                });
+            }
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
+            }
+        }
+    }
+    function sampleViewability() {
+        if (!currentAd || !adVideoElement || !viewObserver || !trackingFired.impression || trackingFired.viewabilitySettled) {
+            return;
+        }
+        var now = adVideoElement.currentTime;
+        var inView = visibleRatio >= VIEWABLE_MIN_VISIBLE_RATIO && document.visibilityState === "visible" && !adVideoElement.paused;
+        if (!inView) {
+            continuousVisibleS = 0;
+        } else if (lastViewSampleTime !== void 0 && now >= lastViewSampleTime) {
+            continuousVisibleS += now - lastViewSampleTime;
+        }
+        lastViewSampleTime = now;
+        if (continuousVisibleS >= VIEWABLE_MIN_CONTINUOUS_S) {
+            trackingFired.viewabilitySettled = true;
+            fireTrackingPixels(currentAd.trackingUrls.viewable);
+        }
+    }
+    function settleViewability() {
+        if (!currentAd || !trackingFired.impression || trackingFired.viewabilitySettled) {
+            return;
+        }
+        trackingFired.viewabilitySettled = true;
+        fireTrackingPixels(viewObserver ? currentAd.trackingUrls.notViewable : currentAd.trackingUrls.viewUndetermined);
+    }
+    function handleFullscreenChange() {
+        var _document_fullscreenElement;
+        if (!adPlaying || !currentAd || !adContainerEl || !trackingFired.start) return;
+        var fullscreenEl = (_document_fullscreenElement = document.fullscreenElement) !== null && _document_fullscreenElement !== void 0 ? _document_fullscreenElement : document.webkitFullscreenElement;
+        var expanded = !!fullscreenEl && fullscreenEl.contains(adContainerEl);
+        if (expanded === lastPlayerExpanded) return;
+        lastPlayerExpanded = expanded;
+        var urls = currentAd.trackingUrls;
+        fireTrackingPixels(expanded ? urls.fullscreen.concat(urls.playerExpand) : urls.exitFullscreen.concat(urls.playerCollapse));
+    }
+    function attachContainerHandlers() {
+        if (!adContainerEl || containerHandlers.length > 0) return;
+        var onClick = function onClick() {
+            return handleAdClick();
+        };
+        var onInteraction = function onInteraction(event) {
+            if (adPlaying) emit("ad_interaction", event);
+        };
+        containerHandlers = [
+            {
+                type: "click",
+                handler: onClick
+            },
+            {
+                type: "mousedown",
+                handler: onInteraction
+            },
+            {
+                type: "touchstart",
+                handler: onInteraction
+            }
+        ];
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            for(var _iterator = containerHandlers[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                var _step_value = _step.value, type = _step_value.type, handler = _step_value.handler;
+                adContainerEl.addEventListener(type, handler);
+            }
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
+            }
+        }
+        var onFullscreenChange = function onFullscreenChange() {
+            return handleFullscreenChange();
+        };
+        documentHandlers = [
+            {
+                type: "fullscreenchange",
+                handler: onFullscreenChange
+            },
+            {
+                type: "webkitfullscreenchange",
+                handler: onFullscreenChange
+            }
+        ];
+        var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+        try {
+            for(var _iterator1 = documentHandlers[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                var _step_value1 = _step1.value, type1 = _step_value1.type, handler1 = _step_value1.handler;
+                document.addEventListener(type1, handler1);
+            }
+        } catch (err) {
+            _didIteratorError1 = true;
+            _iteratorError1 = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                    _iterator1.return();
+                }
+            } finally{
+                if (_didIteratorError1) {
+                    throw _iteratorError1;
+                }
+            }
+        }
+        if (typeof IntersectionObserver !== "undefined") {
+            viewObserver = new IntersectionObserver(function(entries) {
+                var entry = entries[entries.length - 1];
+                if (entry) {
+                    visibleRatio = entry.isIntersecting ? entry.intersectionRatio : 0;
+                }
+            }, {
+                threshold: [
+                    0,
+                    0.25,
+                    0.5,
+                    0.75,
+                    1
+                ]
+            });
+            viewObserver.observe(adContainerEl);
+        }
+    }
+    function detachContainerHandlers() {
+        if (adContainerEl) {
+            var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+            try {
+                for(var _iterator = containerHandlers[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                    var _step_value = _step.value, type = _step_value.type, handler = _step_value.handler;
+                    adContainerEl.removeEventListener(type, handler);
+                }
+            } catch (err) {
+                _didIteratorError = true;
+                _iteratorError = err;
+            } finally{
+                try {
+                    if (!_iteratorNormalCompletion && _iterator.return != null) {
+                        _iterator.return();
+                    }
+                } finally{
+                    if (_didIteratorError) {
+                        throw _iteratorError;
+                    }
+                }
+            }
+        }
+        containerHandlers = [];
+        var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+        try {
+            for(var _iterator1 = documentHandlers[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                var _step_value1 = _step1.value, type1 = _step_value1.type, handler1 = _step_value1.handler;
+                document.removeEventListener(type1, handler1);
+            }
+        } catch (err) {
+            _didIteratorError1 = true;
+            _iteratorError1 = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                    _iterator1.return();
+                }
+            } finally{
+                if (_didIteratorError1) {
+                    throw _iteratorError1;
+                }
+            }
+        }
+        documentHandlers = [];
+        viewObserver === null || viewObserver === void 0 ? void 0 : viewObserver.disconnect();
+        viewObserver = void 0;
+    }
     function setAdPlayingFlag(isPlaying) {
         if (isPlaying) {
             contentVideo.dataset.stormcloudAdPlaying = "true";
@@ -1749,15 +2337,10 @@ 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 resetAdTracking() {
+        trackingFired = createTrackingState();
+        continuousVisibleS = 0;
+        lastViewSampleTime = void 0;
     }
     function isRvfcSupported(video) {
         return typeof video.requestVideoFrameCallback === "function";
@@ -1863,13 +2446,12 @@ function createHlsAdPlayer(contentVideo, options) {
         if (podIndex >= podAds.length - 1) {
             return false;
         }
+        settleViewability();
         podIndex++;
         currentAd = podAds[podIndex];
         currentAdMediaFile = void 0;
-        resetQuartileTracking(false);
+        resetAdTracking();
         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"));
         }
         clearStallWatchdog();
@@ -1907,11 +2489,7 @@ function createHlsAdPlayer(contentVideo, options) {
     function handleAdStall() {
         console.warn("[HlsAdPlayer] Ad playback stalled (no progress) - recovering to avoid a blank frame");
         clearStallWatchdog();
-        if (currentAd) {
-            fireTrackingPixels(currentAd.trackingUrls.error, {
-                errorCode: VAST_ERROR_MEDIA_DISPLAY
-            });
-        }
+        reportCurrentAdError(VAST_ERROR_MEDIA_DISPLAY);
         if (podIndex < podAds.length - 1 && advanceToNextPodAd()) {
             return;
         }
@@ -1977,11 +2555,7 @@ function createHlsAdPlayer(contentVideo, options) {
     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, {
-                errorCode: VAST_ERROR_MEDIA_DISPLAY
-            });
-        }
+        reportCurrentAdError(VAST_ERROR_MEDIA_DISPLAY);
         if (podIndex < podAds.length - 1 && advanceToNextPodAd()) {
             return;
         }
@@ -2036,6 +2610,7 @@ function createHlsAdPlayer(contentVideo, options) {
     }
     function handleAdComplete() {
         console.log("[HlsAdPlayer] Handling ad completion");
+        settleViewability();
         clearStallWatchdog();
         adPlaying = false;
         setAdPlayingFlag(false);
@@ -2059,6 +2634,7 @@ function createHlsAdPlayer(contentVideo, options) {
     }
     function handleAdError() {
         console.log("[HlsAdPlayer] Handling ad error");
+        settleViewability();
         clearStallWatchdog();
         adPlaying = false;
         setAdPlayingFlag(false);
@@ -2091,6 +2667,7 @@ function createHlsAdPlayer(contentVideo, options) {
                 adContainerEl = container;
             }
             contentVideo[AD_CONTAINER_PROP] = adContainerEl;
+            attachContainerHandlers();
         },
         requestAds: function requestAds(vastTagUrl) {
             return _async_to_generator(function() {
@@ -2153,10 +2730,6 @@ function createHlsAdPlayer(contentVideo, options) {
                             currentAd = ads[0];
                             currentAdMediaFile = void 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()
@@ -2196,7 +2769,7 @@ function createHlsAdPlayer(contentVideo, options) {
                             contentVideo[AD_VIDEO_PROP] = adVideoElement;
                         }
                         setupAdEventListeners();
-                        resetQuartileTracking(true);
+                        resetAdTracking();
                         contentVolume = contentVideo.volume;
                         originalVolume = Math.max(0, Math.min(1, contentVolume || originalVolume));
                         if (!(options === null || options === void 0 ? void 0 : options.continueLiveStreamDuringAds)) {
@@ -2267,6 +2840,8 @@ function createHlsAdPlayer(contentVideo, options) {
                 var previousMutedState;
                 return _ts_generator(this, function(_state) {
                     console.log("[HlsAdPlayer] Stopping ad");
+                    settleViewability();
+                    fireNotUsedForUnplayedAds();
                     clearStallWatchdog();
                     adPlaying = false;
                     setAdPlayingFlag(false);
@@ -2297,6 +2872,8 @@ function createHlsAdPlayer(contentVideo, options) {
         },
         destroy: function destroy() {
             console.log("[HlsAdPlayer] Destroying");
+            settleViewability();
+            fireNotUsedForUnplayedAds();
             destroyed = true;
             clearStallWatchdog();
             var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
@@ -2325,6 +2902,7 @@ function createHlsAdPlayer(contentVideo, options) {
             contentVideo.muted = originalMutedState;
             contentVideo.volume = Math.max(0, Math.min(1, originalVolume));
             teardownAdEventListeners();
+            detachContainerHandlers();
             releaseAdDecoder();
             currentAd = void 0;
             currentAdMediaFile = void 0;
@@ -2772,6 +3350,7 @@ function resolveVastEnvironmentSignals(isCtv) {
             limitAdTracking = (_ref1 = platformLat !== null && platformLat !== void 0 ? platformLat : readStoredLimitAdTracking()) !== null && _ref1 !== void 0 ? _ref1 : false;
         }
     }
+    var deviceTypeHint = resolveDeviceTypeHint(isCtv);
     if (isCtv) {
         return _object_spread_props(_object_spread({
             isCtv: true,
@@ -2783,10 +3362,10 @@ function resolveVastEnvironmentSignals(isCtv) {
         } : {}, deviceId && limitAdTracking != null ? {
             limitAdTracking: limitAdTracking
         } : {}), {
-            deviceTypeHint: 5
+            deviceTypeHint: deviceTypeHint
         });
     }
-    return _object_spread({
+    return _object_spread_props(_object_spread({
         isCtv: false
     }, deviceId ? {
         deviceId: deviceId
@@ -2794,7 +3373,142 @@ function resolveVastEnvironmentSignals(isCtv) {
         deviceIdType: deviceIdType
     } : {}, deviceId && limitAdTracking != null ? {
         limitAdTracking: limitAdTracking
-    } : {});
+    } : {}), {
+        deviceTypeHint: deviceTypeHint
+    });
+}
+var DEVICE_TYPE_HINT = {
+    FEATURE_PHONE: 1,
+    SMARTPHONE: 2,
+    DESKTOP: 3,
+    TABLET: 4,
+    CONNECTED_TV: 5,
+    GAME_CONSOLE: 6,
+    SET_TOP_BOX: 7
+};
+var DEVICE_TYPE_HINT_ALIASES = {
+    featurephone: DEVICE_TYPE_HINT.FEATURE_PHONE,
+    smartphone: DEVICE_TYPE_HINT.SMARTPHONE,
+    mobile: DEVICE_TYPE_HINT.SMARTPHONE,
+    phone: DEVICE_TYPE_HINT.SMARTPHONE,
+    desktop: DEVICE_TYPE_HINT.DESKTOP,
+    pc: DEVICE_TYPE_HINT.DESKTOP,
+    tablet: DEVICE_TYPE_HINT.TABLET,
+    ctv: DEVICE_TYPE_HINT.CONNECTED_TV,
+    tv: DEVICE_TYPE_HINT.CONNECTED_TV,
+    connectedtv: DEVICE_TYPE_HINT.CONNECTED_TV,
+    smarttv: DEVICE_TYPE_HINT.CONNECTED_TV,
+    console: DEVICE_TYPE_HINT.GAME_CONSOLE,
+    gameconsole: DEVICE_TYPE_HINT.GAME_CONSOLE,
+    stb: DEVICE_TYPE_HINT.SET_TOP_BOX,
+    settopbox: DEVICE_TYPE_HINT.SET_TOP_BOX
+};
+var SET_TOP_BOX_UA = /LGSTB|\bSTB\b|STB\d|Set-?Top|SetTopBox|TV ?Box|Kaon|Humax|Arris|Technicolor|Sagemcom|Infomir|MAG\d{3}|KreaTV|Amino|Formuler|Dune ?HD|TiVo|MiBOX|Mi Box|SHIELD Android TV|\bAFT[A-Z]|Roku|AppleTV|Apple TV|CrKey/i;
+var GAME_CONSOLE_UA = /PlayStation|Xbox|Nintendo/i;
+var CONNECTED_TV_UA = /Web0S|webOS|Tizen|SMART-TV|SmartTV|NetCast|BRAVIA|HbbTV|VIDAA|Hisense|Philips|Viera|AQUOS|Android TV|Google TV|\bTV\b/i;
+var FEATURE_PHONE_UA = /KAIOS|MIDP|J2ME|Series40|Opera Mini/i;
+function resolveDeviceTypeHint(isCtv) {
+    var override = readDeviceTypeHintOverride();
+    if (override != null) return override;
+    return inferDeviceTypeHint(isCtv);
+}
+function inferDeviceTypeHint(isCtv) {
+    var fallback = isCtv ? DEVICE_TYPE_HINT.CONNECTED_TV : DEVICE_TYPE_HINT.DESKTOP;
+    if (typeof navigator === "undefined") return fallback;
+    var ua = navigator.userAgent || "";
+    var maxTouchPoints = navigator.maxTouchPoints || 0;
+    if (SET_TOP_BOX_UA.test(ua)) return DEVICE_TYPE_HINT.SET_TOP_BOX;
+    if (GAME_CONSOLE_UA.test(ua)) return DEVICE_TYPE_HINT.GAME_CONSOLE;
+    if (CONNECTED_TV_UA.test(ua) && !/Mobile/i.test(ua)) {
+        return DEVICE_TYPE_HINT.CONNECTED_TV;
+    }
+    if (FEATURE_PHONE_UA.test(ua)) return DEVICE_TYPE_HINT.FEATURE_PHONE;
+    if (/iPad/i.test(ua) || /Macintosh/i.test(ua) && maxTouchPoints > 1) {
+        return DEVICE_TYPE_HINT.TABLET;
+    }
+    if (/iPhone|iPod/i.test(ua)) return DEVICE_TYPE_HINT.SMARTPHONE;
+    if (/Android/i.test(ua)) {
+        if (/Mobile/i.test(ua)) return DEVICE_TYPE_HINT.SMARTPHONE;
+        if (maxTouchPoints === 0) return DEVICE_TYPE_HINT.SET_TOP_BOX;
+        return DEVICE_TYPE_HINT.TABLET;
+    }
+    if (/Mobile|Windows Phone|BlackBerry/i.test(ua)) return DEVICE_TYPE_HINT.SMARTPHONE;
+    return fallback;
+}
+function readDeviceTypeHintOverride() {
+    if (typeof window === "undefined") return void 0;
+    var keys = [
+        "dth",
+        "deviceTypeHint"
+    ];
+    var fromGlobal = normalizeDeviceTypeHint(window.__STORMCLOUD_DTH__);
+    if (fromGlobal != null) return fromGlobal;
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = getNativeBridgeSources()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var source = _step.value;
+            var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+            try {
+                for(var _iterator1 = keys[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                    var key = _step1.value;
+                    var value = source === null || source === void 0 ? void 0 : source[key];
+                    var normalized = normalizeDeviceTypeHint(typeof value === "function" ? safeCall(value, source) : value);
+                    if (normalized != null) return normalized;
+                }
+            } catch (err) {
+                _didIteratorError1 = true;
+                _iteratorError1 = err;
+            } finally{
+                try {
+                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                        _iterator1.return();
+                    }
+                } finally{
+                    if (_didIteratorError1) {
+                        throw _iteratorError1;
+                    }
+                }
+            }
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    for(var _i = 0, _iter = [
+        "stormcloud.dth",
+        "dth"
+    ]; _i < _iter.length; _i++){
+        var key1 = _iter[_i];
+        var normalized1 = normalizeDeviceTypeHint(readStoredString(key1));
+        if (normalized1 != null) return normalized1;
+    }
+    return void 0;
+}
+function normalizeDeviceTypeHint(value) {
+    if (typeof value === "number") {
+        return Number.isInteger(value) && value >= 1 && value <= 7 ? value : void 0;
+    }
+    if (typeof value !== "string") return void 0;
+    var trimmed = value.trim();
+    if (/^[1-7]$/.test(trimmed)) return parseInt(trimmed, 10);
+    return DEVICE_TYPE_HINT_ALIASES[trimmed.toLowerCase().replace(/[\s_-]/g, "")];
+}
+function safeCall(fn, thisArg) {
+    try {
+        return fn.call(thisArg);
+    } catch (unused) {
+        return void 0;
+    }
 }
 function inferDeviceIdType() {
     if (typeof navigator === "undefined") {
@@ -3000,22 +3714,9 @@ function isZeroedAdId(value) {
     return ZEROED_AD_ID_PATTERNS.has(value.trim().toLowerCase());
 }
 function readNativeBridgeSignals() {
-    if (typeof window === "undefined") {
-        return {};
-    }
-    var candidates = [
-        window.__STORMCLOUD_CTV_AD_INFO__,
-        window.__STORMCLOUD_CTV__,
-        window.stormcloudCtv,
-        window.AiryTV,
-        window.Android,
-        window.webOS,
-        window.tizen,
-        window.amazon
-    ].filter(Boolean);
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
-        for(var _iterator = candidates[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+        for(var _iterator = getNativeBridgeSources()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
             var source = _step.value;
             var contentUrl = readBridgeValue(source, [
                 "contentUrl",
@@ -3090,6 +3791,21 @@ function readNativeBridgeSignals() {
     }
     return {};
 }
+function getNativeBridgeSources() {
+    if (typeof window === "undefined") {
+        return [];
+    }
+    return [
+        window.__STORMCLOUD_CTV_AD_INFO__,
+        window.__STORMCLOUD_CTV__,
+        window.stormcloudCtv,
+        window.AiryTV,
+        window.Android,
+        window.webOS,
+        window.tizen,
+        window.amazon
+    ].filter(Boolean);
+}
 function readBridgeValue(source, keys) {
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
@@ -7546,6 +8262,12 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                         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("ad_click", function() {
+                    _this.host.onAdClick();
+                });
+                adPlayer.on("ad_interaction", function(event) {
+                    if (event) _this.host.onAdInteraction(event);
+                });
                 adPlayer.on("all_ads_completed", function() {
                     sendAdImpressionTracking(_this.host.config.licenseKey, {
                         source: "hls",
@@ -9075,6 +9797,12 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
             },
             generatePodVastUrl: function generatePodVastUrl(base, breakDurationMs) {
                 return _this.generatePodVastUrl(base, breakDurationMs);
+            },
+            onAdClick: function onAdClick() {
+                return _this.palNonce.sendAdClick();
+            },
+            onAdInteraction: function onAdInteraction(event) {
+                return _this.palNonce.sendAdTouch(event);
             }
         }, this.timing, this.adConfig, this.cueManager, this.placeholder);
     }