@baruk/core 0.4.2 → 0.6.0

package/dist/fiscal/enrollment.js

@@ -0,0 +1,126 @@
+import { uuidv7 } from '@baruk/shared';
+import { appendAudit } from '../audit/audit.js';
+import { getTenantFiscalAutomation, } from './eligibility.js';
+/**
+ * Declara em que ambiente o escritório opera automação fiscal.
+ *
+ * `production` é a fronteira entre ensaio e operação real: a partir dela, o
+ * material de um contribuinte pode ser apresentado a um servidor da Receita. Por
+ * isso o ato é auditado com o modo anterior e o novo — "passou a ser produção"
+ * não responde a pergunta que se faz meses depois.
+ */
+export async function setTenantFiscalAutomation(tx, input) {
+    const anterior = await getTenantFiscalAutomation(tx);
+    const ligando = input.mode !== 'disabled';
+    await tx `
+    INSERT INTO tenant_fiscal_automation (tenant_id, mode, enabled_at, enabled_by, note, updated_at)
+    VALUES (
+      current_setting('app.current_tenant')::uuid, ${input.mode},
+      ${ligando ? new Date() : null}, ${ligando ? input.actorId : null},
+      ${input.note ?? null}, now()
+    )
+    ON CONFLICT (tenant_id) DO UPDATE SET
+      mode = EXCLUDED.mode,
+      enabled_at = EXCLUDED.enabled_at,
+      enabled_by = EXCLUDED.enabled_by,
+      note = EXCLUDED.note,
+      updated_at = now()
+  `;
+    await appendAudit(tx, {
+        actorId: input.actorId,
+        action: 'fiscal_automation_mode_changed',
+        resourceType: 'tenant_fiscal_automation',
+        resourceId: null,
+        metadata: { from: anterior.mode, to: input.mode, note: input.note ?? null },
+    });
+    return getTenantFiscalAutomation(tx);
+}
+export async function listClientFiscalEnrollments(tx, clientId) {
+    const rows = await tx `
+    SELECT document_type, enrolled_at, enrolled_by, revoked_at, note
+      FROM client_fiscal_enrollment
+     WHERE client_id = ${clientId}
+     ORDER BY document_type, enrolled_at DESC
+  `;
+    return rows.map((r) => ({
+        documentType: r.document_type,
+        enrolledAt: r.enrolled_at.toISOString(),
+        enrolledBy: r.enrolled_by,
+        revokedAt: r.revoked_at?.toISOString() ?? null,
+        note: r.note,
+        active: r.revoked_at === null,
+    }));
+}
+/**
+ * Matricula um cliente para UM tipo de documento.
+ *
+ * A granularidade é o ponto: NFS-e e NF-e são conectores diferentes, com
+ * maturidades diferentes. Uma matrícula que valesse "para tudo" habilitaria o
+ * cliente num conector que talvez nem exista.
+ *
+ * Rematricular um cliente revogado o reativa — e o registro guarda as duas
+ * datas, porque quem revogou tinha um motivo e ele não deve sumir.
+ */
+export async function enrollClientFiscal(tx, input) {
+    await tx `
+    INSERT INTO client_fiscal_enrollment (
+      id, tenant_id, client_id, document_type, enrolled_at, enrolled_by, note
+    ) VALUES (
+      ${uuidv7()}, current_setting('app.current_tenant')::uuid, ${input.clientId},
+      ${input.documentType}, now(), ${input.actorId}, ${input.note ?? null}
+    )
+    -- O índice único é PARCIAL (WHERE revoked_at IS NULL), e o ON CONFLICT
+    -- precisa repetir o predicado: sem ele o Postgres não sabe qual índice usar
+    -- e a instrução falha.
+    --
+    -- E a consequência do índice ser parcial é desejável: rematricular um
+    -- cliente que foi revogado cria uma linha NOVA em vez de reescrever a
+    -- antiga. Quem revogou tinha um motivo, e ele fica no registro.
+    ON CONFLICT (tenant_id, client_id, document_type) WHERE revoked_at IS NULL
+    DO UPDATE SET
+      enrolled_at = now(), enrolled_by = ${input.actorId}, note = ${input.note ?? null}
+  `;
+    await appendAudit(tx, {
+        actorId: input.actorId,
+        action: 'fiscal_enrollment_created',
+        resourceType: 'client_fiscal_enrollment',
+        resourceId: null,
+        metadata: { clientId: input.clientId, documentType: input.documentType },
+    });
+    return listClientFiscalEnrollments(tx, input.clientId);
+}
+/** Tira o cliente da automação. Não apaga o histórico. */
+export async function revokeClientFiscalEnrollment(tx, input) {
+    await tx `
+    UPDATE client_fiscal_enrollment
+       SET revoked_at = now(), revoked_by = ${input.actorId},
+           note = COALESCE(${input.reason ?? null}, note)
+     WHERE client_id = ${input.clientId}
+       AND document_type = ${input.documentType}
+       AND revoked_at IS NULL
+  `;
+    await appendAudit(tx, {
+        actorId: input.actorId,
+        action: 'fiscal_enrollment_revoked',
+        resourceType: 'client_fiscal_enrollment',
+        resourceId: null,
+        metadata: {
+            clientId: input.clientId,
+            documentType: input.documentType,
+            reason: input.reason ?? null,
+        },
+    });
+    return listClientFiscalEnrollments(tx, input.clientId);
+}
+/** As duas chaves numa leitura só, para a tela não fazer duas viagens. */
+export async function readFiscalEnrollmentView(tx, clientId) {
+    return {
+        automation: await getTenantFiscalAutomation(tx),
+        enrollments: await listClientFiscalEnrollments(tx, clientId),
+    };
+}
+/** O ambiente declarado casa com o pedido? Chave-geral do portão. */
+export function automationCovers(automation, environment) {
+    return automation.mode !== 'disabled' && automation.mode === environment;
+}
+//# sourceMappingURL=enrollment.js.map

