@bitize/bitmde 0.17.1 → 0.19.0

package/CHANGELOG.md

@@ -1,5 +1,62 @@
 # Changelog
 
+## [Não publicado]
+
+## [0.19.0] / 2026-10-03
+
+> Muda o comportamento padrão de transporte e deixa de suportar o Node 20; leia [Compatibilidade](#compatibilidade) antes de atualizar.
+
+### Modificado
+
+- **O certificado do servidor da SEFAZ passa a ser validado por padrão** (`rejectUnauthorized: true`). Até a 0.18.0 o padrão era `false`: a biblioteca aceitava qualquer servidor, inclusive um intermediário malicioso, e apresentava a ele o certificado A1 no mTLS
+- **A cadeia padrão passa a somar as raízes do Node à ICP-Brasil, em vez de substituí-las.** A cadeia embarcada (AC Raiz Brasileira v10 e AC SERPRO SSLv1) não valida mais o Ambiente Nacional, que hoje serve `AC SERPRO AR46 OV TLS CA 2025 ← GlobalSign Root R46`, e a opção `ca` do Node descarta as raízes padrão. Quem ligava `rejectUnauthorized: true`, como esta documentação recomendava, recebia sempre `UNABLE_TO_GET_ISSUER_CERT_LOCALLY`. As raízes respeitam `NODE_EXTRA_CA_CERTS` e `--use-system-ca` quando o Node oferece `tls.getCACertificates`
+- **Erro de transporte deixa de se disfarçar de status HTTP.** Sem resposta da SEFAZ, o retorno vinha com `status` 500, 502 ou 504 sintético e `resXml: '<error>mensagem</error>'`, e o código do erro se perdia. Agora vem com `status: 0`, `resXml: ''`, `transportError: { code, message }` e `error: 'Falha de transporte (<code>): <message>'`. Resposta HTTP real da SEFAZ, inclusive 5xx, não muda. Ver [ADR 0014](https://github.com/bitize/bitmde/blob/main/.docs/arquitetura/decisoes/0014-tls-validado-por-padrao-e-erro-de-transporte-explicito.md)
+
+### Adicionado
+
+- `CA_PADRAO` e `CA_ICP_BRASIL` exportados na raiz do pacote, nas três formas (`module.exports`, `.default`, `.mde`): a cadeia que a biblioteca usa por padrão e só a ICP-Brasil embarcada. São arrays de PEM congelados, para compor como `httpsOptions: { ca: [...CA_PADRAO, minhaCa] }`
+- Campo `transportError?: { code, message }` no retorno dos três métodos de consulta e do `enviarEvento`
+- `engines: { node: ">=22" }` no `package.json`
+- Workflow `cadeia-tls.yml`, que confere toda semana o handshake TLS com `www1` e `hom1` usando `CA_PADRAO`, para a próxima troca de cadeia do Ambiente Nacional aparecer antes de chegar a quem consome
+
+### Removido
+
+- **Node 20 deixa de ser suportado**: sem suporte do projeto Node.js desde abril de 2026, sai da matriz de testes da CI. A biblioteca passa a exigir Node 22 ou posterior
+
+### Compatibilidade
+
+Nenhuma assinatura muda, mas dois comportamentos padrão mudam, daí o bump de minor (`^0.18.0` não resolve para a 0.19.0):
+
+1. **Servidor cuja cadeia não fecha em `CA_PADRAO` passa a ser recusado.** Para os endpoints do Ambiente Nacional, que são os únicos que a biblioteca chama, nada muda. Atrás de um proxy que reassina TLS, acrescente a CA dele com `NODE_EXTRA_CA_CERTS` ou com `httpsOptions: { ca: [...CA_PADRAO, caDoProxy] }`. Quem já passava `ca` próprio continua no controle, porque `httpsOptions` sobrescreve o padrão.
+2. **Erro de transporte muda de forma.** Quem testa só `if (retorno.error)` não precisa mudar nada. Quem lia `status` 500/502/504 ou procurava `<error>` em `resXml` passa a usar `transportError`:
+
+```diff
+-if (retorno.status === 502 && /^<error>/.test(retorno.resXml)) {
++if (retorno.transportError) {
++  log(retorno.transportError.code, retorno.transportError.message)
+ }
+```
+
+Voltar ao comportamento antigo de TLS ainda é possível com `httpsOptions: { rejectUnauthorized: false }`, e não é recomendado.
+
+Quem ainda roda Node 20 recebe um aviso de `engines` na instalação e deve atualizar para o Node 22 ou o 24, ambos LTS.
+
+## [0.18.0] / 2026-10-01
+
+### Corrigido
+
+- **Um `docZip` corrompido na distribuição DF-e encerrava o processo de quem consome a biblioteca.** `Gzip.unzip` rejeitava a Promise mas seguia executando e lançava um `TypeError` fora dela, como `uncaughtException`, antes de qualquer `.catch` do chamador
+- Um documento ilegível no lote deixa de derrubar a consulta inteira. Antes, `consultaUltNSU`, `consultaNSU` e `consultaChNFe` perderiam os documentos válidos e o `ultNSU`/`maxNSU`, e a varredura ficaria presa no mesmo NSU. Ver [ADR 0013](https://github.com/bitize/bitmde/blob/main/.docs/arquitetura/decisoes/0013-falha-de-doczip-vira-item-de-doczip-errors.md)
+- `<loteDistDFeInt/>` vazio na resposta deixa de lançar `TypeError` e vira lote sem documentos. Um `loteDistDFeInt` em qualquer outra forma que não seja um lote — texto no lugar dos `docZip`, elemento repetido — passa a devolver `error: 'loteDistDFeInt inválido.'` em vez de lançar
+
+### Adicionado
+
+- Campo `data.docZipErrors: [{ nsu, schema, error }]` no retorno da distribuição DF-e, com os documentos do lote que não puderam ser descompactados ou interpretados. Sempre presente; `[]` quando todos abrem. `docZip` mantém o formato de sempre e passa a trazer só os documentos válidos. Falha de documento não preenche o `error` de topo
+
+### Modificado
+
+- `actions/checkout` e `actions/setup-node` atualizadas da v4 para a v7 nos três workflows. A v4 roda em Node 20, deprecado nos runners do GitHub e já forçado a executar em Node 24 — o aviso aparecia em todo run. Nenhuma quebra das v5/v6/v7 se aplica a este repositório: o cache automático da v5 do `setup-node` depende do campo `packageManager` no `package.json`, que não existe aqui, e a remoção do `NODE_AUTH_TOKEN` fictício na v7 não afeta quem publica por OIDC
+
 ## [0.17.1] / 2026-09-10
 
 ### Adicionado

package/README.md

@@ -25,6 +25,7 @@ npm i @bitize/bitmde
 
 - Possuir um **Certificado A1** válido emitido por uma Autoridade Certificadora credenciada pela Infraestrutura de Chaves Públicas Brasileira – **ICP-Brasil**.
 - O certificado pode ser usando no formato **PFX** e **Senha** _OU_ **cert.pem** e **key.pem**
+- **Node.js 22 ou posterior.** O Node 20, sem suporte desde abril de 2026, deixou de ser testado na 0.19.0.
 
 ## Funcionalidades
 
@@ -56,7 +57,7 @@ new DistribuicaoDFe(config)
   - `tpAmb` `<String>` - [OBRIGATÓRIO] - Identificação de Ambiente. Informar `'1'` para **Produção** ou `'2'` para **Homologação**.
   - `options` `<Object>` - [OPCIONAL]
     - `requestOptions` `<AxiosRequestConfig>` - [OPCIONAL]
-    - `httpsOptions` `<AgentOptions>` - [OPCIONAL]
+    - `httpsOptions` `<AgentOptions>` - [OPCIONAL] - Opções do `https.Agent`, mescladas por cima do padrão `{ ca: CA_PADRAO, rejectUnauthorized: true }`. Ver [Conexão com a SEFAZ](#conexão-com-a-sefaz).
 
 ### Consulta por ultNSU
 
@@ -108,6 +109,7 @@ console.log(consulta)
 //         schema: 'procNFe_v4.00.xsd',
 //       },
 //     ],
+//     docZipErrors: [],
 //   },
 //   reqXml: '<?xml version="1.0" encoding="utf-8"?> ... </soap12:Body></soap12:Envelope>',
 //   resXml: '<?xml version="1.0" encoding="utf-8"?> ... </soap:Body></soap:Envelope>',
@@ -115,6 +117,20 @@ console.log(consulta)
 // }
 ```
 
+`docZip` traz só os documentos que puderam ser abertos. Um documento do lote que não descompacta ou não é XML válido não derruba a consulta: ele vai para `docZipErrors`, com o motivo, e `ultNSU`/`maxNSU` continuam preenchidos para a varredura avançar. O formato é o mesmo nas três consultas:
+
+```js
+// docZipErrors: [
+//   {
+//     nsu: '000000000000051',
+//     schema: 'procNFe_v4.00.xsd',
+//     error: 'Falha ao descompactar o docZip: incorrect header check',
+//   },
+// ]
+```
+
+As mensagens possíveis em `error` são `docZip sem conteúdo.`, `Falha ao descompactar o docZip: <motivo>` e `Falha ao interpretar o XML do docZip: <motivo>`.
+
 ### Consulta por chNFe
 
 | Campo   |   Tipo   | Tamanho | Descrição                   |
@@ -161,6 +177,7 @@ console.log(consulta)
 //         schema: 'procNFe_v4.00.xsd',
 //       },
 //     ],
+//     docZipErrors: [],
 //   },
 //   reqXml: '<?xml version="1.0" encoding="utf-8"?> ... </soap12:Body></soap12:Envelope>',
 //   resXml: '<?xml version="1.0" encoding="utf-8"?> ... </soap:Body></soap:Envelope>',
@@ -212,6 +229,7 @@ console.log(consulta)
 //         schema: 'resNFe_v1.01.xsd',
 //       },
 //     ],
+//     docZipErrors: [],
 //   },
 //   reqXml: '<?xml version="1.0" encoding="utf-8"?> ... </soap12:Body></soap12:Envelope>',
 //   resXml: '<?xml version="1.0" encoding="utf-8"?> ... </soap:Body></soap:Envelope>',
@@ -238,7 +256,7 @@ new RecepcaoEvento(config)
   - `timezone` `<String>` - [OPCIONAL] - Fuso horário do autor. É utilizado `'America/Sao_Paulo'` como valor padrão. Consulte a tabela [lista de timezones](#lista-de-timezones) válidos para o Brasil.
   - `options` `<Object>` - [OPCIONAL]
     - `requestOptions` `<AxiosRequestConfig>` - [OPCIONAL]
-    - `httpsOptions` `<AgentOptions>` - [OPCIONAL]
+    - `httpsOptions` `<AgentOptions>` - [OPCIONAL] - Opções do `https.Agent`, mescladas por cima do padrão `{ ca: CA_PADRAO, rejectUnauthorized: true }`. Ver [Conexão com a SEFAZ](#conexão-com-a-sefaz).
 
 ### Enviar Lote de Eventos
 
@@ -330,6 +348,60 @@ console.log(manifestacao)
 // }
 ```
 
+## Conexão com a SEFAZ
+
+### Validação do certificado do servidor
+
+O certificado do servidor da SEFAZ é **validado por padrão**. Sem `httpsOptions`, o agente HTTPS usa:
+
+```js
+{ ca: CA_PADRAO, rejectUnauthorized: true }
+```
+
+A biblioteca exporta as duas cadeias que usa:
+
+- `CA_PADRAO` — as raízes que o Node usaria por padrão, somadas à cadeia ICP-Brasil. Inclui `NODE_EXTRA_CA_CERTS` e `--use-system-ca` quando o Node oferece `tls.getCACertificates` (22.15 ou posterior); nas versões do Node 22 anteriores a ela, usa o bundle da Mozilla (`tls.rootCertificates`). É montada uma vez, quando o pacote é carregado.
+- `CA_ICP_BRASIL` — só a cadeia ICP-Brasil embarcada (AC Raiz Brasileira v10 e AC SERPRO SSLv1).
+
+As duas são arrays de PEM congelados. Informar `ca` em `httpsOptions` **substitui** a cadeia inteira. Para acrescentar uma AC, por exemplo a de um proxy corporativo, some à cadeia padrão:
+
+```js
+const { CA_PADRAO, DistribuicaoDFe } = require('@bitize/bitmde')
+
+const distribuicao = new DistribuicaoDFe({
+  // ...
+  options: {
+    httpsOptions: {
+      ca: [...CA_PADRAO, fs.readFileSync('./minha-ca.pem', 'utf8')],
+    },
+  },
+})
+```
+
+Desligar a validação ainda é possível com `httpsOptions: { rejectUnauthorized: false }`, mas **não é recomendado**: assim a biblioteca aceita qualquer servidor e apresenta a ele o certificado A1 no mTLS.
+
+### Erro de transporte
+
+Quando não há resposta HTTP (falha na cadeia TLS, DNS, conexão recusada, timeout), a biblioteca não lança. O retorno vem com `status: 0` e o motivo em `transportError`:
+
+```js
+// {
+//   data: {},
+//   reqXml: '<?xml version="1.0" encoding="utf-8"?> ... </soap12:Body></soap12:Envelope>',
+//   resXml: '',
+//   status: 0,
+//   error: 'Falha de transporte (UNABLE_TO_GET_ISSUER_CERT_LOCALLY): unable to get local issuer certificate',
+//   transportError: {
+//     code: 'UNABLE_TO_GET_ISSUER_CERT_LOCALLY',
+//     message: 'unable to get local issuer certificate',
+//   },
+// }
+```
+
+`transportError.code` é o código do Node ou do axios, sem tradução: `ECONNREFUSED`, `ENOTFOUND`, `ECONNRESET`, `ECONNABORTED` (timeout), `UNABLE_TO_GET_ISSUER_CERT_LOCALLY` (cadeia), entre outros. Sem código, vem `ERR_DESCONHECIDO`. `error` continua preenchido, então `if (retorno.error)` cobre esse caso como antes.
+
+Uma resposta HTTP de erro da SEFAZ, como um `502` ou um `503`, chega com o status real, o corpo em `resXml` e **sem** `transportError`. Então `status: 0` significa sempre "a SEFAZ não respondeu".
+
 ## Sobre o BitERP
 
 O `@bitize/bitmde` é mantido pela equipe do **[BitERP](https://www.biterp.ai)**, um ERP online que automatiza a rotina fiscal, financeira e comercial de empresas brasileiras.

package/dist/apis/distribuicaoDFe-api.d.ts

@@ -12,7 +12,7 @@ declare class DistribuicaoDFe {
      * @param {'1' | '2'} config.tpAmb
      * @param {Object} [config.options]
      * @param {import('axios').AxiosRequestConfig} [config.options.requestOptions]
-     * @param {import('https').AgentOptions} [config.options.httpsOptions]
+     * @param {import('https').AgentOptions} [config.options.httpsOptions] Mesclado por cima do padrão `{ ca: CA_PADRAO, rejectUnauthorized: true }`. Informar `ca` substitui a cadeia inteira; para somar uma AC, use `[...CA_PADRAO, minhaCa]`.
      */
     constructor(config: {
         pfx?: Buffer;
@@ -56,8 +56,17 @@ declare class DistribuicaoDFe {
                 nsu: string;
                 schema: string;
             }];
+            docZipErrors: [{
+                nsu: string;
+                schema: string;
+                error: string;
+            }];
         };
         error: string;
+        transportError?: {
+            code: string;
+            message: string;
+        };
         reqXml: string;
         resXml: string;
         status: number;
@@ -80,8 +89,17 @@ declare class DistribuicaoDFe {
                 nsu: string;
                 schema: string;
             }];
+            docZipErrors: [{
+                nsu: string;
+                schema: string;
+                error: string;
+            }];
         };
         error: string;
+        transportError?: {
+            code: string;
+            message: string;
+        };
         reqXml: string;
         resXml: string;
         status: number;
@@ -104,8 +122,17 @@ declare class DistribuicaoDFe {
                 nsu: string;
                 schema: string;
             }];
+            docZipErrors: [{
+                nsu: string;
+                schema: string;
+                error: string;
+            }];
         };
         error: string;
+        transportError?: {
+            code: string;
+            message: string;
+        };
         reqXml: string;
         resXml: string;
         status: number;

package/dist/apis/recepcaoEvento-api.d.ts

@@ -12,7 +12,7 @@ declare class RecepcaoEvento {
      * @param {'America/Araguaina' | 'America/Bahia' | 'America/Belem' | 'America/Boa_Vista' | 'America/Campo_Grande' | 'America/Cuiaba' | 'America/Fortaleza' | 'America/Maceio' | 'America/Manaus' | 'America/Noronha' | 'America/Porto_Velho' | 'America/Recife' | 'America/Rio_Branco' | 'America/Sao_Paulo'} [config.timezone = 'America/Sao_Paulo']
      * @param {Object} [config.options]
      * @param {import('axios').AxiosRequestConfig} [config.options.requestOptions]
-     * @param {import('https').AgentOptions} [config.options.httpsOptions]
+     * @param {import('https').AgentOptions} [config.options.httpsOptions] Mesclado por cima do padrão `{ ca: CA_PADRAO, rejectUnauthorized: true }`. Informar `ca` substitui a cadeia inteira; para somar uma AC, use `[...CA_PADRAO, minhaCa]`.
      */
     constructor(config: {
         pfx?: Buffer;
@@ -74,6 +74,10 @@ declare class RecepcaoEvento {
             }];
         };
         error: string;
+        transportError?: {
+            code: string;
+            message: string;
+        };
         reqXml: string;
         resXml: string;
         status: number;

package/dist/controllers/distribuicaoDFe-controller.d.ts

@@ -4,7 +4,7 @@ declare class DistribuicaoController {
     /**
      *
      * @param {Object} opts
-     * @returns {Promise<{data:{tpAmb: string,verAplic: string,cStat: string,xMotivo: string,dhResp: string,ultNSU: string,maxNSU: string, docZip:[{xml: string,json: Object,nsu: string,schema: string}]}, error: string, reqXml: string, resXml: string, status: number}>}
+     * @returns {Promise<{data:{tpAmb: string,verAplic: string,cStat: string,xMotivo: string,dhResp: string,ultNSU: string,maxNSU: string, docZip:[{xml: string,json: Object,nsu: string,schema: string}], docZipErrors:[{nsu: string,schema: string,error: string}]}, error: string, transportError?: {code: string, message: string}, reqXml: string, resXml: string, status: number}>}
      */
     static enviar(opts: any): Promise<{
         data: {
@@ -21,8 +21,17 @@ declare class DistribuicaoController {
                 nsu: string;
                 schema: string;
             }];
+            docZipErrors: [{
+                nsu: string;
+                schema: string;
+                error: string;
+            }];
         };
         error: string;
+        transportError?: {
+            code: string;
+            message: string;
+        };
         reqXml: string;
         resXml: string;
         status: number;

package/dist/controllers/index.d.ts

@@ -17,8 +17,17 @@ declare const controller: Readonly<{
                     nsu: string;
                     schema: string;
                 }];
+                docZipErrors: [{
+                    nsu: string;
+                    schema: string;
+                    error: string;
+                }];
             };
             error: string;
+            transportError?: {
+                code: string;
+                message: string;
+            };
             reqXml: string;
             resXml: string;
             status: number;
@@ -50,6 +59,10 @@ declare const controller: Readonly<{
                 }];
             };
             error: string;
