feat(v7/types): Deprecate Hub interface (#11530)

This PR deprecates the `Hub` interface as a continuation of #11528 where
we deprecated the Hub class.

The difference here is that the interface will stay deprecated
throughout v8 so that we can shim the infamous `getCurrentHub` API. Most
other usages of the interface should already be removed in v8/`develop`
🤞

Author: Lms24

packages/core/src/hub.ts

@@ -115,6 +115,7 @@ export interface Carrier {
  * themselves and will also be removed in version 8. More information:
  * - [Migration Guide](https://github.com/getsentry/sentry-javascript/blob/develop/MIGRATION.md#deprecate-hub)
  */
+// eslint-disable-next-line deprecation/deprecation
 export class Hub implements HubInterface {
   /** Is a {@link Layer}[] containing the client and scope */
   private readonly _stack: Layer[];

packages/core/src/utils/isSentryRequestUrl.ts

@@ -6,6 +6,7 @@ import type { Client, DsnComponents, Hub } from '@sentry/types';
  *
  * TODO(v8): Remove Hub fallback type
  */
+// eslint-disable-next-line deprecation/deprecation
 export function isSentryRequestUrl(url: string, hubOrClient: Hub | Client | undefined): boolean {
   const client =
     hubOrClient && isHub(hubOrClient)
@@ -34,6 +35,7 @@ function removeTrailingSlash(str: string): string {
   return str[str.length - 1] === '/' ? str.slice(0, -1) : str;
 }
 
+// eslint-disable-next-line deprecation/deprecation
 function isHub(hubOrClient: Hub | Client | undefined): hubOrClient is Hub {
   // eslint-disable-next-line deprecation/deprecation
   return (hubOrClient as Hub).getClient !== undefined;

packages/core/test/lib/utils/isSentryRequestUrl.test.ts

@@ -21,6 +21,7 @@ describe('isSentryRequestUrl', () => {
       getClient: () => {
         return client;
       },
+      // eslint-disable-next-line deprecation/deprecation
     } as unknown as Hub;
 
     // Works with hub passed

packages/integrations/test/reportingobserver.test.ts

@@ -14,6 +14,7 @@ const withScope = jest.fn(callback => {
 
 const captureMessage = jest.fn();
 
+// eslint-disable-next-line deprecation/deprecation
 const mockHub = {} as unknown as Hub;
 
 const mockReportingObserverConstructor = jest.fn();

packages/node-experimental/src/integrations/http.ts

@@ -173,6 +173,7 @@ export class Http implements Integration {
   /**
    * @inheritDoc
    */
+  // eslint-disable-next-line deprecation/deprecation
   public setupOnce(_addGlobalEventProcessor: (callback: EventProcessor) => void, _getCurrentHub: () => Hub): void {
     // No need to instrument if we don't want to track anything
     if (!this._breadcrumbs && this._spans === false) {

packages/node-experimental/src/sdk/globals.ts

@@ -27,7 +27,7 @@ export function getGlobalCarrier(): SentryCarrier {
  * Calls global extension method and binding current instance to the function call
  */
 // @ts-expect-error Function lacks ending return statement and return type does not include 'undefined'. ts(2366)
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
+// eslint-disable-next-line @typescript-eslint/no-explicit-any,deprecation/deprecation
 export function callExtensionMethod<T>(hub: Hub, method: string, ...args: any[]): T {
   const carrier = getGlobalCarrier();
 

packages/node-experimental/src/sdk/hub.ts

@@ -40,6 +40,7 @@ export function setupGlobalHub(): void {
 /**
  * This is for legacy reasons, and returns a proxy object instead of a hub to be used.
  */
+// eslint-disable-next-line deprecation/deprecation
 export function getCurrentHub(): Hub {
   return {
     isOlderThan(_version: number): boolean {
@@ -88,6 +89,7 @@ export function getCurrentHub(): Hub {
     // eslint-disable-next-line deprecation/deprecation
     configureScope: configureScope,
 
+    // eslint-disable-next-line deprecation/deprecation
     run(callback: (hub: Hub) => void): void {
       // eslint-disable-next-line @typescript-eslint/no-explicit-any
       return withScope(() => callback(this as any));
@@ -142,6 +144,7 @@ export function getCurrentHub(): Hub {
  *
  * @returns The old replaced hub
  */
+// eslint-disable-next-line deprecation/deprecation
 export function makeMain(hub: Hub): Hub {
   // eslint-disable-next-line no-console
   console.warn('makeMain is a noop in @sentry/node-experimental. Use `setCurrentClient` instead.');

packages/node-experimental/src/sdk/types.ts

@@ -54,6 +54,7 @@ export interface AsyncContextStrategy {
   getScopes: () => CurrentScopes | undefined;
 
   /** This is here for legacy reasons. */
+  // eslint-disable-next-line deprecation/deprecation
   getCurrentHub: () => Hub;
 
   /**
@@ -67,6 +68,7 @@ export interface SentryCarrier {
   acs?: AsyncContextStrategy;
 
   // hub is here for legacy reasons
+  // eslint-disable-next-line deprecation/deprecation
   hub?: Hub;
 
   extensions?: {

packages/node/test/eventbuilders.test.ts

@@ -69,6 +69,7 @@ describe('eventFromUnknownInput', () => {
             return { normalizeDepth: 6 };
           },
         }),
+        // eslint-disable-next-line deprecation/deprecation
       } as unknown as Hub;
     });
 

packages/opentelemetry-node/src/utils/captureExceptionForTimedEvent.ts

@@ -7,6 +7,7 @@ import { isString } from '@sentry/utils';
  * Maybe capture a Sentry exception for an OTEL timed event.
  * This will check if the event is exception-like and in that case capture it as an exception.
  */
+// eslint-disable-next-line deprecation/deprecation
 export function maybeCaptureExceptionForTimedEvent(hub: Hub, event: TimedEvent, otelSpan?: OtelSpan): void {
   if (event.name !== 'exception') {
     return;