feat(contacts): add shared contacts module with persistence layer (#775)

* feat(verification): support full-screen and target navigation for drop-in use cases

Add `target` and `fullScreen` params to AppRoute.Verification so the flow
can forward-navigate on success (replace) and render with status bar padding
when used outside of a modal sheet (e.g. onboarding).

Wire phone verification into the onboarding flow from AccessKeyScreen.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Signed-off-by: Brandon McAnsh <git@bmcreations.dev>

* feat(contacts): add shared contacts module with persistence layer

Introduces the contacts module with:
- ContactCoordinator for orchestrating contact sync
- ScopeAwareContactReader with full-access and picker-based strategies
- ContactChecksum for detecting contact list changes
- Hilt module for DI wiring

Adds persistence support:
- ContactDao with Room queries for contact mappings and sync state
- ContactMappingEntity and ContactSyncStateEntity
- FlipcashDatabase v16 schema migration

Signed-off-by: Brandon McAnsh <git@bmcreations.dev>

* feat(contacts): reset contact state on logout via SessionController

---------

Signed-off-by: Brandon McAnsh <git@bmcreations.dev>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: bmc08gt

apps/flipcash/app/build.gradle.kts

@@ -150,6 +150,7 @@ dependencies {
     implementation(project(":apps:flipcash:shared:google-play-billing"))
     implementation(project(":apps:flipcash:shared:currency-selection:core"))
     implementation(project(":apps:flipcash:shared:currency-selection:ui"))
+    implementation(project(":apps:flipcash:shared:contacts"))
     implementation(project(":apps:flipcash:shared:notifications"))
     implementation(project(":apps:flipcash:shared:onramp:coinbase"))
     implementation(project(":apps:flipcash:shared:onramp:deeplinks"))

apps/flipcash/app/src/main/kotlin/com/flipcash/app/MainActivity.kt

@@ -16,6 +16,8 @@ import com.flipcash.app.appsettings.LocalAppSettings
 import com.flipcash.app.bill.customization.BillPlaygroundController
 import com.flipcash.app.bill.customization.LocalBillPlaygroundController
 import com.flipcash.app.billing.BillingClient
+import com.flipcash.app.contacts.ContactCoordinator
+import com.flipcash.app.contacts.LocalContactCoordinator
 import com.flipcash.app.core.LocalUserManager
 import com.flipcash.app.core.verification.email.EmailCodeChannel
 import com.flipcash.app.core.verification.email.LocalEmailCodeChannel
@@ -115,6 +117,9 @@ class MainActivity : FragmentActivity() {
     @Inject
     lateinit var emailCodeChannel: EmailCodeChannel
 
+    @Inject
+    lateinit var contactCoordinator: ContactCoordinator
+
     @Inject
     lateinit var coinbaseOnRampController: CoinbaseOnRampController
 
@@ -141,6 +146,7 @@ class MainActivity : FragmentActivity() {
                 LocalBillPlaygroundController provides billPlaygroundController,
                 LocalAppUpdater provides appUpdater,
                 LocalEmailCodeChannel provides emailCodeChannel,
+                LocalContactCoordinator provides contactCoordinator,
                 LocalCoinbaseOnRampController provides coinbaseOnRampController,
                 LocalUiTesting provides intent.getBooleanExtra(UI_TEST, false),
             ) {

apps/flipcash/shared/contacts/.gitignore

@@ -0,0 +1,2 @@
+build/
+.gradle/

apps/flipcash/shared/contacts/build.gradle.kts

@@ -0,0 +1,23 @@
+plugins {
+    alias(libs.plugins.flipcash.android.feature)
+}
+
+android {
+    namespace = "${Gradle.flipcashNamespace}.shared.contacts"
+}
+
+dependencies {
+    testImplementation(kotlin("test"))
+    testImplementation(libs.bundles.unit.testing)
+    testImplementation(libs.robolectric)
+
+    implementation(project(":services:flipcash"))
+    implementation(project(":services:opencode"))
+    implementation(project(":apps:flipcash:shared:persistence:db"))
+    implementation(project(":apps:flipcash:shared:phone"))
+    implementation(project(":apps:flipcash:shared:featureflags"))
+    implementation(project(":libs:encryption:keys"))
+    implementation(project(":libs:network:connectivity:public"))
+    implementation(libs.androidx.lifecycle.process)
+    implementation(libs.bundles.room)
+}

apps/flipcash/shared/contacts/src/main/AndroidManifest.xml

@@ -0,0 +1,8 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <uses-permission android:name="android.permission.READ_CONTACTS" />
+    <application>
+
+    </application>
+
+</manifest>