Repository Public
1// Outils communs de la zone d'administration : chargement, erreurs, lecture défensive des réponses du serveur.2import { useCallback, useEffect, useRef, useState, type ReactNode } from "react"3import { fmtDateTime, getLang, t } from "../../i18n"4import { HttpError, NetworkError } from "../../jmap/errors"5import { apiGet } from "../../jmap/http"6import { formatSize } from "../../mail/attachments"7import { S, type Me } from "../../state/app"8import { startAccounts } from "../../state/mail"9import { Icon, Spinner } from "../kit"1011export const DASH = "—"1213// ---------------------------------------------------------------- lecture défensive14export const isRecord = (v: unknown): v is Record<string, unknown> => typeof v === "object" && v !== null && !Array.isArray(v)15export const asArray = (v: unknown): unknown[] => (Array.isArray(v) ? v : [])16/** Chaîne non vide, ou nombre converti ; sinon null. */17export function asString(v: unknown): string | null {18 if (typeof v === "string") return v.trim() ? v : null19 if (typeof v === "number" && Number.isFinite(v)) return String(v)20 return null21}22export function asNumber(v: unknown): number | null {23 if (typeof v === "number") return Number.isFinite(v) ? v : null24 if (typeof v === "string" && /^\d+(\.\d+)?$/.test(v.trim())) return Number(v)25 return null26}27/** Texte affichable d'une valeur quelconque (objet → JSON compact). */28export function asText(v: unknown): string | null {29 const s = asString(v)30 if (s !== null) return s31 if (typeof v === "boolean") return String(v)32 if (isRecord(v) || Array.isArray(v)) {33 try {34 return JSON.stringify(v)35 } catch {36 return null37 }38 }39 return null40}4142export function fmtBytes(v: unknown): string {43 const n = asNumber(v)44 if (n === null) return asString(v) ?? DASH45 return formatSize(n, getLang()) || DASH46}47/** Date ISO ou horodatage Unix (secondes ou millisecondes). */48export function fmtWhen(v: unknown): string {49 if (typeof v === "number" && Number.isFinite(v)) {50 const d = new Date(v < 1e12 ? v * 1000 : v)51 return Number.isNaN(d.getTime()) ? DASH : fmtDateTime(d.toISOString())52 }53 return typeof v === "string" ? fmtDateTime(v) : DASH54}5556// ---------------------------------------------------------------- erreurs57/** Message lisible ; `codes` associe un code d'erreur du serveur à un texte précis. */58export function errorText(e: unknown, codes: Record<string, string> = {}): string {59 if (e instanceof NetworkError) return t("error.offline")60 if (e instanceof HttpError) {61 if (codes[e.code]) return codes[e.code]62 if (e.status === 403) return t("admin.error.forbidden")63 if (e.code === "mail_server_error" || e.code === "mail_server_unavailable") return t("admin.error.mailServer", { detail: e.message || e.code })64 return t("admin.error.detail", { detail: e.message || e.code })65 }66 return t("admin.error.detail", { detail: e instanceof Error ? e.message : String(e) })67}6869// ---------------------------------------------------------------- chargement70export interface LoadState<T> {71 data: T | null72 error: unknown73 loading: boolean74 reload: () => void75}76/** Charge au montage, puis à chaque `reload()` ; la requête en cours est annulée au démontage. */77export function useLoad<T>(loader: (signal: AbortSignal) => Promise<T>): LoadState<T> {78 const [state, setState] = useState<{ data: T | null; error: unknown; loading: boolean }>({ data: null, error: null, loading: true })79 const [tick, setTick] = useState(0)80 const ref = useRef(loader)81 ref.current = loader82 useEffect(() => {83 const ac = new AbortController()84 setState((s) => ({ ...s, error: null, loading: true }))85 ref.current(ac.signal).then(86 (data) => {87 if (!ac.signal.aborted) setState({ data, error: null, loading: false })88 },89 (error: unknown) => {90 if (!ac.signal.aborted) setState({ data: null, error, loading: false })91 },92 )93 return () => ac.abort()94 }, [tick])95 const reload = useCallback(() => setTick((n) => n + 1), [])96 return { ...state, reload }97}9899/** Cadre d'un onglet : barre (contenu libre + « Actualiser »), indicateur, bannière d'erreur avec nouvel essai, contenu. */100export function Loadable<T>({ load, toolbar, children }: { load: LoadState<T>; toolbar?: ReactNode; children: (data: T) => ReactNode }) {101 return (102 <div className="adm">103 <div className="row wrap adm-toolbar">104 {toolbar}105 <span className="spacer" />106 {load.loading && load.data !== null ? <Spinner /> : null}107 <button type="button" className="btn small" onClick={load.reload} disabled={load.loading}>108 <Icon name="refresh" small />109 <span>{t("admin.refresh")}</span>110 </button>111 </div>112 {load.error ? (113 <div className="banner danger" role="alert">114 <Icon name="warn" />115 <span className="adm-grow">{errorText(load.error)}</span>116 <button type="button" className="btn small" onClick={load.reload}>117 {t("common.retry")}118 </button>119 </div>120 ) : load.data === null ? (121 <Spinner label={t("common.loading")} />122 ) : (123 children(load.data)124 )}125 </div>126 )127}128129/** État binaire lisible sans la couleur : icône + texte. */130export function StatusBadge({ ok, okText, badText }: { ok: boolean; okText: string; badText: string }) {131 return (132 <span className={`badge ${ok ? "ok" : "danger"}`}>133 <Icon name={ok ? "check" : "close"} small />134 {ok ? okText : badText}135 </span>136 )137}138139/** Relit l'identité (liste des boîtes de l'utilisateur connecté) et initialise les comptes ajoutés. */140export async function refreshMe(): Promise<void> {141 const me = await apiGet<Me>("/api/me")142 S.set({ me })143 startAccounts()144}145146// ---------------------------------------------------------------- vue d'ensemble (forme normalisée)147export interface Recipient {148 address: string149 status: string | null150 /** texte de la réponse du serveur distant (ou l'état brut en JSON) : sert au diagnostic de la file */151 detail: string | null152}153export interface QueueItem {154 id: string155 from: string | null156 recipients: Recipient[]157 created: unknown158 nextRetry: unknown159 size: unknown160 /** nombre d'essais déjà faits, quand le serveur le donne */161 attempts: number | null162}163export interface Overview {164 server: { reachable: boolean; latencyMs: number | null; error: string | null }165 domains: { name: string; enabled: boolean | null }[]166 counts: { users: number | null; mailboxes: number | null; sessions: number | null }167 backup: Record<string, unknown> | null168 certificates: { names: string[]; issuer: string | null; notAfter: unknown }[]169 accounts: { address: string | null; description: string | null; usedBytes: unknown; aliases: string[] }[]170 queue: QueueItem[]171}172173/** Noms d'un certificat : tableau de chaînes ou dictionnaire (nom → vrai, ou clé → nom). */174function nameList(v: unknown): string[] {175 if (Array.isArray(v)) return v.map((x) => asString(x) ?? (isRecord(x) ? asString(x.name) : null)).filter((x): x is string => x !== null)176 if (isRecord(v)) return Object.entries(v).filter(([, val]) => val !== false && val !== null).map(([k, val]) => (typeof val === "string" && val.trim() ? val : k))177 const one = asString(v)178 return one ? [one] : []179}180/** Alias : chaîne, ou objet portant l'adresse sous un nom connu. */181function aliasList(v: unknown): string[] {182 const items = Array.isArray(v) ? v : isRecord(v) ? Object.values(v) : []183 return items.map((x) => asString(x) ?? (isRecord(x) ? (asString(x.address) ?? asString(x.email) ?? asString(x.emailAddress) ?? asString(x.name)) : null)).filter((x): x is string => x !== null)184}185function statusText(v: unknown): string | null {186 if (isRecord(v)) return asString(v.type) ?? asString(v["@type"]) ?? asString(v.status) ?? asString(v.state)187 return asString(v)188}189/** Réponse du serveur distant portée par l'état d'un destinataire, quel que soit le nom du champ ; à défaut, l'état en JSON. */190function statusDetail(v: unknown): string | null {191 if (!isRecord(v)) return null192 const pick = (o: Record<string, unknown>): string | null => asString(o.response) ?? asString(o.message) ?? asString(o.reason) ?? asString(o.description) ?? asString(o.error) ?? asString(o.details)193 const direct = pick(v)194 if (direct) return direct195 for (const x of Object.values(v)) {196 if (!isRecord(x)) continue197 const inner = pick(x)198 if (inner) return asNumber(x.code) !== null ? `${asNumber(x.code)} ${inner}` : inner199 }200 const rest = Object.keys(v).filter((k) => k !== "@type" && k !== "type" && k !== "status" && k !== "state")201 return rest.length ? asText(v) : null202}203/** Destinataires : chaînes, objets `{address|email, status}` ou dictionnaire adresse → état. */204function recipientList(v: unknown): Recipient[] {205 if (Array.isArray(v)) {206 return v.flatMap((x): Recipient[] => {207 const s = asString(x)208 if (s) return [{ address: s, status: null, detail: null }]209 if (!isRecord(x)) return []210 const address = asString(x.address) ?? asString(x.email) ?? asString(x.rcpt) ?? asString(x.name)211 return address ? [{ address, status: statusText(x.status), detail: statusDetail(x.status) ?? statusDetail(x) }] : []212 })213 }214 if (isRecord(v)) return Object.entries(v).map(([address, val]) => ({ address, status: isRecord(val) && "status" in val ? statusText(val.status) : statusText(val), detail: isRecord(val) ? (statusDetail(val.status) ?? statusDetail(val)) : null }))215 const one = asString(v)216 return one ? [{ address: one, status: null, detail: null }] : []217}218219export function parseOverview(raw: unknown): Overview {220 const o = isRecord(raw) ? raw : {}221 const server = isRecord(o.server) ? o.server : {}222 const counts = isRecord(o.counts) ? o.counts : {}223 return {224 server: { reachable: server.reachable === true, latencyMs: asNumber(server.latency_ms), error: asText(server.error) },225 domains: asArray(o.domains).flatMap((d) => {226 const name = isRecord(d) ? asString(d.name) : asString(d)227 return name ? [{ name, enabled: isRecord(d) && typeof d.enable === "boolean" ? d.enable : null }] : []228 }),229 counts: { users: asNumber(counts.users), mailboxes: asNumber(counts.mailboxes), sessions: asNumber(counts.sessions) },230 backup: o.backup === null || o.backup === undefined ? null : isRecord(o.backup) ? o.backup : { value: o.backup },231 certificates: asArray(o.certificates).filter(isRecord).map((c) => ({ names: nameList(c.subjectAlternativeNames), issuer: asText(c.issuer), notAfter: c.notValidAfter })),232 accounts: asArray(o.accounts).filter(isRecord).map((a) => ({ address: asString(a.address), description: asString(a.description), usedBytes: a.used_bytes, aliases: aliasList(a.aliases) })),233 queue: asArray(o.queue).filter(isRecord).flatMap((q) => {234 const id = asString(q.id)235 return id ? [{ id, from: asString(q.from), recipients: recipientList(q.recipients), created: q.created, nextRetry: q.next_retry, size: q.size, attempts: asNumber(q.attempts) }] : []236 }),237 }238}239240export const loadOverview = async (signal?: AbortSignal): Promise<Overview> => parseOverview(await apiGet<unknown>("/api/admin/overview", signal))241