express-project-builder 1.0.13 → 1.0.15

package/README.md

@@ -345,3 +345,81 @@ import notFound from "./app/middlewares/notFound";
 app.use(globalErrorHandler as unknown as express.ErrorRequestHandler);
 app.use(notFound as unknown as express.ErrorRequestHandler);
 ```
+
+- /src/middlewares/**handleFileUpload.ts**  
+  Middleware for handling file uploads in multipart/form-data requests. Uses `multer` to process uploaded files and stores them in the specified directory. Returns an array of file objects (`req.files`) to the next middleware.
+
+```typescript
+// In your route file
+import { handle_file_upload_middleware } from "../../middlewares/handleFileUpload";
+
+// Apply the middleware to the route
+router.post(
+  "/create",
+  handle_file_upload_middleware([
+    {
+      fieldName: "image", // Form field name for the file
+      maxCount: 1, // Maximum number of files allowed
+      fileType: "image", // Type of file (image, document, etc.)
+      optional: false, // Whether the file is required,
+      allowedImageTypes: [
+        "image/jpeg",
+        "image/png",
+        "image/gif",
+        "image/webp",
+        "image/bmp",
+        "image/svg+xml",
+      ], // Allowed image types,
+      maxImageSize: 1024 * 1024 * 2, // Maximum image size in bytes (2MB)
+    },
+  ]),
+  formDataToSetJSONformatData, // Convert form data to JSON
+  ProductController.createProduct
+);
+```
+
+- /src/middlewares/**rateLimitingHandler.ts**  
+  Rate limiting middleware to prevent API abuse. Implements progressive rate limiting that increases block duration for repeat offenders.
+
+```typescript
+// In your app.ts file for global rate limiting or
+// In your route file for route-specific rate limiting
+
+import { createProgressiveRateLimiter } from "../../middlewares/rateLimitingHandler";
+
+// Create rate limiter instances with different configurations
+const apiRateLimiter = createProgressiveRateLimiter({
+  initialWindowMs: 60 * 1000, // 1 minute
+  initialMax: 100, // limit each IP to 100 requests per windowMs
+  initialBlockMs: 15 * 60 * 1000, // block for 15 minutes on first offense
+  message: {
+    success: false,
+    message: "Too many requests from this IP, please try again later.",
+  },
+  skipSuccessfulRequests: false,
+  skipFailedRequests: false,
+  // Custom keyGenerator to handle proxied requests
+  keyGenerator: (req: Request) => {
+    // Check for X-Forwarded-For header (common when behind proxy)
+    const forwarded = req.headers["x-forwarded-for"] as string;
+    if (forwarded) {
+      // If multiple IPs, take the first one (client IP)
+      return forwarded.split(",")[0].trim();
+    }
+
+    // Fallback to other methods
+    return (
+      req.ip ||
+      req.socket?.remoteAddress ||
+      req.connection?.remoteAddress ||
+      "unknown"
+    );
+  },
+});
+
+// Apply rate limiter to a specific route
+router.get("/products", apiRateLimiter, ProductControllers.getAllProducts);
+
+// Apply rate limiter globally to all API routes
+app.use("/v1/api/", apiRateLimiter, routers);
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "express-project-builder",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "description": "A powerful and professional Express.js project generator CLI that instantly scaffolds a production-ready backend with TypeScript, modular architecture, and built-in support for MongoDB (Mongoose) or PostgreSQL (Prisma). Includes authentication, error handling, rate limiting, file upload, caching, and utility functions—so you can focus on building features instead of boilerplate. Perfect for kickstarting your next Express.js API project with best practices and modern tools.",
   "type": "module",
   "main": "dist/bin/index.js",