@lastbrain/module-ai 0.1.8 → 0.1.10

package/README.md

@@ -1,481 +1,89 @@
-# @lastbrain/module-ai
+# 📦 Module ai
 
-Module de génération IA complet pour LastBrain avec OpenAI. Fournit des pages web, des API routes et un système de gestion de tokens pour la génération de texte et d'images.
+> @lastbrain/module-ai
 
-## 🎯 Vue d'ensemble
+## 📋 Informations
 
-Ce module inclut tout ce dont vous avez besoin pour l'IA :
+- **Nom du package**: `@lastbrain/module-ai`
+- **Slug**: `module-ai`
+- **Type**: Module LastBrain
 
-- 🤖 **Génération de texte** - Utilise GPT-4o pour la génération de contenu
-- 🎨 **Génération d'images** - Intégration DALL-E pour créer des images
-- 💳 **Gestion de tokens** - Système de crédits et suivi de consommation
-- 📊 **Dashboard admin** - Gestion des tokens utilisateurs par les admins
-- 🛡️ **Sécurité** - Protection RLS et contrôle d'accès
+## 📄 Pages Disponibles
 
-## 🚀 Démarrage rapide
+### Pages Protégées (Auth)
 
-> **Recommandé :** Utilisez le CLI LastBrain pour créer une application complète avec le module AI
+- **GET** `/token` - TokenPage
 
-```bash
-# Créer une nouvelle application avec le module AI inclus
-pnpx @lastbrain/app@latest init mon-app
-# Sélectionner "🤖 AI Generation" 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-ai @lastbrain/core @lastbrain/ui
-```
+### Pages Admin
 
-Puis ajoutez le module à votre projet LastBrain :
+- **GET** `/user-token` - UserTokenPage
 
-```bash
-pnpm lastbrain add-module ai
-pnpm build:modules
-```
+## 🗄️ Base de Données
 
-## ⚙️ Configuration
+### Tables
 
-### Variables d'environnement
-
-```bash
-# .env.local
-OPENAI_API_KEY=sk-your-openai-api-key-here
-
-# Supabase (requis)
-NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
-NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
-SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
-```
-
-### Configuration OpenAI
-
-Le module utilise les modèles OpenAI suivants par défaut :
-
-- **Texte** : `gpt-4o` (ou `gpt-4o-mini` pour les tâches simples)
-- **Images** : `dall-e-3` (ou `dall-e-2` pour des coûts réduits)
-
-## 🖼️ Pages Web fournies
-
-### Pages Utilisateur Authentifié
-
-#### 1. Gestion des Tokens (`/auth/ai/token`)
-
-**Component**: `TokenPage`
-
-Page de gestion des tokens utilisateur :
-
-- Solde actuel de tokens
-- Historique des transactions
-- Bouton pour acheter des tokens (placeholder)
-- Statistiques d'utilisation
+#### `user_token_ledger`
 
 ```tsx
-import { TokenPage } from "@lastbrain/module-ai";
-
-export default function UserTokens() {
-  return <TokenPage />;
-}
+<TableStructure
+  tableName="user_token_ledger"
+  title="user_token_ledger"
+  description="Table user_token_ledger du module ai"
+/>
 ```
 
-### Pages Administration
-
-#### 2. Administration des Tokens (`/admin/ai/user-token`)
-
-**Component**: `AdminUserTokenPage`
-
-Page d'administration pour gérer les tokens de tous les utilisateurs :
-
-- Liste de tous les utilisateurs avec leurs soldes
-- Recherche par email ou nom
-- Ajout/retrait de tokens pour un utilisateur
-- Pagination et tri
+#### `user_prompts`
 
 ```tsx
-import { AdminUserTokenPage } from "@lastbrain/module-ai";
-
-export default function AdminTokens() {
-  return <AdminUserTokenPage />;
-}
-```
-
-#### 3. Détail Utilisateur (`/admin/ai/user-token/[id]`)
-
-**Component**: `AdminUserTokenDetailPage`
-
-Page détaillée pour un utilisateur spécifique :
-
-- Historique complet des transactions
-- Ajout/retrait de tokens avec commentaire
-- Statistiques d'utilisation détaillées
-
-```tsx
-import { AdminUserTokenDetailPage } from "@lastbrain/module-ai";
-
-export default function AdminUserDetail() {
-  return <AdminUserTokenDetailPage />;
-}
-```
-
-## 🔌 Routes API
-
-### API Génération IA (`/api/ai/*`)
-
-#### POST `/api/ai/generate-text`
-
-Génère du texte avec GPT.
-
-**Body** :
-
-```json
-{
-  "prompt": "Écris un article sur l'IA",
-  "model": "gpt-4o", // optionnel, défaut: gpt-4o
-  "max_tokens": 1000, // optionnel, défaut: 500
-  "temperature": 0.7, // optionnel, défaut: 0.7
-  "cost_tokens": 100 // coût en tokens pour cette génération
-}
-```
-
-**Réponse** :
-
-```json
-{
-  "data": {
-    "text": "L'intelligence artificielle...",
-    "tokens_used": 95,
-    "model": "gpt-4o",
-    "cost_tokens": 100,
-    "remaining_tokens": 900
-  }
-}
+<TableStructure
+  tableName="user_prompts"
+  title="user_prompts"
+  description="Table user_prompts du module ai"
+/>
 ```
 
