@baruk/core 0.4.2 → 0.5.0

package/dist/fiscal/ingestion/synthetic-provider.js

@@ -0,0 +1,99 @@
+import { FiscalProviderError, } from './provider.js';
+import { FiscalTransportError } from '../transport/types.js';
+export class SyntheticFiscalProvider {
+    options;
+    /** Chamadas atendidas. O teste de replay e o de retentativa a inspecionam. */
+    calls = 0;
+    /** NSUs entregues em cada chamada, para conferir que não houve lacuna. */
+    delivered = [];
+    lastBatch = [];
+    lastResult = null;
+    constructor(options) {
+        this.options = options;
+    }
+    get docs() {
+        // Ordem crescente de NSU, como o manual explicita. O construtor não exige
+        // a lista ordenada porque um teste que a embaralha está exercitando o
+        // provedor, não o motor.
+        return [...this.options.documents].sort((a, b) => Number(a.nsu) - Number(b.nsu));
+    }
+    async fetchDfe(input) {
+        const chamada = this.calls;
+        this.calls += 1;
+        const permitidos = this.options.environments ?? ['synthetic'];
+        if (!permitidos.includes(input.environment)) {
+            throw new FiscalProviderError('auth', `provedor sintético não opera "${input.environment}"`, 'SYNTHETIC_ENVIRONMENT_REFUSED');
+        }
+        const fault = this.options.script?.[chamada] ?? { kind: 'ok' };
+        const now = this.options.now?.() ?? new Date();
+        switch (fault.kind) {
+            case 'rate_limit':
+                throw new FiscalProviderError('throttled', 'consumo excedido', 'HTTP_429', new Date(now.getTime() + (fault.retryAfterSeconds ?? 120) * 1000));
+            case 'unauthorized':
+                throw new FiscalProviderError('auth', 'credencial recusada', 'HTTP_401');
+            case 'forbidden':
+                throw new FiscalProviderError('not_allowed', 'sem direito ao documento', 'HTTP_403');
+            case 'server_error':
+                throw new FiscalProviderError('transient', 'provedor indisponível', `HTTP_${fault.status ?? 503}`);
+            case 'timeout':
+                // Erro de TRANSPORTE, e não de provedor: é assim que ele chega na
+                // realidade, e é o caminho de classificação que precisa ser exercitado.
+                throw new FiscalTransportError('timeout', 'DEADLINE_EXCEEDED');
+            case 'replay': {
+                // O mesmo lote de novo, com o MESMO cursor devolvido. É o caso que a
+                // deduplicação existe para absorver, e o cursor não pode retroceder.
+                if (this.lastResult) {
+                    this.delivered.push(this.lastBatch.map((d) => d.nsu));
+                    return this.lastResult;
+                }
+                break;
+            }
+            case 'malformed': {
+                const lote = [
+                    {
+                        nsu: String(Number(input.fromNsu ?? '0') + 1),
+                        raw: new TextEncoder().encode('<<< isto nao e XML >>>'),
+                        mimeType: 'application/xml',
+                    },
+                ];
+                this.delivered.push(lote.map((d) => d.nsu));
+                const resultado = {
+                    documents: lote,
+                    lastNsu: lote[0].nsu,
+                    maxNsu: this.docs.at(-1)?.nsu ?? lote[0].nsu,
+                    exhausted: false,
+                    providerStatus: 'SYNTHETIC_MALFORMED',
+                };
+                this.lastBatch = lote;
+                this.lastResult = resultado;
+                return resultado;
+            }
+            case 'ok':
+                break;
+        }
+        const from = input.fromNsu ? Number(input.fromNsu) : 0;
+        const limite = Math.min(input.batchLimit, this.options.batchLimit ?? 50);
+        const restantes = this.docs.filter((d) => Number(d.nsu) > from);
+        const lote = restantes.slice(0, limite).map((d) => ({
+            nsu: d.nsu,
+            raw: new TextEncoder().encode(d.xml),
+            mimeType: 'application/xml',
+        }));
+        const maxNsu = this.docs.at(-1)?.nsu ?? null;
+        const lastNsu = lote.at(-1)?.nsu ?? input.fromNsu ?? null;
+        const resultado = {
+            documents: lote,
+            lastNsu,
+            maxNsu,
+            // Esgotado é o servidor DIZENDO que a posição alcançou o máximo — a
+            // condição que arma a espera obrigatória. Nunca "o lote veio vazio".
+            exhausted: maxNsu !== null && lastNsu === maxNsu,
+            providerStatus: null,
+        };
+        this.delivered.push(lote.map((d) => d.nsu));
+        this.lastBatch = lote;
+        this.lastResult = resultado;
+        return resultado;
+    }
+}
+//# sourceMappingURL=synthetic-provider.js.map

