Repository Public
1// SP Mail Next — petites collections synchronisées (libellés, recherches enregistrées, réglages d'IA…) : magasin, copie IndexedDB,2// relecture au retour sur l'onglet et après un changement d'état du courrier ; garde de génération contre les réponses tardives.3import { cacheGet, cachePut } from "../state/cache"4import { createStore, useStore, type Store } from "../state/store"5import { isAbort, toNextError, type NextErrorKind } from "./api"67export interface CollectionState<T> {8 items: T[]9 /** au moins une lecture (cache ou serveur) a abouti */10 loaded: boolean11 /** contenu issu du cache, pas encore confirmé par le serveur */12 stale: boolean13 loading: boolean14 error: NextErrorKind | null15}16export interface Collection<T> {17 store: Store<CollectionState<T>>18 /** lit le cache (première fois) puis le serveur ; les appels concurrents partagent la même requête */19 refresh: () => Promise<void>20 /** applique une modification locale (optimiste ou réponse d'une écriture) et la met en cache */21 mutate: (fn: (items: T[]) => T[]) => void22 use: () => T[]23 reset: () => void24}25const all: Collection<unknown>[] = []2627export function createCollection<T>(key: string, fetcher: () => Promise<T[]>): Collection<T> {28 const store = createStore<CollectionState<T>>({ items: [], loaded: false, stale: false, loading: false, error: null })29 let gen = 030 let flight: Promise<void> | null = null31 const cacheKey = `next:${key}`32 const refresh = (): Promise<void> => {33 if (flight) return flight34 const my = ++gen35 flight = (async () => {36 store.set({ loading: true })37 if (!store.get().loaded) {38 const cached = await cacheGet<T[]>(cacheKey)39 if (my === gen && cached && !store.get().loaded) store.set({ items: cached, loaded: true, stale: true })40 }41 try {42 const items = await fetcher()43 if (my !== gen) return44 store.set({ items, loaded: true, stale: false, loading: false, error: null })45 void cachePut(cacheKey, items)46 } catch (e) {47 if (my !== gen || isAbort(e)) return48 store.set({ loading: false, error: toNextError(e).kind })49 }50 })().finally(() => {51 flight = null52 })53 return flight54 }55 const c: Collection<T> = {56 store,57 refresh,58 mutate(fn) {59 // une écriture locale périme toute lecture en vol (elle rendrait l'état d'avant)60 gen++61 flight = null62 const items = fn(store.get().items)63 store.set({ items, loaded: true, loading: false })64 void cachePut(cacheKey, items)65 },66 use: () => useStore(store, (s) => s.items),67 reset() {68 gen++69 flight = null70 store.set({ items: [], loaded: false, stale: false, loading: false, error: null })71 },72 }73 all.push(c as Collection<unknown>)74 return c75}76/** Relit toutes les collections déjà chargées (retour sur l'onglet, changement d'état du courrier). */77export function refreshCollections() {78 for (const c of all) if (c.store.get().loaded) void c.refresh()79}80/** Perte de session : rien ne doit survivre en mémoire (le cache IndexedDB est effacé par state/session.ts). */81export function resetCollections() {82 for (const c of all) c.reset()83}84