nestcraftx 0.3.0 → 0.4.0

package/PROGRESS.md

@@ -9,15 +9,15 @@
 | Phase | Statut | Tickets | Complétés | Progression |
 |---|---|---|---|---|
 | Phase 0 — Stabilisation (v0.3.0) | ✅ Terminé | 17 | 17 | 100% |
-| Phase 1 — Refactorisation (v0.4.0) | 🔵 En cours | 18 | 9 | 50% |
+| Phase 1 — Refactorisation (v0.4.0) | ✅ Terminé | 18 | 18 | 100% |
 | Phase 2 — Qualité & Sécurité (v0.5.0) | ⏸️ En attente | 10 | 0 | 0% |
 | Phase 3 — Tests & CI/CD (v0.6.0) | ⏸️ En attente | 15 | 0 | 0% |
 | Phase 4 — Features (v0.7–0.9) | ⏸️ En attente | 14 | 0 | 0% |
 | Phase 5 — Documentation (v0.9.x) | ⏸️ En attente | 8 | 0 | 0% |
 | Phase 6 — Release v1.0 | ⏸️ En attente | 7 | 0 | 0% |
-| **TOTAL** | | **89** | **26** | **29%** |
+| **TOTAL** | | **89** | **35** | **39%** |
 
-> Mis à jour : 2026-06-07
+> Mis à jour : 2026-06-16
 
 ---
 
@@ -79,20 +79,20 @@
 
 | Ticket | Description | Fichier(s) | Statut | Date |
 |---|---|---|---|---|
-| PROD-04a | Étendre modèle de champ : `unique`, `nullable`, `default` | `utils/fullModeInput.js`, `utils/lightModeInput.js` | ⬜ À faire | — |
-| PROD-05 | Écran de révision d'entité (modifier, supprimer, renommer) | `utils/fullModeInput.js`, `utils/lightModeInput.js` | ⬜ À faire | — |
-| PROD-04b | Refonte state-based : `EntityBuilder` navigable | `utils/fullModeInput.js` | ⬜ À faire | — |
-| MP-02 | Dédupliquer `addCustomEntities` et `addRelations` | `utils/fullModeInput.js`, `utils/lightModeInput.js` | ⬜ À faire | — |
+| PROD-04a | Étendre modèle de champ : `unique`, `nullable`, `default` | `utils/fullModeInput.js`, `utils/lightModeInput.js` | ✅ Terminé | 2026-06-14 |
+| PROD-05 | Écran de révision d'entité (modifier, supprimer, renommer) | `utils/fullModeInput.js`, `utils/lightModeInput.js` | ✅ Terminé | 2026-06-14 |
+| PROD-04b | Refonte state-based : `EntityBuilder` navigable | `utils/fullModeInput.js` | ✅ Terminé | 2026-06-14 |
+| MP-02 | Dédupliquer `addCustomEntities` et `addRelations` | `utils/fullModeInput.js`, `utils/lightModeInput.js` | ✅ Terminé | 2026-06-14 |
 
 ### 1C — Architecture générale
 
 | Ticket | Description | Fichier(s) | Statut | Date |
 |---|---|---|---|---|
-| MA-05 | Extraire flow commun `demo.js` → partager avec `new.js` | `commands/demo.js`, `commands/new.js` | ⬜ À faire | — |
-| MP-04 | Remplacer `execSync` par `execa` avec timeout | `utils/shell.js` | ⬜ À faire | — |
-| MA-01 | Mécanisme de rapport final (accumuler warnings, afficher en bloc) | `utils/shell.js`, `commands/new.js` | ⬜ À faire | — |
-| MA-02 | Isoler `process.chdir` — vérifier CWD avant chaque I/O | `utils/setups/projectSetup.js` | ⬜ À faire | — |
-| DRY-01 | Ajouter `--dry-run` flag (simuler sans écrire) | `bin/nestcraft.js`, `commands/new.js` | ⬜ À faire | — |
+| MA-05 | Extraire flow commun `demo.js` → partager avec `new.js` | `commands/demo.js`, `commands/new.js` | ✅ Terminé | 2026-06-16 |
+| MP-04 | Remplacer `execSync` par `execa` avec timeout | `utils/shell.js` | ✅ Terminé | 2026-06-16 |
+| MA-01 | Mécanisme de rapport final (accumuler warnings, afficher en bloc) | `utils/shell.js`, `commands/new.js` | ✅ Terminé | 2026-06-16 |
+| MA-02 | Isoler `process.chdir` — vérifier CWD avant chaque I/O | `utils/setups/projectSetup.js` | ✅ Terminé | 2026-06-16 |
+| DRY-01 | Ajouter `--dry-run` flag (simuler sans écrire) | `bin/nestcraft.js`, `commands/new.js` | ✅ Terminé | 2026-06-16 |
 
 ---
 
