@newrelic/browser-agent 1.237.0 → 1.238.0

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

@@ -50,6 +50,18 @@ export class AgentBase {
     warn('Call to agent api setUserId failed. The js errors feature is not currently initialized.');
   }
 
+  /**
+   * Adds a user-defined application version string to subsequent events on the page.
+   * This decorates all payloads with an attribute of `application.version` which is queryable in NR1.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setapplicationversion/}
+   * @param {string|null} value A string identifier for the application version, useful for
+   * tying all browser events to a specific release tag. The value parameter does not
+   * have to be unique. Passing a null value unsets any existing value.
+   */
+  setApplicationVersion(value) {
+    warn('Call to agent api setApplicationVersion failed. The agent is not currently initialized.');
+  }
+
   /**
    * Allows selective ignoring and grouping of known errors that the browser agent captures.
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/seterrorhandler/}

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'];
+  const funcs = ['setErrorHandler', 'finished', 'addToTrace', 'inlineHit', 'addRelease', 'addPageAction', 'setCurrentRouteName', 'setPageViewName', 'setCustomAttribute', 'interaction', 'noticeError', 'setUserId', 'setApplicationVersion'];
   funcs.forEach(f => {
     nr[f] = function () {
       for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
@@ -106,6 +106,19 @@ export function setAPI(agentIdentifier, forceDrain) {
     }
     return appendJsAttribute('enduser.id', value, 'setUserId', true);
   };
+
+  /**
+   * Attach the 'applcation.version' attribute onto agent payloads. This may be used in NR queries to group all browser events by a specific customer-defined release.
+   * @param {string|null} value - Application version -- if null, will "unset" the value
+   * @returns @see apiCall
+   */
+  apiInterface.setApplicationVersion = function (value) {
+    if (!(typeof value === 'string' || value === null)) {
+      warn("Failed to execute setApplicationVersion. Expected <String | null>, but got <".concat(typeof value, ">."));
+      return;
+    }
+    return appendJsAttribute('application.version', value, 'setApplicationVersion', false);
+  };
   apiInterface.interaction = function () {
     return new InteractionHandle().get();
   };

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

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

package/dist/esm/loaders/configure/configure.js

@@ -1,6 +1,6 @@
 import { setAPI, setTopLevelCallers } from '../api/api';
 import { addToNREUM, gosCDN, gosNREUMInitializedAgents } from '../../common/window/nreum';
