stackure 1.20260417.5

Official Stackure authentication SDK for Rust
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
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

//! Input validation utilities for the Stackure SDK.

use regex::Regex;
use std::sync::LazyLock;

use crate::errors::StackureError;

static EMAIL_RE: LazyLock<Regex> =
    LazyLock::new(|| Regex::new(r"^[^\s@]+@[^\s@]+\.[^\s@]+$").unwrap());

static UUID_RE: LazyLock<Regex> = LazyLock::new(|| {
    Regex::new(r"(?i)^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$")
        .unwrap()
});

/// Validate that a string is a well-formed email address.
///
/// # Errors
///
/// Returns [`StackureError::Validation`] if the email is empty or malformed.
pub fn validate_email(email: &str) -> Result<(), StackureError> {
    if email.is_empty() {
        return Err(StackureError::Validation(
            "Email is required and must be a string".into(),
        ));
    }
    if !EMAIL_RE.is_match(email) {
        return Err(StackureError::Validation("Invalid email format".into()));
    }
    Ok(())
}

/// Validate that a string is a valid UUID v4.
///
/// # Errors
///
/// Returns [`StackureError::Validation`] if the value is empty or not a valid UUID v4.
pub fn validate_uuid(value: &str, field_name: &str) -> Result<(), StackureError> {
    if value.is_empty() {
        return Err(StackureError::Validation(format!(
            "{field_name} is required and must be a string"
        )));
    }
    if !UUID_RE.is_match(value) {
        return Err(StackureError::Validation(format!(
            "Invalid {field_name} format (must be a valid UUID)"
        )));
    }
    Ok(())
}