ghinfe 0.6.0 → 0.6.2

package/src/dce/utils/qrcode.utils.js

@@ -0,0 +1,59 @@
+import crypto from 'crypto';
+import { DCE_QRCODE_URL, DCE_TIPO_EMISSAO } from '../constants/dce.js';
+import { loadPfxCertificate } from '../../utils/certificate.utils.js';
+import { GhinfeError } from '../../errors/GhinfeError.js';
+
+/**
+ * Assina a chave de acesso (RSA-SHA1, Base64) para o parâmetro sign do QR Code
+ * em contingência off-line. Deve usar o mesmo certificado que assina a DC-e.
+ * @param {string} chaveAcesso
+ * @param {Buffer|string} pfx
+ * @param {string} senha
+ */
+export function assinarChaveQrCodeDCe(chaveAcesso, pfx, senha) {
+  const { privateKeyPem } = loadPfxCertificate(pfx, senha);
+  return crypto.createSign('RSA-SHA1').update(chaveAcesso).sign(privateKeyPem, 'base64');
+}
+
+/**
+ * Monta URL do QR Code da DC-e (Manual DC-e — Anexo II, item 3.2).
+ *
+ * Normal:       {url}?chDCe={chave}&tpAmb={amb}
+ * Contingência: {url}?chDCe={chave}&tpAmb={amb}&sign={assinatura}&{CNPJ|CPF|idOutros}={doc}
+ *
+ * O pattern de qrCodDCe no XSD exige "&sign=" logo após tpAmb, embora o exemplo
+ * do manual traga a identificação do emitente antes de sign.
+ *
+ * @param {{
+ *   chaveAcesso: string,
+ *   ambiente?: number,
+ *   tipoEmissao?: number,
+ *   emitente?: { cnpj?: string, cpf?: string, idOutros?: string },
+ *   sign?: string,
+ *   baseUrl?: string,
+ * }} params
+ */
+export function gerarUrlQrCodeDCe(params) {
+  const baseUrl = params.baseUrl ?? DCE_QRCODE_URL;
+  let url = `${baseUrl}?chDCe=${params.chaveAcesso}&tpAmb=${params.ambiente ?? 2}`;
+
+  if ((params.tipoEmissao ?? DCE_TIPO_EMISSAO.NORMAL) !== DCE_TIPO_EMISSAO.CONTINGENCIA_OFFLINE) {
+    return url;
+  }
+
+  if (!params.sign) {
+    throw new GhinfeError(
+      'Parâmetro sign obrigatório no QR Code em contingência off-line',
+      'DCE_QRCODE_SIGN_MISSING'
+    );
+  }
+
+  url += `&sign=${params.sign}`;
+
+  const emit = params.emitente ?? {};
+  if (emit.cnpj) url += `&CNPJ=${emit.cnpj.replace(/\D/g, '')}`;
+  else if (emit.cpf) url += `&CPF=${emit.cpf.replace(/\D/g, '')}`;
+  else if (emit.idOutros) url += `&idOutros=${emit.idOutros}`;
+
+  return url;
+}

package/src/errors/GhinfeError.js

@@ -1,13 +1,13 @@
-export class GhinfeError extends Error {
-  /**
-   * @param {string} message
-   * @param {string} [code]
-   * @param {unknown} [details]
-   */
-  constructor(message, code = 'GHINFE_ERROR', details = null) {
-    super(message);
-    this.name = 'GhinfeError';
-    this.code = code;
-    this.details = details;
-  }
-}
+export class GhinfeError extends Error {
+  /**
+   * @param {string} message
+   * @param {string} [code]
+   * @param {unknown} [details]
+   */
+  constructor(message, code = 'GHINFE_ERROR', details = null) {
+    super(message);
+    this.name = 'GhinfeError';
+    this.code = code;
+    this.details = details;
+  }
+}

package/src/errors/SefazError.js

