@newrelic/browser-agent 1.317.0 → 1.318.0-rc.0

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

@@ -0,0 +1,9 @@
+/**
+ * Initiate a harvest call.
+ * @param {object} agentRef The initialized agent reference
+ * @param {NetworkSendSpec} spec Specification for sending data
+ * @returns {boolean} True if a network call was made. Note that this does not mean or guarantee that it was successful.
+ */
+export function send(agentRef: object, { endpoint, payload, localOpts, submitMethod, cbFinished, raw, featureName, endpointVersion, harvesterObfuscator }: NetworkSendSpec): boolean;
+export type NetworkSendSpec = import("./types.js").NetworkSendSpec;
+//# sourceMappingURL=send.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../../../src/common/harvest/send.js"],"names":[],"mappings":"AAuBA;;;;;GAKG;AACH,+BAJW,MAAM,sHACN,eAAe,GACb,OAAO,CAsHnB;8BA/HY,OAAO,YAAY,EAAE,eAAe"}

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

@@ -1,5 +1,5 @@
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 /**
@@ -19,11 +19,15 @@
  * @typedef {object} NetworkSendSpec
  * @property {HarvestEndpointIdentifier} endpoint The endpoint to use (jserrors, events, resources etc.)
  * @property {HarvestPayload} payload Object representing payload.
- * @property {object} localOpts Additional options for sending data
- * @property {boolean} localOpts.isFinalHarvest Specify whether the call is a final harvest during page unload.
- * @property {boolean} localOpts.sendEmptyBody Specify whether the call should be made even if the body is empty. Useful for rum calls.
- * @property {boolean} localOpts.forceNoRetry Don't save the buffered data in the case of a need to retry the transmission.
+ * @property {object} [localOpts] Additional options for sending data
+ * @property {boolean} [localOpts.isFinalHarvest] Specify whether the call is a final harvest during page unload.
+ * @property {boolean} [localOpts.sendEmptyBody] Specify whether the call should be made even if the body is empty. Useful for rum calls.
+ * @property {boolean} [localOpts.forceNoRetry] Don't save the buffered data in the case of a need to retry the transmission.
  * @property {import('../util/submit-data.js').NetworkMethods} submitMethod The network method to use {@link ../util/submit-data.js}
+ * @property {function(object): void} [cbFinished] Callback invoked with the result once the network request completes. Receives an object with sent, status, retry, fullUrl, responseText, and either xhr or fetchResponse.
+ * @property {boolean} [raw] If true, skips standard versioned URL path construction and uses a bare endpoint URL.
+ * @property {string} [featureName] The feature name associated with this harvest, used for metadata tracking and the global harvest event.
+ * @property {number} [endpointVersion] The endpoint version included in the URL path. Defaults to 1.
  */
 export const unused: {};
 export type HarvestEndpointIdentifier = "rum" | "jserrors" | "events" | "ins" | "resources" | "blob";
