@newrelic/browser-agent 1.320.0 → 1.320.1-rc.1

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

@@ -152,6 +152,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     if (!eventBuffer.length) return;
     const {
       addString,
+      addStringRaw,
       addStringWithTruncation
     } = (0, _payloads.createStringAdders)(_belSerializer.getAddStringContext, this.obfuscator);
     let payload = 'bel.7;';
@@ -165,11 +166,11 @@ class Aggregate extends _aggregateBase.AggregateBase {
       // callbackEnd
       (0, _belSerializer.numeric)(0),
       // no callbackDuration for non-SPA events
-      addString(event.method), (0, _belSerializer.numeric)(event.status), addString(event.domain), addString(event.path), (0, _belSerializer.numeric)(event.requestSize), (0, _belSerializer.numeric)(event.responseSize), event.type === 'fetch' ? 1 : '', addString(0),
+      addStringRaw(event.method), (0, _belSerializer.numeric)(event.status), addString(event.domain), addString(event.path), (0, _belSerializer.numeric)(event.requestSize), (0, _belSerializer.numeric)(event.responseSize), event.type === 'fetch' ? 1 : '', addStringRaw(0),
       // nodeId
-      (0, _belSerializer.nullable)(event.spanId, addString, true) +
+      (0, _belSerializer.nullable)(event.spanId, addStringRaw, true) +
       // guid
-      (0, _belSerializer.nullable)(event.traceId, addString, true) +
+      (0, _belSerializer.nullable)(event.traceId, addStringRaw, true) +
       // traceId
       (0, _belSerializer.nullable)(event.spanTimestamp, _belSerializer.numeric, false) // timestamp
       ];
@@ -179,14 +180,21 @@ class Aggregate extends _aggregateBase.AggregateBase {
       const jsAttributes = this.agentRef.info.jsAttributes;
 
       // Regular attributes: obfuscate only
-      const regularAttrs = (0, _belSerializer.addCustomAttributes)({
+      let regularAttrs = (0, _belSerializer.addCustomAttributes)({
         ...(jsAttributes || {}),
-        [_constants.AJAX_ID]: event[_constants.AJAX_ID],
-        // all AjaxRequest events should have a unique identifier to allow for easier grouping and analysis in the UI
         ...(event.targetAttributes || {}),
         // used to supply the version 2 attributes, either MFE target or duplication attributes for the main agent app
         ...(event.gql || {})
-      }, addString);
+      }, {
+        addKey: addStringRaw,
+        addVal: addString
+      });
+      regularAttrs.push(...(0, _belSerializer.addCustomAttributes)({
+        [_constants.AJAX_ID]: event[_constants.AJAX_ID] // all AjaxRequest events should have a unique identifier to allow for easier grouping and analysis in the UI
+      }, {
+        addKey: addStringRaw,
+        addVal: addStringRaw
+      }));
 
       // Payload attributes: obfuscate then truncate
       const payloadAttrs = (0, _belSerializer.addCustomAttributes)({
@@ -205,7 +213,10 @@ class Aggregate extends _aggregateBase.AggregateBase {
         ...(event.responseHeaders ? {
           responseHeaders: event.responseHeaders
         } : {})
-      }, addStringWithTruncation);
+      }, {
+        addKey: addStringRaw,
+        addVal: addStringWithTruncation
+      });
       const attrParts = [...regularAttrs, ...payloadAttrs];
       fields.unshift((0, _belSerializer.numeric)(attrParts.length));
       insert += fields.join(',');

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

@@ -140,9 +140,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
       return queryParameters;
     };
     this.events.add(body);
