diff --git a/.env.example b/.env.example index a211477..f42691b 100644 --- a/.env.example +++ b/.env.example @@ -47,8 +47,8 @@ SMTP_PASSWORD= SMTP_FROM= # true si le serveur SMTP exige TLS des la connexion (port 465). SMTP_SECURE=false -# Logo des courriels. Par defaut PUBLIC_ORIGIN/logo.png ; a surcharger si le -# logo est heberge ailleurs. URL joignable depuis Internet. +# Logo des courriels. Par defaut le logo embarque (backend/src/assets/logo.png, +# joint au message) ; renseigner une URL pour forcer une image distante. MAIL_LOGO_URL= # --- Limitation des connexions ------------------------------------------- diff --git a/backend/src/assets/logo.png b/backend/src/assets/logo.png new file mode 100644 index 0000000..f34c330 Binary files /dev/null and b/backend/src/assets/logo.png differ diff --git a/backend/src/lib/config.ts b/backend/src/lib/config.ts index ffffc78..1d76415 100644 --- a/backend/src/lib/config.ts +++ b/backend/src/lib/config.ts @@ -60,8 +60,8 @@ const schema = z.object({ SMTP_FROM: z.string().min(3), SMTP_SECURE: bool(false), /** - * Logo des courriels. Par defaut celui publie par le front - * (`PUBLIC_ORIGIN/logo.png`) ; l'URL doit etre joignable depuis Internet. + * Logo des courriels. Par defaut le logo embarque (`backend/src/assets/logo.png`, + * joint au message) ; renseigner une URL pour forcer une image distante. */ MAIL_LOGO_URL: z .string() diff --git a/backend/src/lib/mail-template.ts b/backend/src/lib/mail-template.ts index 9798b0c..ccbf2a5 100644 --- a/backend/src/lib/mail-template.ts +++ b/backend/src/lib/mail-template.ts @@ -15,10 +15,17 @@ export interface Branding { footer: string; } +/** + * Identifiant de la piece jointe du logo. Le logo est embarque dans le message + * (voir `mail.ts`) : l'image s'affiche meme si le client bloque les ressources + * distantes. `MAIL_LOGO_URL` force une image distante a la place. + */ +export const LOGO_CID = "cohaise-logo"; + export const branding = (config: Config): Branding => ({ appName: "CoHaiSe Cloud", origin: config.PUBLIC_ORIGIN, - logoUrl: config.MAIL_LOGO_URL ?? new URL("/logo.png", config.PUBLIC_ORIGIN).toString(), + logoUrl: config.MAIL_LOGO_URL ?? `cid:${LOGO_CID}`, color: "#b71c1c", footer: config.SMTP_FROM, }); @@ -54,18 +61,18 @@ export const renderMail = (brand: Branding, content: MailContent): RenderedMail const paragraphs = (content.paragraphs ?? []) .map( (paragraph) => - `

${escapeHtml(paragraph)}

`, + `

${escapeHtml(paragraph)}

`, ) .join(""); const credentials = content.credentials ? ` - -
-

Vos identifiants

-

Adresse : ${escapeHtml(content.credentials.email)}

-

Mot de passe temporaire : - ${escapeHtml(content.credentials.password)} + +
+

Vos identifiants

+

Adresse : ${escapeHtml(content.credentials.email)}

+

Mot de passe temporaire : + ${escapeHtml(content.credentials.password)}

` @@ -73,16 +80,16 @@ export const renderMail = (brand: Branding, content: MailContent): RenderedMail const cta = content.cta ? ` - +
- ${escapeHtml(content.cta.label)} + ${escapeHtml(content.cta.label)}
` : ""; const note = content.note ? ` -

${escapeHtml(content.note)}

