build-app-with 2.0.0

package/src/generators/express/templates/middleware.js

@@ -0,0 +1,59 @@
+/**
+ * Generate middleware template
+ */
+
+export function generateMiddleware(projectPath, answers) {
+    const middlewareContent = `import { logger } from '../utils/logger.js';
+
+export const requestLogger = (req, res, next) => {
+  const start = Date.now();
+  
+  res.on('finish', () => {
+    const duration = Date.now() - start;
+    logger.info(\`\${req.method} \${req.url} - \${res.statusCode} - \${duration}ms\`);
+  });
+  
+  next();
+};
+
+export const notFound = (req, res, next) => {
+  const error = new Error(\`Not found - \${req.originalUrl}\`);
+  res.status(404);
+  next(error);
+};
+
+export const errorHandler = (err, req, res, next) => {
+  let error = { ...err };
+  error.message = err.message;
+
+  // Log error
+  logger.error(err);
+
+  // Mongoose bad ObjectId
+  if (err.name === 'CastError') {
+    const message = 'Resource not found';
+    error = { message, statusCode: 404 };
+  }
+
+  // Mongoose duplicate key
+  if (err.code === 11000) {
+    const message = 'Duplicate field value entered';
+    error = { message, statusCode: 400 };
+  }
+
+  // Mongoose validation error
+  if (err.name === 'ValidationError') {
+    const message = Object.values(err.errors).map(val => val.message).join(', ');
+    error = { message, statusCode: 400 };
+  }
+
+  res.status(error.statusCode || 500).json({
+    success: false,
+    error: error.message || 'Server Error',
+    ...(process.env.NODE_ENV === 'development' && { stack: err.stack })
+  });
+};
+`;
+
+    return middlewareContent;
+}

package/src/generators/express/templates/models.js

@@ -0,0 +1,77 @@
+/**
+ * Generate models template
+ */
+
+import { DATABASES } from '../../../types/index.js';
+
+export function generateModels(projectPath, answers) {
+    if (answers.database === DATABASES.MONGODB) {
+        return generateMongooseModels(answers);
+    } else if (answers.database === DATABASES.POSTGRESQL || answers.database === DATABASES.SQLITE) {
+        return generatePrismaModels(answers);
+    } else if (answers.database === DATABASES.MYSQL) {
+        return generateSequelizeModels(answers);
+    }
+    return '';
+}
+
+function generateMongooseModels(answers) {
+    return `import mongoose from 'mongoose';
+
+const userSchema = new mongoose.Schema({
+  name: {
+    type: String,
+    required: true,
+    trim: true
+  },
+  email: {
+    type: String,
+    required: true,
+    unique: true,
+    lowercase: true,
+    trim: true
+  },
+  password: {
+    type: String,
+    required: true,
+    minlength: 6
+  }
+}, {
+  timestamps: true
+});
+
+export const User = mongoose.model('User', userSchema);
+`;
+}
+
+function generatePrismaModels(answers) {
+    return `// Prisma schema will be generated in schema.prisma
+// This is a placeholder for Prisma models
+
+export const prisma = new PrismaClient();
+`;
+}
+
+function generateSequelizeModels(answers) {
+    return `import { DataTypes } from 'sequelize';
+import { sequelize } from '../config/database.js';
+
+export const User = sequelize.define('User', {
+  name: {
+    type: DataTypes.STRING,
+    allowNull: false
+  },
+  email: {
+    type: DataTypes.STRING,
+    allowNull: false,
+    unique: true
+  },
+  password: {
+    type: DataTypes.STRING,
+    allowNull: false
+  }
+}, {
+  timestamps: true
+});
+`;
+}

package/src/generators/express/templates/package-json.js

