@newrelic/browser-agent 1.284.1 → 1.286.0

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");
@@ -23,6 +21,8 @@ var _constants3 = require("../../common/session/constants");
 var _constants4 = require("../../features/logging/constants");
 var _utils = require("../../features/logging/shared/utils");
 var _wrapLogger = require("../../common/wrap/wrap-logger");
+var _globalEvent = require("../../common/dispatch/global-event");
+var _featureFlags = require("../../common/util/feature-flags");
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; } /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
@@ -35,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
     });
@@ -77,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)();
   };
 
@@ -97,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,
@@ -111,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;
@@ -127,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;
@@ -140,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() {}
@@ -172,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) {
@@ -193,36 +191,47 @@ 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);
-      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
+      (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['API/' + name + '/called'], undefined, _features.FEATURE_NAMES.metrics, agent.ee);
+      (0, _globalEvent.dispatchGlobalEvent)({
+        agentIdentifier: agent.agentIdentifier,
+        drained: !!_featureFlags.activatedFeatures?.[agent.agentIdentifier],
+        type: 'data',
+        name: 'api',
+        feature: prefix + name,
+        data: {
+          notSpa,
+          bufferGroup
+        }
+      });
+      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

@@ -14,15 +14,17 @@ var _featureFlags = require("../../common/util/feature-flags");
 var _runtime2 = require("../../common/constants/runtime");
 var _publicPath = require("./public-path");
 var _contextualEe = require("../../common/event-emitter/contextual-ee");
+var _globalEvent = require("../../common/dispatch/global-event");
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * 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
@@ -50,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);
@@ -67,8 +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;
-  alreadySetOnce = true;
+  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,
+      drained: !!_featureFlags.activatedFeatures?.[agent.agentIdentifier],
+      type: 'lifecycle',
+      name: 'initialize',
+      feature: undefined,
+      data: agent.config
+    });
+  }
+  alreadySetOnce.add(agent.agentIdentifier);
 }

package/dist/cjs/loaders/features/features.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.featurePriority = exports.RUM = exports.JSERRORS = exports.FEATURE_TO_ENDPOINT = exports.FEATURE_NAMES = exports.EVENTS = void 0;
+exports.featurePriority = exports.RUM = exports.LOGS = exports.JSERRORS = exports.FEATURE_TO_ENDPOINT = exports.FEATURE_NAMES = exports.EVENTS = exports.BLOBS = void 0;
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -12,8 +12,9 @@ exports.featurePriority = exports.RUM = exports.JSERRORS = exports.FEATURE_TO_EN
 // To reduce build size a bit:
 const EVENTS = exports.EVENTS = 'events';
 const JSERRORS = exports.JSERRORS = 'jserrors';
-const BLOBS = 'browser/blobs';
+const BLOBS = exports.BLOBS = 'browser/blobs';
 const RUM = exports.RUM = 'rum';
