cosmemilton-acbr-node 0.1.0 → 0.1.1

package/dist/runtime.cjs

@@ -32,7 +32,9 @@ var runtime_exports = {};
 __export(runtime_exports, {
   ErroAcbrNode: () => ErroAcbrNode,
   PROTOCOL_VERSION: () => PROTOCOL_VERSION,
-  criarEmissor: () => criarEmissor
+  criarEmissor: () => criarEmissor,
+  diagnosticarErro: () => diagnosticarErro,
+  diagnosticarResultado: () => diagnosticarResultado
 });
 module.exports = __toCommonJS(runtime_exports);
 var import_node_child_process = require("node:child_process");
@@ -42,16 +44,149 @@ var import_node_module = require("node:module");
 var import_node_crypto = require("node:crypto");
 var import_node_util = require("node:util");
 
+// src/diagnostics.ts
+var ETAPAS = /* @__PURE__ */ new Set(["configuracao", "documento", "runtime", "geracao", "validacao", "assinatura", "transmissao", "consulta", "cancelamento", "carta_correcao", "inutilizacao", "operacao", "limpeza"]);
+var CAMPOS = /* @__PURE__ */ new Set(["cnpj", "uf", "modelo", "ambiente", "contrato", "certificado", "certificado.senha", "certificado.pfx", "certificado.arquivo", "csc", "csc.id", "csc.valor", "timeoutMs", "limiteFila", "limiteBytes", "runtimeDirectory", "documento", "xml", "consulta", "chave", "recibo", "cancelamento", "protocolo", "justificativa", "cartaCorrecao", "correcao", "sequenciaEvento", "inutilizacao", "ano", "serie", "numeroInicial", "numeroFinal", "operacao", "signal"]);
+var CATALOGO = {
+  CONFIGURACAO_INVALIDA: ["configuracao", "A configura\xE7\xE3o cont\xE9m um campo inv\xE1lido.", "Confira o campo indicado e seu tipo antes de continuar."],
+  CONTRATO_INVALIDO: ["configuracao", "O contrato do cliente \xE9 inv\xE1lido.", "Use o contrato gerado junto com o cliente."],
+  CERTIFICADO_INVALIDO: ["configuracao", "O certificado A1 ou sua configura\xE7\xE3o \xE9 inv\xE1lido.", "Confira formato e validade do A1, pfx ou arquivo e a senha digitada, sem registrar esses dados."],
+  CERTIFICADO_DIVERGENTE: ["assinatura", "O certificado n\xE3o corresponde \xE0 raiz CNPJ do emitente.", "Confira o CNPJ configurado e selecione o A1 correspondente ao emitente."],
+  DEPENDENCIA_AUSENTE: ["runtime", "Uma depend\xEAncia do motor fiscal n\xE3o est\xE1 dispon\xEDvel.", "Reinstale o runtime completo da plataforma; confira a disponibilidade do OpenSSL distribu\xEDdo."],
+  SCHEMAS_AUSENTES: ["runtime", "Os schemas fiscais n\xE3o est\xE3o dispon\xEDveis.", "Reinstale o runtime completo da plataforma."],
+  SERVICOS_AUSENTES: ["runtime", "A configura\xE7\xE3o dos servi\xE7os fiscais n\xE3o est\xE1 dispon\xEDvel.", "Reinstale o runtime completo da plataforma."],
+  CSC_AUSENTE: ["configuracao", "A opera\xE7\xE3o de NFC-e exige CSC.", "Informe id e valor do CSC na configura\xE7\xE3o sem registrar seu conte\xFAdo."],
+  IDENTIDADE_DIVERGENTE: ["documento", "A identidade fiscal n\xE3o corresponde \xE0 configura\xE7\xE3o ou ao retorno.", "Confira emitente, UF, modelo, ambiente e chave do documento antes de continuar."],
+  XML_SCHEMA_INVALIDO: ["validacao", "O XML n\xE3o atende aos schemas fiscais.", "Confira os campos obrigat\xF3rios e os tributos; a valida\xE7\xE3o de XML assinado deve ocorrer ap\xF3s a assinatura."],
+  ASSINATURA_INVALIDA: ["assinatura", "A assinatura do XML n\xE3o foi validada.", "Confira o A1 correspondente e use o XML assinado sem altera\xE7\xF5es."],
+  XML_NAO_ASSINADO: ["assinatura", "A opera\xE7\xE3o exige XML previamente assinado.", "Conclua a assinatura e a valida\xE7\xE3o antes de transmitir."],
+  XML_ALTERADO: ["assinatura", "O XML assinado foi alterado.", "Use exatamente o XML assinado e persistido; n\xE3o edite seu conte\xFAdo."],
+  RETORNO_INVALIDO: ["transmissao", "A identidade ou o protocolo do retorno fiscal \xE9 inv\xE1lido.", "Consulte a situa\xE7\xE3o fiscal antes de decidir repetir a opera\xE7\xE3o."],
+  OPERACAO_FISCAL_FALHOU: ["operacao", "O motor n\xE3o conseguiu concluir a etapa fiscal.", "Confira a configura\xE7\xE3o da etapa, os dados do XML e as depend\xEAncias do runtime."],
+  TLS_SERVIDOR_INVALIDO: ["transmissao", "A verifica\xE7\xE3o TLS do servi\xE7o fiscal falhou.", "Confira o servi\xE7o e a cadeia de confian\xE7a; mantenha a verifica\xE7\xE3o TLS habilitada."],
+  CSC_INVALIDO: ["configuracao", "A configura\xE7\xE3o do CSC \xE9 inv\xE1lida.", "Confira id e valor do CSC sem registrar seu conte\xFAdo."],
+  PLATAFORMA_NAO_SUPORTADA: ["runtime", "A plataforma n\xE3o \xE9 suportada.", "Execute em Windows ou Linux x64 com Node.js 22.12 ou superior."],
+  RUNTIME_AUSENTE: ["runtime", "O motor fiscal n\xE3o foi encontrado.", "Instale o runtime da plataforma incluindo depend\xEAncias opcionais."],
+  RUNTIME_INVALIDO: ["runtime", "O runtime fiscal \xE9 inv\xE1lido.", "Use um runtime distribu\xEDdo e compat\xEDvel com a plataforma."],
+  RUNTIME_INCOMPLETO: ["runtime", "Falta um arquivo do runtime fiscal.", "Reinstale o runtime da plataforma."],
+  RUNTIME_ALTERADO: ["runtime", "A integridade do runtime fiscal n\xE3o foi confirmada.", "Reinstale o runtime; n\xE3o desative a verifica\xE7\xE3o dos hashes."],
+  CONTRATO_DIVERGENTE: ["runtime", "Cliente e motor usam contratos diferentes.", "Use vers\xF5es compat\xEDveis ou regenere e recompile ambos."],
+  DOCUMENTO_INVALIDO: ["documento", "O documento cont\xE9m dados incompat\xEDveis com o modelo.", "Valide os campos e tipos do documento antes de gerar o XML."],
+  OPERACAO_INVALIDA: ["operacao", "Os par\xE2metros da opera\xE7\xE3o s\xE3o inv\xE1lidos.", "Informe um objeto com os campos exigidos pela opera\xE7\xE3o."],
+  OPERACAO_CANCELADA: ["operacao", "A opera\xE7\xE3o foi cancelada.", "Confira o estado do envio antes de decidir continuar."],
+  TIMEOUT_MOTOR: ["runtime", "O motor excedeu o tempo de espera.", "Confira o estado do envio antes de repetir a opera\xE7\xE3o."],
+  EMISSOR_FECHADO: ["operacao", "O emissor foi encerrado.", "Crie um novo emissor para continuar."],
+  FALHA_INICIAR_MOTOR: ["runtime", "N\xE3o foi poss\xEDvel iniciar o motor fiscal.", "Confira a instala\xE7\xE3o e as permiss\xF5es de execu\xE7\xE3o do runtime."],
+  FALHA_PIPE: ["runtime", "A comunica\xE7\xE3o com o motor foi interrompida.", "Confira a instala\xE7\xE3o e o estado do envio antes de continuar."],
+  RESPOSTA_EXCESSIVA: ["runtime", "A resposta do motor excedeu o limite.", "Confira o tamanho da opera\xE7\xE3o e a vers\xE3o do runtime."],
+  RESPOSTA_INVALIDA: ["runtime", "O motor devolveu uma resposta inv\xE1lida.", "Confira a compatibilidade do runtime e o estado do envio."],
+  FALHA_MOTOR: ["runtime", "O motor encerrou sem uma resposta fiscal v\xE1lida.", "Confira a instala\xE7\xE3o e o estado do envio antes de continuar."],
+  CERTIFICADO_AUSENTE: ["configuracao", "O certificado A1 n\xE3o est\xE1 dispon\xEDvel para esta opera\xE7\xE3o.", "Configure um A1 acess\xEDvel e sua senha sem registrar esses dados."],
+  CERTIFICADO_EXCESSIVO: ["configuracao", "O certificado excede o limite de tamanho.", "Use um arquivo A1 de at\xE9 2 MiB."],
+  REQUISICAO_INVALIDA: ["operacao", "Os dados n\xE3o puderam ser serializados ou excedem o limite.", "Use dados JSON e reduza o tamanho da opera\xE7\xE3o."],
+  FILA_CHEIA: ["operacao", "A fila fiscal est\xE1 cheia.", "Aguarde a opera\xE7\xE3o atual terminar antes de iniciar outra."],
+  XML_INVALIDO: ["documento", "O XML est\xE1 vazio, tem tipo inv\xE1lido ou excede o limite.", "Informe o XML como texto UTF-8 de at\xE9 2 MiB."],
+  CHAVE_INVALIDA: ["documento", "A chave fiscal tem formato inv\xE1lido.", "Informe a chave como texto com 44 d\xEDgitos."],
+  RECIBO_INVALIDO: ["documento", "O recibo tem formato inv\xE1lido.", "Informe o recibo como texto com 15 d\xEDgitos."],
+  JUSTIFICATIVA_INVALIDA: ["documento", "A justificativa tem tamanho inv\xE1lido.", "Informe uma justificativa com 15 a 255 caracteres."],
+  PROTOCOLO_INVALIDO: ["documento", "O protocolo tem formato inv\xE1lido.", "Informe o protocolo como texto com 15 d\xEDgitos."],
+  OPERACAO_NAO_SUPORTADA: ["operacao", "A opera\xE7\xE3o n\xE3o \xE9 suportada para este modelo.", "Carta de corre\xE7\xE3o exige NF-e modelo 55."],
+  CORRECAO_INVALIDA: ["documento", "Os dados da carta de corre\xE7\xE3o s\xE3o inv\xE1lidos.", "Confira a corre\xE7\xE3o de 15 a 1000 caracteres e a sequ\xEAncia de 1 a 20."],
+  INUTILIZACAO_INVALIDA: ["documento", "A faixa de inutiliza\xE7\xE3o \xE9 inv\xE1lida.", "Confira ano, s\xE9rie e n\xFAmeros inicial e final."],
+  FALHA_LOCAL: ["operacao", "N\xE3o foi poss\xEDvel concluir a opera\xE7\xE3o local.", "Confira a etapa e os tipos dos dados; n\xE3o registre o erro bruto."]
+};
+function etapaDaOperacao(comando) {
+  return { gerarXml: "geracao", validar: "validacao", assinar: "assinatura", transmitir: "transmissao", consultar: "consulta", cancelar: "cancelamento", cartaCorrecao: "carta_correcao", inutilizar: "inutilizacao" }[comando] ?? "operacao";
+}
+function criarDiagnosticoErro(codigo, desconhecido = false, detalhes = {}) {
+  const safeCode = Object.hasOwn(CATALOGO, codigo) ? codigo : "FALHA_LOCAL";
+  const [defaultStage, mensagem, defaultAction] = CATALOGO[safeCode];
+  const etapa = detalhes.etapa && ETAPAS.has(detalhes.etapa) ? detalhes.etapa : defaultStage;
+  const campo = detalhes.campo && CAMPOS.has(detalhes.campo) ? detalhes.campo : void 0;
+  const acoesConfig = { cnpj: "Informe o CNPJ como texto com 14 d\xEDgitos.", uf: "Informe a sigla da UF em letras mai\xFAsculas, por exemplo PE.", modelo: "Informe o n\xFAmero 55 para NF-e ou 65 para NFC-e, sem aspas.", ambiente: "Informe o n\xFAmero 2 para homologa\xE7\xE3o ou 1 para produ\xE7\xE3o, sem aspas.", timeoutMs: "Informe um n\xFAmero inteiro de 1 a 120000 milissegundos.", limiteFila: "Informe um n\xFAmero inteiro de 0 a 1000.", limiteBytes: "Informe um n\xFAmero inteiro de 256 a 8388608 bytes.", runtimeDirectory: "Informe o diret\xF3rio do runtime como texto n\xE3o vazio." };
+  const acao = safeCode === "CONFIGURACAO_INVALIDA" && campo && Object.hasOwn(acoesConfig, campo) ? acoesConfig[campo] : defaultAction;
+  const causa = Object.freeze({ codigo: safeCode, etapa, ...campo ? { campo } : {} });
+  return Object.freeze({
+    codigo: safeCode,
+    etapa,
+    ...campo ? { campo } : {},
+    mensagem,
+    acao: desconhecido ? "Consulte a situa\xE7\xE3o fiscal antes de repetir. O envio pode ter ocorrido; n\xE3o retransmita automaticamente." : acao,
+    statusEnvio: desconhecido ? "resultado_incerto" : "nao_enviado",
+    causa
+  });
+}
+function diagnosticarErro(erro) {
+  return erro instanceof ErroAcbrNode ? erro.diagnostico : criarDiagnosticoErro("FALHA_LOCAL", true);
+}
+function adicionarDiagnosticoLimpeza(diagnostico) {
+  const acao = diagnostico.statusEnvio === "resultado_incerto" ? "Encerre esta aplica\xE7\xE3o antes de iniciar outro motor e consulte a situa\xE7\xE3o fiscal antes de repetir qualquer envio." : "Encerre esta aplica\xE7\xE3o antes de iniciar outro motor. As pr\xF3ximas opera\xE7\xF5es deste emissor foram bloqueadas.";
+  const limpeza = Object.freeze({ codigo: "ENCERRAMENTO_MOTOR_NAO_CONFIRMADO", etapa: "limpeza", mensagem: "N\xE3o foi poss\xEDvel confirmar o encerramento do motor fiscal.", acao });
+  return Object.freeze({ ...diagnostico, acao, limpeza });
+}
+function diagnosticarResultado(resultado, comando) {
+  const etapa = etapaDaOperacao(comando);
+  if (!resultado || typeof resultado !== "object") return criarDiagnosticoErro("FALHA_LOCAL", true, { etapa });
+  if (resultado.envioIniciado !== void 0 && typeof resultado.envioIniciado !== "boolean") return criarDiagnosticoErro("RESPOSTA_INVALIDA", true, { etapa });
+  let statusEnvio = "resultado_incerto", codigo = "RESULTADO_INCERTO";
+  let mensagem = "A situa\xE7\xE3o fiscal ainda n\xE3o foi confirmada.";
+  let acao = "Consulte a situa\xE7\xE3o fiscal antes de repetir. N\xE3o retransmita automaticamente.";
+  const local = comando === "gerarXml" && resultado.estado === "XML_GERADO" || comando === "validar" && resultado.estado === "VALIDADO" || comando === "assinar" && resultado.estado === "ASSINADO";
+  const semEvento = resultado.envioIniciado === false || resultado.envioIniciado === void 0;
+  const protocolo = typeof resultado.protocolo === "string" && /^\d{15}$/.test(resultado.protocolo);
+  const chave = typeof resultado.chave === "string" && /^\d{44}$/.test(resultado.chave);
+  const autorizacao = (comando === "transmitir" || comando === "consultar") && resultado.estado === "AUTORIZADO" && [100, 150].includes(resultado.cStat) && protocolo && chave && (comando === "consultar" || resultado.envioIniciado !== false);
+  const evento = comando === "cancelar" && resultado.estado === "CANCELADO" && [135, 136].includes(resultado.cStat) && chave || comando === "cartaCorrecao" && resultado.estado === "EVENTO_REGISTRADO" && resultado.cStat === 135 && chave || comando === "inutilizar" && resultado.estado === "INUTILIZADO" && resultado.cStat === 102;
+  if (local && resultado.sucesso === true && semEvento) {
+    statusEnvio = "nao_enviado";
+    codigo = "ETAPA_LOCAL_CONCLUIDA";
+    mensagem = "A etapa local foi conclu\xEDda; esta opera\xE7\xE3o n\xE3o transmitiu a nota.";
+    acao = "Confira o resultado antes de seguir para a pr\xF3xima etapa.";
+  } else if (resultado.sucesso === true && (autorizacao || evento && protocolo && resultado.envioIniciado !== false)) {
+    statusEnvio = "autorizado";
+    codigo = "OPERACAO_CONFIRMADA";
+    mensagem = { AUTORIZADO: "A nota foi autorizada.", CANCELADO: "O cancelamento foi confirmado.", EVENTO_REGISTRADO: "O evento foi registrado.", INUTILIZADO: "A faixa foi inutilizada." }[resultado.estado];
+    acao = "Guarde o resultado fiscal. N\xE3o repita esta opera\xE7\xE3o.";
+  } else if (resultado.sucesso === false && (comando === "consultar" || resultado.envioIniciado !== false) && ["transmitir", "consultar", "cancelar", "cartaCorrecao", "inutilizar"].includes(comando) && Number.isInteger(resultado.cStat) && Number(resultado.cStat) > 0 && Number(resultado.cStat) <= 9999 && (resultado.estado === "DENEGADO" && [110, 301, 302].includes(resultado.cStat) || resultado.estado === "REJEITADO" && ![100, 150, 110, 301, 302, 101, 151, 155, 103, 104, 105, 108, 109, 204, 539, 573, 135, 136, 102, 217].includes(resultado.cStat))) {
+    statusEnvio = "rejeitado";
+    codigo = resultado.estado === "DENEGADO" ? "NOTA_DENEGADA" : "OPERACAO_REJEITADA";
+    mensagem = resultado.estado === "DENEGADO" ? "A nota foi denegada." : "A opera\xE7\xE3o foi rejeitada.";
+    acao = resultado.estado === "DENEGADO" ? "Consulte a situa\xE7\xE3o fiscal e a orienta\xE7\xE3o respons\xE1vel antes de usar a numera\xE7\xE3o." : "Confira o cStat e revise os dados antes de decidir uma nova tentativa.";
+  } else if (resultado.estado === "ERRO" && resultado.envioIniciado === false) {
+    if (typeof resultado.codigo === "string" && Object.hasOwn(CATALOGO, resultado.codigo)) return criarDiagnosticoErro(resultado.codigo, false, { etapa });
+    statusEnvio = "nao_enviado";
+    codigo = "FALHA_ANTES_ENVIO";
+    mensagem = "O motor informou falha antes de iniciar o envio desta opera\xE7\xE3o.";
+    acao = "Revise a configura\xE7\xE3o e os dados antes de continuar.";
+  }
+  const cStat = Number.isInteger(resultado.cStat) && Number(resultado.cStat) > 0 && Number(resultado.cStat) <= 9999 ? resultado.cStat : void 0;
+  return Object.freeze({ codigo, etapa, mensagem, acao, statusEnvio, ...cStat !== void 0 ? { cStat } : {} });
+}
+
 // src/types.ts
 var PROTOCOL_VERSION = 1;
 var ErroAcbrNode = class extends Error {
-  constructor(codigo, mensagem, resultadoDesconhecido = false, xmlBase64) {
+  constructor(codigo, mensagem, resultadoDesconhecido = false, xmlBase64, detalhes) {
     super(mensagem);
     this.codigo = codigo;
     this.resultadoDesconhecido = resultadoDesconhecido;
     this.xmlBase64 = xmlBase64;
+    this.#diagnostico = criarDiagnosticoErro(codigo, resultadoDesconhecido, detalhes);
+    Object.defineProperty(this, "xmlBase64", { value: xmlBase64, enumerable: false });
+    Object.defineProperty(this, "cause", { value: this.diagnostico.causa, enumerable: false });
   }
   name = "ErroAcbrNode";
+  #diagnostico;
+  get diagnostico() {
+    return this.#diagnostico;
+  }
+  /** Acrescenta apenas o aviso estático de limpeza, preservando o erro da operação. */
+  anotarFalhaLimpeza() {
+    this.#diagnostico = adicionarDiagnosticoLimpeza(this.#diagnostico);
+  }
+  toJSON() {
+    return this.diagnostico;
+  }
 };
 
 // src/runtime.ts
@@ -59,9 +194,10 @@ var import_meta = {};
 var STATES = /* @__PURE__ */ new Set(["DENEGADO", "XML_GERADO", "VALIDADO", "ASSINADO", "AUTORIZADO", "REJEITADO", "PENDENTE", "INDETERMINADO", "CONSULTADO", "CANCELADO", "EVENTO_REGISTRADO", "INUTILIZADO", "ERRO"]);
 var UFS = new Set("AC AL AP AM BA CE DF ES GO MA MT MS MG PA PB PR PE PI RJ RN RS RO RR SC SP SE TO".split(" "));
 var MAX_BYTES = 8 * 1024 * 1024;
+var MAX_TEARDOWN_MS = 1e3;
 var plain = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
 var validContract = (v) => plain(v) && Number.isInteger(v.sourceRevision) && Number(v.sourceRevision) > 0 && typeof v.contractHash === "string" && /^[a-f0-9]{64}$/.test(v.contractHash);
-var fail = (code, message, req, unknown = false) => new ErroAcbrNode(code, message, unknown, req?.comando === "transmitir" ? req.xmlBase64 : void 0);
+var fail = (code, message, req, unknown = false, detalhes) => new ErroAcbrNode(code, message, unknown, req?.comando === "transmitir" ? req.xmlBase64 : void 0, { ...req ? { etapa: etapaDaOperacao(req.comando) } : {}, ...detalhes });
 function confined(root, relative) {
   const file = import_node_path.default.resolve(root, relative), part = import_node_path.default.relative(root, file);
   if (!relative || import_node_path.default.isAbsolute(relative) || part === ".." || part.startsWith(".." + import_node_path.default.sep)) throw fail("RUNTIME_INVALIDO", "Caminho inv\xE1lido no runtime.");
@@ -104,26 +240,48 @@ async function resolveRuntime(directory, contract) {
   return { directory: root, executable: confined(root, m.executable) };
 }
 function criarEmissor(options) {
-  if (!/^\d{14}$/.test(options.cnpj) || !UFS.has(options.uf) || ![55, 65].includes(options.modelo) || ![1, 2].includes(options.ambiente)) throw fail("CONFIGURACAO_INVALIDA", "Informe CNPJ, UF, modelo e ambiente v\xE1lidos.");
+  const configFail = (campo) => fail("CONFIGURACAO_INVALIDA", "Informe campos e tipos v\xE1lidos na configura\xE7\xE3o.", void 0, false, { etapa: "configuracao", campo });
+  if (!plain(options)) throw configFail();
+  if (typeof options.cnpj !== "string" || !/^\d{14}$/.test(options.cnpj)) throw configFail("cnpj");
+  if (typeof options.uf !== "string" || !UFS.has(options.uf)) throw configFail("uf");
+  if (![55, 65].includes(options.modelo)) throw configFail("modelo");
+  if (![1, 2].includes(options.ambiente)) throw configFail("ambiente");
   if (!validContract(options.contrato)) throw fail("CONTRATO_INVALIDO", "Contrato gerado inv\xE1lido.");
   const cert = options.certificado;
-  if (cert && (typeof cert.senha !== "string" || !!cert.pfx === !!cert.arquivo || cert.pfx && !(cert.pfx instanceof Uint8Array))) throw fail("CERTIFICADO_INVALIDO", "Informe A1 em pfx ou arquivo e sua senha.");
-  if (options.csc && (!/^\d{1,6}$/.test(options.csc.id) || typeof options.csc.valor !== "string" || !options.csc.valor || options.csc.valor.length > 256)) throw fail("CSC_INVALIDO", "CSC inv\xE1lido.");
+  if (cert !== void 0 && (!plain(cert) || typeof cert.senha !== "string" || !!cert.pfx === !!cert.arquivo || cert.pfx !== void 0 && !(cert.pfx instanceof Uint8Array) || cert.arquivo !== void 0 && (typeof cert.arquivo !== "string" || !cert.arquivo))) throw fail("CERTIFICADO_INVALIDO", "Informe A1 em pfx ou arquivo e sua senha.", void 0, false, { campo: "certificado" });
+  if (options.csc !== void 0 && (!plain(options.csc) || typeof options.csc.id !== "string" || !/^\d{1,6}$/.test(options.csc.id) || typeof options.csc.valor !== "string" || !options.csc.valor || options.csc.valor.length > 256)) throw fail("CSC_INVALIDO", "CSC inv\xE1lido.", void 0, false, { campo: "csc" });
+  if (options.runtimeDirectory !== void 0 && (typeof options.runtimeDirectory !== "string" || !options.runtimeDirectory)) throw configFail("runtimeDirectory");
+  if (options.validaDocumento !== void 0 && typeof options.validaDocumento !== "function" || options.criaProcesso !== void 0 && typeof options.criaProcesso !== "function") throw configFail();
   const cfg = { cnpj: options.cnpj, uf: options.uf, modelo: options.modelo, ambiente: options.ambiente, csc: options.csc ? { ...options.csc } : void 0 };
   const certificate = cert ? { ...cert, pfx: cert.pfx ? Buffer.from(cert.pfx) : void 0 } : void 0;
   const contract = { ...options.contrato };
   const timeout = options.timeoutMs ?? 12e4, capacity = options.limiteFila ?? 32, bytesLimit = options.limiteBytes ?? MAX_BYTES;
-  if (!Number.isInteger(timeout) || timeout < 1 || timeout > 12e4 || !Number.isInteger(capacity) || capacity < 0 || capacity > 1e3 || !Number.isInteger(bytesLimit) || bytesLimit < 256 || bytesLimit > MAX_BYTES) throw fail("CONFIGURACAO_INVALIDA", "Limites de execu\xE7\xE3o inv\xE1lidos.");
+  if (!Number.isInteger(timeout) || timeout < 1 || timeout > 12e4) throw configFail("timeoutMs");
+  if (!Number.isInteger(capacity) || capacity < 0 || capacity > 1e3) throw configFail("limiteFila");
+  if (!Number.isInteger(bytesLimit) || bytesLimit < 256 || bytesLimit > MAX_BYTES) throw configFail("limiteBytes");
   const launch = options.criaProcesso ?? ((exe, args, config) => (0, import_node_child_process.spawn)(exe, args, { ...config, stdio: ["pipe", "pipe", "pipe"] }));
-  let runtimePromise, closed = false, current;
+  let runtimePromise, closed = false, teardownFailed = false, current;
   const queue = [];
+  const closedError = () => {
+    const error = fail("EMISSOR_FECHADO", "Emissor encerrado.");
+    if (teardownFailed) error.anotarFalhaLimpeza();
+    return error;
+  };
+  const rejectQueue = () => {
+    for (const item of queue.splice(0)) {
+      item.signal?.removeEventListener("abort", item.abort);
+      item.bytes.fill(0);
+      item.reject(closedError());
+    }
+  };
   async function execute(item) {
     if (closed || item.signal?.aborted) throw fail("OPERACAO_CANCELADA", "Opera\xE7\xE3o cancelada antes da execu\xE7\xE3o.");
     const runtime = await (runtimePromise ??= resolveRuntime(options.runtimeDirectory, contract));
     if (closed || item.signal?.aborted) throw fail("OPERACAO_CANCELADA", "Opera\xE7\xE3o cancelada antes da execu\xE7\xE3o.");
-    await new Promise((done) => {
+    return await new Promise((done, rejectExecution) => {
       let stopError;
       let child, finished = false, started = false, sending = false, total = 0, rest = Buffer.alloc(0), result;
+      let teardownTimer;
       let finishCurrent;
       const doneCurrent = new Promise((r) => {
         finishCurrent = r;
@@ -133,18 +291,54 @@ function criarEmissor(options) {
         if (finished) return;
         finished = true;
         clearTimeout(timer);
+        clearTimeout(teardownTimer);
         item.signal?.removeEventListener("abort", abort);
         item.bytes.fill(0);
         if (current?.done === doneCurrent) current = void 0;
         finishCurrent();
-        error ? item.reject(error) : item.resolve(result);
-        done();
+        error ? rejectExecution(error) : done(result);
+      };
+      const detachOwnedChild = () => {
+        for (const pipe of [child?.stdin, child?.stdout, child?.stderr]) {
+          try {
+            pipe?.destroy();
+          } catch {
+          }
+          try {
+            pipe?.unref?.();
+          } catch {
+          }
+        }
+        try {
+          child?.unref();
+        } catch {
+        }
+      };
+      const teardownFallback = () => {
+        if (finished) return;
+        stopError ??= fail("FALHA_MOTOR", "O motor n\xE3o foi encerrado.", item.req, uncertain());
+        stopError.anotarFalhaLimpeza();
+        teardownFailed = true;
+        closed = true;
+        rejectQueue();
+        certificate?.pfx?.fill(0);
+        finish(stopError);
+        detachOwnedChild();
       };
       const stop = (code, message) => {
         if (finished || stopError) return;
         stopError = fail(code, message, item.req, uncertain());
-        if (child?.pid) child.kill("SIGKILL");
-        else finish(stopError);
+        if (!child?.pid) {
+          finish(stopError);
+          detachOwnedChild();
+          return;
+        }
+        teardownTimer = setTimeout(teardownFallback, MAX_TEARDOWN_MS);
+        try {
+          if (child.kill("SIGKILL") !== true) teardownFallback();
+        } catch {
+          teardownFallback();
+        }
       };
       const abort = () => stop("OPERACAO_CANCELADA", "Opera\xE7\xE3o cancelada; confira a situa\xE7\xE3o fiscal quando o envio foi iniciado.");
       const timer = setTimeout(() => stop("TIMEOUT_MOTOR", "O motor excedeu o prazo; consulte a situa\xE7\xE3o antes de transmitir novamente."), timeout);
@@ -171,8 +365,17 @@ function criarEmissor(options) {
       child.on("spawn", () => {
         started = true;
       });
-      child.on("error", () => finish(fail("FALHA_INICIAR_MOTOR", "N\xE3o foi poss\xEDvel iniciar o motor.", item.req, uncertain())));
+      child.on("error", () => {
+        if (finished) return;
+        if (stopError) {
+          teardownFallback();
+          return;
+        }
+        stop("FALHA_INICIAR_MOTOR", "N\xE3o foi poss\xEDvel iniciar o motor.");
+      });
       child.stdin.on("error", () => stop("FALHA_PIPE", "N\xE3o foi poss\xEDvel comunicar com o motor."));
+      child.stdout.on("error", () => stop("FALHA_PIPE", "N\xE3o foi poss\xEDvel comunicar com o motor."));
+      child.stderr.on("error", () => stop("FALHA_PIPE", "N\xE3o foi poss\xEDvel comunicar com o motor."));
       child.stderr.on("data", () => {
       });
       child.stdout.on("data", (chunk) => {
@@ -198,7 +401,9 @@ function criarEmissor(options) {
             if (result || frame.versao !== 1 || frame.sourceRevision !== contract.sourceRevision || frame.contractHash !== contract.contractHash || typeof frame.sucesso !== "boolean" || !STATES.has(String(frame.estado))) throw Error();
             if (frame.xmlBase64 !== void 0 && (typeof frame.xmlBase64 !== "string" || !frame.xmlBase64.length || Buffer.from(frame.xmlBase64, "base64").toString("base64") !== frame.xmlBase64)) throw Error();
             if (frame.cStat !== void 0 && (!Number.isInteger(frame.cStat) || Number(frame.cStat) < 1 || Number(frame.cStat) > 9999)) throw Error();
-            result = frame;
+            if (frame.envioIniciado !== void 0 && typeof frame.envioIniciado !== "boolean" || sending && frame.envioIniciado === false) throw Error();
+            const fiscal = frame;
+            result = { ...fiscal, diagnostico: diagnosticarResultado(sending ? { ...fiscal, envioIniciado: true } : fiscal, item.req.comando) };
           } catch {
             stop("RESPOSTA_INVALIDA", "O motor retornou uma resposta inv\xE1lida.");
             return;
@@ -229,7 +434,8 @@ function criarEmissor(options) {
     busy = true;
     item.signal?.removeEventListener("abort", item.abort);
     try {
-      await execute(item);
+      const result = await execute(item);
+      item.resolve(result);
     } catch (e) {
       item.bytes.fill(0);
       item.reject(e);
@@ -239,7 +445,11 @@ function criarEmissor(options) {
     }
   }
   async function request(command, data, operation = {}) {
-    if (closed) throw fail("EMISSOR_FECHADO", "Emissor encerrado.");
+    const rawOperation = operation;
+    if (!plain(rawOperation)) throw fail("OPERACAO_INVALIDA", "Informe op\xE7\xF5es v\xE1lidas para a opera\xE7\xE3o.", void 0, false, { etapa: etapaDaOperacao(command), campo: "operacao" });
+    const signal = operation.signal;
+    if (signal !== void 0 && (!plain(signal) || typeof signal.aborted !== "boolean" || typeof signal.addEventListener !== "function" || typeof signal.removeEventListener !== "function")) throw fail("OPERACAO_INVALIDA", "Informe op\xE7\xF5es v\xE1lidas para a opera\xE7\xE3o.", void 0, false, { etapa: etapaDaOperacao(command), campo: "signal" });
+    if (closed) throw closedError();
     if (operation.signal?.aborted) throw fail("OPERACAO_CANCELADA", "Opera\xE7\xE3o cancelada antes da execu\xE7\xE3o.");
     if (["assinar", "transmitir", "consultar", "cancelar", "cartaCorrecao", "inutilizar"].includes(command) && !certificate) throw fail("CERTIFICADO_AUSENTE", "A opera\xE7\xE3o exige um certificado A1.");
     if (command === "gerarXml") options.validaDocumento?.(data.documento);
@@ -265,7 +475,7 @@ function criarEmissor(options) {
     return new Promise((resolve, reject) => {
       if (closed) {
         bytes.fill(0);
-        reject(fail("EMISSOR_FECHADO", "Emissor encerrado."));
+        reject(closedError());
         return;
       }
       if (busy && queue.length >= capacity) {
@@ -290,14 +500,17 @@ function criarEmissor(options) {
     });
   }
   const xmlData = (xml) => {
-    if (typeof xml !== "string" || !xml.trim() || Buffer.byteLength(xml, "utf8") > 2 * 1024 * 1024) throw fail("XML_INVALIDO", "XML vazio ou acima do limite.");
+    if (typeof xml !== "string" || !xml.trim() || Buffer.byteLength(xml, "utf8") > 2 * 1024 * 1024) throw fail("XML_INVALIDO", "XML vazio ou acima do limite.", void 0, false, { campo: "xml" });
     return { xmlBase64: Buffer.from(xml, "utf8").toString("base64") };
   };
   const checkKey = (key) => {
-    if (!/^\d{44}$/.test(key)) throw fail("CHAVE_INVALIDA", "Chave fiscal inv\xE1lida.");
+    if (typeof key !== "string" || !/^\d{44}$/.test(key)) throw fail("CHAVE_INVALIDA", "Chave fiscal inv\xE1lida.", void 0, false, { campo: "chave" });
   };
   const reason = (value) => {
-    if (typeof value !== "string" || value.length < 15 || value.length > 255) throw fail("JUSTIFICATIVA_INVALIDA", "Justificativa deve ter de 15 a 255 caracteres.");
+    if (typeof value !== "string" || value.length < 15 || value.length > 255) throw fail("JUSTIFICATIVA_INVALIDA", "Justificativa deve ter de 15 a 255 caracteres.", void 0, false, { campo: "justificativa" });
+  };
+  const checkObject = (data, campo) => {
+    if (!plain(data)) throw fail("OPERACAO_INVALIDA", "Informe os par\xE2metros da opera\xE7\xE3o como objeto.", void 0, false, { campo });
   };
   return {
     gerarXml: (documento, op) => request("gerarXml", { documento }, op),
@@ -305,39 +518,43 @@ function criarEmissor(options) {
     assinar: (xml, op) => request("assinar", xmlData(xml), op),
     transmitir: (xml, op) => request("transmitir", xmlData(xml), op),
     consultar: (consulta, op) => {
+      checkObject(consulta, "consulta");
       checkKey(consulta.chave);
-      if (consulta.recibo && !/^\d{15}$/.test(consulta.recibo)) throw fail("RECIBO_INVALIDO", "Recibo inv\xE1lido.");
+      if (consulta.recibo !== void 0 && (typeof consulta.recibo !== "string" || !/^\d{15}$/.test(consulta.recibo))) throw fail("RECIBO_INVALIDO", "Recibo inv\xE1lido.", void 0, false, { campo: "recibo" });
       return request("consultar", consulta, op);
     },
     cancelar: (data, op) => {
+      checkObject(data, "cancelamento");
       checkKey(data.chave);
       reason(data.justificativa);
-      if (!/^\d{15}$/.test(data.protocolo)) throw fail("PROTOCOLO_INVALIDO", "Protocolo inv\xE1lido.");
+      if (typeof data.protocolo !== "string" || !/^\d{15}$/.test(data.protocolo)) throw fail("PROTOCOLO_INVALIDO", "Protocolo inv\xE1lido.", void 0, false, { campo: "protocolo" });
       return request("cancelar", data, op);
     },
     cartaCorrecao: (data, op) => {
+      checkObject(data, "cartaCorrecao");
       if (cfg.modelo !== 55) throw fail("OPERACAO_NAO_SUPORTADA", "Carta de corre\xE7\xE3o exige NF-e modelo 55.");
       checkKey(data.chave);
-      if (typeof data.correcao !== "string" || data.correcao.length < 15 || data.correcao.length > 1e3 || !Number.isInteger(data.sequenciaEvento ?? 1) || (data.sequenciaEvento ?? 1) < 1 || (data.sequenciaEvento ?? 1) > 20) throw fail("CORRECAO_INVALIDA", "Dados da carta de corre\xE7\xE3o inv\xE1lidos.");
+      if (typeof data.correcao !== "string" || data.correcao.length < 15 || data.correcao.length > 1e3 || !Number.isInteger(data.sequenciaEvento ?? 1) || (data.sequenciaEvento ?? 1) < 1 || (data.sequenciaEvento ?? 1) > 20) throw fail("CORRECAO_INVALIDA", "Dados da carta de corre\xE7\xE3o inv\xE1lidos.", void 0, false, { campo: "cartaCorrecao" });
       return request("cartaCorrecao", { ...data, sequenciaEvento: data.sequenciaEvento ?? 1 }, op);
     },
     inutilizar: (data, op) => {
+      checkObject(data, "inutilizacao");
       reason(data.justificativa);
-      if (!Number.isInteger(data.ano) || data.ano < 0 || data.ano > 99 || !Number.isInteger(data.serie) || data.serie < 0 || data.serie > 999 || !Number.isInteger(data.numeroInicial) || data.numeroInicial < 1 || !Number.isInteger(data.numeroFinal) || data.numeroFinal < data.numeroInicial || data.numeroFinal > 999999999) throw fail("INUTILIZACAO_INVALIDA", "Faixa de inutiliza\xE7\xE3o inv\xE1lida.");
+      if (!Number.isInteger(data.ano) || data.ano < 0 || data.ano > 99 || !Number.isInteger(data.serie) || data.serie < 0 || data.serie > 999 || !Number.isInteger(data.numeroInicial) || data.numeroInicial < 1 || !Number.isInteger(data.numeroFinal) || data.numeroFinal < data.numeroInicial || data.numeroFinal > 999999999) throw fail("INUTILIZACAO_INVALIDA", "Faixa de inutiliza\xE7\xE3o inv\xE1lida.", void 0, false, { campo: "inutilizacao" });
       return request("inutilizar", { inutilizacao: { ano: data.ano, serie: data.serie, numeroInicial: data.numeroInicial, numeroFinal: data.numeroFinal }, justificativa: data.justificativa }, op);
     },
     async fechar() {
-      if (closed) return;
-      closed = true;
-      for (const item of queue.splice(0)) {
-        item.signal?.removeEventListener("abort", item.abort);
-        item.bytes.fill(0);
-        item.reject(fail("EMISSOR_FECHADO", "Emissor encerrado."));
+      if (!closed) {
+        closed = true;
+        rejectQueue();
       }
       const running = current;
-      running?.stop();
-      if (running) await running.done;
-      certificate?.pfx?.fill(0);
+      try {
+        running?.stop();
+        if (running) await running.done;
+      } finally {
+        certificate?.pfx?.fill(0);
+      }
     }
   };
 }
@@ -345,6 +562,8 @@ function criarEmissor(options) {
 0 && (module.exports = {
   ErroAcbrNode,
   PROTOCOL_VERSION,
-  criarEmissor
+  criarEmissor,
+  diagnosticarErro,
+  diagnosticarResultado
 });
 //# sourceMappingURL=runtime.cjs.map