nestcraftx 0.2.0 → 0.2.3

package/CHANGELOG.fr.md

@@ -0,0 +1,97 @@
+# Journal des modifications (Changelog)
+
+Toutes les modifications notables apportées à NestCraftX seront documentées dans ce fichier.
+
+## [0.2.3] - 10-01-2026
+
+### Ajouté
+
+- **Nouveau système interactif (Inquirer.js)** : Remplacement de `readline-sync` par `Inquirer` pour une navigation professionnelle au clavier (touches fléchées).
+- **Support des gestionnaires de paquets** : Choix entre `npm`, `yarn` et `pnpm` (via le flag `--pm` ou sélection interactive).
+- **Détection intelligente de DB** : Sélection automatique du type de base de données (PostgreSQL ou MongoDB) en fonction de l'ORM choisi.
+- **Fusion avancée des flags** : Intégration fluide entre les flags CLI et les invites interactives pour les options manquantes.
+- **Badges de statut visuels** : Ajout de badges dans le README pour la Version, la Licence et les ORM supportés.
+
+### Changé
+
+- **Refonte TOTALE de l'architecture** : Déplacement des services vers `application/services` pour respecter strictement les patterns de la Clean Architecture.
+- **Refactorisation de l'Auth** : `AuthService` interagit désormais exclusivement avec `UserService` (suppression de l'accès direct au repository).
+- **Commande Demo améliorée** : La commande `demo` génère maintenant un projet de blog complet avec 3 entités liées (User, Post, Comment) et des relations 1-N.
+- **Sécurité renforcée** : Les secrets JWT sont désormais générés via `crypto.randomBytes(32)` (chaînes hexadécimales de 64 caractères).
+- **Docker par défaut** : Les fichiers Docker sont maintenant générés par défaut dans les deux modes, sauf si `--docker=false` est spécifié.
+
+### Corrigé
+
+- **Compatibilité des modules** : Résolution des conflits CommonJS vs ES6 dans les templates de projet générés.
+- **Validation des flags** : Correction de bugs où certains flags CLI étaient ignorés durant le flux interactif.
+- **Dépendances circulaires** : Nettoyage des imports dans le module Auth pour prévenir d'éventuels problèmes au runtime.
+
+---
+
+## [0.2.2] - 07-11-2025
+
+### Ajouté
+
+- **Templates professionnels** : Auto-génération d'un `.gitignore` spécifique à NestJS et d'un `README.md` personnalisé pour chaque nouveau projet.
+- **Auto-init Git** : Initialisation automatique du dépôt Git et premier commit après la génération du projet.
+- **Support Mongoose (Beta)** : Première implémentation de l'architecture MongoDB avec Mongoose.
+
+### Changé
+
+- **Nettoyage du code** : Suppression des fichiers de configuration obsolètes (`start.js`, `fullModeInput.js`, `lightModeInput.js`).
+- **Standardisation des logs** : Unification des messages console via un système de codes couleurs cohérent (Info, Succès, Avertissement).
+
+---
+
+## [0.2.0] - 27-10-2025
+
+### Ajouté
+
+- **Modes d'architecture doubles** :
+- **Mode FULL** : Clean Architecture complète + DDD (Use-cases, Mappers, Adapters).
+- **Mode LIGHT** : Architecture MVP simplifiée (Controllers → Services → Repositories).
+
+- **Parseur CLI moderne** : Support des syntaxes `--key=value` et `--key value` avec validation.
+- **Amélioration de l'UX** : Intégration de spinners animés et d'un résumé complet de la configuration post-génération.
+
+### Sécurité
+
+- **Environnement sécurisé** : Génération automatique de `JWT_SECRET` et `JWT_REFRESH_SECRET` dans le fichier `.env`.
+- **Exemples assainis** : Création d'un fichier `.env.example` sécurisé sans données sensibles.
+
+---
+
+## [0.1.0] - Version précédente
+
+### Fonctionnalités initiales
+
+- Génération de projet NestJS de base.
+- Support de Prisma et TypeORM.
+- Configuration de base Docker et Swagger.
+- Authentification JWT standard.
+
+---
+
+## Notes de migration
+
+### De 0.1.x à 0.2.3
+
+**Changements non-bloquants** : La version 0.2.x est rétrocompatible.
+
+**Nouvelles commandes recommandées :**
+
+```bash
+# Mode LIGHT (Plus rapide pour les MVP)
+nestcraftx new my-api --light --orm=prisma --auth
+
+# Mode FULL (Standard pour les applications d'entreprise)
+nestcraftx new my-app --full --orm=typeorm --auth --swagger
+
+```
+
+Avantages de la mise à jour :
+
+- Secrets JWT automatisés et sécurisés.
+- Choix du gestionnaire de paquets (npm/yarn/pnpm).
+- Meilleure séparation des responsabilités dans les modules Auth/User.
+- Meilleure expérience développeur (DX) avec les menus interactifs.

