@newrelic/browser-agent 1.309.0 → 1.310.0

package/src/common/wrap/wrap-history.js

@@ -1,11 +1,11 @@
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
 /**
  * @file Wraps `pushState` and `replaceState` methods of `window.history` object for instrumentation.
- * This module is used by: session_trace, spa.
+ * This module is used by: session_trace, soft_navigations.
  */
 import { ee as globalEE } from '../event-emitter/contextual-ee'
 import { createWrapperWithEmitter as wfn } from './wrap-function'

package/src/common/wrap/wrap-logger.js

@@ -1,11 +1,11 @@
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
 /**
  * @file Wraps native timeout and interval methods for instrumentation.
- * This module is used by: jserrors, spa.
+ * This module is used by: logging.
  */
 
 import { ee as baseEE, contextId } from '../event-emitter/contextual-ee'

package/src/common/wrap/wrap-xhr.js

@@ -1,11 +1,11 @@
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
 /**
  * @file Wraps AJAX (XHR) related methods for instrumentation.
- * This module is used by: ajax, jserrors, spa.
+ * This module is used by: ajax, jserrors.
  */
 
 import { wrapEvents } from './wrap-events'

package/src/features/jserrors/aggregate/compute-stack-trace.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
  */
 
@@ -58,15 +58,10 @@
 // ex.name = ReferenceError
 import { formatStackTrace } from './format-stack-trace'
 import { canonicalizeUrl } from '../../../common/url/canonicalize-url'
+import { chrome, chromeEval, classNameRegex, gecko, ieEval } from '../../../common/util/browser-stack-matchers'
 
 var debug = false
 
-var classNameRegex = /function (.+?)\s*\(/
-var chrome = /^\s*at (?:((?:\[object object\])?(?:[^(]*\([^)]*\))*[^()]*(?: \[as \S+\])?) )?\(?((?:file|http|https|chrome-extension):.*?)?:(\d+)(?::(\d+))?\)?\s*$/i
-var gecko = /^\s*(?:(\S*|global code)(?:\(.*?\))?@)?((?:file|http|https|chrome|safari-extension).*?):(\d+)(?::(\d+))?\s*$/i
-var chromeEval = /^\s*at .+ \(eval at \S+ \((?:(?:file|http|https):[^)]+)?\)(?:, [^:]*:\d+:\d+)?\)$/i
-var ieEval = /^\s*at Function code \(Function code:\d+:\d+\)\s*/i
-
 /**
  * Represents an error with a stack trace.
  * @typedef {Object} StackInfo

package/src/features/page_view_event/aggregate/initialized-features.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
  */
 import { FEATURE_NAMES } from '../../../loaders/features/features'
@@ -27,7 +27,6 @@ export function getActivatedFeaturesFlags (agentId) {
         case FEATURE_NAMES.sessionTrace:
           flagArr.push('stn'); break
         case FEATURE_NAMES.softNav:
-        case FEATURE_NAMES.spa:
           flagArr.push('spa'); break
       }
     })

package/src/index.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
  */
 export { Agent } from './loaders/agent'
@@ -16,4 +16,4 @@ export { PageViewEvent } from './features/page_view_event'
 export { PageViewTiming } from './features/page_view_timing'
 export { SessionTrace } from './features/session_trace'
 export { SessionReplay } from './features/session_replay'
-export { Spa } from './features/spa'
+export { SoftNav } from './features/soft_navigations'

package/src/interfaces/registered-entity.js

