This package provides a React Native module to determine if a user's biometric authentication settings (e.g., fingerprint, face ID) have changed on their device since the last check. This functionality is crucial for security-sensitive applications that need to re-authenticate users if their biometric credentials might have been altered, removed, or reset. As of version 0.1.1, it offers two primary functions: `checkBiometricAuthChanged` to detect if a change has occurred and `isBiometricAuthAvailable` to ascertain if biometric authentication is even configured on the device. Given its very low version number, it is in its early development stages, suggesting a potentially irregular release cadence as new features or bug fixes are implemented. It aims to provide a cross-platform (iOS and Android) solution specifically for biometric security change detection, differentiating itself by focusing on this aspect rather than general biometric authentication processes like prompting for a scan.
npm install react-native-check-biometric-auth-changedVerified import paths — ran on the pinned version, not inferred.
This quickstart demonstrates how to check if biometric authentication is available on the device and if the user's biometric settings have changed, alerting the user to re-authenticate if necessary for security reasons.
Use exact version pinning (e.g., `"react-native-check-biometric-auth-changed": "0.1.1"`) and manually review updates for breaking changes.
Refer to the source code (e.g., `src/index.ts` in the GitHub repository) or npm package contents to find the correct API exports and their usage.
Ensure you have run `pod install` in your `ios/` directory for iOS and rebuilt your Android project after installation. Avoid using Expo Go for development with native modules that aren't part of the Expo SDK.
Pair this library with a general biometric authentication library (e.g., `react-native-biometrics` or `expo-local-authentication`) if you also need to prompt the user for biometric verification.
For iOS, navigate to your `ios/` directory and run `pod install`. Rebuild your entire React Native application after installation (e.g., `npx react-native run-ios` or `npx react-native run-android`). If using Expo, ensure you are in a bare workflow or using a custom development client, not Expo Go.
Replace calls to `multiply` with the correct functions: `checkBiometricAuthChanged()` or `isBiometricAuthAvailable()`. Refer to the package's source code or its intended documentation for accurate API usage.