@newrelic/browser-agent 1.285.0 → 1.286.0

package/CHANGELOG.md

@@ -3,6 +3,21 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.286.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.285.0...v1.286.0) (2025-04-01)
+
+
+### Features
+
+* Erase .api property on agent instance ([#1425](https://github.com/newrelic/newrelic-browser-agent/issues/1425)) ([44786ae](https://github.com/newrelic/newrelic-browser-agent/commit/44786ae60d761b40a28f6df4b7b835c1791dda5f))
+* Handle duplicate agent APIs ([#1418](https://github.com/newrelic/newrelic-browser-agent/issues/1418)) ([f808447](https://github.com/newrelic/newrelic-browser-agent/commit/f8084474ea1a567a90d0615cdfeb13a8a2c1f110))
+* Reduce noise from `mousemove` events ([#1424](https://github.com/newrelic/newrelic-browser-agent/issues/1424)) ([7c02a02](https://github.com/newrelic/newrelic-browser-agent/commit/7c02a02763abdd2697e9ed1d5a89d81c251dcf67))
+
+
+### Bug Fixes
+
+* Get string className for SVG elements ([#1423](https://github.com/newrelic/newrelic-browser-agent/issues/1423)) ([0c1ce6c](https://github.com/newrelic/newrelic-browser-agent/commit/0c1ce6ca82bce15da12fe84fd91a7d6be8b4da44))
+* Patch `newrelic` event detail ([#1428](https://github.com/newrelic/newrelic-browser-agent/issues/1428)) ([8601424](https://github.com/newrelic/newrelic-browser-agent/commit/86014247ed45520adbbb053d94b6f11de48e239f))
+
 ## [1.285.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.284.1...v1.285.0) (2025-03-18)
 
 

package/README.md

@@ -1,5 +1,11 @@
 <a href="https://opensource.newrelic.com/oss-category/#community-plus"><picture><source media="(prefers-color-scheme: dark)" srcset="https://github.com/newrelic/opensource-website/raw/main/src/images/categories/dark/Community_Plus.png"><source media="(prefers-color-scheme: light)" srcset="https://github.com/newrelic/opensource-website/raw/main/src/images/categories/Community_Plus.png"><img alt="New Relic Open Source community plus project banner." src="https://github.com/newrelic/opensource-website/raw/main/src/images/categories/Community_Plus.png"></picture></a>
 
+### **Deployment status:**
+<img src="https://img.shields.io/endpoint?style=plastic&amp;url=https%3A%2F%2Fnewrelic.github.io%2Fnewrelic-browser-agent-release%2Fbadges%2Fcurrent-version-production.json">
+<img src="https://img.shields.io/endpoint?style=plastic&amp;url=https%3A%2F%2Fnewrelic.github.io%2Fnewrelic-browser-agent-release%2Fbadges%2Fcopy-paste-version-production.json">
+<img src="https://img.shields.io/endpoint?style=plastic&amp;url=https%3A%2F%2Fnewrelic.github.io%2Fnewrelic-browser-agent-release%2Fbadges%2Fgeneric-deploy-percent-production.json">
+
+
 # New Relic Browser Agent
 
 The New Relic browser agent instruments your web application or site and provides observability into performance, errors, and other behaviors.

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.285.0";
+const VERSION = exports.VERSION = "1.286.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.285.0";
+const VERSION = exports.VERSION = "1.286.0";
 
 /**
  * Exposes the build type of the agent

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

@@ -46,7 +46,7 @@ const generateSelectorPath = (elem, targetFields = []) => {
         localName
       } = elem;
       targetFields.forEach(field => {
-        nearestFields[nearestAttrName(field)] ||= elem[field];
+        nearestFields[nearestAttrName(field)] ||= elem[field]?.baseVal || elem[field];
       });
       const selector = [localName, id ? "#".concat(id) : '', pathSelector ? ">".concat(pathSelector) : ''].join('');
       pathSelector = selector;

package/dist/cjs/common/harvest/harvester.js

@@ -217,7 +217,7 @@ function send(agentRef, {
   }
   (0, _globalEvent.dispatchGlobalEvent)({
     agentIdentifier: agentRef.agentIdentifier,
-    loaded: !!_featureFlags.activatedFeatures?.[agentRef.agentIdentifier],
+    drained: !!_featureFlags.activatedFeatures?.[agentRef.agentIdentifier],
     type: 'data',
     name: 'harvest',
     feature: featureName,

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

@@ -33,10 +33,11 @@ function activateFeatures(flags, agentIdentifier) {
   activatedFeatures[agentIdentifier] = flags;
   sentIds.add(agentIdentifier);
 
-  // let any window level subscribers know that the agent is running
+  // let any window level subscribers know that the agent is running, per install docs
   (0, _globalEvent.dispatchGlobalEvent)({
     agentIdentifier,
     loaded: true,
+    drained: true,
     type: 'lifecycle',
     name: 'load',
     feature: undefined,

package/dist/cjs/features/session_replay/shared/recorder.js

@@ -16,6 +16,8 @@ var _features = require("../../../loaders/features/features");
 var _utils = require("./utils");
 var _agentConstants = require("../../../common/constants/agent-constants");
 var _aggregateBase = require("../../utils/aggregate-base");
+var _console = require("../../../common/util/console");
+var _invoke = require("../../../common/util/invoke");
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -30,6 +32,8 @@ class Recorder {
   #preloaded;
   /** flag that if true, blocks events from being "stored".  Only set to true when a full snapshot has incomplete nodes (only stylesheets ATM) */
   #fixing = false;
+  #warnCSSOnce = (0, _invoke.single)(() => (0, _console.warn)(47)); // notifies user of potential replayer issue if fix_stylesheets is off
+
   constructor(parent) {
     this.#events = new _recorderEvents.RecorderEvents();
     this.#backloggedEvents = new _recorderEvents.RecorderEvents();
@@ -131,6 +135,7 @@ class Recorder {
     if (!this.shouldFix) {
       if (incompletes > 0) {
         this.currentBufferTarget.inlinedAllStylesheets = false;
+        this.#warnCSSOnce();
         (0, _handle.handle)(_constants3.SUPPORTABILITY_METRIC_CHANNEL, [missingInlineSMTag + 'Skipped', incompletes], undefined, _features.FEATURE_NAMES.metrics, this.parent.ee);
       }
       return this.store(event, isCheckout);

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

@@ -22,7 +22,8 @@ const ignoredEvents = {
   // we find that certain events make the data too noisy to be useful
   global: {
     mouseup: true,
-    mousedown: true
+    mousedown: true,
+    mousemove: true
   },
   // certain events are present both in the window and in PVT metrics.  PVT metrics are prefered so the window events should be ignored
   window: {
@@ -184,8 +185,8 @@ class TraceStorage {
     this.storeSTN(evt);
   }
   shouldIgnoreEvent(event, target) {
-    const origin = (0, _eventOrigin.eventOrigin)(event.target, target, this.parent.ee);
     if (event.type in ignoredEvents.global) return true;
+    const origin = (0, _eventOrigin.eventOrigin)(event.target, target, this.parent.ee);
     if (!!ignoredEvents[origin] && ignoredEvents[origin].ignoreAll) return true;
     return !!(!!ignoredEvents[origin] && event.type in ignoredEvents[origin]);
   }

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

@@ -145,16 +145,14 @@ class AggregateBase extends _featureBase.FeatureBase {
       } catch (err) {
         // do nothing
       }
-      (0, _configure.configure)({
-        agentIdentifier: this.agentIdentifier
-      }, {
+      (0, _configure.configure)(existingAgent, {
         ...cdn,
         info: {
           ...cdn.info,
           jsAttributes
         },
         runtime: existingAgent.runtime
-      });
+      }, existingAgent.runtime.loaderType);
     }
   }
 

package/dist/cjs/features/utils/event-store-manager.js

@@ -58,7 +58,7 @@ class EventStoreManager {
   add(event, target) {
     (0, _globalEvent.dispatchGlobalEvent)({
       agentIdentifier: this.agentIdentifier,
-      loaded: !!_featureFlags.activatedFeatures?.[this.agentIdentifier],
+      drained: !!_featureFlags.activatedFeatures?.[this.agentIdentifier],
       type: 'data',
       name: 'buffer',
       feature: this.featureName,

package/dist/cjs/features/utils/nr1-debugger.js

@@ -13,7 +13,7 @@ var _nreum = require("../../common/window/nreum");
 const debugId = 1;
 const newrelic = (0, _nreum.gosCDN)();
 function debugNR1(agentIdentifier, location, event, otherprops = {}, debugName = 'SR') {
-  const api = agentIdentifier ? newrelic.initializedAgents[agentIdentifier].api.addPageAction : newrelic.addPageAction;
+  const api = agentIdentifier ? newrelic.initializedAgents[agentIdentifier].addPageAction : newrelic.addPageAction;
   let url;
   try {
     const locURL = new URL(window.location);

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

@@ -25,7 +25,7 @@ class AgentBase extends _microAgentBase.MicroAgentBase {
    * @param  {...any} args
    */
   #callMethod(methodName, ...args) {
-    if (typeof this.api?.[methodName] !== 'function') (0, _console.warn)(35, methodName);else return this.api[methodName](...args);
+    if (this[methodName] === AgentBase.prototype[methodName] || this[methodName] === _microAgentBase.MicroAgentBase.prototype[methodName]) (0, _console.warn)(35, methodName);else return this[methodName](...args);
   }
 
   /**

package/dist/cjs/loaders/agent.js

@@ -76,6 +76,9 @@ class Agent extends _agentBase.AgentBase {
       runtime: this.runtime
     };
   }
+  get api() {
+    return this;
+  }
   run() {
     // Attempt to initialize all the requested features (sequentially in prio order & synchronously), with any failure aborting the whole process.
     try {
@@ -103,7 +106,6 @@ class Agent extends _agentBase.AgentBase {
         this.features[featName].abortHandler?.();
       }
       const newrelic = (0, _nreum.gosNREUM)();
-      delete newrelic.initializedAgents[this.agentIdentifier]?.api; // prevent further calls to agent-specific APIs (see "configure.js")
       delete newrelic.initializedAgents[this.agentIdentifier]?.features; // GC mem used internally by features
       delete this.sharedAggregator;
       // Keep the initialized agent object with its configs for troubleshooting purposes.

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

@@ -7,12 +7,10 @@ exports.setAPI = setAPI;
 exports.setTopLevelCallers = setTopLevelCallers;
 var _features = require("../features/features");
 var _info = require("../../common/config/info");
-var _runtime = require("../../common/config/runtime");
 var _handle = require("../../common/event-emitter/handle");
-var _contextualEe = require("../../common/event-emitter/contextual-ee");
 var _drain = require("../../common/drain/drain");
 var _load = require("../../common/window/load");
-var _runtime2 = require("../../common/constants/runtime");
+var _runtime = require("../../common/constants/runtime");
 var _console = require("../../common/util/console");
 var _constants = require("../../features/metrics/constants");
 var _nreum = require("../../common/window/nreum");
@@ -37,41 +35,39 @@ function setTopLevelCallers() {
   });
   function caller(fnName, ...args) {
     let returnVals = [];
-    Object.values(nr.initializedAgents).forEach(val => {
-      if (!val || !val.api) {
+    Object.values(nr.initializedAgents).forEach(agt => {
+      if (!agt || !agt.runtime) {
         (0, _console.warn)(38, fnName);
-      } else if (val.exposed && val.api[fnName]) {
-        returnVals.push(val.api[fnName](...args));
+      } else if (agt.exposed && agt[fnName] && agt.runtime.loaderType !== 'micro-agent') {
+        returnVals.push(agt[fnName](...args));
       }
     });
-    return returnVals.length > 1 ? returnVals : returnVals[0];
+    return returnVals[0];
   }
 }
 const replayRunning = {};
-function setAPI(agentIdentifier, forceDrain, runSoftNavOverSpa = false) {
-  if (!forceDrain) (0, _drain.registerDrain)(agentIdentifier, 'api');
-  const apiInterface = {};
-  var instanceEE = _contextualEe.ee.get(agentIdentifier);
-  var tracerEE = instanceEE.get('tracer');
-  replayRunning[agentIdentifier] = _constants3.MODE.OFF;
-  instanceEE.on(_constants2.SR_EVENT_EMITTER_TYPES.REPLAY_RUNNING, isRunning => {
-    replayRunning[agentIdentifier] = isRunning;
+function setAPI(agent, forceDrain) {
+  if (!forceDrain) (0, _drain.registerDrain)(agent.agentIdentifier, 'api');
+  const tracerEE = agent.ee.get('tracer');
+  replayRunning[agent.agentIdentifier] = _constants3.MODE.OFF;
+  agent.ee.on(_constants2.SR_EVENT_EMITTER_TYPES.REPLAY_RUNNING, isRunning => {
+    replayRunning[agent.agentIdentifier] = isRunning;
   });
-  var prefix = 'api-';
-  var spaPrefix = prefix + 'ixn-';
-  apiInterface.log = function (message, {
+  const prefix = 'api-';
+  const spaPrefix = prefix + 'ixn-';
+  agent.log = function (message, {
     customAttributes = {},
     level = _constants4.LOG_LEVELS.INFO
   } = {}) {
-    (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['API/log/called'], undefined, _features.FEATURE_NAMES.metrics, instanceEE);
-    (0, _utils.bufferLog)(instanceEE, message, customAttributes, level);
+    (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['API/log/called'], undefined, _features.FEATURE_NAMES.metrics, agent.ee);
+    (0, _utils.bufferLog)(agent.ee, message, customAttributes, level);
   };
-  apiInterface.wrapLogger = (parent, functionName, {
+  agent.wrapLogger = (parent, functionName, {
     customAttributes = {},
     level = _constants4.LOG_LEVELS.INFO
   } = {}) => {
-    (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['API/wrapLogger/called'], undefined, _features.FEATURE_NAMES.metrics, instanceEE);
-    (0, _wrapLogger.wrapLogger)(instanceEE, parent, functionName, {
+    (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['API/wrapLogger/called'], undefined, _features.FEATURE_NAMES.metrics, agent.ee);
+    (0, _wrapLogger.wrapLogger)(agent.ee, parent, functionName, {
       customAttributes,
       level
     });
@@ -79,14 +75,14 @@ function setAPI(agentIdentifier, forceDrain, runSoftNavOverSpa = false) {
 
   // Setup stub functions that queue calls for later processing.
   _apiMethods.asyncApiMethods.forEach(fnName => {
-    apiInterface[fnName] = apiCall(prefix, fnName, true, 'api');
+    agent[fnName] = apiCall(prefix, fnName, true, 'api');
   });
-  apiInterface.addPageAction = apiCall(prefix, 'addPageAction', true, _features.FEATURE_NAMES.genericEvents);
-  apiInterface.recordCustomEvent = apiCall(prefix, 'recordCustomEvent', true, _features.FEATURE_NAMES.genericEvents);
-  apiInterface.setPageViewName = function (name, host) {
+  agent.addPageAction = apiCall(prefix, 'addPageAction', true, _features.FEATURE_NAMES.genericEvents);
+  agent.recordCustomEvent = apiCall(prefix, 'recordCustomEvent', true, _features.FEATURE_NAMES.genericEvents);
+  agent.setPageViewName = function (name, host) {
     if (typeof name !== 'string') return;
     if (name.charAt(0) !== '/') name = '/' + name;
-    (0, _runtime.getRuntime)(agentIdentifier).customTransaction = (host || 'http://custom.transaction') + name;
+    agent.runtime.customTransaction = (host || 'http://custom.transaction') + name;
     return apiCall(prefix, 'setPageViewName', true)();
   };
 
@@ -99,11 +95,11 @@ function setAPI(agentIdentifier, forceDrain, runSoftNavOverSpa = false) {
    * @returns @see apiCall
    */
   function appendJsAttribute(key, value, apiName, addToBrowserStorage) {
-    const currentInfo = (0, _info.getInfo)(agentIdentifier);
+    const currentInfo = agent.info;
     if (value === null) {
       delete currentInfo.jsAttributes[key];
     } else {
-      (0, _info.setInfo)(agentIdentifier, {
+      (0, _info.setInfo)(agent.agentIdentifier, {
         ...currentInfo,
         jsAttributes: {
           ...currentInfo.jsAttributes,
@@ -113,7 +109,7 @@ function setAPI(agentIdentifier, forceDrain, runSoftNavOverSpa = false) {
     }
     return apiCall(prefix, apiName, true, !!addToBrowserStorage || value === null ? 'session' : undefined)(key, value);
   }
-  apiInterface.setCustomAttribute = function (name, value, persistAttribute = false) {
+  agent.setCustomAttribute = function (name, value, persistAttribute = false) {
     if (typeof name !== 'string') {
       (0, _console.warn)(39, typeof name);
       return;
@@ -129,7 +125,7 @@ function setAPI(agentIdentifier, forceDrain, runSoftNavOverSpa = false) {
    * @param {string} value - unique user identifier; a null user id suggests none should exist
    * @returns @see apiCall
    */
-  apiInterface.setUserId = function (value) {
+  agent.setUserId = function (value) {
     if (!(typeof value === 'string' || value === null)) {
       (0, _console.warn)(41, typeof value);
       return;
@@ -142,30 +138,30 @@ function setAPI(agentIdentifier, forceDrain, runSoftNavOverSpa = false) {
    * @param {string|null} value - Application version -- if null, will "unset" the value
    * @returns @see apiCall
    */
-  apiInterface.setApplicationVersion = function (value) {
+  agent.setApplicationVersion = function (value) {
     if (!(typeof value === 'string' || value === null)) {
       (0, _console.warn)(42, typeof value);
       return;
     }
     return appendJsAttribute('application.version', value, 'setApplicationVersion', false);
   };
-  apiInterface.start = () => {
+  agent.start = () => {
     try {
-      (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['API/start/called'], undefined, _features.FEATURE_NAMES.metrics, instanceEE);
-      instanceEE.emit('manual-start-all');
+      (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['API/start/called'], undefined, _features.FEATURE_NAMES.metrics, agent.ee);
+      agent.ee.emit('manual-start-all');
     } catch (err) {
       (0, _console.warn)(23, err);
     }
   };
-  apiInterface[_constants2.SR_EVENT_EMITTER_TYPES.RECORD] = function () {
-    (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['API/recordReplay/called'], undefined, _features.FEATURE_NAMES.metrics, instanceEE);
-    (0, _handle.handle)(_constants2.SR_EVENT_EMITTER_TYPES.RECORD, [], undefined, _features.FEATURE_NAMES.sessionReplay, instanceEE);
+  agent[_constants2.SR_EVENT_EMITTER_TYPES.RECORD] = function () {
+    (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['API/recordReplay/called'], undefined, _features.FEATURE_NAMES.metrics, agent.ee);
+    (0, _handle.handle)(_constants2.SR_EVENT_EMITTER_TYPES.RECORD, [], undefined, _features.FEATURE_NAMES.sessionReplay, agent.ee);
   };
-  apiInterface[_constants2.SR_EVENT_EMITTER_TYPES.PAUSE] = function () {
-    (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['API/pauseReplay/called'], undefined, _features.FEATURE_NAMES.metrics, instanceEE);
-    (0, _handle.handle)(_constants2.SR_EVENT_EMITTER_TYPES.PAUSE, [], undefined, _features.FEATURE_NAMES.sessionReplay, instanceEE);
+  agent[_constants2.SR_EVENT_EMITTER_TYPES.PAUSE] = function () {
+    (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['API/pauseReplay/called'], undefined, _features.FEATURE_NAMES.metrics, agent.ee);
+    (0, _handle.handle)(_constants2.SR_EVENT_EMITTER_TYPES.PAUSE, [], undefined, _features.FEATURE_NAMES.sessionReplay, agent.ee);
   };
-  apiInterface.interaction = function (options) {
+  agent.interaction = function (options) {
     return new InteractionHandle().get(typeof options === 'object' ? options : {});
   };
   function InteractionHandle() {}
@@ -174,9 +170,9 @@ function setAPI(agentIdentifier, forceDrain, runSoftNavOverSpa = false) {
       var contextStore = {};
       var ixn = this;
       var hasCb = typeof cb === 'function';
-      (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['API/createTracer/called'], undefined, _features.FEATURE_NAMES.metrics, instanceEE);
+      (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['API/createTracer/called'], undefined, _features.FEATURE_NAMES.metrics, agent.ee);
       // Soft navigations won't support Tracer nodes, but this fn should still work the same otherwise (e.g., run the orig cb).
-      if (!runSoftNavOverSpa) (0, _handle.handle)(spaPrefix + 'tracer', [(0, _now.now)(), name, contextStore], ixn, _features.FEATURE_NAMES.spa, instanceEE);
+      if (!agent.runSoftNavOverSpa) (0, _handle.handle)(spaPrefix + 'tracer', [(0, _now.now)(), name, contextStore], ixn, _features.FEATURE_NAMES.spa, agent.ee);
       return function () {
         tracerEE.emit((hasCb ? '' : 'no-') + 'fn-start', [(0, _now.now)(), ixn, hasCb], contextStore);
         if (hasCb) {
@@ -195,15 +191,15 @@ function setAPI(agentIdentifier, forceDrain, runSoftNavOverSpa = false) {
     }
   };
   ['actionText', 'setName', 'setAttribute', 'save', 'ignore', 'onEnd', 'getContext', 'end', 'get'].forEach(name => {
-    InteractionApiProto[name] = apiCall(spaPrefix, name, undefined, runSoftNavOverSpa ? _features.FEATURE_NAMES.softNav : _features.FEATURE_NAMES.spa);
+    InteractionApiProto[name] = apiCall(spaPrefix, name, undefined, agent.runSoftNavOverSpa ? _features.FEATURE_NAMES.softNav : _features.FEATURE_NAMES.spa);
   });
-  apiInterface.setCurrentRouteName = runSoftNavOverSpa ? apiCall(spaPrefix, 'routeName', undefined, _features.FEATURE_NAMES.softNav) : apiCall(prefix, 'routeName', true, _features.FEATURE_NAMES.spa);
+  agent.setCurrentRouteName = agent.runSoftNavOverSpa ? apiCall(spaPrefix, 'routeName', undefined, _features.FEATURE_NAMES.softNav) : apiCall(prefix, 'routeName', true, _features.FEATURE_NAMES.spa);
   function apiCall(prefix, name, notSpa, bufferGroup) {
     return function () {
-      (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['API/' + name + '/called'], undefined, _features.FEATURE_NAMES.metrics, instanceEE);
+      (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['API/' + name + '/called'], undefined, _features.FEATURE_NAMES.metrics, agent.ee);
       (0, _globalEvent.dispatchGlobalEvent)({
-        agentIdentifier,
-        loaded: !!_featureFlags.activatedFeatures?.[agentIdentifier],
+        agentIdentifier: agent.agentIdentifier,
+        drained: !!_featureFlags.activatedFeatures?.[agent.agentIdentifier],
         type: 'data',
         name: 'api',
         feature: prefix + name,
@@ -212,30 +208,30 @@ function setAPI(agentIdentifier, forceDrain, runSoftNavOverSpa = false) {
           bufferGroup
         }
       });
-      if (bufferGroup) (0, _handle.handle)(prefix + name, [notSpa ? (0, _now.now)() : performance.now(), ...arguments], notSpa ? null : this, bufferGroup, instanceEE); // no bufferGroup means only the SM is emitted
+      if (bufferGroup) (0, _handle.handle)(prefix + name, [notSpa ? (0, _now.now)() : performance.now(), ...arguments], notSpa ? null : this, bufferGroup, agent.ee); // no bufferGroup means only the SM is emitted
       return notSpa ? undefined : this; // returns the InteractionHandle which allows these methods to be chained
     };
   }
-  apiInterface.noticeError = function (err, customAttributes) {
+  agent.noticeError = function (err, customAttributes) {
     if (typeof err === 'string') err = new Error(err);
-    (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['API/noticeError/called'], undefined, _features.FEATURE_NAMES.metrics, instanceEE);
-    (0, _handle.handle)('err', [err, (0, _now.now)(), false, customAttributes, !!replayRunning[agentIdentifier]], undefined, _features.FEATURE_NAMES.jserrors, instanceEE);
+    (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['API/noticeError/called'], undefined, _features.FEATURE_NAMES.metrics, agent.ee);
+    (0, _handle.handle)('err', [err, (0, _now.now)(), false, customAttributes, !!replayRunning[agent.agentIdentifier]], undefined, _features.FEATURE_NAMES.jserrors, agent.ee);
   };
 
   // theres no window.load event on non-browser scopes, lazy load immediately
-  if (!_runtime2.isBrowserScope) lazyLoad();
+  if (!_runtime.isBrowserScope) lazyLoad();
   // try to stay out of the way of the window.load event, lazy load once that has finished.
   else (0, _load.onWindowLoad)(() => lazyLoad(), true);
   function lazyLoad() {
     Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "async-api" */'./apiAsync'))).then(({
-      setAPI
+      setAsyncAPI
     }) => {
-      setAPI(agentIdentifier);
-      (0, _drain.drain)(agentIdentifier, 'api');
+      setAsyncAPI(agent);
+      (0, _drain.drain)(agent.agentIdentifier, 'api');
     }).catch(err => {
       (0, _console.warn)(27, err);
-      instanceEE.abort();
+      agent.ee.abort();
     });
   }
-  return apiInterface;
+  return true;
 }

package/dist/cjs/loaders/api/apiAsync.js

@@ -3,23 +3,20 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.setAPI = setAPI;
+exports.setAsyncAPI = setAsyncAPI;
 var _features = require("../features/features");
-var _runtime = require("../../common/config/runtime");
-var _contextualEe = require("../../common/event-emitter/contextual-ee");
 var _handle = require("../../common/event-emitter/handle");
 var _registerHandler = require("../../common/event-emitter/register-handler");
 var _invoke = require("../../common/util/invoke");
 var _constants = require("../../features/metrics/constants");
-var _runtime2 = require("../../common/constants/runtime");
+var _runtime = require("../../common/constants/runtime");
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
-function setAPI(agentIdentifier) {
-  var instanceEE = _contextualEe.ee.get(agentIdentifier);
-  var api = {
+function setAsyncAPI(agent) {
+  const api = {
     finished: (0, _invoke.single)(finished),
     setErrorHandler,
     addToTrace,
@@ -27,40 +24,40 @@ function setAPI(agentIdentifier) {
   };
 
   // Hook all of the api functions up to the queues/stubs created in loader/api.js
-  Object.entries(api).forEach(([fnName, fnCall]) => (0, _registerHandler.registerHandler)('api-' + fnName, fnCall, 'api', instanceEE));
+  Object.entries(api).forEach(([fnName, fnCall]) => (0, _registerHandler.registerHandler)('api-' + fnName, fnCall, 'api', agent.ee));
 
   // All API functions get passed the time they were called as their
   // first parameter. These functions can be called asynchronously.
 
   function finished(t, providedTime) {
-    var time = providedTime ? providedTime - _runtime2.originTime : t;
+    const time = providedTime ? providedTime - _runtime.originTime : t;
     (0, _handle.handle)(_constants.CUSTOM_METRIC_CHANNEL, ['finished', {
       time
-    }], undefined, _features.FEATURE_NAMES.metrics, instanceEE);
+    }], undefined, _features.FEATURE_NAMES.metrics, agent.ee);
     addToTrace(t, {
       name: 'finished',
-      start: time + _runtime2.originTime,
+      start: time + _runtime.originTime,
       origin: 'nr'
     });
-    (0, _handle.handle)('api-addPageAction', [time, 'finished'], undefined, _features.FEATURE_NAMES.genericEvents, instanceEE);
+    (0, _handle.handle)('api-addPageAction', [time, 'finished'], undefined, _features.FEATURE_NAMES.genericEvents, agent.ee);
   }
-  function addToTrace(t, evt) {
+  function addToTrace(_, evt) {
     if (!(evt && typeof evt === 'object' && evt.name && evt.start)) return;
-    var report = {
+    const report = {
       n: evt.name,
-      s: evt.start - _runtime2.originTime,
-      e: (evt.end || evt.start) - _runtime2.originTime,
+      s: evt.start - _runtime.originTime,
+      e: (evt.end || evt.start) - _runtime.originTime,
       o: evt.origin || '',
       t: 'api'
     };
-    (0, _handle.handle)('bstApi', [report], undefined, _features.FEATURE_NAMES.sessionTrace, instanceEE);
+    (0, _handle.handle)('bstApi', [report], undefined, _features.FEATURE_NAMES.sessionTrace, agent.ee);
   }
-  function setErrorHandler(t, handler) {
-    (0, _runtime.getRuntime)(agentIdentifier).onerror = handler;
+  function setErrorHandler(_, handler) {
+    agent.runtime.onerror = handler;
   }
-  var releaseCount = 0;
-  function addRelease(t, name, id) {
+  let releaseCount = 0;
+  function addRelease(_, name, id) {
     if (++releaseCount > 10) return;
-    (0, _runtime.getRuntime)(agentIdentifier).releaseIds[name.slice(-200)] = ('' + id).slice(-200);
+    agent.runtime.releaseIds[name.slice(-200)] = ('' + id).slice(-200);
   }
 }

package/dist/cjs/loaders/configure/configure.js

@@ -20,10 +20,11 @@ var _globalEvent = require("../../common/dispatch/global-event");
  * SPDX-License-Identifier: Apache-2.0
  */
 
-let alreadySetOnce = false; // the configure() function can run multiple times in agent lifecycle
+const alreadySetOnce = new Set(); // the configure() function can run multiple times in agent lifecycle for different agents
 
 /**
  * Sets or re-sets the agent's configuration values from global settings. This also attach those as properties to the agent instance.
+ * IMPORTANT: setNREUMInitializedAgent must be called on the agent prior to calling this function.
  */
 function configure(agent, opts = {}, loaderType, forceDrain) {
   // eslint-disable-next-line camelcase
@@ -51,9 +52,9 @@ function configure(agent, opts = {}, loaderType, forceDrain) {
     info.jsAttributes.isWorker = true;
   }
   (0, _info.setInfo)(agent.agentIdentifier, info);
-  const updatedInit = (0, _init.getConfiguration)(agent.agentIdentifier);
+  const updatedInit = agent.init;
   const internalTrafficList = [info.beacon, info.errorBeacon];
-  if (!alreadySetOnce) {
+  if (!alreadySetOnce.has(agent.agentIdentifier)) {
     if (updatedInit.proxy.assets) {
       (0, _publicPath.redefinePublicPath)(updatedInit.proxy.assets);
       internalTrafficList.push(updatedInit.proxy.assets);
@@ -68,23 +69,19 @@ function configure(agent, opts = {}, loaderType, forceDrain) {
   runtime.denyList = [...(updatedInit.ajax.deny_list || []), ...(updatedInit.ajax.block_internal ? internalTrafficList : [])];
   runtime.ptid = agent.agentIdentifier;
   (0, _runtime.setRuntime)(agent.agentIdentifier, runtime);
-  agent.ee = _contextualEe.ee.get(agent.agentIdentifier);
-  if (agent.api === undefined) agent.api = (0, _api.setAPI)(agent.agentIdentifier, forceDrain, agent.runSoftNavOverSpa);
-  if (agent.exposed === undefined) agent.exposed = exposed;
-  if (!alreadySetOnce) {
+  if (!alreadySetOnce.has(agent.agentIdentifier)) {
+    agent.ee = _contextualEe.ee.get(agent.agentIdentifier);
+    agent.exposed = exposed;
+    (0, _api.setAPI)(agent, forceDrain); // assign our API functions to the agent instance
+
     (0, _globalEvent.dispatchGlobalEvent)({
       agentIdentifier: agent.agentIdentifier,
-      loaded: !!_featureFlags.activatedFeatures?.[agent.agentIdentifier],
+      drained: !!_featureFlags.activatedFeatures?.[agent.agentIdentifier],
       type: 'lifecycle',
       name: 'initialize',
       feature: undefined,
-      data: {
-        init: updatedInit,
-        info,
-        loader_config,
-        runtime
-      }
+      data: agent.config
     });
   }
-  alreadySetOnce = true;
+  alreadySetOnce.add(agent.agentIdentifier);
 }

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

@@ -23,7 +23,7 @@ class MicroAgentBase {
    * @param  {...any} args
    */
   #callMethod(methodName, ...args) {
-    if (typeof this.api?.[methodName] !== 'function') (0, _console.warn)(35, methodName);else return this.api[methodName](...args);
+    if (this[methodName] === MicroAgentBase.prototype[methodName]) (0, _console.warn)(35, methodName);else return this[methodName](...args);
   }
 
   // MicroAgent class custom defines its own start

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

@@ -38,7 +38,6 @@ class MicroAgent extends _microAgentBase.MicroAgentBase {
         isolatedBacklog: true
       }
     }, options.loaderType || 'micro-agent');
-    Object.assign(this, this.api); // the APIs should be available at the class level for micro-agent
 
     /**
      * Starts a set of agent features if not running in "autoStart" mode
@@ -91,5 +90,8 @@ class MicroAgent extends _microAgentBase.MicroAgentBase {
       runtime: this.runtime
     };
   }
+  get api() {
+    return this;
+  }
 }
 exports.MicroAgent = MicroAgent;

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

@@ -11,7 +11,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.285.0";
+export const VERSION = "1.286.0";
 
 /**
  * Exposes the build type of the agent