Struct AuditMetadata 

pub struct AuditMetadata {
    pub actor_id: String,
    pub actor_session_id: Option<String>,
    pub source_ip: Option<String>,
    pub user_agent: Option<String>,
    pub timestamp_utc_us: i64,
    pub causation_id: Option<Uuid>,
    pub correlation_id: Uuid,
}

Audit fields stamped on every persisted event.

See module docs for the lifecycle and reserved actor identifiers.

Fields

actor_id: String

Required. Aggregate UUID, "system", "anonymous", or "legacy-pre-hipaa". Must be non-empty after trim.

actor_session_id: Option<String>

Optional. The session this command was dispatched in. Pair with HIPAA-4 server-side session store for revocation.

source_ip: Option<String>

Optional. Source IP. None for system-internal commands.

user_agent: Option<String>

Optional. User-Agent header.

timestamp_utc_us: i64

Required. Microseconds since UNIX epoch. Must be > 0.

causation_id: Option<Uuid>

Optional. Event ID that triggered the command that produced this event (saga / projection-driven follow-up).

correlation_id: Uuid

Required. Groups every event from one logical request together. CommandContext::system synthesizes one for internal jobs.

Implementations

impl AuditMetadata

pub fn new( actor_id: impl Into<String>, correlation_id: Uuid, ) -> Result<Self, AuditError>

Construct a new validated AuditMetadata from raw inputs.

timestamp_utc_us is set from the system clock. Use [AuditMetadata::with_timestamp] to supply an explicit value (testing, replay, deterministic builds).

pub fn system() -> Self

Convenience constructor for system-internal jobs (cron, seeders, migrations). Synthesizes a correlation_id. Always passes validation.

pub fn pending() -> Self

Placeholder value used by Event::new. The CommandBus overwrites this with a real value from the request CommandContext before append. Calling validate() on a pending value returns AuditError::PendingNotStamped — the store rejects the write.

pub fn is_pending(&self) -> bool

True when audit == pending(). Stores reject pending audits at append-time.

pub fn validate(&self) -> Result<(), AuditError>

Defense-in-depth validation. Stores call this at the top of append.

Trait Implementations

impl Clone for AuditMetadata

fn clone(&self) -> AuditMetadata

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AuditMetadata

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AuditMetadata

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for AuditMetadata

fn eq(&self, other: &AuditMetadata) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for AuditMetadata

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AuditMetadata