-    if (this.agentRef.runtime.harvester.triggerHarvestFor(this, {
-      sendEmptyBody: true
-    }).ranSend) this.sentRum = true;
+    if (this.agentRef.runtime.harvester.triggerHarvestFor(this).ranSend) this.sentRum = true;
   }
   serializer(eventBuffer) {
     // this is necessary because PVE sends a single item rather than an array; in the case of undefined, this prevents sending [null] as body
@@ -183,9 +181,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
 
     if (this.isRetrying && this.retries++ < 1) {
       // Only retry once
-      setTimeout(() => this.agentRef.runtime.harvester.triggerHarvestFor(this, {
-        sendEmptyBody: true
-      }), 5000); // Retry sending the RUM event after 5 seconds
+      setTimeout(() => this.agentRef.runtime.harvester.triggerHarvestFor(this), 5000); // Retry sending the RUM event after 5 seconds
       return;
     }
     if (status >= 400 || status === 0) {

package/dist/cjs/features/page_view_event/aggregate_v2/index.js

@@ -0,0 +1,109 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Aggregate = void 0;
+var _runtime = require("../../../common/constants/runtime");
+var _navTiming = require("../../../common/timing/nav-timing");
+var _stringify = require("../../../common/util/stringify");
+var CONSTANTS = _interopRequireWildcard(require("../constants"));
+var _initializedFeatures = require("../aggregate/initialized-features");
+var _aggregateBase = require("../../utils/aggregate-base");
+var _firstContentfulPaint = require("../../../common/vitals/first-contentful-paint");
+var _firstPaint = require("../../../common/vitals/first-paint");
+var _timeToFirstByte = require("../../../common/vitals/time-to-first-byte");
+var _obfuscate = require("../../../common/util/obfuscate");
+var _webdriverDetection = require("../../../common/util/webdriver-detection");
+var _events = require("../../../common/constants/events");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+class Aggregate extends _aggregateBase.AggregateBase {
+  static featureName = CONSTANTS.FEATURE_NAME;
+  #timeToFirstByte = 0;
+  #firstByteToWindowLoad = 0; // our "frontend" duration
+  #firstByteToDomContent = 0; // our "dom processing" duration
+  #obfuscator;
+  constructor(agentRef) {
+    super(agentRef, CONSTANTS.FEATURE_NAME);
+    this.#obfuscator = new _obfuscate.Obfuscator(agentRef, _events.EVENT_TYPES.PVE);
+    if (_runtime.isBrowserScope) {
+      _timeToFirstByte.timeToFirstByte.subscribe(({
+        value,
+        attrs
+      }) => {
+        const navEntry = attrs.navigationEntry;
+        this.#timeToFirstByte = Math.max(value, this.#timeToFirstByte);
+        this.#firstByteToWindowLoad = Math.max(Math.round(navEntry.loadEventEnd - this.#timeToFirstByte), this.#firstByteToWindowLoad); // our "frontend" duration
+        this.#firstByteToDomContent = Math.max(Math.round(navEntry.domContentLoadedEventEnd - this.#timeToFirstByte), this.#firstByteToDomContent); // our "dom processing" duration
+      });
+    }
+    this.waitForFlags([]).then(() => {
+      const body = this.#obfuscator.traverseAndObfuscateEvents({
+        ja: {
+          ...agentRef.info.jsAttributes,
+          webdriverDetected: _webdriverDetection.webdriverDetected
+        }
+      });
+      this.events.add(body);
+      this.drain();
+    });
+  }
+  queryStringsBuilder() {
+    const info = this.agentRef.info;
+    const measures = {};
+    if (info.queueTime) measures.qt = info.queueTime;
+    if (info.applicationTime) measures.ap = info.applicationTime;
+
+    // These 3 values should've been recorded after load and before this func runs. They are part of the minimum required for PageView events to be created.
+    // Following PR #428, which demands that the BA must drive entity indexing, these need to be sent even outside of the main window context where PerformanceTiming
+    // or PerformanceNavigationTiming do not exists. Hence, they'll be filled in by 0s instead in, for example, worker threads that still init the PVE module.
+    measures.be = this.#timeToFirstByte;
+    measures.fe = this.#firstByteToWindowLoad;
+    measures.dc = this.#firstByteToDomContent;
+    const queryParameters = {
+      at: info.atts,
+      af: (0, _initializedFeatures.getActivatedFeaturesFlags)(this.agentRef).join(','),
+      igp: this.agentRef.runtime.appMetadata.igp,
+      ...measures,
+      fp: _firstPaint.firstPaint.current.value,
+      fcp: _firstContentfulPaint.firstContentfulPaint.current.value
+    };
+    if (_runtime.globalScope.performance) {
+      const navTimingEntry = (0, _runtime.getNavigationEntry)();
+      if (navTimingEntry) {
+        // Navigation Timing level 2 API that replaced PerformanceTiming & PerformanceNavigation
+        const perf = {
+          timing: (0, _navTiming.addPT)(_runtime.originTime, navTimingEntry, {}),
+          navigation: (0, _navTiming.addPN)(navTimingEntry, {})
+        };
+        queryParameters.perf = (0, _stringify.stringify)(perf);
+      } else if (typeof PerformanceTiming !== 'undefined') {
+        // Modern Safari iFrames and Safari pre-15 do not support level 2 timing.
+        const perf = {
+          timing: (0, _navTiming.addPT)(_runtime.originTime, _runtime.globalScope.performance.timing, {}, true),
+          navigation: (0, _navTiming.addPN)(_runtime.globalScope.performance.navigation, {})
+        };
+        queryParameters.perf = (0, _stringify.stringify)(perf);
+      }
+    }
+    const {
+      correctedOriginTime
+    } = this.agentRef.runtime.timeKeeper;
+    if (correctedOriginTime) queryParameters.timestamp = correctedOriginTime; // a "PageView" is set to represent the page's (server adjusted) origin time rather than when event is recorded/harvested
+
+    return queryParameters;
+  }
+  get harvestEndpointVersion() {
+    return 2;
+  }
+  serializer(eventBuffer) {
+    // this is necessary because PVE sends a single item rather than an array; in the case of undefined, this prevents sending [null] as body
+    return eventBuffer[0];
+  }
+}
+exports.Aggregate = Aggregate;

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

