crdt_lf 2.2.0

Conflict-free replicated data type (CRDT) - Local-first implementation provided in dart

2.2.0

Date: 2025-11-22

compare to previous release

Changed

• chore: improved documentation about version vector
• Can import snapshot even if there are newer changes in the document

Fixed

• chore: fixed references links
• Fix CRDTDocument.applyChange to correctly handle dependencies that were pruned from the DAG 50

2.1.0

Date: 2025-10-31

compare to previous release

Added

• Added change operation to CRDTFugueTextHandler and CRDTTextHandler 12
• Added CRDTORMapHandler 41

Changed

• chore: improved Fugue text handler change implementation

Fixed

• Fixed deserialization of Map values in CRDTFugueTextHandler operations

2.0.0

Date: 2025-09-16

compare to previous release

Breaking changes

• Changed CRDTFugueTextHandler operations payload

Added

• Created a set of mixins to be used by handlers to optimize performance during operation insertions.
• Thrown HandlerAlreadyRegisteredException when a handler is registered twice
• Added TransactionManager to manage transactional batching of notifications and local changes emission 43
• Added compound "system" to compact consecutive operations during transaction 45
• Added CRDTORSetHandler 42

Changed

• On importChanges listeners of updates are notified only one times at import end
• Handlers now not invalidate cache when an operation is applied due to the new mixins system. This greatly improves the computation of the handler value as it is persisted much more often.
• chore: improved handlers benchmark system

Fixed

• CRDTMapHandler updating an absent key is ignored

1.0.0

Date: 2025-08-18

compare to previous release

Breaking changes Create a set of exception classes to be used across the library. Replace StateError with CrdtException and its subclasses.

• applyChange: throws CausallyNotReadyException instead of StateError when a change's dependencies are not met;
• On import when a cycle is detected among changes throws ChangesCycleException instead of StateError;
• On add node when a node already exists throws DuplicateNodeException instead of StateError;
• On add node when a dependency is missing throws MissingDependencyException instead of StateError;
• On Fugue tree insertion when a node already exists throws DuplicateNodeException instead of Exception.

Removed redundant hlc from Change. change.hlc is also available as getter 37

Hlc in version vector is now serialized as string instead of int64. This avoids precision loss when serialized as JSON for web interoperability.

Added

• documentId to CRDTDocument, specified document identity to remove ambiguity between peer and document 38
• toString to Snapshot and VersionVector
• added a stream to CRDTDocument to be notified of every change (changes, snapshots, merges, ...)
• added mutable and method to VersionVector to create mutable copies
• added a export changes method to CRDTDocument to export changes that are newer than a given version vector

Changed

• chore: setup .github/workflows and update coverage links 33
• chore: update readme with recommended approach for complex handler types
• chore: update topological sort implementation 3
• chore: added benchmarks

Fixed

• Fix CRDTFugueTextHandler to ensure state is synchronized before performing operations 39
• Fix readme reference links
• Fix double hlc increment on CRDTDocument.createChange
• Fix snapshot initialization for handlers that return a non primitive value

0.8.0

Date: 2025-07-08

compare to previous release

Added

• Added update operation for every handler 30

0.7.1

Date: 2025-06-26

compare to previous release

Changed

• Update documentation

0.7.0+1

Date: 2025-06-14

compare to previous release

Fixed

• Chore: update readme links

0.7.0

Date: 2025-06-14

compare to previous release

Added

• CRDTDocument.mergeSnapshot to merge a snapshot with the current snapshot
• CRDTDocument.import to import changes and snapshots with a single method and different strategies

Changed

• On changes pruning, if a change has a dependency on a pruned change, the dependency is removed to preserve integrity

0.6.1

Date: 2025-06-02

compare to previous release

Fixed

• Fix snapshot initialization for handlers that return a non primitive value

0.6.0

Date: 2025-05-10

compare to previous release

Breaking

• Operation.toPayload is now a Map<String, dynamic> instead of dynamic (every operation was already returning a Map<String, dynamic>)

Added

• CRDTMapHandler: a new handler for maps 13

Changed

• chore: apply linter rules
• chore: more documentation on public api

0.5.1

Date: 2025-05-08

compare to previous release

Fixed

• Fix folder name clash with gitignore rules

0.5.0

Date: 2025-05-07

compare to previous release

Breaking

• rename document.import in document.binaryImportChanges
• rename document.export in document.binaryExportChanges

Added

• Snapshot implementation 14
• Version vector (foundational for building snapshots)

Fixed

• Fix Fugue tree insertion

0.4.0

Date: 2025-04-29

compare to previous release

Changed

• chore: move test utils under helpers folder

0.3.0

Date: 2025-04-21

compare to previous release

Added

• CRDTDocument expose localChanges stream to listen to local changes 18
• flutter_example contains a routing with a basic example for each use case (currently only todo list)16
• Split Fugue algorithm from text handler 4

0.2.0

Date: 2025-04-09

compare to previous release

Added

• Tests 6

Fixed

• Fix cached value in handlers

0.1.0

Date: 2025-04-01

Initial release

Added

• CRDTDocument with ChangeStore and Frontiers
• CRDTTextHandler
• CRDTListHandler
• CRDTFugueTextHandler