Struct AuthEvent 

pub struct AuthEvent {
    pub event: String,
    pub user_id: Option<String>,
    pub provider: Option<String>,
    pub status: String,
    pub duration_ms: f64,
    pub error: Option<String>,
    pub timestamp: String,
    pub request_id: Option<String>,
}

A structured log record for a single authentication event.

Constructed with AuthEvent::new and populated via builder methods. Call AuthEvent::log to emit the record through tracing.

Example

use fraiseql_auth::AuthEvent;
let event = AuthEvent::new("login")
    .with_user_id("user123".to_string())
    .with_provider("google".to_string())
    .success(42.5);
event.log();

Fields

event: String

Name of the authentication event (e.g., "login", "token_refresh").

user_id: Option<String>

Optional authenticated user ID associated with this event.

provider: Option<String>

OAuth provider name (e.g., "google", "okta").

status: String

Outcome: "started", "success", or "error".

duration_ms: f64

Duration of the operation in milliseconds.

error: Option<String>

Error message if the operation failed.

timestamp: String

RFC 3339 timestamp of when this event was created.

request_id: Option<String>

Optional correlation ID for tracing a request across services.

Implementations

impl AuthEvent

pub fn new(event: &str) -> Self

Create a new event record in the "started" state.

pub fn with_user_id(self, user_id: String) -> Self

Set the user ID associated with this event.

pub fn with_provider(self, provider: String) -> Self

Set the OAuth provider name for this event.

pub fn with_request_id(self, request_id: String) -> Self

Set the request correlation ID for distributed tracing.

pub fn success(self, duration_ms: f64) -> Self

Mark the event as successful and record its duration.

pub fn error(self, error: String, duration_ms: f64) -> Self

Mark the event as failed, recording the error and duration.

pub fn log(&self)

Emit this event through tracing at the appropriate level.

Successful events are logged at INFO; errors at WARN. Events in the "started" state are silently dropped.

Trait Implementations

impl Debug for AuthEvent

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

Formats the value using the given formatter.

impl Serialize for AuthEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.