@newrelic/browser-agent 1.264.0 → 1.265.0

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

@@ -10,7 +10,8 @@ var _denyList = require("../../../common/deny-list/deny-list");
 var _navTiming = require("../../../common/timing/nav-timing");
 var _uniqueId = require("../../../common/ids/unique-id");
 var _interaction = require("./interaction");
-var _config = require("../../../common/config/config");
+var _init = require("../../../common/config/init");
+var _runtime = require("../../../common/config/runtime");
 var _eventListenerOpts = require("../../../common/event-listener/event-listener-opts");
 var _harvestScheduler = require("../../../common/harvest/harvest-scheduler");
 var _serializer = require("./serializer");
@@ -21,11 +22,12 @@ var _aggregateBase = require("../../utils/aggregate-base");
 var _firstContentfulPaint = require("../../../common/vitals/first-contentful-paint");
 var _firstPaint = require("../../../common/vitals/first-paint");
 var _bundleId = require("../../../common/ids/bundle-id");
-var _runtime = require("../../../common/constants/runtime");
+var _runtime2 = require("../../../common/constants/runtime");
 var _handle = require("../../../common/event-emitter/handle");
 var _constants2 = require("../../metrics/constants");
 var _drain = require("../../../common/drain/drain");
 var _console = require("../../../common/util/console");
