@newrelic/browser-agent 1.279.1 → 1.281.0

package/CHANGELOG.md

@@ -3,6 +3,25 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.281.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.280.0...v1.281.0) (2025-02-04)
+
+
+### Features
+
+* Capture Nearest UserAction Fields ([#1267](https://github.com/newrelic/newrelic-browser-agent/issues/1267)) ([d410937](https://github.com/newrelic/newrelic-browser-agent/commit/d410937983545a6a6aa39c52c3762f621acf1110))
+
+## [1.280.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.279.1...v1.280.0) (2025-01-31)
+
+
+### Features
+
+* Remove agentIdentifier argument from agent constructors ([#1353](https://github.com/newrelic/newrelic-browser-agent/issues/1353)) ([cb866e5](https://github.com/newrelic/newrelic-browser-agent/commit/cb866e5678bf6aa898c082f2be83145a5014fd0e))
+
+
+### Bug Fixes
+
+* Roll back to previous FirstInteraction implementation ([#1359](https://github.com/newrelic/newrelic-browser-agent/issues/1359)) ([c2e22ab](https://github.com/newrelic/newrelic-browser-agent/commit/c2e22ab49b00e9cfbeb54664a820e1aa4ed28a53))
+
 ## [1.279.1](https://github.com/newrelic/newrelic-browser-agent/compare/v1.279.0...v1.279.1) (2025-01-28)
 
 

package/dist/cjs/common/config/init.js

@@ -211,7 +211,8 @@ const model = () => {
     },
     ssl: undefined,
     user_actions: {
-      enabled: true
+      enabled: true,
+      elementAttributes: ['id', 'className', 'tagName', 'type']
     }
   };
 };

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

@@ -17,7 +17,7 @@ exports.VERSION = exports.RRWEB_VERSION = exports.DIST_METHOD = exports.BUILD_EN
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.279.1";
+const VERSION = exports.VERSION = "1.281.0";
 
 /**
  * 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.DIST_METHOD = exports.BUILD_EN
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.279.1";
+const VERSION = exports.VERSION = "1.281.0";
 
 /**
  * Exposes the build type of the agent

package/dist/cjs/common/dom/selector-path.js

@@ -16,8 +16,11 @@ exports.generateSelectorPath = void 0;
  * @param {boolean} includeClass
  * @returns {string|undefined}
  */
-const generateSelectorPath = elem => {
-  if (!elem) return;
+const generateSelectorPath = (elem, targetFields = []) => {
+  if (!elem) return {
+    path: undefined,
+    nearestFields: {}
+  };
   const getNthOfTypeIndex = node => {
     try {
       let i = 1;
@@ -35,12 +38,16 @@ const generateSelectorPath = elem => {
   };
   let pathSelector = '';
   let index = getNthOfTypeIndex(elem);
+  const nearestFields = {};
   try {
     while (elem?.tagName) {
       const {
         id,
         localName
       } = elem;
+      targetFields.forEach(field => {
+        nearestFields[nearestAttrName(field)] ||= elem[field];
+      });
       const selector = [localName, id ? "#".concat(id) : '', pathSelector ? ">".concat(pathSelector) : ''].join('');
       pathSelector = selector;
       elem = elem.parentNode;
@@ -48,6 +55,16 @@ const generateSelectorPath = elem => {
   } catch (err) {
     // do nothing for now
   }
-  return pathSelector ? index ? "".concat(pathSelector, ":nth-of-type(").concat(index, ")") : pathSelector : undefined;
+  const path = pathSelector ? index ? "".concat(pathSelector, ":nth-of-type(").concat(index, ")") : pathSelector : undefined;
+  return {
+    path,
+    nearestFields
+  };
+  function nearestAttrName(originalFieldName) {
+    /** preserve original renaming structure for pre-existing field maps */
+    if (originalFieldName === 'tagName') originalFieldName = 'tag';
+    if (originalFieldName === 'className') originalFieldName = 'class';
+    return "nearest".concat(originalFieldName.charAt(0).toUpperCase() + originalFieldName.slice(1));
+  }
 };
 exports.generateSelectorPath = generateSelectorPath;

package/dist/cjs/common/vitals/constants.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.VITAL_NAMES = exports.PERFORMANCE_ENTRY_TYPE = void 0;
+exports.VITAL_NAMES = void 0;
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -11,12 +11,9 @@ exports.VITAL_NAMES = exports.PERFORMANCE_ENTRY_TYPE = void 0;
 const VITAL_NAMES = exports.VITAL_NAMES = {
   FIRST_PAINT: 'fp',
   FIRST_CONTENTFUL_PAINT: 'fcp',
-  FIRST_INTERACTION: 'fi',
+  FIRST_INPUT_DELAY: 'fi',
   LARGEST_CONTENTFUL_PAINT: 'lcp',
   CUMULATIVE_LAYOUT_SHIFT: 'cls',
   INTERACTION_TO_NEXT_PAINT: 'inp',
   TIME_TO_FIRST_BYTE: 'ttfb'
-};
-const PERFORMANCE_ENTRY_TYPE = exports.PERFORMANCE_ENTRY_TYPE = {
-  FIRST_INPUT: 'first-input'
 };

package/dist/cjs/common/vitals/first-input-delay.js

@@ -0,0 +1,36 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.firstInputDelay = void 0;
+var _attribution = require("web-vitals/attribution");
+var _vitalMetric = require("./vital-metric");
+var _constants = require("./constants");
+var _runtime = require("../constants/runtime");
+/**
+ * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+const firstInputDelay = exports.firstInputDelay = new _vitalMetric.VitalMetric(_constants.VITAL_NAMES.FIRST_INPUT_DELAY);
+if (_runtime.isBrowserScope) {
+  (0, _attribution.onFID)(({
+    value,
+    attribution
+  }) => {
+    if (_runtime.initiallyHidden || firstInputDelay.isValid) return;
+    const attrs = {
+      type: attribution.eventType,
+      fid: Math.round(value),
+      eventTarget: attribution.eventTarget,
+      loadState: attribution.loadState
+    };
+
+    // CWV will only report one (THE) first-input entry to us; fid isn't reported if there are no user interactions occurs before the *first* page hiding.
+    firstInputDelay.update({
+      value: attribution.eventTime,
+      attrs
+    });
+  });
+}

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

@@ -18,6 +18,7 @@ var _userActionsAggregator = require("./user-actions/user-actions-aggregator");
 var _iframe = require("../../../common/dom/iframe");
 var _handle = require("../../../common/event-emitter/handle");
 var _typeCheck = require("../../../common/util/type-check");
+var _features = require("../../../loaders/features/features");
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -60,7 +61,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
           });
         }, this.featureName, this.ee);
       }
-      let addUserAction;
+      let addUserAction = () => {/** no-op */};
       if (_runtime.isBrowserScope && agentRef.init.user_actions.enabled) {
         this.userActionAggregator = new _userActionsAggregator.UserActionsAggregator();
         this.harvestOpts.beforeUnload = () => addUserAction?.(this.userActionAggregator.aggregationEvent);
@@ -86,20 +87,27 @@ class Aggregate extends _aggregateBase.AggregateBase {
                 ...((0, _iframe.isIFrameWindow)(window) && {
                   iframe: true
                 }),
-                ...(canTrustTargetAttribute('id') && {
-                  targetId: target.id
-                }),
-                ...(canTrustTargetAttribute('tagName') && {
-                  targetTag: target.tagName
-                }),
-                ...(canTrustTargetAttribute('type') && {
-                  targetType: target.type
-                }),
-                ...(canTrustTargetAttribute('className') && {
-                  targetClass: target.className
-                })
+                ...this.agentRef.init.user_actions.elementAttributes.reduce((acc, field) => {
+                  /** prevent us from capturing an obscenely long value */
+                  if (canTrustTargetAttribute(field)) acc[targetAttrName(field)] = String(target[field]).trim().slice(0, 128);
+                  return acc;
+                }, {}),
+                ...aggregatedUserAction.nearestTargetFields
               });
 
+              /**
+               * Returns the original target field name with `target` prepended and camelCased
+               * @param {string} originalFieldName
+               * @returns {string} the target field name
+               */
+              function targetAttrName(originalFieldName) {
+                /** preserve original renaming structure for pre-existing field maps */
+                if (originalFieldName === 'tagName') originalFieldName = 'tag';
+                if (originalFieldName === 'className') originalFieldName = 'class';
+                /** return the original field name, cap'd and prepended with target to match formatting */
+                return "target".concat(originalFieldName.charAt(0).toUpperCase() + originalFieldName.slice(1));
+              }
+
               /**
                * Only trust attributes that exist on HTML element targets, which excludes the window and the document targets
                * @param {string} attribute The attribute to check for on the target element
@@ -115,7 +123,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
         };
         (0, _registerHandler.registerHandler)('ua', evt => {
           /** the processor will return the previously aggregated event if it has been completed by processing the current event */
-          addUserAction(this.userActionAggregator.process(evt));
+          addUserAction(this.userActionAggregator.process(evt, this.agentRef.init.user_actions.elementAttributes));
         }, this.featureName, this.ee);
       }
 
@@ -134,7 +142,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
               const observer = new PerformanceObserver(list => {
                 list.getEntries().forEach(entry => {
                   try {
-                    (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, ['Generic/Performance/' + type + '/Seen']);
+                    (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, ['Generic/Performance/' + type + '/Seen'], undefined, _features.FEATURE_NAMES.metrics, this.ee);
                     const detailObj = agentRef.init.performance.capture_detail ? createDetailAttrs(entry.detail) : {};
                     this.addEvent({
                       ...detailObj,
@@ -196,12 +204,12 @@ class Aggregate extends _aggregateBase.AggregateBase {
               if (this.agentRef.init.performance.resources.asset_types.length && !this.agentRef.init.performance.resources.asset_types.includes(entryObject.initiatorType)) return;
               /** decide if the entryDomain is a first party domain */
               firstParty = entryDomain === _runtime.globalScope?.location.hostname || agentRef.init.performance.resources.first_party_domains.includes(entryDomain);
-              if (firstParty) (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, ['Generic/Performance/FirstPartyResource/Seen']);
-              if (isNr) (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, ['Generic/Performance/NrResource/Seen']);
+              if (firstParty) (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, ['Generic/Performance/FirstPartyResource/Seen'], undefined, _features.FEATURE_NAMES.metrics, this.ee);
+              if (isNr) (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, ['Generic/Performance/NrResource/Seen'], undefined, _features.FEATURE_NAMES.metrics, this.ee);
             } catch (err) {
               // couldnt parse the URL, so firstParty will just default to false
             }
-            (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, ['Generic/Performance/Resource/Seen']);
+            (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, ['Generic/Performance/Resource/Seen'], undefined, _features.FEATURE_NAMES.metrics, this.ee);
             const event = {
               ...entryObject,
               eventType: 'BrowserPerformance',
@@ -287,12 +295,12 @@ class Aggregate extends _aggregateBase.AggregateBase {
   trackSupportabilityMetrics() {
     /** track usage SMs to improve these experimental features */
     const configPerfTag = 'Config/Performance/';
-    if (this.agentRef.init.performance.capture_marks) (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, [configPerfTag + 'CaptureMarks/Enabled']);
-    if (this.agentRef.init.performance.capture_measures) (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, [configPerfTag + 'CaptureMeasures/Enabled']);
-    if (this.agentRef.init.performance.resources.enabled) (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, [configPerfTag + 'Resources/Enabled']);
-    if (this.agentRef.init.performance.resources.asset_types?.length !== 0) (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, [configPerfTag + 'Resources/AssetTypes/Changed']);
-    if (this.agentRef.init.performance.resources.first_party_domains?.length !== 0) (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, [configPerfTag + 'Resources/FirstPartyDomains/Changed']);
-    if (this.agentRef.init.performance.resources.ignore_newrelic === false) (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, [configPerfTag + 'Resources/IgnoreNewrelic/Changed']);
+    if (this.agentRef.init.performance.capture_marks) (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, [configPerfTag + 'CaptureMarks/Enabled'], undefined, _features.FEATURE_NAMES.metrics, this.ee);
+    if (this.agentRef.init.performance.capture_measures) (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, [configPerfTag + 'CaptureMeasures/Enabled'], undefined, _features.FEATURE_NAMES.metrics, this.ee);
+    if (this.agentRef.init.performance.resources.enabled) (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, [configPerfTag + 'Resources/Enabled'], undefined, _features.FEATURE_NAMES.metrics, this.ee);
+    if (this.agentRef.init.performance.resources.asset_types?.length !== 0) (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, [configPerfTag + 'Resources/AssetTypes/Changed'], undefined, _features.FEATURE_NAMES.metrics, this.ee);
+    if (this.agentRef.init.performance.resources.first_party_domains?.length !== 0) (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, [configPerfTag + 'Resources/FirstPartyDomains/Changed'], undefined, _features.FEATURE_NAMES.metrics, this.ee);
+    if (this.agentRef.init.performance.resources.ignore_newrelic === false) (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, [configPerfTag + 'Resources/IgnoreNewrelic/Changed'], undefined, _features.FEATURE_NAMES.metrics, this.ee);
   }
 }
 exports.Aggregate = Aggregate;

package/dist/cjs/features/generic_events/aggregate/user-actions/aggregated-user-action.js

@@ -11,13 +11,14 @@ var _constants = require("../../constants");
  */
 
 class AggregatedUserAction {
-  constructor(evt, selectorPath) {
+  constructor(evt, selectorPath, nearestTargetFields) {
     this.event = evt;
     this.count = 1;
     this.originMs = Math.floor(evt.timeStamp);
     this.relativeMs = [0];
     this.selectorPath = selectorPath;
     this.rageClick = undefined;
+    this.nearestTargetFields = nearestTargetFields;
   }
 
   /**

package/dist/cjs/features/generic_events/aggregate/user-actions/user-actions-aggregator.js

@@ -31,9 +31,12 @@ class UserActionsAggregator {
    * @param {Event} evt The event supplied by the addEventListener callback
    * @returns {AggregatedUserAction|undefined} The previous aggregation set if it has been completed by processing the current event
    */
-  process(evt) {
+  process(evt, targetFields) {
     if (!evt) return;
-    const selectorPath = getSelectorPath(evt);
+    const {
+      selectorPath,
+      nearestTargetFields
+    } = getSelectorPath(evt, targetFields);
     const aggregationKey = getAggregationKey(evt, selectorPath);
     if (!!aggregationKey && aggregationKey === this.#aggregationKey) {
       // an aggregation exists already, so lets just continue to increment
@@ -43,7 +46,7 @@ class UserActionsAggregator {
       const finishedEvent = this.#aggregationEvent;
       // then set as this new event aggregation
       this.#aggregationKey = aggregationKey;
-      this.#aggregationEvent = new _aggregatedUserAction.AggregatedUserAction(evt, selectorPath);
+      this.#aggregationEvent = new _aggregatedUserAction.AggregatedUserAction(evt, selectorPath, nearestTargetFields);
       return finishedEvent;
     }
   }
@@ -56,13 +59,24 @@ class UserActionsAggregator {
  * @returns {string}
  */
 exports.UserActionsAggregator = UserActionsAggregator;
-function getSelectorPath(evt) {
+function getSelectorPath(evt, targetFields) {
   let selectorPath;
+  let nearestTargetFields = {};
   if (_constants.OBSERVED_WINDOW_EVENTS.includes(evt.type) || evt.target === window) selectorPath = 'window';else if (evt.target === document) selectorPath = 'document';
   // if still no selectorPath, generate one from target tree that includes elem ids
-  else selectorPath = (0, _selectorPath.generateSelectorPath)(evt.target);
+  else {
+    const {
+      path,
+      nearestFields
+    } = (0, _selectorPath.generateSelectorPath)(evt.target, targetFields);
+    selectorPath = path;
+    nearestTargetFields = nearestFields;
+  }
   // if STILL no selectorPath, it will return undefined which will skip aggregation for this event
-  return selectorPath;
+  return {
+    selectorPath,
+    nearestTargetFields
+  };
 }
 
 /**

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

@@ -15,6 +15,7 @@ var _log = require("../shared/log");
 var _utils = require("../shared/utils");
 var _traverse = require("../../../common/util/traverse");
 var _agentConstants = require("../../../common/constants/agent-constants");
+var _features = require("../../../loaders/features/features");
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -59,17 +60,17 @@ class Aggregate extends _aggregateBase.AggregateBase {
     const failToHarvestMessage = 'Logging/Harvest/Failed/Seen';
     if (logBytes > _agentConstants.MAX_PAYLOAD_SIZE) {
       // cannot possibly send this, even with an empty buffer
-      (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, [failToHarvestMessage, logBytes]);
+      (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, [failToHarvestMessage, logBytes], undefined, _features.FEATURE_NAMES.metrics, this.ee);
       (0, _console.warn)(31, log.message.slice(0, 25) + '...');
       return;
     }
     if (this.events.wouldExceedMaxSize(logBytes)) {
-      (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['Logging/Harvest/Early/Seen', this.events.byteSize() + logBytes]);
+      (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['Logging/Harvest/Early/Seen', this.events.byteSize() + logBytes], undefined, _features.FEATURE_NAMES.metrics, this.ee);
       this.agentRef.runtime.harvester.triggerHarvestFor(this); // force a harvest synchronously to try adding again
     }
     if (!this.events.add(log)) {
       // still failed after a harvest attempt despite not being too large would mean harvest failed with options.retry
-      (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, [failToHarvestMessage, logBytes]);
+      (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, [failToHarvestMessage, logBytes], undefined, _features.FEATURE_NAMES.metrics, this.ee);
       (0, _console.warn)(31, log.message.slice(0, 25) + '...');
     }
   }

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

@@ -12,8 +12,8 @@ var _features = require("../../../loaders/features/features");
 var _aggregateBase = require("../../utils/aggregate-base");
 var _cumulativeLayoutShift = require("../../../common/vitals/cumulative-layout-shift");
 var _firstContentfulPaint = require("../../../common/vitals/first-contentful-paint");
+var _firstInputDelay = require("../../../common/vitals/first-input-delay");
 var _firstPaint = require("../../../common/vitals/first-paint");
-var _firstInteraction = require("../../../common/vitals/first-interaction");
 var _interactionToNextPaint = require("../../../common/vitals/interaction-to-next-paint");
 var _largestContentfulPaint = require("../../../common/vitals/largest-contentful-paint");
 var _timeToFirstByte = require("../../../common/vitals/time-to-first-byte");
@@ -42,8 +42,8 @@ class Aggregate extends _aggregateBase.AggregateBase {
     this.waitForFlags([]).then(() => {
       _firstPaint.firstPaint.subscribe(this.#handleVitalMetric);
       _firstContentfulPaint.firstContentfulPaint.subscribe(this.#handleVitalMetric);
+      _firstInputDelay.firstInputDelay.subscribe(this.#handleVitalMetric);
       _largestContentfulPaint.largestContentfulPaint.subscribe(this.#handleVitalMetric);
-      _firstInteraction.firstInteraction.subscribe(this.#handleVitalMetric);
       _interactionToNextPaint.interactionToNextPaint.subscribe(this.#handleVitalMetric);
       _timeToFirstByte.timeToFirstByte.subscribe(({
         attrs

package/dist/cjs/features/session_trace/aggregate/trace/storage.js

@@ -144,6 +144,13 @@ class TraceStorage {
     this.storeTiming({
       [name]: value
     });
+    if (hasFID(name, attrs)) this.storeEvent({
+      type: 'fid',
+      target: 'document'
+    }, 'document', value, value + attrs.fid);
+    function hasFID(name, attrs) {
+      return name === 'fi' && !!attrs && typeof attrs.fid === 'number';
+    }
   }
   storeTiming(timingEntry, isAbsoluteTimestamp = false) {
     if (!timingEntry) return;

package/dist/cjs/loaders/agent.js

@@ -35,10 +35,9 @@ var _runtime = require("../common/constants/runtime");
 class Agent extends _agentBase.AgentBase {
   /**
    * @param {Object} options Options to initialize agent with
-   * @param {string} [agentIdentifier] Optional identifier of agent
    */
-  constructor(options, agentIdentifier) {
-    super(agentIdentifier);
+  constructor(options) {
+    super();
     if (!_runtime.globalScope) {
       // We could not determine the runtime environment. Short-circuite the agent here
       // to avoid possible exceptions later that may cause issues with customer's application.

package/dist/cjs/loaders/micro-agent-base.js

@@ -13,8 +13,8 @@ var _uniqueId = require("../common/ids/unique-id");
 
 class MicroAgentBase {
   agentIdentifier;
-  constructor(agentIdentifier = (0, _uniqueId.generateRandomHexString)(16)) {
-    this.agentIdentifier = agentIdentifier;
+  constructor() {
+    this.agentIdentifier = (0, _uniqueId.generateRandomHexString)(16);
   }
 
   /**

package/dist/cjs/loaders/micro-agent.js

@@ -27,10 +27,9 @@ const nonAutoFeatures = [_features.FEATURE_NAMES.jserrors, _features.FEATURE_NAM
 class MicroAgent extends _microAgentBase.MicroAgentBase {
   /**
    * @param {Object} options - Specifies features and runtime configuration,
-   * @param {string=} agentIdentifier - The optional unique ID of the agent.
    */
-  constructor(options, agentIdentifier) {
-    super(agentIdentifier);
+  constructor(options) {
+    super();
     this.features = {};
     (0, _nreum.setNREUMInitializedAgent)(this.agentIdentifier, this);
     (0, _configure.configure)(this, {

package/dist/esm/common/config/init.js

@@ -202,7 +202,8 @@ const model = () => {
     },
     ssl: undefined,
     user_actions: {
-      enabled: true
+      enabled: true,
+      elementAttributes: ['id', 'className', 'tagName', 'type']
     }
   };
 };

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

@@ -11,7 +11,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.279.1";
+export const VERSION = "1.281.0";
 
 /**
  * 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.279.1";
+export const VERSION = "1.281.0";
 
 /**
  * Exposes the build type of the agent

package/dist/esm/common/dom/selector-path.js

@@ -10,8 +10,11 @@
  * @param {boolean} includeClass
  * @returns {string|undefined}
  */
-export const generateSelectorPath = elem => {
-  if (!elem) return;
+export const generateSelectorPath = (elem, targetFields = []) => {
+  if (!elem) return {
+    path: undefined,
+    nearestFields: {}
+  };
   const getNthOfTypeIndex = node => {
     try {
       let i = 1;
@@ -29,12 +32,16 @@ export const generateSelectorPath = elem => {
   };
   let pathSelector = '';
   let index = getNthOfTypeIndex(elem);
+  const nearestFields = {};
   try {
     while (elem?.tagName) {
       const {
         id,
         localName
       } = elem;
+      targetFields.forEach(field => {
+        nearestFields[nearestAttrName(field)] ||= elem[field];
+      });
       const selector = [localName, id ? "#".concat(id) : '', pathSelector ? ">".concat(pathSelector) : ''].join('');
       pathSelector = selector;
       elem = elem.parentNode;
@@ -42,5 +49,15 @@ export const generateSelectorPath = elem => {
   } catch (err) {
     // do nothing for now
   }
-  return pathSelector ? index ? "".concat(pathSelector, ":nth-of-type(").concat(index, ")") : pathSelector : undefined;
+  const path = pathSelector ? index ? "".concat(pathSelector, ":nth-of-type(").concat(index, ")") : pathSelector : undefined;
+  return {
+    path,
+    nearestFields
+  };
+  function nearestAttrName(originalFieldName) {
+    /** preserve original renaming structure for pre-existing field maps */
+    if (originalFieldName === 'tagName') originalFieldName = 'tag';
+    if (originalFieldName === 'className') originalFieldName = 'class';
+    return "nearest".concat(originalFieldName.charAt(0).toUpperCase() + originalFieldName.slice(1));
+  }
 };

package/dist/esm/common/vitals/constants.js

@@ -5,12 +5,9 @@
 export const VITAL_NAMES = {
   FIRST_PAINT: 'fp',
   FIRST_CONTENTFUL_PAINT: 'fcp',
-  FIRST_INTERACTION: 'fi',
+  FIRST_INPUT_DELAY: 'fi',
   LARGEST_CONTENTFUL_PAINT: 'lcp',
   CUMULATIVE_LAYOUT_SHIFT: 'cls',
   INTERACTION_TO_NEXT_PAINT: 'inp',
   TIME_TO_FIRST_BYTE: 'ttfb'
-};
-export const PERFORMANCE_ENTRY_TYPE = {
-  FIRST_INPUT: 'first-input'
 };

package/dist/esm/common/vitals/first-input-delay.js

@@ -0,0 +1,29 @@
+/**
+ * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { onFID } from 'web-vitals/attribution';
+import { VitalMetric } from './vital-metric';
+import { VITAL_NAMES } from './constants';
+import { initiallyHidden, isBrowserScope } from '../constants/runtime';
+export const firstInputDelay = new VitalMetric(VITAL_NAMES.FIRST_INPUT_DELAY);
+if (isBrowserScope) {
+  onFID(({
+    value,
+    attribution
+  }) => {
+    if (initiallyHidden || firstInputDelay.isValid) return;
+    const attrs = {
+      type: attribution.eventType,
+      fid: Math.round(value),
+      eventTarget: attribution.eventTarget,
+      loadState: attribution.loadState
+    };
+
+    // CWV will only report one (THE) first-input entry to us; fid isn't reported if there are no user interactions occurs before the *first* page hiding.
+    firstInputDelay.update({
+      value: attribution.eventTime,
+      attrs
+    });
+  });
+}