🇧🇷 BRTools

Uma ferramenta CLI moderna para utilitários brasileiros, desenvolvida para facilitar tarefas do dia a dia relacionadas a documentos e validações do Brasil.

🚀 Funcionalidades

CPF

• ✅ Geração: Gera CPFs válidos aleatoriamente
• 🔍 Validação: Valida CPFs existentes
• 🧮 Dígitos Verificadores: Calcula os dígitos verificadores de um CPF
• 📋 Cópia para Clipboard: Copia automaticamente o resultado
• 🎨 Formatação: Formata CPFs no padrão XXX.XXX.XXX-XX

CNPJ

• ✅ Geração: Gera CNPJs válidos aleatoriamente
• 🔍 Validação: Valida CNPJs existentes
• 🧮 Dígitos Verificadores: Calcula os dígitos verificadores de um CNPJ
• 📋 Cópia para Clipboard: Copia automaticamente o resultado
• 🎨 Formatação: Formata CNPJs no padrão XX.XXX.XXX/XXXX-XX

Hash

• 🔐 Múltiplos Algoritmos: Suporte a bcrypt, MD5, SHA256, SHA512 e Base64
• 📄 Texto e Arquivos: Processa tanto textos quanto arquivos
• ⚙️ Salt Configurável: Permite configurar o salt para bcrypt (padrão: 10)
• 🔒 Hashes Seguros: bcrypt para senhas, SHA256/SHA512 para integridade
• 📋 Cópia para Clipboard: Copia automaticamente o hash gerado

📦 Instalação

npm install -g @joaoseixas/brtools

Nota: O projeto é buildado automaticamente durante a instalação, garantindo que você sempre tenha a versão mais atualizada.

🛠️ Uso

Comando CPF

Gerar CPF

# Gerar um CPF válido
brtools cpf --generate

# Gerar CPF formatado
brtools cpf --generate --formatted

# Gerar CPF e copiar para área de transferência
brtools cpf --generate --copy

Validar CPF

# Validar um CPF
brtools cpf --validate 12345678901

# Validar CPF formatado
brtools cpf --validate 123.456.789-01

Calcular Dígitos Verificadores

# Calcular dígitos verificadores para os 9 primeiros números
brtools cpf --digits 123456789

Comando CNPJ

Gerar CNPJ

# Gerar um CNPJ válido
brtools cnpj --generate

# Gerar CNPJ formatado
brtools cnpj --generate --formatted

# Gerar CNPJ e copiar para área de transferência
brtools cnpj --generate --copy

Validar CNPJ

# Validar um CNPJ
brtools cnpj --validate 11222333000181

# Validar CNPJ formatado
brtools cnpj --validate 11.222.333/0001-81

Calcular Dígitos Verificadores

# Calcular dígitos verificadores para os 12 primeiros números
brtools cnpj --digits 112223330001

Comando Hash

Algoritmos Disponíveis

• bcrypt: Hash seguro para senhas (com salt configurável)
• md5: Hash MD5 (128 bits)
• sha256: Hash SHA-256 (256 bits)
• sha512: Hash SHA-512 (512 bits)
• base64: Codificação Base64

Gerar Hash de Texto

# Hash bcrypt com texto
brtools hash bcrypt --text "minha senha"

# Hash bcrypt com salt customizado
brtools hash bcrypt --text "minha senha" --salt 12

# Hash SHA-256 de um texto
brtools hash sha256 --text "dados importantes"

# Hash MD5 de um texto
brtools hash md5 --text "texto qualquer"

# Codificar em Base64
brtools hash base64 --text "texto para codificar"

# Qualquer hash com cópia para clipboard
brtools hash sha512 --text "meu texto" --copy

Gerar Hash de Arquivo

# Hash SHA-256 de um arquivo
brtools hash sha256 --file "./documento.txt"

# Hash MD5 de um arquivo
brtools hash md5 --file "./imagem.jpg"

# bcrypt de conteúdo de arquivo
brtools hash bcrypt --file "./config.txt" --salt 12