package/dist/fiscal/enrollment.js.map

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

package/dist/fiscal/ingestion/__fixtures__/nfse.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Fixtures SINTÉTICAS de NFS-e, conformes ao leiaute oficial.
+ *
+ * Nenhum documento de pessoa ou empresa real. Os CNPJ usados são os de teste
+ * consagrados (`11.222.333/0001-81` e derivados com DV válido) e os nomes são
+ * inventados. O município é Goiânia (5208707) porque é o do escritório piloto,
+ * e o dado é público.
+ *
+ * A estrutura segue `NFSe_v1.01.xsd` / `tiposComplexos_v1.01.xsd`
+ * (`nfse-esquemas_xsd-v1-01-20260209.zip`, 09/02/2026): raiz `NFSe`, atributo
+ * `versao`, `infNFSe` com `@Id` de 53 posições, `emit`, `DPS/infDPS/toma`,
+ * `valores`, e o bloco `IBSCBS` que a v1.01 já traz.
+ *
+ * A chave obedece a regra do XSD: `"NFS" + IBGE(7) + AmbGer(1) + TpInsc(1) +
+ * Insc(14) + nNFSe(13) + AAMM(4) + cNum(9) + DV(1)`.
+ */
+interface NfseFixtureInput {
+    nNFSe: string;
+    cNum: string;
+    emitCnpj?: string;
+    emitNome?: string;
+    tomaCnpj?: string;
+    tomaNome?: string;
+    /** Intermediário (`interm` do DPS). Ausente = o bloco não é emitido. */
+    intermCnpj?: string;
+    intermNome?: string;
+    /** `false` remove o bloco `toma` — o caso em que a direção não decide. */
+    withToma?: boolean;
+    dhProc?: string;
+    valor?: string;
+    anoMes?: string;
+    withIbsCbs?: boolean;
+}
+/** Monta a chave de 53 posições exatamente como o XSD a descreve. */
+export declare function nfseAccessKey(input: {
+    nNFSe: string;
+    cNum: string;
+    anoMes: string;
+    emitCnpj: string;
+    dv?: string;
+}): string;
+export declare function nfseFixture(input: NfseFixtureInput): string;
+/** Evento de cancelamento sobre uma chave existente. */
+export declare function nfseCancellationFixture(chNFSe: string, seq?: string): string;
+/** XML malformado — tag não fechada. */
+export declare const MALFORMED_XML = "<NFSe versao=\"1.01\"><infNFSe Id=\"NFS1\">";
+/** XML bem formado, mas de raiz que este adapter não reconhece. */
+export declare const UNKNOWN_ROOT_XML = "<?xml version=\"1.0\"?><DPS xmlns=\"http://www.sped.fazenda.gov.br/nfse\" versao=\"1.01\"><infDPS/></DPS>";
+/**
+ * Ataque XXE clássico. O leitor tem de RECUSAR na entrada — e a recusa não
+ * depende de configuração, porque ele não sabe expandir entidade.
+ */
+export declare const XXE_ATTACK_XML = "<?xml version=\"1.0\"?>\n<!DOCTYPE NFSe [<!ENTITY xxe SYSTEM \"file:///etc/passwd\">]>\n<NFSe xmlns=\"http://www.sped.fazenda.gov.br/nfse\" versao=\"1.01\">\n  <infNFSe Id=\"NFS52087071211222333000181000000000000126090000000010\">\n    <emit><CNPJ>&xxe;</CNPJ><xNome>x</xNome></emit>\n  </infNFSe>\n</NFSe>";
+/** Chave fora do formato de 53 posições. */
+export declare function nfseInvalidKeyFixture(): string;
+export {};
+//# sourceMappingURL=nfse.d.ts.map

