@newrelic/browser-agent 1.302.0-rc.9 → 1.303.0-rc.0

package/CHANGELOG.md

@@ -3,6 +3,26 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.303.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.302.0...v1.303.0) (2025-11-13)
+
+
+### Features
+
+* Add custom event support to register API ([#1606](https://github.com/newrelic/newrelic-browser-agent/issues/1606)) ([4137dcb](https://github.com/newrelic/newrelic-browser-agent/commit/4137dcbb339642219164d68695b84a8e48fa9b6f))
+* Add measure support to register API  ([#1623](https://github.com/newrelic/newrelic-browser-agent/issues/1623)) ([c2785f3](https://github.com/newrelic/newrelic-browser-agent/commit/c2785f39ca9ea1f5b87f3e2cf4fc7e462d6084e7))
+* Add consent API ([#1533](https://github.com/newrelic/newrelic-browser-agent/issues/1533)) ([4e8ad2a](https://github.com/newrelic/newrelic-browser-agent/commit/4e8ad2a6aea34bbaa39b6beb67c3947feee3c01d))
+* Additional validation to prepare agent for MFE registrations ([#1625](https://github.com/newrelic/newrelic-browser-agent/issues/1625)) ([aa8c02f](https://github.com/newrelic/newrelic-browser-agent/commit/aa8c02f966e9c7df5c4e83c911f9342b2183447f))
+* Allow consent API to be invoked without localStorage access ([#1627](https://github.com/newrelic/newrelic-browser-agent/issues/1627)) ([0690a65](https://github.com/newrelic/newrelic-browser-agent/commit/0690a65bcfa35eabe0e83b13c058398746e924b8))
+* Allow nested registrations ([#1616](https://github.com/newrelic/newrelic-browser-agent/issues/1616)) ([74a8d4a](https://github.com/newrelic/newrelic-browser-agent/commit/74a8d4ac745cff33eb15f9469775f85fd2641097))
+* Retry initial connect call ([#1605](https://github.com/newrelic/newrelic-browser-agent/issues/1605)) ([9770132](https://github.com/newrelic/newrelic-browser-agent/commit/9770132209b9fb1320b3f60eedfa932b0fcfa3a4))
+* SMs for browser connect response ([#1611](https://github.com/newrelic/newrelic-browser-agent/issues/1611)) ([29f5bdf](https://github.com/newrelic/newrelic-browser-agent/commit/29f5bdf6fa36020a87e5c0aa443d64ce55722c85))
+
+
+### Bug Fixes
+
+* memoize promise context propagation to avoid safari hangs ([#1597](https://github.com/newrelic/newrelic-browser-agent/issues/1597)) ([23cb559](https://github.com/newrelic/newrelic-browser-agent/commit/23cb55993add2eb7e7b14b0d77c6fa3bbb9abcf1))
+* Obfuscate custom attributes for logs added after PVE ([#1622](https://github.com/newrelic/newrelic-browser-agent/issues/1622)) ([f648e3f](https://github.com/newrelic/newrelic-browser-agent/commit/f648e3f1f843913d4c9be6534b0d1e3ba47eb260))
+
 ## [1.302.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.301.0...v1.302.0) (2025-10-24)
 
 

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

@@ -23,9 +23,18 @@ const ReadOnly = {
   version: _env.VERSION,
   originTime: _runtime.originTime
 };
+const hiddenState = {
+  consented: false
+};
 const RuntimeModel = {
   /** Agent-specific metadata found in the RUM call response. ex. entityGuid */
   appMetadata: {},
+  get consented() {
+    return this.session?.state?.consent || hiddenState.consented;
+  },
+  set consented(value) {
+    hiddenState.consented = value;
+  },
   customTransaction: undefined,
   denyList: undefined,
   disabled: 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.302.0-rc.9";
+const VERSION = exports.VERSION = "1.303.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.302.0-rc.9";
+const VERSION = exports.VERSION = "1.303.0-rc.0";
 
 /**
  * Exposes the build type of the agent

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

@@ -69,7 +69,7 @@ class Harvester {
       endpointVersion: aggregateInst.harvestEndpointVersion || 1
     };
     if (aggregateInst.blocked) return output;
-    if (this.agentRef.init?.browser_consent_mode?.enabled && !this.agentRef.runtime?.session?.state?.consent) return output;
+    if (this.agentRef.init?.browser_consent_mode?.enabled && !this.agentRef.runtime.consented) return output;
     const submitMethod = (0, _submitData.getSubmitMethod)(localOpts);
     if (!submitMethod) return output;
     const shouldRetryOnFail = !localOpts.isFinalHarvest && submitMethod === _submitData.xhr; // always retry all features harvests except for final

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

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.getVersion2Attributes = getVersion2Attributes;
+exports.hasValidValue = hasValidValue;
 exports.isValidMFETarget = isValidMFETarget;
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
@@ -17,9 +18,14 @@ exports.isValidMFETarget = isValidMFETarget;
 function isValidMFETarget(target = {}) {
   return !!(target.id && target.name);
 }
+function hasValidValue(val) {
+  return typeof val === 'string' && val.trim().length < 501 || typeof val === 'number';
+}
 
 /**
  * When given a valid target, returns an object with the MFE payload attributes.  Returns an empty object otherwise.
+ * @note Field names may change as the schema is finalized
+ *
  * @param {Object} [target] the registered target
  * @param {AggregateInstance} [aggregateInstance] the aggregate instance calling the method
  * @returns {{'mfe.id': *, 'mfe.name': String}|{}} returns an empty object if args are not supplied or the aggregate instance is not supporting version 2
@@ -35,11 +41,8 @@ function getVersion2Attributes(target, aggregateInstance) {
   }
   return {
     'mfe.id': target.id,
-    // these field names may change as the schema is finalized
     'mfe.name': target.name,
-    // these field names may change as the schema is finalized
-    eventSource: 'MicroFrontendBrowserAgent',
-    // these field names may change as the schema is finalized
-    'parent.id': containerAgentEntityGuid
+    eventSource: target.eventSource,
+    'parent.id': target.parent?.id || containerAgentEntityGuid
   };
 }

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

@@ -63,14 +63,6 @@ function setupAgentSession(agentRef) {
     agentRef.runtime.session.write({
       consent: accept === undefined ? true : accept
     });
-
-    // call sendRum if it wasn't called yet
-    agentRef.features.page_view_event.onAggregateImported.then(loaded => {
-      const pveAgg = agentRef.features.page_view_event.featAggregate;
-      if (loaded && !pveAgg.sentRum) {
-        pveAgg.sendRum();
-      }
-    });
   }, 'session', sharedEE);
   (0, _drain.drain)(agentRef.agentIdentifier, 'session');
   return agentRef.runtime.session;

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

@@ -14,11 +14,24 @@ var _console = require("../../common/util/console");
  */
 
 function setupConsentAPI(agent) {
-  (0, _sharedHandlers.setupAPI)(_constants.CONSENT, function (accept) {
-    if (accept !== undefined && typeof accept !== 'boolean') {
+  (0, _sharedHandlers.setupAPI)(_constants.CONSENT, function (accept = true) {
+    if (typeof accept !== 'boolean') {
       (0, _console.warn)(65, typeof accept);
       return;
     }
-    (0, _handle.handle)(_constants.prefix + _constants.CONSENT, [accept], undefined, 'session', agent.ee);
+    /** harvester, by way of "consented" getter, checks session state first, and falls back on runtime state if not available. Set both here */
+    (0, _handle.handle)(_constants.prefix + _constants.CONSENT, [accept], undefined, 'session', agent.ee); // sets session state (if available)
+    agent.runtime.consented = accept; // sets runtime state
+
+    /** if consent is granted, attempt to make a PageView event harvest if one has not already been made */
+    if (accept) {
+      const pveInst = agent.features.page_view_event;
+      pveInst.onAggregateImported.then(loaded => {
+        const pveAgg = pveInst.featAggregate;
+        if (loaded && !pveAgg.sentRum) {
+          pveAgg.sendRum();
+        }
+      });
+    }
   }, agent);
 }

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

@@ -13,8 +13,9 @@ 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 {(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 {(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.
  * @property {(name: string, value: string | number | boolean | null, persist?: boolean) => void} setCustomAttribute - Add a custom attribute to outgoing data for the registered entity.
  * @property {(value: string | null) => void} setUserId - Add an enduser.id attribute to all outgoing API data for the registered entity.
@@ -24,13 +25,15 @@ 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 {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 {Object} target - The options for the registered entity.
- * @property {string} target.licenseKey - The license key for the registered entity. If none was supplied, it will assume the license key from the main agent.
+ * @property {string} [target.licenseKey] - The license key for the registered entity. If none was supplied, it will assume the license key from the main agent.
  * @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.
  */
 var _default = exports.default = {};

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

@@ -3,7 +3,6 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.buildRegisterApi = buildRegisterApi;
 exports.setupRegisterAPI = setupRegisterAPI;
 var _handle = require("../../common/event-emitter/handle");
 var _console = require("../../common/util/console");
@@ -35,7 +34,7 @@ var _recordCustomEvent = require("./recordCustomEvent");
  */
 function setupRegisterAPI(agent) {
   (0, _sharedHandlers.setupAPI)(_constants2.REGISTER, function (target) {
-    return buildRegisterApi(agent, target);
+    return register(agent, target);
   }, agent);
 }
 
@@ -43,19 +42,18 @@ function setupRegisterAPI(agent) {
  * Builds the api object that will be returned from the register api method.
  * 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 {Object} handlers the shared handlers to be used by both the base agent's API and the external target's API
- * @param {Object} target the target information to be used by the external target's API to send data to the correct location
- * @param {string} [target.licenseKey] the license key of the target to report data to
- * @param {string} target.id the entity ID of the target to report data to
- * @param {string} target.name the entity name of the target to report data to
+ * @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 buildRegisterApi(agentRef, target) {
+function register(agentRef, target, parent) {
   const attrs = {};
   (0, _console.warn)(54, 'newrelic.register');
   target ||= {};
+  target.eventSource = 'MicroFrontendBrowserAgent';
   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 || {};
 
   /** @type {Function} a function that is set and reports when APIs are triggered -- warns the customer of the invalid state  */
   let invalidApiResponse = () => {};
@@ -88,6 +86,9 @@ function buildRegisterApi(agentRef, target) {
   /** 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)));
+  }
 
   /** @type {RegisterAPI} */
   const api = {
@@ -113,6 +114,7 @@ function buildRegisterApi(agentRef, target) {
       ...attrs,
       ...attributes
     }, agentRef], target),
+    register: (target = {}) => report(register, [agentRef, target], api.metadata.target),
     recordCustomEvent: (eventType, attributes = {}) => report(_recordCustomEvent.recordCustomEvent, [eventType, {
       ...attrs,
       ...attributes
@@ -164,8 +166,8 @@ function buildRegisterApi(agentRef, target) {
     const timestamp = (0, _now.now)();
     (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ["API/register/".concat(methodToCall.name, "/called")], undefined, _features.FEATURE_NAMES.metrics, agentRef.ee);
     try {
-      const shouldDuplicate = agentRef.init.api.duplicate_registered_data;
-      if (shouldDuplicate === true || Array.isArray(shouldDuplicate)) {
+      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);
       }

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

@@ -17,9 +17,18 @@ const ReadOnly = {
   version: VERSION,
   originTime
 };
+const hiddenState = {
+  consented: false
+};
 const RuntimeModel = {
   /** Agent-specific metadata found in the RUM call response. ex. entityGuid */
   appMetadata: {},
+  get consented() {
+    return this.session?.state?.consent || hiddenState.consented;
+  },
+  set consented(value) {
+    hiddenState.consented = value;
+  },
   customTransaction: undefined,
   denyList: undefined,
   disabled: false,

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

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

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

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

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

@@ -61,7 +61,7 @@ export class Harvester {
       endpointVersion: aggregateInst.harvestEndpointVersion || 1
     };
     if (aggregateInst.blocked) return output;
-    if (this.agentRef.init?.browser_consent_mode?.enabled && !this.agentRef.runtime?.session?.state?.consent) return output;
+    if (this.agentRef.init?.browser_consent_mode?.enabled && !this.agentRef.runtime.consented) return output;
     const submitMethod = getSubmitMethod(localOpts);
     if (!submitMethod) return output;
     const shouldRetryOnFail = !localOpts.isFinalHarvest && submitMethod === xhrMethod; // always retry all features harvests except for final

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

@@ -10,9 +10,14 @@
 export function isValidMFETarget(target = {}) {
   return !!(target.id && target.name);
 }
+export function hasValidValue(val) {
+  return typeof val === 'string' && val.trim().length < 501 || typeof val === 'number';
+}
 
 /**
  * When given a valid target, returns an object with the MFE payload attributes.  Returns an empty object otherwise.
+ * @note Field names may change as the schema is finalized
+ *
  * @param {Object} [target] the registered target
  * @param {AggregateInstance} [aggregateInstance] the aggregate instance calling the method
  * @returns {{'mfe.id': *, 'mfe.name': String}|{}} returns an empty object if args are not supplied or the aggregate instance is not supporting version 2
@@ -28,11 +33,8 @@ export function getVersion2Attributes(target, aggregateInstance) {
   }
   return {
     'mfe.id': target.id,
-    // these field names may change as the schema is finalized
     'mfe.name': target.name,
-    // these field names may change as the schema is finalized
-    eventSource: 'MicroFrontendBrowserAgent',
-    // these field names may change as the schema is finalized
-    'parent.id': containerAgentEntityGuid
+    eventSource: target.eventSource,
+    'parent.id': target.parent?.id || containerAgentEntityGuid
   };
 }

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

@@ -56,14 +56,6 @@ export function setupAgentSession(agentRef) {
     agentRef.runtime.session.write({
       consent: accept === undefined ? true : accept
     });
-
-    // call sendRum if it wasn't called yet
-    agentRef.features.page_view_event.onAggregateImported.then(loaded => {
-      const pveAgg = agentRef.features.page_view_event.featAggregate;
-      if (loaded && !pveAgg.sentRum) {
-        pveAgg.sendRum();
-      }
-    });
   }, 'session', sharedEE);
   drain(agentRef.agentIdentifier, 'session');
   return agentRef.runtime.session;

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

@@ -7,11 +7,24 @@ import { setupAPI } from './sharedHandlers';
 import { handle } from '../../common/event-emitter/handle';
 import { warn } from '../../common/util/console';
 export function setupConsentAPI(agent) {
-  setupAPI(CONSENT, function (accept) {
-    if (accept !== undefined && typeof accept !== 'boolean') {
+  setupAPI(CONSENT, function (accept = true) {
+    if (typeof accept !== 'boolean') {
       warn(65, typeof accept);
       return;
     }
-    handle(prefix + CONSENT, [accept], undefined, 'session', agent.ee);
+    /** harvester, by way of "consented" getter, checks session state first, and falls back on runtime state if not available. Set both here */
+    handle(prefix + CONSENT, [accept], undefined, 'session', agent.ee); // sets session state (if available)
+    agent.runtime.consented = accept; // sets runtime state
+
+    /** if consent is granted, attempt to make a PageView event harvest if one has not already been made */
+    if (accept) {
+      const pveInst = agent.features.page_view_event;
+      pveInst.onAggregateImported.then(loaded => {
+        const pveAgg = pveInst.featAggregate;
+        if (loaded && !pveAgg.sentRum) {
+          pveAgg.sendRum();
+        }
+      });
+    }
   }, agent);
 }

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

@@ -8,8 +8,9 @@
  * @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 {(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 {(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.
  * @property {(name: string, value: string | number | boolean | null, persist?: boolean) => void} setCustomAttribute - Add a custom attribute to outgoing data for the registered entity.
  * @property {(value: string | null) => void} setUserId - Add an enduser.id attribute to all outgoing API data for the registered entity.
@@ -20,15 +21,17 @@
  * @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 {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 {Object} target - The options for the registered entity.
- * @property {string} target.licenseKey - The license key for the registered entity. If none was supplied, it will assume the license key from the main agent.
+ * @property {string} [target.licenseKey] - The license key for the registered entity. If none was supplied, it will assume the license key from the main agent.
  * @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.
  */
 
 export default {};

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

@@ -4,7 +4,7 @@
  */
 import { handle } from '../../common/event-emitter/handle';
 import { warn } from '../../common/util/console';
-import { isValidMFETarget } from '../../common/util/mfe';
+import { hasValidValue, isValidMFETarget } from '../../common/util/mfe';
 import { FEATURE_NAMES } from '../features/features';
 import { now } from '../../common/timing/now';
 import { SUPPORTABILITY_METRIC_CHANNEL } from '../../features/metrics/constants';
@@ -28,7 +28,7 @@ import { recordCustomEvent } from './recordCustomEvent';
  */
 export function setupRegisterAPI(agent) {
   setupAPI(REGISTER, function (target) {
-    return buildRegisterApi(agent, target);
+    return register(agent, target);
   }, agent);
 }
 
@@ -36,19 +36,18 @@ export function setupRegisterAPI(agent) {
  * Builds the api object that will be returned from the register api method.
  * 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 {Object} handlers the shared handlers to be used by both the base agent's API and the external target's API
- * @param {Object} target the target information to be used by the external target's API to send data to the correct location
- * @param {string} [target.licenseKey] the license key of the target to report data to
- * @param {string} target.id the entity ID of the target to report data to
- * @param {string} target.name the entity name of the target to report data to
+ * @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
  */
-export function buildRegisterApi(agentRef, target) {
+function register(agentRef, target, parent) {
   const attrs = {};
   warn(54, 'newrelic.register');
   target ||= {};
+  target.eventSource = 'MicroFrontendBrowserAgent';
   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 || {};
 
   /** @type {Function} a function that is set and reports when APIs are triggered -- warns the customer of the invalid state  */
   let invalidApiResponse = () => {};
@@ -81,6 +80,9 @@ export function buildRegisterApi(agentRef, target) {
   /** 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 (!isValidMFETarget(target)) block(single(() => warn(48, target)));
+  if (!hasValidValue(target.id) || !hasValidValue(target.name)) {
+    block(single(() => warn(48, target)));
+  }
 
   /** @type {RegisterAPI} */
   const api = {
@@ -106,6 +108,7 @@ export function buildRegisterApi(agentRef, target) {
       ...attrs,
       ...attributes
     }, agentRef], target),
+    register: (target = {}) => report(register, [agentRef, target], api.metadata.target),
     recordCustomEvent: (eventType, attributes = {}) => report(recordCustomEvent, [eventType, {
       ...attrs,
       ...attributes
@@ -157,8 +160,8 @@ export function buildRegisterApi(agentRef, target) {
     const timestamp = now();
     handle(SUPPORTABILITY_METRIC_CHANNEL, ["API/register/".concat(methodToCall.name, "/called")], undefined, FEATURE_NAMES.metrics, agentRef.ee);
     try {
-      const shouldDuplicate = agentRef.init.api.duplicate_registered_data;
-      if (shouldDuplicate === true || Array.isArray(shouldDuplicate)) {
+      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);
       }

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

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/common/config/runtime.js"],"names":[],"mappings":"AA4CO,gDAON"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/common/config/runtime.js"],"names":[],"mappings":"AAsDO,gDAON"}

package/dist/types/common/util/mfe.d.ts

@@ -7,8 +7,11 @@
  * @returns {boolean}
  */
 export function isValidMFETarget(target?: Object): boolean;
+export function hasValidValue(val: any): boolean;
 /**
  * When given a valid target, returns an object with the MFE payload attributes.  Returns an empty object otherwise.
+ * @note Field names may change as the schema is finalized
+ *
  * @param {Object} [target] the registered target
  * @param {AggregateInstance} [aggregateInstance] the aggregate instance calling the method
  * @returns {{'mfe.id': *, 'mfe.name': String}|{}} returns an empty object if args are not supplied or the aggregate instance is not supporting version 2

package/dist/types/common/util/mfe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mfe.d.ts","sourceRoot":"","sources":["../../../../src/common/util/mfe.js"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,0CAHW,MAAM,GACJ,OAAO,CAInB;AAED;;;;;GAKG;AACH,+CAJW,MAAM,sBACN,iBAAiB,GACf;IAAC,QAAQ,EAAE,GAAC,CAAC;IAAC,UAAU,SAAQ;CAAC,GAAC,EAAE,CAiBhD"}
+{"version":3,"file":"mfe.d.ts","sourceRoot":"","sources":["../../../../src/common/util/mfe.js"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,0CAHW,MAAM,GACJ,OAAO,CAInB;AAED,iDAEC;AAED;;;;;;;GAOG;AACH,+CAJW,MAAM,sBACN,iBAAiB,GACf;IAAC,QAAQ,EAAE,GAAC,CAAC;IAAC,UAAU,SAAQ;CAAC,GAAC,EAAE,CAiBhD"}

package/dist/types/features/utils/agent-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-session.d.ts","sourceRoot":"","sources":["../../../../src/features/utils/agent-session.js"],"names":[],"mappings":"AAaA,sDA4DC"}
+{"version":3,"file":"agent-session.d.ts","sourceRoot":"","sources":["../../../../src/features/utils/agent-session.js"],"names":[],"mappings":"AAaA,sDAoDC"}

package/dist/types/loaders/api/consent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../../../../src/loaders/api/consent.js"],"names":[],"mappings":"AASA,kDAQC"}
+{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../../../../src/loaders/api/consent.js"],"names":[],"mappings":"AASA,kDAqBC"}

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

@@ -16,19 +16,28 @@ 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;
     /**
      * - Record a custom event for the registered entity.
      */
     recordCustomEvent: (eventType: string, attributes?: Object) => void;
     /**
-     * {start: number, end: number, duration: number, customAttributes: object}}} measure - Measures a task that is recorded as a BrowserPerformance event.
+     * - Measures a task that is recorded as a BrowserPerformance event.
      */
-    "": (eventType: string, options?: {
+    measure: (eventType: string, options?: {
         start: number;
         end: number;
         duration: number;
         customAttributes: object;
-    }) => {};
+    }) => ({
+        start: number;
+        end: number;
+        duration: number;
+        customAttributes: object;
+    });
     /**
      * - Add an application.version attribute to all outgoing data for the registered entity.
      */
@@ -55,6 +64,10 @@ export type RegisterAPIConstructor = {
      * - The readable name for the registered entity. This will be assigned to any synthesized entities.
      */
     name: string;
+    /**
+     * - The parentId for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
+     */
+    parentId?: string | undefined;
 };
 export type RegisterAPIMetadata = {
     /**
@@ -65,9 +78,10 @@ export type RegisterAPIMetadata = {
      * - The options for the registered entity.
      */
     target: {
-        licenseKey: string;
+        licenseKey?: string | undefined;
         id: string;
         name: string;
+        parentId?: string | undefined;
     };
 };
 //# sourceMappingURL=register-api-types.d.ts.map

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;;;;uBAC1D,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI;;;;QAChD,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAC,KAAK,EAAC;;;;2BAC5G,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,KAAK,IAAI;;;;cAC9B,mBAAmB;;;;;;QAKnB,MAAM,GAAC,MAAM;;;;UACb,MAAM;;;;;;sBAKN,MAAM;;;;YAEjB;QAA0B,UAAU,EAAzB,MAAM;QACS,EAAE,EAAjB,MAAM;QACS,IAAI,EAAnB,MAAM;KACnB"}
+{"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;;;;uBAC/C,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI;;;;aAChD,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,gBAAgB,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;;;;2BACrL,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,KAAK,IAAI;;;;cAC9B,mBAAmB;;;;;;QAKnB,MAAM,GAAC,MAAM;;;;UACb,MAAM;;;;;;;;;;sBAMN,MAAM;;;;YAEjB;QAA2B,UAAU;QACX,EAAE,EAAjB,MAAM;QACS,IAAI,EAAnB,MAAM;QACU,QAAQ;KACrC"}

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

@@ -7,21 +7,5 @@
  * It is not recommended for use in production environments and will not receive support for issues.
  */
 export function setupRegisterAPI(agent: any): void;
-/**
- * Builds the api object that will be returned from the register api method.
- * 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 {Object} handlers the shared handlers to be used by both the base agent's API and the external target's API
- * @param {Object} target the target information to be used by the external target's API to send data to the correct location
- * @param {string} [target.licenseKey] the license key of the target to report data to
- * @param {string} target.id the entity ID of the target to report data to
- * @param {string} target.name the entity name of the target to report data to
- * @returns {RegisterAPI} the api object to be returned from the register api method
- */
-export function buildRegisterApi(agentRef: Object, target: {
-    licenseKey?: string | undefined;
-    id: string;
-    name: string;
-}): RegisterAPI;
 export type RegisterAPI = import("./register-api-types").RegisterAPI;
 //# sourceMappingURL=register.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../../src/loaders/api/register.js"],"names":[],"mappings":"AAmBA;;GAEG;AAEH;;;;GAIG;AACH,mDAIC;AAED;;;;;;;;;;GAUG;AACH,2CARW,MAAM,UAGd;IAAwB,UAAU;IACX,EAAE,EAAjB,MAAM;IACS,IAAI,EAAnB,MAAM;CACd,GAAU,WAAW,CAqGvB;0BA5HY,OAAO,sBAAsB,EAAE,WAAW"}
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../../src/loaders/api/register.js"],"names":[],"mappings":"AAmBA;;GAEG;AAEH;;;;GAIG;AACH,mDAIC;0BAZY,OAAO,sBAAsB,EAAE,WAAW"}

package/package.json

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

package/src/common/config/runtime.js

@@ -19,9 +19,19 @@ const ReadOnly = {
   originTime
 }
 
+const hiddenState = {
+  consented: false
+}
+
 const RuntimeModel = {
   /** Agent-specific metadata found in the RUM call response. ex. entityGuid */
   appMetadata: {},
+  get consented () {
+    return this.session?.state?.consent || hiddenState.consented
+  },
+  set consented (value) {
+    hiddenState.consented = value
+  },
   customTransaction: undefined,
   denyList: undefined,
   disabled: false,

package/src/common/harvest/harvester.js

@@ -59,7 +59,7 @@ export class Harvester {
   triggerHarvestFor (aggregateInst, localOpts = {}) {
     const output = { ranSend: false, payload: undefined, endpointVersion: aggregateInst.harvestEndpointVersion || 1 }
     if (aggregateInst.blocked) return output
-    if (this.agentRef.init?.browser_consent_mode?.enabled && !this.agentRef.runtime?.session?.state?.consent) return output
+    if (this.agentRef.init?.browser_consent_mode?.enabled && !this.agentRef.runtime.consented) return output
 
     const submitMethod = getSubmitMethod(localOpts)
     if (!submitMethod) return output

package/src/common/util/mfe.js

@@ -11,8 +11,14 @@ export function isValidMFETarget (target = {}) {
   return !!(target.id && target.name)
 }
 
+export function hasValidValue (val) {
+  return (typeof val === 'string' && val.trim().length < 501) || (typeof val === 'number')
+}
+
 /**
  * When given a valid target, returns an object with the MFE payload attributes.  Returns an empty object otherwise.
+ * @note Field names may change as the schema is finalized
+ *
  * @param {Object} [target] the registered target
  * @param {AggregateInstance} [aggregateInstance] the aggregate instance calling the method
  * @returns {{'mfe.id': *, 'mfe.name': String}|{}} returns an empty object if args are not supplied or the aggregate instance is not supporting version 2
@@ -27,9 +33,9 @@ export function getVersion2Attributes (target, aggregateInstance) {
     }
   }
   return {
-    'mfe.id': target.id, // these field names may change as the schema is finalized
-    'mfe.name': target.name, // these field names may change as the schema is finalized
-    eventSource: 'MicroFrontendBrowserAgent', // these field names may change as the schema is finalized
-    'parent.id': containerAgentEntityGuid
+    'mfe.id': target.id,
+    'mfe.name': target.name,
+    eventSource: target.eventSource,
+    'parent.id': target.parent?.id || containerAgentEntityGuid
   }
 }

package/src/features/utils/agent-session.js

@@ -58,14 +58,6 @@ export function setupAgentSession (agentRef) {
 
   registerHandler('api-consent', (accept) => {
     agentRef.runtime.session.write({ consent: accept === undefined ? true : accept })
-
-    // call sendRum if it wasn't called yet
-    agentRef.features.page_view_event.onAggregateImported.then((loaded) => {
-      const pveAgg = agentRef.features.page_view_event.featAggregate
-      if (loaded && !pveAgg.sentRum) {
-        pveAgg.sendRum()
-      }
-    })
   }, 'session', sharedEE)
 
   drain(agentRef.agentIdentifier, 'session')

package/src/loaders/api/consent.js

@@ -8,11 +8,24 @@ import { handle } from '../../common/event-emitter/handle'
 import { warn } from '../../common/util/console'
 
 export function setupConsentAPI (agent) {
-  setupAPI(CONSENT, function (accept) {
-    if (accept !== undefined && typeof accept !== 'boolean') {
+  setupAPI(CONSENT, function (accept = true) {
+    if (typeof accept !== 'boolean') {
       warn(65, typeof accept)
       return
     }
-    handle(prefix + CONSENT, [accept], undefined, 'session', agent.ee)
+    /** harvester, by way of "consented" getter, checks session state first, and falls back on runtime state if not available. Set both here */
+    handle(prefix + CONSENT, [accept], undefined, 'session', agent.ee) // sets session state (if available)
+    agent.runtime.consented = accept // sets runtime state
+
+    /** if consent is granted, attempt to make a PageView event harvest if one has not already been made */
+    if (accept) {
+      const pveInst = agent.features.page_view_event
+      pveInst.onAggregateImported.then((loaded) => {
+        const pveAgg = pveInst.featAggregate
+        if (loaded && !pveAgg.sentRum) {
+          pveAgg.sendRum()
+        }
+      })
+    }
   }, agent)
 }

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

@@ -8,8 +8,9 @@
  * @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 {(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 {(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.
  * @property {(name: string, value: string | number | boolean | null, persist?: boolean) => void} setCustomAttribute - Add a custom attribute to outgoing data for the registered entity.
  * @property {(value: string | null) => void} setUserId - Add an enduser.id attribute to all outgoing API data for the registered entity.
@@ -20,15 +21,17 @@
  * @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 {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 {Object} target - The options for the registered entity.
- * @property {string} target.licenseKey - The license key for the registered entity. If none was supplied, it will assume the license key from the main agent.
+ * @property {string} [target.licenseKey] - The license key for the registered entity. If none was supplied, it will assume the license key from the main agent.
  * @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.
  */
 
 export default {}

package/src/loaders/api/register.js

@@ -4,7 +4,7 @@
  */
 import { handle } from '../../common/event-emitter/handle'
 import { warn } from '../../common/util/console'
-import { isValidMFETarget } from '../../common/util/mfe'
+import { hasValidValue, isValidMFETarget } from '../../common/util/mfe'
 import { FEATURE_NAMES } from '../features/features'
 import { now } from '../../common/timing/now'
 import { SUPPORTABILITY_METRIC_CHANNEL } from '../../features/metrics/constants'
@@ -28,7 +28,7 @@ import { recordCustomEvent } from './recordCustomEvent'
  */
 export function setupRegisterAPI (agent) {
   setupAPI(REGISTER, function (target) {
-    return buildRegisterApi(agent, target)
+    return register(agent, target)
   }, agent)
 }
 
@@ -36,20 +36,19 @@ export function setupRegisterAPI (agent) {
  * Builds the api object that will be returned from the register api method.
  * 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 {Object} handlers the shared handlers to be used by both the base agent's API and the external target's API
- * @param {Object} target the target information to be used by the external target's API to send data to the correct location
- * @param {string} [target.licenseKey] the license key of the target to report data to
- * @param {string} target.id the entity ID of the target to report data to
- * @param {string} target.name the entity name of the target to report data to
+ * @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
  */
-export function buildRegisterApi (agentRef, target) {
+function register (agentRef, target, parent) {
   const attrs = {}
   warn(54, 'newrelic.register')
 
   target ||= {}
+  target.eventSource = 'MicroFrontendBrowserAgent'
   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 || {}
 
   /** @type {Function} a function that is set and reports when APIs are triggered -- warns the customer of the invalid state  */
   let invalidApiResponse = () => {}
@@ -75,6 +74,9 @@ export function buildRegisterApi (agentRef, target) {
   /** 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 (!isValidMFETarget(target)) block(single(() => warn(48, target)))
+  if (!hasValidValue(target.id) || !hasValidValue(target.name)) {
+    block(single(() => warn(48, target)))
+  }
 
   /** @type {RegisterAPI} */
   const api = {
@@ -82,6 +84,7 @@ export function buildRegisterApi (agentRef, target) {
     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),
@@ -130,8 +133,8 @@ export function buildRegisterApi (agentRef, target) {
     const timestamp = now()
     handle(SUPPORTABILITY_METRIC_CHANNEL, [`API/register/${methodToCall.name}/called`], undefined, FEATURE_NAMES.metrics, agentRef.ee)
     try {
-      const shouldDuplicate = agentRef.init.api.duplicate_registered_data
-      if (shouldDuplicate === true || Array.isArray(shouldDuplicate)) {
+      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)
       }