@@ -49,14 +53,39 @@ export type NetworkSendSpec = {
     /**
      * Additional options for sending data
      */
-    localOpts: {
-        isFinalHarvest: boolean;
-        sendEmptyBody: boolean;
-        forceNoRetry: boolean;
-    };
+    localOpts?: {
+        /**
+         * Specify whether the call is a final harvest during page unload.
+         */
+        isFinalHarvest?: boolean | undefined;
+        /**
+         * Specify whether the call should be made even if the body is empty. Useful for rum calls.
+         */
+        sendEmptyBody?: boolean | undefined;
+        /**
+         * Don't save the buffered data in the case of a need to retry the transmission.
+         */
+        forceNoRetry?: boolean | undefined;
+    } | undefined;
     /**
      * The network method to use {@link  ../util/submit-data.js}
      */
     submitMethod: import("../util/submit-data.js").NetworkMethods;
+    /**
+     * Callback invoked with the result once the network request completes. Receives an object with sent, status, retry, fullUrl, responseText, and either xhr or fetchResponse.
+     */
+    cbFinished?: ((arg0: object) => void) | undefined;
+    /**
+     * If true, skips standard versioned URL path construction and uses a bare endpoint URL.
+     */
+    raw?: boolean | undefined;
+    /**
+     * The feature name associated with this harvest, used for metadata tracking and the global harvest event.
+     */
+    featureName?: string | undefined;
+    /**
+     * The endpoint version included in the URL path. Defaults to 1.
+     */
+    endpointVersion?: number | undefined;
 };
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/common/harvest/types.js"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AAEH;;GAEG;AAEH;;;;GAIG;AAEH;;;;;;;;;GASG;AAEH,wBAAwB;wCApBX,KAAK,GAAC,UAAU,GAAC,QAAQ,GAAC,KAAK,GAAC,WAAW,GAAC,MAAM;;;;;QAKjD,MAAM;;;;UACN,MAAM;;;;;;cAKN,yBAAyB;;;;aACzB,cAAc;;;;eAEzB;QAA8B,cAAc,EAAjC,OAAO;QACY,aAAa,EAAhC,OAAO;QACY,YAAY,EAA/B,OAAO;KAClB;;;;kBAAW,OAAO,wBAAwB,EAAE,cAAc"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/common/harvest/types.js"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AAEH;;GAEG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;;;GAaG;AAEH,wBAAwB;wCAxBX,KAAK,GAAC,UAAU,GAAC,QAAQ,GAAC,KAAK,GAAC,WAAW,GAAC,MAAM;;;;;QAKjD,MAAM;;;;UACN,MAAM;;;;;;cAKN,yBAAyB;;;;aACzB,cAAc;;;;;;;;;;;;;;;;;;;;;kBAKd,OAAO,wBAAwB,EAAE,cAAc;;;;yBACtC,MAAM,KAAG,IAAI"}

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":"AAsCA;IACE;;;;;OAKG;IACH,uBA+BC;IAzBC,cAAwB;IACxB,aAAsB;IACtB,UAAe;IAGf,SAAc;IAEd,QAAqB;IAoBvB;;;;;aAgFC;IApEC,8BAA0B;IAC1B,+BAA4B;IAe1B,gCAOqC;IAUrC,4CAkBsC;IAexC,iCAAuB;IAKzB,wBAEC;IAED,sBAEC;IAED;;;OAGG;IACH,QAFa,MAAM,CA6BlB;IAED;;;;;;OAMG;IACH,YAHW,MAAM,GACJ,MAAM,CAkBlB;IAED,gBA4BC;IAED;;OAEG;IACH,gBAIC;IAED;;;OAGG;IACH,qBAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;OAGG;IACH,gBAHW,MAAM,GACJ,OAAO,CAKnB;IAED,yDAUC;IAED,6DAIC;IAED;;;OAGG;IACH,6BAHW,MAAM,GACJ,MAAM,CAIlB;IAED,gDAaC;IAHG,YAAuD;CAI5D;sBA5TqB,gBAAgB;iCAGL,4BAA4B"}
+{"version":3,"file":"session-entity.d.ts","sourceRoot":"","sources":["../../../../src/common/session/session-entity.js"],"names":[],"mappings":"AAsCA;IACE;;;;;OAKG;IACH,uBA+BC;IAzBC,cAAwB;IACxB,aAAsB;IACtB,UAAe;IAGf,SAAc;IAEd,QAAqB;IAoBvB;;;;;aAgFC;IApEC,8BAA0B;IAC1B,+BAA4B;IAe1B,gCAOqC;IAUrC,4CAkBsC;IAexC,iCAAuB;IAKzB,wBAEC;IAED,sBAEC;IAED;;;OAGG;IACH,QAFa,MAAM,CA6BlB;IAED;;;;;;OAMG;IACH,YAHW,MAAM,GACJ,MAAM,CAkBlB;IAED,gBA2BC;IAED;;OAEG;IACH,gBAIC;IAED;;;OAGG;IACH,qBAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;OAGG;IACH,gBAHW,MAAM,GACJ,OAAO,CAKnB;IAED,yDAUC;IAED,6DAIC;IAED;;;OAGG;IACH,6BAHW,MAAM,GACJ,MAAM,CAIlB;IAED,gDAaC;IAHG,YAAuD;CAI5D;sBA3TqB,gBAAgB;iCAGL,4BAA4B"}

