@newrelic/browser-agent 1.314.0-rc.0 → 1.314.0-rc.2

package/dist/cjs/common/constants/agent-constants.js

@@ -18,5 +18,6 @@ const SUPPORTS_REGISTERED_ENTITIES = exports.SUPPORTS_REGISTERED_ENTITIES = {
   [_features.FEATURE_NAMES.logging]: true,
   [_features.FEATURE_NAMES.genericEvents]: true,
   [_features.FEATURE_NAMES.jserrors]: true,
-  [_features.FEATURE_NAMES.ajax]: true
+  [_features.FEATURE_NAMES.ajax]: true,
+  [_features.FEATURE_NAMES.pageViewTiming]: true
 };

package/dist/cjs/common/constants/env.cdn.js

@@ -17,7 +17,7 @@ exports.VERSION = exports.RRWEB_VERSION = exports.RRWEB_PACKAGE_NAME = exports.D
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.314.0-rc.0";
+const VERSION = exports.VERSION = "1.314.0-rc.2";
 
 /**
  * Exposes the build type of the agent

package/dist/cjs/common/constants/env.npm.js

@@ -17,7 +17,7 @@ exports.VERSION = exports.RRWEB_VERSION = exports.RRWEB_PACKAGE_NAME = exports.D
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.314.0-rc.0";
+const VERSION = exports.VERSION = "1.314.0-rc.2";
 
 /**
  * Exposes the build type of the agent

package/dist/cjs/common/vitals/cumulative-layout-shift.js

@@ -9,7 +9,7 @@ var _constants = require("./constants");
 var _vitalMetric = require("./vital-metric");
 var _runtime = require("../constants/runtime");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
@@ -29,7 +29,8 @@ if (_runtime.isBrowserScope) {
     };
     cumulativeLayoutShift.update({
       value,
-      attrs
+      attrs,
+      element: attribution.largestShiftSource?.node
     });
   }, {
     reportAllChanges: true

package/dist/cjs/common/vitals/interaction-to-next-paint.js

@@ -9,7 +9,7 @@ var _vitalMetric = require("./vital-metric");
 var _constants = require("./constants");
 var _runtime = require("../constants/runtime");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
@@ -38,7 +38,8 @@ if (_runtime.isBrowserScope) {
     };
     interactionToNextPaint.update({
       value,
-      attrs
+      attrs,
+      element: attribution.interactionTargetElement
     });
   });
 }

package/dist/cjs/common/vitals/largest-contentful-paint.js

@@ -40,7 +40,8 @@ if (_runtime.isBrowserScope) {
     if (attribution.url) attrs.elUrl = (0, _cleanUrl.cleanURL)(attribution.url);
     largestContentfulPaint.update({
       value,
-      attrs
+      attrs,
+      element: lcpEntry?.element
     });
   });
 }

package/dist/cjs/common/vitals/vital-metric.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.VitalMetric = void 0;
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 class VitalMetric {
@@ -18,13 +18,15 @@ class VitalMetric {
   }
   update({
     value,
-    attrs = {}
+    attrs = {},
+    element
   }) {
     if (value === undefined || value === null || value < 0) return;
     const state = {
       value: this.roundingMethod(value),
       name: this.name,
-      attrs
+      attrs,
+      element
     };
     this.history.push(state);
     this.#subscribers.forEach(cb => {
@@ -39,7 +41,8 @@ class VitalMetric {
     return this.history[this.history.length - 1] || {
       value: undefined,
       name: this.name,
-      attrs: {}
+      attrs: {},
+      element: undefined
     };
   }
   get isValid() {

package/dist/cjs/features/page_view_timing/aggregate/index.js

@@ -21,6 +21,8 @@ var _runtime = require("../../../common/constants/runtime");
 var _eventOrigin = require("../../../common/util/event-origin");
 var _loadTime = require("../../../common/vitals/load-time");
 var _webdriverDetection = require("../../../common/util/webdriver-detection");
+var _selectorPath = require("../../../common/dom/selector-path");
+var _utils = require("../../../common/v2/utils");
 var _cleanUrl = require("../../../common/url/clean-url");
 /**
  * Copyright 2020-2026 New Relic, Inc. All rights reserved.
@@ -32,9 +34,10 @@ class Aggregate extends _aggregateBase.AggregateBase {
   #handleVitalMetric = ({
     name,
     value,
-    attrs
+    attrs,
+    element
   }) => {
-    this.addTiming(name, value, attrs);
+    this.addTiming(name, value, attrs, element);
   };
   constructor(agentRef) {
     super(agentRef, _constants.FEATURE_NAME);
@@ -62,10 +65,11 @@ class Aggregate extends _aggregateBase.AggregateBase {
         const {
           name,
           value,
-          attrs
+          attrs,
+          element
         } = _cumulativeLayoutShift.cumulativeLayoutShift.current;
         if (value === undefined) return;
-        this.addTiming(name, value * 1000, attrs);
+        this.addTiming(name, value * 1000, attrs, element);
       }, true, true); // CLS node should only reports on vis change rather than on every change
 
       this.drain();
@@ -83,7 +87,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
       this.curSessEndRecorded = true;
     }
   }
-  addTiming(name, value, attrs) {
+  addTiming(name, value, attrs, element) {
     attrs = attrs || {};
     attrs.pageUrl = (0, _cleanUrl.cleanURL)((0, _runtime.getNavigationEntry)()?.name || _runtime.initialLocation);
     addConnectionAttributes(attrs); // network conditions may differ from the actual for VitalMetrics when they were captured
@@ -104,7 +108,24 @@ class Aggregate extends _aggregateBase.AggregateBase {
       value,
       attrs
     };
-    this.events.add(timing);
+    const targets = (0, _selectorPath.analyzeElemPath)(element, [], this.agentRef).targets;
+    if (!targets.length) targets.push(undefined);
+    targets.forEach(target => {
+      this.events.add({
+        ...timing,
+        attrs: {
+          ...attrs,
+          ...(0, _utils.getVersion2Attributes)(target, this)
+        }
+      });
+      if ((0, _utils.shouldDuplicate)(target, this.agentRef)) this.events.add({
+        ...timing,
+        attrs: {
+          ...attrs,
+          ...(0, _utils.getVersion2DuplicationAttributes)(target, this)
+        }
+      });
+    });
     (0, _handle.handle)('pvtAdded', [name, value, attrs], undefined, _features.FEATURE_NAMES.sessionTrace, this.ee);
     this.checkForFirstInteraction();
 

package/dist/cjs/features/soft_navigations/aggregate/index.js

@@ -36,7 +36,6 @@ class Aggregate extends _aggregateBase.AggregateBase {
       this.initialPageLoadInteraction.forceSave = true; // unless forcibly ignored, iPL always finish by default
       const ixn = this.initialPageLoadInteraction;
       this.events.add(ixn); // add the iPL ixn to the buffer for harvest
-      this.initialPageLoadInteraction = null;
     });
     _loadTime.loadTime.subscribe(({
       value: loadEventTime
@@ -230,22 +229,26 @@ class Aggregate extends _aggregateBase.AggregateBase {
     const INTERACTION_API = 'api-ixn-';
     const thisClass = this;
     (0, _registerHandler.registerHandler)(INTERACTION_API + 'get', function (time, {
-      waitForEnd
+      waitForEnd,
+      targetPageLoad
     } = {}) {
       // In here, 'this' refers to the EventContext specific to per InteractionHandle instance spawned by each .interaction() api call.
       // Each api call aka IH instance would therefore retain a reference to either the in-progress interaction *at the time of the call* OR a new api-started interaction.
-      this.associatedInteraction = thisClass.getInteractionFor(time);
-      if (this.associatedInteraction?.trigger === _constants.IPL_TRIGGER_NAME) this.associatedInteraction = null; // the api get-interaction method cannot target IPL
-      if (!this.associatedInteraction) {
-        // This new api-driven interaction will be the target of any subsequent .interaction() call, until it is closed by EITHER .end() OR the regular url>dom change process.
-        this.associatedInteraction = thisClass.interactionInProgress = new _interaction.Interaction(_constants.API_TRIGGER_NAME, Math.floor(time), thisClass.latestRouteSetByApi);
-        thisClass.domObserver.observe(document.body, {
-          attributes: true,
-          childList: true,
-          subtree: true,
-          characterData: true
-        }); // start observing for DOM changes like a regular UI-driven interaction
-        thisClass.setClosureHandlers();
+      if (targetPageLoad) this.associatedInteraction = thisClass.initialPageLoadInteraction; // this option only grabs the IPL, no frills
+      else {
+        this.associatedInteraction = thisClass.getInteractionFor(time);
+        if (this.associatedInteraction?.trigger === _constants.IPL_TRIGGER_NAME) this.associatedInteraction = null; // the api get-interaction method cannot target IPL
+        if (!this.associatedInteraction) {
+          // This new api-driven interaction will be the target of any subsequent .interaction() call, until it is closed by EITHER .end() OR the regular url>dom change process.
+          this.associatedInteraction = thisClass.interactionInProgress = new _interaction.Interaction(_constants.API_TRIGGER_NAME, Math.floor(time), thisClass.latestRouteSetByApi);
+          thisClass.domObserver.observe(document.body, {
+            attributes: true,
+            childList: true,
+            subtree: true,
+            characterData: true
+          }); // start observing for DOM changes like a regular UI-driven interaction
+          thisClass.setClosureHandlers();
+        }
       }
       if (waitForEnd === true) {
         this.associatedInteraction.keepOpenUntilEndApi = true;

package/dist/cjs/loaders/api-base.js

@@ -202,6 +202,7 @@ class ApiBase {
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/interaction/}
    * @param {Object} [opts] Options to configure the new or existing interaction with
    * @param {boolean} [opts.waitForEnd=false] To forcibly keep the interaction open until the `.end` method is called on its handle, set to true. Defaults to false. After an interaction is earmarked with this, it cannot be undone.
+    * @param {boolean} [opts.targetPageLoad=false] If true, bind this API handle to the initial page load interaction forcibly instead of creating or targeting a soft navigation interaction.
    * @returns {InteractionInstance} An API object that is bound to a specific BrowserInteraction event. Each time this method is called for the same BrowserInteraction, a new object is created, but it still references the same interaction.
    *  - Note: Does not apply to MicroAgent
    *  - Deprecation Notice: interaction.createTracer is deprecated.  See https://docs.newrelic.com/eol/2024/04/eol-04-24-24-createtracer/ for more information.

package/dist/esm/common/constants/agent-constants.js

@@ -11,5 +11,6 @@ export const SUPPORTS_REGISTERED_ENTITIES = {
   [FEATURE_NAMES.logging]: true,
   [FEATURE_NAMES.genericEvents]: true,
   [FEATURE_NAMES.jserrors]: true,
-  [FEATURE_NAMES.ajax]: true
+  [FEATURE_NAMES.ajax]: true,
+  [FEATURE_NAMES.pageViewTiming]: true
 };

package/dist/esm/common/constants/env.cdn.js

@@ -11,7 +11,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.314.0-rc.0";
+export const VERSION = "1.314.0-rc.2";
 
 /**
  * Exposes the build type of the agent

package/dist/esm/common/constants/env.npm.js

@@ -11,7 +11,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.314.0-rc.0";
+export const VERSION = "1.314.0-rc.2";
 
 /**
  * Exposes the build type of the agent

package/dist/esm/common/vitals/cumulative-layout-shift.js

@@ -1,5 +1,5 @@
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 import { onCLS } from 'web-vitals/attribution';
@@ -22,7 +22,8 @@ if (isBrowserScope) {
     };
     cumulativeLayoutShift.update({
       value,
-      attrs
+      attrs,
+      element: attribution.largestShiftSource?.node
     });
   }, {
     reportAllChanges: true

package/dist/esm/common/vitals/interaction-to-next-paint.js

@@ -1,5 +1,5 @@
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 import { onINP } from 'web-vitals/attribution';
@@ -31,7 +31,8 @@ if (isBrowserScope) {
     };
     interactionToNextPaint.update({
       value,
-      attrs
+      attrs,
+      element: attribution.interactionTargetElement
     });
   });
 }

package/dist/esm/common/vitals/largest-contentful-paint.js

@@ -33,7 +33,8 @@ if (isBrowserScope) {
     if (attribution.url) attrs.elUrl = cleanURL(attribution.url);
     largestContentfulPaint.update({
       value,
-      attrs
+      attrs,
+      element: lcpEntry?.element
     });
   });
 }

package/dist/esm/common/vitals/vital-metric.js

@@ -1,5 +1,5 @@
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 export class VitalMetric {
@@ -12,13 +12,15 @@ export class VitalMetric {
   }
   update({
     value,
-    attrs = {}
+    attrs = {},
+    element
   }) {
     if (value === undefined || value === null || value < 0) return;
     const state = {
       value: this.roundingMethod(value),
       name: this.name,
-      attrs
+      attrs,
+      element
     };
     this.history.push(state);
     this.#subscribers.forEach(cb => {
@@ -33,7 +35,8 @@ export class VitalMetric {
     return this.history[this.history.length - 1] || {
       value: undefined,
       name: this.name,
-      attrs: {}
+      attrs: {},
+      element: undefined
     };
   }
   get isValid() {

package/dist/esm/features/page_view_timing/aggregate/index.js

@@ -20,15 +20,18 @@ import { initiallyHidden, getNavigationEntry, initialLocation } from '../../../c
 import { eventOrigin } from '../../../common/util/event-origin';
 import { loadTime } from '../../../common/vitals/load-time';
 import { webdriverDetected } from '../../../common/util/webdriver-detection';
+import { analyzeElemPath } from '../../../common/dom/selector-path';
+import { getVersion2Attributes, getVersion2DuplicationAttributes, shouldDuplicate } from '../../../common/v2/utils';
 import { cleanURL } from '../../../common/url/clean-url';
 export class Aggregate extends AggregateBase {
   static featureName = FEATURE_NAME;
   #handleVitalMetric = ({
     name,
     value,
-    attrs
+    attrs,
+    element
   }) => {
-    this.addTiming(name, value, attrs);
+    this.addTiming(name, value, attrs, element);
   };
   constructor(agentRef) {
     super(agentRef, FEATURE_NAME);
@@ -56,10 +59,11 @@ export class Aggregate extends AggregateBase {
         const {
           name,
           value,
-          attrs
+          attrs,
+          element
         } = cumulativeLayoutShift.current;
         if (value === undefined) return;
-        this.addTiming(name, value * 1000, attrs);
+        this.addTiming(name, value * 1000, attrs, element);
       }, true, true); // CLS node should only reports on vis change rather than on every change
 
       this.drain();
@@ -77,7 +81,7 @@ export class Aggregate extends AggregateBase {
       this.curSessEndRecorded = true;
     }
   }
-  addTiming(name, value, attrs) {
+  addTiming(name, value, attrs, element) {
     attrs = attrs || {};
     attrs.pageUrl = cleanURL(getNavigationEntry()?.name || initialLocation);
     addConnectionAttributes(attrs); // network conditions may differ from the actual for VitalMetrics when they were captured
@@ -98,7 +102,24 @@ export class Aggregate extends AggregateBase {
       value,
       attrs
     };
-    this.events.add(timing);
+    const targets = analyzeElemPath(element, [], this.agentRef).targets;
+    if (!targets.length) targets.push(undefined);
+    targets.forEach(target => {
+      this.events.add({
+        ...timing,
+        attrs: {
+          ...attrs,
+          ...getVersion2Attributes(target, this)
+        }
+      });
+      if (shouldDuplicate(target, this.agentRef)) this.events.add({
+        ...timing,
+        attrs: {
+          ...attrs,
+          ...getVersion2DuplicationAttributes(target, this)
+        }
+      });
+    });
     handle('pvtAdded', [name, value, attrs], undefined, FEATURE_NAMES.sessionTrace, this.ee);
     this.checkForFirstInteraction();
 

package/dist/esm/features/soft_navigations/aggregate/index.js

@@ -29,7 +29,6 @@ export class Aggregate extends AggregateBase {
       this.initialPageLoadInteraction.forceSave = true; // unless forcibly ignored, iPL always finish by default
       const ixn = this.initialPageLoadInteraction;
       this.events.add(ixn); // add the iPL ixn to the buffer for harvest
-      this.initialPageLoadInteraction = null;
     });
     loadTime.subscribe(({
       value: loadEventTime
@@ -223,22 +222,26 @@ export class Aggregate extends AggregateBase {
     const INTERACTION_API = 'api-ixn-';
     const thisClass = this;
     registerHandler(INTERACTION_API + 'get', function (time, {
-      waitForEnd
+      waitForEnd,
+      targetPageLoad
     } = {}) {
       // In here, 'this' refers to the EventContext specific to per InteractionHandle instance spawned by each .interaction() api call.
       // Each api call aka IH instance would therefore retain a reference to either the in-progress interaction *at the time of the call* OR a new api-started interaction.
-      this.associatedInteraction = thisClass.getInteractionFor(time);
-      if (this.associatedInteraction?.trigger === IPL_TRIGGER_NAME) this.associatedInteraction = null; // the api get-interaction method cannot target IPL
-      if (!this.associatedInteraction) {
-        // This new api-driven interaction will be the target of any subsequent .interaction() call, until it is closed by EITHER .end() OR the regular url>dom change process.
-        this.associatedInteraction = thisClass.interactionInProgress = new Interaction(API_TRIGGER_NAME, Math.floor(time), thisClass.latestRouteSetByApi);
-        thisClass.domObserver.observe(document.body, {
-          attributes: true,
-          childList: true,
-          subtree: true,
-          characterData: true
-        }); // start observing for DOM changes like a regular UI-driven interaction
-        thisClass.setClosureHandlers();
+      if (targetPageLoad) this.associatedInteraction = thisClass.initialPageLoadInteraction; // this option only grabs the IPL, no frills
+      else {
+        this.associatedInteraction = thisClass.getInteractionFor(time);
+        if (this.associatedInteraction?.trigger === IPL_TRIGGER_NAME) this.associatedInteraction = null; // the api get-interaction method cannot target IPL
+        if (!this.associatedInteraction) {
+          // This new api-driven interaction will be the target of any subsequent .interaction() call, until it is closed by EITHER .end() OR the regular url>dom change process.
+          this.associatedInteraction = thisClass.interactionInProgress = new Interaction(API_TRIGGER_NAME, Math.floor(time), thisClass.latestRouteSetByApi);
+          thisClass.domObserver.observe(document.body, {
+            attributes: true,
+            childList: true,
+            subtree: true,
+            characterData: true
+          }); // start observing for DOM changes like a regular UI-driven interaction
+          thisClass.setClosureHandlers();
+        }
       }
       if (waitForEnd === true) {
         this.associatedInteraction.keepOpenUntilEndApi = true;

package/dist/esm/loaders/api-base.js

@@ -196,6 +196,7 @@ export class ApiBase {
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/interaction/}
    * @param {Object} [opts] Options to configure the new or existing interaction with
    * @param {boolean} [opts.waitForEnd=false] To forcibly keep the interaction open until the `.end` method is called on its handle, set to true. Defaults to false. After an interaction is earmarked with this, it cannot be undone.
+    * @param {boolean} [opts.targetPageLoad=false] If true, bind this API handle to the initial page load interaction forcibly instead of creating or targeting a soft navigation interaction.
    * @returns {InteractionInstance} An API object that is bound to a specific BrowserInteraction event. Each time this method is called for the same BrowserInteraction, a new object is created, but it still references the same interaction.
    *  - Note: Does not apply to MicroAgent
    *  - Deprecation Notice: interaction.createTracer is deprecated.  See https://docs.newrelic.com/eol/2024/04/eol-04-24-24-createtracer/ for more information.

package/dist/types/common/constants/agent-constants.d.ts

@@ -7,6 +7,7 @@ export const SUPPORTS_REGISTERED_ENTITIES: {
     [FEATURE_NAMES.genericEvents]: boolean;
     [FEATURE_NAMES.jserrors]: boolean;
     [FEATURE_NAMES.ajax]: boolean;
+    [FEATURE_NAMES.pageViewTiming]: boolean;
 };
 import { FEATURE_NAMES } from '../../loaders/features/features';
 //# sourceMappingURL=agent-constants.d.ts.map

package/dist/types/common/constants/agent-constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-constants.d.ts","sourceRoot":"","sources":["../../../../src/common/constants/agent-constants.js"],"names":[],"mappings":"AAMA,iCAAkC,KAAK,CAAA;AACvC,+BAAgC,OAAO,CAAA;AACvC,0BAA2B,oBAAoB,CAAA;AAC/C,4BAA6B,eAAe,CAAA;AAE5C;IACE,CAAC,aAAa,CAAC,OAAO,CAAC,UAAM;IAC7B,CAAC,aAAa,CAAC,aAAa,CAAC,UAAM;IACnC,CAAC,aAAa,CAAC,QAAQ,CAAC,UAAM;IAC9B,CAAC,aAAa,CAAC,IAAI,CAAC,UAAM;EAC3B;8BAZ6B,iCAAiC"}
+{"version":3,"file":"agent-constants.d.ts","sourceRoot":"","sources":["../../../../src/common/constants/agent-constants.js"],"names":[],"mappings":"AAMA,iCAAkC,KAAK,CAAA;AACvC,+BAAgC,OAAO,CAAA;AACvC,0BAA2B,oBAAoB,CAAA;AAC/C,4BAA6B,eAAe,CAAA;AAE5C;IACE,CAAC,aAAa,CAAC,OAAO,CAAC,UAAM;IAC7B,CAAC,aAAa,CAAC,aAAa,CAAC,UAAM;IACnC,CAAC,aAAa,CAAC,QAAQ,CAAC,UAAM;IAC9B,CAAC,aAAa,CAAC,IAAI,CAAC,UAAM;IAC1B,CAAC,aAAa,CAAC,cAAc,CAAC,UAAM;EACrC;8BAb6B,iCAAiC"}

package/dist/types/common/vitals/vital-metric.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 export class VitalMetric {
@@ -8,9 +8,10 @@ export class VitalMetric {
     name: any;
     attrs: {};
     roundingMethod: any;
-    update({ value, attrs }: {
+    update({ value, attrs, element }: {
         value: any;
         attrs?: {} | undefined;
+        element: any;
     }): void;
     get current(): any;
     get isValid(): boolean;

package/dist/types/common/vitals/vital-metric.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vital-metric.d.ts","sourceRoot":"","sources":["../../../../src/common/vitals/vital-metric.js"],"names":[],"mappings":"AAAA;;;GAGG;AACH;IAIE,4CAIC;IAND,eAAY;IAGV,UAAgB;IAChB,UAAe;IACf,oBAAwF;IAG1F;;;aAgBC;IAED,mBAMC;IAED,uBAEC;IAED,uEAMC;;CACF"}
+{"version":3,"file":"vital-metric.d.ts","sourceRoot":"","sources":["../../../../src/common/vitals/vital-metric.js"],"names":[],"mappings":"AAAA;;;GAGG;AACH;IAIE,4CAIC;IAND,eAAY;IAGV,UAAgB;IAChB,UAAe;IACf,oBAAwF;IAG1F;;;;aAiBC;IAED,mBAOC;IAED,uBAEC;IAED,uEAMC;;CACF"}

package/dist/types/features/page_view_timing/aggregate/index.d.ts

@@ -8,7 +8,7 @@ export class Aggregate extends AggregateBase {
      * @param {number} timestamp
      */
     endCurrentSession(timestamp: number): void;
