@newrelic/browser-agent 1.284.1 → 1.286.0

package/dist/esm/features/session_replay/shared/utils.js

@@ -26,4 +26,15 @@ export function buildNRMetaNode(timestamp, timeKeeper) {
     correctedOriginTime: timeKeeper.correctedOriginTime,
     originTimeDiff: Math.floor(originTime - timeKeeper.correctedOriginTime)
   };
+}
+export function customMasker(text, element) {
+  try {
+    if (typeof element?.type === 'string') {
+      if (element.type.toLowerCase() === 'password') return '*'.repeat(text?.length || 0);
+      if (element?.dataset?.nrUnmask !== undefined || element?.classList?.contains('nr-unmask')) return text;
+    }
+  } catch (err) {
+    // likely an element was passed to this handler that was invalid and was missing attributes or methods
+  }
+  return typeof text === 'string' ? text.replace(/[\S]/g, '*') : '*'.repeat(text?.length || 0);
 }

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

@@ -15,7 +15,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: {
@@ -177,8 +178,8 @@ export class TraceStorage {
     this.storeSTN(evt);
   }
   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/dist/esm/features/utils/aggregate-base.js

@@ -36,7 +36,7 @@ export class AggregateBase extends FeatureBase {
       This was necessary to prevent race cond. issues where the event buffer was checked before the feature could "block" itself.
       Its easier to just keep an empty event buffer in place. */
       default:
-        this.events = new EventStoreManager(agentRef.mainAppKey, 1);
+        this.events = new EventStoreManager(agentRef.mainAppKey, 1, agentRef.agentIdentifier, this.featureName);
         break;
     }
     this.harvestOpts = {}; // features aggregate classes can define custom opts for when their harvest is called
@@ -138,16 +138,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);
     }
   }
 
@@ -163,7 +161,7 @@ export class AggregateBase extends FeatureBase {
       appId: agentRef.info.applicationID
     };
     // Create a single Aggregator for this agent if DNE yet; to be used by jserror endpoint features.
-    if (!agentRef.sharedAggregator) agentRef.sharedAggregator = new EventStoreManager(agentRef.mainAppKey, 2);
+    if (!agentRef.sharedAggregator) agentRef.sharedAggregator = new EventStoreManager(agentRef.mainAppKey, 2, agentRef.agentIdentifier, 'shared_aggregator');
     if (!agentRef.runtime.harvester) agentRef.runtime.harvester = new Harvester(agentRef);
   }
 

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

@@ -3,6 +3,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { EventAggregator } from '../../common/aggregate/event-aggregator';
+import { dispatchGlobalEvent } from '../../common/dispatch/global-event';
+import { activatedFeatures } from '../../common/util/feature-flags';
 import { EventBuffer } from './event-buffer';
 
 /**
@@ -13,12 +15,16 @@ export class EventStoreManager {
   /**
    * @param {object} defaultTarget - should contain licenseKey and appId of the main app from NREUM.info at startup
    * @param {1|2} storageChoice - the type of storage to use in this manager; 'EventBuffer' (1), 'EventAggregator' (2)
+   * @param {string} agentIdentifier - agent identifier used in inspection events
+   * @param {string} featureName - feature name used in inspection events for non-shared aggregators
    */
