qhttpx 1.8.12 → 1.9.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "qhttpx",
-  "version": "1.8.12",
-  "description": "The High-Performance Hybrid HTTP Runtime for Node.js. Built for extreme concurrency, request fusion, and zero-overhead scaling.",
+  "version": "1.9.0",
+  "description": "The Ultra-Fast HTTP Framework for Node.js",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
   "exports": {
@@ -17,6 +17,8 @@
   "files": [
     "dist",
     "src/native",
+    "prebuilds",
+    "scripts",
     "binding.gyp",
     "README.md",
     "LICENSE",
@@ -27,6 +29,7 @@
     "doc": "docs"
   },
   "scripts": {
+    "prebuild": "prebuildify --napi --strip",
     "build": "tsc -p tsconfig.json",
     "lint": "eslint src tests --ext .ts",
     "test": "vitest run",
@@ -63,6 +66,10 @@
   ],
   "author": "Quantam Open Source",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Quantam-Open-Source/qhttpx"
+  },
   "type": "commonjs",
   "devDependencies": {
     "@types/autocannon": "^7.12.7",
@@ -81,7 +88,9 @@
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.5",
     "mongodb": "^7.0.0",
+    "node-addon-api": "^8.5.0",
     "pg": "^8.17.1",
+    "prebuildify": "^6.0.1",
     "prettier": "^3.8.0",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
@@ -91,7 +100,7 @@
     "better-sqlite3": "^12.6.2",
     "busboy": "^1.6.0",
     "fast-json-stringify": "^5.15.1",
-    "node-addon-api": "^8.5.0",
+    "node-gyp-build": "^4.8.4",
     "pino": "^10.2.0",
     "pino-pretty": "^13.1.3",
     "quantam-async": "^0.1.1",

package/src/native/index.ts

@@ -1,4 +1,9 @@
+import path from 'path';
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const loadBinding = require('node-gyp-build');
 
+// EXPECTED ABI VERSION
+const EXPECTED_ABI = 1;
 
 export interface NativeServerBinding {
   parse(buffer: Buffer): {
@@ -17,23 +22,24 @@ export interface NativeServerBinding {
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 let nativeBinding: any = null;
 
-// Use try/catch with module.createRequire if import.meta is not available in some build targets
-// However, since we are in a TS module that might be commonjs or esm
-// We'll use a safer approach for require
 try {
-  const req = require;
+  // Look for prebuilds or built binary in root
+  const rootDir = __dirname.includes('dist') 
+    ? path.join(__dirname, '..', '..', '..')
+    : path.join(__dirname, '..', '..');
+    
+  const binding = loadBinding(rootDir);
   
-  try {
-    nativeBinding = req('../../build/Release/qhttpx_native.node');
-  } catch {
-    try {
-      nativeBinding = req('../../build/Debug/qhttpx_native.node');
-    } catch {
-      // Ignored
-    }
+  // 5. Version lock the ABI
+  if (binding && binding.abi === EXPECTED_ABI) {
+      nativeBinding = binding;
+  } else if (binding) {
+      // Version mismatch - disable native
+      // console.warn(`QHTTPX: Native ABI mismatch (Expected: ${EXPECTED_ABI}, Got: ${binding.abi}). Falling back to JS.`);
+      nativeBinding = null;
   }
 } catch {
-  // Ignored
+  // Graceful fallback to JS implementation
 }
 
 export class NativeServer {
@@ -41,7 +47,11 @@ export class NativeServer {
 
   constructor() {
     if (nativeBinding && nativeBinding.NativeServer) {
-      this.binding = new nativeBinding.NativeServer();
+      try {
+        this.binding = new nativeBinding.NativeServer();
+      } catch {
+        this.binding = null;
+      }
     } else {
       this.binding = null;
     }
@@ -51,28 +61,98 @@ export class NativeServer {
     return this.binding !== null;
   }
 
+  // 4. Guard every native call
   public parse(buffer: Buffer) {
-    if (!this.binding) throw new Error('Native bindings not available');
-    return this.binding.parse(buffer);
+    if (this.binding) {
+        try {
+            return this.binding.parse(buffer);
+        } catch {
+            this.disableNative();
+        }
+    }
+    // Fallback: If native parse fails, we return null.
+    // The NativeAdapter will see null and might close the connection or handle error.
+    // We cannot easily implement a full HTTP parser in JS here without adding dependencies.
+    // But since NativeAdapter falls back to http.Server if !isAvailable, 
+    // disabling native here ensures subsequent requests use the safe path.
+    return null;
   }
 
   public createResponse(statusCode: number, headers: Record<string, string>, body?: string | Buffer) {
-    if (!this.binding) throw new Error('Native bindings not available');
-    return this.binding.createResponse(statusCode, headers, body);
+    if (this.binding) {
+        try {
+            return this.binding.createResponse(statusCode, headers, body);
+        } catch {
+            this.disableNative();
+        }
+    }
+    return this.jsCreateResponse(statusCode, headers, body);
   }
 
   public createJSONResponse(obj: unknown) {
-    if (!this.binding) throw new Error('Native bindings not available');
-    return this.binding.createJSONResponse(obj);
+    if (this.binding) {
+        try {
+            return this.binding.createJSONResponse(obj);
+        } catch {
+            this.disableNative();
+        }
+    }
+    // Fallback: Use JSON.stringify + Buffer
+    return this.jsCreateJSONResponse(obj);
   }
 
   public writeResponse(fd: number, chunks: (Buffer | string)[]) {
-    if (!this.binding) throw new Error('Native bindings not available');
-    return this.binding.writeResponse(fd, chunks);
+    if (this.binding) {
+        try {
+            return this.binding.writeResponse(fd, chunks);
+        } catch {
+            this.disableNative();
+        }
+    }
+    // No JS fallback for raw FD writes (requires net.Socket usually)
+    // The caller (NativeAdapter) should handle this by using socket.write()
+    // We throw here so caller knows to use fallback
+    throw new Error('Native writeResponse not available');
   }
 
   public setCPUAffinity(cpuId: number) {
-    if (!this.binding) throw new Error('Native bindings not available');
-    return this.binding.setCPUAffinity(cpuId);
+    if (this.binding) {
+        try {
+            return this.binding.setCPUAffinity(cpuId);
+        } catch {
+             this.disableNative();
+        }
+    }
+    return false;
+  }
+
+  private disableNative() {
+    this.binding = null;
+    // console.warn('QHTTPX: Native module disabled due to error. Falling back to JS.');
+  }
+
+  // --- JS Fallbacks ---
+
+  private jsCreateResponse(statusCode: number, headers: Record<string, string>, body?: string | Buffer): Buffer {
+    const statusMessage = statusCode === 200 ? 'OK' : 'Unknown'; // Simplified
+    let head = `HTTP/1.1 ${statusCode} ${statusMessage}\r\n`;
+    for (const [key, value] of Object.entries(headers)) {
+        head += `${key}: ${value}\r\n`;
+    }
+    head += '\r\n';
+    
+    const headBuf = Buffer.from(head);
+    if (body) {
+        const bodyBuf = Buffer.isBuffer(body) ? body : Buffer.from(body);
+        return Buffer.concat([headBuf, bodyBuf]);
+    }
+    return headBuf;
+  }
+
+  private jsCreateJSONResponse(obj: unknown): Buffer {
+    const json = JSON.stringify(obj);
+    const contentLen = Buffer.byteLength(json);
+    const head = `HTTP/1.1 200 OK\r\nContent-Type: application/json\r\nContent-Length: ${contentLen}\r\n\r\n`;
+    return Buffer.concat([Buffer.from(head), Buffer.from(json)]);
   }
 }

package/src/native/picohttpparser.h

@@ -30,6 +30,11 @@
 
 #include <sys/types.h>
 
+#ifdef _WIN32
+#include <BaseTsd.h>
+typedef SSIZE_T ssize_t;
+#endif
+
 #ifdef __cplusplus
 extern "C" {
 #endif

package/src/native/server.cc

@@ -26,6 +26,8 @@ Napi::Object NativeServer::Init(Napi::Env env, Napi::Object exports) {
     env.SetInstanceData(constructor);
 
     exports.Set("NativeServer", func);
+    // Version Lock: Expose ABI version
+    exports.Set("abi", Napi::Number::New(env, 1));
     return exports;
 }
 

package/dist/examples/api-server.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/examples/api-server.js

@@ -1,77 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const index_1 = require("../src/index");
-const dotenv_1 = require("dotenv");
-// Load .env
-(0, dotenv_1.config)();
-// 1. Initialize App (Fusion + Aegis enabled)
-const app = (0, index_1.createHttpApp)({
-    enableRequestFusion: true, // ⚡ Auto-coalesce duplicate requests
-    metricsEnabled: true, // 📊 Expose /__qhttpx/metrics
-    rateLimit: {
-        windowMs: 15 * 60 * 1000,
-        max: 100,
-        trustProxy: true
-    },
-    cors: true, // 🛡️ Built-in CORS
-    compression: true // 🗜️ Built-in Compression (Gzip/Brotli)
-});
-// 2. Global Middleware (Logging is built-in by default)
-// No manual app.use(rateLimit(...)) needed!
-// 3. Validation Schema
-const UserSchema = {
-    body: {
-        type: 'object',
-        required: ['name', 'role'],
-        properties: { name: { type: 'string' }, role: { type: 'string' } }
-    }
-};
-// 4. Routes (Clean & Destructured)
-app.get('/', ({ json }) => json({ status: 'online', fusion: true }));
-// ⚡ Fused Endpoint: 1000 concurrent requests -> 1 DB execution
-app.get('/heavy', async ({ json }) => {
-    await new Promise(r => setTimeout(r, 100)); // Simulate DB
-    json({ data: 'Expensive Result', timestamp: Date.now() });
-});
-// 🛡️ Validated & Typed Route
-app.post('/users', { schema: UserSchema }, async ({ body, json }) => {
-    // Body is already validated and typed here
-    json({ created: true, user: body }, 201);
-});
-// � Header Auth Example
-app.post('/auth/verify', async ({ headers, json }) => {
-    const token = headers.authorization?.replace('Bearer ', '');
-    if (!token)
-        return json({ error: 'No token provided' }, 401);
-    // Verify token...
-    json({ valid: true, token });
-});
-// �📂 File Uploads (Typed)
-app.post('/upload', ({ files, json }) => {
-    if (!files?.doc)
-        return json({ error: 'No file' }, 400);
-    const doc = Array.isArray(files.doc) ? files.doc[0] : files.doc;
-    json({ filename: doc.filename, size: doc.size });
-});
-// 📡 WebSockets (Pub/Sub)
-app.upgrade('/chat', (ws) => {
-    ws.join('general'); // Auto-join room
-    ws.on('message', (msg) => {
-        // Broadcast to room
-        app.websocket.to('general').emit(`Echo: ${msg}`);
-    });
-});
-// 5. Unified Error Handling
-app.onError(({ error, json }) => {
-    if (error instanceof index_1.HttpError) {
-        return json({
-            error: error.message,
-            code: error.code,
-            details: error.details
-        }, error.status);
-    }
-    console.error(error); // Log internal error
-    json({ error: 'Internal Server Error', handled: true }, 500);
-});
-// 6. Start Server
-app.listen(3000, () => console.log('🚀 Server running on http://localhost:3000'));

package/dist/examples/basic.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/examples/basic.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const index_1 = require("../src/index");
-const app = (0, index_1.createHttpApp)();
-app.get('/', ({ json }) => {
-    json({ message: 'Hello from QHTTPX!' });
-});
-app.listen(3000, () => {
-    console.log('Server running on http://localhost:3000');
-});

package/dist/examples/compression.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/examples/compression.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const index_1 = require("../src/index");
-const app = (0, index_1.createHttpApp)({
-    // Enable Gzip/Brotli compression
-    compression: true
-    // Or with options:
-    // compression: { threshold: 2048 } // Only compress responses > 2KB
-});
-app.get('/large', ({ json }) => {
-    // Generate a large response to trigger compression
-    const data = Array(1000).fill('some repeated data to compress');
-    json({ data });
-});
-app.listen(3000, () => {
-    console.log('Compression-enabled server running on http://localhost:3000');
-});

package/dist/examples/cors.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/examples/cors.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const index_1 = require("../src/index");
-const app = (0, index_1.createHttpApp)({
-    // Simple: Enable CORS for all origins
-    // cors: true 
-    // Advanced: Configure specific origins
-    cors: {
-        origin: ['http://localhost:5173', 'https://myapp.com'],
-        methods: ['GET', 'POST'],
-        credentials: true
-    }
-});
-app.get('/api/data', ({ json }) => {
-    json({ data: 'This data is accessible via CORS' });
-});
-app.listen(3000, () => {
-    console.log('CORS-enabled server running on http://localhost:3000');
-});

package/dist/examples/errors.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/examples/errors.js

@@ -1,25 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const index_1 = require("../src/index");
-const app = (0, index_1.createHttpApp)();
-app.get('/missing', () => {
-    throw new index_1.NotFoundException('Resource not found');
-});
-app.get('/private', () => {
-    throw new index_1.ForbiddenException('You do not have access');
-});
-// Custom global error handler
-app.onError(({ error, json }) => {
-    if (error instanceof index_1.HttpError) {
-        return json({
-            status: 'error',
-            code: error.code,
-            message: error.message
-        }, error.status);
-    }
-    console.error('Unexpected error:', error);
-    json({ status: 'error', message: 'Internal Server Error' }, 500);
-});
-app.listen(3000, () => {
-    console.log('Error handling demo running on http://localhost:3000');
-});

package/dist/examples/file-upload.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/examples/file-upload.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const index_1 = require("../src/index");
-const app = (0, index_1.createHttpApp)({
-    // Limits for uploads
-    maxBodyBytes: 10 * 1024 * 1024 // 10MB
-});
-app.post('/upload', ({ files, json }) => {
-    if (!files || !files.document) {
-        return json({ error: 'No file uploaded' }, 400);
-    }
-    const doc = Array.isArray(files.document) ? files.document[0] : files.document;
-    console.log(`Received file: ${doc.filename} (${doc.size} bytes)`);
-    json({
-        uploaded: true,
-        filename: doc.filename,
-        mimetype: doc.mimeType,
-        size: doc.size
-    });
-});
-app.listen(3000, () => {
-    console.log('Upload server running on http://localhost:3000');
-    console.log('Send POST to /upload with form-data field "document"');
-});

package/dist/examples/fusion.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/examples/fusion.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const index_1 = require("../src/index");
-const app = (0, index_1.createHttpApp)({
-    // Enable Request Fusion (Request Coalescing)
-    enableRequestFusion: true
-});
-// Simulate a slow database call
-const heavyTask = async () => {
-    await new Promise(resolve => setTimeout(resolve, 500));
-    return { data: 'Expensive Result', timestamp: Date.now() };
-};
-// If 1000 users hit this endpoint simultaneously, 
-// the handler runs ONLY ONCE, and the result is shared.
-app.get('/heavy', async ({ json }) => {
-    const result = await heavyTask();
-    json(result);
-});
-app.listen(3000, () => {
-    console.log('Fusion-enabled server running on http://localhost:3000');
-});

package/dist/examples/rate-limiting.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/examples/rate-limiting.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const index_1 = require("../src/index");
-const app = (0, index_1.createHttpApp)({
-    rateLimit: {
-        windowMs: 15 * 60 * 1000, // 15 minutes
-        max: 100, // Limit each IP to 100 requests per window
-        message: 'Too many requests, please try again later.',
-        trustProxy: true // Trust X-Forwarded-For header (useful behind proxies like Nginx)
-    }
-});
-app.get('/', ({ json }) => {
-    json({ status: 'OK', message: 'Request accepted' });
-});
-app.listen(3000, () => {
-    console.log('Rate-limited server running on http://localhost:3000');
-});

package/dist/examples/validation.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/examples/validation.js

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const index_1 = require("../src/index");
-const app = (0, index_1.createHttpApp)();
-// Define a simple schema (or use Zod if configured)
-const UserSchema = {
-    body: {
-        type: 'object',
-        required: ['username', 'email'],
-        properties: {
-            username: { type: 'string' },
-            email: { type: 'string' }
-        }
-    }
-};
-// Apply schema to route
-app.post('/register', { schema: UserSchema }, ({ body, json }) => {
-    // 'body' is already validated and typed here (if using TS with inferred types)
-    json({ success: true, user: body });
-});
-app.listen(3000, () => {
-    console.log('Validation server running on http://localhost:3000');
-});

package/dist/examples/websockets.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/examples/websockets.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const index_1 = require("../src/index");
-const app = (0, index_1.createHttpApp)();
-app.upgrade('/chat', (ws) => {
-    console.log('Client connected');
-    ws.join('general');
-    ws.on('message', (msg) => {
-        console.log(`Received: ${msg}`);
-        // Broadcast to everyone in 'general' room
-        app.websocket.to('general').emit(`Echo: ${msg}`);
-    });
-    ws.on('close', () => {
-        console.log('Client disconnected');
-    });
-});
-app.listen(3000, () => {
-    console.log('WebSocket Server running on http://localhost:3000');
-    console.log('Test with a WebSocket client at ws://localhost:3000/chat');
-});

package/dist/package.json

@@ -1,101 +0,0 @@
-{
-    "name": "qhttpx",
-    "version": "1.8.12",
-    "description": "The High-Performance Hybrid HTTP Runtime for Node.js. Built for extreme concurrency, request fusion, and zero-overhead scaling.",
-    "main": "dist/src/index.js",
-    "types": "dist/src/index.d.ts",
-    "exports": {
-        ".": {
-            "types": "./dist/src/index.d.ts",
-            "require": "./dist/src/index.js",
-            "default": "./dist/src/index.js"
-        }
-    },
-    "bin": {
-        "qhttpx": "./dist/src/cli/index.js"
-    },
-    "files": [
-        "dist",
-        "src/native",
-        "binding.gyp",
-        "README.md",
-        "LICENSE",
-        "CHANGELOG.md",
-        "docs"
-    ],
-    "directories": {
-        "doc": "docs"
-    },
-    "scripts": {
-        "build": "tsc -p tsconfig.json",
-        "lint": "eslint src tests --ext .ts",
-        "test": "vitest run",
-        "example": "npx tsx examples/api-server.ts",
-        "bench": "npm run build && node dist/src/benchmarks/simple-json.js",
-        "bench:quantam": "npm run build && node dist/src/benchmarks/quantam-users.js",
-        "bench:ultra": "npm run build && node dist/src/benchmarks/ultra-mode.js"
-    },
-    "keywords": [
-        "http",
-        "server",
-        "web",
-        "framework",
-        "typescript",
-        "fast",
-        "performance",
-        "high-performance",
-        "async",
-        "concurrency",
-        "request-fusion",
-        "coalescing",
-        "middleware",
-        "websocket",
-        "sse",
-        "rate-limit",
-        "rest",
-        "api",
-        "json",
-        "router",
-        "radix-tree",
-        "scheduler",
-        "ultra-fast",
-        "nodejs"
-    ],
-    "author": "Quantam Open Source",
-    "license": "MIT",
-    "type": "commonjs",
-    "devDependencies": {
-        "@types/autocannon": "^7.12.7",
-        "@types/better-sqlite3": "^7.6.13",
-        "@types/busboy": "^1.5.4",
-        "@types/ioredis": "^4.28.10",
-        "@types/mongodb": "^4.0.6",
-        "@types/node": "^25.0.9",
-        "@types/pg": "^8.16.0",
-        "@types/ws": "^8.18.1",
-        "@typescript-eslint/eslint-plugin": "^8.53.0",
-        "@typescript-eslint/parser": "^8.53.0",
-        "autocannon": "^8.0.0",
-        "dotenv": "^17.2.3",
-        "eslint": "^9.39.2",
-        "eslint-config-prettier": "^10.1.8",
-        "eslint-plugin-prettier": "^5.5.5",
-        "mongodb": "^7.0.0",
-        "pg": "^8.17.1",
-        "prettier": "^3.8.0",
-        "tsx": "^4.21.0",
-        "typescript": "^5.9.3",
-        "vitest": "^4.0.17"
-    },
-    "dependencies": {
-        "better-sqlite3": "^12.6.2",
-        "busboy": "^1.6.0",
-        "fast-json-stringify": "^5.15.1",
-        "node-addon-api": "^8.5.0",
-        "pino": "^10.2.0",
-        "pino-pretty": "^13.1.3",
-        "quantam-async": "^0.1.1",
-        "ws": "^8.19.0",
-        "zod": "^4.3.5"
-    }
-}

package/dist/src/benchmarks/quantam-users.d.ts

@@ -1 +0,0 @@
-export {};