@newrelic/browser-agent 0.0.9 → 0.1.229

package/dist/cjs/features/page_view_event/aggregate/index.js

@@ -0,0 +1,133 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Aggregate = void 0;
+var _handle = require("../../../common/event-emitter/handle");
+var _features = require("../../../loaders/features/features");
+var _iosVersion = require("../../../common/browser-version/ios-version");
+var _webVitals = require("web-vitals");
+var _mapOwn = require("../../../common/util/map-own");
+var _encode = require("../../../common/url/encode");
+var _navTiming = require("../../../common/timing/nav-timing");
+var _stringify = require("../../../common/util/stringify");
+var _paintMetrics = require("../../../common/metrics/paint-metrics");
+var _submitData = require("../../../common/util/submit-data");
+var _config = require("../../../common/config/config");
+var _harvestScheduler = require("../../../common/harvest/harvest-scheduler");
+var _aggregateBase = require("../../utils/aggregate-base");
+var CONSTANTS = _interopRequireWildcard(require("../constants"));
+var _initializedFeatures = require("./initialized-features");
+var _globalScope = require("../../../common/util/global-scope");
+var _drain = require("../../../common/drain/drain");
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+const jsonp = 'NREUM.setToken';
+class Aggregate extends _aggregateBase.AggregateBase {
+  static featureName = CONSTANTS.FEATURE_NAME;
+  constructor(agentIdentifier, aggregator) {
+    super(agentIdentifier, aggregator, CONSTANTS.FEATURE_NAME);
+    if (typeof PerformanceNavigationTiming !== 'undefined' && !_iosVersion.isiOS) {
+      this.alreadySent = false; // we don't support timings on BFCache restores
+      const agentRuntime = (0, _config.getRuntime)(agentIdentifier); // we'll store timing values on the runtime obj to be read by the aggregate module
+
+      /* Time To First Byte
+        This listener must record these values *before* PVE's aggregate sends RUM. */
+      (0, _webVitals.onTTFB)(({
+        value,
+        entries
+      }) => {
+        if (this.alreadySent) return;
+        this.alreadySent = true;
+        agentRuntime[CONSTANTS.TTFB] = Math.round(value); // this is our "backend" duration; web-vitals will ensure it's lower bounded at 0
+
+        // Similar to what vitals does for ttfb, we have to factor in activation-start when calculating relative timings:
+        const navEntry = entries[0];
+        const respOrActivStart = Math.max(navEntry.responseStart, navEntry.activationStart || 0);
+        agentRuntime[CONSTANTS.FBTWL] = Math.max(Math.round(navEntry.loadEventEnd - respOrActivStart), 0); // our "frontend" duration
+        (0, _handle.handle)('timing', ['load', Math.round(navEntry.loadEventEnd)], undefined, _features.FEATURE_NAMES.pageViewTiming, this.ee);
+        agentRuntime[CONSTANTS.FBTDC] = Math.max(Math.round(navEntry.domContentLoadedEventEnd - respOrActivStart), 0); // our "dom processing" duration
+
+        this.sendRum();
+      });
+    } else {
+      this.sendRum(); // timings either already in runtime from instrument or is meant to get 0'd.
+    }
+  }
+
+  getScheme() {
+    return (0, _config.getConfigurationValue)(this.agentIdentifier, 'ssl') === false ? 'http' : 'https';
+  }
+  sendRum() {
+    const info = (0, _config.getInfo)(this.agentIdentifier);
+    if (!info.beacon) return;
+    if (info.queueTime) this.aggregator.store('measures', 'qt', {
+      value: info.queueTime
+    });
+    if (info.applicationTime) this.aggregator.store('measures', 'ap', {
+      value: info.applicationTime
+    });
+    const agentRuntime = (0, _config.getRuntime)(this.agentIdentifier);
+
+    // These 3 values should've been recorded after load and before this func runs. They are part of the minimum required for PageView events to be created.
+    // Following PR #428, which demands that all agents send RUM call, these need to be sent even outside of the main window context where PerformanceTiming
+    // or PerformanceNavigationTiming do not exists. Hence, they'll be filled in by 0s instead in, for example, worker threads that still init the PVE module.
+    this.aggregator.store('measures', 'be', {
+      value: _globalScope.isBrowserScope ? agentRuntime[CONSTANTS.TTFB] : 0
+    });
+    this.aggregator.store('measures', 'fe', {
+      value: _globalScope.isBrowserScope ? agentRuntime[CONSTANTS.FBTWL] : 0
+    });
+    this.aggregator.store('measures', 'dc', {
+      value: _globalScope.isBrowserScope ? agentRuntime[CONSTANTS.FBTDC] : 0
+    });
+    var measuresMetrics = this.aggregator.get('measures');
+    var measuresQueryString = (0, _mapOwn.mapOwn)(measuresMetrics, function (metricName, measure) {
+      return '&' + metricName + '=' + measure.params.value;
+    }).join('');
+
+    // currently we only have one version of our protocol
+    // in the future we may add more
+    var protocol = '1';
+    var scheduler = new _harvestScheduler.HarvestScheduler('page_view_event', {}, this);
+    var chunksForQueryString = [scheduler.harvest.baseQueryString()];
+    chunksForQueryString.push(measuresQueryString);
+    chunksForQueryString.push((0, _encode.param)('tt', info.ttGuid));
+    chunksForQueryString.push((0, _encode.param)('us', info.user));
+    chunksForQueryString.push((0, _encode.param)('ac', info.account));
+    chunksForQueryString.push((0, _encode.param)('pr', info.product));
+    chunksForQueryString.push((0, _encode.param)('af', (0, _initializedFeatures.getActivatedFeaturesFlags)(this.agentIdentifier).join(',')));
+    if (_globalScope.globalScope.performance && typeof _globalScope.globalScope.performance.timing !== 'undefined') {
+      var navTimingApiData = {
+        timing: (0, _navTiming.addPT)(agentRuntime.offset, _globalScope.globalScope.performance.timing, {}),
+        navigation: (0, _navTiming.addPN)(_globalScope.globalScope.performance.navigation, {})
+      };
+      chunksForQueryString.push((0, _encode.param)('perf', (0, _stringify.stringify)(navTimingApiData)));
+    }
+    try {
+      // PVTiming sends these too, albeit using web-vitals and slightly different; it's unknown why they're duplicated, but PVT should be the truth
+      var entries = _globalScope.globalScope.performance.getEntriesByType('paint');
+      entries.forEach(function (entry) {
+        if (!entry.startTime || entry.startTime <= 0) return;
+        if (entry.name === 'first-paint') {
+          chunksForQueryString.push((0, _encode.param)('fp', String(Math.floor(entry.startTime))));
+        } else if (entry.name === 'first-contentful-paint') {
+          chunksForQueryString.push((0, _encode.param)('fcp', String(Math.floor(entry.startTime))));
+        }
+        _paintMetrics.paintMetrics[entry.name] = Math.floor(entry.startTime); // this is consumed by Spa module
+      });
+    } catch (e) {}
+    chunksForQueryString.push((0, _encode.param)('xx', info.extra));
+    chunksForQueryString.push((0, _encode.param)('ua', info.userAttributes));
+    chunksForQueryString.push((0, _encode.param)('at', info.atts));
+    var customJsAttributes = (0, _stringify.stringify)(info.jsAttributes);
+    chunksForQueryString.push((0, _encode.param)('ja', customJsAttributes === '{}' ? null : customJsAttributes));
+    var queryString = (0, _encode.fromArray)(chunksForQueryString, agentRuntime.maxBytes);
+    const isValidJsonp = _submitData.submitData.jsonp(this.getScheme() + '://' + info.beacon + '/' + protocol + '/' + info.licenseKey + queryString, jsonp);
+    // Usually `drain` is invoked automatically after processing feature flags contained in the JSONP callback from
+    // ingest (see `activateFeatures`), so when JSONP cannot execute (as with module workers), we drain manually.
+    if (!isValidJsonp) (0, _drain.drain)(this.agentIdentifier, CONSTANTS.FEATURE_NAME);
+  }
+}
+exports.Aggregate = Aggregate;

