@newrelic/browser-agent 1.238.0 → 1.239.0

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

@@ -10,7 +10,6 @@
  * functionality is validated and a full user experience is curated.
  */
 
-import { drain } from '../../../common/drain/drain';
 import { registerHandler } from '../../../common/event-emitter/register-handler';
 import { HarvestScheduler } from '../../../common/harvest/harvest-scheduler';
 import { FEATURE_NAME } from '../constants';
@@ -20,6 +19,7 @@ import { SESSION_EVENTS, MODE } from '../../../common/session/session-entity';
 import { AggregateBase } from '../../utils/aggregate-base';
 import { sharedChannel } from '../../../common/constants/shared-channel';
 import { obj as encodeObj } from '../../../common/url/encode';
+import { warn } from '../../../common/util/console';
 
 // would be better to get this dynamically in some way
 export const RRWEB_VERSION = '2.0.0-alpha.8';
@@ -127,7 +127,7 @@ export class Aggregate extends AggregateBase {
         return this.initializeRecording(flagOn, Math.random() < getConfigurationValue(this.agentIdentifier, 'session_replay.errorSampleRate'), Math.random() < getConfigurationValue(this.agentIdentifier, 'session_replay.sampleRate'));
       }).then(() => sharedChannel.onReplayReady(this.mode)); // notify watchers that replay started with the mode
 
-      drain(this.agentIdentifier, this.featureName);
+      this.drain();
     }
   }
 

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

@@ -8,7 +8,6 @@ import { parseUrl } from '../../../common/url/parse-url';
 import { getConfigurationValue, getRuntime } from '../../../common/config/config';
 import { now } from '../../../common/timing/now';
 import { FEATURE_NAME } from '../constants';
-import { drain } from '../../../common/drain/drain';
 import { HandlerCache } from '../../utils/handler-cache';
 import { MODE, SESSION_EVENTS } from '../../../common/session/session-entity';
 import { getSessionReplayMode } from '../../session_replay/replay-mode';
@@ -137,7 +136,9 @@ export class Aggregate extends AggregateBase {
             });
             mostRecentModeKnown = updatedTraceMode;
           });
-          this.ee.on(SESSION_EVENTS.PAUSE, () => mostRecentModeKnown = sessionEntity.state.sessionTraceMode);
+          this.ee.on(SESSION_EVENTS.PAUSE, () => {
+            mostRecentModeKnown = sessionEntity.state.sessionTraceMode;
+          });
           if (!sessionEntity.isNew) {
             // inherit the same mode as existing session's Trace
             if (sessionEntity.state.sessionReplay === MODE.OFF) this.isStandalone = true;
@@ -209,7 +210,7 @@ export class Aggregate extends AggregateBase {
       }
       return operationalGate.settle(() => _this.processPVT(...args));
     }, this.featureName, this.ee);
