@guardian/commercial-core 30.2.0 → 32.0.0

package/dist/cjs/email-hash.d.ts

@@ -1,4 +1,4 @@
-type HashClient = 'id5' | 'uid2' | 'euid';
+type HashClient = 'euid' | 'id5' | 'liveramp' | 'uid2' | 'permutive';
 type Email = `${string}@${string}`;
 declare function normaliseEmail(email: string): Email;
 declare function hashEmailForClient(email: string, client: HashClient): Promise<string>;

package/dist/cjs/email-hash.js

@@ -2,18 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.hashEmailForClient = hashEmailForClient;
 exports.normaliseEmail = normaliseEmail;
-function toHex(hashBuffer) {
-    const hashArray = Array.from(new Uint8Array(hashBuffer));
+function toBase64(content) {
+    const hashBytes = new Uint8Array(content);
+    const base64Hash = btoa(String.fromCharCode(...hashBytes));
+    return base64Hash;
+}
+function toHex(content) {
+    const hashArray = Array.from(new Uint8Array(content));
     const hashHex = hashArray
         .map((bytes) => bytes.toString(16).padStart(2, '0'))
         .join('');
     return hashHex;
 }
-function toBase64(hashBuffer) {
-    const hashBytes = new Uint8Array(hashBuffer);
-    const base64Hash = btoa(String.fromCharCode(...hashBytes));
-    return base64Hash;
-}
 function normaliseEmail(email) {
     const normalisedEmail = email.trim().toLowerCase();
     const [name, domain] = normalisedEmail.split('@');
@@ -25,13 +25,15 @@ function normaliseEmail(email) {
 }
 async function hashEmailForClient(email, client) {
     const normalisedEmail = normaliseEmail(email);
-    const utf8 = new TextEncoder().encode(normalisedEmail);
-    const hashBuffer = await crypto.subtle.digest('SHA-256', utf8);
+    const textAsBuffer = new TextEncoder().encode(normalisedEmail);
+    const hashBuffer = await crypto.subtle.digest('SHA-256', textAsBuffer);
     switch (client) {
-        case 'id5':
-            return toHex(hashBuffer);
-        case 'uid2':
         case 'euid':
+        case 'uid2':
             return toBase64(hashBuffer);
+        case 'id5':
+        case 'liveramp':
+        case 'permutive':
+            return toHex(hashBuffer);
     }
 }

package/dist/cjs/event-timer.d.ts

@@ -1,4 +1,9 @@
-import type { ConnectionType } from './types.js';
+import type { ConnectionType, NetworkInformation } from './types.js';
+declare global {
+    interface Navigator {
+        readonly connection?: NetworkInformation;
+    }
+}
 declare const supportsPerformanceAPI: () => boolean;
 interface EventTimerProperties {
     type?: ConnectionType;

package/dist/cjs/global-ad-events.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `globalAdEvents` acts as an event bus that broadcasts ad lifecycle
+ * events, allowing consumers to react to ad status changes without
+ * needing direct access to `Advert` instances.
+ * @see /docs/global-ad-events.md
+ */
+declare const globalAdEvents: EventTarget;
+export { globalAdEvents };

package/dist/cjs/global-ad-events.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.globalAdEvents = void 0;
+/**
+ * `globalAdEvents` acts as an event bus that broadcasts ad lifecycle
+ * events, allowing consumers to react to ad status changes without
+ * needing direct access to `Advert` instances.
+ * @see /docs/global-ad-events.md
+ */
+const globalAdEvents = new EventTarget();
+exports.globalAdEvents = globalAdEvents;

package/dist/cjs/global.d.ts

@@ -1,77 +1,13 @@
-import type { EventTimer } from './event-timer.js';
-import type { AdBlockers, Admiral, Apstag, ArticleCounts, ComscoreGlobals, Confiant, Config, DfpEnv, FetchBidResponse, GoogleTagParams, GoogleTrackConversionObject, HeaderNotification, IasPET, NetworkInformation, NSdkInstance, Ophan, OptOutAdSlot, OptOutInitializeOptions, Permutive, SafeFrameAPI, TeadsAnalytics, Trac } from './types.js';
+import type { CoreGuardian } from './types.js';
 declare global {
-    interface Navigator {
-        readonly connection?: NetworkInformation;
-        readonly cookieDeprecationLabel?: {
-            getValue: () => Promise<string>;
-        };
-    }
     interface Window {
-        guardian: {
-            ophan?: Ophan;
-            config: Config;
-            queue: Array<() => Promise<void>>;
-            mustardCut?: boolean;
-            polyfilled?: boolean;
-            adBlockers: AdBlockers;
-            css: {
-                onLoad: () => void;
-                loaded: boolean;
-            };
-            articleCounts?: ArticleCounts;
-            commercial?: {
-                dfpEnv?: DfpEnv;
-                a9WinningBids?: FetchBidResponse[];
-            };
-            notificationEventHistory?: HeaderNotification[][];
-            commercialTimer?: EventTimer;
-            offlineCount?: number;
-            modules: {
-                sentry?: {
-                    reportError?: (error: Error, feature: string, tags?: Record<string, string>, extras?: Record<string, unknown>) => void;
-                };
-                abTests?: {
-                    getParticipations: () => Record<string, string>;
-                    isUserInTest: (testId: string) => boolean;
-                    isUserInTestGroup: (testId: string, variantId: string) => boolean;
-                };
-            };
-        };
-        ootag: {
-            queue: Array<() => void>;
-            initializeOo: (o: OptOutInitializeOptions) => void;
-            addParameter: (key: string, value: string | string[]) => void;
-            addParameterForSlot: (slotId: string, key: string, value: string | string[]) => void;
-            defineSlot: (o: OptOutAdSlot) => void;
-            makeRequests: () => void;
-            refreshSlot: (slotId: string) => void;
-            refreshAllSlots: () => void;
-            logger: (...args: unknown[]) => void;
-        };
-        readonly navigator: Navigator;
-        confiant?: Confiant;
-        apstag?: Apstag;
-        permutive?: Permutive;
-        _comscore?: ComscoreGlobals[];
-        __iasPET?: IasPET;
-        teads_analytics?: TeadsAnalytics;
-        $sf: SafeFrameAPI;
-        conf: unknown;
-        NOLCMB: {
-            getInstance: (apid: string) => NSdkInstance;
+        guardian: CoreGuardian;
+        googletag: {
+            getConfig?: <Key extends string>(key: Key) => Key extends 'targeting' ? {
+                targeting: Record<string, string | string[]>;
+            } : unknown;
+            pubads: () => unknown;
         };
-        nol_t: (pvar: {
-            cid: string;
-            content: string;
-            server: string;
-        }) => Trac;
-        google_trackConversion?: (arg0: GoogleTrackConversionObject) => void;
-        google_tag_params?: GoogleTagParams;
-        _brandmetrics?: Array<{
-            cmd: string;
-            val: Record<string, unknown>;
-        }>;
-        admiral?: Admiral;
     }
 }
+export type { CoreGuardian };

package/dist/cjs/index.d.ts

@@ -9,6 +9,7 @@ export { buildImaAdTagUrl } from './targeting/youtube-ima.js';
 export { getPermutivePFPSegments } from './permutive.js';
 export { isEligibleForTeads } from './targeting/teads-eligibility.js';
 export { hashEmailForClient } from './email-hash.js';
+export { globalAdEvents } from './global-ad-events.js';
 export type { AdSize, SizeMapping, SlotName } from './ad-sizes.js';
 export type { PageTargeting } from './targeting/build-page-targeting.js';
 export type { AdsConfigDisabled, AdsConfigUSNATorAus, AdsConfigTCFV2, } from './types.js';

package/dist/cjs/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.hashEmailForClient = exports.isEligibleForTeads = exports.getPermutivePFPSegments = exports.buildImaAdTagUrl = exports.buildPageTargeting = exports.initCommercialMetrics = exports.bypassCommercialMetricsSampling = exports.constants = exports.adSizes = exports.EventTimer = exports.isAdBlockInUse = void 0;
+exports.globalAdEvents = exports.hashEmailForClient = exports.isEligibleForTeads = exports.getPermutivePFPSegments = exports.buildImaAdTagUrl = exports.buildPageTargeting = exports.initCommercialMetrics = exports.bypassCommercialMetricsSampling = exports.constants = exports.adSizes = exports.EventTimer = exports.isAdBlockInUse = void 0;
 var detect_ad_blocker_1 = require("./detect-ad-blocker.js");
 Object.defineProperty(exports, "isAdBlockInUse", { enumerable: true, get: function () { return detect_ad_blocker_1.isAdBlockInUse; } });
 var event_timer_1 = require("./event-timer.js");
@@ -56,3 +56,5 @@ var teads_eligibility_1 = require("./targeting/teads-eligibility.js");
 Object.defineProperty(exports, "isEligibleForTeads", { enumerable: true, get: function () { return teads_eligibility_1.isEligibleForTeads; } });
 var email_hash_1 = require("./email-hash.js");
 Object.defineProperty(exports, "hashEmailForClient", { enumerable: true, get: function () { return email_hash_1.hashEmailForClient; } });
+var global_ad_events_1 = require("./global-ad-events.js");
+Object.defineProperty(exports, "globalAdEvents", { enumerable: true, get: function () { return global_ad_events_1.globalAdEvents; } });

package/dist/cjs/targeting/build-page-targeting.d.ts

@@ -1,4 +1,3 @@
-import type { Participations } from '@guardian/ab-core';
 import type { ConsentState, CountryCode } from '@guardian/libs';
 import type { AdManagerGroup, Frequency } from './personalised.js';
 import type { SharedTargeting } from './shared.js';
@@ -40,7 +39,7 @@ type PageTargeting = PartialWithNulls<{
 declare const filterValues: (pageTargets: Record<string, unknown>) => Record<string, string | string[]>;
 type UserId = {
     name: string;
-    params?: Record<string, string | number>;
+    params?: Record<string, string | number | boolean | Record<string, unknown>>;
     storage?: {
         type: 'cookie' | 'html5';
         name: string;
@@ -50,12 +49,12 @@ type UserId = {
 };
 type BuildPageTargetingParams = {
     adFree: boolean;
-    clientSideParticipations: Participations;
+    abTestParticipations: Record<string, string>;
     consentState: ConsentState;
     isSignedIn?: boolean;
     youtube?: boolean;
     idProviders?: UserId[];
 };
-declare const buildPageTargeting: ({ adFree, clientSideParticipations, consentState, isSignedIn, youtube, idProviders, }: BuildPageTargetingParams) => Record<string, string | string[]>;
+declare const buildPageTargeting: ({ adFree, abTestParticipations, consentState, isSignedIn, youtube, idProviders, }: BuildPageTargetingParams) => Record<string, string | string[]>;
 export { buildPageTargeting, filterValues, getLocalHour };
 export type { UserId, PageTargeting };

package/dist/cjs/targeting/build-page-targeting.js

@@ -49,7 +49,7 @@ const isFirstVisit = (referrer) => {
     }
     return !referrerMatchesHost(referrer);
 };
-const buildPageTargeting = ({ adFree, clientSideParticipations, consentState, isSignedIn = false, youtube = false, idProviders = [], }) => {
+const buildPageTargeting = ({ adFree, abTestParticipations, consentState, isSignedIn = false, youtube = false, idProviders = [], }) => {
     const { page, isDotcomRendering } = window.guardian.config;
     const adFreeTargeting = adFree ? { af: 't' } : {};
     const sharedAdTargeting = page.sharedAdTargeting
@@ -74,11 +74,7 @@ const buildPageTargeting = ({ adFree, clientSideParticipations, consentState, is
         localHour: (0, shared_1.getLocalHour)(),
         isSignedIn,
         pageViewId: window.guardian.config.ophan.pageViewId,
-        participations: {
-            clientSideParticipations,
-            serverSideParticipations: window.guardian.config.tests ?? {},
-            betaAbTestParticipations: window.guardian.modules.abTests?.getParticipations() ?? {},
-        },
+        participations: abTestParticipations,
         referrer,
         idProviders,
     });

package/dist/cjs/targeting/session.d.ts

@@ -1,4 +1,3 @@
-import type { Participations } from '@guardian/ab-core';
 import type { CountryCode } from '@guardian/libs';
 import type { UserId } from '../targeting/build-page-targeting.js';
 import type { False, True } from './types.js';
@@ -107,29 +106,17 @@ type SessionTargeting = {
      */
     idp: string[] | null;
 };
-type AllParticipations = {
-    clientSideParticipations: Participations;
-    serverSideParticipations: {
-        [key: `${string}Control`]: 'control';
-        [key: `${string}Variant`]: 'variant';
-    };
-    betaAbTestParticipations: Record<string, string>;
-};
-/**
- * @todo drop old client/server side participations and rename to just `abTestsParticipations` once
- * all tests have been migrated to the new AB testing platform
- */
-declare const experimentsTargeting: ({ clientSideParticipations, serverSideParticipations, betaAbTestParticipations, }: AllParticipations) => SessionTargeting["ab"];
+declare const abTestingTargeting: (abTestParticipations: Record<string, string>) => SessionTargeting["ab"];
 type Session = {
     adTest: SessionTargeting['at'];
     countryCode: CountryCode;
     localHour: string;
     isSignedIn: boolean;
     pageViewId: SessionTargeting['pv'];
-    participations: AllParticipations;
+    participations: Record<string, string>;
     referrer: string;
     idProviders: UserId[];
 };
 declare const getSessionTargeting: ({ adTest, countryCode, localHour, isSignedIn, pageViewId, participations, referrer, idProviders, }: Session) => SessionTargeting;
-export type { SessionTargeting, AllParticipations };
-export { getSessionTargeting, experimentsTargeting };
+export type { SessionTargeting };
+export { getSessionTargeting, abTestingTargeting as experimentsTargeting };

package/dist/cjs/targeting/session.js

@@ -28,46 +28,30 @@ const getReferrer = (referrer) => {
     const matchedRef = referrers.find((referrerType) => referrer.includes(referrerType.match)) ?? null;
     return matchedRef ? matchedRef.id : null;
 };
-/**
- * @todo drop old client/server side participations and rename to just `abTestsParticipations` once
- * all tests have been migrated to the new AB testing platform
- */
-const experimentsTargeting = ({ clientSideParticipations, serverSideParticipations, betaAbTestParticipations, }) => {
+const abTestingTargeting = (abTestParticipations) => {
     const testToParams = (testName, variant) => {
         if (variant === 'notintest')
             return null;
         // GAM key-value pairs accept value strings up to 40 characters long
         return `${testName}-${variant}`.substring(0, 40);
     };
-    const clientSideExperiment = Object.entries(clientSideParticipations)
-        .map((test) => {
-        const [name, variant] = test;
-        return testToParams(name, variant.variant);
-    })
-        .filter(libs_1.isString);
-    const serverSideExperiments = Object.entries(serverSideParticipations)
-        .map((test) => testToParams(...test))
-        .filter(libs_1.isString);
-    const betaAbTests = Object.entries(betaAbTestParticipations)
+    const abTests = Object.entries(abTestParticipations)
         .map((test) => {
         const [name, variant] = test;
         return testToParams(name, variant);
     })
         .filter(libs_1.isString);
-    if (clientSideExperiment.length +
-        serverSideExperiments.length +
-        betaAbTests.length ===
-        0) {
+    if (abTests.length === 0) {
         return null;
     }
-    return [...clientSideExperiment, ...serverSideExperiments, ...betaAbTests];
+    return abTests;
 };
-exports.experimentsTargeting = experimentsTargeting;
+exports.experimentsTargeting = abTestingTargeting;
 const getIdProviders = (userIds) => {
     return userIds.map((id) => id.name);
 };
 const getSessionTargeting = ({ adTest, countryCode, localHour, isSignedIn, pageViewId, participations, referrer, idProviders, }) => ({
-    ab: experimentsTargeting(participations),
+    ab: abTestingTargeting(participations),
     at: adTest,
     cc: countryCode,
     lh: localHour,

package/dist/cjs/targeting/youtube-ima.d.ts

@@ -1,12 +1,11 @@
-import type { Participations } from '@guardian/ab-core';
 import type { ConsentState } from '@guardian/libs';
 import type { CustomParams } from './types.js';
 type BuildImaAdTagUrl = {
     adUnit: string;
     customParams: CustomParams;
     consentState: ConsentState;
-    clientSideParticipations: Participations;
+    abTestParticipations: Record<string, string>;
     isSignedIn: boolean;
 };
-declare const buildImaAdTagUrl: ({ adUnit, clientSideParticipations, consentState, customParams, isSignedIn, }: BuildImaAdTagUrl) => string;
+declare const buildImaAdTagUrl: ({ adUnit, abTestParticipations, consentState, customParams, isSignedIn, }: BuildImaAdTagUrl) => string;
 export { buildImaAdTagUrl };

package/dist/cjs/targeting/youtube-ima.js

@@ -18,12 +18,12 @@ const encodeCustomParams = (params) => {
         .join('&');
     return encodedParams;
 };
-const mergeCustomParamsWithTargeting = (customParams, consentState, clientSideParticipations, isSignedIn) => {
+const mergeCustomParamsWithTargeting = (customParams, consentState, abTestParticipations, isSignedIn) => {
     let pageTargeting = {};
     try {
         pageTargeting = (0, build_page_targeting_1.buildPageTargeting)({
             adFree: false,
-            clientSideParticipations,
+            abTestParticipations,
             consentState: consentState,
             isSignedIn: isSignedIn,
         });
@@ -43,8 +43,8 @@ const mergeCustomParamsWithTargeting = (customParams, consentState, clientSidePa
     };
     return mergedCustomParams;
 };
-const buildImaAdTagUrl = ({ adUnit, clientSideParticipations, consentState, customParams, isSignedIn, }) => {
-    const mergedCustomParams = mergeCustomParamsWithTargeting(customParams, consentState, clientSideParticipations, isSignedIn);
+const buildImaAdTagUrl = ({ adUnit, abTestParticipations, consentState, customParams, isSignedIn, }) => {
+    const mergedCustomParams = mergeCustomParamsWithTargeting(customParams, consentState, abTestParticipations, isSignedIn);
     const queryParams = {
         iu: adUnit,
         tfcd: '0',

package/dist/cjs/types.d.ts

@@ -1,41 +1,6 @@
 import type { EventPayload } from '@guardian/ophan-tracker-js';
-import type { AdSize, SizeMapping } from './ad-sizes.js';
+import type { EventTimer } from './event-timer.js';
 import type { PageTargeting } from './targeting/build-page-targeting.js';
-import '@types/google-publisher-tag';
-type HeaderBiddingSize = AdSize;
-interface Advert {
-    id: string;
-    node: HTMLElement;
-    sizes: SizeMapping;
-    headerBiddingSizes: HeaderBiddingSize[] | null;
-    size: AdSize | 'fluid' | null;
-    slot: googletag.Slot;
-    gpid: string | undefined;
-    isEmpty: boolean | null;
-    isRendered: boolean;
-    shouldRefresh: boolean;
-    whenSlotReady: Promise<void>;
-    extraNodeClasses: string[];
-    hasPrebidSize: boolean;
-    headerBiddingBidRequest: Promise<unknown> | null;
-    lineItemId: number | null;
-    creativeId: number | null;
-    creativeTemplateId: number | null;
-    testgroup: string | undefined;
-    finishedRendering(isRendered: boolean): void;
-    updateExtraSlotClasses(...newClasses: string[]): Promise<void>;
-    generateSizeMapping(additionalSizeMapping: SizeMapping): SizeMapping;
-    updateSizeMapping(additionalSizeMapping: SizeMapping): void;
-}
-interface DfpEnv {
-    renderStartTime: number;
-    adSlotSelector: string;
-    lazyLoadEnabled: boolean;
-    lazyLoadObserve: boolean;
-    advertsToLoad: Advert[];
-    adverts: Map<Advert['id'], Advert>;
-    shouldLazyLoad: () => boolean;
-}
 type ConnectionType = 'bluetooth' | 'cellular' | 'ethernet' | 'mixed' | 'none' | 'other' | 'unknown' | 'wifi';
 interface NetworkInformation extends EventTarget {
     readonly type?: ConnectionType;
@@ -430,4 +395,19 @@ type AdmiralEvent = Record<string, unknown>;
 type AdmiralCallback = (event: AdmiralEvent) => void;
 type AdmiralArg = string | AdmiralCallback;
 type Admiral = (...args: AdmiralArg[]) => void;
-export type { Advert, DfpEnv, ConnectionType, NetworkInformation, OphanRecordFunction, Indices, Edition, AdsConfigDisabled, AdsConfigEnabled, AdsConfigBasic, AdsConfigUSNATorAus, AdsConfigTCFV2, AdsConfig, AdTargetingBuilder, Ophan, Config, AdBlockers, ArticleCounts, FetchBidResponse, HeaderNotification, OptOutInitializeOptions, OptOutAdSlot, Confiant, Permutive, Apstag, ComscoreGlobals, IasPET, TeadsAnalytics, SafeFrameAPI, NSdkInstance, Trac, GoogleTagParams, GoogleTrackConversionObject, Admiral, AdmiralEvent, };
+interface CoreGuardian {
+    config: Config;
+    commercialTimer?: EventTimer;
+    offlineCount?: number;
+    modules: {
+        sentry?: {
+            reportError?: (error: Error, feature: string, tags?: Record<string, string>, extras?: Record<string, unknown>) => void;
+        };
+        abTests?: {
+            getParticipations: () => Record<string, string>;
+            isUserInTest: (testId: string) => boolean;
+            isUserInTestGroup: (testId: string, variantId: string) => boolean;
+        };
+    };
+}
+export type { ConnectionType, NetworkInformation, OphanRecordFunction, Indices, Edition, AdsConfigDisabled, AdsConfigEnabled, AdsConfigBasic, AdsConfigUSNATorAus, AdsConfigTCFV2, AdsConfig, AdTargetingBuilder, Ophan, Config, AdBlockers, ArticleCounts, FetchBidResponse, HeaderNotification, OptOutInitializeOptions, OptOutAdSlot, Confiant, Permutive, Apstag, ComscoreGlobals, IasPET, TeadsAnalytics, SafeFrameAPI, NSdkInstance, Trac, GoogleTagParams, GoogleTrackConversionObject, Admiral, AdmiralEvent, CoreGuardian, };

package/dist/cjs/types.js

@@ -1,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-require("@types/google-publisher-tag");
 var BlockingType;
 (function (BlockingType) {
     BlockingType[BlockingType["Manual"] = 1] = "Manual";

package/dist/esm/email-hash.d.ts

@@ -1,4 +1,4 @@
-type HashClient = 'id5' | 'uid2' | 'euid';
+type HashClient = 'euid' | 'id5' | 'liveramp' | 'uid2' | 'permutive';
 type Email = `${string}@${string}`;
 declare function normaliseEmail(email: string): Email;
 declare function hashEmailForClient(email: string, client: HashClient): Promise<string>;

package/dist/esm/email-hash.js

@@ -1,15 +1,15 @@
-function toHex(hashBuffer) {
-    const hashArray = Array.from(new Uint8Array(hashBuffer));
+function toBase64(content) {
+    const hashBytes = new Uint8Array(content);
+    const base64Hash = btoa(String.fromCharCode(...hashBytes));
+    return base64Hash;
+}
+function toHex(content) {
+    const hashArray = Array.from(new Uint8Array(content));
     const hashHex = hashArray
         .map((bytes) => bytes.toString(16).padStart(2, '0'))
         .join('');
     return hashHex;
 }
-function toBase64(hashBuffer) {
-    const hashBytes = new Uint8Array(hashBuffer);
-    const base64Hash = btoa(String.fromCharCode(...hashBytes));
-    return base64Hash;
-}
 function normaliseEmail(email) {
     const normalisedEmail = email.trim().toLowerCase();
     const [name, domain] = normalisedEmail.split('@');
@@ -21,14 +21,16 @@ function normaliseEmail(email) {
 }
 async function hashEmailForClient(email, client) {
     const normalisedEmail = normaliseEmail(email);
-    const utf8 = new TextEncoder().encode(normalisedEmail);
-    const hashBuffer = await crypto.subtle.digest('SHA-256', utf8);
+    const textAsBuffer = new TextEncoder().encode(normalisedEmail);
+    const hashBuffer = await crypto.subtle.digest('SHA-256', textAsBuffer);
     switch (client) {
-        case 'id5':
-            return toHex(hashBuffer);
-        case 'uid2':
         case 'euid':
+        case 'uid2':
             return toBase64(hashBuffer);
+        case 'id5':
+        case 'liveramp':
+        case 'permutive':
+            return toHex(hashBuffer);
     }
 }
 export { hashEmailForClient, normaliseEmail };

package/dist/esm/event-timer.d.ts

@@ -1,4 +1,9 @@
-import type { ConnectionType } from './types.js';
+import type { ConnectionType, NetworkInformation } from './types.js';
+declare global {
+    interface Navigator {
+        readonly connection?: NetworkInformation;
+    }
+}
 declare const supportsPerformanceAPI: () => boolean;
 interface EventTimerProperties {
     type?: ConnectionType;

package/dist/esm/global-ad-events.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `globalAdEvents` acts as an event bus that broadcasts ad lifecycle
+ * events, allowing consumers to react to ad status changes without
+ * needing direct access to `Advert` instances.
+ * @see /docs/global-ad-events.md
+ */
+declare const globalAdEvents: EventTarget;
+export { globalAdEvents };

package/dist/esm/global-ad-events.js

@@ -0,0 +1,8 @@
+/**
+ * `globalAdEvents` acts as an event bus that broadcasts ad lifecycle
+ * events, allowing consumers to react to ad status changes without
+ * needing direct access to `Advert` instances.
+ * @see /docs/global-ad-events.md
+ */
+const globalAdEvents = new EventTarget();
+export { globalAdEvents };

package/dist/esm/global.d.ts

@@ -1,77 +1,13 @@
-import type { EventTimer } from './event-timer.js';
-import type { AdBlockers, Admiral, Apstag, ArticleCounts, ComscoreGlobals, Confiant, Config, DfpEnv, FetchBidResponse, GoogleTagParams, GoogleTrackConversionObject, HeaderNotification, IasPET, NetworkInformation, NSdkInstance, Ophan, OptOutAdSlot, OptOutInitializeOptions, Permutive, SafeFrameAPI, TeadsAnalytics, Trac } from './types.js';
+import type { CoreGuardian } from './types.js';
 declare global {
-    interface Navigator {
-        readonly connection?: NetworkInformation;
-        readonly cookieDeprecationLabel?: {
-            getValue: () => Promise<string>;
-        };
-    }
     interface Window {
-        guardian: {
-            ophan?: Ophan;
-            config: Config;
-            queue: Array<() => Promise<void>>;
-            mustardCut?: boolean;
-            polyfilled?: boolean;
-            adBlockers: AdBlockers;
-            css: {
-                onLoad: () => void;
-                loaded: boolean;
-            };
-            articleCounts?: ArticleCounts;
-            commercial?: {
-                dfpEnv?: DfpEnv;
-                a9WinningBids?: FetchBidResponse[];
-            };
-            notificationEventHistory?: HeaderNotification[][];
-            commercialTimer?: EventTimer;
-            offlineCount?: number;
-            modules: {
-                sentry?: {
-                    reportError?: (error: Error, feature: string, tags?: Record<string, string>, extras?: Record<string, unknown>) => void;
-                };
-                abTests?: {
-                    getParticipations: () => Record<string, string>;
-                    isUserInTest: (testId: string) => boolean;
-                    isUserInTestGroup: (testId: string, variantId: string) => boolean;
-                };
-            };
-        };
-        ootag: {
-            queue: Array<() => void>;
-            initializeOo: (o: OptOutInitializeOptions) => void;
-            addParameter: (key: string, value: string | string[]) => void;
-            addParameterForSlot: (slotId: string, key: string, value: string | string[]) => void;
-            defineSlot: (o: OptOutAdSlot) => void;
-            makeRequests: () => void;
-            refreshSlot: (slotId: string) => void;
-            refreshAllSlots: () => void;
-            logger: (...args: unknown[]) => void;
-        };
-        readonly navigator: Navigator;
-        confiant?: Confiant;
-        apstag?: Apstag;
-        permutive?: Permutive;
-        _comscore?: ComscoreGlobals[];
-        __iasPET?: IasPET;
-        teads_analytics?: TeadsAnalytics;
-        $sf: SafeFrameAPI;
-        conf: unknown;
-        NOLCMB: {
-            getInstance: (apid: string) => NSdkInstance;
+        guardian: CoreGuardian;
+        googletag: {
+            getConfig?: <Key extends string>(key: Key) => Key extends 'targeting' ? {
+                targeting: Record<string, string | string[]>;
+            } : unknown;
+            pubads: () => unknown;
         };
-        nol_t: (pvar: {
-            cid: string;
-            content: string;
-            server: string;
-        }) => Trac;
-        google_trackConversion?: (arg0: GoogleTrackConversionObject) => void;
-        google_tag_params?: GoogleTagParams;
-        _brandmetrics?: Array<{
-            cmd: string;
-            val: Record<string, unknown>;
-        }>;
-        admiral?: Admiral;
     }
 }
+export type { CoreGuardian };

package/dist/esm/index.d.ts

@@ -9,6 +9,7 @@ export { buildImaAdTagUrl } from './targeting/youtube-ima.js';
 export { getPermutivePFPSegments } from './permutive.js';
 export { isEligibleForTeads } from './targeting/teads-eligibility.js';
 export { hashEmailForClient } from './email-hash.js';
+export { globalAdEvents } from './global-ad-events.js';
 export type { AdSize, SizeMapping, SlotName } from './ad-sizes.js';
 export type { PageTargeting } from './targeting/build-page-targeting.js';
 export type { AdsConfigDisabled, AdsConfigUSNATorAus, AdsConfigTCFV2, } from './types.js';

package/dist/esm/index.js

@@ -9,3 +9,4 @@ export { buildImaAdTagUrl } from './targeting/youtube-ima.js';
 export { getPermutivePFPSegments } from './permutive.js';
 export { isEligibleForTeads } from './targeting/teads-eligibility.js';
 export { hashEmailForClient } from './email-hash.js';
+export { globalAdEvents } from './global-ad-events.js';

package/dist/esm/targeting/build-page-targeting.d.ts

@@ -1,4 +1,3 @@
-import type { Participations } from '@guardian/ab-core';
 import type { ConsentState, CountryCode } from '@guardian/libs';
 import type { AdManagerGroup, Frequency } from './personalised.js';
 import type { SharedTargeting } from './shared.js';
@@ -40,7 +39,7 @@ type PageTargeting = PartialWithNulls<{
 declare const filterValues: (pageTargets: Record<string, unknown>) => Record<string, string | string[]>;
 type UserId = {
     name: string;
-    params?: Record<string, string | number>;
+    params?: Record<string, string | number | boolean | Record<string, unknown>>;
     storage?: {
         type: 'cookie' | 'html5';
         name: string;
@@ -50,12 +49,12 @@ type UserId = {
 };
 type BuildPageTargetingParams = {
     adFree: boolean;
-    clientSideParticipations: Participations;
+    abTestParticipations: Record<string, string>;
     consentState: ConsentState;
     isSignedIn?: boolean;
     youtube?: boolean;
     idProviders?: UserId[];
 };
-declare const buildPageTargeting: ({ adFree, clientSideParticipations, consentState, isSignedIn, youtube, idProviders, }: BuildPageTargetingParams) => Record<string, string | string[]>;
+declare const buildPageTargeting: ({ adFree, abTestParticipations, consentState, isSignedIn, youtube, idProviders, }: BuildPageTargetingParams) => Record<string, string | string[]>;
 export { buildPageTargeting, filterValues, getLocalHour };
 export type { UserId, PageTargeting };

package/dist/esm/targeting/build-page-targeting.js

@@ -44,7 +44,7 @@ const isFirstVisit = (referrer) => {
     }
     return !referrerMatchesHost(referrer);
 };
-const buildPageTargeting = ({ adFree, clientSideParticipations, consentState, isSignedIn = false, youtube = false, idProviders = [], }) => {
+const buildPageTargeting = ({ adFree, abTestParticipations, consentState, isSignedIn = false, youtube = false, idProviders = [], }) => {
     const { page, isDotcomRendering } = window.guardian.config;
     const adFreeTargeting = adFree ? { af: 't' } : {};
     const sharedAdTargeting = page.sharedAdTargeting
@@ -69,11 +69,7 @@ const buildPageTargeting = ({ adFree, clientSideParticipations, consentState, is
         localHour: getLocalHour(),
         isSignedIn,
         pageViewId: window.guardian.config.ophan.pageViewId,
-        participations: {
-            clientSideParticipations,
-            serverSideParticipations: window.guardian.config.tests ?? {},
-            betaAbTestParticipations: window.guardian.modules.abTests?.getParticipations() ?? {},
-        },
+        participations: abTestParticipations,
         referrer,
         idProviders,
     });

package/dist/esm/targeting/session.d.ts

@@ -1,4 +1,3 @@
-import type { Participations } from '@guardian/ab-core';
 import type { CountryCode } from '@guardian/libs';
 import type { UserId } from '../targeting/build-page-targeting.js';
 import type { False, True } from './types.js';
@@ -107,29 +106,17 @@ type SessionTargeting = {
      */
     idp: string[] | null;
 };
-type AllParticipations = {
-    clientSideParticipations: Participations;
-    serverSideParticipations: {
-        [key: `${string}Control`]: 'control';
-        [key: `${string}Variant`]: 'variant';
-    };
-    betaAbTestParticipations: Record<string, string>;
-};
-/**
- * @todo drop old client/server side participations and rename to just `abTestsParticipations` once
- * all tests have been migrated to the new AB testing platform
- */
-declare const experimentsTargeting: ({ clientSideParticipations, serverSideParticipations, betaAbTestParticipations, }: AllParticipations) => SessionTargeting["ab"];
+declare const abTestingTargeting: (abTestParticipations: Record<string, string>) => SessionTargeting["ab"];
 type Session = {
     adTest: SessionTargeting['at'];
     countryCode: CountryCode;
     localHour: string;
     isSignedIn: boolean;
     pageViewId: SessionTargeting['pv'];
-    participations: AllParticipations;
+    participations: Record<string, string>;
     referrer: string;
     idProviders: UserId[];
 };
 declare const getSessionTargeting: ({ adTest, countryCode, localHour, isSignedIn, pageViewId, participations, referrer, idProviders, }: Session) => SessionTargeting;
-export type { SessionTargeting, AllParticipations };
-export { getSessionTargeting, experimentsTargeting };
+export type { SessionTargeting };
+export { getSessionTargeting, abTestingTargeting as experimentsTargeting };

package/dist/esm/targeting/session.js

@@ -25,45 +25,29 @@ const getReferrer = (referrer) => {
     const matchedRef = referrers.find((referrerType) => referrer.includes(referrerType.match)) ?? null;
     return matchedRef ? matchedRef.id : null;
 };
-/**
- * @todo drop old client/server side participations and rename to just `abTestsParticipations` once
- * all tests have been migrated to the new AB testing platform
- */
-const experimentsTargeting = ({ clientSideParticipations, serverSideParticipations, betaAbTestParticipations, }) => {
+const abTestingTargeting = (abTestParticipations) => {
     const testToParams = (testName, variant) => {
         if (variant === 'notintest')
             return null;
         // GAM key-value pairs accept value strings up to 40 characters long
         return `${testName}-${variant}`.substring(0, 40);
     };
-    const clientSideExperiment = Object.entries(clientSideParticipations)
-        .map((test) => {
-        const [name, variant] = test;
-        return testToParams(name, variant.variant);
-    })
-        .filter(isString);
-    const serverSideExperiments = Object.entries(serverSideParticipations)
-        .map((test) => testToParams(...test))
-        .filter(isString);
-    const betaAbTests = Object.entries(betaAbTestParticipations)
+    const abTests = Object.entries(abTestParticipations)
         .map((test) => {
         const [name, variant] = test;
         return testToParams(name, variant);
     })
         .filter(isString);
-    if (clientSideExperiment.length +
-        serverSideExperiments.length +
-        betaAbTests.length ===
-        0) {
+    if (abTests.length === 0) {
         return null;
     }
-    return [...clientSideExperiment, ...serverSideExperiments, ...betaAbTests];
+    return abTests;
 };
 const getIdProviders = (userIds) => {
     return userIds.map((id) => id.name);
 };
 const getSessionTargeting = ({ adTest, countryCode, localHour, isSignedIn, pageViewId, participations, referrer, idProviders, }) => ({
-    ab: experimentsTargeting(participations),
+    ab: abTestingTargeting(participations),
     at: adTest,
     cc: countryCode,
     lh: localHour,
@@ -72,4 +56,4 @@ const getSessionTargeting = ({ adTest, countryCode, localHour, isSignedIn, pageV
     si: isSignedIn ? 't' : 'f',
     idp: getIdProviders(idProviders),
 });
-export { getSessionTargeting, experimentsTargeting };
+export { getSessionTargeting, abTestingTargeting as experimentsTargeting };

package/dist/esm/targeting/youtube-ima.d.ts

@@ -1,12 +1,11 @@
-import type { Participations } from '@guardian/ab-core';
 import type { ConsentState } from '@guardian/libs';
 import type { CustomParams } from './types.js';
 type BuildImaAdTagUrl = {
     adUnit: string;
     customParams: CustomParams;
     consentState: ConsentState;
-    clientSideParticipations: Participations;
+    abTestParticipations: Record<string, string>;
     isSignedIn: boolean;
 };
-declare const buildImaAdTagUrl: ({ adUnit, clientSideParticipations, consentState, customParams, isSignedIn, }: BuildImaAdTagUrl) => string;
+declare const buildImaAdTagUrl: ({ adUnit, abTestParticipations, consentState, customParams, isSignedIn, }: BuildImaAdTagUrl) => string;
 export { buildImaAdTagUrl };

package/dist/esm/targeting/youtube-ima.js

@@ -15,12 +15,12 @@ const encodeCustomParams = (params) => {
         .join('&');
     return encodedParams;
 };
-const mergeCustomParamsWithTargeting = (customParams, consentState, clientSideParticipations, isSignedIn) => {
+const mergeCustomParamsWithTargeting = (customParams, consentState, abTestParticipations, isSignedIn) => {
     let pageTargeting = {};
     try {
         pageTargeting = buildPageTargeting({
             adFree: false,
-            clientSideParticipations,
+            abTestParticipations,
             consentState: consentState,
             isSignedIn: isSignedIn,
         });
@@ -40,8 +40,8 @@ const mergeCustomParamsWithTargeting = (customParams, consentState, clientSidePa
     };
     return mergedCustomParams;
 };
-const buildImaAdTagUrl = ({ adUnit, clientSideParticipations, consentState, customParams, isSignedIn, }) => {
-    const mergedCustomParams = mergeCustomParamsWithTargeting(customParams, consentState, clientSideParticipations, isSignedIn);
+const buildImaAdTagUrl = ({ adUnit, abTestParticipations, consentState, customParams, isSignedIn, }) => {
+    const mergedCustomParams = mergeCustomParamsWithTargeting(customParams, consentState, abTestParticipations, isSignedIn);
     const queryParams = {
         iu: adUnit,
         tfcd: '0',

package/dist/esm/types.d.ts

@@ -1,41 +1,6 @@
 import type { EventPayload } from '@guardian/ophan-tracker-js';
-import type { AdSize, SizeMapping } from './ad-sizes.js';
+import type { EventTimer } from './event-timer.js';
 import type { PageTargeting } from './targeting/build-page-targeting.js';
-import '@types/google-publisher-tag';
-type HeaderBiddingSize = AdSize;
-interface Advert {
-    id: string;
-    node: HTMLElement;
-    sizes: SizeMapping;
-    headerBiddingSizes: HeaderBiddingSize[] | null;
-    size: AdSize | 'fluid' | null;
-    slot: googletag.Slot;
-    gpid: string | undefined;
-    isEmpty: boolean | null;
-    isRendered: boolean;
-    shouldRefresh: boolean;
-    whenSlotReady: Promise<void>;
-    extraNodeClasses: string[];
-    hasPrebidSize: boolean;
-    headerBiddingBidRequest: Promise<unknown> | null;
-    lineItemId: number | null;
-    creativeId: number | null;
-    creativeTemplateId: number | null;
-    testgroup: string | undefined;
-    finishedRendering(isRendered: boolean): void;
-    updateExtraSlotClasses(...newClasses: string[]): Promise<void>;
-    generateSizeMapping(additionalSizeMapping: SizeMapping): SizeMapping;
-    updateSizeMapping(additionalSizeMapping: SizeMapping): void;
-}
-interface DfpEnv {
-    renderStartTime: number;
-    adSlotSelector: string;
-    lazyLoadEnabled: boolean;
-    lazyLoadObserve: boolean;
-    advertsToLoad: Advert[];
-    adverts: Map<Advert['id'], Advert>;
-    shouldLazyLoad: () => boolean;
-}
 type ConnectionType = 'bluetooth' | 'cellular' | 'ethernet' | 'mixed' | 'none' | 'other' | 'unknown' | 'wifi';
 interface NetworkInformation extends EventTarget {
     readonly type?: ConnectionType;
@@ -430,4 +395,19 @@ type AdmiralEvent = Record<string, unknown>;
 type AdmiralCallback = (event: AdmiralEvent) => void;
 type AdmiralArg = string | AdmiralCallback;
 type Admiral = (...args: AdmiralArg[]) => void;
-export type { Advert, DfpEnv, ConnectionType, NetworkInformation, OphanRecordFunction, Indices, Edition, AdsConfigDisabled, AdsConfigEnabled, AdsConfigBasic, AdsConfigUSNATorAus, AdsConfigTCFV2, AdsConfig, AdTargetingBuilder, Ophan, Config, AdBlockers, ArticleCounts, FetchBidResponse, HeaderNotification, OptOutInitializeOptions, OptOutAdSlot, Confiant, Permutive, Apstag, ComscoreGlobals, IasPET, TeadsAnalytics, SafeFrameAPI, NSdkInstance, Trac, GoogleTagParams, GoogleTrackConversionObject, Admiral, AdmiralEvent, };
+interface CoreGuardian {
+    config: Config;
+    commercialTimer?: EventTimer;
+    offlineCount?: number;
+    modules: {
+        sentry?: {
+            reportError?: (error: Error, feature: string, tags?: Record<string, string>, extras?: Record<string, unknown>) => void;
+        };
+        abTests?: {
+            getParticipations: () => Record<string, string>;
+            isUserInTest: (testId: string) => boolean;
+            isUserInTestGroup: (testId: string, variantId: string) => boolean;
+        };
+    };
+}
+export type { ConnectionType, NetworkInformation, OphanRecordFunction, Indices, Edition, AdsConfigDisabled, AdsConfigEnabled, AdsConfigBasic, AdsConfigUSNATorAus, AdsConfigTCFV2, AdsConfig, AdTargetingBuilder, Ophan, Config, AdBlockers, ArticleCounts, FetchBidResponse, HeaderNotification, OptOutInitializeOptions, OptOutAdSlot, Confiant, Permutive, Apstag, ComscoreGlobals, IasPET, TeadsAnalytics, SafeFrameAPI, NSdkInstance, Trac, GoogleTagParams, GoogleTrackConversionObject, Admiral, AdmiralEvent, CoreGuardian, };

package/dist/esm/types.js

@@ -1,4 +1,3 @@
-import '@types/google-publisher-tag';
 var BlockingType;
 (function (BlockingType) {
     BlockingType[BlockingType["Manual"] = 1] = "Manual";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guardian/commercial-core",
-  "version": "30.2.0",
+  "version": "32.0.0",
   "description": "Guardian advertising business logic",
   "homepage": "https://github.com/guardian/commercial#readme",
   "bugs": {
@@ -32,24 +32,21 @@
     "./package.json": "./package.json"
   },
   "peerDependencies": {
-    "@guardian/ab-core": "^9.0.0",
-    "@guardian/libs": "^27.0.0"
+    "@guardian/libs": "^30.1.0"
   },
   "dependencies": {
-    "@guardian/ab-core": "9.0.0",
-    "@guardian/libs": "27.0.0",
-    "@types/google-publisher-tag": "~1.20251117.0"
+    "@guardian/libs": "30.1.0"
   },
   "devDependencies": {
-    "@guardian/ophan-tracker-js": "2.6.3",
+    "@guardian/ophan-tracker-js": "2.8.0",
     "@types/jest": "30.0.0",
-    "@types/node": "24.10.1",
-    "jest": "^30.2.0",
-    "jest-environment-jsdom": "^30.2.0",
+    "@types/node": "25.4.0",
+    "jest": "^30.3.0",
+    "jest-environment-jsdom": "^30.3.0",
     "jest-environment-jsdom-global": "~4.0.0",
     "ts-jest": "^29.4.6",
     "tsc-alias": "1.8.16",
-    "type-fest": "^4.41.0",
+    "type-fest": "^5.4.3",
     "typescript": "5.9.3"
   },
   "publishConfig": {