package/dist/fiscal/ingestion/synthetic-provider.js.map

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

package/dist/fiscal/ingestion/synthetic-transport-types.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Reexportações para o transporte sintético.
+ *
+ * Existe só para que `synthetic-transport.ts` não importe do adapter concreto —
+ * o transporte é do CONTRATO, não da NFS-e, e um dia servirá ao DF-e da NF-e
+ * sem mudar de casa.
+ */
+export { FiscalProviderError, type FiscalEnvironmentTag, type FiscalFetchResult, type RawFiscalDocument, } from './provider.js';
+import type { FiscalEnvironmentTag, FiscalFetchResult } from './provider.js';
+/** A forma mínima que o adapter espera de um transporte. */
+export interface AdnTransportLike {
+    fetchDfe(input: {
+        actorDocument: string;
+        fromNsu: string | null;
+        batchLimit: number;
+        environment: FiscalEnvironmentTag;
+    }): Promise<FiscalFetchResult>;
+}
+//# sourceMappingURL=synthetic-transport-types.d.ts.map

package/dist/fiscal/ingestion/synthetic-transport-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthetic-transport-types.d.ts","sourceRoot":"","sources":["../../../src/fiscal/ingestion/synthetic-transport-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE7E,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE;QACd,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,oBAAoB,CAAC;KACnC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAChC"}

package/dist/fiscal/ingestion/synthetic-transport-types.js

@@ -0,0 +1,9 @@
+/**
+ * Reexportações para o transporte sintético.
+ *
+ * Existe só para que `synthetic-transport.ts` não importe do adapter concreto —
+ * o transporte é do CONTRATO, não da NFS-e, e um dia servirá ao DF-e da NF-e
+ * sem mudar de casa.
+ */
+export { FiscalProviderError, } from './provider.js';
+//# sourceMappingURL=synthetic-transport-types.js.map

package/dist/fiscal/ingestion/synthetic-transport-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthetic-transport-types.js","sourceRoot":"","sources":["../../../src/fiscal/ingestion/synthetic-transport-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,mBAAmB,GAIpB,MAAM,eAAe,CAAC"}

package/dist/fiscal/ingestion/synthetic-transport.d.ts

