nestcraftx 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -2,11 +2,12 @@
 
 All notable changes to NestCraftX will be documented in this file.
 
-## [0.2.1] - 2025-11-07
+## [0.2.2] - 2025-11-07
 
 ### Added
 
 #### Demo Command Amélioré
+
 - Support complet des flags pour demo : `--light`, `--orm`, `--auth`, `--swagger`, `--docker`
 - Mode interactif intelligent : pose les questions uniquement si flags manquants
 - Fusion intelligente des options passées et réponses interactives
@@ -14,6 +15,7 @@ All notable changes to NestCraftX will be documented in this file.
 - Support de tous les ORMs (Prisma, TypeORM, Mongoose)
 
 #### Auth Refactorisée
+
 - AuthService refactorisé pour passer via UserService
 - Pas d'accès direct au repository depuis AuthModule
 - JWT configuré avec ConfigService pour secrets dynamiques
@@ -23,12 +25,14 @@ All notable changes to NestCraftX will be documented in this file.
 - Support du role-based access control (RBAC)
 
 #### Templates Professionnels
+
 - `.gitignore` complet généré pour NestJS
 - `README.md` auto-généré pour chaque projet créé
 - Git auto-initialisé avec premier commit
 - Documentation professionnelle incluse
 
 #### Nettoyage du Code
+
 - Suppression de fichiers obsolètes (start.js, fullModeInput.js, lightModeInput.js)
 - Normalisation CommonJS vs ES6 (cohérence totale)
 - Suppression du code mort et commentaires inutiles
@@ -36,7 +40,7 @@ All notable changes to NestCraftX will be documented in this file.
 
 ### Changed
 
-- Version du projet mise à jour à 0.2.1
+- Version du projet mise à jour à 0.2.2
 - Documentation README complètement mise à jour
 - CLI_USAGE.md actualisé avec les nouveau flags
 - Meilleure séparation des responsabilités (Auth ↔ User)
@@ -54,7 +58,9 @@ All notable changes to NestCraftX will be documented in this file.
 ### Added
 
 #### Architecture Modes
+
 - **Mode FULL** : Architecture complete avec Clean Architecture + DDD
+
   - Structure complete avec use-cases, mappers, adapters
   - Separation stricte domain/application/infrastructure/presentation
   - Ideal pour projets complexes et scalables
@@ -65,7 +71,9 @@ All notable changes to NestCraftX will be documented in this file.
   - Parfait pour prototypes et petits projets
 
 #### CLI Moderne
+
 - Parser de flags ameliore avec validation
+
   - Support de `--flag=value` et `--flag value`
   - Validation des noms de projets
   - Validation des valeurs d'options
@@ -80,6 +88,7 @@ All notable changes to NestCraftX will be documented in this file.
   - `--docker` : Gestion Docker (actif par defaut)
 
 #### Generation .env Securisee
+
 - Generation automatique de secrets JWT securises (64 caracteres)
 - Configuration automatique selon l'ORM :
   - PostgreSQL pour Prisma et TypeORM
@@ -93,6 +102,7 @@ All notable changes to NestCraftX will be documented in this file.
 - Creation d'un fichier `.env.example` sanitise
 
 #### UX Amelioree
+
 - Systeme de couleurs pour les logs :
   - Info en cyan
   - Success en vert
@@ -104,6 +114,7 @@ All notable changes to NestCraftX will be documented in this file.
 - Affichage du mode utilise (FULL/LIGHT)
 
 #### Nouveaux Fichiers Utilitaires
+
 - `utils/cliParser.js` : Parser CLI moderne avec validation
 - `utils/envGenerator.js` : Generateur de fichiers .env securises
 - `utils/colors.js` : Systeme de couleurs pour la console
@@ -113,7 +124,9 @@ All notable changes to NestCraftX will be documented in this file.
 ### Changed
 
 #### Structure du Code
+
 - Refactoring complet de `commands/new.js` :
+
   - Separation en fonctions modulaires
   - `determineMode()` : Detection du mode
   - `buildLightModeInputs()` : Construction config LIGHT
@@ -122,6 +135,7 @@ All notable changes to NestCraftX will be documented in this file.
   - `printSuccessSummary()` : Affichage resume
 
 - Amelioration de `utils/shell.js` :
+
   - Support des spinners
   - Mode silencieux pour certaines operations
   - Meilleure gestion des erreurs
@@ -132,6 +146,7 @@ All notable changes to NestCraftX will be documented in this file.
   - Messages plus clairs
 
 #### Parser CLI
+
 - Validation des inputs en temps reel
 - Detection des flags mutuellement exclusifs
 - Support de la syntaxe moderne (--key=value)
@@ -140,29 +155,34 @@ All notable changes to NestCraftX will be documented in this file.
 ### Improved
 
 #### Generation de Projet
