Struct OpEvent 

pub struct OpEvent {

    pub schema_version: String,
    pub op_id: String,
    pub parent_id: Option<String>,
    pub session_id: String,
    pub timestamp: DateTime<Utc>,
    pub actor: Actor,
    pub kind: OpKind,
    pub payload: Value,
    pub canonical_payload_hash: String,
    pub preconditions: Option<Preconditions>,
    pub dry_run_impact: Option<DryRunImpact>,
    pub apply_result: Option<ApplyResult>,
    pub prev_event_hash: Option<String>,
    pub event_hash: Option<String>,
    pub extra: BTreeMap<String, Value>,
}

Universal event envelope wrapping every effectful workbook operation.

Fields

schema_version: String

Schema version tag for forward-compatible parsing.

op_id: String

Unique event identifier (ULID-style sorted string).

parent_id: Option<String>

Identifier of the previous event in this branch (forms a linked list).

session_id: String

Session this event belongs to.

timestamp: DateTime<Utc>

Wall-clock timestamp of event creation.

actor: Actor

Who or what created this event.

kind: OpKind

Namespaced operation kind (e.g. structure.clone_row).

payload: Value

Operation-specific payload (JSON object).

canonical_payload_hash: String

SHA-256 hash over the canonicalized payload JSON.

preconditions: Option<Preconditions>

Pre-apply validation constraints.

dry_run_impact: Option<DryRunImpact>

Computed impact from dry-run staging (populated during stage, before apply).

apply_result: Option<ApplyResult>

Result metadata after applying the event.

prev_event_hash: Option<String>

Hash of the previous event record (for tamper-detection chains).

event_hash: Option<String>

Hash of this entire event record (computed after serialization).

extra: BTreeMap<String, Value>

Forward-compatible catch-all for unknown fields.

Implementations

impl OpEvent

pub fn new( session_id: String, parent_id: Option<String>, actor: Actor, kind: OpKind, payload: Value, ) -> Self

Create a new event with the given parameters and compute the payload hash.

pub fn with_preconditions(self, preconditions: Preconditions) -> Self

Attach preconditions to this event.

pub fn with_dry_run_impact(self, impact: DryRunImpact) -> Self

Attach dry-run impact to this event.

pub fn with_apply_result(self, result: ApplyResult) -> Self

Record the apply result.

pub fn seal(&mut self)

Compute and set the event hash over the full serialized record.

pub fn validate_version(&self) -> Result<(), String>

Validate schema version compatibility.

Trait Implementations

impl Clone for OpEvent

fn clone(&self) -> OpEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OpEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for OpEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for OpEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.