qhttpx 1.8.12 → 1.9.1

package/dist/src/core/batch.js

@@ -1,97 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BatchExecutor = void 0;
-const coalescer_1 = require("../database/coalescer");
-class BatchExecutor {
-    constructor(dbManager) {
-        this.ops = new Map();
-        this.coalescers = new Map();
-        this.dbManager = dbManager;
-    }
-    register(name, handler) {
-        this.ops.set(name, handler);
-    }
-    async handleBatch(ctx, batch) {
-        if (!Array.isArray(batch)) {
-            throw new Error('Batch must be an array');
-        }
-        // If we have a DB manager, we want to intercept queries for fusion
-        // We create a proxy for the DB manager attached to the context
-        let batchCtx = ctx;
-        if (this.dbManager && ctx.db) {
-            // Create a localized context that intercepts DB calls
-            // We need to ensure that when `ctx.db.get()` is called, it returns a wrapped adapter
-            // But `ctx.db` is the manager itself.
-            // We can't easily wrap the manager instance shared across requests.
-            // Instead, we can wrap the `ctx.db` property for this request scope.
-            const originalDb = ctx.db;
-            // Create a proxy for the database manager
-            const dbProxy = new Proxy(originalDb, {
-                get: (target, prop, receiver) => {
-                    if (prop === 'get' || prop === 'connect') {
-                        return (name) => {
-                            const adapter = target.get(name);
-                            // Check if we have a coalescer for this connection
-                            const connName = name || 'default'; // Simplify for now
-                            let coalescer = this.coalescers.get(connName);
-                            // In a real per-request batch scope, we should create a new Coalescer 
-                            // OR reset the existing one?
-                            // Actually, the Coalescer uses a short timeout (next tick). 
-                            // So it is safe to share across concurrent requests IF we want global batching.
-                            // BUT "auto transaction scope" implies per-request isolation.
-                            // For "Query Fusion", global batching is even better (cross-request fusion).
-                            // However, for this task, let's stick to per-request or global safely.
-                            // Since Coalescer flushes on next tick, sharing it is fine and efficient.
-                            if (!coalescer) {
-                                coalescer = new coalescer_1.QueryCoalescer(adapter);
-                                this.coalescers.set(connName, coalescer);
-                            }
-                            // Return a proxy to the adapter that uses the coalescer
-                            return {
-                                ...adapter,
-                                query: (query, params) => coalescer.query(query, params),
-                                isConnected: () => adapter.isConnected(),
-                                connect: () => adapter.connect(),
-                                disconnect: () => adapter.disconnect()
-                            };
-                        };
-                    }
-                    return Reflect.get(target, prop, receiver);
-                }
-            });
-            // Create a new context object that inherits from original but overrides db
-            // We use Object.create to prototype inherit, but ctx is a flat object in QHTTPX.
-            // We must shallow copy.
-            batchCtx = { ...ctx, db: dbProxy };
-        }
-        // Helper for internal calls
-        // "ctx.call" implementation
-        // The user wants: `ctx.call("getUser", { id: 5 })`
-        // We attach this to the context
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        batchCtx.call = async (op, params) => {
-            const handler = this.ops.get(op);
-            if (!handler) {
-                throw new Error(`Unknown operation: ${op}`);
-            }
-            return handler(params, batchCtx);
-        };
-        // Execute all ops
-        // We can run them in parallel since we want to fuse queries
-        const results = await Promise.all(batch.map(async (item) => {
-            try {
-                const handler = this.ops.get(item.op);
-                if (!handler) {
-                    return { error: `Unknown operation: ${item.op}`, id: item.id };
-                }
-                const result = await handler(item.params, batchCtx);
-                return { result, id: item.id };
-            }
-            catch (err) {
-                return { error: (err instanceof Error ? err.message : String(err)), id: item.id };
-            }
-        }));
-        return { results };
-    }
-}
-exports.BatchExecutor = BatchExecutor;

package/dist/src/core/body-parser.d.ts

