@newrelic/browser-agent 1.289.0 → 1.290.0-rc.0

package/README.md

@@ -251,6 +251,38 @@ import { Agent } from '@newrelic/browser-agent/loaders/agent'
 import { Metrics } from '@newrelic/browser-agent/src/features/metrics'
 ```
 
+## Bundling
+As an outcome of the design patterns employed in the browser agent package, building the agent can generate lazy-loaded chunks for many of the utilized modules. To concatenate, deduplicate and reduce those modules to a single lazy-loaded file the same way we do internally when shipping to our CDN, you can choose to utilize the `"build-tools"` directory which includes rulesets for various build tools.  
+
+**Please note - This is an optional step.  The browser agent can be built without any rules instructing the build tools about the handling of the lazy-loaded chunks, or the chunks can be handled in any way you see fit to conform to your build process. This ruleset serves as an example of what we do internally when shipping to our CDN.**
+
+### Webpack
+For Webpack (v4+), you can choose to use our [webpack cache group rule](https://github.com/newrelic/newrelic-browser-agent/blob/main/tools/bundler-tools/bundler-tools.mjs) to instruct webpack on how to handle the agent's lazy chunks. The cacheGroup rule acts as a rule within the [SplitChunksPlugin](https://webpack.js.org/plugins/split-chunks-plugin/). Please observe the relevant documentation for use of this plugin. The output of this cache group rule will generate a lazy aggregate module, and lazy chunks for session replay, which matches the pattern found on our CDN distribution. 
+
+### Other
+Plugins for other bundling tools are planned for the future.
+
+```javascript
+// in webpack.config.js
+const { webpackCacheGroup } = require('@newrelic/browser-agent/tools/bundler-tools')
+// ... or ...
+import { webpackCacheGroup } from '@newrelic/browser-agent/tools/bundler-tools'
+
+{
+  // ... 
+  optimization: {
+      splitChunks: {
+        cacheGroups: {
+          // A ruleset for handling the browser agent modules
+          ...webpackCacheGroup(), 
+          // ... other cache groups
+        }
+      }
+    },
+  // ... 
+}
+```
+
 ## Library Support
 
 The browser agent is written to be agnostic to any JavaScript library or framework. The agent exposes a number of [API methods](https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/using-browser-apis/) that can be incorporated into libraries and frameworks. For example, export or make available the initialized agent and create a new error boundary in your react application that calls `browserAgent.noticeError()`.

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

@@ -17,7 +17,7 @@ exports.VERSION = exports.RRWEB_VERSION = exports.DIST_METHOD = exports.BUILD_EN
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.289.0";
+const VERSION = exports.VERSION = "1.290.0-rc.0";
 
 /**
  * Exposes the build type of the agent

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

@@ -17,7 +17,7 @@ exports.VERSION = exports.RRWEB_VERSION = exports.DIST_METHOD = exports.BUILD_EN
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.289.0";
+const VERSION = exports.VERSION = "1.290.0-rc.0";
 
 /**
  * Exposes the build type of the agent

package/dist/cjs/features/ajax/instrument/index.js

@@ -21,11 +21,11 @@ var _features = require("../../../loaders/features/features");
 var _constants2 = require("../../metrics/constants");
 var _now = require("../../../common/timing/now");
 var _denyList = require("../../../common/deny-list/deny-list");
-/**
+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.
  * SPDX-License-Identifier: Apache-2.0
  */
-
 var handlers = ['load', 'error', 'abort', 'timeout'];
 var handlersLen = handlers.length;
 var origRequest = (0, _nreum.gosNREUMOriginals)().o.REQ;
@@ -33,8 +33,8 @@ var origXHR = (0, _nreum.gosNREUMOriginals)().o.XHR;
 const NR_CAT_HEADER = 'X-NewRelic-App-Data';
 class Instrument extends _instrumentBase.InstrumentBase {
   static featureName = _constants.FEATURE_NAME;
-  constructor(agentRef, auto = true) {
-    super(agentRef, _constants.FEATURE_NAME, auto);
+  constructor(agentRef) {
+    super(agentRef, _constants.FEATURE_NAME);
     this.dt = new _distributedTracing.DT(agentRef);
     this.handler = (type, args, ctx, group) => (0, _handle.handle)(type, args, ctx, group, this.ee);
 
@@ -72,7 +72,7 @@ class Instrument extends _instrumentBase.InstrumentBase {
     (0, _wrapFetch.wrapFetch)(this.ee);
     (0, _wrapXhr.wrapXhr)(this.ee);
     subscribeToEvents(agentRef, this.ee, this.handler, this.dt);
-    this.importAggregator(agentRef);
+    this.importAggregator(agentRef, () => Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "ajax-aggregate" */'../aggregate/index.js'))));
   }
 }
 exports.Instrument = Instrument;

package/dist/cjs/features/generic_events/aggregate/index.js

@@ -83,6 +83,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
                 actionMs: aggregatedUserAction.relativeMs,
                 rageClick: aggregatedUserAction.rageClick,
                 target: aggregatedUserAction.selectorPath,
+                currentUrl: aggregatedUserAction.currentUrl,
                 ...((0, _iframe.isIFrameWindow)(window) && {
                   iframe: true
                 }),

package/dist/cjs/features/generic_events/aggregate/user-actions/aggregated-user-action.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.AggregatedUserAction = void 0;
 var _constants = require("../../constants");
+var _cleanUrl = require("../../../../common/url/clean-url");
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -19,6 +20,7 @@ class AggregatedUserAction {
     this.selectorPath = selectorPath;
     this.rageClick = undefined;
     this.nearestTargetFields = nearestTargetFields;
+    this.currentUrl = (0, _cleanUrl.cleanURL)('' + location);
   }
 
   /**

package/dist/cjs/features/generic_events/instrument/index.js

@@ -8,19 +8,29 @@ var _runtime = require("../../../common/constants/runtime");
 var _handle = require("../../../common/event-emitter/handle");
 var _eventListenerOpts = require("../../../common/event-listener/event-listener-opts");
 var _invoke = require("../../../common/util/invoke");
+var _addPageAction = require("../../../loaders/api/addPageAction");
+var _finished = require("../../../loaders/api/finished");
+var _recordCustomEvent = require("../../../loaders/api/recordCustomEvent");
+var _register = require("../../../loaders/api/register");
 var _instrumentBase = require("../../utils/instrument-base");
 var _constants = require("../constants");
-/**
+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.
  * SPDX-License-Identifier: Apache-2.0
  */
-
 class Instrument extends _instrumentBase.InstrumentBase {
   static featureName = _constants.FEATURE_NAME;
-  constructor(agentRef, auto = true) {
-    super(agentRef, _constants.FEATURE_NAME, auto);
+  constructor(agentRef) {
+    super(agentRef, _constants.FEATURE_NAME);
     /** config values that gate whether the generic events aggregator should be imported at all */
     const genericEventSourceConfigs = [agentRef.init.page_action.enabled, agentRef.init.performance.capture_marks, agentRef.init.performance.capture_measures, agentRef.init.user_actions.enabled, agentRef.init.performance.resources.enabled];
+
+    /** feature specific APIs */
+    (0, _addPageAction.setupAddPageActionAPI)(agentRef);
+    (0, _recordCustomEvent.setupRecordCustomEventAPI)(agentRef);
+    (0, _finished.setupFinishedAPI)(agentRef);
+    (0, _register.setupRegisterAPI)(agentRef);
     if (_runtime.isBrowserScope) {
       if (agentRef.init.user_actions.enabled) {
         _constants.OBSERVED_EVENTS.forEach(eventType => (0, _eventListenerOpts.windowAddEventListener)(eventType, evt => (0, _handle.handle)('ua', [evt], undefined, this.featureName, this.ee), true));
@@ -49,7 +59,7 @@ class Instrument extends _instrumentBase.InstrumentBase {
     }
 
     /** If any of the sources are active, import the aggregator. otherwise deregister */
-    if (genericEventSourceConfigs.some(x => x)) this.importAggregator(agentRef);else this.deregisterDrain();
+    if (genericEventSourceConfigs.some(x => x)) this.importAggregator(agentRef, () => Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "generic_events-aggregate" */'../aggregate'))));else this.deregisterDrain();
   }
 }
 exports.Instrument = Instrument;

package/dist/cjs/features/jserrors/instrument/index.js

@@ -12,16 +12,26 @@ var _eventListenerOpts = require("../../../common/event-listener/event-listener-
 var _now = require("../../../common/timing/now");
 var _constants2 = require("../../session_replay/constants");
 var _castError = require("../shared/cast-error");
-/**
+var _noticeError = require("../../../loaders/api/noticeError");
+var _setErrorHandler = require("../../../loaders/api/setErrorHandler");
+var _addRelease = require("../../../loaders/api/addRelease");
+var _register = require("../../../loaders/api/register");
+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.
  * SPDX-License-Identifier: Apache-2.0
  */
-
 class Instrument extends _instrumentBase.InstrumentBase {
   static featureName = _constants.FEATURE_NAME;
   #replayRunning = false;
-  constructor(agentRef, auto = true) {
-    super(agentRef, _constants.FEATURE_NAME, auto);
+  constructor(agentRef) {
+    super(agentRef, _constants.FEATURE_NAME);
+
+    /** feature specific APIs */
+    (0, _noticeError.setupNoticeErrorAPI)(agentRef);
+    (0, _setErrorHandler.setupSetErrorHandlerAPI)(agentRef);
+    (0, _addRelease.setupAddReleaseAPI)(agentRef);
+    (0, _register.setupRegisterAPI)(agentRef);
     try {
       // this try-catch can be removed when IE11 is completely unsupported & gone
       this.removeOnAbort = new AbortController();
@@ -44,7 +54,7 @@ class Instrument extends _instrumentBase.InstrumentBase {
       (0, _handle.handle)('err', [(0, _castError.castErrorEvent)(errorEvent), (0, _now.now)(), false, {}, this.#replayRunning], undefined, this.featureName, this.ee);
     }, (0, _eventListenerOpts.eventListenerOpts)(false, this.removeOnAbort?.signal));
     this.abortHandler = this.#abort; // we also use this as a flag to denote that the feature is active or on and handling errors
-    this.importAggregator(agentRef);
+    this.importAggregator(agentRef, () => Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "jserrors-aggregate" */'../aggregate'))));
   }
 
   /** Restoration and resource release tasks to be done if JS error loader is being aborted. Unwind changes to globals. */

package/dist/cjs/features/logging/instrument/index.js

@@ -9,15 +9,23 @@ var _constants = require("../constants");
 var _utils = require("../shared/utils");
 var _wrapLogger = require("../../../common/wrap/wrap-logger");
 var _runtime = require("../../../common/constants/runtime");
-/**
+var _log = require("../../../loaders/api/log");
+var _wrapLogger2 = require("../../../loaders/api/wrapLogger");
+var _register = require("../../../loaders/api/register");
+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.
  * SPDX-License-Identifier: Apache-2.0
  */
-
 class Instrument extends _instrumentBase.InstrumentBase {
   static featureName = _constants.FEATURE_NAME;
-  constructor(agentRef, auto = true) {
-    super(agentRef, _constants.FEATURE_NAME, auto);
+  constructor(agentRef) {
+    super(agentRef, _constants.FEATURE_NAME);
+
+    /** feature specific APIs */
+    (0, _log.setupLogAPI)(agentRef);
+    (0, _wrapLogger2.setupWrapLoggerAPI)(agentRef);
+    (0, _register.setupRegisterAPI)(agentRef);
     const instanceEE = this.ee;
     (0, _wrapLogger.wrapLogger)(instanceEE, _runtime.globalScope.console, 'log', {
       level: 'info'
@@ -45,7 +53,7 @@ class Instrument extends _instrumentBase.InstrumentBase {
       } = this;
       (0, _utils.bufferLog)(instanceEE, message, customAttributes, level);
     });
-    this.importAggregator(agentRef);
+    this.importAggregator(agentRef, () => Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "logging-aggregate" */'../aggregate'))));
   }
 }
 exports.Instrument = Instrument;

package/dist/cjs/features/metrics/instrument/index.js

@@ -8,18 +8,18 @@ var _runtime = require("../../../common/constants/runtime");
 var _handle = require("../../../common/event-emitter/handle");
 var _instrumentBase = require("../../utils/instrument-base");
 var _constants = require("../constants");
-/**
+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.
  * SPDX-License-Identifier: Apache-2.0
  */
-
 // import { handle } from '../../../common/event-emitter/handle'
 // import { WEBSOCKET_TAG, wrapWebSocket } from '../../../common/wrap/wrap-websocket'
 
 class Instrument extends _instrumentBase.InstrumentBase {
   static featureName = _constants.FEATURE_NAME;
-  constructor(agentRef, auto = true) {
-    super(agentRef, _constants.FEATURE_NAME, auto);
+  constructor(agentRef) {
+    super(agentRef, _constants.FEATURE_NAME);
     // wrapWebSocket(this.ee) - feb'25 : removing wrapping again to avoid integration issues
 
     // WATCHABLE_WEB_SOCKET_EVENTS.forEach((suffix) => {
@@ -33,7 +33,7 @@ class Instrument extends _instrumentBase.InstrumentBase {
         (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['Generic/CSPViolation/Detected'], undefined, this.featureName, this.ee);
       });
     }
-    this.importAggregator(agentRef);
+    this.importAggregator(agentRef, () => Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "metrics-aggregate" */'../aggregate'))));
   }
 }
 exports.Instrument = Instrument;

package/dist/cjs/features/page_action/instrument/index.js

@@ -13,11 +13,7 @@ var _generic_events = require("../../generic_events");
 /**
  * @deprecated This feature has been replaced by Generic Events. Use/Import `GenericEvents` instead. This wrapper will be removed in a future release
  */
-class Instrument extends _generic_events.GenericEvents {
-  constructor(agentIdentifier, aggregator, auto = true) {
-    super(agentIdentifier, aggregator, auto);
-  }
-}
+class Instrument extends _generic_events.GenericEvents {}
 
 /**
  * @deprecated This feature has been replaced by Generic Events. Use/Import `GenericEvents` instead. This wrapper will be removed in a future release

package/dist/cjs/features/page_view_event/instrument/index.js

@@ -5,23 +5,25 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.PageViewEvent = exports.Instrument = void 0;
 var _handle = require("../../../common/event-emitter/handle");
+var _setPageViewName = require("../../../loaders/api/setPageViewName");
 var _instrumentBase = require("../../utils/instrument-base");
 var CONSTANTS = _interopRequireWildcard(require("../constants"));
 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; }
-/**
+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.
  * SPDX-License-Identifier: Apache-2.0
  */
-
 class Instrument extends _instrumentBase.InstrumentBase {
   static featureName = CONSTANTS.FEATURE_NAME;
-  constructor(agentRef, auto = true) {
-    super(agentRef, CONSTANTS.FEATURE_NAME, auto);
+  constructor(agentRef) {
+    super(agentRef, CONSTANTS.FEATURE_NAME);
+
+    /** feature specific APIs */
+    (0, _setPageViewName.setupSetPageViewNameAPI)(agentRef);
 
     /** messages from the register API that can trigger a new RUM call */
     this.ee.on('api-send-rum', (attrs, target) => (0, _handle.handle)('send-rum', [attrs, target], undefined, this.featureName, this.ee));
-    this.importAggregator(agentRef);
+    this.importAggregator(agentRef, () => Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "page_view_event-aggregate" */'../aggregate'))));
   }
 }
 exports.Instrument = Instrument;

package/dist/cjs/features/page_view_timing/instrument/index.js

@@ -11,15 +11,15 @@ var _instrumentBase = require("../../utils/instrument-base");
 var _constants = require("../constants");
 var _runtime = require("../../../common/constants/runtime");
 var _now = require("../../../common/timing/now");
-/**
+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.
  * SPDX-License-Identifier: Apache-2.0
  */
-
 class Instrument extends _instrumentBase.InstrumentBase {
   static featureName = _constants.FEATURE_NAME;
-  constructor(agentRef, auto = true) {
-    super(agentRef, _constants.FEATURE_NAME, auto);
+  constructor(agentRef) {
+    super(agentRef, _constants.FEATURE_NAME);
     if (!_runtime.isBrowserScope) return; // CWV is irrelevant outside web context
 
     // While we try to replicate web-vital's visibilitywatcher logic in an effort to defer that library to post-pageload, this isn't perfect and doesn't consider prerendering.
@@ -27,7 +27,7 @@ class Instrument extends _instrumentBase.InstrumentBase {
 
     // Window fires its pagehide event (typically on navigation--this occurrence is a *subset* of vis change); don't defer this unless it's guarantee it cannot happen before load(?)
     (0, _eventListenerOpts.windowAddEventListener)('pagehide', () => (0, _handle.handle)('winPagehide', [(0, _now.now)()], undefined, _constants.FEATURE_NAME, this.ee));
-    this.importAggregator(agentRef);
+    this.importAggregator(agentRef, () => Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "page_view_timing-aggregate" */'../aggregate'))));
   }
 }
 exports.Instrument = Instrument;

package/dist/cjs/features/session_replay/instrument/index.js

@@ -9,6 +9,8 @@ var _constants = require("../../../common/session/constants");
 var _instrumentBase = require("../../utils/instrument-base");
 var _utils = require("../shared/utils");
 var _constants2 = require("../constants");
+var _recordReplay = require("../../../loaders/api/recordReplay");
+var _pauseReplay = require("../../../loaders/api/pauseReplay");
 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.
@@ -20,8 +22,12 @@ class Instrument extends _instrumentBase.InstrumentBase {
   static featureName = _constants2.FEATURE_NAME;
   #mode;
   #agentRef;
-  constructor(agentRef, auto = true) {
-    super(agentRef, _constants2.FEATURE_NAME, auto);
+  constructor(agentRef) {
+    super(agentRef, _constants2.FEATURE_NAME);
+
+    /** feature specific APIs */
+    (0, _recordReplay.setupRecordReplayAPI)(agentRef);
+    (0, _pauseReplay.setupPauseReplayAPI)(agentRef);
     let session;
     this.replayRunning = false;
     this.#agentRef = agentRef;
@@ -35,7 +41,7 @@ class Instrument extends _instrumentBase.InstrumentBase {
       this.#mode = session?.sessionReplayMode;
       this.#preloadStartRecording();
     } else {
-      this.importAggregator(agentRef);
+      this.importAggregator(this.#agentRef, () => Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "session_replay-aggregate" */'../aggregate'))));
     }
 
     /** If the recorder is running, we can pass error events on to the agg to help it switch to full mode later */
@@ -90,7 +96,7 @@ class Instrument extends _instrumentBase.InstrumentBase {
       this.recorder.startRecording();
       this.abortHandler = this.recorder.stopRecording;
     } catch (e) {} // TODO add internal error handling
-    this.importAggregator(this.#agentRef, {
+    this.importAggregator(this.#agentRef, () => Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "session_replay-aggregate" */'../aggregate'))), {
       recorder: this.recorder,
       errorNoticed: this.errorNoticed
     });

package/dist/cjs/features/session_trace/instrument/index.js

@@ -12,13 +12,13 @@ var CONSTANTS = _interopRequireWildcard(require("../constants"));
 var _features = require("../../../loaders/features/features");
 var _featureGates = require("../../utils/feature-gates");
 var _now = require("../../../common/timing/now");
+var _addToTrace = require("../../../loaders/api/addToTrace");
+var _finished = require("../../../loaders/api/finished");
 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; }
-/**
+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.
  * SPDX-License-Identifier: Apache-2.0
  */
-
 const {
   BST_RESOURCE,
   RESOURCE,
@@ -31,8 +31,12 @@ const {
 } = CONSTANTS;
 class Instrument extends _instrumentBase.InstrumentBase {
   static featureName = FEATURE_NAME;
-  constructor(agentRef, auto = true) {
-    super(agentRef, FEATURE_NAME, auto);
+  constructor(agentRef) {
+    super(agentRef, FEATURE_NAME);
+
+    /** feature specific APIs */
+    (0, _addToTrace.setupAddToTraceAPI)(agentRef);
+    (0, _finished.setupFinishedAPI)(agentRef);
     const canTrackSession = (0, _featureGates.canEnableSessionTracking)(agentRef.init);
     if (!canTrackSession) {
       this.deregisterDrain();
@@ -71,7 +75,7 @@ class Instrument extends _instrumentBase.InstrumentBase {
     } catch (e) {
       // Per NEWRELIC-8525, we don't have a fallback for capturing resources for older versions that don't support PO at this time.
     }
-    this.importAggregator(agentRef, {
+    this.importAggregator(agentRef, () => Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "session_trace-aggregate" */'../aggregate'))), {
       resourceObserver: observer
     });
   }

package/dist/cjs/features/soft_navigations/instrument/index.js

@@ -13,11 +13,12 @@ var _wrapHistory = require("../../../common/wrap/wrap-history");
 var _instrumentBase = require("../../utils/instrument-base");
 var _constants = require("../constants");
 var _now = require("../../../common/timing/now");
-/**
+var _interaction = require("../../../loaders/api/interaction");
+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.
  * SPDX-License-Identifier: Apache-2.0
  */
-
 /**
  * The minimal time after a UI event for which no further events will be processed - i.e. a throttling rate to reduce spam.
  * This also give some time for the new interaction to complete without being discarded by a subsequent UI event and wrongly attributed.
@@ -27,8 +28,11 @@ const UI_WAIT_INTERVAL = 1 / 10 * 1000; // assume 10 fps
 
 class Instrument extends _instrumentBase.InstrumentBase {
   static featureName = _constants.FEATURE_NAME;
-  constructor(agentRef, auto = true) {
-    super(agentRef, _constants.FEATURE_NAME, auto);
+  constructor(agentRef) {
+    super(agentRef, _constants.FEATURE_NAME);
+
+    /** feature specific APIs */
+    (0, _interaction.setupInteractionAPI)(agentRef);
     if (!_runtime.isBrowserScope || !(0, _nreum.gosNREUMOriginals)().o.MO) return; // soft navigations is not supported outside web env or browsers without the mutation observer API
 
     const historyEE = (0, _wrapHistory.wrapHistory)(this.ee);
@@ -67,7 +71,7 @@ class Instrument extends _instrumentBase.InstrumentBase {
       leading: true
     });
     this.abortHandler = abort;
-    this.importAggregator(agentRef, {
+    this.importAggregator(agentRef, () => Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "soft_navigations-aggregate" */'../aggregate'))), {
       domObserver
     });
     function abort() {

package/dist/cjs/features/spa/instrument/index.js

@@ -17,13 +17,12 @@ var _wrapXhr = require("../../../common/wrap/wrap-xhr");
 var _wrapFetch = require("../../../common/wrap/wrap-fetch");
 var _wrapHistory = require("../../../common/wrap/wrap-history");
 var _wrapMutation = require("../../../common/wrap/wrap-mutation");
+var _interaction = require("../../../loaders/api/interaction");
 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; }
-/**
+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.
  * SPDX-License-Identifier: Apache-2.0
  */
-
 const {
   FEATURE_NAME,
   START,
@@ -42,8 +41,11 @@ const {
  */
 class Instrument extends _instrumentBase.InstrumentBase {
   static featureName = FEATURE_NAME;
-  constructor(agentRef, auto = true) {
-    super(agentRef, FEATURE_NAME, auto);
+  constructor(agentRef) {
+    super(agentRef, FEATURE_NAME);
+
+    /** feature specific APIs */
+    (0, _interaction.setupInteractionAPI)(agentRef);
     if (!_runtime.isBrowserScope) return; // SPA not supported outside web env
 
     try {
@@ -114,7 +116,7 @@ class Instrument extends _instrumentBase.InstrumentBase {
       });
     }
     this.abortHandler = this.#abort;
-    this.importAggregator(agentRef);
+    this.importAggregator(agentRef, () => Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "spa-aggregate" */'../aggregate'))));
   }
 
   /** Restoration and resource release tasks to be done if SPA loader is being aborted. Unwind changes to globals and subscription to DOM events. */

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

@@ -31,13 +31,9 @@ class InstrumentBase extends _featureBase.FeatureBase {
    * Instantiate InstrumentBase.
    * @param {string} agentIdentifier - The unique ID of the instantiated agent (relative to global scope).
    * @param {string} featureName - The name of the feature module (used to construct file path).
-   * @param {boolean} [auto=true] - Determines whether the feature should automatically register to have the draining
-   *     of its pooled instrumentation data handled by the agent's centralized drain functionality, rather than draining
-   *     immediately. Primarily useful for fine-grained control in tests.
    */
-  constructor(agentRef, featureName, auto = true) {
+  constructor(agentRef, featureName) {
     super(agentRef.agentIdentifier, featureName);
-    this.auto = auto;
 
     /** @type {Function | undefined} This should be set by any derived Instrument class if it has things to do when feature fails or is killed. */
     this.abortHandler = undefined;
@@ -54,34 +50,45 @@ class InstrumentBase extends _featureBase.FeatureBase {
     */
     this.onAggregateImported = undefined;
 
-    /** used in conjunction with newrelic.start() to defer harvesting in features */
-    if (agentRef.init[this.featureName].autoStart === false) this.auto = false;
-    /** if the feature requires opt-in (!auto-start), it will get registered once the api has been called */
-    if (this.auto) (0, _drain.registerDrain)(agentRef.agentIdentifier, featureName);else {
-      this.ee.on('manual-start-all', (0, _invoke.single)(() => {
-        // register the feature to drain only once the API has been called, it will drain when importAggregator finishes for all the features
-        // called by the api in that cycle
-        (0, _drain.registerDrain)(agentRef.agentIdentifier, this.featureName);
-        this.auto = true;
-        this.importAggregator(agentRef);
-      }));
+    /**
+     * used in conjunction with newrelic.start() to defer harvesting in features
+     * @type {Promise} Resolves when the feature is ready to import its aggregator, either immediately or after the start API has been called if the feature is autoStart: false.
+    */
+    this.deferred = Promise.resolve();
+    if (agentRef.init[this.featureName].autoStart === false) {
+      this.deferred = new Promise((resolve, reject) => {
+        this.ee.on('manual-start-all', (0, _invoke.single)(() => {
+          // register the feature to drain only once the API has been called, it will drain when importAggregator finishes for all the features
+          // called by the api in that cycle
+          (0, _drain.registerDrain)(agentRef.agentIdentifier, this.featureName);
+          resolve();
+        }));
+      });
+    } else {
+      /** if the feature requires opt-in (!auto-start), it will get registered once the api has been called */
+      (0, _drain.registerDrain)(agentRef.agentIdentifier, featureName);
     }
   }
 
   /**
    * Lazy-load the latter part of the feature: its aggregator. This method is called by the first part of the feature
    * (the instrumentation) when instrumentation is complete.
-   * @param agentRef - reference to the base agent ancestor that this feature belongs to
+   * @param {Object} agentRef - reference to the base agent ancestor that this feature belongs to
+   * @param {Function} fetchAggregator - a function that returns a promise that resolves to the aggregate module
    * @param {Object} [argsObjFromInstrument] - any values or references to pass down to aggregate
    * @returns void
    */
-  importAggregator(agentRef, argsObjFromInstrument = {}) {
-    if (this.featAggregate || !this.auto) return;
+  importAggregator(agentRef, fetchAggregator, argsObjFromInstrument = {}) {
+    if (this.featAggregate) return;
     let loadedSuccessfully;
     this.onAggregateImported = new Promise(resolve => {
       loadedSuccessfully = resolve;
     });
     const importLater = async () => {
+      // wait for the deferred promise to resolve before proceeding
+      // this will resolve immediately if the feature is auto-started,
+      // or otherwise when the manual-start-all event is emitted by the start API
+      await this.deferred;
       let session;
       try {
         if ((0, _featureGates.canEnableSessionTracking)(agentRef.init)) {
@@ -107,12 +114,9 @@ class InstrumentBase extends _featureBase.FeatureBase {
           loadedSuccessfully(false); // aggregate module isn't loaded at all
           return;
         }
-        const {
-          lazyFeatureLoader
-        } = await Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "lazy-feature-loader" */'./lazy-feature-loader')));
         const {
           Aggregate
-        } = await lazyFeatureLoader(this.featureName, 'aggregate');
+        } = await fetchAggregator();
         this.featAggregate = new Aggregate(agentRef, argsObjFromInstrument);
         agentRef.runtime.harvester.initializedAggregates.push(this.featAggregate); // "subscribe" the feature to future harvest intervals (PVE will start the timer)
         loadedSuccessfully(true);