build-app-with 2.0.0

package/src/generators/express/simple-generator.js

@@ -0,0 +1,275 @@
+/**
+ * Simplified Express.js project generator
+ */
+
+import fs from 'fs-extra';
+import path from 'path';
+import { logger } from '../../core/logger.js';
+import { generateCreditsSection } from '../../utils/credits.js';
+
+export async function generateSimpleExpressProject(projectPath, answers) {
+  try {
+    // Create project directory first
+    logger.debug('Creating project directory...');
+    await fs.ensureDir(projectPath);
+    logger.debug('Project directory created');
+
+    logger.debug('Generating package.json...');
+    const packageJson = {
+      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: 'jest'
+      },
+      keywords: ['express', 'nodejs', 'api', 'backend'],
+      author: 'Generated by build-app-with',
+      license: 'MIT',
+      engines: {
+        node: '>=18.0.0'
+      },
+      dependencies: {
+        'express': '^4.18.2',
+        'cors': '^2.8.5',
+        'helmet': '^7.1.0',
+        'morgan': '^1.10.0',
+        'dotenv': '^16.3.1',
+        'mongoose': '^8.0.3',
+        'jsonwebtoken': '^9.0.2',
+        'bcryptjs': '^2.4.3'
+      },
+      devDependencies: {
+        'nodemon': '^3.0.2',
+        'jest': '^29.7.0',
+        'supertest': '^6.3.3'
+      }
+    };
+
+    await fs.writeJSON(path.join(projectPath, 'package.json'), packageJson, { spaces: 2 });
+
+    logger.info('Creating src directory...');
+    await fs.ensureDir(path.join(projectPath, 'src'));
+
+    logger.info('Generating app.js...');
+    const appJs = `import express from 'express';
+import cors from 'cors';
+import helmet from 'helmet';
+import morgan from 'morgan';
+import dotenv from 'dotenv';
+
+// Load environment variables
+dotenv.config();
+
+const app = express();
+
+// Security middleware
+app.use(helmet());
+
+// CORS configuration
+app.use(cors({
+  origin: process.env.CORS_ORIGIN || 'http://localhost:3000',
+  credentials: true
+}));
+
+// Logging middleware
+app.use(morgan('combined'));
+
+// Body parsing middleware
+app.use(express.json({ limit: '10mb' }));
+app.use(express.urlencoded({ extended: true }));
+
+// Health check endpoint
+app.get('/health', (req, res) => {
+  res.status(200).json({
+    status: 'OK',
+    timestamp: new Date().toISOString(),
+    uptime: process.uptime(),
+    environment: process.env.NODE_ENV || 'development'
+  });
+});
+
+// API routes
+app.get('/api', (req, res) => {
+  res.json({
+    message: 'Welcome to ${answers.projectName} API',
+    version: '1.0.0',
+    endpoints: {
+      health: '/health',
+      api: '/api'
+    }
+  });
+});
+
+// Error handling middleware
+app.use((err, req, res, next) => {
+  console.error(err.stack);
+  res.status(500).json({
+    success: false,
+    error: 'Something went wrong!',
+    ...(process.env.NODE_ENV === 'development' && { stack: err.stack })
+  });
+});
+
+// 404 handler
+app.use('*', (req, res) => {
+  res.status(404).json({
+    success: false,
+    error: \`Route \${req.originalUrl} not found\`
+  });
+});
+
+export default app;
+`;
+
+    await fs.writeFile(path.join(projectPath, 'src', 'app.js'), appJs);
+
+    logger.info('Generating server.js...');
+    const serverJs = `import app from './app.js';
+
+const PORT = process.env.PORT || 3000;
+const NODE_ENV = process.env.NODE_ENV || 'development';
+
+app.listen(PORT, () => {
+  console.log(\`🚀 Server running on port \${PORT} in \${NODE_ENV} mode\`);
+  console.log(\`📊 Health check: http://localhost:\${PORT}/health\`);
+  console.log(\`🔗 API endpoint: http://localhost:\${PORT}/api\`);
+});
+`;
+
+    await fs.writeFile(path.join(projectPath, 'src', 'server.js'), serverJs);
+
+    logger.info('Generating .env.example...');
+    const envExample = `# Server Configuration
+PORT=3000
+NODE_ENV=development
+
+# Database Configuration
+MONGODB_URI=mongodb://localhost:27017/${answers.projectName}
+
+# Authentication
+JWT_SECRET=your-super-secret-jwt-key
+JWT_EXPIRES_IN=7d
+
+# CORS
+CORS_ORIGIN=http://localhost:3000
+`;
+
+    await fs.writeFile(path.join(projectPath, '.env.example'), envExample);
+
+    logger.info('Generating .gitignore...');
+    const gitignore = `# Dependencies
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Logs
+logs
+*.log
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Coverage directory
+coverage/
+
+# IDE
+.vscode/
+.idea/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Build output
+dist/
+build/
+`;
+
+    await fs.writeFile(path.join(projectPath, '.gitignore'), gitignore);
+
+    logger.info('Generating README...');
+
+    // Generate credits asynchronously
+    const allFeatures = ['express', 'mongodb', 'jwt', 'cors', 'helmet', 'morgan'];
+    const credits = await Promise.resolve(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, JWT authentication
+- 🗄️ **Database** - MongoDB with Mongoose
+- 📝 **Logging** - Morgan HTTP request logger
+- ✅ **Validation** - Request validation and sanitization
+- 🧪 **Testing** - Jest and Supertest setup
+
+## 🚀 Getting Started
+
+1. **Install dependencies**
+   \`\`\`bash
+   npm install
+   \`\`\`
+
+2. **Set up environment variables**
+   \`\`\`bash
+   cp .env.example .env
+   # Edit .env with your configuration
+   \`\`\`
+
+3. **Start the development server**
+   \`\`\`bash
+   npm run dev
+   \`\`\`
+
+The server will start on \`http://localhost:3000\`
+
+## 📚 API Endpoints
+
+- **Health Check**: \`GET /health\`
+- **API Info**: \`GET /api\`
+
+## 📝 Available Scripts
+
+- \`npm start\` - Start production server
+- \`npm run dev\` - Start development server with nodemon
+- \`npm test\` - Run tests
+
+## License
+
+MIT
+
+${credits}
+`;
+
+    await fs.writeFile(path.join(projectPath, 'README.md'), readme);
+
+    logger.success('Project structure generated successfully!');
+
+    logger.info('Project structure created! Next steps:');
+    logger.info(`  cd ${path.basename(projectPath)}`);
+    logger.info('  npm install');
+    logger.info('  npm run dev');
+
+  } catch (error) {
+    logger.error('Failed to generate project structure');
+    throw error;
+  }
+}

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

