/** * In-process change notifications for the owner's open tabs. Background work (a draft generated * by the assistant, a document finishing processing) announces what changed, and /api/events * streams it to the browser so lists update without a reload. */ export type ChangeTopic = 'drafts' | 'library' | 'documents'; type Listener = (topics: ChangeTopic[]) => void; const listeners = new Set(); let queued = new Set(); let timer: ReturnType | null = null; /** Announces a change. Bursts (progress updates) are coalesced into one message every 250 ms. */ export function notifyChange(topic: ChangeTopic): void { if (listeners.size === 0) return; queued.add(topic); if (timer) return; timer = setTimeout(() => { timer = null; const topics = [...queued]; queued = new Set(); for (const fn of listeners) fn(topics); }, 250); timer.unref?.(); } export function onChange(listener: Listener): () => void { listeners.add(listener); return () => listeners.delete(listener); } const WRITE = /^\s*(?:INSERT(?:\s+OR\s+\w+)?\s+INTO|UPDATE|DELETE\s+FROM)\s+(\w+)/i; const TOPIC: Record = { drafts: 'drafts', documents: 'documents', quizzes: 'library', questions: 'library', decks: 'library', cards: 'library', notes: 'library', folders: 'library', classes: 'library' }; /** Maps a write statement to the topic it changes, if any. */ export function topicOfWrite(sql: string): ChangeTopic | null { const table = WRITE.exec(sql)?.[1]?.toLowerCase(); return table ? (TOPIC[table] ?? null) : null; }