@rewritetoday/edge e o adapter da Rewrite para runtimes edge que expoem as APIs padrao de Request e Response.
Repositorio: github.com/RewriteToday/adapters
Quando usar
- Quando voce roda em workers ou edge functions com modelo padrao da Web API.
- Quando quer um handler de webhook orientado ao runtime, sem dependencia de framework.
- Quando precisa de verificacao de assinatura e callbacks tipados na fronteira da rota.
- Quando quer um ponto de integracao pequeno e adequado para ambientes com budget de execucao apertado.
Capacidades principais
Orientado ao runtime
Funciona direto com as APIs padrao de
Request e Response expostas por runtimes edge.Payload validado
Assinaturas invalidas sao rejeitadas antes do seu handler de evento rodar.
Callbacks tipados
Trate webhooks com
onPayload ou roteie familias especificas com hooks nomeados.Pouca cola manual
Monte o handler direto no entrypoint
fetch, sem middleware extra de parsing.Instalacao
Exemplo basico
Boas praticas
Leia o segredo a partir de bindings ou env
Leia o segredo a partir de bindings ou env
Evite hardcode do segredo do webhook. Injete esse valor por bindings do worker, config de edge ou variaveis de ambiente.
Retorne rapido e descarregue trabalho pesado
Retorne rapido e descarregue trabalho pesado
Endpoints de webhook devem confirmar a entrega rapidamente. Mova trabalho caro para filas, durable objects ou jobs em background.
Deduplique pelo id do evento
Deduplique pelo id do evento
Persista o id do evento e mantenha o processamento idempotente para que retries nao gerem efeitos duplicados.
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 quando eles fazem mais sentido que os pacotes base.
Visao geral de Webhooks
Validacao de assinatura, formato da entrega, retries e registro de webhooks.
Tipos de evento
Familias de evento e referencias de payload para cada webhook suportado pela Rewrite.