@newrelic/browser-agent 1.302.0 → 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/init-types.js

@@ -89,6 +89,8 @@ exports.default = void 0;
  * @property {boolean} [spa.enabled] - Turn on/off the single page application feature (on by default). NOTE: the SPA feature is deprecated and under removal procedure.
  * @property {boolean} [spa.autoStart] - If true, the agent will automatically start the single page application feature. Otherwise, it will be in a deferred state until the `start` API method is called.
  * @property {boolean} [ssl] - If explicitly false, the agent will use HTTP instead of HTTPS. This setting should NOT be used.
+ * @property {Object} [browser_consent_mode]
+ * @property {boolean} [browser_consent_mode.enabled] - If true, the agent will use consent mode for whether to allow or disallow data harvest.
  * @property {Object} [user_actions]
  * @property {boolean} [user_actions.enabled] - Must be true to allow UserAction events to be captured.
  * @property {Array<string>} [user_actions.elementAttributes] - List of HTML Element properties to be captured with UserAction events' target elements. This may help to identify the source element being interacted with in the UI.

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

@@ -68,6 +68,9 @@ const InitModelFn = () => {
       },
       duplicate_registered_data: false
     },
+    browser_consent_mode: {
+      enabled: false
+    },
     distributed_tracing: {
       enabled: undefined,
       exclude_newrelic_header: undefined,

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

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

@@ -25,8 +25,10 @@ var _globalEvent = require("../dispatch/global-event");
  * SPDX-License-Identifier: Apache-2.0
  */
 
-const RETRY_FAILED = 'Harvester/Retry/Failed/';
-const RETRY_SUCCEEDED = 'Harvester/Retry/Succeeded/';
+const RETRY = 'Harvester/Retry/';
+const RETRY_ATTEMPTED = RETRY + 'Attempted/';
+const RETRY_FAILED = RETRY + 'Failed/';
+const RETRY_SUCCEEDED = RETRY + 'Succeeded/';
 class Harvester {
   #started = false;
   initializedAggregates = [];
@@ -67,11 +69,11 @@ class Harvester {
       endpointVersion: aggregateInst.harvestEndpointVersion || 1
     };
     if (aggregateInst.blocked) 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
-    output.payload = !localOpts.directSend ? aggregateInst.makeHarvestPayload(shouldRetryOnFail, localOpts) : localOpts.directSend?.payload; // features like PVE can define the payload directly, bypassing the makeHarvestPayload logic
-
+    output.payload = aggregateInst.makeHarvestPayload(shouldRetryOnFail, localOpts);
     if (!output.payload) return output;
     send(this.agentRef, {
       endpoint: _features.FEATURE_TO_ENDPOINT[aggregateInst.featureName],
@@ -93,7 +95,9 @@ class Harvester {
     function cbFinished(result) {
       if (aggregateInst.harvestOpts.prevAttemptCode) {
         // this means we just retried a harvest that last failed
-        (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, [(result.retry ? RETRY_FAILED : RETRY_SUCCEEDED) + aggregateInst.harvestOpts.prevAttemptCode], undefined, _features.FEATURE_NAMES.metrics, aggregateInst.ee);
+        const reportSM = message => (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, [message], undefined, _features.FEATURE_NAMES.metrics, aggregateInst.ee);
+        reportSM(RETRY_ATTEMPTED + aggregateInst.featureName);
+        reportSM((result.retry ? RETRY_FAILED : RETRY_SUCCEEDED) + aggregateInst.harvestOpts.prevAttemptCode);
         delete aggregateInst.harvestOpts.prevAttemptCode; // always reset last observation so we don't falsely report again next harvest
         // In case this re-attempt failed again, that'll be handled (re-marked again) next.
       }
@@ -183,9 +187,9 @@ function send(agentRef, {
           status: this.status,
           retry: shouldRetry(this.status),
           fullUrl,
-          xhr: this
+          xhr: this,
+          responseText: this.responseText
         };
-        if (localOpts.needResponse) cbResult.responseText = this.responseText;
         cbFinished(cbResult);
 
         /** temporary audit of consistency of harvest metadata flags */
@@ -199,9 +203,9 @@ function send(agentRef, {
           status,
           retry: shouldRetry(status),
           fullUrl,
-          fetchResponse: response
+          fetchResponse: response,
+          responseText: await response.text()
         };
-        if (localOpts.needResponse) cbResult.responseText = await response.text();
         cbFinished(cbResult);
         /** temporary audit of consistency of harvest metadata flags */
         if (!shouldRetry(status)) trackHarvestMetadata();

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

@@ -30,7 +30,6 @@ exports.unused = void 0;
  * @property {HarvestEndpointIdentifier} endpoint The endpoint to use (jserrors, events, resources etc.)
  * @property {HarvestPayload} payload Object representing payload.
  * @property {object} localOpts Additional options for sending data
- * @property {boolean} localOpts.needResponse Specify whether the caller expects a response data.
  * @property {boolean} localOpts.isFinalHarvest Specify whether the call is a final harvest during page unload.
  * @property {boolean} localOpts.sendEmptyBody Specify whether the call should be made even if the body is empty. Useful for rum calls.
  * @property {boolean} localOpts.forceNoRetry Don't save the buffered data in the case of a need to retry the transmission.

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

@@ -39,7 +39,8 @@ const model = {
   serverTimeDiff: null,
   // set by TimeKeeper; "undefined" value will not be stringified and stored but "null" will
   custom: {},
-  numOfResets: 0
+  numOfResets: 0,
+  consent: false // set by consent() API call
 };
 class SessionEntity {
   /**
@@ -90,7 +91,8 @@ class SessionEntity {
   }) {
     /** Ensure that certain properties are preserved across a reset if already set */
     const persistentAttributes = {
-      serverTimeDiff: this.state.serverTimeDiff || model.serverTimeDiff
+      serverTimeDiff: this.state.serverTimeDiff || model.serverTimeDiff,
+      consent: this.state.consent || model.consent
     };
     this.state = {};
     this.sync({

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/common/wrap/wrap-promise.js

@@ -136,12 +136,17 @@ function wrapPromise(sharedEE) {
     });
     promiseEE.on('propagate', function (val, overwrite, trigger) {
       if (!this.getCtx || overwrite) {
-        this.getCtx = function () {
-          // eslint-disable-next-line
-          if (val instanceof Promise) {
-            var store = promiseEE.context(val);
+        const selfStore = this;
+        const parentStore = val instanceof Promise ? promiseEE.context(val) : null;
+        let cachedCtx;
+        this.getCtx = function getCtx() {
+          if (cachedCtx) return cachedCtx;
+          if (parentStore && parentStore !== selfStore) {
+            cachedCtx = typeof parentStore.getCtx === 'function' ? parentStore.getCtx() : parentStore;
+          } else {
+            cachedCtx = selfStore;
           }
-          return store && store.getCtx ? store.getCtx() : this;
+          return cachedCtx;
         };
       }
     });

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

@@ -35,13 +35,13 @@ class Aggregate extends _aggregateBase.AggregateBase {
         return;
       }
       this.#trackSupportabilityMetrics();
-      (0, _registerHandler.registerHandler)('api-recordCustomEvent', (timestamp, eventType, attributes) => {
+      (0, _registerHandler.registerHandler)('api-recordCustomEvent', (timestamp, eventType, attributes, target) => {
         if (_constants.RESERVED_EVENT_TYPES.includes(eventType)) return (0, _console.warn)(46);
         this.addEvent({
           eventType,
           timestamp: this.toEpoch(timestamp),
           ...attributes
-        });
+        }, target);
       }, this.featureName, this.ee);
       if (agentRef.init.page_action.enabled) {
         (0, _registerHandler.registerHandler)('api-addPageAction', (timestamp, name, attributes, target) => {
@@ -238,7 +238,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
           }
         }, this.featureName, this.ee);
       }
-      (0, _registerHandler.registerHandler)('api-measure', (args, n) => {
+      (0, _registerHandler.registerHandler)('api-measure', (args, n, target) => {
         const {
           start,
           duration,
@@ -252,7 +252,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
           entryDuration: duration,
           entryType: 'measure'
         };
-        this.addEvent(event);
+        this.addEvent(event, target);
       }, this.featureName, this.ee);
       this.drain();
     });

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

@@ -104,8 +104,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
       common: {
         /** Attributes in the `common` section are added to `all` logs generated in the payload */
         attributes: {
-          ...this.agentRef.info.jsAttributes,
-          // user-provided custom attributes
+          ...(0, _traverse.applyFnToProps)(this.agentRef.info.jsAttributes, this.obfuscator.obfuscateString.bind(this.obfuscator), 'string'),
           ...(this.harvestEndpointVersion === 1 && {
             'entity.guid': this.agentRef.runtime.appMetadata.agents[0].entityGuid,
             appId: this.agentRef.info.applicationID

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

@@ -19,6 +19,9 @@ var _timeToFirstByte = require("../../../common/vitals/time-to-first-byte");
 var _now = require("../../../common/timing/now");
 var _timeKeeper = require("../../../common/timing/time-keeper");
 var _traverse = require("../../../common/util/traverse");
+var _harvester = require("../../../common/harvest/harvester");
+var _features = require("../../../loaders/features/features");
+var _submitData = require("../../../common/util/submit-data");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
@@ -29,10 +32,12 @@ class Aggregate extends _aggregateBase.AggregateBase {
   static featureName = CONSTANTS.FEATURE_NAME;
   constructor(agentRef) {
     super(agentRef, CONSTANTS.FEATURE_NAME);
+    this.sentRum = false; // flag to facilitate calling sendRum() once externally (by the consent API in agent-session.js)
+
     this.timeToFirstByte = 0;
     this.firstByteToWindowLoad = 0; // our "frontend" duration
     this.firstByteToDomContent = 0; // our "dom processing" duration
-
+    this.retries = 0;
     if (!(0, _info.isValid)(agentRef.info)) {
       this.ee.abort();
       return (0, _console.warn)(43);
@@ -60,12 +65,8 @@ class Aggregate extends _aggregateBase.AggregateBase {
    *
    * @param {Function} cb A function to run once the RUM call has finished - Defaults to activateFeatures
    * @param {*} customAttributes custom attributes to attach to the RUM call - Defaults to info.js
-   * @param {*} target The target to harvest to
    */
-  sendRum(customAttributes = this.agentRef.info.jsAttributes, target = {
-    licenseKey: this.agentRef.info.licenseKey,
-    applicationID: this.agentRef.info.applicationID
-  }) {
+  sendRum(customAttributes = this.agentRef.info.jsAttributes) {
     const info = this.agentRef.info;
     const measures = {};
     if (info.queueTime) measures.qt = info.queueTime;
@@ -116,27 +117,30 @@ class Aggregate extends _aggregateBase.AggregateBase {
     }
     queryParameters.fp = _firstPaint.firstPaint.current.value;
     queryParameters.fcp = _firstContentfulPaint.firstContentfulPaint.current.value;
-    const timeKeeper = this.agentRef.runtime.timeKeeper;
-    if (timeKeeper?.ready) {
-      queryParameters.timestamp = Math.floor(timeKeeper.correctRelativeTimestamp((0, _now.now)()));
-    }
-    this.rumStartTime = (0, _now.now)();
-    this.agentRef.runtime.harvester.triggerHarvestFor(this, {
-      directSend: {
-        target,
-        payload: {
-          qs: queryParameters,
-          body
-        }
-      },
-      needResponse: true,
+    this.queryStringsBuilder = () => {
+      // this will be called by AggregateBase.makeHarvestPayload every time harvest is triggered to be qs
+      this.rumStartTime = (0, _now.now)(); // this should be reset at the beginning of each RUM call for proper timeKeeper calculation in coordination with postHarvestCleanup
+      const timeKeeper = this.agentRef.runtime.timeKeeper;
+      if (timeKeeper?.ready) {
+        queryParameters.timestamp = Math.floor(timeKeeper.correctRelativeTimestamp(this.rumStartTime));
+      }
+      return queryParameters;
+    };
+    this.events.add(body);
+    if (this.agentRef.runtime.harvester.triggerHarvestFor(this, {
       sendEmptyBody: true
-    });
+    }).ranSend) this.sentRum = true;
+  }
+  serializer(eventBuffer) {
+    // this is necessary because PVE sends a single item rather than an array; in the case of undefined, this prevents sending [null] as body
+    return eventBuffer[0];
   }
   postHarvestCleanup({
+    sent,
     status,
     responseText,
-    xhr
+    xhr,
+    retry
   }) {
     const rumEndTime = (0, _now.now)();
     let app, flags;
@@ -149,8 +153,65 @@ class Aggregate extends _aggregateBase.AggregateBase {
       // wont set entity stuff here, if main agent will later abort, if registered agent, nothing will happen
       (0, _console.warn)(53, error);
     }
+    super.postHarvestCleanup({
+      sent,
+      retry
+    }); // this will set isRetrying & re-buffer the body if request is to be retried
+    if (this.isRetrying && this.retries++ < 1) {
+      // Only retry once
+      setTimeout(() => this.agentRef.runtime.harvester.triggerHarvestFor(this, {
+        sendEmptyBody: true
+      }), 5000); // Retry sending the RUM event after 5 seconds
+      return;
+    }
     if (status >= 400 || status === 0) {
       (0, _console.warn)(18, status);
+      this.blocked = true;
+
+      // Get estimated payload size of our backlog
+      const textEncoder = new TextEncoder();
+      const payloadSize = Object.values(newrelic.ee.backlog).reduce((acc, value) => {
+        if (!value) return acc;
+        const encoded = textEncoder.encode(value);
+        return acc + encoded.byteLength;
+      }, 0);
+
+      // Send SMs about failed RUM request
+      const body = {
+        sm: [{
+          params: {
+            name: "Browser/Supportability/BCS/Error/".concat(status)
+          },
+          stats: {
+            c: 1
+          }
+        }, {
+          params: {
+            name: 'Browser/Supportability/BCS/Error/Dropped/Bytes'
+          },
+          stats: {
+            c: 1,
+            t: payloadSize
+          }
+        }, {
+          params: {
+            name: 'Browser/Supportability/BCS/Error/Duration/Ms'
+          },
+          stats: {
+            c: 1,
+            t: rumEndTime - this.rumStartTime
+          }
+        }]
+      };
+      (0, _harvester.send)(this.agentRef, {
+        endpoint: _features.FEATURE_TO_ENDPOINT[_features.FEATURE_NAMES.metrics],
+        payload: {
+          body
+        },
+        submitMethod: (0, _submitData.getSubmitMethod)(),
+        featureName: _features.FEATURE_NAMES.metrics
+      });
+
       // Adding retry logic for the rum call will be a separate change; this.blocked will need to be changed since that prevents another triggerHarvestFor()
       this.ee.abort();
       return;
@@ -169,6 +230,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
       }
     } catch (error) {
       this.ee.abort();
+      this.blocked = true;
       (0, _console.warn)(17, error);
       return;
     }

package/dist/cjs/features/page_view_event/instrument/index.js

@@ -4,7 +4,6 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.PageViewEvent = exports.Instrument = void 0;
-var _handle = require("../../../common/event-emitter/handle");
 var _setPageViewName = require("../../../loaders/api/setPageViewName");
 var _instrumentBase = require("../../utils/instrument-base");
 var CONSTANTS = _interopRequireWildcard(require("../constants"));
@@ -25,9 +24,6 @@ class Instrument extends _instrumentBase.InstrumentBase {
 
     /** feature specific APIs */
     (0, _setPageViewName.setupSetPageViewNameAPI)(agentRef);
-
-    /** messages from the register API that can trigger a new RUM call */
-    this.ee.on('api-send-rum', (attrs, target) => (0, _handle.handle)('send-rum', [attrs, target], undefined, this.featureName, this.ee));
     this.importAggregator(agentRef, () => Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "page_view_event-aggregate" */'../aggregate'))));
   }
   setupInspectionEvents(agentIdentifier) {

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

@@ -19,6 +19,7 @@ var _now = require("../../../common/timing/now");
 var _agentConstants = require("../../../common/constants/agent-constants");
 var _cleanUrl = require("../../../common/url/clean-url");
 var _featureGates = require("../../utils/feature-gates");
+var _constants3 = require("../../../loaders/api/constants");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); } /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -76,10 +77,10 @@ class Aggregate extends _aggregateBase.AggregateBase {
       if (this.mode !== _constants2.MODE.OFF && data.sessionReplayMode === _constants2.MODE.OFF) this.abort(_constants.ABORT_REASONS.CROSS_TAB);
       this.mode = data.sessionReplayMode;
     });
-    (0, _registerHandler.registerHandler)(_constants.SR_EVENT_EMITTER_TYPES.PAUSE, () => {
+    (0, _registerHandler.registerHandler)(_constants3.PAUSE_REPLAY, () => {
       this.forceStop(this.mode === _constants2.MODE.FULL);
     }, this.featureName, this.ee);
-    (0, _registerHandler.registerHandler)(_constants.SR_EVENT_EMITTER_TYPES.ERROR_DURING_REPLAY, e => {
+    (0, _registerHandler.registerHandler)(_constants.ERROR_DURING_REPLAY, e => {
       this.handleError(e);
     }, this.featureName, this.ee);
     const {

package/dist/cjs/features/session_replay/constants.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.TRIGGERS = exports.SR_EVENT_EMITTER_TYPES = exports.RRWEB_EVENT_TYPES = exports.QUERY_PARAM_PADDING = exports.FEATURE_NAME = exports.CHECKOUT_MS = exports.AVG_COMPRESSION = exports.ABORT_REASONS = void 0;
+exports.TRIGGERS = exports.RRWEB_EVENT_TYPES = exports.QUERY_PARAM_PADDING = exports.FEATURE_NAME = exports.ERROR_DURING_REPLAY = exports.CHECKOUT_MS = exports.AVG_COMPRESSION = exports.ABORT_REASONS = void 0;
 var _constants = require("../../common/session/constants");
 var _features = require("../../loaders/features/features");
 /**
@@ -12,11 +12,7 @@ var _features = require("../../loaders/features/features");
  */
 
 const FEATURE_NAME = exports.FEATURE_NAME = _features.FEATURE_NAMES.sessionReplay;
-const SR_EVENT_EMITTER_TYPES = exports.SR_EVENT_EMITTER_TYPES = {
-  RECORD: 'recordReplay',
-  PAUSE: 'pauseReplay',
-  ERROR_DURING_REPLAY: 'errorDuringReplay'
-};
+const ERROR_DURING_REPLAY = exports.ERROR_DURING_REPLAY = 'errorDuringReplay';
 const AVG_COMPRESSION = exports.AVG_COMPRESSION = 0.12;
 const RRWEB_EVENT_TYPES = exports.RRWEB_EVENT_TYPES = {
   DomContentLoaded: 0,

package/dist/cjs/features/session_replay/instrument/index.js

@@ -11,6 +11,7 @@ var _utils = require("../shared/utils");
 var _constants2 = require("../constants");
 var _recordReplay = require("../../../loaders/api/recordReplay");
 var _pauseReplay = require("../../../loaders/api/pauseReplay");
+var _constants3 = require("../../../loaders/api/constants");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); } /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -34,7 +35,7 @@ class Instrument extends _instrumentBase.InstrumentBase {
       session = JSON.parse(localStorage.getItem("".concat(_constants.PREFIX, "_").concat(_constants.DEFAULT_KEY)));
     } catch (err) {}
     if ((0, _utils.hasReplayPrerequisite)(agentRef.init)) {
-      this.ee.on(_constants2.SR_EVENT_EMITTER_TYPES.RECORD, () => this.#apiStartOrRestartReplay());
+      this.ee.on(_constants3.RECORD_REPLAY, () => this.#apiStartOrRestartReplay());
     }
     if (this.#canPreloadRecorder(session)) {
       this.importRecorder().then(recorder => {
@@ -48,7 +49,7 @@ class Instrument extends _instrumentBase.InstrumentBase {
       if (this.blocked) return;
       if (this.agentRef.runtime.isRecording) {
         this.errorNoticed = true;
-        (0, _handle.handle)(_constants2.SR_EVENT_EMITTER_TYPES.ERROR_DURING_REPLAY, [e], undefined, this.featureName, this.ee);
+        (0, _handle.handle)(_constants2.ERROR_DURING_REPLAY, [e], undefined, this.featureName, this.ee);
       }
     });
   }

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

@@ -59,6 +59,11 @@ function setupAgentSession(agentRef) {
   (0, _registerHandler.registerHandler)('api-setUserId', (time, key, value) => {
     agentRef.runtime.session.syncCustomAttribute(key, value);
   }, 'session', sharedEE);
+  (0, _registerHandler.registerHandler)('api-consent', accept => {
+    agentRef.runtime.session.write({
+      consent: accept === undefined ? true : accept
+    });
+  }, 'session', sharedEE);
   (0, _drain.drain)(agentRef.agentIdentifier, 'session');
   return agentRef.runtime.session;
 }

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

@@ -50,7 +50,10 @@ class InstrumentBase extends _featureBase.FeatureBase {
      * @type {Promise} Assigned immediately after @see importAggregator runs. Serves as a signal for when the inner async fn finishes execution. Useful for features to await
      * one another if there are inter-features dependencies.
     */
-    this.onAggregateImported = undefined;
+    this.loadedSuccessfully = undefined;
+    this.onAggregateImported = new Promise(resolve => {
+      this.loadedSuccessfully = resolve;
+    });
 
     /**
      * used in conjunction with newrelic.start() to defer harvesting in features
@@ -82,10 +85,6 @@ class InstrumentBase extends _featureBase.FeatureBase {
    */
   importAggregator(agentRef, fetchAggregator, argsObjFromInstrument = {}) {
     if (this.featAggregate) return;
-    let loadedSuccessfully;
-    this.onAggregateImported = new Promise(resolve => {
-      loadedSuccessfully = resolve;
-    });
     const importLater = async () => {
       // wait for the deferred promise to resolve before proceeding
       // this will resolve immediately if the feature is auto-started,
@@ -113,7 +112,7 @@ class InstrumentBase extends _featureBase.FeatureBase {
       try {
         if (!this.#shouldImportAgg(this.featureName, session, agentRef.init)) {
           (0, _drain.drain)(this.agentIdentifier, this.featureName);
-          loadedSuccessfully(false); // aggregate module isn't loaded at all
+          this.loadedSuccessfully(false); // aggregate module isn't loaded at all
           return;
         }
         const {
@@ -121,13 +120,13 @@ class InstrumentBase extends _featureBase.FeatureBase {
         } = await fetchAggregator();
         this.featAggregate = new Aggregate(agentRef, argsObjFromInstrument);
         agentRef.runtime.harvester.initializedAggregates.push(this.featAggregate); // "subscribe" the feature to future harvest intervals (PVE will start the timer)
-        loadedSuccessfully(true);
+        this.loadedSuccessfully(true);
       } catch (e) {
         (0, _console.warn)(34, e);
         this.abortHandler?.(); // undo any important alterations made to the page
         // not supported yet but nice to do: "abort" this agent's EE for this feature specifically
         (0, _drain.drain)(this.agentIdentifier, this.featureName, true);
-        loadedSuccessfully(false);
+        this.loadedSuccessfully(false);
         if (this.ee) this.ee.abort();
       }
     };

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

@@ -54,6 +54,27 @@ class RegisteredEntity {
     (0, _console.warn)(35, 'addPageAction');
   }
 
+  /**
+     * Records a custom event with a specified eventType and attributes.
+     * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/recordCustomEvent/}
+     * @param {string} eventType The eventType to store the event as.
+     * @param {Object} [attributes] JSON object with one or more key/value pairs. For example: {key:"value"}.
+     */
+  recordCustomEvent(eventType, attributes) {
+    (0, _console.warn)(35, 'recordCustomEvent');
+  }
+
+  /**
+   * Measures a task that is recorded as a BrowserPerformance event.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/measure/}
+   * @param {string} name The name of the task
+   * @param {{start: number, end: number, duration: number, customAttributes: object}} [options] An object used to control the way the measure API operates
+   * @returns {{start: number, end: number, duration: number, customAttributes: object}} Measurement details
+   */
+  measure(name, options) {
+    (0, _console.warn)(35, 'measure');
+  }
+
   /**
    * Adds a user-defined attribute name and value to subsequent events on the page for the registered target. Note -- the persist flag does not work with the register API.
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setcustomattribute/}

package/dist/cjs/loaders/agent.js

@@ -19,6 +19,7 @@ var _setCustomAttribute = require("./api/setCustomAttribute");
 var _setUserId = require("./api/setUserId");
 var _setApplicationVersion = require("./api/setApplicationVersion");
 var _start = require("./api/start");
+var _consent = require("./api/consent");
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -77,6 +78,7 @@ class Agent extends _agentBase.AgentBase {
     (0, _setUserId.setupSetUserIdAPI)(this);
     (0, _setApplicationVersion.setupSetApplicationVersionAPI)(this);
     (0, _start.setupStartAPI)(this);
+    (0, _consent.setupConsentAPI)(this);
     this.run();
   }
   get config() {