# Base64 de um arquivo (útil para embeds)
brtools hash base64 --file "./logo.png"

# Hash de arquivo com cópia para clipboard
brtools hash sha512 --file "./arquivo.pdf" --copy

Opções Globais

| Opção | Descrição | | ---------------------------- | ---------------------------------------------- | | -g, --generate | Gera um CPF/CNPJ válido | | -v, --validate <documento> | Valida um CPF/CNPJ informado | | -d, --digits <digits> | Calcula dígitos verificadores | | -t, --text <texto> | Texto a ser hasheado | | -f, --file <arquivo> | Arquivo a ser processado/hasheado | | -s, --salt <salt> | Salt para algoritmo bcrypt (padrão: 10) | | -c, --copy | Copia o resultado para a área de transferência | | -f, --formatted | Formata o documento no padrão brasileiro | | --version | Mostra a versão da ferramenta | | --help | Mostra ajuda |

📋 Exemplos

# Exemplo completo: gerar CPF formatado e copiar
brtools cpf --generate --formatted --copy
# Output: 123.456.789-01  ✅ Copiado para a área de transferência

# Validar um CPF
brtools cpf --validate 11144477735
# Output: ✅ CPF válido

# Calcular dígitos verificadores de CPF
brtools cpf --digits 111444777
# Output: Dígitos verificadores: 35

# Gerar CNPJ formatado
brtools cnpj --generate --formatted
# Output: 11.222.333/0001-81

# Validar CNPJ
brtools cnpj --validate 11222333000181
# Output: ✅ CNPJ válido

# Hash bcrypt de texto
brtools hash bcrypt --text "minha senha"
# Output: $2b$10$abc123...xyz789

# Hash SHA-256 de texto
brtools hash sha256 --text "dados importantes"
# Output: a1b2c3d4e5f6...

# Hash MD5 de arquivo
brtools hash md5 --file "./documento.txt"
# Output: 5d41402abc4b...

# Base64 de arquivo
brtools hash base64 --file "./imagem.png"
# Output: iVBORw0KGgoAAAANSUhEUgAA...

# Hash SHA-512 com cópia para clipboard
brtools hash sha512 --text "texto seguro" --copy
# Output: a1b2c3d4e5f6...  ✅ Copiado para a área de transferência

🏗️ Arquitetura

O projeto segue uma arquitetura modular e extensível com carregamento automático de módulos:

src/
├── commander/           # Sistema de comandos
│   └── index.ts        # ProgramStarter - carrega módulos automaticamente
├── exceptions/          # Exceções customizadas
│   └── Validation.ts   # Tratamento de erros de validação
├── helpers/            # Funções utilitárias
│   └── numbers.ts      # Helpers para manipulação de números
├── modules/            # Módulos funcionais
│   ├── cpf/           # Módulo de operações com CPF
│   │   ├── index.ts   # Lógica principal do CPF
│   │   ├── commander.ts  # Configuração de comandos
│   │   └── cpf.spec.ts  # Testes do módulo
│   ├── cnpj/          # Módulo de operações com CNPJ
│   │   ├── index.ts   # Lógica principal do CNPJ
│   │   ├── commander.ts  # Configuração de comandos
│   │   └── cnpj.spec.ts  # Testes do módulo
│   ├── hash/          # Módulo de hash de textos
│   │   ├── index.ts   # Lógica principal do hash
│   │   ├── commander.ts  # Configuração de comandos
│   │   └── types.ts   # Tipos para algoritmos de hash
│   └── module.ts      # Classe base abstrata
├── services/           # Serviços compartilhados
│   └── logger.ts      # Sistema de logging colorido
├── types/             # Definições de tipos TypeScript
└── index.ts           # Ponto de entrada da CLI

Estrutura Modular

• ProgramStarter: Carrega automaticamente todos os módulos com comandos
• CliModule: Classe abstrata que define a interface para todos os módulos
• CPF Module: Implementa todas as operações relacionadas a CPF
• CNPJ Module: Implementa todas as operações relacionadas a CNPJ
• Hash Module: Implementa hash de textos e arquivos com múltiplos algoritmos (bcrypt, MD5, SHA256, SHA512, Base64)
• Logger Service: Fornece logging colorido com chalk
• ValidationException: Tratamento especializado de erros de validação
• NumbersHelper: Funções utilitárias para manipulação de números

