Struct EventLog 

pub struct EventLog { /* private fields */ }

Local JSONL event log. Disabled (no-op) unless explicitly enabled.

Construct with EventLog::from_env for the documented opt-in behavior, or with EventLog::new / EventLog::disabled to pin a specific state (tests, adapters).

Implementations

impl EventLog

pub fn disabled() -> Self

A disabled log: Self::record is a no-op that writes nothing.

pub fn new(path: impl Into<PathBuf>) -> Self

An enabled log pinned to a specific JSONL file path.

pub fn from_env() -> Self

Resolve from the environment.

Enabled iff AUTH_CLOUDFLARE_OBSERVABILITY is exactly "1". The log path is AUTH_CLOUDFLARE_EVENT_LOG when set, otherwise ~/.hermes/auth-cloudflare/events.jsonl (respecting HERMES_HOME). Any other value - including unset - yields a disabled no-op log.

pub fn is_enabled(&self) -> bool

True when events will actually be written.

pub fn path(&self) -> Option<&Path>

The log file path, when enabled.

pub fn record(&self, event: Event) -> Result<(), Error>

Append one event as a single JSON line.

No-op (returns Ok(())) when disabled. When enabled, the parent directory is created if needed, the file is opened in append mode, and the JSON object plus trailing newline is written in a single write_all. The file is created user-private (mode 0o600 on Unix).

Trait Implementations

impl Clone for EventLog

fn clone(&self) -> EventLog

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EventLog

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

Formats the value using the given formatter.