@newrelic/browser-agent 1.289.0 → 1.290.0

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.290.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.289.0...v1.290.0) (2025-05-02)
+
+
+### Features
+
+* API Code Splitting ([#1433](https://github.com/newrelic/newrelic-browser-agent/issues/1433)) ([8e7498e](https://github.com/newrelic/newrelic-browser-agent/commit/8e7498e47a4666996f4837a53b02e8c313a48380))
+* bundler tools exports ([#1447](https://github.com/newrelic/newrelic-browser-agent/issues/1447)) ([c11b6de](https://github.com/newrelic/newrelic-browser-agent/commit/c11b6de857f42b4e2315012a897ac6693c67cd04))
+* Improve lazy-loading optimization ([#1443](https://github.com/newrelic/newrelic-browser-agent/issues/1443)) ([5668883](https://github.com/newrelic/newrelic-browser-agent/commit/56688831ed8fbf512dc70f1ebf37e648e498ece9))
+* Set UserAction currentUrl before aggregation end ([#1463](https://github.com/newrelic/newrelic-browser-agent/issues/1463)) ([177316b](https://github.com/newrelic/newrelic-browser-agent/commit/177316b8527ab158868da8ad9677c96fc60d08ea))
+
 ## [1.289.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.288.1...v1.289.0) (2025-04-24)
 
 

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";
 
 /**
  * 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";
 
 /**
  * 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. */