Repository Public
1// Briques communes aux sections des réglages : choix de la boîte, garde de compte, chargement, erreurs.2import { useCallback, useEffect, useId, useRef, useState, type ReactNode } from "react"3import { t } from "../../i18n"4import { errorDetail, errorKind } from "../../jmap/errors"5import { S, toast, type Account } from "../../state/app"6import { hasClient, initAccount } from "../../state/mail"7import { useStore } from "../../state/store"8import { Icon, Spinner } from "../kit"910/** Message lisible pour une erreur de transport ou de protocole. */11export function errorText(e: unknown): string {12 return errorKind(e) === "offline" ? t("error.offline") : t("error.actionFailed")13}1415/** Notification d'erreur ; un 401 est déjà pris en charge par l'écran de connexion. */16export function toastError(e: unknown, text?: string) {17 if (errorKind(e) === "unauthorized") return18 toast({ kind: "error", text: text ?? errorText(e), detail: errorDetail(e) || undefined })19}2021export function ErrorBanner({ text, detail, onRetry }: { text: string; detail?: string; onRetry?: () => void }) {22 return (23 <div className="banner danger set-banner" role="alert">24 <Icon name="warn" />25 <div className="set-banner-text">26 <div>{text}</div>27 {detail ? <div className="muted mono set-wrap">{detail}</div> : null}28 </div>29 {onRetry ? (30 <button type="button" className="btn small" onClick={onRetry}>31 {t("common.retry")}32 </button>33 ) : null}34 </div>35 )36}3738export function LoadError({ error, onRetry }: { error: unknown; onRetry: () => void }) {39 return <ErrorBanner text={errorText(error)} detail={errorDetail(error) || undefined} onRetry={onRetry} />40}4142// ---------------------------------------------------------------- chargement d'une ressource43export type Load<T> = { status: "loading" } | { status: "error"; error: unknown } | { status: "ready"; data: T }4445/** Charge une ressource à l'affichage et à chaque changement de `key` ; `reload` relance, `setData` remplace sur place. */46export function useLoad<T>(fn: (signal: AbortSignal) => Promise<T>, key: string): { state: Load<T>; reload: () => void; setData: (data: T) => void } {47 const [state, setState] = useState<Load<T>>({ status: "loading" })48 const [gen, setGen] = useState(0)49 const fnRef = useRef(fn)50 fnRef.current = fn51 useEffect(() => {52 const ac = new AbortController()53 setState({ status: "loading" })54 fnRef.current(ac.signal).then(55 (data) => {56 if (!ac.signal.aborted) setState({ status: "ready", data })57 },58 (error: unknown) => {59 if (!ac.signal.aborted) setState({ status: "error", error })60 },61 )62 return () => ac.abort()63 }, [key, gen])64 const reload = useCallback(() => setGen((g) => g + 1), [])65 const setData = useCallback((data: T) => setState({ status: "ready", data }), [])66 return { state, reload, setData }67}6869// ---------------------------------------------------------------- boîte de courrier70/** Sélecteur de boîte ; masqué quand la personne n'en a qu'une. */71export function MailboxPicker({ mb, onChange }: { mb: string; onChange: (mb: string) => void }) {72 const mailboxes = useStore(S, (s) => s.me?.mailboxes)73 const id = useId()74 if (!mailboxes || mailboxes.length < 2) return null75 return (76 <div className="field set-picker">77 <label htmlFor={id}>{t("settings.mailbox")}</label>78 <select id={id} className="select" value={mb} onChange={(e) => onChange(e.target.value)}>79 {mailboxes.map((m) => (80 <option key={m.id} value={m.id}>81 {m.address}82 </option>83 ))}84 </select>85 </div>86 )87}8889/** N'affiche le contenu que lorsque le compte est prêt ; sinon attente ou erreur avec reprise. */90export function AccountGate({ mb, children }: { mb: string; children: (account: Account) => ReactNode }) {91 const account = useStore(S, (s) => s.accounts[mb])92 if (account?.status === "ready") return <>{children(account)}</>93 // rafraîchissement d'un compte déjà chargé : on garde le contenu en place94 if (account?.status === "loading" && account.folders.length > 0 && hasClient(mb)) return <>{children(account)}</>95 if (account?.status === "error") return <ErrorBanner text={account.error === "offline" ? t("error.offline") : t("settings.accountError")} onRetry={() => void initAccount(mb)} />96 return <Spinner label={t("common.loading")} />97}98