offbyt 1.0.0

package/templates/advanced.model.template.js

@@ -0,0 +1,201 @@
+/**
+ * Advanced Model Template
+ * Production-ready Mongoose schema with hooks, validation, and methods
+ * Generated by offbyt
+ */
+
+import mongoose from 'mongoose';
+
+const __MODEL_NAME__Schema = new mongoose.Schema(
+  {
+    // Metadata fields
+    isActive: {
+      type: Boolean,
+      default: true,
+      index: true
+    },
+    isDeleted: {
+      type: Boolean,
+      default: false,
+      index: true
+    },
+    metadata: {
+      createdBy: mongoose.Schema.Types.ObjectId,
+      updatedBy: mongoose.Schema.Types.ObjectId,
+      version: { type: Number, default: 1 },
+      deletedAt: Date,
+      tags: [String]
+    }
+  },
+  {
+    timestamps: true,
+    collection: '__COLLECTION_NAME__'
+  }
+);
+
+// ============================================
+// INDEXES - For query optimization
+// ============================================
+__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 });
+
+// ============================================
+// PRE-HOOKS
+// ============================================
+
+// Before save
+__MODEL_NAME__Schema.pre('save', function(next) {
+  if (this.isModified()) {
+    this.metadata.version = (this.metadata.version || 0) + 1;
+  }
+  next();
+});
+
+// Before update
+__MODEL_NAME__Schema.pre('findByIdAndUpdate', function(next) {
+  this.set({ updatedAt: new Date() });
+  next();
+});
+
+// Before delete (soft delete)
+__MODEL_NAME__Schema.pre('findByIdAndRemove', function(next) {
+  this.set({
+    isDeleted: true,
+    'metadata.deletedAt': new Date()
+  });
+  next();
+});
+
+// ============================================
+// POST-HOOKS
+// ============================================
+
+// After save
+__MODEL_NAME__Schema.post('save', function(doc) {
+  // Can be used for logging, notifications, etc.
+  console.log(`New ${this.constructor.modelName} created`);
+});
+
+// ============================================
+// QUERY HELPERS
+// ============================================
+
+// Find only active documents by default
+__MODEL_NAME__Schema.query.active = function() {
+  return this.find({ isActive: true, isDeleted: false });
+};
+
+// Find only deleted documents
+__MODEL_NAME__Schema.query.deleted = function() {
+  return this.find({ isDeleted: true });
+};
+
+// ============================================
+// STATIC METHODS
+// ============================================
+
+// Find by ID (only active)
+__MODEL_NAME__Schema.statics.findActiveById = async function(id) {
+  return this.findOne({ _id: id, isActive: true, isDeleted: false });
+};
+
+// Find all active
+__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);
+};
+
+// Count active
+__MODEL_NAME__Schema.statics.countActive = async function() {
+  return this.countDocuments({ isActive: true, isDeleted: false });
+};
+
+// Soft delete
+__MODEL_NAME__Schema.statics.softDelete = async function(id) {
+  return this.findByIdAndUpdate(
+    id,
+    {
+      isDeleted: true,
+      'metadata.deletedAt': new Date()
+    },
+    { new: true }
+  );
+};
+
+// Restore
+__MODEL_NAME__Schema.statics.restore = async function(id) {
+  return this.findByIdAndUpdate(
+    id,
+    {
+      isDeleted: false,
+      'metadata.deletedAt': null
+    },
+    { new: true }
+  );
+};
+
+// ============================================
+// INSTANCE METHODS
+// ============================================
+
+// Convert to JSON
+__MODEL_NAME__Schema.methods.toJSON = function() {
+  const obj = this.toObject();
+  delete obj.__v;
+  return obj;
+};
+
+// Mark as active
+__MODEL_NAME__Schema.methods.activate = async function() {
+  this.isActive = true;
+  return this.save();
+};
+
+// Mark as inactive
+__MODEL_NAME__Schema.methods.deactivate = async function() {
+  this.isActive = false;
+  return this.save();
+};
+
+// Soft delete
+__MODEL_NAME__Schema.methods.delete = async function() {
+  this.isDeleted = true;
+  this.metadata.deletedAt = new Date();
+  return this.save();
+};
+
+// ============================================
+// VIRTUALS
+// ============================================
+
+// Format dates for response
+__MODEL_NAME__Schema.virtual('formattedCreatedAt').get(function() {
+  return this.createdAt ? this.createdAt.toISOString() : null;
+});
+
+__MODEL_NAME__Schema.virtual('formattedUpdatedAt').get(function() {
+  return this.updatedAt ? this.updatedAt.toISOString() : null;
+});
+
+// ============================================
+// VALIDATION
+// ============================================
+
+// Custom validation example
+__MODEL_NAME__Schema.pre('validate', function(next) {
+  // Add custom validation logic here
+  next();
+});
+
+// ============================================
+// MODEL EXPORT
+// ============================================
+
+const __MODEL_NAME__ = mongoose.model('__MODEL_NAME__', __MODEL_NAME__Schema);
+
+export default __MODEL_NAME__;
+

