sipp-rs 0.1.0

Unified Rust library for extensible Sipp inference
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
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

use thiserror::Error;

/// Result returned by the protocol-neutral gateway pipeline.
pub type GatewayResult<T> = Result<T, GatewayError>;

/// Stable pipeline failure categories without transport semantics.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum GatewayErrorKind {
    /// Target resolution failed.
    Resolution,
    /// Authorization denied execution.
    Authorization,
    /// Admission policy rejected execution.
    Admission,
    /// Typed request validation failed.
    InvalidRequest,
    /// Execution failed.
    Execution,
    /// Execution was cancelled.
    Cancelled,
    /// Pipeline infrastructure failed.
    Internal,
}

/// Protocol-neutral gateway pipeline error.
#[derive(Debug, Clone, Error)]
#[error("gateway pipeline error ({kind:?}): {message}")]
pub struct GatewayError {
    /// Stable pipeline category.
    pub kind: GatewayErrorKind,
    /// Human-readable diagnostic.
    pub message: String,
}

impl GatewayError {
    /// Create a pipeline error.
    pub fn new(kind: GatewayErrorKind, message: impl Into<String>) -> Self {
        Self {
            kind,
            message: message.into(),
        }
    }
}

impl From<crate::client::SippError> for GatewayError {
    fn from(error: crate::client::SippError) -> Self {
        use crate::client::SippError;

        let kind = match error {
            SippError::Cancelled { .. } => GatewayErrorKind::Cancelled,
            SippError::InvalidRequest(_)
            | SippError::EndpointNotFound(_)
            | SippError::AmbiguousEndpoint { .. }
            | SippError::NoSupportedEndpoint { .. }
            | SippError::UnsupportedOperation { .. } => GatewayErrorKind::InvalidRequest,
            SippError::Internal(_) => GatewayErrorKind::Internal,
            SippError::Local(_) | SippError::Endpoint(_) => GatewayErrorKind::Execution,
            #[cfg(feature = "providers")]
            SippError::Provider(_) => GatewayErrorKind::Execution,
        };
        Self::new(kind, error.to_string())
    }
}