exp-node-server 1.1.0

package/src/utils/swaggerInjector.js

@@ -0,0 +1,52 @@
+import chalk from "chalk";
+import fs from "fs";
+import path from "path";
+
+export function injectSwagger(name) {
+
+    const swaggerFile = path.join(process.cwd(), "src/swaggerOptions.ts");
+
+    if (!fs.existsSync(swaggerFile)) {
+        console.log(chalk.yellow("⚠️ swaggerOptions.ts not found"));
+        return;
+    }
+
+    let content = fs.readFileSync(swaggerFile, "utf-8");
+
+    const importLine = `import { ${name}SwaggerDocs } from "./app/modules/${name}/${name}.swagger";`;
+    const spreadLine = `      ...${name}SwaggerDocs,`;
+
+
+    if (!content.includes(importLine)) {
+
+        const lastImportIndex = content.lastIndexOf("import ");
+        const nextLine = content.indexOf("\n", lastImportIndex);
+
+        content =
+            content.slice(0, nextLine + 1) +
+            importLine +
+            "\n" +
+            content.slice(nextLine + 1);
+    }
+
+    if (!content.includes(spreadLine)) {
+
+        const match = content.match(/paths:\s*{([\s\S]*?)}/);
+
+        if (match) {
+
+            const pathsBlock = match[0];
+
+            const updatedBlock = pathsBlock.replace(
+                /}$/,
+                `${spreadLine}\n    }`
+            );
+
+            content = content.replace(pathsBlock, updatedBlock);
+        }
+    }
+
+    fs.writeFileSync(swaggerFile, content);
+
+    console.log(chalk.green(`✔ Swagger registered for ${name}`));
+}

package/src/utils/validateModuleName.js

@@ -0,0 +1,17 @@
+export function validateModuleName(name) {
+
+    if (!name) return null;
+
+    // convert space / dash → underscore
+    const normalized = name
+        .trim()
+        .toLowerCase()
+        .replace(/[-\s]+/g, "_");
+
+    // allow only a-z and underscore
+    const isValid = /^[a-z_]+$/.test(normalized);
+
+    if (!isValid) return null;
+
+    return normalized;
+}

package/src/utils/validateProjectName.js

@@ -0,0 +1,15 @@
+export function validateProjectName(name) {
+
+  if (!name) return null;
+
+  const normalized = name
+    .trim()
+    .toLowerCase()
+    .replace(/\s+/g, "-");
+
+  const isValid = /^[a-z0-9-]+$/.test(normalized);
+
+  if (!isValid) return null;
+
+  return normalized;
+}

package/src/utils/validationGenerator.js

@@ -0,0 +1,13 @@
+export const validationGenerator = (name) => {
+    return `
+import { z } from "zod";
+
+const create_${name} = z.object({});
+const update_${name} = z.object({});
+
+export const ${name}_validations = {
+  create_${name},
+  update_${name},
+};
+`
+}

package/src/utils.js

@@ -0,0 +1,26 @@
+import fs from "fs";
+import ora from "ora";
+import path from "path";
+
+export const createDir = (dir) => {
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+};
+
+export const createFile = (file, content) => {
+    const spinner = ora(`Creating ${path.basename(file)}...`).start();
+
+    try {
+        fs.writeFileSync(file, content);
+        spinner.succeed(`${path.basename(file)} created`);
+    } catch {
+        spinner.fail(`${path.basename(file)} failed`);
+    }
+};
+
+export const toSnakeCase = (str) =>
+    str.replace(/([a-z])([A-Z])/g, "$1_$2").toLowerCase();
+
+export const toPascalCase = (str) =>
+    str.charAt(0).toUpperCase() + str.slice(1);

package/templates/mongoose/.env.example

@@ -0,0 +1,23 @@
+NODE_ENV=development
+DATABASE_URL=
+PORT=5000
+
+
+# JWT Configuration
+ACCESS_TOKEN=
+REFRESH_TOKEN=
+ACCESS_EXPIRES=
+REFRESH_EXPIRES=
+RESET_SECRET=
+RESET_EXPIRES=
+VERIFIED_TOKEN=
+FRONT_END_URL=
+
+# Email Configuration
+APP_USER_EMAIL=
+APP_PASSWORD=
+
+# Cloudinary Configuration
+CLOUD_NAME=
+CLOUD_API_KEY=
+CLOUD_API_SECRET=

