SPB Git

Repository Public

app.ts 17.8 KB 419 lines typescript

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

Theme