@newrelic/browser-agent 1.302.0-rc.0 → 1.302.0-rc.10

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/recordCustomEvent.js

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+exports.recordCustomEvent = recordCustomEvent;
 exports.setupRecordCustomEventAPI = setupRecordCustomEventAPI;
 var _handle = require("../../common/event-emitter/handle");
 var _now = require("../../common/timing/now");
@@ -15,7 +16,8 @@ var _sharedHandlers = require("./sharedHandlers");
  */
 
 function setupRecordCustomEventAPI(agent) {
-  (0, _sharedHandlers.setupAPI)(_constants.RECORD_CUSTOM_EVENT, function () {
-    (0, _handle.handle)(_constants.prefix + _constants.RECORD_CUSTOM_EVENT, [(0, _now.now)(), ...arguments], undefined, _features.FEATURE_NAMES.genericEvents, agent.ee);
-  }, agent);
+  (0, _sharedHandlers.setupAPI)(_constants.RECORD_CUSTOM_EVENT, (eventType, attributes) => recordCustomEvent(eventType, attributes, agent), agent);
+}
+function recordCustomEvent(eventType, attributes = {}, agentRef, target, timestamp = (0, _now.now)()) {
+  (0, _handle.handle)(_constants.prefix + _constants.RECORD_CUSTOM_EVENT, [timestamp, eventType, attributes, target], undefined, _features.FEATURE_NAMES.genericEvents, agentRef.ee);
 }

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

