@newrelic/browser-agent 1.302.0-rc.7 → 1.302.0-rc.9

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

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

@@ -69,6 +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;
     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/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/features/generic_events/aggregate/index.js

@@ -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/page_view_event/aggregate/index.js

@@ -32,6 +32,8 @@ 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
@@ -125,9 +127,9 @@ class Aggregate extends _aggregateBase.AggregateBase {
       return queryParameters;
     };
     this.events.add(body);
-    this.agentRef.runtime.harvester.triggerHarvestFor(this, {
+    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

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/utils/agent-session.js

@@ -59,6 +59,19 @@ 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
+    });
+
+    // 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/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

@@ -64,6 +64,17 @@ class RegisteredEntity {
     (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() {

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

@@ -0,0 +1,24 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.setupConsentAPI = setupConsentAPI;
+var _constants = require("./constants");
+var _sharedHandlers = require("./sharedHandlers");
+var _handle = require("../../common/event-emitter/handle");
+var _console = require("../../common/util/console");
+/**
+ * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+function setupConsentAPI(agent) {
+  (0, _sharedHandlers.setupAPI)(_constants.CONSENT, function (accept) {
+    if (accept !== undefined && typeof accept !== 'boolean') {
+      (0, _console.warn)(65, typeof accept);
+      return;
+    }
+    (0, _handle.handle)(_constants.prefix + _constants.CONSENT, [accept], undefined, 'session', agent.ee);
+  }, agent);
+}

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

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.spaPrefix = exports.prefix = exports.WRAP_LOGGER = exports.START = exports.SET_USER_ID = exports.SET_PAGE_VIEW_NAME = exports.SET_ERROR_HANDLER = exports.SET_CUSTOM_ATTRIBUTE = exports.SET_CURRENT_ROUTE_NAME = exports.SET_APPLICATION_VERSION = exports.REGISTER = exports.RECORD_REPLAY = exports.RECORD_CUSTOM_EVENT = exports.PAUSE_REPLAY = exports.NOTICE_ERROR = exports.MEASURE = exports.LOG = exports.INTERACTION = exports.FINISHED = exports.ADD_TO_TRACE = exports.ADD_RELEASE = exports.ADD_PAGE_ACTION = void 0;
+exports.spaPrefix = exports.prefix = exports.WRAP_LOGGER = exports.START = exports.SET_USER_ID = exports.SET_PAGE_VIEW_NAME = exports.SET_ERROR_HANDLER = exports.SET_CUSTOM_ATTRIBUTE = exports.SET_CURRENT_ROUTE_NAME = exports.SET_APPLICATION_VERSION = exports.REGISTER = exports.RECORD_REPLAY = exports.RECORD_CUSTOM_EVENT = exports.PAUSE_REPLAY = exports.NOTICE_ERROR = exports.MEASURE = exports.LOG = exports.INTERACTION = exports.FINISHED = exports.CONSENT = exports.ADD_TO_TRACE = exports.ADD_RELEASE = exports.ADD_PAGE_ACTION = void 0;
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -29,4 +29,5 @@ const SET_PAGE_VIEW_NAME = exports.SET_PAGE_VIEW_NAME = 'setPageViewName';
 const SET_USER_ID = exports.SET_USER_ID = 'setUserId';
 const START = exports.START = 'start';
 const WRAP_LOGGER = exports.WRAP_LOGGER = 'wrapLogger';
-const MEASURE = exports.MEASURE = 'measure';
+const MEASURE = exports.MEASURE = 'measure';
+const CONSENT = exports.CONSENT = 'consent';

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

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+exports.measure = measure;
 exports.setupMeasureAPI = setupMeasureAPI;
 var _handle = require("../../common/event-emitter/handle");
 var _now = require("../../common/timing/now");
@@ -16,45 +17,45 @@ var _sharedHandlers = require("./sharedHandlers");
  */
 
 function setupMeasureAPI(agent) {
-  (0, _sharedHandlers.setupAPI)(_constants.MEASURE, function (name, options) {
-    const n = (0, _now.now)();
-    const {
-      start,
-      end,
-      customAttributes
-    } = options || {};
-    const returnObj = {
-      customAttributes: customAttributes || {}
-    };
-    if (typeof returnObj.customAttributes !== 'object' || typeof name !== 'string' || name.length === 0) {
-      (0, _console.warn)(57);
-      return;
-    }
+  (0, _sharedHandlers.setupAPI)(_constants.MEASURE, (name, options) => measure(name, options, agent), agent);
+}
+function measure(name, options, agentRef, target, timestamp = (0, _now.now)()) {
+  const {
+    start,
+    end,
+    customAttributes
+  } = options || {};
+  const returnObj = {
+    customAttributes: customAttributes || {}
+  };
+  if (typeof returnObj.customAttributes !== 'object' || typeof name !== 'string' || name.length === 0) {
+    (0, _console.warn)(57);
+    return;
+  }
 
-    /**
+  /**
      * getValueFromTiming - Helper function to extract a numeric value from a supplied option.
      * @param {Number|PerformanceMark} [timing] The timing value
      * @param {Number} [d] The default value to return if timing is invalid
      * @returns {Number} The timing value or the default value
      */
-    const getValueFromTiming = (timing, d) => {
-      if (timing == null) return d;
-      if (typeof timing === 'number') return timing;
-      if (timing instanceof PerformanceMark) return timing.startTime;
-      return Number.NaN;
-    };
-    returnObj.start = getValueFromTiming(start, 0);
-    returnObj.end = getValueFromTiming(end, n);
-    if (Number.isNaN(returnObj.start) || Number.isNaN(returnObj.end)) {
-      (0, _console.warn)(57);
-      return;
-    }
-    returnObj.duration = returnObj.end - returnObj.start;
-    if (returnObj.duration < 0) {
-      (0, _console.warn)(58);
-      return;
-    }
-    (0, _handle.handle)(_constants.prefix + _constants.MEASURE, [returnObj, name], undefined, _features.FEATURE_NAMES.genericEvents, agent.ee);
-    return returnObj;
-  }, agent);
+  const getValueFromTiming = (timing, d) => {
+    if (timing == null) return d;
+    if (typeof timing === 'number') return timing;
+    if (timing instanceof PerformanceMark) return timing.startTime;
+    return Number.NaN;
+  };
+  returnObj.start = getValueFromTiming(start, 0);
+  returnObj.end = getValueFromTiming(end, timestamp);
+  if (Number.isNaN(returnObj.start) || Number.isNaN(returnObj.end)) {
+    (0, _console.warn)(57);
+    return;
+  }
+  returnObj.duration = returnObj.end - returnObj.start;
+  if (returnObj.duration < 0) {
+    (0, _console.warn)(58);
+    return;
+  }
+  (0, _handle.handle)(_constants.prefix + _constants.MEASURE, [returnObj, name, target], undefined, _features.FEATURE_NAMES.genericEvents, agentRef.ee);
+  return returnObj;
 }

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

@@ -14,6 +14,7 @@ exports.default = void 0;
  * @property {(message: string, options?: { customAttributes?: object, level?: 'ERROR' | 'TRACE' | 'DEBUG' | 'INFO' | 'WARN'}) => void} log - Capture a log for the registered entity.
  * @property {(error: Error | string, customAttributes?: object) => void} noticeError - Notice an error for the registered entity.
  * @property {(eventType: string, attributes?: Object) => void} recordCustomEvent - Record a custom event for the registered entity.
+ * @property {(eventType: string, options?: {start: number, end: number, duration: number, customAttributes: object}) => {{start: number, end: number, duration: number, customAttributes: object}}} measure - Measures a task that is recorded as a BrowserPerformance event.
  * @property {(value: string | null) => void} setApplicationVersion - Add an application.version attribute to all outgoing data for the registered entity.
  * @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.

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

@@ -17,6 +17,7 @@ var _log = require("./log");
 var _addPageAction = require("./addPageAction");
 var _noticeError = require("./noticeError");
 var _invoke = require("../../common/util/invoke");
+var _measure = require("./measure");
 var _recordCustomEvent = require("./recordCustomEvent");
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
@@ -101,6 +102,13 @@ function buildRegisterApi(agentRef, target) {
         ...(options.customAttributes || {})
       }
     }, agentRef], target),
