implement initial backend structure with authentication, user management, and database integration

2026-04-27 17:58:32 +02:00
parent 48a7ed68e6
commit 78b503fe43
14 changed files with 653 additions and 0 deletions
@@ -0,0 +1,132 @@
+"""Authentication service: password hashing, JWT creation/verification, token management."""
+import os
+from datetime import datetime, timedelta, timezone
+from typing import Any
+
+from jose import JWTError, jwt
+from passlib.context import CryptContext
+
+from backend.app.db import get_conn, get_write_lock
+
+_pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto")
+
+ACCESS_TOKEN_EXPIRE_MINUTES = 15
+REFRESH_TOKEN_EXPIRE_DAYS = 7
+ALGORITHM = "HS256"
+
+
+def _secret() -> str:
+    secret = os.getenv("JWT_SECRET")
+    if not secret:
+        raise RuntimeError("JWT_SECRET environment variable is not set.")
+    return secret
+
+
+# --- Password ---
+
+def hash_password(plain: str) -> str:
+    return _pwd_context.hash(plain)
+
+
+def verify_password(plain: str, hashed: str) -> bool:
+    return _pwd_context.verify(plain, hashed)
+
+
+# --- Tokens ---
+
+def create_access_token(user_id: str, email: str, role: str) -> str:
+    expire = datetime.now(timezone.utc) + timedelta(minutes=ACCESS_TOKEN_EXPIRE_MINUTES)
+    payload = {
+        "sub": user_id,
+        "email": email,
+        "role": role,
+        "exp": expire,
+        "type": "access",
+    }
+    return jwt.encode(payload, _secret(), algorithm=ALGORITHM)
+
+
+def create_refresh_token(user_id: str, jti: str) -> str:
+    expire = datetime.now(timezone.utc) + timedelta(days=REFRESH_TOKEN_EXPIRE_DAYS)
+    payload = {
+        "sub": user_id,
+        "jti": jti,
+        "exp": expire,
+        "type": "refresh",
+    }
+    return jwt.encode(payload, _secret(), algorithm=ALGORITHM)
+
+
+def decode_token(token: str) -> dict[str, Any]:
+    """Decode and validate a JWT. Raises JWTError on failure."""
+    return jwt.decode(token, _secret(), algorithms=[ALGORITHM])
+
+
+# --- Database operations ---
+
+async def register_user(email: str, password: str) -> dict[str, Any]:
+    """Insert a new user. Returns the created user row."""
+    conn = get_conn()
+    lock = get_write_lock()
+    async with lock:
+        existing = conn.execute(
+            "SELECT id FROM users WHERE email = ?", [email]
+        ).fetchone()
+        if existing:
+            raise ValueError("Email already registered.")
+        conn.execute(
+            "INSERT INTO users (email, password_hash) VALUES (?, ?)",
+            [email, hash_password(password)],
+        )
+        row = conn.execute(
+            "SELECT id, email, role FROM users WHERE email = ?", [email]
+        ).fetchone()
+    return {"id": str(row[0]), "email": row[1], "role": row[2]}
+
+
+async def authenticate_user(email: str, password: str) -> dict[str, Any] | None:
+    """Return user dict if credentials are valid, else None."""
+    conn = get_conn()
+    row = conn.execute(
+        "SELECT id, email, password_hash, role FROM users WHERE email = ?", [email]
+    ).fetchone()
+    if row is None or not verify_password(password, row[2]):
+        return None
+    return {"id": str(row[0]), "email": row[1], "role": row[3]}
+
+
+async def store_refresh_token(user_id: str, jti: str) -> None:
+    """Persist a refresh token JTI in the database."""
+    conn = get_conn()
+    lock = get_write_lock()
+    from datetime import timedelta
+    expires_at = datetime.now(timezone.utc) + timedelta(days=REFRESH_TOKEN_EXPIRE_DAYS)
+    async with lock:
+        conn.execute(
+            "INSERT INTO refresh_tokens (jti, user_id, expires_at) VALUES (?, ?, ?)",
+            [jti, user_id, expires_at],
+        )
+
+
+async def revoke_refresh_token(jti: str) -> None:
+    """Mark a refresh token as revoked."""
+    conn = get_conn()
+    lock = get_write_lock()
+    async with lock:
+        conn.execute(
+            "UPDATE refresh_tokens SET revoked = true WHERE jti = ?", [jti]
+        )
+
+
+async def validate_refresh_token_jti(jti: str, user_id: str) -> bool:
+    """Return True if the JTI exists, is not revoked, and belongs to user_id."""
+    conn = get_conn()
+    now = datetime.now(timezone.utc)
+    row = conn.execute(
+        """
+        SELECT 1 FROM refresh_tokens
+        WHERE jti = ? AND user_id = ? AND revoked = false AND expires_at > ?
+        """,
+        [jti, user_id, now],
+    ).fetchone()
+    return row is not None
@@ -0,0 +1,86 @@
+"""User management service: CRUD helpers against DuckDB."""
+from typing import Any
+
+from backend.app.db import get_conn, get_write_lock
+from backend.app.services.auth import hash_password
+
+
+async def get_user(user_id: str) -> dict[str, Any] | None:
+    conn = get_conn()
+    row = conn.execute(
+        "SELECT id, email, role FROM users WHERE id = ?", [user_id]
+    ).fetchone()
+    if row is None:
+        return None
+    return {"id": str(row[0]), "email": row[1], "role": row[2]}
+
+
+async def list_users() -> list[dict[str, Any]]:
+    conn = get_conn()
+    rows = conn.execute(
+        "SELECT id, email, role FROM users ORDER BY email").fetchall()
+    return [{"id": str(r[0]), "email": r[1], "role": r[2]} for r in rows]
+
+
+async def update_user(
+    user_id: str,
+    email: str | None = None,
+    password: str | None = None,
+) -> dict[str, Any] | None:
+    """Update email and/or password. Returns updated user or None if not found."""
+    conn = get_conn()
+    lock = get_write_lock()
+
+    if email is None and password is None:
+        return await get_user(user_id)
+
+    async with lock:
+        if email is not None:
+            existing = conn.execute(
+                "SELECT id FROM users WHERE email = ? AND id != ?", [
+                    email, user_id]
+            ).fetchone()
+            if existing:
+                raise ValueError("Email already in use.")
+            conn.execute(
+                "UPDATE users SET email = ?, updated_at = now() WHERE id = ?",
+                [email, user_id],
+            )
+        if password is not None:
+            conn.execute(
+                "UPDATE users SET password_hash = ?, updated_at = now() WHERE id = ?",
+                [hash_password(password), user_id],
+            )
+        row = conn.execute(
+            "SELECT id, email, role FROM users WHERE id = ?", [user_id]
+        ).fetchone()
+
+    if row is None:
+        return None
+    return {"id": str(row[0]), "email": row[1], "role": row[2]}
+
+
+async def set_user_role(user_id: str, role: str) -> dict[str, Any] | None:
+    conn = get_conn()
+    lock = get_write_lock()
+    async with lock:
+        conn.execute(
+            "UPDATE users SET role = ?, updated_at = now() WHERE id = ?",
+            [role, user_id],
+        )
+        row = conn.execute(
+            "SELECT id, email, role FROM users WHERE id = ?", [user_id]
+        ).fetchone()
+    if row is None:
+        return None
+    return {"id": str(row[0]), "email": row[1], "role": row[2]}
+
+
+async def delete_user(user_id: str) -> bool:
+    """Delete user and their refresh tokens. Returns True if a row was removed."""
+    conn = get_conn()
+    lock = get_write_lock()
+    async with lock:
+        conn.execute("DELETE FROM refresh_tokens WHERE user_id = ?", [user_id])
+        conn.execute("DELETE FROM users WHERE id = ?", [user_id])
+    return True