ghinfe 0.6.0 → 0.6.2

package/src/nfe/services/NFeXmlService.js

@@ -1,41 +1,41 @@
-import { NFeXmlBuilder } from '../builders/NFeXmlBuilder.js';
-import { NFeXsdService } from './NFeXsdService.js';
-import { reformaHabilitada } from '../../reforma/ibscbs.js';
-
-/**
- * Serviço responsável pela geração e validação XSD do XML da NF-e.
- */
-export class NFeXmlService {
-  /**
-   * @param {{ validarXsd?: boolean }} [options]
-   */
-  constructor(options = {}) {
-    this.builder = new NFeXmlBuilder();
-    this.xsdService = new NFeXsdService();
-    this.validarXsd = options.validarXsd ?? false;
-  }
-
-  /**
-   * @param {import('../types/NFeDocument.js').NFeDocument} documento
-   * @param {{ validarXsd?: boolean }} [options]
-   */
-  gerarXml(documento, options = {}) {
-    const xml = this.builder.build(documento);
-    const deveValidar = options.validarXsd ?? this.validarXsd;
-
-    // PL_009 não conhece IBSCBS — não validar XSD quando reforma está ativa
-    if (deveValidar && !reformaHabilitada(documento)) {
-      this.xsdService.validarNFe(xml, { preAssinatura: true });
-    }
-
-    return xml;
-  }
-
-  /**
-   * @param {string} xml
-   * @param {{ preAssinatura?: boolean }} [options]
-   */
-  validarXml(xml, options = {}) {
-    return this.xsdService.validarNFe(xml, options);
-  }
-}
+import { NFeXmlBuilder } from '../builders/NFeXmlBuilder.js';
+import { NFeXsdService } from './NFeXsdService.js';
+import { reformaHabilitada } from '../../reforma/ibscbs.js';
+
+/**
+ * Serviço responsável pela geração e validação XSD do XML da NF-e.
+ */
+export class NFeXmlService {
+  /**
+   * @param {{ validarXsd?: boolean }} [options]
+   */
+  constructor(options = {}) {
+    this.builder = new NFeXmlBuilder();
+    this.xsdService = new NFeXsdService();
+    this.validarXsd = options.validarXsd ?? false;
+  }
+
+  /**
+   * @param {import('../types/NFeDocument.js').NFeDocument} documento
+   * @param {{ validarXsd?: boolean }} [options]
+   */
+  gerarXml(documento, options = {}) {
+    const xml = this.builder.build(documento);
+    const deveValidar = options.validarXsd ?? this.validarXsd;
+
+    // PL_009 não conhece IBSCBS — não validar XSD quando reforma está ativa
+    if (deveValidar && !reformaHabilitada(documento)) {
+      this.xsdService.validarNFe(xml, { preAssinatura: true });
+    }
+
+    return xml;
+  }
+
+  /**
+   * @param {string} xml
+   * @param {{ preAssinatura?: boolean }} [options]
+   */
+  validarXml(xml, options = {}) {
+    return this.xsdService.validarNFe(xml, options);
+  }
+}

package/src/nfe/services/NFeXsdService.js