@@ -0,0 +1,55 @@
+import { FiscalProviderError, type AdnTransportLike, type FiscalEnvironmentTag, type FiscalFetchResult } from './synthetic-transport-types.js';
+/**
+ * Transporte SINTÉTICO que reproduz a mecânica de cursor do ADN e do DF-e.
+ *
+ * ## Por que existe, e por que não é um mock
+ *
+ * O ADN exige TLS mútuo com certificado ICP-Brasil — inclusive para servir a
+ * própria documentação. Não há caminho de teste sem credencial real, e esta
+ * fase não usa nenhuma. Um mock que devolvesse "dois documentos" provaria
+ * apenas que o código chama uma função.
+ *
+ * Este transporte reproduz o que a norma DESCREVE, e é essa fidelidade que o
+ * torna útil:
+ *
+ *   - lote com no máximo `batchLimit` itens, em ordem crescente de NSU;
+ *   - `ultNSU` e `maxNSU` devolvidos pelo servidor, não calculados pelo cliente;
+ *   - `exhausted` quando `ultNSU == maxNSU` — a condição que a NT 2014.002
+ *     §3.5 usa para exigir a espera de uma hora;
+ *   - NSU sem lacunas, gerado por ordem de RECEPÇÃO e não de emissão, como o
+ *     manual explicita;
+ *   - capacidade de repetir um lote já entregue (replay), que é o caso que a
+ *     deduplicação precisa absorver.
+ *
+ * Ele não fabrica resposta de servidor oficial: ele fabrica um servidor com as
+ * REGRAS do oficial, e isso é dito em voz alta. O documento que trafega é
+ * fixture sintética conforme o XSD publicado — nunca documento de empresa real.
+ */
+export interface SyntheticDocument {
+    nsu: string;
+    xml: string;
+    schema?: string;
+}
+export interface SyntheticTransportOptions {
+    documents: readonly SyntheticDocument[];
+    /** Erro a levantar na PRÓXIMA chamada. Consumido uma vez. */
+    failNextWith?: FiscalProviderError | null;
+    /** Ambientes aceitos. Fora deles, o transporte recusa. */
+    environments?: readonly FiscalEnvironmentTag[];
+}
+export declare class SyntheticAdnTransport implements AdnTransportLike {
+    private readonly options;
+    private failNext;
+    /** Contagem de chamadas — o teste de replay e de retry a inspeciona. */
+    calls: number;
+    constructor(options: SyntheticTransportOptions);
+    /** Arma uma falha para a próxima chamada. Simula o provedor, não o cliente. */
+    failOnce(err: FiscalProviderError): void;
+    fetchDfe(input: {
+        actorDocument: string;
+        fromNsu: string | null;
+        batchLimit: number;
+        environment: FiscalEnvironmentTag;
+    }): Promise<FiscalFetchResult>;
+}
+//# sourceMappingURL=synthetic-transport.d.ts.map

package/dist/fiscal/ingestion/synthetic-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthetic-transport.d.ts","sourceRoot":"","sources":["../../../src/fiscal/ingestion/synthetic-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EAEvB,MAAM,gCAAgC,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACxC,6DAA6D;IAC7D,YAAY,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC1C,0DAA0D;IAC1D,YAAY,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAChD;AAED,qBAAa,qBAAsB,YAAW,gBAAgB;IAKhD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,QAAQ,CAA6B;IAC7C,wEAAwE;IACxE,KAAK,SAAK;gBAEmB,OAAO,EAAE,yBAAyB;IAI/D,+EAA+E;IAC/E,QAAQ,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI;IAIlC,QAAQ,CAAC,KAAK,EAAE;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,oBAAoB,CAAC;KACnC,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA2C/B"}

package/dist/fiscal/ingestion/synthetic-transport.js

@@ -0,0 +1,57 @@
+import { FiscalProviderError, } from './synthetic-transport-types.js';
+export class SyntheticAdnTransport {
+    options;
+    failNext;
+    /** Contagem de chamadas — o teste de replay e de retry a inspeciona. */
+    calls = 0;
+    constructor(options) {
+        this.options = options;
+        this.failNext = options.failNextWith ?? null;
+    }
+    /** Arma uma falha para a próxima chamada. Simula o provedor, não o cliente. */
+    failOnce(err) {
+        this.failNext = err;
+    }
+    async fetchDfe(input) {
+        this.calls += 1;
+        if (this.failNext) {
+            const err = this.failNext;
+            this.failNext = null;
+            throw err;
+        }
+        const permitidos = this.options.environments ?? ['synthetic'];
+        if (!permitidos.includes(input.environment)) {
+            throw new FiscalProviderError('auth', `transporte sintético não opera "${input.environment}"`, 'SYNTHETIC_ENVIRONMENT_REFUSED');
+        }
+        const ordenados = [...this.options.documents].sort((a, b) => cmpNsu(a.nsu, b.nsu));
+        const maxNsu = ordenados.length > 0 ? ordenados[ordenados.length - 1].nsu : null;
+        const from = input.fromNsu;
+        const pendentes = ordenados.filter((d) => from === null || cmpNsu(d.nsu, from) > 0);
+        const lote = pendentes.slice(0, input.batchLimit);
+        const documents = lote.map((d) => ({
+            nsu: d.nsu,
+            schema: d.schema ?? 'NFSe_v1.01.xsd',
+            raw: new TextEncoder().encode(d.xml),
+            mimeType: 'application/xml',
+        }));
+        // `ultNSU` é do SERVIDOR: quando o lote vem vazio, ele repete a posição do
+        // cliente. Devolver `null` faria o cliente recuar para o começo — o laço
+        // que o cStat 656 pune.
+        const lastNsu = lote.length > 0 ? lote[lote.length - 1].nsu : from;
+        const exhausted = pendentes.length <= lote.length;
+        return {
+            documents,
+            lastNsu,
+            maxNsu,
+            exhausted,
+            providerStatus: documents.length > 0 ? '138' : '137',
+        };
+    }
+}
+/** NSU é numérico com até 15 dígitos, mas chega como texto. Compara por valor. */
+function cmpNsu(a, b) {
+    const na = BigInt(a);
+    const nb = BigInt(b);
+    return na < nb ? -1 : na > nb ? 1 : 0;
+}
+//# sourceMappingURL=synthetic-transport.js.map

