Repository Public
1// Erreurs du transport et du protocole, et leur traduction en message pour la personne.2import type { SetError } from "./types"34/** Réponse HTTP non 2xx de la passerelle ou de l'API SP Mail (`{error, message}`). */5export class HttpError extends Error {6 constructor(7 public status: number,8 public code: string,9 message?: string,10 /** `details` de l'enveloppe /api/v1 (problèmes de validation, limites…) */11 public details?: unknown,12 ) {13 super(message ?? code)14 this.name = "HttpError"15 }16}17/** Le réseau ou le serveur est injoignable (aucune réponse HTTP). */18export class NetworkError extends Error {19 constructor(message = "network") {20 super(message)21 this.name = "NetworkError"22 }23}24/** Réponse « error » d'une méthode JMAP (RFC 8620 §3.6.2). */25export class JmapMethodError extends Error {26 constructor(27 public method: string,28 public type: string,29 public description?: string,30 ) {31 super(`${method}: ${type}${description ? ` — ${description}` : ""}`)32 this.name = "JmapMethodError"33 }34}35/** Refus d'un objet dans un /set (notCreated / notUpdated / notDestroyed). */36export class JmapSetError extends Error {37 constructor(38 public method: string,39 public error: SetError,40 ) {41 super(`${method}: ${error.type}${error.description ? ` — ${error.description}` : ""}`)42 this.name = "JmapSetError"43 }44}4546export type ErrorKind = "offline" | "unauthorized" | "forbidden" | "notFound" | "tooLarge" | "rateLimited" | "mailServer" | "invalid" | "quota" | "conflict" | "unknown"4748export function errorKind(e: unknown): ErrorKind {49 if (e instanceof NetworkError) return "offline"50 if (e instanceof HttpError) {51 if (e.status === 401) return "unauthorized"52 if (e.status === 403) return "forbidden"53 if (e.status === 404) return "notFound"54 if (e.status === 409) return "conflict"55 if (e.status === 413) return "tooLarge"56 if (e.status === 429) return "rateLimited"57 if (e.status === 502 || e.status === 503 || e.status === 504) return "mailServer"58 if (e.status === 400) return "invalid"59 return "unknown"60 }61 const type = e instanceof JmapMethodError ? e.type : e instanceof JmapSetError ? e.error.type : ""62 switch (type) {63 case "overQuota":64 case "maxQuotaReached":65 return "quota"66 case "tooLarge":67 case "requestTooLarge":68 return "tooLarge"69 case "notFound":70 case "blobNotFound":71 return "notFound"72 case "forbidden":73 case "forbiddenFrom":74 case "forbiddenToSend":75 case "accountReadOnly":76 return "forbidden"77 case "rateLimit":78 return "rateLimited"79 case "serverUnavailable":80 case "serverFail":81 return "mailServer"82 case "invalidArguments":83 case "invalidProperties":84 case "invalidScript":85 case "invalidEmail":86 case "invalidRecipients":87 case "noRecipients":88 case "tooManyRecipients":89 return "invalid"90 case "stateMismatch":91 case "alreadyExists":92 case "mailboxHasChild":93 case "mailboxHasEmail":94 return "conflict"95 default:96 return "unknown"97 }98}99100/** Détail technique court à afficher sous le message traduit (jamais de contenu de message). */101export function errorDetail(e: unknown): string {102 if (e instanceof JmapSetError) return e.error.description ?? e.error.type103 if (e instanceof JmapMethodError) return e.description ?? e.type104 if (e instanceof HttpError) return e.message !== e.code ? e.message : e.code105 return ""106}107