Initial commit: webmail client (M0/M1)

Three-pane webmail client. - Backend: FastAPI + async SQLAlchemy + arq worker (Postgres/Redis), IMAP/SMTP sync, threading, search, drafts/outbox with undo, attachments, 2FA. - Frontend: React 18 + Vite + TypeScript + TanStack Query + Tailwind; three-pane UI with rich-text composer, light/dark themes, resizable panels. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-17 23:20:34 +02:00
commit a5ec0d21cb
174 changed files with 22239 additions and 0 deletions
@@ -0,0 +1,65 @@
+// WebSocket layer (SPEC §9.2). Validates frames with zod and invalidates
+// TanStack Query caches keyed on ids in the payload.
+
+import type { QueryClient } from "@tanstack/react-query";
+import { z } from "zod";
+
+const frameSchema = z.object({
+  event: z.string(),
+  payload: z.record(z.unknown()),
+});
+
+const ALLOWED_EVENTS = new Set([
+  "message.new",
+  "message.changed",
+  "message.deleted",
+  "message.sent",
+  "flags.changed",
+  "thread.updated",
+  "sync.progress",
+  "account.state_changed",
+  "draft.saved",
+  "outbox.state_changed",
+]);
+
+export function connectWs(queryClient: QueryClient): () => void {
+  const proto = window.location.protocol === "https:" ? "wss" : "ws";
+  const socket = new WebSocket(`${proto}://${window.location.host}/api/ws`);
+
+  const ping = window.setInterval(() => {
+    if (socket.readyState === WebSocket.OPEN) {
+      socket.send(JSON.stringify({ type: "ping" }));
+    }
+  }, 30000);
+
+  socket.onmessage = (event) => {
+    let parsed: unknown;
+    try {
+      parsed = JSON.parse(event.data);
+    } catch {
+      return;
+    }
+    const result = frameSchema.safeParse(parsed);
+    if (!result.success || !ALLOWED_EVENTS.has(result.data.event)) return;
+    const { event: name, payload } = result.data;
+    // Coarse invalidation: refetch affected lists (SPEC §9.2 contract).
+    if (name === "sync.progress" || name.startsWith("message.") || name === "thread.updated") {
+      queryClient.invalidateQueries({ queryKey: ["threads"] });
+      if (typeof payload.thread_id === "string") {
+        queryClient.invalidateQueries({ queryKey: ["thread", payload.thread_id] });
+      }
+    }
+    if (name === "account.state_changed") {
+      queryClient.invalidateQueries({ queryKey: ["accounts"] });
+    }
+    if (name === "message.sent") {
+      // The sent message's draft is deleted server-side; refresh the Drafts list.
+      queryClient.invalidateQueries({ queryKey: ["drafts"] });
+    }
+  };
+
+  return () => {
+    window.clearInterval(ping);
+    socket.close();
+  };
+}