Create lib/api.ts

web/src/lib/api.ts

@@ -0,0 +1,104 @@
+// web/src/lib/api.ts
+
+export type ApiRole = "user" | "assistant";
+
+export type ApiChatMessage = {
+  role: ApiRole;
+  content: string;
+};
+
+export type ApiChatRequest = {
+  message: string;
+
+  // optional context
+  history?: Array<[string, string]>; // (user, assistant)
+  learning_mode?: string;            // e.g. "concept"
+  language_preference?: string;      // "English" | "中文" | "auto"
+  doc_type?: string;                 // "Syllabus" | ...
+  course_outline?: string[];         // parsed syllabus topics
+  rag_context?: string | null;       // if FE sends; usually BE builds
+  review_data?: string | null;       // for review mode
+};
+
+export type ApiChatResponse = {
+  answer: string;
+  history?: Array<[string, string]>;
+  references?: string[];
+};
+
+const DEFAULT_TIMEOUT_MS = 20000;
+
+// If you later deploy to a different domain, set VITE_API_BASE in env
+function getBaseUrl() {
+  // Vite convention
+  const v = (import.meta as any)?.env?.VITE_API_BASE as string | undefined;
+  return (v && v.trim()) ? v.trim() : "";
+}
+
+async function fetchWithTimeout(input: RequestInfo, init?: RequestInit, timeoutMs = DEFAULT_TIMEOUT_MS) {
+  const controller = new AbortController();
+  const id = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const res = await fetch(input, { ...init, signal: controller.signal });
+    return res;
+  } finally {
+    clearTimeout(id);
+  }
+}
+
+async function parseJsonSafe(res: Response) {
+  const text = await res.text();
+  try {
+    return text ? JSON.parse(text) : null;
+  } catch {
+    return { _raw: text };
+  }
+}
+
+export async function apiChat(payload: ApiChatRequest): Promise<ApiChatResponse> {
+  const base = getBaseUrl();
+  const res = await fetchWithTimeout(`${base}/api/chat`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(payload),
+  });
+
+  const data = await parseJsonSafe(res);
+
+  if (!res.ok) {
+    const msg =
+      (data && (data.error || data.message)) ||
+      `apiChat failed (${res.status})`;
+    throw new Error(msg);
+  }
+
+  // Be tolerant: map common server shapes
+  if (data?.answer) return data as ApiChatResponse;
+  if (data?.response) return { answer: data.response, history: data.history, references: data.references };
+  if (typeof data === "string") return { answer: data };
+
+  return { answer: "" };
+}
+
+export async function apiUpload(file: File, docType: string) {
+  const base = getBaseUrl();
+  const fd = new FormData();
+  fd.append("file", file);
+  fd.append("doc_type", docType);
+
+  const res = await fetchWithTimeout(`${base}/api/upload`, {
+    method: "POST",
+    body: fd,
+  }, 60000);
+
+  const data = await parseJsonSafe(res);
+
+  if (!res.ok) {
+    const msg =
+      (data && (data.error || data.message)) ||
+      `apiUpload failed (${res.status})`;
+    throw new Error(msg);
+  }
+
+  return data;
+}