package/templates/advanced.route.template.js

@@ -0,0 +1,341 @@
+/**
+ * Advanced Route Template - Production Ready
+ * Includes authentication, authorization, pagination, filtering, sorting, search
+ * Auto-generated by offbyt
+ */
+
+import express from 'express';
+import { query, body, param } from 'express-validator';
+import { validateErrors } from '../middleware/validation.js';
+import { PaginationHelper } from '../utils/pagination.js';
+import { authenticateToken } from '../middleware/auth.js';
+import __MODEL_NAME__ from '../models/__MODEL_NAME__.js';
+
+const router = express.Router();
+
+// ============================================
+// ADVANCED GET - List with Pagination & Filters
+// ============================================
+router.get(
+  '/',
+  [
+    query('page').optional().isInt({ min: 1 }).toInt(),
+    query('limit').optional().isInt({ min: 1, max: 100 }).toInt(),
+    query('sort').optional().isString(),
+    query('search').optional().isString().trim(),
+    validateErrors
+  ],
+  async (req, res, next) => {
+    try {
+      const { page = 1, limit = 10, skip = 0 } = PaginationHelper.getPaginationParams(req);
+      const sort = PaginationHelper.getSortObject(req.query.sort);
+
+      // Build query with filters and search
+      let query = {};
+      
+      // Apply search
+      if (req.query.search) {
+        query = PaginationHelper.buildSearchQuery(req.query.search, [__SEARCH_FIELDS__]);
+      }
+
+      // Apply additional filters from query params
+      const filterFields = [__FILTER_FIELDS__];
+      const filters = PaginationHelper.buildFilterQuery(req, filterFields);
+      query = { ...query, ...filters };
+
+      // Execute paginated query
+      const result = await PaginationHelper.paginate(
+        __MODEL_NAME__,
+        query,
+        { page, limit, skip, sort }
+      );
+
+      res.status(200).json({
+        success: true,
+        message: '__MODEL_NAME__ retrieved successfully',
+        ...result
+      });
+    } catch (error) {
+      next(error);
+    }
+  }
+);
+
+// ============================================
+// GET SINGLE BY ID
+// ============================================
+router.get(
+  '/:id',
+  [param('id').isMongoId().withMessage('Invalid ID'), validateErrors],
+  async (req, res, next) => {
+    try {
+      const data = await __MODEL_NAME__.findById(req.params.id);
+
+      if (!data) {
+        return res.status(404).json({
+          success: false,
+          message: '__MODEL_NAME__ not found'
+        });
+      }
+
+      res.status(200).json({
+        success: true,
+        data
+      });
+    } catch (error) {
+      next(error);
+    }
+  }
+);
+
+// ============================================
+// CREATE NEW
+// ============================================
+router.post(
+  '/',
+  authenticateToken,
+  [__CREATE_VALIDATORS__validateErrors],
+  async (req, res, next) => {
+    try {
+      const newData = new __MODEL_NAME__(req.body);
+      const saved = await newData.save();
+
+      res.status(201).json({
+        success: true,
+        message: '__MODEL_NAME__ created successfully',
+        data: saved
+      });
+    } catch (error) {
+      if (error.name === 'ValidationError') {
+        return res.status(400).json({
+          success: false,
+          message: 'Validation Error',
+          errors: Object.values(error.errors).map(e => e.message)
+        });
+      }
+      next(error);
+    }
+  }
+);
+
+// ============================================
+// UPDATE ENTIRE DOCUMENT (PUT)
+// ============================================
+router.put(
+  '/:id',
+  authenticateToken,
+  [
+    param('id').isMongoId().withMessage('Invalid ID'),
+    __UPDATE_VALIDATORS__validateErrors
+  ],
+  async (req, res, next) => {
+    try {
+      const updated = await __MODEL_NAME__.findByIdAndUpdate(
+        req.params.id,
+        req.body,
+        { new: true, runValidators: true }
+      );
+
+      if (!updated) {
+        return res.status(404).json({
+          success: false,
+          message: '__MODEL_NAME__ not found'
+        });
+      }
+
+      res.status(200).json({
+        success: true,
+        message: '__MODEL_NAME__ updated successfully',
+        data: updated
+      });
+    } catch (error) {
+      if (error.name === 'ValidationError') {
+        return res.status(400).json({
+          success: false,
+          message: 'Validation Error',
+          errors: Object.values(error.errors).map(e => e.message)
+        });
+      }
+      next(error);
+    }
+  }
+);
+
+// ============================================
+// PARTIAL UPDATE (PATCH)
+// ============================================
+router.patch(
+  '/:id',
+  authenticateToken,
+  [
+    param('id').isMongoId().withMessage('Invalid ID'),
+    validateErrors
+  ],
+  async (req, res, next) => {
+    try {
+      // Remove fields that shouldn't be updated
+      const restrictedFields = ['_id', 'createdAt'];
+      restrictedFields.forEach(field => delete req.body[field]);
+
+      const updated = await __MODEL_NAME__.findByIdAndUpdate(
+        req.params.id,
+        { $set: req.body },
+        { new: true, runValidators: true }
+      );
+
+      if (!updated) {
+        return res.status(404).json({
+          success: false,
+          message: '__MODEL_NAME__ not found'
+        });
+      }
+
+      res.status(200).json({
+        success: true,
+        message: '__MODEL_NAME__ updated successfully',
+        data: updated
+      });
+    } catch (error) {
+      next(error);
+    }
+  }
+);
+
+// ============================================
+// DELETE
+// ============================================
+router.delete(
+  '/:id',
+  authenticateToken,
+  [param('id').isMongoId().withMessage('Invalid ID'), validateErrors],
+  async (req, res, next) => {
+    try {
+      const deleted = await __MODEL_NAME__.findByIdAndDelete(req.params.id);
+
+      if (!deleted) {
+        return res.status(404).json({
+          success: false,
+          message: '__MODEL_NAME__ not found'
+        });
+      }
+
+      res.status(200).json({
+        success: true,
+        message: '__MODEL_NAME__ deleted successfully',
+        data: deleted
+      });
+    } catch (error) {
+      next(error);
+    }
+  }
+);
+
+// ============================================
+// BULK OPERATIONS
+// ============================================
+
+// Bulk Create
+router.post(
+  '/bulk/create',
+  authenticateToken,
+  [
+    body('items').isArray({ min: 1 }).withMessage('Must provide array of items'),
+    validateErrors
+  ],
+  async (req, res, next) => {
+    try {
+      const items = await __MODEL_NAME__.insertMany(req.body.items, { ordered: false });
+
+      res.status(201).json({
+        success: true,
+        message: `Created ${items.length} records`,
+        count: items.length,
+        data: items
+      });
+    } catch (error) {
+      next(error);
+    }
+  }
+);
+
+// Bulk Delete
+router.delete(
+  '/bulk/delete',
+  authenticateToken,
+  [
+    body('ids').isArray({ min: 1 }).withMessage('Must provide array of IDs'),
+    validateErrors
+  ],
+  async (req, res, next) => {
+    try {
+      const result = await __MODEL_NAME__.deleteMany({
+        _id: { $in: req.body.ids }
+      });
+
+      res.status(200).json({
+        success: true,
+        message: `Deleted ${result.deletedCount} records`,
+        deletedCount: result.deletedCount
+      });
+    } catch (error) {
+      next(error);
+    }
+  }
+);
+
+// Bulk Update
+router.put(
+  '/bulk/update',
+  [
+    body('updates').isArray().withMessage('Must provide array of updates'),
+    validateErrors
+  ],
+  async (req, res, next) => {
+    try {
+      const bulkOps = req.body.updates.map(update => ({
+        updateOne: {
+          filter: { _id: update.id },
+          update: { $set: update.data },
+          upsert: false
+        }
+      }));
+
+      const result = await __MODEL_NAME__.bulkWrite(bulkOps);
+
+      res.status(200).json({
+        success: true,
+        message: 'Bulk update completed',
+        modifiedCount: result.modifiedCount,
+        matchedCount: result.matchedCount
+      });
+    } catch (error) {
+      next(error);
+    }
+  }
+);
+
+// ============================================
+// STATISTICS & AGGREGATION
+// ============================================
+router.get(
+  '/stats/aggregate',
+  async (req, res, next) => {
+    try {
+      const total = await __MODEL_NAME__.countDocuments();
+      const recent = await __MODEL_NAME__.find().sort({ createdAt: -1 }).limit(5);
+
+      res.status(200).json({
+        success: true,
+        stats: {
+          total,
+          recent
+        }
+      });
+    } catch (error) {
+      next(error);
+    }
+  }
+);
+
+export default router;
+

