Repository Public
1// Exploitation : présentation des contrôles et des alertes, séries et projection, diagnostics SMTP, appareils, événements.2import assert from "node:assert/strict"3import { test } from "node:test"4import {5 alertKind, alertTone, certificatesOf, compactDuration, countByStatus, eventTone, fillDaily, filterDevices, handlesOf, isFailure, lastDelivery, lineLayout, niceScale, openAlertCount, parseAlerts, parseApiTrend,6 parseDeliveryTrend, parseDevices, parseHealth, parseMailboxStatus, parseProblems, parseSecurity, parseStorageTrend, platformFamily, problemReply, projectLinear, safeMeta, smtpHint, sortAlerts, statusChip, workersOf, worstStatus,7} from "./ops"89const HEALTH = {10 status: "fail", generated_at: "2026-11-20T10:00:00.000Z",11 checks: {12 database: { status: "ok", detail: "answered in 2 ms", checked_at: "2026-11-20T10:00:00.000Z" },13 mail_server: { status: "ok", detail: "reachable in 40 ms, 2 domain(s)", checked_at: "2026-11-20T10:00:00.000Z", data: { reachable: true, latency_ms: 40, domains: 2 } },14 backups: { status: "fail", detail: "last successful backup is 100 h old (limit 36 h)", checked_at: "2026-11-20T10:00:00.000Z", data: { at: "2026-11-16T06:00:00Z", ok: true, age_hours: 100 } },15 certificates: { status: "warn", detail: "…", checked_at: "2026-11-20T10:00:00.000Z", data: { certificates: [16 { name: "smtp:mx1.example.org", status: "unknown", days: null, expires_at: null, detail: "timeout" },17 { name: "stalwart:mail.example.org", status: "ok", days: 61, expires_at: "2027-01-20T00:00:00Z" },18 { name: "web:mail.example.org", status: "warn", days: 9, expires_at: "2026-11-29T00:00:00Z" },19 ] } },20 workers: { status: "fail", detail: "…", checked_at: "2026-11-20T10:00:00.000Z", data: { enabled: true, workers: [{ name: "ops monitor", last_run_at: "2026-11-20T09:59:30Z", age_ms: 30000, stale: false }, { name: "rules", last_run_at: "2026-11-20T09:00:00Z", age_ms: 3600000, stale: true }],21 queues: { rule_jobs: 3, rule_oldest_s: 700, semantic_queue: 0, stuck_outbound: 1, watcher_idle_s: 4 }, watcher_stalled: [{ address: "a@example.org", failures: 14, since: "2026-11-20T09:58:00Z", error: "401" }] } },22 future_check: { status: "weird", detail: "x", checked_at: null },23 },24}2526test("santé : ordre de la console, états inconnus tolérés, pire état", () => {27 const h = parseHealth(HEALTH)28 assert.deepEqual(h.checks.map((c) => c.name), ["mail_server", "certificates", "backups", "workers", "database", "future_check"])29 assert.equal(h.status, "fail")30 assert.equal(h.checks.at(-1)!.status, "unknown", "un état que la console ne connaît pas devient « inconnu »")31 assert.deepEqual(countByStatus(h.checks), { ok: 2, warn: 1, fail: 2, unknown: 1 })32 assert.equal(parseHealth(null).checks.length, 0)33 assert.equal(parseHealth({ checks: { queue: { status: "warn" } } }).status, "warn", "sans état global, le pire des contrôles")34 assert.equal(worstStatus(["unknown", "ok"]), "ok", "« inconnu » n'aggrave pas")35 assert.equal(worstStatus(["unknown"]), "unknown")36 assert.equal(worstStatus(["ok", "warn", "fail"]), "fail")37})3839test("pastille d'état : jamais la couleur seule (icône + libellé par état)", () => {40 assert.deepEqual(statusChip("ok"), { tone: "ok", icon: "check", label: "adm.ops.status.ok" })41 assert.deepEqual(statusChip("warn"), { tone: "warn", icon: "warn", label: "adm.ops.status.warn" })42 assert.deepEqual(statusChip("fail"), { tone: "danger", icon: "close", label: "adm.ops.status.fail" })43 assert.deepEqual(statusChip("unknown"), { tone: "", icon: "help", label: "adm.ops.status.unknown" })44 assert.equal(new Set(["ok", "warn", "fail", "unknown"].map((s) => statusChip(s as "ok").icon)).size, 4)45})4647test("certificats : triés par échéance, inconnus en dernier ; travailleurs et veilleur", () => {48 const h = parseHealth(HEALTH)49 const certs = certificatesOf(h.checks.find((c) => c.name === "certificates"))50 assert.deepEqual(certs.map((c) => [c.kind, c.subject, c.days]), [["web", "mail.example.org", 9], ["stalwart", "mail.example.org", 61], ["smtp", "mx1.example.org", null]])51 assert.equal(certs[2].detail, "timeout")52 const w = workersOf(h.checks.find((c) => c.name === "workers"))53 assert.equal(w.enabled, true)54 assert.deepEqual(w.workers.map((x) => [x.name, x.stale]), [["ops monitor", false], ["rules", true]])55 assert.deepEqual(w.queues, { ruleJobs: 3, ruleOldestSeconds: 700, semanticQueue: 0, stuckOutbound: 1, watcherIdleSeconds: 4 })56 assert.deepEqual(w.stalled, [{ address: "a@example.org", failures: 14, since: "2026-11-20T09:58:00Z", error: "401" }])57 assert.equal(workersOf(undefined).workers.length, 0)58 assert.equal(workersOf({ name: "workers", status: "warn", detail: "", checkedAt: null, data: { enabled: false } }).enabled, false)59})6061test("durées compactes", () => {62 assert.equal(compactDuration(45_000), "45 s")63 assert.equal(compactDuration(12 * 60_000), "12 min")64 assert.equal(compactDuration(5 * 3600_000), "5 h")65 assert.equal(compactDuration(100 * 3600_000), "4 j")66 assert.equal(compactDuration(100 * 3600_000, "d"), "4 d")67 assert.equal(compactDuration(-5), "0 s")68})6970test("alertes : famille, tri (ouvertes, pannes, récentes), compteur de la pastille", () => {71 assert.equal(alertKind("cert:web:mail.example.org"), "cert")72 assert.equal(alertKind("backup"), "backup")73 assert.equal(alertKind("auth_anomaly"), "auth_anomaly")74 assert.equal(alertKind("nouveau_type"), "other")75 const list = parseAlerts({ data: [76 { id: "1", key: "backup", severity: "warn", title: "Backup", detail: "old", state: "resolved", first_seen: "2026-11-18T00:00:00Z", last_seen: "2026-11-19T00:00:00Z", count: 40, resolved_at: "2026-11-19T00:01:00Z" },77 { id: "2", key: "disk", severity: "warn", title: "Disk", detail: "9 %", state: "open", first_seen: "2026-11-20T08:00:00Z", last_seen: "2026-11-20T09:00:00Z", count: 3 },78 { id: "3", key: "cert:web:x", severity: "fail", title: "Cert", detail: "expired", state: "open", first_seen: "2026-11-20T07:00:00Z", last_seen: "2026-11-20T08:30:00Z", count: 9 },79 { id: "4", key: "queue", severity: "fail", title: "Queue", detail: "stuck", state: "acked", first_seen: "2026-11-20T07:00:00Z", last_seen: "2026-11-20T09:30:00Z", count: 2, acked_by_handle: "owner", acked_at: "2026-11-20T07:05:00Z" },80 { key: "sans identifiant" },81 ] })82 assert.equal(list.length, 4)83 assert.deepEqual(sortAlerts(list).map((a) => a.id), ["3", "2", "4", "1"])84 assert.equal(openAlertCount(list), 2, "acquittées et résolues ne comptent pas")85 assert.equal(list[2].subject, "web:x")86 assert.equal(list[3].ackedBy, "owner")87 assert.equal(alertTone(list[0]), "ok")88 assert.equal(alertTone(list[1]), "warn")89 assert.equal(alertTone(list[2]), "danger")90 assert.deepEqual(parseAlerts(null), [])91})9293test("tendance d'espace : séries par boîte, total, jours triés", () => {94 const t = parseStorageTrend({ metric: "storage", data: [95 { day: "2026-11-19", used_bytes: 300, mailboxes: [{ mailbox_id: "a", address: "a@x", used_bytes: 100 }, { mailbox_id: "b", address: "b@x", used_bytes: 200 }] },96 { day: "2026-11-18", used_bytes: 250, mailboxes: [{ mailbox_id: "a", address: "a@x", used_bytes: 90 }, { mailbox_id: "b", address: "b@x", used_bytes: null }] },97 { day: "pas-un-jour", used_bytes: 9 },98 ] })99 assert.deepEqual(t.total, [{ day: "2026-11-18", value: 250 }, { day: "2026-11-19", value: 300 }])100 assert.deepEqual(t.mailboxes.map((m) => [m.address, m.points.length]), [["b@x", 1], ["a@x", 2]], "la plus grosse boîte d'abord ; un relevé nul est un trou, pas un zéro")101})102103test("projection linéaire : pente, valeur à 30 jours, délai avant le quota, cas limites", () => {104 const pts = [0, 1, 2, 3, 4].map((i) => ({ day: `2026-11-1${i}`, value: 1000 + 100 * i }))105 const p = projectLinear(pts, 30, 5000)!106 assert.equal(Math.round(p.perDay), 100)107 assert.equal(Math.round(p.projected), 1400 + 3000)108 assert.equal(p.daysToCapacity, 36, "(5000 − 1400) / 100")109 assert.equal(p.samples, 5)110 // les trous comptent : deux relevés à dix jours d'écart111 const gap = projectLinear([{ day: "2026-11-01", value: 0 }, { day: "2026-11-11", value: 1000 }], 30)!112 assert.equal(Math.round(gap.perDay), 100)113 assert.equal(gap.daysToCapacity, null, "pas de plafond, pas de délai")114 // série décroissante : jamais négative, jamais de délai115 const down = projectLinear([{ day: "2026-11-01", value: 500 }, { day: "2026-11-02", value: 100 }], 30, 1000)!116 assert.equal(down.projected, 0)117 assert.equal(down.daysToCapacity, null)118 assert.equal(projectLinear([{ day: "2026-11-01", value: 500 }, { day: "2026-11-02", value: 2000 }], 30, 1000)!.daysToCapacity, 0, "quota déjà dépassé")119 assert.equal(projectLinear([{ day: "2026-11-01", value: 5 }]), null, "un seul relevé : pas de projection inventée")120 assert.equal(projectLinear([{ day: "2026-11-01", value: 5 }, { day: "2026-11-01", value: 7 }]), null, "deux relevés du même jour non plus")121 assert.equal(projectLinear([]), null)122 assert.equal(projectLinear([{ day: "2026-11-01", value: 5 }, { day: "2026-11-02", value: 5 }])!.perDay, 0)123})124125test("issue des remises : différés déduits, jours manquants à zéro", () => {126 const d = parseDeliveryTrend({ data: [{ day: "2026-11-19", received: 4, sent: 10, delivered: 6, bounced: 1, failed: 1 }, { day: "2026-11-18", received: 0, sent: 2, delivered: 3, bounced: 0, failed: 0 }] })127 assert.deepEqual(d.map((x) => [x.day, x.deferred]), [["2026-11-18", 0], ["2026-11-19", 2]], "jamais négatif")128 const filled = fillDaily(d, 4, new Date("2026-11-20T15:00:00Z"), (day) => ({ day, received: 0, sent: 0, delivered: 0, deferred: 0, bounced: 0, failed: 0 }))129 assert.deepEqual(filled.map((x) => x.day), ["2026-11-17", "2026-11-18", "2026-11-19", "2026-11-20"])130 assert.deepEqual(filled.map((x) => x.delivered), [0, 3, 6, 0])131 const api = parseApiTrend({ data: [{ day: "2026-11-19", requests: 12, errors: 2, rate_limited: 1, avg_ms: 35 }, { day: "x" }] })132 assert.deepEqual(api, [{ day: "2026-11-19", requests: 12, errors: 2, rateLimited: 1, avgMs: 35 }])133})134135test("géométrie des courbes : échelle ronde, abscisse au temps réel, projection", () => {136 assert.deepEqual(niceScale(7), [0, 2, 4, 6, 8])137 assert.deepEqual(niceScale(0), [0, 1])138 const bin = niceScale(3 * 1024 * 1024, 4, true)139 assert.equal(bin.at(-1)! >= 3 * 1024 * 1024, true)140 assert.equal(bin[1] % (1024 * 1024), 0, "graduations en puissances de 1024")141 const box = { width: 400, height: 200, top: 10, right: 10, bottom: 20, left: 40 }142 const l = lineLayout([{ day: "2026-11-01", value: 0 }, { day: "2026-11-03", value: 4 }, { day: "2026-11-04", value: 8 }], box)143 assert.equal(l.max, 8)144 assert.deepEqual(l.points.map((p) => p.x), [40, 273.33, 390], "le 2 novembre manque : l'écart est conservé")145 assert.deepEqual(l.points.map((p) => p.y), [180, 95, 10])146 assert.equal(l.path, "M40,180L273.33,95L390,10")147 assert.equal(l.area.endsWith("Z"), true)148 assert.equal(l.projection, null)149 const p = lineLayout([{ day: "2026-11-01", value: 0 }, { day: "2026-11-02", value: 5 }], box, { projected: { days: 1, value: 10 } })150 assert.deepEqual(p.projection, { x1: 215, y1: 95, x2: 390, y2: 10 })151 assert.equal(lineLayout([], box).path, "")152 assert.equal(lineLayout([{ day: "2026-11-01", value: 3 }], box).points[0].x, 215, "un seul point : centré")153})154155test("diagnostics SMTP : code, code étendu, famille, temporaire ou définitif", () => {156 const k = (s: string) => smtpHint(s).kind157 assert.deepEqual(smtpHint("550 5.1.1 <x@y.org>: Recipient address rejected: User unknown"), { kind: "unknown_user", code: "550", enhanced: "5.1.1", transient: false })158 assert.deepEqual(smtpHint("452 4.2.2 Mailbox full"), { kind: "mailbox_full", code: "452", enhanced: "4.2.2", transient: true })159 assert.equal(k("552 5.2.2 Over quota"), "mailbox_full")160 assert.deepEqual(smtpHint("451 4.7.1 Greylisted, please try again later"), { kind: "greylisted", code: "451", enhanced: "4.7.1", transient: true })161 assert.equal(k("421 4.7.0 Too many connections from your IP, try again in 15 minutes"), "rate_limited")162 assert.equal(k("550 5.7.1 Service unavailable; client host [1.2.3.4] blocked using zen.spamhaus.org"), "blocked")163 assert.equal(k("550 5.7.26 This mail is unauthenticated: SPF and DKIM both failed"), "auth_dns")164 assert.equal(k("550-5.7.25 The IP address sending this message does not have a PTR record"), "auth_dns")165 assert.equal(k("454 4.7.0 TLS not available due to local problem"), "tls")166 assert.equal(k("552 5.3.4 Message size exceeds fixed limit"), "too_large")167 assert.equal(k("554 5.7.1 <a@b.org>: Relay access denied"), "relay_denied")168 assert.equal(k("Connection timed out"), "connect")169 assert.equal(smtpHint("Connection timed out").transient, true)170 assert.equal(k("DNS lookup failed: NXDOMAIN"), "dns")171 assert.equal(k("554 5.6.0 Message content rejected"), "content")172 assert.equal(k("450 Requested action not taken"), "temporary")173 assert.equal(k("554 Transaction failed"), "permanent")174 assert.equal(smtpHint("554 Transaction failed").transient, false)175 assert.deepEqual(smtpHint(""), { kind: "unknown", code: null, enhanced: null, transient: true })176 assert.deepEqual(smtpHint(null), { kind: "unknown", code: null, enhanced: null, transient: true })177 // un code dans du JSON (état brut de la file) est lu ; un numéro de port ne passe pas pour un code178 assert.equal(smtpHint('{"code":451,"message":"greylisted"}').code, "451")179 assert.equal(smtpHint("connect to mx.example.org port 587 refused").code, null)180 assert.equal(smtpHint("delivered 1.2.3.4").enhanced, null, "une adresse IP n'est pas un code étendu")181})182183test("remises à problème : réponse la plus parlante", () => {184 const [p] = parseProblems({ data: [{ id: "out_1", from: "a@x", status: "bounced", attempts: 2, last_error: "bounce", external: true, created_at: "2026-11-19T00:00:00Z", updated_at: "2026-11-19T01:00:00Z",185 recipients: [{ address: "ok@y", status: "delivered", smtp_reply: "250 ok" }, { address: "ko@y", status: "bounced", smtp_reply: "550 5.1.1 unknown" }] }, { id: "out_2", status: "sent" }] })186 assert.equal(p.recipients.length, 2)187 assert.equal(problemReply(p), "550 5.1.1 unknown")188 assert.equal(problemReply({ recipients: [], lastError: "timeout" }), "timeout")189 assert.equal(parseProblems({ data: [{ id: "x", status: "delivered" }] }).length, 0, "seuls les états à problème")190})191192test("appareils : lecture, familles de plateforme, filtres", () => {193 const d = parseDevices({194 sessions: [195 { id: "s1", user_id: "u1", handle: "owner", kind: "web", device_name: "MacIntel", platform: "Macintosh", ip: "127.0.0.1", user_agent: "Mozilla", created_at: "2026-11-20T00:00:00Z", last_seen_at: "2026-11-20T09:00:00Z", expires_at: "2026-12-20T00:00:00Z", current: true },196 { id: "s2", user_id: "u2", handle: "membre", kind: "native", device_name: "iPhone de M", platform: "iOS 27", current: false },197 { id: "s3", user_id: "u2", handle: "membre", kind: "native", device_name: "Mac", platform: "macOS 27" },198 { handle: "sans id" },199 ],200 push_devices: [{ id: "p1", user_id: "u2", handle: "membre", session_id: "s2", bundle_id: "ai.spboucher.mail.ios", environment: "production", token_tail: "abcdef", created_at: "2026-11-20T00:00:00Z", apns_token: "NE DOIT PAS SORTIR" }],201 })202 assert.equal(d.sessions.length, 3)203 assert.equal(JSON.stringify(d).includes("NE DOIT PAS SORTIR"), false, "le jeton entier n'est jamais repris, même si le serveur le donnait")204 assert.deepEqual(d.sessions.map(platformFamily), ["web", "ios", "mac"])205 assert.equal(platformFamily(d.push[0]), "ios")206 assert.deepEqual(handlesOf(d), ["membre", "owner"])207 assert.deepEqual(filterDevices(d.sessions, { user: "membre", platform: "" }).map((s) => s.id), ["s2", "s3"])208 assert.deepEqual(filterDevices(d.sessions, { user: "", platform: "web" }).map((s) => s.id), ["s1"])209 assert.deepEqual(filterDevices(d.sessions, { user: "membre", platform: "mac" }).map((s) => s.id), ["s3"])210 assert.deepEqual(filterDevices(d.push, { user: "owner", platform: "" }), [])211})212213test("événements de sécurité : pagination, échecs, métadonnées sans secret", () => {214 const p = parseSecurity({ data: [{ id: 12, at: "2026-11-20T09:00:00Z", action: "reauth.failed", actor: "owner", target: "sess", ip: "::1", meta: {} }, { id: "11", at: "2026-11-20T08:00:00Z", action: "apikey.create", actor: "owner", target: "k", meta: { name: "Agent", token: "spm_secret", prefix: "spm_ab12" } }, { action: "sans id" }], next_before: 11, failed_24h: { login_failed: 2, reauth_failed: 1 } })215 assert.equal(p.events.length, 2)216 assert.equal(p.nextBefore, 11)217 assert.deepEqual(p.failed24h, { login: 2, reauth: 1 })218 assert.equal(isFailure("reauth.failed"), true)219 assert.equal(isFailure("login"), false)220 assert.equal(eventTone("login.failed"), "danger")221 assert.equal(eventTone("admin.session.revoke"), "warn")222 assert.equal(eventTone("alert.resolved"), "ok")223 assert.equal(eventTone("login"), "")224 assert.deepEqual(safeMeta(p.events[1].meta), [{ key: "name", value: "Agent" }, { key: "prefix", value: "spm_ab12" }], "une clé nommée « token » n'est jamais affichée")225 assert.deepEqual(safeMeta({ note: "voir spm_abcdefgh12345678" }), [], "une valeur qui ressemble à un jeton non plus")226 assert.equal(safeMeta({ a: "x".repeat(200) })[0].value.length, 80)227 assert.deepEqual(parseSecurity(null), { events: [], nextBefore: null, failed24h: { login: 0, reauth: 0 } })228})229230test("boîtes : état d'exploitation et dernière remise", () => {231 const m = parseMailboxStatus({ data: [{ mailbox_id: "m1", address: "a@x", handle: "owner", used_bytes: "2048", last_received_at: "2026-11-20T08:00:00Z", last_sent_at: "2026-11-20T09:00:00Z", owner_sessions: 2, watcher: { state: "stalled", failures: 14, error: "401" } }, { mailbox_id: "m2", address: "b@x", watcher: {} }] })232 assert.equal(m.get("m1")!.usedBytes, 2048)233 assert.equal(m.get("m1")!.watcher.state, "stalled")234 assert.equal(m.get("m2")!.watcher.state, "unknown")235 assert.deepEqual(lastDelivery(m.get("m1")!), { at: "2026-11-20T09:00:00Z", direction: "out" })236 assert.deepEqual(lastDelivery({ lastReceivedAt: "2026-11-20T08:00:00Z", lastSentAt: null }), { at: "2026-11-20T08:00:00Z", direction: "in" })237 assert.equal(lastDelivery(m.get("m2")!), null)238})239