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

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

@@ -11,6 +11,9 @@ import { Aggregator } from './aggregator';
 export class EventAggregator {
   #aggregator = new 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/esm/common/config/runtime.js

@@ -36,6 +36,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/esm/common/constants/agent-constants.js

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

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

@@ -11,7 +11,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.293.0";
+export const VERSION = "1.294.0-rc.0";
 
 /**
  * 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.293.0";
+export const VERSION = "1.294.0-rc.0";
 
 /**
  * Exposes the build type of the agent

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

@@ -83,12 +83,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/esm/common/url/clean-url.js

@@ -8,10 +8,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.
  */
 export function cleanURL(url, keepHash) {
+  if (!url) return url;
   return url.replace(keepHash ? patternWithHash : patternWithoutHash, '$1$2');
 }

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

@@ -0,0 +1,24 @@
+/**
+ * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { stringify } from './stringify';
+export function trackObjectAttributeSize(parent, object) {
+  const originalAttribute = parent[object] ??= {};
+  const output = {
+    bytes: Object.keys(originalAttribute).reduce((acc, key) => acc + key.length + 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 + stringify(value).length;
+      target[prop] = value;
+      return true;
+    },
+    deleteProperty(target, prop) {
+      output.bytes -= prop.length + stringify(target[prop]).length;
+      return delete target[prop];
+    }
+  });
+  return output;
+}

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

@@ -18,6 +18,12 @@ export class Aggregate extends AggregateBase {
     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/esm/features/generic_events/aggregate/index.js

@@ -10,7 +10,6 @@ import { AggregateBase } from '../../utils/aggregate-base';
 import { warn } from '../../../common/util/console';
 import { now } from '../../../common/timing/now';
 import { registerHandler } from '../../../common/event-emitter/register-handler';
-import { SUPPORTABILITY_METRIC_CHANNEL } from '../../metrics/constants';
 import { applyFnToProps } from '../../../common/util/traverse';
 import { UserActionsAggregator } from './user-actions/user-actions-aggregator';
 import { isIFrameWindow } from '../../../common/dom/iframe';
@@ -19,7 +18,6 @@ export class Aggregate extends AggregateBase {
   static featureName = FEATURE_NAME;
   constructor(agentRef) {
     super(agentRef, FEATURE_NAME);
-    this.eventsPerHarvest = 1000;
     this.referrerUrl = isBrowserScope && document.referrer ? cleanURL(document.referrer) : undefined;
     this.waitForFlags(['ins']).then(([ins]) => {
       if (!ins) {
@@ -277,18 +275,7 @@ export class Aggregate extends 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(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 applyFnToProps({

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

@@ -4,8 +4,6 @@
  */
 import { FEATURE_NAMES } from '../../loaders/features/features';
 export const FEATURE_NAME = FEATURE_NAMES.genericEvents;
-export const IDEAL_PAYLOAD_SIZE = 64000;
-export const MAX_PAYLOAD_SIZE = 1000000;
 export const OBSERVED_EVENTS = ['auxclick', 'click', 'copy', 'keydown', 'paste', 'scrollend'];
 export const OBSERVED_WINDOW_EVENTS = ['focus', 'blur'];
 export const RAGE_CLICK_THRESHOLD_EVENTS = 4;

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

@@ -10,7 +10,6 @@ import { FEATURE_NAME, LOGGING_EVENT_EMITTER_CHANNEL, LOG_LEVELS, LOGGING_MODE }
 import { Log } from '../shared/log';
 import { isValidLogLevel } from '../shared/utils';
 import { applyFnToProps } from '../../../common/util/traverse';
-import { MAX_PAYLOAD_SIZE } from '../../../common/constants/agent-constants';
 import { isContainerAgentTarget } from '../../../common/util/target';
 import { SESSION_EVENT_TYPES, SESSION_EVENTS } from '../../../common/session/constants';
 import { ABORT_REASONS } from '../../session_replay/constants';
@@ -20,6 +19,7 @@ export class Aggregate extends AggregateBase {
   constructor(agentRef) {
     super(agentRef, FEATURE_NAME);
     this.isSessionTrackingEnabled = 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(SESSION_EVENTS.RESET, () => {
@@ -83,28 +83,7 @@ export class Aggregate extends AggregateBase {
     }
     if (typeof message !== 'string' || !message) return warn(32);
     const log = new Log(Math.floor(this.agentRef.runtime.timeKeeper.correctRelativeTimestamp(timestamp)), message, attributes, level);
-    const logBytes = log.message.length + stringify(log.attributes).length + log.level.length + 10; // timestamp == 10 chars
-
-    const failToHarvestMessage = 'Logging/Harvest/Failed/Seen';
-    if (logBytes > MAX_PAYLOAD_SIZE) {
-      // cannot possibly send this, even with an empty buffer
-      this.reportSupportabilityMetric(failToHarvestMessage, logBytes);
-      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);
-      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/esm/features/page_view_timing/aggregate/index.js

@@ -32,6 +32,7 @@ export class Aggregate extends AggregateBase {
     super(agentRef, FEATURE_NAME);
     this.curSessEndRecorded = false;
     this.firstIxnRecorded = false;
+    super.customAttributesAreSeparate = true;
     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:
     registerHandler('winPagehide', msTimestamp => this.addTiming('unload', msTimestamp, null), this.featureName, this.ee);
@@ -133,6 +134,7 @@ export class Aggregate extends AggregateBase {
 
   // serialize array of timing data
   serializer(eventBuffer) {
+    if (!eventBuffer?.length) return '';
     var addString = getAddStringContext(this.agentRef.runtime.obfuscator);
     var payload = 'bel.6;';
     for (var i = 0; i < eventBuffer.length; i++) {

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

@@ -6,8 +6,8 @@ import { addCustomAttributes, getAddStringContext, nullable, numeric } from '../
 import { NODE_TYPE } from '../constants';
 import { BelNode } from './bel-node';
 export class AjaxNode extends BelNode {
-  constructor(agentRef, ajaxEvent) {
-    super(agentRef);
+  constructor(ajaxEvent) {
+    super();
     this.belType = NODE_TYPE.AJAX;
     this.method = ajaxEvent.method;
     this.status = ajaxEvent.status;
@@ -23,8 +23,8 @@ export class AjaxNode extends BelNode {
     this.start = ajaxEvent.startTime; // 5000 --- 5500 --> 10500
     this.end = ajaxEvent.endTime;
   }
-  serialize(parentStartTimestamp) {
-    const addString = getAddStringContext(this.obfuscator);
+  serialize(parentStartTimestamp, agentRef) {
+    const addString = 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/esm/features/soft_navigations/aggregate/bel-node.js

@@ -12,10 +12,6 @@ export 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/esm/features/soft_navigations/aggregate/index.js

@@ -18,6 +18,7 @@ export class Aggregate extends AggregateBase {
     domObserver
   }) {
     super(agentRef, FEATURE_NAME);
+    super.customAttributesAreSeparate = true;
     this.interactionsToHarvest = this.events;
     this.domObserver = domObserver;
     this.initialPageLoadInteraction = new InitialPageLoadInteraction(agentRef);
@@ -26,7 +27,7 @@ export class Aggregate extends 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.subscribe(({
@@ -73,7 +74,7 @@ export class Aggregate extends 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(';'));
@@ -84,7 +85,7 @@ export class Aggregate extends AggregateBase {
     if (this.interactionInProgress?.done() === false) return; // current in-progress is blocked from closing, e.g. by 'waitForEnd' api option
 
     const oldURL = eventName === INTERACTION_TRIGGERS[3] ? this.latestHistoryUrl : undefined; // see related comment in 'newURL' handler above, 'popstate'
-    this.interactionInProgress = new Interaction(this.agentRef, eventName, startedAt, this.latestRouteSetByApi, oldURL);
+    this.interactionInProgress = new Interaction(eventName, startedAt, this.latestRouteSetByApi, oldURL);
     if (eventName === INTERACTION_TRIGGERS[0]) {
       // 'click'
       const sourceElemText = getActionText(sourceElem);
@@ -100,7 +101,7 @@ export class Aggregate extends 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
 
@@ -127,9 +128,8 @@ export class Aggregate extends 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];
@@ -154,15 +154,15 @@ export class Aggregate extends AggregateBase {
       // no interaction was happening when this ajax started, so give it back to Ajax feature for processing
       handle('returnAjax', [event], undefined, FEATURE_NAMES.ajax, this.ee);
     } else {
-      if (associatedInteraction.status === INTERACTION_STATUS.FIN) processAjax(this.agentRef, event, associatedInteraction); // tack ajax onto the ixn object awaiting harvest
+      if (associatedInteraction.status === 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', () => handle('returnAjax', [event], undefined, FEATURE_NAMES.ajax, this.ee));
       }
     }
-    function processAjax(agent, event, parentInteraction) {
-      const newNode = new AjaxNode(agent, event);
+    function processAjax(event, parentInteraction) {
+      const newNode = new AjaxNode(event);
       parentInteraction.addChild(newNode);
     }
   }
@@ -201,7 +201,7 @@ export class Aggregate extends AggregateBase {
       if (this.associatedInteraction?.trigger === 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(thisClass.agentRef, API_TRIGGER_NAME, time, thisClass.latestRouteSetByApi);
+        this.associatedInteraction = thisClass.interactionInProgress = new Interaction(API_TRIGGER_NAME, time, thisClass.latestRouteSetByApi);
         thisClass.domObserver.observe(document.body, {
           attributes: true,
           childList: true,

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

@@ -10,10 +10,11 @@ import { firstContentfulPaint } from '../../../common/vitals/first-contentful-pa
 import { IPL_TRIGGER_NAME } from '../constants';
 export class InitialPageLoadInteraction extends Interaction {
   constructor(agentRef) {
-    super(agentRef, IPL_TRIGGER_NAME, 0, null);
+    super(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.current.value;

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

@@ -30,8 +30,8 @@ export class Interaction extends BelNode {
   keepOpenUntilEndApi = false;
   onDone = [];
   cancellationTimer;
-  constructor(agentRef, uiEvent, uiEventTimestamp, currentRouteKnown, currentUrl) {
-    super(agentRef);
+  constructor(uiEvent, uiEventTimestamp, currentRouteKnown, currentUrl) {
+    super();
     this.belType = NODE_TYPE.INTERACTION;
     this.trigger = uiEvent;
     this.start = uiEventTimestamp;
@@ -72,10 +72,6 @@ export class Interaction extends 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 = INTERACTION_STATUS.FIN;
 
     // Run all the callbacks awaiting this interaction to finish.
@@ -106,9 +102,16 @@ export class Interaction extends 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 = getAddStringContext(this.obfuscator);
+    const addString = getAddStringContext(agentRef.runtime.obfuscator);
     const nodeList = [];
     let ixnType;
     if (this.trigger === IPL_TRIGGER_NAME) ixnType = INTERACTION_TYPE.INITIAL_PAGE_LOAD;else if (this.newURL !== this.oldURL) ixnType = INTERACTION_TYPE.ROUTE_CHANGE;else ixnType = INTERACTION_TYPE.UNSPECIFIED;
@@ -125,12 +128,16 @@ export class Interaction extends BelNode {
     numeric(this.callbackDuration),
     // not relative
     addString(this.trigger), addString(cleanURL(this.initialPageURL, true)), addString(cleanURL(this.oldURL, true)), addString(cleanURL(this.newURL, true)), addString(this.customName), ixnType, nullable(this.queueTime, numeric, true) + nullable(this.appTime, numeric, true) + nullable(this.oldRoute, addString, true) + nullable(this.newRoute, addString, true) + addString(this.id), addString(this.nodeId), nullable(this.firstPaint, numeric, true) + nullable(this.firstContentfulPaint, numeric)];
-    const allAttachedNodes = 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 = 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] = numeric(allAttachedNodes.length);
     nodeList.push(fields);

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

@@ -27,7 +27,7 @@ export function Interaction(eventName, timestamp, url, routeName, onFinished, ag
   attrs.initialPageURL = 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/esm/features/utils/agent-session.js

@@ -8,6 +8,8 @@ import { registerHandler } from '../../common/event-emitter/register-handler';
 import { SessionEntity } from '../../common/session/session-entity';
 import { LocalStorage } from '../../common/storage/local-storage.js';
 import { DEFAULT_KEY } from '../../common/session/constants';
+import { mergeInfo } from '../../common/config/info';
+import { trackObjectAttributeSize } from '../../common/util/attribute-size';
 export function setupAgentSession(agentRef) {
   if (agentRef.runtime.session) return agentRef.runtime.session; // already setup
 
@@ -22,13 +24,19 @@ export 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 = mergeInfo({
+      ...agentRef.info,
+      jsAttributes: {
+        ...customSessionData,
+        ...agentRef.info.jsAttributes
+      }
+    });
   }
+
+  /** track changes to the jsAttributes field over time for aiding with harvest mechanics */
+  agentRef.runtime.jsAttributesMetadata = trackObjectAttributeSize(agentRef.info, 'jsAttributes');
   const sharedEE = ee.get(agentRef.agentIdentifier);
 
   // any calls to newrelic.setCustomAttribute(<persisted>) will need to be added to:

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

@@ -18,6 +18,7 @@ import { EventBuffer } from './event-buffer';
 import { handle } from '../../common/event-emitter/handle';
 import { SUPPORTABILITY_METRIC_CHANNEL } from '../metrics/constants';
 import { EventAggregator } from '../../common/aggregate/event-aggregator';
+import { IDEAL_PAYLOAD_SIZE } from '../../common/constants/agent-constants';
 export class AggregateBase extends FeatureBase {
   /**
    * Create an AggregateBase instance.
@@ -29,6 +30,12 @@ export class AggregateBase extends 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;
@@ -58,17 +65,33 @@ export class AggregateBase extends FeatureBase {
       // Jserror and Metric features uses a singleton EventAggregator instead of a regular EventBuffer.
       case FEATURE_NAMES.jserrors:
       case FEATURE_NAMES.metrics:
-        this.events = this.agentRef.sharedAggregator ??= new EventStoreManager(this.agentRef, EventAggregator, entityGuid, 'shared_aggregator');
+        this.events = this.agentRef.sharedAggregator ??= new EventStoreManager(this.agentRef, 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(this.agentRef, EventBuffer, entityGuid, this.featureName);
+        this.events = new EventStoreManager(this.agentRef, 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 > 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/esm/features/utils/event-buffer.js

@@ -11,10 +11,13 @@ export 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 = MAX_PAYLOAD_SIZE) {
+  constructor(maxPayloadSize = MAX_PAYLOAD_SIZE, featureAgg) {
     this.maxPayloadSize = maxPayloadSize;
+    this.featureAgg = featureAgg;
   }
   isEmpty() {
     return this.#buffer.length === 0;
@@ -36,9 +39,15 @@ export class EventBuffer {
    */
   add(event) {
     const addSize = 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/esm/features/utils/event-store-manager.js

@@ -2,7 +2,7 @@
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { DEFAULT_KEY } from '../../common/constants/agent-constants';
+import { DEFAULT_KEY, MAX_PAYLOAD_SIZE } from '../../common/constants/agent-constants';
 import { dispatchGlobalEvent } from '../../common/dispatch/global-event';
 import { activatedFeatures } from '../../common/util/feature-flags';
 import { isContainerAgentTarget } from '../../common/util/target';
@@ -15,14 +15,14 @@ export 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([[DEFAULT_KEY, new this.StorageClass()]]);
-    this.featureName = featureName;
+    this.appStorageMap = new Map([[DEFAULT_KEY, new this.StorageClass(MAX_PAYLOAD_SIZE, featureAgg)]]);
+    this.featureAgg = featureAgg;
     this.setEventStore(defaultEntityGuid);
   }
 
@@ -39,7 +39,7 @@ export 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 = isContainerAgentTarget(this.entityManager.get(targetEntityGuid), this.agentRef) ? this.appStorageMap.get(DEFAULT_KEY) : new this.StorageClass();
+    const eventStorage = isContainerAgentTarget(this.entityManager.get(targetEntityGuid), this.agentRef) ? this.appStorageMap.get(DEFAULT_KEY) : new this.StorageClass(MAX_PAYLOAD_SIZE, this.featureAgg);
     this.appStorageMap.set(targetEntityGuid, eventStorage);
   }
 
@@ -71,7 +71,7 @@ export class EventStoreManager {
       drained: !!activatedFeatures?.[this.agentRef.agentIdentifier],
       type: 'data',
       name: 'buffer',
-      feature: this.featureName,
+      feature: this.featureAgg.featureName,
       data: event
     });
     return this.#getEventStore(targetEntityGuid).add(event);