@lastbrain/app 0.1.33 → 0.1.36

package/README.md

@@ -11,18 +11,36 @@ Package principal pour créer et gérer des applications Next.js LastBrain.
 - 🔧 **Scripts utilitaires** - Gestion modules, migrations DB, génération docs
 - 🎨 **Intégration Tailwind v4** - Configuration optimale out-of-the-box
 
-## 📦 Installation
+## 📦 Installation & Démarrage rapide
+
+> **Recommandé :** Utilisez directement le CLI pour créer une nouvelle application
 
 ```bash
-pnpm add @lastbrain/app @lastbrain/core @lastbrain/ui
+# Créer une nouvelle application LastBrain
+pnpx @lastbrain/app@latest init mon-app
+
+# Accéder au dossier
+cd mon-app
+
+# Initialiser Supabase (optionnel)
+pnpm db:init
+
+# Démarrer le serveur
+pnpm dev
 ```
 
-## 🚀 Démarrage rapide
+### Installation manuelle
+
+Si vous souhaitez intégrer LastBrain dans un projet existant :
+
+```bash
+pnpm add @lastbrain/app @lastbrain/core @lastbrain/ui
+```
 
-### 1. Créer une nouvelle application
+## 🚀 Ce que fait la commande init
 
 ```bash
-pnpm lastbrain init
+pnpx @lastbrain/app@latest init mon-app
 ```
 
 Cette commande génère une application Next.js complète avec :

package/dist/scripts/db-init.js

@@ -80,10 +80,29 @@ function parseEnvFile(filePath) {
     }));
 }
 function ensureEnvFile(values) {
-    const content = Object.entries(values)
-        .map(([key, value]) => `${key}=${value}`)
-        .join("\n");
     envTargets.forEach((target) => {
+        let existingVars = {};
+        // Lire le fichier .env.local existant pour préserver les variables personnalisées
+        if (fs.existsSync(target)) {
+            try {
+                const existingContent = fs.readFileSync(target, "utf-8");
+                existingVars = Object.fromEntries(existingContent
+                    .split("\n")
+                    .filter((line) => line.includes("=") && !line.startsWith("#"))
+                    .map((line) => {
+                    const [key, ...value] = line.split("=");
+                    return [key, value.join("=")];
+                }));
+            }
+            catch (error) {
+                console.warn(`⚠️  Erreur lors de la lecture de ${target}:`, error);
+            }
+        }
+        // Fusionner les nouvelles valeurs avec les existantes (nouvelles valeurs prioritaires)
+        const mergedValues = { ...existingVars, ...values };
+        const content = Object.entries(mergedValues)
+            .map(([key, value]) => `${key}=${value}`)
+            .join("\n");
         fs.writeFileSync(target, content);
         console.log(`📝 Wrote env to ${target}`);
     });

package/dist/scripts/module-create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-create.d.ts","sourceRoot":"","sources":["../../src/scripts/module-create.ts"],"names":[],"mappings":"AAktBA;;GAEG;AACH,wBAAsB,YAAY,kBAyIjC"}
+{"version":3,"file":"module-create.d.ts","sourceRoot":"","sources":["../../src/scripts/module-create.ts"],"names":[],"mappings":"AAqsCA;;GAEG;AACH,wBAAsB,YAAY,kBAyIjC"}

package/dist/scripts/module-create.js

@@ -248,6 +248,9 @@ function generateIndexTs(pages) {
     return `// Client Components
 ${exports.join("\n")}
 
+// Documentation Component
+export { Doc } from "./components/Doc.js";
+
 // Configuration de build
 export { default as buildConfig } from "./build.config.js";
 `;
@@ -520,6 +523,448 @@ $$;
 ${tablesSQL}
 `;
 }
+/**
+ * Generate Doc.tsx component for the module
+ */
+function generateDocComponent(config) {
+    const moduleNameClean = config.slug.replace("module-", "");
+    // 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">${page.path}</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** \`${page.path}\` - ${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"));
+}
 /**
  * Crée la structure du module
  */
@@ -531,6 +976,7 @@ 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"));
     // Créer package.json
     console.log(chalk.yellow("  📄 package.json"));
@@ -548,6 +994,9 @@ async function createModuleStructure(config, rootDir) {
     // Créer server.ts
     console.log(chalk.yellow("  📄 src/server.ts"));
     await fs.writeFile(path.join(moduleDir, "src", "server.ts"), generateServerTs(config.tables));
+    // 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) {
@@ -586,6 +1035,9 @@ async function createModuleStructure(config, rootDir) {
         console.log(chalk.yellow(`  📄 supabase/migrations/${migrationFileName}`));
         await fs.writeFile(path.join(moduleDir, "supabase", "migrations", migrationFileName), generateMigration(config.tables, config.slug));
     }
+    // Générer la documentation du module
+    console.log(chalk.blue("\n📝 Génération de la documentation..."));
+    await generateModuleReadme(config, moduleDir);
     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:"));