package/dist/types/common/v2/mfe-vitals.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Tracks all Core Web Vitals for a specific MFE.
+ * @param {string} id - The MFE ID to track
+ * @returns {{fcp: object|null, lcp: object|null, cls: object|null, inp: object|null, disconnect: Function}}
+ */
+export function trackMFEVitals(id: string, timings: any): {
+    fcp: object | null;
+    lcp: object | null;
+    cls: object | null;
+    inp: object | null;
+    disconnect: Function;
+};
+export type RegisterAPITimings = any;
+//# sourceMappingURL=mfe-vitals.d.ts.map

package/dist/types/common/v2/mfe-vitals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mfe-vitals.d.ts","sourceRoot":"","sources":["../../../../src/common/v2/mfe-vitals.js"],"names":[],"mappings":"AA+FA;;;;GAIG;AACH,mCAHW,MAAM,iBACJ;IAAC,GAAG,EAAE,MAAM,GAAC,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,GAAC,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,GAAC,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,GAAC,IAAI,CAAC;IAAC,UAAU,WAAU;CAAC,CA0L1G"}

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

@@ -1,6 +1,7 @@
 export class Aggregate extends AggregateBase {
     static featureName: string;
     constructor(agentRef: any);
+    isSessionTrackingEnabled: boolean;
     sentRum: boolean;
     timeToFirstByte: number;
     firstByteToWindowLoad: number;

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":"AAwBA;IACE,2BAA2C;IAE3C,2BA2BC;IAxBC,iBAAoB;IAEpB,wBAAwB;IACxB,8BAA8B;IAC9B,8BAA8B;IAC9B,gBAAgB;IAGhB,uBAA2D;IAkB7D;;;;OAIG;IACH,2BAFW,GAAC,QAiEX;IAbC;;;;;;;;;;;;;;mBAOC;IANC,iCAAyB;IAc7B,kCAEC;IAED;;;;;;aAiGC;CACF;8BAzN6B,4BAA4B;2BAM/B,gCAAgC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/page_view_event/aggregate/index.js"],"names":[],"mappings":"AAyBA;IACE,2BAA2C;IAE3C,2BAuCC;IApCC,kCAAqG;IACrG,iBAAoB;IAEpB,wBAAwB;IACxB,8BAA8B;IAC9B,8BAA8B;IAC9B,gBAAgB;IAGhB,uBAA2D;IA6B7D;;;;OAIG;IACH,2BAFW,GAAC,QAiEX;IAbC;;;;;;;;;;;;;;mBAOC;IANC,iCAAyB;IAc7B,kCAEC;IAED;;;;;;aA6GC;CACF;8BAlP6B,4BAA4B;2BAQ/B,gCAAgC"}

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

@@ -1,7 +1,7 @@
 export class Aggregate extends AggregateBase {
     static featureName: string;
     constructor(agentRef: any, args: any);
-    mode: number;
+    mode: null;
     obfuscator: Obfuscator;
     /** Set once the recorder has fully initialized after flag checks and sampling */
     initialized: boolean;
@@ -66,7 +66,7 @@ export class Aggregate extends AggregateBase {
     forceStop(forceHarvest: any): void;
     /** Abort the feature, once aborted it will not resume */
     abort(reason: {} | undefined, data: any): void;
-    syncWithSessionManager(state?: {}): void;
+    #private;
 }
 import { AggregateBase } from '../../utils/aggregate-base';
 import { Obfuscator } from '../../../common/util/obfuscate';

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":"AA2BA;IACE,2BAAiC;IAIjC,sCA6FC;IAhGD,aAAe;IAOb,uBAA0D;IAE1D,iFAAiF;IACjF,qBAAwB;IAGxB,2CAA2C;IAC3C,sDAAwB;IACxB,6CAA6C;IAC7C,gDAAmB;IACnB,+DAA+D;IAC/D,wBAA0B;IAE1B,0BAA0B;IAC1B,kBAAqB;IACrB,6CAA6C;IAC7C,gBAA2B;IAE3B,qBAA2B;IAE3B,cAA8C;IAI9C,kCAAqG;IAmEvG,0BAEC;IAED,0BAMC;IAED,qBAUC;IAED;;;;;;OAMG;IACH,4BALW,OAAO,iBACP,OAAO;;;;;;QAEL,IAAI,CA8ChB;IAED,2BAUC;IAED,0BA0CC;IAED;;;;OAIG;IACH,6BAHW,MAAM,EAAE,GACN;QAAE,UAAU,EAAE,MAAM,GAAC,SAAS,CAAC;QAAC,SAAS,EAAE,MAAM,GAAC,SAAS,CAAA;KAAE,CAUzE;IAED;;;;;;;;;;MAsEC;IAED,sCAcC;IAED;;;;OAIG;IACH,mCAKC;IAED,yDAAyD;IACzD,+CASC;IAED,yCAIC;CACF;8BA9X6B,4BAA4B;2BAe/B,gCAAgC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/session_replay/aggregate/index.js"],"names":[],"mappings":"AA2BA;IACE,2BAAiC;IAIjC,sCA+FC;IAlGD,WAAW;IAOT,uBAA0D;IAE1D,iFAAiF;IACjF,qBAAwB;IAGxB,2CAA2C;IAC3C,sDAAwB;IACxB,6CAA6C;IAC7C,gDAAmB;IACnB,+DAA+D;IAC/D,wBAA0B;IAE1B,0BAA0B;IAC1B,kBAAqB;IACrB,6CAA6C;IAC7C,gBAA2B;IAE3B,qBAA2B;IAE3B,cAA8C;IAI9C,kCAAqG;IAqEvG,0BAEC;IAED,0BAMC;IAED,qBAUC;IAED;;;;;;OAMG;IACH,4BALW,OAAO,iBACP,OAAO;;;;;;QAEL,IAAI,CA+ChB;IAED,2BAUC;IAED,0BA0CC;IAED;;;;OAIG;IACH,6BAHW,MAAM,EAAE,GACN;QAAE,UAAU,EAAE,MAAM,GAAC,SAAS,CAAC;QAAC,SAAS,EAAE,MAAM,GAAC,SAAS,CAAA;KAAE,CAUzE;IAED;;;;;;;;;;MAsEC;IAED,sCAcC;IAED;;;;OAIG;IACH,mCAKC;IAED,yDAAyD;IACzD,+CASC;;CAOF;8BAjY6B,4BAA4B;2BAe/B,gCAAgC"}

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

@@ -30,7 +30,7 @@ export class Aggregate extends AggregateBase {
     /** Switch from "off" or "error" to full mode (if entitled) */
     switchToFull(): void;
     /** Stop running for the remainder of the page lifecycle */
-    abort(code: any): void;
+    abort(reason?: {}): void;
     postHarvestCleanup(result: any): void;
 }
 import { AggregateBase } from '../../utils/aggregate-base';

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":"AAkBA;IACE,2BAAiC;IAEjC,2BAmBC;IAdC,uBAA0D;IAE1D,0GAA0G;IAC1G,cAAyB;IACzB,mIAAmI;IACnI,uBAA0B;IAC1B,0CAA0C;IAC1C,oBAAuB;IACvB,0GAA0G;IAC1G,2BAA0C;IAO5C,gLAAgL;IAChL,mEA2DC;IApDG,iCAAuB;IACvB,yJAAyJ;IACzJ,UAAsC;IACtC,eAA2D;IAyBD,UAAgE;IA0B9H,qCAWC;IAED,0CAIC;IAED;;;;;;;MAgDC;IAED,8DAA8D;IAC9D,qBAUC;IAED,2DAA2D;IAC3D,uBAMC;IAED,sCAGC;CACF;8BAjM6B,4BAA4B;2BAK/B,gCAAgC;6BAJ9B,iBAAiB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/session_trace/aggregate/index.js"],"names":[],"mappings":"AAkBA;IACE,2BAAiC;IAEjC,2BAmBC;IAdC,uBAA0D;IAE1D,0GAA0G;IAC1G,cAAyB;IACzB,mIAAmI;IACnI,uBAA0B;IAC1B,0CAA0C;IAC1C,oBAAuB;IACvB,0GAA0G;IAC1G,2BAA0C;IAO5C,gLAAgL;IAChL,mEA8DC;IArDG,iCAAuB;IACvB,yJAAyJ;IACzJ,UAAsC;IACtC,eAA2D;IAyBwB,UAAgE;IA2BvJ,qCAWC;IAED,0CAIC;IAED;;;;;;;MAgDC;IAED,8DAA8D;IAC9D,qBAUC;IAED,2DAA2D;IAC3D,yBAMC;IAED,sCAGC;CACF;8BApM6B,4BAA4B;2BAK/B,gCAAgC;6BAJ9B,iBAAiB"}

package/dist/types/features/session_trace/constants.d.ts

@@ -8,4 +8,21 @@ export const FN_END: string;
 export const PUSH_STATE: "pushState";
 export const MAX_NODES_PER_HARVEST: 1000;
 export const ERROR_MODE_SECONDS_WINDOW: number;
+export namespace ABORT_REASONS {
+    namespace CROSS_TAB {
+        let message: string;
+    }
+    namespace ENTITLEMENTS {
+        let message_1: string;
+        export { message_1 as message };
+    }
+    namespace RESET {
+        let message_2: string;
+        export { message_2 as message };
+    }
+    namespace SESSION_CHANGED {
+        let message_3: string;
+        export { message_3 as message };
+    }
+}
 //# sourceMappingURL=constants.d.ts.map

package/dist/types/features/utils/aggregate-base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aggregate-base.d.ts","sourceRoot":"","sources":["../../../../src/features/utils/aggregate-base.js"],"names":[],"mappings":"AAcA;IACE;;;;OAIG;IACH,sBAHW,MAAM,eACN,MAAM,EAkBhB;IAZC,uOAAuO;IACvO,qCAAwC;IACxC,gLAAgL;IAChL,yBAA2B;IAC3B,sFAAsF;IACtF,oBAAuB;IAEvB,gBAAqB;IAqBjB,YAAsE;IAW5E,iNAAiN;IACjN,0CAEC;IAED;;;;OAIG;IACH,8BAHU,MAAM,CAKf;IAED,qBAOC;IAFG,6BAAmB;IAIvB;;;;OAIG;IACH,2BAOC;IAED;;;;OAIG;IACH,yBAHW,MAAM,EAAE,gBAwBlB;IAED;;OAEG;IACH,cAEC;IAED,qCAEC;IAED;;;;;;OAMG;IACH,uDAJW,MAAM,GAAC,SAAS,SAsB1B;IAED;;;;;OAKG;IACH,4BAHG;QAAyB,IAAI,GAArB,OAAO,YAAC;QACS,KAAK,GAAtB,OAAO,YAAC;KAClB,QAKA;IAED;;;OAGG;IACH,2CAIC;IAED;;;;OAIG;IACH,uCAHW,GAAC,UACD,GAAC,QAIX;;CACF;4BAhM2B,gBAAgB"}
+{"version":3,"file":"aggregate-base.d.ts","sourceRoot":"","sources":["../../../../src/features/utils/aggregate-base.js"],"names":[],"mappings":"AAeA;IACE;;;;OAIG;IACH,sBAHW,MAAM,eACN,MAAM,EAkBhB;IAZC,uOAAuO;IACvO,qCAAwC;IACxC,gLAAgL;IAChL,yBAA2B;IAC3B,sFAAsF;IACtF,oBAAuB;IAEvB,gBAAqB;IAqBjB,YAAsE;IAW5E,iNAAiN;IACjN,0CAEC;IAED;;;;OAIG;IACH,8BAHU,MAAM,CAKf;IAED,qBAOC;IAFG,6BAAmB;IAIvB;;;;OAIG;IACH,2BAOC;IAED;;;;OAIG;IACH,yBAHW,MAAM,EAAE,gBAyBlB;IAED;;OAEG;IACH,cAEC;IAED,qCAEC;IAED;;;;;;OAMG;IACH,uDAJW,MAAM,GAAC,SAAS,SAsB1B;IAED;;;;;OAKG;IACH,4BAHG;QAAyB,IAAI,GAArB,OAAO,YAAC;QACS,KAAK,GAAtB,OAAO,YAAC;KAClB,QAKA;IAED;;;OAGG;IACH,2CAIC;IAED;;;;OAIG;IACH,uCAHW,GAAC,UACD,GAAC,QAIX;;CACF;4BAlM2B,gBAAgB"}

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

@@ -1 +1 @@
-{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../../src/loaders/api/register.js"],"names":[],"mappings":"AAmDA;;;;GAIG;AACH,mDAIC;;;;;;;0BArCY,OAAO,sBAAsB,EAAE,WAAW"}
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../../src/loaders/api/register.js"],"names":[],"mappings":"AAoDA;;;;GAIG;AACH,mDAIC;;;;;;;0BArCY,OAAO,sBAAsB,EAAE,WAAW"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newrelic/browser-agent",
-  "version": "1.317.0",
+  "version": "1.318.0-rc.0",
   "private": false,
   "author": "New Relic Browser Agent Team <browser-agent@newrelic.com>",
   "description": "New Relic Browser Agent",
@@ -284,4 +284,4 @@
     "README.md",
     "CHANGELOG.md"
   ]
-}
+}

