Response & Streaming API

Velociradix supports high-performance response streaming and Server-Sent Events (SSE).

---

1. Server-Sent Events (SSE) Streaming (ctx.sse())

app.get('/live-stream', (ctx) => {
  ctx.sse((sendEvent, close) => {
    sendEvent({ message: 'Connected' }, 'init');

    let counter = 0;
    const interval = setInterval(() => {
      sendEvent({ tick: ++counter }, 'update');

      if (counter >= 10) {
        clearInterval(interval);
        close();
      }
    }, 1000);
  });
});

---

2. Node.js Stream Piping (ctx.sendStream())

Pipe any Readable stream directly to the response:

import { createReadStream } from 'node:fs';

app.get('/download-large-log', async (ctx) => {
  const stream = createReadStream('./app.log');
  await ctx.sendStream(stream, 'text/plain');
});

---

3. File Serving & Range Requests (ctx.sendFile())

Supports ETag calculation, 304 Not Modified, and HTTP 206 Partial Content Range Requests for video/audio streaming:

app.get('/media/video.mp4', (ctx) => {
  return ctx.sendFile('./assets/video.mp4');
});