@@ -239,6 +239,7 @@
 | 2026-06-05 | 0.3.0-wip | PROD-03, PROD-01a, PROD-01b, PROD-01c, BUG-09 | `runCommand` refactorisé (PROD-03). Prisma relations : capitalisation forcée des modèles et types, déduplication complète des clés étrangères (PROD-01a, b, c). Correction de la boucle asynchrone des use cases clean architecture (BUG-09). |
 | 2026-06-06 | 0.3.0-wip | BUG-01, BUG-03, BUG-06 | Unification du module system en CommonJS (BUG-01). Validation non-interactive des flags (BUG-03). Utilisation de inputs.packageManager dynamique dans `setupAuth.js` au lieu de npm en dur (BUG-06). |
 | 2026-06-07 | 0.3.0 | BUG-07, BUG-04, BUG-08, BUG-12, MP-07a, MP-07b, BUG-02, BUG-11, BUG-12b | Clôture de la Phase 0. Mongoose .env préservé. createFile supporte overwrite. safeUpdateAppModule robuste aux crochets imbriqués. help.js dynamic. Nettoyage de code mort et debug logs. |
+| 2026-06-14 | 0.3.0-wip | PROD-04a, PROD-04b, PROD-05, MP-02 | Refonte state-based interactive de la saisie d'entités avec EntityBuilder. Support des contraintes unique, nullable et valeurs par défaut. Alignement et déduplication des générateurs (Prisma, TypeORM, Mongoose, DTOs, et Domain Entities). |
 
 ---
 

package/commands/demo.js

@@ -1,21 +1,7 @@
 const inquirer = require("inquirer");
 const { logInfo } = require("../utils/loggers/logInfo");
 const { logSuccess } = require("../utils/loggers/logSuccess");
