Struct Audited 

pub struct Audited<T: Entity> { /* private fields */ }

A wrapper that carries a mandatory audit comment with an entity. Only Audited<T> has a .save() method — bare entities cannot be saved directly. This enforces the “must comment on save” policy at compile time.

Implementations

impl<T: Entity> Audited<T>

pub fn new(entity: T, comment: impl Into<String>) -> Self

Create an audited wrapper with a validated, request-owned root reason.

The fluent constructor remains infallible in its type signature, but invalid input panics with the same code, location and repair guidance as MutationIntent. Callers handling untrusted input can validate it with MutationIntent::new before constructing this wrapper.

pub fn entity(&self) -> &T

Access the inner entity by reference.

pub fn entity_mut(&mut self) -> &mut T

Access the inner entity by mutable reference.

pub fn into_entity(self) -> T

Consume and return the inner entity with comment applied.

pub fn get_comment(&self) -> &str

Get the comment.