TurboCollectionService<T extends TurboWriteableId<String>, API extends TurboFirestoreApi<T>> class abstract

A service for managing a collection of Firestore documents with synchronized local state.

The TurboCollectionService provides a robust foundation for managing collections of documents that need to be synchronized between Firestore and local state. It handles:

• Local state management with optimistic updates
• Remote state synchronization
• Batch operations
• Transaction support
• Error handling
• Automatic user authentication state sync

Type Parameters:

• T - The document type, must extend TurboWriteableId<String>
• API - The Firestore API type, must extend TurboFirestoreApi<T>

Example:

class UserService extends TurboCollectionService<User, UserApi> {
  UserService({required super.api});

  Future<void> updateUserName(String userId, String newName) async {
    final user = findById(userId);
    final updated = user.copyWith(name: newName);
    await updateDoc(doc: updated);
  }
}

Features:

• Automatic local state updates before remote operations
• Optimistic UI updates with rollback on failure
• Batch operations for multiple documents
• Transaction support for atomic operations
• Automatic stream update blocking during mutations
• Error handling and logging
• User authentication state synchronization