qubit-event-bus 0.6.3

A lightweight, thread-safe in-process event bus for Rust
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

/*******************************************************************************
 *
 *    Copyright (c) 2026 Haixing Hu.
 *
 *    SPDX-License-Identifier: Apache-2.0
 *
 *    Licensed under the Apache License, Version 2.0.
 *
 ******************************************************************************/
//! Type-erased events staged for transactional publishing.

use std::any::{
    Any,
    TypeId,
};

use crate::EventEnvelopeMetadata;

/// Type-erased event staged inside a transaction.
pub trait StagedEvent: Send + 'static {
    /// Returns type-erased event metadata.
    ///
    /// # Returns
    /// Metadata copied from the staged envelope.
    fn metadata(&self) -> EventEnvelopeMetadata;

    /// Returns the payload [`TypeId`].
    ///
    /// # Returns
    /// Runtime type ID of the staged payload.
    fn payload_type_id(&self) -> TypeId;

    /// Returns the staged event as [`Any`] for typed downcasting.
    ///
    /// # Returns
    /// Type-erased reference to the concrete staged event.
    fn as_any(&self) -> &dyn Any;

    /// Converts the staged event into [`Any`] for typed ownership recovery.
    ///
    /// # Returns
    /// Type-erased boxed concrete staged event.
    fn into_any(self: Box<Self>) -> Box<dyn Any + Send>;
}