-import { setConfiguration, setInfo, setLoaderConfig, setRuntime } from '../../common/config/config';
+import { getConfiguration, setConfiguration, setInfo, setLoaderConfig, setRuntime } from '../../common/config/config';
 import { activatedFeatures } from '../../common/util/feature-flags';
 import { isWorkerScope } from '../../common/constants/runtime';
 export function configure(agentIdentifier) {
@@ -30,7 +30,8 @@ export function configure(agentIdentifier) {
     info.jsAttributes.isWorker = true;
   }
   setInfo(agentIdentifier, info);
-  runtime.denyList = init.ajax?.block_internal ? (init.ajax.deny_list || []).concat(info.beacon, info.errorBeacon) : init.ajax?.deny_list;
+  const updatedInit = getConfiguration(agentIdentifier);
+  runtime.denyList = [...(updatedInit.ajax?.deny_list || []), ...(updatedInit.ajax?.block_internal ? [info.beacon, info.errorBeacon] : [])];
   setRuntime(agentIdentifier, runtime);
   setTopLevelCallers();
   const api = setAPI(agentIdentifier, forceDrain);

package/dist/types/common/event-emitter/contextual-ee.d.ts

@@ -1,4 +1,24 @@
-export function getOrSetContext(obj: any): any;
+declare namespace globalInstance {
+    export { addEventListener as on };
+    export { addEventListener };
+    export { removeEventListener };
+    export { emit };
+    export { getOrCreate as get };
+    export { listeners };
+    export { context };
+    export { bufferEventsByGroup as buffer };
+    export { abort };
+    export const aborted: boolean;
+    export { isBuffering };
+    export { debugId };
+    export const backlog: any;
+}
+export const contextId: string;
+declare function emit(type: any, args: any, contextOrStore: any, force: any, bubble: any): any;
+declare function getOrCreate(name: any): any;
+declare function listeners(type: any): any;
+declare function bufferEventsByGroup(types: any, group: any): void;
+declare function abort(): void;
+declare function isBuffering(type: any): boolean;
 export { globalInstance as ee };
-declare var globalInstance: any;
 //# sourceMappingURL=contextual-ee.d.ts.map

package/dist/types/common/event-emitter/contextual-ee.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contextual-ee.d.ts","sourceRoot":"","sources":["../../../../src/common/event-emitter/contextual-ee.js"],"names":[],"mappings":"AAmJA,+CAEC;;AAvID,gCAAkB"}
+{"version":3,"file":"contextual-ee.d.ts","sourceRoot":"","sources":["../../../../src/common/event-emitter/contextual-ee.js"],"names":[],"mappings":";;;;;;;;;;;;;;;AAYA,+BAA0C;AA0DxC,+FAsBC;AAqBD,6CAEC;AAND,2CAEC;AAMD,mEAaC;AAcH,+BAGC;AAfC,iDAGC"}

package/dist/types/common/event-emitter/event-context.d.ts

@@ -0,0 +1,5 @@
+export class EventContext {
+    constructor(contextId: any);
+    contextId: any;
+}
+//# sourceMappingURL=event-context.d.ts.map

package/dist/types/common/event-emitter/event-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-context.d.ts","sourceRoot":"","sources":["../../../../src/common/event-emitter/event-context.js"],"names":[],"mappings":"AAAA;IACE,4BAEC;IADC,eAA0B;CAE7B"}

package/dist/types/common/event-emitter/register-handler.d.ts

@@ -1,7 +1,7 @@
 export function defaultRegister(type: any, handler: any, group: any, ee: any): void;
 export namespace defaultRegister {
     export { registerWithSpecificEmitter as on };
-    export let handlers: {};
+    export const handlers: {};
 }
 export { defaultRegister as registerHandler };
 declare function registerWithSpecificEmitter(ee: any, handlers: any, type: any, handler: any, group: any): void;

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,WAUzB;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,CAwB1B;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,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"}

package/dist/types/common/ids/bundle-id.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Provides a unique id for the current agent bundle
+ */
+export const bundleId: string;
+//# sourceMappingURL=bundle-id.d.ts.map

package/dist/types/common/ids/bundle-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-id.d.ts","sourceRoot":"","sources":["../../../../src/common/ids/bundle-id.js"],"names":[],"mappings":"AASA;;GAEG;AACH,8BAAsC"}

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

@@ -1,12 +1,12 @@
 export namespace MODE {
-    let OFF: number;
-    let FULL: number;
-    let ERROR: number;
+    const OFF: number;
+    const FULL: number;
+    const ERROR: number;
 }
 export namespace SESSION_EVENTS {
-    let PAUSE: string;
-    let RESET: string;
-    let RESUME: string;
+    const PAUSE: string;
+    const RESET: string;
+    const RESUME: string;
 }
 export class SessionEntity {
     /**

package/dist/types/common/window/nreum.d.ts

@@ -8,7 +8,7 @@ export function addToNREUM(fnName: any, fn: any): void;
 export function NREUMinitialized(): void;
 export function gosCDN(): any;
 export namespace defaults {
-    let beacon: string;
-    let errorBeacon: string;
+    const beacon: string;
+    const errorBeacon: string;
 }
 //# sourceMappingURL=nreum.d.ts.map

package/dist/types/common/wrap/wrap-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrap-events.d.ts","sourceRoot":"","sources":["../../../../src/common/wrap/wrap-events.js"],"names":[],"mappings":"AAmBA;;;;;;GAMG;AACH,qCAJW,MAAM,GAEJ,MAAM,CAyDlB;AAeD;;;;;;GAMG;AACH,mCAJW,MAAM,GAEJ,MAAM,CAIlB"}
+{"version":3,"file":"wrap-events.d.ts","sourceRoot":"","sources":["../../../../src/common/wrap/wrap-events.js"],"names":[],"mappings":"AAoBA;;;;;;GAMG;AACH,qCAJW,MAAM,GAEJ,MAAM,CAyDlB;AAeD;;;;;;GAMG;AACH,mCAJW,MAAM,GAEJ,MAAM,CAIlB"}

package/dist/types/common/wrap/wrap-fetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrap-fetch.d.ts","sourceRoot":"","sources":["../../../../src/common/wrap/wrap-fetch.js"],"names":[],"mappings":"AAsBA;;;;;;;GAOG;AACH,oCAJW,MAAM,GAEJ,MAAM,CAqElB;AAED;;;;;;GAMG;AACH,mCAJW,MAAM,GAEJ,MAAM,CAIlB"}
+{"version":3,"file":"wrap-fetch.d.ts","sourceRoot":"","sources":["../../../../src/common/wrap/wrap-fetch.js"],"names":[],"mappings":"AAoBA;;;;;;;GAOG;AACH,oCAJW,MAAM,GAEJ,MAAM,CAqElB;AAED;;;;;;GAMG;AACH,mCAJW,MAAM,GAEJ,MAAM,CAIlB"}

package/dist/types/common/wrap/wrap-function.d.ts

@@ -5,24 +5,6 @@
  * @returns {function} The wrapped function.
  */
 export function createWrapperWithEmitter(emitter?: Object | undefined, always: boolean): Function;
-/**
- * Creates a wrapped version of a function using a specified wrapper function. The new wrapped function references the
- * original function. Also copies the properties of the original function to the wrapped function.
- * @param {function} fn - A function to be wrapped.
- * @param {function} wrapper - A higher order function that returns a new function, which executes the function passed
- *     to the higher order function as an argument.
- * @returns {function} A wrapped function with an internal reference to the original function.
- */
-export function wrapFunction(fn: Function, wrapper: Function): Function;
-/**
- * Replaces a function with a wrapped version of itself. To preserve object references, rather than taking the function
- * itself as an argument, takes the object on which the particular named function is a property.
- * @param {Object} obj - The object on which the named function is a property.
- * @param {string} fnName - The name of the function to be wrapped.
- * @param {function} wrapper - A higher order function that returns a new function, which executes the function passed
- *     to the higher order function as an argument.
- */
-export function wrapInPlace(obj: Object, fnName: string, wrapper: Function): void;
-export const flag: "nr@original";
+export const flag: string;
 export default createWrapperWithEmitter;
 //# sourceMappingURL=wrap-function.d.ts.map

package/dist/types/common/wrap/wrap-function.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrap-function.d.ts","sourceRoot":"","sources":["../../../../src/common/wrap/wrap-function.js"],"names":[],"mappings":"AA0BA;;;;;GAKG;AACH,+EAHW,OAAO,YAkIjB;AA6DD;;;;;;;GAOG;AACH,wEAKC;AAED;;;;;;;GAOG;AACH,iCALW,MAAM,UACN,MAAM,2BAOhB;AA7OD,iCAAiC"}
+{"version":3,"file":"wrap-function.d.ts","sourceRoot":"","sources":["../../../../src/common/wrap/wrap-function.js"],"names":[],"mappings":"AA4BA;;;;;GAKG;AACH,+EAHW,OAAO,YAgIjB;AApJD,0BAA6C"}

package/dist/types/common/wrap/wrap-mutation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrap-mutation.d.ts","sourceRoot":"","sources":["../../../../src/common/wrap/wrap-mutation.js"],"names":[],"mappings":"AAgBA;;;;;GAKG;AACH,uCAHW,MAAM,GACJ,MAAM,CA0BlB;AAED;;;;;;GAMG;AACH,mCAJW,MAAM,GAEJ,MAAM,CAIlB"}
+{"version":3,"file":"wrap-mutation.d.ts","sourceRoot":"","sources":["../../../../src/common/wrap/wrap-mutation.js"],"names":[],"mappings":"AAeA;;;;;GAKG;AACH,uCAHW,MAAM,GACJ,MAAM,CA0BlB;AAED;;;;;;GAMG;AACH,mCAJW,MAAM,GAEJ,MAAM,CAIlB"}

package/dist/types/common/wrap/wrap-promise.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrap-promise.d.ts","sourceRoot":"","sources":["../../../../src/common/wrap/wrap-promise.js"],"names":[],"mappings":"AAgBA;;;;;;GAMG;AACH,sCAHW,MAAM,GACJ,MAAM,CAqIlB;AAED;;;;;;GAMG;AACH,mCAJW,MAAM,GAEJ,MAAM,CAIlB"}
+{"version":3,"file":"wrap-promise.d.ts","sourceRoot":"","sources":["../../../../src/common/wrap/wrap-promise.js"],"names":[],"mappings":"AAeA;;;;;;GAMG;AACH,sCAHW,MAAM,GACJ,MAAM,CAqIlB;AAED;;;;;;GAMG;AACH,mCAJW,MAAM,GAEJ,MAAM,CAIlB"}

package/dist/types/common/wrap/wrap-xhr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrap-xhr.d.ts","sourceRoot":"","sources":["../../../../src/common/wrap/wrap-xhr.js"],"names":[],"mappings":"AAoBA;;;;;GAKG;AAEH,kCAJW,MAAM,GACJ,MAAM,CAkLlB;AAED;;;;;;GAMG;AACH,mCAJW,MAAM,GAEJ,MAAM,CAIlB"}
+{"version":3,"file":"wrap-xhr.d.ts","sourceRoot":"","sources":["../../../../src/common/wrap/wrap-xhr.js"],"names":[],"mappings":"AAmBA;;;;;GAKG;AAEH,kCAJW,MAAM,GACJ,MAAM,CA+KlB;AAED;;;;;;GAMG;AACH,mCAJW,MAAM,GAEJ,MAAM,CAIlB"}

package/dist/types/features/ajax/instrument/distributed-tracing.d.ts

@@ -6,10 +6,10 @@ export class DT {
         traceId: string;
         timestamp: number;
     } | null;
-    shouldGenerateTrace(parsedOrigin: any): boolean;
     generateTraceContextParentHeader(spanId: any, traceId: any): string;
     generateTraceContextStateHeader(spanId: any, timestamp: any, accountId: any, appId: any, trustKey: any): string;
     generateTraceHeader(spanId: any, traceId: any, timestamp: any, accountId: any, appId: any, trustKey: any): string | null;
+    shouldGenerateTrace(parsedOrigin: any): boolean;
     isAllowedOrigin(parsedOrigin: any): boolean;
     isDtEnabled(): boolean;
     excludeNewrelicHeader(): boolean;

package/dist/types/features/ajax/instrument/distributed-tracing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"distributed-tracing.d.ts","sourceRoot":"","sources":["../../../../../src/features/ajax/instrument/distributed-tracing.js"],"names":[],"mappings":"AAUA;IACE,kCAMC;IALC,qBAAsC;IAOxC;;;;aA0CC;IA2CD,gDAEC;IA3CD,oEAEC;IAED,gHASC;IAED,yHAsBC;IAQD,4CAuBC;IAED,uBAMC;IAGD,iCAMC;IAED,oCAMC;IAED,yCAMC;CACF"}
+{"version":3,"file":"distributed-tracing.d.ts","sourceRoot":"","sources":["../../../../../src/features/ajax/instrument/distributed-tracing.js"],"names":[],"mappings":"AAUA;IACE,kCAEC;IADC,qBAAsC;IAGxC;;;;aA0CC;IAED,oEAEC;IAED,gHASC;IAED,yHAsBC;IAID,gDAEC;IAED,4CAuBC;IAED,uBAMC;IAGD,iCAMC;IAED,oCAMC;IAED,yCAMC;CACF"}

package/dist/types/features/metrics/aggregate/endpoint-map.d.ts

@@ -1,8 +1,8 @@
 export namespace endpointMap {
-    let rum: string;
-    let events: string;
-    let ins: string;
-    let jserrors: string;
-    let resources: string;
+    const rum: string;
+    const events: string;
+    const ins: string;
+    const jserrors: string;
+    const resources: string;
 }
 //# sourceMappingURL=endpoint-map.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/metrics/aggregate/index.js"],"names":[],"mappings":"AAiBA;IACE,2BAAiC;IACjC,mDAsBC;IAED,wDAKC;IAED,iDAKC;IAED,qBA+BC;IAED,0BAQC;IAED,eAoDC;IA5CG,mCAAyB;CA6C9B;8BA5I6B,4BAA4B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/metrics/aggregate/index.js"],"names":[],"mappings":"AAiBA;IACE,2BAAiC;IACjC,mDAsBC;IAED,wDAKC;IAED,iDAKC;IAED,qBA+BC;IAED,0BAQC;IAED,eA4DC;IApDG,mCAAyB;CAqD9B;8BApJ6B,4BAA4B"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/session_replay/aggregate/index.js"],"names":[],"mappings":"AAwBA,4CAA4C;AAE5C,mCAAmC;AAInC,uCAAuC;AACvC,uCAAuC;AACvC,iCAAiC;AACjC,uCAAuC;AAIvC;IACE,2BAAiC;IACjC,mDA4FC;IA1FC,iHAAiH;IACjH,cAAgB;IAChB,8GAA8G;IAC9G,wBAAgH;IAChH,iFAAiF;IACjF,qBAAwB;IACxB,mEAAmE;IACnE,sBAAyB;IACzB,6GAA6G;IAC7G,aAAoB;IAGpB,iEAAiE;IACjE,mBAAsB;IACtB,gDAAgD;IAChD,wBAA0B;IAE1B,gGAAgG;IAChG,sBAAyB;IACzB;;;MAGE;IACF,qBAAwB;IACxB,+HAA+H;IAC/H,kBAAqB;IAErB,oHAAoH;IACpH;;;MAAsD;IAEtD,qGAAqG;IACrG,+BAA+B;IAO/B,uIAAuI;IACvI,0BAAyE;IAiBvE,wCAKQ;IA+BZ;;;;;;OAMG;IACH,kCALW,OAAO,eACP,OAAO,cACP,OAAO,GACL,IAAI,CAuDhB;IAED;;;;;;;;;oBAaC;IAED;;;;;;;;;MAyBC;IAED,qCAOC;IAED,kFAAkF;IAClF,oBAOC;IAED,qDAAqD;IACrD,uBAyBC;IAED,yHAAyH;IACzH,yCA8BC;IAED,0HAA0H;IAC1H,yBAGC;IAED,qCAIC;IAED,wBAEC;IAED,gCAAgC;IAChC,uCAGC;IAED,yDAAyD;IACzD,cAOC;IAED;;;SAGK;IACL,oCAGC;IAED,yCAGC;CACF;8BAvV6B,4BAA4B;iCALzB,2CAA2C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/session_replay/aggregate/index.js"],"names":[],"mappings":"AAwBA,4CAA4C;AAE5C,mCAAmC;AAInC,uCAAuC;AACvC,uCAAuC;AACvC,iCAAiC;AACjC,uCAAuC;AAIvC;IACE,2BAAiC;IACjC,mDA4FC;IA1FC,iHAAiH;IACjH,cAAgB;IAChB,8GAA8G;IAC9G,wBAAgH;IAChH,iFAAiF;IACjF,qBAAwB;IACxB,mEAAmE;IACnE,sBAAyB;IACzB,6GAA6G;IAC7G,aAAoB;IAGpB,iEAAiE;IACjE,mBAAsB;IACtB,gDAAgD;IAChD,wBAA0B;IAE1B,gGAAgG;IAChG,sBAAyB;IACzB;;;MAGE;IACF,qBAAwB;IACxB,+HAA+H;IAC/H,kBAAqB;IAErB,oHAAoH;IACpH;;;MAAsD;IAEtD,qGAAqG;IACrG,+BAA+B;IAO/B,uIAAuI;IACvI,0BAAyE;IAiBvE,wCAKQ;IA+BZ;;;;;;OAMG;IACH,kCALW,OAAO,eACP,OAAO,cACP,OAAO,GACL,IAAI,CAyDhB;IAED;;;;;;;;;oBAaC;IAED;;;;;;;;;MAyBC;IAED,qCAOC;IAED,kFAAkF;IAClF,oBAOC;IAED,qDAAqD;IACrD,uBAyBC;IAED,yHAAyH;IACzH,yCA8BC;IAED,0HAA0H;IAC1H,yBAGC;IAED,qCAIC;IAED,wBAEC;IAED,gCAAgC;IAChC,uCAGC;IAED,yDAAyD;IACzD,cAOC;IAED;;;SAGK;IACL,oCAGC;IAED,yCAGC;CACF;8BAzV6B,4BAA4B;iCALzB,2CAA2C"}

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

@@ -9,7 +9,11 @@ export class Aggregate extends AggregateBase {
     sentTrace: {} | null | undefined;
     harvestTimeSeconds: any;
     maxNodesPerHarvest: any;
+    /**
+     * Standalone (mode) refers to the legacy version of ST before the idea of 'session' or the Replay feature existed.
+     * It has some different behavior vs when used in tandem with replay. */
     isStandalone: boolean | undefined;
+    operationalGate: HandlerCache | undefined;
     startTracing(startupBuffer: any, dontStartHarvestYet?: boolean): void;
     processPVT(name: any, value: any, attrs: any): void;
     storeTiming(timingEntry: any): void;
@@ -43,4 +47,5 @@ export class Aggregate extends AggregateBase {
     #private;
 }
 import { AggregateBase } from '../../utils/aggregate-base';
+import { HandlerCache } from '../../utils/handler-cache';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/session_trace/aggregate/index.js"],"names":[],"mappings":"AAkCA;IACE,2BAAiC;IAGjC,iEAqHC;IAnHC,kBAA+C;IAK/C,sBAAiD;IACjD,yBAAc;IACd,sBAAe;IACf,8BAAkB;IAClB,iCAAqB;IACrB,wBAA0G;IAC1G,wBAA4G;IAC5G,kCAAyB;IAyG3B,sEAcC;IA4CD,oDAOC;IAGD,oCAwBC;IAGD,uEAkBC;IAED,oDAMC;IAED,wBAwBC;IAED,uCAuBC;IAGD,gDASC;IAID,qCAkBC;IAGD,qEAUC;IAGD,mEAUC;IAGD,yBAWC;IAED;;;;OAIG;IACH,2BAHW,MAAM,GACJ,MAAM,CAsBlB;IAGD;;;;;;;;;;MAwBC;IAED,mEA8BC;;CACF;8BA5d6B,4BAA4B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/session_trace/aggregate/index.js"],"names":[],"mappings":"AAkCA;IACE,2BAAiC;IAGjC,iEAyHC;IAvHC,kBAA+C;IAK/C,sBAAiD;IACjD,yBAAc;IACd,sBAAe;IACf,8BAAkB;IAClB,iCAAqB;IACrB,wBAA0G;IAC1G,wBAA4G;IAC5G;;4EAEwE;IACxE,kCAAyB;IAGzB,0CAAsC;IAuGxC,sEAcC;IA6CD,oDAOC;IAGD,oCAwBC;IAGD,uEAkBC;IAED,oDAMC;IAED,wBAwBC;IAED,uCAuBC;IAGD,gDASC;IAID,qCAkBC;IAGD,qEAUC;IAGD,mEAUC;IAGD,yBAeC;IAED;;;;OAIG;IACH,2BAHW,MAAM,GACJ,MAAM,CAsBlB;IAGD;;;;;;;;;;MAwBC;IAED,mEA8BC;;CACF;8BAre6B,4BAA4B;6BAH7B,2BAA2B"}

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

@@ -34,6 +34,15 @@ export class AgentBase {
      * @param {string|null} value A string identifier for the end-user, useful for tying all browser events to specific users. The value parameter does not have to be unique. If IDs should be unique, the caller is responsible for that validation. Passing a null value unsets any existing user ID.
      */
     setUserId(value: string | null): void;
+    /**
+     * Adds a user-defined application version string to subsequent events on the page.
+     * This decorates all payloads with an attribute of `application.version` which is queryable in NR1.
+     * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setapplicationversion/}
+     * @param {string|null} value A string identifier for the application version, useful for
+     * tying all browser events to a specific release tag. The value parameter does not
+     * have to be unique. Passing a null value unsets any existing value.
+     */
+    setApplicationVersion(value: string | null): void;
     /**
      * Allows selective ignoring and grouping of known errors that the browser agent captures.
      * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/seterrorhandler/}

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

@@ -1 +1 @@
-{"version":3,"file":"agent-base.d.ts","sourceRoot":"","sources":["../../../src/loaders/agent-base.js"],"names":[],"mappings":"AAEA;IACE;;;;;OAKG;IACH,oBAHW,MAAM,yCAKhB;IAED;;;;;OAKG;IACH,sBAHW,MAAM,mCAKhB;IAED;;;;;;OAMG;IACH,yBAJW,MAAM,SACN,MAAM,GAAC,MAAM,GAAC,IAAI,uCAK5B;IAED;;;;;OAKG;IACH,mBAHW,KAAK,GAAC,MAAM,+CAKtB;IAED;;;;OAIG;IACH,iBAFW,MAAM,GAAC,IAAI,QAIrB;IAED;;;;OAIG;IACH,kCAFmB,KAAK,GAAC,MAAM,KAAK,OAAO,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,QAI9D;IAED;;;;OAIG;IACH,+CAEC;IAED;;;;;OAKG;IACH,iBAHW,MAAM,MACN,MAAM,QAIhB;CACF"}
+{"version":3,"file":"agent-base.d.ts","sourceRoot":"","sources":["../../../src/loaders/agent-base.js"],"names":[],"mappings":"AAEA;IACE;;;;;OAKG;IACH,oBAHW,MAAM,yCAKhB;IAED;;;;;OAKG;IACH,sBAHW,MAAM,mCAKhB;IAED;;;;;;OAMG;IACH,yBAJW,MAAM,SACN,MAAM,GAAC,MAAM,GAAC,IAAI,uCAK5B;IAED;;;;;OAKG;IACH,mBAHW,KAAK,GAAC,MAAM,+CAKtB;IAED;;;;OAIG;IACH,iBAFW,MAAM,GAAC,IAAI,QAIrB;IAED;;;;;;;OAOG;IACH,6BAJW,MAAM,GAAC,IAAI,QAMrB;IAED;;;;OAIG;IACH,kCAFmB,KAAK,GAAC,MAAM,KAAK,OAAO,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,QAI9D;IAED;;;;OAIG;IACH,+CAEC;IAED;;;;;OAKG;IACH,iBAHW,MAAM,MACN,MAAM,QAIhB;CACF"}

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

@@ -10,6 +10,12 @@ export function setAPI(agentIdentifier: any, forceDrain: any): {
      * @returns @see apiCall
      */
     setUserId(value: string): any;
+    /**
+     * Attach the 'applcation.version' attribute onto agent payloads. This may be used in NR queries to group all browser events by a specific customer-defined release.
+     * @param {string|null} value - Application version -- if null, will "unset" the value
+     * @returns @see apiCall
+     */
+    setApplicationVersion(value: string | null): any;
     interaction(): any;
     noticeError(err: any, customAttributes: any): void;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../src/loaders/api/api.js"],"names":[],"mappings":"AAkBA,2CAoBC;AAED;;;;;IA0DE;;;;OAIG;qBAFQ,MAAM;;;EAuElB;AA3JD,0CAA0C"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../src/loaders/api/api.js"],"names":[],"mappings":"AAkBA,2CAoBC;AAED;;;;;IA0DE;;;;OAIG;qBAFQ,MAAM;IAWjB;;;;OAIG;iCAFQ,MAAM,GAAC,IAAI;;;EAuEvB;AAxKD,0CAA0C"}

package/dist/types/loaders/api/interaction-types.d.ts

@@ -6,7 +6,7 @@
  * @property {getContext} getContext
  * @property {ignore} ignore
  * @property {onEnd} onEnd
- * @property {onEnd} save
+ * @property {save} save
  * @property {setAttribute} setAttribute
  * @property {setName} setName
  */
@@ -22,8 +22,8 @@
  * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/createtracer/}
  * @callback createTracer
  * @param {string} name This will be used as the name of the tracer.