-#### POST `/api/ai/generate-image`
-
-Génère une image avec DALL-E.
-
-**Body** :
-
-```json
-{
-  "prompt": "Un chat en costume d'astronaute",
-  "model": "dall-e-3", // optionnel, défaut: dall-e-3
-  "size": "1024x1024", // optionnel, défaut: 1024x1024
-  "quality": "hd", // optionnel, défaut: standard
-  "cost_tokens": 200 // coût en tokens pour cette génération
-}
-```
-
-**Réponse** :
-
-```json
-{
-  "data": {
-    "image_url": "https://...",
-    "revised_prompt": "A cat wearing an astronaut suit...",
-    "model": "dall-e-3",
-    "cost_tokens": 200,
-    "remaining_tokens": 800
-  }
-}
-```
-
-### API Administration (`/api/ai/admin/*`)
-
-⚠️ **Toutes les routes admin nécessitent un accès super admin.**
-
-#### GET `/api/ai/admin/user-token`
-
-Liste tous les utilisateurs avec leurs soldes de tokens.
+### Migrations
 
-**Query Parameters** :
+- `20251121000000_ai_tokens.sql`
+- `20251121093113_module-ai_init.sql`
 
-- `page` (optionnel, défaut: 1)
-- `per_page` (optionnel, défaut: 20)
-- `search` (optionnel) : Recherche par email ou nom
+## 📦 Installation
 
-**Réponse** :
-
-```json
-{
-  "data": [
-    {
-      "user_id": "uuid",
-      "email": "user@example.com",
-      "full_name": "John Doe",
-      "balance": 1500,
-      "total_spent": 500,
-      "last_transaction": "2024-01-01T00:00:00Z"
-    }
-  ],
-  "pagination": {
-    "page": 1,
-    "per_page": 20,
-    "total": 100,
-    "total_pages": 5
-  }
-}
-```
-
-#### POST `/api/ai/admin/user-token`
-
-Ajoute ou retire des tokens pour un utilisateur.
-
-**Body** :
-
-```json
-{
-  "user_id": "uuid",
-  "amount": 1000, // positif pour ajouter, négatif pour retirer
-  "description": "Achat de tokens premium",
-  "transaction_type": "purchase" // purchase, admin_grant, admin_debit, etc.
-}
-```
-
-#### GET `/api/ai/admin/user-token/[id]`
-
-Détails et historique pour un utilisateur spécifique.
-
-**Réponse** :
-
-```json
-{
-  "data": {
-    "user": {
-      "id": "uuid",
-      "email": "user@example.com",
-      "full_name": "John Doe",
-      "balance": 1500
-    },
-    "transactions": [
-      {
-        "id": "uuid",
-        "amount": 1000,
-        "description": "Achat de tokens",
-        "transaction_type": "purchase",
-        "created_at": "2024-01-01T00:00:00Z"
-      }
-    ],
-    "stats": {
-      "total_spent": 500,
-      "total_generated_texts": 25,
-      "total_generated_images": 10
-    }
-  }
-}
-```
-
-## 🗄️ Schéma de Base de Données
-
-### Table `user_token_ledger`
-
-Stocke les transactions de tokens des utilisateurs.
-
-```sql
-CREATE TABLE public.user_token_ledger (
-  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-  owner_id UUID NOT NULL REFERENCES auth.users(id) ON DELETE CASCADE,
-  amount INTEGER NOT NULL,
-  balance_after INTEGER NOT NULL,
-  description TEXT,
-  transaction_type TEXT NOT NULL DEFAULT 'usage',
-  metadata JSONB DEFAULT '{}'::jsonb,
-  created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
-  updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
-);
+```bash
+pnpm lastbrain add-module ai
+pnpm build:modules
 ```
 
-**Types de transactions** :
+### Appliquer les migrations
 
-- `purchase` : Achat de tokens
-- `usage` : Utilisation pour génération IA
-- `admin_grant` : Attribution par un admin
-- `admin_debit` : Retrait par un admin
-- `refund` : Remboursement
-
-### Table `user_prompts`
-
-Stocke l'historique des prompts et générations.
-
-```sql
-CREATE TABLE public.user_prompts (
-  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-  owner_id UUID NOT NULL REFERENCES auth.users(id) ON DELETE CASCADE,
-  prompt TEXT NOT NULL,
-  response TEXT,
-  model TEXT NOT NULL,
-  tokens_used INTEGER,
-  cost_tokens INTEGER,
-  generation_type TEXT NOT NULL, -- 'text' ou 'image'
-  metadata JSONB DEFAULT '{}'::jsonb,
-  created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
-  updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
-);
+```bash
+cd apps/votre-app
+supabase migration up
 ```
 
-### Vues et Fonctions
+## 💡 Utilisation
 
