Struct JsonlFileSink 

pub struct JsonlFileSink { /* private fields */ }

JSONL file sink with a salted commitment chain.

Writes transcript.jsonl to a target directory, one line per call, flushed and synced before returning. The transcript is self-identifying: the chain of its last line is the fingerprint, and no sidecar file is written.

Implementations

impl JsonlFileSink

pub fn create(dir: &Path) -> Result<Self>

Create a new sink in dir. Writes transcript.jsonl next to it.

Errors

Returns an I/O error if the JSONL file cannot be created.

pub fn jsonl_path(&self) -> &Path

Path to the JSONL file this sink is writing to.

Trait Implementations

impl Debug for JsonlFileSink

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl TranscriptSink for JsonlFileSink

fn begin(&mut self, header: &TranscriptHeader) -> Result<()>

Write the header line. Must be called once, before any fact.

fn record( &mut self, at: DateTime<Utc>, level: Level, fact: &StepFact, ) -> Result<()>

Record a single fact at level, stamped with the caller-supplied event time at. Must persist before returning, the file-backed implementation calls sync_data so a power loss after record returns cannot drop the fact.

fn finalize(&mut self) -> Result<TranscriptFingerprint>

Finalize the transcript and return its fingerprint.