@newrelic/browser-agent 1.312.1 → 1.313.0-rc.1

package/dist/cjs/loaders/api/register-api-types.js

@@ -13,7 +13,6 @@ exports.default = void 0;
  * @property {(name: string, attributes?: object) => void} addPageAction - Add a page action for the registered entity.
  * @property {(message: string, options?: { customAttributes?: object, level?: 'ERROR' | 'TRACE' | 'DEBUG' | 'INFO' | 'WARN'}) => void} log - Capture a log for the registered entity.
  * @property {(error: Error | string, customAttributes?: object) => void} noticeError - Notice an error for the registered entity.
- * @property {(target: RegisterAPIConstructor) => RegisterAPI} register - Record a custom event for the registered entity.
  * @property {() => void} deregister - Deregister the registered entity, which blocks its use and captures end of life timings.
  * @property {(eventType: string, attributes?: Object) => void} recordCustomEvent - Record a custom event for the registered entity.
  * @property {(eventType: string, options?: {start?: number|PerformanceMark, end?: number|PerformanceMark, customAttributes?: object}) => ({start: number, end: number, duration: number, customAttributes: object})} measure - Measures a task that is recorded as a BrowserPerformance event.
@@ -27,14 +26,14 @@ exports.default = void 0;
  * @property {string} id - The unique id for the registered entity. This will be assigned to any synthesized entities.
  * @property {string} name - The readable name for the registered entity. This will be assigned to any synthesized entities.
  * @property {{[key: string]: any}} [tags] - The tags for the registered entity as key-value pairs. This will be assigned to any synthesized entities. Tags are converted to source.* attributes (e.g., {environment: 'production'} becomes source.environment: 'production').
- * @property {boolean} [isolated] - When true, each registration creates an isolated instance. When false, multiple registrations with the same id and isolated: false will share a single instance, including all custom attributes, ids, names, and metadata. Calling deregister on a shared instance will deregister it for all entities using the instance. Defaults to true.
+ * @property {RegisterAPITarget} [parent] - The parent target for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
  * @property {string} [parentId] - The parentId for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
  */
 /**
  * @typedef {Object} RegisterAPIMetadata
  * @property {Object} customAttributes - The custom attributes for the registered entity.
- * @property {RegisterAPITimings} timings - The timing metrics for the registered entity.
- * @property {RegisterAPITarget} target - The options for the registered entity.
+ * @property {Partial<RegisterAPITimings>} timings - The timing metrics for the registered entity.
+ * @property {Partial<RegisterAPITarget>} target - The options for the registered entity.
  */
 /**
  * @typedef {Object} RegisterAPITarget
@@ -42,15 +41,16 @@ exports.default = void 0;
  * @property {string} name - The name returned for the registered entity.
  * @property {{[key: string]: any}} [tags] - The tags for the registered entity as key-value pairs.
  * @property {string} [parentId] - The parentId for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
- * @property {boolean} [isolated] - When true, each registration creates an isolated instance. When false, multiple registrations with the same id and isolated: false will share a single instance, including all custom attributes, ids, names, and metadata. Calling deregister on a shared instance will deregister it for all entities using the instance. Defaults to true.
  */
 /**
  * @typedef {Object} RegisterAPITimings
  * @property {number} registeredAt - The timestamp when the registered entity was created.
  * @property {number} [reportedAt] - The timestamp when the registered entity was deregistered.
- * @property {number} fetchStart - The timestamp when the registered entity began fetching.
- * @property {number} fetchEnd - The timestamp when the registered entity finished fetching.
+ * @property {number} fetchStart - The timestamp when the registered entity began fetching (performance.start).
+ * @property {number} fetchEnd - The timestamp when the registered entity finished fetching (performance.end).
+ * @property {number} scriptStart - The timestamp when script initialization began (max of dom.start or performance.end, or performance.end if no dom.start).
+ * @property {number} scriptEnd - The timestamp when script loading completed (dom.end or registeredAt if no dom.end).
  * @property {Object} [asset] - The asset path (if found) for the registered entity.
- * @property {string} type - The type of timing associated with the registered entity, 'script' or 'link' if found with the performance resource API, 'inline' if found to be associated with the root document URL, or 'unknown' if no associated resource could be found.
+ * @property {string} type - The type of timing associated with the registered entity, 'script' or 'link' if found with the performance resource API, 'fetch' for dynamic imports, 'inline' if found to be associated with the root document URL, or 'unknown' if no associated resource could be found.
  */
 var _default = exports.default = {};

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

@@ -4,9 +4,10 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.setupRegisterAPI = setupRegisterAPI;
+exports.warnings = void 0;
 var _handle = require("../../common/event-emitter/handle");
 var _console = require("../../common/util/console");