+            transportError?: {
+                code: string;
+                message: string;
+            };
             reqXml: string;
             resXml: string;
             status: number;

package/dist/controllers/recepcaoEvento-controller.d.ts

@@ -4,7 +4,7 @@ declare class RecepcaoController {
     /**
      *
      * @param {Object} opts
-     * @returns {Promise<{data:{idLote: string,tpAmb: string,verAplic: string,cOrgao: string,cStat: string,xMotivo: string, infEvento:[{tpAmb: string,verAplic: string,cOrgao: string,cStat: string,xMotivo: string,chNFe: string,tpEvento: string,xEvento: string,nSeqEvento: string,CNPJDest: string,dhRegEvento: string,nProt: string}]}, error: string, reqXml: string, resXml: string, status: number}>}
+     * @returns {Promise<{data:{idLote: string,tpAmb: string,verAplic: string,cOrgao: string,cStat: string,xMotivo: string, infEvento:[{tpAmb: string,verAplic: string,cOrgao: string,cStat: string,xMotivo: string,chNFe: string,tpEvento: string,xEvento: string,nSeqEvento: string,CNPJDest: string,dhRegEvento: string,nProt: string}]}, error: string, transportError?: {code: string, message: string}, reqXml: string, resXml: string, status: number}>}
      */
     static enviar(opts: any): Promise<{
         data: {
@@ -30,6 +30,10 @@ declare class RecepcaoController {
             }];
         };
         error: string;
+        transportError?: {
+            code: string;
+            message: string;
+        };
         reqXml: string;
         resXml: string;
         status: number;

package/dist/env/ca.d.ts

@@ -1,6 +1,12 @@
 /**
- * Cadeia de Certificados da NF-e (www1.nfe.fazenda.gov.br)
- * Página Principal > Documentos > Diversos > Cadeia de Certificados do www1 (atualizada em 04/08/2021)
+ * Cadeia ICP-Brasil: AC Raiz Brasileira v10 e AC SERPRO SSLv1.
+ *
+ * Veio do portal da NF-e como "Cadeia de Certificados do www1 (atualizada em
+ * 04/08/2021)", mas deixou de ser a cadeia do www1/hom1: desde então o
+ * Ambiente Nacional serve AC SERPRO AR46 OV TLS CA 2025 ← GlobalSign Root R46,
+ * que só fecha com as raízes padrão do Node. Continua embarcada para quem
+ * fala com endpoint ICP-Brasil.
  * https://www.nfe.fazenda.gov.br/portal/exibirArquivo.aspx?conteudo=JuhROOiTOPA=
  */
 export const CA: string[];
+export const CA_PADRAO: string[];

package/dist/env/index.d.ts

@@ -1,8 +1,9 @@
 import { CA } from "./ca";
+import { CA_PADRAO } from "./ca";
 import { CODIGOS_UF } from "./uf";
 import { DISTRIBUICAO } from "./distribuicao";
 import { EVENTOS } from "./evento";
 import { RECEPCAO } from "./recepcao";
 import { VERSION } from "./version";
 import { ZONES } from "./zone";
-export { CA, CODIGOS_UF, DISTRIBUICAO, EVENTOS, RECEPCAO, VERSION, ZONES };
+export { CA, CA_PADRAO, CODIGOS_UF, DISTRIBUICAO, EVENTOS, RECEPCAO, VERSION, ZONES };

package/dist/helpers/distribuicaoDFe-helper.d.ts

@@ -10,6 +10,10 @@ declare class DistribuicaoHelper {
     static enviarConsulta(data: string, opts: any): Promise<{
         status: number;
         data: string;
+        transportError?: {
+            code: string;
+            message: string;
+        };
     }>;
     /**
      *
@@ -20,7 +24,7 @@ declare class DistribuicaoHelper {
     /**
      *
      * @param {string} data
-     * @returns {Promise<{tpAmb: string,verAplic: string,cStat: string,xMotivo: string,dhResp: string,ultNSU: string,maxNSU: string, docZip:[{xml: string,json: Object,nsu: string,schema: string}], error: string}>}
+     * @returns {Promise<{tpAmb: string,verAplic: string,cStat: string,xMotivo: string,dhResp: string,ultNSU: string,maxNSU: string, docZip:[{xml: string,json: Object,nsu: string,schema: string}], docZipErrors:[{nsu: string,schema: string,error: string}], error: string}>}
      */
     static montarResponse(data: string): Promise<{
         tpAmb: string;
@@ -36,6 +40,28 @@ declare class DistribuicaoHelper {
             nsu: string;
             schema: string;
         }];
+        docZipErrors: [{
+            nsu: string;
+            schema: string;
+            error: string;
+        }];
+        error: string;
+    }>;
+    /**
+     * Descompacta e interpreta um docZip sem nunca rejeitar: a falha vira
+     * um item com `error`, para não derrubar o restante do lote.
+     *
+     * @param {Object} doc
+     * @returns {Promise<{xml: string,json: Object,nsu: string,schema: string} | {nsu: string,schema: string,error: string}>}
+     */
+    static abrirDocZip(doc: any): Promise<{
+        xml: string;
+        json: any;
+        nsu: string;
+        schema: string;
+    } | {
+        nsu: string;
+        schema: string;
         error: string;
     }>;
 }

