axess-events 0.2.0

Shared event vocabulary for the axess workspace and platform domains. The Event<P> envelope carries cross-cutting metadata (id, time, tenant, kind, subject, actor, trace context, status) while leaving the payload type-parameterised per domain. EventSink<P> is the trait every producer rides; concrete sinks include a no-op default and a LogAndSwallow wrapper for best-effort emission paths.
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

//! [`TraceContext`]: W3C Trace Context for cross-service span
//! correlation.
//!
//! The axess `trace-id` middleware populates this from the inbound
//! `traceparent` header; subscribers can join an event back onto its
//! originating request span.

/// W3C Trace Context fields. Self-contained so the envelope crate
/// doesn't pull in `opentelemetry` as a dependency; adopters wiring
/// OTEL translate the fields at their edge via
/// [`opentelemetry-http`](https://docs.rs/opentelemetry-http) +
/// [`tracing-opentelemetry`](https://docs.rs/tracing-opentelemetry).
///
/// Field shapes match the W3C `traceparent` header:
///   `00-<trace_id 32 hex>-<span_id 16 hex>-<flags 2 hex>`.
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
#[cfg_attr(
    feature = "rkyv",
    derive(rkyv::Archive, rkyv::Serialize, rkyv::Deserialize)
)]
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub struct TraceContext {
    /// 128-bit trace identifier (W3C trace-id).
    pub trace_id: [u8; 16],
    /// 64-bit span identifier (W3C parent-id).
    pub span_id: [u8; 8],
    /// W3C trace-flags byte (sampled bit, etc.).
    pub flags: u8,
}

impl TraceContext {
    /// All-zero trace context, represents "no upstream context".
    pub const NIL: Self = Self {
        trace_id: [0; 16],
        span_id: [0; 8],
        flags: 0,
    };
}

impl Default for TraceContext {
    fn default() -> Self {
        Self::NIL
    }
}