bibest-code 2.0.0

package/todo-api/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "todo-api",
+  "version": "1.0.0",
+  "description": "API REST complète pour une Todo List - by BIBEST CODE",
+  "main": "src/server.js",
+  "scripts": {
+    "start": "node src/server.js",
+    "dev": "nodemon src/server.js"
+  },
+  "keywords": ["todo", "rest", "api", "express"],
+  "author": "BIBI ONDOUA / BIBEST CODE",
+  "license": "MIT",
+  "dependencies": {
+    "express": "^4.18.2",
+    "uuid": "^9.0.0",
+    "cors": "^2.8.5",
+    "morgan": "^1.10.0"
+  },
+  "devDependencies": {
+    "nodemon": "^3.0.1"
+  }
+}

package/todo-api/src/controllers/todoController.js

@@ -0,0 +1,285 @@
+// ============================================================
+//  Contrôleur Todo — Logique métier CRUD
+//  BIBEST CODE - by BIBI ONDOUA
+// ============================================================
+
+const { v4: uuidv4 } = require("uuid");
+const { todos } = require("../data/todos");
+
+// ─────────────────────────────────────────────────────────────
+// GET /api/todos
+// Récupère tous les todos avec filtres, tri et pagination
+// ─────────────────────────────────────────────────────────────
+const getAllTodos = (req, res) => {
+  let result = [...todos];
+
+  const { completed, priority, search, sort, order, page, limit } = req.query;
+
+  // --- Filtres ---
+  if (completed !== undefined) {
+    const isCompleted = completed === "true";
+    result = result.filter((t) => t.completed === isCompleted);
+  }
+
+  if (priority) {
+    result = result.filter((t) => t.priority === priority);
+  }
+
+  if (search) {
+    const term = search.toLowerCase();
+    result = result.filter(
+      (t) =>
+        t.title.toLowerCase().includes(term) ||
+        (t.description && t.description.toLowerCase().includes(term))
+    );
+  }
+
+  // --- Tri ---
+  const validSortFields = ["createdAt", "updatedAt", "title", "priority"];
+  const sortField = validSortFields.includes(sort) ? sort : "createdAt";
+  const sortOrder = order === "asc" ? 1 : -1;
+
+  result.sort((a, b) => {
+    if (a[sortField] < b[sortField]) return -1 * sortOrder;
+    if (a[sortField] > b[sortField]) return 1 * sortOrder;
+    return 0;
+  });
+
+  // --- Statistiques avant pagination ---
+  const total = result.length;
+  const totalCompleted = result.filter((t) => t.completed).length;
+  const totalPending = total - totalCompleted;
+
+  // --- Pagination ---
+  const pageNum = parseInt(page) || 1;
+  const limitNum = parseInt(limit) || 10;
+  const startIndex = (pageNum - 1) * limitNum;
+  const endIndex = startIndex + limitNum;
+  const paginated = result.slice(startIndex, endIndex);
+
+  res.status(200).json({
+    success: true,
+    message: "Todos récupérés avec succès.",
+    stats: {
+      total,
+      completed: totalCompleted,
+      pending: totalPending,
+    },
+    pagination: {
+      currentPage: pageNum,
+      totalPages: Math.ceil(total / limitNum),
+      limit: limitNum,
+      hasNextPage: endIndex < total,
+      hasPrevPage: pageNum > 1,
+    },
+    data: paginated,
+  });
+};
+
+// ─────────────────────────────────────────────────────────────
+// GET /api/todos/:id
+// Récupère un todo par son ID
+// ─────────────────────────────────────────────────────────────
+const getTodoById = (req, res) => {
+  const { id } = req.params;
+  const todo = todos.find((t) => t.id === id);
+
+  if (!todo) {
+    return res.status(404).json({
+      success: false,
+      message: `Aucun todo trouvé avec l'ID : ${id}`,
+    });
+  }
+
+  res.status(200).json({
+    success: true,
+    message: "Todo récupéré avec succès.",
+    data: todo,
+  });
+};
+
+// ─────────────────────────────────────────────────────────────
+// POST /api/todos
+// Crée un nouveau todo
+// ─────────────────────────────────────────────────────────────
+const createTodo = (req, res) => {
+  const { title, description = "", priority = "medium" } = req.body;
+
+  const newTodo = {
+    id: uuidv4(),
+    title: title.trim(),
+    description: description.trim(),
+    completed: false,
+    priority,
+    createdAt: new Date(),
+    updatedAt: new Date(),
+  };
+
+  todos.push(newTodo);
+
+  res.status(201).json({
+    success: true,
+    message: "Todo créé avec succès.",
+    data: newTodo,
+  });
+};
+
+// ─────────────────────────────────────────────────────────────
+// PUT /api/todos/:id
+// Remplace complètement un todo (tous les champs)
+// ─────────────────────────────────────────────────────────────
+const replaceTodo = (req, res) => {
+  const { id } = req.params;
+  const index = todos.findIndex((t) => t.id === id);
+
+  if (index === -1) {
+    return res.status(404).json({
+      success: false,
+      message: `Aucun todo trouvé avec l'ID : ${id}`,
+    });
+  }
+
+  const { title, description = "", completed = false, priority = "medium" } = req.body;
+
+  if (!title || title.trim() === "") {
+    return res.status(400).json({
+      success: false,
+      message: "Le champ 'title' est requis pour un remplacement complet (PUT).",
+    });
+  }
+
+  const replaced = {
+    id,
+    title: title.trim(),
+    description: description.trim(),
+    completed: Boolean(completed),
+    priority,
+    createdAt: todos[index].createdAt,
+    updatedAt: new Date(),
+  };
+
+  todos[index] = replaced;
+
+  res.status(200).json({
+    success: true,
+    message: "Todo remplacé avec succès.",
+    data: replaced,
+  });
+};
+
+// ─────────────────────────────────────────────────────────────
+// PATCH /api/todos/:id
+// Met à jour partiellement un todo
+// ─────────────────────────────────────────────────────────────
+const updateTodo = (req, res) => {
+  const { id } = req.params;
+  const index = todos.findIndex((t) => t.id === id);
+
+  if (index === -1) {
+    return res.status(404).json({
+      success: false,
+      message: `Aucun todo trouvé avec l'ID : ${id}`,
+    });
+  }
+
+  const { title, description, completed, priority } = req.body;
+  const current = todos[index];
+
+  const updated = {
+    ...current,
+    ...(title !== undefined && { title: title.trim() }),
+    ...(description !== undefined && { description: description.trim() }),
+    ...(completed !== undefined && { completed }),
+    ...(priority !== undefined && { priority }),
+    updatedAt: new Date(),
+  };
+
+  todos[index] = updated;
+
+  res.status(200).json({
+    success: true,
+    message: "Todo mis à jour avec succès.",
+    data: updated,
+  });
+};
+
+// ─────────────────────────────────────────────────────────────
+// PATCH /api/todos/:id/toggle
+// Bascule le statut completed d'un todo
+// ─────────────────────────────────────────────────────────────
+const toggleTodo = (req, res) => {
+  const { id } = req.params;
+  const index = todos.findIndex((t) => t.id === id);
+
+  if (index === -1) {
+    return res.status(404).json({
+      success: false,
+      message: `Aucun todo trouvé avec l'ID : ${id}`,
+    });
+  }
+
+  todos[index].completed = !todos[index].completed;
+  todos[index].updatedAt = new Date();
+
+  res.status(200).json({
+    success: true,
+    message: `Todo marqué comme ${todos[index].completed ? "✅ complété" : "⏳ en attente"}.`,
+    data: todos[index],
+  });
+};
+
+// ─────────────────────────────────────────────────────────────
+// DELETE /api/todos/:id
+// Supprime un todo par son ID
+// ─────────────────────────────────────────────────────────────
+const deleteTodo = (req, res) => {
+  const { id } = req.params;
+  const index = todos.findIndex((t) => t.id === id);
+
+  if (index === -1) {
+    return res.status(404).json({
+      success: false,
+      message: `Aucun todo trouvé avec l'ID : ${id}`,
+    });
+  }
+
+  const deleted = todos.splice(index, 1)[0];
+
+  res.status(200).json({
+    success: true,
+    message: "Todo supprimé avec succès.",
+    data: deleted,
+  });
+};
+
+// ─────────────────────────────────────────────────────────────
+// DELETE /api/todos
+// Supprime tous les todos complétés
+// ─────────────────────────────────────────────────────────────
+const deleteCompletedTodos = (req, res) => {
+  const before = todos.length;
+  const removed = todos.filter((t) => t.completed);
+
+  // Mutation du tableau partagé
+  todos.splice(0, todos.length, ...todos.filter((t) => !t.completed));
+
+  const after = todos.length;
+
+  res.status(200).json({
+    success: true,
+    message: `${before - after} todo(s) complété(s) supprimé(s).`,
+    deletedCount: before - after,
+    deletedItems: removed,
+  });
+};
+
+module.exports = {
+  getAllTodos,
+  getTodoById,
+  createTodo,
+  replaceTodo,
+  updateTodo,
+  toggleTodo,
+  deleteTodo,
+  deleteCompletedTodos,
+};

