@guardian/ophan-tracker-js 4.0.2 → 5.1.0

package/NPM-dist/transmit.js

@@ -1,4 +1,15 @@
-const ophanRemoteHost = window?.ophanRemoteHost || 'https://ophan.theguardian.com';
+const canSendFromCurrentRuntime = () => typeof window !== 'undefined' && typeof document !== 'undefined';
+// Initialize ophanRemoteHost when needed, not at module load
+let ophanRemoteHost;
+const getOphanRemoteHost = () => {
+    if (!ophanRemoteHost) {
+        ophanRemoteHost =
+            typeof window !== 'undefined' && window?.ophanRemoteHost
+                ? window.ophanRemoteHost
+                : 'https://ophan.theguardian.com';
+    }
+    return ophanRemoteHost;
+};
 /**
  * Generates a unique page view ID.
  * @returns {string}
@@ -17,7 +28,7 @@ else {
 const bumpViewId = () => {
     const viewIdGen = generatePageViewId();
     viewId = viewIdGen;
-    if (typeof guardian !== 'undefined') {
+    if (typeof guardian !== 'undefined' && guardian.config?.ophan) {
         guardian.config.ophan.pageViewId = viewIdGen;
     }
 };
@@ -26,7 +37,7 @@ const bumpViewId = () => {
  * @param {Record<string, any>} obj - The data to be sent.
  */
 const sendInitial = (obj) => {
-    send(`${ophanRemoteHost}/img/1?${buildQueryString(obj)}`);
+    send(`${getOphanRemoteHost()}/img/1?${buildQueryString(obj)}`);
 };
 /**
  * Encodes a value for URL transmission.
@@ -60,7 +71,7 @@ const sendMore = (obj, f) => {
     if (values.length === 0) {
         return;
     }
-    const url = `${ophanRemoteHost}/img/2?viewId=${viewId}&${values.join('&')}`;
+    const url = `${getOphanRemoteHost()}/img/2?viewId=${viewId}&${values.join('&')}`;
     send(url, f);
 };
 /**
@@ -97,6 +108,10 @@ const buildQueryString = (obj) => {
  * @param {() => void} [f] - An optional callback function.
  */
 const send = (url, f) => {
+    if (!canSendFromCurrentRuntime()) {
+        f?.();
+        return;
+    }
     if (typeof fetch === 'function') {
         fetch(url, {
             method: 'GET',
@@ -121,7 +136,9 @@ const send = (url, f) => {
 export default {
     sendInitial,
     sendMore,
-    get viewId() { return viewId; },
+    get viewId() {
+        return viewId;
+    },
     bumpViewId,
 };
 /**
@@ -133,3 +150,4 @@ export const _testExports = {
     isDefined,
     buildQueryString,
 };
+//# sourceMappingURL=transmit.js.map

package/NPM-dist/transmit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transmit.js","sourceRoot":"","sources":["../src/transmit.ts"],"names":[],"mappings":"AAEA,MAAM,yBAAyB,GAAG,GAAY,EAAE,CAC/C,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,QAAQ,KAAK,WAAW,CAAC;AAElE,6DAA6D;AAC7D,IAAI,eAAuB,CAAC;AAC5B,MAAM,kBAAkB,GAAG,GAAW,EAAE;IACvC,IAAI,CAAC,eAAe,EAAE,CAAC;QACtB,eAAe;YACd,OAAO,MAAM,KAAK,WAAW,IAAK,MAAc,EAAE,eAAe;gBAChE,CAAC,CAAE,MAAc,CAAC,eAAe;gBACjC,CAAC,CAAC,+BAA+B,CAAC;IACrC,CAAC;IACD,OAAO,eAAe,CAAC;AACxB,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,kBAAkB,GAAG,GAAW,EAAE;IACvC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,OAAO,CACnE,IAAI,EACJ,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CACjD,EAAE,CAAC;AACL,CAAC,CAAC;AAIF,yDAAyD;AACzD,IAAI,MAAc,CAAC;AACnB,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;IACrC,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,IAAI,kBAAkB,EAAE,CAAC;AACrE,CAAC;KAAM,CAAC;IACP,MAAM,GAAG,kBAAkB,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,GAAG,GAAS,EAAE;IAC7B,MAAM,SAAS,GAAG,kBAAkB,EAAE,CAAC;IACvC,MAAM,GAAG,SAAS,CAAC;IAEnB,IAAI,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;QAC/D,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9C,CAAC;AACF,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,GAAG,CAAC,GAAwB,EAAQ,EAAE;IACtD,IAAI,CAAC,GAAG,kBAAkB,EAAE,UAAU,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAChE,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,GAAG,CAAC,KAAsB,EAAU,EAAE;IACtD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5D,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACP,OAAO,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,CAAC;AACF,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,QAAQ,GAAG,CAAC,GAAiB,EAAE,CAAc,EAAQ,EAAE;IAC5D,IAAI,CAAC,IAAI;QAAE,OAAO;IAElB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;QACxB,aAAa;QACb,IAAI,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACtD,aAAa;YACb,MAAM,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC;IACF,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;IACR,CAAC;IAED,MAAM,GAAG,GAAG,GAAG,kBAAkB,EAAE,iBAAiB,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACjF,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACd,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,SAAS,GAAG,CAAC,CAAM,EAAW,EAAE;IACrC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACnB,CAAC;SAAM,CAAC;QACP,OAAO,CAAC,IAAI,IAAI,CAAC;IAClB,CAAC;AACF,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,gBAAgB,GAAG,CAAC,GAAwB,EAAU,EAAE;IAC7D,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;IAEpB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;QACxB,IAAI,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;YACnD,MAAM,CAAC,IAAI,CACV,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAC9D,CAAC;QACH,CAAC;IACF,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,CAAc,EAAQ,EAAE;IAClD,IAAI,CAAC,yBAAyB,EAAE,EAAE,CAAC;QAClC,CAAC,EAAE,EAAE,CAAC;QACN,OAAO;IACR,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QACjC,KAAK,CAAC,GAAG,EAAE;YACV,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,IAAI;YACf,WAAW,EAAE,SAAS;SACtB,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtB,CAAC;SAAM,CAAC;QACP,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;YAChC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACpB,IAAI,OAAO,CAAC,KAAK,UAAU,EAAE,CAAC;oBAC7B,CAAC,EAAE,CAAC;gBACL,CAAC;gBACD,aAAa,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC;QACF,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;AACF,CAAC,CAAC;AAEF,eAAe;IACd,WAAW;IACX,QAAQ;IACR,IAAI,MAAM;QACT,OAAO,MAAM,CAAC;IACf,CAAC;IACD,UAAU;CACV,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC3B,kBAAkB;IAClB,WAAW;IACX,SAAS;IACT,gBAAgB;CAChB,CAAC"}

package/NPM-dist/types/abtest.js

@@ -1 +1,2 @@
 export {};
+//# sourceMappingURL=abtest.js.map

package/NPM-dist/types/abtest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abtest.js","sourceRoot":"","sources":["../../src/types/abtest.ts"],"names":[],"mappings":""}

package/NPM-dist/types/adblock-detection.d.ts

@@ -2,3 +2,4 @@ declare namespace _default {
     function run(): Promise<any>;
 }
 export default _default;
+//# sourceMappingURL=adblock-detection.d.ts.map

package/NPM-dist/types/adblock-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adblock-detection.d.ts","sourceRoot":"","sources":["../../src/adblock-detection.js"],"names":[],"mappings":";IAKC,6BAqBC"}

package/NPM-dist/types/attention.d.ts

@@ -7,3 +7,4 @@ export default _default;
 declare function initAttention(visibility: any): void;
 declare function initComponent(name: any, el: any, visibilityThreshold?: number, isTrackingVideo?: boolean): void;
 declare function setEventEmitter(emitter: any): void;
+//# sourceMappingURL=attention.d.ts.map

package/NPM-dist/types/attention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attention.d.ts","sourceRoot":"","sources":["../../src/attention.js"],"names":[],"mappings":";;;;;;AA2JA,sDAsCC;AArDD,kHAaC;AA0CD,qDAEC"}

package/NPM-dist/types/campaign.d.ts

@@ -1 +1,2 @@
 export {};
+//# sourceMappingURL=campaign.d.ts.map

package/NPM-dist/types/campaign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign.d.ts","sourceRoot":"","sources":["../../src/campaign.js"],"names":[],"mappings":""}

package/NPM-dist/types/click-path-capture.d.ts

@@ -14,3 +14,4 @@ export default _default;
  * @returns {string[]} Array of `data-link-name` values.
  */
 declare function getDataLinkNames(el: Element, dataLinkNames?: string[]): string[];
+//# sourceMappingURL=click-path-capture.d.ts.map

package/NPM-dist/types/click-path-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"click-path-capture.d.ts","sourceRoot":"","sources":["../../src/click-path-capture.js"],"names":[],"mappings":"AASO,+CAHI,OAAO,GACL,OAAO,GAAC,IAAI,CAOxB;AAQM,2CAHI,OAAO,GACL,MAAM,GAAC,IAAI,CAOvB;AAyBM,kDAFI,OAAO,QA0BjB;;;;;;AA/CD;;;;;;GAMG;AACH,sCAJW,OAAO,kBACP,MAAM,EAAE,GACN,MAAM,EAAE,CAUpB"}

package/NPM-dist/types/component-event.js

@@ -1 +1,2 @@
 export {};
+//# sourceMappingURL=component-event.js.map

package/NPM-dist/types/component-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-event.js","sourceRoot":"","sources":["../../src/types/component-event.ts"],"names":[],"mappings":""}

package/NPM-dist/types/component-type.js

@@ -1 +1,2 @@
 export {};
+//# sourceMappingURL=component-type.js.map

package/NPM-dist/types/component-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-type.js","sourceRoot":"","sources":["../../src/types/component-type.ts"],"names":[],"mappings":""}

package/NPM-dist/types/components.d.ts

@@ -66,3 +66,4 @@ declare function stopVideoComponentMonitoring(): any[];
  * @returns {Object}
  */
 declare function getAttentionTimes(): Object;
+//# sourceMappingURL=components.d.ts.map

package/NPM-dist/types/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/components.js"],"names":[],"mappings":"AAAA;;GAEG;AACH,yBAFU,SAAS,EAAE,CAEQ;;;;;;kCAwLlB,CAAC,GAAG,IAAI,qIAAyC,KAAK,IAAI;;;AAlJrE;IACC;;;;;;;;;;;OAWG;IACH,kBAVW,MAAM,WACN,WAAW,uBACX,MAAM,qBAKN,MAAM,oBACN,OAAO,EAoBjB;IAjBA,aAAgB;IAChB,qBAAsB;IACtB,4BAA8C;IAC9C,0BAA0C;IAC1C,yBAAsC;IACtC,iBAAoB;IAEpB,yBAAyB;IAKzB,0CAAsC;IAEtC,iCAAiC;IAKlC,gDAWC;IAED,mBAIC;IAED,qBAGC;IAED,sDAaC;IAED,oCAGC;IAED,2BAIC;CACD;AAED;;;;;;GAMG;AACH,gEAIC;AAED;;;GAGG;AACH,yCAEC;AAED;;;;;;GAMG;AACH,uDAUC;AAED;;;GAGG;AACH,sCAFa,MAAM,CAWlB"}

package/NPM-dist/types/consent.js

@@ -1 +1,2 @@
 export {};
+//# sourceMappingURL=consent.js.map

package/NPM-dist/types/consent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent.js","sourceRoot":"","sources":["../../src/types/consent.ts"],"names":[],"mappings":""}

package/NPM-dist/types/contribution.d.ts

@@ -1,5 +1,6 @@
 declare namespace _default {
-    let record: (obj: import("./manage-my-account.js").EventPayload, f?: (() => void) | undefined) => void;
+    let record: (obj: import("./index.js").EventPayload, f?: (() => void) | undefined) => void;
     const viewId: string;
 }
 export default _default;
+//# sourceMappingURL=contribution.d.ts.map

package/NPM-dist/types/contribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution.d.ts","sourceRoot":"","sources":["../../src/contribution.js"],"names":[],"mappings":""}

package/NPM-dist/types/core.d.ts

@@ -62,3 +62,4 @@ declare function processCaptures(): void;
  * @param {Record<string, unknown>} localGuardian - The guardian object.
  */
 declare function appendContentType(event: Record<string, unknown>, localPlatform: string, localGuardian: Record<string, unknown>): void;
+//# sourceMappingURL=core.d.ts.map

package/NPM-dist/types/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/core.js"],"names":[],"mappings":";;;;IA8SkB,uCAEhB;;;;;;;;;;;;;;AAhTE,sBAAI;AAEP,4CAA0B;AAiK3B;;;;;;;GAOG;AACH,4CAHW,MAAM,OAAO,MAAM,EAAE,OAAO,CAAC,QAUvC;AAjLA,kCAAgB;AAkPjB;;;;GAIG;AACH,mDAFW,MAAM,QAgBhB;AAjCD;;;;;GAKG;AACH,mEAHW,MAAM,EAAE,GACN,MAAM,EAAE,CAQpB;AA5KD;;;;;;GAMG;AACH,mDAHW,MAAM,GACJ,MAAM,GAAG,SAAS,CAa9B;AA0ED,oCAA0B;AAmB1B;;;GAGG;AACH,yCAiBC;AAgFD;;;;;GAKG;AACH,0CAJW,OAAO,MAAM,EAAE,OAAO,CAAC,iBACvB,MAAM,iBACN,OAAO,MAAM,EAAE,OAAO,CAAC,QAWjC"}

package/NPM-dist/types/embed.d.ts

@@ -1,5 +1,6 @@
 declare namespace _default {
-    let record: (obj: import("./manage-my-account.js").EventPayload, f?: (() => void) | undefined) => void;
+    let record: (obj: import("./index.js").EventPayload, f?: (() => void) | undefined) => void;
     const viewId: string;
 }
 export default _default;
+//# sourceMappingURL=embed.d.ts.map

package/NPM-dist/types/embed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../../src/embed.js"],"names":[],"mappings":""}

package/NPM-dist/types/event.js

@@ -1 +1,2 @@
 export {};
+//# sourceMappingURL=event.js.map

package/NPM-dist/types/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/types/event.ts"],"names":[],"mappings":""}

package/NPM-dist/types/fb-instant.d.ts

@@ -2,3 +2,4 @@ declare namespace _default {
     const viewId: string;
 }
 export default _default;
+//# sourceMappingURL=fb-instant.d.ts.map

package/NPM-dist/types/fb-instant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fb-instant.d.ts","sourceRoot":"","sources":["../../src/fb-instant.js"],"names":[],"mappings":""}

package/NPM-dist/types/heatmap.d.ts

@@ -3,3 +3,4 @@ declare namespace _default {
 }
 export default _default;
 declare function init(): void | "//dashboard.ophan.co.uk/assets/js/react/heatphan/index.js" | "//dashboard.ophan.co.uk/assets/js/heatmap-bookmarklet.js";
+//# sourceMappingURL=heatmap.d.ts.map

package/NPM-dist/types/heatmap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heatmap.d.ts","sourceRoot":"","sources":["../../src/heatmap.js"],"names":[],"mappings":";;;;AAEA,yJAgDC"}

package/NPM-dist/types/help-centre.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=help-centre.d.ts.map

package/NPM-dist/types/help-centre.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-centre.d.ts","sourceRoot":"","sources":["../../src/help-centre.ts"],"names":[],"mappings":""}

package/NPM-dist/types/holidays.d.ts

@@ -1,5 +1,6 @@
 declare namespace _default {
-    let record: (obj: import("./manage-my-account.js").EventPayload, f?: (() => void) | undefined) => void;
+    let record: (obj: import("./index.js").EventPayload, f?: (() => void) | undefined) => void;
     const viewId: string;
 }
 export default _default;
+//# sourceMappingURL=holidays.d.ts.map

package/NPM-dist/types/holidays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"holidays.d.ts","sourceRoot":"","sources":["../../src/holidays.js"],"names":[],"mappings":""}

package/NPM-dist/types/http-status.d.ts

@@ -3,3 +3,4 @@ declare namespace _default {
 }
 export default _default;
 declare function reportStatus(platform: any, status: any): any;
+//# sourceMappingURL=http-status.d.ts.map

package/NPM-dist/types/http-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-status.d.ts","sourceRoot":"","sources":["../../src/http-status.js"],"names":[],"mappings":";;;;AAMA,+DAEC"}

package/NPM-dist/types/iframe-tracking.d.ts

@@ -1 +1,2 @@
 export {};
+//# sourceMappingURL=iframe-tracking.d.ts.map

package/NPM-dist/types/iframe-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iframe-tracking.d.ts","sourceRoot":"","sources":["../../src/iframe-tracking.js"],"names":[],"mappings":""}

package/NPM-dist/types/index.d.ts

@@ -0,0 +1,199 @@
+import './click-path-capture.js';
+import './perf.js';
+import './iframe-tracking.js';
+import './campaign.js';
+import { EventPayload } from './types/event.js';
+/**
+ * Product surface that is initialising the tracker.
+ *
+ * The platform controls the historical Ophan serving-platform value and any
+ * platform-specific browser integrations started by `init()`.
+ */
+export type Platform = 'ng' | 'manage-my-account' | 'support' | 'help-centre';
+/**
+ * Initialise the Ophan tracker for a specific platform.
+ *
+ * Call this once, eagerly, in a browser context before using the other tracker
+ * methods. Initialisation sends the first page-view event.
+ *
+ * @param platform - The platform identifier ('ng' for next-gen Guardian sites, 'manage-my-account', or 'support'). Defaults to 'ng'.
+ *
+ * @example
+ * ```javascript
+ * import { init } from '@guardian/ophan-tracker-js';
+ * init('ng');
+ * ```
+ */
+export declare const init: (platform?: Platform) => void;
+/**
+ * Send a new page-view event to Ophan.
+ *
+ * This generates a new view ID and tracks the current page.
+ * `init()` already sends the first page-view event, so call this only when
+ * intentionally creating another page view, such as after a single-page app
+ * route change.
+ *
+ * @param url - The page URL to track (defaults to current location)
+ * @param referrer - The referrer URL (defaults to document.referrer)
+ *
+ * @example
+ * ```javascript
+ * import { sendInitialEvent } from '@guardian/ophan-tracker-js';
+ * sendInitialEvent('https://www.theguardian.com/article', 'https://google.com');
+ * ```
+ */
+export declare const sendInitialEvent: (url?: string, referrer?: string) => void;
+/**
+ * Record an event against the current page view.
+ *
+ * Use this for component interactions, purchases, subscriptions, media events,
+ * consent events, and other non-page-view payloads. `init()` must have run
+ * first so the event is associated with a valid page view and platform.
+ *
+ * @param event - The event data payload containing metrics and metadata
+ * @param callback - Optional callback function executed after the event is sent
+ *
+ * @example
+ * ```javascript
+ * import { record } from '@guardian/ophan-tracker-js';
+ *
+ * // Track a component interaction
+ * record({
+ *   componentEvent: {
+ *     component: {
+ *       componentType: 'ACQUISITIONS_ENGAGEMENT_BANNER',
+ *       id: 'end-of-article-banner',
+ *       campaignCode: '2024-annual-campaign',
+ *       labels: ['end-of-article']
+ *     },
+ *     action: 'CLICK',
+ *     abTest: {
+ *       name: 'BannerTest',
+ *       variant: 'control'
+ *     }
+ *   }
+ * });
+ *
+ * // Track a rendered component list
+ * record({
+ *   renderedComponents: ['nav', 'footer']
+ * });
+ * ```
+ */
+export declare const record: (event: EventPayload, callback?: () => void) => void;
+/**
+ * Track component attention and visibility analytics.
+ *
+ * Monitors when components enter and leave the viewport.
+ *
+ * @param name - Unique identifier for the component
+ * @param el - The DOM element to track
+ * @param visibilityThreshold - Percentage of element that must be visible (0-1)
+ * @param isTrackingVideo - Whether this component contains video content
+ *
+ * @example
+ * ```javascript
+ * import { trackComponentAttention } from '@guardian/ophan-tracker-js';
+ *
+ * const banner = document.getElementById('promo-banner');
+ * trackComponentAttention('promo-banner', banner, 0.5);
+ * ```
+ */
+export declare const trackComponentAttention: (name: string, el: HTMLElement, visibilityThreshold: number, isTrackingVideo?: boolean) => void;
+/**
+ * Set a custom event emitter for attention tracking.
+ *
+ * This is primarily for integrations that need to bridge the tracker's
+ * attention events into an existing event system.
+ *
+ * @param event - Event emitter object with emit/on methods
+ *
+ * @example
+ * ```javascript
+ * import { setEventEmitter } from '@guardian/ophan-tracker-js';
+ *
+ * const customEmitter = new EventEmitter();
+ * setEventEmitter(customEmitter);
+ * ```
+ */
+export declare const setEventEmitter: (event: Object) => void;
+/**
+ * Manually track a click event on an element with data-link-name or data-component attributes.
+ * This captures click path information and component context for analytics.
+ * Useful for elements that stop event propagation or need explicit tracking.
+ *
+ * @param element - The clicked DOM element (should have data-link-name or data-component attributes)
+ *
+ * @example
+ * ```javascript
+ * import { trackClickComponentEvent } from '@guardian/ophan-tracker-js';
+ *
+ * // Track a click on an element with tracking attributes
+ * const link = document.querySelector('a[data-link-name="subscribe-button"]');
+ * trackClickComponentEvent(link);
+ *
+ * // Or track a button inside a component
+ * const button = document.querySelector('[data-component="newsletter-signup"] button');
+ * trackClickComponentEvent(button);
+ * ```
+ */
+export declare const trackClickComponentEvent: (element: Element) => void;
+/**
+ * Generate a new page view ID for the current browser session.
+ *
+ * Useful for single-page applications when navigating between pages.
+ *
+ * @example
+ * ```javascript
+ * import { bumpViewId } from '@guardian/ophan-tracker-js';
+ *
+ * // Call when navigating to a new page in SPA
+ * bumpViewId();
+ * ```
+ */
+export declare const bumpViewId: () => void;
+/**
+ * Return the current live Ophan page view ID.
+ *
+ * Prefer this function over destructuring `viewId` from the default export,
+ * because the value changes after `bumpViewId()` or `sendInitialEvent()`.
+ */
+export declare const getViewId: () => string;
+/**
+ * Alias for `getViewId()` kept for consumers that use page-view terminology.
+ */
+export declare const getPageViewId: () => string;
+/**
+ * Object-shaped tracker API exposed by the package default export.
+ *
+ * Named exports are preferred for new code, but the default export keeps the
+ * historical object-style API and exposes `viewId`/`pageViewId` as live getters.
+ */
+export interface OphanTracker {
+    init: (platform?: Platform) => void;
+    sendInitialEvent: (url?: string, referrer?: string) => void;
+    record: (event: EventPayload, callback?: () => void) => void;
+    trackComponentAttention: (name: string, el: HTMLElement, visibilityThreshold: number, isTrackingVideo?: boolean) => void;
+    setEventEmitter: (event: Object) => void;
+    trackClickComponentEvent: (element: Element) => void;
+    bumpViewId: () => void;
+    getViewId: () => string;
+    getPageViewId: () => string;
+    viewId: string;
+    pageViewId: string;
+}
+declare const ophanTracker: OphanTracker;
+export default ophanTracker;
+export * from './types/abtest.js';
+export * from './types/subscription.js';
+export * from './types/interaction.js';
+export * from './types/inpageclick.js';
+export * from './types/printproduct.js';
+export * from './types/product.js';
+export * from './types/platform.js';
+export * from './types/media.js';
+export * from './types/consent.js';
+export * from './types/component-type.js';
+export * from './types/component-event.js';
+export * from './types/event.js';
+//# sourceMappingURL=index.d.ts.map

package/NPM-dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,yBAAyB,CAAC;AACjC,OAAO,WAAW,CAAC;AACnB,OAAO,sBAAsB,CAAC;AAC9B,OAAO,eAAe,CAAC;AAEvB,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,mBAAmB,GAAG,SAAS,GAAG,aAAa,CAAC;AA2B9E;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,IAAI,cAAc,QAAQ,KAAU,IA0ChD,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,gBAAgB,SACvB,MAAM,aACD,MAAM,KAId,IAWF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,MAAM,UAAW,YAAY,aAAa,MAAM,IAAI,KAAG,IAanE,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,uBAAuB,SAC7B,MAAM,MACR,WAAW,uBACM,MAAM,oBACT,OAAO,KACvB,IAMF,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,UAAW,MAAM,KAAG,IAE/C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,wBAAwB,YAAa,OAAO,KAAG,IAM3D,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,QAAO,IAM7B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,QAAO,MAAyB,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,aAAa,QAAO,MAAyB,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,QAAQ,KAAK,IAAI,CAAC;IACpC,gBAAgB,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D,MAAM,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IAC7D,uBAAuB,EAAE,CACxB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,WAAW,EACf,mBAAmB,EAAE,MAAM,EAC3B,eAAe,CAAC,EAAE,OAAO,KACrB,IAAI,CAAC;IACV,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,wBAAwB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACrD,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,MAAM,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,QAAA,MAAM,YAAY,EAAE,YAgBnB,CAAC;AAEF,eAAe,YAAY,CAAC;AAG5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC"}

package/NPM-dist/types/inpageclick.js

@@ -1 +1,2 @@
 export {};
+//# sourceMappingURL=inpageclick.js.map

package/NPM-dist/types/inpageclick.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inpageclick.js","sourceRoot":"","sources":["../../src/types/inpageclick.ts"],"names":[],"mappings":""}

package/NPM-dist/types/interaction.js

@@ -1 +1,2 @@
 export {};
+//# sourceMappingURL=interaction.js.map

package/NPM-dist/types/interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.js","sourceRoot":"","sources":["../../src/types/interaction.ts"],"names":[],"mappings":""}

package/NPM-dist/types/interactive.d.ts

@@ -1 +1,2 @@
 export {};
+//# sourceMappingURL=interactive.d.ts.map

package/NPM-dist/types/interactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../src/interactive.js"],"names":[],"mappings":""}

package/NPM-dist/types/jobs-courses.d.ts

@@ -1,5 +1,6 @@
 declare namespace _default {
-    let record: (obj: import("./manage-my-account.js").EventPayload, f?: (() => void) | undefined) => void;
+    let record: (obj: import("./index.js").EventPayload, f?: (() => void) | undefined) => void;
     const viewId: string;
 }
 export default _default;
+//# sourceMappingURL=jobs-courses.d.ts.map

package/NPM-dist/types/jobs-courses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs-courses.d.ts","sourceRoot":"","sources":["../../src/jobs-courses.js"],"names":[],"mappings":""}

package/NPM-dist/types/jobs.d.ts

@@ -1,5 +1,6 @@
 declare namespace _default {
-    let record: (obj: import("./manage-my-account.js").EventPayload, f?: (() => void) | undefined) => void;
+    let record: (obj: import("./index.js").EventPayload, f?: (() => void) | undefined) => void;
     const viewId: string;
 }
 export default _default;
+//# sourceMappingURL=jobs.d.ts.map

package/NPM-dist/types/jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/jobs.js"],"names":[],"mappings":""}

package/NPM-dist/types/link.js

@@ -1 +1,2 @@
 export {};
+//# sourceMappingURL=link.js.map

package/NPM-dist/types/link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../../src/types/link.ts"],"names":[],"mappings":""}

package/NPM-dist/types/media.js

@@ -1 +1,2 @@
 export {};
+//# sourceMappingURL=media.js.map

package/NPM-dist/types/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../../src/types/media.ts"],"names":[],"mappings":""}

package/NPM-dist/types/membership.d.ts

@@ -1,5 +1,6 @@
 declare namespace _default {
-    let record: (obj: import("./manage-my-account.js").EventPayload, f?: (() => void) | undefined) => void;
+    let record: (obj: import("./index.js").EventPayload, f?: (() => void) | undefined) => void;
     const viewId: string;
 }
 export default _default;
+//# sourceMappingURL=membership.d.ts.map

package/NPM-dist/types/membership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"membership.d.ts","sourceRoot":"","sources":["../../src/membership.js"],"names":[],"mappings":""}

package/NPM-dist/types/ng.d.ts

@@ -1,6 +1,3 @@
-import './click-path-capture.js';
-import './perf.js';
-import './iframe-tracking.js';
 export * from './types/abtest.js';
 export * from './types/subscription.js';
 export * from './types/interaction.js';
@@ -13,14 +10,6 @@ export * from './types/consent.js';
 export * from './types/component-type.js';
 export * from './types/component-event.js';
 export * from './types/event.js';
-import { EventPayload } from './types/event.js';
-interface NG {
-    record: (event: EventPayload, callback?: Function) => void;
-    pageViewId: string;
-    viewId: string;
-    trackComponentAttention: (name: string, el: HTMLElement, visibilityThreshold: number, isTrackingVideo?: boolean) => void;
-    setEventEmitter: (event: Object) => void;
-    trackClickComponentEvent: (element: Element) => void;
-}
-declare let ng: NG;
+declare const ng: import("./index.js").OphanTracker;
 export default ng;
+//# sourceMappingURL=ng.d.ts.map

package/NPM-dist/types/ng.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ng.d.ts","sourceRoot":"","sources":["../../src/ng.ts"],"names":[],"mappings":"AAEA,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AAWjC,QAAA,MAAM,EAAE,mCAA+C,CAAC;AAQxD,eAAe,EAAE,CAAC"}

package/NPM-dist/types/perf.d.ts

@@ -1,2 +1,3 @@
 export default perf;
-declare const perf: Performance;
+declare const perf: Performance | null;
+//# sourceMappingURL=perf.d.ts.map

package/NPM-dist/types/perf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perf.d.ts","sourceRoot":"","sources":["../../src/perf.js"],"names":[],"mappings":";AAGA,uCAKS"}

package/NPM-dist/types/platform.js

@@ -1 +1,2 @@
 export {};
+//# sourceMappingURL=platform.js.map

package/NPM-dist/types/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/types/platform.ts"],"names":[],"mappings":""}

package/NPM-dist/types/printproduct.js

@@ -1 +1,2 @@
 export {};
+//# sourceMappingURL=printproduct.js.map

package/NPM-dist/types/printproduct.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"printproduct.js","sourceRoot":"","sources":["../../src/types/printproduct.ts"],"names":[],"mappings":""}

package/NPM-dist/types/privatebrowsing.d.ts

@@ -4,3 +4,4 @@ declare namespace _default {
 }
 export default _default;
 declare function privateBrowsingMode(callback: any): void;
+//# sourceMappingURL=privatebrowsing.d.ts.map

package/NPM-dist/types/privatebrowsing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"privatebrowsing.d.ts","sourceRoot":"","sources":["../../src/privatebrowsing.js"],"names":[],"mappings":";IA6DC,6BAOC;;;;AA7DF,0DAmDC"}

package/NPM-dist/types/product.js

@@ -1 +1,2 @@
 export {};
+//# sourceMappingURL=product.js.map

package/NPM-dist/types/product.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product.js","sourceRoot":"","sources":["../../src/types/product.ts"],"names":[],"mappings":""}

package/NPM-dist/types/r2.d.ts

@@ -2,3 +2,4 @@ declare namespace _default {
     const viewId: string;
 }
 export default _default;
+//# sourceMappingURL=r2.d.ts.map

package/NPM-dist/types/r2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r2.d.ts","sourceRoot":"","sources":["../../src/r2.js"],"names":[],"mappings":""}