@@ -24,7 +24,12 @@ class Instrument extends _instrumentBase.InstrumentBase {
 
     /** feature specific APIs */
     (0, _setPageViewName.setupSetPageViewNameAPI)(agentRef);
-    this.importAggregator(agentRef, () => Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "page_view_event-aggregate" */'../aggregate'))));
+    this.importAggregator(agentRef, () => {
+      if (agentRef.init.feature_flags.includes('rum_v2')) {
+        return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "page_view_event-aggregate" */'../aggregate_v2')));
+      }
+      return Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "page_view_event-aggregate" */'../aggregate')));
+    });
   }
   setupInspectionEvents() {
     const dispatch = (evt, name) => {

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

@@ -24,6 +24,7 @@ var _loadTime = require("../../../common/vitals/load-time");
 var _webdriverDetection = require("../../../common/util/webdriver-detection");
 var _cleanUrl = require("../../../common/url/clean-url");
 var _events = require("../../../common/constants/events");
+var _payloads = require("../../../common/payloads/payloads");
 /**
  * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -71,7 +72,11 @@ class Aggregate extends _aggregateBase.AggregateBase {
         } = _cumulativeLayoutShift.cumulativeLayoutShift.current;
         if (value === undefined) return;
         this.addTiming(name, value * 1000, attrs);
-      }, true, true); // CLS node should only reports on vis change rather than on every change
+      }, true, true); // CLS node should only report on vis change rather than on every change.
+      /* NOTE: the capture=true is required -- empirically verified against a real browser (Chrome) for CLS
+      timing node to reliably be in the same final harvest as the rest, alongside Harvester#startTimer's
+      queueMicrotask deferral of the EOL harvest itself. Dropping this flag caused CLS to be split into its own,
+      separate, later harvest instead of going out together with pageHide/INP. */
 
       this.drain();
     });
@@ -104,6 +109,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     if (name !== _constants2.VITAL_NAMES.CUMULATIVE_LAYOUT_SHIFT && _cumulativeLayoutShift.cumulativeLayoutShift.current.value >= 0) {
       attrs.cls = _cumulativeLayoutShift.cumulativeLayoutShift.current.value;
     }
+    attrs.webdriverDetected = _webdriverDetection.webdriverDetected;
     const timing = {
       name,
       value,
@@ -133,15 +139,9 @@ class Aggregate extends _aggregateBase.AggregateBase {
       loadState: document.readyState
     });
   }
