@newrelic/browser-agent 1.312.1-rc.3 → 1.312.1-rc.5

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

@@ -17,7 +17,7 @@ exports.VERSION = exports.RRWEB_VERSION = exports.RRWEB_PACKAGE_NAME = exports.D
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.312.1-rc.3";
+const VERSION = exports.VERSION = "1.312.1-rc.5";
 
 /**
  * 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.RRWEB_PACKAGE_NAME = exports.D
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.312.1-rc.3";
+const VERSION = exports.VERSION = "1.312.1-rc.5";
 
 /**
  * Exposes the build type of the agent

package/dist/cjs/common/timing/time-keeper.js

@@ -4,10 +4,13 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.TimeKeeper = void 0;
+var _constants = require("../../features/metrics/constants");
 var _runtime = require("../constants/runtime");
 var _monkeyPatched = require("../util/monkey-patched");
+var _handle = require("../event-emitter/handle");
+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
  */
 
@@ -42,11 +45,31 @@ class TimeKeeper {
    * @type {boolean}
    */
   #ready = false;
+  #reportedDrift = false;
   constructor(sessionObj) {
     this.#session = sessionObj;
     this.processStoredDiff();
     (0, _monkeyPatched.isNative)(performance.now, Date.now); // will warn the user if these are not native functions.  We need these to be native for time in the agent to be accurate in general.
   }
+  #detectDrift() {
+    if (this.#reportedDrift) return;
+    try {
+      // Drift detection: measures if performance.now() and Date.now() have become desynchronized
+      // This can happen when a machine sleeps and the performance timer freezes while Date continues
+      // this can also happen when a user sets their clock forward during the page lifecycle,
+      // but we have no way of distinguishing that from actual clock drift so we will just treat it as drift.
+      // In either case, the performance timestamps would be inaccurate at that point so we want to detect and report a count of it.
+      // We only detect positive drift (performance clock falling behind Date clock)
+      // Note: localTimeDiff (server time offset) is NOT part of drift - that's a legitimate offset
+      const drift = Date.now() - _runtime.originTime - performance.now();
+      if (drift > 1000) {
+        this.#reportedDrift = true;
+        (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['Generic/TimeKeeper/ClockDrift/Detected', drift], undefined, _features.FEATURE_NAMES.metrics, this.#session.agentRef.ee);
+      }
+    } catch (err) {
+      // Silently ignore drift detection errors to avoid breaking normal operation
+    }
+  }
   get ready() {
     return this.#ready;
   }
@@ -91,6 +114,7 @@ class TimeKeeper {
    * @returns {number} Corrected unix/epoch timestamp
    */
   convertRelativeTimestamp(relativeTime) {
+    this.#detectDrift();
     return _runtime.originTime + relativeTime;
   }
 
@@ -101,6 +125,7 @@ class TimeKeeper {
    * @returns {number}
    */
   convertAbsoluteTimestamp(timestamp) {
+    this.#detectDrift();
     return timestamp - _runtime.originTime;
   }
 
@@ -110,6 +135,7 @@ class TimeKeeper {
    * @return {number} Corrected unix/epoch timestamp
    */
   correctAbsoluteTimestamp(timestamp) {
+    this.#detectDrift();
     return timestamp - this.#localTimeDiff;
   }
 
@@ -119,6 +145,7 @@ class TimeKeeper {
    * @returns {number}
    */
   correctRelativeTimestamp(relativeTime) {
+    this.#detectDrift();
     return this.correctAbsoluteTimestamp(this.convertRelativeTimestamp(relativeTime));
   }
 

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

@@ -11,7 +11,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.312.1-rc.3";
+export const VERSION = "1.312.1-rc.5";
 
 /**
  * Exposes the build type of the agent

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

@@ -11,7 +11,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.312.1-rc.3";
+export const VERSION = "1.312.1-rc.5";
 
 /**
  * Exposes the build type of the agent

package/dist/esm/common/timing/time-keeper.js

@@ -1,9 +1,12 @@
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
+import { SUPPORTABILITY_METRIC_CHANNEL } from '../../features/metrics/constants';
 import { originTime } from '../constants/runtime';
 import { isNative } from '../util/monkey-patched';
+import { handle } from '../event-emitter/handle';
+import { FEATURE_NAMES } from '../../loaders/features/features';
 
 /**
  * Class used to adjust the timestamp of harvested data to New Relic server time. This
@@ -36,11 +39,31 @@ export class TimeKeeper {
    * @type {boolean}
    */
   #ready = false;
+  #reportedDrift = false;
   constructor(sessionObj) {
     this.#session = sessionObj;
     this.processStoredDiff();
     isNative(performance.now, Date.now); // will warn the user if these are not native functions.  We need these to be native for time in the agent to be accurate in general.
   }
+  #detectDrift() {
+    if (this.#reportedDrift) return;
+    try {
+      // Drift detection: measures if performance.now() and Date.now() have become desynchronized
+      // This can happen when a machine sleeps and the performance timer freezes while Date continues
+      // this can also happen when a user sets their clock forward during the page lifecycle,
+      // but we have no way of distinguishing that from actual clock drift so we will just treat it as drift.
+      // In either case, the performance timestamps would be inaccurate at that point so we want to detect and report a count of it.
+      // We only detect positive drift (performance clock falling behind Date clock)
+      // Note: localTimeDiff (server time offset) is NOT part of drift - that's a legitimate offset
+      const drift = Date.now() - originTime - performance.now();
+      if (drift > 1000) {
+        this.#reportedDrift = true;
+        handle(SUPPORTABILITY_METRIC_CHANNEL, ['Generic/TimeKeeper/ClockDrift/Detected', drift], undefined, FEATURE_NAMES.metrics, this.#session.agentRef.ee);
+      }
+    } catch (err) {
+      // Silently ignore drift detection errors to avoid breaking normal operation
+    }
+  }
   get ready() {
     return this.#ready;
   }
@@ -85,6 +108,7 @@ export class TimeKeeper {
    * @returns {number} Corrected unix/epoch timestamp
    */
   convertRelativeTimestamp(relativeTime) {
+    this.#detectDrift();
     return originTime + relativeTime;
   }
 
@@ -95,6 +119,7 @@ export class TimeKeeper {
    * @returns {number}
    */
   convertAbsoluteTimestamp(timestamp) {
+    this.#detectDrift();
     return timestamp - originTime;
   }
 
@@ -104,6 +129,7 @@ export class TimeKeeper {
    * @return {number} Corrected unix/epoch timestamp
    */
   correctAbsoluteTimestamp(timestamp) {
+    this.#detectDrift();
     return timestamp - this.#localTimeDiff;
   }
 
@@ -113,6 +139,7 @@ export class TimeKeeper {
    * @returns {number}
    */
   correctRelativeTimestamp(relativeTime) {
+    this.#detectDrift();
     return this.correctAbsoluteTimestamp(this.convertRelativeTimestamp(relativeTime));
   }
 

package/dist/types/common/timing/time-keeper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"time-keeper.d.ts","sourceRoot":"","sources":["../../../../src/common/timing/time-keeper.js"],"names":[],"mappings":"AAOA;;;;GAIG;AACH;IA2BE,6BAIC;IAED,qBAEC;IAED,kCAEC;IAED,4BAEC;IAED;;;;;;OAMG;IACH,8BALsB,cAAc,aACf,MAAM,WACR,MAAM,gBACD,MAAM,QAqB7B;IAED;;;;;OAKG;IACH,uCAHwB,MAAM,GACjB,MAAM,CAIlB;IAED;;;;;OAKG;IACH,0CAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,oCAHqB,MAAM,GACf,MAAM,CAIjB;IAED;;;;OAIG;IACH,uCAHW,mBAAmB,GACjB,MAAM,CAIlB;IAED,+FAA+F;IAC/F,0BASC;;CACF"}
+{"version":3,"file":"time-keeper.d.ts","sourceRoot":"","sources":["../../../../src/common/timing/time-keeper.js"],"names":[],"mappings":"AAUA;;;;GAIG;AACH;IA6BE,6BAIC;IAsBD,qBAEC;IAED,kCAEC;IAED,4BAEC;IAED;;;;;;OAMG;IACH,8BALsB,cAAc,aACf,MAAM,WACR,MAAM,gBACD,MAAM,QAqB7B;IAED;;;;;OAKG;IACH,uCAHwB,MAAM,GACjB,MAAM,CAKlB;IAED;;;;;OAKG;IACH,0CAFa,MAAM,CAKlB;IAED;;;;OAIG;IACH,oCAHqB,MAAM,GACf,MAAM,CAKjB;IAED;;;;OAIG;IACH,uCAHW,mBAAmB,GACjB,MAAM,CAKlB;IAED,+FAA+F;IAC/F,0BASC;;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newrelic/browser-agent",
-  "version": "1.312.1-rc.3",
+  "version": "1.312.1-rc.5",
   "private": false,
   "author": "New Relic Browser Agent Team <browser-agent@newrelic.com>",
   "description": "New Relic Browser Agent",

package/src/common/timing/time-keeper.js

@@ -1,9 +1,12 @@
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
+import { SUPPORTABILITY_METRIC_CHANNEL } from '../../features/metrics/constants'
 import { originTime } from '../constants/runtime'
 import { isNative } from '../util/monkey-patched'
+import { handle } from '../event-emitter/handle'
+import { FEATURE_NAMES } from '../../loaders/features/features'
 
 /**
  * Class used to adjust the timestamp of harvested data to New Relic server time. This
@@ -37,12 +40,34 @@ export class TimeKeeper {
    */
   #ready = false
 
+  #reportedDrift = false
+
   constructor (sessionObj) {
     this.#session = sessionObj
     this.processStoredDiff()
     isNative(performance.now, Date.now) // will warn the user if these are not native functions.  We need these to be native for time in the agent to be accurate in general.
   }
 
+  #detectDrift () {
+    if (this.#reportedDrift) return
+    try {
+      // Drift detection: measures if performance.now() and Date.now() have become desynchronized
+      // This can happen when a machine sleeps and the performance timer freezes while Date continues
+      // this can also happen when a user sets their clock forward during the page lifecycle,
+      // but we have no way of distinguishing that from actual clock drift so we will just treat it as drift.
+      // In either case, the performance timestamps would be inaccurate at that point so we want to detect and report a count of it.
+      // We only detect positive drift (performance clock falling behind Date clock)
+      // Note: localTimeDiff (server time offset) is NOT part of drift - that's a legitimate offset
+      const drift = (Date.now() - originTime) - performance.now()
+      if (drift > 1000) {
+        this.#reportedDrift = true
+        handle(SUPPORTABILITY_METRIC_CHANNEL, ['Generic/TimeKeeper/ClockDrift/Detected', drift], undefined, FEATURE_NAMES.metrics, this.#session.agentRef.ee)
+      }
+    } catch (err) {
+      // Silently ignore drift detection errors to avoid breaking normal operation
+    }
+  }
+
   get ready () {
     return this.#ready
   }
@@ -90,6 +115,7 @@ export class TimeKeeper {
    * @returns {number} Corrected unix/epoch timestamp
    */
   convertRelativeTimestamp (relativeTime) {
+    this.#detectDrift()
     return originTime + relativeTime
   }
 
@@ -100,6 +126,7 @@ export class TimeKeeper {
    * @returns {number}
    */
   convertAbsoluteTimestamp (timestamp) {
+    this.#detectDrift()
     return timestamp - originTime
   }
 
@@ -109,6 +136,7 @@ export class TimeKeeper {
    * @return {number} Corrected unix/epoch timestamp
    */
   correctAbsoluteTimestamp (timestamp) {
+    this.#detectDrift()
     return timestamp - this.#localTimeDiff
   }
 
@@ -118,6 +146,7 @@ export class TimeKeeper {
    * @returns {number}
    */
   correctRelativeTimestamp (relativeTime) {
+    this.#detectDrift()
     return this.correctAbsoluteTimestamp(this.convertRelativeTimestamp(relativeTime))
   }