@newrelic/browser-agent 1.316.0 → 1.317.0-rc.0

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

@@ -11,11 +11,12 @@ var _aggregateBase = require("../../utils/aggregate-base");
 var _constants = require("../constants");
 var _log = require("../shared/log");
 var _utils = require("../shared/utils");
-var _traverse = require("../../../common/util/traverse");
+var _obfuscate = require("../../../common/util/obfuscate");
 var _constants2 = require("../../../common/session/constants");
 var _constants3 = require("../../session_replay/constants");
 var _featureGates = require("../../utils/feature-gates");
 var _utils2 = require("../../../common/v2/utils");
+var _events = require("../../../common/constants/events");
 /**
  * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -39,6 +40,9 @@ class Aggregate extends _aggregateBase.AggregateBase {
     this.harvestOpts.raw = true;
     super.customAttributesAreSeparate = true;
 
+    // Create obfuscator for log entries
+    this.obfuscator = new _obfuscate.Obfuscator(agentRef, _events.EVENT_TYPES.LOG);
+
     // 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(_constants3.ABORT_REASONS.RESET);
@@ -57,7 +61,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
       }; // likewise, don't want to overwrite the mode if it was set already
       const session = this.agentRef.runtime.session;
       if ((0, _featureGates.canEnableSessionTracking)(agentRef.init) && session) {
-        if (session.isNew) this.#syncWithSessionManager();else updateLocalLoggingMode(session.state.loggingMode, session.state.logApiMode);
+        if (session.state.loggingMode === null || session.state.logApiMode === null) this.#writeToStorage(this.loggingMode);else updateLocalLoggingMode(session.state.loggingMode, session.state.logApiMode);
       }
       if (this.loggingMode.auto === _constants.LOGGING_MODE.OFF && this.loggingMode.api === _constants.LOGGING_MODE.OFF) {
         this.blocked = true;
@@ -119,7 +123,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
       common: {
         /** Attributes in the `common` section are added to `all` logs generated in the payload */
         attributes: {
-          ...(0, _traverse.applyFnToProps)(this.agentRef.info.jsAttributes, this.obfuscator.obfuscateString.bind(this.obfuscator), 'string'),
+          ...this.obfuscator.traverseAndObfuscateEvents(this.agentRef.info.jsAttributes),
           ...(this.harvestEndpointVersion === 1 && {
             'entity.guid': this.agentRef.runtime.appMetadata.agents[0].entityGuid,
             appId: this.agentRef.info.applicationID
@@ -144,7 +148,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
         }
       },
       /** logs section contains individual unique log entries */
-      logs: (0, _traverse.applyFnToProps)(eventBuffer, this.obfuscator.obfuscateString.bind(this.obfuscator), 'string')
+      logs: this.obfuscator.traverseAndObfuscateEvents(eventBuffer)
     }];
   }
   queryStringsBuilder() {
@@ -165,13 +169,13 @@ class Aggregate extends _aggregateBase.AggregateBase {
       auto: _constants.LOGGING_MODE.OFF,
       api: _constants.LOGGING_MODE.OFF
     };
-    this.#syncWithSessionManager();
+    this.#writeToStorage(this.loggingMode);
     this.deregisterDrain();
   }
-  #syncWithSessionManager() {
+  #writeToStorage(logModes) {
     this.agentRef.runtime.session?.write({
-      loggingMode: this.loggingMode.auto,
-      logApiMode: this.loggingMode.api
+      loggingMode: logModes.auto,
+      logApiMode: logModes.api
     });
   }
 }

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

@@ -14,8 +14,9 @@ var _runtime = require("../../../common/constants/runtime");
 var _aggregateBase = require("../../utils/aggregate-base");
 var _iframe = require("../../../common/dom/iframe");
 var _harvestMetadata = require("./harvest-metadata");
