qhttpx 1.9.4 → 2.0.1

package/dist/src/signals.js

@@ -1,31 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.attachSignalHandlers = attachSignalHandlers;
-function attachSignalHandlers(app, options = {}) {
-    const signals = options.signals ?? ['SIGINT', 'SIGTERM'];
-    const timeoutMs = options.timeoutMs ?? 10000;
-    let shuttingDown = false;
-    const handler = async (signal) => {
-        if (shuttingDown) {
-            return;
-        }
-        shuttingDown = true;
-        console.log(`Received ${signal}, shutting down...`);
-        const timer = setTimeout(() => {
-            console.error('Shutdown timed out, forcing exit. (some connections might be lost)');
-            process.exit(1);
-        }, timeoutMs);
-        try {
-            await app.shutdown();
-            clearTimeout(timer);
-            process.exit(0);
-        }
-        catch (err) {
-            console.error('Error during shutdown:', err);
-            process.exit(1);
-        }
-    };
-    for (const signal of signals) {
-        process.on(signal, handler);
-    }
-}

package/dist/src/static.js

@@ -1,107 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createStaticMiddleware = createStaticMiddleware;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-function guessContentType(filePath) {
-    const ext = path_1.default.extname(filePath).toLowerCase();
-    if (ext === '.html' || ext === '.htm') {
-        return 'text/html; charset=utf-8';
-    }
-    if (ext === '.js') {
-        return 'application/javascript; charset=utf-8';
-    }
-    if (ext === '.css') {
-        return 'text/css; charset=utf-8';
-    }
-    if (ext === '.json') {
-        return 'application/json; charset=utf-8';
-    }
-    if (ext === '.png') {
-        return 'image/png';
-    }
-    if (ext === '.jpg' || ext === '.jpeg') {
-        return 'image/jpeg';
-    }
-    if (ext === '.gif') {
-        return 'image/gif';
-    }
-    if (ext === '.svg') {
-        return 'image/svg+xml';
-    }
-    return 'application/octet-stream';
-}
-function createStaticMiddleware(options) {
-    const root = path_1.default.resolve(options.root);
-    const indexFile = options.index ?? 'index.html';
-    const fallthrough = options.fallthrough ?? false;
-    return async (ctx, next) => {
-        const method = ctx.req.method || 'GET';
-        if (method !== 'GET' && method !== 'HEAD') {
-            if (fallthrough) {
-                await next();
-                return;
-            }
-            ctx.res.statusCode = 405;
-            ctx.res.setHeader('content-type', 'text/plain; charset=utf-8');
-            ctx.res.end('Method Not Allowed');
-            return;
-        }
-        let requestPath = ctx.url.pathname || '/';
-        requestPath = requestPath.replace(/^[/\\]+/, '');
-        if (requestPath === '') {
-            requestPath = indexFile;
-        }
-        else if (requestPath.endsWith('/')) {
-            requestPath = requestPath + indexFile;
-        }
-        let safePath = path_1.default.normalize(requestPath);
-        safePath = safePath.replace(/^(\.\.(\/|\\|$))+/, '');
-        const filePath = path_1.default.join(root, safePath);
-        let stat;
-        try {
-            stat = await fs_1.default.promises.stat(filePath);
-        }
-        catch {
-            if (fallthrough) {
-                await next();
-                return;
-            }
-            ctx.res.statusCode = 404;
-            ctx.res.setHeader('content-type', 'text/plain; charset=utf-8');
-            ctx.res.end('Not Found');
-            return;
-        }
-        if (!stat.isFile()) {
-            if (fallthrough) {
-                await next();
-                return;
-            }
-            ctx.res.statusCode = 404;
-            ctx.res.setHeader('content-type', 'text/plain; charset=utf-8');
-            ctx.res.end('Not Found');
-            return;
-        }
-        const contentType = guessContentType(filePath);
-        ctx.res.setHeader('content-type', contentType);
-        ctx.res.statusCode = 200;
-        if (method === 'HEAD') {
-            ctx.res.end();
-            return;
-        }
-        try {
-            const data = await fs_1.default.promises.readFile(filePath);
-            ctx.res.end(data);
-        }
-        catch {
-            if (!ctx.res.headersSent) {
-                ctx.res.statusCode = 500;
-                ctx.res.setHeader('content-type', 'text/plain; charset=utf-8');
-            }
-            ctx.res.end('Internal Server Error');
-        }
-    };
-}

