/** * HTML escaping utilities to prevent XSS in tooltip HTML generation. * * All data from external API responses must be escaped before interpolation * into HTML template strings. */ const ESCAPE_MAP: Record = { '&': '&', '<': '<', '>': '>', '"': '"', "'": ''', }; const ESCAPE_RE = /[&<>"']/g; /** * Escape a string for safe insertion into HTML content or attribute values. * Returns an empty string if the input is nullish. */ export const escapeHtml = (str: unknown): string => { if (str == null) return ''; return String(str).replace(ESCAPE_RE, (ch) => ESCAPE_MAP[ch]); }; const SAFE_PROTOCOLS = new Set(['http:', 'https:', 'mailto:']); /** * Sanitize a URL for safe use in href attributes. * Only allows http:, https:, and mailto: protocols. * Uses the browser's URL parser to reliably detect the protocol, * avoiding edge cases that string-matching can miss. * Returns an empty string for dangerous protocols (javascript:, data:, etc). */ export const sanitizeUrl = (url: unknown): string => { if (url == null) return ''; const str = String(url).trim(); if (str === '') return ''; // Relative URLs are allowed if (str.startsWith('/') || str.startsWith('#') || str.startsWith('?')) { return escapeHtml(str); } try { const parsed = new URL(str); if (SAFE_PROTOCOLS.has(parsed.protocol)) { return escapeHtml(str); } } catch { // Invalid URL — block it } return ''; };