@amplitude/analytics-core 2.44.0 → 2.44.2-SR-3115.0

package/lib/cjs/observers/video.d.ts

@@ -0,0 +1,25 @@
+import type { VideoEvent, MuxEmbeddedPlayer, MuxElement } from '../video-analytics/types';
+type PlaybackState = 'playing' | 'paused' | 'ended' | 'error';
+type Vendor = 'mux';
+type State = {
+    playbackState: PlaybackState;
+    errorMessage?: string;
+    lastEvent?: VideoEvent;
+};
+type VideoObserverParams = {
+    videoEl: HTMLVideoElement | MuxEmbeddedPlayer | MuxElement;
+    onStateChange: (previousState: State, nextState: State) => void;
+    vendor?: Vendor;
+    isEmbedded?: boolean;
+};
+export declare class VideoObserver {
+    private state;
+    private untrack;
+    private onStateChange;
+    private handler;
+    constructor({ videoEl, onStateChange, vendor, isEmbedded }: VideoObserverParams);
+    private updateState;
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=video.d.ts.map

package/lib/cjs/observers/video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.d.ts","sourceRoot":"","sources":["../../../src/observers/video.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAgB,UAAU,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAExG,KAAK,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9D,KAAK,MAAM,GAAG,KAAK,CAAC;AAEpB,KAAK,KAAK,GAAG;IACX,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACzB,OAAO,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,UAAU,CAAC;IAC3D,aAAa,EAAE,CAAC,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,KAAK,IAAI,CAAC;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAEX;IAEF,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,aAAa,CAAmD;IACxE,OAAO,CAAC,OAAO,CAab;gBAEU,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,mBAAmB;IAU/E,OAAO,CAAC,WAAW;IAcnB,OAAO;CAGR"}

package/lib/cjs/observers/video.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VideoObserver = void 0;
+var track_video_1 = require("../video-analytics/track-video");
+var VideoObserver = /** @class */ (function () {
+    function VideoObserver(_a) {
+        var videoEl = _a.videoEl, onStateChange = _a.onStateChange, vendor = _a.vendor, isEmbedded = _a.isEmbedded;
+        var _this = this;
+        this.state = {
+            playbackState: 'paused',
+        };
+        this.handler = {
+            onPlay: function (evt) {
+                _this.updateState('playing', evt);
+            },
+            onPause: function (evt) {
+                _this.updateState('paused', evt);
+            },
+            onEnded: function (evt) {
+                _this.updateState('ended', evt);
+            },
+            onError: function () {
+                _this.updateState('error');
+            },
+        };
+        this.onStateChange = onStateChange;
+        if (isEmbedded) {
+            // TODO: support embedded iFrame video with no Vendor
+            this.untrack = (0, track_video_1.trackMuxEmbeddedVideo)(videoEl, this.handler);
+        }
+        else {
+            this.untrack = (0, track_video_1.trackHtmlVideo)(videoEl, this.handler, vendor);
+        }
+    }
+    VideoObserver.prototype.updateState = function (playbackState, event) {
+        var previousState = this.state;
+        var nextState = {
+            playbackState: playbackState,
+            lastEvent: event,
+        };
+        this.state = nextState;
+        try {
+            this.onStateChange(previousState, nextState);
+        }
+        catch (_error) {
+            // Swallow callback errors to keep observer state consistent.
+        }
+    };
+    VideoObserver.prototype.destroy = function () {
+        this.untrack();
+    };
+    return VideoObserver;
+}());
+exports.VideoObserver = VideoObserver;
+//# sourceMappingURL=video.js.map

package/lib/cjs/observers/video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.js","sourceRoot":"","sources":["../../../src/observers/video.ts"],"names":[],"mappings":";;;AAAA,8DAAuF;AAoBvF;IAsBE,uBAAY,EAAmE;YAAjE,OAAO,aAAA,EAAE,aAAa,mBAAA,EAAE,MAAM,YAAA,EAAE,UAAU,gBAAA;QAAxD,iBAQC;QA7BO,UAAK,GAAU;YACrB,aAAa,EAAE,QAAQ;SACxB,CAAC;QAIM,YAAO,GAAiB;YAC9B,MAAM,EAAE,UAAC,GAAe;gBACtB,KAAI,CAAC,WAAW,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YACnC,CAAC;YACD,OAAO,EAAE,UAAC,GAAe;gBACvB,KAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAClC,CAAC;YACD,OAAO,EAAE,UAAC,GAAe;gBACvB,KAAI,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACjC,CAAC;YACD,OAAO,EAAE;gBACP,KAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC5B,CAAC;SACF,CAAC;QAGA,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,UAAU,EAAE;YACd,qDAAqD;YACrD,IAAI,CAAC,OAAO,GAAG,IAAA,mCAAqB,EAAC,OAA4B,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;SAClF;aAAM;YACL,IAAI,CAAC,OAAO,GAAG,IAAA,4BAAc,EAAC,OAA2B,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;SAClF;IACH,CAAC;IAEO,mCAAW,GAAnB,UAAoB,aAA4B,EAAE,KAAkB;QAClE,IAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC;QACjC,IAAM,SAAS,GAAU;YACvB,aAAa,eAAA;YACb,SAAS,EAAE,KAAK;SACjB,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,IAAI;YACF,IAAI,CAAC,aAAa,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;SAC9C;QAAC,OAAO,MAAM,EAAE;YACf,6DAA6D;SAC9D;IACH,CAAC;IAED,+BAAO,GAAP;QACE,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IACH,oBAAC;AAAD,CAAC,AAjDD,IAiDC;AAjDY,sCAAa","sourcesContent":["import { trackHtmlVideo, trackMuxEmbeddedVideo } from '../video-analytics/track-video';\nimport type { VideoHandler, VideoEvent, MuxEmbeddedPlayer, MuxElement } from '../video-analytics/types';\n\ntype PlaybackState = 'playing' | 'paused' | 'ended' | 'error';\n\ntype Vendor = 'mux'; // | 'vimeo' | 'youtube' | 'other'\n\ntype State = {\n  playbackState: PlaybackState;\n  errorMessage?: string;\n  lastEvent?: VideoEvent;\n};\n\ntype VideoObserverParams = {\n  videoEl: HTMLVideoElement | MuxEmbeddedPlayer | MuxElement;\n  onStateChange: (previousState: State, nextState: State) => void;\n  vendor?: Vendor;\n  isEmbedded?: boolean;\n};\n\nexport class VideoObserver {\n  private state: State = {\n    playbackState: 'paused',\n  };\n\n  private untrack: () => void;\n  private onStateChange: (previousState: State, nextState: State) => void;\n  private handler: VideoHandler = {\n    onPlay: (evt: VideoEvent) => {\n      this.updateState('playing', evt);\n    },\n    onPause: (evt: VideoEvent) => {\n      this.updateState('paused', evt);\n    },\n    onEnded: (evt: VideoEvent) => {\n      this.updateState('ended', evt);\n    },\n    onError: () => {\n      this.updateState('error');\n    },\n  };\n\n  constructor({ videoEl, onStateChange, vendor, isEmbedded }: VideoObserverParams) {\n    this.onStateChange = onStateChange;\n    if (isEmbedded) {\n      // TODO: support embedded iFrame video with no Vendor\n      this.untrack = trackMuxEmbeddedVideo(videoEl as MuxEmbeddedPlayer, this.handler);\n    } else {\n      this.untrack = trackHtmlVideo(videoEl as HTMLVideoElement, this.handler, vendor);\n    }\n  }\n\n  private updateState(playbackState: PlaybackState, event?: VideoEvent) {\n    const previousState = this.state;\n    const nextState: State = {\n      playbackState,\n      lastEvent: event,\n    };\n    this.state = nextState;\n    try {\n      this.onStateChange(previousState, nextState);\n    } catch (_error) {\n      // Swallow callback errors to keep observer state consistent.\n    }\n  }\n\n  destroy() {\n    this.untrack();\n  }\n}\n"]}

package/lib/cjs/video-analytics/track-video.d.ts

@@ -0,0 +1,21 @@
+import { VideoHandler, MuxEmbeddedPlayer, MuxElement } from './types';
+/**
+ * Track a standard HTML video element.
+ *
+ * @param videoEl - The HTML video element to track.
+ * @param handlers - The video handlers to call when on video lifecycle events.
+ * @returns A function to untrack the video.
+ */
+export declare function trackHtmlVideo(videoEl: HTMLVideoElement | MuxElement, handlers: VideoHandler, vendor?: 'mux'): () => void;
+/**
+ * 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 declare function trackMuxHtmlVideo(videoEl: MuxElement, handlers: VideoHandler): () => void;
+export declare function trackMuxEmbeddedVideo(player: MuxEmbeddedPlayer, handlers: VideoHandler): () => void;
+export declare function trackYoutubeEmbeddedVideo(): void;
+export declare function trackVimeoEmbeddedVideo(): void;
+//# sourceMappingURL=track-video.d.ts.map

package/lib/cjs/video-analytics/track-video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-video.d.ts","sourceRoot":"","sources":["../../../src/video-analytics/track-video.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAc,iBAAiB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AA4ClF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,gBAAgB,GAAG,UAAU,EACtC,QAAQ,EAAE,YAAY,EACtB,MAAM,CAAC,EAAE,KAAK,cAkCf;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,cAE5E;AA8BD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,YAAY,cAuDtF;AAED,wBAAgB,yBAAyB,SAExC;AAED,wBAAgB,uBAAuB,SAEtC"}

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

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trackVimeoEmbeddedVideo = exports.trackYoutubeEmbeddedVideo = exports.trackMuxEmbeddedVideo = exports.trackMuxHtmlVideo = exports.trackHtmlVideo = void 0;
+var tslib_1 = require("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) {
+    var currentTime = videoEl.currentTime;
+    var duration = videoEl.duration;
+    return tslib_1.__assign(tslib_1.__assign({}, getPlayData(videoEl)), { last_position: currentTime, percent_completed: calculatePercentCompleted(currentTime, duration) });
+}
+function getEndData(videoEl) {
+    return tslib_1.__assign({}, getPauseData(videoEl));
+}
+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'),
+    };
+}
+/**
+ * Track a standard HTML video element.
+ *
+ * @param videoEl - The HTML video element to track.
+ * @param handlers - The video handlers to call when on video lifecycle events.
+ * @returns A function to untrack the video.
+ */
+function trackHtmlVideo(videoEl, handlers, vendor) {
+    var playHandler = function () {
+        var startEvent = tslib_1.__assign(tslib_1.__assign({}, getPlayData(videoEl)), (vendor === 'mux' ? getMuxMetadata(videoEl) : {}));
+        handlers.onPlay(startEvent);
+    };
+    videoEl.addEventListener('play', playHandler);
+    var pauseHandler = function () {
+        var pauseEvent = tslib_1.__assign(tslib_1.__assign({}, getPauseData(videoEl)), (vendor === 'mux' ? getMuxMetadata(videoEl) : {}));
+        handlers.onPause(pauseEvent);
+    };
+    videoEl.addEventListener('pause', pauseHandler);
+    var endedHandler = function () {
+        var endedEvent = tslib_1.__assign(tslib_1.__assign({}, getEndData(videoEl)), (vendor === 'mux' ? getMuxMetadata(videoEl) : {}));
+        handlers.onEnded(endedEvent);
+    };
+    videoEl.addEventListener('ended', endedHandler);
+    return function () {
+        videoEl.removeEventListener('play', playHandler);
+        videoEl.removeEventListener('pause', pauseHandler);
+        videoEl.removeEventListener('ended', endedHandler);
+    };
+}
+exports.trackHtmlVideo = trackHtmlVideo;
+/**
+ * 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.
+ */
+function trackMuxHtmlVideo(videoEl, handlers) {
+    return trackHtmlVideo(videoEl, handlers, 'mux');
+}
+exports.trackMuxHtmlVideo = trackMuxHtmlVideo;
+function getMuxIframeMetadata(player, elem) {
+    return tslib_1.__awaiter(this, void 0, void 0, function () {
+        var _a, duration, currentTime, url, metadataVideoTitle, metadataVideoId, playerId;
+        return tslib_1.__generator(this, function (_b) {
+            switch (_b.label) {
+                case 0: return [4 /*yield*/, Promise.all([
+                        new Promise(function (resolve) { return player.getDuration(resolve); }),
+                        new Promise(function (resolve) { return player.getCurrentTime(resolve); }),
+                    ])];
+                case 1:
+                    _a = tslib_1.__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();
+                    }
+                    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,
+                        }];
+            }
+        });
+    });
+}
+function trackMuxEmbeddedVideo(player, handlers) {
+    var onUnsubscribe = [];
+    var readyHandler = function () {
+        var elem = player.elem;
+        var playHandler = function () {
+            getMuxIframeMetadata(player, elem)
+                .then(function (playerState) {
+                var startEvent = tslib_1.__assign({}, playerState);
+                handlers.onPlay(startEvent);
+            })
+                .catch(function (error) {
+                handlers.onError("Error getting Mux 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)
+                .then(function (playerState) {
+                var pauseEvent = tslib_1.__assign({}, playerState);
+                handlers.onPause(pauseEvent);
+            })
+                .catch(function (error) {
+                handlers.onError("Error getting Mux 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)
+                .then(function (playerState) {
+                var endedEvent = tslib_1.__assign({}, playerState);
+                handlers.onEnded(endedEvent);
+            })
+                .catch(function (error) {
+                handlers.onError("Error getting Mux iframe metadata from 'ended' handler: ".concat(error));
+            });
+        };
+        player.on('ended', endedHandler);
+        onUnsubscribe.push(function () { return player.off('ended', endedHandler); });
+    };
+    player.on('ready', readyHandler);
+    return function () {
+        player.off('ready', readyHandler);
+        onUnsubscribe.forEach(function (unsubscribe) { return unsubscribe(); });
+    };
+}
+exports.trackMuxEmbeddedVideo = trackMuxEmbeddedVideo;
+function trackYoutubeEmbeddedVideo() {
+    throw new Error('Not implemented');
+}
+exports.trackYoutubeEmbeddedVideo = trackYoutubeEmbeddedVideo;
+function trackVimeoEmbeddedVideo() {
+    throw new Error('Not implemented');
+}
+exports.trackVimeoEmbeddedVideo = trackVimeoEmbeddedVideo;
+//# sourceMappingURL=track-video.js.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,36 @@
+export type VideoHandler = {
+    onPlay: (startEvent: VideoEvent) => void;
+    onPause: (pauseEvent: VideoEvent) => void;
+    onEnded: (endedEvent: VideoEvent) => void;
+    onError: (error: string) => void;
+};
+export type VideoEvent = {
+    program_duration: number;
+    playback_id?: string | undefined;
+    video_id?: string | undefined;
+    video_title?: string | undefined;
+    content_id?: string | undefined;
+    content_type?: string | undefined;
+    session_id?: string | undefined;
+    mux_playback_id?: string | undefined | null;
+    mux_video_id?: string | undefined | null;
+    mux_video_title?: string | undefined | null;
+    mux_session_id?: string | undefined | null;
+    last_position?: number | undefined | null;
+    percent_completed?: number;
+};
+type MuxEmbeddedPlayer = {
+    getCurrentTime: (cb: (time: number) => void) => void;
+    getDuration: (cb: (duration: number) => void) => void;
+    on: (event: string, callback: () => void) => void;
+    off: (event: string, callback: () => void) => void;
+    elem: HTMLIFrameElement;
+};
+type MuxElement = EventTarget & Element & {
+    duration: number;
+    currentTime: number;
+    play?: () => Promise<unknown>;
+    pause?: () => void;
+};
+export { MuxElement, MuxEmbeddedPlayer };
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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"}

package/lib/cjs/video-analytics/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +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"]}

package/lib/esm/observers/video.d.ts

@@ -0,0 +1,25 @@
+import type { VideoEvent, MuxEmbeddedPlayer, MuxElement } from '../video-analytics/types';
+type PlaybackState = 'playing' | 'paused' | 'ended' | 'error';
+type Vendor = 'mux';
+type State = {
+    playbackState: PlaybackState;
+    errorMessage?: string;
+    lastEvent?: VideoEvent;
+};
+type VideoObserverParams = {
+    videoEl: HTMLVideoElement | MuxEmbeddedPlayer | MuxElement;
+    onStateChange: (previousState: State, nextState: State) => void;
+    vendor?: Vendor;
+    isEmbedded?: boolean;
+};
+export declare class VideoObserver {
+    private state;
+    private untrack;
+    private onStateChange;
+    private handler;
+    constructor({ videoEl, onStateChange, vendor, isEmbedded }: VideoObserverParams);
+    private updateState;
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=video.d.ts.map

package/lib/esm/observers/video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.d.ts","sourceRoot":"","sources":["../../../src/observers/video.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAgB,UAAU,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAExG,KAAK,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9D,KAAK,MAAM,GAAG,KAAK,CAAC;AAEpB,KAAK,KAAK,GAAG;IACX,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACzB,OAAO,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,UAAU,CAAC;IAC3D,aAAa,EAAE,CAAC,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,KAAK,IAAI,CAAC;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAEX;IAEF,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,aAAa,CAAmD;IACxE,OAAO,CAAC,OAAO,CAab;gBAEU,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,mBAAmB;IAU/E,OAAO,CAAC,WAAW;IAcnB,OAAO;CAGR"}

package/lib/esm/observers/video.js

@@ -0,0 +1,52 @@
+import { trackHtmlVideo, trackMuxEmbeddedVideo } from '../video-analytics/track-video';
+var VideoObserver = /** @class */ (function () {
+    function VideoObserver(_a) {
+        var videoEl = _a.videoEl, onStateChange = _a.onStateChange, vendor = _a.vendor, isEmbedded = _a.isEmbedded;
+        var _this = this;
+        this.state = {
+            playbackState: 'paused',
+        };
+        this.handler = {
+            onPlay: function (evt) {
+                _this.updateState('playing', evt);
+            },
+            onPause: function (evt) {
+                _this.updateState('paused', evt);
+            },
+            onEnded: function (evt) {
+                _this.updateState('ended', evt);
+            },
+            onError: function () {
+                _this.updateState('error');
+            },
+        };
+        this.onStateChange = onStateChange;
+        if (isEmbedded) {
+            // TODO: support embedded iFrame video with no Vendor
+            this.untrack = trackMuxEmbeddedVideo(videoEl, this.handler);
+        }
+        else {
+            this.untrack = trackHtmlVideo(videoEl, this.handler, vendor);
+        }
+    }
+    VideoObserver.prototype.updateState = function (playbackState, event) {
+        var previousState = this.state;
+        var nextState = {
+            playbackState: playbackState,
+            lastEvent: event,
+        };
+        this.state = nextState;
+        try {
+            this.onStateChange(previousState, nextState);
+        }
+        catch (_error) {
+            // Swallow callback errors to keep observer state consistent.
+        }
+    };
+    VideoObserver.prototype.destroy = function () {
+        this.untrack();
+    };
+    return VideoObserver;
+}());
+export { VideoObserver };
+//# sourceMappingURL=video.js.map

package/lib/esm/observers/video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.js","sourceRoot":"","sources":["../../../src/observers/video.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAoBvF;IAsBE,uBAAY,EAAmE;YAAjE,OAAO,aAAA,EAAE,aAAa,mBAAA,EAAE,MAAM,YAAA,EAAE,UAAU,gBAAA;QAAxD,iBAQC;QA7BO,UAAK,GAAU;YACrB,aAAa,EAAE,QAAQ;SACxB,CAAC;QAIM,YAAO,GAAiB;YAC9B,MAAM,EAAE,UAAC,GAAe;gBACtB,KAAI,CAAC,WAAW,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YACnC,CAAC;YACD,OAAO,EAAE,UAAC,GAAe;gBACvB,KAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAClC,CAAC;YACD,OAAO,EAAE,UAAC,GAAe;gBACvB,KAAI,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACjC,CAAC;YACD,OAAO,EAAE;gBACP,KAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC5B,CAAC;SACF,CAAC;QAGA,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,UAAU,EAAE;YACd,qDAAqD;YACrD,IAAI,CAAC,OAAO,GAAG,qBAAqB,CAAC,OAA4B,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;SAClF;aAAM;YACL,IAAI,CAAC,OAAO,GAAG,cAAc,CAAC,OAA2B,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;SAClF;IACH,CAAC;IAEO,mCAAW,GAAnB,UAAoB,aAA4B,EAAE,KAAkB;QAClE,IAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC;QACjC,IAAM,SAAS,GAAU;YACvB,aAAa,eAAA;YACb,SAAS,EAAE,KAAK;SACjB,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,IAAI;YACF,IAAI,CAAC,aAAa,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;SAC9C;QAAC,OAAO,MAAM,EAAE;YACf,6DAA6D;SAC9D;IACH,CAAC;IAED,+BAAO,GAAP;QACE,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IACH,oBAAC;AAAD,CAAC,AAjDD,IAiDC","sourcesContent":["import { trackHtmlVideo, trackMuxEmbeddedVideo } from '../video-analytics/track-video';\nimport type { VideoHandler, VideoEvent, MuxEmbeddedPlayer, MuxElement } from '../video-analytics/types';\n\ntype PlaybackState = 'playing' | 'paused' | 'ended' | 'error';\n\ntype Vendor = 'mux'; // | 'vimeo' | 'youtube' | 'other'\n\ntype State = {\n  playbackState: PlaybackState;\n  errorMessage?: string;\n  lastEvent?: VideoEvent;\n};\n\ntype VideoObserverParams = {\n  videoEl: HTMLVideoElement | MuxEmbeddedPlayer | MuxElement;\n  onStateChange: (previousState: State, nextState: State) => void;\n  vendor?: Vendor;\n  isEmbedded?: boolean;\n};\n\nexport class VideoObserver {\n  private state: State = {\n    playbackState: 'paused',\n  };\n\n  private untrack: () => void;\n  private onStateChange: (previousState: State, nextState: State) => void;\n  private handler: VideoHandler = {\n    onPlay: (evt: VideoEvent) => {\n      this.updateState('playing', evt);\n    },\n    onPause: (evt: VideoEvent) => {\n      this.updateState('paused', evt);\n    },\n    onEnded: (evt: VideoEvent) => {\n      this.updateState('ended', evt);\n    },\n    onError: () => {\n      this.updateState('error');\n    },\n  };\n\n  constructor({ videoEl, onStateChange, vendor, isEmbedded }: VideoObserverParams) {\n    this.onStateChange = onStateChange;\n    if (isEmbedded) {\n      // TODO: support embedded iFrame video with no Vendor\n      this.untrack = trackMuxEmbeddedVideo(videoEl as MuxEmbeddedPlayer, this.handler);\n    } else {\n      this.untrack = trackHtmlVideo(videoEl as HTMLVideoElement, this.handler, vendor);\n    }\n  }\n\n  private updateState(playbackState: PlaybackState, event?: VideoEvent) {\n    const previousState = this.state;\n    const nextState: State = {\n      playbackState,\n      lastEvent: event,\n    };\n    this.state = nextState;\n    try {\n      this.onStateChange(previousState, nextState);\n    } catch (_error) {\n      // Swallow callback errors to keep observer state consistent.\n    }\n  }\n\n  destroy() {\n    this.untrack();\n  }\n}\n"]}

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

@@ -0,0 +1,21 @@
+import { VideoHandler, MuxEmbeddedPlayer, MuxElement } from './types';
+/**
+ * Track a standard HTML video element.
+ *
+ * @param videoEl - The HTML video element to track.
+ * @param handlers - The video handlers to call when on video lifecycle events.
+ * @returns A function to untrack the video.
+ */
+export declare function trackHtmlVideo(videoEl: HTMLVideoElement | MuxElement, handlers: VideoHandler, vendor?: 'mux'): () => void;
+/**
+ * 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 declare function trackMuxHtmlVideo(videoEl: MuxElement, handlers: VideoHandler): () => void;
+export declare function trackMuxEmbeddedVideo(player: MuxEmbeddedPlayer, handlers: VideoHandler): () => void;
+export declare function trackYoutubeEmbeddedVideo(): void;
+export declare function trackVimeoEmbeddedVideo(): void;
+//# sourceMappingURL=track-video.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"track-video.d.ts","sourceRoot":"","sources":["../../../src/video-analytics/track-video.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAc,iBAAiB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AA4ClF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,gBAAgB,GAAG,UAAU,EACtC,QAAQ,EAAE,YAAY,EACtB,MAAM,CAAC,EAAE,KAAK,cAkCf;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,cAE5E;AA8BD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,YAAY,cAuDtF;AAED,wBAAgB,yBAAyB,SAExC;AAED,wBAAgB,uBAAuB,SAEtC"}

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

@@ -0,0 +1,157 @@
+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) {
+    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));
+}
+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'),
+    };
+}
+/**
+ * Track a standard HTML video element.
+ *
+ * @param videoEl - The HTML 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 trackHtmlVideo(videoEl, handlers, vendor) {
+    var playHandler = function () {
+        var startEvent = __assign(__assign({}, getPlayData(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) : {}));
+        handlers.onPause(pauseEvent);
+    };
+    videoEl.addEventListener('pause', pauseHandler);
+    var endedHandler = function () {
+        var endedEvent = __assign(__assign({}, getEndData(videoEl)), (vendor === 'mux' ? getMuxMetadata(videoEl) : {}));
+        handlers.onEnded(endedEvent);
+    };
+    videoEl.addEventListener('ended', endedHandler);
+    return function () {
+        videoEl.removeEventListener('play', playHandler);
+        videoEl.removeEventListener('pause', pauseHandler);
+        videoEl.removeEventListener('ended', endedHandler);
+    };
+}
+/**
+ * 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 getMuxIframeMetadata(player, elem) {
+    return __awaiter(this, void 0, void 0, function () {
+        var _a, duration, currentTime, url, metadataVideoTitle, metadataVideoId, playerId;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0: return [4 /*yield*/, Promise.all([
+                        new Promise(function (resolve) { return player.getDuration(resolve); }),
+                        new Promise(function (resolve) { return player.getCurrentTime(resolve); }),
+                    ])];
+                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();
+                    }
+                    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,
+                        }];
+            }
+        });
+    });
+}
+export function trackMuxEmbeddedVideo(player, handlers) {
+    var onUnsubscribe = [];
+    var readyHandler = function () {
+        var elem = player.elem;
+        var playHandler = function () {
+            getMuxIframeMetadata(player, elem)
+                .then(function (playerState) {
+                var startEvent = __assign({}, playerState);
+                handlers.onPlay(startEvent);
+            })
+                .catch(function (error) {
+                handlers.onError("Error getting Mux 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)
+                .then(function (playerState) {
+                var pauseEvent = __assign({}, playerState);
+                handlers.onPause(pauseEvent);
+            })
+                .catch(function (error) {
+                handlers.onError("Error getting Mux 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)
+                .then(function (playerState) {
+                var endedEvent = __assign({}, playerState);
+                handlers.onEnded(endedEvent);
+            })
+                .catch(function (error) {
+                handlers.onError("Error getting Mux iframe metadata from 'ended' handler: ".concat(error));
+            });
+        };
+        player.on('ended', endedHandler);
+        onUnsubscribe.push(function () { return player.off('ended', endedHandler); });
+    };
+    player.on('ready', readyHandler);
+    return function () {
+        player.off('ready', readyHandler);
+        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

@@ -0,0 +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"]}

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

@@ -0,0 +1,36 @@
+export type VideoHandler = {
+    onPlay: (startEvent: VideoEvent) => void;
+    onPause: (pauseEvent: VideoEvent) => void;
+    onEnded: (endedEvent: VideoEvent) => void;
+    onError: (error: string) => void;
+};
+export type VideoEvent = {
+    program_duration: number;
+    playback_id?: string | undefined;
+    video_id?: string | undefined;
+    video_title?: string | undefined;
+    content_id?: string | undefined;
+    content_type?: string | undefined;
+    session_id?: string | undefined;
+    mux_playback_id?: string | undefined | null;
+    mux_video_id?: string | undefined | null;
+    mux_video_title?: string | undefined | null;
+    mux_session_id?: string | undefined | null;
+    last_position?: number | undefined | null;
+    percent_completed?: number;
+};
+type MuxEmbeddedPlayer = {
+    getCurrentTime: (cb: (time: number) => void) => void;
+    getDuration: (cb: (duration: number) => void) => void;
+    on: (event: string, callback: () => void) => void;
+    off: (event: string, callback: () => void) => void;
+    elem: HTMLIFrameElement;
+};
+type MuxElement = EventTarget & Element & {
+    duration: number;
+    currentTime: number;
+    play?: () => Promise<unknown>;
+    pause?: () => void;
+};
+export { MuxElement, MuxEmbeddedPlayer };
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +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"]}

package/package.json

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