package/dist/src/stream.js

@@ -1,71 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createSseStream = createSseStream;
-exports.sendStream = sendStream;
-function createSseStream(ctx, options = {}) {
-    const res = ctx.res;
-    if (!res.headersSent) {
-        res.statusCode = 200;
-        res.setHeader('content-type', 'text/event-stream; charset=utf-8');
-        res.setHeader('cache-control', 'no-cache');
-        res.setHeader('connection', 'keep-alive');
-    }
-    const anyRes = res;
-    if (anyRes.flushHeaders) {
-        anyRes.flushHeaders();
-    }
-    if (typeof options.retryMs === 'number') {
-        res.write(`retry: ${options.retryMs}\n\n`);
-    }
-    const send = (data, event) => {
-        if (res.writableEnded) {
-            return;
-        }
-        const payload = typeof data === 'string' ? data : JSON.stringify(data);
-        let chunk = '';
-        if (event) {
-            chunk += `event: ${event}\n`;
-        }
-        chunk += `data: ${payload}\n\n`;
-        res.write(chunk);
-        if (anyRes.flush) {
-            anyRes.flush();
-        }
-    };
-    const close = () => {
-        if (!res.writableEnded) {
-            res.end();
-        }
-    };
-    return { send, close };
-}
-function sendStream(ctx, stream, options = {}) {
-    const res = ctx.res;
-    if (!res.headersSent) {
-        if (options.status !== undefined) {
-            res.statusCode = options.status;
-        }
-        if (options.contentType) {
-            res.setHeader('content-type', options.contentType);
-        }
-    }
-    return new Promise((resolve, reject) => {
-        stream.on('error', (err) => {
-            if (!res.headersSent) {
-                res.statusCode = 500;
-                res.setHeader('content-type', 'text/plain; charset=utf-8');
-            }
-            if (!res.writableEnded) {
-                res.end('Internal Server Error');
-            }
-            reject(err);
-        });
-        stream.on('end', () => {
-            if (!res.writableEnded) {
-                res.end();
-            }
-            resolve();
-        });
-        stream.pipe(res, { end: false });
-    });
-}

package/dist/src/tasks.js