@@ -0,0 +1,73 @@
+/**
+ * Generate main Express app.js file
+ */
+
+import { FEATURES, DATABASES } from '../../../types/index.js';
+
+export function generateAppJs(projectPath, answers) {
+    const isTypeScript = answers.typescript !== false;
+    const ext = isTypeScript ? 'ts' : 'js';
+
+    let content = `import express from 'express';
+import cors from 'cors';
+import helmet from 'helmet';
+import morgan from 'morgan';
+import dotenv from 'dotenv';
+import { errorHandler } from './middleware/errorHandler.js';
+import { notFound } from './middleware/notFound.js';
+import { logger } from './utils/logger.js';
+
+// Load environment variables
+dotenv.config();
+
+const app = express();
+
+// Security middleware
+app.use(helmet());
+
+// CORS configuration
+app.use(cors({
+  origin: process.env.CORS_ORIGIN || 'http://localhost:3000',
+  credentials: true
+}));
+
+// Logging middleware
+app.use(morgan('combined', {
+  stream: { write: (message) => logger.info(message.trim()) }
+}));
+
+// Body parsing middleware
+app.use(express.json({ limit: '10mb' }));
+app.use(express.urlencoded({ extended: true }));
+
+// Health check endpoint
+app.get('/health', (req, res) => {
+  res.status(200).json({
+    status: 'OK',
+    timestamp: new Date().toISOString(),
+    uptime: process.uptime(),
+    environment: process.env.NODE_ENV || 'development'
+  });
+});
+
+// API routes
+app.use('/api', (req, res) => {
+  res.json({
+    message: 'Welcome to ${answers.projectName} API',
+    version: '1.0.0',
+    endpoints: {
+      health: '/health',
+      api: '/api'
+    }
+  });
+});
+
+// Error handling middleware
+app.use(notFound);
+app.use(errorHandler);
+
+export default app;
+`;
+
+    return content;
+}

