Release v5.1.0

[andrenfe]

Release v5.1.0 (minor)

Reúne tudo desde a v5.0.0 e faz a bump de versão. Publicação não é automática por merge — o publish.yml dispara ao criar a GitHub Release (com a tag v5.1.0); este PR só prepara o código.

Destaque — fix do contrato de webhooks de conta

Sonda ao vivo (2026-07-02/03, 3 contas) provou que o contrato de webhooks divergia da API:

• /v1/companies/{id}/webhooks (company-scoped) retorna 404 em todas as contas — contrato alucinado no rewrite v3, nunca existiu na API, nos specs ou no SDK legado v2. Métodos marcados @deprecated (comportamento inalterado; remoção na próxima major).
• createAccountWebhook funcionava 0% das vezes: faltava o envelope { "webHook": {...} } exigido no request (a API respondia 400 incondicional). Corrigido nos dois sentidos (wrap no request, unwrap na resposta, com fallback defensivo) em create/update/retrieve.
• Tipo AccountWebhook novo com o shape real (uri/contentType/secret/filters/insecureSsl/headers/properties/status) — já presente nos specs oficiais e nos tipos gerados; o resource manuscrito só não os consultava.
• Tipo WebhookEventType substitui os literais invoice.* (inexistentes) pelos 46 event types reais (service_invoice.*, product_invoice.*, consumer_invoice.*).
• Achado da contraprova: PUT /v2/webhooks/{id} é substituição integral — update sem status desativa o webhook. Documentado no JSDoc do updateAccountWebhook.
• Teste de alinhamento amarrando AccountWebhook ao schema gerado do spec — sync de spec que mude o contrato quebra o build em vez de driftar.

Docs, exemplos e a skill nfeio-node-sdk atualizados para o fluxo account-scoped.

Semver — minor

Adiciona tipos exportados novos + deprecations não-quebráveis. A troca de assinatura de createAccountWebhook é breaking só no papel (o método respondia 400 sempre; nenhum consumidor funcional existe). Nada de major.

Commits neste PR

• chore(release): v5.1.0 — bump nos 4 pontos (package.json, VERSION, PACKAGE_VERSION, @version) + datação e links do CHANGELOG
• fix(webhooks): corrigir contrato de webhooks de conta contra a API real
• 4× chore de higiene (.gitignore, remoção de config/context obsoletos) — já commitados na master local, sobem junto

Verificação

• typecheck limpo · type-tests 2/2 · build ESM+CJS OK
• suíte completa: 3470 passed, 0 falhas
• dist/ expõe 5.1.0

Pós-merge (manual — gatilho do publish)

git tag v5.1.0 <sha-do-merge> && git push --tags
# criar a GitHub Release apontando pra v5.1.0 → dispara publish.yml (npm publish com provenance)

[github-actions]

📋 OpenAPI Spec Validation

✅ All specs validated and types generated successfully

Specs processed:

• calculo-impostos-v1.yaml - 27.90 KB, 853 lines
• consulta-cnpj.yaml - 34.28 KB, 1128 lines
• consulta-cpf.yaml - 3.39 KB, 83 lines
• consulta-cte-v2.yaml - 18.33 KB, 578 lines
• consulta-endereco.yaml - 11.17 KB, 343 lines
• consulta-nf-consumidor.yaml - 43.41 KB, 1279 lines
• consulta-nf.yaml - 137.87 KB, 3119 lines
• consulta-nfe-distribuicao-v1.yaml - 53.07 KB, 1775 lines
• nf-consumidor-v2.yaml - 293.87 KB, 7609 lines
• nf-produto-v2.yaml - 309.41 KB, 8204 lines
• nf-servico-v1.yaml - 257.42 KB, 6252 lines
• nfeio.yaml - 15.86 KB, 630 lines
• product-invoice-rtc-v1.yaml - 198.88 KB, 5084 lines
• service-invoice-rtc-v1.yaml - 95.30 KB, 1728 lines

Generated types available as artifact in src/generated/.