package/todo-api/src/data/todos.js

@@ -0,0 +1,39 @@
+// ============================================================
+//  Stockage en mémoire (remplaçable par une vraie BDD)
+//  BIBEST CODE - by BIBI ONDOUA
+// ============================================================
+
+const { v4: uuidv4 } = require("uuid");
+
+// Données initiales de démonstration
+let todos = [
+  {
+    id: uuidv4(),
+    title: "Apprendre Express.js",
+    description: "Maîtriser la création d'API REST avec Express",
+    completed: true,
+    priority: "high",
+    createdAt: new Date("2024-01-10T08:00:00.000Z"),
+    updatedAt: new Date("2024-01-12T10:30:00.000Z"),
+  },
+  {
+    id: uuidv4(),
+    title: "Créer une API Todo List",
+    description: "Implémenter toutes les routes CRUD",
+    completed: false,
+    priority: "high",
+    createdAt: new Date("2024-01-15T09:00:00.000Z"),
+    updatedAt: new Date("2024-01-15T09:00:00.000Z"),
+  },
+  {
+    id: uuidv4(),
+    title: "Écrire la documentation",
+    description: "Documenter toutes les routes de l'API",
+    completed: false,
+    priority: "medium",
+    createdAt: new Date("2024-01-16T11:00:00.000Z"),
+    updatedAt: new Date("2024-01-16T11:00:00.000Z"),
+  },
+];
+
+module.exports = { todos };