@@ -1,56 +1,56 @@
-import { XsdValidator } from '../../validation/XsdValidator.js';
-import { XSD_SCHEMAS } from '../../validation/schemas.js';
-
-/**
- * Validação XSD específica para NF-e / NFC-e (layout 4.00).
- */
-export class NFeXsdService {
-  /**
-   * Valida XML da NF-e (modelo 55) contra schema oficial.
-   * @param {string} xml
-   * @param {{ preAssinatura?: boolean }} [options]
-   *   preAssinatura=true injeta stub estrutural (Signature) para validar infNFe antes de assinar
-   */
-  validarNFe(xml, options = {}) {
-    return XsdValidator.validar(xml, XSD_SCHEMAS.NFE, {
-      injetarAssinaturaStub: options.preAssinatura ?? !xml.includes('</Signature>'),
-      modelo: '55',
-    });
-  }
-
-  /**
-   * Valida XML da NFC-e (modelo 65) contra schema oficial.
-   * @param {string} xml
-   * @param {{ preAssinatura?: boolean }} [options]
-   */
-  validarNFCe(xml, options = {}) {
-    return XsdValidator.validar(xml, XSD_SCHEMAS.NFE, {
-      injetarAssinaturaStub: options.preAssinatura ?? !xml.includes('</Signature>'),
-      modelo: '65',
-    });
-  }
-
-  /**
-   * @param {string} xml
-   * @param {'55'|'65'} [modelo]
-   */
-  tentarValidar(xml, modelo = '55') {
-    return modelo === '65' ? this.tentarValidarNFCe(xml) : this.tentarValidarNFe(xml);
-  }
-
-  /** @param {string} xml */
-  tentarValidarNFe(xml) {
-    return XsdValidator.tentarValidar(xml, XSD_SCHEMAS.NFE, {
-      injetarAssinaturaStub: !xml.includes('</Signature>'),
-      modelo: '55',
-    });
-  }
-
-  /** @param {string} xml */
-  tentarValidarNFCe(xml) {
-    return XsdValidator.tentarValidar(xml, XSD_SCHEMAS.NFE, {
-      injetarAssinaturaStub: !xml.includes('</Signature>'),
-      modelo: '65',
-    });
-  }
-}
+import { XsdValidator } from '../../validation/XsdValidator.js';
+import { XSD_SCHEMAS } from '../../validation/schemas.js';
+
+/**
+ * Validação XSD específica para NF-e / NFC-e (layout 4.00).
+ */
+export class NFeXsdService {
+  /**
+   * Valida XML da NF-e (modelo 55) contra schema oficial.
+   * @param {string} xml
+   * @param {{ preAssinatura?: boolean }} [options]
+   *   preAssinatura=true injeta stub estrutural (Signature) para validar infNFe antes de assinar
+   */
+  validarNFe(xml, options = {}) {
+    return XsdValidator.validar(xml, XSD_SCHEMAS.NFE, {
+      injetarAssinaturaStub: options.preAssinatura ?? !xml.includes('</Signature>'),
+      modelo: '55',
+    });
+  }
+
+  /**
+   * Valida XML da NFC-e (modelo 65) contra schema oficial.
+   * @param {string} xml
+   * @param {{ preAssinatura?: boolean }} [options]
+   */
+  validarNFCe(xml, options = {}) {
+    return XsdValidator.validar(xml, XSD_SCHEMAS.NFE, {
+      injetarAssinaturaStub: options.preAssinatura ?? !xml.includes('</Signature>'),
+      modelo: '65',
+    });
+  }
+
+  /**
+   * @param {string} xml
+   * @param {'55'|'65'} [modelo]
+   */
+  tentarValidar(xml, modelo = '55') {
+    return modelo === '65' ? this.tentarValidarNFCe(xml) : this.tentarValidarNFe(xml);
+  }
+
+  /** @param {string} xml */
+  tentarValidarNFe(xml) {
+    return XsdValidator.tentarValidar(xml, XSD_SCHEMAS.NFE, {
+      injetarAssinaturaStub: !xml.includes('</Signature>'),
+      modelo: '55',
+    });
+  }
+
+  /** @param {string} xml */
+  tentarValidarNFCe(xml) {
+    return XsdValidator.tentarValidar(xml, XSD_SCHEMAS.NFE, {
+      injetarAssinaturaStub: !xml.includes('</Signature>'),
+      modelo: '65',
+    });
+  }
+}

package/src/nfe/types/NFeDocument.js