package/dist/fiscal/ingestion/__fixtures__/nfse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nfse.d.ts","sourceRoot":"","sources":["../../../../src/fiscal/ingestion/__fixtures__/nfse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,UAAU,gBAAgB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAMD,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,GAAG,MAAM,CAYT;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CA+D3D;AAED,wDAAwD;AACxD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAM,GAAG,MAAM,CAUzE;AAED,wCAAwC;AACxC,eAAO,MAAM,aAAa,gDAA4C,CAAC;AAEvE,mEAAmE;AACnE,eAAO,MAAM,gBAAgB,8GAC0E,CAAC;AAExG;;;GAGG;AACH,eAAO,MAAM,cAAc,uTAMnB,CAAC;AAET,4CAA4C;AAC5C,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C"}

package/dist/fiscal/ingestion/__fixtures__/nfse.js

@@ -0,0 +1,121 @@
+/**
+ * Fixtures SINTÉTICAS de NFS-e, conformes ao leiaute oficial.
+ *
+ * Nenhum documento de pessoa ou empresa real. Os CNPJ usados são os de teste
+ * consagrados (`11.222.333/0001-81` e derivados com DV válido) e os nomes são
+ * inventados. O município é Goiânia (5208707) porque é o do escritório piloto,
+ * e o dado é público.
+ *
+ * A estrutura segue `NFSe_v1.01.xsd` / `tiposComplexos_v1.01.xsd`
+ * (`nfse-esquemas_xsd-v1-01-20260209.zip`, 09/02/2026): raiz `NFSe`, atributo
+ * `versao`, `infNFSe` com `@Id` de 53 posições, `emit`, `DPS/infDPS/toma`,
+ * `valores`, e o bloco `IBSCBS` que a v1.01 já traz.
+ *
+ * A chave obedece a regra do XSD: `"NFS" + IBGE(7) + AmbGer(1) + TpInsc(1) +
+ * Insc(14) + nNFSe(13) + AAMM(4) + cNum(9) + DV(1)`.
+ */
+const IBGE_GOIANIA = '5208707';
+const AMB_GERADOR = '1';
+const TIPO_INSCRICAO_CNPJ = '2';
+/** Monta a chave de 53 posições exatamente como o XSD a descreve. */
+export function nfseAccessKey(input) {
+    const key = 'NFS' +
+        IBGE_GOIANIA +
+        AMB_GERADOR +
+        TIPO_INSCRICAO_CNPJ +
+        input.emitCnpj.padStart(14, '0') +
+        input.nNFSe.padStart(13, '0') +
+        input.anoMes +
+        input.cNum.padStart(9, '0') +
+        (input.dv ?? '0');
+    return key;
+}
+export function nfseFixture(input) {
+    const emitCnpj = input.emitCnpj ?? '11222333000181';
+    const tomaCnpj = input.tomaCnpj ?? '04252011000110';
+    const dhProc = input.dhProc ?? '2026-09-03T14:20:00-03:00';
+    const anoMes = input.anoMes ?? '2609';
+    const valor = input.valor ?? '1500.00';
+    const chave = nfseAccessKey({ nNFSe: input.nNFSe, cNum: input.cNum, anoMes, emitCnpj });
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<NFSe xmlns="http://www.sped.fazenda.gov.br/nfse" versao="1.01">
+  <infNFSe Id="${chave}">
+    <xLocEmi>Goiania</xLocEmi>
+    <xLocPrestacao>Goiania</xLocPrestacao>
+    <nNFSe>${input.nNFSe}</nNFSe>
+    <cLocIncid>${IBGE_GOIANIA}</cLocIncid>
+    <xLocIncid>Goiania</xLocIncid>
+    <verAplic>SINTETICO-1.0</verAplic>
+    <ambGer>${AMB_GERADOR}</ambGer>
+    <tpEmis>1</tpEmis>
+    <procEmi>1</procEmi>
+    <cStat>100</cStat>
+    <dhProc>${dhProc}</dhProc>
+    <nDFSe>${input.nNFSe}</nDFSe>
+    <emit>
+      <CNPJ>${emitCnpj}</CNPJ>
+      <IM>123456</IM>
+      <xNome>${input.emitNome ?? 'Prestadora Sintetica Ltda'}</xNome>
+    </emit>
+    <DPS>
+      <infDPS>${input.withToma === false
+        ? ''
+        : `
+        <toma>
+          <CNPJ>${tomaCnpj}</CNPJ>
+          <xNome>${input.tomaNome ?? 'Tomadora Sintetica Ltda'}</xNome>
+        </toma>`}${input.intermCnpj
+        ? `
+        <interm>
+          <CNPJ>${input.intermCnpj}</CNPJ>
+          <xNome>${input.intermNome ?? 'Intermediaria Sintetica Ltda'}</xNome>
+        </interm>`
+        : ''}
+      </infDPS>
+    </DPS>
+    <valores>
+      <vServPrest>${valor}</vServPrest>
+      <vLiq>${valor}</vLiq>
+    </valores>${input.withIbsCbs === false
+        ? ''
+        : `
+    <IBSCBS>
+      <gIBSCBS>
+        <vBC>${valor}</vBC>
+      </gIBSCBS>
+    </IBSCBS>`}
+  </infNFSe>
+</NFSe>`;
+}
+/** Evento de cancelamento sobre uma chave existente. */
+export function nfseCancellationFixture(chNFSe, seq = '1') {
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<evento xmlns="http://www.sped.fazenda.gov.br/nfse" versao="1.01">
+  <infEvento Id="EVT${chNFSe.slice(3, 20)}">
+    <chNFSe>${chNFSe}</chNFSe>
+    <tpEvento>101101</tpEvento>
+    <nSeqEvento>${seq}</nSeqEvento>
+    <dhEvento>2026-09-05T09:00:00-03:00</dhEvento>
+  </infEvento>
+</evento>`;
+}
+/** XML malformado — tag não fechada. */
+export const MALFORMED_XML = '<NFSe versao="1.01"><infNFSe Id="NFS1">';
+/** XML bem formado, mas de raiz que este adapter não reconhece. */
+export const UNKNOWN_ROOT_XML = '<?xml version="1.0"?><DPS xmlns="http://www.sped.fazenda.gov.br/nfse" versao="1.01"><infDPS/></DPS>';
+/**
+ * Ataque XXE clássico. O leitor tem de RECUSAR na entrada — e a recusa não
+ * depende de configuração, porque ele não sabe expandir entidade.
+ */
+export const XXE_ATTACK_XML = `<?xml version="1.0"?>
+<!DOCTYPE NFSe [<!ENTITY xxe SYSTEM "file:///etc/passwd">]>
+<NFSe xmlns="http://www.sped.fazenda.gov.br/nfse" versao="1.01">
+  <infNFSe Id="NFS52087071211222333000181000000000000126090000000010">
+    <emit><CNPJ>&xxe;</CNPJ><xNome>x</xNome></emit>
+  </infNFSe>
+</NFSe>`;
+/** Chave fora do formato de 53 posições. */
+export function nfseInvalidKeyFixture() {
+    return nfseFixture({ nNFSe: '1', cNum: '1' }).replace(/Id="NFS\d+"/, 'Id="NFS123"');
+}
+//# sourceMappingURL=nfse.js.map

