@useinvio/nfse-sdk 0.2.0

package/dist/fiscalValidation.js

@@ -0,0 +1,218 @@
+const OP_SIMP_NAC = new Set(['1', '2', '3']);
+const REG_AP_TRIB_SN = new Set(['1', '2', '3']);
+const REG_ESP_TRIB = new Set(['0', '1', '2', '3', '4', '5', '6', '9']);
+const TRIB_ISSQN = new Set(['1', '2', '3', '4']);
+const TP_IMUNIDADE = new Set(['0', '1', '2', '3', '4', '5']);
+const TP_RET_ISSQN = new Set(['1', '2', '3']);
+const PIS_COFINS_CST = new Set([
+    '00',
+    '01',
+    '02',
+    '03',
+    '04',
+    '05',
+    '06',
+    '07',
+    '08',
+    '09',
+    '49',
+    '50',
+    '51',
+    '52',
+    '53',
+    '54',
+    '55',
+    '56',
+    '60',
+    '61',
+    '62',
+    '63',
+    '64',
+    '65',
+    '66',
+    '67',
+    '70',
+    '71',
+    '72',
+    '73',
+    '74',
+    '75',
+    '98',
+    '99',
+]);
+export class DpsFiscalValidationError extends Error {
+    issues;
+    constructor(issues) {
+        super(`JSON da DPS invalido: ${issues.join('; ')}`);
+        this.issues = issues;
+        this.name = 'DpsFiscalValidationError';
+    }
+}
+function issue(issues, message) {
+    issues.push(message);
+}
+function assertPattern(issues, field, value, pattern, example) {
+    if (value === undefined || value === '') {
+        issue(issues, `${field} e obrigatorio`);
+        return;
+    }
+    if (!pattern.test(value)) {
+        issue(issues, `${field} deve seguir ${example}`);
+    }
+}
+function assertEnum(issues, field, value, allowed) {
+    if (value === undefined || value === '') {
+        issue(issues, `${field} e obrigatorio`);
+        return;
+    }
+    if (!allowed.has(value)) {
+        issue(issues, `${field} deve ser um de: ${Array.from(allowed).join(', ')}`);
+    }
+}
+function assertDecimal(issues, field, value) {
+    if (value === undefined || value === '')
+        return;
+    if (!Number.isFinite(Number(value))) {
+        issue(issues, `${field} deve ser numerico`);
+    }
+}
+function validatePrestador(issues, prestador) {
+    assertPattern(issues, 'prestador.cnpj', prestador.cnpj, /^\d{14}$/, '14 digitos numericos');
+    assertPattern(issues, 'prestador.cLocEmi', prestador.cLocEmi, /^\d{7}$/, 'codigo IBGE com 7 digitos');
+    assertPattern(issues, 'prestador.serie', prestador.serie, /^\d{1,5}$/, 'serie numerica com ate 5 digitos');
+    assertEnum(issues, 'prestador.opSimpNac', prestador.opSimpNac, OP_SIMP_NAC);
+    assertEnum(issues, 'prestador.regEspTrib', prestador.regEspTrib, REG_ESP_TRIB);
+    if (prestador.regApTribSN !== undefined) {
+        assertEnum(issues, 'prestador.regApTribSN', prestador.regApTribSN, REG_AP_TRIB_SN);
+        if (prestador.opSimpNac !== '3') {
+            issue(issues, 'prestador.regApTribSN so deve ser informado quando prestador.opSimpNac = 3');
+        }
+    }
+}
+function validateServico(issues, servico, emissao) {
+    assertPattern(issues, 'servico.cTribNac', servico.cTribNac, /^\d{6}$/, '6 digitos numericos');
+    assertPattern(issues, 'servico.cLocPrestacao', emissao.servico?.cLocPrestacao ?? servico.cLocPrestacao, /^\d{7}$/, 'codigo IBGE com 7 digitos');
+    const cNBS = emissao.servico?.cNBS ?? servico.cNBS;
+    if (cNBS !== undefined) {
+        assertPattern(issues, 'servico.cNBS', cNBS, /^\d{9}$/, '9 digitos numericos');
+    }
+}
+function validatePessoa(issues, field, pessoa) {
+    if (!pessoa)
+        return;
+    const ids = [pessoa.CNPJ, pessoa.CPF, pessoa.NIF, pessoa.cNaoNIF].filter((value) => value !== undefined && value !== '');
+    if (ids.length !== 1) {
+        issue(issues, `${field} deve informar exatamente um identificador: CNPJ, CPF, NIF ou cNaoNIF`);
+    }
+    if (!pessoa.xNome) {
+        issue(issues, `${field}.xNome e obrigatorio quando ${field} for informado`);
+    }
+}
+function validateTribMun(issues, trib, opSimpNac) {
+    if (!trib) {
+        issue(issues, 'emissao.tributacaoMunicipal e obrigatorio; a SDK nao assume tribISSQN/tpRetISSQN por default');
+        return;
+    }
+    assertEnum(issues, 'emissao.tributacaoMunicipal.tribISSQN', trib.tribISSQN, TRIB_ISSQN);
+    assertEnum(issues, 'emissao.tributacaoMunicipal.tpRetISSQN', trib.tpRetISSQN, TP_RET_ISSQN);
+    if (trib.tribISSQN === '2') {
+        assertEnum(issues, 'emissao.tributacaoMunicipal.tpImunidade', trib.tpImunidade, TP_IMUNIDADE);
+    }
+    else if (trib.tpImunidade !== undefined) {
+        issue(issues, 'emissao.tributacaoMunicipal.tpImunidade so deve ser informado quando tribISSQN = 2');
+    }
+    if (trib.tribISSQN === '3') {
+        assertPattern(issues, 'emissao.tributacaoMunicipal.cPaisResult', trib.cPaisResult, /^[A-Z]{2}$/, 'ISO-3166 alpha-2');
+    }
+    else if (trib.cPaisResult !== undefined) {
+        issue(issues, 'emissao.tributacaoMunicipal.cPaisResult so deve ser informado quando tribISSQN = 3');
+    }
+    if (opSimpNac === '1' && trib.pAliq !== undefined) {
+        issue(issues, 'emissao.tributacaoMunicipal.pAliq nao deve ser informado quando prestador.opSimpNac = 1');
+    }
+    assertDecimal(issues, 'emissao.tributacaoMunicipal.vBC', trib.vBC);
+    assertDecimal(issues, 'emissao.tributacaoMunicipal.pAliq', trib.pAliq);
+    assertDecimal(issues, 'emissao.tributacaoMunicipal.vISSQN', trib.vISSQN);
+}
+function validateTotTrib(issues, emissao, opSimpNac) {
+    const tot = emissao.totTrib;
+    if (!tot) {
+        issue(issues, 'emissao.totTrib e obrigatorio; a SDK nao preenche carga tributaria aproximada por default');
+        return;
+    }
+    const hasExplicitValue = tot.vTotTrib !== undefined ||
+        tot.pTotTribFed !== undefined ||
+        tot.pTotTribEst !== undefined ||
+        tot.pTotTribMun !== undefined ||
+        tot.pTotTribSN !== undefined ||
+        tot.indTotTrib !== undefined;
+    if (!hasExplicitValue) {
+        issue(issues, 'emissao.totTrib deve informar vTotTrib, pTotTrib*, pTotTribSN ou indTotTrib');
+    }
+    if (opSimpNac === '1' && (tot.pTotTribSN !== undefined || tot.indTotTrib !== undefined)) {
+        issue(issues, 'emissao.totTrib.pTotTribSN/indTotTrib nao devem ser informados para prestador.opSimpNac = 1');
+    }
+    assertDecimal(issues, 'emissao.totTrib.vTotTrib', tot.vTotTrib);
+    assertDecimal(issues, 'emissao.totTrib.pTotTribFed', tot.pTotTribFed);
+    assertDecimal(issues, 'emissao.totTrib.pTotTribEst', tot.pTotTribEst);
+    assertDecimal(issues, 'emissao.totTrib.pTotTribMun', tot.pTotTribMun);
+    assertDecimal(issues, 'emissao.totTrib.pTotTribSN', tot.pTotTribSN);
+}
+function validateUnsupportedShapes(issues, emissao) {
+    if (emissao.tribNac) {
+        issue(issues, 'emissao.tribNac ainda nao e suportado; IBS/CBS no layout v1.01 exige o bloco RTC IBSCBS oficial');
+    }
+    if (emissao.evento) {
+        issue(issues, 'emissao.evento ainda nao e suportado; o layout v1.01 exige xNome, dtIni, dtFim e id/endereco');
+    }
+    if (emissao.obra?.cCM) {
+        issue(issues, 'emissao.obra.cCM nao existe no layout v1.01; use cObra/inscImobFisc ou aguarde suporte a cCIB/endereco');
+    }
+    if (emissao.valores?.vDesc !== undefined || emissao.valores?.vDedRed !== undefined) {
+        issue(issues, 'emissao.valores.vDesc/vDedRed ainda nao sao suportados no shape correto do layout v1.01');
+    }
+}
+function validateComercioExterior(issues, emissao) {
+    const comExt = emissao.comercioExterior ?? emissao.comExt;
+    if (!comExt)
+        return;
+    for (const field of ['mdPrestacao', 'vincPrest', 'tpMoeda', 'mecAFComexP', 'mecAFComexT', 'movTempBens', 'mdic']) {
+        if (!comExt[field])
+            issue(issues, `emissao.comercioExterior.${field} e obrigatorio quando comercioExterior for informado`);
+    }
+    assertDecimal(issues, 'emissao.comercioExterior.vServMoeda', comExt.vServMoeda ?? emissao.valores?.vServMoeda ?? emissao.vServMoeda);
+}
+function validateTribFed(issues, emissao) {
+    const piscofins = emissao.tributacaoFederal?.piscofins;
+    if (!piscofins)
+        return;
+    assertEnum(issues, 'emissao.tributacaoFederal.piscofins.CST', piscofins.CST, PIS_COFINS_CST);
+    assertDecimal(issues, 'emissao.tributacaoFederal.piscofins.vBCPisCofins', piscofins.vBCPisCofins);
+    assertDecimal(issues, 'emissao.tributacaoFederal.piscofins.pAliqPis', piscofins.pAliqPis);
+    assertDecimal(issues, 'emissao.tributacaoFederal.piscofins.pAliqCofins', piscofins.pAliqCofins);
+    assertDecimal(issues, 'emissao.tributacaoFederal.piscofins.vPis', piscofins.vPis);
+    assertDecimal(issues, 'emissao.tributacaoFederal.piscofins.vCofins', piscofins.vCofins);
+}
+export function validateDpsJsonRequest(request) {
+    const issues = [];
+    validatePrestador(issues, request.prestador);
+    validateServico(issues, request.servico, request.emissao);
+    assertPattern(issues, 'emissao.nDPS', request.emissao.nDPS, /^[1-9][0-9]{0,14}$/, '1 a 15 digitos, sem zero inicial');
+    if (request.emissao.serie !== undefined) {
+        assertPattern(issues, 'emissao.serie', request.emissao.serie, /^\d{1,5}$/, 'serie numerica com ate 5 digitos');
+    }
+    assertDecimal(issues, 'emissao.valores.vServ', request.emissao.valores?.vServ ?? request.emissao.vServ);
+    assertDecimal(issues, 'emissao.valores.vServMoeda', request.emissao.valores?.vServMoeda ?? request.emissao.vServMoeda);
+    assertDecimal(issues, 'emissao.valores.cotacao', request.emissao.valores?.cotacao ?? request.emissao.cotacao);
+    validatePessoa(issues, 'emissao.tomador', request.emissao.tomador);
+    validatePessoa(issues, 'emissao.intermediario', request.emissao.intermediario);
+    validateTribMun(issues, request.emissao.tributacaoMunicipal, request.prestador.opSimpNac);
+    validateTribFed(issues, request.emissao);
+    validateTotTrib(issues, request.emissao, request.prestador.opSimpNac);
+    validateComercioExterior(issues, request.emissao);
+    validateUnsupportedShapes(issues, request.emissao);
+    if (issues.length > 0) {
+        throw new DpsFiscalValidationError(issues);
+    }
+}
+//# sourceMappingURL=fiscalValidation.js.map

