@newrelic/browser-agent 1.285.0 → 1.286.0

package/dist/types/loaders/configure/configure.d.ts

@@ -1,5 +1,6 @@
 /**
  * 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.
  */
 export function configure(agent: any, opts: {} | undefined, loaderType: any, forceDrain: any): void;
 //# sourceMappingURL=configure.d.ts.map

package/dist/types/loaders/configure/configure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../../../../src/loaders/configure/configure.js"],"names":[],"mappings":"AAkBA;;GAEG;AACH,oGA+DC"}
+{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../../../../src/loaders/configure/configure.js"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,oGA8DC"}

package/dist/types/loaders/micro-agent.d.ts

@@ -21,6 +21,7 @@ export class MicroAgent extends MicroAgentBase {
         loader_config: any;
         runtime: any;
     };
+    get api(): this;
 }
 import { MicroAgentBase } from './micro-agent-base';
 //# sourceMappingURL=micro-agent.d.ts.map

package/dist/types/loaders/micro-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"micro-agent.d.ts","sourceRoot":"","sources":["../../../src/loaders/micro-agent.js"],"names":[],"mappings":"AAsBA;;;;GAIG;AACH;IACE;;OAEG;IACH,qBAFW,OAAO,SAAS,EAAE,YAAY,EAsDxC;IAjDC,aAAkB;IAMlB;;;;OAIG;IACH,uBAFW,MAAM,GAAC,MAAM,EAAE,aAqCzB;IAKH;;;;;MAOC;CACF;+BAhF8B,oBAAoB"}
+{"version":3,"file":"micro-agent.d.ts","sourceRoot":"","sources":["../../../src/loaders/micro-agent.js"],"names":[],"mappings":"AAsBA;;;;GAIG;AACH;IACE;;OAEG;IACH,qBAFW,OAAO,SAAS,EAAE,YAAY,EAqDxC;IAhDC,aAAkB;IAKlB;;;;OAIG;IACH,uBAFW,MAAM,GAAC,MAAM,EAAE,aAqCzB;IAKH;;;;;MAOC;IAED,gBAEC;CACF;+BAnF8B,oBAAoB"}

package/package.json

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

package/src/common/dom/selector-path.js

