Menu
Perform untyped Firestore document merges using the raw method on Firestore sources.
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.
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.
ConnectivityPlusStream provides a stream of network statuses based on connectivity_plus so DefaultRetryPolicy can intelligently manage failed Operations.
| name | untyped-raw-merges |
| description | Perform untyped Firestore document merges using the raw method on Firestore sources. |
| metadata | {"last_modified":"Wed, 22 Jul 2026 15:00:00 GMT"} |
FirestoreSource (in pkg:data_layer_firestore) and FirestoreAdminSource (in pkg:data_layer_firestore_admin) support untyped document merges via .raw(id, map).
Use .raw when you need to merge an arbitrary Map<String, Object?> into a document without serializing or deserializing a full model object (for example, updating a timestamp or partial field flag).
// Merge arbitrary json into a document with ID 'user_123'
await firestoreSource.raw('user_123', {
'lastActive': DateTime.now(),
'metadata': {
'version': '1.2.0',
},
});
Key features:
DateTime objects (and ISO 8601 strings) into Firestore Timestamp objects via cleanDataForWrite.