✅ README.md

rev-log-worker

Middleware de logging HTTP para aplicações Express, com suporte a:

• Compressão GZIP
• Criptografia RSA + AES opcional
• Envio via Socket.IO ou HTTP POST
• Formato de log detalhado da requisição e resposta
• Suporte a arquivos e formulários (form-data)

📦 Instalação

npm install rev-log-worker

🚀 Uso

const express = require('express');
const createLogMiddleware = require('rev-log-worker');

const app = express();

app.use(createLogMiddleware({
  justRequest: false, // true = só HTTP POST, false = também socket se for log leve
  isCrypt: true, // true = criptografa os logs com RSA+AES
  socketUrl: 'http://localhost:4000', // URL do servidor de socket.io
  apiUrl: 'https://meu-api.com/logs', // URL para envio via POST
  publicKeyPem: '-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqh...', // Chave pública em PEM
  clientName: 'my-app-name' // Identificação do cliente
}));

⚙️ Opções

| Opção | Tipo | Padrão | Descrição | |-------|------|--------|-----------| | justRequest | boolean | true | Se true, envia só via HTTP; se false e log for leve, envia via socket | | isCrypt | boolean | true | Ativa criptografia com RSA + AES | | socketUrl | string | 'http://localhost:4000' | URL para conexão Socket.IO | | apiUrl | string | 'https://webhook.site/...' | URL de fallback/envio HTTP | | publicKeyPem | string | undefined | Chave pública RSA para criptografar (obrigatória se isCrypt=true) | | clientName | string | 'unknown' | Nome do cliente para identificação |

📄 Formato do Log

O log contém informações completas da requisição e resposta, incluindo:

• headers, body, arquivos (upload), tempo de resposta
• IP, URL, método, sessão, user-agent

Enviado como objeto JSON (com ou sem criptografia)

🔐 Criptografia

Se isCrypt for true, o payload será criptografado com AES-128-CBC e a chave AES com a chave pública RSA fornecida (PEM).

💡 Exemplo de envio via Socket.IO

Certifique-se de que o servidor de destino escute o evento http-log:

io.on('connection', (socket) => {
  socket.on('http-log', (log) => {
    console.log('Log recebido:', log);
  });
});

📤 Exemplo de payload HTTP

{
  "encryptedKey": "...",
  "iv": "...",
  "encryptedData": "...",
  "client": "my-app-name"
}

🪪 Licença

MIT © 2025 Davi