@newrelic/browser-agent 1.310.1 → 1.311.0

package/dist/esm/common/session/session-entity.js

@@ -5,7 +5,6 @@
 import { generateRandomHexString } from '../ids/unique-id';
 import { warn } from '../util/console';
 import { stringify } from '../util/stringify';
-import { ee } from '../event-emitter/contextual-ee';
 import { Timer } from '../timer/timer';
 import { isBrowserScope } from '../constants/runtime';
 import { DEFAULT_EXPIRES_MS, DEFAULT_INACTIVE_MS, MODE, PREFIX, SESSION_EVENTS, SESSION_EVENT_TYPES } from './constants';
@@ -39,27 +38,27 @@ const model = {
 };
 export class SessionEntity {
   /**
-   * Create a self-managing Session Entity. This entity is scoped to the agent identifier which triggered it, allowing for multiple simultaneous session objects to exist.
+   * Create a self-managing Session Entity. This entity is scoped to the agent which triggered it, allowing for multiple simultaneous session objects to exist.
    * There is one "namespace" an agent can store data in LS -- NRBA_{key}. If there are two agents on one page, and they both use the same key, they could overwrite each other since they would both use the same namespace in LS by default.
    * The value can be overridden in the constructor, but will default to a unique 16 character hex string
    * expiresMs and inactiveMs are used to "expire" the session, but can be overridden in the constructor. Pass 0 to disable expiration timers.
    */
   constructor(opts) {
     const {
-      agentIdentifier,
+      agentRef,
       key,
       storage
     } = opts;
-    if (!agentIdentifier || !key || !storage) {
-      throw new Error("Missing required field(s):".concat(!agentIdentifier ? ' agentID' : '').concat(!key ? ' key' : '').concat(!storage ? ' storage' : ''));
+    if (!agentRef || !key || !storage) {
+      throw new Error("Missing required field(s):".concat(!agentRef ? ' agentRef' : '').concat(!key ? ' key' : '').concat(!storage ? ' storage' : ''));
     }
-    this.agentIdentifier = agentIdentifier;
+    this.agentRef = agentRef;
     this.storage = storage;
     this.state = {};
 
     // key is intended to act as the k=v pair
     this.key = key;
-    this.ee = ee.get(agentIdentifier);
+    this.ee = agentRef.ee;
     wrapEvents(this.ee);
     this.setup(opts);
 
@@ -247,7 +246,7 @@ export class SessionEntity {
       this.expiresTimer?.clear?.();
       delete this.isNew;
       this.setup({
-        agentIdentifier: this.agentIdentifier,
+        agentRef: this.agentRef,
         key: this.key,
         storage: this.storage,
         expiresMs: this.expiresMs,

package/dist/esm/common/util/console.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
  */
 
@@ -17,7 +17,6 @@ export function warn(code, secondary) {
   if (typeof console.debug !== 'function') return;
   console.debug("New Relic Warning: https://github.com/newrelic/newrelic-browser-agent/blob/main/docs/warning-codes.md#".concat(code), secondary);
   dispatchGlobalEvent({
-    agentIdentifier: null,
     drained: null,
     type: 'data',
     name: 'warn',

package/dist/esm/common/util/feature-flags.js

@@ -1,32 +1,23 @@
 /**
- * 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 { dispatchGlobalEvent } from '../dispatch/global-event';
-const sentIds = new Set();
-
-/** A map of feature flags and their values as provided by the rum call -- scoped by agent ID */
-export const activatedFeatures = {};
 
 /**
- * Sets the activatedFeatures object, dispatches the global loaded event,
+ * Sets the activatedFeatures on the agentRef, dispatches the global loaded event,
  * and emits the rumresp flag to features
  * @param {{[key:string]:number}} flags key-val pair of flag names and numeric
- * @param {string} agentIdentifier agent instance identifier
+ * @param {Object} agentRef agent reference
  * @returns {void}
  */
 export function activateFeatures(flags, agentRef) {
-  const agentIdentifier = agentRef.agentIdentifier;
-  activatedFeatures[agentIdentifier] ??= {};
-  if (!flags || typeof flags !== 'object') return;
-  if (sentIds.has(agentIdentifier)) return;
+  if (!flags || typeof flags !== 'object' || !!agentRef.runtime.activatedFeatures) return;
   agentRef.ee.emit('rumresp', [flags]);
-  activatedFeatures[agentIdentifier] = flags;
-  sentIds.add(agentIdentifier);
+  agentRef.runtime.activatedFeatures = flags;
 
   // let any window level subscribers know that the agent is running, per install docs
   dispatchGlobalEvent({
-    agentIdentifier,
     loaded: true,
     drained: true,
     type: 'lifecycle',

package/dist/esm/common/util/script-tracker.js

@@ -6,14 +6,22 @@
 import { globalScope } from '../constants/runtime';
 import { now } from '../timing/now';
 import { cleanURL } from '../url/clean-url';
-import { chrome, gecko } from './browser-stack-matchers';
+import { chrome, chromeEval, gecko } from './browser-stack-matchers';
 
 /**
  * @typedef {import('./register-api-types').RegisterAPITimings} RegisterAPITimings
  */
 
+/** export for testing purposes */
+export let thisFile;
+try {
+  thisFile = extractUrlsFromStack(getDeepStackTrace()).at(0);
+} catch (err) {
+  thisFile = extractUrlsFromStack(err).at(0);
+}
+
 /** @type {(entry: PerformanceEntry) => boolean} - A shared function to determine if a performance entry is a valid script or link resource for evaluation */
-const validEntryCriteria = entry => entry.initiatorType === 'script' || entry.initiatorType === 'link' && entry.name.endsWith('.js');
+const validEntryCriteria = entry => entry.initiatorType === 'script' || ['link', 'fetch'].includes(entry.initiatorType) && entry.name.endsWith('.js');
 
 /** @type {Set<PerformanceResourceTiming>} - A set of resource timing objects that are "valid" -- see "validEntryCriteria" */
 const scripts = new Set();
@@ -57,9 +65,15 @@ function extractUrlsFromStack(stack) {
   const lines = stack.split('\n');
   for (const line of lines) {
     // Try gecko format first, then chrome
-    const parts = line.match(gecko) || line.match(chrome);
+    const parts = line.match(gecko) || line.match(chrome) || line.match(chromeEval);
     if (parts && parts[2]) {
       urls.add(cleanURL(parts[2]));
+    } else {
+      // Fallback: match URLs using a generic .js pattern (non-greedy to handle ports and query params)
+      const fallbackMatch = line.match(/\(([^)]+\.js):\d+:\d+\)/) || line.match(/^\s+at\s+([^\s(]+\.js):\d+:\d+/);
+      if (fallbackMatch && fallbackMatch[1]) {
+        urls.add(cleanURL(fallbackMatch[1]));
+      }
     }
   }
   return [...urls];
@@ -116,9 +130,11 @@ export function findScriptTimings() {
   };
   const stack = getDeepStackTrace();
   if (!stack) return timings;
-  const navUrl = globalScope.performance?.getEntriesByType('navigation')?.find(entry => entry.initiatorType === 'navigation')?.name || '';
+  const navUrl = globalScope.performance?.getEntriesByType('navigation')?.[0]?.name || '';
   try {
-    const mfeScriptUrl = extractUrlsFromStack(stack).at(-1); // array of URLs from the stack of the register API caller, the MFE script should be at the bottom
+    const urls = extractUrlsFromStack(stack);
+    /** if there is exactly one url, this means the MFE script is running in the same file as the agent.  Otherwise, lets strip away the known agent file from any other file lines */
+    const mfeScriptUrl = (urls.length > 1 ? urls.filter(line => !thisFile.endsWith(line) && !line.endsWith(thisFile)) : urls).at(0);
     if (!mfeScriptUrl) return timings;
     if (navUrl.includes(mfeScriptUrl)) {
       // this means the stack is indicating that the registration came from an inline script or eval, so we won't find a matching script resource - return early with just the URL
@@ -138,6 +154,7 @@ export function findScriptTimings() {
       if (wasPreloaded(mfeScriptUrl)) {
         timings.asset = mfeScriptUrl;
         timings.type = 'preload';
+
         // wait for a late PO callback...  The timings object can be mutated after the fact since we return a pointer and not a cloned object
         poSubscribers.push({
           addedAt: now(),

package/dist/esm/common/util/stringify.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
  */
 
@@ -7,17 +7,32 @@ import { ee } from '../event-emitter/contextual-ee';
 
 /**
  * Returns a function for use as a replacer parameter in JSON.stringify() to handle circular references.
+ * Uses an array to track the current ancestor chain, allowing the same object to appear
+ * multiple times in the structure as long as it's not a circular reference.
  * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Errors/Cyclic_object_value MDN - Cyclical object value}
- * @returns {Function} A function that filters out values it has seen before.
+ * @returns {Function} A function that filters out circular references while allowing duplicate references.
  */
 const getCircularReplacer = () => {
-  const seen = new WeakSet();
-  return (key, value) => {
-    if (typeof value === 'object' && value !== null) {
-      if (seen.has(value)) {
+  const stack = [];
+  return function (key, value) {
+    if (stack.length > 0) {
+      // Find where we are in the stack
+      const thisPos = stack.indexOf(this);
+      if (~thisPos) {
+        // We're still in the stack, trim it
+        stack.splice(thisPos + 1);
+      } else {
+        // We're not in the stack, add ourselves
+        stack.push(this);
+      }
+
+      // Check if value is in the current ancestor chain
+      if (~stack.indexOf(value)) {
         return;
       }
-      seen.add(value);
+    } else {
+      // First call, initialize with root
+      stack.push(value);
     }
     return value;
   };

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

@@ -30,7 +30,6 @@ if (isBrowserScope) {
       if (lcpEntry.element?.tagName) attrs.elTag = lcpEntry.element.tagName;
     }
     if (attribution.element) attrs.element = attribution.element;
-    if (attribution.navigationEntry) attrs.pageUrl = cleanURL(attribution.navigationEntry.name); // used to ensure the LCP gets the correct URL at harvest time if a soft nav has occurred before page load
     if (attribution.url) attrs.elUrl = cleanURL(attribution.url);
     largestContentfulPaint.update({
       value,

package/dist/esm/common/vitals/load-time.js

@@ -1,8 +1,8 @@
 /**
- * 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 { globalScope, isBrowserScope, originTime, supportsNavTimingL2 } from '../constants/runtime';
+import { globalScope, isBrowserScope, originTime, getNavigationEntry } from '../constants/runtime';
 import { onWindowLoad } from '../window/load';
 import { VITAL_NAMES } from './constants';
 import { VitalMetric } from './vital-metric';
@@ -11,8 +11,9 @@ if (isBrowserScope) {
   const perf = globalScope.performance;
   const handler = () => {
     if (!loadTime.isValid && perf) {
+      const navEntry = getNavigationEntry();
       loadTime.update({
-        value: supportsNavTimingL2() ? perf.getEntriesByType('navigation')?.[0]?.loadEventEnd : perf.timing?.loadEventEnd - originTime
+        value: navEntry ? navEntry.loadEventEnd : perf.timing?.loadEventEnd - originTime
       });
     }
   };

package/dist/esm/common/vitals/time-to-first-byte.js

@@ -1,8 +1,8 @@
 /**
- * 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 { globalScope, isBrowserScope, isiOS, originTime, supportsNavTimingL2 } from '../constants/runtime';
+import { globalScope, isBrowserScope, isiOS, originTime, getNavigationEntry } from '../constants/runtime';
 import { VITAL_NAMES } from './constants';
 import { VitalMetric } from './vital-metric';
 import { onTTFB } from 'web-vitals/attribution';
@@ -16,7 +16,7 @@ export const timeToFirstByte = new VitalMetric(VITAL_NAMES.TIME_TO_FIRST_BYTE);
  * - cross-origin iframes specifically in firefox and safari
  * - onTTFB relies on a truthy `responseStart` value, should ensure that exists before relying on it (seen to be falsy in certain Electron.js cases for instance)
  */
-if (isBrowserScope && supportsNavTimingL2() && !isiOS && window === window.parent) {
+if (isBrowserScope && getNavigationEntry() && !isiOS && window === window.parent) {
   onTTFB(({
     value,
     attribution

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

@@ -175,10 +175,6 @@ export class Aggregate extends AggregateBase {
     if (!target) handle('trace-jserror', jsErrorEvent, undefined, FEATURE_NAMES.sessionTrace, this.ee);
     // still send EE events for other features such as above, but stop this one from aggregating internal data
     if (this.blocked) return;
-    if (err.__newrelic?.[this.agentIdentifier]) {
-      params._interactionId = err.__newrelic[this.agentIdentifier].interactionId;
-      params._interactionNodeId = err.__newrelic[this.agentIdentifier].interactionNodeId;
-    }
     if (err.__newrelic?.socketId) {
       customAttributes.socketId = err.__newrelic.socketId;
     }

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

@@ -2,7 +2,7 @@
  * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { globalScope, isBrowserScope, originTime, supportsNavTimingL2 } from '../../../common/constants/runtime';
+import { globalScope, isBrowserScope, originTime, getNavigationEntry } from '../../../common/constants/runtime';
 import { addPT, addPN } from '../../../common/timing/nav-timing';
 import { stringify } from '../../../common/util/stringify';
 import { isValid } from '../../../common/config/info';
@@ -75,7 +75,7 @@ export class Aggregate extends AggregateBase {
       us: info.user,
       ac: info.account,
       pr: info.product,
-      af: getActivatedFeaturesFlags(this.agentIdentifier).join(','),
+      af: getActivatedFeaturesFlags(this.agentRef).join(','),
       ...measures,
       xx: info.extra,
       ua: info.userAttributes,
@@ -90,9 +90,9 @@ export class Aggregate extends AggregateBase {
       }
     }, this.obfuscator.obfuscateString.bind(this.obfuscator), 'string');
     if (globalScope.performance) {
-      if (supportsNavTimingL2()) {
+      const navTimingEntry = getNavigationEntry();
+      if (navTimingEntry) {
         // Navigation Timing level 2 API that replaced PerformanceTiming & PerformanceNavigation
-        const navTimingEntry = globalScope?.performance?.getEntriesByType('navigation')?.[0];
         const perf = {
           timing: addPT(originTime, navTimingEntry, {}),
           navigation: addPN(navTimingEntry, {})

package/dist/esm/features/page_view_event/aggregate/initialized-features.js

@@ -3,19 +3,17 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { FEATURE_NAMES } from '../../../loaders/features/features';
-import { gosNREUM } from '../../../common/window/nreum';
 
 /**
  * Get an array of flags required by downstream (NR UI) based on the features initialized in this agent
  * (aka what is running on the page).
- * @param {String} agentId - the ID of the initialized agent on the page, mapping to the one under the global 'newrelic' object
+ * @param {Object} agentRef - the agent reference object
  * @returns {String[]} Up to 5 short strings corresponding to ingest mapping of features.
  */
-export function getActivatedFeaturesFlags(agentId) {
+export function getActivatedFeaturesFlags(agentRef) {
   const flagArr = [];
-  const newrelic = gosNREUM();
   try {
-    Object.keys(newrelic.initializedAgents[agentId].features).forEach(featName => {
+    Object.keys(agentRef.features || {}).forEach(featName => {
       switch (featName) {
         case FEATURE_NAMES.ajax:
           flagArr.push('xhr');

package/dist/esm/features/page_view_event/instrument/index.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 { setupSetPageViewNameAPI } from '../../../loaders/api/setPageViewName';
@@ -14,17 +14,16 @@ export class Instrument extends InstrumentBase {
     super(agentRef, CONSTANTS.FEATURE_NAME);
 
     /** setup inspection events for window lifecycle */
-    this.setupInspectionEvents(agentRef.agentIdentifier);
+    this.setupInspectionEvents();
 
     /** feature specific APIs */
     setupSetPageViewNameAPI(agentRef);
     this.importAggregator(agentRef, () => import(/* webpackChunkName: "page_view_event-aggregate" */'../aggregate'));
   }
-  setupInspectionEvents(agentIdentifier) {
+  setupInspectionEvents() {
     const dispatch = (evt, name) => {
       if (!evt) return;
       dispatchGlobalEvent({
-        agentIdentifier,
         timeStamp: evt.timeStamp,
         loaded: evt.target.readyState === 'complete',
         type: 'window',
@@ -43,7 +42,6 @@ export class Instrument extends InstrumentBase {
     });
     this.ee.on(SESSION_EVENTS.UPDATE, (_, data) => {
       dispatchGlobalEvent({
-        agentIdentifier,
         type: 'lifecycle',
         name: 'session',
         data

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

@@ -16,10 +16,11 @@ import { interactionToNextPaint } from '../../../common/vitals/interaction-to-ne
 import { largestContentfulPaint } from '../../../common/vitals/largest-contentful-paint';
 import { subscribeToVisibilityChange } from '../../../common/window/page-visibility';
 import { VITAL_NAMES } from '../../../common/vitals/constants';
-import { initiallyHidden } from '../../../common/constants/runtime';
+import { initiallyHidden, getNavigationEntry, initialLocation } from '../../../common/constants/runtime';
 import { eventOrigin } from '../../../common/util/event-origin';
 import { loadTime } from '../../../common/vitals/load-time';
 import { webdriverDetected } from '../../../common/util/webdriver-detection';
+import { cleanURL } from '../../../common/url/clean-url';
 export class Aggregate extends AggregateBase {
   static featureName = FEATURE_NAME;
   #handleVitalMetric = ({
@@ -78,6 +79,7 @@ export class Aggregate extends AggregateBase {
   }
   addTiming(name, value, attrs) {
     attrs = attrs || {};
+    attrs.pageUrl = cleanURL(getNavigationEntry()?.name || initialLocation);
     addConnectionAttributes(attrs); // network conditions may differ from the actual for VitalMetrics when they were captured
 
     // If cls was set to another value by `onCLS`, then it's supported and is attached onto any timing but is omitted until such time.

package/dist/esm/features/session_trace/aggregate/index.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 { registerHandler } from '../../../common/event-emitter/register-handler';
@@ -7,7 +7,7 @@ import { FEATURE_NAME } from '../constants';
 import { AggregateBase } from '../../utils/aggregate-base';
 import { TraceStorage } from './trace/storage';
 import { obj as encodeObj } from '../../../common/url/encode';
-import { globalScope, supportsNavTimingL2 } from '../../../common/constants/runtime';
+import { globalScope, getNavigationEntry } from '../../../common/constants/runtime';
 import { MODE, SESSION_EVENTS } from '../../../common/session/constants';
 import { applyFnToProps } from '../../../common/util/traverse';
 import { cleanURL } from '../../../common/url/clean-url';
@@ -58,8 +58,9 @@ export class Aggregate extends AggregateBase {
         // if another page's session entity has expired, or another page has transitioned to off and this one hasn't... we can just abort straight away here
         if (this.sessionId !== sessionState.value || eventType === 'cross-tab' && sessionState.sessionTraceMode === MODE.OFF) this.abort(2);
       });
-      if (supportsNavTimingL2()) {
-        this.traceStorage.storeTiming(globalScope.performance?.getEntriesByType?.('navigation')[0]);
+      const navEntry = getNavigationEntry();
+      if (navEntry) {
+        this.traceStorage.storeTiming(navEntry);
       } else {
         this.traceStorage.storeTiming(globalScope.performance?.timing, true);
       }

package/dist/esm/features/utils/agent-session.js

@@ -3,7 +3,6 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { drain } from '../../common/drain/drain';
-import { ee } from '../../common/event-emitter/contextual-ee';
 import { registerHandler } from '../../common/event-emitter/register-handler';
 import { SessionEntity } from '../../common/session/session-entity';
 import { LocalStorage } from '../../common/storage/local-storage.js';
@@ -20,7 +19,7 @@ export function setupAgentSession(agentRef) {
 
   const sessionInit = agentRef.init.session;
   agentRef.runtime.session = new SessionEntity({
-    agentIdentifier: agentRef.agentIdentifier,
+    agentRef,
     key: DEFAULT_KEY,
     storage: new LocalStorage(),
     expiresMs: sessionInit?.expiresMs,
@@ -42,7 +41,7 @@ export function setupAgentSession(agentRef) {
 
   /** track changes to the jsAttributes field over time for aiding with harvest mechanics */
   agentRef.runtime.jsAttributesMetadata = trackObjectAttributeSize(agentRef.info, 'jsAttributes');
-  const sharedEE = ee.get(agentRef.agentIdentifier);
+  const sharedEE = agentRef.ee;
 
   // any calls to newrelic.setCustomAttribute(<persisted>) will need to be added to:
   // local info.jsAttributes {}
@@ -67,6 +66,6 @@ export function setupAgentSession(agentRef) {
       consent: accept === undefined ? true : accept
     });
   }, 'session', sharedEE);
-  drain(agentRef.agentIdentifier, 'session');
+  drain(agentRef, 'session');
   return agentRef.runtime.session;
 }

package/dist/esm/features/utils/aggregate-base.js

@@ -7,7 +7,6 @@ import { isValid } from '../../common/config/info';
 import { configure } from '../../loaders/configure/configure';
 import { gosCDN } from '../../common/window/nreum';
 import { drain } from '../../common/drain/drain';
-import { activatedFeatures } from '../../common/util/feature-flags';
 import { Obfuscator } from '../../common/util/obfuscate';
 import { FEATURE_NAMES } from '../../loaders/features/features';
 import { Harvester } from '../../common/harvest/harvester';
@@ -23,8 +22,7 @@ export class AggregateBase extends FeatureBase {
    * @param {string} featureName The name of the feature creating the instance.
    */
   constructor(agentRef, featureName) {
-    super(agentRef.agentIdentifier, featureName);
-    this.agentRef = agentRef;
+    super(agentRef, featureName);
     this.checkConfiguration(agentRef);
     this.doOnceForAllAggregate(agentRef);
 
@@ -108,8 +106,8 @@ export class AggregateBase extends FeatureBase {
    */
   waitForFlags(flagNames = []) {
     const flagsPromise = new Promise((resolve, reject) => {
-      if (activatedFeatures[this.agentIdentifier]) {
-        resolve(buildOutput(activatedFeatures[this.agentIdentifier]));
+      if (this.agentRef.runtime?.activatedFeatures) {
+        resolve(buildOutput(this.agentRef.runtime.activatedFeatures));
       } else {
         this.ee.on('rumresp', (resp = {}) => {
           resolve(buildOutput(resp));
@@ -133,7 +131,7 @@ export class AggregateBase extends FeatureBase {
    * Stages the feature to be drained
    */
   drain() {
-    drain(this.agentIdentifier, this.featureName);
+    drain(this.agentRef, this.featureName);
   }
   preHarvestChecks(opts) {
     return !this.blocked && !this.ee.aborted;

package/dist/esm/features/utils/feature-base.js

@@ -1,15 +1,14 @@
 /**
- * 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 { ee } from '../../common/event-emitter/contextual-ee';
 import { deregisterDrain } from '../../common/drain/drain';
 export class FeatureBase {
-  constructor(agentIdentifier, featureName) {
-    /** @type {string} */
-    this.agentIdentifier = agentIdentifier;
+  constructor(agentRef, featureName) {
+    /** @type {Object} */
+    this.agentRef = agentRef;
     /** @type {import('../../common/event-emitter/contextual-ee').ee} */
-    this.ee = ee.get(agentIdentifier);
+    this.ee = agentRef?.ee;
     /** @type {string} */
     this.featureName = featureName;
     /**
@@ -20,6 +19,6 @@ export class FeatureBase {
     this.blocked = false;
   }
   deregisterDrain() {
-    deregisterDrain(this.agentIdentifier, this.featureName);
+    deregisterDrain(this.agentRef, this.featureName);
   }
 }

package/dist/esm/features/utils/instrument-base.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
  */
 
@@ -28,12 +28,11 @@ import { handle } from '../../common/event-emitter/handle';
 export class InstrumentBase extends FeatureBase {
   /**
    * Instantiate InstrumentBase.
-   * @param {string} agentIdentifier - The unique ID of the instantiated agent (relative to global scope).
+   * @param {Object} agentRef - The agent reference object.
    * @param {string} featureName - The name of the feature module (used to construct file path).
    */
   constructor(agentRef, featureName) {
-    super(agentRef.agentIdentifier, featureName);
-    this.agentRef = agentRef;
+    super(agentRef, featureName);
 
     /** @type {Function | undefined} This should be set by any derived Instrument class if it has things to do when feature fails or is killed. */
     this.abortHandler = undefined;
@@ -63,13 +62,13 @@ export class InstrumentBase extends FeatureBase {
         this.ee.on('manual-start-all', single(() => {
           // register the feature to drain only once the API has been called, it will drain when importAggregator finishes for all the features
           // called by the api in that cycle
-          registerDrain(agentRef.agentIdentifier, this.featureName);
+          registerDrain(agentRef, this.featureName);
           resolve();
         }));
       });
     } else {
       /** if the feature requires opt-in (!auto-start), it will get registered once the api has been called */
-      registerDrain(agentRef.agentIdentifier, featureName);
+      registerDrain(agentRef, featureName);
     }
   }
 
@@ -109,7 +108,7 @@ export class InstrumentBase extends FeatureBase {
        */
       try {
         if (!this.#shouldImportAgg(this.featureName, session, agentRef.init)) {
-          drain(this.agentIdentifier, this.featureName);
+          drain(this.agentRef, this.featureName);
           this.loadedSuccessfully(false); // aggregate module isn't loaded at all
           return;
         }
@@ -123,7 +122,7 @@ export class InstrumentBase extends FeatureBase {
         warn(34, e);
         this.abortHandler?.(); // undo any important alterations made to the page
         // not supported yet but nice to do: "abort" this agent's EE for this feature specifically
-        drain(this.agentIdentifier, this.featureName, true);
+        drain(this.agentRef, this.featureName, true);
         this.loadedSuccessfully(false);
         if (this.ee) this.ee.abort();
       }

package/dist/esm/loaders/api/register-api-types.js

@@ -20,7 +20,7 @@
 
 /**
  * @typedef {Object} RegisterAPIConstructor
- * @property {string|number} id - The unique id for the registered entity. This will be assigned to any synthesized entities.
+ * @property {string} id - The unique id for the registered entity. This will be assigned to any synthesized entities.
  * @property {string} name - The readable name for the registered entity. This will be assigned to any synthesized entities.
  * @property {{[key: string]: any}} [tags] - The tags for the registered entity as key-value pairs. This will be assigned to any synthesized entities. Tags are converted to source.* attributes (e.g., {environment: 'production'} becomes source.environment: 'production').
  * @property {boolean} [isolated] - When true, each registration creates an isolated instance. When false, multiple registrations with the same id and isolated: false will share a single instance, including all custom attributes, ids, names, and metadata. Calling deregister on a shared instance will deregister it for all entities using the instance. Defaults to true.

package/dist/esm/loaders/api/register.js

@@ -88,7 +88,7 @@ function register(agentRef, target, parent) {
     invalidApiResponse = warning;
   };
   function hasValidValue(val) {
-    return typeof val === 'string' && !!val.trim() && val.trim().length < 501 || typeof val === 'number';
+    return typeof val === 'string' && !!val.trim() && val.trim().length < 501;
   }
 
   /** primary cases that can block the register API from working at init time */

package/dist/esm/loaders/api/sharedHandlers.js

@@ -1,12 +1,11 @@
 /**
- * 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 { dispatchGlobalEvent } from '../../common/dispatch/global-event';
 import { handle } from '../../common/event-emitter/handle';
 import { now } from '../../common/timing/now';
 import { warn } from '../../common/util/console';
-import { activatedFeatures } from '../../common/util/feature-flags';
 import { SUPPORTABILITY_METRIC_CHANNEL } from '../../features/metrics/constants';
 import { AgentBase } from '../agent-base';
 import { FEATURE_NAMES } from '../features/features';
@@ -28,8 +27,7 @@ export function setupAPI(name, fn, agent, obj) {
   api[name] = function () {
     handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/' + name + '/called'], undefined, FEATURE_NAMES.metrics, agent.ee);
     dispatchGlobalEvent({
-      agentIdentifier: agent.agentIdentifier,
-      drained: !!activatedFeatures?.[agent.agentIdentifier],
+      drained: !!agent.runtime?.activatedFeatures,
       type: 'data',
       name: 'api',
       feature: prefix + name,