synckit 0.3.2

synckit: ^0.3.2 copied to clipboard

New Features #

Batch Operations Support

Added support for batch operations to perform multiple updates/deletes in a single Firestore write batch, improving performance and ensuring atomicity.

• [SyncBatch]: New class wrapping Firestore WriteBatch with a Completer<void> for async completion tracking.

  • batch: The underlying Firestore WriteBatch.
  • completer: A Completer<void> that completes when the batch is committed.
  • commit(): Commits the batch and completes the completer.

• [SyncManager]: Added batch operation methods:

  • batchUpdate(Dataset<T> data, SyncBatch syncBatch): Performs a batch update operation using the provided SyncBatch. Updates network first, waits for batch commit, then updates local storage.
  • batchRemove(Dataset<T> data, SyncBatch syncBatch): Performs a batch remove operation using the provided SyncBatch. Deletes from network first, waits for batch commit, then deletes from local storage.

• [SyncedState]: Added batch operation methods:

  • batchUpdate(T value, SyncBatch batch): Queues a value update in the batch and updates local state immediately. Note: Call batch.commit() after all batch operations.
  • batchRemoveAll(Iterable<String> ids, SyncBatch batch): Queues removal of multiple items by IDs in the batch and updates local state immediately.

Fixed bug of syncLocalWithNetworkOnFetch not working.

Breaking Changes #

• [NetworkStorage]: Renamed defaultDocPath parameter to path for better clarity and consistency.

New Features #

Collection-Based Storage Mode

Added support for collection-based storage in NetworkStorage, where each record is stored as a separate Firestore document instead of all records in a single document. This is useful for larger datasets or when you need to query individual records.

• New collectionBased parameter in NetworkStorage constructor to enable collection-based mode.
• New NetworkStorageCollectionBasedConfig<T> class for configuring collection-based storage:
  • getAllEnabled: Controls whether getAll is allowed for collection-based storage (default: true).
  • maxGetAllDocs: Maximum number of documents to fetch in getAll operations (default: 10).
  • defaultQuery: Default query function (QueryFn<T>) for filtering/ordering documents.
• New QueryFn<T> typedef: Query<T> Function(Query<T> colRef) for custom query builders.
• New getQuery method in NetworkStorage for querying collection-based storage with custom Firestore queries.

Sync Improvements

• [SyncManager]: Added syncLocalWithNetworkOnFetch parameter (default: true) to control whether local storage should be synchronized with network data on fetch operations.
• [SyncManager]: Added new fetchAndSyncFromNetwork getter that fetches data from the network and optionally clears and updates local storage to match.
• [SyncedState]: The refresh method now uses fetchAndSyncFromNetwork instead of allFromNetwork, ensuring local storage stays in sync with network data.
• [SyncedState]: Changed _params from late final to late to allow reassignment/reconfiguration.

Bug Fixes #

• [NetworkStorage.getAll]: Now returns an empty IMap<String, T> if the Firestore document doesn't exist, instead of throwing a null error.
• [NetworkStorage.writeBatchDelete]: Fixed return type to properly return void instead of an unintended value.

Internal Changes #

• All NetworkStorage methods (update, transactionUpdate, writeBatchUpdate, delete, transactionDelete, writeBatchDelete, clear) now fully support collection-based mode.
• Collection-based operations use WriteBatch for efficient bulk operations.
• Added Firestore withConverter support for type-safe document operations in collection-based mode.

Updated dependencies

Added new copyWith method to [StdObjParams].

Removed flutter_riverpod dependency. This should not be a Breaking Change, since none of the functionality actually depended on flutter_riverpod.

Added new refresh method in [SyncedState].

Fixed bug in [SyncedState]'s clear method, which now clears the state as well.

Fixed a bug in [SyncedState]'s update method, with sorting enabled, causing the newly added last element in the sorted dataset, to not be visible in state.

Fixed a bug in [SyncedState]'s update method, with sorting enabled.

[Breaking Change]: Replaced [hive_flutter] with [hive_ce_flutter].

[Breaking Change]: Replaced Ref<Dataset<T>> in NotifierProviderRef<Dataset<T>> in [SyncedState].

Contain important classes like [LocalStorage], [NetworkStorage], [StdObj], [StdObjParams], [SyncManager], [Synced] etc.