🛣️ Roadmap

Próximas Funcionalidades

• 🏦 Códigos Bancários: Validação de códigos de bancos brasileiros
• 📮 CEP: Consulta e validação de CEPs
• 🆔 RG: Validação por estado
• 📞 Telefone: Formatação e validação de números brasileiros
• 💳 Cartão de Crédito: Validação de números de cartão
• 🏛️ Inscrição Estadual: Validação por estado

🧪 Desenvolvimento

Pré-requisitos

• Node.js 16+
• pnpm (recomendado) ou npm

Scripts Disponíveis

# Compilar o projeto
npm run build

# Executar testes
npm run test

# Instalar dependências
pnpm install

# Fazer build e criar nova versão patch
npm run v:patch

Instalação Automática

O projeto está configurado com um script prepare que:

• Compila automaticamente o TypeScript durante a instalação
• Garante que os usuários sempre tenham a versão mais recente
• Não requer distribuição da pasta dist no repositório

Estrutura do Projeto

brtools/
├── src/                    # Código fonte TypeScript
│   ├── commander/         # Sistema de comandos
│   ├── exceptions/        # Exceções customizadas
│   ├── helpers/           # Funções utilitárias
│   ├── modules/           # Módulos funcionais (CPF, CNPJ, Hash, etc.)
│   ├── services/          # Serviços compartilhados
│   └── types/             # Definições de tipos
├── dist/                   # Código compilado (gerado automaticamente)
├── package.json           # Configurações do projeto
├── tsconfig.json          # Configurações TypeScript
└── README.md             # Documentação

🤝 Contribuindo

Contribuições são sempre bem-vindas! Para contribuir:

1. 🍴 Faça um fork do projeto
2. 🌱 Crie uma branch para sua funcionalidade (git checkout -b feature/nova-funcionalidade)
3. ✨ Commit suas mudanças (git commit -m 'Adiciona nova funcionalidade')
4. 📤 Push para a branch (git push origin feature/nova-funcionalidade)
5. 🔄 Abra um Pull Request

Adicionando Novos Módulos

Para adicionar um novo módulo:

1. Crie uma nova pasta em src/modules/nome-do-modulo/
2. Implemente a classe que estenda CliModule
3. Crie o arquivo commander.ts com as configurações do comando
4. Adicione testes no arquivo *.spec.ts
5. O ProgramStarter carregará automaticamente o novo módulo

Exemplo de Estrutura de Módulo

// src/modules/exemplo/index.ts
import { CliModule } from '../module';

export class ExemploModule extends CliModule {
  handle(options: any): CliModule.Result {
    // Sua lógica aqui
    return 'resultado';
  }
}

// src/modules/exemplo/commander.ts
import { Command } from 'commander';
import { ExemploModule } from './index';

export default function (program: Command) {
  program
    .command('exemplo')
    .description('Descrição do seu módulo')
    .option('-o, --option', 'Sua opção')
    .action((options) => {
      const result = new ExemploModule().handle(options);
      console.log(result);
    });
}

🔧 Tecnologias Utilizadas

• TypeScript: Linguagem principal
• Commander.js: Framework para CLI
• Chalk: Colorização de output
• Copy-paste: Funcionalidade de clipboard
• bcrypt: Biblioteca para hash seguro de senhas
• Jest: Framework de testes
• Node.js: Runtime

📄 Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

👨‍💻 Autor

João Seixas

• GitHub: github.com/joaoseixas88
• Projeto: github.com/joaoseixas88/brtools

🌟 Agradecimentos

• Comunidade JavaScript/TypeScript brasileira
• Contributors e usuários da ferramenta
• Inspiração na necessidade de ferramentas brasileiras para desenvolvedores

BRTools - Facilitando a vida dos desenvolvedores brasileiros! 🇧🇷