-    addTiming(name: any, value: any, attrs: any): {
+    addTiming(name: any, value: any, attrs: any, element: any): {
         name: any;
         value: any;
         attrs: any;

package/dist/types/features/page_view_timing/aggregate/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/page_view_timing/aggregate/index.js"],"names":[],"mappings":"AAwBA;IACE,2BAAiC;IAMjC,2BA4BC;IA1BC,4BAA+B;IAC/B,0BAA6B;IA2B/B;;;OAGG;IACH,6BAFW,MAAM,QAOhB;IAED;;;;MA+BC;IAED;;;OAGG;IACH,4BAFa,IAAI,CAahB;IAED,gDAWC;IAED,4BAGC;IAGD,qCAwBC;;CACF;8BA5J6B,4BAA4B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/page_view_timing/aggregate/index.js"],"names":[],"mappings":"AA0BA;IACE,2BAAiC;IAMjC,2BA4BC;IA1BC,4BAA+B;IAC/B,0BAA6B;IA2B/B;;;OAGG;IACH,6BAFW,MAAM,QAOhB;IAED;;;;MAqCC;IAED;;;OAGG;IACH,4BAFa,IAAI,CAahB;IAED,gDAWC;IAED,4BAGC;IAGD,qCAwBC;;CACF;8BApK6B,4BAA4B"}

package/dist/types/features/soft_navigations/aggregate/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/soft_navigations/aggregate/index.js"],"names":[],"mappings":"AAeA;IACE,2BAAiC;IACjC;;OAgEC;IA3DC,2BAAwC;IACxC,iBAA8B;IAE9B,uDAA0E;IAe1E,yBAA+B;IAC/B,0CAAiC;IACjC,yBAA4C;IAyC9C,qCAUC;IAED,0EAmBC;IAED,2BAiBC;IAED;;;;;;;OAOG;IACH,6BAHW,mBAAmB,OAsB7B;;CAiHF;8BA1Q6B,4BAA4B;2CAGf,iCAAiC;4BAChD,eAAe"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/soft_navigations/aggregate/index.js"],"names":[],"mappings":"AAeA;IACE,2BAAiC;IACjC;;OA+DC;IA1DC,2BAAwC;IACxC,iBAA8B;IAE9B,uDAA0E;IAc1E,yBAA+B;IAC/B,0CAAiC;IACjC,yBAA4C;IAyC9C,qCAUC;IAED,0EAmBC;IAED,2BAiBC;IAED;;;;;;;OAOG;IACH,6BAHW,mBAAmB,OAsB7B;;CAoHF;8BA5Q6B,4BAA4B;2CAGf,iCAAiC;4BAChD,eAAe"}

