made-core 0.8.0

Domain core of MADE: entities, value objects, events, ports. No IO.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

//! Waking the host a delivery is addressed to.

use async_trait::async_trait;

use crate::error::DomainError;
use crate::value_objects::{
    HostActivationAdapterKind, HostActivationEnvelope, HostDeliveryRecord, IntegratorBinding,
};

use super::HostActivationOutcome;

/// Outbound contract for reaching a host that does not ask.
///
/// The engine hands over an envelope and learns whether it arrived.
/// What the host does next it does through the engine's own commands,
/// under their own authorization: an adapter here can wake a process
/// and can never grant it a permission.
///
/// Nothing in the envelope is ever executed. An adapter that runs
/// anything runs what its operator configured, with the envelope as
/// input, which is the difference between waking a host and letting a
/// payload choose a command.
#[async_trait]
pub trait HostActivationPort: Send + Sync {
    /// Hand one envelope to the bound host.
    async fn activate(
        &self,
        binding: &IntegratorBinding,
        record: &HostDeliveryRecord,
        envelope: &HostActivationEnvelope,
    ) -> Result<HostActivationOutcome, DomainError>;

    /// Which adapter this is, for discovery and for the receipt.
    fn kind(&self) -> HostActivationAdapterKind;
}