@newrelic/browser-agent 1.235.0 → 1.236.0

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

@@ -1,4 +1,5 @@
 // loader files
+import { Instrument as PVE } from '../features/page_view_event/instrument';
 import { getEnabledFeatures } from './features/enabled-features';
 import { configure } from './configure/configure';
 // core files
@@ -8,14 +9,13 @@ import { generateRandomHexString } from '../common/ids/unique-id';
 import { getConfiguration, getInfo, getLoaderConfig, getRuntime } from '../common/config/config';
 import { FEATURE_NAMES } from './features/features';
 import { warn } from '../common/util/console';
-const nonAutoFeatures = [FEATURE_NAMES.jserrors, FEATURE_NAMES.pageAction];
-const autoFeatures = [FEATURE_NAMES.metrics];
+import { onWindowLoad } from '../common/window/load';
+const nonAutoFeatures = [FEATURE_NAMES.jserrors, FEATURE_NAMES.pageAction, FEATURE_NAMES.metrics];
 
 /**
- * A minimal agent class designed to be loaded multiple times on the same page, each instance narrowly scoped to the
- * concerns of a particular component, as with the micro-frontend architectural pattern. This class does not
- * automatically instrument. Instead, each MicroAgent instance may be configured to lazy-load specific
- * instrumentations at runtime, and to report desired data, events, and errors programatically.
+ * A minimal agent class designed to only respond to manual user input. As such, this class does not
+ * automatically instrument. Instead, each MicroAgent instance will lazy load the required features and can support loading multiple instances on one page.
+ * Out of the box, it can manually handle and report Page View, Page Action, and Error events.
  */
 export class MicroAgent {
   /**
@@ -48,38 +48,29 @@ export class MicroAgent {
   start() {
     try {
       const enabledFeatures = getEnabledFeatures(this.agentIdentifier);
-      autoFeatures.forEach(f => {
-        if (enabledFeatures[f]) {
-          // TODO - THIS does not work, the instrument switch in lazy loader increases the size of the worker build.  Needs to be revisited
-          import( /* webpackChunkName: "lazy-feature-loader" */'../features/utils/lazy-feature-loader').then(_ref => {
-            let {
-              lazyFeatureLoader
-            } = _ref;
-            return lazyFeatureLoader(f, 'instrument');
-          }).then(_ref2 => {
-            let {
-              Instrument
-            } = _ref2;
-            this.features[f] = new Instrument(this.agentIdentifier, this.sharedAggregator);
-          }).catch(err => warn('Something prevented the agent from being downloaded.'));
-        }
-      });
-      nonAutoFeatures.forEach(f => {
-        if (enabledFeatures[f]) {
-          // TODO - THIS does not work, the instrument switch in lazy loader increases the size of the worker build.  Needs to be revisited
-          // Parts of the lazy-loader were removed because webpack was transpiling them into the worker build, errantly inflating the build size.
-          import( /* webpackChunkName: "lazy-feature-loader" */'../features/utils/lazy-feature-loader').then(_ref3 => {
-            let {
-              lazyFeatureLoader
-            } = _ref3;
-            return lazyFeatureLoader(f, 'aggregate');
-          }).then(_ref4 => {
-            let {
-              Aggregate
-            } = _ref4;
-            this.features[f] = new Aggregate(this.agentIdentifier, this.sharedAggregator);
-          }).catch(err => warn('Something prevented the agent from being downloaded.'));
-        }
+      try {
+        // a biproduct of doing this is that the "session manager" is automatically handled through importing this feature
+        this.features.page_view_event = new PVE(this.agentIdentifier, this.sharedAggregator);
+      } catch (err) {
+        warn('Something prevented the agent from instrumenting.', err);
+      }
+      onWindowLoad(() => {
+        // these features do not import an "instrument" file, meaning they are only hooked up to the API.
+        nonAutoFeatures.forEach(f => {
+          if (enabledFeatures[f]) {
+            import( /* webpackChunkName: "lazy-feature-loader" */'../features/utils/lazy-feature-loader').then(_ref => {
+              let {
+                lazyFeatureLoader
+              } = _ref;
+              return lazyFeatureLoader(f, 'aggregate');
+            }).then(_ref2 => {
+              let {
+                Aggregate
+              } = _ref2;
+              this.features[f] = new Aggregate(this.agentIdentifier, this.sharedAggregator);
+            }).catch(err => warn('Something prevented the agent from being downloaded.', err));
+          }
+        });
       });
       gosNREUMInitializedAgents(this.agentIdentifier, this.features, 'features');
       return this;

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":"AAoEA,+CAIC;AAED,0DAIC;AAED,+DAYC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../src/common/config/state/init.js"],"names":[],"mappings":"AAqEA,+CAIC;AAED,0DAIC;AAED,+DAYC"}

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

@@ -0,0 +1,29 @@
+/**
+ * @file Contains constants about the environment the agent is running
+ * within. These values are derived at the time the agent is first loaded.
+ * @copyright 2023 New Relic Corporation. All rights reserved.
+ * @license Apache-2.0
+ */
+/**
+ * Indicates if the agent is running within a normal browser window context.
+ */
+export const isBrowserScope: boolean;
+/**
+ * Indicates if the agent is running within a worker context.
+ */
+export const isWorkerScope: boolean;
+export const globalScope: false | typeof globalThis;
+export const initialLocation: string;
+export const isiOS: boolean;
+/**
+ * Shared Web Workers introduced in iOS 16.0+ and n/a in 15.6-
+ *
+ * It was discovered in Safari 14 (https://bugs.webkit.org/show_bug.cgi?id=225305) that the buffered flag in PerformanceObserver
+ * 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 ffVersion: number;
+export const isIE: boolean;
+export const supportsSendBeacon: true;
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +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"}

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

@@ -29,7 +29,7 @@ export class HarvestScheduler extends SharedContext {
         customUrl: string;
     };
     started: boolean;
-    timeoutHandle: NodeJS.Timeout | null;
+    timeoutHandle: any;
     aborted: boolean;
     harvest: Harvest;
     /**

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,qCAAyB;IACzB,iBAAoB;IAEpB,iBAA8C;IAWhD;;;OAGG;IACH,eAKC;IAED,mDAIC;IAHC,cAAwB;IAK1B,uCAMC;IAED,6CAWC;IAED,yCA8DC;IAED,gDAiBC;CACF;8BAhK6B,2BAA2B;wBAChB,WAAW"}
+{"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"}

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

@@ -1,21 +1,10 @@
-export function getSubmitMethod(endpoint: any, opts: any): {
-    method: (({ url, body, sync, method, headers }: {
-        url: string;
-        body?: string | undefined;
-        sync?: boolean | undefined;
-        method?: string | undefined;
-        headers?: {
-            key: string;
-            value: string;
-        }[] | undefined;
-    }) => XMLHttpRequest) | (({ url }: {
-        url: string;
-    }) => HTMLImageElement) | (({ url, body }: {
-        url: string;
-        body?: string | undefined;
-    }) => boolean);
-    useBody: boolean;
-};
+/**
+ * @typedef {import('./types.js').NetworkSendSpec} NetworkSendSpec
+ * @typedef {import('./types.js').HarvestEndpointIdentifier} HarvestEndpointIdentifier
+ * @typedef {import('./types.js').HarvestPayload} HarvestPayload
+ * @typedef {import('./types.js').FeatureHarvestCallback} FeatureHarvestCallback
+ * @typedef {import('./types.js').FeatureHarvestCallbackOptions} FeatureHarvestCallbackOptions
+ */
 export class Harvest extends SharedContext {
     tooManyRequestsDelay: any;
     obfuscator: Obfuscator;
@@ -24,38 +13,60 @@ export class Harvest extends SharedContext {
     /**
      * Initiate a harvest from multiple sources. An event that corresponds to the endpoint
      * name is emitted, which gives any listeners the opportunity to provide payload data.
+     * Note: Used by page_action
      * @param {NetworkSendSpec} spec Specification for sending data
      */
-    sendX(spec: NetworkSendSpec): any;
+    sendX(spec?: NetworkSendSpec): boolean;
     /**
      * Initiate a harvest call.
      * @param {NetworkSendSpec} spec Specification for sending data
      */
-    send(spec: NetworkSendSpec): any;
+    send(spec?: NetworkSendSpec): boolean;
     /**
      * Apply obfuscation rules to the payload and then initial the harvest network call.
      * @param {NetworkSendSpec} spec Specification for sending data
      */
-    obfuscateAndSend(spec: NetworkSendSpec): any;
-    _send({ endpoint, payload, opts, submitMethod, cbFinished, customUrl, raw, includeBaseParams }: {
-        endpoint: any;
-        payload?: {} | undefined;
-        opts?: {} | undefined;
-        submitMethod: any;
-        cbFinished: any;
-        customUrl: any;
-        raw: any;
-        includeBaseParams?: boolean | undefined;
-    }): any;
+    obfuscateAndSend(spec?: NetworkSendSpec): boolean;
+    /**
+     * Initiate a harvest call. Typically used by `sendX` and `send` methods or called directly
+     * for raw network calls.
+     * @param {NetworkSendSpec} param0 Specification for sending data
+     * @returns {boolean} True if the network call succeeded. For final harvest calls, the return
+     * value should not be relied upon because network calls will be made asynchronously.
+     */
+    _send({ endpoint, payload, opts, submitMethod, cbFinished, customUrl, raw, includeBaseParams }: NetworkSendSpec): boolean;
     baseQueryString(): string;
-    createPayload(type: any, options: any): {
-        body: {} | undefined;
-        qs: {} | undefined;
-    };
-    on(type: any, listener: any): void;
-    resetListeners(): void;
+    /**
+     * Calls and accumulates data from registered harvesting functions based on
+     * the endpoint being harvested.
+     * @param {HarvestEndpointIdentifier} endpoint BAM endpoint identifier.
+     * @param {FeatureHarvestCallbackOptions} options Options to be passed to the
+     * feature harvest listener callback.
+     * @returns {HarvestPayload} Payload object to transmit to the bam endpoint.
+     */
+    createPayload(endpoint: HarvestEndpointIdentifier, options: FeatureHarvestCallbackOptions): HarvestPayload;
+    /**
+     * Cleans and returns a payload object containing a body and qs
+     * object with key/value pairs. KV pairs where the value is null,
+     * undefined, or an empty string are removed to save on transmission
+     * size.
+     * @param {HarvestPayload} payload Payload to be sent to the endpoint.
+     * @returns {HarvestPayload} Cleaned payload payload to be sent to the endpoint.
+     */
+    cleanPayload(payload?: HarvestPayload): HarvestPayload;
+    /**
+     * Registers a function to be called when harvesting is triggered for a specific
+     * endpoint.
+     * @param {HarvestEndpointIdentifier} endpoint
+     * @param {FeatureHarvestCallback} listener
+     */
+    on(endpoint: HarvestEndpointIdentifier, listener: FeatureHarvestCallback): void;
 }
-export type NetworkSendSpec = object;
+export type NetworkSendSpec = import('./types.js').NetworkSendSpec;
+export type HarvestEndpointIdentifier = import('./types.js').HarvestEndpointIdentifier;
+export type HarvestPayload = import('./types.js').HarvestPayload;
+export type FeatureHarvestCallback = import('./types.js').FeatureHarvestCallback;
+export type FeatureHarvestCallbackOptions = import('./types.js').FeatureHarvestCallbackOptions;
 import { SharedContext } from '../context/shared-context';
 import { Obfuscator } from '../util/obfuscate';
 //# sourceMappingURL=harvest.d.ts.map

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":"AAkOA;;;;;;;;;;;;;;;;;EAmBC;AA9MD;IAII,0BAA2H;IAC3H,uBAAoD;IACpD,kCAAsH;IAEtH,YAAiB;IAGnB;;;;OAIG;IACH,YAFW,eAAe,OAYzB;IAED;;;OAGG;IACH,WAFW,eAAe,OAazB;IAED;;;OAGG;IACH,uBAFW,eAAe,OAMzB;IAED;;;;;;;;;YAiFC;IAGD,0BAmBC;IAED;;;MAaC;IAED,mCAGC;IAED,uBAIC;CACF;8BA3MY,MAAM;8BALW,2BAA2B;2BAF9B,mBAAmB"}
+{"version":3,"file":"harvest.d.ts","sourceRoot":"","sources":["../../../../src/common/harvest/harvest.js"],"names":[],"mappings":"AAmBA;;;;;;GAMG;AAEH;IAII,0BAA2H;IAC3H,uBAAoD;IACpD,kCAAsH;IAEtH,YAAiB;IAGnB;;;;;OAKG;IACH,aAFW,eAAe,WAUzB;IAED;;;OAGG;IACH,YAFW,eAAe,WAMzB;IAED;;;OAGG;IACH,wBAFW,eAAe,WAMzB;IAED;;;;;;OAMG;IACH,gGAJW,eAAe,GACb,OAAO,CA8FnB;IAGD,0BAmBC;IAED;;;;;;;OAOG;IACH,wBALW,yBAAyB,WACzB,6BAA6B,GAE3B,cAAc,CA2B1B;IAED;;;;;;;OAOG;IACH,uBAHW,cAAc,GACZ,cAAc,CAwB1B;IAED;;;;;OAKG;IACH,aAHW,yBAAyB,YACzB,sBAAsB,QAQhC;CACF;8BAhQY,OAAO,YAAY,EAAE,eAAe;wCACpC,OAAO,YAAY,EAAE,yBAAyB;6BAC9C,OAAO,YAAY,EAAE,cAAc;qCACnC,OAAO,YAAY,EAAE,sBAAsB;4CAC3C,OAAO,YAAY,EAAE,6BAA6B;8BATjC,2BAA2B;2BAF9B,mBAAmB"}

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

@@ -0,0 +1,100 @@
+/**
+ * @file Contains types related to harvesting data.
+ * @copyright 2023 New Relic Corporation. All rights reserved.
+ * @license Apache-2.0
+ */
+/**
+ * @typedef {'rum'|'jserrors'|'events'|'ins'|'resources'|'blob'} HarvestEndpointIdentifier
+ */
+/**
+ * @typedef {object} HarvestPayload
+ * @property {object} qs Map of values that should be sent as part of the request query string.
+ * @property {object} body Map of values that should be sent as the body of the request.
+ * @property {string} body.e Special case of body used for browser interactions.
+ */
+/**
+ * @typedef {object} FeatureHarvestCallbackOptions Options for aggregating data for harvesting.
+ * @property {boolean} options.retry Indicates if the feature should store the aggregated
+ * data in anticipation of a possible need to retry the transmission.
+ */
+/**
+ * @callback FeatureHarvestCallback
+ * @param {FeatureHarvestCallbackOptions} options Options for aggregating data for harvesting.
+ * @returns {HarvestPayload} Payload of data to transmit to bam endpoint.
+ */
+/**
+ * @typedef {object} NetworkSendSpec
+ * @property {HarvestEndpointIdentifier} endpoint The endpoint to use (jserrors, events, resources etc.)
+ * @property {HarvestPayload} payload Object representing payload.
+ * @property {object} opts Additional options for sending data
+ * @property {boolean} opts.needResponse Specify whether the caller expects a response data.
+ * @property {boolean} opts.unload Specify whether the call is a final harvest during page unload.
+ * @property {boolean} opts.sendEmptyBody Specify whether the call should be made even if the body is empty. Useful for rum calls.
+ * @property {boolean} opts.retry Indicates if the feature should store the aggregated data in anticipation of a possible need to
+ * retry the transmission.
+ * @property {import('../util/submit-data.js').NetworkMethods} submitMethod The network method to use {@link ../util/submit-data.js}
+ * @property {string} customUrl Override the beacon url the data is sent to; must include protocol if defined
+ * @property {boolean} raw If true, disables adding the license key to the url
+ * @property {boolean} includeBaseParams Enables the use of base query parameters in the beacon url
+ */
+export const unused: {};
+export type HarvestEndpointIdentifier = 'rum' | 'jserrors' | 'events' | 'ins' | 'resources' | 'blob';
+export type HarvestPayload = {
+    /**
+     * Map of values that should be sent as part of the request query string.
+     */
+    qs: object;
+    /**
+     * Map of values that should be sent as the body of the request.
+     */
+    body: {
+        e: string;
+    };
+};
+/**
+ * Options for aggregating data for harvesting.
+ */
+export type FeatureHarvestCallbackOptions = {
+    /**
+     * Indicates if the feature should store the aggregated
+     * data in anticipation of a possible need to retry the transmission.
+     */
+    retry: boolean;
+};
+export type FeatureHarvestCallback = (options: FeatureHarvestCallbackOptions) => HarvestPayload;
+export type NetworkSendSpec = {
+    /**
+     * The endpoint to use (jserrors, events, resources etc.)
+     */
+    endpoint: HarvestEndpointIdentifier;
+    /**
+     * Object representing payload.
+     */
+    payload: HarvestPayload;
+    /**
+     * Additional options for sending data
+     */
+    opts: {
+        needResponse: boolean;
+        unload: boolean;
+        sendEmptyBody: boolean;
+        retry: boolean;
+    };
+    /**
+     * The network method to use {@link  ../util/submit-data.js}
+     */
+    submitMethod: import('../util/submit-data.js').NetworkMethods;
+    /**
+     * Override the beacon url the data is sent to; must include protocol if defined
+     */
+    customUrl: string;
+    /**
+     * If true, disables adding the license key to the url
+     */
+    raw: boolean;
+    /**
+     * Enables the use of base query parameters in the beacon url
+     */
+    includeBaseParams: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/common/harvest/types.js"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AAEH;;;;;GAKG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;;;;GAcG;AAGH,wBAAwB;wCAvCX,KAAK,GAAC,UAAU,GAAC,QAAQ,GAAC,KAAK,GAAC,WAAW,GAAC,MAAM;;;;;QAKjD,MAAM;;;;;QAEO,CAAC,EAAd,MAAM;;;;;;;;;;;WAKN,OAAO;;+CAMV,6BAA6B,KAC3B,cAAc;;;;;cAKb,yBAAyB;;;;aACzB,cAAc;;;;;QAEA,YAAY,EAA1B,OAAO;QACO,MAAM,EAApB,OAAO;QACO,aAAa,EAA3B,OAAO;QACO,KAAK,EAAnB,OAAO;;;;;kBAEP,OAAO,wBAAwB,EAAE,cAAc;;;;eAC/C,MAAM;;;;SACN,OAAO;;;;uBACP,OAAO"}

package/dist/types/common/unload/eol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eol.d.ts","sourceRoot":"","sources":["../../../../src/common/unload/eol.js"],"names":[],"mappings":"AAsBA;;;;;GAKG;AACH,2DAFW,OAAO,QAmCjB"}
+{"version":3,"file":"eol.d.ts","sourceRoot":"","sources":["../../../../src/common/unload/eol.js"],"names":[],"mappings":"AAqBA;;;;;GAKG;AACH,2DAFW,OAAO,QAmCjB"}

package/dist/types/common/util/submit-data.d.ts

@@ -1,65 +1,63 @@
-export namespace submitData {
-    /**
-     * Send via JSONP. Do NOT call this function outside of a guaranteed web window environment.
-     * @param {Object} args - The args
-     * @param {string} args.url - The URL to send to
-     * @param {string} args.jsonp - The string name of the jsonp cb method
-     * @returns {XMLHttpRequest}
-     * @returns {Element}
-     */
-    function jsonp({ url, jsonp }: {
-        url: string;
-        jsonp: string;
-    }): XMLHttpRequest;
-    /**
-     * Performs an asynchronous GET request using XMLHttpRequest.
-     *
-     * @param {Object} args - An object containing a `url` property.
-     * @param {string} args.url - The URL to send the GET request to.
-     * @returns {XMLHttpRequest} - An XMLHttpRequest object.
-     */
-    function xhrGet({ url }: {
-        url: string;
-    }): XMLHttpRequest;
-    /**
-     * Send via XHR
-     * @param {Object} args - The args.
-     * @param {string} args.url - The URL to send to.
-     * @param {string=} args.body - The Stringified body. Default null to prevent IE11 from breaking.
-     * @param {boolean=} args.sync - Run XHR synchronously.
-     * @param {string=} [args.method=POST] - The XHR method to use.
-     * @param {{key: string, value: string}[]} [args.headers] - The headers to attach.
-     * @returns {XMLHttpRequest}
-     */
-    function xhr({ url, body, sync, method, headers }: {
-        url: string;
-        body?: string | undefined;
-        sync?: boolean | undefined;
-        method?: string | undefined;
-        headers?: {
-            key: string;
-            value: string;
-        }[] | undefined;
-    }): XMLHttpRequest;
-    /**
-     * Send by appending an <img> element to the page. Do NOT call this function outside of a guaranteed web window environment.
-     * @param {Object} args - The args
-     * @param {string} args.url - The URL to send to
-     * @returns {HTMLImageElement}
-     */
-    function img({ url }: {
-        url: string;
-    }): HTMLImageElement;
-    /**
-     * Send via sendBeacon. Do NOT call this function outside of a guaranteed web window environment.
-     * @param {Object} args - The args
-     * @param {string} args.url - The URL to send to
-     * @param {string=} args.body - The Stringified body
-     * @returns {boolean}
-     */
-    function beacon({ url, body }: {
-        url: string;
-        body?: string | undefined;
-    }): boolean;
-}
+/**
+ * @typedef {xhr|fetchKeepAlive|beacon} NetworkMethods
+ */
+/**
+ * Determines the submit method to use based on options.
+ * @param {object} opts Options used to determine submit method.
+ * @param {boolean} opts.isFinalHarvest Indicates if the data submission is due to
+ * a final harvest within the agent.
+ */
+export function getSubmitMethod({ isFinalHarvest }?: {
+    isFinalHarvest: boolean;
+}): typeof xhr | typeof beacon;
+/**
+ * Send via XHR
+ * @param {Object} args - The args.
+ * @param {string} args.url - The URL to send to.
+ * @param {string=} args.body - The Stringified body. Default null to prevent IE11 from breaking.
+ * @param {boolean=} args.sync - Run XHR synchronously.
+ * @param {string=} [args.method=POST] - The XHR method to use.
+ * @param {{key: string, value: string}[]} [args.headers] - The headers to attach.
+ * @returns {XMLHttpRequest}
+ */
+export function xhr({ url, body, sync, method, headers }: {
+    url: string;
+    body?: string | undefined;
+    sync?: boolean | undefined;
+    method?: string | undefined;
+    headers?: {
+        key: string;
+        value: string;
+    }[] | undefined;
+}): XMLHttpRequest;
+/**
+ * Send via fetch with keepalive true
+ * @param {Object} args - The args.
+ * @param {string} args.url - The URL to send to.
+ * @param {string=} args.body - The Stringified body.
+ * @param {string=} [args.method=POST] - The XHR method to use.
+ * @param {{key: string, value: string}[]} [args.headers] - The headers to attach.
+ * @returns {XMLHttpRequest}
+ */
+export function fetchKeepAlive({ url, body, method, headers }: {
+    url: string;
+    body?: string | undefined;
+    method?: string | undefined;
+    headers?: {
+        key: string;
+        value: string;
+    }[] | undefined;
+}): XMLHttpRequest;
+/**
+ * Send via sendBeacon. Do NOT call this function outside of a guaranteed web window environment.
+ * @param {Object} args - The args
+ * @param {string} args.url - The URL to send to
+ * @param {string=} args.body - The Stringified body
+ * @returns {boolean}
+ */
+export function beacon({ url, body }: {
+    url: string;
+    body?: string | undefined;
+}): boolean;
+export type NetworkMethods = typeof xhr | typeof fetchKeepAlive | typeof beacon;
 //# sourceMappingURL=submit-data.d.ts.map

package/dist/types/common/util/submit-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"submit-data.d.ts","sourceRoot":"","sources":["../../../../src/common/util/submit-data.js"],"names":[],"mappings":";IAOA;;;;;;;OAOG;IACH;;;uBAsBC;IAED;;;;;;OAMG;IACH;;uBAEC;IAED;;;;;;;;;OASG;IACH;;;;;;;;;uBAiBC;IAED;;;;;OAKG;IACH;;yBAIC;IAED;;;;;;OAMG;IACH;;;gBAYC"}
+{"version":3,"file":"submit-data.d.ts","sourceRoot":"","sources":["../../../../src/common/util/submit-data.js"],"names":[],"mappings":"AAQA;;GAEG;AAEH;;;;;GAKG;AACH;IAHyB,cAAc,EAA5B,OAAO;+BAUjB;AAED;;;;;;;;;GASG;AACH;IAPwB,GAAG,EAAhB,MAAM;IACQ,IAAI,GAAlB,MAAM;IACS,IAAI,GAAnB,OAAO;IACQ,MAAM,GAArB,MAAM;IACgC,OAAO;aAAvC,MAAM;eAAS,MAAM;;IACzB,cAAc,CAmB1B;AAED;;;;;;;;GAQG;AACH;IANwB,GAAG,EAAhB,MAAM;IACQ,IAAI,GAAlB,MAAM;IACS,MAAM,GAArB,MAAM;IACgC,OAAO;aAAvC,MAAM;eAAS,MAAM;;IACzB,cAAc,CAY1B;AAED;;;;;;GAMG;AACH;IAJwB,GAAG,EAAhB,MAAM;IACQ,IAAI,GAAlB,MAAM;IACJ,OAAO,CAcnB;6BAvFY,kDAAyB"}

package/dist/types/features/ajax/instrument/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/ajax/instrument/index.js"],"names":[],"mappings":"AA0BA;IACE,2BAAiC;IACjC,mEAcC;IARC,mBAAiC;IAEjC,4EAAkF;CAOrF;+BA5B8B,6BAA6B;mBAFzC,uBAAuB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/ajax/instrument/index.js"],"names":[],"mappings":"AAyBA;IACE,2BAAiC;IACjC,mEAcC;IARC,mBAAiC;IAEjC,4EAAkF;CAOrF;+BA3B8B,6BAA6B;mBAFzC,uBAAuB"}

package/dist/types/features/jserrors/aggregate/index.d.ts

@@ -16,7 +16,7 @@ export class Aggregate extends AggregateBase {
     currentBody: any;
     onHarvestFinished(result: any): void;
     nameHash(params: any): number;
-    getBucketName(params: any, customParams: any): string;
+    getBucketName(objType: any, params: any, customParams: any): string;
     /**
      * Builds a standardized stack trace string from the frames in the given `stackInfo` object, with each frame separated
      * by a newline character. Lines take the form `<functionName>@<url>:<lineNumber>`.

package/dist/types/features/jserrors/aggregate/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/jserrors/aggregate/index.js"],"names":[],"mappings":"AAwBA;;GAEG;AAEH;IACE,2BAAiC;IACjC,mDAoCC;IAjCC,kBAAuB;IACvB,eAAoB;IACpB,qBAA0B;IAC1B,eAAoB;IAEpB,qBAAwB;IA8B1B;;;MAoBC;IAfG,iBAAuB;IAiB3B,qCAWC;IAED,8BAEC;IAED,sDAEC;IAED;;;;;;OAMG;IACH,qCAHW,SAAS,GACP,MAAM,CAgBlB;IAED,4EA4FC;IAED,2CAgCC;IAED,+CA2BC;CACF;wBAzQY,OAAO,0BAA0B,EAAE,SAAS;8BAH3B,4BAA4B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/jserrors/aggregate/index.js"],"names":[],"mappings":"AAwBA;;GAEG;AAEH;IACE,2BAAiC;IACjC,mDAoCC;IAjCC,kBAAuB;IACvB,eAAoB;IACpB,qBAA0B;IAC1B,eAAoB;IAEpB,qBAAwB;IA8B1B;;;MAoBC;IAfG,iBAAuB;IAiB3B,qCAWC;IAED,8BAEC;IAED,oEAMC;IAED;;;;;;OAMG;IACH,qCAHW,SAAS,GACP,MAAM,CAgBlB;IAED,4EA4FC;IAED,2CAgCC;IAED,+CA2BC;CACF;wBA7QY,OAAO,0BAA0B,EAAE,SAAS;8BAH3B,4BAA4B"}

package/dist/types/features/jserrors/instrument/index.d.ts

@@ -3,7 +3,7 @@ export class Instrument extends InstrumentBase {
     constructor(agentIdentifier: any, aggregator: any, auto?: boolean);
     skipNext: number;
     removeOnAbort: AbortController | undefined;
-    origOnerror: OnErrorEventHandler;
+    origOnerror: any;
     abortHandler: () => void;
     /**
      * FF and Android browsers do not provide error info to the 'error' event callback,

package/dist/types/features/jserrors/instrument/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/jserrors/instrument/index.js"],"names":[],"mappings":"AAkBA;IACE,2BAAiC;IACjC,mEAgDC;IA5CC,iBAAiB;IAGf,2CAA0C;IAyB5C,iCAAsC;IActC,yBAA+B;IAUjC;;;;;;;;;OASG;IACH,wBAPW,MAAM,YACN,MAAM,UACN,MAAM,UACN,MAAM,YACN,KAAK,MAAI,2BAiBnB;;CACF;+BA3F8B,6BAA6B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/jserrors/instrument/index.js"],"names":[],"mappings":"AAkBA;IACE,2BAAiC;IACjC,mEAgDC;IA5CC,iBAAiB;IAGf,2CAA0C;IAyB5C,iBAAsC;IActC,yBAA+B;IAUjC;;;;;;;;;OASG;IACH,wBAPW,MAAM,YACN,MAAM,UACN,MAAM,UACN,MAAM,YACN,KAAK,MAAI,2BAiBnB;;CACF;+BA3F8B,6BAA6B"}

package/dist/types/features/page_view_event/aggregate/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/page_view_event/aggregate/index.js"],"names":[],"mappings":"AAiBA;IACE,2BAA2C;IAC3C,mDA2BC;IAvBG,iCAAwB;IAyB5B,8BAEC;IAED,gBAyFC;CACF;8BA/H6B,4BAA4B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/page_view_event/aggregate/index.js"],"names":[],"mappings":"AAgBA;IACE,2BAA2C;IAC3C,mDA2BC;IAvBG,iCAAwB;IAyB5B,8BAEC;IAED,gBAyFC;CACF;8BA/H6B,4BAA4B"}

package/dist/types/features/page_view_timing/aggregate/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/page_view_timing/aggregate/index.js"],"names":[],"mappings":"AAqBA;IACE,2BAAiC;IACjC,mDA4GC;IAzGC,eAAiB;IACjB,mBAAqB;IACrB,4BAA+B;IAC/B,mBAAe;IAKf,sBAA4B;IAkF5B,4BAGQ;IAeV,8CAUC;IAED;;;OAGG;IACH,6BAFW,MAAM,QAOhB;IAED;;OAEG;IACH,uCAUC;IAED,mDAqBC;IAED,qCAOC;IAED,gDAWC;IAGD;;;;kBAWC;IAGD,8BAuBC;CACF;8BA7O6B,4BAA4B;iCARzB,2CAA2C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/page_view_timing/aggregate/index.js"],"names":[],"mappings":"AAqBA;IACE,2BAAiC;IACjC,mDA4GC;IAzGC,eAAiB;IACjB,mBAAqB;IACrB,4BAA+B;IAC/B,mBAAe;IAKf,sBAA4B;IAkF5B,4BAGQ;IAeV,8CAUC;IAED;;;OAGG;IACH,6BAFW,MAAM,QAOhB;IAED;;OAEG;IACH,uCAUC;IAED,mDAqBC;IAED,qCAKC;IAED,gDAWC;IAGD;;;;kBAWC;IAGD,8BAuBC;CACF;8BA3O6B,4BAA4B;iCARzB,2CAA2C"}

package/dist/types/index.d.ts

@@ -1,6 +1,7 @@
 export { Agent } from "./loaders/agent";
 export { BrowserAgent } from "./loaders/browser-agent";
 export { WorkerAgent } from "./loaders/worker-agent";
+export { MicroAgent } from "./loaders/micro-agent";
 export { Ajax } from "./features/ajax";
 export { JSErrors } from "./features/jserrors";
 export { Metrics } from "./features/metrics";

package/dist/types/loaders/agent.d.ts

@@ -4,10 +4,10 @@
  */
 export class Agent {
     constructor(options: any, agentIdentifier?: string);
-    agentIdentifier: string;
-    sharedAggregator: Aggregator;
-    features: {};
-    desiredFeatures: Set<any>;
+    agentIdentifier: string | undefined;
+    sharedAggregator: Aggregator | undefined;
+    features: {} | undefined;
+    desiredFeatures: Set<any> | undefined;
     get config(): {
         info: any;
         init: any;

package/dist/types/loaders/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/loaders/agent.js"],"names":[],"mappings":"AAeA;;;GAGG;AACH;IACE,oDAcC;IAbC,wBAAsC;IACtC,6BAAiF;IACjF,aAAkB;IAElB,0BAAsD;IAWxD;;;;;MAOC;IAED,2BAgCC;CACF;2BAtE0B,gCAAgC"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/loaders/agent.js"],"names":[],"mappings":"AAgBA;;;GAGG;AACH;IACE,oDAqBC;IAbC,oCAAsC;IACtC,yCAAiF;IACjF,yBAAkB;IAElB,sCAAsD;IAWxD;;;;;MAOC;IAED,2BAgCC;CACF;2BA9E0B,gCAAgC"}

package/dist/types/loaders/micro-agent.d.ts

@@ -1,8 +1,7 @@
 /**
- * A minimal agent class designed to be loaded multiple times on the same page, each instance narrowly scoped to the
- * concerns of a particular component, as with the micro-frontend architectural pattern. This class does not
- * automatically instrument. Instead, each MicroAgent instance may be configured to lazy-load specific
- * instrumentations at runtime, and to report desired data, events, and errors programatically.
+ * A minimal agent class designed to only respond to manual user input. As such, this class does not
+ * automatically instrument. Instead, each MicroAgent instance will lazy load the required features and can support loading multiple instances on one page.
+ * Out of the box, it can manually handle and report Page View, Page Action, and Error events.
  */
 export class MicroAgent {
     /**

package/dist/types/loaders/micro-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"micro-agent.d.ts","sourceRoot":"","sources":["../../../src/loaders/micro-agent.js"],"names":[],"mappings":"AAoBA;;;;;GAKG;AACH;IACE;;;OAGG;IACH,qBAHW,MAAM,oBACN,MAAM,cAUhB;IAPC,wBAAsC;IACtC,6BAAiF;IACjF,aAAkB;IAOpB;;;;;MAOC;IAED,4BAgCC;CACF;2BA/E0B,gCAAgC"}
+{"version":3,"file":"micro-agent.d.ts","sourceRoot":"","sources":["../../../src/loaders/micro-agent.js"],"names":[],"mappings":"AAmBA;;;;GAIG;AACH;IACE;;;OAGG;IACH,qBAHW,MAAM,oBACN,MAAM,cAUhB;IAPC,wBAAsC;IACtC,6BAAiF;IACjF,aAAkB;IAOpB;;;;;MAOC;IAED,4BA8BC;CACF;2BA1E0B,gCAAgC"}