package/dist/fiscalValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fiscalValidation.js","sourceRoot":"","sources":["../fiscalValidation.ts"],"names":[],"mappings":"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"}

package/dist/gzipB64.d.ts

@@ -0,0 +1,4 @@
+/** Compacta (GZip) e codifica em Base64 — formato exigido por dpsXmlGZipB64. */
+export declare function gzipBase64(xml: string): string;
+/** Inverso: decodifica Base64 e descompacta GZip (resposta nfseXmlGZipB64). */
+export declare function gunzipBase64(b64: string): string;

package/dist/gzipB64.js

@@ -0,0 +1,10 @@
+import { gzipSync, gunzipSync } from 'node:zlib';
+/** Compacta (GZip) e codifica em Base64 — formato exigido por dpsXmlGZipB64. */
+export function gzipBase64(xml) {
+    return gzipSync(Buffer.from(xml, 'utf-8')).toString('base64');
+}
+/** Inverso: decodifica Base64 e descompacta GZip (resposta nfseXmlGZipB64). */
+export function gunzipBase64(b64) {
+    return gunzipSync(Buffer.from(b64, 'base64')).toString('utf-8');
+}
+//# sourceMappingURL=gzipB64.js.map

package/dist/gzipB64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gzipB64.js","sourceRoot":"","sources":["../gzipB64.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEjD,gFAAgF;AAChF,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAChE,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAClE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * NFS-e Nacional SDK.
+ *
+ * Handles the protocol layer only: mTLS, signing, gzip/base64, send, consult, events.
+ * No database, no tenants, no business rules.
+ */
+export { SEFIN_BASE_URL, TP_AMB, DEFAULT_AMBIENTE, resolveSefinBaseUrl } from './config.js';
+export type { Ambiente } from './config.js';
+export { consultarNfse, enviarEvento, extrairErros } from './sefinClient.js';
+export type { SefinErro, SefinResposta } from './sefinClient.js';
+export { buildDpsFromJson, buildDpsId } from './dpsJson.js';
+export type { BuiltDps, ComExt, DpsJsonInput, DpsJsonRequest, EventoServico, Intermediario, Obra, PrestadorProfile, ServicoProfile, Tomador, TotTrib, TribFed, TribMun, TribNac, Valores, } from './dpsJson.js';
+export { DpsFiscalValidationError, validateDpsJsonRequest } from './fiscalValidation.js';
+export { EmitirNotaError, emitirNfse } from './emissaoNota.js';
+export type { EmitirNotaOptions, NotaInput, ResultadoEmissaoNota } from './emissaoNota.js';
+export { NfseClient } from './client.js';
+export type { CreateInvoiceInput, InvoiceResource, NfseCertificateInput, NfseClientDpsDefaults, NfseClientOptions, NfseEnvironment, } from './client.js';
+export { gzipBase64, gunzipBase64 } from './gzipB64.js';
+export { signDps, signEnveloped, verifyDps, withUtf8XmlDeclaration } from './signXml.js';
+export { loadPfxFromBuffer, loadPfx } from './loadPfx.js';
+export type { PfxMaterial } from './loadPfx.js';