@@ -1,92 +1,92 @@
-/**
- * @typedef {Object} NFeEndereco
- * @property {string} logradouro
- * @property {string} numero
- * @property {string} [complemento]
- * @property {string} bairro
- * @property {string} codigoMunicipio IBGE 7 dígitos
- * @property {string} municipio
- * @property {string} uf
- * @property {string} cep
- * @property {string} [telefone]
- */
-
-/**
- * @typedef {Object} NFeEmitente
- * @property {string} cnpj
- * @property {string} razaoSocial
- * @property {string} [nomeFantasia]
- * @property {string} ie
- * @property {string} crt 1=Simples, 2=Simples excesso, 3=Normal
- * @property {NFeEndereco} endereco
- */
-
-/**
- * @typedef {Object} NFeDestinatario
- * @property {string} [cnpj]
- * @property {string} [cpf]
- * @property {string} razaoSocial
- * @property {string} [ie]
- * @property {number} [indIEDest] 1=Contribuinte, 2=Isento, 9=Não contribuinte
- * @property {NFeEndereco} endereco
- */
-
-/**
- * @typedef {Object} NFeItem
- * @property {string} codigo
- * @property {string} descricao
- * @property {string} ncm
- * @property {string} cfop
- * @property {string} unidade
- * @property {number} quantidade
- * @property {number} valorUnitario
- * @property {number} valorTotal
- * @property {string} [ean]
- * @property {string} [cst] CST ICMS (ex: "00")
- * @property {number} [aliquotaIcms]
- * @property {number} [valorIcms]
- * @property {import('../../reforma/ibscbs.js').TributacaoRTC} [reforma] IBS/CBS (PL_010)
- */
-
-/**
- * @typedef {Object} NFeFrete
- * @property {number} modalidade 0=Emitente, 1=Destinatário, 9=Sem frete
- * @property {number} [valor]
- * @property {string} [transportadora]
- * @property {string} [cnpjTransportadora]
- */
-
-/**
- * @typedef {Object} NFePagamento
- * @property {string} forma 01=Dinheiro, 03=Cartão crédito, etc.
- * @property {number} valor
- */
-
-/**
- * @typedef {Object} NFeIde
- * @property {string} uf Sigla UF (ex: "SP")
- * @property {string} codigoMunicipio IBGE
- * @property {number} [serie]
- * @property {number} numero
- * @property {number} [tipoEmissao] 1=Normal
- * @property {number} [finalidade] 1=Normal
- * @property {number} [consumidorFinal] 0=Não, 1=Sim
- * @property {number} [presenca] 1=Presencial
- * @property {number} [naturezaOperacao]
- */
-
-/**
- * @typedef {Object} NFeDocumento
- * @property {string} [chaveAcesso] 44 dígitos — gerada automaticamente se omitida
- * @property {number} [ambiente] 1=Produção, 2=Homologação
- * @property {boolean} [reformaTributaria] força totais IBS/CBS mesmo sem item.reforma
- * @property {NFeIde} ide
- * @property {NFeEmitente} emitente
- * @property {NFeDestinatario} destinatario
- * @property {NFeItem[]} itens
- * @property {NFeFrete} [frete]
- * @property {NFePagamento[]} [pagamentos]
- * @property {string} [informacoesComplementares]
- */
-
-export {};
+/**
+ * @typedef {Object} NFeEndereco
+ * @property {string} logradouro
+ * @property {string} numero
+ * @property {string} [complemento]
+ * @property {string} bairro
+ * @property {string} codigoMunicipio IBGE 7 dígitos
+ * @property {string} municipio
+ * @property {string} uf
+ * @property {string} cep
+ * @property {string} [telefone]
+ */
+
+/**
+ * @typedef {Object} NFeEmitente
+ * @property {string} cnpj
+ * @property {string} razaoSocial
+ * @property {string} [nomeFantasia]
+ * @property {string} ie
+ * @property {string} crt 1=Simples, 2=Simples excesso, 3=Normal
+ * @property {NFeEndereco} endereco
+ */
+
+/**
+ * @typedef {Object} NFeDestinatario
+ * @property {string} [cnpj]
+ * @property {string} [cpf]
+ * @property {string} razaoSocial
+ * @property {string} [ie]
+ * @property {number} [indIEDest] 1=Contribuinte, 2=Isento, 9=Não contribuinte
+ * @property {NFeEndereco} endereco
+ */
+
+/**
+ * @typedef {Object} NFeItem
+ * @property {string} codigo
+ * @property {string} descricao
+ * @property {string} ncm
+ * @property {string} cfop
+ * @property {string} unidade
+ * @property {number} quantidade
+ * @property {number} valorUnitario
+ * @property {number} valorTotal
+ * @property {string} [ean]
+ * @property {string} [cst] CST ICMS (ex: "00")
+ * @property {number} [aliquotaIcms]
+ * @property {number} [valorIcms]
+ * @property {import('../../reforma/ibscbs.js').TributacaoRTC} [reforma] IBS/CBS (PL_010)
+ */
+
+/**
+ * @typedef {Object} NFeFrete
+ * @property {number} modalidade 0=Emitente, 1=Destinatário, 9=Sem frete
+ * @property {number} [valor]
+ * @property {string} [transportadora]
+ * @property {string} [cnpjTransportadora]
+ */
+
+/**
+ * @typedef {Object} NFePagamento
+ * @property {string} forma 01=Dinheiro, 03=Cartão crédito, etc.
+ * @property {number} valor
+ */
+
+/**
+ * @typedef {Object} NFeIde
+ * @property {string} uf Sigla UF (ex: "SP")
+ * @property {string} codigoMunicipio IBGE
+ * @property {number} [serie]
+ * @property {number} numero
+ * @property {number} [tipoEmissao] 1=Normal
+ * @property {number} [finalidade] 1=Normal
+ * @property {number} [consumidorFinal] 0=Não, 1=Sim
+ * @property {number} [presenca] 1=Presencial
+ * @property {number} [naturezaOperacao]
+ */
+
+/**
+ * @typedef {Object} NFeDocumento
+ * @property {string} [chaveAcesso] 44 dígitos — gerada automaticamente se omitida
+ * @property {number} [ambiente] 1=Produção, 2=Homologação
+ * @property {boolean} [reformaTributaria] força totais IBS/CBS mesmo sem item.reforma
+ * @property {NFeIde} ide
+ * @property {NFeEmitente} emitente
+ * @property {NFeDestinatario} destinatario
+ * @property {NFeItem[]} itens
+ * @property {NFeFrete} [frete]
+ * @property {NFePagamento[]} [pagamentos]
+ * @property {string} [informacoesComplementares]
+ */
+
+export {};

