@amplitude/analytics-core 2.44.2-SR-3115-rc2.0 → 2.46.0

package/lib/esm/video-analytics/track-video.js

@@ -1,32 +1,22 @@
 import { __assign, __awaiter, __generator, __read } from "tslib";
-function getPlayData(videoEl) {
-    return {
-        program_duration: videoEl.duration,
-    };
-}
 function calculatePercentCompleted(currentTime, duration) {
     var percentCompleted = 0;
     if (Number.isFinite(currentTime) && Number.isFinite(duration) && duration > 0) {
         var rawPercent = (currentTime / duration) * 100;
-        // Clamp to [0, 100] to avoid invalid analytics values.
         percentCompleted = Math.min(100, Math.max(0, rawPercent));
     }
     return percentCompleted;
 }
-function getPauseData(videoEl) {
+function getVideoData(videoEl, stopReason) {
     var currentTime = videoEl.currentTime;
     var duration = videoEl.duration;
-    return __assign(__assign({}, getPlayData(videoEl)), { last_position: currentTime, percent_completed: calculatePercentCompleted(currentTime, duration) });
-}
-function getEndData(videoEl) {
-    return __assign({}, getPauseData(videoEl));
+    return __assign({ duration: duration, start_time: currentTime, last_position: currentTime, percent_completed: calculatePercentCompleted(currentTime, duration) }, (stopReason !== undefined ? { stop_reason: stopReason } : {}));
 }
 function getMuxMetadata(videoEl) {
     return {
         mux_playback_id: videoEl.getAttribute('playback-id'),
         mux_video_id: videoEl.getAttribute('metadata-video-id'),
         mux_video_title: videoEl.getAttribute('metadata-video-title'),
-        mux_session_id: videoEl.getAttribute('session-id'),
     };
 }
 /**
@@ -38,39 +28,64 @@ function getMuxMetadata(videoEl) {
  */
 export function trackHtmlVideo(videoEl, handlers, vendor) {
     var playHandler = function () {
-        var startEvent = __assign(__assign({}, getPlayData(videoEl)), (vendor === 'mux' ? getMuxMetadata(videoEl) : {}));
+        var startEvent = __assign(__assign({}, getVideoData(videoEl)), (vendor === 'mux' ? getMuxMetadata(videoEl) : {}));
         handlers.onPlay(startEvent);
     };
     videoEl.addEventListener('play', playHandler);
     var pauseHandler = function () {
-        var pauseEvent = __assign(__assign({}, getPauseData(videoEl)), (vendor === 'mux' ? getMuxMetadata(videoEl) : {}));
+        var pauseEvent = __assign(__assign({}, getVideoData(videoEl, 'paused')), (vendor === 'mux' ? getMuxMetadata(videoEl) : {}));
         handlers.onPause(pauseEvent);
     };
     videoEl.addEventListener('pause', pauseHandler);
     var endedHandler = function () {
-        var endedEvent = __assign(__assign({}, getEndData(videoEl)), (vendor === 'mux' ? getMuxMetadata(videoEl) : {}));
+        var endedEvent = __assign(__assign({}, getVideoData(videoEl, 'ended')), (vendor === 'mux' ? getMuxMetadata(videoEl) : {}));
         handlers.onEnded(endedEvent);
     };
     videoEl.addEventListener('ended', endedHandler);
+    var seekingHandler = function () {
+        var seekingEvent = __assign(__assign({}, getVideoData(videoEl, 'seeking')), (vendor === 'mux' ? getMuxMetadata(videoEl) : {}));
+        handlers.onSeeking(seekingEvent);
+    };
+    videoEl.addEventListener('seeking', seekingHandler);
+    var seekedHandler = function () {
+        var seekedEvent = __assign(__assign({}, getVideoData(videoEl)), (vendor === 'mux' ? getMuxMetadata(videoEl) : {}));
+        handlers.onSeeked(seekedEvent);
+    };
+    videoEl.addEventListener('seeked', seekedHandler);
+    var timeupdateHandler = function () {
+        var media = videoEl;
+        var timeupdateEvent = {
+            position: videoEl.currentTime,
+            isSeeking: !!media.seeking,
+        };
+        handlers.onTimeUpdate(timeupdateEvent);
+    };
+    videoEl.addEventListener('timeupdate', timeupdateHandler);
     return function () {
         videoEl.removeEventListener('play', playHandler);
         videoEl.removeEventListener('pause', pauseHandler);
         videoEl.removeEventListener('ended', endedHandler);
+        videoEl.removeEventListener('seeking', seekingHandler);
+        videoEl.removeEventListener('seeked', seekedHandler);
+        videoEl.removeEventListener('timeupdate', timeupdateHandler);
     };
 }
-/**
- * Track a Mux HTML video element.
- *
- * @param videoEl - The HTML Mux video element to track.
- * @param handlers - The video handlers to call when on video lifecycle events.
- * @returns A function to untrack the video.
- */
-export function trackMuxHtmlVideo(videoEl, handlers) {
-    return trackHtmlVideo(videoEl, handlers, 'mux');
+function getTimeUpdateInfo(player) {
+    return __awaiter(this, void 0, void 0, function () {
+        var currentTime;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, new Promise(function (resolve) { return player.getCurrentTime(resolve); })];
+                case 1:
+                    currentTime = _a.sent();
+                    return [2 /*return*/, { currentTime: currentTime }];
+            }
+        });
+    });
 }
