feat(cliente): implementa endpoints do ADN (DFe por NSU e convenio)

.github/codeql/codeql-config.yml

@@ -0,0 +1,8 @@
+name: "Configuracao do CodeQL"
+
+# Arquivos de teste usam certificados autoassinados e chaves fracas de
+# proposito (servidor mTLS local, senhas de fixture) - padroes que disparariam
+# alertas de seguranca que nao se aplicam fora de teste. O codigo de producao
+# (fora de src/**/*.teste.ts) continua totalmente analisado.
+paths-ignore:
+  - '**/*.teste.ts'

.github/workflows/codeql.yml

@@ -28,6 +28,7 @@ jobs:
         uses: github/codeql-action/init@v3
         with:
           languages: ${{ matrix.language }}
+          config-file: ./.github/codeql/codeql-config.yml
 
       - name: Analisar
         uses: github/codeql-action/analyze@v3

README.md

@@ -15,7 +15,7 @@ Em desenvolvimento inicial. A tabela abaixo reflete o estado real de cada módul
 | `certificado` | Leitura de certificado A1 (.pfx/.p12) | Feito |
 | `assinatura` | Assinatura XML (XMLDSig) | Feito |
 | `dps` | Tipos e serialização da DPS, incluindo o bloco IBSCBS (XML validado contra o XSD oficial) | Feito; grupo gReeRepRes (reembolso/repasse/ressarcimento de terceiros) ainda não |
-| `cliente` | Cliente HTTP mTLS para o SEFIN Nacional (produção e homologação) | Feito; endpoints do ADN (DFe, parametrização) ainda não |
+| `cliente` | Cliente HTTP mTLS para o SEFIN Nacional e o ADN (produção e homologação) | Feito |
 | `danfse` | Geração do DANFSe em PDF (NT 008/2026) | Feito; canhoto e dedução por documento ficam pra depois |
 
 ## Por que este projeto existe
@@ -32,6 +32,7 @@ O restante do SDK (certificado, assinatura, cliente HTTP) existe porque é pré-
 - [nfse-nacional/nfse-php](https://github.com/nfse-nacional/nfse-php): usado como referência de escopo e organização.
 - [Nota Técnica nº 008 (DANFSe)](https://www.gov.br/nfse/pt-br/biblioteca/documentacao-tecnica/rtc/nt-008-se-cgnfse-danfse-20260714-v1-02.pdf): especificação oficial usada como fonte do leiaute do DANFSe.
 - [Esquemas XSD da NFS-e Nacional](https://www.gov.br/nfse/pt-br/biblioteca/documentacao-tecnica/documentacao-atual/nfse-esquemas_xsd-v1-01-20260209.zip): baixados direto do gov.br e versionados em [`schemas/nfse/v1.01`](schemas/nfse/v1.01) - fonte de verdade dos tipos e da serialização da DPS, e usados nos testes pra validar o XML gerado contra o schema oficial.
+- Especificações OpenAPI do ADN (Ambiente de Dados Nacional) e do SEFIN Nacional: baixadas direto do gov.br e versionadas em [`schemas/adn/v1`](schemas/adn/v1) - fonte de verdade dos endpoints do módulo `cliente`.
 - [Liberation Sans](https://github.com/liberationfonts/liberation-fonts) e [DejaVu Sans](https://dejavu-fonts.github.io/): fontes livres embutidas no gerador de DANFSe (substitutas de Arial e Microsoft Sans Serif, que são proprietárias e não podem ser redistribuídas). Licenças em [`assets/fonts`](assets/fonts).
 
 ## Especificações
@@ -41,6 +42,7 @@ O restante do SDK (certificado, assinatura, cliente HTTP) existe porque é pré-
 
 - NFS-e Nacional - Esquemas XML v1.01 - [gov.br/nfse](https://www.gov.br/nfse/pt-br/biblioteca/documentacao-tecnica/documentacao-atual/nfse-esquemas_xsd-v1-01-20260209.zip)
 - DANFSe - Nota Técnica nº 008, versão 1.02 - [gov.br/nfse](https://www.gov.br/nfse/pt-br/biblioteca/documentacao-tecnica/rtc/nt-008-se-cgnfse-danfse-20260714-v1-02.pdf)
+- API do ADN (Contribuinte e Parâmetros Municipais) e do SEFIN Nacional - [gov.br/nfse](https://www.gov.br/nfse/pt-br/biblioteca/documentacao-tecnica/apis-prod-restrita-e-producao)
 - XML Signature (XMLDSig) - [W3C](https://www.w3.org/TR/xmldsig-core1/), conforme exigido pelo contrato da DPS
 
 </details>

package.json

@@ -58,6 +58,7 @@
   "files": [
     "dist",
     "schemas/**/*.xsd",
+    "schemas/**/*.json",
     "assets/fonts",
     "LICENSE",
     "NOTICE"