Menu
Automatically invalidate local caches after a specified time to live (ttl).
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Understand how sources declare operation capabilities via supportedOperations and how SourceList respects them.
FirestoreAdminSource connects google_cloud_firestore for server-side Dart applications to a SourceList.
FirestoreSource seamlessly connects Cloud Firestore streams to a SourceList.
Perform untyped Firestore document merges using the raw method on Firestore sources.
Cached data is mapped uniquely per request hash (RequestDetails with specific filter and pagination), supporting a powerful request-based caching behavior.
The SourceList class manages the delegation of read/write attempts to various configured Sources, with a read-thru cache system prioritizing local Sources.
| name | cache-expiry-ttl |
| description | Automatically invalidate local caches after a specified time to live (ttl). |
| metadata | {"last_modified":"Sat, 18 Apr 2026 1:52:50 GMT"} |
To automatically expire locally cached data, pass a ttl to the RequestDetails object when calling any read method. This will fetch data from the server and cache it locally under the context of the ttl.
final details = RequestDetails(
ttl: const Duration(minutes: 5),
);
await userRepository.getById('123', details: details);
// Wait 5 minutes...
// This will return null because the cache has expired.
final userWillBeNull = await userRepository.getById(
'123',
details: RequestDetails(
requestType: RequestType.local,
),
);
// However, a default request with the default [RequestDetails]
// will then fall back to the server and re-fetch User 123.
final refreshedUser123 = await userRepository.getById('123');