@schibsted/pulse-sdk 8.0.0-rc.20 → 8.0.0-rc.21

package/dist/types/Tracker.d.ts

@@ -2,15 +2,15 @@ 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';
 import { anonymousEngagementEvent, anonymousTrackerEvent } from './builders/events-anonymous-node';
-import { type AdvertisingIdentifiers, type AdvertisingVendor } from './cis-sync';
+import type { AdvertisingIdentifiers, AdvertisingVendor } from './cis-sync';
 import type { Deferred, ResolvedInput } from './defer';
 import { type Listener } from './EventBus/EventBus';
 import type { LeaveEvent, LeaveEventBuilder, LeaveEventOptions } from './leaveTracking/types';
-import { type IAnonymousViewUIElement, type ICompletedHealthAction, type IEngagementAd, type IEngagementAffiliate, type IEngagementAudio, type IEngagementForm, type IEngagementHealthUIElement, type IEngagementOffer, type IEngagementSchoolUIElement, type IEngagementSportsUIElement, type IEngagementTeaser, type IEngagementTvModule, type IEngagementTvSearch, type IEngagementUIElement, type IEngagementVideo, type IEngagementVideoAd, type IEngagementWidget, type IHeartbeatCommercialArticle, type IImpressionAd, type IImpressionAdSlot, type IImpressionAffiliate, type IImpressionForm, type IImpressionHealthUIElement, type IImpressionOffer, type IImpressionPlayer, type IImpressionSchoolUIElement, type IImpressionSportsUIElement, 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 ILeaveLockedPage, type ILeaveLockedVideoPage, type ILeavePage, type ILeaveSchoolPage, type ILeaveSportsPage, type ILeaveVideoPage, type ILeaveWeather, type ILoadAd, type InputParams, type IProvider, type IRequestAd, type ITpaasEvent, type IViewArticle, type IViewAudioPage, type IViewError, type IViewFrontpage, type IViewHealthPage, type IViewLandingpage, type IViewListing, type IViewLockedArticle, type IViewLockedAudioPage, type IViewLockedPage, type IViewLockedVideoPage, type IViewPage, type IViewSchoolPage, type IViewSportsPage, type IViewTitle, type IViewVideoPage, type IViewWeather } from './tpaas-schemas';
+import { type IAnonymousImpressionUIElement, type ICompletedHealthAction, type IContent, type IEngagementAd, type IEngagementAffiliate, type IEngagementAudio, type IEngagementForm, type IEngagementHealthUIElement, type IEngagementOffer, type IEngagementSchoolUIElement, type IEngagementSportsUIElement, type IEngagementTeaser, type IEngagementTvModule, type IEngagementTvSearch, type IEngagementUIElement, type IEngagementVideo, type IEngagementVideoAd, type IEngagementWidget, type IHeartbeatCommercialArticle, type IImpressionAd, type IImpressionAdSlot, type IImpressionAffiliate, type IImpressionForm, type IImpressionHealthUIElement, type IImpressionOffer, type IImpressionPlayer, type IImpressionSchoolUIElement, type IImpressionSportsUIElement, 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 ILeaveLockedPage, type ILeaveLockedVideoPage, type ILeavePage, type ILeaveSchoolPage, type ILeaveSportsPage, type ILeaveVideoPage, type ILeaveWeather, type ILoadAd, type InputParams, type IPageRef, type IProvider, type ITpaasEvent, type IViewArticle, type IViewAudioPage, type IViewError, type IViewFrontpage, type IViewHealthPage, type IViewLandingpage, type IViewListing, type IViewLockedArticle, type IViewLockedAudioPage, type IViewLockedPage, type IViewLockedVideoPage, type IViewPage, type IViewSchoolPage, type IViewSportsPage, type IViewTitle, type IViewVideoPage, type IViewWeather } from './tpaas-schemas';
 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, type Promisable } 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';
@@ -61,6 +61,23 @@ interface FallbackSDKConfig {
     fallbackCollectorBaseUrl: string;
     schemaLocation: string;
 }
+/**
+ * @private
+ */
+export type CurrentPageContext = {
+    /** Read and updated by both legacy and TPaaS tracking. */
+    info: Promisable<{
+        id: string;
+        type: string;
+        url?: string;
+    }>;
+    /** Updated by both legacy and TPaaS Views, and consumed by TPaaS events. */
+    referrer: Promisable<IPageRef>;
+    /** TPaaS-only metadata; legacy events neither read nor update it. */
+    content?: IContent;
+    /** TPaaS-only metadata; legacy events neither read nor update it. */
+    sports?: Pick<IViewSportsPage['object'], 'sportName' | 'sportSubview' | 'sportView' | 'sports'>;
+};
 /**
  * Possible deployment stages targeted by the SDK api and/or the event routing
  */
