@schibsted/pulse-sdk 8.0.0-rc.6 → 8.0.0-rc.7

package/dist/cjs/Tracker.js

@@ -68,6 +68,7 @@ const version_1 = require("./version");
 const visibility_observer_1 = require("./visibility-observer");
 const warnOnce_1 = __importDefault(require("./warnOnce"));
 const event_builder_1 = require("./wrapper/engagement/ui-element/event-builder");
+const types_1 = require("./wrapper/types");
 const page_from_page_view_1 = require("./wrapper/utils/page-from-page-view");
 const event_builder_2 = require("./wrapper/view/article/event-builder");
 const event_builder_3 = require("./wrapper/view/frontpage/event-builder");
@@ -157,6 +158,27 @@ function unsubscribe(eventName, callback) {
  * @class Tracker
  */
 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: (0, tpaas_event_builder_1.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 = (0, types_1.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]
      * >
@@ -175,12 +197,18 @@ 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: pulse_utils_1.isBrowser ? window.location.href : undefined,
         };
-        this.currentPage = undefined;
         /**
          * Promise that resolves when a session ID becomes available
          * @private
@@ -192,7 +220,7 @@ class Tracker {
          */
         this.hasProxyListener = false;
         this.setPageDefaults = (pageViewEvent) => {
-            this.legacyCurrentPage = (0, page_from_page_view_1.pageFromPageView)(pageViewEvent);
+            this.currentPage = (0, page_from_page_view_1.pageFromPageView)(pageViewEvent);
             if (pageViewEvent.origin) {
                 const pageDefaults = { origin: pageViewEvent.origin };
                 this.update(pageDefaults, true);
@@ -200,8 +228,8 @@ class Tracker {
         };
         this.setCurrentPage = (id, type) => {
             this.currentPage = {
-                pageId: id,
-                pageType: type,
+                id: id || 'unknown',
+                type: type || 'Page',
                 url: pulse_utils_1.isBrowser ? window.location.href : undefined,
             };
         };
@@ -530,10 +558,11 @@ 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 } = (0, pulse_cis_sync_1.parsePulseCookies)();
         return {
@@ -544,7 +573,7 @@ class Tracker {
             consents: adaptConsentsToNewFormat(consents),
             providerId: this.state.providerId,
             pageviewId: this.state.pageViewId,
-            currentPage: this.currentPage,
+            currentPage,
             experiments,
             environmentId,
             jwe,
@@ -621,7 +650,7 @@ 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.
@@ -653,7 +682,38 @@ 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 visibility_observer_1.VisibilityObserver((element) => {
+            callback(element);
+        }));
+        this.visibilityObservers.get(selector)?.observe(selector, options);
     }
     /**
      * The old trackViewArticle method from the Media Wrapper.
@@ -747,7 +807,7 @@ class Tracker {
      * @category Legacy Tracking
      */
     trackLegacyViewUIElement(inputProperties, trackOptions) {
-        const viewUIElementEventData = (0, event_builder_8.buildLegacyViewUIElementEvent)(inputProperties, this.legacyCurrentPage);
+        const viewUIElementEventData = (0, event_builder_8.buildLegacyViewUIElementEvent)(inputProperties, this.getCurrentLegacyPage());
         return this.track('trackerEvent', viewUIElementEventData, trackOptions);
     }
     /**
@@ -758,7 +818,7 @@ class Tracker {
      * @category Legacy Tracking
      */
     trackLegacyClickUIElement(inputProperties, trackOptions) {
-        const clickUIElementEventData = (0, event_builder_1.buildClickUIElementEvent)(inputProperties, this.legacyCurrentPage);
+        const clickUIElementEventData = (0, event_builder_1.buildClickUIElementEvent)(inputProperties, this.getCurrentLegacyPage());
         return this.track('trackerEvent', clickUIElementEventData, trackOptions);
     }
     /**
@@ -831,10 +891,9 @@ class Tracker {
         const result = this.sendTpaasEvent(event);
         if ((0, leaveTrackingTpaas_1.shouldEnableLeaveTracking)(options.leaveTracking)) {
             const leavePageCallback = async (leave) => {
-                const { metrics, ...rest } = input; // metrics are not part of LeavePage schema, so we need to omit them
                 await this.trackLeavePage({
                     leave,
-                    ...rest,
+                    ...input,
                 });
             };
             (0, leaveTrackingTpaas_1.addTpaasLeaveTracking)({
@@ -905,12 +964,9 @@ class Tracker {
         const result = this.sendTpaasEvent(event);
         if ((0, leaveTrackingTpaas_1.shouldEnableLeaveTracking)(options.leaveTracking)) {
             const leaveArticleCallback = async (leave) => {
-                // omit these properties from LeaveArticle because they're not part of the LeaveArticle schema
-                const { authors, hotness, lifetime, sponsor, wordCount, ...rest } = input.object;
                 await this.trackLeaveArticle({
                     leave,
                     ...input,
-                    object: rest,
                 });
             };
             (0, leaveTrackingTpaas_1.addTpaasLeaveTracking)({
@@ -1020,6 +1076,15 @@ class Tracker {
         }
         return result;
     }
+    /**
+     * @param input
+     * @category TPaaS Tracking
+     */
+    async trackImpressionAdSlot(input) {
+        const dependencies = await this.prepareTpaasEvent();
+        const event = (0, tpaas_event_builder_1.buildImpressionAdSlotEvent)(input, dependencies);
+        return this.sendTpaasEvent(event);
+    }
     /**
      * @param input
      * @category TPaaS Tracking
@@ -1078,10 +1143,9 @@ class Tracker {
         const result = this.sendTpaasEvent(event);
         if ((0, leaveTrackingTpaas_1.shouldEnableLeaveTracking)(options.leaveTracking)) {
             const leaveFrontpageCallback = async (leave) => {
-                const { metrics, ...rest } = input; // metrics are not part of LeaveFrontpage schema, so we need to omit them
                 await this.trackLeaveFrontpage({
                     leave,
-                    ...rest,
+                    ...input,
                 });
             };
             (0, leaveTrackingTpaas_1.addTpaasLeaveTracking)({
@@ -1134,6 +1198,10 @@ class Tracker {
                 await this.trackLeaveListing({
                     leave,
                     ...input,
+                    object: {
+                        ...input.object,
+                        listingType: 'Tag,Story,Section,Search,Author,Other', // TODO: listingType is broken for this catalog. will be fixed in the next one
+                    },
                 });
             };
             (0, leaveTrackingTpaas_1.addTpaasLeaveTracking)({
@@ -1157,12 +1225,9 @@ class Tracker {
         const result = this.sendTpaasEvent(event);
         if ((0, leaveTrackingTpaas_1.shouldEnableLeaveTracking)(options.leaveTracking)) {
             const leaveLockedArticleCallback = async (leave) => {
-                // omit these properties because they're not part of the LeaveLockedArticle schema
-                const { authors, hotness, lifetime, sponsor, wordCount, ...rest } = input.object;
                 await this.trackLeaveLockedArticle({
                     leave,
                     ...input,
-                    object: rest,
                 });
             };
             (0, leaveTrackingTpaas_1.addTpaasLeaveTracking)({
@@ -1308,11 +1373,9 @@ class Tracker {
         const result = this.sendTpaasEvent(event);
         if ((0, leaveTrackingTpaas_1.shouldEnableLeaveTracking)(options.leaveTracking)) {
             const leaveWeatherCallback = async (leave) => {
-                // omit object and page from input because they're not part of the LeaveWeather schema
-                const { object, page, ...rest } = input;
                 await this.trackLeaveWeather({
                     leave,
-                    ...rest,
+                    ...input,
                 });
             };
             (0, leaveTrackingTpaas_1.addTpaasLeaveTracking)({

package/dist/cjs/tracker-proxy/consts.js

@@ -22,6 +22,7 @@ exports.TPAAS_ALLOWED_METHODS = [
     'trackEngagementVideoAd',
     'trackEngagementWidget',
     'trackCompletedHealthAction',
+    'trackImpressionAdSlot',
     'trackImpressionForm',
     'trackImpressionHealthUIElement',
     'trackImpressionOffer',

package/dist/cjs/version.js

@@ -2,4 +2,4 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
 // This file is auto-generated by bin/generate-version.js. Do not edit manually.
-exports.SDK_VERSION = '8.0.0-rc.6';
+exports.SDK_VERSION = '8.0.0-rc.7';

package/dist/cjs/visibility-observer/index.js

@@ -16,14 +16,16 @@ class VisibilityObserver {
      * Uses {@link https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver | MutationObserver} to monitor the DOM for dynamically loaded content.
      * Callback is invoked only once per element.
      * @param selector The CSS selector for elements to track.
+     * @param options {ObserverOptions} Optional configuration for the observer.
+     * @param options.threshold Which ratio triggers the Observer callback.
      * @throws Error if called more than once.
      */
-    observe(selector) {
+    observe(selector, { threshold = 0.67 }) {
         if (this.selector) {
             throw new Error(`Cannot observe selector ${selector}. A visibility observer has already been set up for selector ${this.selector}.`);
         }
         this.selector = selector;
-        this.setupObservers();
+        this.setupObservers({ threshold });
         // biome-ignore lint/suspicious/useIterableCallbackReturn: -
         this.elements().forEach((elementToTrack) => this.observeIntersection(elementToTrack));
     }
@@ -33,14 +35,14 @@ class VisibilityObserver {
     elements() {
         return Array.from(document.querySelectorAll(this.selector));
     }
-    // Initialize both observers and start watching for DOM changes
-    setupObservers() {
-        this.setupIntersectionObserver();
+    // Initialise both observers and start watching for DOM changes
+    setupObservers({ threshold }) {
+        this.setupIntersectionObserver({ threshold });
         this.setupMutationObserver();
         this.observeMutations();
     }
     // Create observer to detect when elements become visible in the viewport
-    setupIntersectionObserver() {
+    setupIntersectionObserver({ threshold }) {
         this.intersectionObserver = new IntersectionObserver((entries) => {
             entries.forEach((entry) => {
                 if (entry.isIntersecting) {
@@ -49,7 +51,7 @@ class VisibilityObserver {
                     this.intersectionObserver.unobserve(node);
                 }
             });
-        }, { threshold: 2 / 3 });
+        }, { threshold });
     }
     // Create observer to detect DOM changes that may add/remove tracked elements
     setupMutationObserver() {

package/dist/cjs/wrapper/types/event.js

@@ -1,2 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLegacyPageType = isLegacyPageType;
+const LEGACY_PAGE_TYPE_VALUES = ['Article', 'Listing', 'Frontpage', 'SalesPoster', 'Page', 'LoginPoster'];
+function isLegacyPageType(value) {
+    return LEGACY_PAGE_TYPE_VALUES.includes(value);
+}

package/dist/ejs/Tracker.js

@@ -1,6 +1,6 @@
 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, 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, getCommonBuildersOutput, } from '@schibsted/tpaas-event-builder';
+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, getCommonBuildersOutput, 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';
@@ -25,6 +25,7 @@ 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 +115,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,12 +154,18 @@ 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
@@ -149,7 +177,7 @@ export default class Tracker {
          */
         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);
@@ -157,8 +185,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,
             };
         };
@@ -487,10 +515,11 @@ 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 {
@@ -501,7 +530,7 @@ export default class Tracker {
             consents: adaptConsentsToNewFormat(consents),
             providerId: this.state.providerId,
             pageviewId: this.state.pageViewId,
-            currentPage: this.currentPage,
+            currentPage,
             experiments,
             environmentId,
             jwe,
@@ -578,7 +607,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.
@@ -610,7 +639,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.
@@ -704,7 +764,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);
     }
     /**
@@ -715,7 +775,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);
     }
     /**
@@ -788,10 +848,9 @@ export default class Tracker {
         const result = this.sendTpaasEvent(event);
         if (shouldEnableLeaveTracking(options.leaveTracking)) {
             const leavePageCallback = async (leave) => {
-                const { metrics, ...rest } = input; // metrics are not part of LeavePage schema, so we need to omit them
                 await this.trackLeavePage({
                     leave,
-                    ...rest,
+                    ...input,
                 });
             };
             addTpaasLeaveTracking({
@@ -862,12 +921,9 @@ export default class Tracker {
         const result = this.sendTpaasEvent(event);
         if (shouldEnableLeaveTracking(options.leaveTracking)) {
             const leaveArticleCallback = async (leave) => {
-                // omit these properties from LeaveArticle because they're not part of the LeaveArticle schema
-                const { authors, hotness, lifetime, sponsor, wordCount, ...rest } = input.object;
                 await this.trackLeaveArticle({
                     leave,
                     ...input,
-                    object: rest,
                 });
             };
             addTpaasLeaveTracking({
@@ -977,6 +1033,15 @@ export default class Tracker {
         }
         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
@@ -1035,10 +1100,9 @@ export default class Tracker {
         const result = this.sendTpaasEvent(event);
         if (shouldEnableLeaveTracking(options.leaveTracking)) {
             const leaveFrontpageCallback = async (leave) => {
-                const { metrics, ...rest } = input; // metrics are not part of LeaveFrontpage schema, so we need to omit them
                 await this.trackLeaveFrontpage({
                     leave,
-                    ...rest,
+                    ...input,
                 });
             };
             addTpaasLeaveTracking({
@@ -1091,6 +1155,10 @@ export default class Tracker {
                 await this.trackLeaveListing({
                     leave,
                     ...input,
+                    object: {
+                        ...input.object,
+                        listingType: 'Tag,Story,Section,Search,Author,Other', // TODO: listingType is broken for this catalog. will be fixed in the next one
+                    },
                 });
             };
             addTpaasLeaveTracking({
@@ -1114,12 +1182,9 @@ export default class Tracker {
         const result = this.sendTpaasEvent(event);
         if (shouldEnableLeaveTracking(options.leaveTracking)) {
             const leaveLockedArticleCallback = async (leave) => {
-                // omit these properties because they're not part of the LeaveLockedArticle schema
-                const { authors, hotness, lifetime, sponsor, wordCount, ...rest } = input.object;
                 await this.trackLeaveLockedArticle({
                     leave,
                     ...input,
-                    object: rest,
                 });
             };
             addTpaasLeaveTracking({
@@ -1265,11 +1330,9 @@ export default class Tracker {
         const result = this.sendTpaasEvent(event);
         if (shouldEnableLeaveTracking(options.leaveTracking)) {
             const leaveWeatherCallback = async (leave) => {
-                // omit object and page from input because they're not part of the LeaveWeather schema
-                const { object, page, ...rest } = input;
                 await this.trackLeaveWeather({
                     leave,
-                    ...rest,
+                    ...input,
                 });
             };
             addTpaasLeaveTracking({

package/dist/ejs/tracker-proxy/consts.js

@@ -18,6 +18,7 @@ export const TPAAS_ALLOWED_METHODS = [
     'trackEngagementVideoAd',
     'trackEngagementWidget',
     'trackCompletedHealthAction',
+    'trackImpressionAdSlot',
     'trackImpressionForm',
     'trackImpressionHealthUIElement',
     'trackImpressionOffer',

package/dist/ejs/version.js

@@ -1,2 +1,2 @@
 // This file is auto-generated by bin/generate-version.js. Do not edit manually.
-export const SDK_VERSION = '8.0.0-rc.6';
+export const SDK_VERSION = '8.0.0-rc.7';

package/dist/ejs/visibility-observer/index.js

@@ -13,14 +13,16 @@ export class VisibilityObserver {
      * Uses {@link https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver | MutationObserver} to monitor the DOM for dynamically loaded content.
      * Callback is invoked only once per element.
      * @param selector The CSS selector for elements to track.
+     * @param options {ObserverOptions} Optional configuration for the observer.
+     * @param options.threshold Which ratio triggers the Observer callback.
      * @throws Error if called more than once.
      */
-    observe(selector) {
+    observe(selector, { threshold = 0.67 }) {
         if (this.selector) {
             throw new Error(`Cannot observe selector ${selector}. A visibility observer has already been set up for selector ${this.selector}.`);
         }
         this.selector = selector;
-        this.setupObservers();
+        this.setupObservers({ threshold });
         // biome-ignore lint/suspicious/useIterableCallbackReturn: -
         this.elements().forEach((elementToTrack) => this.observeIntersection(elementToTrack));
     }
@@ -30,14 +32,14 @@ export class VisibilityObserver {
     elements() {
         return Array.from(document.querySelectorAll(this.selector));
     }
-    // Initialize both observers and start watching for DOM changes
-    setupObservers() {
-        this.setupIntersectionObserver();
+    // Initialise both observers and start watching for DOM changes
+    setupObservers({ threshold }) {
+        this.setupIntersectionObserver({ threshold });
         this.setupMutationObserver();
         this.observeMutations();
     }
     // Create observer to detect when elements become visible in the viewport
-    setupIntersectionObserver() {
+    setupIntersectionObserver({ threshold }) {
         this.intersectionObserver = new IntersectionObserver((entries) => {
             entries.forEach((entry) => {
                 if (entry.isIntersecting) {
@@ -46,7 +48,7 @@ export class VisibilityObserver {
                     this.intersectionObserver.unobserve(node);
                 }
             });
-        }, { threshold: 2 / 3 });
+        }, { threshold });
     }
     // Create observer to detect DOM changes that may add/remove tracked elements
     setupMutationObserver() {

package/dist/ejs/wrapper/types/event.js

@@ -1 +1,4 @@
-export {};
+const LEGACY_PAGE_TYPE_VALUES = ['Article', 'Listing', 'Frontpage', 'SalesPoster', 'Page', 'LoginPoster'];
+export function isLegacyPageType(value) {
+    return LEGACY_PAGE_TYPE_VALUES.includes(value);
+}