Repository Public
1// Document d'aperçu d'un modèle, destiné à l'attribut srcdoc d'un <iframe sandbox> SANS allow-scripts ni allow-same-origin.2// Même défense en profondeur que la lecture des messages (mail/sanitize.ts), chaque couche suffisant seule :3// 1. DOMPurify sur le document entier (ni script, ni cadre, ni formulaire, ni gestionnaire d'événement, ni <base>/<meta>/<link>) ;4// 2. seconde passe : liens http(s)/mailto seulement, CSS neutralisé (ni @import, ni @font-face, ni url() distante),5// images distantes remplacées par une URL data: — la page les récupère par le mandataire /api/img et les passe ici ;6// 3. CSP interne « default-src 'none'; img-src data: » : même si quelque chose échappait aux deux premières couches,7// le document ne peut ni exécuter de code ni joindre le réseau.8// Le HTML d'un modèle n'est jamais inséré dans le document de l'application.9import DOMPurify from "dompurify"10import { READER_CSP, neutralizeCss } from "../mail/sanitize"11import { forceColorScheme, hasDarkStyles, type ColorScheme } from "./darkmode"1213type PurifyWindow = Parameters<typeof DOMPurify>[0]14type Purifier = ReturnType<typeof DOMPurify>1516export interface PreviewOptions {17 /** rendu forcé ; absent = clair */18 scheme?: ColorScheme19 /** images déjà récupérées : URL d'origine (https) → URL data: */20 images?: ReadonlyMap<string, string>21 /** miniature : pas de barre de défilement, aucun lien actif */22 thumbnail?: boolean23 lang?: string24 /** fenêtre DOM à utiliser (jsdom dans les tests) */25 window?: PurifyWindow26}2728export interface PreviewDocument {29 /** document complet pour srcdoc */30 srcdoc: string31 /** URL https des images référencées (balises <img>, fonds, url() CSS), sans doublon, dans l'ordre du document */32 remoteImages: string[]33 /** le modèle prévoit un rendu sombre (@media (prefers-color-scheme: dark)) */34 hasDark: boolean35}3637const FORBID_TAGS = [38 "script", "noscript", "template", "iframe", "frame", "frameset", "noframes", "object", "embed", "applet", "portal", "slot",39 "base", "meta", "link", "svg", "math", "form", "input", "button", "select", "textarea", "option", "optgroup", "datalist", "keygen", "output",40 "video", "audio", "source", "track", "canvas", "dialog", "marquee", "bgsound", "layer", "ilayer", "xml", "plaintext", "listing", "xmp", "picture",41]42const FORBID_ATTR = [43 "srcset", "sizes", "action", "formaction", "ping", "poster", "data", "dynsrc", "lowsrc", "longdesc", "usemap", "ismap", "manifest", "profile",44 "contenteditable", "autofocus", "tabindex", "accesskey", "draggable", "download", "is", "nonce", "integrity", "crossorigin", "referrerpolicy", "loading", "decoding", "fetchpriority",45 "name", "popover", "popovertarget", "inert", "slot", "part", "exportparts", "srcdoc", "xlink:href",46]4748const purifiers = new WeakMap<object, Purifier>()49function purifierFor(win?: PurifyWindow): Purifier {50 if (!win) return DOMPurify51 let p = purifiers.get(win as object)52 if (!p) {53 p = DOMPurify(win)54 purifiers.set(win as object, p)55 }56 return p57}5859const SAFE_DATA_IMAGE = /^data:image\/(?:png|jpeg|gif|webp|avif|bmp|x-icon|vnd\.microsoft\.icon);base64,[a-z0-9+/=]*$/i60const HTTPS_URL = /^https:\/\/[^\s"'<>\\()]+$/i61const SAFE_LINK = /^(?:https?:\/\/|mailto:)[^\s"'<>]*$/i62/** Image transparente 1 × 1 : tient la place d'une image distante pas encore (ou jamais) récupérée. */63export const BLANK_IMAGE = "data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7"64const CSS_URL = /url\(\s*(?:"(https:\/\/[^"\\\s()<>]+)"|'(https:\/\/[^'\\\s()<>]+)'|(https:\/\/[^"'\\\s()<>]+))\s*\)/gi6566export const PREVIEW_CSP = READER_CSP6768/** URL du mandataire d'images pour une image distante (seul chemin par lequel une image de modèle est chargée). */69export function proxyUrl(remote: string): string {70 return `/api/img?u=${encodeURIComponent(remote)}`71}7273function escapeAttr(s: string): string {74 return s.replace(/&/g, "&").replace(/"/g, """).replace(/</g, "<").replace(/>/g, ">")75}7677class Collector {78 readonly urls: string[] = []79 private seen = new Set<string>()80 constructor(private images: ReadonlyMap<string, string> | undefined) {}81 /** Enregistre l'URL distante et rend ce qui peut la remplacer dans le cadre (URL data: récupérée, ou `null`). */82 resolve(url: string): string | null {83 if (!this.seen.has(url)) {84 this.seen.add(url)85 this.urls.push(url)86 }87 const data = this.images?.get(url)88 return data && SAFE_DATA_IMAGE.test(data) ? data : null89 }90}9192/** CSS d'un modèle : images distantes remplacées (ou retirées), rendu clair/sombre forcé, tout le reste neutralisé. */93function processCss(css: string, scheme: ColorScheme, collect: Collector, inline = false): string {94 // 1. les url(https://…) deviennent des url("data:…") quand l'image a été récupérée ; sinon elles seront retirées à l'étape 295 const withImages = css.replace(CSS_URL, (m, a?: string, b?: string, c?: string) => {96 const url = a ?? b ?? c ?? ""97 if (!HTTPS_URL.test(url)) return m98 const data = collect.resolve(url)99 return data ? `url("${data}")` : "none"100 })101 // 2. plus rien ne peut charger une ressource ni exécuter de code (url() restantes, @import, @font-face, expression()…)102 const safe = neutralizeCss(withImages).css103 return inline ? safe : forceColorScheme(safe, scheme)104}105106const baseCss = (scheme: ColorScheme, thumbnail: boolean) =>107 `:root{color-scheme:${scheme} only}html{-webkit-text-size-adjust:100%}img{max-width:100%}` +108 (thumbnail ? "html,body{overflow:hidden!important}*{animation:none!important;transition:none!important}a{pointer-events:none}" : "")109110/**111 * Construit le document d'aperçu. Sans DOM (rendu côté serveur, test mal configuré), rend un document vide plutôt que112 * de laisser passer du HTML non assaini.113 */114export function buildPreviewDocument(html: string, opts: PreviewOptions = {}): PreviewDocument {115 const scheme: ColorScheme = opts.scheme === "dark" ? "dark" : "light"116 const collect = new Collector(opts.images)117 const purifier = purifierFor(opts.window)118 const head = `<meta charset="utf-8"><meta http-equiv="Content-Security-Policy" content="${PREVIEW_CSP}"><meta name="referrer" content="no-referrer"><meta name="viewport" content="width=device-width,initial-scale=1"><meta name="color-scheme" content="${scheme}"><title>${escapeAttr(opts.lang === "en" ? "preview" : "aperçu")}</title>`119 const empty: PreviewDocument = { srcdoc: `<!doctype html><html lang="${escapeAttr(opts.lang ?? "fr")}"><head>${head}</head><body></body></html>`, remoteImages: [], hasDark: false }120 if (!purifier.isSupported) return empty121122 const root = purifier.sanitize(html, {123 WHOLE_DOCUMENT: true,124 RETURN_DOM: true,125 FORBID_TAGS,126 FORBID_ATTR,127 ADD_TAGS: ["style", "center"],128 ADD_ATTR: ["target", "bgcolor", "background", "valign", "cellpadding", "cellspacing", "border", "align", "role", "width", "height"],129 ALLOW_DATA_ATTR: false,130 ALLOW_ARIA_ATTR: true,131 ALLOW_UNKNOWN_PROTOCOLS: false,132 SANITIZE_DOM: true,133 FORCE_BODY: false,134 }) as unknown as HTMLElement135 const doc = root.ownerDocument136 const htmlEl = root.tagName === "HTML" ? root : root.querySelector("html")137 if (!doc || !htmlEl) return empty138 const body = htmlEl.querySelector("body")139 if (!body) return empty140141 // ---- feuilles de style (où qu'elles soient : Gmail accepte <style> dans <head>, certains outils en posent dans <body>)142 let hasDark = false143 const sheets: string[] = []144 for (const el of Array.from(htmlEl.querySelectorAll("style"))) {145 const raw = el.textContent ?? ""146 if (hasDarkStyles(raw)) hasDark = true147 const css = processCss(raw, scheme, collect).replace(/</g, "")148 if (css.trim()) sheets.push(css)149 el.remove()150 }151152 // ---- éléments153 for (const el of Array.from(htmlEl.querySelectorAll("*"))) {154 for (const a of Array.from(el.attributes)) {155 const name = a.name.toLowerCase()156 // ceinture et bretelles : DOMPurify les retire déjà157 if (name.startsWith("on") || name === "srcdoc" || name === "srcset" || name === "formaction") el.removeAttribute(a.name)158 }159 const style = el.getAttribute("style")160 if (style !== null) {161 const css = processCss(style, scheme, collect, true).replace(/[<{}]/g, "")162 if (css.trim()) el.setAttribute("style", css)163 else el.removeAttribute("style")164 }165 // fond d'un tableau ou d'une cellule (attribut HTML hérité, encore utilisé pour Outlook)166 const bg = el.getAttribute("background")167 if (bg !== null) {168 el.removeAttribute("background")169 const url = bg.trim()170 const data = HTTPS_URL.test(url) ? collect.resolve(url) : null171 if (data) el.setAttribute("style", `${el.getAttribute("style") ?? ""};background-image:url("${data}")`.replace(/^;/, ""))172 }173 if (el.tagName === "IMG") {174 const src = (el.getAttribute("src") ?? "").trim()175 if (HTTPS_URL.test(src)) el.setAttribute("src", collect.resolve(src) ?? BLANK_IMAGE)176 else if (!SAFE_DATA_IMAGE.test(src)) el.setAttribute("src", BLANK_IMAGE) // http:, cid:, variable non remplie, chemin relatif…177 } else if (el.hasAttribute("src")) el.removeAttribute("src")178 if (el.tagName === "A" || el.tagName === "AREA") {179 const href = (el.getAttribute("href") ?? "").trim()180 if (href && SAFE_LINK.test(href) && !opts.thumbnail) {181 el.setAttribute("href", href)182 el.setAttribute("target", "_blank")183 el.setAttribute("rel", "noopener noreferrer nofollow")184 } else if (el.hasAttribute("href")) {185 // lien non http(s)/mailto, variable brute, ancre : le lien garde son apparence mais ne mène nulle part186 el.removeAttribute("href")187 el.removeAttribute("target")188 if (href) el.setAttribute("data-inert-link", "")189 }190 } else if (el.hasAttribute("href")) el.removeAttribute("href")191 }192193 let headEl = htmlEl.querySelector("head")194 if (!headEl) {195 headEl = doc.createElement("head")196 htmlEl.insertBefore(headEl, htmlEl.firstChild)197 }198 // tout ce qui restait dans <head> (titre d'origine…) est remplacé par notre en-tête : CSP en premier199 const styleTags = [baseCss(scheme, !!opts.thumbnail), ...sheets].map((css) => `<style>${css}</style>`).join("")200 const lang = escapeAttr(opts.lang ?? htmlEl.getAttribute("lang") ?? "fr")201 const bodyAttrs = Array.from(body.attributes)202 .map((a) => ` ${a.name}="${escapeAttr(a.value)}"`)203 .join("")204 const linkCss = "<style>a[data-inert-link]{cursor:default}</style>"205 return {206 srcdoc: `<!doctype html><html lang="${lang}"><head>${head}${styleTags}${linkCss}</head><body${bodyAttrs}>${body.innerHTML}</body></html>`,207 remoteImages: collect.urls,208 hasDark,209 }210}211212/** Seulement la liste des images distantes d'un modèle (pour les récupérer avant de construire l'aperçu définitif). */213export function collectRemoteImages(html: string, window?: PurifyWindow): string[] {214 return buildPreviewDocument(html, { window }).remoteImages215}216