package/dist/helpers/index.d.ts

@@ -5,6 +5,10 @@ declare const helper: Readonly<{
         enviarConsulta(data: string, opts: any): Promise<{
             status: number;
             data: string;
+            transportError?: {
+                code: string;
+                message: string;
+            };
         }>;
         montarRequest(opts: any): string;
         montarResponse(data: string): Promise<{
@@ -21,6 +25,21 @@ declare const helper: Readonly<{
                 nsu: string;
                 schema: string;
             }];
+            docZipErrors: [{
+                nsu: string;
+                schema: string;
+                error: string;
+            }];
+            error: string;
+        }>;
+        abrirDocZip(doc: any): Promise<{
+            xml: string;
+            json: any;
+            nsu: string;
+            schema: string;
+        } | {
+            nsu: string;
+            schema: string;
             error: string;
         }>;
     };
@@ -29,6 +48,10 @@ declare const helper: Readonly<{
         enviarEvento(data: string, opts: any): Promise<{
             status: number;
             data: string;
+            transportError?: {
+                code: string;
+                message: string;
+            };
         }>;
         montarRequest(opts: any): string;
         montarResponse(data: string): {
@@ -63,6 +86,10 @@ declare const helper: Readonly<{
             retornoSefaz: {
                 data: string;
                 status: number;
+                transportError?: {
+                    code: string;
+                    message: string;
+                };
             };
         }): {
             data: any;

package/dist/helpers/recepcaoEvento-helper.d.ts

@@ -10,6 +10,10 @@ declare class RecepcaoHelper {
     static enviarEvento(data: string, opts: any): Promise<{
         status: number;
         data: string;
+        transportError?: {
+            code: string;
+            message: string;
+        };
     }>;
     /**
      *

package/dist/helpers/retorno-helper.d.ts

@@ -9,6 +9,7 @@ declare class RetornoHelper {
      * @param {Object} options.retornoSefaz
      * @param {string} options.retornoSefaz.data
      * @param {number} options.retornoSefaz.status
+     * @param {{code: string, message: string}} [options.retornoSefaz.transportError]
      * @returns
      */
     static montarRetorno(options: {
@@ -17,6 +18,10 @@ declare class RetornoHelper {
         retornoSefaz: {
             data: string;
             status: number;
+            transportError?: {
+                code: string;
+                message: string;
+            };
         };
     }): {
         data: any;

package/dist/index.d.ts

@@ -1,10 +1,16 @@
+export const CA_ICP_BRASIL: readonly string[];
+export const CA_PADRAO: readonly string[];
 import DistribuicaoDFe = require("./apis/distribuicaoDFe-api");
 import RecepcaoEvento = require("./apis/recepcaoEvento-api");
 declare namespace _default {
+    export { CA_ICP_BRASIL };
+    export { CA_PADRAO };
     export { DistribuicaoDFe };
     export { RecepcaoEvento };
 }
 export declare namespace mde {
+    export { CA_ICP_BRASIL };
+    export { CA_PADRAO };
     export { DistribuicaoDFe };
     export { RecepcaoEvento };
 }

package/dist/services/sefaz-service.d.ts

@@ -3,10 +3,17 @@ declare class Instance {
     constructor(opts: any);
     instance: import("axios").AxiosInstance;
     /**
-     * @returns {Promise<{status: number, data: string}>}
+     * Sem resposta HTTP (cadeia TLS, DNS, conexão recusada, timeout, erro
+     * antes do envio), devolve `status: 0` e o motivo em `transportError`.
+     *
+     * @returns {Promise<{status: number, data: string, transportError?: {code: string, message: string}}>}
      */
     request(config: any): Promise<{
         status: number;
         data: string;
+        transportError?: {
+            code: string;
+            message: string;
+        };
     }>;
 }

package/lib/env/ca.js

@@ -1,5 +1,6 @@
-let CA = [ "-----BEGIN CERTIFICATE-----\r\nMIIHAjCCBOqgAwIBAgIJAJVIeKgiEmNTMA0GCSqGSIb3DQEBDQUAMIGYMQswCQYD\r\nVQQGEwJCUjETMBEGA1UECgwKSUNQLUJyYXNpbDE9MDsGA1UECww0SW5zdGl0dXRv\r\nIE5hY2lvbmFsIGRlIFRlY25vbG9naWEgZGEgSW5mb3JtYWNhbyAtIElUSTE1MDMG\r\nA1UEAwwsQXV0b3JpZGFkZSBDZXJ0aWZpY2Fkb3JhIFJhaXogQnJhc2lsZWlyYSB2\r\nMTAwHhcNMjAwMzEyMTkzMTQyWhcNMzIwNzAxMTIwMDU5WjCBjDELMAkGA1UEBhMC\r\nQlIxEzARBgNVBAoMCklDUC1CcmFzaWwxNTAzBgNVBAsMLEF1dG9yaWRhZGUgQ2Vy\r\ndGlmaWNhZG9yYSBSYWl6IEJyYXNpbGVpcmEgdjEwMTEwLwYDVQQDDChBdXRvcmlk\r\nYWRlIENlcnRpZmljYWRvcmEgZG8gU0VSUFJPIFNTTHYxMIICIjANBgkqhkiG9w0B\r\nAQEFAAOCAg8AMIICCgKCAgEA61jQVBX27GVzyZkJuyrEezqjBGdLSJDFRyGdwxbm\r\n8Ntr0AA8blhDaN5ASDOjqDESMA7xF38znfkZWBMLxJ3Ob0271W6G9bqgTwp/svhZ\r\ns91UcbZW6sB7gyxzMTGWLxcFMeBrurM0QpMVsp8hDH5Suv5rfP0YB9brz60k104u\r\nHG625rAcbRKHn7XsWJ1ZUQcwRzx1g0L1NlUKpsk0+eOAxTcVSVRTO33k+n6Gve83\r\n4MXMiG6Orved4isnEvQnl4AecCXOuUuM3vXZ+kdJGTpNy1HOy0coFdKCJSSCxU/y\r\nTbTiAiRJTc8rbvor3I7k7wR4ZDR8alDbW/Sbw1JEMtbQqMOXEOV7iEUIub0/uNT2\r\ng0oM4pu8DAxhIwy2YQCpjfCbzYu2bf1nabuOEQ2B4mFt/zgoxa5FLsM+0IjpCi8u\r\nz9RqLvYFo9pIy5BTi7JMkVfbgqcOv7vkQf3xF7sODdInCVRIbB0R6xpHm+bpitx9\r\nt5ip+Sf24QFlKbjy0gwVAnaEyf/iQF+t8qgcFBO65kyfH/2vs6iYg5TNhFKtjpqQ\r\niTyI7YkRkfTbLFdcgZbiRUUs5TFi0BkS4PAWupO1GgV9sJdk9gm3Z+KNZDgoAnu7\r\nCvhq1JXt6t7qO96WzBx9q9hi7T6eld1VFrV5Ya5kxM9Lgh+XcBDwfnDLI1Yoozbd\r\nMbkCAwEAAaOCAVcwggFTMIGtBgNVHSAEgaUwgaIwTwYGYEwBAYEJMEUwQwYIKwYB\r\nBQUHAgEWN2h0dHBzOi8vcmVwb3NpdG9yaW8uc2VycHJvLmdvdi5ici9kb2NzL2Rw\r\nY3NlcnByb3NzbC5wZGYwTwYGYEwBAgFpMEUwQwYIKwYBBQUHAgEWN2h0dHBzOi8v\r\ncmVwb3NpdG9yaW8uc2VycHJvLmdvdi5ici9kb2NzL2RwY3NlcnByb3NzbC5wZGYw\r\nQAYDVR0fBDkwNzA1oDOgMYYvaHR0cDovL2FjcmFpei5pY3BicmFzaWwuZ292LmJy\r\nL0xDUmFjcmFpenYxMC5jcmwwHwYDVR0jBBgwFoAUdPN+//yfU3rxfOurPqSm2hi6\r\nRWMwHQYDVR0OBBYEFK0WT0vxDL7CiqKFGNcNRiWTIuPNMA8GA1UdEwEB/wQFMAMB\r\nAf8wDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEBDQUAA4ICAQCDvWkOYakalAHB\r\n3ZcifI9yLyuTtjR8eYXlfDesYr7zMFVlmduVghCgueBMZxmht9BpLq9/ceBWu1q8\r\nsKge5oNNyySPmBJFe+CLjtB7Z1Ljk0Q/7A59lMCDZajojJlSEnH6pdhxA1JD58E0\r\ndGsom3SufuBWxdNfgsvpQNXDoKp48VlkyL4DKFCdJExtzuR5IlcQbB1FrmB5m2zo\r\nGG6j7UdoevmikIv01la+8kyn7CF5aNubRE0cfwxulik5LNM1uLIwfUVwYbbQiB8z\r\nbaLUOS2lU/pYr+seLQ7VBPHps/guGB9hKei/Df49KWjDVplu3+AuZhBHqiK533VJ\r\nf9Uwv3Rvx8FCobT54OCrAVfnFs8F6sM3dPh1u7AbW3Ddpeo4oBH5kBA0feLvLk7v\r\nmOnOq64oPMMoj+g6x0B0v7tGqOrNBZK486MaU/uaJi+omx+Le9EfyIz39BbRYGdV\r\nJvO/9P8vn5XnNXsmqziw08ENLjHcrro48tRm3YX0/BUgoitjMUqyzlKTgQ8UOpfi\r\nXeJzqvxvUMO/HgZK9aknN3WQXWXxIFG01OHsEOTd2Nddqbrth5qmZE+1IxwEH+ys\r\nQQzlV0pnPL5K0bRuPCqvH4Jr0CmwV2PqD6dkjI/Sy77XDkTP8adAuYjIEynBoQ0b\r\ntqY/0rJPT3dztepWAwRHhKbvO1yYkA==\r\n-----END CERTIFICATE-----\r\n", "-----BEGIN CERTIFICATE-----\r\nMIIGrDCCBJSgAwIBAgIJANLVi0S/gZNCMA0GCSqGSIb3DQEBDQUAMIGYMQswCQYD\r\nVQQGEwJCUjETMBEGA1UECgwKSUNQLUJyYXNpbDE9MDsGA1UECww0SW5zdGl0dXRv\r\nIE5hY2lvbmFsIGRlIFRlY25vbG9naWEgZGEgSW5mb3JtYWNhbyAtIElUSTE1MDMG\r\nA1UEAwwsQXV0b3JpZGFkZSBDZXJ0aWZpY2Fkb3JhIFJhaXogQnJhc2lsZWlyYSB2\r\nMTAwHhcNMTkwNzAxMTkxNTU5WhcNMzIwNzAxMTIwMDU5WjCBmDELMAkGA1UEBhMC\r\nQlIxEzARBgNVBAoMCklDUC1CcmFzaWwxPTA7BgNVBAsMNEluc3RpdHV0byBOYWNp\r\nb25hbCBkZSBUZWNub2xvZ2lhIGRhIEluZm9ybWFjYW8gLSBJVEkxNTAzBgNVBAMM\r\nLEF1dG9yaWRhZGUgQ2VydGlmaWNhZG9yYSBSYWl6IEJyYXNpbGVpcmEgdjEwMIIC\r\nIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAk3AxKl1ZtP0pNyjChqO7qNkn\r\n+/sClZeqiV/Kd7KnnbkDbI2y3VWcUG7feCE/deIxot6GH6JXncRG794UZl+4doD0\r\nD0/cEwBd4DvrDSZm0RT40xhmYYOTxZDJxv+coTHdmsT5aNmSkktfjzYX4HQHh/7M\r\nem+kTOpT/3E4K6B7KVs9HkOT7nXx5yU1qYbVWqI0qpJM9mOTSFx8C9HiKcHvLCvt\r\n1ioXKPAmFuHPkayOcXP2MXeb+VRNjWKU4E+L2t5uZPKVx1M/9i1DztlLb4K8OfYg\r\nGaPDUSF1sxnoGk5qZHLleO6KjCpmuQepmgsBvxi2YNO7X2YUwQQx1AXNSolgtkAR\r\n5gt+1WzxhbFUhItQqlhqxgWHefLmiT5T/Ctz/P2v+zSO4efkkIzsi1iwD+ypZvM2\r\nlnIvB24RcSN6jzmCahLPX4CwjwIK6JsSoMVxIhpZHCguUP4LXqP8IWUZ6WgS/4zB\r\n7B9E0EICl2rM1PRy+6ulv+ZOW256e8a0pijUB+hXM1msUq9L92476FAAX8va3sP7\r\n+Uut94+bGHmubcTLImWUPrxNT7QyrvE3FyHicfiHioeFL2oV4cXTLZrEq2wS8R4P\r\nKPdSzNn5Z9e2uMEGYQaSNO+OwvVycpIhOBOqrm12wJ9ZhWKtM5UOo34/o37r5ZBI\r\nTYXAGbhqQDB9mWXwH+0CAwEAAaOB9jCB8zBOBgNVHSAERzBFMEMGBWBMAQEAMDow\r\nOAYIKwYBBQUHAgEWLGh0dHA6Ly9hY3JhaXouaWNwYnJhc2lsLmdvdi5ici9EUENh\r\nY3JhaXoucGRmMEAGA1UdHwQ5MDcwNaAzoDGGL2h0dHA6Ly9hY3JhaXouaWNwYnJh\r\nc2lsLmdvdi5ici9MQ1JhY3JhaXp2MTAuY3JsMB8GA1UdIwQYMBaAFHTzfv/8n1N6\r\n8Xzrqz6kptoYukVjMB0GA1UdDgQWBBR0837//J9TevF866s+pKbaGLpFYzAPBgNV\r\nHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQ0FAAOCAgEA\r\neCNhBSuy/Ih/T+1VOtAJju85SrtoE3vET1qXASpmjQllDHG/ph7VFNRAkC+gha+B\r\nCbjoA5oJ/8wwl+Qdp1KGz6nXXFTLx3osU+kjm0srmBf9nyXHPqvFyvBeB0A7sYb7\r\nTmII9GKD20oCxsdkccR/oE/JuTaNnGq0GYZ2aDb5v62uLi21Y6P9UBiTxZqQ4ojW\r\nET6kXNjlK238jpXv17FR8Sg3VusCvX7Q8eJkavvHHZDeWck2fSA+ycAc2JeL2Z0B\r\nMSxGWpH32WM9J8+6XqCJUXHiWEV0zCE8wDYiYC+047pTxQI/gB/FcU7jvylh98DJ\r\nkQPHd/Tp6Og3ynlDA9n9uBbxYHVRZs9vsZ/7xTFaxRe+zk8dhgKgZ/3RrcMFB570\r\n2t8LFbyuUE/kQVY6rZ0QJ9qMWQ7VPLRwRhiMeU3k8WDJb/tBbOXHBqldTbWyQ+mp\r\nMEDWhbrzE/IED82wAuO23Tb05cYk2xC7+Izef8fSc3XdJDuPSbcDpWukzyCDtSEH\r\nisLiGEtIbYRiPsF3czlQPsnIEVoTTCWxHCH1zYR6zScSv18Qh69qVe2J40K5jZoP\r\nGEOhq/oKhVJQAdvAFW5Odp7mF3Tk9nivjjsctJSxY26LFiV5GRV+07SSse4ti0aO\r\njO5PLg5SWjfcOtBG2rz02EIvQAmLcb0kGBtfdj0lW/w=\r\n-----END CERTIFICATE-----\r\n" ];
+let tls = require("tls"), CA = [ "-----BEGIN CERTIFICATE-----\r\nMIIHAjCCBOqgAwIBAgIJAJVIeKgiEmNTMA0GCSqGSIb3DQEBDQUAMIGYMQswCQYD\r\nVQQGEwJCUjETMBEGA1UECgwKSUNQLUJyYXNpbDE9MDsGA1UECww0SW5zdGl0dXRv\r\nIE5hY2lvbmFsIGRlIFRlY25vbG9naWEgZGEgSW5mb3JtYWNhbyAtIElUSTE1MDMG\r\nA1UEAwwsQXV0b3JpZGFkZSBDZXJ0aWZpY2Fkb3JhIFJhaXogQnJhc2lsZWlyYSB2\r\nMTAwHhcNMjAwMzEyMTkzMTQyWhcNMzIwNzAxMTIwMDU5WjCBjDELMAkGA1UEBhMC\r\nQlIxEzARBgNVBAoMCklDUC1CcmFzaWwxNTAzBgNVBAsMLEF1dG9yaWRhZGUgQ2Vy\r\ndGlmaWNhZG9yYSBSYWl6IEJyYXNpbGVpcmEgdjEwMTEwLwYDVQQDDChBdXRvcmlk\r\nYWRlIENlcnRpZmljYWRvcmEgZG8gU0VSUFJPIFNTTHYxMIICIjANBgkqhkiG9w0B\r\nAQEFAAOCAg8AMIICCgKCAgEA61jQVBX27GVzyZkJuyrEezqjBGdLSJDFRyGdwxbm\r\n8Ntr0AA8blhDaN5ASDOjqDESMA7xF38znfkZWBMLxJ3Ob0271W6G9bqgTwp/svhZ\r\ns91UcbZW6sB7gyxzMTGWLxcFMeBrurM0QpMVsp8hDH5Suv5rfP0YB9brz60k104u\r\nHG625rAcbRKHn7XsWJ1ZUQcwRzx1g0L1NlUKpsk0+eOAxTcVSVRTO33k+n6Gve83\r\n4MXMiG6Orved4isnEvQnl4AecCXOuUuM3vXZ+kdJGTpNy1HOy0coFdKCJSSCxU/y\r\nTbTiAiRJTc8rbvor3I7k7wR4ZDR8alDbW/Sbw1JEMtbQqMOXEOV7iEUIub0/uNT2\r\ng0oM4pu8DAxhIwy2YQCpjfCbzYu2bf1nabuOEQ2B4mFt/zgoxa5FLsM+0IjpCi8u\r\nz9RqLvYFo9pIy5BTi7JMkVfbgqcOv7vkQf3xF7sODdInCVRIbB0R6xpHm+bpitx9\r\nt5ip+Sf24QFlKbjy0gwVAnaEyf/iQF+t8qgcFBO65kyfH/2vs6iYg5TNhFKtjpqQ\r\niTyI7YkRkfTbLFdcgZbiRUUs5TFi0BkS4PAWupO1GgV9sJdk9gm3Z+KNZDgoAnu7\r\nCvhq1JXt6t7qO96WzBx9q9hi7T6eld1VFrV5Ya5kxM9Lgh+XcBDwfnDLI1Yoozbd\r\nMbkCAwEAAaOCAVcwggFTMIGtBgNVHSAEgaUwgaIwTwYGYEwBAYEJMEUwQwYIKwYB\r\nBQUHAgEWN2h0dHBzOi8vcmVwb3NpdG9yaW8uc2VycHJvLmdvdi5ici9kb2NzL2Rw\r\nY3NlcnByb3NzbC5wZGYwTwYGYEwBAgFpMEUwQwYIKwYBBQUHAgEWN2h0dHBzOi8v\r\ncmVwb3NpdG9yaW8uc2VycHJvLmdvdi5ici9kb2NzL2RwY3NlcnByb3NzbC5wZGYw\r\nQAYDVR0fBDkwNzA1oDOgMYYvaHR0cDovL2FjcmFpei5pY3BicmFzaWwuZ292LmJy\r\nL0xDUmFjcmFpenYxMC5jcmwwHwYDVR0jBBgwFoAUdPN+//yfU3rxfOurPqSm2hi6\r\nRWMwHQYDVR0OBBYEFK0WT0vxDL7CiqKFGNcNRiWTIuPNMA8GA1UdEwEB/wQFMAMB\r\nAf8wDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEBDQUAA4ICAQCDvWkOYakalAHB\r\n3ZcifI9yLyuTtjR8eYXlfDesYr7zMFVlmduVghCgueBMZxmht9BpLq9/ceBWu1q8\r\nsKge5oNNyySPmBJFe+CLjtB7Z1Ljk0Q/7A59lMCDZajojJlSEnH6pdhxA1JD58E0\r\ndGsom3SufuBWxdNfgsvpQNXDoKp48VlkyL4DKFCdJExtzuR5IlcQbB1FrmB5m2zo\r\nGG6j7UdoevmikIv01la+8kyn7CF5aNubRE0cfwxulik5LNM1uLIwfUVwYbbQiB8z\r\nbaLUOS2lU/pYr+seLQ7VBPHps/guGB9hKei/Df49KWjDVplu3+AuZhBHqiK533VJ\r\nf9Uwv3Rvx8FCobT54OCrAVfnFs8F6sM3dPh1u7AbW3Ddpeo4oBH5kBA0feLvLk7v\r\nmOnOq64oPMMoj+g6x0B0v7tGqOrNBZK486MaU/uaJi+omx+Le9EfyIz39BbRYGdV\r\nJvO/9P8vn5XnNXsmqziw08ENLjHcrro48tRm3YX0/BUgoitjMUqyzlKTgQ8UOpfi\r\nXeJzqvxvUMO/HgZK9aknN3WQXWXxIFG01OHsEOTd2Nddqbrth5qmZE+1IxwEH+ys\r\nQQzlV0pnPL5K0bRuPCqvH4Jr0CmwV2PqD6dkjI/Sy77XDkTP8adAuYjIEynBoQ0b\r\ntqY/0rJPT3dztepWAwRHhKbvO1yYkA==\r\n-----END CERTIFICATE-----\r\n", "-----BEGIN CERTIFICATE-----\r\nMIIGrDCCBJSgAwIBAgIJANLVi0S/gZNCMA0GCSqGSIb3DQEBDQUAMIGYMQswCQYD\r\nVQQGEwJCUjETMBEGA1UECgwKSUNQLUJyYXNpbDE9MDsGA1UECww0SW5zdGl0dXRv\r\nIE5hY2lvbmFsIGRlIFRlY25vbG9naWEgZGEgSW5mb3JtYWNhbyAtIElUSTE1MDMG\r\nA1UEAwwsQXV0b3JpZGFkZSBDZXJ0aWZpY2Fkb3JhIFJhaXogQnJhc2lsZWlyYSB2\r\nMTAwHhcNMTkwNzAxMTkxNTU5WhcNMzIwNzAxMTIwMDU5WjCBmDELMAkGA1UEBhMC\r\nQlIxEzARBgNVBAoMCklDUC1CcmFzaWwxPTA7BgNVBAsMNEluc3RpdHV0byBOYWNp\r\nb25hbCBkZSBUZWNub2xvZ2lhIGRhIEluZm9ybWFjYW8gLSBJVEkxNTAzBgNVBAMM\r\nLEF1dG9yaWRhZGUgQ2VydGlmaWNhZG9yYSBSYWl6IEJyYXNpbGVpcmEgdjEwMIIC\r\nIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAk3AxKl1ZtP0pNyjChqO7qNkn\r\n+/sClZeqiV/Kd7KnnbkDbI2y3VWcUG7feCE/deIxot6GH6JXncRG794UZl+4doD0\r\nD0/cEwBd4DvrDSZm0RT40xhmYYOTxZDJxv+coTHdmsT5aNmSkktfjzYX4HQHh/7M\r\nem+kTOpT/3E4K6B7KVs9HkOT7nXx5yU1qYbVWqI0qpJM9mOTSFx8C9HiKcHvLCvt\r\n1ioXKPAmFuHPkayOcXP2MXeb+VRNjWKU4E+L2t5uZPKVx1M/9i1DztlLb4K8OfYg\r\nGaPDUSF1sxnoGk5qZHLleO6KjCpmuQepmgsBvxi2YNO7X2YUwQQx1AXNSolgtkAR\r\n5gt+1WzxhbFUhItQqlhqxgWHefLmiT5T/Ctz/P2v+zSO4efkkIzsi1iwD+ypZvM2\r\nlnIvB24RcSN6jzmCahLPX4CwjwIK6JsSoMVxIhpZHCguUP4LXqP8IWUZ6WgS/4zB\r\n7B9E0EICl2rM1PRy+6ulv+ZOW256e8a0pijUB+hXM1msUq9L92476FAAX8va3sP7\r\n+Uut94+bGHmubcTLImWUPrxNT7QyrvE3FyHicfiHioeFL2oV4cXTLZrEq2wS8R4P\r\nKPdSzNn5Z9e2uMEGYQaSNO+OwvVycpIhOBOqrm12wJ9ZhWKtM5UOo34/o37r5ZBI\r\nTYXAGbhqQDB9mWXwH+0CAwEAAaOB9jCB8zBOBgNVHSAERzBFMEMGBWBMAQEAMDow\r\nOAYIKwYBBQUHAgEWLGh0dHA6Ly9hY3JhaXouaWNwYnJhc2lsLmdvdi5ici9EUENh\r\nY3JhaXoucGRmMEAGA1UdHwQ5MDcwNaAzoDGGL2h0dHA6Ly9hY3JhaXouaWNwYnJh\r\nc2lsLmdvdi5ici9MQ1JhY3JhaXp2MTAuY3JsMB8GA1UdIwQYMBaAFHTzfv/8n1N6\r\n8Xzrqz6kptoYukVjMB0GA1UdDgQWBBR0837//J9TevF866s+pKbaGLpFYzAPBgNV\r\nHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQ0FAAOCAgEA\r\neCNhBSuy/Ih/T+1VOtAJju85SrtoE3vET1qXASpmjQllDHG/ph7VFNRAkC+gha+B\r\nCbjoA5oJ/8wwl+Qdp1KGz6nXXFTLx3osU+kjm0srmBf9nyXHPqvFyvBeB0A7sYb7\r\nTmII9GKD20oCxsdkccR/oE/JuTaNnGq0GYZ2aDb5v62uLi21Y6P9UBiTxZqQ4ojW\r\nET6kXNjlK238jpXv17FR8Sg3VusCvX7Q8eJkavvHHZDeWck2fSA+ycAc2JeL2Z0B\r\nMSxGWpH32WM9J8+6XqCJUXHiWEV0zCE8wDYiYC+047pTxQI/gB/FcU7jvylh98DJ\r\nkQPHd/Tp6Og3ynlDA9n9uBbxYHVRZs9vsZ/7xTFaxRe+zk8dhgKgZ/3RrcMFB570\r\n2t8LFbyuUE/kQVY6rZ0QJ9qMWQ7VPLRwRhiMeU3k8WDJb/tBbOXHBqldTbWyQ+mp\r\nMEDWhbrzE/IED82wAuO23Tb05cYk2xC7+Izef8fSc3XdJDuPSbcDpWukzyCDtSEH\r\nisLiGEtIbYRiPsF3czlQPsnIEVoTTCWxHCH1zYR6zScSv18Qh69qVe2J40K5jZoP\r\nGEOhq/oKhVJQAdvAFW5Odp7mF3Tk9nivjjsctJSxY26LFiV5GRV+07SSse4ti0aO\r\njO5PLg5SWjfcOtBG2rz02EIvQAmLcb0kGBtfdj0lW/w=\r\n-----END CERTIFICATE-----\r\n" ], RAIZES_PADRAO = "function" == typeof tls.getCACertificates ? tls.getCACertificates("default") : tls.rootCertificates, CA_PADRAO = [ ...RAIZES_PADRAO, ...CA ];
 
 module.exports = {
-    CA: CA
+    CA: CA,
+    CA_PADRAO: CA_PADRAO
 };

package/lib/env/index.js

@@ -1,7 +1,11 @@
-let CA = require("./ca").CA, DISTRIBUICAO = require("./distribuicao").DISTRIBUICAO, EVENTOS = require("./evento").EVENTOS, RECEPCAO = require("./recepcao").RECEPCAO, CODIGOS_UF = require("./uf").CODIGOS_UF, VERSION = require("./version").VERSION, ZONES = require("./zone").ZONES;
+let {
+    CA,
+    CA_PADRAO
+} = require("./ca"), DISTRIBUICAO = require("./distribuicao").DISTRIBUICAO, EVENTOS = require("./evento").EVENTOS, RECEPCAO = require("./recepcao").RECEPCAO, CODIGOS_UF = require("./uf").CODIGOS_UF, VERSION = require("./version").VERSION, ZONES = require("./zone").ZONES;
 
 module.exports = {
     CA: CA,
+    CA_PADRAO: CA_PADRAO,
     CODIGOS_UF: CODIGOS_UF,
     DISTRIBUICAO: DISTRIBUICAO,
     EVENTOS: EVENTOS,

package/lib/env/version.js

@@ -1,3 +1,3 @@
 module.exports = {
-    VERSION: "0.17.1"
+    VERSION: "0.19.0"
 };

package/lib/helpers/distribuicaoDFe-helper.js

@@ -1,5 +1,5 @@
 let {
-    CA,
+    CA_PADRAO,
     DISTRIBUICAO
 } = require("../env"), DistribuicaoSchema = require("../schemas").DistribuicaoSchema, SefazService = require("../services/sefaz-service"), {
     Gzip,
@@ -7,19 +7,19 @@ let {
 } = require("../util");
 
 class DistribuicaoHelper {
-    static async enviarConsulta(e, t) {
-        var r = DISTRIBUICAO[t.tpAmb], e = {
+    static async enviarConsulta(e, r) {
+        var t = DISTRIBUICAO[r.tpAmb], e = {
             method: "POST",
             data: e
         };
         return await new SefazService({
-            baseURL: r,
-            ca: CA,
-            cert: t.cert,
-            key: t.key,
-            tpAmb: t.tpAmb,
-            requestOptions: t.requestOptions,
-            httpsOptions: t.httpsOptions
+            baseURL: t,
+            ca: CA_PADRAO,
+            cert: r.cert,
+            key: r.key,
+            tpAmb: r.tpAmb,
+            requestOptions: r.requestOptions,
+            httpsOptions: r.httpsOptions
         }).request(e);
     }
     static montarRequest(e) {
@@ -27,7 +27,7 @@ class DistribuicaoHelper {
         return Xml.envelopar(e);
     }
     static async montarResponse(e) {
-        var t = {}, e = Xml.xmlToJson(e), {
+        var r = {}, e = Xml.xmlToJson(e), {
             "soap:Envelope": {
                 "soap:Body": {
                     nfeDistDFeInteresseResponse: {
@@ -37,21 +37,51 @@ class DistribuicaoHelper {
                     } = {}
                 } = {}
             } = {}
-        } = (e.error && (t.error = e.error), e), {
-            loteDistDFeInt: r = {}
-        } = e, r = (r.docZip ? Array.isArray(r.docZip) || (r.docZip = [ r.docZip ]) : r.docZip = [], 
-        await Promise.all(r.docZip.map(async e => {
-            var t = await Gzip.unzip(e.value);
+        } = (e.error && (r.error = e.error), e);
+        let {
+            loteDistDFeInt: t = {}
+        } = e;
+        "" === t ? t = {} : "object" == typeof t && !Array.isArray(t) || (r.error = "loteDistDFeInt inválido.", 
+        t = {}), t.docZip ? Array.isArray(t.docZip) || (t.docZip = [ t.docZip ]) : t.docZip = [];
+        var a, s = [], i = [];
+        for (a of await Promise.all(t.docZip.map(e => DistribuicaoHelper.abrirDocZip(e)))) (a.error ? i : s).push(a);
+        return r.tpAmb = e.tpAmb || "", r.verAplic = e.verAplic || "", r.cStat = e.cStat || "", 
+        r.xMotivo = e.xMotivo || "", r.dhResp = e.dhResp || "", r.ultNSU = e.ultNSU || "", 
+        r.maxNSU = e.maxNSU || "", r.docZip = s, r.docZipErrors = i, r;
+    }
+    static async abrirDocZip(e) {
+        var r = e["@_NSU"] || "", t = e["@_schema"] || "";
+        if (!e.value) return {
+            nsu: r,
+            schema: t,
+            error: "docZip sem conteúdo."
+        };
+        let a;
+        try {
+            a = await Gzip.unzip(e.value);
+        } catch (e) {
             return {
-                xml: t,
-                json: Xml.xmlToJson(t),
-                nsu: e["@_NSU"],
-                schema: e["@_schema"]
+                nsu: r,
+                schema: t,
+                error: "Falha ao descompactar o docZip: " + e.message
             };
-        })));
-        return t.tpAmb = e.tpAmb || "", t.verAplic = e.verAplic || "", t.cStat = e.cStat || "", 
-        t.xMotivo = e.xMotivo || "", t.dhResp = e.dhResp || "", t.ultNSU = e.ultNSU || "", 
-        t.maxNSU = e.maxNSU || "", t.docZip = r, t;
+        }
+        let s;
+        try {
+            s = Xml.xmlToJson(a);
+        } catch (e) {
+            return {
+                nsu: r,
+                schema: t,
+                error: "Falha ao interpretar o XML do docZip: " + e.message
+            };
+        }
+        return {
+            xml: a,
+            json: s,
+            nsu: r,
+            schema: t
+        };
     }
 }
 

package/lib/helpers/recepcaoEvento-helper.js

@@ -1,5 +1,5 @@
 let {
-    CA,
+    CA_PADRAO,
     RECEPCAO
 } = require("../env"), RecepcaoSchema = require("../schemas").RecepcaoSchema, SefazService = require("../services/sefaz-service"), {
     Assinatura,
@@ -14,7 +14,7 @@ class RecepcaoHelper {
         };
         return await new SefazService({
             baseURL: o,
-            ca: CA,
+            ca: CA_PADRAO,
             cert: t.cert,
             key: t.key,
             tpAmb: t.tpAmb,

package/lib/helpers/retorno-helper.js

@@ -1,17 +1,24 @@
 class RetornoHelper {
     static montarRetorno(r) {
-        var {
+        var e, t, {
             json: r,
-            data: e,
-            retornoSefaz: t
-        } = r, e = {
+            data: a,
+            retornoSefaz: o
+        } = r, a = {
             data: r,
-            reqXml: e,
-            resXml: t.data,
-            status: t.status
+            reqXml: a,
+            resXml: o.data,
+            status: o.status
         };
-        return r.error && (e.data = {}, e.error = r.error), 2 < Math.floor(t.status / 100) && !r.error && (e.data = {}, 
-        e.error = t.data), e;
+        return o.transportError ? ({
+            code: e,
+            message: t
+        } = o.transportError, a.data = {}, a.error = `Falha de transporte (${e}): ` + t, 
+        a.transportError = {
+            code: e,
+            message: t
+        }) : (r.error && (a.data = {}, a.error = r.error), 2 < Math.floor(o.status / 100) && !r.error && (a.data = {}, 
+        a.error = o.data)), a;
     }
 }
 

package/lib/index.js

@@ -1,12 +1,18 @@
-let DistribuicaoDFe = require("./apis/distribuicaoDFe-api"), RecepcaoEvento = require("./apis/recepcaoEvento-api");
+let DistribuicaoDFe = require("./apis/distribuicaoDFe-api"), RecepcaoEvento = require("./apis/recepcaoEvento-api"), env = require("./env"), CA_ICP_BRASIL = Object.freeze(env.CA), CA_PADRAO = Object.freeze(env.CA_PADRAO);
 
 module.exports = {
+    CA_ICP_BRASIL: CA_ICP_BRASIL,
+    CA_PADRAO: CA_PADRAO,
     DistribuicaoDFe: DistribuicaoDFe,
     RecepcaoEvento: RecepcaoEvento
 }, module.exports.default = {
+    CA_ICP_BRASIL: CA_ICP_BRASIL,
+    CA_PADRAO: CA_PADRAO,
     DistribuicaoDFe: DistribuicaoDFe,
     RecepcaoEvento: RecepcaoEvento
 }, module.exports.mde = {
+    CA_ICP_BRASIL: CA_ICP_BRASIL,
+    CA_PADRAO: CA_PADRAO,
     DistribuicaoDFe: DistribuicaoDFe,
     RecepcaoEvento: RecepcaoEvento
 };

package/lib/services/sefaz-service.js

@@ -11,7 +11,7 @@ class Instance {
             cert: a,
             key: r,
             ca: s,
-            rejectUnauthorized: !1
+            rejectUnauthorized: !0
         }, {
             ...t.httpsOptions
         }), r = new https.Agent(a), s = Object.assign({
@@ -33,29 +33,30 @@ class Instance {
         try {
             var {
                 status: s,
-                data: t
+                data: a
             } = await this.instance(e);
             return {
                 status: s,
-                data: t
+                data: a
             };
         } catch (t) {
-            return t.response ? ({
+            return t && t.response ? ({
                 status: e,
                 data: s
             } = t.response, {
                 status: e,
                 data: s
-            }) : t.request ? "ECONNABORTED" === t.code ? {
-                status: 504,
-                data: `<error>${t.message || t}</error>`
-            } : {
-                status: 502,
-                data: `<error>${t.message || t}</error>`
-            } : {
-                status: 500,
-                data: `<error>${t.message || t}</error>`
-            };
+            }) : ({
+                code: a,
+                message: e
+            } = t || {}, {
+                status: 0,
+                data: "",
+                transportError: {
+                    code: a ? String(a) : "ERR_DESCONHECIDO",
+                    message: e ? String(e) : String(t)
+                }
+            });
         }
     }
 }

package/lib/util/gzip.js

@@ -3,11 +3,11 @@ let zlib = require("zlib");
 class Gzip {
     static unzip(e) {
         let i = Buffer.from(e, "base64");
-        return new Promise((t, r) => {
+        return new Promise((r, t) => {
             zlib.unzip(i, function(e, i) {
-                e && r(e);
+                if (e) return t(e);
                 e = i.toString("utf8");
-                t(e);
+                r(e);
             });
         });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitize/bitmde",
-  "version": "0.17.1",
+  "version": "0.19.0",
   "description": "Biblioteca para consultar notas destinadas e enviar evento de manifestação do destinatário",
   "main": "./lib/index.js",
   "types": "./dist/index.d.ts",
@@ -22,7 +22,7 @@
     "script": "node ./scripts/index.js",
     "release": "git pull && npm run build && npm publish",
     "test": "mocha",
-    "test:ci": "mocha --ignore test/sefaz.test.js",
+    "test:ci": "mocha --ignore test/sefaz.test.js --ignore test/tls-sefaz.test.js",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "certs:teste": "sh ./scripts/gerar-certificado-teste.sh",
@@ -56,6 +56,9 @@
     "Carlos Tirabassi Jr. <carlos@bitize.com.br>"
   ],
   "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
   "bugs": {
     "url": "https://github.com/bitize/bitmde/issues"
   },