convert refTimeout to keepAliveDuration extension

packages/pub/pagination/README.md

@@ -49,12 +49,13 @@ PaginatedView(
 Implement a `PaginatedResult` for your API response. This result can then be used
 anywhere a `PaginatedResult` is expected, such as with `PaginatedView`.
 
-### Ref Timeout
+### Keep Alive Duration
 
-Keeps a `Provider` alive for a given `Duration`.
+Keeps an `autoDispose Provider` alive for a given `Duration` even if
+the provider is no longer used.
 
 ```dart
-applyRefTimeout<T>(
+keepAliveDuration<T>(
   AutoDisposeRef<T> ref, [
   Duration duration = const Duration(seconds: 30),
 ])

packages/pub/pagination_dart/README.md

@@ -49,12 +49,13 @@ class MyPaginatedResult<T> with MyPaginatedResultMappable<T>
 }
 ```
 
-### Ref Timeout
+### Keep Alive Duration
 
-Keeps a `Provider` alive for a given `Duration`.
+Keeps an `autoDispose Provider` alive for a given `Duration` even if
+the provider is no longer used.
 
 ```dart
-applyRefTimeout<T>(
+keepAliveDuration<T>(
   AutoDisposeRef<T> ref, [
   Duration duration = const Duration(seconds: 30),
 ])

packages/pub/pagination_dart/lib/pagination_dart.dart

@@ -4,4 +4,4 @@
 library;
 
 export 'src/paginated_result.dart';
-export 'src/ref_timeout.dart';
+export 'src/keep_alive_duration.dart';

packages/pub/pagination_dart/lib/src/keep_alive_duration.dart

@@ -0,0 +1,26 @@
+import 'dart:async';
+
+import 'package:riverpod/riverpod.dart';
+
+extension KeepAliveDurationExtension<T> on AutoDisposeRef<T> {
+  /// Keeps a [Ref] alive for a given [duration].
+  ///
+  /// Any inflight requests will need to be cancelled separately.
+  void keepAliveDuration([Duration duration = const Duration(seconds: 30)]) {
+    // When a provider is no-longer used, keep it in the cache for some time
+    final link = keepAlive();
+    Timer? timer;
+
+    onDispose(() {
+      timer?.cancel();
+    });
+
+    onCancel(() {
+      timer = Timer(duration, link.close);
+    });
+
+    onResume(() {
+      timer?.cancel();
+    });
+  }
+}