Struct SealedState 

pub struct SealedState { /* private fields */ }

Sealed key/value container with set-once semantics.

Each key can be written exactly once via put_once() or put_sensitive_once(). After that, the key is immutable for the container’s lifetime.

Consumers generally receive &SealedState (read-only), so the Rust borrow checker guarantees no writes occur during execution.

Sensitive keys

Keys set via set_sensitive() are redacted in Debug output. Use this for tokens, secrets, and other credentials.

No Serialize

SealedState intentionally does not implement Serialize, preventing accidental persistence. This is enforced at compile time.

Implementations

impl SealedState

pub fn new() -> Self

Create an empty sealed state.

pub fn put_once( &mut self, key: impl Into<String>, value: impl Serialize, ) -> Result<(), SealedStateError>

Set a key once. Returns error if key already exists.

pub fn put_sensitive_once( &mut self, key: impl Into<String>, value: impl Serialize, ) -> Result<(), SealedStateError>

Set a sensitive key once (redacted in Debug).

pub fn set( &mut self, key: impl Into<String>, value: impl Serialize, ) -> Result<(), SealedStateError>

Backward-compatible alias for put_once.

pub fn set_sensitive( &mut self, key: impl Into<String>, value: impl Serialize, ) -> Result<(), SealedStateError>

Backward-compatible alias for put_sensitive_once.

pub fn get<T: State>(&self) -> T::Ref<'_>

Get a typed state reference (same API as ctx.state::<T>()).

Returns a read-only StateRef backed by the sealed document. Any write through this ref will panic (read-only sink).

pub fn get_at<T: State>(&self, path: &str) -> T::Ref<'_>

Get a typed state reference at a dot-separated path.

pub fn value(&self, key: &str) -> Option<&Value>

Get a raw JSON value by key.

pub fn value_at(&self, path: &str) -> Option<&Value>

Get a raw JSON value at a dot-separated path.

pub fn is_sensitive(&self, key: &str) -> bool

Check if a key is marked sensitive.

pub fn contains_key(&self, key: &str) -> bool

Check if the container has a key.

Trait Implementations

impl Clone for SealedState

fn clone(&self) -> SealedState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SealedState

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

Formats the value using the given formatter.

impl Default for SealedState

fn default() -> Self

Returns the “default value” for a type.