-var _v = require("../../common/util/v2");
+var _utils = require("../../common/v2/utils");
 var _features = require("../features/features");
 var _now = require("../../common/timing/now");
 var _constants = require("../../features/metrics/constants");
@@ -19,7 +20,7 @@ var _invoke = require("../../common/util/invoke");
 var _measure = require("./measure");
 var _recordCustomEvent = require("./recordCustomEvent");
 var _pageVisibility = require("../../common/window/page-visibility");
-var _scriptTracker = require("../../common/util/script-tracker");
+var _scriptTracker = require("../../common/v2/script-tracker");
 var _uniqueId = require("../../common/ids/unique-id");
 /**
  * Copyright 2020-2026 New Relic, Inc. All rights reserved.
@@ -32,6 +33,23 @@ var _uniqueId = require("../../common/ids/unique-id");
 
 const PROTECTED_KEYS = ['name', 'id', 'type'];
 
+/**
+ * Map of API methods to their names (prevents minification from breaking method name references)
+ * @private
+ */
+const METHOD_NAMES = new Map([[_addPageAction.addPageAction, 'addPageAction'], [_log.log, 'log'], [_measure.measure, 'measure'], [_noticeError.noticeError, 'noticeError'], [_recordCustomEvent.recordCustomEvent, 'recordCustomEvent']]);
+
+/**
+ * Warning functions that only fire once - can be reset in tests
+ * @private
+ */
+const warnings = exports.warnings = {
+  experimental: (0, _invoke.single)(() => (0, _console.warn)(54, 'newrelic.register')),
+  disabled: (0, _invoke.single)(() => (0, _console.warn)(55)),
+  invalidTarget: (0, _invoke.single)(target => (0, _console.warn)(48, target)),
+  deregistered: (0, _invoke.single)(() => (0, _console.warn)(68))
+};
+
 /**
  * @experimental
  * IMPORTANT: This feature is being developed for use internally and is not in a public-facing production-ready state.
@@ -48,38 +66,41 @@ function setupRegisterAPI(agent) {
  * Also conducts certain side-effects, such as harvesting a PageView event when triggered and gathering metadata for the registered entity.
  * @param {Object} agentRef the reference to the base agent instance
  * @param {import('./register-api-types').RegisterAPIConstructor} target
- * @param {import('./register-api-types').RegisterAPIConstructor} [parent]
  * @returns {RegisterAPI} the api object to be returned from the register api method
  */
