🍝 Pestto

Uma extensão de navegador minimalista que converte automaticamente a formatação Markdown ao colar textos no WhatsApp Web.

(O nome é uma brincadeira com "paste + to" e um trocadilho com o famoso molho pesto).

🎯 Objetivo

O Pestto foi criado para resolver um problema recorrente: copiar respostas geradas por IA (que geralmente usam Markdown) e colá-las no WhatsApp Web perdendo toda a formatação original.

Este é um projeto open-source, focado em simplicidade extrema, elegância e segurança. Não há coleta de dados, nem comunicação externa.

🚀 Como instalar

Opção 1 — Chrome Web Store (recomendado):

Instale diretamente pela Chrome Web Store.

Opção 2 — Modo Desenvolvedor (instalação local):

1. Faça o download ou clone este repositório.
2. Abra o seu navegador (Chrome, Edge, Brave, etc.) e acesse a página de extensões (chrome://extensions/).
3. Ative o "Modo do desenvolvedor" no canto superior direito.
4. Clique em "Carregar sem compactação" (Load unpacked) e selecione a pasta do Pestto.
5. Abra o WhatsApp Web e faça um teste colando um texto com **negrito** ou *itálico*.

🏗️ Como funciona (Arquitetura)

A extensão intercepta o evento global de paste no navegador, rodando exclusivamente no domínio https://web.whatsapp.com/*.

• Verifica se o usuário está em um campo contenteditable (a caixa de mensagem).
• Lê o texto puro da área de transferência (text/plain).
• Converte a sintaxe Markdown para a sintaxe do WhatsApp em memória.
• Previne o comportamento padrão e insere o texto já formatado.

O que a extensão NÃO FAZ:

Seguindo princípios estritos de segurança e privacidade:

• Não lê suas mensagens enviadas ou recebidas.
• Não percorre o DOM da página.
• Não usa MutationObserver.
• Não possui UI, configurações ou armazenamento de dados (Storage).
• Não faz requisições a servidores externos (Zero rede).
• Não rastreia seu uso (Zero analytics).

🧪 Testes

A lógica de conversão é isolada do navegador e coberta por testes automatizados utilizando Vitest. As suítes de teste estão localizadas na pasta tests/.

Atualmente, o projeto possui 33 testes unitários que garantem a integridade da conversão e dos scripts de build.

Para rodar os testes localmente:

npm install
npm test            # Executa os testes uma única vez e encerra
npm run test:watch  # Executa os testes e aguarda alterações (modo interativo)

🔢 Versionamento

Este projeto utiliza um sistema híbrido para atender aos requisitos da Chrome Web Store:

1. SemVer: O package.json segue o Semantic Versioning (ex: 0.4.3-rc.1).
2. Chrome Version: O manifesto usa uma versão sanitizada de 4 dígitos (X.Y.Z.N):
   • Os 3 primeiros dígitos são extraídos do SemVer (ex: 0.4.3-rc.1 vira 0.4.3).
   • O 4º dígito é o Build Number (apenas em builds do CI), permitindo versões únicas na loja para cada execução do pipeline.

🔍 Qualidade de Código

O projeto usa ESLint (com escopos distintos para browser, Node e Vitest) e Prettier para manter a consistência do código.

O Husky configura um hook pre-commit que, via lint-staged, roda ESLint + Prettier nos arquivos em staging antes de cada commit. Se houver problemas, o commit é abortado, as correções são aplicadas na working tree para revisão, e os testes unitários só são executados se o lint passar.

npm run lint        # verifica todos os arquivos
npm run lint:fix    # corrige automaticamente
npm run format      # formata todos os arquivos
npm run format:check  # apenas verifica (sem alterar)

🚢 Release e Deploy

O processo de liberação (homologação por ZIP RC, checklist, publicação oficial e deploy na loja) está centralizado em release.md.

Se você é novo no projeto e precisa liberar uma versão, comece por lá.

🤝 Contribuição

Contribuições são bem-vindas! O foco atual é manter a extensão pequena, clara e com as permissões mínimas possíveis. Se você encontrar casos onde a conversão falha (edge cases do Regex), sinta-se à vontade para abrir uma Issue ou enviar um Pull Request.