Integre o SDK Node e comece a capturar falhas com contexto real.
Guia interno para instalar o pacote, configurar credenciais do projeto e envolver funções críticas com o SDK da Rebound sem sair do console operacional.
@rebound-dlq/node
Use este pacote como ponto de entrada da integração Node dentro dos seus serviços.
HMAC + timestamp
As requisições do SDK já seguem o contrato mais recente de assinatura para a API.
Payload + contexto
Falhas chegam ao console com stack, contexto e base para reprocessamento.
Primeiros passos
Quickstart para colocar o SDK em produção com segurança
A ideia é instalar o pacote, configurar as credenciais do projeto e envolver os pontos de maior risco sem alterar sua estratégia atual de tratamento de erro.
Instale o pacote do SDK
Adicione o pacote Node oficial da Rebound no serviço ou worker que precisa capturar falhas operacionais.
Configure a API Key
Use a API Key do projeto para inicializar o DlqWrapper antes de chamar suas funções críticas. Em self-hosted, informe também o reboundUrl.
Envolva as funções de risco com o wrapper
Passe a execução da função e o payload original para o SDK, preservando contexto desde a origem da falha.
Valide a entrega no console
Force um cenário de erro controlado e confirme no console se o evento foi capturado com payload e stack.
Instalação
Instale o pacote no serviço que vai enviar eventos
Esse comando cobre a instalação inicial para APIs, workers e integrações backend que precisam reportar falhas para a Rebound.
npm install @rebound-dlq/nodeCredenciais do projeto
Separe as credenciais do projeto antes de integrar
O SDK depende da API Key do projeto para assinar e entregar os eventos corretamente. O reboundUrl é opcional e só deve ser informado em self-hosted.
API Key
É o segredo usado pelo SDK para autenticar a entrega com HMAC. Trate esse valor como credencial sensível e mantenha-o fora do código-fonte.
reboundUrl opcional
Informe a URL base da API Rebound somente quando a plataforma estiver em uma instalação self-hosted. No SaaS oficial, deixe esse parâmetro vazio para o SDK usar a API padrão da Rebound.
Exemplo Node
Exemplo completo de integração Node
Este exemplo mostra o padrão recomendado: manter o tratamento local da falha, enquanto o SDK faz a captura, preserva o payload e envia em background para a Rebound.
const { DlqWrapper } = require('@rebound-dlq/node');
const dlq = new DlqWrapper({
projectSecret: process.env.REBOUND_PROJECT_SECRET, // Chave disponível no painel de projetos da Rebound
// Opcional: use reboundUrl apenas em instalações self-hosted.
// reboundUrl: 'https://rebound.seu-dominio.com/api/v1'
});
async function processarPagamento(dados) {
if (dados.valor > 10000) {
throw new Error('Limite excedido na operadora');
}
return 'aprovado';
}
async function run() {
const dados = {
userId: 'u-123',
valor: 15000
};
try {
const resultado = await dlq.execute(
() => processarPagamento(dados),
dados,
{
flowKey: 'pagarme-payments',
flowLabel: 'Integração Pagarme',
flowStep: 'create_charge'
}
);
console.log('Deu tudo certo:', resultado);
} catch (error) {
console.log('Erro local tratado:', error.message);
// O SDK já registrou o evento em background
}
}
run();Como o SDK funciona
O que acontece quando a função falha
A integração deve aumentar a observabilidade e o contexto operacional, sem tirar de você o controle do fluxo local da aplicação.
A falha é interceptada com o payload
O SDK envolve a função crítica, captura o erro, preserva o payload associado e organiza o contexto técnico da execução.
A entrega acontece em background
O evento é assinado, enviado para a API e tratado pela infraestrutura da Rebound sem exigir que você monte uma DLQ própria do zero.
O console vira a camada operacional
Depois da ingestão, seu time encontra o evento com stack, payload, análise e caminho para reprocessamento com mais segurança.
Validação final
Checklist rápido para validar a integração
Antes de considerar a integração pronta, faça uma validação simples no seu ambiente técnico.
- Confirme que o pacote foi instalado no serviço certo e com a versão esperada.
- Verifique se a API Key pertence ao projeto correto e se reboundUrl só foi informado em self-hosted.
- Force uma falha controlada e confirme se o evento aparece no console.
- Revise se payload, stack e contexto chegaram legíveis para triagem.