eranos/src/lib/sentry.ts

import type { Event as SentryEvent } from '@sentry/core';

/** Subset of the Sentry API surface we actually use. */
interface SentryLike {
  init: typeof import('@sentry/react').init;
  getClient: typeof import('@sentry/react').getClient;
  browserTracingIntegration: typeof import('@sentry/react').browserTracingIntegration;
  captureException: typeof import('@sentry/react').captureException;
  captureMessage: typeof import('@sentry/react').captureMessage;
  setUser: typeof import('@sentry/react').setUser;
}

let sentryInstance: SentryLike | null = null;
let isInitialized = false;
let isEnabled = false;

/**
 * Dynamically imports and initializes Sentry.
 * Uses code splitting so the SDK is only downloaded when needed.
 * Only imports the functions we use so tree-shaking can drop
 * unused modules (replay, feedback, replay-canvas ~300 KB).
 * @param dsn - Sentry DSN
 */
export async function initializeSentry(dsn: string): Promise<void> {
  // Don't initialize if DSN is empty
  if (!dsn) {
    console.log('Sentry DSN is empty, skipping initialization');
    return;
  }

  // If Sentry was already initialized once, just re-enable it
  if (isInitialized && sentryInstance) {
    console.log('Sentry already initialized, re-enabling');
    const client = sentryInstance.getClient();
    if (client) {
      client.getOptions().enabled = true;
    }
    isEnabled = true;
    return;
  }

  try {
    // Named imports let the bundler tree-shake unused Sentry modules
    // (replay, feedback, replay-canvas) that are re-exported from @sentry/browser.
    const {
      init,
      getClient,
      browserTracingIntegration,
      captureException,
      captureMessage,
      setUser,
    } = await import('@sentry/react');

    sentryInstance = { init, getClient, browserTracingIntegration, captureException, captureMessage, setUser };

    // Initialize Sentry
    init({
      dsn,
      integrations: [
        browserTracingIntegration(),
      ],
      // Disable default integrations that pull in large optional dependencies.
      // Replay and feedback are re-exported by @sentry/browser but we don't use them.
      defaultIntegrations: undefined,
      // Performance Monitoring
      tracesSampleRate: 0.1, // Capture 10% of transactions for performance monitoring
      // Environment
      environment: import.meta.env.MODE,
      // Release
      release: import.meta.env.VERSION,
      // Censor sensitive data before sending to Sentry
      beforeSend(event) {
        // Regex to match Nostr nsec private keys
        const NSEC_REGEX = /nsec1[023456789acdefghjklmnpqrstuvwxyz]{58}/g;

        /** Recursively censors sensitive values in any value (string, object, array, etc.) */
        function censorSensitiveData(value: unknown): unknown {
          if (typeof value === 'string') {
            return value
              .replace(NSEC_REGEX, 'nsec1**********************************************************');
          }
          if (Array.isArray(value)) {
            return value.map(censorSensitiveData);
          }
          if (value && typeof value === 'object') {
            const result: Record<string, unknown> = {};
            for (const [key, val] of Object.entries(value)) {
              result[key] = censorSensitiveData(val);
            }
            return result;
          }
          return value;
        }

        /** Censors sensitive values from Sentry events before sending */
        function censorSensitiveValues<T extends SentryEvent>(event: T): T | null {
          return censorSensitiveData(event) as T;
        }

        return censorSensitiveValues(event);
      },
    });

    isInitialized = true;
    isEnabled = true;
    console.log('Sentry initialized successfully');
  } catch (error) {
    console.error('Failed to initialize Sentry:', error);
    throw error;
  }
}

/**
 * Disables Sentry by setting enabled to false.
 * The SDK stays loaded but stops sending events,
 * allowing re-enabling without re-initialization.
 */
export async function disableSentry(): Promise<void> {
  if (!isInitialized || !sentryInstance || !isEnabled) {
    return;
  }

  try {
    const client = sentryInstance.getClient();
    if (client) {
      client.getOptions().enabled = false;
    }
    isEnabled = false;
    console.log('Sentry disabled successfully');
  } catch (error) {
    console.error('Failed to disable Sentry:', error);
  }
}

/**
 * Checks if Sentry is currently initialized and enabled.
 */
export function isSentryInitialized(): boolean {
  return isInitialized && isEnabled;
}

/**
 * Gets the Sentry instance (if initialized and enabled).
 * Returns null if Sentry was never loaded or is disabled.
 */
export function getSentryInstance(): SentryLike | null {
  if (!isEnabled) return null;
  return sentryInstance;
}