@newrelic/browser-agent 1.238.0 → 1.239.0

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

@@ -16,7 +16,6 @@ var _cleanUrl = require("../../../common/url/clean-url");
 var _handle = require("../../../common/event-emitter/handle");
 var _config = require("../../../common/config/config");
 var _constants = require("../constants");
-var _drain = require("../../../common/drain/drain");
 var _features = require("../../../loaders/features/features");
 var _aggregateBase = require("../../utils/aggregate-base");
 /*
@@ -51,7 +50,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     });
 
     /* First Contentful Paint - As of WV v3, it still imperfectly tries to detect document vis state asap and isn't supposed to report if page starts hidden. */
-    if (_runtime.iOS_below16) {
+    if (_runtime.iOSBelow16) {
       try {
         if (!pageStartedHidden) {
           // see ios-version.js for detail on this following bug case; tldr: buffered flag doesn't work but getEntriesByType does
@@ -127,7 +126,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
       let {
         value
       } = _ref5;
-      return this.cls = value;
+      this.cls = value;
     }, {
       reportAllChanges: true
     });
@@ -176,7 +175,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     this.ee.on("drain-".concat(this.featureName), () => {
       this.scheduler.startTimer(harvestTimeSeconds, initialHarvestSeconds);
     });
-    (0, _drain.drain)(this.agentIdentifier, this.featureName);
+    this.drain();
   }
 
   // takes an attributes object and appends connection attributes if available
@@ -230,9 +229,9 @@ class Aggregate extends _aggregateBase.AggregateBase {
       attrs.cls = this.cls;
     }
     this.timings.push({
-      name: name,
-      value: value,
-      attrs: attrs
+      name,
+      value,
+      attrs
     });
     (0, _handle.handle)('pvtAdded', [name, value, attrs], undefined, _features.FEATURE_NAMES.sessionTrace, this.ee);
   }

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

@@ -4,7 +4,6 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.RRWEB_VERSION = exports.MAX_PAYLOAD_SIZE = exports.IDEAL_PAYLOAD_SIZE = exports.Aggregate = exports.AVG_COMPRESSION = void 0;
-var _drain = require("../../../common/drain/drain");
 var _registerHandler = require("../../../common/event-emitter/register-handler");
 var _harvestScheduler = require("../../../common/harvest/harvest-scheduler");
 var _constants = require("../constants");
@@ -14,6 +13,7 @@ var _sessionEntity = require("../../../common/session/session-entity");
 var _aggregateBase = require("../../utils/aggregate-base");
 var _sharedChannel = require("../../../common/constants/shared-channel");
 var _encode = require("../../../common/url/encode");
+var _console = require("../../../common/util/console");
 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); }
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; } /*
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       * Copyright 2023 New Relic Corporation. All rights reserved.
@@ -135,7 +135,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
         return this.initializeRecording(flagOn, Math.random() < (0, _config.getConfigurationValue)(this.agentIdentifier, 'session_replay.errorSampleRate'), Math.random() < (0, _config.getConfigurationValue)(this.agentIdentifier, 'session_replay.sampleRate'));
       }).then(() => _sharedChannel.sharedChannel.onReplayReady(this.mode)); // notify watchers that replay started with the mode
 
-      (0, _drain.drain)(this.agentIdentifier, this.featureName);
+      this.drain();
     }
   }
 
@@ -268,7 +268,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
   /** Begin recording using configured recording lib */
   startRecording() {
     if (!recorder) {
-      warn('Recording library was never imported');
+      (0, _console.warn)('Recording library was never imported');
       return this.abort();
     }
     this.recording = true;

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

@@ -10,7 +10,6 @@ var _parseUrl = require("../../../common/url/parse-url");
 var _config = require("../../../common/config/config");
 var _now = require("../../../common/timing/now");
 var _constants = require("../constants");
-var _drain = require("../../../common/drain/drain");
 var _handlerCache = require("../../utils/handler-cache");
 var _sessionEntity = require("../../../common/session/session-entity");
 var _replayMode = require("../../session_replay/replay-mode");
@@ -144,7 +143,9 @@ class Aggregate extends _aggregateBase.AggregateBase {
             });
             mostRecentModeKnown = updatedTraceMode;
           });
-          this.ee.on(_sessionEntity.SESSION_EVENTS.PAUSE, () => mostRecentModeKnown = sessionEntity.state.sessionTraceMode);
+          this.ee.on(_sessionEntity.SESSION_EVENTS.PAUSE, () => {
+            mostRecentModeKnown = sessionEntity.state.sessionTraceMode;
+          });
           if (!sessionEntity.isNew) {
             // inherit the same mode as existing session's Trace
             if (sessionEntity.state.sessionReplay === _sessionEntity.MODE.OFF) this.isStandalone = true;
@@ -216,7 +217,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
       }
       return operationalGate.settle(() => _this.processPVT(...args));
     }, this.featureName, this.ee);
-    (0, _drain.drain)(this.agentIdentifier, this.featureName);
+    this.drain();
   }
   startTracing(startupBuffer) {
     let dontStartHarvestYet = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
@@ -340,8 +341,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     const origin = this.evtOrigin(event.target, target);
     if (event.type in ignoredEvents.global) return true;
     if (!!ignoredEvents[origin] && ignoredEvents[origin].ignoreAll) return true;
-    if (!!ignoredEvents[origin] && event.type in ignoredEvents[origin]) return true;
-    return false;
+    return !!(!!ignoredEvents[origin] && event.type in ignoredEvents[origin]);
   }
   evtName(type) {
     switch (type) {
@@ -451,7 +451,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
       // limit the amount of pending data awaiting next harvest
       if (this.isStandalone || this.agentRuntime.session.state.sessionTraceMode !== _sessionEntity.MODE.ERROR) return;
       const openedSpace = this.trimSTNs(ERROR_MODE_SECONDS_WINDOW); // but maybe we could make some space by discarding irrelevant nodes if we're in sessioned Error mode
-      if (openedSpace == 0) return;
+      if (openedSpace === 0) return;
     }
     if (this.isStandalone && (0, _now.now)() >= MAX_TRACE_DURATION) {
       return;
@@ -474,7 +474,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
        * This isn't exact since nodes go through some processing & EE handlers chain, but it's close enough as we still capture nodes whose duration overlaps the lookback window.
        * ASSUMPTION: all 'end' timings stored are relative to timeOrigin (DOMHighResTimeStamp) and not Unix epoch based. */
       let cutoffIdx = nodeList.findIndex(node => cutoffHighResTime <= node.e);
-      if (cutoffIdx == 0) return;else if (cutoffIdx < 0) {
+      if (cutoffIdx === 0) return;else if (cutoffIdx < 0) {
         // whole list falls outside lookback window and is irrelevant
         cutoffIdx = nodeList.length;
         delete this.trace[nameCategory];
@@ -538,7 +538,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     };
     function trivial(node) {
       const limit = 4;
-      if (node && typeof node.e === 'number' && typeof node.s === 'number' && node.e - node.s < limit) return true;else return false;
+      return !!(node && typeof node.e === 'number' && typeof node.s === 'number' && node.e - node.s < limit);
     }
   }
 }

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.
@@ -95,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', 'setApplicationVersion'];
+  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) {
@@ -128,6 +130,21 @@ function setAPI(agentIdentifier, forceDrain) {
     }
     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();
   };
@@ -154,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/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