stormcloud-video-player 0.8.75 → 0.8.77

package/lib/player/StormcloudVideoPlayer.d.cts

@@ -1,5 +1,5 @@
 import { StormcloudVideoPlayerConfig, AdFloorLadderConfig } from '../types.cjs';
-import { FloorLadderValidationReport, FloorLadderBounds, FloorSelector } from './FloorLadder.cjs';
+import { FloorLadderBounds, FloorSelector } from './FloorLadder.cjs';
 import './OptimizedPodRequest.cjs';
 
 declare class StormcloudVideoPlayer {
@@ -19,19 +19,13 @@ declare class StormcloudVideoPlayer {
     private readonly hlsEngine;
     private readonly adBreak;
     private readonly floorLadder;
-    private floorLadderEnabled;
     private edgePodBaseUrl;
     constructor(config: StormcloudVideoPlayerConfig);
     private get debug();
     private createAdPlayer;
-    private isCtvEnvironment;
-    setAdFloorLadder(update: Partial<AdFloorLadderConfig>): FloorLadderValidationReport;
-    setAdFloorLadderEnabled(enabled: boolean): void;
+    private applyFloorLadderFromApi;
     isAdFloorLadderEnabled(): boolean;
-    setEdgePodRequest(update: {
-        enableEdgePodRequest?: boolean;
-        edgePodUrl?: string;
-    }): void;
+    private applyEdgePodFromApi;
     getEdgePodUrl(): string | undefined;
     private warnOnInvalidFloorLadder;
     getAdFloorLadder(): AdFloorLadderConfig;

package/lib/players/HlsPlayer.cjs

@@ -1730,21 +1730,19 @@ function fetchConsentSignals() {
     });
 }
 // src/player/FloorLadder.ts