@@ -1,25 +1,25 @@
-import { GhinfeError } from './GhinfeError.js';
-
-export class SefazError extends GhinfeError {
-  /**
-   * @param {string} cStat
-   * @param {string} xMotivo
-   * @param {Record<string, unknown>} [raw]
-   */
-  constructor(cStat, xMotivo, raw = {}) {
-    super(`SEFAZ [${cStat}]: ${xMotivo}`, `SEFAZ_${cStat}`, { cStat, xMotivo, ...raw });
-    this.name = 'SefazError';
-    this.cStat = cStat;
-    this.xMotivo = xMotivo;
-  }
-
-  /** @returns {boolean} */
-  isAutorizado() {
-    return this.cStat === '100';
-  }
-
-  /** @returns {boolean} */
-  isRejeicao() {
-    return this.cStat.length === 3 && this.cStat.startsWith('2');
-  }
-}
+import { GhinfeError } from './GhinfeError.js';
+
+export class SefazError extends GhinfeError {
+  /**
+   * @param {string} cStat
+   * @param {string} xMotivo
+   * @param {Record<string, unknown>} [raw]
+   */
+  constructor(cStat, xMotivo, raw = {}) {
+    super(`SEFAZ [${cStat}]: ${xMotivo}`, `SEFAZ_${cStat}`, { cStat, xMotivo, ...raw });
+    this.name = 'SefazError';
+    this.cStat = cStat;
+    this.xMotivo = xMotivo;
+  }
+
+  /** @returns {boolean} */
+  isAutorizado() {
+    return this.cStat === '100';
+  }
+
+  /** @returns {boolean} */
+  isRejeicao() {
+    return this.cStat.length === 3 && this.cStat.startsWith('2');
+  }
+}

package/src/errors/XsdValidationError.js

@@ -1,15 +1,15 @@
-import { GhinfeError } from './GhinfeError.js';
-
-export class XsdValidationError extends GhinfeError {
-  /**
-   * @param {string[]} erros
-   * @param {string} [schema]
-   */
-  constructor(erros, schema = 'unknown') {
-    const resumo = erros[0] ?? 'XML não conforme ao schema XSD';
-    super(`Validação XSD falhou: ${resumo}`, 'XSD_VALIDATION_FAILED', { erros, schema });
-    this.name = 'XsdValidationError';
-    this.erros = erros;
-    this.schema = schema;
-  }
-}
+import { GhinfeError } from './GhinfeError.js';
+
+export class XsdValidationError extends GhinfeError {
+  /**
+   * @param {string[]} erros
+   * @param {string} [schema]
+   */
+  constructor(erros, schema = 'unknown') {
+    const resumo = erros[0] ?? 'XML não conforme ao schema XSD';
+    super(`Validação XSD falhou: ${resumo}`, 'XSD_VALIDATION_FAILED', { erros, schema });
+    this.name = 'XsdValidationError';
+    this.erros = erros;
+    this.schema = schema;
+  }
+}

package/src/index.js

