@sinete/nfe 0.1.0 → 0.3.0

package/dist/index.js

@@ -1,12 +1,20 @@
 // packages/nfe/src/build/build.ts
-import { ConfigError as ConfigError2, fixedClock as fixedClock2, formatarVerProc, isUf as isUf2, tpAmbOf as tpAmbOf2, ufBySigla as ufBySigla2, ValidationError } from "@sinete/core";
-import { base64Encode as base64Encode2, firstChild as firstChild3, parseXml as parseXml3, signXml } from "@sinete/core/xml";
-import { SerializeError, serialize as serialize2, validate as validate3 } from "@sinete/schemas";
+import {
+  ErroDeConfiguracao as ErroDeConfiguracao2,
+  ErroDeValidacao,
+  ehUf as ehUf2,
+  formatarVerProc,
+  relogioFixo as relogioFixo2,
+  tpAmbDoAmbiente as tpAmbDoAmbiente2,
+  ufPorSigla as ufPorSigla2
+} from "@sinete/core";
+import { assinarXml, codificarBase64 as codificarBase642, lerXml as lerXml3, primeiroFilho as primeiroFilho3 } from "@sinete/core/xml";
+import { ErroSerializacao, serializar as serializar2, validar as validar3 } from "@sinete/schemas";
 import { TIS as TISCt, TNFe_infNFeSupl, TTribNFe as TTribNFeCt } from "@sinete/schemas/nfe/PL_010f";
