@hed-hog/core 0.0.390 → 0.0.393

package/hedhog/frontend/app/mail/log/page.tsx.ejs

@@ -43,6 +43,7 @@ import {
   LayoutGrid,
   List,
   Mail,
+  MailWarning,
   TriangleAlert,
   User,
 } from 'lucide-react';
@@ -65,12 +66,34 @@ type MailSent = {
   cc?: string;
   bcc?: string;
   body: string;
+  provider_message_id?: string | null;
+  delivery_status?: MailDeliveryStatus | null;
+  delivery_updated_at?: string | null;
   created_at: string;
   updated_at: string;
   mail_sent_user?: MailSentRecipientLog[];
+  mail_delivery_event?: MailDeliveryEvent[];
   deliverySummary?: MailDeliverySummary;
 };
 
+/**
+ * Desfecho reportado pelo provedor. `null` significa que ele aceitou a mensagem
+ * e nao disse mais nada - que era o unico estado possivel antes do webhook de
+ * entrega existir.
+ */
+type MailDeliveryStatus = 'delivered' | 'bounced' | 'complained' | 'rejected';
+
+type MailDeliveryEvent = {
+  id: number;
+  recipient_email?: string | null;
+  event_type: string;
+  bounce_type?: string | null;
+  bounce_subtype?: string | null;
+  diagnostic_code?: string | null;
+  reporting_mta?: string | null;
+  occurred_at: string;
+};
+
 type MailSentRecipientLog = {
   id: number;
   recipient_email: string;
@@ -94,6 +117,13 @@ type MailDeliverySummary = {
 };
 
 type DeliveryStatusFilter = 'all' | 'received' | 'read' | 'error';
+type DeliveryOutcomeFilter =
+  | 'all'
+  | 'pending'
+  | 'delivered'
+  | 'bounced'
+  | 'complained'
+  | 'rejected';
 type HasErrorFilter = 'all' | 'true' | 'false';
 type ViewMode = 'cards' | 'table';
 
@@ -107,6 +137,8 @@ export default function MailLogPage() {
   const [recipientEmail, setRecipientEmail] = useState('');
   const [statusFilter, setStatusFilter] = useState<DeliveryStatusFilter>('all');
   const [hasErrorFilter, setHasErrorFilter] = useState<HasErrorFilter>('all');
+  const [deliveryFilter, setDeliveryFilter] =
+    useState<DeliveryOutcomeFilter>('all');
   const [createdAtFrom, setCreatedAtFrom] = useState('');
   const [createdAtTo, setCreatedAtTo] = useState('');
   const [viewMode, setViewMode] = useState<ViewMode>('cards');
@@ -162,6 +194,7 @@ export default function MailLogPage() {
       debouncedRecipientEmail,
       statusFilter,
       hasErrorFilter,
+      deliveryFilter,
       createdAtFrom,
       createdAtTo,
       page,
@@ -175,6 +208,7 @@ export default function MailLogPage() {
           recipientEmail: debouncedRecipientEmail || undefined,
           status: statusFilter !== 'all' ? statusFilter : undefined,
           hasError: hasErrorFilter !== 'all' ? hasErrorFilter : undefined,
+          deliveryStatus: deliveryFilter !== 'all' ? deliveryFilter : undefined,
           createdAtFrom: createdAtFrom || undefined,
           createdAtTo: createdAtTo || undefined,
           page,
@@ -252,6 +286,24 @@ export default function MailLogPage() {
           { value: 'false', label: t('errorNone') },
         ],
       },
+      {
+        id: 'delivery-status',
+        type: 'select',
+        value: deliveryFilter,
+        onChange: (value) => {
+          setDeliveryFilter(value as DeliveryOutcomeFilter);
+          setPage(1);
+        },
+        placeholder: t('filterByDelivery'),
+        options: [
+          { value: 'all', label: t('deliveryAll') },
+          { value: 'pending', label: t('deliveryPending') },
+          { value: 'delivered', label: t('deliveryDelivered') },
+          { value: 'bounced', label: t('deliveryBounced') },
+          { value: 'complained', label: t('deliveryComplained') },
+          { value: 'rejected', label: t('deliveryRejected') },
+        ],
+      },
       {
         id: 'created-at-from',
         type: 'date',
@@ -273,7 +325,7 @@ export default function MailLogPage() {
         min: createdAtFrom || undefined,
       },
     ],
-    [createdAtFrom, createdAtTo, hasErrorFilter, statusFilter, t]
+    [createdAtFrom, createdAtTo, deliveryFilter, hasErrorFilter, statusFilter, t]
   );
 
   const summary = useMemo(() => {
@@ -286,6 +338,15 @@ export default function MailLogPage() {
         if (deliverySummary?.hasError) {
           acc.emailsWithError += 1;
         }
+        // Aceito pelo provedor e devolvido depois: o caso que antes ficava
+        // invisivel, porque o envio constava como bem-sucedido.
+        if (
+          log.delivery_status === 'bounced' ||
+          log.delivery_status === 'complained' ||
+          log.delivery_status === 'rejected'
+        ) {
+          acc.undelivered += 1;
+        }
         return acc;
       },
       {
@@ -293,6 +354,7 @@ export default function MailLogPage() {
         readCount: 0,
         errorCount: 0,
         emailsWithError: 0,
+        undelivered: 0,
       }
     );
   }, [logs]);
@@ -305,6 +367,9 @@ export default function MailLogPage() {
         value: total,
         icon: Mail,
         layout: 'compact',
+        accentClassName: 'from-slate-500/25 via-slate-500/10 to-transparent',
+        iconContainerClassName:
+          'bg-slate-500/10 text-slate-700 dark:text-slate-300',
       },
       {
         key: 'totalRecipients',
@@ -312,6 +377,8 @@ export default function MailLogPage() {
         value: summary.totalRecipients,
         icon: Inbox,
         layout: 'compact',
+        accentClassName: 'from-sky-500/25 via-sky-500/10 to-transparent',
+        iconContainerClassName: 'bg-sky-500/10 text-sky-700 dark:text-sky-400',
       },
       {
         key: 'readRecipients',
@@ -319,6 +386,19 @@ export default function MailLogPage() {
         value: summary.readCount,
         icon: Eye,
         layout: 'compact',
+        accentClassName: 'from-emerald-500/25 via-emerald-500/10 to-transparent',
+        iconContainerClassName:
+          'bg-emerald-500/10 text-emerald-700 dark:text-emerald-400',
+      },
+      {
+        key: 'undelivered',
+        title: t('undeliveredCurrentPage'),
+        value: summary.undelivered,
+        description: t('undeliveredHint'),
+        icon: MailWarning,
+        layout: 'compact',
+        accentClassName: 'from-rose-500/25 via-rose-500/10 to-transparent',
+        iconContainerClassName: 'bg-rose-500/10 text-rose-700 dark:text-rose-400',
       },
       {
         key: 'emailsWithError',
@@ -326,12 +406,16 @@ export default function MailLogPage() {
         value: summary.emailsWithError,
         icon: TriangleAlert,
         layout: 'compact',
+        accentClassName: 'from-amber-500/25 via-amber-500/10 to-transparent',
+        iconContainerClassName:
+          'bg-amber-500/10 text-amber-700 dark:text-amber-400',
       },
     ],
     [
       summary.emailsWithError,
       summary.readCount,
       summary.totalRecipients,
+      summary.undelivered,
       t,
       total,
     ]
@@ -344,6 +428,45 @@ export default function MailLogPage() {
       : text;
   };
 
+  /**
+   * Desfecho que o provedor reportou.
+   *
+   * Vem primeiro na coluna porque responde a pergunta que os contadores de
+   * leitura nao respondem: a mensagem chegou? Sem isto, "enviado" queria dizer
+   * apenas "o provedor aceitou".
+   */
+  const renderDeliveryStatus = (log: MailSent) => {
+    const status = log.delivery_status;
+
+    if (!status) {
+      return (
+        <Badge
+          variant="outline"
+          className="border-dashed text-muted-foreground"
+          title={t('deliveryPendingHint')}
+        >
+          {t('deliveryPending')}
+        </Badge>
+      );
+    }
+
+    const styles: Record<MailDeliveryStatus, string> = {
+      delivered:
+        'border-emerald-500/30 bg-emerald-500/10 text-emerald-700 dark:text-emerald-400',
+      bounced: 'border-rose-500/30 bg-rose-500/10 text-rose-700 dark:text-rose-400',
+      complained:
+        'border-amber-500/30 bg-amber-500/10 text-amber-700 dark:text-amber-400',
+      rejected:
+        'border-rose-500/30 bg-rose-500/10 text-rose-700 dark:text-rose-400',
+    };
+
+    return (
+      <Badge variant="outline" className={styles[status]}>
+        {t(`delivery${status.charAt(0).toUpperCase()}${status.slice(1)}` as never)}
+      </Badge>
+    );
+  };
+
   const renderDeliveryBadges = (deliverySummary?: MailDeliverySummary) => {
     if (!deliverySummary) {
       return <Badge variant="outline">{t('statusUnavailable')}</Badge>;
@@ -503,7 +626,10 @@ export default function MailLogPage() {
                       {log.to}
                     </TableCell>
                     <TableCell>
-                      {renderDeliveryBadges(log.deliverySummary)}
+                      <div className="flex flex-wrap items-center gap-2">
+                        {renderDeliveryStatus(log)}
+                        {renderDeliveryBadges(log.deliverySummary)}
+                      </div>
                     </TableCell>
                     <TableCell>
                       {formatDate(log.created_at, getSettingValue)}
@@ -564,7 +690,10 @@ export default function MailLogPage() {
                         </span>
                       </div>
                     </div>
-                    {renderDeliveryBadges(log.deliverySummary)}
+                    <div className="flex flex-wrap items-center gap-2">
+                      {renderDeliveryStatus(log)}
+                      {renderDeliveryBadges(log.deliverySummary)}
+                    </div>
                   </div>
                   <Button
                     variant="outline"
@@ -638,6 +767,18 @@ export default function MailLogPage() {
                     </p>
                   </div>
                 )}
+                {/* Chave para procurar a mensagem no console do provedor (SES,
+                    SMTP) e descobrir se houve entrega, bounce ou supressao. */}
+                {selectedLog.provider_message_id && (
+                  <div>
+                    <h4 className="mb-2 text-sm font-semibold">
+                      {t('providerMessageId')}
+                    </h4>
+                    <p className="break-all rounded-md bg-muted p-3 font-mono text-xs">
+                      {selectedLog.provider_message_id}
+                    </p>
+                  </div>
+                )}
                 <div>
                   <h4 className="mb-2 text-sm font-semibold">{t('body')}</h4>
                   <div
@@ -652,6 +793,7 @@ export default function MailLogPage() {
                   </h4>
                   <div className="rounded-md border p-3">
                     <div className="mb-3 flex flex-wrap gap-2">
+                      {renderDeliveryStatus(selectedLog)}
                       {renderDeliveryBadges(selectedLog.deliverySummary)}
                       <Badge variant="outline">
                         {t('totalRecipientsLabel', {
@@ -722,6 +864,71 @@ export default function MailLogPage() {
                   </div>
                 </div>
 
+                {/*
+                  O que o provedor disse depois de aceitar a mensagem. O bloco
+                  acima so cobre destinatario que e usuario da plataforma; para
+                  um solicitante externo, este e o unico rastro de entrega.
+                */}
+                <div>
+                  <h4 className="mb-2 text-sm font-semibold">
+                    {t('providerEvents')}
+                  </h4>
+                  {selectedLog.mail_delivery_event &&
+                  selectedLog.mail_delivery_event.length > 0 ? (
+                    <div className="space-y-2">
+                      {selectedLog.mail_delivery_event.map((event) => (
+                        <div
+                          key={event.id}
+                          className="rounded-md border border-border/60 p-3"
+                        >
+                          <div className="flex flex-wrap items-center justify-between gap-2">
+                            <div className="text-sm font-medium">
+                              {event.recipient_email ?? t('allRecipients')}
+                            </div>
+                            <div className="flex flex-wrap items-center gap-2">
+                              <Badge variant="outline" className="uppercase">
+                                {event.event_type}
+                              </Badge>
+                              <span className="text-xs text-muted-foreground">
+                                {formatDate(event.occurred_at, getSettingValue)}
+                              </span>
+                            </div>
+                          </div>
+
+                          {event.bounce_type ? (
+                            <p className="mt-2 text-xs text-muted-foreground">
+                              {event.bounce_type}
+                              {event.bounce_subtype
+                                ? ` / ${event.bounce_subtype}`
+                                : ''}
+                            </p>
+                          ) : null}
+
+                          {/*
+                            A resposta literal do servidor destinatario: e a
+                            unica coisa na tela que responde "por que nao chegou".
+                          */}
+                          {event.diagnostic_code ? (
+                            <p className="mt-2 break-all rounded-md bg-muted p-2 font-mono text-xs">
+                              {event.diagnostic_code}
+                            </p>
+                          ) : null}
+
+                          {event.reporting_mta ? (
+                            <p className="mt-1 text-xs text-muted-foreground">
+                              {t('reportingMta')}: {event.reporting_mta}
+                            </p>
+                          ) : null}
+                        </div>
+                      ))}
+                    </div>
+                  ) : (
+                    <p className="text-sm text-muted-foreground">
+                      {t('noProviderEvents')}
+                    </p>
+                  )}
+                </div>
+
                 <div className="grid grid-cols-2 gap-4">
                   <div>
                     <h4 className="mb-2 text-sm font-semibold">