ref: Make setupOnce optional in integrations (#10729)

This is now properly optional 🎉

Author: mydea

packages/browser/src/integrations/breadcrumbs.ts

@@ -70,8 +70,6 @@ const _breadcrumbsIntegration = ((options: Partial<BreadcrumbsOptions> = {}) =>
 
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     setup(client) {
       if (_options.console) {
         addConsoleInstrumentationHandler(_getConsoleBreadcrumbHandler(client));

packages/browser/src/integrations/dedupe.ts

@@ -11,8 +11,6 @@ const _dedupeIntegration = (() => {
 
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     processEvent(currentEvent) {
       // We want to ignore any non-error type events, e.g. transactions or replays
       // These should never be deduped, and also not be compared against as _previousEvent.

packages/browser/src/integrations/httpcontext.ts

@@ -8,8 +8,6 @@ const INTEGRATION_NAME = 'HttpContext';
 const _httpContextIntegration = (() => {
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     preprocessEvent(event) {
       // if none of the information we want exists, don't bother
       if (!WINDOW.navigator && !WINDOW.location && !WINDOW.document) {

packages/browser/src/integrations/linkederrors.ts

@@ -19,8 +19,6 @@ const _linkedErrorsIntegration = ((options: LinkedErrorsOptions = {}) => {
 
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     preprocessEvent(event, hint, client) {
       const options = client.getOptions();
 

packages/browser/src/profiling/integration.ts

@@ -22,7 +22,6 @@ const _browserProfilingIntegration = (() => {
   return {
     name: INTEGRATION_NAME,
     // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     setup(client) {
       const scope = getCurrentScope();
 

packages/core/src/integration.ts

@@ -129,7 +129,7 @@ export function setupIntegration(client: Client, integration: Integration, integ
   integrationIndex[integration.name] = integration;
 
   // `setupOnce` is only called the first time
-  if (installedIntegrations.indexOf(integration.name) === -1) {
+  if (installedIntegrations.indexOf(integration.name) === -1 && typeof integration.setupOnce === 'function') {
     // eslint-disable-next-line deprecation/deprecation
     integration.setupOnce(addGlobalEventProcessor, getCurrentHub);
     installedIntegrations.push(integration.name);

packages/core/src/integrations/inboundfilters.ts

@@ -33,8 +33,6 @@ const INTEGRATION_NAME = 'InboundFilters';
 const _inboundFiltersIntegration = ((options: Partial<InboundFiltersOptions> = {}) => {
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     processEvent(event, _hint, client) {
       const clientOptions = client.getOptions();
       const mergedOptions = _mergeOptions(options, clientOptions);

packages/core/src/integrations/linkederrors.ts

@@ -18,8 +18,6 @@ const _linkedErrorsIntegration = ((options: LinkedErrorsOptions = {}) => {
 
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     preprocessEvent(event, hint, client) {
       const options = client.getOptions();
 

packages/core/src/integrations/metadata.ts

@@ -9,8 +9,6 @@ const INTEGRATION_NAME = 'ModuleMetadata';
 const _moduleMetadataIntegration = (() => {
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     setup(client) {
       // We need to strip metadata from stack frames before sending them to Sentry since these are client side only.
       client.on('beforeEnvelope', envelope => {

packages/core/src/integrations/requestdata.ts

@@ -75,8 +75,6 @@ const _requestDataIntegration = ((options: RequestDataIntegrationOptions = {}) =
 
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     processEvent(event, _hint, client) {
       // Note: In the long run, most of the logic here should probably move into the request data utility functions. For
       // the moment it lives here, though, until https://github.com/getsentry/sentry-javascript/issues/5718 is addressed.

packages/deno/src/integrations/context.ts

@@ -55,8 +55,6 @@ async function addDenoRuntimeContext(event: Event): Promise<Event> {
 const _denoContextIntegration = (() => {
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     processEvent(event) {
       return addDenoRuntimeContext(event);
     },

packages/deno/src/integrations/contextlines.ts

@@ -52,8 +52,6 @@ const _contextLinesIntegration = ((options: ContextLinesOptions = {}) => {
 
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     processEvent(event) {
       return addSourceContext(event, contextLines);
     },

packages/deno/src/integrations/globalhandlers.ts

@@ -31,8 +31,6 @@ const _globalHandlersIntegration = ((options?: GlobalHandlersIntegrations) => {
 
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     setup(client) {
       if (_options.error) {
         installGlobalErrorHandler(client);

packages/deno/src/integrations/normalizepaths.ts

@@ -70,8 +70,6 @@ const _normalizePathsIntegration = (() => {
 
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     processEvent(event) {
       // This error.stack hopefully contains paths that traverse the app cwd
       const error = new Error();

packages/integrations/src/captureconsole.ts

@@ -20,8 +20,6 @@ const _captureConsoleIntegration = ((options: CaptureConsoleOptions = {}) => {
 
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     setup(client) {
       if (!('console' in GLOBAL_OBJ)) {
         return;

packages/integrations/src/contextlines.ts

@@ -23,8 +23,6 @@ const _contextLinesIntegration = ((options: ContextLinesOptions = {}) => {
 
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     processEvent(event) {
       return addSourceContext(event, contextLines);
     },

packages/integrations/src/debug.ts

@@ -24,8 +24,6 @@ const _debugIntegration = ((options: DebugOptions = {}) => {
 
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     setup(client) {
       client.on('beforeSendEvent', (event: Event, hint?: EventHint) => {
         if (_options.debugger) {

packages/integrations/src/dedupe.ts

@@ -11,8 +11,6 @@ const _dedupeIntegration = (() => {
 
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     processEvent(currentEvent) {
       // We want to ignore any non-error type events, e.g. transactions or replays
       // These should never be deduped, and also not be compared against as _previousEvent.

packages/integrations/src/extraerrordata.ts

@@ -27,8 +27,6 @@ const _extraErrorDataIntegration = ((options: Partial<ExtraErrorDataOptions> = {
   const { depth = 3, captureErrorCause = true } = options;
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     processEvent(event, hint) {
       return _enhanceEventWithErrorData(event, hint, depth, captureErrorCause);
     },

packages/integrations/src/httpclient.ts

@@ -47,8 +47,6 @@ const _httpClientIntegration = ((options: Partial<HttpClientOptions> = {}) => {
 
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     setup(client): void {
       _wrapFetch(client, _options);
       _wrapXHR(client, _options);

packages/integrations/src/rewriteframes.ts

@@ -71,8 +71,6 @@ const _rewriteFramesIntegration = ((options: RewriteFramesOptions = {}) => {
 
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     processEvent(originalEvent) {
       let processedEvent = originalEvent;
 

packages/integrations/src/sessiontiming.ts

@@ -8,8 +8,6 @@ const _sessionTimingIntegration = (() => {
 
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     processEvent(event) {
       const now = Date.now();
 

packages/integrations/test/reportingobserver.test.ts

@@ -50,7 +50,7 @@ describe('ReportingObserver', () => {
       const reportingObserver = reportingObserverIntegration();
 
       expect(() => {
-        reportingObserver.setupOnce();
+        reportingObserver.setupOnce!();
       }).not.toThrow();
 
       expect(mockReportingObserverConstructor).not.toHaveBeenCalled();
@@ -59,7 +59,7 @@ describe('ReportingObserver', () => {
 
     it('should use default report types', () => {
       const reportingObserver = reportingObserverIntegration();
-      reportingObserver.setupOnce();
+      reportingObserver.setupOnce!();
       reportingObserver.setup?.(mockClient);
 
       expect(mockReportingObserverConstructor).toHaveBeenCalledTimes(1);
@@ -71,7 +71,7 @@ describe('ReportingObserver', () => {
 
     it('should use user-provided report types', () => {
       const reportingObserver = reportingObserverIntegration({ types: ['crash'] });
-      reportingObserver.setupOnce();
+      reportingObserver.setupOnce!();
       reportingObserver.setup?.(mockClient);
 
       expect(mockReportingObserverConstructor).toHaveBeenCalledTimes(1);
@@ -83,7 +83,7 @@ describe('ReportingObserver', () => {
 
     it('should use `buffered` option', () => {
       const reportingObserver = reportingObserverIntegration();
-      reportingObserver.setupOnce();
+      reportingObserver.setupOnce!();
       reportingObserver.setup?.(mockClient);
 
       expect(mockReportingObserverConstructor).toHaveBeenCalledTimes(1);
@@ -95,7 +95,7 @@ describe('ReportingObserver', () => {
 
     it('should call `observe` function', () => {
       const reportingObserver = reportingObserverIntegration();
-      reportingObserver.setupOnce();
+      reportingObserver.setupOnce!();
       reportingObserver.setup?.(mockClient);
 
       expect(mockObserve).toHaveBeenCalledTimes(1);
@@ -105,7 +105,7 @@ describe('ReportingObserver', () => {
   describe('handler', () => {
     it('should abort gracefully and not do anything when integration is not installed', () => {
       const reportingObserver = reportingObserverIntegration();
-      reportingObserver.setupOnce();
+      reportingObserver.setupOnce!();
       // without calling setup, the integration is not registered
 
       const handler = mockReportingObserverConstructor.mock.calls[0][0];
@@ -119,7 +119,7 @@ describe('ReportingObserver', () => {
 
     it('should capture messages', () => {
       const reportingObserver = reportingObserverIntegration();
-      reportingObserver.setupOnce();
+      reportingObserver.setupOnce!();
       reportingObserver.setup?.(mockClient);
       const handler = mockReportingObserverConstructor.mock.calls[0][0];
 
@@ -133,7 +133,7 @@ describe('ReportingObserver', () => {
 
     it('should set extra including the url of a report', () => {
       const reportingObserver = reportingObserverIntegration();
-      reportingObserver.setupOnce();
+      reportingObserver.setupOnce!();
       reportingObserver.setup?.(mockClient);
       const handler = mockReportingObserverConstructor.mock.calls[0][0];
 
@@ -148,7 +148,7 @@ describe('ReportingObserver', () => {
 
     it('should set extra including the report body if available', () => {
       const reportingObserver = reportingObserverIntegration();
-      reportingObserver.setupOnce();
+      reportingObserver.setupOnce!();
       reportingObserver.setup?.(mockClient);
       const handler = mockReportingObserverConstructor.mock.calls[0][0];
 
@@ -163,7 +163,7 @@ describe('ReportingObserver', () => {
 
     it('should not set extra report body extra when no body is set', () => {
       const reportingObserver = reportingObserverIntegration();
-      reportingObserver.setupOnce();
+      reportingObserver.setupOnce!();
       reportingObserver.setup?.(mockClient);
       const handler = mockReportingObserverConstructor.mock.calls[0][0];
 
@@ -174,7 +174,7 @@ describe('ReportingObserver', () => {
 
     it('should capture report details from body on crash report', () => {
       const reportingObserver = reportingObserverIntegration();
-      reportingObserver.setupOnce();
+      reportingObserver.setupOnce!();
       reportingObserver.setup?.(mockClient);
       const handler = mockReportingObserverConstructor.mock.calls[0][0];
 
@@ -192,7 +192,7 @@ describe('ReportingObserver', () => {
 
     it('should capture report message from body on deprecation report', () => {
       const reportingObserver = reportingObserverIntegration();
-      reportingObserver.setupOnce();
+      reportingObserver.setupOnce!();
       reportingObserver.setup?.(mockClient);
       const handler = mockReportingObserverConstructor.mock.calls[0][0];
 
@@ -209,7 +209,7 @@ describe('ReportingObserver', () => {
 
     it('should capture report message from body on intervention report', () => {
       const reportingObserver = reportingObserverIntegration();
-      reportingObserver.setupOnce();
+      reportingObserver.setupOnce!();
       reportingObserver.setup?.(mockClient);
       const handler = mockReportingObserverConstructor.mock.calls[0][0];
 
@@ -226,7 +226,7 @@ describe('ReportingObserver', () => {
 
     it('should use fallback message when no body is available', () => {
       const reportingObserver = reportingObserverIntegration();
-      reportingObserver.setupOnce();
+      reportingObserver.setupOnce!();
       reportingObserver.setup?.(mockClient);
       const handler = mockReportingObserverConstructor.mock.calls[0][0];
 
@@ -242,7 +242,7 @@ describe('ReportingObserver', () => {
 
     it('should use fallback message when no body details are available for crash report', () => {
       const reportingObserver = reportingObserverIntegration();
-      reportingObserver.setupOnce();
+      reportingObserver.setupOnce!();
       reportingObserver.setup?.(mockClient);
       const handler = mockReportingObserverConstructor.mock.calls[0][0];
 
@@ -255,7 +255,7 @@ describe('ReportingObserver', () => {
 
     it('should use fallback message when no body message is available for deprecation report', () => {
       const reportingObserver = reportingObserverIntegration();
-      reportingObserver.setupOnce();
+      reportingObserver.setupOnce!();
       reportingObserver.setup?.(mockClient);
       const handler = mockReportingObserverConstructor.mock.calls[0][0];
 
@@ -272,7 +272,7 @@ describe('ReportingObserver', () => {
 
     it('should use fallback message when no body message is available for intervention report', () => {
       const reportingObserver = reportingObserverIntegration();
-      reportingObserver.setupOnce();
+      reportingObserver.setupOnce!();
       reportingObserver.setup?.(mockClient);
       const handler = mockReportingObserverConstructor.mock.calls[0][0];
 

packages/node/src/integrations/anr/index.ts

@@ -55,8 +55,6 @@ const INTEGRATION_NAME = 'Anr';
 const _anrIntegration = ((options: Partial<AnrIntegrationOptions> = {}) => {
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     setup(client: NodeClient) {
       if (NODE_VERSION.major < 16 || (NODE_VERSION.major === 16 && NODE_VERSION.minor < 17)) {
         throw new Error('ANR detection requires Node 16.17.0 or later');

packages/node/src/integrations/console.ts

@@ -8,8 +8,6 @@ const INTEGRATION_NAME = 'Console';
 const _consoleIntegration = (() => {
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     setup(client) {
       addConsoleInstrumentationHandler(({ args, level }) => {
         if (getClient() !== client) {

packages/node/src/integrations/context.ts

@@ -102,8 +102,6 @@ const _nodeContextIntegration = ((options: ContextOptions = {}) => {
 
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     processEvent(event) {
       return addContext(event);
     },

packages/node/src/integrations/contextlines.ts

@@ -40,8 +40,6 @@ const _contextLinesIntegration = ((options: ContextLinesOptions = {}) => {
 
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     processEvent(event) {
       return addSourceContext(event, contextLines);
     },

packages/node/src/integrations/local-variables/local-variables-async.ts

@@ -220,8 +220,6 @@ const _localVariablesAsyncIntegration = ((options: LocalVariablesIntegrationOpti
 
   return {
     name: INTEGRATION_NAME,
-    // TODO v8: Remove this
-    setupOnce() {}, // eslint-disable-line @typescript-eslint/no-empty-function
     setup(client: NodeClient) {
       const clientOptions = client.getOptions();