@newrelic/browser-agent 1.311.0-rc.4 → 1.311.0-rc.6

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.311.0-rc.4";
+const VERSION = exports.VERSION = "1.311.0-rc.6";
 
 /**
  * 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.311.0-rc.4";
+const VERSION = exports.VERSION = "1.311.0-rc.6";
 
 /**
  * Exposes the build type of the agent

package/dist/cjs/common/util/stringify.js

@@ -12,32 +12,17 @@ var _contextualEe = require("../event-emitter/contextual-ee");
 
 /**
  * Returns a function for use as a replacer parameter in JSON.stringify() to handle circular references.
- * Uses an array to track the current ancestor chain, allowing the same object to appear
- * multiple times in the structure as long as it's not a circular reference.
  * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Errors/Cyclic_object_value MDN - Cyclical object value}
- * @returns {Function} A function that filters out circular references while allowing duplicate references.
+ * @returns {Function} A function that filters out values it has seen before.
  */
 const getCircularReplacer = () => {
-  const stack = [];
-  return function (key, value) {
-    if (stack.length > 0) {
-      // Find where we are in the stack
-      const thisPos = stack.indexOf(this);
-      if (~thisPos) {
-        // We're still in the stack, trim it
-        stack.splice(thisPos + 1);
-      } else {
-        // We're not in the stack, add ourselves
-        stack.push(this);
-      }
-
-      // Check if value is in the current ancestor chain
-      if (~stack.indexOf(value)) {
+  const seen = new WeakSet();
+  return (key, value) => {
+    if (typeof value === 'object' && value !== null) {
+      if (seen.has(value)) {
         return;
       }
-    } else {
-      // First call, initialize with root
-      stack.push(value);
+      seen.add(value);
     }
     return value;
   };

package/dist/cjs/common/util/v2.js

@@ -28,7 +28,7 @@ const V2_TYPES = exports.V2_TYPES = {
 };
 
 /**
- * Returns the registered target associated with a given ID. Returns undefined if not found.
+ * Returns the registered target associated with a given ID. Returns an empty array if no target is found.
  * @param {string|number} id
  * @param {*} agentRef the agent reference
  * @returns {import("../../interfaces/registered-entity").RegisterAPIMetadataTarget[]}
@@ -40,7 +40,7 @@ function getRegisteredTargetsFromId(id, agentRef) {
 }
 
 /**
- * Returns the registered target(s) associated with a given filename if found in the resource timing API during registration. Returns an empty array if not found.
+ * Returns the registered target(s) associated with a given filename if found in the resource timing API during registration. Returns an empty array if no target is found.
  * @param {string} filename
  * @param {*} agentRef
  * @returns {import("../../interfaces/registered-entity").RegisterAPIMetadataTarget[]}
@@ -60,7 +60,7 @@ function getRegisteredTargetsFromFilename(filename, agentRef) {
  * @returns {Object} returns an empty object if args are not supplied or the aggregate instance is not supporting version 2
  */
 function getVersion2Attributes(target, aggregateInstance) {
-  if (aggregateInstance?.harvestEndpointVersion !== 2) return {};
+  if (!supportsV2(aggregateInstance)) return {};
   const containerAgentEntityGuid = aggregateInstance.agentRef.runtime.appMetadata.agents[0].entityGuid;
   /** if there's no target, but we are in v2 mode, this means the data belongs to the container agent */
   if (!target) {
@@ -74,24 +74,40 @@ function getVersion2Attributes(target, aggregateInstance) {
 }
 
 /**
- * Returns the attributes used for duplicating data in version 2 of the harvest endpoint. If not valid for duplication, returns an empty object.
+ * Returns the attributes used for duplicating data in version 2 of the harvest endpoint.
+ * If not valid for duplication, returns an empty object.
+ * @note BEST PRACTICE - Caller should call shouldDuplicate() before utilizing this method to determine if duplication attributes should be added to the event.
  * @param {import("../../interfaces/registered-entity").RegisterAPIMetadataTarget} target
  * @param {*} aggregateInstance the aggregate instance calling the method
  * @returns {Object}
  */
 function getVersion2DuplicationAttributes(target, aggregateInstance) {
-  if (aggregateInstance?.harvestEndpointVersion !== 2 || !shouldDuplicate(target, aggregateInstance?.agentRef)) return {};
+  if (!shouldDuplicate(target, aggregateInstance)) return {};
   return {
     'child.id': target.id,
     'child.type': target.type,
     ...getVersion2Attributes(undefined, aggregateInstance)
   };
 }
-function shouldDuplicate(target, agentRef) {
-  return !!target && agentRef.init.api.duplicate_registered_data;
+
+/**
+ * Determines if an event should be duplicated for a given target and aggregate instance.  This is used to determine if duplication attributes should be added to an event and if the event should be sent to the soft nav feature for evaluation.
+ * @note This method is intended to be used in conjunction with getVersion2DuplicationAttributes and should be called before it to determine if duplication attributes should be added to an event.
+ * @param {import("../../interfaces/registered-entity").RegisterAPIMetadataTarget} target
+ * @param {*} aggregateInstance The aggregate instance calling the method.  This is needed to check if duplication is enabled and if the harvest endpoint version supports it.
+ * @returns {boolean} returns true if the event should be duplicated for the target, false otherwise
+ */
+function shouldDuplicate(target, aggregateInstance) {
+  return !!target && !!supportsV2(aggregateInstance) && aggregateInstance.agentRef.init.api.duplicate_registered_data;
 }
+
+/**
+ * Finds the registered targets from the stack trace for a given agent reference.
+ * @param {*} agentRef The agent reference to use for finding targets.
+ * @returns {Array} An array of targets found from the stack trace. If no targets are found or allowed, returns an array with undefined.
+ */
 function findTargetsFromStackTrace(agentRef) {
-  if (!agentRef?.init.api.allow_registered_children) return [];
+  if (!agentRef?.init.api.allow_registered_children) return [undefined];
   const targets = [];
   try {
     var urls = (0, _scriptTracker.extractUrlsFromStack)((0, _scriptTracker.getDeepStackTrace)());
@@ -102,5 +118,17 @@ function findTargetsFromStackTrace(agentRef) {
   } catch (err) {
     // Silent catch to prevent errors from propagating
   }
+  if (!targets.length) targets.push(undefined); // if we can't find any targets from the stack trace, return an array with undefined to signify the container agent is the target
   return targets;
+}
+
+/**
+ * Determines if the aggregate instance supports version 2 of the harvest endpoint. Nearly all the V2 logic "depends" on
+ * the harvest endpoint version, so this is the main gatekeeper method for whether or not V2 logic should be executed across the
+ * various functions in this module.
+ * @param {*} aggregateInstance The aggregate instance to check.
+ * @returns {boolean} Returns true if the aggregate instance supports version 2, false otherwise.
+ */
+function supportsV2(aggregateInstance) {
+  return aggregateInstance?.harvestEndpointVersion === 2;
 }

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

@@ -80,8 +80,6 @@ function wrapFetch(sharedEE, agentRef) {
         var args = [...arguments];
         const ctx = {};
         const targets = (0, _v.findTargetsFromStackTrace)(agentRef);
-        // undefined target reports to container
-        if (!targets.length) targets.push(undefined);
 
         // we are wrapping args in an array so we can preserve the reference
         ee.emit(prefix + 'before-start', [args], ctx);

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

@@ -8,6 +8,7 @@ exports.createWrapperWithEmitter = createWrapperWithEmitter;
 exports.flag = exports.default = void 0;
 var _contextualEe = require("../event-emitter/contextual-ee");
 var _bundleId = require("../ids/bundle-id");
+var _v = require("../util/v2");
 /**
  * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -40,7 +41,7 @@ var _default = exports.default = createWrapperWithEmitter;
  * @param {boolean} always - If `true`, emit events even if already emitting an event.
  * @returns {function} The wrapped function.
  */
-function createWrapperWithEmitter(emitter, always) {
+function createWrapperWithEmitter(emitter, always, agentRef) {
   emitter || (emitter = _contextualEe.ee);
   wrapFn.inPlace = inPlace;
 
@@ -59,9 +60,10 @@ function createWrapperWithEmitter(emitter, always) {
    * @param {function|object} getContext - The function or object that will serve as the 'this' context for handlers of events emitted by this wrapper.
    * @param {string} methodName - The name of the method being wrapped.
    * @param {boolean} bubble - If true, emitted events should also bubble up to the old emitter upon which the `emitter` in the current scope was based (if it defines one).
+   * @param {boolean} [evaluateStack] - If true, the wrapper will attempt to evaluate the stack of the executed wrapped function to find targets of the execution (ex. the MFE source of a console.log).
    * @returns {function} The wrapped function.
    */
-  function wrapFn(fn, prefix, getContext, methodName, bubble) {
+  function wrapFn(fn, prefix, getContext, methodName, bubble, evaluateStack) {
     // Unless fn is both wrappable and unwrapped, return it unchanged.
     if (notWrappable(fn)) return fn;
     if (!prefix) prefix = '';
@@ -80,9 +82,15 @@ function createWrapperWithEmitter(emitter, always) {
       var ctx;
       var result;
       let thrownError;
+      let targets;
       try {
         originalThis = this;
         args = [...arguments];
+
+        // certain wrappers can inform the function wrapper to evaluate the stack of the executed wrapped function to find targets of the execution
+        // (e.g. wrap-logger can inform this method to find try to find the MFE source of a console.log)
+        targets = evaluateStack ? (0, _v.findTargetsFromStackTrace)(agentRef) : [undefined]; // undefined target always maps to the container agent
+
         if (typeof getContext === 'function') {
           ctx = getContext(args, originalThis);
         } else {
@@ -93,7 +101,7 @@ function createWrapperWithEmitter(emitter, always) {
       }
 
       // Warning: start events may mutate args!
-      safeEmit(prefix + 'start', [args, originalThis, methodName], ctx, bubble);
+      safeEmit(prefix + 'start', [args, originalThis, methodName, targets], ctx, bubble);
       const fnStartTime = performance.now();
       let fnEndTime;
       try {
@@ -102,7 +110,7 @@ function createWrapperWithEmitter(emitter, always) {
         return result;
       } catch (err) {
         fnEndTime = performance.now();
-        safeEmit(prefix + 'err', [args, originalThis, err], ctx, bubble);
+        safeEmit(prefix + 'err', [args, originalThis, err, targets], ctx, bubble);
         // rethrow error so we don't effect execution by observing.
         thrownError = err;
         throw thrownError;
@@ -119,10 +127,10 @@ function createWrapperWithEmitter(emitter, always) {
         };
         // standalone long task message
         if (task.isLongTask) {
-          safeEmit('long-task', [task, originalThis], ctx, bubble);
+          safeEmit('long-task', [task, originalThis, targets], ctx, bubble);
         }
         // -end message also includes the task execution info
-        safeEmit(prefix + 'end', [args, originalThis, result], ctx, bubble);
+        safeEmit(prefix + 'end', [args, originalThis, result, targets], ctx, bubble);
       }
     }
   }
@@ -138,7 +146,7 @@ function createWrapperWithEmitter(emitter, always) {
    * @param {boolean} [bubble=false] If `true`, emitted events should also bubble up to the old emitter upon which
    * the `emitter` in the current scope was based (if it defines one).
    */
-  function inPlace(obj, methods, prefix, getContext, bubble) {
+  function inPlace(obj, methods, prefix, getContext, bubble, evaluateStack) {
     if (!prefix) prefix = '';
 
     // If prefix starts with '-' set this boolean to add the method name to the prefix before passing each one to wrap.
@@ -149,7 +157,7 @@ function createWrapperWithEmitter(emitter, always) {
 
       // Unless fn is both wrappable and unwrapped, bail so we don't add extra properties with undefined values.
       if (notWrappable(fn)) continue;
-      obj[method] = wrapFn(fn, prependMethodPrefix ? method + prefix : prefix, getContext, method, bubble);
+      obj[method] = wrapFn(fn, prependMethodPrefix ? method + prefix : prefix, getContext, method, bubble, evaluateStack);
     }
   }
 

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

@@ -30,10 +30,10 @@ const contextMap = new Map();
  * @returns {Object} Scoped event emitter with a debug ID of `logger`.
  */
 // eslint-disable-next-line
-function wrapLogger(sharedEE, parent, loggerFn, context, autoCaptured = true) {
+function wrapLogger(sharedEE, parent, loggerFn, context, autoCaptured = true, agentRef) {
   if (!(typeof parent === 'object' && !!parent && typeof loggerFn === 'string' && !!loggerFn && typeof parent[loggerFn] === 'function')) return (0, _console.warn)(29);
   const ee = scopedEE(sharedEE);
-  const wrapFn = (0, _wrapFunction.createWrapperWithEmitter)(ee);
+  const wrapFn = (0, _wrapFunction.createWrapperWithEmitter)(ee, undefined, agentRef);
 
   /**
    * This section contains the context that will be shared across all invoked calls of the wrapped function,
@@ -46,8 +46,10 @@ function wrapLogger(sharedEE, parent, loggerFn, context, autoCaptured = true) {
   const contextLookupKey = parent[loggerFn]?.[_wrapFunction.flag] || parent[loggerFn];
   contextMap.set(contextLookupKey, ctx);
 
-  /** observe calls to <loggerFn> and emit events prefixed with `wrap-logger-` */
-  wrapFn.inPlace(parent, [loggerFn], 'wrap-logger-', () => contextMap.get(contextLookupKey));
+  /** observe calls to <loggerFn> and emit events prefixed with `wrap-logger-`
+   * inform the inplace wrapper to evaluate the stack for targets of the log execution,
+   * so that logs can be attributed to a matching MFE source if being used. */
+  wrapFn.inPlace(parent, [loggerFn], 'wrap-logger-', () => contextMap.get(contextLookupKey), undefined, true);
   return ee;
 }
 

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

@@ -56,8 +56,6 @@ function wrapXhr(sharedEE, agentRef) {
     const xhr = new OrigXHR(opts);
     const context = ee.context(xhr);
     context.targets = (0, _v.findTargetsFromStackTrace)(agentRef);
-    // undefined target reports to container
-    if (!context.targets.length) context.targets.push(undefined);
     try {
       ee.emit('new-xhr', [xhr], context);
       xhr.addEventListener(READY_STATE_CHANGE, wrapXHR(context), (0, _eventListenerOpts.eventListenerOpts)(false));

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

@@ -108,7 +108,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
         ...event,
         targetAttributes: (0, _v.getVersion2Attributes)(target, this)
       });
-      if ((0, _v.shouldDuplicate)(target, this.agentRef)) this.reportContainerEvent({
+      if ((0, _v.shouldDuplicate)(target, this)) this.reportContainerEvent({
         ...event,
         targetAttributes: (0, _v.getVersion2DuplicationAttributes)(target, this)
       }, ctx);

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

@@ -78,11 +78,6 @@ class Aggregate extends _aggregateBase.AggregateBase {
     const modeForThisLog = autoCaptured ? this.loggingMode.auto : this.loggingMode.api;
     if (!modeForThisLog) return;
     if (!attributes || typeof attributes !== 'object') attributes = {};
-    attributes = {
-      ...attributes,
-      /** Specific attributes only supplied if harvesting to endpoint version 2 */
-      ...(0, _v.getVersion2Attributes)(target, this)
-    };
     if (typeof level === 'string') level = level.toUpperCase();
     if (!(0, _utils.isValidLogLevel)(level)) return (0, _console.warn)(30, level);
     if (modeForThisLog < (_constants.LOGGING_MODE[level] || Infinity)) {
@@ -105,8 +100,18 @@ class Aggregate extends _aggregateBase.AggregateBase {
       return;
     }
     if (typeof message !== 'string' || !message) return (0, _console.warn)(32);
-    const log = new _log.Log(Math.floor(this.agentRef.runtime.timeKeeper.correctRelativeTimestamp(timestamp)), message, attributes, level);
-    if (this.events.add(log)) this.reportSupportabilityMetric(LOGGING_EVENT + (autoCaptured ? 'Auto' : 'API') + '/Added');
+    const addEvent = attributes => {
+      const log = new _log.Log(Math.floor(this.agentRef.runtime.timeKeeper.correctRelativeTimestamp(timestamp)), message, attributes, level);
+      if (this.events.add(log)) this.reportSupportabilityMetric(LOGGING_EVENT + (autoCaptured ? 'Auto' : 'API') + '/Added');
+    };
+    addEvent({
+      ...attributes,
+      ...(0, _v.getVersion2Attributes)(target, this)
+    });
+    if ((0, _v.shouldDuplicate)(target, this)) addEvent({
+      ...attributes,
+      ...(0, _v.getVersion2DuplicationAttributes)(target, this)
+    });
   }
   serializer(eventBuffer) {
     const sessionEntity = this.agentRef.runtime.session;

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

@@ -32,17 +32,19 @@ class Instrument extends _instrumentBase.InstrumentBase {
       (0, _monkeyPatched.isNative)(_runtime.globalScope.console[method]);
       (0, _wrapLogger.wrapLogger)(instanceEE, _runtime.globalScope.console, method, {
         level: method === 'log' ? 'info' : method
-      });
+      }, undefined, agentRef);
     });
 
     /** emitted by wrap-logger function */
-    this.ee.on('wrap-logger-end', function handleLog([message]) {
+    this.ee.on('wrap-logger-end', function handleLog([message], _, __, targets = []) {
       const {
         level,
         customAttributes,
         autoCaptured
       } = this;
-      (0, _utils.bufferLog)(instanceEE, message, customAttributes, level, autoCaptured);
+      targets.forEach(target => {
+        (0, _utils.bufferLog)(instanceEE, message, customAttributes, level, autoCaptured, target);
+      });
     });
     this.importAggregator(agentRef, () => Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "logging-aggregate" */'../aggregate'))));
   }

package/dist/cjs/features/logging/shared/utils.js

@@ -21,11 +21,11 @@ var _constants2 = require("../constants");
    * @param {{[key: string]: *}} customAttributes - The log's custom attributes if any
    * @param {enum} level - the log level enum
    * @param {boolean} [autoCaptured=true] - True if log was captured from auto wrapping. False if it was captured from the API manual usage.
-   * @param {object=} target - the optional target provided by an api call
+   * @param {object=} targets - the optional targets found
    */
-function bufferLog(ee, message, customAttributes = {}, level = _constants2.LOG_LEVELS.INFO, autoCaptured = true, target, timestamp = (0, _now.now)()) {
+function bufferLog(ee, message, customAttributes = {}, level = _constants2.LOG_LEVELS.INFO, autoCaptured = true, targets, timestamp = (0, _now.now)()) {
   (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ["API/logging/".concat(level.toLowerCase(), "/called")], undefined, _features.FEATURE_NAMES.metrics, ee);
-  (0, _handle.handle)(_constants2.LOGGING_EVENT_EMITTER_CHANNEL, [timestamp, message, customAttributes, level, autoCaptured, target], undefined, _features.FEATURE_NAMES.logging, ee);
+  (0, _handle.handle)(_constants2.LOGGING_EVENT_EMITTER_CHANNEL, [timestamp, message, customAttributes, level, autoCaptured, targets], undefined, _features.FEATURE_NAMES.logging, ee);
 }
 
 /**

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

@@ -160,7 +160,9 @@ function register(agentRef, target, parent) {
     setUserId: value => setLocalValue('enduser.id', value),
     /** metadata */
     metadata: {
-      customAttributes: attrs,
+      get customAttributes() {
+        return attrs;
+      },
       target,
       timings
     }

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

@@ -21,6 +21,6 @@ function setupWrapLoggerAPI(agent) {
     (0, _wrapLogger.wrapLogger)(agent.ee, parent, functionName, {
       customAttributes,
       level
-    }, false);
+    }, false, agent);
   }, agent);
 }

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

@@ -11,7 +11,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.311.0-rc.4";
+export const VERSION = "1.311.0-rc.6";
 
 /**
  * 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.311.0-rc.4";
+export const VERSION = "1.311.0-rc.6";
 
 /**
  * Exposes the build type of the agent

package/dist/esm/common/util/stringify.js

@@ -7,32 +7,17 @@ import { ee } from '../event-emitter/contextual-ee';
 
 /**
  * Returns a function for use as a replacer parameter in JSON.stringify() to handle circular references.
- * Uses an array to track the current ancestor chain, allowing the same object to appear
- * multiple times in the structure as long as it's not a circular reference.
  * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Errors/Cyclic_object_value MDN - Cyclical object value}
- * @returns {Function} A function that filters out circular references while allowing duplicate references.
+ * @returns {Function} A function that filters out values it has seen before.
  */
 const getCircularReplacer = () => {
-  const stack = [];
-  return function (key, value) {
-    if (stack.length > 0) {
-      // Find where we are in the stack
-      const thisPos = stack.indexOf(this);
-      if (~thisPos) {
-        // We're still in the stack, trim it
-        stack.splice(thisPos + 1);
-      } else {
-        // We're not in the stack, add ourselves
-        stack.push(this);
-      }
-
-      // Check if value is in the current ancestor chain
-      if (~stack.indexOf(value)) {
+  const seen = new WeakSet();
+  return (key, value) => {
+    if (typeof value === 'object' && value !== null) {
+      if (seen.has(value)) {
         return;
       }
-    } else {
-      // First call, initialize with root
-      stack.push(value);
+      seen.add(value);
     }
     return value;
   };

package/dist/esm/common/util/v2.js

@@ -17,7 +17,7 @@ export const V2_TYPES = {
 };
 
 /**
- * Returns the registered target associated with a given ID. Returns undefined if not found.
+ * Returns the registered target associated with a given ID. Returns an empty array if no target is found.
  * @param {string|number} id
  * @param {*} agentRef the agent reference
  * @returns {import("../../interfaces/registered-entity").RegisterAPIMetadataTarget[]}
@@ -29,7 +29,7 @@ export function getRegisteredTargetsFromId(id, agentRef) {
 }
 
 /**
- * Returns the registered target(s) associated with a given filename if found in the resource timing API during registration. Returns an empty array if not found.
+ * Returns the registered target(s) associated with a given filename if found in the resource timing API during registration. Returns an empty array if no target is found.
  * @param {string} filename
  * @param {*} agentRef
  * @returns {import("../../interfaces/registered-entity").RegisterAPIMetadataTarget[]}
@@ -49,7 +49,7 @@ export function getRegisteredTargetsFromFilename(filename, agentRef) {
  * @returns {Object} returns an empty object if args are not supplied or the aggregate instance is not supporting version 2
  */
 export function getVersion2Attributes(target, aggregateInstance) {
-  if (aggregateInstance?.harvestEndpointVersion !== 2) return {};
+  if (!supportsV2(aggregateInstance)) return {};
   const containerAgentEntityGuid = aggregateInstance.agentRef.runtime.appMetadata.agents[0].entityGuid;
   /** if there's no target, but we are in v2 mode, this means the data belongs to the container agent */
   if (!target) {
@@ -63,24 +63,40 @@ export function getVersion2Attributes(target, aggregateInstance) {
 }
 
 /**
- * Returns the attributes used for duplicating data in version 2 of the harvest endpoint. If not valid for duplication, returns an empty object.
+ * Returns the attributes used for duplicating data in version 2 of the harvest endpoint.
+ * If not valid for duplication, returns an empty object.
+ * @note BEST PRACTICE - Caller should call shouldDuplicate() before utilizing this method to determine if duplication attributes should be added to the event.
  * @param {import("../../interfaces/registered-entity").RegisterAPIMetadataTarget} target
  * @param {*} aggregateInstance the aggregate instance calling the method
  * @returns {Object}
  */
 export function getVersion2DuplicationAttributes(target, aggregateInstance) {
-  if (aggregateInstance?.harvestEndpointVersion !== 2 || !shouldDuplicate(target, aggregateInstance?.agentRef)) return {};
+  if (!shouldDuplicate(target, aggregateInstance)) return {};
   return {
     'child.id': target.id,
     'child.type': target.type,
     ...getVersion2Attributes(undefined, aggregateInstance)
   };
 }
-export function shouldDuplicate(target, agentRef) {
-  return !!target && agentRef.init.api.duplicate_registered_data;
+
+/**
+ * Determines if an event should be duplicated for a given target and aggregate instance.  This is used to determine if duplication attributes should be added to an event and if the event should be sent to the soft nav feature for evaluation.
+ * @note This method is intended to be used in conjunction with getVersion2DuplicationAttributes and should be called before it to determine if duplication attributes should be added to an event.
+ * @param {import("../../interfaces/registered-entity").RegisterAPIMetadataTarget} target
+ * @param {*} aggregateInstance The aggregate instance calling the method.  This is needed to check if duplication is enabled and if the harvest endpoint version supports it.
+ * @returns {boolean} returns true if the event should be duplicated for the target, false otherwise
+ */
+export function shouldDuplicate(target, aggregateInstance) {
+  return !!target && !!supportsV2(aggregateInstance) && aggregateInstance.agentRef.init.api.duplicate_registered_data;
 }
+
+/**
+ * Finds the registered targets from the stack trace for a given agent reference.
+ * @param {*} agentRef The agent reference to use for finding targets.
+ * @returns {Array} An array of targets found from the stack trace. If no targets are found or allowed, returns an array with undefined.
+ */
 export function findTargetsFromStackTrace(agentRef) {
-  if (!agentRef?.init.api.allow_registered_children) return [];
+  if (!agentRef?.init.api.allow_registered_children) return [undefined];
   const targets = [];
   try {
     var urls = extractUrlsFromStack(getDeepStackTrace());
@@ -91,5 +107,17 @@ export function findTargetsFromStackTrace(agentRef) {
   } catch (err) {
     // Silent catch to prevent errors from propagating
   }
+  if (!targets.length) targets.push(undefined); // if we can't find any targets from the stack trace, return an array with undefined to signify the container agent is the target
   return targets;
+}
+
+/**
+ * Determines if the aggregate instance supports version 2 of the harvest endpoint. Nearly all the V2 logic "depends" on
+ * the harvest endpoint version, so this is the main gatekeeper method for whether or not V2 logic should be executed across the
+ * various functions in this module.
+ * @param {*} aggregateInstance The aggregate instance to check.
+ * @returns {boolean} Returns true if the aggregate instance supports version 2, false otherwise.
+ */
+function supportsV2(aggregateInstance) {
+  return aggregateInstance?.harvestEndpointVersion === 2;
 }

package/dist/esm/common/wrap/wrap-fetch.js

@@ -72,8 +72,6 @@ export function wrapFetch(sharedEE, agentRef) {
         var args = [...arguments];
         const ctx = {};
         const targets = findTargetsFromStackTrace(agentRef);
-        // undefined target reports to container
-        if (!targets.length) targets.push(undefined);
 
         // we are wrapping args in an array so we can preserve the reference
         ee.emit(prefix + 'before-start', [args], ctx);

package/dist/esm/common/wrap/wrap-function.js

@@ -9,6 +9,7 @@
 
 import { ee } from '../event-emitter/contextual-ee';
 import { bundleId } from '../ids/bundle-id';
+import { findTargetsFromStackTrace } from '../util/v2';
 export const flag = "nr@original:".concat(bundleId);
 const LONG_TASK_THRESHOLD = 50;
 
@@ -33,7 +34,7 @@ export default createWrapperWithEmitter;
  * @param {boolean} always - If `true`, emit events even if already emitting an event.
  * @returns {function} The wrapped function.
  */
-export function createWrapperWithEmitter(emitter, always) {
+export function createWrapperWithEmitter(emitter, always, agentRef) {
   emitter || (emitter = ee);
   wrapFn.inPlace = inPlace;
 
@@ -52,9 +53,10 @@ export function createWrapperWithEmitter(emitter, always) {
    * @param {function|object} getContext - The function or object that will serve as the 'this' context for handlers of events emitted by this wrapper.
    * @param {string} methodName - The name of the method being wrapped.
    * @param {boolean} bubble - If true, emitted events should also bubble up to the old emitter upon which the `emitter` in the current scope was based (if it defines one).
+   * @param {boolean} [evaluateStack] - If true, the wrapper will attempt to evaluate the stack of the executed wrapped function to find targets of the execution (ex. the MFE source of a console.log).
    * @returns {function} The wrapped function.
    */
-  function wrapFn(fn, prefix, getContext, methodName, bubble) {
+  function wrapFn(fn, prefix, getContext, methodName, bubble, evaluateStack) {
     // Unless fn is both wrappable and unwrapped, return it unchanged.
     if (notWrappable(fn)) return fn;
     if (!prefix) prefix = '';
@@ -73,9 +75,15 @@ export function createWrapperWithEmitter(emitter, always) {
       var ctx;
       var result;
       let thrownError;
+      let targets;
       try {
         originalThis = this;
         args = [...arguments];
+
+        // certain wrappers can inform the function wrapper to evaluate the stack of the executed wrapped function to find targets of the execution
+        // (e.g. wrap-logger can inform this method to find try to find the MFE source of a console.log)
+        targets = evaluateStack ? findTargetsFromStackTrace(agentRef) : [undefined]; // undefined target always maps to the container agent
+
         if (typeof getContext === 'function') {
           ctx = getContext(args, originalThis);
         } else {
@@ -86,7 +94,7 @@ export function createWrapperWithEmitter(emitter, always) {
       }
 
       // Warning: start events may mutate args!
-      safeEmit(prefix + 'start', [args, originalThis, methodName], ctx, bubble);
+      safeEmit(prefix + 'start', [args, originalThis, methodName, targets], ctx, bubble);
       const fnStartTime = performance.now();
       let fnEndTime;
       try {
@@ -95,7 +103,7 @@ export function createWrapperWithEmitter(emitter, always) {
         return result;
       } catch (err) {
         fnEndTime = performance.now();
-        safeEmit(prefix + 'err', [args, originalThis, err], ctx, bubble);
+        safeEmit(prefix + 'err', [args, originalThis, err, targets], ctx, bubble);
         // rethrow error so we don't effect execution by observing.
         thrownError = err;
         throw thrownError;
@@ -112,10 +120,10 @@ export function createWrapperWithEmitter(emitter, always) {
         };
         // standalone long task message
         if (task.isLongTask) {
-          safeEmit('long-task', [task, originalThis], ctx, bubble);
+          safeEmit('long-task', [task, originalThis, targets], ctx, bubble);
         }
         // -end message also includes the task execution info
-        safeEmit(prefix + 'end', [args, originalThis, result], ctx, bubble);
+        safeEmit(prefix + 'end', [args, originalThis, result, targets], ctx, bubble);
       }
     }
   }
@@ -131,7 +139,7 @@ export function createWrapperWithEmitter(emitter, always) {
    * @param {boolean} [bubble=false] If `true`, emitted events should also bubble up to the old emitter upon which
    * the `emitter` in the current scope was based (if it defines one).
    */
-  function inPlace(obj, methods, prefix, getContext, bubble) {
+  function inPlace(obj, methods, prefix, getContext, bubble, evaluateStack) {
     if (!prefix) prefix = '';
 
     // If prefix starts with '-' set this boolean to add the method name to the prefix before passing each one to wrap.
@@ -142,7 +150,7 @@ export function createWrapperWithEmitter(emitter, always) {
 
       // Unless fn is both wrappable and unwrapped, bail so we don't add extra properties with undefined values.
       if (notWrappable(fn)) continue;
-      obj[method] = wrapFn(fn, prependMethodPrefix ? method + prefix : prefix, getContext, method, bubble);
+      obj[method] = wrapFn(fn, prependMethodPrefix ? method + prefix : prefix, getContext, method, bubble, evaluateStack);
     }
   }