+
 - Detection automatique du mode selon les flags
 - Configuration interactive seulement si necessaire
 - Validation des noms de projets
 - Meilleure gestion des erreurs
 
 #### Configuration Database
+
 - URL de database construite automatiquement
 - Support ameliore pour les 3 ORMs
 - Configuration adaptee au type de database
 
 #### Documentation
+
 - Ajout de `CLI_USAGE.md` : Guide complet d'utilisation
 - Ajout de `CHANGELOG.md` : Historique des versions
 - Exemples de commandes detailles
 - Documentation des deux modes d'architecture
 
 ### Fixed
+
 - Gestion des erreurs amelioree dans tout le CLI
 - Validation des options avant execution
 - Messages d'erreur plus explicites
 - Nettoyage du code (suppression des commentaires obsoletes)
 
 ### Security
+
 - Generation de secrets JWT securises avec crypto
 - Secrets de 64 caracteres en base64url
 - Fichier .env.example sans secrets sensibles
@@ -171,6 +191,7 @@ All notable changes to NestCraftX will be documented in this file.
 ## [0.1.0] - Previous Version
 
 ### Features Initiales
+
 - Generation de projets NestJS
 - Support Prisma, TypeORM, Mongoose
 - Architecture Clean Code de base
@@ -189,12 +210,14 @@ All notable changes to NestCraftX will be documented in this file.
 **Nouvelles commandes recommandees :**
 
 Avant (0.1.x) :
+
 ```bash
 nestcraftx start
 # Configuration interactive
 ```
 
 Maintenant (0.2.0) :
+
 ```bash
 # Mode LIGHT (nouveau - recommande pour MVP)
 nestcraftx new mon-projet --light --orm=prisma --auth
@@ -204,6 +227,7 @@ nestcraftx new mon-projet --full --orm=prisma --auth
 ```
 
 **Avantages de la mise a jour :**
+
 - Generation de secrets JWT automatique et securisee
 - Fichier .env pret a l'emploi
 - Mode LIGHT pour demarrer plus rapidement

package/CORRECTIONS_APPLIED.md

@@ -11,17 +11,21 @@ Ce document récapitule toutes les corrections apportées au CLI NestCraftX pour
 **Problème:** Le mode light ne demandait pas les relations entre entités.
 
 **Solution:**
+
 - Ajout d'une fonction `addRelations()` pour gérer les relations entre entités
 - Ajout d'un prompt pour demander si l'utilisateur veut créer des relations
 - Les relations supportées: 1-1, 1-n, n-1, n-n
 
 **Code ajouté:**
