Skip to content

v0.1.1: o contrato oficial saiu de baixo dos pacotes

Choose a tag to compare

@Mozurok Mozurok released this 04 Sep 17:40
· 12 commits to main since this release
b35c528

Primeira release marcada do repositório. O 0.1.0 foi publicado no npm em julho sem tag nem release, então esta também abre o histórico.

Os pacotes não mudam de comportamento. O que esta release entrega é a descoberta de que o chão se moveu, e o conserto da vigilância que não viu.

O contrato da Plataforma foi para a v1.1.0

Em 24/08/2026 o CGIBS publicou o OpenAPI v1.1.0 da Plataforma Pública, pareado com o Manual de Integração v1.1.0, e moveu a v0.0.10 para "versões anteriores".

v0.0.10 (o que os pacotes geram) v1.1.0
rotas 32 35
schemas 57 78 (33 dos 55 comuns alterados)
stream {idPsp}/tributos/... {cnpjRaizPspRecDir}/transacoes/...
Mecanismo de Ocorrências não existe 3 rotas
X-JWS-Signature ausente obrigatório nas 43 operações

@splitbr/client e @splitbr/mock continuam fiéis à v0.0.10 e seguem servindo para aprender o mecanismo. Quem integra a plataforma real deve tratar a v1.1.0 como fonte da verdade. A migração é major e está em andamento.

Por que passou 11 dias sem ninguém ver

O detector de drift afirmava, em comentário no próprio código, que esse contrato não tinha fonte pública e por isso não dava para monitorá-lo. O README repetia. Era falso: o CGIBS publica o OAS numa página aberta, sem login e sem mTLS, e o arquivo de lá é byte-idêntico ao que estava vendorado desde julho.

Uma limitação escrita com confiança e nunca testada. O detector agora tem um quarto alvo sobre aquela página, comparando o inventário de artefatos, porque o nome de cada upload carrega timestamp e só a página é alvo estável.

Também nesta release

  • Sete artefatos oficiais vendorados: OAS v1.1.0, Manual de Integração v1.1.0, NT 2025.002 v1.51, NT 2026.006 (vinculação NF-e à transação de split), IT 2026.001, PL 010f e a minuta do Manual de Tempos, que quatro documentos davam como inédita e está publicada desde 15/07.
  • Contratos da Calculadora re-vendorados, de 36 para 40 rotas, fechando a issue #6.
  • CI que não existia. Os 162 testes só rodavam na máquina do mantenedor. Agora build, typecheck e testes em Node 22 e 24.
  • prepublishOnly: sem ele, publicar de um clone limpo geraria um tarball apontando para um dist/ inexistente.
  • Quadro de estado da regulação reconciliado, e cinco semanas de silêncio em Novidades preenchidas.

Full Changelog: 384bb96...v0.1.1