-  appendGlobalCustomAttributes(timing) {
-    var timingAttributes = timing.attrs || {};
-    var reservedAttributes = ['size', 'eid', 'cls', 'type', 'fid', 'elTag', 'elUrl', 'net-type', 'net-etype', 'net-rtt', 'net-dlink'];
-    Object.entries(this.agentRef.info.jsAttributes || {}).forEach(([key, val]) => {
-      if (reservedAttributes.indexOf(key) < 0) {
-        timingAttributes[key] = val;
-      }
-    });
-    timingAttributes.webdriverDetected = _webdriverDetection.webdriverDetected;
+  #getGlobalCustomAttributes() {
+    const reservedAttributes = ['size', 'eid', 'cls', 'type', 'fid', 'elTag', 'elUrl', 'net-type', 'net-etype', 'net-rtt', 'net-dlink', 'webdriverDetected'];
+    return Object.fromEntries(Object.entries(this.agentRef.info.jsAttributes || {}).filter(([key]) => !reservedAttributes.includes(key)));
   }
   preHarvestChecks() {
     this.checkForFirstInteraction();
@@ -151,15 +151,34 @@ class Aggregate extends _aggregateBase.AggregateBase {
   // serialize array of timing data
   serializer(eventBuffer) {
     if (!eventBuffer?.length) return '';
-    var addString = (0, _belSerializer.getAddStringContext)(this.obfuscator);
+    const {
+      addString,
+      addStringRaw
+    } = (0, _payloads.createStringAdders)(_belSerializer.getAddStringContext, this.obfuscator);
+    const keepOrigValue = {
+      addKey: addStringRaw,
+      addVal: addStringRaw
+    };
+    const obfuscateValue = {
+      addKey: addStringRaw,
+      addVal: addString
+    };
     var payload = 'bel.6;';
     for (var i = 0; i < eventBuffer.length; i++) {
       var timing = eventBuffer[i];
       payload += 'e,';
-      payload += addString(timing.name) + ',';
+      payload += addStringRaw(timing.name) + ',';
       payload += (0, _belSerializer.nullable)(timing.value, _belSerializer.numeric, false) + ',';
-      this.appendGlobalCustomAttributes(timing);
-      var attrParts = (0, _belSerializer.addCustomAttributes)(timing.attrs, addString);
+      const userAttrs = this.#getGlobalCustomAttributes();
+      const {
+        pageUrl,
+        ...systemReservedAttrs
+      } = timing.attrs || {};
+      var attrParts = (0, _belSerializer.addCustomAttributes)(systemReservedAttrs, keepOrigValue);
+      attrParts.push(...(0, _belSerializer.addCustomAttributes)(userAttrs, obfuscateValue));
+      if (pageUrl) attrParts.push(...(0, _belSerializer.addCustomAttributes)({
+        pageUrl
+      }, obfuscateValue));
       if (attrParts && attrParts.length > 0) {
         payload += (0, _belSerializer.numeric)(attrParts.length) + ';' + attrParts.join(';');
       }

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

@@ -44,6 +44,10 @@ class Instrument extends _instrumentBase.InstrumentBase {
         recorder.startRecording(_constants2.TRIGGERS.PRELOAD, session?.sessionReplayMode);
       }); // could handle specific fail-state behaviors with a .catch block here
     }
+
+    // If the aggregate never successfully loads (missing session prerequisite, or the aggregate module itself
+    // fails to import/construct), any preload recording that already started needs to be stopped.
+    this.abortHandler = this.#abort;
     this.importAggregator(this.agentRef, () => Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "session_replay-aggregate" */'../aggregate'))), this);
 
     /** If the recorder is running, we can pass error events on to the agg to help it switch to full mode later */
@@ -108,6 +112,11 @@ class Instrument extends _instrumentBase.InstrumentBase {
       }); // could handle specific fail-state behaviors with a .catch block here
     }
   }
+
+  /** Stops any preload recording that already started if the aggregate never ends up successfully loading. */
+  #abort() {
+    this.recorder?.stopRecording();
+  }
 }
 exports.Instrument = Instrument;
 const SessionReplay = exports.SessionReplay = Instrument;

package/dist/cjs/features/session_replay/shared/recorder.js