package/todo-api/src/middlewares/errorHandler.js

@@ -0,0 +1,27 @@
+// ============================================================
+//  Middleware de gestion globale des erreurs
+//  BIBEST CODE - by BIBI ONDOUA
+// ============================================================
+
+// Gestion des routes inexistantes (404)
+const notFound = (req, res, next) => {
+  res.status(404).json({
+    success: false,
+    message: `Route introuvable : ${req.method} ${req.originalUrl}`,
+  });
+};
+
+// Gestionnaire d'erreurs global (500)
+const errorHandler = (err, req, res, next) => {
+  console.error("❌ Erreur serveur :", err.stack);
+
+  const statusCode = err.statusCode || 500;
+
+  res.status(statusCode).json({
+    success: false,
+    message: err.message || "Erreur interne du serveur.",
+    ...(process.env.NODE_ENV === "development" && { stack: err.stack }),
+  });
+};
+
+module.exports = { notFound, errorHandler };

package/todo-api/src/middlewares/validate.js

@@ -0,0 +1,92 @@
+// ============================================================
+//  Middlewares de validation
+//  BIBEST CODE - by BIBI ONDOUA
+// ============================================================
+
+const VALID_PRIORITIES = ["low", "medium", "high"];
+
+// Valide le body lors de la création d'un todo
+const validateCreate = (req, res, next) => {
+  const { title, description, priority } = req.body;
+
+  const errors = [];
+
+  if (!title || typeof title !== "string" || title.trim() === "") {
+    errors.push("Le champ 'title' est requis et doit être une chaîne non vide.");
+  } else if (title.trim().length > 100) {
+    errors.push("Le champ 'title' ne doit pas dépasser 100 caractères.");
+  }
+
+  if (description !== undefined) {
+    if (typeof description !== "string") {
+      errors.push("Le champ 'description' doit être une chaîne de caractères.");
+    } else if (description.length > 500) {
+      errors.push("Le champ 'description' ne doit pas dépasser 500 caractères.");
+    }
+  }
+
+  if (priority !== undefined && !VALID_PRIORITIES.includes(priority)) {
+    errors.push(`Le champ 'priority' doit être l'une des valeurs : ${VALID_PRIORITIES.join(", ")}.`);
+  }
+
+  if (errors.length > 0) {
+    return res.status(400).json({
+      success: false,
+      message: "Données invalides.",
+      errors,
+    });
+  }
+
+  next();
+};
+
+// Valide le body lors de la mise à jour d'un todo
+const validateUpdate = (req, res, next) => {
+  const { title, description, completed, priority } = req.body;
+
+  const errors = [];
+
+  if (Object.keys(req.body).length === 0) {
+    return res.status(400).json({
+      success: false,
+      message: "Le corps de la requête ne peut pas être vide.",
+      errors: ["Fournissez au moins un champ à mettre à jour : title, description, completed, priority."],
+    });
+  }
+
+  if (title !== undefined) {
+    if (typeof title !== "string" || title.trim() === "") {
+      errors.push("Le champ 'title' doit être une chaîne non vide.");
+    } else if (title.trim().length > 100) {
+      errors.push("Le champ 'title' ne doit pas dépasser 100 caractères.");
+    }
+  }
+
+  if (description !== undefined) {
+    if (typeof description !== "string") {
+      errors.push("Le champ 'description' doit être une chaîne de caractères.");
+    } else if (description.length > 500) {
+      errors.push("Le champ 'description' ne doit pas dépasser 500 caractères.");
+    }
+  }
+
+  if (completed !== undefined && typeof completed !== "boolean") {
+    errors.push("Le champ 'completed' doit être un booléen (true ou false).");
+  }
+
+  if (priority !== undefined && !VALID_PRIORITIES.includes(priority)) {
+    errors.push(`Le champ 'priority' doit être l'une des valeurs : ${VALID_PRIORITIES.join(", ")}.`);
+  }
+
+  if (errors.length > 0) {
+    return res.status(400).json({
+      success: false,
+      message: "Données invalides.",
+      errors,
+    });
+  }
+
+  next();
+};
+
+module.exports = { validateCreate, validateUpdate };