@@ -21,6 +21,7 @@ export class RegisteredEntity {
   /** @type {RegisterAPIMetadata} */
   metadata = {
     target: {},
+    timings: {},
     customAttributes: {}
   }
 
@@ -87,7 +88,7 @@ export class RegisteredEntity {
    * Measures a task that is recorded as a BrowserPerformance event.
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/measure/}
    * @param {string} name The name of the task
-   * @param {{start: number, end: number, duration: number, customAttributes: object}} [options] An object used to control the way the measure API operates
+   * @param {{start?: number|PerformanceMark, end?: number|PerformanceMark, customAttributes?: object}} [options] An object used to control the way the measure API operates
    * @returns {{start: number, end: number, duration: number, customAttributes: object}} Measurement details
    */
   measure (name, options) {

package/src/loaders/agent.js

@@ -97,10 +97,6 @@ export class Agent extends AgentBase {
       featuresToStart.sort((a, b) => featurePriority[a.featureName] - featurePriority[b.featureName])
       featuresToStart.forEach(InstrumentCtor => {
         if (!enabledFeatures[InstrumentCtor.featureName] && InstrumentCtor.featureName !== FEATURE_NAMES.pageViewEvent) return // PVE is required to run even if it's marked disabled
-        if (InstrumentCtor.featureName === FEATURE_NAMES.spa) {
-          warn(67)
-          return // Skip old SPA
-        }
 
         const dependencies = getFeatureDependencyNames(InstrumentCtor.featureName)
         const missingDependencies = dependencies.filter(featName => !(featName in this.features)) // any other feature(s) this depends on should've been initialized on prior iterations by priority order

package/src/loaders/api/register-api-types.js

@@ -11,7 +11,7 @@
  * @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, end: number, duration: number, customAttributes: object}) => ({start: number, end: number, duration: number, customAttributes: object})} measure - Measures a task that is recorded as a BrowserPerformance event.
+ * @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.
  * @property {(value: string | null) => void} setApplicationVersion - Add an application.version attribute to all outgoing data for the registered entity.
  * @property {(name: string, value: string | number | boolean | null, persist?: boolean) => void} setCustomAttribute - Add a custom attribute to outgoing data for the registered entity.
  * @property {(value: string | null, resetSession?: boolean) => void} setUserId - Add an enduser.id attribute to all outgoing API data for the registered entity.  Note: a registered entity will not be able to initiate a session reset.  It must be done from the main agent.
@@ -30,13 +30,27 @@
 /**
  * @typedef {Object} RegisterAPIMetadata
  * @property {Object} customAttributes - The custom attributes for the registered entity.
- * @property {Object} target - The options for the registered entity.
- * @property {string} [target.licenseKey] - The license key for the registered entity. If none was supplied, it will assume the license key from the main agent.
- * @property {string} target.id - The ID for the registered entity.
- * @property {string} target.name - The name returned for the registered entity.
- * @property {{[key: string]: any}} [target.tags] - The tags for the registered entity as key-value pairs.
- * @property {string} [target.parentId] - The parentId for the registered entity. If none was supplied, it will assume the entity guid from the main agent.
- * @property {boolean} [target.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 {RegisterAPITimings} timings - The timing metrics for the registered entity.
+ * @property {RegisterAPITarget} target - The options for the registered entity.
+ */
+
+/**
+ * @typedef {Object} RegisterAPITarget
+ * @property {string} id - The ID for the registered entity.
+ * @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 {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.
  */
 
 export default {}

package/src/loaders/api/register.js

@@ -16,6 +16,8 @@ import { noticeError } from './noticeError'
 import { single } from '../../common/util/invoke'
 import { measure } from './measure'
 import { recordCustomEvent } from './recordCustomEvent'
+import { subscribeToPageUnload } from '../../common/window/page-visibility'
+import { findScriptTimings } from '../../common/util/script-tracker'
 
 /**
  * @typedef {import('./register-api-types').RegisterAPI} RegisterAPI
@@ -52,6 +54,8 @@ function register (agentRef, target, parent) {
   target.parent = parent || {}
   if (typeof target.tags !== 'object' || target.tags === null || Array.isArray(target.tags)) target.tags = {}
 
+  const timings = findScriptTimings()
+
   const attrs = {}
 
   // Process tags object and add to attrs, excluding protected keys
@@ -96,6 +100,7 @@ function register (agentRef, target, parent) {
     addPageAction: (name, attributes = {}) => report(addPageAction, [name, { ...attrs, ...attributes }, agentRef], target),
     deregister: () => {
       /** note: blocking this instance will disable access for all entities sharing the instance, and will invalidate it from the v2 checks */
+      reportTimings()
       block(single(() => warn(68)))
     },
     log: (message, options = {}) => report(log, [message, { ...options, customAttributes: { ...attrs, ...(options.customAttributes || {}) } }, agentRef], target),
@@ -109,7 +114,8 @@ function register (agentRef, target, parent) {
     /** metadata */
     metadata: {
       customAttributes: attrs,
-      target
+      target,
+      timings
     }
   }
 
@@ -123,7 +129,30 @@ function register (agentRef, target, parent) {
   }
 
   /** only allow registered APIs to be tracked in the agent runtime */
-  if (!isBlocked()) registeredEntities.push(api)
+  if (!isBlocked()) {
+    registeredEntities.push(api)
+    subscribeToPageUnload(reportTimings)
+  }
+
+  /**
+   * Reports the gathered timings for the registered entity through a custom event to the container agent. Only reports once
+   * by checking for the presence of the reportedAt timing.
+   * @returns {void}
+   */
+  function reportTimings () {
+    // only ever report the timings the first time this is called
+    if (timings.reportedAt) return
+    timings.reportedAt = now()
+    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
+      timeToBeRequested: timings.fetchStart, // origin to fetchStart
+      timeToFetch: timings.fetchEnd - timings.fetchStart, // fetchStart to fetchEnd
+      timeToRegister: timings.registeredAt - timings.fetchEnd, // fetchEnd to registeredAt
+      timeAlive: timings.reportedAt - timings.registeredAt // registeredAt to reportedAt
+    })
+  }
 
   /**
    * Sets a value local to the registered API attrs. Will do nothing if APIs are deregistered.

package/src/loaders/api-base.js

@@ -220,7 +220,7 @@ export class ApiBase {
    * Measures a task that is recorded as a BrowserPerformance event.
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/measure/}
    * @param {string} name The name of the task
-   * @param {{start: number, end: number, duration: number, customAttributes: object}} [options] An object used to control the way the measure API operates
+   * @param {{start?: number|PerformanceMark, end?: number|PerformanceMark, customAttributes?: object}} [options] An object used to control the way the measure API operates
    * @returns {{start: number, end: number, duration: number, customAttributes: object}} Measurement details
    */
   measure (name, options) {

package/src/loaders/features/features.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
  */
 
@@ -24,8 +24,7 @@ export const FEATURE_NAMES = {
   pageViewTiming: 'page_view_timing',
   sessionReplay: 'session_replay',
   sessionTrace: 'session_trace',
-  softNav: 'soft_navigations',
-  spa: 'spa'
+  softNav: 'soft_navigations'
 }
 
 /**
@@ -37,20 +36,18 @@ export const featurePriority = {
   [FEATURE_NAMES.pageViewTiming]: 2,
   [FEATURE_NAMES.metrics]: 3,
   [FEATURE_NAMES.jserrors]: 4,
-  [FEATURE_NAMES.spa]: 5,
+  [FEATURE_NAMES.softNav]: 5,
   [FEATURE_NAMES.ajax]: 6,
   [FEATURE_NAMES.sessionTrace]: 7,
-  [FEATURE_NAMES.softNav]: 8,
-  [FEATURE_NAMES.sessionReplay]: 9,
-  [FEATURE_NAMES.logging]: 10,
-  [FEATURE_NAMES.genericEvents]: 11
+  [FEATURE_NAMES.sessionReplay]: 8,
+  [FEATURE_NAMES.logging]: 9,
+  [FEATURE_NAMES.genericEvents]: 10
 }
 
 export const FEATURE_TO_ENDPOINT = {
   [FEATURE_NAMES.pageViewEvent]: RUM,
   [FEATURE_NAMES.pageViewTiming]: EVENTS,
   [FEATURE_NAMES.ajax]: EVENTS,
-  [FEATURE_NAMES.spa]: EVENTS,
   [FEATURE_NAMES.softNav]: EVENTS,
   [FEATURE_NAMES.metrics]: JSERRORS,
   [FEATURE_NAMES.jserrors]: JSERRORS,

package/dist/cjs/common/wrap/wrap-jsonp.js

@@ -1,137 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.scopedEE = scopedEE;
-exports.wrapJsonP = wrapJsonP;
-var _eventListenerOpts = require("../event-listener/event-listener-opts");
-var _contextualEe = require("../event-emitter/contextual-ee");
-var _wrapFunction = require("./wrap-function");
-var _runtime = require("../constants/runtime");
-/**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @file Wraps DOM insertion methods which in turn wrap JSONP functions that show up in the DOM.
- * This module is used by: spa.
- */
-
-const wrapped = {};
-const domInsertMethods = ['appendChild', 'insertBefore', 'replaceChild'];
-
-/**
- * Wraps DOM insertion methods to identify script elements containing JSONP callback functions and instruments those
- * functions with custom events in the context of a new event emitter scoped only to JSONP.
- * @param {Object} sharedEE - The shared event emitter on which a new scoped event emitter will be based.
- * @returns {Object} Scoped event emitter with a debug ID of `jsonp`.
- */
-function wrapJsonP(sharedEE) {
-  const ee = scopedEE(sharedEE);
-
-  // Notice if our wrapping never ran yet, the falsy NaN will not early return; but if it has,
-  // then we increment the count to track # of feats using this at runtime.  JSONP deals with DOM
-  // tags so browser window env is required.
-  if (!_runtime.isBrowserScope || wrapped[ee.debugId]) return ee;
-  wrapped[ee.debugId] = true; // otherwise, first feature to wrap JSONP
-
-  var wrapFn = (0, _wrapFunction.createWrapperWithEmitter)(ee);
-  var CALLBACK_REGEX = /[?&](?:callback|cb)=([^&#]+)/;
-  var PARENT_REGEX = /(.*)\.([^.]+)/;
-  var VALUE_REGEX = /^(\w+)(\.|$)(.*)$/;
-
-  // JSONP works by dynamically inserting <script> elements - wrap DOM methods for
-  // inserting elements to detect insertion of JSONP-specific elements.
-  wrapFn.inPlace(Node.prototype, domInsertMethods, 'dom-');
-  ee.on('dom-start', function (args) {
-    wrapElement(args[0]);
-  });
-
-  // subscribe to events on the JSONP <script> element and wrap the JSONP callback
-  // in order to track start and end of the interaction node
-  function wrapElement(el) {
-    var isScript = el && typeof el.nodeName === 'string' && el.nodeName.toLowerCase() === 'script';
-    if (!isScript) return;
-    var isValidElement = typeof el.addEventListener === 'function';
-    if (!isValidElement) return;
-    var callbackName = extractCallbackName(el.src);
-    if (!callbackName) return;
-    var callback = discoverParent(callbackName);
-    var validCallback = typeof callback.parent[callback.key] === 'function';
-    if (!validCallback) return;
-
-    // At this point we know that the element is a valid JSONP script element.
-    // The following events are emitted during the lifetime of a JSONP call:
-    // * immediately emit `new-jsonp` to notify start of the JSONP work
-    // * the wrapped callback will emit `cb-start` and `cb-end` during the execution
-    //   of the callback, here we can inspect the response
-    // * when the element emits the `load` event (script loaded and executed),
-    //   emit `jsonp-end` to notify end of the JSONP work
-    // * if the element emits the `error` event, in response emit `jsonp-error`
-    //   (and `jsonp-end`). Note that the callback in this case will likely not get
-    //   called.
-
-    var context = {};
-    wrapFn.inPlace(callback.parent, [callback.key], 'cb-', context);
-    el.addEventListener('load', onLoad, (0, _eventListenerOpts.eventListenerOpts)(false));
-    el.addEventListener('error', onError, (0, _eventListenerOpts.eventListenerOpts)(false));
-    ee.emit('new-jsonp', [el.src], context);
-    function onLoad() {
-      ee.emit('jsonp-end', [], context);
-      el.removeEventListener('load', onLoad, (0, _eventListenerOpts.eventListenerOpts)(false));
-      el.removeEventListener('error', onError, (0, _eventListenerOpts.eventListenerOpts)(false));
-    }
-    function onError() {
-      ee.emit('jsonp-error', [], context);
-      ee.emit('jsonp-end', [], context);
-      el.removeEventListener('load', onLoad, (0, _eventListenerOpts.eventListenerOpts)(false));
-      el.removeEventListener('error', onError, (0, _eventListenerOpts.eventListenerOpts)(false));
-    }
-  }
-  function extractCallbackName(src) {
-    var matches = src.match(CALLBACK_REGEX);
-    return matches ? matches[1] : null;
-  }
-
-  /**
-   * Traverse a nested object using a '.'-delimited string wherein each substring piece maps to each subsequent object property layer.
-   * @param {string} longKey
-   * @param {object} obj
-   * @returns The final nested object referred to by initial longKey.
-   */
-  function discoverValue(longKey, obj) {
-    if (!longKey) return obj; // end of object recursion depth when no more key levels
-    const matches = longKey.match(VALUE_REGEX);
-    // if 'longKey' was not undefined, that is it at least had 1 level left, then the regexp would've at least matched 1st group
-    const key = matches[1];
-    const remaining = matches[3];
-    return discoverValue(remaining, obj[key]);
-  }
-  function discoverParent(key) {
-    var matches = key.match(PARENT_REGEX);
-    if (matches && matches.length >= 3) {
-      return {
-        key: matches[2],
-        parent: discoverValue(matches[1], window)
-      };
-    }
-    return {
-      key,
-      parent: window
-    };
-  }
-  return ee;
-}
-
-/**
- * Returns an event emitter scoped specifically for the `jsonp` context. This scoping is a remnant from when all the
- * features shared the same group in the event, to isolate events between features. It will likely be revisited.
- * @param {Object} sharedEE - Optional event emitter on which to base the scoped emitter.
- *     Uses `ee` on the global scope if undefined).
- * @returns {Object} Scoped event emitter with a debug ID of 'jsonp'.
- */
-function scopedEE(sharedEE) {
-  return (sharedEE || _contextualEe.ee).get('jsonp');
-}

package/dist/cjs/common/wrap/wrap-mutation.js

@@ -1,62 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.scopedEE = scopedEE;
-exports.wrapMutation = wrapMutation;
-var _contextualEe = require("../event-emitter/contextual-ee");
-var _wrapFunction = require("./wrap-function");
-var _runtime = require("../constants/runtime");
-/**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @file Wraps the window's DOM mutation observer for instrumentation.
- * This module is used by: spa.
- */
-
-const wrapped = {};
-
-/**
- * In web environments only, wraps the `window.MutationObserver` function to emit events on start, end, and error, in
- * the context of a new event emitter scoped only to mutations.
- * @param {Object} sharedEE - The shared event emitter on which a new scoped event emitter will be based.
- * @returns {Object} Scoped event emitter with a debug ID of `mutation`.
- */
-function wrapMutation(sharedEE) {
-  const ee = scopedEE(sharedEE);
-
-  // Notice if our wrapping never ran yet, the falsy NaN will not early return; but if it has,
-  // then we increment the count to track # of feats using this at runtime. Mutations API is only
-  // available in browser DOM context.
-  if (!_runtime.isBrowserScope || wrapped[ee.debugId]) return ee;
-  wrapped[ee.debugId] = true; // otherwise, first feature to wrap mutations
-
-  var wrapFn = (0, _wrapFunction.createWrapperWithEmitter)(ee);
-  var OriginalObserver = _runtime.globalScope.MutationObserver;
-  if (OriginalObserver) {
-    window.MutationObserver = function WrappedMutationObserver(cb) {
-      if (this instanceof OriginalObserver) {
-        return new OriginalObserver(wrapFn(cb, 'fn-'));
-      } else {
-        return OriginalObserver.apply(this, arguments);
-      }
-    };
-    MutationObserver.prototype = OriginalObserver.prototype;
-  }
-  return ee;
-}
-
-/**
- * Returns an event emitter scoped specifically for the `mutation` context. This scoping is a remnant from when all the
- * features shared the same group in the event, to isolate events between features. It will likely be revisited.
- * @param {Object} sharedEE - Optional event emitter on which to base the scoped emitter.
- *     Uses `ee` on the global scope if undefined).
- * @returns {Object} Scoped event emitter with a debug ID of 'mutation'.
- */
-function scopedEE(sharedEE) {
-  return (sharedEE || _contextualEe.ee).get('mutation');
-}

package/dist/cjs/common/wrap/wrap-promise.js

@@ -1,166 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.scopedEE = scopedEE;
-exports.wrapPromise = wrapPromise;
-var _wrapFunction = require("./wrap-function");
-var _contextualEe = require("../event-emitter/contextual-ee");
-var _runtime = require("../constants/runtime");
-/**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-
-/**
- * @file Wraps the native Promise object for instrumentation.
- * This module is used by: spa.
- */
-
-const wrapped = {};
-
-/**
- * Wraps the native Promise object so that it will emit events for start, end and error in the context of a new event
- * emitter scoped only to promise methods. Also instruments various methods, such as `all`, `race`, `resolve`,
- * `reject`, `then`, and `catch`.
- * @param {Object} sharedEE - The shared event emitter on which a new scoped event emitter will be based.
- * @returns {Object} Scoped event emitter with a debug ID of `promise`.
- */
-function wrapPromise(sharedEE) {
-  const promiseEE = scopedEE(sharedEE);
-
-  // Notice if our wrapping never ran yet, the falsy NaN will not early return; but if it has,
-  // then we increment the count to track # of feats using this at runtime.
-  if (wrapped[promiseEE.debugId]) return promiseEE;
-  wrapped[promiseEE.debugId] = true; // otherwise, first feature to wrap promise
-
-  var getContext = promiseEE.context;
-  var promiseWrapper = (0, _wrapFunction.createWrapperWithEmitter)(promiseEE);
-  var prevPromiseObj = _runtime.globalScope.Promise;
-  if (prevPromiseObj) {
-    // ensure there's a Promise API (native or otherwise) to even wrap
-    wrap();
-  }
-  function wrap() {
-    _runtime.globalScope.Promise = WrappedPromise;
-
-    // Renamed from "WrappedPromise" back to "Promise" & toString() so that we appear "native" to TP libraries...
-    Object.defineProperty(WrappedPromise, 'name', {
-      value: 'Promise'
-    });
-    WrappedPromise.toString = function () {
-      return prevPromiseObj.toString();
-    };
-
-    /**
-     * This constitutes the global used when calling "Promise.staticMethod" or chaining off a "new Promise()" object.
-     * @param {Function} executor - to be executed by the original Promise constructor
-     * @returns A new WrappedPromise object prototyped off the original.
-     */
-    function WrappedPromise(executor) {
-      var ctx = promiseEE.context();
-      var wrappedExecutor = promiseWrapper(executor, 'executor-', ctx, null, false);
-      const newCustomPromiseInst = Reflect.construct(prevPromiseObj, [wrappedExecutor], WrappedPromise); // new Promises will use WrappedPromise.prototype as theirs prototype
-
-      promiseEE.context(newCustomPromiseInst).getCtx = function () {
-        return ctx;
-      };
-      return newCustomPromiseInst;
-    }
-
-    // Make WrappedPromise inherit statics from the orig Promise.
-    Object.setPrototypeOf(WrappedPromise, prevPromiseObj);
-    ['all', 'race'].forEach(function (method) {
-      const prevStaticFn = prevPromiseObj[method];
-      WrappedPromise[method] = function (subPromises) {
-        // use our own wrapped version of "Promise.all" and ".race" static fns
-        let finalized = false;
-        [...(subPromises || [])].forEach(sub => {
-          this.resolve(sub).then(setNrId(method === 'all'), setNrId(false));
-        });
-        const origFnCallWithThis = prevStaticFn.apply(this, arguments);
-        return origFnCallWithThis;
-        function setNrId(overwrite) {
-          return function () {
-            promiseEE.emit('propagate', [null, !finalized], origFnCallWithThis, false, false);
-            finalized = finalized || !overwrite;
-          };
-        }
-      };
-    });
-    ['resolve', 'reject'].forEach(function (method) {
-      const prevStaticFn = prevPromiseObj[method];
-      WrappedPromise[method] = function (val) {
-        // and the same for ".resolve" and ".reject"
-        const origFnCallWithThis = prevStaticFn.apply(this, arguments);
-        if (val !== origFnCallWithThis) {
-          promiseEE.emit('propagate', [val, true], origFnCallWithThis, false, false);
-        }
-        return origFnCallWithThis;
-      };
-    });
-
-    /*
-     * Ideally, we create a new WrappedPromise.prototype chained off the original Promise's so that we don't alter it.
-     * However, there's no way to make the (native) promise returned from async functions use our WrappedPromise,
-     * so we have to modify the original prototype. This ensures that promises returned from async functions execute
-     * the same instance methods as promises created with "new Promise()", and also that instanceof async() is
-     * the global Promise (see GH issue #409). This also affects the promise returned from fetch().
-     */
-    WrappedPromise.prototype = prevPromiseObj.prototype;
-
-    // Note that this wrapping affects the same originals.PR (prototype) object.
-    const prevPromiseOrigThen = prevPromiseObj.prototype.then;
-    prevPromiseObj.prototype.then = function wrappedThen(...args) {
-      var originalThis = this;
-      var ctx = getContext(originalThis);
-      ctx.promise = originalThis;
-      args[0] = promiseWrapper(args[0], 'cb-', ctx, null, false);
-      args[1] = promiseWrapper(args[1], 'cb-', ctx, null, false);
-      const origFnCallWithThis = prevPromiseOrigThen.apply(this, args);
-      ctx.nextPromise = origFnCallWithThis;
-      promiseEE.emit('propagate', [originalThis, true], origFnCallWithThis, false, false);
-      return origFnCallWithThis;
-    };
-    prevPromiseObj.prototype.then[_wrapFunction.flag] = prevPromiseOrigThen;
-    promiseEE.on('executor-start', function (args) {
-      args[0] = promiseWrapper(args[0], 'resolve-', this, null, false);
-      args[1] = promiseWrapper(args[1], 'resolve-', this, null, false);
-    });
-    promiseEE.on('executor-err', function (args, originalThis, err) {
-      args[1](err);
-    });
-    promiseEE.on('cb-end', function (args, originalThis, result) {
-      promiseEE.emit('propagate', [result, true], this.nextPromise, false, false);
-    });
-    promiseEE.on('propagate', function (val, overwrite, trigger) {
-      if (!this.getCtx || overwrite) {
-        const selfStore = this;
-        const parentStore = val instanceof Promise ? promiseEE.context(val) : null;
-        let cachedCtx;
-        this.getCtx = function getCtx() {
-          if (cachedCtx) return cachedCtx;
-          if (parentStore && parentStore !== selfStore) {
-            cachedCtx = typeof parentStore.getCtx === 'function' ? parentStore.getCtx() : parentStore;
-          } else {
-            cachedCtx = selfStore;
-          }
-          return cachedCtx;
-        };
-      }
-    });
-  }
-  return promiseEE;
-}
-
-/**
- * Returns an event emitter scoped specifically for the `promise` context. This scoping is a remnant from when all the
- * features shared the same group in the event, to isolate events between features. It will likely be revisited.
- * @param {Object} sharedEE - Optional event emitter on which to base the scoped emitter.
- *     Uses `ee` on the global scope if undefined).
- * @returns {Object} Scoped event emitter with a debug ID of 'promise'.
- */
-function scopedEE(sharedEE) {
-  return (sharedEE || _contextualEe.ee).get('promise');
-}