@newrelic/browser-agent 1.312.1-rc.0 → 1.312.1-rc.2

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

@@ -17,8 +17,9 @@ exports.default = void 0;
  * @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} [api.register]
+ * @property {boolean} [api.register.enabled] - If true, the agent will allow registered children to be sent to the server.
+ * @property {boolean} [api.register.duplicate_data_to_container] - 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]

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

@@ -27,7 +27,7 @@ const InitModelFn = () => {
   const hiddenState = {
     feature_flags: [],
     experimental: {
-      allow_registered_children: false,
+      register: false,
       resources: false
     },
     mask_selector: '*',
@@ -60,13 +60,15 @@ const InitModelFn = () => {
       autoStart: true
     },
     api: {
-      get allow_registered_children() {
-        return hiddenState.feature_flags.includes(_constants.FEATURE_FLAGS.REGISTER) || hiddenState.experimental.allow_registered_children;
-      },
-      set allow_registered_children(val) {
-        hiddenState.experimental.allow_registered_children = val;
-      },
-      duplicate_registered_data: false
+      register: {
+        get enabled() {
+          return hiddenState.feature_flags.includes(_constants.FEATURE_FLAGS.REGISTER) || hiddenState.experimental.register;
+        },
+        set enabled(val) {
+          hiddenState.experimental.register = val;
+        },
+        duplicate_data_to_container: false
+      }
     },
     browser_consent_mode: {
       enabled: false

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.312.1-rc.0";
+const VERSION = exports.VERSION = "1.312.1-rc.2";
 
 /**
  * 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.312.1-rc.0";
+const VERSION = exports.VERSION = "1.312.1-rc.2";
 
 /**
  * Exposes the build type of the agent

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

@@ -34,7 +34,7 @@ const V2_TYPES = exports.V2_TYPES = {
  * @returns {import("../../interfaces/registered-entity").RegisterAPIMetadataTarget[]}
  */
 function getRegisteredTargetsFromId(id, agentRef) {
-  if (!id || !agentRef?.init.api.allow_registered_children) return [];
+  if (!id || !agentRef?.init.api.register.enabled) return [];
   const registeredEntities = agentRef.runtime.registeredEntities;
   return registeredEntities?.filter(entity => String(entity.metadata.target.id) === String(id)).map(entity => entity.metadata.target) || [];
 }
@@ -46,7 +46,7 @@ function getRegisteredTargetsFromId(id, agentRef) {
  * @returns {import("../../interfaces/registered-entity").RegisterAPIMetadataTarget[]}
  */
 function getRegisteredTargetsFromFilename(filename, agentRef) {
-  if (!filename || !agentRef?.init.api.allow_registered_children) return [];
+  if (!filename || !agentRef?.init.api.register.enabled) return [];
   const registeredEntities = agentRef.runtime.registeredEntities;
   return registeredEntities?.filter(entity => entity.metadata.timings?.asset?.endsWith(filename)).map(entity => entity.metadata.target) || [];
 }
@@ -98,7 +98,7 @@ function getVersion2DuplicationAttributes(target, aggregateInstance) {
  * @returns {boolean} returns true if the event should be duplicated for the target, false otherwise
  */
 function shouldDuplicate(target, aggregateInstance) {
-  return !!target && !!supportsV2(aggregateInstance) && aggregateInstance.agentRef.init.api.duplicate_registered_data;
+  return !!target && !!supportsV2(aggregateInstance) && aggregateInstance.agentRef.init.api.register.duplicate_data_to_container;
 }
 
 /**
@@ -107,7 +107,7 @@ function shouldDuplicate(target, aggregateInstance) {
  * @returns {Array} An array of targets found from the stack trace. If no targets are found or allowed, returns an array with undefined.
  */
 function findTargetsFromStackTrace(agentRef) {
-  if (!agentRef?.init.api.allow_registered_children) return [undefined];
+  if (!agentRef?.init.api.register.enabled) return [undefined];
   const targets = [];
   try {
     var urls = (0, _scriptTracker.extractUrlsFromStack)((0, _scriptTracker.getDeepStackTrace)());

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

@@ -24,18 +24,18 @@ var _console = require("../common/util/console");
  * An interface for registering an external caller to report through the base agent to a different target than the base agent.
  */
 class RegisteredEntity {
-  /** @type {RegisterAPIMetadata} */
-  metadata = {
-    target: {},
-    timings: {},
-    customAttributes: {}
-  };
-
   /**
    *
    * @param {RegisterAPIConstructor} opts The options for setting up the registered entity.
    */
   constructor(opts) {
+    // Initialize metadata as an own property to ensure it exists even when agent is missing
+    /** @type {RegisterAPIMetadata} */
+    this.metadata = {
+      target: (/** @type {import('../loaders/api/register-api-types').RegisterAPITarget} */{}),
+      timings: (/** @type {import('../loaders/api/register-api-types').RegisterAPITimings} */{}),
+      customAttributes: {}
+    };
     try {
       if (!window?.newrelic) return (0, _console.warn)(51);
       Object.assign(this, window?.newrelic?.register(opts) || {});
@@ -55,19 +55,6 @@ 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.

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

@@ -13,7 +13,6 @@ exports.default = void 0;
  * @property {(name: string, attributes?: object) => void} addPageAction - Add a page action for the registered entity.
  * @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|PerformanceMark, end?: number|PerformanceMark, customAttributes?: object}) => ({start: number, end: number, duration: number, customAttributes: object})} measure - Measures a task that is recorded as a BrowserPerformance event.
@@ -27,14 +26,14 @@ exports.default = void 0;
  * @property {string} 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 {{[key: string]: any}} [tags] - The tags for the registered entity as key-value pairs. This will be assigned to any synthesized entities. Tags are converted to source.* attributes (e.g., {environment: 'production'} becomes source.environment: 'production').
- * @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 {RegisterAPITarget} [parent] - The parent target for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
  * @property {string} [parentId] - The parentId for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
  */
 /**
  * @typedef {Object} RegisterAPIMetadata
  * @property {Object} customAttributes - The custom attributes for the registered entity.
- * @property {RegisterAPITimings} timings - The timing metrics for the registered entity.
- * @property {RegisterAPITarget} target - The options for the registered entity.
+ * @property {Partial<RegisterAPITimings>} timings - The timing metrics for the registered entity.
+ * @property {Partial<RegisterAPITarget>} target - The options for the registered entity.
  */
 /**
  * @typedef {Object} RegisterAPITarget
@@ -42,7 +41,6 @@ exports.default = void 0;
  * @property {string} name - The name returned for the registered entity.
  * @property {{[key: string]: any}} [tags] - The tags for the registered entity as key-value pairs.
  * @property {string} [parentId] - The parentId for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
- * @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.
  */
 /**
  * @typedef {Object} RegisterAPITimings

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

@@ -48,10 +48,9 @@ function setupRegisterAPI(agent) {
  * Also conducts certain side-effects, such as harvesting a PageView event when triggered and gathering metadata for the registered entity.
  * @param {Object} agentRef the reference to the base agent instance
  * @param {import('./register-api-types').RegisterAPIConstructor} target
- * @param {import('./register-api-types').RegisterAPIConstructor} [parent]
  * @returns {RegisterAPI} the api object to be returned from the register api method
  */
-function register(agentRef, target, parent) {
+function register(agentRef, target) {
   (0, _console.warn)(54, 'newrelic.register');
   target ||= {};
   target.instance = (0, _uniqueId.generateRandomHexString)(8);
@@ -59,7 +58,7 @@ function register(agentRef, target, parent) {
   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;
   if (typeof target.tags !== 'object' || target.tags === null || Array.isArray(target.tags)) target.tags = {};
-  target.parent = parent || {
+  target.parent ??= {
     get id() {
       return agentRef.runtime.appMetadata.agents[0].entityGuid;
     },
@@ -87,23 +86,11 @@ function register(agentRef, target, parent) {
       attrs["source.".concat(key)] = value;
     }
   });
-  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 (!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 && !target.isolated);
-    if (sharedEntity) return sharedEntity;
-  }
 
   /**
    * Block the API, and supply a warning function to display a message to end users
@@ -118,7 +105,7 @@ function register(agentRef, target, parent) {
   }
 
   /** 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 (!agentRef.init.api.register.enabled) block((0, _invoke.single)(() => (0, _console.warn)(55)));
   if (!hasValidValue(target.id) || !hasValidValue(target.name)) block((0, _invoke.single)(() => (0, _console.warn)(48, target)));
 
   /** @type {RegisterAPI} */
@@ -150,7 +137,6 @@ function register(agentRef, target, parent) {
       ...attrs,
       ...attributes
     }, agentRef], target),
-    register: (target = {}) => report(register, [agentRef, target], api.metadata.target),
     recordCustomEvent: (eventType, attributes = {}) => report(_recordCustomEvent.recordCustomEvent, [eventType, {
       ...attrs,
       ...attributes
@@ -222,7 +208,7 @@ function register(agentRef, target, parent) {
 
   /**
      * The reporter method that will be used to report the data to the container agent's API method. If invalid, will log a warning and not execute.
-     * If the api.duplicate_registered_data configuration value is set to true, the data will be reported to BOTH the container and the external target
+     * If the api.register.duplicate_data_to_container configuration value is set to true, the data will be reported to BOTH the container and the external target
      * @param {*} methodToCall the container agent's API method to call
      * @param {*} args the arguments to supply to the container agent's API method
      * @param {string} target the target to report the data to. If undefined, will report to the container agent's target.

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

@@ -12,8 +12,9 @@
  * @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} [api.register]
+ * @property {boolean} [api.register.enabled] - If true, the agent will allow registered children to be sent to the server.
+ * @property {boolean} [api.register.duplicate_data_to_container] - 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]

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

@@ -21,7 +21,7 @@ const InitModelFn = () => {
   const hiddenState = {
     feature_flags: [],
     experimental: {
-      allow_registered_children: false,
+      register: false,
       resources: false
     },
     mask_selector: '*',
@@ -54,13 +54,15 @@ const InitModelFn = () => {
       autoStart: true
     },
     api: {
-      get allow_registered_children() {
-        return hiddenState.feature_flags.includes(FEATURE_FLAGS.REGISTER) || hiddenState.experimental.allow_registered_children;
-      },
-      set allow_registered_children(val) {
-        hiddenState.experimental.allow_registered_children = val;
-      },
-      duplicate_registered_data: false
+      register: {
+        get enabled() {
+          return hiddenState.feature_flags.includes(FEATURE_FLAGS.REGISTER) || hiddenState.experimental.register;
+        },
+        set enabled(val) {
+          hiddenState.experimental.register = val;
+        },
+        duplicate_data_to_container: false
+      }
     },
     browser_consent_mode: {
       enabled: false

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

@@ -11,7 +11,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.312.1-rc.0";
+export const VERSION = "1.312.1-rc.2";
 
 /**
  * Exposes the build type of the agent

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

@@ -11,7 +11,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.312.1-rc.0";
+export const VERSION = "1.312.1-rc.2";
 
 /**
  * Exposes the build type of the agent

package/dist/esm/common/util/v2.js

@@ -23,7 +23,7 @@ export const V2_TYPES = {
  * @returns {import("../../interfaces/registered-entity").RegisterAPIMetadataTarget[]}
  */
 export function getRegisteredTargetsFromId(id, agentRef) {
-  if (!id || !agentRef?.init.api.allow_registered_children) return [];
+  if (!id || !agentRef?.init.api.register.enabled) return [];
   const registeredEntities = agentRef.runtime.registeredEntities;
   return registeredEntities?.filter(entity => String(entity.metadata.target.id) === String(id)).map(entity => entity.metadata.target) || [];
 }
@@ -35,7 +35,7 @@ export function getRegisteredTargetsFromId(id, agentRef) {
  * @returns {import("../../interfaces/registered-entity").RegisterAPIMetadataTarget[]}
  */
 export function getRegisteredTargetsFromFilename(filename, agentRef) {
-  if (!filename || !agentRef?.init.api.allow_registered_children) return [];
+  if (!filename || !agentRef?.init.api.register.enabled) return [];
   const registeredEntities = agentRef.runtime.registeredEntities;
   return registeredEntities?.filter(entity => entity.metadata.timings?.asset?.endsWith(filename)).map(entity => entity.metadata.target) || [];
 }
@@ -87,7 +87,7 @@ export function getVersion2DuplicationAttributes(target, aggregateInstance) {
  * @returns {boolean} returns true if the event should be duplicated for the target, false otherwise
  */
 export function shouldDuplicate(target, aggregateInstance) {
-  return !!target && !!supportsV2(aggregateInstance) && aggregateInstance.agentRef.init.api.duplicate_registered_data;
+  return !!target && !!supportsV2(aggregateInstance) && aggregateInstance.agentRef.init.api.register.duplicate_data_to_container;
 }
 
 /**
@@ -96,7 +96,7 @@ export function shouldDuplicate(target, aggregateInstance) {
  * @returns {Array} An array of targets found from the stack trace. If no targets are found or allowed, returns an array with undefined.
  */
 export function findTargetsFromStackTrace(agentRef) {
-  if (!agentRef?.init.api.allow_registered_children) return [undefined];
+  if (!agentRef?.init.api.register.enabled) return [undefined];
   const targets = [];
   try {
     var urls = extractUrlsFromStack(getDeepStackTrace());

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

@@ -18,18 +18,18 @@ import { warn } from '../common/util/console';
  * An interface for registering an external caller to report through the base agent to a different target than the base agent.
  */
 export class RegisteredEntity {
-  /** @type {RegisterAPIMetadata} */
-  metadata = {
-    target: {},
-    timings: {},
-    customAttributes: {}
-  };
-
   /**
    *
    * @param {RegisterAPIConstructor} opts The options for setting up the registered entity.
    */
   constructor(opts) {
+    // Initialize metadata as an own property to ensure it exists even when agent is missing
+    /** @type {RegisterAPIMetadata} */
+    this.metadata = {
+      target: (/** @type {import('../loaders/api/register-api-types').RegisterAPITarget} */{}),
+      timings: (/** @type {import('../loaders/api/register-api-types').RegisterAPITimings} */{}),
+      customAttributes: {}
+    };
     try {
       if (!window?.newrelic) return warn(51);
       Object.assign(this, window?.newrelic?.register(opts) || {});
@@ -49,19 +49,6 @@ export class RegisteredEntity {
     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) {
-    warn(35, 'register');
-  }
-
   /**
    * @experimental
    * IMPORTANT: This feature is being developed for use internally and is not in a public-facing production-ready state.

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

@@ -8,7 +8,6 @@
  * @property {(name: string, attributes?: object) => void} addPageAction - Add a page action for the registered entity.
  * @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|PerformanceMark, end?: number|PerformanceMark, customAttributes?: object}) => ({start: number, end: number, duration: number, customAttributes: object})} measure - Measures a task that is recorded as a BrowserPerformance event.
@@ -23,15 +22,15 @@
  * @property {string} 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 {{[key: string]: any}} [tags] - The tags for the registered entity as key-value pairs. This will be assigned to any synthesized entities. Tags are converted to source.* attributes (e.g., {environment: 'production'} becomes source.environment: 'production').
- * @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 {RegisterAPITarget} [parent] - The parent target for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
  * @property {string} [parentId] - The parentId for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
  */
 
 /**
  * @typedef {Object} RegisterAPIMetadata
  * @property {Object} customAttributes - The custom attributes for the registered entity.
- * @property {RegisterAPITimings} timings - The timing metrics for the registered entity.
- * @property {RegisterAPITarget} target - The options for the registered entity.
+ * @property {Partial<RegisterAPITimings>} timings - The timing metrics for the registered entity.
+ * @property {Partial<RegisterAPITarget>} target - The options for the registered entity.
  */
 
 /**
@@ -40,7 +39,6 @@
  * @property {string} name - The name returned for the registered entity.
  * @property {{[key: string]: any}} [tags] - The tags for the registered entity as key-value pairs.
  * @property {string} [parentId] - The parentId for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
- * @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.
  */
 
 /**

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

@@ -42,10 +42,9 @@ export function setupRegisterAPI(agent) {
  * Also conducts certain side-effects, such as harvesting a PageView event when triggered and gathering metadata for the registered entity.
  * @param {Object} agentRef the reference to the base agent instance
  * @param {import('./register-api-types').RegisterAPIConstructor} target
- * @param {import('./register-api-types').RegisterAPIConstructor} [parent]
  * @returns {RegisterAPI} the api object to be returned from the register api method
  */
-function register(agentRef, target, parent) {
+function register(agentRef, target) {
   warn(54, 'newrelic.register');
   target ||= {};
   target.instance = generateRandomHexString(8);
@@ -53,7 +52,7 @@ function register(agentRef, target, parent) {
   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;
   if (typeof target.tags !== 'object' || target.tags === null || Array.isArray(target.tags)) target.tags = {};
-  target.parent = parent || {
+  target.parent ??= {
     get id() {
       return agentRef.runtime.appMetadata.agents[0].entityGuid;
     },
@@ -81,23 +80,11 @@ function register(agentRef, target, parent) {
       attrs["source.".concat(key)] = value;
     }
   });
-  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 (!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 && !target.isolated);
-    if (sharedEntity) return sharedEntity;
-  }
 
   /**
    * Block the API, and supply a warning function to display a message to end users
@@ -112,7 +99,7 @@ function register(agentRef, target, parent) {
   }
 
   /** primary cases that can block the register API from working at init time */
-  if (!agentRef.init.api.allow_registered_children) block(single(() => warn(55)));
+  if (!agentRef.init.api.register.enabled) block(single(() => warn(55)));
   if (!hasValidValue(target.id) || !hasValidValue(target.name)) block(single(() => warn(48, target)));
 
   /** @type {RegisterAPI} */
@@ -144,7 +131,6 @@ function register(agentRef, target, parent) {
       ...attrs,
       ...attributes
     }, agentRef], target),
-    register: (target = {}) => report(register, [agentRef, target], api.metadata.target),
     recordCustomEvent: (eventType, attributes = {}) => report(recordCustomEvent, [eventType, {
       ...attrs,
       ...attributes
@@ -216,7 +202,7 @@ function register(agentRef, target, parent) {
 
   /**
      * The reporter method that will be used to report the data to the container agent's API method. If invalid, will log a warning and not execute.
-     * If the api.duplicate_registered_data configuration value is set to true, the data will be reported to BOTH the container and the external target
+     * If the api.register.duplicate_data_to_container configuration value is set to true, the data will be reported to BOTH the container and the external target
      * @param {*} methodToCall the container agent's API method to call
      * @param {*} args the arguments to supply to the container agent's API method
      * @param {string} target the target to report the data to. If undefined, will report to the container agent's target.

package/dist/types/common/config/init-types.d.ts

@@ -20,14 +20,16 @@ export type Init = {
         autoStart?: boolean | undefined;
     } | undefined;
     api?: {
-        /**
-         * - If true, the agent will allow registered children to be sent to the server.
-         */
-        allow_registered_children?: boolean | undefined;
-        /**
-         * - If true, the agent will capture registered child data to the main agent as well as the registered child.
-         */
-        duplicate_registered_data?: boolean | undefined;
+        register?: {
+            /**
+             * - If true, the agent will allow registered children to be sent to the server.
+             */
+            enabled?: boolean | undefined;
+            /**
+             * - If true, the agent will capture registered child data to the main agent as well as the registered child.
+             */
+            duplicate_data_to_container?: boolean | undefined;
+        } | undefined;
     } | undefined;
     distributed_tracing?: {
         /**

package/dist/types/common/config/init-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-types.d.ts","sourceRoot":"","sources":["../../../../src/common/config/init-types.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAqCsB,MAAM,GAAG,MAAM;qBAAe,MAAM"}
+{"version":3,"file":"init-types.d.ts","sourceRoot":"","sources":["../../../../src/common/config/init-types.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAsCsB,MAAM,GAAG,MAAM;qBAAe,MAAM"}

package/dist/types/common/config/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/common/config/init.js"],"names":[],"mappings":"AA6IO,0CAEN;mBApIY,OAAO,cAAc,EAAE,IAAI"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/common/config/init.js"],"names":[],"mappings":"AA+IO,0CAEN;mBAtIY,OAAO,cAAc,EAAE,IAAI"}

package/dist/types/interfaces/registered-entity.d.ts

@@ -25,16 +25,6 @@ export class RegisteredEntity {
      * @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: string, attributes?: object): void;
-    /**
-     * @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: import("../loaders/api/register-api-types").RegisterAPIConstructor): import("../loaders/api/register-api-types").RegisterAPI;
     /**
      * @experimental
      * IMPORTANT: This feature is being developed for use internally and is not in a public-facing production-ready state.

package/dist/types/interfaces/registered-entity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registered-entity.d.ts","sourceRoot":"","sources":["../../../src/interfaces/registered-entity.js"],"names":[],"mappings":"AAMA;;;;GAIG;AAEH;;;;;;GAMG;AACH;IAQE;;;OAGG;IACH,kBAFW,sBAAsB,EAShC;IAlBD,kCAAkC;IAClC,UADW,mBAAmB,CAK7B;IAeD;;;;;OAKG;IACH,oBAHW,MAAM,eACN,MAAM,QAKhB;IAED;;;;;;;;OAQG;IACH,iBAHW,OAAO,mCAAmC,EAAE,sBAAsB,GACjE,OAAO,mCAAmC,EAAE,WAAW,CAIlE;IAED;;;;;;;OAOG;IACH,cAFa,IAAI,CAIhB;IAED;;;;;SAKK;IACL,6BAHa,MAAM,eACN,MAAM,QAIlB;IAED;;;;;;OAMG;IACH,cAJW,MAAM,YACN;QAAC,KAAK,CAAC,EAAE,MAAM,GAAC,eAAe,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,GAAC,eAAe,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAC,GACvF;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAC,CAIpF;IAED;;;;;;OAMG;IACH,yBAJW,MAAM,SACN,MAAM,GAAC,MAAM,GAAC,OAAO,GAAC,IAAI,YAC1B,OAAO,QAKjB;IAED;;;;;OAKG;IACH,mBAHW,KAAK,GAAC,MAAM,qBACZ,MAAM,QAKhB;IAED;;;;;OAKG;IACH,iBAHW,MAAM,GAAC,IAAI,iBACX,OAAO,QAKjB;IAED;;;;;;;OAOG;IACH,6BAJW,MAAM,GAAC,IAAI,QAOrB;IAED;;;;;MAKE;IACF,aAHW,MAAM,YACN;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,GAAC,OAAO,GAAC,OAAO,GAAC,MAAM,GAAC,MAAM,CAAA;KAAC,QAKpF;CACF;0BAnJY,OAAO,mCAAmC,EAAE,WAAW;kCACvD,OAAO,mCAAmC,EAAE,mBAAmB;qCAC/D,OAAO,mCAAmC,EAAE,sBAAsB"}
+{"version":3,"file":"registered-entity.d.ts","sourceRoot":"","sources":["../../../src/interfaces/registered-entity.js"],"names":[],"mappings":"AAMA;;;;GAIG;AAEH;;;;;;GAMG;AACH;IACE;;;OAGG;IACH,kBAFW,sBAAsB,EAiBhC;IAbC,kCAAkC;IAClC,UADW,mBAAmB,CAK7B;IAUH;;;;;OAKG;IACH,oBAHW,MAAM,eACN,MAAM,QAKhB;IAED;;;;;;;OAOG;IACH,cAFa,IAAI,CAIhB;IAED;;;;;SAKK;IACL,6BAHa,MAAM,eACN,MAAM,QAIlB;IAED;;;;;;OAMG;IACH,cAJW,MAAM,YACN;QAAC,KAAK,CAAC,EAAE,MAAM,GAAC,eAAe,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,GAAC,eAAe,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAC,GACvF;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAC,CAIpF;IAED;;;;;;OAMG;IACH,yBAJW,MAAM,SACN,MAAM,GAAC,MAAM,GAAC,OAAO,GAAC,IAAI,YAC1B,OAAO,QAKjB;IAED;;;;;OAKG;IACH,mBAHW,KAAK,GAAC,MAAM,qBACZ,MAAM,QAKhB;IAED;;;;;OAKG;IACH,iBAHW,MAAM,GAAC,IAAI,iBACX,OAAO,QAKjB;IAED;;;;;;;OAOG;IACH,6BAJW,MAAM,GAAC,IAAI,QAOrB;IAED;;;;;MAKE;IACF,aAHW,MAAM,YACN;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,GAAC,OAAO,GAAC,OAAO,GAAC,MAAM,GAAC,MAAM,CAAA;KAAC,QAKpF;CACF;0BAvIY,OAAO,mCAAmC,EAAE,WAAW;kCACvD,OAAO,mCAAmC,EAAE,mBAAmB;qCAC/D,OAAO,mCAAmC,EAAE,sBAAsB"}

package/dist/types/loaders/api/register-api-types.d.ts

@@ -16,10 +16,6 @@ export type RegisterAPI = {
      * - Notice an error for the registered entity.
      */
     noticeError: (error: Error | string, customAttributes?: object) => void;
-    /**
-     * - Record a custom event for the registered entity.
-     */
-    register: (target: RegisterAPIConstructor) => RegisterAPI;
     /**
      * - Deregister the registered entity, which blocks its use and captures end of life timings.
      */
@@ -74,9 +70,9 @@ export type RegisterAPIConstructor = {
         [key: string]: any;
     } | undefined;
     /**
-     * - 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.
+     * - The parent target for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
      */
-    isolated?: boolean | undefined;
+    parent?: RegisterAPITarget | undefined;
     /**
      * - The parentId for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
      */
@@ -90,11 +86,11 @@ export type RegisterAPIMetadata = {
     /**
      * - The timing metrics for the registered entity.
      */
-    timings: RegisterAPITimings;
+    timings: Partial<RegisterAPITimings>;
     /**
      * - The options for the registered entity.
      */
-    target: RegisterAPITarget;
+    target: Partial<RegisterAPITarget>;
 };
 export type RegisterAPITarget = {
     /**
@@ -115,10 +111,6 @@ export type RegisterAPITarget = {
      * - The parentId for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
      */
     parentId?: string | undefined;
-    /**
-     * - 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.
-     */
-    isolated?: boolean | undefined;
 };
 export type RegisterAPITimings = {
     /**

package/dist/types/loaders/api/register-api-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register-api-types.d.ts","sourceRoot":"","sources":["../../../../src/loaders/api/register-api-types.js"],"names":[],"mappings":";;;;;;mBAOc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI;;;;SAC3C,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;KAAC,KAAK,IAAI;;;;iBACxH,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,KAAK,IAAI;;;;cAC1D,CAAC,MAAM,EAAE,sBAAsB,KAAK,WAAW;;;;gBAC/C,MAAM,IAAI;;;;uBACV,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI;;;;aAChD,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAC,KAAK,CAAC,EAAE,MAAM,GAAC,eAAe,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,GAAC,eAAe,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAC,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAC,CAAC;;;;2BACtM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI;;;;wBAC9B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI;;;;eAClF,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,YAAY,CAAC,EAAE,OAAO,KAAK,IAAI;;;;cACtD,mBAAmB;;;;;;QAKnB,MAAM;;;;UACN,MAAM;;;;;;;;;;;;;;;;;;;;sBAQN,MAAM;;;;aACN,kBAAkB;;;;YAClB,iBAAiB;;;;;;QAKjB,MAAM;;;;UACN,MAAM;;;;;;;;;;;;;;;;;;;;kBAQN,MAAM;;;;;;;;gBAEN,MAAM;;;;cACN,MAAM;;;;;;;;UAEN,MAAM"}
+{"version":3,"file":"register-api-types.d.ts","sourceRoot":"","sources":["../../../../src/loaders/api/register-api-types.js"],"names":[],"mappings":";;;;;;mBAOc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI;;;;SAC3C,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;KAAC,KAAK,IAAI;;;;iBACxH,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,KAAK,IAAI;;;;gBAC1D,MAAM,IAAI;;;;uBACV,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI;;;;aAChD,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAC,KAAK,CAAC,EAAE,MAAM,GAAC,eAAe,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,GAAC,eAAe,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAC,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAC,CAAC;;;;2BACtM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI;;;;wBAC9B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI;;;;eAClF,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,YAAY,CAAC,EAAE,OAAO,KAAK,IAAI;;;;cACtD,mBAAmB;;;;;;QAKnB,MAAM;;;;UACN,MAAM;;;;;;;;;;;;;;;;;;;;sBAQN,MAAM;;;;aACN,OAAO,CAAC,kBAAkB,CAAC;;;;YAC3B,OAAO,CAAC,iBAAiB,CAAC;;;;;;QAK1B,MAAM;;;;UACN,MAAM;;;;;;;;;;;;;;;;kBAON,MAAM;;;;;;;;gBAEN,MAAM;;;;cACN,MAAM;;;;;;;;UAEN,MAAM"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newrelic/browser-agent",
-  "version": "1.312.1-rc.0",
+  "version": "1.312.1-rc.2",
   "private": false,
   "author": "New Relic Browser Agent Team <browser-agent@newrelic.com>",
   "description": "New Relic Browser Agent",

package/src/common/config/init-types.js

@@ -12,8 +12,9 @@
  * @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} [api.register]
+ * @property {boolean} [api.register.enabled] - If true, the agent will allow registered children to be sent to the server.
+ * @property {boolean} [api.register.duplicate_data_to_container] - 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]

package/src/common/config/init.js

@@ -21,7 +21,7 @@ const InitModelFn = () => {
   const hiddenState = {
     feature_flags: [],
     experimental: {
-      allow_registered_children: false,
+      register: false,
       resources: false
     },
     mask_selector: '*',
@@ -49,9 +49,11 @@ const InitModelFn = () => {
   return {
     ajax: { deny_list: undefined, block_internal: true, enabled: true, autoStart: true },
     api: {
-      get allow_registered_children () { return hiddenState.feature_flags.includes(FEATURE_FLAGS.REGISTER) || hiddenState.experimental.allow_registered_children },
-      set allow_registered_children (val) { hiddenState.experimental.allow_registered_children = val },
-      duplicate_registered_data: false
+      register: {
+        get enabled () { return hiddenState.feature_flags.includes(FEATURE_FLAGS.REGISTER) || hiddenState.experimental.register },
+        set enabled (val) { hiddenState.experimental.register = val },
+        duplicate_data_to_container: false
+      }
     },
     browser_consent_mode: { enabled: false },
     distributed_tracing: {

package/src/common/util/v2.js

@@ -23,7 +23,7 @@ export const V2_TYPES = {
  * @returns {import("../../interfaces/registered-entity").RegisterAPIMetadataTarget[]}
  */
 export function getRegisteredTargetsFromId (id, agentRef) {
-  if (!id || !agentRef?.init.api.allow_registered_children) return []
+  if (!id || !agentRef?.init.api.register.enabled) return []
   const registeredEntities = agentRef.runtime.registeredEntities
   return registeredEntities?.filter(entity => String(entity.metadata.target.id) === String(id)).map(entity => entity.metadata.target) || []
 }
@@ -35,7 +35,7 @@ export function getRegisteredTargetsFromId (id, agentRef) {
  * @returns {import("../../interfaces/registered-entity").RegisterAPIMetadataTarget[]}
  */
 export function getRegisteredTargetsFromFilename (filename, agentRef) {
-  if (!filename || !agentRef?.init.api.allow_registered_children) return []
+  if (!filename || !agentRef?.init.api.register.enabled) return []
   const registeredEntities = agentRef.runtime.registeredEntities
   return registeredEntities?.filter(entity => entity.metadata.timings?.asset?.endsWith(filename)).map(entity => entity.metadata.target) || []
 }
@@ -83,7 +83,7 @@ export function getVersion2DuplicationAttributes (target, aggregateInstance) {
  * @returns {boolean} returns true if the event should be duplicated for the target, false otherwise
  */
 export function shouldDuplicate (target, aggregateInstance) {
-  return !!target && !!supportsV2(aggregateInstance) && aggregateInstance.agentRef.init.api.duplicate_registered_data
+  return !!target && !!supportsV2(aggregateInstance) && aggregateInstance.agentRef.init.api.register.duplicate_data_to_container
 }
 
 /**
@@ -92,7 +92,7 @@ export function shouldDuplicate (target, aggregateInstance) {
  * @returns {Array} An array of targets found from the stack trace. If no targets are found or allowed, returns an array with undefined.
  */
 export function findTargetsFromStackTrace (agentRef) {
-  if (!agentRef?.init.api.allow_registered_children) return [undefined]
+  if (!agentRef?.init.api.register.enabled) return [undefined]
 
   const targets = []
   try {

package/src/interfaces/registered-entity.js

@@ -18,18 +18,19 @@ import { warn } from '../common/util/console'
  * An interface for registering an external caller to report through the base agent to a different target than the base agent.
  */
 export class RegisteredEntity {
-  /** @type {RegisterAPIMetadata} */
-  metadata = {
-    target: {},
-    timings: {},
-    customAttributes: {}
-  }
-
   /**
    *
    * @param {RegisterAPIConstructor} opts The options for setting up the registered entity.
    */
   constructor (opts) {
+    // Initialize metadata as an own property to ensure it exists even when agent is missing
+    /** @type {RegisterAPIMetadata} */
+    this.metadata = {
+      target: /** @type {import('../loaders/api/register-api-types').RegisterAPITarget} */ ({}),
+      timings: /** @type {import('../loaders/api/register-api-types').RegisterAPITimings} */ ({}),
+      customAttributes: {}
+    }
+
     try {
       if (!window?.newrelic) return warn(51)
       Object.assign(this, window?.newrelic?.register(opts) || {})
@@ -49,19 +50,6 @@ export class RegisteredEntity {
     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) {
-    warn(35, 'register')
-  }
-
   /**
    * @experimental
    * IMPORTANT: This feature is being developed for use internally and is not in a public-facing production-ready state.

package/src/loaders/api/register-api-types.js

@@ -8,7 +8,6 @@
  * @property {(name: string, attributes?: object) => void} addPageAction - Add a page action for the registered entity.
  * @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|PerformanceMark, end?: number|PerformanceMark, customAttributes?: object}) => ({start: number, end: number, duration: number, customAttributes: object})} measure - Measures a task that is recorded as a BrowserPerformance event.
@@ -23,15 +22,15 @@
  * @property {string} 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 {{[key: string]: any}} [tags] - The tags for the registered entity as key-value pairs. This will be assigned to any synthesized entities. Tags are converted to source.* attributes (e.g., {environment: 'production'} becomes source.environment: 'production').
- * @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 {RegisterAPITarget} [parent] - The parent target for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
  * @property {string} [parentId] - The parentId for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
  */
 
 /**
  * @typedef {Object} RegisterAPIMetadata
  * @property {Object} customAttributes - The custom attributes for the registered entity.
- * @property {RegisterAPITimings} timings - The timing metrics for the registered entity.
- * @property {RegisterAPITarget} target - The options for the registered entity.
+ * @property {Partial<RegisterAPITimings>} timings - The timing metrics for the registered entity.
+ * @property {Partial<RegisterAPITarget>} target - The options for the registered entity.
  */
 
 /**
@@ -40,7 +39,6 @@
  * @property {string} name - The name returned for the registered entity.
  * @property {{[key: string]: any}} [tags] - The tags for the registered entity as key-value pairs.
  * @property {string} [parentId] - The parentId for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
- * @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.
  */
 
 /**

package/src/loaders/api/register.js

@@ -42,10 +42,9 @@ export function setupRegisterAPI (agent) {
  * Also conducts certain side-effects, such as harvesting a PageView event when triggered and gathering metadata for the registered entity.
  * @param {Object} agentRef the reference to the base agent instance
  * @param {import('./register-api-types').RegisterAPIConstructor} target
- * @param {import('./register-api-types').RegisterAPIConstructor} [parent]
  * @returns {RegisterAPI} the api object to be returned from the register api method
  */
-function register (agentRef, target, parent) {
+function register (agentRef, target) {
   warn(54, 'newrelic.register')
 
   target ||= {}
@@ -54,7 +53,7 @@ function register (agentRef, target, parent) {
   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
   if (typeof target.tags !== 'object' || target.tags === null || Array.isArray(target.tags)) target.tags = {}
-  target.parent = parent || {
+  target.parent ??= {
     get id () { return agentRef.runtime.appMetadata.agents[0].entityGuid }, // getter because this is asyncronously set
     type: V2_TYPES.BA
   }
@@ -82,19 +81,11 @@ function register (agentRef, target, parent) {
     }
   })
 
-  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 (!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 && !target.isolated)
-    if (sharedEntity) return sharedEntity
-  }
-
   /**
    * Block the API, and supply a warning function to display a message to end users
    * @param {Function} warning
@@ -109,7 +100,7 @@ function register (agentRef, target, parent) {
   }
 
   /** primary cases that can block the register API from working at init time */
-  if (!agentRef.init.api.allow_registered_children) block(single(() => warn(55)))
+  if (!agentRef.init.api.register.enabled) block(single(() => warn(55)))
   if (!hasValidValue(target.id) || !hasValidValue(target.name)) block(single(() => warn(48, target)))
 
   /** @type {RegisterAPI} */
@@ -123,7 +114,6 @@ function register (agentRef, target, parent) {
     log: (message, options = {}) => report(log, [message, { ...options, customAttributes: { ...attrs, ...(options.customAttributes || {}) } }, agentRef], target),
     measure: (name, options = {}) => report(measure, [name, { ...options, customAttributes: { ...attrs, ...(options.customAttributes || {}) } }, agentRef], target),
     noticeError: (error, attributes = {}) => report(noticeError, [error, { ...attrs, ...attributes }, agentRef], target),
-    register: (target = {}) => report(register, [agentRef, target], api.metadata.target),
     recordCustomEvent: (eventType, attributes = {}) => report(recordCustomEvent, [eventType, { ...attrs, ...attributes }, agentRef], target),
     setApplicationVersion: (value) => setLocalValue('application.version', value),
     setCustomAttribute: (key, value) => setLocalValue(key, value),
@@ -184,7 +174,7 @@ function register (agentRef, target, parent) {
 
   /**
      * The reporter method that will be used to report the data to the container agent's API method. If invalid, will log a warning and not execute.
-     * If the api.duplicate_registered_data configuration value is set to true, the data will be reported to BOTH the container and the external target
+     * If the api.register.duplicate_data_to_container configuration value is set to true, the data will be reported to BOTH the container and the external target
      * @param {*} methodToCall the container agent's API method to call
      * @param {*} args the arguments to supply to the container agent's API method
      * @param {string} target the target to report the data to. If undefined, will report to the container agent's target.