package/dist/types/loaders/api-base.d.ts

@@ -143,12 +143,14 @@ export class ApiBase {
      * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/interaction/}
      * @param {Object} [opts] Options to configure the new or existing interaction with
      * @param {boolean} [opts.waitForEnd=false] To forcibly keep the interaction open until the `.end` method is called on its handle, set to true. Defaults to false. After an interaction is earmarked with this, it cannot be undone.
+      * @param {boolean} [opts.targetPageLoad=false] If true, bind this API handle to the initial page load interaction forcibly instead of creating or targeting a soft navigation interaction.
      * @returns {InteractionInstance} An API object that is bound to a specific BrowserInteraction event. Each time this method is called for the same BrowserInteraction, a new object is created, but it still references the same interaction.
      *  - Note: Does not apply to MicroAgent
      *  - Deprecation Notice: interaction.createTracer is deprecated.  See https://docs.newrelic.com/eol/2024/04/eol-04-24-24-createtracer/ for more information.
     */
     interaction(opts?: {
         waitForEnd?: boolean | undefined;
+        targetPageLoad?: boolean | undefined;
     }): InteractionInstance;
     /**
      * Wrap a logger function to capture a log each time the function is invoked with the message and arguments passed

package/dist/types/loaders/api-base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-base.d.ts","sourceRoot":"","sources":["../../../src/loaders/api-base.js"],"names":[],"mappings":"AAOA;;GAEG;AACH;IAQE;;;;;OAKG;IACH,oBAHW,MAAM,eACN,MAAM,OAIhB;IAED;;;;;;;;OAQG;IACH,iBAHW,OAAO,0BAA0B,EAAE,sBAAsB,GAC1D,OAAO,0BAA0B,EAAE,WAAW,CAIvD;IAED;;;;;OAKG;IACH,6BAHW,MAAM,eACN,MAAM,OAIhB;IAED;;;;;OAKG;IACH,sBAHW,MAAM,SACN,MAAM,OAIhB;IAED;;;;;;OAMG;IACH,yBAJW,MAAM,SACN,MAAM,GAAC,MAAM,GAAC,OAAO,GAAC,IAAI,YAC1B,OAAO,OAIjB;IAED;;;;;OAKG;IACH,mBAHW,KAAK,GAAC,MAAM,qBACZ,MAAM,OAIhB;IAED;;;;;OAKG;IACH,iBAHW,MAAM,GAAC,IAAI,iBACX,OAAO,OAIjB;IAED;;;;;;;OAOG;IACH,6BAJW,MAAM,GAAC,IAAI,OAMrB;IAED;;;;OAIG;IACH,0BAFW,CAAC,KAAK,EAAE,KAAK,GAAC,MAAM,KAAK,OAAO,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,OAI9D;IAED;;;;;OAKG;IACH,iBAHW,MAAM,MACN,MAAM,OAIhB;IAED;;;;;MAKE;IACF,aAHW,MAAM,YACN;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,GAAC,OAAO,GAAC,OAAO,GAAC,MAAM,GAAC,MAAM,CAAA;KAAC,OAIpF;IAED;;;OAGG;IACH,aAEC;IAED;;;;OAIG;IACH,qBAFW,MAAM,OAIhB;IAED;;;;OAIG;IACH,oBAEC;IAED;;;;;OAKG;IACH,mBAEC;IAED;;;;;;;;;;OAUG;IACH,6BARW;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAC,OAUrF;IAED;;;;;OAKG;IACH,0BAHW,MAAM,OAKhB;IAED;;;;;;;;MAQE;IACF,mBALG;QAAuB,UAAU;KACjC,GAAU,mBAAmB,CAM/B;IAED;;;;;;MAME;IACF,mBAJW,MAAM,gBACN,MAAM,YACN;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,GAAC,OAAO,GAAC,OAAO,GAAC,MAAM,GAAC,MAAM,CAAA;KAAC,OAIpF;IAED;;;;;;OAMG;IACH,cAJW,MAAM,YACN;QAAC,KAAK,CAAC,EAAE,MAAM,GAAC,eAAe,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,GAAC,eAAe,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAC,GACvF;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAC,CAIpF;IAED;;;;;OAKG;IACH,gBAFW,OAAO,OAAC,OAIlB;;CACF;kCAtOY,OAAO,yBAAyB,EAAE,mBAAmB"}
+{"version":3,"file":"api-base.d.ts","sourceRoot":"","sources":["../../../src/loaders/api-base.js"],"names":[],"mappings":"AAOA;;GAEG;AACH;IAQE;;;;;OAKG;IACH,oBAHW,MAAM,eACN,MAAM,OAIhB;IAED;;;;;;;;OAQG;IACH,iBAHW,OAAO,0BAA0B,EAAE,sBAAsB,GAC1D,OAAO,0BAA0B,EAAE,WAAW,CAIvD;IAED;;;;;OAKG;IACH,6BAHW,MAAM,eACN,MAAM,OAIhB;IAED;;;;;OAKG;IACH,sBAHW,MAAM,SACN,MAAM,OAIhB;IAED;;;;;;OAMG;IACH,yBAJW,MAAM,SACN,MAAM,GAAC,MAAM,GAAC,OAAO,GAAC,IAAI,YAC1B,OAAO,OAIjB;IAED;;;;;OAKG;IACH,mBAHW,KAAK,GAAC,MAAM,qBACZ,MAAM,OAIhB;IAED;;;;;OAKG;IACH,iBAHW,MAAM,GAAC,IAAI,iBACX,OAAO,OAIjB;IAED;;;;;;;OAOG;IACH,6BAJW,MAAM,GAAC,IAAI,OAMrB;IAED;;;;OAIG;IACH,0BAFW,CAAC,KAAK,EAAE,KAAK,GAAC,MAAM,KAAK,OAAO,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,OAI9D;IAED;;;;;OAKG;IACH,iBAHW,MAAM,MACN,MAAM,OAIhB;IAED;;;;;MAKE;IACF,aAHW,MAAM,YACN;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,GAAC,OAAO,GAAC,OAAO,GAAC,MAAM,GAAC,MAAM,CAAA;KAAC,OAIpF;IAED;;;OAGG;IACH,aAEC;IAED;;;;OAIG;IACH,qBAFW,MAAM,OAIhB;IAED;;;;OAIG;IACH,oBAEC;IAED;;;;;OAKG;IACH,mBAEC;IAED;;;;;;;;;;OAUG;IACH,6BARW;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAC,OAUrF;IAED;;;;;OAKG;IACH,0BAHW,MAAM,OAKhB;IAED;;;;;;;;;MASE;IACF,mBANG;QAAuB,UAAU;QACT,cAAc;KACtC,GAAU,mBAAmB,CAM/B;IAED;;;;;;MAME;IACF,mBAJW,MAAM,gBACN,MAAM,YACN;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,GAAC,OAAO,GAAC,OAAO,GAAC,MAAM,GAAC,MAAM,CAAA;KAAC,OAIpF;IAED;;;;;;OAMG;IACH,cAJW,MAAM,YACN;QAAC,KAAK,CAAC,EAAE,MAAM,GAAC,eAAe,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,GAAC,eAAe,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAC,GACvF;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAC,CAIpF;IAED;;;;;OAKG;IACH,gBAFW,OAAO,OAAC,OAIlB;;CACF;kCAvOY,OAAO,yBAAyB,EAAE,mBAAmB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newrelic/browser-agent",
-  "version": "1.314.0-rc.0",
+  "version": "1.314.0-rc.2",
   "private": false,
   "author": "New Relic Browser Agent Team <browser-agent@newrelic.com>",
   "description": "New Relic Browser Agent",

package/src/common/constants/agent-constants.js

@@ -13,5 +13,6 @@ export const SUPPORTS_REGISTERED_ENTITIES = {
   [FEATURE_NAMES.logging]: true,
   [FEATURE_NAMES.genericEvents]: true,
   [FEATURE_NAMES.jserrors]: true,
-  [FEATURE_NAMES.ajax]: true
+  [FEATURE_NAMES.ajax]: true,
+  [FEATURE_NAMES.pageViewTiming]: true
 }

package/src/common/vitals/cumulative-layout-shift.js

@@ -1,5 +1,5 @@
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 import { onCLS } from 'web-vitals/attribution'
@@ -18,6 +18,6 @@ if (isBrowserScope) {
       largestShiftValue: attribution.largestShiftValue,
       loadState: attribution.loadState
     }
-    cumulativeLayoutShift.update({ value, attrs })
+    cumulativeLayoutShift.update({ value, attrs, element: attribution.largestShiftSource?.node })
   }, { reportAllChanges: true })
 }

package/src/common/vitals/interaction-to-next-paint.js

@@ -1,5 +1,5 @@
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 import { onINP } from 'web-vitals/attribution'
@@ -25,6 +25,6 @@ if (isBrowserScope) {
       presentationDelay: attribution.presentationDelay,
       loadState: attribution.loadState
     }
-    interactionToNextPaint.update({ value, attrs })
+    interactionToNextPaint.update({ value, attrs, element: attribution.interactionTargetElement })
   })
 }

package/src/common/vitals/largest-contentful-paint.js

@@ -31,6 +31,6 @@ if (isBrowserScope) {
     if (attribution.element) attrs.element = attribution.element
     if (attribution.url) attrs.elUrl = cleanURL(attribution.url)
 
-    largestContentfulPaint.update({ value, attrs })
+    largestContentfulPaint.update({ value, attrs, element: lcpEntry?.element })
   })
 }

package/src/common/vitals/vital-metric.js

@@ -1,5 +1,5 @@
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 export class VitalMetric {
@@ -12,12 +12,13 @@ export class VitalMetric {
     this.roundingMethod = typeof roundingMethod === 'function' ? roundingMethod : Math.floor
   }
 
-  update ({ value, attrs = {} }) {
+  update ({ value, attrs = {}, element }) {
     if (value === undefined || value === null || value < 0) return
     const state = {
       value: this.roundingMethod(value),
       name: this.name,
-      attrs
+      attrs,
+      element
     }
 
     this.history.push(state)
@@ -34,7 +35,8 @@ export class VitalMetric {
     return this.history[this.history.length - 1] || {
       value: undefined,
       name: this.name,
-      attrs: {}
+      attrs: {},
+      element: undefined
     }
   }
 

package/src/features/page_view_timing/aggregate/index.js

@@ -20,13 +20,15 @@ import { initiallyHidden, getNavigationEntry, initialLocation } from '../../../c
 import { eventOrigin } from '../../../common/util/event-origin'
 import { loadTime } from '../../../common/vitals/load-time'
 import { webdriverDetected } from '../../../common/util/webdriver-detection'
+import { analyzeElemPath } from '../../../common/dom/selector-path'
+import { getVersion2Attributes, getVersion2DuplicationAttributes, shouldDuplicate } from '../../../common/v2/utils'
 import { cleanURL } from '../../../common/url/clean-url'
 
 export class Aggregate extends AggregateBase {
   static featureName = FEATURE_NAME
 
-  #handleVitalMetric = ({ name, value, attrs }) => {
-    this.addTiming(name, value, attrs)
+  #handleVitalMetric = ({ name, value, attrs, element }) => {
+    this.addTiming(name, value, attrs, element)
   }
 
   constructor (agentRef) {
@@ -50,9 +52,9 @@ export class Aggregate extends AggregateBase {
         /* Downstream, the event consumer interprets all timing node value as ms-unit and converts it to seconds via division by 1000. CLS is unitless so this normally is a problem.
           bel.6 schema also doesn't support decimal values, of which cls within [0,1). However, the two nicely cancels out, and we can multiply cls by 1000 to both negate the division
           and send an integer > 1. We effectively lose some precision down to 3 decimal places for this workaround. E.g. (real) 0.749132... -> 749.132...-> 749 -> 0.749 (final) */
