@newrelic/browser-agent 1.272.0 → 1.273.1

package/src/loaders/micro-agent-base.js

@@ -0,0 +1,113 @@
+import { warn } from '../common/util/console'
+import { generateRandomHexString } from '../common/ids/unique-id'
+
+export class MicroAgentBase {
+  agentIdentifier
+
+  constructor (agentIdentifier = generateRandomHexString(16)) {
+    this.agentIdentifier = agentIdentifier
+  }
+
+  /**
+   * Tries to execute the api and generates a generic warning message with the api name injected if unsuccessful
+   * @param {string} methodName
+   * @param  {...any} args
+   */
+  #callMethod (methodName, ...args) {
+    if (typeof this.api?.[methodName] !== 'function') warn(35, methodName)
+    else return this.api[methodName](...args)
+  }
+
+  // MicroAgent class custom defines its own start
+
+  /**
+   * Reports a browser PageAction event along with a name and optional attributes.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/addpageaction/}
+   * @param {string} name Name or category of the action. Reported as the actionName attribute.
+   * @param {object} [attributes] JSON object with one or more key/value pairs. For example: {key:"value"}. The key is reported as its own PageAction attribute with the specified values.
+   */
+  addPageAction (name, attributes) {
+    return this.#callMethod('addPageAction', name, attributes)
+  }
+
+  /**
+   * Groups page views to help URL structure or to capture the URL's routing information.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setpageviewname/}
+   * @param {string} name The page name you want to use. Use alphanumeric characters.
+   * @param {string} [host] Default is http://custom.transaction. Typically set host to your site's domain URI.
+   */
+  setPageViewName (name, host) {
+    return this.#callMethod('setPageViewName', name, host)
+  }
+
+  /**
+   * 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|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, value, persist) {
+    return this.#callMethod('setCustomAttribute', name, value, persist)
+  }
+
+  /**
+   * Identifies a browser error without disrupting your app's operations.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/noticeerror/}
+   * @param {Error|string} error Provide a meaningful error message that you can use when analyzing data on browser's JavaScript errors page.
+   * @param {object} [customAttributes] An object containing name/value pairs representing custom attributes.
+   */
+  noticeError (error, customAttributes) {
+    return this.#callMethod('noticeError', error, customAttributes)
+  }
+
+  /**
+   * Adds a user-defined identifier string to subsequent events on the page.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/setuserid/}
+   * @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) {
+    return this.#callMethod('setUserId', value)
+  }
+
+  /**
+   * 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) {
+    return this.#callMethod('setApplicationVersion', value)
+  }
+
+  /**
+   * 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/}
+   * @param {(error: Error|string) => boolean | { group: string }} callback When an error occurs, the callback is called with the error object as a parameter. The callback will be called with each error, so it is not specific to one error.
+   */
+  setErrorHandler (callback) {
+    return this.#callMethod('setErrorHandler', callback)
+  }
+
+  /**
+   * Adds a unique name and ID to identify releases with multiple JavaScript bundles on the same page.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/addrelease/}
+   * @param {string} name A short description of the component; for example, the name of a project, application, file, or library.
+   * @param {string} id The ID or version of this release; for example, a version number, build number from your CI environment, GitHub SHA, GUID, or a hash of the contents.
+   */
+  addRelease (name, id) {
+    return this.#callMethod('addRelease', name, id)
+  }
+
+  /**
+   * Capture a single log.
+   * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/log/}
+   * @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, options) {
+    return this.#callMethod('log', message, options)
+  }
+}

package/src/loaders/micro-agent.js

@@ -4,13 +4,9 @@ import { getEnabledFeatures } from './features/enabled-features'
 import { configure } from './configure/configure'
 // core files
 import { setNREUMInitializedAgent } from '../common/window/nreum'
-import { getInfo } from '../common/config/info'
-import { getConfiguration, getConfigurationValue } from '../common/config/init'
-import { getLoaderConfig } from '../common/config/loader-config'
-import { getRuntime } from '../common/config/runtime'
 import { FEATURE_NAMES } from './features/features'
 import { warn } from '../common/util/console'
-import { AgentBase } from './agent-base'
+import { MicroAgentBase } from './micro-agent-base'
 
 const nonAutoFeatures = [
   FEATURE_NAMES.jserrors,
@@ -24,7 +20,7 @@ const nonAutoFeatures = [
  * automatically instrument. Instead, each MicroAgent instance will lazy load the required features and can support loading multiple instances on one page.
  * Out of the box, it can manually handle and report Page View, Page Action, and Error events.
  */
