Repository Public
1// « Toutes les boîtes » : logique pure de la liste unifiée bâtie sur GET /api/v1/messages (fusion multi-boîtes, curseur2// composite) — requête d'une vue, fusion des pages, adresse de réception d'un message, couleur stable par adresse,3// passage d'un identifiant /api/v1 à l'identifiant JMAP de la boîte (pour rouvrir le message dans le lecteur).4import { sameEmail } from "./address"5import type { V1Message, V1Page } from "./v1"67export type UnifiedView = "inbox" | "unread" | "starred" | "drafts" | "sent" | "scheduled"8/** Vue par boîte dans laquelle s'ouvre un message d'une vue unifiée (dossiers, compteurs et actions du lecteur). */9export const MAILBOX_VIEW: Record<UnifiedView, string> = { inbox: "inbox", unread: "inbox", starred: "flagged", drafts: "drafts", sent: "sent", scheduled: "sent" }1011export const UNIFIED_PAGE = 501213/** Paramètres de GET /api/v1/messages pour une vue. `addresses` : adresses principales des boîtes retenues (vide = toutes). */14export function unifiedQuery(view: Exclude<UnifiedView, "scheduled">, addresses: readonly string[], cursor: string | null, limit = UNIFIED_PAGE): string {15 const q = new URLSearchParams()16 if (view === "inbox" || view === "unread") q.set("folder", "inbox")17 if (view === "drafts") q.set("folder", "drafts")18 if (view === "sent") q.set("folder", "sent")19 if (view === "unread") q.set("unread", "true")20 if (view === "starred") q.set("flagged", "true")21 if (addresses.length) q.set("address", [...addresses].sort().join(","))22 q.set("limit", String(limit))23 if (cursor) q.set("cursor", cursor)24 return q.toString()25}26/** Ce qui identifie une liste : une réponse arrivée pour une autre clé (vue ou sous-ensemble changé entre-temps) est ignorée. */27export const unifiedKey = (view: UnifiedView, addresses: readonly string[]): string => `${view}|${[...addresses].sort().join(",")}`2829/** Favoris : l'API cherche dans tous les dossiers ; la corbeille et les indésirables n'ont pas leur place dans la vue. */30export function belongsToView(view: UnifiedView, m: Pick<V1Message, "folders">): boolean {31 if (view !== "starred") return true32 return !m.folders.some((f) => f.role === "trash" || f.role === "junk")33}3435export interface UnifiedList {36 key: string37 rows: V1Message[]38 /** curseur de la page suivante ; null = fin de liste (ou rien de chargé) */39 cursor: string | null40 hasMore: boolean41}42export const emptyUnified = (key: string): UnifiedList => ({ key, rows: [], cursor: null, hasMore: false })4344/**45 * Ajoute une page à la liste. Le curseur est opaque : on le garde tel quel et on le rend à l'API pour la page suivante.46 * Une page peut être plus courte que demandé — voire vide — alors que `has_more` est vrai (vues restreintes) : on continue47 * tant que l'API donne un curseur. Un message déjà présent (arrivé entre deux pages, ou relu) n'est jamais doublé.48 * `reset` : la page est la première d'une relecture, elle remplace la liste.49 */50export function appendPage(list: UnifiedList, key: string, page: V1Page<V1Message>, view: UnifiedView, reset = false): UnifiedList {51 if (key !== list.key) return list52 const base = reset ? [] : list.rows53 const seen = new Set(base.map((m) => m.id))54 const rows = [...base]55 for (const m of page.data) {56 if (seen.has(m.id) || !belongsToView(view, m)) continue57 seen.add(m.id)58 rows.push(m)59 }60 const cursor = page.has_more && page.next_cursor ? page.next_cursor : null61 return { key, rows, cursor, hasMore: cursor !== null }62}6364/** L'ordre de la liste : du plus récent au plus ancien (date de réception), stable à égalité. */65export function isDateOrdered(rows: readonly Pick<V1Message, "received_at">[]): boolean {66 for (let i = 1; i < rows.length; i++) if (Date.parse(rows[i - 1].received_at) < Date.parse(rows[i].received_at)) return false67 return true68}6970/**71 * Adresse qui a reçu le message, parmi les miennes : destinataire d'enveloppe (Delivered-To) d'abord, puis À/Cc, sinon72 * l'adresse principale de la boîte. Pour un message envoyé ou un brouillon : l'adresse d'expéditeur si elle est à moi.73 */74export function receivingAddress(m: Pick<V1Message, "mailbox" | "delivered_to" | "to" | "cc" | "from" | "draft" | "folders">, mine: readonly string[]): string {75 const own = (a: string) => mine.some((x) => sameEmail(x, a))76 const outgoing = m.draft || m.folders.some((f) => f.role === "sent" || f.role === "drafts")77 if (outgoing) return m.from.map((a) => a.email).find(own) ?? m.mailbox78 return m.delivered_to.find(own) ?? [...m.to, ...m.cc].map((a) => a.email).find(own) ?? m.mailbox79}8081/** Teinte (0–359) stable pour une adresse : la même adresse a toujours la même pastille, sur tous les appareils. */82export function addressHue(address: string): number {83 let h = 216613626184 const s = address.trim().toLowerCase()85 for (let i = 0; i < s.length; i++) {86 h ^= s.charCodeAt(i)87 h = Math.imul(h, 16777619)88 }89 return (h >>> 0) % 36090}9192/**93 * Identifiant /api/v1 (`msg_…`, `thr_…`) → boîte SP Mail + identifiant JMAP. Le format est celui de server/src/v1/ids.ts94 * (16 octets d'UUID de boîte puis l'identifiant JMAP, en base64url) : le webmail, client de première partie, s'en sert pour95 * rouvrir le message par la passerelle JMAP ; un identifiant illisible rend null (la ligne reste affichée, non ouvrable).96 */97export function decodeV1Id(id: string, prefix: "msg" | "thr"): { mailboxId: string; jmapId: string } | null {98 if (!id.startsWith(`${prefix}_`)) return null99 const raw = id.slice(prefix.length + 1)100 if (!/^[A-Za-z0-9_-]+$/.test(raw)) return null101 let bin: string102 try {103 bin = atob(raw.replace(/-/g, "+").replace(/_/g, "/") + "=".repeat((4 - (raw.length % 4)) % 4))104 } catch {105 return null106 }107 if (bin.length < 17) return null108 let hex = ""109 for (let i = 0; i < 16; i++) hex += bin.charCodeAt(i).toString(16).padStart(2, "0")110 const jmapId = bin.slice(16)111 if (!/^[A-Za-z0-9_-]{1,255}$/.test(jmapId)) return null112 return { mailboxId: `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`, jmapId }113}114115/** Boîtes retenues pour les vues unifiées : la préférence filtrée par les boîtes existantes ; vide = toutes. */116export function effectiveSubset(pref: readonly string[], mailboxes: readonly { id: string }[]): string[] {117 const known = new Set(mailboxes.map((m) => m.id))118 const kept = pref.filter((id) => known.has(id))119 return kept.length === mailboxes.length ? [] : kept120}121