@lastbrain/app 0.1.34 → 0.1.37

package/dist/scripts/module-create.js

@@ -2,6 +2,18 @@ import fs from "fs-extra";
 import path from "path";
 import chalk from "chalk";
 import inquirer from "inquirer";
+import { fileURLToPath } from "url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// Noms réservés pour éviter les collisions avec le routeur/app
+const RESERVED_PAGE_NAMES = new Set([
+    "layout",
+    "page",
+    "api",
+    "admin",
+    "auth",
+    "public",
+]);
 /**
  * Parse une chaîne de pages séparées par des virgules
  * Ex: "legal, privacy, terms" => ["legal", "privacy", "terms"]
@@ -14,6 +26,18 @@ function parsePagesList(input) {
         .map((p) => p.trim())
         .filter((p) => p.length > 0);
 }
+/**
+ * Slugifie un nom de page: minuscules, tirets, alphanum uniquement
+ */
+function slugifyPageName(name) {
+    return name
+        .trim()
+        .toLowerCase()
+        .replace(/[\s_]+/g, "-")
+        .replace(/[^a-z0-9-]/g, "")
+        .replace(/--+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
 /**
  * Parse une chaîne de tables séparées par des virgules
  * Ex: "settings, users" => ["settings", "users"]
@@ -51,7 +75,8 @@ function getLastBrainPackageVersions(rootDir) {
  */
 function generatePackageJson(moduleName, slug, rootDir) {
     const versions = getLastBrainPackageVersions(rootDir);
-    const buildConfigExport = `./${slug}.build.config`;
+    const moduleNameOnly = slug.replace("module-", "");
+    const buildConfigExport = `./${moduleNameOnly}.build.config`;
     return JSON.stringify({
         name: moduleName,
         version: "0.1.0",
@@ -84,8 +109,8 @@ function generatePackageJson(moduleName, slug, rootDir) {
                 default: "./dist/server.js",
             },
             [buildConfigExport]: {
-                types: `./dist/${slug}.build.config.d.ts`,
-                default: `./dist/${slug}.build.config.js`,
+                types: `./dist/${moduleNameOnly}.build.config.d.ts`,
+                default: `./dist/${moduleNameOnly}.build.config.js`,
             },
             "./api/*": {
                 types: "./dist/api/*.d.ts",
@@ -114,6 +139,38 @@ function generateTsConfig() {
  */
 function generateBuildConfig(config) {
     const { moduleName, pages, tables } = config;
+    const moduleNameOnly = config.slug.replace("module-", "");
+    // Helper pour normaliser les chemins (évite // et trim)
+    function normalizePath(...segments) {
+        return ("/" +
+            segments
+                .map((s) => s.replace(/^\/+/g, "").replace(/\/+$/g, ""))
+                .filter(Boolean)
+                .join("/"));
+    }
+    // Construit un path de menu selon la section en respectant le pattern attendu
+    function buildMenuPath(section, pagePath, pageName) {
+        const cleanedPagePath = pagePath.replace(/^\/+/g, "");
+        switch (section) {
+            case "public": {
+                // Public: /<module>/<page> (si non déjà préfixé)
+                if (cleanedPagePath.startsWith(moduleNameOnly + "/")) {
+                    return normalizePath(cleanedPagePath); // déjà préfixé
+                }
+                return normalizePath(moduleNameOnly, cleanedPagePath);
+            }
+            case "auth": {
+                // Auth: /auth/<module>/<page>
+                return normalizePath("auth", moduleNameOnly, cleanedPagePath);
+            }
+            case "admin": {
+                // Admin: /admin/<module>/<pageName> (utilise le slug brut)
+                return normalizePath("admin", moduleNameOnly, pageName);
+            }
+            default:
+                return normalizePath(cleanedPagePath);
+        }
+    }
     // Générer la liste des pages
     const pagesConfig = pages.map((page) => {
         const componentName = page.name
@@ -152,11 +209,12 @@ function generateBuildConfig(config) {
                 .split("-")
                 .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
                 .join(" ");
+            const menuPath = buildMenuPath("public", page.path, page.name);
             return `      {
         title: "${title}",
         description: "Page ${title}",
         icon: "FileText",
-        path: "${page.path}",
+        path: "${menuPath}",
         order: ${index + 1},
       }`;
         });
@@ -170,11 +228,12 @@ function generateBuildConfig(config) {
                 .split("-")
                 .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
                 .join(" ");
+            const menuPath = buildMenuPath("auth", page.path, page.name);
             return `      {
         title: "${title}",
         description: "Page ${title}",
         icon: "FileText",
-        path: "${page.path}",
+        path: "${menuPath}",
         order: ${index + 1},
       }`;
         });
@@ -188,11 +247,12 @@ function generateBuildConfig(config) {
                 .split("-")
                 .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
                 .join(" ");
+            const menuPath = buildMenuPath("admin", page.path, page.name);
             return `      {
         title: "${title}",
         description: "Page ${title}",
         icon: "Settings",
-        path: "${page.path}",
+        path: "${menuPath}",
         order: ${index + 1},
       }`;
         });
@@ -233,23 +293,29 @@ export default buildConfig;
 /**
  * Génère le contenu du fichier index.ts
  */
-function generateIndexTs(pages) {
+function toPascalCase(value) {
+    return value
+        .split(/[-_]/g)
+        .filter(Boolean)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join("");
+}
+function generateIndexTs(pages, moduleNameOnly) {
     const exports = pages.map((page) => {
-        const componentName = page.name
-            .split("-")
-            .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
-            .join("");
-        const fileName = page.name
-            .split("-")
-            .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
-            .join("");
-        return `export { ${componentName}Page } from "./web/${page.section}/${fileName}Page.js";`;
+        const componentName = toPascalCase(page.name);
+        const fileName = toPascalCase(page.name);
+        return `export { ${componentName}Page } from "./web/${page.section}/${fileName}Page";`;
     });
+    const moduleAlias = toPascalCase(moduleNameOnly);
     return `// Client Components
 ${exports.join("\n")}
 
+// Documentation Component 
+export { Doc } from "./components/Doc";
+export { Doc as ${moduleAlias}ModuleDoc } from "./components/Doc";
+
 // Configuration de build
-export { default as buildConfig } from "./build.config.js";
+export { default as buildConfig } from "./${moduleNameOnly}.build.config";
 `;
 }
 /**
@@ -301,7 +367,13 @@ export function ${componentName}Page() {
  */
 function generateApiRoute(tableName, section) {
     const authRequired = section !== "public";
-    return `import { getSupabaseServerClient } from "@lastbrain/core/server";
+    const clientImport = section === "admin"
+        ? 'import { getSupabaseServiceClient } from "@lastbrain/core/server"'
+        : 'import { getSupabaseServerClient } from "@lastbrain/core/server"';
+    const clientGetter = section === "admin"
+        ? "getSupabaseServiceClient"
+        : "getSupabaseServerClient";
+    return `${clientImport};
 
 const jsonResponse = (payload: unknown, status = 200) => {
   return new Response(JSON.stringify(payload), {
@@ -316,7 +388,7 @@ const jsonResponse = (payload: unknown, status = 200) => {
  * GET - Liste tous les enregistrements de ${tableName}
  */
 export async function GET(request: Request) {
-  const supabase = await getSupabaseServerClient();
+  const supabase = await ${clientGetter}();
   ${authRequired
         ? `
   const { data: { user }, error: authError } = await supabase.auth.getUser();
@@ -341,7 +413,7 @@ export async function GET(request: Request) {
  * POST - Crée un nouvel enregistrement dans ${tableName}
  */
 export async function POST(request: Request) {
-  const supabase = await getSupabaseServerClient();
+  const supabase = await ${clientGetter}();
   ${authRequired
         ? `
   const { data: { user }, error: authError } = await supabase.auth.getUser();
@@ -353,9 +425,12 @@ export async function POST(request: Request) {
 
   const body = await request.json();
 
+  // Injection côté serveur de owner_id si l'utilisateur est authentifié (sécurité)
+  const insertPayload = ${authRequired ? `{ ...body, owner_id: user.id }` : "body"};
+
   const { data, error } = await supabase
     .from("${tableName}")
-    .insert(body)
+    .insert(insertPayload)
     .select()
     .single();
 
@@ -370,7 +445,7 @@ export async function POST(request: Request) {
  * PUT - Met à jour un enregistrement dans ${tableName}
  */
 export async function PUT(request: Request) {
-  const supabase = await getSupabaseServerClient();
+  const supabase = await ${clientGetter}();
   ${authRequired
         ? `
   const { data: { user }, error: authError } = await supabase.auth.getUser();
@@ -405,7 +480,7 @@ export async function PUT(request: Request) {
  * DELETE - Supprime un enregistrement de ${tableName}
  */
 export async function DELETE(request: Request) {
-  const supabase = await getSupabaseServerClient();
+  const supabase = await ${clientGetter}();
   ${authRequired
         ? `
   const { data: { user }, error: authError } = await supabase.auth.getUser();
@@ -520,10 +595,559 @@ $$;
 ${tablesSQL}
 `;
 }
+/**
+ * Generate Doc.tsx component for the module
+ */
+function generateDocComponent(config) {
+    const moduleNameClean = config.slug.replace("module-", "");
+    const moduleNameOnly = moduleNameClean;
+    // Generate pages sections
+    const publicPages = config.pages.filter((p) => p.section === "public");
+    const authPages = config.pages.filter((p) => p.section === "auth");
+    const adminPages = config.pages.filter((p) => p.section === "admin");
+    let pagesSection = "";
+    if (config.pages.length > 0) {
+        pagesSection = `
+      <Card>
+        <CardHeader>
+          <h2 className="text-2xl font-semibold flex items-center gap-2">
+            <FileText size={24} />
+            Pages Disponibles
+          </h2>
+        </CardHeader>
+        <CardBody className="space-y-4">`;
+        if (publicPages.length > 0) {
+            pagesSection += `
+          <div>
+            <h3 className="text-lg font-semibold mb-2">Pages Publiques</h3>
+            <div className="space-y-2">`;
+            for (const page of publicPages) {
+                const componentName = page.name
+                    .split("-")
+                    .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+                    .join("");
+                pagesSection += `
+              <div className="flex items-start gap-2">
+                <Chip size="sm" color="success" variant="flat">GET</Chip>
+                <code className="text-sm">${page.path}</code>
+                <span className="text-sm text-slate-600 dark:text-slate-400">- ${componentName}</span>
+              </div>`;
+            }
+            pagesSection += `
+            </div>
+          </div>`;
+        }
+        if (authPages.length > 0) {
+            pagesSection += `
+          <div>
+            <h3 className="text-lg font-semibold mb-2">Pages Protégées (Auth)</h3>
+            <div className="space-y-2">`;
+            for (const page of authPages) {
+                const componentName = page.name
+                    .split("-")
+                    .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+                    .join("");
+                pagesSection += `
+              <div className="flex items-start gap-2">
+                <Chip size="sm" color="primary" variant="flat">GET</Chip>
+                <code className="text-sm">${page.path}</code>
+                <span className="text-sm text-slate-600 dark:text-slate-400">- ${componentName}</span>
+              </div>`;
+            }
+            pagesSection += `
+            </div>
+          </div>`;
+        }
+        if (adminPages.length > 0) {
+            pagesSection += `
+          <div>
+            <h3 className="text-lg font-semibold mb-2">Pages Admin</h3>
+            <div className="space-y-2">`;
+            for (const page of adminPages) {
+                const componentName = page.name
+                    .split("-")
+                    .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+                    .join("");
+                pagesSection += `
+              <div className="flex items-start gap-2">
+                <Chip size="sm" color="secondary" variant="flat">GET</Chip>
+                <code className="text-sm">/admin/${moduleNameOnly}/${page.name}</code>
+                <span className="text-sm text-slate-600 dark:text-slate-400">- ${componentName}</span>
+              </div>`;
+            }
+            pagesSection += `
+            </div>
+          </div>`;
+        }
+        pagesSection += `
+        </CardBody>
+      </Card>
+`;
+    }
+    // Generate APIs section
+    let apisSection = "";
+    if (config.tables.length > 0) {
+        apisSection = `
+      <Card>
+        <CardHeader>
+          <h2 className="text-2xl font-semibold flex items-center gap-2">
+            <Zap size={24} />
+            API Routes
+          </h2>
+        </CardHeader>
+        <CardBody className="space-y-4">`;
+        for (const table of config.tables) {
+            for (const section of table.sections) {
+                apisSection += `
+          <div>
+            <h3 className="text-lg font-semibold mb-2">
+              <code>/api/${section}/${table.name}</code>
+            </h3>
+            <div className="flex gap-2">
+              <Chip size="sm" color="success" variant="flat">GET</Chip>
+              <Chip size="sm" color="primary" variant="flat">POST</Chip>
+              <Chip size="sm" color="warning" variant="flat">PUT</Chip>
+              <Chip size="sm" color="danger" variant="flat">DELETE</Chip>
+            </div>
+          </div>`;
+            }
+        }
+        apisSection += `
+        </CardBody>
+      </Card>
+`;
+    }
+    // Generate tables section
+    let tablesSection = "";
+    if (config.tables.length > 0) {
+        tablesSection = `
+      <Card>
+        <CardHeader>
+          <h2 className="text-2xl font-semibold flex items-center gap-2">
+            <Database size={24} />
+            Base de Données
+          </h2>
+        </CardHeader>
+        <CardBody className="space-y-6">`;
+        for (const table of config.tables) {
+            tablesSection += `
+          <TableStructure
+            tableName="${table.name}"
+            title="${table.name}"
+            description="Table ${table.name} du module ${moduleNameClean}"
+          />`;
+        }
+        tablesSection += `
+        </CardBody>
+      </Card>
+`;
+    }
+    // Installation commands
+    const installSection = `
+      <Card>
+        <CardHeader>
+          <h2 className="text-2xl font-semibold flex items-center gap-2">
+            <Package size={24} />
+            Installation
+          </h2>
+        </CardHeader>
+        <CardBody className="space-y-4">
+          <div>
+            <h3 className="text-lg font-semibold mb-2">Ajouter le module</h3>
+            <Snippet symbol="" hideSymbol className="text-sm mb-2">
+              pnpm lastbrain add-module ${moduleNameClean}
+            </Snippet>
+            <Snippet symbol="" hideSymbol className="text-sm mb-2">
+              pnpm build:modules
+            </Snippet>
+          </div>
+          
+          <div>
+            <h3 className="text-lg font-semibold mb-2">Appliquer les migrations</h3>
+            <Snippet symbol="" hideSymbol className="text-sm mb-2">
+              cd apps/votre-app
+            </Snippet>
+            <Snippet symbol="" hideSymbol className="text-sm mb-2">
+              supabase migration up
+            </Snippet>
+          </div>
+        </CardBody>
+      </Card>
+`;
+    // Usage section with placeholder
+    const usageSection = `
+      <Card>
+        <CardHeader>
+          <h2 className="text-2xl font-semibold flex items-center gap-2">
+            <BookOpen size={24} />
+            Utilisation
+          </h2>
+        </CardHeader>
+        <CardBody className="space-y-4">
+          <Alert color="default" className="mb-4">
+            <p className="text-sm">
+              📝 <strong>Section à compléter par l'auteur du module</strong>
+            </p>
+            <p className="text-sm text-slate-600 dark:text-slate-400 mt-2">
+              Ajoutez ici des exemples d'utilisation, des configurations spécifiques,
+              et toute information utile pour les développeurs utilisant ce module.
+            </p>
+          </Alert>
+          
+          <div>
+            <h3 className="text-lg font-semibold mb-2">Exemple d'utilisation</h3>
+            <Alert color="primary" className="p-4 mb-4">
+              <pre className="whitespace-pre-wrap">{\`// Importez les composants depuis le module
+import { ${config.pages.length > 0
+        ? config.pages[0].name
+            .split("-")
+            .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+            .join("") + "Page"
+        : "Component"} } from "${config.moduleName}";
+
+// Utilisez-les dans votre application
+<${config.pages.length > 0
+        ? config.pages[0].name
+            .split("-")
+            .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+            .join("") + "Page"
+        : "Component"} />\`}</pre>
+            </Alert>
+          </div>
+        </CardBody>
+      </Card>
+`;
+    // Danger zone
+    const dangerSection = `
+      <Card>
+        <CardHeader>
+          <h2 className="text-2xl font-semibold flex items-center gap-2 text-danger">
+            <AlertTriangle size={24} />
+            Danger Zone
+          </h2>
+        </CardHeader>
+        <CardBody className="space-y-4">
+          <Alert color="danger" className="mb-4">
+            <p className="text-sm font-semibold">
+              ⚠️ Cette action est irréversible
+            </p>
+            <p className="text-sm mt-2">
+              La suppression du module supprimera toutes les pages, routes API et migrations associées.
+            </p>
+          </Alert>
+          
+          <div>
+            <h3 className="text-lg font-semibold mb-2">Supprimer le module</h3>
+            <Snippet symbol="" hideSymbol color="danger" className="text-sm mb-2">
+              pnpm lastbrain remove-module ${moduleNameClean}
+            </Snippet>
+            <Snippet symbol="" hideSymbol color="danger" className="text-sm mb-2">
+              pnpm build:modules
+            </Snippet>
+          </div>
+        </CardBody>
+      </Card>
+`;
+    return `"use client";
+
+import { Card, CardBody, CardHeader } from "@lastbrain/ui";
+import { Chip } from "@lastbrain/ui";
+import { Snippet } from "@lastbrain/ui";
+import { Alert } from "@lastbrain/ui";
+import { TableStructure } from "@lastbrain/ui";
+import { 
+  FileText, 
+  Zap, 
+  Database, 
+  Package, 
+  BookOpen, 
+  AlertTriangle 
+} from "lucide-react";
+
+/**
+ * Documentation component for ${config.moduleName}
+ * Auto-generated from ${config.slug}.build.config.ts
+ * 
+ * To regenerate this file, run:
+ * pnpm generate:module-docs
+ */
+export function Doc() {
+  return (
+    <div className="container mx-auto p-6 space-y-6">
+      <Card>
+        <CardHeader>
+          <div>
+            <h1 className="text-3xl font-bold mb-2">📦 Module ${moduleNameClean}</h1>
+            <p className="text-slate-600 dark:text-slate-400">${config.moduleName}</p>
+          </div>
+        </CardHeader>
+        <CardBody>
+          <div className="grid grid-cols-1 md:grid-cols-3 gap-4">
+            <div>
+              <p className="text-sm text-slate-600 dark:text-slate-400">Package</p>
+              <code className="text-sm font-semibold">${config.moduleName}</code>
+            </div>
+            <div>
+              <p className="text-sm text-slate-600 dark:text-slate-400">Slug</p>
+              <code className="text-sm font-semibold">${config.slug}</code>
+            </div>
+            <div>
+              <p className="text-sm text-slate-600 dark:text-slate-400">Type</p>
+              <code className="text-sm font-semibold">Module LastBrain</code>
+            </div>
+          </div>
+        </CardBody>
+      </Card>
+${pagesSection}${apisSection}${tablesSection}${installSection}${usageSection}${dangerSection}
+    </div>
+  );
+}
+`;
+}
+/**
+ * Generate README.md for the module
+ */
+async function generateModuleReadme(config, moduleDir) {
+    const moduleNameClean = config.slug.replace("module-", "");
+    let md = `# 📦 Module ${moduleNameClean}\n\n`;
+    md += `> ${config.moduleName}\n\n`;
+    // Information section
+    md += `## 📋 Informations\n\n`;
+    md += `- **Nom du package**: \`${config.moduleName}\`\n`;
+    md += `- **Slug**: \`${config.slug}\`\n`;
+    md += `- **Type**: Module LastBrain\n\n`;
+    // Pages section
+    if (config.pages.length > 0) {
+        md += `## 📄 Pages Disponibles\n\n`;
+        const publicPages = config.pages.filter((p) => p.section === "public");
+        const authPages = config.pages.filter((p) => p.section === "auth");
+        const adminPages = config.pages.filter((p) => p.section === "admin");
+        if (publicPages.length > 0) {
+            md += `### Pages Publiques\n\n`;
+            for (const page of publicPages) {
+                const componentName = page.name
+                    .split("-")
+                    .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+                    .join("");
+                md += `- **GET** \`${page.path}\` - ${componentName}\n`;
+            }
+            md += `\n`;
+        }
+        if (authPages.length > 0) {
+            md += `### Pages Protégées (Auth)\n\n`;
+            for (const page of authPages) {
+                const componentName = page.name
+                    .split("-")
+                    .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+                    .join("");
+                md += `- **GET** \`${page.path}\` - ${componentName}\n`;
+            }
+            md += `\n`;
+        }
+        if (adminPages.length > 0) {
+            md += `### Pages Admin\n\n`;
+            for (const page of adminPages) {
+                const componentName = page.name
+                    .split("-")
+                    .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+                    .join("");
+                md += `- **GET** \`/admin/${config.slug.replace("module-", "")}/${page.name}\` - ${componentName}\n`;
+            }
+            md += `\n`;
+        }
+    }
+    // APIs section
+    if (config.tables.length > 0) {
+        md += `## 🔌 API Routes\n\n`;
+        for (const table of config.tables) {
+            for (const section of table.sections) {
+                md += `### \`/api/${section}/${table.name}\`\n\n`;
+                md += `**Méthodes supportées**: GET, POST, PUT, DELETE\n\n`;
+            }
+        }
+    }
+    // Database section
+    if (config.tables.length > 0) {
+        md += `## 🗄️ Base de Données\n\n`;
+        md += `### Tables\n\n`;
+        for (const table of config.tables) {
+            md += `#### \`${table.name}\`\n\n`;
+            md += `\`\`\`tsx\n`;
+            md += `<TableStructure\n`;
+            md += `  tableName="${table.name}"\n`;
+            md += `  title="${table.name}"\n`;
+            md += `  description="Table ${table.name} du module ${moduleNameClean}"\n`;
+            md += `/>\n`;
+            md += `\`\`\`\n\n`;
+        }
+        // Get migration files
+        const migrationsPath = path.join(moduleDir, "supabase", "migrations");
+        if (fs.existsSync(migrationsPath)) {
+            const migrationFiles = fs
+                .readdirSync(migrationsPath)
+                .filter((f) => f.endsWith(".sql"))
+                .sort();
+            if (migrationFiles.length > 0) {
+                md += `### Migrations\n\n`;
+                for (const migration of migrationFiles) {
+                    md += `- \`${migration}\`\n`;
+                }
+                md += `\n`;
+            }
+        }
+    }
+    // Installation section
+    md += `## 📦 Installation\n\n`;
+    md += `\`\`\`bash\n`;
+    md += `pnpm lastbrain add-module ${moduleNameClean}\n`;
+    md += `pnpm build:modules\n`;
+    md += `\`\`\`\n\n`;
+    md += `### Appliquer les migrations\n\n`;
+    md += `\`\`\`bash\n`;
+    md += `cd apps/votre-app\n`;
+    md += `supabase migration up\n`;
+    md += `\`\`\`\n\n`;
+    // Usage section
+    md += `## 💡 Utilisation\n\n`;
+    md += `<!-- 📝 Section à compléter par l'auteur du module -->\n\n`;
+    md += `### Exemple d'utilisation\n\n`;
+    md += `\`\`\`tsx\n`;
+    md += `// Importez les composants depuis le module\n`;
+    if (config.pages.length > 0) {
+        const firstPage = config.pages[0];
+        const componentName = firstPage.name
+            .split("-")
+            .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+            .join("");
+        md += `import { ${componentName}Page } from "${config.moduleName}";\n\n`;
+        md += `// Utilisez-les dans votre application\n`;
+        md += `<${componentName}Page />\n`;
+    }
+    md += `\`\`\`\n\n`;
+    md += `### Configuration\n\n`;
+    md += `<!-- Ajoutez ici les détails de configuration spécifiques -->\n\n`;
+    // Danger zone
+    md += `## ⚠️ Danger Zone\n\n`;
+    md += `La suppression du module supprimera toutes les pages, routes API et migrations associées. **Cette action est irréversible.**\n\n`;
+    md += `\`\`\`bash\n`;
+    md += `pnpm lastbrain remove-module ${moduleNameClean}\n`;
+    md += `pnpm build:modules\n`;
+    md += `\`\`\`\n\n`;
+    // Write README.md
+    const readmePath = path.join(moduleDir, "README.md");
+    await fs.writeFile(readmePath, md);
+    console.log(chalk.yellow("  📄 README.md"));
+}
+/**
+ * Met à jour le registre des modules dans core/src/config/modules.ts
+ */
+async function updateModuleRegistry(config, rootDir) {
+    const moduleRegistryPath = path.join(rootDir, "packages", "core", "src", "config", "modules.ts");
+    if (!fs.existsSync(moduleRegistryPath)) {
+        console.log(chalk.yellow("  ⚠️  Fichier de registre non trouvé, création..."));
+        // Si le fichier n'existe pas, on le crée avec le module actuel
+        const content = `/**
+ * Configuration centralisée des modules LastBrain
+ * Ce fichier est auto-généré et maintenu par les scripts de gestion des modules
+ */
+
+export interface ModuleMetadata {
+  name: string;
+  package: string;
+  description: string;
+  emoji: string;
+  version?: string;
+}
+
+export const AVAILABLE_MODULES: ModuleMetadata[] = [
+  {
+    name: "${config.slug.replace("module-", "")}",
+    package: "@lastbrain/${config.slug}",
+    description: "Module ${config.moduleName}",
+    emoji: "📦",
+  },
+];
+
+/**
+ * Récupère les métadonnées d'un module par son nom
+ */
+export function getModuleMetadata(name: string): ModuleMetadata | undefined {
+  return AVAILABLE_MODULES.find((m) => m.name === name);
+}
+
+/**
+ * Vérifie si un module existe
+ */
+export function moduleExists(name: string): boolean {
+  return AVAILABLE_MODULES.some((m) => m.name === name);
+}
+
+/**
+ * Récupère la liste des noms de modules disponibles
+ */
+export function getAvailableModuleNames(): string[] {
+  return AVAILABLE_MODULES.map((m) => m.name);
+}
+`;
+        await fs.writeFile(moduleRegistryPath, content, "utf-8");
+        console.log(chalk.green("  ✓ Registre créé"));
+        return;
+    }
+    try {
+        let content = await fs.readFile(moduleRegistryPath, "utf-8");
+        const moduleName = config.slug.replace("module-", "");
+        const moduleEntry = `  {
+    name: "${moduleName}",
+    package: "@lastbrain/${config.slug}",
+    description: "Module ${config.moduleName}",
+    emoji: "📦",
+  },`;
+        // Vérifier si le module existe déjà
+        if (content.includes(`name: "${moduleName}"`)) {
+            console.log(chalk.yellow(`  ⚠️  Module ${moduleName} déjà présent dans le registre`));
+            return;
+        }
+        // Trouver le tableau AVAILABLE_MODULES et ajouter le module
+        const arrayMatch = content.match(/export const AVAILABLE_MODULES: ModuleMetadata\[\] = \[([\s\S]*?)\];/);
+        if (arrayMatch) {
+            const arrayContent = arrayMatch[1];
+            const lastItem = arrayContent.trim().split("\n").pop();
+            // Ajouter le nouveau module à la fin du tableau
+            const newArrayContent = arrayContent.trimEnd() + "\n" + moduleEntry + "\n";
+            content = content.replace(/export const AVAILABLE_MODULES: ModuleMetadata\[\] = \[([\s\S]*?)\];/, `export const AVAILABLE_MODULES: ModuleMetadata[] = [${newArrayContent}];`);
+            await fs.writeFile(moduleRegistryPath, content, "utf-8");
+            console.log(chalk.green(`  ✓ Module ${moduleName} ajouté au registre`));
+        }
+        else {
+            console.log(chalk.yellow("  ⚠️  Format du registre non reconnu, ajout manuel requis"));
+        }
+    }
+    catch (error) {
+        console.log(chalk.yellow(`  ⚠️  Erreur lors de la mise à jour du registre: ${error}`));
+        console.log(chalk.gray("  Vous devrez ajouter manuellement le module au registre"));
+    }
+}
+/**
+ * Trouve le répertoire racine du workspace (avec pnpm-workspace.yaml)
+ */
+export function findWorkspaceRoot() {
+    let rootDir = process.cwd();
+    let attempts = 0;
+    const maxAttempts = 5;
+    while (attempts < maxAttempts) {
+        const workspaceFile = path.join(rootDir, "pnpm-workspace.yaml");
+        if (fs.existsSync(workspaceFile)) {
+            return rootDir;
+        }
+        rootDir = path.resolve(rootDir, "..");
+        attempts++;
+    }
+    throw new Error("Impossible de trouver le répertoire racine du workspace (pnpm-workspace.yaml non trouvé)");
+}
 /**
  * Crée la structure du module
  */
-async function createModuleStructure(config, rootDir) {
+export async function createModuleStructure(config, rootDir) {
     const moduleDir = path.join(rootDir, "packages", config.slug);
     console.log(chalk.blue(`\n📦 Création du module ${config.slug}...\n`));
     // Créer la structure de base
@@ -531,23 +1155,28 @@ async function createModuleStructure(config, rootDir) {
     await fs.ensureDir(path.join(moduleDir, "src"));
     await fs.ensureDir(path.join(moduleDir, "src", "web"));
     await fs.ensureDir(path.join(moduleDir, "src", "api"));
+    await fs.ensureDir(path.join(moduleDir, "src", "components"));
     await fs.ensureDir(path.join(moduleDir, "supabase", "migrations"));
+    await fs.ensureDir(path.join(moduleDir, "supabase", "migrations-down"));
     // Créer package.json
     console.log(chalk.yellow("  📄 package.json"));
     await fs.writeFile(path.join(moduleDir, "package.json"), generatePackageJson(config.moduleName, config.slug, rootDir));
     // Créer tsconfig.json
     console.log(chalk.yellow("  📄 tsconfig.json"));
     await fs.writeFile(path.join(moduleDir, "tsconfig.json"), generateTsConfig());
-    // Créer {slug}.build.config.ts
-    const buildConfigFileName = `${config.slug}.build.config.ts`;
+    // Créer {name}.build.config.ts (sans le préfixe module-)
+    const moduleNameOnly = config.slug.replace("module-", "");
+    const buildConfigFileName = `${moduleNameOnly}.build.config.ts`;
     console.log(chalk.yellow(`  📄 src/${buildConfigFileName}`));
     await fs.writeFile(path.join(moduleDir, "src", buildConfigFileName), generateBuildConfig(config));
     // Créer index.ts
     console.log(chalk.yellow("  📄 src/index.ts"));
-    await fs.writeFile(path.join(moduleDir, "src", "index.ts"), generateIndexTs(config.pages));
-    // Créer server.ts
-    console.log(chalk.yellow("  📄 src/server.ts"));
-    await fs.writeFile(path.join(moduleDir, "src", "server.ts"), generateServerTs(config.tables));
+    await fs.writeFile(path.join(moduleDir, "src", "index.ts"), generateIndexTs(config.pages, moduleNameOnly));
+    // Note: server.ts n'est plus généré pour éviter les conflits d'exports
+    // Les routes API sont exposées via le build.config et l'app les importe dynamiquement
+    // Créer Doc.tsx
+    console.log(chalk.yellow("  📄 src/components/Doc.tsx"));
+    await fs.writeFile(path.join(moduleDir, "src", "components", "Doc.tsx"), generateDocComponent(config));
     // Créer les pages
     console.log(chalk.blue("\n📄 Création des pages..."));
     for (const page of config.pages) {
@@ -585,14 +1214,56 @@ async function createModuleStructure(config, rootDir) {
         const migrationFileName = `${timestamp}_${config.slug}_init.sql`;
         console.log(chalk.yellow(`  📄 supabase/migrations/${migrationFileName}`));
         await fs.writeFile(path.join(moduleDir, "supabase", "migrations", migrationFileName), generateMigration(config.tables, config.slug));
+        // Génération du fichier DOWN correspondant pour rollback
+        const downFileName = `${timestamp}_${config.slug}_init.sql`;
+        const downContent = config.tables
+            .map((t) => `-- Rollback for table ${t.name}\nDROP POLICY IF EXISTS ${t.name}_owner_delete ON public.${t.name};\nDROP POLICY IF EXISTS ${t.name}_owner_update ON public.${t.name};\nDROP POLICY IF EXISTS ${t.name}_owner_insert ON public.${t.name};\nDROP POLICY IF EXISTS ${t.name}_owner_select ON public.${t.name};\nDROP TRIGGER IF EXISTS set_${t.name}_updated_at ON public.${t.name};\nDROP INDEX IF EXISTS idx_${t.name}_owner_id;\nDROP TABLE IF EXISTS public.${t.name};\n`)
+            .join("\n");
+        console.log(chalk.yellow(`  📄 supabase/migrations-down/${downFileName}`));
+        await fs.writeFile(path.join(moduleDir, "supabase", "migrations-down", downFileName), `-- DOWN migration for ${config.slug}\n${downContent}`);
+    }
+    // Générer la documentation du module
+    console.log(chalk.blue("\n📝 Génération de la documentation..."));
+    await generateModuleReadme(config, moduleDir);
+    // Installer les dépendances
+    console.log(chalk.blue("\n📦 Installation des dépendances..."));
+    const { execSync } = await import("child_process");
+    const installCmd = process.env.CI
+        ? "pnpm install --no-frozen-lockfile"
+        : "pnpm install";
+    try {
+        execSync(installCmd, {
+            cwd: moduleDir,
+            stdio: "inherit",
+        });
+        console.log(chalk.green("\n✅ Dépendances installées avec succès!"));
+    }
+    catch (error) {
+        console.log(chalk.yellow("\n⚠️  Erreur lors de l'installation, veuillez exécuter manuellement:"));
+        console.log(chalk.gray(`  cd ${moduleDir} && pnpm install`));
+    }
+    // Mettre à jour le registre des modules dans le core
+    console.log(chalk.blue("\n📝 Mise à jour du registre des modules..."));
+    await updateModuleRegistry(config, rootDir);
+    // Build auto du module pour générer dist immédiatement
+    console.log(chalk.blue("\n🏗️  Build initial du module..."));
+    try {
+        execSync(`pnpm --filter ${config.slug} build`, {
+            cwd: rootDir,
+            stdio: "inherit",
+        });
+        console.log(chalk.green("✓ Module compilé"));
+    }
+    catch (error) {
+        console.log(chalk.yellow("⚠️  Build automatique échoué, exécutez: cd"), config.slug, "&& pnpm build");
     }
     console.log(chalk.green(`\n✅ Module ${config.slug} créé avec succès!\n`));
     console.log(chalk.gray(`📂 Emplacement: ${moduleDir}\n`));
     console.log(chalk.blue("Prochaines étapes:"));
-    console.log(chalk.gray(`  1. cd ${moduleDir}`));
-    console.log(chalk.gray(`  2. pnpm install`));
-    console.log(chalk.gray(`  3. pnpm build`));
-    console.log(chalk.gray(`  4. Ajouter le module à votre app avec: pnpm lastbrain add ${config.slug.replace("module-", "")}\n`));
+    console.log(chalk.gray(`  1. Ajouter à une app: pnpm lastbrain add-module ${config.slug.replace("module-", "")}`));
+    console.log(chalk.gray("  2. (Optionnel) Modifier Doc.tsx pour documentation personnalisée"));
+    console.log(chalk.gray("  3. Publier: pnpm publish:" + config.slug));
+    console.log(chalk.gray("  4. Générer docs globales: pnpm generate:all\n"));
 }
 /**
  * Point d'entrée du script
@@ -646,29 +1317,50 @@ export async function createModule() {
     const pages = [];
     // Pages publiques
     const publicPages = parsePagesList(answers.pagesPublic);
+    const invalidPublic = publicPages.filter((n) => RESERVED_PAGE_NAMES.has(n));
+    if (invalidPublic.length) {
+        console.error(chalk.red(`❌ Noms de pages publiques réservés détectés: ${invalidPublic.join(", ")}`));
+        console.error(chalk.yellow("Noms interdits: layout, page, api, admin, auth, public. Choisissez des noms métier distincts."));
+        process.exit(1);
+    }
     for (const pageName of publicPages) {
+        const slugName = slugifyPageName(pageName);
         pages.push({
             section: "public",
-            path: `/${pageName}`,
-            name: pageName,
+            path: `/${slugName}`,
+            name: slugName,
         });
     }
     // Pages auth
     const authPages = parsePagesList(answers.pagesAuth);
+    const invalidAuth = authPages.filter((n) => RESERVED_PAGE_NAMES.has(n));
+    if (invalidAuth.length) {
+        console.error(chalk.red(`❌ Noms de pages auth réservés détectés: ${invalidAuth.join(", ")}`));
+        console.error(chalk.yellow("Noms interdits: layout, page, api, admin, auth, public. Utilisez des noms métier (ex: dashboard, profile)."));
+        process.exit(1);
+    }
     for (const pageName of authPages) {
+        const slugName = slugifyPageName(pageName);
         pages.push({
             section: "auth",
-            path: `/${pageName}`,
-            name: pageName,
+            path: `/${slugName}`,
+            name: slugName,
         });
     }
     // Pages admin
     const adminPages = parsePagesList(answers.pagesAdmin);
+    const invalidAdmin = adminPages.filter((n) => RESERVED_PAGE_NAMES.has(n));
+    if (invalidAdmin.length) {
+        console.error(chalk.red(`❌ Noms de pages admin réservés détectés: ${invalidAdmin.join(", ")}`));
+        console.error(chalk.yellow("Noms interdits: layout, page, api, admin, auth, public. Utilisez des noms métier (ex: settings, users)."));
+        process.exit(1);
+    }
     for (const pageName of adminPages) {
+        const slugName = slugifyPageName(pageName);
         pages.push({
             section: "admin",
-            path: `/${pageName}`,
-            name: pageName,
+            path: `/${slugName}`,
+            name: slugName,
         });
     }
     // Tables
@@ -698,19 +1390,12 @@ export async function createModule() {
         tables,
     };
     // Trouver le répertoire racine du workspace (chercher pnpm-workspace.yaml)
-    let rootDir = process.cwd();
-    let attempts = 0;
-    const maxAttempts = 5;
-    while (attempts < maxAttempts) {
-        const workspaceFile = path.join(rootDir, "pnpm-workspace.yaml");
-        if (fs.existsSync(workspaceFile)) {
-            break;
-        }
-        rootDir = path.resolve(rootDir, "..");
-        attempts++;
+    let rootDir;
+    try {
+        rootDir = findWorkspaceRoot();
     }
-    if (attempts === maxAttempts) {
-        console.error(chalk.red("❌ Impossible de trouver le répertoire racine du workspace (pnpm-workspace.yaml non trouvé)"));
+    catch (error) {
+        console.error(chalk.red("❌ " + error.message));
         process.exit(1);
     }
     // Créer le module