offbyt 1.0.0

package/templates/model.template.js

@@ -0,0 +1,86 @@
+import mongoose from 'mongoose';
+
+const __MODEL_NAME__Schema = new mongoose.Schema(
+  {
+/* __FIELDS__ */
+    isActive: {
+      type: Boolean,
+      default: true,
+      index: true
+    },
+    isDeleted: {
+      type: Boolean,
+      default: false,
+      index: true
+    },
+    createdBy: {
+      type: mongoose.Schema.Types.ObjectId,
+      ref: 'User'
+    },
+    metadata: {
+      updatedBy: mongoose.Schema.Types.ObjectId,
+      version: { type: Number, default: 1 },
+      tags: [String]
+    }
+  },
+  { 
+    timestamps: true,
+    collection: '__COLLECTION_NAME__'
+  }
+);
+
+// ============================================================
+// INDEXES FOR PERFORMANCE
+// ============================================================
+__MODEL_NAME__Schema.index({ createdAt: -1 });
+__MODEL_NAME__Schema.index({ updatedAt: -1 });
+__MODEL_NAME__Schema.index({ isActive: 1 });
+__MODEL_NAME__Schema.index({ isDeleted: 1, createdAt: -1 });
+
+// ============================================================
+// HOOKS
+// ============================================================
+__MODEL_NAME__Schema.pre('save', function(next) {
+  if (this.isModified()) {
+    this.metadata.version = (this.metadata.version || 0) + 1;
+  }
+  next();
+});
+
+// ============================================================
+// QUERY HELPERS
+// ============================================================
+__MODEL_NAME__Schema.query.active = function() {
+  return this.find({ isActive: true, isDeleted: false });
+};
+
+// ============================================================
+// STATIC METHODS
+// ============================================================
+__MODEL_NAME__Schema.statics.findAllActive = async function(options = {}) {
+  return this.find({ isActive: true, isDeleted: false })
+    .sort(options.sort || { createdAt: -1 })
+    .limit(options.limit || 100)
+    .skip(options.skip || 0);
+};
+
+__MODEL_NAME__Schema.statics.softDelete = async function(id) {
+  return this.findByIdAndUpdate(
+    id,
+    { isDeleted: true },
+    { new: true }
+  );
+};
+
+// ============================================================
+// INSTANCE METHODS
+// ============================================================
+__MODEL_NAME__Schema.methods.toJSON = function() {
+  const obj = this.toObject();
+  delete obj.__v;
+  return obj;
+};
+
+const __MODEL_NAME__ = mongoose.model('__MODEL_NAME__', __MODEL_NAME__Schema);
+
+export default __MODEL_NAME__;

package/templates/package.production.json

@@ -0,0 +1,51 @@
+{
+  "name": "backend",
+  "version": "1.0.0",
+  "description": "Production-Ready Backend API - Generated by offbyt",
+  "type": "module",
+  "main": "server.js",
+  "scripts": {
+    "start": "node server.js",
+    "dev": "NODE_ENV=development node --watch server.js",
+    "test": "NODE_ENV=test echo \"Test suite coming soon\"",
+    "build": "echo \"Build complete\"",
+    "lint": "echo \"Linting enabled in production setup\""
+  },
+  "keywords": [
+    "backend",
+    "express",
+    "mongoose",
+    "rest-api",
+    "mongodb",
+    "production",
+    "api",
+    "full-stack"
+  ],
+  "author": "offbyt Generator",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.6.5",
+    "bcryptjs": "^2.4.3",
+    "chalk": "^5.3.0",
+    "compression": "^1.7.4",
+    "cors": "^2.8.5",
+    "dotenv": "^16.3.1",
+    "express": "^4.18.2",
+    "express-async-errors": "^3.1.1",
+    "express-rate-limit": "^7.1.5",
+    "express-validator": "^7.0.0",
+    "helmet": "^7.1.0",
+    "jsonwebtoken": "^9.0.2",
+    "express-mongo-sanitize": "^2.2.0",
+    "mongoose": "^8.0.3",
+    "ora": "^8.0.1",
+    "validator": "^13.11.0"
+  },
+  "devDependencies": {
+    "nodemon": "^3.0.2"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=9.0.0"
+  }
+}

package/templates/package.template.json

