refactor(analytics): encapsulate event hierarchy behind service interface

- Convert AnalyticsEvent to internal sealed interface with toProperties()
  on each subclass, removing the shared properties() extension function
- Move event data onto subclasses (mint, amount, error, etc.) so callers
  no longer pass context separately from the event
- Replace public AnalyticsEvent references in FlipcashAnalyticsService
  with domain-typed enums and sealed interfaces (BuyMethod, OnrampSource,
  OnrampVerificationStep, etc.)
- Convert Transfer from enum to sealed interface to support SentCashLink
  variants (Clipboard, App) alongside simple data objects
- Add StubAnalyticsService for tests and DI fallback
- Add Throwable?.asProperty() helper to reduce null-check repetition

Author: bmc08gt

apps/flipcash/features/balance/src/main/kotlin/com/flipcash/app/balance/internal/BalanceViewModel.kt

@@ -1,7 +1,7 @@
 package com.flipcash.app.balance.internal
 
 import androidx.lifecycle.viewModelScope
-import com.flipcash.app.analytics.AnalyticsEvent
+import com.flipcash.app.analytics.Analytics
 import com.flipcash.app.analytics.FlipcashAnalyticsService
 import com.flipcash.app.core.AppRoute
 import com.flipcash.app.core.tokens.TokenPurpose
