Struct EventMetadata 

pub struct EventMetadata { /* private fields */ }

Fields shared by every event: timestamp, raw bytes, and raw-bytes hash.

Constructed via EventMetadata::new, which computes the raw_bytes_hash from raw_bytes to enforce the invariant that the hash always matches. This is critical for server-side deduplication via event fingerprints.

The timestamp is Option<DateTime<Utc>> because some log entries lack a parseable timestamp in the header. None means “no timestamp found in the log entry” — downstream consumers must handle this explicitly rather than receiving a synthetic Utc::now() that would break fingerprinting and chronological ordering.

All fields are private to protect the hash invariant. Use the accessor methods to read them.

Deserialization also enforces this invariant: the hash is recomputed from raw_bytes during deserialization rather than trusting the serialized value.

Implementations

impl EventMetadata

pub fn new(timestamp: Option<DateTime<Utc>>, raw_bytes: Vec<u8>) -> Self

Creates a new EventMetadata, computing raw_bytes_hash as the SHA-256 digest of raw_bytes.

timestamp is None when the log entry header did not contain a parseable timestamp. This preserves the distinction between “real timestamp from the log” and “no timestamp available” for downstream consumers.

pub fn timestamp(&self) -> Option<DateTime<Utc>>

Returns the UTC timestamp parsed from the log entry header, or None if the entry did not contain a parseable timestamp.

pub fn raw_bytes(&self) -> &[u8]

Returns the original log entry bytes.

pub fn raw_bytes_hash(&self) -> &[u8; 32]

Returns the SHA-256 hash of raw_bytes.

Trait Implementations

impl Clone for EventMetadata

fn clone(&self) -> EventMetadata

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for EventMetadata

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for EventMetadata

Custom Deserialize that recomputes raw_bytes_hash from raw_bytes, ensuring the hash invariant survives serialization round-trips.

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for EventMetadata

fn eq(&self, other: &EventMetadata) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for EventMetadata

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for EventMetadata