SSE Tester

2 min de leitura

SSE Tester

O SSE Tester é uma ferramenta de arquivo único para navegador localizada em tools/test-sse. Permite subscrever qualquer número de canais PostgreSQL NOTIFY via uma conexão Server-Sent Events ao vivo e observar os eventos em tempo real.

Funcionalidades

  • Subscrições multicanal — adicione ou remova canais como tags antes de conectar. Todos os canais são passados como parâmetro ?channels= separado por vírgulas.
  • Todos os métodos de autenticação — a aba Password usa HTTP Basic Auth (credenciais diretas, sem necessidade de JWT); a aba Bearer Token aceita um JWT ou token de API.
  • Stream ao vivo — utiliza a Fetch Streams API com AbortController para desconexão limpa. As linhas SSE são analisadas manualmente, de modo que os campos event:, data: e heartbeat (:) são todos tratados corretamente.
  • Realce de sintaxe JSON — os payloads JSON são exibidos com cores.
  • Configurações persistentes — URL, prefixo, banco de dados, nome de usuário e lista de canais são salvos no localStorage.

Autenticação

A ferramenta verifica as credenciais antes de revelar o painel de subscrição. Ao clicar em Verify & Continue, é chamado o capabilities com o cabeçalho escolhido — se o PgArachne retornar uma resposta bem-sucedida, o painel de subscrição é desbloqueado.

  • Aba Password — envia Authorization: Basic <base64(usuário:senha)>. O usuário do banco de dados deve ter GRANT EXECUTE nas funções de destino e acesso ao endpoint SSE; não é necessário GRANT <papel> TO pgarachne.
  • Aba Bearer Token — envia Authorization: Bearer <token>. Cole um JWT (obtido pelo JWT Getter) ou um token de API de longa duração.
Como habilitar: Defina STATIC_FILES_PATH como tools/test-sse e visite http://localhost:8080. Ou abra index.html diretamente no navegador.