@@ -1,60 +1,84 @@
-export { NFeService } from './nfe/services/NFeService.js';
-export { NFeXmlService } from './nfe/services/NFeXmlService.js';
-export { NFeSignService } from './nfe/services/NFeSignService.js';
-export { NFeSoapService } from './nfe/services/NFeSoapService.js';
-export { NFeEventoService } from './nfe/services/NFeEventoService.js';
-export { NFeXsdService } from './nfe/services/NFeXsdService.js';
-export { NFeXmlBuilder } from './nfe/builders/NFeXmlBuilder.js';
-export { NFeEventoXmlBuilder } from './nfe/builders/NFeEventoXmlBuilder.js';
-export { NFeQueue } from './queue/NFeQueue.js';
-
-export { NFCeService } from './nfce/services/NFCeService.js';
-export { NFCeXmlService } from './nfce/services/NFCeXmlService.js';
-export { NFCeXmlBuilder } from './nfce/builders/NFCeXmlBuilder.js';
-export { NFCeQueue } from './queue/NFCeQueue.js';
-export { gerarUrlQrCodeV3, gerarHashQrCodeV3, inserirInfNFeSupl } from './nfce/utils/qrcode.utils.js';
-
-export { NFSeService } from './nfse/services/NFSeService.js';
-export { NFSeXmlService } from './nfse/services/NFSeXmlService.js';
-export { NFSeXmlBuilder } from './nfse/builders/NFSeXmlBuilder.js';
-export { NFSeEventoXmlBuilder } from './nfse/builders/NFSeEventoXmlBuilder.js';
-export { NFSeSoapService, NFSeSoapError } from './nfse/services/NFSeSoapService.js';
-export { NFSeMunicipioResolver } from './nfse/NFSeMunicipioResolver.js';
-export { NFSeQueue } from './queue/NFSeQueue.js';
-export { NFSE_LAYOUTS, NFSE_MUNICIPIOS } from './nfse/constants/municipios.js';
-export { obterAdapter, NFSeLayoutAdapters } from './nfse/layouts/adapters.js';
-
-export { DanfeService } from './danfe/DanfeService.js';
-export { extrairDadosDanfe, formatarChaveAcesso } from './danfe/xml-extract.js';
-
-export { SefazEndpointResolver, SEFAZ_SERVICO } from './sefaz/SefazEndpointResolver.js';
-export { UF_AUTORIZADOR, AUTORIZADOR_ENDPOINTS } from './sefaz/endpoints.registry.js';
-
-export {
-  calcularIBSCBS,
-  buildFragmentoIBSCBS,
-  somarTotaisReforma,
-  reformaHabilitada,
-  appendIBSCBS,
-  appendTotaisIBSCBS,
-  CST_IBSCBS,
-  REFORMA_LAYOUT,
-} from './reforma/ibscbs.js';
-
-export { XsdValidator } from './validation/XsdValidator.js';
-export { XSD_SCHEMAS } from './validation/schemas.js';
-
-export { GhinfeError } from './errors/GhinfeError.js';
-export { SefazError } from './errors/SefazError.js';
-export { XsdValidationError } from './errors/XsdValidationError.js';
-
-export { SEFAZ_STATUS, SEFAZ_URLS, AMBIENTE, NFE_VERSAO, UF_IBGE } from './constants/sefaz.js';
-export { NFE_EVENTOS } from './nfe/types/NFeEvento.js';
-export { loadPfxCertificate } from './utils/certificate.utils.js';
-export {
-  gerarChaveAcesso,
-  calcularDigitoVerificador,
-  validarChaveAcesso,
-  parseChaveAcesso,
-  gerarCodigoNumerico,
-} from './utils/chave.utils.js';
+export { NFeService } from './nfe/services/NFeService.js';
+export { NFeXmlService } from './nfe/services/NFeXmlService.js';
+export { NFeSignService } from './nfe/services/NFeSignService.js';
+export { NFeSoapService } from './nfe/services/NFeSoapService.js';
+export { NFeEventoService } from './nfe/services/NFeEventoService.js';
+export { NFeXsdService } from './nfe/services/NFeXsdService.js';
+export { NFeXmlBuilder } from './nfe/builders/NFeXmlBuilder.js';
+export { NFeEventoXmlBuilder } from './nfe/builders/NFeEventoXmlBuilder.js';
+export { NFeQueue } from './queue/NFeQueue.js';
+
+export { NFCeService } from './nfce/services/NFCeService.js';
+export { NFCeXmlService } from './nfce/services/NFCeXmlService.js';
+export { NFCeXmlBuilder } from './nfce/builders/NFCeXmlBuilder.js';
+export { NFCeQueue } from './queue/NFCeQueue.js';
+export { gerarUrlQrCodeV3, gerarHashQrCodeV3, inserirInfNFeSupl } from './nfce/utils/qrcode.utils.js';
+
+export { NFSeService } from './nfse/services/NFSeService.js';
+export { NFSeXmlService } from './nfse/services/NFSeXmlService.js';
+export { NFSeXmlBuilder } from './nfse/builders/NFSeXmlBuilder.js';
+export { NFSeEventoXmlBuilder } from './nfse/builders/NFSeEventoXmlBuilder.js';
+export { NFSeSoapService, NFSeSoapError } from './nfse/services/NFSeSoapService.js';
+export { NFSeMunicipioResolver } from './nfse/NFSeMunicipioResolver.js';
+export { NFSeQueue } from './queue/NFSeQueue.js';
+export { NFSE_LAYOUTS, NFSE_MUNICIPIOS } from './nfse/constants/municipios.js';
+export { obterAdapter, NFSeLayoutAdapters } from './nfse/layouts/adapters.js';
+
+export { DCeService } from './dce/services/DCeService.js';
+export { DCeXmlService } from './dce/services/DCeXmlService.js';
+export { DCeXmlBuilder } from './dce/builders/DCeXmlBuilder.js';
+export { DCeSoapService } from './dce/services/DCeSoapService.js';
+export { DCeEventoXmlBuilder } from './dce/builders/DCeEventoXmlBuilder.js';
+export { DaceService } from './dce/dace/DaceService.js';
+export { extrairDadosDace } from './dce/dace/dace-extract.js';
+export { codificarCode128C, gerarSvgCode128C } from './utils/code128.utils.js';
+export { gerarUrlQrCodeDCe, assinarChaveQrCodeDCe } from './dce/utils/qrcode.utils.js';
+export {
+  DCE_VERSAO,
+  DCE_TIPO_EMITENTE,
+  DCE_TIPO_EMISSAO,
+  DCE_MODALIDADE_TRANSPORTE,
+  DCE_QRCODE_URL,
+  DCE_WEBSERVICES,
+  DCE_EVENTOS,
+  DCE_STATUS,
+} from './dce/constants/dce.js';
+export { criarHttpsAgentSefaz, ICP_BRASIL_RAIZ_V10 } from './sefaz/httpsAgent.js';
+
+export { DanfeService } from './danfe/DanfeService.js';
+export { extrairDadosDanfe, formatarChaveAcesso } from './danfe/xml-extract.js';
+
+export { SefazEndpointResolver, SEFAZ_SERVICO } from './sefaz/SefazEndpointResolver.js';
+export { UF_AUTORIZADOR, AUTORIZADOR_ENDPOINTS } from './sefaz/endpoints.registry.js';
+
+export {
+  calcularIBSCBS,
+  buildFragmentoIBSCBS,
+  somarTotaisReforma,
+  reformaHabilitada,
+  appendIBSCBS,
+  appendTotaisIBSCBS,
+  CST_IBSCBS,
+  REFORMA_LAYOUT,
+} from './reforma/ibscbs.js';
+
+export { XsdValidator } from './validation/XsdValidator.js';
+export { XSD_SCHEMAS } from './validation/schemas.js';
+
+export { GhinfeError } from './errors/GhinfeError.js';
+export { SefazError } from './errors/SefazError.js';
+export { XsdValidationError } from './errors/XsdValidationError.js';
+
+export { SEFAZ_STATUS, SEFAZ_URLS, AMBIENTE, NFE_VERSAO, UF_IBGE } from './constants/sefaz.js';
+export { NFE_EVENTOS } from './nfe/types/NFeEvento.js';
+export { loadPfxCertificate, criarPfxDePem } from './utils/certificate.utils.js';
+export {
+  gerarChaveAcesso,
+  calcularDigitoVerificador,
+  validarChaveAcesso,
+  parseChaveAcesso,
+  gerarCodigoNumerico,
+  gerarChaveAcessoDCe,
+  parseChaveAcessoDCe,
+  gerarCodigoNumericoDCe,
+} from './utils/chave.utils.js';