Skip to main content

pwt/
errors.rs

1use thiserror::Error;
2
3/// TokenValidationError describes claim validation failures.
4#[derive(Debug, Error, Clone, PartialEq, Eq)]
5pub enum TokenValidationError {
6    #[error("token is expired")]
7    TokenExpired,
8    #[error("token is not yet valid (nbf)")]
9    TokenNotValidYet,
10}
11
12/// SigningMethodError reports signing or verification failures.
13#[derive(Debug, Error)]
14pub enum SigningMethodError {
15    #[error("invalid key type")]
16    InvalidKeyType,
17    #[error("invalid signature")]
18    InvalidSignature,
19    #[error("key parse error: {0}")]
20    KeyParseError(String),
21    #[error("crypto error: {0}")]
22    CryptoError(String),
23}
24
25/// PwtError reports token parsing and signing failures.
26#[derive(Debug, Error)]
27pub enum PwtError {
28    #[error("invalid token segment count: {0}")]
29    InvalidSegmentCount(usize),
30    #[error("failed to decode {0}")]
31    Base64DecodingFailed(&'static str),
32    #[error("failed to unmarshal header: {0}")]
33    HeaderDecodingFailed(#[source] prost::DecodeError),
34    #[error("failed to unmarshal payload: {0}")]
35    PayloadDecodingFailed(#[source] prost::DecodeError),
36    #[error("failed to decode signature: {0}")]
37    SignatureDecodingFailed(#[source] Box<dyn std::error::Error + Send + Sync>),
38    #[error("unsupported signing method: {0}")]
39    UnsupportedAlgorithm(String),
40    #[error("keyFunc is nil")]
41    KeyFuncNil,
42    #[error("keyFunc returned error: {0}")]
43    KeyFuncError(#[source] Box<dyn std::error::Error + Send + Sync>),
44    #[error("failed to verify signature: {0}")]
45    SignatureVerificationFailed(#[source] SigningMethodError),
46    #[error("token validation failed: {0}")]
47    TokenValidationFailed(#[source] TokenValidationError),
48    #[error("failed to marshal header: {0}")]
49    HeaderEncodingFailed(#[source] prost::EncodeError),
50    #[error("failed to marshal payload: {0}")]
51    PayloadEncodingFailed(#[source] prost::EncodeError),
52    #[error("signing failed: {0}")]
53    SigningFailed(#[source] SigningMethodError),
54}