native/src/lib/quote-header.ts

// Default reply/forward quote header. Port of the webmail's lib/quote-header.ts
// (without the plugin transform, which has no RN runtime).
//
// Both the forward "From:" line and the reply "On … wrote:" line show the
// full sender incl. address ("Name <email>"), like Gmail/Outlook (#482). The
// interpolated values are HTML-escaped: an unescaped "<email>" would be parsed
// as a tag by the editor and silently dropped.

import { escapeHtml } from './email-html';
import type { TimeFormat } from '../stores/settings-store';

/** Localized label set the caller passes in (from the locale catalog). */
export interface QuoteHeaderLabels {
  /** Reply line template with `{date}` and `{from}` placeholders. */
  replyLine: string;
  forwardedSeparator: string;
  fromLabel: string;
  dateLabel: string;
  subjectLabel: string;
}

export const DEFAULT_QUOTE_HEADER_LABELS: QuoteHeaderLabels = {
  replyLine: 'On {date}, {from} wrote:',
  forwardedSeparator: '---------- Forwarded message ----------',
  fromLabel: 'From',
  dateLabel: 'Date',
  subjectLabel: 'Subject',
};

/**
 * The labels in the app language. Shared by the composer and the quick reply
 * box so a reply carries the same header whichever one sent it.
 */
export function quoteHeaderLabels(t: (key: string, fallback: string) => string): QuoteHeaderLabels {
  return {
    replyLine: t('quote_header.reply_line', 'On {date}, {from} wrote:'),
    forwardedSeparator: t('quote_header.forwarded_separator', '---------- Forwarded message ----------'),
    fromLabel: t('quote_header.from_label', 'From'),
    dateLabel: t('quote_header.date_label', 'Date'),
    subjectLabel: t('quote_header.subject_label', 'Subject'),
  };
}

export interface QuoteHeader {
  html: string;
  text: string;
  wrapInBlockquote: boolean;
}

export interface QuoteHeaderArgs {
  mode: 'reply' | 'replyAll' | 'forward';
  email: {
    from?: { email?: string; name?: string };
    subject?: string;
    receivedAt?: string;
  };
  timeFormat: TimeFormat;
  locale?: string;
  unknownLabel: string;
  labels?: QuoteHeaderLabels;
}

/** Locale- and 12/24h-aware date with a short weekday (webmail formatDateTime). */
export function formatQuoteDate(iso: string | undefined, timeFormat: TimeFormat, locale?: string): string {
  if (!iso) return '';
  const d = new Date(iso);
  if (Number.isNaN(d.getTime())) return '';
  const intlLocale = !locale || locale === 'en' ? 'en-US' : locale;
  try {
    return d.toLocaleString(intlLocale, {
      weekday: 'short',
      year: 'numeric',
      month: 'short',
      day: 'numeric',
      hour: '2-digit',
      minute: '2-digit',
      hour12: timeFormat === '12h',
    });
  } catch {
    return d.toLocaleString();
  }
}

/** "Name <email>" when both are known and distinct, else whichever exists. */
export function formatQuoteSender(
  from: { email?: string; name?: string } | undefined,
  unknownLabel: string,
): string {
  if (!from) return unknownLabel;
  if (from.name && from.email && from.name !== from.email) return `${from.name} <${from.email}>`;
  return from.email || from.name || unknownLabel;
}

function fillReplyLine(template: string, vars: { date: string; from: string }): string {
  const line = template.replace('{date}', vars.date).replace('{from}', vars.from).replace('{sender}', vars.from);
  // A missing date leaves "On , X wrote:" - collapse the dangling comma.
  return vars.date ? line : line.replace(/^\S+\s*,\s*/, '');
}

export function buildQuoteHeader(args: QuoteHeaderArgs): QuoteHeader {
  const { mode, email, timeFormat, locale, unknownLabel } = args;
  const labels = args.labels ?? DEFAULT_QUOTE_HEADER_LABELS;
  const date = formatQuoteDate(email.receivedAt, timeFormat, locale);
  const fromStrFull = formatQuoteSender(email.from, unknownLabel);
  const subject = email.subject || '';

  if (mode === 'forward') {
    const text = `${labels.forwardedSeparator}\n${labels.fromLabel}: ${fromStrFull}\n${labels.dateLabel}: ${date}\n${labels.subjectLabel}: ${subject}\n`;
    const html = `<div>${labels.forwardedSeparator}<br>${labels.fromLabel}: ${escapeHtml(fromStrFull)}<br>${labels.dateLabel}: ${escapeHtml(date)}<br>${labels.subjectLabel}: ${escapeHtml(subject)}<br><br></div>`;
    return { html, text, wrapInBlockquote: false };
  }

  const text = `${fillReplyLine(labels.replyLine, { date, from: fromStrFull })}\n`;
  const html = `<div>${fillReplyLine(labels.replyLine, { date: escapeHtml(date), from: escapeHtml(fromStrFull) })}<br></div>`;
  return { html, text, wrapInBlockquote: true };
}