@@ -316,7 +333,11 @@ export default class Tracker {
      * which properties are shared and which are exclusively TPaaS metadata.
      */
     private currentPageContext;
-    private getCurrentTpaasPage;
+    /**
+     * What the TPaaS context module reads to resolve the context of an event.
+     * Built on every call, so it always reflects the current state.
+     */
+    private get tpaasContextSource();
     private getCurrentLegacyPage;
     private setCurrentTpaasPageData;
     /**
@@ -412,18 +433,6 @@ export default class Tracker {
      * @category Tracking Anonymous
      */
     trackAnonymous<T extends AnonymousEventType>(eventType: T, input: AnonymousEventInputTypesByTrackingMethod[T], options?: TrackOptions): Promise<any>;
-    private adaptExperiments;
-    /**
-     *
-     * @private
-     * @category TPaaS Tracking
-     */
-    private prepareAnonymousTpaasEvent;
-    /**
-     * @private
-     * @category TPaaS Tracking
-     */
-    private prepareTpaasEvent;
     /**
      * This method extends the list of base experiments that will be automatically included in every event sent by the tracker.
      *
@@ -597,7 +606,7 @@ export default class Tracker {
      * @param input
      * @category TPaaS Tracking
      */
-    trackAnonymousViewUIElement(input: InputParams<IAnonymousViewUIElement>): Promise<unknown>;
+    trackAnonymousImpressionUIElement(input: InputParams<IAnonymousImpressionUIElement>): Promise<unknown>;
     trackCompletedHealthAction(input: InputParams<ICompletedHealthAction>): Promise<unknown>;
     trackEngagementHealthUIElement(input: InputParams<IEngagementHealthUIElement>): Promise<unknown>;
     trackViewHealthPage(input: InputParams<IViewHealthPage>, options: TrackViewEventOptions<IViewHealthPage>): Promise<unknown>;
@@ -635,11 +644,6 @@ export default class Tracker {
      * @category TPaaS Tracking
      */
     trackLoadAd(input: InputParams<ILoadAd>): Promise<unknown>;
-    /**
-     * @param input
-     * @category TPaaS Tracking
-     */
-    trackRequestAd(input: InputParams<IRequestAd>): Promise<unknown>;
     /**
      * @param input
      * @param options
@@ -1148,7 +1152,7 @@ export default class Tracker {
      * If no session exists yet, returns a promise that resolves with the session ID
      * when it gets created (typically when the first non-anonymous tracking event is sent).
      *
-     * Note: Anonymous events (such as those sent via {@link trackAnonymous} or {@link trackAnonymousViewUIElement})
+     * Note: Anonymous events (such as those sent via {@link trackAnonymous} or {@link trackAnonymousImpressionUIElement})
      * do not create sessions and will not resolve pending session ID promises. The promise will only resolve when a
      * non-anonymous tracking event is sent.
      *

package/dist/types/builders/session-browser.d.ts

@@ -4,18 +4,5 @@ export type Session = {
     startTime: string;
     xDomainId?: string;
 };
-type StoredSession = {
-    id: string;
-    startTime: Date;
-    lastEventTime: Date;
-};
-type StoredSessionSerialized = [
-    id: string,
-    startTime: number,
-    lastEventTime: number
-];
-export declare const readAndParse: (storageKey: string) => StoredSessionSerialized | undefined;
-export declare const readSession: () => StoredSession | undefined;
 export declare const defaultValue: () => undefined;
 export default function session(_input?: TrackerEventInput, eventCreationDate?: Date): Session;
-export {};

package/dist/types/session/store.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The session as stored in the `_pulsesession` cookie, shared by legacy and TPaaS events.
+ * @private
+ */
+export type StoredSession = {
+    sessionId: string;
+    startTime: Date;
+    lastEventTime: Date;
+};
+/**
+ * @private
+ */
+export type TouchedSession = StoredSession & {
+    isFirstEvent: boolean;
+};
+/**
+ * @private
+ */
+export declare const generateSessionSDRN: (sessionId: string) => string;
+/**
+ * Reads the stored session. Any invalid or unreadable data is ignored.
+ * @private
+ */
+export declare const readSession: () => StoredSession | undefined;
+/**
+ * Registers an event created at `createdAt` in the stored session: extends the current session,
+ * or starts a new one when it expired, and stores the result.
+ *
+ * Call it synchronously, together with capturing `createdAt`, before any asynchronous work,
+ * so sessions are updated in the order events are tracked.
+ *
+ * @private
+ */
+export declare const touchSession: (createdAt: Date) => TouchedSession;

package/dist/types/tpaas-builders/builders/consents.d.ts

@@ -1,5 +1,5 @@
+import type { TpaasEventContext } from '../../tpaas-context/types';
 import type { IConsents } from '../../tpaas-schemas';
-import type { TpaasEventBuilderDependencies } from '../types';
-export declare function builder(consents: TpaasEventBuilderDependencies['consents']): {
+export declare function builder(consents: TpaasEventContext['consents']): {
     consents: IConsents;
 };

package/dist/types/tpaas-builders/builders/device.d.ts

@@ -1,5 +1,5 @@
+import type { TpaasEventContext } from '../../tpaas-context/types';
 import type { IDevice } from '../../tpaas-schemas';
-import type { TpaasEventBuilderDependencies } from '../types';
-export declare const builder: (environmentId: TpaasEventBuilderDependencies['environmentId'], jwe: TpaasEventBuilderDependencies['jwe']) => {
+export declare const builder: (environmentId: TpaasEventContext['environmentId'], jwe: TpaasEventContext['jwe'], browser: TpaasEventContext['browser']) => {
     device: IDevice;
 };

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

@@ -1,9 +1,9 @@
+import type { TpaasEventContext } from '../../tpaas-context/types';
 import type { IExperiments, InputParams, ITpaasEvent } from '../../tpaas-schemas';
-import type { TpaasEventBuilderDependencies } from '../types';
 type TpaasSchemasWithExperiments = Extract<ITpaasEvent, {
     experiments?: IExperiments;
 }>;
-export declare const builder: (baseExperiments?: TpaasEventBuilderDependencies['experiments'], eventExperiments?: InputParams<TpaasSchemasWithExperiments>['experiments']) => {
+export declare const builder: (baseExperiments?: TpaasEventContext['experiments'], eventExperiments?: InputParams<TpaasSchemasWithExperiments>['experiments']) => {
     experiments?: IExperiments;
 };
 export {};

package/dist/types/tpaas-builders/builders/pageInfo.d.ts

@@ -1,5 +1,6 @@
+import type { TpaasEventContext } from '../../tpaas-context/types';
 import type { IPageRef } from '../../tpaas-schemas';
-export declare const builder: (currentPage?: IPageRef) => {
+export declare const builder: (currentPage: IPageRef | undefined, url: TpaasEventContext['browser']['url']) => {
     page: {
         info: IPageRef;
     };

package/dist/types/tpaas-builders/builders/pageviewId.d.ts

@@ -1,5 +1,5 @@
-import type { TpaasEventBuilderDependencies } from '../types';
-export declare const builder: (pageviewId: TpaasEventBuilderDependencies['pageviewId']) => {
+import type { TpaasEventContext } from '../../tpaas-context/types';
+export declare const builder: (pageviewId: TpaasEventContext['pageviewId']) => {
     page: {
         pageviewId: string;
     };

package/dist/types/tpaas-builders/builders/provider.d.ts

@@ -1,5 +1,5 @@
+import type { TpaasEventContext } from '../../tpaas-context/types';
 import type { IProvider } from '../../tpaas-schemas';
-import type { TpaasEventBuilderDependencies } from '../types';
-export declare function builder(providerId: TpaasEventBuilderDependencies['providerId'], providerStage: TpaasEventBuilderDependencies['providerStage'], providerProduct: TpaasEventBuilderDependencies['providerProduct'], providerVersion: TpaasEventBuilderDependencies['providerVersion'], component?: TpaasEventBuilderDependencies['component'], componentVersion?: TpaasEventBuilderDependencies['componentVersion'], providerName?: TpaasEventBuilderDependencies['providerName'], providerGroup?: TpaasEventBuilderDependencies['providerGroup']): {
+export declare function builder(providerId: TpaasEventContext['providerId'], providerStage: TpaasEventContext['providerStage'], providerProduct: TpaasEventContext['providerProduct'], providerVersion: TpaasEventContext['providerVersion'], component?: TpaasEventContext['component'], componentVersion?: TpaasEventContext['componentVersion'], providerName?: TpaasEventContext['providerName'], providerGroup?: TpaasEventContext['providerGroup']): {
     provider: Pick<IProvider, 'component' | 'componentVersion' | 'name' | 'group'> & Required<Pick<IProvider, 'product' | 'providerId' | 'providerSdrn' | 'stage' | 'version'>>;
 };

package/dist/types/tpaas-builders/builders/session.d.ts

@@ -1,15 +1,4 @@
 import type { ISession } from '../../tpaas-schemas';
-type StoredSession = ISession & {
-    lastEventTime: Date;
-};
-type StoredSessionSerialized = [
-    sessionId: string,
-    startTime: number,
-    lastEventTime: number
-];
-export declare const builder: (createdAt: Date) => {
+export declare const builder: (session: ISession) => {
     session: ISession;
 };
-export declare const readAndParse: (storageKey: string) => StoredSessionSerialized | undefined;
-export declare const readSession: () => StoredSession | undefined;
-export {};

package/dist/types/tpaas-builders/builders/trackerBuilder.d.ts

@@ -1,5 +1,5 @@
+import type { TpaasEventContext } from '../../tpaas-context/types';
 import type { ITracker } from '../../tpaas-schemas';
-import type { TpaasEventBuilderDependencies } from '../types';
-export declare const builder: ({ isHybrid, routingStage, version, }: Pick<TpaasEventBuilderDependencies, 'isHybrid' | 'routingStage' | 'version'>) => {
+export declare const builder: ({ isHybrid, routingStage, version, }: Pick<TpaasEventContext, 'isHybrid' | 'routingStage' | 'version'>) => {
     tracker: ITracker;
 };

package/dist/types/tpaas-builders/builders/user.d.ts

@@ -1,5 +1,5 @@
+import type { TpaasEventContext } from '../../tpaas-context/types';
 import type { IUser } from '../../tpaas-schemas';
-import type { TpaasEventBuilderDependencies } from '../types';
-export declare const builder: (user: TpaasEventBuilderDependencies['user']) => {
+export declare const builder: (user: TpaasEventContext['user']) => {
     user?: IUser;
 };

package/dist/types/tpaas-builders/builders/utm.d.ts

@@ -1,5 +1,6 @@
+import type { TpaasEventContext } from '../../tpaas-context/types';
 import type { IUtmTags } from '../../tpaas-schemas';
-export declare const builder: () => {
+export declare const builder: (search: TpaasEventContext['browser']['search']) => {
     page: {
         utm?: IUtmTags;
     };

package/dist/types/tpaas-builders/builders.d.ts

@@ -1,14 +1,14 @@
-import { type IAnonymousViewUIElement, type ICompletedHealthAction, type IEngagementAd, type IEngagementAffiliate, type IEngagementAudio, type IEngagementForm, type IEngagementHealthUIElement, type IEngagementOffer, type IEngagementSchoolUIElement, type IEngagementSportsUIElement, type IEngagementTeaser, type IEngagementTvModule, type IEngagementTvSearch, type IEngagementUIElement, type IEngagementVideo, type IEngagementVideoAd, type IEngagementWidget, type IExperiments, type IHeartbeatCommercialArticle, type IImpressionAd, type IImpressionAdSlot, type IImpressionAffiliate, type IImpressionForm, type IImpressionHealthUIElement, type IImpressionOffer, type IImpressionPlayer, type IImpressionSchoolUIElement, type IImpressionSportsUIElement, type IImpressionTeaser, type IImpressionUIElement, type IImpressionWidget, type ILeaveArticle, type ILeaveAudioPage, type ILeaveError, type ILeaveFrontpage, type ILeaveLandingpage, type ILeaveListing, type ILeaveLockedArticle, type ILeaveLockedAudioPage, type ILeaveLockedPage, type ILeaveLockedVideoPage, type ILeavePage, type ILeaveSchoolPage, type ILeaveSportsPage, type ILeaveVideoPage, type ILeaveWeather, type ILoadAd, type InputParams, type IRequestAd, type ITpaasEvent, type IViewArticle, type IViewAudioPage, type IViewError, type IViewFrontpage, type IViewHealthPage, type IViewLandingpage, type IViewListing, type IViewLockedArticle, type IViewLockedAudioPage, type IViewLockedPage, type IViewLockedVideoPage, type IViewPage, type IViewSchoolPage, type IViewSportsPage, type IViewTitle, type IViewVideoPage, type IViewWeather } from '../tpaas-schemas';
-import type { TpaasAnonymousEventBuilderDependencies, TpaasEventBuilderDependencies } from './types';
+import type { TpaasAnonymousEventContext, TpaasEventContext } from '../tpaas-context/types';
+import { type IAnonymousImpressionUIElement, type ICompletedHealthAction, type IEngagementAd, type IEngagementAffiliate, type IEngagementAudio, type IEngagementForm, type IEngagementHealthUIElement, type IEngagementOffer, type IEngagementSchoolUIElement, type IEngagementSportsUIElement, type IEngagementTeaser, type IEngagementTvModule, type IEngagementTvSearch, type IEngagementUIElement, type IEngagementVideo, type IEngagementVideoAd, type IEngagementWidget, type IExperiments, type IHeartbeatCommercialArticle, type IImpressionAd, type IImpressionAdSlot, type IImpressionAffiliate, type IImpressionForm, type IImpressionHealthUIElement, type IImpressionOffer, type IImpressionPlayer, type IImpressionSchoolUIElement, type IImpressionSportsUIElement, type IImpressionTeaser, type IImpressionUIElement, type IImpressionWidget, type ILeaveArticle, type ILeaveAudioPage, type ILeaveError, type ILeaveFrontpage, type ILeaveLandingpage, type ILeaveListing, type ILeaveLockedArticle, type ILeaveLockedAudioPage, type ILeaveLockedPage, type ILeaveLockedVideoPage, type ILeavePage, type ILeaveSchoolPage, type ILeaveSportsPage, type ILeaveVideoPage, type ILeaveWeather, type ILoadAd, type ITpaasEvent, type IViewArticle, type IViewAudioPage, type IViewError, type IViewFrontpage, type IViewHealthPage, type IViewLandingpage, type IViewListing, type IViewLockedArticle, type IViewLockedAudioPage, type IViewLockedPage, type IViewLockedVideoPage, type IViewPage, type IViewSchoolPage, type IViewSportsPage, type IViewTitle, type IViewVideoPage, type IViewWeather } from '../tpaas-schemas';
 /**
  * Common builders output to be merged into all events
- * @param createdAt
- * @param dependencies {TpaasEventBuilderDependencies}
+ * @param context {TpaasEventContext} the event context, including the tracking input
  * @private
  */
-export declare const getCommonBuildersOutput: (createdAt: Date, dependencies: TpaasEventBuilderDependencies, input: InputParams<Extract<ITpaasEvent, {
+type EventContextWithExperiments = TpaasEventContext<Extract<ITpaasEvent, {
     experiments?: IExperiments;
-}>>) => {
+}>>;
+export declare const getCommonBuildersOutput: (context: EventContextWithExperiments) => {
     catalogVersion: string;
     consents: {
         advertising: "Accepted" | "Rejected" | "Unknown";
@@ -75,67 +75,67 @@ export declare const getCommonBuildersOutput: (createdAt: Date, dependencies: Tp
     };
     user: import("..").IUser | undefined;
 };
-export declare function buildAnonymousViewUIElementEvent(input: InputParams<IAnonymousViewUIElement>, dependencies: TpaasAnonymousEventBuilderDependencies): IAnonymousViewUIElement;
-export declare function buildViewArticleEvent(input: InputParams<IViewArticle>, dependencies: TpaasEventBuilderDependencies): IViewArticle;
-export declare function buildViewAudioPageEvent(input: InputParams<IViewAudioPage>, dependencies: TpaasEventBuilderDependencies): IViewAudioPage;
-export declare function buildViewErrorEvent(input: InputParams<IViewError>, dependencies: TpaasEventBuilderDependencies): IViewError;
-export declare function buildViewFrontpageEvent(input: InputParams<IViewFrontpage>, dependencies: TpaasEventBuilderDependencies): IViewFrontpage;
-export declare function buildViewLandingpageEvent(input: InputParams<IViewLandingpage>, dependencies: TpaasEventBuilderDependencies): IViewLandingpage;
-export declare function buildViewListingEvent(input: InputParams<IViewListing>, dependencies: TpaasEventBuilderDependencies): IViewListing;
-export declare function buildViewLockedArticleEvent(input: InputParams<IViewLockedArticle>, dependencies: TpaasEventBuilderDependencies): IViewLockedArticle;
-export declare function buildViewLockedAudioPageEvent(input: InputParams<IViewLockedAudioPage>, dependencies: TpaasEventBuilderDependencies): IViewLockedAudioPage;
-export declare function buildViewLockedPageEvent(input: InputParams<IViewLockedPage>, dependencies: TpaasEventBuilderDependencies): IViewLockedPage;
-export declare function buildViewLockedVideoPageEvent(input: InputParams<IViewLockedVideoPage>, dependencies: TpaasEventBuilderDependencies): IViewLockedVideoPage;
-export declare function buildLeaveLockedVideoPageEvent(input: InputParams<ILeaveLockedVideoPage>, dependencies: TpaasEventBuilderDependencies): ILeaveLockedVideoPage;
-export declare function buildViewPageEvent(input: InputParams<IViewPage>, dependencies: TpaasEventBuilderDependencies): IViewPage;
-export declare function buildViewSportsPageEvent(input: InputParams<IViewSportsPage>, dependencies: TpaasEventBuilderDependencies): IViewSportsPage;
-export declare function buildViewSchoolPageEvent(input: InputParams<IViewSchoolPage>, dependencies: TpaasEventBuilderDependencies): IViewSchoolPage;
-export declare function buildViewTitleEvent(input: InputParams<IViewTitle>, dependencies: TpaasEventBuilderDependencies): IViewTitle;
-export declare function buildViewVideoPageEvent(input: InputParams<IViewVideoPage>, dependencies: TpaasEventBuilderDependencies): IViewVideoPage;
-export declare function buildViewWeatherEvent(input: InputParams<IViewWeather>, dependencies: TpaasEventBuilderDependencies): IViewWeather;
-export declare function buildLeaveArticleEvent(input: InputParams<ILeaveArticle>, dependencies: TpaasEventBuilderDependencies): ILeaveArticle;
-export declare function buildLeaveAudioPageEvent(input: InputParams<ILeaveAudioPage>, dependencies: TpaasEventBuilderDependencies): ILeaveAudioPage;
-export declare function buildLeaveErrorEvent(input: InputParams<ILeaveError>, dependencies: TpaasEventBuilderDependencies): ILeaveError;
-export declare function buildLeaveFrontpageEvent(input: InputParams<ILeaveFrontpage>, dependencies: TpaasEventBuilderDependencies): ILeaveFrontpage;
-export declare function buildLeaveLandingpageEvent(input: InputParams<ILeaveLandingpage>, dependencies: TpaasEventBuilderDependencies): ILeaveLandingpage;
-export declare function buildLeaveListingEvent(input: InputParams<ILeaveListing>, dependencies: TpaasEventBuilderDependencies): ILeaveListing;
-export declare function buildLeaveLockedArticleEvent(input: InputParams<ILeaveLockedArticle>, dependencies: TpaasEventBuilderDependencies): ILeaveLockedArticle;
-export declare function buildLeaveLockedAudioPageEvent(input: InputParams<ILeaveLockedAudioPage>, dependencies: TpaasEventBuilderDependencies): ILeaveLockedAudioPage;
-export declare function buildLeaveLockedPageEvent(input: InputParams<ILeaveLockedPage>, dependencies: TpaasEventBuilderDependencies): ILeaveLockedPage;
-export declare function buildLeavePageEvent(input: InputParams<ILeavePage>, dependencies: TpaasEventBuilderDependencies): ILeavePage;
-export declare function buildLeaveSportsPageEvent(input: InputParams<ILeaveSportsPage>, dependencies: TpaasEventBuilderDependencies): ILeaveSportsPage;
-export declare function buildLeaveSchoolPageEvent(input: InputParams<ILeaveSchoolPage>, dependencies: TpaasEventBuilderDependencies): ILeaveSchoolPage;
-export declare function buildLeaveVideoPageEvent(input: InputParams<ILeaveVideoPage>, dependencies: TpaasEventBuilderDependencies): ILeaveVideoPage;
-export declare function buildLeaveWeatherEvent(input: InputParams<ILeaveWeather>, dependencies: TpaasEventBuilderDependencies): ILeaveWeather;
-export declare function buildEngagementAdEvent(input: InputParams<IEngagementAd>, dependencies: TpaasEventBuilderDependencies): IEngagementAd;
-export declare function buildEngagementAffiliateEvent(input: InputParams<IEngagementAffiliate>, dependencies: TpaasEventBuilderDependencies): IEngagementAffiliate;
-export declare function buildEngagementAudioEvent(input: InputParams<IEngagementAudio>, dependencies: TpaasEventBuilderDependencies): IEngagementAudio;
-export declare function buildEngagementFormEvent(input: InputParams<IEngagementForm>, dependencies: TpaasEventBuilderDependencies): IEngagementForm;
-export declare function buildEngagementOfferEvent(input: InputParams<IEngagementOffer>, dependencies: TpaasEventBuilderDependencies): IEngagementOffer;
-export declare function buildEngagementSportsUIElementEvent(input: InputParams<IEngagementSportsUIElement>, dependencies: TpaasEventBuilderDependencies): IEngagementSportsUIElement;
-export declare function buildEngagementSchoolUIElementEvent(input: InputParams<IEngagementSchoolUIElement>, dependencies: TpaasEventBuilderDependencies): IEngagementSchoolUIElement;
-export declare function buildEngagementTeaserEvent(input: InputParams<IEngagementTeaser>, dependencies: TpaasEventBuilderDependencies): IEngagementTeaser;
-export declare function buildEngagementTvModuleEvent(input: InputParams<IEngagementTvModule>, dependencies: TpaasEventBuilderDependencies): IEngagementTvModule;
-export declare function buildEngagementTvSearchEvent(input: InputParams<IEngagementTvSearch>, dependencies: TpaasEventBuilderDependencies): IEngagementTvSearch;
-export declare function buildEngagementUIElementEvent(input: InputParams<IEngagementUIElement>, dependencies: TpaasEventBuilderDependencies): IEngagementUIElement;
-export declare function buildEngagementVideoEvent(input: InputParams<IEngagementVideo>, dependencies: TpaasEventBuilderDependencies): IEngagementVideo;
-export declare function buildEngagementVideoAdEvent(input: InputParams<IEngagementVideoAd>, dependencies: TpaasEventBuilderDependencies): IEngagementVideoAd;
-export declare function buildEngagementWidgetEvent(input: InputParams<IEngagementWidget>, dependencies: TpaasEventBuilderDependencies): IEngagementWidget;
-export declare function buildHeartbeatCommercialArticleEvent(input: InputParams<IHeartbeatCommercialArticle>, dependencies: TpaasEventBuilderDependencies): IHeartbeatCommercialArticle;
-export declare function buildCompletedHealthActionEvent(input: InputParams<ICompletedHealthAction>, dependencies: TpaasEventBuilderDependencies): ICompletedHealthAction;
-export declare function buildEngagementHealthUIElementEvent(input: InputParams<IEngagementHealthUIElement>, dependencies: TpaasEventBuilderDependencies): IEngagementHealthUIElement;
-export declare function buildViewHealthPageEvent(input: InputParams<IViewHealthPage>, dependencies: TpaasEventBuilderDependencies): IViewHealthPage;
-export declare function buildImpressionHealthUIElementEvent(input: InputParams<IImpressionHealthUIElement>, dependencies: TpaasEventBuilderDependencies): IImpressionHealthUIElement;
-export declare function buildImpressionAdEvent(input: InputParams<IImpressionAd>, dependencies: TpaasEventBuilderDependencies): IImpressionAd;
-export declare function buildImpressionAdSlotEvent(input: InputParams<IImpressionAdSlot>, dependencies: TpaasEventBuilderDependencies): IImpressionAdSlot;
-export declare function buildImpressionAffiliateEvent(input: InputParams<IImpressionAffiliate>, dependencies: TpaasEventBuilderDependencies): IImpressionAffiliate;
-export declare function buildImpressionFormEvent(input: InputParams<IImpressionForm>, dependencies: TpaasEventBuilderDependencies): IImpressionForm;
-export declare function buildImpressionOfferEvent(input: InputParams<IImpressionOffer>, dependencies: TpaasEventBuilderDependencies): IImpressionOffer;
-export declare function buildImpressionPlayerEvent(input: InputParams<IImpressionPlayer>, dependencies: TpaasEventBuilderDependencies): IImpressionPlayer;
-export declare function buildImpressionSportsUIElementEvent(input: InputParams<IImpressionSportsUIElement>, dependencies: TpaasEventBuilderDependencies): IImpressionSportsUIElement;
-export declare function buildImpressionSchoolUIElementEvent(input: InputParams<IImpressionSchoolUIElement>, dependencies: TpaasEventBuilderDependencies): IImpressionSchoolUIElement;
-export declare function buildImpressionTeaserEvent(input: InputParams<IImpressionTeaser>, dependencies: TpaasEventBuilderDependencies): IImpressionTeaser;
-export declare function buildImpressionUIElementEvent(input: InputParams<IImpressionUIElement>, dependencies: TpaasEventBuilderDependencies): IImpressionUIElement;
-export declare function buildImpressionWidgetEvent(input: InputParams<IImpressionWidget>, dependencies: TpaasEventBuilderDependencies): IImpressionWidget;
-export declare function buildLoadAdEvent(input: InputParams<ILoadAd>, dependencies: TpaasEventBuilderDependencies): ILoadAd;
-export declare function buildRequestAdEvent(input: InputParams<IRequestAd>, dependencies: TpaasEventBuilderDependencies): IRequestAd;
+export declare function buildAnonymousImpressionUIElementEvent(context: TpaasAnonymousEventContext<IAnonymousImpressionUIElement>): IAnonymousImpressionUIElement;
+export declare function buildViewArticleEvent(context: TpaasEventContext<IViewArticle>): IViewArticle;
+export declare function buildViewAudioPageEvent(context: TpaasEventContext<IViewAudioPage>): IViewAudioPage;
+export declare function buildViewErrorEvent(context: TpaasEventContext<IViewError>): IViewError;
+export declare function buildViewFrontpageEvent(context: TpaasEventContext<IViewFrontpage>): IViewFrontpage;
+export declare function buildViewLandingpageEvent(context: TpaasEventContext<IViewLandingpage>): IViewLandingpage;
+export declare function buildViewListingEvent(context: TpaasEventContext<IViewListing>): IViewListing;
+export declare function buildViewLockedArticleEvent(context: TpaasEventContext<IViewLockedArticle>): IViewLockedArticle;
+export declare function buildViewLockedAudioPageEvent(context: TpaasEventContext<IViewLockedAudioPage>): IViewLockedAudioPage;
+export declare function buildViewLockedPageEvent(context: TpaasEventContext<IViewLockedPage>): IViewLockedPage;
+export declare function buildViewLockedVideoPageEvent(context: TpaasEventContext<IViewLockedVideoPage>): IViewLockedVideoPage;
+export declare function buildLeaveLockedVideoPageEvent(context: TpaasEventContext<ILeaveLockedVideoPage>): ILeaveLockedVideoPage;
+export declare function buildViewPageEvent(context: TpaasEventContext<IViewPage>): IViewPage;
+export declare function buildViewSportsPageEvent(context: TpaasEventContext<IViewSportsPage>): IViewSportsPage;
+export declare function buildViewSchoolPageEvent(context: TpaasEventContext<IViewSchoolPage>): IViewSchoolPage;
+export declare function buildViewTitleEvent(context: TpaasEventContext<IViewTitle>): IViewTitle;
+export declare function buildViewVideoPageEvent(context: TpaasEventContext<IViewVideoPage>): IViewVideoPage;
+export declare function buildViewWeatherEvent(context: TpaasEventContext<IViewWeather>): IViewWeather;
+export declare function buildLeaveArticleEvent(context: TpaasEventContext<ILeaveArticle>): ILeaveArticle;
+export declare function buildLeaveAudioPageEvent(context: TpaasEventContext<ILeaveAudioPage>): ILeaveAudioPage;
+export declare function buildLeaveErrorEvent(context: TpaasEventContext<ILeaveError>): ILeaveError;
+export declare function buildLeaveFrontpageEvent(context: TpaasEventContext<ILeaveFrontpage>): ILeaveFrontpage;
+export declare function buildLeaveLandingpageEvent(context: TpaasEventContext<ILeaveLandingpage>): ILeaveLandingpage;
+export declare function buildLeaveListingEvent(context: TpaasEventContext<ILeaveListing>): ILeaveListing;
+export declare function buildLeaveLockedArticleEvent(context: TpaasEventContext<ILeaveLockedArticle>): ILeaveLockedArticle;
+export declare function buildLeaveLockedAudioPageEvent(context: TpaasEventContext<ILeaveLockedAudioPage>): ILeaveLockedAudioPage;
+export declare function buildLeaveLockedPageEvent(context: TpaasEventContext<ILeaveLockedPage>): ILeaveLockedPage;
+export declare function buildLeavePageEvent(context: TpaasEventContext<ILeavePage>): ILeavePage;
+export declare function buildLeaveSportsPageEvent(context: TpaasEventContext<ILeaveSportsPage>): ILeaveSportsPage;
+export declare function buildLeaveSchoolPageEvent(context: TpaasEventContext<ILeaveSchoolPage>): ILeaveSchoolPage;
+export declare function buildLeaveVideoPageEvent(context: TpaasEventContext<ILeaveVideoPage>): ILeaveVideoPage;
+export declare function buildLeaveWeatherEvent(context: TpaasEventContext<ILeaveWeather>): ILeaveWeather;
+export declare function buildEngagementAdEvent(context: TpaasEventContext<IEngagementAd>): IEngagementAd;
+export declare function buildEngagementAffiliateEvent(context: TpaasEventContext<IEngagementAffiliate>): IEngagementAffiliate;
+export declare function buildEngagementAudioEvent(context: TpaasEventContext<IEngagementAudio>): IEngagementAudio;
+export declare function buildEngagementFormEvent(context: TpaasEventContext<IEngagementForm>): IEngagementForm;
+export declare function buildEngagementOfferEvent(context: TpaasEventContext<IEngagementOffer>): IEngagementOffer;
+export declare function buildEngagementSportsUIElementEvent(context: TpaasEventContext<IEngagementSportsUIElement>): IEngagementSportsUIElement;
+export declare function buildEngagementSchoolUIElementEvent(context: TpaasEventContext<IEngagementSchoolUIElement>): IEngagementSchoolUIElement;
+export declare function buildEngagementTeaserEvent(context: TpaasEventContext<IEngagementTeaser>): IEngagementTeaser;
+export declare function buildEngagementTvModuleEvent(context: TpaasEventContext<IEngagementTvModule>): IEngagementTvModule;
+export declare function buildEngagementTvSearchEvent(context: TpaasEventContext<IEngagementTvSearch>): IEngagementTvSearch;
+export declare function buildEngagementUIElementEvent(context: TpaasEventContext<IEngagementUIElement>): IEngagementUIElement;
+export declare function buildEngagementVideoEvent(context: TpaasEventContext<IEngagementVideo>): IEngagementVideo;
+export declare function buildEngagementVideoAdEvent(context: TpaasEventContext<IEngagementVideoAd>): IEngagementVideoAd;
+export declare function buildEngagementWidgetEvent(context: TpaasEventContext<IEngagementWidget>): IEngagementWidget;
+export declare function buildHeartbeatCommercialArticleEvent(context: TpaasEventContext<IHeartbeatCommercialArticle>): IHeartbeatCommercialArticle;
+export declare function buildCompletedHealthActionEvent(context: TpaasEventContext<ICompletedHealthAction>): ICompletedHealthAction;
+export declare function buildEngagementHealthUIElementEvent(context: TpaasEventContext<IEngagementHealthUIElement>): IEngagementHealthUIElement;
+export declare function buildViewHealthPageEvent(context: TpaasEventContext<IViewHealthPage>): IViewHealthPage;
+export declare function buildImpressionHealthUIElementEvent(context: TpaasEventContext<IImpressionHealthUIElement>): IImpressionHealthUIElement;
+export declare function buildImpressionAdEvent(context: TpaasEventContext<IImpressionAd>): IImpressionAd;
+export declare function buildImpressionAdSlotEvent(context: TpaasEventContext<IImpressionAdSlot>): IImpressionAdSlot;
+export declare function buildImpressionAffiliateEvent(context: TpaasEventContext<IImpressionAffiliate>): IImpressionAffiliate;
+export declare function buildImpressionFormEvent(context: TpaasEventContext<IImpressionForm>): IImpressionForm;
+export declare function buildImpressionOfferEvent(context: TpaasEventContext<IImpressionOffer>): IImpressionOffer;
+export declare function buildImpressionPlayerEvent(context: TpaasEventContext<IImpressionPlayer>): IImpressionPlayer;
+export declare function buildImpressionSportsUIElementEvent(context: TpaasEventContext<IImpressionSportsUIElement>): IImpressionSportsUIElement;
+export declare function buildImpressionSchoolUIElementEvent(context: TpaasEventContext<IImpressionSchoolUIElement>): IImpressionSchoolUIElement;
+export declare function buildImpressionTeaserEvent(context: TpaasEventContext<IImpressionTeaser>): IImpressionTeaser;
+export declare function buildImpressionUIElementEvent(context: TpaasEventContext<IImpressionUIElement>): IImpressionUIElement;
+export declare function buildImpressionWidgetEvent(context: TpaasEventContext<IImpressionWidget>): IImpressionWidget;
+export declare function buildLoadAdEvent(context: TpaasEventContext<ILoadAd>): ILoadAd;
+export {};

package/dist/types/tpaas-builders/index.d.ts

@@ -1,3 +1,2 @@
 export * from './builders';
 export { isPageType } from './guards';
-export type { TpaasAnonymousEventBuilderDependencies, TpaasEventBuilderDependencies } from './types';

package/dist/types/tpaas-context/adapters.d.ts

@@ -0,0 +1,26 @@
+import type { ActorInput, Consents } from '../builders';
+import type { IExperiments } from '../tpaas-schemas';
+import type { BaseEventExperiment } from '../wrapper/types';
+import type { TpaasEventContext, UserParams } from './types';
+/**
+ * Adapts the legacy actor input to the TPaaS user format.
+ *
+ * @privateRemarks
+ * This is a temporary solution to adapt the actor to the new format.
+ * It should be removed once we have new methods in place to get the actor.
+ *
+ * @private
+ */
+export declare function adaptActorToNewFormat(actor?: ActorInput): UserParams | undefined;
+/**
+ * Adapts the legacy consents to the TPaaS consents format.
+ *
+ * @private
+ */
+export declare function adaptConsentsToNewFormat(consents?: Consents): TpaasEventContext['consents'];
+/**
+ * Adapts the base experiments stored in the tracker to the TPaaS experiments format.
+ *
+ * @private
+ */
+export declare function adaptExperiments(baseExperiments?: BaseEventExperiment[]): IExperiments;

package/dist/types/tpaas-context/browser.d.ts

@@ -0,0 +1,8 @@
+import type { TpaasBrowserContext } from './types';
+/**
+ * Reads the browser state that can change between events, such as the URL after an SPA navigation
+ * or the viewport after a resize. Call it synchronously, when the event is tracked.
+ *
+ * @private
+ */
+export declare const captureBrowserContext: () => TpaasBrowserContext;

package/dist/types/tpaas-context/index.d.ts

@@ -0,0 +1,2 @@
+export { prepareAnonymousTpaasEventContext, prepareTpaasEventContext, type TpaasContextSource } from './prepare';
+export type { TpaasAnonymousEventContext, TpaasEventContext } from './types';

package/dist/types/tpaas-context/prepare.d.ts

@@ -0,0 +1,38 @@
+import type { Consents } from '../builders';
+import type { Builders, CurrentPageContext, SDKState } from '../Tracker';
+import type { InputParams, ITpaasEvent } from '../tpaas-schemas';
+import type { TpaasAnonymousEventContext, TpaasEventContext } from './types';
+/**
+ * What the Tracker provides to resolve the context of a TPaaS event.
+ *
+ * `state`, `builders` and `currentPage` are read synchronously when an event is tracked, so a later
+ * update or View event cannot change the context of an event that is still being prepared.
+ *
+ * @private
+ */
+export interface TpaasContextSource {
+    state: Pick<SDKState, 'isHybrid' | 'pageViewId' | 'providerId' | 'provider' | 'component' | 'componentVersion' | 'stage' | 'product' | 'version' | 'deployStageTpaas'>;
+    builders: Builders;
+    currentPage: CurrentPageContext;
+    /** Applies the remote configuration. A failure does not prevent the event from being tracked. */
+    applyRemoteConfig(): Promise<void>;
+    /** Applies the remote configuration and syncs with CIS. A failure does not prevent the event from being tracked. */
+    syncRemoteResources(builders: Builders): Promise<unknown>;
+    getConsents(): Promise<Consents>;
+    /** Called when the event's session has been resolved and stored. */
+    onSessionResolved(): void;
+}
+/**
+ * Resolves the context of an anonymous TPaaS event.
+ * Callers specify the event schema because it cannot be inferred from `InputParams<I>`.
+ *
+ * @private
+ */
+export declare function prepareAnonymousTpaasEventContext<I extends ITpaasEvent>(source: TpaasContextSource, input: InputParams<I>): Promise<TpaasAnonymousEventContext<I>>;
+/**
+ * Resolves the context of a TPaaS event.
+ * Callers specify the event schema because it cannot be inferred from `InputParams<I>`.
+ *
+ * @private
+ */
+export declare function prepareTpaasEventContext<I extends ITpaasEvent>(source: TpaasContextSource, input: InputParams<I>): Promise<TpaasEventContext<I>>;

package/dist/types/tpaas-context/session.d.ts

@@ -0,0 +1,10 @@
+import type { ISession } from '../tpaas-schemas';
+/**
+ * Registers an event created at `createdAt` in the stored session and returns it in the TPaaS format.
+ *
+ * Call it synchronously, together with capturing `createdAt`, before any asynchronous work.
+ * Sessions are then updated in the order events are tracked, which is also their creation order.
+ *
+ * @private
+ */
+export declare const resolveSession: (createdAt: Date) => ISession;

package/dist/types/tpaas-context/types.d.ts

@@ -0,0 +1,66 @@
+import type { IConsents, IContent, IDevice, IExperiments, InputParams, IPageRef, IProvider, ISession, ITpaasEvent, ITracker, IUser, IViewSportsPage } from '../tpaas-schemas';
+/**
+ * Browser state read when the event is tracked.
+ * @private
+ */
+export interface TpaasBrowserContext {
+    url?: string;
+    search: string;
+    screenOrientationType?: OrientationType;
+    viewportWidth: number;
+    viewportHeight: number;
+    userAgent: string | undefined;
+}
+export type UserParams = Pick<IUser, 'hasAnySubscription' | 'region'> & {
+    id: string;
+    realm: string;
+};
+/**
+ * Everything the TPaaS event builders need besides the tracking input, resolved by `prepareTpaasEventContext`.
+ *
+ * @private
+ *
+ * @privateRemarks
+ * These can be different from one event type to another, depending on the builders used by that event type.
+ * However, for now, we use the same context for all event types. let's make it more complex only if needed.
+ */
+export interface TpaasEventContext<I extends ITpaasEvent = ITpaasEvent> {
+    /**
+     * The tracking input, copied when the track method is called.
+     */
+    input: InputParams<I>;
+    /**
+     * Event creation time, captured when the track method is called, before any asynchronous work.
+     */
+    createdAt: Date;
+    /**
+     * Session resolved together with `createdAt`, so sessions are updated in the order events are tracked.
+     */
+    session: ISession;
+    /**
+     * Browser state read together with `createdAt`, so it describes the moment the event was tracked.
+     */
+    browser: TpaasBrowserContext;
+    user?: UserParams;
+    version: ITracker['version'];
+    isHybrid: ITracker['isHybrid'];
+    routingStage: ITracker['routingStage'];
+    consents?: IConsents;
+    providerId: IProvider['providerId'];
+    providerName?: IProvider['name'];
+    providerGroup?: IProvider['group'];
+    providerStage: IProvider['stage'];
+    providerProduct: NonNullable<IProvider['product']>;
+    providerVersion: NonNullable<IProvider['version']>;
+    component?: IProvider['component'];
+    componentVersion?: IProvider['componentVersion'];
+    environmentId: IDevice['environmentId'];
+    jwe: IDevice['jweIds'];
+    pageviewId: string;
+    experiments?: IExperiments;
+    currentPage?: IPageRef;
+    currentPageContent?: IContent;
+    currentPageSports?: Pick<IViewSportsPage['object'], 'sportName' | 'sportSubview' | 'sportView' | 'sports'>;
+    currentPageReferrer: IPageRef;
+}
+export type TpaasAnonymousEventContext<I extends ITpaasEvent> = Pick<TpaasEventContext<I>, 'input' | 'createdAt' | 'browser' | 'isHybrid' | 'version' | 'pageviewId' | 'providerId' | 'providerName' | 'providerGroup' | 'providerStage' | 'providerProduct' | 'providerVersion' | 'experiments' | 'component' | 'componentVersion' | 'currentPageReferrer' | 'routingStage'>;