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

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, 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';
@@ -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';
@@ -25,6 +26,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 +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,12 +155,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 +178,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 +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,
             };
         };
@@ -400,7 +429,9 @@ export default class Tracker {
             return {
                 name: exp.name || exp.id,
                 variant: exp.variant || '',
-                experimentSdrn: exp.id,
+                // 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,
             };
@@ -487,10 +518,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,28 +533,12 @@ export default class Tracker {
             consents: adaptConsentsToNewFormat(consents),
             providerId: this.state.providerId,
             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.
      *
@@ -544,6 +560,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);
     }
     /**
@@ -578,7 +597,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 +629,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 +754,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 +765,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 +838,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 +911,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 +1023,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 +1090,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({
@@ -1114,12 +1168,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 +1316,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/builders/experiments.js

@@ -1,4 +1,4 @@
-function generateExperimentSDRN(id, experimentationPlatform) {
+export function generateExperimentSDRN(id, experimentationPlatform) {
     return `sdrn:${experimentationPlatform}:experiment:${id}`;
 }
 /**

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.8';

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);
+}

package/dist/types/Tracker.d.ts

@@ -1,6 +1,5 @@
 import { type AdvertisingIdentifiers, type AdvertisingVendor } from '@schibsted/pulse-cis-sync';
-import { getCommonBuildersOutput, type InputParams } from '@schibsted/tpaas-event-builder';
-import { type IAnonymousViewUIElement, type ICompletedHealthAction, type IEngagementAudio, type IEngagementForm, type IEngagementHealthUIElement, type IEngagementOffer, type IEngagementTeaser, type IEngagementUIElement, type IEngagementVideo, type IEngagementVideoAd, type IEngagementWidget, type IImpressionForm, type IImpressionHealthUIElement, type IImpressionOffer, type IImpressionPlayer, type IImpressionTeaser, type IImpressionUIElement, type IImpressionWidget, type ILeave, type ILeaveArticle, type ILeaveAudioPage, type ILeaveError, type ILeaveFrontpage, type ILeaveLandingpage, type ILeaveListing, type ILeaveLockedArticle, type ILeaveLockedAudioPage, type ILeaveLockedVideoPage, type ILeavePage, type ILeaveSportsPage, type ILeaveVideoPage, type ILeaveWeather, type ITpaasEvent, type IViewArticle, type IViewAudioPage, type IViewError, type IViewFrontpage, type IViewHealthPage, type IViewLandingpage, type IViewListing, type IViewLockedArticle, type IViewLockedAudioPage, type IViewLockedVideoPage, type IViewPage, type IViewSportsPage, type IViewTitle, type IViewVideoPage, type IViewWeather } from '@schibsted/tpaas-schemas';
+import { type IAnonymousViewUIElement, type ICompletedHealthAction, type IEngagementAudio, type IEngagementForm, type IEngagementHealthUIElement, type IEngagementOffer, type IEngagementTeaser, type IEngagementUIElement, type IEngagementVideo, type IEngagementVideoAd, type IEngagementWidget, type IImpressionAdSlot, type IImpressionForm, type IImpressionHealthUIElement, type IImpressionOffer, type IImpressionPlayer, type IImpressionTeaser, type IImpressionUIElement, type IImpressionWidget, type ILeave, type ILeaveArticle, type ILeaveAudioPage, type ILeaveError, type ILeaveFrontpage, type ILeaveLandingpage, type ILeaveListing, type ILeaveLockedArticle, type ILeaveLockedAudioPage, type ILeaveLockedVideoPage, type ILeavePage, type ILeaveSportsPage, type ILeaveVideoPage, type ILeaveWeather, type InputParams, type ITpaasEvent, type IViewArticle, type IViewAudioPage, type IViewError, type IViewFrontpage, type IViewHealthPage, type IViewLandingpage, type IViewListing, type IViewLockedArticle, type IViewLockedAudioPage, type IViewLockedVideoPage, type IViewPage, type IViewSportsPage, type IViewTitle, type IViewVideoPage, type IViewWeather } from '@schibsted/tpaas-schemas';
 import logger from 'loglevel';
 import type { ActorInput, Consents, ConsentsInput, DeviceInput, LocationInput, ObjectInput, OriginInput, ProviderInput, TrackerInput } from './builders';
 import { engagementEvent, identityEvent, routableEvent, trackerEvent } from './builders/events';
@@ -9,8 +8,9 @@ import type { Deferred, ResolvedInput } from './defer';
 import { type Listener } from './EventBus/EventBus';
 import type { LeaveEvent, LeaveEventBuilder, LeaveEventOptions } from './leaveTracking/types';
 import type { AnonymousEventInputTypesByTrackingMethod, EventInput, EventInputTypesByTrackingMethod, TrackViewEventOptions } from './types';
+import { type ObserverOptions } from './visibility-observer';
 import type { ClickUIElementInputProperties } from './wrapper/engagement/ui-element/types';
-import type { BaseEventExperiment } from './wrapper/types';
+import { type BaseEventExperiment } from './wrapper/types';
 import type { ViewArticleInputProperties } from './wrapper/view/article/types';
 import type { ViewFrontpageInputProperties } from './wrapper/view/frontpage/types';
 import type { ViewListingInputProperties } from './wrapper/view/listing/types';
@@ -273,8 +273,16 @@ export default class Tracker {
     private bookmark;
     private legacyVisibilityObservers;
     private visibilityObservers;
-    private legacyCurrentPage;
+    /**
+     * @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
+     */
     private currentPage;
