Repository Public
1// SP Mail Next — Réglages › Règles : règles après livraison (/api/next/rules) : liste ordonnée, activation, éditeur, essai, journal d'exécution ; lien avec les filtres Sieve.2import { useState } from "react"3import { fmtDateTime, t } from "../../i18n"4import { hasFeature, toNextError } from "../../next/api"5import { mailboxAddress } from "../../next/nav"6import {7 actionLabel, aiActive, createRule, deleteRule, emptyRuleForm, listLabels, listRules, listRuns, listSnippets, patchRule, reorderRules, ruleNeedsAi, ruleSummary, ruleToForm, scopeSummary,8 type LabelRef, type Rule, type RuleInput, type RuleRun, type RuleRunAction, type SnippetRef,9} from "../../next/rules"10import { S, toast } from "../../state/app"11import { linkProps } from "../../state/session"12import { useStore } from "../../state/store"13import { ConfirmDialog, Dialog, Icon, IconButton, Spinner } from "../kit"14import { Section } from "../Page"15import { RuleEditor, type EditorContext } from "./RuleEditor"16import { LoadError, useLoad } from "./shared"17import "./next-settings.css"1819interface Data {20 rules: Rule[]21 labels: LabelRef[]22 snippets: SnippetRef[]23 ai: boolean24}25const errorMessage = (e: unknown): string => {26 const err = toNextError(e)27 if (err.kind === "offline") return t("nx.offline")28 if (err.kind === "rate_limited") return t("nx.error.rateLimited")29 if (err.code === "unknown_label") return t("nx.settings.rules.err.unknownLabel")30 if (err.code === "unknown_snippet") return t("nx.settings.rules.err.unknownSnippet")31 if (err.code === "unknown_mailbox") return t("nx.settings.rules.err.unknownMailbox")32 if (err.code === "too_many_rules") return t("nx.settings.rules.err.tooMany")33 if (err.kind === "not_found") return t("nx.error.notFound")34 // refus de validation : le détail du serveur dit quel champ35 return err.kind === "invalid" && err.message ? `${t("nx.settings.rules.err.refused")} ${err.message}` : t("nx.error.generic")36}3738// ---------------------------------------------------------------- journal d'exécution39const runStatus = (s: RuleRun["status"]): { label: string; cls: string } =>40 s === "ok" ? { label: t("nx.settings.rules.runs.ok"), cls: "ok" } : s === "partial" ? { label: t("nx.settings.rules.runs.partial"), cls: "warn" } : s === "error" ? { label: t("nx.settings.rules.runs.error"), cls: "danger" } : s === "interrupted" ? { label: t("nx.settings.rules.runs.interrupted"), cls: "warn" } : { label: t("nx.settings.rules.runs.running"), cls: "" }41function skipText(detail: string | undefined): string {42 switch (detail) {43 case "ai_disabled": return t("nx.settings.rules.runs.skip.ai")44 case "label_not_found": case "labels_unavailable": return t("nx.settings.rules.runs.skip.label")45 case "snippet_not_found": case "snippets_unavailable": return t("nx.settings.rules.runs.skip.snippet")46 case "not_replyable": return t("nx.settings.rules.runs.skip.notReplyable")47 case "snooze_unavailable": case "reminders_unavailable": return t("nx.settings.rules.runs.skip.unavailable")48 default: return detail ?? ""49 }50}51function RunAction({ a }: { a: RuleRunAction }) {52 const extracted = a.type === "extract" && a.result && typeof a.result === "object" ? Object.entries(a.result as Record<string, unknown>) : []53 return (54 <li data-status={a.status}>55 <Icon name={a.status === "ok" ? "check" : a.status === "skipped" ? "chevronRight" : "warn"} small />56 <span>57 {actionLabel(a.type)}58 {a.status === "skipped" ? ` — ${t("nx.settings.rules.runs.skipped")} ${skipText(a.detail)}` : a.status === "error" ? ` — ${t("nx.settings.rules.runs.failed")} ${a.detail ?? ""}` : ""}59 {extracted.length ? (60 <span className="nx-set-extracted">61 {extracted.map(([k, v]) => (62 <span key={k} className="mono">63 {k} = {v === null ? "∅" : String(v)}64 </span>65 ))}66 </span>67 ) : null}68 </span>69 </li>70 )71}72function RunsDialog({ rule, onClose }: { rule: Rule; onClose: () => void }) {73 const { state, reload } = useLoad((signal) => listRuns(rule.id, signal), rule.id)74 return (75 <Dialog title={t("nx.settings.rules.runs.title", { name: rule.name })} onClose={onClose} wide>76 {state.status === "loading" ? <Spinner label={t("nx.loading")} /> : null}77 {state.status === "error" ? <LoadError error={state.error} onRetry={reload} /> : null}78 {state.status === "ready" && !state.data.length ? (79 <div className="nx-empty" data-testid="runs-empty">80 <Icon name="clock" />81 <p>{t("nx.settings.rules.runs.empty")}</p>82 </div>83 ) : null}84 {state.status === "ready" && state.data.length ? (85 <ol className="set-list nx-set-runs" aria-label={t("nx.settings.rules.runs.title", { name: rule.name })} data-testid="runs-list">86 {state.data.map((r) => {87 const st = runStatus(r.status)88 return (89 <li key={String(r.id)} className="set-item" data-testid="run-row" data-status={r.status}>90 <div className="row wrap nx-set-run-head">91 <span className={`badge ${st.cls}`}>{st.label}</span>92 <time dateTime={r.at}>{fmtDateTime(r.at)}</time>93 <span className="muted small set-wrap">{mailboxAddress(r.mailbox_id)}</span>94 </div>95 <ul className="nx-set-test-list">96 {r.actions.map((a, i) => (97 <RunAction key={i} a={a} />98 ))}99 </ul>100 </li>101 )102 })}103 </ol>104 ) : null}105 <p className="nx-note set-note">{t("nx.settings.rules.runs.note")}</p>106 </Dialog>107 )108}109110// ---------------------------------------------------------------- section111export default function Rules() {112 const online = useStore(S, (s) => s.online)113 const { state, reload, setData } = useLoad<Data>(async (signal) => {114 const [rules, labels, snippets, ai] = await Promise.all([115 listRules(signal),116 hasFeature("labels") ? listLabels(signal).catch(() => [] as LabelRef[]) : Promise.resolve([] as LabelRef[]),117 hasFeature("snippets") ? listSnippets(signal).catch(() => [] as SnippetRef[]) : Promise.resolve([] as SnippetRef[]),118 hasFeature("ai") ? aiActive(signal) : Promise.resolve(false),119 ])120 return { rules, labels, snippets, ai }121 }, "rules")122 const [editing, setEditing] = useState<{ rule: Rule | null } | null>(null)123 const [removing, setRemoving] = useState<Rule | null>(null)124 const [history, setHistory] = useState<Rule | null>(null)125 const [busy, setBusy] = useState(false)126127 const intro = (128 <div className="banner nx-set-explain" data-testid="rules-explain">129 <Icon name="rule" />130 <div>131 <p>{t("nx.settings.rules.explain")}</p>132 <p>133 {t("nx.settings.rules.explainSieve")}{" "}134 <a {...linkProps("/settings/filters")} data-testid="link-filters">135 {t("nx.settings.rules.toFilters")}136 </a>137 </p>138 </div>139 </div>140 )141 if (state.status === "loading") return <Spinner label={t("nx.loading")} />142 if (state.status === "error") return <LoadError error={state.error} onRetry={reload} />143 const data = state.data144 const ctx: EditorContext = { labels: data.labels, snippets: data.snippets, ai: data.ai, mailbox: mailboxAddress }145 const setRules = (rules: Rule[]) => setData({ ...data, rules })146147 const toggle = async (r: Rule, enabled: boolean) => {148 setRules(data.rules.map((x) => (x.id === r.id ? { ...x, enabled } : x)))149 try {150 await patchRule(r.id, { enabled })151 } catch (e) {152 toast({ kind: "error", text: errorMessage(e) })153 reload()154 }155 }156 const move = async (r: Rule, delta: -1 | 1) => {157 const next = reorderRules(data.rules, r.id, delta)158 if (!next.patches.length) return159 setRules(next.rules)160 setBusy(true)161 try {162 for (const p of next.patches) await patchRule(p.id, { position: p.position })163 } catch (e) {164 toast({ kind: "error", text: errorMessage(e) })165 reload()166 } finally {167 setBusy(false)168 }169 }170 const save = async (input: RuleInput): Promise<string | null> => {171 try {172 const cur = editing?.rule173 const saved = cur ? await patchRule(cur.id, input) : await createRule(input)174 setRules(cur ? data.rules.map((x) => (x.id === saved.id ? saved : x)) : [...data.rules, saved])175 setEditing(null)176 toast({ kind: "success", text: cur ? t("nx.settings.rules.saved") : t("nx.settings.rules.created") })177 return null178 } catch (e) {179 return errorMessage(e)180 }181 }182 const remove = async (r: Rule) => {183 try {184 await deleteRule(r.id)185 setRules(data.rules.filter((x) => x.id !== r.id))186 toast({ kind: "success", text: t("nx.settings.rules.deleted") })187 } catch (e) {188 toast({ kind: "error", text: errorMessage(e) })189 reload()190 }191 }192193 return (194 <>195 {intro}196 <Section197 title={t("nx.settings.rules.title")}198 description={t("nx.settings.rules.desc")}199 actions={200 <button type="button" className="btn small" disabled={!online || data.rules.length >= 100} title={online ? undefined : t("nx.offline")} onClick={() => setEditing({ rule: null })} data-testid="rule-add">201 <Icon name="plus" small />202 <span>{t("nx.settings.rules.add")}</span>203 </button>204 }205 >206 {data.rules.length === 0 ? (207 <div className="nx-empty" data-testid="rules-empty">208 <Icon name="rule" />209 <p>{t("nx.settings.rules.empty")}</p>210 </div>211 ) : (212 <ol className="set-list" aria-label={t("nx.settings.rules.title")} data-testid="rules-list">213 {data.rules.map((r, i) => (214 <li key={r.id} className="set-item" data-testid="rule-row" data-rule-name={r.name}>215 <div className="set-item-row">216 <label className="check set-item-main">217 <input type="checkbox" role="switch" checked={r.enabled} disabled={!online} aria-label={t("nx.settings.rules.enableLabel", { name: r.name })} onChange={(e) => void toggle(r, e.target.checked)} />218 <span className="set-rule-text">219 <strong className="set-wrap">{r.name}</strong>220 {ruleNeedsAi(r) ? <span className={`badge ${data.ai ? "" : "warn"} nx-set-badge`}>{data.ai ? t("nx.settings.rules.usesAi") : t("nx.settings.rules.aiOffBadge")}</span> : null}221 <span className="muted small set-wrap set-block" data-testid="rule-summary">222 {ruleSummary(r, ctx)}223 </span>224 <span className="muted small set-wrap set-block">{t("nx.settings.rules.scopeLine", { scope: scopeSummary(r, ctx) })}</span>225 </span>226 </label>227 <div className="row set-rule-actions">228 <IconButton icon="chevron" className="set-up" label={t("nx.settings.rules.moveUp", { name: r.name })} disabled={i === 0 || busy || !online} onClick={() => void move(r, -1)} />229 <IconButton icon="chevron" label={t("nx.settings.rules.moveDown", { name: r.name })} disabled={i === data.rules.length - 1 || busy || !online} onClick={() => void move(r, 1)} />230 <IconButton icon="clock" label={t("nx.settings.rules.historyLabel", { name: r.name })} onClick={() => setHistory(r)} />231 <IconButton icon="edit" label={t("nx.settings.rules.editLabel", { name: r.name })} onClick={() => setEditing({ rule: r })} />232 <IconButton icon="trash" label={t("nx.settings.rules.deleteLabel", { name: r.name })} disabled={!online} onClick={() => setRemoving(r)} />233 </div>234 </div>235 </li>236 ))}237 </ol>238 )}239 {data.rules.length > 1 ? <p className="muted small set-note">{t("nx.settings.rules.orderNote")}</p> : null}240 {!data.ai && data.rules.some(ruleNeedsAi) ? (241 <p className="muted small set-note">242 {t("nx.settings.rules.aiOffNote")}{" "}243 {hasFeature("ai") ? <a {...linkProps("/settings/intelligence")}>{t("nx.settings.rules.toIntelligence")}</a> : null}244 </p>245 ) : null}246 </Section>247248 {editing ? <RuleEditor key={editing.rule?.id ?? "new"} initial={editing.rule ? ruleToForm(editing.rule) : emptyRuleForm()} isNew={!editing.rule} ctx={ctx} onSave={save} onClose={() => setEditing(null)} /> : null}249 {history ? <RunsDialog rule={history} onClose={() => setHistory(null)} /> : null}250 {removing ? <ConfirmDialog title={t("nx.settings.rules.deleteTitle")} body={t("nx.settings.rules.deleteBody", { name: removing.name })} confirmLabel={t("common.delete")} danger onConfirm={() => remove(removing)} onClose={() => setRemoving(null)} /> : null}251 </>252 )253}254