package/templates/mongoose/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "server",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "dev": "ts-node-dev --respawn --transpile-only src/server.ts",
+    "build": "tsc"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "commonjs",
+  "dependencies": {
+    "bcrypt": "^6.0.0",
+    "cloudinary": "^2.7.0",
+    "cookie-parser": "^1.4.7",
+    "cors": "^2.8.5",
+    "dotenv": "^17.2.3",
+    "express": "^5.1.0",
+    "jsonwebtoken": "^9.0.2",
+    "multer": "^2.0.2",
+    "nodemailer": "^7.0.9",
+    "pg": "^8.17.2",
+    "swagger-jsdoc": "^6.2.8",
+    "swagger-ui-express": "^5.0.1",
+    "ts-node-dev": "^2.0.0",
+    "zod": "^4.1.12"
+  },
+  "devDependencies": {
+    "@types/bcrypt": "^6.0.0",
+    "@types/cookie-parser": "^1.4.9",
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.3",
+    "@types/jsonwebtoken": "^9.0.10",
+    "@types/mongoose": "^5.11.96",
+    "@types/multer": "^2.0.0",
+    "@types/node": "^24.10.9",
+    "@types/nodemailer": "^7.0.2",
+    "@types/pg": "^8.16.0",
+    "@types/swagger-jsdoc": "^6.0.4",
+    "@types/swagger-ui-express": "^4.1.8"
+  }
+}

package/templates/mongoose/readme.md