@@ -0,0 +1,41 @@
+{
+  "name": "backend",
+  "version": "1.0.0",
+  "description": "Backend Server - Generated by offbyt",
+  "type": "module",
+  "main": "server.js",
+  "scripts": {
+    "start": "node server.js",
+    "dev": "NODE_ENV=development node --watch server.js",
+    "dev:ai": "offbyt doctor-ai",
+    "test": "echo \"Error: no test specified\" && exit 0"
+  },
+  "keywords": [
+    "backend",
+    "express",
+    "mongoose",
+    "rest-api",
+    "mongodb"
+  ],
+  "author": "offbyt Generator",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.6.0",
+    "bcryptjs": "^2.4.3",
+    "cors": "^2.8.5",
+    "dotenv": "^16.3.1",
+    "express": "^4.18.2",
+    "express-async-errors": "^3.1.1",
+    "jsonwebtoken": "^9.0.2",
+    "express-mongo-sanitize": "^2.2.0",
+    "mongoose": "^8.0.3",
+    "validator": "^13.11.0"
+  },
+  "devDependencies": {
+    "nodemon": "^3.0.1"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=9.0.0"
+  }
+}

package/templates/pagination.utility.js

@@ -0,0 +1,110 @@
+/**
+ * Pagination Utility
+ * Provides pagination, filtering, sorting for queries
+ */
+
+export class PaginationHelper {
+  static getPaginationParams(req) {
+    const page = Math.max(1, parseInt(req.query.page) || 1);
+    const limit = Math.min(100, parseInt(req.query.limit) || 10);
+    const skip = (page - 1) * limit;
+
+    return { page, limit, skip };
+  }
+
+  static async paginate(model, query = {}, options = {}) {
+    const {
+      page = 1,
+      limit = 10,
+      skip = 0,
+      sort = { createdAt: -1 },
+      select = null,
+      populate = []
+    } = options;
+
+    const total = await model.countDocuments(query);
+    const data = await model
+      .find(query)
+      .sort(sort)
+      .skip(skip)
+      .limit(limit)
+      .select(select);
+
+    if (populate.length > 0) {
+      for (const field of populate) {
+        await model.populate(data, field);
+      }
+    }
+
+    return {
+      data,
+      pagination: {
+        page,
+        limit,
+        total,
+        pages: Math.ceil(total / limit),
+        hasMore: page * limit < total,
+        skip
+      }
+    };
+  }
+
+  static getSortObject(sortParam) {
+    if (!sortParam) return { createdAt: -1 };
+
+    const sorts = {};
+    const fields = sortParam.split(',');
+
+    for (const field of fields) {
+      if (field.startsWith('-')) {
+        sorts[field.substring(1)] = -1;
+      } else {
+        sorts[field] = 1;
+      }
+    }
+
+    return sorts;
+  }
+
+  static buildFilterQuery(req, allowedFields = []) {
+    const query = {};
+
+    for (const field of allowedFields) {
+      if (req.query[field]) {
+        const value = req.query[field];
+        
+        // Handle range queries
+        if (value.includes('..')) {
+          const [min, max] = value.split('..');
+          query[field] = { $gte: isNaN(min) ? min : parseFloat(min), $lte: isNaN(max) ? max : parseFloat(max) };
+        }
+        // Handle multiple values
+        else if (value.includes(',')) {
+          query[field] = { $in: value.split(',') };
+        }
+        // Handle regex search
+        else if (value.includes('*')) {
+          query[field] = { $regex: value.replace(/\*/g, '.*'), $options: 'i' };
+        }
+        // Direct match
+        else {
+          query[field] = value;
+        }
+      }
+    }
+
+    return query;
+  }
+
+  static buildSearchQuery(searchTerm, searchFields = []) {
+    if (!searchTerm || searchFields.length === 0) return {};
+
+    return {
+      $or: searchFields.map(field => ({
+        [field]: { $regex: searchTerm, $options: 'i' }
+      }))
+    };
+  }
+}
+
+export default PaginationHelper;

package/templates/production.server.template.js

