SPB Git

Repository Public

shared.tsx 11.0 KB 241 lines tsx

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
Files main
Menu

Theme