@newrelic/browser-agent 1.291.1 → 1.292.0-rc.0

package/CHANGELOG.md

@@ -3,6 +3,19 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.292.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.291.1...v1.292.0) (2025-06-16)
+
+
+### Features
+
+* Add more inspection events ([#1494](https://github.com/newrelic/newrelic-browser-agent/issues/1494)) ([def89c4](https://github.com/newrelic/newrelic-browser-agent/commit/def89c4ab5850a3d8f8dc03b424a473bd5eb4bb5))
+* Update BrowserInteraction previousUrl definition ([#1499](https://github.com/newrelic/newrelic-browser-agent/issues/1499)) ([93f0fd0](https://github.com/newrelic/newrelic-browser-agent/commit/93f0fd0076e1e1fcc2b353d766a7a95c0f524e76))
+
+
+### Bug Fixes
+
+* Fix .finished API timeSinceLoad value ([#1503](https://github.com/newrelic/newrelic-browser-agent/issues/1503)) ([363a898](https://github.com/newrelic/newrelic-browser-agent/commit/363a898fce43c9c53a881f1d3b4a16ca7ced70f8))
+
 ## [1.291.1](https://github.com/newrelic/newrelic-browser-agent/compare/v1.291.0...v1.291.1) (2025-06-06)
 
 

package/dist/cjs/common/constants/env.cdn.js

@@ -17,7 +17,7 @@ exports.VERSION = exports.RRWEB_VERSION = exports.DIST_METHOD = exports.BUILD_EN
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.291.1";
+const VERSION = exports.VERSION = "1.292.0-rc.0";
 
 /**
  * Exposes the build type of the agent

package/dist/cjs/common/constants/env.npm.js

@@ -17,7 +17,7 @@ exports.VERSION = exports.RRWEB_VERSION = exports.DIST_METHOD = exports.BUILD_EN
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.291.1";
+const VERSION = exports.VERSION = "1.292.0-rc.0";
 
 /**
  * Exposes the build type of the agent

package/dist/cjs/common/drain/drain.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.deregisterDrain = deregisterDrain;
 exports.drain = drain;
 exports.registerDrain = registerDrain;
+var _globalEvent = require("../../common/dispatch/global-event");
 var _contextualEe = require("../event-emitter/contextual-ee");
 var _registerHandler = require("../event-emitter/register-handler");
 var _features = require("../../loaders/features/features");
@@ -100,6 +101,12 @@ function drainGroup(agentIdentifier, group, activateGroup = true) {
   const baseEE = agentIdentifier ? _contextualEe.ee.get(agentIdentifier) : _contextualEe.ee;
   const handlers = _registerHandler.registerHandler.handlers; // other storage in registerHandler
   if (baseEE.aborted || !baseEE.backlog || !handlers) return;
+  (0, _globalEvent.dispatchGlobalEvent)({
+    agentIdentifier,
+    type: 'lifecycle',
+    name: 'drain',
+    feature: group
+  });
 
   // Only activated features being drained should run queued listeners on buffered events. Deactivated features only need to release memory.
   if (activateGroup) {

package/dist/cjs/common/window/load.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.checkState = checkState;
 exports.onDOMContentLoaded = onDOMContentLoaded;
+exports.onPopstateChange = onPopstateChange;
 exports.onWindowLoad = onWindowLoad;
 var _eventListenerOpts = require("../event-listener/event-listener-opts");
 /**
@@ -22,4 +23,8 @@ function onWindowLoad(cb, useCapture) {
 function onDOMContentLoaded(cb) {
   if (checkState()) return cb();
   (0, _eventListenerOpts.documentAddEventListener)('DOMContentLoaded', cb);
+}
+function onPopstateChange(cb) {
+  if (checkState()) return cb();
+  (0, _eventListenerOpts.windowAddEventListener)('popstate', cb);
 }

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

@@ -8,6 +8,9 @@ var _handle = require("../../../common/event-emitter/handle");
 var _setPageViewName = require("../../../loaders/api/setPageViewName");
 var _instrumentBase = require("../../utils/instrument-base");
 var CONSTANTS = _interopRequireWildcard(require("../constants"));
+var _constants2 = require("../../../common/session/constants");
+var _globalEvent = require("../../../common/dispatch/global-event");
+var _load = require("../../../common/window/load");
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; } /**
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
@@ -18,6 +21,9 @@ class Instrument extends _instrumentBase.InstrumentBase {
   constructor(agentRef) {
     super(agentRef, CONSTANTS.FEATURE_NAME);
 
+    /** setup inspection events for window lifecycle */
+    this.setupInspectionEvents(agentRef.agentIdentifier);
+
     /** feature specific APIs */
     (0, _setPageViewName.setupSetPageViewNameAPI)(agentRef);
 
@@ -25,6 +31,36 @@ class Instrument extends _instrumentBase.InstrumentBase {
     this.ee.on('api-send-rum', (attrs, target) => (0, _handle.handle)('send-rum', [attrs, target], undefined, this.featureName, this.ee));
     this.importAggregator(agentRef, () => Promise.resolve().then(() => _interopRequireWildcard(require(/* webpackChunkName: "page_view_event-aggregate" */'../aggregate'))));
   }
+  setupInspectionEvents(agentIdentifier) {
+    const dispatch = (evt, name) => {
+      if (!evt) return;
+      (0, _globalEvent.dispatchGlobalEvent)({
+        agentIdentifier,
+        timeStamp: evt.timeStamp,
+        loaded: evt.target.readyState === 'complete',
+        type: 'window',
+        name,
+        data: evt.target.location + ''
+      });
+    };
+    (0, _load.onDOMContentLoaded)(evt => {
+      dispatch(evt, 'DOMContentLoaded');
+    });
+    (0, _load.onWindowLoad)(evt => {
+      dispatch(evt, 'load');
+    });
+    (0, _load.onPopstateChange)(evt => {
+      dispatch(evt, 'navigate');
+    });
+    this.ee.on(_constants2.SESSION_EVENTS.UPDATE, (_, data) => {
+      (0, _globalEvent.dispatchGlobalEvent)({
+        agentIdentifier,
+        type: 'lifecycle',
+        name: 'session',
+        data
+      });
+    });
+  }
 }
 exports.Instrument = Instrument;
 const PageViewEvent = exports.PageViewEvent = Instrument;

package/dist/cjs/features/soft_navigations/aggregate/initial-page-load-interaction.js

@@ -20,6 +20,7 @@ class InitialPageLoadInteraction extends _interaction.Interaction {
     super(agentRef, _constants.IPL_TRIGGER_NAME, 0, null);
     this.queueTime = agentRef.info.queueTime;
     this.appTime = agentRef.info.applicationTime;
+    this.oldURL = document.referrer;
   }
   get firstPaint() {
     return _firstPaint.firstPaint.current.value;

package/dist/cjs/features/spa/aggregate/interaction.js

@@ -33,7 +33,8 @@ function Interaction(eventName, timestamp, url, routeName, onFinished, agentRef)
   attrs.trigger = eventName;
   attrs.initialPageURL = _runtime.initialLocation;
   attrs.oldRoute = routeName;
-  attrs.newURL = attrs.oldURL = url;
+  attrs.newURL = url;
+  attrs.oldURL = eventName === 'initialPageLoad' ? document.referrer : url;
   attrs.custom = {};
   attrs.store = {};
 }

package/dist/cjs/loaders/api/finished.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.setupFinishedAPI = setupFinishedAPI;
 var _runtime = require("../../common/constants/runtime");
 var _handle = require("../../common/event-emitter/handle");
-var _now = require("../../common/timing/now");
+var _console = require("../../common/util/console");
 var _constants = require("../../features/metrics/constants");
 var _features = require("../features/features");
 var _constants2 = require("./constants");
@@ -17,15 +17,17 @@ var _sharedHandlers = require("./sharedHandlers");
  */
 
 function setupFinishedAPI(agent) {
-  (0, _sharedHandlers.setupAPI)(_constants2.FINISHED, function (time = (0, _now.now)()) {
+  (0, _sharedHandlers.setupAPI)(_constants2.FINISHED, function (unixTime = Date.now()) {
+    const relativeTime = unixTime - _runtime.originTime;
+    if (relativeTime < 0) (0, _console.warn)(62, unixTime);
     (0, _handle.handle)(_constants.CUSTOM_METRIC_CHANNEL, [_constants2.FINISHED, {
-      time
+      time: relativeTime
     }], undefined, _features.FEATURE_NAMES.metrics, agent.ee);
     agent.addToTrace({
       name: _constants2.FINISHED,
-      start: time + _runtime.originTime,
+      start: unixTime,
       origin: 'nr'
     });
-    (0, _handle.handle)(_constants2.prefix + _constants2.ADD_PAGE_ACTION, [time, _constants2.FINISHED], undefined, _features.FEATURE_NAMES.genericEvents, agent.ee);
+    (0, _handle.handle)(_constants2.prefix + _constants2.ADD_PAGE_ACTION, [relativeTime, _constants2.FINISHED], undefined, _features.FEATURE_NAMES.genericEvents, agent.ee);
   }, agent);
 }

package/dist/cjs/loaders/api-base.js

@@ -149,7 +149,7 @@ class ApiBase {
   /**
    * Records an additional time point as "finished" in a session trace and adds a page action.
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/finished/}
-   * @param {number} [timeStamp] Defaults to the current time of the call. If used, this marks the time that the page is "finished" according to your own criteria.
+   * @param {number} [timeStamp] integer (UNIX time) - Defaults to the current time of the call. If used, this marks the time that the page is "finished" according to your own criteria.
    */
   finished(timeStamp) {
     return this.#callMethod(_constants.FINISHED, timeStamp);

package/dist/esm/common/constants/env.cdn.js

@@ -11,7 +11,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.291.1";
+export const VERSION = "1.292.0-rc.0";
 
 /**
  * Exposes the build type of the agent

package/dist/esm/common/constants/env.npm.js

@@ -11,7 +11,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.291.1";
+export const VERSION = "1.292.0-rc.0";
 
 /**
  * Exposes the build type of the agent

package/dist/esm/common/drain/drain.js

@@ -3,6 +3,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+import { dispatchGlobalEvent } from '../../common/dispatch/global-event';
 import { ee } from '../event-emitter/contextual-ee';
 import { registerHandler as defaultRegister } from '../event-emitter/register-handler';
 import { featurePriority } from '../../loaders/features/features';
@@ -92,6 +93,12 @@ function drainGroup(agentIdentifier, group, activateGroup = true) {
   const baseEE = agentIdentifier ? ee.get(agentIdentifier) : ee;
   const handlers = defaultRegister.handlers; // other storage in registerHandler
   if (baseEE.aborted || !baseEE.backlog || !handlers) return;
+  dispatchGlobalEvent({
+    agentIdentifier,
+    type: 'lifecycle',
+    name: 'drain',
+    feature: group
+  });
 
   // Only activated features being drained should run queued listeners on buffered events. Deactivated features only need to release memory.
   if (activateGroup) {

package/dist/esm/common/window/load.js

@@ -13,4 +13,8 @@ export function onWindowLoad(cb, useCapture) {
 export function onDOMContentLoaded(cb) {
   if (checkState()) return cb();
   documentAddEventListener('DOMContentLoaded', cb);
+}
+export function onPopstateChange(cb) {
+  if (checkState()) return cb();
+  windowAddEventListener('popstate', cb);
 }

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

@@ -6,11 +6,17 @@ import { handle } from '../../../common/event-emitter/handle';
 import { setupSetPageViewNameAPI } from '../../../loaders/api/setPageViewName';
 import { InstrumentBase } from '../../utils/instrument-base';
 import * as CONSTANTS from '../constants';
+import { SESSION_EVENTS } from '../../../common/session/constants';
+import { dispatchGlobalEvent } from '../../../common/dispatch/global-event';
+import { onDOMContentLoaded, onPopstateChange, onWindowLoad } from '../../../common/window/load';
 export class Instrument extends InstrumentBase {
   static featureName = CONSTANTS.FEATURE_NAME;
   constructor(agentRef) {
     super(agentRef, CONSTANTS.FEATURE_NAME);
 
+    /** setup inspection events for window lifecycle */
+    this.setupInspectionEvents(agentRef.agentIdentifier);
+
     /** feature specific APIs */
     setupSetPageViewNameAPI(agentRef);
 
@@ -18,5 +24,35 @@ export class Instrument extends InstrumentBase {
     this.ee.on('api-send-rum', (attrs, target) => handle('send-rum', [attrs, target], undefined, this.featureName, this.ee));
     this.importAggregator(agentRef, () => import(/* webpackChunkName: "page_view_event-aggregate" */'../aggregate'));
   }
+  setupInspectionEvents(agentIdentifier) {
+    const dispatch = (evt, name) => {
+      if (!evt) return;
+      dispatchGlobalEvent({
+        agentIdentifier,
+        timeStamp: evt.timeStamp,
+        loaded: evt.target.readyState === 'complete',
+        type: 'window',
+        name,
+        data: evt.target.location + ''
+      });
+    };
+    onDOMContentLoaded(evt => {
+      dispatch(evt, 'DOMContentLoaded');
+    });
+    onWindowLoad(evt => {
+      dispatch(evt, 'load');
+    });
+    onPopstateChange(evt => {
+      dispatch(evt, 'navigate');
+    });
+    this.ee.on(SESSION_EVENTS.UPDATE, (_, data) => {
+      dispatchGlobalEvent({
+        agentIdentifier,
+        type: 'lifecycle',
+        name: 'session',
+        data
+      });
+    });
+  }
 }
 export const PageViewEvent = Instrument;

package/dist/esm/features/soft_navigations/aggregate/initial-page-load-interaction.js

@@ -13,6 +13,7 @@ export class InitialPageLoadInteraction extends Interaction {
     super(agentRef, IPL_TRIGGER_NAME, 0, null);
     this.queueTime = agentRef.info.queueTime;
     this.appTime = agentRef.info.applicationTime;
+    this.oldURL = document.referrer;
   }
   get firstPaint() {
     return firstPaint.current.value;

package/dist/esm/features/spa/aggregate/interaction.js

@@ -26,7 +26,8 @@ export function Interaction(eventName, timestamp, url, routeName, onFinished, ag
   attrs.trigger = eventName;
   attrs.initialPageURL = initialLocation;
   attrs.oldRoute = routeName;
-  attrs.newURL = attrs.oldURL = url;
+  attrs.newURL = url;
+  attrs.oldURL = eventName === 'initialPageLoad' ? document.referrer : url;
   attrs.custom = {};
   attrs.store = {};
 }

package/dist/esm/loaders/api/finished.js

@@ -4,21 +4,23 @@
  */
 import { originTime } from '../../common/constants/runtime';
 import { handle } from '../../common/event-emitter/handle';
-import { now } from '../../common/timing/now';
+import { warn } from '../../common/util/console';
 import { CUSTOM_METRIC_CHANNEL } from '../../features/metrics/constants';
 import { FEATURE_NAMES } from '../features/features';
 import { ADD_PAGE_ACTION, FINISHED, prefix } from './constants';
 import { setupAPI } from './sharedHandlers';
 export function setupFinishedAPI(agent) {
-  setupAPI(FINISHED, function (time = now()) {
+  setupAPI(FINISHED, function (unixTime = Date.now()) {
+    const relativeTime = unixTime - originTime;
+    if (relativeTime < 0) warn(62, unixTime);
     handle(CUSTOM_METRIC_CHANNEL, [FINISHED, {
-      time
+      time: relativeTime
     }], undefined, FEATURE_NAMES.metrics, agent.ee);
     agent.addToTrace({
       name: FINISHED,
-      start: time + originTime,
+      start: unixTime,
       origin: 'nr'
     });
-    handle(prefix + ADD_PAGE_ACTION, [time, FINISHED], undefined, FEATURE_NAMES.genericEvents, agent.ee);
+    handle(prefix + ADD_PAGE_ACTION, [relativeTime, FINISHED], undefined, FEATURE_NAMES.genericEvents, agent.ee);
   }, agent);
 }

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

@@ -143,7 +143,7 @@ export class ApiBase {
   /**
    * Records an additional time point as "finished" in a session trace and adds a page action.
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/finished/}
-   * @param {number} [timeStamp] Defaults to the current time of the call. If used, this marks the time that the page is "finished" according to your own criteria.
+   * @param {number} [timeStamp] integer (UNIX time) - Defaults to the current time of the call. If used, this marks the time that the page is "finished" according to your own criteria.
    */
   finished(timeStamp) {
     return this.#callMethod(FINISHED, timeStamp);

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

@@ -1 +1 @@
-{"version":3,"file":"drain.d.ts","sourceRoot":"","sources":["../../../../src/common/drain/drain.js"],"names":[],"mappings":"AAYA;;;;;;;GAOG;AACH,+CAHW,MAAM,SACN,MAAM,QAQhB;AAED;;;;GAIG;AACH,iDAHW,GAAC,SACD,GAAC,QAOX;AAYD;;;;;;GAMG;AACH,wCAJW,MAAM,gBACN,MAAM,UACN,OAAO,QAajB"}
+{"version":3,"file":"drain.d.ts","sourceRoot":"","sources":["../../../../src/common/drain/drain.js"],"names":[],"mappings":"AAaA;;;;;;;GAOG;AACH,+CAHW,MAAM,SACN,MAAM,QAQhB;AAED;;;;GAIG;AACH,iDAHW,GAAC,SACD,GAAC,QAOX;AAYD;;;;;;GAMG;AACH,wCAJW,MAAM,gBACN,MAAM,UACN,OAAO,QAajB"}

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

@@ -1,4 +1,5 @@
 export function checkState(): boolean;
 export function onWindowLoad(cb: any, useCapture: any): any;
 export function onDOMContentLoaded(cb: any): any;
+export function onPopstateChange(cb: any): any;
 //# sourceMappingURL=load.d.ts.map

package/dist/types/common/window/load.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../../../src/common/window/load.js"],"names":[],"mappings":"AAMA,sCAEC;AAED,4DAGC;AAED,iDAGC"}
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../../../src/common/window/load.js"],"names":[],"mappings":"AAMA,sCAEC;AAED,4DAGC;AAED,iDAGC;AAED,+CAGC"}

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

@@ -1,6 +1,7 @@
 export class Instrument extends InstrumentBase {
     static featureName: string;
     constructor(agentRef: any);
+    setupInspectionEvents(agentIdentifier: any): void;
 }
 export const PageViewEvent: typeof Instrument;
 import { InstrumentBase } from '../../utils/instrument-base';

package/dist/types/features/page_view_event/instrument/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/page_view_event/instrument/index.js"],"names":[],"mappings":"AASA;IACE,2BAA2C;IAC3C,2BAUC;CACF;AAED,8CAAuC;+BAlBR,6BAA6B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/page_view_event/instrument/index.js"],"names":[],"mappings":"AAYA;IACE,2BAA2C;IAC3C,2BAaC;IAED,kDAiCC;CACF;AAED,8CAAuC;+BA3DR,6BAA6B"}

package/dist/types/features/soft_navigations/aggregate/initial-page-load-interaction.d.ts

@@ -1,5 +1,6 @@
 export class InitialPageLoadInteraction extends Interaction {
     constructor(agentRef: any);
+    oldURL: string;
     get firstPaint(): any;
     get firstContentfulPaint(): any;
     /**

package/dist/types/features/soft_navigations/aggregate/initial-page-load-interaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initial-page-load-interaction.d.ts","sourceRoot":"","sources":["../../../../../src/features/soft_navigations/aggregate/initial-page-load-interaction.js"],"names":[],"mappings":"AAWA;IACE,2BAIC;IAED,sBAAqD;IACrD,gCAAyE;IAEzE;;;OAGG;IACH,oCA6BC;CACF;4BAlD2B,eAAe"}
+{"version":3,"file":"initial-page-load-interaction.d.ts","sourceRoot":"","sources":["../../../../../src/features/soft_navigations/aggregate/initial-page-load-interaction.js"],"names":[],"mappings":"AAWA;IACE,2BAKC;IADC,eAA+B;IAGjC,sBAAqD;IACrD,gCAAyE;IAEzE;;;OAGG;IACH,oCA6BC;CACF;4BAnD2B,eAAe"}

package/dist/types/features/spa/aggregate/interaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../../../../../src/features/spa/aggregate/interaction.js"],"names":[],"mappings":"AAaA,4HAwBC;;IAxBD,sGAwBC;IAvBC,cAAwB;IAGxB,WAA4C;IAC5C,eAA0B;IAC1B,cAAc;IACd,kBAAkB;IAClB,iBAAuB;IACvB,wBAA2B;IAC3B,YAAyC;IAA3B,gBAA2B;IACzC,gBAAkB;IAClB,gBAA4B;IAC5B,cAAiB;IAEN,sBAAqE;;gCAtBlD,oBAAoB"}
+{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../../../../../src/features/spa/aggregate/interaction.js"],"names":[],"mappings":"AAaA,4HAyBC;;IAzBD,sGAyBC;IAxBC,cAAwB;IAGxB,WAA4C;IAC5C,eAA0B;IAC1B,cAAc;IACd,kBAAkB;IAClB,iBAAuB;IACvB,wBAA2B;IAC3B,YAAyC;IAA3B,gBAA2B;IACzC,gBAAkB;IAClB,gBAA4B;IAC5B,cAAiB;IAEN,sBAAqE;;gCAtBlD,oBAAoB"}

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

@@ -1 +1 @@
-{"version":3,"file":"finished.d.ts","sourceRoot":"","sources":["../../../../src/loaders/api/finished.js"],"names":[],"mappings":"AAYA,mDAMC"}
+{"version":3,"file":"finished.d.ts","sourceRoot":"","sources":["../../../../src/loaders/api/finished.js"],"names":[],"mappings":"AAYA,mDAQC"}

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

@@ -103,7 +103,7 @@ export class ApiBase {
     /**
      * Records an additional time point as "finished" in a session trace and adds a page action.
      * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/finished/}
-     * @param {number} [timeStamp] Defaults to the current time of the call. If used, this marks the time that the page is "finished" according to your own criteria.
+     * @param {number} [timeStamp] integer (UNIX time) - Defaults to the current time of the call. If used, this marks the time that the page is "finished" according to your own criteria.
      */
     finished(timeStamp?: number): any;
     /**

package/package.json

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

package/src/common/drain/drain.js

@@ -3,6 +3,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+import { dispatchGlobalEvent } from '../../common/dispatch/global-event'
 import { ee } from '../event-emitter/contextual-ee'
 import { registerHandler as defaultRegister } from '../event-emitter/register-handler'
 import { featurePriority } from '../../loaders/features/features'
@@ -92,6 +93,13 @@ function drainGroup (agentIdentifier, group, activateGroup = true) {
   const handlers = defaultRegister.handlers // other storage in registerHandler
   if (baseEE.aborted || !baseEE.backlog || !handlers) return
 
+  dispatchGlobalEvent({
+    agentIdentifier,
+    type: 'lifecycle',
+    name: 'drain',
+    feature: group
+  })
+
   // Only activated features being drained should run queued listeners on buffered events. Deactivated features only need to release memory.
   if (activateGroup) {
     const bufferedEventsInGroup = baseEE.backlog[group]

package/src/common/window/load.js

@@ -17,3 +17,8 @@ export function onDOMContentLoaded (cb) {
   if (checkState()) return cb()
   documentAddEventListener('DOMContentLoaded', cb)
 }
+
+export function onPopstateChange (cb) {
+  if (checkState()) return cb()
+  windowAddEventListener('popstate', cb)
+}

package/src/features/page_view_event/instrument/index.js

@@ -6,12 +6,18 @@ import { handle } from '../../../common/event-emitter/handle'
 import { setupSetPageViewNameAPI } from '../../../loaders/api/setPageViewName'
 import { InstrumentBase } from '../../utils/instrument-base'
 import * as CONSTANTS from '../constants'
+import { SESSION_EVENTS } from '../../../common/session/constants'
+import { dispatchGlobalEvent } from '../../../common/dispatch/global-event'
+import { onDOMContentLoaded, onPopstateChange, onWindowLoad } from '../../../common/window/load'
 
 export class Instrument extends InstrumentBase {
   static featureName = CONSTANTS.FEATURE_NAME
   constructor (agentRef) {
     super(agentRef, CONSTANTS.FEATURE_NAME)
 
+    /** setup inspection events for window lifecycle */
+    this.setupInspectionEvents(agentRef.agentIdentifier)
+
     /** feature specific APIs */
     setupSetPageViewNameAPI(agentRef)
 
@@ -20,6 +26,41 @@ export class Instrument extends InstrumentBase {
 
     this.importAggregator(agentRef, () => import(/* webpackChunkName: "page_view_event-aggregate" */ '../aggregate'))
   }
+
+  setupInspectionEvents (agentIdentifier) {
+    const dispatch = (evt, name) => {
+      if (!evt) return
+      dispatchGlobalEvent({
+        agentIdentifier,
+        timeStamp: evt.timeStamp,
+        loaded: evt.target.readyState === 'complete',
+        type: 'window',
+        name,
+        data: evt.target.location + ''
+      })
+    }
+
+    onDOMContentLoaded((evt) => {
+      dispatch(evt, 'DOMContentLoaded')
+    })
+
+    onWindowLoad((evt) => {
+      dispatch(evt, 'load')
+    })
+
+    onPopstateChange((evt) => {
+      dispatch(evt, 'navigate')
+    })
+
+    this.ee.on(SESSION_EVENTS.UPDATE, (_, data) => {
+      dispatchGlobalEvent({
+        agentIdentifier,
+        type: 'lifecycle',
+        name: 'session',
+        data
+      })
+    })
+  }
 }
 
 export const PageViewEvent = Instrument

package/src/features/soft_navigations/aggregate/initial-page-load-interaction.js

@@ -14,6 +14,7 @@ export class InitialPageLoadInteraction extends Interaction {
     super(agentRef, IPL_TRIGGER_NAME, 0, null)
     this.queueTime = agentRef.info.queueTime
     this.appTime = agentRef.info.applicationTime
+    this.oldURL = document.referrer
   }
 
   get firstPaint () { return firstPaint.current.value }

package/src/features/spa/aggregate/interaction.js

@@ -32,7 +32,8 @@ export function Interaction (eventName, timestamp, url, routeName, onFinished, a
   attrs.trigger = eventName
   attrs.initialPageURL = initialLocation
   attrs.oldRoute = routeName
-  attrs.newURL = attrs.oldURL = url
+  attrs.newURL = url
+  attrs.oldURL = eventName === 'initialPageLoad' ? document.referrer : url
   attrs.custom = {}
   attrs.store = {}
 }

package/src/loaders/api/finished.js

@@ -4,16 +4,18 @@
  */
 import { originTime } from '../../common/constants/runtime'
 import { handle } from '../../common/event-emitter/handle'
-import { now } from '../../common/timing/now'
+import { warn } from '../../common/util/console'
 import { CUSTOM_METRIC_CHANNEL } from '../../features/metrics/constants'
 import { FEATURE_NAMES } from '../features/features'
 import { ADD_PAGE_ACTION, FINISHED, prefix } from './constants'
 import { setupAPI } from './sharedHandlers'
 
 export function setupFinishedAPI (agent) {
-  setupAPI(FINISHED, function (time = now()) {
-    handle(CUSTOM_METRIC_CHANNEL, [FINISHED, { time }], undefined, FEATURE_NAMES.metrics, agent.ee)
-    agent.addToTrace({ name: FINISHED, start: time + originTime, origin: 'nr' })
-    handle(prefix + ADD_PAGE_ACTION, [time, FINISHED], undefined, FEATURE_NAMES.genericEvents, agent.ee)
+  setupAPI(FINISHED, function (unixTime = Date.now()) {
+    const relativeTime = unixTime - originTime
+    if (relativeTime < 0) warn(62, unixTime)
+    handle(CUSTOM_METRIC_CHANNEL, [FINISHED, { time: relativeTime }], undefined, FEATURE_NAMES.metrics, agent.ee)
+    agent.addToTrace({ name: FINISHED, start: unixTime, origin: 'nr' })
+    handle(prefix + ADD_PAGE_ACTION, [relativeTime, FINISHED], undefined, FEATURE_NAMES.genericEvents, agent.ee)
   }, agent)
 }

package/src/loaders/api-base.js

@@ -144,7 +144,7 @@ export class ApiBase {
   /**
    * Records an additional time point as "finished" in a session trace and adds a page action.
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/finished/}
-   * @param {number} [timeStamp] Defaults to the current time of the call. If used, this marks the time that the page is "finished" according to your own criteria.
+   * @param {number} [timeStamp] integer (UNIX time) - Defaults to the current time of the call. If used, this marks the time that the page is "finished" according to your own criteria.
    */
   finished (timeStamp) {
     return this.#callMethod(FINISHED, timeStamp)