@@ -0,0 +1,55 @@
+/**
+ * Generate package.json for Express.js project
+ */
+
+import { FRAMEWORKS, DATABASES, AUTH_STRATEGIES } from '../../../types/index.js';
+
+export function generatePackageJson(answers) {
+    const basePackage = {
+        name: answers.projectName,
+        version: '1.0.0',
+        description: `A production-ready Express.js application - ${answers.projectName}`,
+        main: 'src/server.js',
+        type: 'module',
+        scripts: {
+            start: 'node src/server.js',
+            dev: 'nodemon src/server.js',
+            test: answers.includeTests ? 'jest' : undefined,
+            'test:watch': answers.includeTests ? 'jest --watch' : undefined,
+            'test:coverage': answers.includeTests ? 'jest --coverage' : undefined
+        },
+        keywords: [
+            'express',
+            'nodejs',
+            'api',
+            'backend',
+            'server',
+            'rest',
+            'production-ready'
+        ],
+        author: 'Generated by build-app-with',
+        license: 'MIT',
+        engines: {
+            node: '>=18.0.0'
+        },
+        dependencies: {},
+        devDependencies: {}
+    };
+
+    // Add database-specific scripts
+    if (answers.database === DATABASES.POSTGRESQL || answers.database === DATABASES.SQLITE) {
+        basePackage.scripts['db:generate'] = 'prisma generate';
+        basePackage.scripts['db:push'] = 'prisma db push';
+        basePackage.scripts['db:migrate'] = 'prisma migrate dev';
+        basePackage.scripts['db:studio'] = 'prisma studio';
+    }
+
+    // Remove undefined scripts
+    Object.keys(basePackage.scripts).forEach(key => {
+        if (basePackage.scripts[key] === undefined) {
+            delete basePackage.scripts[key];
+        }
+    });
+
+    return basePackage;
+}

package/src/generators/express/templates/readme.js