- * @param {string} [callback] A callback that contains the synchronous work to run at the end of the async work. To execute this callback, call the wrapper function returned using createTracer().
- * @returns {Function} Returns a method that wraps the original callback. When this method is invoked, it calls the original callback and ends the async timing.
+ * @param {(...args: any[]) => any} [callback] A callback that contains the synchronous work to run at the end of the async work. To execute this callback, call the wrapper function returned using createTracer().
+ * @returns {(...args: any[]) => any} Returns a method that wraps the original callback. When this method is invoked, it calls the original callback and ends the async timing.
  */
 /**
  * Ends the SPA interaction at the current time.
@@ -38,6 +38,12 @@
  * @param {(ctx: object) => void} callback This function is called when the interaction ends. It is called with one parameter, which is the interaction context.
  * @returns {InteractionInstance} Returns the same interaction object allowing method chaining.
  */
+/**
+ * Overrides other SPA save() calls; ignores an interaction so it is not saved or sent to New Relic.
+ * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/ignore/}
+ * @callback ignore
+ * @returns {InteractionInstance} Returns the same interaction object allowing method chaining.
+ */
 /**
  * Change the values associated with a SPA interaction before the interaction is saved.
  * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/onend/}
@@ -56,7 +62,7 @@
  * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setattribute/}
  * @callback setAttribute
  * @param {string} key Used as the attribute name on the BrowserInteraction event.
- * @param {any} key Used as the attribute value on the BrowserInteraction event. This can be a string, number, boolean, or object. If it is an object, New Relic serializes it to a JSON string.
+ * @param {any} value Used as the attribute value on the BrowserInteraction event. This can be a string, number, boolean, or object. If it is an object, New Relic serializes it to a JSON string.
  * @returns {InteractionInstance} Returns the same interaction object allowing method chaining.
  */
 /**
@@ -75,7 +81,7 @@ export type InteractionInstance = {
     getContext: getContext;
     ignore: ignore;
     onEnd: onEnd;
-    save: onEnd;
+    save: save;
     setAttribute: setAttribute;
     setName: setName;
 };
@@ -88,7 +94,7 @@ export type actionText = (value: string) => InteractionInstance;
  * Times sub-components of a SPA interaction separately, including wait time and JS execution time.
  * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/createtracer/}
  */
