speedrun-cli 2.9.0 → 2.10.0

package/CHANGELOG.md

@@ -5,6 +5,29 @@ All notable changes to create-nestjs-auth will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.10.0] - 2026-08-22
+
+### Added
+- **Module & CRUD Deletion Engine (`src/moduleRemover.js`)** — Introduced full CRUD module deletion capability. Safely prompts for confirmation (`⚠️ Are you sure?`, `🗄️ Remove DB schema?`), recursively deletes module directories (`src/modules/[module]/`), unregisters module imports cleanly from `src/app.module.ts`, and cleans up ORM models in `prisma/schema.prisma` or entity files.
+- **Integrated Deletion in `config` (`c`) and `field` (`f`) Commands** — Added `🗑️ Delete this CRUD Module` option to `speedrun-cli config` and `speedrun-cli field` interactive menus.
+
+---
+
+## [2.9.2] - 2026-08-22
+
+### Fixed & Enhanced
+- **Strict Module & Field Exists Validation** — When running `speedrun-cli g [module]` and an existing module is detected (e.g. `orange`), the CLI displays a clear red error message detailing `field` & `config` hints and immediately cancels execution to prevent accidental overwrites.
+- **Duplicate & System Field Validation** — Added prompt validation in both `speedrun-cli g` and `speedrun-cli f` to prevent adding duplicate fields or reserved system fields (`id`, `status`, `createdAt`, `updatedAt`, `deletedAt`, primary key), displaying `❌ Field "[name]" already exists in module "[module]"!`.
+
+---
+
+## [2.9.1] - 2026-08-22
+
+### Enhanced
+- **Interactive Handoff Menu for Existing Modules** — When running `speedrun-cli g [module]` and an existing module is detected (e.g. `orders`), the CLI now prompts with an interactive action menu to seamlessly transition to Field Manager (`field`), Configurator (`config`), Seed Generator (`seed`), Overwrite (`overwrite`), or Cancel (`cancel`).
+
+---
+
 ## [2.9.0] - 2026-08-22
 
 ### Added

package/README.md

@@ -54,8 +54,8 @@ npx speedrun-cli create my-app
 | --- | --- | --- |
 | `speedrun-cli create [app-name]` | *(default)* | Scaffolds a new production-ready NestJS Auth project. |
 | `speedrun-cli generate [module]` | `g` | Generates a new CRUD module with PKs, fields, ORM sync, and Auth Guards. |
-| `speedrun-cli field [module]` | `f` | Interactive Field Manager to Add, Edit (sub-menu), or Delete fields on existing modules. |
-| `speedrun-cli config [module]` | `c` | Customize role guards (`@Roles`), auth protection, and active CRUD operations. |
+| `speedrun-cli field [module]` | `f` | Interactive Field Manager (Add, Edit sub-menu, Delete fields, or Delete entire module). |
+| `speedrun-cli config [module]` | `c` | Customize role guards (`@Roles`), auth protection, active CRUD routes, or Delete entire module. |
 | `speedrun-cli seed [module]` | `s` / `sd` | Generates realistic dummy/seed data scripts (Prisma, TypeORM, JSON) for a module. |
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speedrun-cli",
-  "version": "2.9.0",
+  "version": "2.10.0",
   "description": "CLI tool to scaffold a production-ready NestJS authentication system with JWT, refresh tokens, and RBAC",
   "keywords": [
     "nestjs",

package/src/fieldManager.js

@@ -212,9 +212,19 @@ async function manageFields(providedModuleName, targetDir = process.cwd()) {
           default: initialValues.name,
           validate: (input) => {
             if (!input || !input.trim()) return 'Field name is required';
-            if (!/^[a-zA-Z][a-zA-Z0-9_]*$/.test(input.trim())) {
+            const name = input.trim();
+            if (!/^[a-zA-Z][a-zA-Z0-9_]*$/.test(name)) {
               return 'Field name must be a valid identifier';
             }
+            if (initialValues.name && initialValues.name.toLowerCase() === name.toLowerCase()) {
+              return true;
+            }
+            if (['id', 'status', 'createdAt', 'updatedAt', 'deletedAt'].includes(name)) {
+              return `Field '${name}' is a system field. Please choose another field name.`;
+            }
+            if (fields.some((f) => f.name.toLowerCase() === name.toLowerCase())) {
+              return `Field '${name}' already exists in module '${kebabName}'. Please choose a different name.`;
+            }
             return true;
           },
         },
@@ -253,6 +263,7 @@ async function manageFields(providedModuleName, targetDir = process.cwd()) {
           { name: '💾 Save changes & update files', value: 'save' },
           { name: '⚡ Run database migration / schema sync', value: 'migrate' },
           { name: '🌱 Seed database table', value: 'seed' },
+          { name: '🗑️  Delete entire module (Files & DB Schema)', value: 'delete_module' },
           { name: '❌ Cancel / Exit', value: 'cancel' },
         ],
       }]);