-function getMuxIframeMetadata(player, elem) {
+function getIframeMetadata(player, elem, vendor, stopReason) {
     return __awaiter(this, void 0, void 0, function () {
-        var _a, duration, currentTime, url, metadataVideoTitle, metadataVideoId, playerId;
+        var _a, duration, currentTime, vendorMetadata, url;
         return __generator(this, function (_b) {
             switch (_b.label) {
                 case 0: return [4 /*yield*/, Promise.all([
@@ -79,68 +94,103 @@ function getMuxIframeMetadata(player, elem) {
                     ])];
                 case 1:
                     _a = __read.apply(void 0, [_b.sent(), 2]), duration = _a[0], currentTime = _a[1];
-                    metadataVideoTitle = null, metadataVideoId = null, playerId = null;
-                    try {
-                        url = new URL(elem.getAttribute('src'));
-                        metadataVideoTitle = url.searchParams.get('metadata-video-title');
-                        metadataVideoId = url.searchParams.get('metadata-video-id');
-                        playerId = url.pathname.split('/').pop();
+                    vendorMetadata = {};
+                    if (vendor === 'mux') {
+                        url = void 0;
+                        try {
+                            url = new URL(elem.getAttribute('src'));
+                            vendorMetadata.mux_video_title = url.searchParams.get('metadata-video-title');
+                            vendorMetadata.mux_video_id = url.searchParams.get('metadata-video-id');
+                            vendorMetadata.mux_playback_id = url.pathname.split('/').pop();
+                        }
+                        catch (error) {
+                            // invalid or no src url, skip the header metadata
+                        }
                     }
-                    catch (error) {
-                        // invalid or no src url, skip the header metadata
-                    }
-                    return [2 /*return*/, {
-                            percent_completed: calculatePercentCompleted(currentTime, duration),
-                            program_duration: duration,
-                            last_position: currentTime,
-                            mux_video_title: metadataVideoTitle,
-                            mux_video_id: metadataVideoId,
-                            mux_playback_id: playerId,
-                        }];
+                    return [2 /*return*/, __assign(__assign({ duration: duration, start_time: currentTime, last_position: currentTime, percent_completed: calculatePercentCompleted(currentTime, duration) }, (stopReason !== undefined ? { stop_reason: stopReason } : {})), vendorMetadata)];
             }
         });
     });
 }
-export function trackMuxEmbeddedVideo(player, handlers) {
+export function trackEmbeddedVideo(player, handlers, vendor) {
+    if (vendor === void 0) { vendor = null; }
     var onUnsubscribe = [];
     var readyHandler = function () {
         var elem = player.elem;
+        var isSeeking = false;
         var playHandler = function () {
-            getMuxIframeMetadata(player, elem)
+            getIframeMetadata(player, elem, vendor)
                 .then(function (playerState) {
-                var startEvent = __assign({}, playerState);
-                handlers.onPlay(startEvent);
+                handlers.onPlay(playerState);
             })
                 .catch(function (error) {
-                handlers.onError("Error getting Mux iframe metadata from 'play' handler: ".concat(error));
+                handlers.onError("Error getting iframe metadata from 'play' handler: ".concat(error));
             });
         };
         player.on('play', playHandler);
         onUnsubscribe.push(function () { return player.off('play', playHandler); });
         var pauseHandler = function () {
-            getMuxIframeMetadata(player, elem)
+            getIframeMetadata(player, elem, vendor, 'paused')
                 .then(function (playerState) {
-                var pauseEvent = __assign({}, playerState);
-                handlers.onPause(pauseEvent);
+                handlers.onPause(playerState);
             })
                 .catch(function (error) {
-                handlers.onError("Error getting Mux iframe metadata from 'pause' handler: ".concat(error));
+                handlers.onError("Error getting iframe metadata from 'pause' handler: ".concat(error));
             });
         };
         player.on('pause', pauseHandler);
         onUnsubscribe.push(function () { return player.off('pause', pauseHandler); });
         var endedHandler = function () {
-            getMuxIframeMetadata(player, elem)
+            getIframeMetadata(player, elem, vendor, 'ended')
                 .then(function (playerState) {
-                var endedEvent = __assign({}, playerState);
-                handlers.onEnded(endedEvent);
+                handlers.onEnded(playerState);
             })
                 .catch(function (error) {
-                handlers.onError("Error getting Mux iframe metadata from 'ended' handler: ".concat(error));
+                handlers.onError("Error getting iframe metadata from 'ended' handler: ".concat(error));
             });
         };
         player.on('ended', endedHandler);
         onUnsubscribe.push(function () { return player.off('ended', endedHandler); });
+        var seekingHandler = function () {
+            isSeeking = true;
+            getIframeMetadata(player, elem, vendor, 'seeking')
+                .then(function (playerState) {
+                handlers.onSeeking(playerState);
+            })
+                .catch(function (error) {
+                handlers.onError("Error getting iframe metadata from 'seeking' handler: ".concat(error));
+            });
+        };
+        player.on('seeking', seekingHandler);
+        onUnsubscribe.push(function () { return player.off('seeking', seekingHandler); });
+        var seekedHandler = function () {
+            isSeeking = false;
+            getIframeMetadata(player, elem, vendor)
+                .then(function (playerState) {
+                handlers.onSeeked(playerState);
+            })
+                .catch(function (error) {
+                handlers.onError("Error getting iframe metadata from 'seeked' handler: ".concat(error));
+            });
+        };
+        player.on('seeked', seekedHandler);
+        onUnsubscribe.push(function () { return player.off('seeked', seekedHandler); });
+        var timeupdateHandler = function () {
+            getTimeUpdateInfo(player)
+                .then(function (_a) {
+                var currentTime = _a.currentTime;
+                var timeupdateEvent = {
+                    position: currentTime,
+                    isSeeking: isSeeking,
+                };
+                handlers.onTimeUpdate(timeupdateEvent);
+            })
+                .catch(function (error) {
+                handlers.onError("Error getting iframe metadata from 'timeupdate' handler: ".concat(error));
+            });
+        };
+        player.on('timeupdate', timeupdateHandler);
+        onUnsubscribe.push(function () { return player.off('timeupdate', timeupdateHandler); });
     };
     player.on('ready', readyHandler);
     return function () {
@@ -148,10 +198,4 @@ export function trackMuxEmbeddedVideo(player, handlers) {
         onUnsubscribe.forEach(function (unsubscribe) { return unsubscribe(); });
     };
 }
-export function trackYoutubeEmbeddedVideo() {
-    throw new Error('Not implemented');
-}
-export function trackVimeoEmbeddedVideo() {
-    throw new Error('Not implemented');
-}
 //# sourceMappingURL=track-video.js.map

package/lib/esm/video-analytics/track-video.js.map

@@ -1 +1 @@
-{"version":3,"file":"track-video.js","sourceRoot":"","sources":["../../../src/video-analytics/track-video.ts"],"names":[],"mappings":"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","sourcesContent":["import { VideoHandler, VideoEvent, MuxEmbeddedPlayer, MuxElement } from './types';\n\nfunction getPlayData(videoEl: HTMLVideoElement | MuxElement) {\n  return {\n    program_duration: videoEl.duration,\n  };\n}\n\nfunction calculatePercentCompleted(currentTime: number, duration: number) {\n  let percentCompleted = 0;\n  if (Number.isFinite(currentTime) && Number.isFinite(duration) && duration > 0) {\n    const rawPercent = (currentTime / duration) * 100;\n    // Clamp to [0, 100] to avoid invalid analytics values.\n    percentCompleted = Math.min(100, Math.max(0, rawPercent));\n  }\n  return percentCompleted;\n}\n\nfunction getPauseData(videoEl: HTMLVideoElement | MuxElement) {\n  const currentTime = videoEl.currentTime;\n  const duration = videoEl.duration;\n\n  return {\n    ...getPlayData(videoEl),\n    last_position: currentTime,\n    percent_completed: calculatePercentCompleted(currentTime, duration),\n  };\n}\n\nfunction getEndData(videoEl: HTMLVideoElement | MuxElement) {\n  return {\n    ...getPauseData(videoEl),\n  };\n}\n\nfunction getMuxMetadata(videoEl: MuxElement) {\n  return {\n    mux_playback_id: videoEl.getAttribute('playback-id'),\n    mux_video_id: videoEl.getAttribute('metadata-video-id'),\n    mux_video_title: videoEl.getAttribute('metadata-video-title'),\n    mux_session_id: videoEl.getAttribute('session-id'),\n  };\n}\n\n/**\n * Track a standard HTML video element.\n *\n * @param videoEl - The HTML video element to track.\n * @param handlers - The video handlers to call when on video lifecycle events.\n * @returns A function to untrack the video.\n */\nexport function trackHtmlVideo(\n  videoEl: HTMLVideoElement | MuxElement,\n  handlers: VideoHandler,\n  vendor?: 'mux', // if new vendors add them to this as enum\n) {\n  const playHandler = () => {\n    const startEvent: VideoEvent = {\n      ...getPlayData(videoEl),\n      ...(vendor === 'mux' ? getMuxMetadata(videoEl) : {}),\n    };\n    handlers.onPlay(startEvent);\n  };\n  videoEl.addEventListener('play', playHandler);\n\n  const pauseHandler = () => {\n    const pauseEvent: VideoEvent = {\n      ...getPauseData(videoEl),\n      ...(vendor === 'mux' ? getMuxMetadata(videoEl) : {}),\n    };\n    handlers.onPause(pauseEvent);\n  };\n  videoEl.addEventListener('pause', pauseHandler);\n\n  const endedHandler = () => {\n    const endedEvent: VideoEvent = {\n      ...getEndData(videoEl),\n      ...(vendor === 'mux' ? getMuxMetadata(videoEl) : {}),\n    };\n    handlers.onEnded(endedEvent);\n  };\n  videoEl.addEventListener('ended', endedHandler);\n\n  return () => {\n    videoEl.removeEventListener('play', playHandler);\n    videoEl.removeEventListener('pause', pauseHandler);\n    videoEl.removeEventListener('ended', endedHandler);\n  };\n}\n\n/**\n * Track a Mux HTML video element.\n *\n * @param videoEl - The HTML Mux video element to track.\n * @param handlers - The video handlers to call when on video lifecycle events.\n * @returns A function to untrack the video.\n */\nexport function trackMuxHtmlVideo(videoEl: MuxElement, handlers: VideoHandler) {\n  return trackHtmlVideo(videoEl, handlers, 'mux');\n}\n\nasync function getMuxIframeMetadata(player: MuxEmbeddedPlayer, elem: HTMLIFrameElement) {\n  const [duration, currentTime] = await Promise.all([\n    new Promise<number>((resolve) => player.getDuration(resolve)),\n    new Promise<number>((resolve) => player.getCurrentTime(resolve)),\n  ]);\n\n  let url,\n    metadataVideoTitle = null,\n    metadataVideoId = null,\n    playerId = null;\n  try {\n    url = new URL(elem.getAttribute('src') as string);\n    metadataVideoTitle = url.searchParams.get('metadata-video-title');\n    metadataVideoId = url.searchParams.get('metadata-video-id');\n    playerId = url.pathname.split('/').pop();\n  } catch (error) {\n    // invalid or no src url, skip the header metadata\n  }\n  return {\n    percent_completed: calculatePercentCompleted(currentTime, duration),\n    program_duration: duration,\n    last_position: currentTime,\n    mux_video_title: metadataVideoTitle,\n    mux_video_id: metadataVideoId,\n    mux_playback_id: playerId,\n  };\n}\n\nexport function trackMuxEmbeddedVideo(player: MuxEmbeddedPlayer, handlers: VideoHandler) {\n  const onUnsubscribe: (() => void)[] = [];\n  const readyHandler = () => {\n    const { elem } = player;\n    const playHandler = () => {\n      getMuxIframeMetadata(player, elem)\n        .then((playerState) => {\n          const startEvent: VideoEvent = {\n            ...playerState,\n          };\n          handlers.onPlay(startEvent);\n        })\n        .catch((error) => {\n          handlers.onError(`Error getting Mux iframe metadata from 'play' handler: ${error as string}`);\n        });\n    };\n    player.on('play', playHandler);\n    onUnsubscribe.push(() => player.off('play', playHandler));\n\n    const pauseHandler = () => {\n      getMuxIframeMetadata(player, elem)\n        .then((playerState) => {\n          const pauseEvent: VideoEvent = {\n            ...playerState,\n          };\n          handlers.onPause(pauseEvent);\n        })\n        .catch((error) => {\n          handlers.onError(`Error getting Mux iframe metadata from 'pause' handler: ${error as string}`);\n        });\n    };\n    player.on('pause', pauseHandler);\n    onUnsubscribe.push(() => player.off('pause', pauseHandler));\n\n    const endedHandler = () => {\n      getMuxIframeMetadata(player, elem)\n        .then((playerState) => {\n          const endedEvent: VideoEvent = {\n            ...playerState,\n          };\n          handlers.onEnded(endedEvent);\n        })\n        .catch((error) => {\n          handlers.onError(`Error getting Mux iframe metadata from 'ended' handler: ${error as string}`);\n        });\n    };\n    player.on('ended', endedHandler);\n    onUnsubscribe.push(() => player.off('ended', endedHandler));\n  };\n  player.on('ready', readyHandler);\n\n  return () => {\n    player.off('ready', readyHandler);\n    onUnsubscribe.forEach((unsubscribe) => unsubscribe());\n  };\n}\n\nexport function trackYoutubeEmbeddedVideo() {\n  throw new Error('Not implemented');\n}\n\nexport function trackVimeoEmbeddedVideo() {\n  throw new Error('Not implemented');\n}\n"]}
+{"version":3,"file":"track-video.js","sourceRoot":"","sources":["../../../src/video-analytics/track-video.ts"],"names":[],"mappings":";AAUA,SAAS,yBAAyB,CAAC,WAAmB,EAAE,QAAgB;IACtE,IAAI,gBAAgB,GAAG,CAAC,CAAC;IACzB,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE;QAC7E,IAAM,UAAU,GAAG,CAAC,WAAW,GAAG,QAAQ,CAAC,GAAG,GAAG,CAAC;QAClD,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;KAC3D;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,SAAS,YAAY,CAAC,OAAsC,EAAE,UAA4B;IACxF,IAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACxC,IAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,kBACE,QAAQ,UAAA,EACR,UAAU,EAAE,WAAW,EACvB,aAAa,EAAE,WAAW,EAC1B,iBAAiB,EAAE,yBAAyB,CAAC,WAAW,EAAE,QAAQ,CAAC,IAChE,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAChE;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,OAAmB;IACzC,OAAO;QACL,eAAe,EAAE,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC;QACpD,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC,mBAAmB,CAAC;QACvD,eAAe,EAAE,OAAO,CAAC,YAAY,CAAC,sBAAsB,CAAC;KAC9D,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,OAAsC,EAAE,QAAsB,EAAE,MAAe;IAC5G,IAAM,WAAW,GAAG;QAClB,IAAM,UAAU,yBACX,YAAY,CAAC,OAAO,CAAC,GACrB,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CACrD,CAAC;QACF,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC,CAAC;IACF,OAAO,CAAC,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAE9C,IAAM,YAAY,GAAG;QACnB,IAAM,UAAU,yBACX,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,GAC/B,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CACrD,CAAC;QACF,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC,CAAC;IACF,OAAO,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAEhD,IAAM,YAAY,GAAG;QACnB,IAAM,UAAU,yBACX,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,GAC9B,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CACrD,CAAC;QACF,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC,CAAC;IACF,OAAO,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAEhD,IAAM,cAAc,GAAG;QACrB,IAAM,YAAY,yBACb,YAAY,CAAC,OAAO,EAAE,SAAS,CAAC,GAChC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CACrD,CAAC;QACF,QAAQ,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IACnC,CAAC,CAAC;IACF,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAEpD,IAAM,aAAa,GAAG;QACpB,IAAM,WAAW,yBACZ,YAAY,CAAC,OAAO,CAAC,GACrB,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CACrD,CAAC;QACF,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC,CAAC;IACF,OAAO,CAAC,gBAAgB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAElD,IAAM,iBAAiB,GAAG;QACxB,IAAM,KAAK,GAAG,OAA2B,CAAC;QAC1C,IAAM,eAAe,GAAoB;YACvC,QAAQ,EAAE,OAAO,CAAC,WAAW;YAC7B,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO;SAC3B,CAAC;QACF,QAAQ,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IACzC,CAAC,CAAC;IACF,OAAO,CAAC,gBAAgB,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;IAE1D,OAAO;QACL,OAAO,CAAC,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACjD,OAAO,CAAC,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACnD,OAAO,CAAC,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACnD,OAAO,CAAC,mBAAmB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QACvD,OAAO,CAAC,mBAAmB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QACrD,OAAO,CAAC,mBAAmB,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;IAC/D,CAAC,CAAC;AACJ,CAAC;AAED,SAAe,iBAAiB,CAAC,MAA2B;;;;;wBACtC,qBAAM,IAAI,OAAO,CAAS,UAAC,OAAO,IAAK,OAAA,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,EAA9B,CAA8B,CAAC,EAAA;;oBAApF,WAAW,GAAG,SAAsE;oBAC1F,sBAAO,EAAE,WAAW,aAAA,EAAE,EAAC;;;;CACxB;AAED,SAAe,iBAAiB,CAC9B,MAA2B,EAC3B,IAAuB,EACvB,MAAqB,EACrB,UAA4B;;;;;wBAEI,qBAAM,OAAO,CAAC,GAAG,CAAC;wBAChD,IAAI,OAAO,CAAS,UAAC,OAAO,IAAK,OAAA,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,EAA3B,CAA2B,CAAC;wBAC7D,IAAI,OAAO,CAAS,UAAC,OAAO,IAAK,OAAA,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,EAA9B,CAA8B,CAAC;qBACjE,CAAC,EAAA;;oBAHI,KAAA,sBAA0B,SAG9B,KAAA,EAHK,QAAQ,QAAA,EAAE,WAAW,QAAA;oBAKtB,cAAc,GAA8C,EAAE,CAAC;oBACrE,IAAI,MAAM,KAAK,KAAK,EAAE;wBAChB,GAAG,SAAA,CAAC;wBACR,IAAI;4BACF,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAW,CAAC,CAAC;4BAClD,cAAc,CAAC,eAAe,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;4BAC9E,cAAc,CAAC,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;4BACxE,cAAc,CAAC,eAAe,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;yBAChE;wBAAC,OAAO,KAAK,EAAE;4BACd,kDAAkD;yBACnD;qBACF;oBACD,0CACE,QAAQ,UAAA,EACR,UAAU,EAAE,WAAW,EACvB,aAAa,EAAE,WAAW,EAC1B,iBAAiB,EAAE,yBAAyB,CAAC,WAAW,EAAE,QAAQ,CAAC,IAChE,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,GAC7D,cAAc,GACjB;;;;CACH;AAED,MAAM,UAAU,kBAAkB,CAAC,MAA2B,EAAE,QAAsB,EAAE,MAA4B;IAA5B,uBAAA,EAAA,aAA4B;IAClH,IAAM,aAAa,GAAmB,EAAE,CAAC;IACzC,IAAM,YAAY,GAAG;QACX,IAAA,IAAI,GAAK,MAAM,KAAX,CAAY;QACxB,IAAI,SAAS,GAAG,KAAK,CAAC;QAEtB,IAAM,WAAW,GAAG;YAClB,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC;iBACpC,IAAI,CAAC,UAAC,WAAW;gBAChB,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAC/B,CAAC,CAAC;iBACD,KAAK,CAAC,UAAC,KAAK;gBACX,QAAQ,CAAC,OAAO,CAAC,6DAAsD,KAAe,CAAE,CAAC,CAAC;YAC5F,CAAC,CAAC,CAAC;QACP,CAAC,CAAC;QACF,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC/B,aAAa,CAAC,IAAI,CAAC,cAAM,OAAA,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EAA/B,CAA+B,CAAC,CAAC;QAE1D,IAAM,YAAY,GAAG;YACnB,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC;iBAC9C,IAAI,CAAC,UAAC,WAAW;gBAChB,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAChC,CAAC,CAAC;iBACD,KAAK,CAAC,UAAC,KAAK;gBACX,QAAQ,CAAC,OAAO,CAAC,8DAAuD,KAAe,CAAE,CAAC,CAAC;YAC7F,CAAC,CAAC,CAAC;QACP,CAAC,CAAC;QACF,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACjC,aAAa,CAAC,IAAI,CAAC,cAAM,OAAA,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,EAAjC,CAAiC,CAAC,CAAC;QAE5D,IAAM,YAAY,GAAG;YACnB,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC;iBAC7C,IAAI,CAAC,UAAC,WAAW;gBAChB,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAChC,CAAC,CAAC;iBACD,KAAK,CAAC,UAAC,KAAK;gBACX,QAAQ,CAAC,OAAO,CAAC,8DAAuD,KAAe,CAAE,CAAC,CAAC;YAC7F,CAAC,CAAC,CAAC;QACP,CAAC,CAAC;QACF,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACjC,aAAa,CAAC,IAAI,CAAC,cAAM,OAAA,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,EAAjC,CAAiC,CAAC,CAAC;QAE5D,IAAM,cAAc,GAAG;YACrB,SAAS,GAAG,IAAI,CAAC;YACjB,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC;iBAC/C,IAAI,CAAC,UAAC,WAAW;gBAChB,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YAClC,CAAC,CAAC;iBACD,KAAK,CAAC,UAAC,KAAK;gBACX,QAAQ,CAAC,OAAO,CAAC,gEAAyD,KAAe,CAAE,CAAC,CAAC;YAC/F,CAAC,CAAC,CAAC;QACP,CAAC,CAAC;QACF,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QACrC,aAAa,CAAC,IAAI,CAAC,cAAM,OAAA,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,cAAc,CAAC,EAArC,CAAqC,CAAC,CAAC;QAEhE,IAAM,aAAa,GAAG;YACpB,SAAS,GAAG,KAAK,CAAC;YAClB,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC;iBACpC,IAAI,CAAC,UAAC,WAAW;gBAChB,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YACjC,CAAC,CAAC;iBACD,KAAK,CAAC,UAAC,KAAK;gBACX,QAAQ,CAAC,OAAO,CAAC,+DAAwD,KAAe,CAAE,CAAC,CAAC;YAC9F,CAAC,CAAC,CAAC;QACP,CAAC,CAAC;QACF,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QACnC,aAAa,CAAC,IAAI,CAAC,cAAM,OAAA,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAnC,CAAmC,CAAC,CAAC;QAE9D,IAAM,iBAAiB,GAAG;YACxB,iBAAiB,CAAC,MAAM,CAAC;iBACtB,IAAI,CAAC,UAAC,EAAe;oBAAb,WAAW,iBAAA;gBAClB,IAAM,eAAe,GAAoB;oBACvC,QAAQ,EAAE,WAAW;oBACrB,SAAS,EAAE,SAAS;iBACrB,CAAC;gBACF,QAAQ,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;YACzC,CAAC,CAAC;iBACD,KAAK,CAAC,UAAC,KAAK;gBACX,QAAQ,CAAC,OAAO,CAAC,mEAA4D,KAAe,CAAE,CAAC,CAAC;YAClG,CAAC,CAAC,CAAC;QACP,CAAC,CAAC;QACF,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;QAC3C,aAAa,CAAC,IAAI,CAAC,cAAM,OAAA,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,iBAAiB,CAAC,EAA3C,CAA2C,CAAC,CAAC;IACxE,CAAC,CAAC;IACF,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAEjC,OAAO;QACL,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAClC,aAAa,CAAC,OAAO,CAAC,UAAC,WAAW,IAAK,OAAA,WAAW,EAAE,EAAb,CAAa,CAAC,CAAC;IACxD,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import {\n  VideoHandler,\n  VideoEvent,\n  EmbeddedVideoPlayer,\n  MuxElement,\n  Vendor,\n  VideoStopReason,\n  TimeUpdateEvent,\n} from './types';\n\nfunction calculatePercentCompleted(currentTime: number, duration: number) {\n  let percentCompleted = 0;\n  if (Number.isFinite(currentTime) && Number.isFinite(duration) && duration > 0) {\n    const rawPercent = (currentTime / duration) * 100;\n    percentCompleted = Math.min(100, Math.max(0, rawPercent));\n  }\n  return percentCompleted;\n}\n\nfunction getVideoData(videoEl: HTMLVideoElement | MuxElement, stopReason?: VideoStopReason) {\n  const currentTime = videoEl.currentTime;\n  const duration = videoEl.duration;\n  return {\n    duration,\n    start_time: currentTime,\n    last_position: currentTime,\n    percent_completed: calculatePercentCompleted(currentTime, duration),\n    ...(stopReason !== undefined ? { stop_reason: stopReason } : {}),\n  };\n}\n\nfunction getMuxMetadata(videoEl: MuxElement) {\n  return {\n    mux_playback_id: videoEl.getAttribute('playback-id'),\n    mux_video_id: videoEl.getAttribute('metadata-video-id'),\n    mux_video_title: videoEl.getAttribute('metadata-video-title'),\n  };\n}\n\n/**\n * Track a standard HTML video element.\n *\n * @param videoEl - The HTML video element to track.\n * @param handlers - The video handlers to call when on video lifecycle events.\n * @returns A function to untrack the video.\n */\nexport function trackHtmlVideo(videoEl: HTMLVideoElement | MuxElement, handlers: VideoHandler, vendor?: Vendor) {\n  const playHandler = () => {\n    const startEvent: VideoEvent = {\n      ...getVideoData(videoEl),\n      ...(vendor === 'mux' ? getMuxMetadata(videoEl) : {}),\n    };\n    handlers.onPlay(startEvent);\n  };\n  videoEl.addEventListener('play', playHandler);\n\n  const pauseHandler = () => {\n    const pauseEvent: VideoEvent = {\n      ...getVideoData(videoEl, 'paused'),\n      ...(vendor === 'mux' ? getMuxMetadata(videoEl) : {}),\n    };\n    handlers.onPause(pauseEvent);\n  };\n  videoEl.addEventListener('pause', pauseHandler);\n\n  const endedHandler = () => {\n    const endedEvent: VideoEvent = {\n      ...getVideoData(videoEl, 'ended'),\n      ...(vendor === 'mux' ? getMuxMetadata(videoEl) : {}),\n    };\n    handlers.onEnded(endedEvent);\n  };\n  videoEl.addEventListener('ended', endedHandler);\n\n  const seekingHandler = () => {\n    const seekingEvent: VideoEvent = {\n      ...getVideoData(videoEl, 'seeking'),\n      ...(vendor === 'mux' ? getMuxMetadata(videoEl) : {}),\n    };\n    handlers.onSeeking(seekingEvent);\n  };\n  videoEl.addEventListener('seeking', seekingHandler);\n\n  const seekedHandler = () => {\n    const seekedEvent: VideoEvent = {\n      ...getVideoData(videoEl),\n      ...(vendor === 'mux' ? getMuxMetadata(videoEl) : {}),\n    };\n    handlers.onSeeked(seekedEvent);\n  };\n  videoEl.addEventListener('seeked', seekedHandler);\n\n  const timeupdateHandler = () => {\n    const media = videoEl as HTMLVideoElement;\n    const timeupdateEvent: TimeUpdateEvent = {\n      position: videoEl.currentTime,\n      isSeeking: !!media.seeking,\n    };\n    handlers.onTimeUpdate(timeupdateEvent);\n  };\n  videoEl.addEventListener('timeupdate', timeupdateHandler);\n\n  return () => {\n    videoEl.removeEventListener('play', playHandler);\n    videoEl.removeEventListener('pause', pauseHandler);\n    videoEl.removeEventListener('ended', endedHandler);\n    videoEl.removeEventListener('seeking', seekingHandler);\n    videoEl.removeEventListener('seeked', seekedHandler);\n    videoEl.removeEventListener('timeupdate', timeupdateHandler);\n  };\n}\n\nasync function getTimeUpdateInfo(player: EmbeddedVideoPlayer) {\n  const currentTime = await new Promise<number>((resolve) => player.getCurrentTime(resolve));\n  return { currentTime };\n}\n\nasync function getIframeMetadata(\n  player: EmbeddedVideoPlayer,\n  elem: HTMLIFrameElement,\n  vendor: Vendor | null,\n  stopReason?: VideoStopReason,\n) {\n  const [duration, currentTime] = await Promise.all([\n    new Promise<number>((resolve) => player.getDuration(resolve)),\n    new Promise<number>((resolve) => player.getCurrentTime(resolve)),\n  ]);\n\n  const vendorMetadata: Record<string, string | null | undefined> = {};\n  if (vendor === 'mux') {\n    let url;\n    try {\n      url = new URL(elem.getAttribute('src') as string);\n      vendorMetadata.mux_video_title = url.searchParams.get('metadata-video-title');\n      vendorMetadata.mux_video_id = url.searchParams.get('metadata-video-id');\n      vendorMetadata.mux_playback_id = url.pathname.split('/').pop();\n    } catch (error) {\n      // invalid or no src url, skip the header metadata\n    }\n  }\n  return {\n    duration,\n    start_time: currentTime,\n    last_position: currentTime,\n    percent_completed: calculatePercentCompleted(currentTime, duration),\n    ...(stopReason !== undefined ? { stop_reason: stopReason } : {}),\n    ...vendorMetadata,\n  };\n}\n\nexport function trackEmbeddedVideo(player: EmbeddedVideoPlayer, handlers: VideoHandler, vendor: Vendor | null = null) {\n  const onUnsubscribe: (() => void)[] = [];\n  const readyHandler = () => {\n    const { elem } = player;\n    let isSeeking = false;\n\n    const playHandler = () => {\n      getIframeMetadata(player, elem, vendor)\n        .then((playerState) => {\n          handlers.onPlay(playerState);\n        })\n        .catch((error) => {\n          handlers.onError(`Error getting iframe metadata from 'play' handler: ${error as string}`);\n        });\n    };\n    player.on('play', playHandler);\n    onUnsubscribe.push(() => player.off('play', playHandler));\n\n    const pauseHandler = () => {\n      getIframeMetadata(player, elem, vendor, 'paused')\n        .then((playerState) => {\n          handlers.onPause(playerState);\n        })\n        .catch((error) => {\n          handlers.onError(`Error getting iframe metadata from 'pause' handler: ${error as string}`);\n        });\n    };\n    player.on('pause', pauseHandler);\n    onUnsubscribe.push(() => player.off('pause', pauseHandler));\n\n    const endedHandler = () => {\n      getIframeMetadata(player, elem, vendor, 'ended')\n        .then((playerState) => {\n          handlers.onEnded(playerState);\n        })\n        .catch((error) => {\n          handlers.onError(`Error getting iframe metadata from 'ended' handler: ${error as string}`);\n        });\n    };\n    player.on('ended', endedHandler);\n    onUnsubscribe.push(() => player.off('ended', endedHandler));\n\n    const seekingHandler = () => {\n      isSeeking = true;\n      getIframeMetadata(player, elem, vendor, 'seeking')\n        .then((playerState) => {\n          handlers.onSeeking(playerState);\n        })\n        .catch((error) => {\n          handlers.onError(`Error getting iframe metadata from 'seeking' handler: ${error as string}`);\n        });\n    };\n    player.on('seeking', seekingHandler);\n    onUnsubscribe.push(() => player.off('seeking', seekingHandler));\n\n    const seekedHandler = () => {\n      isSeeking = false;\n      getIframeMetadata(player, elem, vendor)\n        .then((playerState) => {\n          handlers.onSeeked(playerState);\n        })\n        .catch((error) => {\n          handlers.onError(`Error getting iframe metadata from 'seeked' handler: ${error as string}`);\n        });\n    };\n    player.on('seeked', seekedHandler);\n    onUnsubscribe.push(() => player.off('seeked', seekedHandler));\n\n    const timeupdateHandler = () => {\n      getTimeUpdateInfo(player)\n        .then(({ currentTime }) => {\n          const timeupdateEvent: TimeUpdateEvent = {\n            position: currentTime,\n            isSeeking: isSeeking,\n          };\n          handlers.onTimeUpdate(timeupdateEvent);\n        })\n        .catch((error) => {\n          handlers.onError(`Error getting iframe metadata from 'timeupdate' handler: ${error as string}`);\n        });\n    };\n    player.on('timeupdate', timeupdateHandler);\n    onUnsubscribe.push(() => player.off('timeupdate', timeupdateHandler));\n  };\n  player.on('ready', readyHandler);\n\n  return () => {\n    player.off('ready', readyHandler);\n    onUnsubscribe.forEach((unsubscribe) => unsubscribe());\n  };\n}\n"]}

package/lib/esm/video-analytics/types.d.ts

@@ -1,11 +1,17 @@
+export type Vendor = 'mux';
+export type VideoStopReason = 'paused' | 'ended' | 'seeking';
 export type VideoHandler = {
     onPlay: (startEvent: VideoEvent) => void;
     onPause: (pauseEvent: VideoEvent) => void;
     onEnded: (endedEvent: VideoEvent) => void;
+    onSeeking: (seekingEvent: VideoEvent) => void;
+    onSeeked: (seekedEvent: VideoEvent) => void;
     onError: (error: string) => void;
+    onTimeUpdate: (timeUpdateEvent: TimeUpdateEvent) => void;
 };
 export type VideoEvent = {
-    program_duration: number;
+    duration: number;
+    start_time?: number;
     playback_id?: string | undefined;
     video_id?: string | undefined;
     video_title?: string | undefined;
@@ -16,10 +22,15 @@ export type VideoEvent = {
     mux_video_id?: string | undefined | null;
     mux_video_title?: string | undefined | null;
     mux_session_id?: string | undefined | null;
-    last_position?: number | undefined | null;
+    last_position: number | undefined | null;
     percent_completed?: number;
+    stop_reason?: VideoStopReason;
+};
+export type TimeUpdateEvent = {
+    position: number;
+    isSeeking: boolean;
 };
-type MuxEmbeddedPlayer = {
+type EmbeddedVideoPlayer = {
     getCurrentTime: (cb: (time: number) => void) => void;
     getDuration: (cb: (duration: number) => void) => void;
     on: (event: string, callback: () => void) => void;
@@ -27,10 +38,11 @@ type MuxEmbeddedPlayer = {
     elem: HTMLIFrameElement;
 };
 type MuxElement = EventTarget & Element & {
+    seeking: boolean;
     duration: number;
     currentTime: number;
     play?: () => Promise<unknown>;
     pause?: () => void;
 };
-export { MuxElement, MuxEmbeddedPlayer };
+export { MuxElement, EmbeddedVideoPlayer };
 //# sourceMappingURL=types.d.ts.map

package/lib/esm/video-analytics/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/video-analytics/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IACzC,OAAO,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAC1C,OAAO,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAC1C,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAC5C,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IACzC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAC5C,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAC3C,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,cAAc,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,KAAK,IAAI,CAAC;IACrD,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,KAAK,IAAI,CAAC;IACtD,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IAClD,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACnD,IAAI,EAAE,iBAAiB,CAAC;CACzB,CAAC;AAEF,KAAK,UAAU,GAAG,WAAW,GAC3B,OAAO,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC;AAEzG,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/video-analytics/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG,KAAK,CAAC;AAE3B,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE7D,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IACzC,OAAO,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAC1C,OAAO,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAC1C,SAAS,EAAE,CAAC,YAAY,EAAE,UAAU,KAAK,IAAI,CAAC;IAC9C,QAAQ,EAAE,CAAC,WAAW,EAAE,UAAU,KAAK,IAAI,CAAC;IAC5C,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,YAAY,EAAE,CAAC,eAAe,EAAE,eAAe,KAAK,IAAI,CAAC;CAC1D,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAC5C,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IACzC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAC5C,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAC3C,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACzB,cAAc,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,KAAK,IAAI,CAAC;IACrD,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,KAAK,IAAI,CAAC;IACtD,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IAClD,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACnD,IAAI,EAAE,iBAAiB,CAAC;CACzB,CAAC;AAEF,KAAK,UAAU,GAAG,WAAW,GAC3B,OAAO,GAAG;IACR,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AAEJ,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,CAAC"}

package/lib/esm/video-analytics/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/video-analytics/types.ts"],"names":[],"mappings":"","sourcesContent":["export type VideoHandler = {\n  onPlay: (startEvent: VideoEvent) => void;\n  onPause: (pauseEvent: VideoEvent) => void;\n  onEnded: (endedEvent: VideoEvent) => void;\n  onError: (error: string) => void;\n};\n\nexport type VideoEvent = {\n  program_duration: number;\n  playback_id?: string | undefined;\n  video_id?: string | undefined;\n  video_title?: string | undefined;\n  content_id?: string | undefined;\n  content_type?: string | undefined;\n  session_id?: string | undefined;\n  mux_playback_id?: string | undefined | null;\n  mux_video_id?: string | undefined | null;\n  mux_video_title?: string | undefined | null;\n  mux_session_id?: string | undefined | null;\n  last_position?: number | undefined | null;\n  percent_completed?: number;\n};\n\ntype MuxEmbeddedPlayer = {\n  getCurrentTime: (cb: (time: number) => void) => void;\n  getDuration: (cb: (duration: number) => void) => void;\n  on: (event: string, callback: () => void) => void;\n  off: (event: string, callback: () => void) => void;\n  elem: HTMLIFrameElement;\n};\n\ntype MuxElement = EventTarget &\n  Element & { duration: number; currentTime: number; play?: () => Promise<unknown>; pause?: () => void };\n\nexport { MuxElement, MuxEmbeddedPlayer };\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/video-analytics/types.ts"],"names":[],"mappings":"","sourcesContent":["export type Vendor = 'mux'; // | 'vimeo' | 'youtube' | 'other'\n\nexport type VideoStopReason = 'paused' | 'ended' | 'seeking';\n\nexport type VideoHandler = {\n  onPlay: (startEvent: VideoEvent) => void;\n  onPause: (pauseEvent: VideoEvent) => void;\n  onEnded: (endedEvent: VideoEvent) => void;\n  onSeeking: (seekingEvent: VideoEvent) => void;\n  onSeeked: (seekedEvent: VideoEvent) => void;\n  onError: (error: string) => void;\n  onTimeUpdate: (timeUpdateEvent: TimeUpdateEvent) => void;\n};\n\nexport type VideoEvent = {\n  duration: number;\n  start_time?: number;\n  playback_id?: string | undefined;\n  video_id?: string | undefined;\n  video_title?: string | undefined;\n  content_id?: string | undefined;\n  content_type?: string | undefined;\n  session_id?: string | undefined;\n  mux_playback_id?: string | undefined | null;\n  mux_video_id?: string | undefined | null;\n  mux_video_title?: string | undefined | null;\n  mux_session_id?: string | undefined | null;\n  last_position: number | undefined | null;\n  percent_completed?: number;\n  stop_reason?: VideoStopReason;\n};\n\nexport type TimeUpdateEvent = {\n  position: number;\n  isSeeking: boolean;\n};\n\ntype EmbeddedVideoPlayer = {\n  getCurrentTime: (cb: (time: number) => void) => void;\n  getDuration: (cb: (duration: number) => void) => void;\n  on: (event: string, callback: () => void) => void;\n  off: (event: string, callback: () => void) => void;\n  elem: HTMLIFrameElement;\n};\n\ntype MuxElement = EventTarget &\n  Element & {\n    seeking: boolean;\n    duration: number;\n    currentTime: number;\n    play?: () => Promise<unknown>;\n    pause?: () => void;\n  };\n\nexport { MuxElement, EmbeddedVideoPlayer };\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amplitude/analytics-core",
-  "version": "2.44.2-SR-3115-rc2.0",
+  "version": "2.46.0",
   "description": "",
   "author": "Amplitude Inc",
   "homepage": "https://github.com/amplitude/Amplitude-TypeScript",