@@ -0,0 +1,233 @@
+/**
+ * Production Server Template
+ * Fully configured Express server with all middleware
+ * Generated by offbyt - Enterprise Ready
+ */
+
+import express from 'express';
+import 'dotenv/config';
+import dns from 'dns';
+import cors from 'cors';
+import compression from 'compression';
+import helmet from 'helmet';
+import rateLimit from 'express-rate-limit';
+import chalk from 'chalk';
+
+// Import database
+import { connectDatabase, disconnectDatabase, isDatabaseConnected } from './config/database.js';
+
+// Import middleware
+import requestLogger from './middleware/requestLogger.js';
+import errorHandler from './middleware/errorHandler.js';
+import { securityHeaders, sanitizeData } from './middleware/security.js';
+import { globalLimiter, authLimiter } from './middleware/rateLimiter.js';
+import { cacheMiddleware } from './middleware/cache.js';
+
+// Import utilities
+import { ResponseHelper, Logger } from './utils/helper.js';
+
+
+const app = express();
+const PORT = process.env.PORT || 5000;
+const NODE_ENV = process.env.NODE_ENV || 'development';
+const API_VERSION = 'v1';
+
+// ============================================
+// MIDDLEWARE SETUP
+// ============================================
+
+// Security Headers
+app.use(securityHeaders);
+
+// Body Parsing
+app.use(express.json({ limit: '50mb' }));
+app.use(express.urlencoded({ limit: '50mb', extended: true }));
+
+// Compression
+app.use(compression({
+  level: NODE_ENV === 'production' ? 6 : 3,
+  threshold: 1024
+}));
+
+// CORS Configuration
+app.use(cors({
+  origin: process.env.CORS_ORIGIN?.split(',') || '*',
+  credentials: true,
+  methods: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS'],
+  allowedHeaders: ['Content-Type', 'Authorization'],
+  maxAge: 86400 // 24 hours
+}));
+
+// Rate Limiting
+app.use(`/api/auth`, authLimiter);
+app.use(`/api`, globalLimiter);
+
+// Data Sanitization
+app.use(sanitizeData);
+
+// Request Logging
+app.use(requestLogger);
+
+// Cache Middleware (for GET requests)
+app.use(cacheMiddleware(300)); // 5 minutes cache
+
+// ============================================
+// ROUTES SETUP
+// ============================================
+
+// Health Check & API Info
+app.get('/health', (req, res) => {
+  res.status(200).json({
+    status: 'OK',
+    uptime: process.uptime(),
+    timestamp: new Date().toISOString(),
+    environment: NODE_ENV,
+    database: isDatabaseConnected() ? 'Connected' : 'Disconnected',
+    version: API_VERSION
+  });
+});
+
+app.get(`/api/health`, (req, res) => {
+  res.status(200).json({
+    status: 'OK',
+    uptime: process.uptime(),
+    timestamp: new Date().toISOString(),
+    environment: NODE_ENV,
+    database: isDatabaseConnected() ? 'Connected' : 'Disconnected',
+    version: API_VERSION
+  });
+});
+
+app.get(`/api`, (req, res) => {
+  res.status(200).json({
+    success: true,
+    message: 'Backend API Server',
+    version: API_VERSION,
+    environment: NODE_ENV,
+    endpoints: {
+      health: '/health',
+      documentation: `/api/docs`,
+      status: `/api/status`
+    }
+  });
+});
+
+app.get(`/api/status`, (req, res) => {
+  res.status(200).json({
+    success: true,
+    status: 'running',
+    database: isDatabaseConnected() ? 'connected' : 'disconnected',
+    memory: process.memoryUsage(),
+    uptime: process.uptime()
+  });
+});
+
+// Import all routes
+// Routes will be auto-registered here
+// __ROUTES__
+
+// ============================================
+// IMPORTANT: API URL Configuration
+// ============================================
+// Routes are registered with /api prefix (e.g., app.use(`/api/users`, usersRoutes))
+// Frontend VITE_API_URL should be: http://localhost:5000 (WITHOUT /api)
+// Frontend will then call: http://localhost:5000/api/users
+// 
+// ❌ WRONG: VITE_API_URL = http://localhost:5000/api
+// This would result in: http://localhost:5000/api/api/users (404!)
+// 
+// ✅ CORRECT: VITE_API_URL = http://localhost:5000
+// This results in: http://localhost:5000/api/users (✓ works!)
+// ============================================
+
+// ============================================
+// 404 ERROR HANDLER
+// ============================================
+app.use((req, res) => {
+  res.status(404).json({
+    success: false,
+    message: 'Endpoint not found',
+    path: req.path,
+    method: req.method,
+    status: 404
+  });
+});
+
+// ============================================
+// GLOBAL ERROR HANDLER
+// ============================================
+app.use(errorHandler);
+
+// ============================================
+// SERVER STARTUP
+// ============================================
+
+async function startServer() {
+  try {
+    // Connect to database
+    await connectDatabase();
+
+    // Start server
+    const server = app.listen(PORT, () => {
+      Logger.info('Server started successfully', {
+        port: PORT,
+        environment: NODE_ENV,
+        pid: process.pid
+      });
+
+      console.log(chalk.cyan('\n🚀 Backend Server Running\n'));
+      console.log(chalk.white('   URL:       '), chalk.bold(`http://localhost:${PORT}`));
+      console.log(chalk.white('   API:       '), chalk.bold(`http://localhost:${PORT}/api`));
+      console.log(chalk.white('   Health:    '), chalk.bold(`http://localhost:${PORT}/health`));
+      console.log(chalk.white('   Status:    '), chalk.bold(`http://localhost:${PORT}/api/status`));
+      console.log(chalk.white('   Env:       '), chalk.bold(NODE_ENV));
+      console.log(chalk.gray('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
+    });
+
+    // Graceful shutdown
+    process.on('SIGINT', async () => {
+      console.log(chalk.yellow('\nâ›” Shutting down gracefully...\n'));
+      
+      server.close(async () => {
+        await disconnectDatabase();
+        Logger.info('Server shut down successfully');
+        process.exit(0);
+      });
+
+      // Force shutdown after 10 seconds
+      setTimeout(() => {
+        console.error(chalk.red('Force shutting down...'));
+        process.exit(1);
+      }, 10000);
+    });
+
+    // Handle uncaught exceptions
+    process.on('uncaughtException', (error) => {
+      Logger.error('Uncaught Exception', error);
+      console.error(chalk.red('❌ Uncaught Exception:'), error.message);
+      process.exit(1);
+    });
+
+    // Handle unhandled promise rejections
+    process.on('unhandledRejection', (reason, promise) => {
+      Logger.error('Unhandled Rejection', reason);
+      console.error(chalk.red('❌ Unhandled Rejection:'), reason);
+    });
+
+  } catch (error) {
+    Logger.error('Server startup failed', error);
+    console.error(chalk.red('❌ Server startup failed:'), error.message);
+    process.exit(1);
+  }
+}
+
+// ============================================
+// START APPLICATION
+// ============================================
+
+if (process.env.NODE_ENV !== 'test') {
+  startServer();
+}
+
+export default app;
+

package/templates/rateLimiter.middleware.js

@@ -0,0 +1,36 @@
+/**
+ * Rate Limiter Middleware
+ * Prevents abuse by limiting requests from IP addresses
+ */
+
+import rateLimit from 'express-rate-limit';
+
+// Global rate limiter
+export const globalLimiter = rateLimit({
+  windowMs: 15 * 60 * 1000, // 15 minutes
+  max: 100, // limit each IP to 100 requests per windowMs
+  message: 'Too many requests from this IP, please try again later.',
+  standardHeaders: true, // Return rate limit info in the `RateLimit-*` headers
+  legacyHeaders: false, // Disable the `X-RateLimit-*` headers
+  skip: (req) => process.env.NODE_ENV === 'development', // Skip in development
+  keyGenerator: (req) => req.ip || req.socket.remoteAddress // Use IP address as key
+});
+
+// Strict rate limiter for auth endpoints
+export const authLimiter = rateLimit({
+  windowMs: 15 * 60 * 1000, // 15 minutes
+  max: 5, // limit each IP to 5 requests per windowMs
+  message: 'Too many login attempts, please try again later.',
+  standardHeaders: true,
+  legacyHeaders: false,
+  skipSuccessfulRequests: true // Don't count successful requests
+});
+
+// API endpoint limiter
+export const apiLimiter = rateLimit({
+  windowMs: 60 * 1000, // 1 minute
+  max: 30, // limit each IP to 30 requests per minute
+  message: 'Too many API requests, please try again later.'
+});
+
+export default globalLimiter;

package/templates/requestLogger.middleware.js

@@ -0,0 +1,19 @@
+// Request Logger Middleware
+const requestLogger = (req, res, next) => {
+  const start = Date.now();
+
+  // Log request
+  console.log(`📨 ${req.method} ${req.path}`);
+
+  // Override res.json to log response
+  const originalJson = res.json.bind(res);
+  res.json = function(data) {
+    const duration = Date.now() - start;
+    console.log(`✅ ${res.statusCode} ${req.method} ${req.path} [${duration}ms]`);
+    return originalJson(data);
+  };
+
+  next();
+};
+
+export default requestLogger;