Repository Public
1// État global de l'application : identité, préférences, route, comptes, liste, fil ouvert, rédaction, notifications.2import type { ErrorKind } from "../jmap/errors"3import type { PushStatus } from "../jmap/push"4import type { DeliveryStatus, EmailFull, EmailSummary, Id, Identity, Mailbox, Quota } from "../jmap/types"5import type { Addr } from "../mail/address"6import type { ApiAddress } from "../mail/v1"7import { defaultDevice, type DevicePrefs } from "./device"8import { defaultLayout, normalizeLayout, type DashboardLayout } from "../next/dashboard"9import { createStore } from "./store"1011// ---------------------------------------------------------------- identité et préférences12export interface Me {13 user: { id: string; handle: string; display_name: string; role: "admin" | "member"; prefs: Record<string, unknown> }14 session: { id: string; kind: "web" | "native" }15 mailboxes: { id: string; address: string; display_name: string; position: number; access?: "owner" | "shared"; can_send?: boolean }[]16 version: string17}18export type Theme = "system" | "light" | "dark" | "midnight"19/** Thème effectivement appliqué (« système » résolu selon le réglage clair/sombre de l'appareil). */20export type ResolvedTheme = Exclude<Theme, "system">21export type Density = "comfortable" | "cozy" | "compact"22export type TextSize = "small" | "default" | "large" | "xlarge"23export type ReadingFont = "system" | "serif" | "mono"24export type PreviewLines = 0 | 1 | 225export type Lang = "fr" | "en"26export interface Prefs {27 /** thème effectif : celui choisi sur cet appareil (state/device.ts), à défaut celui du compte */28 theme: Theme29 density: Density30 textSize: TextSize31 /** police du texte des messages (texte brut, et HTML sans police imposée) */32 readingFont: ReadingFont33 /** lignes d'aperçu sous l'objet dans la liste */34 previewLines: PreviewLines35 /** pastille d'initiales devant chaque conversation */36 avatars: boolean37 /** thèmes sombres : afficher d'emblée les messages HTML en « lecture sombre » (modifiable message par message) */38 darkMessages: boolean39 /** null = suivre la langue du navigateur */40 lang: Lang | null41 /** politique des images distantes : bloquées (défaut) ou toujours affichées via le mandataire */42 remoteImages: "block" | "allow"43 /** expéditeurs dont les images distantes sont toujours affichées */44 trustedSenders: string[]45 /** identité de marque du studio de modèles (remplie une fois, reprise à chaque génération) */46 templateBrand: BrandKit47 /** vues « Toutes les boîtes » : boîtes retenues (identifiants) ; vide = toutes */48 unifiedMailboxes: string[]49 /** centre de commande : ordre, visibilité et largeur des widgets (next/dashboard.ts) */50 dashboard: DashboardLayout51}52/** Marque transmise au générateur de modèles (voir docs/templates-api.md, objet `brand`). */53export interface BrandKit {54 name?: string55 accent?: string56 logo_url?: string57 tone?: string58 footer?: string59 website?: string60}61export const defaultPrefs = (): Prefs => ({ theme: "system", density: "comfortable", textSize: "default", readingFont: "system", previewLines: 1, avatars: true, darkMessages: false, lang: null, remoteImages: "block", trustedSenders: [], templateBrand: {}, unifiedMailboxes: [], dashboard: defaultLayout() })6263/** Ne garde d'une marque que les champs valides pour le serveur (longueurs, couleur #rrggbb, adresses https). */64export function normalizeBrand(raw: unknown): BrandKit {65 const r = raw && typeof raw === "object" ? (raw as Record<string, unknown>) : {}66 const str = (v: unknown, max: number) => (typeof v === "string" && v.trim() ? v.trim().slice(0, max) : undefined)67 const out: BrandKit = {}68 const name = str(r.name, 80)69 if (name) out.name = name70 const accent = str(r.accent, 7)71 if (accent && /^#[0-9a-fA-F]{6}$/.test(accent)) out.accent = accent.toLowerCase()72 const logo = str(r.logo_url, 500)73 if (logo && /^https:\/\/[^\s]+\.[^\s]+$/.test(logo)) out.logo_url = logo74 const tone = str(r.tone, 200)75 if (tone) out.tone = tone76 const footer = str(r.footer, 400)77 if (footer) out.footer = footer78 const website = str(r.website, 300)79 if (website && /^https?:\/\/[^\s]+\.[^\s]+$/.test(website)) out.website = website80 return out81}8283export function normalizePrefs(raw: Record<string, unknown> | null | undefined): Prefs {84 const d = defaultPrefs()85 const r = raw ?? {}86 return {87 theme: r.theme === "light" || r.theme === "dark" || r.theme === "midnight" ? r.theme : "system",88 density: r.density === "compact" || r.density === "cozy" ? r.density : "comfortable",89 textSize: r.textSize === "small" || r.textSize === "large" || r.textSize === "xlarge" ? r.textSize : "default",90 readingFont: r.readingFont === "serif" || r.readingFont === "mono" ? r.readingFont : "system",91 previewLines: r.previewLines === 0 || r.previewLines === 2 ? r.previewLines : 1,92 avatars: r.avatars !== false,93 darkMessages: r.darkMessages === true,94 lang: r.lang === "fr" || r.lang === "en" ? r.lang : null,95 remoteImages: r.remoteImages === "allow" ? "allow" : d.remoteImages,96 trustedSenders: Array.isArray(r.trustedSenders) ? r.trustedSenders.filter((x): x is string => typeof x === "string").slice(0, 500) : [],97 templateBrand: normalizeBrand(r.templateBrand),98 unifiedMailboxes: Array.isArray(r.unifiedMailboxes) ? r.unifiedMailboxes.filter((x): x is string => typeof x === "string" && x.length <= 64).slice(0, 100) : [],99 dashboard: normalizeLayout(r.dashboard),100 }101}102103// ---------------------------------------------------------------- routes104export type Route =105 /** `all` : vue « Toutes les boîtes » (/u/…) ; `mbIndex` désigne alors la boîte du fil ouvert */106 | { name: "mail"; mbIndex: number; view: string; threadId: string | null; q: string; all?: boolean }107 | { name: "settings"; tab: string }108 | { name: "admin"; tab: string }109 /** studio de modèles : bibliothèque (id null), création par IA (create) ou éditeur d'un modèle */110 | { name: "templates"; id: string | null; create: boolean }111 | { name: "enroll" }112 /** écrans « Next » affichés dans la coquille à la place de la liste et du lecteur ; `q` = paramètres d'adresse bruts (sans « ? ») */113 | { name: "next"; page: NextPage; id: string | null; q: string }114115/** Premier segment d'adresse des écrans « Next » (tableau de bord, contacts, galerie, veille, suivis). */116export const NEXT_PAGES = ["dashboard", "contacts", "attachments", "snoozed", "followups"] as const117export type NextPage = (typeof NEXT_PAGES)[number]118119/** Vues de « Toutes les boîtes ». */120export const UNIFIED_VIEWS = ["inbox", "unread", "starred", "drafts", "sent", "scheduled"] as const121export type UnifiedView = (typeof UNIFIED_VIEWS)[number]122123export function parseRoute(pathname: string, search: string): Route {124 const seg = pathname.split("/").filter(Boolean).map(decodeURIComponent)125 if (seg[0] === "enroll") return { name: "enroll" }126 if (seg[0] === "settings") return { name: "settings", tab: seg[1] ?? "profile" }127 if (seg[0] === "admin") return { name: "admin", tab: seg[1] ?? "overview" }128 if (seg[0] === "templates") {129 if (seg[1] === "new") return { name: "templates", id: null, create: true }130 return { name: "templates", id: seg[1] && /^[0-9a-f-]{36}$/i.test(seg[1]) ? seg[1].toLowerCase() : null, create: false }131 }132 if ((NEXT_PAGES as readonly string[]).includes(seg[0] ?? "")) return { name: "next", page: seg[0] as NextPage, id: seg[1] ?? null, q: search.replace(/^\?/, "") }133 if (seg[0] === "u") {134 // `/u/search?q=…` : recherche dans toutes les boîtes (vue du module de recherche « Next », hors UNIFIED_VIEWS)135 const searching = seg[1] === "search"136 const view = searching ? "search" : (UNIFIED_VIEWS as readonly string[]).includes(seg[1] ?? "") ? seg[1] : "inbox"137 const open = seg[2] === "t" && seg[3] !== undefined && seg[4]138 return { name: "mail", all: true, mbIndex: open ? Math.max(0, Number.parseInt(seg[3], 10) || 0) : 0, view, threadId: open ? seg[4] : null, q: searching ? (new URLSearchParams(search).get("q") ?? "") : "" }139 }140 if (seg[0] === "m") {141 const mbIndex = Math.max(0, Number.parseInt(seg[1] ?? "0", 10) || 0)142 const view = seg[2] || "inbox"143 const threadId = seg[3] === "t" && seg[4] ? seg[4] : null144 return { name: "mail", mbIndex, view, threadId, q: new URLSearchParams(search).get("q") ?? "" }145 }146 return { name: "mail", mbIndex: 0, view: "inbox", threadId: null, q: "" }147}148149export function routeHref(r: Route): string {150 switch (r.name) {151 case "enroll":152 return "/enroll"153 case "settings":154 return `/settings/${encodeURIComponent(r.tab)}`155 case "admin":156 return `/admin/${encodeURIComponent(r.tab)}`157 case "next":158 return `/${r.page}${r.id ? `/${encodeURIComponent(r.id)}` : ""}${r.q ? `?${r.q}` : ""}`159 case "templates":160 return r.create ? "/templates/new" : r.id ? `/templates/${encodeURIComponent(r.id)}` : "/templates"161 case "mail": {162 if (r.all) return `/u/${encodeURIComponent(r.view)}${r.threadId ? `/t/${r.mbIndex}/${encodeURIComponent(r.threadId)}` : ""}${r.view === "search" && r.q ? `?q=${encodeURIComponent(r.q)}` : ""}`163 let p = `/m/${r.mbIndex}/${encodeURIComponent(r.view)}`164 if (r.threadId) p += `/t/${encodeURIComponent(r.threadId)}`165 if (r.q) p += `?q=${encodeURIComponent(r.q)}`166 return p167 }168 }169}170171/**172 * Les adresses gardent la forme historique `/m/<rang>/…`, mais le rang d'une boîte change quand l'administration en ajoute, en173 * retire ou les réordonne. Chaque entrée de l'historique mémorise donc l'identifiant stable de sa boîte (`history.state.mb`) :174 * s'il ne correspond plus au rang de l'adresse, c'est l'identifiant qui fait foi et l'adresse est corrigée (`redirect`).175 * Sans identifiant mémorisé (signet, lien collé), le rang est pris tel quel, borné aux boîtes existantes.176 */177export function resolveMailboxIndex(mailboxes: readonly { id: string }[], index: number, stableId: string | null | undefined): { index: number; redirect: boolean; gone: boolean } {178 if (!mailboxes.length) return { index: 0, redirect: index !== 0, gone: !!stableId }179 if (stableId) {180 const at = mailboxes.findIndex((m) => m.id === stableId)181 if (at >= 0) return { index: at, redirect: at !== index, gone: false }182 // la boîte visée n'existe plus : première boîte183 return { index: 0, redirect: true, gone: true }184 }185 if (index >= 0 && index < mailboxes.length) return { index, redirect: false, gone: false }186 return { index: 0, redirect: true, gone: false }187}188189// ---------------------------------------------------------------- comptes de courrier190export interface Account {191 id: string192 status: "loading" | "ready" | "error"193 error?: ErrorKind194 /** données issues du cache hors ligne (pas encore confirmées par le serveur) */195 stale: boolean196 folders: Mailbox[]197 identities: Identity[]198 quota: Quota[]199 mailboxState: string200 emailState: string201 push: PushStatus202}203204export interface ListState {205 /** boîte + vue + recherche : change quand on change de liste */206 key: string207 total: number | null208 /** identifiants par position ; `undefined` = pas encore chargé */209 ids: (Id | undefined)[]210 loadingFirst: boolean211 error: ErrorKind | null212 /** contenu servi par le cache hors ligne */213 stale: boolean214}215/** État de synchronisation montré par l'indicateur discret (rien quand tout est à jour). */216export interface SyncInfo {217 /** modifications envoyées au serveur, réponse attendue */218 pendingOps: number219 /** une relecture en arrière-plan est en cours (affichée seulement si elle dure) */220 busy: boolean221 /** dernière synchronisation en arrière-plan échouée et pas encore rattrapée */222 error: ErrorKind | null223 /** actions hors ligne en attente de rejeu (state/offline.ts) */224 queued?: number225}226export const emptyList = (key = ""): ListState => ({ key, total: null, ids: [], loadingFirst: true, error: null, stale: false })227228export interface OpenThread {229 /** boîte du fil : les identifiants de fil JMAP sont propres à chaque boîte (le même peut exister dans deux boîtes) */230 mb: string231 threadId: Id232 status: "loading" | "ready" | "error"233 error?: ErrorKind234 emailIds: Id[]235 emails: Record<Id, EmailFull>236 expanded: ReadonlySet<Id>237 stale: boolean238}239240// ---------------------------------------------------------------- rédaction241export interface DraftAttachment {242 key: string243 name: string244 type: string245 size: number246 blobId: Id | null247 progress: number248 error: string | null249 /** pièce reprise du message transféré (déjà sur le serveur) */250 inherited?: boolean251}252export type SendPhase = "idle" | "sending" | "error"253export interface Draft {254 key: string255 mb: string256 identityId: Id | null257 /** adresse d'expéditeur choisie (boîte ou alias) ; null = adresse de l'identité JMAP (brouillons d'avant) */258 from?: string | null259 to: Addr[]260 cc: Addr[]261 bcc: Addr[]262 showCc: boolean263 subject: string264 mode: "html" | "text"265 html: string266 text: string267 attachments: DraftAttachment[]268 inReplyTo: string[] | null269 references: string[] | null270 /** message auquel on répond / que l'on transfère (pour poser $answered / $forwarded) */271 related: { emailId: Id; kind: "reply" | "forward" } | null272 /** brouillon enregistré sur le serveur */273 draftEmailId: Id | null274 save: "clean" | "dirty" | "saving" | "saved" | "error"275 savedAt: number | null276 send: SendPhase277 sendError: string | null278 minimized: boolean279 /** incrémenté quand le contenu est remplacé par programme : l'éditeur (non contrôlé) recharge alors son HTML */280 rev: number281}282283export interface Delivery {284 key: string285 mb: string286 submissionId: Id287 /** envoi fait par /api/v1 (alias) : suivi par GET /messages/outbound/{id} */288 outboundId?: string289 subject: string290 recipients: string[]291 status: Record<string, DeliveryStatus> | null292 /** l'interrogation continue tant qu'un destinataire est « queued » */293 polling: boolean294 acceptedAt: number295}296297export interface Toast {298 id: number299 kind: "info" | "success" | "error"300 text: string301 detail?: string302 actionLabel?: string303 action?: () => void304 timeout: number305}306307export interface AppState {308 phase: "boot" | "signedOut" | "ready"309 /** la session a expiré en cours d'utilisation (on revient à la connexion sans rien perdre) */310 expired: boolean311 online: boolean312 /** l'interface est servie depuis le cache, le serveur étant injoignable */313 offlineShell: boolean314 me: Me | null315 prefs: Prefs316 lang: Lang317 route: Route318 accounts: Record<string, Account>319 /** boîte et vue affichées */320 mb: string | null321 view: string322 query: string323 list: ListState324 emails: Record<Id, EmailSummary>325 threads: Record<Id, Id[]>326 /** nombre de messages que le lecteur montrera pour un fil dans la vue courante (corbeille et brouillons écartés) */327 threadShown: Record<Id, number>328 selected: ReadonlySet<Id>329 cursor: Id | null330 open: OpenThread | null331 draft: Draft | null332 deliveries: Delivery[]333 toasts: Toast[]334 helpOpen: boolean335 navOpen: boolean336 paletteOpen: boolean337 /** préférences de cet appareil (disposition, volets, transparence) */338 device: DevicePrefs339 resolvedTheme: ResolvedTheme340 sync: SyncInfo341 contacts: Record<string, Addr[]>342 /** vue « Toutes les boîtes » affichée (la liste vient alors de state/unified.ts) */343 all: boolean344 /** adresses de l'utilisateur (GET /api/v1/addresses) ; null tant que non lues */345 addresses: ApiAddress[] | null346 /** envois externes en attente d'approbation (administrateurs seulement) */347 pendingApprovals: number348}349350export const S = createStore<AppState>({351 phase: "boot",352 expired: false,353 online: typeof navigator === "undefined" ? true : navigator.onLine,354 offlineShell: false,355 me: null,356 prefs: defaultPrefs(),357 lang: "fr",358 route: { name: "mail", mbIndex: 0, view: "inbox", threadId: null, q: "" },359 accounts: {},360 mb: null,361 view: "inbox",362 query: "",363 list: emptyList(),364 emails: {},365 threads: {},366 threadShown: {},367 selected: new Set(),368 cursor: null,369 open: null,370 draft: null,371 deliveries: [],372 toasts: [],373 helpOpen: false,374 navOpen: false,375 paletteOpen: false,376 device: defaultDevice(),377 resolvedTheme: "light",378 sync: { pendingOps: 0, busy: false, error: null },379 contacts: {},380 all: false,381 addresses: null,382 pendingApprovals: 0,383})384385// ---------------------------------------------------------------- notifications386let toastSeq = 0387export function toast(t: Omit<Toast, "id" | "timeout"> & { timeout?: number }): number {388 const id = ++toastSeq389 const timeout = t.timeout ?? (t.action || t.kind === "error" ? 6000 : 4000)390 S.set((s) => ({ toasts: [...s.toasts.slice(-3), { ...t, id, timeout }] }))391 return id392}393export function dismissToast(id: number) {394 S.set((s) => ({ toasts: s.toasts.filter((t) => t.id !== id) }))395}396397export function setAccount(mb: string, patch: Partial<Account>) {398 S.set((s) => {399 const prev: Account = s.accounts[mb] ?? { id: mb, status: "loading", stale: false, folders: [], identities: [], quota: [], mailboxState: "", emailState: "", push: "closed" }400 return { accounts: { ...s.accounts, [mb]: { ...prev, ...patch } } }401 })402}403404// ---------------------------------------------------------------- sélecteurs utiles405export const currentAccount = (s: AppState): Account | undefined => (s.mb ? s.accounts[s.mb] : undefined)406export const folderByRole = (a: Account | undefined, role: string): Mailbox | undefined => a?.folders.find((f) => f.role === role)407export const SYSTEM_ROLES = ["inbox", "drafts", "sent", "archive", "junk", "trash"] as const408export const VIRTUAL_VIEWS = ["unread", "flagged", "pinned", "search"] as const409410/** Dossier réel correspondant à une vue, s'il y en a un. */411export function folderOfView(a: Account | undefined, view: string): Mailbox | undefined {412 if (!a) return undefined413 if (view.startsWith("f:")) return a.folders.find((f) => f.id === view.slice(2))414 return a.folders.find((f) => f.role === view)415}416export function viewOfFolder(f: Mailbox): string {417 return f.role && (SYSTEM_ROLES as readonly string[]).includes(f.role) ? f.role : `f:${f.id}`418}419