@@ -216,7 +216,8 @@ class Recorder {
 
     // We are making an effort to try to keep payloads manageable for unloading.  If they reach the unload limit before their interval,
     // it will send immediately.  This often happens on the first snapshot, which can be significantly larger than the other payloads.
-    if ((this.events.hasSnapshot && this.events.hasMeta || payloadSize > _agentConstants.IDEAL_PAYLOAD_SIZE) && !this.isErrorMode) {
+    // (the aggregate may not exist yet/at all if its own bootstrap hasn't finished or failed -- nothing to harvest for in that case.)
+    if ((this.events.hasSnapshot && this.events.hasMeta || payloadSize > _agentConstants.IDEAL_PAYLOAD_SIZE) && !this.isErrorMode && this.srInstrument.featAggregate) {
       // if we've made it to the ideal size of ~16kb before the interval timer, we should send early.
       this.agentRef.runtime.harvester.triggerHarvestFor(this.srInstrument.featAggregate);
     }

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

@@ -48,6 +48,7 @@ class AjaxNode extends _belNode.BelNode {
   serialize(parentStartTimestamp, agentRef, ajaxObfuscator) {
     const {
       addString,
+      addStringRaw,
       addStringWithTruncation
     } = (0, _payloads.createStringAdders)(_belSerializer.getAddStringContext, ajaxObfuscator);
     const nodeList = [];
@@ -63,13 +64,21 @@ class AjaxNode extends _belNode.BelNode {
     // callbackEnd is relative to end
     (0, _belSerializer.numeric)(this.callbackDuration),
     // not relative
-    addString(this.method), (0, _belSerializer.numeric)(this.status), addString(this.domain), addString(this.path), (0, _belSerializer.numeric)(this.txSize), (0, _belSerializer.numeric)(this.rxSize), this.requestedWith, addString(this.nodeId), (0, _belSerializer.nullable)(this.spanId, addString, true) + (0, _belSerializer.nullable)(this.traceId, addString, true) + (0, _belSerializer.nullable)(this.spanTimestamp, _belSerializer.numeric)];
+    addStringRaw(this.method), (0, _belSerializer.numeric)(this.status), addString(this.domain), addString(this.path), (0, _belSerializer.numeric)(this.txSize), (0, _belSerializer.numeric)(this.rxSize), this.requestedWith, addStringRaw(this.nodeId), (0, _belSerializer.nullable)(this.spanId, addStringRaw, true) + (0, _belSerializer.nullable)(this.traceId, addStringRaw, true) + (0, _belSerializer.nullable)(this.spanTimestamp, _belSerializer.numeric)];
     // Regular attributes: obfuscate only
     const regularAttrs = (0, _belSerializer.addCustomAttributes)({
-      [_constants.AJAX_ID]: this[_constants.AJAX_ID],
       ...(this.targetAttributes || {}),
       ...(this.gql || {})
-    }, addString);
+    }, {
+      addKey: addStringRaw,
+      addVal: addString
+    });
+    regularAttrs.push(...(0, _belSerializer.addCustomAttributes)({
+      [_constants.AJAX_ID]: this[_constants.AJAX_ID]
+    }, {
+      addKey: addStringRaw,
+      addVal: addStringRaw
+    }));
 
     // Payload attributes: obfuscate then truncate
     const payloadAttrs = (0, _belSerializer.addCustomAttributes)({
@@ -88,7 +97,10 @@ class AjaxNode extends _belNode.BelNode {
       ...(this.responseHeaders ? {
         responseHeaders: this.responseHeaders
       } : {})
-    }, addStringWithTruncation);
+    }, {
+      addKey: addStringRaw,
+      addVal: addStringWithTruncation
+    });
     let allAttachedNodes = [...regularAttrs, ...payloadAttrs];
     this.children.forEach(node => allAttachedNodes.push(node.serialize())); // no children is expected under ajax nodes at this time
 

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

@@ -11,6 +11,7 @@ var _now = require("../../../common/timing/now");
 var _cleanUrl = require("../../../common/url/clean-url");
 var _constants = require("../constants");
 var _belNode = require("./bel-node");
