wavesyncdb 0.3.0

WaveSyncDB is a lightweight, distributed database synchronization engine designed to bridge the gap between real-time data streaming and relational storage. It ensures high-consistency data replication across decentralized nodes with a focus on low-latency updates.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

# wavesyncdb

Core library for WaveSyncDB — transparent peer-to-peer sync for SeaORM applications.

## Features

- **Connection wrapper** — `WaveSyncDb` implements SeaORM's `ConnectionTrait`, intercepting writes transparently
- **P2P sync** — libp2p gossipsub with mDNS discovery, QUIC and TCP transports
- **LWW conflict resolution** — hybrid logical clocks with deterministic tiebreakers
- **Persistent sync log** — `_wavesync_log` table tracks all operations for incremental sync
- **Schema builder** — fluent API to register entities for sync or local-only use

## Usage

```rust
use sea_orm::*;
use wavesyncdb::WaveSyncDbBuilder;

let db = WaveSyncDbBuilder::new("sqlite:./app.db?mode=rwc", "my-topic")
    .build()
    .await?;

// Register entities for sync
db.get_schema_registry(module_path!().split("::").next().unwrap())
    .sync()
    .await?;

// Use standard SeaORM operations — sync happens automatically
let task = task::ActiveModel { /* ... */ };
task.insert(&db).await?;
```

See the [root README](../README.md) for full documentation, architecture overview, and Dioxus integration.

## License

GPL-3.0-or-later