@@ -1,87 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TaskEngine = void 0;
-class TaskEngine {
-    constructor(scheduler) {
-        this.tasks = new Map();
-        this.registeredTasksCount = 0;
-        this.totalEnqueued = 0;
-        this.totalCompleted = 0;
-        this.totalFailed = 0;
-        this.totalOverloaded = 0;
-        this.totalRetried = 0;
-        this.scheduler = scheduler;
-    }
-    register(name, handler, options = {}) {
-        if (!this.tasks.has(name)) {
-            this.registeredTasksCount += 1;
-        }
-        this.tasks.set(name, {
-            name,
-            handler,
-            options,
-        });
-    }
-    async enqueue(name, payload) {
-        const def = this.tasks.get(name);
-        if (!def) {
-            throw new Error(`Task "${name}" is not registered`);
-        }
-        this.totalEnqueued += 1;
-        await this.executeWithRetry(def, payload);
-    }
-    getMetrics() {
-        return {
-            registeredTasks: this.registeredTasksCount,
-            totalEnqueued: this.totalEnqueued,
-            totalCompleted: this.totalCompleted,
-            totalFailed: this.totalFailed,
-            totalOverloaded: this.totalOverloaded,
-            totalRetried: this.totalRetried,
-        };
-    }
-    async executeWithRetry(def, payload) {
-        const maxRetries = def.options.maxRetries ?? 0;
-        const backoffMs = def.options.backoffMs ?? 0;
-        let attempt = 0;
-        for (;;) {
-            let overloaded = false;
-            let error;
-            await this.scheduler.run(async () => {
-                try {
-                    await def.handler(payload);
-                }
-                catch (err) {
-                    error = err;
-                }
-            }, {
-                onOverloaded: () => {
-                    overloaded = true;
-                },
-            });
-            if (!overloaded && !error) {
-                this.totalCompleted += 1;
-                return;
-            }
-            if (attempt >= maxRetries) {
-                if (error) {
-                    this.totalFailed += 1;
-                    throw error;
-                }
-                if (overloaded) {
-                    this.totalOverloaded += 1;
-                    throw new Error(`Task "${def.name}" overloaded`);
-                }
-                return;
-            }
-            attempt += 1;
-            this.totalRetried += 1;
-            if (backoffMs > 0) {
-                await new Promise((resolve) => {
-                    setTimeout(resolve, backoffMs);
-                });
-            }
-        }
-    }
-}
-exports.TaskEngine = TaskEngine;

package/dist/src/testing.js

@@ -1,40 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createTestClient = createTestClient;
-async function createTestClient(app) {
-    const { port } = await app.listen(0, '127.0.0.1');
-    const baseUrl = `http://127.0.0.1:${port}`;
-    const request = async (method, path, body, extraHeaders = {}) => {
-        const headers = { ...extraHeaders };
-        const init = {
-            method,
-            headers,
-        };
-        if (body !== undefined) {
-            if (typeof body === 'string') {
-                init.body = body;
-            }
-            else if (body instanceof Uint8Array || Buffer.isBuffer(body)) {
-                init.body = body;
-            }
-            else {
-                init.body = JSON.stringify(body);
-                if (!('content-type' in headers)) {
-                    headers['content-type'] = 'application/json';
-                }
-            }
-        }
-        return fetch(`${baseUrl}${path}`, init);
-    };
-    return {
-        get: (path, headers) => request('GET', path, undefined, headers),
-        post: (path, body, headers) => request('POST', path, body, headers),
-        put: (path, body, headers) => request('PUT', path, body, headers),
-        delete: (path, headers) => request('DELETE', path, undefined, headers),
-        close: async () => {
-            await app.close();
-        },
-        app,
-        url: baseUrl,
-    };
-}

package/dist/src/types.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HttpError = exports.RoutePriority = void 0;
-var RoutePriority;
-(function (RoutePriority) {
-    RoutePriority["CRITICAL"] = "critical";
-    RoutePriority["STANDARD"] = "standard";
-    RoutePriority["BEST_EFFORT"] = "best-effort";
-})(RoutePriority || (exports.RoutePriority = RoutePriority = {}));
-class HttpError extends Error {
-    constructor(status, message, options = {}) {
-        super(message ?? 'HTTP Error');
-        this.status = status;
-        this.code = options.code;
-        this.details = options.details;
-        Object.setPrototypeOf(this, new.target.prototype);
-    }
-}
-exports.HttpError = HttpError;

package/dist/src/utils/testing.js