` +

${escapeHtml(content.note)}

` : ""; const html = ` @@ -90,32 +97,39 @@ export const renderMail = (brand: Branding, content: MailContent): RenderedMail - + + ${escapeHtml(content.heading)} - -
${escapeHtml(content.preview)}
- + +
${escapeHtml(content.preview)}
+
- -
- - - ${escapeHtml(brand.appName)} - + + - + -
+ ${escapeHtml(brand.appName)}
-

${escapeHtml(content.heading)}

-

${escapeHtml(content.intro)}

+
+

${escapeHtml(content.heading)}

+

${escapeHtml(content.intro)}

+
${paragraphs}${credentials}${cta}${note}
-
-

Message automatique : merci de ne pas repondre a cet e-mail.

-

${escapeHtml(brand.footer)}

+
+ + + + + +
+

Message automatique : merci de ne pas repondre a cet e-mail.

+

${escapeHtml(brand.footer)}

+
+ +
-

${escapeHtml(brand.appName)} — ${escapeHtml(brand.origin.replace(/^https?:\/\//, ""))}

diff --git a/backend/src/lib/mail.ts b/backend/src/lib/mail.ts index ff9d164..48938a7 100644 --- a/backend/src/lib/mail.ts +++ b/backend/src/lib/mail.ts @@ -1,5 +1,7 @@ +import { readFileSync } from "node:fs"; import { createTransport, type Transporter } from "nodemailer"; import type { Config } from "./config.js"; +import { LOGO_CID } from "./mail-template.js"; /** * Envoi de courriel via SMTP. @@ -9,6 +11,20 @@ import type { Config } from "./config.js"; * laisser une reinitialisation de mot de passe silencieusement sans effet. */ +/** + * Logo embarque dans les messages. Le chemin remonte depuis `src/lib` ou + * `dist/lib` vers `backend/src/assets/logo.png`, present dans l'image. + */ +const LOGO_PATH = new URL("../../src/assets/logo.png", import.meta.url); + +const loadLogo = (): Buffer | null => { + try { + return readFileSync(LOGO_PATH); + } catch { + return null; + } +}; + export interface MailMessage { to: string; subject: string; @@ -33,14 +49,22 @@ export const createMailer = (config: Config): Mailer => { disableUrlAccess: true, }); + // Logo embarque une seule fois. `MAIL_LOGO_URL` le remplace par une image + // distante : dans ce cas on n'attache rien. + const logo = config.MAIL_LOGO_URL ? null : loadLogo(); + return { send: async (message) => { + const inlineLogo = logo !== null && message.html?.includes(`cid:${LOGO_CID}`) === true; await transport.sendMail({ from: config.SMTP_FROM, to: message.to, subject: message.subject, text: message.text, ...(message.html ? { html: message.html } : {}), + ...(inlineLogo + ? { attachments: [{ filename: "logo.png", content: logo, cid: LOGO_CID }] } + : {}), }); }, }; diff --git a/docs/api.md b/docs/api.md index 6a9da17..3b31abc 100644 --- a/docs/api.md +++ b/docs/api.md @@ -115,9 +115,12 @@ par tous les membres authentifiés, en écriture pour son propriétaire. ## Courriels Les messages sortants sont construits par `backend/src/lib/mail-template.ts` : -gabarit HTML aux couleurs de l'app (`#b71c1c`), logo (`MAIL_LOGO_URL`, défaut -`PUBLIC_ORIGIN/logo.png`), bouton d'action et mention **ne pas répondre**. Un -repli texte accompagne chaque envoi. +gabarit HTML aux couleurs de l'app (`#b71c1c`), logo, bouton d'action et mention +**ne pas répondre**. Un repli texte accompagne chaque envoi. + +Le logo `backend/src/assets/logo.png` est **embarqué** dans le message (pièce +jointe `cid`), donc visible même quand le client bloque les images distantes. +`MAIL_LOGO_URL` force une image distante à la place. Points d'envoi : réinitialisation du mot de passe, changement d'adresse, et **notification au nouvel utilisateur** à la création d'un compte admin diff --git a/docs/deployment.md b/docs/deployment.md index c452d73..fedae44 100644 --- a/docs/deployment.md +++ b/docs/deployment.md @@ -35,7 +35,7 @@ pose problème (`backend/src/lib/config.ts`). | `SMTP_USER` / `SMTP_PASSWORD` | authentification (vides = relais local) | vide | | `SMTP_FROM` | adresse d'expédition | — | | `SMTP_SECURE` | TLS implicite (port 465) | `false` | -| `MAIL_LOGO_URL` | logo des courriels (défaut `PUBLIC_ORIGIN/logo.png`) | vide | +| `MAIL_LOGO_URL` | logo distant des courriels (sinon logo embarqué `backend/src/assets/logo.png`) | vide | | `RATE_LIMIT_LOGIN_MAX` | tentatives par fenêtre | `10` | | `RATE_LIMIT_LOGIN_WINDOW_MS` | largeur de fenêtre | `60000` | | `LOG_LEVEL` | `silent…debug` | `info` | diff --git a/frontend/index.html b/frontend/index.html index 86b8080..a0ab49b 100644 --- a/frontend/index.html +++ b/frontend/index.html @@ -7,8 +7,8 @@ CoHaiSe Cloud - - + + diff --git a/frontend/public/icon.png b/frontend/public/icon.png new file mode 100644 index 0000000..f34c330 Binary files /dev/null and b/frontend/public/icon.png differ diff --git a/frontend/public/logo.png b/frontend/public/logo.png deleted file mode 100644 index 59bda20..0000000 Binary files a/frontend/public/logo.png and /dev/null differ diff --git a/frontend/src/components/AppShell.tsx b/frontend/src/components/AppShell.tsx index 98ae814..80932f9 100644 --- a/frontend/src/components/AppShell.tsx +++ b/frontend/src/components/AppShell.tsx @@ -58,6 +58,11 @@ export const AppShell = () => { const brand = ( setMenuOpen(false)}> + CoHaiSe diff --git a/frontend/src/components/confirm.tsx b/frontend/src/components/confirm.tsx new file mode 100644 index 0000000..b888262 --- /dev/null +++ b/frontend/src/components/confirm.tsx @@ -0,0 +1,85 @@ +import { + createContext, + useCallback, + useContext, + useState, + type ReactNode, +} from "react"; +import { Button } from "../ui/index.js"; +import { Modal } from "./feedback.js"; + +export interface ConfirmOptions { + /** Titre de la modale. */ + title?: string; + /** Corps du message ; accepte du balisage pour mettre un nom en valeur. */ + message: ReactNode; + confirmLabel?: string; + cancelLabel?: string; + /** `danger` reserve l'action a une operation destructive. */ + tone?: "default" | "danger"; +} + +type ConfirmFn = (options: ConfirmOptions) => Promise; + +interface PendingConfirm { + options: ConfirmOptions; + resolve: (value: boolean) => void; +} + +const ConfirmContext = createContext(null); + +/** + * Remplace `window.confirm` par une modale maison aux couleurs de l'app. + * `useConfirm()` renvoie une promesse resolue a `true` (confirme) ou `false`. + */ +export const ConfirmProvider = ({ children }: { children: ReactNode }) => { + const [pending, setPending] = useState(null); + + const confirm = useCallback( + (options) => new Promise((resolve) => setPending({ options, resolve })), + [], + ); + + const answer = (value: boolean) => { + if (pending) pending.resolve(value); + setPending(null); + }; + + const tone = pending?.options.tone ?? "default"; + + return ( + + {children} + answer(false)} + > +
+

