stormcloud-video-player 0.8.68 → 0.8.69

package/lib/player/AdBreakOrchestrator.cjs

@@ -284,84 +284,6 @@ __export(AdBreakOrchestrator_exports, {
     }
 });
 module.exports = __toCommonJS(AdBreakOrchestrator_exports);
-// src/utils/trackingIngest.ts
-var DEFAULT_TRACKING_INGEST_CONFIG = {
-    enabled: true,
-    baseUrl: "https://player-analytics-ingest-api-760490581852.us-central1.run.app/api/adstorm/player-tracking"
-};
-var trackingIngestConfig = _object_spread({}, DEFAULT_TRACKING_INGEST_CONFIG);
-function isTrackingIngestEnabled() {
-    return trackingIngestConfig.enabled === true;
-}
-function normalizeIngestBaseUrl(baseUrl) {
-    return baseUrl.replace(/\/+$/, "");
-}
-function buildTrackingIngestUrl(channel) {
-    var base = normalizeIngestBaseUrl(trackingIngestConfig.baseUrl);
-    if (channel === "impressions") {
-        return "".concat(base, "/impressions/ingest");
-    }
-    return "".concat(base, "/metrics/ingest");
-}
-function ingestPlayerTracking(licenseKey, channel, body) {
-    return _async_to_generator(function() {
-        var response, error;
-        return _ts_generator(this, function(_state) {
-            switch(_state.label){
-                case 0:
-                    if (!isTrackingIngestEnabled() || !licenseKey) {
-                        return [
-                            2,
-                            false
-                        ];
-                    }
-                    _state.label = 1;
-                case 1:
-                    _state.trys.push([
-                        1,
-                        3,
-                        ,
-                        4
-                    ]);
-                    return [
-                        4,
-                        fetch(buildTrackingIngestUrl(channel), {
-                            method: "POST",
-                            headers: {
-                                "Content-Type": "application/json",
-                                Authorization: "License-Key ".concat(licenseKey)
-                            },
-                            body: JSON.stringify(body)
-                        })
-                    ];
-                case 2:
-                    response = _state.sent();
-                    if (!response.ok) {
-                        console.warn("[StormcloudVideoPlayer] Tracking ingest failed (".concat(response.status, ") for ").concat(channel));
-                        return [
-                            2,
-                            false
-                        ];
-                    }
-                    return [
-                        2,
-                        true
-                    ];
-                case 3:
-                    error = _state.sent();
-                    console.warn("[StormcloudVideoPlayer] Tracking ingest error for ".concat(channel, ":"), error);
-                    return [
-                        2,
-                        false
-                    ];
-                case 4:
-                    return [
-                        2
-                    ];
-            }
-        });
-    })();
-}
 // src/utils/vastEnvironmentSignals.ts
 var PLAYER_ID_STORAGE_KEY = "stormcloud.player.id";
 var DEVICE_ID_STORAGE_KEYS = [
@@ -807,6 +729,225 @@ function normalizeBoolean(value) {
     }
     return void 0;
 }
