feat(contacts): add join timestamp and sort feed by recency

- Add requireCoinbaseEmailVerification to UserFlags (editable override)
- Add joinTs to FlipcashContact, persist to Room, and use in contact
  feed sorting so recently-joined contacts appear prominently while
  new messages still sort to the top
- Extract ContactMapper for proto-to-domain contact mapping
- Return raw proto list from ContactListService, map in repository

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

Author: bmc08gt

apps/flipcash/features/direct-send/src/main/kotlin/com/flipcash/app/directsend/internal/SendFlowViewModel.kt

@@ -301,18 +301,23 @@ internal class SendFlowViewModel @Inject constructor(
                 chatId = chatId,
                 lastActivity = summary.metadata.lastActivity,
             )
-        }.sortedWith(
-            compareByDescending<ContactListItem.ContactRow> { it.lastActivity }
-                .thenBy(String.CASE_INSENSITIVE_ORDER) { it.contact.displayName }
-        )
+        }
 
-        // On Flipcash — contacts that haven't chatted yet
+        // On Flipcash — contacts that haven't chatted yet, use joinedAt as their sort timestamp
         val flipcashRows = filtered
             .filter { it.e164 in contactState.flipcashE164s && it.e164 !in recentsE164s }
-            .sortedWith(compareBy(String.CASE_INSENSITIVE_ORDER) { it.displayName })
-            .map { ContactListItem.ContactRow(contact = it, isOnFlipcash = true) }
+            .map { contact ->
+                ContactListItem.ContactRow(
+                    contact = contact,
+                    isOnFlipcash = true,
+                    lastActivity = contactState.joinedAtByE164[contact.e164],
+                )
+            }
 
-        val flipcashCombined = (recentRows + flipcashRows)
+        val flipcashCombined = (recentRows + flipcashRows).sortedWith(
+            compareByDescending<ContactListItem.ContactRow> { it.lastActivity }
+                .thenBy(String.CASE_INSENSITIVE_ORDER) { it.contact.displayName }
+        )
 
         val excludedE164s = recentsE164s + contactState.flipcashE164s
         val other = filtered

apps/flipcash/features/userflags/src/main/kotlin/com/flipcash/app/userflags/internal/UserFlagsViewModel.kt

@@ -142,4 +142,5 @@ private fun ResolvedUserFlags.editableEntries(): List<EditableEntry<*>> = listOf
     EditableEntry(Field.WithdrawalFeeAmount, withdrawalFeeAmount),
     EditableEntry(Field.PreferredUsdcOnRampLiquidityPool, usdcOnRampLiquidityPool),
     EditableEntry(Field.MinimumHolderAmountForLeaderboard, minimumHolderAmountForLeaderboard),
+    EditableEntry(Field.RequireCoinbaseEmailVerification, requireCoinbaseEmailVerification),
 )

apps/flipcash/shared/contacts/src/main/kotlin/com/flipcash/app/contacts/ContactCoordinator.kt

@@ -61,6 +61,7 @@ import kotlinx.coroutines.launch
 import javax.inject.Inject
 import javax.inject.Singleton
 import kotlin.collections.map
+import kotlin.time.Instant
 import kotlin.collections.mapValues
 
 
@@ -98,6 +99,7 @@ class ContactCoordinator @Inject constructor(
         val contacts: Map<String, DeviceContact> = emptyMap(),
         val flipcashE164s: Set<String> = emptySet(),
         val dmChatIds: Map<String, String> = emptyMap(),
+        val joinedAtByE164: Map<String, Instant> = emptyMap(),
         val syncState: SyncState = SyncState.Idle,
         val hasEverSynced: Boolean = false,
         val hasDiscoveredFlipcashContacts: Boolean = false,
@@ -370,12 +372,16 @@ class ContactCoordinator @Inject constructor(
         val dmChatIds = mappings
             .filter { it.dmChatId.isNotEmpty() }
             .associate { it.e164 to it.dmChatId }
+        val joinedAtByE164 = mappings
+            .filter { it.joinedAtEpochSeconds > 0 }
+            .associate { it.e164 to Instant.fromEpochSeconds(it.joinedAtEpochSeconds) }
 
         _state.update {
             it.copy(
                 contacts = contacts,
                 flipcashE164s = flipcashE164s,
                 dmChatIds = dmChatIds,
+                joinedAtByE164 = joinedAtByE164,
                 hasEverSynced = true,
                 hasDiscoveredFlipcashContacts = hasDiscoveredFlipcashContacts,
             )
@@ -551,12 +557,21 @@ class ContactCoordinator @Inject constructor(
                     }
                 }
                 val dmChatIds = mutableMapOf<String, String>()
+                val joinedAts = mutableMapOf<String, Instant>()
                 entries.forEach { entry ->
+                    contactDataSource.updateJoinedAt(entry.phoneNumber, entry.joinedAt.epochSeconds)
+                    joinedAts[entry.phoneNumber] = entry.joinedAt
                     val chatIdStr = entry.dmChatId?.toString() ?: return@forEach
                     contactDataSource.updateDmChatId(entry.phoneNumber, chatIdStr)
                     dmChatIds[entry.phoneNumber] = chatIdStr
                 }
-                _state.update { it.copy(flipcashE164s = flipcashE164s, dmChatIds = it.dmChatIds + dmChatIds) }
+                _state.update {
+                    it.copy(
+                        flipcashE164s = flipcashE164s,
+                        dmChatIds = it.dmChatIds + dmChatIds,
+                        joinedAtByE164 = it.joinedAtByE164 + joinedAts,
+                    )
+                }
                 trace(tag = TAG, message = "Found ${flipcashE164s.size} contacts on Flipcash", type = TraceType.Process)
             }?.onFailure { error ->
                 when (error) {