@newrelic/browser-agent 1.293.0 → 1.294.0-rc.0

package/CHANGELOG.md

@@ -3,6 +3,18 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.294.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.293.0...v1.294.0) (2025-07-23)
+
+
+### Features
+
+* Harvest early ([#1513](https://github.com/newrelic/newrelic-browser-agent/issues/1513)) ([d347eaa](https://github.com/newrelic/newrelic-browser-agent/commit/d347eaa76e26a9a4fc8e5c191de6a3c737712c68))
+
+
+### Bug Fixes
+
+* report empty previousUrl as undefined ([#1526](https://github.com/newrelic/newrelic-browser-agent/issues/1526)) ([e3ca824](https://github.com/newrelic/newrelic-browser-agent/commit/e3ca824847e8f91a5da8cca8bf7717001c16929b))
+
 ## [1.293.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.292.1...v1.293.0) (2025-07-01)
 
 

package/dist/cjs/common/aggregate/event-aggregator.js

@@ -17,6 +17,9 @@ var _aggregator = require("./aggregator");
 class EventAggregator {
   #aggregator = new _aggregator.Aggregator();
   #savedNamesToBuckets = {};
+  byteSize() {
+    return 0; // EventAggregator does not currently track byte size like EventBuffer does, but will in a future update. This is a placeholder to maintain interface consistency.
+  }
   isEmpty({
     aggregatorTypes
   }) {

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

@@ -42,6 +42,10 @@ const RuntimeModel = {
   releaseIds: {},
   session: undefined,
   timeKeeper: undefined,
+  /** a proxy is set in agent-session to track jsAttributes changes for harvesting mechanics */
+  jsAttributesMetadata: {
+    bytes: 0
+  },
   get harvestCount() {
     return ++_harvestCount;
   }

package/dist/cjs/common/constants/agent-constants.js

@@ -8,6 +8,6 @@ exports.MAX_PAYLOAD_SIZE = exports.IDEAL_PAYLOAD_SIZE = exports.DEFAULT_KEY = vo
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-const IDEAL_PAYLOAD_SIZE = exports.IDEAL_PAYLOAD_SIZE = 64000;
+const IDEAL_PAYLOAD_SIZE = exports.IDEAL_PAYLOAD_SIZE = 16000;
 const MAX_PAYLOAD_SIZE = exports.MAX_PAYLOAD_SIZE = 1000000;
 const DEFAULT_KEY = exports.DEFAULT_KEY = 'NR_CONTAINER_AGENT';

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

@@ -17,7 +17,7 @@ exports.VERSION = exports.RRWEB_VERSION = exports.DIST_METHOD = exports.BUILD_EN
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.293.0";
+const VERSION = exports.VERSION = "1.294.0-rc.0";
 
 /**
  * Exposes the build type of the agent

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

@@ -17,7 +17,7 @@ exports.VERSION = exports.RRWEB_VERSION = exports.DIST_METHOD = exports.BUILD_EN
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.293.0";
+const VERSION = exports.VERSION = "1.294.0-rc.0";
 
 /**
  * Exposes the build type of the agent

package/dist/cjs/common/event-emitter/contextual-ee.js

@@ -87,12 +87,13 @@ function ee(old, debugId) {
     if (old && bubble) old.emit(type, args, contextOrStore);
     var ctx = context(contextOrStore);
     var handlersArray = listeners(type);
-    var len = handlersArray.length;
 
     // Apply each handler function in the order they were added
     // to the context with the arguments
 
-    for (var i = 0; i < len; i++) handlersArray[i].apply(ctx, args);
+    handlersArray.forEach(handler => {
+      handler.apply(ctx, args);
+    });
 
     // Buffer after emitting for consistent ordering
     var bufferGroup = getBuffer()[bufferGroupMap[type]];

package/dist/cjs/common/url/clean-url.js

@@ -14,10 +14,11 @@ var patternWithoutHash = /([^?#]*)().*/;
 
 /**
  * Cleans a URL by removing the query string and fragment (hash portion).
- * @param {string} url - The original URL to be cleaned.
+ * @param {string} [url] - The original URL to be cleaned.
  * @param {boolean} [keepHash=false] - Whether to preserve the hash portion of the URL.
  * @returns {string} The cleaned URL.
  */
 function cleanURL(url, keepHash) {
+  if (!url) return url;
   return url.replace(keepHash ? patternWithHash : patternWithoutHash, '$1$2');
 }

package/dist/cjs/common/util/attribute-size.js

@@ -0,0 +1,31 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.trackObjectAttributeSize = trackObjectAttributeSize;
+var _stringify = require("./stringify");
+/**
+ * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+function trackObjectAttributeSize(parent, object) {
+  const originalAttribute = parent[object] ??= {};
+  const output = {
+    bytes: Object.keys(originalAttribute).reduce((acc, key) => acc + key.length + (0, _stringify.stringify)(originalAttribute[key]).length, 0)
+  };
+  // proxy attribute to calculate its size when changed
+  parent[object] = new Proxy(originalAttribute, {
+    set(target, prop, value) {
+      output.bytes += prop.length + (0, _stringify.stringify)(value).length;
+      target[prop] = value;
+      return true;
+    },
+    deleteProperty(target, prop) {
+      output.bytes -= prop.length + (0, _stringify.stringify)(target[prop]).length;
+      return delete target[prop];
+    }
+  });
+  return output;
+}

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

@@ -25,6 +25,12 @@ class Aggregate extends _aggregateBase.AggregateBase {
     (0, _denyList.setDenyList)(agentRef.runtime.denyList);
     this.underSpaEvents = {};
     const classThis = this;
+    if (!agentRef.init.ajax.block_internal) {
+      // if the agent is tracking ITSELF, it can spawn endless ajax requests early if they are large from custom attributes, so we just disable early harvest for ajax in this case.
+      super.canHarvestEarly = false;
+    } else {
+      super.customAttributesAreSeparate = true;
+    }
 
     // --- v Used by old spa feature
     this.ee.on('interactionDone', (interaction, wasSaved) => {

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

@@ -12,7 +12,6 @@ var _aggregateBase = require("../../utils/aggregate-base");
 var _console = require("../../../common/util/console");
 var _now = require("../../../common/timing/now");
 var _registerHandler = require("../../../common/event-emitter/register-handler");
-var _constants2 = require("../../metrics/constants");
 var _traverse = require("../../../common/util/traverse");
 var _userActionsAggregator = require("./user-actions/user-actions-aggregator");
 var _iframe = require("../../../common/dom/iframe");
@@ -26,7 +25,6 @@ class Aggregate extends _aggregateBase.AggregateBase {
   static featureName = _constants.FEATURE_NAME;
   constructor(agentRef) {
     super(agentRef, _constants.FEATURE_NAME);
-    this.eventsPerHarvest = 1000;
     this.referrerUrl = _runtime.isBrowserScope && document.referrer ? (0, _cleanUrl.cleanURL)(document.referrer) : undefined;
     this.waitForFlags(['ins']).then(([ins]) => {
       if (!ins) {
@@ -284,18 +282,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
       /** Event-specific attributes take precedence over agent-level custom attributes and fallbacks */
       ...obj
     };
-    const addedEvent = this.events.add(eventAttributes, targetEntityGuid);
-    if (!addedEvent && !this.events.isEmpty(undefined, targetEntityGuid)) {
-      /** could not add the event because it pushed the buffer over the limit
-       * so we harvest early, and try to add it again now that the buffer is cleared
-       * if it fails again, we do nothing
-       */
-      this.ee.emit(_constants2.SUPPORTABILITY_METRIC_CHANNEL, ['GenericEvents/Harvest/Max/Seen']);
-      this.agentRef.runtime.harvester.triggerHarvestFor(this, {
-        targetEntityGuid
-      });
-      this.events.add(eventAttributes);
-    }
+    this.events.add(eventAttributes, targetEntityGuid);
   }
   serializer(eventBuffer) {
     return (0, _traverse.applyFnToProps)({

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

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.RESERVED_EVENT_TYPES = exports.RAGE_CLICK_THRESHOLD_MS = exports.RAGE_CLICK_THRESHOLD_EVENTS = exports.OBSERVED_WINDOW_EVENTS = exports.OBSERVED_EVENTS = exports.MAX_PAYLOAD_SIZE = exports.IDEAL_PAYLOAD_SIZE = exports.FEATURE_NAME = exports.FEATURE_FLAGS = void 0;
+exports.RESERVED_EVENT_TYPES = exports.RAGE_CLICK_THRESHOLD_MS = exports.RAGE_CLICK_THRESHOLD_EVENTS = exports.OBSERVED_WINDOW_EVENTS = exports.OBSERVED_EVENTS = exports.FEATURE_NAME = exports.FEATURE_FLAGS = void 0;
 var _features = require("../../loaders/features/features");
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
@@ -11,8 +11,6 @@ var _features = require("../../loaders/features/features");
  */
 
 const FEATURE_NAME = exports.FEATURE_NAME = _features.FEATURE_NAMES.genericEvents;
-const IDEAL_PAYLOAD_SIZE = exports.IDEAL_PAYLOAD_SIZE = 64000;
-const MAX_PAYLOAD_SIZE = exports.MAX_PAYLOAD_SIZE = 1000000;
 const OBSERVED_EVENTS = exports.OBSERVED_EVENTS = ['auxclick', 'click', 'copy', 'keydown', 'paste', 'scrollend'];
 const OBSERVED_WINDOW_EVENTS = exports.OBSERVED_WINDOW_EVENTS = ['focus', 'blur'];
 const RAGE_CLICK_THRESHOLD_EVENTS = exports.RAGE_CLICK_THRESHOLD_EVENTS = 4;

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

@@ -12,7 +12,6 @@ var _constants = require("../constants");
 var _log = require("../shared/log");
 var _utils = require("../shared/utils");
 var _traverse = require("../../../common/util/traverse");
-var _agentConstants = require("../../../common/constants/agent-constants");
 var _target = require("../../../common/util/target");
 var _constants2 = require("../../../common/session/constants");
 var _constants3 = require("../../session_replay/constants");
@@ -27,6 +26,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
   constructor(agentRef) {
     super(agentRef, _constants.FEATURE_NAME);
     this.isSessionTrackingEnabled = (0, _featureGates.canEnableSessionTracking)(agentRef.init) && agentRef.runtime.session;
+    super.customAttributesAreSeparate = true;
 
     // The SessionEntity class can emit a message indicating the session was cleared and reset (expiry, inactivity). This feature must abort and never resume if that occurs.
     this.ee.on(_constants2.SESSION_EVENTS.RESET, () => {
@@ -90,28 +90,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     }
     if (typeof message !== 'string' || !message) return (0, _console.warn)(32);
     const log = new _log.Log(Math.floor(this.agentRef.runtime.timeKeeper.correctRelativeTimestamp(timestamp)), message, attributes, level);
-    const logBytes = log.message.length + (0, _stringify.stringify)(log.attributes).length + log.level.length + 10; // timestamp == 10 chars
-
-    const failToHarvestMessage = 'Logging/Harvest/Failed/Seen';
-    if (logBytes > _agentConstants.MAX_PAYLOAD_SIZE) {
-      // cannot possibly send this, even with an empty buffer
-      this.reportSupportabilityMetric(failToHarvestMessage, logBytes);
-      (0, _console.warn)(31, log.message.slice(0, 25) + '...');
-      return;
-    }
-    if (this.events.wouldExceedMaxSize(logBytes, targetEntityGuid)) {
-      this.reportSupportabilityMetric('Logging/Harvest/Early/Seen', this.events.byteSize() + logBytes);
-      this.agentRef.runtime.harvester.triggerHarvestFor(this, {
-        targetEntityGuid
-      }); // force a harvest synchronously to try adding again
-    }
-    if (!this.events.add(log, targetEntityGuid)) {
-      // still failed after a harvest attempt despite not being too large would mean harvest failed with options.retry
-      this.reportSupportabilityMetric(failToHarvestMessage, logBytes);
-      (0, _console.warn)(31, log.message.slice(0, 25) + '...');
-    } else {
-      this.reportSupportabilityMetric('Logging/Event/Added/Seen');
-    }
+    this.events.add(log, targetEntityGuid);
   }
   serializer(eventBuffer, targetEntityGuid) {
     const target = this.agentRef.runtime.entityManager.get(targetEntityGuid);

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

@@ -38,6 +38,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     super(agentRef, _constants.FEATURE_NAME);
     this.curSessEndRecorded = false;
     this.firstIxnRecorded = false;
+    super.customAttributesAreSeparate = true;
     (0, _registerHandler.registerHandler)('docHidden', msTimestamp => this.endCurrentSession(msTimestamp), this.featureName, this.ee);
     // Add the time of _window pagehide event_ firing to the next PVT harvest == NRDB windowUnload attr:
     (0, _registerHandler.registerHandler)('winPagehide', msTimestamp => this.addTiming('unload', msTimestamp, null), this.featureName, this.ee);
@@ -139,6 +140,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
 
   // serialize array of timing data
   serializer(eventBuffer) {
+    if (!eventBuffer?.length) return '';
     var addString = (0, _belSerializer.getAddStringContext)(this.agentRef.runtime.obfuscator);
     var payload = 'bel.6;';
     for (var i = 0; i < eventBuffer.length; i++) {

package/dist/cjs/features/soft_navigations/aggregate/ajax-node.js

@@ -13,8 +13,8 @@ var _belNode = require("./bel-node");
  */
 
 class AjaxNode extends _belNode.BelNode {
-  constructor(agentRef, ajaxEvent) {
-    super(agentRef);
+  constructor(ajaxEvent) {
+    super();
     this.belType = _constants.NODE_TYPE.AJAX;
     this.method = ajaxEvent.method;
     this.status = ajaxEvent.status;
@@ -30,8 +30,8 @@ class AjaxNode extends _belNode.BelNode {
     this.start = ajaxEvent.startTime; // 5000 --- 5500 --> 10500
     this.end = ajaxEvent.endTime;
   }
-  serialize(parentStartTimestamp) {
-    const addString = (0, _belSerializer.getAddStringContext)(this.obfuscator);
+  serialize(parentStartTimestamp, agentRef) {
+    const addString = (0, _belSerializer.getAddStringContext)(agentRef.runtime.obfuscator);
     const nodeList = [];
 
     // IMPORTANT: The order in which addString is called matters and correlates to the order in which string shows up in the harvest payload. Do not re-order the following code.

package/dist/cjs/features/soft_navigations/aggregate/bel-node.js

@@ -18,10 +18,6 @@ class BelNode {
   callbackEnd = 0;
   callbackDuration = 0;
   nodeId = ++nodesSeen;
-  constructor(agentRef) {
-    this.obfuscator = agentRef.runtime.obfuscator;
-    this.info = agentRef.info;
-  }
   addChild(child) {
     this.children.push(child);
   }

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

@@ -25,6 +25,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     domObserver
   }) {
     super(agentRef, _constants.FEATURE_NAME);
+    super.customAttributesAreSeparate = true;
     this.interactionsToHarvest = this.events;
     this.domObserver = domObserver;
     this.initialPageLoadInteraction = new _initialPageLoadInteraction.InitialPageLoadInteraction(agentRef);
@@ -33,7 +34,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
       if (agentRef.runtime.session?.isNew) this.initialPageLoadInteraction.customAttributes.isFirstOfSession = true; // mark the hard page load as first of its session
       this.initialPageLoadInteraction.forceSave = true; // unless forcibly ignored, iPL always finish by default
       const ixn = this.initialPageLoadInteraction;
-      this.interactionsToHarvest.add(ixn);
+      this.events.add(ixn); // add the iPL ixn to the buffer for harvest
       this.initialPageLoadInteraction = null;
     });
     _timeToFirstByte.timeToFirstByte.subscribe(({
@@ -80,7 +81,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     let firstIxnStartTime;
     const serializedIxnList = [];
     for (const interaction of eventBuffer) {
-      serializedIxnList.push(interaction.serialize(firstIxnStartTime));
+      serializedIxnList.push(interaction.serialize(firstIxnStartTime, this.agentRef));
       if (firstIxnStartTime === undefined) firstIxnStartTime = Math.floor(interaction.start); // careful not to match or overwrite on 0 value!
     }
     return "bel.7;".concat(serializedIxnList.join(';'));
@@ -91,7 +92,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     if (this.interactionInProgress?.done() === false) return; // current in-progress is blocked from closing, e.g. by 'waitForEnd' api option
 
     const oldURL = eventName === _constants.INTERACTION_TRIGGERS[3] ? this.latestHistoryUrl : undefined; // see related comment in 'newURL' handler above, 'popstate'
-    this.interactionInProgress = new _interaction.Interaction(this.agentRef, eventName, startedAt, this.latestRouteSetByApi, oldURL);
+    this.interactionInProgress = new _interaction.Interaction(eventName, startedAt, this.latestRouteSetByApi, oldURL);
     if (eventName === _constants.INTERACTION_TRIGGERS[0]) {
       // 'click'
       const sourceElemText = getActionText(sourceElem);
@@ -107,7 +108,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
   setClosureHandlers() {
     this.interactionInProgress.on('finished', () => {
       const ref = this.interactionInProgress;
-      this.interactionsToHarvest.add(this.interactionInProgress);
+      this.events.add(this.interactionInProgress); // add the ixn to the buffer for harvest
       this.interactionInProgress = null;
       this.domObserver.disconnect(); // can stop observing whenever our interaction logic completes a cycle
 
@@ -134,9 +135,8 @@ class Aggregate extends _aggregateBase.AggregateBase {
     */
     if (this.interactionInProgress?.isActiveDuring(timestamp)) return this.interactionInProgress;
     let saveIxn;
-    const [{
-      data: interactionsBuffer
-    }] = this.interactionsToHarvest.get();
+    const interactionsBuffer = this.interactionsToHarvest.get()?.[0]?.data;
+    if (!interactionsBuffer) return undefined; // no interactions have been staged yet, so nothing to search through)
     for (let idx = interactionsBuffer.length - 1; idx >= 0; idx--) {
       // reverse search for the latest completed interaction for efficiency
       const finishedInteraction = interactionsBuffer[idx];
@@ -161,15 +161,15 @@ class Aggregate extends _aggregateBase.AggregateBase {
       // no interaction was happening when this ajax started, so give it back to Ajax feature for processing
       (0, _handle.handle)('returnAjax', [event], undefined, _features.FEATURE_NAMES.ajax, this.ee);
     } else {
-      if (associatedInteraction.status === _constants.INTERACTION_STATUS.FIN) processAjax(this.agentRef, event, associatedInteraction); // tack ajax onto the ixn object awaiting harvest
+      if (associatedInteraction.status === _constants.INTERACTION_STATUS.FIN) processAjax(event, associatedInteraction); // tack ajax onto the ixn object awaiting harvest
       else {
         // same thing as above, just at a later time -- if the interaction in progress is cancelled, just send the event back to ajax feat unmodified
-        associatedInteraction.on('finished', () => processAjax(this.agentRef, event, associatedInteraction));
+        associatedInteraction.on('finished', () => processAjax(event, associatedInteraction));
         associatedInteraction.on('cancelled', () => (0, _handle.handle)('returnAjax', [event], undefined, _features.FEATURE_NAMES.ajax, this.ee));
       }
     }
-    function processAjax(agent, event, parentInteraction) {
-      const newNode = new _ajaxNode.AjaxNode(agent, event);
+    function processAjax(event, parentInteraction) {
+      const newNode = new _ajaxNode.AjaxNode(event);
       parentInteraction.addChild(newNode);
     }
   }
@@ -208,7 +208,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
       if (this.associatedInteraction?.trigger === _constants.IPL_TRIGGER_NAME) this.associatedInteraction = null; // the api get-interaction method cannot target IPL
       if (!this.associatedInteraction) {
         // This new api-driven interaction will be the target of any subsequent .interaction() call, until it is closed by EITHER .end() OR the regular seenHistoryAndDomChange process.
-        this.associatedInteraction = thisClass.interactionInProgress = new _interaction.Interaction(thisClass.agentRef, _constants.API_TRIGGER_NAME, time, thisClass.latestRouteSetByApi);
+        this.associatedInteraction = thisClass.interactionInProgress = new _interaction.Interaction(_constants.API_TRIGGER_NAME, time, thisClass.latestRouteSetByApi);
         thisClass.domObserver.observe(document.body, {
           attributes: true,
           childList: true,

package/dist/cjs/features/soft_navigations/aggregate/initial-page-load-interaction.js

@@ -17,10 +17,11 @@ var _constants = require("../constants");
 
 class InitialPageLoadInteraction extends _interaction.Interaction {
   constructor(agentRef) {
-    super(agentRef, _constants.IPL_TRIGGER_NAME, 0, null);
+    super(_constants.IPL_TRIGGER_NAME, 0, null);
     this.queueTime = agentRef.info.queueTime;
     this.appTime = agentRef.info.applicationTime;
-    this.oldURL = document.referrer;
+    /** @type {string|undefined} we assign as undefined if no referrer value is available so that URL grouping is not applied to an empty string at ingest */
+    this.oldURL = document.referrer || undefined;
   }
   get firstPaint() {
     return _firstPaint.firstPaint.current.value;

package/dist/cjs/features/soft_navigations/aggregate/interaction.js

@@ -36,8 +36,8 @@ class Interaction extends _belNode.BelNode {
   keepOpenUntilEndApi = false;
   onDone = [];
   cancellationTimer;
-  constructor(agentRef, uiEvent, uiEventTimestamp, currentRouteKnown, currentUrl) {
-    super(agentRef);
+  constructor(uiEvent, uiEventTimestamp, currentRouteKnown, currentUrl) {
+    super();
     this.belType = _constants.NODE_TYPE.INTERACTION;
     this.trigger = uiEvent;
     this.start = uiEventTimestamp;
@@ -78,10 +78,6 @@ class Interaction extends _belNode.BelNode {
   #finish(customEndTime = 0) {
     clearTimeout(this.cancellationTimer);
     this.end = Math.max(this.domTimestamp, this.historyTimestamp, customEndTime);
-    this.customAttributes = {
-      ...this.info.jsAttributes,
-      ...this.customAttributes
-    }; // attrs specific to this interaction should have precedence over the general custom attrs
     this.status = _constants.INTERACTION_STATUS.FIN;
 
     // Run all the callbacks awaiting this interaction to finish.
@@ -112,9 +108,16 @@ class Interaction extends _belNode.BelNode {
   get firstPaint() {}
   get firstContentfulPaint() {}
   get navTiming() {}
-  serialize(firstStartTimeOfPayload) {
+
+  /**
+   * Serializes (BEL) the interaction data for transmission.
+   * @param {Number} firstStartTimeOfPayload timestamp
+   * @param {Agent} agentRef Pass in the agent reference directly so that the event itself doesnt need to store the pointers and ruin the evaluation of the event size by including unused object references.
+   * @returns {String} A string that is the serialized representation of this interaction.
+   */
+  serialize(firstStartTimeOfPayload, agentRef) {
     const isFirstIxnOfPayload = firstStartTimeOfPayload === undefined;
-    const addString = (0, _belSerializer.getAddStringContext)(this.obfuscator);
+    const addString = (0, _belSerializer.getAddStringContext)(agentRef.runtime.obfuscator);
     const nodeList = [];
     let ixnType;
     if (this.trigger === _constants.IPL_TRIGGER_NAME) ixnType = _constants.INTERACTION_TYPE.INITIAL_PAGE_LOAD;else if (this.newURL !== this.oldURL) ixnType = _constants.INTERACTION_TYPE.ROUTE_CHANGE;else ixnType = _constants.INTERACTION_TYPE.UNSPECIFIED;
@@ -131,12 +134,16 @@ class Interaction extends _belNode.BelNode {
     (0, _belSerializer.numeric)(this.callbackDuration),
     // not relative
     addString(this.trigger), addString((0, _cleanUrl.cleanURL)(this.initialPageURL, true)), addString((0, _cleanUrl.cleanURL)(this.oldURL, true)), addString((0, _cleanUrl.cleanURL)(this.newURL, true)), addString(this.customName), ixnType, (0, _belSerializer.nullable)(this.queueTime, _belSerializer.numeric, true) + (0, _belSerializer.nullable)(this.appTime, _belSerializer.numeric, true) + (0, _belSerializer.nullable)(this.oldRoute, addString, true) + (0, _belSerializer.nullable)(this.newRoute, addString, true) + addString(this.id), addString(this.nodeId), (0, _belSerializer.nullable)(this.firstPaint, _belSerializer.numeric, true) + (0, _belSerializer.nullable)(this.firstContentfulPaint, _belSerializer.numeric)];
-    const allAttachedNodes = (0, _belSerializer.addCustomAttributes)(this.customAttributes || {}, addString); // start with all custom attributes
-    if (this.info.atts) allAttachedNodes.push('a,' + addString(this.info.atts)); // add apm provided attributes
+    const customAttributes = {
+      ...agentRef.info.jsAttributes,
+      ...this.customAttributes
+    }; // attrs specific to this interaction should have precedence over the general custom attrs
+    const allAttachedNodes = (0, _belSerializer.addCustomAttributes)(customAttributes || {}, addString); // start with all custom attributes
+    if (agentRef.info.atts) allAttachedNodes.push('a,' + addString(agentRef.info.atts)); // add apm provided attributes
     /* Querypack encoder+decoder quirkiness:
        - If first ixn node of payload is being processed, its children's start time must be offset by this node's start. (firstStartTime should be undefined.)
        - Else for subsequent ixns in the same payload, we go back to using that first ixn node's start to offset their children's start. */
-    this.children.forEach(node => allAttachedNodes.push(node.serialize(isFirstIxnOfPayload ? this.start : firstStartTimeOfPayload))); // recursively add the serialized string of every child of this (ixn) bel node
+    this.children.forEach(node => allAttachedNodes.push(node.serialize(isFirstIxnOfPayload ? this.start : firstStartTimeOfPayload, agentRef))); // recursively add the serialized string of every child of this (ixn) bel node
 
     fields[1] = (0, _belSerializer.numeric)(allAttachedNodes.length);
     nodeList.push(fields);

package/dist/cjs/features/spa/aggregate/interaction.js

@@ -34,7 +34,7 @@ function Interaction(eventName, timestamp, url, routeName, onFinished, agentRef)
   attrs.initialPageURL = _runtime.initialLocation;
   attrs.oldRoute = routeName;
   attrs.newURL = url;
-  attrs.oldURL = eventName === 'initialPageLoad' ? document.referrer : url;
+  attrs.oldURL = eventName === 'initialPageLoad' ? document.referrer || undefined : url; // document referrer can return '' and flipper url grouping gets weird with empty strings. Pass undefined to skip flipper.
   attrs.custom = {};
   attrs.store = {};
 }

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

@@ -10,6 +10,8 @@ var _registerHandler = require("../../common/event-emitter/register-handler");
 var _sessionEntity = require("../../common/session/session-entity");
 var _localStorage = require("../../common/storage/local-storage.js");
 var _constants = require("../../common/session/constants");
+var _info = require("../../common/config/info");
+var _attributeSize = require("../../common/util/attribute-size");
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -29,13 +31,19 @@ function setupAgentSession(agentRef) {
 
   // Retrieve & re-add all of the persisted setCustomAttribute|setUserId k-v from previous page load(s), if any was stored.
   const customSessionData = agentRef.runtime.session.state.custom;
-  if (customSessionData) {
+  if (customSessionData && Object.keys(customSessionData).length) {
     /** stored attributes from previous page should not take precedence over attributes stored on this page via API before the page load */
-    agentRef.info.jsAttributes = {
-      ...customSessionData,
-      ...agentRef.info.jsAttributes
-    };
+    agentRef.info = (0, _info.mergeInfo)({
+      ...agentRef.info,
+      jsAttributes: {
+        ...customSessionData,
+        ...agentRef.info.jsAttributes
+      }
+    });
   }
+
+  /** track changes to the jsAttributes field over time for aiding with harvest mechanics */
+  agentRef.runtime.jsAttributesMetadata = (0, _attributeSize.trackObjectAttributeSize)(agentRef.info, 'jsAttributes');
   const sharedEE = _contextualEe.ee.get(agentRef.agentIdentifier);
 
   // any calls to newrelic.setCustomAttribute(<persisted>) will need to be added to:

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

@@ -20,6 +20,7 @@ var _eventBuffer = require("./event-buffer");
 var _handle = require("../../common/event-emitter/handle");
 var _constants = require("../metrics/constants");
 var _eventAggregator = require("../../common/aggregate/event-aggregator");
+var _agentConstants = require("../../common/constants/agent-constants");
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -36,6 +37,12 @@ class AggregateBase extends _featureBase.FeatureBase {
     this.agentRef = agentRef;
     this.checkConfiguration(agentRef);
     this.doOnceForAllAggregate(agentRef);
+
+    /** @type {Boolean} indicates if custom attributes are combined in each event payload for size estimation purposes. this is set to true in derived classes that need to evaluate custom attributes separately from the event payload */
+    this.customAttributesAreSeparate = false;
+    /** @type {Boolean} indicates if the feature can harvest early. This is set to false in derived classes that need to block early harvests, like ajax under certain conditions */
+    this.canHarvestEarly = true; // this is set to false in derived classes that need to block early harvests, like ajax under certain conditions
+
     this.harvestOpts = {}; // features aggregate classes can define custom opts for when their harvest is called
 
     const agentEntityGuid = this.agentRef?.runtime?.appMetadata?.agents?.[0]?.entityGuid;
@@ -65,17 +72,33 @@ class AggregateBase extends _featureBase.FeatureBase {
       // Jserror and Metric features uses a singleton EventAggregator instead of a regular EventBuffer.
       case _features.FEATURE_NAMES.jserrors:
       case _features.FEATURE_NAMES.metrics:
-        this.events = this.agentRef.sharedAggregator ??= new _eventStoreManager.EventStoreManager(this.agentRef, _eventAggregator.EventAggregator, entityGuid, 'shared_aggregator');
+        this.events = this.agentRef.sharedAggregator ??= new _eventStoreManager.EventStoreManager(this.agentRef, _eventAggregator.EventAggregator, entityGuid, {
+          featureName: 'shared_aggregator'
+        });
         break;
       /** All other features get EventBuffer in the ESM by default. Note: PVE is included here, but event buffer will always be empty so future harvests will still not happen by interval or EOL.
       This was necessary to prevent race cond. issues where the event buffer was checked before the feature could "block" itself.
       Its easier to just keep an empty event buffer in place. */
       default:
-        this.events = new _eventStoreManager.EventStoreManager(this.agentRef, _eventBuffer.EventBuffer, entityGuid, this.featureName);
+        this.events = new _eventStoreManager.EventStoreManager(this.agentRef, _eventBuffer.EventBuffer, entityGuid, this);
         break;
     }
   }
 
+  /**
+   * Evaluates whether a harvest should be made early by estimating the size of the current payload.  Currently, this only happens if the event storage is EventBuffer, since that triggers this method directly.
+   * If conditions are met, a new harvest will be triggered immediately.
+   * @returns void
+   */
+  decideEarlyHarvest() {
+    if (!this.canHarvestEarly) return;
+    const estimatedSize = this.events.byteSize() + (this.customAttributesAreSeparate ? this.agentRef.runtime.jsAttributesMetadata.bytes : 0);
+    if (estimatedSize > _agentConstants.IDEAL_PAYLOAD_SIZE) {
+      this.agentRef.runtime.harvester.triggerHarvestFor(this);
+      this.reportSupportabilityMetric("".concat(this.featureName, "/Harvest/Early/Seen"), estimatedSize);
+    }
+  }
+
   /**
    * New handler for waiting for multiple flags. Useful when expecting multiple flags simultaneously (ex. stn vs sr)
    * @param {string[]} flagNames

package/dist/cjs/features/utils/event-buffer.js

@@ -18,10 +18,13 @@ class EventBuffer {
   #rawBytesBackup;
 
   /**
-   * @param {number} maxPayloadSize
+   * Creates an event buffer that can hold feature-processed events.
+   * @param {Number} maxPayloadSize The maximum size of the payload that can be stored in this buffer.
+   * @param {Object} [featureAgg] - the feature aggregate instance
    */
-  constructor(maxPayloadSize = _agentConstants.MAX_PAYLOAD_SIZE) {
+  constructor(maxPayloadSize = _agentConstants.MAX_PAYLOAD_SIZE, featureAgg) {
     this.maxPayloadSize = maxPayloadSize;
+    this.featureAgg = featureAgg;
   }
   isEmpty() {
     return this.#buffer.length === 0;
@@ -43,9 +46,15 @@ class EventBuffer {
    */
   add(event) {
     const addSize = (0, _stringify.stringify)(event)?.length || 0; // (estimate) # of bytes a directly stringified event it would take to send
-    if (this.#rawBytes + addSize > this.maxPayloadSize) return false;
+    if (this.#rawBytes + addSize > this.maxPayloadSize) {
+      const smTag = inject => "EventBuffer/".concat(inject, "/Dropped/Bytes");
+      this.featureAgg?.reportSupportabilityMetric(smTag(this.featureAgg.featureName), addSize); // bytes dropped for this feature will aggregate with this metric tag
+      this.featureAgg?.reportSupportabilityMetric(smTag('Combined'), addSize); // all bytes dropped across all features will aggregate with this metric tag
+      return false;
+    }
     this.#buffer.push(event);
     this.#rawBytes += addSize;
+    this.featureAgg?.decideEarlyHarvest(); // check if we should harvest early with new data
     return true;
   }
 

package/dist/cjs/features/utils/event-store-manager.js

@@ -22,14 +22,14 @@ class EventStoreManager {
    * @param {object} agentRef - reference to base agent class
    * @param {EventBuffer|EventAggregator} storageClass - the type of storage to use in this manager; 'EventBuffer' (1), 'EventAggregator' (2)
    * @param {string} [defaultEntityGuid] - the entity guid to use as the default storage instance; if not provided, a new one is created
-   * @param {string} featureName - the name of the feature this manager is for; used for event dispatching
+   * @param {Object} featureAgg - the feature aggregate instance that initialized this manager
    */
-  constructor(agentRef, storageClass, defaultEntityGuid, featureName) {
+  constructor(agentRef, storageClass, defaultEntityGuid, featureAgg) {
     this.agentRef = agentRef;
     this.entityManager = agentRef.runtime.entityManager;
     this.StorageClass = storageClass;
-    this.appStorageMap = new Map([[_agentConstants.DEFAULT_KEY, new this.StorageClass()]]);
-    this.featureName = featureName;
+    this.appStorageMap = new Map([[_agentConstants.DEFAULT_KEY, new this.StorageClass(_agentConstants.MAX_PAYLOAD_SIZE, featureAgg)]]);
+    this.featureAgg = featureAgg;
     this.setEventStore(defaultEntityGuid);
   }
 
@@ -46,7 +46,7 @@ class EventStoreManager {
     /** we should already have an event store for the default */
     if (!targetEntityGuid) return;
     /** if the target is the container agent, SHARE the default storage -- otherwise create a new event store */
-    const eventStorage = (0, _target.isContainerAgentTarget)(this.entityManager.get(targetEntityGuid), this.agentRef) ? this.appStorageMap.get(_agentConstants.DEFAULT_KEY) : new this.StorageClass();
+    const eventStorage = (0, _target.isContainerAgentTarget)(this.entityManager.get(targetEntityGuid), this.agentRef) ? this.appStorageMap.get(_agentConstants.DEFAULT_KEY) : new this.StorageClass(_agentConstants.MAX_PAYLOAD_SIZE, this.featureAgg);
     this.appStorageMap.set(targetEntityGuid, eventStorage);
   }
 
@@ -78,7 +78,7 @@ class EventStoreManager {
       drained: !!_featureFlags.activatedFeatures?.[this.agentRef.agentIdentifier],
       type: 'data',
       name: 'buffer',
-      feature: this.featureName,
+      feature: this.featureAgg.featureName,
       data: event
     });
     return this.#getEventStore(targetEntityGuid).add(event);