@oobit/react-native-sdk 1.0.6 → 1.1.0

package/src/biometricUtils.ts

@@ -1,183 +0,0 @@
-/**
- * Biometric Authentication Utilities
- *
- * Provides cross-platform biometric authentication for card details access.
- * Uses expo-local-authentication which works in Expo Go without native modules.
- *
- * @requires expo-local-authentication - included in Expo SDK
- */
-
-import * as LocalAuthentication from 'expo-local-authentication';
-
-/**
- * Result of a biometric authentication attempt
- */
-export interface BiometricResult {
-  /** Whether authentication was successful */
-  success: boolean;
-  /** Error details if authentication failed */
-  error?: {
-    reason: 'cancelled' | 'failed' | 'not_available' | 'not_enrolled';
-    message?: string;
-  };
-}
-
-/**
- * Information about biometric capabilities on the device
- */
-export interface BiometricAvailability {
-  /** Whether any biometric authentication is available */
-  available: boolean;
-  /** The types of biometry available */
-  biometryTypes: LocalAuthentication.AuthenticationType[];
-}
-
-/**
- * Checks if biometric authentication is available on the device
- *
- * @returns Object containing availability status and biometry types
- */
-export async function isBiometricAvailable(): Promise<BiometricAvailability> {
-  try {
-    const hasHardware = await LocalAuthentication.hasHardwareAsync();
-    const isEnrolled = await LocalAuthentication.isEnrolledAsync();
-    const supportedTypes = await LocalAuthentication.supportedAuthenticationTypesAsync();
-
-    return {
-      available: hasHardware && isEnrolled,
-      biometryTypes: supportedTypes,
-    };
-  } catch (error) {
-    console.error('[BiometricUtils] Error checking biometric availability:', error);
-    return {
-      available: false,
-      biometryTypes: [],
-    };
-  }
-}
-
-/**
- * Prompts the user for biometric authentication
- *
- * This function should be called before generating session credentials
- * for viewing card details. It ensures proper user verification before
- * accessing sensitive payment card information.
- *
- * @param promptMessage - Message to display in the biometric prompt
- * @returns Result indicating success or failure with reason
- *
- * @example
- * ```typescript
- * const result = await authenticateWithBiometrics('Authenticate to view card details');
- * if (result.success) {
- *   // Proceed with generating session credentials
- * } else {
- *   // Handle failure based on result.error.reason
- * }
- * ```
- */
-export async function authenticateWithBiometrics(
-  promptMessage: string = 'Authenticate to view card details'
-): Promise<BiometricResult> {
-  try {
-    // First check if biometrics are available
-    const hasHardware = await LocalAuthentication.hasHardwareAsync();
-
-    if (!hasHardware) {
-      console.log('[BiometricUtils] Biometrics not available on device');
-      return {
-        success: false,
-        error: {
-          reason: 'not_available',
-          message: 'Biometric authentication is not available on this device',
-        },
-      };
-    }
-
-    // Check if biometrics are enrolled
-    const isEnrolled = await LocalAuthentication.isEnrolledAsync();
-
-    if (!isEnrolled) {
-      console.log('[BiometricUtils] No biometrics enrolled');
-      return {
-        success: false,
-        error: {
-          reason: 'not_enrolled',
-          message: 'No biometric authentication is set up on this device',
-        },
-      };
-    }
-
-    console.log('[BiometricUtils] Attempting biometric authentication...');
-
-    // Perform the biometric authentication
-    const result = await LocalAuthentication.authenticateAsync({
-      promptMessage,
-      cancelLabel: 'Cancel',
-      disableDeviceFallback: false, // Allow PIN/password fallback
-      fallbackLabel: 'Use Passcode',
-    });
-
-    if (result.success) {
-      console.log('[BiometricUtils] Biometric authentication successful');
-      return { success: true };
-    }
-
-    // Handle various failure reasons
-    console.log('[BiometricUtils] Biometric authentication failed:', result.error);
-
-    let reason: 'cancelled' | 'failed' | 'not_available' | 'not_enrolled' = 'failed';
-
-    if (result.error === 'user_cancel' || result.error === 'system_cancel') {
-      reason = 'cancelled';
-    } else if (result.error === 'not_enrolled') {
-      reason = 'not_enrolled';
-    } else if (result.error === 'not_available') {
-      reason = 'not_available';
-    }
-
-    return {
-      success: false,
-      error: {
-        reason,
-        message: result.warning || 'Authentication failed',
-      },
-    };
-  } catch (error) {
-    console.error('[BiometricUtils] Biometric authentication error:', error);
-
-    const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
-
-    return {
-      success: false,
-      error: {
-        reason: 'failed',
-        message: errorMessage,
-      },
-    };
-  }
-}
-
-/**
- * Gets a user-friendly description of the biometric type
- *
- * @param biometryType - The biometry type from the device
- * @returns Human-readable string for the biometry type
- */
-export function getBiometryTypeLabel(
-  biometryType: LocalAuthentication.AuthenticationType
-): string {
-  switch (biometryType) {
-    case LocalAuthentication.AuthenticationType.FACIAL_RECOGNITION:
-      return 'Face ID';
-    case LocalAuthentication.AuthenticationType.FINGERPRINT:
-      return 'Touch ID';
-    case LocalAuthentication.AuthenticationType.IRIS:
-      return 'Iris';
-    default:
-      return 'Biometric Authentication';
-  }
-}
-
-// Re-export AuthenticationType for convenience
-export { AuthenticationType } from 'expo-local-authentication';