package/src/common/config/configurable.js

@@ -21,7 +21,7 @@ export function getModeledObject (obj, model) {
 
         if (Array.isArray(obj[key]) && Array.isArray(model[key])) output[key] = Array.from(new Set([...obj[key], ...model[key]]))
         else if (obj[key] instanceof Map || obj[key] instanceof Set || obj[key] instanceof Date || obj[key] instanceof RegExp) output[key] = obj[key]
-        else if (typeof obj[key] === 'object' && typeof model[key] === 'object') output[key] = getModeledObject(obj[key], model[key])
+        else if (typeof obj[key] === 'object' && model[key] !== null && typeof model[key] === 'object') output[key] = getModeledObject(obj[key], model[key])
         else output[key] = obj[key]
       } catch (e) {
         if (!output[key]) warn(1, e)

package/src/common/config/init-types.js

@@ -88,6 +88,8 @@
  * @property {Object} [user_actions]
  * @property {boolean} [user_actions.enabled] - Must be true to allow UserAction events to be captured.
  * @property {Array<string>} [user_actions.elementAttributes] - List of HTML Element properties to be captured with UserAction events' target elements. This may help to identify the source element being interacted with in the UI.
+ * @property {Object} [web_sockets]
+ * @property {boolean} [web_sockets.enabled] - Turn on/off the web sockets feature (off by default).
  */
 
 export default {}

package/src/common/config/init.js

@@ -138,7 +138,8 @@ const InitModelFn = () => {
     session_trace: { enabled: true, autoStart: true },
     soft_navigations: { enabled: true, autoStart: true },
     ssl: undefined,
-    user_actions: { enabled: true, elementAttributes: ['id', 'className', 'tagName', 'type'] }
+    user_actions: { enabled: true, elementAttributes: ['id', 'className', 'tagName', 'type'] },
+    web_sockets: { enabled: false }
   }
 }
 

