@newrelic/browser-agent 1.290.1 → 1.291.1

package/CHANGELOG.md

@@ -3,6 +3,28 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.291.1](https://github.com/newrelic/newrelic-browser-agent/compare/v1.291.0...v1.291.1) (2025-06-06)
+
+
+### Bug Fixes
+
+* Add safeguards for addToTrace ([#1490](https://github.com/newrelic/newrelic-browser-agent/issues/1490)) ([e94a36e](https://github.com/newrelic/newrelic-browser-agent/commit/e94a36efaf37f69dfdb8134bc27ee0df0a734e83))
+* Clean BrowserPerformance entryName for resources ([#1493](https://github.com/newrelic/newrelic-browser-agent/issues/1493)) ([09ff0ad](https://github.com/newrelic/newrelic-browser-agent/commit/09ff0adb27c12e99c02c81462aeb921af8686ce8))
+* Prevent ST from holding onto Event refs in memory when aborted ([#1491](https://github.com/newrelic/newrelic-browser-agent/issues/1491)) ([a1d15cb](https://github.com/newrelic/newrelic-browser-agent/commit/a1d15cb9d972a2fa421a648b83e150489799d437))
+
+## [1.291.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.290.1...v1.291.0) (2025-05-30)
+
+
+### Features
+
+* Create the measure API ([#1476](https://github.com/newrelic/newrelic-browser-agent/issues/1476)) ([f944b76](https://github.com/newrelic/newrelic-browser-agent/commit/f944b76c2137e6d75e47e692ded4ba5f04bb4b6d))
+
+
+### Bug Fixes
+
+* Fix race between end of session and features aborting ([#1487](https://github.com/newrelic/newrelic-browser-agent/issues/1487)) ([531f8d4](https://github.com/newrelic/newrelic-browser-agent/commit/531f8d4228f6c7ead8e2342c8a8dd25c651e9ec6))
+* Harvest first session trace payload immediately ([#1483](https://github.com/newrelic/newrelic-browser-agent/issues/1483)) ([50f4ace](https://github.com/newrelic/newrelic-browser-agent/commit/50f4acea3e27c6b5e65d02ffb46af02b351e4500))
+
 ## [1.290.1](https://github.com/newrelic/newrelic-browser-agent/compare/v1.290.0...v1.290.1) (2025-05-21)
 
 

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

@@ -17,7 +17,7 @@ exports.VERSION = exports.RRWEB_VERSION = exports.DIST_METHOD = exports.BUILD_EN
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.290.1";
+const VERSION = exports.VERSION = "1.291.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.DIST_METHOD = exports.BUILD_EN
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.290.1";
+const VERSION = exports.VERSION = "1.291.1";
 
 /**
  * Exposes the build type of the agent

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

@@ -10,7 +10,6 @@ var _env = require("../constants/env.npm");
 var _runtime = require("../constants/runtime");
 var _handle = require("../event-emitter/handle");
 var _eventListenerOpts = require("../event-listener/event-listener-opts");
-var _constants2 = require("../session/constants");
 var _now = require("../timing/now");
 var _eol = require("../unload/eol");
 var _cleanUrl = require("../url/clean-url");
@@ -43,12 +42,6 @@ class Harvester {
       }));
       /* This callback should run in bubble phase, so that that CWV api, like "onLCP", is called before the final harvest so that emitted timings are part of last outgoing. */
     }, false);
-
-    /* Flush all buffered data if session resets and give up retries. This should be synchronous to ensure that the correct `session` value is sent.
-      Since session-reset generates a new session ID and the ID is grabbed at send-time, any delays or retries would cause the payload to be sent under the wrong session ID. */
-    agentRef.ee.on(_constants2.SESSION_EVENTS.RESET, () => this.initializedAggregates.forEach(aggregateInst => this.triggerHarvestFor(aggregateInst, {
-      forceNoRetry: true
-    })));
   }
   startTimer(harvestInterval = this.agentRef.init.harvest.interval) {
     if (this.#started) return;

package/dist/cjs/common/session/session-entity.js

@@ -240,7 +240,10 @@ class SessionEntity {
     // * stop recording (stn and sr)...
     // * delete the session and start over
     try {
-      if (this.initialized) this.ee.emit(_constants.SESSION_EVENTS.RESET);
+      if (this.initialized) {
+        this.ee.emit(_constants.SESSION_EVENTS.RESET);
+        this.state.numOfResets++;
+      }
       this.storage.remove(this.lookupKey);
       this.inactiveTimer?.abort?.();
       this.expiresTimer?.clear?.();
@@ -251,7 +254,7 @@ class SessionEntity {
         storage: this.storage,
         expiresMs: this.expiresMs,
         inactiveMs: this.inactiveMs,
-        numOfResets: ++this.state.numOfResets
+        numOfResets: this.state.numOfResets
       });
       return this.read();
     } catch (e) {
@@ -270,9 +273,6 @@ class SessionEntity {
       inactiveAt: this.getFutureTimestamp(this.inactiveMs)
     });
   }
-  isAfterSessionExpiry(timestamp) {
-    return this.state.numOfResets > 0 || typeof timestamp === 'number' && typeof this.state.expiresAt === 'number' && timestamp >= this.state.expiresAt;
-  }
 
   /**
    * @param {number} timestamp

package/dist/cjs/common/util/console.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.warn = warn;
+var _globalEvent = require("../dispatch/global-event");
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -20,4 +21,15 @@ exports.warn = warn;
 function warn(code, secondary) {
   if (typeof console.debug !== 'function') return;
   console.debug("New Relic Warning: https://github.com/newrelic/newrelic-browser-agent/blob/main/docs/warning-codes.md#".concat(code), secondary);
+  (0, _globalEvent.dispatchGlobalEvent)({
+    agentIdentifier: null,
+    drained: null,
+    type: 'data',
+    name: 'warn',
+    feature: 'warn',
+    data: {
+      code,
+      secondary
+    }
+  });
 }

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

@@ -148,7 +148,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
                       ...detailObj,
                       eventType: 'BrowserPerformance',
                       timestamp: this.toEpoch(entry.startTime),
-                      entryName: (0, _cleanUrl.cleanURL)(entry.name),
+                      entryName: entry.name,
                       entryDuration: entry.duration,
                       entryType: type
                     });
@@ -214,7 +214,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
               ...entryObject,
               eventType: 'BrowserPerformance',
               timestamp: Math.floor(agentRef.runtime.timeKeeper.correctRelativeTimestamp(entryObject.startTime)),
-              entryName: name,
+              entryName: (0, _cleanUrl.cleanURL)(name),
               entryDuration: duration,
               firstParty
             };
@@ -224,6 +224,22 @@ class Aggregate extends _aggregateBase.AggregateBase {
           }
         }, this.featureName, this.ee);
       }
+      (0, _registerHandler.registerHandler)('api-measure', (args, n) => {
+        const {
+          start,
+          duration,
+          customAttributes
+        } = args;
+        const event = {
+          ...customAttributes,
+          eventType: 'BrowserPerformance',
+          timestamp: Math.floor(agentRef.runtime.timeKeeper.correctRelativeTimestamp(start)),
+          entryName: n,
+          entryDuration: duration,
+          entryType: 'measure'
+        };
+        this.addEvent(event);
+      }, this.featureName, this.ee);
       agentRef.runtime.harvester.triggerHarvestFor(this);
       this.drain();
     });

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

@@ -12,6 +12,7 @@ var _addPageAction = require("../../../loaders/api/addPageAction");
 var _finished = require("../../../loaders/api/finished");
 var _recordCustomEvent = require("../../../loaders/api/recordCustomEvent");
 var _register = require("../../../loaders/api/register");
+var _measure = require("../../../loaders/api/measure");
 var _instrumentBase = require("../../utils/instrument-base");
 var _constants = require("../constants");
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
@@ -31,6 +32,7 @@ class Instrument extends _instrumentBase.InstrumentBase {
     (0, _recordCustomEvent.setupRecordCustomEventAPI)(agentRef);
     (0, _finished.setupFinishedAPI)(agentRef);
     (0, _register.setupRegisterAPI)(agentRef);
+    (0, _measure.setupMeasureAPI)(agentRef);
     if (_runtime.isBrowserScope) {
       if (agentRef.init.user_actions.enabled) {
         _constants.OBSERVED_EVENTS.forEach(eventType => (0, _eventListenerOpts.windowAddEventListener)(eventType, evt => (0, _handle.handle)('ua', [evt], undefined, this.featureName, this.ee), true));

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

@@ -281,6 +281,9 @@ class Aggregate extends _aggregateBase.AggregateBase {
     this.recorder.clearBuffer();
     if (recorderEvents.type === 'preloaded') this.agentRef.runtime.harvester.triggerHarvestFor(this);
     payloadOutput.payload = payload;
+    if (!this.agentRef.runtime.session.state.traceHarvestStarted) {
+      (0, _console.warn)(59, JSON.stringify(this.agentRef.runtime.session.state));
+    }
     return [payloadOutput];
   }
   getCorrectedTimestamp(node) {

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

@@ -168,10 +168,6 @@ class Recorder {
   /** Store a payload in the buffer (this.#events).  This should be the callback to the recording lib noticing a mutation */
   store(event, isCheckout) {
     if (!event) return;
-    if (this.parent.agentRef.runtime.session?.isAfterSessionExpiry(event.timestamp)) {
-      (0, _handle.handle)(_constants3.SUPPORTABILITY_METRIC_CHANNEL, ['Session/Expired/SessionReplay/Seen'], undefined, _features.FEATURE_NAMES.metrics, this.ee);
-      return;
-    }
     if (!(this.parent instanceof _aggregateBase.AggregateBase) && this.#preloaded.length) this.currentBufferTarget = this.#preloaded[this.#preloaded.length - 1];else this.currentBufferTarget = this.#events;
     if (this.parent.blocked) return;
     if (this.parent.timeKeeper?.ready && !event.__newrelic) {

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

@@ -13,6 +13,7 @@ var _runtime = require("../../../common/constants/runtime");
 var _constants2 = require("../../../common/session/constants");
 var _traverse = require("../../../common/util/traverse");
 var _cleanUrl = require("../../../common/url/clean-url");
+var _console = require("../../../common/util/console");
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -85,7 +86,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     (0, _registerHandler.registerHandler)('bstResource', (...args) => this.events.storeResources(...args), this.featureName, this.ee);
     (0, _registerHandler.registerHandler)('bstHist', (...args) => this.events.storeHist(...args), this.featureName, this.ee);
     (0, _registerHandler.registerHandler)('bstXhrAgg', (...args) => this.events.storeXhrAgg(...args), this.featureName, this.ee);
-    (0, _registerHandler.registerHandler)('bstApi', (...args) => this.events.storeSTN(...args), this.featureName, this.ee);
+    (0, _registerHandler.registerHandler)('bstApi', (...args) => this.events.storeNode(...args), this.featureName, this.ee);
     (0, _registerHandler.registerHandler)('trace-jserror', (...args) => this.events.storeErrorAgg(...args), this.featureName, this.ee);
     (0, _registerHandler.registerHandler)('pvtAdded', (...args) => this.events.processPVT(...args), this.featureName, this.ee);
     if (this.mode !== _constants2.MODE.FULL) {
@@ -98,9 +99,11 @@ class Aggregate extends _aggregateBase.AggregateBase {
       sessionTraceMode: this.mode
     });
     this.drain();
+    /** try to harvest immediately. This will not send if the trace is not running in FULL mode due to the pre-harvest checks. */
+    this.agentRef.runtime.harvester.triggerHarvestFor(this);
   }
   preHarvestChecks() {
-    if (this.mode !== _constants2.MODE.FULL) return; // only allow harvest if running in full mode
+    if (this.blocked || this.mode !== _constants2.MODE.FULL) return; // only allow harvest if running in full mode
     if (!this.timeKeeper?.ready) return; // this should likely never happen, but just to be safe, we should never harvest if we cant correct time
     if (!this.agentRef.runtime.session) return; // session entity is required for trace to run and continue running
     if (this.sessionId !== this.agentRef.runtime.session.state.value || this.ptid !== this.agentRef.runtime.ptid) {
@@ -194,7 +197,8 @@ class Aggregate extends _aggregateBase.AggregateBase {
   }
 
   /** Stop running for the remainder of the page lifecycle */
-  abort() {
+  abort(code) {
+    (0, _console.warn)(60, code);
     this.blocked = true;
     this.mode = _constants2.MODE.OFF;
     this.agentRef.runtime.session.write({

package/dist/cjs/features/session_trace/aggregate/trace/storage.js

@@ -53,23 +53,19 @@ class TraceStorage {
   constructor(parent) {
     this.parent = parent;
   }
-  isAfterSessionExpiry(entryTimestamp) {
-    return this.parent.agentRef.runtime?.session?.isAfterSessionExpiry((this.parent.timeKeeper?.ready && this.parent.timeKeeper.convertRelativeTimestamp(entryTimestamp)) ?? undefined);
-  }
-
-  /** Central function called by all the other store__ & addToTrace API to append a trace node. */
-  storeSTN(stn) {
-    if (this.parent.blocked) return;
+  #canStoreNewNode() {
+    if (this.parent.blocked) return false;
     if (this.nodeCount >= _constants2.MAX_NODES_PER_HARVEST) {
       // limit the amount of pending data awaiting next harvest
-      if (this.parent.mode !== _constants.MODE.ERROR) return;
+      if (this.parent.mode !== _constants.MODE.ERROR) return false;
       const openedSpace = this.trimSTNs(ERROR_MODE_SECONDS_WINDOW); // but maybe we could make some space by discarding irrelevant nodes if we're in sessioned Error mode
-      if (openedSpace === 0) return;
-    }
-    if (this.isAfterSessionExpiry(stn.s)) {
-      this.parent.reportSupportabilityMetric('Session/Expired/SessionTrace/Seen');
-      return;
+      if (openedSpace === 0) return false;
     }
+    return true;
+  }
+
+  /** Central internal function called by all the other store__ & addToTrace API to append a trace node. They MUST all have checked #canStoreNewNode before calling this func!! */
+  #storeSTN(stn) {
     if (this.trace[stn.n]) this.trace[stn.n].push(stn);else this.trace[stn.n] = [stn];
     if (stn.s < this.earliestTimeStamp) this.earliestTimeStamp = stn.s;
     if (stn.s > this.latestTimeStamp) this.latestTimeStamp = stn.s;
@@ -149,6 +145,10 @@ class TraceStorage {
       return !!(node && typeof node.e === 'number' && typeof node.s === 'number' && node.e - node.s < limit);
     }
   }
+  storeNode(node) {
+    if (!this.#canStoreNewNode()) return;
+    this.#storeSTN(node);
+  }
   processPVT(name, value, attrs) {
     this.storeTiming({
       [name]: value
@@ -172,13 +172,16 @@ class TraceStorage {
       if (this.parent.timeKeeper && this.parent.timeKeeper.ready && isAbsoluteTimestamp) {
         val = this.parent.timeKeeper.convertAbsoluteTimestamp(Math.floor(this.parent.timeKeeper.correctAbsoluteTimestamp(val)));
       }
-      this.storeSTN(new _node.TraceNode(key, val, val, 'document', 'timing'));
+      if (!this.#canStoreNewNode()) return; // at any point when no new nodes can be stored, there's no point in processing the rest of the timing entries
+      this.#storeSTN(new _node.TraceNode(key, val, val, 'document', 'timing'));
     }
   }
 
   // Tracks the events and their listener's duration on objects wrapped by wrap-events.
   storeEvent(currentEvent, target, start, end) {
     if (this.shouldIgnoreEvent(currentEvent, target)) return;
+    if (!this.#canStoreNewNode()) return; // need to check if adding node will succeed BEFORE storing event ref below (*cli Jun'25 - addressing memory leak in aborted ST issue #NR-420780)
+
     if (this.prevStoredEvents.has(currentEvent)) return; // prevent multiple listeners of an event from creating duplicate trace nodes per occurrence. Cleared every harvest. near-zero chance for re-duplication after clearing per harvest since the timestamps of the event are considered for uniqueness.
     this.prevStoredEvents.add(currentEvent);
     const evt = new _node.TraceNode(this.evtName(currentEvent.type), start, end, undefined, 'event');
@@ -189,7 +192,7 @@ class TraceStorage {
     } catch (e) {
       evt.o = (0, _eventOrigin.eventOrigin)(null, target, this.parent.ee);
     }
-    this.storeSTN(evt);
+    this.#storeSTN(evt);
   }
   shouldIgnoreEvent(event, target) {
     if (event.type in ignoredEvents.global) return true;
@@ -225,14 +228,17 @@ class TraceStorage {
 
   // Tracks when the window history API specified by wrap-history is used.
   storeHist(path, old, time) {
-    this.storeSTN(new _node.TraceNode('history.pushState', time, time, path, old));
+    if (!this.#canStoreNewNode()) return;
+    this.#storeSTN(new _node.TraceNode('history.pushState', time, time, path, old));
   }
   #laststart = 0;
   // Processes all the PerformanceResourceTiming entries captured (by observer).
   storeResources(resources) {
     if (!resources || resources.length === 0) return;
-    resources.forEach(currentResource => {
-      if ((currentResource.fetchStart | 0) <= this.#laststart) return; // don't recollect already-seen resources
+    for (let i = 0; i < resources.length; i++) {
+      const currentResource = resources[i];
+      if ((currentResource.fetchStart | 0) <= this.#laststart) continue; // don't recollect already-seen resources
+      if (!this.#canStoreNewNode()) break; // stop processing if we can't store any more resource nodes anyways
 
       const {
         initiatorType,
@@ -247,21 +253,23 @@ class TraceStorage {
         pathname
       } = (0, _parseUrl.parseUrl)(currentResource.name);
       const res = new _node.TraceNode(initiatorType, fetchStart | 0, responseEnd | 0, "".concat(protocol, "://").concat(hostname, ":").concat(port).concat(pathname), entryType);
-      this.storeSTN(res);
-    });
+      this.#storeSTN(res);
+    }
     this.#laststart = resources[resources.length - 1].fetchStart | 0;
   }
 
   // JavascriptError (FEATURE) events pipes into ST here.
   storeErrorAgg(type, name, params, metrics) {
     if (type !== 'err') return; // internal errors are purposefully ignored
-    this.storeSTN(new _node.TraceNode('error', metrics.time, metrics.time, params.message, params.stackHash));
+    if (!this.#canStoreNewNode()) return;
+    this.#storeSTN(new _node.TraceNode('error', metrics.time, metrics.time, params.message, params.stackHash));
   }
 
   // Ajax (FEATURE) events--XML & fetches--pipes into ST here.
   storeXhrAgg(type, name, params, metrics) {
     if (type !== 'xhr') return;
-    this.storeSTN(new _node.TraceNode('Ajax', metrics.time, metrics.time + metrics.duration, "".concat(params.status, " ").concat(params.method, ": ").concat(params.host).concat(params.pathname), 'ajax'));
+    if (!this.#canStoreNewNode()) return;
+    this.#storeSTN(new _node.TraceNode('Ajax', metrics.time, metrics.time + metrics.duration, "".concat(params.status, " ").concat(params.method, ": ").concat(params.host).concat(params.pathname), 'ajax'));
   }
 
   /* Below are the interface expected & required of whatever storage is used across all features on an individual basis. This allows a common `.events` property on Trace shared with AggregateBase.
@@ -286,7 +294,12 @@ class TraceStorage {
     this.latestTimeStamp = 0;
   }
   reloadSave() {
-    Object.values(this.#backupTrace).forEach(stnsArray => stnsArray.forEach(stn => this.storeSTN(stn)));
+    for (const stnsArray of Object.values(this.#backupTrace)) {
+      for (const stn of stnsArray) {
+        if (!this.#canStoreNewNode()) return; // stop attempting to re-store nodes
+        this.#storeSTN(stn);
+      }
+    }
   }
   clearSave() {
     this.#backupTrace = undefined;

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

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.setupAddToTraceAPI = setupAddToTraceAPI;
 var _runtime = require("../../common/constants/runtime");
 var _handle = require("../../common/event-emitter/handle");
+var _console = require("../../common/util/console");
 var _features = require("../features/features");
 var _constants = require("./constants");
 var _sharedHandlers = require("./sharedHandlers");
@@ -24,6 +25,13 @@ function setupAddToTraceAPI(agent) {
       o: evt.origin || '',
       t: 'api'
     };
+    if (report.s < 0 || report.e < 0 || report.e < report.s) {
+      (0, _console.warn)(61, {
+        start: report.s,
+        end: report.e
+      });
+      return;
+    }
     (0, _handle.handle)('bstApi', [report], undefined, _features.FEATURE_NAMES.sessionTrace, agent.ee);
   }, agent);
 }

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

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.spaPrefix = exports.prefix = exports.WRAP_LOGGER = exports.START = exports.SET_USER_ID = exports.SET_PAGE_VIEW_NAME = exports.SET_ERROR_HANDLER = exports.SET_CUSTOM_ATTRIBUTE = exports.SET_CURRENT_ROUTE_NAME = exports.SET_APPLICATION_VERSION = exports.REGISTER = exports.RECORD_REPLAY = exports.RECORD_CUSTOM_EVENT = exports.PAUSE_REPLAY = exports.NOTICE_ERROR = exports.LOG = exports.INTERACTION = exports.FINISHED = exports.ADD_TO_TRACE = exports.ADD_RELEASE = exports.ADD_PAGE_ACTION = void 0;
+exports.spaPrefix = exports.prefix = exports.WRAP_LOGGER = exports.START = exports.SET_USER_ID = exports.SET_PAGE_VIEW_NAME = exports.SET_ERROR_HANDLER = exports.SET_CUSTOM_ATTRIBUTE = exports.SET_CURRENT_ROUTE_NAME = exports.SET_APPLICATION_VERSION = exports.REGISTER = exports.RECORD_REPLAY = exports.RECORD_CUSTOM_EVENT = exports.PAUSE_REPLAY = exports.NOTICE_ERROR = exports.MEASURE = exports.LOG = exports.INTERACTION = exports.FINISHED = exports.ADD_TO_TRACE = exports.ADD_RELEASE = exports.ADD_PAGE_ACTION = void 0;
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -28,4 +28,5 @@ const SET_ERROR_HANDLER = exports.SET_ERROR_HANDLER = 'setErrorHandler';
 const SET_PAGE_VIEW_NAME = exports.SET_PAGE_VIEW_NAME = 'setPageViewName';
 const SET_USER_ID = exports.SET_USER_ID = 'setUserId';
 const START = exports.START = 'start';
-const WRAP_LOGGER = exports.WRAP_LOGGER = 'wrapLogger';
+const WRAP_LOGGER = exports.WRAP_LOGGER = 'wrapLogger';
+const MEASURE = exports.MEASURE = 'measure';

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

@@ -0,0 +1,60 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.setupMeasureAPI = setupMeasureAPI;
+var _handle = require("../../common/event-emitter/handle");
+var _now = require("../../common/timing/now");
+var _console = require("../../common/util/console");
+var _features = require("../features/features");
+var _constants = require("./constants");
+var _sharedHandlers = require("./sharedHandlers");
+/**
+ * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+function setupMeasureAPI(agent) {
+  (0, _sharedHandlers.setupAPI)(_constants.MEASURE, function (name, options) {
+    const n = (0, _now.now)();
+    const {
+      start,
+      end,
+      customAttributes
+    } = options || {};
+    const returnObj = {
+      customAttributes: customAttributes || {}
+    };
+    if (typeof returnObj.customAttributes !== 'object' || typeof name !== 'string' || name.length === 0) {
+      (0, _console.warn)(57);
+      return;
+    }
+
+    /**
+     * getValueFromTiming - Helper function to extract a numeric value from a supplied option.
+     * @param {Number|PerformanceMark} [timing] The timing value
+     * @param {Number} [d] The default value to return if timing is invalid
+     * @returns {Number} The timing value or the default value
+     */
+    const getValueFromTiming = (timing, d) => {
+      if (timing == null) return d;
+      if (typeof timing === 'number') return timing;
+      if (timing instanceof PerformanceMark) return timing.startTime;
+      return Number.NaN;
+    };
+    returnObj.start = getValueFromTiming(start, 0);
+    returnObj.end = getValueFromTiming(end, n);
+    if (Number.isNaN(returnObj.start) || Number.isNaN(returnObj.end)) {
+      (0, _console.warn)(57);
+      return;
+    }
+    returnObj.duration = returnObj.end - returnObj.start;
+    if (returnObj.duration < 0) {
+      (0, _console.warn)(58);
+      return;
+    }
+    (0, _handle.handle)(_constants.prefix + _constants.MEASURE, [returnObj, name], undefined, _features.FEATURE_NAMES.genericEvents, agent.ee);
+    return returnObj;
+  }, agent);
+}

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

@@ -220,5 +220,16 @@ class ApiBase {
   wrapLogger(parent, functionName, options) {
     return this.#callMethod(_constants.WRAP_LOGGER, parent, functionName, options);
   }
+
+  /**
+   * Measures a task that is recorded as a BrowserPerformance event.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/measure/}
+   * @param {string} name The name of the task
+   * @param {object?} options An object used to control the way the measure API operates
+   * @returns {{start: number, end: number, duration: number, customAttributes: object}} Measurement details
+   */
+  measure(name, options) {
+    return this.#callMethod(_constants.MEASURE, name, options);
+  }
 }
 exports.ApiBase = ApiBase;

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

@@ -11,7 +11,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.290.1";
+export const VERSION = "1.291.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.290.1";
+export const VERSION = "1.291.1";
 
 /**
  * Exposes the build type of the agent

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

@@ -8,7 +8,6 @@ import { VERSION } from "../constants/env.npm";
 import { globalScope, isWorkerScope } from '../constants/runtime';
 import { handle } from '../event-emitter/handle';
 import { eventListenerOpts } from '../event-listener/event-listener-opts';
-import { SESSION_EVENTS } from '../session/constants';
 import { now } from '../timing/now';
 import { subscribeToEOL } from '../unload/eol';
 import { cleanURL } from '../url/clean-url';
@@ -36,12 +35,6 @@ export class Harvester {
       }));
       /* This callback should run in bubble phase, so that that CWV api, like "onLCP", is called before the final harvest so that emitted timings are part of last outgoing. */
     }, false);
-
-    /* Flush all buffered data if session resets and give up retries. This should be synchronous to ensure that the correct `session` value is sent.
-      Since session-reset generates a new session ID and the ID is grabbed at send-time, any delays or retries would cause the payload to be sent under the wrong session ID. */
-    agentRef.ee.on(SESSION_EVENTS.RESET, () => this.initializedAggregates.forEach(aggregateInst => this.triggerHarvestFor(aggregateInst, {
-      forceNoRetry: true
-    })));
   }
   startTimer(harvestInterval = this.agentRef.init.harvest.interval) {
     if (this.#started) return;

package/dist/esm/common/session/session-entity.js

@@ -234,7 +234,10 @@ export class SessionEntity {
     // * stop recording (stn and sr)...
     // * delete the session and start over
     try {
-      if (this.initialized) this.ee.emit(SESSION_EVENTS.RESET);
+      if (this.initialized) {
+        this.ee.emit(SESSION_EVENTS.RESET);
+        this.state.numOfResets++;
+      }
       this.storage.remove(this.lookupKey);
       this.inactiveTimer?.abort?.();
       this.expiresTimer?.clear?.();
@@ -245,7 +248,7 @@ export class SessionEntity {
         storage: this.storage,
         expiresMs: this.expiresMs,
         inactiveMs: this.inactiveMs,
-        numOfResets: ++this.state.numOfResets
+        numOfResets: this.state.numOfResets
       });
       return this.read();
     } catch (e) {
@@ -264,9 +267,6 @@ export class SessionEntity {
       inactiveAt: this.getFutureTimestamp(this.inactiveMs)
     });
   }
-  isAfterSessionExpiry(timestamp) {
-    return this.state.numOfResets > 0 || typeof timestamp === 'number' && typeof this.state.expiresAt === 'number' && timestamp >= this.state.expiresAt;
-  }
 
   /**
    * @param {number} timestamp

package/dist/esm/common/util/console.js

@@ -3,6 +3,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+import { dispatchGlobalEvent } from '../dispatch/global-event';
+
 /* eslint no-console: ["error", { allow: ["debug"] }] */
 
 /**
@@ -14,4 +16,15 @@
 export function warn(code, secondary) {
   if (typeof console.debug !== 'function') return;
   console.debug("New Relic Warning: https://github.com/newrelic/newrelic-browser-agent/blob/main/docs/warning-codes.md#".concat(code), secondary);
+  dispatchGlobalEvent({
+    agentIdentifier: null,
+    drained: null,
+    type: 'data',
+    name: 'warn',
+    feature: 'warn',
+    data: {
+      code,
+      secondary
+    }
+  });
 }

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

@@ -141,7 +141,7 @@ export class Aggregate extends AggregateBase {
                       ...detailObj,
                       eventType: 'BrowserPerformance',
                       timestamp: this.toEpoch(entry.startTime),
-                      entryName: cleanURL(entry.name),
+                      entryName: entry.name,
                       entryDuration: entry.duration,
                       entryType: type
                     });
@@ -207,7 +207,7 @@ export class Aggregate extends AggregateBase {
               ...entryObject,
               eventType: 'BrowserPerformance',
               timestamp: Math.floor(agentRef.runtime.timeKeeper.correctRelativeTimestamp(entryObject.startTime)),
-              entryName: name,
+              entryName: cleanURL(name),
               entryDuration: duration,
               firstParty
             };
@@ -217,6 +217,22 @@ export class Aggregate extends AggregateBase {
           }
         }, this.featureName, this.ee);
       }
+      registerHandler('api-measure', (args, n) => {
+        const {
+          start,
+          duration,
+          customAttributes
+        } = args;
+        const event = {
+          ...customAttributes,
+          eventType: 'BrowserPerformance',
+          timestamp: Math.floor(agentRef.runtime.timeKeeper.correctRelativeTimestamp(start)),
+          entryName: n,
+          entryDuration: duration,
+          entryType: 'measure'
+        };
+        this.addEvent(event);
+      }, this.featureName, this.ee);
       agentRef.runtime.harvester.triggerHarvestFor(this);
       this.drain();
     });