@@ -1,15 +0,0 @@
-import { IncomingMessage } from 'http';
-export type BodyParserOptions = {
-    maxBodyBytes?: number;
-};
-export type ParsedBody = {
-    body: unknown;
-    files?: Record<string, unknown>;
-};
-export interface IBodyParser {
-    parse(req: IncomingMessage, options?: BodyParserOptions): Promise<any>;
-}
-export declare class BodyParser {
-    static parse(req: IncomingMessage, options?: BodyParserOptions): Promise<any>;
-    private static parseMultipart;
-}

package/dist/src/core/body-parser.js

@@ -1,121 +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.BodyParser = void 0;
-const querystring_1 = require("querystring");
-const busboy_1 = __importDefault(require("busboy"));
-class BodyParser {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    static async parse(req, options = {}) {
-        const method = (req.method || 'GET').toUpperCase();
-        if (method === 'GET' || method === 'HEAD') {
-            return { body: undefined };
-        }
-        const contentType = req.headers['content-type'] || '';
-        if (contentType.includes('multipart/form-data')) {
-            return this.parseMultipart(req, options);
-        }
-        const chunks = [];
-        let totalBytes = 0;
-        const maxBodyBytes = options.maxBodyBytes;
-        for await (const chunk of req) {
-            const bufferChunk = typeof chunk === 'string' ? Buffer.from(chunk) : chunk;
-            chunks.push(bufferChunk);
-            totalBytes += bufferChunk.length;
-            if (maxBodyBytes !== undefined && totalBytes > maxBodyBytes) {
-                throw new Error('QHTTPX_BODY_TOO_LARGE');
-            }
-        }
-        if (chunks.length === 0) {
-            return { body: undefined };
-        }
-        const buffer = Buffer.concat(chunks);
-        if (typeof contentType === 'string' &&
-            contentType.includes('application/json')) {
-            const text = buffer.toString('utf8');
-            try {
-                return { body: JSON.parse(text) };
-            }
-            catch {
-                throw new Error('QHTTPX_INVALID_JSON');
-            }
-        }
-        if (typeof contentType === 'string' &&
-            contentType.includes('application/x-www-form-urlencoded')) {
-            const text = buffer.toString('utf8');
-            return { body: (0, querystring_1.parse)(text) };
-        }
-        return { body: buffer };
-    }
-    static parseMultipart(req, options) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        return new Promise((resolve, reject) => {
-            let bb;
-            try {
-                bb = (0, busboy_1.default)({ headers: req.headers, limits: { fileSize: options.maxBodyBytes } });
-            }
-            catch (err) {
-                return reject(err);
-            }
-            const body = {};
-            const files = {};
-            bb.on('field', (name, val) => {
-                if (Object.prototype.hasOwnProperty.call(body, name)) {
-                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                    if (Array.isArray(body[name])) {
-                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                        body[name].push(val);
-                    }
-                    else {
-                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                        body[name] = [body[name], val];
-                    }
-                }
-                else {
-                    body[name] = val;
-                }
-            });
-            bb.on('file', (name, file, info) => {
-                const { filename, encoding, mimeType } = info;
-                const chunks = [];
-                file.on('data', (chunk) => {
-                    chunks.push(chunk);
-                });
-                file.on('end', () => {
-                    const buffer = Buffer.concat(chunks);
-                    const fileData = {
-                        filename,
-                        encoding,
-                        mimeType,
-                        data: buffer,
-                        size: buffer.length,
-                    };
-                    if (Object.prototype.hasOwnProperty.call(files, name)) {
-                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                        if (Array.isArray(files[name])) {
-                            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                            files[name].push(fileData);
-                        }
-                        else {
-                            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                            files[name] = [files[name], fileData];
-                        }
-                    }
-                    else {
-                        files[name] = fileData;
-                    }
-                });
-            });
-            bb.on('close', () => {
-                resolve({ body, files });
-            });
-            bb.on('error', (err) => {
-                reject(err);
-            });
-            req.pipe(bb);
-        });
-    }
-}
-exports.BodyParser = BodyParser;

