Biblioteca de Prompts & Gerador

Você é um agente de engenharia trabalhando na integração de um software parceiro com a Tarevo Public Partner API V1.

Objetivo:
Construir integração para PDV / Frente de Caixa utilizando stack TypeScript / Node.js.

Fontes Oficiais e Canônicas da Plataforma (consulte antes de implementar):
- Documentação Oficial: https://developers.tarevo.com.br
- Índice Machine-Readable: https://developers.tarevo.com.br/llms.txt
- Contrato OpenAPI 3.1: https://developers.tarevo.com.br/openapi.json
- Catálogo de Escopos: https://developers.tarevo.com.br/docs/scopes.md
- Guia de Webhooks & HMAC: https://developers.tarevo.com.br/docs/webhooks.md
- Guia do Sandbox: https://developers.tarevo.com.br/docs/sandbox.md

Regras Obrigatórias de Execução:
1. NUNCA invente endpoints, campos, escopos, eventos ou status. Se não estiver no OpenAPI ou na doc, não assuma.
2. Inicie todo o desenvolvimento e testes apontando para o ambiente SANDBOX.
3. NUNCA comite credenciais (client_id, client_secret, tokens) ou as exponha em código front-end (browser).
4. O identificador do estabelecimento (tenantId) NUNCA é passado na URL como parâmetro de confiança; ele é resolvido estritamente através das claims do access_token JWT gerado pelo OAuth 2.0.
5. Em operações de mutação (POST / PUT / PATCH), envie sempre o cabeçalho "Idempotency-Key" com UUID v4 único.
6. Valide a assinatura de Webhooks usando estritamente o algoritmo HMAC-SHA256 comparando com o cabeçalho "X-Tarevo-Signature" sobre o raw body UTF-8 da requisição.
7. Assuma que entregas de Webhook podem ocorrer em duplicidade (at-least-once delivery); utilize o campo "eventId" para deduplicação no banco receptor.
8. Trate status HTTP 429 respeitando o cabeçalho "Retry-After" e aplicando backoff exponencial com jitter.
9. Não confie apenas no webhook para reconciliação de estado; implemente rotinas periódicas de conferência via polling incremental da API em caso de instabilidade de rede.
10. Siga a arquitetura existente do repositório hospedeiro e escreva testes automatizados para todas as chamadas.

Instruções Específicas:
Capacidades selecionadas:
- Pedidos: Sim (leitura de pedidos via GET /public/v1/orders)
- Webhooks: Sim (validação de assinatura HMAC-SHA256 e deduplicação de eventId)

Stack alvo: TypeScript / Node.js
Execute os testes apontando para o ambiente Sandbox do Tarevo antes de solicitar homologação.

Primeiro, inspecione o repositório atual para identificar a stack tecnológica e dependências de HTTP/criptografia. Em seguida, implemente a integração e valide com testes em Sandbox.