package/dist/fiscal/ingestion/synthetic-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthetic-transport.js","sourceRoot":"","sources":["../../../src/fiscal/ingestion/synthetic-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,GAKpB,MAAM,gCAAgC,CAAC;AA0CxC,MAAM,OAAO,qBAAqB;IAKH;IAJrB,QAAQ,CAA6B;IAC7C,wEAAwE;IACxE,KAAK,GAAG,CAAC,CAAC;IAEV,YAA6B,OAAkC;QAAlC,YAAO,GAAP,OAAO,CAA2B;QAC7D,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC;IAC/C,CAAC;IAED,+EAA+E;IAC/E,QAAQ,CAAC,GAAwB;QAC/B,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAKd;QACC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QAChB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,IAAK,CAAC,WAAW,CAAW,CAAC;QACzE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,mBAAmB,CAC3B,MAAM,EACN,mCAAmC,KAAK,CAAC,WAAW,GAAG,EACvD,+BAA+B,CAChC,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACnF,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QAClF,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC;QAC3B,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACpF,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAElD,MAAM,SAAS,GAAwB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtD,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,gBAAgB;YACpC,GAAG,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;YACpC,QAAQ,EAAE,iBAAiB;SAC5B,CAAC,CAAC,CAAC;QAEJ,2EAA2E;QAC3E,yEAAyE;QACzE,wBAAwB;QACxB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QACpE,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;QAElD,OAAO;YACL,SAAS;YACT,OAAO;YACP,MAAM;YACN,SAAS;YACT,cAAc,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;SACrD,CAAC;IACJ,CAAC;CACF;AAED,kFAAkF;AAClF,SAAS,MAAM,CAAC,CAAS,EAAE,CAAS;IAClC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACrB,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACrB,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC"}