package/dist/fiscal/ingestion/__fixtures__/nfse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nfse.js","sourceRoot":"","sources":["../../../../src/fiscal/ingestion/__fixtures__/nfse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAoBH,MAAM,YAAY,GAAG,SAAS,CAAC;AAC/B,MAAM,WAAW,GAAG,GAAG,CAAC;AACxB,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC,qEAAqE;AACrE,MAAM,UAAU,aAAa,CAAC,KAM7B;IACC,MAAM,GAAG,GACP,KAAK;QACL,YAAY;QACZ,WAAW;QACX,mBAAmB;QACnB,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC;QAChC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC;QAC7B,KAAK,CAAC,MAAM;QACZ,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;QAC3B,CAAC,KAAK,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC;IACpB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,gBAAgB,CAAC;IACpD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,gBAAgB,CAAC;IACpD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,2BAA2B,CAAC;IAC3D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,MAAM,CAAC;IACtC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,SAAS,CAAC;IACvC,MAAM,KAAK,GAAG,aAAa,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAExF,OAAO;;iBAEQ,KAAK;;;aAGT,KAAK,CAAC,KAAK;iBACP,YAAY;;;cAGf,WAAW;;;;cAIX,MAAM;aACP,KAAK,CAAC,KAAK;;cAEV,QAAQ;;eAEP,KAAK,CAAC,QAAQ,IAAI,2BAA2B;;;gBAIpD,KAAK,CAAC,QAAQ,KAAK,KAAK;QACtB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC;;kBAEM,QAAQ;mBACP,KAAK,CAAC,QAAQ,IAAI,yBAAyB;gBAExD,GACE,KAAK,CAAC,UAAU;QACd,CAAC,CAAC;;kBAEM,KAAK,CAAC,UAAU;mBACf,KAAK,CAAC,UAAU,IAAI,8BAA8B;kBACnD;QACR,CAAC,CAAC,EACN;;;;oBAIc,KAAK;cACX,KAAK;gBAEb,KAAK,CAAC,UAAU,KAAK,KAAK;QACxB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC;;;eAGK,KAAK;;cAGhB;;QAEI,CAAC;AACT,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,uBAAuB,CAAC,MAAc,EAAE,GAAG,GAAG,GAAG;IAC/D,OAAO;;sBAEa,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;cAC3B,MAAM;;kBAEF,GAAG;;;UAGX,CAAC;AACX,CAAC;AAED,wCAAwC;AACxC,MAAM,CAAC,MAAM,aAAa,GAAG,yCAAyC,CAAC;AAEvE,mEAAmE;AACnE,MAAM,CAAC,MAAM,gBAAgB,GAC3B,qGAAqG,CAAC;AAExG;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;QAMtB,CAAC;AAET,4CAA4C;AAC5C,MAAM,UAAU,qBAAqB;IACnC,OAAO,WAAW,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;AACtF,CAAC"}

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