@@ -0,0 +1,310 @@
+/**
+ * Generate README for Express.js project
+ */
+
+import { DATABASES, AUTH_STRATEGIES } from '../../../types/index.js';
+import { generateCreditsSection } from '../../../utils/credits.js';
+
+export function generateReadme(projectPath, answers) {
+    const selectedFeatures = Array.isArray(answers.features) ? answers.features : [];
+    const allFeatures = [...selectedFeatures];
+    if (answers.database && answers.database !== 'none') {
+        allFeatures.push(answers.database);
+    }
+    if (answers.authStrategy && answers.authStrategy !== 'none') {
+        allFeatures.push(answers.authStrategy);
+    }
+    if (answers.includeTests) {
+        allFeatures.push('jest');
+    }
+    if (answers.includeDocker) {
+        allFeatures.push('docker');
+    }
+
+    const credits = generateCreditsSection('express', allFeatures);
+
+    const readme = `# ${answers.projectName}
+
+A production-ready Express.js application built with modern best practices.
+
+## 🚀 Features
+
+- ⚡ **Express.js** - Fast, unopinionated web framework
+- 🔒 **Security** - Helmet, CORS, rate limiting
+- 🗄️ **Database** - ${answers.database === 'none' ? 'No database' : answers.database} integration
+- 🔐 **Authentication** - ${answers.authStrategy === 'none' ? 'No authentication' : answers.authStrategy} strategy
+- 📝 **Logging** - Winston logger with structured logging
+- ✅ **Validation** - Request validation and sanitization
+- 🧪 **Testing** - Jest and Supertest setup
+- 📚 **Documentation** - API documentation with Swagger
+- 🐳 **Docker** - Production-ready containerization
+
+## 🛠️ Tech Stack
+
+${generateTechStack(answers)}
+
+## 📁 Project Structure
+
+\`\`\`
+${answers.projectName}/
+├── src/
+│   ├── controllers/        # Route controllers
+│   ├── services/          # Business logic
+│   ├── models/            # Database models
+│   ├── routes/            # API routes
+│   ├── middleware/        # Custom middleware
+│   ├── config/            # Configuration files
+│   ├── utils/             # Utility functions
+│   ├── app.js             # Express app setup
+│   └── server.js          # Server entry point
+├── tests/                 # Test files
+├── logs/                  # Log files
+├── .env.example          # Environment variables example
+├── .gitignore            # Git ignore rules
+├── package.json          # Dependencies and scripts
+└── README.md             # This file
+\`\`\`
+
+## 🚀 Getting Started
+
+### Prerequisites
+
+- Node.js (v18 or higher)
+- npm, yarn, or pnpm
+${answers.database !== 'none' ? `- ${answers.database} database` : ''}
+
+### Installation
+
+1. **Clone the repository**
+   \`\`\`bash
+   git clone <your-repo-url>
+   cd ${answers.projectName}
+   \`\`\`
+
+2. **Install dependencies**
+   \`\`\`bash
+   npm install
+   \`\`\`
+
+3. **Set up environment variables**
+   \`\`\`bash
+   cp .env.example .env
+   # Edit .env with your configuration
+   \`\`\`
+
+4. **Set up the database**
+   ${generateDatabaseSetup(answers)}
+
+5. **Start the development server**
+   \`\`\`bash
+   npm run dev
+   \`\`\`
+
+The server will start on \`http://localhost:3000\`
+
+## 📚 API Documentation
+
+Once the server is running, you can access:
+
+- **API Base URL**: \`http://localhost:3000/api\`
+- **Health Check**: \`http://localhost:3000/health\`
+${answers.features.includes('swagger') ? '- **API Documentation**: `http://localhost:3000/api-docs`' : ''}
+
+## 🧪 Testing
+
+\`\`\`bash
+# Run all tests
+npm test
+
+# Run tests in watch mode
+npm run test:watch
+
+# Run tests with coverage
+npm run test:coverage
+\`\`\`
+
+## 🐳 Docker
+
+\`\`\`bash
+# Build Docker image
+docker build -t ${answers.projectName} .
+
+# Run with Docker Compose
+docker-compose up -d
+\`\`\`
+
+## 📝 Available Scripts
+
+- \`npm start\` - Start production server
+- \`npm run dev\` - Start development server with nodemon
+- \`npm test\` - Run tests
+- \`npm run test:watch\` - Run tests in watch mode
+- \`npm run test:coverage\` - Run tests with coverage report
+${answers.database === 'postgresql' || answers.database === 'sqlite' ? `
+- \`npm run db:generate\` - Generate Prisma client
+- \`npm run db:push\` - Push schema to database
+- \`npm run db:migrate\` - Run database migrations
+- \`npm run db:studio\` - Open Prisma Studio
+` : ''}
+
+## 🔧 Configuration
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| \`PORT\` | Server port | \`3000\` |
+| \`NODE_ENV\` | Environment | \`development\` |
+${generateEnvVars(answers)}
+
+## 🚀 Deployment
+
+### Production Checklist
+
+- [ ] Set \`NODE_ENV=production\`
+- [ ] Configure proper database connection
+- [ ] Set up logging and monitoring
+- [ ] Configure reverse proxy (nginx)
+- [ ] Set up SSL certificates
+- [ ] Configure environment variables
+- [ ] Set up process manager (PM2)
+- [ ] Configure backup strategy
+
+### PM2 Configuration
+
+\`\`\`bash
+# Install PM2 globally
+npm install -g pm2
+
+# Start application with PM2
+pm2 start src/server.js --name "${answers.projectName}"
+
+# Save PM2 configuration
+pm2 save
+pm2 startup
+\`\`\`
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create your feature branch (\`git checkout -b feature/amazing-feature\`)
+3. Commit your changes (\`git commit -m 'Add some amazing feature'\`)
+4. Push to the branch (\`git push origin feature/amazing-feature\`)
+5. Open a Pull Request
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- **Express.js Team** - For the amazing web framework
+- **Node.js Community** - For the incredible ecosystem
+- **MongoDB/PostgreSQL/MySQL Teams** - For the robust databases
+- **Jest Team** - For the testing framework
+- **Winston Team** - For the logging library
+
+---
+
+${credits}
+`;
+
+    return readme;
+}
+
+function generateTechStack(answers) {
+    const stack = ['- **Node.js** - JavaScript runtime'];
+
+    if (answers.database !== 'none') {
+        stack.push(`- **Database** - ${answers.database}`);
+    }
+
+    if (answers.authStrategy !== 'none') {
+        stack.push(`- **Authentication** - ${answers.authStrategy}`);
+    }
+
+    if (answers.features.includes('cors')) {
+        stack.push('- **CORS** - Cross-origin resource sharing');
+    }
+
+    if (answers.features.includes('helmet')) {
+        stack.push('- **Helmet** - Security headers');
+    }
+
+    if (answers.features.includes('morgan')) {
+        stack.push('- **Morgan** - HTTP request logger');
+    }
+
+    if (answers.features.includes('winston')) {
+        stack.push('- **Winston** - Logging library');
+    }
+
+    if (answers.features.includes('swagger')) {
+        stack.push('- **Swagger** - API documentation');
+    }
+
+    if (answers.includeTests) {
+        stack.push('- **Jest** - Testing framework');
+        stack.push('- **Supertest** - HTTP assertion library');
+    }
+
+    return stack.join('\n');
+}
+
+function generateDatabaseSetup(answers) {
+    if (answers.database === 'mongodb') {
+        return `   \`\`\`bash
+   # Start MongoDB (if using local instance)
+   mongod
+   \`\`\``;
+    } else if (answers.database === 'postgresql') {
+        return `   \`\`\`bash
+   # Generate Prisma client
+   npm run db:generate
+   
+   # Push schema to database
+   npm run db:push
+   \`\`\``;
+    } else if (answers.database === 'mysql') {
+        return `   \`\`\`bash
+   # Create MySQL database
+   mysql -u root -p -e "CREATE DATABASE ${answers.projectName};"
+   \`\`\``;
+    } else if (answers.database === 'sqlite') {
+        return `   \`\`\`bash
+   # Generate Prisma client
+   npm run db:generate
+   
+   # Push schema to database
+   npm run db:push
+   \`\`\``;
+    }
+    return '';
+}
+
+function generateEnvVars(answers) {
+    const vars = [];
+
+    if (answers.database === 'mongodb') {
+        vars.push(`| \`MONGODB_URI\` | MongoDB connection string | \`mongodb://localhost:27017/${answers.projectName}\` |`);
+    } else if (answers.database === 'postgresql' || answers.database === 'sqlite') {
+        vars.push('| `DATABASE_URL` | Database connection string | `postgresql://...` |');
+    } else if (answers.database === 'mysql') {
+        vars.push('| `DB_HOST` | MySQL host | `localhost` |');
+        vars.push('| `DB_PORT` | MySQL port | `3306` |');
+        vars.push(`| \`DB_NAME\` | MySQL database name | \`${answers.projectName}\` |`);
+        vars.push('| `DB_USER` | MySQL username | `root` |');
+        vars.push('| `DB_PASSWORD` | MySQL password | `password` |');
+    }
+
+    if (answers.authStrategy !== 'none') {
+        vars.push('| `JWT_SECRET` | JWT secret key | `your-secret-key` |');
+        vars.push('| `JWT_EXPIRES_IN` | JWT expiration time | `7d` |');
+    }
+
+    if (answers.features.includes('cors')) {
+        vars.push('| `CORS_ORIGIN` | CORS allowed origin | `http://localhost:3000` |');
+    }
+
+    return vars.join('\n');
+}

