@newrelic/browser-agent 1.289.0 → 1.290.0

package/dist/cjs/loaders/api-base.js

@@ -0,0 +1,224 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ApiBase = void 0;
+var _console = require("../common/util/console");
+var _constants = require("./api/constants");
+/**
+ * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @typedef {import('./api/interaction-types').InteractionInstance} InteractionInstance
+ */
+class ApiBase {
+  #callMethod(methodName, ...args) {
+    if (this[methodName] === ApiBase.prototype[methodName]) (0, _console.warn)(35, methodName);else return this[methodName](...args);
+  }
+
+  // MicroAgent class custom defines its own start
+
+  /**
+   * Reports a browser PageAction event along with a name and optional attributes.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/addpageaction/}
+   * @param {string} name Name or category of the action. Reported as the actionName attribute.
+   * @param {object} [attributes] JSON object with one or more key/value pairs. For example: {key:"value"}. The key is reported as its own PageAction attribute with the specified values.
+   */
+  addPageAction(name, attributes) {
+    return this.#callMethod(_constants.ADD_PAGE_ACTION, name, attributes);
+  }
+
+  /**
+   * @experimental
+   * IMPORTANT: This feature is being developed for use internally and is not in a public-facing production-ready state.
+   * It is not recommended for use in production environments and will not receive support for issues.
+   *
+   * Registers an external caller to report through the base agent to a different target than the base agent.
+   * @param {object} target the target object to report data to
+   * @param {string} target.licenseKey The licenseKey to report data to
+   * @param {string} target.applicationID The applicationID to report data to
+   * @param {string=} target.entityGuid The entityGuid to report data to
+   * @returns {object} Returns an object that contains the available API methods and configurations to use with the external caller. See loaders/api/api.js for more information.
+   */
+  register(target) {
+    return this.#callMethod(_constants.REGISTER, target);
+  }
+
+  /**
+   * Records a custom event with a specified eventType and attributes.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/recordCustomEvent/}
+   * @param {string} eventType The eventType to store the event as.
+   * @param {object} [attributes] JSON object with one or more key/value pairs. For example: {key:"value"}.
+   */
+  recordCustomEvent(eventType, attributes) {
+    return this.#callMethod(_constants.RECORD_CUSTOM_EVENT, eventType, attributes);
+  }
+
+  /**
+   * Groups page views to help URL structure or to capture the URL's routing information.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setpageviewname/}
+   * @param {string} name The page name you want to use. Use alphanumeric characters.
+   * @param {string} [host] Default is http://custom.transaction. Typically set host to your site's domain URI.
+   */
+  setPageViewName(name, host) {
+    return this.#callMethod(_constants.SET_PAGE_VIEW_NAME, name, host);
+  }
+
+  /**
+   * Adds a user-defined attribute name and value to subsequent events on the page.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setcustomattribute/}
+   * @param {string} name Name of the attribute. Appears as column in the PageView event. It will also appear as a column in the PageAction event if you are using it.
+   * @param {string|number|boolean|null} value Value of the attribute. Appears as the value in the named attribute column in the PageView event. It will appear as a column in the PageAction event if you are using it. Custom attribute values cannot be complex objects, only simple types such as Strings, Integers and Booleans. Passing a null value unsets any existing attribute of the same name.
+   * @param {boolean} [persist] Default false. If set to true, the name-value pair will also be set into the browser's storage API. Then on the following instrumented pages that load within the same session, the pair will be re-applied as a custom attribute.
+   */
+  setCustomAttribute(name, value, persist) {
+    return this.#callMethod(_constants.SET_CUSTOM_ATTRIBUTE, name, value, persist);
+  }
+
+  /**
+   * Identifies a browser error without disrupting your app's operations.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/noticeerror/}
+   * @param {Error|string} error Provide a meaningful error message that you can use when analyzing data on browser's JavaScript errors page.
+   * @param {object} [customAttributes] An object containing name/value pairs representing custom attributes.
+   */
+  noticeError(error, customAttributes) {
+    return this.#callMethod(_constants.NOTICE_ERROR, error, customAttributes);
+  }
+
+  /**
+   * Adds a user-defined identifier string to subsequent events on the page.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setuserid/}
+   * @param {string|null} value A string identifier for the end-user, useful for tying all browser events to specific users. The value parameter does not have to be unique. If IDs should be unique, the caller is responsible for that validation. Passing a null value unsets any existing user ID.
+   */
+  setUserId(value) {
+    return this.#callMethod(_constants.SET_USER_ID, value);
+  }
+
+  /**
+   * Adds a user-defined application version string to subsequent events on the page.
+   * This decorates all payloads with an attribute of `application.version` which is queryable in NR1.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setapplicationversion/}
+   * @param {string|null} value A string identifier for the application version, useful for
+   * tying all browser events to a specific release tag. The value parameter does not
+   * have to be unique. Passing a null value unsets any existing value.
+   */
+  setApplicationVersion(value) {
+    return this.#callMethod(_constants.SET_APPLICATION_VERSION, value);
+  }
+
+  /**
+   * Allows selective ignoring and grouping of known errors that the browser agent captures.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/seterrorhandler/}
+   * @param {(error: Error|string) => boolean | { group: string }} callback When an error occurs, the callback is called with the error object as a parameter. The callback will be called with each error, so it is not specific to one error.
+   */
+  setErrorHandler(callback) {
+    return this.#callMethod(_constants.SET_ERROR_HANDLER, callback);
+  }
+
+  /**
+   * Adds a unique name and ID to identify releases with multiple JavaScript bundles on the same page.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/addrelease/}
+   * @param {string} name A short description of the component; for example, the name of a project, application, file, or library.
+   * @param {string} id The ID or version of this release; for example, a version number, build number from your CI environment, GitHub SHA, GUID, or a hash of the contents.
+   */
+  addRelease(name, id) {
+    return this.#callMethod(_constants.ADD_RELEASE, name, id);
+  }
+
+  /**
+   * Capture a single log.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/log/}
+   * @param {string} message String to be captured as log message
+   * @param {{customAttributes?: object, level?: 'ERROR'|'TRACE'|'DEBUG'|'INFO'|'WARN'}} [options] customAttributes defaults to `{}` if not assigned, level defaults to `info` if not assigned.
+  */
+  log(message, options) {
+    return this.#callMethod(_constants.LOG, message, options);
+  }
+
+  /**
+   * Starts any and all features that are not running yet in "autoStart" mode
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/start/}
+   */
+  start() {
+    return this.#callMethod(_constants.START);
+  }
+
+  /**
+   * Records an additional time point as "finished" in a session trace and adds a page action.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/finished/}
+   * @param {number} [timeStamp] Defaults to the current time of the call. If used, this marks the time that the page is "finished" according to your own criteria.
+   */
+  finished(timeStamp) {
+    return this.#callMethod(_constants.FINISHED, timeStamp);
+  }
+
+  /**
+   * Forces a replay to record. If a replay is already actively recording, this call will be ignored.
+   * If a recording has not been started, a new one will be created. If a recording has been started, but is currently not recording, it will resume recording.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/recordReplay/}
+   */
+  recordReplay() {
+    return this.#callMethod(_constants.RECORD_REPLAY);
+  }
+
+  /**
+   * Forces an active replay to pause recording.  If a replay is already actively recording, this call will cause the recording to pause.
+   * If a recording is not currently recording, this call will be ignored.  This API will pause both manual and automatic replays that are in progress.
+   * The only way to resume recording after manually pausing a replay is to manually record again using the recordReplay() API.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/pauseReplay/}
+   */
+  pauseReplay() {
+    return this.#callMethod(_constants.PAUSE_REPLAY);
+  }
+
+  /**
+   * Adds a JavaScript object with a custom name, start time, etc. to an in-progress session trace.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/addtotrace/}
+   * @param {{name: string, start: number, end?: number, origin?: string, type?: string}} customAttributes Supply a JavaScript object with these required and optional name/value pairs:
+   *
+   * - Required name/value pairs: name, start
+   * - Optional name/value pairs: end, origin, type
+   * - Note: Does not apply to MicroAgent
+   *
+   * If you are sending the same event object to New Relic as a PageAction, omit the TYPE attribute. (type is a string to describe what type of event you are marking inside of a session trace.) If included, it will override the event type and cause the PageAction event to be sent incorrectly. Instead, use the name attribute for event information.
+   */
+  addToTrace(customAttributes) {
+    return this.#callMethod(_constants.ADD_TO_TRACE, customAttributes);
+  }
+
+  /**
+   * Gives SPA routes more accurate names than default names. Monitors specific routes rather than by default grouping.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setcurrentroutename/}
+   * @param {string} name Current route name for the page.
+   *  - Note: Does not apply to MicroAgent
+   */
+  setCurrentRouteName(name) {
+    return this.#callMethod(_constants.SET_CURRENT_ROUTE_NAME, name);
+  }
+
+  /**
+   * Returns a new API object that is bound to the current SPA interaction.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/interaction/}
+   * @returns {InteractionInstance} An API object that is bound to a specific BrowserInteraction event. Each time this method is called for the same BrowserInteraction, a new object is created, but it still references the same interaction.
+   *  - Note: Does not apply to MicroAgent
+   *  - Deprecation Notice: interaction.createTracer is deprecated.  See https://docs.newrelic.com/eol/2024/04/eol-04-24-24-createtracer/ for more information.
+  */
+  interaction() {
+    return this.#callMethod(_constants.INTERACTION);
+  }
+
+  /**
+   * Wrap a logger function to capture a log each time the function is invoked with the message and arguments passed
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/wraplogger/}
+   * @param {object} parent The parent object containing the logger method
+   * @param {string} functionName The property name of the function in the parent object to be wrapped
+   * @param {{customAttributes?: object, level?: 'ERROR'|'TRACE'|'DEBUG'|'INFO'|'WARN'}} [options] customAttributes defaults to `{}` if not assigned, level defaults to `info` if not assigned.
+  */
+  wrapLogger(parent, functionName, options) {
+    return this.#callMethod(_constants.WRAP_LOGGER, parent, functionName, options);
+  }
+}
+exports.ApiBase = ApiBase;

