菜单
Automatically invalidate local caches after a specified time to live (ttl).
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
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');