SPB Git

Repository Public

push.ts 7.2 KB 153 lines typescript

1// SP Mail Next — notifications des appareils natifs (/api/next/push) : préférences, appareils, état du pipeline ; validation pure (heures calmes, expéditeurs prioritaires).2import { createStore } from "../state/store"3import { hasFeature, isAbort, nx } from "./api"45// ---------------------------------------------------------------- formes du serveur (server/src/next/push.ts fait foi)6export type Preview = "none" | "sender" | "full"7export interface QuietHours {8  start: string9  end: string10  tz: string11}12export interface PushPrefs {13  enabled: boolean14  preview: Preview15  quiet_hours: QuietHours | null16  priority_senders: string[]17  priority_only: boolean18  /** `{ "<boîte>": false }` coupe une boîte ; absente = active */19  mailboxes: Record<string, boolean>20  badge: "inbox" | "none"21}22export interface PushDevice {23  id: string24  session_id: string25  device_name: string | null26  bundle_id: string27  environment: "production" | "sandbox"28  enabled: boolean29  current: boolean30  prefs: { mailboxes?: Record<string, boolean>; sound?: boolean }31  locale: string | null32  app_version: string | null33  created_at: string | null34  last_registered_at: string | null35  last_push_at: string | null36  last_error: string | null37}38export interface PushStatus {39  configured: boolean40  queue: { pending: number; failed_24h: number; sent_24h: number }41  last_error: string | null42}43export const DEFAULT_PUSH_PREFS: PushPrefs = { enabled: true, preview: "sender", quiet_hours: null, priority_senders: [], priority_only: false, mailboxes: {}, badge: "inbox" }44export const MAX_PRIORITY_SENDERS = 2004546// ---------------------------------------------------------------- validation (pure)47const HHMM = /^([01]\d|2[0-3]):[0-5]\d$/48/** Même expression que le serveur : adresse complète ou « @domaine ». */49const SENDER = /^(@[a-z0-9.-]+\.[a-z0-9-]+|[^@\s]+@[a-z0-9.-]+\.[a-z0-9-]+)$/50export const isHHMM = (s: string): boolean => HHMM.test(s)51export function isValidTimeZone(tz: string): boolean {52  if (!tz || tz.length > 64) return false53  try {54    new Intl.DateTimeFormat("en-US", { timeZone: tz })55    return true56  } catch {57    return false58  }59}60export type QuietIssue = "start" | "end" | "same" | "tz"61/** Défaut d'une plage d'heures calmes, ou null. Une plage peut enjamber minuit ; début = fin ne couvrirait aucune minute. */62export function quietHoursIssue(q: QuietHours): QuietIssue | null {63  if (!isHHMM(q.start)) return "start"64  if (!isHHMM(q.end)) return "end"65  if (q.start === q.end) return "same"66  if (!isValidTimeZone(q.tz)) return "tz"67  return null68}69/** La plage enjambe minuit (22:00 → 07:00). */70export const spansMidnight = (q: QuietHours): boolean => isHHMM(q.start) && isHHMM(q.end) && q.start > q.end7172/** Forme enregistrée d'un expéditeur prioritaire (minuscules, sans espaces), ou null s'il n'est ni une adresse ni « @domaine ». */73export function normalizeSender(raw: string): string | null {74  const s = raw.trim().toLowerCase()75  return s.length <= 254 && SENDER.test(s) ? s : null76}77export type SenderIssue = "invalid" | "duplicate" | "full"78export function addPrioritySender(list: readonly string[], raw: string): { ok: true; list: string[] } | { ok: false; issue: SenderIssue } {79  const s = normalizeSender(raw)80  if (!s) return { ok: false, issue: "invalid" }81  if (list.includes(s)) return { ok: false, issue: "duplicate" }82  if (list.length >= MAX_PRIORITY_SENDERS) return { ok: false, issue: "full" }83  return { ok: true, list: [...list, s] }84}85/** Une boîte est active tant qu'elle n'est pas explicitement coupée. */86export const mailboxEnabled = (prefs: Pick<PushPrefs, "mailboxes">, mailboxId: string): boolean => prefs.mailboxes[mailboxId] !== false87export function setMailboxEnabled(mailboxes: Record<string, boolean>, mailboxId: string, on: boolean): Record<string, boolean> {88  const next = { ...mailboxes }89  if (on) delete next[mailboxId]90  else next[mailboxId] = false91  return next92}93/** Ne garde d'une réponse que la forme attendue (défauts du serveur pour le reste). */94export function normalizePushPrefs(raw: unknown): PushPrefs {95  const r = raw && typeof raw === "object" ? (raw as Record<string, unknown>) : {}96  const q = r.quiet_hours && typeof r.quiet_hours === "object" ? (r.quiet_hours as Record<string, unknown>) : null97  const quiet = q && typeof q.start === "string" && typeof q.end === "string" && typeof q.tz === "string" ? { start: q.start, end: q.end, tz: q.tz } : null98  const boxes = r.mailboxes && typeof r.mailboxes === "object" ? Object.fromEntries(Object.entries(r.mailboxes as Record<string, unknown>).filter(([, v]) => typeof v === "boolean")) : {}99  return {100    enabled: r.enabled !== false,101    preview: r.preview === "none" || r.preview === "full" ? r.preview : "sender",102    quiet_hours: quiet,103    priority_senders: Array.isArray(r.priority_senders) ? r.priority_senders.filter((x): x is string => typeof x === "string") : [],104    priority_only: r.priority_only === true,105    mailboxes: boxes as Record<string, boolean>,106    badge: r.badge === "none" ? "none" : "inbox",107  }108}109110// ---------------------------------------------------------------- état partagé : l'aperçu choisi sert aussi aux notifications du navigateur111export const PUSH = createStore<{ prefs: PushPrefs | null }>({ prefs: null })112let gen = 0113/** Lit les préférences (sans effet si le serveur n'a pas la fonction `push`) ; une réponse tardive n'écrase pas une écriture plus récente. */114export async function loadPushPrefs(signal?: AbortSignal): Promise<PushPrefs | null> {115  if (!hasFeature("push")) return null116  const my = ++gen117  try {118    const prefs = normalizePushPrefs(await nx.get<unknown>("push/prefs", undefined, signal))119    if (my === gen) PUSH.set({ prefs })120    return prefs121  } catch (e) {122    if (isAbort(e)) return null123    throw e124  }125}126/** N'envoie que les clés modifiées : le serveur n'applique que celles présentes dans le corps. */127export async function savePushPrefs(patch: Partial<PushPrefs>): Promise<PushPrefs> {128  const my = ++gen129  // effet immédiat à l'écran ; la réponse du serveur fait foi, un échec rétablit l'état d'avant (si rien d'autre n'a été écrit depuis)130  const before = PUSH.get().prefs131  if (before) PUSH.set({ prefs: { ...before, ...patch } })132  try {133    const prefs = normalizePushPrefs(await nx.put<unknown>("push/prefs", patch))134    if (my === gen) PUSH.set({ prefs })135    return prefs136  } catch (e) {137    if (my === gen) PUSH.set({ prefs: before })138    throw e139  }140}141export function resetPush() {142  gen++143  PUSH.set({ prefs: null })144}145/** Niveau d'aperçu à respecter ; « sender » tant que les préférences ne sont pas connues. */146export const currentPreview = (): Preview => PUSH.get().prefs?.preview ?? "sender"147148export const listDevices = (signal?: AbortSignal) => nx.list<PushDevice>("push/devices", undefined, signal)149export const setDeviceEnabled = (id: string, enabled: boolean) => nx.patch<{ ok: boolean; enabled: boolean }>(`push/devices/${encodeURIComponent(id)}`, { enabled })150export const removeDevice = (id: string) => nx.del(`push/devices/${encodeURIComponent(id)}`)151export const pushStatus = (signal?: AbortSignal) => nx.get<PushStatus>("push/status", undefined, signal)152export const sendTestPush = (deviceId?: string) => nx.post<{ queued: number }>("push/test", deviceId ? { device_id: deviceId } : {})153
Files main
Menu

Theme