@sinete/nfe 0.1.0 → 0.3.0

package/src/services/soap.ts

@@ -1,14 +1,14 @@
 /**
  * Chamada SOAP 1.2 a um web service da NF-e 4.00: monta o corpo com o namespace do WSDL (dado em `data/servicos.json`),
- * envia pelo `Transport` injetado e devolve o elemento de retorno como fatia da resposta, com a árvore para leitura.
+ * envia pelo `Transporte` injetado e devolve o elemento de retorno como fatia da resposta, com a árvore para leitura.
  */
 
 import type { Logger } from '@sinete/core';
-import { ProtocolError } from '@sinete/core';
-import type { XmlDocument, XmlElement } from '@sinete/core/xml';
-import { childElements, descendants, parseXml } from '@sinete/core/xml';
-import type { EndpointRef, NfeServico, Transport } from '@sinete/transport';
-import { soap12ContentType, soap12Envelope, soapFault } from '@sinete/transport';
+import { ErroRespostaInvalida } from '@sinete/core';
+import type { DocumentoXml, ElementoXml } from '@sinete/core/xml';
+import { descendentes, elementosFilhos, lerXml } from '@sinete/core/xml';
+import type { EndpointResolvido, NfeServico, Transporte } from '@sinete/transport';
+import { contentTypeSoap12, envelopeSoap12, lerSoapFault } from '@sinete/transport';
 import servicos from '../data/servicos.json' with { type: 'json' };
 import { NFE_NS } from './proc.ts';
 
@@ -29,7 +29,7 @@ const SERVICOS: Readonly<Record<string, ServicoInfo>> = servicos.servicos;
 /** Namespace do WSDL e operação do serviço. */
 export function servicoInfo(servico: NfeServico): ServicoInfo {
   const s = SERVICOS[servico];
-  if (!s) throw new ProtocolError(`serviço sem descrição em data/servicos.json: ${servico}`);
+  if (!s) throw new ErroRespostaInvalida(`serviço sem descrição em data/servicos.json: ${servico}`);
   return s;
 }
 