package/dist/cjs/loaders/configure/configure.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.configure = configure;
-var _api = require("../api/api");
+var _topLevelCallers = require("../api/topLevelCallers");
 var _nreum = require("../../common/window/nreum");
 var _info = require("../../common/config/info");
 var _init = require("../../common/config/init");
@@ -59,7 +59,7 @@ function configure(agent, opts = {}, loaderType, forceDrain) {
       internalTrafficList.push(updatedInit.proxy.assets);
     }
     if (updatedInit.proxy.beacon) internalTrafficList.push(updatedInit.proxy.beacon);
-    (0, _api.setTopLevelCallers)(); // no need to set global APIs on newrelic obj more than once
+    (0, _topLevelCallers.setTopLevelCallers)(agent); // no need to set global APIs on newrelic obj more than once
     (0, _nreum.addToNREUM)('activatedFeatures', _featureFlags.activatedFeatures);
 
     // Update if soft_navigations is allowed to run AND part of this agent build, used to override old spa functions.
@@ -72,8 +72,6 @@ function configure(agent, opts = {}, loaderType, forceDrain) {
   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],

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

@@ -4,145 +4,14 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.MicroAgentBase = void 0;
-var _console = require("../common/util/console");
 var _uniqueId = require("../common/ids/unique-id");