@@ -1,40 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createTestClient = createTestClient;
-async function createTestClient(app) {
-    const { port } = await app.listen(0, '127.0.0.1');
-    const baseUrl = `http://127.0.0.1:${port}`;
-    const request = async (method, path, body, extraHeaders = {}) => {
-        const headers = { ...extraHeaders };
-        const init = {
-            method,
-            headers,
-        };
-        if (body !== undefined) {
-            if (typeof body === 'string') {
-                init.body = body;
-            }
-            else if (body instanceof Uint8Array || Buffer.isBuffer(body)) {
-                init.body = body;
-            }
-            else {
-                init.body = JSON.stringify(body);
-                if (!('content-type' in headers)) {
-                    headers['content-type'] = 'application/json';
-                }
-            }
-        }
-        return fetch(`${baseUrl}${path}`, init);
-    };
-    return {
-        get: (path, headers) => request('GET', path, undefined, headers),
-        post: (path, body, headers) => request('POST', path, body, headers),
-        put: (path, body, headers) => request('PUT', path, body, headers),
-        delete: (path, headers) => request('DELETE', path, undefined, headers),
-        close: async () => {
-            await app.close();
-        },
-        app,
-        url: baseUrl,
-    };
-}

package/dist/src/worker-queue.js

@@ -1,73 +0,0 @@
-"use strict";
-/**
- * Lock-free (or lock-minimal) work queue for per-worker task distribution.
- * Uses a simple ring buffer for high throughput.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WorkerQueue = void 0;
-class WorkerQueue {
-    constructor(capacity = 1024) {
-        this.writeIndex = 0;
-        this.readIndex = 0;
-        this.size = 0;
-        if (capacity <= 0 || !Number.isInteger(capacity)) {
-            throw new Error('Capacity must be a positive integer');
-        }
-        // Ensure capacity is a power of 2 for efficient modulo with bitmask
-        this.capacity = Math.pow(2, Math.ceil(Math.log2(capacity)));
-        this.buffer = new Array(this.capacity);
-    }
-    /**
-     * Enqueue a work item. Returns true if successful, false if queue is full.
-     */
-    enqueue(item) {
-        if (this.size >= this.capacity) {
-            return false;
-        }
-        this.buffer[this.writeIndex] = item;
-        this.writeIndex = (this.writeIndex + 1) & (this.capacity - 1);
-        this.size += 1;
-        return true;
-    }
-    /**
-     * Dequeue a work item. Returns undefined if queue is empty.
-     */
-    dequeue() {
-        if (this.size <= 0) {
-            return undefined;
-        }
-        const item = this.buffer[this.readIndex];
-        this.buffer[this.readIndex] = undefined;
-        this.readIndex = (this.readIndex + 1) & (this.capacity - 1);
-        this.size -= 1;
-        return item;
-    }
-    /**
-     * Peek at the next item without removing it.
-     */
-    peek() {
-        if (this.size <= 0) {
-            return undefined;
-        }
-        return this.buffer[this.readIndex];
-    }
-    /**
-     * Check if the queue is empty.
-     */
-    isEmpty() {
-        return this.size === 0;
-    }
-    /**
-     * Get the current size of the queue.
-     */
-    getSize() {
-        return this.size;
-    }
-    /**
-     * Get the capacity of the queue.
-     */
-    getCapacity() {
-        return this.capacity;
-    }
-}
-exports.WorkerQueue = WorkerQueue;

package/dist/tests/native-adapter.test.d.ts

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

package/dist/tests/native-adapter.test.js