-var DEFAULT_WEB_FLOOR_LADDER_CONFIG = Object.freeze({
+var DISABLED_FLOOR_LADDER_CONFIG = Object.freeze({
     enabled: false,
-    targetingKey: "airytv_web_floor",
-    minFloorCents: 25,
-    maxFloorCents: 300,
-    stepCents: 25,
-    selectedFloorCents: 25,
-    fallbackFloorCents: 25,
+    targetingKey: "",
+    minFloorCents: 0,
+    maxFloorCents: 0,
+    stepCents: 0,
+    selectedFloorCents: 0,
+    fallbackFloorCents: 0,
     readyFloorCents: [],
     mode: "fixed",
-    allowedPositions: [
-        "midroll"
-    ],
-    targetAdUnitPath: "/21821455290/airytvadx/airytv-web",
-    configurationVersion: "2026-09-29.1"
+    allowedPositions: [],
+    targetAdUnitPath: "",
+    configurationVersion: ""
 });
 var DEFAULT_FLOOR_LADDER_BOUNDS = Object.freeze({
     minCents: 25,
@@ -1763,15 +1761,6 @@ function generateFloorLevels(minCents, maxCents, stepCents) {
     }
     return levels;
 }
-function resolveFloorLadderBounds() {
-    var overrides = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
-    var _overrides_minCents, _overrides_maxCents, _overrides_stepCents;
-    return {
-        minCents: (_overrides_minCents = overrides.minCents) !== null && _overrides_minCents !== void 0 ? _overrides_minCents : DEFAULT_FLOOR_LADDER_BOUNDS.minCents,
-        maxCents: (_overrides_maxCents = overrides.maxCents) !== null && _overrides_maxCents !== void 0 ? _overrides_maxCents : DEFAULT_FLOOR_LADDER_BOUNDS.maxCents,
-        stepCents: (_overrides_stepCents = overrides.stepCents) !== null && _overrides_stepCents !== void 0 ? _overrides_stepCents : DEFAULT_FLOOR_LADDER_BOUNDS.stepCents
-    };
-}
 function validateFloorCents(value, config) {
     var bounds = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : DEFAULT_FLOOR_LADDER_BOUNDS;
     if (!isInteger(value)) return {
@@ -1903,7 +1892,6 @@ function resolveOpportunityFloor(config, context) {
     if (!config.enabled) return skipped("disabled");
     var positions = Array.isArray(config.allowedPositions) ? config.allowedPositions : [];
     if (positions.indexOf(context.position) === -1) return skipped("position_not_allowed");
-    if (context.isCtv) return skipped("ctv_excluded");
     if (!config.targetingKey) return skipped("missing_targeting_key");
     if (!config.targetAdUnitPath) return skipped("missing_target_ad_unit");
     var result;
@@ -2057,15 +2045,80 @@ function mergeDefined(target, update) {
     }
     return copyConfig(next);
 }
+var AD_POSITIONS = [
+    "preroll",
+    "midroll",
+    "postroll"
+];
+function finiteNumber(value) {
+    return typeof value === "number" && isFinite(value) ? value : void 0;
+}
+function parseApiFloorLadder(raw) {
+    if (!raw || (typeof raw === "undefined" ? "undefined" : _type_of(raw)) !== "object" || Array.isArray(raw)) return void 0;
+    var src = raw;
+    var out = {};
+    if (typeof src.enabled === "boolean") out.enabled = src.enabled;
+    if (typeof src.targetingKey === "string") out.targetingKey = src.targetingKey;
+    if (typeof src.targetAdUnitPath === "string") out.targetAdUnitPath = src.targetAdUnitPath;
+    if (typeof src.configurationVersion === "string") out.configurationVersion = src.configurationVersion;
+    if (typeof src.mode === "string") out.mode = src.mode;
+    var min = finiteNumber(src.minFloorCents);
+    var max = finiteNumber(src.maxFloorCents);
+    var step = finiteNumber(src.stepCents);
+    var selected = finiteNumber(src.selectedFloorCents);
+    var fallback = finiteNumber(src.fallbackFloorCents);
+    if (min !== void 0) out.minFloorCents = min;
+    if (max !== void 0) out.maxFloorCents = max;
+    if (step !== void 0) out.stepCents = step;
+    if (selected !== void 0) out.selectedFloorCents = selected;
+    if (fallback !== void 0) out.fallbackFloorCents = fallback;
+    if (Array.isArray(src.readyFloorCents)) {
+        out.readyFloorCents = src.readyFloorCents.filter(function(cents) {
+            return finiteNumber(cents) !== void 0;
+        });
+    }
+    if (Array.isArray(src.allowedPositions)) {
+        out.allowedPositions = src.allowedPositions.filter(function(position) {
+            return AD_POSITIONS.indexOf(position) !== -1;
+        });
+    }
+    return out;
+}
 var FloorLadderController = /*#__PURE__*/ function() {
-    function FloorLadderController(initial, bounds) {
-        var selector = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : fixedFloorSelector;
+    function FloorLadderController() {
+        var selector = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : fixedFloorSelector;
         _class_call_check(this, FloorLadderController);
-        this.config = mergeDefined(copyConfig(DEFAULT_WEB_FLOOR_LADDER_CONFIG), initial);
-        this.bounds = Object.freeze(resolveFloorLadderBounds(bounds));
+        this.bounds = DEFAULT_FLOOR_LADDER_BOUNDS;
+        this.config = copyConfig(DISABLED_FLOOR_LADDER_CONFIG);
         this.selector = selector;
     }
     _create_class(FloorLadderController, [
+        {
+            key: "isEnabled",
+            value: function isEnabled() {
+                return this.config.enabled === true;
+            }
+        },
+        {
+            key: "applyApiConfig",
+            value: function applyApiConfig(raw) {
+                var parsed = parseApiFloorLadder(raw);
+                this.config = mergeDefined(copyConfig(DISABLED_FLOOR_LADDER_CONFIG), parsed);
+                this.bounds = Object.freeze({
+                    minCents: this.config.minFloorCents,
+                    maxCents: this.config.maxFloorCents,
+                    stepCents: this.config.stepCents
+                });
+                return validateFloorLadderConfig(this.config, this.bounds);
+            }
+        },
+        {
+            key: "reset",
+            value: function reset() {
+                this.config = copyConfig(DISABLED_FLOOR_LADDER_CONFIG);
+                this.bounds = DEFAULT_FLOOR_LADDER_BOUNDS;
+            }
+        },
         {
             key: "get",
             value: function get() {
@@ -2078,13 +2131,6 @@ var FloorLadderController = /*#__PURE__*/ function() {
                 return _object_spread({}, this.bounds);
             }
         },
-        {
-            key: "update",
-            value: function update(update) {
-                this.config = mergeDefined(this.config, update);
-                return validateFloorLadderConfig(this.config, this.bounds);
-            }
-        },
         {
             key: "validate",
             value: function validate() {
@@ -6317,6 +6363,9 @@ function resolvePlayerIdentitySeed(clientInfo) {
     }
     return "fingerprint:".concat(JSON.stringify(clientInfo));
 }
+function getCachedBrowserId() {
+    return cachedBrowserId !== null && cachedBrowserId !== void 0 ? cachedBrowserId : void 0;
+}
 function getBrowserID(clientInfo) {
     return _async_to_generator(function() {
         return _ts_generator(this, function(_state) {
@@ -7986,7 +8035,7 @@ var AdConfigManager = /*#__PURE__*/ function() {
             key: "fetchAdConfiguration",
             value: function fetchAdConfiguration() {
                 return _async_to_generator(function() {
-                    var _data_response_ima_publisherdeskima, _data_response_ima, _data_response, _data_response_options_vast_cue_tones, _data_response_options_vast, _data_response_options, _data_response1, apiUrl, headers, response, data, imaPayload, decodedPayload, numberAds;
+                    var _data_response, _data_response1, _data_response2, _data_response_ima_publisherdeskima, _data_response_ima, _data_response3, _data_response_options_vast_cue_tones, _data_response_options_vast, _data_response_options, _data_response4, apiUrl, headers, response, data, apiEnableEdge, apiEdgeUrl, imaPayload, decodedPayload, numberAds;
                     return _ts_generator(this, function(_state) {
                         switch(_state.label){
                             case 0:
@@ -8046,7 +8095,21 @@ var AdConfigManager = /*#__PURE__*/ function() {
                                 ];
                             case 4:
                                 data = _state.sent();
-                                imaPayload = (_data_response = data.response) === null || _data_response === void 0 ? void 0 : (_data_response_ima = _data_response.ima) === null || _data_response_ima === void 0 ? void 0 : (_data_response_ima_publisherdeskima = _data_response_ima["publisherdesk.ima"]) === null || _data_response_ima_publisherdeskima === void 0 ? void 0 : _data_response_ima_publisherdeskima.payload;
+                                apiEnableEdge = (_data_response = data.response) === null || _data_response === void 0 ? void 0 : _data_response.enableEdgePodRequest;
+                                apiEdgeUrl = (_data_response1 = data.response) === null || _data_response1 === void 0 ? void 0 : _data_response1.edgePodUrl;
+                                this.apiEnableEdgePodRequest = typeof apiEnableEdge === "boolean" ? apiEnableEdge : void 0;
+                                this.apiEdgePodUrl = typeof apiEdgeUrl === "string" ? apiEdgeUrl : void 0;
+                                if (this.debug) {
+                                    console.log("[StormcloudVideoPlayer] Edge pod settings from API:", {
+                                        enableEdgePodRequest: this.apiEnableEdgePodRequest,
+                                        edgePodUrl: this.apiEdgePodUrl
+                                    });
+                                }
+                                this.apiFloorLadder = (_data_response2 = data.response) === null || _data_response2 === void 0 ? void 0 : _data_response2.floorLadder;
+                                if (this.debug) {
+                                    console.log(this.apiFloorLadder ? "[StormcloudVideoPlayer] Floor ladder from API:" : "[StormcloudVideoPlayer] No floorLadder block in /ads/web response", this.apiFloorLadder);
+                                }
+                                imaPayload = (_data_response3 = data.response) === null || _data_response3 === void 0 ? void 0 : (_data_response_ima = _data_response3.ima) === null || _data_response_ima === void 0 ? void 0 : (_data_response_ima_publisherdeskima = _data_response_ima["publisherdesk.ima"]) === null || _data_response_ima_publisherdeskima === void 0 ? void 0 : _data_response_ima_publisherdeskima.payload;
                                 if (imaPayload) {
                                     decodedPayload = imaPayload;
                                     try {
@@ -8064,7 +8127,7 @@ var AdConfigManager = /*#__PURE__*/ function() {
                                         console.warn("[StormcloudVideoPlayer] No VAST tag URL found in /ads/web response");
                                     }
                                 }
-                                numberAds = (_data_response1 = data.response) === null || _data_response1 === void 0 ? void 0 : (_data_response_options = _data_response1.options) === null || _data_response_options === void 0 ? void 0 : (_data_response_options_vast = _data_response_options.vast) === null || _data_response_options_vast === void 0 ? void 0 : (_data_response_options_vast_cue_tones = _data_response_options_vast.cue_tones) === null || _data_response_options_vast_cue_tones === void 0 ? void 0 : _data_response_options_vast_cue_tones.number_ads;
+                                numberAds = (_data_response4 = data.response) === null || _data_response4 === void 0 ? void 0 : (_data_response_options = _data_response4.options) === null || _data_response_options === void 0 ? void 0 : (_data_response_options_vast = _data_response_options.vast) === null || _data_response_options_vast === void 0 ? void 0 : (_data_response_options_vast_cue_tones = _data_response_options_vast.cue_tones) === null || _data_response_options_vast_cue_tones === void 0 ? void 0 : _data_response_options_vast_cue_tones.number_ads;
                                 if (numberAds != null && numberAds > 0) {
                                     this.apiNumberAds = numberAds;
                                     if (this.debug) {
@@ -9898,7 +9961,23 @@ function resolveEdgePodBaseUrl(config) {
         return void 0;
     }
 }
+function resolveEdgePodRequestContext(config) {
+    var extra = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
+    return {
+        width: extra.width,
+        height: extra.height,
+        playerId: extra.playerId,
+        contentNetwork: config.contentNetwork,
+        contentChannel: config.channelName,
+        contentTitle: config.programTitle
+    };
+}
+function setOptionalParam(url, key, value) {
+    var trimmed = value === null || value === void 0 ? void 0 : value.trim();
+    if (trimmed) url.searchParams.set(key, trimmed);
+}
 function buildEdgePodUrl(baseUrl, remainingMs, remainingAdLimit) {
+    var context = arguments.length > 3 && arguments[3] !== void 0 ? arguments[3] : {};
     var url = new URL(baseUrl);
     var maxMs = Math.max(0, Math.floor(remainingMs));
     var maxAds = Math.max(1, Math.min(EDGE_POD_MAX_ADS, Math.floor(remainingAdLimit)));
@@ -9906,6 +9985,16 @@ function buildEdgePodUrl(baseUrl, remainingMs, remainingAdLimit) {
     url.searchParams.set("pmad", String(maxAds));
     url.searchParams.set("duration", String(Math.floor(maxMs / 1e3)));
     url.searchParams.set("count", String(maxAds));
+    if (context.width != null && Number.isFinite(context.width) && context.width > 0) {
+        url.searchParams.set("width", String(Math.round(context.width)));
+    }
+    if (context.height != null && Number.isFinite(context.height) && context.height > 0) {
+        url.searchParams.set("height", String(Math.round(context.height)));
+    }
+    setOptionalParam(url, "pid", context.playerId);
+    setOptionalParam(url, "cn", context.contentNetwork);
+    setOptionalParam(url, "cc", context.contentChannel);
+    setOptionalParam(url, "ct", context.contentTitle);
     return url.toString();
 }
 function classifyEdgeVastResponse(result) {
@@ -10793,7 +10882,12 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                     return void 0;
                 }
                 try {
-                    return buildEdgePodUrl(baseUrl, remainingMs, remainingAds);
+                    var playerId = getCachedBrowserId();
+                    return buildEdgePodUrl(baseUrl, remainingMs, remainingAds, resolveEdgePodRequestContext(this.host.config, {
+                        width: this.host.video.offsetWidth || this.host.video.clientWidth,
+                        height: this.host.video.offsetHeight || this.host.video.clientHeight,
+                        playerId: playerId
+                    }));
                 } catch (unused) {
                     this.markEdgeExhausted("invalid_edge_url");
                     return void 0;
@@ -12303,14 +12397,7 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
         this.config = _object_spread({}, browserOverrides, config);
         this.video = config.videoElement;
         logBrowserInfo(config.debugAdTiming);
-        var floorBounds = {};
-        if (this.config.adFloorMinCents != null) floorBounds.minCents = this.config.adFloorMinCents;
-        if (this.config.adFloorMaxCents != null) floorBounds.maxCents = this.config.adFloorMaxCents;
-        if (this.config.adFloorStepCents != null) floorBounds.stepCents = this.config.adFloorStepCents;
-        this.floorLadder = new FloorLadderController(this.config.adFloorLadder, floorBounds);
-        this.floorLadderEnabled = this.config.adFloorLadderEnabled === true;
-        this.warnOnInvalidFloorLadder(this.floorLadder.validate());
-        this.edgePodBaseUrl = resolveEdgePodBaseUrl(this.config);
+        this.floorLadder = new FloorLadderController();
         this.adPlayer = this.createAdPlayer(false);
         this.palNonce = createPalNonceManager();
         this.cueManager = new Scte35CueManager(!!this.config.debugAdTiming, {
@@ -12417,9 +12504,8 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
                 return _this.edgePodBaseUrl;
             },
             getFloorSnapshot: function getFloorSnapshot(position) {
-                return _this.floorLadderEnabled ? _this.floorLadder.snapshotFor({
-                    position: position,
-                    isCtv: _this.isCtvEnvironment()
+                return _this.floorLadder.isEnabled() ? _this.floorLadder.snapshotFor({
+                    position: position
                 }) : void 0;
             },
             onAdClick: function onAdClick() {
@@ -12456,45 +12542,42 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
             }
         },
         {
-            key: "isCtvEnvironment",
-            value: function isCtvEnvironment() {
-                if (this.config.ctvAdRequest) return true;
-                var hint = inferDeviceTypeHint(false);
-                return hint === DEVICE_TYPE_HINT.CONNECTED_TV || hint === DEVICE_TYPE_HINT.SET_TOP_BOX;
-            }
-        },
-        {
-            key: "setAdFloorLadder",
-            value: function setAdFloorLadder(update) {
-                var report = this.floorLadder.update(update);
+            key: "applyFloorLadderFromApi",
+            value: function applyFloorLadderFromApi() {
+                var raw = this.adConfig.apiFloorLadder;
+                if (raw == null) {
+                    this.floorLadder.reset();
+                    return;
+                }
+                var report = this.floorLadder.applyApiConfig(raw);
                 this.warnOnInvalidFloorLadder(report);
-                return report;
-            }
-        },
-        {
-            key: "setAdFloorLadderEnabled",
-            value: function setAdFloorLadderEnabled(enabled) {
-                this.floorLadderEnabled = enabled;
-                if (enabled) this.warnOnInvalidFloorLadder(this.floorLadder.validate());
+                if (this.debug) {
+                    console.log("[AdBreak][FLOOR] configuration applied from API", {
+                        config: this.floorLadder.get(),
+                        bounds: this.floorLadder.getBounds(),
+                        validation: report
+                    });
+                }
             }
         },
         {
             key: "isAdFloorLadderEnabled",
             value: function isAdFloorLadderEnabled() {
-                return this.floorLadderEnabled;
+                return this.floorLadder.isEnabled();
             }
         },
         {
-            key: "setEdgePodRequest",
-            value: function setEdgePodRequest(update) {
-                if (update.enableEdgePodRequest === this.config.enableEdgePodRequest && update.edgePodUrl === this.config.edgePodUrl) {
-                    return;
+            key: "applyEdgePodFromApi",
+            value: function applyEdgePodFromApi() {
+                this.edgePodBaseUrl = resolveEdgePodBaseUrl({
+                    enableEdgePodRequest: this.adConfig.apiEnableEdgePodRequest,
+                    edgePodUrl: this.adConfig.apiEdgePodUrl,
+                    licenseKey: this.config.licenseKey
+                });
+                if (this.debug) {
+                    var _this_edgePodBaseUrl;
+                    console.log("[AdBreak][EDGE] edge pod base URL from API:", (_this_edgePodBaseUrl = this.edgePodBaseUrl) !== null && _this_edgePodBaseUrl !== void 0 ? _this_edgePodBaseUrl : "(disabled; GAM only)");
                 }
-                if (update.enableEdgePodRequest === void 0) delete this.config.enableEdgePodRequest;
-                else this.config.enableEdgePodRequest = update.enableEdgePodRequest;
-                if (update.edgePodUrl === void 0) delete this.config.edgePodUrl;
-                else this.config.edgePodUrl = update.edgePodUrl;
-                this.edgePodBaseUrl = resolveEdgePodBaseUrl(this.config);
             }
         },
         {
@@ -12507,7 +12590,7 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
             key: "warnOnInvalidFloorLadder",
             value: function warnOnInvalidFloorLadder(report) {
                 var config = this.floorLadder.get();
-                if (report.ok || !this.floorLadderEnabled || !config.enabled) return;
+                if (report.ok || !config.enabled) return;
                 console.warn("[AdBreak][FLOOR] configuration has issues; invalid floors will not be sent", {
                     errors: report.errors,
                     configurationVersion: config.configurationVersion,
@@ -12582,6 +12665,8 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
                                     4
                                 ];
                             case 4:
+                                this.applyFloorLadderFromApi();
+                                this.applyEdgePodFromApi();
                                 palDescriptionUrl = this.config.ctvAdRequest ? this.adConfig.getPalDescriptionUrl() : void 0;
                                 fetchConsentSignals().catch(function() {
                                     return {};
@@ -13344,6 +13429,12 @@ var HlsPlayer = /*#__PURE__*/ function(_import_react_Component) {
                             if (_this1.props.adFailsafeTimeoutMs !== void 0) config.adFailsafeTimeoutMs = _this1.props.adFailsafeTimeoutMs;
                             if (_this1.props.minSegmentsBeforePlay !== void 0) config.minSegmentsBeforePlay = _this1.props.minSegmentsBeforePlay;
                             if (_this1.props.ctvAdRequest !== void 0) config.ctvAdRequest = _this1.props.ctvAdRequest;
+                            if (_this1.props.vastTagUrl !== void 0) config.vastTagUrl = _this1.props.vastTagUrl;
+                            if (_this1.props.isVmap !== void 0) config.isVmap = _this1.props.isVmap;
+                            if (_this1.props.vmapUrl !== void 0) config.vmapUrl = _this1.props.vmapUrl;
+                            if (_this1.props.minRemainingMsToRequestAd !== void 0) config.minRemainingMsToRequestAd = _this1.props.minRemainingMsToRequestAd;
+                            if (_this1.props.maxNoFillsPerBreak !== void 0) config.maxNoFillsPerBreak = _this1.props.maxNoFillsPerBreak;
+                            if (_this1.props.maxAdBreakExtensionMs !== void 0) config.maxAdBreakExtensionMs = _this1.props.maxAdBreakExtensionMs;
                             _this1.player = new StormcloudVideoPlayer(config);
                             (_this_props_onMount = (_this_props = _this1.props).onMount) === null || _this_props_onMount === void 0 ? void 0 : _this_props_onMount.call(_this_props, _this1);
                             return [