runique 1.1.25

A Django-inspired web framework for Rust with ORM, templates, and comprehensive security middleware
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
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

// ═══════════════════════════════════════════════════════════════
// User built-in de Runique
// ═══════════════════════════════════════════════════════════════
//
// Prêt à l'emploi, aucune migration manuelle requise.
// Table : `runique_users` (préfixé pour éviter les conflits).
//
// Usage zéro config :
//   .with_admin(|a| a.auth(RuniqueAdminAuth::new()))
// ═══════════════════════════════════════════════════════════════

use sea_orm::{entity::prelude::*, ColumnTrait, DatabaseConnection, EntityTrait, QueryFilter};

pub use crate::middleware::auth::default_auth::UserEntity;
pub use crate::middleware::auth::user_trait::RuniqueUser;

// ─── Modèle SeaORM ───────────────────────────────────────────────────────────

#[derive(Clone, Debug, PartialEq, DeriveEntityModel, serde::Serialize, serde::Deserialize)]
#[sea_orm(table_name = "users")]
pub struct Model {
    #[sea_orm(primary_key)]
    pub id: i32,
    pub username: String,
    pub email: String,
    /// Hash Argon2 — jamais le mot de passe en clair
    pub password: String,
    pub is_active: bool,
    pub is_staff: bool,
    pub is_superuser: bool,
    /// Format JSON : ["editor","moderator"] ou NULL
    pub roles: Option<String>,
    pub created_at: Option<chrono::NaiveDateTime>,
    pub updated_at: Option<chrono::NaiveDateTime>,
}

#[derive(Copy, Clone, Debug, EnumIter, DeriveRelation)]
pub enum Relation {}

impl ActiveModelBehavior for ActiveModel {}

// ─── Méthodes utilitaires ────────────────────────────────────────────────────

impl Model {
    pub fn get_roles(&self) -> Vec<String> {
        self.roles
            .as_deref()
            .and_then(|r| serde_json::from_str(r).ok())
            .unwrap_or_default()
    }

    pub fn set_roles(roles: Vec<String>) -> Option<String> {
        if roles.is_empty() {
            None
        } else {
            serde_json::to_string(&roles).ok()
        }
    }
}

// ─── RuniqueUser ─────────────────────────────────────────────────────────────

impl RuniqueUser for Model {
    fn user_id(&self) -> i32 {
        self.id
    }
    fn username(&self) -> &str {
        &self.username
    }
    fn email(&self) -> &str {
        &self.email
    }
    fn password_hash(&self) -> &str {
        &self.password
    }
    fn is_active(&self) -> bool {
        self.is_active
    }
    fn is_staff(&self) -> bool {
        self.is_staff
    }
    fn is_superuser(&self) -> bool {
        self.is_superuser
    }

    fn roles(&self) -> Vec<String> {
        self.get_roles()
    }
}

// ─── UserEntity ──────────────────────────────────────────────────────────────

pub struct BuiltinUserEntity;

#[async_trait::async_trait]
impl UserEntity for BuiltinUserEntity {
    type Model = Model;

    async fn find_by_username(db: &DatabaseConnection, username: &str) -> Option<Self::Model> {
        Entity::find()
            .filter(Column::Username.eq(username))
            .one(db)
            .await
            .ok()
            .flatten()
    }
    async fn find_by_email(db: &DatabaseConnection, email: &str) -> Option<Self::Model> {
        Entity::find()
            .filter(Column::Email.eq(email))
            .one(db)
            .await
            .ok()
            .flatten()
    }
}

// ─── Alias pratique ───────────────────────────────────────────────────────────

/// Auth admin prête à l'emploi avec le User built-in.
///
/// ```rust,ignore
/// .with_admin(|a| a.auth(RuniqueAdminAuth::new()))
/// ```
pub type RuniqueAdminAuth =
    crate::middleware::auth::default_auth::DefaultAdminAuth<BuiltinUserEntity>;