footing 0.1.12

Feature-gated foundations for Rust backend services
Documentation
//! Permission and principal validation errors.

use thiserror::Error;

use crate::result::{ClassifyError, ErrorKind};

#[derive(Debug, Error)]
#[non_exhaustive]
/// Errors that can occur while handling permission.
pub enum PermissionError {
    #[error("permission denied")]
    /// Indicates denied.
    Denied,
    #[error("permission backend is unavailable")]
    /// Indicates unavailable.
    Unavailable,
    #[error("invalid principal: {0}")]
    /// The principal is invalid.
    InvalidPrincipal(String),
    #[error("invalid principal authority: {0}")]
    /// The authority is invalid.
    InvalidAuthority(String),
    #[error("invalid permission policy: {0}")]
    /// The policy is invalid.
    InvalidPolicy(String),
}

impl ClassifyError for PermissionError {
    fn error_kind(&self) -> ErrorKind {
        match self {
            Self::Denied => ErrorKind::Authorization,
            Self::Unavailable => ErrorKind::Unavailable,
            Self::InvalidPrincipal(_) | Self::InvalidAuthority(_) => ErrorKind::Validation,
            Self::InvalidPolicy(_) => ErrorKind::Internal,
        }
    }

    fn error_code(&self) -> crate::result::ErrorCode {
        crate::result::ErrorCode::internal(match self {
            Self::Denied => "permission_denied",
            Self::Unavailable => "permission_unavailable",
            Self::InvalidPrincipal(_) => "principal_invalid",
            Self::InvalidAuthority(_) => "principal_authority_invalid",
            Self::InvalidPolicy(_) => "permission_invalid_policy",
        })
    }
}