SDKS-4716: Add disaster recovery cleanup handling

[vibhorgoswami]

JIRA Ticket

SDKS-4716

Description

Add disaster recovery when opening the database when migrating Legacy auth data. This prevents the migration to fail when in disaster recovery.

Problem Scenario

When an app is uninstalled, database files may remain on the device. When the app is reinstalled with the same package name, the Android KeyStore generates a new encryption passphrase, making the old database files unreadable. This causes SQLCipher to throw SQLiteNotADatabaseException: file is not a database (code 26).

Solution

This function proactively checks if there is an existing database available and backup data or deletes any existing OATH and Push database files if they are unrecoverable before initializing new storage instances, ensuring a clean migration environment.

Database Files Cleaned

• pingidentity_oath.db - OATH/TOTP credentials database
• pingidentity_push.db - Push credentials, notifications, and device tokens database

[codecov]

Codecov Report

❌ Patch coverage is 0% with 215 lines in your changes missing coverage. Please review.
✅ Project coverage is 44.83%. Comparing base (cb96135) to head (13f85d2).
⚠️ Report is 1 commits behind head on develop.

Files with missing lines	Patch %	Lines
...tity/auth/migration/AuthenticatorMigrationSteps.kt	0.00%	166 Missing ⚠️
...ty/auth/migration/LegacyAuthenticatorRepository.kt	0.00%	44 Missing ⚠️
...n/com/pingidentity/auth/migration/AuthMigration.kt	0.00%	5 Missing ⚠️

Additional details and impacted files

@@              Coverage Diff              @@
##             develop     #166      +/-   ##
=============================================
- Coverage      45.60%   44.83%   -0.77%     
  Complexity      1228     1228              
=============================================
  Files            302      302              
  Lines           9186     9347     +161     
  Branches        1294     1346      +52     
=============================================
+ Hits            4189     4191       +2     
- Misses          4455     4616     +161     
+ Partials         542      540       -2     

Flag	Coverage Δ
integration-tests	26.12% <0.00%> (-0.50%)	⬇️
unit-tests	26.03% <0.00%> (-0.46%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.