@@ -0,0 +1,123 @@
+import { type ClientTlsMaterial, type FiscalTransport } from '../transport/types.js';
+import { type AdnEnvelopeProfile } from '../contracts/nfse-adn-contract.js';
+import { FiscalProviderError, type FiscalEnvironmentTag, type FiscalFetchResult } from './provider.js';
+/**
+ * O transporte do ADN — pronto até onde a documentação oficial chega, e parado
+ * exatamente onde ela para.
+ *
+ * ## O que está PROVADO aqui, e o que está apenas PREPARADO
+ *
+ * **Provado**: a resolução e a AUTORIZAÇÃO do destino (allowlist), a forma da
+ * requisição, o encadeamento de NSU, a montagem do TLS mútuo, os tetos de
+ * tamanho e de descompressão, e o mapeamento de erro. Tudo isso é exercitado
+ * contra o servidor TLS sintético em toda execução da suíte.
+ *
+ * **Preparado, não provado**: os nomes dos campos do envelope e o status HTTP de
+ * cada desfecho. Não por falta de procura: as dezesseis URLs de Swagger que o
+ * gov.br publica para o ADN — oito módulos × dois ambientes — não devolvem UM
+ * byte de HTTP sem certificado ICP-Brasil de cliente (medido em 2026-09-08). O
+ * host que documenta a API é o mesmo que exige a credencial para documentá-la.
+ *
+ * Por isso o perfil oficial tem `verified: false`, e por isso este transporte
+ * recusa `homologation` E `production` — não apenas produção, como na fase
+ * anterior. Produção restrita é servidor do governo tanto quanto produção; um
+ * parser suposto contra ela devolveria zero documentos com sucesso aparente do
+ * mesmo jeito, e o cursor avançaria sobre lotes vazios até a fiscalização.
+ *
+ * ## Dois portões independentes, e é de propósito
+ *
+ *   1. `ADN_ENVELOPE_UNVERIFIED`      — não sabemos ler a resposta.
+ *   2. `ADN_REAL_TRANSPORT_DISABLED`  — ninguém autorizou falar.
+ *
+ * Nenhum implica o outro. No dia em que alguém conferir o envelope, o portão 1
+ * abre e o 2 continua fechado — porque ver a resposta uma vez não é o mesmo que
+ * autorizar o produto a sincronizar carteira de cliente sozinho.
+ */
+/** @deprecated Use `NFSE_ADN_HOSTS`. Mantido para não quebrar quem já importa. */
+export declare const ADN_HOSTS: Readonly<Record<"production" | "homologation", string>>;
+/**
+ * @deprecated Use `NFSE_ADN_ENVELOPE_SHAPE_VERIFIED` (envelope) ou
+ * `NFSE_ADN_PAYLOAD_SHAPE_VERIFIED` (conteúdo).
+ *
+ * A constante única confundia duas perguntas: sabemos ler o XML da NFS-e (sim,
+ * contra o XSD oficial v1.01) e sabemos ler o envelope que o embrulha (não).
+ * Um leitor concluía do `false` que também não sabíamos ler o documento.
+ */
+export declare const ADN_RESPONSE_SHAPE_VERIFIED = false;
+export interface AdnDfeTransportOptions {
+    environment: FiscalEnvironmentTag;
+    /** Material do contribuinte. Sem ele o handshake do ADN nem começa. */
+    tls: ClientTlsMaterial;
+    /** Base do serviço. Passa pela allowlist; nunca é destino livre. */
+    baseUrl?: string;
+    /** Transporte injetável. Ausente = HTTPS real com o material acima. */
+    transport?: FiscalTransport;
+    /**
+     * O perfil de envelope. Ausente = o do ambiente.
+     *
+     * Injetável porque é assim que o portão 2 fica testável em isolamento: com um
+     * perfil já conferido, o portão 1 passa e o 2 é quem recusa. Um teste que só
+     * conseguisse ver o primeiro "não" nunca provaria que existe um segundo.
+     */
+    profile?: AdnEnvelopeProfile;
+    timeoutMs?: number;
+}
+/**
+ * Resolve a URL de um lote.
+ *
+ * `GET /DFe/{NSU}` — o NSU é a posição de onde continuar. `0` é o começo
+ * disponível, e é o que se envia quando não há cursor: não existe "sem
+ * parâmetro" nesta API.
+ *
+ * Cursor ilegível LANÇA, e não volta para `0` em silêncio como fazia antes.
+ * Voltar para `0` contra o ambiente nacional refaz a varredura inteira do
+ * cliente — que é consumo, e consumo excessivo é o `cStat 656`, cujo bloqueio
+ * recai sobre o CNPJ do CLIENTE. Um cursor corrompido é defeito para
+ * investigar, não condição para recomeçar.
+ */
+export declare function adnDfeUrl(baseUrl: string, fromNsu: string | null): string;
+/** `GET /NFSe/{ChaveAcesso}/Eventos` — os eventos de um documento específico. */
+export declare function adnEventsUrl(baseUrl: string, accessKey: string): string;
+/**
+ * Status HTTP → erro do provedor, com a espera que o servidor pediu.
+ *
+ * A tradução mora aqui porque ela é do PROTOCOLO: `429` com `Retry-After` é o
+ * servidor dizendo quando voltar, e o motor de retentativa consome essa data em
+ * vez de estimar uma.
+ *
+ * ## O `404` deixou de significar "lote vazio"
+ *
+ * Ele era mapeado para "não há documento neste NSU" por analogia com o
+ * `cStat 137` da NF-e. A analogia não se sustenta: o ADN publica um MECANISMO
+ * PRÓPRIO para dizer isso — os códigos `E2215` e `E2230` do ANEXO_IV — e não
+ * publica status HTTP nenhum. Traduzir um status suposto em lote vazio é
+ * exatamente a fabricação de sucesso que esta fase existe para eliminar.
+ *
+ * Agora o `404` devolve `null` para que o CORPO seja lido: se ele trouxer o
+ * código oficial, o leitor de envelope o reconhece como "sem documentos"; se não
+ * trouxer, o leitor recusa. A decisão passa a sair do que o ADN diz, e não do
+ * que supomos que o status dele significa.
+ */
+export declare function mapAdnStatus(status: number, headers: Readonly<Record<string, string>>, now?: Date): FiscalProviderError | null;
+/** O perfil que um ambiente usa quando o chamador não escolhe. */
+export declare function defaultAdnProfile(environment: FiscalEnvironmentTag): AdnEnvelopeProfile;
+/**
+ * Os portões do transporte real, em ordem, e o motivo de cada um.
+ *
+ * Exportada porque a tela precisa dizer POR QUE não sincroniza — e porque um
+ * portão que só existe dentro de uma função não é conferível por teste sem
+ * construir o transporte inteiro.
+ */
+export declare function assertAdnTransportAllowed(environment: FiscalEnvironmentTag, profile: AdnEnvelopeProfile): void;
+/** O transporte do ADN, pronto para receber uma credencial real — e travado. */
+export declare function createAdnDfeTransport(options: AdnDfeTransportOptions): {
+    readonly contractVersion: string;
+    readonly profileId: string;
+    fetchDfe(input: {
+        actorDocument: string;
+        fromNsu: string | null;
+        batchLimit: number;
+        environment: FiscalEnvironmentTag;
+    }): Promise<FiscalFetchResult>;
+};
+//# sourceMappingURL=adn-transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adn-transport.d.ts","sourceRoot":"","sources":["../../../src/fiscal/ingestion/adn-transport.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAOL,KAAK,kBAAkB,EACxB,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EACL,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,kFAAkF;AAClF,eAAO,MAAM,SAAS,yDAAiB,CAAC;AAExC;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,QAAmC,CAAC;AAE5E,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,oBAAoB,CAAC;IAClC,uEAAuE;IACvE,GAAG,EAAE,iBAAiB,CAAC;IACvB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAKzE;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAOvE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACzC,GAAG,GAAE,IAAiB,GACrB,mBAAmB,GAAG,IAAI,CAsB5B;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,oBAAoB,GAAG,kBAAkB,CAIvF;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,oBAAoB,EACjC,OAAO,EAAE,kBAAkB,GAC1B,IAAI,CA+BN;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG;IACtE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,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,CAiFA"}