crdt_lf_persistence 0.1.0

The storage contract behind the crdt_lf persistence adapters, and the consumer that keeps a document on disk as it changes.

0.1.0

Date: 2026-09-07

First release. The storage contract behind the crdt_lf persistence adapters — the README has the API and the examples.

Added

• CRDTChangeStorage, CRDTSnapshotStorage, CRDTDocumentStorage and CRDTPeerIdStorage: what one document has on disk. crdt_lf_hive, crdt_lf_drift and crdt_lf_sqlite implement them, so code written against the contract runs on any adapter.

• CRDTStorageBackend: the database itself — storageForDocument, peerIdStorageForDocument, documentIds, deleteDocument, close.

• CRDTDocumentPersistence: keeps a CRDTDocument on disk as it changes. Writes are batched, a failed write is retried with a growing delay (250 ms, doubling, capped at 30 s), hasUnwrittenChanges says whether anything is still waiting, and compact() snapshots and prunes on demand. openSync restores before it returns, on a backend whose reads are synchronous, so a Flutter app builds its first frame from stored state.

• On the backend, everything an app does with a stored document: openDocument(id) (identity, document and restore in one call), readDocument(id) for a preview or a read-only view, documentAt(id, version) for a history view, and copyDocumentTo(other, id) for a backup or a move to another adapter. The three read-and-copy calls are also on a single CRDTDocumentStorage.

• CRDTChangeStorage.getChanges takes newerThan and upTo, both VersionVectors; filterByVersion is the fallback for a backend that cannot ask its own query language.

• newestSnapshot: which snapshot to restore from when a crash left two. Settled by version vector, then by the smaller id, so every backend answers the same from the same bytes.

• Every storage method returns a FutureOr, so a backend that answers without touching the disk never suspends; CRDTFutureOr.chain works on either.

• CRDTDocumentStorage.close() and transaction(), both with a working default, so an adapter only fills in what its backend can do.