+var _obfuscate = require("../../../common/util/obfuscate");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
@@ -28,6 +29,9 @@ class Aggregate extends _aggregateBase.AggregateBase {
     super(agentRef, _constants.FEATURE_NAME);
     this.harvestOpts.aggregatorTypes = ['cm', 'sm']; // the types in EventAggregator this feature cares about
 
+    // Create a generic obfuscator for checking if rules are configured
+    this.obfuscator = new _obfuscate.Obfuscator(agentRef);
+
     /** all the harvest metadata metrics need to be evaluated simulataneously at unload time so just temporarily buffer them and dont make SMs immediately from the data */
     this.harvestMetadata = {};
     this.harvestOpts.beforeUnload = () => {

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

@@ -17,11 +17,13 @@ var _firstPaint = require("../../../common/vitals/first-paint");
 var _timeToFirstByte = require("../../../common/vitals/time-to-first-byte");
 var _now = require("../../../common/timing/now");
 var _timeKeeper = require("../../../common/timing/time-keeper");
-var _traverse = require("../../../common/util/traverse");
-var _harvester = require("../../../common/harvest/harvester");
+var _send = require("../../../common/harvest/send");
+var _featureGates = require("../../utils/feature-gates");
+var _obfuscate = require("../../../common/util/obfuscate");
 var _features = require("../../../loaders/features/features");
 var _submitData = require("../../../common/util/submit-data");
 var _webdriverDetection = require("../../../common/util/webdriver-detection");
+var _events = require("../../../common/constants/events");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 /**
  * Copyright 2020-2026 New Relic, Inc. All rights reserved.
@@ -32,14 +34,31 @@ class Aggregate extends _aggregateBase.AggregateBase {
   static featureName = CONSTANTS.FEATURE_NAME;
   constructor(agentRef) {
     super(agentRef, CONSTANTS.FEATURE_NAME);
+    this.isSessionTrackingEnabled = (0, _featureGates.canEnableSessionTracking)(agentRef.init) && !!agentRef.runtime.session;
     this.sentRum = false; // flag to facilitate calling sendRum() once externally (by the consent API in agent-session.js)
 
     this.timeToFirstByte = 0;
     this.firstByteToWindowLoad = 0; // our "frontend" duration
     this.firstByteToDomContent = 0; // our "dom processing" duration
     this.retries = 0;
+
+    // Create obfuscator for page view events
+    this.obfuscator = new _obfuscate.Obfuscator(agentRef, _events.EVENT_TYPES.PVE);
     agentRef.runtime.timeKeeper = new _timeKeeper.TimeKeeper(agentRef.runtime.session);
     if (_runtime.isBrowserScope) {
+      const cached = this.isSessionTrackingEnabled && agentRef.runtime.session?.state.cachedRumResponse;
+      if (cached) {
+        const {
+          app: cachedApp,
+          ...cachedFlags
+        } = cached;
+
+        // set the agent runtime objects that require the rum response or entity guid
+        if (!Object.keys(this.agentRef.runtime.appMetadata).length) agentRef.runtime.appMetadata = cachedApp;
+        this.drain();
+        agentRef.runtime.harvester.startTimer();
+        (0, _featureFlags.activateFeatures)(cachedFlags, agentRef);
+      }
       _timeToFirstByte.timeToFirstByte.subscribe(({
         value,
         attrs
@@ -84,14 +103,13 @@ class Aggregate extends _aggregateBase.AggregateBase {
       ua: info.userAttributes,
       at: info.atts
     };
-    if (this.agentRef.runtime.session) queryParameters.fsh = Number(this.agentRef.runtime.session.isNew); // "first session harvest" aka RUM request or PageView event of a session
-
-    let body = (0, _traverse.applyFnToProps)({
+    if (this.agentRef.runtime.session) queryParameters.fsh = Number(!this.agentRef.runtime.session.state.cachedRumResponse);
+    let body = this.obfuscator.traverseAndObfuscateEvents({
       ja: {
         ...customAttributes,
         webdriverDetected: _webdriverDetection.webdriverDetected
       }
-    }, this.obfuscator.obfuscateString.bind(this.obfuscator), 'string');
+    });
     if (_runtime.globalScope.performance) {
       const navTimingEntry = (0, _runtime.getNavigationEntry)();
       if (navTimingEntry) {
@@ -139,6 +157,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
   }) {
     const rumEndTime = (0, _now.now)();
     let app, flags;
+    const hasCachedRumResponse = !!this.agentRef.runtime.session?.state.cachedRumResponse;
     try {
       ({
         app,
@@ -148,10 +167,20 @@ class Aggregate extends _aggregateBase.AggregateBase {
       // wont set entity stuff here, if main agent will later abort, if registered agent, nothing will happen
       (0, _console.warn)(53, error);
     }
+    const shouldCacheResponse = this.isSessionTrackingEnabled && !hasCachedRumResponse && !!app;
+    if (hasCachedRumResponse) {
+      let {
+        app: cachedApp,
+        ...cachedFlags
+      } = this.agentRef.runtime.session.state.cachedRumResponse;
+      app ??= cachedApp;
+      flags = cachedFlags;
+    }
     super.postHarvestCleanup({
       sent,
-      retry
+      retry: retry && !hasCachedRumResponse
     }); // this will set isRetrying & re-buffer the body if request is to be retried
+
     if (this.isRetrying && this.retries++ < 1) {
       // Only retry once
       setTimeout(() => this.agentRef.runtime.harvester.triggerHarvestFor(this, {
@@ -161,7 +190,6 @@ class Aggregate extends _aggregateBase.AggregateBase {
     }
     if (status >= 400 || status === 0) {
       (0, _console.warn)(18, status);
-      this.blocked = true;
 
       // Get estimated payload size of our backlog
       const textEncoder = new TextEncoder();
@@ -172,15 +200,24 @@ class Aggregate extends _aggregateBase.AggregateBase {
       }, 0);
       const BCSError = 'BCS/Error/';
       // Send SMs about failed RUM request
-      const body = {
-        sm: [{
-          params: {
-            name: BCSError + status
-          },
-          stats: {
-            c: 1
-          }
-        }, {
+      const sm = [{
+        params: {
+          name: BCSError + status
+        },
+        stats: {
+          c: 1
+        }
+      }, {
+        params: {
+          name: BCSError + 'Duration/Ms'
+        },
+        stats: {
+          c: 1,
+          t: rumEndTime - this.rumStartTime
+        }
+      }];
+      if (!hasCachedRumResponse) {
+        sm.push({
           params: {
             name: BCSError + 'Dropped/Bytes'
           },
@@ -188,28 +225,30 @@ class Aggregate extends _aggregateBase.AggregateBase {
             c: 1,
             t: payloadSize
           }
-        }, {
-          params: {
-            name: BCSError + 'Duration/Ms'
-          },
-          stats: {
-            c: 1,
-            t: rumEndTime - this.rumStartTime
-          }
-        }]
-      };
-      (0, _harvester.send)(this.agentRef, {
+        });
+      }
+      (0, _send.send)(this.agentRef, {
         endpoint: _features.FEATURE_TO_ENDPOINT[_features.FEATURE_NAMES.metrics],
         payload: {
-          body
+          body: {
+            sm
+          }
         },
         submitMethod: (0, _submitData.getSubmitMethod)(),
         featureName: _features.FEATURE_NAMES.metrics
       });
-
-      // Adding retry logic for the rum call will be a separate change; this.blocked will need to be changed since that prevents another triggerHarvestFor()
-      this.ee.abort();
-      return;
+      if (!hasCachedRumResponse) {
+        this.blocked = true;
+        this.ee.abort();
+        return;
+      }
+    } else if (shouldCacheResponse) {
+      this.agentRef.runtime.session.write({
+        cachedRumResponse: {
+          app,
+          ...flags
+        }
+      });
     }
     try {
       const wasReady = this.agentRef.runtime.timeKeeper.ready;

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

@@ -10,6 +10,7 @@ var _handle = require("../../../common/event-emitter/handle");
 var _constants = require("../constants");
 var _features = require("../../../loaders/features/features");
 var _aggregateBase = require("../../utils/aggregate-base");
+var _obfuscate = require("../../../common/util/obfuscate");
 var _cumulativeLayoutShift = require("../../../common/vitals/cumulative-layout-shift");
 var _firstContentfulPaint = require("../../../common/vitals/first-contentful-paint");
 var _firstPaint = require("../../../common/vitals/first-paint");
@@ -22,6 +23,7 @@ var _eventOrigin = require("../../../common/util/event-origin");
 var _loadTime = require("../../../common/vitals/load-time");
 var _webdriverDetection = require("../../../common/util/webdriver-detection");
 var _cleanUrl = require("../../../common/url/clean-url");
+var _events = require("../../../common/constants/events");
 /**
  * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -41,6 +43,9 @@ class Aggregate extends _aggregateBase.AggregateBase {
     this.curSessEndRecorded = false;
     this.firstIxnRecorded = false;
     super.customAttributesAreSeparate = true;
+
+    // Create obfuscator for page view timing events
+    this.obfuscator = new _obfuscate.Obfuscator(agentRef, _events.EVENT_TYPES.PVT);
     (0, _registerHandler.registerHandler)('docHidden', msTimestamp => this.endCurrentSession(msTimestamp), this.featureName, this.ee);
     // Add the time of _window pagehide event_ firing to the next PVT harvest == NRDB windowUnload attr:
     (0, _registerHandler.registerHandler)('winPagehide', msTimestamp => this.addTiming('unload', msTimestamp, null), this.featureName, this.ee);
@@ -146,7 +151,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
   // serialize array of timing data
   serializer(eventBuffer) {
     if (!eventBuffer?.length) return '';
-    var addString = (0, _belSerializer.getAddStringContext)(this.agentRef.runtime.obfuscator);
+    var addString = (0, _belSerializer.getAddStringContext)(this.obfuscator);
     var payload = 'bel.6;';
     for (var i = 0; i < eventBuffer.length; i++) {
       var timing = eventBuffer[i];

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

@@ -17,9 +17,11 @@ var _stringify = require("../../../common/util/stringify");
 var _stylesheetEvaluator = require("../shared/stylesheet-evaluator");
 var _now = require("../../../common/timing/now");
 var _agentConstants = require("../../../common/constants/agent-constants");
+var _events = require("../../../common/constants/events");
 var _cleanUrl = require("../../../common/url/clean-url");
 var _featureGates = require("../../utils/feature-gates");
 var _constants3 = require("../../../loaders/api/constants");
+var _obfuscate = require("../../../common/util/obfuscate");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); } /**
  * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -28,11 +30,15 @@ function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r
  */
 class Aggregate extends _aggregateBase.AggregateBase {
   static featureName = _constants.FEATURE_NAME;
-  mode = _constants2.MODE.OFF;
+  mode = null;
 
   // pass the recorder into the aggregator
   constructor(agentRef, args) {
     super(agentRef, _constants.FEATURE_NAME);
+
+    // Create obfuscator for session replay query params
+    this.obfuscator = new _obfuscate.Obfuscator(agentRef, _events.EVENT_TYPES.SR);
+
     /** Set once the recorder has fully initialized after flag checks and sampling */
     this.initialized = false;
     /** Set once the feature has been "aborted" to prevent other side-effects from continuing */
@@ -69,7 +75,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
       if (!this.recorder) return;
       // if the mode changed on a different tab, it needs to update this instance to match
       this.mode = agentRef.runtime.session.state.sessionReplayMode;
-      if (!this.initialized || this.mode === _constants2.MODE.OFF) return;
+      if (!this.initialized || this.mode === _constants2.MODE.OFF || !this.mode) return;
       this.recorder?.startRecording(_constants.TRIGGERS.RESUME, this.mode);
     });
     this.ee.on(_constants2.SESSION_EVENTS.UPDATE, (type, data) => {
@@ -96,6 +102,10 @@ class Aggregate extends _aggregateBase.AggregateBase {
     this.waitForFlags(['srs', 'sr']).then(([srMode, entitled]) => {
       this.entitled = !!entitled;
       if (!this.entitled) {
+        this.mode = _constants2.MODE.OFF;
+        this.#writeToStorage({
+          sessionReplayMode: this.mode
+        });
         this.deregisterDrain();
         if (this.agentRef.runtime.isRecording) {
           this.abort(_constants.ABORT_REASONS.ENTITLEMENTS);
@@ -107,7 +117,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
         this.drain();
       });
     }).then(() => {
-      if (this.mode === _constants2.MODE.OFF) {
+      if (!this.mode) {
         this.recorder?.stopRecording(); // stop any conservative preload recording launched by instrument
         while (this.recorder?.getEvents().events.length) this.recorder?.clearBuffer?.();
       }
@@ -140,7 +150,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     // if the error was noticed AFTER the recorder was already imported....
     if (this.recorder && this.initialized) {
       if (!this.agentRef.runtime.isRecording) this.recorder.startRecording(_constants.TRIGGERS.SWITCH_TO_FULL, this.mode); // off --> full
-      this.syncWithSessionManager({
+      this.#writeToStorage({
         sessionReplayMode: this.mode
       });
     } else {
@@ -172,35 +182,35 @@ class Aggregate extends _aggregateBase.AggregateBase {
     this.timeKeeper = timeKeeper;
     if (this.recorder?.trigger === _constants.TRIGGERS.API && this.agentRef.runtime.isRecording) {
       this.mode = _constants2.MODE.FULL;
-    } else if (!session.isNew && !ignoreSession) {
+    } else if (session.state.sessionReplayMode !== null && !ignoreSession) {
       // inherit the mode of the existing session
       this.mode = session.state.sessionReplayMode;
     } else {
       // The session is new... determine the mode the new session should start in
       this.mode = srMode;
     }
-    // If off, then don't record (early return)
-    if (this.mode === _constants2.MODE.OFF) return;
-    try {
-      /** will return a recorder instance if already imported, otherwise, will fetch the recorder and initialize it */
-      this.recorder ??= await this.instrumentClass.importRecorder();
-    } catch (err) {
-      /** if the recorder fails to import, abort the feature */
-      return this.abort(_constants.ABORT_REASONS.IMPORT, err);
-    }
+    if (this.mode !== _constants2.MODE.OFF) {
+      try {
+        /** will return a recorder instance if already imported, otherwise, will fetch the recorder and initialize it */
+        this.recorder ??= await this.instrumentClass.importRecorder();
+      } catch (err) {
+        /** if the recorder fails to import, abort the feature */
+        return this.abort(_constants.ABORT_REASONS.IMPORT, err);
+      }
 
-    // If an error was noticed before the mode could be set (like in the early lifecycle of the page), immediately set to FULL mode
-    if (this.mode === _constants2.MODE.ERROR && this.instrumentClass.errorNoticed) {
-      this.mode = _constants2.MODE.FULL;
-    }
+      // If an error was noticed before the mode could be set (like in the early lifecycle of the page), immediately set to FULL mode
+      if (this.mode === _constants2.MODE.ERROR && this.instrumentClass.errorNoticed) {
+        this.mode = _constants2.MODE.FULL;
+      }
 
-    // FULL mode records AND reports from the beginning, while ERROR mode only records (but does not report).
-    // ERROR mode will do this until an error is thrown, and then switch into FULL mode.
-    // The makeHarvestPayload should ensure that no payload is returned if we're not in FULL mode...
+      // FULL mode records AND reports from the beginning, while ERROR mode only records (but does not report).
+      // ERROR mode will do this until an error is thrown, and then switch into FULL mode.
+      // The makeHarvestPayload should ensure that no payload is returned if we're not in FULL mode...
 
-    await this.prepUtils();
-    if (!this.agentRef.runtime.isRecording) this.recorder.startRecording(trigger, this.mode);
-    this.syncWithSessionManager({
+      await this.prepUtils();
+      if (!this.agentRef.runtime.isRecording) this.recorder.startRecording(trigger, this.mode);
+    }
+    this.#writeToStorage({
       sessionReplayMode: this.mode
     });
   }
@@ -247,7 +257,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
       this.abort(_constants.ABORT_REASONS.TOO_BIG, len);
       return;
     }
-    if (!this.agentRef.runtime.session.state.sessionReplaySentFirstChunk) this.syncWithSessionManager({
+    if (!this.agentRef.runtime.session.state.sessionReplaySentFirstChunk) this.#writeToStorage({
       sessionReplaySentFirstChunk: true
     });
     this.recorder.clearBuffer();
@@ -310,7 +320,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     return {
       qs: {
         browser_monitoring_key: this.agentRef.info.licenseKey,
-        type: 'SessionReplay',
+        type: _events.EVENT_TYPES.SR,
         app_id: this.agentRef.info.applicationID,
         protocol_version: '0',
         timestamp: firstTimestamp,
@@ -376,7 +386,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     if (forceHarvest) this.agentRef.runtime.harvester.triggerHarvestFor(this);
     this.mode = _constants2.MODE.OFF;
     this.recorder?.stopRecording?.();
-    this.syncWithSessionManager({
+    this.#writeToStorage({
       sessionReplayMode: this.mode
     });
   }
@@ -388,13 +398,13 @@ class Aggregate extends _aggregateBase.AggregateBase {
     this.blocked = true;
     this.mode = _constants2.MODE.OFF;
     this.recorder?.stopRecording?.();
-    this.syncWithSessionManager({
+    this.#writeToStorage({
       sessionReplayMode: this.mode
     });
     this.recorder?.clearTimestamps?.();
     while (this.recorder?.getEvents().events.length) this.recorder?.clearBuffer?.();
   }
-  syncWithSessionManager(state = {}) {
+  #writeToStorage(state = {}) {
     if (this.isSessionTrackingEnabled) {
       this.agentRef.runtime.session.write(state);
     }

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

@@ -11,9 +11,10 @@ var _storage = require("./trace/storage");
 var _encode = require("../../../common/url/encode");
 var _runtime = require("../../../common/constants/runtime");
 var _constants2 = require("../../../common/session/constants");
-var _traverse = require("../../../common/util/traverse");
+var _obfuscate = require("../../../common/util/obfuscate");
 var _cleanUrl = require("../../../common/url/clean-url");
 var _console = require("../../../common/util/console");
+var _events = require("../../../common/constants/events");
 /**
  * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -27,6 +28,9 @@ class Aggregate extends _aggregateBase.AggregateBase {
     super(agentRef, _constants.FEATURE_NAME);
     this.harvestOpts.raw = true;
 
+    // Create obfuscator for session trace nodes
+    this.obfuscator = new _obfuscate.Obfuscator(agentRef, _events.EVENT_TYPES.ST);
+
     /** Tied to the entitlement flag response from BCS.  Will short circuit operations of the agg if false  */
     this.entitled = undefined;
     /** A flag used to decide if the 30 node threshold should be ignored on the first harvest to ensure sending on the first payload */
@@ -43,8 +47,10 @@ class Aggregate extends _aggregateBase.AggregateBase {
   /** Sets up event listeners, and initializes this module to run in the correct "mode".  Can be triggered from a few places, but makes an effort to only set up listeners once */
   initialize(stMode, stEntitled, ignoreSession) {
     this.entitled ??= stEntitled;
-    if (!this.entitled) this.blocked = true;
-    if (this.blocked) return this.deregisterDrain();
+    if (!this.entitled) {
+      this.abort(_constants.ABORT_REASONS.ENTITLEMENTS);
+      return this.deregisterDrain();
+    }
     this.timeKeeper ??= this.agentRef.runtime.timeKeeper;
     if (!this.initialized) {
       this.initialized = true;
@@ -54,7 +60,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
       // 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, () => {
         if (this.blocked) return;
-        this.abort(1);
+        this.abort(_constants.ABORT_REASONS.RESET);
       });
       // 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
@@ -63,7 +69,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
         // 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' && sessionState.sessionTraceMode === _constants2.MODE.OFF) this.abort(2);
+        if (this.sessionId !== sessionState.value || eventType === 'cross-tab' && sessionState.sessionTraceMode === _constants2.MODE.OFF) this.abort(_constants.ABORT_REASONS.CROSS_TAB);
       });
       if (typeof PerformanceNavigationTiming !== 'undefined' && _runtime.globalScope.performance?.getEntriesByType('navigation')?.length > 0) {
         this.traceStorage.storeTiming(_runtime.globalScope.performance.getEntriesByType('navigation')[0]);
@@ -74,30 +80,30 @@ class Aggregate extends _aggregateBase.AggregateBase {
 
     /** 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.agentRef.runtime.session.isNew && !ignoreSession) this.mode = this.agentRef.runtime.session.state.sessionTraceMode;else this.mode = stMode;
-
-    /** 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 this.deregisterDrain();
-
-    /** The handlers set up by the Inst file */
-    (0, _registerHandler.registerHandler)('bst', (...args) => this.traceStorage.storeEvent(...args), this.featureName, this.ee);
-    (0, _registerHandler.registerHandler)('bstResource', (...args) => this.traceStorage.storeResources(...args), this.featureName, this.ee);
-    (0, _registerHandler.registerHandler)('bstHist', (...args) => this.traceStorage.storeHist(...args), this.featureName, this.ee);
-    (0, _registerHandler.registerHandler)('bstXhrAgg', (...args) => this.traceStorage.storeXhrAgg(...args), this.featureName, this.ee);
-    (0, _registerHandler.registerHandler)('bstApi', (...args) => this.traceStorage.storeNode(...args), this.featureName, this.ee);
-    (0, _registerHandler.registerHandler)('trace-jserror', (...args) => this.traceStorage.storeErrorAgg(...args), this.featureName, this.ee);
-    (0, _registerHandler.registerHandler)('pvtAdded', (...args) => this.traceStorage.processPVT(...args), this.featureName, this.ee);
-    if (this.mode !== _constants2.MODE.FULL) {
-      /** A separate handler for noticing errors, and switching to "full" mode if running in "error" mode */
-      (0, _registerHandler.registerHandler)('trace-jserror', () => {
-        if (this.mode === _constants2.MODE.ERROR) this.switchToFull();
-      }, this.featureName, this.ee);
+    if (this.agentRef.runtime.session.state.sessionTraceMode !== null && !ignoreSession) this.mode = this.agentRef.runtime.session.state.sessionTraceMode;else this.mode = stMode;
+    if (this.mode !== _constants2.MODE.OFF) {
+      /** The handlers set up by the Inst file */
+      (0, _registerHandler.registerHandler)('bst', (...args) => this.traceStorage.storeEvent(...args), this.featureName, this.ee);
+      (0, _registerHandler.registerHandler)('bstResource', (...args) => this.traceStorage.storeResources(...args), this.featureName, this.ee);
+      (0, _registerHandler.registerHandler)('bstHist', (...args) => this.traceStorage.storeHist(...args), this.featureName, this.ee);
+      (0, _registerHandler.registerHandler)('bstXhrAgg', (...args) => this.traceStorage.storeXhrAgg(...args), this.featureName, this.ee);
+      (0, _registerHandler.registerHandler)('bstApi', (...args) => this.traceStorage.storeNode(...args), this.featureName, this.ee);
+      (0, _registerHandler.registerHandler)('trace-jserror', (...args) => this.traceStorage.storeErrorAgg(...args), this.featureName, this.ee);
+      (0, _registerHandler.registerHandler)('pvtAdded', (...args) => this.traceStorage.processPVT(...args), this.featureName, this.ee);
+      if (this.mode === _constants2.MODE.ERROR) {
+        /** A separate handler for noticing errors, and switching to "full" mode if running in "error" mode */
+        (0, _registerHandler.registerHandler)('trace-jserror', () => {
+          if (this.mode === _constants2.MODE.ERROR) this.switchToFull();
+        }, this.featureName, this.ee);
+      }
     }
     this.agentRef.runtime.session.write({
       sessionTraceMode: this.mode
     });
-    this.drain();
+
+    /** 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. */
+    this.mode === _constants2.MODE.OFF ? this.deregisterDrain() : this.drain();
   }
   preHarvestChecks() {
     if (this.blocked || this.mode !== _constants2.MODE.FULL) return; // only allow harvest if running in full mode
@@ -105,7 +111,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     if (!this.agentRef.runtime.session) return; // session entity is required for trace to run and continue running
     if (this.sessionId !== this.agentRef.runtime.session.state.value || this.ptid !== this.agentRef.runtime.ptid) {
       // If something unexpected happened and we somehow still got to harvesting after a session identifier changed, we should force-exit instead of harvesting:
-      this.abort(3);
+      this.abort(_constants.ABORT_REASONS.SESSION_CHANGED);
       return;
     }
     return true;
@@ -113,7 +119,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
   serializer(stns) {
     if (!stns.length) return; // there are no processed nodes
     this.everHarvested = true;
-    return (0, _traverse.applyFnToProps)(stns, this.obfuscator.obfuscateString.bind(this.obfuscator), 'string');
+    return this.obfuscator.traverseAndObfuscateEvents(stns);
   }
   queryStringsBuilder(stns) {
     const firstSessionHarvest = !this.agentRef.runtime.session.state.traceHarvestStarted;
@@ -190,8 +196,8 @@ class Aggregate extends _aggregateBase.AggregateBase {
   }
 
   /** Stop running for the remainder of the page lifecycle */
-  abort(code) {
-    (0, _console.warn)(60, code);
+  abort(reason = {}) {
+    (0, _console.warn)(60, reason.message);
     this.blocked = true;
     this.mode = _constants2.MODE.OFF;
     this.agentRef.runtime.session.write({

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

@@ -3,10 +3,10 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.START = exports.RESOURCE = exports.PUSH_STATE = exports.MAX_NODES_PER_HARVEST = exports.FN_START = exports.FN_END = exports.FEATURE_NAME = exports.ERROR_MODE_SECONDS_WINDOW = exports.END = exports.BST_RESOURCE = void 0;
+exports.START = exports.RESOURCE = exports.PUSH_STATE = exports.MAX_NODES_PER_HARVEST = exports.FN_START = exports.FN_END = exports.FEATURE_NAME = exports.ERROR_MODE_SECONDS_WINDOW = exports.END = exports.BST_RESOURCE = exports.ABORT_REASONS = void 0;
 var _features = require("../../loaders/features/features");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
@@ -19,4 +19,18 @@ const FN_START = exports.FN_START = 'fn' + START;
 const FN_END = exports.FN_END = 'fn' + END;
 const PUSH_STATE = exports.PUSH_STATE = 'pushState';
 const MAX_NODES_PER_HARVEST = exports.MAX_NODES_PER_HARVEST = 1000;
-const ERROR_MODE_SECONDS_WINDOW = exports.ERROR_MODE_SECONDS_WINDOW = 30 * 1000; // sliding window of nodes to track when simply monitoring (but not harvesting) in error mode
+const ERROR_MODE_SECONDS_WINDOW = exports.ERROR_MODE_SECONDS_WINDOW = 30 * 1000; // sliding window of nodes to track when simply monitoring (but not harvesting) in error mode
+const ABORT_REASONS = exports.ABORT_REASONS = {
+  CROSS_TAB: {
+    message: 'Session Entity was set to OFF on another tab'
+  },
+  ENTITLEMENTS: {
+    message: 'Session Trace is not allowed and will not be started'
+  },
+  RESET: {
+    message: 'Session was reset'
+  },
+  SESSION_CHANGED: {
+    message: 'Session identifier changed unexpectedly'
+  }
+};