analizador-eml

O analisador EML lê mensagens EML/MIME para extrair e resumir cabeçalhos, partes MIME, anexos, codificação e origem. Público-alvo: desenvolvedores, analistas de segurança, administradores de TI e responders de incidentes que precisam validar a estrutura do e-mail, reconstruir mensagens para auditorias ou integrar dados de e-mail em pipelines de processamento. Casos de uso incluem depuração de entrega, verificação de integridade de cabeçalhos após transferências MTA, identificação de indicadores de phishing no payload, extração de anexos para indexação ou varredura de malware e geração de fixtures para testar fluxos de processamento de e-mails.
Lógica central: parsing compatível com RFC 5322, construção de árvore MIME, normalização de cabeçalhos e extração de From/To/Subject/Date, Message-ID e dicas de autenticação de cabeçalhos (DKIM/SPF/DMARC). Também expõe content-type, transfer-encoding e charset, com um resumo estruturado: dicionário de headers, partes do corpo e metadados de anexos. Funções obrigatórias: aceitar arquivo ou texto EML cru, lidar com multi-partes, tolerar dados parciais e pequenas corrupções e produzir saídas determinísticas. Funções avançadas (opcionais): detectar a parte principal do corpo, distinguir conteúdo embutido de anexos, decodificar encodings comuns e redigir campos sensíveis para compartilhamento mais seguro. Desempenho: decodificação em streaming para arquivos grandes e uso de memória seguro.
Inputs e outputs: incluem arquivo EML ou string EML cru, opções para incluir partes binárias, decodificar palavras codificadas e tamanho máximo de anexos. Saídas: resumo em formato JSON com cabeçalhos, metadados representativos, textos do corpo, anexos e detalhes de encoding.
Algoritmos e cálculos: construção da árvore MIME, decodificação de cabeçalhos RFC2047, decodificação base64/quoted-printable, resolução de fronteiras e seleção de partes do corpo. Contagem de anexos e partes e indicação de anomalias. Sem chamadas a servidores externos nem decriptação.
Tratamento de erros: entradas inválidas, leituras parciais e fronteiras corrompidas com fallbacks seguros. Observações de localização: usa bytes e datas ISO; opções de redaction e privacidade disponíveis. Suposições: entrada semelhante a RFC822; exclusões: acesso direto a caixas de correio, decriptação ou indexação de caixas.