Reescrita completa da SDK, agora cobrindo toda a plataforma APIBrasil.
- Cliente central
ApiBrasilcom módulos por produto:whatsapp,evolution,whatsmeow,sms,dados,vehicles,fipe,correios,cep,geolocation,geomatrix,recognize,ddd,holidays,translate,weather,loterias,databaseIp,consulta(créditos),ura,chipVirtual,bulk,auth(login/2FA),devices,catalog,account,payments(PIX/boleto/cartão),ipWhitelist,bearerRateLimit,reports. - Zero dependências: transporte padrão com fetch nativo; interface
Transportplugável para axios/proxies/mocks. - Retry com backoff exponencial (padrão: HTTP 429 e falhas de conexão; nunca timeouts nem erros de negócio) com suporte a
Retry-After. - Hooks de observabilidade:
onRequest,onResponse,onRetry. - Hierarquia de erros:
ValidationError,AuthenticationError,InsufficientBalanceError,PermissionError,NotFoundError,RateLimitError,ServerError,NetworkError,TimeoutError— todas estendendoApiBrasilError. - Variáveis de ambiente:
APIBRASIL_BEARER_TOKEN,APIBRASIL_DEVICE_TOKEN,APIBRASIL_SECRET_KEY,APIBRASIL_BASE_URLlidas automaticamente. - Tipos gerados do catálogo (
npm run codegen): autocomplete das actions de WhatsApp/Evolution/WhatsMeow e dos 210+tipode consulta. - Dual build ESM + CJS com subpath exports:
apigratis-sdk-nodejs/core,/messaging,/data,/platform,/legacy. - Testes unitários (transporte fake) e de contrato opcionais (
npm run test:contract). - CI no GitHub Actions (Node 18/20/22), publicação com provenance e docs TypeDoc.
- Node.js >= 18 (fetch nativo).
axiosnão é mais dependência; oTransportcustomizado substitui interceptors.- Imports profundos de
dist/(ex:apigratis-sdk-nodejs/dist/Cpf) deixam de funcionar — use os subpath exports. - Interface legada
createWhatsAppApi/createCpfApi/etc. segue funcionando com o mesmo contrato ({ status: 'error' }em erros, basecluster.apigratis.com), agora implementada sobre o novo núcleo e marcada como deprecated.
Última versão da interface antiga (wrappers createXxxApi sobre axios).
Ajustes gerais