SPB Git

Repository Public

unified.ts 6.3 KB 121 lines typescript

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

Theme