WriteBatchWithReference<T> class

A container for a Firestore write batch and its most recently used document reference

This class helps track batch operations by keeping both the batch and the last document reference together. This is useful for:

• Chaining batch operations
• Accessing the last modified document
• Maintaining type safety in batch operations
• Building complex atomic updates

Example:

// Create a new user in a batch
final response = await api.createDocs(
  writeable: user,
  writeBatch: batch,
);

response.when(
  success: (result) async {
    // Access the batch and reference
    final batch = result.writeBatch;
    final userRef = result.documentReference;

    // Add more operations to the batch
    batch.update(userRef, {'status': 'active'});

    // Commit all changes atomically
    await batch.commit();
  },
  fail: (error) => print('Error: $error'),
);