Struct WriteEvent 

pub struct WriteEvent { /* private fields */ }

Context provided to write callbacks describing what changed in the database.

For local writes (transaction commits), this contains a single entry. For remote writes (sync), this may contain a batch of entries that were received and stored together.

Catching up on missed writes

The previous_tips field contains the DAG tips of the database before the write(s) that triggered this callback. Consumers can use this to determine exactly what changed by walking the DAG from the current tips back to these previous tips. This is analogous to git log previous_tip..HEAD.

This design means callbacks never need to “miss” writes — even if multiple entries are batched (as in sync), the consumer can reconstruct the full set of changes from the tip diff.

Example

// Check what stores were touched
for entry in event.entries() {
    if entry.in_subtree("messages") {
        // A write touched the "messages" store
    }
}

// Use previous_tips to find what's new
let prev = event.previous_tips();
// Walk DAG from current tips back to prev to find all new entries

Implementations

impl WriteEvent

pub fn entries(&self) -> &[Entry]

Get the entries written in this event.

For local writes (transaction commits), this always contains exactly one entry. For remote writes (sync), this contains the full batch of entries received together.

pub fn previous_tips(&self) -> &[ID]

Get the DAG tips of the database before this write.

Use these to determine what changed: walk from the database’s current tips back to these previous tips to find all new entries.

pub fn source(&self) -> WriteSource

The source of this write (local commit or remote sync).

Trait Implementations

impl Clone for WriteEvent

fn clone(&self) -> WriteEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WriteEvent

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

Formats the value using the given formatter.