offline_sync_engine 3.1.0

Offline-first CRDT-based sync engine with automatic conflict resolution. Seamlessly sync data across multiple devices with built-in implementations for quick start.

Changelog

All notable changes to this project are documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

3.1.0 - 2026-02-19

Changed

• Documentation updates for clarity and accuracy.
• Refined guides and examples to match latest project structure.

3.0.0 - 2026-02-19

Added

• Clearer inline comments and API docs in core sync files to improve maintainability.
• Additional tests for deterministic concurrent merge behavior and input validation.
• Detailed package review document (REVIEW_FEEDBACK.md) for file-by-file improvement planning.

Changed

• BREAKING: strengthened merge determinism for concurrent updates with overlapping fields.
• BREAKING: SyncManager now rejects empty deviceId and empty recordId values via ArgumentError.
• Improved operation ID generation in SyncManager (microseconds + local counter) to reduce collision probability in fast loops.
• README rewritten for cleaner onboarding, production checklist, and clearer adapter contracts.

Fixed

• Safer vector clock serialization by returning a copied map in VersionTracker.toJson().
• Guard added to prevent merging records with different IDs.

2.4.0 - 2026-02-18

Changed

• Documentation updates for clarity and accuracy.
• Refined guides and examples to match latest project structure.

2.3.0 - 2026-02-18

Changed

• Documentation updates for clarity and accuracy.
• Refined guides and examples to match latest project structure.

2.2.0 - 2026-02-18

Added

• Updated README.md with new repository URL (https://github.com/Harsh4114/offline_sync_engine).
• Added Pub Version badge to README.
• Added MIT License badge to README.
• Enhanced documentation with improved formatting and structure.

Changed

• Repository, homepage, and documentation URLs updated in pubspec.yaml.
• Improved package metadata for better discoverability.

2.1.0 - 2026-02-10

Added

• Multi-device example demonstrating cross-device synchronization.
• Delete operation example showcasing tombstone functionality.
• Custom adapters example for production use cases.
• Enhanced test documentation in test/README.md.
• Comprehensive inline code documentation.

Changed

• Improved test coverage to 30 tests with detailed scenarios.
• Enhanced README with better quick start guide.
• Reorganized examples directory with individual example files.

Fixed

• Edge cases in vector clock comparison.
• Memory leak in in-memory implementations during long-running operations.

2.0.0 - 2026-01-25

Added

• BREAKING: Built-in implementations (InMemoryDatabaseAdapter and InMemoryCloudAdapter).
• New example directory with practical usage examples.
• PUBLISHING_GUIDE.md for package publication instructions.
• Support for topics in pubspec.yaml (offline, sync, crdt, database, multi-device).
• Comprehensive test suite with 30+ test cases.
• Type-safe operations with full Dart null safety.

Changed

• BREAKING: Restructured library exports for better modularity.
• BREAKING: Updated minimum SDK to ">=3.0.0 <4.0.0".
• Improved CRDT merge algorithm for better performance.
• Enhanced documentation with detailed examples and use cases.
• Renamed internal methods for better clarity.

Fixed

• Conflict resolution issues in concurrent operations.
• Version tracking inconsistencies across devices.
• Idempotency bugs in operation replay.

Removed

• BREAKING: Legacy API methods (deprecated in v1.2.0).

1.0.0 - 2025-10-15

Added

• Initial release of Offline Sync Engine.
• Core SyncManager class for offline-first data synchronization.
• DatabaseAdapter interface for local storage abstraction.
• CloudAdapter interface for cloud backend abstraction.
• SyncOperation model for operation tracking.
• Basic CRDT-based conflict resolution.
• Automatic sync with push/pull functionality.
• Offline-first architecture.
• Operation-based synchronization.
• Basic test coverage.
• MIT License.
• Initial documentation and README.