package/dist/index.js

@@ -0,0 +1,16 @@
+/**
+ * NFS-e Nacional SDK.
+ *
+ * Handles the protocol layer only: mTLS, signing, gzip/base64, send, consult, events.
+ * No database, no tenants, no business rules.
+ */
+export { SEFIN_BASE_URL, TP_AMB, DEFAULT_AMBIENTE, resolveSefinBaseUrl } from './config.js';
+export { consultarNfse, enviarEvento, extrairErros } from './sefinClient.js';
+export { buildDpsFromJson, buildDpsId } from './dpsJson.js';
+export { DpsFiscalValidationError, validateDpsJsonRequest } from './fiscalValidation.js';
+export { EmitirNotaError, emitirNfse } from './emissaoNota.js';
+export { NfseClient } from './client.js';
+export { gzipBase64, gunzipBase64 } from './gzipB64.js';
+export { signDps, signEnveloped, verifyDps, withUtf8XmlDeclaration } from './signXml.js';
+export { loadPfxFromBuffer, loadPfx } from './loadPfx.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAG5F,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAG7E,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAmB5D,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEzF,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG/D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAUzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEzF,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/loadPfx.d.ts

@@ -0,0 +1,18 @@
+export interface PfxMaterial {
+    /** Chave privada em PEM (PKCS#8/PKCS#1) */
+    privateKeyPem: string;
+    /** Certificado do titular em PEM */
+    certPem: string;
+    /** Certificado em DER base64 (sem cabeçalhos PEM), p/ <X509Certificate> */
+    certDerBase64: string;
+    /** Buffer bruto do .pfx, para uso no handshake mTLS */
+    pfxBuffer: Buffer;
+}
+/**
+ * Lê um certificado ICP-Brasil A1 (.pfx/PKCS#12) e extrai a chave privada e o
+ * certificado do titular. Usado tanto para a assinatura XMLDSIG quanto para o
+ * mTLS (via pfxBuffer).
+ */
+/** Load from an in-memory buffer (used for decrypted certs in multi-tenant flow). */
+export declare function loadPfxFromBuffer(pfxBuffer: Buffer, password: string): PfxMaterial;
+export declare function loadPfx(pfxPath: string, password: string): PfxMaterial;