+var _payloads = require("../../../common/payloads/payloads");
 /**
  * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -133,7 +134,10 @@ class Interaction extends _belNode.BelNode {
    */
   serialize(firstStartTimeOfPayload, agentRef, interactionObfuscator, ajaxObfuscator) {
     const isFirstIxnOfPayload = firstStartTimeOfPayload === undefined;
-    const addString = (0, _belSerializer.getAddStringContext)(interactionObfuscator);
+    const {
+      addString,
+      addStringRaw
+    } = (0, _payloads.createStringAdders)(_belSerializer.getAddStringContext, interactionObfuscator);
     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;
@@ -149,12 +153,15 @@ class Interaction extends _belNode.BelNode {
     // callbackEnd -- relative to start; not used by BrowserInteraction events so these are always 0
     (0, _belSerializer.numeric)(0),
     // not relative; always 0 for BrowserInteraction
-    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)];
+    addStringRaw(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) + addStringRaw(this.id), addStringRaw(this.nodeId), (0, _belSerializer.nullable)(this.firstPaint, _belSerializer.numeric, true) + (0, _belSerializer.nullable)(this.firstContentfulPaint, _belSerializer.numeric)];
     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
+    const allAttachedNodes = (0, _belSerializer.addCustomAttributes)(customAttributes || {}, {
+      addKey: addStringRaw,
+      addVal: 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.)

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

@@ -7,7 +7,6 @@ exports.AggregateBase = void 0;
 var _featureBase = require("./feature-base");
 var _drain = require("../../common/drain/drain");
 var _features = require("../../loaders/features/features");
-var _harvester = require("../../common/harvest/harvester");
 var _eventBuffer = require("./event-buffer");
 var _handle = require("../../common/event-emitter/handle");
 var _constants = require("../metrics/constants");
@@ -27,7 +26,6 @@ class AggregateBase extends _featureBase.FeatureBase {
    */
   constructor(agentRef, featureName) {
     super(agentRef, featureName);
-    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;
@@ -179,16 +177,6 @@ class AggregateBase extends _featureBase.FeatureBase {
     this.events.clearSave(this.harvestOpts);
   }
 
-  /**
-   * These are actions related to shared resources that should be initialized once by whichever feature Aggregate subclass loads first.
-   * This method should run after checkConfiguration, which may reset the agent's info/runtime object that is used here.
-   */
-  doOnceForAllAggregate(agentRef) {
-    // Note: obfuscator is now created per-feature for their specific event types
-
-    if (!agentRef.runtime.harvester) agentRef.runtime.harvester = new _harvester.Harvester(agentRef);
-  }
-
   /**
    * Report a supportability metric
    * @param {*} metricName The tag of the name matching the Angler aggregation tag

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

@@ -27,6 +27,7 @@ function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r
  * Inherits `blocked` behavior from [FeatureBase]{@link ./feature-base}.
  */
 const checkedAgents = new WeakSet();
+const runtimeBootstrapPromises = new WeakMap();
 
 /**
  * Base class for instrumenting a feature.
@@ -102,32 +103,14 @@ class InstrumentBase extends _featureBase.FeatureBase {
         this.loadedSuccessfully(false);
         return;
       }
-      let session;
       try {
-        if ((0, _featureGates.canEnableSessionTracking)(agentRef.init)) {
-          // would require some setup before certain features start
-          const {
-            setupAgentSession
-          } = await Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "session-manager" */'./agent-session')));
-          session = setupAgentSession(agentRef);
-        }
+        // in the interest of keeping loader file size small, some modules are lazy-loaded as part of the larger async chunk
+        await ensureRuntimeBootstrap(agentRef, this.ee, this.featureName);
       } catch (e) {
-        (0, _console.warn)(20, e);
-        this.ee.emit('internal-error', [e]);
-        (0, _handle.handle)(_agentConstants.SESSION_ERROR, [e], undefined, this.featureName, this.ee);
-      }
-      if (agentRef.init.api.register.allow_iframe_bridge) {
-        try {
-          // This chunk doesn't exist in the lite build (see webpack IgnorePlugin config) since none
-          // of lite's features wire up agent.register -- guard against that rather than letting an
-          // unhandled rejection surface if this flag is ever set on a lite page.
-          const {
-            setupIframeMFEMessageListener
-          } = await Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "iframe-message-handler" */'../../loaders/configure/iframe-message-handler')));
-          setupIframeMFEMessageListener(agentRef);
-        } catch (e) {
-          (0, _console.warn)(23, e);
-        }
+        (0, _console.warn)(79, e);
+        this.ee.abort(); // failed Connector or Harvester will cause entire agent to shutdown
+        this.loadedSuccessfully(false);
+        return;
       }
 
       /**
@@ -135,7 +118,8 @@ class InstrumentBase extends _featureBase.FeatureBase {
        * it's only responsible for aborting its one specific feature, rather than all.
        */
       try {
-        if (!this.#shouldImportAgg(this.featureName, session, agentRef.init)) {
+        if (!this.#shouldImportAgg(this.featureName, agentRef.runtime.session, agentRef.init)) {
+          this.abortHandler?.();
           (0, _drain.drain)(this.agentRef, this.featureName);
           this.loadedSuccessfully(false); // aggregate module isn't loaded at all
           return;
@@ -144,15 +128,14 @@ class InstrumentBase extends _featureBase.FeatureBase {
           Aggregate
         } = await fetchAggregator();
         this.featAggregate = new Aggregate(agentRef, argsObjFromInstrument);
-        agentRef.runtime.harvester.initializedAggregates.push(this.featAggregate); // "subscribe" the feature to future harvest intervals (PVE will start the timer)
+        agentRef.runtime.harvester.initializedAggregates.push(this.featAggregate); // "subscribe" the feature to future harvest intervals
         this.loadedSuccessfully(true);
       } catch (e) {
         (0, _console.warn)(34, e);
-        this.abortHandler?.(); // undo any important alterations made to the page
+        this.abortHandler?.();
         // not supported yet but nice to do: "abort" this agent's EE for this feature specifically
         (0, _drain.drain)(this.agentRef, this.featureName, true);
         this.loadedSuccessfully(false);
-        if (this.ee) this.ee.abort();
       }
     };
 
@@ -212,4 +195,64 @@ class InstrumentBase extends _featureBase.FeatureBase {
     }
   }
 }