+
 ```javascript
 // Demander les relations entre entités
 if (inputs.entitiesData.entities.length > 1) {
-  const wantsRelation = readline.keyInYNStrict('Voulez-vous ajouter des relations entre entites ?');
+  const wantsRelation = readline.keyInYNStrict(
+    "Voulez-vous ajouter des relations entre entites ?"
+  );
   if (wantsRelation) {
-    console.log(`\n${info('[INFO]')} Configuration des relations`);
+    console.log(`\n${info("[INFO]")} Configuration des relations`);
     addRelations(inputs.entitiesData);
   }
 }
@@ -34,11 +38,13 @@ if (inputs.entitiesData.entities.length > 1) {
 **Problème:** Les repositories ne mappaient pas les données brutes de la base de données vers les entités, causant des erreurs lors du retour des données.
 
 **Solution:**
+
 - Ajout d'une méthode privée `toEntity()` dans chaque repository pour convertir les données brutes
 - Implémentation complète pour Prisma, TypeORM et Mongoose
 - Utilisation de cette méthode dans toutes les opérations CRUD
 
 **Exemple pour Prisma:**
+
 ```typescript
 private toEntity(raw: any): ${entityName}Entity {
   return new ${entityName}Entity(
@@ -51,6 +57,7 @@ private toEntity(raw: any): ${entityName}Entity {
 ```
 
 **Exemple pour Mongoose:**
+
 ```typescript
 private toEntity(raw: any): ${entityName}Entity {
   const obj = raw.toObject ? raw.toObject() : raw;
@@ -70,6 +77,7 @@ private toEntity(raw: any): ${entityName}Entity {
 **Problème:** Les repositories pour TypeORM et Mongoose n'étaient pas complètement implémentés en mode light, seul Prisma était géré.
 
 **Solution:**
+
 - Implémentation complète du repository TypeORM avec toutes les opérations CRUD
 - Implémentation complète du repository Mongoose avec toutes les opérations CRUD
 - Ajout des imports nécessaires pour chaque ORM
@@ -82,6 +90,7 @@ private toEntity(raw: any): ${entityName}Entity {
 **Statut:** Le fichier existait déjà et était correctement configuré.
 
 **Contenu:**
+
 - Installation des dépendances TypeORM
 - Configuration de la connexion PostgreSQL
 - Génération des entités TypeORM
@@ -94,6 +103,7 @@ private toEntity(raw: any): ${entityName}Entity {
 **Problème:** Le module d'authentification était conçu uniquement pour le mode Full avec Clean Architecture, causant des erreurs d'import en mode Light.
 
 **Solution:**
+
 - Détection automatique du mode (full ou light) via `inputs.mode`
 - Chemins d'imports dynamiques selon le mode:
   - Mode Light: `src/user/dto/`, `src/user/repositories/`, `src/user/entities/`
@@ -103,9 +113,13 @@ private toEntity(raw: any): ${entityName}Entity {
   - Mode Full: injection via interface avec `@Inject('IUserRepository')`
 
 **Exemple de code adaptatif:**
+
 ```javascript
-const userDtoPath = mode === 'light' ? 'src/user/dto/user.dto' : 'src/user/application/dtos/user.dto';
-const userRepoType = mode === 'light' ? 'UserRepository' : 'IUserRepository';
+const userDtoPath =
+  mode === "light"
+    ? "src/user/dto/user.dto"
+    : "src/user/application/dtos/user.dto";
+const userRepoType = mode === "light" ? "UserRepository" : "IUserRepository";
 ```
 
 ## 6. Import dotenv dans Prisma Config
@@ -115,6 +129,7 @@ const userRepoType = mode === 'light' ? 'UserRepository' : 'IUserRepository';
 **Problème:** La nouvelle version de Prisma génère un fichier `prisma.config.ts` qui doit charger les variables d'environnement avant l'exécution, sinon les migrations échouent.
 
 **Solution:**
+
 - Installation automatique de dotenv comme dépendance
 - Détection de l'existence du fichier `prisma.config.ts`
 - Injection automatique de `import 'dotenv/config';` au début du fichier si il existe
@@ -127,16 +142,18 @@ const userRepoType = mode === 'light' ? 'UserRepository' : 'IUserRepository';
 **Problème:** L'enum Role n'était pas généré en mode light, mais était importé et utilisé dans les guards et le module d'authentification.
 
 **Solution:**
+
 - Création du dossier `src/common/enums`
 - Génération automatique du fichier `role.enum.ts` si l'entité User existe
 - Import cohérent du Role enum dans tous les fichiers qui en ont besoin
 
 **Fichier généré:**
+
 ```typescript
 export enum Role {
-  USER = 'USER',
-  ADMIN = 'ADMIN',
-  SUPER_ADMIN = 'SUPER_ADMIN',
+  USER = "USER",
+  ADMIN = "ADMIN",
+  SUPER_ADMIN = "SUPER_ADMIN",
 }
 ```
 
@@ -147,6 +164,7 @@ export enum Role {
 **Problème:** Les imports dans le module Auth restaient en mode "full" même en mode light, causant des chemins incorrects.
 
 **Solution:**
+
 - Adaptation dynamique des chemins d'imports selon le mode
 - Mode Light: `src/user/dto/`, `src/user/repositories/`, `src/auth/dto/`
 - Mode Full: `src/user/application/dtos/`, `src/user/application/interfaces/`
@@ -159,11 +177,13 @@ export enum Role {
 **Problème:** La méthode `toEntity` utilisait un spread operator générique qui ne mappait pas correctement les champs réels de l'entité.
 
 **Solution:**
+
 - Génération dynamique de la méthode `toEntity` basée sur les champs réels de l'entité
 - Chaque champ défini est explicitement mappé vers le constructeur
 - Support complet pour Prisma, TypeORM et Mongoose
 
 **Exemple pour Prisma:**
+
 ```typescript
 private toEntity(raw: any): UserEntity {
   return new UserEntity(
@@ -184,6 +204,7 @@ private toEntity(raw: any): UserEntity {
 **Problème:** L'import Swagger était dupliqué dans les controllers générés.
 
 **Solution:**
+
 - Refactorisation du code de génération du controller
 - Import Swagger déclaré une seule fois au début du fichier
 - Condition unique pour les importations et les décorateurs
@@ -195,26 +216,28 @@ private toEntity(raw: any): UserEntity {
 **Problème:** Les exemples Swagger étaient trop génériques et peu réalistes pour l'UX.
 
 **Solution Implémentée:**
+
 - Exemples réalistes basés sur les noms de champs
 - Patterns reconnaissables pour l'utilisateur final
 - Données cohérentes avec les cas d'usage réels
 
 **Exemples de Patterns d'Amélioration:**
 
-| Champ | Ancien Exemple | Nouvel Exemple |
-|-------|---|---|
-| email | user@example.com | alice.johnson@example.com |
-| password | StrongPassword123! | SecurePass@2024 |
-| firstName | firstName_example | John |
-| phone | phone_example | +1234567890 |
-| price | 199.99 | 99.99 |
-| quantity | 123 | 5 |
-| rating | 123 | 4.5 |
-| date | 2024-01-01T00:00:00Z | 2024-12-01T10:30:00Z |
+| Champ     | Ancien Exemple       | Nouvel Exemple            |
+| --------- | -------------------- | ------------------------- |
+| email     | user@example.com     | alice.johnson@example.com |
+| password  | StrongPassword123!   | SecurePass@2024           |
+| firstName | firstName_example    | John                      |
+| phone     | phone_example        | +1234567890               |
+| price     | 199.99               | 99.99                     |
+| quantity  | 123                  | 5                         |
+| rating    | 123                  | 4.5                       |
+| date      | 2024-01-01T00:00:00Z | 2024-12-01T10:30:00Z      |
 
 ## Tests de Validation
 
 Tous les fichiers modifiés ont été validés avec `node --check`:
+
 - ✅ `utils/configs/setupLightArchitecture.js`
 - ✅ `utils/lightModeInput.js`
 - ✅ `utils/setups/setupAuth.js`
@@ -258,6 +281,6 @@ Toutes les corrections ciblent des problèmes réels du mode Light identifiés l
 
 ## Version
 
-- Version du CLI: 0.2.1
+- Version du CLI: 0.2.2
 - Date des corrections: 2025-10-31
 - Toutes les corrections ont été validées syntaxiquement

package/DEMO.md

@@ -1,4 +1,4 @@
-# NestCraftX CLI - Démo du projet `blog-demo` (v0.2.1)
+# NestCraftX CLI - Démo du projet `blog-demo` (v0.2.2)
 
 ## 🎯 Objectif
 
@@ -159,5 +159,5 @@ npm run start:dev
 
 ---
 
-**NestCraftX v0.2.1** – Clean Architecture Generator for NestJS
+**NestCraftX v0.2.2** – Clean Architecture Generator for NestJS
 [Documentation complète](https://github.com/august-dev-pro/NestCraftX)

package/QUICK_START.md

@@ -149,4 +149,4 @@ Le CLI genere automatiquement :
 
 ---
 
-**NestCraftX v0.2.1** - Clean Architecture Made Simple
+**NestCraftX v0.2.2** - Clean Architecture Made Simple

package/commands/help.js

@@ -2,7 +2,7 @@ async function helpCommand() {
   console.log(`
   ╔═══════════════════════════════════════════════════════════╗
   ║                                                           ║
-  ║             🌟 NestCraftX CLI v0.2.1-beta 🌟             ║
+  ║              🌟 NestCraftX CLI v0.2.2 🌟                  ║
   ║          Clean Architecture Generator for NestJS          ║
   ║                                                           ║
   ╚═══════════════════════════════════════════════════════════╝

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nestcraftx",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Modern CLI to generate scalable NestJS projects with Clean Architecture (FULL) and MVP mode (LIGHT) - Enhanced with auto-generated .env secrets, complete ORM support, and entity relations",
   "main": "bin/nestcraft.js",
   "bin": {

package/readme.md

@@ -3,11 +3,11 @@
 demo
 ![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)
 ![Node.js](https://img.shields.io/badge/node-%3E=14.0.0-green.svg)
-![Version](https://img.shields.io/badge/version-0.2.1-brightgreen.svg)
+![Version](https://img.shields.io/badge/version-0.2.2-brightgreen.svg)
 
 **NestCraftX** est un CLI Node.js moderne et puissant pour generer automatiquement des projets NestJS avec une architecture propre et maintenable. Il implemente les meilleures pratiques modernes : **Clean Architecture**, **Domain-Driven Design (DDD)**, **Prisma/TypeORM/Mongoose**, **JWT Auth avec secrets auto-generes**, **Swagger**, **Docker**, et plus encore.
 
-> Version 0.2.1 : Amélioration majeure - Démo interactif avec flags, Auth refactorisée via UserService, templates professionnels (gitignore, README), code propre et maintenir par la communauté !
+> Version 0.2.2 : Amélioration majeure - Démo interactif avec flags, Auth refactorisée via UserService, templates professionnels (gitignore, README), code propre et maintenir par la communauté !
 
 ---
 
@@ -28,7 +28,7 @@ demo
 
 ---
 
-## Nouveautes v0.2.1
+## Nouveautes v0.2.2
 
 ### Demo Command Amélioré
 
@@ -548,7 +548,7 @@ Merci à tous les contributeurs et à la communauté NestJS !
 
 ---
 
-**NestCraftX v0.2.1** - Clean Architecture Made Simple
+**NestCraftX v0.2.2** - Clean Architecture Made Simple
 
 Pour plus d'informations: