@rewritetoday/hono e o adapter da Rewrite para apps Hono rodando em edge ou em runtimes compativeis com Node.
Repositorio: github.com/RewriteToday/adapters
Quando usar
- Quando sua aplicacao ja expoe rotas HTTP com Hono.
- Quando quer um handler de webhook enxuto e alinhado ao modelo de request do Hono.
- Quando prefere callbacks tipados a codigo manual de verificacao de assinatura.
- Quando precisa de uma integracao que possa migrar entre edge e servidor com poucas mudancas.
Capacidades principais
Rota nativa do Hono
Registre o endpoint da Rewrite com o mesmo estilo
app.post(...) que voce ja usa no Hono.Verificacao de assinatura
Assinaturas invalidas sao rejeitadas antes do seu callback rodar.
Callbacks tipados
Use handlers nomeados para eventos especificos da Rewrite ou
onPayload para tratamento generico.Amigavel a varios runtimes
O mesmo estilo de integracao funciona bem em deployments Hono para edge e runtimes compativeis com Node.
Instalacao
Exemplo basico
Boas praticas
Mantenha segredos na configuracao do runtime
Mantenha segredos na configuracao do runtime
Carregue o segredo de assinatura a partir de variaveis de ambiente ou bindings, sem hardcode no codigo da aplicacao.
Responda rapido as entregas
Responda rapido as entregas
Mantenha a rota focada em verificacao e dispatch. Mova trabalho mais longo para filas ou tarefas em background.
Deduplique retries
Deduplique retries
A Rewrite pode reenviar webhooks, entao persista o id do evento e torne efeitos colaterais idempotentes.
Callbacks de evento disponiveis
Callbacks de evento disponiveis
O adapter suporta
onSMSOTP, onMessageSent, onMessageBatch, onMessageQueued, onMessageDelivered, onMessageScheduled, onMessageFailed, onMessageCanceled e o hook generico onPayload.Documentacao relacionada
Visao geral de Adapters
Compare todos os adapters oficiais e entenda onde cada um se encaixa.
Visao geral de Webhooks
Formato da entrega, retries, validacao de assinatura e orientacoes operacionais.
Tipos de evento
Paginas de payload por evento para as familias de webhook suportadas pela Rewrite.