+ {pending?.options.message} +

+
+ + +
+
+
+
+ ); +}; + +export const useConfirm = (): ConfirmFn => { + const context = useContext(ConfirmContext); + if (!context) throw new Error("useConfirm doit etre utilise sous ConfirmProvider"); + return context; +}; diff --git a/frontend/src/components/feedback.tsx b/frontend/src/components/feedback.tsx index 5e3639f..d16fe25 100644 --- a/frontend/src/components/feedback.tsx +++ b/frontend/src/components/feedback.tsx @@ -1,4 +1,4 @@ -import type { ReactNode } from "react"; +import { useEffect, type ReactNode } from "react"; import { cn } from "../ui/index.js"; import { CloseIcon } from "./icons.js"; @@ -11,13 +11,27 @@ export const Modal = ({ open: boolean; title: string; onClose: () => void; - children: React.ReactNode; + children: ReactNode; }) => { + useEffect(() => { + if (!open) return; + const onKeyDown = (event: KeyboardEvent) => { + if (event.key === "Escape") onClose(); + }; + window.addEventListener("keydown", onKeyDown); + const previousOverflow = document.body.style.overflow; + document.body.style.overflow = "hidden"; + return () => { + window.removeEventListener("keydown", onKeyDown); + document.body.style.overflow = previousOverflow; + }; + }, [open, onClose]); + if (!open) return null; return (