@newrelic/browser-agent 1.310.1 → 1.311.0

package/src/features/utils/aggregate-base.js

@@ -7,7 +7,6 @@ import { isValid } from '../../common/config/info'
 import { configure } from '../../loaders/configure/configure'
 import { gosCDN } from '../../common/window/nreum'
 import { drain } from '../../common/drain/drain'
-import { activatedFeatures } from '../../common/util/feature-flags'
 import { Obfuscator } from '../../common/util/obfuscate'
 import { FEATURE_NAMES } from '../../loaders/features/features'
 import { Harvester } from '../../common/harvest/harvester'
@@ -24,8 +23,7 @@ export class AggregateBase extends FeatureBase {
    * @param {string} featureName The name of the feature creating the instance.
    */
   constructor (agentRef, featureName) {
-    super(agentRef.agentIdentifier, featureName)
-    this.agentRef = agentRef
+    super(agentRef, featureName)
     this.checkConfiguration(agentRef)
     this.doOnceForAllAggregate(agentRef)
 
@@ -112,8 +110,8 @@ export class AggregateBase extends FeatureBase {
    */
   waitForFlags (flagNames = []) {
     const flagsPromise = new Promise((resolve, reject) => {
-      if (activatedFeatures[this.agentIdentifier]) {
-        resolve(buildOutput(activatedFeatures[this.agentIdentifier]))
+      if (this.agentRef.runtime?.activatedFeatures) {
+        resolve(buildOutput(this.agentRef.runtime.activatedFeatures))
       } else {
         this.ee.on('rumresp', (resp = {}) => {
           resolve(buildOutput(resp))
@@ -137,7 +135,7 @@ export class AggregateBase extends FeatureBase {
    * Stages the feature to be drained
    */
   drain () {
-    drain(this.agentIdentifier, this.featureName)
+    drain(this.agentRef, this.featureName)
   }
 
   preHarvestChecks (opts) {

package/src/features/utils/feature-base.js

@@ -1,16 +1,15 @@
 /**
- * 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 { ee } from '../../common/event-emitter/contextual-ee'
 import { deregisterDrain } from '../../common/drain/drain'
 
 export class FeatureBase {
-  constructor (agentIdentifier, featureName) {
-    /** @type {string} */
-    this.agentIdentifier = agentIdentifier
+  constructor (agentRef, featureName) {
+    /** @type {Object} */
+    this.agentRef = agentRef
     /** @type {import('../../common/event-emitter/contextual-ee').ee} */
-    this.ee = ee.get(agentIdentifier)
+    this.ee = agentRef?.ee
     /** @type {string} */
     this.featureName = featureName
     /**
@@ -22,6 +21,6 @@ export class FeatureBase {
   }
 
   deregisterDrain () {
-    deregisterDrain(this.agentIdentifier, this.featureName)
+    deregisterDrain(this.agentRef, this.featureName)
   }
 }

package/src/features/utils/instrument-base.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
  */
 
@@ -28,13 +28,11 @@ import { handle } from '../../common/event-emitter/handle'
 export class InstrumentBase extends FeatureBase {
   /**
    * Instantiate InstrumentBase.
-   * @param {string} agentIdentifier - The unique ID of the instantiated agent (relative to global scope).
+   * @param {Object} agentRef - The agent reference object.
    * @param {string} featureName - The name of the feature module (used to construct file path).
    */
   constructor (agentRef, featureName) {
-    super(agentRef.agentIdentifier, featureName)
-
-    this.agentRef = agentRef
+    super(agentRef, featureName)
 
     /** @type {Function | undefined} This should be set by any derived Instrument class if it has things to do when feature fails or is killed. */
     this.abortHandler = undefined
@@ -65,13 +63,13 @@ export class InstrumentBase extends FeatureBase {
         this.ee.on('manual-start-all', single(() => {
         // register the feature to drain only once the API has been called, it will drain when importAggregator finishes for all the features
         // called by the api in that cycle
-          registerDrain(agentRef.agentIdentifier, this.featureName)
+          registerDrain(agentRef, this.featureName)
           resolve()
         }))
       })
     } else {
       /** if the feature requires opt-in (!auto-start), it will get registered once the api has been called */
-      registerDrain(agentRef.agentIdentifier, featureName)
+      registerDrain(agentRef, featureName)
     }
   }
 
@@ -110,7 +108,7 @@ export class InstrumentBase extends FeatureBase {
        */
       try {
         if (!this.#shouldImportAgg(this.featureName, session, agentRef.init)) {
-          drain(this.agentIdentifier, this.featureName)
+          drain(this.agentRef, this.featureName)
           this.loadedSuccessfully(false) // aggregate module isn't loaded at all
           return
         }
@@ -123,7 +121,7 @@ export class InstrumentBase extends FeatureBase {
         warn(34, e)
         this.abortHandler?.() // undo any important alterations made to the page
         // not supported yet but nice to do: "abort" this agent's EE for this feature specifically
-        drain(this.agentIdentifier, this.featureName, true)
+        drain(this.agentRef, this.featureName, true)
         this.loadedSuccessfully(false)
         if (this.ee) this.ee.abort()
       }

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

@@ -20,7 +20,7 @@
 
 /**
  * @typedef {Object} RegisterAPIConstructor
- * @property {string|number} id - The unique id for the registered entity. This will be assigned to any synthesized entities.
+ * @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.

package/src/loaders/api/register.js

@@ -88,7 +88,7 @@ function register (agentRef, target, parent) {
   }
 
   function hasValidValue (val) {
-    return (typeof val === 'string' && !!val.trim() && val.trim().length < 501) || (typeof val === 'number')
+    return (typeof val === 'string' && !!val.trim() && val.trim().length < 501)
   }
 
   /** primary cases that can block the register API from working at init time */

package/src/loaders/api/sharedHandlers.js

@@ -1,12 +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
  */
 import { dispatchGlobalEvent } from '../../common/dispatch/global-event'
 import { handle } from '../../common/event-emitter/handle'
 import { now } from '../../common/timing/now'
 import { warn } from '../../common/util/console'
-import { activatedFeatures } from '../../common/util/feature-flags'
 import { SUPPORTABILITY_METRIC_CHANNEL } from '../../features/metrics/constants'
 import { AgentBase } from '../agent-base'
 import { FEATURE_NAMES } from '../features/features'
@@ -28,8 +27,7 @@ export function setupAPI (name, fn, agent, obj) {
   api[name] = function () {
     handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/' + name + '/called'], undefined, FEATURE_NAMES.metrics, agent.ee)
     dispatchGlobalEvent({
-      agentIdentifier: agent.agentIdentifier,
-      drained: !!activatedFeatures?.[agent.agentIdentifier],
+      drained: !!agent.runtime?.activatedFeatures,
       type: 'data',
       name: 'api',
       feature: prefix + name,

package/src/loaders/configure/configure.js

@@ -3,19 +3,16 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { setTopLevelCallers } from '../api/topLevelCallers'
-import { addToNREUM, gosCDN } from '../../common/window/nreum'
+import { gosCDN } from '../../common/window/nreum'
 import { mergeInfo } from '../../common/config/info'
 import { mergeInit } from '../../common/config/init'
 import { mergeRuntime } from '../../common/config/runtime'
-import { activatedFeatures } from '../../common/util/feature-flags'
 import { isWorkerScope } from '../../common/constants/runtime'
 import { redefinePublicPath } from './public-path'
 import { ee } from '../../common/event-emitter/contextual-ee'
 import { dispatchGlobalEvent } from '../../common/dispatch/global-event'
 import { mergeLoaderConfig } from '../../common/config/loader-config'
 
-const alreadySetOnce = new Set() // the configure() function can run multiple times in agent lifecycle for different agents
-
 /**
  * Sets or re-sets the agent's configuration values from global settings. This also attach those as properties to the agent instance.
  * IMPORTANT: setNREUMInitializedAgent must be called on the agent prior to calling this function.
@@ -42,41 +39,48 @@ export function configure (agent, opts = {}, loaderType, forceDrain) {
   agent.info = mergeInfo(info)
 
   const updatedInit = agent.init
-  const internalTrafficList = [info.beacon, info.errorBeacon]
 
-  if (!alreadySetOnce.has(agent.agentIdentifier)) {
-    if (updatedInit.proxy.assets) {
-      redefinePublicPath(updatedInit.proxy.assets)
-      internalTrafficList.push(updatedInit.proxy.assets)
-    }
-    if (updatedInit.proxy.beacon) internalTrafficList.push(updatedInit.proxy.beacon)
-    agent.beacons = [...internalTrafficList]
+  agent.runtime ??= mergeRuntime(runtime)
 
-    setTopLevelCallers(agent) // no need to set global APIs on newrelic obj more than once
-    addToNREUM('activatedFeatures', activatedFeatures)
+  // Apply proxy settings whenever configure is called (supports late {init} setting)
+  if (updatedInit.proxy.assets) {
+    redefinePublicPath(updatedInit.proxy.assets)
   }
 
-  runtime.denyList = [
-    ...(updatedInit.ajax.deny_list || []),
-    ...(updatedInit.ajax.block_internal ? internalTrafficList : [])
-  ]
-  runtime.ptid = agent.agentIdentifier
-  runtime.loaderType = loaderType
-  agent.runtime = mergeRuntime(runtime)
+  if (!agent.runtime.configured) {
+    Object.defineProperty(agent, 'beacons', {
+      get () {
+        return [agent.info.beacon, agent.info.errorBeacon, agent.init.proxy.assets, agent.init.proxy.beacon].filter(Boolean)
+      }
+    })
+
+    Object.defineProperty(agent.runtime, 'denyList', {
+      get () {
+        // Compute the internal traffic list fresh each time to ensure beacons array is current
+        return [
+          ...(agent.init.ajax.deny_list || []),
+          ...(agent.init.ajax.block_internal ? agent.beacons : [])
+        ]
+      }
+    })
+    agent.runtime.ptid = agent.agentIdentifier
+
+    setTopLevelCallers(agent) // no need to set global APIs on newrelic obj more than once
+
+    agent.runtime.loaderType = loaderType
 
-  if (!alreadySetOnce.has(agent.agentIdentifier)) {
     agent.ee = ee.get(agent.agentIdentifier)
+
     agent.exposed = exposed
 
     dispatchGlobalEvent({
-      agentIdentifier: agent.agentIdentifier,
-      drained: !!activatedFeatures?.[agent.agentIdentifier],
+      drained: !!agent.runtime.activatedFeatures,
       type: 'lifecycle',
       name: 'initialize',
       feature: undefined,
       data: agent.config
     })
-  }
 
-  alreadySetOnce.add(agent.agentIdentifier)
+    agent.runtime.configured = true
+  }
 }

package/dist/cjs/features/utils/nr1-debugger.js

@@ -1,30 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.debugNR1 = debugNR1;
-var _nreum = require("../../common/window/nreum");
-/**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-
-const debugId = 1;
-const newrelic = (0, _nreum.gosCDN)();
-function debugNR1(agentIdentifier, location, event, otherprops = {}, debugName = 'SR') {
-  const api = agentIdentifier ? newrelic.initializedAgents[agentIdentifier].addPageAction : newrelic.addPageAction;
-  let url;
-  try {
-    const locURL = new URL(window.location);
-    url = locURL.pathname;
-  } catch (err) {}
-  api(debugName, {
-    debugId,
-    url,
-    location,
-    event,
-    now: performance.now(),
-    ...otherprops
-  });
-}

package/dist/esm/features/utils/nr1-debugger.js

@@ -1,23 +0,0 @@
-/**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-import { gosCDN } from '../../common/window/nreum';
-const debugId = 1;
-const newrelic = gosCDN();
-export function debugNR1(agentIdentifier, location, event, otherprops = {}, debugName = 'SR') {
-  const api = agentIdentifier ? newrelic.initializedAgents[agentIdentifier].addPageAction : newrelic.addPageAction;
-  let url;
-  try {
-    const locURL = new URL(window.location);
-    url = locURL.pathname;
-  } catch (err) {}
-  api(debugName, {
-    debugId,
-    url,
-    location,
-    event,
-    now: performance.now(),
-    ...otherprops
-  });
-}

package/dist/types/features/utils/nr1-debugger.d.ts

@@ -1,2 +0,0 @@
-export function debugNR1(agentIdentifier: any, location: any, event: any, otherprops?: {}, debugName?: string): void;
-//# sourceMappingURL=nr1-debugger.d.ts.map

package/dist/types/features/utils/nr1-debugger.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"nr1-debugger.d.ts","sourceRoot":"","sources":["../../../../src/features/utils/nr1-debugger.js"],"names":[],"mappings":"AAQA,qHAiBC"}

package/src/features/utils/nr1-debugger.js

@@ -1,26 +0,0 @@
-/**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-import { gosCDN } from '../../common/window/nreum'
-
-const debugId = 1
-const newrelic = gosCDN()
-export function debugNR1 (agentIdentifier, location, event, otherprops = {}, debugName = 'SR') {
-  const api = agentIdentifier ? newrelic.initializedAgents[agentIdentifier].addPageAction : newrelic.addPageAction
-  let url
-  try {
-    const locURL = new URL(window.location)
-    url = locURL.pathname
-  } catch (err) {
-
-  }
-  api(debugName, {
-    debugId,
-    url,
-    location,
-    event,
-    now: performance.now(),
-    ...otherprops
-  })
-}