hexser 0.4.7

Zero-boilerplate hexagonal architecture with graph-based introspection
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

//! DomainEvent trait for significant occurrences in the domain.
//!
//! Domain events represent something that happened in the domain that domain
//! experts care about. They are immutable facts about the past and are used
//! for event sourcing, event-driven architectures, and communication between
//! bounded contexts. Events capture the intent and meaning behind state changes.
//!
//! Revision History
//! - 2025-10-01T00:00:00Z @AI: Initial DomainEvent trait definition with metadata.

/// Trait for domain events representing significant occurrences.
///
/// Domain events are immutable records of something that happened in the domain.
/// They capture the intent behind changes and enable event-driven architecture.
///
/// # Example
///
/// ```rust
/// use hexser::domain::DomainEvent;
///
/// struct UserRegistered {
///     user_id: String,
///     email: String,
///     timestamp: u64,
/// }
///
/// impl DomainEvent for UserRegistered {
///     fn event_type(&self) -> &str {
///         "UserRegistered"
///     }
///
///     fn aggregate_id(&self) -> String {
///         self.user_id.clone()
///     }
/// }
/// ```
pub trait DomainEvent {
  /// Returns the type name of this event.
  fn event_type(&self) -> &str;

  /// Returns the identifier of the aggregate that produced this event.
  fn aggregate_id(&self) -> String;
}

#[cfg(test)]
mod tests {
  use super::*;

  struct TestUserCreated {
    user_id: String,
    email: String,
  }

  impl DomainEvent for TestUserCreated {
    fn event_type(&self) -> &str {
      "UserCreated"
    }

    fn aggregate_id(&self) -> String {
      self.user_id.clone()
    }
  }

  #[test]
  fn test_domain_event_type() {
    let event = TestUserCreated {
      user_id: String::from("123"),
      email: String::from("test@example.com"),
    };
    assert_eq!(event.event_type(), "UserCreated");
  }

  #[test]
  fn test_domain_event_aggregate_id() {
    let event = TestUserCreated {
      user_id: String::from("123"),
      email: String::from("test@example.com"),
    };
    assert_eq!(event.aggregate_id(), "123");
  }
}