package/CHANGELOG.md

@@ -2,210 +2,97 @@
 
 All notable changes to NestCraftX will be documented in this file.
 
-## [0.2.1] - 2025-11-07
+## [0.2.3] - 2026-01-10
 
 ### 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
-- 3 entités pré-configurées (User, Post, Comment) avec relations
-- 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
-- Refresh tokens implémentés
-- OTP et password reset ready-to-use
-- Guards et strategies Passport complets
-- 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
-- Imports/exports cohérents dans tout le projet
+- **New Interactive System (Inquirer.js)**: Replaced `readline-sync` with `Inquirer` for professional arrow-key navigation.
+- **Package Manager Support**: Choice between `npm`, `yarn`, and `pnpm` (via `--pm` flag or interactive selection).
+- **Smart DB Detection**: Automatic database type selection (PostgreSQL or MongoDB) based on the chosen ORM.
+- **Advanced Flag Merging**: Seamless integration between CLI flags and interactive prompts for missing options.
+- **Visual Status Badges**: Added README badges for Version, License, and Supported ORMs.
 
 ### Changed
 
-- Version du projet mise à jour à 0.2.1
-- Documentation README complètement mise à jour
-- CLI_USAGE.md actualisé avec les nouveau flags
-- Meilleure séparation des responsabilités (Auth ↔ User)
+- **FULL Architecture Refactor**: Services moved to `application/services` to strictly follow Clean Architecture patterns.
+- **Auth Refactoring**: `AuthService` now interacts exclusively with `UserService` (removed direct repository access).
+- **Enhanced Demo Command**: The `demo` command now generates a full blog project with 3 related entities (User, Post, Comment) and 1-N relationships.
+- **Improved Security**: JWT secrets now generated via `crypto.randomBytes(32)` (64-character hex strings).
+- **Docker by Default**: Docker files are now generated by default in both modes unless `--docker=false` is specified.
 
 ### Fixed
 
-- Cohérence des systèmes de modules CommonJS
-- Résolution des problèmes d'imports ES6/CommonJS mélangés
-- Gestion correcte des dépendances transversales
+- **Module Compatibility**: Resolved CommonJS vs ES6 conflicts in generated project templates.
+- **Flag Validation**: Fixed bugs where certain CLI flags were ignored during the interactive flow.
+- **Circular Dependencies**: Cleaned up imports in the Auth module to prevent potential runtime issues.
 
 ---
 
-## [0.2.0] - 2025-10-27
+## [0.2.2] - 2025-11-07
 
 ### 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