@@ -0,0 +1,180 @@
+# ⚡ Express + Mongoose + TypeScript Module Generator
+
+[![npm version](https://img.shields.io/npm/v/exp-cli-gen.svg)](https://www.npmjs.com/package/exp-cli-gen)
+[![npm downloads](https://img.shields.io/npm/dw/exp-cli-gen.svg)](https://www.npmjs.com/package/exp-cli-gen)
+[![npm total downloads](https://img.shields.io/npm/dt/exp-cli-gen.svg)](https://www.npmjs.com/package/exp-cli-gen)
+[![GitHub stars](https://img.shields.io/github/stars/abumahid/mongo-server-stater-pack.svg)](https://github.com/abumahid/mongo-server-stater-pack/stargazers)
+[![GitHub issues](https://img.shields.io/github/issues/abumahid/mongo-server-stater-pack.svg)](https://github.com/abumahid/mongo-server-stater-pack/issues)
+[![License](https://img.shields.io/github/license/abumahid/mongo-server-stater-pack.svg)](https://github.com/abumahid/mongo-server-stater-pack/blob/main/LICENSE)
+[![GitHub last commit](https://img.shields.io/github/last-commit/abumahid/mongo-server-stater-pack.svg)](https://github.com/abumahid/mongo-server-stater-pack/commits/main)
+[![Made with TypeScript](https://img.shields.io/badge/Made%20with-TypeScript-blue.svg)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-18+-green.svg)](https://nodejs.org/)
+
+---
+
+## 🚀 Overview
+
+**exp-cli-gen** is a powerful **Express + TypeScript module generator** that uses **Mongoose** for database interaction.  
+It automatically creates a complete module structure — including **models, controllers, services, routes, Zod validations, and Swagger documentation** — all in one command.
+
+Ideal for developers who want to quickly scaffold modular Express APIs with clean architecture and ready-to-use integrations.
+
+---
+
+## ✨ Features
+
+- ⚙️ Generates full-featured Express + TypeScript modules  
+- 🧩 Automatically integrates Mongoose models and Zod validations  
+- 📘 Adds Swagger documentation automatically  
+- 🚀 Clones and sets up a ready-to-run Express starter project  
+- 🔁 Can add new modules anytime with a single command  
+- 🧠 Skips redundant setup if the starter pack already exists  
+- 💪 Built for scalability and maintainability
+
+---
+
+## 📦 Installation
+
+Install globally:
+
+```bash
+npm install -g exp-cli-gen
+```
+Or run directly using npx (recommended):
+
+```bash
+npx exp-cli-gen <module-name>
+```
+## Usage
+🏗️ Generate your first module
+
+Run:
+
+```bash
+npx exp-cli-gen test
+```
+First run example:
+
+```bash
+Need to install the following packages:
+exp-cli-gen@1.0.1
+Ok to proceed? (y)
+
+⠋ No Express project found. Cloning starter pack...
+✔ Starter project cloned!
+
+✔ Git logs removed!
+
+📦 Installing dependencies...
+
+🚀 Project setup complete.
+🧩 Generating module: test...
+✔ test.interface.ts created
+✔ test.schema.ts created
+✔ test.validation.ts created
+✔ test.route.ts created
+✔ test.controller.ts created
+✔ test.service.ts created
+✔ test.swagger.ts created
+
+🔗 Route added to src/app/routes.ts
+📘 Swagger doc added to src/swaggerOptions.ts
+✨ Module 'test' created successfully!
+
+```
+
+## 📁 Generated Module Structure
+
+Each generated module will contain the following files:
+
+```pgsql
+src/app/modules/<module-name>/
+ ├── <module-name>.interface.ts
+ ├── <module-name>.schema.ts
+ ├── <module-name>.validation.ts
+ ├── <module-name>.route.ts
+ ├── <module-name>.controller.ts
+ ├── <module-name>.service.ts
+ └── <module-name>.swagger.ts
+```
+
+## 🔄 Add More Modules
+
+Need another module? Just run:
+
+```bash
+npx exp-cli-gen products
+```
+
+If the starter project already exists, it will skip cloning and directly add the new module.
+
+Example output:
+```bash
+ℹ 📦 Starter folder already exists. Skipping clone.
+📦 Dependencies already installed. Skipping npm install.
+🧩 Generating module: products...
+✔ products files created
+✨ Module 'products' created successfully!
+
+src/app/modules/products/
+ ├── products.interface.ts
+ ├── products.schema.ts
+ ├── products.validation.ts
+ ├── products.route.ts
+ ├── products.controller.ts
+ ├── products.service.ts
+ └── products.swagger.ts
+```
+
+Then, refresh your Swagger docs at:
+```bash
+http://localhost:5000/docs
+```
+
+You’ll see your new routes automatically added.
+
+---
+
+## ⚙️ Configuration
+
+After setup, update your .env file following the .env.example file in the starter project.
+
+To start the server:
+```bash
+npm run dev
+```
+Open Swagger documentation at:
+```bash
+http://localhost:5000/docs
+```
+
+---
+## 🧠 Tech Stack
+
+- Express.js — Backend framework
+- TypeScript — Strongly typed JavaScript
+- Mongoose — MongoDB ORM
+- Zod — Runtime schema validation
+- Swagger — API documentation
+- CLI (Node.js) — Command-line automation
+
+---
+## 🧩 Starter Pack Repository
+
+This CLI uses the following base project as a starter:
+
+👉 [mongo-server-stater-pack](https://github.com/abumahid/mongo-server-stater-pack.git)
+
+---
+## 💬 Author
+
+Abu Mahid
+
+🧠 [GitHub Profile](https://github.com/abumahid)
+
+💼 [npm Profile](https://www.npmjs.com/~dev_abumahid)
+
+---
+### ⭐ Star this project
+
+If you like this CLI, please give it a ⭐ on GitHub — it helps others discover it too! Thank you!

package/templates/mongoose/src/app/configs/index.ts

@@ -0,0 +1,26 @@
+import "dotenv/config";
+
+export const configs = {
+  port: process.env.PORT,
+  env: process.env.NODE_ENV,
+  db_url: process.env.DATABASE_URL,
+  jwt: {
+    access_token: process.env.ACCESS_TOKEN,
+    refresh_token: process.env.REFRESH_TOKEN,
+    access_expires: process.env.ACCESS_EXPIRES,
+    refresh_expires: process.env.REFRESH_EXPIRES,
+    reset_secret: process.env.RESET_SECRET,
+    reset_expires: process.env.RESET_EXPIRES,
+    front_end_url: process.env.FRONT_END_URL,
+    verified_token: process.env.VERIFIED_TOKEN,
+  },
+  email: {
+    app_email: process.env.APP_USER_EMAIL,
+    app_password: process.env.APP_PASSWORD,
+  },
+  cloudinary: {
+    cloud_name: process.env.CLOUD_NAME,
+    cloud_api_key: process.env.CLOUD_API_KEY,
+    cloud_api_secret: process.env.CLOUD_API_SECRET,
+  },
+};

package/templates/mongoose/src/app/errors/castError.ts

@@ -0,0 +1,23 @@
+import mongoose from 'mongoose'
+import { TErrorSources, TGenericErrorResponse } from '../types/error'
+
+const handleCastError = (
+    err: mongoose.Error.CastError
+): TGenericErrorResponse => {
+    const errorSources: TErrorSources= [
+        {
+            path: err.path,
+            message: err.message
+        }
+    ]
+
+    const statusCode = 400
+
+    return {
+        statusCode,
+        message: 'Invalid ID',
+        errorSources
+    }
+}
+
+export default handleCastError

package/templates/mongoose/src/app/errors/duplicateError.ts

@@ -0,0 +1,26 @@
+import { TErrorSources, TGenericErrorResponse } from '../types/error'
+
+const handleDuplicateError = (err: any): TGenericErrorResponse => {
+    // Extract value within double quotes using regex
+    const match = err.message.match(/"([^"]*)"/)
+
+    // The extracted value will be in the first capturing group
+    const extractedMessage = match && match[1]
+
+    const errorSources: TErrorSources = [
+        {
+            path: '',
+            message: `${extractedMessage} is already exists`
+        }
+    ]
+
+    const statusCode = 400
+
+    return {
+        statusCode,
+        message: 'Invalid ID',
+        errorSources
+    }
+}
+
+export default handleDuplicateError

package/templates/mongoose/src/app/errors/validationError.ts

@@ -0,0 +1,25 @@
+import mongoose from 'mongoose'
+import { TErrorSources, TGenericErrorResponse } from '../types/error'
+
+const handleValidationError = (
+    err: mongoose.Error.ValidationError
+): TGenericErrorResponse => {
+    const errorSources: TErrorSources = Object.values(err.errors).map(
+        (val: mongoose.Error.ValidatorError | mongoose.Error.CastError) => {
+            return {
+                path: val?.path,
+                message: val?.message
+            }
+        }
+    )
+
+    const statusCode = 400
+
+    return {
+        statusCode,
+        message: 'Validation Error',
+        errorSources
+    }
+}
+
+export default handleValidationError

package/templates/mongoose/src/app/errors/zodError.ts

@@ -0,0 +1,20 @@
+import { ZodError, ZodIssue } from 'zod'
+import { TErrorSources, TGenericErrorResponse } from '../types/error'
+
+const handleZodError = (err: ZodError): TGenericErrorResponse => {
+    const errorSources: TErrorSources = err.issues.map((issue: ZodIssue) => {
+        return {
+            path: issue?.path[issue.path.length - 1] as string,
+            message: issue.message
+        }
+    })
+
+    const statusCode = 400
+    return {
+        statusCode,
+        message: 'Validation Error',
+        errorSources
+    }
+}
+
+export default handleZodError

package/templates/mongoose/src/app/middlewares/auth.ts

@@ -0,0 +1,50 @@
+import { NextFunction, Request, Response } from 'express';
+import { AppError } from '../utils/app_error';
+import { configs } from '../configs';
+import { jwtHelpers, JwtPayloadType } from '../utils/JWT';
+import { Account_Model } from '../modules/auth/auth.schema';
+
+
+type Role = "ADMIN" | "USER"
+
+
+const auth = (...roles: Role[]) => {
+    return async (req: Request, res: Response, next: NextFunction) => {
+        try {
+            const token = req.headers.authorization;
+            if (!token) {
+                throw new AppError('You are not authorize!!', 401);
+            }
+            const verifiedUser = jwtHelpers.verifyToken(
+                token,
+                configs.jwt.access_token as string,
+            );
+            if (!roles.length || !roles.includes(verifiedUser.role)) {
+                throw new AppError('You are not authorize!!', 401);
+            }
+            // check user
+            const isUserExist = await Account_Model.findOne({ email: verifiedUser?.email }).lean()
+            if (!isUserExist) {
+                throw new AppError("Account not found !", 404)
+            }
+            if (isUserExist?.accountStatus == "SUSPENDED") {
+                throw new AppError("This Account is suspended !", 401)
+            }
+            if (isUserExist?.accountStatus == "INACTIVE") {
+                throw new AppError("This Account is inactive !", 401)
+            }
+            if (isUserExist?.isDeleted) {
+                throw new AppError("This account is deleted", 401)
+            }
+            if (!isUserExist?.isVerified) {
+                throw new AppError("This account is not verified ", 401)
+            }
+            req.user = verifiedUser as JwtPayloadType;
+            next();
+        } catch (err) {
+            next(err);
+        }
+    };
+};
+
+export default auth;

package/templates/mongoose/src/app/middlewares/global_error_handler.ts

@@ -0,0 +1,69 @@
+import { Request, Response, NextFunction, ErrorRequestHandler } from 'express'
+import { ZodError } from 'zod'
+import handleZodError from '../errors/zodError'
+import handleValidationError from '../errors/validationError'
+import handleCastError from '../errors/castError'
+import { TErrorSources } from '../types/error'
+import handleDuplicateError from '../errors/duplicateError'
+import { AppError } from '../utils/app_error'
+import { configs } from '../configs'
+
+const globalErrorHandler: ErrorRequestHandler = (err, req, res, next) => {
+    let statusCode = 500
+    let message = 'Something went wrong!'
+    let errorSources: TErrorSources = [
+        {
+            path: '',
+            message: 'Something went wrong'
+        }
+    ]
+
+    if (err instanceof ZodError) {
+        const simplifiedError = handleZodError(err)
+        statusCode = simplifiedError?.statusCode
+        message = simplifiedError?.message
+        errorSources = simplifiedError?.errorSources
+    } else if (err?.name === 'ValidationError') {
+        const simplifiedError = handleValidationError(err)
+        statusCode = simplifiedError?.statusCode
+        message = simplifiedError?.message
+        errorSources = simplifiedError?.errorSources
+    } else if (err?.name === 'CastError') {
+        const simplifiedError = handleCastError(err)
+        statusCode = simplifiedError?.statusCode
+        message = simplifiedError?.message
+        errorSources = simplifiedError?.errorSources
+    } else if (err?.code === 11000) {
+        const simplifiedError = handleDuplicateError(err)
+        statusCode = simplifiedError?.statusCode
+        message = simplifiedError?.message
+        errorSources = simplifiedError?.errorSources
+    } else if (err instanceof AppError) {
+        statusCode = err?.statusCode
+        message = err.message
+        errorSources = [
+            {
+                path: '',
+                message: err?.message
+            }
+        ]
+    } else if (err instanceof Error) {
+        message = err.message
+        errorSources = [
+            {
+                path: '',
+                message: err?.message
+            }
+        ]
+    }
+
+    res.status(statusCode).json({
+        success: false,
+        message,
+        errorSources,
+        err,
+        stack: configs.env === 'development' ? err?.stack : null
+    })
+}
+
+export default globalErrorHandler

package/templates/mongoose/src/app/middlewares/not_found_api.ts

@@ -0,0 +1,10 @@
+import { Request, Response, NextFunction } from 'express';
+
+const notFound = (req: Request, res: Response, next: NextFunction) => {
+    res.status(404).json({
+        message: 'Sorry Route is not found!! 😴😴😴',
+        success: false,
+        error: '',
+    });
+};
+export default notFound;

package/templates/mongoose/src/app/middlewares/request_validator.ts

@@ -0,0 +1,14 @@
+import { NextFunction, Request, Response } from 'express';
+
+const RequestValidator = (schema: any) => {
+    return async (req: Request, res: Response, next: NextFunction) => {
+        try {
+            await schema.parseAsync(req.body);
+            next();
+        } catch (err) {
+            next(err);
+        }
+    };
+};
+
+export default RequestValidator;

package/templates/mongoose/src/app/middlewares/uploader.ts

@@ -0,0 +1,16 @@
+import multer from "multer";
+import path from "path";
+
+const storage = multer.diskStorage({
+    destination: function (req, file, cb) {
+        cb(null, path.join(process.cwd(), "uploads"))
+    },
+    filename: function (req, file, cb) {
+
+        cb(null, file.originalname)
+    }
+})
+
+const uploader = multer({ storage: storage })
+
+export default uploader;