-export type createTracer = (name: string, callback?: string | undefined) => Function;
+export type createTracer = (name: string, callback?: ((...args: any[]) => any) | undefined) => (...args: any[]) => any;
 /**
  * Ends the SPA interaction at the current time.
  * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/end/}
@@ -99,6 +105,11 @@ export type end = () => InteractionInstance;
  * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/getcontext/}
  */
 export type getContext = (callback: (ctx: object) => void) => InteractionInstance;
+/**
+ * Overrides other SPA save() calls; ignores an interaction so it is not saved or sent to New Relic.
+ * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/ignore/}
+ */
+export type ignore = () => InteractionInstance;
 /**
  * Change the values associated with a SPA interaction before the interaction is saved.
  * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/onend/}
@@ -113,7 +124,7 @@ export type save = () => InteractionInstance;
  * Adds a custom SPA attribute only to the current interaction in browser.
  * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setattribute/}
  */
-export type setAttribute = (key: string, key: any) => InteractionInstance;
+export type setAttribute = (key: string, value: any) => InteractionInstance;
 /**
  * Sets the name and trigger of a SPA's browser interaction that is not a route change or URL change.
  * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setname/}

package/dist/types/loaders/api/interaction-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interaction-types.d.ts","sourceRoot":"","sources":["../../../../src/loaders/api/interaction-types.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;GAMG;AAEH;;;;;;;GAOG;AAEH;;;;;GAKG;AAEH;;;;;;GAMG;AAEH;;;;;;GAMG;AAEH;;;;;GAKG;AAEH;;;;;;;GAOG;AAEH;;;;;;;GAOG;AAGH,wBAAwB;;gBA7EV,UAAU;kBACV,YAAY;SACZ,GAAG;gBACH,UAAU;;WAEV,KAAK;UACL,KAAK;kBACL,YAAY;aACZ,OAAO;;;;;;iCAOV,MAAM,KACJ,mBAAmB;;;;;kCAOrB,MAAM;;;;;wBASJ,mBAAmB;;;;;0CAOf,MAAM,KAAK,IAAI,KACnB,mBAAmB;;;;;qCAOf,MAAM,KAAK,IAAI,KACnB,mBAAmB;;;;;yBAOnB,mBAAmB;;;;;iCAOrB,MAAM,OACN,GAAG,KACD,mBAAmB;;;;;6BAOrB,MAAM,mCAEJ,mBAAmB"}
+{"version":3,"file":"interaction-types.d.ts","sourceRoot":"","sources":["../../../../src/loaders/api/interaction-types.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;GAMG;AAEH;;;;;;;GAOG;AAEH;;;;;GAKG;AAEH;;;;;;GAMG;AAEH;;;;;GAKG;AAEH;;;;;;GAMG;AAEH;;;;;GAKG;AAEH;;;;;;;GAOG;AAEH;;;;;;;GAOG;AAGH,wBAAwB;;gBApFV,UAAU;kBACV,YAAY;SACZ,GAAG;gBACH,UAAU;YACV,MAAM;WACN,KAAK;UACL,IAAI;kBACJ,YAAY;aACZ,OAAO;;;;;;iCAOV,MAAM,KACJ,mBAAmB;;;;;kCAOrB,MAAM,wBACI,GAAG,EAAE,KAAK,GAAG,4BACX,GAAG,EAAE,KAAK,GAAG;;;;;wBAOvB,mBAAmB;;;;;0CAOf,MAAM,KAAK,IAAI,KACnB,mBAAmB;;;;;2BAOnB,mBAAmB;;;;;qCAOf,MAAM,KAAK,IAAI,KACnB,mBAAmB;;;;;yBAOnB,mBAAmB;;;;;iCAOrB,MAAM,SACN,GAAG,KACD,mBAAmB;;;;;6BAOrB,MAAM,mCAEJ,mBAAmB"}

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

@@ -4,6 +4,7 @@ export function configure(agentIdentifier: any, opts: {} | undefined, loaderType
     setPageViewName(name: any, host: any): any;
     setCustomAttribute(name: any, value: any, persistAttribute?: boolean): any;
     setUserId(value: string): any;
+    setApplicationVersion(value: string | null): any;
     interaction(): any;
     noticeError(err: any, customAttributes: any): void;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../../../../src/loaders/configure/configure.js"],"names":[],"mappings":"AAMA;;;;;;;;EA4BC"}
+{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../../../../src/loaders/configure/configure.js"],"names":[],"mappings":"AAMA;;;;;;;;;EAqCC"}

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

@@ -1,13 +1,13 @@
 export namespace FEATURE_NAMES {
-    let ajax: string;
-    let jserrors: string;
-    let metrics: string;
-    let pageAction: string;
-    let pageViewEvent: string;
-    let pageViewTiming: string;
-    let sessionReplay: string;
-    let sessionTrace: string;
-    let spa: string;
+    const ajax: string;
+    const jserrors: string;
+    const metrics: string;
+    const pageAction: string;
+    const pageViewEvent: string;
+    const pageViewTiming: string;
+    const sessionReplay: string;
+    const sessionTrace: string;
+    const spa: string;
 }
 /**
  * The order in which features will be instrumented. This is the traditional order. It's unclear if the order of

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

@@ -18,7 +18,7 @@ export class MicroAgent extends AgentBase {
         loader_config: any;
         runtime: any;
     };
-    start(): false | this;
+    start(): false | MicroAgent;
 }
 import { AgentBase } from './agent-base';
 import { Aggregator } from '../common/aggregate/aggregator';

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;;;;GAIG;AACH;IACE;;;OAGG;IACH,qBAHW,MAAM,oBACN,MAAM,cAYhB;IAPC,wBAAsC;IACtC,6BAAiF;IACjF,aAAkB;IAOpB;;;;;MAOC;IAED,sBA8BC;CACF;0BAtEyB,cAAc;2BAPb,gCAAgC"}
+{"version":3,"file":"micro-agent.d.ts","sourceRoot":"","sources":["../../../src/loaders/micro-agent.js"],"names":[],"mappings":"AAoBA;;;;GAIG;AACH;IACE;;;OAGG;IACH,qBAHW,MAAM,oBACN,MAAM,cAYhB;IAPC,wBAAsC;IACtC,6BAAiF;IACjF,aAAkB;IAOpB;;;;;MAOC;IAED,4BA8BC;CACF;0BAtEyB,cAAc;2BAPb,gCAAgC"}