package/src/nfe/types/NFeEvento.js

@@ -1,44 +1,44 @@
-/** Tipos de evento NF-e conforme tabela SEFAZ. */
-export const NFE_EVENTOS = {
-  CARTA_CORRECAO: '110110',
-  CANCELAMENTO: '110111',
-  CIENCIA_OPERACAO: '210210',
-  CONFIRMACAO_OPERACAO: '210200',
-  DESCONHECIMENTO_OPERACAO: '210220',
-  OPERACAO_NAO_REALIZADA: '210240',
-};
-
-/** Texto fixo exigido na CC-e. */
-export const CCE_COND_USO =
-  'A Carta de Correcao e disciplinada pelo paragrafo 1o-A do art. 7o do Convenio S/N, ' +
-  'de 15 de dezembro de 1970 e pode ser utilizada para regularizacao de erro ocorrido ' +
-  'na emissao de documento fiscal, desde que o erro nao esteja relacionado com: ' +
-  'I - as variaveis que determinam o valor do imposto tais como: base de calculo, ' +
-  'aliquota, diferenca de preco, quantidade, valor da operacao ou da prestacao; ' +
-  'II - a correcao de dados cadastrais que implique mudanca do remetente ou do destinatario; ' +
-  'III - a data de emissao ou de saida.';
-
-/**
- * @typedef {Object} NFeEventoBase
- * @property {string} chaveAcesso Chave da NF-e (44 dígitos)
- * @property {string} cnpj CNPJ do autor do evento
- * @property {string} uf Sigla UF
- * @property {number} [ambiente] 1=Produção, 2=Homologação
- * @property {number} [sequencia] nSeqEvento (default 1)
- * @property {string} [idLote] ID do lote de eventos
- */
-
-/**
- * @typedef {NFeEventoBase & {
- *   protocolo: string,
- *   justificativa: string,
- * }} NFeCancelamento
- */
-
-/**
- * @typedef {NFeEventoBase & {
- *   correcao: string,
- * }} NFeCartaCorrecao
- */
-
-export {};
+/** Tipos de evento NF-e conforme tabela SEFAZ. */
+export const NFE_EVENTOS = {
+  CARTA_CORRECAO: '110110',
+  CANCELAMENTO: '110111',
+  CIENCIA_OPERACAO: '210210',
+  CONFIRMACAO_OPERACAO: '210200',
+  DESCONHECIMENTO_OPERACAO: '210220',
+  OPERACAO_NAO_REALIZADA: '210240',
+};
+
+/** Texto fixo exigido na CC-e. */
+export const CCE_COND_USO =
+  'A Carta de Correcao e disciplinada pelo paragrafo 1o-A do art. 7o do Convenio S/N, ' +
+  'de 15 de dezembro de 1970 e pode ser utilizada para regularizacao de erro ocorrido ' +
+  'na emissao de documento fiscal, desde que o erro nao esteja relacionado com: ' +
+  'I - as variaveis que determinam o valor do imposto tais como: base de calculo, ' +
+  'aliquota, diferenca de preco, quantidade, valor da operacao ou da prestacao; ' +
+  'II - a correcao de dados cadastrais que implique mudanca do remetente ou do destinatario; ' +
+  'III - a data de emissao ou de saida.';
+
+/**
+ * @typedef {Object} NFeEventoBase
+ * @property {string} chaveAcesso Chave da NF-e (44 dígitos)
+ * @property {string} cnpj CNPJ do autor do evento
+ * @property {string} uf Sigla UF
+ * @property {number} [ambiente] 1=Produção, 2=Homologação
+ * @property {number} [sequencia] nSeqEvento (default 1)
+ * @property {string} [idLote] ID do lote de eventos
+ */
+
+/**
+ * @typedef {NFeEventoBase & {
+ *   protocolo: string,
+ *   justificativa: string,
+ * }} NFeCancelamento
+ */
+
+/**
+ * @typedef {NFeEventoBase & {
+ *   correcao: string,
+ * }} NFeCartaCorrecao
+ */
+
+export {};

