@schibsted/pulse-sdk 8.0.0-rc.0 → 8.0.0-rc.10

package/dist/ejs/Tracker.js

@@ -1,7 +1,7 @@
 import { parsePulseCookies } from '@schibsted/pulse-cis-sync';
 import { evaluateAndFlatten, isBrowser, isFunction, isPromise, isString, pulseMerge, throttle, } from '@schibsted/pulse-utils';
-import { buildAnonymousViewUIElementEvent, buildCompletedHealthActionEvent, buildEngagementAudioEvent, buildEngagementFormEvent, buildEngagementHealthUIElementEvent, buildEngagementOfferEvent, buildEngagementTeaserEvent, buildEngagementUIElementEvent, buildEngagementVideoAdEvent, buildEngagementVideoEvent, buildEngagementWidgetEvent, buildImpressionAdSlotEvent, buildImpressionFormEvent, buildImpressionHealthUIElementEvent, buildImpressionOfferEvent, buildImpressionPlayerEvent, buildImpressionTeaserEvent, buildImpressionUIElementEvent, buildImpressionWidgetEvent, buildLeaveArticleEvent, buildLeaveAudioPageEvent, buildLeaveErrorEvent, buildLeaveFrontpageEvent, buildLeaveLandingpageEvent, buildLeaveListingEvent, buildLeaveLockedArticleEvent, buildLeaveLockedAudioEvent, buildLeaveLockedAudioPageEvent, buildLeaveLockedVideoEvent, buildLeaveLockedVideoPageEvent, buildLeavePageEvent, buildLeaveVideoPageEvent, buildLeaveWeatherEvent, buildViewArticleEvent, buildViewAudioEvent, buildViewAudioPageEvent, buildViewErrorEvent, buildViewFrontpageEvent, buildViewHealthPageEvent, buildViewLandingpageEvent, buildViewListingEvent, buildViewLockedArticleEvent, buildViewLockedAudioEvent, buildViewLockedAudioPageEvent, buildViewLockedVideoEvent, buildViewLockedVideoPageEvent, buildViewPageEvent, buildViewTitleEvent, buildViewVideoEvent, buildViewVideoPageEvent, buildViewWeatherEvent, getCommonBuildersOutput, } from '@schibsted/tpaas-event-builder';
-import { LeaveArticle, LeaveAudioPage, LeaveError, LeaveFrontpage, LeaveLandingpage, LeaveListing, LeaveLockedArticle, LeaveLockedAudioPage, LeaveLockedVideoPage, LeavePage, LeaveVideoPage, LeaveWeather, ViewArticle, ViewError, ViewFrontpage, ViewListing, ViewLockedArticle, ViewLockedVideo, ViewPage, ViewTitle, } from '@schibsted/tpaas-schemas';
+import { buildAnonymousViewUIElementEvent, buildCompletedHealthActionEvent, buildEngagementAudioEvent, buildEngagementFormEvent, buildEngagementHealthUIElementEvent, buildEngagementOfferEvent, buildEngagementTeaserEvent, buildEngagementUIElementEvent, buildEngagementVideoAdEvent, buildEngagementVideoEvent, buildEngagementWidgetEvent, buildImpressionAdSlotEvent, buildImpressionFormEvent, buildImpressionHealthUIElementEvent, buildImpressionOfferEvent, buildImpressionPlayerEvent, buildImpressionTeaserEvent, buildImpressionUIElementEvent, buildImpressionWidgetEvent, buildLeaveArticleEvent, buildLeaveAudioPageEvent, buildLeaveErrorEvent, buildLeaveFrontpageEvent, buildLeaveLandingpageEvent, buildLeaveListingEvent, buildLeaveLockedArticleEvent, buildLeaveLockedAudioPageEvent, buildLeaveLockedVideoPageEvent, buildLeavePageEvent, buildLeaveSportsPageEvent, buildLeaveVideoPageEvent, buildLeaveWeatherEvent, buildViewArticleEvent, buildViewAudioPageEvent, buildViewErrorEvent, buildViewFrontpageEvent, buildViewHealthPageEvent, buildViewLandingpageEvent, buildViewListingEvent, buildViewLockedArticleEvent, buildViewLockedAudioPageEvent, buildViewLockedVideoPageEvent, buildViewPageEvent, buildViewSportsPageEvent, buildViewTitleEvent, buildViewVideoPageEvent, buildViewWeatherEvent, isPageType, } from '@schibsted/tpaas-event-builder';
+import { LeaveArticle, LeaveAudioPage, LeaveError, LeaveFrontpage, LeaveLandingpage, LeaveListing, LeaveLockedArticle, LeaveLockedAudioPage, LeaveLockedVideoPage, LeavePage, LeaveSportsPage, LeaveVideoPage, LeaveWeather, ViewArticle, ViewAudioPage, ViewError, ViewFrontpage, ViewHealthPage, ViewLandingpage, ViewListing, ViewLockedArticle, ViewLockedAudioPage, ViewLockedVideoPage, ViewPage, ViewSportsPage, ViewTitle, ViewVideoPage, ViewWeather, } from '@schibsted/tpaas-schemas';
 import logger from 'loglevel';
 import { v4 } from 'uuid';
 import { getDefaultAltHandler, getDefaultNativeJwe } from './app-integration';
