@newrelic/browser-agent 1.282.0 → 1.283.0

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.283.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.282.0...v1.283.0) (2025-02-18)
+
+
+### Features
+
+* Add auto-logging feature ([#1274](https://github.com/newrelic/newrelic-browser-agent/issues/1274)) ([91204ae](https://github.com/newrelic/newrelic-browser-agent/commit/91204ae0099508d13c944be06ed6c46dce901ce3))
+* Add global custom attributes to log data ([#1343](https://github.com/newrelic/newrelic-browser-agent/issues/1343)) ([dc7d27c](https://github.com/newrelic/newrelic-browser-agent/commit/dc7d27c718c13a54bce5cc1fa6b0260b95008637))
+
 ## [1.282.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.281.0...v1.282.0) (2025-02-13)
 
 

package/README.md

@@ -88,6 +88,23 @@ The following features may be disabled by adding `init` entries as shown above.
 
 See the [New Relic documentation site](https://docs.newrelic.com/docs/browser/browser-monitoring/getting-started/introduction-browser-monitoring/) for information on the above features.
 
+## Options Parameter
+
+The `options` parameter used, or passed in, when instantiating the `BrowserAgent` class can include the following arguments:
+
+| Argument       | Type     | Description                                                                 |
+|----------------|----------|-----------------------------------------------------------------------------|
+| `info`         | Object   | Operational information for the agent. `applicationID` and `licenseKey` properties are strictly required to be defined inside of this. Some properties may be provided by APM-injection installation. See model object in [info.js](src/common/config/info.js). |
+| `init`         | Object   | (Optional) Initialization settings for the agent, including feature toggles. This controls many parts of the agent's behavior and that of its features. It's recommended to understand each config being changed before doing so. See the object returned by `model()` in [init.js](src/common/config/init.js). |
+| `loader_config`| Object   | (Optional) Agent installed via APM-injection is provided this object by the APM agent. It's highly recommended to leave this alone. Defaults to model object in [loader-config.js](src/common/config/loader-config.js). |
+| `runtime`      | Object   | (Optional) Used by the agent to store shared references or info at runtime. It's highly recommended to leave this alone. Defaults to model object in [runtime.js](src/common/config/runtime.js). |
+| `exposed`      | Boolean  | (Optional) Affects whether the `newrelic` API includes or acts on this agent. If set to false, for example, `newrelic.setCustomAttribute()` would not affect this agent instance. Defaults to true. |
+
+The underlying `Agent` class `options` parameter also includes the following _additional_ arguments, as shown in the next section:
+
+| Argument       | Type     | Description                                                                 |
+|----------------|----------|-----------------------------------------------------------------------------|
+| `features`     | Array    | List of feature classes to be used by the agent. This determines what features _can_ actually be enabled and affects your bundler build size of the agent. `PageViewEvent` is forcibly included, even if it's not in this array or an empty array is passed in. |
 
 ## Composing a custom agent with selected feature modules
 

package/dist/cjs/common/config/info.js

@@ -13,6 +13,27 @@ var _configurable = require("./configurable");
  * SPDX-License-Identifier: Apache-2.0
  */
 
+/**
+ * @typedef {Object} Info
+ * @property {string} [beacon]
+ * @property {string} [errorBeacon] - Base URL endpoint for all data harvested by the agent. Proxies should be defined in the init instead.
+ * @property {string} licenseKey - New Relic license key provided by the website in user account.
+ * @property {string} applicationID - New Relic application ID provided when creating a browser entity in the UI.
+ * @property {number} [sa]
+ * @property {number} [queueTime]
+ * @property {number} [applicationTime]
+ * @property {string} [ttGuid]
+ * @property {string} [user]
+ * @property {string} [account]
+ * @property {string} [product]
+ * @property {string} [extra]
+ * @property {Object} [jsAttributes] - Custom attributes that are added to majority of agent's payloads. The `setCustomAttribute` API method affects this.
+ * @property {string} [userAttributes]
+ * @property {string} [atts]
+ * @property {string} [transactionName]
+ * @property {string} [tNamePlain]
+ */
+
 const model = {
   // preset defaults
   beacon: _nreum.defaults.beacon,

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

@@ -7,9 +7,8 @@ exports.getConfiguration = getConfiguration;
 exports.getConfigurationValue = getConfigurationValue;
 exports.setConfiguration = setConfiguration;
 var _constants = require("../../features/generic_events/constants");
-var _constants2 = require("../../features/logging/constants");
 var _querySelector = require("../dom/query-selector");
-var _constants3 = require("../session/constants");
+var _constants2 = require("../session/constants");
 var _console = require("../util/console");
 var _nreum = require("../window/nreum");
 var _configurable = require("./configurable");
@@ -18,6 +17,88 @@ var _configurable = require("./configurable");
  * SPDX-License-Identifier: Apache-2.0
  */
 
+/**
+ * @typedef {Object} Init
+ * @property {Object} [ajax]
+ * @property {Array<string>} [ajax.deny_list] - List of domain URLs to be excluded from AjaxRequest collection.
+ * @property {boolean} [ajax.block_internal] - If true, agent requests going to harvest endpoint are treated as on deny list. In other words, agent will not self-report AJAX.
+ * @property {boolean} [ajax.enabled] - Turn on/off the ajax feature (on by default).
+ * @property {boolean} [ajax.autoStart] - If true, the agent will automatically start the ajax feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [distributed_tracing]
+ * @property {boolean} [distributed_tracing.enabled] - If true, distributed tracing headers will be added to outgoing requests. Requires ajax feature to be running.
+ * @property {boolean} [distributed_tracing.exclude_newrelic_header]
+ * @property {boolean} [distributed_tracing.cors_use_newrelic_header]
+ * @property {boolean} [distributed_tracing.cors_use_tracecontext_headers]
+ * @property {Array<string>} [distributed_tracing.allowed_origins]
+ * @property {Array<string>} [feature_flags] - An array of feature flags to enable experimental features.
+ * @property {Object} [generic_events]
+ * @property {boolean} [generic_events.enabled] - Turn on/off the generic events feature (on by default). This is required for `PageAction`, `UserAction`, and `BrowserPerformance` events.
+ * @property {boolean} [generic_events.autoStart] - If true, the agent will automatically start the generic events feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [harvest]
+ * @property {number} [harvest.interval] - The interval in seconds at which the agent will send out data. It's not recommended to change this value.
+ * @property {Object} [jserrors]
+ * @property {boolean} [jserrors.enabled] - Turn on/off the jserrors feature (on by default).
+ * @property {boolean} [jserrors.autoStart] - If true, the agent will automatically start the jserrors feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [logging]
+ * @property {boolean} [logging.enabled] - Turn on/off the logging feature (on by default).
+ * @property {boolean} [logging.autoStart] - If true, the agent will automatically start the logging feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [metrics]
+ * @property {boolean} [metrics.enabled] - Turn on/off the metrics feature (on by default).
+ * @property {boolean} [metrics.autoStart] - If true, the agent will automatically start the metrics feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Array<Object>} [obfuscate] - Array of regexp and corresponding replacement patterns for obfuscating data.
+ * @property {Object} [page_action]
+ * @property {boolean} [page_action.enabled] - Must be true to allow PageAction events to be captured.
+ * @property {Object} [page_view_event]
+ * @property {boolean} [page_view_event.enabled] - This setting is ignored! PageViewEvent is always enabled by force.
+ * @property {boolean} [page_view_event.autoStart] - If true, the agent will automatically send the RUM request. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [page_view_timing]
+ * @property {boolean} [page_view_timing.enabled] - Turn on/off the page view timing feature (on by default).
+ * @property {boolean} [page_view_timing.autoStart] - If true, the agent will automatically start the page view timing feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [performance]
+ * @property {boolean} [performance.capture_marks] - If true, the agent will capture PerformanceMark events.
+ * @property {boolean} [performance.capture_measures] - If true, the agent will capture PerformanceMeasure events.
+ * @property {boolean} [performance.capture_detail] - If true, `BrowserPerformance` events from marks and measures will include, as attribute(s), the `detail` metadata provided to `markOptions` and `measureOptions`.
+ * @property {Object} [performance.resources]
+ * @property {boolean} [performance.resources.enabled] - If true, the agent will capture PerformanceResourceTiming entries.
+ * @property {Array<string>} [performance.resources.asset_types] - Array of `initiatorType` strings to filter the desired ResourceTiming entries. By default, all resource types are captured.
+ * @property {Array<string>} [performance.resources.first_party_domains] - Each resource URL will be checked against this list to determine if it should be labeled "first party" in the resulting `BrowserPerformance` event.
+ * @property {boolean} [performance.resources.ignore_newrelic] - When true (default), resource entries associated with New Relic domains will be ignored.
+ * @property {Object} [privacy]
+ * @property {boolean} [privacy.cookies_enabled] - If true (default), session tracking of users across page loads is enabled in the agent. This is required for session trace, replay, and session-related features.
+ * @property {Object} [proxy]
+ * @property {string} [proxy.assets] - Set value will be used to overwrite the webpack asset path used to fetch agent assets.
+ * @property {string} [proxy.beacon] - Set value will be used to overwrite the endpoint URL to which we send analytics.
+ * @property {Object} [session]
+ * @property {number} [session.expiresMs] - When session tracking is on, this determines how long a session will last before expiring. Modifying this value is not recommended.
+ * @property {number} [session.inactiveMs] - When session tracking is on, this determines how long a session will last without user activity before expiring. Modifying this value is not recommended.
+ * @property {Object} [session_replay]
+ * @property {boolean} [session_replay.autoStart] - If true, the agent will automatically start the session replay feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {boolean} [session_replay.enabled] - Turn on/off the session replay feature (off by default).
+ * @property {boolean} [session_replay.preload] - If true, allow the agent to run rrweb recorder immediately instead of waiting until after the window.load event, for new sessions. Existing sessions ignore this setting.
+ * @property {number} [session_replay.sampling_rate] - This setting is deprecated and ineffective. Sampling is controlled in New Relic by server-side configuration.
+ * @property {number} [session_replay.error_sampling_rate] - This setting is deprecated and ineffective.
+ * @property {boolean} [session_replay.collect_fonts] - When true, serialize fonts for collection without public asset url. This is currently broken -- https://github.com/rrweb-io/rrweb/issues/1304.
+ * @property {boolean} [session_replay.inline_images] - When true, serialize images for collection without public asset url. Not recommended for use. This is currently for TESTING as it easily generates payloads too large to be harvested.
+ * @property {boolean} [session_replay.fix_stylesheets] - When true, tries to fetch any missing stylesheets again to inline in replayer.
+ * @property {boolean} [session_replay.mask_all_inputs] - If true, all input content will be masked with asterisks.
+ * @property {string} [session_replay.mask_text_selector] - Set value should be in CSS selector syntax and is used to identify matching elements to mask.
+ * @property {string} [session_replay.block_selector] - Set value should be in CSS selector syntax and is used to identify matching elements to block.
+ * @property {Object} [session_replay.mask_input_options] - If mask_all_inputs is not true, this object will be used to select what input to mask. Passwords are forcibly always masked.
+ * @property {Object} [session_trace]
+ * @property {boolean} [session_trace.enabled] - Turn on/off the session trace feature (on by default).
+ * @property {boolean} [session_trace.autoStart] - If true, the agent will automatically start the session trace feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [soft_navigations]
+ * @property {boolean} [soft_navigations.enabled] - Turn on/off the soft navigations feature (on by default).
+ * @property {boolean} [soft_navigations.autoStart] - If true, the agent will automatically start the soft navigations feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [spa]
+ * @property {boolean} [spa.enabled] - Turn on/off the single page application feature (on by default). NOTE: the SPA feature is deprecated and under removal procedure.
+ * @property {boolean} [spa.autoStart] - If true, the agent will automatically start the single page application feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {boolean} [ssl] - If explicitly false, the agent will use HTTP instead of HTTPS. This setting should NOT be used.
+ * @property {Object} [user_actions]
+ * @property {boolean} [user_actions.enabled] - Must be true to allow UserAction events to be captured.
+ * @property {Array<string>} [user_actions.elementAttributes] - List of HTML Element properties to be captured with UserAction events' target elements. This may help to identify the source element being interacted with in the UI.
+ */
+
 const nrMask = '[data-nr-mask]';
 const model = () => {
   const hiddenState = {
@@ -82,8 +163,7 @@ const model = () => {
     },
     logging: {
       enabled: true,
-      autoStart: true,
-      level: _constants2.LOG_LEVELS.INFO
+      autoStart: true
     },
     metrics: {
       enabled: true,
@@ -116,7 +196,6 @@ const model = () => {
       },
       capture_detail: true,
       resources: {
-        // whether to run this subfeature or not in the generic_events feature. false by default through experimental phase, but flipped to true once GA'd
         get enabled() {
           return hiddenState.feature_flags.includes(_constants.FEATURE_FLAGS.RESOURCES) || hiddenState.experimental.resources;
         },
@@ -124,41 +203,30 @@ const model = () => {
           hiddenState.experimental.resources = val;
         },
         asset_types: [],
-        // MDN types to collect, empty array will collect all types
         first_party_domains: [],
-        // when included, will decorate the resource as first party if matching
-        ignore_newrelic: true // ignore capturing internal agent scripts and harvest calls
+        ignore_newrelic: true
       }
     },
     privacy: {
       cookies_enabled: true
     },
-    // *cli - per discussion, default should be true
     proxy: {
       assets: undefined,
-      // if this value is set, it will be used to overwrite the webpack asset path used to fetch assets
-      beacon: undefined // likewise for the url to which we send analytics
+      beacon: undefined
     },
     session: {
-      expiresMs: _constants3.DEFAULT_EXPIRES_MS,
-      inactiveMs: _constants3.DEFAULT_INACTIVE_MS
+      expiresMs: _constants2.DEFAULT_EXPIRES_MS,
+      inactiveMs: _constants2.DEFAULT_INACTIVE_MS
     },
     session_replay: {
-      // feature settings
       autoStart: true,
       enabled: false,
       preload: false,
-      // if true, enables the agent to load rrweb immediately instead of waiting to do so after the window.load event
       sampling_rate: 10,
-      // float from 0 - 100
       error_sampling_rate: 100,
-      // float from 0 - 100
       collect_fonts: false,
-      // serialize fonts for collection without public asset url, this is currently broken in RRWeb -- https://github.com/rrweb-io/rrweb/issues/1304.  When fixed, revisit with test cases
       inline_images: false,
-      // serialize images for collection without public asset url -- right now this is only useful for testing as it easily generates payloads too large to be harvested
       fix_stylesheets: true,
-      // fetch missing stylesheet resources for inlining
       // recording config settings
       mask_all_inputs: true,
       // this has a getter/setter to facilitate validation of the selectors

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

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

@@ -18,6 +18,7 @@ var _handle = require("../event-emitter/handle");
 var _constants2 = require("../../features/metrics/constants");
 var _features = require("../../loaders/features/features");
 var _eventListenerOpts = require("../event-listener/event-listener-opts");
+var _constants3 = require("../../features/logging/constants");
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -34,6 +35,7 @@ const model = {
   sessionReplaySentFirstChunk: false,
   sessionTraceMode: _constants.MODE.OFF,
   traceHarvestStarted: false,
+  loggingMode: _constants3.LOGGING_MODE.OFF,
   serverTimeDiff: null,
   // set by TimeKeeper; "undefined" value will not be stringified and stored but "null" will
   custom: {}

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

@@ -16,6 +16,9 @@ var _utils = require("../shared/utils");
 var _traverse = require("../../../common/util/traverse");
 var _agentConstants = require("../../../common/constants/agent-constants");
 var _features = require("../../../loaders/features/features");
+var _constants3 = require("../../../common/session/constants");
+var _constants4 = require("../../session_replay/constants");
+var _featureGates = require("../../utils/feature-gates");
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -25,8 +28,30 @@ class Aggregate extends _aggregateBase.AggregateBase {
   static featureName = _constants2.FEATURE_NAME;
   constructor(agentRef) {
     super(agentRef, _constants2.FEATURE_NAME);
+    this.isSessionTrackingEnabled = (0, _featureGates.canEnableSessionTracking)(this.agentIdentifier) && this.agentRef.runtime.session;
+
+    // The SessionEntity class can emit a message indicating the session was cleared and reset (expiry, inactivity). This feature must abort and never resume if that occurs.
+    this.ee.on(_constants3.SESSION_EVENTS.RESET, () => {
+      this.abort(_constants4.ABORT_REASONS.RESET);
+    });
+    this.ee.on(_constants3.SESSION_EVENTS.UPDATE, (type, data) => {
+      if (this.blocked || type !== _constants3.SESSION_EVENT_TYPES.CROSS_TAB) return;
+      if (this.mode !== _constants2.LOGGING_MODE.OFF && data.loggingMode === _constants2.LOGGING_MODE.OFF) this.abort(_constants4.ABORT_REASONS.CROSS_TAB);else this.mode = data.loggingMode;
+    });
     this.harvestOpts.raw = true;
-    this.waitForFlags([]).then(() => {
+    this.waitForFlags(['log']).then(([loggingMode]) => {
+      const session = this.agentRef.runtime.session ?? {};
+      if (this.loggingMode === _constants2.LOGGING_MODE.OFF || session.isNew && loggingMode === _constants2.LOGGING_MODE.OFF) {
+        this.blocked = true;
+        this.deregisterDrain();
+        return;
+      }
+      if (session.isNew || !this.isSessionTrackingEnabled) {
+        this.updateLoggingMode(loggingMode);
+      } else {
+        this.loggingMode = session.state.loggingMode;
+      }
+
       /** emitted by instrument class (wrapped loggers) or the api methods directly */
       (0, _registerHandler.registerHandler)(_constants2.LOGGING_EVENT_EMITTER_CHANNEL, this.handleLog.bind(this), this.featureName, this.ee);
       this.drain();
@@ -34,11 +59,18 @@ class Aggregate extends _aggregateBase.AggregateBase {
       agentRef.runtime.harvester.triggerHarvestFor(this);
     });
   }
+  updateLoggingMode(loggingMode) {
+    this.loggingMode = loggingMode;
+    this.syncWithSessionManager({
+      loggingMode: this.loggingMode
+    });
+  }
   handleLog(timestamp, message, attributes = {}, level = _constants2.LOG_LEVELS.INFO) {
-    if (this.blocked) return;
+    if (this.blocked || !this.loggingMode) return;
     if (!attributes || typeof attributes !== 'object') attributes = {};
     if (typeof level === 'string') level = level.toUpperCase();
     if (!(0, _utils.isValidLogLevel)(level)) return (0, _console.warn)(30, level);
+    if (this.loggingMode < (_constants2.LOGGING_MODE[level] || Infinity)) return;
     try {
       if (typeof message !== 'string') {
         const stringified = (0, _stringify.stringify)(message);
@@ -100,7 +132,9 @@ class Aggregate extends _aggregateBase.AggregateBase {
           // The following 3 attributes are evaluated and dropped at ingest processing time and do not get stored on NRDB:
           'instrumentation.provider': 'browser',
           'instrumentation.version': this.agentRef.runtime.version,
-          'instrumentation.name': this.agentRef.runtime.loaderType
+          'instrumentation.name': this.agentRef.runtime.loaderType,
+          // Custom attributes
+          ...this.agentRef.info.jsAttributes
         }
       },
       /** logs section contains individual unique log entries */
@@ -112,5 +146,20 @@ class Aggregate extends _aggregateBase.AggregateBase {
       browser_monitoring_key: this.agentRef.info.licenseKey
     };
   }
+
+  /** Abort the feature, once aborted it will not resume */
+  abort(reason = {}) {
+    (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ["Logging/Abort/".concat(reason.sm)], undefined, _features.FEATURE_NAMES.logging, this.ee);
+    this.blocked = true;
+    this.events.clear();
+    this.events.clearSave();
+    this.updateLoggingMode(_constants2.LOGGING_MODE.OFF);
+    this.deregisterDrain();
+  }
+  syncWithSessionManager(state = {}) {
+    if (this.isSessionTrackingEnabled) {
+      this.agentRef.runtime.session.write(state);
+    }
+  }
 }
 exports.Aggregate = Aggregate;

package/dist/cjs/features/logging/constants.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.LOG_LEVELS = exports.LOGGING_EVENT_EMITTER_CHANNEL = exports.FEATURE_NAME = void 0;
+exports.LOG_LEVELS = exports.LOGGING_MODE = exports.LOGGING_EVENT_EMITTER_CHANNEL = exports.FEATURE_NAME = void 0;
 var _features = require("../../loaders/features/features");
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
@@ -17,5 +17,13 @@ const LOG_LEVELS = exports.LOG_LEVELS = {
   DEBUG: 'DEBUG',
   TRACE: 'TRACE'
 };
+const LOGGING_MODE = exports.LOGGING_MODE = {
+  OFF: 0,
+  ERROR: 1,
+  WARN: 2,
+  INFO: 3,
+  DEBUG: 4,
+  TRACE: 5
+};
 const LOGGING_EVENT_EMITTER_CHANNEL = exports.LOGGING_EVENT_EMITTER_CHANNEL = 'log';
 const FEATURE_NAME = exports.FEATURE_NAME = _features.FEATURE_NAMES.logging;

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

@@ -7,6 +7,8 @@ exports.Logging = exports.Instrument = void 0;
 var _instrumentBase = require("../../utils/instrument-base");
 var _constants = require("../constants");
 var _utils = require("../shared/utils");
+var _wrapLogger = require("../../../common/wrap/wrap-logger");
+var _runtime = require("../../../common/constants/runtime");
 /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -17,6 +19,24 @@ class Instrument extends _instrumentBase.InstrumentBase {
   constructor(agentRef, auto = true) {
     super(agentRef, _constants.FEATURE_NAME, auto);
     const instanceEE = this.ee;
+    (0, _wrapLogger.wrapLogger)(instanceEE, _runtime.globalScope.console, 'log', {
+      level: 'info'
+    });
+    (0, _wrapLogger.wrapLogger)(instanceEE, _runtime.globalScope.console, 'error', {
+      level: 'error'
+    });
+    (0, _wrapLogger.wrapLogger)(instanceEE, _runtime.globalScope.console, 'warn', {
+      level: 'warn'
+    });
+    (0, _wrapLogger.wrapLogger)(instanceEE, _runtime.globalScope.console, 'info', {
+      level: 'info'
+    });
+    (0, _wrapLogger.wrapLogger)(instanceEE, _runtime.globalScope.console, 'debug', {
+      level: 'debug'
+    });
+    (0, _wrapLogger.wrapLogger)(instanceEE, _runtime.globalScope.console, 'trace', {
+      level: 'trace'
+    });
     /** emitted by wrap-logger function */
     this.ee.on('wrap-logger-end', function handleLog([message]) {
       const {

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

@@ -22,6 +22,7 @@ var _now = require("../../../common/timing/now");
 var _utils = require("../shared/utils");
 var _agentConstants = require("../../../common/constants/agent-constants");
 var _cleanUrl = require("../../../common/url/clean-url");
+var _featureGates = require("../../utils/feature-gates");
 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); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; } /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
@@ -52,6 +53,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     this.recorder = args?.recorder;
     this.errorNoticed = args?.errorNoticed || false;
     this.harvestOpts.raw = true;
+    this.isSessionTrackingEnabled = (0, _featureGates.canEnableSessionTracking)(this.agentIdentifier) && this.agentRef.runtime.session;
     (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, ['Config/SessionReplay/Enabled'], undefined, _features.FEATURE_NAMES.metrics, this.ee);
 
     // The SessionEntity class can emit a message indicating the session was cleared and reset (expiry, inactivity). This feature must abort and never resume if that occurs.
@@ -74,7 +76,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     this.ee.on(_constants3.SESSION_EVENTS.UPDATE, (type, data) => {
       if (!this.recorder || !this.initialized || this.blocked || type !== _constants3.SESSION_EVENT_TYPES.CROSS_TAB) return;
       if (this.mode !== _constants3.MODE.OFF && data.sessionReplayMode === _constants3.MODE.OFF) this.abort(_constants.ABORT_REASONS.CROSS_TAB);
-      this.mode = data.sessionReplay;
+      this.mode = data.sessionReplayMode;
     });
     (0, _registerHandler.registerHandler)(_constants.SR_EVENT_EMITTER_TYPES.PAUSE, () => {
       this.forceStop(this.mode === _constants3.MODE.FULL);
@@ -148,7 +150,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
 
   /**
    * Evaluate entitlements and sampling before starting feature mechanics, importing and configuring recording library, and setting storage state
-   * @param {boolean} entitlements - the true/false state of the "sr" flag from RUM response
+   * @param {boolean} srMode - the true/false state of the "sr" flag (aka. entitlements) from RUM response
    * @param {boolean} ignoreSession - whether to force the method to ignore the session state and use just the sample flags
    * @returns {void}
    */
@@ -396,7 +398,9 @@ class Aggregate extends _aggregateBase.AggregateBase {
     while (this.recorder?.getEvents().events.length) this.recorder?.clearBuffer?.();
   }
   syncWithSessionManager(state = {}) {
-    this.agentRef.runtime.session.write(state);
+    if (this.isSessionTrackingEnabled) {
+      this.agentRef.runtime.session.write(state);
+    }
   }
 }
 exports.Aggregate = Aggregate;

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

@@ -78,6 +78,9 @@ class AggregateBase extends _featureBase.FeatureBase {
     (0, _drain.drain)(this.agentIdentifier, this.featureName);
     this.drained = true;
   }
+  preHarvestChecks(opts) {
+    return !this.blocked;
+  }
 
   /**
    * Return harvest payload. A "serializer" function can be defined on a derived class to format the payload.

package/dist/cjs/loaders/agent.js

@@ -28,13 +28,24 @@ var _runtime = require("../common/constants/runtime");
 
 // common files
 
+/**
+ * @typedef {Object} AgentOptions
+ * @property {import('../common/config/info').Info} info - An object containing operational info needed by the agent. It's strongly encouraged to define this.
+ * @property {import('../common/config/init').Init} [init] - An object containing initialization configurations for the agent.
+ * @property {Object} [loader_config] - An object containing configuration primarily passed by APM injection. This is not recommended for use if not already provided by installation.
+ * @property {Object} [runtime] - An object containing runtime references by the agent. This is not recommended for use.
+ * @property {Array<Object>} [features] - A list of feature modules to include in the agent. This is only necessary when using the `Agent` class strictly.
+ * @property {boolean} [exposed] - Whether the agent should expose its API to (be affected by) the global `newrelic` object.
+ * @property {string} [loaderType] - The type of loader that is initializing the agent. It's recommended to allow the default.
+ */
+
 /**
  * A flexible class that may be used to compose an agent from a select subset of feature modules. In applications
  * sensitive to network load, this may result in smaller builds with slightly lower performance impact.
  */
 class Agent extends _agentBase.AgentBase {
   /**
-   * @param {Object} options Options to initialize agent with
+   * @param {AgentOptions} options
    */
   constructor(options) {
     super();

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

@@ -26,9 +26,12 @@ var _instrument11 = require("../features/soft_navigations/instrument");
  * The BrowserAgent class is the most convenient and reliable option for most use cases.
  */
 class BrowserAgent extends _agent.Agent {
-  constructor(args) {
+  /**
+   * @param {import('./agent').AgentOptions} options
+   */
+  constructor(options) {
     super({
-      ...args,
+      ...options,
       features: [_instrument5.Instrument, _instrument.Instrument, _instrument2.Instrument, _instrument6.Instrument, _instrument3.Instrument, _instrument4.Instrument, _instrument7.Instrument, _instrument11.Instrument, _instrument8.Instrument, _instrument9.Instrument, _instrument10.Instrument],
       loaderType: 'browser-agent'
     });

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

@@ -26,7 +26,7 @@ const nonAutoFeatures = [_features.FEATURE_NAMES.jserrors, _features.FEATURE_NAM
  */
 class MicroAgent extends _microAgentBase.MicroAgentBase {
   /**
-   * @param {Object} options - Specifies features and runtime configuration,
+   * @param {import('./agent').AgentOptions} options
    */
   constructor(options) {
     super();

package/dist/esm/common/config/info.js

@@ -4,6 +4,28 @@
  */
 import { defaults as nrDefaults, getNREUMInitializedAgent } from '../window/nreum';
 import { getModeledObject } from './configurable';
+
+/**
+ * @typedef {Object} Info
+ * @property {string} [beacon]
+ * @property {string} [errorBeacon] - Base URL endpoint for all data harvested by the agent. Proxies should be defined in the init instead.
+ * @property {string} licenseKey - New Relic license key provided by the website in user account.
+ * @property {string} applicationID - New Relic application ID provided when creating a browser entity in the UI.
+ * @property {number} [sa]
+ * @property {number} [queueTime]
+ * @property {number} [applicationTime]
+ * @property {string} [ttGuid]
+ * @property {string} [user]
+ * @property {string} [account]
+ * @property {string} [product]
+ * @property {string} [extra]
+ * @property {Object} [jsAttributes] - Custom attributes that are added to majority of agent's payloads. The `setCustomAttribute` API method affects this.
+ * @property {string} [userAttributes]
+ * @property {string} [atts]
+ * @property {string} [transactionName]
+ * @property {string} [tNamePlain]
+ */
+
 const model = {
   // preset defaults
   beacon: nrDefaults.beacon,