Skip to main content

appcore_sync/
sync.rs

1// =============================================================================
2//        #######
3//     ###       ###     F: sync.rs
4//    ##   ## ##   ##    P: AppCore-Runtime
5//         ## ##
6//                       C: 2026/05/31 13:38:42 by dnettoRaw
7//    ##   ## ##   ##    U: 2026/07/24 16:07:49 by dnettoRaw
8//      ###########      S: 1.0.1-rc.8
9// =============================================================================
10
11//! Minimal sync contracts and local implementations.
12mod checkpoint;
13mod chunk;
14mod client;
15mod codec;
16mod conflict;
17mod discovery;
18mod error;
19mod log;
20mod log_file;
21mod log_file_format;
22mod message_json;
23mod outbox;
24mod outbox_format;
25mod outbox_journal;
26mod outbox_journal_state;
27mod outbox_journal_view;
28mod outbox_size;
29mod outbox_stream;
30mod persistence;
31mod receiver;
32mod retry;
33mod revision;
34mod snapshot;
35mod transport;
36mod types;
37mod wire;
38
39pub use checkpoint::{
40    FileSyncCheckpointStore, InMemorySyncCheckpointStore, SyncCheckpointStore,
41    MAX_CHECKPOINT_FILE_BYTES, MAX_CHECKPOINT_PEER_ID_BYTES, MAX_CHECKPOINT_RECORDS,
42    SYNC_CHECKPOINT_FORMAT_V1,
43};
44pub use chunk::{
45    split_sync_payload, SyncChunkAssembler, SyncChunkInsert, SyncChunkProgress, SyncChunkRange,
46    SyncPayloadChunk, MAX_SYNC_CHUNKS, MAX_SYNC_CHUNK_BYTES, MAX_SYNC_CHUNK_TOTAL_BYTES,
47    MAX_SYNC_TRANSFER_ID_BYTES,
48};
49pub use client::FollowerSyncClient;
50pub use conflict::{
51    InMemorySyncConflictStore, SyncConflict, SyncConflictKind, SyncConflictResolution,
52    SyncConflictResolutionReceipt, SyncConflictResolutionRequest, SyncConflictStore,
53    MAX_CONFLICT_ID_BYTES, MAX_CONFLICT_REASON_BYTES, MAX_SYNC_CONFLICTS,
54};
55pub use discovery::{discover_dns_sync_peers, SyncPeerAddress, SyncPeerScheme};
56pub use error::{SyncError, SyncResult};
57pub use log::{
58    FileReplicationLog, InMemoryReplicationLog, ReplicationLog, MAX_REPLICATION_PAGE_BYTES,
59    MAX_REPLICATION_PAGE_RECORDS, MAX_SYNC_BATCH_PAYLOAD_BYTES, REPLICATION_LOG_FORMAT_V1,
60};
61pub use message_json::write_sync_message_json;
62pub use outbox::{
63    FileSyncOutbox, InMemorySyncOutbox, SyncOutbox, SyncOutboxReceipt, SyncOutboxStats,
64    MAX_OUTBOX_PAGE_BYTES, MAX_OUTBOX_PAGE_MESSAGES, SYNC_OUTBOX_FORMAT_V2,
65};
66pub use outbox_size::encoded_sync_message_bytes;
67pub use receiver::{SyncReceiveAck, SyncReceiverState};
68pub use retry::{SyncPushMetrics, SyncRetryPolicy};
69pub use revision::{
70    decide_object_revision_v1, validate_checkpoint_head_v1, ObjectRevisionV1, RevisionChainV1,
71    RevisionDecisionV1, MAX_REVISION_CHAIN_V1,
72};
73pub use snapshot::{ReplicationSnapshot, ReplicationSnapshotRecord, SYNC_SNAPSHOT_FORMAT_V1};
74pub use transport::{
75    decode_sync_message, HttpSyncTransport, SyncTransport, MAX_SYNC_REQUEST_BODY_BYTES,
76};
77pub use types::{
78    compute_events_hash, HeartbeatMessage, LeaderElection, NodeRole, PeerInfo, SyncMessage,
79    SyncStatus,
80};
81pub use wire::{
82    decode_sync_envelope, encode_sync_envelope_v1, SyncEnvelopeV1, SYNC_WIRE_SCHEMA_V1,
83};
84
85#[cfg(test)]
86pub(crate) use transport::read_http_request_body;
87
88#[cfg(test)]
89mod sync_tests;