mvc-faststart-express 1.0.0

package/index.js

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { execSync } from 'node:child_process';
+
+/**
+ * MernMvcGenerator - A zero-dependency CLI for scaffolding MERN backends.
+ * Uses native node:fs and ANSI colors for maximum performance and portability.
+ */
+class MernMvcGenerator {
+  constructor(projectName) {
+    this.projectName = projectName || 'mern-api-service';
+    this.targetDir = path.join(process.cwd(), this.projectName);
+    
+    this.colors = {
+      reset: "\x1b[0m",
+      bold: "\x1b[1m",
+      cyan: "\x1b[36m",
+      green: "\x1b[32m",
+      yellow: "\x1b[33m",
+      red: "\x1b[31m",
+    };
+  }
+
+  log(color, message, isBold = false) {
+    const style = isBold ? this.colors.bold : "";
+    console.log(`${style}${color}${message}${this.colors.reset}`);
+  }
+
+  getTemplates() {
+    return {
+      ".env": `PORT=5000\nMONGODB_URL=mongodb://127.0.0.1:27017/${this.projectName}\nNODE_ENV=development`,
+      
+      "package.json": JSON.stringify({
+        name: this.projectName,
+        version: "1.0.0",
+        type: "module",
+        main: "src/server.js",
+        scripts: {
+          "start": "node src/server.js",
+          "dev": "nodemon src/server.js"
+        }
+      }, null, 2),
+
+      "src/server.js": `import mongoose from 'mongoose';\nimport app from './app.js';\nimport './config/db.js';\n\nconst PORT = process.env.PORT || 5000;\n\napp.listen(PORT, () => {\n  console.log(\`🚀 Server running in \${process.env.NODE_ENV} mode on port \${PORT}\`);\n});`,
+
+      "src/app.js": `import express from 'express';\nimport cors from 'cors';\nimport helmet from 'helmet';\nimport routes from './routes/index.js';\nimport { errorConverter, errorHandler } from './middlewares/error.js';\nimport ApiError from './utils/ApiError.js';\n\nconst app = express();\napp.use(helmet());\napp.use(express.json());\napp.use(cors());\napp.use('/v1', routes);\n\napp.use((req, res, next) => {\n  next(new ApiError(404, 'Not found'));\n});\n\napp.use(errorConverter);\napp.use(errorHandler);\n\nexport default app;`,
+
+      "src/config/db.js": `import mongoose from 'mongoose';\nimport dotenv from 'dotenv';\ndotenv.config();\n\nmongoose.connect(process.env.MONGODB_URL)\n  .then(() => console.log('✅ Connected to MongoDB'))\n  .catch((err) => console.error('❌ MongoDB connection error:', err));`,
+
+      // --- NEW: MODELS FOLDER ---
+      "src/models/user.model.js": `import mongoose from 'mongoose';\n\nconst userSchema = mongoose.Schema(\n  {\n    name: { type: String, required: true },\n    email: { type: String, required: true, unique: true },\n    password: { type: String, required: true },\n  },\n  { timestamps: true }\n);\n\nconst User = mongoose.model('User', userSchema);\nexport default User;`,
+      
+      "src/models/index.js": `export { default as User } from './user.model.js';`,
+
+      "src/utils/catchAsync.js": `export default (fn) => (req, res, next) => {\n  Promise.resolve(fn(req, res, next)).catch((err) => next(err));\n};`,
+
+      "src/utils/ApiError.js": `class ApiError extends Error {\n  constructor(statusCode, message, isOperational = true, stack = '') {\n    super(message);\n    this.statusCode = statusCode;\n    this.isOperational = isOperational;\n    if (stack) { this.stack = stack; } else { Error.captureStackTrace(this, this.constructor); }\n  }\n}\nexport default ApiError;`,
+
+      "src/middlewares/error.js": `import ApiError from '../utils/ApiError.js';\n\nexport const errorConverter = (err, req, res, next) => {\n  let error = err;\n  if (!(error instanceof ApiError)) {\n    const statusCode = error.statusCode || 500;\n    const message = error.message || 'Internal Server Error';\n    error = new ApiError(statusCode, message, false, err.stack);\n  }\n  next(error);\n};\n\nexport const errorHandler = (err, req, res, next) => {\n  let { statusCode, message } = err;\n  res.status(statusCode).send({\n    code: statusCode, \n    message, \n    ...(process.env.NODE_ENV === 'development' && { stack: err.stack }),\n  });\n};`,
+
+      "src/routes/index.js": `import express from 'express';\nimport userRoute from './user.route.js';\nconst router = express.Router();\nrouter.use('/users', userRoute);\nexport default router;`,
+
+      "src/routes/user.route.js": `import express from 'express';\nimport { userController } from '../controllers/index.js';\nconst router = express.Router();\nrouter.get('/', userController.getUsers);\nexport default router;`,
+
+      "src/controllers/index.js": `export * as userController from './user.controller.js';`,
+      
+      "src/controllers/user.controller.js": `import catchAsync from '../utils/catchAsync.js';\nimport { userService } from '../services/index.js';\nexport const getUsers = catchAsync(async (req, res) => {\n  const users = await userService.queryUsers();\n  res.send(users);\n});`,
+
+      "src/services/index.js": `export * as userService from './user.service.js';`,
+      
+      // --- UPDATED: SERVICE LAYER CALLING MODEL ---
+      "src/services/user.service.js": `import User from '../models/user.model.js';\n\nexport const queryUsers = async () => {\n  // Logic to fetch users from MongoDB\n  return await User.find({});\n};`,
+    };
+  }
+
+  generate() {
+    this.log(this.colors.cyan, `\n🛠  Building Professional MERN Backend: ${this.projectName}\n`, true);
+
+    if (fs.existsSync(this.targetDir)) {
+      this.log(this.colors.red, `❌ Error: Directory "${this.projectName}" already exists.`);
+      process.exit(1);
+    }
+
+    try {
+      const templates = this.getTemplates();
+
+      Object.entries(templates).forEach(([filePath, content]) => {
+        const fullPath = path.join(this.targetDir, filePath);
+        const folderPath = path.dirname(fullPath);
+
+        if (!fs.existsSync(folderPath)) {
+          fs.mkdirSync(folderPath, { recursive: true });
+        }
+        
+        fs.writeFileSync(fullPath, content, 'utf8');
+      });
+
+      this.log(this.colors.green, "✅ File structure and templates created.");
+
+      this.log(this.colors.yellow, "📦 Running npm install...");
+      execSync(`cd "${this.targetDir}" && npm install express mongoose dotenv cors helmet`, { stdio: 'inherit' });
+      execSync(`cd "${this.targetDir}" && npm install -D nodemon`, { stdio: 'inherit' });
+
+      this.log(this.colors.green, `\n✨ Successfully created ${this.projectName}!`, true);
+      this.log(this.colors.white, `\nNext steps:\n  1. cd ${this.projectName}\n  2. npm run dev\n`);
+
+    } catch (error) {
+      this.log(this.colors.red, `💥 Fatal Error: ${error.message}`);
+      process.exit(1);
+    }
+  }
+}
+
+const generator = new MernMvcGenerator(process.argv[2]);
+generator.generate();

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "mvc-faststart-express", 
+  "version": "1.0.0",
+  "description": "A zero-dependency CLI for scaffolding production-ready MERN MVC architecture",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "mvc-faststart-express": "index.js"
+  },
+  "keywords": ["express", "mvc", "mern", "boilerplate", "cli", "generator"],
+  "author": "Vinay Kumar",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {}
+}