/**
* 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 '';
};