qhttpx 2.1.0 → 2.3.1

package/dist/tests/tasks.test.d.ts

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

package/dist/tests/tasks.test.js

@@ -1,62 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const vitest_1 = require("vitest");
-const index_1 = require("../src/index");
-(0, vitest_1.describe)('Task engine', () => {
-    (0, vitest_1.it)('registers and executes a task', async () => {
-        const app = new index_1.QHTTPX();
-        const seen = [];
-        app.task('echo', async (payload) => {
-            seen.push(payload);
-        });
-        await app.enqueue('echo', { hello: 'world' });
-        (0, vitest_1.expect)(seen).toHaveLength(1);
-        (0, vitest_1.expect)(seen[0]).toEqual({ hello: 'world' });
-    });
-    (0, vitest_1.it)('retries failing tasks according to maxRetries', async () => {
-        const app = new index_1.QHTTPX();
-        const spy = vitest_1.vi.fn();
-        let attempts = 0;
-        app.task('sometimes-fails', () => {
-            spy();
-            attempts += 1;
-            if (attempts < 3) {
-                throw new Error('fail');
-            }
-        }, { maxRetries: 5 });
-        await app.enqueue('sometimes-fails', null);
-        (0, vitest_1.expect)(spy).toHaveBeenCalledTimes(3);
-    });
-    (0, vitest_1.it)('propagates errors after exceeding retries', async () => {
-        const app = new index_1.QHTTPX();
-        app.task('always-fails', () => {
-            throw new Error('boom');
-        }, { maxRetries: 1 });
-        await (0, vitest_1.expect)(app.enqueue('always-fails', null)).rejects.toThrow('boom');
-    });
-    (0, vitest_1.it)('integrates with HTTP route that enqueues a job', async () => {
-        const app = new index_1.QHTTPX();
-        const seen = [];
-        app.task('job', async (payload) => {
-            seen.push(payload);
-        });
-        app.post('/enqueue', async (ctx) => {
-            const body = ctx.body;
-            await app.enqueue('job', body.value);
-            ctx.json({ ok: true });
-        });
-        const { port } = await app.listen(0, '127.0.0.1');
-        const response = await fetch(`http://127.0.0.1:${port}/enqueue`, {
-            method: 'POST',
-            headers: {
-                'content-type': 'application/json',
-            },
-            body: JSON.stringify({ value: 'hello' }),
-        });
-        (0, vitest_1.expect)(response.status).toBe(200);
-        const json = (await response.json());
-        (0, vitest_1.expect)(json.ok).toBe(true);
-        (0, vitest_1.expect)(seen).toEqual(['hello']);
-        await app.close();
-    });
-});

package/dist/tests/testing.test.d.ts

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

package/dist/tests/testing.test.js

@@ -1,47 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const vitest_1 = require("vitest");
-const src_1 = require("../src");
-(0, vitest_1.describe)('Testing utilities', () => {
-    (0, vitest_1.it)('creates a test client and handles requests', async () => {
-        const app = new src_1.QHTTPX();
-        app.get('/hello', (ctx) => {
-            ctx.json({ message: 'world' });
-        });
-        app.post('/echo', (ctx) => {
-            ctx.json(ctx.body);
-        });
-        const client = (0, src_1.createTestClient)(app);
-        try {
-            const res1 = await client.get('/hello');
-            (0, vitest_1.expect)(res1.status).toBe(200);
-            (0, vitest_1.expect)(await res1.json()).toEqual({ message: 'world' });
-            const res2 = await client.post('/echo', { foo: 'bar' });
-            (0, vitest_1.expect)(res2.status).toBe(200);
-            (0, vitest_1.expect)(await res2.json()).toEqual({ foo: 'bar' });
-        }
-        finally {
-            await client.stop();
-        }
-    });
-    (0, vitest_1.it)('handles custom headers and raw body', async () => {
-        const app = new src_1.QHTTPX();
-        app.post('/raw', (ctx) => {
-            ctx.send(ctx.req.headers['x-custom']);
-        });
-        const client = (0, src_1.createTestClient)(app);
-        try {
-            const res = await client.post('/raw', 'raw-body', {
-                headers: {
-                    'x-custom': 'custom-value',
-                    'content-type': 'text/plain',
-                },
-            });
-            (0, vitest_1.expect)(res.status).toBe(200);
-            (0, vitest_1.expect)(await res.text()).toBe('custom-value');
-        }
-        finally {
-            await client.stop();
-        }
-    });
-});

