@amplitude/plugin-autocapture-browser 1.23.6 → 1.24.0

package/lib/cjs/autocapture/track-click.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"track-click.d.ts","sourceRoot":"","sources":["../../../src/autocapture/track-click.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAmD,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACtG,OAAO,EAAc,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAA+B,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG3E,wBAAgB,WAAW,CAAC,EAC1B,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,gBAAgB,GACjB,EAAE;IACD,SAAS,EAAE,aAAa,CAAC;IACzB,cAAc,EAAE,oBAAoB,CAAC;IACrC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,gBAAgB,EAAE,kBAAkB,CAAC;CACtC,8BAkBA"}
+{"version":3,"file":"track-click.d.ts","sourceRoot":"","sources":["../../../src/autocapture/track-click.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAwD,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC3G,OAAO,EAAc,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAA+B,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG3E,wBAAgB,WAAW,CAAC,EAC1B,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,gBAAgB,GACjB,EAAE;IACD,SAAS,EAAE,aAAa,CAAC;IACzB,cAAc,EAAE,oBAAoB,CAAC;IACrC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,gBAAgB,EAAE,kBAAkB,CAAC;CACtC,8BAkBA"}

package/lib/cjs/autocapture/track-click.js.map

@@ -1 +1 @@
-{"version":3,"file":"track-click.js","sourceRoot":"","sources":["../../../src/autocapture/track-click.ts"],"names":[],"mappings":";;;AAGA,sCAA2E;AAC3E,0CAA+D;AAE/D,SAAgB,WAAW,CAAC,EAU3B;QATC,SAAS,eAAA,EACT,cAAc,oBAAA,EACd,gBAAgB,sBAAA,EAChB,gBAAgB,sBAAA;IAOR,IAAA,eAAe,GAAK,cAAc,gBAAnB,CAAoB;IAE3C,IAAM,uBAAuB,GAAG,eAAe;SAC5C,MAAM,CAAC,qCAA2B,CAAC;SACnC,MAAM,CAAC,UAAC,KAAK;QACZ,wDAAwD;QACxD,OAAO,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACjE,CAAC,CAAC;SACD,GAAG,CAAC,UAAC,KAAK,IAAK,OAAA,gBAAgB,CAAC,KAAK,CAAC,EAAvB,CAAuB,CAAC,CAAC;IAE3C,IAAM,MAAM,GACV,uBAAuB,CAAC;IAE1B,OAAO,MAAM,CAAC,SAAS,CAAC,UAAC,KAAsD;QAC7E,0BAA0B;QAC1B,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,KAAK,CAAC,2CAA+B,EAAE,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;AACL,CAAC;AA5BD,kCA4BC","sourcesContent":["import { AllWindowObservables } from '../autocapture-plugin';\nimport { ElementBasedEvent, ElementBasedTimestampedEvent, type evaluateTriggersFn } from '../helpers';\nimport { Observable, BrowserClient } from '@amplitude/analytics-core';\nimport { filterOutNonTrackableEvents, shouldTrackEvent } from '../helpers';\nimport { AMPLITUDE_ELEMENT_CLICKED_EVENT } from '../constants';\n\nexport function trackClicks({\n  amplitude,\n  allObservables,\n  shouldTrackEvent,\n  evaluateTriggers,\n}: {\n  amplitude: BrowserClient;\n  allObservables: AllWindowObservables;\n  shouldTrackEvent: shouldTrackEvent;\n  evaluateTriggers: evaluateTriggersFn;\n}) {\n  const { clickObservable } = allObservables;\n\n  const clickObservableFiltered = clickObservable\n    .filter(filterOutNonTrackableEvents)\n    .filter((click) => {\n      // Only track clicks on elements that should be tracked,\n      return shouldTrackEvent('click', click.closestTrackedAncestor);\n    })\n    .map((click) => evaluateTriggers(click));\n\n  const clicks: Observable<typeof clickObservableFiltered extends Observable<infer U> ? U : never> =\n    clickObservableFiltered;\n\n  return clicks.subscribe((click: ElementBasedTimestampedEvent<ElementBasedEvent>) => {\n    /* istanbul ignore next */\n    amplitude?.track(AMPLITUDE_ELEMENT_CLICKED_EVENT, click.targetElementProperties);\n  });\n}\n"]}
+{"version":3,"file":"track-click.js","sourceRoot":"","sources":["../../../src/autocapture/track-click.ts"],"names":[],"mappings":";;;AAGA,sCAA2E;AAC3E,0CAA+D;AAE/D,SAAgB,WAAW,CAAC,EAU3B;QATC,SAAS,eAAA,EACT,cAAc,oBAAA,EACd,gBAAgB,sBAAA,EAChB,gBAAgB,sBAAA;IAOR,IAAA,eAAe,GAAK,cAAc,gBAAnB,CAAoB;IAE3C,IAAM,uBAAuB,GAAG,eAAe;SAC5C,MAAM,CAAC,qCAA2B,CAAC;SACnC,MAAM,CAAC,UAAC,KAA+C;QACtD,wDAAwD;QACxD,OAAO,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACjE,CAAC,CAAC;SACD,GAAG,CAAC,UAAC,KAA+C,IAAK,OAAA,gBAAgB,CAAC,KAAK,CAAC,EAAvB,CAAuB,CAAC,CAAC;IAErF,IAAM,MAAM,GACV,uBAAuB,CAAC;IAE1B,OAAO,MAAM,CAAC,SAAS,CAAC,UAAC,KAAsD;QAC7E,0BAA0B;QAC1B,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,KAAK,CAAC,2CAA+B,EAAE,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;AACL,CAAC;AA5BD,kCA4BC","sourcesContent":["import { AllWindowObservables } from '../autocapture-plugin';\nimport { ElementBasedEvent, type ElementBasedTimestampedEvent, type evaluateTriggersFn } from '../helpers';\nimport { Observable, BrowserClient } from '@amplitude/analytics-core';\nimport { filterOutNonTrackableEvents, shouldTrackEvent } from '../helpers';\nimport { AMPLITUDE_ELEMENT_CLICKED_EVENT } from '../constants';\n\nexport function trackClicks({\n  amplitude,\n  allObservables,\n  shouldTrackEvent,\n  evaluateTriggers,\n}: {\n  amplitude: BrowserClient;\n  allObservables: AllWindowObservables;\n  shouldTrackEvent: shouldTrackEvent;\n  evaluateTriggers: evaluateTriggersFn;\n}) {\n  const { clickObservable } = allObservables;\n\n  const clickObservableFiltered = clickObservable\n    .filter(filterOutNonTrackableEvents)\n    .filter((click: ElementBasedTimestampedEvent<MouseEvent>) => {\n      // Only track clicks on elements that should be tracked,\n      return shouldTrackEvent('click', click.closestTrackedAncestor);\n    })\n    .map((click: ElementBasedTimestampedEvent<MouseEvent>) => evaluateTriggers(click));\n\n  const clicks: Observable<typeof clickObservableFiltered extends Observable<infer U> ? U : never> =\n    clickObservableFiltered;\n\n  return clicks.subscribe((click: ElementBasedTimestampedEvent<ElementBasedEvent>) => {\n    /* istanbul ignore next */\n    amplitude?.track(AMPLITUDE_ELEMENT_CLICKED_EVENT, click.targetElementProperties);\n  });\n}\n"]}

package/lib/cjs/autocapture/track-exposure.d.ts

@@ -0,0 +1,12 @@
+import { AllWindowObservables } from '../autocapture-plugin';
+import { DataExtractor } from '../data-extractor';
+export declare function trackExposure({ allObservables, onExposure, dataExtractor, exposureDuration, }: {
+    allObservables: AllWindowObservables;
+    onExposure: (elementPath: string) => void;
+    dataExtractor: DataExtractor;
+    exposureDuration?: number;
+}): {
+    unsubscribe: () => void;
+    reset: () => void;
+};
+//# sourceMappingURL=track-exposure.d.ts.map

package/lib/cjs/autocapture/track-exposure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-exposure.d.ts","sourceRoot":"","sources":["../../../src/autocapture/track-exposure.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,wBAAgB,aAAa,CAAC,EAC5B,cAAc,EACd,UAAU,EACV,aAAa,EACb,gBAA4C,GAC7C,EAAE;IACD,cAAc,EAAE,oBAAoB,CAAC;IACrC,UAAU,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;;;EAsDA"}

package/lib/cjs/autocapture/track-exposure.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trackExposure = void 0;
+/* eslint-disable no-restricted-globals */
+var analytics_core_1 = require("@amplitude/analytics-core");
+function trackExposure(_a) {
+    var allObservables = _a.allObservables, onExposure = _a.onExposure, dataExtractor = _a.dataExtractor, _b = _a.exposureDuration, exposureDuration = _b === void 0 ? analytics_core_1.DEFAULT_EXPOSURE_DURATION : _b;
+    // Track which elements have been marked as exposed (per-element state)
+    var exposureMap = new Map();
+    // Track active timers for elements that are currently visible but not yet exposed
+    var exposureTimerMap = new Map();
+    var exposureObservable = allObservables.exposureObservable;
+    var exposureSubscription = exposureObservable.subscribe(function (event) {
+        var entry = event;
+        var element = entry.target;
+        if (entry.isIntersecting) {
+            // Element became visible - start exposure timer if not already exposed
+            if (!exposureMap.get(element)) {
+                var timer = setTimeout(function () {
+                    // Element has been visible for exposureDuration - mark as exposed
+                    exposureMap.set(element, true);
+                    // Record the CSS selector path in the shared exposure state
+                    var elementPath = dataExtractor.getElementPath(element);
+                    onExposure(elementPath);
+                    // Clear the timer reference
+                    exposureTimerMap.set(element, null);
+                }, exposureDuration);
+                exposureTimerMap.set(element, timer);
+            }
+        }
+        else if (!entry.isIntersecting && entry.intersectionRatio < 1.0) {
+            // Element left viewport - cancel exposure timer if one exists
+            var timer = exposureTimerMap.get(element);
+            if (timer) {
+                clearTimeout(timer);
+                exposureTimerMap.set(element, null);
+            }
+        }
+    });
+    return {
+        unsubscribe: function () {
+            exposureSubscription.unsubscribe();
+        },
+        reset: function () {
+            exposureTimerMap.forEach(function (timer) {
+                if (timer) {
+                    clearTimeout(timer);
+                }
+            });
+            exposureTimerMap.clear();
+            exposureMap.clear();
+        },
+    };
+}
+exports.trackExposure = trackExposure;
+//# sourceMappingURL=track-exposure.js.map

package/lib/cjs/autocapture/track-exposure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-exposure.js","sourceRoot":"","sources":["../../../src/autocapture/track-exposure.ts"],"names":[],"mappings":";;;AAAA,0CAA0C;AAC1C,4DAAsE;AAItE,SAAgB,aAAa,CAAC,EAU7B;QATC,cAAc,oBAAA,EACd,UAAU,gBAAA,EACV,aAAa,mBAAA,EACb,wBAA4C,EAA5C,gBAAgB,mBAAG,0CAAyB,KAAA;IAO5C,uEAAuE;IACvE,IAAM,WAAW,GAAG,IAAI,GAAG,EAAoB,CAAC;IAEhD,kFAAkF;IAClF,IAAM,gBAAgB,GAAG,IAAI,GAAG,EAA6D,CAAC;IAEtF,IAAA,kBAAkB,GAAK,cAAc,mBAAnB,CAAoB;IAE9C,IAAM,oBAAoB,GAAG,kBAAkB,CAAC,SAAS,CAAC,UAAC,KAAK;QAC9D,IAAM,KAAK,GAAG,KAA6C,CAAC;QAC5D,IAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC;QAE7B,IAAI,KAAK,CAAC,cAAc,EAAE;YACxB,uEAAuE;YACvE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;gBAC7B,IAAM,KAAK,GAAG,UAAU,CAAC;oBACvB,kEAAkE;oBAClE,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;oBAE/B,4DAA4D;oBAC5D,IAAM,WAAW,GAAG,aAAa,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;oBAC1D,UAAU,CAAC,WAAW,CAAC,CAAC;oBAExB,4BAA4B;oBAC5B,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBACtC,CAAC,EAAE,gBAAgB,CAAC,CAAC;gBAErB,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;aACtC;SACF;aAAM,IAAI,CAAC,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,iBAAiB,GAAG,GAAG,EAAE;YACjE,8DAA8D;YAC9D,IAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC5C,IAAI,KAAK,EAAE;gBACT,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;aACrC;SACF;IACH,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,WAAW,EAAE;YACX,oBAAoB,CAAC,WAAW,EAAE,CAAC;QACrC,CAAC;QACD,KAAK,EAAE;YACL,gBAAgB,CAAC,OAAO,CAAC,UAAC,KAAK;gBAC7B,IAAI,KAAK,EAAE;oBACT,YAAY,CAAC,KAAK,CAAC,CAAC;iBACrB;YACH,CAAC,CAAC,CAAC;YACH,gBAAgB,CAAC,KAAK,EAAE,CAAC;YACzB,WAAW,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC;AAhED,sCAgEC","sourcesContent":["/* eslint-disable no-restricted-globals */\nimport { DEFAULT_EXPOSURE_DURATION } from '@amplitude/analytics-core';\nimport { AllWindowObservables } from '../autocapture-plugin';\nimport { DataExtractor } from '../data-extractor';\n\nexport function trackExposure({\n  allObservables,\n  onExposure,\n  dataExtractor,\n  exposureDuration = DEFAULT_EXPOSURE_DURATION,\n}: {\n  allObservables: AllWindowObservables;\n  onExposure: (elementPath: string) => void;\n  dataExtractor: DataExtractor;\n  exposureDuration?: number;\n}) {\n  // Track which elements have been marked as exposed (per-element state)\n  const exposureMap = new Map<Element, boolean>();\n\n  // Track active timers for elements that are currently visible but not yet exposed\n  const exposureTimerMap = new Map<Element, ReturnType<typeof setTimeout> | null | undefined>();\n\n  const { exposureObservable } = allObservables;\n\n  const exposureSubscription = exposureObservable.subscribe((event) => {\n    const entry = event as unknown as IntersectionObserverEntry;\n    const element = entry.target;\n\n    if (entry.isIntersecting) {\n      // Element became visible - start exposure timer if not already exposed\n      if (!exposureMap.get(element)) {\n        const timer = setTimeout(() => {\n          // Element has been visible for exposureDuration - mark as exposed\n          exposureMap.set(element, true);\n\n          // Record the CSS selector path in the shared exposure state\n          const elementPath = dataExtractor.getElementPath(element);\n          onExposure(elementPath);\n\n          // Clear the timer reference\n          exposureTimerMap.set(element, null);\n        }, exposureDuration);\n\n        exposureTimerMap.set(element, timer);\n      }\n    } else if (!entry.isIntersecting && entry.intersectionRatio < 1.0) {\n      // Element left viewport - cancel exposure timer if one exists\n      const timer = exposureTimerMap.get(element);\n      if (timer) {\n        clearTimeout(timer);\n        exposureTimerMap.set(element, null);\n      }\n    }\n  });\n\n  return {\n    unsubscribe: () => {\n      exposureSubscription.unsubscribe();\n    },\n    reset: () => {\n      exposureTimerMap.forEach((timer) => {\n        if (timer) {\n          clearTimeout(timer);\n        }\n      });\n      exposureTimerMap.clear();\n      exposureMap.clear();\n    },\n  };\n}\n"]}

package/lib/cjs/autocapture/track-scroll.d.ts

@@ -0,0 +1,15 @@
+import { AllWindowObservables } from '../autocapture-plugin';
+import { BrowserClient } from '@amplitude/analytics-core';
+export interface ScrollState {
+    maxX: number;
+    maxY: number;
+}
+export declare function trackScroll({ amplitude, allObservables, }: {
+    amplitude: BrowserClient;
+    allObservables: AllWindowObservables;
+}): {
+    unsubscribe: () => void;
+    getState: () => ScrollState;
+    reset: () => void;
+};
+//# sourceMappingURL=track-scroll.d.ts.map

package/lib/cjs/autocapture/track-scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-scroll.d.ts","sourceRoot":"","sources":["../../../src/autocapture/track-scroll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAkB,MAAM,2BAA2B,CAAC;AAE1E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,WAAW,CAAC,EAC1B,SAAS,EACT,cAAc,GACf,EAAE;IACD,SAAS,EAAE,aAAa,CAAC;IACzB,cAAc,EAAE,oBAAoB,CAAC;CACtC;;;;EA6BA"}

package/lib/cjs/autocapture/track-scroll.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trackScroll = void 0;
+var analytics_core_1 = require("@amplitude/analytics-core");
+function trackScroll(_a) {
+    var amplitude = _a.amplitude, allObservables = _a.allObservables;
+    // amplitude is reserved for future periodic scroll event tracking
+    void amplitude;
+    var scrollObservable = allObservables.scrollObservable;
+    var state = { maxX: 0, maxY: 0 };
+    var scrollSubscription = scrollObservable.subscribe(function () {
+        var _a, _b, _c, _d;
+        var globalScope = (0, analytics_core_1.getGlobalScope)();
+        /* istanbul ignore next */
+        var currentX = Math.floor((_b = (_a = globalScope === null || globalScope === void 0 ? void 0 : globalScope.scrollX) !== null && _a !== void 0 ? _a : globalScope === null || globalScope === void 0 ? void 0 : globalScope.pageXOffset) !== null && _b !== void 0 ? _b : 0);
+        /* istanbul ignore next */
+        var currentY = Math.floor((_d = (_c = globalScope === null || globalScope === void 0 ? void 0 : globalScope.scrollY) !== null && _c !== void 0 ? _c : globalScope === null || globalScope === void 0 ? void 0 : globalScope.pageYOffset) !== null && _d !== void 0 ? _d : 0);
+        // Update page-level max positions for Page View End event (never resets during page lifetime)
+        state.maxX = Math.max(state.maxX, currentX);
+        state.maxY = Math.max(state.maxY, currentY);
+    });
+    return {
+        unsubscribe: function () {
+            scrollSubscription.unsubscribe();
+        },
+        getState: function () { return state; },
+        reset: function () {
+            state.maxX = 0;
+            state.maxY = 0;
+        },
+    };
+}
+exports.trackScroll = trackScroll;
+//# sourceMappingURL=track-scroll.js.map

package/lib/cjs/autocapture/track-scroll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-scroll.js","sourceRoot":"","sources":["../../../src/autocapture/track-scroll.ts"],"names":[],"mappings":";;;AACA,4DAA0E;AAO1E,SAAgB,WAAW,CAAC,EAM3B;QALC,SAAS,eAAA,EACT,cAAc,oBAAA;IAKd,kEAAkE;IAClE,KAAK,SAAS,CAAC;IAEP,IAAA,gBAAgB,GAAK,cAAc,iBAAnB,CAAoB;IAC5C,IAAM,KAAK,GAAgB,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAEhD,IAAM,kBAAkB,GAAG,gBAAgB,CAAC,SAAS,CAAC;;QACpD,IAAM,WAAW,GAAG,IAAA,+BAAc,GAAE,CAAC;QACrC,0BAA0B;QAC1B,IAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAA,MAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,OAAO,mCAAI,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,WAAW,mCAAI,CAAC,CAAC,CAAC;QACnF,0BAA0B;QAC1B,IAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAA,MAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,OAAO,mCAAI,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,WAAW,mCAAI,CAAC,CAAC,CAAC;QAEnF,8FAA8F;QAC9F,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC5C,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,WAAW,EAAE;YACX,kBAAkB,CAAC,WAAW,EAAE,CAAC;QACnC,CAAC;QACD,QAAQ,EAAE,cAAM,OAAA,KAAK,EAAL,CAAK;QACrB,KAAK,EAAE;YACL,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC;AAnCD,kCAmCC","sourcesContent":["import { AllWindowObservables } from '../autocapture-plugin';\nimport { BrowserClient, getGlobalScope } from '@amplitude/analytics-core';\n\nexport interface ScrollState {\n  maxX: number;\n  maxY: number;\n}\n\nexport function trackScroll({\n  amplitude,\n  allObservables,\n}: {\n  amplitude: BrowserClient;\n  allObservables: AllWindowObservables;\n}) {\n  // amplitude is reserved for future periodic scroll event tracking\n  void amplitude;\n\n  const { scrollObservable } = allObservables;\n  const state: ScrollState = { maxX: 0, maxY: 0 };\n\n  const scrollSubscription = scrollObservable.subscribe(() => {\n    const globalScope = getGlobalScope();\n    /* istanbul ignore next */\n    const currentX = Math.floor(globalScope?.scrollX ?? globalScope?.pageXOffset ?? 0);\n    /* istanbul ignore next */\n    const currentY = Math.floor(globalScope?.scrollY ?? globalScope?.pageYOffset ?? 0);\n\n    // Update page-level max positions for Page View End event (never resets during page lifetime)\n    state.maxX = Math.max(state.maxX, currentX);\n    state.maxY = Math.max(state.maxY, currentY);\n  });\n\n  return {\n    unsubscribe: () => {\n      scrollSubscription.unsubscribe();\n    },\n    getState: () => state,\n    reset: () => {\n      state.maxX = 0;\n      state.maxY = 0;\n    },\n  };\n}\n"]}

package/lib/cjs/autocapture/track-viewport-content-updated.d.ts

@@ -0,0 +1,25 @@
+import { BrowserClient } from '@amplitude/analytics-core';
+export interface ScrollTracker {
+    getState: () => {
+        maxX: number;
+        maxY: number;
+    };
+    reset: () => void;
+}
+export interface ExposureTracker {
+    reset: () => void;
+}
+export declare function fireViewportContentUpdated({ amplitude, scrollTracker, currentElementExposed, elementExposedForPage, exposureTracker, isPageEnd, lastScroll, }: {
+    amplitude: BrowserClient;
+    scrollTracker: ScrollTracker;
+    currentElementExposed: Set<string>;
+    elementExposedForPage: Set<string>;
+    exposureTracker: ExposureTracker | undefined;
+    isPageEnd: boolean;
+    lastScroll: {
+        maxX: undefined | number;
+        maxY: undefined | number;
+    };
+}): void;
+export declare function onExposure(elementPath: string, elementExposedForPage: Set<string>, currentElementExposed: Set<string>, fireViewportContentUpdatedCallback: (isPageEnd: boolean) => void): void;
+//# sourceMappingURL=track-viewport-content-updated.d.ts.map

package/lib/cjs/autocapture/track-viewport-content-updated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-viewport-content-updated.d.ts","sourceRoot":"","sources":["../../../src/autocapture/track-viewport-content-updated.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,2BAA2B,CAAC;AAI1E,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,wBAAgB,0BAA0B,CAAC,EACzC,SAAS,EACT,aAAa,EACb,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,SAAS,EACT,UAAU,GACX,EAAE;IACD,SAAS,EAAE,aAAa,CAAC;IACzB,aAAa,EAAE,aAAa,CAAC;IAC7B,qBAAqB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,qBAAqB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,eAAe,EAAE,eAAe,GAAG,SAAS,CAAC;IAC7C,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE;QAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAAA;KAAE,CAAC;CACpE,GAAG,IAAI,CAqDP;AAED,wBAAgB,UAAU,CACxB,WAAW,EAAE,MAAM,EACnB,qBAAqB,EAAE,GAAG,CAAC,MAAM,CAAC,EAClC,qBAAqB,EAAE,GAAG,CAAC,MAAM,CAAC,EAClC,kCAAkC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,QAejE"}

package/lib/cjs/autocapture/track-viewport-content-updated.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onExposure = exports.fireViewportContentUpdated = void 0;
+var tslib_1 = require("tslib");
+var analytics_core_1 = require("@amplitude/analytics-core");
+var constants = tslib_1.__importStar(require("../constants"));
+var helpers_1 = require("../helpers");
+function fireViewportContentUpdated(_a) {
+    var _b;
+    var _c, _d, _e;
+    var amplitude = _a.amplitude, scrollTracker = _a.scrollTracker, currentElementExposed = _a.currentElementExposed, elementExposedForPage = _a.elementExposedForPage, exposureTracker = _a.exposureTracker, isPageEnd = _a.isPageEnd, lastScroll = _a.lastScroll;
+    var pageScrollMaxState = scrollTracker.getState();
+    var globalScope = (0, analytics_core_1.getGlobalScope)();
+    /* istanbul ignore next */
+    var viewportWidth = (_c = globalScope === null || globalScope === void 0 ? void 0 : globalScope.innerWidth) !== null && _c !== void 0 ? _c : 0;
+    /* istanbul ignore next */
+    var viewportHeight = (_d = globalScope === null || globalScope === void 0 ? void 0 : globalScope.innerHeight) !== null && _d !== void 0 ? _d : 0;
+    var eventProperties = (_b = {},
+        _b[constants.AMPLITUDE_EVENT_PROP_PAGE_URL] = 
+        /* istanbul ignore next */
+        (_e = globalScope === null || globalScope === void 0 ? void 0 : globalScope.location) === null || _e === void 0 ? void 0 : _e.href,
+        _b[constants.AMPLITUDE_EVENT_PROP_MAX_PAGE_X] = pageScrollMaxState.maxX + viewportWidth,
+        _b[constants.AMPLITUDE_EVENT_PROP_MAX_PAGE_Y] = pageScrollMaxState.maxY + viewportHeight,
+        _b[constants.AMPLITUDE_EVENT_PROP_VIEWPORT_HEIGHT] = viewportHeight,
+        _b[constants.AMPLITUDE_EVENT_PROP_VIEWPORT_WIDTH] = viewportWidth,
+        _b['[Amplitude] Element Exposed'] = Array.from(currentElementExposed),
+        _b);
+    var pageViewId = (0, helpers_1.getCurrentPageViewId)();
+    if (pageViewId) {
+        eventProperties[constants.AMPLITUDE_EVENT_PROP_PAGE_VIEW_ID] = pageViewId;
+    }
+    // If elements exposed is empty and max scroll is same as last event, don't track
+    if (currentElementExposed.size === 0 &&
+        pageScrollMaxState.maxX === lastScroll.maxX &&
+        pageScrollMaxState.maxY === lastScroll.maxY) {
+        if (isPageEnd) {
+            scrollTracker.reset();
+            elementExposedForPage.clear();
+            exposureTracker === null || exposureTracker === void 0 ? void 0 : exposureTracker.reset();
+        }
+        return;
+    }
+    /* istanbul ignore next */
+    amplitude === null || amplitude === void 0 ? void 0 : amplitude.track('[Amplitude] Viewport Content Updated', eventProperties);
+    lastScroll.maxX = pageScrollMaxState.maxX;
+    lastScroll.maxY = pageScrollMaxState.maxY;
+    // Clear current batch
+    currentElementExposed.clear();
+    if (isPageEnd) {
+        // Reset state for next page view
+        scrollTracker.reset();
+        elementExposedForPage.clear();
+        exposureTracker === null || exposureTracker === void 0 ? void 0 : exposureTracker.reset();
+    }
+}
+exports.fireViewportContentUpdated = fireViewportContentUpdated;
+function onExposure(elementPath, elementExposedForPage, currentElementExposed, fireViewportContentUpdatedCallback) {
+    if (elementExposedForPage.has(elementPath)) {
+        return;
+    }
+    elementExposedForPage.add(elementPath);
+    currentElementExposed.add(elementPath);
+    // Check if current set size exceeds 18k chars
+    var exposedArray = Array.from(currentElementExposed);
+    var exposedString = JSON.stringify(exposedArray);
+    if (exposedString.length >= constants.MAX_ELEMENT_EXPOSED_STR_LENGTH) {
+        fireViewportContentUpdatedCallback(false);
+    }
+}
+exports.onExposure = onExposure;
+//# sourceMappingURL=track-viewport-content-updated.js.map

package/lib/cjs/autocapture/track-viewport-content-updated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-viewport-content-updated.js","sourceRoot":"","sources":["../../../src/autocapture/track-viewport-content-updated.ts"],"names":[],"mappings":"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","sourcesContent":["import { BrowserClient, getGlobalScope } from '@amplitude/analytics-core';\nimport * as constants from '../constants';\nimport { getCurrentPageViewId } from '../helpers';\n\nexport interface ScrollTracker {\n  getState: () => { maxX: number; maxY: number };\n  reset: () => void;\n}\n\nexport interface ExposureTracker {\n  reset: () => void;\n}\n\nexport function fireViewportContentUpdated({\n  amplitude,\n  scrollTracker,\n  currentElementExposed,\n  elementExposedForPage,\n  exposureTracker,\n  isPageEnd,\n  lastScroll,\n}: {\n  amplitude: BrowserClient;\n  scrollTracker: ScrollTracker;\n  currentElementExposed: Set<string>;\n  elementExposedForPage: Set<string>;\n  exposureTracker: ExposureTracker | undefined;\n  isPageEnd: boolean;\n  lastScroll: { maxX: undefined | number; maxY: undefined | number };\n}): void {\n  const pageScrollMaxState = scrollTracker.getState();\n  const globalScope = getGlobalScope();\n\n  /* istanbul ignore next */\n  const viewportWidth = globalScope?.innerWidth ?? 0;\n  /* istanbul ignore next */\n  const viewportHeight = globalScope?.innerHeight ?? 0;\n\n  const eventProperties: Record<string, unknown> = {\n    [constants.AMPLITUDE_EVENT_PROP_PAGE_URL]:\n      /* istanbul ignore next */\n      globalScope?.location?.href,\n    [constants.AMPLITUDE_EVENT_PROP_MAX_PAGE_X]: pageScrollMaxState.maxX + viewportWidth,\n    [constants.AMPLITUDE_EVENT_PROP_MAX_PAGE_Y]: pageScrollMaxState.maxY + viewportHeight,\n    [constants.AMPLITUDE_EVENT_PROP_VIEWPORT_HEIGHT]: viewportHeight,\n    [constants.AMPLITUDE_EVENT_PROP_VIEWPORT_WIDTH]: viewportWidth,\n    '[Amplitude] Element Exposed': Array.from(currentElementExposed),\n  };\n\n  const pageViewId = getCurrentPageViewId();\n  if (pageViewId) {\n    eventProperties[constants.AMPLITUDE_EVENT_PROP_PAGE_VIEW_ID] = pageViewId;\n  }\n\n  // If elements exposed is empty and max scroll is same as last event, don't track\n  if (\n    currentElementExposed.size === 0 &&\n    pageScrollMaxState.maxX === lastScroll.maxX &&\n    pageScrollMaxState.maxY === lastScroll.maxY\n  ) {\n    if (isPageEnd) {\n      scrollTracker.reset();\n      elementExposedForPage.clear();\n      exposureTracker?.reset();\n    }\n    return;\n  }\n\n  /* istanbul ignore next */\n  amplitude?.track('[Amplitude] Viewport Content Updated', eventProperties);\n  lastScroll.maxX = pageScrollMaxState.maxX;\n  lastScroll.maxY = pageScrollMaxState.maxY;\n\n  // Clear current batch\n  currentElementExposed.clear();\n\n  if (isPageEnd) {\n    // Reset state for next page view\n    scrollTracker.reset();\n    elementExposedForPage.clear();\n    exposureTracker?.reset();\n  }\n}\n\nexport function onExposure(\n  elementPath: string,\n  elementExposedForPage: Set<string>,\n  currentElementExposed: Set<string>,\n  fireViewportContentUpdatedCallback: (isPageEnd: boolean) => void,\n) {\n  if (elementExposedForPage.has(elementPath)) {\n    return;\n  }\n  elementExposedForPage.add(elementPath);\n  currentElementExposed.add(elementPath);\n\n  // Check if current set size exceeds 18k chars\n  const exposedArray = Array.from(currentElementExposed);\n  const exposedString = JSON.stringify(exposedArray);\n\n  if (exposedString.length >= constants.MAX_ELEMENT_EXPOSED_STR_LENGTH) {\n    fireViewportContentUpdatedCallback(false);\n  }\n}\n"]}

package/lib/cjs/autocapture-plugin.d.ts

@@ -17,6 +17,8 @@ export declare enum ObservablesEnum {
     ChangeObservable = "changeObservable",
     NavigateObservable = "navigateObservable",
     MutationObservable = "mutationObservable",
+    ScrollObservable = "scrollObservable",
+    ExposureObservable = "exposureObservable",
     BrowserErrorObservable = "browserErrorObservable",
     SelectionObservable = "selectionObservable",
     MouseMoveObservable = "mouseMoveObservable"
@@ -26,6 +28,8 @@ export interface AllWindowObservables {
     [ObservablesEnum.ClickObservable]: Observable<ElementBasedTimestampedEvent<MouseEvent>>;
     [ObservablesEnum.MutationObservable]: Observable<TimestampedEvent<MutationRecord[]>>;
     [ObservablesEnum.NavigateObservable]?: Observable<TimestampedEvent<NavigateEvent>>;
+    [ObservablesEnum.ScrollObservable]: Observable<Event>;
+    [ObservablesEnum.ExposureObservable]: Observable<Event>;
     [ObservablesEnum.SelectionObservable]?: Observable<void>;
 }
 export declare const autocapturePlugin: (options?: ElementInteractionsOptions, context?: {

package/lib/cjs/autocapture-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"autocapture-plugin.d.ts","sourceRoot":"","sources":["../../src/autocapture-plugin.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,0BAA0B,EAI/B,kBAAkB,EAKnB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAEL,KAAK,4BAA4B,EACjC,KAAK,gBAAgB,EACrB,KAAK,aAAa,EACnB,MAAM,WAAW,CAAC;AAanB,OAAO,EAAE,UAAU,EAAkB,MAAM,2BAA2B,CAAC;AAEvE,KAAK,cAAc,GAAG;IACpB,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,kCAAkC,KAAK,IAAI,CAAC;IACvF,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,kCAAkC,KAAK,IAAI,CAAC;CAC3F,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,UAAU,EAAE,cAAc,CAAC;KAC5B;CACF;AAED,KAAK,uBAAuB,GAAG,gBAAgB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;AAE9E,MAAM,MAAM,8BAA8B,GAAG,QAAQ,CACnD,IAAI,CAAC,0BAA0B,EAAE,cAAc,GAAG,sBAAsB,GAAG,sBAAsB,CAAC,CACnG,GACC,0BAA0B,CAAC;AAE7B,oBAAY,eAAe;IACzB,eAAe,oBAAoB;IACnC,gBAAgB,qBAAqB;IAErC,kBAAkB,uBAAuB;IACzC,kBAAkB,uBAAuB;IACzC,sBAAsB,2BAA2B;IACjD,mBAAmB,wBAAwB;IAC3C,mBAAmB,wBAAwB;CAC5C;AAED,MAAM,WAAW,oBAAoB;IACnC,CAAC,eAAe,CAAC,gBAAgB,CAAC,EAAE,UAAU,CAAC,4BAA4B,CAAC,KAAK,CAAC,CAAC,CAAC;IAEpF,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC,4BAA4B,CAAC,UAAU,CAAC,CAAC,CAAC;IACxF,CAAC,eAAe,CAAC,kBAAkB,CAAC,EAAE,UAAU,CAAC,gBAAgB,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;IACrF,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC,EAAE,UAAU,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC;IACnF,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;CAC1D;AAED,eAAO,MAAM,iBAAiB,aACnB,0BAA0B,YACzB;IAAE,iBAAiB,EAAE,kBAAkB,CAAA;CAAE,KAClD,uBAsQF,CAAC"}
+{"version":3,"file":"autocapture-plugin.d.ts","sourceRoot":"","sources":["../../src/autocapture-plugin.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,0BAA0B,EAK/B,kBAAkB,EAKnB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAEL,KAAK,4BAA4B,EACjC,KAAK,gBAAgB,EACrB,KAAK,aAAa,EACnB,MAAM,WAAW,CAAC;AAoBnB,OAAO,EAAE,UAAU,EAAkB,MAAM,2BAA2B,CAAC;AAIvE,KAAK,cAAc,GAAG;IACpB,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,kCAAkC,KAAK,IAAI,CAAC;IACvF,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,kCAAkC,KAAK,IAAI,CAAC;CAC3F,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,UAAU,EAAE,cAAc,CAAC;KAC5B;CACF;AAED,KAAK,uBAAuB,GAAG,gBAAgB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;AAE9E,MAAM,MAAM,8BAA8B,GAAG,QAAQ,CACnD,IAAI,CAAC,0BAA0B,EAAE,cAAc,GAAG,sBAAsB,GAAG,sBAAsB,CAAC,CACnG,GACC,0BAA0B,CAAC;AAE7B,oBAAY,eAAe;IACzB,eAAe,oBAAoB;IACnC,gBAAgB,qBAAqB;IACrC,kBAAkB,uBAAuB;IACzC,kBAAkB,uBAAuB;IACzC,gBAAgB,qBAAqB;IACrC,kBAAkB,uBAAuB;IACzC,sBAAsB,2BAA2B;IACjD,mBAAmB,wBAAwB;IAC3C,mBAAmB,wBAAwB;CAC5C;AAED,MAAM,WAAW,oBAAoB;IACnC,CAAC,eAAe,CAAC,gBAAgB,CAAC,EAAE,UAAU,CAAC,4BAA4B,CAAC,KAAK,CAAC,CAAC,CAAC;IAEpF,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC,4BAA4B,CAAC,UAAU,CAAC,CAAC,CAAC;IACxF,CAAC,eAAe,CAAC,kBAAkB,CAAC,EAAE,UAAU,CAAC,gBAAgB,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;IACrF,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC,EAAE,UAAU,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC;IACnF,CAAC,eAAe,CAAC,gBAAgB,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IACtD,CAAC,eAAe,CAAC,kBAAkB,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;CAC1D;AAED,eAAO,MAAM,iBAAiB,aACnB,0BAA0B,YACzB;IAAE,iBAAiB,EAAE,kBAAkB,CAAA;CAAE,KAClD,uBA6XF,CAAC"}

package/lib/cjs/autocapture-plugin.js

@@ -11,34 +11,40 @@ var messenger_1 = require("./libs/messenger");
 var track_click_1 = require("./autocapture/track-click");
 var track_change_1 = require("./autocapture/track-change");
 var track_action_click_1 = require("./autocapture/track-action-click");
+var track_scroll_1 = require("./autocapture/track-scroll");
 var observables_1 = require("./observables");
 var triggers_1 = require("./pageActions/triggers");
 var data_extractor_1 = require("./data-extractor");
 var analytics_core_2 = require("@amplitude/analytics-core");
+var track_exposure_1 = require("./autocapture/track-exposure");
+var track_viewport_content_updated_1 = require("./autocapture/track-viewport-content-updated");
 var ObservablesEnum;
 (function (ObservablesEnum) {
     ObservablesEnum["ClickObservable"] = "clickObservable";
     ObservablesEnum["ChangeObservable"] = "changeObservable";
-    // ErrorObservable = 'errorObservable',
     ObservablesEnum["NavigateObservable"] = "navigateObservable";
     ObservablesEnum["MutationObservable"] = "mutationObservable";
+    ObservablesEnum["ScrollObservable"] = "scrollObservable";
+    ObservablesEnum["ExposureObservable"] = "exposureObservable";
     ObservablesEnum["BrowserErrorObservable"] = "browserErrorObservable";
     ObservablesEnum["SelectionObservable"] = "selectionObservable";
     ObservablesEnum["MouseMoveObservable"] = "mouseMoveObservable";
 })(ObservablesEnum = exports.ObservablesEnum || (exports.ObservablesEnum = {}));
 var autocapturePlugin = function (options, context) {
-    var _a, _b, _c, _d, _e, _f, _g, _h;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
     if (options === void 0) { options = {}; }
     // Set the plugin version tag
     // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
     context === null || context === void 0 ? void 0 : context.diagnosticsClient.setTag('plugin.autocapture.version', version_1.VERSION);
-    var _j = options.dataAttributePrefix, dataAttributePrefix = _j === void 0 ? analytics_core_1.DEFAULT_DATA_ATTRIBUTE_PREFIX : _j, _k = options.visualTaggingOptions, visualTaggingOptions = _k === void 0 ? {
+    var _m = options.dataAttributePrefix, dataAttributePrefix = _m === void 0 ? analytics_core_1.DEFAULT_DATA_ATTRIBUTE_PREFIX : _m, _o = options.visualTaggingOptions, visualTaggingOptions = _o === void 0 ? {
         enabled: true,
-    } : _k;
+    } : _o;
     options.cssSelectorAllowlist = (_a = options.cssSelectorAllowlist) !== null && _a !== void 0 ? _a : analytics_core_1.DEFAULT_CSS_SELECTOR_ALLOWLIST;
     options.actionClickAllowlist = (_b = options.actionClickAllowlist) !== null && _b !== void 0 ? _b : analytics_core_1.DEFAULT_ACTION_CLICK_ALLOWLIST;
     options.debounceTime = (_c = options.debounceTime) !== null && _c !== void 0 ? _c : 0;
-    options.pageUrlExcludelist = (_d = options.pageUrlExcludelist) === null || _d === void 0 ? void 0 : _d.reduce(function (acc, excludePattern) {
+    var resolvedExposureDuration = (_f = (_e = (_d = options.viewportContentUpdated) === null || _d === void 0 ? void 0 : _d.exposureDuration) !== null && _e !== void 0 ? _e : options.exposureDuration) !== null && _f !== void 0 ? _f : analytics_core_1.DEFAULT_EXPOSURE_DURATION;
+    options.viewportContentUpdated = tslib_1.__assign(tslib_1.__assign({}, options.viewportContentUpdated), { exposureDuration: resolvedExposureDuration });
+    options.pageUrlExcludelist = (_g = options.pageUrlExcludelist) === null || _g === void 0 ? void 0 : _g.reduce(function (acc, excludePattern) {
         if (typeof excludePattern === 'string') {
             acc.push(excludePattern);
         }
@@ -59,9 +65,13 @@ var autocapturePlugin = function (options, context) {
     var name = constants.PLUGIN_NAME;
     var type = 'enrichment';
     var subscriptions = [];
-    // Create data extractor based on options
     var dataExtractor = new data_extractor_1.DataExtractor(options, context);
-    // Create observables on events on the window
+    // Page-level state shared across trackers, emitted in a single Page View End event on beforeunload
+    // elementExposedForPage holds the total set of elements seen during the entire page view lifetime
+    var elementExposedForPage = new Set();
+    // currentElementExposed only holds the set of elements that will be flushed during the next [Amplitude] Viewport Content Updated event
+    var currentElementExposed = new Set();
+    var beforeUnloadCleanup;
     var createObservables = function () {
         var _a;
         var clickObservable = (0, analytics_core_1.multicast)((0, observables_1.createClickObservable)().map(function (click) {
@@ -78,10 +88,6 @@ var autocapturePlugin = function (options, context) {
             /* istanbul ignore next */
             return function () { var _a; return (_a = (0, analytics_core_1.getGlobalScope)()) === null || _a === void 0 ? void 0 : _a.document.removeEventListener('change', handler); };
         }));
-        // Create Observable from unhandled errors
-        // const errorObservable = fromEvent<ErrorEvent>(window, 'error').pipe(
-        //   map((error) => addAdditionalEventProperties(error, 'error')),
-        // );
         // Create observable for URL changes
         var navigateObservable;
         /* istanbul ignore next */
@@ -100,17 +106,21 @@ var autocapturePlugin = function (options, context) {
         var mutationObservable = (0, analytics_core_1.multicast)((0, observables_1.createMutationObservable)().map(function (mutation) {
             return dataExtractor.addAdditionalEventProperties(mutation, 'mutation', options.cssSelectorAllowlist, dataAttributePrefix);
         }));
+        var scrollObservable = (0, observables_1.createScrollObservable)();
+        var exposureObservable = (0, observables_1.createExposureObservable)(mutationObservable, options.cssSelectorAllowlist);
         return _a = {},
             _a[ObservablesEnum.ChangeObservable] = changeObservable,
             // [ObservablesEnum.ErrorObservable]: errorObservable,
             _a[ObservablesEnum.ClickObservable] = clickObservable,
             _a[ObservablesEnum.MutationObservable] = mutationObservable,
             _a[ObservablesEnum.NavigateObservable] = navigateObservable,
+            _a[ObservablesEnum.ScrollObservable] = scrollObservable,
+            _a[ObservablesEnum.ExposureObservable] = exposureObservable,
             _a;
     };
     // Group labeled events by event type (eg. click, change)
-    var groupedLabeledEvents = (0, triggers_1.groupLabeledEventIdsByEventType)(Object.values((_f = (_e = options.pageActions) === null || _e === void 0 ? void 0 : _e.labeledEvents) !== null && _f !== void 0 ? _f : {}));
-    var labeledEventToTriggerMap = (0, triggers_1.createLabeledEventToTriggerMap)((_h = (_g = options.pageActions) === null || _g === void 0 ? void 0 : _g.triggers) !== null && _h !== void 0 ? _h : []);
+    var groupedLabeledEvents = (0, triggers_1.groupLabeledEventIdsByEventType)(Object.values((_j = (_h = options.pageActions) === null || _h === void 0 ? void 0 : _h.labeledEvents) !== null && _j !== void 0 ? _j : {}));
+    var labeledEventToTriggerMap = (0, triggers_1.createLabeledEventToTriggerMap)((_l = (_k = options.pageActions) === null || _k === void 0 ? void 0 : _k.triggers) !== null && _l !== void 0 ? _l : []);
     // Evaluate triggers for the given event by running the actions associated with the matching triggers
     var evaluateTriggers = (0, triggers_1.createTriggerEvaluator)(groupedLabeledEvents, labeledEventToTriggerMap, dataExtractor, options);
     // Function to recalculate internal variables when remote config is updated
@@ -127,13 +137,15 @@ var autocapturePlugin = function (options, context) {
         }
     };
     var setup = function (config, amplitude) { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
-        var shouldTrackEvent, shouldTrackActionClick, allObservables, clickTrackingSubscription, changeSubscription, actionClickSubscription, allowlist, actionClickAllowlist, messenger;
+        var pageViewEndFired, lastScroll, shouldTrackEvent, shouldTrackActionClick, allObservables, clickTrackingSubscription, changeSubscription, actionClickSubscription, scrollTracker, trackers, globalScope, handleViewportContentUpdated, handleExposure, beforeUnloadHandler, navigateObservable, popstateHandler_1, originalPushState_1, allowlist, actionClickAllowlist, messenger;
         var _a;
         return tslib_1.__generator(this, function (_b) {
             /* istanbul ignore if */
             if (typeof document === 'undefined') {
                 return [2 /*return*/];
             }
+            pageViewEndFired = false;
+            lastScroll = { maxX: undefined, maxY: undefined };
             // Fetch remote config for pageActions in a non-blocking manner
             if (config.fetchRemoteConfig) {
                 if (!config.remoteConfigClient) {
@@ -187,6 +199,89 @@ var autocapturePlugin = function (options, context) {
             if (actionClickSubscription) {
                 subscriptions.push(actionClickSubscription);
             }
+            scrollTracker = (0, track_scroll_1.trackScroll)({
+                allObservables: allObservables,
+                amplitude: amplitude,
+            });
+            subscriptions.push(scrollTracker);
+            trackers = {};
+            globalScope = (0, analytics_core_1.getGlobalScope)();
+            handleViewportContentUpdated = function (isPageEnd) {
+                if (isPageEnd && pageViewEndFired) {
+                    return;
+                }
+                setTimeout(function () {
+                    pageViewEndFired = false;
+                }, 100);
+                pageViewEndFired = true;
+                (0, track_viewport_content_updated_1.fireViewportContentUpdated)({
+                    amplitude: amplitude,
+                    scrollTracker: scrollTracker,
+                    currentElementExposed: currentElementExposed,
+                    elementExposedForPage: elementExposedForPage,
+                    exposureTracker: trackers.exposure,
+                    isPageEnd: isPageEnd,
+                    lastScroll: lastScroll,
+                });
+            };
+            handleExposure = function (elementPath) {
+                (0, track_viewport_content_updated_1.onExposure)(elementPath, elementExposedForPage, currentElementExposed, handleViewportContentUpdated);
+            };
+            trackers.exposure = (0, track_exposure_1.trackExposure)({
+                allObservables: allObservables,
+                onExposure: handleExposure,
+                dataExtractor: dataExtractor,
+                exposureDuration: resolvedExposureDuration,
+            });
+            if (trackers.exposure) {
+                subscriptions.push(trackers.exposure);
+            }
+            beforeUnloadHandler = function () {
+                handleViewportContentUpdated(true);
+            };
+            /* istanbul ignore next */
+            globalScope === null || globalScope === void 0 ? void 0 : globalScope.addEventListener('beforeunload', beforeUnloadHandler);
+            beforeUnloadCleanup = function () {
+                /* istanbul ignore next */
+                globalScope === null || globalScope === void 0 ? void 0 : globalScope.removeEventListener('beforeunload', beforeUnloadHandler);
+            };
+            // Ensure cleanup on teardown as well
+            subscriptions.push({ unsubscribe: function () { return beforeUnloadCleanup(); } });
+            navigateObservable = allObservables[ObservablesEnum.NavigateObservable];
+            if (navigateObservable) {
+                subscriptions.push(navigateObservable.subscribe(function () {
+                    handleViewportContentUpdated(true);
+                }));
+            }
+            else if (globalScope) {
+                popstateHandler_1 = function () {
+                    handleViewportContentUpdated(true);
+                };
+                /* istanbul ignore next */
+                // Fallback for SPA tracking when Navigation API is not available
+                globalScope.addEventListener('popstate', popstateHandler_1);
+                originalPushState_1 = globalScope.history.pushState;
+                if (globalScope.history && originalPushState_1) {
+                    // eslint-disable-next-line @typescript-eslint/unbound-method
+                    globalScope.history.pushState = new Proxy(originalPushState_1, {
+                        apply: function (target, thisArg, _a) {
+                            var _b = tslib_1.__read(_a, 3), state = _b[0], unused = _b[1], url = _b[2];
+                            target.apply(thisArg, [state, unused, url]);
+                            handleViewportContentUpdated(true);
+                        },
+                    });
+                }
+                subscriptions.push({
+                    unsubscribe: function () {
+                        /* istanbul ignore next */
+                        globalScope.removeEventListener('popstate', popstateHandler_1);
+                        /* istanbul ignore next */
+                        if (globalScope.history && originalPushState_1) {
+                            globalScope.history.pushState = originalPushState_1;
+                        }
+                    },
+                });
+            }
             /* istanbul ignore next */
             (_a = config === null || config === void 0 ? void 0 : config.loggerProvider) === null || _a === void 0 ? void 0 : _a.log("".concat(name, " has been successfully added."));
             // Setup visual tagging and background capture on the shared messenger singleton.