Struct LogEntry 

pub struct LogEntry {
    pub hlc: HlcTimestamp,
    pub node_id: String,
    pub table: TableId,
    pub op: WriteOp,
    pub prev_hlc: Option<HlcTimestamp>,
    pub prev_value: Option<Vec<u8>>,
    pub originator: Originator,
    pub request_id: Option<String>,
    pub interface: Option<String>,
}

A single durable record of a committed write.

Persisted to the per-deployment TransactionLog at commit time. Both audit and replication observers consume from this log:

• Replication tail-reads by HLC: streams new entries to peers, filtering out Originator::Replicated writes so applied- from-peer entries don’t echo back.
• Audit range-reads by HLC + filters by table / originator / user for query responses.

Wire-stable (serde-derived) because LogEntry frames also flow across the replication network protocol between nodes.

Fields

hlc: HlcTimestamp

HLC timestamp assigned at commit time. Strictly greater than any previously-appended entry’s HLC on the same node.

node_id: String

Node id of the node that PERSISTED this entry (the node that observed the commit). Both locally-originated and replication- applied writes log here, so node_id is always the local node. Distinguished from Originator::Replicated::from_node which records the conceptual writer.

table: TableId

In-deployment table identity.

op: WriteOp

The write operation that was committed.

prev_hlc: Option<HlcTimestamp>

HLC of the existing record at this key prior to the write, if any. None for inserts. Used by anti-entropy to record causal predecessor relationships for the receive-side HLC-LWW comparison.

prev_value: Option<Vec<u8>>

Raw bytes of the existing record at this key prior to the write, if the table opted into @audit(capture_state: true) and the LoggingBackend was configured with capture_before: true. None when capture was disabled OR the key didn’t exist (insert path). Decoded as JSON by audit readers to surface as AuditEntry.before.

Storage cost is significant — each captured write doubles the log entry size plus pays one extra get at write time — so this is opt-in per table via the @audit directive.

Note: encoded inline (not skip_serializing_if) because the wire format is rmp-serde tuple-positional; skipping fields breaks the decoder’s positional expectations.

originator: Originator

Who / what initiated the write.

request_id: Option<String>

Optional correlation id for traceability — typically the request id from the HTTP / MQTT / gRPC layer.

interface: Option<String>

Which protocol / interface the write came in through — "rest", "graphql", "mqtt", "mcp", or "internal" for platform- originated writes. None when the originator couldn’t be determined (background tasks, startup bootstrap that didn’t set the task-local). Audit queries surface this for filtering.

Implementations

impl LogEntry

pub fn encode(&self) -> Result<Vec<u8>>

Serialize to MessagePack bytes for storage / wire.

Errors

Returns crate::error::YetiError::Internal if encoding fails (in practice, impossible for fully-owned LogEntry values; the Result is preserved for forward-compatibility with future fields that may have encoding constraints).

pub fn decode(bytes: &[u8]) -> Result<Self>

Deserialize from MessagePack bytes.

Errors

Returns crate::error::YetiError::Internal if the input is not a valid LogEntry encoding (truncation, version skew, or corruption on disk).

Trait Implementations

impl Clone for LogEntry

fn clone(&self) -> LogEntry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LogEntry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LogEntry

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for LogEntry

impl PartialEq for LogEntry

fn eq(&self, other: &LogEntry) -> 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 LogEntry

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 LogEntry