@@ -34,9 +34,7 @@ export const generateSelectorPath = (elem, targetFields = []) => {
   try {
     while (elem?.tagName) {
       const { id, localName } = elem
-      targetFields.forEach(field => {
-        nearestFields[nearestAttrName(field)] ||= elem[field]
-      })
+      targetFields.forEach(field => { nearestFields[nearestAttrName(field)] ||= (elem[field]?.baseVal || elem[field]) })
       const selector = [
         localName,
         id ? `#${id}` : '',

package/src/common/harvest/harvester.js

@@ -178,7 +178,7 @@ function send (agentRef, { endpoint, targetApp, payload, localOpts = {}, submitM
 
   dispatchGlobalEvent({
     agentIdentifier: agentRef.agentIdentifier,
-    loaded: !!activatedFeatures?.[agentRef.agentIdentifier],
+    drained: !!activatedFeatures?.[agentRef.agentIdentifier],
     type: 'data',
     name: 'harvest',
     feature: featureName,

package/src/common/util/feature-flags.js

@@ -28,10 +28,11 @@ export function activateFeatures (flags, agentIdentifier) {
 
   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
   dispatchGlobalEvent({
     agentIdentifier,
     loaded: true,
+    drained: true,
     type: 'lifecycle',
     name: 'load',
     feature: undefined,

package/src/features/session_replay/shared/recorder.js

@@ -14,6 +14,8 @@ import { FEATURE_NAMES } from '../../../loaders/features/features'
 import { buildNRMetaNode, customMasker } from './utils'
 import { IDEAL_PAYLOAD_SIZE } from '../../../common/constants/agent-constants'
 import { AggregateBase } from '../../utils/aggregate-base'
+import { warn } from '../../../common/util/console'
+import { single } from '../../../common/util/invoke'
 
 export class Recorder {
   /** Each page mutation or event will be stored (raw) in this array. This array will be cleared on each harvest */
@@ -25,6 +27,8 @@ export class Recorder {
   /** 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 = single(() => warn(47)) // notifies user of potential replayer issue if fix_stylesheets is off
+
   constructor (parent) {
     this.#events = new RecorderEvents()
     this.#backloggedEvents = new RecorderEvents()
@@ -120,6 +124,7 @@ export class Recorder {
     if (!this.shouldFix) {
       if (incompletes > 0) {
         this.currentBufferTarget.inlinedAllStylesheets = false
+        this.#warnCSSOnce()
         handle(SUPPORTABILITY_METRIC_CHANNEL, [missingInlineSMTag + 'Skipped', incompletes], undefined, FEATURE_NAMES.metrics, this.parent.ee)
       }
       return this.store(event, isCheckout)

package/src/features/session_trace/aggregate/trace/storage.js

@@ -15,7 +15,7 @@ const SUPPORTS_PERFORMANCE_OBSERVER = typeof globalScope.PerformanceObserver ===
 
 const ignoredEvents = {
   // we find that certain events make the data too noisy to be useful
-  global: { mouseup: true, mousedown: true },
+  global: { mouseup: 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: { load: true, pagehide: true },
   // when ajax instrumentation is disabled, all XMLHttpRequest events will return with origin = xhrOriginMissing and should be ignored
@@ -182,8 +182,8 @@ export class TraceStorage {
   }
 
   shouldIgnoreEvent (event, target) {
-    const origin = eventOrigin(event.target, target, this.parent.ee)
     if (event.type in ignoredEvents.global) return true
+    const origin = eventOrigin(event.target, target, this.parent.ee)
     if (!!ignoredEvents[origin] && ignoredEvents[origin].ignoreAll) return true
     return !!(!!ignoredEvents[origin] && event.type in ignoredEvents[origin])
   }

package/src/features/utils/aggregate-base.js

@@ -136,14 +136,14 @@ export class AggregateBase extends FeatureBase {
       } catch (err) {
         // do nothing
       }
-      configure({ agentIdentifier: this.agentIdentifier }, {
+      configure(existingAgent, {
         ...cdn,
         info: {
           ...cdn.info,
           jsAttributes
         },
         runtime: existingAgent.runtime
-      })
+      }, existingAgent.runtime.loaderType)
     }
   }
 

package/src/features/utils/event-store-manager.js

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

package/src/features/utils/nr1-debugger.js

@@ -7,7 +7,7 @@ import { gosCDN } from '../../common/window/nreum'
 const debugId = 1
 const newrelic = gosCDN()
 export 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/src/loaders/agent-base.js

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

package/src/loaders/agent.js

@@ -72,6 +72,10 @@ export class Agent extends AgentBase {
     }
   }
 
+  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 {
@@ -102,7 +106,6 @@ export class Agent extends AgentBase {
       }
 
       const newrelic = 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/src/loaders/api/api.js

@@ -3,10 +3,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { FEATURE_NAMES } from '../features/features'
-import { getInfo, setInfo } from '../../common/config/info'
-import { getRuntime } from '../../common/config/runtime'
+import { setInfo } from '../../common/config/info'
 import { handle } from '../../common/event-emitter/handle'
-import { ee } from '../../common/event-emitter/contextual-ee'
 import { drain, registerDrain } from '../../common/drain/drain'
 import { onWindowLoad } from '../../common/window/load'
 import { isBrowserScope } from '../../common/constants/runtime'
@@ -31,55 +29,53 @@ export 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) {
         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 = {}
 
-export function setAPI (agentIdentifier, forceDrain, runSoftNavOverSpa = false) {
-  if (!forceDrain) registerDrain(agentIdentifier, 'api')
-  const apiInterface = {}
-  var instanceEE = ee.get(agentIdentifier)
-  var tracerEE = instanceEE.get('tracer')
+export function setAPI (agent, forceDrain) {
+  if (!forceDrain) registerDrain(agent.agentIdentifier, 'api')
+  const tracerEE = agent.ee.get('tracer')
 
-  replayRunning[agentIdentifier] = MODE.OFF
+  replayRunning[agent.agentIdentifier] = MODE.OFF
 
-  instanceEE.on(SR_EVENT_EMITTER_TYPES.REPLAY_RUNNING, (isRunning) => {
-    replayRunning[agentIdentifier] = isRunning
+  agent.ee.on(SR_EVENT_EMITTER_TYPES.REPLAY_RUNNING, (isRunning) => {
+    replayRunning[agent.agentIdentifier] = isRunning
   })
 
-  var prefix = 'api-'
-  var spaPrefix = prefix + 'ixn-'
+  const prefix = 'api-'
+  const spaPrefix = prefix + 'ixn-'
 
-  apiInterface.log = function (message, { customAttributes = {}, level = LOG_LEVELS.INFO } = {}) {
-    handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/log/called'], undefined, FEATURE_NAMES.metrics, instanceEE)
-    bufferLog(instanceEE, message, customAttributes, level)
+  agent.log = function (message, { customAttributes = {}, level = LOG_LEVELS.INFO } = {}) {
+    handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/log/called'], undefined, FEATURE_NAMES.metrics, agent.ee)
+    bufferLog(agent.ee, message, customAttributes, level)
   }
 
-  apiInterface.wrapLogger = (parent, functionName, { customAttributes = {}, level = LOG_LEVELS.INFO } = {}) => {
-    handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/wrapLogger/called'], undefined, FEATURE_NAMES.metrics, instanceEE)
-    wrapLogger(instanceEE, parent, functionName, { customAttributes, level })
+  agent.wrapLogger = (parent, functionName, { customAttributes = {}, level = LOG_LEVELS.INFO } = {}) => {
+    handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/wrapLogger/called'], undefined, FEATURE_NAMES.metrics, agent.ee)
+    wrapLogger(agent.ee, parent, functionName, { customAttributes, level })
   }
 
   // Setup stub functions that queue calls for later processing.
-  asyncApiMethods.forEach(fnName => { apiInterface[fnName] = apiCall(prefix, fnName, true, 'api') })
+  asyncApiMethods.forEach(fnName => { agent[fnName] = apiCall(prefix, fnName, true, 'api') })
 
-  apiInterface.addPageAction = apiCall(prefix, 'addPageAction', true, FEATURE_NAMES.genericEvents)
+  agent.addPageAction = apiCall(prefix, 'addPageAction', true, FEATURE_NAMES.genericEvents)
 
-  apiInterface.recordCustomEvent = apiCall(prefix, 'recordCustomEvent', true, FEATURE_NAMES.genericEvents)
+  agent.recordCustomEvent = apiCall(prefix, 'recordCustomEvent', true, FEATURE_NAMES.genericEvents)
 
-  apiInterface.setPageViewName = function (name, host) {
+  agent.setPageViewName = function (name, host) {
     if (typeof name !== 'string') return
     if (name.charAt(0) !== '/') name = '/' + name
-    getRuntime(agentIdentifier).customTransaction = (host || 'http://custom.transaction') + name
+    agent.runtime.customTransaction = (host || 'http://custom.transaction') + name
     return apiCall(prefix, 'setPageViewName', true)()
   }
 
@@ -92,15 +88,15 @@ export function setAPI (agentIdentifier, forceDrain, runSoftNavOverSpa = false)
    * @returns @see apiCall
    */
   function appendJsAttribute (key, value, apiName, addToBrowserStorage) {
-    const currentInfo = getInfo(agentIdentifier)
+    const currentInfo = agent.info
     if (value === null) {
       delete currentInfo.jsAttributes[key]
     } else {
-      setInfo(agentIdentifier, { ...currentInfo, jsAttributes: { ...currentInfo.jsAttributes, [key]: value } })
+      setInfo(agent.agentIdentifier, { ...currentInfo, jsAttributes: { ...currentInfo.jsAttributes, [key]: value } })
     }
     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') {
       warn(39, typeof name)
       return
@@ -116,7 +112,7 @@ export 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)) {
       warn(41, typeof value)
       return
@@ -129,7 +125,7 @@ export 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)) {
       warn(42, typeof value)
       return
@@ -137,26 +133,26 @@ export function setAPI (agentIdentifier, forceDrain, runSoftNavOverSpa = false)
     return appendJsAttribute('application.version', value, 'setApplicationVersion', false)
   }
 
-  apiInterface.start = () => {
+  agent.start = () => {
     try {
-      handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/start/called'], undefined, FEATURE_NAMES.metrics, instanceEE)
-      instanceEE.emit('manual-start-all')
+      handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/start/called'], undefined, FEATURE_NAMES.metrics, agent.ee)
+      agent.ee.emit('manual-start-all')
     } catch (err) {
       warn(23, err)
     }
   }
 
-  apiInterface[SR_EVENT_EMITTER_TYPES.RECORD] = function () {
-    handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/recordReplay/called'], undefined, FEATURE_NAMES.metrics, instanceEE)
-    handle(SR_EVENT_EMITTER_TYPES.RECORD, [], undefined, FEATURE_NAMES.sessionReplay, instanceEE)
+  agent[SR_EVENT_EMITTER_TYPES.RECORD] = function () {
+    handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/recordReplay/called'], undefined, FEATURE_NAMES.metrics, agent.ee)
+    handle(SR_EVENT_EMITTER_TYPES.RECORD, [], undefined, FEATURE_NAMES.sessionReplay, agent.ee)
   }
 
-  apiInterface[SR_EVENT_EMITTER_TYPES.PAUSE] = function () {
-    handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/pauseReplay/called'], undefined, FEATURE_NAMES.metrics, instanceEE)
-    handle(SR_EVENT_EMITTER_TYPES.PAUSE, [], undefined, FEATURE_NAMES.sessionReplay, instanceEE)
+  agent[SR_EVENT_EMITTER_TYPES.PAUSE] = function () {
+    handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/pauseReplay/called'], undefined, FEATURE_NAMES.metrics, agent.ee)
+    handle(SR_EVENT_EMITTER_TYPES.PAUSE, [], undefined, FEATURE_NAMES.sessionReplay, agent.ee)
   }
 
-  apiInterface.interaction = function (options) {
+  agent.interaction = function (options) {
     return new InteractionHandle().get(typeof options === 'object' ? options : {})
   }
 
@@ -167,9 +163,9 @@ export function setAPI (agentIdentifier, forceDrain, runSoftNavOverSpa = false)
       var contextStore = {}
       var ixn = this
       var hasCb = typeof cb === 'function'
-      handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/createTracer/called'], undefined, FEATURE_NAMES.metrics, instanceEE)
+      handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/createTracer/called'], undefined, 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) handle(spaPrefix + 'tracer', [now(), name, contextStore], ixn, FEATURE_NAMES.spa, instanceEE)
+      if (!agent.runSoftNavOverSpa) handle(spaPrefix + 'tracer', [now(), name, contextStore], ixn, FEATURE_NAMES.spa, agent.ee)
       return function () {
         tracerEE.emit((hasCb ? '' : 'no-') + 'fn-start', [now(), ixn, hasCb], contextStore)
         if (hasCb) {
@@ -189,30 +185,30 @@ export function setAPI (agentIdentifier, forceDrain, runSoftNavOverSpa = false)
   }
 
   ;['actionText', 'setName', 'setAttribute', 'save', 'ignore', 'onEnd', 'getContext', 'end', 'get'].forEach(name => {
-    InteractionApiProto[name] = apiCall(spaPrefix, name, undefined, runSoftNavOverSpa ? FEATURE_NAMES.softNav : FEATURE_NAMES.spa)
+    InteractionApiProto[name] = apiCall(spaPrefix, name, undefined, agent.runSoftNavOverSpa ? FEATURE_NAMES.softNav : FEATURE_NAMES.spa)
   })
-  apiInterface.setCurrentRouteName = runSoftNavOverSpa ? apiCall(spaPrefix, 'routeName', undefined, FEATURE_NAMES.softNav) : apiCall(prefix, 'routeName', true, FEATURE_NAMES.spa)
+  agent.setCurrentRouteName = agent.runSoftNavOverSpa ? apiCall(spaPrefix, 'routeName', undefined, FEATURE_NAMES.softNav) : apiCall(prefix, 'routeName', true, FEATURE_NAMES.spa)
 
   function apiCall (prefix, name, notSpa, bufferGroup) {
     return function () {
-      handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/' + name + '/called'], undefined, FEATURE_NAMES.metrics, instanceEE)
+      handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/' + name + '/called'], undefined, FEATURE_NAMES.metrics, agent.ee)
       dispatchGlobalEvent({
-        agentIdentifier,
-        loaded: !!activatedFeatures?.[agentIdentifier],
+        agentIdentifier: agent.agentIdentifier,
+        drained: !!activatedFeatures?.[agent.agentIdentifier],
         type: 'data',
         name: 'api',
         feature: prefix + name,
         data: { notSpa, bufferGroup }
       })
-      if (bufferGroup) handle(prefix + name, [notSpa ? now() : performance.now(), ...arguments], notSpa ? null : this, bufferGroup, instanceEE) // no bufferGroup means only the SM is emitted
+      if (bufferGroup) handle(prefix + name, [notSpa ? 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)
-    handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/noticeError/called'], undefined, FEATURE_NAMES.metrics, instanceEE)
-    handle('err', [err, now(), false, customAttributes, !!replayRunning[agentIdentifier]], undefined, FEATURE_NAMES.jserrors, instanceEE)
+    handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/noticeError/called'], undefined, FEATURE_NAMES.metrics, agent.ee)
+    handle('err', [err, now(), false, customAttributes, !!replayRunning[agent.agentIdentifier]], undefined, FEATURE_NAMES.jserrors, agent.ee)
   }
 
   // theres no window.load event on non-browser scopes, lazy load immediately
@@ -221,14 +217,14 @@ export function setAPI (agentIdentifier, forceDrain, runSoftNavOverSpa = false)
   else onWindowLoad(() => lazyLoad(), true)
 
   function lazyLoad () {
-    import(/* webpackChunkName: "async-api" */'./apiAsync').then(({ setAPI }) => {
-      setAPI(agentIdentifier)
-      drain(agentIdentifier, 'api')
+    import(/* webpackChunkName: "async-api" */'./apiAsync').then(({ setAsyncAPI }) => {
+      setAsyncAPI(agent)
+      drain(agent.agentIdentifier, 'api')
     }).catch((err) => {
       warn(27, err)
-      instanceEE.abort()
+      agent.ee.abort()
     })
   }
 
-  return apiInterface
+  return true
 }

package/src/loaders/api/apiAsync.js

@@ -3,18 +3,14 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { FEATURE_NAMES } from '../features/features'
-import { getRuntime } from '../../common/config/runtime'
-import { ee } from '../../common/event-emitter/contextual-ee'
 import { handle } from '../../common/event-emitter/handle'
 import { registerHandler } from '../../common/event-emitter/register-handler'
 import { single } from '../../common/util/invoke'
 import { CUSTOM_METRIC_CHANNEL } from '../../features/metrics/constants'
 import { originTime } from '../../common/constants/runtime'
 
-export function setAPI (agentIdentifier) {
-  var instanceEE = ee.get(agentIdentifier)
-
-  var api = {
+export function setAsyncAPI (agent) {
+  const api = {
     finished: single(finished),
     setErrorHandler,
     addToTrace,
@@ -22,22 +18,22 @@ export 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]) => registerHandler('api-' + fnName, fnCall, 'api', instanceEE))
+  Object.entries(api).forEach(([fnName, fnCall]) => 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 - originTime : t
-    handle(CUSTOM_METRIC_CHANNEL, ['finished', { time }], undefined, FEATURE_NAMES.metrics, instanceEE)
+    const time = providedTime ? providedTime - originTime : t
+    handle(CUSTOM_METRIC_CHANNEL, ['finished', { time }], undefined, FEATURE_NAMES.metrics, agent.ee)
     addToTrace(t, { name: 'finished', start: time + originTime, origin: 'nr' })
-    handle('api-addPageAction', [time, 'finished'], undefined, FEATURE_NAMES.genericEvents, instanceEE)
+    handle('api-addPageAction', [time, 'finished'], undefined, 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 - originTime,
       e: (evt.end || evt.start) - originTime,
@@ -45,16 +41,16 @@ export function setAPI (agentIdentifier) {
       t: 'api'
     }
 
-    handle('bstApi', [report], undefined, FEATURE_NAMES.sessionTrace, instanceEE)
+    handle('bstApi', [report], undefined, FEATURE_NAMES.sessionTrace, agent.ee)
   }
 
-  function setErrorHandler (t, handler) {
-    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
-    getRuntime(agentIdentifier).releaseIds[name.slice(-200)] = ('' + id).slice(-200)
+    agent.runtime.releaseIds[name.slice(-200)] = ('' + id).slice(-200)
   }
 }

package/src/loaders/configure/configure.js

@@ -5,7 +5,7 @@
 import { setAPI, setTopLevelCallers } from '../api/api'
 import { addToNREUM, gosCDN } from '../../common/window/nreum'
 import { setInfo } from '../../common/config/info'
-import { getConfiguration, setConfiguration } from '../../common/config/init'
+import { setConfiguration } from '../../common/config/init'
 import { setLoaderConfig } from '../../common/config/loader-config'
 import { setRuntime } from '../../common/config/runtime'
 import { activatedFeatures } from '../../common/util/feature-flags'
@@ -14,10 +14,11 @@ import { redefinePublicPath } from './public-path'
 import { ee } from '../../common/event-emitter/contextual-ee'
 import { dispatchGlobalEvent } from '../../common/dispatch/global-event'
 
-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.
  */
 export function configure (agent, opts = {}, loaderType, forceDrain) {
   // eslint-disable-next-line camelcase
@@ -41,10 +42,10 @@ export function configure (agent, opts = {}, loaderType, forceDrain) {
   }
   setInfo(agent.agentIdentifier, info)
 
-  const updatedInit = getConfiguration(agent.agentIdentifier)
+  const updatedInit = agent.init
   const internalTrafficList = [info.beacon, info.errorBeacon]
 
-  if (!alreadySetOnce) {
+  if (!alreadySetOnce.has(agent.agentIdentifier)) {
     if (updatedInit.proxy.assets) {
       redefinePublicPath(updatedInit.proxy.assets)
       internalTrafficList.push(updatedInit.proxy.assets)
@@ -65,21 +66,20 @@ export function configure (agent, opts = {}, loaderType, forceDrain) {
   runtime.ptid = agent.agentIdentifier
   setRuntime(agent.agentIdentifier, runtime)
 
-  agent.ee = ee.get(agent.agentIdentifier)
+  if (!alreadySetOnce.has(agent.agentIdentifier)) {
+    agent.ee = ee.get(agent.agentIdentifier)
+    agent.exposed = exposed
+    setAPI(agent, forceDrain) // assign our API functions to the agent instance
 
-  if (agent.api === undefined) agent.api = setAPI(agent.agentIdentifier, forceDrain, agent.runSoftNavOverSpa)
-  if (agent.exposed === undefined) agent.exposed = exposed
-
-  if (!alreadySetOnce) {
     dispatchGlobalEvent({
       agentIdentifier: agent.agentIdentifier,
-      loaded: !!activatedFeatures?.[agent.agentIdentifier],
+      drained: !!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/src/loaders/micro-agent-base.js

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

package/src/loaders/micro-agent.js

@@ -36,7 +36,6 @@ export class MicroAgent extends MicroAgentBase {
     setNREUMInitializedAgent(this.agentIdentifier, this)
 
     configure(this, { ...options, runtime: { 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,4 +90,8 @@ export class MicroAgent extends MicroAgentBase {
       runtime: this.runtime
     }
   }
+
+  get api () {
+    return this
+  }
 }