7632cfde2c
Adiciona uma extensão MV3 (Firefox e Chromium/Brave) que insere CPF ou CNPJ
válido direto no campo focado, pelo menu de contexto de qualquer input,
textarea ou contenteditable.
Extensões rodam em sandbox sem acesso a processos, então não há como invocar
os binários cpfgen/cnpjgen; fazer isso exigiria um host de native messaging
registrado no SO. Como os algoritmos são curtos e puros, foram portados para
JS em extension/generator.js, a partir de main.go (CPF) e de
cnpj_generator/cnpj/generate.go (CNPJ), trocando math/rand por
crypto.getRandomValues. test_generator.mjs compara as duas implementações
para que não divirjam.
A inserção usa document.execCommand("insertText"), que emite os eventos
nativos e portanto funciona em campos controlados por React/Vue — atribuir
.value diretamente seria descartado por esses frameworks.
Somente desktop: o Firefox para Android não implementa a API menus.
Testes carregam a extensão de verdade nos dois navegadores e verificam que os
8 itens de menu são criados e que a inserção funciona nos três tipos de campo.
|
||
|---|---|---|
| extension | ||
| .gitignore | ||
| go.mod | ||
| main.go | ||
| main_test.go | ||
| Makefile | ||
| README.md | ||
cpfgen
CLI para gerar CPFs válidos em Go, mais uma extensão de navegador que gera CPF e CNPJ pelo menu de contexto de qualquer campo de texto.
Instalação
make build
Rodar os testes
make test
Uso
./bin/cpfgen # 487.197.991-10
./bin/cpfgen -num # 48719799110
Extensão de navegador
Em extension/. Clique com o botão direito em qualquer input, textarea ou
campo contenteditable e escolha Gerar CPF ou Gerar CNPJ — o valor é
inserido direto no campo, na posição do cursor.
Cada menu oferece formatado e só números; o CNPJ inclui também as duas variantes alfanuméricas (formato novo).
A extensão não chama os binários Go: extensões rodam num sandbox sem acesso
a processos do sistema, e fazer isso exigiria um host de native messaging
registrado no sistema operacional. Como os algoritmos são curtos e puros, eles
foram portados para JS em extension/generator.js, a partir de main.go (CPF) e
de cnpj_generator/cnpj/generate.go (CNPJ). make ext-test compara as duas
implementações para garantir que não divirjam.
Não pede permissão de rede nem de acesso a sites, não coleta nada e funciona offline.
Somente desktop. O Firefox para Android não implementa a API menus — pela
documentação da Mozilla,
"menus, which means you cannot add options to context menus". Como a
extensão é inteiramente baseada no menu de contexto, ela não tem como funcionar
lá. Por isso o manifesto não declara gecko_android.
Instalar no Firefox
Temporário (some ao fechar o navegador):
- Abra
about:debugging#/runtime/this-firefox - Carregar extensão temporária…
- Escolha
extension/manifest.json
Permanente: o Firefox só instala extensões assinadas. Rode make ext-build e
envie web-ext-artifacts/cpfgen-1.0.0.zip para
addons.mozilla.org — dá para publicar
como unlisted e receber um .xpi assinado só seu, sem listar na loja.
Para desenvolver, make ext-run abre um Firefox já com a extensão carregada e
recarrega a cada alteração.
Instalar no Brave
- Abra
brave://extensions - Ligue o Modo do desenvolvedor (canto superior direito)
- Carregar sem compactação e escolha a pasta
extension/
Isso persiste entre reinicializações. O Brave mostra um aviso sobre extensões em modo desenvolvedor a cada início — é esperado. O mesmo procedimento vale para Chrome, Chromium e Edge.
Testes da extensão
make ext-test # porte JS vs. binários Go + extensão real no Firefox e no Brave
make ext-lint # validação oficial da Mozilla (web-ext lint)
make ext-build # gera o .zip para publicação
make ext-test roda três coisas:
test_generator.mjs— gera centenas de amostras pelo JS e pelos binários Go e revalida todos os dígitos verificadores com uma implementação independente;test_extension.py— sobe um Firefox headless, instala a extensão de verdade, confere que os 8 itens de menu foram criados e que a inserção funciona eminput,textareaecontenteditable;test_chromium.py— carrega a extensão no Brave headless e confere que o service worker MV3 sobe e registra os mesmos 8 itens.
Precisa de node, python3, firefox e brave (os dois navegadores e os
binários Go são pulados com aviso se não estiverem presentes).