-    drain(this.agentIdentifier, this.featureName);
+    this.drain();
   }
   startTracing(startupBuffer) {
     let dontStartHarvestYet = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
@@ -333,8 +334,7 @@ export class Aggregate extends 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) {
@@ -444,7 +444,7 @@ export class Aggregate extends AggregateBase {
       // limit the amount of pending data awaiting next harvest
       if (this.isStandalone || this.agentRuntime.session.state.sessionTraceMode !== 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 && now() >= MAX_TRACE_DURATION) {
       return;
@@ -467,7 +467,7 @@ export class Aggregate extends 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];
@@ -531,7 +531,7 @@ export class Aggregate extends 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/esm/features/spa/aggregate/index.js

@@ -17,7 +17,6 @@ import { HarvestScheduler } from '../../../common/harvest/harvest-scheduler';
 import { Serializer } from './serializer';
 import { ee } from '../../../common/event-emitter/contextual-ee';
 import * as CONSTANTS from '../constants';
-import { drain } from '../../../common/drain/drain';
 import { FEATURE_NAMES } from '../../../loaders/features/features';
 import { AggregateBase } from '../../utils/aggregate-base';
 const {
@@ -135,8 +134,8 @@ export class Aggregate extends AggregateBase {
 
     // register plugins
     var pluginApi = {
-      getCurrentNode: getCurrentNode,
-      setCurrentNode: setCurrentNode
+      getCurrentNode,
+      setCurrentNode
     };
     register('spa-register', function (init) {
       if (typeof init === 'function') {
@@ -201,21 +200,19 @@ export class Aggregate extends 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(evName, this[FN_START], state.lastSeenUrl, state.lastSeenRouteName, onInteractionFinished, agentIdentifier);
+        var ixn = new 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;
           }
         }
       }
@@ -497,7 +494,7 @@ export class Aggregate extends AggregateBase {
     }, this.featureName, promiseEE);
     register(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('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('api', t, state.lastSeenUrl, state.lastSeenRouteName, onInteractionFinished, agentIdentifier);
       if (!state.currentNode) {
         interaction.checkFinish();
         if (state.depth) setCurrentNode(interaction.root);
@@ -665,11 +662,8 @@ export class Aggregate extends AggregateBase {
     }
     function isEnabled() {
       var enabled = getConfigurationValue(agentIdentifier, 'spa.enabled');
-      if (enabled === false) {
-        return false;
-      }
-      return true;
+      return enabled !== false;
     }
-    drain(this.agentIdentifier, this.featureName);
+    this.drain();
   }
 }

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

@@ -7,7 +7,6 @@ import { getInfo, getRuntime, originals } from '../../../common/config/config';
 import { mapOwn } from '../../../common/util/map-own';
 import { ee } from '../../../common/event-emitter/contextual-ee';
 import { InteractionNode } from './interaction-node';
-import { now } from '../../../common/timing/now';
 var originalSetTimeout = originals.ST;
 var originalClearTimeout = originals.CT;
 var lastId = {};
@@ -78,7 +77,6 @@ InteractionPrototype.finish = function finishInteraction() {
   var root = interaction.root;
   if (root.end !== null) return;
   var endTimestamp = Math.max(interaction.lastCb, interaction.lastFinish);
-  var delta = now() - endTimestamp;
   var attrs = root.attrs;
   var customAttrs = attrs.custom;
   if (this.onFinished) {

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

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

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

@@ -3,6 +3,7 @@ import { FeatureBase } from './feature-base';
 import { getInfo, isConfigured, getRuntime } from '../../common/config/config';
 import { configure } from '../../loaders/configure/configure';
 import { gosCDN } from '../../common/window/nreum';
+import { drain } from '../../common/drain/drain';
 export class AggregateBase extends FeatureBase {
   constructor() {
     super(...arguments);
@@ -20,6 +21,9 @@ export class AggregateBase extends FeatureBase {
       registerHandler("rumresp-".concat(fName), isOn => resolve(isOn), this.featureName, this.ee);
     })));
   }
+  drain() {
+    drain(this.agentIdentifier, this.featureName);
+  }
 
   /**
    * Checks for additional `jsAttributes` items to support backward compatibility with implementations of the agent where

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

@@ -36,7 +36,9 @@ export 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/esm/features/utils/instrument-base.js

@@ -32,18 +32,24 @@ export class InstrumentBase extends 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) registerDrain(agentIdentifier, featureName);
+    this.onAggregateImported = undefined;
+
+    /** used in conjunction with newrelic.start() to defer harvesting in features */
+    if (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) registerDrain(agentIdentifier, featureName);
   }
 
   /**
@@ -54,7 +60,19 @@ export class InstrumentBase extends 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
+        registerDrain(this.agentIdentifier, this.featureName);
+        this.auto = true;
+        this.importAggregator();
+      });
+      return;
+    }
     const enableSessionTracking = isBrowserScope && getConfigurationValue(this.agentIdentifier, 'privacy.cookies_enabled') === true;
     let loadedSuccessfully;
     this.onAggregateImported = new Promise(resolve => {
@@ -75,7 +93,7 @@ export class InstrumentBase extends 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/esm/loaders/agent-base.js

@@ -1,3 +1,5 @@
+/* eslint-disable n/handle-callback-err */
+
 import { warn } from '../common/util/console';
 export class AgentBase {
   /**
@@ -89,4 +91,13 @@ export class AgentBase {
   addRelease(name, id) {
     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) {
+    warn('Call to agent api addRelease failed. The agent is not currently initialized.');
+  }
 }

package/dist/esm/loaders/agent.js

@@ -44,7 +44,7 @@ export class Agent extends 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(PageViewEvent);
     Object.assign(this, configure(this.agentIdentifier, options, options.loaderType || 'agent'));
-    this.start();
+    this.run();
   }
   get config() {
     return {
@@ -54,20 +54,20 @@ export class Agent extends AgentBase {
       runtime: 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 = getEnabledFeatures(this.agentIdentifier);
       const featuresToStart = [...this.desiredFeatures];
       featuresToStart.sort((a, b) => featurePriority[a.featureName] - 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 === FEATURE_NAMES.pageViewEvent) {
-          const dependencies = getFeatureDependencyNames(f.featureName);
+        if (enabledFeatures[InstrumentCtor.featureName] || InstrumentCtor.featureName === FEATURE_NAMES.pageViewEvent) {
+          const dependencies = getFeatureDependencyNames(InstrumentCtor.featureName);
           const hasAllDeps = dependencies.every(x => enabledFeatures[x]);
-          if (!hasAllDeps) warn("".concat(f.featureName, " is enabled but one or more dependent features has been disabled (").concat(stringify(dependencies), "). This may cause unintended consequences or missing data..."));
-          this.features[f.featureName] = new f(this.agentIdentifier, this.sharedAggregator);
+          if (!hasAllDeps) warn("".concat(InstrumentCtor.featureName, " is enabled but one or more dependent features has been disabled (").concat(stringify(dependencies), "). This may cause unintended consequences or missing data..."));
+          this.features[InstrumentCtor.featureName] = new InstrumentCtor(this.agentIdentifier, this.sharedAggregator);
         }
       });
       gosNREUMInitializedAgents(this.agentIdentifier, this.features, NR_FEATURES_REF_NAME);

package/dist/esm/loaders/api/api.js

@@ -17,7 +17,7 @@ export const CUSTOM_ATTR_GROUP = 'CUSTOM/'; // the subgroup items should be stor
 
 export function setTopLevelCallers() {
   const nr = 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++) {
@@ -49,7 +49,9 @@ export 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, FEATURE_NAMES.pageAction);
   apiInterface.setCurrentRouteName = apiCall(prefix, 'routeName', true, FEATURE_NAMES.spa);
   apiInterface.setPageViewName = function (name, host) {
@@ -119,6 +121,21 @@ export function setAPI(agentIdentifier, forceDrain) {
     }
     return appendJsAttribute('application.version', value, 'setApplicationVersion', false);
   };
+  apiInterface.start = features => {
+    try {
+      const featNames = Object.values(FEATURE_NAMES);
+      if (features === undefined) features = featNames;else {
+        features = Array.isArray(features) && features.length ? features : [features];
+        if (features.some(f => !featNames.includes(f))) return warn("Invalid feature name supplied. Acceptable feature names are: ".concat(featNames));
+        if (!features.includes(FEATURE_NAMES.pageViewEvent)) features.push(FEATURE_NAMES.pageViewEvent);
+      }
+      features.forEach(feature => {
+        instanceEE.emit("".concat(feature, "-opt-in"));
+      });
+    } catch (err) {
+      warn('An unexpected issue occurred', err);
+    }
+  };
   apiInterface.interaction = function () {
     return new InteractionHandle().get();
   };
@@ -145,14 +162,14 @@ export 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, FEATURE_NAMES.spa);
   });
   function apiCall(prefix, name, notSpa, bufferGroup) {
     return function () {
       handle(SUPPORTABILITY_METRIC_CHANNEL, ['API/' + name + '/called'], undefined, FEATURE_NAMES.metrics, instanceEE);
       if (bufferGroup) handle(prefix + name, [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/esm/loaders/api/apiAsync.js

@@ -13,10 +13,10 @@ export function setAPI(agentIdentifier) {
   var scheme = getConfigurationValue(agentIdentifier, 'ssl') === false ? 'http' : 'https';
   var api = {
     finished: 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
@@ -52,29 +52,28 @@ export function setAPI(agentIdentifier) {
     handle('bstApi', [report], undefined, 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 (!isBrowserScope) return;
-    request_name = window.encodeURIComponent(request_name);
+    requestName = window.encodeURIComponent(requestName);
     cycle += 1;
     const agentInfo = getInfo(agentIdentifier);
-    const agentRuntime = 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/esm/loaders/configure/configure.js

@@ -7,6 +7,7 @@ export 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,
@@ -20,9 +21,11 @@ export function configure(agentIdentifier) {
   if (!info) {
     init = nr.init;
     info = nr.info;
+    // eslint-disable-next-line camelcase
     loader_config = nr.loader_config;
   }
   setConfiguration(agentIdentifier, init || {});
+  // eslint-disable-next-line camelcase
   setLoaderConfig(agentIdentifier, loader_config || {});
   info.jsAttributes ??= {};
   if (isWorkerScope) {

package/dist/esm/loaders/features/enabled-features.js

@@ -1,5 +1,5 @@
 import { FEATURE_NAMES } from './features';
-import { getConfigurationValue, getRuntime } from '../../common/config/config';
+import { getConfigurationValue } from '../../common/config/config';
 const featureNames = Object.values(FEATURE_NAMES);
 function isEnabled(name, agentIdentifier) {
   return getConfigurationValue(agentIdentifier, "".concat(name, ".enabled")) !== false;

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

@@ -6,7 +6,7 @@ import { configure } from './configure/configure';
 import { Aggregator } from '../common/aggregate/aggregator';
 import { gosNREUMInitializedAgents } from '../common/window/nreum';
 import { generateRandomHexString } from '../common/ids/unique-id';
-import { getConfiguration, getInfo, getLoaderConfig, getRuntime } from '../common/config/config';
+import { getConfiguration, getConfigurationValue, getInfo, getLoaderConfig, getRuntime } from '../common/config/config';
 import { FEATURE_NAMES } from './features/features';
 import { warn } from '../common/util/console';
 import { onWindowLoad } from '../common/window/load';
@@ -37,7 +37,14 @@ export class MicroAgent extends 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 => getConfigurationValue(agentIdentifier, "".concat(featureName, ".autoStart"))));
   }
   get config() {
     return {
@@ -47,7 +54,17 @@ export class MicroAgent extends AgentBase {
       runtime: 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 warn("Invalid feature name supplied. Acceptable feature names are: ".concat(featNames));
+        if (!features.includes(FEATURE_NAMES.pageViewEvent)) features.push(FEATURE_NAMES.pageViewEvent);
+      }
+    } catch (err) {
+      warn('An unexpected issue occurred', err);
+    }
     try {
       const enabledFeatures = getEnabledFeatures(this.agentIdentifier);
       try {
@@ -59,7 +76,7 @@ export class MicroAgent extends AgentBase {
       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)) {
             import( /* webpackChunkName: "lazy-feature-loader" */'../features/utils/lazy-feature-loader').then(_ref => {
               let {
                 lazyFeatureLoader

package/dist/types/common/config/state/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../src/common/config/state/init.js"],"names":[],"mappings":"AAqEA,+CAIC;AAED,0DAIC;AAED,+DAYC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../src/common/config/state/init.js"],"names":[],"mappings":"AAsEA,+CAIC;AAED,0DAIC;AAED,+DAYC"}

package/dist/types/common/config/state/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../../src/common/config/state/runtime.js"],"names":[],"mappings":"AA8BA,yCAIC;AAED,oDAIC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../../src/common/config/state/runtime.js"],"names":[],"mappings":"AA4BA,yCAIC;AAED,oDAIC"}

package/dist/types/common/constants/runtime.d.ts

@@ -22,7 +22,7 @@ export const isiOS: boolean;
  * 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: boolean;
+export const iOSBelow16: boolean;
 export const ffVersion: number;
 export const isIE: boolean;
 export const supportsSendBeacon: true;

package/dist/types/common/constants/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/common/constants/runtime.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,qCAEqB;AAErB;;GAEG;AACH,oCAeK;AAEL,oDAUI;AAEJ,qCAAyD;AAEzD,4BAAiE;AAEjE;;;;;;GAMG;AACH,kCAAyE;AAEzE,+BAOI;AAEJ,2BAA2E;AAE3E,sCAAwD"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/common/constants/runtime.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,qCAEqB;AAErB;;GAEG;AACH,oCAeK;AAEL,oDAUI;AAEJ,qCAAyD;AAEzD,4BAAiE;AAEjE;;;;;;GAMG;AACH,iCAAwE;AAExE,+BAOI;AAEJ,2BAA2E;AAE3E,sCAAwD"}

package/dist/types/common/harvest/harvest-scheduler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"harvest-scheduler.d.ts","sourceRoot":"","sources":["../../../../src/common/harvest/harvest-scheduler.js"],"names":[],"mappings":"AAYA;;GAEG;AACH;IACE;;;;;;;;;;SAUK;IACL,sBATa,MAAM;QAES,UAAU;QACV,UAAU;QACZ,UAAU,EAAvB,MAAM;QACQ,GAAG,EAAjB,OAAO;QACM,SAAS,EAAtB,MAAM;oBAoBlB;IAfC,iBAAwB;IACxB;;;oBARW,MAAM;aACN,OAAO;mBACP,MAAM;MAMK;IACtB,iBAAoB;IACpB,mBAAyB;IACzB,iBAAoB;IAEpB,iBAA8C;IAWhD;;;OAGG;IACH,eAKC;IAED,mDAIC;IAHC,cAAwB;IAK1B,uCAMC;IAED,6CAUC;IAED,yCAgEC;IAED,gDAiBC;CACF;8BAjK6B,2BAA2B;wBACjC,WAAW"}
+{"version":3,"file":"harvest-scheduler.d.ts","sourceRoot":"","sources":["../../../../src/common/harvest/harvest-scheduler.js"],"names":[],"mappings":"AAWA;;GAEG;AACH;IACE;;;;;;;;;;SAUK;IACL,sBATa,MAAM;QAES,UAAU;QACV,UAAU;QACZ,UAAU,EAAvB,MAAM;QACQ,GAAG,EAAjB,OAAO;QACM,SAAS,EAAtB,MAAM;oBAoBlB;IAfC,iBAAwB;IACxB;;;oBARW,MAAM;aACN,OAAO;mBACP,MAAM;MAMK;IACtB,iBAAoB;IACpB,mBAAyB;IACzB,iBAAoB;IAEpB,iBAA8C;IAWhD;;;OAGG;IACH,eAKC;IAED,mDAIC;IAHC,cAAwB;IAK1B,uCAMC;IAED,6CAUC;IAED,yCA8DC;IAED,gDAiBC;CACF;8BA9J6B,2BAA2B;wBACjC,WAAW"}

package/dist/types/common/harvest/harvest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"harvest.d.ts","sourceRoot":"","sources":["../../../../src/common/harvest/harvest.js"],"names":[],"mappings":"AAsBA;;;;;;GAMG;AACH;IAII,0BAA2H;IAC3H,uBAAoD;IACpD,kCAAsH;IAEtH,YAAiB;IAGnB;;;;;OAKG;IACH,aAFW,eAAe,WAWzB;IAED;;;OAGG;IACH,YAFW,eAAe,WAMzB;IAED;;;OAGG;IACH,wBAFW,eAAe,WAMzB;IAED;;;;;;OAMG;IACH,gGAJW,eAAe,GACb,OAAO,CAmFnB;IAGD,0BAmBC;IAED;;;;;;;OAOG;IACH,wBALW,yBAAyB,WACzB,6BAA6B,GAE3B,cAAc,CA2B1B;IAED;;;;;;;OAOG;IACH,uBAHW,cAAc,GACZ,cAAc,CAuB1B;IAED;;;;;OAKG;IACH,aAHW,yBAAyB,YACzB,sBAAsB,QAQhC;CACF;8BApPY,OAAO,YAAY,EAAE,eAAe;wCACpC,OAAO,YAAY,EAAE,yBAAyB;6BAC9C,OAAO,YAAY,EAAE,cAAc;qCACnC,OAAO,YAAY,EAAE,sBAAsB;4CAC3C,OAAO,YAAY,EAAE,6BAA6B;8BAZjC,2BAA2B;2BAF9B,mBAAmB"}
+{"version":3,"file":"harvest.d.ts","sourceRoot":"","sources":["../../../../src/common/harvest/harvest.js"],"names":[],"mappings":"AAsBA;;;;;;GAMG;AACH;IAII,0BAA2H;IAC3H,uBAAoD;IACpD,kCAAsH;IAEtH,YAAiB;IAGnB;;;;;OAKG;IACH,aAFW,eAAe,WAWzB;IAED;;;OAGG;IACH,YAFW,eAAe,WAMzB;IAED;;;OAGG;IACH,wBAFW,eAAe,WAMzB;IAED;;;;;;OAMG;IACH,gGAJW,eAAe,GACb,OAAO,CA+EnB;IAGD,0BAmBC;IAED;;;;;;;OAOG;IACH,wBALW,yBAAyB,WACzB,6BAA6B,GAE3B,cAAc,CA2B1B;IAED;;;;;;;OAOG;IACH,uBAHW,cAAc,GACZ,cAAc,CAuB1B;IAED;;;;;OAKG;IACH,aAHW,yBAAyB,YACzB,sBAAsB,QAQhC;CACF;8BAhPY,OAAO,YAAY,EAAE,eAAe;wCACpC,OAAO,YAAY,EAAE,yBAAyB;6BAC9C,OAAO,YAAY,EAAE,cAAc;qCACnC,OAAO,YAAY,EAAE,sBAAsB;4CAC3C,OAAO,YAAY,EAAE,6BAA6B;8BAZjC,2BAA2B;2BAF9B,mBAAmB"}

package/dist/types/common/session/session-entity.d.ts

@@ -16,21 +16,18 @@ export class SessionEntity {
      * expiresMs and inactiveMs are used to "expire" the session, but can be overridden in the constructor. Pass 0 to disable expiration timers.
      */
     constructor(opts: any);
-    setup({ agentIdentifier, key, storage, value, expiresMs, inactiveMs }: {
-        agentIdentifier: any;
-        key: any;
-        storage: any;
+    agentIdentifier: any;
+    storage: any;
+    state: {};
+    key: any;
+    ee: any;
+    setup({ value, expiresMs, inactiveMs }: {
         value?: string | undefined;
         expiresMs?: number | undefined;
         inactiveMs?: number | undefined;
     }): void;
-    agentIdentifier: any;
-    storage: any;
-    state: {} | undefined;
-    key: any;
     expiresMs: number | undefined;
     inactiveMs: number | undefined;
-    ee: any;
     expiresTimer: Timer | undefined;
     inactiveTimer: InteractionTimer | undefined;
     isNew: boolean | undefined;

package/dist/types/common/session/session-entity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-entity.d.ts","sourceRoot":"","sources":["../../../../src/common/session/session-entity.js"],"names":[],"mappings":";;;;;;;;;;AAoCA;IACE;;;;;OAKG;IACH,uBAEC;IAED;;;;;;;aAkFC;IA9EC,qBAAsC;IACtC,aAAsB;IACtB,sBAAe;IAKf,SAAc;IAId,8BAA0B;IAC1B,+BAA4B;IAE5B,QAAiC;IAgB/B,gCAOqC;IAUrC,4CAiBsC;IAOV,2BAA6C;IAM3E,iCAAuB;IAIzB,wBAEC;IAED,sBAEC;IAED;;;OAGG;IACH,QAFa,MAAM,CA6BlB;IAED;;;;;;OAMG;IACH,YAHW,MAAM,GACJ,MAAM,CAiBlB;IAED,gBAuBC;IAED;;OAEG;IACH,gBAIC;IAED;;;OAGG;IACH,qBAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;OAGG;IACH,gBAHW,MAAM,GACJ,OAAO,CAKnB;IAED,yDAYC;IAED;;;OAGG;IACH,6BAHW,MAAM,GACJ,MAAM,CAIlB;IAED,gDAaC;IAHG,YAAuD;CAI5D;sBAxRqB,gBAAgB;iCAGL,4BAA4B"}
+{"version":3,"file":"session-entity.d.ts","sourceRoot":"","sources":["../../../../src/common/session/session-entity.js"],"names":[],"mappings":";;;;;;;;;;AAoCA;IACE;;;;;OAKG;IACH,uBAgBC;IAVC,qBAAsC;IACtC,aAAsB;IACtB,UAAe;IAGf,SAAc;IAEd,QAAiC;IAKnC;;;;aAsEC;IA/DC,8BAA0B;IAC1B,+BAA4B;IAc1B,gCAOqC;IAUrC,4CAiBsC;IAOV,2BAA6C;IAM3E,iCAAuB;IAIzB,wBAEC;IAED,sBAEC;IAED;;;OAGG;IACH,QAFa,MAAM,CA6BlB;IAED;;;;;;OAMG;IACH,YAHW,MAAM,GACJ,MAAM,CAiBlB;IAED,gBAuBC;IAED;;OAEG;IACH,gBAIC;IAED;;;OAGG;IACH,qBAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;OAGG;IACH,gBAHW,MAAM,GACJ,OAAO,CAKnB;IAED,yDAYC;IAED;;;OAGG;IACH,6BAHW,MAAM,GACJ,MAAM,CAIlB;IAED,gDAaC;IAHG,YAAuD;CAI5D;sBA1RqB,gBAAgB;iCAGL,4BAA4B"}

package/dist/types/common/storage/first-party-cookies.d.ts

@@ -3,6 +3,6 @@ export class FirstPartyCookies {
     domain: any;
     get(name: any): string | undefined;
     set(key: any, value: any): void;
-    remove(key: any): string | undefined;
+    remove(key: any): void;
 }
 //# sourceMappingURL=first-party-cookies.d.ts.map

package/dist/types/common/storage/first-party-cookies.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"first-party-cookies.d.ts","sourceRoot":"","sources":["../../../../src/common/storage/first-party-cookies.js"],"names":[],"mappings":"AAAA;IACE,yBAEC;IADC,YAAoB;IAGtB,mCAOC;IAED,gCAOC;IAED,qCAMC;CACF"}
+{"version":3,"file":"first-party-cookies.d.ts","sourceRoot":"","sources":["../../../../src/common/storage/first-party-cookies.js"],"names":[],"mappings":"AAAA;IACE,yBAEC;IADC,YAAoB;IAGtB,mCAQC;IAED,gCAOC;IAED,uBAMC;CACF"}

package/dist/types/common/storage/local-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-storage.d.ts","sourceRoot":"","sources":["../../../../src/common/storage/local-storage.js"],"names":[],"mappings":"AAAA;IACE,kCAQC;IAED,gCAOC;IAED,uBAMC;CACF"}
+{"version":3,"file":"local-storage.d.ts","sourceRoot":"","sources":["../../../../src/common/storage/local-storage.js"],"names":[],"mappings":"AAAA;IACE,kCASC;IAED,gCAOC;IAED,uBAMC;CACF"}