import fs from 'node:fs'; import path from 'node:path'; import { Hono, type Context } from 'hono'; import { z } from 'zod'; import crypto from 'node:crypto'; import { getCookie, setCookie } from 'hono/cookie'; import { isHttps } from '../auth.ts'; import { safeEqual } from '../crypto.ts'; import { citedPassages, citedPassagesPrompt, EXPLAIN_SYSTEM, explainPrompt } from '../ai/explain.ts'; import { genUiPrompt } from '../ai/genui.ts'; import { officePreviewHtml, PREVIEW_CSP } from '../documents/preview.ts'; import { aiStatus, runChatWithMcp } from '../ai/service.ts'; import { AIError, type ChatMessage } from '../ai/types.ts'; import { HttpError, idParam, notFound, readBody, type AppContext } from '../http.ts'; import { listCards, listQuestions } from '../services/content.ts'; import { listChunks, searchChunks, sourceLabel, type ChunkHit } from '../services/documents.ts'; import { hybridSearch } from '../services/semantic.ts'; import { newId, newToken, now, parseJson } from '../util.ts'; import type { ToolActivity } from '../ai/activity.ts'; import { sourceActivity, sse, type ExplainEvent } from './ai.ts'; const KINDS = ['quiz', 'deck', 'folder', 'class', 'note', 'document'] as const; type ShareKind = (typeof KINDS)[number]; interface ShareRow { id: string; token: string; kind: ShareKind; target_id: string; enabled: number; view_count: number; last_viewed_at: number | null; created_at: number; updated_at: number; ai: string; } /** AI features a share's visitors may use. Both are off until the owner turns them on. */ export interface ShareAi { /** "Explain this" on shared questions and flashcards. */ explain: boolean; /** A chat assistant that answers from the shared material only. */ assistant: boolean; } const shareAi = (row: Pick): ShareAi => ({ explain: false, assistant: false, ...parseJson>(row.ai, {}) }); const TABLE: Record = { quiz: { table: 'quizzes', title: 'title' }, deck: { table: 'decks', title: 'title' }, note: { table: 'notes', title: 'title' }, document: { table: 'documents', title: 'title' }, folder: { table: 'folders', title: 'name' }, class: { table: 'classes', title: 'name' }, }; function mapShare(row: ShareRow) { return { id: row.id, token: row.token, kind: row.kind, targetId: row.target_id, enabled: Boolean(row.enabled), viewCount: row.view_count, lastViewedAt: row.last_viewed_at, createdAt: row.created_at, ai: shareAi(row), }; } /* ------------------------------ admin ------------------------------ */ export function shareRoutes(app: AppContext): Hono { const { db } = app; const r = new Hono(); r.get('/shares', (c) => { const rows = db.all('SELECT * FROM shares ORDER BY created_at DESC'); const out = []; for (const row of rows) { const meta = TABLE[row.kind]; const target = db.get<{ title: string; class_id?: string }>( `SELECT ${meta.title} AS title${row.kind === 'class' ? '' : ', class_id'} FROM ${meta.table} WHERE id = ?`, row.target_id, ); if (!target) { db.run('DELETE FROM shares WHERE id = ?', row.id); continue; } const classId = row.kind === 'class' ? row.target_id : target.class_id; const cls = classId ? db.get<{ name: string; color: string }>('SELECT name, color FROM classes WHERE id = ?', classId) : undefined; out.push({ ...mapShare(row), title: target.title, classId: classId ?? null, className: cls?.name ?? '', classColor: cls?.color ?? 'slate' }); } return c.json({ shares: out }); }); r.post('/shares', async (c) => { const body = await readBody(c, z.object({ kind: z.enum(KINDS), targetId: z.string() })); const meta = TABLE[body.kind]; if (!db.get(`SELECT id FROM ${meta.table} WHERE id = ?`, body.targetId)) throw notFound('Item'); const existing = db.get('SELECT * FROM shares WHERE kind = ? AND target_id = ?', body.kind, body.targetId); const at = now(); if (existing) { db.run('UPDATE shares SET enabled = 1, updated_at = ? WHERE id = ?', at, existing.id); return c.json({ share: mapShare({ ...existing, enabled: 1 }) }); } const id = newId(); db.run('INSERT INTO shares (id, token, kind, target_id, enabled, created_at, updated_at) VALUES (?, ?, ?, ?, 1, ?, ?)', id, newToken(), body.kind, body.targetId, at, at); return c.json({ share: mapShare(db.get('SELECT * FROM shares WHERE id = ?', id)!) }, 201); }); r.patch('/shares/:id', async (c) => { const id = idParam(c); const body = await readBody(c, z.object({ enabled: z.boolean().optional(), ai: z.object({ explain: z.boolean(), assistant: z.boolean() }).partial().optional() })); const row = db.get('SELECT * FROM shares WHERE id = ?', id); if (!row) throw notFound('Share link'); const enabled = body.enabled ?? Boolean(row.enabled); const ai = { ...shareAi(row), ...body.ai }; db.run('UPDATE shares SET enabled = ?, ai = ?, updated_at = ? WHERE id = ?', enabled ? 1 : 0, JSON.stringify(ai), now(), id); return c.json({ share: mapShare(db.get('SELECT * FROM shares WHERE id = ?', id)!) }); }); /** Issues a new token: the old link stops working immediately. */ r.post('/shares/:id/rotate', (c) => { const id = idParam(c); const { changes } = db.run('UPDATE shares SET token = ?, view_count = 0, last_viewed_at = NULL, updated_at = ? WHERE id = ?', newToken(), now(), id); if (!changes) throw notFound('Share link'); return c.json({ share: mapShare(db.get('SELECT * FROM shares WHERE id = ?', id)!) }); }); r.delete('/shares/:id', (c) => { const { changes } = db.run('DELETE FROM shares WHERE id = ?', idParam(c)); if (!changes) throw notFound('Share link'); return c.json({ ok: true }); }); return r; } /* ------------------------------ public (no auth) ------------------------------ */ /** * Visitor AI requests are limited per device (not per IP: a whole campus can share one address) * and, as a cost backstop, per link. A device is a random id in a signed cookie; clearing cookies * gives a fresh device allowance, which the link-wide cap still bounds. */ const DEVICE_LIMIT = { max: 20, windowMs: 10 * 60_000 }; const LINK_LIMIT = { max: 500, windowMs: 60 * 60_000 }; const VISITOR_COOKIE = 'sd_visitor'; const aiHits = new Map(); function recentHits(key: string, windowMs: number, at: number): number[] { const list = (aiHits.get(key) ?? []).filter((t) => at - t < windowMs); aiHits.set(key, list); return list; } function limitVisitor(shareId: string, deviceId: string): void { const at = Date.now(); if (aiHits.size > 20_000) aiHits.clear(); const device = recentHits(`device:${shareId}:${deviceId}`, DEVICE_LIMIT.windowMs, at); const link = recentHits(`link:${shareId}`, LINK_LIMIT.windowMs, at); const over = device.length >= DEVICE_LIMIT.max ? { list: device, limit: DEVICE_LIMIT, who: 'from this device' } : link.length >= LINK_LIMIT.max ? { list: link, limit: LINK_LIMIT, who: 'on this link' } : null; if (over) { const retry = Math.max(1, Math.ceil((over.list[0] + over.limit.windowMs - at) / 60_000)); throw new HttpError(429, 'rate_limited', `Too many AI requests ${over.who}. Try again in ${retry} minute${retry === 1 ? '' : 's'}.`); } device.push(at); link.push(at); } const signVisitor = (app: AppContext, id: string) => crypto.createHmac('sha256', app.config.secretKey).update(`visitor:${id}`).digest('base64url').slice(0, 32); /** This browser's visitor id, from its signed cookie; a new one is issued when it is missing or forged. */ function visitorId(app: AppContext, c: Context): string { const raw = getCookie(c, VISITOR_COOKIE) ?? ''; const [id, sig] = raw.split('.'); if (id && sig && /^[A-Za-z0-9_-]{16,64}$/.test(id) && safeEqual(sig, signVisitor(app, id))) return id; const fresh = crypto.randomBytes(16).toString('base64url'); const secure = app.config.cookieSecure === 'auto' ? isHttps(c, app.config.trustProxy) : app.config.cookieSecure; setCookie(c, VISITOR_COOKIE, `${fresh}.${signVisitor(app, fresh)}`, { httpOnly: true, sameSite: 'Lax', secure, path: '/api/public', maxAge: 365 * 86_400 }); return fresh; } export function resetShareAiLimits(): void { aiHits.clear(); } /** What a visitor sees of a tool step: the step itself and its pages, not its raw input and output. */ function publicTool(tool: ToolActivity): ToolActivity { return { id: tool.id, name: tool.kind === 'mcp' ? 'tool' : tool.name, label: tool.label, status: tool.status, kind: tool.kind, subject: tool.subject, sources: tool.sources }; } const clipText = (text: string, max: number) => (text.length > max ? `${text.slice(0, max)}\n…(more not shown)` : text); /** What the shared assistant may read: the shared item (or the one being viewed) and the documents in scope. */ function sharedMaterial(app: AppContext, share: ShareRow, viewing?: { kind: 'quiz' | 'deck' | 'note' | 'document'; id: string }): { title: string; text: string; documentIds: string[] } { const meta = TABLE[share.kind]; const title = app.db.get<{ title: string }>(`SELECT ${meta.title} AS title FROM ${meta.table} WHERE id = ?`, share.target_id)?.title ?? 'Shared material'; const describe = (kind: 'quiz' | 'deck' | 'note' | 'document', id: string): { text: string; documentIds: string[] } => { if (kind === 'quiz') { const quiz = publicQuiz(app, id); return { text: `Quiz "${quiz.title}":\n${quiz.questions.map((q, i) => `${i + 1}. ${q.stem}\n${q.options.map((o) => ` - ${o.text}${o.correct ? ' (correct)' : ''}`).join('\n')}${q.rationale ? `\n Rationale: ${q.rationale}` : ''}`).join('\n')}`, documentIds: [] }; } if (kind === 'deck') { const deck = publicDeck(app, id); return { text: `Flashcards "${deck.title}":\n${deck.cards.map((c) => `- ${c.front} :: ${c.back}`).join('\n')}`, documentIds: [] }; } if (kind === 'note') { const note = publicNote(app, id); return { text: `Note "${note.title}":\n${note.content}`, documentIds: [] }; } return { text: '', documentIds: [id] }; }; if (share.kind === 'class' || share.kind === 'folder') { const items = collectionItems(app, share); const listing = `Materials in this shared ${share.kind}:\n${items.map((i) => `- ${i.kind}: ${i.title}`).join('\n')}`; const current = viewing ? describe(viewing.kind, viewing.id) : { text: '', documentIds: [] }; return { title, text: clipText([current.text ? `The visitor is looking at this:\n${current.text}` : '', listing].filter(Boolean).join('\n\n'), 24_000), documentIds: items.filter((i) => i.kind === 'document').map((i) => i.id) }; } const own = describe(share.kind, share.target_id); return { title, text: clipText(own.text, 24_000), documentIds: own.documentIds }; } const gone = () => new HttpError(404, 'share_not_found', 'This link is no longer available'); function publicQuiz(app: AppContext, id: string) { const quiz = app.db.get<{ id: string; title: string; description: string; class_id: string }>('SELECT id, title, description, class_id FROM quizzes WHERE id = ?', id); if (!quiz) throw gone(); return { kind: 'quiz' as const, id: quiz.id, title: quiz.title, description: quiz.description, questions: listQuestions(app.db, quiz.id).map((q) => ({ id: q.id, type: q.type, stem: q.stem, options: q.options, rationale: q.rationale, topic: q.topic, difficulty: q.difficulty, })), }; } function publicDeck(app: AppContext, id: string) { const deck = app.db.get<{ id: string; title: string; description: string }>('SELECT id, title, description FROM decks WHERE id = ?', id); if (!deck) throw gone(); return { kind: 'deck' as const, id: deck.id, title: deck.title, description: deck.description, cards: listCards(app.db, deck.id).map((c) => ({ id: c.id, front: c.front, back: c.back, hint: c.hint })), }; } function publicNote(app: AppContext, id: string) { const note = app.db.get<{ id: string; title: string; content: string; updated_at: number }>('SELECT id, title, content, updated_at FROM notes WHERE id = ?', id); if (!note) throw gone(); return { kind: 'note' as const, id: note.id, title: note.title, content: note.content, updatedAt: note.updated_at }; } function publicDocument(app: AppContext, id: string) { const doc = app.db.get>('SELECT id, title, filename, kind, size, page_count, mime FROM documents WHERE id = ?', id); if (!doc) throw gone(); return { kind: 'document' as const, id: doc.id as string, title: doc.title as string, filename: doc.filename as string, docKind: doc.kind as string, size: doc.size as number, pageCount: doc.page_count as number | null }; } /** Quizzes, decks, notes and processed documents inside a class or folder. */ function collectionItems(app: AppContext, share: ShareRow) { const { db } = app; const byFolder = share.kind === 'folder'; const where = byFolder ? 'folder_id = ?' : 'class_id = ?'; const quizzes = db.all>( `SELECT z.id, z.title, z.description, z.folder_id, (SELECT COUNT(*) FROM questions q WHERE q.quiz_id = z.id) AS n FROM quizzes z WHERE z.${where} ORDER BY z.sort_order, z.created_at`, share.target_id, ); const decks = db.all>( `SELECT d.id, d.title, d.description, d.folder_id, (SELECT COUNT(*) FROM cards c WHERE c.deck_id = d.id) AS n FROM decks d WHERE d.${where} ORDER BY d.sort_order, d.created_at`, share.target_id, ); const notes = db.all>(`SELECT id, title, folder_id FROM notes WHERE ${where} ORDER BY sort_order, created_at`, share.target_id); // Documents are shared once they have been processed (a failed or half-read upload stays private). const documents = db.all>(`SELECT id, title, folder_id, page_count, kind FROM documents WHERE ${where} AND status = 'ready' ORDER BY sort_order, created_at`, share.target_id); return [ ...quizzes.filter((q) => q.n > 0).map((q) => ({ kind: 'quiz' as const, id: q.id as string, title: q.title as string, description: q.description as string, folderId: q.folder_id as string | null, count: q.n as number })), ...decks.filter((d) => d.n > 0).map((d) => ({ kind: 'deck' as const, id: d.id as string, title: d.title as string, description: d.description as string, folderId: d.folder_id as string | null, count: d.n as number })), ...notes.map((n) => ({ kind: 'note' as const, id: n.id as string, title: n.title as string, description: '', folderId: n.folder_id as string | null, count: 0 })), ...documents.map((d) => ({ kind: 'document' as const, id: d.id as string, title: d.title as string, description: String(d.kind ?? ''), folderId: d.folder_id as string | null, count: (d.page_count as number | null) ?? 0 })), ]; } export function publicRoutes(app: AppContext): Hono { const { db } = app; const r = new Hono(); /** The switches visitors see: on only when the owner allowed it and a model is configured. */ const publicAi = (share: ShareRow): ShareAi => { const flags = shareAi(share); if (!flags.explain && !flags.assistant) return flags; const ready = aiStatus(app).ready; return { explain: flags.explain && ready, assistant: flags.assistant && ready }; }; const load = (token: string): ShareRow => { if (!token || token.length < 16 || token.length > 64) throw gone(); const share = db.get('SELECT * FROM shares WHERE token = ?', token); if (!share || !share.enabled) throw gone(); return share; }; r.get('/:token', (c) => { const share = load(c.req.param('token')); db.run('UPDATE shares SET view_count = view_count + 1, last_viewed_at = ? WHERE id = ?', now(), share.id); c.header('Cache-Control', 'no-store'); c.header('X-Robots-Tag', 'noindex, nofollow'); const ai = publicAi(share); switch (share.kind) { case 'quiz': return c.json({ ...publicQuiz(app, share.target_id), ai }); case 'deck': return c.json({ ...publicDeck(app, share.target_id), ai }); case 'note': return c.json({ ...publicNote(app, share.target_id), ai }); case 'document': return c.json({ ...publicDocument(app, share.target_id), ai }); case 'folder': { const folder = db.get<{ id: string; name: string; class_id: string }>('SELECT id, name, class_id FROM folders WHERE id = ?', share.target_id); if (!folder) throw gone(); const cls = db.get<{ name: string; color: string }>('SELECT name, color FROM classes WHERE id = ?', folder.class_id); return c.json({ kind: 'collection' as const, title: folder.name, subtitle: cls?.name ?? '', color: cls?.color ?? 'cobalt', folders: [], items: collectionItems(app, share), ai }); } case 'class': { const cls = db.get<{ id: string; name: string; code: string; description: string; color: string }>('SELECT * FROM classes WHERE id = ?', share.target_id); if (!cls) throw gone(); const folders = db.all<{ id: string; name: string }>('SELECT id, name FROM folders WHERE class_id = ? ORDER BY sort_order, created_at', cls.id); return c.json({ kind: 'collection' as const, title: cls.name, subtitle: cls.code, description: cls.description, color: cls.color, folders, items: collectionItems(app, share), ai }); } default: throw gone(); } }); /** One item inside a shared class or folder. Membership is re-checked on every request. */ r.get('/:token/items/:kind/:id', (c) => { const share = load(c.req.param('token')); if (share.kind !== 'class' && share.kind !== 'folder') throw gone(); const kind = c.req.param('kind'); const id = c.req.param('id'); const allowed = collectionItems(app, share).some((i) => i.kind === kind && i.id === id); if (!allowed) throw gone(); c.header('Cache-Control', 'no-store'); c.header('X-Robots-Tag', 'noindex, nofollow'); const ai = publicAi(share); if (kind === 'quiz') return c.json({ ...publicQuiz(app, id), ai }); if (kind === 'deck') return c.json({ ...publicDeck(app, id), ai }); if (kind === 'document') return c.json({ ...publicDocument(app, id), ai }); return c.json({ ...publicNote(app, id), ai }); }); const sendDocument = (documentId: string) => { const doc = db.get<{ filename: string; mime: string; storage_name: string }>('SELECT filename, mime, storage_name FROM documents WHERE id = ?', documentId); if (!doc) throw gone(); const file = path.join(app.config.uploadsDir, path.basename(doc.storage_name)); if (!fs.existsSync(file)) throw gone(); const inline = doc.mime === 'application/pdf' || doc.mime.startsWith('image/'); return new Response(fs.readFileSync(file), { headers: { 'Content-Type': doc.mime || 'application/octet-stream', 'Content-Disposition': `${inline ? 'inline' : 'attachment'}; filename*=UTF-8''${encodeURIComponent(doc.filename)}`, 'X-Content-Type-Options': 'nosniff', ...(inline ? {} : { 'Content-Security-Policy': "default-src 'none'; sandbox" }), 'Cache-Control': 'private, no-store', 'X-Robots-Tag': 'noindex, nofollow', }, }); }; /** Download for an explicitly shared document. */ r.get('/:token/file', (c) => { const share = load(c.req.param('token')); if (share.kind !== 'document') throw gone(); return sendDocument(share.target_id); }); /* ------------------------------ AI for visitors ------------------------------ */ /** True when the item is the shared target or sits inside the shared class or folder. */ const inScope = (share: ShareRow, kind: 'quiz' | 'deck' | 'note' | 'document', id: string): boolean => share.kind === kind ? share.target_id === id : (share.kind === 'class' || share.kind === 'folder') && collectionItems(app, share).some((i) => i.kind === kind && i.id === id); const requireAi = (c: Context, share: ShareRow, feature: keyof ShareAi) => { if (!shareAi(share)[feature]) throw new HttpError(403, 'ai_disabled', 'The owner has not turned this on for this link.'); if (!aiStatus(app).ready) throw new HttpError(503, 'ai_unavailable', 'AI is not available right now.'); limitVisitor(share.id, visitorId(app, c)); }; const explainSchema = z.discriminatedUnion('kind', [ z.object({ kind: z.literal('question'), quizId: z.string().max(64), questionId: z.string().max(64), selected: z.array(z.string().max(4000)).max(12).optional(), ask: z.string().max(500).optional() }), z.object({ kind: z.literal('card'), deckId: z.string().max(64), cardId: z.string().max(64), ask: z.string().max(500).optional() }), ]); /** * "Explain this" for visitors. The request names a question or card; its content is loaded * here (never taken from the request), so a link can't be used as a general-purpose model. */ r.post('/:token/explain', async (c) => { const share = load(c.req.param('token')); const body = await readBody(c, explainSchema); requireAi(c, share, 'explain'); let prompt: string; let sources: ReturnType = []; if (body.kind === 'question') { if (!inScope(share, 'quiz', body.quizId)) throw gone(); const q = listQuestions(db, body.quizId).find((x) => x.id === body.questionId); if (!q) throw gone(); const texts = new Set(q.options.map((o) => o.text)); prompt = explainPrompt({ kind: 'question', stem: q.stem, options: q.options.map((o) => ({ text: o.text, correct: o.correct })), selected: body.selected?.filter((s) => texts.has(s) || q.type === 'numeric').map((s) => s.slice(0, 200)), rationale: q.rationale, ask: body.ask }); // The pages the rationale cites, read only from the quiz's own class. const classId = db.get<{ class_id: string }>('SELECT class_id FROM quizzes WHERE id = ?', body.quizId)?.class_id; if (classId && q.rationale) sources = citedPassages(db, q.rationale, { classIds: [classId], stem: q.stem }); prompt += citedPassagesPrompt(sources); } else { if (!inScope(share, 'deck', body.deckId)) throw gone(); const card = listCards(db, body.deckId).find((x) => x.id === body.cardId); if (!card) throw gone(); prompt = explainPrompt({ kind: 'card', front: card.front, back: card.back, ask: body.ask }); } return sse(c, async (emit, signal) => { try { if (sources.length) emit({ type: 'tool', tool: sourceActivity(sources) }); // Only MCP servers the owner allowed on share links take part. await runChatWithMcp( app, { task: 'quick', purpose: 'shared explanation', system: EXPLAIN_SYSTEM + genUiPrompt(), messages: [{ role: 'user', content: [{ type: 'text', text: prompt }] }], maxOutputTokens: 2500, signal, onEvent: (e) => e.type === 'text' && emit({ type: 'text', delta: e.delta }) }, 'share', { onTool: (tool) => emit({ type: 'tool', tool: publicTool(tool) }) }, ); } catch (err) { const ai = err instanceof AIError ? err : null; if (ai?.code !== 'aborted') emit({ type: 'error', code: ai?.code ?? 'server', message: 'The explanation could not be generated. Try again later.' }); } emit({ type: 'done' }); }); }); const chatSchema = z.object({ messages: z .array(z.object({ role: z.enum(['user', 'assistant']), text: z.string().trim().min(1).max(4000) })) .min(1) .max(16) .refine((m) => m[m.length - 1].role === 'user', 'The last message must be from the visitor'), /** The item the visitor is looking at inside a shared class or folder. */ item: z.object({ kind: z.enum(['quiz', 'deck', 'note', 'document']), id: z.string().max(64) }).optional(), }); /** A chat that answers from the shared material (plus MCP servers allowed on share links): no library access, nothing saved. */ r.post('/:token/chat', async (c) => { const share = load(c.req.param('token')); const body = await readBody(c, chatSchema); requireAi(c, share, 'assistant'); const question = body.messages[body.messages.length - 1].text; const material = sharedMaterial(app, share, body.item && inScope(share, body.item.kind, body.item.id) ? body.item : undefined); let hits: ChunkHit[] = []; if (material.documentIds.length) { const scope = { documentIds: material.documentIds }; hits = await hybridSearch(app, question, scope, 6).catch(() => searchChunks(db, question, scope, 6)); } const excerpts = hits.map((h) => `[${sourceLabel(h)}]\n${h.text}`).join('\n\n---\n\n'); const system = [ `You are a study assistant on a page someone shared: "${material.title}". Help the visitor understand and remember this material.`, 'Answer from the shared material below and from general nursing knowledge. You cannot see anything else of the owner\'s, and you cannot change anything. If a question has nothing to do with studying this material, politely say you can only help with it.', 'When you use a document excerpt, name its source in parentheses, e.g. (Lecture 3, p. 4). Be concise and use Markdown.', material.text ? `SHARED MATERIAL:\n${material.text}` : '', excerpts ? `RELEVANT DOCUMENT EXCERPTS:\n${excerpts}` : '', ] .filter(Boolean) .join('\n\n') + genUiPrompt(); const messages: ChatMessage[] = body.messages.map((m) => ({ role: m.role, content: [{ type: 'text', text: m.text }] })); return sse(c, async (emit, signal) => { try { let wrote = false; await runChatWithMcp( app, { task: 'chat', purpose: 'shared assistant', system, messages, maxOutputTokens: 2500, signal, onEvent: (e) => { if (e.type !== 'text') return; wrote = true; emit({ type: 'text', delta: e.delta }); }, }, 'share', { onTool: (tool) => { if (tool.status === 'running' && wrote) emit({ type: 'text', delta: '\n\n' }); wrote = false; emit({ type: 'tool', tool: publicTool(tool) }); }, }, ); } catch (err) { const ai = err instanceof AIError ? err : null; if (ai?.code !== 'aborted') emit({ type: 'error', code: ai?.code ?? 'server', message: 'The assistant could not answer. Try again later.' }); } emit({ type: 'done' }); }); }); /* ------------------------------ viewing documents ------------------------------ */ /** The document a link (or an item inside a shared collection) points at; membership is re-checked. */ const sharedDocument = (c: Context, nested: boolean): string => { const share = load(c.req.param('token') ?? ''); if (!nested) { if (share.kind !== 'document') throw gone(); return share.target_id; } if (share.kind !== 'class' && share.kind !== 'folder') throw gone(); const id = c.req.param('id') ?? ''; if (!collectionItems(app, share).some((i) => i.kind === 'document' && i.id === id)) throw gone(); return id; }; /** Word and PowerPoint files as a sandboxed HTML page. */ const sendPreview = async (documentId: string) => { const doc = db.get<{ kind: string; title: string; storage_name: string }>('SELECT kind, title, storage_name FROM documents WHERE id = ?', documentId); if (!doc || (doc.kind !== 'docx' && doc.kind !== 'pptx')) throw gone(); const file = path.join(app.config.uploadsDir, path.basename(doc.storage_name)); if (!fs.existsSync(file)) throw gone(); let html: string; try { html = await officePreviewHtml(doc.kind, new Uint8Array(await fs.promises.readFile(file)), doc.title); } catch (err) { app.log('warn', 'Shared document preview failed', err instanceof Error ? err.message : err); throw new HttpError(422, 'preview_failed', 'This file could not be shown. Download it to open it instead.'); } return new Response(html, { headers: { 'Content-Type': 'text/html; charset=utf-8', 'Content-Security-Policy': PREVIEW_CSP, 'X-Content-Type-Options': 'nosniff', 'Cache-Control': 'private, no-store', 'X-Robots-Tag': 'noindex, nofollow' } }); }; /** The extracted text, page by page, for reading on any device. */ const sendText = (c: Context, documentId: string) => { const offset = Math.max(0, Number(c.req.query('offset') ?? 0) || 0); const limit = Math.min(60, Math.max(1, Number(c.req.query('limit') ?? 30) || 30)); const chunks = listChunks(db, documentId, offset, limit + 1); c.header('Cache-Control', 'no-store'); c.header('X-Robots-Tag', 'noindex, nofollow'); return c.json({ chunks: chunks.slice(0, limit).map((ch) => ({ id: ch.id, seq: ch.seq, text: ch.text, heading: ch.heading, pageStart: ch.pageStart, pageEnd: ch.pageEnd })), nextOffset: chunks.length > limit ? offset + limit : null, }); }; r.get('/:token/preview', (c) => sendPreview(sharedDocument(c, false))); r.get('/:token/items/document/:id/preview', (c) => sendPreview(sharedDocument(c, true))); r.get('/:token/text', (c) => sendText(c, sharedDocument(c, false))); r.get('/:token/items/document/:id/text', (c) => sendText(c, sharedDocument(c, true))); /** Download for a document inside a shared class or folder. Membership is re-checked. */ r.get('/:token/items/document/:id/file', (c) => { const share = load(c.req.param('token')); if (share.kind !== 'class' && share.kind !== 'folder') throw gone(); const id = c.req.param('id'); if (!collectionItems(app, share).some((i) => i.kind === 'document' && i.id === id)) throw gone(); return sendDocument(id); }); return r; }