+    measure: (name, options = {}) => report(_measure.measure, [name, {
+      ...options,
+      customAttributes: {
+        ...attrs,
+        ...(options.customAttributes || {})
+      }
+    }, agentRef], target),
     noticeError: (error, attributes = {}) => report(_noticeError.noticeError, [error, {
       ...attrs,
       ...attributes

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

@@ -224,11 +224,21 @@ class ApiBase {
    * 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 {object?} options An object used to control the way the measure API operates
+   * @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) {
     return this.#callMethod(_constants.MEASURE, name, options);
   }
+
+  /**
+   * Accepts or rejects consent when the agent is configured to require consent before harvesting.
+   * The consent state is stored in session storage inside the NRBA_SESSION object.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/consent/}
+   * @param {boolean?} accept Whether to accept or reject consent. Defaults to true (accept) if left undefined.
+   */
+  consent(accept) {
+    return this.#callMethod(_constants.CONSENT, accept);
+  }
 }
 exports.ApiBase = ApiBase;

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

@@ -84,6 +84,8 @@
  * @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/esm/common/config/init.js

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

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

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

@@ -61,6 +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;
     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/session/session-entity.js

@@ -33,7 +33,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
 };
 export class SessionEntity {
   /**
@@ -84,7 +85,8 @@ export 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/esm/features/generic_events/aggregate/index.js

@@ -231,7 +231,7 @@ export class Aggregate extends AggregateBase {
           }
         }, this.featureName, this.ee);
       }
-      registerHandler('api-measure', (args, n) => {
+      registerHandler('api-measure', (args, n, target) => {
         const {
           start,
           duration,
@@ -245,7 +245,7 @@ export class Aggregate extends AggregateBase {
           entryDuration: duration,
           entryType: 'measure'
         };
-        this.addEvent(event);
+        this.addEvent(event, target);
       }, this.featureName, this.ee);
       this.drain();
     });

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

@@ -24,6 +24,8 @@ export class Aggregate extends 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
@@ -117,9 +119,9 @@ export class Aggregate extends AggregateBase {
       return queryParameters;
     };
     this.events.add(body);
-    this.agentRef.runtime.harvester.triggerHarvestFor(this, {
+    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

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

@@ -2,7 +2,6 @@
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { handle } from '../../../common/event-emitter/handle';
 import { setupSetPageViewNameAPI } from '../../../loaders/api/setPageViewName';
 import { InstrumentBase } from '../../utils/instrument-base';
 import * as CONSTANTS from '../constants';
@@ -19,9 +18,6 @@ export class Instrument extends InstrumentBase {
 
     /** feature specific APIs */
     setupSetPageViewNameAPI(agentRef);
-
-    /** messages from the register API that can trigger a new RUM call */
-    this.ee.on('api-send-rum', (attrs, target) => handle('send-rum', [attrs, target], undefined, this.featureName, this.ee));
     this.importAggregator(agentRef, () => import(/* webpackChunkName: "page_view_event-aggregate" */'../aggregate'));
   }
   setupInspectionEvents(agentIdentifier) {

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

@@ -52,6 +52,19 @@ export function setupAgentSession(agentRef) {
   registerHandler('api-setUserId', (time, key, value) => {
     agentRef.runtime.session.syncCustomAttribute(key, value);
   }, 'session', sharedEE);
+  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');
   return agentRef.runtime.session;
 }

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

@@ -48,7 +48,10 @@ export class InstrumentBase extends 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
@@ -80,10 +83,6 @@ export class InstrumentBase extends 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,
@@ -111,7 +110,7 @@ export class InstrumentBase extends FeatureBase {
       try {
         if (!this.#shouldImportAgg(this.featureName, session, agentRef.init)) {
           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 {
@@ -119,13 +118,13 @@ export class InstrumentBase extends 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) {
         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
         drain(this.agentIdentifier, this.featureName, true);
-        loadedSuccessfully(false);
+        this.loadedSuccessfully(false);
         if (this.ee) this.ee.abort();
       }
     };

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

@@ -58,6 +58,17 @@ export class RegisteredEntity {
     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) {
+    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/}