@newrelic/browser-agent 1.247.0 → 1.249.0

package/CHANGELOG.md

@@ -3,6 +3,32 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.249.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.248.0...v1.249.0) (2023-12-14)
+
+
+### Features
+
+* Allow empty string for Session Replay masking value ([#831](https://github.com/newrelic/newrelic-browser-agent/issues/831)) ([34f837f](https://github.com/newrelic/newrelic-browser-agent/commit/34f837f65ab31a67b821f125e20e80d39d7790a9))
+
+
+### Bug Fixes
+
+* Fix API Warning Messages ([#830](https://github.com/newrelic/newrelic-browser-agent/issues/830)) ([2b13a0f](https://github.com/newrelic/newrelic-browser-agent/commit/2b13a0fdfad529dc1cfff43506e28473498ce8a1))
+* loader missing sub-resource integrity hashes ([#837](https://github.com/newrelic/newrelic-browser-agent/issues/837)) ([a9b6f2e](https://github.com/newrelic/newrelic-browser-agent/commit/a9b6f2e578b1684dd50f8eb491251c03eca88a12))
+* traceids not random when using `webcrypto` ([#825](https://github.com/newrelic/newrelic-browser-agent/issues/825)) ([e264acf](https://github.com/newrelic/newrelic-browser-agent/commit/e264acfbff2cacc93fae88daea70be3c1e006f90))
+
+## [1.248.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.247.0...v1.248.0) (2023-11-16)
+
+
+### Features
+
+* Report enduser.id with Session Replay ([#815](https://github.com/newrelic/newrelic-browser-agent/issues/815)) ([8f5446d](https://github.com/newrelic/newrelic-browser-agent/commit/8f5446d1f7679f6a5ea0ba90eb082d1d4deb0d93))
+
+
+### Bug Fixes
+
+* Fix issue with errors forcefully triggering session traces ([#819](https://github.com/newrelic/newrelic-browser-agent/issues/819)) ([3872c35](https://github.com/newrelic/newrelic-browser-agent/commit/3872c35a173f76644b663df5ca0474971451b7cf))
+
 ## [1.247.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.246.1...v1.247.0) (2023-11-14)
 
 

package/dist/cjs/common/config/state/init.js

@@ -11,6 +11,7 @@ var _constants = require("../../session/constants");
 var _console = require("../../util/console");
 var _nreum = require("../../window/nreum");
 var _configurable = require("./configurable");
+const nrMask = '[data-nr-mask]';
 const model = () => {
   const hiddenState = {
     mask_selector: '*',
@@ -124,8 +125,7 @@ const model = () => {
         return hiddenState.mask_selector;
       },
       set mask_text_selector(val) {
-        if ((0, _querySelector.isValidSelector)(val)) hiddenState.mask_selector = val + ',[data-nr-mask]';else if (val === null) hiddenState.mask_selector = val; // null is acceptable, which completely disables the behavior
-        else (0, _console.warn)('An invalid session_replay.mask_selector was provided and will not be used', val);
+        if ((0, _querySelector.isValidSelector)(val)) hiddenState.mask_selector = "".concat(val, ",").concat(nrMask);else if (val === '' || val === null) hiddenState.mask_selector = nrMask;else (0, _console.warn)('An invalid session_replay.mask_selector was provided. \'*\' will be used.', val);
       },
       // these properties only have getters because they are enforcable constants and should error if someone tries to override them
       get block_class() {

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

@@ -12,7 +12,7 @@ exports.VERSION = exports.RRWEB_VERSION = exports.DIST_METHOD = exports.BUILD_EN
 /**
  * Exposes the version of the agent
  */
-const VERSION = "1.247.0";
+const VERSION = "1.249.0";
 
 /**
  * Exposes the build type of the agent

package/dist/cjs/common/constants/env.npm.js

@@ -12,7 +12,7 @@ exports.VERSION = exports.RRWEB_VERSION = exports.DIST_METHOD = exports.BUILD_EN
 /**
  * Exposes the version of the agent
  */
-const VERSION = "1.247.0";
+const VERSION = "1.249.0";
 
 /**
  * Exposes the build type of the agent

package/dist/cjs/common/ids/unique-id.js

@@ -50,12 +50,13 @@ function generateUuid() {
   let randomValueTable;
   let randomValueIndex = 0;
   if (crypto && crypto.getRandomValues) {
+    // For a UUID, we only need 30 characters since two characters are pre-defined
     // eslint-disable-next-line
-    randomValueTable = crypto.getRandomValues(new Uint8Array(31));
+    randomValueTable = crypto.getRandomValues(new Uint8Array(30));
   }
   return uuidv4Template.split('').map(templateInput => {
     if (templateInput === 'x') {
-      return getRandomValue(randomValueTable, ++randomValueIndex).toString(16);
+      return getRandomValue(randomValueTable, randomValueIndex++).toString(16);
     } else if (templateInput === 'y') {
       // this is the uuid variant per spec (8, 9, a, b)
       // % 4, then shift to get values 8-11
@@ -78,7 +79,7 @@ function generateRandomHexString(length) {
   let randomValueIndex = 0;
   if (crypto && crypto.getRandomValues) {
     // eslint-disable-next-line
-    randomValueTable = crypto.getRandomValues(new Uint8Array(31));
+    randomValueTable = crypto.getRandomValues(new Uint8Array(length));
   }
   const chars = [];
   for (var i = 0; i < length; i++) {

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

@@ -71,8 +71,10 @@ const MAX_PAYLOAD_SIZE = 1000000;
 /** Unloading caps around 64kb */
 exports.MAX_PAYLOAD_SIZE = MAX_PAYLOAD_SIZE;
 const IDEAL_PAYLOAD_SIZE = 64000;
-/** Interval between forcing new full snapshots -- 15 seconds in error mode (x2), 5 minutes in full mode */
+/** Reserved room for query param attrs */
 exports.IDEAL_PAYLOAD_SIZE = IDEAL_PAYLOAD_SIZE;
+const QUERY_PARAM_PADDING = 5000;
+/** Interval between forcing new full snapshots -- 15 seconds in error mode (x2), 5 minutes in full mode */
 const CHECKOUT_MS = {
   [_sessionEntity.MODE.ERROR]: 15000,
   [_sessionEntity.MODE.FULL]: 300000,
@@ -298,6 +300,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
   getHarvestContents() {
     const agentRuntime = (0, _config.getRuntime)(this.agentIdentifier);
     const info = (0, _config.getInfo)(this.agentIdentifier);
+    const endUserId = info.jsAttributes?.['enduser.id'];
     if (this.backloggedEvents.length) this.events = [...this.backloggedEvents, ...this.events];
 
     // do not let the first node be a full snapshot node, since this NEEDS to be preceded by a meta node
@@ -330,6 +333,8 @@ class Aggregate extends _aggregateBase.AggregateBase {
         app_id: info.applicationID,
         protocol_version: '0',
         attributes: (0, _encode.obj)({
+          // this section of attributes must be controllable and stay below the query param padding limit -- see QUERY_PARAM_PADDING
+          // if not, data could be lost to truncation at time of sending, potentially breaking parsing / API behavior in NR1
           ...(this.shouldCompress && {
             content_encoding: 'gzip'
           }),
@@ -347,8 +352,13 @@ class Aggregate extends _aggregateBase.AggregateBase {
           hasError: this.hasError,
           isFirstChunk: agentRuntime.session.state.sessionReplaySentFirstChunk === false,
           decompressedBytes: this.payloadBytesEstimation,
-          'rrweb.version': _env.RRWEB_VERSION
-        }, MAX_PAYLOAD_SIZE - this.payloadBytesEstimation).substring(1) // remove the leading '&'
+          'rrweb.version': _env.RRWEB_VERSION,
+          // customer-defined data should go last so that if it exceeds the query param padding limit it will be truncated instead of important attrs
+          ...(endUserId && {
+            'enduser.id': endUserId
+          })
+          // The Query Param is being arbitrarily limited in length here.  It is also applied when estimating the size of the payload in getPayloadSize()
+        }, QUERY_PARAM_PADDING).substring(1) // remove the leading '&'
       },
 
       body: this.events
@@ -470,8 +480,8 @@ class Aggregate extends _aggregateBase.AggregateBase {
   /** Estimate the payload size */
   getPayloadSize() {
     let newBytes = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;
-    // the 1KB gives us some padding for the other metadata
-    return this.estimateCompression(this.payloadBytesEstimation + newBytes) + 1000;
+    // the query param padding constant gives us some padding for the other metadata to be safely injected
+    return this.estimateCompression(this.payloadBytesEstimation + newBytes) + QUERY_PARAM_PADDING;
   }
 
   /**

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

@@ -102,6 +102,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
      * "external" input in this case means errors thrown on the page or session replay itself being triggered to run in full mode by the API, which updates the session entity.
      */
     const switchToFull = () => {
+      if (this.agentRuntime?.session?.state?.sessionReplayMode !== _sessionEntity.MODE.FULL) return;
       if (mostRecentModeKnown !== _sessionEntity.MODE.FULL) {
         const prevMode = mostRecentModeKnown;
         mostRecentModeKnown = _sessionEntity.MODE.FULL;

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

@@ -23,6 +23,8 @@ var _firstContentfulPaint = require("../../../common/vitals/first-contentful-pai
 var _firstPaint = require("../../../common/vitals/first-paint");
 var _bundleId = require("../../../common/ids/bundle-id");
 var _runtime = require("../../../common/constants/runtime");
+var _handle = require("../../../common/event-emitter/handle");
+var _constants2 = require("../../metrics/constants");
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
 /*
@@ -672,6 +674,9 @@ class Aggregate extends _aggregateBase.AggregateBase {
       }
       baseEE.emit('interactionSaved', [interaction]);
       state.interactionsToHarvest.push(interaction);
+      let smCategory = 'RouteChange';
+      if (interaction.root?.attrs?.trigger === 'initialPageLoad') smCategory = 'InitialPageLoad';else if (interaction.root?.attrs?.trigger === 'api') 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);
       scheduler.scheduleHarvest(0);
     }
     function isEnabled() {

package/dist/cjs/loaders/agent-base.js

@@ -8,6 +8,11 @@ var _console = require("../common/util/console");
 /* eslint-disable n/handle-callback-err */
 
 class AgentBase {
+  /** Generates a generic warning message with the api name injected */
+  #warnMessage(api) {
+    return "Call to agent api ".concat(api, " failed. The agent is not currently initialized.");
+  }
+
   /**
    * Reports a browser PageAction event along with a name and optional attributes.
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/addpageaction/}
@@ -15,7 +20,7 @@ class AgentBase {
    * @param {object} [attributes] JSON object with one or more key/value pairs. For example: {key:"value"}. The key is reported as its own PageAction attribute with the specified values.
    */
   addPageAction(name, attributes) {
-    (0, _console.warn)('Call to agent api addPageAction failed. The page action feature is not currently initialized.');
+    (0, _console.warn)(this.#warnMessage('addPageAction'));
   }
 
   /**
@@ -25,7 +30,7 @@ class AgentBase {
    * @param {string} [host] Default is http://custom.transaction. Typically set host to your site's domain URI.
    */
   setPageViewName(name, host) {
-    (0, _console.warn)('Call to agent api setPageViewName failed. The page view feature is not currently initialized.');
+    (0, _console.warn)(this.#warnMessage('setPageViewName'));
   }
 
   /**
@@ -36,7 +41,7 @@ class AgentBase {
    * @param {boolean} [persist] Default false. f set to true, the name-value pair will also be set into the browser's storage API. Then on the following instrumented pages that load within the same session, the pair will be re-applied as a custom attribute.
    */
   setCustomAttribute(name, value, persist) {
-    (0, _console.warn)('Call to agent api setCustomAttribute failed. The js errors feature is not currently initialized.');
+    (0, _console.warn)(this.#warnMessage('setCustomAttribute'));
   }
 
   /**
@@ -46,7 +51,7 @@ class AgentBase {
    * @param {object} [customAttributes] An object containing name/value pairs representing custom attributes.
    */
   noticeError(error, customAttributes) {
-    (0, _console.warn)('Call to agent api noticeError failed. The js errors feature is not currently initialized.');
+    (0, _console.warn)(this.#warnMessage('noticeError'));
   }
 
   /**
@@ -55,7 +60,7 @@ class AgentBase {
    * @param {string|null} value A string identifier for the end-user, useful for tying all browser events to specific users. The value parameter does not have to be unique. If IDs should be unique, the caller is responsible for that validation. Passing a null value unsets any existing user ID.
    */
   setUserId(value) {
-    (0, _console.warn)('Call to agent api setUserId failed. The js errors feature is not currently initialized.');
+    (0, _console.warn)(this.#warnMessage('setUserId'));
   }
 
   /**
@@ -67,7 +72,7 @@ class AgentBase {
    * have to be unique. Passing a null value unsets any existing value.
    */
   setApplicationVersion(value) {
-    (0, _console.warn)('Call to agent api setApplicationVersion failed. The agent is not currently initialized.');
+    (0, _console.warn)(this.#warnMessage('setApplicationVersion'));
   }
 
   /**
@@ -76,16 +81,16 @@ class AgentBase {
    * @param {(error: Error|string) => boolean | { group: string }} callback When an error occurs, the callback is called with the error object as a parameter. The callback will be called with each error, so it is not specific to one error.
    */
   setErrorHandler(callback) {
-    (0, _console.warn)('Call to agent api setErrorHandler failed. The js errors feature is not currently initialized.');
+    (0, _console.warn)(this.#warnMessage('setErrorHandler'));
   }
 
   /**
-   * Records an additional time point as "finished" in a session trace, and sends the event to New Relic.
+   * Records an additional time point as "finished" in a session trace and adds a page action.
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/finished/}
    * @param {number} [timeStamp] Defaults to the current time of the call. If used, this marks the time that the page is "finished" according to your own criteria.
    */
   finished(timeStamp) {
-    (0, _console.warn)('Call to agent api finished failed. The page action feature is not currently initialized.');
+    (0, _console.warn)(this.#warnMessage('finished'));
   }
 
   /**
@@ -95,7 +100,7 @@ class AgentBase {
    * @param {string} id The ID or version of this release; for example, a version number, build number from your CI environment, GitHub SHA, GUID, or a hash of the contents.
    */
   addRelease(name, id) {
-    (0, _console.warn)('Call to agent api addRelease failed. The js errors feature is not currently initialized.');
+    (0, _console.warn)(this.#warnMessage('addRelease'));
   }
 
   /**
@@ -104,7 +109,7 @@ class AgentBase {
    * @param {string|string[]} [featureNames] The name(s) of the features to start.  If no name(s) are passed, all features will be started
    */
   start(featureNames) {
-    (0, _console.warn)('Call to agent api addRelease failed. The agent is not currently initialized.');
+    (0, _console.warn)(this.#warnMessage('start'));
   }
 
   /**
@@ -113,7 +118,7 @@ class AgentBase {
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/recordReplay/}
    */
   recordReplay() {
-    (0, _console.warn)('Call to agent api recordReplay failed. The agent is not currently initialized.');
+    (0, _console.warn)(this.#warnMessage('recordReplay'));
   }
 
   /**
@@ -123,7 +128,7 @@ class AgentBase {
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/recordReplay/}
    */
   pauseReplay() {
-    (0, _console.warn)('Call to agent api pauseReplay failed. The agent is not currently initialized.');
+    (0, _console.warn)(this.#warnMessage('pauseReplay'));
   }
 }
 exports.AgentBase = AgentBase;

package/dist/esm/common/config/state/init.js

@@ -3,6 +3,7 @@ import { DEFAULT_EXPIRES_MS, DEFAULT_INACTIVE_MS } from '../../session/constants
 import { warn } from '../../util/console';
 import { getNREUMInitializedAgent } from '../../window/nreum';
 import { getModeledObject } from './configurable';
+const nrMask = '[data-nr-mask]';
 const model = () => {
   const hiddenState = {
     mask_selector: '*',
@@ -116,8 +117,7 @@ const model = () => {
         return hiddenState.mask_selector;
       },
       set mask_text_selector(val) {
-        if (isValidSelector(val)) hiddenState.mask_selector = val + ',[data-nr-mask]';else if (val === null) hiddenState.mask_selector = val; // null is acceptable, which completely disables the behavior
-        else warn('An invalid session_replay.mask_selector was provided and will not be used', val);
+        if (isValidSelector(val)) hiddenState.mask_selector = "".concat(val, ",").concat(nrMask);else if (val === '' || val === null) hiddenState.mask_selector = nrMask;else warn('An invalid session_replay.mask_selector was provided. \'*\' will be used.', val);
       },
       // these properties only have getters because they are enforcable constants and should error if someone tries to override them
       get block_class() {

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

@@ -6,7 +6,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.247.0";
+export const VERSION = "1.249.0";
 
 /**
  * Exposes the build type of the agent

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

@@ -6,7 +6,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.247.0";
+export const VERSION = "1.249.0";
 
 /**
  * Exposes the build type of the agent

package/dist/esm/common/ids/unique-id.js

@@ -41,12 +41,13 @@ export function generateUuid() {
   let randomValueTable;
   let randomValueIndex = 0;
   if (crypto && crypto.getRandomValues) {
+    // For a UUID, we only need 30 characters since two characters are pre-defined
     // eslint-disable-next-line
-    randomValueTable = crypto.getRandomValues(new Uint8Array(31));
+    randomValueTable = crypto.getRandomValues(new Uint8Array(30));
   }
   return uuidv4Template.split('').map(templateInput => {
     if (templateInput === 'x') {
-      return getRandomValue(randomValueTable, ++randomValueIndex).toString(16);
+      return getRandomValue(randomValueTable, randomValueIndex++).toString(16);
     } else if (templateInput === 'y') {
       // this is the uuid variant per spec (8, 9, a, b)
       // % 4, then shift to get values 8-11
@@ -69,7 +70,7 @@ export function generateRandomHexString(length) {
   let randomValueIndex = 0;
   if (crypto && crypto.getRandomValues) {
     // eslint-disable-next-line
-    randomValueTable = crypto.getRandomValues(new Uint8Array(31));
+    randomValueTable = crypto.getRandomValues(new Uint8Array(length));
   }
   const chars = [];
   for (var i = 0; i < length; i++) {

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

@@ -63,6 +63,8 @@ let recorder, gzipper, u8;
 export const MAX_PAYLOAD_SIZE = 1000000;
 /** Unloading caps around 64kb */
 export const IDEAL_PAYLOAD_SIZE = 64000;
+/** Reserved room for query param attrs */
+const QUERY_PARAM_PADDING = 5000;
 /** Interval between forcing new full snapshots -- 15 seconds in error mode (x2), 5 minutes in full mode */
 const CHECKOUT_MS = {
   [MODE.ERROR]: 15000,
@@ -289,6 +291,7 @@ export class Aggregate extends AggregateBase {
   getHarvestContents() {
     const agentRuntime = getRuntime(this.agentIdentifier);
     const info = getInfo(this.agentIdentifier);
+    const endUserId = info.jsAttributes?.['enduser.id'];
     if (this.backloggedEvents.length) this.events = [...this.backloggedEvents, ...this.events];
 
     // do not let the first node be a full snapshot node, since this NEEDS to be preceded by a meta node
@@ -321,6 +324,8 @@ export class Aggregate extends AggregateBase {
         app_id: info.applicationID,
         protocol_version: '0',
         attributes: encodeObj({
+          // this section of attributes must be controllable and stay below the query param padding limit -- see QUERY_PARAM_PADDING
+          // if not, data could be lost to truncation at time of sending, potentially breaking parsing / API behavior in NR1
           ...(this.shouldCompress && {
             content_encoding: 'gzip'
           }),
@@ -338,8 +343,13 @@ export class Aggregate extends AggregateBase {
           hasError: this.hasError,
           isFirstChunk: agentRuntime.session.state.sessionReplaySentFirstChunk === false,
           decompressedBytes: this.payloadBytesEstimation,
-          'rrweb.version': RRWEB_VERSION
-        }, MAX_PAYLOAD_SIZE - this.payloadBytesEstimation).substring(1) // remove the leading '&'
+          'rrweb.version': RRWEB_VERSION,
+          // customer-defined data should go last so that if it exceeds the query param padding limit it will be truncated instead of important attrs
+          ...(endUserId && {
+            'enduser.id': endUserId
+          })
+          // The Query Param is being arbitrarily limited in length here.  It is also applied when estimating the size of the payload in getPayloadSize()
+        }, QUERY_PARAM_PADDING).substring(1) // remove the leading '&'
       },
 
       body: this.events
@@ -461,8 +471,8 @@ export class Aggregate extends AggregateBase {
   /** Estimate the payload size */
   getPayloadSize() {
     let newBytes = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;
-    // the 1KB gives us some padding for the other metadata
-    return this.estimateCompression(this.payloadBytesEstimation + newBytes) + 1000;
+    // the query param padding constant gives us some padding for the other metadata to be safely injected
+    return this.estimateCompression(this.payloadBytesEstimation + newBytes) + QUERY_PARAM_PADDING;
   }
 
   /**

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

@@ -95,6 +95,7 @@ export class Aggregate extends AggregateBase {
      * "external" input in this case means errors thrown on the page or session replay itself being triggered to run in full mode by the API, which updates the session entity.
      */
     const switchToFull = () => {
+      if (this.agentRuntime?.session?.state?.sessionReplayMode !== MODE.FULL) return;
       if (mostRecentModeKnown !== MODE.FULL) {
         const prevMode = mostRecentModeKnown;
         mostRecentModeKnown = MODE.FULL;

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

@@ -22,6 +22,8 @@ import { firstContentfulPaint } from '../../../common/vitals/first-contentful-pa
 import { firstPaint } from '../../../common/vitals/first-paint';
 import { bundleId } from '../../../common/ids/bundle-id';
 import { loadedAsDeferredBrowserScript } from '../../../common/constants/runtime';
+import { handle } from '../../../common/event-emitter/handle';
+import { SUPPORTABILITY_METRIC_CHANNEL } from '../../metrics/constants';
 const {
   FEATURE_NAME,
   INTERACTION_EVENTS,
@@ -663,6 +665,9 @@ export class Aggregate extends AggregateBase {
       }
       baseEE.emit('interactionSaved', [interaction]);
       state.interactionsToHarvest.push(interaction);
+      let smCategory = 'RouteChange';
+      if (interaction.root?.attrs?.trigger === 'initialPageLoad') smCategory = 'InitialPageLoad';else if (interaction.root?.attrs?.trigger === 'api') smCategory = 'Custom';
+      handle(SUPPORTABILITY_METRIC_CHANNEL, ["Spa/Interaction/".concat(smCategory, "/Duration/Ms"), Math.max((interaction.root?.end || 0) - (interaction.root?.start || 0), 0)], undefined, FEATURE_NAMES.metrics, baseEE);
       scheduler.scheduleHarvest(0);
     }
     function isEnabled() {

package/dist/esm/loaders/agent-base.js

@@ -2,6 +2,11 @@
 
 import { warn } from '../common/util/console';
 export class AgentBase {
+  /** Generates a generic warning message with the api name injected */
+  #warnMessage(api) {
+    return "Call to agent api ".concat(api, " failed. The agent is not currently initialized.");
+  }
+
   /**
    * Reports a browser PageAction event along with a name and optional attributes.
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/addpageaction/}
@@ -9,7 +14,7 @@ export class AgentBase {
    * @param {object} [attributes] JSON object with one or more key/value pairs. For example: {key:"value"}. The key is reported as its own PageAction attribute with the specified values.
    */
   addPageAction(name, attributes) {
-    warn('Call to agent api addPageAction failed. The page action feature is not currently initialized.');
+    warn(this.#warnMessage('addPageAction'));
   }
 
   /**
@@ -19,7 +24,7 @@ export class AgentBase {
    * @param {string} [host] Default is http://custom.transaction. Typically set host to your site's domain URI.
    */
   setPageViewName(name, host) {
-    warn('Call to agent api setPageViewName failed. The page view feature is not currently initialized.');
+    warn(this.#warnMessage('setPageViewName'));
   }
 
   /**
@@ -30,7 +35,7 @@ export class AgentBase {
    * @param {boolean} [persist] Default false. f set to true, the name-value pair will also be set into the browser's storage API. Then on the following instrumented pages that load within the same session, the pair will be re-applied as a custom attribute.
    */
   setCustomAttribute(name, value, persist) {
-    warn('Call to agent api setCustomAttribute failed. The js errors feature is not currently initialized.');
+    warn(this.#warnMessage('setCustomAttribute'));
   }
 
   /**
@@ -40,7 +45,7 @@ export class AgentBase {
    * @param {object} [customAttributes] An object containing name/value pairs representing custom attributes.
    */
   noticeError(error, customAttributes) {
-    warn('Call to agent api noticeError failed. The js errors feature is not currently initialized.');
+    warn(this.#warnMessage('noticeError'));
   }
 
   /**
@@ -49,7 +54,7 @@ export class AgentBase {
    * @param {string|null} value A string identifier for the end-user, useful for tying all browser events to specific users. The value parameter does not have to be unique. If IDs should be unique, the caller is responsible for that validation. Passing a null value unsets any existing user ID.
    */
   setUserId(value) {
-    warn('Call to agent api setUserId failed. The js errors feature is not currently initialized.');
+    warn(this.#warnMessage('setUserId'));
   }
 
   /**
@@ -61,7 +66,7 @@ export class AgentBase {
    * have to be unique. Passing a null value unsets any existing value.
    */
   setApplicationVersion(value) {
-    warn('Call to agent api setApplicationVersion failed. The agent is not currently initialized.');
+    warn(this.#warnMessage('setApplicationVersion'));
   }
 
   /**
@@ -70,16 +75,16 @@ export class AgentBase {
    * @param {(error: Error|string) => boolean | { group: string }} callback When an error occurs, the callback is called with the error object as a parameter. The callback will be called with each error, so it is not specific to one error.
    */
   setErrorHandler(callback) {
-    warn('Call to agent api setErrorHandler failed. The js errors feature is not currently initialized.');
+    warn(this.#warnMessage('setErrorHandler'));
   }
 
   /**
-   * Records an additional time point as "finished" in a session trace, and sends the event to New Relic.
+   * Records an additional time point as "finished" in a session trace and adds a page action.
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/finished/}
    * @param {number} [timeStamp] Defaults to the current time of the call. If used, this marks the time that the page is "finished" according to your own criteria.
    */
   finished(timeStamp) {
-    warn('Call to agent api finished failed. The page action feature is not currently initialized.');
+    warn(this.#warnMessage('finished'));
   }
 
   /**
@@ -89,7 +94,7 @@ export class AgentBase {
    * @param {string} id The ID or version of this release; for example, a version number, build number from your CI environment, GitHub SHA, GUID, or a hash of the contents.
    */
   addRelease(name, id) {
-    warn('Call to agent api addRelease failed. The js errors feature is not currently initialized.');
+    warn(this.#warnMessage('addRelease'));
   }
 
   /**
@@ -98,7 +103,7 @@ export class AgentBase {
    * @param {string|string[]} [featureNames] The name(s) of the features to start.  If no name(s) are passed, all features will be started
    */
   start(featureNames) {
-    warn('Call to agent api addRelease failed. The agent is not currently initialized.');
+    warn(this.#warnMessage('start'));
   }
 
   /**
@@ -107,7 +112,7 @@ export class AgentBase {
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/recordReplay/}
    */
   recordReplay() {
-    warn('Call to agent api recordReplay failed. The agent is not currently initialized.');
+    warn(this.#warnMessage('recordReplay'));
   }
 
   /**
@@ -117,6 +122,6 @@ export class AgentBase {
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/recordReplay/}
    */
   pauseReplay() {
-    warn('Call to agent api pauseReplay failed. The agent is not currently initialized.');
+    warn(this.#warnMessage('pauseReplay'));
   }
 }

package/dist/types/common/config/state/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../src/common/config/state/init.js"],"names":[],"mappings":"AA2GA,+CAIC;AAED,0DAKC;AAED,+DAYC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../src/common/config/state/init.js"],"names":[],"mappings":"AA6GA,+CAIC;AAED,0DAKC;AAED,+DAYC"}

package/dist/types/common/ids/unique-id.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unique-id.d.ts","sourceRoot":"","sources":["../../../../src/common/ids/unique-id.js"],"names":[],"mappings":"AAkCA;;;;GAIG;AACH,gCAFa,MAAM,CAuBlB;AAED;;;;;GAKG;AACH,sDAFa,MAAM,CAiBlB;AAED;;;;;GAKG;AACH,kCAFa,MAAM,CAIlB;AAED;;;;;GAKG;AACH,mCAFa,MAAM,CAIlB"}
+{"version":3,"file":"unique-id.d.ts","sourceRoot":"","sources":["../../../../src/common/ids/unique-id.js"],"names":[],"mappings":"AAkCA;;;;GAIG;AACH,gCAFa,MAAM,CAwBlB;AAED;;;;;GAKG;AACH,sDAFa,MAAM,CAiBlB;AAED;;;;;GAKG;AACH,kCAFa,MAAM,CAIlB;AAED;;;;;GAKG;AACH,mCAFa,MAAM,CAIlB"}

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":"AA6BA,mCAAmC;;;;;;;;;AAoCnC,uCAAuC;AACvC,uCAAuC;AACvC,iCAAiC;AACjC,uCAAuC;AAIvC;IACE,2BAAiC;IACjC,mDAuHC;IArHC,iHAAiH;IACjH,cAAgB;IAChB,mFAAmF;IACnF,wBAA0B;IAC1B,8GAA8G;IAC9G,wBAAgH;IAChH,iFAAiF;IACjF,qBAAwB;IACxB,mEAAmE;IACnE,sBAAyB;IACzB,6GAA6G;IAC7G,aAAoB;IAGpB,iEAAiE;IACjE,mBAAsB;IACtB,gDAAgD;IAChD,wBAA0B;IAE1B;;;MAGE;IACF,qBAAwB;IACxB,4IAA4I;IAC5I,iBAAoB;IACpB,+HAA+H;IAC/H,kBAAqB;IAErB;;OAEG;IACH,oBAA+B;IAE/B,qGAAqG;IACrG,+BAA+B;IAE/B,kIAAkI;IAClI,cAAyB;IAEzB,0BAA0B;IAC1B,kBAAqB;IAOrB,uIAAuI;IACvI,0BAAyE;IA0BvE,wCAKQ;IAuCZ,qBAWC;IAED;;;;;;;OAOG;IACH,iCALW,OAAO,cACP,OAAO,iBACP,OAAO,GACL,IAAI,CAuDhB;IAED;;;;;;;;;oBAkBC;IAED;;;;;;;;;MA0DC;IAED,qCAOC;IAED,kFAAkF;IAClF,oBASC;IAED,qDAAqD;IACrD,uBA4BC;IAED,yHAAyH;IACzH,yCAsCC;IAED,0HAA0H;IAC1H,yBAGC;IAED,sBAGC;IAED,wBAEC;IAED,gCAAgC;IAChC,uCAGC;IAED;;;;OAIG;IACH,mCAKC;IAED,yDAAyD;IACzD,yBASC;IAED;;;SAGK;IACL,oCAGC;IAED,yCAGC;CACF;8BApe6B,4BAA4B;iCALzB,2CAA2C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/session_replay/aggregate/index.js"],"names":[],"mappings":"AA6BA,mCAAmC;;;;;;;;;AAoCnC,uCAAuC;AACvC,uCAAuC;AACvC,iCAAiC;AACjC,uCAAuC;AAMvC;IACE,2BAAiC;IACjC,mDAuHC;IArHC,iHAAiH;IACjH,cAAgB;IAChB,mFAAmF;IACnF,wBAA0B;IAC1B,8GAA8G;IAC9G,wBAAgH;IAChH,iFAAiF;IACjF,qBAAwB;IACxB,mEAAmE;IACnE,sBAAyB;IACzB,6GAA6G;IAC7G,aAAoB;IAGpB,iEAAiE;IACjE,mBAAsB;IACtB,gDAAgD;IAChD,wBAA0B;IAE1B;;;MAGE;IACF,qBAAwB;IACxB,4IAA4I;IAC5I,iBAAoB;IACpB,+HAA+H;IAC/H,kBAAqB;IAErB;;OAEG;IACH,oBAA+B;IAE/B,qGAAqG;IACrG,+BAA+B;IAE/B,kIAAkI;IAClI,cAAyB;IAEzB,0BAA0B;IAC1B,kBAAqB;IAOrB,uIAAuI;IACvI,0BAAyE;IA0BvE,wCAKQ;IAuCZ,qBAWC;IAED;;;;;;;OAOG;IACH,iCALW,OAAO,cACP,OAAO,iBACP,OAAO,GACL,IAAI,CAuDhB;IAED;;;;;;;;;oBAkBC;IAED;;;;;;;;;MAgEC;IAED,qCAOC;IAED,kFAAkF;IAClF,oBASC;IAED,qDAAqD;IACrD,uBA4BC;IAED,yHAAyH;IACzH,yCAsCC;IAED,0HAA0H;IAC1H,yBAGC;IAED,sBAGC;IAED,wBAEC;IAED,gCAAgC;IAChC,uCAGC;IAED;;;;OAIG;IACH,mCAKC;IAED,yDAAyD;IACzD,yBASC;IAED;;;SAGK;IACL,oCAGC;IAED,yCAGC;CACF;8BA5e6B,4BAA4B;iCALzB,2CAA2C"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/session_trace/aggregate/index.js"],"names":[],"mappings":"AAiCA;IACE,2BAAiC;IAGjC,iEA0IC;IAxIC,kBAA+C;IAK/C,sBAAiD;IACjD,yBAAc;IACd,sBAAe;IACf,8BAAkB;IAClB,iCAAqB;IACrB,wBAA0G;IAC1G,wBAA4G;IAC5G;;4EAEwE;IACxE,kCAAyB;IAGzB,0CAAsC;IAwHxC,sEAcC;IA6CD,oDAOC;IAGD,oCAwBC;IAGD,uEAkBC;IAED,oDAKC;IAED,wBAwBC;IAED,uCAuBC;IAGD,gDASC;IAID,qCAkBC;IAGD,qEAUC;IAGD,mEAUC;IAGD,yBAeC;IAED;;;;OAIG;IACH,2BAHW,MAAM,GACJ,MAAM,CAsBlB;IAGD;;;;;;;YAkCM;0GAC8F;;YAE9F;0FAC8E;;YAE9E,4IAA4I;;;;;;MAMjJ;IAED,mEA6BC;;CACF;8BA1gB6B,4BAA4B;6BAH7B,2BAA2B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/session_trace/aggregate/index.js"],"names":[],"mappings":"AAiCA;IACE,2BAAiC;IAGjC,iEA4IC;IA1IC,kBAA+C;IAK/C,sBAAiD;IACjD,yBAAc;IACd,sBAAe;IACf,8BAAkB;IAClB,iCAAqB;IACrB,wBAA0G;IAC1G,wBAA4G;IAC5G;;4EAEwE;IACxE,kCAAyB;IAGzB,0CAAsC;IA0HxC,sEAcC;IA6CD,oDAOC;IAGD,oCAwBC;IAGD,uEAkBC;IAED,oDAKC;IAED,wBAwBC;IAED,uCAuBC;IAGD,gDASC;IAID,qCAkBC;IAGD,qEAUC;IAGD,mEAUC;IAGD,yBAeC;IAED;;;;OAIG;IACH,2BAHW,MAAM,GACJ,MAAM,CAsBlB;IAGD;;;;;;;YAkCM;0GAC8F;;YAE9F;0FAC8E;;YAE9E,4IAA4I;;;;;;MAMjJ;IAED,mEA6BC;;CACF;8BA5gB6B,4BAA4B;6BAH7B,2BAA2B"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/spa/aggregate/index.js"],"names":[],"mappings":"AA6BA;IACE,2BAAiC;IACjC,mDAgsBC;IA7rBC;;;;;;;;;;;;;;;;;MAkBC;IAED,uBAAsC;CA0qBzC;8BA7sB6B,4BAA4B;2BAJ/B,cAAc"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/spa/aggregate/index.js"],"names":[],"mappings":"AA+BA;IACE,2BAAiC;IACjC,mDAssBC;IAnsBC;;;;;;;;;;;;;;;;;MAkBC;IAED,uBAAsC;CAgrBzC;8BArtB6B,4BAA4B;2BAJ/B,cAAc"}

package/dist/types/loaders/agent-base.d.ts

@@ -52,7 +52,7 @@ export class AgentBase {
         group: string;
     }): void;
     /**
-     * Records an additional time point as "finished" in a session trace, and sends the event to New Relic.
+     * Records an additional time point as "finished" in a session trace and adds a page action.
      * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/finished/}
      * @param {number} [timeStamp] Defaults to the current time of the call. If used, this marks the time that the page is "finished" according to your own criteria.
      */
@@ -83,5 +83,6 @@ export class AgentBase {
      * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/recordReplay/}
      */
     pauseReplay(): void;
+    #private;
 }
 //# sourceMappingURL=agent-base.d.ts.map

package/dist/types/loaders/agent-base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-base.d.ts","sourceRoot":"","sources":["../../../src/loaders/agent-base.js"],"names":[],"mappings":"AAIA;IACE;;;;;OAKG;IACH,oBAHW,MAAM,yCAKhB;IAED;;;;;OAKG;IACH,sBAHW,MAAM,mCAKhB;IAED;;;;;;OAMG;IACH,yBAJW,MAAM,SACN,MAAM,GAAC,MAAM,GAAC,IAAI,uCAK5B;IAED;;;;;OAKG;IACH,mBAHW,KAAK,GAAC,MAAM,+CAKtB;IAED;;;;OAIG;IACH,iBAFW,MAAM,GAAC,IAAI,QAIrB;IAED;;;;;;;OAOG;IACH,6BAJW,MAAM,GAAC,IAAI,QAMrB;IAED;;;;OAIG;IACH,kCAFmB,KAAK,GAAC,MAAM,KAAK,OAAO,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,QAI9D;IAED;;;;OAIG;IACH,+CAEC;IAED;;;;;OAKG;IACH,iBAHW,MAAM,MACN,MAAM,QAIhB;IAED;;;;OAIG;IACH,0DAEC;IAED;;;;OAIG;IACH,qBAEC;IAED;;;;;OAKG;IACH,oBAEC;CACF"}
+{"version":3,"file":"agent-base.d.ts","sourceRoot":"","sources":["../../../src/loaders/agent-base.js"],"names":[],"mappings":"AAIA;IAME;;;;;OAKG;IACH,oBAHW,MAAM,yCAKhB;IAED;;;;;OAKG;IACH,sBAHW,MAAM,mCAKhB;IAED;;;;;;OAMG;IACH,yBAJW,MAAM,SACN,MAAM,GAAC,MAAM,GAAC,IAAI,uCAK5B;IAED;;;;;OAKG;IACH,mBAHW,KAAK,GAAC,MAAM,+CAKtB;IAED;;;;OAIG;IACH,iBAFW,MAAM,GAAC,IAAI,QAIrB;IAED;;;;;;;OAOG;IACH,6BAJW,MAAM,GAAC,IAAI,QAMrB;IAED;;;;OAIG;IACH,kCAFmB,KAAK,GAAC,MAAM,KAAK,OAAO,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,QAI9D;IAED;;;;OAIG;IACH,+CAEC;IAED;;;;;OAKG;IACH,iBAHW,MAAM,MACN,MAAM,QAIhB;IAED;;;;OAIG;IACH,0DAEC;IAED;;;;OAIG;IACH,qBAEC;IAED;;;;;OAKG;IACH,oBAEC;;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newrelic/browser-agent",
-  "version": "1.247.0",
+  "version": "1.249.0",
   "private": false,
   "author": "New Relic Browser Agent Team <browser-agent@newrelic.com>",
   "description": "New Relic Browser Agent",
@@ -139,14 +139,11 @@
     "cdn:build": "npm run cdn:build:prod",
     "cdn:build:local": "npm run cdn:webpack",
     "cdn:build:prod": "npm run cdn:webpack -- --env mode=prod",
-    "postcdn:build:prod": "npm run cdn:clone",
     "cdn:build:dev": "npm run cdn:webpack -- --env mode=dev",
     "cdn:build:experiment": "npm run cdn:webpack -- --env mode=experiment",
     "cdn:webpack": "npx webpack --progress --config ./tools/webpack/index.mjs",
-    "postcdn:webpack": "npm run cdn:cleanup",
     "cdn:watch": "jung -r ./src -F '.*\\.test\\.js' --run -- npm run cdn:build:local",
     "cdn:cleanup": "node ./tools/webpack/scripts/cleanup.mjs",
-    "cdn:clone": "node ./tools/webpack/scripts/clone.mjs",
     "test-server": "node ./tools/wdio/bin/server",
     "sauce:connect": "node ./tools/saucelabs/bin.mjs",
     "sauce:get-browsers": "node ./tools/browsers-lists/sauce-browsers.mjs",
@@ -251,7 +248,6 @@
     "webpack-bundle-analyzer": "^4.7.0",
     "webpack-cli": "^4.10.0",
     "webpack-stream": "^7.0.0",
-    "webpack-subresource-integrity": "^5.1.0",
     "yargs": "^17.6.2"
   },
   "files": [

package/src/common/config/state/init.js

@@ -4,6 +4,8 @@ import { warn } from '../../util/console'
 import { getNREUMInitializedAgent } from '../../window/nreum'
 import { getModeledObject } from './configurable'
 
+const nrMask = '[data-nr-mask]'
+
 const model = () => {
   const hiddenState = {
     mask_selector: '*',
@@ -72,9 +74,9 @@ const model = () => {
       // this has a getter/setter to facilitate validation of the selectors
       get mask_text_selector () { return hiddenState.mask_selector },
       set mask_text_selector (val) {
-        if (isValidSelector(val)) hiddenState.mask_selector = val + ',[data-nr-mask]'
-        else if (val === null) hiddenState.mask_selector = val // null is acceptable, which completely disables the behavior
-        else warn('An invalid session_replay.mask_selector was provided and will not be used', val)
+        if (isValidSelector(val)) hiddenState.mask_selector = `${val},${nrMask}`
+        else if (val === '' || val === null) hiddenState.mask_selector = nrMask
+        else warn('An invalid session_replay.mask_selector was provided. \'*\' will be used.', val)
       },
       // these properties only have getters because they are enforcable constants and should error if someone tries to override them
       get block_class () { return 'nr-block' },

package/src/common/ids/unique-id.js

@@ -43,13 +43,14 @@ export function generateUuid () {
   let randomValueTable
   let randomValueIndex = 0
   if (crypto && crypto.getRandomValues) {
+    // For a UUID, we only need 30 characters since two characters are pre-defined
     // eslint-disable-next-line
-    randomValueTable = crypto.getRandomValues(new Uint8Array(31))
+    randomValueTable = crypto.getRandomValues(new Uint8Array(30))
   }
 
   return uuidv4Template.split('').map(templateInput => {
     if (templateInput === 'x') {
-      return getRandomValue(randomValueTable, ++randomValueIndex).toString(16)
+      return getRandomValue(randomValueTable, randomValueIndex++).toString(16)
     } else if (templateInput === 'y') {
       // this is the uuid variant per spec (8, 9, a, b)
       // % 4, then shift to get values 8-11
@@ -73,7 +74,7 @@ export function generateRandomHexString (length) {
   let randomValueIndex = 0
   if (crypto && crypto.getRandomValues) {
     // eslint-disable-next-line
-    randomValueTable = crypto.getRandomValues(new Uint8Array(31))
+    randomValueTable = crypto.getRandomValues(new Uint8Array(length))
   }
 
   const chars = []

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

@@ -67,6 +67,8 @@ let recorder, gzipper, u8
 export const MAX_PAYLOAD_SIZE = 1000000
 /** Unloading caps around 64kb */
 export const IDEAL_PAYLOAD_SIZE = 64000
+/** Reserved room for query param attrs */
+const QUERY_PARAM_PADDING = 5000
 /** Interval between forcing new full snapshots -- 15 seconds in error mode (x2), 5 minutes in full mode */
 const CHECKOUT_MS = { [MODE.ERROR]: 15000, [MODE.FULL]: 300000, [MODE.OFF]: 0 }
 
@@ -292,6 +294,7 @@ export class Aggregate extends AggregateBase {
   getHarvestContents () {
     const agentRuntime = getRuntime(this.agentIdentifier)
     const info = getInfo(this.agentIdentifier)
+    const endUserId = info.jsAttributes?.['enduser.id']
 
     if (this.backloggedEvents.length) this.events = [...this.backloggedEvents, ...this.events]
 
@@ -327,6 +330,8 @@ export class Aggregate extends AggregateBase {
         app_id: info.applicationID,
         protocol_version: '0',
         attributes: encodeObj({
+          // this section of attributes must be controllable and stay below the query param padding limit -- see QUERY_PARAM_PADDING
+          // if not, data could be lost to truncation at time of sending, potentially breaking parsing / API behavior in NR1
           ...(this.shouldCompress && { content_encoding: 'gzip' }),
           'replay.firstTimestamp': firstTimestamp,
           'replay.firstTimestampOffset': firstTimestamp - agentOffset,
@@ -342,8 +347,11 @@ export class Aggregate extends AggregateBase {
           hasError: this.hasError,
           isFirstChunk: agentRuntime.session.state.sessionReplaySentFirstChunk === false,
           decompressedBytes: this.payloadBytesEstimation,
-          'rrweb.version': RRWEB_VERSION
-        }, MAX_PAYLOAD_SIZE - this.payloadBytesEstimation).substring(1) // remove the leading '&'
+          'rrweb.version': RRWEB_VERSION,
+          // customer-defined data should go last so that if it exceeds the query param padding limit it will be truncated instead of important attrs
+          ...(endUserId && { 'enduser.id': endUserId })
+          // The Query Param is being arbitrarily limited in length here.  It is also applied when estimating the size of the payload in getPayloadSize()
+        }, QUERY_PARAM_PADDING).substring(1) // remove the leading '&'
       },
       body: this.events
     }
@@ -459,8 +467,8 @@ export class Aggregate extends AggregateBase {
 
   /** Estimate the payload size */
   getPayloadSize (newBytes = 0) {
-    // the 1KB gives us some padding for the other metadata
-    return this.estimateCompression(this.payloadBytesEstimation + newBytes) + 1000
+    // the query param padding constant gives us some padding for the other metadata to be safely injected
+    return this.estimateCompression(this.payloadBytesEstimation + newBytes) + QUERY_PARAM_PADDING
   }
 
   /**

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

@@ -89,6 +89,8 @@ export class Aggregate extends AggregateBase {
      * "external" input in this case means errors thrown on the page or session replay itself being triggered to run in full mode by the API, which updates the session entity.
      */
     const switchToFull = () => {
+      if (this.agentRuntime?.session?.state?.sessionReplayMode !== MODE.FULL) return
+
       if (mostRecentModeKnown !== MODE.FULL) {
         const prevMode = mostRecentModeKnown
         mostRecentModeKnown = MODE.FULL

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

@@ -22,6 +22,8 @@ import { firstContentfulPaint } from '../../../common/vitals/first-contentful-pa
 import { firstPaint } from '../../../common/vitals/first-paint'
 import { bundleId } from '../../../common/ids/bundle-id'
 import { loadedAsDeferredBrowserScript } from '../../../common/constants/runtime'
+import { handle } from '../../../common/event-emitter/handle'
+import { SUPPORTABILITY_METRIC_CHANNEL } from '../../metrics/constants'
 
 const {
   FEATURE_NAME, INTERACTION_EVENTS, MAX_TIMER_BUDGET, FN_START, FN_END, CB_START, INTERACTION_API, REMAINING,
@@ -724,6 +726,12 @@ export class Aggregate extends AggregateBase {
       }
       baseEE.emit('interactionSaved', [interaction])
       state.interactionsToHarvest.push(interaction)
+
+      let smCategory = 'RouteChange'
+      if (interaction.root?.attrs?.trigger === 'initialPageLoad') smCategory = 'InitialPageLoad'
+      else if (interaction.root?.attrs?.trigger === 'api') smCategory = 'Custom'
+      handle(SUPPORTABILITY_METRIC_CHANNEL, [`Spa/Interaction/${smCategory}/Duration/Ms`, Math.max((interaction.root?.end || 0) - (interaction.root?.start || 0), 0)], undefined, FEATURE_NAMES.metrics, baseEE)
+
       scheduler.scheduleHarvest(0)
     }
 

package/src/loaders/agent-base.js

@@ -3,6 +3,11 @@
 import { warn } from '../common/util/console'
 
 export class AgentBase {
+  /** Generates a generic warning message with the api name injected */
+  #warnMessage (api) {
+    return `Call to agent api ${api} failed. The agent is not currently initialized.`
+  }
+
   /**
    * Reports a browser PageAction event along with a name and optional attributes.
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/addpageaction/}
@@ -10,7 +15,7 @@ export class AgentBase {
    * @param {object} [attributes] JSON object with one or more key/value pairs. For example: {key:"value"}. The key is reported as its own PageAction attribute with the specified values.
    */
   addPageAction (name, attributes) {
-    warn('Call to agent api addPageAction failed. The page action feature is not currently initialized.')
+    warn(this.#warnMessage('addPageAction'))
   }
 
   /**
@@ -20,7 +25,7 @@ export class AgentBase {
    * @param {string} [host] Default is http://custom.transaction. Typically set host to your site's domain URI.
    */
   setPageViewName (name, host) {
-    warn('Call to agent api setPageViewName failed. The page view feature is not currently initialized.')
+    warn(this.#warnMessage('setPageViewName'))
   }
 
   /**
@@ -31,7 +36,7 @@ export class AgentBase {
    * @param {boolean} [persist] Default false. f set to true, the name-value pair will also be set into the browser's storage API. Then on the following instrumented pages that load within the same session, the pair will be re-applied as a custom attribute.
    */
   setCustomAttribute (name, value, persist) {
-    warn('Call to agent api setCustomAttribute failed. The js errors feature is not currently initialized.')
+    warn(this.#warnMessage('setCustomAttribute'))
   }
 
   /**
@@ -41,7 +46,7 @@ export class AgentBase {
    * @param {object} [customAttributes] An object containing name/value pairs representing custom attributes.
    */
   noticeError (error, customAttributes) {
-    warn('Call to agent api noticeError failed. The js errors feature is not currently initialized.')
+    warn(this.#warnMessage('noticeError'))
   }
 
   /**
@@ -50,7 +55,7 @@ export class AgentBase {
    * @param {string|null} value A string identifier for the end-user, useful for tying all browser events to specific users. The value parameter does not have to be unique. If IDs should be unique, the caller is responsible for that validation. Passing a null value unsets any existing user ID.
    */
   setUserId (value) {
-    warn('Call to agent api setUserId failed. The js errors feature is not currently initialized.')
+    warn(this.#warnMessage('setUserId'))
   }
 
   /**
@@ -62,7 +67,7 @@ export class AgentBase {
    * have to be unique. Passing a null value unsets any existing value.
    */
   setApplicationVersion (value) {
-    warn('Call to agent api setApplicationVersion failed. The agent is not currently initialized.')
+    warn(this.#warnMessage('setApplicationVersion'))
   }
 
   /**
@@ -71,16 +76,16 @@ export class AgentBase {
    * @param {(error: Error|string) => boolean | { group: string }} callback When an error occurs, the callback is called with the error object as a parameter. The callback will be called with each error, so it is not specific to one error.
    */
   setErrorHandler (callback) {
-    warn('Call to agent api setErrorHandler failed. The js errors feature is not currently initialized.')
+    warn(this.#warnMessage('setErrorHandler'))
   }
 
   /**
-   * Records an additional time point as "finished" in a session trace, and sends the event to New Relic.
+   * Records an additional time point as "finished" in a session trace and adds a page action.
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/finished/}
    * @param {number} [timeStamp] Defaults to the current time of the call. If used, this marks the time that the page is "finished" according to your own criteria.
    */
   finished (timeStamp) {
-    warn('Call to agent api finished failed. The page action feature is not currently initialized.')
+    warn(this.#warnMessage('finished'))
   }
 
   /**
@@ -90,7 +95,7 @@ export class AgentBase {
    * @param {string} id The ID or version of this release; for example, a version number, build number from your CI environment, GitHub SHA, GUID, or a hash of the contents.
    */
   addRelease (name, id) {
-    warn('Call to agent api addRelease failed. The js errors feature is not currently initialized.')
+    warn(this.#warnMessage('addRelease'))
   }
 
   /**
@@ -99,7 +104,7 @@ export class AgentBase {
    * @param {string|string[]} [featureNames] The name(s) of the features to start.  If no name(s) are passed, all features will be started
    */
   start (featureNames) {
-    warn('Call to agent api addRelease failed. The agent is not currently initialized.')
+    warn(this.#warnMessage('start'))
   }
 
   /**
@@ -108,7 +113,7 @@ export class AgentBase {
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/recordReplay/}
    */
   recordReplay () {
-    warn('Call to agent api recordReplay failed. The agent is not currently initialized.')
+    warn(this.#warnMessage('recordReplay'))
   }
 
   /**
@@ -118,6 +123,6 @@ export class AgentBase {
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/recordReplay/}
    */
   pauseReplay () {
-    warn('Call to agent api pauseReplay failed. The agent is not currently initialized.')
+    warn(this.#warnMessage('pauseReplay'))
   }
 }