-  constructor(defaultTarget, storageChoice) {
+  constructor(defaultTarget, storageChoice, agentIdentifier, featureName) {
     this.mainApp = defaultTarget;
     this.StorageClass = storageChoice === 1 ? EventBuffer : EventAggregator;
     this.appStorageMap = new Map();
     this.appStorageMap.set(defaultTarget, new this.StorageClass());
+    this.agentIdentifier = agentIdentifier;
+    this.featureName = featureName;
   }
 
   // This class must contain an union of all methods from all supported storage classes and conceptualize away the target app argument.
@@ -44,6 +50,14 @@ export class EventStoreManager {
    * @returns {boolean} True if the event was successfully added
    */
   add(event, target) {
+    dispatchGlobalEvent({
+      agentIdentifier: this.agentIdentifier,
+      drained: !!activatedFeatures?.[this.agentIdentifier],
+      type: 'data',
+      name: 'buffer',
+      feature: this.featureName,
+      data: event
+    });
     if (target && !this.appStorageMap.has(target)) this.appStorageMap.set(target, new this.StorageClass());
     return this.appStorageMap.get(target || this.mainApp).add(event);
   }

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

@@ -6,7 +6,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/dist/esm/loaders/agent-base.js

@@ -20,7 +20,7 @@ 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/dist/esm/loaders/agent.js

@@ -67,6 +67,9 @@ export class Agent extends 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 {
@@ -94,7 +97,6 @@ export class Agent extends AgentBase {
         this.features[featName].abortHandler?.();
       }
       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/dist/esm/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';
@@ -20,6 +18,8 @@ import { MODE } from '../../common/session/constants';
 import { LOG_LEVELS } from '../../features/logging/constants';
 import { bufferLog } from '../../features/logging/shared/utils';
 import { wrapLogger } from '../../common/wrap/wrap-logger';
+import { dispatchGlobalEvent } from '../../common/dispatch/global-event';
+import { activatedFeatures } from '../../common/util/feature-flags';
 export function setTopLevelCallers() {
   const nr = gosCDN();
   apiMethods.forEach(f => {
@@ -27,41 +27,39 @@ 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');
-  replayRunning[agentIdentifier] = MODE.OFF;
-  instanceEE.on(SR_EVENT_EMITTER_TYPES.REPLAY_RUNNING, isRunning => {
-    replayRunning[agentIdentifier] = isRunning;
+export function setAPI(agent, forceDrain) {
+  if (!forceDrain) registerDrain(agent.agentIdentifier, 'api');
+  const tracerEE = agent.ee.get('tracer');
+  replayRunning[agent.agentIdentifier] = MODE.OFF;
+  agent.ee.on(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 = LOG_LEVELS.INFO
   } = {}) {
-    handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/log/called'], undefined, FEATURE_NAMES.metrics, instanceEE);
-    bufferLog(instanceEE, message, customAttributes, level);
+    handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/log/called'], undefined, FEATURE_NAMES.metrics, agent.ee);
+    bufferLog(agent.ee, message, customAttributes, level);
   };
-  apiInterface.wrapLogger = (parent, functionName, {
+  agent.wrapLogger = (parent, functionName, {
     customAttributes = {},
     level = LOG_LEVELS.INFO
   } = {}) => {
-    handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/wrapLogger/called'], undefined, FEATURE_NAMES.metrics, instanceEE);
-    wrapLogger(instanceEE, parent, functionName, {
+    handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/wrapLogger/called'], undefined, FEATURE_NAMES.metrics, agent.ee);
+    wrapLogger(agent.ee, parent, functionName, {
       customAttributes,
       level
     });
@@ -69,14 +67,14 @@ export function setAPI(agentIdentifier, forceDrain, runSoftNavOverSpa = false) {
 
   // Setup stub functions that queue calls for later processing.
   asyncApiMethods.forEach(fnName => {
-    apiInterface[fnName] = apiCall(prefix, fnName, true, 'api');
+    agent[fnName] = apiCall(prefix, fnName, true, 'api');
   });
-  apiInterface.addPageAction = apiCall(prefix, 'addPageAction', true, FEATURE_NAMES.genericEvents);
-  apiInterface.recordCustomEvent = apiCall(prefix, 'recordCustomEvent', true, FEATURE_NAMES.genericEvents);
-  apiInterface.setPageViewName = function (name, host) {
+  agent.addPageAction = apiCall(prefix, 'addPageAction', true, FEATURE_NAMES.genericEvents);
+  agent.recordCustomEvent = apiCall(prefix, 'recordCustomEvent', true, FEATURE_NAMES.genericEvents);
+  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)();
   };
 
@@ -89,11 +87,11 @@ 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, {
+      setInfo(agent.agentIdentifier, {
         ...currentInfo,
         jsAttributes: {
           ...currentInfo.jsAttributes,
@@ -103,7 +101,7 @@ export 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') {
       warn(39, typeof name);
       return;
@@ -119,7 +117,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;
@@ -132,30 +130,30 @@ 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;
     }
     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 : {});
   };
   function InteractionHandle() {}
@@ -164,9 +162,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) {
@@ -185,20 +183,31 @@ 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);
-      if (bufferGroup) handle(prefix + name, [notSpa ? now() : performance.now(), ...arguments], notSpa ? null : this, bufferGroup, instanceEE); // no bufferGroup means only the SM is emitted
+      handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/' + name + '/called'], undefined, FEATURE_NAMES.metrics, agent.ee);
+      dispatchGlobalEvent({
+        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, 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
@@ -207,14 +216,14 @@ export function setAPI(agentIdentifier, forceDrain, runSoftNavOverSpa = false) {
   else onWindowLoad(() => lazyLoad(), true);
   function lazyLoad() {
     import(/* webpackChunkName: "async-api" */'./apiAsync').then(({
-      setAPI
+      setAsyncAPI
     }) => {
-      setAPI(agentIdentifier);
-      drain(agentIdentifier, 'api');
+      setAsyncAPI(agent);
+      drain(agent.agentIdentifier, 'api');
     }).catch(err => {
       warn(27, err);
-      instanceEE.abort();
+      agent.ee.abort();
     });
   }
-  return apiInterface;
+  return true;
 }

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

@@ -3,16 +3,13 @@
  * 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,
@@ -20,40 +17,40 @@ 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;
+    const time = providedTime ? providedTime - originTime : t;
     handle(CUSTOM_METRIC_CHANNEL, ['finished', {
       time
-    }], undefined, FEATURE_NAMES.metrics, instanceEE);
+    }], 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,
       o: evt.origin || '',
       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/dist/esm/loaders/configure/configure.js

@@ -5,17 +5,19 @@
 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';
 import { isWorkerScope } from '../../common/constants/runtime';
 import { redefinePublicPath } from './public-path';
 import { ee } from '../../common/event-emitter/contextual-ee';
-let alreadySetOnce = false; // the configure() function can run multiple times in agent lifecycle
+import { dispatchGlobalEvent } from '../../common/dispatch/global-event';
+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
@@ -43,9 +45,9 @@ export function configure(agent, opts = {}, loaderType, forceDrain) {
     info.jsAttributes.isWorker = true;
   }
   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);
@@ -60,8 +62,19 @@ export function configure(agent, opts = {}, loaderType, forceDrain) {
   runtime.denyList = [...(updatedInit.ajax.deny_list || []), ...(updatedInit.ajax.block_internal ? internalTrafficList : [])];
   runtime.ptid = agent.agentIdentifier;
   setRuntime(agent.agentIdentifier, runtime);
-  agent.ee = ee.get(agent.agentIdentifier);
-  if (agent.api === undefined) agent.api = setAPI(agent.agentIdentifier, forceDrain, agent.runSoftNavOverSpa);
-  if (agent.exposed === undefined) agent.exposed = exposed;
-  alreadySetOnce = true;
+  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
+
+    dispatchGlobalEvent({
+      agentIdentifier: agent.agentIdentifier,
+      drained: !!activatedFeatures?.[agent.agentIdentifier],
+      type: 'lifecycle',
+      name: 'initialize',
+      feature: undefined,
+      data: agent.config
+    });
+  }
+  alreadySetOnce.add(agent.agentIdentifier);
 }

package/dist/esm/loaders/features/features.js

@@ -6,8 +6,9 @@
 // To reduce build size a bit:
 export const EVENTS = 'events';
 export const JSERRORS = 'jserrors';
-const BLOBS = 'browser/blobs';
+export const BLOBS = 'browser/blobs';
 export const RUM = 'rum';
+export const LOGS = 'browser/logs';
 export const FEATURE_NAMES = {
   ajax: 'ajax',
   genericEvents: 'generic_events',
@@ -53,6 +54,6 @@ export const FEATURE_TO_ENDPOINT = {
   [FEATURE_NAMES.jserrors]: JSERRORS,
   [FEATURE_NAMES.sessionTrace]: BLOBS,
   [FEATURE_NAMES.sessionReplay]: BLOBS,
-  [FEATURE_NAMES.logging]: 'browser/logs',
+  [FEATURE_NAMES.logging]: LOGS,
   [FEATURE_NAMES.genericEvents]: 'ins'
 };

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

@@ -16,7 +16,7 @@ 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/dist/esm/loaders/micro-agent.js

@@ -33,7 +33,6 @@ export class MicroAgent extends 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
@@ -86,4 +85,7 @@ export class MicroAgent extends MicroAgentBase {
       runtime: this.runtime
     };
   }
+  get api() {
+    return this;
+  }
 }

package/dist/types/common/dom/selector-path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"selector-path.d.ts","sourceRoot":"","sources":["../../../../src/common/dom/selector-path.js"],"names":[],"mappings":"AAYO,2CALI,WAAW,yBAGT,MAAM,GAAC,SAAS,CAmD5B"}
+{"version":3,"file":"selector-path.d.ts","sourceRoot":"","sources":["../../../../src/common/dom/selector-path.js"],"names":[],"mappings":"AAYO,2CALI,WAAW,yBAGT,MAAM,GAAC,SAAS,CAiD5B"}

package/dist/types/common/harvest/harvester.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"harvester.d.ts","sourceRoot":"","sources":["../../../../src/common/harvest/harvester.js"],"names":[],"mappings":"AAsBA;IAIE,2BAcC;IAhBD,6BAA0B;IAGxB,cAAwB;IAe1B,wCASC;IAED;;;;;OAKG;IACH,iCAJW,MAAM,cACN,MAAM,GACJ,OAAO,CA8CnB;;CACF;8BAGY,OAAO,YAAY,EAAE,eAAe"}
+{"version":3,"file":"harvester.d.ts","sourceRoot":"","sources":["../../../../src/common/harvest/harvester.js"],"names":[],"mappings":"AAwBA;IAIE,2BAcC;IAhBD,6BAA0B;IAGxB,cAAwB;IAe1B,wCASC;IAED;;;;;OAKG;IACH,iCAJW,MAAM,cACN,MAAM,GACJ,OAAO,CA+CnB;;CACF;8BAGY,OAAO,YAAY,EAAE,eAAe"}

package/dist/types/common/util/feature-flags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../../../src/common/util/feature-flags.js"],"names":[],"mappings":"AAYA;;;;;;GAMG;AACH,wCAJW;IAAC,CAAC,GAAG,EAAC,MAAM,GAAE,MAAM,CAAA;CAAC,mBACrB,MAAM,GACJ,IAAI,CAehB;AAvBD,gGAAgG;AAChG,mCAAmC"}
+{"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../../../src/common/util/feature-flags.js"],"names":[],"mappings":"AAYA;;;;;;GAMG;AACH,wCAJW;IAAC,CAAC,GAAG,EAAC,MAAM,GAAE,MAAM,CAAA;CAAC,mBACrB,MAAM,GACJ,IAAI,CAuBhB;AA/BD,gGAAgG;AAChG,mCAAmC"}

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

@@ -2,7 +2,6 @@ export class Aggregate extends AggregateBase {
     static featureName: string;
     constructor(agentRef: any);
     isSessionTrackingEnabled: any;
-    mode: any;
     loggingMode: any;
     updateLoggingMode(loggingMode: any): void;
     handleLog(timestamp: any, message: any, attributes?: {}, level?: string): void;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/logging/aggregate/index.js"],"names":[],"mappings":"AAiBA;IACE,2BAAiC;IACjC,2BAmCC;IAjCC,8BAA+G;IAUxG,UAA4B;IAc/B,iBAA4C;IAWlD,0CAKC;IAED,+EAuDC;IAED;;YAIM,0FAA0F;;;QAoB5F,0DAA0D;;QAM7D;IAED;;MAEC;IAED,yDAAyD;IACzD,yBAOC;IAED,yCAIC;CACF;8BApK6B,4BAA4B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/logging/aggregate/index.js"],"names":[],"mappings":"AAiBA;IACE,2BAAiC;IACjC,2BAmCC;IAjCC,8BAA+G;IAUxG,iBAAmC;IAyB5C,0CAKC;IAED,+EAuDC;IAED;;YAIM,0FAA0F;;;QAoB5F,0DAA0D;;QAM7D;IAED;;MAEC;IAED,yDAAyD;IACzD,yBAOC;IAED,yCAIC;CACF;8BApK6B,4BAA4B"}

package/dist/types/features/session_replay/shared/recorder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../../../../src/features/session_replay/shared/recorder.js"],"names":[],"mappings":"AAiBA;IAUE,yBAkBC;IAdC,iEAAiE;IACjE,mBAAsB;IACtB,6DAA6D;IAC7D,oCAAuC;IACvC,+IAA+I;IAC/I,yBAA4B;IAC5B,kIAAkI;IAClI,kBAAqB;IACrB,sDAAsD;IACtD,YAAoB;IACpB,0FAA0F;IAC1F,eAAyE;IACzE,uIAAuI;IACvI,0BAAyE;IAG3E;;;;;;;;;MAmBC;IAED,mFAAmF;IACnF,oBAKC;IAED,qDAAqD;IACrD,uBAoCC;IAED;;;;;OAKG;IACH,aAHW,GAAC,cACD,GAAC,QAgCX;IAED,0HAA0H;IAC1H,yCAoDC;IA1CG,8BAAoB;IA4CxB,0HAA0H;IAC1H,yBAOC;IAED,wBAEC;IAED,gCAAgC;IAChC,uCAGC;IAED;;;SAGK;IACL,oCAGC;;CACF;+BArO8B,mBAAmB"}
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../../../../src/features/session_replay/shared/recorder.js"],"names":[],"mappings":"AAmBA;IAYE,yBAkBC;IAdC,iEAAiE;IACjE,mBAAsB;IACtB,6DAA6D;IAC7D,oCAAuC;IACvC,+IAA+I;IAC/I,yBAA4B;IAC5B,kIAAkI;IAClI,kBAAqB;IACrB,sDAAsD;IACtD,YAAoB;IACpB,0FAA0F;IAC1F,eAAyE;IACzE,uIAAuI;IACvI,0BAAyE;IAG3E;;;;;;;;;MAmBC;IAED,mFAAmF;IACnF,oBAKC;IAED,qDAAqD;IACrD,uBA6BC;IAED;;;;;OAKG;IACH,aAHW,GAAC,cACD,GAAC,QAiCX;IAED,0HAA0H;IAC1H,yCAoDC;IA1CG,8BAAoB;IA4CxB,0HAA0H;IAC1H,yBAOC;IAED,wBAEC;IAED,gCAAgC;IAChC,uCAGC;IAED;;;SAGK;IACL,oCAGC;;CACF;+BAnO8B,mBAAmB"}

package/dist/types/features/session_replay/shared/utils.d.ts

@@ -8,4 +8,5 @@ export function buildNRMetaNode(timestamp: any, timeKeeper: any): {
     correctedOriginTime: any;
     originTimeDiff: number;
 };
+export function customMasker(text: any, element: any): any;
 //# sourceMappingURL=utils.d.ts.map

package/dist/types/features/session_replay/shared/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/features/session_replay/shared/utils.js"],"names":[],"mappings":"AASA,6DAIC;AAED,wDAEC;AAED;;;;;;;EAUC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/features/session_replay/shared/utils.js"],"names":[],"mappings":"AASA,6DAIC;AAED,wDAEC;AAED;;;;;;;EAUC;AAED,2DAUC"}