package/dist/cjs/features/page_view_event/aggregate/initialized-features.js

@@ -0,0 +1,39 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getActivatedFeaturesFlags = getActivatedFeaturesFlags;
+var _features = require("../../../loaders/features/features");
+/**
+ * Get an array of flags required by downstream (NR UI) based on the features initialized in this agent
+ * (aka what is running on the page).
+ * @param {String} agentId - the ID of the initialized agent on the page, mapping to the one under the global 'newrelic' object
+ * @returns {String[]} Up to 5 short strings corresponding to ingest mapping of features.
+ */
+function getActivatedFeaturesFlags(agentId) {
+  const flagArr = [];
+  Object.keys(newrelic.initializedAgents[agentId].features).forEach(featName => {
+    switch (featName) {
+      case _features.FEATURE_NAMES.ajax:
+        flagArr.push('xhr');
+        break;
+      case _features.FEATURE_NAMES.jserrors:
+        flagArr.push('err');
+        break;
+      case _features.FEATURE_NAMES.pageAction:
+        flagArr.push('ins');
+        break;
+      case _features.FEATURE_NAMES.sessionTrace:
+        flagArr.push('stn');
+        break;
+      case _features.FEATURE_NAMES.spa:
+        flagArr.push('spa');
+        break;
+    }
+  });
+  return flagArr;
+}
+
+// Note: this module and the "af" param in src/features/page_view_event/aggregate/index.js can be removed in the future at such time
+// that it's no longer being used. For the browser agent, this is an unused flag system.