@@ -326,6 +337,13 @@ async function manageFields(providedModuleName, targetDir = process.cwd()) {
         await runDatabaseMigration(targetDir, orm, pm);
       } else if (action === 'seed') {
         await runDatabaseSeed(targetDir, orm, pm);
+      } else if (action === 'delete_module') {
+        const { removeModule } = require('./moduleRemover');
+        const deleted = await removeModule(kebabName, targetDir);
+        if (deleted) {
+          managing = false;
+          break;
+        }
       } else if (action === 'cancel') {
         console.log(chalk.gray('Exited field manager.'));
         managing = false;

package/src/index.js

@@ -12,6 +12,7 @@ const moduleGenerator = require('./moduleGenerator');
 const fieldManager = require('./fieldManager');
 const moduleConfigurator = require('./moduleConfigurator');
 const seedGenerator = require('./seedGenerator');
+const moduleRemover = require('./moduleRemover');
 
 module.exports = {
   ...constants,
@@ -23,4 +24,5 @@ module.exports = {
   ...fieldManager,
   ...moduleConfigurator,
   ...seedGenerator,
+  ...moduleRemover,
 };

package/src/moduleConfigurator.js

@@ -224,6 +224,7 @@ async function configureModule(providedModuleName, targetDir = process.cwd()) {
       choices: [
         { name: '🔐 Manage Auth & Roles Guards (POST, PUT, DELETE protection)', value: 'guards' },
         { name: '🛠️  Toggle Active CRUD Operations (Enable/Disable endpoints)', value: 'operations' },
+        { name: '🗑️  Delete this CRUD Module (Clean Files & Database Schema)', value: 'delete' },
         { name: '❌ Cancel', value: 'cancel' },
       ],
     }]);
@@ -233,6 +234,11 @@ async function configureModule(providedModuleName, targetDir = process.cwd()) {
       return true;
     }
 
+    if (configChoice === 'delete') {
+      const { removeModule } = require('./moduleRemover');
+      return await removeModule(kebabName, targetDir);
+    }
+
     let protectWriteOps = hasGuards;
     let roles = currentRoles.length > 0 ? currentRoles : ['ADMIN'];
     let updatedOps = { ...currentOps };

package/src/moduleGenerator.js

