@newrelic/browser-agent 1.260.0 → 1.261.0

package/dist/types/features/utils/instrument-base.d.ts

@@ -12,7 +12,7 @@ export class InstrumentBase extends FeatureBase {
      *     of its pooled instrumentation data handled by the agent's centralized drain functionality, rather than draining
      *     immediately. Primarily useful for fine-grained control in tests.
      */
-    constructor(agentIdentifier: string, aggregator: import('../../common/aggregate/aggregator').Aggregator, featureName: string, auto?: boolean | undefined);
+    constructor(agentIdentifier: string, aggregator: import("../../common/aggregate/aggregator").Aggregator, featureName: string, auto?: boolean | undefined);
     auto: boolean;
     /** @type {Function | undefined} This should be set by any derived Instrument class if it has things to do when feature fails or is killed. */
     abortHandler: Function | undefined;
@@ -20,7 +20,7 @@ export class InstrumentBase extends FeatureBase {
      * @type {import('./aggregate-base').AggregateBase} Holds the reference to the feature's aggregate module counterpart, if and after it has been initialized. This may not be assigned until after page loads!
      * The only purpose of this for now is to expose it to the NREUM interface, as the feature's instrument instance is already exposed.
     */
-    featAggregate: import('./aggregate-base').AggregateBase;
+    featAggregate: import("./aggregate-base").AggregateBase;
     /**
      * @type {Promise} Assigned immediately after @see importAggregator runs. Serves as a signal for when the inner async fn finishes execution. Useful for features to await
      * one another if there are inter-features dependencies.

package/dist/types/features/utils/lazy-feature-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lazy-feature-loader.d.ts","sourceRoot":"","sources":["../../../../src/features/utils/lazy-feature-loader.js"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,uEAFa,QAAQ,+BAA2B,IAAI,CAAC,CA6BpD"}
+{"version":3,"file":"lazy-feature-loader.d.ts","sourceRoot":"","sources":["../../../../src/features/utils/lazy-feature-loader.js"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,uEAFa,OAAO,CAAC,cAAc,GAAC,WAAW,GAAC,IAAI,CAAC,CA+BpD"}

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

@@ -23,10 +23,10 @@ export class AgentBase {
      * Adds a user-defined attribute name and value to subsequent events on the page.
      * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setcustomattribute/}
      * @param {string} name Name of the attribute. Appears as column in the PageView event. It will also appear as a column in the PageAction event if you are using it.
-     * @param {string|number|null} value Value of the attribute. Appears as the value in the named attribute column in the PageView event. It will appear as a column in the PageAction event if you are using it. Custom attribute values cannot be complex objects, only simple types such as Strings and Integers.
-     * @param {boolean} [persist] Default false. f set to true, the name-value pair will also be set into the browser's storage API. Then on the following instrumented pages that load within the same session, the pair will be re-applied as a custom attribute.
+     * @param {string|number|boolean|null} value Value of the attribute. Appears as the value in the named attribute column in the PageView event. It will appear as a column in the PageAction event if you are using it. Custom attribute values cannot be complex objects, only simple types such as Strings, Integers and Booleans. Passing a null value unsets any existing attribute of the same name.
+     * @param {boolean} [persist] Default false. If set to true, the name-value pair will also be set into the browser's storage API. Then on the following instrumented pages that load within the same session, the pair will be re-applied as a custom attribute.
      */
-    setCustomAttribute(name: string, value: string | number | null, persist?: boolean | undefined): any;
+    setCustomAttribute(name: string, value: string | number | boolean | null, persist?: boolean | undefined): any;
     /**
      * Identifies a browser error without disrupting your app's operations.
      * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/noticeerror/}
@@ -121,7 +121,28 @@ export class AgentBase {
      *  - Note: Does not apply to MicroAgent
     */
     interaction(): InteractionInstance;
+    /**
+     * Capture a single log.
+     * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/loginfo/}
+     * @param {string} message String to be captured as log message
+     * @param {{customAttributes?: object, level?: 'ERROR'|'TRACE'|'DEBUG'|'INFO'|'WARN'}} [options] customAttributes defaults to `{}` if not assigned, level defaults to `info` if not assigned.
+    */
+    log(message: string, options?: {
+        customAttributes?: object;
+        level?: "ERROR" | "TRACE" | "DEBUG" | "INFO" | "WARN";
+    } | undefined): any;
+    /**
+     * Wrap a logger function to capture a log each time the function is invoked with the message and arguments passed
+     * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/wraplogger/}
+     * @param {object} parent The parent object containing the logger method
+     * @param {string} functionName The property name of the function in the parent object to be wrapped
+     * @param {{customAttributes?: object, level?: 'ERROR'|'TRACE'|'DEBUG'|'INFO'|'WARN'}} [options] customAttributes defaults to `{}` if not assigned, level defaults to `info` if not assigned.
+    */
+    wrapLogger(parent: object, functionName: string, options?: {
+        customAttributes?: object;
+        level?: "ERROR" | "TRACE" | "DEBUG" | "INFO" | "WARN";
+    } | undefined): any;
     #private;
 }
-export type InteractionInstance = import('./api/interaction-types').InteractionInstance;
+export type InteractionInstance = import("./api/interaction-types").InteractionInstance;
 //# sourceMappingURL=agent-base.d.ts.map

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":"AAOA;;GAEG;AAEH;IAGE,sCAKC;IAPD,wBAAe;IAMb,QAAiC;IAanC;;;;;OAKG;IACH,oBAHW,MAAM,wCAKhB;IAED;;;;;OAKG;IACH,sBAHW,MAAM,kCAKhB;IAED;;;;;;OAMG;IACH,yBAJW,MAAM,SACN,MAAM,GAAC,MAAM,GAAC,IAAI,sCAK5B;IAED;;;;;OAKG;IACH,mBAHW,KAAK,GAAC,MAAM,8CAKtB;IAED;;;;OAIG;IACH,iBAFW,MAAM,GAAC,IAAI,OAIrB;IAED;;;;;;;OAOG;IACH,6BAJW,MAAM,GAAC,IAAI,OAMrB;IAED;;;;OAIG;IACH,kCAFmB,KAAK,GAAC,MAAM,KAAK,OAAO,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,OAI9D;IAED;;;;OAIG;IACH,8CAEC;IAED;;;;;OAKG;IACH,iBAHW,MAAM,MACN,MAAM,OAIhB;IAED;;;;OAIG;IACH,yDAEC;IAED;;;;OAIG;IACH,oBAEC;IAED;;;;;OAKG;IACH,mBAEC;IAED;;;;;;;;;;OAUG;IACH,6BARW;QAAC,MAAM,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAC,OAUrF;IAED;;;;;OAKG;IACH,0BAHW,MAAM,OAKhB;IAED;;;;;MAKE;IACF,eAHa,mBAAmB,CAK/B;;CACF;kCA/KY,OAAO,yBAAyB,EAAE,mBAAmB"}
+{"version":3,"file":"agent-base.d.ts","sourceRoot":"","sources":["../../../src/loaders/agent-base.js"],"names":[],"mappings":"AAOA;;GAEG;AAEH;IAGE,sCAKC;IAPD,wBAAe;IAMb,QAAiC;IAanC;;;;;OAKG;IACH,oBAHW,MAAM,wCAKhB;IAED;;;;;OAKG;IACH,sBAHW,MAAM,kCAKhB;IAED;;;;;;OAMG;IACH,yBAJW,MAAM,SACN,MAAM,GAAC,MAAM,GAAC,OAAO,GAAC,IAAI,sCAKpC;IAED;;;;;OAKG;IACH,mBAHW,KAAK,GAAC,MAAM,8CAKtB;IAED;;;;OAIG;IACH,iBAFW,MAAM,GAAC,IAAI,OAIrB;IAED;;;;;;;OAOG;IACH,6BAJW,MAAM,GAAC,IAAI,OAMrB;IAED;;;;OAIG;IACH,0BAFW,CAAC,KAAK,EAAE,KAAK,GAAC,MAAM,KAAK,OAAO,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,OAI9D;IAED;;;;OAIG;IACH,8CAEC;IAED;;;;;OAKG;IACH,iBAHW,MAAM,MACN,MAAM,OAIhB;IAED;;;;OAIG;IACH,yDAEC;IAED;;;;OAIG;IACH,oBAEC;IAED;;;;;OAKG;IACH,mBAEC;IAED;;;;;;;;;;OAUG;IACH,6BARW;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAC,OAUrF;IAED;;;;;OAKG;IACH,0BAHW,MAAM,OAKhB;IAED;;;;;MAKE;IACF,eAHa,mBAAmB,CAK/B;IAED;;;;;MAKE;IACF,aAHW,MAAM;2BACc,MAAM;gBAAU,OAAO,GAAC,OAAO,GAAC,OAAO,GAAC,MAAM,GAAC,MAAM;wBAInF;IAED;;;;;;MAME;IACF,mBAJW,MAAM,gBACN,MAAM;2BACc,MAAM;gBAAU,OAAO,GAAC,OAAO,GAAC,OAAO,GAAC,MAAM,GAAC,MAAM;wBAInF;;CACF;kCApMY,OAAO,yBAAyB,EAAE,mBAAmB"}

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

@@ -1,5 +1,13 @@
 export function setTopLevelCallers(): void;
 export function setAPI(agentIdentifier: any, forceDrain: any, runSoftNavOverSpa?: boolean): {
+    log(message: any, { customAttributes, level }?: {
+        customAttributes?: {} | undefined;
+        level?: string | undefined;
+    }): void;
+    wrapLogger(parent: any, functionName: any, { customAttributes, level }?: {
+        customAttributes?: {} | undefined;
+        level?: string | undefined;
+    }): void;
     addPageAction: (...args: any[]) => any;
     setPageViewName(name: any, host: any): any;
     setCustomAttribute(name: any, value: any, persistAttribute?: boolean): any;

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":"AAmBA,2CAeC;AAID;;;;IAuDE;;;;OAIG;qBAFQ,MAAM;IAWjB;;;;OAIG;iCAFQ,MAAM,GAAC,IAAI;;;;;EAiGvB"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../src/loaders/api/api.js"],"names":[],"mappings":"AAsBA,2CAeC;AAID;;;;;;;;;;;;IAsEE;;;;OAIG;qBAFQ,MAAM;IAWjB;;;;OAIG;iCAFQ,MAAM,GAAC,IAAI;;;;;EAiGvB"}

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;;;;;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"}
+{"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,kBACrB,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG;;;;;wBAOvB,mBAAmB;;;;;oCAOrB,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,KACnB,mBAAmB;;;;;2BAOnB,mBAAmB;;;;;+BAOrB,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,KACnB,mBAAmB;;;;;yBAOnB,mBAAmB;;;;;iCAOrB,MAAM,SACN,GAAG,KACD,mBAAmB;;;;;6BAOrB,MAAM,mCAEJ,mBAAmB"}

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

