feat: add configurable biometric authentication policies for SecureCredentialsManager

[subhankarmaiti]

Changes

This PR introduces configurable biometric authentication policies for SecureCredentialsManager, allowing developers to control when biometric prompts are shown when accessing stored credentials. This enhancement improves user experience by reducing authentication friction while maintaining security.

References

auth0/react-native-auth0#687 (comment)

Testing

1. Run the included unit tests: ./gradlew :auth0:testDebugUnitTest --tests "*BiometricPolicyTest"
2. Use the sample app to test different policies:
   • Always Policy: Biometric prompt appears every time
   • Session Policy (5 min): Prompt appears once, then cached for 5 minutes
   • AppLifecycle Policy: Prompt appears once until app restart or manual clear

• This change adds unit test coverage
• This change adds integration test coverage
• This change has been tested on the latest version of the platform/language or why not

Checklist

• I have read the Auth0 general contribution guidelines
• I have read the Auth0 Code of Conduct
• All existing and new tests complete without errors

[Copilot]

Pull Request Overview

This PR adds configurable biometric authentication policies to SecureCredentialsManager, allowing developers to control when biometric prompts are shown based on different authentication strategies (Always, Session-based, or App Lifecycle-based).

Key changes:

• Introduction of BiometricPolicy sealed class with three policy types
• Enhanced LocalAuthenticationOptions to include policy configuration
• Session management functionality in SecureCredentialsManager

Reviewed Changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
BiometricPolicy.kt	New sealed class defining three biometric authentication policies
LocalAuthenticationOptions.kt	Added policy parameter and builder method for biometric policy configuration
SecureCredentialsManager.kt	Integrated session validation logic and biometric session management
SecureCredentialsManagerBiometricPolicyTest.kt	Comprehensive test coverage for new biometric policy functionality
EXAMPLES.md	Updated documentation with examples and explanations of BiometricPolicy usage

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Copilot]

Pull Request Overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.