@newrelic/browser-agent 1.260.1 → 1.261.1

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

@@ -7,7 +7,7 @@ exports.Instrument = void 0;
 var _instrumentBase = require("../../utils/instrument-base");
 var CONSTANTS = _interopRequireWildcard(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); }
-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 && Object.prototype.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; }
+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; }
 class Instrument extends _instrumentBase.InstrumentBase {
   static featureName = CONSTANTS.FEATURE_NAME;
   constructor(agentIdentifier, aggregator) {

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

@@ -48,7 +48,6 @@ class Aggregate extends _aggregateBase.AggregateBase {
     if ((0, _config.getConfigurationValue)(this.agentIdentifier, 'page_view_timing.long_task') === true) _longTask.longTask.subscribe(this.#handleVitalMetric);
     (0, _registerHandler.registerHandler)('docHidden', msTimestamp => this.endCurrentSession(msTimestamp), this.featureName, this.ee);
     (0, _registerHandler.registerHandler)('winPagehide', msTimestamp => this.recordPageUnload(msTimestamp), this.featureName, this.ee);
-    const initialHarvestSeconds = (0, _config.getConfigurationValue)(this.agentIdentifier, 'page_view_timing.initialHarvestSeconds') || 10;
     const harvestTimeSeconds = (0, _config.getConfigurationValue)(this.agentIdentifier, 'page_view_timing.harvestTimeSeconds') || 30;
     this.waitForFlags([]).then(() => {
       /* It's important that CWV api, like "onLCP", is called before the **scheduler** is initialized. The reason is because they listen to the same
@@ -85,7 +84,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
           return _this.prepareHarvest(...arguments);
         }
       }, this);
-      scheduler.startTimer(harvestTimeSeconds, initialHarvestSeconds);
+      scheduler.startTimer(harvestTimeSeconds);
       this.drain();
     });
   }

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

@@ -24,7 +24,7 @@ var _drain = require("../../../common/drain/drain");
 var _now = require("../../../common/timing/now");
 var _utils = require("../shared/utils");
 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 && Object.prototype.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; } /*
+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 2023 New Relic Corporation. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */ /**
@@ -303,7 +303,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
       this.scheduler.opts.gzip = false;
     }
     if (len > _constants.MAX_PAYLOAD_SIZE) {
-      this.abort(_constants.ABORT_REASONS.TOO_BIG);
+      this.abort(_constants.ABORT_REASONS.TOO_BIG, len);
       return;
     }
     // TODO -- Gracefully handle the buffer for retries.
@@ -420,8 +420,9 @@ class Aggregate extends _aggregateBase.AggregateBase {
   /** Abort the feature, once aborted it will not resume */
   abort() {
     let reason = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+    let data = arguments.length > 1 ? arguments[1] : undefined;
     (0, _console.warn)("SR aborted -- ".concat(reason.message));
-    (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, ["SessionReplay/Abort/".concat(reason.sm)], undefined, _features.FEATURE_NAMES.metrics, this.ee);
+    (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, ["SessionReplay/Abort/".concat(reason.sm), data], undefined, _features.FEATURE_NAMES.metrics, this.ee);
     this.blocked = true;
     this.mode = _constants3.MODE.OFF;
     this.recorder?.stopRecording?.();

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

@@ -10,7 +10,7 @@ var _instrumentBase = require("../../utils/instrument-base");
 var _utils = require("../shared/utils");
 var _constants2 = 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); }
-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 && Object.prototype.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; } /*
+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 2023 New Relic Corporation. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */ /**

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

@@ -48,22 +48,30 @@ class Aggregate extends _aggregateBase.AggregateBase {
     this.entitled ??= stEntitled;
     if (this.blocked || !this.entitled) return (0, _drain.deregisterDrain)(this.agentIdentifier, this.featureName);
     if (!this.initialized) {
+      this.initialized = true;
+      /** Store session identifiers at initialization time to be cross-checked later at harvest time for session changes that are subject to race conditions */
+      this.ptid = this.agentRuntime.ptid;
+      this.sessionId = this.agentRuntime.session?.state.value;
       // 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(_constants2.SESSION_EVENTS.RESET, () => {
-        this.abort();
+        if (this.blocked) return;
+        this.abort(1);
       });
       // The SessionEntity can have updates (locally or across tabs for SR mode changes), (across tabs for ST mode changes).
       // Those updates should be sync'd here to ensure this page also honors the mode after initialization
       this.ee.on(_constants2.SESSION_EVENTS.UPDATE, (eventType, sessionState) => {
+        if (this.blocked) return;
         // this will only have an effect if ST is NOT already in full mode
         if (this.mode !== _constants2.MODE.FULL && (sessionState.sessionReplayMode === _constants2.MODE.FULL || sessionState.sessionTraceMode === _constants2.MODE.FULL)) this.switchToFull();
+        // if another page's session entity has expired, or another page has transitioned to off and this one hasn't... we can just abort straight away here
+        if (this.sessionId !== sessionState.value || eventType === 'cross-tab' && this.scheduler?.started && sessionState.sessionTraceMode === _constants2.MODE.OFF) this.abort(2);
       });
     }
 
     /** ST/SR sampling flow in BCS - https://drive.google.com/file/d/19hwt2oft-8Hh4RrjpLqEXfpP_9wYBLcq/view?usp=sharing */
     /** ST will run in the mode provided by BCS if the session IS NEW.  If not... it will use the state of the session entity to determine what mode to run in */
     if (!this.agentRuntime.session.isNew && !ignoreSession) this.mode = this.agentRuntime.session.state.sessionTraceMode;else this.mode = stMode;
-    this.initialized = true;
+
     /** If the mode is off, we do not want to hold up draining for other features, so we deregister the feature for now.
      * If it drains later (due to a mode change), data and handlers will instantly drain instead of waiting for the registry. */
     if (this.mode === _constants2.MODE.OFF) return (0, _drain.deregisterDrain)(this.agentIdentifier, this.featureName);
@@ -128,9 +136,8 @@ class Aggregate extends _aggregateBase.AggregateBase {
     let options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
     this.traceStorage.prevStoredEvents.clear(); // release references to past events for GC
     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.mode === _constants2.MODE.OFF && this.traceStorage.nodeCount === 0) return;
-    if (this.mode === _constants2.MODE.ERROR) return; // Trace in this mode should never be harvesting, even on unload
-
+    if (this.blocked || this.mode !== _constants2.MODE.FULL || this.traceStorage.nodeCount === 0) return;
+    if (this.sessionId !== this.agentRuntime.session?.state.value || this.ptid !== this.agentRuntime.ptid) return this.abort(3); // if something unexpected happened and we somehow still got to the point of harvesting after a session identifier changed, we should force-exit instead of harvesting
     /** Get the ST nodes from the traceStorage buffer.  This also returns helpful metadata about the payload. */
     const {
       stns,
@@ -186,8 +193,8 @@ class Aggregate extends _aggregateBase.AggregateBase {
           ...(hasReplay && {
             hasReplay
           }),
-          ptid: "".concat(this.agentRuntime.ptid),
-          session: "".concat(this.agentRuntime.session?.state.value),
+          ptid: "".concat(this.ptid),
+          session: "".concat(this.sessionId),
           // customer-defined data should go last so that if it exceeds the query param padding limit it will be truncated instead of important attrs
           ...(endUserId && {
             'enduser.id': endUserId
@@ -229,7 +236,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
   }
 
   /** Stop running for the remainder of the page lifecycle */
-  abort() {
+  abort(reason) {
     this.blocked = true;
     this.mode = _constants2.MODE.OFF;
     this.agentRuntime.session.write({

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

@@ -13,7 +13,7 @@ var _drain = require("../../../common/drain/drain");
 var _featureGates = require("../../utils/feature-gates");
 var _now = require("../../../common/timing/now");
 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 && Object.prototype.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; }
+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 New Relic Corporation. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0

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

@@ -28,7 +28,7 @@ var _constants2 = require("../../metrics/constants");
 var _drain = require("../../../common/drain/drain");
 var _console = require("../../../common/util/console");
 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 && Object.prototype.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; }
+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 New Relic Corporation. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -545,7 +545,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
       var interaction = this.ixn;
       var node = activeNodeFor(interaction);
       setCurrentNode(null);
-      node.child('customEnd', timestamp).finish(timestamp);
+      node.child('customEnd', timestamp)?.finish(timestamp);
       interaction.finish();
     }, this.featureName, baseEE);
     (0, _registerHandler.registerHandler)(INTERACTION_API + 'ignore', function (t) {

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

@@ -12,7 +12,7 @@ var _runtime = require("../../../common/constants/runtime");
 var _now = require("../../../common/timing/now");
 var _handle = require("../../../common/event-emitter/handle");
 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 && Object.prototype.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; }
+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 New Relic Corporation. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0

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

@@ -23,7 +23,7 @@ class AggregateBase extends _featureBase.FeatureBase {
    */
   waitForFlags() {
     let flagNames = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
-    return new Promise((resolve, reject) => {
+    const flagsPromise = new Promise((resolve, reject) => {
       if (_featureFlags.activatedFeatures[this.agentIdentifier]) {
         resolve(buildOutput(_featureFlags.activatedFeatures[this.agentIdentifier]));
       } else {
@@ -39,6 +39,9 @@ class AggregateBase extends _featureBase.FeatureBase {
         });
       }
     });
+    return flagsPromise.catch(err => {
+      this.ee.emit('internal-error', [err]);
+    });
   }
   drain() {
     (0, _drain.drain)(this.agentIdentifier, this.featureName);

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

@@ -15,7 +15,7 @@ var _utils = require("../session_replay/shared/utils");
 var _featureGates = require("./feature-gates");
 var _invoke = require("../../common/util/invoke");
 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 && Object.prototype.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; } /**
+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; } /**
  * @file Defines `InstrumentBase` to be used as the super of the Instrument classes implemented by each feature.
  * Inherits and executes the `checkConfiguration` method from [FeatureBase]{@link ./feature-base}, which also
  * exposes the `blocked` property.
@@ -93,6 +93,7 @@ class InstrumentBase extends _featureBase.FeatureBase {
         }
       } catch (e) {
         (0, _console.warn)('A problem occurred when starting up session manager. This page will not start or extend any session.', e);
+        this.ee.emit('internal-error', [e]);
         if (this.featureName === _features.FEATURE_NAMES.sessionReplay) this.abortHandler?.(); // SR should stop recording if session DNE
       }
 
@@ -137,7 +138,7 @@ class InstrumentBase extends _featureBase.FeatureBase {
   */
   #shouldImportAgg(featureName, session) {
     if (featureName === _features.FEATURE_NAMES.sessionReplay) return (0, _utils.canImportReplayAgg)(this.agentIdentifier, session);
-    return true;
+    return !(featureName === _features.FEATURE_NAMES.sessionTrace && !session);
   }
 }
 exports.InstrumentBase = InstrumentBase;

package/dist/cjs/features/utils/lazy-feature-loader.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.lazyFeatureLoader = lazyFeatureLoader;
 var _features = require("../../loaders/features/features");
 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 && Object.prototype.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; }
+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; }
 /**
  * Centralizes the lazy loading of agent feature aggregate and instrument sources.
  *
@@ -25,6 +25,8 @@ function lazyFeatureLoader(featureName, featurePart) {
         return Promise.resolve().then(() => _interopRequireWildcard(require( /* webpackChunkName: "ajax-aggregate" */'../ajax/aggregate')));
       case _features.FEATURE_NAMES.jserrors:
         return Promise.resolve().then(() => _interopRequireWildcard(require( /* webpackChunkName: "jserrors-aggregate" */'../jserrors/aggregate')));
