feat(replay): Add getReplay utility function (#10510)

As pointed out here, and I also did notice that myself, it is not super
nice - as you need to provide a generic integration to
`getIntegrationByName`, which is annoying to do in a type safe way, esp.
if you want to avoid deprecations:

```ts
const client = getClient();
const replay = client && client.getIntegrationByName && client.getIntegrationByName<ReturnType<typeof replayIntegration>>('Replay');
```

So IMHO a small utility `Sentry.getReplay()` is not unreasonable for
this 🤔

Author: mydea

packages/browser/src/index.ts

@@ -27,6 +27,7 @@ export {
   // eslint-disable-next-line deprecation/deprecation
   Replay,
   replayIntegration,
+  getReplay,
 } from '@sentry/replay';
 export type {
   ReplayEventType,

packages/replay/src/index.ts

@@ -19,5 +19,7 @@ export type {
   CanvasManagerOptions,
 } from './types';
 
+export { getReplay } from './util/getReplay';
+
 // TODO (v8): Remove deprecated types
 export * from './types/deprecated';

packages/replay/src/util/getReplay.ts

@@ -0,0 +1,13 @@
+import { getClient } from '@sentry/core';
+import type { replayIntegration } from '../integration';
+
+/**
+ * This is a small utility to get a type-safe instance of the Replay integration.
+ */
+// eslint-disable-next-line deprecation/deprecation
+export function getReplay(): ReturnType<typeof replayIntegration> | undefined {
+  const client = getClient();
+  return (
+    client && client.getIntegrationByName && client.getIntegrationByName<ReturnType<typeof replayIntegration>>('Replay')
+  );
+}

packages/replay/test/unit/util/getReplay.test.ts

@@ -0,0 +1,42 @@
+import { getCurrentScope } from '@sentry/core';
+import { replayIntegration } from '../../../src/integration';
+import { getReplay } from '../../../src/util/getReplay';
+import { getDefaultClientOptions, init } from '../../utils/TestClient';
+
+describe('getReplay', () => {
+  beforeEach(() => {
+    getCurrentScope().setClient(undefined);
+  });
+
+  it('works without a client', () => {
+    const actual = getReplay();
+    expect(actual).toBeUndefined();
+  });
+
+  it('works with a client without Replay', () => {
+    init(
+      getDefaultClientOptions({
+        dsn: 'https://[email protected]/1',
+      }),
+    );
+
+    const actual = getReplay();
+    expect(actual).toBeUndefined();
+  });
+
+  it('works with a client with Replay xxx', () => {
+    const replay = replayIntegration();
+    init(
+      getDefaultClientOptions({
+        integrations: [replay],
+        replaysOnErrorSampleRate: 0,
+        replaysSessionSampleRate: 0,
+      }),
+    );
+
+    const actual = getReplay();
+    expect(actual).toBeDefined();
+    expect(actual === replay).toBe(true);
+    expect(replay.getReplayId()).toBe(undefined);
+  });
+});

packages/replay/test/utils/TestClient.ts

@@ -39,7 +39,7 @@ export function init(options: TestClientOptions): void {
   initAndBind(TestClient, options);
 }
 
-export function getDefaultClientOptions(options: Partial<ClientOptions> = {}): ClientOptions {
+export function getDefaultClientOptions(options: Partial<TestClientOptions> = {}): ClientOptions {
   return {
     integrations: [],
     dsn: 'https://username@domain/123',