feat(onboarding): unify login into a single OnboardingFlow with linear FlowHost API

apps/flipcash/app/src/main/kotlin/com/flipcash/app/internal/ui/App.kt

@@ -266,8 +266,8 @@ internal fun App(
                                             action.entropy,
                                             onSwitchAccount = {
                                                 codeNavigator.replaceAll(
-                                                    AppRoute.Onboarding.Login(
-                                                        action.entropy,
+                                                    AppRoute.OnboardingFlow(
+                                                        seed = action.entropy,
                                                         fromDeeplink = true
                                                     )
                                                 )
@@ -287,13 +287,13 @@ internal fun App(
                                 LaunchedEffect(userState.authState) {
                                     if (userState.authState == AuthState.LoggedOut) {
                                         val current = codeNavigator.currentRouteKey
-                                        if (current !is AppRoute.Loading && current !is AppRoute.Onboarding) {
+                                        if (current !is AppRoute.Loading && current !is AppRoute.OnboardingFlow) {
                                             codeNavigator.pendingSheetDismiss = null
                                             val switchEntropy =
                                                 viewModel.consumePendingSwitchEntropy()
                                             codeNavigator.replaceAll(
-                                                AppRoute.Onboarding.Login(
-                                                    switchEntropy
+                                                AppRoute.OnboardingFlow(
+                                                    seed = switchEntropy
                                                 )
                                             )
                                         }

apps/flipcash/app/src/main/kotlin/com/flipcash/app/internal/ui/navigation/AppRestrictedScreen.kt

@@ -19,9 +19,7 @@ fun AppRestrictedScreen(restrictionType: RestrictionType) {
         coroutineScope.launch {
             homeViewModel.logout()
                 .onSuccess {
-                    navigator.replaceAll(
-                        AppRoute.Onboarding.Login()
-                    )
+                    navigator.replaceAll(AppRoute.OnboardingFlow())
                 }
         }
     }

apps/flipcash/app/src/main/kotlin/com/flipcash/app/internal/ui/navigation/AppScreenContent.kt

@@ -34,16 +34,9 @@ import com.flipcash.app.internal.ui.navigation.decorators.rememberNavMessagingEn
 import com.flipcash.app.lab.LabsScreen
 import com.flipcash.app.lab.NavBarSettingsScreen
 import com.flipcash.app.lab.StandaloneLabsScreen
-import com.flipcash.app.login.accesskey.AccessKeyScreen
-import com.flipcash.app.login.accesskey.PhotoAccessKeyScreen
-import com.flipcash.app.login.router.LoginRouter
-import com.flipcash.app.login.seed.SeedInputScreen
+import com.flipcash.app.login.OnboardingFlowScreen
 import com.flipcash.app.menu.MenuScreen
 import com.flipcash.app.myaccount.MyAccountScreen
-import com.flipcash.app.permissions.ContactPermissionScreen
-import com.flipcash.app.permissions.NotificationPermissionRationaleScreen
-import com.flipcash.app.permissions.NotificationPermissionScreen
-import com.flipcash.app.purchase.PurchaseAccountScreen
 import com.flipcash.app.scanner.ScannerScreen
 import com.flipcash.app.shareapp.ShareAppScreen
 import com.flipcash.app.tokens.SwapFlowScreen
@@ -75,16 +68,10 @@ fun appEntryProvider(
     // Loading / splash
     annotatedEntry<AppRoute.Loading> { MainRoot(deepLink) }
 
-    // Onboarding
-    annotatedEntry<AppRoute.Onboarding.Login> { key -> LoginRouter(key.seed, key.fromDeeplink) }
-    annotatedEntry<AppRoute.Onboarding.SeedInput> { SeedInputScreen() }
-    annotatedEntry<AppRoute.Onboarding.AccessKey> { AccessKeyScreen() }
-    annotatedEntry<AppRoute.Onboarding.AccessKeySavedLocation> { PhotoAccessKeyScreen() }
-    annotatedEntry<AppRoute.Onboarding.Purchase> { key -> PurchaseAccountScreen(key.fromLogin) }
-    annotatedEntry<AppRoute.Onboarding.ContactPermission> { key -> ContactPermissionScreen(key.postCreate) }
-    annotatedEntry<AppRoute.Onboarding.NotificationPermission> { key -> NotificationPermissionScreen(key.postCreate) }
-    annotatedEntry<AppRoute.Onboarding.NotificationPermissionRationale> { key -> NotificationPermissionRationaleScreen(key.permanentlyDenied) }
-    annotatedEntry<AppRoute.Onboarding.CameraPermission> { }
+    // Onboarding flow
+    annotatedEntry<AppRoute.OnboardingFlow> { key ->
+        OnboardingFlowScreen(route = key, resultStateRegistry = resultStateRegistry)
+    }
 
     // Main
     annotatedEntry<AppRoute.Main.Sheet> { key ->

apps/flipcash/app/src/main/kotlin/com/flipcash/app/internal/ui/navigation/MainRoot.kt

@@ -179,25 +179,13 @@ private fun buildNavGraphForLaunch(
 ): LaunchNavGraph? {
     return when (state) {
         is AuthState.Registered -> {
-            if (state.seenAccessKey) {
-                val routes = if (userFlags?.requiresIapForRegistration == true) {
-                    listOf(
-                        AppRoute.Onboarding.Login(),
-                        AppRoute.Onboarding.AccessKey,
-                        AppRoute.Onboarding.Purchase()
-                    )
-                } else {
-                    listOf(AppRoute.Main.Scanner)
-                }
-                LaunchNavGraph(routes)
-            } else {
-                LaunchNavGraph(
-                    listOf(
-                        AppRoute.Onboarding.Login(),
-                        AppRoute.Onboarding.AccessKey
-                    )
-                )
+            val resumePoint = when {
+                !state.seenAccessKey -> AppRoute.OnboardingFlow.ResumePoint.AccessKey
+                userFlags?.requiresIapForRegistration == true ->
+                    AppRoute.OnboardingFlow.ResumePoint.AccessKeyThenPurchase
+                else -> AppRoute.OnboardingFlow.ResumePoint.PostAccessKey
             }
+            LaunchNavGraph(listOf(AppRoute.OnboardingFlow(resumeAt = resumePoint)))
         }
 
         AuthState.LoggedInWithUser -> {
@@ -223,10 +211,10 @@ private fun buildNavGraphForLaunch(
             if (link != null) {
                 when (val action = router.dispatch(link)) {
                     is DeeplinkAction.Navigate -> LaunchNavGraph(action.routes)
-                    else -> LaunchNavGraph(listOf(AppRoute.Onboarding.Login()))
+                    else -> LaunchNavGraph(listOf(AppRoute.OnboardingFlow()))
                 }
             } else {
-                LaunchNavGraph(listOf(AppRoute.Onboarding.Login()))
+                LaunchNavGraph(listOf(AppRoute.OnboardingFlow()))
             }
         }
 

apps/flipcash/core/src/main/kotlin/com/flipcash/app/core/AppRoute.kt

@@ -14,8 +14,10 @@ import com.flipcash.app.core.verification.VerificationResult
 import com.flipcash.app.core.verification.VerificationStep
 import com.flipcash.app.core.withdrawal.WithdrawalResult
 import com.flipcash.app.core.withdrawal.WithdrawalStep
+import com.flipcash.app.core.onboarding.OnboardingStep
 import com.getcode.navigation.NonDismissableRoute
 import com.getcode.navigation.NonDraggableRoute
+import com.getcode.navigation.flow.FlowRoute
 import com.getcode.navigation.flow.FlowRouteWithResult
 import com.getcode.opencode.exchange.VerifiedFiat
 import com.getcode.opencode.internal.solana.model.SwapId
@@ -62,6 +64,31 @@ sealed interface AppRoute : NavKey, Parcelable {
     }
 
 
+    @Serializable
+    @Parcelize
+    data class OnboardingFlow(
+        val phase: Phase = Phase.Account,
+        val seed: String? = null,
+        val fromDeeplink: Boolean = false,
+        val resumeAt: ResumePoint = ResumePoint.Login,
+        val skipContacts: Boolean = false,
+    ) : AppRoute, FlowRoute {
+        enum class Phase { Account, Permissions }
+        enum class ResumePoint { Login, AccessKey, AccessKeyThenPurchase, PostAccessKey }
+
+        override val initialStack: List<NavKey>
+            get() = when (phase) {
+                Phase.Account -> when (resumeAt) {
+                    ResumePoint.Login -> listOf(OnboardingStep.Start(seed, fromDeeplink))
+                    ResumePoint.AccessKey -> listOf(OnboardingStep.Start(), OnboardingStep.AccessKey)
+                    ResumePoint.AccessKeyThenPurchase ->
+                        listOf(OnboardingStep.Start(), OnboardingStep.AccessKey, OnboardingStep.Purchase)
+                    ResumePoint.PostAccessKey -> emptyList()
+                }
+                Phase.Permissions -> listOf(OnboardingStep.ContactPermission, OnboardingStep.NotificationPermission)
+            }
+    }
+
     @Serializable
     @Parcelize
     sealed interface Main : AppRoute {

apps/flipcash/core/src/main/kotlin/com/flipcash/app/core/onboarding/OnboardingStep.kt

@@ -0,0 +1,63 @@
+package com.flipcash.app.core.onboarding
+
+import android.os.Parcelable
+import com.getcode.navigation.NonDismissableRoute
+import com.getcode.navigation.flow.FlowStep
+import kotlinx.parcelize.Parcelize
+import kotlinx.serialization.Serializable
+
+/**
+ * Steps inside the Onboarding flow. Owned by [com.flipcash.app.core.AppRoute.OnboardingFlow]
+ * and rendered inside a [com.getcode.navigation.flow.FlowHost].
+ */
+@Serializable
+sealed interface OnboardingStep : FlowStep, Parcelable {
+    @Parcelize
+    @Serializable
+    data class Start(val seed: String? = null, val fromDeeplink: Boolean = false) : OnboardingStep
+
+    @Parcelize
+    @Serializable
+    data object SeedInput : OnboardingStep
+
+    @Parcelize
+    @Serializable
+    data object AccessKey : OnboardingStep
+
+    @Parcelize
+    @Serializable
+    data object AccessKeySavedLocation : OnboardingStep
+
+    @Parcelize
+    @Serializable
+    data object Purchase : OnboardingStep
+
+    @Parcelize
+    @Serializable
+    data object ContactPermission : OnboardingStep
+
+    @Parcelize
+    @Serializable
+    data object NotificationPermission : OnboardingStep
+
+    @Parcelize
+    @Serializable
+    data class NotificationPermissionRationale(
+        val permanentlyDenied: Boolean = false,
+    ) : OnboardingStep, NonDismissableRoute
+}
+
+@Serializable
+sealed interface OnboardingResult : Parcelable {
+    @Parcelize
+    @Serializable
+    data object ProceedToVerification : OnboardingResult
+
+    @Parcelize
+    @Serializable
+    data object LoggedIn : OnboardingResult
+
+    @Parcelize
+    @Serializable
+    data object Completed : OnboardingResult
+}

apps/flipcash/features/login/build.gradle.kts

@@ -16,7 +16,9 @@ dependencies {
     implementation(project(":apps:flipcash:shared:analytics"))
     implementation(project(":apps:flipcash:shared:authentication"))
     implementation(project(":apps:flipcash:shared:featureflags"))
+    implementation(project(":apps:flipcash:shared:permissions"))
     implementation(project(":apps:flipcash:shared:userflags"))
+    implementation(project(":apps:flipcash:features:purchase"))
     implementation(project(":libs:datetime"))
     implementation(project(":libs:messaging"))
     implementation(project(":libs:permissions:bindings"))