qhttpx 1.8.12 → 1.9.1

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

@@ -1,34 +0,0 @@
-import { RoutePriority } from './types';
-export type SchedulerOptions = {
-    maxConcurrency?: number;
-    workers?: number;
-};
-export type RunOptions = {
-    priority?: RoutePriority;
-    onOverloaded?: () => void;
-    timeoutMs?: number;
-    onTimeout?: () => void;
-};
-export type SchedulerStats = {
-    inFlight: number;
-    maxConcurrency: number;
-    workers: number;
-    perWorkerStats: {
-        workerId: number;
-        queued: number;
-    }[];
-};
-export declare class Scheduler {
-    private inFlight;
-    private readonly maxConcurrency;
-    private readonly workerCount;
-    private readonly perWorkerQueues;
-    private nextWorkerIndex;
-    constructor(options?: SchedulerOptions);
-    getCurrentInFlight(): number;
-    /**
-     * Get scheduler statistics (queued tasks per worker, etc.)
-     */
-    getStats(): SchedulerStats;
-    run(task: () => void | Promise<void>, options: RunOptions): Promise<void>;
-}

package/dist/src/core/scheduler.js

@@ -1,85 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Scheduler = void 0;
-const worker_queue_1 = require("./worker-queue");
-const types_1 = require("./types");
-class Scheduler {
-    constructor(options = {}) {
-        this.inFlight = 0;
-        this.nextWorkerIndex = 0;
-        const max = options.maxConcurrency ?? Infinity;
-        this.maxConcurrency = max > 0 ? max : Infinity;
-        // Initialize per-worker queues
-        this.workerCount = options.workers ?? 1;
-        this.perWorkerQueues = [];
-        for (let i = 0; i < this.workerCount; i += 1) {
-            this.perWorkerQueues.push(new worker_queue_1.WorkerQueue(1024));
-        }
-    }
-    getCurrentInFlight() {
-        return this.inFlight;
-    }
-    /**
-     * Get scheduler statistics (queued tasks per worker, etc.)
-     */
-    getStats() {
-        return {
-            inFlight: this.inFlight,
-            maxConcurrency: this.maxConcurrency,
-            workers: this.workerCount,
-            perWorkerStats: this.perWorkerQueues.map((q, i) => ({
-                workerId: i,
-                queued: q.getSize(),
-            })),
-        };
-    }
-    async run(task, options) {
-        const priority = options.priority ?? types_1.RoutePriority.STANDARD;
-        let threshold = this.maxConcurrency;
-        if (priority === types_1.RoutePriority.BEST_EFFORT) {
-            // Shed best-effort requests if we are above 80% capacity
-            threshold = Math.max(1, Math.floor(this.maxConcurrency * 0.8));
-        }
-        else if (priority === types_1.RoutePriority.STANDARD) {
-            // Shed standard requests if we are above 95% capacity
-            threshold = Math.max(1, Math.floor(this.maxConcurrency * 0.95));
-        }
-        // CRITICAL allows up to 100%
-        if (this.inFlight >= threshold) {
-            if (options.onOverloaded) {
-                options.onOverloaded();
-            }
-            return;
-        }
-        this.inFlight += 1;
-        let timeoutId;
-        try {
-            if (!options.timeoutMs || options.timeoutMs <= 0) {
-                const result = task();
-                if (result && typeof result.then === 'function') {
-                    await result;
-                }
-                return;
-            }
-            const taskPromise = Promise.resolve(task()).then(() => 'ok');
-            const timeoutPromise = new Promise((resolve) => {
-                timeoutId = setTimeout(() => {
-                    resolve('timeout');
-                }, options.timeoutMs);
-            });
-            const result = await Promise.race([taskPromise, timeoutPromise]);
-            if (result === 'timeout') {
-                if (options.onTimeout) {
-                    options.onTimeout();
-                }
-            }
-        }
-        finally {
-            if (timeoutId) {
-                clearTimeout(timeoutId);
-            }
-            this.inFlight -= 1;
-        }
-    }
-}
-exports.Scheduler = Scheduler;

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

