qhttpx 2.0.0 → 2.0.1

package/README.md

@@ -45,10 +45,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 |
@@ -188,24 +188,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 +225,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.0.1",
     "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) {

package/package.json

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