nestcraftx 0.1.9 → 0.2.2

package/CHANGELOG.md

@@ -0,0 +1,235 @@
+# Changelog
+
+All notable changes to NestCraftX will be documented in this file.
+
+## [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
+- 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
+
+### Changed
+
+- 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)
+
+### 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
+
+---
+
+## [0.2.0] - 2025-10-27
+
+### 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
+
+### 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
+
+### 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
+- Bonnes pratiques de securite appliquees
+
+## [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
+
+---
+
+## Notes de Migration
+
+### De 0.1.x vers 0.2.0
+
+**Changements non-breaking** : La version 0.2.0 est retrocompatible.
+
+**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
+
+# Mode FULL (equivalent a l'ancien comportement)
+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
+- Meilleure experience utilisateur (couleurs, spinners)
+- CLI plus moderne et flexible

package/CLI_USAGE.md

@@ -0,0 +1,300 @@
+# 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/
+│   │   ├── use-cases/
+│   │   ├── dtos/
+│   │   └── interfaces/
+│   ├── domain/
+│   │   ├── entities/
+│   │   ├── enums/
+│   │   └── mappers/
+│   ├── infrastructure/
+│   │   ├── repositories/
+│   │   ├── services/
+│   │   └── adapters/
+│   └── presentation/
+│       └── controllers/
+```
+
+### 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/
+```
+
+## Options disponibles
+
+### ORM
+Choisir l'ORM a utiliser :
+
+```bash
+--orm=prisma     # Prisma (par defaut)
+--orm=typeorm    # TypeORM
+--orm=mongoose   # Mongoose (MongoDB)
+```
+
+**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