Skip to main content
@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

Carregue o segredo de assinatura a partir de variaveis de ambiente ou bindings, sem hardcode no codigo da aplicacao.
Mantenha a rota focada em verificacao e dispatch. Mova trabalho mais longo para filas ou tarefas em background.
A Rewrite pode reenviar webhooks, entao persista o id do evento e torne efeitos colaterais idempotentes.
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.