@newrelic/browser-agent 1.289.0 → 1.290.0

package/src/loaders/api-base.js

@@ -0,0 +1,218 @@
+/**
+ * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { warn } from '../common/util/console'
+import { ADD_PAGE_ACTION, ADD_RELEASE, ADD_TO_TRACE, FINISHED, INTERACTION, LOG, NOTICE_ERROR, PAUSE_REPLAY, RECORD_CUSTOM_EVENT, RECORD_REPLAY, REGISTER, SET_APPLICATION_VERSION, SET_CURRENT_ROUTE_NAME, SET_CUSTOM_ATTRIBUTE, SET_ERROR_HANDLER, SET_PAGE_VIEW_NAME, SET_USER_ID, START, WRAP_LOGGER } from './api/constants'
+
+/**
+ * @typedef {import('./api/interaction-types').InteractionInstance} InteractionInstance
+ */
+export class ApiBase {
+  #callMethod (methodName, ...args) {
+    if (this[methodName] === ApiBase.prototype[methodName]) 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(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(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(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(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(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(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(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(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(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(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(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(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(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(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(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(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(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(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(WRAP_LOGGER, parent, functionName, options)
+  }
+}

package/src/loaders/configure/configure.js

@@ -2,7 +2,7 @@
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { setAPI, setTopLevelCallers } from '../api/api'
+import { setTopLevelCallers } from '../api/topLevelCallers'
 import { addToNREUM, gosCDN } from '../../common/window/nreum'
 import { mergeInfo } from '../../common/config/info'
 import { mergeInit } from '../../common/config/init'
@@ -51,7 +51,7 @@ export function configure (agent, opts = {}, loaderType, forceDrain) {
     }
     if (updatedInit.proxy.beacon) internalTrafficList.push(updatedInit.proxy.beacon)
 
-    setTopLevelCallers() // no need to set global APIs on newrelic obj more than once
+    setTopLevelCallers(agent) // no need to set global APIs on newrelic obj more than once
     addToNREUM('activatedFeatures', activatedFeatures)
 
     // Update if soft_navigations is allowed to run AND part of this agent build, used to override old spa functions.
@@ -69,7 +69,6 @@ export function configure (agent, opts = {}, loaderType, forceDrain) {
   if (!alreadySetOnce.has(agent.agentIdentifier)) {
     agent.ee = ee.get(agent.agentIdentifier)
     agent.exposed = exposed
-    setAPI(agent, forceDrain) // assign our API functions to the agent instance
 
     dispatchGlobalEvent({
       agentIdentifier: agent.agentIdentifier,

package/src/loaders/micro-agent-base.js

@@ -2,142 +2,9 @@
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { warn } from '../common/util/console'
 import { generateRandomHexString } from '../common/ids/unique-id'
+import { ApiBase } from './api-base'
 
-export class MicroAgentBase {
-  agentIdentifier
-
-  constructor () {
-    this.agentIdentifier = 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]) 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)
-  }
+export class MicroAgentBase extends ApiBase {
+  agentIdentifier = generateRandomHexString(16)
 }

package/src/loaders/micro-agent.js

@@ -12,6 +12,19 @@ import { setNREUMInitializedAgent } from '../common/window/nreum'
 import { FEATURE_NAMES } from './features/features'
 import { warn } from '../common/util/console'
 import { MicroAgentBase } from './micro-agent-base'
+// api files that are not auto-instrumented
+import { setupSetCustomAttributeAPI } from './api/setCustomAttribute'
+import { setupSetUserIdAPI } from './api/setUserId'
+import { setupSetApplicationVersionAPI } from './api/setApplicationVersion'
+import { setupStartAPI } from './api/start'
+import { setupNoticeErrorAPI } from './api/noticeError'
+import { setupSetErrorHandlerAPI } from './api/setErrorHandler'
+import { setupAddReleaseAPI } from './api/addRelease'
+import { setupAddPageActionAPI } from './api/addPageAction'
+import { setupRecordCustomEventAPI } from './api/recordCustomEvent'
+import { setupFinishedAPI } from './api/finished'
+import { setupLogAPI } from './api/log'
+import { setupWrapLoggerAPI } from './api/wrapLogger'
 
 const nonAutoFeatures = [
   FEATURE_NAMES.jserrors,
@@ -22,7 +35,7 @@ const nonAutoFeatures = [
 
 /**
  * @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.
  */
@@ -38,6 +51,25 @@ export class MicroAgent extends MicroAgentBase {
 
     configure(this, { ...options, runtime: { isolatedBacklog: true } }, options.loaderType || 'micro-agent')
 
+    /** assign base agent-level API definitions */
+    setupSetCustomAttributeAPI(this)
+    setupSetUserIdAPI(this)
+    setupSetApplicationVersionAPI(this)
+    setupStartAPI(this)
+
+    /** feature APIs that wont get set up automatically for the micro agent since it skips the inst file */
+    /** jserrors */
+    setupNoticeErrorAPI(this)
+    setupSetErrorHandlerAPI(this)
+    setupAddReleaseAPI(this)
+    /** generic events */
+    setupAddPageActionAPI(this)
+    setupRecordCustomEventAPI(this)
+    setupFinishedAPI(this)
+    /** logging */
+    setupLogAPI(this)
+    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/}
@@ -64,9 +96,7 @@ export class MicroAgent extends 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)) {
-              import(/* webpackChunkName: "lazy-feature-loader" */ '../features/utils/lazy-feature-loader').then(({ lazyFeatureLoader }) => {
-                return lazyFeatureLoader(f, 'aggregate')
-              }).then(({ Aggregate }) => {
+              import(`../features/${f}/aggregate`).then(({ Aggregate }) => {
                 this.features[f] = new Aggregate(this)
                 this.runtime.harvester.initializedAggregates.push(this.features[f]) // so that harvester will poll this feature agg on interval
               }).catch(err => warn(25, err))

package/tools/bundler-tools/bundler-tools.js

@@ -0,0 +1,27 @@
+const webpackCacheGroup = (asyncChunkName = 'new-relic-browser-agent', matcher) => {
+  if (!matcher) {
+    matcher = (module, { chunkGraph }) => {
+      if (!module.resource) return false
+      if (!module.resource.match(/node_modules[\\/](@newrelic[\\/]browser-agent|web-vitals)[\\/]/)) return false
+      return chunkGraph.getModuleChunks(module).filter(chunk => {
+        return !['recorder', 'compressor'].includes(chunk.name)
+      }).length > 0
+    }
+  }
+
+  return {
+    [asyncChunkName]: {
+      name: asyncChunkName,
+      enforce: true,
+      reuseExistingChunk: true,
+      test: matcher,
+      chunks: 'async'
+    }
+  }
+}
+
+module.exports = {
+  webpackCacheGroup
+}
+
+// roll-up, vite, esbuild etc.

package/tools/bundler-tools/bundler-tools.mjs

@@ -0,0 +1,23 @@
+export const webpackCacheGroup = (asyncChunkName = 'new-relic-browser-agent', matcher) => {
+  if (!matcher) {
+    matcher = (module, { chunkGraph }) => {
+      if (!module.resource) return false
+      if (!module.resource.match(/node_modules[\\/](@newrelic[\\/]browser-agent|web-vitals)[\\/]/)) return false
+      return chunkGraph.getModuleChunks(module).filter(chunk => {
+        return !['recorder', 'compressor'].includes(chunk.name)
+      }).length > 0
+    }
+  }
+
+  return {
+    [asyncChunkName]: {
+      name: asyncChunkName,
+      enforce: true,
+      reuseExistingChunk: true,
+      test: matcher,
+      chunks: 'async'
+    }
+  }
+}
+
+// roll-up, vite, esbuild etc.

package/dist/cjs/features/utils/lazy-feature-loader.js

@@ -1,53 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.lazyFeatureLoader = lazyFeatureLoader;
-var _features = require("../../loaders/features/features");
-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
- */
-/**
- * Centralizes the lazy loading of agent feature aggregate and instrument sources.
- *
- * This function uses two defined switch cases to allow us to easily name our chunks and re-use these
- * chunks for different agent types. We do not use template strings or string concatenation here because
- * doing so makes it much more difficult to name the chunks and forces Webpack to "guess" what the chunks
- * should be.
- * @param featureName Name of the feature to import such as ajax or session_trace
- * @param featurePart Name of the feature part to load; should be either instrument or aggregate
- * @returns {Promise<InstrumentBase|FeatureBase|null>}
- */
-function lazyFeatureLoader(featureName, featurePart) {
-  if (featurePart === 'aggregate') {
-    switch (featureName) {
-      case _features.FEATURE_NAMES.ajax:
-        return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "ajax-aggregate" */'../ajax/aggregate')));
-      case _features.FEATURE_NAMES.jserrors:
-        return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "jserrors-aggregate" */'../jserrors/aggregate')));
-      case _features.FEATURE_NAMES.genericEvents:
-        return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "generic_events-aggregate" */'../generic_events/aggregate')));
-      case _features.FEATURE_NAMES.logging:
-        return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "logging-aggregate" */'../logging/aggregate')));
-      case _features.FEATURE_NAMES.metrics:
-        return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "metrics-aggregate" */'../metrics/aggregate')));
-      case _features.FEATURE_NAMES.pageViewEvent:
-        return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "page_view_event-aggregate" */'../page_view_event/aggregate')));
-      case _features.FEATURE_NAMES.pageViewTiming:
-        return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "page_view_timing-aggregate" */'../page_view_timing/aggregate')));
-      case _features.FEATURE_NAMES.sessionReplay:
-        return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "session_replay-aggregate" */'../session_replay/aggregate')));
-      case _features.FEATURE_NAMES.sessionTrace:
-        return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "session_trace-aggregate" */'../session_trace/aggregate')));
-      case _features.FEATURE_NAMES.spa:
-        return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "spa-aggregate" */'../spa/aggregate')));
-      case _features.FEATURE_NAMES.softNav:
-        return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "basic-spa-aggregate" */'../soft_navigations/aggregate')));
-      default:
-        throw new Error("Attempted to load unsupported agent feature: ".concat(featureName, " ").concat(featurePart));
-    }
-  }
-}

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

@@ -1,14 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.asyncApiMethods = exports.apiMethods = void 0;
-var _constants = require("../../features/session_replay/constants");
-/**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-
-const apiMethods = exports.apiMethods = ['setErrorHandler', 'finished', 'addToTrace', 'addRelease', 'recordCustomEvent', 'addPageAction', 'setCurrentRouteName', 'setPageViewName', 'setCustomAttribute', 'interaction', 'noticeError', 'setUserId', 'setApplicationVersion', 'start', _constants.SR_EVENT_EMITTER_TYPES.RECORD, _constants.SR_EVENT_EMITTER_TYPES.PAUSE, 'log', 'wrapLogger', 'register'];
-const asyncApiMethods = exports.asyncApiMethods = ['setErrorHandler', 'finished', 'addToTrace', 'addRelease'];