Struct RuntimeController 

pub struct RuntimeController { /* private fields */ }

Coordinates lifecycle, idempotency, command dispatch, events and audit.

Implementations

impl RuntimeController

pub fn new(instance: RuntimeInstance) -> Self

Creates a controller with process-local idempotency.

pub fn with_idempotency_store( instance: RuntimeInstance, idempotency: Box<dyn IdempotencyStore + Send + Sync>, ) -> Self

Creates a controller with an explicit idempotency store.

pub fn instance(&self) -> &RuntimeInstance

Returns the hosted immutable Runtime instance.

pub fn instance_arc(&self) -> Arc<RuntimeInstance>

Returns a shared reference-counted Runtime instance.

pub fn lifecycle(&self) -> &RuntimeLifecycle

Returns the process lifecycle.

pub fn idempotency_len(&self) -> usize

Returns the number of active idempotency records.

pub fn idempotency_contains(&self, key: &str) -> RuntimeResult<bool>

Reports whether an idempotency key has an active record.

pub fn apply_lifecycle_event( &mut self, event: RuntimeLifecycleEvent, ) -> RuntimeResult<RuntimeLifecycleState>

Applies one process lifecycle event.

pub fn dispatch_command( &mut self, command: &CommandEnvelope, context: &dyn RuntimeContext, ) -> RuntimeResult<CommandResult>

Runs the complete command dispatch transaction.

pub fn pre_dispatch( &self, command: &CommandEnvelope, ) -> RuntimeResult<Option<RuntimeResult<CommandResult>>>

Performs lifecycle and idempotency checks before handler execution.

pub fn post_dispatch( &self, command: &CommandEnvelope, dispatch_result: &RuntimeResult<CommandResult>, ) -> RuntimeResult<()>

Persists command outcome and emits accepted events after handler execution.