package/src/common/harvest/harvester.js

@@ -3,19 +3,11 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { SUPPORTABILITY_METRIC_CHANNEL } from '../../features/metrics/constants'
-import { FEATURE_TO_ENDPOINT, JSERRORS, RUM, EVENTS, FEATURE_NAMES, BLOBS, LOGS } from '../../loaders/features/features'
-import { VERSION } from '../constants/env'
-import { globalScope, isWorkerScope } from '../constants/runtime'
+import { FEATURE_TO_ENDPOINT, FEATURE_NAMES } from '../../loaders/features/features'
 import { handle } from '../event-emitter/handle'
-import { eventListenerOpts } from '../event-listener/event-listener-opts'
-import { now } from '../timing/now'
 import { subscribeToEOL } from '../unload/eol'
-import { cleanURL } from '../url/clean-url'
-import { obj, param } from '../url/encode'
-import { warn } from '../util/console'
-import { stringify } from '../util/stringify'
-import { getSubmitMethod, xhr as xhrMethod, xhrFetch as fetchMethod } from '../util/submit-data'
-import { dispatchGlobalEvent } from '../dispatch/global-event'
+import { getSubmitMethod, xhr as xhrMethod } from '../util/submit-data'
+import { send } from './send'
 import { Obfuscator } from '../util/obfuscate'
 
 const RETRY = 'Harvester/Retry/'
