SPB Git

Repository Public

collection.ts 3.1 KB 84 lines typescript

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

Theme