@newrelic/browser-agent 1.237.1 → 1.239.0

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

@@ -18,7 +18,6 @@ var _harvestScheduler = require("../../../common/harvest/harvest-scheduler");
 var _serializer = require("./serializer");
 var _contextualEe = require("../../../common/event-emitter/contextual-ee");
 var CONSTANTS = _interopRequireWildcard(require("../constants"));
-var _drain = require("../../../common/drain/drain");
 var _features = require("../../../loaders/features/features");
 var _aggregateBase = require("../../utils/aggregate-base");
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
@@ -144,8 +143,8 @@ class Aggregate extends _aggregateBase.AggregateBase {
 
     // register plugins
     var pluginApi = {
-      getCurrentNode: getCurrentNode,
-      setCurrentNode: setCurrentNode
+      getCurrentNode,
+      setCurrentNode
     };
     (0, _registerHandler.registerHandler)('spa-register', function (init) {
       if (typeof init === 'function') {
@@ -210,21 +209,19 @@ class Aggregate extends _aggregateBase.AggregateBase {
         // If this event was emitted by an XHR, restore the node ID associated with
         // that XHR.
         setCurrentNode(baseEE.context(eventSource).spaNode);
-      } else if (!state.currentNode) {
+      } else if (!state.currentNode && INTERACTION_EVENTS.indexOf(evName) !== -1) {
         // Otherwise, if no interaction is currently active, create a new node ID,
         // and let the aggregator know that we entered a new event handler callback
         // so that it has a chance to possibly start an interaction.
-        if (INTERACTION_EVENTS.indexOf(evName) !== -1) {
-          var ixn = new _interaction.Interaction(evName, this[FN_START], state.lastSeenUrl, state.lastSeenRouteName, onInteractionFinished, agentIdentifier);
+        var ixn = new _interaction.Interaction(evName, this[FN_START], state.lastSeenUrl, state.lastSeenRouteName, onInteractionFinished, agentIdentifier);
 
-          // Store the interaction as prevInteraction in case it is prematurely discarded
-          state.prevInteraction = ixn;
-          setCurrentNode(ixn.root);
-          if (evName === 'click') {
-            var value = getActionText(ev.target);
-            if (value) {
-              state.currentNode.attrs.custom.actionText = value;
-            }
+        // Store the interaction as prevInteraction in case it is prematurely discarded
+        state.prevInteraction = ixn;
+        setCurrentNode(ixn.root);
+        if (evName === 'click') {
+          var value = getActionText(ev.target);
+          if (value) {
+            state.currentNode.attrs.custom.actionText = value;
           }
         }
       }
@@ -506,7 +503,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     }, this.featureName, promiseEE);
     (0, _registerHandler.registerHandler)(INTERACTION_API + 'get', function (t) {
       var interaction;
-      if (state?.currentNode?.[INTERACTION]) interaction = this.ixn = state.currentNode[INTERACTION];else if (state?.prevNode?.end === null && state?.prevNode?.[INTERACTION]?.root?.[INTERACTION]?.eventName != 'initialPageLoad') interaction = this.ixn = state.prevNode[INTERACTION];else interaction = this.ixn = new _interaction.Interaction('api', t, state.lastSeenUrl, state.lastSeenRouteName, onInteractionFinished, agentIdentifier);
+      if (state?.currentNode?.[INTERACTION]) interaction = this.ixn = state.currentNode[INTERACTION];else if (state?.prevNode?.end === null && state?.prevNode?.[INTERACTION]?.root?.[INTERACTION]?.eventName !== 'initialPageLoad') interaction = this.ixn = state.prevNode[INTERACTION];else interaction = this.ixn = new _interaction.Interaction('api', t, state.lastSeenUrl, state.lastSeenRouteName, onInteractionFinished, agentIdentifier);
       if (!state.currentNode) {
         interaction.checkFinish();
         if (state.depth) setCurrentNode(interaction.root);
@@ -674,12 +671,9 @@ class Aggregate extends _aggregateBase.AggregateBase {
     }
     function isEnabled() {
       var enabled = (0, _config.getConfigurationValue)(agentIdentifier, 'spa.enabled');
-      if (enabled === false) {
-        return false;
-      }
-      return true;
+      return enabled !== false;
     }
-    (0, _drain.drain)(this.agentIdentifier, this.featureName);
+    this.drain();
   }
 }
 exports.Aggregate = Aggregate;

package/dist/cjs/features/spa/aggregate/interaction.js

@@ -8,7 +8,6 @@ var _config = require("../../../common/config/config");
 var _mapOwn = require("../../../common/util/map-own");
 var _contextualEe = require("../../../common/event-emitter/contextual-ee");
 var _interactionNode = require("./interaction-node");
-var _now = require("../../../common/timing/now");
 /*
  * Copyright 2020 New Relic Corporation. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -84,7 +83,6 @@ InteractionPrototype.finish = function finishInteraction() {
   var root = interaction.root;
   if (root.end !== null) return;
   var endTimestamp = Math.max(interaction.lastCb, interaction.lastFinish);
-  var delta = (0, _now.now)() - endTimestamp;
   var attrs = root.attrs;
   var customAttrs = attrs.custom;
   if (this.onFinished) {

package/dist/cjs/features/spa/aggregate/serializer.js

@@ -126,7 +126,7 @@ class Serializer extends _sharedContext.SharedContext {
         // (since its the same as interaction.start)
         // and limit to just the first 20 values we know about
         (0, _mapOwn.mapOwn)(navTiming.slice(1, 21), function (i, v) {
-          if (v !== void 0) {
+          if (v !== undefined) {
             navTimingNode += seperator + (0, _belSerializer.numeric)(v - prev);
             seperator = ',';
             prev = v;

package/dist/cjs/features/utils/aggregate-base.js

@@ -9,6 +9,7 @@ var _featureBase = require("./feature-base");
 var _config = require("../../common/config/config");
 var _configure = require("../../loaders/configure/configure");
 var _nreum = require("../../common/window/nreum");
+var _drain = require("../../common/drain/drain");
 class AggregateBase extends _featureBase.FeatureBase {
   constructor() {
     super(...arguments);
@@ -26,6 +27,9 @@ class AggregateBase extends _featureBase.FeatureBase {
       (0, _registerHandler.registerHandler)("rumresp-".concat(fName), isOn => resolve(isOn), this.featureName, this.ee);
     })));
   }
+  drain() {
+    (0, _drain.drain)(this.agentIdentifier, this.featureName);
+  }
 
   /**
    * Checks for additional `jsAttributes` items to support backward compatibility with implementations of the agent where

package/dist/cjs/features/utils/handler-cache.js

@@ -42,7 +42,9 @@ class HandlerCache {
    * @returns {void}
    */
   settle(handler) {
-    if (this.#decision === false) return;else if (this.#decision === undefined) this.#cache.push(handler);else handler();
+    if (this.#decision === false) {
+      // Do nothing
+    } else if (this.#decision === undefined) this.#cache.push(handler);else handler();
   }
 
   /**

package/dist/cjs/features/utils/instrument-base.js

@@ -37,18 +37,24 @@ class InstrumentBase extends _featureBase.FeatureBase {
     this.auto = auto;
 
     /** @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;
+    this.abortHandler = undefined;
+
     /**
      * @type {Class} Holds the reference to the feature's aggregate module counterpart, if and after it has been initialized. This may not be assigned until after page loads!
      * The only purpose of this for now is to expose it to the NREUM interface, as the feature's instrument instance is already exposed.
     */
-    this.featAggregate;
+    this.featAggregate = undefined;
+
     /**
      * @type {Promise} Assigned immediately after @see importAggregator runs. Serves as a signal for when the inner async fn finishes execution. Useful for features to await
      * one another if there are inter-features dependencies.
     */
-    this.onAggregateImported;
-    if (auto) (0, _drain.registerDrain)(agentIdentifier, featureName);
+    this.onAggregateImported = undefined;
+
+    /** used in conjunction with newrelic.start() to defer harvesting in features */
+    if ((0, _config.getConfigurationValue)(this.agentIdentifier, "".concat(this.featureName, ".autoStart")) === false) this.auto = false;
+    /** if the feature requires opt-in (!auto-start), it will get registered once the api has been called */
+    if (this.auto) (0, _drain.registerDrain)(agentIdentifier, featureName);
   }
 
   /**
@@ -59,7 +65,19 @@ class InstrumentBase extends _featureBase.FeatureBase {
    */
   importAggregator() {
     let argsObjFromInstrument = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-    if (this.featAggregate || !this.auto) return;
+    if (this.featAggregate) return;
+    if (!this.auto) {
+      // this feature requires an opt in...
+      // wait for API to be called
+      this.ee.on("".concat(this.featureName, "-opt-in"), () => {
+        // 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
+        (0, _drain.registerDrain)(this.agentIdentifier, this.featureName);
+        this.auto = true;
+        this.importAggregator();
+      });
+      return;
+    }
     const enableSessionTracking = _runtime.isBrowserScope && (0, _config.getConfigurationValue)(this.agentIdentifier, 'privacy.cookies_enabled') === true;
     let loadedSuccessfully;
     this.onAggregateImported = new Promise(resolve => {
@@ -80,7 +98,7 @@ class InstrumentBase extends _featureBase.FeatureBase {
       }
 
       /**
-       * Note this try-catch differs from the one in Agent.start() in that it's placed later in a page's lifecycle and
+       * Note this try-catch differs from the one in Agent.run() in that it's placed later in a page's lifecycle and
        * it's only responsible for aborting its one specific feature, rather than all.
        */
       try {

package/dist/cjs/loaders/agent-base.js

@@ -5,6 +5,8 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.AgentBase = void 0;
 var _console = require("../common/util/console");
+/* eslint-disable n/handle-callback-err */
+
 class AgentBase {
   /**
    * Reports a browser PageAction event along with a name and optional attributes.
@@ -56,6 +58,18 @@ class AgentBase {
     (0, _console.warn)('Call to agent api setUserId failed. The js errors feature is not currently initialized.');
   }
 
+  /**
+   * Adds a user-defined application version string to subsequent events on the page.
+   * This decorates all payloads with an attribute of `application.version` which is queryable in NR1.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setapplicationversion/}
+   * @param {string|null} value A string identifier for the application version, useful for
+   * tying all browser events to a specific release tag. The value parameter does not
+   * have to be unique. Passing a null value unsets any existing value.
+   */
+  setApplicationVersion(value) {
+    (0, _console.warn)('Call to agent api setApplicationVersion failed. The agent is not currently initialized.');
+  }
+
   /**
    * Allows selective ignoring and grouping of known errors that the browser agent captures.
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/seterrorhandler/}
@@ -83,5 +97,14 @@ class AgentBase {
   addRelease(name, id) {
     (0, _console.warn)('Call to agent api addRelease failed. The agent is not currently initialized.');
   }
+
+  /**
+   * Starts a set of agent features if not running in "autoStart" mode
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/start/}
+   * @param {string|string[]|undefined} name The feature name(s) to start.  If no name(s) are passed, all features will be started
+   */
+  start(featureNames) {
+    (0, _console.warn)('Call to agent api addRelease failed. The agent is not currently initialized.');
+  }
 }
 exports.AgentBase = AgentBase;

package/dist/cjs/loaders/agent.js

@@ -52,7 +52,7 @@ class Agent extends _agentBase.AgentBase {
     // Future work is being planned to evaluate removing this behavior from the backend, but for now we must ensure this call is made
     this.desiredFeatures.add(_instrument.Instrument);
     Object.assign(this, (0, _configure.configure)(this.agentIdentifier, options, options.loaderType || 'agent'));
-    this.start();
+    this.run();
   }
   get config() {
     return {
@@ -62,20 +62,20 @@ class Agent extends _agentBase.AgentBase {
       runtime: (0, _config.getRuntime)(this.agentIdentifier)
     };
   }
-  start() {
+  run() {
     const NR_FEATURES_REF_NAME = 'features';
     // Attempt to initialize all the requested features (sequentially in prio order & synchronously), with any failure aborting the whole process.
     try {
       const enabledFeatures = (0, _enabledFeatures.getEnabledFeatures)(this.agentIdentifier);
       const featuresToStart = [...this.desiredFeatures];
       featuresToStart.sort((a, b) => _features.featurePriority[a.featureName] - _features.featurePriority[b.featureName]);
-      featuresToStart.forEach(f => {
+      featuresToStart.forEach(InstrumentCtor => {
         // pageViewEvent must be enabled because RUM calls are not optional. See comment in constructor and PR 428.
-        if (enabledFeatures[f.featureName] || f.featureName === _features.FEATURE_NAMES.pageViewEvent) {
-          const dependencies = (0, _featureDependencies.getFeatureDependencyNames)(f.featureName);
+        if (enabledFeatures[InstrumentCtor.featureName] || InstrumentCtor.featureName === _features.FEATURE_NAMES.pageViewEvent) {
+          const dependencies = (0, _featureDependencies.getFeatureDependencyNames)(InstrumentCtor.featureName);
           const hasAllDeps = dependencies.every(x => enabledFeatures[x]);
-          if (!hasAllDeps) (0, _console.warn)("".concat(f.featureName, " is enabled but one or more dependent features has been disabled (").concat((0, _stringify.stringify)(dependencies), "). This may cause unintended consequences or missing data..."));
-          this.features[f.featureName] = new f(this.agentIdentifier, this.sharedAggregator);
+          if (!hasAllDeps) (0, _console.warn)("".concat(InstrumentCtor.featureName, " is enabled but one or more dependent features has been disabled (").concat((0, _stringify.stringify)(dependencies), "). This may cause unintended consequences or missing data..."));
+          this.features[InstrumentCtor.featureName] = new InstrumentCtor(this.agentIdentifier, this.sharedAggregator);
         }
       });
       (0, _nreum.gosNREUMInitializedAgents)(this.agentIdentifier, this.features, NR_FEATURES_REF_NAME);

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

@@ -26,7 +26,7 @@ const CUSTOM_ATTR_GROUP = 'CUSTOM/'; // the subgroup items should be stored unde
 exports.CUSTOM_ATTR_GROUP = CUSTOM_ATTR_GROUP;
 function setTopLevelCallers() {
   const nr = (0, _nreum.gosCDN)();
-  const funcs = ['setErrorHandler', 'finished', 'addToTrace', 'inlineHit', 'addRelease', 'addPageAction', 'setCurrentRouteName', 'setPageViewName', 'setCustomAttribute', 'interaction', 'noticeError', 'setUserId'];
+  const funcs = ['setErrorHandler', 'finished', 'addToTrace', 'inlineHit', 'addRelease', 'addPageAction', 'setCurrentRouteName', 'setPageViewName', 'setCustomAttribute', 'interaction', 'noticeError', 'setUserId', 'setApplicationVersion', 'start'];
   funcs.forEach(f => {
     nr[f] = function () {
       for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
@@ -58,7 +58,9 @@ function setAPI(agentIdentifier, forceDrain) {
   var spaPrefix = prefix + 'ixn-';
 
   // Setup stub functions that queue calls for later processing.
-  asyncApiFns.forEach(fnName => apiInterface[fnName] = apiCall(prefix, fnName, true, 'api'));
+  asyncApiFns.forEach(fnName => {
+    apiInterface[fnName] = apiCall(prefix, fnName, true, 'api');
+  });
   apiInterface.addPageAction = apiCall(prefix, 'addPageAction', true, _features.FEATURE_NAMES.pageAction);
   apiInterface.setCurrentRouteName = apiCall(prefix, 'routeName', true, _features.FEATURE_NAMES.spa);
   apiInterface.setPageViewName = function (name, host) {
@@ -115,6 +117,34 @@ function setAPI(agentIdentifier, forceDrain) {
     }
     return appendJsAttribute('enduser.id', value, 'setUserId', true);
   };
+
+  /**
+   * Attach the 'applcation.version' attribute onto agent payloads. This may be used in NR queries to group all browser events by a specific customer-defined release.
+   * @param {string|null} value - Application version -- if null, will "unset" the value
+   * @returns @see apiCall
+   */
+  apiInterface.setApplicationVersion = function (value) {
+    if (!(typeof value === 'string' || value === null)) {
+      (0, _console.warn)("Failed to execute setApplicationVersion. Expected <String | null>, but got <".concat(typeof value, ">."));
+      return;
+    }
+    return appendJsAttribute('application.version', value, 'setApplicationVersion', false);
+  };
+  apiInterface.start = features => {
+    try {
+      const featNames = Object.values(_features.FEATURE_NAMES);
+      if (features === undefined) features = featNames;else {
+        features = Array.isArray(features) && features.length ? features : [features];
+        if (features.some(f => !featNames.includes(f))) return (0, _console.warn)("Invalid feature name supplied. Acceptable feature names are: ".concat(featNames));
+        if (!features.includes(_features.FEATURE_NAMES.pageViewEvent)) features.push(_features.FEATURE_NAMES.pageViewEvent);
+      }
+      features.forEach(feature => {
+        instanceEE.emit("".concat(feature, "-opt-in"));
+      });
+    } catch (err) {
+      (0, _console.warn)('An unexpected issue occurred', err);
+    }
+  };
   apiInterface.interaction = function () {
     return new InteractionHandle().get();
   };
@@ -141,14 +171,14 @@ function setAPI(agentIdentifier, forceDrain) {
       };
     }
   };
-  void ['actionText', 'setName', 'setAttribute', 'save', 'ignore', 'onEnd', 'getContext', 'end', 'get'].forEach(name => {
+  ['actionText', 'setName', 'setAttribute', 'save', 'ignore', 'onEnd', 'getContext', 'end', 'get'].forEach(name => {
     InteractionApiProto[name] = apiCall(spaPrefix, name, undefined, _features.FEATURE_NAMES.spa);
   });
   function apiCall(prefix, name, notSpa, bufferGroup) {
     return function () {
       (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['API/' + name + '/called'], undefined, _features.FEATURE_NAMES.metrics, instanceEE);
       if (bufferGroup) (0, _handle.handle)(prefix + name, [(0, _now.now)(), ...arguments], notSpa ? null : this, bufferGroup, instanceEE); // no bufferGroup means only the SM is emitted
-      return notSpa ? void 0 : this;
+      return notSpa ? undefined : this;
     };
   }
   apiInterface.noticeError = function (err, customAttributes) {

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

@@ -21,10 +21,10 @@ function setAPI(agentIdentifier) {
   var scheme = (0, _config.getConfigurationValue)(agentIdentifier, 'ssl') === false ? 'http' : 'https';
   var api = {
     finished: (0, _invoke.single)(finished),
-    setErrorHandler: setErrorHandler,
-    addToTrace: addToTrace,
-    inlineHit: inlineHit,
-    addRelease: addRelease
+    setErrorHandler,
+    addToTrace,
+    inlineHit,
+    addRelease
   };
 
   // Hook all of the api functions up to the queues/stubs created in loader/api.js
@@ -60,29 +60,28 @@ function setAPI(agentIdentifier) {
     (0, _handle.handle)('bstApi', [report], undefined, _features.FEATURE_NAMES.sessionTrace, instanceEE);
   }
 
-  // NREUM.inlineHit(request_name, queue_time, app_time, total_be_time, dom_time, fe_time)
+  // NREUM.inlineHit(requestName, queueTime, appTime, totalBackEndTime, domTime, frontEndTime)
   //
-  // request_name - the 'web page' name or service name
-  // queue_time - the amount of time spent in the app tier queue
-  // app_time - the amount of time spent in the application code
-  // total_be_time - the total roundtrip time of the remote service call
-  // dom_time - the time spent processing the result of the service call (or user defined)
-  // fe_time - the time spent rendering the result of the service call (or user defined)
-  function inlineHit(t, request_name, queue_time, app_time, total_be_time, dom_time, fe_time) {
+  // requestName - the 'web page' name or service name
+  // queueTime - the amount of time spent in the app tier queue
+  // appTime - the amount of time spent in the application code
+  // totalBackEndTime - the total roundtrip time of the remote service call
+  // domTime - the time spent processing the result of the service call (or user defined)
+  // frontEndTime - the time spent rendering the result of the service call (or user defined)
+  function inlineHit(t, requestName, queueTime, appTime, totalBackEndTime, domTime, frontEndTime) {
     if (!_runtime.isBrowserScope) return;
-    request_name = window.encodeURIComponent(request_name);
+    requestName = window.encodeURIComponent(requestName);
     cycle += 1;
     const agentInfo = (0, _config.getInfo)(agentIdentifier);
-    const agentRuntime = (0, _config.getRuntime)(agentIdentifier);
     if (!agentInfo.beacon) return;
     var url = scheme + '://' + agentInfo.beacon + '/1/' + agentInfo.licenseKey;
     url += '?a=' + agentInfo.applicationID + '&';
-    url += 't=' + request_name + '&';
-    url += 'qt=' + ~~queue_time + '&';
-    url += 'ap=' + ~~app_time + '&';
-    url += 'be=' + ~~total_be_time + '&';
-    url += 'dc=' + ~~dom_time + '&';
-    url += 'fe=' + ~~fe_time + '&';
+    url += 't=' + requestName + '&';
+    url += 'qt=' + ~~queueTime + '&';
+    url += 'ap=' + ~~appTime + '&';
+    url += 'be=' + ~~totalBackEndTime + '&';
+    url += 'dc=' + ~~domTime + '&';
+    url += 'fe=' + ~~frontEndTime + '&';
     url += 'c=' + cycle;
     submitData.xhr({
       url

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

@@ -12,7 +12,7 @@ exports.unused = void 0;
  * @property {getContext} getContext
  * @property {ignore} ignore
  * @property {onEnd} onEnd
- * @property {onEnd} save
+ * @property {save} save
  * @property {setAttribute} setAttribute
  * @property {setName} setName
  */
@@ -30,8 +30,8 @@ exports.unused = void 0;
  * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/createtracer/}
  * @callback createTracer
  * @param {string} name This will be used as the name of the tracer.
- * @param {string} [callback] A callback that contains the synchronous work to run at the end of the async work. To execute this callback, call the wrapper function returned using createTracer().
- * @returns {Function} Returns a method that wraps the original callback. When this method is invoked, it calls the original callback and ends the async timing.
+ * @param {(...args: any[]) => any} [callback] A callback that contains the synchronous work to run at the end of the async work. To execute this callback, call the wrapper function returned using createTracer().
+ * @returns {(...args: any[]) => any} Returns a method that wraps the original callback. When this method is invoked, it calls the original callback and ends the async timing.
  */
 
 /**
@@ -49,6 +49,13 @@ exports.unused = void 0;
  * @returns {InteractionInstance} Returns the same interaction object allowing method chaining.
  */
 
+/**
+ * Overrides other SPA save() calls; ignores an interaction so it is not saved or sent to New Relic.
+ * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/ignore/}
+ * @callback ignore
+ * @returns {InteractionInstance} Returns the same interaction object allowing method chaining.
+ */
+
 /**
  * Change the values associated with a SPA interaction before the interaction is saved.
  * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/onend/}
@@ -69,7 +76,7 @@ exports.unused = void 0;
  * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setattribute/}
  * @callback setAttribute
  * @param {string} key Used as the attribute name on the BrowserInteraction event.
- * @param {any} key Used as the attribute value on the BrowserInteraction event. This can be a string, number, boolean, or object. If it is an object, New Relic serializes it to a JSON string.
+ * @param {any} value Used as the attribute value on the BrowserInteraction event. This can be a string, number, boolean, or object. If it is an object, New Relic serializes it to a JSON string.
  * @returns {InteractionInstance} Returns the same interaction object allowing method chaining.
  */
 

package/dist/cjs/loaders/configure/configure.js

@@ -13,6 +13,7 @@ function configure(agentIdentifier) {
   let opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
   let loaderType = arguments.length > 2 ? arguments[2] : undefined;
   let forceDrain = arguments.length > 3 ? arguments[3] : undefined;
+  // eslint-disable-next-line camelcase
   let {
     init,
     info,
@@ -26,9 +27,11 @@ function configure(agentIdentifier) {
   if (!info) {
     init = nr.init;
     info = nr.info;
+    // eslint-disable-next-line camelcase
     loader_config = nr.loader_config;
   }
   (0, _config.setConfiguration)(agentIdentifier, init || {});
+  // eslint-disable-next-line camelcase
   (0, _config.setLoaderConfig)(agentIdentifier, loader_config || {});
   info.jsAttributes ??= {};
   if (_runtime.isWorkerScope) {

package/dist/cjs/loaders/micro-agent.js

@@ -44,7 +44,14 @@ class MicroAgent extends _agentBase.AgentBase {
         isolatedBacklog: true
       }
     }, options.loaderType || 'micro-agent'));
-    this.start();
+
+    /**
+     * Starts a set of agent features if not running in "autoStart" mode
+     * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/start/}
+     * @param {string|string[]|undefined} name The feature name(s) to start.  If no name(s) are passed, all features will be started
+     */
+    this.start = features => this.run(features);
+    this.run(nonAutoFeatures.filter(featureName => (0, _config.getConfigurationValue)(agentIdentifier, "".concat(featureName, ".autoStart"))));
   }
   get config() {
     return {
@@ -54,7 +61,17 @@ class MicroAgent extends _agentBase.AgentBase {
       runtime: (0, _config.getRuntime)(this.agentIdentifier)
     };
   }
-  start() {
+  run(features) {
+    try {
+      const featNames = nonAutoFeatures;
+      if (features === undefined) features = featNames;else {
+        features = Array.isArray(features) && features.length ? features : [features];
+        if (features.some(f => !featNames.includes(f))) return (0, _console.warn)("Invalid feature name supplied. Acceptable feature names are: ".concat(featNames));
+        if (!features.includes(_features.FEATURE_NAMES.pageViewEvent)) features.push(_features.FEATURE_NAMES.pageViewEvent);
+      }
+    } catch (err) {
+      (0, _console.warn)('An unexpected issue occurred', err);
+    }
     try {
       const enabledFeatures = (0, _enabledFeatures.getEnabledFeatures)(this.agentIdentifier);
       try {
@@ -66,7 +83,7 @@ class MicroAgent extends _agentBase.AgentBase {
       (0, _load.onWindowLoad)(() => {
         // these features do not import an "instrument" file, meaning they are only hooked up to the API.
         nonAutoFeatures.forEach(f => {
-          if (enabledFeatures[f]) {
+          if (enabledFeatures[f] && features.includes(f)) {
             Promise.resolve().then(() => _interopRequireWildcard(require( /* webpackChunkName: "lazy-feature-loader" */'../features/utils/lazy-feature-loader'))).then(_ref => {
               let {
                 lazyFeatureLoader

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

@@ -9,8 +9,6 @@ const model = () => {
     }
   };
   return {
-    allow_bfcache: true,
-    // *cli - temporary feature flag for BFCache work
     privacy: {
       cookies_enabled: true
     },
@@ -19,7 +17,8 @@ const model = () => {
       deny_list: undefined,
       block_internal: true,
       enabled: true,
-      harvestTimeSeconds: 10
+      harvestTimeSeconds: 10,
+      autoStart: true
     },
     distributed_tracing: {
       enabled: undefined,
@@ -38,32 +37,39 @@ const model = () => {
     obfuscate: undefined,
     jserrors: {
       enabled: true,
-      harvestTimeSeconds: 10
+      harvestTimeSeconds: 10,
+      autoStart: true
     },
     metrics: {
-      enabled: true
+      enabled: true,
+      autoStart: true
     },
     page_action: {
       enabled: true,
-      harvestTimeSeconds: 30
+      harvestTimeSeconds: 30,
+      autoStart: true
     },
     page_view_event: {
-      enabled: true
+      enabled: true,
+      autoStart: true
     },
     page_view_timing: {
       enabled: true,
       harvestTimeSeconds: 30,
-      long_task: false
+      long_task: false,
+      autoStart: true
     },
     session_trace: {
       enabled: true,
-      harvestTimeSeconds: 10
+      harvestTimeSeconds: 10,
+      autoStart: true
     },
     harvest: {
       tooManyRequestsDelay: 60
     },
     session_replay: {
       // feature settings
+      autoStart: true,
       enabled: false,
       harvestTimeSeconds: 60,
       sampleRate: 0.1,
@@ -102,23 +108,25 @@ const model = () => {
     },
     spa: {
       enabled: true,
-      harvestTimeSeconds: 10
+      harvestTimeSeconds: 10,
+      autoStart: true
     }
   };
 };
 const _cache = {};
+const missingAgentIdError = 'All configuration objects require an agent identifier!';
 export function getConfiguration(id) {
-  if (!id) throw new Error('All configuration objects require an agent identifier!');
+  if (!id) throw new Error(missingAgentIdError);
   if (!_cache[id]) throw new Error("Configuration for ".concat(id, " was never set"));
   return _cache[id];
 }
 export function setConfiguration(id, obj) {
-  if (!id) throw new Error('All configuration objects require an agent identifier!');
+  if (!id) throw new Error(missingAgentIdError);
   _cache[id] = getModeledObject(obj, model());
   gosNREUMInitializedAgents(id, _cache[id], 'config');
 }
 export function getConfigurationValue(id, path) {
-  if (!id) throw new Error('All configuration objects require an agent identifier!');
+  if (!id) throw new Error(missingAgentIdError);
   var val = getConfiguration(id);
   if (val) {
     var parts = path.split('.');

package/dist/esm/common/config/state/runtime.js

@@ -4,10 +4,6 @@ import { globalScope } from '../../constants/runtime';
 import { BUILD_ENV, DIST_METHOD, VERSION } from "../../constants/env.npm";
 const model = {
   buildEnv: BUILD_ENV,
-  bytesSent: {},
-  // Used for SM to capture body bytes sent per endpoint
-  queryBytesSent: {},
-  // Used for SM to capture query parameter bytes sent per endpoint
   customTransaction: undefined,
   disabled: false,
   distMethod: DIST_METHOD,

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

@@ -6,7 +6,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.237.1";
+export const VERSION = "1.239.0";
 
 /**
  * Exposes the build type of the agent

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

@@ -6,7 +6,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.237.1";
+export const VERSION = "1.239.0";
 
 /**
  * Exposes the build type of the agent

package/dist/esm/common/constants/runtime.js

@@ -25,7 +25,7 @@ export const isiOS = /iPad|iPhone|iPod/.test(navigator.userAgent);
  * did not work. This affects our onFCP metric in particular since web-vitals uses that flag to retrieve paint timing entries.
  * This was fixed in v16+.
  */
-export const iOS_below16 = isiOS && typeof SharedWorker === 'undefined';
+export const iOSBelow16 = isiOS && typeof SharedWorker === 'undefined';
 export const ffVersion = (() => {
   const match = navigator.userAgent.match(/Firefox[/\s](\d+\.\d+)/);
   if (Array.isArray(match) && match.length >= 2) {