@baruk/core 0.3.1 → 0.5.0

package/dist/fiscal/ingestion/pipeline.js.map

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

package/dist/fiscal/ingestion/provider.d.ts

@@ -0,0 +1,206 @@
+/**
+ * A porta entre o motor de ingestão e as fontes oficiais de documento fiscal.
+ *
+ * ## A forma foi medida, não inventada
+ *
+ * Os três documentos que importam ao Brasil compartilham a MESMA mecânica de
+ * distribuição, e isso é evidência de documentação oficial, não conveniência:
+ *
+ *   NF-e   NT 2014.002 v1.02c (ago/2020), WS `NFeDistribuicaoDFe`, método
+ *          `nfeDistDFeInteresse`. Consultas `distNSU` (lote a partir do
+ *          `ultNSU`), `consNSU` (um NSU faltante) e `consChNFe` (por chave).
+ *          Lote de até **50** documentos, ordem crescente de NSU, resposta com
+ *          `ultNSU` e `maxNSU`, conteúdo em `docZip` (gZip + base64).
+ *   CT-e   NT 2015.002, WS `CTeDistribuicaoDFe`. `distNSU`/`consNSU`,
+ *          `ultNSU`/`maxNSU`, `docZip`. Mesma forma.
+ *   NFS-e  Manual dos Contribuintes do ADN v1.0 (12/02/2026),
+ *          `GET /DFe/{NSU}` e `GET /NFSe/{ChaveAcesso}/Eventos`. REST em vez de
+ *          SOAP — e o mesmo cursor NSU.
+ *
+ * Por isso a porta é modelada sobre **cursor NSU + lote + posição declarada
+ * pelo servidor**, e não sobre "página" ou "data inicial". Uma interface
+ * paginada por data obrigaria cada adapter a fingir uma semântica que nenhuma
+ * das três APIs tem.
+ *
+ * ## O que a porta deliberadamente NÃO abstrai
+ *
+ * Transporte, autenticação e parsing. SOAP com TLS mútuo e REST com TLS mútuo
+ * não se beneficiam de uma camada comum, e forçá-la produziria o pior tipo de
+ * abstração: uma que precisa de `if` por provedor lá dentro.
+ */
+/** Ambientes. Sem fallback entre eles, em nenhuma direção (Gate B0). */
+export type FiscalEnvironmentTag = 'synthetic' | 'homologation' | 'production';
+export type FiscalDocumentType = 'nfse' | 'nfe' | 'cte' | 'nfce';
+/**
+ * Direção do documento em relação ao ator consultado.
+ *
+ * `unknown` não é um estado de erro: é a resposta honesta quando o leiaute não
+ * traz o participante que decidiria. Ver `direction.ts` — e nunca substituí-lo
+ * por `issued`, que foi o defeito da primeira escrita desta onda.
+ */
+export type FiscalDirection = 'issued' | 'received' | 'intermediary' | 'unknown';
+export type FiscalContentKind = 'summary' | 'full';
+/**
+ * Um documento como o provedor o entregou, antes de qualquer interpretação.
+ *
+ * `raw` são os BYTES originais — já descompactados do `docZip`, mas não
+ * reescritos. É este conteúdo que vai para o storage e cujo sha256 é gravado.
+ */
+export interface RawFiscalDocument {
+    /** Posição no cursor do provedor que entregou este item. */
+    nsu: string;
+    /** Identificação do leiaute, quando o provedor a declara (`schema` do docZip). */
+    schema?: string | null;
+    raw: Uint8Array;
+    /** `application/xml` na prática; declarado porque o blob exige. */
+    mimeType: string;
+}
+/**
+ * O resultado de um lote.
+ *
+ * `maxNsu` é o que arma a espera obrigatória: quando `lastNsu === maxNsu` não há
+ * mais nada, e a NT 2014.002 §3.5 exige **uma hora** antes da próxima
+ * solicitação. Consultar antes é `cStat 656 — Consumo Indevido`, e o CNPJ que
+ * fica bloqueado é o do CLIENTE.
+ */
+export interface FiscalFetchResult {
+    documents: readonly RawFiscalDocument[];
+    /** Último NSU pesquisado, como o servidor o declarou. */
+    lastNsu: string | null;
+    /** Maior NSU existente para o ator consultado, como o servidor o declarou. */
+    maxNsu: string | null;
+    /** `true` quando o provedor disse que não há mais nada agora (cStat 137). */
+    exhausted: boolean;
+    /** Código de status bruto do provedor, para a trilha. Nunca a mensagem. */
+    providerStatus?: string | null;
+}
+/**
+ * Classes de erro do provedor.
+ *
+ * A separação existe porque os tratamentos são opostos, e confundi-los é como
+ * um laço bem-intencionado bloqueia o CNPJ de um terceiro:
+ *
+ *   `transient`    rede, 5xx, serviço paralisado (cStat 108/109). Retenta.
+ *   `throttled`    consumo indevido (cStat 656) ou espera obrigatória ainda
+ *                  correndo. **Não retenta agora** — recuar é a correção.
+ *   `auth`         certificado inválido, vencido, revogado, fora da ICP-Brasil
+ *                  (cStat 280-286), ou CNPJ-base divergente (593). Pessoa
+ *                  resolve; retentar não.
+ *   `not_allowed`  o ator não tem direito àquele documento (640, 641, 653).
+ *   `invalid`      leiaute, schema, chave malformada (215, 236, 614-619).
+ *   `unknown`      não classificado. Trata como `transient` com teto.
+ */
+export type FiscalProviderErrorClass = 'transient' | 'throttled' | 'auth' | 'not_allowed' | 'invalid' | 'unknown';
+export declare class FiscalProviderError extends Error {
+    readonly errorClass: FiscalProviderErrorClass;
+    /** Código do provedor (`cStat`, HTTP). Código, jamais a resposta bruta. */
+    readonly providerCode?: string | null | undefined;
+    /** Quando o provedor ou a norma impõem espera, até quando. */
+    readonly retryAfter?: (Date | null) | undefined;
+    constructor(errorClass: FiscalProviderErrorClass, message: string, 
+    /** Código do provedor (`cStat`, HTTP). Código, jamais a resposta bruta. */
+    providerCode?: string | null | undefined, 
+    /** Quando o provedor ou a norma impõem espera, até quando. */
+    retryAfter?: (Date | null) | undefined);
+}
+/** O que o adapter precisa saber para buscar em nome de um cliente. */
+export interface FiscalFetchRequest {
+    /** CNPJ/CPF do ator consultado. Sem máscara. */
+    actorDocument: string;
+    /** Posição de onde continuar. `null` = do começo disponível. */
+    fromNsu: string | null;
+    environment: FiscalEnvironmentTag;
+    /** Teto de documentos deste lote. A NT 2014.002 fixa 50 na NF-e. */
+    batchLimit: number;
+}
+/**
+ * Um documento já interpretado, mas ainda não gravado.
+ *
+ * `dedupeKey` é responsabilidade do ADAPTER, não do motor: só ele sabe o que
+ * identifica um documento naquele leiaute. E não pode ser o NSU — o mesmo
+ * documento reaparece sob outro NSU num replay, que é exatamente o caso que a
+ * deduplicação existe para absorver.
+ *
+ * ## Não há campo `direction` aqui, e é deliberado
+ *
+ * A primeira escrita desta onda tinha um, e todo parser o preenchia com
+ * `'issued'` fixo — inclusive para notas em que o cliente é o tomador. A
+ * remoção do campo não é estilo: é o que torna IMPOSSÍVEL a um adapter declarar
+ * direção sem confrontar participantes, porque ele não conhece o ator
+ * consultado. O adapter informa QUEM são emitente, tomador e intermediário; o
+ * motor confronta com o ator e decide (`classifyFiscalDirection`).
+ */
+export interface NormalizedFiscalDocument {
+    dedupeKey: string;
+    documentType: FiscalDocumentType;
+    contentKind: FiscalContentKind;
+    accessKey?: string | null;
+    documentNumber?: string | null;
+    series?: string | null;
+    issuerDocument?: string | null;
+    issuerName?: string | null;
+    recipientDocument?: string | null;
+    recipientName?: string | null;
+    /** Intermediário do serviço, quando o leiaute o declara (`interm` da NFS-e). */
+    intermediaryDocument?: string | null;
+    intermediaryName?: string | null;
+    issuedAt?: Date | null;
+    /** `YYYY-MM`. Pode divergir de `issuedAt` — e frequentemente diverge. */
+    competenceLabel?: string | null;
+    grossAmount?: string | null;
+    /** Campos do leiaute que não viraram coluna. Sobrevive à reforma tributária. */
+    normalized: Record<string, unknown>;
+    /** Quando o item é um EVENTO de um documento, e não um documento. */
+    event?: {
+        type: 'cancellation' | 'replacement' | 'correction' | 'manifestation' | 'other';
+        code?: string | null;
+        occurredAt?: Date | null;
+        /**
+         * Sequência do evento no leiaute (`nSeqEvento`). Entra no desempate da
+         * ordem de aplicação quando dois eventos guardados na caixa de entrada têm
+         * o mesmo instante — ou quando o instante não veio.
+         */
+        sequence?: string | null;
+        /** Chave do documento que este evento altera. */
+        targetAccessKey: string;
+    } | null;
+}
+/**
+ * O adapter de uma fonte fiscal.
+ *
+ * `parse` é separado de `fetch` de propósito: é o que permite exercitar o
+ * leiaute inteiro com fixture, sem rede e sem credencial — e é sob essa
+ * separação que esta fase prova o motor sem tocar em documento real.
+ */
+export interface FiscalDocumentAdapter {
+    /** Slug estável. Vai para `fiscal_document.source` e para o cursor. */
+    readonly source: string;
+    /**
+     * Versão do CONTRATO que este adapter implementa (`nfse-adn:v1`).
+     *
+     * Vai gravada em `fiscal_sync_run.contract_version`, e a razão é operacional:
+     * o leiaute da NFS-e nacional mudou duas vezes entre dez/2025 e fev/2026. No
+     * dia em que mudar de novo, "qual parser processou este lote?" precisa ter
+     * resposta no DADO — não na arqueologia do `git log` cruzada com a data da
+     * linha, que é o que sobra quando a versão não é gravada.
+     *
+     * Opcional porque adapters sintéticos e de teste não implementam contrato
+     * externo nenhum, e obrigá-los a inventar um rótulo poluiria a trilha com
+     * versões que não existem lá fora.
+     */
+    readonly contractVersion?: string | null;
+    readonly documentTypes: readonly FiscalDocumentType[];
+    /** Ambientes que ESTE adapter sabe operar. */
+    readonly environments: readonly FiscalEnvironmentTag[];
+    /** Teto de lote imposto pela norma ou pelo provedor. */
+    readonly batchLimit: number;
+    /**
+     * Espera obrigatória depois de o provedor dizer "não há mais nada".
+     * Na NF-e são 3600s por norma; um adapter sintético pode declarar 0.
+     */
+    readonly exhaustedBackoffSeconds: number;
+    fetchBatch(request: FiscalFetchRequest): Promise<FiscalFetchResult>;
+    /** Interpreta um item bruto. Lança `FiscalProviderError('invalid')` se não puder. */
+    parse(doc: RawFiscalDocument): NormalizedFiscalDocument;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/fiscal/ingestion/provider.d.ts.map

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

package/dist/fiscal/ingestion/provider.js

@@ -0,0 +1,47 @@
+/**
+ * A porta entre o motor de ingestão e as fontes oficiais de documento fiscal.
+ *
+ * ## A forma foi medida, não inventada
+ *
+ * Os três documentos que importam ao Brasil compartilham a MESMA mecânica de
+ * distribuição, e isso é evidência de documentação oficial, não conveniência:
+ *
+ *   NF-e   NT 2014.002 v1.02c (ago/2020), WS `NFeDistribuicaoDFe`, método
+ *          `nfeDistDFeInteresse`. Consultas `distNSU` (lote a partir do
+ *          `ultNSU`), `consNSU` (um NSU faltante) e `consChNFe` (por chave).
+ *          Lote de até **50** documentos, ordem crescente de NSU, resposta com
+ *          `ultNSU` e `maxNSU`, conteúdo em `docZip` (gZip + base64).
+ *   CT-e   NT 2015.002, WS `CTeDistribuicaoDFe`. `distNSU`/`consNSU`,
+ *          `ultNSU`/`maxNSU`, `docZip`. Mesma forma.
+ *   NFS-e  Manual dos Contribuintes do ADN v1.0 (12/02/2026),
+ *          `GET /DFe/{NSU}` e `GET /NFSe/{ChaveAcesso}/Eventos`. REST em vez de
+ *          SOAP — e o mesmo cursor NSU.
+ *
+ * Por isso a porta é modelada sobre **cursor NSU + lote + posição declarada
+ * pelo servidor**, e não sobre "página" ou "data inicial". Uma interface
+ * paginada por data obrigaria cada adapter a fingir uma semântica que nenhuma
+ * das três APIs tem.
+ *
+ * ## O que a porta deliberadamente NÃO abstrai
+ *
+ * Transporte, autenticação e parsing. SOAP com TLS mútuo e REST com TLS mútuo
+ * não se beneficiam de uma camada comum, e forçá-la produziria o pior tipo de
+ * abstração: uma que precisa de `if` por provedor lá dentro.
+ */
+export class FiscalProviderError extends Error {
+    errorClass;
+    providerCode;
+    retryAfter;
+    constructor(errorClass, message, 
+    /** Código do provedor (`cStat`, HTTP). Código, jamais a resposta bruta. */
+    providerCode, 
+    /** Quando o provedor ou a norma impõem espera, até quando. */
+    retryAfter) {
+        super(message);
+        this.errorClass = errorClass;
+        this.providerCode = providerCode;
+        this.retryAfter = retryAfter;
+        this.name = 'FiscalProviderError';
+    }
+}
+//# sourceMappingURL=provider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/fiscal/ingestion/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAuEH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAEjC;IAGA;IAEA;IANX,YACW,UAAoC,EAC7C,OAAe;IACf,2EAA2E;IAClE,YAA4B;IACrC,8DAA8D;IACrD,UAAwB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAPN,eAAU,GAAV,UAAU,CAA0B;QAGpC,iBAAY,GAAZ,YAAY,CAAgB;QAE5B,eAAU,GAAV,UAAU,CAAc;QAGjC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}

package/dist/fiscal/ingestion/repository.d.ts

@@ -0,0 +1,82 @@
+import type { Tx } from '../../db/client.js';
+import { type FiscalEnvironment } from '../eligibility.js';
+/**
+ * Leitura dos documentos fiscais capturados.
+ *
+ * Tudo aqui roda sob RLS FORCE com política de DUAS fronteiras: tenant sempre,
+ * e cliente quando `app.current_client` está definido (portal). O filtro por
+ * cliente nos parâmetros é conveniência de tela — a fronteira é do banco.
+ */
+export interface FiscalDocumentRow {
+    id: string;
+    clientId: string;
+    clientName: string | null;
+    documentType: string;
+    direction: string;
+    accessKey: string | null;
+    documentNumber: string | null;
+    issuerName: string | null;
+    recipientName: string | null;
+    issuedAt: string | null;
+    competenceLabel: string | null;
+    grossAmount: string | null;
+    status: string;
+    contentKind: string;
+    source: string;
+    sourceEnvironment: string;
+    hasRaw: boolean;
+    ingestedAt: string;
+}
+export interface FiscalDocumentFilter {
+    clientId?: string | null;
+    documentType?: string | null;
+    competenceLabel?: string | null;
+    status?: string | null;
+    direction?: string | null;
+    limit?: number;
+}
+export declare function listFiscalDocuments(tx: Tx, filter?: FiscalDocumentFilter): Promise<FiscalDocumentRow[]>;
+export declare function getFiscalDocument(tx: Tx, id: string): Promise<(FiscalDocumentRow & {
+    normalized: unknown;
+    events: unknown[];
+}) | null>;
+/**
+ * O estado factual da sincronização — para a tela dizer a verdade.
+ *
+ * Não existe "tudo certo". Cada estado é derivado de um fato: existe linha de
+ * automação? existe cursor? quando foi o último sucesso? qual foi o último erro?
+ * Uma tela que diz "pronto" sem ter o que a sustente é a mesma classe de defeito
+ * do painel que mostrava zero por RLS.
+ */
+export type FiscalSyncStatus = 'not_configured' | 'ready' | 'synced' | 'waiting_provider_window' | 'blocked_credential' | 'blocked_eligibility' | 'error';
+export interface FiscalSyncState {
+    status: FiscalSyncStatus;
+    environment: FiscalEnvironment | null;
+    lastSuccessAt: string | null;
+    nextAttemptAfter: string | null;
+    lastErrorClass: string | null;
+    consecutiveFailures: number;
+    documentsTotal: number;
+    /** Quantos vieram sozinhos — a métrica que mede o valor devolvido. */
+    documentsAutomaticallyCollected: number;
+    eligibleClients: number;
+    /**
+     * A caixa de entrada, exposta.
+     *
+     * Evento pendente não é erro: é informação fiscal preservada esperando o
+     * documento-alvo. Mas ele PRECISA ser visível — uma caixa que só cresce
+     * significa que os documentos correspondentes nunca chegaram, e essa é uma
+     * pergunta operacional real (o cliente mudou de emissor? a inscrição está
+     * apontando para o CNPJ errado?). Sem o contador, a espera vira acúmulo
+     * silencioso, que é o vizinho do descarte silencioso que esta onda corrigiu.
+     */
+    pendingEvents: number;
+    /** Há quanto tempo o mais antigo espera. `null` quando a caixa está vazia. */
+    oldestPendingEventAt: string | null;
+    /** Quantos já saíram da espera e viraram evento do documento. */
+    reconciledEvents: number;
+    /** Itens preservados que não puderam ser interpretados. Recuperáveis por NSU. */
+    invalidItems: number;
+}
+export declare function fiscalSyncState(tx: Tx): Promise<FiscalSyncState>;
+//# sourceMappingURL=repository.d.ts.map

package/dist/fiscal/ingestion/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../src/fiscal/ingestion/repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAA6B,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtF;;;;;;GAMG;AAEH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,EAAE,EACN,MAAM,GAAE,oBAAyB,GAChC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA0D9B;AAED,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,EAAE,EACN,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,CAAC,iBAAiB,GAAG;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,GAAG,IAAI,CAAC,CAuBlF;AAeD;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GACxB,gBAAgB,GAChB,OAAO,GACP,QAAQ,GACR,yBAAyB,GACzB,oBAAoB,GACpB,qBAAqB,GACrB,OAAO,CAAC;AAEZ,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACtC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,+BAA+B,EAAE,MAAM,CAAC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB;;;;;;;;;OASG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,iEAAiE;IACjE,gBAAgB,EAAE,MAAM,CAAC;IACzB,iFAAiF;IACjF,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,eAAe,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CA2DtE"}

package/dist/fiscal/ingestion/repository.js

@@ -0,0 +1,127 @@
+import { getTenantFiscalAutomation } from '../eligibility.js';
+export async function listFiscalDocuments(tx, filter = {}) {
+    const limit = Math.min(Math.max(filter.limit ?? 100, 1), 500);
+    const rows = await tx `
+    SELECT d.id, d.client_id, c.display_name AS client_name, d.document_type, d.direction,
+           d.access_key, d.document_number, d.issuer_name, d.recipient_name, d.issued_at,
+           d.competence_label, d.gross_amount, d.status, d.content_kind, d.source,
+           d.source_environment, (d.raw_blob_id IS NOT NULL) AS has_raw, d.ingested_at
+      FROM fiscal_document d
+      LEFT JOIN client c ON c.id = d.client_id
+     WHERE (${filter.clientId ?? null}::uuid IS NULL OR d.client_id = ${filter.clientId ?? null}::uuid)
+       AND (${filter.documentType ?? null}::text IS NULL OR d.document_type = ${filter.documentType ?? null})
+       AND (${filter.competenceLabel ?? null}::text IS NULL OR d.competence_label = ${filter.competenceLabel ?? null})
+       AND (${filter.status ?? null}::text IS NULL OR d.status = ${filter.status ?? null})
+       AND (${filter.direction ?? null}::text IS NULL OR d.direction = ${filter.direction ?? null})
+     ORDER BY d.issued_at DESC NULLS LAST, d.ingested_at DESC
+     LIMIT ${limit}
+  `;
+    return rows.map((r) => ({
+        id: r.id,
+        clientId: r.client_id,
+        clientName: r.client_name,
+        documentType: r.document_type,
+        direction: r.direction,
+        accessKey: r.access_key,
+        documentNumber: r.document_number,
+        issuerName: r.issuer_name,
+        recipientName: r.recipient_name,
+        issuedAt: r.issued_at?.toISOString() ?? null,
+        competenceLabel: r.competence_label,
+        grossAmount: r.gross_amount,
+        status: r.status,
+        contentKind: r.content_kind,
+        source: r.source,
+        sourceEnvironment: r.source_environment,
+        hasRaw: r.has_raw,
+        ingestedAt: r.ingested_at.toISOString(),
+    }));
+}
+export async function getFiscalDocument(tx, id) {
+    const [row] = await listFiscalDocumentsById(tx, id);
+    if (!row)
+        return null;
+    const events = await tx `
+    SELECT event_type, event_code, occurred_at
+      FROM fiscal_document_event WHERE fiscal_document_id = ${id}
+     ORDER BY occurred_at NULLS LAST, ingested_at
+  `;
+    return {
+        ...row.doc,
+        normalized: row.normalized,
+        events: events.map((e) => ({
+            type: e.event_type,
+            code: e.event_code,
+            occurredAt: e.occurred_at?.toISOString() ?? null,
+            // O evento HERDA a direção do documento que altera — ele não tem uma
+            // própria. Um cancelamento sobre uma nota recebida é evento de nota
+            // recebida; classificá-lo como emitida inverteria o sinal do fato.
+            direction: row.doc.direction,
+        })),
+    };
+}
+async function listFiscalDocumentsById(tx, id) {
+    const docs = await listFiscalDocuments(tx, {});
+    const found = docs.find((d) => d.id === id);
+    if (!found)
+        return [];
+    const [n] = await tx `
+    SELECT normalized FROM fiscal_document WHERE id = ${id}
+  `;
+    return [{ doc: found, normalized: n?.normalized ?? {} }];
+}
+export async function fiscalSyncState(tx) {
+    const automation = await getTenantFiscalAutomation(tx);
+    const [totals] = await tx `
+    SELECT count(*)::int AS total,
+           count(*) FILTER (WHERE source <> 'manual')::int AS automatic
+      FROM fiscal_document
+  `;
+    const [enroll] = await tx `
+    SELECT count(DISTINCT client_id)::int AS n
+      FROM client_fiscal_enrollment WHERE revoked_at IS NULL
+  `;
+    const [inbox] = await tx `
+    SELECT count(*) FILTER (WHERE state = 'pending_target')::int AS pending,
+           count(*) FILTER (WHERE state = 'applied')::int       AS reconciled,
+           count(*) FILTER (WHERE state = 'invalid')::int       AS invalid,
+           min(received_at) FILTER (WHERE state = 'pending_target') AS oldest
+      FROM fiscal_ingestion_inbox
+  `;
+    const [cursor] = await tx `
+    SELECT last_success_at, next_attempt_after, last_error_class, consecutive_failures
+      FROM fiscal_sync_cursor ORDER BY updated_at DESC LIMIT 1
+  `;
+    const base = {
+        environment: automation.mode === 'disabled' ? null : automation.mode,
+        lastSuccessAt: cursor?.last_success_at?.toISOString() ?? null,
+        nextAttemptAfter: cursor?.next_attempt_after?.toISOString() ?? null,
+        lastErrorClass: cursor?.last_error_class ?? null,
+        consecutiveFailures: cursor?.consecutive_failures ?? 0,
+        documentsTotal: totals?.total ?? 0,
+        documentsAutomaticallyCollected: totals?.automatic ?? 0,
+        eligibleClients: enroll?.n ?? 0,
+        pendingEvents: inbox?.pending ?? 0,
+        oldestPendingEventAt: inbox?.oldest?.toISOString() ?? null,
+        reconciledEvents: inbox?.reconciled ?? 0,
+        invalidItems: inbox?.invalid ?? 0,
+    };
+    // A ordem é do mais específico para o mais genérico: dizer "erro" quando na
+    // verdade ninguém configurou nada seria culpar o sistema pela ausência de
+    // decisão de uma pessoa.
+    if (automation.mode === 'disabled')
+        return { ...base, status: 'not_configured' };
+    if (base.eligibleClients === 0)
+        return { ...base, status: 'blocked_eligibility' };
+    if (cursor?.last_error_class === 'auth')
+        return { ...base, status: 'blocked_credential' };
+    if (cursor?.last_error_class)
+        return { ...base, status: 'error' };
+    if (base.nextAttemptAfter && new Date(base.nextAttemptAfter) > new Date()) {
+        return { ...base, status: 'waiting_provider_window' };
+    }
+    if (base.lastSuccessAt)
+        return { ...base, status: 'synced' };
+    return { ...base, status: 'ready' };
+}
+//# sourceMappingURL=repository.js.map

package/dist/fiscal/ingestion/repository.js.map

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

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

@@ -0,0 +1,92 @@
+import { type FiscalEnvironmentTag, type FiscalFetchResult } from './provider.js';
+/**
+ * O provedor sintético OPERACIONAL — um servidor com as regras do oficial,
+ * incluindo as maneiras pelas quais ele falha.
+ *
+ * ## Por que o transporte sintético da Fase 1 não bastava
+ *
+ * `SyntheticAdnTransport` reproduz a mecânica FELIZ: lote, NSU crescente,
+ * `ultNSU`/`maxNSU`, esgotamento. Ele provou a ingestão, e continua válido.
+ *
+ * A Fase 2 precisa provar outra coisa: que o motor sobrevive ao provedor real,
+ * que é um serviço público sob carga. Um serviço assim devolve 429 no meio da
+ * carteira, 503 durante uma janela de manutenção, 401 quando a procuração
+ * venceu e, de vez em quando, um XML que o parser não lê.
+ *
+ * Cada uma dessas exige um tratamento DIFERENTE — e testar só o caminho feliz
+ * deixa exatamente as diferenças sem prova. Este provedor é roteirizável: a
+ * falha da terceira chamada é declarada, e o teste mede a decisão que ela
+ * produz.
+ *
+ * ## Ele não fabrica resposta de servidor oficial
+ *
+ * Ele fabrica um servidor com as REGRAS do oficial, e isso é dito em voz alta.
+ * O XML é fixture conforme o XSD publicado; nenhum documento de empresa real
+ * passa por aqui.
+ */
+export type SyntheticFault = 
+/** 429 com `Retry-After`. O motor deve OBEDECER, não estimar. */
+{
+    kind: 'rate_limit';
+    retryAfterSeconds?: number;
+}
+/** 401: credencial recusada. Não retenta; abre tarefa humana. */
+ | {
+    kind: 'unauthorized';
+}
+/** 403: o contribuinte não tem direito àquele documento. */
+ | {
+    kind: 'forbidden';
+}
+/** 5xx: indisponível. Retenta com recuo e conta para o disjuntor. */
+ | {
+    kind: 'server_error';
+    status?: number;
+}
+/** O socket não respondeu dentro do prazo. Pode ter sido processado. */
+ | {
+    kind: 'timeout';
+}
+/** Resposta entregue, conteúdo ilegível. Vai para a quarentena, não some. */
+ | {
+    kind: 'malformed';
+}
+/** O MESMO lote da chamada anterior. A deduplicação tem de absorver. */
+ | {
+    kind: 'replay';
+}
+/** Nada de errado. Serve para posicionar falhas em chamadas específicas. */
+ | {
+    kind: 'ok';
+};
+export interface SyntheticProviderDocument {
+    nsu: string;
+    xml: string;
+}
+export interface SyntheticProviderOptions {
+    documents: readonly SyntheticProviderDocument[];
+    /** Falhas por CHAMADA, em ordem. Esgotado o roteiro, tudo dá certo. */
+    script?: readonly SyntheticFault[];
+    batchLimit?: number;
+    environments?: readonly FiscalEnvironmentTag[];
+    /** Relógio injetável, para que a espera medida não dependa da sorte. */
+    now?: () => Date;
+}
+export declare class SyntheticFiscalProvider {
+    private readonly options;
+    /** Chamadas atendidas. O teste de replay e o de retentativa a inspecionam. */
+    calls: number;
+    /** NSUs entregues em cada chamada, para conferir que não houve lacuna. */
+    readonly delivered: string[][];
+    private lastBatch;
+    private lastResult;
+    constructor(options: SyntheticProviderOptions);
+    private get docs();
+    fetchDfe(input: {
+        actorDocument: string;
+        fromNsu: string | null;
+        batchLimit: number;
+        environment: FiscalEnvironmentTag;
+    }): Promise<FiscalFetchResult>;
+}
+//# sourceMappingURL=synthetic-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"synthetic-provider.d.ts","sourceRoot":"","sources":["../../../src/fiscal/ingestion/synthetic-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EAEvB,MAAM,eAAe,CAAC;AAGvB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,MAAM,cAAc;AACxB,iEAAiE;AAC/D;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAE;AACpD,iEAAiE;GAC/D;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE;AAC1B,4DAA4D;GAC1D;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE;AACvB,qEAAqE;GACnE;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;AAC3C,wEAAwE;GACtE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE;AACrB,6EAA6E;GAC3E;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE;AACvB,wEAAwE;GACtE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE;AACpB,4EAA4E;GAC1E;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC;AAEnB,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAChD,uEAAuE;IACvE,MAAM,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC/C,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,qBAAa,uBAAuB;IAQtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,8EAA8E;IAC9E,KAAK,SAAK;IACV,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAM;IACpC,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,UAAU,CAAkC;gBAEvB,OAAO,EAAE,wBAAwB;IAE9D,OAAO,KAAK,IAAI,GAKf;IAEK,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;CAgG/B"}