@newrelic/browser-agent 1.286.0 → 1.288.0

package/CHANGELOG.md

@@ -3,6 +3,27 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.288.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.287.0...v1.288.0) (2025-04-16)
+
+
+### Features
+
+* Introduce isFirstOfSession attribute on InitialPageLoad events ([#1432](https://github.com/newrelic/newrelic-browser-agent/issues/1432)) ([8d7bdd6](https://github.com/newrelic/newrelic-browser-agent/commit/8d7bdd63abe0b6d9dfccc46f63845bde0fd099a4))
+* Prevent storing session data past session expiry ([#1426](https://github.com/newrelic/newrelic-browser-agent/issues/1426)) ([5819b64](https://github.com/newrelic/newrelic-browser-agent/commit/5819b649792b6227d49173ecb326f918b1f39bdb))
+
+
+### Bug Fixes
+
+* Reset `notified` when replay stops recording ([#1435](https://github.com/newrelic/newrelic-browser-agent/issues/1435)) ([7dd8b62](https://github.com/newrelic/newrelic-browser-agent/commit/7dd8b6217763c57c382737b6ff90667066437b75))
+* Solve race condition in logging abort ([#1445](https://github.com/newrelic/newrelic-browser-agent/issues/1445)) ([ab315dc](https://github.com/newrelic/newrelic-browser-agent/commit/ab315dc009a45911911f5d176978fac0cf066be3))
+
+## [1.287.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.286.0...v1.287.0) (2025-04-10)
+
+
+### Features
+
+* Central Agent Architecture - Micro Front Ends ([#1266](https://github.com/newrelic/newrelic-browser-agent/issues/1266)) ([b1a6c30](https://github.com/newrelic/newrelic-browser-agent/commit/b1a6c30bf78001f5286a614c229ceb7a256593aa))
+
 ## [1.286.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.285.0...v1.286.0) (2025-04-01)
 
 

package/dist/cjs/common/config/init-types.js

@@ -0,0 +1,96 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+/**
+ * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ */
+/**
+ * @typedef {Object} Init
+ * @property {Object} [ajax]
+ * @property {Array<string>} [ajax.deny_list] - List of domain URLs to be excluded from AjaxRequest collection.
+ * @property {boolean} [ajax.block_internal] - If true, agent requests going to harvest endpoint are treated as on deny list. In other words, agent will not self-report AJAX.
+ * @property {boolean} [ajax.enabled] - Turn on/off the ajax feature (on by default).
+ * @property {boolean} [ajax.autoStart] - If true, the agent will automatically start the ajax feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [api]
+ * @property {boolean} [api.allow_registered_children] - If true, the agent will allow registered children to be sent to the server.
+ * @property {boolean} [api.duplicate_registered_data] - If true, the agent will capture registered child data to the main agent as well as the registered child.
+ * @property {Object} [distributed_tracing]
+ * @property {boolean} [distributed_tracing.enabled] - If true, distributed tracing headers will be added to outgoing requests. Requires ajax feature to be running.
+ * @property {boolean} [distributed_tracing.exclude_newrelic_header]
+ * @property {boolean} [distributed_tracing.cors_use_newrelic_header]
+ * @property {boolean} [distributed_tracing.cors_use_tracecontext_headers]
+ * @property {Array<string>} [distributed_tracing.allowed_origins]
+ * @property {Array<string>} [feature_flags] - An array of feature flags to enable experimental features.
+ * @property {Object} [generic_events]
+ * @property {boolean} [generic_events.enabled] - Turn on/off the generic events feature (on by default). This is required for `PageAction`, `UserAction`, and `BrowserPerformance` events.
+ * @property {boolean} [generic_events.autoStart] - If true, the agent will automatically start the generic events feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [harvest]
+ * @property {number} [harvest.interval] - The interval in seconds at which the agent will send out data. It's not recommended to change this value.
+ * @property {Object} [jserrors]
+ * @property {boolean} [jserrors.enabled] - Turn on/off the jserrors feature (on by default).
+ * @property {boolean} [jserrors.autoStart] - If true, the agent will automatically start the jserrors feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [logging]
+ * @property {boolean} [logging.enabled] - Turn on/off the logging feature (on by default).
+ * @property {boolean} [logging.autoStart] - If true, the agent will automatically start the logging feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [metrics]
+ * @property {boolean} [metrics.enabled] - Turn on/off the metrics feature (on by default).
+ * @property {boolean} [metrics.autoStart] - If true, the agent will automatically start the metrics feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Array<Object>} [obfuscate] - Array of regexp and corresponding replacement patterns for obfuscating data.
+ * @property {Object} [page_action]
+ * @property {boolean} [page_action.enabled] - Must be true to allow PageAction events to be captured.
+ * @property {Object} [page_view_event]
+ * @property {boolean} [page_view_event.enabled] - This setting is ignored! PageViewEvent is always enabled by force.
+ * @property {boolean} [page_view_event.autoStart] - If true, the agent will automatically send the RUM request. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [page_view_timing]
+ * @property {boolean} [page_view_timing.enabled] - Turn on/off the page view timing feature (on by default).
+ * @property {boolean} [page_view_timing.autoStart] - If true, the agent will automatically start the page view timing feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [performance]
+ * @property {boolean} [performance.capture_marks] - If true, the agent will capture PerformanceMark events.
+ * @property {boolean} [performance.capture_measures] - If true, the agent will capture PerformanceMeasure events.
+ * @property {boolean} [performance.capture_detail] - If true, `BrowserPerformance` events from marks and measures will include, as attribute(s), the `detail` metadata provided to `markOptions` and `measureOptions`.
+ * @property {Object} [performance.resources]
+ * @property {boolean} [performance.resources.enabled] - If true, the agent will capture PerformanceResourceTiming entries.
+ * @property {Array<string>} [performance.resources.asset_types] - Array of `initiatorType` strings to filter the desired ResourceTiming entries. By default, all resource types are captured.
+ * @property {Array<string>} [performance.resources.first_party_domains] - Each resource URL will be checked against this list to determine if it should be labeled "first party" in the resulting `BrowserPerformance` event.
+ * @property {boolean} [performance.resources.ignore_newrelic] - When true (default), resource entries associated with New Relic domains will be ignored.
+ * @property {Object} [privacy]
+ * @property {boolean} [privacy.cookies_enabled] - If true (default), session tracking of users across page loads is enabled in the agent. This is required for session trace, replay, and session-related features.
+ * @property {Object} [proxy]
+ * @property {string} [proxy.assets] - Set value will be used to overwrite the webpack asset path used to fetch agent assets.
+ * @property {string} [proxy.beacon] - Set value will be used to overwrite the endpoint URL to which we send analytics.
+ * @property {Object} [session]
+ * @property {number} [session.expiresMs] - When session tracking is on, this determines how long a session will last before expiring. Modifying this value is not recommended.
+ * @property {number} [session.inactiveMs] - When session tracking is on, this determines how long a session will last without user activity before expiring. Modifying this value is not recommended.
+ * @property {Object} [session_replay]
+ * @property {boolean} [session_replay.autoStart] - If true, the agent will automatically start the session replay feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {boolean} [session_replay.enabled] - Turn on/off the session replay feature (off by default).
+ * @property {boolean} [session_replay.preload] - If true, allow the agent to run rrweb recorder immediately instead of waiting until after the window.load event, for new sessions. Existing sessions ignore this setting.
+ * @property {number} [session_replay.sampling_rate] - This setting is deprecated and ineffective. Sampling is controlled in New Relic by server-side configuration.
+ * @property {number} [session_replay.error_sampling_rate] - This setting is deprecated and ineffective.
+ * @property {boolean} [session_replay.collect_fonts] - When true, serialize fonts for collection without public asset url. This is currently broken -- https://github.com/rrweb-io/rrweb/issues/1304.
+ * @property {boolean} [session_replay.inline_images] - When true, serialize images for collection without public asset url. Not recommended for use. This is currently for TESTING as it easily generates payloads too large to be harvested.
+ * @property {boolean} [session_replay.fix_stylesheets] - When true, tries to fetch any missing stylesheets again to inline in replayer.
+ * @property {boolean} [session_replay.mask_all_inputs] - If true, all input content will be masked with asterisks.
+ * @property {string} [session_replay.mask_text_selector] - Set value should be in CSS selector syntax and is used to identify matching elements to mask.
+ * @property {string} [session_replay.block_selector] - Set value should be in CSS selector syntax and is used to identify matching elements to block.
+ * @property {Object} [session_replay.mask_input_options] - If mask_all_inputs is not true, this object will be used to select what input to mask. Passwords are forcibly always masked.
+ * @property {Object} [session_trace]
+ * @property {boolean} [session_trace.enabled] - Turn on/off the session trace feature (on by default).
+ * @property {boolean} [session_trace.autoStart] - If true, the agent will automatically start the session trace feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [soft_navigations]
+ * @property {boolean} [soft_navigations.enabled] - Turn on/off the soft navigations feature (on by default).
+ * @property {boolean} [soft_navigations.autoStart] - If true, the agent will automatically start the soft navigations feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [spa]
+ * @property {boolean} [spa.enabled] - Turn on/off the single page application feature (on by default). NOTE: the SPA feature is deprecated and under removal procedure.
+ * @property {boolean} [spa.autoStart] - If true, the agent will automatically start the single page application feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {boolean} [ssl] - If explicitly false, the agent will use HTTP instead of HTTPS. This setting should NOT be used.
+ * @property {Object} [user_actions]
+ * @property {boolean} [user_actions.enabled] - Must be true to allow UserAction events to be captured.
+ * @property {Array<string>} [user_actions.elementAttributes] - List of HTML Element properties to be captured with UserAction events' target elements. This may help to identify the source element being interacted with in the UI.
+ */
+var _default = exports.default = {};

package/dist/cjs/common/config/init.js

@@ -18,88 +18,14 @@ var _configurable = require("./configurable");
  */
 
 /**
- * @typedef {Object} Init
- * @property {Object} [ajax]
- * @property {Array<string>} [ajax.deny_list] - List of domain URLs to be excluded from AjaxRequest collection.
- * @property {boolean} [ajax.block_internal] - If true, agent requests going to harvest endpoint are treated as on deny list. In other words, agent will not self-report AJAX.
- * @property {boolean} [ajax.enabled] - Turn on/off the ajax feature (on by default).
- * @property {boolean} [ajax.autoStart] - If true, the agent will automatically start the ajax feature. Otherwise, it will be in a deferred state until the `start` API method is called.
- * @property {Object} [distributed_tracing]
- * @property {boolean} [distributed_tracing.enabled] - If true, distributed tracing headers will be added to outgoing requests. Requires ajax feature to be running.
- * @property {boolean} [distributed_tracing.exclude_newrelic_header]
- * @property {boolean} [distributed_tracing.cors_use_newrelic_header]
- * @property {boolean} [distributed_tracing.cors_use_tracecontext_headers]
- * @property {Array<string>} [distributed_tracing.allowed_origins]
- * @property {Array<string>} [feature_flags] - An array of feature flags to enable experimental features.
- * @property {Object} [generic_events]
- * @property {boolean} [generic_events.enabled] - Turn on/off the generic events feature (on by default). This is required for `PageAction`, `UserAction`, and `BrowserPerformance` events.
- * @property {boolean} [generic_events.autoStart] - If true, the agent will automatically start the generic events feature. Otherwise, it will be in a deferred state until the `start` API method is called.
- * @property {Object} [harvest]
- * @property {number} [harvest.interval] - The interval in seconds at which the agent will send out data. It's not recommended to change this value.
- * @property {Object} [jserrors]
- * @property {boolean} [jserrors.enabled] - Turn on/off the jserrors feature (on by default).
- * @property {boolean} [jserrors.autoStart] - If true, the agent will automatically start the jserrors feature. Otherwise, it will be in a deferred state until the `start` API method is called.
- * @property {Object} [logging]
- * @property {boolean} [logging.enabled] - Turn on/off the logging feature (on by default).
- * @property {boolean} [logging.autoStart] - If true, the agent will automatically start the logging feature. Otherwise, it will be in a deferred state until the `start` API method is called.
- * @property {Object} [metrics]
- * @property {boolean} [metrics.enabled] - Turn on/off the metrics feature (on by default).
- * @property {boolean} [metrics.autoStart] - If true, the agent will automatically start the metrics feature. Otherwise, it will be in a deferred state until the `start` API method is called.
- * @property {Array<Object>} [obfuscate] - Array of regexp and corresponding replacement patterns for obfuscating data.
- * @property {Object} [page_action]
- * @property {boolean} [page_action.enabled] - Must be true to allow PageAction events to be captured.
- * @property {Object} [page_view_event]
- * @property {boolean} [page_view_event.enabled] - This setting is ignored! PageViewEvent is always enabled by force.
- * @property {boolean} [page_view_event.autoStart] - If true, the agent will automatically send the RUM request. Otherwise, it will be in a deferred state until the `start` API method is called.
- * @property {Object} [page_view_timing]
- * @property {boolean} [page_view_timing.enabled] - Turn on/off the page view timing feature (on by default).
- * @property {boolean} [page_view_timing.autoStart] - If true, the agent will automatically start the page view timing feature. Otherwise, it will be in a deferred state until the `start` API method is called.
- * @property {Object} [performance]
- * @property {boolean} [performance.capture_marks] - If true, the agent will capture PerformanceMark events.
- * @property {boolean} [performance.capture_measures] - If true, the agent will capture PerformanceMeasure events.
- * @property {boolean} [performance.capture_detail] - If true, `BrowserPerformance` events from marks and measures will include, as attribute(s), the `detail` metadata provided to `markOptions` and `measureOptions`.
- * @property {Object} [performance.resources]
- * @property {boolean} [performance.resources.enabled] - If true, the agent will capture PerformanceResourceTiming entries.
- * @property {Array<string>} [performance.resources.asset_types] - Array of `initiatorType` strings to filter the desired ResourceTiming entries. By default, all resource types are captured.
- * @property {Array<string>} [performance.resources.first_party_domains] - Each resource URL will be checked against this list to determine if it should be labeled "first party" in the resulting `BrowserPerformance` event.
- * @property {boolean} [performance.resources.ignore_newrelic] - When true (default), resource entries associated with New Relic domains will be ignored.
- * @property {Object} [privacy]
- * @property {boolean} [privacy.cookies_enabled] - If true (default), session tracking of users across page loads is enabled in the agent. This is required for session trace, replay, and session-related features.
- * @property {Object} [proxy]
- * @property {string} [proxy.assets] - Set value will be used to overwrite the webpack asset path used to fetch agent assets.
- * @property {string} [proxy.beacon] - Set value will be used to overwrite the endpoint URL to which we send analytics.
- * @property {Object} [session]
- * @property {number} [session.expiresMs] - When session tracking is on, this determines how long a session will last before expiring. Modifying this value is not recommended.
- * @property {number} [session.inactiveMs] - When session tracking is on, this determines how long a session will last without user activity before expiring. Modifying this value is not recommended.
- * @property {Object} [session_replay]
- * @property {boolean} [session_replay.autoStart] - If true, the agent will automatically start the session replay feature. Otherwise, it will be in a deferred state until the `start` API method is called.
- * @property {boolean} [session_replay.enabled] - Turn on/off the session replay feature (off by default).
- * @property {boolean} [session_replay.preload] - If true, allow the agent to run rrweb recorder immediately instead of waiting until after the window.load event, for new sessions. Existing sessions ignore this setting.
- * @property {number} [session_replay.sampling_rate] - This setting is deprecated and ineffective. Sampling is controlled in New Relic by server-side configuration.
- * @property {number} [session_replay.error_sampling_rate] - This setting is deprecated and ineffective.
- * @property {boolean} [session_replay.collect_fonts] - When true, serialize fonts for collection without public asset url. This is currently broken -- https://github.com/rrweb-io/rrweb/issues/1304.
- * @property {boolean} [session_replay.inline_images] - When true, serialize images for collection without public asset url. Not recommended for use. This is currently for TESTING as it easily generates payloads too large to be harvested.
- * @property {boolean} [session_replay.fix_stylesheets] - When true, tries to fetch any missing stylesheets again to inline in replayer.
- * @property {boolean} [session_replay.mask_all_inputs] - If true, all input content will be masked with asterisks.
- * @property {string} [session_replay.mask_text_selector] - Set value should be in CSS selector syntax and is used to identify matching elements to mask.
- * @property {string} [session_replay.block_selector] - Set value should be in CSS selector syntax and is used to identify matching elements to block.
- * @property {Object} [session_replay.mask_input_options] - If mask_all_inputs is not true, this object will be used to select what input to mask. Passwords are forcibly always masked.
- * @property {Object} [session_trace]
- * @property {boolean} [session_trace.enabled] - Turn on/off the session trace feature (on by default).
- * @property {boolean} [session_trace.autoStart] - If true, the agent will automatically start the session trace feature. Otherwise, it will be in a deferred state until the `start` API method is called.
- * @property {Object} [soft_navigations]
- * @property {boolean} [soft_navigations.enabled] - Turn on/off the soft navigations feature (on by default).
- * @property {boolean} [soft_navigations.autoStart] - If true, the agent will automatically start the soft navigations feature. Otherwise, it will be in a deferred state until the `start` API method is called.
- * @property {Object} [spa]
- * @property {boolean} [spa.enabled] - Turn on/off the single page application feature (on by default). NOTE: the SPA feature is deprecated and under removal procedure.
- * @property {boolean} [spa.autoStart] - If true, the agent will automatically start the single page application feature. Otherwise, it will be in a deferred state until the `start` API method is called.
- * @property {boolean} [ssl] - If explicitly false, the agent will use HTTP instead of HTTPS. This setting should NOT be used.
- * @property {Object} [user_actions]
- * @property {boolean} [user_actions.enabled] - Must be true to allow UserAction events to be captured.
- * @property {Array<string>} [user_actions.elementAttributes] - List of HTML Element properties to be captured with UserAction events' target elements. This may help to identify the source element being interacted with in the UI.
+ * @typedef {import('./init-types').Init} Init
  */
 
 const nrMask = '[data-nr-mask]';
+
+/**
+ * @returns {Init} the default configuration object
+ */
 const model = () => {
   const hiddenState = {
     feature_flags: [],
@@ -137,6 +63,10 @@ const model = () => {
       enabled: true,
       autoStart: true
     },
+    api: {
+      allow_registered_children: true,
+      duplicate_registered_data: false
+    },
     distributed_tracing: {
       enabled: undefined,
       exclude_newrelic_header: undefined,

package/dist/cjs/common/config/runtime.js

@@ -26,21 +26,22 @@ const readonly = {
   originTime: _runtime.originTime
 };
 const model = {
+  /** Agent-specific metadata found in the RUM call response. ex. entityGuid */
+  appMetadata: {},
   customTransaction: undefined,
+  denyList: undefined,
   disabled: false,
+  entityManager: undefined,
+  harvester: undefined,
   isolatedBacklog: false,
   loaderType: undefined,
   maxBytes: 30000,
+  obfuscator: undefined,
   onerror: undefined,
   ptid: undefined,
   releaseIds: {},
-  /** Agent-specific metadata found in the RUM call response. ex. entityGuid */
-  appMetadata: {},
   session: undefined,
-  denyList: undefined,
-  timeKeeper: undefined,
-  obfuscator: undefined,
-  harvester: undefined
+  timeKeeper: undefined
 };
 const _cache = {};
 function getRuntime(id) {

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.286.0";
+const VERSION = exports.VERSION = "1.288.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.286.0";
+const VERSION = exports.VERSION = "1.288.0";
 
 /**
  * Exposes the build type of the agent

package/dist/cjs/common/harvest/harvester.js

@@ -152,7 +152,7 @@ function send(agentRef, {
   const protocol = agentRef.init.ssl === false ? 'http' : 'https';
   const perceivedBeacon = agentRef.init.proxy.beacon || agentRef.info.errorBeacon;
   const url = raw ? "".concat(protocol, "://").concat(perceivedBeacon, "/").concat(endpoint) : "".concat(protocol, "://").concat(perceivedBeacon).concat(endpoint !== _features.RUM ? '/' + endpoint : '', "/1/").concat(targetApp.licenseKey);
-  const baseParams = !raw ? baseQueryString(agentRef, qs, endpoint, targetApp.appId) : '';
+  const baseParams = !raw ? baseQueryString(agentRef, qs, endpoint, targetApp.applicationID) : '';
   let payloadParams = (0, _encode.obj)(qs, agentRef.runtime.maxBytes);
   if (baseParams === '' && payloadParams.startsWith('&')) {
     payloadParams = payloadParams.substring(1);
@@ -192,8 +192,8 @@ function send(agentRef, {
           sent: this.status !== 0,
           status: this.status,
           retry: shouldRetry(this.status),
-          xhr: this,
           fullUrl,
+          xhr: this,
           targetApp
         };
         if (localOpts.needResponse) cbResult.responseText = this.responseText;

package/dist/cjs/common/session/session-entity.js

@@ -38,7 +38,8 @@ const model = {
   loggingMode: _constants3.LOGGING_MODE.OFF,
   serverTimeDiff: null,
   // set by TimeKeeper; "undefined" value will not be stringified and stored but "null" will
-  custom: {}
+  custom: {},
+  numOfResets: 0
 };
 class SessionEntity {
   /**
@@ -84,7 +85,8 @@ class SessionEntity {
   setup({
     value = (0, _uniqueId.generateRandomHexString)(16),
     expiresMs = _constants.DEFAULT_EXPIRES_MS,
-    inactiveMs = _constants.DEFAULT_INACTIVE_MS
+    inactiveMs = _constants.DEFAULT_INACTIVE_MS,
+    numOfResets = 0
   }) {
     /** Ensure that certain properties are preserved across a reset if already set */
     const persistentAttributes = {
@@ -113,6 +115,7 @@ class SessionEntity {
     // this gets ignored if the value is falsy, allowing for session entities that do not expire
     if (expiresMs) {
       this.state.expiresAt = initialRead?.expiresAt || this.getFutureTimestamp(expiresMs);
+      this.state.numOfResets = initialRead?.numOfResets || numOfResets;
       this.expiresTimer = new _timer.Timer({
         // When the inactive timer ends, collect a SM and reset the session
         onEnd: () => {
@@ -247,7 +250,8 @@ class SessionEntity {
         key: this.key,
         storage: this.storage,
         expiresMs: this.expiresMs,
-        inactiveMs: this.inactiveMs
+        inactiveMs: this.inactiveMs,
+        numOfResets: ++this.state.numOfResets
       });
       return this.read();
     } catch (e) {
@@ -266,6 +270,9 @@ class SessionEntity {
       inactiveAt: this.getFutureTimestamp(this.inactiveMs)
     });
   }
+  isAfterSessionExpiry(timestamp) {
+    return this.state.numOfResets > 0 || typeof timestamp === 'number' && typeof this.state.expiresAt === 'number' && timestamp >= this.state.expiresAt;
+  }
 
   /**
    * @param {number} timestamp

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

@@ -5,7 +5,6 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.activateFeatures = activateFeatures;
 exports.activatedFeatures = void 0;
-var _contextualEe = require("../event-emitter/contextual-ee");
 var _globalEvent = require("../dispatch/global-event");
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
@@ -24,12 +23,12 @@ const activatedFeatures = exports.activatedFeatures = {};
  * @param {string} agentIdentifier agent instance identifier
  * @returns {void}
  */
-function activateFeatures(flags, agentIdentifier) {
-  const sharedEE = _contextualEe.ee.get(agentIdentifier);
+function activateFeatures(flags, agentRef) {
+  const agentIdentifier = agentRef.agentIdentifier;
   activatedFeatures[agentIdentifier] ??= {};
-  if (!(flags && typeof flags === 'object')) return;
+  if (!flags || typeof flags !== 'object') return;
   if (sentIds.has(agentIdentifier)) return;
-  sharedEE.emit('rumresp', [flags]);
+  agentRef.ee.emit('rumresp', [flags]);
   activatedFeatures[agentIdentifier] = flags;
   sentIds.add(agentIdentifier);
 

package/dist/cjs/common/util/target.js

@@ -0,0 +1,34 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isContainerAgentTarget = isContainerAgentTarget;
+exports.isValidTarget = isValidTarget;
+/**
+ * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @param {Object} [target] - the target to be validated
+ * @param {boolean} [allowUndefined=true]
+ * @returns {boolean}
+ */
+function isValidTarget(target) {
+  /** target can be undefined to support legacy/default behaviors - main agent does not supply a target */
+  if (!target) return true;
+  /** if not undefined, we require specific values */
+  return !!(target.licenseKey && target.applicationID);
+}
+
+/**
+ * Checks if the target matches the container agent target
+ * @param {*} target the target to be validated
+ * @param {*} agentRef the agent reference to be validated
+ * @returns {boolean}
+ */
+function isContainerAgentTarget(target, agentRef) {
+  if (!target) return true;
+  return target.licenseKey === agentRef.info.licenseKey && target.applicationID === agentRef.info.applicationID;
+}

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

@@ -61,7 +61,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
 
     // Report ajax timeslice metric (to be harvested by jserrors feature, but only if it's running).
     if (jserrorsInUse && (shouldCollect || !shouldOmitAjaxMetrics)) {
-      this.agentRef.sharedAggregator.add(['xhr', hash, params, metrics]);
+      this.agentRef.sharedAggregator?.add(['xhr', hash, params, metrics]);
     }
     if (!shouldCollect) {
       if (params.hostname === this.agentRef.info.errorBeacon || this.agentRef.init.proxy?.beacon && params.hostname === this.agentRef.init.proxy.beacon) {
@@ -114,6 +114,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     }
   }
   serializer(eventBuffer) {
+    if (!eventBuffer.length) return;
     const addString = (0, _belSerializer.getAddStringContext)(this.agentIdentifier);
     let payload = 'bel.7;';
     for (let i = 0; i < eventBuffer.length; i++) {

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

@@ -44,7 +44,8 @@ class Aggregate extends _aggregateBase.AggregateBase {
         });
       }, this.featureName, this.ee);
       if (agentRef.init.page_action.enabled) {
-        (0, _registerHandler.registerHandler)('api-addPageAction', (timestamp, name, attributes) => {
+        (0, _registerHandler.registerHandler)('api-addPageAction', (timestamp, name, attributes, targetEntityGuid) => {
+          if (!this.agentRef.runtime.entityManager.get(targetEntityGuid)) return (0, _console.warn)(56, this.featureName);
           this.addEvent({
             ...attributes,
             eventType: 'PageAction',
@@ -56,7 +57,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
               browserWidth: window.document.documentElement?.clientWidth,
               browserHeight: window.document.documentElement?.clientHeight
             })
-          });
+          }, targetEntityGuid);
         }, this.featureName, this.ee);
       }
       let addUserAction = () => {/** no-op */};
@@ -238,9 +239,10 @@ class Aggregate extends _aggregateBase.AggregateBase {
    * * sessionTraceId: set by the `ptid=` query param
    * * userAgent*: set by the userAgent header
    * @param {object=} obj the event object for storing in the event buffer
+   * @param {string=} targetEntityGuid the target entity guid for the event to scope buffering and harvesting. Defaults to agent config if undefined
    * @returns void
    */
-  addEvent(obj = {}) {
+  addEvent(obj = {}, targetEntityGuid) {
     if (!obj || !Object.keys(obj).length) return;
     if (!obj.eventType) {
       (0, _console.warn)(44);
@@ -265,14 +267,16 @@ class Aggregate extends _aggregateBase.AggregateBase {
       /** Event-specific attributes take precedence over agent-level custom attributes and fallbacks */
       ...obj
     };
-    const addedEvent = this.events.add(eventAttributes);
-    if (!addedEvent && !this.events.isEmpty()) {
+    const addedEvent = this.events.add(eventAttributes, targetEntityGuid);
+    if (!addedEvent && !this.events.isEmpty(undefined, targetEntityGuid)) {
       /** could not add the event because it pushed the buffer over the limit
        * so we harvest early, and try to add it again now that the buffer is cleared
        * if it fails again, we do nothing
        */
       this.ee.emit(_constants2.SUPPORTABILITY_METRIC_CHANNEL, ['GenericEvents/Harvest/Max/Seen']);
-      this.agentRef.runtime.harvester.triggerHarvestFor(this);
+      this.agentRef.runtime.harvester.triggerHarvestFor(this, {
+        targetEntityGuid
+      });
       this.events.add(eventAttributes);
     }
   }

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

@@ -18,6 +18,8 @@ var _aggregateBase = require("../../utils/aggregate-base");
 var _now = require("../../../common/timing/now");
 var _traverse = require("../../../common/util/traverse");
 var _internalErrors = require("./internal-errors");
+var _target = require("../../../common/util/target");
+var _console = require("../../../common/util/console");
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -101,10 +103,13 @@ class Aggregate extends _aggregateBase.AggregateBase {
    * @param {object=} customAttributes  any custom attributes to be included in the error payload
    * @param {boolean=} hasReplay a flag indicating if the error occurred during a replay session
    * @param {string=} swallowReason a string indicating pre-defined reason if swallowing the error.  Mainly used by the internal error SMs.
+   * @param {object=} target the target to buffer and harvest to, if undefined the default configuration target is used
    * @returns
    */
-  storeError(err, time, internal, customAttributes, hasReplay, swallowReason) {
+  storeError(err, time, internal, customAttributes, hasReplay, swallowReason, targetEntityGuid) {
     if (!err) return;
+    const target = this.agentRef.runtime.entityManager.get(targetEntityGuid);
+    if (!target) return (0, _console.warn)(56, this.featureName);
     // are we in an interaction
     time = time || (0, _now.now)();
     let filterOutput;
@@ -136,7 +141,9 @@ class Aggregate extends _aggregateBase.AggregateBase {
     // Notice if filterOutput isn't false|undefined OR our specified object, this func would've returned already (so it's unnecessary to req-check group).
     // Do not modify the name ('errorGroup') of params without DEM approval!
     if (filterOutput?.group) params.errorGroup = filterOutput.group;
-    if (hasReplay) params.hasReplay = hasReplay;
+
+    // Should only decorate "hasReplay" for the container agent, so check if the target matches the config
+    if (hasReplay && (0, _target.isContainerAgentTarget)(target, this.agentRef)) params.hasReplay = hasReplay;
     /**
      * The bucketHash is different from the params.stackHash because the params.stackHash is based on the canonicalized
      * stack trace and is used downstream in NR1 to attempt to group the same errors across different browsers. However,
@@ -171,33 +178,38 @@ class Aggregate extends _aggregateBase.AggregateBase {
 
     // Trace sends the error in its payload, and both trace & replay simply listens for any error to occur.
     const jsErrorEvent = [type, bucketHash, params, newMetrics, customAttributes];
-    (0, _handle.handle)('trace-jserror', jsErrorEvent, undefined, _features.FEATURE_NAMES.sessionTrace, this.ee);
+    if (this.shouldAllowMainAgentToCapture(targetEntityGuid)) (0, _handle.handle)('trace-jserror', jsErrorEvent, undefined, _features.FEATURE_NAMES.sessionTrace, this.ee);
     // still send EE events for other features such as above, but stop this one from aggregating internal data
     if (this.blocked) return;
     if (err?.__newrelic?.[this.agentIdentifier]) {
       params._interactionId = err.__newrelic[this.agentIdentifier].interactionId;
       params._interactionNodeId = err.__newrelic[this.agentIdentifier].interactionNodeId;
     }
-    const softNavInUse = Boolean(this.agentRef.features?.[_features.FEATURE_NAMES.softNav]);
-    // Note: the following are subject to potential race cond wherein if the other feature aren't fully initialized, it'll be treated as there being no associated interaction.
-    // They each will also tack on their respective properties to the params object as part of the decision flow.
-    if (softNavInUse) (0, _handle.handle)('jserror', [params, time], undefined, _features.FEATURE_NAMES.softNav, this.ee);else (0, _handle.handle)('spa-jserror', jsErrorEvent, undefined, _features.FEATURE_NAMES.spa, this.ee);
-    if (params.browserInteractionId && !params._softNavFinished) {
-      // hold onto the error until the in-progress interaction is done, eithered saved or discarded
-      this.bufferedErrorsUnderSpa[params.browserInteractionId] ??= [];
-      this.bufferedErrorsUnderSpa[params.browserInteractionId].push(jsErrorEvent);
-    } else if (params._interactionId != null) {
-      // same as above, except tailored for the way old spa does it
-      this.bufferedErrorsUnderSpa[params._interactionId] = this.bufferedErrorsUnderSpa[params._interactionId] || [];
-      this.bufferedErrorsUnderSpa[params._interactionId].push(jsErrorEvent);
-    } else {
-      // Either there is no interaction (then all these params properties will be undefined) OR there's a related soft navigation that's already completed.
-      // The old spa does not look up completed interactions at all, so there's no need to consider it.
-      this.#storeJserrorForHarvest(jsErrorEvent, params.browserInteractionId !== undefined, params._softNavAttributes);
+    if (this.shouldAllowMainAgentToCapture(targetEntityGuid)) {
+      const softNavInUse = Boolean(this.agentRef.features?.[_features.FEATURE_NAMES.softNav]);
+      // Note: the following are subject to potential race cond wherein if the other feature aren't fully initialized, it'll be treated as there being no associated interaction.
+      // They each will also tack on their respective properties to the params object as part of the decision flow.
+      if (softNavInUse) (0, _handle.handle)('jserror', [params, time], undefined, _features.FEATURE_NAMES.softNav, this.ee);else (0, _handle.handle)('spa-jserror', jsErrorEvent, undefined, _features.FEATURE_NAMES.spa, this.ee);
+      if (params.browserInteractionId && !params._softNavFinished) {
+        // hold onto the error until the in-progress interaction is done, eithered saved or discarded
+        this.bufferedErrorsUnderSpa[params.browserInteractionId] ??= [];
+        this.bufferedErrorsUnderSpa[params.browserInteractionId].push(jsErrorEvent);
+      } else if (params._interactionId != null) {
+        // same as above, except tailored for the way old spa does it
+        this.bufferedErrorsUnderSpa[params._interactionId] = this.bufferedErrorsUnderSpa[params._interactionId] || [];
+        this.bufferedErrorsUnderSpa[params._interactionId].push(jsErrorEvent);
+      } else {
+        // Either there is no interaction (then all these params properties will be undefined) OR there's a related soft navigation that's already completed.
+        // The old spa does not look up completed interactions at all, so there's no need to consider it.
+        this.#storeJserrorForHarvest(jsErrorEvent, params.browserInteractionId !== undefined, params._softNavAttributes);
+      }
     }
+
+    // always add directly if scoped to a sub-entity, the other pathways above will be deterministic if the main agent should procede
+    if (targetEntityGuid) this.#storeJserrorForHarvest([...jsErrorEvent, targetEntityGuid], false, params._softNavAttributes);
   }
   #storeJserrorForHarvest(errorInfoArr, softNavOccurredFinished, softNavCustomAttrs = {}) {
-    let [type, bucketHash, params, newMetrics, localAttrs] = errorInfoArr;
+    let [type, bucketHash, params, newMetrics, localAttrs, targetEntityGuid] = errorInfoArr;
     const allCustomAttrs = {};
     if (softNavOccurredFinished) {
       Object.entries(softNavCustomAttrs).forEach(([k, v]) => setCustom(k, v)); // when an ixn finishes, it'll include stuff in jsAttributes + attrs specific to the ixn
@@ -213,12 +225,22 @@ class Aggregate extends _aggregateBase.AggregateBase {
 
     const jsAttributesHash = (0, _stringHashCode.stringHashCode)((0, _stringify.stringify)(allCustomAttrs));
     const aggregateHash = bucketHash + ':' + jsAttributesHash;
-    this.events.add([type, aggregateHash, params, newMetrics, allCustomAttrs]);
+    this.events.add([type, aggregateHash, params, newMetrics, allCustomAttrs], targetEntityGuid);
     function setCustom(key, val) {
       allCustomAttrs[key] = val && typeof val === 'object' ? (0, _stringify.stringify)(val) : val;
     }
   }
 
+  /**
+  * If the event lacks an entityGuid (the default behavior), the main agent should capture the data. If the data is assigned to a sub-entity target
+  * the main agent should not capture events unless it is configured to do so.
+  * @param {string} entityGuid - the context object for the event
+  * @returns {boolean} - whether the main agent should capture the event to its internal target
+  */
+  shouldAllowMainAgentToCapture(entityGuid) {
+    return !entityGuid || this.agentRef.init.api.duplicate_registered_data;
+  }
+
   // TO-DO: Remove this function when old spa is taken out. #storeJserrorForHarvest handles the work with the softnav feature.
   onInteractionDone(interaction, wasSaved) {
     if (!this.bufferedErrorsUnderSpa[interaction.id] || this.blocked) return;
@@ -237,7 +259,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
       var hash = wasSaved ? item[1] + interaction.root.attrs.id : item[1];
       var jsAttributesHash = (0, _stringHashCode.stringHashCode)((0, _stringify.stringify)(allCustomAttrs));
       var aggregateHash = hash + ':' + jsAttributesHash;
-      this.events.add([item[0], aggregateHash, params, item[3], allCustomAttrs]);
+      this.events.add([item[0], aggregateHash, params, item[3], allCustomAttrs], item[5]);
       function setCustom([key, val]) {
         allCustomAttrs[key] = val && typeof val === 'object' ? (0, _stringify.stringify)(val) : val;
       }