@newrelic/browser-agent 1.239.1 → 1.241.0

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

@@ -3,22 +3,33 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import { onFCP, onFID, onLCP, onCLS, onINP } from 'web-vitals';
-import { onFirstPaint } from '../first-paint';
-import { onLongTask } from '../long-tasks';
-import { iOSBelow16 } from '../../../common/constants/runtime';
 import { nullable, numeric, getAddStringContext, addCustomAttributes } from '../../../common/serialize/bel-serializer';
 import { mapOwn } from '../../../common/util/map-own';
 import { HarvestScheduler } from '../../../common/harvest/harvest-scheduler';
 import { registerHandler } from '../../../common/event-emitter/register-handler';
-import { cleanURL } from '../../../common/url/clean-url';
 import { handle } from '../../../common/event-emitter/handle';
-import { getInfo, getConfigurationValue, getRuntime } from '../../../common/config/config';
+import { getInfo, getConfigurationValue } from '../../../common/config/config';
 import { FEATURE_NAME } from '../constants';
 import { FEATURE_NAMES } from '../../../loaders/features/features';
 import { AggregateBase } from '../../utils/aggregate-base';
+import { cumulativeLayoutShift } from '../../../common/vitals/cumulative-layout-shift';
+import { firstContentfulPaint } from '../../../common/vitals/first-contentful-paint';
+import { firstInputDelay } from '../../../common/vitals/first-input-delay';
+import { firstPaint } from '../../../common/vitals/first-paint';
+import { interactionToNextPaint } from '../../../common/vitals/interaction-to-next-paint';
+import { largestContentfulPaint } from '../../../common/vitals/largest-contentful-paint';
+import { timeToFirstByte } from '../../../common/vitals/time-to-first-byte';
+import { longTask } from '../../../common/vitals/long-task';
 export class Aggregate extends AggregateBase {
   static featureName = FEATURE_NAME;
+  #handleVitalMetric = _ref => {
+    let {
+      name,
+      value,
+      attrs
+    } = _ref;
+    this.addTiming(name, value, attrs);
+  };
   constructor(agentIdentifier, aggregator) {
     var _this;
     super(agentIdentifier, aggregator, FEATURE_NAME);
@@ -26,163 +37,41 @@ export class Aggregate extends AggregateBase {
     this.timings = [];
     this.timingsSent = [];
     this.curSessEndRecorded = false;
-    this.cls = null; // this should be null unless set to a numeric value by web-vitals so that we differentiate if CLS is supported
-
-    /* ! This is the section that used to be in the loader portion: ! */
-    /* ------------------------------------------------------------ */
-    const pageStartedHidden = getRuntime(agentIdentifier).initHidden; // our attempt at recapturing initial vis state since this code runs post-load time
-    this.alreadySent = new Set(); // since we don't support timings on BFCache restores, this tracks and helps cap metrics that web-vitals report more than once
-
-    /* PerformancePaintTiming API - BFC is not yet supported. */
-    onFirstPaint(_ref => {
-      let {
-        name,
-        value
-      } = _ref;
-      if (pageStartedHidden) return;
-      this.addTiming(name.toLowerCase(), Math.floor(value));
-    });
-
-    /* First Contentful Paint - As of WV v3, it still imperfectly tries to detect document vis state asap and isn't supposed to report if page starts hidden. */
-    if (iOSBelow16) {
-      try {
-        if (!pageStartedHidden) {
-          // see ios-version.js for detail on this following bug case; tldr: buffered flag doesn't work but getEntriesByType does
-          const paintEntries = performance.getEntriesByType('paint');
-          paintEntries.forEach(entry => {
-            if (entry.name === 'first-contentful-paint') {
-              this.addTiming('fcp', Math.floor(entry.startTime));
-            }
-          });
-        }
-      } catch (e) {}
-    } else {
-      onFCP(_ref2 => {
-        let {
-          name,
-          value
-        } = _ref2;
-        if (pageStartedHidden || this.alreadySent.has(name)) return;
-        this.alreadySent.add(name);
-        this.addTiming(name.toLowerCase(), value);
-      });
-    }
-
-    /* First Input Delay (+"First Interaction") - As of WV v3, it still imperfectly tries to detect document vis state asap and isn't supposed to report if page starts hidden. */
-    onFID(_ref3 => {
-      let {
-        name,
-        value,
-        entries
-      } = _ref3;
-      if (pageStartedHidden || this.alreadySent.has(name) || entries.length === 0) return;
-      this.alreadySent.add(name);
-
-      // CWV will only report one (THE) first-input entry to us; fid isn't reported if there are no user interactions occurs before the *first* page hiding.
-      const fiEntry = entries[0];
-      const attributes = {
-        type: fiEntry.name,
-        fid: Math.round(value)
-      };
-      this.addConnectionAttributes(attributes);
-      this.addTiming('fi', Math.round(fiEntry.startTime), attributes);
-    });
-
-    /* Largest Contentful Paint - As of WV v3, it still imperfectly tries to detect document vis state asap and isn't supposed to report if page starts hidden. */
-    onLCP(_ref4 => {
+    firstPaint.subscribe(this.#handleVitalMetric);
+    firstContentfulPaint.subscribe(this.#handleVitalMetric);
+    firstInputDelay.subscribe(this.#handleVitalMetric);
+    largestContentfulPaint.subscribe(this.#handleVitalMetric);
+    interactionToNextPaint.subscribe(this.#handleVitalMetric);
+    timeToFirstByte.subscribe(_ref2 => {
       let {
-        name,
-        value,
         entries
-      } = _ref4;
-      if (pageStartedHidden || this.alreadySent.has(name)) return;
-      this.alreadySent.add(name);
-      const attributes = {};
-      if (entries.length > 0) {
-        // CWV will only ever report one (THE) lcp entry to us; lcp is also only reported *once* on earlier(user interaction, page hidden).
-        const lcpEntry = entries[entries.length - 1]; // this looks weird if we only expect one, but this is how cwv-attribution gets it so to be sure...
-        attributes.size = lcpEntry.size;
-        attributes.eid = lcpEntry.id;
-        if (lcpEntry.url) {
-          attributes.elUrl = cleanURL(lcpEntry.url);
-        }
-        if (lcpEntry.element?.tagName) {
-          attributes.elTag = lcpEntry.element.tagName;
-        }
-      }
-      this.addConnectionAttributes(attributes);
-      this.addTiming(name.toLowerCase(), value, attributes);
-    });
-
-    /* Cumulative Layout Shift - We don't have to limit this callback since cls is stored as a state and only sent as attribute on other timings.
-      reportAllChanges ensures our tracked cls has the most recent rolling value to attach to 'unload' and 'pagehide'. */
-    onCLS(_ref5 => {
-      let {
-        value
-      } = _ref5;
-      this.cls = value;
-    }, {
-      reportAllChanges: true
-    });
-
-    /* Interaction-to-Next-Paint */
-    onINP(_ref6 => {
-      let {
-        name,
-        value,
-        id
-      } = _ref6;
-      return this.addTiming(name.toLowerCase(), value, {
-        metricId: id
-      });
+      } = _ref2;
+      this.addTiming('load', Math.round(entries[0].loadEventEnd));
     });
-
-    /* PerformanceLongTaskTiming API */
-    if (getConfigurationValue(this.agentIdentifier, 'page_view_timing.long_task') === true) {
-      onLongTask(_ref7 => {
-        let {
-          name,
-          value,
-          info
-        } = _ref7;
-        return this.addTiming(name.toLowerCase(), value, info);
-      }); // lt context is passed as 'info'=attrs in the timing node
-    }
-    /* ------------------------------------End of ex-loader section */
+    if (getConfigurationValue(this.agentIdentifier, 'page_view_timing.long_task') === true) longTask.subscribe(this.#handleVitalMetric);
 
     /* It's important that CWV api, like "onLCP", is called before this scheduler is initialized. The reason is because they listen to the same
       on vis change or pagehide events, and we'd want ex. onLCP to record the timing (win the race) before we try to send "final harvest". */
-    this.scheduler = new HarvestScheduler('events', {
-      onFinished: function () {
-        return _this.onHarvestFinished(...arguments);
-      },
-      getPayload: function () {
-        return _this.prepareHarvest(...arguments);
-      }
-    }, this);
-    registerHandler('timing', (name, value, attrs) => this.addTiming(name, value, attrs), this.featureName, this.ee); // notice CLS is added to all timings via 4th param
+
     registerHandler('docHidden', msTimestamp => this.endCurrentSession(msTimestamp), this.featureName, this.ee);
     registerHandler('winPagehide', msTimestamp => this.recordPageUnload(msTimestamp), this.featureName, this.ee);
     const initialHarvestSeconds = getConfigurationValue(this.agentIdentifier, 'page_view_timing.initialHarvestSeconds') || 10;
     const harvestTimeSeconds = getConfigurationValue(this.agentIdentifier, 'page_view_timing.harvestTimeSeconds') || 30;
     // send initial data sooner, then start regular
     this.ee.on("drain-".concat(this.featureName), () => {
+      this.scheduler = new HarvestScheduler('events', {
+        onFinished: function () {
+          return _this.onHarvestFinished(...arguments);
+        },
+        getPayload: function () {
+          return _this.prepareHarvest(...arguments);
+        }
+      }, this);
       this.scheduler.startTimer(harvestTimeSeconds, initialHarvestSeconds);
     });
     this.drain();
   }
 
-  // takes an attributes object and appends connection attributes if available
-  addConnectionAttributes(attributes) {
-    var connection = navigator.connection || navigator.mozConnection || navigator.webkitConnection; // to date, both window & worker shares the same support for connection
-    if (!connection) return;
-    if (connection.type) attributes['net-type'] = connection.type;
-    if (connection.effectiveType) attributes['net-etype'] = connection.effectiveType;
-    if (connection.rtt) attributes['net-rtt'] = connection.rtt;
-    if (connection.downlink) attributes['net-dlink'] = connection.downlink;
-    return attributes;
-  }
-
   /**
    * Add the time of _document visibilitychange to hidden_ to the next PVT harvest == NRDB pageHide attr.
    * @param {number} timestamp
@@ -219,8 +108,8 @@ export class Aggregate extends AggregateBase {
     Mitigation: We've set initial CLS to null so that it's omitted from timings like 'pageHide' in that edge case. It should only be included if onCLS callback was executed at least once.
     Future: onCLS value changes should be reported directly & CLS separated into its own timing node so it's not beholden to 'pageHide' firing. It'd also be possible to report the real final CLS.
     */
-    if (this.cls !== null) {
-      attrs.cls = this.cls;
+    if (cumulativeLayoutShift.current.value >= 0) {
+      attrs.cls = cumulativeLayoutShift.current.value;
     }
     this.timings.push({
       name,

package/dist/esm/features/page_view_timing/instrument/index.js

@@ -3,7 +3,6 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { handle } from '../../../common/event-emitter/handle';
-import { getRuntime } from '../../../common/config/config';
 import { subscribeToVisibilityChange } from '../../../common/window/page-visibility';
 import { windowAddEventListener } from '../../../common/event-listener/event-listener-opts';
 import { now } from '../../../common/timing/now';
@@ -17,9 +16,7 @@ export class Instrument extends InstrumentBase {
     super(agentIdentifier, aggregator, FEATURE_NAME, auto);
     if (!isBrowserScope) return; // CWV is irrelevant outside web context
 
-    // Document visibility state becomes hidden; this should run as soon as possible in page life.
     // While we try to replicate web-vital's visibilitywatcher logic in an effort to defer that library to post-pageload, this isn't perfect and doesn't consider prerendering.
-    getRuntime(agentIdentifier).initHidden = Boolean(document.visibilityState === 'hidden');
     subscribeToVisibilityChange(() => handle('docHidden', [now()], undefined, FEATURE_NAME, this.ee), true);
 
     // Window fires its pagehide event (typically on navigation--this occurrence is a *subset* of vis change); don't defer this unless it's guarantee it cannot happen before load(?)

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

@@ -20,6 +20,7 @@ import { AggregateBase } from '../../utils/aggregate-base';
 import { sharedChannel } from '../../../common/constants/shared-channel';
 import { obj as encodeObj } from '../../../common/url/encode';
 import { warn } from '../../../common/util/console';
+import { globalScope } from '../../../common/constants/runtime';
 
 // would be better to get this dynamically in some way
 export const RRWEB_VERSION = '2.0.0-alpha.8';
@@ -64,17 +65,30 @@ export class Aggregate extends AggregateBase {
      * -- When visibility changes from "hidden" -> "visible", it must capture a full snapshot for the replay to work correctly across tabs
     */
     this.hasSnapshot = false;
+    /** Payload metadata -- Should indicate that the payload being sent has a meta node. The meta node should always precede a snapshot node. */
+    this.hasMeta = false;
     /** Payload metadata -- Should indicate that the payload being sent contains an error.  Used for query/filter purposes in UI */
     this.hasError = false;
 
-    /** Payload metadata -- Should indicate when a replay blob started recording.  Resets each time a harvest occurs. */
+    /** Payload metadata -- Should indicate when a replay blob started recording.  Resets each time a harvest occurs.
+     * cycle timestamps are used as fallbacks if event timestamps cannot be used
+     */
     this.timestamp = {
-      first: undefined,
-      last: undefined
+      event: {
+        first: undefined,
+        last: undefined
+      },
+      cycle: {
+        first: undefined,
+        last: undefined
+      }
     };
 
     /** A value which increments with every new mutation node reported. Resets after a harvest is sent */
     this.payloadBytesEstimation = 0;
+
+    /** Hold on to the last meta node, so that it can be re-inserted if the meta and snapshot nodes are broken up due to harvesting */
+    this.lastMeta = undefined;
     const shouldSetup = getConfigurationValue(agentIdentifier, 'privacy.cookies_enabled') === true && getConfigurationValue(agentIdentifier, 'session_trace.enabled') === true;
 
     /** The method to stop recording. This defaults to a noop, but is overwritten once the recording library is imported and initialized */
@@ -124,7 +138,7 @@ export class Aggregate extends AggregateBase {
       }, this.featureName, this.ee);
       this.waitForFlags(['sr']).then(_ref => {
         let [flagOn] = _ref;
-        return this.initializeRecording(flagOn, Math.random() < getConfigurationValue(this.agentIdentifier, 'session_replay.errorSampleRate'), Math.random() < getConfigurationValue(this.agentIdentifier, 'session_replay.sampleRate'));
+        return this.initializeRecording(flagOn, Math.random() * 100 < getConfigurationValue(this.agentIdentifier, 'session_replay.error_sampling_rate'), Math.random() * 100 < getConfigurationValue(this.agentIdentifier, 'session_replay.sampling_rate'));
       }).then(() => sharedChannel.onReplayReady(this.mode)); // notify watchers that replay started with the mode
 
       this.drain();
@@ -165,6 +179,12 @@ export class Aggregate extends AggregateBase {
     if (this.mode === MODE.ERROR && this.errorNoticed) {
       this.mode = MODE.FULL;
     }
+    try {
+      // Do not change the webpackChunkName or it will break the webpack nrba-chunking plugin
+      recorder = (await import( /* webpackChunkName: "recorder" */'rrweb')).record;
+    } catch (err) {
+      return this.abort();
+    }
 
     // FULL mode records AND reports from the beginning, while ERROR mode only records (but does not report).
     // ERROR mode will do this until an error is thrown, and then switch into FULL mode.
@@ -173,12 +193,6 @@ export class Aggregate extends AggregateBase {
       // We only report (harvest) in FULL mode
       this.scheduler.startTimer(this.harvestTimeSeconds);
     }
-    try {
-      // Do not change the webpackChunkName or it will break the webpack nrba-chunking plugin
-      recorder = (await import( /* webpackChunkName: "recorder" */'rrweb')).record;
-    } catch (err) {
-      return this.abort();
-    }
     try {
       // Do not change the webpackChunkName or it will break the webpack nrba-chunking plugin
       const {
@@ -213,6 +227,8 @@ export class Aggregate extends AggregateBase {
   getHarvestContents() {
     const agentRuntime = getRuntime(this.agentIdentifier);
     const info = getInfo(this.agentIdentifier);
+    const firstTimestamp = this.timestamp.event.first || this.timestamp.cycle.first;
+    const lastTimestamp = this.timestamp.event.last || this.timestamp.cycle.last;
     return {
       qs: {
         browser_monitoring_key: info.licenseKey,
@@ -223,11 +239,12 @@ export class Aggregate extends AggregateBase {
           ...(this.shouldCompress && {
             content_encoding: 'gzip'
           }),
-          'replay.firstTimestamp': this.timestamp.first,
-          'replay.lastTimestamp': this.timestamp.last,
-          'replay.durationMs': this.timestamp.last - this.timestamp.first,
+          'replay.firstTimestamp': firstTimestamp,
+          'replay.lastTimestamp': lastTimestamp,
+          'replay.durationMs': lastTimestamp - firstTimestamp,
           agentVersion: agentRuntime.version,
           session: agentRuntime.session.state.value,
+          hasMeta: this.hasMeta,
           hasSnapshot: this.hasSnapshot,
           hasError: this.hasError,
           isFirstChunk: this.isFirstChunk,
@@ -252,6 +269,7 @@ export class Aggregate extends AggregateBase {
     this.events = [];
     this.isFirstChunk = false;
     this.hasSnapshot = false;
+    this.hasMeta = false;
     this.hasError = false;
     this.payloadBytesEstimation = 0;
     this.clearTimestamps();
@@ -263,27 +281,30 @@ export class Aggregate extends AggregateBase {
       warn('Recording library was never imported');
       return this.abort();
     }
+    this.clearTimestamps();
+    // set the fallbacks as early as possible
+    this.setTimestamps();
     this.recording = true;
     const {
-      blockClass,
-      ignoreClass,
-      maskTextClass,
-      blockSelector,
-      maskInputOptions,
-      maskTextSelector,
-      maskAllInputs
+      block_class,
+      ignore_class,
+      mask_text_class,
+      block_selector,
+      mask_input_options,
+      mask_text_selector,
+      mask_all_inputs
     } = getConfigurationValue(this.agentIdentifier, 'session_replay');
     // set up rrweb configurations for maximum privacy --
     // https://newrelic.atlassian.net/wiki/spaces/O11Y/pages/2792293280/2023+02+28+Browser+-+Session+Replay#Configuration-options
     const stop = recorder({
       emit: this.store.bind(this),
-      blockClass,
-      ignoreClass,
-      maskTextClass,
-      blockSelector,
-      maskInputOptions,
-      maskTextSelector,
-      maskAllInputs,
+      blockClass: block_class,
+      ignoreClass: ignore_class,
+      maskTextClass: mask_text_class,
+      blockSelector: block_selector,
+      maskInputOptions: mask_input_options,
+      maskTextSelector: mask_text_selector,
+      maskAllInputs: mask_all_inputs,
       checkoutEveryNms: CHECKOUT_MS[this.mode]
     });
     this.stopRecording = () => {
@@ -294,6 +315,7 @@ export class Aggregate extends AggregateBase {
 
   /** Store a payload in the buffer (this.events).  This should be the callback to the recording lib noticing a mutation */
   store(event, isCheckout) {
+    this.setTimestamps(event);
     if (this.blocked) return;
     const eventBytes = stringify(event).length;
     /** The estimated size of the payload after compression */
@@ -310,8 +332,22 @@ export class Aggregate extends AggregateBase {
       // we are still waiting for an error to throw, so keep wiping the buffer over time
       this.clearBuffer();
     }
-    this.setTimestamps(event);
-    if (event.type === 2) this.hasSnapshot = true;
+
+    // meta event
+    if (event.type === 4) {
+      this.hasMeta = true;
+      this.lastMeta = event;
+    }
+    // snapshot event
+    if (event.type === 2) {
+      this.hasSnapshot = true;
+      // small chance that the meta event got separated from its matching snapshot across payload harvests
+      // it needs to precede the snapshot, so shove it in first.
+      if (!this.hasMeta) {
+        this.events.push(this.lastMeta);
+        this.hasMeta = true;
+      }
+    }
     this.events.push(event);
     this.payloadBytesEstimation += eventBytes;
 
@@ -328,15 +364,25 @@ export class Aggregate extends AggregateBase {
     if (!recorder) return;
     recorder.takeFullSnapshot();
   }
-  setTimestamps(rrwebEvent) {
-    if (!rrwebEvent) return;
-    if (!this.timestamp.first) this.timestamp.first = rrwebEvent.timestamp;
-    this.timestamp.last = rrwebEvent.timestamp;
+  setTimestamps(event) {
+    // fallbacks if timestamps cannot be derived from rrweb events
+    this.timestamp.cycle.last = getRuntime(this.agentIdentifier).offset + globalScope.performance.now();
+    if (!this.timestamp.cycle.first) this.timestamp.cycle.first = this.timestamp.cycle.last;
+    // timestamps based on rrweb events
+    if (!event || !event.timestamp) return;
+    if (!this.timestamp.event.first) this.timestamp.event.first = event.timestamp;
+    this.timestamp.event.last = event.timestamp;
   }
   clearTimestamps() {
     this.timestamp = {
-      first: undefined,
-      last: undefined
+      event: {
+        first: undefined,
+        last: undefined
+      },
+      cycle: {
+        first: undefined,
+        last: undefined
+      }
     };
   }
 

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

@@ -485,9 +485,12 @@ export class Aggregate extends AggregateBase {
       // if PO isn't supported, this checks resourcetiming buffer every harvest.
       this.storeResources(window.performance.getEntriesByType('resource'));
     }
+    let earliestTimeStamp = Infinity;
     const stns = Object.entries(this.trace).flatMap(_ref3 => {
       let [name, listOfSTNodes] = _ref3;
       // basically take the "this.trace" map-obj and concat all the list-type values
+      const oldestNodeTS = listOfSTNodes.reduce((acc, next) => !acc || next.s < acc ? next.s : acc, undefined);
+      if (oldestNodeTS < earliestTimeStamp) earliestTimeStamp = oldestNodeTS;
       if (!(name in toAggregate)) return listOfSTNodes;
       // Special processing for event nodes dealing with user inputs:
       const reindexByOriginFn = this.smearEvtsByOrigin(name);
@@ -502,8 +505,17 @@ export class Aggregate extends AggregateBase {
     this.nodeCount = 0;
     return {
       qs: {
-        st: String(getRuntime(this.agentIdentifier).offset)
+        st: this.agentRuntime.offset,
+        /** hr === "hasReplay" in NR1, standalone is always checked and processed before harvesting
+         * so a race condition between ST and SR states should not be a concern if implemented here */
+        hr: Number(!this.isStandalone),
+        /** fts === "firstTimestamp" in NR1, indicates what the earliest NODE timestamp was
+         * so that blob parsing doesn't need to happen to support UI/API functions  */
+        fts: this.agentRuntime.offset + earliestTimeStamp,
+        /** n === "nodeCount" in NR1, a count of nodes in the ST payload, so that blob parsing doesn't need to happen to support UI/API functions */
+        n: stns.length // node count
       },
+
       body: {
         res: stns
       }

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

@@ -9,7 +9,6 @@ import { shouldCollectEvent } from '../../../common/deny-list/deny-list';
 import { mapOwn } from '../../../common/util/map-own';
 import { navTimingValues as navTiming } from '../../../common/timing/nav-timing';
 import { generateUuid } from '../../../common/ids/unique-id';
-import { paintMetrics } from '../../../common/metrics/paint-metrics';
 import { Interaction } from './interaction';
 import { getConfigurationValue, getRuntime } from '../../../common/config/config';
 import { eventListenerOpts } from '../../../common/event-listener/event-listener-opts';
@@ -19,6 +18,8 @@ import { ee } from '../../../common/event-emitter/contextual-ee';
 import * as CONSTANTS from '../constants';
 import { FEATURE_NAMES } from '../../../loaders/features/features';
 import { AggregateBase } from '../../utils/aggregate-base';
+import { firstContentfulPaint } from '../../../common/vitals/first-contentful-paint';
+import { firstPaint } from '../../../common/vitals/first-paint';
 const {
   FEATURE_NAME,
   INTERACTION_EVENTS,
@@ -653,8 +654,8 @@ export class Aggregate extends AggregateBase {
       // assign unique id, this is serialized and used to link interactions with errors
       interaction.root.attrs.id = generateUuid();
       if (interaction.root.attrs.trigger === 'initialPageLoad') {
-        interaction.root.attrs.firstPaint = paintMetrics['first-paint'];
-        interaction.root.attrs.firstContentfulPaint = paintMetrics['first-contentful-paint'];
+        interaction.root.attrs.firstPaint = firstPaint.current.value;
+        interaction.root.attrs.firstContentfulPaint = firstContentfulPaint.current.value;
       }
       baseEE.emit('interactionSaved', [interaction]);
       state.interactionsToHarvest.push(interaction);

package/dist/esm/loaders/agent.js

@@ -1,3 +1,5 @@
+// important side effects
+import "./configure/public-path.npm";
 // loader files
 import { AgentBase } from './agent-base';
 import { getEnabledFeatures } from './features/enabled-features';

package/dist/esm/loaders/api/api.js

@@ -123,6 +123,8 @@ export function setAPI(agentIdentifier, forceDrain) {
   };
   apiInterface.start = features => {
     try {
+      const smTag = !features ? 'undefined' : 'defined';
+      handle(SUPPORTABILITY_METRIC_CHANNEL, ["API/start/".concat(smTag, "/called")], undefined, FEATURE_NAMES.metrics, instanceEE);
       const featNames = Object.values(FEATURE_NAMES);
       if (features === undefined) features = featNames;else {
         features = Array.isArray(features) && features.length ? features : [features];

package/dist/esm/loaders/api/apiAsync.js

@@ -1,5 +1,5 @@
 import { FEATURE_NAMES } from '../features/features';
-import { getConfigurationValue, getInfo, getRuntime } from '../../common/config/config';
+import { getConfiguration, getInfo, getRuntime } from '../../common/config/config';
 import { ee } from '../../common/event-emitter/contextual-ee';
 import { handle } from '../../common/event-emitter/handle';
 import { registerHandler } from '../../common/event-emitter/register-handler';
@@ -10,7 +10,6 @@ import { CUSTOM_METRIC_CHANNEL } from '../../features/metrics/constants';
 export function setAPI(agentIdentifier) {
   var instanceEE = ee.get(agentIdentifier);
   var cycle = 0;
-  var scheme = getConfigurationValue(agentIdentifier, 'ssl') === false ? 'http' : 'https';
   var api = {
     finished: single(finished),
     setErrorHandler,
@@ -66,7 +65,10 @@ export function setAPI(agentIdentifier) {
     cycle += 1;
     const agentInfo = getInfo(agentIdentifier);
     if (!agentInfo.beacon) return;
-    var url = scheme + '://' + agentInfo.beacon + '/1/' + agentInfo.licenseKey;
+    const agentInit = getConfiguration(agentIdentifier);
+    const scheme = agentInit.ssl === false ? 'http' : 'https';
+    const beacon = agentInit.proxy.beacon || agentInfo.beacon;
+    let url = "".concat(scheme, "://").concat(beacon, "/1/").concat(agentInfo.licenseKey);
     url += '?a=' + agentInfo.applicationID + '&';
     url += 't=' + requestName + '&';
     url += 'qt=' + ~~queueTime + '&';

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

@@ -7,6 +7,7 @@ import { Instrument as InstrumentXhr } from '../features/ajax/instrument';
 import { Instrument as InstrumentSessionTrace } from '../features/session_trace/instrument';
 import { Instrument as InstrumentSpa } from '../features/spa/instrument';
 import { Instrument as InstrumentPageAction } from '../features/page_action/instrument';
+import { Instrument as InstrumentSessionReplay } from '../features/session_replay/instrument';
 
 /**
  * An agent class with all feature modules available. Features may be disabled and enabled via runtime configuration.
@@ -16,7 +17,7 @@ export class BrowserAgent extends Agent {
   constructor(args) {
     super({
       ...args,
-      features: [InstrumentXhr, InstrumentPageViewEvent, InstrumentPageViewTiming, InstrumentSessionTrace, InstrumentMetrics, InstrumentPageAction, InstrumentErrors, InstrumentSpa],
+      features: [InstrumentXhr, InstrumentPageViewEvent, InstrumentPageViewTiming, InstrumentSessionTrace, InstrumentMetrics, InstrumentPageAction, InstrumentErrors, InstrumentSpa, InstrumentSessionReplay],
       loaderType: 'browser-agent'
     });
   }

package/dist/esm/loaders/configure/configure.js

@@ -3,6 +3,9 @@ import { addToNREUM, gosCDN, gosNREUMInitializedAgents } from '../../common/wind
 import { getConfiguration, setConfiguration, setInfo, setLoaderConfig, setRuntime } from '../../common/config/config';
 import { activatedFeatures } from '../../common/util/feature-flags';
 import { isWorkerScope } from '../../common/constants/runtime';
+import { redefinePublicPath } from './public-path';
+let alreadySetOnce = false; // the configure() function can run multiple times in agent lifecycle
+
 export function configure(agentIdentifier) {
   let opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
   let loaderType = arguments.length > 2 ? arguments[2] : undefined;
@@ -34,7 +37,16 @@ export function configure(agentIdentifier) {
   }
   setInfo(agentIdentifier, info);
   const updatedInit = getConfiguration(agentIdentifier);
-  runtime.denyList = [...(updatedInit.ajax?.deny_list || []), ...(updatedInit.ajax?.block_internal ? [info.beacon, info.errorBeacon] : [])];
+  const internalTrafficList = [info.beacon, info.errorBeacon];
+  if (!alreadySetOnce) {
+    alreadySetOnce = true;
+    if (updatedInit.proxy.assets) {
+      redefinePublicPath(updatedInit.proxy.assets + '/'); // much like the info.beacon & init.proxy.beacon, this input should not end in a slash, but one is needed for webpack concat
+      internalTrafficList.push(updatedInit.proxy.assets);
+    }
+    if (updatedInit.proxy.beacon) internalTrafficList.push(updatedInit.proxy.beacon);
+  }
+  runtime.denyList = [...(updatedInit.ajax.deny_list || []), ...(updatedInit.ajax.block_internal ? internalTrafficList : [])];
   setRuntime(agentIdentifier, runtime);
   setTopLevelCallers();
   const api = setAPI(agentIdentifier, forceDrain);

package/dist/esm/loaders/configure/public-path.js

@@ -0,0 +1,6 @@
+// Set the default CDN or remote for fetching the assets; NPM shouldn't change this var.
+
+export const redefinePublicPath = url => {
+  // There's no URL validation here, so caller should check arg if need be.
+  __webpack_public_path__ = url; // eslint-disable-line
+};

package/dist/esm/loaders/configure/public-path.npm.js

@@ -0,0 +1,3 @@
+export const redefinePublicPath = () => {
+  // We don't support setting public path in webpack via NPM build.
+};

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":"AAsEA,+CAIC;AAED,0DAIC;AAED,+DAYC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../src/common/config/state/init.js"],"names":[],"mappings":"AA0EA,+CAIC;AAED,0DAIC;AAED,+DAYC"}

package/dist/types/common/constants/runtime.d.ts

@@ -13,6 +13,7 @@ export const isBrowserScope: boolean;
  */
 export const isWorkerScope: boolean;
 export const globalScope: false | typeof globalThis;
+export const initiallyHidden: boolean;
 export const initialLocation: string;
 export const isiOS: boolean;
 /**
@@ -25,5 +26,6 @@ export const isiOS: boolean;
 export const iOSBelow16: boolean;
 export const ffVersion: number;
 export const isIE: boolean;
-export const supportsSendBeacon: true;
+export const supportsSendBeacon: boolean;
+export const offset: number;
 //# sourceMappingURL=runtime.d.ts.map