@@ -10,6 +10,7 @@ import { getConsentsWaitForAnalytics, getFallbackConsents } from './builders/con
 import { applyAdvertisingConsent, applyAdvertisingConsentSync, } from './builders/consents';
 import { engagementEvent, identityEvent, routableEvent, trackerEvent } from './builders/events';
 import { anonymousEngagementEvent, anonymousTrackerEvent } from './builders/events-anonymous-node';
+import { generateExperimentSDRN } from './builders/experiments';
 import { readSession } from './builders/session-browser';
 import { baseConfig as defaultConfig } from './config';
 import { CISEndpoints, collectorEndpoints, remoteConfig } from './config-browser';
@@ -21,10 +22,11 @@ import { addTpaasLeaveTracking, getTpaasLeaveObject, leaveTpaasTrackingIsActive,
 import send from './network';
 import * as config from './remoteConfig';
 import { startProxyProviderListener } from './tracker-proxy/proxy-provider';
-import version from './version.json';
+import { SDK_VERSION } from './version';
 import { VisibilityObserver } from './visibility-observer';
 import warnOnce from './warnOnce';
 import { buildClickUIElementEvent } from './wrapper/engagement/ui-element/event-builder';
+import { isLegacyPageType } from './wrapper/types';
 import { pageFromPageView } from './wrapper/utils/page-from-page-view';
 import { buildLegacyViewArticleEvent } from './wrapper/view/article/event-builder';
 import { buildLegacyViewFrontpageEvent } from './wrapper/view/frontpage/event-builder';
@@ -114,6 +116,27 @@ export function unsubscribe(eventName, callback) {
  * @class Tracker
  */
 export default class Tracker {
+    async getCurrentTpaasPage() {
+        const { id, type, url } = await this.currentPage;
+        return {
+            // remove the SDRN prefix, it's not expected for TPaaS
+            pageId: id.startsWith('sdrn:') ? id.split(':').slice(-1)[0] : id,
+            // make sure the pageType is valid for TPaaS
+            pageType: isPageType(type) ? type : 'Page',
+            url,
+        };
+    }
+    async getCurrentLegacyPage() {
+        const { id, type, url } = await this.currentPage;
+        // make sure the pageType is valid for legacy events
+        const validatedType = isLegacyPageType(type) ? type : 'Page';
+        return {
+            // add the SDRN prefix if it's not there, legacy events expect the full SDRN format
+            id: id.startsWith('sdrn:') ? id : `sdrn:${this.state.providerId}:${validatedType.toLowerCase()}:${id}`,
+            type: validatedType,
+            url,
+        };
+    }
     /**
      * > [!WARNING]
      * >
@@ -132,19 +155,30 @@ export default class Tracker {
         // the tracking of the same element with both old and new events at the same time
         this.legacyVisibilityObservers = new Map();
         this.visibilityObservers = new Map();
-        this.legacyCurrentPage = {
-            id: 'undefined-id',
+        /**
+         * @private
+         *
+         * This is used as the source of truth for the current page's information, which is updated based on the View Page-level event
+         * As a single source of truth for the current page, this needs to be compatible between legacy and TPaaS events, hence the need for a custom data type.
+         * Legacy events can provide an id with SDRN, while TPaaS events don't need it
+         */
+        this.currentPage = {
+            id: 'unknown',
             type: 'Page',
-            url: typeof window !== 'undefined' ? window.location.href : '',
+            url: isBrowser ? window.location.href : undefined,
         };
-        this.currentPage = undefined;
         /**
          * Promise that resolves when a session ID becomes available
          * @private
          */
         this.sessionIdPromise = null;
+        /**
+         * A simple flag used to prevent duplicate listeners being registered
+         * if `exposeToProxyClients` or `startProxyProviderListener` is called more than once.
+         */
+        this.hasProxyListener = false;
         this.setPageDefaults = (pageViewEvent) => {
-            this.legacyCurrentPage = pageFromPageView(pageViewEvent);
+            this.currentPage = pageFromPageView(pageViewEvent);
             if (pageViewEvent.origin) {
                 const pageDefaults = { origin: pageViewEvent.origin };
                 this.update(pageDefaults, true);
@@ -152,8 +186,8 @@ export default class Tracker {
         };
         this.setCurrentPage = (id, type) => {
             this.currentPage = {
-                pageId: id,
-                pageType: type,
+                id: id || 'unknown',
+                type: type || 'Page',
                 url: isBrowser ? window.location.href : undefined,
             };
         };
@@ -162,6 +196,9 @@ export default class Tracker {
         if (!providerId || !(typeof providerId === 'string')) {
             throw new Error('Required parameter `providerId` missing');
         }
+        if (config?.componentVersion !== undefined && config?.component === undefined) {
+            throw new Error('`componentVersion` cannot be provided without `component`');
+        }
         let includeAdvertising;
         if (isBrowser && config?.autoCreateConsents) {
             config.consents = getConsentsWaitForAnalytics((consents) => {
@@ -205,9 +242,11 @@ export default class Tracker {
         this.builders = pulseMerge({}, builders, {
             provider: {
                 id: providerId,
+                ...(config?.component !== undefined && { component: config.component }),
+                ...(config?.componentVersion !== undefined && { componentVersion: config.componentVersion }),
             },
             tracker: {
-                version: version.SDK_VERSION,
+                version: SDK_VERSION,
             },
         });
         this.bookmark = new Map();
@@ -321,6 +360,11 @@ export default class Tracker {
                 return queuedEvent.then((result) => result);
             });
         };
+        /*
+         * Casting `input` as `Partial<Builders>` to formalise the intention of processing the event input in relation to the properties in
+         * the Builders type. It would justify changing the public api for `.track`, but as this deals with legacy code, we
+         * keep it internal, so dependencies from now on can count on objects being a Partial<Builder>
+         */
         return this.syncRemoteResources(input, currentBuilders).then(_track, _track);
     }
     /**
@@ -390,6 +434,11 @@ export default class Tracker {
             return {
                 name: exp.name || exp.id,
                 variant: exp.variant || '',
+                // nobody should be sending experiment id with an sdrn format, but in case they do
+                // we want to be able to handle it and not generate an invalid sdrn by adding another layer to it
+                experimentSdrn: exp.id.startsWith('sdrn:') ? exp.id : generateExperimentSDRN(exp.id, exp.platform),
+                platform: exp.platform || '',
+                testId: exp.custom?.testId,
             };
         });
     }
@@ -407,15 +456,16 @@ export default class Tracker {
         }
         return {
             autoTrackerVersion: this.builders.tracker?.autoTrackerVersion,
-            version: version.SDK_VERSION,
+            version: SDK_VERSION,
             isHybrid: !!this.state.isHybrid,
             pageviewId: this.state.pageViewId,
             providerId: this.state.providerId,
+            component: this.state.component,
+            componentVersion: this.state.componentVersion,
             experiments: await this.adaptExperiments(this.builders.experiments),
         };
     }
     /**
-     *
      * @private
      * @category TPaaS Tracking
      */
@@ -475,42 +525,29 @@ export default class Tracker {
                 source: source || 'unknown',
             };
         }
-        const [actor, consents, experiments] = await Promise.all([
+        const [actor, consents, experiments, currentPage] = await Promise.all([
             this.getActor(),
             this.getConsents(),
             this.adaptExperiments(this.builders.experiments),
+            this.getCurrentTpaasPage(),
         ]);
         const { environmentId, jwe } = parsePulseCookies();
         return {
             autoTrackerVersion: this.builders.tracker?.autoTrackerVersion,
-            version: version.SDK_VERSION,
+            version: SDK_VERSION,
             isHybrid: !!this.state.isHybrid,
             user: adaptActorToNewFormat(actor),
             consents: adaptConsentsToNewFormat(consents),
             providerId: this.state.providerId,
+            component: this.state.component,
+            componentVersion: this.state.componentVersion,
             pageviewId: this.state.pageViewId,
-            currentPage: this.currentPage,
+            currentPage,
             experiments,
             environmentId,
             jwe,
         };
     }
-    /**
-     * Generate a generic TPaaS event with common builders output
-     * The method should be used for experiments, not for real production work.
-     * It doesn't have any real TPaaS schema associated with it.
-     * The method doesn't queue or send the event, it just returns the merged object.
-     * The method can be removed at any time in the future, so use it with caution.
-     *
-     * @param input - The input object to merge with the common builders output
-     * @returns A promise that resolves to the merged object
-     * @private
-     * @category TPaaS Tracking
-     */
-    async generateGenericTpaasEvent(input) {
-        const dependencies = await this.prepareTpaasEvent();
-        return pulseMerge({}, input, getCommonBuildersOutput(new Date(), dependencies));
-    }
     /**
      * This method extends the list of base experiments that will be automatically included in every event sent by the tracker.
      *
@@ -532,6 +569,9 @@ export default class Tracker {
      * @category Tracking
      */
     addExperiments(experiments) {
+        if (experiments.some((experiment) => experiment.id.startsWith('sdrn:'))) {
+            logger.warn('Pulse - addExperiments received an experiment id starting with "sdrn:"; pass the raw experiment id instead. The SDK will generate the sdrn automatically.');
+        }
         this.update({ experiments }, true);
     }
     /**
@@ -566,7 +606,7 @@ export default class Tracker {
             const viewUIElementInputProperties = buildEventFromElement(element);
             this.trackLegacyViewUIElement(viewUIElementInputProperties);
         }));
-        this.legacyVisibilityObservers.get(selector)?.observe(selector);
+        this.legacyVisibilityObservers.get(selector)?.observe(selector, {});
     }
     /**
      * The `addUIElementVisibilityTracking` function provides an interface for sending tracking events when specific UI elements become visible within the viewport.
@@ -598,7 +638,38 @@ export default class Tracker {
             const eventInput = buildEventFromElement(element);
             this.trackImpressionUIElement(eventInput);
         }));
-        this.visibilityObservers.get(selector)?.observe(selector);
+        this.visibilityObservers.get(selector)?.observe(selector, {});
+    }
+    /**
+     * The `addElementVisibilityObserver` function provides an interface for executing arbitrary code when specific DOM Elements become visible within the viewport.
+     * It is built on the `VisibilityObserver` class, which efficiently detects visibility changes in DOM elements.
+     * When an element becomes at least 2/3 visible, a callback is triggered, with the Element that invoked the callback call as argument.
+     * It leverages the [Intersection Observer API](https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API) for viewport tracking
+     * and the [Mutation Observer API](https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver) to monitor lazy-loaded elements.
+     *
+     * Example usage:
+     *
+     * ```ts
+     * tracker.addElementVisibilityObserver('[data-pulse-entity-id]', (element) => {
+     *   const eventInput = parseElementIntoEventInput(element); // user-defined function
+     *   tracker.trackImpressionTeaser(eventInput); // can be anything actually, not necessarily a Teaser tracking call
+     * });
+     * ```
+     * @param selector
+     * @param callback
+     * @param options {ObserverOptions}
+     * @param options.threshold - A number between 0 and 1 indicating how much of the element should be visible to trigger
+     * the callback. Default is 0.67 (2/3 of the element).
+     */
+    addElementVisibilityObserver(selector, callback, options = {}) {
+        if (this.visibilityObservers.has(selector)) {
+            console.warn(`Cannot add UI Element visibility tracking for selector "${selector}" as it is already being tracked.`);
+            return;
+        }
+        this.visibilityObservers.set(selector, new VisibilityObserver((element) => {
+            callback(element);
+        }));
+        this.visibilityObservers.get(selector)?.observe(selector, options);
     }
     /**
      * The old trackViewArticle method from the Media Wrapper.
@@ -692,7 +763,7 @@ export default class Tracker {
      * @category Legacy Tracking
      */
     trackLegacyViewUIElement(inputProperties, trackOptions) {
-        const viewUIElementEventData = buildLegacyViewUIElementEvent(inputProperties, this.legacyCurrentPage);
+        const viewUIElementEventData = buildLegacyViewUIElementEvent(inputProperties, this.getCurrentLegacyPage());
         return this.track('trackerEvent', viewUIElementEventData, trackOptions);
     }
     /**
@@ -703,7 +774,7 @@ export default class Tracker {
      * @category Legacy Tracking
      */
     trackLegacyClickUIElement(inputProperties, trackOptions) {
-        const clickUIElementEventData = buildClickUIElementEvent(inputProperties, this.legacyCurrentPage);
+        const clickUIElementEventData = buildClickUIElementEvent(inputProperties, this.getCurrentLegacyPage());
         return this.track('trackerEvent', clickUIElementEventData, trackOptions);
     }
     /**
@@ -730,19 +801,18 @@ export default class Tracker {
     }
     async trackViewHealthPage(input, options) {
         this.newPageView(); // Reset the page view ID if it is not set, to ensure a new page view is tracked
-        this.setCurrentPage(input.object.objectId, 'Page'); // ViewHealthPage.object.objectType is HealthPage, which is not allowed as a pageType
+        this.setCurrentPage(input.object.objectId, ViewHealthPage.object.objectType);
         const dependencies = await this.prepareTpaasEvent();
         const event = buildViewHealthPageEvent(input, dependencies);
         const result = this.sendTpaasEvent(event);
         if (shouldEnableLeaveTracking(options.leaveTracking)) {
-            const { objectElement, pageElement, heightBuilder, objectResizable } = options.leaveTracking;
-            // HealthView Page is a bit special, in the sense that in doesn't have a dedicated Leave event.
-            // Instead, we need to reuse the generic Leave Page event, but adapt the input accordingly.
-            // This means omitting some fields from HealthView Page that are not part of Leave Page schema.
-            const { experiments, metrics, object, ...restInput } = input;
-            const { category, custom, intent, name, tags, ...restObject } = input.object;
-            const leavePageCallback = (leave) => {
-                this.trackLeavePage({
+            const leavePageCallback = async (leave) => {
+                // HealthView Page is a bit special, in the sense that in doesn't have a dedicated Leave event.
+                // Instead, we need to reuse the generic Leave Page event, but adapt the input accordingly.
+                // This means omitting some fields from HealthView Page that are not part of Leave Page schema.
+                const { experiments, metrics, object, origin, ...restInput } = input;
+                const { category, custom, intent, name, tags, ...restObject } = input.object;
+                await this.trackLeavePage({
                     leave,
                     ...restInput,
                     object: {
@@ -752,10 +822,7 @@ export default class Tracker {
                 });
             };
             addTpaasLeaveTracking({
-                objectElement,
-                pageElement,
-                objectResizable,
-                heightBuilder,
+                ...options.leaveTracking,
                 schema: LeavePage.object.objectType,
                 trackMethod: leavePageCallback,
             });
@@ -779,18 +846,14 @@ export default class Tracker {
         const event = buildViewPageEvent(input, dependencies);
         const result = this.sendTpaasEvent(event);
         if (shouldEnableLeaveTracking(options.leaveTracking)) {
-            const { objectElement, pageElement, heightBuilder, objectResizable } = options.leaveTracking;
-            const leavePageCallback = (leave) => {
-                this.trackLeavePage({
+            const leavePageCallback = async (leave) => {
+                await this.trackLeavePage({
                     leave,
                     ...input,
                 });
             };
             addTpaasLeaveTracking({
-                objectElement,
-                pageElement,
-                objectResizable,
-                heightBuilder,
+                ...options.leaveTracking,
                 schema: LeavePage.object.objectType,
                 trackMethod: leavePageCallback,
             });
@@ -799,32 +862,49 @@ export default class Tracker {
     }
     /**
      * @param input
+     * @param options
      * @category TPaaS Tracking
      */
-    async trackViewTitle(input) {
+    async trackViewSportsPage(input, options) {
         this.newPageView(); // Reset the page view ID if it is not set, to ensure a new page view is tracked
-        this.setCurrentPage(input.object.objectId, ViewTitle.object.objectType);
+        this.setCurrentPage(input.object.objectId, ViewSportsPage.object.objectType);
         const dependencies = await this.prepareTpaasEvent();
-        const event = buildViewTitleEvent(input, dependencies);
-        return this.sendTpaasEvent(event);
-        // there's no Leave Title event
+        const event = buildViewSportsPageEvent(input, dependencies);
+        const result = this.sendTpaasEvent(event);
+        if (shouldEnableLeaveTracking(options.leaveTracking)) {
+            const leaveSportsPageCallback = async (leave) => {
+                await this.trackLeaveSportsPage({
+                    leave,
+                    ...input,
+                });
+            };
+            addTpaasLeaveTracking({
+                ...options.leaveTracking,
+                schema: LeaveSportsPage.object.objectType,
+                trackMethod: leaveSportsPageCallback,
+            });
+        }
+        return result;
     }
     /**
      * @param input
      * @category TPaaS Tracking
      */
-    async trackImpressionWidget(input) {
+    async trackViewTitle(input) {
+        this.newPageView(); // Reset the page view ID if it is not set, to ensure a new page view is tracked
+        this.setCurrentPage(input.object.objectId, ViewTitle.object.objectType);
         const dependencies = await this.prepareTpaasEvent();
-        const event = buildImpressionWidgetEvent(input, dependencies);
+        const event = buildViewTitleEvent(input, dependencies);
         return this.sendTpaasEvent(event);
+        // there's no Leave Title event
     }
     /**
      * @param input
      * @category TPaaS Tracking
      */
-    async trackImpressionAdSlot(input) {
+    async trackImpressionWidget(input) {
         const dependencies = await this.prepareTpaasEvent();
-        const event = buildImpressionAdSlotEvent(input, dependencies);
+        const event = buildImpressionWidgetEvent(input, dependencies);
         return this.sendTpaasEvent(event);
     }
     /**
@@ -839,36 +919,20 @@ export default class Tracker {
         const event = buildViewArticleEvent(input, dependencies);
         const result = this.sendTpaasEvent(event);
         if (shouldEnableLeaveTracking(options.leaveTracking)) {
-            const { objectElement, pageElement, heightBuilder, objectResizable } = options.leaveTracking;
-            const leaveArticleCallback = (leave) => {
-                this.trackLeaveArticle({
+            const leaveArticleCallback = async (leave) => {
+                await this.trackLeaveArticle({
                     leave,
                     ...input,
                 });
             };
             addTpaasLeaveTracking({
-                objectElement,
-                pageElement,
-                heightBuilder,
-                objectResizable,
+                ...options.leaveTracking,
                 schema: LeaveArticle.object.objectType,
                 trackMethod: leaveArticleCallback,
             });
         }
         return result;
     }
-    /**
-     * @param input
-     * @param options
-     * @category TPaaS Tracking
-     */
-    async trackViewAudio(input) {
-        // despite the View event type, this is not a page view event, but rather a media object view event
-        // so we shouldn't reset the page view ID here or enable leave tracking
-        const dependencies = await this.prepareTpaasEvent();
-        const event = buildViewAudioEvent(input, dependencies);
-        return this.sendTpaasEvent(event);
-    }
     /**
      * Tracks a View AudioPage event and automatically fires a Leave AudioPage event when the user
      * navigates away.
@@ -911,20 +975,20 @@ export default class Tracker {
      */
     async trackViewAudioPage(input, options) {
         this.newPageView();
-        this.setCurrentPage(input.object.objectId, 'Audio'); // ViewAudioPage.object.objectType is AudioPage, which is not allowed as a pageType
+        this.setCurrentPage(input.object.objectId, ViewAudioPage.object.objectType);
         const dependencies = await this.prepareTpaasEvent();
         const event = buildViewAudioPageEvent(input, dependencies);
         const result = this.sendTpaasEvent(event);
         if (shouldEnableLeaveTracking(options.leaveTracking)) {
-            const { objectElement, pageElement, heightBuilder, objectResizable, leaveAudioBuilder } = options.leaveTracking;
-            const leaveAudioPageCallback = (leave) => {
+            const { leaveAudioBuilder, ...restLeaveTrackingOptions } = options.leaveTracking;
+            const leaveAudioPageCallback = async (leave) => {
                 const leaveAudioInput = leaveAudioBuilder?.() ?? {
                     audioCompleted: 0,
                     audioStarted: 0,
                     maxPlaylistPosition: 0,
                     playlistPositionPercentage: 0,
                 };
-                this.trackLeaveAudioPage({
+                await this.trackLeaveAudioPage({
                     leave,
                     leaveAudio: {
                         ...leaveAudioInput,
@@ -935,10 +999,7 @@ export default class Tracker {
                 });
             };
             addTpaasLeaveTracking({
-                objectElement,
-                pageElement,
-                heightBuilder,
-                objectResizable,
+                ...restLeaveTrackingOptions,
                 schema: LeaveAudioPage.object.objectType,
                 trackMethod: leaveAudioPageCallback,
             });
@@ -957,24 +1018,29 @@ export default class Tracker {
         const event = buildViewErrorEvent(input, dependencies);
         const result = this.sendTpaasEvent(event);
         if (shouldEnableLeaveTracking(options.leaveTracking)) {
-            const { objectElement, pageElement, heightBuilder, objectResizable } = options.leaveTracking;
-            const leaveErrorCallback = (leave) => {
-                this.trackLeaveError({
+            const leaveErrorCallback = async (leave) => {
+                await this.trackLeaveError({
                     leave,
                     ...input,
                 });
             };
             addTpaasLeaveTracking({
-                objectElement,
-                pageElement,
-                heightBuilder,
-                objectResizable,
+                ...options.leaveTracking,
                 schema: LeaveError.object.objectType,
                 trackMethod: leaveErrorCallback,
             });
         }
         return result;
     }
+    /**
+     * @param input
+     * @category TPaaS Tracking
+     */
+    async trackImpressionAdSlot(input) {
+        const dependencies = await this.prepareTpaasEvent();
+        const event = buildImpressionAdSlotEvent(input, dependencies);
+        return this.sendTpaasEvent(event);
+    }
     /**
      * @param input
      * @category TPaaS Tracking
@@ -1032,18 +1098,14 @@ export default class Tracker {
         const event = buildViewFrontpageEvent(input, dependencies);
         const result = this.sendTpaasEvent(event);
         if (shouldEnableLeaveTracking(options.leaveTracking)) {
-            const { objectElement, pageElement, heightBuilder, objectResizable } = options.leaveTracking;
-            const leaveFrontpageCallback = (leave) => {
-                this.trackLeaveFrontpage({
+            const leaveFrontpageCallback = async (leave) => {
+                await this.trackLeaveFrontpage({
                     leave,
                     ...input,
                 });
             };
             addTpaasLeaveTracking({
-                objectElement,
-                pageElement,
-                objectResizable,
-                heightBuilder,
+                ...options.leaveTracking,
                 schema: LeaveFrontpage.object.objectType,
                 trackMethod: leaveFrontpageCallback,
             });
@@ -1057,23 +1119,19 @@ export default class Tracker {
      */
     async trackViewLandingpage(input, options) {
         this.newPageView(); // Reset the page view ID if it is not set, to ensure a new page view is tracked
-        this.setCurrentPage(input.object.objectId, 'LandingPage' /* TODO: ViewLandingpage.object.type once the schema is fixed */);
+        this.setCurrentPage(input.object.objectId, ViewLandingpage.object.objectType);
         const dependencies = await this.prepareTpaasEvent();
         const event = buildViewLandingpageEvent(input, dependencies);
         const result = this.sendTpaasEvent(event);
         if (shouldEnableLeaveTracking(options.leaveTracking)) {
-            const { objectElement, pageElement, heightBuilder, objectResizable } = options.leaveTracking;
-            const leaveLandingpageCallback = (leave) => {
-                this.trackLeaveLandingpage({
+            const leaveLandingpageCallback = async (leave) => {
+                await this.trackLeaveLandingpage({
                     leave,
                     ...input,
                 });
             };
             addTpaasLeaveTracking({
-                objectElement,
-                pageElement,
-                heightBuilder,
-                objectResizable,
+                ...options.leaveTracking,
                 schema: LeaveLandingpage.object.objectType,
                 trackMethod: leaveLandingpageCallback,
             });
@@ -1092,18 +1150,14 @@ export default class Tracker {
         const event = buildViewListingEvent(input, dependencies);
         const result = this.sendTpaasEvent(event);
         if (shouldEnableLeaveTracking(options.leaveTracking)) {
-            const { objectElement, pageElement, heightBuilder, objectResizable } = options.leaveTracking;
-            const leaveListingCallback = (leave) => {
-                this.trackLeaveListing({
+            const leaveListingCallback = async (leave) => {
+                await this.trackLeaveListing({
                     leave,
                     ...input,
                 });
             };
             addTpaasLeaveTracking({
-                objectElement,
-                pageElement,
-                heightBuilder,
-                objectResizable,
+                ...options.leaveTracking,
                 schema: LeaveListing.object.objectType,
                 trackMethod: leaveListingCallback,
             });
@@ -1122,36 +1176,20 @@ export default class Tracker {
         const event = buildViewLockedArticleEvent(input, dependencies);
         const result = this.sendTpaasEvent(event);
         if (shouldEnableLeaveTracking(options.leaveTracking)) {
-            const { objectElement, pageElement, heightBuilder, objectResizable } = options.leaveTracking;
-            const leaveLockedArticleCallback = (leave) => {
-                this.trackLeaveLockedArticle({
+            const leaveLockedArticleCallback = async (leave) => {
+                await this.trackLeaveLockedArticle({
                     leave,
                     ...input,
                 });
             };
             addTpaasLeaveTracking({
-                objectElement,
-                pageElement,
-                objectResizable,
-                heightBuilder,
+                ...options.leaveTracking,
                 schema: LeaveLockedArticle.object.objectType,
                 trackMethod: leaveLockedArticleCallback,
             });
         }
         return result;
     }
-    /**
-     * @param input
-     * @param options
-     * @category TPaaS Tracking
-     */
-    async trackViewLockedAudio(input) {
-        // despite the View event type, this is not a page view event, but rather a media object view event
-        // so we shouldn't reset the page view ID here or enable leave tracking
-        const dependencies = await this.prepareTpaasEvent();
-        const event = buildViewLockedAudioEvent(input, dependencies);
-        return this.sendTpaasEvent(event);
-    }
     /**
      * @param input
      * @param options
@@ -1159,40 +1197,25 @@ export default class Tracker {
      */
     async trackViewLockedAudioPage(input, options) {
         this.newPageView();
-        this.setCurrentPage(input.object.objectId, 'Audio'); // ViewLockedAudioPage.object.objectType is AudioPage, which is not allowed as a pageType
+        this.setCurrentPage(input.object.objectId, ViewLockedAudioPage.object.objectType);
         const dependencies = await this.prepareTpaasEvent();
         const event = buildViewLockedAudioPageEvent(input, dependencies);
         const result = this.sendTpaasEvent(event);
         if (shouldEnableLeaveTracking(options.leaveTracking)) {
-            const { objectElement, pageElement, heightBuilder, objectResizable } = options.leaveTracking;
-            const leaveLockedAudioPageCallback = (leave) => {
-                this.trackLeaveLockedAudioPage({
+            const leaveLockedAudioPageCallback = async (leave) => {
+                await this.trackLeaveLockedAudioPage({
                     leave,
                     ...input,
                 });
             };
             addTpaasLeaveTracking({
-                objectElement,
-                pageElement,
-                heightBuilder,
-                objectResizable,
+                ...options.leaveTracking,
                 schema: LeaveLockedAudioPage.object.objectType,
                 trackMethod: leaveLockedAudioPageCallback,
             });
         }
         return result;
     }
-    /**
-     * @param input
-     * @category TPaaS Tracking
-     */
-    async trackViewLockedVideo(input) {
-        // despite the name, this is not a page-level event. trackViewLockedVideoPage is a page-level event
-        // as such, we don't support (yet) automatic leave event enabling
-        const dependencies = await this.prepareTpaasEvent();
-        const event = buildViewLockedVideoEvent(input, dependencies);
-        return this.sendTpaasEvent(event);
-    }
     /**
      * @param input
      * @param options
@@ -1200,40 +1223,25 @@ export default class Tracker {
      */
     async trackViewLockedVideoPage(input, options) {
         this.newPageView(); // Reset the page view ID if it is not set, to ensure a new page view is tracked
-        this.setCurrentPage(input.object.objectId, ViewLockedVideo.object.objectType);
+        this.setCurrentPage(input.object.objectId, ViewLockedVideoPage.object.objectType);
         const dependencies = await this.prepareTpaasEvent();
         const event = buildViewLockedVideoPageEvent(input, dependencies);
         const result = this.sendTpaasEvent(event);
         if (shouldEnableLeaveTracking(options.leaveTracking)) {
-            const { objectElement, pageElement, heightBuilder, objectResizable } = options.leaveTracking;
-            const leaveLockedVideoPageCallback = (leave) => {
-                this.trackLeaveLockedVideoPage({
+            const leaveLockedVideoPageCallback = async (leave) => {
+                await this.trackLeaveLockedVideoPage({
                     leave,
                     ...input,
                 });
             };
             addTpaasLeaveTracking({
-                objectElement,
-                pageElement,
-                heightBuilder,
-                objectResizable,
+                ...options.leaveTracking,
                 schema: LeaveLockedVideoPage.object.objectType,
                 trackMethod: leaveLockedVideoPageCallback,
             });
         }
         return result;
     }
-    /**
-     * @param input
-     * @category TPaaS Tracking
-     */
-    async trackViewVideo(input) {
-        // despite the View event type, this is not a page view event, but rather a media object view event
-        // so we shouldn't reset the page view ID here or enable leave tracking
-        const dependencies = await this.prepareTpaasEvent();
-        const event = buildViewVideoEvent(input, dependencies);
-        return this.sendTpaasEvent(event);
-    }
     /**
      * Tracks a View VideoPage event and automatically fires a Leave VideoPage event when the user
      * navigates away.
@@ -1278,15 +1286,15 @@ export default class Tracker {
      */
     async trackViewVideoPage(input, options) {
         this.newPageView(); // Reset the page view ID if it is not set, to ensure a new page view is tracked
-        this.setCurrentPage(input.object.objectId, 'Video'); // ViewVideoPage.object.type is VideoPage, which is not allowed as a pageType
+        this.setCurrentPage(input.object.objectId, ViewVideoPage.object.objectType);
         const dependencies = await this.prepareTpaasEvent();
         const event = buildViewVideoPageEvent(input, dependencies);
         const result = this.sendTpaasEvent(event);
         if (shouldEnableLeaveTracking(options.leaveTracking)) {
-            const { objectElement, pageElement, heightBuilder, objectResizable, leaveStoriesBuilder } = options.leaveTracking;
-            const leaveVideoCallback = (leave) => {
+            const { leaveStoriesBuilder, ...restLeaveTrackingOptions } = options.leaveTracking;
+            const leaveVideoCallback = async (leave) => {
                 const leaveStoriesInput = leaveStoriesBuilder?.();
-                this.trackLeaveVideoPage({
+                await this.trackLeaveVideoPage({
                     leave,
                     leaveStories: leaveStoriesInput && {
                         ...leaveStoriesInput,
@@ -1297,10 +1305,7 @@ export default class Tracker {
                 });
             };
             addTpaasLeaveTracking({
-                objectElement,
-                pageElement,
-                heightBuilder,
-                objectResizable,
+                ...restLeaveTrackingOptions,
                 schema: LeaveVideoPage.object.objectType,
                 trackMethod: leaveVideoCallback,
             });
@@ -1314,23 +1319,19 @@ export default class Tracker {
      */
     async trackViewWeather(input, options) {
         this.newPageView(); // Reset the page view ID if it is not set, to ensure a new page view is tracked
-        this.setCurrentPage(input.object.objectId, 'Page' /* TODO: ViewWeather.object.type once the schema is fixed */);
+        this.setCurrentPage(input.object.objectId, ViewWeather.object.objectType);
         const dependencies = await this.prepareTpaasEvent();
         const event = buildViewWeatherEvent(input, dependencies);
         const result = this.sendTpaasEvent(event);
         if (shouldEnableLeaveTracking(options.leaveTracking)) {
-            const { objectElement, pageElement, heightBuilder, objectResizable } = options.leaveTracking;
-            const leaveWeatherCallback = (leave) => {
-                this.trackLeaveWeather({
+            const leaveWeatherCallback = async (leave) => {
+                await this.trackLeaveWeather({
                     leave,
                     ...input,
                 });
             };
             addTpaasLeaveTracking({
-                objectElement,
-                pageElement,
-                heightBuilder,
-                objectResizable,
+                ...options.leaveTracking,
                 schema: LeaveWeather.object.objectType,
                 trackMethod: leaveWeatherCallback,
             });
@@ -1400,15 +1401,6 @@ export default class Tracker {
         const event = buildLeaveLockedArticleEvent(input, dependencies);
         return this.sendTpaasEvent(event);
     }
-    /**
-     * @param input
-     * @category TPaaS Tracking
-     */
-    async trackLeaveLockedAudio(input) {
-        const dependencies = await this.prepareTpaasEvent();
-        const event = buildLeaveLockedAudioEvent(input, dependencies);
-        return this.sendTpaasEvent(event);
-    }
     /**
      * @param input
      * @category TPaaS Tracking
@@ -1422,27 +1414,27 @@ export default class Tracker {
      * @param input
      * @category TPaaS Tracking
      */
-    async trackLeaveLockedVideo(input) {
+    async trackLeaveLockedVideoPage(input) {
         const dependencies = await this.prepareTpaasEvent();
-        const event = buildLeaveLockedVideoEvent(input, dependencies);
+        const event = buildLeaveLockedVideoPageEvent(input, dependencies);
         return this.sendTpaasEvent(event);
     }
     /**
      * @param input
      * @category TPaaS Tracking
      */
-    async trackLeaveLockedVideoPage(input) {
+    async trackLeavePage(input) {
         const dependencies = await this.prepareTpaasEvent();
-        const event = buildLeaveLockedVideoPageEvent(input, dependencies);
+        const event = buildLeavePageEvent(input, dependencies);
         return this.sendTpaasEvent(event);
     }
     /**
      * @param input
      * @category TPaaS Tracking
      */
-    async trackLeavePage(input) {
+    async trackLeaveSportsPage(input) {
         const dependencies = await this.prepareTpaasEvent();
-        const event = buildLeavePageEvent(input, dependencies);
+        const event = buildLeaveSportsPageEvent(input, dependencies);
         return this.sendTpaasEvent(event);
     }
     /**
@@ -2178,8 +2170,8 @@ export default class Tracker {
      * with the added guarantee that a second Leave event will not be triggered if one already has been sent.
      * @category TPaaS Leave Tracking
      */
-    trackTpaasActiveLeave() {
-        trackTpaasActiveLeave();
+    async trackTpaasActiveLeave() {
+        await trackTpaasActiveLeave();
     }
     /**
      * Check if leave tracking is enabled (if an event will be sent when the user leaves the page)