package/src/generators/express/templates/routes.js

@@ -0,0 +1,36 @@
+/**
+ * Generate routes template
+ */
+
+export function generateRoutes(projectPath, answers) {
+    const routesContent = `import express from 'express';
+import { logger } from '../utils/logger.js';
+
+const router = express.Router();
+
+// Health check route
+router.get('/health', (req, res) => {
+  res.json({
+    status: 'OK',
+    timestamp: new Date().toISOString(),
+    service: '${answers.projectName}'
+  });
+});
+
+// API routes
+router.get('/', (req, res) => {
+  res.json({
+    message: 'Welcome to ${answers.projectName} API',
+    version: '1.0.0',
+    endpoints: {
+      health: '/health',
+      api: '/api'
+    }
+  });
+});
+
+export default router;
+`;
+
+    return routesContent;
+}

package/src/generators/express/templates/server.js

@@ -0,0 +1,59 @@
+/**
+ * Generate server.js file
+ */
+
+import { DATABASES } from '../../../types/index.js';
+
+export function generateServerJs(projectPath, answers) {
+  let content = `import app from './app.js';
+import { logger } from './utils/logger.js';
+import { connectDatabase } from './config/database.js';
+
+const PORT = process.env.PORT || 3000;
+const NODE_ENV = process.env.NODE_ENV || 'development';
+
+async function startServer() {
+  try {
+    // Connect to database
+    await connectDatabase();
+    
+    // Start server
+    app.listen(PORT, () => {
+      logger.info(\`🚀 Server running on port \${PORT} in \${NODE_ENV} mode\`);
+      logger.info(\`📊 Health check: http://localhost:\${PORT}/health\`);
+      logger.info(\`🔗 API endpoint: http://localhost:\${PORT}/api\`);
+    });
+  } catch (error) {
+    logger.error('Failed to start server:', error);
+    process.exit(1);
+  }
+}
+
+// Handle uncaught exceptions
+process.on('uncaughtException', (error) => {
+  logger.error('Uncaught Exception:', error);
+  process.exit(1);
+});
+
+// Handle unhandled promise rejections
+process.on('unhandledRejection', (reason, promise) => {
+  logger.error('Unhandled Rejection at:', promise, 'reason:', reason);
+  process.exit(1);
+});
+
+// Graceful shutdown
+process.on('SIGTERM', () => {
+  logger.info('SIGTERM received, shutting down gracefully');
+  process.exit(0);
+});
+
+process.on('SIGINT', () => {
+  logger.info('SIGINT received, shutting down gracefully');
+  process.exit(0);
+});
+
+startServer();
+`;
+
+  return content;
+}

