@lastbrain/module-auth 0.1.10 → 0.1.13

package/README.md

@@ -1,554 +1,128 @@
-# @lastbrain/module-auth
+# 📦 Module auth
 
-Module d'authentification complet pour LastBrain avec Supabase. Fournit des pages web, des API routes et une gestion complète de l'authentification utilisateur, du profil et de l'administration.
+> @lastbrain/module-auth
 
-## 🎯 Vue d'ensemble
+## 📋 Informations
 
-Ce module inclut tout ce dont vous avez besoin pour l'authentification :
+- **Nom du package**: `@lastbrain/module-auth`
+- **Slug**: `module-auth`
+- **Type**: Module LastBrain
 
-- 🔐 **Pages complètes** - Connexion, inscription, profil, dashboard
-- 🛠️ **API routes** - Gestion utilisateur et administration
-- 🗄️ **Schema DB** - Tables et permissions Supabase
-- 👤 **Gestion profils** - Informations personnelles et préférences
-- 🛡️ **Sécurité** - Protection RLS et rôles admin
+## 📄 Pages Disponibles
 
-## 🚀 Démarrage rapide
-
-> **Recommandé :** Utilisez le CLI LastBrain pour créer une application complète avec le module auth
-
-```bash
-# Créer une nouvelle application avec le module auth inclus
-pnpx @lastbrain/app@latest init mon-app
-# Sélectionner "🔐 Authentication" lors de la création
-
-cd mon-app
-pnpm db:init  # Applique automatiquement les migrations
-pnpm dev
-```
-
-## 📦 Installation manuelle
-
-Si vous intégrez LastBrain dans un projet existant :
-
-```bash
-pnpm add @lastbrain/module-auth @lastbrain/core @lastbrain/ui
-```
-
-Puis ajoutez le module à votre projet LastBrain :
-
-```bash
-pnpm lastbrain add-module auth
-pnpm build:modules
-```
-
-## Configuration
-
-### Prérequis
-
-1. **Supabase configuré** : Vous devez avoir un projet Supabase avec les variables d'environnement suivantes :
-
-   ```env
-   NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
-   NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
-   ```
-
-2. **Migrations appliquées** : Appliquez la migration fournie dans `supabase/migrations/20251112000000_user_init.sql` pour créer les tables nécessaires.
-
-3. **Fonction RPC is_superadmin** : Assurez-vous que la fonction `is_superadmin` est disponible (généralement fournie par la migration de base de l'app).
-
-### Configuration de la fonction is_superadmin
-
-La fonction `is_superadmin` vérifie si un utilisateur a le rôle d'administrateur. Elle est définie dans la migration de base et examine les métadonnées utilisateur :
-
-```sql
-CREATE OR REPLACE FUNCTION public.is_superadmin(user_id uuid)
-RETURNS boolean
-LANGUAGE sql
-STABLE
-SECURITY DEFINER
-SET search_path = public, auth
-AS $function$
-  SELECT COALESCE((
-    SELECT
-      COALESCE((raw_app_meta_data ->> 'is_super_admin')::boolean, FALSE)
-      OR COALESCE((raw_user_meta_data ->> 'is_super_admin')::boolean, FALSE)
-      OR COALESCE((raw_app_meta_data -> 'roles') ? 'admin', FALSE)
-      OR COALESCE((raw_user_meta_data -> 'roles') ? 'admin', FALSE)
-    FROM auth.users
-    WHERE id = user_id
-  ), FALSE);
-$function$;
-```
-
-## Pages Web Fournies
-
-Le module fournit plusieurs composants React prêts à l'emploi utilisant HeroUI :
-
-### Pages Utilisateur Authentifié
-
-#### 1. Dashboard (`/auth/dashboard`)
-
-**Component**: `DashboardPage`
-
-Tableau de bord utilisateur affichant :
-
-- Résumé du profil avec avatar
-- Email et date de création du compte
-- Statut du compte
-- Statistiques rapides (projets, tâches, etc.)
-
-**Usage** :
-
-```tsx
-import { DashboardPage } from "@lastbrain/module-auth";
-
-export default function Dashboard() {
-  return <DashboardPage />;
-}
-```
-
-#### 2. Profil (`/auth/profile`)
-
-**Component**: `ProfilePage`
+### Pages Publiques
 
-Page de modification du profil utilisateur permettant de mettre à jour :
+- **GET** `/signin` - SignInPage
+- **GET** `/signup` - SignUpPage
+- **GET** `/reset-password` - ResetPassword
 
-- Informations personnelles (nom, prénom, téléphone, bio)
-- Informations professionnelles (entreprise, site web, localisation)
-- Préférences (langue, timezone, avatar)
+### Pages Protégées (Auth)
 
-**Usage** :
+- **GET** `/dashboard` - DashboardPage
+- **GET** `/folder` - FolderPage
+- **GET** `/reglage` - ReglagePage
+- **GET** `/profile` - ProfilePage
 
-```tsx
-import { ProfilePage } from "@lastbrain/module-auth";
+### Pages Admin
 
-export default function Profile() {
-  return <ProfilePage />;
-}
-```
+- **GET** `/users` - AdminUsersPage
 
-#### 3. Paramètres (`/auth/settings`)
+## 🔌 API Routes
 
-**Component**: `ReglagePage`
+### `/api/auth/signin`
 
-Page de configuration du compte avec :
+**Méthodes supportées**: GET, POST, PUT, DELETE
 
-- Notifications (email, push, marketing)
-- Apparence (thème)
-- Langue et région (langue, timezone)
+### `/api/auth/profile`
 
-**Usage** :
+**Méthodes supportées**: GET, POST, PUT, DELETE
 
-```tsx
-import { ReglagePage } from "@lastbrain/module-auth";
+### `/api/auth/me`
 
-export default function Settings() {
-  return <ReglagePage />;
-}
-```
+**Méthodes supportées**: GET, POST, PUT, DELETE
 
-### Pages Publiques
+### `/api/admin/users`
 
-#### 4. Connexion (`/signin`)
+**Méthodes supportées**: GET, POST, PUT, DELETE
 
-**Component**: `SignInPage`
+## 🗄️ Base de Données
 
-Page de connexion avec gestion des erreurs et redirection.
+### Tables
 
-**Usage** :
+#### `user_profil`
 
 ```tsx
-import { SignInPage } from "@lastbrain/module-auth";
-
-export default function SignIn() {
-  return <SignInPage />;
-}
+<TableStructure
+  tableName="user_profil"
+  title="user_profil"
+  description="Table user_profil du module auth"
+/>
 ```
 
-#### 5. Inscription (`/signup`)
-
-**Component**: `SignUpPage`
-
-Page d'inscription avec validation des champs.
-
-**Usage** :
+#### `user_address`
 
 ```tsx
-import { SignUpPage } from "@lastbrain/module-auth";
-
-export default function SignUp() {
-  return <SignUpPage />;
-}
+<TableStructure
+  tableName="user_address"
+  title="user_address"
+  description="Table user_address du module auth"
+/>
 ```
 
-### Pages Administration
-
-#### 6. Gestion des Utilisateurs (`/admin/users`)
-
-**Component**: `AdminUsersPage`
-
-Page d'administration pour lister et gérer tous les utilisateurs.
-**Accès réservé aux super admins uniquement.**
-
-Fonctionnalités :
-
-- Liste de tous les utilisateurs
-- Recherche par email ou nom
-- Pagination
-- Affichage des informations (email, rôle, date de création)
-
-**Usage** :
+#### `user_notifications`
 
 ```tsx
-import { AdminUsersPage } from "@lastbrain/module-auth";
-
-export default function AdminUsers() {
-  return <AdminUsersPage />;
-}
-```
-
-## Routes API
-
-Le module expose plusieurs routes API pour la gestion des utilisateurs et profils.
-
-### API Authentification (`/api/auth/*`)
-
-#### GET `/api/auth/me`
-
-Récupère les informations de l'utilisateur connecté et son profil.
-
-**Réponse** :
-
-```json
-{
-  "data": {
-    "id": "uuid",
-    "email": "user@example.com",
-    "created_at": "2024-01-01T00:00:00Z",
-    "profile": {
-      "first_name": "John",
-      "last_name": "Doe",
-      "avatar_url": "https://...",
-      "bio": "...",
-      "phone": "...",
-      "company": "...",
-      "website": "...",
-      "location": "...",
-      "language": "en",
-      "timezone": "UTC",
-      "preferences": {}
-    }
-  }
-}
+<TableStructure
+  tableName="user_notifications"
+  title="user_notifications"
+  description="Table user_notifications du module auth"
+/>
 ```
 
-**Erreurs** :
-
-- `401` : Utilisateur non authentifié
+### Migrations
 
-#### GET `/api/auth/profile`
+- `20251112000000_user_init.sql`
+- `20251112000001_auto_profile_and_admin_view.sql`
+- `20251112000002_sync_avatars.sql`
+- `20251124000001_add_get_admin_user_details.sql`
 
-Récupère le profil de l'utilisateur connecté.
-
-**Réponse** :
-
-```json
-{
-  "data": {
-    "id": "uuid",
-    "owner_id": "uuid",
-    "first_name": "John",
-    "last_name": "Doe",
-    ...
-  }
-}
-```
-
-#### PUT/PATCH `/api/auth/profile`
-
-Met à jour le profil de l'utilisateur. Crée le profil s'il n'existe pas.
-
-**Body** :
-
-```json
-{
-  "first_name": "John",
-  "last_name": "Doe",
-  "avatar_url": "https://...",
-  "bio": "...",
-  "phone": "...",
-  "company": "...",
-  "website": "...",
-  "location": "...",
-  "language": "fr",
-  "timezone": "Europe/Paris",
-  "preferences": {
-    "email_notifications": true,
-    "theme": "dark"
-  }
-}
-```
-
-**Réponse** :
-
-```json
-{
-  "data": {
-    "id": "uuid",
-    "owner_id": "uuid",
-    "first_name": "John",
-    ...
-  }
-}
-```
-
-### API Administration (`/api/admin/*`)
-
-⚠️ **Toutes les routes admin nécessitent un accès super admin.**
-
-#### GET `/api/admin/users`
-
-Liste tous les utilisateurs (paginé).
-
-**Query Parameters** :
-
-- `page` (optionnel, défaut: 1) : Numéro de page
-- `per_page` (optionnel, défaut: 20) : Nombre d'éléments par page
-- `search` (optionnel) : Recherche par email ou nom
-
-**Réponse** :
-
-```json
-{
-  "data": [
-    {
-      "id": "uuid",
-      "email": "user@example.com",
-      "created_at": "2024-01-01T00:00:00Z",
-      "profile": {
-        "first_name": "John",
-        "last_name": "Doe",
-        ...
-      }
-    }
-  ],
-  "pagination": {
-    "page": 1,
-    "per_page": 20,
-    "total": 100,
-    "total_pages": 5
-  }
-}
-```
-
-**Erreurs** :
-
-- `401` : Utilisateur non authentifié
-- `403` : Accès refusé (non super admin)
-
-### Utilisation dans une API Route Next.js
-
-```typescript
-// app/api/auth/me/route.ts
-export { GET } from "@lastbrain/module-auth/api/auth/me";
-
-// app/api/auth/profile/route.ts
-export { GET, PUT, PATCH } from "@lastbrain/module-auth/api/auth/profile";
-
-// app/api/admin/users/route.ts
-export { GET } from "@lastbrain/module-auth/api/admin/users";
-```
-
-## Schéma de Base de Données
-
-Le module utilise les tables suivantes (créées par la migration `20251112000000_user_init.sql`) :
-
-### Table `user_profil`
-
-Stocke les informations de profil utilisateur.
-
-```sql
-CREATE TABLE public.user_profil (
-  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-  owner_id UUID NOT NULL REFERENCES auth.users(id) ON DELETE CASCADE,
-  first_name TEXT,
-  last_name TEXT,
-  avatar_url TEXT,
-  bio TEXT,
-  phone TEXT,
-  company TEXT,
-  website TEXT,
-  location TEXT,
-  language TEXT DEFAULT 'en',
-  timezone TEXT,
-  preferences JSONB DEFAULT '{}'::jsonb,
-  created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
-  updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
-);
-```
-
-**Index** :
-
-- `idx_user_profil_owner_id` sur `owner_id`
-
-**RLS (Row Level Security)** :
-
-- Les utilisateurs peuvent lire, créer, modifier et supprimer leur propre profil
-- Les super admins ont accès à tous les profils
-
-### Table `user_address`
-
-Stocke les adresses des utilisateurs.
-
-```sql
-CREATE TABLE public.user_address (
-  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-  owner_id UUID NOT NULL REFERENCES auth.users(id) ON DELETE CASCADE,
-  street TEXT NOT NULL,
-  street2 TEXT,
-  city TEXT NOT NULL,
-  state TEXT,
-  postal_code TEXT,
-  country TEXT NOT NULL,
-  is_default BOOLEAN DEFAULT false,
-  address_type TEXT DEFAULT 'billing',
-  created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
-  updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
-);
-```
-
-### Table `user_notifications`
-
-Stocke les notifications des utilisateurs.
-
-```sql
-CREATE TABLE public.user_notifications (
-  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-  owner_id UUID NOT NULL REFERENCES auth.users(id) ON DELETE CASCADE,
-  title TEXT NOT NULL,
-  body TEXT,
-  type TEXT NOT NULL DEFAULT 'primary',
-  read BOOLEAN NOT NULL DEFAULT false,
-  created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
-  updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
-);
-```
-
-## Intégration dans une Application
-
-### 1. Installer les dépendances
+## 📦 Installation
 
 ```bash
-pnpm add @lastbrain/module-auth @lastbrain/core @lastbrain/ui
+pnpm lastbrain add-module auth
+pnpm build:modules
 ```
 
-### 2. Appliquer les migrations Supabase
-
-Copiez les migrations du module dans votre projet Supabase et appliquez-les :
+### Appliquer les migrations
 
 ```bash
-cp node_modules/@lastbrain/module-auth/supabase/migrations/* supabase/migrations/
-supabase db push
+cd apps/votre-app
+supabase migration up
 ```
 
-### 3. Créer les pages Next.js
-
-Créez les pages dans votre application Next.js :
+## 💡 Utilisation
 
-```typescript
-// app/auth/dashboard/page.tsx
-import { DashboardPage } from "@lastbrain/module-auth";
-export default DashboardPage;
+<!-- 📝 Section à compléter par l'auteur du module -->
 
-// app/auth/profile/page.tsx
-import { ProfilePage } from "@lastbrain/module-auth";
-export default ProfilePage;
+### Exemple d'utilisation
 
-// app/auth/settings/page.tsx
-import { ReglagePage } from "@lastbrain/module-auth";
-export default ReglagePage;
-
-// app/admin/users/page.tsx
-import { AdminUsersPage } from "@lastbrain/module-auth";
-export default AdminUsersPage;
-```
-
-### 4. Créer les routes API
-
-```typescript
-// app/api/auth/me/route.ts
-export { GET } from "@lastbrain/module-auth/api/auth/me";
-
-// app/api/auth/profile/route.ts
-export { GET, PUT, PATCH } from "@lastbrain/module-auth/api/auth/profile";
-
-// app/api/admin/users/route.ts
-export { GET } from "@lastbrain/module-auth/api/admin/users";
-```
-
-### 5. Configurer les variables d'environnement
-
-```env
-NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
-NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
-```
-
-## Sécurité
-
-### Row Level Security (RLS)
-
-Toutes les tables sont protégées par RLS :
-
-- Les utilisateurs ne peuvent accéder qu'à leurs propres données
-- Les super admins ont accès à toutes les données
-
-### Vérification Super Admin
-
-Les routes admin vérifient l'accès super admin via la RPC Supabase :
-
-```typescript
-const { data: isSuperAdmin } = await supabase.rpc("is_superadmin", {
-  user_id: user.id,
-});
+```tsx
+// Importez les composants depuis le module
+import { SignInPage } from "@lastbrain/module-auth";
 
-if (!isSuperAdmin) {
-  return NextResponse.json({ error: "Forbidden" }, { status: 403 });
-}
+// Utilisez-les dans votre application
+<SignInPage />;
 ```
 
-### Authentification
-
-Les routes API vérifient l'authentification :
+### Configuration
 
-```typescript
-const {
-  data: { user },
-  error,
-} = await supabase.auth.getUser();
+<!-- Ajoutez ici les détails de configuration spécifiques -->
 
-if (error || !user) {
-  return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
-}
-```
-
-## Développement
+## ⚠️ Danger Zone
 
-### Build
+La suppression du module supprimera toutes les pages, routes API et migrations associées. **Cette action est irréversible.**
 
 ```bash
-pnpm build
-```
-
-### Watch mode
-
-```bash
-pnpm dev
+pnpm lastbrain remove-module auth
+pnpm build:modules
 ```
-
-## Support
-
-Pour des questions ou des problèmes, ouvrez une issue sur [GitHub](https://github.com/lastpublication/starter).
-
-## Licence
-
-MIT

package/dist/auth.build.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.build.config.d.ts","sourceRoot":"","sources":["../src/auth.build.config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,QAAA,MAAM,eAAe,EAAE,iBAqMtB,CAAC;AAEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"auth.build.config.d.ts","sourceRoot":"","sources":["../src/auth.build.config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,QAAA,MAAM,eAAe,EAAE,iBA6NtB,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/auth.build.config.js

@@ -21,6 +21,11 @@ const authBuildConfig = {
             path: "/dashboard",
             componentExport: "DashboardPage",
         },
+        {
+            section: "auth",
+            path: "/folder",
+            componentExport: "FolderPage",
+        },
         {
             section: "auth",
             path: "/reglage",
@@ -136,22 +141,39 @@ const authBuildConfig = {
                 icon: "Users2",
                 path: "/admin/auth/users",
                 order: 1,
+                shortcut: "cmd+shift+u",
+                shortcutDisplay: "⌘⇧U",
             },
         ],
-        account: [
+        auth: [
             {
                 title: "Tableau de bord",
                 description: "Accédez à votre tableau de bord",
                 icon: "LayoutDashboard",
                 path: "/auth/dashboard",
                 order: 1,
+                shortcut: "cmd+shift+d",
+                shortcutDisplay: "⌘⇧D",
             },
+            {
+                title: "Dossier",
+                description: "Accédez à votre dossier personnel",
+                icon: "FolderOpen",
+                path: "/auth/folder",
+                order: 2,
+                shortcut: "cmd+shift+f",
+                shortcutDisplay: "⌘⇧F",
+            },
+        ],
+        account: [
             {
                 title: "Mon profil",
                 description: "Gérez vos informations personnelles",
                 icon: "User2",
                 path: "/auth/profile",
                 order: 1,
+                shortcut: "cmd+shift+p",
+                shortcutDisplay: "⌘⇧P",
             },
             {
                 title: "Paramètres",
@@ -159,6 +181,8 @@ const authBuildConfig = {
                 icon: "Settings",
                 path: "/auth/reglage",
                 order: 2,
+                shortcut: "cmd+shift+s",
+                shortcutDisplay: "⌘⇧S",
             },
             {
                 title: "Déconnexion",

package/dist/components/Doc.d.ts

@@ -1,2 +1,9 @@
-export declare function AuthModuleDoc(): import("react/jsx-runtime").JSX.Element;
+/**
+ * Documentation component for @lastbrain/module-auth
+ * Auto-generated from module-auth.build.config.ts
+ *
+ * To regenerate this file, run:
+ * pnpm update:module-docs
+ */
+export declare function Doc(): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=Doc.d.ts.map