-#### Vue `user_token_balance_v`
+<!-- 📝 Section à compléter par l'auteur du module -->
 
-Calcule automatiquement le solde actuel de chaque utilisateur :
-
-```sql
-CREATE VIEW user_token_balance_v AS
-SELECT
-  owner_id,
-  COALESCE(SUM(amount), 0) as balance,
-  COUNT(*) as total_transactions,
-  MAX(created_at) as last_transaction
-FROM user_token_ledger
-GROUP BY owner_id;
-```
-
-## 🔧 Utilisation dans le Code
-
-### Hooks React
+### Exemple d'utilisation
 
 ```tsx
-import { useTokenBalance, useAIGeneration } from "@lastbrain/module-ai";
-
-function MyAIComponent() {
-  const { balance, loading, refetch } = useTokenBalance();
-  const { generateText, generating } = useAIGeneration();
-
-  const handleGenerate = async () => {
-    const result = await generateText({
-      prompt: "Écris un poème sur l'automne",
-      max_tokens: 200,
-      cost_tokens: 50,
-    });
-
-    if (result.success) {
-      console.log("Texte généré:", result.data.text);
-      refetch(); // Rafraîchir le solde
-    }
-  };
-
-  return (
-    <div>
-      <p>Solde: {balance} tokens</p>
-      <Button onPress={handleGenerate} isLoading={generating}>
-        Générer du texte
-      </Button>
-    </div>
-  );
-}
-```
-
-### Utilisation directe des APIs
-
-```typescript
-// Génération de texte
-const response = await fetch("/api/ai/generate-text", {
-  method: "POST",
-  headers: { "Content-Type": "application/json" },
-  body: JSON.stringify({
-    prompt: "Explique l'intelligence artificielle",
-    max_tokens: 500,
-    cost_tokens: 100,
-  }),
-});
-
-const result = await response.json();
-console.log(result.data.text);
-
-// Génération d'image
-const imageResponse = await fetch("/api/ai/generate-image", {
-  method: "POST",
-  headers: { "Content-Type": "application/json" },
-  body: JSON.stringify({
-    prompt: "Un paysage futuriste",
-    size: "1024x1024",
-    cost_tokens: 200,
-  }),
-});
-
-const imageResult = await imageResponse.json();
-console.log(imageResult.data.image_url);
-```
-
-## 💳 Système de Tokens
-
-### Coûts par défaut
-
-Les coûts en tokens sont configurables mais voici les valeurs par défaut :
-
-**Génération de texte** :
-
-- GPT-4o : 1 token = ~10 tokens OpenAI
-- GPT-4o-mini : 1 token = ~5 tokens OpenAI
-
-**Génération d'images** :
-
-- DALL-E 3 (1024x1024) : 200 tokens
-- DALL-E 2 (1024x1024) : 100 tokens
-
-### Gestion du solde
-
-```typescript
-// Vérifier le solde avant génération
-const checkBalance = async (requiredTokens: number) => {
-  const response = await fetch("/api/ai/user/balance");
-  const { balance } = await response.json();
-
-  if (balance < requiredTokens) {
-    throw new Error("Solde insuffisant");
-  }
-};
+// Importez les composants depuis le module
+import { TokenPage } from "@lastbrain/module-ai";
 
-// Débiter automatiquement lors de la génération
-await generateText({
-  prompt: "...",
-  cost_tokens: 100, // Sera automatiquement débité
-});
+// Utilisez-les dans votre application
+<TokenPage />;
 ```
 
-## 🛡️ Sécurité et Limitations
+### Configuration
 
-### Protection contre l'abus
+<!-- Ajoutez ici les détails de configuration spécifiques -->
 
-- **Rate limiting** : Les APIs ont des limites de débit
-- **Validation des prompts** : Filtrage du contenu inapproprié
-- **Vérification du solde** : Impossible de générer sans tokens suffisants
+## ⚠️ Danger Zone
 
-### Row Level Security (RLS)
+La suppression du module supprimera toutes les pages, routes API et migrations associées. **Cette action est irréversible.**
 