package/todo-api/src/routes/todoRoutes.js

@@ -0,0 +1,53 @@
+// ============================================================
+//  Routes Todo — API REST
+//  BIBEST CODE - by BIBI ONDOUA
+// ============================================================
+
+const express = require("express");
+const router = express.Router();
+
+const {
+  getAllTodos,
+  getTodoById,
+  createTodo,
+  replaceTodo,
+  updateTodo,
+  toggleTodo,
+  deleteTodo,
+  deleteCompletedTodos,
+} = require("../controllers/todoController");
+
+const { validateCreate, validateUpdate } = require("../middlewares/validate");
+
+// ─────────────────────────────────────────────────────────────
+//  Routes de collection  →  /api/todos
+// ─────────────────────────────────────────────────────────────
+
+// GET    /api/todos             → Lister tous les todos (filtres + pagination)
+// POST   /api/todos             → Créer un nouveau todo
+// DELETE /api/todos             → Supprimer tous les todos complétés
+router.get("/",    getAllTodos);
+router.post("/",   validateCreate, createTodo);
+router.delete("/", deleteCompletedTodos);
+
+// ─────────────────────────────────────────────────────────────
+//  Routes de ressource individuelle  →  /api/todos/:id
+// ─────────────────────────────────────────────────────────────
+
+// GET    /api/todos/:id         → Récupérer un todo
+// PUT    /api/todos/:id         → Remplacer complètement un todo
+// PATCH  /api/todos/:id         → Mettre à jour partiellement un todo
+// DELETE /api/todos/:id         → Supprimer un todo
+router.get("/:id",    getTodoById);
+router.put("/:id",    validateCreate, replaceTodo);
+router.patch("/:id",  validateUpdate, updateTodo);
+router.delete("/:id", deleteTodo);
+
+// ─────────────────────────────────────────────────────────────
+//  Route spéciale → Basculer le statut completed
+// ─────────────────────────────────────────────────────────────
+
+// PATCH  /api/todos/:id/toggle  → Toggle completed
+router.patch("/:id/toggle", toggleTodo);
+
+module.exports = router;