@@ -1,71 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const vitest_1 = require("vitest");
-const native_adapter_1 = require("../src/core/native-adapter");
-const index_1 = require("../src/index");
-const net_1 = __importDefault(require("net"));
-// Mock the NativeServer module
-vitest_1.vi.mock('../src/native', () => {
-    return {
-        NativeServer: class MockNativeServer {
-            constructor() {
-                this.isAvailable = true;
-            }
-            parse(buffer) {
-                const str = buffer.toString();
-                if (str.includes('GET / HTTP/1.1')) {
-                    return {
-                        method: 'GET',
-                        path: '/',
-                        version: 1,
-                        headers: { host: 'localhost' },
-                        bodyOffset: str.indexOf('\r\n\r\n') + 4
-                    };
-                }
-                return undefined;
-            }
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            createResponse(statusCode, headers, body) {
-                return Buffer.from(`HTTP/1.1 ${statusCode} OK\r\n\r\n${body || ''}`);
-            }
-        }
-    };
-});
-(0, vitest_1.describe)('NativeAdapter', () => {
-    let app;
-    let adapter;
-    let server;
-    let port = 0;
-    (0, vitest_1.beforeEach)(() => {
-        app = (0, index_1.createHttpApp)();
-        adapter = new native_adapter_1.NativeAdapter(app);
-    });
-    (0, vitest_1.afterEach)(async () => {
-        if (server) {
-            await new Promise(resolve => server.close(() => resolve()));
-        }
-    });
-    (0, vitest_1.it)('should handle request using native parser mock', async () => {
-        app.get('/', ({ res }) => { res.end('Native Works'); });
-        await new Promise((resolve) => {
-            server = adapter.listen(0, () => {
-                port = server.address().port;
-                resolve();
-            });
-        });
-        const socket = net_1.default.createConnection(port);
-        const responsePromise = new Promise((resolve) => {
-            socket.on('data', (data) => {
-                resolve(data.toString());
-                socket.end();
-            });
-        });
-        socket.write('GET / HTTP/1.1\r\nHost: localhost\r\n\r\n');
-        const response = await responsePromise;
-        (0, vitest_1.expect)(response).toContain('HTTP/1.1 200 OK');
-        (0, vitest_1.expect)(response).toContain('Native Works');
-    });
-});

package/scripts/install-native.js

@@ -1,26 +0,0 @@
-const { execSync } = require('child_process');
-const fs = require('fs');
-const path = require('path');
-
-// Graceful Native Build Strategy
-// This script attempts to build the native addon but swallows errors
-// to ensure installation succeeds even on environments without C++ tools.
-
-try {
-  // Check if prebuilds exist (optional optimization)
-  // But usually we want to try building if we are installing from source/npm
-  
-  console.log('QHTTPX: Attempting native compilation...');
-  
-  // Use node-gyp directly. It should be available in npm environment.
-  // We inherit stdio so user can see progress/errors if they care, 
-  // but we catch the error to prevent install failure.
-  execSync('node-gyp rebuild', { stdio: 'inherit' });
-  
-  console.log('QHTTPX: Native compilation successful.');
-} catch (error) {
-  console.log('QHTTPX: Native compilation failed.');
-  console.log('QHTTPX: Falling back to pure JavaScript/WASM adapter.');
-  // Exit with 0 to allow installation to proceed
-  process.exit(0);
-}

package/src/native/README.md

@@ -1,31 +0,0 @@
-# QHTTPX Native Addon
-
-This directory contains the C++ native addon for QHTTPX to accelerate HTTP parsing and response generation.
-
-## Prerequisites
-
-To build this addon, you need:
-- **Windows**: Visual Studio Build Tools (Desktop development with C++).
-- **Linux/macOS**: Python 3, make, and a C++ compiler (GCC/Clang).
-
-## Building
-
-The build is handled automatically by `npm install` if `node-gyp` and build tools are present.
-
-To manually rebuild:
-```bash
-npx node-gyp rebuild
-```
-
-## Structure
-
-- `addon.cc`: Entry point, registers the module.
-- `server.cc`: `NativeServer` class implementation.
-- `picohttpparser.c/h`: The HTTP parser library (vendored).
-- `index.ts`: TypeScript wrapper and fallback logic.
-
-## Usage
-
-The `NativeAdapter` in `src/core/native-adapter.ts` automatically detects if the native addon is available.
-If available, it uses `net.Server` + `NativeServer` for handling requests.
-If not, it falls back to the standard `http.Server`.

package/src/native/addon.cc

@@ -1,8 +0,0 @@
-#include <napi.h>
-#include "server.h"
-
-Napi::Object InitAll(Napi::Env env, Napi::Object exports) {
-  return NativeServer::Init(env, exports);
-}
-
-NODE_API_MODULE(qhttpx_native, InitAll)