-import { buildChaveAcesso, parseChaveAcesso, parseCnpj as parseCnpj3, parseCpf, parseIe } from "@sinete/validators";
+import { lerChaveAcesso, lerCnpj as lerCnpj3, lerCpf, lerIe, montarChaveAcesso } from "@sinete/validators";
 // packages/nfe/src/data/arredondamento.json
 var arredondamento_default = {
-  descricao: "Modo de arredondamento dos valores calculados pelo builder, por família de campo. HALF_UP é o arredondamento comercial; HALF_EVEN é o bancário (NBR 5891). Quem emite pode sobrepor por família em BuildNfeOptions.arredondamento.",
+  descricao: "Modo de arredondamento dos valores calculados pelo builder, por família de campo. HALF_UP é o arredondamento comercial; HALF_EVEN é o bancário (NBR 5891). Quem emite pode sobrepor por família em MontarNfeOpcoes.arredondamento.",
   atualizadoEm: "2026-09-26",
   familias: {
     produto: {
@@ -37,7 +45,7 @@ var arredondamento_default = {
 };
 // packages/nfe/src/data/produtor-rural.json
 var produtor_rural_default = {
-  descricao: "Regras do produtor rural que variam no tempo ou por UF. refNFP: a nota fiscal de produtor em papel (modelo 04) foi extinta; uma NF-e ainda pode referenciar uma nota modelo 04 emitida antes do fim da vigência na UF da nota referenciada. vedadaDesde é o primeiro AAMM em que a UF não aceita mais nota modelo 04 emitida; a referência a nota com AAMM igual ou posterior é recusada pelo builder. series: faixas de série por tipo de emitente na emissão pelo contribuinte (procEmi 0, a única que o buildNfe monta).",
+  descricao: "Regras do produtor rural que variam no tempo ou por UF. refNFP: a nota fiscal de produtor em papel (modelo 04) foi extinta; uma NF-e ainda pode referenciar uma nota modelo 04 emitida antes do fim da vigência na UF da nota referenciada. vedadaDesde é o primeiro AAMM em que a UF não aceita mais nota modelo 04 emitida; a referência a nota com AAMM igual ou posterior é recusada pelo builder. series: faixas de série por tipo de emitente na emissão pelo contribuinte (procEmi 0, a única que o montarNfe monta).",
   atualizadoEm: "2026-09-28",
   refNFP: {
     modelo04: {
@@ -62,7 +70,7 @@ var reforma_default = {
 };
 // packages/nfe/src/data/resp-tec.json
 var resp_tec_default = {
-  descricao: "Exigência do grupo infRespTec e do CSRT por UF do emitente, com vigência por ambiente. infRespTec: 'obrigatorio' faz o builder recusar a nota sem responsável técnico; 'opcional' só o inclui quando informado. csrt: 'obrigatorio' exige idCSRT e hashCSRT (rejeição 975). Datas no formato AAAA-MM-DD, a partir de 00:00 de Brasília. UF ausente usa o padrão. A adesão é de cada UF (NT 2018.005); quem emite pode sobrepor em BuildNfeOptions.",
+  descricao: "Exigência do grupo infRespTec e do CSRT por UF do emitente, com vigência por ambiente. infRespTec: 'obrigatorio' faz o builder recusar a nota sem responsável técnico; 'opcional' só o inclui quando informado. csrt: 'obrigatorio' exige idCSRT e hashCSRT (rejeição 975). Datas no formato AAAA-MM-DD, a partir de 00:00 de Brasília. UF ausente usa o padrão. A adesão é de cada UF (NT 2018.005); quem emite pode sobrepor em MontarNfeOpcoes.",
   atualizadoEm: "2026-09-26",
   fonte: "NT 2018.005 v1.50 (responsável técnico e CSRT, adesão a critério da UF)",
   padrao: { infRespTec: "opcional", csrt: "opcional" },
@@ -76,7 +84,7 @@ var resp_tec_default = {
 };
 
 // packages/nfe/src/decimal.ts
-import { ConfigError } from "@sinete/core";
+import { ErroDeConfiguracao } from "@sinete/core";
 var DECIMAL_TEXT = /^([+-])?(\d+)(?:\.(\d*))?(?:[eE]([+-]?\d+))?$|^([+-])?\.(\d+)(?:[eE]([+-]?\d+))?$/;
 var MAX_SCALE = 64;
 function pow10(n) {
@@ -95,13 +103,13 @@ class Decimal {
   static HUNDRED = new Decimal(100n, 0);
   static fromParts(coef, scale) {
     if (!Number.isInteger(scale) || scale < 0 || scale > MAX_SCALE)
-      throw new ConfigError(`escala inválida: ${scale}`);
+      throw new ErroDeConfiguracao(`escala inválida: ${scale}`);
     return new Decimal(coef, scale);
   }
   static of(input) {
     const d = Decimal.tryOf(input);
     if (d === undefined)
-      throw new ConfigError(`número decimal inválido: ${JSON.stringify(String(input))}`);
+      throw new ErroDeConfiguracao(`número decimal inválido: ${JSON.stringify(String(input))}`);
     return d;
   }
   static tryOf(input) {
@@ -161,7 +169,7 @@ class Decimal {
   dividedBy(other, scale, mode) {
     const o = Decimal.of(other);
     if (o.coef === 0n)
-      throw new ConfigError("divisão por zero");
+      throw new ErroDeConfiguracao("divisão por zero");
     const shift = o.scale + scale + 1 - this.scale;
     const num = shift >= 0 ? this.coef * pow10(shift) : this.coef;
     const den = shift >= 0 ? o.coef : o.coef * pow10(-shift);
@@ -181,7 +189,7 @@ class Decimal {
   }
   round(scale, mode) {
     if (!Number.isInteger(scale) || scale < 0)
-      throw new ConfigError(`casas decimais inválidas: ${scale}`);
+      throw new ErroDeConfiguracao(`casas decimais inválidas: ${scale}`);
     if (scale >= this.scale)
       return new Decimal(this.coef * pow10(scale - this.scale), scale);
     return roundCoef(this.coef, this.scale, scale, mode, false);
@@ -246,50 +254,50 @@ function roundCoef(coef, from, to, mode, sticky) {
   }
   return Decimal.fromParts(neg ? -q : q, to);
 }
-function dec(input) {
-  return Decimal.of(input);
+function dec(valor) {
+  return Decimal.of(valor);
 }
-function sum(values) {
+function sum(valores) {
   let acc = Decimal.ZERO;
-  for (const v of values)
+  for (const v of valores)
     acc = acc.plus(v);
   return acc;
 }
 
 // packages/nfe/src/format.ts
-var D1302 = { name: "TDec_1302", min: 2, max: 2, intDigits: 13 };
-var D1302_OPC = { name: "TDec_1302Opc", min: 2, max: 2, intDigits: 13, nonZero: true };
-var D0302A04 = { name: "TDec_0302a04", min: 2, max: 4, intDigits: 3 };
-var D0302A04_OPC = { name: "TDec_0302a04Opc", min: 2, max: 4, intDigits: 3 };
-var D0302 = { name: "TDec_0302Max100", min: 2, max: 2, intDigits: 3 };
-var D1104V = { name: "TDec_1104v", min: 0, max: 4, intDigits: 11 };
-var D1104 = { name: "TDec_1104", min: 4, max: 4, intDigits: 11 };
-var D1110V = { name: "TDec_1110v", min: 0, max: 10, intDigits: 11 };
-var D1204V = { name: "TDec_1204v", min: 0, max: 4, intDigits: 12 };
-var D1204 = { name: "TDec_1204", min: 4, max: 4, intDigits: 12 };
-var D1203 = { name: "TDec_1203", min: 3, max: 3, intDigits: 12 };
-function formatDecimal(value, format, mode = "HALF_UP") {
-  const r = value.round(format.max, mode);
-  let places = Math.max(format.min, Math.min(format.max, r.significantScale()));
-  if (format.minBelowOne !== undefined && !r.isZero() && r.abs().lt(1))
-    places = Math.max(places, format.minBelowOne);
-  return r.toFixed(places, mode);
+var D1302 = { nome: "TDec_1302", min: 2, max: 2, digitosInteiros: 13 };
+var D1302_OPC = { nome: "TDec_1302Opc", min: 2, max: 2, digitosInteiros: 13, naoNulo: true };
+var D0302A04 = { nome: "TDec_0302a04", min: 2, max: 4, digitosInteiros: 3 };
+var D0302A04_OPC = { nome: "TDec_0302a04Opc", min: 2, max: 4, digitosInteiros: 3 };
+var D0302 = { nome: "TDec_0302Max100", min: 2, max: 2, digitosInteiros: 3 };
+var D1104V = { nome: "TDec_1104v", min: 0, max: 4, digitosInteiros: 11 };
+var D1104 = { nome: "TDec_1104", min: 4, max: 4, digitosInteiros: 11 };
+var D1110V = { nome: "TDec_1110v", min: 0, max: 10, digitosInteiros: 11 };
+var D1204V = { nome: "TDec_1204v", min: 0, max: 4, digitosInteiros: 12 };
+var D1204 = { nome: "TDec_1204", min: 4, max: 4, digitosInteiros: 12 };
+var D1203 = { nome: "TDec_1203", min: 3, max: 3, digitosInteiros: 12 };
+function formatarDecimal(valor, formato, modo = "HALF_UP") {
+  const r = valor.round(formato.max, modo);
+  let places = Math.max(formato.min, Math.min(formato.max, r.significantScale()));
+  if (formato.minimoAbaixoDeUm !== undefined && !r.isZero() && r.abs().lt(1))
+    places = Math.max(places, formato.minimoAbaixoDeUm);
+  return r.toFixed(places, modo);
 }
-function formatProblem(value, format) {
-  if (value.isNegative())
+function problemaDeFormato(valor, formato) {
+  if (valor.isNegative())
     return "valor negativo";
-  if (format.nonZero && value.isZero())
+  if (formato.naoNulo && valor.isZero())
     return "valor zero não é aceito neste campo";
-  if (value.significantScale() > format.max)
-    return `mais de ${format.max} casas decimais`;
-  const intDigits = value.round(0, "DOWN").abs().toString().replace(/^0$/, "").length;
-  if (intDigits > format.intDigits)
-    return `mais de ${format.intDigits} dígitos inteiros`;
+  if (valor.significantScale() > formato.max)
+    return `mais de ${formato.max} casas decimais`;
+  const intDigits = valor.round(0, "DOWN").abs().toString().replace(/^0$/, "").length;
+  if (intDigits > formato.digitosInteiros)
+    return `mais de ${formato.digitosInteiros} dígitos inteiros`;
   return;
 }
 
 // packages/nfe/src/issues.ts
-var NFE_ISSUE_CODES = [
+var CODIGOS_OCORRENCIA_NFE = [
   "campo_obrigatorio",
   "campo_invalido",
   "campo_fora_do_pl",
@@ -326,7 +334,7 @@ class Issues {
     this.list = [];
   }
   add(path, code, message, origem = "entrada") {
-    this.list.push({ path, code, message, origem });
+    this.list.push({ caminho: path, code, mensagem: message, origem });
   }
   montagem(path, code, message) {
     this.add(path, code, message, "montagem");
@@ -350,10 +358,10 @@ class Issues {
 }
 
 // packages/nfe/src/rtc.ts
-import { fixedClock, isUf, timeContext, ufByCUf } from "@sinete/core";
-import { officialRates, RateUnknownError } from "@sinete/ibs-cbs/aliquotas";
-import { ClassificationError, calculate, UnsupportedRegimeError } from "@sinete/ibs-cbs/calcular";
-import { documentFromRoc, validate } from "@sinete/ibs-cbs/validar";
+import { contextoDeTempo, ehUf, relogioFixo, ufPorCUf } from "@sinete/core";
+import { aliquotasOficiais, ErroAliquotaDesconhecida } from "@sinete/ibs-cbs/aliquotas";
+import { calcular, ErroClassificacao, ErroRegimeNaoSuportado } from "@sinete/ibs-cbs/calcular";
+import { documentoDoRoc, validar } from "@sinete/ibs-cbs/validar";
 var BASE = /^\d{1,13}(\.\d{1,2})?$/;
 function normalizado(v) {
   const [int = "0", frac = ""] = v.split(".");
@@ -363,7 +371,7 @@ function normalizado(v) {
 }
 var caminho = (nItem) => `itens[${nItem - 1}].impostos.ibsCbs`;
 function ufDoMunicipio(cMun) {
-  return ufByCUf(cMun.slice(0, 2))?.sigla;
+  return ufPorCUf(cMun.slice(0, 2))?.sigla;
 }
 function localDaOperacao(nota) {
   if (nota.cMunFGIBS !== undefined) {
@@ -372,7 +380,7 @@ function localDaOperacao(nota) {
       return { uf, cMun: nota.cMunFGIBS };
   }
   const d = nota.destino;
-  if (d !== undefined && d.UF !== "EX" && isUf(d.UF))
+  if (d !== undefined && d.UF !== "EX" && ehUf(d.UF))
     return { uf: d.UF, cMun: d.cMun };
   return { uf: nota.emitente.UF, cMun: nota.emitente.cMun };
 }
@@ -391,30 +399,30 @@ function grupoDoLeiaute(g, indDoacao) {
   };
 }
 function ocorrenciaDoMotor(e, itens) {
-  if (e instanceof ClassificationError || e instanceof UnsupportedRegimeError) {
+  if (e instanceof ErroClassificacao || e instanceof ErroRegimeNaoSuportado) {
     const path = e.item !== undefined ? caminho(e.item) : caminho(itens[0]?.nItem ?? 1);
-    return { path, code: e.code, message: e.message, origem: "entrada" };
+    return { caminho: path, code: e.code, mensagem: e.message, origem: "entrada" };
   }
-  if (e instanceof RateUnknownError)
-    return { path: "impostos.ibsCbs", code: e.code, message: e.message, origem: "montagem" };
+  if (e instanceof ErroAliquotaDesconhecida)
+    return { caminho: "impostos.ibsCbs", code: e.code, mensagem: e.message, origem: "montagem" };
   return;
 }
 var embarcado;
 function carregarDatasetEmbarcado() {
-  embarcado ??= import("@sinete/ibs-cbs-dados/bundled").then((m) => m.bundledDataset(), (e) => {
+  embarcado ??= import("@sinete/ibs-cbs-dados/embarcado").then((m) => m.datasetEmbarcado(), (e) => {
     embarcado = undefined;
     throw e;
   });
   return embarcado;
 }
-function ibsCbsCalculator(options = {}) {
-  const rates = options.rates ?? officialRates();
-  const dataset = options.dataset;
+function calculadoraIbsCbs(opcoes = {}) {
+  const rates = opcoes.aliquotas ?? aliquotasOficiais();
+  const dataset = opcoes.dataset;
   return {
     calcular(request) {
       if (dataset !== undefined)
-        return calcularCom(dataset, rates, options, request);
-      return carregarDatasetEmbarcado().then((ds) => calcularCom(ds, rates, options, request));
+        return calcularCom(dataset, rates, opcoes, request);
+      return carregarDatasetEmbarcado().then((ds) => calcularCom(ds, rates, opcoes, request));
     }
   };
 }
@@ -427,9 +435,9 @@ function calcularCom(dataset, rates, options, {
   for (const it of itens) {
     if (it.cCredPres !== undefined) {
       issues.push({
-        path: caminho(it.nItem),
+        caminho: caminho(it.nItem),
         code: "ibscbs_nao_suportado",
-        message: "crédito presumido (cCredPres) precisa do grupo gCredPresOper pronto (ibsCbs.grupo)",
+        mensagem: "crédito presumido (cCredPres) precisa do grupo gCredPresOper pronto (ibsCbs.grupo)",
         origem: "entrada"
       });
       continue;
@@ -437,18 +445,18 @@ function calcularCom(dataset, rates, options, {
     const base = it.vBC !== undefined ? it.vBC.toFixed(2) : options.base?.(it, nota);
     if (base === undefined) {
       issues.push({
-        path: `${caminho(it.nItem)}.classificacao.vBC`,
+        caminho: `${caminho(it.nItem)}.classificacao.vBC`,
         code: "ibscbs_base_ausente",
-        message: "informe vBC do IBS/CBS ou IbsCbsCalculatorOptions.base: a composição da base (UB16-10) ainda não tem regra publicada",
+        mensagem: "informe vBC do IBS/CBS ou CalculadoraIbsCbsOpcoes.base: a composição da base (UB16-10) ainda não tem regra publicada",
         origem: "entrada"
       });
       continue;
     }
     if (!BASE.test(base)) {
       issues.push({
-        path: `${caminho(it.nItem)}.classificacao.vBC`,
+        caminho: `${caminho(it.nItem)}.classificacao.vBC`,
         code: "decimal_invalido",
-        message: base,
+        mensagem: base,
         origem: it.vBC !== undefined ? "entrada" : "montagem"
       });
       continue;
@@ -458,92 +466,92 @@ function calcularCom(dataset, rates, options, {
       cst: it.CST,
       cClassTrib: it.cClassTrib,
       base,
-      quantity: it.qTrib.toString(),
-      unit: it.uTrib,
+      quantidade: it.qTrib.toString(),
+      unidade: it.uTrib,
       ...it.gTribRegular === undefined ? {} : { regular: { cst: it.gTribRegular.CSTReg, cClassTrib: it.gTribRegular.cClassTribReg } }
     });
   }
   if (issues.length > 0)
-    return { itens: [], issues };
+    return { itens: [], ocorrencias: issues };
   const op = {
     modelo: Number(nota.mod),
-    place: localDaOperacao(nota),
+    local: localDaOperacao(nota),
     ...nota.compraGov === undefined ? {} : {
-      governmentPurchase: {
+      compraGovernamental: {
         tpEnteGov: Number(nota.compraGov.tpEnteGov),
         ...nota.compraGov.tpOperGov === "1" || nota.compraGov.tpOperGov === "2" ? { tpOperGov: Number(nota.compraGov.tpOperGov) } : {}
       }
     },
-    items: classificados
+    itens: classificados
   };
-  const time = timeContext({ emissao: fixedClock(nota.emissao), fatoGerador: fixedClock(nota.fatoGerador) });
+  const time = contextoDeTempo({ emissao: relogioFixo(nota.emissao), fatoGerador: relogioFixo(nota.fatoGerador) });
   let roc;
   try {
-    roc = calculate(op, {
+    roc = calcular(op, {
       dataset,
-      rates,
-      time,
-      ...options.utcOffsetMinutes === undefined ? {} : { utcOffsetMinutes: options.utcOffsetMinutes }
+      aliquotas: rates,
+      tempo: time,
+      ...options.deslocamentoMin === undefined ? {} : { deslocamentoMin: options.deslocamentoMin }
     });
   } catch (e) {
     const issue = ocorrenciaDoMotor(e, itens);
     if (issue === undefined)
       throw e;
-    return { itens: [], issues: [issue] };
+    return { itens: [], ocorrencias: [issue] };
   }
   const redutor = roc.oper?.gCompraGov.pRedutor;
   if (nota.compraGov !== undefined && redutor !== undefined && normalizado(nota.compraGov.pRedutor.toString()) !== normalizado(redutor)) {
     issues.push({
-      path: "gCompraGov.pRedutor",
+      caminho: "gCompraGov.pRedutor",
       code: "ibscbs_redutor_divergente",
-      message: `pRedutor informado (${nota.compraGov.pRedutor.toString()}) difere do vigente no fato gerador (${redutor})`,
+      mensagem: `pRedutor informado (${nota.compraGov.pRedutor.toString()}) difere do vigente no fato gerador (${redutor})`,
       origem: "entrada"
     });
   }
   if (options.regras !== false) {
-    const doc = documentFromRoc(roc, {
+    const doc = documentoDoRoc(roc, {
       modelo: op.modelo,
       crt: Number(nota.emitente.CRT),
       finNFe: Number(nota.finNFe),
       ...nota.tpNFDebito === undefined ? {} : { tpNFDebito: nota.tpNFDebito },
       ...nota.tpNFCredito === undefined ? {} : { tpNFCredito: nota.tpNFCredito },
-      emitMun: nota.emitente.cMun,
-      ...nota.destino === undefined ? {} : { destMun: nota.destino.cMun },
-      items: itens.map((it) => ({ nItem: it.nItem, ncm: it.NCM, vProd: it.vProd.toFixed(2) }))
+      munEmitente: nota.emitente.cMun,
+      ...nota.destino === undefined ? {} : { munDestinatario: nota.destino.cMun },
+      itens: itens.map((it) => ({ nItem: it.nItem, ncm: it.NCM, vProd: it.vProd.toFixed(2) }))
     });
-    const report = validate(doc, {
+    const report = validar(doc, {
       dataset,
-      time,
+      tempo: time,
       ambiente: nota.ambiente,
-      rates,
-      ...options.utcOffsetMinutes === undefined ? {} : { utcOffsetMinutes: options.utcOffsetMinutes },
-      ...options.regras?.rules === undefined ? {} : { rules: options.regras.rules },
-      ...options.regras?.ignoreActivation === undefined ? {} : { ignoreActivation: options.regras.ignoreActivation }
+      aliquotas: rates,
+      ...options.deslocamentoMin === undefined ? {} : { deslocamentoMin: options.deslocamentoMin },
+      ...options.regras?.regras === undefined ? {} : { regras: options.regras.regras },
+      ...options.regras?.ignorarAtivacao === undefined ? {} : { ignorarAtivacao: options.regras.ignorarAtivacao }
     });
-    for (const v of report.violations) {
+    for (const v of report.violacoes) {
       issues.push({
-        path: v.item === undefined ? "total.IBSCBSTot" : caminho(v.item),
+        caminho: v.item === undefined ? "total.IBSCBSTot" : caminho(v.item),
         code: "ibscbs_regra_nt",
-        message: `${v.rule} (rejeição ${v.cStat}): ${v.message} [${v.source}]`,
+        mensagem: `${v.regra} (rejeição ${v.cStat}): ${v.message} [${v.fonte}]`,
         origem: "montagem"
       });
     }
   }
   const porItem = new Map(itens.map((it) => [it.nItem, it]));
   return {
-    itens: roc.items.map((r) => ({
+    itens: roc.itens.map((r) => ({
       nItem: r.nItem,
       IBSCBS: grupoDoLeiaute(r.IBSCBS, porItem.get(r.nItem)?.indDoacao)
     })),
-    ...issues.length === 0 ? {} : { issues }
+    ...issues.length === 0 ? {} : { ocorrencias: issues }
   };
 }
 
 // packages/nfe/src/time.ts
-import { formatDateTimeOffset } from "@sinete/core";
+import { formatarDataHoraComFuso } from "@sinete/core";
 // packages/nfe/src/data/fusos.json
 var fusos_default = {
-  descricao: "Deslocamento do horário legal de cada UF em relação a UTC, em minutos, usado para formatar dhEmi, dhSaiEnt, dhCont e dhEvento quando quem emite não informa o fuso. Sem horário de verão desde 2019. UFs com mais de um fuso usam o da capital; o emitente de outro fuso informa offsetMinutes.",
+  descricao: "Deslocamento do horário legal de cada UF em relação a UTC, em minutos, usado para formatar dhEmi, dhSaiEnt, dhCont e dhEvento quando quem emite não informa o fuso. Sem horário de verão desde 2019. UFs com mais de um fuso usam o da capital; o emitente de outro fuso informa deslocamentoMin.",
   atualizadoEm: "2026-09-26",
   fontes: [
     "Lei 11.662/2008 e Lei 12.876/2013 (fusos horários do Brasil; Acre em UTC-5)",
@@ -562,19 +570,19 @@ var fusos_default = {
 
 // packages/nfe/src/time.ts
 var UF_OFFSETS = fusos_default.ufs;
-function offsetDaUf(uf) {
+function deslocamentoDaUf(uf) {
   return Object.hasOwn(UF_OFFSETS, uf) ? UF_OFFSETS[uf] : fusos_default.padrao;
 }
-function formatDh(date, offsetMinutes) {
-  return formatDateTimeOffset(date, offsetMinutes);
+function formatarDh(data, deslocamentoMin) {
+  return formatarDataHoraComFuso(data, deslocamentoMin);
 }
 
 // packages/nfe/src/versao-gerada.ts
-var VERSAO_PACOTE = "0.1.0";
+var VERSAO_PACOTE = "0.3.0";
 
 // packages/nfe/src/build/destinatario.ts
-import { ufBySigla } from "@sinete/core";
-import { parseCnpj } from "@sinete/validators";
+import { ufPorSigla } from "@sinete/core";
+import { lerCnpj } from "@sinete/validators";
 // packages/nfe/src/data/suframa.json
 var suframa_default = {
   descricao: "Onde a inscrição na Suframa do destinatário (ISUF) é aceita na NF-e: UFs inteiras e, no Amapá, só os municípios listados. Fora delas, rejeição 251.",
@@ -617,7 +625,7 @@ function conferirDestinatario(input, ide, issues) {
   }
   if (end !== undefined && !exterior) {
     const e = end;
-    const cUF = ufBySigla(e.UF)?.cUF;
+    const cUF = ufPorSigla(e.UF)?.cUF;
     if (cUF !== undefined && digitos(e.cMun).slice(0, 2) !== cUF) {
       issues.add("destinatario.endereco.cMun", "combinacao_invalida", `município ${e.cMun} não é da UF ${e.UF} do destinatário (E10-20, rejeição 275)`);
     }
@@ -636,8 +644,8 @@ function conferirDestinatario(input, ide, issues) {
       const cnpj = (v) => {
         if (v === undefined)
           return;
-        const r = parseCnpj(v);
-        return r.ok ? r.value : undefined;
+        const r = lerCnpj(v);
+        return r.ok ? r.valor : undefined;
       };
       const cnpjDest = "CNPJ" in d ? cnpj(d.CNPJ) : undefined;
       const mesmoCnpj = cnpjDest !== undefined && cnpjDest === cnpj(input.emitente.CNPJ);
@@ -685,18 +693,18 @@ function conferirDestinatario(input, ide, issues) {
 }
 
 // packages/nfe/src/build/ibscbs.ts
-import { firstChild, parseXml } from "@sinete/core/xml";
-import { serialize, validate as validate2 } from "@sinete/schemas";
+import { lerXml, primeiroFilho } from "@sinete/core/xml";
+import { serializar, validar as validar2 } from "@sinete/schemas";
 var NFE_NS = "http://www.portalfiscal.inf.br/nfe";
 function grupoInvalido(ct, nome, value, path, issues) {
   if (value === undefined)
     return false;
   try {
-    const doc = parseXml(`<w xmlns="${NFE_NS}">${serialize(ct, nome, value, NFE_NS)}</w>`);
-    const el = firstChild(doc.root, nome, NFE_NS);
-    const erros = el === undefined ? [{ path: "", code: "modelo_de_conteudo", message: "grupo vazio" }] : validate2(ct, el);
+    const doc = lerXml(`<w xmlns="${NFE_NS}">${serializar(ct, nome, value, NFE_NS)}</w>`);
+    const el = primeiroFilho(doc.raiz, nome, NFE_NS);
+    const erros = el === undefined ? [{ caminho: "", code: "modelo_de_conteudo", mensagem: "grupo vazio" }] : validar2(ct, el);
     for (const e of erros)
-      issues.add(`${path}${e.path.replace(/^\/[^/]+/, "").replace(/\//g, ".")}`, "schema", `${e.code}: ${e.message}`);
+      issues.add(`${path}${e.caminho.replace(/^\/[^/]+/, "").replace(/\//g, ".")}`, "schema", `${e.code}: ${e.mensagem}`);
     return erros.length > 0;
   } catch (e) {
     issues.add(path, "schema", `grupo malformado: ${e.message}`);
@@ -809,9 +817,9 @@ class Ctx {
       this.issues.add(path, "decimal_invalido", "número decimal inválido (use ponto como separador, sem milhar)");
       return;
     }
-    const problem = formatProblem(d, format);
+    const problem = problemaDeFormato(d, format);
     if (problem !== undefined) {
-      this.issues.add(path, "decimal_invalido", `${problem} (${format.name})`);
+      this.issues.add(path, "decimal_invalido", `${problem} (${format.nome})`);
       return;
     }
     return d;
@@ -842,14 +850,14 @@ class Ctx {
     return g;
   }
   s(value, format) {
-    return formatDecimal(value, format);
+    return formatarDecimal(value, format);
   }
   so(value, format) {
     if (value === undefined)
       return;
-    if (format.nonZero && value.isZero())
+    if (format.naoNulo && value.isZero())
       return;
-    return formatDecimal(value, format);
+    return formatarDecimal(value, format);
   }
 }
 function clean(o) {
@@ -1362,17 +1370,17 @@ function buildIcms(ctx, input, base, path) {
 }
 
 // packages/nfe/src/build/nfce.ts
-import { tpAmbOf } from "@sinete/core";
-import { base64Encode, c14n, firstChild as firstChild2, parseXml as parseXml2, SHA1_DIGEST_INFO_PREFIX } from "@sinete/core/xml";
-import { parseCnpj as parseCnpj2 } from "@sinete/validators";
+import { tpAmbDoAmbiente } from "@sinete/core";
+import { c14n, codificarBase64, lerXml as lerXml2, PREFIXO_DIGEST_INFO_SHA1, primeiroFilho as primeiroFilho2 } from "@sinete/core/xml";
+import { lerCnpj as lerCnpj2 } from "@sinete/validators";
 // packages/nfe/src/data/nfce-urls.json
 var nfce_urls_default = {
-  descricao: "Endereços da NFC-e (modelo 65) por UF e ambiente: a consulta via QR Code (1ª parte da URL do infNFeSupl/qrCode, sem o '?p=' que o builder acrescenta) e a consulta por chave de acesso (infNFeSupl/urlChave, impressa no DANFC-e). Cada UF tem uma lista de endereços com a data de início ('desde', AAAA-MM-DD, 00:00 de Brasília); vale o mais recente cujo início não passou da data de emissão. As tabelas do ENCAT foram transcritas como publicadas, com três ajustes: o '?' final e o exemplo de parâmetros (AM: '?chNFe=1315....') foram retirados, porque o builder monta a query; o espaço dentro do endereço de homologação do MA ('homolog acao') foi juntado; e o endereço de MG por chave de acesso vem da página de web services da própria SEFAZ-MG, mais nova que a do ENCAT. Onde a tabela não dá o protocolo ('http://' ou 'https://'), a URL do QR Code fica null: o schema exige o protocolo e não há fonte para escolher um; informe BuildNfeOptions.urlQrCode. A regra ZX02-20 (rejeição 395) compara o endereço sem diferenciar maiúsculas e minúsculas; ZX03-20 (rejeição 878) é opcional por UF.",
+  descricao: "Endereços da NFC-e (modelo 65) por UF e ambiente: a consulta via QR Code (1ª parte da URL do infNFeSupl/qrCode, sem o '?p=' que o builder acrescenta) e a consulta por chave de acesso (infNFeSupl/urlChave, impressa no DANFC-e). Cada UF tem uma lista de endereços com a data de início ('desde', AAAA-MM-DD, 00:00 de Brasília); vale o mais recente cujo início não passou da data de emissão. As tabelas do ENCAT foram transcritas como publicadas, com três ajustes: o '?' final e o exemplo de parâmetros (AM: '?chNFe=1315....') foram retirados, porque o builder monta a query; o espaço dentro do endereço de homologação do MA ('homolog acao') foi juntado; e o endereço de MG por chave de acesso vem da página de web services da própria SEFAZ-MG, mais nova que a do ENCAT. Onde a tabela não dá o protocolo ('http://' ou 'https://'), a URL do QR Code fica null: o schema exige o protocolo e não há fonte para escolher um; informe MontarNfeOpcoes.urlQrCode. A regra ZX02-20 (rejeição 395) compara o endereço sem diferenciar maiúsculas e minúsculas; ZX03-20 (rejeição 878) é opcional por UF.",
   atualizadoEm: "2026-09-26",
   fontes: [
     "Portal Nacional da NFC-e (ENCAT), URL por UF utilizada QR code: https://nfce.encat.org/desenvolvedor/qrcode/ (coletada em 26/09/2026)",
     "Portal Nacional da NFC-e (ENCAT), URL por UF utilizada para consulta chave, QR Code versão 2.0: https://nfce.encat.org/desenvolvedor/httpnfce-encat-orgconsulte-sua-nota-qr-code-versao-2-0/ (coletada em 26/09/2026)",
-    "SEFAZ-MG, web services da NFC-e: https://portalsped.fazenda.mg.gov.br/spedmg/nfce/web-services/ (a mesma fonte do nfceConsultaUrls do @sinete/transport) (coletada em 26/09/2026)",
+    "SEFAZ-MG, web services da NFC-e: https://portalsped.fazenda.mg.gov.br/spedmg/nfce/web-services/ (a mesma fonte do urlsConsultaNfce do @sinete/transport) (coletada em 26/09/2026)",
     "MOC 7.0 Anexo I, regras ZX02-20 e ZX03-20; NT 2025.001 v1.03, grupo ZX (campos ZX02 qrCode e ZX03 urlChave)"
   ],
   qrCode: {
@@ -1558,11 +1566,11 @@ async function sha1(bytes) {
 }
 var hex = (b) => Array.from(b, (x) => x.toString(16).padStart(2, "0")).join("");
 async function digValHex(xml) {
-  const doc = parseXml2(xml);
-  const inf = firstChild2(doc.root, "infNFe", NFE_NS2);
+  const doc = lerXml2(xml);
+  const inf = primeiroFilho2(doc.raiz, "infNFe", NFE_NS2);
   if (inf === undefined)
     throw new Error("NF-e montada sem infNFe");
-  return hexDoDigestValue(base64Encode(await sha1(te.encode(c14n(inf)))));
+  return hexDoDigestValue(codificarBase64(await sha1(te.encode(c14n(inf)))));
 }
 function hexDoDigestValue(digestValue) {
   return hex(te.encode(digestValue));
@@ -1571,7 +1579,7 @@ async function hashQrCodeV2(parametros, csc) {
   return hex(await sha1(te.encode(parametros + csc))).toUpperCase();
 }
 async function parametrosQrCode(d, qr) {
-  const tpAmb = tpAmbOf(d.ambiente);
+  const tpAmb = tpAmbDoAmbiente(d.ambiente);
   const offline = d.tpEmis === "9";
   const dia = d.dhEmi.slice(8, 10);
   if (qr.versao === "3") {
@@ -1587,13 +1595,13 @@ async function parametrosQrCode(d, qr) {
 }
 async function assinarParametros(parametros, signer) {
   const bytes = te.encode(parametros);
-  if (signer.kind === "data")
-    return base64Encode(await signer.sign(bytes, "SHA-1"));
+  if (signer.tipo === "dados")
+    return codificarBase64(await signer.assinar(bytes, "SHA-1"));
   const h = await sha1(bytes);
-  const di = new Uint8Array(SHA1_DIGEST_INFO_PREFIX.length + h.length);
-  di.set(SHA1_DIGEST_INFO_PREFIX);
-  di.set(h, SHA1_DIGEST_INFO_PREFIX.length);
-  return base64Encode(await signer.signDigestInfo(di));
+  const di = new Uint8Array(PREFIXO_DIGEST_INFO_SHA1.length + h.length);
+  di.set(PREFIXO_DIGEST_INFO_SHA1);
+  di.set(h, PREFIXO_DIGEST_INFO_SHA1.length);
+  return codificarBase64(await signer.assinarDigestInfo(di));
 }
 var CFOP_ISSQN = "5933";
 var NFCE_LIMITE_SEM_DESTINATARIO = "10000.00";
@@ -1761,17 +1769,17 @@ function pagamentoNfce(pag, vNF, issues) {
       issues.add(path, "campo_obrigatorio", "cartão integrado à automação (tpIntegra 1) informa o CNPJ da credenciadora e o cAut (NT 2025.001, YA05-10, rejeição 392)");
     }
     if (c.CNPJ !== undefined) {
-      const r = parseCnpj2(c.CNPJ, { path: `${path}.CNPJ` });
+      const r = lerCnpj2(c.CNPJ, { caminho: `${path}.CNPJ` });
       if (!r.ok)
-        issues.list.push(r.error);
+        issues.list.push(r.erro);
     }
   });
 }
 var digitos2 = (s) => s.replace(/[^0-9A-Za-z]/g, "").toUpperCase();
 
 // packages/nfe/src/build/pl.ts
-import { UnsupportedError } from "@sinete/core";
-import { isComplexType, isElementParticle, isWildcard, selecionarPl } from "@sinete/schemas";
+import { ErroNaoSuportado } from "@sinete/core";
+import { ehComplexType, ehElementParticle, ehWildcard, selecionarPl } from "@sinete/schemas";
 import { TNFe_infNFe as Inf010e } from "@sinete/schemas/nfe/PL_010e";
 import { TNFe_infNFe as Inf010f } from "@sinete/schemas/nfe/PL_010f";
 var INF_NFE = {
@@ -1782,14 +1790,14 @@ function escolherPl(ambiente, emissao) {
   const vigencia = selecionarPl("nfe", ambiente, emissao);
   const infNFe = INF_NFE[vigencia.modulo];
   if (infNFe === undefined) {
-    throw new UnsupportedError(`@sinete/nfe não conhece o módulo ${vigencia.modulo}; atualize o pacote`);
+    throw new ErroNaoSuportado(`@sinete/nfe não conhece o módulo ${vigencia.modulo}; atualize o pacote`);
   }
   return { vigencia, infNFe };
 }
 function memberNames(p, acc) {
-  if (isWildcard(p))
+  if (ehWildcard(p))
     acc.add("$any");
-  else if (isElementParticle(p))
+  else if (ehElementParticle(p))
     acc.add(p.e);
   else
     for (const i of p.i)
@@ -1797,10 +1805,10 @@ function memberNames(p, acc) {
   return acc;
 }
 function elementTypes(p, acc) {
-  if (isWildcard(p))
+  if (ehWildcard(p))
     return acc;
-  if (isElementParticle(p)) {
-    if (isComplexType(p.t))
+  if (ehElementParticle(p)) {
+    if (ehComplexType(p.t))
       acc.set(p.e, p.t);
   } else
     for (const i of p.i)
@@ -1867,7 +1875,7 @@ function cstComIsento(input, idDest, issues) {
     issues.add(`itens[${n}].impostos.icms.CST`, "combinacao_invalida", `CST ${cst} não se usa com destinatário contribuinte isento de IE (indIEDest 2) (N12-80, rejeição 529)`);
   });
 }
-var dataNoFuso = (instante, offsetMinutes) => formatDh(instante, offsetMinutes).slice(0, 10);
+var dataNoFuso = (instante, offsetMinutes) => formatarDh(instante, offsetMinutes).slice(0, 10);
 var OFFSET_BRASILIA = -180;
 function vencimentos(input, emissao, issues) {
   const dups = input.cobranca?.duplicatas;
@@ -1890,9 +1898,9 @@ function conferirEmitenteDoCertificado(nfe, titular) {
     if (base !== soDocumento(titular.cnpj).slice(0, 8)) {
       return [
         {
-          path: "emitente.CNPJ",
+          caminho: "emitente.CNPJ",
           code: "emitente_difere_do_certificado",
-          message: `CNPJ-base ${base} do emitente difere do CNPJ-base do certificado (F03, rejeição 213)`,
+          mensagem: `CNPJ-base ${base} do emitente difere do CNPJ-base do certificado (F03, rejeição 213)`,
           origem: "entrada"
         }
       ];
@@ -1901,9 +1909,9 @@ function conferirEmitenteDoCertificado(nfe, titular) {
   if (e.CPF !== undefined && titular.cpf !== undefined && soDocumento(e.CPF) !== soDocumento(titular.cpf)) {
     return [
       {
-        path: "emitente.CPF",
+        caminho: "emitente.CPF",
         code: "emitente_difere_do_certificado",
-        message: "CPF do emitente difere do CPF do certificado (F03A, rejeição 227)",
+        mensagem: "CPF do emitente difere do CPF do certificado (F03A, rejeição 227)",
         origem: "entrada"
       }
     ];
@@ -1911,6 +1919,192 @@ function conferirEmitenteDoCertificado(nfe, titular) {
   return [];
 }
 
+// packages/nfe/src/build/textos.ts
+import { conferirTipoSimples, ehComplexType as ehComplexType2, ehElementParticle as ehElementParticle2, ehWildcard as ehWildcard2 } from "@sinete/schemas";
+function textoXmlValido(texto) {
+  for (const ch of texto) {
+    const c = ch.codePointAt(0) ?? 0;
+    const ok = c === 9 || c === 10 || c === 13 || c >= 32 && c <= 55295 || c >= 57344 && c <= 65533 || c >= 65536 && c <= 1114111;
+    if (!ok)
+      return false;
+  }
+  return true;
+}
+var CAMPOS = [
+  ["natOp", "ide.natOp"],
+  ["emitente.xNome", "emit.xNome"],
+  ["emitente.xFant", "emit.xFant"],
+  ["emitente.endereco.xLgr", "emit.enderEmit.xLgr"],
+  ["emitente.endereco.nro", "emit.enderEmit.nro"],
+  ["emitente.endereco.xCpl", "emit.enderEmit.xCpl"],
+  ["emitente.endereco.xBairro", "emit.enderEmit.xBairro"],
+  ["emitente.endereco.xMun", "emit.enderEmit.xMun"],
+  ["destinatario.xNome", "dest.xNome"],
+  ["destinatario.email", "dest.email"],
+  ["destinatario.endereco.xLgr", "dest.enderDest.xLgr"],
+  ["destinatario.endereco.nro", "dest.enderDest.nro"],
+  ["destinatario.endereco.xCpl", "dest.enderDest.xCpl"],
+  ["destinatario.endereco.xBairro", "dest.enderDest.xBairro"],
+  ["destinatario.endereco.xMun", "dest.enderDest.xMun"],
+  ["destinatario.endereco.xPais", "dest.enderDest.xPais"],
+  ...["retirada", "entrega"].flatMap((g) => ["xNome", "xLgr", "nro", "xCpl", "xBairro", "xMun", "email"].map((c) => [`${g}.${c}`, `${g}.${c}`])),
+  ["itens[].produto.cProd", "det.prod.cProd"],
+  ["itens[].produto.xProd", "det.prod.xProd"],
+  ["itens[].produto.uCom", "det.prod.uCom"],
+  ["itens[].produto.uTrib", "det.prod.uTrib"],
+  ["itens[].produto.xPed", "det.prod.xPed"],
+  ["itens[].infAdProd", "det.infAdProd"],
+  ["transporte.transportador.xNome", "transp.transporta.xNome"],
+  ["transporte.transportador.xEnder", "transp.transporta.xEnder"],
+  ["transporte.transportador.xMun", "transp.transporta.xMun"],
+  ["transporte.volumes[].esp", "transp.vol.esp"],
+  ["transporte.volumes[].marca", "transp.vol.marca"],
+  ["transporte.volumes[].nVol", "transp.vol.nVol"],
+  ["cobranca.fatura.nFat", "cobr.fat.nFat"],
+  ["cobranca.duplicatas[].nDup", "cobr.dup.nDup"],
+  ["pagamento.detPag[].xPag", "pag.detPag.xPag"],
+  ["informacoesAdicionais.infAdFisco", "infAdic.infAdFisco"],
+  ["informacoesAdicionais.infCpl", "infAdic.infCpl"],
+  ["informacoesAdicionais.obsCont[].xTexto", "infAdic.obsCont.xTexto"],
+  ["informacoesAdicionais.obsFisco[].xTexto", "infAdic.obsFisco.xTexto"],
+  ["compra.xNEmp", "compra.xNEmp"],
+  ["compra.xPed", "compra.xPed"],
+  ["compra.xCont", "compra.xCont"]
+];
+function elemento(p, nome) {
+  if (p === undefined || ehWildcard2(p))
+    return;
+  if (ehElementParticle2(p))
+    return p.e === nome ? p.t : undefined;
+  for (const i of p.i) {
+    const t = elemento(i, nome);
+    if (t !== undefined)
+      return t;
+  }
+  return;
+}
+function tipoEm(infNFe, caminho) {
+  let t = infNFe;
+  for (const nome of caminho.split(".")) {
+    if (t === undefined || !ehComplexType2(t))
+      return;
+    t = elemento(t.c, nome);
+  }
+  return t === undefined || ehComplexType2(t) ? undefined : t;
+}
+var tiposPorPl = new WeakMap;
+function tiposDoPl(infNFe) {
+  let m = tiposPorPl.get(infNFe);
+  if (m === undefined) {
+    const novo = new Map;
+    for (const [entrada, xml] of CAMPOS) {
+      const t = tipoEm(infNFe, xml);
+      if (t !== undefined)
+        novo.set(entrada, t);
+    }
+    m = novo;
+    tiposPorPl.set(infNFe, m);
+  }
+  return m;
+}
+function valoresEm(raiz, caminho) {
+  let atuais = [["", raiz]];
+  for (const parte of caminho.split(".")) {
+    const lista = parte.endsWith("[]");
+    const chave = lista ? parte.slice(0, -2) : parte;
+    const proximos = [];
+    for (const [c, v] of atuais) {
+      if (typeof v !== "object" || v === null)
+        continue;
+      const filho = v[chave];
+      const base = c === "" ? chave : `${c}.${chave}`;
+      if (!lista)
+        proximos.push([base, filho]);
+      else if (Array.isArray(filho))
+        for (const [n, f] of filho.entries())
+          proximos.push([`${base}[${n}]`, f]);
+    }
+    atuais = proximos;
+  }
+  return atuais;
+}
+function textosForaDoXml(valor, caminho, saida) {
+  if (typeof valor === "string") {
+    if (!textoXmlValido(valor))
+      saida.push(caminho);
+  } else if (Array.isArray(valor)) {
+    for (const [n, v] of valor.entries())
+      textosForaDoXml(v, `${caminho}[${n}]`, saida);
+  } else if (typeof valor === "object" && valor !== null) {
+    for (const [k, v] of Object.entries(valor))
+      textosForaDoXml(v, caminho === "" ? k : `${caminho}.${k}`, saida);
+  }
+}
+var CARACTERE_INVISIVEL = "caractere não aceito (símbolo ou caractere de controle)";
+var VISIVEL = /^[\p{L}\p{M}\p{N}\p{P}\p{S}]$/u;
+function caractereRecusado(tipo, valor) {
+  for (const ch of new Set(valor)) {
+    const saida = [];
+    conferirTipoSimples(tipo, `A${ch}A`, "", saida);
+    if (saida.some((o) => o.code === "padrao"))
+      return ch;
+  }
+  return;
+}
+function mensagensDoTexto(tipo, valor, violadas) {
+  if (violadas.length === 0)
+    return [];
+  if (valor.trim() === "")
+    return ["não pode ficar em branco"];
+  const tamanho = [...valor].length;
+  const mensagens = new Set;
+  for (const o of violadas) {
+    if (o.code === "tamanho_maximo" && tipo.mx !== undefined)
+      mensagens.add(`no máximo ${tipo.mx} caracteres (tem ${tamanho})`);
+    else if (o.code === "tamanho_minimo" && tipo.mn !== undefined)
+      mensagens.add(`no mínimo ${tipo.mn} caracteres (tem ${tamanho})`);
+    else if (o.code === "tamanho" && tipo.l !== undefined)
+      mensagens.add(`exatamente ${tipo.l} caracteres (tem ${tamanho})`);
+    else if (o.code === "padrao") {
+      const espaco = valor !== valor.trim();
+      const ch = caractereRecusado(tipo, valor);
+      if (espaco)
+        mensagens.add("sem espaço no começo nem no fim");
+      if (ch !== undefined)
+        mensagens.add(VISIVEL.test(ch) ? `caractere não aceito: “${ch}”` : CARACTERE_INVISIVEL);
+      if (!espaco && ch === undefined)
+        mensagens.add("formato não aceito");
+    } else
+      mensagens.add("valor não aceito neste campo");
+  }
+  return [...mensagens];
+}
+function conferirTextosDaEntrada(entrada, infNFe, issues, substituidos = new Set) {
+  const jaRecusados = new Set(issues.list.map((i) => i.caminho));
+  const foraDoXml = [];
+  textosForaDoXml(entrada, "", foraDoXml);
+  for (const c of foraDoXml) {
+    if (jaRecusados.has(c) || substituidos.has(c))
+      continue;
+    issues.add(c, "campo_invalido", CARACTERE_INVISIVEL);
+    jaRecusados.add(c);
+  }
+  const tipos = tiposDoPl(infNFe);
+  for (const [campo] of CAMPOS) {
+    const tipo = tipos.get(campo);
+    if (tipo === undefined)
+      continue;
+    for (const [caminho, valor] of valoresEm(entrada, campo)) {
+      if (typeof valor !== "string" || jaRecusados.has(caminho) || substituidos.has(caminho))
+        continue;
+      const saida = [];
+      conferirTipoSimples(tipo, valor, caminho, saida);
+      for (const m of mensagensDoTexto(tipo, valor, saida))
+        issues.add(caminho, "campo_invalido", m);
+    }
+  }
+}
+
 // packages/nfe/src/build/tributos.ts
 function buildIpi(ctx, input, vOp, path) {
   const head = {
@@ -2058,7 +2252,7 @@ function buildIcmsUfDest(ctx, input, path) {
 // packages/nfe/src/build/build.ts
 var padrao;
 function calculadoraPadrao() {
-  padrao ??= ibsCbsCalculator();
+  padrao ??= calculadoraIbsCbs();
   return padrao;
 }
 var NFE_NS3 = "http://www.portalfiscal.inf.br/nfe";
@@ -2068,7 +2262,7 @@ var MODES = Object.fromEntries(Object.entries(arredondamento_default.familias).m
 var SEM_GTIN = "SEM GTIN";
 var BRASILIA = -180;
 function diaBrasilia(d) {
-  return formatDh(d, BRASILIA).slice(0, 10);
+  return formatarDh(d, BRASILIA).slice(0, 10);
 }
 function exigenciaRespTec(uf, ambiente, data) {
   const dia = diaBrasilia(data);
@@ -2087,29 +2281,29 @@ function exigenciaRespTec(uf, ambiente, data) {
 }
 async function hashCsrt(csrt, chave) {
   const d = await globalThis.crypto.subtle.digest("SHA-1", new TextEncoder().encode(csrt + chave));
-  return base64Encode2(new Uint8Array(d));
+  return codificarBase642(new Uint8Array(d));
 }
 function documento(doc, path, issues) {
   if (doc.CNPJ !== undefined) {
-    const r = parseCnpj3(doc.CNPJ, { path: `${path}.CNPJ` });
+    const r = lerCnpj3(doc.CNPJ, { caminho: `${path}.CNPJ` });
     if (!r.ok)
-      issues.list.push(r.error);
-    return { CNPJ: r.ok ? r.value : doc.CNPJ };
+      issues.list.push(r.erro);
+    return { CNPJ: r.ok ? r.valor : doc.CNPJ };
   }
-  const r = parseCpf(doc.CPF ?? "", { path: `${path}.CPF` });
+  const r = lerCpf(doc.CPF ?? "", { caminho: `${path}.CPF` });
   if (!r.ok)
-    issues.list.push(r.error);
-  return { CPF: r.ok ? r.value : doc.CPF ?? "" };
+    issues.list.push(r.erro);
+  return { CPF: r.ok ? r.valor : doc.CPF ?? "" };
 }
 function ie(value, uf, path, issues, allowIsento) {
   if (value === undefined)
     return;
-  const r = parseIe(value, uf, { path, allowIsento });
+  const r = lerIe(value, uf, { caminho: path, aceitarIsento: allowIsento });
   if (!r.ok) {
-    issues.list.push(r.error);
+    issues.list.push(r.erro);
     return value;
   }
-  return r.value.value;
+  return r.valor.valor;
 }
 function endereco(e) {
   return {
@@ -2129,9 +2323,9 @@ function isExterior(e) {
 }
 function gerarChave(parts, cNFInformado, random, issues) {
   const tentar = (cNF) => {
-    const chave = buildChaveAcesso({ ...parts, cNF });
-    const r = parseChaveAcesso(chave, { emissao: true, path: "chave" });
-    return r.ok ? { chave, ok: true } : { chave, ok: false, issue: r.error };
+    const chave = montarChaveAcesso({ ...parts, cNF });
+    const r = lerChaveAcesso(chave, { emissao: true, caminho: "chave" });
+    return r.ok ? { chave, ok: true } : { chave, ok: false, issue: r.erro };
   };
   if (cNFInformado !== undefined) {
     if (!/^\d{8}$/.test(cNFInformado)) {
@@ -2143,9 +2337,9 @@ function gerarChave(parts, cNFInformado, random, issues) {
       const doCnf = r.issue.code === "chave_cnf_invalido";
       issues.list.push({
         ...r.issue,
-        path: doCnf ? "cNF" : r.issue.path,
+        caminho: doCnf ? "cNF" : r.issue.caminho,
         code: "chave_invalida",
-        message: `${r.issue.message} (${r.issue.code})`,
+        mensagem: `${r.issue.mensagem} (${r.issue.code})`,
         origem: doCnf ? "entrada" : "montagem"
       });
     }
@@ -2162,7 +2356,7 @@ function gerarChave(parts, cNFInformado, random, issues) {
       issues.list.push({
         ...r.issue,
         code: "chave_invalida",
-        message: `${r.issue.message} (${r.issue.code})`,
+        mensagem: `${r.issue.mensagem} (${r.issue.code})`,
         origem: "montagem"
       });
       return;
@@ -2173,10 +2367,10 @@ function gerarChave(parts, cNFInformado, random, issues) {
 }
 function referencia(ref, path, issues) {
   const chave = (c, p) => {
-    const r = parseChaveAcesso(c, { path: p });
+    const r = lerChaveAcesso(c, { caminho: p });
     if (!r.ok)
-      issues.list.push(r.error);
-    return r.ok ? r.value.chave : c;
+      issues.list.push(r.erro);
+    return r.ok ? r.valor.chave : c;
   };
   if ("refNFe" in ref)
     return { refNFe: chave(ref.refNFe, `${path}.refNFe`) };
@@ -2196,7 +2390,7 @@ function referencia(ref, path, issues) {
   const nfp = ref.refNFP;
   if (nfp.mod === "04") {
     const porUf = produtor_rural_default.refNFP.ufs;
-    const cUfSigla = Object.keys(porUf).find((k) => ufBySigla2(k)?.cUF === nfp.cUF);
+    const cUfSigla = Object.keys(porUf).find((k) => ufPorSigla2(k)?.cUF === nfp.cUF);
     const vedadaDesde = cUfSigla ? porUf[cUfSigla]?.vedadaDesde ?? "" : produtor_rural_default.refNFP.modelo04.vedadaDesde;
     if (nfp.AAMM >= vedadaDesde) {
       issues.add(`${path}.refNFP.AAMM`, "referencia_vedada", `nota de produtor modelo 04 emitida em ${nfp.AAMM}, depois do fim do modelo (${vedadaDesde}; ${produtor_rural_default.refNFP.modelo04.fonte})`);
@@ -2215,25 +2409,16 @@ function referencia(ref, path, issues) {
     }
   };
 }
-function textoXmlValido(texto) {
-  for (const ch of texto) {
-    const c = ch.codePointAt(0) ?? 0;
-    const ok = c === 9 || c === 10 || c === 13 || c >= 32 && c <= 55295 || c >= 57344 && c <= 65533 || c >= 65536 && c <= 1114111;
-    if (!ok)
-      return false;
-  }
-  return true;
-}
-function textosForaDoXml(value, path, issues) {
+function textosForaDoXml2(value, path, issues) {
   if (typeof value === "string") {
     if (!textoXmlValido(value))
       issues.montagem(path, "campo_invalido", "texto com caractere não permitido em XML");
   } else if (Array.isArray(value)) {
     for (const [n, v] of value.entries())
-      textosForaDoXml(v, `${path}[${n}]`, issues);
+      textosForaDoXml2(v, `${path}[${n}]`, issues);
   } else if (typeof value === "object" && value !== null) {
     for (const [k, v] of Object.entries(value))
-      textosForaDoXml(v, `${path}.${k}`, issues);
+      textosForaDoXml2(v, `${path}.${k}`, issues);
   }
 }
 function montarItem(ctx, item, n, normal) {
@@ -2415,11 +2600,11 @@ function montarItem(ctx, item, n, normal) {
   if (item.obsItem !== undefined)
     det.obsItem = item.obsItem;
   if (item.DFeReferenciado !== undefined) {
-    const r = parseChaveAcesso(item.DFeReferenciado.chaveAcesso, { path: `${path}.DFeReferenciado.chaveAcesso` });
+    const r = lerChaveAcesso(item.DFeReferenciado.chaveAcesso, { caminho: `${path}.DFeReferenciado.chaveAcesso` });
     if (!r.ok)
-      ctx.issues.list.push(r.error);
+      ctx.issues.list.push(r.erro);
     det.DFeReferenciado = clean({
-      chaveAcesso: r.ok ? r.value.chave : item.DFeReferenciado.chaveAcesso,
+      chaveAcesso: r.ok ? r.valor.chave : item.DFeReferenciado.chaveAcesso,
       nItem: item.DFeReferenciado.nItem === undefined ? undefined : String(item.DFeReferenciado.nItem)
     });
   }
@@ -2443,36 +2628,36 @@ function composicao(m, incluirProd) {
   }
   return total;
 }
-async function buildNfe(input, options) {
+async function montarNfe(entrada, opcoes) {
   const issues = new Issues;
-  const finNFeIn = input.finNFe ?? "1";
-  const mod = input.modelo ?? "55";
+  const finNFeIn = entrada.finNFe ?? "1";
+  const mod = entrada.modelo ?? "55";
   if (mod !== "55" && mod !== "65") {
     issues.add("modelo", "modelo_nao_suportado", `modelo ${String(mod)}: o builder monta NF-e (55) e NFC-e (65)`);
-    return { ok: false, issues: issues.classificadas };
+    return { ok: false, ocorrencias: issues.classificadas };
   }
   const nfce = mod === "65";
-  const indPres = input.indPres ?? (nfce ? "1" : finNFeIn === "2" || finNFeIn === "3" ? "0" : "9");
-  const indFinal = input.indFinal ?? (nfce || input.destinatario?.indIEDest === "9" ? "1" : "0");
-  const ctx = new Ctx(issues, { ...MODES, ...options.arredondamento }, finNFeIn !== "2" && finNFeIn !== "3");
-  const pRedutorGov = input.gCompraGov && ctx.req(input.gCompraGov.pRedutor, "gCompraGov.pRedutor", D0302A04);
-  const emitUf = input.emitente.endereco.UF;
-  if (!isUf2(emitUf)) {
+  const indPres = entrada.indPres ?? (nfce ? "1" : finNFeIn === "2" || finNFeIn === "3" ? "0" : "9");
+  const indFinal = entrada.indFinal ?? (nfce || entrada.destinatario?.indIEDest === "9" ? "1" : "0");
+  const ctx = new Ctx(issues, { ...MODES, ...opcoes.arredondamento }, finNFeIn !== "2" && finNFeIn !== "3");
+  const pRedutorGov = entrada.gCompraGov && ctx.req(entrada.gCompraGov.pRedutor, "gCompraGov.pRedutor", D0302A04);
+  const emitUf = entrada.emitente.endereco.UF;
+  if (!ehUf2(emitUf)) {
     issues.add("emitente.endereco.UF", "campo_invalido", "UF do emitente inválida");
-    return { ok: false, issues: issues.classificadas };
+    return { ok: false, ocorrencias: issues.classificadas };
   }
-  const cUF = ufBySigla2(emitUf)?.cUF ?? "";
-  const offset = options.offsetMinutes ?? offsetDaUf(emitUf);
-  const agora = options.time.emissao.now();
-  const fatoGerador = options.time.fatoGerador.now();
-  const dhEmi = formatDh(agora, offset);
+  const cUF = ufPorSigla2(emitUf)?.cUF ?? "";
+  const offset = opcoes.deslocamentoMin ?? deslocamentoDaUf(emitUf);
+  const agora = opcoes.tempo.emissao.agora();
+  const fatoGerador = opcoes.tempo.fatoGerador.agora();
+  const dhEmi = formatarDh(agora, offset);
   const aamm = dhEmi.slice(2, 4) + dhEmi.slice(5, 7);
-  const tpAmb = tpAmbOf2(options.ambiente);
-  const pl = escolherPl(options.ambiente, fixedClock2(agora));
-  const e = input.emitente;
+  const tpAmb = tpAmbDoAmbiente2(opcoes.ambiente);
+  const pl = escolherPl(opcoes.ambiente, relogioFixo2(agora));
+  const e = entrada.emitente;
   const emitDoc = documento(e, "emitente", issues);
-  const serie = Number(input.serie);
-  const nNF = Number(input.nNF);
+  const serie = Number(entrada.serie);
+  const nNF = Number(entrada.nNF);
   if (!Number.isInteger(serie) || serie < 0 || serie > 999)
     issues.add("serie", "serie_invalida", "série de 0 a 999");
   if (!Number.isInteger(nNF) || nNF < 1 || nNF > 999999999)
@@ -2496,7 +2681,7 @@ async function buildNfe(input, options) {
     CRT: e.CRT,
     ISUFEmit: e.ISUFEmit
   });
-  const d = input.destinatario;
+  const d = entrada.destinatario;
   let dest;
   let destUf;
   if (d === undefined) {
@@ -2526,7 +2711,7 @@ async function buildNfe(input, options) {
     const destIe = d.IE !== undefined && destUf !== undefined && destUf !== "EX" ? ie(d.IE, destUf, "destinatario.IE", issues, false) : d.IE;
     dest = clean({
       ...docDest,
-      xNome: options.ambiente === "homologacao" ? XNOME_HOMOLOGACAO : d.xNome,
+      xNome: opcoes.ambiente === "homologacao" ? XNOME_HOMOLOGACAO : d.xNome,
       enderDest,
       indIEDest: d.indIEDest,
       IE: destIe,
@@ -2535,7 +2720,7 @@ async function buildNfe(input, options) {
       email: d.email
     });
   }
-  const cont = input.contingencia;
+  const cont = entrada.contingencia;
   const tpEmis = cont?.tpEmis ?? "1";
   if (cont !== undefined) {
     if (cont.xJust.length < 15 || cont.xJust.length > 256) {
@@ -2551,19 +2736,19 @@ async function buildNfe(input, options) {
       issues.add("contingencia.tpEmis", "contingencia_invalida", "a NFC-e não é autorizada pela SVC; a contingência dela é off-line, tpEmis 9 (B22-70, rejeição 783)");
     }
   }
-  const idDest = input.idDest ?? (nfce ? "1" : destUf === "EX" ? "3" : destUf !== undefined && destUf !== emitUf ? "2" : "1");
-  const tpImp = input.tpImp ?? (nfce ? "4" : "1");
-  conferirDestinatario(input, {
+  const idDest = entrada.idDest ?? (nfce ? "1" : destUf === "EX" ? "3" : destUf !== undefined && destUf !== emitUf ? "2" : "1");
+  const tpImp = entrada.tpImp ?? (nfce ? "4" : "1");
+  conferirDestinatario(entrada, {
     mod,
-    tpNF: input.tpNF,
+    tpNF: entrada.tpNF,
     idDest,
-    idDestInformado: input.idDest !== undefined,
+    idDestInformado: entrada.idDest !== undefined,
     indFinal,
-    producao: options.ambiente === "producao"
+    producao: opcoes.ambiente === "producao"
   }, issues);
   if (nfce) {
-    conferirNfce(input, {
-      tpNF: input.tpNF,
+    conferirNfce(entrada, {
+      tpNF: entrada.tpNF,
       idDest,
       tpImp,
       finNFe: finNFeIn,
@@ -2573,7 +2758,7 @@ async function buildNfe(input, options) {
   } else if (tpImp === "4" || tpImp === "5") {
     issues.add("tpImp", "campo_invalido", "tpImp 4 e 5 (DANFC-e) são da NFC-e (B21-20, rejeição 710)");
   }
-  const qr = options.qrCode ?? { versao: "3" };
+  const qr = opcoes.qrCode ?? { versao: "3" };
   if (nfce && qr.versao === "2") {
     if (!/^\d{1,6}$/.test(qr.idCSC) || Number(qr.idCSC) === 0) {
       issues.montagem("qrCode.idCSC", "qrcode_invalido", "idCSC tem de 1 a 6 algarismos, diferente de zero (Manual do DANFE NFC-e 6.0, 4.6)");
@@ -2585,23 +2770,23 @@ async function buildNfe(input, options) {
       issues.montagem("qrCode.versao", "qrcode_invalido", "emitente pessoa física usa o QR Code versão 3 (NT 2025.001, ZX02-222, rejeição 444)");
     }
   }
-  const random = options.random ?? ((b) => globalThis.crypto.getRandomValues(b));
+  const random = opcoes.aleatorio ?? ((b) => globalThis.crypto.getRandomValues(b));
   const emitente14 = "CNPJ" in emitDoc ? emitDoc.CNPJ : emitDoc.CPF;
-  const gerada = issues.empty ? gerarChave({ cUF, aamm, emitente: emitente14, mod, serie: String(serie), nNF: String(nNF), tpEmis }, input.cNF, random, issues) : undefined;
+  const gerada = issues.empty ? gerarChave({ cUF, aamm, emitente: emitente14, mod, serie: String(serie), nNF: String(nNF), tpEmis }, entrada.cNF, random, issues) : undefined;
   const chave = gerada?.chave ?? "0".repeat(44);
   const cNF = gerada?.cNF ?? "00000000";
   const cDV = chave.slice(43);
-  if (input.itens.length === 0 || input.itens.length > 990) {
+  if (entrada.itens.length === 0 || entrada.itens.length > 990) {
     issues.add("itens", "itens_limite", "a NF-e tem de 1 a 990 itens");
   }
-  const itens = input.itens.map((it, n) => montarItem(ctx, it, n, finNFeIn === "1"));
+  const itens = entrada.itens.map((it, n) => montarItem(ctx, it, n, finNFeIn === "1"));
   const primeiro = itens[0];
-  if (nfce && options.ambiente === "homologacao" && primeiro !== undefined) {
+  if (nfce && opcoes.ambiente === "homologacao" && primeiro !== undefined) {
     primeiro.det.prod.xProd = XPROD_HOMOLOGACAO_NFCE;
   }
-  const classificados = input.itens.map((it, n) => ({ it, n })).filter(({ it }) => it.impostos.ibsCbs?.classificacao !== undefined);
+  const classificados = entrada.itens.map((it, n) => ({ it, n })).filter(({ it }) => it.impostos.ibsCbs?.classificacao !== undefined);
   if (classificados.length > 0) {
-    const calculadora = options.ibsCbs ?? calculadoraPadrao();
+    const calculadora = opcoes.ibsCbs ?? calculadoraPadrao();
     const reqs = classificados.map(({ it, n }) => {
       const c = it.impostos.ibsCbs?.classificacao;
       const m = itens[n];
@@ -2637,23 +2822,23 @@ async function buildNfe(input, options) {
         vFCPUFDest: m.v.vFCPUFDest
       };
     });
-    const destino = input.entrega !== undefined ? { UF: input.entrega.UF, cMun: input.entrega.cMun } : d?.endereco !== undefined ? isExterior(d.endereco) ? { UF: "EX", cMun: "9999999" } : { UF: d.endereco.UF, cMun: d.endereco.cMun } : undefined;
-    const compra = input.gCompraGov;
+    const destino = entrada.entrega !== undefined ? { UF: entrada.entrega.UF, cMun: entrada.entrega.cMun } : d?.endereco !== undefined ? isExterior(d.endereco) ? { UF: "EX", cMun: "9999999" } : { UF: d.endereco.UF, cMun: d.endereco.cMun } : undefined;
+    const compra = entrada.gCompraGov;
     const resp = await calculadora.calcular({
       nota: {
         fatoGerador,
         emissao: agora,
-        ambiente: options.ambiente,
+        ambiente: opcoes.ambiente,
         mod,
-        tpNF: input.tpNF,
+        tpNF: entrada.tpNF,
         finNFe: finNFeIn,
-        ...input.tpNFDebito ? { tpNFDebito: input.tpNFDebito } : {},
-        ...input.tpNFCredito ? { tpNFCredito: input.tpNFCredito } : {},
+        ...entrada.tpNFDebito ? { tpNFDebito: entrada.tpNFDebito } : {},
+        ...entrada.tpNFCredito ? { tpNFCredito: entrada.tpNFCredito } : {},
         indFinal,
         indPres,
         emitente: { UF: emitUf, cMun: e.endereco.cMun, CRT: e.CRT },
         ...destino ? { destino } : {},
-        ...input.cMunFGIBS ? { cMunFGIBS: input.cMunFGIBS } : {},
+        ...entrada.cMunFGIBS ? { cMunFGIBS: entrada.cMunFGIBS } : {},
         ...compra && pRedutorGov ? {
           compraGov: {
             tpEnteGov: compra.tpEnteGov,
@@ -2664,7 +2849,7 @@ async function buildNfe(input, options) {
       },
       itens: reqs
     });
-    issues.addAll(resp.issues ?? [], "montagem");
+    issues.addAll(resp.ocorrencias ?? [], "montagem");
     for (const { n } of classificados) {
       const g = resp.itens.find((x) => x.nItem === n + 1);
       if (g === undefined) {
@@ -2678,7 +2863,7 @@ async function buildNfe(input, options) {
     const imp = m.det.imposto;
     const ib = `itens[${n}].impostos.ibsCbs`;
     const is = `itens[${n}].impostos.is`;
-    const ibsDaCalculadora = input.itens[n]?.impostos.ibsCbs?.grupo === undefined;
+    const ibsDaCalculadora = entrada.itens[n]?.impostos.ibsCbs?.grupo === undefined;
     const antes = issues.list.length;
     decimaisInvalidos(imp.IBSCBS, ib, issues);
     if (ibsDaCalculadora)
@@ -2691,8 +2876,10 @@ async function buildNfe(input, options) {
       grupoInvalido(TISCt, "IS", imp.IS, is, issues);
     }
   });
+  const substituidos = opcoes.ambiente === "homologacao" ? ["destinatario.xNome", ...nfce ? ["itens[0].produto.xProd"] : []] : [];
+  conferirTextosDaEntrada(entrada, pl.infNFe, issues, new Set(substituidos));
   if (!issues.empty)
-    return { ok: false, issues: issues.classificadas };
+    return { ok: false, ocorrencias: issues.classificadas };
   const gruposIbsCbs = itens.map((m) => m.det.imposto.IBSCBS).filter((g) => g !== undefined);
   const somaTributosNoItem = diaBrasilia(fatoGerador) >= reforma_default.vItemSomaTributosDesde;
   let vNFTot = Decimal.ZERO;
@@ -2789,39 +2976,39 @@ async function buildNfe(input, options) {
   const ide = clean({
     cUF,
     cNF,
-    natOp: input.natOp,
+    natOp: entrada.natOp,
     mod,
     serie: String(serie),
     nNF: String(nNF),
     dhEmi,
-    dhSaiEnt: input.dhSaiEnt === undefined ? undefined : formatDh(input.dhSaiEnt, offset),
-    dPrevEntrega: input.dPrevEntrega,
-    tpNF: input.tpNF,
+    dhSaiEnt: entrada.dhSaiEnt === undefined ? undefined : formatarDh(entrada.dhSaiEnt, offset),
+    dPrevEntrega: entrada.dPrevEntrega,
+    tpNF: entrada.tpNF,
     idDest,
-    cMunFG: input.cMunFG ?? e.endereco.cMun,
-    cMunFGIBS: input.cMunFGIBS,
+    cMunFG: entrada.cMunFG ?? e.endereco.cMun,
+    cMunFGIBS: entrada.cMunFGIBS,
     tpImp,
     tpEmis,
     cDV,
     tpAmb,
     finNFe,
-    tpNFDebito: input.tpNFDebito,
-    tpNFCredito: input.tpNFCredito,
+    tpNFDebito: entrada.tpNFDebito,
+    tpNFCredito: entrada.tpNFCredito,
     indFinal,
     indPres,
-    indIntermed: input.indIntermed ?? (["2", "3", "4", "9"].includes(indPres) ? "0" : undefined),
+    indIntermed: entrada.indIntermed ?? (["2", "3", "4", "9"].includes(indPres) ? "0" : undefined),
     procEmi: "0",
-    verProc: options.verProc ?? formatarVerProc("sinete", VERSAO_PACOTE),
-    dhCont: cont === undefined ? undefined : formatDh(cont.dhCont, offset),
+    verProc: opcoes.verProc ?? formatarVerProc("sinete", VERSAO_PACOTE),
+    dhCont: cont === undefined ? undefined : formatarDh(cont.dhCont, offset),
     xJust: cont?.xJust,
-    NFref: input.referenciadas?.map((r, n) => referencia(r, `referenciadas[${n}]`, issues)),
-    gCompraGov: input.gCompraGov === undefined ? undefined : clean({
-      tpEnteGov: input.gCompraGov.tpEnteGov,
+    NFref: entrada.referenciadas?.map((r, n) => referencia(r, `referenciadas[${n}]`, issues)),
+    gCompraGov: entrada.gCompraGov === undefined ? undefined : clean({
+      tpEnteGov: entrada.gCompraGov.tpEnteGov,
       pRedutor: ctx.s(pRedutorGov ?? Decimal.ZERO, D0302A04),
-      tpOperGov: input.gCompraGov.tpOperGov,
-      refDFeAnt: input.gCompraGov.refDFeAnt
+      tpOperGov: entrada.gCompraGov.tpOperGov,
+      refDFeAnt: entrada.gCompraGov.refDFeAnt
     }),
-    gPagAntecipado: input.gPagAntecipado === undefined ? undefined : { refNFe: [...input.gPagAntecipado] }
+    gPagAntecipado: entrada.gPagAntecipado === undefined ? undefined : { refNFe: [...entrada.gPagAntecipado] }
   });
   const local = (l, path) => l === undefined ? undefined : clean({
     ...documento(l, path, issues),
@@ -2832,10 +3019,10 @@ async function buildNfe(input, options) {
     email: l.email,
     IE: l.IE
   });
-  if ((input.autXML?.length ?? 0) > 10)
+  if ((entrada.autXML?.length ?? 0) > 10)
     issues.add("autXML", "campo_invalido", "no máximo 10 autorizados");
-  const autXML = input.autXML?.map((a, n) => documento(a, `autXML[${n}]`, issues));
-  const tr = input.transporte;
+  const autXML = entrada.autXML?.map((a, n) => documento(a, `autXML[${n}]`, issues));
+  const tr = entrada.transporte;
   const transp = { modFrete: tr?.modFrete ?? "9" };
   if (tr?.transportador !== undefined) {
     const t = tr.transportador;
@@ -2876,8 +3063,8 @@ async function buildNfe(input, options) {
     }));
   }
   let cobr;
-  if (input.cobranca !== undefined) {
-    const c = input.cobranca;
+  if (entrada.cobranca !== undefined) {
+    const c = entrada.cobranca;
     cobr = {};
     if (c.fatura !== undefined) {
       const f = c.fatura;
@@ -2901,10 +3088,10 @@ async function buildNfe(input, options) {
       }));
     }
   }
-  const pagIn = input.pagamento ?? { detPag: [{ tPag: "90", vPag: "0" }] };
-  const igualTotal = options.pagamentoIgualTotal === true;
+  const pagIn = entrada.pagamento ?? { detPag: [{ tPag: "90", vPag: "0" }] };
+  const igualTotal = opcoes.pagamentoIgualTotal === true;
   if (igualTotal) {
-    const unico = input.pagamento?.detPag.length === 1 ? input.pagamento.detPag[0] : undefined;
+    const unico = entrada.pagamento?.detPag.length === 1 ? entrada.pagamento.detPag[0] : undefined;
     if (unico === undefined) {
       issues.add("pagamento.detPag", "pagamento_igual_total", "pagamentoIgualTotal pede exatamente um detPag");
     } else if (unico.tPag === "90") {
@@ -2924,13 +3111,13 @@ async function buildNfe(input, options) {
     })),
     vTroco: ctx.so(ctx.opt(pagIn.vTroco, "pagamento.vTroco", D1302), D1302)
   });
-  if (nfce && input.pagamento !== undefined && input.pagamento.detPag.length > 0 && issues.empty) {
+  if (nfce && entrada.pagamento !== undefined && entrada.pagamento.detPag.length > 0 && issues.empty) {
     pagamentoNfce(pag, vNF, issues);
   }
   if (nfce && vNF.gt(Decimal.of(NFCE_LIMITE_SEM_DESTINATARIO)) && dest === undefined) {
     issues.add("destinatario", "campo_obrigatorio", `NFC-e acima de R$ ${NFCE_LIMITE_SEM_DESTINATARIO} identifica o destinatário (W16-40, rejeição 750)`);
   }
-  const ia = input.informacoesAdicionais;
+  const ia = entrada.informacoesAdicionais;
   const infAdic = ia === undefined || Object.values(ia).every((x) => x === undefined) ? undefined : clean({
     infAdFisco: ia.infAdFisco,
     infCpl: ia.infCpl,
@@ -2938,19 +3125,19 @@ async function buildNfe(input, options) {
     obsFisco: ia.obsFisco,
     procRef: ia.procRef
   });
-  const exig = { ...exigenciaRespTec(emitUf, options.ambiente, agora), ...options.exigencias };
-  const rt = input.respTec ?? options.respTec;
+  const exig = { ...exigenciaRespTec(emitUf, opcoes.ambiente, agora), ...opcoes.exigencias };
+  const rt = entrada.respTec ?? opcoes.respTec;
   let infRespTec;
   if (rt === undefined) {
     if (exig.infRespTec === "obrigatorio") {
       issues.add("respTec", "resp_tec_obrigatorio", `a UF ${emitUf} exige o responsável técnico (rejeição 972)`);
     }
   } else {
-    const cnpjRt = parseCnpj3(rt.CNPJ, { path: "respTec.CNPJ" });
+    const cnpjRt = lerCnpj3(rt.CNPJ, { caminho: "respTec.CNPJ" });
     if (!cnpjRt.ok)
-      issues.list.push(cnpjRt.error);
+      issues.list.push(cnpjRt.erro);
     infRespTec = {
-      CNPJ: cnpjRt.ok ? cnpjRt.value : rt.CNPJ,
+      CNPJ: cnpjRt.ok ? cnpjRt.valor : rt.CNPJ,
       xContato: rt.xContato,
       email: rt.email,
       fone: digits(rt.fone)
@@ -2968,66 +3155,69 @@ async function buildNfe(input, options) {
     ide,
     emit,
     dest,
-    retirada: local(input.retirada, "retirada"),
-    entrega: local(input.entrega, "entrega"),
+    retirada: local(entrada.retirada, "retirada"),
+    entrega: local(entrada.entrega, "entrega"),
     autXML,
     det: itens.map((m) => m.det),
     total,
     transp,
     cobr,
     pag,
-    infIntermed: input.infIntermed,
+    infIntermed: entrada.infIntermed,
     infAdic,
-    exporta: input.exporta,
-    compra: input.compra,
-    cana: input.cana,
+    exporta: entrada.exporta,
+    compra: entrada.compra,
+    cana: entrada.cana,
     infRespTec,
-    agropecuario: input.agropecuario
+    agropecuario: entrada.agropecuario
   });
-  cstComIsento(input, idDest, issues);
-  vencimentos(input, { dhEmi, instante: agora }, issues);
+  cstComIsento(entrada, idDest, issues);
+  vencimentos(entrada, { dhEmi, instante: agora }, issues);
   camposForaDoPl(pl.infNFe, inf, "infNFe", pl.vigencia.pl, issues);
-  textosForaDoXml(inf, "infNFe", issues);
+  textosForaDoXml2(inf, "infNFe", issues);
   if (!issues.empty)
-    return { ok: false, issues: issues.classificadas };
+    return { ok: false, ocorrencias: issues.classificadas };
   let xml;
   try {
-    xml = `<NFe xmlns="${NFE_NS3}">${serialize2(pl.infNFe, "infNFe", inf, NFE_NS3)}</NFe>`;
+    xml = `<NFe xmlns="${NFE_NS3}">${serializar2(pl.infNFe, "infNFe", inf, NFE_NS3)}</NFe>`;
   } catch (e) {
-    if (!(e instanceof SerializeError))
+    if (!(e instanceof ErroSerializacao))
       throw e;
-    return { ok: false, issues: [{ path: e.path, code: "schema", message: e.message, origem: "montagem" }] };
+    return {
+      ok: false,
+      ocorrencias: [{ caminho: e.caminho, code: "schema", mensagem: e.message, origem: "montagem" }]
+    };
   }
-  const doc = parseXml3(xml);
-  const infEl = firstChild3(doc.root, "infNFe", NFE_NS3);
-  const schemaIssues = infEl === undefined ? [] : validate3(pl.infNFe, infEl);
+  const doc = lerXml3(xml);
+  const infEl = primeiroFilho3(doc.raiz, "infNFe", NFE_NS3);
+  const schemaIssues = infEl === undefined ? [] : validar3(pl.infNFe, infEl);
   if (schemaIssues.length > 0) {
     return {
       ok: false,
-      issues: schemaIssues.map((i) => ({
-        path: i.path,
+      ocorrencias: schemaIssues.map((i) => ({
+        caminho: i.caminho,
         code: "schema",
-        message: `${i.code}: ${i.message}`,
+        mensagem: `${i.code}: ${i.mensagem}`,
         origem: "montagem"
       }))
     };
   }
   let supl;
   if (nfce) {
-    const tabela = urlsNfce(emitUf, options.ambiente, diaBrasilia(agora));
-    const urlQr = options.urlQrCode ?? tabela.qrCode;
-    const urlChave = options.urlChave ?? tabela.urlChave;
+    const tabela = urlsNfce(emitUf, opcoes.ambiente, diaBrasilia(agora));
+    const urlQr = opcoes.urlQrCode ?? tabela.qrCode;
+    const urlChave = opcoes.urlChave ?? tabela.urlChave;
     if (urlQr === undefined || !/^https?:\/\//i.test(urlQr)) {
-      issues.montagem("urlQrCode", "qrcode_invalido", `sem endereço completo do QR Code da NFC-e para ${emitUf} em ${options.ambiente}: informe urlQrCode (data/nfce-urls.json)`);
+      issues.montagem("urlQrCode", "qrcode_invalido", `sem endereço completo do QR Code da NFC-e para ${emitUf} em ${opcoes.ambiente}: informe urlQrCode (data/nfce-urls.json)`);
     }
     if (urlChave === undefined) {
       issues.montagem("urlChave", "qrcode_invalido", `sem URL de consulta por chave da NFC-e para ${emitUf}: informe urlChave`);
     }
     if (urlQr === undefined || urlChave === undefined || !issues.empty)
-      return { ok: false, issues: issues.classificadas };
+      return { ok: false, ocorrencias: issues.classificadas };
     const p = await parametrosQrCode({
       chave,
-      ambiente: options.ambiente,
+      ambiente: opcoes.ambiente,
       tpEmis,
       dhEmi,
       vNF: inf.total.ICMSTot.vNF,
@@ -3037,11 +3227,11 @@ async function buildNfe(input, options) {
     supl = { versao: qr.versao, urlChave, base: `${urlQr.replace(/\?+$/, "")}?p=`, ...p };
     const suplIssues = conferirSupl(inserirSupl({ xml, nfce: supl }, supl.assinar ? ASSINATURA_2048 : undefined));
     if (suplIssues.length > 0)
-      return { ok: false, issues: suplIssues };
+      return { ok: false, ocorrencias: suplIssues };
   }
   return {
     ok: true,
-    value: {
+    valor: {
       chave,
       id: `NFe${chave}`,
       cNF,
@@ -3056,22 +3246,27 @@ async function buildNfe(input, options) {
     }
   };
 }
-var ASSINATURA_2048 = base64Encode2(new Uint8Array(256));
+var ASSINATURA_2048 = codificarBase642(new Uint8Array(256));
 function conferirSupl(xml) {
-  const el = firstChild3(parseXml3(xml).root, "infNFeSupl", NFE_NS3);
-  const erros = el === undefined ? [] : validate3(TNFe_infNFeSupl, el);
-  return erros.map((i) => ({ path: i.path, code: "schema", message: `${i.code}: ${i.message}`, origem: "montagem" }));
+  const el = primeiroFilho3(lerXml3(xml).raiz, "infNFeSupl", NFE_NS3);
+  const erros = el === undefined ? [] : validar3(TNFe_infNFeSupl, el);
+  return erros.map((i) => ({
+    caminho: i.caminho,
+    code: "schema",
+    mensagem: `${i.code}: ${i.mensagem}`,
+    origem: "montagem"
+  }));
 }
 var escapeXml = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
-async function assinaturaQrCode(built, signer) {
-  return built.nfce?.assinar === true ? assinarParametros(built.nfce.parametros, signer) : undefined;
+async function assinaturaQrCode(nota, assinador) {
+  return nota.nfce?.assinar === true ? assinarParametros(nota.nfce.parametros, assinador) : undefined;
 }
-function comQrCode(built, assinatura) {
-  const xml = inserirSupl(built, assinatura);
+function comQrCode(nota, assinatura) {
+  const xml = inserirSupl(nota, assinatura);
   if (assinatura !== undefined) {
     const issues = conferirSupl(xml);
     if (issues.length > 0)
-      throw new ValidationError("o QR Code da NFC-e não passou no schema", issues);
+      throw new ErroDeValidacao("o QR Code da NFC-e não passou no schema", issues);
   }
   return xml;
 }
@@ -3079,24 +3274,24 @@ function inserirSupl(built, assinatura) {
   const s = built.nfce;
   if (s === undefined) {
     if (assinatura !== undefined)
-      throw new ConfigError2("a NF-e (modelo 55) não tem QR Code");
+      throw new ErroDeConfiguracao2("a NF-e (modelo 55) não tem QR Code");
     return built.xml;
   }
   if (s.assinar && assinatura === undefined) {
-    throw new ConfigError2("NFC-e em contingência off-line com QR Code versão 3 precisa da assinatura (ZX02-334, rejeição 474)");
+    throw new ErroDeConfiguracao2("NFC-e em contingência off-line com QR Code versão 3 precisa da assinatura (ZX02-334, rejeição 474)");
   }
   if (!s.assinar && assinatura !== undefined) {
-    throw new ConfigError2("este QR Code não leva assinatura (ZX02-330, rejeição 445)");
+    throw new ErroDeConfiguracao2("este QR Code não leva assinatura (ZX02-330, rejeição 445)");
   }
   const fim = "</NFe>";
   if (!built.xml.endsWith(fim))
-    throw new ConfigError2("NFC-e montada fora da forma esperada");
+    throw new ErroDeConfiguracao2("NFC-e montada fora da forma esperada");
   const qrCode = `${s.base}${s.parametros}${assinatura === undefined ? "" : `|${assinatura}`}`;
   const supl = `<infNFeSupl><qrCode>${escapeXml(qrCode)}</qrCode><urlChave>${escapeXml(s.urlChave)}</urlChave></infNFeSupl>`;
   return built.xml.slice(0, -fim.length) + supl + fim;
 }
-async function signNfe(built, signer) {
-  return signXml(comQrCode(built, await assinaturaQrCode(built, signer)), { id: built.id }, signer);
+async function assinarNfe(nota, assinador) {
+  return assinarXml(comQrCode(nota, await assinaturaQrCode(nota, assinador)), { id: nota.id }, assinador);
 }
 // packages/nfe/src/model.ts
 var MotivoDesoneracaoIcms = {
@@ -3182,7 +3377,7 @@ var GRUPOS = [
   { padrao: /^infNFe\.infRespTec\b/, rotulo: "Responsável técnico" },
   { padrao: /^infNFe\.exporta\b/, rotulo: "Exportação" }
 ];
-var CAMPOS = {
+var CAMPOS2 = {
   IE: "Inscrição estadual",
   IEST: "Inscrição estadual do substituto tributário",
   IM: "Inscrição municipal",
@@ -3245,25 +3440,25 @@ var CAMPOS = {
   infCpl: "Informações complementares",
   infAdFisco: "Informações de interesse do fisco"
 };
-var rotular = criarRotuloDoCaminho({ grupos: GRUPOS, campos: CAMPOS, padrao: "Dados da NF-e" });
-function rotuloDoCaminho(path) {
-  return rotular(path);
+var rotular = criarRotuloDoCaminho({ grupos: GRUPOS, campos: CAMPOS2, padrao: "Dados da NF-e" });
+function rotuloDoCaminho(caminho) {
+  return rotular(caminho);
 }
 // packages/nfe/src/services/client.ts
 import {
-  authorized,
-  ConfigError as ConfigError4,
-  denied,
-  noopLogger,
-  ProtocolError as ProtocolError4,
-  pending,
-  tpAmbOf as tpAmbOf3,
-  ufByCUf as ufByCUf2,
-  ufBySigla as ufBySigla3,
-  ValidationError as ValidationError2
+  criarAutorizado,
+  criarDenegado,
+  criarPendente,
+  ErroDeConfiguracao as ErroDeConfiguracao4,
+  ErroDeValidacao as ErroDeValidacao2,
+  ErroRespostaInvalida as ErroRespostaInvalida4,
+  loggerSilencioso,
+  tpAmbDoAmbiente as tpAmbDoAmbiente3,
+  ufPorCUf as ufPorCUf2,
+  ufPorSigla as ufPorSigla3
 } from "@sinete/core";
-import { childElements as childElements2, firstChild as firstChild5, parseXml as parseXml6, signXml as signXml2, textOf as textOf2 } from "@sinete/core/xml";
-import { decode, decodeXml, serialize as serialize3, serializeRoot, validate as validate4 } from "@sinete/schemas";
+import { assinarXml as assinarXml2, elementosFilhos as elementosFilhos2, lerXml as lerXml6, primeiroFilho as primeiroFilho5, textoDe as textoDe2 } from "@sinete/core/xml";
+import { decodificar, decodificarXml, serializar as serializar3, serializarRaiz, validar as validar4 } from "@sinete/schemas";
 import { ConsCadElement, TRetConsCad } from "@sinete/schemas/nfe/consulta-cadastro/PL_010d";
 import { consSitNFeElement, TProtNFe, TRetConsSitNFe } from "@sinete/schemas/nfe/consulta-protocolo/PL_010d";
 import {
@@ -3283,32 +3478,32 @@ import { TInutNFe_infInut, TRetInutNFe } from "@sinete/schemas/nfe/inutilizacao/
 import { TRetConsReciNFe, TRetEnviNFe } from "@sinete/schemas/nfe/PL_010f";
 import { consStatServElement, TRetConsStatServ } from "@sinete/schemas/nfe/status-servico/PL_009q";
 import { nfceEndpoint, nfeContingenciaDaUf, nfeEndpoint } from "@sinete/transport";
-import { parseChaveAcesso as parseChaveAcesso2, parseCnpj as parseCnpj4, parseCpf as parseCpf2 } from "@sinete/validators";
+import { lerChaveAcesso as lerChaveAcesso2, lerCnpj as lerCnpj4, lerCpf as lerCpf2 } from "@sinete/validators";
 
 // packages/nfe/src/services/gzip.ts
-import { ProtocolError, UnsupportedError as UnsupportedError2 } from "@sinete/core";
-import { base64Decode } from "@sinete/core/xml";
-async function gunzipBase64(b64) {
+import { ErroNaoSuportado as ErroNaoSuportado2, ErroRespostaInvalida } from "@sinete/core";
+import { decodificarBase64 } from "@sinete/core/xml";
+async function descomprimirGzipBase64(b64) {
   const Ds = globalThis.DecompressionStream;
   if (Ds === undefined)
-    throw new UnsupportedError2("DecompressionStream indisponível nesta runtime; docZip não pode ser lido");
+    throw new ErroNaoSuportado2("DecompressionStream indisponível nesta runtime; docZip não pode ser lido");
   let bytes;
   try {
-    bytes = base64Decode(b64.trim());
+    bytes = decodificarBase64(b64.trim());
   } catch (cause) {
-    throw new ProtocolError("docZip com base64 inválido", { cause });
+    throw new ErroRespostaInvalida("docZip com base64 inválido", { cause });
   }
   try {
     const stream = new Blob([bytes]).stream().pipeThrough(new Ds("gzip"));
     return await new Response(stream).text();
   } catch (cause) {
-    throw new ProtocolError("docZip não é um gzip válido", { cause });
+    throw new ErroRespostaInvalida("docZip não é um gzip válido", { cause });
   }
 }
 
 // packages/nfe/src/services/outcome.ts
-import { rejected } from "@sinete/core";
-import { enrichRejected } from "@sinete/rejeicoes";
+import { criarRecusado } from "@sinete/core";
+import { completarRecusado } from "@sinete/rejeicoes";
 // packages/nfe/src/data/cstat.json
 var cstat_default = {
   descricao: "Códigos de status de sucesso e de processamento (MOC 7.0 Anexo I, tabela 4.4.1) e os códigos que o @sinete/nfe trata de forma própria. Rejeições e denegações com mensagem oficial estão no @sinete/rejeicoes; aqui fica só o desfecho de cada código por serviço.",
@@ -3335,14 +3530,14 @@ var cstat_default = {
   consumoIndevido: ["656"],
   dicas: {
     "656": {
-      probableCause: "Consumo indevido: consultas repetidas à Distribuição DF-e sem documento novo (ultNSU igual a maxNSU) ou acima do limite de requisições por hora.",
-      suggestedFix: "Aguardar uma hora antes de consultar de novo e só repetir a consulta quando ultNSU for menor que maxNSU; guardar o ultNSU devolvido e continuar dele.",
-      source: "NT 2014.002 v1.02 (Distribuição DF-e), regras de consumo indevido"
+      causaProvavel: "Consumo indevido: consultas repetidas à Distribuição DF-e sem documento novo (ultNSU igual a maxNSU) ou acima do limite de requisições por hora.",
+      comoCorrigir: "Aguardar uma hora antes de consultar de novo e só repetir a consulta quando ultNSU for menor que maxNSU; guardar o ultNSU devolvido e continuar dele.",
+      fonte: "NT 2014.002 v1.02 (Distribuição DF-e), regras de consumo indevido"
     },
     "217": {
-      probableCause: "A chave consultada não consta na base do autorizador consultado: a nota não foi recebida, ou foi autorizada em outro ambiente ou autorizador (SVC).",
-      suggestedFix: "Se o envio ficou sem resposta, reenviar exatamente o mesmo XML assinado; se foi emitida em contingência SVC, consultar no SVC.",
-      source: "MOC 7.0 Anexo I, serviço de consulta protocolo"
+      causaProvavel: "A chave consultada não consta na base do autorizador consultado: a nota não foi recebida, ou foi autorizada em outro ambiente ou autorizador (SVC).",
+      comoCorrigir: "Se o envio ficou sem resposta, reenviar exatamente o mesmo XML assinado; se foi emitida em contingência SVC, consultar no SVC.",
+      fonte: "MOC 7.0 Anexo I, serviço de consulta protocolo"
     }
   }
 };
@@ -3354,68 +3549,68 @@ function cstatEm(cStat, classe) {
   return CLASSES[classe].includes(cStat);
 }
 function rejeitado(status) {
-  const r = enrichRejected(rejected(status));
-  if (r.hint !== undefined)
+  const r = completarRecusado(criarRecusado(status));
+  if (r.dica !== undefined)
     return r;
   const dica = Object.hasOwn(DICAS, status.cStat) ? DICAS[status.cStat] : undefined;
-  return dica === undefined ? r : rejected(status, dica);
+  return dica === undefined ? r : criarRecusado(status, dica);
 }
 
 // packages/nfe/src/services/proc.ts
-import { ConfigError as ConfigError3, ProtocolError as ProtocolError2 } from "@sinete/core";
+import { ErroDeConfiguracao as ErroDeConfiguracao3, ErroRespostaInvalida as ErroRespostaInvalida2 } from "@sinete/core";
 import {
-  attributeOf,
-  descendants,
-  firstChild as firstChild4,
-  inScopeNamespaces,
-  parseXml as parseXml4,
-  textOf,
+  atributoDe,
+  descendentes,
+  lerXml as lerXml4,
+  namespacesEmEscopo,
+  primeiroFilho as primeiroFilho4,
+  textoDe,
   XMLDSIG_NS
 } from "@sinete/core/xml";
 var NFE_NS4 = "http://www.portalfiscal.inf.br/nfe";
 var XML_DECL = /^?<\?xml[^?]*\?>\s*/;
-function sliceElement(doc, el, parentDefaultNs = NFE_NS4) {
-  const slice = doc.source.slice(el.start, el.end);
+function recortarElemento(documento, el, nsPadraoDoPai = NFE_NS4) {
+  const slice = documento.texto.slice(el.inicio, el.fim);
   const used = new Set;
   const cobertoDentro = (d, p) => {
-    for (let e = d;e; e = e === el ? null : e.parent)
+    for (let e = d;e; e = e === el ? null : e.pai)
       if (e.namespaces.has(p))
         return true;
     return false;
   };
-  for (const d of descendants(el)) {
-    const prefixos = [d.prefix, ...d.attributes.map((a) => a.prefix)].filter((p) => p !== "" && p !== "xml");
+  for (const d of descendentes(el)) {
+    const prefixos = [d.prefixo, ...d.atributos.map((a) => a.prefixo)].filter((p) => p !== "" && p !== "xml");
     for (const p of prefixos)
       if (!cobertoDentro(d, p))
         used.add(p);
   }
   const extra = [];
   const inScope = new Map;
-  for (let e = el.parent;e; e = e.parent) {
+  for (let e = el.pai;e; e = e.pai) {
     for (const [p, u] of e.namespaces)
       if (!inScope.has(p))
         inScope.set(p, u);
   }
   const herdado = inScope.get("") ?? "";
-  if (herdado !== parentDefaultNs && usaDefaultHerdado(el))
+  if (herdado !== nsPadraoDoPai && usaDefaultHerdado(el))
     extra.push(` xmlns="${herdado}"`);
   for (const p of [...used].sort()) {
     const uri = inScope.get(p);
     if (uri === undefined)
-      throw new ProtocolError2(`prefixo ${p} sem declaração no recorte de ${el.name}`);
+      throw new ErroRespostaInvalida2(`prefixo ${p} sem declaração no recorte de ${el.nome}`);
     extra.push(` xmlns:${p}="${uri}"`);
   }
   if (extra.length === 0)
     return slice;
-  const at = 1 + el.name.length;
+  const at = 1 + el.nome.length;
   return slice.slice(0, at) + extra.join("") + slice.slice(at);
 }
 function usaDefaultHerdado(raiz) {
-  for (const d of descendants(raiz)) {
-    if (d.prefix !== "")
+  for (const d of descendentes(raiz)) {
+    if (d.prefixo !== "")
       continue;
     let coberto = false;
-    for (let e = d;e; e = e === raiz ? null : e.parent) {
+    for (let e = d;e; e = e === raiz ? null : e.pai) {
       if (e.namespaces.has("")) {
         coberto = true;
         break;
@@ -3430,46 +3625,46 @@ function documentoAssinado(xml, raiz, elemento) {
   const text = xml.replace(XML_DECL, "");
   let doc;
   try {
-    doc = parseXml4(text);
+    doc = lerXml4(text);
   } catch (cause) {
-    throw new ConfigError3(`${raiz} assinado malformado`, { cause });
+    throw new ErroDeConfiguracao3(`${raiz} assinado malformado`, { cause });
   }
-  if (doc.root.local !== raiz || doc.root.ns !== NFE_NS4) {
-    throw new ConfigError3(`esperado <${raiz}> no namespace da NF-e, veio <${doc.root.name}>`);
+  if (doc.raiz.local !== raiz || doc.raiz.ns !== NFE_NS4) {
+    throw new ErroDeConfiguracao3(`esperado <${raiz}> no namespace da NF-e, veio <${doc.raiz.nome}>`);
   }
-  if (doc.root.namespaces.get("") !== NFE_NS4) {
-    throw new ConfigError3(`<${raiz}> assinado precisa declarar xmlns="${NFE_NS4}" na própria raiz`);
+  if (doc.raiz.namespaces.get("") !== NFE_NS4) {
+    throw new ErroDeConfiguracao3(`<${raiz}> assinado precisa declarar xmlns="${NFE_NS4}" na própria raiz`);
   }
-  const alvo = firstChild4(doc.root, elemento, NFE_NS4);
-  const id = alvo ? attributeOf(alvo, "Id") : undefined;
-  const sig = firstChild4(doc.root, "Signature", XMLDSIG_NS);
+  const alvo = primeiroFilho4(doc.raiz, elemento, NFE_NS4);
+  const id = alvo ? atributoDe(alvo, "Id") : undefined;
+  const sig = primeiroFilho4(doc.raiz, "Signature", XMLDSIG_NS);
   const digest = sig && descendantText(sig, "DigestValue");
   if (!id || digest === undefined)
-    throw new ConfigError3(`${raiz} sem ${elemento} identificado ou sem assinatura`);
-  return { xml: text, id, digestValue: digest, doc };
+    throw new ErroDeConfiguracao3(`${raiz} sem ${elemento} identificado ou sem assinatura`);
+  return { xml: text, id, digestValue: digest, documento: doc };
 }
 function descendantText(el, local) {
-  for (const d of descendants(el))
+  for (const d of descendentes(el))
     if (d.local === local && d.ns === XMLDSIG_NS)
-      return textOf(d).trim();
+      return textoDe(d).trim();
   return;
 }
 function nfeAssinadaDoProc(xml) {
   const text = xml.replace(XML_DECL, "");
   let doc;
   try {
-    doc = parseXml4(text);
+    doc = lerXml4(text);
   } catch (cause) {
-    throw new ConfigError3("nfeProc malformado", { cause });
+    throw new ErroDeConfiguracao3("nfeProc malformado", { cause });
   }
-  const noProc = doc.root.local === "nfeProc" && doc.root.ns === NFE_NS4 ? firstChild4(doc.root, "NFe", NFE_NS4) : undefined;
-  const el = noProc ?? (doc.root.local === "NFe" && doc.root.ns === NFE_NS4 ? doc.root : undefined);
+  const noProc = doc.raiz.local === "nfeProc" && doc.raiz.ns === NFE_NS4 ? primeiroFilho4(doc.raiz, "NFe", NFE_NS4) : undefined;
+  const el = noProc ?? (doc.raiz.local === "NFe" && doc.raiz.ns === NFE_NS4 ? doc.raiz : undefined);
   if (el === undefined)
-    throw new ConfigError3(`esperado <nfeProc> ou <NFe> assinada, veio <${doc.root.name}>`);
-  const fatia = doc.source.slice(el.start, el.end);
-  const herdados = [...inScopeNamespaces(el)].filter(([p]) => p !== "xml" && !el.namespaces.has(p));
+    throw new ErroDeConfiguracao3(`esperado <nfeProc> ou <NFe> assinada, veio <${doc.raiz.nome}>`);
+  const fatia = doc.texto.slice(el.inicio, el.fim);
+  const herdados = [...namespacesEmEscopo(el)].filter(([p]) => p !== "xml" && !el.namespaces.has(p));
   const decl = herdados.map(([p, uri]) => ` ${p === "" ? "xmlns" : `xmlns:${p}`}="${uri.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/"/g, "&quot;")}"`).join("");
-  const at = 1 + el.name.length;
+  const at = 1 + el.nome.length;
   const assinado = decl === "" ? fatia : fatia.slice(0, at) + decl + fatia.slice(at);
   return documentoAssinado(assinado, "NFe", "infNFe").xml;
 }
@@ -3478,9 +3673,9 @@ function envelope(raiz, versao, partes) {
 }
 
 // packages/nfe/src/services/soap.ts
-import { ProtocolError as ProtocolError3 } from "@sinete/core";
-import { childElements, descendants as descendants2, parseXml as parseXml5 } from "@sinete/core/xml";
-import { soap12ContentType, soap12Envelope, soapFault } from "@sinete/transport";
+import { ErroRespostaInvalida as ErroRespostaInvalida3 } from "@sinete/core";
+import { descendentes as descendentes2, elementosFilhos, lerXml as lerXml5 } from "@sinete/core/xml";
+import { contentTypeSoap12, envelopeSoap12, lerSoapFault } from "@sinete/transport";
 // packages/nfe/src/data/servicos.json
 var servicos_default = {
   descricao: "Web services SOAP 1.2 da NF-e 4.00: namespace do WSDL e operação (a action do Content-Type é <namespace>/<operação>). Na NF-e 4.00 não existe cabeçalho nfeCabecMsg; a mensagem vai em nfeDadosMsg no namespace do WSDL, e a resposta volta em nfeResultMsg. A Distribuição DF-e usa o envelope do WSDL próprio, com nfeDadosMsg dentro de nfeDistDFeInteresse.",
@@ -3532,7 +3727,7 @@ var SERVICOS = servicos_default.servicos;
 function servicoInfo(servico) {
   const s = SERVICOS[servico];
   if (!s)
-    throw new ProtocolError3(`serviço sem descrição em data/servicos.json: ${servico}`);
+    throw new ErroRespostaInvalida3(`serviço sem descrição em data/servicos.json: ${servico}`);
   return s;
 }
 function soapBodyFor(servico, mensagem, autorizador) {
@@ -3545,62 +3740,62 @@ function soapBodyFor(servico, mensagem, autorizador) {
 async function chamar(c) {
   const s = servicoInfo(c.servico);
   const started = { servico: c.servico, autorizador: c.endpoint.autorizador, host: c.endpoint.host };
-  const res = await c.transport.send({
+  const res = await c.transport.enviar({
     url: c.endpoint.url,
     endpoint: c.endpoint,
-    method: "POST",
-    headers: { "content-type": soap12ContentType(`${s.namespace}/${s.operacao}`) },
-    body: soap12Envelope(soapBodyFor(c.servico, c.mensagem, c.endpoint.autorizador)),
+    metodo: "POST",
+    cabecalhos: { "content-type": contentTypeSoap12(`${s.namespace}/${s.operacao}`) },
+    corpo: envelopeSoap12(soapBodyFor(c.servico, c.mensagem, c.endpoint.autorizador)),
     ...c.timeoutMs === undefined ? {} : { timeoutMs: c.timeoutMs },
     ...c.signal === undefined ? {} : { signal: c.signal }
   });
-  const text = res.text();
-  const fault = soapFault(text);
+  const text = res.texto();
+  const fault = lerSoapFault(text);
   if (fault) {
     c.logger.warn("nfe.soap.fault", { ...started, status: res.status, code: fault.code });
-    throw new ProtocolError3(`SOAP fault de ${c.endpoint.host}: ${fault.reason ?? fault.code ?? "sem motivo"}`, {
-      details: { status: res.status, code: fault.code, reason: fault.reason, servico: c.servico }
+    throw new ErroRespostaInvalida3(`SOAP fault de ${c.endpoint.host}: ${fault.reason ?? fault.code ?? "sem motivo"}`, {
+      detalhes: { status: res.status, code: fault.code, reason: fault.reason, servico: c.servico }
     });
   }
   let doc;
   try {
-    doc = parseXml5(text.replace(/^/, ""));
+    doc = lerXml5(text.replace(/^/, ""));
   } catch (cause) {
-    throw new ProtocolError3(`resposta de ${c.endpoint.host} não é XML (HTTP ${res.status})`, {
+    throw new ErroRespostaInvalida3(`resposta de ${c.endpoint.host} não é XML (HTTP ${res.status})`, {
       cause,
-      details: { status: res.status, servico: c.servico }
+      detalhes: { status: res.status, servico: c.servico }
     });
   }
   let ret;
-  for (const el of descendants2(doc.root)) {
+  for (const el of descendentes2(doc.raiz)) {
     if (el.local === c.retorno && el.ns === NFE_NS4) {
       ret = el;
       break;
     }
   }
   if (!ret)
-    ret = retornoForaDoNamespace(doc.root, c.retorno);
+    ret = retornoForaDoNamespace(doc.raiz, c.retorno);
   if (ret && ret.ns !== NFE_NS4) {
     c.logger.warn("nfe.soap.retorno_fora_do_namespace", { ...started, retorno: c.retorno, ns: ret.ns });
   }
   if (!ret) {
-    throw new ProtocolError3(`resposta de ${c.endpoint.host} sem <${c.retorno}> (HTTP ${res.status})`, {
-      details: { status: res.status, servico: c.servico }
+    throw new ErroRespostaInvalida3(`resposta de ${c.endpoint.host} sem <${c.retorno}> (HTTP ${res.status})`, {
+      detalhes: { status: res.status, servico: c.servico }
     });
   }
-  if (!Array.from(descendants2(ret)).some((el) => el.local === "cStat" && el.ns === NFE_NS4)) {
-    throw new ProtocolError3(`<${c.retorno}> de ${c.endpoint.host} sem cStat (HTTP ${res.status})`, {
-      details: { status: res.status, servico: c.servico }
+  if (!Array.from(descendentes2(ret)).some((el) => el.local === "cStat" && el.ns === NFE_NS4)) {
+    throw new ErroRespostaInvalida3(`<${c.retorno}> de ${c.endpoint.host} sem cStat (HTTP ${res.status})`, {
+      detalhes: { status: res.status, servico: c.servico }
     });
   }
   c.logger.debug("nfe.soap.resposta", { ...started, status: res.status });
   return { doc, ret, status: res.status };
 }
 function retornoForaDoNamespace(root, retorno) {
-  for (const el of descendants2(root)) {
+  for (const el of descendentes2(root)) {
     if (el.local !== retorno)
       continue;
-    const filhos = childElements(el);
+    const filhos = elementosFilhos(el);
     if (filhos.length > 0 && filhos.every((f) => f.ns === NFE_NS4))
       return el;
   }
@@ -3628,26 +3823,26 @@ var defaultSleep = (ms, signal) => new Promise((resolve, reject) => {
   signal?.addEventListener("abort", onAbort, { once: true });
 });
 function chaveValida(chave, path) {
-  const r = parseChaveAcesso2(chave, { path });
+  const r = lerChaveAcesso2(chave, { caminho: path });
   if (!r.ok)
-    throw new ValidationError2(`chave de acesso inválida: ${r.error.message}`, [r.error]);
-  return r.value;
+    throw new ErroDeValidacao2(`chave de acesso inválida: ${r.erro.mensagem}`, [r.erro]);
+  return r.valor;
 }
 function schemaIssues(what, issues) {
   if (issues.length > 0)
-    throw new ValidationError2(`${what} não confere com o schema`, issues);
+    throw new ErroDeValidacao2(`${what} não confere com o schema`, issues);
 }
 function documentoAutor(a, path) {
   if (a.CNPJ !== undefined) {
-    const r = parseCnpj4(a.CNPJ, { path: `${path}.CNPJ` });
+    const r = lerCnpj4(a.CNPJ, { caminho: `${path}.CNPJ` });
     if (!r.ok)
-      throw new ValidationError2("CNPJ do autor inválido", [r.error]);
-    return { CNPJ: r.value };
+      throw new ErroDeValidacao2("CNPJ do autor inválido", [r.erro]);
+    return { CNPJ: r.valor };
   }
-  const r = parseCpf2(a.CPF ?? "", { path: `${path}.CPF` });
+  const r = lerCpf2(a.CPF ?? "", { caminho: `${path}.CPF` });
   if (!r.ok)
-    throw new ValidationError2("CPF do autor inválido", [r.error]);
-  return { CPF: r.value };
+    throw new ErroDeValidacao2("CPF do autor inválido", [r.erro]);
+  return { CPF: r.valor };
 }
 function autorDaChave(c) {
   return c.cnpj !== undefined ? { CNPJ: c.cnpj } : { CPF: c.cpf ?? c.emitente.slice(3) };
@@ -3659,11 +3854,11 @@ function autorDoEmitente(a, c) {
   const autor = documentoAutor(a, "autor");
   const [campo, valor] = "CNPJ" in autor ? ["CNPJ", autor.CNPJ] : ["CPF", autor.CPF];
   if (valor !== ("CNPJ" in daChave ? daChave.CNPJ : daChave.CPF) || campo !== ("CNPJ" in daChave ? "CNPJ" : "CPF")) {
-    throw new ValidationError2("o autor do evento não é o emitente da NF-e", [
+    throw new ErroDeValidacao2("o autor do evento não é o emitente da NF-e", [
       {
-        path: `autor.${campo}`,
+        caminho: `autor.${campo}`,
         code: "autor_difere_do_emitente",
-        message: `o autor de um evento do emitente é o ${"CNPJ" in daChave ? "CNPJ" : "CPF"} da chave (P12-44, rejeição 574)`,
+        mensagem: `o autor de um evento do emitente é o ${"CNPJ" in daChave ? "CNPJ" : "CPF"} da chave (P12-44, rejeição 574)`,
         origem: "entrada"
       }
     ]);
@@ -3672,19 +3867,19 @@ function autorDoEmitente(a, c) {
 }
 var SVC_DO_TPEMIS = { "6": "SVC-AN", "7": "SVC-RS" };
 function chaveDoDocumento(a) {
-  const r = parseChaveAcesso2(a.id.slice(3), { path: "infNFe.Id", checkEmitente: false });
+  const r = lerChaveAcesso2(a.id.slice(3), { caminho: "infNFe.Id", conferirEmitente: false });
   if (!r.ok)
-    throw new ConfigError4(`Id da NF-e assinada não é uma chave de acesso: ${r.error.message}`);
-  return r.value;
+    throw new ErroDeConfiguracao4(`Id da NF-e assinada não é uma chave de acesso: ${r.erro.mensagem}`);
+  return r.valor;
 }
 function avulso(doc, el) {
-  return sliceElement(doc, el, "");
+  return recortarElemento(doc, el, "");
 }
 function lerProtocolo(doc, el) {
-  const { value } = decode(TProtNFe, el, doc.source);
+  const { valor: value } = decodificar(TProtNFe, el, doc.texto);
   const inf = value.infProt;
   if (!inf)
-    throw new ProtocolError4("protNFe sem infProt");
+    throw new ErroRespostaInvalida4("protNFe sem infProt");
   const p = {
     chNFe: inf.chNFe,
     cStat: inf.cStat,
@@ -3695,7 +3890,7 @@ function lerProtocolo(doc, el) {
     ...inf.nProt === undefined ? {} : { nProt: inf.nProt },
     ...inf.digVal === undefined ? {} : { digVal: inf.digVal }
   };
-  return { p, embutido: sliceElement(doc, el) };
+  return { p, embutido: recortarElemento(doc, el) };
 }
 function desfechoDoProtocolo({ p, embutido }, a) {
   const status = { cStat: p.cStat, xMotivo: p.xMotivo };
@@ -3706,27 +3901,27 @@ function desfechoDoProtocolo({ p, embutido }, a) {
   let full = p;
   if (a) {
     if (`NFe${p.chNFe}` !== a.id) {
-      throw new ProtocolError4("protocolo de outra chave de acesso", { details: { chNFe: p.chNFe } });
+      throw new ErroRespostaInvalida4("protocolo de outra chave de acesso", { detalhes: { chNFe: p.chNFe } });
     }
     if (p.digVal !== undefined && p.digVal !== a.digestValue) {
-      throw new ProtocolError4("digVal do protocolo difere do DigestValue da NF-e enviada", {
-        details: { chNFe: p.chNFe, cStat: p.cStat }
+      throw new ErroRespostaInvalida4("digVal do protocolo difere do DigestValue da NF-e enviada", {
+        detalhes: { chNFe: p.chNFe, cStat: p.cStat }
       });
     }
     if (p.digVal !== undefined)
       full = { ...p, nfeProc: envelope("nfeProc", "4.00", [a.xml, embutido]) };
   }
-  return autorizada ? authorized(status, full) : denied(status, full);
+  return autorizada ? criarAutorizado(status, full) : criarDenegado(status, full);
 }
 function protNFeDaChave(parent, a) {
-  const prots = childElements2(parent).filter((e) => e.local === "protNFe" && e.ns === NFE_NS4);
+  const prots = elementosFilhos2(parent).filter((e) => e.local === "protNFe" && e.ns === NFE_NS4);
   if (!a)
     return prots[0];
   const chave = a.id.slice(3);
   return prots.find((e) => {
-    const inf = firstChild5(e, "infProt", NFE_NS4);
-    const ch = inf && firstChild5(inf, "chNFe", NFE_NS4);
-    return ch !== undefined && textOf2(ch).trim() === chave;
+    const inf = primeiroFilho5(e, "infProt", NFE_NS4);
+    const ch = inf && primeiroFilho5(inf, "chNFe", NFE_NS4);
+    return ch !== undefined && textoDe2(ch).trim() === chave;
   }) ?? (prots.length === 1 ? prots[0] : undefined);
 }
 var EVENTO_VERSAO = "1.00";
@@ -3737,36 +3932,39 @@ var MANIFESTACOES = {
   desconhecimento: { tpEvento: "210220", descEvento: "Desconhecimento da Operacao", ct: TEventoDesconhecimento },
   "nao-realizada": { tpEvento: "210240", descEvento: "Operacao nao Realizada", ct: TEventoNaoRealizada }
 };
-function createNfeClient(options) {
-  const logger = (options.logger ?? noopLogger).child({ modulo: "nfe", ambiente: options.ambiente });
-  const sleep = options.sleep ?? defaultSleep;
-  const tpAmb = tpAmbOf3(options.ambiente);
-  const ufInfo = options.uf === undefined ? undefined : ufBySigla3(options.uf);
-  if (options.uf !== undefined && !ufInfo)
-    throw new ConfigError4(`UF inválida: ${String(options.uf)}`);
+function criarClienteNfe(opcoesDoCliente) {
+  const logger = (opcoesDoCliente.logger ?? loggerSilencioso).child({
+    modulo: "nfe",
+    ambiente: opcoesDoCliente.ambiente
+  });
+  const sleep = opcoesDoCliente.esperar ?? defaultSleep;
+  const tpAmb = tpAmbDoAmbiente3(opcoesDoCliente.ambiente);
+  const ufInfo = opcoesDoCliente.uf === undefined ? undefined : ufPorSigla3(opcoesDoCliente.uf);
+  if (opcoesDoCliente.uf !== undefined && !ufInfo)
+    throw new ErroDeConfiguracao4(`UF inválida: ${String(opcoesDoCliente.uf)}`);
   const ufPadrao = (servico) => {
-    if (options.uf === undefined || ufInfo === undefined) {
-      throw new ConfigError4(`${servico} precisa da UF: informe NfeClientOptions.uf`);
+    if (opcoesDoCliente.uf === undefined || ufInfo === undefined) {
+      throw new ErroDeConfiguracao4(`${servico} precisa da UF: informe ClienteNfeOpcoes.uf`);
     }
-    return { uf: options.uf, cUF: ufInfo.cUF };
+    return { uf: opcoesDoCliente.uf, cUF: ufInfo.cUF };
   };
-  const offsetDe = (uf) => options.offsetMinutes ?? offsetDaUf(uf);
+  const offsetDe = (uf) => opcoesDoCliente.deslocamentoMin ?? deslocamentoDaUf(uf);
   const idLote = () => {
-    const id = options.idLote ? options.idLote() : String(options.clock.now().getTime()).slice(-15);
+    const id = opcoesDoCliente.idLote ? opcoesDoCliente.idLote() : String(opcoesDoCliente.relogio.agora().getTime()).slice(-15);
     if (!/^[0-9]{1,15}$/.test(id))
-      throw new ConfigError4(`idLote inválido: ${id}`);
+      throw new ErroDeConfiguracao4(`idLote inválido: ${id}`);
     return id;
   };
-  const endpointNfce = (servico, uf) => options.nfceEndpoint ? options.nfceEndpoint(servico, uf) : nfceEndpoint({ ambiente: options.ambiente, servico, uf });
+  const endpointNfce = (servico, uf) => opcoesDoCliente.endpointNfce ? opcoesDoCliente.endpointNfce(servico, uf) : nfceEndpoint({ ambiente: opcoesDoCliente.ambiente, servico, uf });
   const endpoint = (servico, mod = "55") => {
     const { uf } = ufPadrao(servico);
     if (mod === "65")
       return endpointNfce(servico, uf);
     return nfeEndpoint({
-      ambiente: options.ambiente,
+      ambiente: opcoesDoCliente.ambiente,
       servico,
       uf,
-      ...options.contingencia === undefined ? {} : { contingencia: options.contingencia }
+      ...opcoesDoCliente.contingencia === undefined ? {} : { contingencia: opcoesDoCliente.contingencia }
     });
   };
   const endpointDaChave = (servico, c, naUf = false) => {
@@ -3774,76 +3972,78 @@ function createNfeClient(options) {
       return endpointNfce(servico, c.uf);
     const svc = naUf || c.tpEmis === undefined ? undefined : SVC_DO_TPEMIS[c.tpEmis];
     return nfeEndpoint({
-      ambiente: options.ambiente,
+      ambiente: opcoesDoCliente.ambiente,
       servico,
       ...svc === undefined ? { uf: c.uf } : { autorizador: svc }
     });
   };
   const call = (ep, servico, mensagem, retorno, signal) => chamar({
-    transport: options.transport,
+    transport: opcoesDoCliente.transporte,
     endpoint: ep,
     servico,
     mensagem,
     retorno,
     logger,
-    ...options.timeoutMs === undefined ? {} : { timeoutMs: options.timeoutMs },
+    ...opcoesDoCliente.timeoutMs === undefined ? {} : { timeoutMs: opcoesDoCliente.timeoutMs },
     ...signal === undefined ? {} : { signal }
   });
   const autorPadrao = (a, path) => {
-    const autor = a ?? options.autor;
+    const autor = a ?? opcoesDoCliente.autor;
     if (!autor)
-      throw new ConfigError4(`informe o CNPJ ou CPF do autor (${path} ou NfeClientOptions.autor)`);
+      throw new ErroDeConfiguracao4(`informe o CNPJ ou CPF do autor (${path} ou ClienteNfeOpcoes.autor)`);
     return documentoAutor(autor, path);
   };
   async function consultarRecibo(nRec, nfeAssinada, opcoes = {}) {
     if (!/^[0-9]{15}$/.test(nRec))
-      throw new ConfigError4(`número de recibo inválido: ${nRec}`);
+      throw new ErroDeConfiguracao4(`número de recibo inválido: ${nRec}`);
     const a = nfeAssinada === undefined ? undefined : documentoAssinado(nfeAssinada, "NFe", "infNFe");
     const c = a === undefined ? undefined : chaveDoDocumento(a);
     if (c !== undefined && opcoes.mod !== undefined && opcoes.mod !== c.mod) {
-      throw new ConfigError4(`mod ${opcoes.mod} não é o da NF-e assinada (${c.mod})`);
+      throw new ErroDeConfiguracao4(`mod ${opcoes.mod} não é o da NF-e assinada (${c.mod})`);
     }
     const msg = envelope("consReciNFe", "4.00", [`<tpAmb>${tpAmb}</tpAmb><nRec>${nRec}</nRec>`]);
     const ep = c === undefined ? endpoint("NFeRetAutorizacao", opcoes.mod ?? "55") : endpointDaChave("NFeRetAutorizacao", c);
     const r = await call(ep, "NFeRetAutorizacao", msg, "retConsReciNFe", opcoes.signal);
-    const v = decode(TRetConsReciNFe, r.ret, r.doc.source).value;
+    const v = decodificar(TRetConsReciNFe, r.ret, r.doc.texto).valor;
     if (v.nRec !== undefined && v.nRec !== nRec) {
-      throw new ProtocolError4("retorno de outro recibo", { details: { nRec: v.nRec } });
+      throw new ErroRespostaInvalida4("retorno de outro recibo", { detalhes: { nRec: v.nRec } });
     }
     const status = { cStat: v.cStat, xMotivo: v.xMotivo };
     logger.info("nfe.recibo", { nRec, cStat: v.cStat });
     if (cstatEm(v.cStat, "loteEmProcessamento") || cstatEm(v.cStat, "loteRecebido"))
-      return pending(status, { ref: nRec });
+      return criarPendente(status, { referencia: nRec });
     if (cstatEm(v.cStat, "loteProcessado")) {
       const el = protNFeDaChave(r.ret, a);
       if (!el)
-        throw new ProtocolError4("lote processado sem o protNFe da NF-e", { details: { nRec } });
+        throw new ErroRespostaInvalida4("lote processado sem o protNFe da NF-e", { detalhes: { nRec } });
       return desfechoDoProtocolo(lerProtocolo(r.doc, el), a);
     }
     return rejeitado(status);
   }
-  async function consultar(chave, nfeAssinada) {
+  async function consultar(chave, nfeAssinada, opcoes) {
     const c = chaveValida(chave, "chNFe");
     const a = nfeAssinada === undefined ? undefined : documentoAssinado(nfeAssinada, "NFe", "infNFe");
     if (a && a.id !== `NFe${c.chave}`)
-      throw new ConfigError4("a NF-e assinada não é a da chave consultada");
-    const msg = serializeRoot(consSitNFeElement, { versao: "4.00", tpAmb, xServ: "CONSULTAR", chNFe: c.chave });
+      throw new ErroDeConfiguracao4("a NF-e assinada não é a da chave consultada");
+    const msg = serializarRaiz(consSitNFeElement, { versao: "4.00", tpAmb, xServ: "CONSULTAR", chNFe: c.chave });
     const ep = endpointDaChave("NfeConsultaProtocolo", c);
-    const r = await call(ep, "NfeConsultaProtocolo", msg, "retConsSitNFe");
-    const v = decode(TRetConsSitNFe, r.ret, r.doc.source).value;
+    const r = await call(ep, "NfeConsultaProtocolo", msg, "retConsSitNFe", opcoes?.signal);
+    const v = decodificar(TRetConsSitNFe, r.ret, r.doc.texto).valor;
     const status = { cStat: v.cStat, xMotivo: v.xMotivo };
     logger.info("nfe.consulta", { chNFe: c.chave, cStat: v.cStat });
     const situacao = cstatEm(v.cStat, "autorizada") ? "autorizada" : cstatEm(v.cStat, "cancelada") ? "cancelada" : cstatEm(v.cStat, "denegada") ? "denegada" : undefined;
     if (situacao === undefined)
       return rejeitado(status);
-    const protEl = firstChild5(r.ret, "protNFe", NFE_NS4);
-    const eventos = childElements2(r.ret).filter((e) => e.local === "procEventoNFe" && e.ns === NFE_NS4).map((e) => avulso(r.doc, e));
+    const protEl = primeiroFilho5(r.ret, "protNFe", NFE_NS4);
+    const eventos = elementosFilhos2(r.ret).filter((e) => e.local === "procEventoNFe" && e.ns === NFE_NS4).map((e) => avulso(r.doc, e));
     let protocolo;
     let digValConfere;
     if (protEl) {
       const { p, embutido } = lerProtocolo(r.doc, protEl);
       if (p.chNFe !== c.chave) {
-        throw new ProtocolError4("protocolo de outra chave de acesso na consulta", { details: { chNFe: p.chNFe } });
+        throw new ErroRespostaInvalida4("protocolo de outra chave de acesso na consulta", {
+          detalhes: { chNFe: p.chNFe }
+        });
       }
       protocolo = p;
       if (a) {
@@ -3859,12 +4059,12 @@ function createNfeClient(options) {
       ...protocolo === undefined ? {} : { protocolo },
       ...digValConfere === undefined ? {} : { digValConfere }
     };
-    return situacao === "denegada" ? denied(status, value) : authorized(status, value);
+    return situacao === "denegada" ? criarDenegado(status, value) : criarAutorizado(status, value);
   }
   async function enviarEvento(p) {
     const nSeq = p.nSeqEvento;
     if (!Number.isInteger(nSeq) || nSeq < 1 || nSeq > 99)
-      throw new ConfigError4(`nSeqEvento inválido: ${nSeq}`);
+      throw new ErroDeConfiguracao4(`nSeqEvento inválido: ${nSeq}`);
     const nSeqEvento = String(nSeq);
     const id = `ID${p.tpEvento}${p.chave}${nSeqEvento.padStart(2, "0")}`;
     const inf = {
@@ -3873,62 +4073,62 @@ function createNfeClient(options) {
       tpAmb,
       ...p.autor,
       chNFe: p.chave,
-      dhEvento: formatDh(options.clock.now(), p.offsetMinutes),
+      dhEvento: formatarDh(opcoesDoCliente.relogio.agora(), p.offsetMinutes),
       tpEvento: p.tpEvento,
       nSeqEvento,
       verEvento: EVENTO_VERSAO,
       detEvento: p.detEvento
     };
-    const infXml = serialize3(p.ct, "infEvento", inf, NFE_NS4);
+    const infXml = serializar3(p.ct, "infEvento", inf, NFE_NS4);
     const evento = `<evento xmlns="${NFE_NS4}" versao="${EVENTO_VERSAO}">${infXml}</evento>`;
-    const infEl = firstChild5(parseXml6(evento).root, "infEvento", NFE_NS4);
-    schemaIssues("evento", validate4(p.ct, infEl));
-    const assinado = await signXml2(evento, { id }, options.signer);
+    const infEl = primeiroFilho5(lerXml6(evento).raiz, "infEvento", NFE_NS4);
+    schemaIssues("evento", validar4(p.ct, infEl));
+    const assinado = await assinarXml2(evento, { id }, opcoesDoCliente.assinador);
     const msg = envelope("envEvento", EVENTO_VERSAO, [`<idLote>${idLote()}</idLote>`, assinado]);
-    const r = await call(p.endpoint, "RecepcaoEvento", msg, "retEnvEvento");
-    const v = decode(TRetEnvEvento, r.ret, r.doc.source).value;
+    const r = await call(p.endpoint, "RecepcaoEvento", msg, "retEnvEvento", p.signal);
+    const v = decodificar(TRetEnvEvento, r.ret, r.doc.texto).valor;
     logger.info("nfe.evento", { chNFe: p.chave, tpEvento: p.tpEvento, cStat: v.cStat });
     if (!cstatEm(v.cStat, "loteEventoProcessado"))
       return rejeitado({ cStat: v.cStat, xMotivo: v.xMotivo });
-    const retEl = childElements2(r.ret).find((e) => e.local === "retEvento" && e.ns === NFE_NS4);
+    const retEl = elementosFilhos2(r.ret).find((e) => e.local === "retEvento" && e.ns === NFE_NS4);
     const ret = v.retEvento?.[0]?.infEvento;
     if (!retEl || !ret)
-      throw new ProtocolError4("lote de evento processado sem retEvento");
+      throw new ErroRespostaInvalida4("lote de evento processado sem retEvento");
     const divergentes = [
       ["chNFe", ret.chNFe, p.chave],
       ["tpEvento", ret.tpEvento, p.tpEvento],
       ["nSeqEvento", ret.nSeqEvento === undefined ? undefined : String(Number(ret.nSeqEvento)), nSeqEvento]
     ].filter(([, veio, enviado]) => veio !== undefined && veio !== enviado);
     if (divergentes.length > 0) {
-      throw new ProtocolError4("retEvento de outro evento", {
-        details: Object.fromEntries(divergentes.map(([k, veio]) => [k, veio]))
+      throw new ErroRespostaInvalida4("retEvento de outro evento", {
+        detalhes: Object.fromEntries(divergentes.map(([k, veio]) => [k, veio]))
       });
     }
     const status = { cStat: ret.cStat, xMotivo: ret.xMotivo };
     if (!cstatEm(ret.cStat, "eventoRegistrado"))
       return rejeitado(status);
-    return authorized(status, {
+    return criarAutorizado(status, {
       chNFe: p.chave,
       tpEvento: p.tpEvento,
       nSeqEvento,
       dhRegEvento: ret.dhRegEvento,
       retEvento: avulso(r.doc, retEl),
-      procEventoNFe: envelope("procEventoNFe", EVENTO_VERSAO, [assinado, sliceElement(r.doc, retEl)]),
+      procEventoNFe: envelope("procEventoNFe", EVENTO_VERSAO, [assinado, recortarElemento(r.doc, retEl)]),
       ...ret.nProt === undefined ? {} : { nProt: ret.nProt }
     });
   }
   const client = {
-    options,
+    opcoes: opcoesDoCliente,
     async statusServico(opcoes) {
       const { cUF } = ufPadrao("NfeStatusServico");
-      const msg = serializeRoot(consStatServElement, { versao: "4.00", tpAmb, cUF, xServ: "STATUS" });
-      const r = await call(endpoint("NfeStatusServico", opcoes?.mod), "NfeStatusServico", msg, "retConsStatServ");
-      const v = decode(TRetConsStatServ, r.ret, r.doc.source).value;
+      const msg = serializarRaiz(consStatServElement, { versao: "4.00", tpAmb, cUF, xServ: "STATUS" });
+      const r = await call(endpoint("NfeStatusServico", opcoes?.mod), "NfeStatusServico", msg, "retConsStatServ", opcoes?.signal);
+      const v = decodificar(TRetConsStatServ, r.ret, r.doc.texto).valor;
       const status = { cStat: v.cStat, xMotivo: v.xMotivo };
       logger.info("nfe.status", { cStat: v.cStat });
       if (!cstatEm(v.cStat, "servicoEmOperacao"))
         return rejeitado(status);
-      return authorized(status, {
+      return criarAutorizado(status, {
         cUF: v.cUF,
         verAplic: v.verAplic,
         dhRecbto: v.dhRecbto,
@@ -3946,15 +4146,15 @@ function createNfeClient(options) {
       ]);
       const ep = endpointDaChave("NFeAutorizacao", chaveDoDocumento(a));
       const r = await call(ep, "NFeAutorizacao", msg, "retEnviNFe", opcoes.signal);
-      const v = decode(TRetEnviNFe, r.ret, r.doc.source).value;
+      const v = decodificar(TRetEnviNFe, r.ret, r.doc.texto).valor;
       const status = { cStat: v.cStat, xMotivo: v.xMotivo };
       logger.info("nfe.autorizacao", { chNFe: a.id.slice(3), cStat: v.cStat, sincrono });
       if (cstatEm(v.cStat, "loteRecebido")) {
         const nRec = v.infRec?.nRec;
         if (!nRec)
-          throw new ProtocolError4("lote recebido sem número de recibo");
+          throw new ErroRespostaInvalida4("lote recebido sem número de recibo");
         const tMed = Number(v.infRec?.tMed ?? "0");
-        return pending(status, { ref: nRec, retryAfterMs: Math.max(1, tMed) * 1000 });
+        return criarPendente(status, { referencia: nRec, aguardarMs: Math.max(1, tMed) * 1000 });
       }
       const protEl = protNFeDaChave(r.ret, a);
       if (protEl)
@@ -3968,21 +4168,23 @@ function createNfeClient(options) {
       const mult = politica.multiplicador ?? 1.5;
       const teto = politica.esperaMaximaMs ?? 30000;
       if (!(max >= 1) || !(minimo >= 0) || !(mult >= 1) || !(teto >= minimo)) {
-        throw new ConfigError4("política de consulta do recibo inválida", { details: { max, minimo, mult, teto } });
+        throw new ErroDeConfiguracao4("política de consulta do recibo inválida", {
+          detalhes: { max, minimo, mult, teto }
+        });
       }
       let espera = minimo;
       let ultimo;
       for (let i = 0;i < max; i++) {
         await sleep(espera, politica.signal);
         ultimo = await consultarRecibo(nRec, nfeAssinada, politica);
-        if (ultimo.status !== "pending")
+        if (ultimo.tipo !== "pendente")
           return ultimo;
-        espera = Math.min(teto, Math.max(minimo, Math.round(espera * mult), ultimo.retryAfterMs ?? 0));
+        espera = Math.min(teto, Math.max(minimo, Math.round(espera * mult), ultimo.aguardarMs ?? 0));
       }
       return ultimo;
     },
     consultar,
-    async cancelar(p) {
+    async cancelar(p, opcoes) {
       const c = chaveValida(p.chave, "chave");
       return enviarEvento({
         ct: TEventoCanc,
@@ -3993,17 +4195,18 @@ function createNfeClient(options) {
         autor: autorDoEmitente(p.autor, c),
         detEvento: { versao: EVENTO_VERSAO, descEvento: "Cancelamento", nProt: p.nProt, xJust: p.xJust },
         endpoint: endpointDaChave("RecepcaoEvento", c),
-        offsetMinutes: offsetDe(c.uf)
+        offsetMinutes: offsetDe(c.uf),
+        signal: opcoes?.signal
       });
     },
-    async cancelarPorSubstituicao(p) {
+    async cancelarPorSubstituicao(p, opcoes) {
       const c = chaveValida(p.chave, "chave");
       if (c.mod !== "65") {
-        throw new ValidationError2("cancelamento por substituição só existe para NFC-e", [
+        throw new ErroDeValidacao2("cancelamento por substituição só existe para NFC-e", [
           {
-            path: "chave",
+            caminho: "chave",
             code: "modelo_nao_suportado",
-            message: "O evento 110112 é exclusivo da NFC-e (modelo 65)"
+            mensagem: "O evento 110112 é exclusivo da NFC-e (modelo 65)"
           }
         ]);
       }
@@ -4027,13 +4230,14 @@ function createNfeClient(options) {
         autor: autorDoEmitente(p.autor, c),
         detEvento,
         endpoint: endpointDaChave("RecepcaoEvento", c),
-        offsetMinutes: offsetDe(c.uf)
+        offsetMinutes: offsetDe(c.uf),
+        signal: opcoes?.signal
       });
     },
-    async cartaCorrecao(p) {
+    async cartaCorrecao(p, opcoes) {
       const c = chaveValida(p.chave, "chave");
       if (!Number.isInteger(p.nSeqEvento) || p.nSeqEvento < 1 || p.nSeqEvento > 20) {
-        throw new ConfigError4(`nSeqEvento da CC-e vai de 1 a 20: ${p.nSeqEvento}`);
+        throw new ErroDeConfiguracao4(`nSeqEvento da CC-e vai de 1 a 20: ${p.nSeqEvento}`);
       }
       return enviarEvento({
         ct: TEventoCce,
@@ -4049,14 +4253,15 @@ function createNfeClient(options) {
           xCondUso: XCONDUSO
         },
         endpoint: endpointDaChave("RecepcaoEvento", c, true),
-        offsetMinutes: offsetDe(c.uf)
+        offsetMinutes: offsetDe(c.uf),
+        signal: opcoes?.signal
       });
     },
-    async manifestar(p) {
+    async manifestar(p, opcoes) {
       const c = chaveValida(p.chave, "chave");
       const m = MANIFESTACOES[p.tipo];
       if (!m)
-        throw new ConfigError4(`tipo de manifestação desconhecido: ${String(p.tipo)}`);
+        throw new ErroDeConfiguracao4(`tipo de manifestação desconhecido: ${String(p.tipo)}`);
       return enviarEvento({
         ct: m.ct,
         tpEvento: m.tpEvento,
@@ -4069,18 +4274,19 @@ function createNfeClient(options) {
           descEvento: m.descEvento,
           ...p.xJust === undefined ? {} : { xJust: p.xJust }
         },
-        endpoint: nfeEndpoint({ ambiente: options.ambiente, servico: "RecepcaoEvento", autorizador: "AN" }),
-        offsetMinutes: offsetDe(options.uf ?? c.uf)
+        endpoint: nfeEndpoint({ ambiente: opcoesDoCliente.ambiente, servico: "RecepcaoEvento", autorizador: "AN" }),
+        offsetMinutes: offsetDe(opcoesDoCliente.uf ?? c.uf),
+        signal: opcoes?.signal
       });
     },
-    async inutilizar(p) {
+    async inutilizar(p, opcoes) {
       const autor = autorPadrao(p.autor, "autor");
       if (!("CNPJ" in autor)) {
-        throw new ValidationError2("inutilização não se aplica ao emitente pessoa física", [
+        throw new ErroDeValidacao2("inutilização não se aplica ao emitente pessoa física", [
           {
-            path: "autor.CPF",
+            caminho: "autor.CPF",
             code: "inutilizacao_emitente_cpf",
-            message: "O pedido de inutilização só existe para emitente CNPJ (NT 2018.001 v1.10, item 6.1)"
+            mensagem: "O pedido de inutilização só existe para emitente CNPJ (NT 2018.001 v1.10, item 6.1)"
           }
         ]);
       }
@@ -4099,16 +4305,16 @@ function createNfeClient(options) {
         ["nNFFin", fin, /^[1-9][0-9]{0,8}$/]
       ]) {
         if (!re.test(x))
-          throw new ConfigError4(`${k} inválido para inutilização: ${x}`);
+          throw new ErroDeConfiguracao4(`${k} inválido para inutilização: ${x}`);
       }
       if (Number(fin) < Number(ini))
-        throw new ConfigError4("nNFFin menor que nNFIni");
+        throw new ErroDeConfiguracao4("nNFFin menor que nNFIni");
       if (Number(serie) >= 910 && Number(serie) <= 969) {
-        throw new ValidationError2("série de emitente pessoa física não se inutiliza", [
+        throw new ErroDeValidacao2("série de emitente pessoa física não se inutiliza", [
           {
-            path: "serie",
+            caminho: "serie",
             code: "inutilizacao_serie_cpf",
-            message: "Série 910 a 969 identifica emitente CPF: a SEFAZ rejeita com 266 (NT 2018.001 v1.10, regra I02a)"
+            mensagem: "Série 910 a 969 identifica emitente CPF: a SEFAZ rejeita com 266 (NT 2018.001 v1.10, regra I02a)"
           }
         ]);
       }
@@ -4126,14 +4332,14 @@ function createNfeClient(options) {
         nNFFin: fin,
         xJust: p.xJust
       };
-      const infXml = serialize3(TInutNFe_infInut, "infInut", inf, NFE_NS4);
+      const infXml = serializar3(TInutNFe_infInut, "infInut", inf, NFE_NS4);
       const inut = envelope("inutNFe", "4.00", [infXml]);
-      const infEl = firstChild5(parseXml6(inut).root, "infInut", NFE_NS4);
-      schemaIssues("pedido de inutilização", validate4(TInutNFe_infInut, infEl));
-      const assinado = await signXml2(inut, { id }, options.signer);
-      const ep = mod === "65" ? endpointNfce("NfeInutilizacao", uf) : nfeEndpoint({ ambiente: options.ambiente, servico: "NfeInutilizacao", uf });
-      const r = await call(ep, "NfeInutilizacao", assinado, "retInutNFe");
-      const v = decode(TRetInutNFe, r.ret, r.doc.source).value;
+      const infEl = primeiroFilho5(lerXml6(inut).raiz, "infInut", NFE_NS4);
+      schemaIssues("pedido de inutilização", validar4(TInutNFe_infInut, infEl));
+      const assinado = await assinarXml2(inut, { id }, opcoesDoCliente.assinador);
+      const ep = mod === "65" ? endpointNfce("NfeInutilizacao", uf) : nfeEndpoint({ ambiente: opcoesDoCliente.ambiente, servico: "NfeInutilizacao", uf });
+      const r = await call(ep, "NfeInutilizacao", assinado, "retInutNFe", opcoes?.signal);
+      const v = decodificar(TRetInutNFe, r.ret, r.doc.texto).valor;
       const status = { cStat: v.infInut.cStat, xMotivo: v.infInut.xMotivo };
       logger.info("nfe.inutilizacao", { id, cStat: status.cStat });
       if (!cstatEm(status.cStat, "inutilizacaoHomologada"))
@@ -4150,65 +4356,65 @@ function createNfeClient(options) {
       ];
       const fora = confere.filter(([, veio, pedido]) => veio !== undefined && veio !== pedido);
       if (fora.length > 0) {
-        throw new ProtocolError4("retInutNFe de outra faixa", {
-          details: Object.fromEntries(fora.map(([k, v]) => [k, v]))
+        throw new ErroRespostaInvalida4("retInutNFe de outra faixa", {
+          detalhes: Object.fromEntries(fora.map(([k, v]) => [k, v]))
         });
       }
-      return authorized(status, {
+      return criarAutorizado(status, {
         dhRecbto: v.infInut.dhRecbto,
         retInutNFe: avulso(r.doc, r.ret),
-        procInutNFe: envelope("ProcInutNFe", "4.00", [assinado, sliceElement(r.doc, r.ret)]),
+        procInutNFe: envelope("ProcInutNFe", "4.00", [assinado, recortarElemento(r.doc, r.ret)]),
         ...v.infInut.nProt === undefined ? {} : { nProt: v.infInut.nProt }
       });
     },
-    async consultarCadastro(p) {
+    async consultarCadastro(p, opcoes) {
       const doc = "CNPJ" in p ? documentoAutor({ CNPJ: p.CNPJ }, "CNPJ") : ("CPF" in p) ? documentoAutor({ CPF: p.CPF }, "CPF") : { IE: p.IE.replace(/[^0-9A-Za-z]/g, "").toUpperCase() };
-      const msg = serializeRoot(ConsCadElement, { versao: "2.00", infCons: { xServ: "CONS-CAD", UF: p.uf, ...doc } });
-      const ep = nfeEndpoint({ ambiente: options.ambiente, servico: "NfeConsultaCadastro", uf: p.uf });
-      const r = await call(ep, "NfeConsultaCadastro", msg, "retConsCad");
-      const v = decode(TRetConsCad, r.ret, r.doc.source).value;
+      const msg = serializarRaiz(ConsCadElement, { versao: "2.00", infCons: { xServ: "CONS-CAD", UF: p.uf, ...doc } });
+      const ep = nfeEndpoint({ ambiente: opcoesDoCliente.ambiente, servico: "NfeConsultaCadastro", uf: p.uf });
+      const r = await call(ep, "NfeConsultaCadastro", msg, "retConsCad", opcoes?.signal);
+      const v = decodificar(TRetConsCad, r.ret, r.doc.texto).valor;
       const i = v.infCons;
       const status = { cStat: i.cStat, xMotivo: i.xMotivo };
       logger.info("nfe.cadastro", { uf: p.uf, cStat: i.cStat });
       if (!cstatEm(i.cStat, "cadastroEncontrado"))
         return rejeitado(status);
-      return authorized(status, { UF: i.UF, dhCons: i.dhCons, infCad: i.infCad ?? [] });
+      return criarAutorizado(status, { UF: i.UF, dhCons: i.dhCons, infCad: i.infCad ?? [] });
     },
     async distribuicaoDFe(consulta, opcoes = {}) {
       const autor = autorPadrao(opcoes.autor, "autor");
       const nsu = (x, k) => {
         const s = String(x);
         if (!/^[0-9]{1,15}$/.test(s))
-          throw new ConfigError4(`${k} inválido: ${s}`);
+          throw new ErroDeConfiguracao4(`${k} inválido: ${s}`);
         return s.padStart(15, "0");
       };
       const grupo = "ultNSU" in consulta ? { distNSU: { ultNSU: nsu(consulta.ultNSU, "ultNSU") } } : ("NSU" in consulta) ? { consNSU: { NSU: nsu(consulta.NSU, "NSU") } } : { consChNFe: { chNFe: chaveValida(consulta.chNFe, "chNFe").chave } };
       const cUFAutor = opcoes.cUFAutor ?? ufPadrao("NFeDistribuicaoDFe").cUF;
-      if (ufByCUf2(cUFAutor) === undefined)
-        throw new ConfigError4(`cUFAutor inválido: ${cUFAutor}`);
-      const msg = serializeRoot(distDFeIntElement, {
+      if (ufPorCUf2(cUFAutor) === undefined)
+        throw new ErroDeConfiguracao4(`cUFAutor inválido: ${cUFAutor}`);
+      const msg = serializarRaiz(distDFeIntElement, {
         versao: "1.01",
         tpAmb,
         cUFAutor,
         ...autor,
         ...grupo
       });
-      const ep = nfeEndpoint({ ambiente: options.ambiente, servico: "NFeDistribuicaoDFe" });
-      const r = await call(ep, "NFeDistribuicaoDFe", msg, "retDistDFeInt");
-      const v = decode(retDistDFeInt, r.ret, r.doc.source).value;
+      const ep = nfeEndpoint({ ambiente: opcoesDoCliente.ambiente, servico: "NFeDistribuicaoDFe" });
+      const r = await call(ep, "NFeDistribuicaoDFe", msg, "retDistDFeInt", opcoes.signal);
+      const v = decodificar(retDistDFeInt, r.ret, r.doc.texto).valor;
       const status = { cStat: v.cStat, xMotivo: v.xMotivo };
       logger.info("nfe.distribuicao", { cStat: v.cStat, ultNSU: v.ultNSU, maxNSU: v.maxNSU });
       const base = { ultNSU: v.ultNSU, maxNSU: v.maxNSU, dhResp: v.dhResp };
       if (cstatEm(v.cStat, "distribuicaoNenhumDocumento"))
-        return authorized(status, { ...base, documentos: [] });
+        return criarAutorizado(status, { ...base, documentos: [] });
       if (!cstatEm(v.cStat, "distribuicaoDocumentos"))
         return rejeitado(status);
       const documentos = [];
       for (const z of v.loteDistDFeInt?.docZip ?? []) {
-        const xml = await gunzipBase64(z.$text);
+        const xml = await descomprimirGzipBase64(z.$text);
         documentos.push(documentoDistribuido(z.NSU ?? "", z.schema, xml));
       }
-      return authorized(status, { ...base, documentos });
+      return criarAutorizado(status, { ...base, documentos });
     }
   };
   return client;
@@ -4217,9 +4423,9 @@ function documentoDistribuido(NSU, schema, xml) {
   const nome = schema.replace(/_v?\d.*$/, "");
   const base = { NSU, schema, xml };
   if (nome === "resNFe")
-    return { ...base, tipo: "resNFe", resNFe: decodeXml(resNFeElement, xml).value };
+    return { ...base, tipo: "resNFe", resNFe: decodificarXml(resNFeElement, xml).valor };
   if (nome === "resEvento")
-    return { ...base, tipo: "resEvento", resEvento: decodeXml(resEventoElement, xml).value };
+    return { ...base, tipo: "resEvento", resEvento: decodificarXml(resEventoElement, xml).valor };
   if (nome === "procNFe")
     return { ...base, tipo: "procNFe" };
   if (nome === "procEventoNFe")
@@ -4227,23 +4433,23 @@ function documentoDistribuido(NSU, schema, xml) {
   return { ...base, tipo: "outro" };
 }
 // packages/nfe/src/services/recuperar.ts
-import { firstChild as firstChild6, parseXml as parseXml7, textOf as textOf3 } from "@sinete/core/xml";
+import { lerXml as lerXml7, primeiroFilho as primeiroFilho6, textoDe as textoDe3 } from "@sinete/core/xml";
 function campo(el, local) {
-  const c = firstChild6(el, local, NFE_NS4);
-  return c === undefined ? undefined : textOf3(c).trim();
+  const c = primeiroFilho6(el, local, NFE_NS4);
+  return c === undefined ? undefined : textoDe3(c).trim();
 }
 function lerProcEvento(xml) {
   let doc;
   try {
-    doc = parseXml7(xml);
+    doc = lerXml7(xml);
   } catch {
     return;
   }
-  const evento = firstChild6(doc.root, "evento", NFE_NS4);
-  const pedido = evento === undefined ? undefined : firstChild6(evento, "infEvento", NFE_NS4);
-  const retEl = firstChild6(doc.root, "retEvento", NFE_NS4);
-  const ret = retEl === undefined ? undefined : firstChild6(retEl, "infEvento", NFE_NS4);
-  if (doc.root.local !== "procEventoNFe" || pedido === undefined || retEl === undefined || ret === undefined) {
+  const evento = primeiroFilho6(doc.raiz, "evento", NFE_NS4);
+  const pedido = evento === undefined ? undefined : primeiroFilho6(evento, "infEvento", NFE_NS4);
+  const retEl = primeiroFilho6(doc.raiz, "retEvento", NFE_NS4);
+  const ret = retEl === undefined ? undefined : primeiroFilho6(retEl, "infEvento", NFE_NS4);
+  if (doc.raiz.local !== "procEventoNFe" || pedido === undefined || retEl === undefined || ret === undefined) {
     return;
   }
   const cStat = campo(ret, "cStat");
@@ -4268,19 +4474,21 @@ function lerProcEvento(xml) {
     tpEvento,
     nSeqEvento: String(Number(nSeq)),
     dhRegEvento,
-    retEvento: sliceElement(doc, retEl, ""),
+    retEvento: recortarElemento(doc, retEl, ""),
     procEventoNFe: xml,
     ...nProt === undefined ? {} : { nProt }
   };
 }
-async function recuperarEventoRegistrado(client, chave, tpEvento) {
-  const consulta = await client.consultar(chave);
-  if (consulta.status !== "authorized" && consulta.status !== "denied")
+async function recuperarEventoRegistrado(cliente, chave, tpEvento, nSeqEvento, opcoes) {
+  const consulta = await cliente.consultar(chave, undefined, opcoes);
+  if (consulta.tipo !== "autorizado" && consulta.tipo !== "denegado")
     return { registrado: false, consulta };
   let achado;
-  for (const xml of consulta.value.eventos) {
+  for (const xml of consulta.valor.eventos) {
     const e = lerProcEvento(xml);
-    if (e === undefined || e.chNFe !== consulta.value.chNFe || e.tpEvento !== tpEvento)
+    if (e === undefined || e.chNFe !== consulta.valor.chNFe || e.tpEvento !== tpEvento)
+      continue;
+    if (nSeqEvento !== undefined && Number(e.nSeqEvento) !== nSeqEvento)
       continue;
     if (achado === undefined || Number(e.nSeqEvento) > Number(achado.nSeqEvento))
       achado = e;
@@ -4288,83 +4496,83 @@ async function recuperarEventoRegistrado(client, chave, tpEvento) {
   return achado === undefined ? { registrado: false, consulta } : { registrado: true, evento: achado, consulta };
 }
 // packages/nfe/src/services/resolver.ts
-import { authorized as authorized2, denied as denied2 } from "@sinete/core";
+import { criarAutorizado as criarAutorizado2, criarDenegado as criarDenegado2 } from "@sinete/core";
 var CHAVE_NO_MOTIVO = /\[\s*chNFe\s*:\s*([0-9]{6}[0-9A-Z]{12}[0-9]{26})\s*\]/i;
 function chaveDaDuplicidade(xMotivo) {
   return CHAVE_NO_MOTIVO.exec(xMotivo)?.[1]?.toUpperCase();
 }
-async function resolverEnvioSemResposta(client, nfeAssinada, anterior) {
+async function resolverEnvioSemResposta(cliente, nfeAssinada, anterior, opcoes) {
   const a = documentoAssinado(nfeAssinada, "NFe", "infNFe");
   const chave = a.id.slice(3);
-  if (anterior && anterior.status === "rejected" && cstatEm(anterior.cStat, "duplicidadeChaveDiferente")) {
+  if (anterior && anterior.tipo === "recusado" && cstatEm(anterior.cStat, "duplicidadeChaveDiferente")) {
     const outra = chaveDaDuplicidade(anterior.xMotivo);
     return { acao: "divergente", motivo: anterior, ...outra === undefined ? {} : { chNFe: outra } };
   }
-  const consulta = await client.consultar(chave, nfeAssinada);
-  if (consulta.status === "rejected") {
+  const consulta = await cliente.consultar(chave, nfeAssinada, opcoes);
+  if (consulta.tipo === "recusado") {
     if (cstatEm(consulta.cStat, "naoConsta"))
       return { acao: "reenviar", nfeAssinada: a.xml };
     if (cstatEm(consulta.cStat, "outraNfeNoNumero")) {
       const outra = chaveDaDuplicidade(consulta.xMotivo);
       return { acao: "divergente", motivo: consulta, ...outra === undefined ? {} : { chNFe: outra } };
     }
-    return { acao: "indefinida", outcome: consulta };
+    return { acao: "indefinida", resultado: consulta };
   }
-  if (consulta.status === "pending")
-    return { acao: "indefinida", outcome: consulta };
-  const v = consulta.value;
+  if (consulta.tipo === "pendente")
+    return { acao: "indefinida", resultado: consulta };
+  const v = consulta.valor;
   const p = v.protocolo;
   if (!p)
-    return { acao: "indefinida", outcome: consulta };
+    return { acao: "indefinida", resultado: consulta };
   const conteudo = p.digVal === undefined ? "sem-digval" : v.digValConfere === true ? "confere" : "difere";
   const protStatus = { cStat: p.cStat, xMotivo: p.xMotivo };
   if (v.situacao === "denegada")
-    return { acao: "concluida", situacao: "denegada", conteudo, outcome: denied2(protStatus, p) };
+    return { acao: "concluida", situacao: "denegada", conteudo, resultado: criarDenegado2(protStatus, p) };
   if (conteudo === "difere")
     return { acao: "divergente", chNFe: chave, consulta, motivo: consulta };
   if (conteudo === "sem-digval")
     return { acao: "sem-prova", situacao: v.situacao, consulta };
   if (p.nfeProc === undefined)
-    return { acao: "indefinida", outcome: consulta };
-  return { acao: "concluida", situacao: v.situacao, conteudo, outcome: authorized2(protStatus, p) };
+    return { acao: "indefinida", resultado: consulta };
+  return { acao: "concluida", situacao: v.situacao, conteudo, resultado: criarAutorizado2(protStatus, p) };
 }
 export {
+  CODIGOS_OCORRENCIA_NFE,
   Decimal,
   MotivoDesoneracaoIcms,
   NFCE_LIMITE_SEM_DESTINATARIO,
-  NFE_ISSUE_CODES,
   NFE_NS3 as NFE_NS,
   TipoPagamento,
   XNOME_HOMOLOGACAO,
   XPROD_HOMOLOGACAO_NFCE,
+  assinarNfe,
   assinaturaQrCode,
   autorizadorContingencia,
-  buildNfe,
+  calculadoraIbsCbs,
   carregarDatasetEmbarcado,
   chaveDaDuplicidade,
   comQrCode,
   conferirEmitenteDoCertificado,
-  createNfeClient,
+  criarClienteNfe,
   dec,
+  descomprimirGzipBase64,
+  deslocamentoDaUf,
   documentoAssinado,
   exigenciaRespTec,
-  formatDecimal,
-  formatDh,
-  formatProblem,
-  gunzipBase64,
+  formatarDecimal,
+  formatarDh,
   hashCsrt,
-  ibsCbsCalculator,
   localDaOperacao,
+  montarNfe,
   nfeAssinadaDoProc,
-  offsetDaUf,
+  problemaDeFormato,
+  recortarElemento,
   recuperarEventoRegistrado,
   resolverEnvioSemResposta,
   rotuloDoCaminho,
-  signNfe,
-  sliceElement,
   sum,
   urlsNfce
 };
 
-//# debugId=91E6FDD0B4D20CBD64756E2164756E21
+//# debugId=9351F0AE81B9EE1064756E2164756E21
 //# sourceMappingURL=index.js.map