Repository Public
1// Onglet « Boîtes » : création, adoption, alias, détachement et suppression des boîtes, par utilisateur.2import { useId, useState, type FormEvent } from "react"3import { lastDelivery, parseMailboxStatus, type MailboxStatus } from "../../admin/ops"4import { addMessages, fmtDateTime, t } from "../../i18n"5import { enAdmOps } from "../../i18n/en.adm.ops"6import { frAdmOps } from "../../i18n/fr.adm.ops"7import { linkProps } from "../../state/session"8import { apiDelete, apiGet, apiPost, apiPut } from "../../jmap/http"9import { isValidEmail } from "../../mail/address"10import { S, toast } from "../../state/app"11import { ConfirmDialog, Dialog, Field, Icon, Spinner } from "../kit"12import { Section } from "../Page"13import { DASH, Loadable, asArray, asNumber, asString, errorText, fmtBytes, isRecord, loadOverview, refreshMe, useLoad, type Overview } from "./shared"1415interface Box {16 id: string17 address: string18 displayName: string | null19}20interface User {21 id: string22 handle: string23 displayName: string24 role: string | null25 status: string | null26 passkeys: number | null27 mailboxes: Box[]28}29addMessages("fr", frAdmOps)30addMessages("en", enAdmOps)3132interface Data {33 users: User[]34 /** état d'exploitation par boîte (espace, dernière remise, veilleur) ; son échec ne bloque pas la gestion */35 status: Map<string, MailboxStatus>36 overview: Overview | null37 /** la vue d'ensemble sert aux domaines, à l'espace utilisé et aux alias ; son échec ne bloque pas la gestion */38 overviewError: unknown39}4041function parseUser(raw: unknown): User | null {42 if (!isRecord(raw)) return null43 const id = asString(raw.id)44 if (!id) return null45 const handle = asString(raw.handle) ?? DASH46 return {47 id,48 handle,49 displayName: asString(raw.display_name) ?? handle,50 role: asString(raw.role),51 status: asString(raw.status),52 passkeys: asNumber(raw.passkeys),53 mailboxes: asArray(raw.mailboxes).flatMap((b): Box[] => {54 if (!isRecord(b)) return []55 const boxId = asString(b.id)56 const address = asString(b.address)57 return boxId && address ? [{ id: boxId, address, displayName: asString(b.display_name) }] : []58 }),59 }60}6162async function loadData(signal: AbortSignal): Promise<Data> {63 const [users, status, ov] = await Promise.all([64 apiGet<unknown>("/api/admin/users", signal),65 apiGet<unknown>("/api/admin/mailboxes/status", signal).then(parseMailboxStatus, () => new Map<string, MailboxStatus>()),66 loadOverview(signal).then(67 (overview) => ({ overview, overviewError: null as unknown }),68 (overviewError: unknown) => ({ overview: null, overviewError }),69 ),70 ])71 return { users: asArray(users).map(parseUser).filter((u): u is User => u !== null), status, ...ov }72}7374/** Après un changement touchant les boîtes de l'utilisateur connecté : relit son identité, sans masquer un échec. */75async function refreshOwn(ownerId: string) {76 if (ownerId !== S.get().me?.user.id) return77 try {78 await refreshMe()79 } catch (e) {80 toast({ kind: "error", text: t("admin.mailboxes.meRefreshFailed"), detail: errorText(e) })81 }82}8384/** Dernière remise (réception ou envoi) et état du veilleur de réception d'une boîte. */85function BoxStatus({ s }: { s: MailboxStatus | undefined }) {86 if (!s) return <span className="muted">{DASH}</span>87 const last = lastDelivery(s)88 const w = s.watcher89 return (90 <div className="adm-mb-status" data-testid="mb-status" data-watcher={w.state}>91 <span data-testid="mb-last">{last ? t(last.direction === "in" ? "adm.ops.mb.lastIn" : "adm.ops.mb.lastOut", { when: fmtDateTime(last.at) }) : t("adm.ops.mb.noDelivery")}</span>92 <span>93 <span className={`badge ${w.state === "ok" ? "ok" : w.state === "stalled" ? "danger" : w.state === "failing" || w.state === "off" ? "warn" : ""}`}>94 <Icon name={w.state === "ok" ? "check" : w.state === "unknown" ? "help" : "warn"} small />95 {t(`adm.ops.mb.watcher.${w.state}`)}96 </span>97 </span>98 {w.error && w.state !== "ok" ? <span className="adm-error small">{w.error}</span> : null}99 </div>100 )101}102103// ---------------------------------------------------------------- création / adoption104function MailboxForm({ mode, users, domains, onDone }: { mode: "create" | "adopt"; users: User[]; domains: string[]; onDone: (ownerId: string) => void }) {105 const meId = S.get().me?.user.id ?? ""106 const [address, setAddress] = useState("")107 const [name, setName] = useState("")108 const [owner, setOwner] = useState(meId)109 const [busy, setBusy] = useState(false)110 const [error, setError] = useState<string | null>(null)111 const uid = useId()112 const create = mode === "create"113 // Propriétaire par défaut : l'utilisateur connecté, sinon le premier de la liste.114 const ownerId = users.some((u) => u.id === owner) ? owner : (users[0]?.id ?? "")115116 const submit = async (e: FormEvent) => {117 e.preventDefault()118 if (busy) return119 const addr = address.trim().toLowerCase()120 if (!isValidEmail(addr)) return setError(t("admin.mailboxes.err.invalid"))121 if (!ownerId) return setError(t("admin.mailboxes.err.owner"))122 setError(null)123 setBusy(true)124 try {125 if (create) await apiPost("/api/admin/mailboxes", { address: addr, display_name: name.trim(), user_id: ownerId })126 else await apiPost("/api/admin/mailboxes/adopt", { address: addr, user_id: ownerId })127 toast({ kind: "success", text: t(create ? "admin.mailboxes.created" : "admin.mailboxes.adopted", { address: addr }) })128 setAddress("")129 setName("")130 onDone(ownerId)131 } catch (err) {132 setError(133 errorText(134 err,135 create136 ? { address_taken: t("admin.mailboxes.err.taken"), unknown_domain: t("admin.mailboxes.err.domain"), invalid: t("admin.mailboxes.err.invalid") }137 : { not_found: t("admin.mailboxes.err.noAccount"), unknown_domain: t("admin.mailboxes.err.domain"), invalid: t("admin.mailboxes.err.invalid") },138 ),139 )140 } finally {141 setBusy(false)142 }143 }144145 return (146 <form className="adm-form" aria-label={t(create ? "admin.mailboxes.create.title" : "admin.mailboxes.adopt.title")} onSubmit={(e) => void submit(e)} noValidate>147 <Field label={t("admin.mailboxes.address")} id={`${uid}a`} hint={create && domains.length ? t("admin.mailboxes.domainsHint", { domains: domains.join(", ") }) : undefined}>148 <input149 id={`${uid}a`}150 className="input"151 type="email"152 inputMode="email"153 placeholder={t("admin.mailboxes.addressPlaceholder")}154 value={address}155 onChange={(e) => setAddress(e.target.value)}156 autoComplete="off"157 autoCapitalize="none"158 spellCheck={false}159 required160 aria-invalid={error ? true : undefined}161 aria-describedby={error ? `${uid}e` : undefined}162 />163 </Field>164 {create ? (165 <Field label={t("admin.mailboxes.displayName")} id={`${uid}n`}>166 <input id={`${uid}n`} className="input" value={name} onChange={(e) => setName(e.target.value)} maxLength={80} autoComplete="off" />167 </Field>168 ) : null}169 <Field label={t("admin.mailboxes.owner")} id={`${uid}o`}>170 <select id={`${uid}o`} className="select" value={ownerId} onChange={(e) => setOwner(e.target.value)}>171 {users.map((u) => (172 <option key={u.id} value={u.id}>173 {u.displayName} ({u.handle})174 </option>175 ))}176 </select>177 </Field>178 <div className="row wrap adm-form-foot">179 <button type="submit" className={`btn${create ? " primary" : ""}`} disabled={busy}>180 {t(create ? "admin.mailboxes.create.submit" : "admin.mailboxes.adopt.submit")}181 </button>182 {busy ? <Spinner label={t("admin.working")} /> : null}183 {error ? (184 <span id={`${uid}e`} className="adm-error small" role="alert">185 {error}186 </span>187 ) : null}188 </div>189 </form>190 )191}192193// ---------------------------------------------------------------- alias194function AliasDialog({ box, initial, onClose, onSaved }: { box: Box; initial: string[]; onClose: () => void; onSaved: () => void }) {195 const [text, setText] = useState(initial.join("\n"))196 const [busy, setBusy] = useState(false)197 const [error, setError] = useState<string | null>(null)198 const id = useId()199200 const save = async () => {201 if (busy) return202 const aliases = [...new Set(text.split(/[\n,;]+/).map((x) => x.trim().toLowerCase()).filter(Boolean))]203 const invalid = aliases.filter((a) => !isValidEmail(a))204 if (invalid.length) return setError(t("admin.aliases.err.invalid", { list: invalid.join(", ") }))205 if (aliases.length > 50) return setError(t("admin.aliases.err.tooMany"))206 setError(null)207 setBusy(true)208 try {209 await apiPut(`/api/admin/mailboxes/${box.id}/aliases`, { aliases })210 toast({ kind: "success", text: t("admin.aliases.saved", { address: box.address }) })211 onSaved()212 onClose()213 } catch (e) {214 setError(errorText(e, { invalid: t("admin.aliases.err.rejected") }))215 setBusy(false)216 }217 }218219 return (220 <Dialog221 title={t("admin.aliases.title", { address: box.address })}222 onClose={onClose}223 footer={224 <>225 {busy ? <Spinner label={t("admin.working")} /> : null}226 <button type="button" className="btn" onClick={onClose}>227 {t("common.cancel")}228 </button>229 <button type="button" className="btn primary" disabled={busy} onClick={() => void save()}>230 {t("common.save")}231 </button>232 </>233 }234 >235 <div className="stack">236 <Field label={t("admin.aliases.label")} id={id} hint={t("admin.aliases.hint")}>237 <textarea238 id={id}239 className="textarea mono"240 rows={6}241 value={text}242 onChange={(e) => setText(e.target.value)}243 spellCheck={false}244 autoCapitalize="none"245 aria-invalid={error ? true : undefined}246 aria-describedby={error ? `${id}e` : undefined}247 data-autofocus248 />249 </Field>250 {error ? (251 <p id={`${id}e`} className="adm-error small" role="alert">252 {error}253 </p>254 ) : null}255 </div>256 </Dialog>257 )258}259260// ---------------------------------------------------------------- liste261type Pending = { kind: "aliases" | "detach" | "purge"; box: Box; ownerId: string }262263export default function MailboxesTab() {264 const load = useLoad(loadData)265 const [pending, setPending] = useState<Pending | null>(null)266267 const changed = (ownerId: string) => {268 load.reload()269 void refreshOwn(ownerId)270 }271 /** Détache la boîte ; avec `purge`, supprime aussi le compte de courrier et tout son contenu. */272 const remove = async (p: Pending, purge: boolean) => {273 try {274 await apiDelete(`/api/admin/mailboxes/${p.box.id}${purge ? "?purge=delete-all-mail" : ""}`)275 toast({ kind: "success", text: t(purge ? "admin.mailboxes.purged" : "admin.mailboxes.detached", { address: p.box.address }) })276 } catch (e) {277 toast({ kind: "error", text: errorText(e, { not_found: t("admin.mailboxes.err.gone") }) })278 }279 // Rechargé dans tous les cas : après un échec partiel, la liste doit refléter l'état réel.280 changed(p.ownerId)281 }282283 return (284 <Loadable load={load}>285 {({ users, status, overview, overviewError }) => {286 const accounts = new Map((overview?.accounts ?? []).flatMap((a) => (a.address ? [[a.address.toLowerCase(), a] as const] : [])))287 const domains = (overview?.domains ?? []).map((d) => d.name)288 const aliasesOf = (b: Box) => accounts.get(b.address.toLowerCase())?.aliases ?? []289 return (290 <>291 {overviewError ? (292 <div className="banner warn" role="alert">293 <Icon name="warn" />294 <span>{t("admin.mailboxes.overviewFailed", { detail: errorText(overviewError) })}</span>295 </div>296 ) : overview && !overview.server.reachable ? (297 <div className="banner warn" role="alert">298 <Icon name="warn" />299 <span>{t("admin.mailboxes.serverDown")}</span>300 </div>301 ) : null}302303 <Section title={t("admin.mailboxes.create.title")} description={t("admin.mailboxes.create.desc")}>304 <MailboxForm mode="create" users={users} domains={domains} onDone={changed} />305 </Section>306307 <Section title={t("admin.mailboxes.adopt.title")} description={t("admin.mailboxes.adopt.desc")}>308 <div className="stack">309 <div className="banner warn">310 <Icon name="warn" />311 <span>{t("admin.mailboxes.adopt.warning")}</span>312 </div>313 <MailboxForm mode="adopt" users={users} domains={domains} onDone={changed} />314 </div>315 </Section>316317 {users.length === 0 ? <p className="muted">{t("admin.users.empty")}</p> : null}318 {users.map((u) => (319 <section key={u.id} className="card section adm-user" data-user={u.handle} aria-label={u.displayName}>320 <div className="row wrap adm-user-head">321 <h3>{u.displayName}</h3>322 <span className="mono muted">{u.handle}</span>323 <span className={`badge${u.role === "admin" ? " adm-badge" : ""}`}>{u.role === "admin" ? t("admin.users.role.admin") : u.role === "member" ? t("admin.users.role.member") : (u.role ?? DASH)}</span>324 {u.status && u.status !== "active" ? <span className="badge warn">{u.status}</span> : null}325 <span className="spacer" />326 <span className="muted small">{u.passkeys === null ? DASH : t("admin.users.passkeys", { n: u.passkeys })}</span>327 <a className="btn small" {...linkProps(`/admin/devices?user=${encodeURIComponent(u.handle)}`)} data-testid="user-devices">328 <Icon name="phone" small />329 <span>{t("adm.ops.mb.devices")}</span>330 </a>331 </div>332 {u.mailboxes.length === 0 ? (333 <p className="muted small">{t("admin.users.noMailbox")}</p>334 ) : (335 <div className="table-wrap">336 <table className="table cards-sm">337 <caption className="sr-only">{t("admin.users.caption", { name: u.displayName })}</caption>338 <thead>339 <tr>340 <th scope="col">{t("admin.col.address")}</th>341 <th scope="col">{t("admin.mailboxes.displayName")}</th>342 <th scope="col">{t("admin.col.used")}</th>343 <th scope="col">{t("adm.ops.mb.col.activity")}</th>344 <th scope="col">{t("admin.col.aliases")}</th>345 <th scope="col">{t("admin.col.actions")}</th>346 </tr>347 </thead>348 <tbody>349 {u.mailboxes.map((b) => {350 const aliases = aliasesOf(b)351 const open = (kind: Pending["kind"]) => setPending({ kind, box: b, ownerId: u.id })352 return (353 <tr key={b.id} data-address={b.address}>354 <td className="mono adm-break">{b.address}</td>355 <td className="adm-break" data-label={t("admin.mailboxes.displayName")}>356 {b.displayName ?? DASH}357 </td>358 <td className="adm-nowrap" data-label={t("admin.col.used")} data-testid="mb-used">359 {fmtBytes(accounts.get(b.address.toLowerCase())?.usedBytes ?? status.get(b.id)?.usedBytes)}360 </td>361 <td data-label={t("adm.ops.mb.col.activity")}>362 <BoxStatus s={status.get(b.id)} />363 </td>364 <td className="mono adm-break" data-label={t("admin.col.aliases")}>365 {aliases.length ? aliases.join(", ") : DASH}366 </td>367 <td>368 <div className="row wrap adm-actions">369 <button type="button" className="btn small" onClick={() => open("aliases")}>370 {t("admin.mailboxes.aliasesBtn")}371 </button>372 <button type="button" className="btn small" onClick={() => open("detach")}>373 {t("admin.mailboxes.detachBtn")}374 </button>375 <button type="button" className="btn small danger" onClick={() => open("purge")}>376 {t("admin.mailboxes.purgeBtn")}377 </button>378 </div>379 </td>380 </tr>381 )382 })}383 </tbody>384 </table>385 </div>386 )}387 </section>388 ))}389390 {pending?.kind === "aliases" ? <AliasDialog box={pending.box} initial={aliasesOf(pending.box)} onClose={() => setPending(null)} onSaved={load.reload} /> : null}391 {pending?.kind === "detach" ? (392 <ConfirmDialog393 title={t("admin.detach.title", { address: pending.box.address })}394 body={<p>{t("admin.detach.body")}</p>}395 confirmLabel={t("admin.detach.confirm")}396 onConfirm={() => remove(pending, false)}397 onClose={() => setPending(null)}398 />399 ) : null}400 {pending?.kind === "purge" ? (401 <ConfirmDialog402 danger403 requireText={pending.box.address}404 title={t("admin.purge.title")}405 body={406 <div className="stack">407 <p>{t("admin.purge.body", { address: pending.box.address })}</p>408 <div className="banner danger">409 <Icon name="warn" />410 <span>{t("admin.purge.warning")}</span>411 </div>412 </div>413 }414 confirmLabel={t("admin.purge.confirm")}415 onConfirm={() => remove(pending, true)}416 onClose={() => setPending(null)}417 />418 ) : null}419 </>420 )421 }}422 </Loadable>423 )424}425