package/dist/cjs/features/page_view_event/constants.js

@@ -0,0 +1,15 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.TTFB = exports.FEATURE_NAME = exports.FBTWL = exports.FBTDC = void 0;
+var _features = require("../../loaders/features/features");
+const FEATURE_NAME = _features.FEATURE_NAMES.pageViewEvent;
+exports.FEATURE_NAME = FEATURE_NAME;
+const TTFB = 'firstbyte';
+exports.TTFB = TTFB;
+const FBTDC = 'domcontent';
+exports.FBTDC = FBTDC;
+const FBTWL = 'windowload';
+exports.FBTWL = FBTWL;

package/dist/cjs/features/page_view_event/index.js

@@ -0,0 +1,12 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "PageViewEvent", {
+  enumerable: true,
+  get: function () {
+    return _index.Instrument;
+  }
+});
+var _index = require("./instrument/index");

package/dist/cjs/features/page_view_event/instrument/index.js

@@ -0,0 +1,38 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Instrument = void 0;
+var _handle = require("../../../common/event-emitter/handle");
+var _iosVersion = require("../../../common/browser-version/ios-version");
+var _instrumentBase = require("../../utils/instrument-base");
+var CONSTANTS = _interopRequireWildcard(require("../constants"));
+var _features = require("../../../loaders/features/features");
+var _config = require("../../../common/config/config");
+var _load = require("../../../common/window/load");
+var _now = require("../../../common/timing/now");
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+class Instrument extends _instrumentBase.InstrumentBase {
+  static featureName = CONSTANTS.FEATURE_NAME;
+  constructor(agentIdentifier, aggregator, auto = true) {
+    super(agentIdentifier, aggregator, CONSTANTS.FEATURE_NAME, auto);
+    if ((typeof PerformanceNavigationTiming === 'undefined' || _iosVersion.isiOS) && typeof PerformanceTiming !== 'undefined') {
+      // For majority browser versions in which PNT exists, we can get load timings later from the nav entry (in the aggregate portion). At minimum, PT should exist for main window.
+      // *cli Mar'23 - iOS 15.2 & 15.4 testing in Sauce still fails with onTTFB. Hence, all iOS will fallback to this for now. Unknown if this is similar in nature to iOS_below16 bug.
+      const agentRuntime = (0, _config.getRuntime)(agentIdentifier);
+      agentRuntime[CONSTANTS.TTFB] = Math.max(Date.now() - agentRuntime.offset, 0);
+      (0, _load.onDOMContentLoaded)(() => agentRuntime[CONSTANTS.FBTDC] = Math.max((0, _now.now)() - agentRuntime[CONSTANTS.TTFB], 0));
+      (0, _load.onWindowLoad)(() => {
+        const timeNow = (0, _now.now)();
+        agentRuntime[CONSTANTS.FBTWL] = Math.max(timeNow - agentRuntime[CONSTANTS.TTFB], 0);
+        (0, _handle.handle)('timing', ['load', timeNow], undefined, _features.FEATURE_NAMES.pageViewTiming, this.ee);
+      });
+    }
+    // Else, inference: inside worker or some other env where these events are irrelevant. They'll get filled in with 0s in RUM call.
+
+    this.importAggregator();
+  }
+}
+exports.Instrument = Instrument;