-exports.InstrumentBase = InstrumentBase;
+
+/**
+ * Lazily initializes the shared runtime bootstrap for a given agent exactly once. This loads session setup, Connector, and
+ * Harvester through shared async chunks and returns the same in-flight Promise to any concurrent callers.
+ *
+ * Session setup failures are reported but do not stop bootstrap. Connector or Harvester failures are allowed to bubble so the caller can abort the agent.
+ *
+ * @param {Object} agentRef - The agent reference object.
+ * @param {Object} ee - The feature event emitter used for error reporting.
+ * @param {string} featureName - The feature name used when reporting session setup errors.
+ * @returns {Promise<void>} Resolves when the shared bootstrap completes.
+ */
+exports.InstrumentBase = InstrumentBase;
+async function ensureRuntimeBootstrap(agentRef, ee, featureName) {
+  if (runtimeBootstrapPromises.has(agentRef)) return runtimeBootstrapPromises.get(agentRef);
+  const bootstrapPromise = (async () => {
+    if ((0, _featureGates.canEnableSessionTracking)(agentRef.init)) {
+      try {
+        const {
+          setupAgentSession
+        } = await Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "session-manager" */'./agent-session')));
+        setupAgentSession(agentRef); // sets agentRef.runtime.session, if successful
+      } catch (e) {
+        (0, _console.warn)(20, e);
+        ee.emit('internal-error', [e]);
+        (0, _handle.handle)(_agentConstants.SESSION_ERROR, [e], undefined, featureName, ee);
+      }
+    }
+    if (agentRef.init.api.register.allow_iframe_bridge) {
+      try {
+        // This chunk doesn't exist in the lite build (see webpack IgnorePlugin config) since none
+        // of lite's features wire up agent.register -- guard against that rather than letting an
+        // unhandled rejection surface if this flag is ever set on a lite page.
+        const {
+          setupIframeMFEMessageListener
+        } = await Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "iframe-message-handler" */'../../loaders/configure/iframe-message-handler')));
+        setupIframeMFEMessageListener(agentRef);
+      } catch (e) {
+        (0, _console.warn)(23, e);
+      }
+    }
+    const [{
+      Connector
+    }, {
+      Harvester
+    }] = await Promise.all([Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "connector" */'../../common/harvest/connector'))), Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "harvester" */'../../common/harvest/harvester')))]);
+    agentRef.runtime.connector = new Connector(agentRef);
+    agentRef.runtime.harvester = new Harvester(agentRef);
+
+    /* Wait for auto-started features' aggregates to load before starting the harvest timer, so Harvester's EOL
+    listener registers after aggregate-level listeners like web-vitals' CWV APIs. Not awaited here to avoid
+    deadlock, since every feature awaits this same bootstrap promise before its own aggregate load.
+    Only auto-started features are waited on: an autoStart:false feature only registers in drainRegistry once
+    `start` is called, so filtering on that registry excludes any feature that's never started instead of
+    blocking startTimer() forever. */
+    const autoStartedFeatures = Object.values(agentRef.features).filter(feature => agentRef.runtime.drainRegistry.has(feature.featureName));
+    Promise.all(autoStartedFeatures.map(feature => feature.onAggregateImported)).then(() => agentRef.runtime.harvester.startTimer());
+  })();
+  runtimeBootstrapPromises.set(agentRef, bootstrapPromise);
+  await bootstrapPromise;
+}

