/** * CENTRAL EMAIL FORMATTING UTILITY * * This is the centralized email formatting utility used throughout the application. * It provides consistent handling of email content, sanitization, and text direction. * * All code that needs to format email content should import from this file. * Text direction is preserved based on content language for proper RTL/LTR display. */ import DOMPurify from 'isomorphic-dompurify'; // Reset any existing hooks to start clean DOMPurify.removeAllHooks(); // Configure DOMPurify for English-only content (always LTR) DOMPurify.addHook('afterSanitizeAttributes', function(node) { // We no longer force LTR direction on all elements // This allows the natural text direction to be preserved if (node instanceof HTMLElement) { // Only set direction if not already specified if (!node.hasAttribute('dir')) { // Add dir attribute only if not present node.setAttribute('dir', 'auto'); } // Don't forcibly modify text alignment or direction in style attributes // This allows the component to control text direction instead } }); // Configure DOMPurify to preserve direction attributes DOMPurify.setConfig({ ADD_ATTR: ['dir'], ALLOWED_ATTR: ['style', 'class', 'id', 'dir'] }); // Note: We ensure LTR text direction is applied in the component level // when rendering email content // Interface definitions export interface EmailAddress { name: string; address: string; } export interface EmailMessage { id: string; messageId?: string; subject: string; from: EmailAddress[]; to: EmailAddress[]; cc?: EmailAddress[]; bcc?: EmailAddress[]; date: Date | string; flags?: { seen: boolean; flagged: boolean; answered: boolean; deleted: boolean; draft: boolean; }; preview?: string; content?: string; html?: string; text?: string; hasAttachments?: boolean; attachments?: any[]; folder?: string; size?: number; contentFetched?: boolean; } /** * Format email addresses for display */ export function formatEmailAddresses(addresses: EmailAddress[]): string { if (!addresses || addresses.length === 0) return ''; return addresses.map(addr => addr.name && addr.name !== addr.address ? `${addr.name} <${addr.address}>` : addr.address ).join(', '); } /** * Format date for display */ export function formatEmailDate(date: Date | string | undefined): string { if (!date) return ''; try { const dateObj = typeof date === 'string' ? new Date(date) : date; return dateObj.toLocaleString('en-US', { weekday: 'short', year: 'numeric', month: 'short', day: 'numeric', hour: '2-digit', minute: '2-digit' }); } catch (e) { return typeof date === 'string' ? date : date.toString(); } } /** * Sanitize HTML content before processing or displaying * This ensures the content is properly sanitized while preserving text direction * @param content HTML content to sanitize * @returns Sanitized HTML with preserved text direction */ export function sanitizeHtml(content: string): string { if (!content) return ''; // Sanitize the HTML using our configured DOMPurify with text direction preserved return DOMPurify.sanitize(content); } /** * Format an email for forwarding - CENTRAL IMPLEMENTATION * All other formatting functions should be deprecated in favor of this one */ export function formatForwardedEmail(email: EmailMessage): { subject: string; content: string; } { // Format subject with Fwd: prefix if needed const subjectBase = email.subject || '(No subject)'; const subject = subjectBase.match(/^(Fwd|FW|Forward):/i) ? subjectBase : `Fwd: ${subjectBase}`; // Get sender and recipient information const fromString = formatEmailAddresses(email.from || []); const toString = formatEmailAddresses(email.to || []); const dateString = formatEmailDate(email.date); // Get and sanitize original content (sanitization preserves content direction) const originalContent = sanitizeHtml(email.content || email.html || email.text || ''); // Check if the content already has a forwarded message header const hasExistingHeader = originalContent.includes('---------- Forwarded message ---------'); // If there's already a forwarded message header, don't add another one if (hasExistingHeader) { // Just wrap the content without additional formatting const content = `