npm - servcraft - Versions diffs - 0.1.7 → 0.2.0 - Mend

servcraft 0.1.7 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (17) hide show

package/README.md +20 -1
package/ROADMAP.md +15 -8
package/dist/cli/index.cjs +900 -174
package/dist/cli/index.cjs.map +1 -1
package/dist/cli/index.js +919 -172
package/dist/cli/index.js.map +1 -1
package/package.json +1 -1
package/src/cli/commands/add-module.ts +36 -7
package/src/cli/commands/doctor.ts +8 -0
package/src/cli/commands/generate.ts +43 -1
package/src/cli/commands/init.ts +29 -10
package/src/cli/commands/list.ts +274 -0
package/src/cli/commands/remove.ts +102 -0
package/src/cli/index.ts +12 -0
package/src/cli/utils/dry-run.ts +155 -0
package/src/cli/utils/error-handler.ts +184 -0
package/src/cli/utils/helpers.ts +13 -0

package/dist/cli/index.cjs CHANGED Viewed

@@ -6,6 +6,13 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
     for (let key of __getOwnPropNames(from))
@@ -22,27 +29,294 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 // node_modules/tsup/assets/cjs_shims.js
-var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
-var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
+var getImportMetaUrl, importMetaUrl;
+var init_cjs_shims = __esm({
+  "node_modules/tsup/assets/cjs_shims.js"() {
+    "use strict";
+    getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
+    importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
+  }
+});
+// src/cli/utils/error-handler.ts
+var error_handler_exports = {};
+__export(error_handler_exports, {
+  ErrorTypes: () => ErrorTypes,
+  ServCraftError: () => ServCraftError,
+  displayError: () => displayError,
+  handleSystemError: () => handleSystemError,
+  validateProject: () => validateProject
+});
+function displayError(error2) {
+  console.error("\n" + import_chalk4.default.red.bold("\u2717 Error: ") + import_chalk4.default.red(error2.message));
+  if (error2 instanceof ServCraftError) {
+    if (error2.suggestions.length > 0) {
+      console.log("\n" + import_chalk4.default.yellow.bold("\u{1F4A1} Suggestions:"));
+      error2.suggestions.forEach((suggestion) => {
+        console.log(import_chalk4.default.yellow("  \u2022 ") + suggestion);
+      });
+    }
+    if (error2.docsLink) {
+      console.log("\n" + import_chalk4.default.blue.bold("\u{1F4DA} Documentation: ") + import_chalk4.default.blue.underline(error2.docsLink));
+    }
+  }
+  console.log();
+}
+function handleSystemError(err) {
+  switch (err.code) {
+    case "ENOENT":
+      return new ServCraftError(
+        `File or directory not found: ${err.path}`,
+        [`Check if the path exists`, `Create the directory first`]
+      );
+    case "EACCES":
+    case "EPERM":
+      return new ServCraftError(
+        `Permission denied: ${err.path}`,
+        [
+          `Check file permissions`,
+          `Try running with elevated privileges (not recommended)`,
+          `Change ownership of the directory`
+        ]
+      );
+    case "EEXIST":
+      return new ServCraftError(
+        `File or directory already exists: ${err.path}`,
+        [`Use a different name`, `Remove the existing file first`, `Use ${import_chalk4.default.cyan("--force")} to overwrite`]
+      );
+    case "ENOTDIR":
+      return new ServCraftError(
+        `Not a directory: ${err.path}`,
+        [`Check the path`, `A file exists where a directory is expected`]
+      );
+    case "EISDIR":
+      return new ServCraftError(
+        `Is a directory: ${err.path}`,
+        [`Cannot perform this operation on a directory`, `Did you mean to target a file?`]
+      );
+    default:
+      return new ServCraftError(
+        err.message,
+        [`Check system error code: ${err.code}`, `Review the error details above`]
+      );
+  }
+}
+function validateProject() {
+  try {
+    const fs10 = require("fs");
+    const path11 = require("path");
+    if (!fs10.existsSync("package.json")) {
+      return ErrorTypes.NOT_IN_PROJECT();
+    }
+    const packageJson = JSON.parse(fs10.readFileSync("package.json", "utf-8"));
+    if (!packageJson.dependencies?.fastify) {
+      return new ServCraftError(
+        "This does not appear to be a ServCraft project",
+        [
+          `ServCraft projects require Fastify`,
+          `Run ${import_chalk4.default.cyan("servcraft init")} to create a new project`
+        ]
+      );
+    }
+    return null;
+  } catch (err) {
+    return new ServCraftError(
+      "Failed to validate project",
+      [`Ensure you are in the project root directory`, `Check if ${import_chalk4.default.yellow("package.json")} is valid`]
+    );
+  }
+}
+var import_chalk4, ServCraftError, ErrorTypes;
+var init_error_handler = __esm({
+  "src/cli/utils/error-handler.ts"() {
+    "use strict";
+    init_cjs_shims();
+    import_chalk4 = __toESM(require("chalk"), 1);
+    ServCraftError = class extends Error {
+      suggestions;
+      docsLink;
+      constructor(message, suggestions = [], docsLink) {
+        super(message);
+        this.name = "ServCraftError";
+        this.suggestions = suggestions;
+        this.docsLink = docsLink;
+      }
+    };
+    ErrorTypes = {
+      MODULE_NOT_FOUND: (moduleName) => new ServCraftError(
+        `Module "${moduleName}" not found`,
+        [
+          `Run ${import_chalk4.default.cyan("servcraft list")} to see available modules`,
+          `Check the spelling of the module name`,
+          `Visit ${import_chalk4.default.blue("https://github.com/Le-Sourcier/servcraft#modules")} for module list`
+        ],
+        "https://github.com/Le-Sourcier/servcraft#add-pre-built-modules"
+      ),
+      MODULE_ALREADY_EXISTS: (moduleName) => new ServCraftError(
+        `Module "${moduleName}" already exists`,
+        [
+          `Use ${import_chalk4.default.cyan("servcraft add " + moduleName + " --force")} to overwrite`,
+          `Use ${import_chalk4.default.cyan("servcraft add " + moduleName + " --update")} to update`,
+          `Use ${import_chalk4.default.cyan("servcraft add " + moduleName + " --skip-existing")} to skip`
+        ]
+      ),
+      NOT_IN_PROJECT: () => new ServCraftError(
+        "Not in a ServCraft project directory",
+        [
+          `Run ${import_chalk4.default.cyan("servcraft init")} to create a new project`,
+          `Navigate to your ServCraft project directory`,
+          `Check if ${import_chalk4.default.yellow("package.json")} exists`
+        ],
+        "https://github.com/Le-Sourcier/servcraft#initialize-project"
+      ),
+      FILE_ALREADY_EXISTS: (fileName) => new ServCraftError(
+        `File "${fileName}" already exists`,
+        [
+          `Use ${import_chalk4.default.cyan("--force")} flag to overwrite`,
+          `Choose a different name`,
+          `Delete the existing file first`
+        ]
+      ),
+      INVALID_DATABASE: (database) => new ServCraftError(
+        `Invalid database type: "${database}"`,
+        [
+          `Valid options: ${import_chalk4.default.cyan("postgresql, mysql, sqlite, mongodb, none")}`,
+          `Use ${import_chalk4.default.cyan("servcraft init --db postgresql")} for PostgreSQL`
+        ]
+      ),
+      INVALID_VALIDATOR: (validator) => new ServCraftError(
+        `Invalid validator type: "${validator}"`,
+        [`Valid options: ${import_chalk4.default.cyan("zod, joi, yup")}`, `Default is ${import_chalk4.default.cyan("zod")}`]
+      ),
+      MISSING_DEPENDENCY: (dependency, command) => new ServCraftError(
+        `Missing dependency: "${dependency}"`,
+        [`Run ${import_chalk4.default.cyan(command)} to install`, `Check your ${import_chalk4.default.yellow("package.json")}`]
+      ),
+      INVALID_FIELD_FORMAT: (field) => new ServCraftError(
+        `Invalid field format: "${field}"`,
+        [
+          `Expected format: ${import_chalk4.default.cyan("name:type")}`,
+          `Example: ${import_chalk4.default.cyan("name:string age:number isActive:boolean")}`,
+          `Supported types: string, number, boolean, date`
+        ]
+      ),
+      GIT_NOT_INITIALIZED: () => new ServCraftError(
+        "Git repository not initialized",
+        [
+          `Run ${import_chalk4.default.cyan("git init")} to initialize git`,
+          `This is required for some ServCraft features`
+        ]
+      )
+    };
+  }
+});
 // src/cli/index.ts
-var import_commander6 = require("commander");
+init_cjs_shims();
+var import_commander9 = require("commander");
 // src/cli/commands/init.ts
+init_cjs_shims();
 var import_commander = require("commander");
-var import_path2 = __toESM(require("path"), 1);
+var import_path3 = __toESM(require("path"), 1);
 var import_promises2 = __toESM(require("fs/promises"), 1);
 var import_ora = __toESM(require("ora"), 1);
 var import_inquirer = __toESM(require("inquirer"), 1);
-var import_chalk2 = __toESM(require("chalk"), 1);
+var import_chalk3 = __toESM(require("chalk"), 1);
 var import_child_process = require("child_process");
 // src/cli/utils/helpers.ts
+init_cjs_shims();
 var import_promises = __toESM(require("fs/promises"), 1);
-var import_path = __toESM(require("path"), 1);
+var import_path2 = __toESM(require("path"), 1);
+var import_chalk2 = __toESM(require("chalk"), 1);
+// src/cli/utils/dry-run.ts
+init_cjs_shims();
 var import_chalk = __toESM(require("chalk"), 1);