package/dist/cjs/loaders/agent.js

@@ -96,9 +96,10 @@ class Agent extends _agentBase.AgentBase {
     try {
       const enabledFeatures = (0, _enabledFeatures.getEnabledFeatures)(this.init);
       const featuresToStart = [...this.desiredFeatures];
+      const isRumV2Enabled = this.init.feature_flags.includes('rum_v2');
       featuresToStart.sort((a, b) => _features.featurePriority[a.featureName] - _features.featurePriority[b.featureName]);
       featuresToStart.forEach(InstrumentCtor => {
-        if (!enabledFeatures[InstrumentCtor.featureName] && InstrumentCtor.featureName !== _features.FEATURE_NAMES.pageViewEvent) return; // PVE is required to run even if it's marked disabled
+        if (!enabledFeatures[InstrumentCtor.featureName] && (isRumV2Enabled || InstrumentCtor.featureName !== _features.FEATURE_NAMES.pageViewEvent)) return; // PVE is required to run even if it's marked disabled unless rum_v2 is enabled
 
         const dependencies = (0, _featureDependencies.getFeatureDependencyNames)(InstrumentCtor.featureName);
         const missingDependencies = dependencies.filter(featName => !(featName in this.features)); // any other feature(s) this depends on should've been initialized on prior iterations by priority order

package/dist/cjs/loaders/api/consent.js

@@ -9,7 +9,7 @@ var _sharedHandlers = require("./sharedHandlers");
 var _handle = require("../../common/event-emitter/handle");
 var _console = require("../../common/util/console");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
@@ -29,7 +29,7 @@ function setupConsentAPI(agent) {
       pveInst.onAggregateImported.then(loaded => {
         const pveAgg = pveInst.featAggregate;
         if (loaded && !pveAgg.sentRum) {
-          pveAgg.sendRum();
+          pveAgg.sendRum?.(); // only the old v1 aggregate has a sendRum method that acts as a blocker for the rest of the agent; v2 aggregate will auto report when harvester becomes unblocked
         }
       });
     }

package/dist/cjs/loaders/features/features.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.featurePriority = exports.RUM = exports.LOGS = exports.JSERRORS = exports.FEATURE_TO_ENDPOINT = exports.FEATURE_NAMES = exports.EVENTS = exports.BLOBS = void 0;
+exports.featurePriority = exports.RUM = exports.LOGS = exports.JSERRORS = exports.FEATURE_TO_ENDPOINT = exports.FEATURE_NAMES = exports.EVENTS = exports.CONNECT = exports.BLOBS = void 0;
 /**
  * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -14,6 +14,7 @@ const EVENTS = exports.EVENTS = 'events';
 const JSERRORS = exports.JSERRORS = 'jserrors';
 const BLOBS = exports.BLOBS = 'browser/blobs';
 const RUM = exports.RUM = 'rum';
+const CONNECT = exports.CONNECT = 'connect';
 const LOGS = exports.LOGS = 'browser/logs';
 const FEATURE_NAMES = exports.FEATURE_NAMES = {
   ajax: 'ajax',

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

@@ -38,6 +38,7 @@ const RuntimeModel = {
   disabled: false,
   /** @type {Map<string, {staged: boolean, priority: number}>} */
   drainRegistry: new Map(),
+  connector: undefined,
   harvester: undefined,
   isolatedBacklog: false,
   isRecording: false,