Struct EventLogger 

pub struct EventLogger { /* private fields */ }

Sends pre-serialized event JSON lines to the background writer task via an mpsc channel.

log() is non-blocking: if the channel is full (capacity 1024), the event is dropped with a warning rather than blocking the verdict path.

Architecture

EventLogger is the sender side; EventLoggerHandle owns the background task. The caller must drop EventLogger before calling EventLoggerHandle::shutdown() so the writer task sees the channel close and exits cleanly.

Events are accepted as pre-serialized JSON strings to avoid double serialization (struct → Value → String). The caller serializes once; the writer appends as-is.

Implementations

impl EventLogger

pub fn new(log_dir: PathBuf) -> (Self, EventLoggerHandle)

Create a new EventLogger and its background writer task.

Returns the logger (sender) and the handle (task owner) as a pair. The caller must hold the EventLoggerHandle until the daemon shuts down.

pub fn log(&self, event_json: String)

Send a pre-serialized JSON line to the background writer (non-blocking).

Uses try_send so the hot path never awaits channel capacity. If the channel is full or closed, the event is dropped with a warning.

Trait Implementations

impl Clone for EventLogger

fn clone(&self) -> EventLogger

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.