+var _eventBuffer = require("../../utils/event-buffer");
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 /*
@@ -53,10 +55,10 @@ const {
   originalSetTimeout
 } = CONSTANTS;
 class Aggregate extends _aggregateBase.AggregateBase {
-  static featureName = (() => FEATURE_NAME)();
+  static featureName = FEATURE_NAME;
   constructor(agentIdentifier, aggregator) {
     super(agentIdentifier, aggregator, FEATURE_NAME);
-    const agentRuntime = (0, _config.getRuntime)(agentIdentifier);
+    const agentRuntime = (0, _runtime.getRuntime)(agentIdentifier);
     this.state = {
       initialPageURL: agentRuntime.origin,
       lastSeenUrl: agentRuntime.origin,
@@ -70,11 +72,10 @@ class Aggregate extends _aggregateBase.AggregateBase {
       pageLoaded: false,
       childTime: 0,
       depth: 0,
-      harvestTimeSeconds: (0, _config.getConfigurationValue)(agentIdentifier, 'spa.harvestTimeSeconds') || 10,
-      interactionsToHarvest: [],
-      interactionsSent: [],
+      harvestTimeSeconds: (0, _init.getConfigurationValue)(agentIdentifier, 'spa.harvestTimeSeconds') || 10,
+      interactionsToHarvest: new _eventBuffer.EventBuffer(),
       // The below feature flag is used to disable the SPA ajax fix for specific customers, see https://new-relic.atlassian.net/browse/NR-172169
-      disableSpaFix: ((0, _config.getConfigurationValue)(agentIdentifier, 'feature_flags') || []).indexOf('disable-spa-fix') > -1
+      disableSpaFix: ((0, _init.getConfigurationValue)(agentIdentifier, 'feature_flags') || []).indexOf('disable-spa-fix') > -1
     };
     let scheduler;
     this.serializer = new _serializer.Serializer(this);
@@ -125,8 +126,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     //  | click ending:                   |   65  |    50    |        |           |           |
     // click fn-end                       |   70  |    0     |    0   |     70    |     20    |
 
-    this.waitForFlags(['spa']).then(_ref => {
-      let [spaFlag] = _ref;
+    this.waitForFlags(['spa']).then(([spaFlag]) => {
       if (spaFlag) {
         scheduler = new _harvestScheduler.HarvestScheduler('events', {
           onFinished: onHarvestFinished,
@@ -193,7 +193,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
       var ev = args[0];
       var evName = ev.type;
       var eventNode = ev["__nrNode:".concat(_bundleId.bundleId)];
-      if (!state.pageLoaded && (evName === 'load' && eventSource === window || _runtime.loadedAsDeferredBrowserScript)) {
+      if (!state.pageLoaded && (evName === 'load' && eventSource === window || _runtime2.loadedAsDeferredBrowserScript)) {
         state.pageLoaded = true;
         // set to null so prevNode is set correctly
         this.prevNode = state.currentNode = null;
@@ -628,14 +628,9 @@ class Aggregate extends _aggregateBase.AggregateBase {
     }
     const classThis = this;
     function onHarvestStarted(options) {
-      if (state.interactionsToHarvest.length === 0 || classThis.blocked) return {};
-      var payload = serializer.serializeMultiple(state.interactionsToHarvest, 0, _navTiming.navTimingValues);
-      if (options.retry) {
-        state.interactionsToHarvest.forEach(function (interaction) {
-          state.interactionsSent.push(interaction);
-        });
-      }
-      state.interactionsToHarvest = [];
+      if (!state.interactionsToHarvest.hasData || classThis.blocked) return {};
+      var payload = serializer.serializeMultiple(state.interactionsToHarvest.buffer, 0, _navTiming.navTimingValues);
+      if (options.retry) state.interactionsToHarvest.hold();else state.interactionsToHarvest.clear();
       return {
         body: {
           e: payload
@@ -643,12 +638,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
       };
     }
     function onHarvestFinished(result) {
-      if (result.sent && result.retry && state.interactionsSent.length > 0) {
-        state.interactionsSent.forEach(function (interaction) {
-          state.interactionsToHarvest.unshift(interaction);
-        });
-        state.interactionsSent = [];
-      }
+      if (result.sent && result.retry && state.interactionsToHarvest.held.hasData) state.interactionsToHarvest.unhold();else state.interactionsToHarvest.held.clear();
     }
     baseEE.on('spa-jserror', function (type, name, params, metrics) {
       if (!state.currentNode) return;
@@ -696,7 +686,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
         interaction.root.attrs.firstContentfulPaint = _firstContentfulPaint.firstContentfulPaint.current.value;
       }
       baseEE.emit('interactionDone', [interaction, true]);
-      state.interactionsToHarvest.push(interaction);
+      state.interactionsToHarvest.add(interaction);
       let smCategory;
       if (interaction.root?.attrs?.trigger === 'initialPageLoad') smCategory = 'InitialPageLoad';else if (interaction.routeChange) smCategory = 'RouteChange';else smCategory = 'Custom';
       (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, ["Spa/Interaction/".concat(smCategory, "/Duration/Ms"), Math.max((interaction.root?.end || 0) - (interaction.root?.start || 0), 0)], undefined, _features.FEATURE_NAMES.metrics, baseEE);
@@ -704,7 +694,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
       if (!scheduler) (0, _console.warn)(19);
     }
     function isEnabled() {
-      var enabled = (0, _config.getConfigurationValue)(agentIdentifier, 'spa.enabled');
+      var enabled = (0, _init.getConfigurationValue)(agentIdentifier, 'spa.enabled');
       return enabled !== false;
     }
   }

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

@@ -4,7 +4,9 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.Interaction = Interaction;
-var _config = require("../../../common/config/config");
+var _info = require("../../../common/config/info");
+var _runtime = require("../../../common/config/runtime");
+var _nreum = require("../../../common/window/nreum");
 var _contextualEe = require("../../../common/event-emitter/contextual-ee");
 var _interactionNode = require("./interaction-node");
 /*
@@ -12,8 +14,8 @@ var _interactionNode = require("./interaction-node");
  * SPDX-License-Identifier: Apache-2.0
  */
 