package/src/generators/express/templates/config/database.js

@@ -0,0 +1,122 @@
+/**
+ * Database configuration template
+ */
+
+import { DATABASES } from '../../../types/index.js';
+
+export function generateDatabaseConfig(answers) {
+    if (answers.database === DATABASES.MONGODB) {
+        return `import mongoose from 'mongoose';
+import { logger } from '../utils/logger.js';
+
+export async function connectDatabase() {
+  try {
+    const mongoUri = process.env.MONGODB_URI || 'mongodb://localhost:27017/${answers.projectName}';
+    
+    await mongoose.connect(mongoUri, {
+      useNewUrlParser: true,
+      useUnifiedTopology: true,
+    });
+    
+    logger.info('MongoDB connected successfully');
+  } catch (error) {
+    logger.error('MongoDB connection error:', error);
+    process.exit(1);
+  }
+}
+
+// Handle connection events
+mongoose.connection.on('connected', () => {
+  logger.info('Mongoose connected to MongoDB');
+});
+
+mongoose.connection.on('error', (err) => {
+  logger.error('Mongoose connection error:', err);
+});
+
+mongoose.connection.on('disconnected', () => {
+  logger.warn('Mongoose disconnected');
+});
+
+// Graceful shutdown
+process.on('SIGINT', async () => {
+  await mongoose.connection.close();
+  logger.info('Mongoose connection closed through app termination');
+  process.exit(0);
+});
+`;
+    } else if (answers.database === DATABASES.POSTGRESQL || answers.database === DATABASES.SQLITE) {
+        return `import { PrismaClient } from '@prisma/client';
+import { logger } from '../utils/logger.js';
+
+const prisma = new PrismaClient({
+  log: process.env.NODE_ENV === 'development' ? ['query', 'info', 'warn', 'error'] : ['error'],
+});
+
+export async function connectDatabase() {
+  try {
+    await prisma.$connect();
+    logger.info('Database connected successfully');
+  } catch (error) {
+    logger.error('Database connection error:', error);
+    process.exit(1);
+  }
+}
+
+// Graceful shutdown
+process.on('SIGINT', async () => {
+  await prisma.$disconnect();
+  logger.info('Database connection closed');
+  process.exit(0);
+});
+
+export { prisma };
+`;
+    } else if (answers.database === DATABASES.MYSQL) {
+        return `import { Sequelize } from 'sequelize';
+import { logger } from '../utils/logger.js';
+
+const sequelize = new Sequelize(
+  process.env.DB_NAME || '${answers.projectName}',
+  process.env.DB_USER || 'root',
+  process.env.DB_PASSWORD || 'password',
+  {
+    host: process.env.DB_HOST || 'localhost',
+    port: process.env.DB_PORT || 3306,
+    dialect: 'mysql',
+    logging: process.env.NODE_ENV === 'development' ? console.log : false,
+  }
+);
+
+export async function connectDatabase() {
+  try {
+    await sequelize.authenticate();
+    logger.info('MySQL connected successfully');
+    
+    // Sync models in development
+    if (process.env.NODE_ENV === 'development') {
+      await sequelize.sync({ alter: true });
+    }
+  } catch (error) {
+    logger.error('MySQL connection error:', error);
+    process.exit(1);
+  }
+}
+
+// Graceful shutdown
+process.on('SIGINT', async () => {
+  await sequelize.close();
+  logger.info('MySQL connection closed');
+  process.exit(0);
+});
+
+export { sequelize };
+`;
+    } else {
+        return `// No database configuration needed
+export async function connectDatabase() {
+  console.log('No database configured');
+}
+`;
+    }
+}

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

