stormcloud-video-player 0.8.23 → 0.8.25

package/lib/player/AdBreakOrchestrator.cjs

@@ -376,8 +376,362 @@ function publishMQTT(topic, payload) {
         return false;
     }
 }
+// src/utils/vastEnvironmentSignals.ts
+var PLAYER_ID_STORAGE_KEY = "stormcloud.player.id";
+var DEVICE_ID_STORAGE_KEYS = [
+    "rdid",
+    "ifa",
+    "advertisingId",
+    "advertising_id",
+    "deviceAdvertisingId",
+    "aaid",
+    "adid",
+    "rida",
+    "tifa",
+    "lgudid"
+];
+function inferDeviceIdType() {
+    if (typeof navigator === "undefined") {
+        return void 0;
+    }
+    var ua = navigator.userAgent;
+    if (/Roku/i.test(ua)) return "rida";
+    if (/Tizen|Samsung/i.test(ua)) return "tifa";
+    if (/AppleTV|Apple TV/i.test(ua)) return "tvOS";
+    if (/AFT|Fire TV|Amazon/i.test(ua)) return "afai";
+    if (/Web0S|webOS|LG Browser|LGSTB|LGE/i.test(ua)) return "lgudid";
+    if (/Android|Google TV/i.test(ua)) return "aaid";
+    if (/iPhone|iPad|iPod/i.test(ua)) return "idfa";
+    return void 0;
+}
+function resolveNativeDeviceId() {
+    var bridgeSignals = readNativeBridgeSignals();
+    var platformDevice = readPlatformNativeDeviceId();
+    var deviceId = bridgeSignals.deviceId || readStoredDeviceId() || platformDevice.deviceId;
+    if (!deviceId || isMacroPlaceholder(deviceId) || isZeroedAdId(deviceId)) {
+        return void 0;
+    }
+    return deviceId;
+}
+function getOrCreateStoredUuid(storageKey) {
+    if (typeof window === "undefined") {
+        return void 0;
+    }
+    var existing = readStoredString(storageKey);
+    if (existing) {
+        return existing;
+    }
+    var id = createUuid();
+    try {
+        var _window_localStorage;
+        (_window_localStorage = window.localStorage) === null || _window_localStorage === void 0 ? void 0 : _window_localStorage.setItem(storageKey, id);
+    } catch (unused) {}
+    return id;
+}
+function createUuid() {
+    if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+        return crypto.randomUUID();
+    }
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, function(char) {
+        var value = Math.floor(Math.random() * 16);
+        var nibble = char === "x" ? value : value & 3 | 8;
+        return nibble.toString(16);
+    });
+}
+function readPlatformNativeDeviceId() {
+    if (typeof window === "undefined") return {};
+    try {
+        var _window_webapis;
+        var adinfo = (_window_webapis = window.webapis) === null || _window_webapis === void 0 ? void 0 : _window_webapis.adinfo;
+        if (adinfo) {
+            var tifa = typeof adinfo.getTIFA === "function" ? adinfo.getTIFA() : adinfo.tifa;
+            if (typeof tifa === "string" && tifa && !isMacroPlaceholder(tifa)) {
+                var lat = typeof adinfo.isLATEnabled === "function" ? adinfo.isLATEnabled() : void 0;
+                return _object_spread({
+                    deviceId: tifa,
+                    deviceIdType: "tifa"
+                }, typeof lat === "boolean" ? {
+                    limitAdTracking: lat
+                } : {});
+            }
+        }
+    } catch (unused) {}
+    try {
+        var webOSDev = window.webOSDev;
+        if (webOSDev) {
+            var _webOSDev_lgudid;
+            var lgudid = typeof webOSDev.LGUDID === "function" ? webOSDev.LGUDID() : (_webOSDev_lgudid = webOSDev.lgudid) !== null && _webOSDev_lgudid !== void 0 ? _webOSDev_lgudid : webOSDev.LGUDID;
+            if (typeof lgudid === "string" && lgudid) {
+                if (isZeroedAdId(lgudid)) {
+                    return {
+                        deviceIdType: "lgudid",
+                        limitAdTracking: true
+                    };
+                }
+                if (!isMacroPlaceholder(lgudid)) {
+                    return {
+                        deviceId: lgudid,
+                        deviceIdType: "lgudid",
+                        limitAdTracking: false
+                    };
+                }
+            }
+        }
+    } catch (unused) {}
+    try {
+        var roku = window.Roku;
+        if (roku) {
+            var rida = typeof roku.getPublisherUniqueId === "function" ? roku.getPublisherUniqueId() : roku.rida;
+            if (typeof rida === "string" && rida && !isMacroPlaceholder(rida)) {
+                return {
+                    deviceId: rida,
+                    deviceIdType: "rida",
+                    limitAdTracking: false
+                };
+            }
+        }
+    } catch (unused) {}
+    return {};
+}
+var ZEROED_AD_ID_PATTERNS = /* @__PURE__ */ new Set([
+    "38400000-8cf0-11bd-b23e-10b96e40000d",
+    "00000000-0000-0000-0000-000000000000"
+]);
+function isMacroPlaceholder(value) {
+    var t = value.trim();
+    return !t || /^(\[[^\]]*\]|\{[^}]*\}|%%[^%]*%%)$/.test(t) || /^(unknown|null|undefined|none|n\/a|\$\{[^}]+\})$/i.test(t) || ZEROED_AD_ID_PATTERNS.has(t.toLowerCase());
+}
+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){
+            var source = _step.value;
+            var contentUrl = readBridgeValue(source, [
+                "contentUrl",
+                "url",
+                "videoUrl",
+                "canonicalUrl"
+            ]) || void 0;
+            var appId = readBridgeValue(source, [
+                "appId",
+                "msid",
+                "applicationId",
+                "packageName"
+            ]) || void 0;
+            var appName = readBridgeValue(source, [
+                "appName",
+                "an",
+                "applicationName"
+            ]) || void 0;
+            var deviceId = readBridgeValue(source, [
+                "rdid",
+                "ifa",
+                "advertisingId",
+                "adId",
+                "deviceId",
+                "lgudid",
+                "LGUDID",
+                "tifa",
+                "rida",
+                "afai",
+                "aaid"
+            ]) || void 0;
+            if (!contentUrl && !deviceId && !appId && !appName) continue;
+            var deviceIdType = readBridgeValue(source, [
+                "idtype",
+                "deviceIdType",
+                "advertisingIdType",
+                "idType"
+            ]) || inferDeviceIdType();
+            var limitAdTracking = readBridgeBoolean(source, [
+                "is_lat",
+                "limitAdTracking",
+                "limitedAdTracking",
+                "lat"
+            ]);
+            return _object_spread({}, contentUrl ? {
+                contentUrl: contentUrl
+            } : {}, appId ? {
+                appId: appId
+            } : {}, appName ? {
+                appName: appName
+            } : {}, deviceId ? {
+                deviceId: deviceId
+            } : {}, deviceId && deviceIdType ? {
+                deviceIdType: deviceIdType
+            } : {}, deviceId && limitAdTracking != null ? {
+                limitAdTracking: limitAdTracking
+            } : {});
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return {};
+}
+function readBridgeValue(source, keys) {
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = keys[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var key = _step.value;
+            var value = source === null || source === void 0 ? void 0 : source[key];
+            if (typeof value === "string" && value) {
+                return value;
+            }
+            if (typeof value === "function") {
+                try {
+                    var result = value.call(source);
+                    if (typeof result === "string" && result) {
+                        return result;
+                    }
+                } catch (unused) {}
+            }
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return void 0;
+}
+function readBridgeBoolean(source, keys) {
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = keys[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var key = _step.value;
+            var value = source === null || source === void 0 ? void 0 : source[key];
+            var normalized = normalizeBoolean(value);
+            if (normalized != null) {
+                return normalized;
+            }
+            if (typeof value === "function") {
+                try {
+                    var result = normalizeBoolean(value.call(source));
+                    if (result != null) {
+                        return result;
+                    }
+                } catch (unused) {}
+            }
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return void 0;
+}
+function readStoredDeviceId() {
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = DEVICE_ID_STORAGE_KEYS[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var key = _step.value;
+            var value = readStoredString(key);
+            if (value) {
+                return value;
+            }
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return void 0;
+}
+function readStoredString(key) {
+    if (typeof window === "undefined") {
+        return void 0;
+    }
+    try {
+        var _window_localStorage;
+        var value = (_window_localStorage = window.localStorage) === null || _window_localStorage === void 0 ? void 0 : _window_localStorage.getItem(key);
+        return value || void 0;
+    } catch (unused) {
+        return void 0;
+    }
+}
+function normalizeBoolean(value) {
+    if (typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "number") {
+        return value === 1;
+    }
+    if (typeof value === "string") {
+        var normalized = value.toLowerCase();
+        if (normalized === "1" || normalized === "true" || normalized === "yes") {
+            return true;
+        }
+        if (normalized === "0" || normalized === "false" || normalized === "no") {
+            return false;
+        }
+    }
+    return void 0;
+}
 // src/utils/tracking.ts
 var cachedBrowserId = null;
+function buildAnalyticsContext(config) {
+    var context = {};
+    if (config.debugAdTiming) {
+        context.debugAdTiming = true;
+    }
+    if (config.isLiveStream !== void 0) {
+        context.inputStreamType = config.isLiveStream ? "live" : "vod";
+    }
+    return context;
+}
 function getClientInfo() {
     var _screen, _screen1, _screen2, _screen3, _screen_orientation, _screen4, _screen5, _window, _window1, _window_screen_orientation, _window_screen, _navigator_languages;
     var ua = navigator.userAgent;
@@ -520,19 +874,12 @@ function getClientInfo() {
         visibilityState: document.visibilityState
     };
 }
-function getBrowserID(clientInfo) {
+function sha256Hex(input) {
     return _async_to_generator(function() {
-        var _crypto_subtle, fingerprintString, encodedData, utf8, buffer, i, hashBuffer, hashHex, unused, hash, i1, char, fallbackHash, timestamp, random;
+        var _crypto_subtle, encodedData, utf8, buffer, i, hashBuffer, unused, hash, i1, char, fallbackHash, timestamp, random;
         return _ts_generator(this, function(_state) {
             switch(_state.label){
                 case 0:
-                    if (cachedBrowserId) {
-                        return [
-                            2,
-                            cachedBrowserId
-                        ];
-                    }
-                    fingerprintString = JSON.stringify(clientInfo);
                     if (!(typeof crypto !== "undefined" && ((_crypto_subtle = crypto.subtle) === null || _crypto_subtle === void 0 ? void 0 : _crypto_subtle.digest))) return [
                         3,
                         5
@@ -556,9 +903,9 @@ function getBrowserID(clientInfo) {
                 case 2:
                     _state.sent();
                     if (typeof TextEncoder !== "undefined") {
-                        encodedData = new TextEncoder().encode(fingerprintString);
+                        encodedData = new TextEncoder().encode(input);
                     } else {
-                        utf8 = unescape(encodeURIComponent(fingerprintString));
+                        utf8 = unescape(encodeURIComponent(input));
                         buffer = new Uint8Array(utf8.length);
                         for(i = 0; i < utf8.length; i++){
                             buffer[i] = utf8.charCodeAt(i);
@@ -571,13 +918,11 @@ function getBrowserID(clientInfo) {
                     ];
                 case 3:
                     hashBuffer = _state.sent();
-                    hashHex = Array.from(new Uint8Array(hashBuffer)).map(function(b) {
-                        return b.toString(16).padStart(2, "0");
-                    }).join("");
-                    cachedBrowserId = hashHex;
                     return [
                         2,
-                        hashHex
+                        Array.from(new Uint8Array(hashBuffer)).map(function(b) {
+                            return b.toString(16).padStart(2, "0");
+                        }).join("")
                     ];
                 case 4:
                     unused = _state.sent();
@@ -588,15 +933,50 @@ function getBrowserID(clientInfo) {
                     ];
                 case 5:
                     hash = 0;
-                    for(i1 = 0; i1 < fingerprintString.length; i1++){
-                        char = fingerprintString.charCodeAt(i1);
+                    for(i1 = 0; i1 < input.length; i1++){
+                        char = input.charCodeAt(i1);
                         hash = (hash << 5) - hash + char;
                         hash = hash & hash;
                     }
                     fallbackHash = Math.abs(hash).toString(16).padStart(8, "0");
                     timestamp = Date.now().toString(16).padStart(12, "0");
                     random = Math.random().toString(16).substring(2, 14).padStart(12, "0");
-                    cachedBrowserId = (fallbackHash + timestamp + random).padEnd(64, "0");
+                    return [
+                        2,
+                        (fallbackHash + timestamp + random).padEnd(64, "0")
+                    ];
+            }
+        });
+    })();
+}
+function resolvePlayerIdentitySeed(clientInfo) {
+    var nativeDeviceId = resolveNativeDeviceId();
+    if (nativeDeviceId) {
+        return "device:".concat(nativeDeviceId);
+    }
+    var persistedId = getOrCreateStoredUuid(PLAYER_ID_STORAGE_KEY);
+    if (persistedId) {
+        return "persisted:".concat(persistedId);
+    }
+    return "fingerprint:".concat(JSON.stringify(clientInfo));
+}
+function getBrowserID(clientInfo) {
+    return _async_to_generator(function() {
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    if (cachedBrowserId) {
+                        return [
+                            2,
+                            cachedBrowserId
+                        ];
+                    }
+                    return [
+                        4,
+                        sha256Hex(resolvePlayerIdentitySeed(clientInfo))
+                    ];
+                case 1:
+                    cachedBrowserId = _state.sent();
                     return [
                         2,
                         cachedBrowserId
@@ -610,19 +990,26 @@ function canPublish(licenseKey) {
 }
 function buildPlayerMetricEvent() {
     return _async_to_generator(function() {
-        var context, flags, _flags_captureAt, _flags_adLoaded, _flags_adDetect, clientInfo, playerId, captureAt;
+        var context, flags, _flags_captureAt, _flags_adLoaded, _flags_adDetect, clientInfo, debugAdTiming, playerId, captureAt;
         var _arguments = arguments;
         return _ts_generator(this, function(_state) {
             switch(_state.label){
                 case 0:
                     context = _arguments.length > 0 && _arguments[0] !== void 0 ? _arguments[0] : {}, flags = _arguments.length > 1 && _arguments[1] !== void 0 ? _arguments[1] : {};
                     clientInfo = getClientInfo();
+                    debugAdTiming = !!context.debugAdTiming;
+                    if (debugAdTiming) {
+                        console.log("[StormcloudVideoPlayer] clientInfo: ", JSON.stringify(clientInfo, null, 2));
+                    }
                     return [
                         4,
                         getBrowserID(clientInfo)
                     ];
                 case 1:
                     playerId = _state.sent();
+                    if (debugAdTiming) {
+                        console.log("[StormcloudVideoPlayer] playerId: ", playerId);
+                    }
                     captureAt = (_flags_captureAt = flags.captureAt) !== null && _flags_captureAt !== void 0 ? _flags_captureAt : /* @__PURE__ */ new Date().toISOString();
                     return [
                         2,
@@ -823,6 +1210,12 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                 return !!this.host.config.debugAdTiming;
             }
         },
+        {
+            key: "analyticsContext",
+            get: function get() {
+                return buildAnalyticsContext(this.host.config);
+            }
+        },
         {
             // ───────────────────────────────────────────────────────────────
             //  IMA event listeners
@@ -836,7 +1229,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                         source: "hls",
                         adIndex: _this.timing.currentAdIndex,
                         timestamp: /* @__PURE__ */ new Date().toISOString()
-                    }).catch(function() {});
+                    }, _this.analyticsContext).catch(function() {});
                     _this.timing.recordPlayedAdDuration(_this.host.getAdPlayer());
                     var remaining = _this.timing.getRemainingAdMs();
                     _this.timing.consecutiveFailures = 0;
@@ -898,7 +1291,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                         source: "hls",
                         adIndex: _this.timing.currentAdIndex,
                         timestamp: /* @__PURE__ */ new Date().toISOString()
-                    }).catch(function() {});
+                    }, _this.analyticsContext).catch(function() {});
                     if (!_this.host.video.muted) {
                         _this.host.video.muted = true;
                         if (_this.debug) {
@@ -1045,7 +1438,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                         source: "hls",
                                         vastUrl: firstAdUrl,
                                         timestamp: /* @__PURE__ */ new Date().toISOString()
-                                    }).catch(function() {});
+                                    }, this.analyticsContext).catch(function() {});
                                     if (this.debug) {
                                         console.log("[CONTINUOUS-FETCH] Using preloaded ad from pool (preloaded in advance, ready immediately!)");
                                     }
@@ -1159,7 +1552,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                     source: "hls",
                                     vastUrl: firstAdUrl,
                                     timestamp: /* @__PURE__ */ new Date().toISOString()
-                                }).catch(function() {});
+                                }, this.analyticsContext).catch(function() {});
                                 if (this.debug) {
                                     console.log("[CONTINUOUS-FETCH] First ad request successful, starting playback");
                                 }
@@ -1623,7 +2016,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                     source: "hls",
                                     vastUrl: preloaded.vastUrl,
                                     timestamp: /* @__PURE__ */ new Date().toISOString()
-                                }).catch(function() {});
+                                }, this.analyticsContext).catch(function() {});
                                 _state.label = 1;
                             case 1:
                                 _state.trys.push([
@@ -1856,7 +2249,7 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                                     source: "hls",
                                     vastUrl: vastTagUrl,
                                     timestamp: /* @__PURE__ */ new Date().toISOString()
-                                }).catch(function() {});
+                                }, this.analyticsContext).catch(function() {});
                                 this.timing.clearAdRequestWatchdog();
                                 if (this.timing.activeAdRequestToken !== requestToken) return [
                                     2