auth/

lib/auth

Namespace de packages utility pour l'authentification. Aucun code Go au root — uniquement des sous-packages purs et des artefacts SQL partagés.

Principe : lib/auth/* ne touche jamais à la DB. Les tests sont des unit-tests, pas d'intégration. La composition (handlers HTTP, persistance, orchestration des flows) vit dans internal/auth/ côté app.

Packages

Composition côté app

// internal/auth/login.go (composé par chaque app)
import (
    "github.com/AltSoyuz/lib/auth/passwords"
    "github.com/AltSoyuz/lib/auth/sessions"
)

func loginHandler(s *Store) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        email, _ := passwords.NormalizeEmail(in.Email)
        cred, _ := s.Queries.GetPasswordCredentialByUserID(ctx, user.ID)
        if passwords.Verify(cred.PassHash, pw) != nil { /* 401 */ }
        token, hash, _ := sessions.NewToken()
        // ... store hash, set cookie
        sessions.SetCookie(w, r, token, time.Now().Add(sessions.TTL))
    }
}

SQL partagé (schema/)

Les fichiers SQL ne sont pas embarqués via //go:embed côté lib — ce sont des templates que chaque app copie dans son dossier de migrations + queries propre.

# bootstrap d'une nouvelle app
cp $(go env GOMODCACHE)/github.com/!alt!soyuz/homeapp@<version>/lib/auth/schema/migrations/*.sql \
   ./internal/store/migrations/
cp $(go env GOMODCACHE)/github.com/!alt!soyuz/homeapp@<version>/lib/auth/schema/queries/auth.sql \
   ./internal/auth/queries/

sqlc target côté app :

- engine: "sqlite"
  queries: "lib/auth/schema/queries"
  schema: "lib/auth/schema/migrations"
  gen: { go: { package: "dal", out: "internal/auth/dal" } }

Règles

• ❌ Pas de DB, pas de SQLite, pas d'intégration dans lib/auth/*
• ❌ Pas de couplage entre passwords, sessions, magiclinks — chaque package est indépendant
• ❌ Pas d'//go:embed sur schema/ côté lib
• ✅ Toute logique pure (crypto, parsing, normalisation, math) → ici
• ✅ Composition (HTTP, DB, transactions, flows) → internal/auth/ côté app