package/dist/cjs/features/page_view_timing/aggregate/index.js

@@ -0,0 +1,265 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Aggregate = void 0;
+var _webVitals = require("web-vitals");
+var _firstPaint = require("../first-paint");
+var _longTasks = require("../long-tasks");
+var _iosVersion = require("../../../common/browser-version/ios-version");
+var _belSerializer = require("../../../common/serialize/bel-serializer");
+var _mapOwn = require("../../../common/util/map-own");
+var _harvestScheduler = require("../../../common/harvest/harvest-scheduler");
+var _registerHandler = require("../../../common/event-emitter/register-handler");
+var _cleanUrl = require("../../../common/url/clean-url");
+var _handle = require("../../../common/event-emitter/handle");
+var _config = require("../../../common/config/config");
+var _aggregateBase = require("../../utils/aggregate-base");
+var _constants = require("../constants");
+var _drain = require("../../../common/drain/drain");
+var _features = require("../../../loaders/features/features");
+/*
+ * Copyright 2020 New Relic Corporation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+class Aggregate extends _aggregateBase.AggregateBase {
+  static featureName = _constants.FEATURE_NAME;
+  constructor(agentIdentifier, aggregator) {
+    super(agentIdentifier, aggregator, _constants.FEATURE_NAME);
+    this.timings = [];
+    this.timingsSent = [];
+    this.curSessEndRecorded = false;
+    try {
+      // we (only) need to track cls state because it's attached to other timing events rather than reported on change...
+      this.clsSupported = PerformanceObserver.supportedEntryTypes.includes('layout-shift');
+      this.cls = 0;
+    } catch (e) {}
+
+    /*! This is the section that used to be in the loader portion: !*/
+    /* ------------------------------------------------------------ */
+    const pageStartedHidden = (0, _config.getRuntime)(agentIdentifier).initHidden; // our attempt at recapturing initial vis state since this code runs post-load time
+    this.alreadySent = new Set(); // since we don't support timings on BFCache restores, this tracks and helps cap metrics that web-vitals report more than once
+
+    /* PerformancePaintTiming API - BFC is not yet supported. */
+    (0, _firstPaint.onFirstPaint)(({
+      name,
+      value
+    }) => {
+      if (pageStartedHidden) return;
+      this.addTiming(name.toLowerCase(), Math.floor(value));
+    });
+
+    /* First Contentful Paint - As of WV v3, it still imperfectly tries to detect document vis state asap and isn't supposed to report if page starts hidden. */
+    if (_iosVersion.iOS_below16) {
+      try {
+        if (!pageStartedHidden) {
+          // see ios-version.js for detail on this following bug case; tldr: buffered flag doesn't work but getEntriesByType does
+          const paintEntries = performance.getEntriesByType('paint');
+          paintEntries.forEach(entry => {
+            if (entry.name === 'first-contentful-paint') {
+              this.addTiming('fcp', Math.floor(entry.startTime));
+            }
+          });
+        }
+      } catch (e) {}
+    } else {
+      (0, _webVitals.onFCP)(({
+        name,
+        value
+      }) => {
+        if (pageStartedHidden || this.alreadySent.has(name)) return;
+        this.alreadySent.add(name);
+        this.addTiming(name.toLowerCase(), value);
+      });
+    }
+
+    /* First Input Delay (+"First Interaction") - As of WV v3, it still imperfectly tries to detect document vis state asap and isn't supposed to report if page starts hidden. */
+    (0, _webVitals.onFID)(({
+      name,
+      value,
+      entries
+    }) => {
+      if (pageStartedHidden || this.alreadySent.has(name)) return;
+      this.alreadySent.add(name);
+
+      // CWV will only report one (THE) first-input entry to us; fid isn't reported if there are no user interactions occurs before the *first* page hiding.
+      const fiEntry = entries[0];
+      const attributes = {
+        type: fiEntry.name,
+        fid: Math.round(value)
+      };
+      this.addConnectionAttributes(attributes);
+      this.addTiming('fi', Math.round(fiEntry.startTime), attributes);
+    });
+
+    /* Largest Contentful Paint - As of WV v3, it still imperfectly tries to detect document vis state asap and isn't supposed to report if page starts hidden. */
+    (0, _webVitals.onLCP)(({
+      name,
+      value,
+      entries
+    }) => {
+      if (pageStartedHidden || this.alreadySent.has(name)) return;
+      this.alreadySent.add(name);
+
+      // CWV will only ever report one (THE) lcp entry to us; lcp is also only reported *once* on earlier(user interaction, page hidden).
+      const lcpEntry = entries[entries.length - 1]; // this looks weird if we only expect one, but this is how cwv-attribution gets it so to be sure...
+      const attrs = {
+        size: lcpEntry.size,
+        eid: lcpEntry.id
+      };
+      this.addConnectionAttributes(attrs);
+      if (lcpEntry.url) {
+        attrs['elUrl'] = (0, _cleanUrl.cleanURL)(lcpEntry.url);
+      }
+      if (lcpEntry.element && lcpEntry.element.tagName) {
+        attrs['elTag'] = lcpEntry.element.tagName;
+      }
+      this.addTiming(name.toLowerCase(), value, attrs);
+    });
+
+    /* Cumulative Layout Shift - We don't have to limit this callback since cls is stored as a state and only sent as attribute on other timings. */
+    (0, _webVitals.onCLS)(({
+      value
+    }) => this.cls = value);
+
+    /* Interaction-to-Next-Paint */
+    (0, _webVitals.onINP)(({
+      name,
+      value,
+      id
+    }) => this.addTiming(name.toLowerCase(), value, {
+      metricId: id
+    }));
+
+    /* PerformanceLongTaskTiming API */
+    if ((0, _config.getConfigurationValue)(this.agentIdentifier, 'page_view_timing.long_task') === true) {
+      (0, _longTasks.onLongTask)(({
+        name,
+        value,
+        info
+      }) => this.addTiming(name.toLowerCase(), value, info)); // lt context is passed as 'info'=attrs in the timing node
+    }
+    /* ------------------------------------End of ex-loader section */
+
+    /* It's important that CWV api, like "onLCP", is called before this scheduler is initialized. The reason is because they listen to the same
+      on vis change or pagehide events, and we'd want ex. onLCP to record the timing (win the race) before we try to send "final harvest". */
+    this.scheduler = new _harvestScheduler.HarvestScheduler('events', {
+      onFinished: (...args) => this.onHarvestFinished(...args),
+      getPayload: (...args) => this.prepareHarvest(...args)
+    }, this);
+    (0, _registerHandler.registerHandler)('timing', (name, value, attrs) => this.addTiming(name, value, attrs), this.featureName, this.ee); // notice CLS is added to all timings via 4th param
+    (0, _registerHandler.registerHandler)('docHidden', msTimestamp => this.endCurrentSession(msTimestamp), this.featureName, this.ee);
+    (0, _registerHandler.registerHandler)('winPagehide', msTimestamp => this.recordPageUnload(msTimestamp), this.featureName, this.ee);
+    const initialHarvestSeconds = (0, _config.getConfigurationValue)(this.agentIdentifier, 'page_view_timing.initialHarvestSeconds') || 10;
+    const harvestTimeSeconds = (0, _config.getConfigurationValue)(this.agentIdentifier, 'page_view_timing.harvestTimeSeconds') || 30;
+    // send initial data sooner, then start regular
+    this.ee.on(`drain-${this.featureName}`, () => {
+      this.scheduler.startTimer(harvestTimeSeconds, initialHarvestSeconds);
+    });
+    (0, _drain.drain)(this.agentIdentifier, this.featureName);
+  }
+
+  // takes an attributes object and appends connection attributes if available
+  addConnectionAttributes(attributes) {
+    var connection = navigator.connection || navigator.mozConnection || navigator.webkitConnection; // to date, both window & worker shares the same support for connection
+    if (!connection) return;
+    if (connection.type) attributes['net-type'] = connection.type;
+    if (connection.effectiveType) attributes['net-etype'] = connection.effectiveType;
+    if (connection.rtt) attributes['net-rtt'] = connection.rtt;
+    if (connection.downlink) attributes['net-dlink'] = connection.downlink;
+    return attributes;
+  }
+
+  /**
+   * Add the time of _document visibilitychange to hidden_ to the next PVT harvest == NRDB pageHide attr.
+   * @param {number} timestamp
+   */
+  endCurrentSession(timestamp) {
+    if (!this.curSessEndRecorded) {
+      // TO DO: stage 2 - we don't want to capture this timing twice on page navigating away, but it should run again if we return to page and away *again*
+      this.addTiming('pageHide', timestamp, null);
+      this.curSessEndRecorded = true;
+    }
+  }
+
+  /**
+   * Add the time of _window pagehide event_ firing to the next PVT harvest == NRDB windowUnload attr.
+   */
+  recordPageUnload(timestamp) {
+    this.addTiming('unload', timestamp, null);
+    // Because window's pageHide commonly fires before vis change and the final harvest occurs on the earlier of the two, we also have to add that now or it won't make it into the last payload out.
+    this.endCurrentSession(timestamp);
+  }
+  addTiming(name, value, attrs) {
+    attrs = attrs || {};
+
+    // If CLS is supported, a cls value should exist and be reported, even at 0.
+    // *cli Mar'23 - At this time, it remains attached to all timings. See NEWRELIC-6143.
+    if (this.clsSupported) {
+      attrs['cls'] = this.cls;
+    }
+    this.timings.push({
+      name: name,
+      value: value,
+      attrs: attrs
+    });
+    (0, _handle.handle)('pvtAdded', [name, value, attrs], undefined, _features.FEATURE_NAMES.sessionTrace, this.ee);
+  }
+  onHarvestFinished(result) {
+    if (result.retry && this.timingsSent.length > 0) {
+      for (var i = 0; i < this.timingsSent.length; i++) {
+        this.timings.push(this.timingsSent[i]);
+      }
+      this.timingsSent = [];
+    }
+  }
+  appendGlobalCustomAttributes(timing) {
+    var timingAttributes = timing.attrs || {};
+    var customAttributes = (0, _config.getInfo)(this.agentIdentifier).jsAttributes || {};
+    var reservedAttributes = ['size', 'eid', 'cls', 'type', 'fid', 'elTag', 'elUrl', 'net-type', 'net-etype', 'net-rtt', 'net-dlink'];
+    (0, _mapOwn.mapOwn)(customAttributes, function (key, val) {
+      if (reservedAttributes.indexOf(key) < 0) {
+        timingAttributes[key] = val;
+      }
+    });
+  }
+
+  // serialize and return current timing data, clear and save current data for retry
+  prepareHarvest(options) {
+    if (this.timings.length === 0) return;
+    var payload = this.getPayload(this.timings);
+    if (options.retry) {
+      for (var i = 0; i < this.timings.length; i++) {
+        this.timingsSent.push(this.timings[i]);
+      }
+    }
+    this.timings = [];
+    return {
+      body: {
+        e: payload
+      }
+    };
+  }
+
+  // serialize array of timing data
+  getPayload(data) {
+    var addString = (0, _belSerializer.getAddStringContext)(this.agentIdentifier);
+    var payload = 'bel.6;';
+    for (var i = 0; i < data.length; i++) {
+      var timing = data[i];
+      payload += 'e,';
+      payload += addString(timing.name) + ',';
+      payload += (0, _belSerializer.nullable)(timing.value, _belSerializer.numeric, false) + ',';
+      this.appendGlobalCustomAttributes(timing);
+      var attrParts = (0, _belSerializer.addCustomAttributes)(timing.attrs, addString);
+      if (attrParts && attrParts.length > 0) {
+        payload += (0, _belSerializer.numeric)(attrParts.length) + ';' + attrParts.join(';');
+      }
+      if (i + 1 < data.length) payload += ';';
+    }
+    return payload;
+  }
+}
+exports.Aggregate = Aggregate;