@@ -1,26 +0,0 @@
-import { QHTTPX } from './server';
-import { QHTTPXHandler, QHTTPXRouteOptions, QHTTPXMiddleware, QHTTPXPlugin, QHTTPXPluginOptions } from './types';
-/**
- * A Scope represents a prefixed or isolated context for plugins.
- * It proxies methods to the main QHTTPX instance but handles prefixing.
- */
-export declare class QHTTPXScope {
-    private readonly app;
-    private readonly prefix;
-    constructor(app: QHTTPX, prefix?: string);
-    /**
-     * Registers a sub-plugin within this scope.
-     * Prefixes are concatenated (e.g. /v1 + /users = /v1/users).
-     */
-    register<Options extends QHTTPXPluginOptions>(plugin: QHTTPXPlugin<Options>, options?: Options): Promise<void>;
-    use(middleware: QHTTPXMiddleware): void;
-    get(path: string, handler: QHTTPXHandler | QHTTPXRouteOptions): void;
-    post(path: string, handler: QHTTPXHandler | QHTTPXRouteOptions): void;
-    put(path: string, handler: QHTTPXHandler | QHTTPXRouteOptions): void;
-    delete(path: string, handler: QHTTPXHandler | QHTTPXRouteOptions): void;
-    patch(path: string, handler: QHTTPXHandler | QHTTPXRouteOptions): void;
-    options(path: string, handler: QHTTPXHandler | QHTTPXRouteOptions): void;
-    head(path: string, handler: QHTTPXHandler | QHTTPXRouteOptions): void;
-    getApp(): QHTTPX;
-    private joinPaths;
-}

package/dist/src/core/scope.js

@@ -1,68 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.QHTTPXScope = void 0;
-/**
- * A Scope represents a prefixed or isolated context for plugins.
- * It proxies methods to the main QHTTPX instance but handles prefixing.
- */
-class QHTTPXScope {
-    constructor(app, prefix = '') {
-        this.app = app;
-        this.prefix = prefix;
-    }
-    /**
-     * Registers a sub-plugin within this scope.
-     * Prefixes are concatenated (e.g. /v1 + /users = /v1/users).
-     */
-    async register(plugin, options) {
-        const newPrefix = this.joinPaths(this.prefix, options?.prefix || '');
-        const scope = new QHTTPXScope(this.app, newPrefix);
-        await plugin(scope, options);
-    }
-    use(middleware) {
-        // Middleware in scopes is currently global (TODO: Encapsulated middleware)
-        this.app.use(middleware);
-    }
-    get(path, handler) {
-        this.app._registerRoute('GET', this.joinPaths(this.prefix, path), handler);
-    }
-    post(path, handler) {
-        this.app._registerRoute('POST', this.joinPaths(this.prefix, path), handler);
-    }
-    put(path, handler) {
-        this.app._registerRoute('PUT', this.joinPaths(this.prefix, path), handler);
-    }
-    delete(path, handler) {
-        this.app._registerRoute('DELETE', this.joinPaths(this.prefix, path), handler);
-    }
-    patch(path, handler) {
-        this.app._registerRoute('PATCH', this.joinPaths(this.prefix, path), handler);
-    }
-    options(path, handler) {
-        this.app._registerRoute('OPTIONS', this.joinPaths(this.prefix, path), handler);
-    }
-    head(path, handler) {
-        this.app._registerRoute('HEAD', this.joinPaths(this.prefix, path), handler);
-    }
-    // Helper to access the main app if needed
-    getApp() {
-        return this.app;
-    }
-    joinPaths(head, tail) {
-        if (!head)
-            return tail;
-        if (!tail)
-            return head;
-        // Ensure clean slash joining
-        const headSlash = head.endsWith('/');
-        const tailSlash = tail.startsWith('/');
-        if (headSlash && tailSlash) {
-            return head + tail.slice(1);
-        }
-        if (!headSlash && !tailSlash) {
-            return head + '/' + tail;
-        }
-        return head + tail;
-    }
-}
-exports.QHTTPXScope = QHTTPXScope;

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

@@ -1,10 +0,0 @@
-/**
- * Fast JSON serializer using fast-json-stringify
- * For best performance, use schema-based stringifiers per route
- */
-export declare function fastJsonStringify(value: unknown, schema?: unknown): string;
-/**
- * Get a pre-compiled stringifier for a specific schema
- * Use this in route handlers for maximum performance
- */
-export declare function getStringifier(schema: unknown): (value: unknown) => string;