package/src/generators/express/templates/services.js

@@ -0,0 +1,55 @@
+/**
+ * Generate services template
+ */
+
+export function generateServices(projectPath, answers) {
+    const servicesContent = `import { logger } from '../utils/logger.js';
+
+export class BaseService {
+  static async handleServiceCall(serviceName, operation, data = null) {
+    try {
+      logger.info(\`Service: \${serviceName} - Operation: \${operation}\`);
+      
+      // Add your business logic here
+      const result = await this.performOperation(operation, data);
+      
+      return {
+        success: true,
+        data: result
+      };
+    } catch (error) {
+      logger.error(\`Service error in \${serviceName}:\`, error);
+      throw error;
+    }
+  }
+
+  static async performOperation(operation, data) {
+    // Implement your business logic here
+    return { operation, data };
+  }
+}
+
+export class HealthService extends BaseService {
+  static async getHealthStatus() {
+    return this.handleServiceCall('HealthService', 'getStatus', {
+      timestamp: new Date().toISOString(),
+      uptime: process.uptime(),
+      memory: process.memoryUsage(),
+      service: '${answers.projectName}'
+    });
+  }
+}
+
+export class ApiService extends BaseService {
+  static async getApiInfo() {
+    return this.handleServiceCall('ApiService', 'getInfo', {
+      message: 'Welcome to ${answers.projectName} API',
+      version: '1.0.0',
+      features: ['REST API', 'Health Check', 'Error Handling']
+    });
+  }
+}
+`;
+
+    return servicesContent;
+}

package/src/generators/express/templates/tests.js

@@ -0,0 +1,46 @@
+/**
+ * Generate tests template
+ */
+
+export function generateTests(projectPath, answers) {
+    const testsContent = `import request from 'supertest';
+import app from '../app.js';
+
+describe('${answers.projectName} API', () => {
+  describe('GET /health', () => {
+    it('should return health status', async () => {
+      const response = await request(app)
+        .get('/health')
+        .expect(200);
+
+      expect(response.body).toHaveProperty('status', 'OK');
+      expect(response.body).toHaveProperty('timestamp');
+    });
+  });
+
+  describe('GET /api', () => {
+    it('should return API information', async () => {
+      const response = await request(app)
+        .get('/api')
+        .expect(200);
+
+      expect(response.body).toHaveProperty('message');
+      expect(response.body).toHaveProperty('version');
+    });
+  });
+
+  describe('404 handling', () => {
+    it('should return 404 for unknown routes', async () => {
+      const response = await request(app)
+        .get('/unknown-route')
+        .expect(404);
+
+      expect(response.body).toHaveProperty('success', false);
+      expect(response.body).toHaveProperty('error');
+    });
+  });
+});
+`;
+
+    return testsContent;
+}