onlyne-store 2.0.0

Onlyne SQLite persistence
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

//! SQLite persistence for Onlyne.
//!
//! ## Schema versus plan
//!
//! Every timestamp column in both databases is written by this crate's conversion helpers, `unix_to_rfc3339` and `rfc3339`, and no caller supplies a raw stored value: the kernel's `i64` seconds (`SessionWrite`, `ServerFaultRow`, `VersionedSession`, `FaultRecord`) convert at the write, and the one text input, `RoleRow::updated_at` from the server's `upsert_role` call sites, is re-encoded through the same helpers before the insert.
//! The server `ledger.body_json` column is nullable because retention pruning clears acknowledged bodies after the cutoff.
//! Extra indexes support ledger pulls, fault deduplication, due-intent ordering, and event-cursor scans.
//! `schema_marker` records the v1.0.0 schema and protocol gate for each database.

mod client;
mod error;
mod liveness;
mod server;
pub mod session;
pub use client::{CLIENT_DDL, ClientStore, INTENT_FLUSH_BATCH_SIZE, IntentRow, TaskRow};
pub use error::{StoreError, StoreResult};
pub use server::{
    Append, CursorRow, EventRecord, FaultQuery, GhostSweepRow, LedgerRow, RoleRow, SERVER_DDL,
    ServerFaultRow, ServerLedger, ServerSessionRow, SessionBindingRow, SessionWrite, rfc3339,
};
pub use session::{FaultRecord, SessionLedger, SessionRecord, VersionedSession};

pub use onlyne_proto::LedgerState;

pub fn transition_allowed(from: LedgerState, to: LedgerState) -> bool {
    matches!(
        (from, to),
        (LedgerState::Queued, LedgerState::InFlight)
            | (LedgerState::Queued, LedgerState::Rejected)
            | (LedgerState::Queued, LedgerState::Expired)
            | (LedgerState::InFlight, LedgerState::Acked)
            | (LedgerState::InFlight, LedgerState::Queued)
            | (LedgerState::InFlight, LedgerState::Rejected)
    )
}