package/dist/loadPfx.js

@@ -0,0 +1,41 @@
+import { readFileSync } from 'node:fs';
+import forge from 'node-forge';
+/**
+ * Lê um certificado ICP-Brasil A1 (.pfx/PKCS#12) e extrai a chave privada e o
+ * certificado do titular. Usado tanto para a assinatura XMLDSIG quanto para o
+ * mTLS (via pfxBuffer).
+ */
+/** Load from an in-memory buffer (used for decrypted certs in multi-tenant flow). */
+export function loadPfxFromBuffer(pfxBuffer, password) {
+    return parsePfx(pfxBuffer, password);
+}
+export function loadPfx(pfxPath, password) {
+    const pfxBuffer = readFileSync(pfxPath);
+    return parsePfx(pfxBuffer, password);
+}
+function parsePfx(pfxBuffer, password) {
+    const p12Der = forge.util.createBuffer(pfxBuffer.toString('binary'));
+    const p12Asn1 = forge.asn1.fromDer(p12Der);
+    const p12 = forge.pkcs12.pkcs12FromAsn1(p12Asn1, password);
+    // Chave privada
+    const keyBags = p12.getBags({ bagType: forge.pki.oids.pkcs8ShroudedKeyBag });
+    const keyBag = keyBags[forge.pki.oids.pkcs8ShroudedKeyBag]?.[0];
+    if (!keyBag?.key)
+        throw new Error('Chave privada não encontrada no .pfx (senha incorreta?)');
+    const privateKeyPem = forge.pki.privateKeyToPem(keyBag.key);
+    // Certificado do titular: o que casa com a chave (não-CA, com o CNPJ)
+    const certBags = p12.getBags({ bagType: forge.pki.oids.certBag });
+    const certs = certBags[forge.pki.oids.certBag] ?? [];
+    const isCa = (b) => {
+        const ext = b.cert?.getExtension('basicConstraints');
+        return ext?.cA === true;
+    };
+    const holder = certs.find((b) => b.cert && !isCa(b)) ?? certs[0];
+    if (!holder?.cert)
+        throw new Error('Certificado do titular não encontrado no .pfx');
+    const certPem = forge.pki.certificateToPem(holder.cert);
+    const certDer = forge.asn1.toDer(forge.pki.certificateToAsn1(holder.cert)).getBytes();
+    const certDerBase64 = forge.util.encode64(certDer);
+    return { privateKeyPem, certPem, certDerBase64, pfxBuffer };
+}
+//# sourceMappingURL=loadPfx.js.map

