qhttpx 1.8.2 → 1.8.4

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

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

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

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

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

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

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

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

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

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

package/dist/tests/rate-limit.test.d.ts

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

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

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

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

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

package/dist/tests/schema-routes.test.d.ts

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

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

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

package/dist/tests/server-db.test.d.ts

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

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

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

package/dist/tests/sqlite-fusion.test.d.ts

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

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

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

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

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

package/dist/tests/task-metrics.test.d.ts

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

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

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

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

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

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

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

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

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

package/dist/vitest.config.d.ts

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

package/examples/api-server.ts

@@ -1,254 +1,62 @@
-import { createHash } from 'crypto';
-import { IncomingMessage } from 'http';
-import { Duplex } from 'stream';
-import { createHttpApp, HttpError } from '../src/index';
+import { createHttpApp } from '../src/index';
 
-// 1. Initialize the application (includes CORS, Security Headers, Logging)
-const app = createHttpApp({
-  metricsEnabled: true,
-  workers: 1,
+// 1. Initialize App (Fusion + Aegis enabled)
+const app = createHttpApp({ 
+  enableRequestFusion: true, // ⚡ Auto-coalesce duplicate requests
+  metricsEnabled: true       // 📊 Expose /__qhttpx/metrics
 });
 
-// 2. Mock Database
-const users = new Map<string, { id: string; name: string; role: string }>();
-
-// Seed some data
-users.set('1', { id: '1', name: 'Alice', role: 'admin' });
-users.set('2', { id: '2', name: 'Bob', role: 'user' });
-
-// 3. Register Background Tasks
-app.task('send-email', async (payload: any) => {
-  // Simulate heavy work
-  await new Promise((resolve) => setTimeout(resolve, 500));
-  console.log(`[Background Job] Sending email to ${payload.email}: "${payload.subject}"`);
-});
-
-// 4. Define Routes
-
-// Root
-app.get('/', (ctx) => {
-  ctx.json({
-    message: 'Welcome to QHTTPX Example API',
-    endpoints: [
-      'GET /api/users',
-      'POST /api/users',
-      'GET /api/users/:id',
-      'POST /api/jobs/email',
-      'WS /ws',
-      'GET /api/cookies',
-      'GET /api/redirect'
-    ],
-    documentation: 'https://github.com/your-repo/qhttpx'
-  });
-});
-
-app.get('/api/cookies', (ctx) => {
-  // Read cookies
-  const visited = parseInt(ctx.cookies['visited'] || '0');
-  
-  // Set cookie
-  ctx.setCookie('visited', (visited + 1).toString(), {
-    path: '/',
-    maxAge: 3600, // 1 hour
-    httpOnly: true,
-  });
-
-  ctx.json({
-    message: 'Cookie demo',
-    visited: visited + 1,
-    allCookies: ctx.cookies
-  });
+// 2. Global Middleware (Logging & Rate Limit)
+app.use(async ({ req, next }) => {
+  console.log(`[${req.method}] ${req.url}`);
+  if (next) await next();
 });
 
-app.get('/api/redirect', (ctx) => {
-  ctx.redirect('/api/users');
-});
-
-// User Routes using the Chainable Builder
-app.route('/api/users')
-  .get((ctx) => {
-    const userList = Array.from(users.values());
-    ctx.json({ data: userList, count: userList.length });
-  })
-  .post(async (ctx) => {
-    if (!ctx.body || typeof ctx.body !== 'object') {
-       ctx.json({ error: 'Invalid body' }, 400);
-       return;
-    }
-    
-    const body = ctx.body as any;
-    if (!body.name || !body.role) {
-      ctx.json({ error: 'Missing name or role' }, 400);
-      return;
-    }
-
-    const id = (users.size + 1).toString();
-    const newUser = { id, name: body.name, role: body.role };
-    users.set(id, newUser);
-
-    ctx.json({ message: 'User created', user: newUser }, 201);
-  });
-
-app.route('/api/users/:id')
-  .get((ctx) => {
-    const { id } = ctx.params;
-    const user = users.get(id);
-    
-    if (!user) {
-      ctx.json({ error: 'User not found' }, 404);
-      return;
-    }
-
-    ctx.json({ data: user });
-  })
-  .delete((ctx) => {
-    const { id } = ctx.params;
-    if (users.delete(id)) {
-      ctx.json({ message: 'User deleted' });
-    } else {
-      ctx.json({ error: 'User not found' }, 404);
-    }
-  });
-
-// Job Route
-app.post('/api/jobs/email', async (ctx) => {
-  const body = ctx.body as any;
-  if (!body.email) {
-    ctx.json({ error: 'Email required' }, 400);
-    return;
+// 3. Validation Schema
+const UserSchema = {
+  body: {
+    type: 'object',
+    required: ['name', 'role'],
+    properties: { name: { type: 'string' }, role: { type: 'string' } }
   }
+};
 
-  await app.enqueue('send-email', { 
-    email: body.email, 
-    subject: 'Welcome to QHTTPX!' 
-  });
+// 4. Routes (Clean & Destructured)
+app.get('/', ({ json }) => json({ status: 'online', fusion: true }));
 
-  ctx.json({ message: 'Email job queued', status: 'pending' }, 202);
+// ⚡ Fused Endpoint: 1000 concurrent requests -> 1 DB execution
+app.get('/heavy', async ({ json }) => {
+  await new Promise(r => setTimeout(r, 100)); // Simulate DB
+  json({ data: 'Expensive Result', timestamp: Date.now() });
 });
 
-// WebSocket Route
-app.upgrade('/ws', handleWebSocketEcho);
-
-// Error handling demo
-app.get('/error', () => {
-  throw new Error('Something went wrong!');
+// 🛡️ Validated & Typed Route
+app.post('/users', { schema: UserSchema }, async ({ body, json }) => {
+  // Body is already validated and typed here
+  json({ created: true, user: body }, 201);
 });
 
-// Custom Error Handlers (optional, defaults are good)
-app.setNotFoundHandler((ctx) => {
-  ctx.json({ error: 'Not Found', path: ctx.url.pathname }, 404);
+// 📂 File Uploads (Typed)
+app.post('/upload', ({ files, json }) => {
+  if (!files?.doc) return json({ error: 'No file' }, 400);
+  const doc = Array.isArray(files.doc) ? files.doc[0] : files.doc;
+  json({ filename: doc.filename, size: doc.size });
 });
 
-app.setErrorHandler((err, ctx) => {
-  if (err instanceof HttpError) {
-    ctx.json({ error: err.message, code: err.code, details: err.details }, err.status);
-    return;
-  }
-  ctx.json({ error: 'Internal Server Error' }, 500);
+// 📡 WebSockets (Pub/Sub)
+app.upgrade('/chat', (ws) => {
+  ws.join('general'); // Auto-join room
+  ws.on('message', (msg) => {
+    // Broadcast to room
+    app.websocket.to('general').emit(`Echo: ${msg}`);
+  });
 });
 
-// 5. Start Server
-const PORT = process.env.PORT ? parseInt(process.env.PORT) : 3000;
-app.listen(PORT, '0.0.0.0').then(({ port }) => {
-  console.log(`\n🚀 Server running at http://localhost:${port}`);
-  console.log(`   Try: curl http://localhost:${port}/api/users`);
+// 5. Unified Error Handling
+app.onError(({ error, json }) => {
+  console.error(error); // Log internal error
+  json({ error: 'Internal Server Error', handled: true }, 500);
 });
 
-// --- Helpers ---
-
-function createWebSocketAccept(key: string): string {
-  return createHash('sha1')
-    .update(key + '258EAFA5-E914-47DA-95CA-C5AB0DC85B11')
-    .digest('base64');
-}
-
-function handleWebSocketEcho(req: IncomingMessage, socket: Duplex, head: Buffer) {
-  void head;
-
-  const rawKeyHeader = req.headers['sec-websocket-key'];
-  let keyHeader: string | undefined;
-  if (typeof rawKeyHeader === 'string') {
-    keyHeader = rawKeyHeader;
-  } else if (Array.isArray(rawKeyHeader)) {
-    const values = rawKeyHeader as string[];
-    if (values.length > 0) {
-      keyHeader = values[0];
-    }
-  }
-
-  const key = keyHeader ?? '';
-  const accept = createWebSocketAccept(key);
-  const responseLines = [
-    'HTTP/1.1 101 Switching Protocols',
-    'Upgrade: websocket',
-    'Connection: Upgrade',
-    `Sec-WebSocket-Accept: ${accept}`,
-    '',
-    '',
-  ];
-  socket.write(responseLines.join('\r\n'));
-
-  socket.on('data', (buffer) => {
-    if (buffer.length < 2) return;
-
-    const opcode = buffer[0] & 0x0f;
-    const masked = (buffer[1] & 0x80) !== 0;
-    let payloadLength = buffer[1] & 0x7f;
-    let offset = 2;
-
-    if (payloadLength === 126) {
-      if (buffer.length < offset + 2) return;
-      payloadLength = buffer.readUInt16BE(offset);
-      offset += 2;
-    } else if (payloadLength === 127) {
-      return; // Too large for this demo
-    }
-
-    if (buffer.length < offset + payloadLength) return;
-
-    let maskingKey: Buffer | undefined;
-    if (masked) {
-      maskingKey = buffer.subarray(offset, offset + 4);
-      offset += 4;
-    }
-
-    const payload = buffer.subarray(offset, offset + payloadLength);
-
-    if (masked && maskingKey) {
-      for (let i = 0; i < payload.length; i += 1) {
-        payload[i] ^= maskingKey[i % 4];
-      }
-    }
-
-    if (opcode === 0x8) { // Close
-      socket.end();
-      return;
-    }
-
-    if (opcode === 0x1) { // Text
-      const message = payload.toString('utf8');
-      const textBytes = Buffer.from(message, 'utf8');
-      const length = textBytes.length;
-
-      let header: Buffer;
-      if (length < 126) {
-        header = Buffer.alloc(2);
-        header[0] = 0x81;
-        header[1] = length;
-      } else if (length < 65536) {
-        header = Buffer.alloc(4);
-        header[0] = 0x81;
-        header[1] = 126;
-        header.writeUInt16BE(length, 2);
-      } else {
-        return; // Too large
-      }
-
-      const frame = Buffer.concat([header, textBytes]);
-      socket.write(frame);
-    }
-  });
-
-  socket.on('end', () => socket.end());
-  socket.on('error', () => socket.destroy());
-}
+// 6. Start Server
+app.listen(3000, () => console.log('🚀 Server running on http://localhost:3000'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qhttpx",
-  "version": "1.8.2",
+  "version": "1.8.4",
   "description": "The High-Performance Hybrid HTTP Runtime for Node.js. Built for extreme concurrency, request fusion, and zero-overhead scaling.",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",