stormcloud-video-player 0.8.68 → 0.8.70

package/lib/player/AdBreakOrchestrator.d.cts

@@ -1,4 +1,5 @@
-import { Scte35Marker, StormcloudVideoPlayerConfig, AdController } from '../types.cjs';
+import { Scte35Marker, StormcloudVideoPlayerConfig, AdController, AdPosition } from '../types.cjs';
+import { OpportunityFloor } from './FloorLadder.cjs';
 import { AdTimingService } from './AdTimingService.cjs';
 import { AdConfigManager } from './AdConfigManager.cjs';
 import { Scte35CueManager } from './Scte35CueManager.cjs';
@@ -21,6 +22,9 @@ interface AdBreakOrchestratorHost {
     recoverMediaError(): void;
     requiresMediaPipelineResetAfterAds(): boolean;
     generatePodVastUrl(baseUrl: string, breakDurationMs?: number): string;
+    /** Validated Edge pod URL, or undefined when Edge-first is disabled. */
+    getEdgePodBaseUrl(): string | undefined;
+    getFloorSnapshot(position: AdPosition): OpportunityFloor | undefined;
     onAdClick(): void;
     onAdInteraction(event: MouseEvent | TouchEvent): void;
 }
@@ -45,6 +49,10 @@ declare class AdBreakOrchestrator {
     private requestStartedAt;
     private opportunityBreakKey;
     private opportunityEpoch;
+    private opportunityFloor;
+    private currentPodSource;
+    private edgeExhaustedForBreak;
+    private edgeRequestsInBreak;
     adPodQueue: string[];
     private readonly defaultMinRemainingMsToRequestAd;
     private readonly defaultMaxNoFillsPerBreak;
@@ -72,10 +80,23 @@ declare class AdBreakOrchestrator {
     clearPendingAdBreak(): void;
     isBreakActive(): boolean;
     getSlotState(): AdSlotState;
-    beginVmapBreak(breakKey: string): void;
+    beginVmapBreak(breakKey: string, position: AdPosition): void;
     handleAdStart(marker: Scte35Marker): Promise<void>;
     private waitForBreakDuration;
     private startOptimizedPod;
+    private resetEdgeStateForBreak;
+    private isLiveBreak;
+    private canRequestEdge;
+    private markEdgeExhausted;
+    /**
+     * Builds the next Edge request from the budget left right now, or marks Edge
+     * exhausted for this break. Synchronous on purpose: callers must reach the
+     * REQUESTING state in the same tick so a second completion event cannot race
+     * in a parallel request.
+     */
+    private prepareEdgePodRequest;
+    private runEdgePod;
+    private continueAfterEdgeOutcome;
     private setSlotState;
     private isStale;
     private getMinRemainingMsToRequestAd;
@@ -92,9 +113,12 @@ declare class AdBreakOrchestrator {
     private recordRequestDiagnostic;
     private finalizeRequestDiagnostics;
     private withCurrentPodBudget;
+    private opportunityFloorFields;
+    private requestFloorFields;
+    private applyOpportunityFloor;
     private countFunnelStage;
     private logOrchestratorFunnel;
-    noteOpportunity(source: "scte35" | "vmap", breakKey: string | undefined): void;
+    noteOpportunity(source: "scte35" | "vmap", breakKey: string | undefined, position: AdPosition): void;
     private beginFunnelRequest;
     isAdLoadingWithoutPlayback(): boolean;
     noteStopBeforeStart(reason: string): void;

package/lib/player/EdgePodRequest.cjs

@@ -0,0 +1,136 @@
+"use strict";
+function _type_of(obj) {
+    "@swc/helpers - typeof";
+    return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
+}
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = function __export(target, all) {
+    for(var name in all)__defProp(target, name, {
+        get: all[name],
+        enumerable: true
+    });
+};
+var __copyProps = function __copyProps(to, from, except, desc) {
+    if (from && (typeof from === "undefined" ? "undefined" : _type_of(from)) === "object" || typeof from === "function") {
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            var _loop = function() {
+                var key = _step.value;
+                if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+                    get: function get() {
+                        return from[key];
+                    },
+                    enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+                });
+            };
+            for(var _iterator = __getOwnPropNames(from)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true)_loop();
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
+            }
+        }
+    }
+    return to;
+};
+var __toCommonJS = function __toCommonJS(mod) {
+    return __copyProps(__defProp({}, "__esModule", {
+        value: true
+    }), mod);
+};
+// src/player/EdgePodRequest.ts
+var EdgePodRequest_exports = {};
+__export(EdgePodRequest_exports, {
+    EDGE_POD_EXCEEDS_BUDGET: function EDGE_POD_EXCEEDS_BUDGET1() {
+        return EDGE_POD_EXCEEDS_BUDGET;
+    },
+    EDGE_POD_MAX_ADS: function EDGE_POD_MAX_ADS1() {
+        return EDGE_POD_MAX_ADS;
+    },
+    buildEdgePodUrl: function buildEdgePodUrl1() {
+        return buildEdgePodUrl;
+    },
+    classifyEdgeVastResponse: function classifyEdgeVastResponse1() {
+        return classifyEdgeVastResponse;
+    },
+    describeEdgeUrl: function describeEdgeUrl1() {
+        return describeEdgeUrl;
+    },
+    resolveEdgePodBaseUrl: function resolveEdgePodBaseUrl1() {
+        return resolveEdgePodBaseUrl;
+    }
+});
+module.exports = __toCommonJS(EdgePodRequest_exports);
+var EDGE_POD_MAX_ADS = 10;
+var EDGE_POD_EXCEEDS_BUDGET = "edge_pod_exceeds_budget";
+function resolveEdgePodBaseUrl(config) {
+    var _config_edgePodUrl;
+    if (config.enableEdgePodRequest !== true) return void 0;
+    var raw = (_config_edgePodUrl = config.edgePodUrl) === null || _config_edgePodUrl === void 0 ? void 0 : _config_edgePodUrl.trim();
+    if (!raw) {
+        console.warn("[AdBreak][EDGE] enableEdgePodRequest is true but edgePodUrl is missing; using GAM only");
+        return void 0;
+    }
+    try {
+        var url = new URL(raw);
+        if (url.protocol !== "https:" && url.protocol !== "http:") {
+            throw new Error("unsupported protocol ".concat(url.protocol));
+        }
+        return url.toString();
+    } catch (unused) {
+        console.warn("[AdBreak][EDGE] edgePodUrl is not a valid http(s) URL; using GAM only");
+        return void 0;
+    }
+}
+function buildEdgePodUrl(baseUrl, remainingMs, remainingAdLimit) {
+    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)));
+    url.searchParams.set("pmxd", String(maxMs));
+    url.searchParams.set("pmad", String(maxAds));
+    url.searchParams.set("duration", String(Math.floor(maxMs / 1e3)));
+    url.searchParams.set("count", String(maxAds));
+    return url.toString();
+}
+function classifyEdgeVastResponse(result) {
+    var _ref;
+    var _result_error;
+    if (result.error == null) {
+        return result.podAdCount > 0 ? "fill" : "no_fill";
+    }
+    var message = (_ref = (_result_error = result.error) === null || _result_error === void 0 ? void 0 : _result_error.message) !== null && _ref !== void 0 ? _ref : String(result.error);
+    if (/no ads available|fill rejected|no media file|no ad loaded/i.test(message) || message.includes(EDGE_POD_EXCEEDS_BUDGET)) {
+        return "no_fill";
+    }
+    return "invalid";
+}
+function describeEdgeUrl(url) {
+    try {
+        var parsed = new URL(url);
+        return "".concat(parsed.origin).concat(parsed.pathname);
+    } catch (unused) {
+        var _url_split_;
+        return (_url_split_ = url.split("?")[0]) !== null && _url_split_ !== void 0 ? _url_split_ : "";
+    }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+    EDGE_POD_EXCEEDS_BUDGET: EDGE_POD_EXCEEDS_BUDGET,
+    EDGE_POD_MAX_ADS: EDGE_POD_MAX_ADS,
+    buildEdgePodUrl: buildEdgePodUrl,
+    classifyEdgeVastResponse: classifyEdgeVastResponse,
+    describeEdgeUrl: describeEdgeUrl,
+    resolveEdgePodBaseUrl: resolveEdgePodBaseUrl
+});
+//# sourceMappingURL=EdgePodRequest.cjs.map