@@ -1,6 +1,7 @@
 export namespace FEATURE_NAMES {
     let ajax: string;
     let jserrors: string;
+    let logging: string;
     let metrics: string;
     let pageAction: string;
     let pageViewEvent: string;

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

@@ -1 +1 @@
-{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../../../src/loaders/features/features.js"],"names":[],"mappings":";;;;;;;;;;;;AAaA;;;GAGG;AACH;;EAWC"}
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../../../src/loaders/features/features.js"],"names":[],"mappings":";;;;;;;;;;;;;AAcA;;;GAGG;AACH;;EAYC"}

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":"AAmBA;;;;GAIG;AACH;IACE;;;OAGG;IACH,qBAHW,MAAM,oBACN,MAAM,cAmBhB;IAdC,6BAAiF;IACjF,aAAkB;IAMlB;;;;OAIG;IACH,yCAA2C;IAI7C;;;;;MAOC;IAED,mCAyCC;CACF;0BAxFyB,cAAc;2BANb,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,YAAC,EAmBjB;IAdC,6BAAiF;IACjF,aAAkB;IAMlB;;;;OAIG;IACH,yCAA2C;IAI7C;;;;;MAOC;IAED,mCAyCC;CACF;0BAxFyB,cAAc;2BANb,gCAAgC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newrelic/browser-agent",
-  "version": "1.260.0",
+  "version": "1.261.0",
   "private": false,
   "author": "New Relic Browser Agent Team <browser-agent@newrelic.com>",
   "description": "New Relic Browser Agent",
@@ -35,6 +35,9 @@
       "features/jserrors": [
         "dist/types/features/jserrors/index.d.ts"
       ],
+      "features/logging": [
+        "dist/types/features/logging/index.d.ts"
+      ],
       "features/metrics": [
         "dist/types/features/metrics/index.d.ts"
       ],
@@ -91,6 +94,11 @@
       "require": "./dist/cjs/features/jserrors/index.js",
       "default": "./dist/esm/features/jserrors/index.js"
     },
+    "./features/logging": {
+      "types": "./dist/types/features/logging/index.d.ts",
+      "require": "./dist/cjs/features/logging/index.js",
+      "default": "./dist/esm/features/logging/index.js"
+    },
     "./features/metrics": {
       "types": "./dist/types/features/metrics/index.d.ts",
       "require": "./dist/cjs/features/metrics/index.js",
@@ -134,11 +142,8 @@
     "test:component": "jest --selectProjects component",
     "test:types": "tsd -f ./tests/dts/**/*.ts",
     "wdio": "node --max-old-space-size=8192 tools/wdio/bin/cli.js",
-    "jil": "tools/jil/bin/cli.js",
     "build:all": "npm run cdn:build:local && npm run build:npm && npm run tools:test-builds",
     "build:npm": "npm run npm:build:esm && npm run npm:build:cjs && npm run npm:build:types && npm run npm:pack",
-    "build:browser-tests": "npm --prefix ./tools/test-builds/browser-tests run build",
-    "watch:browser-tests": "jung -r ./src -F '.*\\.test\\.js' --run -- npm run build:browser-tests",
     "cdn:build": "npm run cdn:build:prod",
     "cdn:build:local": "npm run cdn:webpack",
     "cdn:build:prod": "npm run cdn:webpack -- --env mode=prod",
@@ -146,17 +151,16 @@
     "cdn:build:experiment": "npm run cdn:webpack -- --env mode=experiment",
     "cdn:webpack": "npx webpack --progress --config ./tools/webpack/index.mjs",
     "cdn:watch": "jung -r ./src -F '.*\\.test\\.js' --run -- npm run cdn:build:local",
-    "cdn:cleanup": "node ./tools/webpack/scripts/cleanup.mjs",
     "test-server": "node ./tools/wdio/bin/server",
-    "sauce:connect": "node ./tools/saucelabs/bin.mjs",
-    "sauce:get-browsers": "node ./tools/browsers-lists/sauce-browsers.mjs",
+    "lt:update-browsers": "node ./tools/browsers-lists/lt-update-supported.mjs",
     "tools:test-builds": "npm --prefix ./tools/test-builds run build-all",
     "third-party-updates": "oss third-party manifest --includeOptDeps && oss third-party notices --includeOptDeps",
     "prepare": "husky install",
     "npm:build:esm": "npx babel --env-name npm-esm --out-dir dist/esm --out-file-extension .js ./src",
     "npm:build:cjs": "npx babel --env-name npm-cjs --out-dir dist/cjs --out-file-extension .js ./src",
     "npm:build:types": "npx tsc -b",
-    "npm:pack": "mkdir -p temp && export PKG_NAME=$(npm pack --pack-destination temp) && echo ./temp/$PKG_NAME"
+    "npm:pack": "mkdir -p temp && export PKG_NAME=$(npm pack --pack-destination temp) && echo ./temp/$PKG_NAME",
+    "publish:nrdb:stage": "npm --prefix .github/actions install && node .github/actions/nr-upload/index.js --environment=stage --loader-version=$npm_package_version --stage-api-key=$STAGE_API_KEY && node .github/actions/nr-verify/index.js --loader-version=$npm_package_version"
   },
   "config": {
     "unsafe-perm": true
@@ -194,17 +198,11 @@
     "@wdio/local-runner": "^8.27.0",
     "@wdio/logger": "^8.24.12",
     "@wdio/mocha-framework": "^8.27.0",
-    "@wdio/sauce-service": "^8.27.0",
     "@wdio/spec-reporter": "^8.27.0",
     "babel-jest": "^29.7.0",
     "babel-loader": "^9.1.3",
     "babel-plugin-transform-inline-environment-variables": "^0.4.4",
-    "babelify": "^10.0.0",
-    "browserify": "^13.3.0",
-    "charm": "^1.0.2",
-    "concat-stream": "^1.5.1",
     "deepmerge-ts": "^5.1.0",
-    "defined": "^1.0.0",
     "dotenv-webpack": "^8.0.1",
     "eslint": "^8.56.0",
     "eslint-config-standard": "^17.1.0",
@@ -214,9 +212,9 @@
     "eslint-plugin-sonarjs": "^0.23.0",
     "fastify": "^4.25.2",
     "fastify-plugin": "^4.5.1",
+    "form-data": "^4.0.0",
     "fs-extra": "^11.2.0",
-    "function-bind": "^1.1.1",
-    "glob": "^10.2.5",
+    "glob": "^10.4.2",
     "html-webpack-plugin": "^5.6.0",
     "husky": "^8.0.3",
     "istanbul-lib-coverage": "^3.2.2",
@@ -227,30 +225,20 @@
     "jest-environment-jsdom": "29.7.0",
     "jest-extended": "^4.0.2",
     "jung": "^2.1.0",
-    "just-debounce": "^1.0.0",
     "node-fetch": "^3.3.2",
     "npm-run-all": "^4.1.5",
-    "object-inspect": "^1.5.0",
-    "path-browserify": "^1.0.1",
-    "preprocessify": "0.0.6",
-    "process": "^0.11.10",
-    "saucelabs": "^7.5.0",
     "semver": "^7.5.4",
     "serialize-anything": "^1.2.3",
-    "stream-browserify": "^3.0.0",
-    "tap-parser": "^1.2.2",
-    "tape": "^4.8.0",
-    "through": "^2.3.8",
+    "terser-webpack-plugin": "^5.3.10",
     "tsd": "^0.30.0",
     "typescript": "^5.3.3",
     "util": "^0.12.5",
     "uuid": "^9.0.1",
     "wait-on": "^7.2.0",
-    "wd": "^1.11.2",
+    "wdio-lambdatest-service": "^2.1.3",
     "webpack": "^5.89.0",
     "webpack-bundle-analyzer": "^4.10.1",
     "webpack-cli": "^5.1.4",
-    "webpack-stream": "^7.0.0",
     "yargs": "^17.7.2"
   },
   "files": [

package/src/cdn/experimental.js

@@ -20,6 +20,7 @@ import { Instrument as InstrumentSessionReplay } from '../features/session_repla
 // import { Instrument as InstrumentSpa } from '../features/spa/instrument'
 import { Instrument as InstrumentSoftNav } from '../features/soft_navigations/instrument'
 import { Instrument as InstrumentPageAction } from '../features/page_action/instrument'
+import { Instrument as InstrumentLogs } from '../features/logging/instrument'
 
 new Agent({
   features: [
@@ -31,6 +32,7 @@ new Agent({
     InstrumentMetrics,
     InstrumentPageAction,
     InstrumentErrors,
+    InstrumentLogs,
     // InstrumentSpa,
     InstrumentSoftNav
   ],

package/src/cdn/polyfills/pro.js

@@ -13,6 +13,7 @@ import { Instrument as InstrumentErrors } from '../../features/jserrors/instrume
 import { Instrument as InstrumentXhr } from '../../features/ajax/instrument'
 import { Instrument as InstrumentSessionTrace } from '../../features/session_trace/instrument'
 import { Instrument as InstrumentPageAction } from '../../features/page_action/instrument'
+import { Instrument as InstrumentLogs } from '../../features/logging/instrument'
 
 new Agent({
   features: [
@@ -22,7 +23,8 @@ new Agent({
     InstrumentXhr,
     InstrumentMetrics,
     InstrumentPageAction,
-    InstrumentErrors
+    InstrumentErrors,
+    InstrumentLogs
   ],
   loaderType: 'pro-polyfills'
 })

package/src/cdn/polyfills/spa.js

@@ -14,6 +14,7 @@ import { Instrument as InstrumentXhr } from '../../features/ajax/instrument'
 import { Instrument as InstrumentSessionTrace } from '../../features/session_trace/instrument'
 import { Instrument as InstrumentSpa } from '../../features/spa/instrument'
 import { Instrument as InstrumentPageAction } from '../../features/page_action/instrument'
+import { Instrument as InstrumentLogs } from '../../features/logging/instrument'
 
 new Agent({
   features: [
@@ -24,6 +25,7 @@ new Agent({
     InstrumentMetrics,
     InstrumentPageAction,
     InstrumentErrors,
+    InstrumentLogs,
     InstrumentSpa
   ],
   loaderType: 'spa-polyfills'

package/src/cdn/pro.js

@@ -13,6 +13,7 @@ import { Instrument as InstrumentXhr } from '../features/ajax/instrument'
 import { Instrument as InstrumentSessionTrace } from '../features/session_trace/instrument'
 import { Instrument as InstrumentSessionReplay } from '../features/session_replay/instrument'
 import { Instrument as InstrumentPageAction } from '../features/page_action/instrument'
+import { Instrument as InstrumentLogs } from '../features/logging/instrument'
 
 new Agent({
   features: [
@@ -23,7 +24,8 @@ new Agent({
     InstrumentXhr,
     InstrumentMetrics,
     InstrumentPageAction,
-    InstrumentErrors
+    InstrumentErrors,
+    InstrumentLogs
   ],
   loaderType: 'pro'
 })

package/src/cdn/spa.js

@@ -14,6 +14,7 @@ import { Instrument as InstrumentSessionReplay } from '../features/session_repla
 import { Instrument as InstrumentSoftNav } from '../features/soft_navigations/instrument'
 import { Instrument as InstrumentSpa } from '../features/spa/instrument'
 import { Instrument as InstrumentPageAction } from '../features/page_action/instrument'
+import { Instrument as InstrumentLogs } from '../features/logging/instrument'
 
 new Agent({
   features: [
@@ -25,6 +26,7 @@ new Agent({
     InstrumentMetrics,
     InstrumentPageAction,
     InstrumentErrors,
+    InstrumentLogs,
     InstrumentSoftNav,
     InstrumentSpa // either the softnav or the old spa will be used (not both), but we still need to pack both to avoid dynamic import for instrument files
   ],

package/src/common/config/state/init.js

@@ -1,3 +1,4 @@
+import { LOG_LEVELS } from '../../../features/logging/constants'
 import { isValidSelector } from '../../dom/query-selector'
 import { DEFAULT_EXPIRES_MS, DEFAULT_INACTIVE_MS } from '../../session/constants'
 import { warn } from '../../util/console'
@@ -31,12 +32,6 @@ const model = () => {
     }
   }
   return {
-    feature_flags: [],
-    proxy: {
-      assets: undefined, // if this value is set, it will be used to overwrite the webpack asset path used to fetch assets
-      beacon: undefined // likewise for the url to which we send analytics
-    },
-    privacy: { cookies_enabled: true }, // *cli - per discussion, default should be true
     ajax: { deny_list: undefined, block_internal: true, enabled: true, harvestTimeSeconds: 10, autoStart: true },
     distributed_tracing: {
       enabled: undefined,
@@ -45,19 +40,24 @@ const model = () => {
       cors_use_tracecontext_headers: undefined,
       allowed_origins: undefined
     },
-    session: {
-      expiresMs: DEFAULT_EXPIRES_MS,
-      inactiveMs: DEFAULT_INACTIVE_MS
-    },
-    ssl: undefined,
-    obfuscate: undefined,
+    feature_flags: [],
+    harvest: { tooManyRequestsDelay: 60 },
     jserrors: { enabled: true, harvestTimeSeconds: 10, autoStart: true },
+    logging: { enabled: true, harvestTimeSeconds: 10, autoStart: true, level: LOG_LEVELS.INFO },
     metrics: { enabled: true, autoStart: true },
+    obfuscate: undefined,
     page_action: { enabled: true, harvestTimeSeconds: 30, autoStart: true },
     page_view_event: { enabled: true, autoStart: true },
     page_view_timing: { enabled: true, harvestTimeSeconds: 30, long_task: false, autoStart: true },
-    session_trace: { enabled: true, harvestTimeSeconds: 10, autoStart: true },
-    harvest: { tooManyRequestsDelay: 60 },
+    privacy: { cookies_enabled: true }, // *cli - per discussion, default should be true
+    proxy: {
+      assets: undefined, // if this value is set, it will be used to overwrite the webpack asset path used to fetch assets
+      beacon: undefined // likewise for the url to which we send analytics
+    },
+    session: {
+      expiresMs: DEFAULT_EXPIRES_MS,
+      inactiveMs: DEFAULT_INACTIVE_MS
+    },
     session_replay: {
       // feature settings
       autoStart: true,
@@ -100,8 +100,10 @@ const model = () => {
         else warn('An invalid session_replay.mask_input_option was provided and will not be used', val)
       }
     },
+    session_trace: { enabled: true, harvestTimeSeconds: 10, autoStart: true },
+    soft_navigations: { enabled: true, harvestTimeSeconds: 10, autoStart: true },
     spa: { enabled: true, harvestTimeSeconds: 10, autoStart: true },
-    soft_navigations: { enabled: true, harvestTimeSeconds: 10, autoStart: true }
+    ssl: undefined
   }
 }
 

package/src/common/constants/runtime.js

@@ -5,6 +5,8 @@
  * @license Apache-2.0
  */
 
+import { now } from '../timing/now'
+
 /**
  * Indicates if the agent is running within a normal browser window context.
  */
@@ -79,4 +81,4 @@ export const supportsSendBeacon = !!globalScope.navigator?.sendBeacon
  * according to the browser's local clock.
  * @type {number}
  */
-export const originTime = Math.floor(Date.now() - performance.now())
+export const originTime = Date.now() - now()

package/src/common/deny-list/deny-list.js

@@ -10,7 +10,7 @@ var denyList = []
  * @returns {boolean} `true` if request does not match any entries of {@link denyList|deny list}; else `false`
  */
 export function shouldCollectEvent (params) {
-  if (hasUndefinedHostname(params)) return false
+  if (!params || hasUndefinedHostname(params)) return false
 
   if (denyList.length === 0) return true
 

package/src/common/session/session-entity.js

@@ -3,7 +3,7 @@ import { warn } from '../util/console'
 import { stringify } from '../util/stringify'
 import { ee } from '../event-emitter/contextual-ee'
 import { Timer } from '../timer/timer'
-import { isBrowserScope } from '../constants/runtime'
+import { isBrowserScope, isIE } from '../constants/runtime'
 import { DEFAULT_EXPIRES_MS, DEFAULT_INACTIVE_MS, MODE, PREFIX, SESSION_EVENTS, SESSION_EVENT_TYPES } from './constants'
 import { InteractionTimer } from '../timer/interaction-timer'
 import { wrapEvents } from '../wrap'
@@ -52,7 +52,12 @@ export class SessionEntity {
     wrapEvents(this.ee)
     this.setup(opts)
 
-    if (isBrowserScope) {
+    /**
+     * Do not emit session storage events for IE11, because IE11 is unable to determine
+     * if the event was spawned on the current page or an adjacent page, and the behavior tied
+     * to storage events is critical to apply only to cross-tab behavior
+     * */
+    if (isBrowserScope && !isIE) {
       windowAddEventListener('storage', (event) => {
         if (event.key === this.lookupKey) {
           const obj = typeof event.newValue === 'string' ? JSON.parse(event.newValue) : event.newValue

package/src/common/timing/time-keeper.js

@@ -61,7 +61,7 @@ export class TimeKeeper {
     }
 
     const medianRumOffset = (endTime - startTime) / 2
-    const serverOffset = Math.floor(startTime + medianRumOffset)
+    const serverOffset = startTime + medianRumOffset
 
     // Corrected page origin time
     this.#correctedOriginTime = Math.floor(Date.parse(responseDateHeader) - serverOffset)
@@ -82,7 +82,7 @@ export class TimeKeeper {
    * @returns {number} Corrected unix/epoch timestamp
    */
   convertRelativeTimestamp (relativeTime) {
-    return this.#correctedOriginTime + relativeTime
+    return Math.floor(this.#correctedOriginTime + relativeTime)
   }
 
   /**

package/src/common/wrap/wrap-logger.js

@@ -0,0 +1,49 @@
+/*
+ * Copyright 2020 New Relic Corporation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @file Wraps native timeout and interval methods for instrumentation.
+ * This module is used by: jserrors, spa.
+ */
+
+import { ee as baseEE, contextId } from '../event-emitter/contextual-ee'
+import { EventContext } from '../event-emitter/event-context'
+import { createWrapperWithEmitter as wfn } from './wrap-function'
+
+/**
+ * Wraps a supplied function and adds emitter events under the `-wrap-logger-` prefix
+ * @param {Object} sharedEE - The shared event emitter on which a new scoped event emitter will be based.
+ * @param {Object} parent - The parent object housing the logger function
+ * @param {string} loggerFn - The name of the function in the parent object to wrap
+ * @returns {Object} Scoped event emitter with a debug ID of `logger`.
+ */
+// eslint-disable-next-line
+export function wrapLogger(sharedEE, parent, loggerFn, context) {
+  const ee = scopedEE(sharedEE)
+  const wrapFn = wfn(ee)
+
+  /**
+   * This section contains the context that will be shared across all invoked calls of the wrapped function,
+   * which will be used to decorate the log data later at agg time
+  */
+  const ctx = new EventContext(contextId)
+  ctx.level = context.level
+  ctx.customAttributes = context.customAttributes
+
+  /** observe calls to <loggerFn> and emit events prefixed with `wrap-logger-` */
+  wrapFn.inPlace(parent, [loggerFn], 'wrap-logger-', ctx)
+
+  return ee
+}
+
+/**
+ * Returns an event emitter scoped specifically for the `logger` context. This scoping is a remnant from when all the
+ * features shared the same group in the event, to isolate events between features. It will likely be revisited.
+ * @param {Object} sharedEE - Optional event emitter on which to base the scoped emitter.
+ *     Uses `ee` on the global scope if undefined).
+ * @returns {Object} Scoped event emitter with a debug ID of 'logger'.
+ */
+export function scopedEE (sharedEE) {
+  return (sharedEE || baseEE).get('logger')
+}

package/src/features/logging/aggregate/index.js

@@ -0,0 +1,101 @@
+import { getConfigurationValue, getInfo, getRuntime } from '../../../common/config/config'
+import { handle } from '../../../common/event-emitter/handle'
+import { registerHandler } from '../../../common/event-emitter/register-handler'
+import { HarvestScheduler } from '../../../common/harvest/harvest-scheduler'
+import { warn } from '../../../common/util/console'
+import { stringify } from '../../../common/util/stringify'
+import { SUPPORTABILITY_METRIC_CHANNEL } from '../../metrics/constants'
+import { AggregateBase } from '../../utils/aggregate-base'
+import { FEATURE_NAME, LOGGING_EVENT_EMITTER_CHANNEL, LOGGING_IGNORED, MAX_PAYLOAD_SIZE } from '../constants'
+import { Log } from '../shared/log'
+
+export class Aggregate extends AggregateBase {
+  static featureName = FEATURE_NAME
+  #agentRuntime
+  #agentInfo
+  constructor (agentIdentifier, aggregator) {
+    super(agentIdentifier, aggregator, FEATURE_NAME)
+
+    /** held logs before sending */
+    this.bufferedLogs = []
+    /** held logs during sending, for retries */
+    this.outgoingLogs = []
+    /** the estimated bytes of log data waiting to be sent -- triggers a harvest if adding a new log will exceed limit  */
+    this.estimatedBytes = 0
+
+    this.#agentRuntime = getRuntime(this.agentIdentifier)
+    this.#agentInfo = getInfo(this.agentIdentifier)
+
+    this.harvestTimeSeconds = getConfigurationValue(this.agentIdentifier, 'logging.harvestTimeSeconds')
+
+    this.waitForFlags([]).then(() => {
+      this.scheduler = new HarvestScheduler('browser/logs', {
+        onFinished: this.onHarvestFinished.bind(this),
+        retryDelay: this.harvestTimeSeconds,
+        getPayload: this.prepareHarvest.bind(this),
+        raw: true
+      }, this)
+      /** harvest immediately once started to purge pre-load logs collected */
+      this.scheduler.startTimer(this.harvestTimeSeconds, 0)
+      /** emitted by instrument class (wrapped loggers) or the api methods directly */
+      registerHandler(LOGGING_EVENT_EMITTER_CHANNEL, this.handleLog.bind(this), this.featureName, this.ee)
+      this.drain()
+    })
+  }
+
+  handleLog (timestamp, message, attributes, level) {
+    if (this.blocked) return
+    const log = new Log(
+      this.#agentRuntime.timeKeeper.convertRelativeTimestamp(timestamp),
+      message,
+      attributes,
+      level
+    )
+    const logBytes = log.message.length + stringify(log.attributes).length + log.level.length + 10 // timestamp == 10 chars
+    if (logBytes > MAX_PAYLOAD_SIZE) {
+      handle(SUPPORTABILITY_METRIC_CHANNEL, ['Logging/Harvest/Failed/Seen', logBytes])
+      return warn(LOGGING_IGNORED + '> ' + MAX_PAYLOAD_SIZE + ' bytes', log.message.slice(0, 25) + '...')
+    }
+
+    if (this.estimatedBytes + logBytes >= MAX_PAYLOAD_SIZE) {
+      handle(SUPPORTABILITY_METRIC_CHANNEL, ['Logging/Harvest/Early/Seen', this.estimatedBytes + logBytes])
+      this.scheduler.runHarvest({})
+    }
+    this.estimatedBytes += logBytes
+    this.bufferedLogs.push(log)
+  }
+
+  prepareHarvest () {
+    if (this.blocked || !(this.bufferedLogs.length || this.outgoingLogs.length)) return
+    /** populate outgoing array while also clearing main buffer */
+    this.outgoingLogs.push(...this.bufferedLogs.splice(0))
+    this.estimatedBytes = 0
+    /** see https://source.datanerd.us/agents/rum-specs/blob/main/browser/Log for logging spec */
+    return {
+      qs: {
+        browser_monitoring_key: this.#agentInfo.licenseKey
+      },
+      body: [{
+        common: {
+          /** Attributes in the `common` section are added to `all` logs generated in the payload */
+          attributes: {
+            'entity.guid': this.#agentRuntime.appMetadata?.agents?.[0]?.entityGuid, // browser entity guid as provided from RUM response
+            session: this.#agentRuntime?.session?.state.value || '0', // The session ID that we generate and keep across page loads
+            hasReplay: this.#agentRuntime?.session?.state.sessionReplayMode === 1, // True if a session replay recording is running
+            hasTrace: this.#agentRuntime?.session?.state.sessionTraceMode === 1, // True if a session trace recording is running
+            ptid: this.#agentRuntime.ptid, // page trace id
+            appId: this.#agentInfo.applicationID, // Application ID from info object,
+            standalone: Boolean(this.#agentInfo.sa), // copy paste (true) vs APM (false)
+            agentVersion: this.#agentRuntime.version // browser agent version
+          }
+        },
+        /** logs section contains individual unique log entries */
+        logs: this.outgoingLogs
+      }]
+    }
+  }
+
+  onHarvestFinished (result) {
+    if (!result.retry) this.outgoingLogs = []
+  }
+}

package/src/features/logging/constants.js

@@ -0,0 +1,19 @@
+import { FEATURE_NAMES } from '../../loaders/features/features'
+
+export const LOG_LEVELS = {
+  ERROR: 'ERROR',
+  WARN: 'WARN',
+  INFO: 'INFO',
+  DEBUG: 'DEBUG',
+  TRACE: 'TRACE'
+}
+
+export const LOGGING_EVENT_EMITTER_CHANNEL = 'log'
+
+export const FEATURE_NAME = FEATURE_NAMES.logging
+
+export const MAX_PAYLOAD_SIZE = 1000000
+
+export const LOGGING_FAILURE_MESSAGE = 'failed to wrap logger: '
+export const LOGGING_LEVEL_FAILURE_MESSAGE = 'invalid log level: '
+export const LOGGING_IGNORED = 'ignored log: '