package/templates/auth.middleware.template.js

@@ -0,0 +1,87 @@
+import jwt from 'jsonwebtoken';
+
+// Ensure JWT_SECRET is consistent across all auth checks
+const JWT_SECRET = process.env.JWT_SECRET || 'your_super_secret_jwt_key_change_this_in_production';
+
+/**
+ * JWT Authentication Middleware
+ * Verifies JWT token from Authorization header
+ */
+export const authenticateToken = (req, res, next) => {
+  try {
+    const authHeader = req.headers['authorization'];
+    const token = authHeader && authHeader.split(' ')[1]; // Bearer TOKEN
+
+    if (!token) {
+      return res.status(401).json({
+        success: false,
+        message: 'Access token required',
+        code: 'NO_TOKEN'
+      });
+    }
+
+    jwt.verify(token, JWT_SECRET, (err, user) => {
+      if (err) {
+        if (err.name === 'TokenExpiredError') {
+          return res.status(401).json({
+            success: false,
+            message: 'Token has expired',
+            code: 'TOKEN_EXPIRED'
+          });
+        }
+        return res.status(403).json({
+          success: false,
+          message: 'Invalid token',
+          code: 'INVALID_TOKEN'
+        });
+      }
+
+      req.user = user;
+      next();
+    });
+  } catch (error) {
+    res.status(500).json({
+      success: false,
+      message: 'Token verification failed',
+      error: error.message
+    });
+  }
+};
+
+/**
+ * Optional Authentication Middleware
+ * Doesn't fail if no token, just sets req.user if valid token exists
+ */
+export const optionalAuth = (req, res, next) => {
+  try {
+    const authHeader = req.headers['authorization'];
+    const token = authHeader && authHeader.split(' ')[1];
+
+    if (!token) {
+      return next();
+    }
+
+    jwt.verify(token, JWT_SECRET, (err, user) => {
+      if (!err) {
+        req.user = user;
+      }
+      next();
+    });
+  } catch (error) {
+    next();
+  }
+};
+
+/**
+ * Admin Only Middleware
+ */
+export const adminOnly = (req, res, next) => {
+  if (!req.user || req.user.role !== 'admin') {
+    return res.status(403).json({
+      success: false,
+      message: 'Admin access required',
+      code: 'ADMIN_ONLY'
+    });
+  }
+  next();
+};