// Shared browser networking for every page. // // The server is authoritative. Pages send intents (JOIN_ROOM, CREATE_ROOM, // PING, ...) and render what the server sends back. This file only knows about // transport: connection, reconnection, heartbeat, and per-tab identity. const wsProtocol = location.protocol === "https:" ? "wss:" : "ws:"; export const WS_URL = `${wsProtocol}//${location.host}/ws`; export function getClientId() { let clientId = sessionStorage.getItem("clientId"); if (!clientId) { clientId = crypto.randomUUID?.() ?? Math.random().toString(36).slice(2) + Date.now().toString(36); sessionStorage.setItem("clientId", clientId); } return clientId; } export const student = { get() { return { name: sessionStorage.getItem("playerName") ?? "", code: sessionStorage.getItem("roomCode") ?? "", clientId: getClientId(), }; }, save(name, code) { sessionStorage.setItem("playerName", name); sessionStorage.setItem("roomCode", code); }, clear() { sessionStorage.removeItem("playerName"); sessionStorage.removeItem("roomCode"); }, }; export const teacher = { get() { return { code: sessionStorage.getItem("teacherCode") ?? "", token: sessionStorage.getItem("teacherToken") ?? "", }; }, save(code, token) { sessionStorage.setItem("teacherCode", code); sessionStorage.setItem("teacherToken", token); }, clear() { sessionStorage.removeItem("teacherCode"); sessionStorage.removeItem("teacherToken"); }, }; // Tell the server which student this tab belongs to. export function joinStudentRoom(send) { const { name, code, clientId } = student.get(); if (!name || !code) { location.href = "/"; return false; } return send({ type: "JOIN_ROOM", name, code, clientId }); } // Reclaim a room the teacher already created in this tab. export function resumeTeacherRoom(send) { const { code, token } = teacher.get(); if (!code || !token) return false; return send({ type: "RESUME_TEACHER", code, token }); } /** * Open a WebSocket and keep it open. * * Options: * onMessage(data) called for every non-PONG server message * onStatus(status) "connecting" | "connected" | "disconnected" | * "error" | "replaced" * onOpen(send) called after each successful (re)connection, so the page * can re-announce who it is * * Returns { send, close } where send() returns false when the socket is not * ready instead of throwing. */ export function createConnection({ onMessage, onStatus = () => {}, onOpen } = {}) { let socket = null; let heartbeat = null; let reconnectTimer = null; let reconnectDelay = 1000; let unloading = false; window.addEventListener("beforeunload", () => { unloading = true; }); function send(message) { if (!socket || socket.readyState !== WebSocket.OPEN) return false; socket.send(JSON.stringify(message)); return true; } function connect() { onStatus("connecting"); const ws = new WebSocket(WS_URL); socket = ws; ws.onopen = () => { if (socket !== ws) return; clearTimeout(reconnectTimer); reconnectTimer = null; reconnectDelay = 1000; clearInterval(heartbeat); heartbeat = setInterval(() => { if (socket?.readyState === WebSocket.OPEN) { socket.send(JSON.stringify({ type: "PING" })); } }, 25000); onStatus("connected"); onOpen?.(send); }; ws.onmessage = (event) => { if (socket !== ws) return; let data; try { data = JSON.parse(event.data); } catch { console.warn("Ignored a non-JSON server message"); return; } if (data.type === "PONG") return; onMessage?.(data); }; ws.onclose = (event) => { if (socket !== ws) return; socket = null; clearInterval(heartbeat); heartbeat = null; // 4000 = the server found a newer connection for this identity. Do not // reconnect, or two tabs will keep taking the room from each other. if (event.code === 4000) { onStatus("replaced"); return; } onStatus("disconnected"); if (unloading) return; reconnectTimer = setTimeout(connect, reconnectDelay); reconnectDelay = Math.min(reconnectDelay * 2, 10000); }; ws.onerror = () => { if (socket === ws) onStatus("error"); }; } connect(); return { send }; }