package/dist/cjs/features/page_view_timing/constants.js

@@ -0,0 +1,9 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.FEATURE_NAME = void 0;
+var _features = require("../../loaders/features/features");
+const FEATURE_NAME = _features.FEATURE_NAMES.pageViewTiming;
+exports.FEATURE_NAME = FEATURE_NAME;

package/dist/cjs/features/page_view_timing/first-paint.js

@@ -0,0 +1,50 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.onFirstPaint = void 0;
+/**
+ * Calls the `onReport` function when the 'first-paint' PerformancePaintTiming entry is observed.
+ * The argument supplied is an object similar to the Metric type used by web-vitals library.
+ *
+ * @param {Function} onReport - callback that accepts a `metric` object as the single parameter
+ */
+const onFirstPaint = onReport => {
+  const handleEntries = entries => {
+    entries.forEach(entry => {
+      if (entry.name === 'first-paint') {
+        observer.disconnect();
+
+        /* Initial hidden state and pre-rendering not yet considered for first paint. See web-vitals onFCP for example. */
+        const metric = {
+          name: 'FP',
+          value: entry.startTime
+        };
+        onReport(metric);
+      }
+    });
+  };
+  let observer;
+  try {
+    if (PerformanceObserver.supportedEntryTypes.includes('paint')) {
+      observer = new PerformanceObserver(list => {
+        // Delay by a microtask to workaround a bug in Safari where the
+        // callback is invoked immediately, rather than in a separate task.
+        // See: https://github.com/GoogleChrome/web-vitals/issues/277
+        Promise.resolve().then(() => {
+          handleEntries(list.getEntries());
+        });
+      });
+      observer.observe({
+        type: 'paint',
+        buffered: true
+      });
+    }
+  } catch (e) {
+    // Do nothing.
+  }
+
+  /* BFCache restore not yet considered for first paint. See web-vitals onFCP for example. */
+};
+exports.onFirstPaint = onFirstPaint;