@@ -0,0 +1,37 @@
+/**
+ * Generate config template
+ */
+
+export function generateConfig(projectPath, answers) {
+    const configContent = `import dotenv from 'dotenv';
+
+// Load environment variables
+dotenv.config();
+
+export const config = {
+  port: process.env.PORT || 3000,
+  nodeEnv: process.env.NODE_ENV || 'development',
+  corsOrigin: process.env.CORS_ORIGIN || 'http://localhost:3000',
+  database: {
+    url: process.env.DATABASE_URL || process.env.MONGODB_URI,
+    host: process.env.DB_HOST || 'localhost',
+    port: process.env.DB_PORT || 3306,
+    name: process.env.DB_NAME || '${answers.projectName}',
+    user: process.env.DB_USER || 'root',
+    password: process.env.DB_PASSWORD || 'password'
+  },
+  auth: {
+    jwtSecret: process.env.JWT_SECRET || 'your-secret-key',
+    jwtExpiresIn: process.env.JWT_EXPIRES_IN || '7d'
+  },
+  rateLimit: {
+    max: parseInt(process.env.RATE_LIMIT_MAX) || 100,
+    timeWindow: parseInt(process.env.RATE_LIMIT_TIME_WINDOW) || 60000
+  }
+};
+
+export default config;
+`;
+
+    return configContent;
+}

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

@@ -0,0 +1,49 @@
+/**
+ * Generate controllers template
+ */
+
+export function generateControllers(projectPath, answers) {
+    const controllersContent = `import { logger } from '../utils/logger.js';
+
+export class BaseController {
+  static async handleRequest(req, res, next, handler) {
+    try {
+      const result = await handler(req, res);
+      res.json({
+        success: true,
+        data: result
+      });
+    } catch (error) {
+      logger.error('Controller error:', error);
+      next(error);
+    }
+  }
+}
+
+export class HealthController extends BaseController {
+  static async check(req, res) {
+    return {
+      status: 'OK',
+      timestamp: new Date().toISOString(),
+      uptime: process.uptime(),
+      service: '${answers.projectName}'
+    };
+  }
+}
+
+export class ApiController extends BaseController {
+  static async getInfo(req, res) {
+    return {
+      message: 'Welcome to ${answers.projectName} API',
+      version: '1.0.0',
+      endpoints: {
+        health: '/health',
+        api: '/api'
+      }
+    };
+  }
+}
+`;
+
+    return controllersContent;
+}

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

@@ -0,0 +1,72 @@
+/**
+ * Generate Docker template
+ */
+
+export function generateDocker(projectPath, answers) {
+    const dockerfile = `# Use Node.js LTS version
+FROM node:18-alpine
+
+# Set working directory
+WORKDIR /app
+
+# Copy package files
+COPY package*.json ./
+
+# Install dependencies
+RUN npm ci --only=production
+
+# Copy source code
+COPY . .
+
+# Create non-root user
+RUN addgroup -g 1001 -S nodejs
+RUN adduser -S nextjs -u 1001
+
+# Change ownership
+RUN chown -R nextjs:nodejs /app
+USER nextjs
+
+# Expose port
+EXPOSE 3000
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \\
+  CMD curl -f http://localhost:3000/health || exit 1
+
+# Start the application
+CMD ["npm", "start"]
+`;
+
+    const dockerCompose = `version: '3.8'
+
+services:
+  app:
+    build: .
+    ports:
+      - "3000:3000"
+    environment:
+      - NODE_ENV=production
+      - PORT=3000
+    depends_on:
+      - db
+    restart: unless-stopped
+
+  db:
+    image: ${answers.database === 'mongodb' ? 'mongo:latest' : 'postgres:15-alpine'}
+    environment:
+      ${answers.database === 'mongodb'
+            ? 'MONGO_INITDB_DATABASE=myapp'
+            : 'POSTGRES_DB=myapp\n      POSTGRES_USER=postgres\n      POSTGRES_PASSWORD=password'
+        }
+    volumes:
+      - db_data:/data/db
+    ports:
+      - "${answers.database === 'mongodb' ? '27017:27017' : '5432:5432'}"
+    restart: unless-stopped
+
+volumes:
+  db_data:
+`;
+
+    return { dockerfile, dockerCompose };
+}

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

@@ -0,0 +1,49 @@
+/**
+ * Error handling middleware template
+ */
+
+export function generateErrorHandler() {
+    return `import { logger } from '../utils/logger.js';
+
+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 })
+  });
+};
+`;
+}
+
+export function generateNotFound() {
+    return `export const notFound = (req, res, next) => {
+  const error = new Error(\`Not found - \${req.originalUrl}\`);
+  res.status(404);
+  next(error);
+};
+`;
+}