+var import_path = __toESM(require("path"), 1);
+var DryRunManager = class _DryRunManager {
+  static instance;
+  enabled = false;
+  operations = [];
+  constructor() {
+  }
+  static getInstance() {
+    if (!_DryRunManager.instance) {
+      _DryRunManager.instance = new _DryRunManager();
+    }
+    return _DryRunManager.instance;
+  }
+  enable() {
+    this.enabled = true;
+    this.operations = [];
+  }
+  disable() {
+    this.enabled = false;
+    this.operations = [];
+  }
+  isEnabled() {
+    return this.enabled;
+  }
+  addOperation(operation) {
+    if (this.enabled) {
+      this.operations.push(operation);
+    }
+  }
+  getOperations() {
+    return [...this.operations];
+  }
+  printSummary() {
+    if (!this.enabled || this.operations.length === 0) {
+      return;
+    }
+    console.log(import_chalk.default.bold.yellow("\n\u{1F4CB} Dry Run - Preview of changes:\n"));
+    console.log(import_chalk.default.gray("No files will be written. Remove --dry-run to apply changes.\n"));
+    const createOps = this.operations.filter((op) => op.type === "create");
+    const modifyOps = this.operations.filter((op) => op.type === "modify");
+    const deleteOps = this.operations.filter((op) => op.type === "delete");
+    if (createOps.length > 0) {
+      console.log(import_chalk.default.green.bold(`
+\u2713 Files to be created (${createOps.length}):`));
+      createOps.forEach((op) => {
+        const size = op.content ? `${op.content.length} bytes` : "unknown size";
+        console.log(`  ${import_chalk.default.green("+")} ${import_chalk.default.cyan(op.path)} ${import_chalk.default.gray(`(${size})`)}`);
+      });
+    }
+    if (modifyOps.length > 0) {
+      console.log(import_chalk.default.yellow.bold(`
+~ Files to be modified (${modifyOps.length}):`));
+      modifyOps.forEach((op) => {
+        console.log(`  ${import_chalk.default.yellow("~")} ${import_chalk.default.cyan(op.path)}`);
+      });
+    }
+    if (deleteOps.length > 0) {
+      console.log(import_chalk.default.red.bold(`
+- Files to be deleted (${deleteOps.length}):`));
+      deleteOps.forEach((op) => {
+        console.log(`  ${import_chalk.default.red("-")} ${import_chalk.default.cyan(op.path)}`);
+      });
+    }
+    console.log(import_chalk.default.gray("\n" + "\u2500".repeat(60)));
+    console.log(
+      import_chalk.default.bold(`  Total operations: ${this.operations.length}`) + import_chalk.default.gray(
+        ` (${createOps.length} create, ${modifyOps.length} modify, ${deleteOps.length} delete)`
+      )
+    );
+    console.log(import_chalk.default.gray("\u2500".repeat(60)));
+    console.log(import_chalk.default.yellow("\n\u26A0 This was a dry run. No files were created or modified."));
+    console.log(import_chalk.default.gray("  Remove --dry-run to apply these changes.\n"));
+  }
+  // Helper to format file path relative to cwd
+  relativePath(filePath) {
+    return import_path.default.relative(process.cwd(), filePath);
+  }
+};
+// src/cli/utils/helpers.ts
 function toPascalCase(str) {
   return str.split(/[-_\s]+/).map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join("");
 }
@@ -74,39 +348,54 @@ async function ensureDir(dirPath) {
   await import_promises.default.mkdir(dirPath, { recursive: true });
 }
 async function writeFile(filePath, content) {
-  await ensureDir(import_path.default.dirname(filePath));
+  const dryRun = DryRunManager.getInstance();
+  if (dryRun.isEnabled()) {
+    dryRun.addOperation({
+      type: "create",
+      path: dryRun.relativePath(filePath),
+      content,
+      size: content.length
+    });
+    return;
+  }
+  await ensureDir(import_path2.default.dirname(filePath));
   await import_promises.default.writeFile(filePath, content, "utf-8");
 }
 function success(message) {
-  console.log(import_chalk.default.green("\u2713"), message);
+  console.log(import_chalk2.default.green("\u2713"), message);
 }
 function error(message) {
-  console.error(import_chalk.default.red("\u2717"), message);
+  console.error(import_chalk2.default.red("\u2717"), message);
 }
 function warn(message) {
-  console.log(import_chalk.default.yellow("\u26A0"), message);
+  console.log(import_chalk2.default.yellow("\u26A0"), message);
 }
 function info(message) {
-  console.log(import_chalk.default.blue("\u2139"), message);
+  console.log(import_chalk2.default.blue("\u2139"), message);
 }
 function getProjectRoot() {
   return process.cwd();
 }
 function getSourceDir() {
-  return import_path.default.join(getProjectRoot(), "src");
+  return import_path2.default.join(getProjectRoot(), "src");
 }
 function getModulesDir() {
-  return import_path.default.join(getSourceDir(), "modules");
+  return import_path2.default.join(getSourceDir(), "modules");
 }
 // src/cli/commands/init.ts