package/dist/tests/validation.test.d.ts

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

package/dist/tests/validation.test.js

@@ -1,107 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const vitest_1 = require("vitest");
-const server_1 = require("../src/core/server");
-(0, vitest_1.describe)('Validation System', () => {
-    let app;
-    (0, vitest_1.afterEach)(async () => {
-        if (app)
-            await app.close();
-    });
-    (0, vitest_1.it)('should validate request body and return 400 on failure', async () => {
-        app = new server_1.QHTTPX();
-        const schema = {
-            body: {
-                type: 'object',
-                properties: {
-                    name: { type: 'string', min: 3 },
-                    age: { type: 'number', min: 18 }
-                }
-            }
-        };
-        app.post('/user', {
-            schema,
-            handler: (ctx) => {
-                ctx.json({ status: 'ok', body: ctx.body });
-            }
-        });
-        const { port } = await app.listen(0);
-        // Invalid request (age too low)
-        const res1 = await fetch(`http://localhost:${port}/user`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ name: 'Alice', age: 10 })
-        });
-        (0, vitest_1.expect)(res1.status).toBe(400);
-        const data1 = await res1.json();
-        (0, vitest_1.expect)(data1.error).toBe('Validation Error');
-        (0, vitest_1.expect)(data1.details).toContain('age');
-        // Valid request
-        const res2 = await fetch(`http://localhost:${port}/user`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ name: 'Alice', age: 20 })
-        });
-        (0, vitest_1.expect)(res2.status).toBe(200);
-        const data2 = await res2.json();
-        (0, vitest_1.expect)(data2.body).toEqual({ name: 'Alice', age: 20 });
-    });
-    (0, vitest_1.it)('should validate and coerce query parameters', async () => {
-        app = new server_1.QHTTPX();
-        const schema = {
-            query: {
-                type: 'object',
-                properties: {
-                    page: { type: 'number', min: 1 },
-                    sort: { type: 'string', enum: ['asc', 'desc'] }
-                }
-            }
-        };
-        app.get('/items', {
-            schema,
-            handler: (ctx) => {
-                // ctx.query should have numbers now
-                ctx.json({
-                    page: ctx.query.page,
-                    pageType: typeof ctx.query.page,
-                    sort: ctx.query.sort
-                });
-            }
-        });
-        const { port } = await app.listen(0);
-        // Valid query
-        const res1 = await fetch(`http://localhost:${port}/items?page=5&sort=desc`);
-        (0, vitest_1.expect)(res1.status).toBe(200);
-        const data1 = await res1.json();
-        (0, vitest_1.expect)(data1.page).toBe(5);
-        (0, vitest_1.expect)(data1.pageType).toBe('number'); // Coercion worked
-        (0, vitest_1.expect)(data1.sort).toBe('desc');
-        // Invalid query
-        const res2 = await fetch(`http://localhost:${port}/items?page=0&sort=foo`);
-        (0, vitest_1.expect)(res2.status).toBe(400);
-    });
-    (0, vitest_1.it)('should support legacy response schema (no validation)', async () => {
-        app = new server_1.QHTTPX();
-        // Legacy schema: just a JSON schema at root
-        const schema = {
-            type: 'object',
-            properties: {
-                hello: { type: 'string' }
-            }
-        };
-        app.get('/legacy', {
-            schema,
-            handler: (ctx) => {
-                // If validation ran, it might fail because ctx.body is undefined or not matching
-                // But here we check if it IGNORES validation and uses it for serialization
-                ctx.json({ hello: 'world', extra: 'hidden' });
-            }
-        });
-        const { port } = await app.listen(0);
-        const res = await fetch(`http://localhost:${port}/legacy`);
-        (0, vitest_1.expect)(res.status).toBe(200);
-        const data = await res.json();
-        (0, vitest_1.expect)(data.hello).toBe('world');
-        (0, vitest_1.expect)(data.extra).toBeUndefined(); // fast-json-stringify filters extra fields
-    });
-});

