SPB Git

Repository Public

addresses.ts 18.7 KB 367 lines typescript

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
Files main
Menu

Theme