Repository Public
1// Client de gestion Stalwart (JMAP, capacité urn:stalwart:jmap) et coffre des secrets de boîtes.2import crypto from "node:crypto"3import { config } from "./config.js"4import { bad } from "./util.js"56function key(): Buffer {7 const k = Buffer.from(config.masterKey, "base64")8 if (k.length !== 32) throw new Error("SPMAIL_MASTER_KEY must be 32 bytes, base64-encoded")9 return k10}11export function seal(plain: string): Buffer {12 const iv = crypto.randomBytes(12)13 const c = crypto.createCipheriv("aes-256-gcm", key(), iv)14 const body = Buffer.concat([c.update(plain, "utf8"), c.final()])15 return Buffer.concat([Buffer.from([1]), iv, c.getAuthTag(), body])16}17export function unseal(blob: Buffer): string {18 if (blob[0] !== 1) throw new Error("unknown secret format")19 const d = crypto.createDecipheriv("aes-256-gcm", key(), blob.subarray(1, 13))20 d.setAuthTag(blob.subarray(13, 29))21 return Buffer.concat([d.update(blob.subarray(29)), d.final()]).toString("utf8")22}2324export const basic = (user: string, password: string) => "Basic " + Buffer.from(`${user}:${password}`).toString("base64")25const adminAuth = () => basic(config.stalwartAdminUser, config.stalwartAdminPassword)2627type Call = [string, Record<string, unknown>, string]28export async function adminCall(calls: Call[]): Promise<Call[]> {29 const r = await fetch(`${config.stalwartUrl}/jmap/`, {30 method: "POST",31 headers: { authorization: adminAuth(), "content-type": "application/json" },32 body: JSON.stringify({ using: ["urn:ietf:params:jmap:core", "urn:stalwart:jmap"], methodCalls: calls }),33 signal: AbortSignal.timeout(6_000),34 }).catch(() => { throw bad("mail_server_unavailable", 502, "The mail server is unreachable") })35 if (!r.ok) throw bad("mail_server_unavailable", 502, `Stalwart management API answered ${r.status}`)36 const j = (await r.json()) as { methodResponses: Call[] }37 for (const [name, res] of j.methodResponses) if (name === "error") throw bad("mail_server_error", 502, String(res.type ?? "error"))38 return j.methodResponses39}4041export async function getAll(type: string, properties?: string[]): Promise<Record<string, any>[]> {42 const r = await adminCall([[`x:${type}/query`, { limit: 500 }, "q"], [`x:${type}/get`, { "#ids": { resultOf: "q", name: `x:${type}/query`, path: "/ids" }, ...(properties ? { properties } : {}) }, "g"]])43 return (r[1][1].list as Record<string, any>[]) ?? []44}4546export async function listDomains() {47 const r = await adminCall([["x:Domain/get", { ids: null, properties: ["name", "enable", "description"] }, "d"]])48 return r[0][1].list as { id: string; name: string; enable: boolean }[]49}5051/** Crée un compte Stalwart avec un mot de passe aléatoire (jamais montré à personne) et rend son identifiant. */52export async function createAccount(address: string, description: string): Promise<{ id: string; secret: string }> {53 const [local, domain] = address.toLowerCase().split("@")54 const dom = (await listDomains()).find((d) => d.name === domain)55 if (!dom) throw bad("unknown_domain", 400, `Domain ${domain} is not hosted here`)56 const existing = await getAll("Account", ["emailAddress", "aliases", "name"])57 if (existing.some((a) => a.emailAddress === address.toLowerCase())) throw bad("address_taken", 409)58 const secret = crypto.randomBytes(30).toString("base64url")59 const r = await adminCall([["x:Account/set", { create: { n: { "@type": "User", name: local, domainId: dom.id, description, credentials: { "0": { "@type": "Password", secret } } } } }, "c"]])60 const created = (r[0][1].created as Record<string, { id: string }> | undefined)?.n61 if (!created) throw bad("mail_server_error", 502, JSON.stringify(r[0][1].notCreated ?? {}).slice(0, 300))62 return { id: created.id, secret }63}6465/** Remplace le mot de passe d'un compte existant (rotation ou adoption d'un compte créé hors SP Mail). */66export async function rotateSecret(stalwartId: string): Promise<string> {67 const secret = crypto.randomBytes(30).toString("base64url")68 const r = await adminCall([["x:Account/set", { update: { [stalwartId]: { credentials: { "0": { "@type": "Password", secret } } } } }, "u"]])69 if (!(r[0][1].updated && stalwartId in (r[0][1].updated as object))) throw bad("mail_server_error", 502, JSON.stringify(r[0][1].notUpdated ?? {}).slice(0, 300))70 return secret71}7273export async function destroyAccount(stalwartId: string) {74 await adminCall([["x:Account/set", { destroy: [stalwartId] }, "d"]])75}7677export async function setAliases(stalwartId: string, aliases: string[]) {78 const doms = await listDomains()79 const value: Record<string, unknown> = {}80 aliases.forEach((a, i) => {81 const [local, domain] = a.toLowerCase().split("@")82 const dom = doms.find((d) => d.name === domain)83 if (!dom) throw bad("unknown_domain", 400, `Domain ${domain} is not hosted here`)84 value[String(i)] = { name: local, domainId: dom.id }85 })86 const r = await adminCall([["x:Account/set", { update: { [stalwartId]: { aliases: value } } }, "u"]])87 if (!(r[0][1].updated && stalwartId in (r[0][1].updated as object))) throw bad("mail_server_error", 502, JSON.stringify(r[0][1].notUpdated ?? {}).slice(0, 300))88}8990// ------------------------------------------------------------------ extensions pour /api/v1 (adresses, quotas, listes)91const setOk = (r: Call[], kind: "created" | "updated" | "destroyed", id: string) => {92 const v = r[0][1][kind] as Record<string, unknown> | string[] | undefined93 return Array.isArray(v) ? v.includes(id) : !!v && id in v94}95const setErr = (r: Call[]) => JSON.stringify(r[0][1].notCreated ?? r[0][1].notUpdated ?? r[0][1].notDestroyed ?? {}).slice(0, 300)9697let domainCache: { at: number; list: { id: string; name: string; enable: boolean }[] } | undefined98/** Domaines hébergés (cache 60 s). */99export async function hostedDomains(fresh = false) {100 if (!fresh && domainCache && Date.now() - domainCache.at < 60_000) return domainCache.list101 domainCache = { at: Date.now(), list: await listDomains() }102 return domainCache.list103}104export async function domainIdOf(address: string): Promise<string> {105 const domain = address.split("@")[1]106 const dom = (await hostedDomains()).find((d) => d.name === domain) ?? (await hostedDomains(true)).find((d) => d.name === domain)107 if (!dom) throw bad("unknown_domain", 400, `Domain ${domain} is not hosted here`)108 return dom.id109}110export async function domainNameById(id: string): Promise<string | undefined> {111 return ((await hostedDomains()).find((d) => d.id === id) ?? (await hostedDomains(true)).find((d) => d.id === id))?.name112}113114export type StalwartAlias = { name: string; domainId: string; enable?: boolean; description?: string | null }115export type StalwartAccount = {116 id: string; name: string; emailAddress: string; aliases: Record<string, StalwartAlias>; quotas: Record<string, number>117 permissions: { "@type": string; enabledPermissions?: Record<string, boolean>; disabledPermissions?: Record<string, boolean> }; usedDiskQuota?: number118}119export async function getAccount(stalwartId: string): Promise<StalwartAccount | null> {120 const r = await adminCall([["x:Account/get", { ids: [stalwartId], properties: ["name", "emailAddress", "aliases", "quotas", "permissions", "usedDiskQuota"] }, "g"]])121 return ((r[0][1].list as StalwartAccount[]) ?? [])[0] ?? null122}123export async function updateAccount(stalwartId: string, patch: Record<string, unknown>) {124 const r = await adminCall([["x:Account/set", { update: { [stalwartId]: patch } }, "u"]])125 if (!setOk(r, "updated", stalwartId)) throw bad("mail_server_error", 502, setErr(r))126}127128// Listes de diffusion Stalwart : un alias à plusieurs destinations locales.129export type StalwartList = { id: string; name: string; domainId: string; emailAddress: string; recipients: Record<string, boolean> }130export async function getList(id: string): Promise<StalwartList | null> {131 const r = await adminCall([["x:MailingList/get", { ids: [id] }, "g"]])132 return ((r[0][1].list as StalwartList[]) ?? [])[0] ?? null133}134export async function createList(address: string, recipients: string[]): Promise<string> {135 const r = await adminCall([["x:MailingList/set", { create: { n: { name: address.split("@")[0], domainId: await domainIdOf(address), recipients: Object.fromEntries(recipients.map((a) => [a, true])) } } }, "c"]])136 const id = (r[0][1].created as Record<string, { id: string }> | undefined)?.n?.id137 if (!id) throw bad("mail_server_error", 502, setErr(r))138 return id139}140export async function updateList(id: string, recipients: string[]) {141 const r = await adminCall([["x:MailingList/set", { update: { [id]: { recipients: Object.fromEntries(recipients.map((a) => [a, true])) } } }, "u"]])142 if (!setOk(r, "updated", id)) throw bad("mail_server_error", 502, setErr(r))143}144export async function destroyList(id: string) {145 await adminCall([["x:MailingList/set", { destroy: [id] }, "d"]])146}147