soul-auth 0.1.0

Framework-agnostic JWT claims and auth error primitives for the Soul platform.
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

//! Soul Auth — minimal, framework-agnostic auth primitives.
//!
//! Provides:
//! - [`AuthError`] — a unified error enum for authentication/authorization flows.
//! - [`Claims`] — a JWT claims struct (sub / exp / iat / session_id / subject_type).
//! - [`encode_token`] / [`decode_token`] — HS256 helpers around `jsonwebtoken`.
//!
//! # Example
//!
//! ```
//! use soul_auth::{Claims, SubjectType, encode_token, decode_token};
//!
//! let secret = b"my-secret-key";
//! let claims = Claims {
//!     sub: "user:42".into(),
//!     exp: 9_999_999_999,
//!     iat: 1_700_000_000,
//!     session_id: Some("session:1".into()),
//!     subject_type: Some(SubjectType::Human),
//! };
//!
//! let token = encode_token(&claims, secret).unwrap();
//! let decoded = decode_token(&token, secret).unwrap();
//! assert_eq!(decoded.sub, "user:42");
//! ```

pub mod claims;
pub mod error;

pub use claims::{decode_token, encode_token, Claims, SubjectType};
pub use error::{AppError, AuthError, Result};