package/dist/src/core/buffer-pool.d.ts

@@ -1,41 +0,0 @@
-/**
- * Buffer pool for response bodies (small, medium, large).
- * Reuses allocated buffers to reduce GC pressure.
- */
-export type BufferPoolConfig = {
-    smallSize?: number;
-    mediumSize?: number;
-    largeSize?: number;
-    smallPoolSize?: number;
-    mediumPoolSize?: number;
-    largePoolSize?: number;
-};
-export declare class BufferPool {
-    private readonly smallSize;
-    private readonly mediumSize;
-    private readonly largeSize;
-    private readonly smallBuffers;
-    private readonly mediumBuffers;
-    private readonly largeBuffers;
-    private readonly smallPoolSize;
-    private readonly mediumPoolSize;
-    private readonly largePoolSize;
-    constructor(config?: BufferPoolConfig);
-    /**
-     * Acquire a buffer suitable for the given size.
-     * Returns a buffer from the appropriate pool.
-     */
-    acquire(size: number): Buffer;
-    /**
-     * Release a buffer back to the appropriate pool.
-     */
-    release(buffer: Buffer): void;
-    /**
-     * Get the number of available buffers in each pool.
-     */
-    getPoolStatus(): {
-        small: number;
-        medium: number;
-        large: number;
-    };
-}

package/dist/src/core/buffer-pool.js

@@ -1,70 +0,0 @@
-"use strict";
-/**
- * Buffer pool for response bodies (small, medium, large).
- * Reuses allocated buffers to reduce GC pressure.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BufferPool = void 0;
-class BufferPool {
-    constructor(config = {}) {
-        this.smallBuffers = [];
-        this.mediumBuffers = [];
-        this.largeBuffers = [];
-        this.smallSize = config.smallSize ?? 4096; // 4KB
-        this.mediumSize = config.mediumSize ?? 65536; // 64KB
-        this.largeSize = config.largeSize ?? 262144; // 256KB
-        this.smallPoolSize = config.smallPoolSize ?? 32;
-        this.mediumPoolSize = config.mediumPoolSize ?? 8;
-        this.largePoolSize = config.largePoolSize ?? 2;
-        // Preallocate buffers
-        for (let i = 0; i < this.smallPoolSize; i += 1) {
-            this.smallBuffers.push(Buffer.allocUnsafe(this.smallSize));
-        }
-        for (let i = 0; i < this.mediumPoolSize; i += 1) {
-            this.mediumBuffers.push(Buffer.allocUnsafe(this.mediumSize));
-        }
-        for (let i = 0; i < this.largePoolSize; i += 1) {
-            this.largeBuffers.push(Buffer.allocUnsafe(this.largeSize));
-        }
-    }
-    /**
-     * Acquire a buffer suitable for the given size.
-     * Returns a buffer from the appropriate pool.
-     */
-    acquire(size) {
-        if (size <= this.smallSize) {
-            return this.smallBuffers.pop() || Buffer.allocUnsafe(this.smallSize);
-        }
-        if (size <= this.mediumSize) {
-            return this.mediumBuffers.pop() || Buffer.allocUnsafe(this.mediumSize);
-        }
-        return this.largeBuffers.pop() || Buffer.allocUnsafe(this.largeSize);
-    }
-    /**
-     * Release a buffer back to the appropriate pool.
-     */
-    release(buffer) {
-        if (buffer.length === this.smallSize && this.smallBuffers.length < this.smallPoolSize) {
-            this.smallBuffers.push(buffer);
-        }
-        else if (buffer.length === this.mediumSize &&
-            this.mediumBuffers.length < this.mediumPoolSize) {
-            this.mediumBuffers.push(buffer);
-        }
-        else if (buffer.length === this.largeSize &&
-            this.largeBuffers.length < this.largePoolSize) {
-            this.largeBuffers.push(buffer);
-        }
-    }
-    /**
-     * Get the number of available buffers in each pool.
-     */
-    getPoolStatus() {
-        return {
-            small: this.smallBuffers.length,
-            medium: this.mediumBuffers.length,
-            large: this.largeBuffers.length,
-        };
-    }
-}
-exports.BufferPool = BufferPool;

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