-var initCommand = new import_commander.Command("init").alias("new").description("Initialize a new Servcraft project").argument("[name]", "Project name").option("-y, --yes", "Skip prompts and use defaults").option("--ts, --typescript", "Use TypeScript (default)").option("--js, --javascript", "Use JavaScript").option("--esm", "Use ES Modules (import/export) - default").option("--cjs, --commonjs", "Use CommonJS (require/module.exports)").option("--db <database>", "Database type (postgresql, mysql, sqlite, mongodb, none)").action(
+var initCommand = new import_commander.Command("init").alias("new").description("Initialize a new Servcraft project").argument("[name]", "Project name").option("-y, --yes", "Skip prompts and use defaults").option("--ts, --typescript", "Use TypeScript (default)").option("--js, --javascript", "Use JavaScript").option("--esm", "Use ES Modules (import/export) - default").option("--cjs, --commonjs", "Use CommonJS (require/module.exports)").option("--db <database>", "Database type (postgresql, mysql, sqlite, mongodb, none)").option("--dry-run", "Preview changes without writing files").action(
   async (name, cmdOptions) => {
+    const dryRun = DryRunManager.getInstance();
+    if (cmdOptions?.dryRun) {
+      dryRun.enable();
+      console.log(import_chalk3.default.yellow("\n\u26A0 DRY RUN MODE - No files will be written\n"));
+    }
     console.log(
-      import_chalk2.default.blue(`
+      import_chalk3.default.blue(`
 \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
 \u2551                                           \u2551
-\u2551   ${import_chalk2.default.bold("\u{1F680} Servcraft Project Generator")}          \u2551
+\u2551   ${import_chalk3.default.bold("\u{1F680} Servcraft Project Generator")}          \u2551
 \u2551                                           \u2551
 \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
 `)
@@ -201,7 +490,7 @@ var initCommand = new import_commander.Command("init").alias("new").description(
         orm: db === "mongodb" ? "mongoose" : db === "none" ? "none" : "prisma"
       };
     }
-    const projectDir = import_path2.default.resolve(process.cwd(), options.name);
+    const projectDir = import_path3.default.resolve(process.cwd(), options.name);
     const spinner = (0, import_ora.default)("Creating project...").start();
     try {
       try {
@@ -215,21 +504,21 @@ var initCommand = new import_commander.Command("init").alias("new").description(
       spinner.text = "Generating project files...";
       const packageJson = generatePackageJson(options);
       await writeFile(
-        import_path2.default.join(projectDir, "package.json"),
+        import_path3.default.join(projectDir, "package.json"),
         JSON.stringify(packageJson, null, 2)
       );
       if (options.language === "typescript") {
-        await writeFile(import_path2.default.join(projectDir, "tsconfig.json"), generateTsConfig(options));
-        await writeFile(import_path2.default.join(projectDir, "tsup.config.ts"), generateTsupConfig(options));
+        await writeFile(import_path3.default.join(projectDir, "tsconfig.json"), generateTsConfig(options));
+        await writeFile(import_path3.default.join(projectDir, "tsup.config.ts"), generateTsupConfig(options));
       } else {
-        await writeFile(import_path2.default.join(projectDir, "jsconfig.json"), generateJsConfig(options));
+        await writeFile(import_path3.default.join(projectDir, "jsconfig.json"), generateJsConfig(options));
       }
-      await writeFile(import_path2.default.join(projectDir, ".env.example"), generateEnvExample(options));
-      await writeFile(import_path2.default.join(projectDir, ".env"), generateEnvExample(options));
-      await writeFile(import_path2.default.join(projectDir, ".gitignore"), generateGitignore());
-      await writeFile(import_path2.default.join(projectDir, "Dockerfile"), generateDockerfile(options));
+      await writeFile(import_path3.default.join(projectDir, ".env.example"), generateEnvExample(options));
+      await writeFile(import_path3.default.join(projectDir, ".env"), generateEnvExample(options));
+      await writeFile(import_path3.default.join(projectDir, ".gitignore"), generateGitignore());
+      await writeFile(import_path3.default.join(projectDir, "Dockerfile"), generateDockerfile(options));
       await writeFile(
-        import_path2.default.join(projectDir, "docker-compose.yml"),
+        import_path3.default.join(projectDir, "docker-compose.yml"),
         generateDockerCompose(options)
       );
       const ext = options.language === "typescript" ? "ts" : options.moduleSystem === "esm" ? "js" : "cjs";
@@ -250,59 +539,63 @@ var initCommand = new import_commander.Command("init").alias("new").description(
         dirs.push("src/database/models");
       }
       for (const dir of dirs) {
-        await ensureDir(import_path2.default.join(projectDir, dir));
+        await ensureDir(import_path3.default.join(projectDir, dir));
       }
-      await writeFile(import_path2.default.join(projectDir, `src/index.${ext}`), generateEntryFile(options));
+      await writeFile(import_path3.default.join(projectDir, `src/index.${ext}`), generateEntryFile(options));
       await writeFile(
-        import_path2.default.join(projectDir, `src/core/server.${ext}`),
+        import_path3.default.join(projectDir, `src/core/server.${ext}`),
         generateServerFile(options)
       );
       await writeFile(
-        import_path2.default.join(projectDir, `src/core/logger.${ext}`),
+        import_path3.default.join(projectDir, `src/core/logger.${ext}`),
         generateLoggerFile(options)
       );
       await writeFile(
-        import_path2.default.join(projectDir, `src/config/index.${ext}`),
+        import_path3.default.join(projectDir, `src/config/index.${ext}`),
         generateConfigFile(options)
       );
       await writeFile(
-        import_path2.default.join(projectDir, `src/middleware/index.${ext}`),
+        import_path3.default.join(projectDir, `src/middleware/index.${ext}`),
         generateMiddlewareFile(options)
       );
       await writeFile(
-        import_path2.default.join(projectDir, `src/utils/index.${ext}`),
+        import_path3.default.join(projectDir, `src/utils/index.${ext}`),
         generateUtilsFile(options)
       );
       await writeFile(
-        import_path2.default.join(projectDir, `src/types/index.${ext}`),
+        import_path3.default.join(projectDir, `src/types/index.${ext}`),
         generateTypesFile(options)
       );
       if (options.orm === "prisma") {
         await writeFile(
-          import_path2.default.join(projectDir, "prisma/schema.prisma"),
+          import_path3.default.join(projectDir, "prisma/schema.prisma"),
           generatePrismaSchema(options)
         );
       } else if (options.orm === "mongoose") {
         await writeFile(
-          import_path2.default.join(projectDir, `src/database/connection.${ext}`),
+          import_path3.default.join(projectDir, `src/database/connection.${ext}`),
           generateMongooseConnection(options)
         );
         await writeFile(
-          import_path2.default.join(projectDir, `src/database/models/user.model.${ext}`),
+          import_path3.default.join(projectDir, `src/database/models/user.model.${ext}`),
           generateMongooseUserModel(options)
         );
       }
       spinner.succeed("Project files generated!");
-      const installSpinner = (0, import_ora.default)("Installing dependencies...").start();
-      try {
-        (0, import_child_process.execSync)("npm install", { cwd: projectDir, stdio: "pipe" });
-        installSpinner.succeed("Dependencies installed!");
-      } catch {
-        installSpinner.warn("Failed to install dependencies automatically");
-        warn('  Run "npm install" manually in the project directory');
+      if (!cmdOptions?.dryRun) {
+        const installSpinner = (0, import_ora.default)("Installing dependencies...").start();
+        try {
+          (0, import_child_process.execSync)("npm install", { cwd: projectDir, stdio: "pipe" });
+          installSpinner.succeed("Dependencies installed!");
+        } catch {
+          installSpinner.warn("Failed to install dependencies automatically");
+          warn('  Run "npm install" manually in the project directory');
+        }
+      }
+      if (!cmdOptions?.dryRun) {
+        console.log("\n" + import_chalk3.default.green("\u2728 Project created successfully!"));
       }
-      console.log("\n" + import_chalk2.default.green("\u2728 Project created successfully!"));
-      console.log("\n" + import_chalk2.default.bold("\u{1F4C1} Project structure:"));
+      console.log("\n" + import_chalk3.default.bold("\u{1F4C1} Project structure:"));
       console.log(`
   ${options.name}/
   \u251C\u2500\u2500 src/
@@ -317,19 +610,22 @@ var initCommand = new import_commander.Command("init").alias("new").description(
   \u251C\u2500\u2500 docker-compose.yml
   \u2514\u2500\u2500 package.json
 `);
-      console.log(import_chalk2.default.bold("\u{1F680} Get started:"));
+      console.log(import_chalk3.default.bold("\u{1F680} Get started:"));
       console.log(`
-  ${import_chalk2.default.cyan(`cd ${options.name}`)}
-  ${options.database !== "none" ? import_chalk2.default.cyan("npm run db:push        # Setup database") : ""}
-  ${import_chalk2.default.cyan("npm run dev            # Start development server")}
+  ${import_chalk3.default.cyan(`cd ${options.name}`)}
+  ${options.database !== "none" ? import_chalk3.default.cyan("npm run db:push        # Setup database") : ""}
+  ${import_chalk3.default.cyan("npm run dev            # Start development server")}
 `);
-      console.log(import_chalk2.default.bold("\u{1F4DA} Available commands:"));
+      console.log(import_chalk3.default.bold("\u{1F4DA} Available commands:"));
       console.log(`
-  ${import_chalk2.default.yellow("servcraft generate module <name>")}    Generate a new module
-  ${import_chalk2.default.yellow("servcraft generate controller <name>")} Generate a controller
-  ${import_chalk2.default.yellow("servcraft generate service <name>")}    Generate a service
-  ${import_chalk2.default.yellow("servcraft add auth")}                   Add authentication module
+  ${import_chalk3.default.yellow("servcraft generate module <name>")}    Generate a new module
+  ${import_chalk3.default.yellow("servcraft generate controller <name>")} Generate a controller
+  ${import_chalk3.default.yellow("servcraft generate service <name>")}    Generate a service
+  ${import_chalk3.default.yellow("servcraft add auth")}                   Add authentication module
 `);
+      if (cmdOptions?.dryRun) {
+        dryRun.printSummary();
+      }
     } catch (err) {
       spinner.fail("Failed to create project");
       error(err instanceof Error ? err.message : String(err));
@@ -1120,12 +1416,15 @@ declare module 'fastify' {
 }
 // src/cli/commands/generate.ts
+init_cjs_shims();
 var import_commander2 = require("commander");
-var import_path3 = __toESM(require("path"), 1);
+var import_path4 = __toESM(require("path"), 1);
 var import_ora2 = __toESM(require("ora"), 1);
 var import_inquirer2 = __toESM(require("inquirer"), 1);
+var import_chalk5 = __toESM(require("chalk"), 1);
 // src/cli/utils/field-parser.ts
+init_cjs_shims();
 var tsTypeMap = {
   string: "string",
   number: "number",
@@ -1267,7 +1566,11 @@ function parseFields(fieldsStr) {
   return fieldsStr.split(/\s+/).filter(Boolean).map(parseField);
 }
+// src/cli/commands/generate.ts
+init_error_handler();
 // src/cli/templates/controller.ts
+init_cjs_shims();
 function controllerTemplate(name, pascalName, camelName) {
   return `import type { FastifyRequest, FastifyReply } from 'fastify';
 import type { ${pascalName}Service } from './${name}.service.js';
@@ -1337,6 +1640,7 @@ export function create${pascalName}Controller(${camelName}Service: ${pascalName}
 }
 // src/cli/templates/service.ts
+init_cjs_shims();
 function serviceTemplate(name, pascalName, camelName) {
   return `import type { PaginatedResult, PaginationParams } from '../../types/index.js';
 import { NotFoundError, ConflictError } from '../../utils/errors.js';
@@ -1397,6 +1701,7 @@ export function create${pascalName}Service(repository?: ${pascalName}Repository)
 }
 // src/cli/templates/repository.ts
+init_cjs_shims();
 function repositoryTemplate(name, pascalName, camelName, pluralName) {
   return `import { randomUUID } from 'crypto';
 import type { PaginatedResult, PaginationParams } from '../../types/index.js';
@@ -1503,6 +1808,7 @@ export function create${pascalName}Repository(): ${pascalName}Repository {
 }
 // src/cli/templates/types.ts
+init_cjs_shims();
 function typesTemplate(name, pascalName) {
   return `import type { BaseEntity } from '../../types/index.js';
@@ -1532,6 +1838,7 @@ export interface ${pascalName}Filters {
 }
 // src/cli/templates/schemas.ts
+init_cjs_shims();
 function schemasTemplate(name, pascalName, camelName) {
   return `import { z } from 'zod';
@@ -1560,6 +1867,7 @@ export type ${pascalName}QueryInput = z.infer<typeof ${camelName}QuerySchema>;
 }
 // src/cli/templates/routes.ts
+init_cjs_shims();
 function routesTemplate(name, pascalName, camelName, pluralName) {
   return `import type { FastifyInstance } from 'fastify';
 import type { ${pascalName}Controller } from './${name}.controller.js';
@@ -1612,6 +1920,7 @@ export function register${pascalName}Routes(
 }
 // src/cli/templates/module-index.ts
+init_cjs_shims();
 function moduleIndexTemplate(name, pascalName, camelName) {
   return `import type { FastifyInstance } from 'fastify';
 import { logger } from '../../core/logger.js';
@@ -1647,6 +1956,7 @@ export * from './${name}.schemas.js';
 }
 // src/cli/templates/prisma-model.ts
+init_cjs_shims();
 function prismaModelTemplate(name, pascalName, tableName) {
   return `
 // Add this model to your prisma/schema.prisma file
@@ -1666,6 +1976,7 @@ model ${pascalName} {
 }
 // src/cli/templates/dynamic-types.ts
+init_cjs_shims();
 function dynamicTypesTemplate(name, pascalName, fields) {
   const fieldLines = fields.map((field) => {
     const tsType = tsTypeMap[field.type];
@@ -1710,6 +2021,7 @@ ${fields.filter((f) => ["string", "enum", "boolean"].includes(f.type)).map((f) =
 }
 // src/cli/templates/dynamic-schemas.ts
+init_cjs_shims();
 function dynamicSchemasTemplate(name, pascalName, camelName, fields, validator = "zod") {
   switch (validator) {
     case "joi":
@@ -1888,6 +2200,7 @@ function getJsType(field) {
 }
 // src/cli/templates/dynamic-prisma.ts
+init_cjs_shims();
 function dynamicPrismaTemplate(modelName, tableName, fields) {
   const fieldLines = [];
   for (const field of fields) {
@@ -1956,10 +2269,23 @@ ${indexLines.join("\n")}
 }
 // src/cli/commands/generate.ts
+function enableDryRunIfNeeded(options) {
+  const dryRun = DryRunManager.getInstance();
+  if (options.dryRun) {
+    dryRun.enable();
+    console.log(import_chalk5.default.yellow("\n\u26A0 DRY RUN MODE - No files will be written\n"));
+  }
+}
+function showDryRunSummary(options) {
+  if (options.dryRun) {
+    DryRunManager.getInstance().printSummary();
+  }
+}
 var generateCommand = new import_commander2.Command("generate").alias("g").description("Generate resources (module, controller, service, etc.)");
 generateCommand.command("module <name> [fields...]").alias("m").description(
   "Generate a complete module with controller, service, repository, types, schemas, and routes"
-).option("--no-routes", "Skip routes generation").option("--no-repository", "Skip repository generation").option("--prisma", "Generate Prisma model suggestion").option("--validator <type>", "Validator type: zod, joi, yup", "zod").option("-i, --interactive", "Interactive mode to define fields").action(async (name, fieldsArgs, options) => {
+).option("--no-routes", "Skip routes generation").option("--no-repository", "Skip repository generation").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, fieldsArgs, options) => {
+  enableDryRunIfNeeded(options);
   let fields = [];
   if (options.interactive) {
     fields = await promptForFields();
@@ -1974,7 +2300,7 @@ generateCommand.command("module <name> [fields...]").alias("m").description(
     const pluralName = pluralize(kebabName);
     const tableName = pluralize(kebabName.replace(/-/g, "_"));
     const validatorType = options.validator || "zod";
-    const moduleDir = import_path3.default.join(getModulesDir(), kebabName);
+    const moduleDir = import_path4.default.join(getModulesDir(), kebabName);
     if (await fileExists(moduleDir)) {
       spinner.stop();
       error(`Module "${kebabName}" already exists`);
@@ -2013,7 +2339,7 @@ generateCommand.command("module <name> [fields...]").alias("m").description(
       });
     }
     for (const file of files) {
-      await writeFile(import_path3.default.join(moduleDir, file.name), file.content);
+      await writeFile(import_path4.default.join(moduleDir, file.name), file.content);
     }
     spinner.succeed(`Module "${pascalName}" generated successfully!`);
     if (options.prisma || hasFields) {
@@ -2051,42 +2377,46 @@ generateCommand.command("module <name> [fields...]").alias("m").description(
       info(`  ${hasFields ? "3" : "4"}. Add the Prisma model to schema.prisma`);
       info(`  ${hasFields ? "4" : "5"}. Run: npm run db:migrate`);
     }
+    showDryRunSummary(options);
   } catch (err) {
     spinner.fail("Failed to generate module");
     error(err instanceof Error ? err.message : String(err));
   }
 });
-generateCommand.command("controller <name>").alias("c").description("Generate a controller").option("-m, --module <module>", "Target module name").action(async (name, options) => {
+generateCommand.command("controller <name>").alias("c").description("Generate a controller").option("-m, --module <module>", "Target module name").option("--dry-run", "Preview changes without writing files").action(async (name, options) => {
+  enableDryRunIfNeeded(options);
   const spinner = (0, import_ora2.default)("Generating controller...").start();
   try {
     const kebabName = toKebabCase(name);
     const pascalName = toPascalCase(name);
     const camelName = toCamelCase(name);
     const moduleName = options.module ? toKebabCase(options.module) : kebabName;
-    const moduleDir = import_path3.default.join(getModulesDir(), moduleName);
-    const filePath = import_path3.default.join(moduleDir, `${kebabName}.controller.ts`);
+    const moduleDir = import_path4.default.join(getModulesDir(), moduleName);
+    const filePath = import_path4.default.join(moduleDir, `${kebabName}.controller.ts`);
     if (await fileExists(filePath)) {
       spinner.stop();
-      error(`Controller "${kebabName}" already exists`);
+      displayError(ErrorTypes.FILE_ALREADY_EXISTS(`${kebabName}.controller.ts`));
       return;
     }
     await writeFile(filePath, controllerTemplate(kebabName, pascalName, camelName));
     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));
   }
 });
-generateCommand.command("service <name>").alias("s").description("Generate a service").option("-m, --module <module>", "Target module name").action(async (name, options) => {
+generateCommand.command("service <name>").alias("s").description("Generate a service").option("-m, --module <module>", "Target module name").option("--dry-run", "Preview changes without writing files").action(async (name, options) => {
+  enableDryRunIfNeeded(options);
   const spinner = (0, import_ora2.default)("Generating service...").start();
   try {
     const kebabName = toKebabCase(name);
     const pascalName = toPascalCase(name);
     const camelName = toCamelCase(name);
     const moduleName = options.module ? toKebabCase(options.module) : kebabName;
-    const moduleDir = import_path3.default.join(getModulesDir(), moduleName);
-    const filePath = import_path3.default.join(moduleDir, `${kebabName}.service.ts`);
+    const moduleDir = import_path4.default.join(getModulesDir(), moduleName);
+    const filePath = import_path4.default.join(moduleDir, `${kebabName}.service.ts`);
     if (await fileExists(filePath)) {
       spinner.stop();
       error(`Service "${kebabName}" already exists`);
@@ -2095,12 +2425,14 @@ generateCommand.command("service <name>").alias("s").description("Generate a ser
     await writeFile(filePath, serviceTemplate(kebabName, pascalName, camelName));
     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));
   }
 });
-generateCommand.command("repository <name>").alias("r").description("Generate a repository").option("-m, --module <module>", "Target module name").action(async (name, options) => {
+generateCommand.command("repository <name>").alias("r").description("Generate a repository").option("-m, --module <module>", "Target module name").option("--dry-run", "Preview changes without writing files").action(async (name, options) => {
+  enableDryRunIfNeeded(options);
   const spinner = (0, import_ora2.default)("Generating repository...").start();
   try {
     const kebabName = toKebabCase(name);
@@ -2108,8 +2440,8 @@ generateCommand.command("repository <name>").alias("r").description("Generate a
     const camelName = toCamelCase(name);
     const pluralName = pluralize(kebabName);
     const moduleName = options.module ? toKebabCase(options.module) : kebabName;
-    const moduleDir = import_path3.default.join(getModulesDir(), moduleName);
-    const filePath = import_path3.default.join(moduleDir, `${kebabName}.repository.ts`);
+    const moduleDir = import_path4.default.join(getModulesDir(), moduleName);
+    const filePath = import_path4.default.join(moduleDir, `${kebabName}.repository.ts`);
     if (await fileExists(filePath)) {
       spinner.stop();
       error(`Repository "${kebabName}" already exists`);
@@ -2118,19 +2450,21 @@ generateCommand.command("repository <name>").alias("r").description("Generate a
     await writeFile(filePath, repositoryTemplate(kebabName, pascalName, camelName, pluralName));
     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));
   }
 });
-generateCommand.command("types <name>").alias("t").description("Generate types/interfaces").option("-m, --module <module>", "Target module name").action(async (name, options) => {
+generateCommand.command("types <name>").alias("t").description("Generate types/interfaces").option("-m, --module <module>", "Target module name").option("--dry-run", "Preview changes without writing files").action(async (name, options) => {
+  enableDryRunIfNeeded(options);
   const spinner = (0, import_ora2.default)("Generating types...").start();
   try {
     const kebabName = toKebabCase(name);
     const pascalName = toPascalCase(name);
     const moduleName = options.module ? toKebabCase(options.module) : kebabName;
-    const moduleDir = import_path3.default.join(getModulesDir(), moduleName);
-    const filePath = import_path3.default.join(moduleDir, `${kebabName}.types.ts`);
+    const moduleDir = import_path4.default.join(getModulesDir(), moduleName);
+    const filePath = import_path4.default.join(moduleDir, `${kebabName}.types.ts`);
     if (await fileExists(filePath)) {
       spinner.stop();
       error(`Types file "${kebabName}.types.ts" already exists`);
@@ -2139,20 +2473,22 @@ generateCommand.command("types <name>").alias("t").description("Generate types/i
     await writeFile(filePath, typesTemplate(kebabName, pascalName));
     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));
   }
 });
-generateCommand.command("schema <name>").alias("v").description("Generate validation schemas").option("-m, --module <module>", "Target module name").action(async (name, options) => {
+generateCommand.command("schema <name>").alias("v").description("Generate validation schemas").option("-m, --module <module>", "Target module name").option("--dry-run", "Preview changes without writing files").action(async (name, options) => {
+  enableDryRunIfNeeded(options);
   const spinner = (0, import_ora2.default)("Generating schemas...").start();
   try {
     const kebabName = toKebabCase(name);
     const pascalName = toPascalCase(name);
     const camelName = toCamelCase(name);
     const moduleName = options.module ? toKebabCase(options.module) : kebabName;
-    const moduleDir = import_path3.default.join(getModulesDir(), moduleName);
-    const filePath = import_path3.default.join(moduleDir, `${kebabName}.schemas.ts`);
+    const moduleDir = import_path4.default.join(getModulesDir(), moduleName);
+    const filePath = import_path4.default.join(moduleDir, `${kebabName}.schemas.ts`);
     if (await fileExists(filePath)) {
       spinner.stop();
       error(`Schemas file "${kebabName}.schemas.ts" already exists`);
@@ -2161,12 +2497,14 @@ generateCommand.command("schema <name>").alias("v").description("Generate valida
     await writeFile(filePath, schemasTemplate(kebabName, pascalName, camelName));
     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));
   }
 });
-generateCommand.command("routes <name>").description("Generate routes").option("-m, --module <module>", "Target module name").action(async (name, options) => {
+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, options) => {
+  enableDryRunIfNeeded(options);
   const spinner = (0, import_ora2.default)("Generating routes...").start();
   try {
     const kebabName = toKebabCase(name);
@@ -2174,8 +2512,8 @@ generateCommand.command("routes <name>").description("Generate routes").option("
     const camelName = toCamelCase(name);
     const pluralName = pluralize(kebabName);
     const moduleName = options.module ? toKebabCase(options.module) : kebabName;
-    const moduleDir = import_path3.default.join(getModulesDir(), moduleName);
-    const filePath = import_path3.default.join(moduleDir, `${kebabName}.routes.ts`);
+    const moduleDir = import_path4.default.join(getModulesDir(), moduleName);
+    const filePath = import_path4.default.join(moduleDir, `${kebabName}.routes.ts`);
     if (await fileExists(filePath)) {
       spinner.stop();
       error(`Routes file "${kebabName}.routes.ts" already exists`);
@@ -2184,6 +2522,7 @@ generateCommand.command("routes <name>").description("Generate routes").option("
     await writeFile(filePath, routesTemplate(kebabName, pascalName, camelName, pluralName));
     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));
@@ -2261,22 +2600,24 @@ async function promptForFields() {
 }
 // src/cli/commands/add-module.ts
+init_cjs_shims();
 var import_commander3 = require("commander");
-var import_path4 = __toESM(require("path"), 1);
+var import_path5 = __toESM(require("path"), 1);
 var import_ora3 = __toESM(require("ora"), 1);
-var import_chalk4 = __toESM(require("chalk"), 1);
+var import_chalk7 = __toESM(require("chalk"), 1);
 var fs5 = __toESM(require("fs/promises"), 1);
 // src/cli/utils/env-manager.ts
+init_cjs_shims();
 var fs3 = __toESM(require("fs/promises"), 1);
-var path4 = __toESM(require("path"), 1);
+var path5 = __toESM(require("path"), 1);
 var import_fs = require("fs");
 var EnvManager = class {
   envPath;
   envExamplePath;
   constructor(projectRoot) {
-    this.envPath = path4.join(projectRoot, ".env");
-    this.envExamplePath = path4.join(projectRoot, ".env.example");
+    this.envPath = path5.join(projectRoot, ".env");
+    this.envExamplePath = path5.join(projectRoot, ".env.example");
   }
   /**
    * Add environment variables to .env file
@@ -2926,16 +3267,17 @@ var EnvManager = class {
 };
 // src/cli/utils/template-manager.ts
+init_cjs_shims();
 var fs4 = __toESM(require("fs/promises"), 1);
-var path5 = __toESM(require("path"), 1);
+var path6 = __toESM(require("path"), 1);
 var import_crypto = require("crypto");
 var import_fs2 = require("fs");
 var TemplateManager = class {
   templatesDir;
   manifestsDir;
   constructor(projectRoot) {
-    this.templatesDir = path5.join(projectRoot, ".servcraft", "templates");
-    this.manifestsDir = path5.join(projectRoot, ".servcraft", "manifests");
+    this.templatesDir = path6.join(projectRoot, ".servcraft", "templates");
+    this.manifestsDir = path6.join(projectRoot, ".servcraft", "manifests");
   }
   /**
    * Initialize template system
@@ -2949,10 +3291,10 @@ var TemplateManager = class {
    */
   async saveTemplate(moduleName, files) {
     await this.initialize();
-    const moduleTemplateDir = path5.join(this.templatesDir, moduleName);
+    const moduleTemplateDir = path6.join(this.templatesDir, moduleName);
     await fs4.mkdir(moduleTemplateDir, { recursive: true });
     for (const [fileName, content] of Object.entries(files)) {
-      const filePath = path5.join(moduleTemplateDir, fileName);
+      const filePath = path6.join(moduleTemplateDir, fileName);
       await fs4.writeFile(filePath, content, "utf-8");
     }
   }
@@ -2961,7 +3303,7 @@ var TemplateManager = class {
    */
   async getTemplate(moduleName, fileName) {
     try {
-      const filePath = path5.join(this.templatesDir, moduleName, fileName);
+      const filePath = path6.join(this.templatesDir, moduleName, fileName);
       return await fs4.readFile(filePath, "utf-8");
     } catch {
       return null;
@@ -2986,7 +3328,7 @@ var TemplateManager = class {
       installedAt: /* @__PURE__ */ new Date(),
       updatedAt: /* @__PURE__ */ new Date()
     };
-    const manifestPath = path5.join(this.manifestsDir, `${moduleName}.json`);
+    const manifestPath = path6.join(this.manifestsDir, `${moduleName}.json`);
     await fs4.writeFile(manifestPath, JSON.stringify(manifest, null, 2), "utf-8");
   }
   /**
@@ -2994,7 +3336,7 @@ var TemplateManager = class {
    */
   async getManifest(moduleName) {
     try {
-      const manifestPath = path5.join(this.manifestsDir, `${moduleName}.json`);
+      const manifestPath = path6.join(this.manifestsDir, `${moduleName}.json`);
       const content = await fs4.readFile(manifestPath, "utf-8");
       return JSON.parse(content);
     } catch {
@@ -3023,7 +3365,7 @@ var TemplateManager = class {
     }
     const results = [];
     for (const [fileName, fileInfo] of Object.entries(manifest.files)) {
-      const filePath = path5.join(moduleDir, fileName);
+      const filePath = path6.join(moduleDir, fileName);
       if (!(0, import_fs2.existsSync)(filePath)) {
         results.push({
           fileName,
@@ -3049,7 +3391,7 @@ var TemplateManager = class {
    */
   async createBackup(moduleName, moduleDir) {
     const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").substring(0, 19);
-    const backupDir = path5.join(path5.dirname(moduleDir), `${moduleName}.backup-${timestamp}`);
+    const backupDir = path6.join(path6.dirname(moduleDir), `${moduleName}.backup-${timestamp}`);
     await this.copyDirectory(moduleDir, backupDir);
     return backupDir;
   }
@@ -3060,8 +3402,8 @@ var TemplateManager = class {
     await fs4.mkdir(dest, { recursive: true });
     const entries = await fs4.readdir(src, { withFileTypes: true });
     for (const entry of entries) {
-      const srcPath = path5.join(src, entry.name);
-      const destPath = path5.join(dest, entry.name);
+      const srcPath = path6.join(src, entry.name);
+      const destPath = path6.join(dest, entry.name);
       if (entry.isDirectory()) {
         await this.copyDirectory(srcPath, destPath);
       } else {
@@ -3162,23 +3504,24 @@ var TemplateManager = class {
     }
     manifest.files = fileHashes;
     manifest.updatedAt = /* @__PURE__ */ new Date();
-    const manifestPath = path5.join(this.manifestsDir, `${moduleName}.json`);
+    const manifestPath = path6.join(this.manifestsDir, `${moduleName}.json`);
     await fs4.writeFile(manifestPath, JSON.stringify(manifest, null, 2), "utf-8");
   }
 };
 // src/cli/utils/interactive-prompt.ts
+init_cjs_shims();
 var import_inquirer3 = __toESM(require("inquirer"), 1);
-var import_chalk3 = __toESM(require("chalk"), 1);
+var import_chalk6 = __toESM(require("chalk"), 1);
 var InteractivePrompt = class {
   /**
    * Ask what to do when module already exists
    */
   static async askModuleExists(moduleName, hasModifications) {
-    console.log(import_chalk3.default.yellow(`
+    console.log(import_chalk6.default.yellow(`
 \u26A0\uFE0F  Module "${moduleName}" already exists`));
     if (hasModifications) {
-      console.log(import_chalk3.default.yellow("   Some files have been modified by you.\n"));
+      console.log(import_chalk6.default.yellow("   Some files have been modified by you.\n"));
     }
     const { action } = await import_inquirer3.default.prompt([
       {
@@ -3216,12 +3559,12 @@ var InteractivePrompt = class {
    * Ask what to do with a specific file
    */
   static async askFileAction(fileName, isModified, yourLines, newLines) {
-    console.log(import_chalk3.default.cyan(`
+    console.log(import_chalk6.default.cyan(`
 \u{1F4C1} ${fileName}`));
     console.log(
-      import_chalk3.default.gray(`   Your version: ${yourLines} lines${isModified ? " (modified)" : ""}`)
+      import_chalk6.default.gray(`   Your version: ${yourLines} lines${isModified ? " (modified)" : ""}`)
     );
-    console.log(import_chalk3.default.gray(`   New version: ${newLines} lines
+    console.log(import_chalk6.default.gray(`   New version: ${newLines} lines
 `));
     const { action } = await import_inquirer3.default.prompt([
       {
@@ -3273,7 +3616,7 @@ var InteractivePrompt = class {
    * Display diff and ask to continue
    */
   static async showDiffAndAsk(diff) {
-    console.log(import_chalk3.default.cyan("\n\u{1F4CA} Differences:\n"));
+    console.log(import_chalk6.default.cyan("\n\u{1F4CA} Differences:\n"));
     console.log(diff);
     return await this.confirm("\nDo you want to proceed with this change?", true);
   }
@@ -3281,41 +3624,41 @@ var InteractivePrompt = class {
    * Display merge conflicts
    */
   static displayConflicts(conflicts) {
-    console.log(import_chalk3.default.red("\n\u26A0\uFE0F  Merge Conflicts Detected:\n"));
+    console.log(import_chalk6.default.red("\n\u26A0\uFE0F  Merge Conflicts Detected:\n"));
     conflicts.forEach((conflict, i) => {
-      console.log(import_chalk3.default.yellow(`   ${i + 1}. ${conflict}`));
+      console.log(import_chalk6.default.yellow(`   ${i + 1}. ${conflict}`));
     });
-    console.log(import_chalk3.default.gray("\n   Conflict markers have been added to the file:"));
-    console.log(import_chalk3.default.gray("   <<<<<<< YOUR VERSION"));
-    console.log(import_chalk3.default.gray("   ... your code ..."));
-    console.log(import_chalk3.default.gray("   ======="));
-    console.log(import_chalk3.default.gray("   ... new code ..."));
-    console.log(import_chalk3.default.gray("   >>>>>>> NEW VERSION\n"));
+    console.log(import_chalk6.default.gray("\n   Conflict markers have been added to the file:"));
+    console.log(import_chalk6.default.gray("   <<<<<<< YOUR VERSION"));
+    console.log(import_chalk6.default.gray("   ... your code ..."));
+    console.log(import_chalk6.default.gray("   ======="));
+    console.log(import_chalk6.default.gray("   ... new code ..."));
+    console.log(import_chalk6.default.gray("   >>>>>>> NEW VERSION\n"));
   }
   /**
    * Show backup location
    */
   static showBackupCreated(backupPath) {
-    console.log(import_chalk3.default.green(`
-\u2713 Backup created: ${import_chalk3.default.cyan(backupPath)}`));
+    console.log(import_chalk6.default.green(`
+\u2713 Backup created: ${import_chalk6.default.cyan(backupPath)}`));
   }
   /**
    * Show merge summary
    */
   static showMergeSummary(stats) {
-    console.log(import_chalk3.default.bold("\n\u{1F4CA} Merge Summary:\n"));
+    console.log(import_chalk6.default.bold("\n\u{1F4CA} Merge Summary:\n"));
     if (stats.merged > 0) {
-      console.log(import_chalk3.default.green(`   \u2713 Merged: ${stats.merged} file(s)`));
+      console.log(import_chalk6.default.green(`   \u2713 Merged: ${stats.merged} file(s)`));
     }
     if (stats.kept > 0) {
-      console.log(import_chalk3.default.blue(`   \u2192 Kept: ${stats.kept} file(s)`));
+      console.log(import_chalk6.default.blue(`   \u2192 Kept: ${stats.kept} file(s)`));
     }
     if (stats.overwritten > 0) {
-      console.log(import_chalk3.default.yellow(`   \u26A0 Overwritten: ${stats.overwritten} file(s)`));
+      console.log(import_chalk6.default.yellow(`   \u26A0 Overwritten: ${stats.overwritten} file(s)`));
     }
     if (stats.conflicts > 0) {
-      console.log(import_chalk3.default.red(`   \u26A0 Conflicts: ${stats.conflicts} file(s)`));
-      console.log(import_chalk3.default.gray("\n   Please resolve conflicts manually before committing.\n"));
+      console.log(import_chalk6.default.red(`   \u26A0 Conflicts: ${stats.conflicts} file(s)`));
+      console.log(import_chalk6.default.gray("\n   Please resolve conflicts manually before committing.\n"));
     }
   }
   /**
@@ -3353,6 +3696,7 @@ var InteractivePrompt = class {
 };
 // src/cli/commands/add-module.ts
+init_error_handler();
 var AVAILABLE_MODULES = {
   auth: {
     name: "Authentication",
@@ -3487,31 +3831,40 @@ var AVAILABLE_MODULES = {
 var addModuleCommand = new import_commander3.Command("add").description("Add a pre-built module to your project").argument(
   "[module]",
   "Module to add (auth, users, email, audit, upload, cache, notifications, settings)"
-).option("-l, --list", "List available modules").option("-f, --force", "Force overwrite existing module").option("-u, --update", "Update existing module (smart merge)").option("--skip-existing", "Skip if module already exists").action(
+).option("-l, --list", "List available modules").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, options) => {
     if (options?.list || !moduleName) {
-      console.log(import_chalk4.default.bold("\n\u{1F4E6} Available Modules:\n"));
+      console.log(import_chalk7.default.bold("\n\u{1F4E6} Available Modules:\n"));
       for (const [key, mod] of Object.entries(AVAILABLE_MODULES)) {
-        console.log(`  ${import_chalk4.default.cyan(key.padEnd(15))} ${mod.name}`);
-        console.log(`  ${" ".repeat(15)} ${import_chalk4.default.gray(mod.description)}
+        console.log(`  ${import_chalk7.default.cyan(key.padEnd(15))} ${mod.name}`);
+        console.log(`  ${" ".repeat(15)} ${import_chalk7.default.gray(mod.description)}
 `);
       }
-      console.log(import_chalk4.default.bold("Usage:"));
-      console.log(`  ${import_chalk4.default.yellow("servcraft add auth")}      Add authentication module`);
-      console.log(`  ${import_chalk4.default.yellow("servcraft add users")}     Add user management module`);
-      console.log(`  ${import_chalk4.default.yellow("servcraft add email")}     Add email service module
+      console.log(import_chalk7.default.bold("Usage:"));
+      console.log(`  ${import_chalk7.default.yellow("servcraft add auth")}      Add authentication module`);
+      console.log(`  ${import_chalk7.default.yellow("servcraft add users")}     Add user management module`);
+      console.log(`  ${import_chalk7.default.yellow("servcraft add email")}     Add email service module
 `);
       return;
     }
+    const dryRun = DryRunManager.getInstance();
+    if (options?.dryRun) {
+      dryRun.enable();
+      console.log(import_chalk7.default.yellow("\n\u26A0 DRY RUN MODE - No files will be written\n"));
+    }
     const module2 = AVAILABLE_MODULES[moduleName];
     if (!module2) {
-      error(`Unknown module: ${moduleName}`);
-      info('Run "servcraft add --list" to see available modules');
+      displayError(ErrorTypes.MODULE_NOT_FOUND(moduleName));
+      return;
+    }
+    const projectError = validateProject();
+    if (projectError) {
+      displayError(projectError);
       return;
     }
     const spinner = (0, import_ora3.default)(`Adding ${module2.name} module...`).start();
     try {
-      const moduleDir = import_path4.default.join(getModulesDir(), moduleName);
+      const moduleDir = import_path5.default.join(getModulesDir(), moduleName);
       const templateManager = new TemplateManager(process.cwd());
       const moduleExists = await fileExists(moduleDir);
       if (moduleExists) {
@@ -3579,16 +3932,16 @@ var addModuleCommand = new import_commander3.Command("add").description("Add a p
             info("\n\u{1F4DD} Created new .env file");
           }
           if (result.added.length > 0) {
-            console.log(import_chalk4.default.bold("\n\u2705 Added to .env:"));
+            console.log(import_chalk7.default.bold("\n\u2705 Added to .env:"));
             result.added.forEach((key) => success(`  ${key}`));
           }
           if (result.skipped.length > 0) {
-            console.log(import_chalk4.default.bold("\n\u23ED\uFE0F  Already in .env (skipped):"));
+            console.log(import_chalk7.default.bold("\n\u23ED\uFE0F  Already in .env (skipped):"));
             result.skipped.forEach((key) => info(`  ${key}`));
           }
           const requiredVars = envSections.flatMap((section) => section.variables).filter((v) => v.required && !v.value).map((v) => v.key);
           if (requiredVars.length > 0) {
-            console.log(import_chalk4.default.bold("\n\u26A0\uFE0F  Required configuration:"));
+            console.log(import_chalk7.default.bold("\n\u26A0\uFE0F  Required configuration:"));
             requiredVars.forEach((key) => warn(`  ${key} - Please configure this variable`));
           }
         } catch (err) {
@@ -3596,10 +3949,15 @@ var addModuleCommand = new import_commander3.Command("add").description("Add a p
           error(err instanceof Error ? err.message : String(err));
         }
       }
-      console.log("\n\u{1F4CC} 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\u{1F4CC} 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) {
+        dryRun.printSummary();
+      }
     } catch (err) {
       spinner.fail("Failed to add module");
       error(err instanceof Error ? err.message : String(err));
@@ -3650,7 +4008,7 @@ export * from './auth.schemas.js';
 `
   };
   for (const [name, content] of Object.entries(files)) {
-    await writeFile(import_path4.default.join(dir, name), content);
+    await writeFile(import_path5.default.join(dir, name), content);
   }
 }
 async function generateUsersModule(dir) {
@@ -3690,7 +4048,7 @@ export * from './user.schemas.js';
 `
   };
   for (const [name, content] of Object.entries(files)) {
-    await writeFile(import_path4.default.join(dir, name), content);
+    await writeFile(import_path5.default.join(dir, name), content);
   }
 }
 async function generateEmailModule(dir) {
@@ -3747,7 +4105,7 @@ export { EmailService, emailService } from './email.service.js';
 `
   };
   for (const [name, content] of Object.entries(files)) {
-    await writeFile(import_path4.default.join(dir, name), content);
+    await writeFile(import_path5.default.join(dir, name), content);
   }
 }
 async function generateAuditModule(dir) {
@@ -3791,7 +4149,7 @@ export { AuditService, auditService } from './audit.service.js';
 `
   };
   for (const [name, content] of Object.entries(files)) {
-    await writeFile(import_path4.default.join(dir, name), content);
+    await writeFile(import_path5.default.join(dir, name), content);
   }
 }
 async function generateUploadModule(dir) {
@@ -3817,7 +4175,7 @@ export interface UploadOptions {
 `
   };
   for (const [name, content] of Object.entries(files)) {
-    await writeFile(import_path4.default.join(dir, name), content);
+    await writeFile(import_path5.default.join(dir, name), content);
   }
 }
 async function generateCacheModule(dir) {
@@ -3863,7 +4221,7 @@ export { CacheService, cacheService } from './cache.service.js';
 `
   };
   for (const [name, content] of Object.entries(files)) {
-    await writeFile(import_path4.default.join(dir, name), content);
+    await writeFile(import_path5.default.join(dir, name), content);
   }
 }
 async function generateGenericModule(dir, name) {
@@ -3877,18 +4235,18 @@ export interface ${name.charAt(0).toUpperCase() + name.slice(1)}Data {
 `
   };
   for (const [fileName, content] of Object.entries(files)) {
-    await writeFile(import_path4.default.join(dir, fileName), content);
+    await writeFile(import_path5.default.join(dir, fileName), content);
   }
 }
 async function findServercraftModules() {
-  const scriptDir = import_path4.default.dirname(new URL(importMetaUrl).pathname);
+  const scriptDir = import_path5.default.dirname(new URL(importMetaUrl).pathname);
   const possiblePaths = [
     // Local node_modules (when servcraft is a dependency)
-    import_path4.default.join(process.cwd(), "node_modules", "servcraft", "src", "modules"),
+    import_path5.default.join(process.cwd(), "node_modules", "servcraft", "src", "modules"),
     // From dist/cli/index.js -> src/modules (npx or global install)
-    import_path4.default.resolve(scriptDir, "..", "..", "src", "modules"),
+    import_path5.default.resolve(scriptDir, "..", "..", "src", "modules"),
     // From src/cli/commands/add-module.ts -> src/modules (development)
-    import_path4.default.resolve(scriptDir, "..", "..", "modules")
+    import_path5.default.resolve(scriptDir, "..", "..", "modules")
   ];
   for (const p of possiblePaths) {
     try {
@@ -3912,7 +4270,7 @@ async function generateModuleFiles(moduleName, moduleDir) {
   const sourceDirName = moduleNameMap[moduleName] || moduleName;
   const servercraftModulesDir = await findServercraftModules();
   if (servercraftModulesDir) {
-    const sourceModuleDir = import_path4.default.join(servercraftModulesDir, sourceDirName);
+    const sourceModuleDir = import_path5.default.join(servercraftModulesDir, sourceDirName);
     if (await fileExists(sourceModuleDir)) {
       await copyModuleFromSource(sourceModuleDir, moduleDir);
       return;
@@ -3944,8 +4302,8 @@ async function generateModuleFiles(moduleName, moduleDir) {
 async function copyModuleFromSource(sourceDir, targetDir) {
   const entries = await fs5.readdir(sourceDir, { withFileTypes: true });
   for (const entry of entries) {
-    const sourcePath = import_path4.default.join(sourceDir, entry.name);
-    const targetPath = import_path4.default.join(targetDir, entry.name);
+    const sourcePath = import_path5.default.join(sourceDir, entry.name);
+    const targetPath = import_path5.default.join(targetDir, entry.name);
     if (entry.isDirectory()) {
       await fs5.mkdir(targetPath, { recursive: true });
       await copyModuleFromSource(sourcePath, targetPath);
@@ -3958,7 +4316,7 @@ async function getModuleFiles(moduleName, moduleDir) {
   const files = {};
   const entries = await fs5.readdir(moduleDir);
   for (const entry of entries) {
-    const filePath = import_path4.default.join(moduleDir, entry);
+    const filePath = import_path5.default.join(moduleDir, entry);
     const stat2 = await fs5.stat(filePath);
     if (stat2.isFile() && entry.endsWith(".ts")) {
       const content = await fs5.readFile(filePath, "utf-8");
@@ -3969,14 +4327,14 @@ async function getModuleFiles(moduleName, moduleDir) {
 }
 async function showDiffForModule(templateManager, moduleName, moduleDir) {
   const modifiedFiles = await templateManager.getModifiedFiles(moduleName, moduleDir);
-  console.log(import_chalk4.default.cyan(`
+  console.log(import_chalk7.default.cyan(`
 \u{1F4CA} Changes in module "${moduleName}":
 `));
   for (const file of modifiedFiles) {
     if (file.isModified) {
-      console.log(import_chalk4.default.yellow(`
+      console.log(import_chalk7.default.yellow(`
 \u{1F4C4} ${file.fileName}:`));
-      const currentPath = import_path4.default.join(moduleDir, file.fileName);
+      const currentPath = import_path5.default.join(moduleDir, file.fileName);
       const currentContent = await fs5.readFile(currentPath, "utf-8");
       const originalContent = await templateManager.getTemplate(moduleName, file.fileName);
       if (originalContent) {
@@ -3989,11 +4347,11 @@ async function showDiffForModule(templateManager, moduleName, moduleDir) {
 async function performSmartMerge(templateManager, moduleName, moduleDir, _displayName) {
   const spinner = (0, import_ora3.default)("Analyzing files for merge...").start();
   const newFiles = {};
-  const templateDir = import_path4.default.join(templateManager["templatesDir"], moduleName);
+  const templateDir = import_path5.default.join(templateManager["templatesDir"], moduleName);
   try {
     const entries = await fs5.readdir(templateDir);
     for (const entry of entries) {
-      const content = await fs5.readFile(import_path4.default.join(templateDir, entry), "utf-8");
+      const content = await fs5.readFile(import_path5.default.join(templateDir, entry), "utf-8");
       newFiles[entry] = content;
     }
   } catch {
@@ -4011,7 +4369,7 @@ async function performSmartMerge(templateManager, moduleName, moduleDir, _displa
   };
   for (const fileInfo of modifiedFiles) {
     const fileName = fileInfo.fileName;
-    const filePath = import_path4.default.join(moduleDir, fileName);
+    const filePath = import_path5.default.join(moduleDir, fileName);
     const newContent = newFiles[fileName];
     if (!newContent) {
       continue;
@@ -4080,10 +4438,11 @@ async function performSmartMerge(templateManager, moduleName, moduleDir, _displa
 }
 // src/cli/commands/db.ts
+init_cjs_shims();
 var import_commander4 = require("commander");
 var import_child_process2 = require("child_process");
 var import_ora4 = __toESM(require("ora"), 1);
-var import_chalk5 = __toESM(require("chalk"), 1);
+var import_chalk8 = __toESM(require("chalk"), 1);
 var dbCommand = new import_commander4.Command("db").description("Database management commands");
 dbCommand.command("migrate").description("Run database migrations").option("-n, --name <name>", "Migration name").action(async (options) => {
   const spinner = (0, import_ora4.default)("Running migrations...").start();
@@ -4140,7 +4499,7 @@ dbCommand.command("seed").description("Run database seed").action(async () => {
 });
 dbCommand.command("reset").description("Reset database (drop all data and re-run migrations)").option("-f, --force", "Skip confirmation").action(async (options) => {
   if (!options.force) {
-    console.log(import_chalk5.default.yellow("\n\u26A0\uFE0F  WARNING: This will delete all data in your database!\n"));
+    console.log(import_chalk8.default.yellow("\n\u26A0\uFE0F  WARNING: This will delete all data in your database!\n"));
     const readline = await import("readline");
     const rl = readline.createInterface({
       input: process.stdin,
@@ -4173,21 +4532,25 @@ dbCommand.command("status").description("Show migration status").action(async ()
 });
 // src/cli/commands/docs.ts
+init_cjs_shims();
 var import_commander5 = require("commander");
-var import_path6 = __toESM(require("path"), 1);
+var import_path7 = __toESM(require("path"), 1);
 var import_promises4 = __toESM(require("fs/promises"), 1);
 var import_ora6 = __toESM(require("ora"), 1);
-var import_chalk6 = __toESM(require("chalk"), 1);
+var import_chalk9 = __toESM(require("chalk"), 1);
 // src/cli/utils/docs-generator.ts
+init_cjs_shims();
 var import_promises3 = __toESM(require("fs/promises"), 1);
-var import_path5 = __toESM(require("path"), 1);
+var import_path6 = __toESM(require("path"), 1);
 var import_ora5 = __toESM(require("ora"), 1);
 // src/core/server.ts
+init_cjs_shims();
 var import_fastify = __toESM(require("fastify"), 1);
 // src/core/logger.ts
+init_cjs_shims();
 var import_pino = __toESM(require("pino"), 1);
 var defaultConfig = {
   level: process.env.LOG_LEVEL || "info",
@@ -4320,7 +4683,14 @@ function createServer(config2 = {}) {
   return new Server(config2);
 }
+// src/middleware/index.ts
+init_cjs_shims();
+// src/middleware/error-handler.ts
+init_cjs_shims();
 // src/utils/errors.ts
+init_cjs_shims();
 var AppError = class _AppError extends Error {
   statusCode;
   isOperational;
@@ -4374,7 +4744,11 @@ function isAppError(error2) {
   return error2 instanceof AppError;
 }
+// src/config/index.ts
+init_cjs_shims();
 // src/config/env.ts
+init_cjs_shims();
 var import_zod = require("zod");
 var import_dotenv = __toESM(require("dotenv"), 1);
 import_dotenv.default.config();
@@ -4520,6 +4894,7 @@ function registerErrorHandler(app) {
 }
 // src/middleware/security.ts
+init_cjs_shims();
 var import_helmet = __toESM(require("@fastify/helmet"), 1);
 var import_cors = __toESM(require("@fastify/cors"), 1);
 var import_rate_limit = __toESM(require("@fastify/rate-limit"), 1);
@@ -4579,7 +4954,11 @@ async function registerSecurity(app, options = {}) {
   }
 }
+// src/modules/swagger/index.ts
+init_cjs_shims();
 // src/modules/swagger/swagger.service.ts
+init_cjs_shims();
 var import_swagger = __toESM(require("@fastify/swagger"), 1);
 var import_swagger_ui = __toESM(require("@fastify/swagger-ui"), 1);
 var defaultConfig3 = {
@@ -4639,11 +5018,16 @@ async function registerSwagger(app, customConfig) {
   logger.info("Swagger documentation registered at /docs");
 }
+// src/modules/swagger/schema-builder.ts
+init_cjs_shims();
 // src/modules/auth/index.ts
+init_cjs_shims();
 var import_jwt = __toESM(require("@fastify/jwt"), 1);
 var import_cookie = __toESM(require("@fastify/cookie"), 1);
 // src/modules/auth/auth.service.ts
+init_cjs_shims();
 var import_bcryptjs = __toESM(require("bcryptjs"), 1);
 var import_ioredis = require("ioredis");
 var AuthService = class {
@@ -4842,7 +5226,11 @@ function createAuthService(app) {
   return new AuthService(app);
 }
+// src/modules/auth/auth.controller.ts
+init_cjs_shims();
 // src/modules/auth/schemas.ts
+init_cjs_shims();
 var import_zod2 = require("zod");
 var loginSchema = import_zod2.z.object({
   email: import_zod2.z.string().email("Invalid email address"),
@@ -4869,6 +5257,7 @@ var changePasswordSchema = import_zod2.z.object({
 });
 // src/utils/response.ts
+init_cjs_shims();
 function success2(reply, data, statusCode = 200) {
   const response = {
     success: true,
@@ -4884,6 +5273,7 @@ function noContent(reply) {
 }
 // src/modules/validation/validator.ts
+init_cjs_shims();
 var import_zod3 = require("zod");
 function validateBody(schema, data) {
   const result = schema.safeParse(data);
@@ -4902,11 +5292,11 @@ function validateQuery(schema, data) {
 function formatZodErrors(error2) {
   const errors = {};
   for (const issue of error2.issues) {
-    const path9 = issue.path.join(".") || "root";
-    if (!errors[path9]) {
-      errors[path9] = [];
+    const path11 = issue.path.join(".") || "root";
+    if (!errors[path11]) {
+      errors[path11] = [];
     }
-    errors[path9].push(issue.message);
+    errors[path11].push(issue.message);
   }
   return errors;
 }
@@ -5054,7 +5444,11 @@ function createAuthController(authService, userService) {
   return new AuthController(authService, userService);
 }
+// src/modules/auth/auth.routes.ts
+init_cjs_shims();
 // src/modules/auth/auth.middleware.ts
+init_cjs_shims();
 function createAuthMiddleware(authService) {
   return async function authenticate(request, _reply) {
     const authHeader = request.headers.authorization;
@@ -5097,7 +5491,14 @@ function registerAuthRoutes(app, controller, authService) {
   );
 }
+// src/modules/user/user.service.ts
+init_cjs_shims();
+// src/modules/user/user.repository.ts
+init_cjs_shims();
 // src/database/prisma.ts
+init_cjs_shims();
 var import_client = require("@prisma/client");
 var prismaClientSingleton = () => {
   return new import_client.PrismaClient({
@@ -5111,6 +5512,7 @@ if (!isProduction()) {
 }
 // src/utils/pagination.ts
+init_cjs_shims();
 var DEFAULT_PAGE = 1;
 var DEFAULT_LIMIT = 20;
 var MAX_LIMIT = 100;
@@ -5375,6 +5777,7 @@ function createUserRepository() {
 }
 // src/modules/user/types.ts
+init_cjs_shims();
 var DEFAULT_ROLE_PERMISSIONS = {
   user: ["profile:read", "profile:update"],
   moderator: [
@@ -5505,6 +5908,9 @@ function createUserService(repository) {
   return new UserService(repository || createUserRepository());
 }
+// src/modules/auth/types.ts
+init_cjs_shims();
 // src/modules/auth/index.ts
 async function registerAuthModule(app) {
   await app.register(import_jwt.default, {
@@ -5524,7 +5930,14 @@ async function registerAuthModule(app) {
   logger.info("Auth module registered");
 }
+// src/modules/user/index.ts
+init_cjs_shims();
+// src/modules/user/user.controller.ts
+init_cjs_shims();
 // src/modules/user/schemas.ts
+init_cjs_shims();
 var import_zod4 = require("zod");
 var userStatusEnum = import_zod4.z.enum(["active", "inactive", "suspended", "banned"]);
 var userRoleEnum = import_zod4.z.enum(["user", "admin", "moderator", "super_admin"]);
@@ -5651,6 +6064,7 @@ function createUserController(userService) {
 }
 // src/modules/user/user.routes.ts
+init_cjs_shims();
 var idParamsSchema = {
   type: "object",
   properties: {
@@ -5739,8 +6153,8 @@ async function generateDocs(outputPath = "openapi.json", silent = false) {
     await registerUserModule(app, authService);
     await app.ready();
     const spec = app.swagger();
-    const absoluteOutput = import_path5.default.resolve(outputPath);
-    await import_promises3.default.mkdir(import_path5.default.dirname(absoluteOutput), { recursive: true });
+    const absoluteOutput = import_path6.default.resolve(outputPath);
+    await import_promises3.default.mkdir(import_path6.default.dirname(absoluteOutput), { recursive: true });
     await import_promises3.default.writeFile(absoluteOutput, JSON.stringify(spec, null, 2), "utf8");
     spinner?.succeed(`OpenAPI spec generated at ${absoluteOutput}`);
     await app.close();
@@ -5785,7 +6199,7 @@ docsCommand.command("export").description("Export documentation to Postman, Inso
   const spinner = (0, import_ora6.default)("Exporting documentation...").start();
   try {
     const projectRoot = getProjectRoot();
-    const specPath = import_path6.default.join(projectRoot, "openapi.json");
+    const specPath = import_path7.default.join(projectRoot, "openapi.json");
     try {
       await import_promises4.default.access(specPath);
     } catch {
@@ -5812,7 +6226,7 @@ docsCommand.command("export").description("Export documentation to Postman, Inso
       default:
         throw new Error(`Unknown format: ${options.format}`);
     }
-    const outPath = import_path6.default.join(projectRoot, options.output || defaultName);
+    const outPath = import_path7.default.join(projectRoot, options.output || defaultName);
     await import_promises4.default.writeFile(outPath, output);
     spinner.succeed(`Exported to: ${options.output || defaultName}`);
     if (options.format === "postman") {
@@ -5825,8 +6239,8 @@ docsCommand.command("export").description("Export documentation to Postman, Inso
 });
 docsCommand.command("status").description("Show documentation status").action(async () => {
   const projectRoot = getProjectRoot();
-  console.log(import_chalk6.default.bold("\n\u{1F4CA} Documentation Status\n"));
-  const specPath = import_path6.default.join(projectRoot, "openapi.json");
+  console.log(import_chalk9.default.bold("\n\u{1F4CA} Documentation Status\n"));
+  const specPath = import_path7.default.join(projectRoot, "openapi.json");
   try {
     const stat2 = await import_promises4.default.stat(specPath);
     success(
@@ -5941,13 +6355,325 @@ function formatDate(date) {
   });
 }
+// src/cli/commands/list.ts
+init_cjs_shims();
+var import_commander6 = require("commander");
+var import_chalk10 = __toESM(require("chalk"), 1);
+var import_promises5 = __toESM(require("fs/promises"), 1);
+var AVAILABLE_MODULES2 = {
+  // Core
+  auth: {
+    name: "Authentication",
+    description: "JWT authentication with access/refresh tokens",
+    category: "Core"
+  },
+  users: {
+    name: "User Management",
+    description: "User CRUD with RBAC (roles & permissions)",
+    category: "Core"
+  },
+  email: {
+    name: "Email Service",
+    description: "SMTP email with templates (Handlebars)",
+    category: "Core"
+  },
+  // Security
+  mfa: {
+    name: "MFA/TOTP",
+    description: "Two-factor authentication with QR codes",
+    category: "Security"
+  },
+  oauth: {
+    name: "OAuth",
+    description: "Social login (Google, GitHub, Facebook, Twitter, Apple)",
+    category: "Security"
+  },
+  "rate-limit": {
+    name: "Rate Limiting",
+    description: "Advanced rate limiting with multiple algorithms",
+    category: "Security"
+  },
+  // Data & Storage
+  cache: {
+    name: "Redis Cache",
+    description: "Redis caching with TTL & invalidation",
+    category: "Data & Storage"
+  },
+  upload: {
+    name: "File Upload",
+    description: "File upload with local/S3/Cloudinary storage",
+    category: "Data & Storage"
+  },
+  search: {
+    name: "Search",
+    description: "Full-text search with Elasticsearch/Meilisearch",
+    category: "Data & Storage"
+  },
+  // Communication
+  notification: {
+    name: "Notifications",
+    description: "Email, SMS, Push notifications",
+    category: "Communication"
+  },
+  webhook: {
+    name: "Webhooks",
+    description: "Outgoing webhooks with HMAC signatures & retry",
+    category: "Communication"
+  },
+  websocket: {
+    name: "WebSockets",
+    description: "Real-time communication with Socket.io",
+    category: "Communication"
+  },
+  // Background Processing
+  queue: {
+    name: "Queue/Jobs",
+    description: "Background jobs with Bull/BullMQ & cron scheduling",
+    category: "Background Processing"
+  },
+  "media-processing": {
+    name: "Media Processing",
+    description: "Image/video processing with FFmpeg",
+    category: "Background Processing"
+  },
+  // Monitoring & Analytics
+  audit: {
+    name: "Audit Logs",
+    description: "Activity logging and audit trail",
+    category: "Monitoring & Analytics"
+  },
+  analytics: {
+    name: "Analytics/Metrics",
+    description: "Prometheus metrics & event tracking",
+    category: "Monitoring & Analytics"
+  },
+  // Internationalization
+  i18n: {
+    name: "i18n/Localization",
+    description: "Multi-language support with 7+ locales",
+    category: "Internationalization"
+  },
+  // API Management
+  "feature-flag": {
+    name: "Feature Flags",
+    description: "A/B testing & progressive rollout",
+    category: "API Management"
+  },
+  "api-versioning": {
+    name: "API Versioning",
+    description: "Multiple API versions support",
+    category: "API Management"
+  },
+  // Payments
+  payment: {
+    name: "Payments",
+    description: "Payment processing (Stripe, PayPal, Mobile Money)",
+    category: "Payments"
+  }
+};
+async function getInstalledModules() {
+  try {
+    const modulesDir = getModulesDir();
+    const entries = await import_promises5.default.readdir(modulesDir, { withFileTypes: true });
+    return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+  } catch {
+    return [];
+  }
+}
+function isServercraftProject() {
+  try {
+    getProjectRoot();
+    return true;
+  } catch {
+    return false;
+  }
+}
+var listCommand = new import_commander6.Command("list").alias("ls").description("List available and installed modules").option("-a, --available", "Show only available modules").option("-i, --installed", "Show only installed modules").option("-c, --category <category>", "Filter by category").option("--json", "Output as JSON").action(
+  async (options) => {
+    const installedModules = await getInstalledModules();
+    const isProject = isServercraftProject();
+    if (options.json) {
+      const output = {
+        available: Object.entries(AVAILABLE_MODULES2).map(([key, mod]) => ({
+          id: key,
+          ...mod,
+          installed: installedModules.includes(key)
+        }))
+      };
+      if (isProject) {
+        output.installed = installedModules;
+      }
+      console.log(JSON.stringify(output, null, 2));
+      return;
+    }
+    const byCategory = {};
+    for (const [key, mod] of Object.entries(AVAILABLE_MODULES2)) {
+      if (options.category && mod.category.toLowerCase() !== options.category.toLowerCase()) {
+        continue;
+      }
+      if (!byCategory[mod.category]) {
+        byCategory[mod.category] = [];
+      }
+      byCategory[mod.category].push({
+        id: key,
+        name: mod.name,
+        description: mod.description,
+        installed: installedModules.includes(key)
+      });
+    }
+    if (options.installed) {
+      if (!isProject) {
+        console.log(import_chalk10.default.yellow("\n\u26A0 Not in a Servcraft project directory\n"));
+        return;
+      }
+      console.log(import_chalk10.default.bold("\n\u{1F4E6} Installed Modules:\n"));
+      if (installedModules.length === 0) {
+        console.log(import_chalk10.default.gray("  No modules installed yet.\n"));
+        console.log(`  Run ${import_chalk10.default.cyan("servcraft add <module>")} to add a module.
+`);
+        return;
+      }
+      for (const modId of installedModules) {
+        const mod = AVAILABLE_MODULES2[modId];
+        if (mod) {
+          console.log(`  ${import_chalk10.default.green("\u2713")} ${import_chalk10.default.cyan(modId.padEnd(18))} ${mod.name}`);
+        } else {
+          console.log(
+            `  ${import_chalk10.default.green("\u2713")} ${import_chalk10.default.cyan(modId.padEnd(18))} ${import_chalk10.default.gray("(custom module)")}`
+          );
+        }
+      }
+      console.log(`
+  Total: ${import_chalk10.default.bold(installedModules.length)} module(s) installed
+`);
+      return;
+    }
+    console.log(import_chalk10.default.bold("\n\u{1F4E6} Available Modules\n"));
+    if (isProject) {
+      console.log(
+        import_chalk10.default.gray(`  ${import_chalk10.default.green("\u2713")} = installed    ${import_chalk10.default.dim("\u25CB")} = not installed
+`)
+      );
+    }
+    for (const [category, modules] of Object.entries(byCategory)) {
+      console.log(import_chalk10.default.bold.blue(`  ${category}`));
+      console.log(import_chalk10.default.gray("  " + "\u2500".repeat(40)));
+      for (const mod of modules) {
+        const status = isProject ? mod.installed ? import_chalk10.default.green("\u2713") : import_chalk10.default.dim("\u25CB") : " ";
+        const nameColor = mod.installed ? import_chalk10.default.green : import_chalk10.default.cyan;
+        console.log(`  ${status} ${nameColor(mod.id.padEnd(18))} ${mod.name}`);
+        console.log(`    ${import_chalk10.default.gray(mod.description)}`);
+      }
+      console.log();
+    }
+    const totalAvailable = Object.keys(AVAILABLE_MODULES2).length;
+    const totalInstalled = installedModules.filter((m) => AVAILABLE_MODULES2[m]).length;
+    console.log(import_chalk10.default.gray("\u2500".repeat(50)));
+    console.log(
+      `  ${import_chalk10.default.bold(totalAvailable)} modules available` + (isProject ? ` | ${import_chalk10.default.green.bold(totalInstalled)} installed` : "")
+    );
+    console.log();
+    console.log(import_chalk10.default.bold("  Usage:"));
+    console.log(`    ${import_chalk10.default.yellow("servcraft add <module>")}      Add a module`);
+    console.log(`    ${import_chalk10.default.yellow("servcraft list --installed")}  Show installed only`);
+    console.log(`    ${import_chalk10.default.yellow("servcraft list --category Security")}  Filter by category`);
+    console.log();
+  }
+);
+// src/cli/commands/remove.ts
+init_cjs_shims();
+var import_commander7 = require("commander");
+var import_path8 = __toESM(require("path"), 1);
+var import_ora7 = __toESM(require("ora"), 1);
+var import_chalk11 = __toESM(require("chalk"), 1);
+var import_promises6 = __toESM(require("fs/promises"), 1);
+var import_inquirer4 = __toESM(require("inquirer"), 1);
+init_error_handler();
+var removeCommand = new import_commander7.Command("remove").alias("rm").description("Remove an installed module from your project").argument("<module>", "Module to remove").option("-y, --yes", "Skip confirmation prompt").option("--keep-env", "Keep environment variables").action(async (moduleName, options) => {
+  const projectError = validateProject();
+  if (projectError) {
+    displayError(projectError);
+    return;
+  }
+  console.log(import_chalk11.default.bold.cyan("\n\u{1F5D1}\uFE0F  ServCraft Module Removal\n"));
+  const moduleDir = import_path8.default.join(getModulesDir(), moduleName);
+  try {
+    const exists = await import_promises6.default.access(moduleDir).then(() => true).catch(() => false);
+    if (!exists) {
+      displayError(
+        new (init_error_handler(), __toCommonJS(error_handler_exports)).ServCraftError(
+          `Module "${moduleName}" is not installed`,
+          [
+            `Run ${import_chalk11.default.cyan("servcraft list --installed")} to see installed modules`,
+            `Check the spelling of the module name`
+          ]
+        )
+      );
+      return;
+    }
+    const files = await import_promises6.default.readdir(moduleDir);
+    const fileCount = files.length;
+    if (!options?.yes) {
+      console.log(import_chalk11.default.yellow(`\u26A0  This will remove the "${moduleName}" module:`));
+      console.log(import_chalk11.default.gray(`   Directory: ${moduleDir}`));
+      console.log(import_chalk11.default.gray(`   Files: ${fileCount} file(s)`));
+      console.log();
+      const { confirm } = await import_inquirer4.default.prompt([
+        {
+          type: "confirm",
+          name: "confirm",
+          message: "Are you sure you want to remove this module?",
+          default: false
+        }
+      ]);
+      if (!confirm) {
+        console.log(import_chalk11.default.yellow("\n\u2716 Removal cancelled\n"));
+        return;
+      }
+    }
+    const spinner = (0, import_ora7.default)("Removing module...").start();
+    await import_promises6.default.rm(moduleDir, { recursive: true, force: true });
+    spinner.succeed(`Module "${moduleName}" removed successfully!`);
+    console.log("\n" + import_chalk11.default.bold("\u2713 Removed:"));
+    success(`  src/modules/${moduleName}/ (${fileCount} files)`);
+    if (!options?.keepEnv) {
+      console.log("\n" + import_chalk11.default.bold("\u{1F4CC} Manual cleanup needed:"));
+      info("  1. Remove environment variables related to this module from .env");
+      info("  2. Remove module imports from your main app file");
+      info("  3. Remove related database migrations if any");
+      info("  4. Update your routes if they reference this module");
+    } else {
+      console.log("\n" + import_chalk11.default.bold("\u{1F4CC} Manual cleanup needed:"));
+      info("  1. Environment variables were kept (--keep-env flag)");
+      info("  2. Remove module imports from your main app file");
+      info("  3. Update your routes if they reference this module");
+    }
+    console.log();
+  } catch (err) {
+    error(err instanceof Error ? err.message : String(err));
+    console.log();
+  }
+});
+// src/cli/commands/doctor.ts
+init_cjs_shims();
+var import_commander8 = require("commander");
+var import_chalk12 = __toESM(require("chalk"), 1);
+var doctorCommand = new import_commander8.Command("doctor").description("Diagnose project configuration and dependencies").action(async () => {
+  console.log(import_chalk12.default.bold.cyan("\nServCraft Doctor - Coming soon!\n"));
+});
 // src/cli/index.ts
-var program = new import_commander6.Command();
+var program = new import_commander9.Command();
 program.name("servcraft").description("Servcraft - A modular Node.js backend framework CLI").version("0.1.0");
 program.addCommand(initCommand);
 program.addCommand(generateCommand);
 program.addCommand(addModuleCommand);
 program.addCommand(dbCommand);
 program.addCommand(docsCommand);
+program.addCommand(listCommand);
+program.addCommand(removeCommand);
+program.addCommand(doctorCommand);
 program.parse();
 //# sourceMappingURL=index.cjs.map