nexpgen 1.0.0

package/.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

package/README.md

@@ -0,0 +1,517 @@
+# nexpgen
+
+A powerful CLI tool for generating code files from templates with support for multiple architectures and function styles. Built by **CodevNexus**.
+
+## 📋 Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Usage Guide](#usage-guide)
+- [Architecture Options](#architecture-options)
+- [Function Styles](#function-styles)
+- [Helper Files](#helper-files)
+- [Configuration](#configuration)
+- [Examples](#examples)
+- [Project Structure](#project-structure)
+- [Contributing](#contributing)
+- [License](#license)
+
+## ✨ Features
+
+- 🏗️ **Multiple Architecture Support**: MVC, Microservices, Layered, Clean Architecture, and Simple Structure
+- 🎨 **Function Style Options**: Class-based or Arrow function styles
+- 📦 **Package Integration**: Automatically integrates dotenv, helmet, multer, and custom helpers
+- 📁 **Smart File Generation**: Generate multiple files at once with nested directory support
+- 🔧 **Template-Based**: Easy to customize templates for your needs
+- 🛡️ **Production-Ready**: Comprehensive error handling and input validation
+- 📝 **CamelCase Variables**: Automatic variable naming conversion
+- ⚙️ **Configuration-Driven**: Remembers your preferences
+- 🚀 **CRUD Generator**: Generate complete CRUD operations in one command ⭐ **NEW!**
+- 🛣️ **Route Generation**: Auto-generate REST API routes ⭐ **NEW!**
+- 🛡️ **Middleware Generation**: Generate auth, validation, error handling middleware ⭐ **NEW!**
+
+## 🚀 Installation
+
+### Global Installation (Recommended)
+
+```bash
+npm install -g nexpgen
+```
+
+### Local Installation
+
+```bash
+npm install nexpgen --save-dev
+```
+
+### Verify Installation
+
+```bash
+nexpgen --version
+```
+
+## 🎯 Quick Start
+
+### 1. Initialize a New Project
+
+```bash
+nexpgen init
+```
+
+This will prompt you with interactive questions:
+- Package name
+- Architecture type
+- Function style preference
+- Additional packages to include
+
+### 2. Generate Files
+
+```bash
+nexpgen generate controller user
+nexpgen generate service product
+```
+
+## 📖 Usage Guide
+
+### Initialize Command
+
+```bash
+nexpgen init
+```
+
+**What it does:**
+- Creates project directory structure based on selected architecture
+- Generates `server.js` entry point file
+- Creates `package.json` with dependencies
+- Sets up helper files (if selected)
+- Creates `.env.example` (if dotenv selected)
+- Saves configuration to `.nexpgenrc`
+
+**Example:**
+```bash
+$ nexpgen init
+🚀 Initializing project...
+
+? What is your package name? my-awesome-app
+? Which architecture do you want to use? MVC (Model-View-Controller)
+? What function style do you prefer? Arrow functions with module.exports
+? Select additional packages you want to include: dotenv, helmet, imageUpload
+
+✅ Configuration saved to .nexpgenrc
+📁 Created directory: src/controllers
+📁 Created directory: src/services
+...
+✨ Project initialized successfully!
+```
+
+### Generate Command
+
+```bash
+nexpgen generate <type> <name> [options]
+# or shorthand
+nexpgen g <type> <name> [options]
+```
+
+**Types:**
+- `controller` - Generate controller files (with full CRUD methods)
+- `service` - Generate service files (with full CRUD methods)
+- `util` - Generate utility files
+- `error` - Generate error class files
+- `route` - Generate route files (REST API routes)
+- `middleware` - Generate middleware files (auth, validation, errorHandler, rateLimit)
+- `crud` - Generate complete CRUD (controller + service + routes) ⭐ **NEW!**
+
+**Options:**
+- `-d, --directory <dir>` - Output directory (default: `src`)
+
+**Examples:**
+
+```bash
+# Generate single file
+nexpgen generate controller user
+
+# Generate multiple files
+nexpgen generate controller user,product,category
+
+# Generate complete CRUD (controller + service + routes) ⭐ NEW!
+nexpgen generate crud user
+
+# Generate routes
+nexpgen generate route product
+
+# Generate middleware
+nexpgen generate middleware auth
+nexpgen generate middleware validation
+nexpgen generate middleware errorHandler
+
+# Generate with nested paths
+nexpgen generate controller admin/user
+nexpgen generate controller admin/front/dashboard
+
+# Generate in custom directory
+nexpgen generate service auth -d app/services
+
+# Generate multiple files with nested paths
+nexpgen generate service admin/auth,admin/users,front/products
+```
+
+## 🏛️ Architecture Options
+
+### MVC (Model-View-Controller)
+```
+src/
+├── controllers/
+├── models/
+├── views/
+├── routes/
+├── middleware/
+├── config/
+└── utils/
+public/
+├── css/
+├── js/
+└── images/
+config/
+└── uploads/
+    └── images/
+```
+
+### Microservices
+```
+services/
+├── api-gateway/
+│   ├── src/
+│   ├── public/
+│   └── config/
+├── user-service/
+│   ├── src/
+│   └── config/
+└── shared/
+public/
+config/
+```
+
+### Layered Architecture
+```
+src/
+├── presentation/
+├── business/
+├── data/
+└── infrastructure/
+public/
+config/
+```
+
+### Clean Architecture
+```
+src/
+├── domain/
+├── application/
+├── infrastructure/
+└── presentation/
+public/
+config/
+```
+
+### Simple Structure
+```
+src/
+├── controllers/
+├── services/
+├── routes/
+├── utils/
+└── config/
+public/
+config/
+```
+
+## 💻 Function Styles
+
+### Class-Based Style
+
+```javascript
+class UserController {
+  constructor() {
+    this.name = 'user';
+  }
+  
+  async handle(req, res, next) {
+    try {
+      // Controller logic
+      res.json({ message: 'Success' });
+    } catch (error) {
+      next(error);
+    }
+  }
+}
+
+module.exports = UserController;
+```
+
+### Arrow Function Style
+
+```javascript
+const handle = async (req, res, next) => {
+  try {
+    // Controller logic
+    res.json({ message: 'Success' });
+  } catch (error) {
+    next(error);
+  }
+};
+
+const getById = async (req, res, next) => {
+  // Get by ID logic
+};
+
+module.exports = {
+  handle,
+  getById
+};
+```
+
+## 🛠️ Helper Files
+
+### Image Upload Helper
+
+If selected during initialization, creates `src/utils/imageUploadHelper.js`:
+
+**Usage:**
+```javascript
+const imageUpload = require('./src/utils/imageUploadHelper');
+
+// Single file upload
+router.post('/upload', imageUpload.getSingleUpload('image'), (req, res) => {
+  if (req.file) {
+    res.json({ 
+      message: 'File uploaded successfully',
+      file: req.file.filename,
+      path: req.file.path
+    });
+  }
+});
+
+// Multiple files upload
+router.post('/upload-multiple', imageUpload.getMultipleUpload('images', 5), (req, res) => {
+  res.json({ files: req.files });
+});
+
+// Delete file
+imageUpload.deleteFile('config/uploads/images/file-123456789.jpg');
+```
+
+**Features:**
+- Stores uploaded images in `config/uploads/images/`
+- Validates file types (jpeg, jpg, png, gif, webp)
+- 5MB file size limit
+- Automatic directory creation
+
+### Time Converter Helper
+
+If selected during initialization, creates `src/utils/customHelp.js`:
+
+**Usage:**
+```javascript
+const timeConverter = require('./src/utils/customHelp');
+
+// Format date
+const formatted = timeConverter.format(new Date(), 'YYYY-MM-DD HH:mm:ss');
+
+// Add time
+const futureDate = timeConverter.addDays(new Date(), 7);
+const futureHour = timeConverter.addHours(new Date(), 2);
+
+// Calculate difference
+const daysDiff = timeConverter.differenceInDays(date1, date2);
+const hoursDiff = timeConverter.differenceInHours(date1, date2);
+
+// Compare dates
+const isBefore = timeConverter.isBefore(date1, date2);
+const isSameDay = timeConverter.isSameDay(date1, date2);
+```
+
+## ⚙️ Configuration
+
+Your preferences are saved in `.nexpgenrc`:
+
+```json
+{
+  "packageName": "my-app",
+  "architecture": "mvc",
+  "functionStyle": "arrow",
+  "packages": ["dotenv", "helmet", "imageUpload"]
+}
+```
+
+The generate command automatically uses these settings when creating files.
+
+## 📚 Examples
+
+### Example 1: Complete CRUD Setup ⭐ NEW!
+
+```bash
+# Initialize project
+nexpgen init
+# Select: MVC, Arrow functions, dotenv, helmet, imageUpload
+
+# Generate complete CRUD for resources (creates controller + service + routes)
+nexpgen generate crud user
+nexpgen generate crud product
+nexpgen generate crud order
+
+# Generate middleware
+nexpgen generate middleware auth
+nexpgen generate middleware errorHandler
+
+# Register routes in server.js (instructions provided after CRUD generation)
+```
+
+### Example 2: Complete MVC Project Setup
+
+```bash
+# Initialize project
+nexpgen init
+# Select: MVC, Arrow functions, dotenv, helmet, imageUpload
+
+# Generate controllers
+nexpgen generate controller user,product,order
+
+# Generate services
+nexpgen generate service user,product,order
+
+# Generate nested admin controllers
+nexpgen generate controller admin/users,admin/products
+
+# Generate utilities
+nexpgen generate util validation,helpers
+```
+
+### Example 2: Microservices Setup
+
+```bash
+# Initialize microservices architecture
+nexpgen init
+# Select: Microservices, Class-based, all packages
+
+# Generate service-specific files
+cd services/user-service/src
+nexpgen generate controller user
+nexpgen generate service user
+```
+
+### Example 4: Using Generated Files
+
+```javascript
+// src/controllers/user.controller.js (Arrow function style)
+const getById = async (req, res, next) => {
+  try {
+    const { id } = req.params;
+    const userData = await userService.getById(id);
+    res.json({ success: true, data: userData });
+  } catch (error) {
+    next(error);
+  }
+};
+
+module.exports = { getById };
+
+// src/routes/userRoutes.js
+const express = require('express');
+const router = express.Router();
+const userController = require('../controllers/user.controller');
+
+router.get('/:id', userController.getById);
+
+module.exports = router;
+
+// server.js
+const userRoutes = require('./src/routes/userRoutes');
+app.use('/api/users', userRoutes);
+```
+
+## 📁 Project Structure
+
+```
+nexpgen/
+├── bin/
+│   └── cli.js                    # CLI entry point
+├── src/
+│   ├── commands/
+│   │   ├── generate.js           # Generate command
+│   │   └── init.js               # Init command
+│   ├── templates/
+│   │   ├── servers/              # Server templates
+│   │   ├── helpers/              # Helper templates
+│   │   ├── controller.template
+│   │   ├── service.template
+│   │   ├── util.template
+│   │   └── error.template
+│   └── utils/
+│       ├── fileGenerator.js       # File generation utility
+│       └── architectureGenerator.js # Architecture setup
+├── package.json
+└── README.md
+```
+
+## 🔧 Advanced Usage
+
+### Custom Templates
+
+You can customize templates by modifying files in `node_modules/nexpgen/src/templates/` or by copying them to your project.
+
+### Environment Variables
+
+If dotenv is selected, create a `.env` file:
+
+```env
+PORT=3000
+NODE_ENV=development
+DATABASE_URL=your_database_url
+```
+
+### Static Files
+
+Place static files in the `public/` directory:
+- CSS files → `public/css/`
+- JavaScript files → `public/js/`
+- Images → `public/images/`
+
+The server automatically serves these files.
+
+### Uploaded Files
+
+Uploaded images are stored in `config/uploads/images/`. Make sure this directory is:
+- Included in `.gitignore` (for production)
+- Has proper write permissions
+- Backed up regularly (if needed)
+
+## 🐛 Troubleshooting
+
+### Issue: Template not found
+**Solution:** Ensure nexpgen is properly installed: `npm install -g nexpgen`
+
+### Issue: Permission denied
+**Solution:** Check file/directory permissions. On Linux/Mac, you may need `sudo` for global installation.
+
+### Issue: Invalid package name
+**Solution:** Package names must follow npm naming conventions. Use lowercase letters, numbers, hyphens, and underscores only.
+
+### Issue: File already exists
+**Solution:** The tool won't overwrite existing files. Rename or delete the existing file first.
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 📄 License
+
+ISC
+
+## 👨‍💻 Author
+
+**CodevNexus**
+
+---
+
+Made with ❤️ by CodevNexus

package/bin/cli.js

@@ -0,0 +1,58 @@
+const { program } = require('commander');
+const generateCommand = require('../src/commands/generate');
+const initCommand = require('../src/commands/init');
+
+process.on('uncaughtException', (error) => {
+  console.error('❌ Uncaught Exception:', error.message);
+  process.exit(1);
+});
+
+process.on('unhandledRejection', (reason, promise) => {
+  console.error('❌ Unhandled Rejection at:', promise, 'reason:', reason);
+  process.exit(1);
+});
+
+program
+  .name('nexpgen')
+  .description('A CLI tool for generating code files from templates')
+  .version('1.0.0');
+
+program
+  .command('init')
+  .description('Initialize a new project')
+  .action(async () => {
+    try {
+      await initCommand();
+    } catch (error) {
+      console.error(`❌ Init command failed: ${error.message}`);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('generate')
+  .alias('g')
+  .description('Generate code files from templates')
+  .argument('<type>', 'Type of file to generate (controller, service, util, error, route, middleware, crud)')
+  .argument('<name>', 'Name of the file to generate')
+  .option('-d, --directory <dir>', 'Output directory', 'src')
+  .action(async (type, name, options) => {
+    try {
+      if (!type || !name) {
+        console.error('❌ Error: Type and name are required');
+        process.exit(1);
+      }
+      await generateCommand(type, name, options);
+    } catch (error) {
+      console.error(`❌ Generate command failed: ${error.message}`);
+      process.exit(1);
+    }
+  });
+
+program.on('command:*', () => {
+  console.error(`❌ Invalid command: ${program.args.join(' ')}`);
+  console.error('See --help for a list of available commands.');
+  process.exit(1);
+});
+
+program.parse();

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "nexpgen",
+  "version": "1.0.0",
+  "description": "A powerful CLI tool for generating code files from templates with support for multiple architectures (MVC, Microservices, Clean Architecture) and function styles. Built by CodevNexus.",
+  "main": "index.js",
+  "bin": {
+    "nexpgen": "./bin/cli.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "cli",
+    "generator",
+    "template",
+    "code-generator",
+    "scaffold",
+    "boilerplate",
+    "mvc",
+    "microservices",
+    "clean-architecture",
+    "layered-architecture",
+    "express",
+    "nodejs",
+    "codevnexus"
+  ],
+  "author": "CodevNexus",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/9Bit-Dark-knight/nexpgen.git"
+  },
+  "bugs": {
+    "url": "https://github.com/9Bit-Dark-knight/nexpgen/issues"
+  },
+  "homepage": "https://github.com/9Bit-Dark-knight/nexpgen#readme",
+  "dependencies": {
+    "commander": "^11.0.0",
+    "inquirer": "^9.2.12"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}