-export class MicroAgent extends AgentBase {
+export class MicroAgent extends MicroAgentBase {
   /**
    * @param {Object} options - Specifies features and runtime configuration,
    * @param {string=} agentIdentifier - The optional unique ID of the agent.
@@ -41,62 +37,53 @@ export class MicroAgent extends AgentBase {
     /**
      * Starts a set of agent features if not running in "autoStart" mode
      * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/start/}
-     * @param {string|string[]|undefined} name The feature name(s) to start.  If no name(s) are passed, all features will be started
+     * @param {string|string[]} [featureNames] The feature name(s) to start.  If no name(s) are passed, all features will be started
      */
-    this.start = features => this.run(features)
-    this.run(nonAutoFeatures.filter(featureName => getConfigurationValue(this.agentIdentifier, `${featureName}.autoStart`)))
-  }
-
-  get config () {
-    return {
-      info: getInfo(this.agentIdentifier),
-      init: getConfiguration(this.agentIdentifier),
-      loader_config: getLoaderConfig(this.agentIdentifier),
-      runtime: getRuntime(this.agentIdentifier)
-    }
-  }
+    this.start = (featureNames) => {
+      try {
+        if (featureNames === undefined || (Array.isArray(featureNames) && featureNames.length === 0)) featureNames = nonAutoFeatures
+        else if (typeof featureNames === 'string') featureNames = [featureNames]
 
-  run (features) {
-    try {
-      const featNames = nonAutoFeatures
-      if (features === undefined) features = featNames
-      else {
-        features = Array.isArray(features) && features.length ? features : [features]
-        if (features.some(f => !featNames.includes(f))) return warn(37, featNames)
-        if (!features.includes(FEATURE_NAMES.pageViewEvent)) features.push(FEATURE_NAMES.pageViewEvent)
-      }
-    } catch (err) {
-      warn(23, err)
-    }
+        if (featureNames.some(f => !nonAutoFeatures.includes(f))) warn(37, nonAutoFeatures)
+        const enabledFeatures = getEnabledFeatures(this.agentIdentifier)
 
-    try {
-      const enabledFeatures = getEnabledFeatures(this.agentIdentifier)
+        try {
+          // a biproduct of doing this is that the "session manager" is automatically handled through importing this feature
+          this.features.page_view_event = new PVE(this)
+        } catch (err) {
+          warn(24, err)
+        }
 
-      try {
-        // a biproduct of doing this is that the "session manager" is automatically handled through importing this feature
-        this.features.page_view_event = new PVE(this)
+        this.features.page_view_event.onAggregateImported.then(() => {
+          /* The following features do not import an "instrument" file, meaning they are only hooked up to the API.
+          Since the missing instrument-base class handles drain-gating (racing behavior) and PVE handles some setup, these are chained until after PVE has finished initializing
+          so as to avoid the race condition of things like session and sharedAggregator not being ready by features that uses them right away. */
+          nonAutoFeatures.forEach(f => {
+            if (enabledFeatures[f] && featureNames.includes(f)) {
+              import(/* webpackChunkName: "lazy-feature-loader" */ '../features/utils/lazy-feature-loader').then(({ lazyFeatureLoader }) => {
+                return lazyFeatureLoader(f, 'aggregate')
+              }).then(({ Aggregate }) => {
+                this.features[f] = new Aggregate(this)
+              }).catch(err => warn(25, err))
+            }
+          })
+        })
+        return true
       } catch (err) {
-        warn(24, err)
+        warn(26, err)
+        return false
       }
+    }
 
-      this.features.page_view_event.onAggregateImported.then(() => {
-        /* The following features do not import an "instrument" file, meaning they are only hooked up to the API.
-        Since the missing instrument-base class handles drain-gating (racing behavior) and PVE handles some setup, these are chained until after PVE has finished initializing
-        so as to avoid the race condition of things like session and sharedAggregator not being ready by features that uses them right away. */
-        nonAutoFeatures.forEach(f => {
-          if (enabledFeatures[f] && features.includes(f)) {
-            import(/* webpackChunkName: "lazy-feature-loader" */ '../features/utils/lazy-feature-loader').then(({ lazyFeatureLoader }) => {
-              return lazyFeatureLoader(f, 'aggregate')
-            }).then(({ Aggregate }) => {
-              this.features[f] = new Aggregate(this)
-            }).catch(err => warn(25, err))
-          }
-        })
-      })
-      return true
-    } catch (err) {
-      warn(26, err)
-      return false
+    this.start(nonAutoFeatures.filter(featureName => !!this.init[featureName].autoStart))
+  }
+
+  get config () {
+    return {
+      info: this.info,
+      init: this.init,
+      loader_config: this.loader_config,
+      runtime: this.runtime
     }
   }
 }

package/dist/cjs/features/ajax/aggregate/chunk.js

@@ -1,51 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-var _belSerializer = require("../../../common/serialize/bel-serializer");
-var _info = require("../../../common/config/info");
-var _agentConstants = require("../../../common/constants/agent-constants");
-class Chunk {
-  constructor(events, aggregateInstance) {
-    this.addString = (0, _belSerializer.getAddStringContext)(aggregateInstance.agentIdentifier); // pass agentIdentifier here
-    this.events = events;
-    this.payload = 'bel.7;';
-    for (let i = 0; i < events.length; i++) {
-      const event = events[i];
-      const fields = [(0, _belSerializer.numeric)(event.startTime), (0, _belSerializer.numeric)(event.endTime - event.startTime), (0, _belSerializer.numeric)(0),
-      // callbackEnd
-      (0, _belSerializer.numeric)(0),
-      // no callbackDuration for non-SPA events
-      this.addString(event.method), (0, _belSerializer.numeric)(event.status), this.addString(event.domain), this.addString(event.path), (0, _belSerializer.numeric)(event.requestSize), (0, _belSerializer.numeric)(event.responseSize), event.type === 'fetch' ? 1 : '', this.addString(0),
-      // nodeId
-      (0, _belSerializer.nullable)(event.spanId, this.addString, true) +
-      // guid
-      (0, _belSerializer.nullable)(event.traceId, this.addString, true) +
-      // traceId
-      (0, _belSerializer.nullable)(event.spanTimestamp, _belSerializer.numeric, false) // timestamp
-      ];
-      let insert = '2,';
-
-      // Since configuration objects (like info) are created new each time they are set, we have to grab the current pointer to the attr object here.
-      const jsAttributes = (0, _info.getInfo)(aggregateInstance.agentIdentifier).jsAttributes;
-
-      // add custom attributes
-      // gql decorators are added as custom attributes to alleviate need for new BEL schema
-      const attrParts = (0, _belSerializer.addCustomAttributes)({
-        ...(jsAttributes || {}),
-        ...(event.gql || {})
-      }, this.addString);
-      fields.unshift((0, _belSerializer.numeric)(attrParts.length));
-      insert += fields.join(',');
-      if (attrParts && attrParts.length > 0) {
-        insert += ';' + attrParts.join(';');
-      }
-      if (i + 1 < events.length) insert += ';';
-      this.payload += insert;
-    }
-    this.tooBig = this.payload.length * 2 > _agentConstants.MAX_PAYLOAD_SIZE;
-  }
-}
-exports.default = Chunk;

package/dist/esm/features/ajax/aggregate/chunk.js

@@ -1,44 +0,0 @@
-import { nullable, numeric, getAddStringContext, addCustomAttributes } from '../../../common/serialize/bel-serializer';
-import { getInfo } from '../../../common/config/info';
-import { MAX_PAYLOAD_SIZE } from '../../../common/constants/agent-constants';
-export default class Chunk {
-  constructor(events, aggregateInstance) {
-    this.addString = getAddStringContext(aggregateInstance.agentIdentifier); // pass agentIdentifier here
-    this.events = events;
-    this.payload = 'bel.7;';
-    for (let i = 0; i < events.length; i++) {
-      const event = events[i];
-      const fields = [numeric(event.startTime), numeric(event.endTime - event.startTime), numeric(0),
-      // callbackEnd
-      numeric(0),
-      // no callbackDuration for non-SPA events
-      this.addString(event.method), numeric(event.status), this.addString(event.domain), this.addString(event.path), numeric(event.requestSize), numeric(event.responseSize), event.type === 'fetch' ? 1 : '', this.addString(0),
-      // nodeId
-      nullable(event.spanId, this.addString, true) +
-      // guid
-      nullable(event.traceId, this.addString, true) +
-      // traceId
-      nullable(event.spanTimestamp, numeric, false) // timestamp
-      ];
-      let insert = '2,';
-
-      // Since configuration objects (like info) are created new each time they are set, we have to grab the current pointer to the attr object here.
-      const jsAttributes = getInfo(aggregateInstance.agentIdentifier).jsAttributes;
-
-      // add custom attributes
-      // gql decorators are added as custom attributes to alleviate need for new BEL schema
-      const attrParts = addCustomAttributes({
-        ...(jsAttributes || {}),
-        ...(event.gql || {})
-      }, this.addString);
-      fields.unshift(numeric(attrParts.length));
-      insert += fields.join(',');
-      if (attrParts && attrParts.length > 0) {
-        insert += ';' + attrParts.join(';');
-      }
-      if (i + 1 < events.length) insert += ';';
-      this.payload += insert;
-    }
-    this.tooBig = this.payload.length * 2 > MAX_PAYLOAD_SIZE;
-  }
-}

package/dist/types/features/ajax/aggregate/chunk.d.ts

@@ -1,8 +0,0 @@
-export default class Chunk {
-    constructor(events: any, aggregateInstance: any);
-    addString: (str: any) => string;
-    events: any;
-    payload: string;
-    tooBig: boolean;
-}
-//# sourceMappingURL=chunk.d.ts.map

package/dist/types/features/ajax/aggregate/chunk.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chunk.d.ts","sourceRoot":"","sources":["../../../../../src/features/ajax/aggregate/chunk.js"],"names":[],"mappings":"AAIA;IACE,iDA6CC;IA5CC,gCAAuE;IACvE,YAAoB;IACpB,gBAAuB;IAyCvB,gBAAwD;CAE3D"}

package/src/features/ajax/aggregate/chunk.js

@@ -1,52 +0,0 @@
-import { nullable, numeric, getAddStringContext, addCustomAttributes } from '../../../common/serialize/bel-serializer'
-import { getInfo } from '../../../common/config/info'
-import { MAX_PAYLOAD_SIZE } from '../../../common/constants/agent-constants'
-
-export default class Chunk {
-  constructor (events, aggregateInstance) {
-    this.addString = getAddStringContext(aggregateInstance.agentIdentifier) // pass agentIdentifier here
-    this.events = events
-    this.payload = 'bel.7;'
-
-    for (let i = 0; i < events.length; i++) {
-      const event = events[i]
-      const fields = [
-        numeric(event.startTime),
-        numeric(event.endTime - event.startTime),
-        numeric(0), // callbackEnd
-        numeric(0), // no callbackDuration for non-SPA events
-        this.addString(event.method),
-        numeric(event.status),
-        this.addString(event.domain),
-        this.addString(event.path),
-        numeric(event.requestSize),
-        numeric(event.responseSize),
-        event.type === 'fetch' ? 1 : '',
-        this.addString(0), // nodeId
-        nullable(event.spanId, this.addString, true) + // guid
-        nullable(event.traceId, this.addString, true) + // traceId
-        nullable(event.spanTimestamp, numeric, false) // timestamp
-      ]
-
-      let insert = '2,'
-
-      // Since configuration objects (like info) are created new each time they are set, we have to grab the current pointer to the attr object here.
-      const jsAttributes = getInfo(aggregateInstance.agentIdentifier).jsAttributes
-
-      // add custom attributes
-      // gql decorators are added as custom attributes to alleviate need for new BEL schema
-      const attrParts = addCustomAttributes({ ...(jsAttributes || {}), ...(event.gql || {}) }, this.addString)
-      fields.unshift(numeric(attrParts.length))
-
-      insert += fields.join(',')
-      if (attrParts && attrParts.length > 0) {
-        insert += ';' + attrParts.join(';')
-      }
-      if ((i + 1) < events.length) insert += ';'
-
-      this.payload += insert
-    }
-
-    this.tooBig = this.payload.length * 2 > MAX_PAYLOAD_SIZE
-  }
-}