package/dist/fiscal/ingestion/xml-reader.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Leitor mínimo de XML fiscal — deliberadamente incapaz.
+ *
+ * ## Por que não um parser de XML de verdade
+ *
+ * A escolha óbvia seria uma dependência (`fast-xml-parser`, `xml2js`). Duas
+ * razões contra, e a segunda é a que decide:
+ *
+ * 1. Este repositório não tem nenhuma, e acrescentar uma ao caminho que
+ *    processa documento de terceiro amplia a superfície de suprimento.
+ * 2. **XXE.** Parsers completos resolvem entidades externas por padrão ou por
+ *    configuração fácil de errar, e o `DOCTYPE` de um XML vindo de fora é o
+ *    vetor clássico para ler arquivo do servidor. A defesa usual é "configure o
+ *    parser direito" — disciplina, não ferramenta. Este leitor **não sabe** o
+ *    que é uma entidade: não há configuração para esquecer.
+ *
+ * ## O que ele sabe e o que não sabe
+ *
+ * Sabe: extrair o texto do primeiro elemento de um nome, dentro de um escopo,
+ * e ler atributo. É o suficiente para os campos que viram COLUNA.
+ *
+ * Não sabe: namespaces reais, mixed content, CDATA aninhado, validação. Nada
+ * disso é necessário aqui, porque o documento é validado por XSD do lado de
+ * quem o emitiu e o original é preservado intacto — este leitor alimenta a
+ * projeção, jamais substitui o documento.
+ *
+ * Qualquer coisa que ele não entenda vira `null`, e o chamador decide. Um
+ * leitor que adivinha é pior que um que admite não saber.
+ */
+/** Rejeita de entrada o que este leitor não pode processar com segurança. */
+export declare class UnsafeXmlError extends Error {
+    constructor(reason: string);
+}
+/**
+ * Converte bytes em texto e recusa o que for perigoso.
+ *
+ * A recusa é fail-closed e ANTES de qualquer leitura: um documento com
+ * `DOCTYPE` não é processado nem parcialmente. Um documento fiscal legítimo
+ * não tem `DOCTYPE` — nem NF-e, nem NFS-e, nem CT-e o usam.
+ */
+export declare function decodeFiscalXml(raw: Uint8Array): string;
+/**
+ * Texto do primeiro elemento `name` encontrado em `scope`.
+ *
+ * Devolve `null` quando o elemento não existe, está vazio ou é auto-fechado —
+ * três coisas diferentes que, para quem chama, significam a mesma: não há valor.
+ */
+export declare function readText(scope: string, name: string): string | null;
+/** Conteúdo bruto (com marcação) do primeiro elemento `name`, para descer nível. */
+export declare function readElement(scope: string, name: string): string | null;
+/** Valor de atributo do primeiro elemento `name`. */
+export declare function readAttribute(scope: string, name: string, attr: string): string | null;
+/** Nome do elemento raiz, sem prefixo. `null` se não houver um. */
+export declare function rootElementName(text: string): string | null;
+//# sourceMappingURL=xml-reader.d.ts.map

package/dist/fiscal/ingestion/xml-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-reader.d.ts","sourceRoot":"","sources":["../../../src/fiscal/ingestion/xml-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,6EAA6E;AAC7E,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,MAAM,EAAE,MAAM;CAI3B;AAOD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAUvD;AAiBD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQnE;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKtE;AAED,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKtF;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK3D"}

package/dist/fiscal/ingestion/xml-reader.js