-- Les utilisateurs ne voient que leurs propres transactions et prompts
-- Les admins ont accès à toutes les données via les routes `/admin/*`
-
-### Exemple de politique RLS
-
-```sql
--- Les utilisateurs ne voient que leurs propres transactions
-CREATE POLICY "user_token_ledger_owner_select" ON public.user_token_ledger
-FOR SELECT USING (auth.uid() = owner_id);
-
--- Seuls les admins peuvent modifier via les APIs admin
-CREATE POLICY "user_token_ledger_admin_all" ON public.user_token_ledger
-FOR ALL USING (public.is_superadmin(auth.uid()));
+```bash
+pnpm lastbrain remove-module ai
+pnpm build:modules
 ```
-
-## 🤝 Contribuer
-
-Ce package fait partie du monorepo LastBrain. Voir le [CONTRIBUTING.md](../../CONTRIBUTING.md) principal.
-
-## 📄 Licence
-
-MIT - Voir [LICENSE](../../LICENSE)
-
-## 🔗 Liens utiles
-
-- [OpenAI API Documentation](https://platform.openai.com/docs/api-reference)
-- [DALL-E Guide](https://platform.openai.com/docs/guides/images)
-- [GPT-4 Documentation](https://platform.openai.com/docs/models/gpt-4)

package/dist/components/Doc.d.ts

@@ -1,2 +1,9 @@
-export declare function AiModuleDoc(): import("react/jsx-runtime").JSX.Element;
+/**
+ * Documentation component for @lastbrain/module-ai
+ * Auto-generated from module-ai.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

package/dist/components/Doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Doc.d.ts","sourceRoot":"","sources":["../../src/components/Doc.tsx"],"names":[],"mappings":"AAUA,wBAAgB,WAAW,4CAqU1B"}
+{"version":3,"file":"Doc.d.ts","sourceRoot":"","sources":["../../src/components/Doc.tsx"],"names":[],"mappings":"AAgBA;;;;;;GAMG;AACH,wBAAgB,GAAG,4CA4PlB"}

package/dist/components/Doc.js

@@ -1,5 +1,22 @@
+"use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Card, CardBody, CardHeader, Snippet, Chip, TableStructure, } from "@lastbrain/ui";
-export function AiModuleDoc() {
-    return (_jsxs("div", { className: "space-y-6", children: [_jsxs("div", { className: "flex items-start justify-between", children: [_jsxs("div", { children: [_jsx("h2", { className: "text-3xl font-bold mb-2", children: "Module AI" }), _jsx("p", { className: "text-slate-600 dark:text-slate-400", children: "G\u00E9n\u00E9ration IA (texte et images) avec syst\u00E8me de tokens et gestion des co\u00FBts" })] }), _jsx(Chip, { color: "primary", variant: "flat", children: "v0.1.0" })] }), _jsxs(Card, { children: [_jsx(CardHeader, { children: _jsx("h3", { className: "text-xl font-semibold", children: "\uD83D\uDCDD Informations" }) }), _jsxs(CardBody, { className: "space-y-2", children: [_jsxs("div", { children: [_jsx("span", { className: "font-semibold", children: "Auteur:" }), " LastBrain Team"] }), _jsxs("div", { children: [_jsx("span", { className: "font-semibold", children: "Package:" }), " @lastbrain/module-ai"] }), _jsxs("div", { children: [_jsx("span", { className: "font-semibold", children: "Derni\u00E8re mise \u00E0 jour:" }), " 21 novembre 2025"] })] })] }), _jsxs(Card, { children: [_jsx(CardHeader, { children: _jsx("h3", { className: "text-xl font-semibold", children: "\uD83C\uDFA8 Composants Disponibles" }) }), _jsxs(CardBody, { className: "space-y-3", children: [_jsxs("div", { children: [_jsx("h4", { className: "font-semibold mb-2", children: "TextareaGenerative" }), _jsx("p", { className: "text-sm text-slate-600 dark:text-slate-400 mb-2", children: "Textarea avec g\u00E9n\u00E9ration de texte IA int\u00E9gr\u00E9e. Bouton de g\u00E9n\u00E9ration avec s\u00E9lection de prompts." }), _jsx(Snippet, { symbol: "", color: "default", size: "sm", hideSymbol: true, children: _jsxs("div", { className: "flex flex-col gap-1", children: [_jsxs("span", { children: ["import ", "{ TextareaGenerative }", " from \"@lastbrain/module-ai\";"] }), _jsx("span", {}), _jsx("span", { children: "<TextareaGenerative" }), _jsx("span", { children: " label=\"Description\"" }), _jsx("span", { children: " placeholder=\"Entrez une description...\"" }), _jsxs("span", { children: [" value=", "{value}"] }), _jsxs("span", { children: [" onChange=", "{setValue}"] }), _jsx("span", { children: "/>" })] }) })] }), _jsxs("div", { children: [_jsx("h4", { className: "font-semibold mb-2 mt-4", children: "ImageGenerative" }), _jsx("p", { className: "text-sm text-slate-600 dark:text-slate-400 mb-2", children: "Composant de g\u00E9n\u00E9ration d'images avec DALL-E. Upload ou g\u00E9n\u00E9ration IA." }), _jsx(Snippet, { symbol: "", color: "default", size: "sm", hideSymbol: true, children: _jsxs("div", { className: "flex flex-col gap-1", children: [_jsxs("span", { children: ["import ", "{ ImageGenerative }", " from \"@lastbrain/module-ai\";"] }), _jsx("span", {}), _jsx("span", { children: "<ImageGenerative" }), _jsx("span", { children: " label=\"Image du produit\"" }), _jsxs("span", { children: [" value=", "{imageUrl}"] }), _jsxs("span", { children: [" onChange=", "{setImageUrl}"] }), _jsx("span", { children: "/>" })] }) })] })] })] }), _jsxs(Card, { children: [_jsx(CardHeader, { children: _jsx("h3", { className: "text-xl font-semibold", children: "\uD83D\uDCC4 Pages Disponibles" }) }), _jsxs(CardBody, { className: "space-y-3", children: [_jsxs("div", { children: [_jsx("h4", { className: "font-semibold mb-2", children: "Pages Prot\u00E9g\u00E9es (Auth)" }), _jsx("div", { className: "space-y-2", children: _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Chip, { size: "sm", color: "primary", variant: "flat", children: "GET" }), _jsx("code", { className: "text-sm", children: "/auth/token" }), _jsx("span", { className: "text-slate-600 dark:text-slate-400", children: "- Historique et balance des tokens" })] }) })] }), _jsxs("div", { children: [_jsx("h4", { className: "font-semibold mb-2", children: "Pages Admin" }), _jsxs("div", { className: "space-y-2", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Chip, { size: "sm", color: "danger", variant: "flat", children: "GET" }), _jsx("code", { className: "text-sm", children: "/admin/user-token" }), _jsx("span", { className: "text-slate-600 dark:text-slate-400", children: "- Gestion des tokens utilisateurs" })] }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Chip, { size: "sm", color: "danger", variant: "flat", children: "GET" }), _jsx("code", { className: "text-sm", children: "/admin/user-token/[id]" }), _jsx("span", { className: "text-slate-600 dark:text-slate-400", children: "- D\u00E9tail d'un utilisateur" })] })] })] })] })] }), _jsxs(Card, { children: [_jsx(CardHeader, { children: _jsx("h3", { className: "text-xl font-semibold", children: "\uD83D\uDD0C Routes API" }) }), _jsxs(CardBody, { className: "space-y-2", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Chip, { size: "sm", color: "warning", variant: "flat", children: "POST" }), _jsx("code", { className: "text-sm", children: "/api/ai/generate-text" }), _jsx("span", { className: "text-slate-600 dark:text-slate-400", children: "- G\u00E9n\u00E9ration de texte" })] }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Chip, { size: "sm", color: "warning", variant: "flat", children: "POST" }), _jsx("code", { className: "text-sm", children: "/api/ai/generate-image" }), _jsx("span", { className: "text-slate-600 dark:text-slate-400", children: "- G\u00E9n\u00E9ration d'image" })] }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Chip, { size: "sm", color: "success", variant: "flat", children: "GET" }), _jsx("code", { className: "text-sm", children: "/api/ai/admin/user-token" }), _jsx("span", { className: "text-slate-600 dark:text-slate-400", children: "- Liste des tokens utilisateurs" })] }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Chip, { size: "sm", color: "warning", variant: "flat", children: "POST" }), _jsx("code", { className: "text-sm", children: "/api/ai/admin/user-token" }), _jsx("span", { className: "text-slate-600 dark:text-slate-400", children: "- Cr\u00E9er/modifier des tokens" })] }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Chip, { size: "sm", color: "success", variant: "flat", children: "GET" }), _jsx("code", { className: "text-sm", children: "/api/ai/admin/user-token/[id]" }), _jsx("span", { className: "text-slate-600 dark:text-slate-400", children: "- D\u00E9tails tokens utilisateur" })] })] })] }), _jsxs(Card, { children: [_jsx(CardHeader, { children: _jsx("h3", { className: "text-xl font-semibold", children: "\uD83D\uDCC1 Structure" }) }), _jsx(CardBody, { children: _jsx(Snippet, { symbol: "", color: "default", size: "sm", hideSymbol: true, children: _jsxs("div", { className: "flex flex-col gap-1 text-xs font-mono", children: [_jsx("span", { children: "module-ai/" }), _jsx("span", { children: "\u251C\u2500\u2500 src/" }), _jsx("span", { children: "\u2502 \u251C\u2500\u2500 web/" }), _jsx("span", { children: "\u2502 \u2502 \u251C\u2500\u2500 TextareaGenerative.tsx" }), _jsx("span", { children: "\u2502 \u2502 \u2514\u2500\u2500 ImageGenerative.tsx" }), _jsx("span", { children: "\u2502 \u251C\u2500\u2500 api/" }), _jsx("span", { children: "\u2502 \u2502 \u251C\u2500\u2500 generate-text.ts" }), _jsx("span", { children: "\u2502 \u2502 \u251C\u2500\u2500 generate-image.ts" }), _jsx("span", { children: "\u2502 \u2502 \u251C\u2500\u2500 prompts.ts" }), _jsx("span", { children: "\u2502 \u2502 \u2514\u2500\u2500 balance.ts" }), _jsx("span", { children: "\u2502 \u251C\u2500\u2500 components/" }), _jsx("span", { children: "\u2502 \u2502 \u2514\u2500\u2500 Doc.tsx" }), _jsx("span", { children: "\u2502 \u2514\u2500\u2500 ai.build.config.ts" }), _jsx("span", { children: "\u2514\u2500\u2500 supabase/" }), _jsx("span", { children: " \u2514\u2500\u2500 migrations/" }), _jsx("span", { children: " \u251C\u2500\u2500 20251121000000_ai_tokens.sql" }), _jsx("span", { children: " \u2514\u2500\u2500 20251121093113_module-ai_init.sql" })] }) }) })] }), _jsxs(Card, { children: [_jsx(CardHeader, { children: _jsx("h3", { className: "text-xl font-semibold", children: "\uD83D\uDDC4\uFE0F Tables de Donn\u00E9es" }) }), _jsxs(CardBody, { className: "space-y-4", children: [_jsx(TableStructure, { tableName: "user_token_ledger", title: "user_token_ledger", description: "Comptabilit\u00E9 des tokens (cr\u00E9dits, d\u00E9bits, balance). Vue user_token_balance pour le solde actuel." }), _jsx(TableStructure, { tableName: "user_prompts", title: "user_prompts", description: "Biblioth\u00E8que de prompts r\u00E9utilisables par utilisateur (titre, contenu, type)." })] })] }), _jsxs(Card, { children: [_jsx(CardHeader, { children: _jsx("h3", { className: "text-xl font-semibold", children: "\uD83D\uDCE6 Installation" }) }), _jsxs(CardBody, { className: "space-y-4", children: [_jsxs("div", { className: "flex flex-col gap-2", children: [_jsx(Snippet, { symbol: "", color: "default", size: "sm", children: "pnpm lastbrain add-module ai" }), _jsx(Snippet, { symbol: "", color: "default", size: "sm", children: "pnpm build:modules" }), _jsx(Snippet, { symbol: "", color: "default", size: "sm", children: "supabase migration up" })] }), _jsxs("div", { className: "border-2 border-danger rounded-lg p-4 mt-6", children: [_jsx("h4", { className: "text-lg font-semibold text-danger mb-3", children: "\u26A0\uFE0F Danger Zone" }), _jsx("p", { className: "text-sm text-slate-600 dark:text-slate-400 mb-3", children: "La suppression du module supprimera toutes les pages, routes API et migrations associ\u00E9es. Cette action est irr\u00E9versible." }), _jsxs("div", { className: "flex flex-col gap-2", children: [_jsx(Snippet, { symbol: "", color: "danger", size: "sm", children: "pnpm lastbrain remove-module ai" }), _jsx(Snippet, { symbol: "", color: "danger", size: "sm", children: "pnpm build:modules" })] })] })] })] }), _jsxs(Card, { children: [_jsx(CardHeader, { children: _jsx("h3", { className: "text-xl font-semibold", children: "\u2699\uFE0F Configuration" }) }), _jsxs(CardBody, { className: "space-y-3", children: [_jsx("p", { className: "text-sm text-slate-600 dark:text-slate-400", children: "Ajoutez votre cl\u00E9 API OpenAI dans vos variables d'environnement :" }), _jsx(Snippet, { symbol: "", color: "default", size: "sm", children: "OPENAI_API_KEY=sk-..." })] })] }), _jsxs(Card, { children: [_jsx(CardHeader, { children: _jsx("h3", { className: "text-xl font-semibold", children: "\uD83D\uDCB0 Syst\u00E8me de Tokens" }) }), _jsxs(CardBody, { className: "space-y-3", children: [_jsxs("div", { children: [_jsx("h4", { className: "font-semibold mb-2", children: "Co\u00FBts" }), _jsxs("ul", { className: "text-sm text-slate-600 dark:text-slate-400 space-y-1", children: [_jsx("li", { children: "\u2022 G\u00E9n\u00E9ration de texte : 10 tokens" }), _jsx("li", { children: "\u2022 G\u00E9n\u00E9ration d'image : 50 tokens" })] })] }), _jsxs("div", { children: [_jsx("h4", { className: "font-semibold mb-2 mt-4", children: "Trigger de validation" }), _jsx("p", { className: "text-sm text-slate-600 dark:text-slate-400", children: "Un trigger emp\u00EAche les transactions si le solde devient n\u00E9gatif." })] }), _jsxs("div", { children: [_jsx("h4", { className: "font-semibold mb-2 mt-4", children: "Ajouter des tokens" }), _jsx(Snippet, { symbol: "", color: "default", size: "sm", hideSymbol: true, children: _jsxs("div", { className: "flex flex-col gap-1", children: [_jsx("span", { children: "INSERT INTO user_token_ledger" }), _jsx("span", { children: "(user_id, amount, transaction_type, description)" }), _jsx("span", { children: "VALUES" }), _jsx("span", { children: "(\"('user-uuid', 1000, 'credit', 'Achat de tokens');\")" })] }) })] })] })] })] }));
+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 @lastbrain/module-ai
+ * Auto-generated from module-ai.build.config.ts
+ *
+ * To regenerate this file, run:
+ * pnpm update:module-docs
+ */
+export function Doc() {
+    return (_jsxs("div", { className: "container mx-auto p-6 space-y-6", children: [_jsxs(Card, { children: [_jsx(CardHeader, { children: _jsxs("div", { children: [_jsx("h1", { className: "text-3xl font-bold mb-2", children: "\uD83D\uDCE6 Module ai" }), _jsx("p", { className: "text-slate-600 dark:text-slate-400", children: "@lastbrain/module-ai" })] }) }), _jsx(CardBody, { children: _jsxs("div", { className: "grid grid-cols-1 md:grid-cols-3 gap-4", children: [_jsxs("div", { children: [_jsx("p", { className: "text-sm text-slate-600 dark:text-slate-400", children: "Package" }), _jsx("code", { className: "text-sm font-semibold", children: "@lastbrain/module-ai" })] }), _jsxs("div", { children: [_jsx("p", { className: "text-sm text-slate-600 dark:text-slate-400", children: "Slug" }), _jsx("code", { className: "text-sm font-semibold", children: "module-ai" })] }), _jsxs("div", { children: [_jsx("p", { className: "text-sm text-slate-600 dark:text-slate-400", children: "Type" }), _jsx("code", { className: "text-sm font-semibold", children: "Module LastBrain" })] })] }) })] }), _jsxs(Card, { children: [_jsx(CardHeader, { children: _jsxs("h2", { className: "text-2xl font-semibold flex items-center gap-2", children: [_jsx(FileText, { size: 24 }), "Pages Disponibles"] }) }), _jsxs(CardBody, { className: "space-y-4", children: [_jsxs("div", { children: [_jsx("h3", { className: "text-lg font-semibold mb-2", children: "Pages Prot\u00E9g\u00E9es (Auth)" }), _jsx("div", { className: "space-y-2", children: _jsxs("div", { className: "flex items-start gap-2", children: [_jsx(Chip, { size: "sm", color: "primary", variant: "flat", children: "GET" }), _jsx("code", { className: "text-sm", children: "/token" }), _jsx("span", { className: "text-sm text-slate-600 dark:text-slate-400", children: "- TokenPage" })] }) })] }), _jsxs("div", { children: [_jsx("h3", { className: "text-lg font-semibold mb-2", children: "Pages Admin" }), _jsx("div", { className: "space-y-2", children: _jsxs("div", { className: "flex items-start gap-2", children: [_jsx(Chip, { size: "sm", color: "secondary", variant: "flat", children: "GET" }), _jsx("code", { className: "text-sm", children: "/user-token" }), _jsx("span", { className: "text-sm text-slate-600 dark:text-slate-400", children: "- UserTokenPage" })] }) })] })] })] }), _jsxs(Card, { children: [_jsx(CardHeader, { children: _jsxs("h2", { className: "text-2xl font-semibold flex items-center gap-2", children: [_jsx(Zap, { size: 24 }), "API Routes"] }) }), _jsxs(CardBody, { className: "space-y-4", children: [_jsxs("div", { children: [_jsx("h3", { className: "text-lg font-semibold mb-2", children: _jsx("code", { children: "/api/auth/user_token_ledger" }) }), _jsxs("div", { className: "flex gap-2", children: [_jsx(Chip, { size: "sm", color: "success", variant: "flat", children: "GET" }), _jsx(Chip, { size: "sm", color: "primary", variant: "flat", children: "POST" }), _jsx(Chip, { size: "sm", color: "warning", variant: "flat", children: "PUT" }), _jsx(Chip, { size: "sm", color: "danger", variant: "flat", children: "DELETE" })] })] }), _jsxs("div", { children: [_jsx("h3", { className: "text-lg font-semibold mb-2", children: _jsx("code", { children: "/api/auth/user_prompts" }) }), _jsxs("div", { className: "flex gap-2", children: [_jsx(Chip, { size: "sm", color: "success", variant: "flat", children: "GET" }), _jsx(Chip, { size: "sm", color: "primary", variant: "flat", children: "POST" }), _jsx(Chip, { size: "sm", color: "warning", variant: "flat", children: "PUT" }), _jsx(Chip, { size: "sm", color: "danger", variant: "flat", children: "DELETE" })] })] })] })] }), _jsxs(Card, { children: [_jsx(CardHeader, { children: _jsxs("h2", { className: "text-2xl font-semibold flex items-center gap-2", children: [_jsx(Database, { size: 24 }), "Base de Donn\u00E9es"] }) }), _jsxs(CardBody, { className: "space-y-6", children: [_jsx(TableStructure, { tableName: "user_token_ledger", title: "user_token_ledger", description: "Table user_token_ledger du module ai" }), _jsx(TableStructure, { tableName: "user_prompts", title: "user_prompts", description: "Table user_prompts du module ai" })] })] }), _jsxs(Card, { children: [_jsx(CardHeader, { children: _jsxs("h2", { className: "text-2xl font-semibold flex items-center gap-2", children: [_jsx(Package, { size: 24 }), "Installation"] }) }), _jsxs(CardBody, { className: "space-y-4", children: [_jsxs("div", { children: [_jsx("h3", { className: "text-lg font-semibold mb-2", children: "Ajouter le module" }), _jsx(Snippet, { symbol: "", hideSymbol: true, className: "text-sm mb-2", children: "pnpm lastbrain add-module ai" }), _jsx(Snippet, { symbol: "", hideSymbol: true, className: "text-sm mb-2", children: "pnpm build:modules" })] }), _jsxs("div", { children: [_jsx("h3", { className: "text-lg font-semibold mb-2", children: "Appliquer les migrations" }), _jsx(Snippet, { symbol: "", hideSymbol: true, className: "text-sm mb-2", children: "cd apps/votre-app" }), _jsx(Snippet, { symbol: "", hideSymbol: true, className: "text-sm mb-2", children: "supabase migration up" })] })] })] }), _jsxs(Card, { children: [_jsx(CardHeader, { children: _jsxs("h2", { className: "text-2xl font-semibold flex items-center gap-2", children: [_jsx(BookOpen, { size: 24 }), "Utilisation"] }) }), _jsxs(CardBody, { className: "space-y-4", children: [_jsxs(Alert, { color: "default", className: "mb-4", children: [_jsxs("p", { className: "text-sm", children: ["\uD83D\uDCDD ", _jsx("strong", { children: "Section \u00E0 compl\u00E9ter par l'auteur du module" })] }), _jsx("p", { className: "text-sm text-slate-600 dark:text-slate-400 mt-2", children: "Ajoutez ici des exemples d'utilisation, des configurations sp\u00E9cifiques, et toute information utile pour les d\u00E9veloppeurs utilisant ce module." })] }), _jsxs("div", { children: [_jsx("h3", { className: "text-lg font-semibold mb-2", children: "Exemple d'utilisation" }), _jsx(Alert, { color: "primary", className: "p-4 mb-4", children: _jsx("pre", { className: "whitespace-pre-wrap", children: `// Importez les composants depuis le module
+import { TokenPage } from "@lastbrain/module-ai";
+
+// Utilisez-les dans votre application
+<TokenPage />` }) })] })] })] }), _jsxs(Card, { children: [_jsx(CardHeader, { children: _jsxs("h2", { className: "text-2xl font-semibold flex items-center gap-2 text-danger", children: [_jsx(AlertTriangle, { size: 24 }), "Danger Zone"] }) }), _jsxs(CardBody, { className: "space-y-4", children: [_jsxs(Alert, { color: "danger", className: "mb-4", children: [_jsx("p", { className: "text-sm font-semibold", children: "\u26A0\uFE0F Cette action est irr\u00E9versible" }), _jsx("p", { className: "text-sm mt-2", children: "La suppression du module supprimera toutes les pages, routes API et migrations associ\u00E9es." })] }), _jsxs("div", { children: [_jsx("h3", { className: "text-lg font-semibold mb-2", children: "Supprimer le module" }), _jsx(Snippet, { symbol: "", hideSymbol: true, color: "danger", className: "text-sm mb-2", children: "pnpm lastbrain remove-module ai" }), _jsx(Snippet, { symbol: "", hideSymbol: true, color: "danger", className: "text-sm mb-2", children: "pnpm build:modules" })] })] })] })] }));
 }

package/dist/index.d.ts

@@ -3,7 +3,8 @@ export { ImageGenerative } from "./web/components/ImageGenerative.js";
 export { TokenPage } from "./web/auth/TokenPage.js";
 export { UserTokenPage } from "./web/admin/UserTokenPage.js";
 export { UserTokenIdPage } from "./web/admin/UserTokenIdPage.js";
-export { AiModuleDoc } from "./components/Doc.js";
+export { Doc } from "./components/Doc.js";
+export { Doc as AiModuleDoc } from "./components/Doc.js";
 export type { GenerativeResponse, TextareaGenerativeProps, } from "./web/components/TextareaGenerative.js";
 export type { GenerativeImageResponse, ImageGenerativeProps, } from "./web/components/ImageGenerative.js";
 export { default as buildConfig } from "./ai.build.config.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAGtE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlD,YAAY,EACV,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,wCAAwC,CAAC;AAEhD,YAAY,EACV,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,qCAAqC,CAAC;AAG7C,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAGtE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,GAAG,IAAI,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGzD,YAAY,EACV,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,wCAAwC,CAAC;AAEhD,YAAY,EACV,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,qCAAqC,CAAC;AAG7C,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -7,6 +7,7 @@ export { TokenPage } from "./web/auth/TokenPage.js";
 export { UserTokenPage } from "./web/admin/UserTokenPage.js";
 export { UserTokenIdPage } from "./web/admin/UserTokenIdPage.js";
 // Documentation
-export { AiModuleDoc } from "./components/Doc.js";
+export { Doc } from "./components/Doc.js";
+export { Doc as AiModuleDoc } from "./components/Doc.js";
 // Configuration de build
 export { default as buildConfig } from "./ai.build.config.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lastbrain/module-ai",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "Module de génération IA (texte et images) avec gestion de tokens pour LastBrain",
   "private": false,
   "type": "module",
@@ -38,8 +38,8 @@
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "zod": "^3.23.8",
-    "@lastbrain/core": "0.1.9",
-    "@lastbrain/ui": "0.1.12"
+    "@lastbrain/core": "0.1.11",
+    "@lastbrain/ui": "0.1.14"
   },
   "peerDependencies": {
     "next": ">=15.0.0"