Struct AuditLogger 

pub struct AuditLogger { /* private fields */ }

Implementations

impl AuditLogger

pub fn for_data_path(data_path: &Path) -> Self

Place the audit log next to the primary .rdb file so backup

• restore flows can ship it together.

pub fn for_destination(dest: &LogDestination, fallback_data_path: &Path) -> Self

Resolve a crate::storage::layout::LogDestination into a concrete audit-log sink. File(p) writes to that exact path (Performance / Max tier route here). Stderr and Syslog fall back to the legacy .audit.log next to fallback_data_path — emit sites still get durable storage while the dedicated stderr / syslog sinks are not yet wired (ADR 0018 marks Syslog as a stub-and-warn lane).

pub fn with_path(path: PathBuf) -> Self

Direct constructor primarily for tests that want a custom path.

pub fn with_max_bytes(path: PathBuf, max_bytes: u64) -> Self

Test/integration constructor with explicit settings — bypasses env-var resolution so parallel tests don’t race on set_var.

pub fn path(&self) -> &Path

pub fn max_bytes(&self) -> u64

Active rotation threshold (bytes).

pub fn current_hash(&self) -> Option<String>

Latest tip-hash of the chain (for diagnostics + tests).

pub fn wait_idle(&self, timeout: Duration) -> bool

Block until the writer thread has drained every pending event. Tests use this to make assertions deterministic.

pub fn record( &self, action: &str, principal: &str, target: &str, result: &str, details: JsonValue, )

Back-compat record signature. Used by every existing emit site. Wraps into the new schema and forwards to record_event.

pub fn record_event(&self, event: AuditEvent)

Primary new entry point. Non-blocking when the channel has capacity; falls back to a sync write when full or the writer thread has shut down.

Trait Implementations

impl Debug for AuditLogger

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

Formats the value using the given formatter.

impl Drop for AuditLogger

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.