chahinebrini 1dfb0c647c feat(mail-page): polish v3 + shared HalfDonut + status-dot heartbeat-aware
User-Feedback nach Live-Test:

Frontend (mail page):
- HalfDonut als shared component in components/common/HalfDonut.tsx
  extrahiert (vorher local in ProtectionDetailsSheet). Mail-Page nutzt
  jetzt dieselbe SVG-Math, Animation und Stroke-Style wie der
  Blocker-Schutz-Details-Sheet — visuelle Konsistenz auf einen Blick.
  Mail-Donut: width=168 (kompakter als die 220 in Blocker, weil Legend
  rechts daneben sitzt).
- Donut zeigt Total in der Mitte mit kompaktem Format:
  < 1000 → "999", >=1000 → "1.2k+" / "12k+" / "27k+"
  Headline-Zahl oben links entfällt — Total ist im Donut-Center.
- "Mehr Infos" + "Kürzlich blockiert" zu EINER Top-Level-Collapsible
  zusammengefasst. Beim Aufklappen: Bar-Chart direkt sichtbar, nested
  Collapsible "Kürzlich blockiert" darunter (default zu).
- Account-Card Expanded: per-Connection-Bar-Chart mit adaptive
  Granularität nach Connection-Age:
  · <24h → Empty-State "Daten werden gesammelt, Auswertung nach 24h"
  · 1-14d → Day-Buckets (echte Daten via /api/mail/stats/blocked-by-day
    ?connectionId=)
  · 15-90d → Week-Buckets (client-aggregiert)
  · >90d → Month-Buckets (client-aggregiert)
- Settings-Sheet komplett refactored: State-Machine `mode: 'list' |
  'edit-title' | 'edit-email' | 'edit-password'` mit Back-Pfeil. Inline-
  Edit im selben Sheet statt Sub-Sheet öffnen (FormSheet-Pattern).
  Email-Edit-Row vorbereitet (Backend-PATCH-Endpoint kommt separat).
- Pen-Icons app-weit entfernt: SheetFieldStack-Row, alle Settings-Rows
  auf chevron-forward (Memory-Konvention).

Frontend (MailAccountCard status fix):
- resolveStatusDot nutzt jetzt heartbeat-as-fallback. Vorher: "waiting"
  wenn lastScannedAt=null, egal ob Daemon längst connected war. Jetzt:
  "waiting" nur wenn weder lebendiger Heartbeat noch vergangener Scan
  existiert → frisch verbundene Connections (z.B. OAuth-Outlook 5s nach
  Connect) zeigen direkt "live".
- Behebt User-Beobachtung: "wartet auf erste verbindung" bei Outlook
  obwohl Daemon-Log "connected, auth=xoauth2" zeigt.

Backend (imap-idle daemon):
- getMailboxLock("INBOX") jetzt mit 30s Promise.race-Timeout gewrappt.
- Outlook/XOAUTH2 hat den Edge-Case, dass der Mailbox-Lock lautlos
  hängt nach erfolgreichem connect — die Session bleibt offen ohne
  Fortschritt bis der Renew-Timer (10min) ein imap.close() schickt.
  Mit Timeout wird das Failure-Mode explizit → Auth-Retry-Loop greift
  sauber + last_connect_error mit klarem Text (statt stiller Hänger).
- Root-Cause "warum hängt es" noch nicht behoben — Diagnose nach
  Deploy in Logs (mo).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-13 23:23:45 +02:00

145 lines
3.9 KiB
TypeScript

import { useCallback, useEffect, useRef, useState } from 'react';
import { AppState, type AppStateStatus } from 'react-native';
import { apiFetch } from '../lib/api';
export type MailAccount = {
id: string;
email: string;
provider: string;
title?: string | null;
isActive: boolean;
paused?: boolean;
lastScannedAt: string | null;
nextScanAt: string | null;
totalBlocked: number;
totalScanned: number;
scanInterval: number;
blockRate: number;
lastConnectError?: string | null;
lastConnectErrorAt?: string | null;
lastIdleHeartbeatAt?: string | null;
/** ISO-date — present when backend includes it. Used for adaptive chart granularity. */
createdAt?: string | null;
};
export type DailyStat = {
date: string;
label: string;
count: number;
};
export type MailStatusResponse = {
connected: boolean;
accounts: MailAccount[];
totalBlocked: number;
totalScanned: number;
dailyStats: DailyStat[];
};
export type Plan = 'free' | 'pro' | 'legend';
export type UseMailStatusReturn = {
connected: boolean;
accounts: MailAccount[];
totalBlocked: number;
totalScanned: number;
dailyStats: DailyStat[];
/** Plan-derived account limit: free=1, pro=3, legend=Infinity */
maxAccounts: number;
loading: boolean;
error: string | null;
refresh: () => Promise<void>;
};
const POLL_INTERVAL_MS = 30_000;
function deriveMaxAccounts(plan: Plan): number {
if (plan === 'free') return 1;
if (plan === 'pro') return 3;
return Infinity;
}
/**
* Fetched GET /api/mail/status mit:
* - initialem Fetch on mount
* - 30s-Polling solange App im Vordergrund (AppState === 'active')
* - manuell triggerbar via refresh()
*
* TODO: Ersetze Polling durch IDLE-Realtime-Websocket wenn Phase-10-Backend fertig ist.
*/
export function useMailStatus(plan: Plan): UseMailStatusReturn {
const [data, setData] = useState<MailStatusResponse | null>(null);
const [loading, setLoading] = useState(true);
const [error, setError] = useState<string | null>(null);
const intervalRef = useRef<ReturnType<typeof setInterval> | null>(null);
const appStateRef = useRef<AppStateStatus>(AppState.currentState);
const fetchStatus = useCallback(async () => {
try {
const res = await apiFetch<MailStatusResponse>('/api/mail/status');
setData(res);
setError(null);
} catch (e: any) {
console.error('[useMailStatus] fetch failed:', e?.message ?? e);
setError(e?.message ?? 'unknown');
} finally {
setLoading(false);
}
}, []);
// Polling starten / stoppen je nach AppState
const startPolling = useCallback(() => {
if (intervalRef.current) return;
intervalRef.current = setInterval(() => {
fetchStatus();
}, POLL_INTERVAL_MS);
}, [fetchStatus]);
const stopPolling = useCallback(() => {
if (intervalRef.current) {
clearInterval(intervalRef.current);
intervalRef.current = null;
}
}, []);
useEffect(() => {
fetchStatus();
startPolling();
const sub = AppState.addEventListener('change', (nextState: AppStateStatus) => {
const wasActive = appStateRef.current === 'active';
const isNowActive = nextState === 'active';
appStateRef.current = nextState;
if (!wasActive && isNowActive) {
// App kommt in Vordergrund — sofort refreshen + Polling neu starten
fetchStatus();
startPolling();
} else if (wasActive && !isNowActive) {
// App geht in Hintergrund — Polling stoppen
stopPolling();
}
});
return () => {
stopPolling();
sub.remove();
};
}, [fetchStatus, startPolling, stopPolling]);
const maxAccounts = deriveMaxAccounts(plan);
return {
connected: data?.connected ?? false,
accounts: data?.accounts ?? [],
totalBlocked: data?.totalBlocked ?? 0,
totalScanned: data?.totalScanned ?? 0,
dailyStats: data?.dailyStats ?? [],
maxAccounts,
loading,
error,
refresh: fetchStatus,
};
}