Repository Public
1// « Envoyer ce modèle » : expéditeur, destinataires, valeurs des variables, objet de remplacement, programmation, aperçu2// rendu avec les valeurs saisies, puis POST /api/v1/messages/send (template_id + variables) et suivi honnête de l'envoi :3// « accepté » n'est pas « remis » — seul l'état rapporté par l'API, destinataire par destinataire, est affiché.4import { useCallback, useEffect, useId, useMemo, useRef, useState } from "react"5import { fmtDateTime, t, type MsgKey } from "../../i18n"6import { HttpError } from "../../jmap/errors"7import type { Addr } from "../../mail/address"8import type { Outbound } from "../../mail/v1"9import { S } from "../../state/app"10import { loadContacts } from "../../state/mail"11import { isFinalOutbound, pollOutbound } from "../../state/outbound"12import { loadAddresses, senderGroups } from "../../state/senders"13import { useStore } from "../../state/store"14import { cancelScheduledSend, previewDraft, sendTemplate, type PreviewResult, type Template, type TemplateVariable } from "../../state/templates"15import {16 SEND_AT_MAX_DAYS, SUBJECT_MAX, VALUE_MAX, buildSendPayload, knownStatus, newIdempotencyKey, parseLocalDateTime, previewValues, readSendError, sendProblems, shouldPoll, statusTone, toLocalInput,17 type SendError, type SendForm, type SendProblem, type StatusTone,18} from "../../templates/send"19import { RecipientInput } from "../Composer"20import { Dialog, Icon, Spinner, type IconName } from "../kit"21import { ApiPanel } from "./ApiPanel"22import { TemplateFrame } from "./Frame"2324export interface SendDialogProps {25 /** modèle enregistré : c'est lui que l'API envoie */26 tpl: Template27 /** contenu affiché dans l'éditeur (égal au modèle enregistré s'il n'y a pas de modification en attente) */28 draft: { html: string; subject: string; preheader: string; text: string }29 variables: TemplateVariable[]30 dirty: boolean31 /** enregistre les modifications en attente ; faux si l'enregistrement a échoué */32 onSave: () => Promise<boolean>33 onClose: () => void34}3536const TONE_ICON: Record<StatusTone, IconName> = { ok: "check", warn: "warn", danger: "warn", info: "clock" }37const statusLabel = (status: string) => t(`tpl.send.status.${knownStatus(status)}` as MsgKey)38const quoted = (names: readonly string[]) => names.map((n) => `{{${n}}}`).join(", ")3940function problemText(p: SendProblem): string {41 switch (p.code) {42 case "invalid_recipient":43 return t("tpl.send.problem.invalid_recipient", { n: p.addresses.length, addresses: p.addresses.join(", ") })44 case "missing_variables":45 return t("tpl.send.problem.missing_variables", { n: p.variables.length, names: quoted(p.variables) })46 case "value_too_long":47 return t("tpl.send.problem.value_too_long", { names: quoted(p.variables) })48 case "send_at_too_far":49 return t("tpl.send.problem.send_at_too_far", { days: SEND_AT_MAX_DAYS })50 default:51 return t(`tpl.send.problem.${p.code}` as MsgKey)52 }53}54function errorMessage(e: SendError): string {55 if (e.code === "missing_variables" || e.code === "unknown_variables") return t(`tpl.send.err.${e.code}` as MsgKey, { n: Math.max(1, e.variables.length), names: quoted(e.variables) || "—" })56 if (e.code === "send_at_too_far") return t("tpl.send.err.send_at_too_far", { days: SEND_AT_MAX_DAYS })57 return t(`tpl.send.err.${e.code}` as MsgKey)58}5960// ---------------------------------------------------------------- suivi de l'envoi61function StatusView({ outbound, polling, stalled, onCancelScheduled, cancelling }: { outbound: Outbound; polling: boolean; stalled: boolean; onCancelScheduled: () => void; cancelling: boolean }) {62 const tone = statusTone(outbound.status)63 const status = knownStatus(outbound.status)64 return (65 <section className="stack tpl-send-status" aria-live="polite" data-testid="send-status" data-status={outbound.status}>66 <div className={`banner ${tone === "info" ? "" : tone}`}>67 <Icon name={TONE_ICON[tone]} small />68 <div className="spacer">69 <strong data-testid="send-status-label">{statusLabel(outbound.status)}</strong>70 <p>{status === "scheduled" && outbound.send_at ? t("tpl.send.explain.scheduledAt", { when: fmtDateTime(outbound.send_at) }) : t(`tpl.send.explain.${status}` as MsgKey)}</p>71 {outbound.last_error ? (72 <p className="tpl-send-reply" data-testid="send-last-error">73 {t("tpl.send.lastError", { error: outbound.last_error })}74 </p>75 ) : null}76 </div>77 </div>78 <h3>{t("tpl.send.recipientsTitle")}</h3>79 <ul className="tpl-send-rcpts">80 {outbound.recipients.map((r) => {81 const rt = statusTone(r.status)82 return (83 <li key={r.address} data-recipient={r.address} data-status={r.status}>84 <span className="tpl-send-addr">{r.address}</span>85 <span className={`badge ${rt === "info" ? "" : rt}`}>86 <Icon name={TONE_ICON[rt]} small />87 <span>{statusLabel(r.status)}</span>88 </span>89 {r.smtp_reply ? <span className="muted small tpl-send-reply">{r.smtp_reply}</span> : null}90 </li>91 )92 })}93 </ul>94 {polling ? (95 <div className="row muted small" data-testid="send-polling">96 <Spinner />97 <span>{t("tpl.send.tracking")}</span>98 </div>99 ) : stalled ? (100 <p className="muted small" data-testid="send-stalled">101 {t("tpl.send.trackingStopped")}102 </p>103 ) : null}104 {outbound.status === "scheduled" ? (105 <div className="row wrap">106 <button type="button" className="btn" disabled={cancelling} onClick={onCancelScheduled} data-testid="send-cancel-scheduled">107 <Icon name="close" small />108 <span>{t("tpl.send.cancelScheduled")}</span>109 </button>110 <span className="muted small">{t("tpl.send.scheduledWhere")}</span>111 </div>112 ) : null}113 <p className="muted small">{t("tpl.send.reference", { id: outbound.id })}</p>114 </section>115 )116}117118// ---------------------------------------------------------------- aperçu rendu avec les valeurs saisies119function SendPreview({ rendered, subject, loading, failed }: { rendered: PreviewResult | null; subject: string; loading: boolean; failed: boolean }) {120 const box = useRef<HTMLDivElement>(null)121 const [w, setW] = useState(0)122 useEffect(() => {123 const el = box.current124 if (!el) return125 const ro = new ResizeObserver(() => setW(el.clientWidth))126 ro.observe(el)127 setW(el.clientWidth)128 return () => ro.disconnect()129 }, [])130 const scale = w > 0 ? Math.min(1, w / 600) : 0131 return (132 <section className="stack tpl-send-preview" aria-labelledby="tpl-send-preview-h" data-testid="send-preview" data-loading={loading || undefined}>133 <h3 id="tpl-send-preview-h">{t("tpl.send.previewTitle")}</h3>134 <p className="small tpl-send-subject">135 <span className="muted">{t("tpl.send.previewSubject")}</span> <strong data-testid="send-preview-subject">{subject.trim() || t("tpl.noSubject")}</strong>136 </p>137 {failed ? (138 <div className="banner warn" role="alert">139 <Icon name="warn" small />140 <span>{t("tpl.preview.failed")}</span>141 </div>142 ) : null}143 <div ref={box} className="tpl-version-frame tpl-send-frame">144 {rendered && scale > 0 ? <TemplateFrame html={rendered.html} title={t("tpl.send.previewFrame")} width={600} height={Math.round(380 / scale)} scale={scale} /> : <div className="skeleton tpl-stage-skel" />}145 </div>146 <p className="muted small">{t("tpl.send.previewHelp")}</p>147 </section>148 )149}150151// ---------------------------------------------------------------- dialogue152export function SendDialog({ tpl, draft, variables, dirty, onSave, onClose }: SendDialogProps) {153 const id = useId()154 const groups = useStore(S, senderGroups)155 const [addressesReady, setAddressesReady] = useState(() => S.get().addresses !== null)156 // seules les boîtes et les alias ont une ligne d'adresse : une identité JMAP ajoutée à la main serait refusée par l'API157 const sendable = useMemo(() => groups.map((g) => ({ ...g, senders: g.senders.filter((s) => s.kind !== "identity") })).filter((g) => g.senders.length > 0), [groups])158 const [fromChoice, setFromChoice] = useState<string | null>(null)159 const all = useMemo(() => sendable.flatMap((g) => g.senders), [sendable])160 const sender = all.find((s) => s.email === fromChoice) ?? all[0] ?? null161 const from = sender?.email ?? null162 const contacts = useStore(S, (s) => (sender ? s.contacts[sender.mb] : undefined))163 const suggestions: Addr[] = contacts ?? []164165 const [to, setTo] = useState<Addr[]>([])166 const [cc, setCc] = useState<Addr[]>([])167 const [bcc, setBcc] = useState<Addr[]>([])168 const [showCc, setShowCc] = useState(false)169 const [values, setValues] = useState<Record<string, string>>({})170 const [subject, setSubject] = useState("")171 const [schedule, setSchedule] = useState(false)172 const [sendAt, setSendAt] = useState("")173 const [tried, setTried] = useState(false)174 const [pendingText, setPendingText] = useState<string[]>([])175 const [busy, setBusy] = useState<"saving" | "sending" | null>(null)176 const [error, setError] = useState<SendError | "save_failed" | null>(null)177 const [outbound, setOutbound] = useState<Outbound | null>(null)178 const [polling, setPolling] = useState(false)179 const [stalled, setStalled] = useState(false)180 const [cancelling, setCancelling] = useState(false)181 const [rendered, setRendered] = useState<PreviewResult | null>(null)182 const [previewLoading, setPreviewLoading] = useState(false)183 const [previewFailed, setPreviewFailed] = useState(false)184 // une clé par ouverture du dialogue et par tentative : un double clic ou un nouvel essai après coupure ne peut pas envoyer deux fois185 const idemKey = useRef(newIdempotencyKey())186 const inFlight = useRef(false)187 const tracker = useRef<AbortController | null>(null)188189 useEffect(() => {190 let alive = true191 void loadAddresses(60_000).then(() => alive && setAddressesReady(true))192 return () => {193 alive = false194 tracker.current?.abort()195 }196 }, [])197 const mb = sender?.mb198 useEffect(() => {199 if (mb) void loadContacts(mb).catch(() => {})200 }, [mb])201202 // ---- aperçu : le contenu de l'éditeur rendu avec les valeurs saisies, sans aucun exemple (comme le fera l'envoi)203 const { html, subject: tplSubject, preheader, text } = draft204 useEffect(() => {205 if (outbound) return206 const ctrl = new AbortController()207 setPreviewLoading(true)208 const timer = setTimeout(async () => {209 try {210 const r = await previewDraft({ html, subject: tplSubject, preheader, text, variables, values: previewValues(variables, values) }, ctrl.signal)211 setRendered(r)212 setPreviewFailed(false)213 } catch {214 if (!ctrl.signal.aborted) setPreviewFailed(true)215 } finally {216 if (!ctrl.signal.aborted) setPreviewLoading(false)217 }218 }, 300)219 return () => {220 clearTimeout(timer)221 ctrl.abort()222 }223 }, [html, tplSubject, preheader, text, variables, values, outbound])224225 const form: SendForm = useMemo(() => ({ from, to, cc, bcc, variables, values, subject, schedule, sendAt }), [from, to, cc, bcc, variables, values, subject, schedule, sendAt])226 const problems = useMemo(() => {227 const list = tried ? sendProblems(form) : []228 if (!pendingText.length) return list229 const known = list.find((p): p is Extract<SendProblem, { code: "invalid_recipient" }> => p.code === "invalid_recipient")230 if (known) return list.map((p) => (p === known ? { ...known, addresses: [...known.addresses, ...pendingText] } : p))231 return [...list, { code: "invalid_recipient", addresses: pendingText } as SendProblem]232 }, [tried, form, pendingText])233 useEffect(() => setPendingText([]), [to, cc, bcc])234 const has = (code: SendProblem["code"]) => problems.some((p) => p.code === code)235 const missing = problems.find((p): p is Extract<SendProblem, { code: "missing_variables" }> => p.code === "missing_variables")?.variables ?? []236237 const track = useCallback((first: Outbound) => {238 tracker.current?.abort()239 setStalled(false)240 if (isFinalOutbound(first) || !shouldPoll(first.status)) return setPolling(false)241 const ctrl = new AbortController()242 tracker.current = ctrl243 setPolling(true)244 void pollOutbound(first.id, (o) => !ctrl.signal.aborted && setOutbound(o), ctrl.signal).then((last) => {245 if (ctrl.signal.aborted) return246 setPolling(false)247 setStalled(!last || !isFinalOutbound(last))248 })249 }, [])250251 /** Texte encore dans un champ de destinataires (saisie non validée) : il ne partirait pas, on le signale. */252 const leftovers = () =>253 ["to", "cc", "bcc"]254 .map((f) => (document.getElementById(`${id}-${f}`) as HTMLInputElement | null)?.value.trim() ?? "")255 .filter((v) => v.length > 0)256257 const submit = async () => {258 if (inFlight.current || outbound) return259 setTried(true)260 setError(null)261 const pending = leftovers()262 setPendingText(pending)263 if (pending.length || sendProblems(form).length) return264 inFlight.current = true265 try {266 if (dirty) {267 setBusy("saving")268 if (!(await onSave())) return setError("save_failed")269 }270 setBusy("sending")271 const payload = buildSendPayload(tpl.id, form)272 const first = await sendTemplate(payload, idemKey.current)273 idemKey.current = newIdempotencyKey()274 setOutbound(first)275 track(first)276 } catch (e) {277 const err = readSendError(e instanceof HttpError ? e : null)278 // refus net du serveur : la prochaine tentative est une nouvelle demande ; coupure : même clé (pas de double envoi)279 if (!err.keepKey) idemKey.current = newIdempotencyKey()280 setError(err)281 } finally {282 inFlight.current = false283 setBusy(null)284 }285 }286287 const cancelScheduled = async () => {288 if (!outbound || cancelling) return289 setCancelling(true)290 try {291 setOutbound(await cancelScheduledSend(outbound.id))292 } catch (e) {293 setError(readSendError(e instanceof HttpError ? e : null))294 } finally {295 setCancelling(false)296 }297 }298 const again = () => {299 tracker.current?.abort()300 setOutbound(null)301 setPolling(false)302 setStalled(false)303 setError(null)304 setTried(false)305 }306 const toggleSchedule = (on: boolean) => {307 setSchedule(on)308 if (on && !parseLocalDateTime(sendAt)) {309 const d = new Date(Date.now() + 86400_000)310 d.setHours(9, 0, 0, 0)311 setSendAt(toLocalInput(d))312 }313 }314315 const close = () => {316 if (!busy) onClose()317 }318 const noSender = addressesReady && all.length === 0319 const sendLabel = busy === "saving" ? t("tpl.edit.saving") : busy === "sending" ? t("tpl.send.sending") : dirty ? (schedule ? t("tpl.send.saveAndSchedule") : t("tpl.send.saveAndSend")) : schedule ? t("tpl.send.schedule") : t("tpl.send.submit")320 const now = Date.now()321 const zone = useMemo(() => {322 try {323 return Intl.DateTimeFormat().resolvedOptions().timeZone324 } catch {325 return ""326 }327 }, [])328329 const footer = outbound ? (330 <>331 <button type="button" className="btn" onClick={again} data-testid="send-again">332 {t("tpl.send.again")}333 </button>334 <button type="button" className="btn primary" onClick={close}>335 {t("common.close")}336 </button>337 </>338 ) : (339 <>340 <button type="button" className="btn" onClick={close} disabled={!!busy}>341 {t("common.cancel")}342 </button>343 <button type="button" className="btn primary" onClick={() => void submit()} disabled={!!busy || noSender || !addressesReady} data-testid="send-submit">344 <Icon name={schedule ? "clock" : "send"} />345 <span>{sendLabel}</span>346 </button>347 </>348 )349350 return (351 <Dialog title={t("tpl.send.title")} onClose={close} wide footer={footer}>352 <div className="stack tpl-send" data-testid="send-dialog">353 <p className="muted small">{t("tpl.send.intro", { name: tpl.name })}</p>354 {error ? (355 <div className="banner danger" role="alert" data-testid="send-error" data-code={error === "save_failed" ? "save_failed" : error.code}>356 <Icon name="warn" small />357 <span>{error === "save_failed" ? t("tpl.send.err.save_failed") : errorMessage(error)}</span>358 </div>359 ) : null}360361 {outbound ? (362 <StatusView outbound={outbound} polling={polling} stalled={stalled} onCancelScheduled={() => void cancelScheduled()} cancelling={cancelling} />363 ) : (364 <div className="tpl-send-grid">365 {/* Aucun envoi implicite : la touche Entrée dans un champ ne doit jamais faire partir un vrai courriel */}366 <form className="stack tpl-send-form" noValidate onSubmit={(e) => e.preventDefault()}>367 {dirty ? (368 <div className="banner warn" role="status" data-testid="send-unsaved">369 <Icon name="warn" small />370 <div>371 <strong>{t("tpl.send.unsavedTitle")}</strong>372 <p>{t("tpl.send.unsavedBody")}</p>373 </div>374 </div>375 ) : null}376377 <div className="field">378 <label htmlFor={`${id}-from`}>{t("tpl.send.from")}</label>379 {!addressesReady ? (380 <Spinner label={t("common.loading")} />381 ) : noSender ? (382 <div className="banner danger" role="alert" data-testid="send-no-sender">383 <Icon name="warn" small />384 <span>{t("tpl.send.noSender")}</span>385 </div>386 ) : (387 <select id={`${id}-from`} className="select" value={from ?? ""} onChange={(e) => setFromChoice(e.target.value)} data-testid="send-from">388 {sendable.map((g) => (389 <optgroup key={g.mb} label={g.mailbox}>390 {g.senders.map((s) => (391 <option key={s.key} value={s.email}>392 {s.name ? `${s.name} <${s.email}>` : s.email}393 </option>394 ))}395 </optgroup>396 ))}397 </select>398 )}399 </div>400401 <div className="tpl-send-rcpt" data-invalid={has("no_recipient") || has("invalid_recipient") || undefined}>402 <RecipientInput label={t("tpl.send.to")} value={to} onChange={setTo} suggestions={suggestions} inputId={`${id}-to`} />403 </div>404 {showCc ? (405 <>406 <div className="tpl-send-rcpt">407 <RecipientInput label={t("tpl.send.cc")} value={cc} onChange={setCc} suggestions={suggestions} inputId={`${id}-cc`} autoFocus />408 </div>409 <div className="tpl-send-rcpt">410 <RecipientInput label={t("tpl.send.bcc")} value={bcc} onChange={setBcc} suggestions={suggestions} inputId={`${id}-bcc`} />411 </div>412 </>413 ) : (414 <div className="row">415 <button type="button" className="btn small ghost" onClick={() => setShowCc(true)}>416 <Icon name="plus" small />417 <span>{t("tpl.send.addCc")}</span>418 </button>419 </div>420 )}421422 <fieldset className="stack tpl-send-vars">423 <legend>{t("tpl.send.variables")}</legend>424 {variables.length === 0 ? (425 <p className="muted small">{t("tpl.send.noVariables")}</p>426 ) : (427 variables.map((v) => {428 const fid = `${id}-v-${v.name}`429 const value = values[v.name] ?? ""430 const invalid = missing.includes(v.name)431 const common = {432 id: fid,433 value,434 maxLength: VALUE_MAX,435 placeholder: v.example ? t("tpl.send.examplePlaceholder", { example: v.example.slice(0, 80) }) : undefined,436 "aria-required": v.required || undefined,437 "aria-invalid": invalid || undefined,438 "aria-describedby": v.description ? `${fid}-d` : undefined,439 "data-send-variable": v.name,440 onChange: (e: React.ChangeEvent<HTMLInputElement | HTMLTextAreaElement>) => setValues((prev) => ({ ...prev, [v.name]: e.target.value })),441 }442 return (443 <div key={v.name} className="field">444 <label htmlFor={fid}>445 <code>{v.name}</code>446 {v.required ? (447 <span className="tpl-required">448 <span aria-hidden="true">*</span>449 <span className="sr-only">{t("tpl.vars.required")}</span>450 </span>451 ) : (452 <span className="muted tpl-optional">{t("tpl.send.optional")}</span>453 )}454 </label>455 {v.example.length > 80 ? <textarea {...common} className="textarea" rows={2} /> : <input {...common} className="input" autoComplete="off" />}456 {v.description ? (457 <span className="hint" id={`${fid}-d`}>458 {v.description}459 </span>460 ) : null}461 </div>462 )463 })464 )}465 {variables.length ? <p className="muted small">{t("tpl.send.variablesHelp")}</p> : null}466 </fieldset>467468 <div className="field">469 <label htmlFor={`${id}-subject`}>{t("tpl.send.subject")}</label>470 <input471 id={`${id}-subject`}472 className="input"473 value={subject}474 maxLength={SUBJECT_MAX}475 placeholder={rendered?.subject || tpl.subject || undefined}476 aria-invalid={has("subject_invalid") || undefined}477 aria-describedby={`${id}-subject-h`}478 autoComplete="off"479 onChange={(e) => setSubject(e.target.value.replace(/[\r\n]+/g, " "))}480 data-testid="send-subject"481 />482 <span className="hint" id={`${id}-subject-h`}>483 {t("tpl.send.subjectHelp")}484 </span>485 </div>486487 <div className="stack tpl-send-when">488 <label className="check">489 <input type="checkbox" checked={schedule} onChange={(e) => toggleSchedule(e.target.checked)} data-testid="send-schedule" />490 <span>{t("tpl.send.scheduleToggle")}</span>491 </label>492 {schedule ? (493 <div className="field">494 <label htmlFor={`${id}-at`}>{t("tpl.send.sendAt")}</label>495 <input496 id={`${id}-at`}497 className="input"498 type="datetime-local"499 value={sendAt}500 min={toLocalInput(new Date(now + 120_000))}501 max={toLocalInput(new Date(now + SEND_AT_MAX_DAYS * 86400_000))}502 aria-invalid={has("send_at_invalid") || has("send_at_past") || has("send_at_too_far") || undefined}503 aria-describedby={`${id}-at-h`}504 onChange={(e) => setSendAt(e.target.value)}505 data-testid="send-at"506 />507 <span className="hint" id={`${id}-at-h`}>508 {t("tpl.send.sendAtHelp", { days: SEND_AT_MAX_DAYS, zone: zone || "—" })}509 </span>510 </div>511 ) : null}512 </div>513514 {problems.length ? (515 <div className="banner danger" role="alert" data-testid="send-problems">516 <Icon name="warn" small />517 <ul>518 {problems.map((p) => (519 <li key={p.code} data-problem={p.code}>520 {problemText(p)}521 </li>522 ))}523 </ul>524 </div>525 ) : null}526 </form>527528 <div className="stack tpl-send-side">529 <SendPreview rendered={rendered} subject={subject.trim() || rendered?.subject || ""} loading={previewLoading} failed={previewFailed} />530 <p className="muted small tpl-send-honest">531 <Icon name="shieldOk" small />532 <span>{t("tpl.send.honest")}</span>533 </p>534 </div>535 </div>536 )}537538 <details className="tpl-send-api" data-testid="send-api">539 <summary>540 <Icon name="code" small />541 <span>{t("tpl.send.apiSummary")}</span>542 </summary>543 <ApiPanel templateId={tpl.id} from={from} variables={variables} values={values} />544 </details>545 </div>546 </Dialog>547 )548}549