feat: implement search history functionality

- Add `SearchHistoryEntity` and `SearchHistoryDao` to persist recent search queries in the Room database (Schema version 7).
- Implement `SearchHistoryRepository` to manage adding, removing, and clearing search history entries.
- Introduce `SearchHistorySection` component to display recent searches when the search query is empty.
- Update `SearchViewModel` to observe search history and save valid queries (min 3 characters).
- Remove the debounced automatic search logic, favoring manual search triggers and history interactions.
- Add localized string resources for "Recent searches", "Clear all", and "Remove" actions.
- Register new search history components in the dependency injection modules.

Author: rainxchzed

core/data/schemas/zed.rainxch.core.data.local.db.AppDatabase/7.json

@@ -15,6 +15,7 @@ import zed.rainxch.core.data.local.db.AppDatabase
 import zed.rainxch.core.data.local.db.dao.CacheDao
 import zed.rainxch.core.data.local.db.dao.FavoriteRepoDao
 import zed.rainxch.core.data.local.db.dao.InstalledAppDao
+import zed.rainxch.core.data.local.db.dao.SearchHistoryDao
 import zed.rainxch.core.data.local.db.dao.SeenRepoDao
 import zed.rainxch.core.data.local.db.dao.StarredRepoDao
 import zed.rainxch.core.data.local.db.dao.UpdateHistoryDao
@@ -27,6 +28,7 @@ import zed.rainxch.core.data.repository.FavouritesRepositoryImpl
 import zed.rainxch.core.data.repository.InstalledAppsRepositoryImpl
 import zed.rainxch.core.data.repository.ProxyRepositoryImpl
 import zed.rainxch.core.data.repository.RateLimitRepositoryImpl
+import zed.rainxch.core.data.repository.SearchHistoryRepositoryImpl
 import zed.rainxch.core.data.repository.SeenReposRepositoryImpl
 import zed.rainxch.core.data.repository.StarredRepositoryImpl
 import zed.rainxch.core.data.repository.TweaksRepositoryImpl
@@ -39,6 +41,7 @@ import zed.rainxch.core.domain.repository.FavouritesRepository
 import zed.rainxch.core.domain.repository.InstalledAppsRepository
 import zed.rainxch.core.domain.repository.ProxyRepository
 import zed.rainxch.core.domain.repository.RateLimitRepository
+import zed.rainxch.core.domain.repository.SearchHistoryRepository
 import zed.rainxch.core.domain.repository.SeenReposRepository
 import zed.rainxch.core.domain.repository.StarredRepository
 import zed.rainxch.core.domain.repository.TweaksRepository
@@ -103,6 +106,12 @@ val coreModule =
             )
         }
 
+        single<SearchHistoryRepository> {
+            SearchHistoryRepositoryImpl(
+                searchHistoryDao = get(),
+            )
+        }
+
         single<ProxyRepository> {
             ProxyRepositoryImpl(
                 preferences = get(),
@@ -216,4 +225,8 @@ val databaseModule =
         single<SeenRepoDao> {
             get<AppDatabase>().seenRepoDao
         }
+
+        single<SearchHistoryDao> {
+            get<AppDatabase>().searchHistoryDao
+        }
     }

core/data/src/commonMain/kotlin/zed/rainxch/core/data/di/SharedModule.kt

@@ -5,12 +5,14 @@ import androidx.room.RoomDatabase
 import zed.rainxch.core.data.local.db.dao.CacheDao
 import zed.rainxch.core.data.local.db.dao.FavoriteRepoDao
 import zed.rainxch.core.data.local.db.dao.InstalledAppDao
+import zed.rainxch.core.data.local.db.dao.SearchHistoryDao
 import zed.rainxch.core.data.local.db.dao.SeenRepoDao
 import zed.rainxch.core.data.local.db.dao.StarredRepoDao
 import zed.rainxch.core.data.local.db.dao.UpdateHistoryDao
 import zed.rainxch.core.data.local.db.entities.CacheEntryEntity
 import zed.rainxch.core.data.local.db.entities.FavoriteRepoEntity
 import zed.rainxch.core.data.local.db.entities.InstalledAppEntity
+import zed.rainxch.core.data.local.db.entities.SearchHistoryEntity
 import zed.rainxch.core.data.local.db.entities.SeenRepoEntity
 import zed.rainxch.core.data.local.db.entities.StarredRepositoryEntity
 import zed.rainxch.core.data.local.db.entities.UpdateHistoryEntity
@@ -23,8 +25,9 @@ import zed.rainxch.core.data.local.db.entities.UpdateHistoryEntity
         StarredRepositoryEntity::class,
         CacheEntryEntity::class,
         SeenRepoEntity::class,
+        SearchHistoryEntity::class,
     ],
