feat(browser): Add diagnoseSdk() function to programmatically detect possible issues

Author: Luca Forstner

packages/browser/src/diagnose-sdk.ts

@@ -0,0 +1,30 @@
+import { getCurrentScope } from '@sentry/core';
+
+/**
+ * A function to diagnose why the SDK might not be successfully sending data.
+ *
+ * Possible return values wrapped in a Promise:
+ * - `"no-client-active"` - There was no active client when the function was called. This possibly means that the SDK was not initialized yet.
+ * - `"sentry-unreachable"` - There was no active client when the function was called. This possibly means that the SDK was not initialized yet.
+ */
+export async function diagnoseSdk(): Promise<'no-client-active' | 'sentry-unreachable' | void> {
+  const client = getCurrentScope().getClient();
+
+  if (!client) {
+    return 'no-client-active';
+  }
+
+  try {
+    await fetch(
+      'https://o1337.ingest.sentry.io/api/1337/envelope/?sentry_version=7&sentry_key=1337&sentry_client=sentry.javascript.react%2F1.33.7',
+      {
+        body: '',
+        method: 'POST',
+        mode: 'cors',
+        credentials: 'omit',
+      },
+    );
+  } catch {
+    return 'sentry-unreachable';
+  }
+}

packages/browser/src/index.ts

@@ -71,3 +71,4 @@ export { launchDarklyIntegration, buildLaunchDarklyFlagUsedHandler } from './int
 export { openFeatureIntegration, OpenFeatureIntegrationHook } from './integrations/featureFlags/openfeature';
 export { unleashIntegration } from './integrations/featureFlags/unleash';
 export { statsigIntegration } from './integrations/featureFlags/statsig';
+export { diagnoseSdk } from './diagnose-sdk';