-        const { name, value, attrs } = cumulativeLayoutShift.current
+        const { name, value, attrs, element } = cumulativeLayoutShift.current
         if (value === undefined) return
-        this.addTiming(name, value * 1000, attrs)
+        this.addTiming(name, value * 1000, attrs, element)
       }, true, true) // CLS node should only reports on vis change rather than on every change
 
       this.drain()
@@ -70,7 +72,7 @@ export class Aggregate extends AggregateBase {
     }
   }
 
-  addTiming (name, value, attrs) {
+  addTiming (name, value, attrs, element) {
     attrs = attrs || {}
     attrs.pageUrl = cleanURL(getNavigationEntry()?.name || initialLocation)
 
@@ -93,7 +95,13 @@ export class Aggregate extends AggregateBase {
       value,
       attrs
     }
-    this.events.add(timing)
+
+    const targets = analyzeElemPath(element, [], this.agentRef).targets
+    if (!targets.length) targets.push(undefined)
+    targets.forEach(target => {
+      this.events.add({ ...timing, attrs: { ...attrs, ...getVersion2Attributes(target, this) } })
+      if (shouldDuplicate(target, this.agentRef)) this.events.add({ ...timing, attrs: { ...attrs, ...getVersion2DuplicationAttributes(target, this) } })
+    })
 
     handle('pvtAdded', [name, value, attrs], undefined, FEATURE_NAMES.sessionTrace, this.ee)
 

package/src/features/soft_navigations/aggregate/index.js

@@ -30,7 +30,6 @@ export class Aggregate extends AggregateBase {
       this.initialPageLoadInteraction.forceSave = true // unless forcibly ignored, iPL always finish by default
       const ixn = this.initialPageLoadInteraction
       this.events.add(ixn) // add the iPL ixn to the buffer for harvest
-      this.initialPageLoadInteraction = null
     })
 
     loadTime.subscribe(({ value: loadEventTime }) => {
@@ -230,16 +229,19 @@ export class Aggregate extends AggregateBase {
     const INTERACTION_API = 'api-ixn-'
     const thisClass = this
 
-    registerHandler(INTERACTION_API + 'get', function (time, { waitForEnd } = {}) {
+    registerHandler(INTERACTION_API + 'get', function (time, { waitForEnd, targetPageLoad } = {}) {
       // In here, 'this' refers to the EventContext specific to per InteractionHandle instance spawned by each .interaction() api call.
       // Each api call aka IH instance would therefore retain a reference to either the in-progress interaction *at the time of the call* OR a new api-started interaction.
-      this.associatedInteraction = thisClass.getInteractionFor(time)
-      if (this.associatedInteraction?.trigger === IPL_TRIGGER_NAME) this.associatedInteraction = null // the api get-interaction method cannot target IPL
-      if (!this.associatedInteraction) {
+      if (targetPageLoad) this.associatedInteraction = thisClass.initialPageLoadInteraction // this option only grabs the IPL, no frills
+      else {
+        this.associatedInteraction = thisClass.getInteractionFor(time)
+        if (this.associatedInteraction?.trigger === IPL_TRIGGER_NAME) this.associatedInteraction = null // the api get-interaction method cannot target IPL
+        if (!this.associatedInteraction) {
         // This new api-driven interaction will be the target of any subsequent .interaction() call, until it is closed by EITHER .end() OR the regular url>dom change process.
-        this.associatedInteraction = thisClass.interactionInProgress = new Interaction(API_TRIGGER_NAME, Math.floor(time), thisClass.latestRouteSetByApi)
-        thisClass.domObserver.observe(document.body, { attributes: true, childList: true, subtree: true, characterData: true }) // start observing for DOM changes like a regular UI-driven interaction
-        thisClass.setClosureHandlers()
+          this.associatedInteraction = thisClass.interactionInProgress = new Interaction(API_TRIGGER_NAME, Math.floor(time), thisClass.latestRouteSetByApi)
+          thisClass.domObserver.observe(document.body, { attributes: true, childList: true, subtree: true, characterData: true }) // start observing for DOM changes like a regular UI-driven interaction
+          thisClass.setClosureHandlers()
+        }
       }
       if (waitForEnd === true) {
         this.associatedInteraction.keepOpenUntilEndApi = true

package/src/loaders/api-base.js

@@ -197,6 +197,7 @@ export class ApiBase {
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/interaction/}
    * @param {Object} [opts] Options to configure the new or existing interaction with
    * @param {boolean} [opts.waitForEnd=false] To forcibly keep the interaction open until the `.end` method is called on its handle, set to true. Defaults to false. After an interaction is earmarked with this, it cannot be undone.
+    * @param {boolean} [opts.targetPageLoad=false] If true, bind this API handle to the initial page load interaction forcibly instead of creating or targeting a soft navigation interaction.
    * @returns {InteractionInstance} An API object that is bound to a specific BrowserInteraction event. Each time this method is called for the same BrowserInteraction, a new object is created, but it still references the same interaction.
    *  - Note: Does not apply to MicroAgent
    *  - Deprecation Notice: interaction.createTracer is deprecated.  See https://docs.newrelic.com/eol/2024/04/eol-04-24-24-createtracer/ for more information.