-
-- **Mode LIGHT** : Architecture MVP simplifiee
-  - Structure plate : controllers → services → repositories
-  - Moins de couches d'abstraction
-  - 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
-  - Messages d'erreur clairs
-
-- Nouvelles options en ligne de commande :
-  - `--full` ou `--mode=full` : Mode architecture complete
-  - `--light` ou `--mode=light` : Mode architecture simplifiee
-  - `--orm=<prisma|typeorm|mongoose>` : Choix de l'ORM
-  - `--auth` : Activation de l'authentification JWT
-  - `--swagger` : Activation de la documentation Swagger
-  - `--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
-  - MongoDB pour Mongoose
-- Variables pre-configurees :
-  - `JWT_SECRET` : Secret auto-genere
-  - `JWT_REFRESH_SECRET` : Secret refresh auto-genere
-  - `JWT_EXPIRES_IN` : 15 minutes par defaut
-  - `JWT_REFRESH_EXPIRES_IN` : 7 jours par defaut
-  - `DATABASE_URL` : URL construite automatiquement
-- Creation d'un fichier `.env.example` sanitise
-
-#### UX Amelioree
-- Systeme de couleurs pour les logs :
-  - Info en cyan
-  - Success en vert
-  - Error en rouge
-  - Warning en jaune
-- Spinners animes pour les operations longues
-- Messages de progression clairs
-- Resume detaille post-generation avec toutes les configurations
-- 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
-- `utils/spinner.js` : Spinners animes pour les operations longues
-- `utils/configs/setupLightArchitecture.js` : Setup architecture LIGHT
+- **Professional Templates**: Auto-generation of NestJS-specific `.gitignore` and customized `README.md` for every new project.
+- **Git Auto-init**: Automatic Git repository initialization and first commit after project generation.
+- **Mongoose Support (Beta)**: Initial implementation of MongoDB architecture with Mongoose.
 
 ### Changed
 
-#### Structure du Code
-- Refactoring complet de `commands/new.js` :
-  - Separation en fonctions modulaires
-  - `determineMode()` : Detection du mode
-  - `buildLightModeInputs()` : Construction config LIGHT
-  - `buildFullModeInputs()` : Construction config FULL
-  - `executeProjectSetup()` : Execution du setup
-  - `printSuccessSummary()` : Affichage resume
-
-- Amelioration de `utils/shell.js` :
-  - Support des spinners
-  - Mode silencieux pour certaines operations
-  - Meilleure gestion des erreurs
-
-- Modernisation des loggers :
-  - Utilisation du systeme de couleurs
-  - Format unifie
-  - Messages plus clairs
-
-#### Parser CLI
-- Validation des inputs en temps reel
-- Detection des flags mutuellement exclusifs
-- Support de la syntaxe moderne (--key=value)
-- Messages d'erreur descriptifs
-
-### 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
+- **Code Cleanup**: Removed obsolete configuration files (`start.js`, `fullModeInput.js`, `lightModeInput.js`).
+- **Log Standardization**: Unified console messaging using a consistent color-coded system (Info, Success, Warning).
 
-### 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)
+---
+
+## [0.2.0] - 2025-10-27
+
+### Added
+
+- **Dual Architecture Modes**:
+  - **Mode FULL**: Complete Clean Architecture + DDD (Use-cases, Mappers, Adapters).
+  - **Mode LIGHT**: Simplified MVP Architecture (Controllers → Services → Repositories).
+- **Modern CLI Parser**: Support for `--key=value` and `--key value` syntax with validation.
+- **Improved UX**: Integrated animated spinners and a full post-generation configuration summary.
 
 ### Security
-- Generation de secrets JWT securises avec crypto
-- Secrets de 64 caracteres en base64url
-- Fichier .env.example sans secrets sensibles
-- Bonnes pratiques de securite appliquees
+
+- **Secure Environment**: Automatic generation of `JWT_SECRET` and `JWT_REFRESH_SECRET` in `.env`.
+- **Sanitized Examples**: Creation of a safe `.env.example` file without sensitive data.
+
+---
 
 ## [0.1.0] - Previous Version
 
-### Features Initiales
-- Generation de projets NestJS
-- Support Prisma, TypeORM, Mongoose
-- Architecture Clean Code de base
-- Configuration Docker
-- Support Swagger
-- Authentification JWT basique
+### Initial Features
+
+- Basic NestJS project generation.
+- Support for Prisma and TypeORM.
+- Basic Docker and Swagger configuration.
+- Standard JWT Authentication.
 
 ---
 
-## Notes de Migration
+## Migration Notes
 
-### De 0.1.x vers 0.2.0
+### From 0.1.x to 0.2.3
 
-**Changements non-breaking** : La version 0.2.0 est retrocompatible.
+**Non-breaking changes**: Version 0.2.x is backward compatible.
 
-**Nouvelles commandes recommandees :**
+**New Recommended Commands:**
 
-Avant (0.1.x) :
 ```bash
-nestcraftx start
-# Configuration interactive
+# LIGHT Mode (Fastest for MVPs)
+nestcraftx new my-api --light --orm=prisma --auth
+
+# FULL Mode (Standard for enterprise-grade apps)
+nestcraftx new my-app --full --orm=typeorm --auth --swagger
 ```
 
-Maintenant (0.2.0) :
-```bash
-# Mode LIGHT (nouveau - recommande pour MVP)
-nestcraftx new mon-projet --light --orm=prisma --auth
+Benefits of updating:
 
