![\"Vexora](\"https://img.shields.io/badge/Vexora-Engine-8b5cf6?style=for-the-badge&logo=lightning&logoColor=white\"){kind=icon}
\n\n
\n The Backend Master โ Enterprise-Grade, Blazing-Fast, Zero-Dependency Node.js Engine\n
\n\n\n ![\"npm](\"https://img.shields.io/npm/v/vexora?style=flat-square&color=8b5cf6&label=npm\")
![\"npm](\"https://img.shields.io/npm/dm/vexora?style=flat-square&color=8b5cf6&label=downloads\")
![\"License:](\"https://img.shields.io/badge/License-MIT-10b981.svg?style=flat-square\"){kind=icon}
\n ![\"Zero](\"https://img.shields.io/badge/dependencies-0-10b981.svg?style=flat-square\"){kind=icon}
\n ![\"Node](\"https://img.shields.io/badge/node-%3E%3D18.0.0-3b82f6.svg?style=flat-square\"){kind=icon}
\n ![\"Performance\"](\"https://img.shields.io/badge/throughput-~90%2C000%20req%2Fs-f59e0b.svg?style=flat-square\"){kind=icon}
\n
\n Build high-performance REST APIs, real-time WebSockets, encrypted file storage, background job queues,
\n and complex database-driven architectures โ all without a single third-party dependency.\n
Your account is ready.
\"\n });\n\n if (response.success) {\n console.log(\"โ Email sent!\");\n console.log(\"SMTP Logs:\", response.log);\n }\n} catch (error) {\n console.error(\"โ Failed:\", error.message);\n}\n```\n\n### Dynamic Credentials (Multi-Tenancy)\n\n```javascript\nawait Vexora.mail.send({\n host: \"custom-smtp.server.com\",\n port: 587,\n secure: true,\n user: \"tenant-auth\",\n pass: \"tenant-pass\",\n from: \"custom@tenant.com\",\n to: \"client@example.com\",\n subject: \"Tenant Email\",\n text: \"Hello from tenant!\"\n});\n```\n\n\n---\n\n\n\n## ๐ HTTP Client\n\nNative lightweight HTTP/HTTPS request wrapper:\n\n```javascript\nimport Vexora from \"vexora\";\n\n// POST request with body and headers\nconst response = await Vexora.http.post(\n \"https://api.example.com/users\",\n { name: \"Satyam Kumar\", role: \"developer\" },\n { headers: { \"Authorization\": \"Bearer YOUR_TOKEN\" } }\n);\n\nif (response.ok) {\n console.log(\"Data:\", response.data);\n} else {\n console.log(\"Error:\", response.status);\n}\n\n// GET request with query parameters\nconst search = await Vexora.http.get(\"https://api.example.com/search\", {\n query: { q: \"vexora\", page: 1 },\n headers: { \"Accept\": \"application/json\" }\n});\n\n// PUT, PATCH, DELETE also available\nconst del = await Vexora.http.delete(\"https://api.example.com/users/1\", {\n headers: { \"Authorization\": \"Bearer token\" }\n});\n```\n\n\n---\n\n\n\n## ๐ซ IP Blocking\n\nZero-overhead IP blocking at the start of the server lifecycle:\n\n```ini\n# .vexora_config/config\nBLOCKED_IPS=192.168.1.50,10.0.0.99,8.8.8.8\n```\n\nBlocked IPs are rejected immediately with `403 Forbidden` โ no routing, database, or session logic is executed.\n\n\n---\n\n\n\n## โ ๏ธ Suspicious Activity Throttling\n\nAutomatic per-IP rate monitoring with temporary auto-blocking:\n\n```ini\n# .vexora_config/config\nSUSPICIOUS_WINDOW=60 # Time window in seconds (default: 60)\nSUSPICIOUS_THRESHOLD=30 # Max requests before blocking (default: 30)\nAUTO_BLOCK_DURATION=300 # Block duration in seconds (default: 300)\n```\n\n**Behavior:**\n- **Normal** (< threshold): Requests proceed normally\n- **Abusive** (โฅ threshold): IP auto-blocked in RAM Cache for `AUTO_BLOCK_DURATION` seconds โ `403 Forbidden`\n- **After expiry**: IP automatically unblocked\n\n> [!NOTE]\n> The suspicious tracker uses a memory-bounded map (max 100,000 entries). Under extreme DDoS conditions, the entire tracker is flushed as an emergency measure to prevent memory exhaustion.\n\n\n---\n\n\n\n## โณ Custom Rate Limiters\n\nIndependent rate limiters for different resources:\n\n```javascript\n// Create a rate limiter: 30 requests per 60 seconds\nconst apiLimiter = new Vexora.RateLimiterClass({\n isEnabled: true,\n maxRequests: 30,\n windowSeconds: 60\n});\n\n// Check in your handler\nconst check = apiLimiter.check(req);\nif (!check.allowed) {\n res.statusCode = 429;\n return res.json({\n status: false,\n message: `Too many requests. Retry after ${check.retryAfter}s.`\n });\n}\n```\n\n\n---\n\n\n\n## ๐ค Bot Behavior Analyzer\n\nState-of-the-art behavioral guard that distinguishes humans from automated scripts:\n\n### Configuration\n\n```ini\n# .vexora_config/config\nDETECT_BOT_BEHAVIOR=true # Enable/disable (default: true)\nBOT_MIN_JITTER=15 # Min interval jitter in ms (default: 15)\nMAX_CONSECUTIVE_404S=15 # Max 404s before blocking (default: 15)\n```\n\n### Protection Layers\n\n| Layer | Description |\n|:------|:------------|\n| **Jitter Analysis** | Tracks time intervals between requests. If standard deviation < `BOT_MIN_JITTER` over 6+ requests, detects bot loop and blocks IP. |\n| **User-Agent Filter** | Blocks `puppeteer`, `playwright`, `selenium`, `headlesschrome`, `curl`, `wget`, `python-requests` on first request. |\n| **Route Scanner Guard** | Tracks consecutive `404` responses. After `MAX_CONSECUTIVE_404S` failures, flags as vulnerability scanner and blocks IP. |\n\n\n---\n\n\n\n## ๐ก๏ธ CAPTCHA Verification\n\nNative verification for Google reCAPTCHA and Cloudflare Turnstile:\n\n### Configuration\n\n```ini\n# .vexora_config/config\nCAPTCHA_PROVIDER=google # 'google' or 'turnstile'\nRECAPTCHA_SECRET=YOUR_SECRET_KEY\n```\n\n### Direct Verification\n\n```javascript\nconst result = await Vexora.verifyCaptcha(req.body.captcha_token);\n\nif (result.success) {\n console.log(\"Score (v3):\", result.score);\n} else {\n console.log(\"Failed:\", result.errorCodes);\n}\n```\n\n### Middleware\n\n```javascript\nconst captchaGuard = Vexora.captcha({\n tokenField: \"captcha_token\",\n headerName: \"x-captcha-token\"\n});\n\nconst app = Vexora.start(3000);\n\napp.post(\"/secure-endpoint\", async (req, res) => {\n const blocked = await captchaGuard(req, res);\n if (blocked) return;\n\n return res.success(null, \"Access granted!\");\n});\n```\n\n\n---\n\n\n\n## ๐๏ธ Queue & Background Jobs\n\nNative concurrent queue and background worker system:\n\n### Configuration\n\n```ini\n# .vexora_config/config\nQUEUE_DRIVER=memory # 'memory' or 'cache' (persistent)\nQUEUE_AUTO_START=true # Auto-start worker on boot\nQUEUE_CONCURRENCY=2 # Concurrent job processing\nQUEUE_POLL_INTERVAL=1000 # Polling interval in ms\n```\n\n### Complete Example\n\n```javascript\nimport Vexora from \"vexora\";\n\n// Define job handler\nVexora.Queue.define(\"send-welcome-email\", async (data) => {\n console.log(`[Queue] Sending email to: ${data.email}`);\n await Vexora.mail.send({\n to: data.email,\n subject: \"Welcome!\",\n html: \"