-function register(agentRef, target, parent) {
-  (0, _console.warn)(54, 'newrelic.register');
+function register(agentRef, target) {
+  warnings.experimental();
   target ||= {};
   target.instance = (0, _uniqueId.generateRandomHexString)(8);
-  target.type = _v.V2_TYPES.MFE;
+  target.type = _utils.V2_TYPES.MFE;
   target.licenseKey ||= agentRef.info.licenseKey; // will inherit the license key from the container agent if not provided for brevity. A future state may dictate that we need different license keys to do different things.
   target.blocked = false;
   if (typeof target.tags !== 'object' || target.tags === null || Array.isArray(target.tags)) target.tags = {};
-  target.parent = parent || {
+  target.parent ??= {
     get id() {
       return agentRef.runtime.appMetadata.agents[0].entityGuid;
     },
     // getter because this is asyncronously set
-    type: _v.V2_TYPES.BA
+    type: _utils.V2_TYPES.BA
   };
   const timings = (0, _scriptTracker.findScriptTimings)();
   const attrs = {};
-  Object.defineProperty(target, 'attributes', {
-    get() {
-      return {
-        ...attrs,
-        'source.id': target.id,
-        'source.name': target.name,
-        'source.type': target.type,
-        'parent.type': target.parent?.type || _v.V2_TYPES.BA,
-        'parent.id': target.parent?.id
-      };
-    }
-  });
+
+  // Only define attributes getter if it doesn't already exist
+  if (!Object.prototype.hasOwnProperty.call(target, 'attributes')) {
+    Object.defineProperty(target, 'attributes', {
+      get() {
+        return {
+          ...attrs,
+          'source.id': target.id,
+          'source.name': target.name,
+          'source.type': target.type,
+          'parent.type': target.parent?.type || _utils.V2_TYPES.BA,
+          'parent.id': target.parent?.id
+        };
+      }
+    });
+  }
 
   // Process tags object and add to attrs, excluding protected keys
   Object.entries(target.tags).forEach(([key, value]) => {
@@ -87,23 +108,11 @@ function register(agentRef, target, parent) {
       attrs["source.".concat(key)] = value;
     }
   });
-  target.isolated ??= true;
 
   /** @type {Function} a function that is set and reports when APIs are triggered -- warns the customer of the invalid state  */
   let invalidApiResponse = () => {};
   /** @type {Array} the array of registered target APIs */
   const registeredEntities = agentRef.runtime.registeredEntities;
-  if (!target.isolated) {
-    /** if we have already registered this non-isolated target, go ahead and re-use it */
-    const sharedEntity = registeredEntities.find(({
-      metadata: {
-        target: {
-          id
-        }
-      }
-    }) => id === target.id && !target.isolated);
-    if (sharedEntity) return sharedEntity;
-  }
 
   /**
    * Block the API, and supply a warning function to display a message to end users
@@ -118,8 +127,8 @@ function register(agentRef, target, parent) {
   }
 
   /** primary cases that can block the register API from working at init time */
-  if (!agentRef.init.api.allow_registered_children) block((0, _invoke.single)(() => (0, _console.warn)(55)));
-  if (!hasValidValue(target.id) || !hasValidValue(target.name)) block((0, _invoke.single)(() => (0, _console.warn)(48, target)));
+  if (!agentRef.init.api.register.enabled) block(warnings.disabled);
+  if (!hasValidValue(target.id) || !hasValidValue(target.name)) block(() => warnings.invalidTarget(target));
 
   /** @type {RegisterAPI} */
   const api = {
@@ -130,7 +139,7 @@ function register(agentRef, target, parent) {
     deregister: () => {
       /** note: blocking this instance will disable access for all entities sharing the instance, and will invalidate it from the v2 checks */
       reportTimings();
-      block((0, _invoke.single)(() => (0, _console.warn)(68)));
+      block(warnings.deregistered);
     },
     log: (message, options = {}) => report(_log.log, [message, {
       ...options,
@@ -150,7 +159,6 @@ function register(agentRef, target, parent) {
       ...attrs,
       ...attributes
     }, agentRef], target),
-    register: (target = {}) => report(register, [agentRef, target], api.metadata.target),
     recordCustomEvent: (eventType, attributes = {}) => report(_recordCustomEvent.recordCustomEvent, [eventType, {
       ...attrs,
       ...attributes
@@ -192,20 +200,24 @@ function register(agentRef, target, parent) {
     // only ever report the timings the first time this is called
     if (timings.reportedAt) return;
     timings.reportedAt = (0, _now.now)();
+    const timeToFetch = timings.fetchEnd - timings.fetchStart; // fetchStart to fetchEnd
+    const timeToExecute = timings.scriptEnd - timings.scriptStart; // scriptStart to scriptEnd
     api.recordCustomEvent('MicroFrontEndTiming', {
       assetUrl: timings.asset,
       // the url of the script that was registered, or undefined if it could not be determined (inline or no match)
       assetType: timings.type,
       // the type of asset that was associated with the timings, one of 'script', 'link' (if preloaded and found in the resource timing buffer), 'preload' (if preloaded but not found in the resource timing buffer), or "unknown" if it could not be determined
-      timeToLoad: timings.registeredAt - timings.fetchStart,
-      // fetchStart to registeredAt
+      timeAlive: timings.reportedAt - timings.registeredAt,
+      // registeredAt to reportedAt
       timeToBeRequested: timings.fetchStart,
       // origin to fetchStart
-      timeToFetch: timings.fetchEnd - timings.fetchStart,
+      timeToExecute,
+      // scriptStart to scriptEnd
+      timeToFetch,
       // fetchStart to fetchEnd
-      timeToRegister: timings.registeredAt - timings.fetchEnd,
-      // fetchEnd to registeredAt
-      timeAlive: timings.reportedAt - timings.registeredAt // registeredAt to reportedAt
+      timeToLoad: timeToFetch + timeToExecute,
+      // fetch time and script time together
+      timeToRegister: timings.registeredAt // timestamp when register() was called
     });
   }
 
@@ -222,7 +234,7 @@ function register(agentRef, target, parent) {
 
   /**
      * The reporter method that will be used to report the data to the container agent's API method. If invalid, will log a warning and not execute.
-     * If the api.duplicate_registered_data configuration value is set to true, the data will be reported to BOTH the container and the external target
+     * If the api.register.duplicate_data_to_container configuration value is set to true, the data will be reported to BOTH the container and the external target
      * @param {*} methodToCall the container agent's API method to call
      * @param {*} args the arguments to supply to the container agent's API method
      * @param {string} target the target to report the data to. If undefined, will report to the container agent's target.
@@ -233,7 +245,8 @@ function register(agentRef, target, parent) {
     if (isBlocked() && methodToCall !== register) return;
     /** set the timestamp before the async part of waiting for the rum response for better accuracy */
     const timestamp = (0, _now.now)();
-    (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ["API/register/".concat(methodToCall.name, "/called")], undefined, _features.FEATURE_NAMES.metrics, agentRef.ee);
+    const methodName = METHOD_NAMES.get(methodToCall) || 'unknown';
+    (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ["API/register/".concat(methodName, "/called")], undefined, _features.FEATURE_NAMES.metrics, agentRef.ee);
     try {
       return methodToCall(...args, target, timestamp); // always report to target
     } catch (err) {

package/dist/esm/common/config/init-types.js

@@ -12,8 +12,9 @@
  * @property {boolean} [ajax.enabled] - Turn on/off the ajax feature (on by default).
  * @property {boolean} [ajax.autoStart] - If true, the agent will automatically start the ajax feature. Otherwise, it will be in a deferred state until the `start` API method is called.
  * @property {Object} [api]
- * @property {boolean} [api.allow_registered_children] - If true, the agent will allow registered children to be sent to the server.
- * @property {boolean} [api.duplicate_registered_data] - If true, the agent will capture registered child data to the main agent as well as the registered child.
+ * @property {Object} [api.register]
+ * @property {boolean} [api.register.enabled] - If true, the agent will allow registered children to be sent to the server.
+ * @property {boolean} [api.register.duplicate_data_to_container] - If true, the agent will capture registered child data to the main agent as well as the registered child.
  * @property {Object} [distributed_tracing]
  * @property {boolean} [distributed_tracing.enabled] - If true, distributed tracing headers will be added to outgoing requests. Requires ajax feature to be running.
  * @property {boolean} [distributed_tracing.exclude_newrelic_header]

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

@@ -21,7 +21,7 @@ const InitModelFn = () => {
   const hiddenState = {
     feature_flags: [],
     experimental: {
-      allow_registered_children: false,
+      register: false,
       resources: false
     },
     mask_selector: '*',
@@ -54,13 +54,15 @@ const InitModelFn = () => {
       autoStart: true
     },
     api: {
-      get allow_registered_children() {
-        return hiddenState.feature_flags.includes(FEATURE_FLAGS.REGISTER) || hiddenState.experimental.allow_registered_children;
-      },
-      set allow_registered_children(val) {
-        hiddenState.experimental.allow_registered_children = val;
-      },
-      duplicate_registered_data: false
+      register: {
+        get enabled() {
+          return hiddenState.feature_flags.includes(FEATURE_FLAGS.REGISTER) || hiddenState.experimental.register;
+        },
+        set enabled(val) {
+          hiddenState.experimental.register = val;
+        },
+        duplicate_data_to_container: false
+      }
     },
     browser_consent_mode: {
       enabled: false

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

@@ -11,7 +11,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.312.1";
+export const VERSION = "1.313.0-rc.1";
 
 /**
  * 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";
+export const VERSION = "1.313.0-rc.1";
 
 /**
  * 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/esm/common/util/short-circuit.js

@@ -0,0 +1,6 @@
+/**
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/** A special error used to short-circuit the error processing pipeline */
+export class ShortCircuit extends Error {}

package/dist/esm/common/util/submit-data.js

@@ -1,5 +1,5 @@
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
@@ -62,8 +62,7 @@ export function xhrFetch({
   return fetch(url, {
     headers: objHeaders,
     method,
-    body,
-    credentials: 'include'
+    body
   });
 }
 
@@ -89,12 +88,6 @@ export function xhr({
 }) {
   const request = new XMLHttpRequest();
   request.open(method, url, !sync);
-  try {
-    // Set cookie
-    if ('withCredentials' in request) request.withCredentials = true;
-  } catch (e) {
-    // do nothing
-  }
   headers.forEach(header => {
     request.setRequestHeader(header.key, header.value);
   });

package/dist/esm/common/v2/script-correlation.js

@@ -0,0 +1,43 @@
+/**
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Represents script correlation data combining DOM and Performance API information
+ */
+export class ScriptCorrelation {
+  /** @type {CorrelationTiming} [dom] - DOM-related information */
+  dom = new CorrelationTiming();
+  /** @type {CorrelationTiming} [performance] - Performance-related information */
+  performance = new CorrelationTiming();
+
+  /**
+   * Creates a new ScriptCorrelation instance
+   * @param {string} url - The cleaned URL of the script
+   */
+  constructor(url) {
+    /** @type {string} The cleaned URL of the script */
+    this.url = url;
+  }
+
+  /**
+   * Gets the script timing, using DOM timings if available, otherwise falling back to performance timings or registeredAt as appropriate. This is used to provide the most accurate script timing possible for registered entities.
+   * @returns {{start: number, end: number}
+   */
+  get script() {
+    const start = Math.max(this.dom.start, this.performance.end);
+    const end = Math.max(this.dom.end, this.performance.end, start);
+    return {
+      start,
+      end
+    };
+  }
+}
+class CorrelationTiming {
+  /** @type {number} [start] - The startTime from the performance entry */
+  start = 0;
+  /** @type {number} [end] - The responseEnd from the performance entry */
+  end = 0;
+  /** @type {*} [value] - The entry value */
+  value = undefined;
+}