@newrelic/browser-agent 1.302.0-rc.6 → 1.302.0-rc.8

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.6";
+const VERSION = exports.VERSION = "1.302.0-rc.8";
 
 /**
  * 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.6";
+const VERSION = exports.VERSION = "1.302.0-rc.8";
 
 /**
  * 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?.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
-    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/features/page_view_event/aggregate/index.js

@@ -32,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);
@@ -63,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;
@@ -119,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;
@@ -152,8 +153,20 @@ 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();
@@ -217,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/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/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-base.js

@@ -230,5 +230,15 @@ class ApiBase {
   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.6";
+export const VERSION = "1.302.0-rc.8";
 
 /**
  * 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.6";
+export const VERSION = "1.302.0-rc.8";
 
 /**
  * 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/features/page_view_event/aggregate/index.js

@@ -24,10 +24,12 @@ 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);
@@ -55,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;
@@ -111,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;
@@ -144,8 +145,20 @@ 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();
@@ -209,6 +222,7 @@ export class Aggregate extends AggregateBase {
       }
     } catch (error) {
       this.ee.abort();
+      this.blocked = true;
       warn(17, error);
       return;
     }