package/dist/loadPfx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadPfx.js","sourceRoot":"","sources":["../loadPfx.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,MAAM,YAAY,CAAC;AAa/B;;;;GAIG;AACH,qFAAqF;AACrF,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,QAAgB;IACnE,OAAO,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe,EAAE,QAAgB;IACvD,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,QAAQ,CAAC,SAAiB,EAAE,QAAgB;IACnD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAE3D,gBAAgB;IAChB,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM,EAAE,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7F,MAAM,aAAa,GAAG,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAE5D,sEAAsE;IACtE,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACrD,MAAM,IAAI,GAAG,CAAC,CAAmB,EAAW,EAAE;QAC5C,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,YAAY,CAAC,kBAAkB,CAAiC,CAAC;QACrF,OAAO,GAAG,EAAE,EAAE,KAAK,IAAI,CAAC;IAC1B,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;IACjE,IAAI,CAAC,MAAM,EAAE,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAEpF,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACtF,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAEnD,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;AAC9D,CAAC"}

package/dist/sefinClient.d.ts

@@ -0,0 +1,20 @@
+import type { PfxMaterial } from './loadPfx.js';
+import type { Ambiente } from './config.js';
+export interface SefinErro {
+    Codigo: string;
+    Descricao: string;
+    Complemento?: string;
+}
+export interface SefinResposta {
+    status: number;
+    /** Corpo bruto parseado (JSON) */
+    body: any;
+}
+/** Normaliza a lista de erros retornada pelo SEFIN em diferentes formatos. */
+export declare function extrairErros(body: any): SefinErro[];
+/** SefinNacional · POST /nfse — transporte baixo nivel de DPS ja compactada em GZip+Base64. */
+export declare function transmitirDpsCompactada(dpsXmlGZipB64: string, pfx: PfxMaterial, ambiente?: Ambiente): Promise<SefinResposta>;
+/** SefinNacional · GET /nfse/{chave} — consulta a NFS-e pela chave de acesso (50 dígitos). */
+export declare function consultarNfse(chave: string, pfx: PfxMaterial, ambiente?: Ambiente): Promise<SefinResposta>;
+/** SefinNacional · POST /nfse/{chave}/eventos — registra evento fiscal da NFS-e. */
+export declare function enviarEvento(pedRegXmlGZipB64: string, pfx: PfxMaterial, chaveAcesso: string, ambiente?: Ambiente): Promise<SefinResposta>;

