qhttpx 2.1.0 → 2.3.1

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

@@ -1,41 +0,0 @@
-import { QHTTPX } from './server';
-import { QHTTPXHandler, QHTTPXRouteOptions, QHTTPXRouteConfig, QHTTPXMiddleware, QHTTPXPlugin, QHTTPXPluginOptions, HttpError } 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): void;
-    get(path: string, options: QHTTPXRouteOptions): void;
-    get(path: string, handler: QHTTPXHandler, options: QHTTPXRouteConfig): void;
-    post(path: string, handler: QHTTPXHandler): void;
-    post(path: string, options: QHTTPXRouteOptions): void;
-    post(path: string, handler: QHTTPXHandler, options: QHTTPXRouteConfig): void;
-    put(path: string, handler: QHTTPXHandler): void;
-    put(path: string, options: QHTTPXRouteOptions): void;
-    put(path: string, handler: QHTTPXHandler, options: QHTTPXRouteConfig): void;
-    delete(path: string, handler: QHTTPXHandler): void;
-    delete(path: string, options: QHTTPXRouteOptions): void;
-    delete(path: string, handler: QHTTPXHandler, options: QHTTPXRouteConfig): void;
-    patch(path: string, handler: QHTTPXHandler): void;
-    patch(path: string, options: QHTTPXRouteOptions): void;
-    patch(path: string, handler: QHTTPXHandler, options: QHTTPXRouteConfig): void;
-    options(path: string, handler: QHTTPXHandler): void;
-    options(path: string, options: QHTTPXRouteOptions): void;
-    options(path: string, handler: QHTTPXHandler, options: QHTTPXRouteConfig): void;
-    head(path: string, handler: QHTTPXHandler): void;
-    head(path: string, options: QHTTPXRouteOptions): void;
-    head(path: string, handler: QHTTPXHandler, options: QHTTPXRouteConfig): void;
-    httpError(status: number, message?: string, details?: unknown): HttpError;
-    getApp(): QHTTPX;
-    private joinPaths;
-}

package/dist/src/core/scope.js