package/dist/src/core/serializer.js

@@ -1,44 +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.fastJsonStringify = fastJsonStringify;
-exports.getStringifier = getStringifier;
-const fast_json_stringify_1 = __importDefault(require("fast-json-stringify"));
-// Cache of compiled stringifiers per schema
-const stringifierCache = new Map();
-// Default fast JSON stringifier for generic objects
-const defaultStringifier = (0, fast_json_stringify_1.default)({
-    type: 'object',
-    additionalProperties: true,
-});
-/**
- * Fast JSON serializer using fast-json-stringify
- * For best performance, use schema-based stringifiers per route
- */
-function fastJsonStringify(value, schema) {
-    if (schema) {
-        const schemaKey = JSON.stringify(schema);
-        let stringifier = stringifierCache.get(schemaKey);
-        if (!stringifier) {
-            stringifier = (0, fast_json_stringify_1.default)(schema);
-            stringifierCache.set(schemaKey, stringifier);
-        }
-        return stringifier(value);
-    }
-    return defaultStringifier(value);
-}
-/**
- * Get a pre-compiled stringifier for a specific schema
- * Use this in route handlers for maximum performance
- */
-function getStringifier(schema) {
-    const schemaKey = JSON.stringify(schema);
-    let stringifier = stringifierCache.get(schemaKey);
-    if (!stringifier) {
-        stringifier = (0, fast_json_stringify_1.default)(schema);
-        stringifierCache.set(schemaKey, stringifier);
-    }
-    return stringifier;
-}

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