@@ -1,7 +0,0 @@
-import type { QHTTPXOptions } from './types';
-export type LoadConfigOptions = {
-    env?: NodeJS.ProcessEnv;
-    defaults?: QHTTPXOptions;
-    prefix?: string;
-};
-export declare function loadConfig(options?: LoadConfigOptions): QHTTPXOptions;

package/dist/src/core/config.js

@@ -1,50 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadConfig = loadConfig;
-function loadConfig(options = {}) {
-    const env = options.env ?? process.env;
-    const defaults = options.defaults ?? {};
-    const prefix = options.prefix ?? 'QHTTPX_';
-    const getNumber = (key) => {
-        const value = env[prefix + key];
-        if (!value) {
-            return undefined;
-        }
-        const n = Number(value);
-        if (!Number.isFinite(n) || n <= 0) {
-            return undefined;
-        }
-        return n;
-    };
-    const getBoolean = (key) => {
-        const value = env[prefix + key];
-        if (!value) {
-            return undefined;
-        }
-        const lower = value.toLowerCase();
-        if (lower === 'true' || lower === '1') {
-            return true;
-        }
-        if (lower === 'false' || lower === '0') {
-            return false;
-        }
-        return undefined;
-    };
-    const maxConcurrency = getNumber('MAX_CONCURRENCY');
-    const requestTimeoutMs = getNumber('REQUEST_TIMEOUT_MS');
-    const maxMemoryBytes = getNumber('MAX_MEMORY_BYTES');
-    const maxBodyBytes = getNumber('MAX_BODY_BYTES');
-    const keepAliveTimeoutMs = getNumber('KEEP_ALIVE_TIMEOUT_MS');
-    const headersTimeoutMs = getNumber('HEADERS_TIMEOUT_MS');
-    const metricsEnabled = getBoolean('METRICS_ENABLED');
-    return {
-        ...defaults,
-        maxConcurrency: maxConcurrency ?? defaults.maxConcurrency,
-        requestTimeoutMs: requestTimeoutMs ?? defaults.requestTimeoutMs,
-        maxMemoryBytes: maxMemoryBytes ?? defaults.maxMemoryBytes,
-        maxBodyBytes: maxBodyBytes ?? defaults.maxBodyBytes,
-        keepAliveTimeoutMs: keepAliveTimeoutMs ?? defaults.keepAliveTimeoutMs,
-        headersTimeoutMs: headersTimeoutMs ?? defaults.headersTimeoutMs,
-        metricsEnabled: metricsEnabled ?? defaults.metricsEnabled,
-    };
-}

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

@@ -1,34 +0,0 @@
-import { HttpError } from './types';
-export declare class BadRequestException extends HttpError {
-    constructor(message?: string, details?: unknown);
-}
-export declare class UnauthorizedException extends HttpError {
-    constructor(message?: string, details?: unknown);
-}
-export declare class ForbiddenException extends HttpError {
-    constructor(message?: string, details?: unknown);
-}
-export declare class NotFoundException extends HttpError {
-    constructor(message?: string, details?: unknown);
-}
-export declare class MethodNotAllowedException extends HttpError {
-    constructor(message?: string, details?: unknown);
-}
-export declare class ConflictException extends HttpError {
-    constructor(message?: string, details?: unknown);
-}
-export declare class PayloadTooLargeException extends HttpError {
-    constructor(message?: string, details?: unknown);
-}
-export declare class UnsupportedMediaTypeException extends HttpError {
-    constructor(message?: string, details?: unknown);
-}
-export declare class TooManyRequestsException extends HttpError {
-    constructor(message?: string, details?: unknown);
-}
-export declare class InternalServerErrorException extends HttpError {
-    constructor(message?: string, details?: unknown);
-}
-export declare class ServiceUnavailableException extends HttpError {
-    constructor(message?: string, details?: unknown);
-}