+      case _features.FEATURE_NAMES.logging:
+        return Promise.resolve().then(() => _interopRequireWildcard(require( /* webpackChunkName: "logging-aggregate" */'../logging/aggregate')));
       case _features.FEATURE_NAMES.metrics:
         return Promise.resolve().then(() => _interopRequireWildcard(require( /* webpackChunkName: "metrics-aggregate" */'../metrics/aggregate')));
       case _features.FEATURE_NAMES.pageAction:

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

@@ -60,8 +60,8 @@ class AgentBase {
    * Adds a user-defined attribute name and value to subsequent events on the page.
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setcustomattribute/}
    * @param {string} name Name of the attribute. Appears as column in the PageView event. It will also appear as a column in the PageAction event if you are using it.
-   * @param {string|number|null} value Value of the attribute. Appears as the value in the named attribute column in the PageView event. It will appear as a column in the PageAction event if you are using it. Custom attribute values cannot be complex objects, only simple types such as Strings and Integers.
-   * @param {boolean} [persist] Default false. f set to true, the name-value pair will also be set into the browser's storage API. Then on the following instrumented pages that load within the same session, the pair will be re-applied as a custom attribute.
+   * @param {string|number|boolean|null} value Value of the attribute. Appears as the value in the named attribute column in the PageView event. It will appear as a column in the PageAction event if you are using it. Custom attribute values cannot be complex objects, only simple types such as Strings, Integers and Booleans. Passing a null value unsets any existing attribute of the same name.
+   * @param {boolean} [persist] Default false. If set to true, the name-value pair will also be set into the browser's storage API. Then on the following instrumented pages that load within the same session, the pair will be re-applied as a custom attribute.
    */
   setCustomAttribute(name, value, persist) {
     return this.#callMethod('setCustomAttribute', name, value, persist);
@@ -188,5 +188,26 @@ class AgentBase {
   interaction() {
     return this.#callMethod('interaction');
   }
+
+  /**
+   * Capture a single log.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/loginfo/}
+   * @param {string} message String to be captured as log message
+   * @param {{customAttributes?: object, level?: 'ERROR'|'TRACE'|'DEBUG'|'INFO'|'WARN'}} [options] customAttributes defaults to `{}` if not assigned, level defaults to `info` if not assigned.
+  */
+  log(message, options) {
+    return this.#callMethod('logInfo', message, options);
+  }
+
+  /**
+   * Wrap a logger function to capture a log each time the function is invoked with the message and arguments passed
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/wraplogger/}
+   * @param {object} parent The parent object containing the logger method
+   * @param {string} functionName The property name of the function in the parent object to be wrapped
+   * @param {{customAttributes?: object, level?: 'ERROR'|'TRACE'|'DEBUG'|'INFO'|'WARN'}} [options] customAttributes defaults to `{}` if not assigned, level defaults to `info` if not assigned.
+  */
+  wrapLogger(parent, functionName, options) {
+    return this.#callMethod('wrapLogger', parent, functionName, options);
+  }
 }
 exports.AgentBase = AgentBase;

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

@@ -5,5 +5,5 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.asyncApiMethods = exports.apiMethods = void 0;
 var _constants = require("../../features/session_replay/constants");
-const apiMethods = exports.apiMethods = ['setErrorHandler', 'finished', 'addToTrace', 'addRelease', 'addPageAction', 'setCurrentRouteName', 'setPageViewName', 'setCustomAttribute', 'interaction', 'noticeError', 'setUserId', 'setApplicationVersion', 'start', _constants.SR_EVENT_EMITTER_TYPES.RECORD, _constants.SR_EVENT_EMITTER_TYPES.PAUSE];
+const apiMethods = exports.apiMethods = ['setErrorHandler', 'finished', 'addToTrace', 'addRelease', 'addPageAction', 'setCurrentRouteName', 'setPageViewName', 'setCustomAttribute', 'interaction', 'noticeError', 'setUserId', 'setApplicationVersion', 'start', _constants.SR_EVENT_EMITTER_TYPES.RECORD, _constants.SR_EVENT_EMITTER_TYPES.PAUSE, 'log', 'wrapLogger'];
 const asyncApiMethods = exports.asyncApiMethods = ['setErrorHandler', 'finished', 'addToTrace', 'addRelease'];

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

@@ -19,8 +19,11 @@ var _apiMethods = require("./api-methods");
 var _constants2 = require("../../features/session_replay/constants");
 var _now = require("../../common/timing/now");
 var _constants3 = require("../../common/session/constants");
+var _constants4 = require("../../features/logging/constants");
+var _utils = require("../../features/logging/shared/utils");
+var _wrapLogger = require("../../common/wrap/wrap-logger");
 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 && Object.prototype.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; } /*
+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 New Relic Corporation. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
@@ -60,6 +63,30 @@ function setAPI(agentIdentifier, forceDrain) {
   });
   var prefix = 'api-';
   var spaPrefix = prefix + 'ixn-';
+  apiInterface.log = function (message) {
+    let {
+      customAttributes = {},
+      level = _constants4.LOG_LEVELS.INFO
+    } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+    if (!customAttributes || typeof customAttributes !== 'object') customAttributes = {};
+    if (typeof message !== 'string' || !message) return (0, _console.warn)(_constants4.LOGGING_IGNORED + 'invalid message');
+    if (!(0, _utils.isValidLogLevel)(level)) return (0, _console.warn)(_constants4.LOGGING_LEVEL_FAILURE_MESSAGE + level, _constants4.LOG_LEVELS);
+    if (message.length > _constants4.MAX_PAYLOAD_SIZE) return (0, _console.warn)(_constants4.LOGGING_IGNORED + '> ' + _constants4.MAX_PAYLOAD_SIZE + ' bytes: ', message.slice(0, 25) + '...');
+    (0, _utils.bufferLog)(instanceEE, message, customAttributes, level.toUpperCase());
+  };
+  apiInterface.wrapLogger = function (parent, functionName) {
+    let {
+      customAttributes = {},
+      level = _constants4.LOG_LEVELS.INFO
+    } = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+    if (!customAttributes || typeof customAttributes !== 'object') customAttributes = {};
+    if (!(typeof parent === 'object' && !!parent && typeof functionName === 'string' && !!functionName && typeof parent[functionName] === 'function' && typeof customAttributes === 'object')) return (0, _console.warn)(_constants4.LOGGING_FAILURE_MESSAGE + 'invalid argument(s)');
+    if (!(0, _utils.isValidLogLevel)(level)) return (0, _console.warn)(_constants4.LOGGING_FAILURE_MESSAGE + _constants4.LOGGING_LEVEL_FAILURE_MESSAGE + level, _constants4.LOG_LEVELS);
+    (0, _wrapLogger.wrapLogger)(instanceEE, parent, functionName, {
+      customAttributes,
+      level: level.toUpperCase()
+    });
+  };
 
   // Setup stub functions that queue calls for later processing.
   _apiMethods.asyncApiMethods.forEach(fnName => {
@@ -76,7 +103,7 @@ function setAPI(agentIdentifier, forceDrain) {
   /**
    * Attach the key-value attribute onto agent payloads. All browser events in NR will be affected.
    * @param {string} key
-   * @param {string|number|null} value - null indicates the key should be removed or erased
+   * @param {string|number|boolean|null} value - null indicates the key should be removed or erased
    * @param {string} apiName
    * @param {boolean} addToBrowserStorage - whether this attribute should be stored in browser storage API and retrieved by the next agent context or initialization
    * @returns @see apiCall

package/dist/cjs/loaders/features/features.js

@@ -7,6 +7,7 @@ exports.featurePriority = exports.FEATURE_NAMES = void 0;
 const FEATURE_NAMES = exports.FEATURE_NAMES = {
   ajax: 'ajax',
   jserrors: 'jserrors',
+  logging: 'logging',
   metrics: 'metrics',
   pageAction: 'page_action',
   pageViewEvent: 'page_view_event',
@@ -26,10 +27,11 @@ const featurePriority = exports.featurePriority = {
   [FEATURE_NAMES.pageViewTiming]: 2,
   [FEATURE_NAMES.metrics]: 3,
   [FEATURE_NAMES.jserrors]: 4,
-  [FEATURE_NAMES.ajax]: 5,
-  [FEATURE_NAMES.sessionTrace]: 6,
-  [FEATURE_NAMES.pageAction]: 7,
-  [FEATURE_NAMES.spa]: 8,
+  [FEATURE_NAMES.spa]: 5,
+  [FEATURE_NAMES.ajax]: 6,
+  [FEATURE_NAMES.sessionTrace]: 7,
+  [FEATURE_NAMES.pageAction]: 8,
   [FEATURE_NAMES.softNav]: 9,
-  [FEATURE_NAMES.sessionReplay]: 10
+  [FEATURE_NAMES.sessionReplay]: 10,
+  [FEATURE_NAMES.logging]: 11
 };

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

@@ -15,7 +15,7 @@ var _console = require("../common/util/console");
 var _load = require("../common/window/load");
 var _agentBase = require("./agent-base");
 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 && Object.prototype.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; } // loader files
+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; } // loader files
 // core files
 const nonAutoFeatures = [_features.FEATURE_NAMES.jserrors, _features.FEATURE_NAMES.pageAction, _features.FEATURE_NAMES.metrics];
 

package/dist/esm/cdn/experimental.js

@@ -19,8 +19,9 @@ import { Instrument as InstrumentSessionReplay } from '../features/session_repla
 // import { Instrument as InstrumentSpa } from '../features/spa/instrument'
 import { Instrument as InstrumentSoftNav } from '../features/soft_navigations/instrument';
 import { Instrument as InstrumentPageAction } from '../features/page_action/instrument';
+import { Instrument as InstrumentLogs } from '../features/logging/instrument';
 new Agent({
-  features: [InstrumentXhr, InstrumentPageViewEvent, InstrumentPageViewTiming, InstrumentSessionTrace, InstrumentSessionReplay, InstrumentMetrics, InstrumentPageAction, InstrumentErrors,
+  features: [InstrumentXhr, InstrumentPageViewEvent, InstrumentPageViewTiming, InstrumentSessionTrace, InstrumentSessionReplay, InstrumentMetrics, InstrumentPageAction, InstrumentErrors, InstrumentLogs,
   // InstrumentSpa,
   InstrumentSoftNav],
   loaderType: 'experimental'

package/dist/esm/cdn/polyfills/pro.js

@@ -12,7 +12,8 @@ import { Instrument as InstrumentErrors } from '../../features/jserrors/instrume
 import { Instrument as InstrumentXhr } from '../../features/ajax/instrument';
 import { Instrument as InstrumentSessionTrace } from '../../features/session_trace/instrument';
 import { Instrument as InstrumentPageAction } from '../../features/page_action/instrument';
+import { Instrument as InstrumentLogs } from '../../features/logging/instrument';
 new Agent({
-  features: [InstrumentPageViewEvent, InstrumentPageViewTiming, InstrumentSessionTrace, InstrumentXhr, InstrumentMetrics, InstrumentPageAction, InstrumentErrors],
+  features: [InstrumentPageViewEvent, InstrumentPageViewTiming, InstrumentSessionTrace, InstrumentXhr, InstrumentMetrics, InstrumentPageAction, InstrumentErrors, InstrumentLogs],
   loaderType: 'pro-polyfills'
 });

package/dist/esm/cdn/polyfills/spa.js

@@ -13,7 +13,8 @@ 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 InstrumentLogs } from '../../features/logging/instrument';
 new Agent({
-  features: [InstrumentXhr, InstrumentPageViewEvent, InstrumentPageViewTiming, InstrumentSessionTrace, InstrumentMetrics, InstrumentPageAction, InstrumentErrors, InstrumentSpa],
+  features: [InstrumentXhr, InstrumentPageViewEvent, InstrumentPageViewTiming, InstrumentSessionTrace, InstrumentMetrics, InstrumentPageAction, InstrumentErrors, InstrumentLogs, InstrumentSpa],
   loaderType: 'spa-polyfills'
 });

package/dist/esm/cdn/pro.js

@@ -12,7 +12,8 @@ import { Instrument as InstrumentXhr } from '../features/ajax/instrument';
 import { Instrument as InstrumentSessionTrace } from '../features/session_trace/instrument';
 import { Instrument as InstrumentSessionReplay } from '../features/session_replay/instrument';
 import { Instrument as InstrumentPageAction } from '../features/page_action/instrument';
+import { Instrument as InstrumentLogs } from '../features/logging/instrument';
 new Agent({
-  features: [InstrumentPageViewEvent, InstrumentPageViewTiming, InstrumentSessionTrace, InstrumentSessionReplay, InstrumentXhr, InstrumentMetrics, InstrumentPageAction, InstrumentErrors],
+  features: [InstrumentPageViewEvent, InstrumentPageViewTiming, InstrumentSessionTrace, InstrumentSessionReplay, InstrumentXhr, InstrumentMetrics, InstrumentPageAction, InstrumentErrors, InstrumentLogs],
   loaderType: 'pro'
 });

package/dist/esm/cdn/spa.js

@@ -13,8 +13,9 @@ import { Instrument as InstrumentSessionReplay } from '../features/session_repla
 import { Instrument as InstrumentSoftNav } from '../features/soft_navigations/instrument';
 import { Instrument as InstrumentSpa } from '../features/spa/instrument';
 import { Instrument as InstrumentPageAction } from '../features/page_action/instrument';
+import { Instrument as InstrumentLogs } from '../features/logging/instrument';
 new Agent({
-  features: [InstrumentXhr, InstrumentPageViewEvent, InstrumentPageViewTiming, InstrumentSessionTrace, InstrumentSessionReplay, InstrumentMetrics, InstrumentPageAction, InstrumentErrors, InstrumentSoftNav, InstrumentSpa // either the softnav or the old spa will be used (not both), but we still need to pack both to avoid dynamic import for instrument files
+  features: [InstrumentXhr, InstrumentPageViewEvent, InstrumentPageViewTiming, InstrumentSessionTrace, InstrumentSessionReplay, InstrumentMetrics, InstrumentPageAction, InstrumentErrors, InstrumentLogs, InstrumentSoftNav, InstrumentSpa // either the softnav or the old spa will be used (not both), but we still need to pack both to avoid dynamic import for instrument files
   ],
   loaderType: 'spa'
 });

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

@@ -1,3 +1,4 @@
+import { LOG_LEVELS } from '../../../features/logging/constants';
 import { isValidSelector } from '../../dom/query-selector';
 import { DEFAULT_EXPIRES_MS, DEFAULT_INACTIVE_MS } from '../../session/constants';
 import { warn } from '../../util/console';
@@ -29,16 +30,6 @@ const model = () => {
     }
   };
   return {
-    feature_flags: [],
-    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
-    },
-    privacy: {
-      cookies_enabled: true
-    },
-    // *cli - per discussion, default should be true
     ajax: {
       deny_list: undefined,
       block_internal: true,
@@ -53,21 +44,26 @@ const model = () => {
       cors_use_tracecontext_headers: undefined,
       allowed_origins: undefined
     },
-    session: {
-      expiresMs: DEFAULT_EXPIRES_MS,
-      inactiveMs: DEFAULT_INACTIVE_MS
+    feature_flags: [],
+    harvest: {
+      tooManyRequestsDelay: 60
     },
-    ssl: undefined,
-    obfuscate: undefined,
     jserrors: {
       enabled: true,
       harvestTimeSeconds: 10,
       autoStart: true
     },
+    logging: {
+      enabled: true,
+      harvestTimeSeconds: 10,
+      autoStart: true,
+      level: LOG_LEVELS.INFO
+    },
     metrics: {
       enabled: true,
       autoStart: true
     },
+    obfuscate: undefined,
     page_action: {
       enabled: true,
       harvestTimeSeconds: 30,
@@ -83,13 +79,18 @@ const model = () => {
       long_task: false,
       autoStart: true
     },
-    session_trace: {
-      enabled: true,
-      harvestTimeSeconds: 10,
-      autoStart: true
+    privacy: {
+      cookies_enabled: true
     },
-    harvest: {
-      tooManyRequestsDelay: 60
+    // *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
+    },
+    session: {
+      expiresMs: DEFAULT_EXPIRES_MS,
+      inactiveMs: DEFAULT_INACTIVE_MS
     },
     session_replay: {
       // feature settings
@@ -146,7 +147,7 @@ const model = () => {
         };else warn('An invalid session_replay.mask_input_option was provided and will not be used', val);
       }
     },
-    spa: {
+    session_trace: {
       enabled: true,
       harvestTimeSeconds: 10,
       autoStart: true
@@ -155,7 +156,13 @@ const model = () => {
       enabled: true,
       harvestTimeSeconds: 10,
       autoStart: true
-    }
+    },
+    spa: {
+      enabled: true,
+      harvestTimeSeconds: 10,
+      autoStart: true
+    },
+    ssl: undefined
   };
 };
 const _cache = {};

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

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

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

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

package/dist/esm/common/deny-list/deny-list.js

@@ -10,7 +10,7 @@ var denyList = [];
  * @returns {boolean} `true` if request does not match any entries of {@link denyList|deny list}; else `false`
  */
 export function shouldCollectEvent(params) {
-  if (hasUndefinedHostname(params)) return false;
+  if (!params || hasUndefinedHostname(params)) return false;
   if (denyList.length === 0) return true;
   for (var i = 0; i < denyList.length; i++) {
     var parsed = denyList[i];

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

@@ -3,7 +3,7 @@ import { warn } from '../util/console';
 import { stringify } from '../util/stringify';
 import { ee } from '../event-emitter/contextual-ee';
 import { Timer } from '../timer/timer';
-import { isBrowserScope } from '../constants/runtime';
+import { isBrowserScope, isIE } from '../constants/runtime';
 import { DEFAULT_EXPIRES_MS, DEFAULT_INACTIVE_MS, MODE, PREFIX, SESSION_EVENTS, SESSION_EVENT_TYPES } from './constants';
 import { InteractionTimer } from '../timer/interaction-timer';
 import { wrapEvents } from '../wrap';
@@ -53,7 +53,13 @@ export class SessionEntity {
     this.ee = ee.get(agentIdentifier);
     wrapEvents(this.ee);
     this.setup(opts);
-    if (isBrowserScope) {
+
+    /**
+     * Do not emit session storage events for IE11, because IE11 is unable to determine
+     * if the event was spawned on the current page or an adjacent page, and the behavior tied
+     * to storage events is critical to apply only to cross-tab behavior
+     * */
+    if (isBrowserScope && !isIE) {
       windowAddEventListener('storage', event => {
         if (event.key === this.lookupKey) {
           const obj = typeof event.newValue === 'string' ? JSON.parse(event.newValue) : event.newValue;