@newrelic/browser-agent 1.307.0 → 1.308.0-rc.0

package/CHANGELOG.md

@@ -3,6 +3,23 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.308.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.307.0...v1.308.0) (2026-01-08)
+
+
+### Features
+
+* Add "deregister" API ([#1632](https://github.com/newrelic/newrelic-browser-agent/issues/1632)) ([6338f04](https://github.com/newrelic/newrelic-browser-agent/commit/6338f04a2ec09ce0cbfa34e5878e14bfa5637a02))
+* add child.id attribute to facilitate MFE cross-linking ([#1662](https://github.com/newrelic/newrelic-browser-agent/issues/1662)) ([71fb23f](https://github.com/newrelic/newrelic-browser-agent/commit/71fb23f75f903f32ab07c09622692dab757ce274))
+* Add default close reason ([#1665](https://github.com/newrelic/newrelic-browser-agent/issues/1665)) ([6ff6d39](https://github.com/newrelic/newrelic-browser-agent/commit/6ff6d39cf2b3584de7b6b9a75fbceffd7bce00de))
+* add parent.type attribute to facilitate relationship synthesis ([#1661](https://github.com/newrelic/newrelic-browser-agent/issues/1661)) ([b2d3965](https://github.com/newrelic/newrelic-browser-agent/commit/b2d39659a17e1472e5b60baed04fbd0390267d95))
+* add support for mfe tags with the register API ([#1660](https://github.com/newrelic/newrelic-browser-agent/issues/1660)) ([8a835b3](https://github.com/newrelic/newrelic-browser-agent/commit/8a835b39ea62389d5922d4fedb3b55b4479dd523))
+
+
+### Bug Fixes
+
+* Clean WebSocket URLs ([#1663](https://github.com/newrelic/newrelic-browser-agent/issues/1663)) ([a381a16](https://github.com/newrelic/newrelic-browser-agent/commit/a381a16cc6d1eabb5998188f69bb744525db3464))
+* enforce non-null values on the numeric fields ([#1664](https://github.com/newrelic/newrelic-browser-agent/issues/1664)) ([78da14b](https://github.com/newrelic/newrelic-browser-agent/commit/78da14b5b5a5fcc54edfbca5284d57a3c816dd9c))
+
 ## [1.307.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.306.0...v1.307.0) (2026-01-06)
 
 

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

@@ -17,7 +17,7 @@ exports.VERSION = exports.RRWEB_VERSION = exports.RRWEB_PACKAGE_NAME = exports.D
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.307.0";
+const VERSION = exports.VERSION = "1.308.0-rc.0";
 
 /**
  * Exposes the build type of the agent

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

@@ -17,7 +17,7 @@ exports.VERSION = exports.RRWEB_VERSION = exports.RRWEB_PACKAGE_NAME = exports.D
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.307.0";
+const VERSION = exports.VERSION = "1.308.0-rc.0";
 
 /**
  * Exposes the build type of the agent

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

@@ -21,7 +21,7 @@ var _submitData = require("../util/submit-data");
 var _featureFlags = require("../util/feature-flags");
 var _globalEvent = require("../dispatch/global-event");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 

package/dist/cjs/common/util/{mfe.js → v2.js}

@@ -3,27 +3,26 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+exports.V2_TYPES = void 0;
 exports.getVersion2Attributes = getVersion2Attributes;
-exports.hasValidValue = hasValidValue;
-exports.isValidMFETarget = isValidMFETarget;
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
 /**
- * @param {Object} [target] - the target to be validated
- * @returns {boolean}
+ * @enum {string}
+ * @readonly
  */
-function isValidMFETarget(target = {}) {
-  return !!(target.id && target.name);
-}
-function hasValidValue(val) {
-  return typeof val === 'string' && val.trim().length < 501 || typeof val === 'number';
-}
+const V2_TYPES = exports.V2_TYPES = {
+  /** Micro Frontend */
+  MFE: 'MFE',
+  /** Browser Application */
+  BA: 'BA'
+};
 
 /**
- * When given a valid target, returns an object with the MFE payload attributes.  Returns an empty object otherwise.
+ * When given a valid target, returns an object with the V2 payload attributes.  Returns an empty object otherwise.
  * @note Field names may change as the schema is finalized
  *
  * @param {Object} [target] the registered target
@@ -33,16 +32,19 @@ function hasValidValue(val) {
 function getVersion2Attributes(target, aggregateInstance) {
   if (aggregateInstance?.harvestEndpointVersion !== 2) return {};
   const containerAgentEntityGuid = aggregateInstance.agentRef.runtime.appMetadata.agents[0].entityGuid;
-  if (!isValidMFETarget(target)) {
+  /** if there's no target, but we are in v2 mode, this means the data belongs to the container agent */
+  if (!target) {
     return {
       'entity.guid': containerAgentEntityGuid,
       appId: aggregateInstance.agentRef.info.applicationID
     };
   }
+  /** otherwise, the data belongs to the target (MFE) and should be attributed as such */
   return {
     'source.id': target.id,
     'source.name': target.name,
     'source.type': target.type,
-    'parent.id': target.parent?.id || containerAgentEntityGuid
+    'parent.id': target.parent?.id || containerAgentEntityGuid,
+    'parent.type': target.parent?.type || V2_TYPES.BA
   };
 }

package/dist/cjs/common/wrap/wrap-websocket.js

@@ -7,10 +7,11 @@ exports.wrapWebSocket = wrapWebSocket;
 var _runtime = require("../constants/runtime");
 var _uniqueId = require("../ids/unique-id");
 var _now = require("../timing/now");
+var _cleanUrl = require("../url/clean-url");
 var _nreum = require("../window/nreum");
 var _pageVisibility = require("../window/page-visibility");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
@@ -75,11 +76,11 @@ function wrapWebSocket(sharedEE) {
           type,
           size
         } = getDataInfo(event.data);
-        this.nrData.messageOrigin ??= event.origin; // the origin of messages thru WS lifetime cannot be changed, so set once is sufficient
-        this.nrData.messageCount = (this.nrData.messageCount ?? 0) + 1;
-        this.nrData.messageBytes = (this.nrData.messageBytes ?? 0) + size;
-        this.nrData.messageBytesMin = Math.min(this.nrData.messageBytesMin ?? Infinity, size);
-        this.nrData.messageBytesMax = Math.max(this.nrData.messageBytesMax ?? 0, size);
+        this.nrData.messageOrigin ??= (0, _cleanUrl.cleanURL)(event.origin); // the origin of messages thru WS lifetime cannot be changed, so set once is sufficient
+        this.nrData.messageCount++;
+        this.nrData.messageBytes += size;
+        this.nrData.messageBytesMin = Math.min(this.nrData.messageBytesMin || Infinity, size);
+        this.nrData.messageBytesMax = Math.max(this.nrData.messageBytesMax, size);
         if (!(this.nrData.messageTypes ?? '').includes(type)) {
           this.nrData.messageTypes = this.nrData.messageTypes ? "".concat(this.nrData.messageTypes, ",").concat(type) : type;
         }
@@ -87,7 +88,7 @@ function wrapWebSocket(sharedEE) {
       this.addEventListener('close', event => {
         this.nrData.closedAt = (0, _now.now)();
         this.nrData.closeCode = event.code;
-        this.nrData.closeReason = event.reason;
+        if (event.reason) this.nrData.closeReason = event.reason;
         this.nrData.closeWasClean = event.wasClean;
         this.nrData.connectedDuration = this.nrData.closedAt - this.nrData.openedAt;
         openWebSockets.delete(this); // remove from tracking set since it's now closed
@@ -123,10 +124,10 @@ function wrapWebSocket(sharedEE) {
           type,
           size
         } = getDataInfo(data);
-        this.nrData.sendCount = (this.nrData.sendCount ?? 0) + 1;
-        this.nrData.sendBytes = (this.nrData.sendBytes ?? 0) + size;
-        this.nrData.sendBytesMin = Math.min(this.nrData.sendBytesMin ?? Infinity, size);
-        this.nrData.sendBytesMax = Math.max(this.nrData.sendBytesMax ?? 0, size);
+        this.nrData.sendCount++;
+        this.nrData.sendBytes += size;
+        this.nrData.sendBytesMin = Math.min(this.nrData.sendBytesMin || Infinity, size);
+        this.nrData.sendBytesMax = Math.max(this.nrData.sendBytesMax, size);
         if (!(this.nrData.sendTypes ?? '').includes(type)) {
           this.nrData.sendTypes = this.nrData.sendTypes ? "".concat(this.nrData.sendTypes, ",").concat(type) : type;
         }
@@ -206,7 +207,7 @@ class WebSocketData {
     this.timestamp = (0, _now.now)();
 
     /** @type {string} Most current URL when WebSocket was created; relevant for SPA */
-    this.currentUrl = window.location.href;
+    this.currentUrl = (0, _cleanUrl.cleanURL)(window.location.href);
 
     /*
      * pageUrl will be set by addEvent later; unlike timestamp and currentUrl, it's not sensitive to *when* it is set.
@@ -217,7 +218,7 @@ class WebSocketData {
     this.socketId = (0, _uniqueId.generateRandomHexString)(8);
 
     /** @type {string} The URL requested for the WebSocket connection */
-    this.requestedUrl = requestedUrl;
+    this.requestedUrl = (0, _cleanUrl.cleanURL)(requestedUrl);
 
     /** @type {string} Comma-separated list of requested protocols */
     this.requestedProtocols = Array.isArray(requestedProtocols) ? requestedProtocols.join(',') : requestedProtocols || '';
@@ -239,33 +240,33 @@ class WebSocketData {
     /** @type {string} [messageOrigin] Origin of messages (set once) */
     this.messageOrigin = undefined;
 
-    /** @type {number} [messageCount] Total number of messages received */
-    this.messageCount = undefined;
+    /** @type {number} Total number of messages received */
+    this.messageCount = 0;
 
-    /** @type {number} [messageBytes] Total bytes received */
-    this.messageBytes = undefined;
+    /** @type {number} Total bytes received */
+    this.messageBytes = 0;
 
-    /** @type {number} [messageBytesMin] Minimum message size received */
-    this.messageBytesMin = undefined;
+    /** @type {number} Minimum message size received */
+    this.messageBytesMin = 0;
 
-    /** @type {number} [messageBytesMax] Maximum message size received */
-    this.messageBytesMax = undefined;
+    /** @type {number} Maximum message size received */
+    this.messageBytesMax = 0;
 
     /** @type {string} [messageTypes] Comma-separated list of message types received */
     this.messageTypes = undefined;
 
     // Send metrics
-    /** @type {number} [sendCount] Total number of messages sent */
-    this.sendCount = undefined;
+    /** @type {number} Total number of messages sent */
+    this.sendCount = 0;
 
-    /** @type {number} [sendBytes] Total bytes sent */
-    this.sendBytes = undefined;
+    /** @type {number} Total bytes sent */
+    this.sendBytes = 0;
 
-    /** @type {number} [sendBytesMin] Minimum message size sent */
-    this.sendBytesMin = undefined;
+    /** @type {number} Minimum message size sent */
+    this.sendBytesMin = 0;
 
-    /** @type {number} [sendBytesMax] Maximum message size sent */
-    this.sendBytesMax = undefined;
+    /** @type {number} Maximum message size sent */
+    this.sendBytesMax = 0;
 
     /** @type {string} [sendTypes] Comma-separated list of message types sent */
     this.sendTypes = undefined;
@@ -277,14 +278,14 @@ class WebSocketData {
     /** @type {number} [closeCode] WebSocket close code */
     this.closeCode = undefined;
 
-    /** @type {string} [closeReason] WebSocket close reason */
-    this.closeReason = undefined;
+    /** @type {string} WebSocket close reason */
+    this.closeReason = 'unknown';
 
     /** @type {boolean} [closeWasClean] Whether the connection closed cleanly */
     this.closeWasClean = undefined;
 
-    /** @type {number} [connectedDuration] Duration of the connection in milliseconds */
-    this.connectedDuration = undefined;
+    /** @type {number} Duration of the connection in milliseconds */
+    this.connectedDuration = 0;
 
     // Error tracking
     /** @type {boolean} [hasErrors] Whether any errors occurred */

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

@@ -15,7 +15,7 @@ var _gql = require("./gql");
 var _belSerializer = require("../../../common/serialize/bel-serializer");
 var _nreum = require("../../../common/window/nreum");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 

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

@@ -16,9 +16,9 @@ var _traverse = require("../../../common/util/traverse");
 var _userActionsAggregator = require("./user-actions/user-actions-aggregator");
 var _iframe = require("../../../common/dom/iframe");
 var _typeCheck = require("../../../common/util/type-check");
-var _mfe = require("../../../common/util/mfe");
+var _v = require("../../../common/util/v2");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
@@ -305,7 +305,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
       pageUrl: (0, _cleanUrl.cleanURL)('' + _runtime.initialLocation),
       currentUrl: (0, _cleanUrl.cleanURL)('' + location),
       /** Specific attributes only supplied if harvesting to endpoint version 2 */
-      ...(0, _mfe.getVersion2Attributes)(target, this)
+      ...(0, _v.getVersion2Attributes)(target, this)
     };
     const eventAttributes = {
       /** Agent-level custom attributes */

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

@@ -18,10 +18,10 @@ var _aggregateBase = require("../../utils/aggregate-base");
 var _now = require("../../../common/timing/now");
 var _traverse = require("../../../common/util/traverse");
 var _internalErrors = require("./internal-errors");
-var _mfe = require("../../../common/util/mfe");
+var _v = require("../../../common/util/v2");
 var _causeString = require("./cause-string");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
@@ -149,7 +149,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
      * the canonical stack trace excludes items like the column number increasing the hit-rate of different errors potentially
      * bucketing and ultimately resulting in the loss of data in NR1.
      */
-    var bucketHash = (0, _stringHashCode.stringHashCode)("".concat(stackInfo.name, "_").concat(stackInfo.message, "_").concat(stackInfo.stackString, "_").concat(params.hasReplay ? 1 : 0));
+    var bucketHash = (0, _stringHashCode.stringHashCode)("".concat(stackInfo.name, "_").concat(stackInfo.message, "_").concat(stackInfo.stackString, "_").concat(params.hasReplay ? 1 : 0, "_").concat(target?.id || 'container'));
     if (!this.stackReported[bucketHash]) {
       this.stackReported[bucketHash] = true;
       params.stack_trace = (0, _formatStackTrace.truncateSize)(stackInfo.stackString);
@@ -177,7 +177,7 @@ 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];
-    if (this.shouldAllowMainAgentToCapture(target)) (0, _handle.handle)('trace-jserror', jsErrorEvent, undefined, _features.FEATURE_NAMES.sessionTrace, this.ee);
+    if (!target) (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]) {
@@ -187,7 +187,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     if (err.__newrelic?.socketId) {
       customAttributes.socketId = err.__newrelic.socketId;
     }
-    if (this.shouldAllowMainAgentToCapture(target)) {
+    if (!target) {
       const softNavInUse = Boolean(this.agentRef.features?.[_features.FEATURE_NAMES.softNav]);
       if (softNavInUse) {
         // pass the error to soft nav for evaluation - it will return it via 'returnJserror' when interaction is resolved
@@ -204,7 +204,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     let [type, bucketHash, params, newMetrics, localAttrs, target] = errorInfoArr;
     const allCustomAttrs = {
       /** MFE specific attributes if in "multiple" mode (ie consumer version 2) */
-      ...(0, _mfe.getVersion2Attributes)(target, this)
+      ...(0, _v.getVersion2Attributes)(target, this)
     };
     Object.entries(this.agentRef.info.jsAttributes).forEach(([k, v]) => setCustom(k, v));
     Object.entries(softNavCustomAttrs).forEach(([k, v]) => setCustom(k, v)); // when an ixn finishes, it'll pass attrs specific to the ixn; if no associated ixn, this defaults to empty
@@ -218,15 +218,5 @@ class Aggregate extends _aggregateBase.AggregateBase {
       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} target - the context object for the event
-  * @returns {boolean} - whether the main agent should capture the event to its internal target
-  */
-  shouldAllowMainAgentToCapture(target) {
-    return !target || this.agentRef.init.api.duplicate_registered_data;
-  }
 }
 exports.Aggregate = Aggregate;

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

@@ -15,9 +15,9 @@ var _traverse = require("../../../common/util/traverse");
 var _constants2 = require("../../../common/session/constants");
 var _constants3 = require("../../session_replay/constants");
 var _featureGates = require("../../utils/feature-gates");
-var _mfe = require("../../../common/util/mfe");
+var _v = require("../../../common/util/v2");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
@@ -81,7 +81,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     attributes = {
       ...attributes,
       /** Specific attributes only supplied if harvesting to endpoint version 2 */
-      ...(0, _mfe.getVersion2Attributes)(target, this)
+      ...(0, _v.getVersion2Attributes)(target, this)
     };
     if (typeof level === 'string') level = level.toUpperCase();
     if (!(0, _utils.isValidLogLevel)(level)) return (0, _console.warn)(30, level);

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

@@ -14,7 +14,7 @@ var _ajaxNode = require("./ajax-node");
 var _initialPageLoadInteraction = require("./initial-page-load-interaction");
 var _interaction = require("./interaction");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 

package/dist/cjs/features/utils/agent-session.js

@@ -18,7 +18,7 @@ var _constants3 = require("../metrics/constants");
 var _features = require("../../loaders/features/features");
 var _sharedHandlers = require("../../loaders/api/sharedHandlers");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 

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

@@ -19,7 +19,7 @@ var _constants = require("../metrics/constants");
 var _eventAggregator = require("../../common/aggregate/event-aggregator");
 var _agentConstants = require("../../common/constants/agent-constants");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 

package/dist/cjs/interfaces/registered-entity.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.RegisteredEntity = void 0;
 var _console = require("../common/util/console");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
@@ -54,6 +54,31 @@ class RegisteredEntity {
     (0, _console.warn)(35, 'addPageAction');
   }
 
+  /**
+   * @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. Will be related to this registered entity when called through this access point.
+   * @param {import('../loaders/api/register-api-types').RegisterAPIConstructor} target the target object to report data to
+    @returns {import('../loaders/api/register-api-types').RegisterAPI} 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) {
+    (0, _console.warn)(35, 'register');
+  }
+
+  /**
+   * @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.
+   *
+   * Deregister the registered entity (this), which blocks its use and captures end of life timings.
+   * @returns {void}
+   */
+  deregister() {
+    (0, _console.warn)(35, 'deregister');
+  }
+
   /**
      * Records a custom event with a specified eventType and attributes.
      * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/recordCustomEvent/}

package/dist/cjs/loaders/api/interaction.js

@@ -11,7 +11,7 @@ var _features = require("../features/features");
 var _constants2 = require("./constants");
 var _sharedHandlers = require("./sharedHandlers");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 

package/dist/cjs/loaders/api/register-api-types.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 /**
@@ -14,6 +14,7 @@ exports.default = void 0;
  * @property {(message: string, options?: { customAttributes?: object, level?: 'ERROR' | 'TRACE' | 'DEBUG' | 'INFO' | 'WARN'}) => void} log - Capture a log for the registered entity.
  * @property {(error: Error | string, customAttributes?: object) => void} noticeError - Notice an error for the registered entity.
  * @property {(target: RegisterAPIConstructor) => RegisterAPI} register - Record a custom event for the registered entity.
+ * @property {() => void} deregister - Deregister the registered entity, which blocks its use and captures end of life timings.
  * @property {(eventType: string, attributes?: Object) => void} recordCustomEvent - Record a custom event for the registered entity.
  * @property {(eventType: string, options?: {start: number, end: number, duration: number, customAttributes: object}) => ({start: number, end: number, duration: number, customAttributes: object})} measure - Measures a task that is recorded as a BrowserPerformance event.
  * @property {(value: string | null) => void} setApplicationVersion - Add an application.version attribute to all outgoing data for the registered entity.
@@ -25,6 +26,7 @@ exports.default = void 0;
  * @typedef {Object} RegisterAPIConstructor
  * @property {string|number} id - The unique id for the registered entity. This will be assigned to any synthesized entities.
  * @property {string} name - The readable name for the registered entity. This will be assigned to any synthesized entities.
+ * @property {boolean} [isolated] - When true, each registration creates an isolated instance. When false, multiple registrations with the same id and isolated: false will share a single instance, including all custom attributes, ids, names, and metadata. Calling deregister on a shared instance will deregister it for all entities using the instance. Defaults to true.
  * @property {string} [parentId] - The parentId for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
  */
 /**
@@ -35,5 +37,6 @@ exports.default = void 0;
  * @property {string} target.id - The ID for the registered entity.
  * @property {string} target.name - The name returned for the registered entity.
  * @property {string} [target.parentId] - The parentId for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
+ * @property {boolean} [target.isolated] - When true, each registration creates an isolated instance. When false, multiple registrations with the same id and isolated: false will share a single instance, including all custom attributes, ids, names, and metadata. Calling deregister on a shared instance will deregister it for all entities using the instance. Defaults to true.
  */
 var _default = exports.default = {};

package/dist/cjs/loaders/api/register.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.setupRegisterAPI = setupRegisterAPI;
 var _handle = require("../../common/event-emitter/handle");
 var _console = require("../../common/util/console");
-var _mfe = require("../../common/util/mfe");
+var _v = require("../../common/util/v2");
 var _features = require("../features/features");
 var _now = require("../../common/timing/now");
 var _constants = require("../../features/metrics/constants");
@@ -19,7 +19,7 @@ var _invoke = require("../../common/util/invoke");
 var _measure = require("./measure");
 var _recordCustomEvent = require("./recordCustomEvent");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
@@ -47,31 +47,33 @@ function setupRegisterAPI(agent) {
  * @returns {RegisterAPI} the api object to be returned from the register api method
  */
 function register(agentRef, target, parent) {
-  const attrs = {};
   (0, _console.warn)(54, 'newrelic.register');
   target ||= {};
-  target.type = 'MFE';
+  target.type = _v.V2_TYPES.MFE;
   target.licenseKey ||= agentRef.info.licenseKey; // will inherit the license key from the container agent if not provided for brevity. A future state may dictate that we need different license keys to do different things.
   target.blocked = false;
   target.parent = parent || {};
+  if (!Array.isArray(target.tags)) target.tags = [];
+  const attrs = {};
+  target.tags.forEach(tag => {
+    if (tag !== 'name' && tag !== 'id') attrs["source.".concat(tag)] = true;
+  });
+  target.isolated ??= true;
 
   /** @type {Function} a function that is set and reports when APIs are triggered -- warns the customer of the invalid state  */
   let invalidApiResponse = () => {};
   /** @type {Array} the array of registered target APIs */
   const registeredEntities = agentRef.runtime.registeredEntities;
-
-  /** if we have already registered this target, go ahead and re-use it */
-  const preregisteredEntity = registeredEntities.find(({
-    metadata: {
-      target: {
-        id,
-        name
+  if (!target.isolated) {
+    /** if we have already registered this non-isolated target, go ahead and re-use it */
+    const sharedEntity = registeredEntities.find(({
+      metadata: {
+        target: {
+          id
+        }
       }
-    }
-  }) => id === target.id);
-  if (preregisteredEntity) {
-    if (preregisteredEntity.metadata.target.name !== target.name) preregisteredEntity.metadata.target.name = target.name;
-    return preregisteredEntity;
+    }) => id === target.id && !target.isolated);
+    if (sharedEntity) return sharedEntity;
   }
 
   /**
@@ -82,13 +84,13 @@ function register(agentRef, target, parent) {
     target.blocked = true;
     invalidApiResponse = warning;
   };
+  function hasValidValue(val) {
+    return typeof val === 'string' && !!val.trim() && val.trim().length < 501 || typeof val === 'number';
+  }
 
   /** primary cases that can block the register API from working at init time */
   if (!agentRef.init.api.allow_registered_children) block((0, _invoke.single)(() => (0, _console.warn)(55)));
-  if (!(0, _mfe.isValidMFETarget)(target)) block((0, _invoke.single)(() => (0, _console.warn)(48, target)));
-  if (!(0, _mfe.hasValidValue)(target.id) || !(0, _mfe.hasValidValue)(target.name)) {
-    block((0, _invoke.single)(() => (0, _console.warn)(48, target)));
-  }
+  if (!hasValidValue(target.id) || !hasValidValue(target.name)) block((0, _invoke.single)(() => (0, _console.warn)(48, target)));
 
   /** @type {RegisterAPI} */
   const api = {
@@ -96,6 +98,10 @@ function register(agentRef, target, parent) {
       ...attrs,
       ...attributes
     }, agentRef], target),
+    deregister: () => {
+      /** note: blocking this instance will disable access for all entities sharing the instance, and will invalidate it from the v2 checks */
+      block((0, _invoke.single)(() => (0, _console.warn)(68)));
+    },
     log: (message, options = {}) => report(_log.log, [message, {
       ...options,
       customAttributes: {
@@ -168,8 +174,24 @@ function register(agentRef, target, parent) {
     try {
       const shouldDuplicate = agentRef.init.api.duplicate_registered_data && methodToCall.name !== 'register';
       if (shouldDuplicate) {
-        // also report to container by providing undefined target
-        methodToCall(...args, undefined, timestamp);
+        let duplicatedArgs = args;
+        if (args[1] instanceof Object) {
+          const childAttrs = {
+            'child.id': target.id,
+            'child.type': target.type
+          };
+          if ('customAttributes' in args[1]) duplicatedArgs = [args[0], {
+            ...args[1],
+            customAttributes: {
+              ...args[1].customAttributes,
+              ...childAttrs
+            }
+          }, ...args.slice(2)];else duplicatedArgs = [args[0], {
+            ...args[1],
+            ...childAttrs
+          }, ...args.slice(2)];
+        }
+        methodToCall(...duplicatedArgs, undefined, timestamp);
       }
       return methodToCall(...args, target, timestamp); // always report to target
     } catch (err) {

package/dist/cjs/loaders/api/setUserId.js

@@ -9,7 +9,7 @@ var _constants = require("./constants");
 var _sharedHandlers = require("./sharedHandlers");
 var _handle = require("../../common/event-emitter/handle");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 

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

@@ -7,7 +7,7 @@ exports.ApiBase = void 0;
 var _console = require("../common/util/console");
 var _constants = require("./api/constants");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 

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

@@ -16,7 +16,7 @@ var _contextualEe = require("../../common/event-emitter/contextual-ee");
 var _globalEvent = require("../../common/dispatch/global-event");
 var _loaderConfig = require("../../common/config/loader-config");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */