feat: Prepare agent to utilize v2 harvests for MFE registrations (#1495)

Author: metal-messiah

.github/actions/build-ab/templates/postamble.js

@@ -64,10 +64,10 @@ if (!!newrelic && !!newrelic.log) {
 }
 
 // Browser AI-Hackthon POC Prep
-try{
+try {
   const automatedHints = ['Headless', 'PhantomJS', 'Selenium', 'WebDriver', 'Puppeteer', 'Playwright']
   const botHints = ['bot', 'spider', 'crawler', 'scraper', 'robot', 'Googlebot', 'Bingbot', 'Slurp', 'DuckDuckBot', 'Baiduspider', 'YandexBot', 'AhrefsBot', 'SemrushBot', 'Exabot', 'facebot', 'ia_archiver', 'facebookexternalhit', 'Twitterbot', 'LinkedInBot', 'Slackbot', 'Discordbot', 'Pinterestbot', 'WhatsApp', 'TelegramBot', 'GoogleAdsBot', 'BingPreview']
-  
+
   const automatedMatches = []
   const botMatches = []
 
@@ -81,7 +81,7 @@ try{
 
   const userAgentString = window.navigator.userAgent
 
-  if (userAgentString){  
+  if (userAgentString) {
     automatedHints.map(x => x.toLowerCase()).forEach((hint) => {
       if (userAgentString.toLowerCase().includes(hint)) {
         automatedMatches.push(hint);
@@ -107,7 +107,7 @@ try{
     newrelic.setCustomAttribute('userAgent', window.navigator.userAgent);
   }
 } catch (e) {
-  newrelic.noticeError(new Error("NRBA: swallowed preamble error", {cause: e}));
+  newrelic.noticeError(new Error("NRBA: swallowed preamble error", { cause: e }));
 }
 
 try {
@@ -140,5 +140,5 @@ try {
     pressureObserver.observe("cpu", { sampleInterval: 1000 });
   }
 } catch (e) {
-  newrelic.noticeError(new Error("NRBA: swallowed preamble error", {cause: e}));
+  newrelic.noticeError(new Error("NRBA: swallowed preamble error", { cause: e }));
 }

.github/actions/build-ab/templates/released.js

@@ -1,7 +1,7 @@
 // config
 window.NREUM={
   init: {
-    feature_flags: ['soft_nav', 'user_frustrations'],
+    feature_flags: ['soft_nav', 'user_frustrations', 'register'], // add jserrors and generic events once the consumer(s) support it
     distributed_tracing: {
       enabled: true
     },

.github/workflows/pull-request-checks.yml

@@ -13,6 +13,10 @@ on:
         description: 'Run the latest version of browsers only instead of all versions'
         default: true
         type: boolean
+      boosted:
+        description: 'Enable boosted testing (uses more resources)'
+        default: false
+        type: boolean
   pull_request:
 
 jobs:
@@ -261,6 +265,7 @@ jobs:
     with:
       ref: 'refs/pull/${{ fromJSON(needs.find-pull-request.outputs.pull-request-target).pr_number }}/merge'
       latest-only: ${{ inputs.latest-only }}
+      boosted: ${{ inputs.boosted }}
     secrets: inherit
 
   complete-status-comment-pull-request:

.github/workflows/wdio-all-browsers.yml

@@ -12,6 +12,10 @@ on:
         description: 'Run the latest version of browsers only instead of all versions'
         default: true
         type: boolean
+      boosted:
+        description: 'Enable boosted testing (uses more resources)'
+        default: false
+        type: boolean
     secrets:
       LAMBDA_USERNAME:
         required: true
@@ -24,27 +28,31 @@ jobs:
     with:
       ref: ${{ inputs.ref || github.ref }}
       browser-target: ${{ inputs.latest-only == true && 'chrome@latest' || 'chrome@*' }}
+      concurrency: ${{ inputs.boosted == true && 20 || 10 }}
     secrets: inherit
 
   firefox:
     uses: ./.github/workflows/wdio-single-browser.yml
     with:
       ref: ${{ inputs.ref || github.ref }}
       browser-target: ${{ inputs.latest-only == true && 'firefox@latest' || 'firefox@*' }}
+      concurrency: ${{ inputs.boosted == true && 20 || 10 }}
     secrets: inherit
 
   safari:
     uses: ./.github/workflows/wdio-single-browser.yml
     with:
       ref: ${{ inputs.ref || github.ref }}
       browser-target: ${{ inputs.latest-only == true && 'safari@latest' || 'safari@*' }}
+      concurrency: ${{ inputs.boosted == true && 20 || 10 }}
     secrets: inherit
 
   edge:
     uses: ./.github/workflows/wdio-single-browser.yml
     with:
       ref: ${{ inputs.ref || github.ref }}
       browser-target: ${{ inputs.latest-only == true && 'edge@latest' || 'edge@*' }}
+      concurrency: ${{ inputs.boosted == true && 20 || 10 }}
     secrets: inherit
 
   ios:
@@ -53,6 +61,7 @@ jobs:
       ref: ${{ inputs.ref || github.ref }}
       browser-target: ${{ inputs.latest-only == true && 'ios@latest' || 'ios@*' }}
       additional-flags: --timeout 120000 --session-timeout 240000
+      concurrency: ${{ inputs.boosted == true && 20 || 10 }}
     secrets: inherit
 
   android:
@@ -61,6 +70,7 @@ jobs:
       ref: ${{ inputs.ref || github.ref }}
       browser-target: ${{ inputs.latest-only == true && 'android@latest' || 'android@*' }}
       additional-flags: --timeout 120000 --session-timeout 240000
+      concurrency: ${{ inputs.boosted == true && 20 || 10 }}
     secrets: inherit
 
   ios-webview:

docs/warning-codes.md

@@ -96,7 +96,7 @@
 ### 47
 `We tried to access a stylesheet's contents but failed due to browser security. For best results, ensure that cross-domain CSS assets are decorated with "crossorigin='anonymous'" attribution or are otherwise publicly accessible.`
 ### 48
-`Supplied an invalid API target. Must be an <Object> that contains licenseKey and applicationID properties.`
+`Supplied an invalid API target. Must be an <Object> that contains id and name properties.`
 ### 49
 `Supplied API target is missing an entityGuid. Some APIs may not behave correctly without a valid entityGuid (ex. logs).`
 ### 50
@@ -129,4 +129,3 @@
 `A single event was larger than the maximum allowed payload size`
 ### 64
 `Required globals have been mutated before being accessed by the browser agent. This can cause issues and should be avoided.`
-

src/common/config/init-types.js

@@ -35,7 +35,7 @@
  * @property {Object} [metrics]
  * @property {boolean} [metrics.enabled] - Turn on/off the metrics feature (on by default).
  * @property {boolean} [metrics.autoStart] - If true, the agent will automatically start the metrics feature. Otherwise, it will be in a deferred state until the `start` API method is called.
- * @property {Array<Object>} [obfuscate] - Array of regexp and corresponding replacement patterns for obfuscating data.
+ * @property {{regex: RegExp | string, replacement: string}[]} [obfuscate] - Array of regexp and corresponding replacement patterns for obfuscating data.
  * @property {Object} [page_action]
  * @property {boolean} [page_action.enabled] - Must be true to allow PageAction events to be captured.
  * @property {Object} [page_view_event]

src/common/config/init.js

@@ -21,6 +21,7 @@ const InitModelFn = () => {
   const hiddenState = {
     feature_flags: [],
     experimental: {
+      allow_registered_children: false,
       resources: false
     },
     mask_selector: '*',
@@ -48,7 +49,8 @@ const InitModelFn = () => {
   return {
     ajax: { deny_list: undefined, block_internal: true, enabled: true, autoStart: true },
     api: {
-      allow_registered_children: true,
+      get allow_registered_children () { return hiddenState.feature_flags.includes(FEATURE_FLAGS.REGISTER) || hiddenState.experimental.allow_registered_children },
+      set allow_registered_children (val) { hiddenState.experimental.allow_registered_children = val },
       duplicate_registered_data: false
     },
     distributed_tracing: {

src/common/config/runtime.js

@@ -25,7 +25,6 @@ const RuntimeModel = {
   customTransaction: undefined,
   denyList: undefined,
   disabled: false,
-  entityManager: undefined,
   harvester: undefined,
   isolatedBacklog: false,
   isRecording: false, // true when actively recording, false when paused or stopped
@@ -37,6 +36,7 @@ const RuntimeModel = {
   releaseIds: {},
   session: undefined,
   timeKeeper: undefined,
+  registeredEntities: [],
   /** a proxy is set in agent-session to track jsAttributes changes for harvesting mechanics */
   jsAttributesMetadata: { bytes: 0 },
   get harvestCount () { return ++_harvestCount }

src/common/constants/agent-constants.js

@@ -2,7 +2,17 @@
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
+import { FEATURE_NAMES } from '../../loaders/features/features'
+
 export const IDEAL_PAYLOAD_SIZE = 16000
 export const MAX_PAYLOAD_SIZE = 1000000
 export const DEFAULT_KEY = 'NR_CONTAINER_AGENT'
 export const SESSION_ERROR = 'SESSION_ERROR'
+
+export const SUPPORTS_REGISTERED_ENTITIES = {
+  [FEATURE_NAMES.logging]: true,
+  // flip other features here when they are supported by DEM consumers
+  [FEATURE_NAMES.genericEvents]: false,
+  [FEATURE_NAMES.jserrors]: false,
+  [FEATURE_NAMES.ajax]: false
+}

src/common/drain/drain.js

@@ -123,7 +123,7 @@ function drainGroup (agentIdentifier, group, activateGroup = true) {
 
   if (!baseEE.isolatedBacklog) delete handlers[group]
   baseEE.backlog[group] = null
-  baseEE.emit('drain-' + group, []) // TODO: Code exists purely for a unit test and needs to be refined
+  baseEE.emit('drain-' + group, []) // Informs the feature that it has drained its backlog of events, this kicks off an immediate harvest to capture any load-driven events that were buffered.
 }
 
 /**