appcore_core/
event.rs

1// =============================================================================
2//        #######
3//     ###       ###     F: event.rs
4//    ##   ## ##   ##    P: AppCore-Runtime
5//         ## ##
6//                       C: 2026/05/29 20:47:35 by dnettoRaw
7//    ##   ## ##   ##    U: 2026/07/23 23:50:45 by dnettoRaw
8//      ###########      S: 1.0.1-rc.8
9// =============================================================================
10
11//! Event contract and ordered, duplicate-safe event registry.
12//! Event payload transport uses `EventEnvelope`.
13//! Handler outcomes may emit events through `CommandResult`.
14
15use crate::error::RuntimeResult;
16use crate::ids::EventName;
17use crate::registry::NameRegistry;
18
19/// Minimal runtime event contract.
20pub trait RuntimeEvent {
21    /// Returns the stable event name used for registration.
22    fn name(&self) -> &EventName;
23}
24
25/// Ordered registry of declared event names.
26#[derive(Debug, Default)]
27pub struct EventRegistry {
28    names: NameRegistry<EventName>,
29}
30
31impl EventRegistry {
32    /// Creates an empty event registry.
33    pub fn new() -> Self {
34        Self::default()
35    }
36
37    /// Registers an event name, rejecting duplicates.
38    pub fn register(&mut self, name: EventName) -> RuntimeResult<()> {
39        self.names.register(name, "event")
40    }
41
42    /// Reports whether an event name is registered.
43    pub fn contains(&self, name: &EventName) -> bool {
44        self.names.contains(name)
45    }
46
47    /// Returns the number of registered event names.
48    pub fn len(&self) -> usize {
49        self.names.len()
50    }
51
52    /// Reports whether no event names are registered.
53    pub fn is_empty(&self) -> bool {
54        self.names.is_empty()
55    }
56
57    /// Returns event names in registration order.
58    pub fn list(&self) -> &[EventName] {
59        self.names.list()
60    }
61}
62
63#[cfg(test)]
64#[path = "event_tests.rs"]
65mod tests;
appcore_core/event.rs

appcore_core/
event.rs
