servcraft 0.1.6 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "servcraft",
-  "version": "0.1.6",
+  "version": "0.2.0",
   "description": "A modular, production-ready Node.js backend framework",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -51,7 +51,7 @@
     "@fastify/cookie": "^9.3.1",
     "@fastify/cors": "^9.0.1",
     "@fastify/helmet": "^11.1.1",
-    "@fastify/jwt": "^10.0.0",
+    "@fastify/jwt": "^7.2.4",
     "@fastify/multipart": "^8.3.0",
     "@fastify/rate-limit": "^9.1.0",
     "@fastify/swagger": "^8.15.0",

package/src/cli/commands/add-module.ts

@@ -16,6 +16,8 @@ import {
 import { EnvManager } from '../utils/env-manager.js';
 import { TemplateManager } from '../utils/template-manager.js';
 import { InteractivePrompt } from '../utils/interactive-prompt.js';
+import { DryRunManager } from '../utils/dry-run.js';
+import { ErrorTypes, displayError, validateProject } from '../utils/error-handler.js';
 
 // Pre-built modules that can be added
 const AVAILABLE_MODULES = {
@@ -160,10 +162,17 @@ export const addModuleCommand = new Command('add')
   .option('-f, --force', 'Force overwrite existing module')
   .option('-u, --update', 'Update existing module (smart merge)')
   .option('--skip-existing', 'Skip if module already exists')
+  .option('--dry-run', 'Preview changes without writing files')
   .action(
     async (
       moduleName?: string,
-      options?: { list?: boolean; force?: boolean; update?: boolean; skipExisting?: boolean }
+      options?: {
+        list?: boolean;
+        force?: boolean;
+        update?: boolean;
+        skipExisting?: boolean;
+        dryRun?: boolean;
+      }
     ) => {
       if (options?.list || !moduleName) {
         console.log(chalk.bold('\n📦 Available Modules:\n'));
@@ -180,11 +189,24 @@ export const addModuleCommand = new Command('add')
         return;
       }
 
+      // Enable dry-run mode if specified
+      const dryRun = DryRunManager.getInstance();
+      if (options?.dryRun) {
+        dryRun.enable();
+        console.log(chalk.yellow('\n⚠ DRY RUN MODE - No files will be written\n'));
+      }
+
       const module = AVAILABLE_MODULES[moduleName as keyof typeof AVAILABLE_MODULES];
 
       if (!module) {
-        error(`Unknown module: ${moduleName}`);
-        info('Run "servcraft add --list" to see available modules');
+        displayError(ErrorTypes.MODULE_NOT_FOUND(moduleName));
+        return;
+      }
+
+      // Validate project structure
+      const projectError = validateProject();
+      if (projectError) {
+        displayError(projectError);
         return;
       }
 
@@ -319,10 +341,17 @@ export const addModuleCommand = new Command('add')
           }
         }
 
-        console.log('\n📌 Next steps:');
-        info('  1. Configure environment variables in .env (if needed)');
-        info('  2. Register the module in your main app file');
-        info('  3. Run database migrations if needed');
+        if (!options?.dryRun) {
+          console.log('\n📌 Next steps:');
+          info('  1. Configure environment variables in .env (if needed)');
+          info('  2. Register the module in your main app file');
+          info('  3. Run database migrations if needed');
+        }
+
+        // Show dry-run summary if enabled
+        if (options?.dryRun) {
+          dryRun.printSummary();
+        }
       } catch (err) {
         spinner.fail('Failed to add module');
         error(err instanceof Error ? err.message : String(err));
@@ -620,34 +649,6 @@ export interface ${name.charAt(0).toUpperCase() + name.slice(1)}Data {
   }
 }
 
-/**
- * Helper: Get the servcraft package directory (works for both npm installed and local dev)
- */
-function getServercraftModulesDir(): string {
-  // Try node_modules first (when installed as dependency)
-  const nodeModulesPath = path.join(process.cwd(), 'node_modules', 'servcraft', 'src', 'modules');
-
-  // Try global npm path
-  const globalPath = path.join(
-    process.env.npm_config_prefix || '/usr/local',
-    'lib',
-    'node_modules',
-    'servcraft',
-    'src',
-    'modules'
-  );
-
-  // For CLI execution, use import.meta.url to find package location
-  const cliPath = path.resolve(
-    path.dirname(new URL(import.meta.url).pathname),
-    '..',
-    '..',
-    'modules'
-  );
-
-  return nodeModulesPath; // Primary path - will check existence in generateModuleFiles
-}
-
 /**
  * Helper: Find servcraft modules source directory
  */
@@ -683,7 +684,7 @@ async function findServercraftModules(): Promise<string | null> {
 async function generateModuleFiles(moduleName: string, moduleDir: string): Promise<void> {
   // Map module names to their directory names in servcraft
   const moduleNameMap: Record<string, string> = {
-    'users': 'user',
+    users: 'user',
     'rate-limit': 'rate-limit',
     'feature-flag': 'feature-flag',
     'api-versioning': 'api-versioning',

package/src/cli/commands/doctor.ts

@@ -0,0 +1,8 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+
+export const doctorCommand = new Command('doctor')
+  .description('Diagnose project configuration and dependencies')
+  .action(async () => {
+    console.log(chalk.bold.cyan('\nServCraft Doctor - Coming soon!\n'));
+  });

package/src/cli/commands/generate.ts

@@ -14,7 +14,26 @@ import {
   info,
   getModulesDir,
 } from '../utils/helpers.js';
+import { DryRunManager } from '../utils/dry-run.js';
+import chalk from 'chalk';
 import { parseFields, type FieldDefinition } from '../utils/field-parser.js';
+import { ErrorTypes, displayError } from '../utils/error-handler.js';
+
+// Helper to enable dry-run mode
+function enableDryRunIfNeeded(options: { dryRun?: boolean }): void {
+  const dryRun = DryRunManager.getInstance();
+  if (options.dryRun) {
+    dryRun.enable();
+    console.log(chalk.yellow('\n⚠ DRY RUN MODE - No files will be written\n'));
+  }
+}
+
+// Helper to show dry-run summary
+function showDryRunSummary(options: { dryRun?: boolean }): void {
+  if (options.dryRun) {
+    DryRunManager.getInstance().printSummary();
+  }
+}
 import { controllerTemplate } from '../templates/controller.js';
 import { serviceTemplate } from '../templates/service.js';
 import { repositoryTemplate } from '../templates/repository.js';
@@ -43,7 +62,9 @@ generateCommand
   .option('--prisma', 'Generate Prisma model suggestion')
   .option('--validator <type>', 'Validator type: zod, joi, yup', 'zod')
   .option('-i, --interactive', 'Interactive mode to define fields')
+  .option('--dry-run', 'Preview changes without writing files')
   .action(async (name: string, fieldsArgs: string[], options) => {
+    enableDryRunIfNeeded(options);
     let fields: FieldDefinition[] = [];
 
     // Parse fields from command line or interactive mode
@@ -161,6 +182,9 @@ generateCommand
         info(`  ${hasFields ? '3' : '4'}. Add the Prisma model to schema.prisma`);
         info(`  ${hasFields ? '4' : '5'}. Run: npm run db:migrate`);
       }
+
+      // Show dry-run summary if enabled
+      showDryRunSummary(options);
     } catch (err) {
       spinner.fail('Failed to generate module');
       error(err instanceof Error ? err.message : String(err));
@@ -173,7 +197,9 @@ generateCommand
   .alias('c')
   .description('Generate a controller')
   .option('-m, --module <module>', 'Target module name')
+  .option('--dry-run', 'Preview changes without writing files')
   .action(async (name: string, options) => {
+    enableDryRunIfNeeded(options);
     const spinner = ora('Generating controller...').start();
 
     try {
@@ -187,7 +213,7 @@ generateCommand
 
       if (await fileExists(filePath)) {
         spinner.stop();
-        error(`Controller "${kebabName}" already exists`);
+        displayError(ErrorTypes.FILE_ALREADY_EXISTS(`${kebabName}.controller.ts`));
         return;
       }
 
@@ -195,6 +221,7 @@ generateCommand
 
       spinner.succeed(`Controller "${pascalName}Controller" generated!`);
       success(`  src/modules/${moduleName}/${kebabName}.controller.ts`);
+      showDryRunSummary(options);
     } catch (err) {
       spinner.fail('Failed to generate controller');
       error(err instanceof Error ? err.message : String(err));
@@ -207,7 +234,9 @@ generateCommand
   .alias('s')
   .description('Generate a service')
   .option('-m, --module <module>', 'Target module name')
+  .option('--dry-run', 'Preview changes without writing files')
   .action(async (name: string, options) => {
+    enableDryRunIfNeeded(options);
     const spinner = ora('Generating service...').start();
 
     try {
@@ -229,6 +258,7 @@ generateCommand
 
       spinner.succeed(`Service "${pascalName}Service" generated!`);
       success(`  src/modules/${moduleName}/${kebabName}.service.ts`);
+      showDryRunSummary(options);
     } catch (err) {
       spinner.fail('Failed to generate service');
       error(err instanceof Error ? err.message : String(err));
@@ -241,7 +271,9 @@ generateCommand
   .alias('r')
   .description('Generate a repository')
   .option('-m, --module <module>', 'Target module name')
+  .option('--dry-run', 'Preview changes without writing files')
   .action(async (name: string, options) => {
+    enableDryRunIfNeeded(options);
     const spinner = ora('Generating repository...').start();
 
     try {
@@ -264,6 +296,7 @@ generateCommand
 
       spinner.succeed(`Repository "${pascalName}Repository" generated!`);
       success(`  src/modules/${moduleName}/${kebabName}.repository.ts`);
+      showDryRunSummary(options);
     } catch (err) {
       spinner.fail('Failed to generate repository');
       error(err instanceof Error ? err.message : String(err));
@@ -276,7 +309,9 @@ generateCommand
   .alias('t')
   .description('Generate types/interfaces')
   .option('-m, --module <module>', 'Target module name')
+  .option('--dry-run', 'Preview changes without writing files')
   .action(async (name: string, options) => {
+    enableDryRunIfNeeded(options);
     const spinner = ora('Generating types...').start();
 
     try {
@@ -297,6 +332,7 @@ generateCommand
 
       spinner.succeed(`Types for "${pascalName}" generated!`);
       success(`  src/modules/${moduleName}/${kebabName}.types.ts`);
+      showDryRunSummary(options);
     } catch (err) {
       spinner.fail('Failed to generate types');
       error(err instanceof Error ? err.message : String(err));
@@ -309,7 +345,9 @@ generateCommand
   .alias('v')
   .description('Generate validation schemas')
   .option('-m, --module <module>', 'Target module name')
+  .option('--dry-run', 'Preview changes without writing files')
   .action(async (name: string, options) => {
+    enableDryRunIfNeeded(options);
     const spinner = ora('Generating schemas...').start();
 
     try {
@@ -331,6 +369,7 @@ generateCommand
 
       spinner.succeed(`Schemas for "${pascalName}" generated!`);
       success(`  src/modules/${moduleName}/${kebabName}.schemas.ts`);
+      showDryRunSummary(options);
     } catch (err) {
       spinner.fail('Failed to generate schemas');
       error(err instanceof Error ? err.message : String(err));
@@ -342,7 +381,9 @@ generateCommand
   .command('routes <name>')
   .description('Generate routes')
   .option('-m, --module <module>', 'Target module name')
+  .option('--dry-run', 'Preview changes without writing files')
   .action(async (name: string, options) => {
+    enableDryRunIfNeeded(options);
     const spinner = ora('Generating routes...').start();
 
     try {
@@ -365,6 +406,7 @@ generateCommand
 
       spinner.succeed(`Routes for "${pascalName}" generated!`);
       success(`  src/modules/${moduleName}/${kebabName}.routes.ts`);
+      showDryRunSummary(options);
     } catch (err) {
       spinner.fail('Failed to generate routes');
       error(err instanceof Error ? err.message : String(err));