@umituz/react-native-sentry 1.2.1 → 1.3.0

package/README.md

@@ -73,6 +73,25 @@ function MyComponent() {
 }
 ```
 
+### Test Helpers (Production/TestFlight)
+
+Verify Sentry is working in production builds:
+
+```typescript
+import { sendTestError, sendTestMessage, runTestSuite } from '@umituz/react-native-sentry';
+
+// Send a single test error
+sendTestError();
+
+// Send a test message
+sendTestMessage();
+
+// Run complete test suite
+runTestSuite('user-123');
+```
+
+Add a debug button in your app (e.g., Settings screen) to trigger these tests in TestFlight builds.
+
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-sentry",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Production-ready error tracking and performance monitoring for React Native apps",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
@@ -48,4 +48,4 @@
     "README.md",
     "LICENSE"
   ]
-}
+}

package/src/domain/value-objects/ErrorMetadata.ts

@@ -8,6 +8,7 @@ export interface UserData {
   email?: string;
   username?: string;
   ipAddress?: string;
+  extras?: Record<string, any>;
 }
 
 export interface ErrorTags {

package/src/global.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Global type declarations for React Native environment
+ */
+
+declare const __DEV__: boolean;
+
+declare const console: {
+    log(...args: any[]): void;
+    warn(...args: any[]): void;
+    error(...args: any[]): void;
+    info(...args: any[]): void;
+    debug(...args: any[]): void;
+};

package/src/index.ts

@@ -45,3 +45,11 @@ export {
   trackPackageEvent,
 } from './presentation/utils/sentryTracking';
 export type { PackageErrorContext } from './presentation/utils/sentryTracking';
+
+// Test Helpers (for verifying Sentry in production/TestFlight)
+export {
+  sendTestError,
+  sendTestMessage,
+  setTestUser,
+  runTestSuite,
+} from './presentation/utils/testHelpers';

package/src/infrastructure/adapters/native-sentry.adapter.ts

@@ -4,6 +4,7 @@
  */
 
 import * as Sentry from '@sentry/react-native';
+import type { SeverityLevel } from '@sentry/types';
 import type { SentryConfig } from '../../domain/entities/SentryConfig';
 import type { UserData, Breadcrumb } from '../../domain/value-objects/ErrorMetadata';
 import type { CaptureMetadata, MessageLevel } from '../../application/ports/ISentryClient';
@@ -39,20 +40,10 @@ export const nativeSentryAdapter: NativeSentryAdapter = {
       debug: config.debug ?? false,
       enableAutoPerformanceTracing: true,
       enableNativeCrashHandling: true,
-
-      // Session Replay
-      replaysSessionSampleRate: config.replaysSessionSampleRate ?? 0.1,
-      replaysOnErrorSampleRate: config.replaysOnErrorSampleRate ?? 1.0,
       integrations: integrations.length > 0 ? integrations : undefined,
-
-      // Logs
-      enableLogs: config.enableLogs ?? false,
-
-      // PII
       sendDefaultPii: config.sendDefaultPii ?? false,
 
-      beforeSend: (event) => {
-        // Privacy: Mask email in production unless sendDefaultPii is true
+      beforeSend: (event: any) => {
         if (!__DEV__ && !config.sendDefaultPii && event.user?.email) {
           event.user.email = '***@***.***';
         }
@@ -71,7 +62,7 @@ export const nativeSentryAdapter: NativeSentryAdapter = {
 
   captureMessage(message: string, level?: MessageLevel, metadata?: CaptureMetadata): string | undefined {
     return Sentry.captureMessage(message, {
-      level: level as Sentry.SeverityLevel,
+      level: level as SeverityLevel,
       tags: metadata?.tags,
       extra: metadata?.extra,
       user: metadata?.user,
@@ -82,7 +73,7 @@ export const nativeSentryAdapter: NativeSentryAdapter = {
     Sentry.addBreadcrumb({
       message: breadcrumb.message,
       category: breadcrumb.category,
-      level: breadcrumb.level as Sentry.SeverityLevel,
+      level: breadcrumb.level as SeverityLevel,
       data: breadcrumb.data,
       timestamp: breadcrumb.timestamp,
     });

package/src/presentation/utils/testHelpers.ts

@@ -0,0 +1,164 @@
+/**
+ * Sentry Test Helpers
+ * Utilities for testing Sentry integration in production/TestFlight
+ */
+
+import { SentryClient } from '../../infrastructure/config/SentryClient';
+
+/**
+ * Send test error to Sentry
+ * Use this to verify Sentry is working in production builds
+ *
+ * @example
+ * import { sendTestError } from '@umituz/react-native-sentry';
+ * sendTestError(); // In a debug button
+ */
+export function sendTestError(): void {
+    if (!SentryClient.isInitialized()) {
+        /* eslint-disable-next-line no-console */
+        if (__DEV__) {
+            console.warn('[Sentry Test] Not initialized, cannot send test error');
+        }
+        return;
+    }
+
+    try {
+        SentryClient.addBreadcrumb({
+            category: 'test',
+            message: 'Test breadcrumb added',
+            level: 'info',
+            data: { timestamp: new Date().toISOString() },
+        });
+
+        const error = new Error(
+            `[TEST] Sentry verification - ${new Date().toISOString()}`
+        );
+        SentryClient.captureException(error, {
+            tags: { test: 'true', type: 'verification' },
+            extra: { purpose: 'Testing Sentry integration', timestamp: Date.now() },
+        });
+
+        /* eslint-disable-next-line no-console */
+        if (__DEV__) {
+            console.log('✅ Test error sent to Sentry');
+        }
+    } catch (error) {
+        /* eslint-disable-next-line no-console */
+        if (__DEV__) {
+            console.error('[Sentry Test] Failed to send test error:', error);
+        }
+    }
+}
+
+/**
+ * Send test message to Sentry
+ * Lighter alternative to sendTestError for verification
+ *
+ * @example
+ * import { sendTestMessage } from '@umituz/react-native-sentry';
+ * sendTestMessage();
+ */
+export function sendTestMessage(): void {
+    if (!SentryClient.isInitialized()) {
+        /* eslint-disable-next-line no-console */
+        if (__DEV__) {
+            console.warn('[Sentry Test] Not initialized, cannot send test message');
+        }
+        return;
+    }
+
+    try {
+        const message = `[TEST] Sentry message verification - ${new Date().toISOString()}`;
+        SentryClient.captureMessage(message, 'info', {
+            tags: { test: 'true', type: 'message' },
+            extra: { timestamp: Date.now() },
+        });
+
+        /* eslint-disable-next-line no-console */
+        if (__DEV__) {
+            console.log('✅ Test message sent to Sentry');
+        }
+    } catch (error) {
+        /* eslint-disable-next-line no-console */
+        if (__DEV__) {
+            console.error('[Sentry Test] Failed to send test message:', error);
+        }
+    }
+}
+
+/**
+ * Set test user context
+ * Verify user tracking is working
+ *
+ * @param userId - User ID to test with
+ *
+ * @example
+ * import { setTestUser } from '@umituz/react-native-sentry';
+ * setTestUser('test-user-123');
+ */
+export function setTestUser(userId: string): void {
+    if (!SentryClient.isInitialized()) {
+        /* eslint-disable-next-line no-console */
+        if (__DEV__) {
+            console.warn('[Sentry Test] Not initialized, cannot set test user');
+        }
+        return;
+    }
+
+    try {
+        SentryClient.setUser({
+            id: userId,
+            extras: {
+                testMode: true,
+                testTimestamp: new Date().toISOString(),
+            },
+        });
+
+        /* eslint-disable-next-line no-console */
+        if (__DEV__) {
+            console.log('✅ Test user set in Sentry:', userId);
+        }
+    } catch (error) {
+        /* eslint-disable-next-line no-console */
+        if (__DEV__) {
+            console.error('[Sentry Test] Failed to set test user:', error);
+        }
+    }
+}
+
+/**
+ * Send comprehensive test suite
+ * Tests breadcrumbs, user context, message and error tracking
+ *
+ * @param userId - Optional user ID for testing user context
+ *
+ * @example
+ * import { runTestSuite } from '@umituz/react-native-sentry';
+ * runTestSuite('user-123');
+ */
+export function runTestSuite(userId?: string): void {
+    if (!SentryClient.isInitialized()) {
+        /* eslint-disable-next-line no-console */
+        if (__DEV__) {
+            console.warn('[Sentry Test] Not initialized, cannot run test suite');
+        }
+        return;
+    }
+
+    /* eslint-disable-next-line no-console */
+    if (__DEV__) {
+        console.log('🧪 Running Sentry test suite...');
+    }
+
+    if (userId) {
+        setTestUser(userId);
+    }
+
+    sendTestMessage();
+    sendTestError();
+
+    /* eslint-disable-next-line no-console */
+    if (__DEV__) {
+        console.log('✅ Sentry test suite completed. Check Sentry dashboard.');
+    }
+}