feat(node): Add Spotlight option to Node SDK

packages/node/src/sdk.ts

@@ -10,7 +10,9 @@ import type { SessionStatus, StackParser } from '@sentry/types';
 import {
   createStackParser,
   GLOBAL_OBJ,
+  logger,
   nodeStackLineParser,
+  serializeEnvelope,
   stackParserFromStackParserOptions,
   tracingContextFromHeaders,
 } from '@sentry/utils';
@@ -179,6 +181,39 @@ export function init(options: NodeOptions = {}): void {
   }
 
   updateScopeFromEnvVariables();
+
+  connectToSpotlight(options);
+}
+
+function connectToSpotlight(options: NodeOptions): void {
+  if (!options.spotlight) {
+    return;
+  }
+
+  const spotlightUrl = typeof options.spotlight === 'string' ? options.spotlight : 'http://localhost:8969/stream';
+
+  const client = getCurrentHub().getClient();
+  if (client) {
+    client.setupIntegrations(true);
+    let tries = 0;
+    client.on('beforeEnvelope', envelope => {
+      if (tries > 3) {
+        logger.warn('[Spotlight] Disabled Sentry -> Spotlight integration due to too many failed requests');
+        return;
+      }
+      fetch(spotlightUrl, {
+        method: 'POST',
+        body: serializeEnvelope(envelope),
+        headers: {
+          'Content-Type': 'application/x-sentry-envelope',
+        },
+        mode: 'cors',
+      }).catch(() => {
+        tries++;
+        logger.warn('[Spotlight] Failed to send envelope to Spotlight Sidecar');
+      });
+    });
+  }
 }
 
 /**

packages/node/src/types.ts

@@ -79,6 +79,12 @@ export interface BaseNodeOptions {
 
   /** Callback that is executed when a fatal global error occurs. */
   onFatalError?(this: void, error: Error): void;
+
+  /**
+   * The SDK tries to relay all events to Spotlight in development.
+   * Either set it to true, or provide a specific Spotlight URL.
+   */
+  spotlight?: boolean | string;
 }
 
 /**