Files
Learn_System/backend/src/sse.js
T
Maxim Dolgolyov fd29acbbdd feat: WebSocket real-time + rAF render gate + guest board + screen picker
Classroom performance:
- WebSocket server (ws-server.js) for low-latency cursor & stroke preview
  Replaces HTTP POST per event → eliminates per-message auth overhead
  Session member cache (30s TTL) avoids SQLite query per WS message
  Fallback to HTTP POST when WS not connected
- Cursor throttle reduced 100ms → 33ms (~30fps)
- Stroke preview throttle reduced 50ms → 20ms
- whiteboard.js: render() is now rAF-gated (_doRender/_rafPending)
  Multiple render() calls within one frame collapse into one repaint
  document.hidden check — zero CPU when tab is in background
  visibilitychange listener restores canvas on tab focus

Guest board:
- guestClassroom.js route: public token-based read-only access
- guest-board.html: name entry + read-only whiteboard + SSE
- SSE: addGuestClient/removeGuestClient/emitToGuests

Screen share picker:
- Discord-style modal with tab switching (screen/window/tab)
- Live video preview before confirming share
- useExistingScreenStream() in ClassroomRTC

Fullscreen exit overlay:
- #cr-fs-exit-overlay button inside cr-board-wrap
- Visible only via CSS :fullscreen selector (touchpad users)

File sharing from library:
- Teacher picks file from library, sends as styled card in chat
- crDownloadLibraryFile() fetches with Bearer auth

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-13 18:04:59 +03:00

86 lines
2.6 KiB
JavaScript

/* ── SSE registry — shared between controllers ─────────────────────────── */
const clients = new Map(); // userId -> Set<res>
const guestClients = new Map(); // sessionId -> Set<res>
const db = require('./db/db');
function addClient(userId, res) {
if (!clients.has(userId)) clients.set(userId, new Set());
clients.get(userId).add(res);
}
function removeClient(userId, res) {
const set = clients.get(userId);
if (!set) return;
set.delete(res);
if (set.size === 0) clients.delete(userId);
}
function emit(userId, data) {
const conns = clients.get(userId);
if (!conns?.size) return;
const payload = `data: ${JSON.stringify(data)}\n\n`;
for (const res of conns) {
try { res.write(payload); } catch {}
}
}
// Heartbeat: detect and remove dead connections every 30s
setInterval(() => {
for (const [userId, conns] of clients) {
for (const res of conns) {
try {
if (res.writableEnded || res.destroyed) { conns.delete(res); continue; }
res.write(': heartbeat\n\n');
} catch { conns.delete(res); }
}
if (conns.size === 0) clients.delete(userId);
}
for (const [sessionId, conns] of guestClients) {
for (const res of conns) {
try {
if (res.writableEnded || res.destroyed) { conns.delete(res); continue; }
res.write(': heartbeat\n\n');
} catch { conns.delete(res); }
}
if (conns.size === 0) guestClients.delete(sessionId);
}
}, 30_000).unref();
/* Broadcast to all members of a class */
function emitToClass(classId, data) {
const members = db.prepare('SELECT user_id FROM class_members WHERE class_id=?').all(classId);
for (const { user_id } of members) emit(user_id, data);
}
/* ── Guest SSE (session-scoped, no userId) ── */
function addGuestClient(sessionId, res) {
if (!guestClients.has(sessionId)) guestClients.set(sessionId, new Set());
guestClients.get(sessionId).add(res);
}
function removeGuestClient(sessionId, res) {
const set = guestClients.get(sessionId);
if (!set) return;
set.delete(res);
if (set.size === 0) guestClients.delete(sessionId);
}
function emitToGuests(sessionId, data) {
const set = guestClients.get(sessionId);
if (!set?.size) return;
const payload = `data: ${JSON.stringify(data)}\n\n`;
for (const res of set) {
try { res.write(payload); } catch {}
}
}
/* Returns array of user IDs currently connected via SSE */
function getOnlineUserIds() {
return [...clients.keys()];
}
module.exports = {
addClient, removeClient, emit, emitToClass, getOnlineUserIds,
addGuestClient, removeGuestClient, emitToGuests,
};