Struct ComponentChange 

pub struct ComponentChange<'a> {
    pub component_id: ComponentId,
    pub op: ComponentOp,
    pub actor: ActorAuthority,
    pub old_value: Option<&'a [u8]>,
    pub new_value: Option<&'a [u8]>,
    pub proposer: Option<InboxId>,
    pub is_dm_participant: bool,
    pub key: Option<&'a [u8]>,
    pub membership: Option<&'a HashSet<InboxId>>,
}

A change being proposed against a component, used as the input to validate_component_write.

Carries everything a base policy may read: the component, the element operation and key, the authenticated proposer and its roles, and the membership after the commit. It never carries the value being written into policy evaluation; new_value feeds only component invariants.

old_value is the whole component before this proposal (None when absent). Immutability reads it: an absent immutable component accepts one first scalar Update or collection Inserts.

Construct via the generated builder so that old_value and new_value (which share the same type) can’t be accidentally swapped:

let change = ComponentChange::builder()
    .component_id(ComponentId::GROUP_NAME)
    .op(ComponentOp::Update)
    .actor(actor)
    .old_value(&old_bytes)
    .new_value(&new_bytes)
    .build();

Fields

component_id: ComponentId

op: ComponentOp

actor: ActorAuthority

old_value: Option<&'a [u8]>

new_value: Option<&'a [u8]>

proposer: Option<InboxId>

The authenticated proposer. None fails every self test closed.

is_dm_participant: bool

Whether the proposer is one of the conversation’s DM_MEMBERS.

key: Option<&'a [u8]>

TLS encoding of the element key for a map or registry mutation; None for a scalar, a set, or a whole-component Remove.

membership: Option<&'a HashSet<InboxId>>

Inbox ids in GROUP_MEMBERSHIP after the commit, or the committed membership for a standalone proposal. None fails every non-member test closed.

Implementations

impl<'a> ComponentChange<'a>

pub fn builder() -> ComponentChangeBuilder<'a>

Create an instance of ComponentChange using the builder syntax

Trait Implementations

impl<'a> Clone for ComponentChange<'a>

fn clone(&self) -> ComponentChange<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for ComponentChange<'a>

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

Formats the value using the given formatter.