@newrelic/browser-agent 1.323.0-rc.11 → 1.323.0-rc.12

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

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.SUPPORTS_REGISTERED_ENTITIES = exports.SESSION_ERROR = exports.MAX_PAYLOAD_SIZE = exports.IDEAL_PAYLOAD_SIZE = exports.DEFAULT_KEY = void 0;
+exports.SUPPORTS_REGISTERED_ENTITIES = exports.SESSION_ERROR = exports.MIN_EARLY_HARVEST_INTERVAL = exports.MAX_PAYLOAD_SIZE = exports.IDEAL_PAYLOAD_SIZE = exports.EARLY_HARVEST_BYPASS_SIZE = exports.DEFAULT_KEY = void 0;
 var _features = require("../../loaders/features/features");
 /**
  * Copyright 2020-2026 New Relic, Inc. All rights reserved.
@@ -12,6 +12,10 @@ var _features = require("../../loaders/features/features");
 
 const IDEAL_PAYLOAD_SIZE = exports.IDEAL_PAYLOAD_SIZE = 16000;
 const MAX_PAYLOAD_SIZE = exports.MAX_PAYLOAD_SIZE = 1000000;
+/** The minimum time (ms) between early harvests of a single feature. Data that arrives inside this window stays buffered for the next harvest. */
+const MIN_EARLY_HARVEST_INTERVAL = exports.MIN_EARLY_HARVEST_INTERVAL = 500;
+/** The estimated payload size at which a feature may harvest early even inside the minimum interval, so that a flood of data cannot fill the buffer to MAX_PAYLOAD_SIZE (and start dropping events) while waiting. */
+const EARLY_HARVEST_BYPASS_SIZE = exports.EARLY_HARVEST_BYPASS_SIZE = MAX_PAYLOAD_SIZE / 2;
 const DEFAULT_KEY = exports.DEFAULT_KEY = 'NR_CONTAINER_AGENT';
 const SESSION_ERROR = exports.SESSION_ERROR = 'SESSION_ERROR';
 const SUPPORTS_REGISTERED_ENTITIES = exports.SUPPORTS_REGISTERED_ENTITIES = {

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

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

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.trackObjectAttributeSize = trackObjectAttributeSize;
 var _stringify = require("./stringify");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
@@ -18,12 +18,15 @@ function trackObjectAttributeSize(parent, object) {
   // proxy attribute to calculate its size when changed
   parent[object] = new Proxy(originalAttribute, {
     set(target, prop, value) {
+      /* An overwrite replaces the existing entry, so its previous size must be removed first. Otherwise repeated sets of the same key inflate the count far beyond the real size. */
+      if (Object.prototype.hasOwnProperty.call(target, prop)) output.bytes -= prop.length + (0, _stringify.stringify)(target[prop]).length;
       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;
+      /* Deleting a key that was never set removes nothing, so the count must not change. */
+      if (Object.prototype.hasOwnProperty.call(target, prop)) output.bytes -= prop.length + (0, _stringify.stringify)(target[prop]).length;
       return delete target[prop];
     }
   });

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

@@ -13,6 +13,7 @@ var _constants = require("../metrics/constants");
 var _eventAggregator = require("../../common/aggregate/event-aggregator");
 var _agentConstants = require("../../common/constants/agent-constants");
 var _console = require("../../common/util/console");
+var _now = require("../../common/timing/now");
 /**
  * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -33,6 +34,8 @@ class AggregateBase extends _featureBase.FeatureBase {
     this.canHarvestEarly = true;
     /** @type {Boolean} indicates if the feature is actively in a retry deferral period */
     this.isRetrying = false;
+    /** @type {number|undefined} the timestamp (ms, relative to page start) of the last early harvest triggered by this feature, if any */
+    this.lastEarlyHarvestAt = undefined;
     this.harvestOpts = {}; // features aggregate classes can define custom opts for when their harvest is called
 
     this.#setupEventStore();
@@ -88,13 +91,19 @@ class AggregateBase extends _featureBase.FeatureBase {
 
   /**
    * 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.
+   * If conditions are met, a new harvest will be triggered immediately, unless this feature already harvested early within the last `MIN_EARLY_HARVEST_INTERVAL` ms.
+   * Data held back by that limit stays buffered until the next early, interval, or final harvest. Once the estimated payload reaches `EARLY_HARVEST_BYPASS_SIZE`
+   * the limit no longer applies, so a flood of data cannot fill the buffer to its maximum size, where new events would be dropped, while waiting.
    * @returns void
    */
   decideEarlyHarvest() {
     if (!this.canHarvestEarly || this.blocked || this.isRetrying) return;
     const estimatedSize = this.events.byteSize() + (this.customAttributesAreSeparate ? this.agentRef.runtime.jsAttributesMetadata.bytes : 0);
     if (estimatedSize > _agentConstants.IDEAL_PAYLOAD_SIZE) {
+      const currentTime = (0, _now.now)();
+      /* Bounds the request rate when a page produces data in a flood, regardless of how fast or whether requests complete. Large payloads skip the limit to avoid dropping data. */
+      if (estimatedSize < _agentConstants.EARLY_HARVEST_BYPASS_SIZE && this.lastEarlyHarvestAt !== undefined && currentTime - this.lastEarlyHarvestAt < _agentConstants.MIN_EARLY_HARVEST_INTERVAL) return;
+      this.lastEarlyHarvestAt = currentTime;
       this.agentRef.runtime.harvester.triggerHarvestFor(this);
       this.reportSupportabilityMetric("".concat(this.featureName, "/Harvest/Early/Seen"), estimatedSize);
     }

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

@@ -5,6 +5,10 @@
 import { FEATURE_NAMES } from '../../loaders/features/features';
 export const IDEAL_PAYLOAD_SIZE = 16000;
 export const MAX_PAYLOAD_SIZE = 1000000;
+/** The minimum time (ms) between early harvests of a single feature. Data that arrives inside this window stays buffered for the next harvest. */
+export const MIN_EARLY_HARVEST_INTERVAL = 500;
+/** The estimated payload size at which a feature may harvest early even inside the minimum interval, so that a flood of data cannot fill the buffer to MAX_PAYLOAD_SIZE (and start dropping events) while waiting. */
+export const EARLY_HARVEST_BYPASS_SIZE = MAX_PAYLOAD_SIZE / 2;
 export const DEFAULT_KEY = 'NR_CONTAINER_AGENT';
 export const SESSION_ERROR = 'SESSION_ERROR';
 export const SUPPORTS_REGISTERED_ENTITIES = {

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

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

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

@@ -1,5 +1,5 @@
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 import { stringify } from './stringify';
@@ -11,12 +11,15 @@ export function trackObjectAttributeSize(parent, object) {
   // proxy attribute to calculate its size when changed
   parent[object] = new Proxy(originalAttribute, {
     set(target, prop, value) {
+      /* An overwrite replaces the existing entry, so its previous size must be removed first. Otherwise repeated sets of the same key inflate the count far beyond the real size. */
+      if (Object.prototype.hasOwnProperty.call(target, prop)) output.bytes -= prop.length + stringify(target[prop]).length;
       output.bytes += prop.length + stringify(value).length;
       target[prop] = value;
       return true;
     },
     deleteProperty(target, prop) {
-      output.bytes -= prop.length + stringify(target[prop]).length;
+      /* Deleting a key that was never set removes nothing, so the count must not change. */
+      if (Object.prototype.hasOwnProperty.call(target, prop)) output.bytes -= prop.length + stringify(target[prop]).length;
       return delete target[prop];
     }
   });

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

@@ -9,8 +9,9 @@ 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 { MAX_PAYLOAD_SIZE, IDEAL_PAYLOAD_SIZE, SUPPORTS_REGISTERED_ENTITIES } from '../../common/constants/agent-constants';
+import { MAX_PAYLOAD_SIZE, IDEAL_PAYLOAD_SIZE, MIN_EARLY_HARVEST_INTERVAL, EARLY_HARVEST_BYPASS_SIZE, SUPPORTS_REGISTERED_ENTITIES } from '../../common/constants/agent-constants';
 import { warn } from '../../common/util/console';
+import { now } from '../../common/timing/now';
 export class AggregateBase extends FeatureBase {
   /**
    * Create an AggregateBase instance.
@@ -26,6 +27,8 @@ export class AggregateBase extends FeatureBase {
     this.canHarvestEarly = true;
     /** @type {Boolean} indicates if the feature is actively in a retry deferral period */
     this.isRetrying = false;
+    /** @type {number|undefined} the timestamp (ms, relative to page start) of the last early harvest triggered by this feature, if any */
+    this.lastEarlyHarvestAt = undefined;
     this.harvestOpts = {}; // features aggregate classes can define custom opts for when their harvest is called
 
     this.#setupEventStore();
@@ -81,13 +84,19 @@ export class AggregateBase extends FeatureBase {
 
   /**
    * 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.
+   * If conditions are met, a new harvest will be triggered immediately, unless this feature already harvested early within the last `MIN_EARLY_HARVEST_INTERVAL` ms.
+   * Data held back by that limit stays buffered until the next early, interval, or final harvest. Once the estimated payload reaches `EARLY_HARVEST_BYPASS_SIZE`
+   * the limit no longer applies, so a flood of data cannot fill the buffer to its maximum size, where new events would be dropped, while waiting.
    * @returns void
    */
   decideEarlyHarvest() {
     if (!this.canHarvestEarly || this.blocked || this.isRetrying) return;
     const estimatedSize = this.events.byteSize() + (this.customAttributesAreSeparate ? this.agentRef.runtime.jsAttributesMetadata.bytes : 0);
     if (estimatedSize > IDEAL_PAYLOAD_SIZE) {
+      const currentTime = now();
+      /* Bounds the request rate when a page produces data in a flood, regardless of how fast or whether requests complete. Large payloads skip the limit to avoid dropping data. */
+      if (estimatedSize < EARLY_HARVEST_BYPASS_SIZE && this.lastEarlyHarvestAt !== undefined && currentTime - this.lastEarlyHarvestAt < MIN_EARLY_HARVEST_INTERVAL) return;
+      this.lastEarlyHarvestAt = currentTime;
       this.agentRef.runtime.harvester.triggerHarvestFor(this);
       this.reportSupportabilityMetric("".concat(this.featureName, "/Harvest/Early/Seen"), estimatedSize);
     }

package/dist/types/common/constants/agent-constants.d.ts

@@ -1,5 +1,9 @@
 export const IDEAL_PAYLOAD_SIZE: 16000;
 export const MAX_PAYLOAD_SIZE: 1000000;
+/** The minimum time (ms) between early harvests of a single feature. Data that arrives inside this window stays buffered for the next harvest. */
+export const MIN_EARLY_HARVEST_INTERVAL: 500;
+/** The estimated payload size at which a feature may harvest early even inside the minimum interval, so that a flood of data cannot fill the buffer to MAX_PAYLOAD_SIZE (and start dropping events) while waiting. */
+export const EARLY_HARVEST_BYPASS_SIZE: number;
 export const DEFAULT_KEY: "NR_CONTAINER_AGENT";
 export const SESSION_ERROR: "SESSION_ERROR";
 export const SUPPORTS_REGISTERED_ENTITIES: {

package/dist/types/common/constants/agent-constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-constants.d.ts","sourceRoot":"","sources":["../../../../src/common/constants/agent-constants.js"],"names":[],"mappings":"AAMA,iCAAkC,KAAK,CAAA;AACvC,+BAAgC,OAAO,CAAA;AACvC,0BAA2B,oBAAoB,CAAA;AAC/C,4BAA6B,eAAe,CAAA;AAE5C;IACE,CAAC,aAAa,CAAC,OAAO,CAAC,UAAM;IAC7B,CAAC,aAAa,CAAC,aAAa,CAAC,UAAM;IACnC,CAAC,aAAa,CAAC,QAAQ,CAAC,UAAM;IAC9B,CAAC,aAAa,CAAC,IAAI,CAAC,UAAM;EAC3B;8BAZ6B,iCAAiC"}
+{"version":3,"file":"agent-constants.d.ts","sourceRoot":"","sources":["../../../../src/common/constants/agent-constants.js"],"names":[],"mappings":"AAMA,iCAAkC,KAAK,CAAA;AACvC,+BAAgC,OAAO,CAAA;AACvC,kJAAkJ;AAClJ,yCAA0C,GAAG,CAAA;AAC7C,sNAAsN;AACtN,+CAA6D;AAC7D,0BAA2B,oBAAoB,CAAA;AAC/C,4BAA6B,eAAe,CAAA;AAE5C;IACE,CAAC,aAAa,CAAC,OAAO,CAAC,UAAM;IAC7B,CAAC,aAAa,CAAC,aAAa,CAAC,UAAM;IACnC,CAAC,aAAa,CAAC,QAAQ,CAAC,UAAM;IAC9B,CAAC,aAAa,CAAC,IAAI,CAAC,UAAM;EAC3B;8BAhB6B,iCAAiC"}

package/dist/types/common/util/attribute-size.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attribute-size.d.ts","sourceRoot":"","sources":["../../../../src/common/util/attribute-size.js"],"names":[],"mappings":"AAMA;;EAiBC"}
+{"version":3,"file":"attribute-size.d.ts","sourceRoot":"","sources":["../../../../src/common/util/attribute-size.js"],"names":[],"mappings":"AAMA;;EAoBC"}

package/dist/types/features/utils/aggregate-base.d.ts

@@ -11,6 +11,8 @@ export class AggregateBase extends FeatureBase {
     canHarvestEarly: boolean;
     /** @type {Boolean} indicates if the feature is actively in a retry deferral period */
     isRetrying: boolean;
+    /** @type {number|undefined} the timestamp (ms, relative to page start) of the last early harvest triggered by this feature, if any */
+    lastEarlyHarvestAt: number | undefined;
     harvestOpts: {};
     events: any;
     /** @type {Boolean} indicates if the feature supports registered entities and the harvest requirements therein. Also read by getter "harvestEndpointVersion". Controlled by feature flag in pre-release phase. */
@@ -25,7 +27,9 @@ export class AggregateBase extends FeatureBase {
     drained: boolean | undefined;
     /**
      * 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.
+     * If conditions are met, a new harvest will be triggered immediately, unless this feature already harvested early within the last `MIN_EARLY_HARVEST_INTERVAL` ms.
+     * Data held back by that limit stays buffered until the next early, interval, or final harvest. Once the estimated payload reaches `EARLY_HARVEST_BYPASS_SIZE`
+     * the limit no longer applies, so a flood of data cannot fill the buffer to its maximum size, where new events would be dropped, while waiting.
      * @returns void
      */
     decideEarlyHarvest(): void;

package/dist/types/features/utils/aggregate-base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aggregate-base.d.ts","sourceRoot":"","sources":["../../../../src/features/utils/aggregate-base.js"],"names":[],"mappings":"AAcA;IACE;;;;OAIG;IACH,sBAHW,MAAM,eACN,MAAM,EAiBhB;IAZC,uOAAuO;IACvO,qCAAwC;IACxC,gLAAgL;IAChL,yBAA2B;IAC3B,sFAAsF;IACtF,oBAAuB;IAEvB,gBAAqB;IAqBjB,YAAsE;IAW5E,iNAAiN;IACjN,0CAEC;IAED;;;;OAIG;IACH,8BAHU,MAAM,CAKf;IAED,qBAOC;IAFG,6BAAmB;IAIvB;;;;OAIG;IACH,2BAOC;IAED;;;;OAIG;IACH,yBAHW,MAAM,EAAE,gBAyBlB;IAED;;OAEG;IACH,cAEC;IAED,qCAEC;IAED;;;;;;OAMG;IACH,uDAJW,MAAM,GAAC,SAAS,SAsB1B;IAED;;;;;OAKG;IACH,4BAHG;QAAyB,IAAI,GAArB,OAAO,YAAC;QACS,KAAK,GAAtB,OAAO,YAAC;KAClB,QAKA;IAED;;;;OAIG;IACH,uCAHW,GAAC,UACD,GAAC,QAIX;;CACF;4BAtL2B,gBAAgB"}
+{"version":3,"file":"aggregate-base.d.ts","sourceRoot":"","sources":["../../../../src/features/utils/aggregate-base.js"],"names":[],"mappings":"AAeA;IACE;;;;OAIG;IACH,sBAHW,MAAM,eACN,MAAM,EAmBhB;IAdC,uOAAuO;IACvO,qCAAwC;IACxC,gLAAgL;IAChL,yBAA2B;IAC3B,sFAAsF;IACtF,oBAAuB;IACvB,sIAAsI;IACtI,oBADW,MAAM,GAAC,SAAS,CACQ;IAEnC,gBAAqB;IAqBjB,YAAsE;IAW5E,iNAAiN;IACjN,0CAEC;IAED;;;;OAIG;IACH,8BAHU,MAAM,CAKf;IAED,qBAOC;IAFG,6BAAmB;IAIvB;;;;;;OAMG;IACH,2BAWC;IAED;;;;OAIG;IACH,yBAHW,MAAM,EAAE,gBAyBlB;IAED;;OAEG;IACH,cAEC;IAED,qCAEC;IAED;;;;;;OAMG;IACH,uDAJW,MAAM,GAAC,SAAS,SAsB1B;IAED;;;;;OAKG;IACH,4BAHG;QAAyB,IAAI,GAArB,OAAO,YAAC;QACS,KAAK,GAAtB,OAAO,YAAC;KAClB,QAKA;IAED;;;;OAIG;IACH,uCAHW,GAAC,UACD,GAAC,QAIX;;CACF;4BA/L2B,gBAAgB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newrelic/browser-agent",
-  "version": "1.323.0-rc.11",
+  "version": "1.323.0-rc.12",
   "private": false,
   "author": "New Relic Browser Agent Team <browser-agent@newrelic.com>",
   "description": "New Relic Browser Agent",

package/src/common/constants/agent-constants.js

@@ -6,6 +6,10 @@ import { FEATURE_NAMES } from '../../loaders/features/features'
 
 export const IDEAL_PAYLOAD_SIZE = 16000
 export const MAX_PAYLOAD_SIZE = 1000000
+/** The minimum time (ms) between early harvests of a single feature. Data that arrives inside this window stays buffered for the next harvest. */
+export const MIN_EARLY_HARVEST_INTERVAL = 500
+/** The estimated payload size at which a feature may harvest early even inside the minimum interval, so that a flood of data cannot fill the buffer to MAX_PAYLOAD_SIZE (and start dropping events) while waiting. */
+export const EARLY_HARVEST_BYPASS_SIZE = MAX_PAYLOAD_SIZE / 2
 export const DEFAULT_KEY = 'NR_CONTAINER_AGENT'
 export const SESSION_ERROR = 'SESSION_ERROR'
 

package/src/common/util/attribute-size.js

@@ -1,5 +1,5 @@
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 import { stringify } from './stringify'
@@ -10,12 +10,15 @@ export function trackObjectAttributeSize (parent, object) {
   // proxy attribute to calculate its size when changed
   parent[object] = new Proxy(originalAttribute, {
     set (target, prop, value) {
+      /* An overwrite replaces the existing entry, so its previous size must be removed first. Otherwise repeated sets of the same key inflate the count far beyond the real size. */
+      if (Object.prototype.hasOwnProperty.call(target, prop)) output.bytes -= prop.length + stringify(target[prop]).length
       output.bytes += prop.length + stringify(value).length
       target[prop] = value
       return true
     },
     deleteProperty (target, prop) {
-      output.bytes -= prop.length + stringify(target[prop]).length
+      /* Deleting a key that was never set removes nothing, so the count must not change. */
+      if (Object.prototype.hasOwnProperty.call(target, prop)) output.bytes -= prop.length + stringify(target[prop]).length
       return delete target[prop]
     }
   })

package/src/features/utils/aggregate-base.js

@@ -9,8 +9,9 @@ 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 { MAX_PAYLOAD_SIZE, IDEAL_PAYLOAD_SIZE, SUPPORTS_REGISTERED_ENTITIES } from '../../common/constants/agent-constants'
+import { MAX_PAYLOAD_SIZE, IDEAL_PAYLOAD_SIZE, MIN_EARLY_HARVEST_INTERVAL, EARLY_HARVEST_BYPASS_SIZE, SUPPORTS_REGISTERED_ENTITIES } from '../../common/constants/agent-constants'
 import { warn } from '../../common/util/console'
+import { now } from '../../common/timing/now'
 
 export class AggregateBase extends FeatureBase {
   /**
@@ -27,6 +28,8 @@ export class AggregateBase extends FeatureBase {
     this.canHarvestEarly = true
     /** @type {Boolean} indicates if the feature is actively in a retry deferral period */
     this.isRetrying = false
+    /** @type {number|undefined} the timestamp (ms, relative to page start) of the last early harvest triggered by this feature, if any */
+    this.lastEarlyHarvestAt = undefined
 
     this.harvestOpts = {} // features aggregate classes can define custom opts for when their harvest is called
 
@@ -85,13 +88,19 @@ export class AggregateBase extends FeatureBase {
 
   /**
    * 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.
+   * If conditions are met, a new harvest will be triggered immediately, unless this feature already harvested early within the last `MIN_EARLY_HARVEST_INTERVAL` ms.
+   * Data held back by that limit stays buffered until the next early, interval, or final harvest. Once the estimated payload reaches `EARLY_HARVEST_BYPASS_SIZE`
+   * the limit no longer applies, so a flood of data cannot fill the buffer to its maximum size, where new events would be dropped, while waiting.
    * @returns void
    */
   decideEarlyHarvest () {
     if (!this.canHarvestEarly || this.blocked || this.isRetrying) return
     const estimatedSize = this.events.byteSize() + (this.customAttributesAreSeparate ? this.agentRef.runtime.jsAttributesMetadata.bytes : 0)
     if (estimatedSize > IDEAL_PAYLOAD_SIZE) {
+      const currentTime = now()
+      /* Bounds the request rate when a page produces data in a flood, regardless of how fast or whether requests complete. Large payloads skip the limit to avoid dropping data. */
+      if (estimatedSize < EARLY_HARVEST_BYPASS_SIZE && this.lastEarlyHarvestAt !== undefined && currentTime - this.lastEarlyHarvestAt < MIN_EARLY_HARVEST_INTERVAL) return
+      this.lastEarlyHarvestAt = currentTime
       this.agentRef.runtime.harvester.triggerHarvestFor(this)
       this.reportSupportabilityMetric(`${this.featureName}/Harvest/Early/Seen`, estimatedSize)
     }