+const LOGS = exports.LOGS = 'browser/logs';
 const FEATURE_NAMES = exports.FEATURE_NAMES = {
   ajax: 'ajax',
   genericEvents: 'generic_events',
@@ -59,6 +60,6 @@ const FEATURE_TO_ENDPOINT = exports.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/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.284.1";
+export const VERSION = "1.286.0";
 
 /**
  * Exposes the build type of the agent

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

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

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

@@ -40,7 +40,7 @@ export 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/esm/common/harvest/harvester.js

@@ -3,7 +3,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { SUPPORTABILITY_METRIC_CHANNEL } from '../../features/metrics/constants';
-import { FEATURE_TO_ENDPOINT, JSERRORS, RUM, EVENTS, FEATURE_NAMES } from '../../loaders/features/features';
+import { FEATURE_TO_ENDPOINT, JSERRORS, RUM, EVENTS, FEATURE_NAMES, BLOBS, LOGS } from '../../loaders/features/features';
 import { VERSION } from "../constants/env.npm";
 import { globalScope, isWorkerScope } from '../constants/runtime';
 import { handle } from '../event-emitter/handle';
@@ -16,6 +16,8 @@ import { obj, param } from '../url/encode';
 import { warn } from '../util/console';
 import { stringify } from '../util/stringify';
 import { getSubmitMethod, xhr as xhrMethod, xhrFetch as fetchMethod } from '../util/submit-data';
+import { activatedFeatures } from '../util/feature-flags';
+import { dispatchGlobalEvent } from '../dispatch/global-event';
 const RETRY_FAILED = 'Harvester/Retry/Failed/';
 const RETRY_SUCCEEDED = 'Harvester/Retry/Succeeded/';
 export class Harvester {
@@ -81,7 +83,8 @@ export class Harvester {
         localOpts,
         submitMethod,
         cbFinished,
-        raw: aggregateInst.harvestOpts.raw
+        raw: aggregateInst.harvestOpts.raw,
+        featureName: aggregateInst.featureName
       });
       ranSend = true;
     });
@@ -123,7 +126,8 @@ function send(agentRef, {
   localOpts = {},
   submitMethod,
   cbFinished,
-  raw
+  raw,
+  featureName
 }) {
   if (!agentRef.info.errorBeacon) return false;
   let {
@@ -204,6 +208,22 @@ function send(agentRef, {
       });
     }
   }
+  dispatchGlobalEvent({
+    agentIdentifier: agentRef.agentIdentifier,
+    drained: !!activatedFeatures?.[agentRef.agentIdentifier],
+    type: 'data',
+    name: 'harvest',
+    feature: featureName,
+    data: {
+      endpoint,
+      headers,
+      targetApp,
+      payload,
+      submitMethod: getSubmitMethodName(),
+      raw,
+      synchronousXhr: !!(localOpts.isFinalHarvest && isWorkerScope)
+    }
+  });
   return true;
   function shouldRetry(status) {
     switch (status) {
@@ -214,6 +234,11 @@ function send(agentRef, {
     }
     return status >= 502 && status <= 504 || status >= 512 && status <= 530;
   }
+  function getSubmitMethodName() {
+    if (submitMethod === xhrMethod) return 'xhr';
+    if (submitMethod === fetchMethod) return 'fetch';
+    return 'beacon';
+  }
 }
 
 /**
@@ -245,12 +270,14 @@ function cleanPayload(payload = {}) {
 function baseQueryString(agentRef, qs, endpoint, applicationID) {
   const ref = agentRef.runtime.obfuscator.obfuscateString(cleanURL('' + globalScope.location));
   const hr = agentRef.runtime.session?.state.sessionReplayMode === 1 && endpoint !== JSERRORS;
+  const ht = agentRef.runtime.session?.state.sessionTraceMode === 1 && ![LOGS, BLOBS].includes(endpoint);
   const qps = ['a=' + applicationID, param('sa', agentRef.info.sa ? '' + agentRef.info.sa : ''), param('v', VERSION), transactionNameParam(), param('ct', agentRef.runtime.customTransaction), '&rst=' + now(), '&ck=0',
   // ck param DEPRECATED - still expected by backend
   '&s=' + (agentRef.runtime.session?.state.value || '0'),
   // the 0 id encaps all untrackable and default traffic
   param('ref', ref), param('ptid', agentRef.runtime.ptid ? '' + agentRef.runtime.ptid : '')];
   if (hr) qps.push(param('hr', '1', qs));
+  if (ht) qps.push(param('ht', '1', qs));
   return qps.join('');
 
   // Constructs the transaction name param for the beacon URL.

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

@@ -25,8 +25,14 @@ export 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
   dispatchGlobalEvent({
-    loaded: true
+    agentIdentifier,
+    loaded: true,
+    drained: true,
+    type: 'lifecycle',
+    name: 'load',
+    feature: undefined,
+    data: flags
   });
 }

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

@@ -26,7 +26,7 @@ export class Aggregate extends AggregateBase {
     });
     this.ee.on(SESSION_EVENTS.UPDATE, (type, data) => {
       if (this.blocked || type !== SESSION_EVENT_TYPES.CROSS_TAB) return;
-      if (this.mode !== LOGGING_MODE.OFF && data.loggingMode === LOGGING_MODE.OFF) this.abort(ABORT_REASONS.CROSS_TAB);else this.mode = data.loggingMode;
+      if (this.loggingMode !== LOGGING_MODE.OFF && data.loggingMode === LOGGING_MODE.OFF) this.abort(ABORT_REASONS.CROSS_TAB);else this.loggingMode = data.loggingMode;
     });
     this.harvestOpts.raw = true;
     this.waitForFlags(['log']).then(([loggingMode]) => {

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

@@ -11,9 +11,11 @@ import { stylesheetEvaluator } from './stylesheet-evaluator';
 import { handle } from '../../../common/event-emitter/handle';
 import { SUPPORTABILITY_METRIC_CHANNEL } from '../../metrics/constants';
 import { FEATURE_NAMES } from '../../../loaders/features/features';
-import { buildNRMetaNode } from './utils';
+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 */
   #events;
@@ -23,6 +25,8 @@ export 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 = single(() => warn(47)); // notifies user of potential replayer issue if fix_stylesheets is off
+
   constructor(parent) {
     this.#events = new RecorderEvents();
     this.#backloggedEvents = new RecorderEvents();
@@ -83,14 +87,7 @@ export class Recorder {
       inline_images,
       collect_fonts
     } = this.parent.agentRef.init.session_replay;
-    const customMasker = (text, element) => {
-      try {
-        if (typeof element?.type === 'string' && element.type.toLowerCase() !== 'password' && (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 '*'.repeat(text?.length || 0);
-    };
+
     // set up rrweb configurations for maximum privacy --
     // https://newrelic.atlassian.net/wiki/spaces/O11Y/pages/2792293280/2023+02+28+Browser+-+Session+Replay#Configuration-options
     const stop = recorder({
@@ -131,6 +128,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);