Repository Public
1// Registre des boîtes d'essai d'une suite (fichier sous son dossier de sortie) : chaque boîte créée y est inscrite AVANT sa création,2// le démontage purge exactement celles-là, et le lancement suivant de la même suite purge ce qu'un parcours interrompu a laissé.3import fs from "node:fs"45/** Seules des adresses d'essai du domaine de recette peuvent être inscrites ou purgées : web-<nom>…@stg.spboucher.ai. */6export const isTestMailbox = (address: string): boolean => /^web-[a-z0-9-]+@stg\.spboucher\.ai$/.test(address)7const current = (out: string) => `${out}/mailboxes.json`8const leftover = (out: string) => `${out}/mailboxes-leftover.json`9function read(file: string): string[] {10 try {11 const v = JSON.parse(fs.readFileSync(file, "utf8")) as unknown12 return Array.isArray(v) ? v.filter((x): x is string => typeof x === "string" && isTestMailbox(x)) : []13 } catch {14 return []15 }16}17function write(file: string, list: string[]) {18 fs.mkdirSync(file.slice(0, file.lastIndexOf("/")), { recursive: true })19 fs.writeFileSync(file, JSON.stringify([...new Set(list)].sort(), null, 1))20}2122/** Inscrit des boîtes que le parcours va créer (avant la création : une interruption entre les deux ne perd rien). */23export function trackMailboxes(out: string, ...addresses: string[]) {24 for (const a of addresses) if (!isTestMailbox(a)) throw new Error(`not a test mailbox address: ${a}`)25 write(current(out), [...read(current(out)), ...addresses])26}27export const trackedMailboxes = (out: string): string[] => read(current(out))28export const leftoverMailboxes = (out: string): string[] => read(leftover(out))29/** Début d'un parcours : ce que le précédent a inscrit sans le purger devient « restes » ; le registre repart vide. */30export function rotateRegistry(out: string) {31 write(leftover(out), [...read(leftover(out)), ...read(current(out))])32 write(current(out), [])33}34function forget(out: string, addresses: string[]) {35 const gone = new Set(addresses)36 write(current(out), read(current(out)).filter((a) => !gone.has(a)))37 write(leftover(out), read(leftover(out)).filter((a) => !gone.has(a)))38}3940/** Appel de l'API d'administration du backend d'essai avec la session du parcours ; rend le statut et le corps JSON. */41export type AdminCall = (method: string, path: string, body?: unknown) => Promise<{ status: number; body: unknown }>42/** Appel à partir d'un en-tête Cookie (démontage global, hors navigateur). */43export function cookieCall(origin: string, cookie: string): AdminCall {44 return async (method, path, body) => {45 const r = await fetch(`${origin}${path}`, { method, headers: { cookie, origin, "x-spmail": "1", ...(body === undefined ? {} : { "content-type": "application/json" }) }, body: body === undefined ? undefined : JSON.stringify(body) })46 return { status: r.status, body: await r.json().catch(() => null) }47 }48}4950/**51 * Purge ces boîtes (compte de courrier et courrier) par l'API d'administration : une boîte que la base du parcours ne connaît pas52 * (parcours précédent, boîte détachée) est d'abord reprise (`adopt`) ; un compte déjà absent du serveur de courrier est « absent ».53 */54export async function purgeMailboxes(call: AdminCall, addresses: string[]): Promise<{ purged: string[]; absent: string[]; failed: string[] }> {55 const out = { purged: [] as string[], absent: [] as string[], failed: [] as string[] }56 const list = [...new Set(addresses)].filter(isTestMailbox)57 if (!list.length) return out58 const users = await call("GET", "/api/admin/users")59 if (users.status !== 200) return { ...out, failed: list }60 const known = new Map((users.body as { mailboxes: { id: string; address: string }[] }[]).flatMap((u) => u.mailboxes).map((m) => [m.address, m.id]))61 for (const address of list) {62 let id = known.get(address)63 if (!id) {64 const adopted = await call("POST", "/api/admin/mailboxes/adopt", { address })65 if (adopted.status === 404) {66 out.absent.push(address)67 continue68 }69 id = adopted.status === 200 ? (adopted.body as { id: string }).id : undefined70 }71 const r = id ? await call("DELETE", `/api/admin/mailboxes/${id}?purge=delete-all-mail`) : null72 ;(r?.status === 200 ? out.purged : out.failed).push(address)73 }74 return out75}76/** Purge les restes d'un parcours précédent de la même suite, puis les oublie (ceux qui échouent restent inscrits). */77export async function purgeLeftovers(out: string, call: AdminCall): Promise<void> {78 const list = leftoverMailboxes(out)79 if (!list.length) return80 const r = await purgeMailboxes(call, list)81 forget(out, [...r.purged, ...r.absent])82 console.log(`[e2e] restes du parcours précédent : ${r.purged.length} purgé(s), ${r.absent.length} déjà absent(s), ${r.failed.length} en échec`)83}84/** Démontage : purge exactement les boîtes inscrites par ce parcours ; rend celles qui n'ont pas pu l'être (elles restent inscrites). */85export async function purgeTracked(out: string, call: AdminCall): Promise<string[]> {86 const r = await purgeMailboxes(call, trackedMailboxes(out))87 forget(out, [...r.purged, ...r.absent])88 return r.failed89}90