package/dist/sefinClient.js

@@ -0,0 +1,117 @@
+import https from 'node:https';
+import { resolveSefinBaseUrl } from './config.js';
+/**
+ * Requisição mTLS de baixo nível ao SefinNacional, retornando o corpo bruto (Buffer).
+ * Usa key+cert PEM no handshake (o .pfx legado ICP-Brasil é rejeitado pelo TLS do Node).
+ */
+function sefinRequest(opts, pfx, baseOverride) {
+    const url = new URL(`${baseOverride ?? resolveSefinBaseUrl()}${opts.path}`);
+    const payload = opts.jsonBody != null ? JSON.stringify(opts.jsonBody) : undefined;
+    const headers = {
+        Accept: 'application/json',
+    };
+    if (payload != null) {
+        headers['Content-Type'] = 'application/json';
+        headers['Content-Length'] = Buffer.byteLength(payload);
+    }
+    const options = {
+        method: opts.method,
+        hostname: url.hostname,
+        port: url.port || 443,
+        path: url.pathname + url.search,
+        headers,
+        key: pfx.privateKeyPem,
+        cert: pfx.certPem,
+        rejectUnauthorized: true,
+    };
+    return new Promise((resolve, reject) => {
+        const req = https.request(options, (res) => {
+            const chunks = [];
+            res.on('data', (c) => chunks.push(c));
+            res.on('end', () => resolve({
+                status: res.statusCode ?? 0,
+                contentType: String(res.headers['content-type'] ?? ''),
+                buffer: Buffer.concat(chunks),
+            }));
+        });
+        req.on('error', reject);
+        if (payload != null)
+            req.write(payload);
+        req.end();
+    });
+}
+/** Parseia o corpo como JSON; mantém texto cru se não for JSON (ex.: 403 HTML). */
+function parseJson(raw) {
+    const text = raw.buffer.toString('utf-8');
+    try {
+        return { status: raw.status, body: text ? JSON.parse(text) : null };
+    }
+    catch {
+        return { status: raw.status, body: text };
+    }
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function normalizeErro(value) {
+    const erro = {
+        Codigo: String(value.Codigo ?? value.codigo ?? value.code ?? 'DESCONHECIDO'),
+        Descricao: String(value.Descricao ?? value.descricao ?? value.mensagem ?? value.message ?? ''),
+    };
+    const complemento = value.Complemento ?? value.complemento;
+    if (complemento != null)
+        erro.Complemento = String(complemento);
+    return erro;
+}
+function isSefinSuccessBody(body) {
+    return (body.sucesso === true ||
+        typeof body.chaveAcesso === 'string' ||
+        typeof body.nfseXmlGZipB64 === 'string' ||
+        typeof body.idDps === 'string');
+}
+/** Normaliza a lista de erros retornada pelo SEFIN em diferentes formatos. */
+export function extrairErros(body) {
+    if (!body)
+        return [];
+    if (Array.isArray(body))
+        return body.map(normalizeErro);
+    if (!isRecord(body)) {
+        return [{ Codigo: 'DESCONHECIDO', Descricao: String(body) }];
+    }
+    if (isSefinSuccessBody(body))
+        return [];
+    if (Array.isArray(body.erros))
+        return body.erros.map(normalizeErro);
+    if (Array.isArray(body.Erros))
+        return body.Erros.map(normalizeErro);
+    if (Array.isArray(body.erro))
+        return body.erro.map(normalizeErro);
+    if (Array.isArray(body.Erro))
+        return body.Erro.map(normalizeErro);
+    if (body.Codigo || body.codigo) {
+        return [normalizeErro(body)];
+    }
+    return [
+        { Codigo: 'DESCONHECIDO', Descricao: JSON.stringify(body) },
+    ];
+}
+/** SefinNacional · POST /nfse — transporte baixo nivel de DPS ja compactada em GZip+Base64. */
+export async function transmitirDpsCompactada(dpsXmlGZipB64, pfx, ambiente) {
+    const base = ambiente ? resolveSefinBaseUrl(ambiente) : undefined;
+    return parseJson(await sefinRequest({ method: 'POST', path: '/nfse', jsonBody: { dpsXmlGZipB64 } }, pfx, base));
+}
+/** SefinNacional · GET /nfse/{chave} — consulta a NFS-e pela chave de acesso (50 dígitos). */
+export async function consultarNfse(chave, pfx, ambiente) {
+    const base = ambiente ? resolveSefinBaseUrl(ambiente) : undefined;
+    return parseJson(await sefinRequest({ method: 'GET', path: `/nfse/${chave}` }, pfx, base));
+}
+/** SefinNacional · POST /nfse/{chave}/eventos — registra evento fiscal da NFS-e. */
+export async function enviarEvento(pedRegXmlGZipB64, pfx, chaveAcesso, ambiente) {
+    const base = ambiente ? resolveSefinBaseUrl(ambiente) : undefined;
+    return parseJson(await sefinRequest({
+        method: 'POST',
+        path: `/nfse/${chaveAcesso}/eventos`,
+        jsonBody: { pedRegXmlGZipB64 },
+    }, pfx, base));
+}
+//# sourceMappingURL=sefinClient.js.map

package/dist/sefinClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sefinClient.js","sourceRoot":"","sources":["../sefinClient.ts"],"names":[],"mappings":"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"}

package/dist/signXml.d.ts

@@ -0,0 +1,13 @@
+import type { PfxMaterial } from './loadPfx.js';
+/** Garante declaracao XML UTF-8 antes de compactar/enviar para a SEFIN. */
+export declare function withUtf8XmlDeclaration(xml: string): string;
+/**
+ * Assina (XMLDSIG enveloped) o elemento de nome local `localName`, referenciando
+ * seu Id (URI="#<id>"). A <Signature> é inserida como irmã desse elemento.
+ * Usado para infDPS (emissão) e infPedReg (eventos/cancelamento).
+ */
+export declare function signEnveloped(xml: string, refId: string, localName: string, pfx: PfxMaterial): string;
+/** Assina a DPS (referência em infDPS). */
+export declare function signDps(xml: string, dpsId: string, pfx: PfxMaterial): string;
+/** Valida uma DPS assinada usando o certificado fornecido. Útil em testes. */
+export declare function verifyDps(signedXml: string, certPem: string): boolean;

package/dist/signXml.js

@@ -0,0 +1,52 @@
+import { SignedXml } from 'xml-crypto';
+import { DOMParser } from '@xmldom/xmldom';
+// Algoritmos observados nas NFS-e reais do Sistema Nacional.
+// Centralizados aqui para troca fácil caso o ambiente exija variantes.
+const SIGNATURE_ALGORITHM = 'http://www.w3.org/2001/04/xmldsig-more#rsa-sha256';
+const DIGEST_ALGORITHM = 'http://www.w3.org/2001/04/xmlenc#sha256';
+const CANON_ALGORITHM = 'http://www.w3.org/2001/10/xml-exc-c14n#WithComments';
+const ENVELOPED = 'http://www.w3.org/2000/09/xmldsig#enveloped-signature';
+/** Garante declaracao XML UTF-8 antes de compactar/enviar para a SEFIN. */
+export function withUtf8XmlDeclaration(xml) {
+    const xmlWithoutDeclaration = xml.replace(/^\uFEFF?\s*<\?xml[^?]*\?>\s*/i, '');
+    return `<?xml version="1.0" encoding="UTF-8"?>${xmlWithoutDeclaration}`;
+}
+/**
+ * Assina (XMLDSIG enveloped) o elemento de nome local `localName`, referenciando
+ * seu Id (URI="#<id>"). A <Signature> é inserida como irmã desse elemento.
+ * Usado para infDPS (emissão) e infPedReg (eventos/cancelamento).
+ */
+export function signEnveloped(xml, refId, localName, pfx) {
+    const xpath = `//*[local-name(.)='${localName}']`;
+    const sig = new SignedXml({
+        privateKey: pfx.privateKeyPem,
+        publicCert: pfx.certPem,
+        signatureAlgorithm: SIGNATURE_ALGORITHM,
+        canonicalizationAlgorithm: CANON_ALGORITHM,
+    });
+    sig.addReference({
+        xpath,
+        transforms: [ENVELOPED, CANON_ALGORITHM],
+        digestAlgorithm: DIGEST_ALGORITHM,
+        uri: refId,
+    });
+    // Emite <KeyInfo> com o certificado do titular.
+    sig.getKeyInfoContent = () => `<X509Data><X509Certificate>${pfx.certDerBase64}</X509Certificate></X509Data>`;
+    sig.computeSignature(xml, { location: { reference: xpath, action: 'after' } });
+    return withUtf8XmlDeclaration(sig.getSignedXml());
+}
+/** Assina a DPS (referência em infDPS). */
+export function signDps(xml, dpsId, pfx) {
+    return signEnveloped(xml, dpsId, 'infDPS', pfx);
+}
+/** Valida uma DPS assinada usando o certificado fornecido. Útil em testes. */
+export function verifyDps(signedXml, certPem) {
+    const doc = new DOMParser().parseFromString(signedXml, 'text/xml');
+    const signature = doc.getElementsByTagName('Signature')[0];
+    if (!signature)
+        throw new Error('Nenhuma <Signature> encontrada no XML');
+    const sig = new SignedXml({ publicCert: certPem });
+    sig.loadSignature(signature);
+    return sig.checkSignature(signedXml);
+}
+//# sourceMappingURL=signXml.js.map

package/dist/signXml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signXml.js","sourceRoot":"","sources":["../signXml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,6DAA6D;AAC7D,uEAAuE;AACvE,MAAM,mBAAmB,GAAG,mDAAmD,CAAC;AAChF,MAAM,gBAAgB,GAAG,yCAAyC,CAAC;AACnE,MAAM,eAAe,GAAG,qDAAqD,CAAC;AAC9E,MAAM,SAAS,GAAG,uDAAuD,CAAC;AAE1E,2EAA2E;AAC3E,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,MAAM,qBAAqB,GAAG,GAAG,CAAC,OAAO,CAAC,+BAA+B,EAAE,EAAE,CAAC,CAAC;IAC/E,OAAO,yCAAyC,qBAAqB,EAAE,CAAC;AAC1E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAW,EACX,KAAa,EACb,SAAiB,EACjB,GAAgB;IAEhB,MAAM,KAAK,GAAG,sBAAsB,SAAS,IAAI,CAAC;IAClD,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC;QACxB,UAAU,EAAE,GAAG,CAAC,aAAa;QAC7B,UAAU,EAAE,GAAG,CAAC,OAAO;QACvB,kBAAkB,EAAE,mBAAmB;QACvC,yBAAyB,EAAE,eAAe;KAC3C,CAAC,CAAC;IAEH,GAAG,CAAC,YAAY,CAAC;QACf,KAAK;QACL,UAAU,EAAE,CAAC,SAAS,EAAE,eAAe,CAAC;QACxC,eAAe,EAAE,gBAAgB;QACjC,GAAG,EAAE,KAAK;KACX,CAAC,CAAC;IAEH,gDAAgD;IAChD,GAAG,CAAC,iBAAiB,GAAG,GAAG,EAAE,CAC3B,8BAA8B,GAAG,CAAC,aAAa,+BAA+B,CAAC;IAEjF,GAAG,CAAC,gBAAgB,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IAC/E,OAAO,sBAAsB,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,KAAa,EAAE,GAAgB;IAClE,OAAO,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;AAClD,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,SAAS,CAAC,SAAiB,EAAE,OAAe;IAC1D,MAAM,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,GAAG,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACzE,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;IACnD,GAAG,CAAC,aAAa,CAAC,SAA4B,CAAC,CAAC;IAChD,OAAO,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC"}