package/src/nfse/NFSeMunicipioResolver.js

@@ -1,42 +1,42 @@
-import { NFSE_MUNICIPIOS } from './constants/municipios.js';
-import { GhinfeError } from '../errors/GhinfeError.js';
-
-/**
- * Resolve endpoint NFS-e por código IBGE do município.
- */
-export class NFSeMunicipioResolver {
-  /** @type {Record<string, object>} */
-  static #custom = {};
-
-  /**
-   * Registra endpoint customizado para um município.
-   * @param {string} codigoMunicipio IBGE 7 dígitos
-   * @param {{ nome?: string, homologacao: string, producao: string, layout?: string }} config
-   */
-  static registrar(codigoMunicipio, config) {
-    this.#custom[codigoMunicipio] = config;
-  }
-
-  /**
-   * @param {string} codigoMunicipio
-   * @param {number} [ambiente] 1=Produção, 2=Homologação
-   */
-  static resolver(codigoMunicipio, ambiente = 2) {
-    const config = this.#custom[codigoMunicipio] ?? NFSE_MUNICIPIOS[codigoMunicipio];
-
-    if (!config) {
-      throw new GhinfeError(
-        `Endpoint NFS-e não configurado para município ${codigoMunicipio}. Use NFSeMunicipioResolver.registrar()`,
-        'NFSE_MUNICIPIO_NOT_FOUND'
-      );
-    }
-
-    const url = ambiente === 1 ? config.producao : config.homologacao;
-    return { url, layout: config.layout ?? 'abrasf', nome: config.nome };
-  }
-
-  /** @returns {string[]} */
-  static listarMunicipios() {
-    return [...new Set([...Object.keys(NFSE_MUNICIPIOS), ...Object.keys(this.#custom)])];
-  }
-}
+import { NFSE_MUNICIPIOS } from './constants/municipios.js';
+import { GhinfeError } from '../errors/GhinfeError.js';
+
+/**
+ * Resolve endpoint NFS-e por código IBGE do município.
+ */
+export class NFSeMunicipioResolver {
+  /** @type {Record<string, object>} */
+  static #custom = {};
+
+  /**
+   * Registra endpoint customizado para um município.
+   * @param {string} codigoMunicipio IBGE 7 dígitos
+   * @param {{ nome?: string, homologacao: string, producao: string, layout?: string }} config
+   */
+  static registrar(codigoMunicipio, config) {
+    this.#custom[codigoMunicipio] = config;
+  }
+
+  /**
+   * @param {string} codigoMunicipio
+   * @param {number} [ambiente] 1=Produção, 2=Homologação
+   */
+  static resolver(codigoMunicipio, ambiente = 2) {
+    const config = this.#custom[codigoMunicipio] ?? NFSE_MUNICIPIOS[codigoMunicipio];
+
+    if (!config) {
+      throw new GhinfeError(
+        `Endpoint NFS-e não configurado para município ${codigoMunicipio}. Use NFSeMunicipioResolver.registrar()`,
+        'NFSE_MUNICIPIO_NOT_FOUND'
+      );
+    }
+
+    const url = ambiente === 1 ? config.producao : config.homologacao;
+    return { url, layout: config.layout ?? 'abrasf', nome: config.nome };
+  }
+
+  /** @returns {string[]} */
+  static listarMunicipios() {
+    return [...new Set([...Object.keys(NFSE_MUNICIPIOS), ...Object.keys(this.#custom)])];
+  }
+}