Lucas F. 7632cfde2c feat: extensão de navegador para gerar CPF/CNPJ no menu de contexto

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.

2026-09-03 17:57:50 -03:00

3.4 KiB

Raw Blame History

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 em input, textarea e contenteditable;
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).

3.4 KiB Raw Blame History