SPB Git

Repository Public

errors.ts 3.4 KB 107 lines typescript

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

Theme