@trustchex/react-native-sdk 1.250.0 → 1.266.0

package/README.md

@@ -13,6 +13,7 @@ React Native SDK for KYC and identity verification with document scanning, facia
 - 🌐 Multi-language support (English, Turkish)
 - 🎨 Customizable branding
 - 🔗 Deep link support
+- 📊 **Privacy-compliant analytics** (GDPR, KVKK, PCI-DSS)
 
 ## Installation
 
@@ -33,7 +34,6 @@ npm install @react-native-community/image-editor@^4.3.0 \
   react-native-gesture-handler@^2.27.1 \
   react-native-get-random-values@^1.11.0 \
   react-native-nfc-manager@^3.16.2 \
-  react-native-paper@^5.14.5 \
   react-native-safe-area-context@^5.5.2 \
   react-native-screens@^4.13.1 \
   react-native-svg@^15.12.0 \
@@ -53,7 +53,6 @@ module.exports = {
   presets: ['module:@react-native/babel-preset'],
   plugins: [
     'react-native-worklets-core/plugin',
-    'react-native-paper/babel',
   ],
 };
 ```
@@ -182,11 +181,29 @@ import Trustchex from '@trustchex/react-native-sdk';
     tertiaryColor: '#EF4444'
   }}
   locale="en" // 'en' | 'tr'
+  enableAnalytics={true}
   onCompleted={() => console.log('Completed')}
   onError={(error) => console.error(error)}
 />
 ```
 