@@ -62,7 +62,7 @@ internal class BalanceViewModel @Inject constructor(
         eventFlow
             .filterIsInstance<Event.OnAddCashClicked>()
             .onEach {
-                analytics.openOnramp(AnalyticsEvent.OnRampOpenEvent.Balance)
+                analytics.openOnramp(Analytics.OnrampSource.Balance)
                 val provider = stateFlow.value.preferredOnRampProvider
                 if (provider is OnRampProvider.Coinbase && provider.type == OnRampType.Virtual) {
                     // has coinbase provider supporting google pay - pop selection for quick add

apps/flipcash/features/cash/src/main/kotlin/com/flipcash/app/cash/internal/CashScreenViewModel.kt

@@ -1,7 +1,7 @@
 package com.flipcash.app.cash.internal
 
 import androidx.lifecycle.viewModelScope
-import com.flipcash.app.analytics.AnalyticsEvent
+import com.flipcash.app.analytics.Analytics
 import com.flipcash.app.analytics.FlipcashAnalyticsService
 import com.flipcash.app.core.AppRoute
 import com.flipcash.app.core.bill.Bill
@@ -318,7 +318,7 @@ internal class CashScreenViewModel @Inject constructor(
             .onEach { amount ->
                 val provider = stateFlow.value.preferredOnRampProvider
                 if (provider is OnRampProvider.Coinbase && provider.type == OnRampType.Virtual) {
-                    analytics.openOnramp(AnalyticsEvent.OnRampOpenEvent.Give)
+                    analytics.openOnramp(Analytics.OnrampSource.Give)
                     // has coinbase provider supporting google pay - pop selection for quick add
                     dispatchEvent(Event.OpenOnRampAmountModal(amount))
                 } else {

apps/flipcash/features/contact-verification/src/main/kotlin/com/flipcash/app/contact/verification/email/EmailMagicLinkScreen.kt

@@ -12,10 +12,9 @@ import androidx.compose.ui.platform.LocalContext
 import androidx.compose.ui.res.stringResource
 import cafe.adriel.voyager.core.annotation.ExperimentalVoyagerApi
 import cafe.adriel.voyager.core.lifecycle.LifecycleEffectOnce
-import cafe.adriel.voyager.core.screen.Screen
 import cafe.adriel.voyager.core.screen.ScreenKey
 import cafe.adriel.voyager.core.screen.uniqueScreenKey
-import com.flipcash.app.analytics.AnalyticsEvent
+import com.flipcash.app.analytics.Analytics
 import com.flipcash.app.analytics.rememberAnalytics
 import com.flipcash.app.contact.verification.EmailVerificationFlow
 import com.flipcash.app.contact.verification.VerificationFlowStep
@@ -59,7 +58,7 @@ class EmailMagicLinkScreen(
 
         val analytics = rememberAnalytics()
         LifecycleEffectOnce {
-            analytics.onrampVerification(AnalyticsEvent.OnRampVerificationEvent.ConfirmEmail)
+            analytics.onrampVerification(Analytics.OnrampVerificationStep.ConfirmEmail)
         }
 
         Column(

apps/flipcash/features/contact-verification/src/main/kotlin/com/flipcash/app/contact/verification/email/EmailVerificationScreen.kt

@@ -11,12 +11,11 @@ import androidx.compose.ui.Modifier
 import androidx.compose.ui.res.stringResource
 import cafe.adriel.voyager.core.annotation.ExperimentalVoyagerApi
 import cafe.adriel.voyager.core.lifecycle.LifecycleEffectOnce
-import cafe.adriel.voyager.core.screen.Screen
 import cafe.adriel.voyager.core.screen.ScreenKey
 import cafe.adriel.voyager.core.screen.uniqueScreenKey
 import cafe.adriel.voyager.navigator.LocalNavigator
 import cafe.adriel.voyager.navigator.currentOrThrow
-import com.flipcash.app.analytics.AnalyticsEvent
+import com.flipcash.app.analytics.Analytics
 import com.flipcash.app.analytics.rememberAnalytics
 import com.flipcash.app.contact.verification.EmailVerificationFlow
 import com.flipcash.app.contact.verification.internal.email.EmailEntryScreen
@@ -69,7 +68,7 @@ class EmailVerificationScreen : AppScreen, Parcelable  {
 
         val analytics = rememberAnalytics()
         LifecycleEffectOnce {
-            analytics.onrampVerification(AnalyticsEvent.OnRampVerificationEvent.EnterEmail)
+            analytics.onrampVerification(Analytics.OnrampVerificationStep.EnterEmail)
         }
 
         BackHandler {

apps/flipcash/features/contact-verification/src/main/kotlin/com/flipcash/app/contact/verification/internal/VerificationFlowIntroScreen.kt

@@ -27,7 +27,7 @@ import cafe.adriel.voyager.core.annotation.ExperimentalVoyagerApi
 import cafe.adriel.voyager.core.lifecycle.LifecycleEffectOnce
 import cafe.adriel.voyager.core.screen.ScreenKey
 import cafe.adriel.voyager.core.screen.uniqueScreenKey
-import com.flipcash.app.analytics.AnalyticsEvent
+import com.flipcash.app.analytics.Analytics
 import com.flipcash.app.analytics.rememberAnalytics
 import com.flipcash.app.contact.verification.VerificationFlowStep
 import com.flipcash.app.navigation.FlowNavigator
@@ -69,7 +69,7 @@ class VerificationFlowIntroScreen(
 
         val analytics = rememberAnalytics()
         LifecycleEffectOnce {
-            analytics.onrampVerification(AnalyticsEvent.OnRampVerificationEvent.ShowInfo)
+            analytics.onrampVerification(Analytics.OnrampVerificationStep.ShowInfo)
         }
 
         BackHandler {

apps/flipcash/features/contact-verification/src/main/kotlin/com/flipcash/app/contact/verification/phone/PhoneCodeScreen.kt

@@ -11,10 +11,9 @@ import androidx.compose.ui.Modifier
 import androidx.compose.ui.res.stringResource
 import cafe.adriel.voyager.core.annotation.ExperimentalVoyagerApi
 import cafe.adriel.voyager.core.lifecycle.LifecycleEffectOnce
-import cafe.adriel.voyager.core.screen.Screen
 import cafe.adriel.voyager.core.screen.ScreenKey
 import cafe.adriel.voyager.core.screen.uniqueScreenKey
-import com.flipcash.app.analytics.AnalyticsEvent
+import com.flipcash.app.analytics.Analytics
 import com.flipcash.app.analytics.rememberAnalytics
 import com.flipcash.app.contact.verification.PhoneVerificationFlow
 import com.flipcash.app.contact.verification.VerificationFlowStep
@@ -64,7 +63,7 @@ class PhoneCodeScreen: AppScreen, Parcelable {
 
         val analytics = rememberAnalytics()
         LifecycleEffectOnce {
-            analytics.onrampVerification(AnalyticsEvent.OnRampVerificationEvent.ConfirmPhone)
+            analytics.onrampVerification(Analytics.OnrampVerificationStep.ConfirmPhone)
         }
 
         LaunchedEffect(viewModel) {

apps/flipcash/features/contact-verification/src/main/kotlin/com/flipcash/app/contact/verification/phone/PhoneVerificationScreen.kt

@@ -11,12 +11,11 @@ import androidx.compose.ui.Modifier
 import androidx.compose.ui.res.stringResource
 import cafe.adriel.voyager.core.annotation.ExperimentalVoyagerApi
 import cafe.adriel.voyager.core.lifecycle.LifecycleEffectOnce
-import cafe.adriel.voyager.core.screen.Screen
 import cafe.adriel.voyager.core.screen.ScreenKey
 import cafe.adriel.voyager.core.screen.uniqueScreenKey
 import cafe.adriel.voyager.navigator.LocalNavigator
 import cafe.adriel.voyager.navigator.currentOrThrow
-import com.flipcash.app.analytics.AnalyticsEvent
+import com.flipcash.app.analytics.Analytics
 import com.flipcash.app.analytics.rememberAnalytics
 import com.flipcash.app.contact.verification.PhoneVerificationFlow
 import com.flipcash.app.contact.verification.internal.phone.PhoneEntryScreen
@@ -70,7 +69,7 @@ class PhoneVerificationScreen : AppScreen, Parcelable  {
 
         val analytics = rememberAnalytics()
         LifecycleEffectOnce {
-            analytics.onrampVerification(AnalyticsEvent.OnRampVerificationEvent.EnterPhone)
+            analytics.onrampVerification(Analytics.OnrampVerificationStep.EnterPhone)
         }
 
         BackHandler {

apps/flipcash/features/menu/src/main/kotlin/com/flipcash/app/menu/internal/MenuScreenViewModel.kt

@@ -1,7 +1,7 @@
 package com.flipcash.app.menu.internal
 
 import androidx.lifecycle.viewModelScope
-import com.flipcash.app.analytics.AnalyticsEvent
+import com.flipcash.app.analytics.Analytics
 import com.flipcash.app.analytics.FlipcashAnalyticsService
 import com.flipcash.app.auth.AuthManager
 import com.flipcash.app.core.AppRoute
@@ -130,7 +130,7 @@ internal class MenuScreenViewModel @Inject constructor(
         eventFlow
             .filterIsInstance<Event.OnAddCashClicked>()
             .onEach {
-                analytics.openOnramp(AnalyticsEvent.OnRampOpenEvent.Settings)
+                analytics.openOnramp(Analytics.OnrampSource.Settings)
                 val provider = stateFlow.value.preferredOnRampProvider
                 if (provider is OnRampProvider.Coinbase && provider.type == OnRampType.Virtual) {
                     // has coinbase provider supporting google pay - pop selection for quick add

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

@@ -54,6 +54,7 @@ dependencies {
     implementation(Libs.compose_activities)
 
     implementation(project(":apps:flipcash:core"))
+    implementation(project(":apps:flipcash:shared:analytics"))
     implementation(project(":apps:flipcash:shared:appsettings"))
     implementation(project(":apps:flipcash:shared:appupdates"))
     implementation(project(":apps:flipcash:shared:bills"))

apps/flipcash/features/scanner/src/main/kotlin/com/flipcash/app/scanner/internal/Scanner.kt

@@ -13,6 +13,7 @@ import androidx.compose.ui.platform.LocalContext
 import androidx.lifecycle.Lifecycle
 import cafe.adriel.voyager.core.registry.ScreenRegistry
 import cafe.adriel.voyager.navigator.currentOrThrow
+import com.flipcash.app.analytics.rememberAnalytics
 import com.flipcash.app.core.navigation.DeeplinkType
 import com.flipcash.app.router.LocalRouter
 import com.flipcash.app.scanner.internal.bills.BillContainer
@@ -39,6 +40,7 @@ internal fun Scanner(deepLink: DeeplinkType?) {
     val session = LocalSessionController.currentOrThrow
     val state by session.state.collectAsState()
     val billState by session.billState.collectAsState()
+    val analytics = rememberAnalytics()
 
     val sheetLifecycleHandler = rememberSheetAutoResign()
     LaunchedEffect(sheetLifecycleHandler) {
@@ -71,7 +73,7 @@ internal fun Scanner(deepLink: DeeplinkType?) {
         deepLink = deepLinkSaved,
         previewing = previewing,
         session = session,
-        navigator = navigator
+        navigator = navigator,
     ) {
         deepLinkSaved = null
     }