Struct AuditEventBuilder 

pub struct AuditEventBuilder { /* private fields */ }

A fluent builder for AuditEvent.

Only event_type and description are required; every other field receives a sensible default (auto-generated id, SystemTime::now() timestamp, RiskLevel::Low, EventOutcome::Unknown, etc.).

Example

use auth_framework::audit::*;

let event = AuditEvent::builder(AuditEventType::LoginSuccess, "User logged in")
    .user_id("user_123")
    .session_id("sess_abc")
    .outcome(EventOutcome::Success)
    .with_actor("user", "user_123")
    .build();

assert_eq!(event.event_type, AuditEventType::LoginSuccess);
assert_eq!(event.user_id, Some("user_123".to_string()));

Implementations

impl AuditEventBuilder

pub fn new(event_type: AuditEventType, description: impl Into<String>) -> Self

Create a new builder with required fields.

pub fn user_id(self, id: impl Into<String>) -> Self

Set the user ID.

pub fn session_id(self, id: impl Into<String>) -> Self

Set the session ID.

pub fn outcome(self, outcome: EventOutcome) -> Self

Set the event outcome.

pub fn risk_level(self, level: RiskLevel) -> Self

Set the risk level.

pub fn with_actor( self, actor_type: impl Into<String>, actor_id: impl Into<String>, ) -> Self

Set actor information.

pub fn actor(self, actor: ActorInfo) -> Self

Set full actor information.

pub fn request_metadata(self, metadata: RequestMetadata) -> Self

Set request metadata.

pub fn resource(self, resource: ResourceInfo) -> Self

Set the affected resource.

pub fn correlation_id(self, id: impl Into<String>) -> Self

Set the correlation ID.

pub fn detail(self, key: impl Into<String>, value: impl Into<String>) -> Self

Insert a key-value pair into the event details.

pub fn details(self, details: HashMap<String, String>) -> Self

Set the full details map.

pub fn build(self) -> AuditEvent

Consume the builder and produce the AuditEvent.

Auto-generates a UUID id if one was not set, and sets the timestamp to SystemTime::now() if it was left at the default.