package/dist/tests/websocket.test.d.ts

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

package/dist/tests/websocket.test.js

@@ -1,146 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-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 net = __importStar(require("net"));
-const ws_1 = __importDefault(require("ws"));
-const src_1 = require("../src");
-(0, vitest_1.describe)('WebSocket upgrade', () => {
-    (0, vitest_1.it)('handles websocket upgrade for registered path', async () => {
-        const app = new src_1.QHTTPX();
-        let upgraded = false;
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        app.upgrade('/ws', (ws, req) => {
-            upgraded = true;
-            ws.close();
-        });
-        const { port } = await app.listen(0, '127.0.0.1');
-        const ws = new ws_1.default(`ws://127.0.0.1:${port}/ws`);
-        await new Promise((resolve, reject) => {
-            ws.on('open', () => {
-                resolve();
-            });
-            ws.on('error', (err) => {
-                reject(err);
-            });
-        });
-        (0, vitest_1.expect)(upgraded).toBe(true);
-        ws.close();
-        await app.close();
-    });
-    (0, vitest_1.it)('destroys socket when no upgrade handler is registered for path', async () => {
-        const app = new src_1.QHTTPX();
-        const { port } = await app.listen(0, '127.0.0.1');
-        const socket = net.createConnection({ port, host: '127.0.0.1' });
-        const done = new Promise((resolve) => {
-            let finished = false;
-            const finish = () => {
-                if (!finished) {
-                    finished = true;
-                    resolve();
-                }
-            };
-            socket.on('end', finish);
-            socket.on('close', finish);
-            socket.on('error', () => {
-                finish();
-            });
-            setTimeout(finish, 500);
-        });
-        const requestLines = [
-            'GET /no-ws HTTP/1.1',
-            'Host: 127.0.0.1',
-            'Upgrade: websocket',
-            'Connection: Upgrade',
-            '',
-            '',
-        ];
-        socket.write(requestLines.join('\r\n'));
-        await done;
-        await app.close();
-    });
-    (0, vitest_1.it)('supports rooms and broadcasting', async () => {
-        const app = new src_1.QHTTPX();
-        app.upgrade('/chat', (ws, req) => {
-            const url = new URL(req.url || '', 'http://localhost');
-            const room = url.searchParams.get('room');
-            if (room) {
-                ws.join(room);
-            }
-        });
-        app.post('/broadcast', (ctx) => {
-            const { room, message } = ctx.body;
-            app.websocket.to(room).emit(message);
-            ctx.json({ success: true });
-        });
-        const { port } = await app.listen(0, '127.0.0.1');
-        const baseUrl = `ws://127.0.0.1:${port}/chat`;
-        // Client A in room1
-        const wsA = new ws_1.default(`${baseUrl}?room=room1`);
-        const msgsA = [];
-        wsA.on('message', (data) => msgsA.push(data.toString()));
-        // Client B in room1
-        const wsB = new ws_1.default(`${baseUrl}?room=room1`);
-        const msgsB = [];
-        wsB.on('message', (data) => msgsB.push(data.toString()));
-        // Client C in room2
-        const wsC = new ws_1.default(`${baseUrl}?room=room2`);
-        const msgsC = [];
-        wsC.on('message', (data) => msgsC.push(data.toString()));
-        await Promise.all([
-            new Promise((resolve) => wsA.on('open', () => resolve())),
-            new Promise((resolve) => wsB.on('open', () => resolve())),
-            new Promise((resolve) => wsC.on('open', () => resolve())),
-        ]);
-        // Broadcast to room1
-        // We need to make a POST request.
-        // Since we are inside test, we can use fetch or http.request.
-        // Or just use app.websocket directly if we can access it?
-        // We can access app.websocket directly here since we have app instance.
-        app.websocket.to('room1').emit('hello room1');
-        // Wait a bit for messages
-        await new Promise((resolve) => setTimeout(resolve, 100));
-        (0, vitest_1.expect)(msgsA).toContain('hello room1');
-        (0, vitest_1.expect)(msgsB).toContain('hello room1');
-        (0, vitest_1.expect)(msgsC).not.toContain('hello room1');
-        wsA.close();
-        wsB.close();
-        wsC.close();
-        await app.close();
-    });
-});