package/lib/player/EdgePodRequest.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["d:\\project\\stormcloud-vp\\lib\\player\\EdgePodRequest.cjs"],"names":["__defProp","Object","defineProperty","__getOwnPropDesc","getOwnPropertyDescriptor","__getOwnPropNames","getOwnPropertyNames","__hasOwnProp","prototype","hasOwnProperty","__export","target","all","name","get","enumerable","__copyProps","to","from","except","desc","key","call","__toCommonJS","mod","value","EdgePodRequest_exports","EDGE_POD_EXCEEDS_BUDGET","EDGE_POD_MAX_ADS","buildEdgePodUrl","classifyEdgeVastResponse","describeEdgeUrl","resolveEdgePodBaseUrl","module","exports","config","enableEdgePodRequest","raw","edgePodUrl","trim","console","warn","url","URL","protocol","Error","toString","baseUrl","remainingMs","remainingAdLimit","maxMs","Math","max","floor","maxAds","min","searchParams","set","String","result","error","podAdCount","message","test","includes","parsed","origin","pathname","split"],"mappings":"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","sourcesContent":["\"use strict\";\nvar __defProp = Object.defineProperty;\nvar __getOwnPropDesc = Object.getOwnPropertyDescriptor;\nvar __getOwnPropNames = Object.getOwnPropertyNames;\nvar __hasOwnProp = Object.prototype.hasOwnProperty;\nvar __export = (target, all) => {\n  for (var name in all)\n    __defProp(target, name, { get: all[name], enumerable: true });\n};\nvar __copyProps = (to, from, except, desc) => {\n  if (from && typeof from === \"object\" || typeof from === \"function\") {\n    for (let key of __getOwnPropNames(from))\n      if (!__hasOwnProp.call(to, key) && key !== except)\n        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });\n  }\n  return to;\n};\nvar __toCommonJS = (mod) => __copyProps(__defProp({}, \"__esModule\", { value: true }), mod);\n\n// src/player/EdgePodRequest.ts\nvar EdgePodRequest_exports = {};\n__export(EdgePodRequest_exports, {\n  EDGE_POD_EXCEEDS_BUDGET: () => EDGE_POD_EXCEEDS_BUDGET,\n  EDGE_POD_MAX_ADS: () => EDGE_POD_MAX_ADS,\n  buildEdgePodUrl: () => buildEdgePodUrl,\n  classifyEdgeVastResponse: () => classifyEdgeVastResponse,\n  describeEdgeUrl: () => describeEdgeUrl,\n  resolveEdgePodBaseUrl: () => resolveEdgePodBaseUrl\n});\nmodule.exports = __toCommonJS(EdgePodRequest_exports);\nvar EDGE_POD_MAX_ADS = 10;\nvar EDGE_POD_EXCEEDS_BUDGET = \"edge_pod_exceeds_budget\";\nfunction resolveEdgePodBaseUrl(config) {\n  if (config.enableEdgePodRequest !== true) return void 0;\n  const raw = config.edgePodUrl?.trim();\n  if (!raw) {\n    console.warn(\n      \"[AdBreak][EDGE] enableEdgePodRequest is true but edgePodUrl is missing; using GAM only\"\n    );\n    return void 0;\n  }\n  try {\n    const url = new URL(raw);\n    if (url.protocol !== \"https:\" && url.protocol !== \"http:\") {\n      throw new Error(`unsupported protocol ${url.protocol}`);\n    }\n    return url.toString();\n  } catch {\n    console.warn(\"[AdBreak][EDGE] edgePodUrl is not a valid http(s) URL; using GAM only\");\n    return void 0;\n  }\n}\nfunction buildEdgePodUrl(baseUrl, remainingMs, remainingAdLimit) {\n  const url = new URL(baseUrl);\n  const maxMs = Math.max(0, Math.floor(remainingMs));\n  const maxAds = Math.max(1, Math.min(EDGE_POD_MAX_ADS, Math.floor(remainingAdLimit)));\n  url.searchParams.set(\"pmxd\", String(maxMs));\n  url.searchParams.set(\"pmad\", String(maxAds));\n  url.searchParams.set(\"duration\", String(Math.floor(maxMs / 1e3)));\n  url.searchParams.set(\"count\", String(maxAds));\n  return url.toString();\n}\nfunction classifyEdgeVastResponse(result) {\n  if (result.error == null) {\n    return result.podAdCount > 0 ? \"fill\" : \"no_fill\";\n  }\n  const message = result.error?.message ?? String(result.error);\n  if (/no ads available|fill rejected|no media file|no ad loaded/i.test(message) || message.includes(EDGE_POD_EXCEEDS_BUDGET)) {\n    return \"no_fill\";\n  }\n  return \"invalid\";\n}\nfunction describeEdgeUrl(url) {\n  try {\n    const parsed = new URL(url);\n    return `${parsed.origin}${parsed.pathname}`;\n  } catch {\n    return url.split(\"?\")[0] ?? \"\";\n  }\n}\n// Annotate the CommonJS export names for ESM import in node:\n0 && (module.exports = {\n  EDGE_POD_EXCEEDS_BUDGET,\n  EDGE_POD_MAX_ADS,\n  buildEdgePodUrl,\n  classifyEdgeVastResponse,\n  describeEdgeUrl,\n  resolveEdgePodBaseUrl\n});\n"]}

package/lib/player/EdgePodRequest.d.cts

@@ -0,0 +1,14 @@
+import { StormcloudVideoPlayerConfig } from '../types.cjs';
+
+declare const EDGE_POD_MAX_ADS = 10;
+type EdgePodClassification = "fill" | "no_fill" | "invalid";
+declare const EDGE_POD_EXCEEDS_BUDGET = "edge_pod_exceeds_budget";
+declare function resolveEdgePodBaseUrl(config: Pick<StormcloudVideoPlayerConfig, "enableEdgePodRequest" | "edgePodUrl">): string | undefined;
+declare function buildEdgePodUrl(baseUrl: string, remainingMs: number, remainingAdLimit: number): string;
+declare function classifyEdgeVastResponse(result: {
+    podAdCount: number;
+    error?: unknown;
+}): EdgePodClassification;
+declare function describeEdgeUrl(url: string): string;
+
+export { EDGE_POD_EXCEEDS_BUDGET, EDGE_POD_MAX_ADS, type EdgePodClassification, buildEdgePodUrl, classifyEdgeVastResponse, describeEdgeUrl, resolveEdgePodBaseUrl };