SPB Git

Repository Public

SendDialog.tsx 24.9 KB 549 lines tsx

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

Theme