@@ -44,14 +44,14 @@ export function soapBodyFor(servico: NfeServico, mensagem: string, autorizador?:
 
 /** Resposta de um serviço: o documento inteiro (para fatiar) e o elemento de retorno. */
 export interface RespostaSoap {
-  readonly doc: XmlDocument;
-  readonly ret: XmlElement;
+  readonly doc: DocumentoXml;
+  readonly ret: ElementoXml;
   readonly status: number;
 }
 
 export interface ChamadaSoap {
-  readonly transport: Transport;
-  readonly endpoint: EndpointRef;
+  readonly transport: Transporte;
+  readonly endpoint: EndpointResolvido;
   readonly servico: NfeServico;
   readonly mensagem: string;
   /** Nome local do elemento de retorno (`retEnviNFe`, `retConsSitNFe`...). */
@@ -61,57 +61,57 @@ export interface ChamadaSoap {
   readonly logger: Logger;
 }
 
-/** Envia e devolve o elemento de retorno. Fault SOAP, retorno ausente ou XML malformado viram `ProtocolError`. */
+/** Envia e devolve o elemento de retorno. Fault SOAP, retorno ausente ou XML malformado viram `ErroRespostaInvalida`. */
 export async function chamar(c: ChamadaSoap): Promise<RespostaSoap> {
   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 ProtocolError(`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 ErroRespostaInvalida(`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: XmlDocument;
+  let doc: DocumentoXml;
   try {
-    doc = parseXml(text.replace(/^/, ''));
+    doc = lerXml(text.replace(/^/, ''));
   } catch (cause) {
-    throw new ProtocolError(`resposta de ${c.endpoint.host} não é XML (HTTP ${res.status})`, {
+    throw new ErroRespostaInvalida(`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: XmlElement | undefined;
-  for (const el of descendants(doc.root)) {
+  let ret: ElementoXml | undefined;
+  for (const el of descendentes(doc.raiz)) {
     if (el.local === c.retorno && el.ns === NFE_NS) {
       ret = el;
       break;
     }
   }
-  if (!ret) ret = retornoForaDoNamespace(doc.root, c.retorno);
+  if (!ret) ret = retornoForaDoNamespace(doc.raiz, c.retorno);
   if (ret && ret.ns !== NFE_NS) {
     // A SEFAZ-MG devolve o <retConsCad> sem o namespace da NF-e: ele herda o default do WSDL do nfeResultMsg, e só
     // os filhos declaram o da NF-e (visto em homologação e em produção em 28/09/2026). O conteúdo é o do leiaute.
     c.logger.warn('nfe.soap.retorno_fora_do_namespace', { ...started, retorno: c.retorno, ns: ret.ns });
   }
   if (!ret) {
-    throw new ProtocolError(`resposta de ${c.endpoint.host} sem <${c.retorno}> (HTTP ${res.status})`, {
-      details: { status: res.status, servico: c.servico },
+    throw new ErroRespostaInvalida(`resposta de ${c.endpoint.host} sem <${c.retorno}> (HTTP ${res.status})`, {
+      detalhes: { status: res.status, servico: c.servico },
     });
   }
-  if (!Array.from(descendants(ret)).some((el) => el.local === 'cStat' && el.ns === NFE_NS)) {
-    throw new ProtocolError(`<${c.retorno}> de ${c.endpoint.host} sem cStat (HTTP ${res.status})`, {
-      details: { status: res.status, servico: c.servico },
+  if (!Array.from(descendentes(ret)).some((el) => el.local === 'cStat' && el.ns === NFE_NS)) {
+    throw new ErroRespostaInvalida(`<${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 });
@@ -123,10 +123,10 @@ export async function chamar(c: ChamadaSoap): Promise<RespostaSoap> {
  * NF-e: é o caso do autorizador que esquece o `xmlns` no elemento de retorno e o declara nos filhos. Com os filhos
  * fora do namespace, a resposta continua recusada.
  */
-function retornoForaDoNamespace(root: XmlElement, retorno: string): XmlElement | undefined {
-  for (const el of descendants(root)) {
+function retornoForaDoNamespace(root: ElementoXml, retorno: string): ElementoXml | undefined {
+  for (const el of descendentes(root)) {
     if (el.local !== retorno) continue;
-    const filhos = childElements(el);
+    const filhos = elementosFilhos(el);
     if (filhos.length > 0 && filhos.every((f) => f.ns === NFE_NS)) return el;
   }
   return undefined;

package/src/time.ts

@@ -3,21 +3,21 @@
  * tabela `data/fusos.json` pela UF, ou do chamador; nunca do fuso da máquina.
  */
 
-import type { Clock, Uf } from '@sinete/core';
-import { formatDateTimeOffset } from '@sinete/core';
+import type { Relogio, Uf } from '@sinete/core';
+import { formatarDataHoraComFuso } from '@sinete/core';
 import fusos from './data/fusos.json' with { type: 'json' };
 
 /** Instante no tempo, como os relógios do `@sinete/core` o devolvem (o tipo `Date`, sem tocar no global). */
-export type Instante = ReturnType<Clock['now']>;
+export type Instante = ReturnType<Relogio['agora']>;
 
 const UF_OFFSETS: Readonly<Record<string, number>> = fusos.ufs;
 
 /** Deslocamento do horário legal da UF em minutos (`-180` para Brasília). */
-export function offsetDaUf(uf: Uf): number {
+export function deslocamentoDaUf(uf: Uf): number {
   return Object.hasOwn(UF_OFFSETS, uf) ? (UF_OFFSETS[uf] as number) : fusos.padrao;
 }
 
 /** `TDateTimeUTC` do instante no deslocamento dado. */
-export function formatDh(date: Instante, offsetMinutes: number): string {
-  return formatDateTimeOffset(date, offsetMinutes);
+export function formatarDh(data: Instante, deslocamentoMin: number): string {
+  return formatarDataHoraComFuso(data, deslocamentoMin);
 }

package/src/versao-gerada.ts

@@ -1,3 +1,3 @@
 // GERADO por scripts/versao-gerada.ts a partir do package.json. Não edite: rode `bun scripts/versao-gerada.ts`.
 /** Versão de `@sinete/nfe`, para o padrão de `verProc`/`verAplic` (`formatarVerProc` do @sinete/core). */
-export const VERSAO_PACOTE = '0.1.0';
+export const VERSAO_PACOTE = '0.3.0';