@@ -107,194 +99,3 @@ export class Harvester {
     }
   }
 }
-
-/**
- * @typedef {import('./types.js').NetworkSendSpec} NetworkSendSpec
- */
-
-const warnings = {}
-/**
-  * Initiate a harvest call.
-  * @param {NetworkSendSpec} param0 Specification for sending data
-  * @returns {boolean} True if a network call was made. Note that this does not mean or guarantee that it was successful.
-  */
-export function send (agentRef, { endpoint, payload, localOpts = {}, submitMethod, cbFinished, raw, featureName, endpointVersion = 1, harvesterObfuscator }) {
-  if (!agentRef.info.errorBeacon) return false
-
-  let { body, qs } = cleanPayload(payload)
-
-  if (Object.keys(body).length === 0 && !localOpts.sendEmptyBody) { // if there's no body to send, just run onfinish stuff and return
-    if (cbFinished) cbFinished({ sent: false })
-    return false
-  }
-
-  const protocol = agentRef.init.ssl === false ? 'http' : 'https'
-  const perceivedBeacon = agentRef.init.proxy.beacon || agentRef.info.errorBeacon
-  const url = raw
-    ? `${protocol}://${perceivedBeacon}/${endpoint}`
-    : `${protocol}://${perceivedBeacon}${endpoint !== RUM ? '/' + endpoint : ''}/${endpointVersion}/${agentRef.info.licenseKey}`
-  const baseParams = !raw ? baseQueryString(agentRef, qs, endpoint, harvesterObfuscator) : ''
-  let payloadParams = obj(qs, agentRef.runtime.maxBytes)
-  if (baseParams === '' && payloadParams.startsWith('&')) {
-    payloadParams = payloadParams.substring(1)
-  }
-
-  const fullUrl = `${url}?${baseParams}${payloadParams}`
-  const gzip = !!qs?.attributes?.includes('gzip')
-
-  // all gzipped data is already in the correct format and needs no transformation
-  // all features going to 'events' endpoint should already be serialized & stringified
-  let stringBody = gzip || endpoint === EVENTS ? body : stringify(body)
-
-  // If body is null, undefined, or an empty object or array after stringifying, send an empty string instead.
-  if (!stringBody || stringBody.length === 0 || stringBody === '{}' || stringBody === '[]') stringBody = ''
-
-  // Warn--once per endpoint--if the agent tries to send large payloads
-  if (endpoint !== BLOBS && stringBody.length > 750000 && (warnings[endpoint] = (warnings[endpoint] || 0) + 1) === 1) warn(28, endpoint)
-
-  const headers = [{ key: 'content-type', value: 'text/plain' }]
-
-  /* Since workers don't support sendBeacon right now, they can only use XHR method.
-      Because they still do permit synch XHR, the idea is that at final harvest time (worker is closing),
-      we just make a BLOCKING request--trivial impact--with the remaining data as a temp fill-in for sendBeacon.
-     Following the removal of img-element method. */
-  let result = submitMethod({ url: fullUrl, body: stringBody, sync: localOpts.isFinalHarvest && isWorkerScope, headers })
-
-  if (!localOpts.isFinalHarvest && cbFinished) { // final harvests don't hold onto buffer data (shouldRetryOnFail is false), so cleanup isn't needed
-    if (submitMethod === xhrMethod) {
-      result.addEventListener('loadend', function () {
-        // `this` here in block refers to the XHR object in this scope, do not change the anon function to an arrow function
-        // status 0 refers to a local error, such as CORS or network failure, or a blocked request by the browser (e.g. adblocker)
-        const cbResult = { sent: this.status !== 0, status: this.status, retry: shouldRetry(this.status), fullUrl, xhr: this, responseText: this.responseText }
-        cbFinished(cbResult)
-
-        /** temporary audit of consistency of harvest metadata flags */
-        if (!shouldRetry(this.status)) trackHarvestMetadata()
-      }, eventListenerOpts(false))
-    } else if (submitMethod === fetchMethod) {
-      result.then(async function (response) {
-        const status = response.status
-        const cbResult = { sent: true, status, retry: shouldRetry(status), fullUrl, fetchResponse: response, responseText: await response.text() }
-        cbFinished(cbResult)
-        /** temporary audit of consistency of harvest metadata flags */
-        if (!shouldRetry(status)) trackHarvestMetadata()
-      })
-    }
-
-    function trackHarvestMetadata () {
-      try {
-        if (featureName === FEATURE_NAMES.jserrors && !body?.err) return
-
-        const hasReplay = baseParams.includes('hr=1')
-        const hasTrace = baseParams.includes('ht=1')
-        const hasError = qs?.attributes?.includes('hasError=true')
-
-        handle('harvest-metadata', [{
-          [featureName]: {
-            ...(hasReplay && { hasReplay }),
-            ...(hasTrace && { hasTrace }),
-            ...(hasError && { hasError })
-          }
-        }], undefined, FEATURE_NAMES.metrics, agentRef.ee)
-      } catch (err) {
-      // do nothing
-      }
-    }
-  }
-
-  dispatchGlobalEvent({
-    drained: !!agentRef.runtime?.activatedFeatures,
-    type: 'data',
-    name: 'harvest',
-    feature: featureName,
-    data: {
-      endpoint,
-      headers,
-      payload,
-      submitMethod: getSubmitMethodName(),
-      raw,
-      synchronousXhr: !!(localOpts.isFinalHarvest && isWorkerScope)
-    }
-  })
-
-  return true
-
-  function shouldRetry (status) {
-    switch (status) {
-      case 408:
-      case 429:
-      case 500:
-        return true
-    }
-    return (status >= 502 && status <= 504) || (status >= 512 && status <= 530)
-  }
-
-  function getSubmitMethodName () {
-    if (submitMethod === xhrMethod) return 'xhr'
-    if (submitMethod === fetchMethod) return 'fetch'
-    return 'beacon'
-  }
-}
-
-/**
- * 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.
- */
-function cleanPayload (payload = {}) {
-  const clean = (input) => {
-    if ((typeof Uint8Array !== 'undefined' && input instanceof Uint8Array) || Array.isArray(input)) return input
-    if (typeof input === 'string') return input
-    return Object.entries(input || {}).reduce((accumulator, [key, value]) => {
-      if ((typeof value === 'number') ||
-          (typeof value === 'string' && value.length > 0) ||
-          (typeof value === 'object' && Object.keys(value || {}).length > 0)
-      ) {
-        accumulator[key] = value
-      }
-      return accumulator
-    }, {})
-  }
-
-  return {
-    body: clean(payload.body),
-    qs: clean(payload.qs)
-  }
-}
-
-// The stuff that gets sent every time.
-function baseQueryString (agentRef, qs, endpoint, harvesterObfuscator) {
-  const cleanedURL = cleanURL('' + globalScope.location)
-  const ref = harvesterObfuscator?.obfuscateString(cleanedURL) ?? cleanedURL
-  const session = agentRef.runtime.session
-  const hr = !!session?.state.sessionReplaySentFirstChunk && session?.state.sessionReplayMode === 1 && endpoint !== JSERRORS
-  const ht = !!session?.state.traceHarvestStarted && session?.state.sessionTraceMode === 1 && ![LOGS, BLOBS].includes(endpoint)
-
-  const qps = [
-    'a=' + agentRef.info.applicationID,
-    param('sa', (agentRef.info.sa ? '' + agentRef.info.sa : '')),
-    param('v', VERSION),
-    transactionNameParam(),
-    param('ct', agentRef.runtime.customTransaction),
-    '&rst=' + now(),
-    '&ck=0', // ck param DEPRECATED - still expected by backend
-    '&s=' + (session?.state.value || '0'), // the 0 id encaps all untrackable and default traffic
-    param('ref', ref),
-    param('ptid', (agentRef.runtime.ptid ? '' + agentRef.runtime.ptid : ''))
-  ]
-  if (hr) qps.push(param('hr', '1', qs))
-  if (ht) qps.push(param('ht', '1', qs))
-
-  return qps.join('')
-
-  // Constructs the transaction name param for the beacon URL.
-  // Prefers the obfuscated transaction name over the plain text.
-  // Falls back to making up a name.
-  function transactionNameParam () {
-    if (agentRef.info.transactionName) return param('to', agentRef.info.transactionName)
-    return param('t', agentRef.info.tNamePlain || 'Unnamed Transaction')
-  }
-}