+// src/utils/vastMacros.ts
+var GAM_AD_HOSTS = /* @__PURE__ */ new Set([
+    "pubads.g.doubleclick.net",
+    "securepubads.g.doubleclick.net"
+]);
+function ensureVideoAdType(rawUrl) {
+    try {
+        var url = new URL(rawUrl);
+        if (!GAM_AD_HOSTS.has(url.hostname)) return rawUrl;
+        if (url.searchParams.has("ad_type")) return rawUrl;
+        url.searchParams.set("ad_type", "video");
+        return url.toString();
+    } catch (unused) {
+        return rawUrl;
+    }
+}
+// src/player/FloorLadder.ts
+var DEFAULT_WEB_FLOOR_LADDER_CONFIG = Object.freeze({
+    enabled: false,
+    targetingKey: "airytv_web_floor",
+    minFloorCents: 25,
+    maxFloorCents: 300,
+    stepCents: 25,
+    selectedFloorCents: 25,
+    fallbackFloorCents: 25,
+    readyFloorCents: [],
+    mode: "fixed",
+    allowedPositions: [
+        "midroll"
+    ],
+    targetAdUnitPath: "/21821455290/airytvadx/airytv-web",
+    configurationVersion: "2026-09-29.1"
+});
+var DEFAULT_FLOOR_LADDER_BOUNDS = Object.freeze({
+    minCents: 25,
+    maxCents: 300,
+    stepCents: 25
+});
+function decodeQueryComponent(value) {
+    try {
+        return decodeURIComponent(value.replace(/\+/g, " "));
+    } catch (unused) {
+        return void 0;
+    }
+}
+function mergeCustParams(decoded, key, cents) {
+    var prefix = "".concat(key, "=");
+    var kept = decoded.split("&").filter(function(pair) {
+        return pair !== "" && pair !== key && pair.indexOf(prefix) !== 0;
+    });
+    kept.push("".concat(prefix).concat(cents));
+    return kept.join("&");
+}
+function applyFloorToVastUrl(url, floor) {
+    if (floor.status !== "armed" || floor.floorCents == null) {
+        return {
+            url: url,
+            applied: false,
+            reason: floor.reason
+        };
+    }
+    var parsed;
+    try {
+        parsed = new URL(url);
+    } catch (unused) {
+        return {
+            url: url,
+            applied: false,
+            reason: "invalid_url"
+        };
+    }
+    if (!GAM_AD_HOSTS.has(parsed.hostname)) {
+        return {
+            url: url,
+            applied: false,
+            reason: "not_gam_host"
+        };
+    }
+    if (parsed.searchParams.get("iu") !== floor.targetAdUnitPath) {
+        return {
+            url: url,
+            applied: false,
+            reason: "ad_unit_mismatch"
+        };
+    }
+    var hashIndex = url.indexOf("#");
+    var beforeHash = hashIndex === -1 ? url : url.slice(0, hashIndex);
+    var hash = hashIndex === -1 ? "" : url.slice(hashIndex);
+    var queryIndex = beforeHash.indexOf("?");
+    var base = beforeHash.slice(0, queryIndex);
+    var segments = beforeHash.slice(queryIndex + 1).split("&");
+    var existing = [];
+    var insertAt = -1;
+    var rest = [];
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = segments[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var segment = _step.value;
+            var eq = segment.indexOf("=");
+            var rawKey = eq === -1 ? segment : segment.slice(0, eq);
+            if (decodeQueryComponent(rawKey) === "cust_params") {
+                if (insertAt === -1) insertAt = rest.length;
+                var value = eq === -1 ? "" : decodeQueryComponent(segment.slice(eq + 1));
+                if (value === void 0) {
+                    return {
+                        url: url,
+                        applied: false,
+                        reason: "malformed_cust_params"
+                    };
+                }
+                if (value) existing.push(value);
+                continue;
+            }
+            rest.push(segment);
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    if (insertAt === -1) insertAt = rest.length;
+    var merged = mergeCustParams(existing.join("&"), floor.targetingKey, floor.floorCents);
+    rest.splice(insertAt, 0, "cust_params=".concat(encodeURIComponent(merged)));
+    var query = rest.filter(function(segment) {
+        return segment !== "";
+    }).join("&");
+    return {
+        url: "".concat(base, "?").concat(query).concat(hash),
+        applied: true,
+        reason: void 0
+    };
+}
+// src/utils/trackingIngest.ts
+var DEFAULT_TRACKING_INGEST_CONFIG = {
+    enabled: true,
+    baseUrl: "https://player-analytics-ingest-api-760490581852.us-central1.run.app/api/adstorm/player-tracking"
+};
+var trackingIngestConfig = _object_spread({}, DEFAULT_TRACKING_INGEST_CONFIG);
+function isTrackingIngestEnabled() {
+    return trackingIngestConfig.enabled === true;
+}
+function normalizeIngestBaseUrl(baseUrl) {
+    return baseUrl.replace(/\/+$/, "");
+}
+function buildTrackingIngestUrl(channel) {
+    var base = normalizeIngestBaseUrl(trackingIngestConfig.baseUrl);
+    if (channel === "impressions") {
+        return "".concat(base, "/impressions/ingest");
+    }
+    return "".concat(base, "/metrics/ingest");
+}
+function ingestPlayerTracking(licenseKey, channel, body) {
+    return _async_to_generator(function() {
+        var response, error;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    if (!isTrackingIngestEnabled() || !licenseKey) {
+                        return [
+                            2,
+                            false
+                        ];
+                    }
+                    _state.label = 1;
+                case 1:
+                    _state.trys.push([
+                        1,
+                        3,
+                        ,
+                        4
+                    ]);
+                    return [
+                        4,
+                        fetch(buildTrackingIngestUrl(channel), {
+                            method: "POST",
+                            headers: {
+                                "Content-Type": "application/json",
+                                Authorization: "License-Key ".concat(licenseKey)
+                            },
+                            body: JSON.stringify(body)
+                        })
+                    ];
+                case 2:
+                    response = _state.sent();
+                    if (!response.ok) {
+                        console.warn("[StormcloudVideoPlayer] Tracking ingest failed (".concat(response.status, ") for ").concat(channel));
+                        return [
+                            2,
+                            false
+                        ];
+                    }
+                    return [
+                        2,
+                        true
+                    ];
+                case 3:
+                    error = _state.sent();
+                    console.warn("[StormcloudVideoPlayer] Tracking ingest error for ".concat(channel, ":"), error);
+                    return [
+                        2,
+                        false
+                    ];
+                case 4:
+                    return [
+                        2
+                    ];
+            }
+        });
+    })();
+}
 // src/utils/tracking.ts
 var cachedBrowserId = null;
 function buildAnalyticsContext(config) {
@@ -1288,22 +1429,6 @@ function sendHeartbeat(_0) {
 function getAdAudioVolume(adPlayer) {
     return adPlayer.getOriginalMutedState() ? 0 : adPlayer.getOriginalVolume();
 }
-// src/utils/vastMacros.ts
-var GAM_AD_HOSTS = /* @__PURE__ */ new Set([
-    "pubads.g.doubleclick.net",
-    "securepubads.g.doubleclick.net"
-]);
-function ensureVideoAdType(rawUrl) {
-    try {
-        var url = new URL(rawUrl);
-        if (!GAM_AD_HOSTS.has(url.hostname)) return rawUrl;
-        if (url.searchParams.has("ad_type")) return rawUrl;
-        url.searchParams.set("ad_type", "video");
-        return url.toString();
-    } catch (unused) {
-        return rawUrl;
-    }
-}
 // src/player/AdBreakOrchestrator.ts
 var REQUEST_FAILURE_STAGES = /* @__PURE__ */ new Set([
     "no_fill",
@@ -1612,13 +1737,13 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
         },
         {
             key: "beginVmapBreak",
-            value: function beginVmapBreak(breakKey) {
+            value: function beginVmapBreak(breakKey, position) {
                 this.breakSource = "vmap";
                 this.followUpBaseVastUrl = void 0;
                 this.unusableResponsesInBreak = 0;
                 this.timing.totalAdRequestsInBreak = 0;
                 this.setSlotState("NEEDS_NEXT_AD", "vmap_break_start");
-                this.noteOpportunity("vmap", breakKey);
+                this.noteOpportunity("vmap", breakKey, position);
             }
         },
         {
@@ -1673,7 +1798,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                 if (this.timing.expectedAdBreakDurationMs == null && adBreakDurationMs != null) {
                                     this.timing.expectedAdBreakDurationMs = adBreakDurationMs;
                                 }
-                                this.noteOpportunity("scte35", this.cueManager.activeScte35BreakKey);
+                                this.noteOpportunity("scte35", this.cueManager.activeScte35BreakKey, "midroll");
                                 epoch = this.timing.adBreakEpoch;
                                 hasPrefetchedUrl = !!(this.pendingAdBreak && this.pendingAdBreak.vastUrls.length > 0);
                                 if (!(adBreakDurationMs == null && !hasPrefetchedUrl)) return [
@@ -1767,7 +1892,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
             // ───────────────────────────────────────────────────────────────
             function startOptimizedPod(baseVastUrl, breakDurationMs) {
                 return _async_to_generator(function() {
-                    var podUrl, prefetched, epoch, generation, adPlayer, requestToken, _ref, _adPlayer_getPodAdCount, podCount, error;
+                    var podUrl, prefetched, epoch, generation, adPlayer, requestToken, requestUrl, _ref, _adPlayer_getPodAdCount, podCount, error;
                     return _ts_generator(this, function(_state) {
                         switch(_state.label){
                             case 0:
@@ -1791,9 +1916,10 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                 adPlayer = this.host.getAdPlayer();
                                 requestToken = ++this.timing.adRequestTokenCounter;
                                 this.timing.activeAdRequestToken = requestToken;
-                                this.currentVastUrl = podUrl;
                                 this.setSlotState("REQUESTING", "initial_pod");
                                 this.beginFunnelRequest(adPlayer, requestToken, "initial_pod");
+                                requestUrl = this.applyOpportunityFloor(podUrl);
+                                this.currentVastUrl = requestUrl;
                                 _state.label = 1;
                             case 1:
                                 _state.trys.push([
@@ -1816,7 +1942,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                 return [
                                     4,
                                     this.callController(function() {
-                                        return adPlayer.requestAds(podUrl);
+                                        return adPlayer.requestAds(requestUrl);
                                     })
                                 ];
                             case 3:
@@ -1848,7 +1974,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                 }
                                 sendAdLoadedTracking(this.host.config.licenseKey, {
                                     source: "hls",
-                                    vastUrl: podUrl,
+                                    vastUrl: requestUrl,
                                     timestamp: (/* @__PURE__ */ new Date()).toISOString()
                                 }, this.analyticsContext).catch(function() {});
                                 this.timing.startAdFailsafeTimer(requestToken);
@@ -2195,12 +2321,14 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                     this.timing.failedVastUrls.add(vastTagUrl);
                 }
                 this.countFunnelStage("request_outcome:".concat(outcome));
-                this.logOrchestratorFunnel("request_outcome", {
+                this.logOrchestratorFunnel("request_outcome", _object_spread({
                     outcome: outcome,
                     errorMessage: message,
                     consecutiveFailures: this.timing.consecutiveFailures,
-                    unusableResponsesInBreak: this.unusableResponsesInBreak
-                });
+                    unusableResponsesInBreak: this.unusableResponsesInBreak,
+                    vastAdCount: diag === null || diag === void 0 ? void 0 : diag.vastAdCount,
+                    impressionCount: diag === null || diag === void 0 ? void 0 : diag.impressionCount
+                }, this.requestFloorFields(diag)));
             }
         },
         {
@@ -2239,6 +2367,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                         break;
                     case "impression_fired":
                         diag.impressionFired = true;
+                        diag.impressionCount++;
                         break;
                     default:
                         if (REQUEST_FAILURE_STAGES.has(payload.stage) && !diag.failureReason) {
@@ -2295,6 +2424,67 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                 }
             }
         },
+        {
+            key: "opportunityFloorFields",
+            value: function opportunityFloorFields() {
+                var floor = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : this.opportunityFloor;
+                if (!floor) return {};
+                return {
+                    floorStatus: floor.status,
+                    floorCents: floor.floorCents,
+                    floorSource: floor.source,
+                    floorReason: floor.reason,
+                    floorSelector: floor.selector,
+                    floorConfigVersion: floor.configurationVersion,
+                    adPosition: floor.position
+                };
+            }
+        },
+        {
+            key: "requestFloorFields",
+            value: function requestFloorFields(diag) {
+                if (!diag || diag.floorApplied === void 0) return {};
+                return {
+                    floorApplied: diag.floorApplied,
+                    floorCents: diag.floorCents,
+                    floorSource: diag.floorSource,
+                    floorReason: diag.floorReason,
+                    floorConfigVersion: diag.floorConfigVersion
+                };
+            }
+        },
+        {
+            key: "applyOpportunityFloor",
+            value: function applyOpportunityFloor(url) {
+                var floor = this.opportunityFloor;
+                if (!floor) return url;
+                var result = applyFloorToVastUrl(url, floor);
+                var diag = this.currentRequestId != null ? this.requestDiagnostics.get(this.currentRequestId) : void 0;
+                if (diag) {
+                    diag.floorApplied = result.applied;
+                    if (result.applied && floor.floorCents != null) diag.floorCents = floor.floorCents;
+                    diag.floorSource = result.applied ? floor.source : "none";
+                    if (result.reason) diag.floorReason = result.reason;
+                    diag.floorConfigVersion = floor.configurationVersion;
+                }
+                if (floor.status === "skipped" && floor.reason === "disabled") {
+                    this.countFunnelStage("floor_skipped:disabled");
+                    return result.url;
+                }
+                this.logOrchestratorFunnel(result.applied ? "floor_applied" : "floor_skipped", {
+                    reason: result.reason,
+                    floorCents: result.applied ? floor.floorCents : void 0,
+                    floorSource: result.applied ? floor.source : "none",
+                    floorSelector: floor.selector,
+                    floorConfigVersion: floor.configurationVersion,
+                    adPosition: floor.position
+                });
+                if (!result.applied && result.reason) {
+                    this.countFunnelStage("floor_skipped:".concat(result.reason));
+                }
+                return result.url;
+            }
+        },
         {
             key: "countFunnelStage",
             value: function countFunnelStage(stage) {
@@ -2317,7 +2507,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
         },
         {
             key: "noteOpportunity",
-            value: function noteOpportunity(source, breakKey) {
+            value: function noteOpportunity(source, breakKey, position) {
                 if (breakKey && breakKey === this.opportunityBreakKey && this.opportunityEpoch === this.timing.adBreakEpoch) {
                     this.logOrchestratorFunnel("duplicate_break_start", {
                         source: source,
@@ -2327,11 +2517,16 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                 }
                 this.opportunityBreakKey = breakKey;
                 this.opportunityEpoch = this.timing.adBreakEpoch;
-                this.logOrchestratorFunnel("opportunity_created", {
+                try {
+                    this.opportunityFloor = this.host.getFloorSnapshot(position);
+                } catch (unused) {
+                    this.opportunityFloor = void 0;
+                }
+                this.logOrchestratorFunnel("opportunity_created", _object_spread({
                     source: source,
                     breakKey: breakKey,
                     expectedDurationMs: this.timing.expectedAdBreakDurationMs
-                });
+                }, this.opportunityFloorFields()));
             }
         },
         {
@@ -2358,6 +2553,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                     supportedMediaCount: 0,
                     playStarted: false,
                     impressionFired: false,
+                    impressionCount: 0,
                     startedAt: Date.now()
                 });
                 (_adPlayer_setFunnelContext = adPlayer.setFunnelContext) === null || _adPlayer_setFunnelContext === void 0 ? void 0 : _adPlayer_setFunnelContext.call(adPlayer, {
@@ -2442,7 +2638,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
             value: function playSingleAd(vastTagUrl) {
                 var trigger = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : "vmap";
                 return _async_to_generator(function() {
-                    var epoch, generation, requestToken, ap, requestUrl, _ap_getLoadedAdDuration, adDurationS, remainingMs, error;
+                    var epoch, generation, requestToken, ap, budgetedUrl, requestUrl, _ap_getLoadedAdDuration, adDurationS, remainingMs, error;
                     return _ts_generator(this, function(_state) {
                         switch(_state.label){
                             case 0:
@@ -2480,10 +2676,11 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                 requestToken = ++this.timing.adRequestTokenCounter;
                                 this.timing.activeAdRequestToken = requestToken;
                                 ap = this.host.getAdPlayer();
-                                requestUrl = this.withCurrentPodBudget(vastTagUrl);
-                                this.currentVastUrl = requestUrl;
+                                budgetedUrl = this.withCurrentPodBudget(vastTagUrl);
                                 this.setSlotState("REQUESTING", trigger);
                                 this.beginFunnelRequest(ap, requestToken, trigger);
+                                requestUrl = this.applyOpportunityFloor(budgetedUrl);
+                                this.currentVastUrl = requestUrl;
                                 _state.label = 1;
                             case 1:
                                 _state.trys.push([
@@ -2616,10 +2813,13 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                         endReason: endReason
                     });
                 }
-                console.log("[AdBreak][FUNNEL] Break summary", {
+                console.log("[AdBreak][FUNNEL] Break summary", _object_spread_props(_object_spread({
                     breakId: breakId,
                     endReason: endReason,
-                    opportunities: count("opportunity_created"),
+                    opportunities: count("opportunity_created")
+                }, this.opportunityFloorFields()), {
+                    floorAppliedRequests: count("floor_applied"),
+                    floorSkippedRequests: count("floor_skipped") + count("floor_skipped:disabled"),
                     vastUrlsGenerated: count("vast_url_generated"),
                     requests: requests,
                     requestRetries: requestRetries,
@@ -2671,7 +2871,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                     visibilityHidden: count("while_hidden"),
                     playbackFailures: count("play_failed") + count("media_error") + count("hls_fatal") + count("stall") + count("decode_failure") + count("media_unsupported"),
                     stages: funnel
-                });
+                }));
             }
         },
         {
@@ -2722,6 +2922,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                 this.unusableResponsesInBreak = 0;
                 adPlayer.stop().catch(function() {});
                 if (!alreadyEnded) this.logBreakFunnel(reason);
+                this.opportunityFloor = void 0;
                 this.setSlotState("IDLE", "break_complete");
                 var restoredMuted = this.host.getAdPlayer().getOriginalMutedState();
                 var restoredVolume = this.host.getAdPlayer().getOriginalVolume();