+    private getCurrentTpaasPage;
+    private getCurrentLegacyPage;
     /**
      * Promise that resolves when a session ID becomes available
      * @private
@@ -380,19 +388,6 @@ export default class Tracker {
      * @category TPaaS Tracking
      */
     private prepareTpaasEvent;
-    /**
-     * 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
-     */
-    generateGenericTpaasEvent<T>(input: T): Promise<T & ReturnType<typeof getCommonBuildersOutput>>;
     /**
      * This method extends the list of base experiments that will be automatically included in every event sent by the tracker.
      *
@@ -460,6 +455,28 @@ export default class Tracker {
      * @category Tracking
      */
     addUIElementVisibilityTracking(selector: string, buildEventFromElement: (element: HTMLElement) => InputParams<IImpressionUIElement>): void;
+    /**
+     * 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: string, callback: (element: HTMLElement) => void, options?: ObserverOptions): void;
     private setPageDefaults;
     /**
      * The old trackViewArticle method from the Media Wrapper.
@@ -625,6 +642,11 @@ export default class Tracker {
      * @category TPaaS Tracking
      */
     trackViewError(input: InputParams<IViewError>, options: TrackViewEventOptions<IViewError>): Promise<unknown>;
+    /**
+     * @param input
+     * @category TPaaS Tracking
+     */
+    trackImpressionAdSlot(input: InputParams<IImpressionAdSlot>): Promise<unknown>;
     /**
      * @param input
      * @category TPaaS Tracking

package/dist/types/builders/experiments.d.ts

@@ -1,4 +1,5 @@
 import type { TrackerEventInput } from './events';
+export declare function generateExperimentSDRN(id?: string | number, experimentationPlatform?: string): string;
 /**
  * The necessary values to construct a valid "sdrn" for experiment.
  * Additional properties are allowed.

package/dist/types/index.d.ts

@@ -5,7 +5,6 @@ export { TrackerEventInput } from './builders/events-node';
 export * from './Tracker';
 export { EventInput } from './types';
 export { T as Tracker };
-export type { InputParams } from '@schibsted/tpaas-event-builder';
 export * from '@schibsted/tpaas-schemas';
 export type { IPulseTrackerCreateParams } from './createPulseTracker';
 export { createPulseTracker } from './createPulseTracker';

package/dist/types/tracker-proxy/consts.d.ts

@@ -17,7 +17,7 @@ export declare const MESSAGE_TYPE_INVOKE = "pulse-tracker-proxy:invoke";
 export declare const MESSAGE_TYPE_RETURN = "pulse-tracker-proxy:return";
 export declare const MESSAGE_TYPE_RETURN_ERROR = "pulse-tracker-proxy:return-error";
 export declare const ALLOWED_METHODS: readonly ["track"];
-export declare const TPAAS_ALLOWED_METHODS: readonly ["trackAnonymousViewUIElement", "trackEngagementAudio", "trackEngagementForm", "trackEngagementHealthUIElement", "trackEngagementOffer", "trackEngagementTeaser", "trackEngagementUIElement", "trackEngagementVideo", "trackEngagementVideoAd", "trackEngagementWidget", "trackCompletedHealthAction", "trackImpressionForm", "trackImpressionHealthUIElement", "trackImpressionOffer", "trackImpressionPlayer", "trackImpressionTeaser", "trackImpressionUIElement", "trackImpressionWidget", "trackLeaveArticle", "trackLeaveAudioPage", "trackLeaveError", "trackLeaveFrontpage", "trackLeaveLandingpage", "trackLeaveListing", "trackLeaveLockedArticle", "trackLeaveLockedAudioPage", "trackLeaveLockedVideoPage", "trackLeavePage", "trackLeaveSportsPage", "trackLeaveVideoPage", "trackLeaveWeather", "trackViewArticle", "trackViewAudioPage", "trackViewError", "trackViewFrontpage", "trackViewHealthPage", "trackViewLandingpage", "trackViewListing", "trackViewLockedArticle", "trackViewLockedAudioPage", "trackViewLockedVideoPage", "trackViewPage", "trackViewSportsPage", "trackViewTitle", "trackViewVideoPage", "trackViewWeather", "trackLegacyViewArticle", "trackLegacyViewLoginPoster", "trackLegacyViewSalesPoster", "trackLegacyViewListing", "trackLegacyViewFrontpage", "trackLegacyViewPage", "trackLegacyViewUIElement", "trackLegacyClickUIElement"];
+export declare const TPAAS_ALLOWED_METHODS: readonly ["trackAnonymousViewUIElement", "trackEngagementAudio", "trackEngagementForm", "trackEngagementHealthUIElement", "trackEngagementOffer", "trackEngagementTeaser", "trackEngagementUIElement", "trackEngagementVideo", "trackEngagementVideoAd", "trackEngagementWidget", "trackCompletedHealthAction", "trackImpressionAdSlot", "trackImpressionForm", "trackImpressionHealthUIElement", "trackImpressionOffer", "trackImpressionPlayer", "trackImpressionTeaser", "trackImpressionUIElement", "trackImpressionWidget", "trackLeaveArticle", "trackLeaveAudioPage", "trackLeaveError", "trackLeaveFrontpage", "trackLeaveLandingpage", "trackLeaveListing", "trackLeaveLockedArticle", "trackLeaveLockedAudioPage", "trackLeaveLockedVideoPage", "trackLeavePage", "trackLeaveSportsPage", "trackLeaveVideoPage", "trackLeaveWeather", "trackViewArticle", "trackViewAudioPage", "trackViewError", "trackViewFrontpage", "trackViewHealthPage", "trackViewLandingpage", "trackViewListing", "trackViewLockedArticle", "trackViewLockedAudioPage", "trackViewLockedVideoPage", "trackViewPage", "trackViewSportsPage", "trackViewTitle", "trackViewVideoPage", "trackViewWeather", "trackLegacyViewArticle", "trackLegacyViewLoginPoster", "trackLegacyViewSalesPoster", "trackLegacyViewListing", "trackLegacyViewFrontpage", "trackLegacyViewPage", "trackLegacyViewUIElement", "trackLegacyClickUIElement"];
 export declare function isPulseProxyMessage(message: unknown): message is Message;
 export type TrackInvocation = {
     method: 'track';

package/dist/types/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "8.0.0-rc.6";
+export declare const SDK_VERSION = "8.0.0-rc.8";

package/dist/types/visibility-observer/index.d.ts

@@ -1,4 +1,7 @@
 type ComponentViewCallback = (node: HTMLElement) => void;
+export interface ObserverOptions {
+    threshold?: number;
+}
 /**
  * Observes visibility of elements matching a selector using MutationObserver and IntersectionObserver.
  */
@@ -16,9 +19,11 @@ export declare 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: string): void;
+    observe(selector: string, { threshold }: ObserverOptions): void;
     /**
      * @returns {HTMLElement[]} An array of elements that match the selector in the document.
      */

package/dist/types/wrapper/types/event.d.ts

@@ -1,5 +1,7 @@
 type NavigationType = 'navigation' | 'alternative' | 'refresh' | 'unknown';
-type PageType = 'Article' | 'Listing' | 'Frontpage' | 'SalesPoster' | 'Page' | 'LoginPoster';
+declare const LEGACY_PAGE_TYPE_VALUES: readonly ["Article", "Listing", "Frontpage", "SalesPoster", "Page", "LoginPoster"];
+export declare function isLegacyPageType(value: string): value is PageType;
+type PageType = (typeof LEGACY_PAGE_TYPE_VALUES)[number];
 type TargetCategory = 'Article' | 'Audio' | 'Video' | 'Weather' | 'Title' | 'other';
 type TargetType = 'Article' | 'ArticleReference' | 'ExternalContent';
 type SalesPosterType = 'Ip' | 'Login' | 'Paid' | 'Meter' | 'Personalised';