@@ -10,19 +10,20 @@ exports.default = void 0;
  */
 /**
  * @typedef {Object} RegisterAPI
- * @property {Function} addPageAction - Add a page action for the registered entity.
- * @property {Function} log - Capture a log for the registered entity.
- * @property {Function} noticeError - Notice an error for the registered entity.
- * @property {Function} setApplicationVersion - Add an application.version attribute to all outgoing data for the registered entity.
- * @property {Function} setCustomAttribute - Add a custom attribute to outgoing data for the registered entity.
- * @property {Function} setUserId - Add an enduser.id attribute to all outgoing API data for the registered entity.
+ * @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 {(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.
  * @property {RegisterAPIMetadata} metadata - The metadata object containing the custom attributes and target information for the registered entity.
  */
 /**
  * @typedef {Object} RegisterAPIConstructor
- * @property {Object} opts - The options for the registered entity.
- * @property {string} opts.id - The unique id for the registered entity. This will be assigned to any synthesized entities.
- * @property {string} opts.name - The readable name for the registered entity. This will be assigned to any synthesized entities.
+ * @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.
  */
 /**
  * @typedef {Object} RegisterAPIMetadata

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

@@ -17,6 +17,8 @@ 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.
  * SPDX-License-Identifier: Apache-2.0
@@ -86,6 +88,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 = {
@@ -100,10 +105,21 @@ 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
     }, agentRef], target),
+    recordCustomEvent: (eventType, attributes = {}) => report(_recordCustomEvent.recordCustomEvent, [eventType, {
+      ...attrs,
+      ...attributes
+    }, agentRef], target),
     setApplicationVersion: value => setLocalValue('application.version', value),
     setCustomAttribute: (key, value) => setLocalValue(key, value),
     setUserId: value => setLocalValue('enduser.id', value),

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

@@ -37,11 +37,8 @@ class ApiBase {
    * It is not recommended for use in production environments and will not receive support for issues.
    *
    * Registers an external caller to report through the base agent to a different target than the base agent.
-   * @param {object} target the target object to report data to
-   * @param {string} target.licenseKey The licenseKey to report data to
-   * @param {string} target.applicationID The applicationID to report data to
-   * @param {string=} target.entityGuid The entityGuid to report data to
-   * @returns {object} Returns an object that contains the available API methods and configurations to use with the external caller. See loaders/api/api.js for more information.
+   * @param {import('./api/register-api-types').RegisterAPIConstructor} target the target object to report data to
+  @returns {import('./api/register-api-types').RegisterAPI} Returns an object that contains the available API methods and configurations to use with the external caller. See loaders/api/api.js for more information.
    */
   register(target) {
     return this.#callMethod(_constants.REGISTER, target);
@@ -51,7 +48,7 @@ class ApiBase {
    * 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"}.
+   * @param {Object} [attributes] JSON object with one or more key/value pairs. For example: {key:"value"}.
    */
   recordCustomEvent(eventType, attributes) {
     return this.#callMethod(_constants.RECORD_CUSTOM_EVENT, eventType, attributes);
@@ -227,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.0";
+export const VERSION = "1.302.0-rc.10";
 
 /**
  * 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.0";
+export const VERSION = "1.302.0-rc.10";
 
 /**
  * Exposes the build type of the agent

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

@@ -17,8 +17,10 @@ import { stringify } from '../util/stringify';
 import { getSubmitMethod, xhr as xhrMethod, xhrFetch as fetchMethod } from '../util/submit-data';
 import { activatedFeatures } from '../util/feature-flags';
 import { dispatchGlobalEvent } from '../dispatch/global-event';
-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/';
 export class Harvester {
   #started = false;
   initializedAggregates = [];
@@ -59,11 +61,11 @@ 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
-    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: FEATURE_TO_ENDPOINT[aggregateInst.featureName],
@@ -85,7 +87,9 @@ export class Harvester {
     function cbFinished(result) {
       if (aggregateInst.harvestOpts.prevAttemptCode) {
         // this means we just retried a harvest that last failed
-        handle(SUPPORTABILITY_METRIC_CHANNEL, [(result.retry ? RETRY_FAILED : RETRY_SUCCEEDED) + aggregateInst.harvestOpts.prevAttemptCode], undefined, FEATURE_NAMES.metrics, aggregateInst.ee);
+        const reportSM = message => handle(SUPPORTABILITY_METRIC_CHANNEL, [message], undefined, 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.
       }
@@ -175,9 +179,9 @@ export 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 */
@@ -191,9 +195,9 @@ export 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/esm/common/harvest/types.js

@@ -24,7 +24,6 @@
  * @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/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/common/util/mfe.js

@@ -10,6 +10,9 @@
 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.

package/dist/esm/common/wrap/wrap-promise.js

@@ -129,12 +129,17 @@ export 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/esm/features/generic_events/aggregate/index.js

@@ -28,13 +28,13 @@ export class Aggregate extends AggregateBase {
         return;
       }
       this.#trackSupportabilityMetrics();
-      registerHandler('api-recordCustomEvent', (timestamp, eventType, attributes) => {
+      registerHandler('api-recordCustomEvent', (timestamp, eventType, attributes, target) => {
         if (RESERVED_EVENT_TYPES.includes(eventType)) return warn(46);
         this.addEvent({
           eventType,
           timestamp: this.toEpoch(timestamp),
           ...attributes
-        });
+        }, target);
       }, this.featureName, this.ee);
       if (agentRef.init.page_action.enabled) {
         registerHandler('api-addPageAction', (timestamp, name, attributes, target) => {
@@ -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/logging/aggregate/index.js

@@ -97,8 +97,7 @@ export class Aggregate extends 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
+          ...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/esm/features/page_view_event/aggregate/index.js

@@ -17,14 +17,19 @@ import { timeToFirstByte } from '../../../common/vitals/time-to-first-byte';
 import { now } from '../../../common/timing/now';
 import { TimeKeeper } from '../../../common/timing/time-keeper';
 import { applyFnToProps } from '../../../common/util/traverse';
+import { send } from '../../../common/harvest/harvester';
+import { FEATURE_NAMES, FEATURE_TO_ENDPOINT } from '../../../loaders/features/features';
+import { getSubmitMethod } from '../../../common/util/submit-data';
 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
-
+    this.retries = 0;
     if (!isValid(agentRef.info)) {
       this.ee.abort();
       return warn(43);
@@ -52,12 +57,8 @@ export class Aggregate extends 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;
@@ -108,27 +109,30 @@ export class Aggregate extends AggregateBase {
     }
     queryParameters.fp = firstPaint.current.value;
     queryParameters.fcp = firstContentfulPaint.current.value;
-    const timeKeeper = this.agentRef.runtime.timeKeeper;
-    if (timeKeeper?.ready) {
-      queryParameters.timestamp = Math.floor(timeKeeper.correctRelativeTimestamp(now()));
-    }
-    this.rumStartTime = 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 = 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 = now();
     let app, flags;
@@ -141,8 +145,65 @@ export class Aggregate extends AggregateBase {
       // wont set entity stuff here, if main agent will later abort, if registered agent, nothing will happen
       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) {
       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
+          }
+        }]
+      };
+      send(this.agentRef, {
+        endpoint: FEATURE_TO_ENDPOINT[FEATURE_NAMES.metrics],
+        payload: {
+          body
+        },
+        submitMethod: getSubmitMethod(),
+        featureName: 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;
@@ -161,6 +222,7 @@ export class Aggregate extends AggregateBase {
       }
     } catch (error) {
       this.ee.abort();
+      this.blocked = true;
       warn(17, error);
       return;
     }

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

@@ -7,7 +7,7 @@
  */
 
 import { registerHandler } from '../../../common/event-emitter/register-handler';
-import { ABORT_REASONS, FEATURE_NAME, QUERY_PARAM_PADDING, RRWEB_EVENT_TYPES, SR_EVENT_EMITTER_TYPES, TRIGGERS } from '../constants';
+import { ABORT_REASONS, ERROR_DURING_REPLAY, FEATURE_NAME, QUERY_PARAM_PADDING, RRWEB_EVENT_TYPES, TRIGGERS } from '../constants';
 import { AggregateBase } from '../../utils/aggregate-base';
 import { sharedChannel } from '../../../common/constants/shared-channel';
 import { obj as encodeObj } from '../../../common/url/encode';
@@ -21,6 +21,7 @@ import { now } from '../../../common/timing/now';
 import { MAX_PAYLOAD_SIZE } from '../../../common/constants/agent-constants';
 import { cleanURL } from '../../../common/url/clean-url';
 import { canEnableSessionTracking } from '../../utils/feature-gates';
+import { PAUSE_REPLAY } from '../../../loaders/api/constants';
 export class Aggregate extends AggregateBase {
   static featureName = FEATURE_NAME;
   mode = MODE.OFF;
@@ -72,10 +73,10 @@ export class Aggregate extends AggregateBase {
       if (this.mode !== MODE.OFF && data.sessionReplayMode === MODE.OFF) this.abort(ABORT_REASONS.CROSS_TAB);
       this.mode = data.sessionReplayMode;
     });
-    registerHandler(SR_EVENT_EMITTER_TYPES.PAUSE, () => {
+    registerHandler(PAUSE_REPLAY, () => {
       this.forceStop(this.mode === MODE.FULL);
     }, this.featureName, this.ee);
-    registerHandler(SR_EVENT_EMITTER_TYPES.ERROR_DURING_REPLAY, e => {
+    registerHandler(ERROR_DURING_REPLAY, e => {
       this.handleError(e);
     }, this.featureName, this.ee);
     const {