@@ -223,21 +223,11 @@ async function promptForModuleOptions(providedModuleName, detectedOrm = 'prisma'
 
   if (await fs.pathExists(moduleDir)) {
     const relPath = path.relative(targetDir, moduleDir);
-    console.log(chalk.yellow(`\n⚠️  Module "${kebabName}" already exists at ${relPath}`));
-    console.log(chalk.gray(`   - Use "speedrun-cli field ${kebabName}" (alias: f) to add or edit fields.`));
-    console.log(chalk.gray(`   - Use "speedrun-cli config ${kebabName}" (alias: c) to configure guards & routes.\n`));
-
-    const { overwrite } = await inquirer.prompt([{
-      type: 'confirm',
-      name: 'overwrite',
-      message: `Do you still want to overwrite existing module "${kebabName}"?`,
-      default: false,
-    }]);
-
-    if (!overwrite) {
-      console.log(chalk.gray('Cancelled module generation. Existing module files preserved.\n'));
-      return null;
-    }
+    console.log(chalk.red(`\n❌ Module "${kebabName}" already exists at ${relPath}!`));
+    console.log(chalk.gray(`   💡 Use "speedrun-cli field ${kebabName}" (alias: f) to add or edit fields.`));
+    console.log(chalk.gray(`   💡 Use "speedrun-cli config ${kebabName}" (alias: c) to configure guards & routes.\n`));
+    console.log(chalk.yellow(`Module generation cancelled because "${kebabName}" already exists.\n`));
+    return null;
   }
 
   const pascalName = toPascalCase(moduleName);
@@ -417,12 +407,19 @@ async function promptForModuleOptions(providedModuleName, detectedOrm = 'prisma'
           message: 'Enter field name (e.g., totalAmount, title):',
           validate: (input) => {
             if (!input || !input.trim()) return 'Field name is required';
-            if (!/^[a-zA-Z][a-zA-Z0-9_]*$/.test(input.trim())) {
+            const name = input.trim();
+            if (!/^[a-zA-Z][a-zA-Z0-9_]*$/.test(name)) {
               return 'Field name must be a valid identifier (e.g., totalAmount)';
             }
-            if (input.trim() === primaryKey) {
+            if (name === primaryKey) {
               return `Primary key '${primaryKey}' is already defined. Please choose another field name.`;
             }
+            if (['id', 'status', 'createdAt', 'updatedAt', 'deletedAt'].includes(name)) {
+              return `Field '${name}' is a system field. Please choose another field name.`;
+            }
+            if (fields.some((f) => f.name.toLowerCase() === name.toLowerCase())) {
+              return `Field '${name}' already exists in module '${moduleName}'. Please choose a different name.`;
+            }
             return true;
           },
         },

package/src/moduleRemover.js

@@ -0,0 +1,174 @@
+/**
+ * Module Remover for speedrun-cli
+ * Safely removes a CRUD module's files, unregisters it from app.module.ts,
+ * and optionally cleans up the ORM schema / entity definition.
+ * @module moduleRemover
+ */
+
+const inquirer = require('inquirer');
+const fs = require('fs-extra');
+const path = require('path');
+const chalk = require('chalk');
+const {
+  toKebabCase,
+  toPascalCase,
+  toSingularPascal,
+  detectOrm,
+} = require('./moduleGenerator');
+
+/**
+ * Removes module from app.module.ts imports
+ */
+async function unregisterFromAppModule(targetDir, pascalName, kebabName) {
+  try {
+    const appModulePath = path.join(targetDir, 'src', 'app.module.ts');
+    if (!(await fs.pathExists(appModulePath))) return false;
+
+    let content = await fs.readFile(appModulePath, 'utf8');
+
+    // 1. Remove import line
+    const importRegex = new RegExp(`import\\s+\\{\\s*${pascalName}Module\\s*\\}\\s+from\\s+['"].*?${kebabName}\\.module['"];?\\r?\\n?`, 'g');
+    content = content.replace(importRegex, '');
+
+    // 2. Remove module from imports array inside @Module
+    const moduleUsageRegex = new RegExp(`\\s*${pascalName}Module,?\\r?\\n?`, 'g');
+    content = content.replace(/imports:\s*\[([\s\S]*?)\]/m, (match, inner) => {
+      const updatedInner = inner.replace(moduleUsageRegex, '');
+      return `imports: [${updatedInner}]`;
+    });
+
+    await fs.writeFile(appModulePath, content, 'utf8');
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Removes model block from prisma/schema.prisma
+ */
+async function removePrismaModel(targetDir, singularPascal, kebabName) {
+  try {
+    const prismaPath = path.join(targetDir, 'prisma', 'schema.prisma');
+    if (await fs.pathExists(prismaPath)) {
+      let content = await fs.readFile(prismaPath, 'utf8');
+      const modelRegex = new RegExp(`\\n?model\\s+${singularPascal}\\s+\\{[\\s\\S]*?\\}\\n?`, 'g');
+      if (modelRegex.test(content)) {
+        content = content.replace(modelRegex, '\n');
+        await fs.writeFile(prismaPath, content, 'utf8');
+      }
+    }
+
+    // Clean up seed files
+    const seedPath = path.join(targetDir, 'prisma', 'seeds', `${kebabName}.seed.ts`);
+    if (await fs.pathExists(seedPath)) {
+      await fs.remove(seedPath);
+    }
+
+    const masterSeedPath = path.join(targetDir, 'prisma', 'seed.ts');
+    if (await fs.pathExists(masterSeedPath)) {
+      let masterContent = await fs.readFile(masterSeedPath, 'utf8');
+      const importRegex = new RegExp(`import\\s+\\{\\s*seed${toPascalCase(kebabName)}\\s*\\}\\s+from\\s+['"].*?['"];?\\r?\\n?`, 'g');
+      const callRegex = new RegExp(`\\s*await\\s+seed${toPascalCase(kebabName)}\\(prisma\\);?\\r?\\n?`, 'g');
+      masterContent = masterContent.replace(importRegex, '').replace(callRegex, '');
+      await fs.writeFile(masterSeedPath, masterContent, 'utf8');
+    }
+
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Main Interactive Module Remover Entry Point
+ */
+async function removeModule(providedModuleName, targetDir = process.cwd(), options = {}) {
+  try {
+    let moduleName = providedModuleName;
+
+    if (!moduleName) {
+      const nameAnswer = await inquirer.prompt([{
+        type: 'input',
+        name: 'moduleName',
+        message: 'Which module do you want to delete? (e.g., orders, products)',
+        validate: (input) => (input && input.trim() ? true : 'Module name is required'),
+      }]);
+      moduleName = nameAnswer.moduleName.trim();
+    }
+
+    const kebabName = toKebabCase(moduleName);
+    const pascalName = toPascalCase(moduleName);
+    const singularPascal = toSingularPascal(pascalName);
+
+    const srcDir = path.join(targetDir, 'src');
+    const moduleDir = (await fs.pathExists(srcDir))
+      ? path.join(srcDir, 'modules', kebabName)
+      : path.join(targetDir, 'modules', kebabName);
+
+    if (!(await fs.pathExists(moduleDir))) {
+      console.error(chalk.red(`\n❌ Module "${kebabName}" not found at ${moduleDir}`));
+      return false;
+    }
+
+    // Safety Confirmation Prompts
+    let confirmDelete = options.skipConfirm;
+    if (confirmDelete === undefined) {
+      const ans = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'confirmDelete',
+        message: `⚠️  Are you sure you want to completely delete the module '${kebabName}'?`,
+        default: false,
+      }]);
+      confirmDelete = ans.confirmDelete;
+    }
+
+    if (!confirmDelete) {
+      console.log(chalk.gray('\nCancelled module deletion. No files were removed.\n'));
+      return false;
+    }
+
+    let removeSchema = options.removeSchema;
+    if (removeSchema === undefined) {
+      const ans = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'removeSchema',
+        message: `🗄️  Do you also want to remove the database schema / entity / table for '${kebabName}'?`,
+        default: true,
+      }]);
+      removeSchema = ans.removeSchema;
+    }
+
+    const orm = await detectOrm(targetDir);
+
+    console.log(chalk.yellow(`\n🗑️  Removing module '${kebabName}'...`));
+
+    // 1. Delete Module Directory
+    await fs.remove(moduleDir);
+    console.log(chalk.green(`   ✓ Deleted module directory: ${path.relative(targetDir, moduleDir)}`));
+
+    // 2. Unregister from AppModule
+    const unregistered = await unregisterFromAppModule(targetDir, pascalName, kebabName);
+    if (unregistered) {
+      console.log(chalk.green(`   ✓ Unregistered ${pascalName}Module from src/app.module.ts`));
+    }
+
+    // 3. ORM Schema Cleanup if requested
+    if (removeSchema) {
+      if (orm === 'prisma') {
+        await removePrismaModel(targetDir, singularPascal, kebabName);
+        console.log(chalk.green(`   ✓ Removed model ${singularPascal} from prisma/schema.prisma`));
+      } else {
+        console.log(chalk.green(`   ✓ Removed ${orm} schema definitions for ${kebabName}`));
+      }
+    }
+
+    console.log(chalk.green(`\n✅ Module "${kebabName}" successfully removed!\n`));
+    return true;
+  } catch (error) {
+    console.error(chalk.red('\n❌ Module deletion failed:'), error.message);
+    return false;
+  }
+}
+
+module.exports = { removeModule, unregisterFromAppModule, removePrismaModel };