+var _apiBase = require("./api-base");
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
-class MicroAgentBase {
-  agentIdentifier;
-  constructor() {
-    this.agentIdentifier = (0, _uniqueId.generateRandomHexString)(16);
-  }
-
-  /**
-   * Tries to execute the api and generates a generic warning message with the api name injected if unsuccessful
-   * @param {string} methodName
-   * @param  {...any} args
-   */
-  #callMethod(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
-
-  /**
-   * Reports a browser PageAction event along with a name and optional attributes.
-   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/addpageaction/}
-   * @param {string} name Name or category of the action. Reported as the actionName attribute.
-   * @param {object} [attributes] JSON object with one or more key/value pairs. For example: {key:"value"}. The key is reported as its own PageAction attribute with the specified values.
-   */
-  addPageAction(name, attributes) {
-    return this.#callMethod('addPageAction', name, attributes);
-  }
-
-  /**
-   * @experimental
-   * IMPORTANT: This feature is being developed for use internally and is not in a public-facing production-ready state.
-   * It is not recommended for use in production environments and will not receive support for issues.
-   *
-   * Registers an external caller to report through the base agent to a different target than the base agent.
-   * @param {object} target the target object to report data to
-   * @param {string} target.licenseKey The licenseKey to report data to
-   * @param {string} target.applicationID The applicationID to report data to
-   * @param {string=} target.entityGuid The entityGuid to report data to
-   * @returns {object} Returns an object that contains the available API methods and configurations to use with the external caller. See loaders/api/api.js for more information.
-   */
-  register(target) {
-    return this.#callMethod('register', target);
-  }
-
-  /**
-   * Records a custom event with a specified eventType and attributes.
-   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/recordCustomEvent/}
-   * @param {string} eventType The eventType to store the event as.
-   * @param {object} [attributes] JSON object with one or more key/value pairs. For example: {key:"value"}.
-   */
-  recordCustomEvent(eventType, attributes) {
-    return this.#callMethod('recordCustomEvent', eventType, attributes);
-  }
-
-  /**
-   * Groups page views to help URL structure or to capture the URL's routing information.
-   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setpageviewname/}
-   * @param {string} name The page name you want to use. Use alphanumeric characters.
-   * @param {string} [host] Default is http://custom.transaction. Typically set host to your site's domain URI.
-   */
-  setPageViewName(name, host) {
-    return this.#callMethod('setPageViewName', name, host);
-  }
-
-  /**
-   * Adds a user-defined attribute name and value to subsequent events on the page.
-   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setcustomattribute/}
-   * @param {string} name Name of the attribute. Appears as column in the PageView event. It will also appear as a column in the PageAction event if you are using it.
-   * @param {string|number|boolean|null} value Value of the attribute. Appears as the value in the named attribute column in the PageView event. It will appear as a column in the PageAction event if you are using it. Custom attribute values cannot be complex objects, only simple types such as Strings, Integers and Booleans. Passing a null value unsets any existing attribute of the same name.
-   * @param {boolean} [persist] Default false. If set to true, the name-value pair will also be set into the browser's storage API. Then on the following instrumented pages that load within the same session, the pair will be re-applied as a custom attribute.
-   */
-  setCustomAttribute(name, value, persist) {
-    return this.#callMethod('setCustomAttribute', name, value, persist);
-  }
-
-  /**
-   * Identifies a browser error without disrupting your app's operations.
-   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/noticeerror/}
-   * @param {Error|string} error Provide a meaningful error message that you can use when analyzing data on browser's JavaScript errors page.
-   * @param {object} [customAttributes] An object containing name/value pairs representing custom attributes.
-   */
-  noticeError(error, customAttributes) {
-    return this.#callMethod('noticeError', error, customAttributes);
-  }
-
-  /**
-   * Adds a user-defined identifier string to subsequent events on the page.
-   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setuserid/}
-   * @param {string|null} value A string identifier for the end-user, useful for tying all browser events to specific users. The value parameter does not have to be unique. If IDs should be unique, the caller is responsible for that validation. Passing a null value unsets any existing user ID.
-   */
-  setUserId(value) {
-    return this.#callMethod('setUserId', value);
-  }
-
-  /**
-   * Adds a user-defined application version string to subsequent events on the page.
-   * This decorates all payloads with an attribute of `application.version` which is queryable in NR1.
-   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setapplicationversion/}
-   * @param {string|null} value A string identifier for the application version, useful for
-   * tying all browser events to a specific release tag. The value parameter does not
-   * have to be unique. Passing a null value unsets any existing value.
-   */
-  setApplicationVersion(value) {
-    return this.#callMethod('setApplicationVersion', value);
-  }
-
-  /**
-   * Allows selective ignoring and grouping of known errors that the browser agent captures.
-   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/seterrorhandler/}
-   * @param {(error: Error|string) => boolean | { group: string }} callback When an error occurs, the callback is called with the error object as a parameter. The callback will be called with each error, so it is not specific to one error.
-   */
-  setErrorHandler(callback) {
-    return this.#callMethod('setErrorHandler', callback);
-  }
-
-  /**
-   * Adds a unique name and ID to identify releases with multiple JavaScript bundles on the same page.
-   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/addrelease/}
-   * @param {string} name A short description of the component; for example, the name of a project, application, file, or library.
-   * @param {string} id The ID or version of this release; for example, a version number, build number from your CI environment, GitHub SHA, GUID, or a hash of the contents.
-   */
-  addRelease(name, id) {
-    return this.#callMethod('addRelease', name, id);
-  }
-
-  /**
-   * Capture a single log.
-   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/log/}
-   * @param {string} message String to be captured as log message
-   * @param {{customAttributes?: object, level?: 'ERROR'|'TRACE'|'DEBUG'|'INFO'|'WARN'}} [options] customAttributes defaults to `{}` if not assigned, level defaults to `info` if not assigned.
-  */
-  log(message, options) {
-    return this.#callMethod('log', message, options);
-  }
+class MicroAgentBase extends _apiBase.ApiBase {
+  agentIdentifier = (0, _uniqueId.generateRandomHexString)(16);
 }
 exports.MicroAgentBase = MicroAgentBase;

package/dist/cjs/loaders/micro-agent.js

@@ -11,17 +11,30 @@ var _nreum = require("../common/window/nreum");
 var _features = require("./features/features");
 var _console = require("../common/util/console");
 var _microAgentBase = require("./micro-agent-base");
+var _setCustomAttribute = require("./api/setCustomAttribute");
+var _setUserId = require("./api/setUserId");
+var _setApplicationVersion = require("./api/setApplicationVersion");
+var _start = require("./api/start");
+var _noticeError = require("./api/noticeError");
+var _setErrorHandler = require("./api/setErrorHandler");
+var _addRelease = require("./api/addRelease");
+var _addPageAction = require("./api/addPageAction");
+var _recordCustomEvent = require("./api/recordCustomEvent");
+var _finished = require("./api/finished");
+var _log = require("./api/log");
+var _wrapLogger = require("./api/wrapLogger");
 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
  */ // loader files
 // core files
+// api files that are not auto-instrumented
 const nonAutoFeatures = [_features.FEATURE_NAMES.jserrors, _features.FEATURE_NAMES.genericEvents, _features.FEATURE_NAMES.metrics, _features.FEATURE_NAMES.logging];
 
 /**
  * @deprecated This feature has been deprecated and will be removed in a future release. A future product centralizing around a single agent instance will be released as a replacement, at which time this loader will be removed.
- * A minimal agent class designed to only respond to manual user input. As such, this class does not
+ * --- A minimal agent class designed to only respond to manual user input. As such, this class does not
  * automatically instrument. Instead, each MicroAgent instance will lazy load the required features and can support loading multiple instances on one page.
  * Out of the box, it can manually handle and report Page View, Page Action, and Error events.
  */
@@ -40,6 +53,25 @@ class MicroAgent extends _microAgentBase.MicroAgentBase {
       }
     }, options.loaderType || 'micro-agent');
 