@@ -1,107 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.QHTTPXScope = void 0;
-const types_1 = require("./types");
-/**
- * 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, arg1, arg2) {
-        if (typeof arg1 === 'function' && arg2) {
-            this.app._registerRoute('GET', this.joinPaths(this.prefix, path), arg2, arg1);
-        }
-        else {
-            this.app._registerRoute('GET', this.joinPaths(this.prefix, path), arg1);
-        }
-    }
-    post(path, arg1, arg2) {
-        if (typeof arg1 === 'function' && arg2) {
-            this.app._registerRoute('POST', this.joinPaths(this.prefix, path), arg2, arg1);
-        }
-        else {
-            this.app._registerRoute('POST', this.joinPaths(this.prefix, path), arg1);
-        }
-    }
-    put(path, arg1, arg2) {
-        if (typeof arg1 === 'function' && arg2) {
-            this.app._registerRoute('PUT', this.joinPaths(this.prefix, path), arg2, arg1);
-        }
-        else {
-            this.app._registerRoute('PUT', this.joinPaths(this.prefix, path), arg1);
-        }
-    }
-    delete(path, arg1, arg2) {
-        if (typeof arg1 === 'function' && arg2) {
-            this.app._registerRoute('DELETE', this.joinPaths(this.prefix, path), arg2, arg1);
-        }
-        else {
-            this.app._registerRoute('DELETE', this.joinPaths(this.prefix, path), arg1);
-        }
-    }
-    patch(path, arg1, arg2) {
-        if (typeof arg1 === 'function' && arg2) {
-            this.app._registerRoute('PATCH', this.joinPaths(this.prefix, path), arg2, arg1);
-        }
-        else {
-            this.app._registerRoute('PATCH', this.joinPaths(this.prefix, path), arg1);
-        }
-    }
-    options(path, arg1, arg2) {
-        if (typeof arg1 === 'function' && arg2) {
-            this.app._registerRoute('OPTIONS', this.joinPaths(this.prefix, path), arg2, arg1);
-        }
-        else {
-            this.app._registerRoute('OPTIONS', this.joinPaths(this.prefix, path), arg1);
-        }
-    }
-    head(path, arg1, arg2) {
-        if (typeof arg1 === 'function' && arg2) {
-            this.app._registerRoute('HEAD', this.joinPaths(this.prefix, path), arg2, arg1);
-        }
-        else {
-            this.app._registerRoute('HEAD', this.joinPaths(this.prefix, path), arg1);
-        }
-    }
-    httpError(status, message, details) {
-        return new types_1.HttpError(status, message, { details });
-    }
-    // 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 with optimization for simple objects
- * 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,82 +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();
-function isSimpleObject(obj) {
-    if (typeof obj !== 'object' || obj === null || Array.isArray(obj))
-        return false;
-    const keys = Object.keys(obj);
-    if (keys.length > 20)
-        return false; // Threshold for "simple"
-    for (let i = 0; i < keys.length; i++) {
-        const val = obj[keys[i]];
-        const type = typeof val;
-        if (type !== 'string' && type !== 'number' && type !== 'boolean' && val !== null) {
-            return false;
-        }
-    }
-    return true;
-}
-function stringifySimple(obj) {
-    // Manual stringification for simple objects (faster than JSON.stringify)
-    const keys = Object.keys(obj);
-    const parts = new Array(keys.length);
-    for (let i = 0; i < keys.length; i++) {
-        const key = keys[i];
-        const val = obj[key];
-        const valStr = typeof val === 'string' ? `"${val}"` : val;
-        parts[i] = `"${key}":${valStr}`;
-    }
-    return `{${parts.join(',')}}`;
-}
-/**
- * Fast JSON serializer using fast-json-stringify with optimization for simple objects
- * For best performance, use schema-based stringifiers per route
- */
-function fastJsonStringify(value, schema) {
-    // Fast path for primitives
-    if (value === null || value === undefined) {
-        return 'null';
-    }
-    if (typeof value === 'string') {
-        return JSON.stringify(value);
-    }
-    if (typeof value === 'number' || typeof value === 'boolean') {
-        return String(value);
-    }
-    // Fast path for simple objects (no nesting, all string values)
-    if (isSimpleObject(value)) {
-        return stringifySimple(value);
-    }
-    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);
-    }
-    // Fallback to native JSON.stringify for schema-less complex objects
-    // It is often faster than generic fast-json-stringify
-    return JSON.stringify(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,179 +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, HttpError, 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;
-    private _params;
-    get params(): Record<string, string>;
-    set params(v: Record<string, string>);
-    private _body;
-    get body(): unknown;
-    set body(v: unknown);
-    private _files?;
-    get files(): Record<string, QHTTPXFile | QHTTPXFile[]> | undefined;
-    set files(v: Record<string, QHTTPXFile | QHTTPXFile[]> | undefined);
-    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;
-    private _cookies;
-    private _query;
-    _generation: number;
-    _dirty: number;
-    private _customHeaders;
-    httpError(status: number, message?: string, details?: unknown): HttpError;
-    constructor(app: QHTTPX);
-    get cookies(): Record<string, string>;
-    set cookies(v: Record<string, string>);
-    get query(): Record<string, string | string[]>;
-    set query(v: Record<string, string | string[]>);
-    private _parseQuery;
-    private _parseCookies;
-    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 _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 lastDateNow;
-    private lastDateString;
-    private requestCounter;
-    private readonly wsManager;
-    private readonly batchExecutor?;
-    private _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 | import('./types').QHTTPXRouteConfig, handlerIfOptions?: QHTTPXHandler): void;
-    register<Options extends QHTTPXPluginOptions>(plugin: QHTTPXPlugin<Options>, options?: Options): Promise<void>;
-    private registerRoute;
-    get(path: string, handler: QHTTPXHandler | QHTTPXRouteOptions): void;
-    get(path: string, handler: QHTTPXHandler, config: import('./types').QHTTPXRouteConfig): void;
-    get(path: string, config: import('./types').QHTTPXRouteConfig, handler: QHTTPXHandler): void;
-    post(path: string, handler: QHTTPXHandler | QHTTPXRouteOptions): void;
-    post(path: string, handler: QHTTPXHandler, config: import('./types').QHTTPXRouteConfig): void;
-    post(path: string, config: import('./types').QHTTPXRouteConfig, handler: QHTTPXHandler): void;
-    put(path: string, handler: QHTTPXHandler | QHTTPXRouteOptions): void;
-    put(path: string, handler: QHTTPXHandler, config: import('./types').QHTTPXRouteConfig): void;
-    put(path: string, config: import('./types').QHTTPXRouteConfig, handler: QHTTPXHandler): void;
-    delete(path: string, handler: QHTTPXHandler | QHTTPXRouteOptions): void;
-    delete(path: string, handler: QHTTPXHandler, config: import('./types').QHTTPXRouteConfig): void;
-    delete(path: string, config: import('./types').QHTTPXRouteConfig, handler: QHTTPXHandler): void;
-    patch(path: string, handler: QHTTPXHandler | QHTTPXRouteOptions): void;
-    patch(path: string, handler: QHTTPXHandler, config: import('./types').QHTTPXRouteConfig): void;
-    patch(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;
-    database(manager: import('../database/manager').DatabaseManager): this;
-    security(options?: import('./types').SecureDefaultsOptions): this;
-    log(options?: import('./types').LoggerOptions | boolean): this;
-    validate(validator?: Validator): this;
-    production(): this;
-    routes(prefix: string, plugin: QHTTPXPlugin): this;
-    rateLimit(option: import('./types').RateLimitPreset | number, interval?: string): this;
-    allow(count: number): {
-        per: (interval: string) => QHTTPX;
-    };
-    fusion(enable?: boolean | import('./types').RequestFusionOptions): this;
-    bodyLimit(bytes: number): this;
-    metrics(enable?: boolean): this;
-    error(status: number, message: string, details?: unknown): HttpError;
-    start(port: number): Promise<{
-        port: number;
-    }>;
-    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;
-}