local_first_sync 0.1.0

Local-first sync for Dart and Flutter: offline writes, a crash-safe queue, dependency-ordered operations, temp-id rewriting, and pluggable conflict resolution.

0.1.0

First release. Local-first sync for Dart and Flutter: writes land in local storage immediately and are pushed to a backend in the background.

• Local-first API. Collection<T> with save/delete/get/getAll/ watch/watchById. Writes never block on the network.
• Dependency-aware queue. Pass an earlier operation's id as dependsOn and the dependent waits for it. A dependency that fails permanently blocks its dependents — never silently drops them — with a human-readable reason.
• Temporary ids. When the server assigns a different id on create, queued dependents have their declared referenceFields rewritten before they send.
• Crash-safe queue. PersistentSyncQueue writes through to any SyncOperationStore; an operation interrupted mid-flight is re-sent under its original idempotency key.
• Pull sync (opt-in). Implement PullableRemoteStore and call pullNow(). A pull never overwrites an entity that still has unsynced local work queued.
• Operation coalescing. N offline edits to one record cost one request; create-then-delete before either syncs costs none.
• Queue control. pause/resume, retryOperation, retryAllFailed, cancelOperation, purgeCompleted, plus retention of completed operations.
• Ordering guarantees. Priority first, then strict FIFO; two operations on the same entity never run concurrently.
• Retry policy with exponential backoff, jitter, a per-operation timeout, and a timer that actually fires when the backoff elapses.
• Conflict resolution. ServerWins, ClientWins, LastWriteWins, and CustomResolver for field-level merges.
• Optimistic rollback (opt-in) when the backend permanently rejects a write.
• SyncState — one stream for a status bar: connectivity, in-flight, per-status counts, lastSyncedAt, lastError.
• SyncInspector — read-only diagnostics with a plain-English explain(operation) and optional payload redaction.

Ships with in-memory LocalStore/RemoteStore implementations for tests and prototyping. Production adapters (Drift, REST) are yours to write — see the README.