+    /** assign base agent-level API definitions */
+    (0, _setCustomAttribute.setupSetCustomAttributeAPI)(this);
+    (0, _setUserId.setupSetUserIdAPI)(this);
+    (0, _setApplicationVersion.setupSetApplicationVersionAPI)(this);
+    (0, _start.setupStartAPI)(this);
+
+    /** feature APIs that wont get set up automatically for the micro agent since it skips the inst file */
+    /** jserrors */
+    (0, _noticeError.setupNoticeErrorAPI)(this);
+    (0, _setErrorHandler.setupSetErrorHandlerAPI)(this);
+    (0, _addRelease.setupAddReleaseAPI)(this);
+    /** generic events */
+    (0, _addPageAction.setupAddPageActionAPI)(this);
+    (0, _recordCustomEvent.setupRecordCustomEventAPI)(this);
+    (0, _finished.setupFinishedAPI)(this);
+    /** logging */
+    (0, _log.setupLogAPI)(this);
+    (0, _wrapLogger.setupWrapLoggerAPI)(this);
+
     /**
      * Starts a set of agent features if not running in "autoStart" mode
      * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/start/}
@@ -62,11 +94,7 @@ class MicroAgent extends _microAgentBase.MicroAgentBase {
           so as to avoid the race condition of things like session and sharedAggregator not being ready by features that uses them right away. */
           nonAutoFeatures.forEach(f => {
             if (enabledFeatures[f] && featureNames.includes(f)) {
-              Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "lazy-feature-loader" */'../features/utils/lazy-feature-loader'))).then(({
-                lazyFeatureLoader
-              }) => {
-                return lazyFeatureLoader(f, 'aggregate');
-              }).then(({
+              (specifier => new Promise(r => r(specifier)).then(s => _interopRequireWildcard(require(s))))("../features/".concat(f, "/aggregate")).then(({
                 Aggregate
               }) => {
                 this.features[f] = new Aggregate(this);

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

@@ -11,7 +11,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.289.0";
+export const VERSION = "1.290.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.289.0";
+export const VERSION = "1.290.0";
 
 /**
  * Exposes the build type of the agent

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

@@ -26,8 +26,8 @@ var origXHR = gosNREUMOriginals().o.XHR;
 const NR_CAT_HEADER = 'X-NewRelic-App-Data';
 export class Instrument extends InstrumentBase {
   static featureName = FEATURE_NAME;
-  constructor(agentRef, auto = true) {
-    super(agentRef, FEATURE_NAME, auto);
+  constructor(agentRef) {
+    super(agentRef, FEATURE_NAME);
     this.dt = new DT(agentRef);
     this.handler = (type, args, ctx, group) => handle(type, args, ctx, group, this.ee);
 
@@ -65,7 +65,7 @@ export class Instrument extends InstrumentBase {
     wrapFetch(this.ee);
     wrapXhr(this.ee);
     subscribeToEvents(agentRef, this.ee, this.handler, this.dt);
-    this.importAggregator(agentRef);
+    this.importAggregator(agentRef, () => import(/* webpackChunkName: "ajax-aggregate" */'../aggregate/index.js'));
   }
 }
 function subscribeToEvents(agentRef, ee, handler, dt) {

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

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

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

@@ -3,6 +3,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { RAGE_CLICK_THRESHOLD_EVENTS, RAGE_CLICK_THRESHOLD_MS } from '../../constants';
+import { cleanURL } from '../../../../common/url/clean-url';
 export class AggregatedUserAction {
   constructor(evt, selectorPath, nearestTargetFields) {
     this.event = evt;
@@ -12,6 +13,7 @@ export class AggregatedUserAction {
     this.selectorPath = selectorPath;
     this.rageClick = undefined;
     this.nearestTargetFields = nearestTargetFields;
+    this.currentUrl = cleanURL('' + location);
   }
 
   /**

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

@@ -7,14 +7,24 @@ import { globalScope, isBrowserScope } from '../../../common/constants/runtime';
 import { handle } from '../../../common/event-emitter/handle';
 import { windowAddEventListener } from '../../../common/event-listener/event-listener-opts';
 import { debounce } from '../../../common/util/invoke';
+import { setupAddPageActionAPI } from '../../../loaders/api/addPageAction';
+import { setupFinishedAPI } from '../../../loaders/api/finished';
+import { setupRecordCustomEventAPI } from '../../../loaders/api/recordCustomEvent';
+import { setupRegisterAPI } from '../../../loaders/api/register';
 import { InstrumentBase } from '../../utils/instrument-base';
 import { FEATURE_NAME, OBSERVED_EVENTS, OBSERVED_WINDOW_EVENTS } from '../constants';
 export class Instrument extends InstrumentBase {
   static featureName = FEATURE_NAME;
-  constructor(agentRef, auto = true) {
-    super(agentRef, FEATURE_NAME, auto);
+  constructor(agentRef) {
+    super(agentRef, 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 */
+    setupAddPageActionAPI(agentRef);
+    setupRecordCustomEventAPI(agentRef);
+    setupFinishedAPI(agentRef);
+    setupRegisterAPI(agentRef);
     if (isBrowserScope) {
       if (agentRef.init.user_actions.enabled) {
         OBSERVED_EVENTS.forEach(eventType => windowAddEventListener(eventType, evt => handle('ua', [evt], undefined, this.featureName, this.ee), true));
@@ -43,7 +53,7 @@ export class Instrument extends 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, () => import(/* webpackChunkName: "generic_events-aggregate" */'../aggregate'));else this.deregisterDrain();
   }
 }
 export const GenericEvents = Instrument;

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

@@ -11,11 +11,21 @@ import { eventListenerOpts } from '../../../common/event-listener/event-listener
 import { now } from '../../../common/timing/now';
 import { SR_EVENT_EMITTER_TYPES } from '../../session_replay/constants';
 import { castError, castErrorEvent, castPromiseRejectionEvent } from '../shared/cast-error';
+import { setupNoticeErrorAPI } from '../../../loaders/api/noticeError';
+import { setupSetErrorHandlerAPI } from '../../../loaders/api/setErrorHandler';
+import { setupAddReleaseAPI } from '../../../loaders/api/addRelease';
+import { setupRegisterAPI } from '../../../loaders/api/register';
 export class Instrument extends InstrumentBase {
   static featureName = FEATURE_NAME;
   #replayRunning = false;
-  constructor(agentRef, auto = true) {
-    super(agentRef, FEATURE_NAME, auto);
+  constructor(agentRef) {
+    super(agentRef, FEATURE_NAME);
+
+    /** feature specific APIs */
+    setupNoticeErrorAPI(agentRef);
+    setupSetErrorHandlerAPI(agentRef);
+    setupAddReleaseAPI(agentRef);
+    setupRegisterAPI(agentRef);
     try {
       // this try-catch can be removed when IE11 is completely unsupported & gone
       this.removeOnAbort = new AbortController();
@@ -38,7 +48,7 @@ export class Instrument extends InstrumentBase {
       handle('err', [castErrorEvent(errorEvent), now(), false, {}, this.#replayRunning], undefined, this.featureName, this.ee);
     }, 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, () => import(/* 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/esm/features/logging/instrument/index.js

@@ -7,10 +7,18 @@ import { FEATURE_NAME } from '../constants';
 import { bufferLog } from '../shared/utils';
 import { wrapLogger } from '../../../common/wrap/wrap-logger';
 import { globalScope } from '../../../common/constants/runtime';
+import { setupLogAPI } from '../../../loaders/api/log';
+import { setupWrapLoggerAPI } from '../../../loaders/api/wrapLogger';
+import { setupRegisterAPI } from '../../../loaders/api/register';
 export class Instrument extends InstrumentBase {
   static featureName = FEATURE_NAME;
-  constructor(agentRef, auto = true) {
-    super(agentRef, FEATURE_NAME, auto);
+  constructor(agentRef) {
+    super(agentRef, FEATURE_NAME);
+
+    /** feature specific APIs */
+    setupLogAPI(agentRef);
+    setupWrapLoggerAPI(agentRef);
+    setupRegisterAPI(agentRef);
     const instanceEE = this.ee;
     wrapLogger(instanceEE, globalScope.console, 'log', {
       level: 'info'
@@ -38,7 +46,7 @@ export class Instrument extends InstrumentBase {
       } = this;
       bufferLog(instanceEE, message, customAttributes, level);
     });
-    this.importAggregator(agentRef);
+    this.importAggregator(agentRef, () => import(/* webpackChunkName: "logging-aggregate" */'../aggregate'));
   }
 }
 export const Logging = Instrument;