+### With Custom Analytics Tracking
+
+```tsx
+import {
+  trackButtonClick,
+  trackScreenView,
+  analyticsService
+} from '@trustchex/react-native-sdk';
+
+// Track custom events
+await trackButtonClick('custom_button', 'custom_screen');
+await trackScreenView('custom_screen');
+
+// Access analytics service directly
+await analyticsService.clear(); // Right to be forgotten
+```
+
 ### Deep Links
 
 ```tsx
@@ -205,9 +222,33 @@ const [baseUrl, sessionId] = handleDeepLink({
 | `sessionId` | `string?` | Verification session ID |
 | `branding` | `object?` | Theme colors and logo |
 | `locale` | `'en' \| 'tr'?` | UI language |
+| `enableAnalytics` | `boolean?` | Enable analytics (default: `true`) |
 | `onCompleted` | `function?` | Success callback |
 | `onError` | `function?` | Error callback |
 
+## Analytics
+
+The SDK includes **privacy-compliant analytics** that respects GDPR, KVKK, and PCI-DSS regulations.
+
+### Key Features
+
+- ✅ **No PII collected** - No names, emails, addresses, or personal data
+- ✅ **Data anonymization** - Device identifiers excluded
+- ✅ **Right to deletion** - Users can clear their data
+
+### Usage
+
+Analytics is enabled by default. To customize:
+
+```tsx
+<Trustchex
+  enableAnalytics={true}           // Enable/disable analytics
+  {...otherProps}
+/>
+```
+
+For complete analytics documentation, see [ANALYTICS.md](./ANALYTICS.md).
+
 ## Requirements
 
 - React Native ≥ 0.79.5

package/android/src/main/java/com/trustchex/reactnativesdk/DeviceBrightnessModule.kt

@@ -0,0 +1,66 @@
+package com.trustchex.reactnativesdk
+
+import android.app.Activity
+import android.provider.Settings
+import android.view.WindowManager
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
+
+class DeviceBrightnessModule(reactContext: ReactApplicationContext) :
+  ReactContextBaseJavaModule(reactContext) {
+
+  override fun getName(): String {
+    return "DeviceBrightness"
+  }
+
+  @ReactMethod
+  fun getBrightness(promise: Promise) {
+    try {
+      val activity: Activity? = currentActivity
+      if (activity == null) {
+        promise.reject("ERROR", "Activity is null")
+        return
+      }
+
+      val brightness = activity.window.attributes.screenBrightness
+      if (brightness < 0) {
+        // Return system brightness if window brightness is not set
+        val systemBrightness = Settings.System.getInt(
+          activity.contentResolver,
+          Settings.System.SCREEN_BRIGHTNESS
+        ) / 255.0f
+        promise.resolve(systemBrightness.toDouble())
+      } else {
+        promise.resolve(brightness.toDouble())
+      }
+    } catch (e: Exception) {
+      promise.reject("ERROR", e.message)
+    }
+  }
+
+  @ReactMethod
+  fun setBrightness(brightness: Double, promise: Promise) {
+    try {
+      val activity: Activity? = currentActivity
+      if (activity == null) {
+        promise.reject("ERROR", "Activity is null")
+        return
+      }
+
+      activity.runOnUiThread {
+        try {
+          val layoutParams = activity.window.attributes
+          layoutParams.screenBrightness = brightness.toFloat()
+          activity.window.attributes = layoutParams
+          promise.resolve(null)
+        } catch (e: Exception) {
+          promise.reject("ERROR", e.message)
+        }
+      }
+    } catch (e: Exception) {
+      promise.reject("ERROR", e.message)
+    }
+  }
+}

package/android/src/main/java/com/trustchex/reactnativesdk/TrustchexSDKPackage.kt

@@ -36,6 +36,7 @@ class TrustchexSDKPackage : BaseReactPackage() {
   override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? {
     return when (name) {
       TrustchexSDKModule.NAME -> TrustchexSDKModule(reactContext)
+      "DeviceBrightness" -> DeviceBrightnessModule(reactContext)
       else -> null
     }
   }
@@ -55,6 +56,17 @@ class TrustchexSDKPackage : BaseReactPackage() {
                       true // isTurboModule
               )
 
+      // Device brightness module
+      moduleInfos["DeviceBrightness"] =
+              ReactModuleInfo(
+                      "DeviceBrightness",
+                      "DeviceBrightness",
+                      false, // canOverrideExistingModule
+                      false, // needsEagerInit
+                      false, // isCxxModule
+                      false // isTurboModule
+              )
+
       moduleInfos
     }
   }

package/ios/DeviceBrightnessModule.h

@@ -0,0 +1,4 @@
+#import <React/RCTBridgeModule.h>
+
+@interface DeviceBrightnessModule : NSObject <RCTBridgeModule>
+@end

package/ios/DeviceBrightnessModule.m

@@ -0,0 +1,27 @@
+#import "DeviceBrightnessModule.h"
+#import <UIKit/UIKit.h>
+
+@implementation DeviceBrightnessModule
+
+RCT_EXPORT_MODULE(DeviceBrightness);
+
+RCT_EXPORT_METHOD(getBrightness:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+{
+  dispatch_async(dispatch_get_main_queue(), ^{
+    CGFloat brightness = [UIScreen mainScreen].brightness;
+    resolve(@(brightness));
+  });
+}
+
+RCT_EXPORT_METHOD(setBrightness:(double)brightness
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+{
+  dispatch_async(dispatch_get_main_queue(), ^{
+    [UIScreen mainScreen].brightness = brightness;
+    resolve(nil);
+  });
+}
+
+@end

package/lib/module/Screens/Dynamic/ContractAcceptanceScreen.js

@@ -9,6 +9,7 @@ import { getI18n, useTranslation } from 'react-i18next';
 import StyledButton from "../../Shared/Components/StyledButton.js";
 import NativeDeviceInfo from "../../Shared/Libs/native-device-info.utils.js";
 import { speakWithDebounce } from "../../Shared/Libs/tts.utils.js";
+import { trackFunnelStep, useScreenTracking, trackConsentGiven, trackVerificationStart, trackVerificationComplete, trackError } from "../../Shared/Libs/analytics.utils.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const ContractAcceptanceScreen = () => {
   const [isEnabled, setIsEnabled] = useState(false);
@@ -21,6 +22,9 @@ const ContractAcceptanceScreen = () => {
   const {
     t
   } = useTranslation();
+
+  // Track screen view and exit
+  useScreenTracking('contract_acceptance');
   useEffect(() => {
     const contracts = appContext.currentWorkflowStep?.data?.contracts;
     if (!contracts) {
@@ -70,9 +74,21 @@ const ContractAcceptanceScreen = () => {
       scalesPageToFit: false,
       scrollEnabled: true,
       style: styles.webView,
+      onError: syntheticEvent => {
+        const {
+          nativeEvent
+        } = syntheticEvent;
+        trackError('CONTRACT_WEBVIEW_ERROR', nativeEvent.description || 'Failed to load contract', 'contract_acceptance', 'medium', {
+          recoverable: true,
+          userAction: 'load_contract'
+        });
+      },
       onLoadEnd: event => {
         if (event.nativeEvent.url === contractUrl) {
           setIsReady(true);
+
+          // Track contract acceptance started
+          trackVerificationStart('CONTRACT_ACCEPTANCE');
           if (appContext.currentWorkflowStep?.data?.voiceGuidanceActive) {
             speakWithDebounce(t('termsOfUseAndDataPrivacyScreen.footerText'));
           }
@@ -107,6 +123,15 @@ const ContractAcceptanceScreen = () => {
             // Update the context with the new device info
             appContext.identificationInfo.consent = consent;
           }
+
+          // Track contract acceptance completed
+          trackVerificationComplete('CONTRACT_ACCEPTANCE', true, 1);
+
+          // Track contract acceptance as funnel event
+          trackConsentGiven(consent.contractIds, 'contract_acceptance');
+
+          // Track contract acceptance as funnel step
+          trackFunnelStep('Contract Accepted', 1, 5, 'session_start', true);
           navigationManagerRef.current?.navigateToNextStep();
         },
         children: t('termsOfUseAndDataPrivacyScreen.acceptAndContinue')

package/lib/module/Screens/Dynamic/IdentityDocumentEIDScanningScreen.js

@@ -7,6 +7,7 @@ import NavigationManager from "../../Shared/Components/NavigationManager.js";
 import AppContext from "../../Shared/Contexts/AppContext.js";
 import IdentityDocumentCamera from "../../Shared/Components/IdentityDocumentCamera.js";
 import { useTranslation } from 'react-i18next';
+import { trackFunnelStep, useScreenTracking, trackVerificationStart, trackVerificationComplete } from "../../Shared/Libs/analytics.utils.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const IdentityDocumentEIDScanningScreen = () => {
   const appContext = useContext(AppContext);
@@ -24,6 +25,14 @@ const IdentityDocumentEIDScanningScreen = () => {
   } = useTranslation();
   const [allowedDocumentTypes, setAllowedDocumentTypes] = useState(null);
   const [allowedCountries, setAllowedCountries] = useState(null);
+
+  // Track screen view and exit
+  useScreenTracking('nfc_scanning');
+
+  // Track EID scan step started when component mounts
+  useEffect(() => {
+    trackVerificationStart('IDENTITY_DOCUMENT_EID_SCAN');
+  }, []);
   useEffect(() => {
     if (appContext.identificationInfo.scannedDocument?.mrzFields) {
       const {
@@ -73,6 +82,8 @@ const IdentityDocumentEIDScanningScreen = () => {
             if (allowedCountries && allowedCountries.length > 0) {
               const countryCode = mrzFields.issuingState;
               if (!allowedCountries.includes(countryCode)) {
+                // Workflow validation - user's document country not in allowed list
+                // Expected behavior, not a bug
                 Alert.alert(t('general.error'), t('general.countryNotAllowed'));
                 appContext.onError?.(t('general.countryNotAllowed'));
                 navigationManagerRef.current?.reset();
@@ -82,12 +93,20 @@ const IdentityDocumentEIDScanningScreen = () => {
             if (allowedDocumentTypes && allowedDocumentTypes.length > 0) {
               const documentCode = mrzFields.documentCode;
               if (!allowedDocumentTypes.includes(documentCode)) {
+                // Workflow validation - user's document type not in allowed list
+                // Expected behavior, not a bug
                 Alert.alert(t('general.error'), t('general.documentTypeNotAllowed'));
                 appContext.onError?.(t('general.documentTypeNotAllowed'));
                 navigationManagerRef.current?.reset();
                 return;
               }
             }
+
+            // Track successful EID step completion
+            trackVerificationComplete('IDENTITY_DOCUMENT_EID_SCAN', true, 1);
+
+            // Track successful NFC completion as funnel step
+            trackFunnelStep('NFC Scan Completed', 4, 5, 'liveness_detection', true);
             navigationManagerRef.current?.navigateToNextStep();
           }
         },

package/lib/module/Screens/Dynamic/IdentityDocumentScanningScreen.js

@@ -6,6 +6,7 @@ import IdentityDocumentCamera from "../../Shared/Components/IdentityDocumentCame
 import AppContext from "../../Shared/Contexts/AppContext.js";
 import NavigationManager from "../../Shared/Components/NavigationManager.js";
 import { useTranslation } from 'react-i18next';
+import { trackFunnelStep, useScreenTracking, trackVerificationStart, trackVerificationComplete } from "../../Shared/Libs/analytics.utils.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const IdentityDocumentScanningScreen = () => {
   const [idFrontSideData, setIDFrontSideData] = useState(null);
@@ -18,6 +19,14 @@ const IdentityDocumentScanningScreen = () => {
   } = useTranslation();
   const [allowedDocumentTypes, setAllowedDocumentTypes] = useState(null);
   const [allowedCountries, setAllowedCountries] = useState(null);
+
+  // Track screen view and exit
+  useScreenTracking('document_scanning');
+
+  // Track document scan started when component mounts
+  useEffect(() => {
+    trackVerificationStart('IDENTITY_DOCUMENT_SCAN');
+  }, []);
   useEffect(() => {
     if ((idFrontSideData && idBackSideData || passportData) && appContext.identificationInfo && !appContext.identificationInfo.scannedDocument) {
       appContext.identificationInfo.scannedDocument = {
@@ -40,6 +49,8 @@ const IdentityDocumentScanningScreen = () => {
       if (allowedCountries && allowedCountries.length > 0) {
         const countryCode = mrzFields.issuingState;
         if (!allowedCountries.includes(countryCode)) {
+          // Workflow validation - user's document country not in allowed list
+          // Expected behavior, not a bug
           Alert.alert(t('general.error'), t('general.countryNotAllowed'));
           appContext.onError?.(t('general.countryNotAllowed'));
           navigationManagerRef.current?.reset();
@@ -49,12 +60,20 @@ const IdentityDocumentScanningScreen = () => {
       if (allowedDocumentTypes && allowedDocumentTypes.length > 0) {
         const documentCode = mrzFields.documentCode;
         if (!allowedDocumentTypes.includes(documentCode)) {
+          // Workflow validation - user's document type not in allowed list
+          // Expected behavior, not a bug
           Alert.alert(t('general.error'), t('general.documentTypeNotAllowed'));
           appContext.onError?.(t('general.documentTypeNotAllowed'));
           navigationManagerRef.current?.reset();
           return;
         }
       }
+
+      // Track successful document scan completion
+      trackVerificationComplete('IDENTITY_DOCUMENT_SCAN', true, 1);
+
+      // Track successful document scan completion as funnel step
+      trackFunnelStep('Document Scan Completed', 2, 5, 'contract_acceptance', true);
       setTimeout(() => navigationManagerRef.current?.navigateToNextStep(), 1000);
     }
   }, [idFrontSideData, idBackSideData, passportData, appContext.identificationInfo, allowedCountries, allowedDocumentTypes, t, appContext]);

package/lib/module/Screens/Dynamic/LivenessDetectionScreen.js

@@ -13,6 +13,7 @@ import { useTranslation } from 'react-i18next';
 import StyledButton from "../../Shared/Components/StyledButton.js";
 import LottieView from 'lottie-react-native';
 import { speakWithDebounce } from "../../Shared/Libs/tts.utils.js";
+import { trackFunnelStep, useScreenTracking, trackVerificationStart, trackVerificationComplete } from "../../Shared/Libs/analytics.utils.js";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 const {
   width: windowWidth,
@@ -37,6 +38,9 @@ const LivenessDetectionScreen = () => {
     t
   } = useTranslation();
   const [isRecording, setIsRecording] = useState(false);
+
+  // Track screen view and exit
+  useScreenTracking('liveness_detection');
   const [initialState, setInitialState] = useState({
     brightnessLow: false,
     faceDetected: false,
@@ -109,15 +113,18 @@ const LivenessDetectionScreen = () => {
       try {
         await camera?.cancelRecording();
         setIsRecording(false);
-      } catch (e) {
-        // Ignore error
+      } catch (error) {
+        // User cancelled recording - expected behavior, no need to track
       }
     }
     setTimeout(() => {
+      // Track liveness check started
+      trackVerificationStart('LIVENESS_CHECK');
       camera?.startRecording({
         fileType: 'mp4',
         videoCodec: 'h265',
         onRecordingError() {
+          // Recording errors are retried automatically, no need to track them
           setIsRecording(false);
         },
         onRecordingFinished(video) {
@@ -126,6 +133,10 @@ const LivenessDetectionScreen = () => {
               type: 'VIDEO_RECORDED',
               payload: video.path
             });
+
+            // Track liveness check completion
+            trackVerificationComplete('LIVENESS_CHECK', true, 1);
+            trackFunnelStep('Liveness Check Completed', 3, 5, 'document_scanning', true);
             setIsRecording(false);
           }, 500);
         }
@@ -137,8 +148,9 @@ const LivenessDetectionScreen = () => {
     try {
       await camera?.stopRecording();
       setIsRecording(false);
-    } catch (e) {
-      // Ignore error
+    } catch (error) {
+      // Stop recording can fail due to race conditions when user navigates away
+      // This is expected behavior and not actionable
     }
   }, [camera]);
   const areEyesOpen = face => face.leftEyeOpenProbability >= 0.8 && face.rightEyeOpenProbability >= 0.8;
@@ -425,7 +437,8 @@ const LivenessDetectionScreen = () => {
     }) : /*#__PURE__*/_jsxs(_Fragment, {
       children: [/*#__PURE__*/_jsx(FaceCamera, {
         onFacesDetected: onFacesDetected,
-        onCameraInitialized: setCamera
+        onCameraInitialized: setCamera,
+        previewRect: PREVIEW_RECT
       }), /*#__PURE__*/_jsx(NativeCircularProgress, {
         style: styles.circularProgress,
         size: PREVIEW_SIZE,

package/lib/module/Screens/Static/QrCodeScanningScreen.js

@@ -15,8 +15,16 @@ const QrCodeScanningScreen = () => {
       url: data
     });
     if (bUrl && sId) {
-      appContext.baseUrl = bUrl;
-      appContext.identificationInfo.sessionId = sId;
+      if (appContext.setBaseUrl) {
+        appContext.setBaseUrl(bUrl);
+      } else {
+        appContext.baseUrl = bUrl;
+      }
+      if (appContext.setSessionId) {
+        appContext.setSessionId(sId);
+      } else {
+        appContext.identificationInfo.sessionId = sId;
+      }
       navigation.navigate('VerificationSessionCheckScreen');
     }
   };

package/lib/module/Screens/Static/ResultScreen.js

@@ -16,6 +16,9 @@ import { encryptWithAes, getSessionKey } from "../../Shared/Libs/crypto.utils.js
 import Video from 'react-native-video';
 import StyledButton from "../../Shared/Components/StyledButton.js";
 import NativeDeviceInfo from "../../Shared/Libs/native-device-info.utils.js";
+import { trackError, trackFunnelStep, useScreenTracking } from "../../Shared/Libs/analytics.utils.js";
+import { analyticsService } from "../../Shared/Services/AnalyticsService.js";
+import { AnalyticsEventName, AnalyticsEventCategory } from "../../Shared/Types/analytics.types.js";
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 const ResultScreen = () => {
   const appContext = useContext(AppContext);
@@ -27,6 +30,9 @@ const ResultScreen = () => {
   const {
     t
   } = useTranslation();
+
+  // Track screen view and exit
+  useScreenTracking('result_screen');
   const apiUrl = useMemo(() => `${appContext.baseUrl}/api/app/mobile`, [appContext.baseUrl]);
   useEffect(() => {
     if (appContext.isDemoSession) {
@@ -117,7 +123,7 @@ const ResultScreen = () => {
       },
       files: [],
       progress: res => {
-        setProgress(40 + res.totalBytesSent / res.totalBytesExpectedToSend * 50);
+        setProgress(60 + res.totalBytesSent / res.totalBytesExpectedToSend * 30);
       }
     };
     const frontImage = scannedIdentityDocument?.frontImage;
@@ -202,11 +208,36 @@ const ResultScreen = () => {
           videoFilePath = `${RNFS.TemporaryDirectoryPath}/LIVENESS_VIDEO.mp4`;
         }
         await RNFS.copyFile(livenessVideoPath, videoFilePath);
-        await VideoCompressor.compress(videoFilePath);
+
+        // Get original file size
+        const originalStats = await RNFS.stat(videoFilePath);
+        const originalSize = originalStats.size;
+
+        // Compress video with maximum compression settings
+        const compressedVideoPath = await VideoCompressor.compress(videoFilePath, {
+          compressionMethod: 'manual',
+          bitrate: 500000,
+          // 500 kbps
+          maxSize: 1280,
+          // HD 720p
+          minimumFileSizeForCompress: 0 // Always compress
+        }, compressionProgress => {
+          // Map compression progress (0-1) to main progress (40-60%)
+          setProgress(40 + compressionProgress * 20);
+        });
+
+        // Convert file:// URI to regular path for RNFS upload
+        const normalizedPath = compressedVideoPath.replace('file://', '');
+
+        // Get compressed file size and log difference
+        const compressedStats = await RNFS.stat(normalizedPath);
+        const compressedSize = compressedStats.size;
+        const compressionRatio = ((originalSize - compressedSize) / originalSize * 100).toFixed(2);
+        console.log(`Video compression: ${(originalSize / 1024 / 1024).toFixed(2)}MB -> ${(compressedSize / 1024 / 1024).toFixed(2)}MB (${compressionRatio}% reduction)`);
         uploadFileOptions.files.push({
           name: 'files',
           filename: 'LIVENESS_VIDEO.mp4',
-          filepath: videoFilePath,
+          filepath: normalizedPath,
           filetype: 'video/mp4'
         });
       }
@@ -235,12 +266,30 @@ const ResultScreen = () => {
       setProgress(40);
       const livenessDetection = identificationInfo.livenessDetection;
       await runWithRetry(() => uploadIdentificationMedia(identificationId, scannedIdentityDocument, livenessDetection));
+      setProgress(90);
       await runWithRetry(() => finishIdentification(identificationId, sessionKey));
       setProgress(100);
       setIsSubmitting(false);
+
+      // Track successful verification completion as final funnel step
+      trackFunnelStep('Verification Completed', 5, 5, 'nfc_scanning', true).catch(() => {});
+      analyticsService.trackEvent(AnalyticsEventName.VERIFICATION_SUCCESS, AnalyticsEventCategory.VERIFICATION, {
+        sessionId: appContext.identificationInfo.sessionId || ''
+      }).catch(() => {});
     } catch (error) {
       setIsSubmitting(false);
       setProgress(0);
+
+      // Track verification failure
+      const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+      trackError('VERIFICATION_SUBMISSION_FAILED', errorMessage, 'result_screen', 'critical', {
+        recoverable: false,
+        userAction: 'submit_verification'
+      }).catch(() => {});
+      analyticsService.trackEvent(AnalyticsEventName.VERIFICATION_FAILED, AnalyticsEventCategory.VERIFICATION, {
+        sessionId: appContext.identificationInfo.sessionId || '',
+        errorMessage
+      }).catch(() => {});
       Alert.alert(t('general.error'), t('resultScreen.submissionFailed'));
       appContext.onError?.(t('resultScreen.submissionFailed'));
       navigationManagerRef.current?.reset();