@newrelic/browser-agent 1.284.1 → 1.286.0

package/CHANGELOG.md

@@ -3,6 +3,35 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.286.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.285.0...v1.286.0) (2025-04-01)
+
+
+### Features
+
+* Erase .api property on agent instance ([#1425](https://github.com/newrelic/newrelic-browser-agent/issues/1425)) ([44786ae](https://github.com/newrelic/newrelic-browser-agent/commit/44786ae60d761b40a28f6df4b7b835c1791dda5f))
+* Handle duplicate agent APIs ([#1418](https://github.com/newrelic/newrelic-browser-agent/issues/1418)) ([f808447](https://github.com/newrelic/newrelic-browser-agent/commit/f8084474ea1a567a90d0615cdfeb13a8a2c1f110))
+* Reduce noise from `mousemove` events ([#1424](https://github.com/newrelic/newrelic-browser-agent/issues/1424)) ([7c02a02](https://github.com/newrelic/newrelic-browser-agent/commit/7c02a02763abdd2697e9ed1d5a89d81c251dcf67))
+
+
+### Bug Fixes
+
+* Get string className for SVG elements ([#1423](https://github.com/newrelic/newrelic-browser-agent/issues/1423)) ([0c1ce6c](https://github.com/newrelic/newrelic-browser-agent/commit/0c1ce6ca82bce15da12fe84fd91a7d6be8b4da44))
+* Patch `newrelic` event detail ([#1428](https://github.com/newrelic/newrelic-browser-agent/issues/1428)) ([8601424](https://github.com/newrelic/newrelic-browser-agent/commit/86014247ed45520adbbb053d94b6f11de48e239f))
+
+## [1.285.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.284.1...v1.285.0) (2025-03-18)
+
+
+### Features
+
+* Decorate harvest requests with ht (hasTrace) param ([#1409](https://github.com/newrelic/newrelic-browser-agent/issues/1409)) ([b8ed2b0](https://github.com/newrelic/newrelic-browser-agent/commit/b8ed2b0aeef8b8db651ddb8001171f28785c7673))
+* Inspection events ([#1413](https://github.com/newrelic/newrelic-browser-agent/issues/1413)) ([1832562](https://github.com/newrelic/newrelic-browser-agent/commit/1832562f52c1e2e26c49c2855ad1996d6251b803))
+
+
+### Bug Fixes
+
+* Logging mode on session update ([#1417](https://github.com/newrelic/newrelic-browser-agent/issues/1417)) ([3f59afe](https://github.com/newrelic/newrelic-browser-agent/commit/3f59afef8a53848d80f7f32d28302b6b0bcf7d2f))
+* Session Replay text masking for whitespace ([#1416](https://github.com/newrelic/newrelic-browser-agent/issues/1416)) ([97bf326](https://github.com/newrelic/newrelic-browser-agent/commit/97bf32655d6e608ea7248acc680d983b1d1e0eea))
+
 ## [1.284.1](https://github.com/newrelic/newrelic-browser-agent/compare/v1.284.0...v1.284.1) (2025-03-11)
 
 

package/README.md

@@ -1,5 +1,11 @@
 <a href="https://opensource.newrelic.com/oss-category/#community-plus"><picture><source media="(prefers-color-scheme: dark)" srcset="https://github.com/newrelic/opensource-website/raw/main/src/images/categories/dark/Community_Plus.png"><source media="(prefers-color-scheme: light)" srcset="https://github.com/newrelic/opensource-website/raw/main/src/images/categories/Community_Plus.png"><img alt="New Relic Open Source community plus project banner." src="https://github.com/newrelic/opensource-website/raw/main/src/images/categories/Community_Plus.png"></picture></a>
 
+### **Deployment status:**
+<img src="https://img.shields.io/endpoint?style=plastic&amp;url=https%3A%2F%2Fnewrelic.github.io%2Fnewrelic-browser-agent-release%2Fbadges%2Fcurrent-version-production.json">
+<img src="https://img.shields.io/endpoint?style=plastic&amp;url=https%3A%2F%2Fnewrelic.github.io%2Fnewrelic-browser-agent-release%2Fbadges%2Fcopy-paste-version-production.json">
+<img src="https://img.shields.io/endpoint?style=plastic&amp;url=https%3A%2F%2Fnewrelic.github.io%2Fnewrelic-browser-agent-release%2Fbadges%2Fgeneric-deploy-percent-production.json">
+
+
 # New Relic Browser Agent
 
 The New Relic browser agent instruments your web application or site and provides observability into performance, errors, and other behaviors.

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

package/dist/cjs/common/dom/selector-path.js

@@ -46,7 +46,7 @@ const generateSelectorPath = (elem, targetFields = []) => {
         localName
       } = elem;
       targetFields.forEach(field => {
-        nearestFields[nearestAttrName(field)] ||= elem[field];
+        nearestFields[nearestAttrName(field)] ||= elem[field]?.baseVal || elem[field];
       });
       const selector = [localName, id ? "#".concat(id) : '', pathSelector ? ">".concat(pathSelector) : ''].join('');
       pathSelector = selector;

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

@@ -18,6 +18,8 @@ var _encode = require("../url/encode");
 var _console = require("../util/console");
 var _stringify = require("../util/stringify");
 var _submitData = require("../util/submit-data");
+var _featureFlags = require("../util/feature-flags");
+var _globalEvent = require("../dispatch/global-event");
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -88,7 +90,8 @@ class Harvester {
         localOpts,
         submitMethod,
         cbFinished,
-        raw: aggregateInst.harvestOpts.raw
+        raw: aggregateInst.harvestOpts.raw,
+        featureName: aggregateInst.featureName
       });
       ranSend = true;
     });
@@ -130,7 +133,8 @@ function send(agentRef, {
   localOpts = {},
   submitMethod,
   cbFinished,
-  raw
+  raw,
+  featureName
 }) {
   if (!agentRef.info.errorBeacon) return false;
   let {
@@ -211,6 +215,22 @@ function send(agentRef, {
       });
     }
   }
+  (0, _globalEvent.dispatchGlobalEvent)({
+    agentIdentifier: agentRef.agentIdentifier,
+    drained: !!_featureFlags.activatedFeatures?.[agentRef.agentIdentifier],
+    type: 'data',
+    name: 'harvest',
+    feature: featureName,
+    data: {
+      endpoint,
+      headers,
+      targetApp,
+      payload,
+      submitMethod: getSubmitMethodName(),
+      raw,
+      synchronousXhr: !!(localOpts.isFinalHarvest && _runtime.isWorkerScope)
+    }
+  });
   return true;
   function shouldRetry(status) {
     switch (status) {
@@ -221,6 +241,11 @@ function send(agentRef, {
     }
     return status >= 502 && status <= 504 || status >= 512 && status <= 530;
   }
+  function getSubmitMethodName() {
+    if (submitMethod === _submitData.xhr) return 'xhr';
+    if (submitMethod === _submitData.xhrFetch) return 'fetch';
+    return 'beacon';
+  }
 }
 
 /**
@@ -252,12 +277,14 @@ function cleanPayload(payload = {}) {
 function baseQueryString(agentRef, qs, endpoint, applicationID) {
   const ref = agentRef.runtime.obfuscator.obfuscateString((0, _cleanUrl.cleanURL)('' + _runtime.globalScope.location));
   const hr = agentRef.runtime.session?.state.sessionReplayMode === 1 && endpoint !== _features.JSERRORS;
+  const ht = agentRef.runtime.session?.state.sessionTraceMode === 1 && ![_features.LOGS, _features.BLOBS].includes(endpoint);
   const qps = ['a=' + applicationID, (0, _encode.param)('sa', agentRef.info.sa ? '' + agentRef.info.sa : ''), (0, _encode.param)('v', _env.VERSION), transactionNameParam(), (0, _encode.param)('ct', agentRef.runtime.customTransaction), '&rst=' + (0, _now.now)(), '&ck=0',
   // ck param DEPRECATED - still expected by backend
   '&s=' + (agentRef.runtime.session?.state.value || '0'),
   // the 0 id encaps all untrackable and default traffic
   (0, _encode.param)('ref', ref), (0, _encode.param)('ptid', agentRef.runtime.ptid ? '' + agentRef.runtime.ptid : '')];
   if (hr) qps.push((0, _encode.param)('hr', '1', qs));
+  if (ht) qps.push((0, _encode.param)('ht', '1', qs));
   return qps.join('');
 
   // Constructs the transaction name param for the beacon URL.

package/dist/cjs/common/util/feature-flags.js

@@ -33,8 +33,14 @@ function activateFeatures(flags, agentIdentifier) {
   activatedFeatures[agentIdentifier] = flags;
   sentIds.add(agentIdentifier);
 
-  // let any window level subscribers know that the agent is running
+  // let any window level subscribers know that the agent is running, per install docs
   (0, _globalEvent.dispatchGlobalEvent)({
-    loaded: true
+    agentIdentifier,
+    loaded: true,
+    drained: true,
+    type: 'lifecycle',
+    name: 'load',
+    feature: undefined,
+    data: flags
   });
 }

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

@@ -33,7 +33,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     });
     this.ee.on(_constants2.SESSION_EVENTS.UPDATE, (type, data) => {
       if (this.blocked || type !== _constants2.SESSION_EVENT_TYPES.CROSS_TAB) return;
-      if (this.mode !== _constants.LOGGING_MODE.OFF && data.loggingMode === _constants.LOGGING_MODE.OFF) this.abort(_constants3.ABORT_REASONS.CROSS_TAB);else this.mode = data.loggingMode;
+      if (this.loggingMode !== _constants.LOGGING_MODE.OFF && data.loggingMode === _constants.LOGGING_MODE.OFF) this.abort(_constants3.ABORT_REASONS.CROSS_TAB);else this.loggingMode = data.loggingMode;
     });
     this.harvestOpts.raw = true;
     this.waitForFlags(['log']).then(([loggingMode]) => {

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

@@ -16,6 +16,8 @@ var _features = require("../../../loaders/features/features");
 var _utils = require("./utils");
 var _agentConstants = require("../../../common/constants/agent-constants");
 var _aggregateBase = require("../../utils/aggregate-base");
+var _console = require("../../../common/util/console");
+var _invoke = require("../../../common/util/invoke");
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -30,6 +32,8 @@ class Recorder {
   #preloaded;
   /** flag that if true, blocks events from being "stored".  Only set to true when a full snapshot has incomplete nodes (only stylesheets ATM) */
   #fixing = false;
+  #warnCSSOnce = (0, _invoke.single)(() => (0, _console.warn)(47)); // notifies user of potential replayer issue if fix_stylesheets is off
+
   constructor(parent) {
     this.#events = new _recorderEvents.RecorderEvents();
     this.#backloggedEvents = new _recorderEvents.RecorderEvents();
@@ -90,14 +94,7 @@ class Recorder {
       inline_images,
       collect_fonts
     } = this.parent.agentRef.init.session_replay;
-    const customMasker = (text, element) => {
-      try {
-        if (typeof element?.type === 'string' && element.type.toLowerCase() !== 'password' && (element?.dataset?.nrUnmask !== undefined || element?.classList?.contains('nr-unmask'))) return text;
-      } catch (err) {
-        // likely an element was passed to this handler that was invalid and was missing attributes or methods
-      }
-      return '*'.repeat(text?.length || 0);
-    };
+
     // 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 = (0, _rrweb.record)({
@@ -108,9 +105,9 @@ class Recorder {
       blockSelector: block_selector,
       maskInputOptions: mask_input_options,
       maskTextSelector: mask_text_selector,
-      maskTextFn: customMasker,
+      maskTextFn: _utils.customMasker,
       maskAllInputs: mask_all_inputs,
-      maskInputFn: customMasker,
+      maskInputFn: _utils.customMasker,
       inlineStylesheet: true,
       inlineImages: inline_images,
       collectFonts: collect_fonts,
@@ -138,6 +135,7 @@ class Recorder {
     if (!this.shouldFix) {
       if (incompletes > 0) {
         this.currentBufferTarget.inlinedAllStylesheets = false;
+        this.#warnCSSOnce();
         (0, _handle.handle)(_constants3.SUPPORTABILITY_METRIC_CHANNEL, [missingInlineSMTag + 'Skipped', incompletes], undefined, _features.FEATURE_NAMES.metrics, this.parent.ee);
       }
       return this.store(event, isCheckout);

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

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.buildNRMetaNode = buildNRMetaNode;
+exports.customMasker = customMasker;
 exports.hasReplayPrerequisite = hasReplayPrerequisite;
 exports.isPreloadAllowed = isPreloadAllowed;
 var _nreum = require("../../../common/window/nreum");
@@ -35,4 +36,15 @@ function buildNRMetaNode(timestamp, timeKeeper) {
     correctedOriginTime: timeKeeper.correctedOriginTime,
     originTimeDiff: Math.floor(_runtime.originTime - timeKeeper.correctedOriginTime)
   };
+}
+function customMasker(text, element) {
+  try {
+    if (typeof element?.type === 'string') {
+      if (element.type.toLowerCase() === 'password') return '*'.repeat(text?.length || 0);
+      if (element?.dataset?.nrUnmask !== undefined || element?.classList?.contains('nr-unmask')) return text;
+    }
+  } catch (err) {
+    // likely an element was passed to this handler that was invalid and was missing attributes or methods
+  }
+  return typeof text === 'string' ? text.replace(/[\S]/g, '*') : '*'.repeat(text?.length || 0);
 }

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

@@ -22,7 +22,8 @@ const ignoredEvents = {
   // we find that certain events make the data too noisy to be useful
   global: {
     mouseup: true,
-    mousedown: true
+    mousedown: true,
+    mousemove: true
   },
   // certain events are present both in the window and in PVT metrics.  PVT metrics are prefered so the window events should be ignored
   window: {
@@ -184,8 +185,8 @@ class TraceStorage {
     this.storeSTN(evt);
   }
   shouldIgnoreEvent(event, target) {
-    const origin = (0, _eventOrigin.eventOrigin)(event.target, target, this.parent.ee);
     if (event.type in ignoredEvents.global) return true;
+    const origin = (0, _eventOrigin.eventOrigin)(event.target, target, this.parent.ee);
     if (!!ignoredEvents[origin] && ignoredEvents[origin].ignoreAll) return true;
     return !!(!!ignoredEvents[origin] && event.type in ignoredEvents[origin]);
   }

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

@@ -43,7 +43,7 @@ class AggregateBase extends _featureBase.FeatureBase {
       This was necessary to prevent race cond. issues where the event buffer was checked before the feature could "block" itself.
       Its easier to just keep an empty event buffer in place. */
       default:
-        this.events = new _eventStoreManager.EventStoreManager(agentRef.mainAppKey, 1);
+        this.events = new _eventStoreManager.EventStoreManager(agentRef.mainAppKey, 1, agentRef.agentIdentifier, this.featureName);
         break;
     }
     this.harvestOpts = {}; // features aggregate classes can define custom opts for when their harvest is called
@@ -145,16 +145,14 @@ class AggregateBase extends _featureBase.FeatureBase {
       } catch (err) {
         // do nothing
       }
-      (0, _configure.configure)({
-        agentIdentifier: this.agentIdentifier
-      }, {
+      (0, _configure.configure)(existingAgent, {
         ...cdn,
         info: {
           ...cdn.info,
           jsAttributes
         },
         runtime: existingAgent.runtime
-      });
+      }, existingAgent.runtime.loaderType);
     }
   }
 
@@ -170,7 +168,7 @@ class AggregateBase extends _featureBase.FeatureBase {
       appId: agentRef.info.applicationID
     };
     // Create a single Aggregator for this agent if DNE yet; to be used by jserror endpoint features.
-    if (!agentRef.sharedAggregator) agentRef.sharedAggregator = new _eventStoreManager.EventStoreManager(agentRef.mainAppKey, 2);
+    if (!agentRef.sharedAggregator) agentRef.sharedAggregator = new _eventStoreManager.EventStoreManager(agentRef.mainAppKey, 2, agentRef.agentIdentifier, 'shared_aggregator');
     if (!agentRef.runtime.harvester) agentRef.runtime.harvester = new _harvester.Harvester(agentRef);
   }
 

package/dist/cjs/features/utils/event-store-manager.js

@@ -5,6 +5,8 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.EventStoreManager = void 0;
 var _eventAggregator = require("../../common/aggregate/event-aggregator");
+var _globalEvent = require("../../common/dispatch/global-event");
+var _featureFlags = require("../../common/util/feature-flags");
 var _eventBuffer = require("./event-buffer");
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
@@ -19,12 +21,16 @@ class EventStoreManager {
   /**
    * @param {object} defaultTarget - should contain licenseKey and appId of the main app from NREUM.info at startup
    * @param {1|2} storageChoice - the type of storage to use in this manager; 'EventBuffer' (1), 'EventAggregator' (2)
+   * @param {string} agentIdentifier - agent identifier used in inspection events
+   * @param {string} featureName - feature name used in inspection events for non-shared aggregators
    */
-  constructor(defaultTarget, storageChoice) {
+  constructor(defaultTarget, storageChoice, agentIdentifier, featureName) {
     this.mainApp = defaultTarget;
     this.StorageClass = storageChoice === 1 ? _eventBuffer.EventBuffer : _eventAggregator.EventAggregator;
     this.appStorageMap = new Map();
     this.appStorageMap.set(defaultTarget, new this.StorageClass());
+    this.agentIdentifier = agentIdentifier;
+    this.featureName = featureName;
   }
 
   // This class must contain an union of all methods from all supported storage classes and conceptualize away the target app argument.
@@ -50,6 +56,14 @@ class EventStoreManager {
    * @returns {boolean} True if the event was successfully added
    */
   add(event, target) {
+    (0, _globalEvent.dispatchGlobalEvent)({
+      agentIdentifier: this.agentIdentifier,
+      drained: !!_featureFlags.activatedFeatures?.[this.agentIdentifier],
+      type: 'data',
+      name: 'buffer',
+      feature: this.featureName,
+      data: event
+    });
     if (target && !this.appStorageMap.has(target)) this.appStorageMap.set(target, new this.StorageClass());
     return this.appStorageMap.get(target || this.mainApp).add(event);
   }

package/dist/cjs/features/utils/nr1-debugger.js

@@ -13,7 +13,7 @@ var _nreum = require("../../common/window/nreum");
 const debugId = 1;
 const newrelic = (0, _nreum.gosCDN)();
 function debugNR1(agentIdentifier, location, event, otherprops = {}, debugName = 'SR') {
-  const api = agentIdentifier ? newrelic.initializedAgents[agentIdentifier].api.addPageAction : newrelic.addPageAction;
+  const api = agentIdentifier ? newrelic.initializedAgents[agentIdentifier].addPageAction : newrelic.addPageAction;
   let url;
   try {
     const locURL = new URL(window.location);

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

@@ -25,7 +25,7 @@ class AgentBase extends _microAgentBase.MicroAgentBase {
    * @param  {...any} args
    */
   #callMethod(methodName, ...args) {
-    if (typeof this.api?.[methodName] !== 'function') (0, _console.warn)(35, methodName);else return this.api[methodName](...args);
+    if (this[methodName] === AgentBase.prototype[methodName] || this[methodName] === _microAgentBase.MicroAgentBase.prototype[methodName]) (0, _console.warn)(35, methodName);else return this[methodName](...args);
   }
 
   /**

package/dist/cjs/loaders/agent.js

@@ -76,6 +76,9 @@ class Agent extends _agentBase.AgentBase {
       runtime: this.runtime
     };
   }
+  get api() {
+    return this;
+  }
   run() {
     // Attempt to initialize all the requested features (sequentially in prio order & synchronously), with any failure aborting the whole process.
     try {
@@ -103,7 +106,6 @@ class Agent extends _agentBase.AgentBase {
         this.features[featName].abortHandler?.();
       }
       const newrelic = (0, _nreum.gosNREUM)();
-      delete newrelic.initializedAgents[this.agentIdentifier]?.api; // prevent further calls to agent-specific APIs (see "configure.js")
       delete newrelic.initializedAgents[this.agentIdentifier]?.features; // GC mem used internally by features
       delete this.sharedAggregator;
       // Keep the initialized agent object with its configs for troubleshooting purposes.