Repository Public
1// Logique pure de la section « Adresses » de la console : filtres, état affiché, formulaire → corps des requêtes de2// /api/v1/addresses (création par nature, modification par différence), bornes de l'avatar, destinations, quotas.3// Aucun accès au DOM ni au réseau : tout est testé dans addresses.test.ts.4import { isValidEmail } from "../mail/address"5import type { AddressKind, ApiAddress } from "../mail/v1"67// ---------------------------------------------------------------- natures8export const PHYSICAL_KINDS: readonly AddressKind[] = ["mailbox", "shared"]9export const ALIAS_LIKE_KINDS: readonly AddressKind[] = ["alias", "notification", "send_only", "receive_only", "temporary"]10export const ALL_KINDS: readonly AddressKind[] = [...PHYSICAL_KINDS, ...ALIAS_LIKE_KINDS]11export const isPhysicalKind = (k: string): boolean => (PHYSICAL_KINDS as readonly string[]).includes(k)1213/**14 * Natures vers lesquelles l'API accepte de convertir une adresse (PATCH `kind`) : entre natures de type alias seulement.15 * Une boîte ne devient pas un alias, ni l'inverse (`400 kind_change_unsupported`) ; « partagée » découle des accès accordés.16 */17export function convertibleKinds(kind: AddressKind): AddressKind[] {18 return isPhysicalKind(kind) ? [kind] : [...ALIAS_LIKE_KINDS]19}2021// ---------------------------------------------------------------- filtre de la liste22export type AddressFilter = "all" | "mailboxes" | "aliases" | "shared" | "temporary"23export const ADDRESS_FILTERS: readonly AddressFilter[] = ["all", "mailboxes", "aliases", "shared", "temporary"]2425type Listed = Pick<ApiAddress, "address" | "kind" | "mailbox" | "display_name">26export function matchesFilter(a: Listed, filter: AddressFilter, query = ""): boolean {27 const byKind =28 filter === "all" ? true29 : filter === "mailboxes" ? isPhysicalKind(a.kind)30 : filter === "shared" ? a.kind === "shared"31 : filter === "temporary" ? a.kind === "temporary"32 : !isPhysicalKind(a.kind)33 if (!byKind) return false34 const q = query.trim().toLowerCase()35 if (!q) return true36 return [a.address, a.mailbox ?? "", a.display_name ?? ""].some((s) => s.toLowerCase().includes(q))37}38export function countByFilter(list: readonly Listed[]): Record<AddressFilter, number> {39 const out = { all: 0, mailboxes: 0, aliases: 0, shared: 0, temporary: 0 }40 for (const a of list) for (const f of ADDRESS_FILTERS) if (matchesFilter(a, f)) out[f]++41 return out42}4344// ---------------------------------------------------------------- état et expiration45export type AddressState = "active" | "suspended" | "expired"46/** État affiché : l'expiration prime (l'API refuse l'adresse dès l'échéance, avant même le passage du robot horaire). */47export function addressState(a: Pick<ApiAddress, "status" | "expired" | "expires_at">, now = Date.now()): AddressState {48 if (a.expired || (a.expires_at !== null && Date.parse(a.expires_at) <= now)) return "expired"49 return a.status === "suspended" ? "suspended" : "active"50}5152export type Expiry = { kind: "none" } | { kind: "past" } | { kind: "soon" | "later"; days: number }53const DAY = 86_400_00054/** Échéance : aucune, passée, proche (≤ 7 jours) ou lointaine ; `days` = jours entiers restants, arrondis vers le haut. */55export function expiryInfo(expiresAt: string | null, now = Date.now()): Expiry {56 if (!expiresAt) return { kind: "none" }57 const at = Date.parse(expiresAt)58 if (Number.isNaN(at)) return { kind: "none" }59 if (at <= now) return { kind: "past" }60 const days = Math.ceil((at - now) / DAY)61 return { kind: days <= 7 ? "soon" : "later", days }62}6364// ---------------------------------------------------------------- dates (champ datetime-local ↔ ISO)65const pad = (n: number) => String(n).padStart(2, "0")66/** ISO → valeur d'un champ `datetime-local`, en heure locale ; "" si absent ou illisible. */67export function isoToLocalInput(iso: string | null): string {68 if (!iso) return ""69 const d = new Date(iso)70 if (Number.isNaN(d.getTime())) return ""71 return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}T${pad(d.getHours())}:${pad(d.getMinutes())}`72}73/** Valeur d'un champ `datetime-local` (heure locale) → ISO ; null si vide ou illisible. */74export function localInputToIso(local: string): string | null {75 if (!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}/.test(local.trim())) return null76 const d = new Date(local.trim())77 return Number.isNaN(d.getTime()) ? null : d.toISOString()78}7980// ---------------------------------------------------------------- destinations supplémentaires81export const MAX_DESTINATIONS = 2082/** Découpe une saisie libre (virgules, points-virgules, espaces, retours) en adresses normalisées, sans doublon. */83export function parseDestinations(text: string): { list: string[]; invalid: string[] } {84 const list: string[] = []85 const invalid: string[] = []86 for (const raw of text.split(/[\s,;]+/)) {87 const s = raw.trim().toLowerCase()88 if (!s) continue89 if (!isValidEmail(s)) invalid.push(s)90 else if (!list.includes(s)) list.push(s)91 }92 return { list, invalid }93}9495export type FormError =96 | "address_invalid" | "mailbox_required" | "owner_required" | "expires_required" | "expires_invalid" | "expires_past"97 | "destinations_invalid" | "destinations_too_many" | "destination_self" | "destination_unknown" | "destinations_need_receive"98 | "days_invalid" | "quota_invalid" | "name_too_long" | "signature_too_long" | "html_too_long"99export type Result<T> = { ok: true; value: T } | { ok: false; error: FormError; detail?: string }100const fail = (error: FormError, detail?: string): Result<never> => ({ ok: false, error, detail })101102/** Les destinations doivent être des adresses locales connues, hors l'adresse elle-même et sa propre boîte. */103function checkDestinations(text: string, self: string, mailbox: string, known: ReadonlySet<string> | null): Result<string[]> {104 const { list, invalid } = parseDestinations(text)105 if (invalid.length) return fail("destinations_invalid", invalid.join(", "))106 if (list.length > MAX_DESTINATIONS) return fail("destinations_too_many")107 const own = list.find((d) => d === self || d === mailbox)108 if (own) return fail("destination_self", own)109 const unknown = known ? list.filter((d) => !known.has(d)) : []110 if (unknown.length) return fail("destination_unknown", unknown.join(", "))111 return { ok: true, value: list }112}113114// ---------------------------------------------------------------- création115export interface CreateForm {116 kind: AddressKind117 address: string118 displayName: string119 /** natures de type alias : adresse principale de la boîte cible */120 mailbox: string121 /** boîtes : utilisateur propriétaire ("" = l'administrateur connecté) */122 ownerId: string123 /** saisie libre d'adresses locales */124 destinations: string125 replyPolicy: ApiAddress["reply_policy"]126 /** valeur du champ datetime-local */127 expiresLocal: string128}129export const emptyCreateForm = (kind: AddressKind = "alias"): CreateForm => ({ kind, address: "", displayName: "", mailbox: "", ownerId: "", destinations: "", replyPolicy: "reject", expiresLocal: "" })130131export type CreatePayload = { address: string; kind: AddressKind; display_name?: string; mailbox?: string; user_id?: string; extra_destinations?: string[]; reply_policy?: ApiAddress["reply_policy"]; expires_at?: string }132133/**134 * Corps de `POST /api/v1/addresses` selon la nature. `known` = adresses locales connues (contrôle des destinations) ;135 * null = pas de contrôle local (l'API tranche : `400 invalid_destination`).136 */137export function buildCreatePayload(f: CreateForm, known: ReadonlySet<string> | null = null, now = Date.now()): Result<CreatePayload> {138 const address = f.address.trim().toLowerCase()139 if (!isValidEmail(address)) return fail("address_invalid")140 const name = f.displayName.trim()141 if (name.length > 80) return fail("name_too_long")142 const out: CreatePayload = { address, kind: f.kind }143 if (name) out.display_name = name144145 if (isPhysicalKind(f.kind)) {146 if (f.ownerId) out.user_id = f.ownerId147 return { ok: true, value: out }148 }149150 const mailbox = f.mailbox.trim().toLowerCase()151 if (!mailbox) return fail("mailbox_required")152 out.mailbox = mailbox153154 if (f.kind === "send_only") out.reply_policy = f.replyPolicy155 else {156 const dest = checkDestinations(f.destinations, address, mailbox, known)157 if (!dest.ok) return dest158 if (dest.value.length) out.extra_destinations = dest.value159 }160161 if (f.expiresLocal.trim()) {162 const iso = localInputToIso(f.expiresLocal)163 if (!iso) return fail("expires_invalid")164 if (Date.parse(iso) <= now) return fail("expires_past")165 out.expires_at = iso166 } else if (f.kind === "temporary") return fail("expires_required")167 return { ok: true, value: out }168}169170// ---------------------------------------------------------------- modification171export interface EditForm {172 kind: AddressKind173 displayName: string174 signatureText: string175 signatureHtml: string176 avatar: string | null177 canSend: boolean178 canReceive: boolean179 status: ApiAddress["status"]180 expiresLocal: string181 retentionDays: string182 retentionTrashDays: string183 retentionJunkDays: string184 /** quota en gigaoctets décimaux ("" = aucun) */185 quotaGb: string186 replyPolicy: ApiAddress["reply_policy"]187 destinations: string188}189const numText = (n: number | null) => (n === null ? "" : String(n))190export const bytesToGb = (bytes: number | null): string => (bytes === null ? "" : String(Math.round(bytes / 1e6) / 1000))191/** Gigaoctets saisis (virgule ou point) → octets ; null = aucun quota ; NaN si illisible ou hors bornes de l'API (1 Mo – 1 To). */192export function gbToBytes(text: string): number | null {193 const s = text.trim().replace(",", ".")194 if (!s) return null195 if (!/^\d+(\.\d+)?$/.test(s)) return Number.NaN196 const bytes = Math.round(Number(s) * 1e9)197 return bytes >= 1_000_000 && bytes <= 1_000_000_000_000 ? bytes : Number.NaN198}199/** Nombre de jours (1 – 36 500) ; null = vide ; NaN si invalide. */200export function parseDays(text: string): number | null {201 const s = text.trim()202 if (!s) return null203 if (!/^\d+$/.test(s)) return Number.NaN204 const n = Number(s)205 return n >= 1 && n <= 36_500 ? n : Number.NaN206}207208export function editFormOf(a: ApiAddress): EditForm {209 return {210 kind: a.kind, displayName: a.display_name, signatureText: a.signature_text, signatureHtml: a.signature_html, avatar: a.avatar, canSend: a.can_send, canReceive: a.can_receive,211 status: a.status, expiresLocal: isoToLocalInput(a.expires_at), retentionDays: numText(a.retention_days), retentionTrashDays: numText(a.retention_trash_days),212 retentionJunkDays: numText(a.retention_junk_days), quotaGb: bytesToGb(a.quota_bytes), replyPolicy: a.reply_policy, destinations: a.extra_destinations.join("\n"),213 }214}215216export type AddressPatch = Partial<Pick<ApiAddress,217 "kind" | "display_name" | "signature_text" | "signature_html" | "avatar" | "can_send" | "can_receive" | "status" | "expires_at" | "retention_days" | "retention_trash_days"218 | "retention_junk_days" | "quota_bytes" | "reply_policy" | "extra_destinations">>219220/** Champs qu'une adresse protégée refuse de voir changer (`403 protected_address`). */221export const PROTECTED_LOCKED: readonly (keyof AddressPatch)[] = ["status", "kind", "can_receive", "expires_at", "retention_days", "retention_trash_days", "retention_junk_days", "reply_policy", "extra_destinations"]222223const sameList = (a: readonly string[], b: readonly string[]) => a.length === b.length && a.every((x, i) => x === b[i])224225/**226 * Corps de `PATCH /api/v1/addresses/{id}` : uniquement ce qui a changé, selon les règles de cohérence par nature227 * (envoi/réception imposés pour « envoi seul » et « réception seule », quota et conservation sur les boîtes seulement,228 * destinations sur les natures de type alias qui reçoivent, échéance obligatoire pour une adresse temporaire).229 */230export function buildPatch(a: ApiAddress, f: EditForm, known: ReadonlySet<string> | null = null): Result<AddressPatch> {231 const patch: AddressPatch = {}232 const physical = isPhysicalKind(a.kind)233 const kind = physical ? a.kind : f.kind234 if (kind !== a.kind) patch.kind = kind235236 const name = f.displayName.trim()237 if (name.length > 80) return fail("name_too_long")238 if (f.signatureText.length > 4000) return fail("signature_too_long")239 if (f.signatureHtml.length > 20_000) return fail("html_too_long")240 if (name !== a.display_name) patch.display_name = name241 if (f.signatureText !== a.signature_text) patch.signature_text = f.signatureText242 if (f.signatureHtml !== a.signature_html) patch.signature_html = f.signatureHtml243 if (f.avatar !== a.avatar) patch.avatar = f.avatar244 if (f.status !== a.status) patch.status = f.status245246 // « envoi seul » et « réception seule » fixent les deux permissions côté serveur : on ne les envoie pas247 const forced = kind === "send_only" || kind === "receive_only"248 if (!forced) {249 if (f.canSend !== a.can_send) patch.can_send = f.canSend250 if (f.canReceive !== a.can_receive) patch.can_receive = f.canReceive251 }252 const receives = kind === "send_only" ? false : kind === "receive_only" ? true : f.canReceive253 if (f.replyPolicy !== a.reply_policy) patch.reply_policy = f.replyPolicy254255 if (physical) {256 const days: [keyof AddressPatch & ("retention_days" | "retention_trash_days" | "retention_junk_days"), string][] = [["retention_days", f.retentionDays], ["retention_trash_days", f.retentionTrashDays], ["retention_junk_days", f.retentionJunkDays]]257 for (const [key, text] of days) {258 const n = parseDays(text)259 if (Number.isNaN(n)) return fail("days_invalid")260 if (n !== a[key]) patch[key] = n261 }262 const quota = gbToBytes(f.quotaGb)263 if (Number.isNaN(quota)) return fail("quota_invalid")264 // le champ arrondit au mégaoctet : un quota inchangé à l'affichage n'est pas renvoyé265 if (f.quotaGb.trim().replace(",", ".") !== bytesToGb(a.quota_bytes)) patch.quota_bytes = quota266 } else {267 const dest = checkDestinations(f.destinations, a.address, a.mailbox, known)268 if (!dest.ok) return dest269 if (dest.value.length && !receives) return fail("destinations_need_receive")270 if (!sameList(dest.value, a.extra_destinations)) patch.extra_destinations = dest.value271 }272273 const expires = f.expiresLocal.trim() ? localInputToIso(f.expiresLocal) : null274 if (f.expiresLocal.trim() && !expires) return fail("expires_invalid")275 if (kind === "temporary" && !expires) return fail("expires_required")276 if (f.expiresLocal.trim() !== isoToLocalInput(a.expires_at)) patch.expires_at = expires277 return { ok: true, value: patch }278}279export const patchIsEmpty = (p: AddressPatch) => Object.keys(p).length === 0280281// ---------------------------------------------------------------- suppression282export type DeleteMode = "alias" | "detach" | "purge"283export const PURGE_TOKEN = "delete-all-mail"284/** Requête `DELETE /api/v1/addresses/{id}` : alias retiré, boîte détachée (courrier conservé) ou purgée (courrier détruit). */285export function deleteRequest(id: string, mode: DeleteMode): { path: string; json?: { confirm: string } } {286 const base = `/addresses/${encodeURIComponent(id)}`287 return mode === "purge" ? { path: `${base}?purge=${PURGE_TOKEN}`, json: { confirm: PURGE_TOKEN } } : { path: base }288}289290// ---------------------------------------------------------------- avatar291/** L'API borne la chaîne `data:` entière à 90 000 caractères (PNG, JPEG ou WebP en base64). */292export const AVATAR_MAX_CHARS = 90_000293export const AVATAR_RE = /^data:image\/(png|jpeg|webp);base64,[A-Za-z0-9+/=]+$/294export const avatarFits = (dataUrl: string): boolean => dataUrl.length <= AVATAR_MAX_CHARS && AVATAR_RE.test(dataUrl)295/** Octets décodés d'une URL `data:` en base64 (0 si ce n'en est pas une). */296export function dataUrlBytes(dataUrl: string): number {297 const i = dataUrl.indexOf(";base64,")298 if (i < 0) return 0299 const b64 = dataUrl.slice(i + 8)300 const padding = b64.endsWith("==") ? 2 : b64.endsWith("=") ? 1 : 0301 return Math.max(0, Math.floor((b64.length * 3) / 4) - padding)302}303/** Plus gros fichier (octets) qui tient sous la borne une fois encodé en base64 avec son préfixe. */304export function maxAvatarBytes(mime: string): number {305 const prefix = `data:${mime};base64,`.length306 return Math.floor((AVATAR_MAX_CHARS - prefix) / 4) * 3307}308/** Dimensions réduites pour tenir dans un carré de `max` pixels, proportions gardées, sans jamais agrandir. */309export function fitWithin(width: number, height: number, max: number): { width: number; height: number } {310 if (!(width > 0) || !(height > 0)) return { width: 0, height: 0 }311 const k = Math.min(1, max / Math.max(width, height))312 return { width: Math.max(1, Math.round(width * k)), height: Math.max(1, Math.round(height * k)) }313}314export interface AvatarStep {315 size: number316 quality: number317}318/** Essais successifs de réduction : du plus fin au plus petit, jusqu'à passer sous la borne. */319export const AVATAR_STEPS: readonly AvatarStep[] = [{ size: 256, quality: 0.9 }, { size: 192, quality: 0.85 }, { size: 128, quality: 0.85 }, { size: 96, quality: 0.8 }, { size: 64, quality: 0.8 }, { size: 48, quality: 0.7 }]320/** Premier rendu qui respecte la borne de l'API ; null si aucun (image illisible, format refusé par le navigateur). */321export function pickAvatar(render: (step: AvatarStep) => string | null, steps: readonly AvatarStep[] = AVATAR_STEPS): string | null {322 for (const step of steps) {323 const url = render(step)324 if (url && avatarFits(url)) return url325 }326 return null327}328329// ---------------------------------------------------------------- quota et clés330/** Part du quota utilisée (0 – 1, plafonnée) ; null sans quota ou sans mesure. */331export function usageRatio(usedBytes: number | null, quotaBytes: number | null): number | null {332 if (usedBytes === null || quotaBytes === null || quotaBytes <= 0) return null333 return Math.min(1, Math.max(0, usedBytes / quotaBytes))334}335336export interface KeyRef {337 id: string338 name: string339 prefix: string340 state: string341 scopes: string[]342 address_ids: string[]343 all_addresses: boolean344}345/** Clés d'API autorisées à agir pour cette adresse : liste explicite, ou clé « toutes les adresses ». */346export function keysForAddress<K extends Pick<KeyRef, "address_ids" | "all_addresses">>(keys: readonly K[], addressId: string): K[] {347 return keys.filter((k) => k.all_addresses || k.address_ids.includes(addressId))348}349350// ---------------------------------------------------------------- accès partagés351export interface Grant {352 user_id: string353 can_read: boolean354 can_send: boolean355}356/** Liste envoyée à `PUT /api/admin/mailboxes/{id}/grants` : sans le propriétaire, sans doublon ni ligne vide. */357export function normaliseGrants(grants: readonly Grant[], ownerId: string | null): Grant[] {358 const seen = new Set<string>()359 const out: Grant[] = []360 for (const g of grants) {361 if (g.user_id === ownerId || seen.has(g.user_id) || !(g.can_read || g.can_send)) continue362 seen.add(g.user_id)363 out.push({ user_id: g.user_id, can_read: g.can_read, can_send: g.can_send })364 }365 return out366}367