package/dist/cjs/features/page_view_timing/index.js

@@ -0,0 +1,12 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "PageViewTiming", {
+  enumerable: true,
+  get: function () {
+    return _index.Instrument;
+  }
+});
+var _index = require("./instrument/index");

package/dist/cjs/features/page_view_timing/instrument/index.js

@@ -0,0 +1,36 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Instrument = void 0;
+var _handle = require("../../../common/event-emitter/handle");
+var _config = require("../../../common/config/config");
+var _pageVisibility = require("../../../common/window/page-visibility");
+var _eventListenerOpts = require("../../../common/event-listener/event-listener-opts");
+var _now = require("../../../common/timing/now");
+var _instrumentBase = require("../../utils/instrument-base");
+var _constants = require("../constants");
+var _globalScope = require("../../../common/util/global-scope");
+/*
+ * Copyright 2020 New Relic Corporation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+class Instrument extends _instrumentBase.InstrumentBase {
+  static featureName = _constants.FEATURE_NAME;
+  constructor(agentIdentifier, aggregator, auto = true) {
+    super(agentIdentifier, aggregator, _constants.FEATURE_NAME, auto);
+    if (!_globalScope.isBrowserScope) return; // CWV is irrelevant outside web context
+
+    // Document visibility state becomes hidden; this should run as soon as possible in page life.
+    // While we try to replicate web-vital's visibilitywatcher logic in an effort to defer that library to post-pageload, this isn't perfect and doesn't consider prerendering.
+    (0, _config.getRuntime)(agentIdentifier).initHidden = Boolean(document.visibilityState === 'hidden');
+    (0, _pageVisibility.subscribeToVisibilityChange)(() => (0, _handle.handle)('docHidden', [(0, _now.now)()], undefined, _constants.FEATURE_NAME, this.ee), true);
+
+    // Window fires its pagehide event (typically on navigation--this occurrence is a *subset* of vis change); don't defer this unless it's guarantee it cannot happen before load(?)
+    (0, _eventListenerOpts.windowAddEventListener)('pagehide', () => (0, _handle.handle)('winPagehide', [(0, _now.now)()], undefined, _constants.FEATURE_NAME, this.ee));
+    this.importAggregator();
+  }
+}
+exports.Instrument = Instrument;