@newrelic/browser-agent 1.322.0 → 1.323.0-rc.1

package/CHANGELOG.md

@@ -3,6 +3,20 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.323.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.322.0...v1.323.0) (2026-09-30)
+
+
+### Features
+
+* Add internal adoption metrics for AJAX Payloads ([#1842](https://github.com/newrelic/newrelic-browser-agent/issues/1842)) ([055b917](https://github.com/newrelic/newrelic-browser-agent/commit/055b9171ef6393da18ee64cc156c51af4ac1498e))
+* Harvest SR on switch from ERROR to FULL mode ([#1864](https://github.com/newrelic/newrelic-browser-agent/issues/1864)) ([b95f9cd](https://github.com/newrelic/newrelic-browser-agent/commit/b95f9cd065225ae4386a75bfa5e7acc4adb528d9))
+
+
+### Bug Fixes
+
+* **ajax:** correct DT header timestamp to server time ([#1867](https://github.com/newrelic/newrelic-browser-agent/issues/1867)) ([5e86506](https://github.com/newrelic/newrelic-browser-agent/commit/5e865062e5162acc7c4ee2924cf7b1db9d8f5685))
+* Ensure timeKeeper readiness on Connector race condition ([#1875](https://github.com/newrelic/newrelic-browser-agent/issues/1875)) ([45de2d8](https://github.com/newrelic/newrelic-browser-agent/commit/45de2d85c730a0dd189ed6f14c7166e89ef3e1a0))
+
 ## [1.322.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.321.0...v1.322.0) (2026-09-11)
 
 

package/README.md

@@ -142,6 +142,27 @@ const options = {
 }
 ```
 
+## AJAX deny list
+
+The browser agent can be configured to exclude specific domains or paths from `AjaxRequest` event tracking using the `ajax.deny_list` setting in the `init` configuration.
+
+```javascript
+const options = {
+  info: { ... },
+  loader_config: { ... },
+  init: {
+    ajax: {
+      deny_list: ["mywebsite.com/photos"]
+    },
+    ...
+  }
+}
+```
+
+<b>Important:</b> Updating the deny list via the app settings page or NerdGraph only updates the `NREUM.init` configuration shown in the copy/paste snippet on the app's *Application settings* page. It doesn't take effect automatically for an agent installed via NPM. If you configure the deny list using one of those methods, you must manually copy over the updated configuration, then rebuild and redeploy your application for the change to take effect.
+
+See [Configure AjaxRequest events](https://docs.newrelic.com/docs/browser/new-relic-browser/configuration/configure-ajax-request-events/) for more information.
+
 ## Options Parameter
 
 The `options` parameter used, or passed in, when instantiating the `BrowserAgent` class can include the following arguments:

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

package/dist/cjs/common/harvest/connector.js

@@ -90,6 +90,8 @@ class Connector {
       if (cachedResp) {
         // Report that we've seen a race condition on updating session state
         (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['Session/RaceCondition/Seen'], undefined, _features.FEATURE_NAMES.metrics, this.#agentRef.ee);
+        // The other tab/agent that wrote this cached response also wrote its own serverTimeDiff to the session around the same time. TimeKeeper was constructed before that happened, so re-check the session now to pick it up.
+        this.#agentRef.runtime.timeKeeper.processStoredDiff();
         // `cachedRumResponse` is stored flat (`{ app, ...flags }`, matching the old v1 RUM response), so re-nest it before applying.
         const {
           app,

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

@@ -121,7 +121,9 @@ class Aggregate extends _aggregateBase.AggregateBase {
     if (ctx.dt) {
       event.spanId = ctx.dt.spanId;
       event.traceId = ctx.dt.traceId;
-      event.spanTimestamp = Math.floor(this.agentRef.runtime.timeKeeper.correctAbsoluteTimestamp(ctx.dt.timestamp));
+      // ctx.dt.timestampCorrected holds the already NR-server-time-corrected value (see distributed-tracing.js) if
+      // timeKeeper was ready when the request started -- reuse it if present, otherwise correct it here now, to avoid double-correcting.
+      event.spanTimestamp = ctx.dt.timestampCorrected ?? Math.floor(this.agentRef.runtime.timeKeeper.correctAbsoluteTimestamp(ctx.dt.timestamp));
     }
     if (event.gql) this.reportSupportabilityMetric('Ajax/Events/GraphQL/Bytes-Added', (0, _stringify.stringify)(event.gql).length);
 
@@ -217,6 +219,10 @@ class Aggregate extends _aggregateBase.AggregateBase {
         addKey: addStringRaw,
         addVal: addStringWithTruncation
       });
+
+      // .length is UTF-16 code units, not true UTF-8 byte size, so this undercounts multi-byte characters -- but it reuses the
+      // already-serialized payloadAttrs strings instead of re-stringifying/byte-counting, which is worth the imprecision here.
+      if (payloadAttrs.length) this.reportSupportabilityMetric('Ajax/Events/Payload/Bytes-Added', payloadAttrs.join(';').length);
       const attrParts = [...regularAttrs, ...payloadAttrs];
       fields.unshift((0, _belSerializer.numeric)(attrParts.length));
       insert += fields.join(',');

package/dist/cjs/features/ajax/instrument/distributed-tracing.js

@@ -9,7 +9,7 @@ var _parseUrl = require("../../../common/url/parse-url");
 var _runtime = require("../../../common/constants/runtime");
 var _stringify = require("../../../common/util/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
  */
 
@@ -31,17 +31,25 @@ class DT {
     var spanId = (0, _uniqueId.generateSpanId)();
     var traceId = (0, _uniqueId.generateTraceId)();
     var timestamp = Date.now();
+    // Correct to NR server time when timeKeeper is available/ready; if it isn't connected yet (e.g. RUM hasn't
+    // completed), accept the uncorrected local timestamp. This only affects the receiving APM agent's computed
+    // transportDuration value on its Span -- it is not used for anything else in this payload.
+    var timestampCorrected;
+    if (this.agentRef.runtime?.timeKeeper?.ready) {
+      timestampCorrected = Math.floor(this.agentRef.runtime.timeKeeper.correctAbsoluteTimestamp(timestamp));
+    }
     var payload = {
       spanId,
       traceId,
-      timestamp
+      timestamp,
+      timestampCorrected
     };
     if (parsedOrigin.sameOrigin || this.isAllowedOrigin(parsedOrigin) && this.useTraceContextHeadersForCors()) {
       payload.traceContextParentHeader = this.generateTraceContextParentHeader(spanId, traceId);
-      payload.traceContextStateHeader = this.generateTraceContextStateHeader(spanId, timestamp, accountId, agentId, trustKey);
+      payload.traceContextStateHeader = this.generateTraceContextStateHeader(spanId, timestampCorrected ?? timestamp, accountId, agentId, trustKey);
     }
     if (parsedOrigin.sameOrigin && !this.excludeNewrelicHeader() || !parsedOrigin.sameOrigin && this.isAllowedOrigin(parsedOrigin) && this.useNewrelicHeaderForCors()) {
-      payload.newrelicHeader = this.generateTraceHeader(spanId, traceId, timestamp, accountId, agentId, trustKey);
+      payload.newrelicHeader = this.generateTraceHeader(spanId, traceId, timestampCorrected ?? timestamp, accountId, agentId, trustKey);
     }
     return payload;
   }

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

@@ -146,13 +146,18 @@ class Aggregate extends _aggregateBase.AggregateBase {
   }
   switchToFull() {
     if (!this.entitled || this.blocked) return;
+    const prevMode = this.mode;
     this.mode = _constants2.MODE.FULL;
+    this.#writeToStorage({
+      sessionReplayMode: this.mode
+    });
+
     // if the error was noticed AFTER the recorder was already imported....
     if (this.recorder && this.initialized) {
+      if (prevMode === _constants2.MODE.ERROR) {
+        this.agentRef.runtime.harvester.triggerHarvestFor(this);
+      }
       if (!this.agentRef.runtime.isRecording) this.recorder.startRecording(_constants.TRIGGERS.SWITCH_TO_FULL, this.mode); // off --> full
-      this.#writeToStorage({
-        sessionReplayMode: this.mode
-      });
     } else {
       this.initializeRecording(_constants2.MODE.FULL, true, _constants.TRIGGERS.SWITCH_TO_FULL);
     }

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

@@ -90,12 +90,12 @@ class Aggregate extends _aggregateBase.AggregateBase {
       (0, _registerHandler.registerHandler)('bstApi', (...args) => this.traceStorage.storeNode(...args), this.featureName, this.ee);
       (0, _registerHandler.registerHandler)('trace-jserror', (...args) => this.traceStorage.storeErrorAgg(...args), this.featureName, this.ee);
       (0, _registerHandler.registerHandler)('pvtAdded', (...args) => this.traceStorage.processPVT(...args), this.featureName, this.ee);
-      if (this.mode === _constants2.MODE.ERROR) {
-        /** A separate handler for noticing errors, and switching to "full" mode if running in "error" mode */
-        (0, _registerHandler.registerHandler)('trace-jserror', () => {
-          if (this.mode === _constants2.MODE.ERROR) this.switchToFull();
-        }, this.featureName, this.ee);
-      }
+    }
+    if (this.mode === _constants2.MODE.ERROR) {
+      /** A separate handler for noticing errors, and switching to "full" mode if running in "error" mode */
+      (0, _registerHandler.registerHandler)('trace-jserror', () => {
+        if (this.mode === _constants2.MODE.ERROR) this.switchToFull();
+      }, this.featureName, this.ee);
     }
     this.agentRef.runtime.session.write({
       sessionTraceMode: this.mode

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

@@ -6,8 +6,11 @@ Object.defineProperty(exports, "__esModule", {
 exports.AjaxNode = void 0;
 var _belSerializer = require("../../../common/serialize/bel-serializer");
 var _payloads = require("../../../common/payloads/payloads");
-var _constants = require("../../ajax/constants");
-var _constants2 = require("../constants");
+var _handle = require("../../../common/event-emitter/handle");
+var _features = require("../../../loaders/features/features");
+var _constants = require("../../metrics/constants");
+var _constants2 = require("../../ajax/constants");
+var _constants3 = require("../constants");
 var _belNode = require("./bel-node");
 /**
  * Copyright 2020-2026 New Relic, Inc. All rights reserved.
@@ -17,7 +20,7 @@ var _belNode = require("./bel-node");
 class AjaxNode extends _belNode.BelNode {
   constructor(ajaxEvent, ajaxContext) {
     super();
-    this.belType = _constants2.NODE_TYPE.AJAX;
+    this.belType = _constants3.NODE_TYPE.AJAX;
     this.method = ajaxEvent.method;
     this.status = ajaxEvent.status;
     this.domain = ajaxEvent.domain;
@@ -30,7 +33,7 @@ class AjaxNode extends _belNode.BelNode {
     this.spanTimestamp = ajaxEvent.spanTimestamp;
     this.gql = ajaxEvent.gql;
     this.targetAttributes = ajaxEvent.targetAttributes;
-    this[_constants.AJAX_ID] = ajaxEvent[_constants.AJAX_ID]; // all AjaxRequest events should have a unique identifier to allow for easier grouping and analysis in the UI
+    this[_constants2.AJAX_ID] = ajaxEvent[_constants2.AJAX_ID]; // all AjaxRequest events should have a unique identifier to allow for easier grouping and analysis in the UI
 
     // optional payload metadata attributes
     this.requestBody = ajaxEvent.requestBody;
@@ -74,7 +77,7 @@ class AjaxNode extends _belNode.BelNode {
       addVal: addString
     });
     regularAttrs.push(...(0, _belSerializer.addCustomAttributes)({
-      [_constants.AJAX_ID]: this[_constants.AJAX_ID]
+      [_constants2.AJAX_ID]: this[_constants2.AJAX_ID]
     }, {
       addKey: addStringRaw,
       addVal: addStringRaw
@@ -101,6 +104,10 @@ class AjaxNode extends _belNode.BelNode {
       addKey: addStringRaw,
       addVal: addStringWithTruncation
     });
+
+    // .length is UTF-16 code units, not true UTF-8 byte size, so this undercounts multi-byte characters -- but it reuses the
+    // already-serialized payloadAttrs strings instead of re-stringifying/byte-counting, which is worth the imprecision here.
+    if (payloadAttrs.length) (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['Ajax/Events/Payload/Bytes-Added', payloadAttrs.join(';').length], undefined, _features.FEATURE_NAMES.metrics, agentRef.ee);
     let allAttachedNodes = [...regularAttrs, ...payloadAttrs];
     this.children.forEach(node => allAttachedNodes.push(node.serialize())); // no children is expected under ajax nodes at this time
 

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

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

package/dist/esm/common/harvest/connector.js

@@ -84,6 +84,8 @@ export class Connector {
       if (cachedResp) {
         // Report that we've seen a race condition on updating session state
         handle(SUPPORTABILITY_METRIC_CHANNEL, ['Session/RaceCondition/Seen'], undefined, FEATURE_NAMES.metrics, this.#agentRef.ee);
+        // The other tab/agent that wrote this cached response also wrote its own serverTimeDiff to the session around the same time. TimeKeeper was constructed before that happened, so re-check the session now to pick it up.
+        this.#agentRef.runtime.timeKeeper.processStoredDiff();
         // `cachedRumResponse` is stored flat (`{ app, ...flags }`, matching the old v1 RUM response), so re-nest it before applying.
         const {
           app,

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

@@ -114,7 +114,9 @@ export class Aggregate extends AggregateBase {
     if (ctx.dt) {
       event.spanId = ctx.dt.spanId;
       event.traceId = ctx.dt.traceId;
-      event.spanTimestamp = Math.floor(this.agentRef.runtime.timeKeeper.correctAbsoluteTimestamp(ctx.dt.timestamp));
+      // ctx.dt.timestampCorrected holds the already NR-server-time-corrected value (see distributed-tracing.js) if
+      // timeKeeper was ready when the request started -- reuse it if present, otherwise correct it here now, to avoid double-correcting.
+      event.spanTimestamp = ctx.dt.timestampCorrected ?? Math.floor(this.agentRef.runtime.timeKeeper.correctAbsoluteTimestamp(ctx.dt.timestamp));
     }
     if (event.gql) this.reportSupportabilityMetric('Ajax/Events/GraphQL/Bytes-Added', stringify(event.gql).length);
 
@@ -210,6 +212,10 @@ export class Aggregate extends AggregateBase {
         addKey: addStringRaw,
         addVal: addStringWithTruncation
       });
+
+      // .length is UTF-16 code units, not true UTF-8 byte size, so this undercounts multi-byte characters -- but it reuses the
+      // already-serialized payloadAttrs strings instead of re-stringifying/byte-counting, which is worth the imprecision here.
+      if (payloadAttrs.length) this.reportSupportabilityMetric('Ajax/Events/Payload/Bytes-Added', payloadAttrs.join(';').length);
       const attrParts = [...regularAttrs, ...payloadAttrs];
       fields.unshift(numeric(attrParts.length));
       insert += fields.join(',');

package/dist/esm/features/ajax/instrument/distributed-tracing.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 { generateSpanId, generateTraceId } from '../../../common/ids/unique-id';
@@ -24,17 +24,25 @@ export class DT {
     var spanId = generateSpanId();
     var traceId = generateTraceId();
     var timestamp = Date.now();
+    // Correct to NR server time when timeKeeper is available/ready; if it isn't connected yet (e.g. RUM hasn't
+    // completed), accept the uncorrected local timestamp. This only affects the receiving APM agent's computed
+    // transportDuration value on its Span -- it is not used for anything else in this payload.
+    var timestampCorrected;
+    if (this.agentRef.runtime?.timeKeeper?.ready) {
+      timestampCorrected = Math.floor(this.agentRef.runtime.timeKeeper.correctAbsoluteTimestamp(timestamp));
+    }
     var payload = {
       spanId,
       traceId,
-      timestamp
+      timestamp,
+      timestampCorrected
     };
     if (parsedOrigin.sameOrigin || this.isAllowedOrigin(parsedOrigin) && this.useTraceContextHeadersForCors()) {
       payload.traceContextParentHeader = this.generateTraceContextParentHeader(spanId, traceId);
-      payload.traceContextStateHeader = this.generateTraceContextStateHeader(spanId, timestamp, accountId, agentId, trustKey);
+      payload.traceContextStateHeader = this.generateTraceContextStateHeader(spanId, timestampCorrected ?? timestamp, accountId, agentId, trustKey);
     }
     if (parsedOrigin.sameOrigin && !this.excludeNewrelicHeader() || !parsedOrigin.sameOrigin && this.isAllowedOrigin(parsedOrigin) && this.useNewrelicHeaderForCors()) {
-      payload.newrelicHeader = this.generateTraceHeader(spanId, traceId, timestamp, accountId, agentId, trustKey);
+      payload.newrelicHeader = this.generateTraceHeader(spanId, traceId, timestampCorrected ?? timestamp, accountId, agentId, trustKey);
     }
     return payload;
   }

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

@@ -142,13 +142,18 @@ export class Aggregate extends AggregateBase {
   }
   switchToFull() {
     if (!this.entitled || this.blocked) return;
+    const prevMode = this.mode;
     this.mode = MODE.FULL;
+    this.#writeToStorage({
+      sessionReplayMode: this.mode
+    });
+
     // if the error was noticed AFTER the recorder was already imported....
     if (this.recorder && this.initialized) {
+      if (prevMode === MODE.ERROR) {
+        this.agentRef.runtime.harvester.triggerHarvestFor(this);
+      }
       if (!this.agentRef.runtime.isRecording) this.recorder.startRecording(TRIGGERS.SWITCH_TO_FULL, this.mode); // off --> full
-      this.#writeToStorage({
-        sessionReplayMode: this.mode
-      });
     } else {
       this.initializeRecording(MODE.FULL, true, TRIGGERS.SWITCH_TO_FULL);
     }

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

@@ -84,12 +84,12 @@ export class Aggregate extends AggregateBase {
       registerHandler('bstApi', (...args) => this.traceStorage.storeNode(...args), this.featureName, this.ee);
       registerHandler('trace-jserror', (...args) => this.traceStorage.storeErrorAgg(...args), this.featureName, this.ee);
       registerHandler('pvtAdded', (...args) => this.traceStorage.processPVT(...args), this.featureName, this.ee);
-      if (this.mode === MODE.ERROR) {
-        /** A separate handler for noticing errors, and switching to "full" mode if running in "error" mode */
-        registerHandler('trace-jserror', () => {
-          if (this.mode === MODE.ERROR) this.switchToFull();
-        }, this.featureName, this.ee);
-      }
+    }
+    if (this.mode === MODE.ERROR) {
+      /** A separate handler for noticing errors, and switching to "full" mode if running in "error" mode */
+      registerHandler('trace-jserror', () => {
+        if (this.mode === MODE.ERROR) this.switchToFull();
+      }, this.featureName, this.ee);
     }
     this.agentRef.runtime.session.write({
       sessionTraceMode: this.mode

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

@@ -4,6 +4,9 @@
  */
 import { addCustomAttributes, getAddStringContext, nullable, numeric } from '../../../common/serialize/bel-serializer';
 import { createStringAdders } from '../../../common/payloads/payloads';
+import { handle } from '../../../common/event-emitter/handle';
+import { FEATURE_NAMES } from '../../../loaders/features/features';
+import { SUPPORTABILITY_METRIC_CHANNEL } from '../../metrics/constants';
 import { AJAX_ID } from '../../ajax/constants';
 import { NODE_TYPE } from '../constants';
 import { BelNode } from './bel-node';
@@ -94,6 +97,10 @@ export class AjaxNode extends BelNode {
       addKey: addStringRaw,
       addVal: addStringWithTruncation
     });
+
+    // .length is UTF-16 code units, not true UTF-8 byte size, so this undercounts multi-byte characters -- but it reuses the
+    // already-serialized payloadAttrs strings instead of re-stringifying/byte-counting, which is worth the imprecision here.
+    if (payloadAttrs.length) handle(SUPPORTABILITY_METRIC_CHANNEL, ['Ajax/Events/Payload/Bytes-Added', payloadAttrs.join(';').length], undefined, FEATURE_NAMES.metrics, agentRef.ee);
     let allAttachedNodes = [...regularAttrs, ...payloadAttrs];
     this.children.forEach(node => allAttachedNodes.push(node.serialize())); // no children is expected under ajax nodes at this time
 

package/dist/types/common/harvest/connector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../../src/common/harvest/connector.js"],"names":[],"mappings":"AAmBA;IAKE,2BAeC;IAED,+CAiBC;;CA+GF"}
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../../src/common/harvest/connector.js"],"names":[],"mappings":"AAmBA;IAKE,2BAeC;IAED,+CAiBC;;CAiHF"}

package/dist/types/features/ajax/aggregate/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/ajax/aggregate/index.js"],"names":[],"mappings":"AAoBA;IACE,2BAAiC;IAEjC,2BA6BC;IAvBC,uBAA4D;IAyB9D,0GA2FC;IAED,+CAOC;IAED,iDAuEC;CACF;8BA1N6B,4BAA4B;2BAK/B,gCAAgC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/ajax/aggregate/index.js"],"names":[],"mappings":"AAoBA;IACE,2BAAiC;IAEjC,2BA6BC;IAvBC,uBAA4D;IAyB9D,0GA2FC;IAED,+CAOC;IAED,iDA2EC;CACF;8BA9N6B,4BAA4B;2BAK/B,gCAAgC"}

package/dist/types/features/ajax/instrument/distributed-tracing.d.ts

@@ -5,6 +5,7 @@ export class DT {
         spanId: string;
         traceId: string;
         timestamp: number;
+        timestampCorrected: number | undefined;
     } | null;
     generateTraceContextParentHeader(spanId: any, traceId: any): string;
     generateTraceContextStateHeader(spanId: any, timestamp: any, accountId: any, appId: any, trustKey: any): string;

package/dist/types/features/ajax/instrument/distributed-tracing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"distributed-tracing.d.ts","sourceRoot":"","sources":["../../../../../src/features/ajax/instrument/distributed-tracing.js"],"names":[],"mappings":"AASA;IACE,2BAEC;IADC,cAAwB;IAG1B;;;;aAsCC;IAED,oEAEC;IAED,gHASC;IAED,yHAsBC;IAID,4CAEC;IAED,4CAkBC;IAGD,iCAMC;IAED,oCAMC;IAED,yCAMC;CACF"}
+{"version":3,"file":"distributed-tracing.d.ts","sourceRoot":"","sources":["../../../../../src/features/ajax/instrument/distributed-tracing.js"],"names":[],"mappings":"AASA;IACE,2BAEC;IADC,cAAwB;IAG1B;;;;;aA8CC;IAED,oEAEC;IAED,gHASC;IAED,yHAsBC;IAID,4CAEC;IAED,4CAkBC;IAGD,iCAMC;IAED,oCAMC;IAED,yCAMC;CACF"}

package/dist/types/features/session_replay/aggregate/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/session_replay/aggregate/index.js"],"names":[],"mappings":"AA2BA;IACE,2BAAiC;IAIjC,sCA+FC;IAlGD,WAAW;IAOT,uBAA0D;IAE1D,iFAAiF;IACjF,qBAAwB;IAGxB,2CAA2C;IAC3C,sDAAwB;IACxB,6CAA6C;IAC7C,gDAAmB;IACnB,+DAA+D;IAC/D,wBAA0B;IAE1B,0BAA0B;IAC1B,kBAAqB;IACrB,6CAA6C;IAC7C,gBAA2B;IAE3B,qBAA2B;IAE3B,cAA8C;IAI9C,kCAAqG;IAqEvG,0BAEC;IAED,0BAMC;IAED,qBAUC;IAED;;;;;;OAMG;IACH,4BALW,OAAO,iBACP,OAAO;;;;;;QAEL,IAAI,CA+ChB;IAED,2BAUC;IAED,0BA0CC;IAED;;;;OAIG;IACH,6BAHW,MAAM,EAAE,GACN;QAAE,UAAU,EAAE,MAAM,GAAC,SAAS,CAAC;QAAC,SAAS,EAAE,MAAM,GAAC,SAAS,CAAA;KAAE,CAUzE;IAED;;;;;;;;;;MAsEC;IAED,sCAcC;IAED;;;;OAIG;IACH,mCAKC;IAED,yDAAyD;IACzD,+CASC;;CAOF;8BAjY6B,4BAA4B;2BAe/B,gCAAgC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/session_replay/aggregate/index.js"],"names":[],"mappings":"AA2BA;IACE,2BAAiC;IAIjC,sCA+FC;IAlGD,WAAW;IAOT,uBAA0D;IAE1D,iFAAiF;IACjF,qBAAwB;IAGxB,2CAA2C;IAC3C,sDAAwB;IACxB,6CAA6C;IAC7C,gDAAmB;IACnB,+DAA+D;IAC/D,wBAA0B;IAE1B,0BAA0B;IAC1B,kBAAqB;IACrB,6CAA6C;IAC7C,gBAA2B;IAE3B,qBAA2B;IAE3B,cAA8C;IAI9C,kCAAqG;IAqEvG,0BAEC;IAED,0BAMC;IAED,qBAeC;IAED;;;;;;OAMG;IACH,4BALW,OAAO,iBACP,OAAO;;;;;;QAEL,IAAI,CA+ChB;IAED,2BAUC;IAED,0BA0CC;IAED;;;;OAIG;IACH,6BAHW,MAAM,EAAE,GACN;QAAE,UAAU,EAAE,MAAM,GAAC,SAAS,CAAC;QAAC,SAAS,EAAE,MAAM,GAAC,SAAS,CAAA;KAAE,CAUzE;IAED;;;;;;;;;;MAsEC;IAED,sCAcC;IAED;;;;OAIG;IACH,mCAKC;IAED,yDAAyD;IACzD,+CASC;;CAOF;8BAtY6B,4BAA4B;2BAe/B,gCAAgC"}

package/dist/types/features/soft_navigations/aggregate/ajax-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ajax-node.d.ts","sourceRoot":"","sources":["../../../../../src/features/soft_navigations/aggregate/ajax-node.js"],"names":[],"mappings":"AAUA;IACE,8CA8BC;IA5BC,gBAA6B;IAC7B,YAA8B;IAC9B,YAA8B;IAC9B,YAA8B;IAC9B,UAA0B;IAC1B,YAAmC;IACnC,YAAoC;IACpC,+BAAwD;IACxD,YAA8B;IAC9B,aAAgC;IAChC,mBAA4C;IAC5C,SAAwB;IACxB,sBAAkD;IAIlD,iBAAwC;IACxC,oBAA8C;IAC9C,kBAA0C;IAC1C,kBAA0C;IAC1C,qBAAgD;IAK9C,iBAAoE;IAKxE,iFAkDC;IAnEC,sBAAkC;CAoErC;wBAtFuB,YAAY"}
+{"version":3,"file":"ajax-node.d.ts","sourceRoot":"","sources":["../../../../../src/features/soft_navigations/aggregate/ajax-node.js"],"names":[],"mappings":"AAaA;IACE,8CA8BC;IA5BC,gBAA6B;IAC7B,YAA8B;IAC9B,YAA8B;IAC9B,YAA8B;IAC9B,UAA0B;IAC1B,YAAmC;IACnC,YAAoC;IACpC,+BAAwD;IACxD,YAA8B;IAC9B,aAAgC;IAChC,mBAA4C;IAC5C,SAAwB;IACxB,sBAAkD;IAIlD,iBAAwC;IACxC,oBAA8C;IAC9C,kBAA0C;IAC1C,kBAA0C;IAC1C,qBAAgD;IAK9C,iBAAoE;IAKxE,iFAsDC;IAvEC,sBAAkC;CAwErC;wBA1FuB,YAAY"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newrelic/browser-agent",
-  "version": "1.322.0",
+  "version": "1.323.0-rc.1",
   "private": false,
   "author": "New Relic Browser Agent Team <browser-agent@newrelic.com>",
   "description": "New Relic Browser Agent",
@@ -206,7 +206,10 @@
     "test-server": "node ./tools/wdio/bin/server",
     "lt:update-browsers": "node ./tools/browsers-lists/lt-update-supported.mjs",
     "lt:upload-webview-assets": "node ./tools/lambda-test/upload-webview-assets.mjs",
+    "build:frameworks": "npm run build:npm && npm --prefix ./tools/test-builds run build-frameworks",
     "tools:test-builds": "npm --prefix ./tools/test-builds run build-all",
+    "test-builds:bump-latest": "node ./tools/test-builds/bump-latest.mjs",
+    "test-builds:framework-report": "node ./tools/test-builds/generate-framework-report.mjs",
     "third-party-updates": "oss third-party manifest --includeOptDeps && oss third-party notices --includeOptDeps",
     "prepare": "husky install",
     "npm:build:esm": "npx babel --env-name npm-esm --out-dir dist/esm --out-file-extension .js ./src",
@@ -294,4 +297,4 @@
     "README.md",
     "CHANGELOG.md"
   ]
-}
+}

package/src/common/harvest/connector.js

@@ -73,6 +73,8 @@ export class Connector {
       if (cachedResp) {
         // Report that we've seen a race condition on updating session state
         handle(SUPPORTABILITY_METRIC_CHANNEL, ['Session/RaceCondition/Seen'], undefined, FEATURE_NAMES.metrics, this.#agentRef.ee)
+        // The other tab/agent that wrote this cached response also wrote its own serverTimeDiff to the session around the same time. TimeKeeper was constructed before that happened, so re-check the session now to pick it up.
+        this.#agentRef.runtime.timeKeeper.processStoredDiff()
         // `cachedRumResponse` is stored flat (`{ app, ...flags }`, matching the old v1 RUM response), so re-nest it before applying.
         const { app, ...config } = cachedResp
         this.#applyConnectResponse({ app, config })

package/src/features/ajax/aggregate/index.js

@@ -129,9 +129,9 @@ export class Aggregate extends AggregateBase {
     if (ctx.dt) {
       event.spanId = ctx.dt.spanId
       event.traceId = ctx.dt.traceId
-      event.spanTimestamp = Math.floor(
-        this.agentRef.runtime.timeKeeper.correctAbsoluteTimestamp(ctx.dt.timestamp)
-      )
+      // ctx.dt.timestampCorrected holds the already NR-server-time-corrected value (see distributed-tracing.js) if
+      // timeKeeper was ready when the request started -- reuse it if present, otherwise correct it here now, to avoid double-correcting.
+      event.spanTimestamp = ctx.dt.timestampCorrected ?? Math.floor(this.agentRef.runtime.timeKeeper.correctAbsoluteTimestamp(ctx.dt.timestamp))
     }
 
     if (event.gql) this.reportSupportabilityMetric('Ajax/Events/GraphQL/Bytes-Added', stringify(event.gql).length)
@@ -212,6 +212,10 @@ export class Aggregate extends AggregateBase {
         ...(event.responseHeaders ? { responseHeaders: event.responseHeaders } : {})
       }, { addKey: addStringRaw, addVal: addStringWithTruncation })
 
+      // .length is UTF-16 code units, not true UTF-8 byte size, so this undercounts multi-byte characters -- but it reuses the
+      // already-serialized payloadAttrs strings instead of re-stringifying/byte-counting, which is worth the imprecision here.
+      if (payloadAttrs.length) this.reportSupportabilityMetric('Ajax/Events/Payload/Bytes-Added', payloadAttrs.join(';').length)
+
       const attrParts = [...regularAttrs, ...payloadAttrs]
       fields.unshift(numeric(attrParts.length))
 

package/src/features/ajax/instrument/distributed-tracing.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 { generateSpanId, generateTraceId } from '../../../common/ids/unique-id'
@@ -29,23 +29,31 @@ export class DT {
     var spanId = generateSpanId()
     var traceId = generateTraceId()
     var timestamp = Date.now()
+    // Correct to NR server time when timeKeeper is available/ready; if it isn't connected yet (e.g. RUM hasn't
+    // completed), accept the uncorrected local timestamp. This only affects the receiving APM agent's computed
+    // transportDuration value on its Span -- it is not used for anything else in this payload.
+    var timestampCorrected
+    if (this.agentRef.runtime?.timeKeeper?.ready) {
+      timestampCorrected = Math.floor(this.agentRef.runtime.timeKeeper.correctAbsoluteTimestamp(timestamp))
+    }
 
     var payload = {
       spanId,
       traceId,
-      timestamp
+      timestamp,
+      timestampCorrected
     }
 
     if (parsedOrigin.sameOrigin ||
         (this.isAllowedOrigin(parsedOrigin) && this.useTraceContextHeadersForCors())) {
       payload.traceContextParentHeader = this.generateTraceContextParentHeader(spanId, traceId)
-      payload.traceContextStateHeader = this.generateTraceContextStateHeader(spanId, timestamp,
+      payload.traceContextStateHeader = this.generateTraceContextStateHeader(spanId, timestampCorrected ?? timestamp,
         accountId, agentId, trustKey)
     }
 
     if ((parsedOrigin.sameOrigin && !this.excludeNewrelicHeader()) ||
         (!parsedOrigin.sameOrigin && this.isAllowedOrigin(parsedOrigin) && this.useNewrelicHeaderForCors())) {
-      payload.newrelicHeader = this.generateTraceHeader(spanId, traceId, timestamp, accountId,
+      payload.newrelicHeader = this.generateTraceHeader(spanId, traceId, timestampCorrected ?? timestamp, accountId,
         agentId, trustKey)
     }
 

package/src/features/session_replay/aggregate/index.js

@@ -141,11 +141,16 @@ export class Aggregate extends AggregateBase {
 
   switchToFull () {
     if (!this.entitled || this.blocked) return
+    const prevMode = this.mode
     this.mode = MODE.FULL
+    this.#writeToStorage({ sessionReplayMode: this.mode })
+
     // if the error was noticed AFTER the recorder was already imported....
     if (this.recorder && this.initialized) {
+      if (prevMode === MODE.ERROR) {
+        this.agentRef.runtime.harvester.triggerHarvestFor(this)
+      }
       if (!this.agentRef.runtime.isRecording) this.recorder.startRecording(TRIGGERS.SWITCH_TO_FULL, this.mode) // off --> full
-      this.#writeToStorage({ sessionReplayMode: this.mode })
     } else {
       this.initializeRecording(MODE.FULL, true, TRIGGERS.SWITCH_TO_FULL)
     }

package/src/features/session_trace/aggregate/index.js

@@ -90,13 +90,13 @@ export class Aggregate extends AggregateBase {
       registerHandler('bstApi', (...args) => this.traceStorage.storeNode(...args), this.featureName, this.ee)
       registerHandler('trace-jserror', (...args) => this.traceStorage.storeErrorAgg(...args), this.featureName, this.ee)
       registerHandler('pvtAdded', (...args) => this.traceStorage.processPVT(...args), this.featureName, this.ee)
+    }
 
-      if (this.mode === MODE.ERROR) {
-        /** A separate handler for noticing errors, and switching to "full" mode if running in "error" mode */
-        registerHandler('trace-jserror', () => {
-          if (this.mode === MODE.ERROR) this.switchToFull()
-        }, this.featureName, this.ee)
-      }
+    if (this.mode === MODE.ERROR) {
+      /** A separate handler for noticing errors, and switching to "full" mode if running in "error" mode */
+      registerHandler('trace-jserror', () => {
+        if (this.mode === MODE.ERROR) this.switchToFull()
+      }, this.featureName, this.ee)
     }
     this.agentRef.runtime.session.write({ sessionTraceMode: this.mode })
 

package/src/features/soft_navigations/aggregate/ajax-node.js

@@ -4,6 +4,9 @@
  */
 import { addCustomAttributes, getAddStringContext, nullable, numeric } from '../../../common/serialize/bel-serializer'
 import { createStringAdders } from '../../../common/payloads/payloads'
+import { handle } from '../../../common/event-emitter/handle'
+import { FEATURE_NAMES } from '../../../loaders/features/features'
+import { SUPPORTABILITY_METRIC_CHANNEL } from '../../metrics/constants'
 import { AJAX_ID } from '../../ajax/constants'
 import { NODE_TYPE } from '../constants'
 import { BelNode } from './bel-node'
@@ -83,6 +86,10 @@ export class AjaxNode extends BelNode {
       ...(this.responseHeaders ? { responseHeaders: this.responseHeaders } : {})
     }, { addKey: addStringRaw, addVal: addStringWithTruncation })
 
+    // .length is UTF-16 code units, not true UTF-8 byte size, so this undercounts multi-byte characters -- but it reuses the
+    // already-serialized payloadAttrs strings instead of re-stringifying/byte-counting, which is worth the imprecision here.
+    if (payloadAttrs.length) handle(SUPPORTABILITY_METRIC_CHANNEL, ['Ajax/Events/Payload/Bytes-Added', payloadAttrs.join(';').length], undefined, FEATURE_NAMES.metrics, agentRef.ee)
+
     let allAttachedNodes = [...regularAttrs, ...payloadAttrs]
     this.children.forEach(node => allAttachedNodes.push(node.serialize())) // no children is expected under ajax nodes at this time