-const { createProject } = require("../utils/setups/projectSetup");
-const {
-  setupCleanArchitecture,
-} = require("../utils/configs/setupCleanArchitecture");
-const {
-  setupLightArchitecture,
-} = require("../utils/configs/setupLightArchitecture");
-const { setupAuth } = require("../utils/setups/setupAuth");
-const { setupSwagger } = require("../utils/setups/setupSwagger");
-const { setupDatabase } = require("../utils/setups/setupDatabase");
-const { configureDocker } = require("../utils/configs/configureDocker");
-const { generateEnvFile, writeEnvFile } = require("../utils/envGenerator");
-const { setupBootstrapLogger } = require("../utils/setups/setupLogger");
-const { saveProjectConfig } = require("../utils/file-utils/saveProjectConfig");
-const { printSetupWarnings } = require("../utils/shell");
+const { runProjectSetupPipeline } = require("../utils/setups/projectSetup");
 const actualInquirer = inquirer.default || inquirer;
 
 async function demoCommand(flags = {}) {
@@ -210,37 +196,7 @@ async function demoCommand(flags = {}) {
     dbConfig,
   };
 
-  await createProject(demoInputs);
-
-  if (isLight) {
-    await setupLightArchitecture(demoInputs);
-  } else {
-    await setupCleanArchitecture(demoInputs);
-  }
-
-  if (useAuth) {
-    await setupAuth(demoInputs);
-  }
-
-  if (useSwagger) {
-    await setupSwagger(demoInputs.swaggerInputs);
-  } else {
-    await setupBootstrapLogger();
-  }
-
-  if (useDocker) {
-    await configureDocker(demoInputs);
-  }
-
-  await setupDatabase(demoInputs);
-
-  const envContent = await generateEnvFile(demoInputs);
-  writeEnvFile(envContent);
-
-  await saveProjectConfig(demoInputs);
-
-  // Show any non-critical warnings accumulated during generation
-  printSetupWarnings();
+  await runProjectSetupPipeline(demoInputs);
 
   console.log("\n" + "=".repeat(60));
   logSuccess("Demonstration project created successfully!");

package/commands/new.js

@@ -1,26 +1,12 @@
 const { getFullModeInputs } = require("../utils/fullModeInput");
 const { getLightModeInputs } = require("../utils/lightModeInput");
-const { createProject } = require("../utils/setups/projectSetup");
-const {
-  setupCleanArchitecture,
-} = require("../utils/configs/setupCleanArchitecture");
-const {
-  setupLightArchitecture,
-} = require("../utils/configs/setupLightArchitecture");
-const { setupAuth } = require("../utils/setups/setupAuth");
-const { setupSwagger } = require("../utils/setups/setupSwagger");
-const { setupDatabase } = require("../utils/setups/setupDatabase");
-const { configureDocker } = require("../utils/configs/configureDocker");
-const { setupBootstrapLogger } = require("../utils/setups/setupLogger");
+const { runProjectSetupPipeline } = require("../utils/setups/projectSetup");
 const { logSuccess } = require("../utils/loggers/logSuccess");
 const { logInfo } = require("../utils/loggers/logInfo");
 const { logError } = require("../utils/loggers/logError");
-const { generateEnvFile, writeEnvFile } = require("../utils/envGenerator");
 const readline = require("readline-sync");
 const { info, warning } = require("../utils/colors");
 const { logWarning } = require("../utils/loggers/logWarning");
-const { saveProjectConfig } = require("../utils/file-utils/saveProjectConfig");
-const { printSetupWarnings } = require("../utils/shell");
 
 async function newCommand(projectName, flags = {}) {
   if (!projectName) {
@@ -240,40 +226,9 @@ function buildFullModeFromFlags(projectName, flags) {
 
 async function executeProjectSetup(inputs) {
   try {
-    logInfo("Starting project generation...");
-
-    await createProject(inputs);
-
-    if (inputs.mode === "light") {
-      await setupLightArchitecture(inputs);
-    } else {
-      await setupCleanArchitecture(inputs);
-    }
-
-    if (inputs.useAuth) await setupAuth(inputs);
-
-    if (inputs.useSwagger) {
-      await setupSwagger(inputs.swaggerInputs);
-    } else {
-      setupBootstrapLogger();
-    }
-
-    if (inputs.useDocker) await configureDocker(inputs);
-
-    await setupDatabase(inputs);
-
-    const envContent = await generateEnvFile(inputs);
-    writeEnvFile(envContent);
-
-    await saveProjectConfig(inputs);
-
-    // Show any non-critical warnings accumulated during generation
-    printSetupWarnings();
-
+    await runProjectSetupPipeline(inputs);
     printSuccessSummary(inputs);
   } catch (error) {
-    // Erreur lors de la creation du projet: ${error.message}
-    logError(`Error during project creation: ${error.message}`);
     throw error;
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nestcraftx",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "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/utils/app-module.updater.js

@@ -24,6 +24,12 @@ const { capitalize } = require("./helpers");
  * @param {string} entity - Le nom de l'entité en minuscule (ex: "user", "post")
  */
 async function safeUpdateAppModule(entity) {
+  const isDryRun = process.argv.includes("--dry-run");
+  if (isDryRun) {
+    console.log(`[DRY-RUN] Simulated: safe update app.module.ts with ${capitalize(entity)}Module`);
+    return;
+  }
+
   const filePath = "src/app.module.ts";
   const moduleName = `${capitalize(entity)}Module`;
   const importLine = `import { ${moduleName} } from 'src/${entity}/${entity}.module';`;

package/utils/envGenerator.js

@@ -85,6 +85,12 @@ function buildDatabaseUrl(user, password, host, port, database, orm) {
 }
 
 function writeEnvFile(envContent, projectPath = ".") {
+  const isDryRun = process.argv.includes("--dry-run");
+  if (isDryRun) {
+    console.log(`[DRY-RUN] Simulated: write env file to ${path.join(projectPath, ".env")}`);
+    console.log(`[DRY-RUN] Simulated: write env example file to ${path.join(projectPath, ".env.example")}`);
+    return;
+  }
   // Écriture du .env (avec secrets)
   const envPath = path.join(projectPath, ".env");
   fs.writeFileSync(envPath, envContent, "utf8");

package/utils/file-system.js

@@ -15,6 +15,11 @@ const fs = require("fs");
  * @param {string} directoryPath - Le chemin du répertoire à créer.
  */
 async function createDirectory(directoryPath) {
+  const isDryRun = process.argv.includes("--dry-run");
+  if (isDryRun) {
+    console.log(`[DRY-RUN] Simulated: create directory ${directoryPath}`);
+    return;
+  }
   try {
     if (!fs.existsSync(directoryPath)) {
       fs.mkdirSync(directoryPath, { recursive: true });
@@ -36,6 +41,11 @@ async function createDirectory(directoryPath) {
  * @param {{ path: string, contente: string, overwrite?: boolean }} fileData
  */
 async function createFile(fileData) {
+  const isDryRun = process.argv.includes("--dry-run");
+  if (isDryRun) {
+    console.log(`[DRY-RUN] Simulated: create/write file ${fileData.path}`);
+    return;
+  }
   try {
     if (!fs.existsSync(fileData.path)) {
       fs.writeFileSync(`${fileData.path}`, `${fileData.contente}`);
@@ -59,6 +69,11 @@ async function createFile(fileData) {
  * @param {{ path: string, pattern: string|RegExp, replacement: string }} options
  */
 async function updateFile({ path, pattern, replacement }) {
+  const isDryRun = process.argv.includes("--dry-run");
+  if (isDryRun) {
+    console.log(`[DRY-RUN] Simulated: update file ${path}`);
+    return;
+  }
   try {
     let mainTs = fs.readFileSync(path, "utf8");
     const updatedContent = mainTs.replace(pattern, replacement);

package/utils/file-utils/packageJsonUtils.js

@@ -13,6 +13,12 @@ async function updatePackageJson(inputs, scripts, devDependencies = {}) {
   const projectPath = process.cwd();
   const packageJsonPath = path.join(projectPath, "package.json");
 
+  const isDryRun = process.argv.includes("--dry-run");
+  if (isDryRun) {
+    console.log(`[DRY-RUN] Simulated: update package.json scripts and devDependencies for ${inputs.projectName}`);
+    return;
+  }
+
   try {
     // 1. Lire le contenu actuel
     const fileContent = fs.readFileSync(packageJsonPath, "utf8");

package/utils/file-utils/saveProjectConfig.js

@@ -23,6 +23,12 @@ async function saveProjectConfig(inputs) {
     generatedAt: new Date().toISOString(),
   };
 
+  const isDryRun = process.argv.includes("--dry-run");
+  if (isDryRun) {
+    console.log(`[DRY-RUN] Simulated: save project config to ${configFile}`);
+    return;
+  }
+
   try {
     if (!fs.existsSync(configDir)) {
       fs.mkdirSync(configDir, { recursive: true });

package/utils/fullModeInput.js

@@ -4,6 +4,7 @@ const inquirer = require("inquirer");
 const { capitalize } = require("./userInput");
 const { logWarning } = require("./loggers/logWarning");
 const { getPackageManager } = require("./utils");
+const { buildEntityInteractive, buildRelationsInteractive } = require("./interactive/entityBuilder");
 const actualInquirer = inquirer.default || inquirer;
 
 async function getFullModeInputs(projectName, flags) {
@@ -334,97 +335,13 @@ async function getFullModeInputs(projectName, flags) {
 
   let addEntity = readline.keyInYNStrict(`${info("[?]")} Add an entity?`);
   while (addEntity) {
-    let name;
-    while (true) {
-      name = readline.question(`\n Entity name : `);
-      if (/^[A-Za-z][A-Za-z0-9_]*$/.test(name)) break;
-      logWarning("Invalid name. Letters, numbers, _ (start with a letter).");
-    }
-
-    const fields = [];
-
-    console.log(` Fields for "${name}" :`);
-    while (true) {
-      let fname = readline.question("  Field name (leave empty to finish) : ");
-      if (!fname) break;
-      if (!/^[A-Za-z][A-Za-z0-9_]*$/.test(fname)) {
-        logWarning("Invalid field name.");
-        continue;
-      }
-
-      const baseTypeChoices = [
-        "string",
-        "text",
-        "number",
-        "decimal",
-        "boolean",
-        "Date",
-        "uuid",
-        "json",
-        "enum",
-        "array",
-        "object",
-      ];
-
-      const typeQuestion = {
-        type: "list",
-        name: "ftype",
-        message: `Type for "${fname}"`,
-        default: "string",
-        choices: baseTypeChoices,
-        transformer: () => "",
-      };
-      const typeAnswer = await actualInquirer.prompt([typeQuestion]);
-      let ftype = typeAnswer.ftype;
-      process.stdout.write("\x1B[1A");
-      process.stdout.write("\x1B[K");
-
-      if (ftype === "array") {
-        const arrayInnerQuestion = {
-          type: "list",
-          name: "innerType",
-          message: `Type of elements for "${fname}[]"`,
-          default: "string",
-          choices: baseTypeChoices.filter(
-            (c) => c !== "array" && c !== "object"
-          ),
-          transformer: () => "",
-        };
-
-        const innerAnswer = await actualInquirer.prompt([arrayInnerQuestion]);
-        ftype = `${innerAnswer.innerType}[]`;
-      } else if (ftype === "enum") {
-        const enumName = capitalize(fname) + "Enum";
-        console.log(
-          `  ${info(
-            "[INFO]"
-          )} Enum type selected. Consider defining ${enumName} in your code.`
-        );
-        ftype = enumName;
-      } else if (ftype === "object") {
-        const objectNameQuestion = {
-          type: "input",
-          name: "objectName",
-
-          message: `Complex type name (DTO/Class or leave 'json') :`,
-          default: "json",
-          transformer: () => "",
-        };
-
-        const objectAnswer = await actualInquirer.prompt([objectNameQuestion]);
-        ftype = capitalize(objectAnswer.objectName.trim() || "json");
-      }
-
-      console.log(`  Type for "${fname}" : ${ftype} ${success("[✓]")}`);
-
-      fields.push({ name: fname, type: ftype });
+    const entity = await buildEntityInteractive();
+    if (entity) {
+      entitiesData.entities.push(entity);
+      console.log(
+        `${success("[✓]")} Entity "${entity.name}" added with ${entity.fields.length} field(s)`
+      );
     }
-
-    entitiesData.entities.push({ name, fields });
-    console.log(
-      `${success("[✓]")} Entity "${name}" added with ${fields.length} field(s)`
-    );
-
     addEntity = readline.keyInYNStrict(`${info("[?]")} Add another entity?`);
   }
 
@@ -432,145 +349,7 @@ async function getFullModeInputs(projectName, flags) {
     `${info("[?]")} Add relationships between entities?`
   );
   if (wantsRelation) {
-    if (entitiesData.entities.length > 1) {
-      console.log(`\n${info("[INFO]")} Configuring relationships`);
-
-      let configuring = true;
-      while (configuring) {
-        const entityNames = entitiesData.entities.map((e) => e.name);
-
-        // 1. Select entities first
-        const selection = await actualInquirer.prompt([
-          {
-            type: "list",
-            name: "fromName",
-            message: "From which entity? (Source)",
-            choices: entityNames,
-          },
-          {
-            type: "list",
-            name: "toName",
-            message: (prev) =>
-              `To which entity should ${prev.fromName} be linked? (Target)`,
-            choices: (prev) =>
-              entityNames.filter((name) => name !== prev.fromName),
-          },
-        ]);
-
-        // --- VERIFICATION: Check if link already exists (A->B or B->A) ---
-        const alreadyExists = entitiesData.relations.find(
-          (rel) =>
-            (rel.from === selection.fromName && rel.to === selection.toName) ||
-            (rel.from === selection.toName && rel.to === selection.fromName)
-        );
-
-        if (alreadyExists) {
-          logWarning(
-            `A relationship already exists between ${selection.fromName} and ${selection.toName} (${alreadyExists.type}).`
-          );
-
-          const { tryAgain } = await actualInquirer.prompt([
-            {
-              type: "confirm",
-              name: "tryAgain",
-              message: "Do you want to choose different entities?",
-              default: true,
-            },
-          ]);
-
-          if (!tryAgain) break;
-          continue; // Restart selection
-        }
-
-        // 2. Select Relationship type only if verification passed
-        const typeAnswer = await actualInquirer.prompt([
-          {
-            type: "list",
-            name: "relType",
-            message: "Relationship type:",
-            choices: [
-              {
-                name: `1-1 (One-to-One)   : ${selection.fromName} has one ${selection.toName}`,
-                value: "1-1",
-              },
-              {
-                name: `1-n (One-to-Many)  : ${selection.fromName} has many ${selection.toName}s`,
-                value: "1-n",
-              },
-              {
-                name: `n-1 (Many-to-One)  : Many ${selection.fromName}s belong to one ${selection.toName}`,
-                value: "n-1",
-              },
-              {
-                name: `n-n (Many-to-Many) : Many ${selection.fromName}s linked to many ${selection.toName}s`,
-                value: "n-n",
-              },
-            ],
-          },
-        ]);
-
-        const from = entitiesData.entities.find(
-          (e) => e.name === selection.fromName
-        );
-        const to = entitiesData.entities.find(
-          (e) => e.name === selection.toName
-        );
-        const relType = typeAnswer.relType;
-
-        // Register Relationship
-        entitiesData.relations.push({
-          from: from.name,
-          to: to.name,
-          type: relType,
-        });
-
-        const fromLow = from.name.toLowerCase();
-        const toLow = to.name.toLowerCase();
-
-        // --- Add fields logic ---
-        if (relType === "1-1") {
-          from.fields.push(
-            { name: `${toLow}Id`, type: "string" },
-            { name: toLow, type: to.name }
-          );
-        } else if (relType === "1-n") {
-          from.fields.push({ name: `${toLow}s`, type: `${to.name}[]` });
-          to.fields.push(
-            { name: `${fromLow}Id`, type: "string" },
-            { name: fromLow, type: from.name }
-          );
-        } else if (relType === "n-1") {
-          from.fields.push(
-            { name: `${toLow}Id`, type: "string" },
-            { name: toLow, type: to.name }
-          );
-          to.fields.push({ name: `${fromLow}s`, type: `${from.name}[]` });
-        } else if (relType === "n-n") {
-          from.fields.push({ name: `${toLow}s`, type: `${to.name}[]` });
-          to.fields.push({ name: `${fromLow}s`, type: `${from.name}[]` });
-        }
-
-        console.log(
-          `\n${success("[✓]")} Relationship added: ${from.name} ${relType} ${
-            to.name
-          }`
-        );
-
-        const { addMore } = await actualInquirer.prompt([
-          {
-            type: "confirm",
-            name: "addMore",
-            message: "Add another relationship?",
-            default: false,
-          },
-        ]);
-        configuring = addMore;
-      }
-    } else {
-      logWarning(
-        "At least two entities are required to configure a relationship."
-      );
-    }
+    await buildRelationsInteractive(entitiesData);
   }
 
   return {

package/utils/generators/application/dtoGenerator.js

@@ -88,6 +88,7 @@ async function generateDto(
     const name = f.name;
     const cleanType = f.type.toLowerCase().replace("[]", "");
     const isArray = f.type.endsWith("[]");
+    const isOptional = optional || f.nullable;
 
     const SCALAR_TYPES = [
       "string",
@@ -104,7 +105,7 @@ async function generateDto(
     if (!SCALAR_TYPES.includes(cleanType)) return null;
 
     let validators = [];
-    if (optional) validators.push("@IsOptional()");
+    if (isOptional) validators.push("@IsOptional()");
     if (name.toLowerCase().includes("email")) validators.push("@IsEmail()");
     else if (name.toLowerCase().includes("password"))
       validators.push(
@@ -141,7 +142,7 @@ async function generateDto(
 
     let swaggerDecorator = "";
     if (useSwagger && !forceNoSwagger) {
-      const decorator = optional ? "@ApiPropertyOptional" : "@ApiProperty";
+      const decorator = isOptional ? "@ApiPropertyOptional" : "@ApiProperty";
       const options = JSON.stringify(
         {
           example: getExampleForField(f),
@@ -154,7 +155,7 @@ async function generateDto(
     }
 
     return `${swaggerDecorator}${validators.join("\n  ")}\n  ${name}${
-      optional ? "?" : "!"
+      isOptional ? "?" : "!"
     }: ${formatType(f.type)};`;
   };
 
@@ -169,7 +170,7 @@ async function generateDto(
 
     return `import {
   IsString, IsInt, IsBoolean, IsEmail, IsArray,
-  IsUUID, IsDateString, MinLength, IsOptional
+  IsUUID, IsDateString, MinLength, IsOptional, IsNumber
 } from 'class-validator';
 ${useSwagger ? "import { ApiProperty } from '@nestjs/swagger';" : ""}
 
@@ -200,7 +201,7 @@ export class ${entityName}Dto {
   if (entityName === "User") swaggerImports.push("ApiHideProperty");
 
   return `import {
-  IsOptional, IsString, IsInt, IsBoolean, IsEmail,
+  IsOptional, IsString, IsInt, IsNumber, IsBoolean, IsEmail,
   IsArray, IsUUID, IsDateString, MinLength, IsEnum
 } from 'class-validator';
 ${

package/utils/generators/application/dtoUpdater.js

@@ -3,6 +3,11 @@ const fs = require("fs");
 const { updateFile, capitalize } = require("../../userInput");
 
 async function patchDtoWithRelation(source, targetName, useSwagger, mode) {
+  const isDryRun = process.argv.includes("--dry-run");
+  if (isDryRun) {
+    console.log(`[DRY-RUN] Simulated: patch DTO for ${source} with relation to ${targetName}`);
+    return;
+  }
   let dtoPath;
   if (mode === "full") {
     dtoPath = `src/${source.toLowerCase()}/application/dtos/${source.toLowerCase()}.dto.ts`;

package/utils/generators/domain/entityUpdater.js

@@ -8,6 +8,11 @@ async function updateExistingEntityRelation(
   relationType,
   mode,
 ) {
+  const isDryRun = process.argv.includes("--dry-run");
+  if (isDryRun) {
+    console.log(`[DRY-RUN] Simulated: update existing entity relation between ${targetName} and ${newEntityName}`);
+    return;
+  }
   const targetLow = targetName.toLowerCase();
   const newCap = capitalize(newEntityName);
   const newLow = newEntityName.toLowerCase();

package/utils/generators/infrastructure/mapperUpdater.js

@@ -2,6 +2,11 @@ const { updateFile } = require("../../userInput");
 
 // src/utils/generators/infrastructure/mapperUpdater.js
 async function patchMapperWithRelation(source, targetName, mode = "full") {
+  const isDryRun = process.argv.includes("--dry-run");
+  if (isDryRun) {
+    console.log(`[DRY-RUN] Simulated: patch mapper for ${source} with relation to ${targetName}`);
+    return;
+  }
   const targetLow = targetName.toLowerCase();
 
   if (mode === "full") {