@@ -1,138 +0,0 @@
-import http, { IncomingMessage, ServerResponse, IncomingHttpHeaders } from 'http';
-import { URL } from 'url';
-import { WebSocketManager } from './websocket';
-import { Validator } from '../validation/types';
-import { OpenAPIOptions } from '../openapi/generator';
-import { HTTPMethod, QHTTPXContext, QHTTPXErrorHandler, QHTTPXHandler, QHTTPXMethodNotAllowedHandler, QHTTPXMiddleware, QHTTPXNotFoundHandler, QHTTPXOptions, QHTTPXRouteOptions, QHTTPXPlugin, QHTTPXPluginOptions, CookieOptions, QHTTPXFile } from './types';
-import { Logger } from './logger';
-export declare class QHTTPXContextImpl implements QHTTPXContext {
-    req: IncomingMessage;
-    res: ServerResponse;
-    headers: IncomingHttpHeaders;
-    method: HTTPMethod;
-    params: Record<string, string>;
-    query: Record<string, string | string[]>;
-    body: unknown;
-    files?: Record<string, QHTTPXFile | QHTTPXFile[]>;
-    cookies: Record<string, string>;
-    private _state;
-    requestId: string | undefined;
-    requestStart: number | undefined;
-    serializer?: (value: unknown) => string;
-    disableAutoEnd?: boolean;
-    path: string;
-    error?: Error;
-    next?: () => Promise<void>;
-    private _url;
-    private _ip;
-    private _app;
-    private _appJsonSerializer;
-    constructor(app: QHTTPX);
-    get bufferPool(): any;
-    get db(): any;
-    get state(): Record<string, unknown>;
-    set state(v: Record<string, unknown>);
-    get ip(): string;
-    set ip(v: string);
-    get url(): URL;
-    set url(v: URL);
-    json(payload: unknown, status?: number): void;
-    send(payload: string | Buffer, status?: number): void;
-    html(payload: string, status?: number): void;
-    redirect(url: string, status?: number): void;
-    setCookie(name: string, value: string, options: CookieOptions | undefined): void;
-    render(view: string, locals?: Record<string, unknown>): Promise<void>;
-    validate<T>(schema: unknown, data?: unknown): Promise<T>;
-    reset(): void;
-}
-export declare class QHTTPX {
-    private static readonly EMPTY_PARAMS;
-    private static readonly EMPTY_MATCH;
-    private readonly options;
-    private readonly server;
-    readonly logger: Logger;
-    private readonly router;
-    private readonly scheduler;
-    private readonly middlewares;
-    private readonly workerCount;
-    private readonly tasks;
-    private readonly metrics;
-    private readonly contextPool;
-    private readonly bufferPool;
-    private pipelineRunner;
-    private errorHandler?;
-    private notFoundHandler?;
-    private methodNotAllowedHandler?;
-    private readonly tracer?;
-    private readonly onStartHooks;
-    private readonly onBeforeShutdownHooks;
-    private readonly onShutdownHooks;
-    private nextRequestId;
-    private requestCounter;
-    private readonly wsManager;
-    private readonly ultraMode;
-    private readonly batchExecutor?;
-    private readonly fusion?;
-    readonly validator: Validator;
-    private readonly poolLimit;
-    constructor(options?: QHTTPXOptions);
-    get serverInstance(): http.Server;
-    get websocket(): WebSocketManager;
-    setErrorHandler(handler: QHTTPXErrorHandler): void;
-    setNotFoundHandler(handler: QHTTPXNotFoundHandler): void;
-    setMethodNotAllowedHandler(handler: QHTTPXMethodNotAllowedHandler): void;
-    set404Handler(handler: QHTTPXNotFoundHandler): void;
-    set405Handler(handler: QHTTPXMethodNotAllowedHandler): void;
-    /**
-     * Alias for setErrorHandler
-     */
-    onError(handler: QHTTPXErrorHandler): void;
-    /**
-     * Alias for setNotFoundHandler
-     */
-    notFound(handler: QHTTPXNotFoundHandler): void;
-    onStart(hook: () => void | Promise<void>): void;
-    onBeforeShutdown(hook: () => void | Promise<void>): void;
-    onShutdown(hook: () => void | Promise<void>): void;
-    upgrade(path: string, handler: import('./websocket').WSHandler): void;
-    use(middleware: QHTTPXMiddleware): void;
-    private compileMiddlewarePipeline;
-    private compileRoutePipeline;
-    _registerRoute(method: HTTPMethod, path: string, handlerOrOptions: QHTTPXHandler | QHTTPXRouteOptions): void;
-    register<Options extends QHTTPXPluginOptions>(plugin: QHTTPXPlugin<Options>, options?: Options): Promise<void>;
-    private registerRoute;
-    get(path: string, handler: QHTTPXHandler | QHTTPXRouteOptions): void;
-    get(path: string, config: import('./types').QHTTPXRouteConfig, handler: QHTTPXHandler): void;
-    post(path: string, handler: QHTTPXHandler | QHTTPXRouteOptions): void;
-    post(path: string, config: import('./types').QHTTPXRouteConfig, handler: QHTTPXHandler): void;
-    put(path: string, handler: QHTTPXHandler | QHTTPXRouteOptions): void;
-    put(path: string, config: import('./types').QHTTPXRouteConfig, handler: QHTTPXHandler): void;
-    delete(path: string, handler: QHTTPXHandler | QHTTPXRouteOptions): void;
-    delete(path: string, config: import('./types').QHTTPXRouteConfig, handler: QHTTPXHandler): void;
-    route(path: string): {
-        get(handler: QHTTPXHandler | QHTTPXRouteOptions): /*elided*/ any;
-        post(handler: QHTTPXHandler | QHTTPXRouteOptions): /*elided*/ any;
-        put(handler: QHTTPXHandler | QHTTPXRouteOptions): /*elided*/ any;
-        delete(handler: QHTTPXHandler | QHTTPXRouteOptions): /*elided*/ any;
-    };
-    task(name: string, handler: import('./types').QHTTPXTaskHandler, options?: import('./types').QHTTPXTaskOptions): void;
-    enqueue(name: string, payload: unknown): Promise<void>;
-    op(name: string, handler: import('./types').QHTTPXOpHandler): void;
-    private registerInternalRoutes;
-    getOpenAPI(options: OpenAPIOptions): object;
-    listen(port: number, hostnameOrCallback?: string | (() => void), callback?: () => void): Promise<{
-        port: number;
-    }>;
-    close(): Promise<void>;
-    shutdown(): Promise<void>;
-    private createContext;
-    private acquireContext;
-    private releaseContext;
-    private handleNoMatch;
-    handleRequest(req: IncomingMessage, res: ServerResponse): void;
-    private dispatch;
-    private handleUpgrade;
-    private runLifecycleHooks;
-    private handleError;
-    private generateRequestId;
-}