package/dist/vitest.config.d.ts

@@ -1,2 +0,0 @@
-declare const _default: import("vite").UserConfig;
-export default _default;

package/dist/vitest.config.js

@@ -1,9 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const config_1 = require("vitest/config");
-exports.default = (0, config_1.defineConfig)({
-    test: {
-        include: ['tests/**/*.test.ts'],
-        exclude: ['dist/**', 'node_modules/**'],
-    },
-});

package/docs/AEGIS.md

@@ -1,91 +0,0 @@
-# Aegis Rate Limiter
-
-**Aegis** is a high-performance, Token Bucket-based rate limiter built directly into QHTTPX. It is designed to protect your application from DDoS attacks, brute-force attempts, and API abuse while maintaining ultra-low latency.
-
-## Features
-
-- **Token Bucket Algorithm**: Smooths out traffic spikes while enforcing strict limits.
-- **Zero Dependencies**: Uses an efficient in-memory `Map` by default.
-- **Standard Compliance**: Automatically sets `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `Retry-After` headers.
-- **Flexible Keys**: Limit by IP, API Key, User ID, or any custom logic.
-- **Extensible Storage**: Interface-ready for Redis or other distributed stores.
-
-## Usage
-
-### Zero-Config (Recommended)
-
-The easiest way to enable Aegis is via the new fluent API:
-
-```typescript
-import { app } from 'qhttpx';
-
-// 1. Presets
-app.rateLimit('standard'); // 100 req / 15 min
-
-// 2. Custom Fluent API
-app.allow(500).per('minute');
-```
-
-### Manual Middleware
-
-For specific routes or more control:
-
-```typescript
-import { app, rateLimit } from 'qhttpx';
-
-// Global
-app.use(rateLimit({
-  windowMs: 60 * 1000,
-  max: 100
-}));
-
-// Per Route
-app.post('/login', rateLimit({ max: 5 }), async () => { ... });
-```
-
-## Proxy Support
-
-If your app sits behind a reverse proxy (Nginx, AWS ALB, Cloudflare), you must configure **Proxy Trust** so Aegis sees the real user IP instead of the load balancer's IP.
-
-```typescript
-app.security({
-  cors: true,
-  rateLimit: { trustProxy: true }
-});
-```
-
-## Options
-
-| Option | Type | Default | Description |
-|Params|---|---|---|
-| `windowMs` | `number` | `60000` | Time frame for which requests are checked/remembered. |
-| `max` | `number` | `100` | Max number of connections during `windowMs` before sending a 429 response. |
-| `message` | `string` \| `object` | `"Too many requests..."` | Error message returned to the client. |
-| `statusCode` | `number` | `429` | HTTP status code returned. |
-| `headers` | `boolean` | `true` | Enable/disable `X-RateLimit-*` headers. |
-| `keyGenerator` | `(ctx) => string` | `IP Address` | Function to generate a unique key for the client. |
-| `skip` | `(ctx) => boolean` | `undefined` | Function to bypass the limiter. |
-| `store` | `RateLimitStore` | `MemoryStore` | Custom storage backend (e.g., Redis). |
-
-## Custom Storage (Redis Example)
-
-You can easily swap the in-memory store for Redis to share limits across a cluster:
-
-```typescript
-import { RateLimitStore } from 'qhttpx/middleware';
-
-class RedisStore implements RateLimitStore {
-  constructor(private redis: RedisClient) {}
-
-  async increment(key: string, windowMs: number) {
-    // Implement Redis INCR + EXPIRE logic
-  }
-  
-  async decrement(key: string) { ... }
-  async reset(key: string) { ... }
-}
-
-app.use(rateLimit({
-  store: new RedisStore(redisClient)
-}));
-```