Struct AuditEvent 

pub struct AuditEvent {
    pub ts: u128,
    pub event_id: String,
    pub principal: Option<String>,
    pub source: AuditAuthSource,
    pub tenant: Option<String>,
    pub action: String,
    pub resource: Option<String>,
    pub outcome: Outcome,
    pub detail: Value,
    pub remote_addr: Option<String>,
    pub correlation_id: Option<String>,
}

Structured audit event. Serialised as one JSONL row per call.

Fields

ts: u128

event_id: String

principal: Option<String>

source: AuditAuthSource

tenant: Option<String>

action: String

resource: Option<String>

outcome: Outcome

detail: Value

remote_addr: Option<String>

correlation_id: Option<String>

Implementations

impl AuditEvent

pub fn builder(action: impl Into<String>) -> AuditEventBuilder

Convenience builder. The caller fills the required fields and chains the optional ones — keeps emit sites readable.

pub fn from_legacy( action: &str, principal: &str, target: &str, result: &str, details: Value, ) -> AuditEvent

Wrap a pre-structured-API call into the new schema. Used by the back-compat record(action, principal, target, result, details) path so existing emit sites keep compiling.

pub fn to_json_line(&self, prev_hash: Option<&str>) -> String

Render to a single JSONL line, optionally seeded with a prev_hash for the tamper-evident chain.

pub fn parse_line(line: &str) -> Option<AuditEvent>

Parse one JSONL line back into an AuditEvent. Returns None for legacy lines (pre-restructuring) or malformed JSON; callers in the query path use this to filter.

Trait Implementations

impl Clone for AuditEvent

fn clone(&self) -> AuditEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AuditEvent

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

Formats the value using the given formatter.