-var originalSetTimeout = _config.originals.ST;
-var originalClearTimeout = _config.originals.CT;
+var originalSetTimeout = (0, _nreum.gosNREUMOriginals)().o.ST;
+var originalClearTimeout = (0, _nreum.gosNREUMOriginals)().o.CT;
 var lastId = {};
 function Interaction(eventName, timestamp, url, routeName, onFinished, agentIdentifier) {
   this.agentIdentifier = agentIdentifier;
@@ -32,7 +34,7 @@ function Interaction(eventName, timestamp, url, routeName, onFinished, agentIden
   var root = this.root = new _interactionNode.InteractionNode(this, null, 'interaction', timestamp);
   var attrs = root.attrs;
   attrs.trigger = eventName;
-  attrs.initialPageURL = (0, _config.getRuntime)(agentIdentifier).origin;
+  attrs.initialPageURL = (0, _runtime.getRuntime)(agentIdentifier).origin;
   attrs.oldRoute = routeName;
   attrs.newURL = attrs.oldURL = url;
   attrs.custom = {};
@@ -87,8 +89,7 @@ InteractionPrototype.finish = function finishInteraction() {
   if (this.onFinished) {
     this.onFinished(this);
   }
-  Object.entries((0, _config.getInfo)(interaction.agentIdentifier).jsAttributes || {}).forEach(_ref => {
-    let [attr, value] = _ref;
+  Object.entries((0, _info.getInfo)(interaction.agentIdentifier).jsAttributes || {}).forEach(([attr, value]) => {
     if (!(attr in customAttrs)) customAttrs[attr] = value;
   });
   root.end = endTimestamp;

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

@@ -7,7 +7,7 @@ exports.Serializer = void 0;
 var _cleanUrl = require("../../../common/url/clean-url");
 var _belSerializer = require("../../../common/serialize/bel-serializer");
 var _sharedContext = require("../../../common/context/shared-context");
-var _config = require("../../../common/config/config");
+var _info = require("../../../common/config/info");
 /*
  * Copyright 2020 New Relic Corporation. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -27,7 +27,7 @@ class Serializer extends _sharedContext.SharedContext {
     this.firstTimestamp = undefined;
   }
   serializeMultiple(interactions, offset, navTiming) {
-    const info = (0, _config.getInfo)(this.sharedContext.agentIdentifier);
+    const info = (0, _info.getInfo)(this.sharedContext.agentIdentifier);
     var addString = (0, _belSerializer.getAddStringContext)(this.sharedContext.agentIdentifier);
     var serialized = 'bel.7';
     interactions.forEach(interaction => {
@@ -37,7 +37,7 @@ class Serializer extends _sharedContext.SharedContext {
     return serialized;
   }
   serializeSingle(root, offset, navTiming, isRouteChange) {
-    const info = (0, _config.getInfo)(this.sharedContext.agentIdentifier);
+    const info = (0, _info.getInfo)(this.sharedContext.agentIdentifier);
     var addString = (0, _belSerializer.getAddStringContext)(this.sharedContext.agentIdentifier);
     var serialized = 'bel.7;' + this.serializeInteraction(root, offset, navTiming, isRouteChange, addString, info);
     this.firstTimestamp = undefined;

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

@@ -4,7 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.originalSetTimeout = exports.START = exports.SPA_NODE = exports.REMAINING = exports.MAX_TIMER_BUDGET = exports.JS_TIME = exports.JSONP_NODE = exports.JSONP_END = exports.INTERACTION_EVENTS = exports.INTERACTION_API = exports.INTERACTION = exports.FN_START = exports.FN_END = exports.FETCH_START = exports.FETCH_DONE = exports.FETCH_BODY = exports.FETCH = exports.FEATURE_NAME = exports.END = exports.CB_START = exports.CB_END = exports.BODY = void 0;
-var _config = require("../../common/config/config");
+var _nreum = require("../../common/window/nreum");
 var _features = require("../../loaders/features/features");
 const FEATURE_NAME = exports.FEATURE_NAME = _features.FEATURE_NAMES.spa;
 const INTERACTION_EVENTS = exports.INTERACTION_EVENTS = ['click', 'submit', 'keypress', 'keydown', 'keyup', 'change'];
@@ -21,7 +21,7 @@ const FETCH_START = exports.FETCH_START = 'fetch-start';
 const FETCH_DONE = exports.FETCH_DONE = 'fetch-done';
 const FETCH_BODY = exports.FETCH_BODY = 'fetch-body-';
 const JSONP_END = exports.JSONP_END = 'jsonp-end';
-const originalSetTimeout = exports.originalSetTimeout = _config.originals.ST;
+const originalSetTimeout = exports.originalSetTimeout = (0, _nreum.gosNREUMOriginals)().o.ST;
 const START = exports.START = '-start';
 const END = exports.END = '-end';
 const BODY = exports.BODY = '-body';

package/dist/cjs/features/spa/instrument/index.js

@@ -3,14 +3,20 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.Instrument = void 0;
-var _wrap = require("../../../common/wrap");
+exports.Spa = exports.Instrument = void 0;
 var _eventListenerOpts = require("../../../common/event-listener/event-listener-opts");
 var _instrumentBase = require("../../utils/instrument-base");
 var CONSTANTS = _interopRequireWildcard(require("../constants"));
 var _runtime = require("../../../common/constants/runtime");
 var _now = require("../../../common/timing/now");
 var _handle = require("../../../common/event-emitter/handle");
+var _wrapJsonp = require("../../../common/wrap/wrap-jsonp");
+var _wrapPromise = require("../../../common/wrap/wrap-promise");
+var _wrapTimer = require("../../../common/wrap/wrap-timer");
+var _wrapXhr = require("../../../common/wrap/wrap-xhr");
+var _wrapFetch = require("../../../common/wrap/wrap-fetch");
+var _wrapHistory = require("../../../common/wrap/wrap-history");
+var _wrapMutation = require("../../../common/wrap/wrap-mutation");
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 /*
@@ -31,12 +37,9 @@ const {
   FN_END
 } = CONSTANTS;
 class Instrument extends _instrumentBase.InstrumentBase {
-  static featureName = (() => FEATURE_NAME)();
-  constructor(agentIdentifier, aggregator) {
-    var _this;
-    let auto = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
+  static featureName = FEATURE_NAME;
+  constructor(agentIdentifier, aggregator, auto = true) {
     super(agentIdentifier, aggregator, FEATURE_NAME, auto);
-    _this = this;
     if (!_runtime.isBrowserScope) return; // SPA not supported outside web env
 
     try {
@@ -45,25 +48,22 @@ class Instrument extends _instrumentBase.InstrumentBase {
     let depth = 0;
     let startHash;
     const tracerEE = this.ee.get('tracer');
-    const jsonpEE = (0, _wrap.wrapJsonP)(this.ee);
-    const promiseEE = (0, _wrap.wrapPromise)(this.ee);
-    const timerEE = (0, _wrap.wrapTimer)(this.ee);
-    const xhrEE = (0, _wrap.wrapXhr)(this.ee);
+    const jsonpEE = (0, _wrapJsonp.wrapJsonP)(this.ee);
+    const promiseEE = (0, _wrapPromise.wrapPromise)(this.ee);
+    const timerEE = (0, _wrapTimer.wrapTimer)(this.ee);
+    const xhrEE = (0, _wrapXhr.wrapXhr)(this.ee);
     const eventsEE = this.ee.get('events'); // wrapXhr will call wrapEvents
-    const fetchEE = (0, _wrap.wrapFetch)(this.ee);
-    const historyEE = (0, _wrap.wrapHistory)(this.ee);
-    const mutationEE = (0, _wrap.wrapMutation)(this.ee);
+    const fetchEE = (0, _wrapFetch.wrapFetch)(this.ee);
+    const historyEE = (0, _wrapHistory.wrapHistory)(this.ee);
+    const mutationEE = (0, _wrapMutation.wrapMutation)(this.ee);
     this.ee.on(FN_START, startTimestamp);
     promiseEE.on(CB_START, startTimestamp);
     jsonpEE.on(CB_START, startTimestamp);
     this.ee.on(FN_END, endTimestamp);
     promiseEE.on(CB_END, endTimestamp);
     jsonpEE.on(CB_END, endTimestamp);
-    this.ee.on('fn-err', function () {
-      for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
-        args[_key] = arguments[_key];
-      }
-      if (!args[2]?.__newrelic?.[agentIdentifier]) (0, _handle.handle)('function-err', [...args], undefined, _this.featureName, _this.ee);
+    this.ee.on('fn-err', (...args) => {
+      if (!args[2]?.__newrelic?.[agentIdentifier]) (0, _handle.handle)('function-err', [...args], undefined, this.featureName, this.ee);
     });
     this.ee.buffer([FN_START, FN_END, 'xhr-resolved'], this.featureName);
     eventsEE.buffer([FN_START], this.featureName);
@@ -119,4 +119,5 @@ class Instrument extends _instrumentBase.InstrumentBase {
     this.abortHandler = undefined; // weakly allow this abort op to run only once
   }
 }
-exports.Instrument = Instrument;
+exports.Instrument = Instrument;
+const Spa = exports.Spa = Instrument;

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

@@ -4,7 +4,9 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.setupAgentSession = setupAgentSession;
-var _config = require("../../common/config/config");
+var _info = require("../../common/config/info");
+var _init = require("../../common/config/init");
+var _runtime = require("../../common/config/runtime");
 var _drain = require("../../common/drain/drain");
 var _contextualEe = require("../../common/event-emitter/contextual-ee");
 var _registerHandler = require("../../common/event-emitter/register-handler");
@@ -13,9 +15,9 @@ var _localStorage = require("../../common/storage/local-storage.js");
 var _constants = require("../../common/session/constants");
 let ranOnce = 0;
 function setupAgentSession(agentIdentifier) {
-  const agentRuntime = (0, _config.getRuntime)(agentIdentifier);
+  const agentRuntime = (0, _runtime.getRuntime)(agentIdentifier);
   if (ranOnce++) return agentRuntime.session;
-  const sessionInit = (0, _config.getConfiguration)(agentIdentifier).session;
+  const sessionInit = (0, _init.getConfiguration)(agentIdentifier).session;
   agentRuntime.session = new _sessionEntity.SessionEntity({
     agentIdentifier,
     key: _constants.DEFAULT_KEY,
@@ -26,7 +28,7 @@ function setupAgentSession(agentIdentifier) {
 
   // Retrieve & re-add all of the persisted setCustomAttribute|setUserId k-v from previous page load(s), if any was stored.
   const customSessionData = agentRuntime.session.state.custom;
-  const agentInfo = (0, _config.getInfo)(agentIdentifier);
+  const agentInfo = (0, _info.getInfo)(agentIdentifier);
   if (customSessionData) {
     agentInfo.jsAttributes = {
       ...agentInfo.jsAttributes,

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

@@ -5,15 +5,18 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.AggregateBase = void 0;
 var _featureBase = require("./feature-base");
-var _config = require("../../common/config/config");
+var _info = require("../../common/config/info");
+var _runtime = require("../../common/config/runtime");
 var _configure = require("../../loaders/configure/configure");
 var _nreum = require("../../common/window/nreum");
 var _drain = require("../../common/drain/drain");
 var _featureFlags = require("../../common/util/feature-flags");
+var _obfuscate = require("../../common/util/obfuscate");
 class AggregateBase extends _featureBase.FeatureBase {
-  constructor() {
-    super(...arguments);
+  constructor(...args) {
+    super(...args);
     this.checkConfiguration();
+    this.obfuscator = (0, _runtime.getRuntime)(this.agentIdentifier).obfuscator;
   }
 
   /**
@@ -21,14 +24,12 @@ class AggregateBase extends _featureBase.FeatureBase {
    * @param {string[]} flagNames
    * @returns {Promise}
    */
-  waitForFlags() {
-    let flagNames = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+  waitForFlags(flagNames = []) {
     const flagsPromise = new Promise((resolve, reject) => {
       if (_featureFlags.activatedFeatures[this.agentIdentifier]) {
         resolve(buildOutput(_featureFlags.activatedFeatures[this.agentIdentifier]));
       } else {
-        this.ee.on('rumresp', function () {
-          let resp = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+        this.ee.on('rumresp', (resp = {}) => {
           resolve(buildOutput(resp));
         });
       }
@@ -56,7 +57,7 @@ class AggregateBase extends _featureBase.FeatureBase {
    */
   checkConfiguration() {
     // NOTE: This check has to happen at aggregator load time
-    if (!(0, _config.isConfigured)(this.agentIdentifier)) {
+    if (!(0, _info.isValid)(this.agentIdentifier)) {
       const cdn = (0, _nreum.gosCDN)();
       let jsAttributes = {
         ...cdn.info?.jsAttributes
@@ -64,7 +65,7 @@ class AggregateBase extends _featureBase.FeatureBase {
       try {
         jsAttributes = {
           ...jsAttributes,
-          ...(0, _config.getInfo)(this.agentIdentifier)?.jsAttributes
+          ...(0, _info.getInfo)(this.agentIdentifier)?.jsAttributes
         };
       } catch (err) {
         // do nothing
@@ -77,9 +78,13 @@ class AggregateBase extends _featureBase.FeatureBase {
           ...cdn.info,
           jsAttributes
         },
-        runtime: (0, _config.getRuntime)(this.agentIdentifier)
+        runtime: (0, _runtime.getRuntime)(this.agentIdentifier)
       });
     }
+    const runtime = (0, _runtime.getRuntime)(this.agentIdentifier);
+    if (!runtime.obfuscator) {
+      runtime.obfuscator = new _obfuscate.Obfuscator(this.agentIdentifier);
+    }
   }
 }
 exports.AggregateBase = AggregateBase;

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

@@ -0,0 +1,132 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EventBuffer = void 0;
+var _stringify = require("../../common/util/stringify");
+var _agentConstants = require("../../common/constants/agent-constants");
+/**
+ * A container that keeps an event buffer and size with helper methods
+ * @typedef {Object} EventBuffer
+ * @property {number} size
+ * @property {*[]} buffer
+ */
+
+/**
+ * A container that holds, evaluates, and merges event objects for harvesting
+ */
+class EventBuffer {
+  /** @type {Object[]} */
+  #buffer = [];
+  /** @type {number} */
+  #bytes = 0;
+  /** @type {EventBuffer} */
+  #held;
+
+  /**
+   *
+   * @param {number=} maxPayloadSize
+   */
+  constructor(maxPayloadSize = _agentConstants.MAX_PAYLOAD_SIZE) {
+    this.maxPayloadSize = maxPayloadSize;
+  }
+
+  /**
+   * buffer is read only, use the helper methods to add or clear buffer data
+   */
+  get buffer() {
+    return this.#buffer;
+  }
+
+  /**
+   * bytes is read only, use the helper methods to add or clear buffer data
+   */
+  get bytes() {
+    return this.#bytes;
+  }
+
+  /**
+   * held is another event buffer
+   */
+  get held() {
+    this.#held ??= new EventBuffer(this.maxPayloadSize);
+    return this.#held;
+  }
+
+  /**
+   * Returns a boolean indicating whether the current size and buffer contain valid data
+   * @returns {boolean}
+   */
+  get hasData() {
+    return this.buffer.length > 0 && this.bytes > 0;
+  }
+
+  /**
+   * Adds an event object to the buffer while tallying size
+   * @param {Object} event the event object to add to the buffer
+   * @returns {EventBuffer} returns the event buffer for chaining
+   */
+  add(event) {
+    const size = (0, _stringify.stringify)(event).length;
+    if (!this.canMerge(size)) return this;
+    this.#buffer.push(event);
+    this.#bytes += size;
+    return this;
+  }
+
+  /**
+   * clear the buffer data
+   * @returns {EventBuffer}
+   */
+  clear() {
+    this.#bytes = 0;
+    this.#buffer = [];
+    return this;
+  }
+
+  /**
+   * Hold the buffer data in a new (child) EventBuffer (.held) to unblock the main buffer.
+   * This action clears the main buffer
+   * @returns {EventBuffer}
+   */
+  hold() {
+    this.held.merge(this);
+    this.clear();
+    return this;
+  }
+
+  /**
+   * Prepend the held EventBuffer (.held) back into the main buffer
+   * This action clears the held buffer
+   * @returns {EventBuffer}
+   */
+  unhold() {
+    this.merge(this.held, true);
+    this.held.clear();
+    return this;
+  }
+
+  /**
+   * Merges an EventBuffer into this EventBuffer
+   * @param {EventBuffer} events an EventBuffer intended to merge with this EventBuffer
+   * @param {boolean} prepend if true, the supplied events will be prepended before the events of this class
+   * @returns {EventBuffer} returns the event buffer for chaining
+   */
+  merge(eventBuffer, prepend = false) {
+    if (!this.canMerge(eventBuffer.bytes)) return this;
+    this.#buffer = prepend ? [...eventBuffer.buffer, ...this.#buffer] : [...this.#buffer, ...eventBuffer.buffer];
+    this.#bytes += eventBuffer.#bytes;
+    return this;
+  }
+
+  /**
+   * Returns a boolean indicating the resulting size of a merge would be valid. Compares against the maxPayloadSize provided at initialization time.
+   * @param {number} size
+   * @returns {boolean}
+   */
+  canMerge(size) {
+    return this.bytes + (size || Infinity) < this.maxPayloadSize;
+  }
+}
+exports.EventBuffer = EventBuffer;

package/dist/cjs/features/utils/feature-gates.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.canEnableSessionTracking = void 0;
-var _config = require("../../common/config/config");
+var _init = require("../../common/config/init");
 var _runtime = require("../../common/constants/runtime");
 /**
  * Checks if session can be tracked, affects session entity and dependent features
@@ -12,6 +12,6 @@ var _runtime = require("../../common/constants/runtime");
  * @returns {boolean}
  */
 const canEnableSessionTracking = agentId => {
-  return _runtime.isBrowserScope && (0, _config.getConfigurationValue)(agentId, 'privacy.cookies_enabled') === true;
+  return _runtime.isBrowserScope && (0, _init.getConfigurationValue)(agentId, 'privacy.cookies_enabled') === true;
 };
 exports.canEnableSessionTracking = canEnableSessionTracking;

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

@@ -10,7 +10,7 @@ var _load = require("../../common/window/load");
 var _runtime = require("../../common/constants/runtime");
 var _console = require("../../common/util/console");
 var _features = require("../../loaders/features/features");
-var _config = require("../../common/config/config");
+var _init = require("../../common/config/init");
 var _utils = require("../session_replay/shared/utils");
 var _featureGates = require("./feature-gates");
 var _invoke = require("../../common/util/invoke");
@@ -34,8 +34,7 @@ class InstrumentBase extends _featureBase.FeatureBase {
    *     of its pooled instrumentation data handled by the agent's centralized drain functionality, rather than draining
    *     immediately. Primarily useful for fine-grained control in tests.
    */
-  constructor(agentIdentifier, aggregator, featureName) {
-    let auto = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : true;
+  constructor(agentIdentifier, aggregator, featureName, auto = true) {
     super(agentIdentifier, aggregator, featureName);
     this.auto = auto;
 
@@ -51,11 +50,12 @@ class InstrumentBase extends _featureBase.FeatureBase {
     /**
      * @type {Promise} Assigned immediately after @see importAggregator runs. Serves as a signal for when the inner async fn finishes execution. Useful for features to await
      * one another if there are inter-features dependencies.
+     * TODO: This is only used for the SPA feature component tests and should be refactored out.
     */
     this.onAggregateImported = undefined;
 
     /** used in conjunction with newrelic.start() to defer harvesting in features */
-    if ((0, _config.getConfigurationValue)(this.agentIdentifier, "".concat(this.featureName, ".autoStart")) === false) this.auto = false;
+    if ((0, _init.getConfigurationValue)(this.agentIdentifier, "".concat(this.featureName, ".autoStart")) === false) this.auto = false;
     /** if the feature requires opt-in (!auto-start), it will get registered once the api has been called */
     if (this.auto) (0, _drain.registerDrain)(agentIdentifier, featureName);else {
       this.ee.on('manual-start-all', (0, _invoke.single)(() => {
@@ -74,8 +74,7 @@ class InstrumentBase extends _featureBase.FeatureBase {
    * @param {Object} [argsObjFromInstrument] - any values or references to pass down to aggregate
    * @returns void
    */
-  importAggregator() {
-    let argsObjFromInstrument = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  importAggregator(argsObjFromInstrument = {}) {
     if (this.featAggregate || !this.auto) return;
     let loadedSuccessfully;
     this.onAggregateImported = new Promise(resolve => {
@@ -88,7 +87,7 @@ class InstrumentBase extends _featureBase.FeatureBase {
           // would require some setup before certain features start
           const {
             setupAgentSession
-          } = await Promise.resolve().then(() => _interopRequireWildcard(require( /* webpackChunkName: "session-manager" */'./agent-session')));
+          } = await Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "session-manager" */'./agent-session')));
           session = setupAgentSession(this.agentIdentifier);
         }
       } catch (e) {
@@ -109,7 +108,7 @@ class InstrumentBase extends _featureBase.FeatureBase {
         }
         const {
           lazyFeatureLoader
-        } = await Promise.resolve().then(() => _interopRequireWildcard(require( /* webpackChunkName: "lazy-feature-loader" */'./lazy-feature-loader')));
+        } = await Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "lazy-feature-loader" */'./lazy-feature-loader')));
         const {
           Aggregate
         } = await lazyFeatureLoader(this.featureName, 'aggregate');

package/dist/cjs/features/utils/lazy-feature-loader.js

@@ -22,27 +22,27 @@ function lazyFeatureLoader(featureName, featurePart) {
   if (featurePart === 'aggregate') {
     switch (featureName) {
       case _features.FEATURE_NAMES.ajax:
-        return Promise.resolve().then(() => _interopRequireWildcard(require( /* webpackChunkName: "ajax-aggregate" */'../ajax/aggregate')));
+        return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "ajax-aggregate" */'../ajax/aggregate')));
       case _features.FEATURE_NAMES.jserrors:
-        return Promise.resolve().then(() => _interopRequireWildcard(require( /* webpackChunkName: "jserrors-aggregate" */'../jserrors/aggregate')));
+        return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "jserrors-aggregate" */'../jserrors/aggregate')));
       case _features.FEATURE_NAMES.genericEvents:
-        return Promise.resolve().then(() => _interopRequireWildcard(require( /* webpackChunkName: "generic_events-aggregate" */'../generic_events/aggregate')));
+        return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "generic_events-aggregate" */'../generic_events/aggregate')));
       case _features.FEATURE_NAMES.logging:
-        return Promise.resolve().then(() => _interopRequireWildcard(require( /* webpackChunkName: "logging-aggregate" */'../logging/aggregate')));
+        return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "logging-aggregate" */'../logging/aggregate')));
       case _features.FEATURE_NAMES.metrics:
-        return Promise.resolve().then(() => _interopRequireWildcard(require( /* webpackChunkName: "metrics-aggregate" */'../metrics/aggregate')));
+        return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "metrics-aggregate" */'../metrics/aggregate')));
       case _features.FEATURE_NAMES.pageViewEvent:
-        return Promise.resolve().then(() => _interopRequireWildcard(require( /* webpackChunkName: "page_view_event-aggregate" */'../page_view_event/aggregate')));
+        return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "page_view_event-aggregate" */'../page_view_event/aggregate')));
       case _features.FEATURE_NAMES.pageViewTiming:
-        return Promise.resolve().then(() => _interopRequireWildcard(require( /* webpackChunkName: "page_view_timing-aggregate" */'../page_view_timing/aggregate')));
+        return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "page_view_timing-aggregate" */'../page_view_timing/aggregate')));
       case _features.FEATURE_NAMES.sessionReplay:
-        return Promise.resolve().then(() => _interopRequireWildcard(require( /* webpackChunkName: "session_replay-aggregate" */'../session_replay/aggregate')));
+        return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "session_replay-aggregate" */'../session_replay/aggregate')));
       case _features.FEATURE_NAMES.sessionTrace:
-        return Promise.resolve().then(() => _interopRequireWildcard(require( /* webpackChunkName: "session_trace-aggregate" */'../session_trace/aggregate')));
+        return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "session_trace-aggregate" */'../session_trace/aggregate')));
       case _features.FEATURE_NAMES.spa:
-        return Promise.resolve().then(() => _interopRequireWildcard(require( /* webpackChunkName: "spa-aggregate" */'../spa/aggregate')));
+        return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "spa-aggregate" */'../spa/aggregate')));
       case _features.FEATURE_NAMES.softNav:
-        return Promise.resolve().then(() => _interopRequireWildcard(require( /* webpackChunkName: "basic-spa-aggregate" */'../soft_navigations/aggregate')));
+        return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "basic-spa-aggregate" */'../soft_navigations/aggregate')));
       default:
         throw new Error("Attempted to load unsupported agent feature: ".concat(featureName, " ").concat(featurePart));
     }