Webhooks na sua máquina com o CLI

Antes de cadastrar um endpoint de produção, dá para receber os webhooks do Steel no app que roda na sua máquina, sem expor nada na internet. O steel listen recebe os eventos do workspace em tempo real e, com --forward, repassa cada um para o seu app com o mesmo corpo e os mesmos cabeçalhos de uma entrega de verdade (Steel-Webhook-Id, Steel-Webhook-Timestamp e Steel-Signature). A conferência de assinatura do seu app roda igual à de produção.

O que o Steel envia (eventos, corpo, assinatura, novas tentativas) está em Webhooks que o Steel envia. Esta página cobre o lado do CLI.

Teste a integração ponta a ponta

1. Tenha uma rota no seu app que recebe o webhook e confere a assinatura. Com o SDK, num route handler do Next.js:

   // app/webhooks/steel/route.ts
   import { verifySignature } from '@steel-so/sdk'
   
   export async function POST(request: Request) {
     const rawBody = await request.text() // o corpo exato, antes de JSON.parse
     const valid = verifySignature(
       process.env.STEEL_WEBHOOK_SECRET ?? '',
       request.headers.get('steel-signature'),
       request.headers.get('steel-webhook-timestamp'),
       rawBody,
     )
     if (!valid) return new Response('assinatura inválida', { status: 401 })
   
     const event = JSON.parse(rawBody) as { id: string; type: string; data: unknown }
     console.log(event.type, event.id)
     return new Response(null, { status: 204 })
   }