@newrelic/browser-agent 0.1.230 → 1.232.0

package/README.md

@@ -1,14 +1,14 @@
-[![Community Plus header](https://github.com/newrelic/opensource-website/raw/main/src/images/categories/Community_Plus.png)](https://opensource.newrelic.com/oss-category/#community-plus)
+<a href="https://opensource.newrelic.com/oss-category/#community-plus"><picture><source media="(prefers-color-scheme: dark)" srcset="https://github.com/newrelic/opensource-website/raw/main/src/images/categories/dark/Community_Plus.png"><source media="(prefers-color-scheme: light)" srcset="https://github.com/newrelic/opensource-website/raw/main/src/images/categories/Community_Plus.png"><img alt="New Relic Open Source community plus project banner." src="https://github.com/newrelic/opensource-website/raw/main/src/images/categories/Community_Plus.png"></picture></a>
 
 # New Relic Browser Agent
 
 The New Relic browser agent instruments your web application or site and provides observability into performance, errors, and other behaviors.
 
-- The instructions on this page pertain to installing the browser agent as an NPM package (currently in pre-release).
+- The instructions on this page pertain to installing the browser agent as an NPM package.
 
 - The browser agent is also generally available as a copy-paste JavaScript snippet and via auto-injection by backend apps. See *[Install the browser agent](https://docs.newrelic.com/docs/browser/browser-monitoring/installation/install-browser-monitoring-agent/)* for info on these alternatives.
 
-- For questions and feedback on this pre-release package, please visit the [Explorer's Hub](https://forum.newrelic.com/s/), New Relic's community support forum.
+- For questions and feedback on this package, please visit the [Explorer's Hub](https://forum.newrelic.com/s/), New Relic's community support forum.
 
 - Looking to contribute to the browser agent code base? See [DEVELOPING.md](DEVELOPING.md) for instructions on building and testing the browser agent library, and [CONTRIBUTING.md](CONTRIBUTING.md) for general guidance.
 
@@ -170,6 +170,30 @@ import { Agent } from '@newrelic/browser-agent/loaders/agent'
 import { Metrics } from '@newrelic/browser-agent/src/features/metrics'
 ```
 
+## Support
+
+New Relic hosts and moderates an online forum where customers can interact with New Relic employees as well as other customers to get help and share best practices. Like all official New Relic open source projects, there's a related Community topic in the New Relic Explorers Hub. You can find this project's topic/threads here:
+
+https://discuss.newrelic.com/c/full-stack-observability/browser
+
+## Contribute
+
+We encourage your contributions to improve the Browser agent! Keep in mind that when you submit your pull request, you'll need to sign the CLA via the click-through using CLA-Assistant. You only have to sign the CLA one time per project.
+
+If you have any questions, or to execute our corporate CLA (which is required if your contribution is on behalf of a company), drop us an email at opensource@newrelic.com.
+
+For more details on how best to contribute, see [CONTRIBUTING.md](CONTRIBUTING.md)
+
+**A note about vulnerabilities**
+
+As noted in our [security policy](https://github.com/newrelic/newrelic-browser-agent/security/policy), New Relic is committed to the privacy and security of our customers and their data. We believe that providing coordinated disclosure by security researchers and engaging with the security community are important means to achieve our security goals.
+
+If you believe you have found a security vulnerability in this project or any of New Relic's products or websites, we welcome and greatly appreciate you reporting it to New Relic through [HackerOne](https://hackerone.com/newrelic).
+
+If you would like to contribute to this project, review [these guidelines](./CONTRIBUTING.md).
+
+To all contributors, we thank you! Without your contribution, this project would not be what it is today. We also host [a community project page dedicated to the Browser agent](https://opensource.newrelic.com/projects/newrelic/newrelic-browser-agent).
+
 ## License
 
 The Browser agent is licensed under the [Apache 2.0](http://apache.org/licenses/LICENSE-2.0.txt) License.

package/dist/cjs/common/browser-version/ios-version.js

@@ -11,8 +11,9 @@ const isiOS = /(iPad|iPhone|iPod)/g.test(navigator.userAgent);
 // Shared Web Workers introduced in iOS 16.0+ and n/a in 15.6-
 exports.isiOS = isiOS;
 const iOS_below16 = isiOS && Boolean(typeof SharedWorker === 'undefined');
-/* ^ It was discovered in Safari 14 (https://bugs.webkit.org/show_bug.cgi?id=225305) that the buffered flag in PerformanceObserver
-	did not work. This affects our onFCP metric in particular since web-vitals uses that flag to retrieve paint timing entries.
-	This was fixed in v16+.
+/*
+  ^ It was discovered in Safari 14 (https://bugs.webkit.org/show_bug.cgi?id=225305) that the buffered flag in PerformanceObserver
+  did not work. This affects our onFCP metric in particular since web-vitals uses that flag to retrieve paint timing entries.
+  This was fixed in v16+.
 */
 exports.iOS_below16 = iOS_below16;

package/dist/cjs/common/config/state/configurable.js

@@ -8,26 +8,32 @@ var _featureDependencies = require("../../../loaders/features/featureDependencie
 var _console = require("../../util/console");
 class Configurable {
   constructor(obj, model) {
-    try {
-      if (!obj || typeof obj !== 'object') return (0, _console.warn)('New setting a Configurable requires an object as input');
-      if (!model || typeof model !== 'object') return (0, _console.warn)('Setting a Configurable requires a model to set its initial properties');
-      Object.assign(this, model);
-      Object.entries(obj).forEach(_ref => {
-        let [key, value] = _ref;
-        const frozenAttrs = (0, _featureDependencies.getFrozenAttributes)(key);
-        if (frozenAttrs.length && value && typeof value === 'object') {
-          frozenAttrs.forEach(attr => {
-            if (attr in value) {
-              (0, _console.warn)(`"${attr}" is a protected attribute and can not be changed in feature ${key}.  It will have no effect.`);
-              delete value[attr];
-            }
-          });
-        }
-        this[key] = value;
-      });
-    } catch (err) {
-      (0, _console.warn)('An error occured while setting a Configurable', err);
-    }
+    Object.assign(this, setValues(obj, model));
   }
 }
-exports.Configurable = Configurable;
+exports.Configurable = Configurable;
+function setValues(obj, model) {
+  const state = {};
+  try {
+    if (!obj || typeof obj !== 'object') return (0, _console.warn)('New setting a Configurable requires an object as input');
+    if (!model || typeof model !== 'object') return (0, _console.warn)('Setting a Configurable requires a model to set its initial properties');
+    Object.assign(state, model);
+    Object.entries(obj).forEach(_ref => {
+      let [key, value] = _ref;
+      if (!Object.keys(model).includes(key)) return;
+      const frozenAttrs = (0, _featureDependencies.getFrozenAttributes)(key);
+      if (frozenAttrs.length && value && typeof value === 'object') {
+        frozenAttrs.forEach(attr => {
+          if (attr in value) {
+            (0, _console.warn)("\"".concat(attr, "\" is a protected attribute and can not be changed in feature ").concat(key, ".  It will have no effect."));
+            delete value[attr];
+          }
+        });
+      }
+      state[key] = value;
+    });
+    return state;
+  } catch (err) {
+    (0, _console.warn)('An error occured while setting a Configurable', err);
+  }
+}

package/dist/cjs/common/config/state/info.js

@@ -40,7 +40,7 @@ function isValid(id) {
 }
 function getInfo(id) {
   if (!id) throw new Error('All info objects require an agent identifier!');
-  if (!_cache[id]) throw new Error(`Info for ${id} was never set`);
+  if (!_cache[id]) throw new Error("Info for ".concat(id, " was never set"));
   return _cache[id];
 }
 function setInfo(id, obj) {

package/dist/cjs/common/config/state/init.js

@@ -6,6 +6,8 @@ Object.defineProperty(exports, "__esModule", {
 exports.getConfiguration = getConfiguration;
 exports.getConfigurationValue = getConfigurationValue;
 exports.setConfiguration = setConfiguration;
+var _constants = require("../../session/constants");
+var _globalScope = require("../../util/global-scope");
 var _nreum = require("../../window/nreum");
 var _configurable = require("./configurable");
 const model = {
@@ -27,6 +29,12 @@ const model = {
     cors_use_tracecontext_headers: undefined,
     allowed_origins: undefined
   },
+  session: {
+    domain: undefined,
+    // used by first party cookies to set the top-level domain
+    expiresMs: _constants.DEFAULT_EXPIRES_MS,
+    inactiveMs: _constants.DEFAULT_INACTIVE_MS
+  },
   ssl: undefined,
   obfuscate: undefined,
   jserrors: {
@@ -60,7 +68,7 @@ const model = {
 const _cache = {};
 function getConfiguration(id) {
   if (!id) throw new Error('All configuration objects require an agent identifier!');
-  if (!_cache[id]) throw new Error(`Configuration for ${id} was never set`);
+  if (!_cache[id]) throw new Error("Configuration for ".concat(id, " was never set"));
   return _cache[id];
 }
 function setConfiguration(id, obj) {

package/dist/cjs/common/config/state/loader-config.js

@@ -18,7 +18,7 @@ const model = {
 const _cache = {};
 function getLoaderConfig(id) {
   if (!id) throw new Error('All loader-config objects require an agent identifier!');
-  if (!_cache[id]) throw new Error(`LoaderConfig for ${id} was never set`);
+  if (!_cache[id]) throw new Error("LoaderConfig for ".concat(id, " was never set"));
   return _cache[id];
 }
 function setLoaderConfig(id, obj) {

package/dist/cjs/common/config/state/runtime.js

@@ -8,44 +8,42 @@ exports.setRuntime = setRuntime;
 var userAgent = _interopRequireWildcard(require("../../util/user-agent"));
 var _configurable = require("./configurable");
 var _nreum = require("../../window/nreum");
-var _sessionStorage = require("../../window/session-storage");
-var _config = require("../config");
 var _globalScope = require("../../util/global-scope");
-var _environmentVariables = require("../../constants/environment-variables");
+var _env = require("../../constants/env.npm");
 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 model = agentId => {
-  return {
-    buildEnv: _environmentVariables.BUILD_ENV,
-    bytesSent: {},
-    customTransaction: undefined,
-    disabled: false,
-    distMethod: _environmentVariables.DIST_METHOD,
-    isolatedBacklog: false,
-    loaderType: undefined,
-    maxBytes: 30000,
-    // The "timeOrigin" property is the new standard timestamp property shared across main frame and workers, but is not supported in some early Safari browsers (safari<15) + IE
-    // ingest expects an integer value, and timeOrigin can return a float.
-    offset: Math.floor(_globalScope.globalScope?.performance?.timeOrigin || _globalScope.globalScope?.performance?.timing?.navigationStart || Date.now()),
-    onerror: undefined,
-    origin: '' + _globalScope.globalScope.location,
-    ptid: undefined,
-    releaseIds: {},
-    sessionId: (0, _config.getConfigurationValue)(agentId, 'privacy.cookies_enabled') == true ? (0, _sessionStorage.getCurrentSessionIdOrMakeNew)() : null,
-    // if cookies (now session tracking) is turned off or can't get session ID, this is null
-    xhrWrappable: typeof _globalScope.globalScope.XMLHttpRequest?.prototype?.addEventListener === 'function',
-    userAgent,
-    version: _environmentVariables.VERSION
-  };
+const model = {
+  buildEnv: _env.BUILD_ENV,
+  bytesSent: {},
+  // Used for SM to capture body bytes sent per endpoint
+  queryBytesSent: {},
+  // Used for SM to capture query parameter bytes sent per endpoint
+  customTransaction: undefined,
+  disabled: false,
+  distMethod: _env.DIST_METHOD,
+  isolatedBacklog: false,
+  loaderType: undefined,
+  maxBytes: 30000,
+  // The "timeOrigin" property is the new standard timestamp property shared across main frame and workers, but is not supported in some early Safari browsers (safari<15) + IE
+  // ingest expects an integer value, and timeOrigin can return a float.
+  offset: Math.floor(_globalScope.globalScope?.performance?.timeOrigin || _globalScope.globalScope?.performance?.timing?.navigationStart || Date.now()),
+  onerror: undefined,
+  origin: '' + _globalScope.globalScope.location,
+  ptid: undefined,
+  releaseIds: {},
+  session: undefined,
+  xhrWrappable: typeof _globalScope.globalScope.XMLHttpRequest?.prototype?.addEventListener === 'function',
+  userAgent,
+  version: _env.VERSION
 };
 const _cache = {};
 function getRuntime(id) {
   if (!id) throw new Error('All runtime objects require an agent identifier!');
-  if (!_cache[id]) throw new Error(`Runtime for ${id} was never set`);
+  if (!_cache[id]) throw new Error("Runtime for ".concat(id, " was never set"));
   return _cache[id];
 }
 function setRuntime(id, obj) {
   if (!id) throw new Error('All runtime objects require an agent identifier!');
-  _cache[id] = new _configurable.Configurable(obj, model(id));
+  _cache[id] = new _configurable.Configurable(obj, model);
   (0, _nreum.gosNREUMInitializedAgents)(id, _cache[id], 'runtime');
 }

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

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.VERSION = exports.DIST_METHOD = exports.BUILD_ENV = void 0;
+/**
+ * @file This file exposes CDN build environment variables. These variables will
+ * be overridden with babel.
+ */
+
+/**
+ * Exposes the version of the agent
+ */
+const VERSION = "1.232.0";
+
+/**
+ * Exposes the build type of the agent
+ * Valid values are LOCAL, PROD, DEV
+ */
+exports.VERSION = VERSION;
+const BUILD_ENV = undefined;
+
+/**
+ * Exposes the distribution method of the agent
+ */
+exports.BUILD_ENV = BUILD_ENV;
+const DIST_METHOD = 'CDN';
+exports.DIST_METHOD = DIST_METHOD;

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

@@ -0,0 +1,32 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.VERSION = exports.DIST_METHOD = exports.BUILD_ENV = void 0;
+var _package = _interopRequireDefault(require("../../../package.json"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/**
+ * @file This file exposes build time environment variables that will be included in the
+ * build output of the agent. This file specifically contains the normal environment variables
+ * for the NPM agent build and will be overridden by webpack/babel during the build based on the
+ * type of build being performed.
+ */
+
+/**
+ * Exposes the version of the agent
+ */
+const VERSION = _package.default.version;
+
+/**
+ * Exposes the build type of the agent
+ */
+exports.VERSION = VERSION;
+const BUILD_ENV = 'NPM';
+
+/**
+ * Exposes the distribution method of the agent
+ */
+exports.BUILD_ENV = BUILD_ENV;
+const DIST_METHOD = 'NPM';
+exports.DIST_METHOD = DIST_METHOD;

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

@@ -0,0 +1,30 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.VERSION = exports.DIST_METHOD = exports.BUILD_ENV = void 0;
+/**
+ * @file This file exposes NPM build environment variables. These variables will
+ * be overridden with babel.
+ */
+
+/**
+ * Exposes the version of the agent
+ */
+const VERSION = "1.232.0";
+
+/**
+ * Exposes the build type of the agent
+ * Valid values are LOCAL, PROD, DEV
+ */
+exports.VERSION = VERSION;
+const BUILD_ENV = 'NPM';
+
+/**
+ * Exposes the distribution method of the agent
+ * Valid valuse are CDN, NPM
+ */
+exports.BUILD_ENV = BUILD_ENV;
+const DIST_METHOD = 'NPM';
+exports.DIST_METHOD = DIST_METHOD;

package/dist/cjs/common/context/shared-context.js

@@ -6,7 +6,8 @@ Object.defineProperty(exports, "__esModule", {
 exports.SharedContext = void 0;
 var _console = require("../util/console");
 const model = {
-  agentIdentifier: ''
+  agentIdentifier: '',
+  ee: undefined
 };
 class SharedContext {
   constructor(context) {

package/dist/cjs/common/event-emitter/contextual-ee.test.js

@@ -0,0 +1,282 @@
+"use strict";
+
+var _faker = require("@faker-js/faker");
+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; }
+let mockNREUM;
+let runtime;
+beforeEach(() => {
+  mockNREUM = {};
+  runtime = {};
+  jest.doMock('../window/nreum', () => ({
+    __esModule: true,
+    gosNREUM: jest.fn(() => mockNREUM)
+  }));
+  jest.doMock('../config/config', () => ({
+    __esModule: true,
+    getRuntime: jest.fn(() => runtime)
+  }));
+});
+afterEach(() => {
+  jest.resetModules();
+  jest.resetAllMocks();
+});
+describe('global event-emitter', () => {
+  test('it returns the event-emitter defined on window.NREUM', async () => {
+    const mockEE = {};
+    mockNREUM.ee = mockEE;
+    const {
+      ee
+    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
+    expect(ee).toEqual(mockEE);
+  });
+  test('it sets the global event-emitter on window.NREUM', async () => {
+    const {
+      ee
+    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
+    expect(ee).toEqual(mockNREUM.ee);
+  });
+});
+describe('scoping event-emitter', () => {
+  test('it creates a new child event-emitter', async () => {
+    const {
+      ee
+    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
+    const childName = _faker.faker.datatype.uuid();
+    const result = ee.get(childName);
+    expect(result).not.toEqual(mockNREUM.ee);
+    expect(result).toEqual(ee.get(childName)); // Should always return the same event-emitter
+    expect(result.debugId).toEqual(childName);
+  });
+  test('it creates a child event-emitter with an isolated backlog', async () => {
+    const childName = _faker.faker.random.alphaNumeric(16);
+    jest.doMock('../config/config', () => ({
+      __esModule: true,
+      getRuntime: jest.fn(id => {
+        if (id === childName) {
+          return {
+            isolatedBacklog: true
+          };
+        }
+        return runtime;
+      })
+    }));
+    const {
+      ee
+    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
+    const result = ee.get(childName);
+    expect(ee.backlog).not.toBe(result.backlog);
+  });
+});
+describe('event-emitter context', () => {
+  test('it returns a new context', async () => {
+    const {
+      ee
+    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
+    const result = ee.context();
+    expect(result).toEqual({});
+  });
+  test('it returns the same context', async () => {
+    const {
+      ee
+    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
+    const result = ee.context();
+    expect(result).toEqual(ee.context(result));
+  });
+  test('it adds the context to the provided object', async () => {
+    const {
+      ee
+    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
+    const obj = {};
+    const result = ee.context(obj);
+    expect(result).toEqual(obj['nr@context']);
+  });
+});
+describe('event-emitter buffer', () => {
+  it('it should create a new buffer for the given group', async () => {
+    const {
+      ee
+    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
+    const eventType = _faker.faker.datatype.uuid();
+    const group = _faker.faker.datatype.uuid();
+    ee.buffer([eventType], group);
+    expect(ee.backlog).toEqual(expect.objectContaining({
+      [group]: []
+    }));
+    expect(ee.isBuffering(eventType)).toEqual(true);
+  });
+  it('it should default group to "feature"', async () => {
+    const {
+      ee
+    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
+    const eventType = _faker.faker.datatype.uuid();
+    ee.buffer([eventType]);
+    expect(ee.backlog).toEqual(expect.objectContaining({
+      feature: []
+    }));
+    expect(ee.isBuffering(eventType)).toEqual(true);
+  });
+  it('it should not create buffer if event-emitter is aborted', async () => {
+    const {
+      ee
+    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
+    const eventType = _faker.faker.datatype.uuid();
+    const group = _faker.faker.datatype.uuid();
+    ee.backlog = {
+      api: ['foo', 'bar', 'baz']
+    };
+    ee.abort();
+    ee.buffer([eventType], group);
+    expect(ee.backlog).toEqual({});
+    expect(ee.isBuffering(eventType)).toEqual(false);
+  });
+});
+describe('event-emitter abort', () => {
+  test('it aborts if there is an API backlog', async () => {
+    const {
+      ee
+    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
+    ee.backlog = {
+      api: ['foo', 'bar', 'baz']
+    };
+    ee.abort();
+    expect(ee.aborted).toEqual(true);
+    expect(ee.backlog).toEqual({});
+  });
+  test('it aborts if there is a feature backlog', async () => {
+    const {
+      ee
+    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
+    ee.backlog = {
+      feature: ['foo', 'bar', 'baz']
+    };
+    ee.abort();
+    expect(ee.aborted).toEqual(true);
+    expect(ee.backlog).toEqual({});
+  });
+});
+describe('event-emitter emit', () => {
+  it('should execute the listener', async () => {
+    const {
+      ee
+    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
+    const mockListener = jest.fn();
+    const eventType = _faker.faker.datatype.uuid();
+    const eventArgs = ['a', 'b', 'c'];
+    ee.on(eventType, mockListener);
+    ee.emit(eventType, eventArgs);
+    expect(mockListener).toHaveBeenCalledWith(eventArgs[0], eventArgs[1], eventArgs[2]);
+  });
+  it('should not execute the listener after removal', async () => {
+    const {
+      ee
+    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
+    const mockListener = jest.fn();
+    const eventType = _faker.faker.datatype.uuid();
+    const eventArgs = ['a', 'b', 'c'];
+    ee.on(eventType, mockListener);
+    ee.emit(eventType, eventArgs);
+    ee.removeEventListener(eventType, mockListener);
+    ee.emit(eventType, eventArgs);
+    expect(mockListener).toHaveBeenCalledTimes(1);
+  });
+  it('should return early if global event-emitter is aborted', async () => {
+    const {
+      ee
+    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
+    const mockListener = jest.fn();
+    const eventType = _faker.faker.datatype.uuid();
+    const eventArgs = ['a', 'b', 'c'];
+    ee.backlog = {
+      api: ['foo', 'bar', 'baz']
+    };
+    ee.abort();
+    ee.on(eventType, mockListener);
+    ee.emit(eventType, eventArgs);
+    expect(mockListener).toHaveBeenCalledTimes(0);
+  });
+  it('should still emit if global event-emitter is aborted but force flag is true', async () => {
+    const {
+      ee
+    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
+    const scopeEE = ee.get(_faker.faker.datatype.uuid());
+    const mockScopeListener = jest.fn();
+    const eventType = _faker.faker.datatype.uuid();
+    const eventArgs = ['a', 'b', 'c'];
+    ee.backlog = {
+      api: ['foo', 'bar', 'baz']
+    };
+    ee.abort();
+    scopeEE.on(eventType, mockScopeListener);
+    scopeEE.emit(eventType, eventArgs, {}, true);
+    expect(mockScopeListener).toHaveBeenCalledTimes(1);
+  });
+  it('should bubble the event if bubble flag is true', async () => {
+    const {
+      ee
+    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
+    const scopeEE = ee.get(_faker.faker.datatype.uuid());
+    const mockListener = jest.fn();
+    const mockScopeListener = jest.fn();
+    const eventType = _faker.faker.datatype.uuid();
+    const eventArgs = ['a', 'b', 'c'];
+    ee.on(eventType, mockListener);
+    scopeEE.on(eventType, mockScopeListener);
+    scopeEE.emit(eventType, eventArgs, {}, false, true);
+    expect(mockScopeListener).toHaveBeenCalledTimes(1);
+    expect(mockListener).toHaveBeenCalledTimes(1);
+  });
+  it('should not bubble the event if bubble flag is false', async () => {
+    const {
+      ee
+    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
+    const scopeEE = ee.get(_faker.faker.datatype.uuid());
+    const mockListener = jest.fn();
+    const mockScopeListener = jest.fn();
+    const eventType = _faker.faker.datatype.uuid();
+    const eventArgs = ['a', 'b', 'c'];
+    ee.on(eventType, mockListener);
+    scopeEE.on(eventType, mockScopeListener);
+    scopeEE.emit(eventType, eventArgs, {}, false, false);
+    expect(mockScopeListener).toHaveBeenCalledTimes(1);
+    expect(mockListener).not.toHaveBeenCalled();
+  });
+  it('should buffer the event on the scoped event-emitter', async () => {
+    const {
+      ee
+    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
+    const scopeEE = ee.get(_faker.faker.datatype.uuid());
+    const mockListener = jest.fn();
+    const mockScopeListener = jest.fn();
+    const eventType = _faker.faker.datatype.uuid();
+    const eventArgs = ['a', 'b', 'c'];
+    ee.on(eventType, mockListener);
+    ee.buffer([eventType]);
+    scopeEE.on(eventType, mockScopeListener);
+    scopeEE.buffer([eventType]);
+    scopeEE.emit(eventType, eventArgs, {}, false, false);
+    expect(mockScopeListener).toHaveBeenCalledTimes(1);
+    expect(mockListener).not.toHaveBeenCalled();
+    expect(scopeEE.backlog.feature).toEqual(expect.arrayContaining([expect.arrayContaining([scopeEE, eventType, eventArgs, {}])]));
+    expect(ee.backlog.feature).toEqual(scopeEE.backlog.feature);
+  });
+});
+describe('getOrSetContext', () => {
+  test('it returns a new context', async () => {
+    const {
+      getOrSetContext
+    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
+    const obj = {};
+    const result = getOrSetContext(obj);
+    expect(result).toEqual({});
+    expect(result).toEqual(obj['nr@context']);
+  });
+  test('it returns the same context', async () => {
+    const {
+      getOrSetContext
+    } = await Promise.resolve().then(() => _interopRequireWildcard(require('./contextual-ee')));
+    const obj = {};
+    const result = getOrSetContext(obj);
+    expect(getOrSetContext(obj)).toEqual(result);
+  });
+});