🐛 [useTableRequest]: Fix cache key conflict on page switch

- Auto-generate unique cache keys per page (e.g., users_p0_s10)
- Use custom setCache/getCache to append page params to cacheKey
- Change getCache return type to nullable for proper cache miss handling
- Add caching example in UseTableRequestExample

Author: junerver

app/src/commonMain/kotlin/xyz/junerver/composehooks/example/UseTableRequestExample.kt

@@ -19,6 +19,7 @@ import xyz.junerver.compose.hooks.userequest.useTableRequest
 import xyz.junerver.compose.hooks.usetable.core.column
 import xyz.junerver.compose.hooks.usetable.useTable
 import kotlin.math.ceil
+import kotlin.time.Duration.Companion.seconds
 
 /**
  * Example demonstrating useTableRequest hook.
@@ -52,6 +53,9 @@ fun UseTableRequestExample() {
         optionsOf = {
             initialPageSize = 5
             requestOptions = {
+                // Per-page caching: each page is cached independently
+                cacheKey = "users-table"
+                staleTime = 30.seconds
                 onSuccess = { data, _ ->
                     println("Loaded ${data?.rows?.size ?: 0} users")
                 }

hooks/src/commonMain/kotlin/xyz/junerver/compose/hooks/userequest/UseRequestOptions.kt

@@ -122,7 +122,7 @@ data class UseRequestOptions<TParams, TData> internal constructor(
     @Stable
     var setCache: ((data: CachedData<TData>) -> Unit)? = null,
     @Stable
-    var getCache: ((params: TParams) -> CachedData<TData>)? = null,
+    var getCache: ((params: TParams) -> CachedData<TData>?)? = null,
     /**
      * By setting options.[loadingDelay], you can delay the time when [FetchState.loading] becomes true, effectively preventing flickering.
      * For example, when an interface normally returns quickly, if we use it conventionally, flickering will occur. After the request is initiated, it changes very quickly from false -> true -> false;

hooks/src/commonMain/kotlin/xyz/junerver/compose/hooks/userequest/UseTableRequest.kt

@@ -7,6 +7,8 @@ import androidx.compose.runtime.remember
 import xyz.junerver.compose.hooks._useState
 import xyz.junerver.compose.hooks.useEffect
 import xyz.junerver.compose.hooks.useLatestRef
+import xyz.junerver.compose.hooks.userequest.utils.CachedData
+import xyz.junerver.compose.hooks.utils.CacheManager
 
 /**
  * Paged request parameters.
@@ -163,6 +165,24 @@ fun <T> useTableRequest(
             manual = true
             defaultParams = PageParams(latestPage.current, latestPageSize.current)
             options.requestOptions(this)
+            // Per-page caching: if user set cacheKey, use custom cache functions
+            // to generate unique keys for each page
+            if (cacheKey.isNotEmpty()) {
+                val baseCacheKey = cacheKey
+                setCache = { cachedData ->
+                    val params = cachedData.params as? PageParams
+                    val key = if (params != null) {
+                        "${baseCacheKey}_p${params.page}_s${params.pageSize}"
+                    } else {
+                        baseCacheKey
+                    }
+                    CacheManager.saveCache(key, cacheTime, cachedData)
+                }
+                getCache = { params ->
+                    val key = "${baseCacheKey}_p${params.page}_s${params.pageSize}"
+                    CacheManager.getCache<TableResult<T>>(key)
+                }
+            }
         }
     )