Added #

• Repositories now work without authUid for public/unauthenticated collections (e.g. static/config). Omitting authUid queries Firestore immediately instead of waiting for a signed-in user.
• Updated doc comments with public-collection usage examples

• Stable release — no API changes, just documentation polish
• Added doc comments to all public members across both repository types

Improved #

• Collection repo now primes UI from Firestore local cache before starting the live subscription, giving instant data on revisits
• Incremental snapshot processing via docChanges — only re-parses added/modified/removed documents instead of deserializing the full list on every snapshot event
• Per-item notifiers are now pruned (removed from the map) when documents leave the snapshot, preventing unbounded memory growth over long sessions

Breaking #

• Bumps command_it from ^8.0.0 to ^9.0.0
• Requires Dart >=3.8.0 and Flutter >=3.32.0
• write command on FirestoreDocRepository no longer accepts an unreachable merge parameter (always merges)

Fixed #

• Race condition in FirestoreDocRepository._swap on rapid auth changes (added epoch guard)
• _resizing flag in FirestoreCollectionRepository could get permanently stuck, breaking loadMore()
• Deleted documents now correctly clear value to null in FirestoreDocRepository
• Pagination limit now resets on query/dependency changes
• Per-item notifiers are nulled out when documents leave the snapshot
• All Command objects are now properly disposed

Improved #

• Bumps cloud_firestore to ^6.0.0, flutter_lints to ^6.0.0
• Fixes CI docs workflow (uses stable Flutter channel, gh-pages v4)
• Test coverage increased from 4 to 26 tests (94% line coverage)

• Adds paginate option to FirestoreCollectRepository to enable pagination of collection queries

• Improves example and README

• Formatting issue

• Adds better documentation, examples, and updates licence

• Initial release: single-doc and collection repositories
• Live-cache prime, metadata-churn squash
• Live-window pagination, per-item notifiers
• Simple CRUD commands