Repository Public
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