@@ -0,0 +1,112 @@
+/**
+ * Leitor mínimo de XML fiscal — deliberadamente incapaz.
+ *
+ * ## Por que não um parser de XML de verdade
+ *
+ * A escolha óbvia seria uma dependência (`fast-xml-parser`, `xml2js`). Duas
+ * razões contra, e a segunda é a que decide:
+ *
+ * 1. Este repositório não tem nenhuma, e acrescentar uma ao caminho que
+ *    processa documento de terceiro amplia a superfície de suprimento.
+ * 2. **XXE.** Parsers completos resolvem entidades externas por padrão ou por
+ *    configuração fácil de errar, e o `DOCTYPE` de um XML vindo de fora é o
+ *    vetor clássico para ler arquivo do servidor. A defesa usual é "configure o
+ *    parser direito" — disciplina, não ferramenta. Este leitor **não sabe** o
+ *    que é uma entidade: não há configuração para esquecer.
+ *
+ * ## O que ele sabe e o que não sabe
+ *
+ * Sabe: extrair o texto do primeiro elemento de um nome, dentro de um escopo,
+ * e ler atributo. É o suficiente para os campos que viram COLUNA.
+ *
+ * Não sabe: namespaces reais, mixed content, CDATA aninhado, validação. Nada
+ * disso é necessário aqui, porque o documento é validado por XSD do lado de
+ * quem o emitiu e o original é preservado intacto — este leitor alimenta a
+ * projeção, jamais substitui o documento.
+ *
+ * Qualquer coisa que ele não entenda vira `null`, e o chamador decide. Um
+ * leitor que adivinha é pior que um que admite não saber.
+ */
+/** Rejeita de entrada o que este leitor não pode processar com segurança. */
+export class UnsafeXmlError extends Error {
+    constructor(reason) {
+        super(`XML recusado: ${reason}`);
+        this.name = 'UnsafeXmlError';
+    }
+}
+const DOCTYPE = /<!DOCTYPE/i;
+const ENTITY = /<!ENTITY/i;
+/** Qualquer referência a entidade que não seja uma das cinco predefinidas. */
+const CUSTOM_ENTITY = /&(?!(?:amp|lt|gt|quot|apos|#\d+|#x[0-9a-fA-F]+);)[A-Za-z_][\w.-]*;/;
+/**
+ * Converte bytes em texto e recusa o que for perigoso.
+ *
+ * A recusa é fail-closed e ANTES de qualquer leitura: um documento com
+ * `DOCTYPE` não é processado nem parcialmente. Um documento fiscal legítimo
+ * não tem `DOCTYPE` — nem NF-e, nem NFS-e, nem CT-e o usam.
+ */
+export function decodeFiscalXml(raw) {
+    if (raw.byteLength > 8 * 1024 * 1024) {
+        throw new UnsafeXmlError('documento acima de 8 MiB');
+    }
+    const text = new TextDecoder('utf-8', { fatal: false }).decode(raw);
+    if (DOCTYPE.test(text))
+        throw new UnsafeXmlError('DOCTYPE presente');
+    if (ENTITY.test(text))
+        throw new UnsafeXmlError('declaração de entidade presente');
+    if (CUSTOM_ENTITY.test(text))
+        throw new UnsafeXmlError('referência a entidade não predefinida');
+    if (!text.includes('<'))
+        throw new UnsafeXmlError('conteúdo não é XML');
+    return text;
+}
+/** Só as cinco entidades predefinidas do XML. Nenhuma outra é resolvida. */
+function unescapeXml(v) {
+    return v
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&apos;/g, "'")
+        .replace(/&amp;/g, '&');
+}
+/** Nome de elemento com ou sem prefixo de namespace. */
+function tagPattern(name) {
+    return `(?:[A-Za-z_][\\w.-]*:)?${name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}`;
+}
+/**
+ * Texto do primeiro elemento `name` encontrado em `scope`.
+ *
+ * Devolve `null` quando o elemento não existe, está vazio ou é auto-fechado —
+ * três coisas diferentes que, para quem chama, significam a mesma: não há valor.
+ */
+export function readText(scope, name) {
+    const t = tagPattern(name);
+    const re = new RegExp(`<${t}(?:\\s[^>]*)?>([\\s\\S]*?)</${t}>`);
+    const m = re.exec(scope);
+    if (!m || m[1] === undefined)
+        return null;
+    const inner = m[1].trim();
+    if (inner === '' || inner.includes('<'))
+        return inner === '' ? null : null;
+    return unescapeXml(inner);
+}
+/** Conteúdo bruto (com marcação) do primeiro elemento `name`, para descer nível. */
+export function readElement(scope, name) {
+    const t = tagPattern(name);
+    const re = new RegExp(`<${t}(?:\\s[^>]*)?>([\\s\\S]*?)</${t}>`);
+    const m = re.exec(scope);
+    return m?.[1] ?? null;
+}
+/** Valor de atributo do primeiro elemento `name`. */
+export function readAttribute(scope, name, attr) {
+    const t = tagPattern(name);
+    const re = new RegExp(`<${t}\\s[^>]*?${attr}\\s*=\\s*"([^"]*)"`);
+    const m = re.exec(scope);
+    return m?.[1] ? unescapeXml(m[1]) : null;
+}
+/** Nome do elemento raiz, sem prefixo. `null` se não houver um. */
+export function rootElementName(text) {
+    const m = /<(?:[A-Za-z_][\w.-]*:)?([A-Za-z_][\w.-]*)(?:\s|>|\/)/.exec(text.replace(/<\?[\s\S]*?\?>/g, '').replace(/<!--[\s\S]*?-->/g, ''));
+    return m?.[1] ?? null;
+}
+//# sourceMappingURL=xml-reader.js.map

package/dist/fiscal/ingestion/xml-reader.js.map

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