Struct ActionBinding 

pub struct ActionBinding<I> { /* private fields */ }

Type-safe adapter from a control’s input value to an exported action.

Construction requires the real Resource and ActionSpec, rather than parallel string constants. Emission pre-validates arguments against a clone of that spec; the host nevertheless re-resolves and validates again at dispatch time because this object is convenience, not authority.

Implementations

impl<I> ActionBinding<I>

pub fn new( resource: &Resource, spec: &ActionSpec, arguments: impl Fn(I) -> Map<String, Value> + Send + Sync + 'static, ) -> Result<ActionBinding<I>, ActionBindingError>

Bind a typed control value to arguments for an action actually exported by resource.

Errors

Returns ActionBindingError::ActionNotExported if spec is absent from resource.

pub fn fallible( resource: &Resource, spec: &ActionSpec, arguments: impl Fn(I) -> Result<Map<String, Value>, String> + Send + Sync + 'static, ) -> Result<ActionBinding<I>, ActionBindingError>

Self::new for an input that may not make arguments: a value that does not serialize, a form that does not fit the parameters. Such an input is refused when the control emits it, never sent empty.

Errors

Returns ActionBindingError::ActionNotExported if spec is absent from resource.

pub fn invoke(&self, input: I) -> Result<ControlInvocation, ActionBindingError>

Produce a host-routable intent after strict parameter validation.

Errors

Returns ActionBindingError::InvalidArguments if the mapped input violates the exported action’s parameter contract.

pub fn address(&self) -> &ActionAddress

impl ActionBinding<()>

pub fn unit( resource: &Resource, spec: &ActionSpec, ) -> Result<ActionBinding<()>, ActionBindingError>

Bind a nullary control to a nullary exported action.

Errors

Returns an error if the action is not exported or requires arguments.

pub fn unit_for( resource: &Resource, action_id: &str, ) -> Result<ActionBinding<()>, ActionBindingError>

Look up the real exported spec by stable id, then create a nullary binding. Useful when the resource is assembled inline or generated.

Errors

Returns an error if action_id is not exported or requires arguments.

pub fn static_json( resource: &Resource, spec: &ActionSpec, arguments: Map<String, Value>, ) -> Result<ActionBinding<()>, ActionBindingError>

Bind a control to a fixed, strictly validated JSON argument object.

Errors

Returns an error if the action is not exported or arguments violate its parameter contract.

pub fn static_json_for( resource: &Resource, action_id: &str, arguments: Map<String, Value>, ) -> Result<ActionBinding<()>, ActionBindingError>

Look up the real exported spec by id, then bind fixed JSON arguments.

Errors

Returns an error if action_id is not exported or arguments violate its parameter contract.

Trait Implementations

impl<I> Clone for ActionBinding<I>

where I: Clone,

fn clone(&self) -> ActionBinding<I>

Returns a duplicate of the value.

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

Performs copy-assignment from source.