-    version = 6,
+    version = 7,
     exportSchema = true,
 )
 abstract class AppDatabase : RoomDatabase() {
@@ -34,4 +37,5 @@ abstract class AppDatabase : RoomDatabase() {
     abstract val starredReposDao: StarredRepoDao
     abstract val cacheDao: CacheDao
     abstract val seenRepoDao: SeenRepoDao
+    abstract val searchHistoryDao: SearchHistoryDao
 }

core/data/src/commonMain/kotlin/zed/rainxch/core/data/local/db/AppDatabase.kt

@@ -0,0 +1,23 @@
+package zed.rainxch.core.data.local.db.dao
+
+import androidx.room.Dao
+import androidx.room.Insert
+import androidx.room.OnConflictStrategy
+import androidx.room.Query
+import kotlinx.coroutines.flow.Flow
+import zed.rainxch.core.data.local.db.entities.SearchHistoryEntity
+
+@Dao
+interface SearchHistoryDao {
+    @Query("SELECT * FROM search_history ORDER BY searchedAt DESC LIMIT 20")
+    fun getRecentSearches(): Flow<List<SearchHistoryEntity>>
+
+    @Insert(onConflict = OnConflictStrategy.REPLACE)
+    suspend fun insert(entity: SearchHistoryEntity)
+
+    @Query("DELETE FROM search_history WHERE `query` = :query")
+    suspend fun deleteByQuery(query: String)
+
+    @Query("DELETE FROM search_history")
+    suspend fun clearAll()
+}

core/data/src/commonMain/kotlin/zed/rainxch/core/data/local/db/dao/SearchHistoryDao.kt

@@ -0,0 +1,11 @@
+package zed.rainxch.core.data.local.db.entities
+
+import androidx.room.Entity
+import androidx.room.PrimaryKey
+
+@Entity(tableName = "search_history")
+data class SearchHistoryEntity(
+    @PrimaryKey
+    val query: String,
+    val searchedAt: Long,
+)

core/data/src/commonMain/kotlin/zed/rainxch/core/data/local/db/entities/SearchHistoryEntity.kt

@@ -0,0 +1,36 @@
+package zed.rainxch.core.data.repository
+
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.map
+import kotlin.time.Clock
+import zed.rainxch.core.data.local.db.dao.SearchHistoryDao
+import zed.rainxch.core.data.local.db.entities.SearchHistoryEntity
+import zed.rainxch.core.domain.repository.SearchHistoryRepository
+
+class SearchHistoryRepositoryImpl(
+    private val searchHistoryDao: SearchHistoryDao,
+) : SearchHistoryRepository {
+    override fun getRecentSearches(): Flow<List<String>> =
+        searchHistoryDao.getRecentSearches().map { entities ->
+            entities.map { it.query }
+        }
+
+    override suspend fun addSearch(query: String) {
+        val trimmed = query.trim()
+        if (trimmed.isBlank()) return
+        searchHistoryDao.insert(
+            SearchHistoryEntity(
+                query = trimmed,
+                searchedAt = Clock.System.now().toEpochMilliseconds(),
+            ),
+        )
+    }
+
+    override suspend fun removeSearch(query: String) {
+        searchHistoryDao.deleteByQuery(query)
+    }
+
+    override suspend fun clearAll() {
+        searchHistoryDao.clearAll()
+    }
+}

core/data/src/commonMain/kotlin/zed/rainxch/core/data/repository/SearchHistoryRepositoryImpl.kt

@@ -0,0 +1,13 @@
+package zed.rainxch.core.domain.repository
+
+import kotlinx.coroutines.flow.Flow
+
+interface SearchHistoryRepository {
+    fun getRecentSearches(): Flow<List<String>>
+
+    suspend fun addSearch(query: String)
+
+    suspend fun removeSearch(query: String)
+
+    suspend fun clearAll()
+}

core/domain/src/commonMain/kotlin/zed/rainxch/core/domain/repository/SearchHistoryRepository.kt

@@ -615,4 +615,9 @@
     <string name="clear_seen_history_description">Reset all seen repositories so they appear again in feeds</string>
     <string name="seen_history_cleared">Seen history cleared</string>
     <string name="seen_badge">Viewed</string>
+
+    <!-- Search history -->
+    <string name="recent_searches">Recent searches</string>
+    <string name="clear_all_history">Clear all</string>
+    <string name="remove_search_history_item">Remove</string>
 </resources>

core/presentation/src/commonMain/composeResources/values/strings.xml

@@ -61,4 +61,14 @@ sealed interface SearchAction {
     data object OnFabClick : SearchAction
 
     data object DismissClipboardBanner : SearchAction
+
+    data class OnHistoryItemClick(
+        val query: String,
+    ) : SearchAction
+
+    data class OnRemoveHistoryItem(
+        val query: String,
+    ) : SearchAction
+
+    data object OnClearAllHistory : SearchAction
 }

feature/search/presentation/src/commonMain/kotlin/zed/rainxch/search/presentation/SearchAction.kt

@@ -92,6 +92,7 @@ import zed.rainxch.core.presentation.theme.GithubStoreTheme
 import zed.rainxch.core.presentation.utils.ObserveAsEvents
 import zed.rainxch.githubstore.core.presentation.res.*
 import zed.rainxch.search.presentation.components.LanguageFilterBottomSheet
+import zed.rainxch.search.presentation.components.SearchHistorySection
 import zed.rainxch.search.presentation.components.SortByBottomSheet
 import zed.rainxch.search.presentation.model.ParsedGithubLink
 import zed.rainxch.search.presentation.model.ProgrammingLanguageUi
@@ -485,6 +486,26 @@ fun SearchScreen(
                 )
             }
 
+            // Show search history when query is empty
+            if (state.query.isBlank() &&
+                state.repositories.isEmpty() &&
+                state.recentSearches.isNotEmpty() &&
+                !state.isLoading
+            ) {
+                SearchHistorySection(
+                    recentSearches = state.recentSearches,
+                    onHistoryItemClick = { query ->
+                        onAction(SearchAction.OnHistoryItemClick(query))
+                    },
+                    onRemoveItem = { query ->
+                        onAction(SearchAction.OnRemoveHistoryItem(query))
+                    },
+                    onClearAll = {
+                        onAction(SearchAction.OnClearAllHistory)
+                    },
+                )
+            }
+
             val visibleRepos by remember(state.repositories, state.isHideSeenEnabled, state.seenRepoIds) {
                 derivedStateOf {
                     if (state.isHideSeenEnabled && state.seenRepoIds.isNotEmpty()) {