-# Mode FULL (equivalent a l'ancien comportement)
-nestcraftx new mon-projet --full --orm=prisma --auth
-```
+- Automated secure JWT secrets.
+
+- Choice of Package Manager (npm/yarn/pnpm).
+
+- Cleaner separation of concerns in Auth/User modules.
 
-**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
-- Meilleure experience utilisateur (couleurs, spinners)
-- CLI plus moderne et flexible
+- Better DX with arrow-key menus.

package/CLI_USAGE.fr.md

@@ -0,0 +1,331 @@
+# NestCraftX CLI - Guide d'utilisation
+
+## Installation
+
+```bash
+npm install -g nestcraftx
+```
+
+## Commandes disponibles
+
+### Creer un nouveau projet
+
+```bash
+nestcraftx new <project-name> [options]
+```
+
+## Modes de generation
+
+### Mode FULL (Architecture Complete - Clean Architecture + DDD)
+
+Structure complete avec use-cases, mappers, adapters et separation stricte des couches.
+Ideal pour les projets complexes et scalables.
+
+```bash
+nestcraftx new mon-projet --full
+nestcraftx new mon-projet --mode=full
+nestcraftx new mon-projet
+```
+
+**Structure generee :**
+
+```
+src
+├── [entity]
+│   ├── application
+│   │   ├── dtos
+│   │   ├── services
+│   │   ├── use-cases
+│   │   └── interfaces
+│   │
+│   ├── domain
+│   │   ├── entities
+│   │   ├── enums
+│   │   └── interfaces
+│   │
+│   ├── infrastructure
+│   │   ├── adapters
+│   │   ├── mappers
+│   │   ├── repositories
+│   │   └── services
+│   │
+│   ├── presentation
+│   │   └── controllers
+│   │
+│   └── [entity].module.ts
+```
+
+### Mode LIGHT (MVP Simplifie)
+
+Structure plate avec moins de couches d'abstraction.
+Parfait pour prototypes et petits projets.
+
+```bash
+nestcraftx new mon-projet --light
+nestcraftx new mon-projet --mode=light
+```
+
+**Structure generee :**
+
+```
+src
+├── [entity]
+│   ├── entities
+│   ├── dto
+│   ├── services
+│   ├── repositories
+│   ├── controllers
+│   └── [entity].module.ts
+```
+
+## Options disponibles
+
+### ORM
+
+Choisir l'ORM a utiliser :
+
+```bash
+--orm=prisma     # Prisma (par defaut)
+--orm=typeorm    # TypeORM
+--orm=mongoose   # Mongoose (MongoDB - phase de test)
+```
+
+**Exemples :**
+
+```bash
+nestcraftx new mon-api --light --orm=prisma
+nestcraftx new mon-api --full --orm=typeorm
+nestcraftx new mon-api --orm=mongoose
+```
+
+### Authentification
+
+Activer l'authentification JWT :
+
+```bash
+--auth           # Active l'auth avec JWT
+```
+
+**Exemple :**
+
+```bash
+nestcraftx new mon-api --light --auth --orm=prisma
+```
+
+Avec `--auth`, une entite User est automatiquement generee avec :
+
+- email (string)
+- password (string)
+- isActive (boolean)
+
+### Swagger
+
+Activer la documentation Swagger/OpenAPI :
+
+```bash
+--swagger        # Active Swagger UI
+```
+
+**Exemple :**
+
+```bash
+nestcraftx new mon-api --light --swagger
+```
+
+Swagger sera accessible a : `http://localhost:3000/api/docs`
+
+### Docker
+
+Desactiver Docker (active par defaut) :
+
+```bash
+--docker=false   # Desactive Docker
+```
+
+**Exemple :**
+
+```bash
+nestcraftx new mon-api --light --docker=false
+```
+
+## Exemples de commandes completes
+
+### Projet LIGHT avec toutes les options
+
+```bash
+nestcraftx new mon-api --light --orm=prisma --auth --swagger
+```
+
+### Projet FULL avec TypeORM et Auth
+
+```bash
+nestcraftx new mon-api --full --orm=typeorm --auth
+```
+
+### Projet minimal LIGHT (mode interactif)
+
+```bash
+nestcraftx new mon-api --light
+# Le CLI demandera toutes les options necessaires
+```
+
+### Projet MongoDB avec Mongoose
+
+```bash
+nestcraftx new mon-api --light --orm=mongoose --auth --swagger
+```
+
+## Configuration automatique
+
+### Fichier .env genere
+
+Le CLI genere automatiquement un fichier `.env` avec :
+
+**Pour PostgreSQL (Prisma/TypeORM) :**
+
+```env
+NODE_ENV=development
+PORT=3000
+JWT_SECRET=<secret-auto-genere-64-chars>
+JWT_REFRESH_SECRET=<secret-auto-genere-64-chars>
+JWT_EXPIRES_IN=15m
+JWT_REFRESH_EXPIRES_IN=7d
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=postgres
+POSTGRES_DB=mon-api
+POSTGRES_HOST=localhost
+POSTGRES_PORT=5432
+DATABASE_URL=postgresql://postgres:postgres@localhost:5432/mon-api?schema=public
+```
+
+**Pour MongoDB (Mongoose) :**
+
+```env
+NODE_ENV=development
+PORT=3000
+JWT_SECRET=<secret-auto-genere-64-chars>
+JWT_REFRESH_SECRET=<secret-auto-genere-64-chars>
+JWT_EXPIRES_IN=15m
+JWT_REFRESH_EXPIRES_IN=7d
+MONGO_URI=mongodb://localhost:27017
+MONGO_DB=mon-api
+```
+
+Les secrets JWT sont generes automatiquement de maniere securisee.
+
+## Modes Interactifs
+
+### Mode LIGHT Interactif
+
+Si vous ne fournissez pas tous les flags necessaires, le CLI passera en mode interactif pour demander les options manquantes.
+
+**Exemple :**
+
+```bash
+nestcraftx new mon-api --light
+
+[MODE LIGHT] Configuration simplifiee pour mon-api
+
+[?] Choisissez un ORM (prisma, typeorm, mongoose) [prisma]: prisma
+[?] Activer l'authentification JWT ? (Y/n): y
+[INFO] Auth active : ajout automatique de l'entite User
+[?] Activer Swagger pour la documentation API ? (Y/n): y
+[?] Generer les fichiers Docker ? (Y/n): y
+
+[INFO] Configuration PostgreSQL
+  Utilisateur PostgreSQL [postgres]:
+  Mot de passe PostgreSQL [postgres]:
+  Nom de la base [mon-api]:
+  Hote PostgreSQL [localhost]:
+  Port PostgreSQL [5432]:
+
+[?] Voulez-vous ajouter des entites supplementaires ? (Y/n): n
+
+[INFO] Demarrage de la generation du projet...
+```
+
+### Mode FULL Interactif
+
+Le mode FULL est toujours interactif pour vous donner un controle total sur la configuration.
+
+**Exemple :**
+
+```bash
+nestcraftx new mon-projet
+
+[MODE FULL] Configuration complete avec Clean Architecture
+
+[?] Nom du projet : mon-projet
+[?] Base de donnees (postgresql, mongodb) [postgresql]: postgresql
+
+[INFO] Configuration PostgreSQL
+  Utilisateur PostgreSQL [postgres]:
+  Mot de passe PostgreSQL [postgres]:
+  ...
+
+[?] ORM pour PostgreSQL (prisma, typeorm) [prisma]: prisma
+[?] Utiliser Yarn ? (Y/n): n
+[?] Generer fichiers Docker ? (Y/n): y
+[?] Ajouter authentification JWT ? (Y/n): y
+[?] Installer Swagger ? (Y/n): y
+
+[INFO] Configuration Swagger
+  Titre API [mon-projet API]:
+  Description [API generated by NestCraftX]:
+  Version [1.0.0]:
+  Endpoint [api/docs]:
+
+[INFO] Saisie des entites (Mode FULL - Architecture complete)
+[?] Ajouter une entite ? (Y/n): y
+  Nom de l'entite : post
+  Champs pour "post" :
+    Nom du champ (vide pour terminer) : title
+    Type de "title" (string, number, boolean, Date, enum) : string
+    Nom du champ (vide pour terminer) : content
+    Type de "content" (string, number, boolean, Date, enum) : string
+    Nom du champ (vide pour terminer) :
+
+[✓] Entite "post" ajoutee avec 2 champ(s)
+[?] Ajouter une autre entite ? (Y/n): n
+[?] Ajouter des relations entre entites ? (Y/n): n
+```
+
+## Apres la creation
+
+```bash
+cd mon-projet
+npm run start:dev
+```
+
+Si Swagger est active :
+
+```
+http://localhost:3000/api/docs
+```
+
+## Autres commandes
+
+### Verifier l'environnement
+
+```bash
+nestcraftx test
+```
+
+### Informations CLI
+
+```bash
+nestcraftx info
+```
+
+### Aide
+
+```bash
+nestcraftx --help
+```
+
+## Notes importantes
+
+- Les secrets JWT sont auto-generes de maniere securisee (64 caracteres)
+- DATABASE_URL est automatiquement construit selon l'ORM choisi
+- Docker est active par defaut en mode LIGHT
+- Le mode FULL necessite une configuration interactive si aucune option n'est fournie