stormcloud-video-player 0.8.24 → 0.8.25

package/lib/index.d.cts

@@ -108,6 +108,7 @@ interface TrackingData extends ClientInfo {
 }
 interface PlayerAnalyticsContext {
     inputStreamType?: string;
+    debugAdTiming?: boolean;
 }
 interface HeartbeatData {
     browserId: string;
@@ -3924,6 +3925,7 @@ declare const IS_SAFARI: boolean;
 declare const SUPPORTS_HLS: () => boolean;
 declare const SUPPORTS_DASH: () => boolean;
 
+declare function buildAnalyticsContext(config: Pick<StormcloudVideoPlayerConfig, "debugAdTiming" | "isLiveStream">): PlayerAnalyticsContext;
 declare function getClientInfo(): ClientInfo;
 declare function getBrowserID(clientInfo: ClientInfo): Promise<string>;
 type PlayerMetricFlags = {
@@ -4035,4 +4037,4 @@ interface PalNonceManager {
 }
 declare function createPalNonceManager(): PalNonceManager;
 
-export { type AdBreak, type AdController, type AdControllerOptions, type AdDetectInfo, type AdImpressionInfo, type AdLoadedInfo, type AdSchedule, type BaseStormcloudPlayerProps, type BrowserInfo, type ClientInfo, DEFAULT_MQTT_CONFIG, type HeartbeatData, IS_BROWSER, IS_GLOBAL, IS_IOS, IS_SAFARI, type ImaController, type ImaControllerOptions, type LateJoinPolicy, type MQTTConfig, type MQTTStatus, MQTT_CA_CERT_FILE, type OnProgressProps, type PalNonceManager, type PalNonceOptions, type PlayerAnalyticsContext, SUPPORTS_DASH, SUPPORTS_HLS, StormcloudPlayer, StormcloudVideoPlayer, StormcloudVideoPlayerComponent, type StormcloudVideoPlayerConfig, type StormcloudVideoPlayerProps, type TrackingData, applyMQTTConfig, buildMQTTBrokerUrl, buildPlayerTopic, canPlay, configureMQTT, createHlsAdPlayer, createPalNonceManager, createStormcloudPlayer, StormcloudVideoPlayerComponent as default, detectBrowser, disconnectMQTT, ensureMQTTClient, getBrowserConfigOverrides, getBrowserID, getClientInfo, getMQTTStatus, initMQTTClient, initializePolyfills, isMQTTConfigured, isMQTTConnected, isMQTTEnabled, isMediaStream, lazy, logBrowserInfo, merge, mqttConfig, omit, parseQuery, players, publishMQTT, randomString, sendAdDetectTracking, sendAdImpressionTracking, sendAdLoadedTracking, sendHeartbeat, sendInitialTracking, supportsFeature, supportsModernJS, supportsWebKitPresentationMode };
+export { type AdBreak, type AdController, type AdControllerOptions, type AdDetectInfo, type AdImpressionInfo, type AdLoadedInfo, type AdSchedule, type BaseStormcloudPlayerProps, type BrowserInfo, type ClientInfo, DEFAULT_MQTT_CONFIG, type HeartbeatData, IS_BROWSER, IS_GLOBAL, IS_IOS, IS_SAFARI, type ImaController, type ImaControllerOptions, type LateJoinPolicy, type MQTTConfig, type MQTTStatus, MQTT_CA_CERT_FILE, type OnProgressProps, type PalNonceManager, type PalNonceOptions, type PlayerAnalyticsContext, SUPPORTS_DASH, SUPPORTS_HLS, StormcloudPlayer, StormcloudVideoPlayer, StormcloudVideoPlayerComponent, type StormcloudVideoPlayerConfig, type StormcloudVideoPlayerProps, type TrackingData, applyMQTTConfig, buildAnalyticsContext, buildMQTTBrokerUrl, buildPlayerTopic, canPlay, configureMQTT, createHlsAdPlayer, createPalNonceManager, createStormcloudPlayer, StormcloudVideoPlayerComponent as default, detectBrowser, disconnectMQTT, ensureMQTTClient, getBrowserConfigOverrides, getBrowserID, getClientInfo, getMQTTStatus, initMQTTClient, initializePolyfills, isMQTTConfigured, isMQTTConnected, isMQTTEnabled, isMediaStream, lazy, logBrowserInfo, merge, mqttConfig, omit, parseQuery, players, publishMQTT, randomString, sendAdDetectTracking, sendAdImpressionTracking, sendAdLoadedTracking, sendHeartbeat, sendInitialTracking, supportsFeature, supportsModernJS, supportsWebKitPresentationMode };

package/lib/index.d.ts

@@ -108,6 +108,7 @@ interface TrackingData extends ClientInfo {
 }
 interface PlayerAnalyticsContext {
     inputStreamType?: string;
+    debugAdTiming?: boolean;
 }
 interface HeartbeatData {
     browserId: string;
@@ -3924,6 +3925,7 @@ declare const IS_SAFARI: boolean;
 declare const SUPPORTS_HLS: () => boolean;
 declare const SUPPORTS_DASH: () => boolean;
 
+declare function buildAnalyticsContext(config: Pick<StormcloudVideoPlayerConfig, "debugAdTiming" | "isLiveStream">): PlayerAnalyticsContext;
 declare function getClientInfo(): ClientInfo;
 declare function getBrowserID(clientInfo: ClientInfo): Promise<string>;
 type PlayerMetricFlags = {
@@ -4035,4 +4037,4 @@ interface PalNonceManager {
 }
 declare function createPalNonceManager(): PalNonceManager;
 
-export { type AdBreak, type AdController, type AdControllerOptions, type AdDetectInfo, type AdImpressionInfo, type AdLoadedInfo, type AdSchedule, type BaseStormcloudPlayerProps, type BrowserInfo, type ClientInfo, DEFAULT_MQTT_CONFIG, type HeartbeatData, IS_BROWSER, IS_GLOBAL, IS_IOS, IS_SAFARI, type ImaController, type ImaControllerOptions, type LateJoinPolicy, type MQTTConfig, type MQTTStatus, MQTT_CA_CERT_FILE, type OnProgressProps, type PalNonceManager, type PalNonceOptions, type PlayerAnalyticsContext, SUPPORTS_DASH, SUPPORTS_HLS, StormcloudPlayer, StormcloudVideoPlayer, StormcloudVideoPlayerComponent, type StormcloudVideoPlayerConfig, type StormcloudVideoPlayerProps, type TrackingData, applyMQTTConfig, buildMQTTBrokerUrl, buildPlayerTopic, canPlay, configureMQTT, createHlsAdPlayer, createPalNonceManager, createStormcloudPlayer, StormcloudVideoPlayerComponent as default, detectBrowser, disconnectMQTT, ensureMQTTClient, getBrowserConfigOverrides, getBrowserID, getClientInfo, getMQTTStatus, initMQTTClient, initializePolyfills, isMQTTConfigured, isMQTTConnected, isMQTTEnabled, isMediaStream, lazy, logBrowserInfo, merge, mqttConfig, omit, parseQuery, players, publishMQTT, randomString, sendAdDetectTracking, sendAdImpressionTracking, sendAdLoadedTracking, sendHeartbeat, sendInitialTracking, supportsFeature, supportsModernJS, supportsWebKitPresentationMode };
+export { type AdBreak, type AdController, type AdControllerOptions, type AdDetectInfo, type AdImpressionInfo, type AdLoadedInfo, type AdSchedule, type BaseStormcloudPlayerProps, type BrowserInfo, type ClientInfo, DEFAULT_MQTT_CONFIG, type HeartbeatData, IS_BROWSER, IS_GLOBAL, IS_IOS, IS_SAFARI, type ImaController, type ImaControllerOptions, type LateJoinPolicy, type MQTTConfig, type MQTTStatus, MQTT_CA_CERT_FILE, type OnProgressProps, type PalNonceManager, type PalNonceOptions, type PlayerAnalyticsContext, SUPPORTS_DASH, SUPPORTS_HLS, StormcloudPlayer, StormcloudVideoPlayer, StormcloudVideoPlayerComponent, type StormcloudVideoPlayerConfig, type StormcloudVideoPlayerProps, type TrackingData, applyMQTTConfig, buildAnalyticsContext, buildMQTTBrokerUrl, buildPlayerTopic, canPlay, configureMQTT, createHlsAdPlayer, createPalNonceManager, createStormcloudPlayer, StormcloudVideoPlayerComponent as default, detectBrowser, disconnectMQTT, ensureMQTTClient, getBrowserConfigOverrides, getBrowserID, getClientInfo, getMQTTStatus, initMQTTClient, initializePolyfills, isMQTTConfigured, isMQTTConnected, isMQTTEnabled, isMediaStream, lazy, logBrowserInfo, merge, mqttConfig, omit, parseQuery, players, publishMQTT, randomString, sendAdDetectTracking, sendAdImpressionTracking, sendAdLoadedTracking, sendHeartbeat, sendInitialTracking, supportsFeature, supportsModernJS, supportsWebKitPresentationMode };

package/lib/index.js

@@ -1990,6 +1990,16 @@ function normalizeBoolean(value) {
 }
 // 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;
@@ -2248,19 +2258,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,
@@ -4932,7 +4949,7 @@ var AdConfigManager = /*#__PURE__*/ function() {
             key: "initializeTracking",
             value: function initializeTracking() {
                 var _this = this;
-                sendInitialTracking(this.config.licenseKey).then(function() {
+                sendInitialTracking(this.config.licenseKey, buildAnalyticsContext(this.config)).then(function() {
                     _this.heartbeatInterval = window.setInterval(function() {
                         _this.sendHeartbeatIfNeeded();
                     }, 5e3);
@@ -4953,7 +4970,7 @@ var AdConfigManager = /*#__PURE__*/ function() {
                 var now = Date.now();
                 if (!this.lastHeartbeatTime || now - this.lastHeartbeatTime > 3e4) {
                     this.lastHeartbeatTime = now;
-                    sendHeartbeat(this.config.licenseKey).catch(function(error) {
+                    sendHeartbeat(this.config.licenseKey, buildAnalyticsContext(this.config)).catch(function(error) {
                         if (_this.debug) {
                             console.warn("[StormcloudVideoPlayer] Failed to send heartbeat:", error);
                         }
@@ -6738,6 +6755,12 @@ var AdBreakOrchestrator = /*#__PURE__*/ function() {
                 return !!this.host.config.debugAdTiming;
             }
         },
+        {
+            key: "analyticsContext",
+            get: function get() {
+                return buildAnalyticsContext(this.host.config);
+            }
+        },
         {
             // ───────────────────────────────────────────────────────────────
             //  IMA event listeners
@@ -6751,7 +6774,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;
@@ -6813,7 +6836,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) {
@@ -6960,7 +6983,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!)");
                                     }
@@ -7074,7 +7097,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");
                                 }
@@ -7538,7 +7561,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([
@@ -7771,7 +7794,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
@@ -8564,7 +8587,7 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
                         sendAdDetectTracking(this.config.licenseKey, _object_spread({
                             source: "scte35",
                             timestamp: /* @__PURE__ */ new Date().toISOString()
-                        }, detectPayload)).catch(function() {});
+                        }, detectPayload), buildAnalyticsContext(this.config)).catch(function() {});
                     }
                     var hasPrefetchedAds = this.adBreak.pendingAdBreak && this.adBreak.pendingAdBreak.vastUrls.length > 0;
                     var durationMs = marker.durationSeconds != null ? marker.durationSeconds * 1e3 : ((_this_adBreak_pendingAdBreak = this.adBreak.pendingAdBreak) === null || _this_adBreak_pendingAdBreak === void 0 ? void 0 : _this_adBreak_pendingAdBreak.marker.durationSeconds) != null ? this.adBreak.pendingAdBreak.marker.durationSeconds * 1e3 : void 0;
@@ -8737,7 +8760,7 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
                 sendAdDetectTracking(this.config.licenseKey, _object_spread({
                     source: "scte35",
                     timestamp: /* @__PURE__ */ new Date().toISOString()
-                }, detectPayload)).catch(function() {});
+                }, detectPayload), buildAnalyticsContext(this.config)).catch(function() {});
                 if (this.debug) {
                     console.log("[PREFETCH] Starting ad prefetch for upcoming ad break");
                     console.log("[PREFETCH] Pre-generated ".concat(generatedUrls.length, " VAST URLs"));
@@ -11539,5 +11562,5 @@ var createStormcloudPlayer = function createStormcloudPlayer(playerList, fallbac
 };
 var StormcloudPlayer = createStormcloudPlayer(players_default, players_default[players_default.length - 1]);
 var StormcloudPlayer_default = StormcloudPlayer;
-export { DEFAULT_MQTT_CONFIG, IS_BROWSER, IS_GLOBAL, IS_IOS, IS_SAFARI, MQTT_CA_CERT_FILE, SUPPORTS_DASH, SUPPORTS_HLS, StormcloudPlayer_default as StormcloudPlayer, StormcloudVideoPlayer, StormcloudVideoPlayerComponent, applyMQTTConfig, buildMQTTBrokerUrl, buildPlayerTopic, canPlay, configureMQTT, createHlsAdPlayer, createPalNonceManager, createStormcloudPlayer, StormcloudVideoPlayerComponent as default, detectBrowser, disconnectMQTT, ensureMQTTClient, getBrowserConfigOverrides, getBrowserID, getClientInfo, getMQTTStatus, initMQTTClient, initializePolyfills, isMQTTConfigured, isMQTTConnected, isMQTTEnabled, isMediaStream, lazy, logBrowserInfo, merge, mqttConfig, omit, parseQuery, players_default as players, publishMQTT, randomString, sendAdDetectTracking, sendAdImpressionTracking, sendAdLoadedTracking, sendHeartbeat, sendInitialTracking, supportsFeature, supportsModernJS, supportsWebKitPresentationMode };
+export { DEFAULT_MQTT_CONFIG, IS_BROWSER, IS_GLOBAL, IS_IOS, IS_SAFARI, MQTT_CA_CERT_FILE, SUPPORTS_DASH, SUPPORTS_HLS, StormcloudPlayer_default as StormcloudPlayer, StormcloudVideoPlayer, StormcloudVideoPlayerComponent, applyMQTTConfig, buildAnalyticsContext, buildMQTTBrokerUrl, buildPlayerTopic, canPlay, configureMQTT, createHlsAdPlayer, createPalNonceManager, createStormcloudPlayer, StormcloudVideoPlayerComponent as default, detectBrowser, disconnectMQTT, ensureMQTTClient, getBrowserConfigOverrides, getBrowserID, getClientInfo, getMQTTStatus, initMQTTClient, initializePolyfills, isMQTTConfigured, isMQTTConnected, isMQTTEnabled, isMediaStream, lazy, logBrowserInfo, merge, mqttConfig, omit, parseQuery, players_default as players, publishMQTT, randomString, sendAdDetectTracking, sendAdImpressionTracking, sendAdLoadedTracking, sendHeartbeat, sendInitialTracking, supportsFeature, supportsModernJS, supportsWebKitPresentationMode };
 //# sourceMappingURL=index.js.map