Study/web/src/lib/queries.ts
Elijah c595e0ff2c
All checks were successful
Verify and publish V2 container / build-and-push (push) Successful in 1m0s
Third revision: web search, MCP sign-in, exams, intelligent UI, clarifying questions
- Built-in Parallel web search (keyless; optional sign-in for higher limits and research)
  with its own settings page; OAuth sign-in (RFC 9728/8414/7591, PKCE, RFC 8707) for any
  MCP server, with token refresh and pre-registered client support
- Friendly tool steps (icon, name, status; details on click) and ids stripped from results;
  per-chat tool switches; taller thinking box
- Exams within classes: exam tabs, scoped lists, uploads, imports and Generate; exam-only
  material for generation; class setting for what the groups are called
- Assistant can ask clarifying questions in an inline form before generating
- OpenUI blocks (charts, questions, flashcards, inputs) in assistant, Explain and share chats
- Explain beside the quiz on wide screens, grounded in the cited source pages
- Quiz results: percentage ring coloured by score band, rainbow at 100
- Share links: assistant button like the owner's, hidden during quizzes; documents readable
  in the browser
- Live draft and library updates over server-sent events

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-15 20:30:00 -07:00

79 lines
3.8 KiB
TypeScript

import { useQuery, useQueryClient } from '@tanstack/react-query';
import { useCallback, useEffect } from 'react';
import { api } from './api';
import type { AiModel, AiStatus, ClassDetail, ClassListItem, DeckDetail, Overview, QuizDetail } from './types';
export const qk = {
auth: ['auth'] as const,
classes: ['classes'] as const,
class: (id: string) => ['class', id] as const,
quiz: (id: string) => ['quiz', id] as const,
deck: (id: string) => ['deck', id] as const,
note: (id: string) => ['note', id] as const,
document: (id: string) => ['document', id] as const,
attempt: (id: string) => ['attempt', id] as const,
draft: (id: string) => ['draft', id] as const,
drafts: ['drafts'] as const,
overview: ['overview'] as const,
aiStatus: ['ai', 'status'] as const,
aiModels: ['ai', 'models'] as const,
aiProviders: ['ai', 'providers'] as const,
shares: ['shares'] as const,
templates: ['templates'] as const,
settings: ['settings'] as const,
};
export const useClasses = () => useQuery({ queryKey: qk.classes, queryFn: ({ signal }) => api.get<{ classes: ClassListItem[] }>('/api/classes', signal).then((r) => r.classes) });
export const useClass = (id: string | undefined, refetchInterval?: number | false) =>
useQuery({ queryKey: qk.class(id ?? ''), queryFn: ({ signal }) => api.get<ClassDetail>(`/api/classes/${id}`, signal), enabled: Boolean(id), refetchInterval });
export const useQuiz = (id: string | undefined) => useQuery({ queryKey: qk.quiz(id ?? ''), queryFn: ({ signal }) => api.get<QuizDetail>(`/api/quizzes/${id}`, signal), enabled: Boolean(id) });
export const useDeck = (id: string | undefined) => useQuery({ queryKey: qk.deck(id ?? ''), queryFn: ({ signal }) => api.get<DeckDetail>(`/api/decks/${id}`, signal), enabled: Boolean(id) });
export const useOverview = () => useQuery({ queryKey: qk.overview, queryFn: ({ signal }) => api.get<Overview>('/api/overview', signal) });
export const useAiStatus = () => useQuery({ queryKey: qk.aiStatus, queryFn: ({ signal }) => api.get<AiStatus>('/api/ai/status', signal), staleTime: 60_000 });
export const useAiModels = () => useQuery({ queryKey: qk.aiModels, queryFn: ({ signal }) => api.get<{ models: AiModel[] }>('/api/ai/models', signal).then((r) => r.models), staleTime: 60_000 });
/**
* After a change, refresh everything that could show it. The whole dataset is small and
* requests are local, so correctness beats precision here.
*/
export function useRefresh() {
const qc = useQueryClient();
return useCallback(
(...only: (readonly unknown[])[]) => {
if (only.length > 0) return Promise.all(only.map((queryKey) => qc.invalidateQueries({ queryKey })));
return qc.invalidateQueries({ predicate: (q) => q.queryKey[0] !== 'auth' && q.queryKey[0] !== 'public' });
},
[qc],
);
}
/**
* Listens to /api/events and refreshes what changed elsewhere: a draft the assistant created,
* a quiz saved in another tab, a change the assistant confirmed. Reconnects by itself.
*/
export function useLiveChanges() {
const qc = useQueryClient();
useEffect(() => {
if (typeof EventSource === 'undefined') return;
const source = new EventSource('/api/events');
source.onmessage = (e) => {
let msg: { type?: string; topics?: string[] } = {};
try {
msg = JSON.parse(e.data);
} catch {
return;
}
if (msg.type !== 'change' || !msg.topics) return;
if (msg.topics.includes('drafts')) void qc.invalidateQueries({ queryKey: qk.drafts });
// Document processing is already polled by the pages that show it; its progress writes are skipped here.
if (msg.topics.includes('library')) void qc.invalidateQueries({ predicate: (q) => ['classes', 'class', 'overview', 'quiz', 'deck', 'note'].includes(String(q.queryKey[0])) });
};
return () => source.close();
}, [qc]);
}