package/todo-api/src/server.js

@@ -0,0 +1,86 @@
+// ============================================================
+//  Serveur principal — Todo API REST
+//  BIBEST CODE - by BIBI ONDOUA
+// ============================================================
+
+const express = require("express");
+const cors    = require("cors");
+const morgan  = require("morgan");
+
+const todoRoutes           = require("./routes/todoRoutes");
+const { notFound, errorHandler } = require("./middlewares/errorHandler");
+
+const app  = express();
+const PORT = process.env.PORT || 3000;
+
+// ─────────────────────────────────────────────────────────────
+//  Middlewares globaux
+// ─────────────────────────────────────────────────────────────
+app.use(cors());                        // Autorise les requêtes cross-origin
+app.use(express.json());                // Parse le body JSON
+app.use(express.urlencoded({ extended: true })); // Parse les form-data
+app.use(morgan("dev"));                 // Logs HTTP colorés
+
+// ─────────────────────────────────────────────────────────────
+//  Route d'accueil / health-check
+// ─────────────────────────────────────────────────────────────
+app.get("/", (req, res) => {
+  res.status(200).json({
+    success: true,
+    name: "Todo List REST API",
+    version: "1.0.0",
+    author: "BIBI ONDOUA — BIBEST CODE",
+    description: "API REST complète avec routes CRUD pour une Todo List",
+    endpoints: {
+      base: "/api/todos",
+      routes: [
+        { method: "GET",    path: "/api/todos",              description: "Lister tous les todos (filtres + pagination)" },
+        { method: "GET",    path: "/api/todos/:id",          description: "Récupérer un todo par ID" },
+        { method: "POST",   path: "/api/todos",              description: "Créer un nouveau todo" },
+        { method: "PUT",    path: "/api/todos/:id",          description: "Remplacer complètement un todo" },
+        { method: "PATCH",  path: "/api/todos/:id",          description: "Mettre à jour partiellement un todo" },
+        { method: "PATCH",  path: "/api/todos/:id/toggle",   description: "Basculer le statut completed" },
+        { method: "DELETE", path: "/api/todos/:id",          description: "Supprimer un todo" },
+        { method: "DELETE", path: "/api/todos",              description: "Supprimer tous les todos complétés" },
+      ],
+      queryParams: {
+        completed: "true | false",
+        priority:  "low | medium | high",
+        search:    "texte libre (titre/description)",
+        sort:      "createdAt | updatedAt | title | priority",
+        order:     "asc | desc (défaut: desc)",
+        page:      "numéro de page (défaut: 1)",
+        limit:     "items par page (défaut: 10)",
+      },
+    },
+  });
+});
+
+// ─────────────────────────────────────────────────────────────
+//  Montage des routes
+// ─────────────────────────────────────────────────────────────
+app.use("/api/todos", todoRoutes);
+
+// ─────────────────────────────────────────────────────────────
+//  Gestion des erreurs (toujours en dernier)
+// ─────────────────────────────────────────────────────────────
+app.use(notFound);
+app.use(errorHandler);
+
+// ─────────────────────────────────────────────────────────────
+//  Démarrage du serveur
+// ─────────────────────────────────────────────────────────────
+app.listen(PORT, () => {
+  console.log("");
+  console.log("╔══════════════════════════════════════════════╗");
+  console.log("║       🚀  Todo List REST API  🚀             ║");
+  console.log("║         BIBEST CODE — BIBI ONDOUA            ║");
+  console.log("╠══════════════════════════════════════════════╣");
+  console.log(`║  ✅  Serveur démarré sur le port ${PORT}         ║`);
+  console.log(`║  🌐  http://localhost:${PORT}                   ║`);
+  console.log(`║  📦  Base URL : http://localhost:${PORT}/api/todos ║`);
+  console.log("╚══════════════════════════════════════════════╝");
+  console.log("");
+});
+
+module.exports = app;