Struct Ledger 

pub struct Ledger<E> { /* private fields */ }

Append-only JSONL ledger with per-day file rotation.

Generic over the event type E. For multi-writer scenarios, wrap in Arc<Mutex<Ledger<E>>> — the file-level flock is handled by the OS when opening for append.

Implementations

impl<E: Serialize + DeserializeOwned> Ledger<E>

pub fn open(base_dir: &Path) -> Result<Self>

Open (or create) a ledger directory.

pub fn append(&mut self, event: &E) -> Result<()>

Append one event to today’s JSONL file. Debounced fsync (≤1s).

pub fn base_dir(&self) -> &Path

pub fn flush(&mut self) -> Result<()>

pub fn scan_days(base_dir: &Path, days: u32) -> Vec<Result<E>>

Scan the most recent days daily files in chronological order. Skips malformed lines and missing files.