rocket_firebase_auth 0.5.0

//! Error management for the library

/// All rocket-firebase-auth errors are consolidated into the following AuthError
#[derive(Debug, PartialEq, Eq)]
pub enum Error {
    /// Invalid JWT given
    InvalidJwt(InvalidJwt),
    /// Fail to fetch list of JWKs from issuer
    FetchFailed(String),
    /// Invalid Authorization header in request
    InvalidAuthHeader(InvalidAuthHeader),
    /// jsonwebtoken errors
    JsonWebTokenError(String),
    #[cfg(feature = "env")]
    /// Failures related to reading from environment variables
    Env(Env),
    /// FirebaseAuth state was not found, can't check validity of token
    FirebaseAuthStateNotFound,
}

/// Errors around the contents of a decoded token
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
pub enum InvalidJwt {
    /// Kid is missing
    MissingKid,
    /// Jwk for a Kid could not be found
    MatchingJwkNotFound,
    /// Unspecified invalid JWT error
    Unspecified,
}

/// Errors around invalid request headers and encoded tokens
#[derive(Debug, PartialEq, Eq)]
pub enum InvalidAuthHeader {
    /// Too many Authorization headers. Expects only 1
    BadCount,
    /// Authorization header is missing altogether in request
    MissingAuthHeader,
    /// `Bearer` keyword is missing
    MissingBearer,
    /// Bearer token is missing
    MissingBearerValue,
    /// Invalid Bearer token format. Couldn't parse to BearerToken type
    InvalidFormat(String),
}

/// Errors that occur when reading environment variables
#[cfg(feature = "env")]
#[derive(Debug, PartialEq, Eq)]
pub enum Env {
    /// Invalid Firebase credentials given
    InvalidFirebaseCredentials(String),
    /// Invalid file format received
    InvalidFileFormat(String),
    /// Missing env file
    MissingEnvFile(String),
}

impl From<jsonwebtoken::errors::Error> for Error {
    fn from(e: jsonwebtoken::errors::Error) -> Self {
        Error::JsonWebTokenError(format!("Auth error occurred: {e}"))
    }
}

impl From<std::io::Error> for Error {
    fn from(e: std::io::Error) -> Self {
        Error::Env(Env::InvalidFileFormat(e.to_string()))
    }
}

impl From<std::env::VarError> for Error {
    fn from(e: std::env::VarError) -> Self {
        Error::Env(Env::InvalidFirebaseCredentials(e.to_string()))
    }
}

impl From<serde_json::Error> for Error {
    fn from(e: serde_json::Error) -> Self {
        Error::Env(Env::InvalidFileFormat(e.to_string()))
    }
}

impl From<dotenvy::Error> for Error {
    fn from(e: dotenvy::Error) -> Self {
        Error::Env(Env::MissingEnvFile(e.to_string()))
    }
}

impl From<reqwest::Error> for Error {
    fn from(e: reqwest::Error) -> Self {
        Error::FetchFailed(format!("Auth error occurred: {e}"))
    }
}