npm package: @ktfth/gerador-senhas-offline
Description: 🔐 Gerador de senhas seguras e offline para linha de comando
Author: Seu Nome
Latest version: 1.0.0

# 🔐 Gerador de Senhas Offline

Um gerador de senhas seguras e completamente offline, desenvolvido com Bun e TypeScript.

## ✨ Características

- **100% Offline**: Funciona sem conexão com internet
- **Criptograficamente Seguro**: Usa `crypto.getRandomValues()` para aleatoriedade
- **Totalmente Customizável**: Configure comprimento, tipos de caracteres, etc.
- **Armazenamento Local**: Salve senhas localmente (criptografadas no seu dispositivo)
- **Análise de Força**: Avalia automaticamente a segurança da senha
- **Interface CLI Intuitiva**: Menu interativo fácil de usar

## 🚀 Instalação

### Pré-requisitos
- [Bun](https://bun.sh/) instalado no sistema

### Passos
```bash
# Clone ou baixe os arquivos
# Navegue até a pasta do projeto
cd gerador-senhas-offline

# Instale dependências (se necessário)
bun install

# Execute o gerador
bun run start
```

## 📋 Como Usar

1. **Execute o programa**: `bun run start`
2. **Escolha uma opção** no menu:
   - **Opção 1**: Gerar nova senha personalizada
   - **Opção 2**: Ver senhas salvas anteriormente  
   - **Opção 3**: Deletar senhas salvas
   - **Opção 4**: Sair do programa

### Configurações de Senha

Ao gerar uma nova senha, você pode configurar:

- **Comprimento**: De 4 a 128 caracteres
- **Maiúsculas**: A-Z
- **Minúsculas**: a-z  
- **Números**: 0-9
- **Símbolos**: !@#$%^&*()_+-=[]{}|;:,.<>?
- **Excluir similares**: Remove caracteres como i, l, 1, L, o, 0, O

## 🔒 Segurança

- **Aleatoriedade criptográfica**: Utiliza a API `crypto.getRandomValues()`
- **Armazenamento local**: Senhas ficam apenas no seu dispositivo
- **Sem conexão externa**: Nenhum dado é enviado para servidores
- **Código aberto**: Você pode auditar todo o código

## 📊 Análise de Força

O sistema avalia a força das senhas baseado em:
- Comprimento da senha
- Variedade de tipos de caracteres
- Diversidade de caracteres únicos

**Níveis**: Fraca → Média → Forte → Muito Forte

## 📁 Estrutura de Arquivos

```
gerador-senhas-offline/
├── index.ts          # Código principal
├── package.json      # Configurações do projeto
├── passwords.json    # Senhas salvas (criado automaticamente)
└── README.md        # Este arquivo
```

## 🛠️ Scripts Disponíveis

```bash
# Executar o gerador
bun run start

# Modo desenvolvimento (reinicia automaticamente)
bun run dev

# Compilar para distribuição
bun run build
```

## 💡 Exemplos de Uso

### Senha para Login Geral
- Comprimento: 16 caracteres
- Maiúsculas: ✅ | Minúsculas: ✅ | Números: ✅ | Símbolos: ❌

### Senha de Alta Segurança  
- Comprimento: 32 caracteres
- Maiúsculas: ✅ | Minúsculas: ✅ | Números: ✅ | Símbolos: ✅

### Senha Memorável
- Comprimento: 12 caracteres
- Maiúsculas: ✅ | Minúsculas: ✅ | Números: ✅ | Símbolos: ❌
- Excluir similares: ✅

## 🤝 Contribuição

Sinta-se livre para:
- Reportar bugs
- Sugerir melhorias
- Fazer fork do projeto
- Enviar pull requests

## 📄 Licença

MIT License - veja o arquivo de licença para detalhes.

## ⚠️ Importante

- **Faça backup** das suas senhas importantes
- **Use senhas únicas** para cada serviço
- **Mantenha o arquivo passwords.json seguro**
- **Considere usar um gerenciador de senhas** para uso diário

---

*Desenvolvido com ❤️ usando Bun e TypeScript*