package/dist/src/core/errors.js

@@ -1,70 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ServiceUnavailableException = exports.InternalServerErrorException = exports.TooManyRequestsException = exports.UnsupportedMediaTypeException = exports.PayloadTooLargeException = exports.ConflictException = exports.MethodNotAllowedException = exports.NotFoundException = exports.ForbiddenException = exports.UnauthorizedException = exports.BadRequestException = void 0;
-const types_1 = require("./types");
-class BadRequestException extends types_1.HttpError {
-    constructor(message = 'Bad Request', details) {
-        super(400, message, { code: 'BAD_REQUEST', details });
-    }
-}
-exports.BadRequestException = BadRequestException;
-class UnauthorizedException extends types_1.HttpError {
-    constructor(message = 'Unauthorized', details) {
-        super(401, message, { code: 'UNAUTHORIZED', details });
-    }
-}
-exports.UnauthorizedException = UnauthorizedException;
-class ForbiddenException extends types_1.HttpError {
-    constructor(message = 'Forbidden', details) {
-        super(403, message, { code: 'FORBIDDEN', details });
-    }
-}
-exports.ForbiddenException = ForbiddenException;
-class NotFoundException extends types_1.HttpError {
-    constructor(message = 'Not Found', details) {
-        super(404, message, { code: 'NOT_FOUND', details });
-    }
-}
-exports.NotFoundException = NotFoundException;
-class MethodNotAllowedException extends types_1.HttpError {
-    constructor(message = 'Method Not Allowed', details) {
-        super(405, message, { code: 'METHOD_NOT_ALLOWED', details });
-    }
-}
-exports.MethodNotAllowedException = MethodNotAllowedException;
-class ConflictException extends types_1.HttpError {
-    constructor(message = 'Conflict', details) {
-        super(409, message, { code: 'CONFLICT', details });
-    }
-}
-exports.ConflictException = ConflictException;
-class PayloadTooLargeException extends types_1.HttpError {
-    constructor(message = 'Payload Too Large', details) {
-        super(413, message, { code: 'PAYLOAD_TOO_LARGE', details });
-    }
-}
-exports.PayloadTooLargeException = PayloadTooLargeException;
-class UnsupportedMediaTypeException extends types_1.HttpError {
-    constructor(message = 'Unsupported Media Type', details) {
-        super(415, message, { code: 'UNSUPPORTED_MEDIA_TYPE', details });
-    }
-}
-exports.UnsupportedMediaTypeException = UnsupportedMediaTypeException;
-class TooManyRequestsException extends types_1.HttpError {
-    constructor(message = 'Too Many Requests', details) {
-        super(429, message, { code: 'TOO_MANY_REQUESTS', details });
-    }
-}
-exports.TooManyRequestsException = TooManyRequestsException;
-class InternalServerErrorException extends types_1.HttpError {
-    constructor(message = 'Internal Server Error', details) {
-        super(500, message, { code: 'INTERNAL_SERVER_ERROR', details });
-    }
-}
-exports.InternalServerErrorException = InternalServerErrorException;
-class ServiceUnavailableException extends types_1.HttpError {
-    constructor(message = 'Service Unavailable', details) {
-        super(503, message, { code: 'SERVICE_UNAVAILABLE', details });
-    }
-}
-exports.ServiceUnavailableException = ServiceUnavailableException;

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

@@ -1,14 +0,0 @@
-import type { QHTTPXContext } from './types';
-export interface RequestFusionOptions {
-    windowMs?: number;
-    vary?: string[];
-}
-export declare class RequestFusion {
-    private inflight;
-    private cache;
-    private options;
-    constructor(options?: boolean | RequestFusionOptions);
-    coalesce(ctx: QHTTPXContext, next: (ctx: QHTTPXContext) => Promise<void> | void): Promise<void>;
-    private applyResult;
-    private getKey;
-}