qhttpx 2.0.0 → 2.1.0

package/README.md

@@ -2,9 +2,8 @@
   <img src="https://raw.githubusercontent.com/Quantam-Open-Source/qhttpx/main/assets/logo.svg" alt="QHTTPX Logo" width="200" height="200" />
 </div>
 
-
 <div align="center">
-  <strong>The High-Performance Hybrid HTTP Runtime for Node.js</strong>
+  <strong>The Ultra-Fast HTTP Framework for Node.js</strong>
 </div>
 
 <br />
@@ -13,18 +12,16 @@
 
 [![npm version](https://img.shields.io/npm/v/qhttpx.svg?style=flat-square)](https://www.npmjs.com/package/qhttpx)
 [![Downloads](https://img.shields.io/npm/dm/qhttpx.svg?style=flat-square)](https://www.npmjs.com/package/qhttpx)
-[![Website](https://img.shields.io/badge/website-qhttpx.gridrr.com-blueviolet.svg?style=flat-square)](https://qhttpx.gridrr.com)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](https://github.com/Quantam-Open-Source/qhttpx/blob/main/LICENSE)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)
 [![TypeScript](https://img.shields.io/badge/Written%20in-TypeScript-blue?style=flat-square)](https://www.typescriptlang.org)
+[![Production Ready](https://img.shields.io/badge/Production-Ready-brightgreen.svg?style=flat-square)](#)
 
 </div>
 
 <br />
 
-**QHTTPX** is a next-generation, concurrency-native HTTP runtime designed to outperform traditional frameworks like Express and Fastify. It is built from the ground up to handle extreme concurrency on low-resource hardware by leveraging a unified async scheduler for requests, streams, and background tasks.
-
-It is not just a web framework; it is an **Operating System for your API**.
+**QHttpX** is a high-performance HTTP framework for Node.js. Minimal API. Maximum performance. Built-in features like Request Fusion, WebSockets, and rate limiting.
 
 ---
 
@@ -45,10 +42,10 @@ Most Node.js frameworks rely on the event loop blindly. QHTTPX introduces a **Co
 
 | Feature | **QHTTPX** | Fastify | Express | Hono |
 | :--- | :---: | :---: | :---: | :---: |
-| **Core Runtime** | **⚡ Hybrid (C++ / JS)** | JS | JS | JS |
+| **Core Runtime** | **⚡ Pure TypeScript** | JS | JS | JS |
 | **Request Fusion** | **✅ Native** | ❌ | ❌ | ❌ |
 | **DDoS Protection** | **✅ Built-in (Aegis)** | ❌ | ❌ | ❌ |
-| **JSON Serialization** | **✅ Zero-Copy (C++)** | Schema-based | Slow | Slow |
+| **JSON Serialization** | **✅ Optimized Fast-Path** | Schema-based | Slow | Slow |
 | **Concurrency Model** | **✅ Async Scheduler** | Event Loop | Event Loop | Event Loop |
 | **Rate Limiting** | **✅ Zero-Overhead** | Plugin | Middleware | Middleware |
 | **Routing Algorithm** | **✅ Optimized Radix** | Radix Tree | Linear/Regex | RegExp/Trie |
@@ -129,6 +126,17 @@ Everything you need, built-in but modular.
 
 ---
 
+## 📚 Documentation
+
+New to QHttpX? Start here:
+
+- **[API Reference](./docs/API_REFERENCE.md)** - Complete API documentation with examples
+- **[Security Guide](./docs/SECURITY.md)** - Production security best practices
+- **[Production Deployment](./docs/PRODUCTION_DEPLOYMENT.md)** - Deploy to VPS, Docker, or Kubernetes
+- **[Migration Guide](./docs/MIGRATION_1.9_TO_2.0.md)** - Migrate from v1.9.4 to v2.0+
+
+---
+
 ## 📦 Installation
 
 ```bash
@@ -188,24 +196,26 @@ app.start(3000).then(() => console.log('Running on http://localhost:3000'));
 
 Run with: `node index.js`
 
-### 3. The Advanced Way (Custom Configuration)
-
-When you need specific configuration options or multiple instances.
+### 3. The Fluent Way (Advanced Configuration)
+Use the chainable API to configure advanced features like Request Fusion, Metrics, and Body Limits.
 
 ```typescript
-import { createHttpApp } from "qhttpx";
+import { app } from 'qhttpx';
 
-const app = createHttpApp({
-  enableRequestFusion: true, // Enable coalescing
-  maxBodySize: "1mb"
-});
+app.fusion(true)          // Enable Request Coalescing
+   .metrics(true)         // Enable Prometheus-style metrics
+   .bodyLimit(1024 * 1024)// Set 1MB body limit
+   .security({ cors: true });
 
-app.get("/users", ({ json, query }) => {
-  const { page } = query;
-  return { page };
+app.get('/heavy-compute', async () => {
+  // If 1000 users hit this at once, it executes ONLY ONCE
+  return await db.query('SELECT * FROM heavy_table');
 });
+
+app.start(3000);
 ```
 
+
 ---
 
 ## 📚 Documentation
@@ -223,21 +233,7 @@ Detailed guides for every feature of QHTTPX:
 
 ---
 
-## 📊 Benchmarks
 
-Benchmarks comparing **QHTTPX v1.8.6** against popular Node.js frameworks.
-*(Run on local environment: Windows, 100 connections, 10 pipelining, 40s duration. Average of 2 runs, taking the second result.)*
-
-| Framework | Req/Sec | Latency (Avg) | Throughput |
-| :--- | :--- | :--- | :--- |
-| **Fastify** | 16,050 | 256.78 ms | 3.00 Mb/s |
-| **QHTTPX** | **14,179** | **291.13 ms** | **3.02 Mb/s** |
-| **Hono** | 14,176 | 294.09 ms | 2.43 Mb/s |
-| **Express** | 10,450 | 407.12 ms | 1.94 Mb/s |
-
-> **Note**: QHTTPX achieves comparable throughput to Fastify while offering advanced features like **Request Fusion** (deduplication) which can significantly reduce database load in real-world scenarios.
-
----
 
 ## 🤝 Ecosystem Compatibility
 

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "qhttpx",
-    "version": "2.0.0",
+    "version": "2.1.0",
     "gypfile": false,
     "description": "The Ultra-Fast HTTP Framework for Node.js",
     "main": "dist/src/index.js",

package/dist/src/core/metrics.d.ts

@@ -29,7 +29,7 @@ export declare class Metrics {
     private readonly fusion?;
     private readonly latencies;
     private readonly maxLatencies;
-    private readonly enabled;
+    private _enabled;
     private totalRequests;
     private inFlightRequests;
     private totalErrors;
@@ -39,6 +39,7 @@ export declare class Metrics {
         enabled?: boolean;
     }, taskEngine?: TaskEngine, fusion?: RequestFusion);
     get isEnabled(): boolean;
+    setEnabled(value: boolean): void;
     onRequestStart(): void;
     onRequestEnd(durationMs: number, statusCode: number): void;
     onTimeout(): void;

package/dist/src/core/metrics.js

@@ -12,19 +12,22 @@ class Metrics {
         this.taskEngine = taskEngine;
         this.fusion = fusion;
         this.maxLatencies = options.maxLatencies ?? 1000;
-        this.enabled = options.enabled ?? true;
+        this._enabled = options.enabled ?? true;
     }
     get isEnabled() {
-        return this.enabled;
+        return this._enabled;
+    }
+    setEnabled(value) {
+        this._enabled = value;
     }
     onRequestStart() {
-        if (!this.enabled) {
+        if (!this._enabled) {
             return;
         }
         this.inFlightRequests += 1;
     }
     onRequestEnd(durationMs, statusCode) {
-        if (!this.enabled) {
+        if (!this._enabled) {
             return;
         }
         this.totalRequests += 1;
@@ -37,7 +40,7 @@ class Metrics {
         this.recordLatency(durationMs);
     }
     onTimeout() {
-        if (!this.enabled) {
+        if (!this._enabled) {
             return;
         }
         this.totalTimeouts += 1;
@@ -74,7 +77,7 @@ class Metrics {
         };
     }
     recordLatency(durationMs) {
-        if (!this.enabled) {
+        if (!this._enabled) {
             return;
         }
         if (!Number.isFinite(durationMs) || durationMs < 0) {

package/dist/src/core/server.js

@@ -1033,14 +1033,7 @@ class QHTTPX {
     }
     metrics(enable = true) {
         this.options.metricsEnabled = enable;
-        // Metrics instance checks this.options.metricsEnabled in some places?
-        // The Metrics class is initialized in constructor.
-        // We might need to update the metrics instance.
-        // But looking at Metrics class, it takes options in constructor.
-        // However, we can probably update the internal state if needed.
-        // For now, let's assume setting options is enough or we might need to expose a method on Metrics.
-        // Re-initializing metrics might be complex. 
-        // Let's assume the user calls this before start.
+        this._metrics.setEnabled(enable);
         return this;
     }
     error(status, message, details) {