@baruk/core 0.4.2 → 0.5.0

package/dist/cjs/fiscal/sync/policy.js.map

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

package/dist/cjs/fiscal/sync/reprocess.js

@@ -0,0 +1,241 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reprocessFiscalInboxItem = reprocessFiscalInboxItem;
+exports.listFiscalInbox = listFiscalInbox;
+const audit_js_1 = require("../../audit/audit.js");
+const pipeline_js_1 = require("../ingestion/pipeline.js");
+/**
+ * Reprocessa um item preservado.
+ *
+ * `deps.adapter` precisa ser o adapter da MESMA fonte que guardou o item —
+ * outro leiaute produziria uma interpretação errada de bytes válidos. Quem
+ * chama confere; a rota faz isso pela `source` gravada na linha.
+ */
+async function reprocessFiscalInboxItem(tx, deps, input) {
+    const now = input.now ?? new Date();
+    const [row] = await tx `
+    SELECT id, client_id, source, source_environment, source_nsu, state,
+           document_type, raw, reject_reason
+      FROM fiscal_ingestion_inbox
+     WHERE id = ${input.inboxId}
+  `;
+    if (!row) {
+        return {
+            inboxId: input.inboxId,
+            outcome: 'not_found',
+            detail: 'item não encontrado',
+            documentId: null,
+            reconciled: 0,
+        };
+    }
+    const base = {
+        tenantId: input.tenantId,
+        clientId: row.client_id,
+        actorDocument: input.actorDocument,
+        environment: row.source_environment,
+        documentType: (row.document_type ?? 'nfse'),
+        now,
+        actorId: input.actorId ?? null,
+    };
+    // Já aplicado: reprocessar não é erro, e não faz nada. Devolver isso é melhor
+    // do que reingerir bytes que já viraram linha — seria trabalho para produzir
+    // uma duplicata que o banco recusaria de qualquer forma.
+    if (row.state === 'applied') {
+        return {
+            inboxId: row.id,
+            outcome: 'already_resolved',
+            detail: 'item já aplicado',
+            documentId: null,
+            reconciled: 0,
+        };
+    }
+    // Pendente: o que falta não é interpretar, é o alvo existir. Reconciliar é a
+    // operação certa, e ela é idempotente por construção.
+    if (row.state === 'pending_target') {
+        const reconciled = await (0, pipeline_js_1.reconcileFiscalPendingEvents)(tx, deps, {
+            tenantId: input.tenantId,
+            clientId: row.client_id,
+        });
+        await auditar(tx, input, row, reconciled > 0 ? 'event_applied' : 'event_pending', reconciled);
+        return {
+            inboxId: row.id,
+            outcome: reconciled > 0 ? 'event_applied' : 'event_pending',
+            detail: reconciled > 0
+                ? 'documento-alvo encontrado; evento aplicado'
+                : 'documento-alvo ainda não chegou',
+            documentId: null,
+            reconciled,
+        };
+    }
+    // Inválido: tenta interpretar de novo com o parser ATUAL.
+    const doc = {
+        nsu: row.source_nsu ?? '0',
+        raw: new Uint8Array(row.raw),
+        mimeType: 'application/xml',
+    };
+    let parsed;
+    try {
+        parsed = deps.adapter.parse(doc);
+    }
+    catch (err) {
+        const reason = err ? 'parse_failed' : 'parse_failed';
+        await tx `
+      UPDATE fiscal_ingestion_inbox
+         SET reprocessed_at = ${now}, reprocess_count = reprocess_count + 1,
+             reject_reason = ${reason}
+       WHERE id = ${row.id}
+    `;
+        return {
+            inboxId: row.id,
+            outcome: 'still_invalid',
+            detail: 'o parser atual ainda não lê este item',
+            documentId: null,
+            reconciled: 0,
+        };
+    }
+    if (parsed.event) {
+        // Promoção NO LUGAR. `dedupe_key` muda de `raw:<sha>` para a identidade
+        // real do evento, e é aí que pode haver conflito com um evento idêntico já
+        // guardado — caso em que este item é redundante e o outro já o preserva.
+        try {
+            await tx.savepoint((sp) => sp `
+        UPDATE fiscal_ingestion_inbox
+           SET state             = 'pending_target',
+               document_type     = ${parsed.documentType},
+               event_type        = ${parsed.event.type},
+               event_code        = ${parsed.event.code ?? null},
+               event_sequence    = ${parsed.event.sequence ?? null},
+               occurred_at       = ${parsed.event.occurredAt ?? null},
+               target_access_key = ${parsed.event.targetAccessKey},
+               dedupe_key        = ${parsed.dedupeKey},
+               reject_reason     = NULL,
+               reprocessed_at    = ${now},
+               reprocess_count   = reprocess_count + 1
+         WHERE id = ${row.id}
+      `);
+        }
+        catch {
+            await tx `
+        UPDATE fiscal_ingestion_inbox
+           SET reprocessed_at = ${now}, reprocess_count = reprocess_count + 1,
+               reject_reason = 'duplicate_of_existing_event'
+         WHERE id = ${row.id}
+      `;
+            return {
+                inboxId: row.id,
+                outcome: 'still_invalid',
+                detail: 'evento idêntico já preservado em outro item',
+                documentId: null,
+                reconciled: 0,
+            };
+        }
+        const reconciled = await (0, pipeline_js_1.reconcileFiscalPendingEvents)(tx, deps, {
+            tenantId: input.tenantId,
+            clientId: row.client_id,
+        });
+        await auditar(tx, input, row, reconciled > 0 ? 'event_applied' : 'event_pending', reconciled);
+        return {
+            inboxId: row.id,
+            outcome: reconciled > 0 ? 'event_applied' : 'event_pending',
+            detail: reconciled > 0
+                ? 'reinterpretado como evento e aplicado'
+                : 'reinterpretado como evento; alvo ainda não existe',
+            documentId: null,
+            reconciled,
+        };
+    }
+    // Documento. O pipeline grava com a MESMA dedupe do caminho normal.
+    const resultado = await (0, pipeline_js_1.reingestPreservedItem)(tx, deps, base, doc);
+    if (resultado.kind === 'still_invalid') {
+        await tx `
+      UPDATE fiscal_ingestion_inbox
+         SET reprocessed_at = ${now}, reprocess_count = reprocess_count + 1,
+             reject_reason = ${resultado.reason}
+       WHERE id = ${row.id}
+    `;
+        return {
+            inboxId: row.id,
+            outcome: 'still_invalid',
+            detail: resultado.reason,
+            documentId: null,
+            reconciled: 0,
+        };
+    }
+    // Duplicata quer dizer que o documento JÁ existe — o item está resolvido do
+    // mesmo jeito, e apontar para a linha existente é mais útil do que apontar
+    // para nada.
+    const documentId = resultado.kind === 'document_created'
+        ? resultado.documentId
+        : ((await tx `
+            SELECT id FROM fiscal_document
+             WHERE client_id = ${row.client_id} AND dedupe_key = ${parsed.dedupeKey}
+             LIMIT 1
+          `)[0]?.id ?? null);
+    await tx `
+    UPDATE fiscal_ingestion_inbox
+       SET state = 'applied', applied_at = ${now}, applied_document_id = ${documentId},
+           reject_reason = NULL, reprocessed_at = ${now},
+           reprocess_count = reprocess_count + 1
+     WHERE id = ${row.id}
+  `;
+    await auditar(tx, input, row, resultado.kind === 'document_created' ? 'document_created' : 'document_duplicate', 0);
+    return {
+        inboxId: row.id,
+        outcome: resultado.kind === 'document_created' ? 'document_created' : 'document_duplicate',
+        detail: resultado.kind === 'document_created'
+            ? 'reinterpretado como documento e gravado'
+            : 'documento já existia; item marcado como resolvido',
+        documentId,
+        reconciled: 0,
+    };
+}
+/** Trilha: contadores e identificadores. Nunca XML, nunca nome, nunca valor. */
+async function auditar(tx, input, row, outcome, reconciled) {
+    await (0, audit_js_1.appendAudit)(tx, {
+        actorType: input.actorId ? 'user' : 'system',
+        actorId: input.actorId ?? null,
+        action: 'fiscal.inbox.reprocessed',
+        resourceType: 'fiscal_ingestion_inbox',
+        resourceId: row.id,
+        metadata: {
+            clientId: row.client_id,
+            source: row.source,
+            environment: row.source_environment,
+            previousState: row.state,
+            previousReason: row.reject_reason,
+            outcome,
+            reconciled,
+        },
+    });
+}
+/** A caixa de entrada, para a tela. Sem o `raw` — bytes não vão em JSON de API. */
+async function listFiscalInbox(tx, input = {}) {
+    const limit = Math.min(Math.max(input.limit ?? 100, 1), 500);
+    const state = input.state ?? 'any';
+    const rows = await tx `
+    SELECT i.id, i.client_id, c.display_name AS client_name, i.source, i.source_environment,
+           i.source_nsu, i.state, i.event_type, i.target_access_key, i.reject_reason,
+           i.received_at, i.reprocess_count, octet_length(i.raw) AS size_bytes
+      FROM fiscal_ingestion_inbox i
+      LEFT JOIN client c ON c.id = i.client_id
+     WHERE ${state === 'any' ? tx `true` : tx `i.state = ${state}`}
+     ORDER BY i.received_at DESC
+     LIMIT ${limit}
+  `;
+    return rows.map((r) => ({
+        id: r.id,
+        clientId: r.client_id,
+        clientName: r.client_name,
+        source: r.source,
+        environment: r.source_environment,
+        sourceNsu: r.source_nsu,
+        state: r.state,
+        eventType: r.event_type,
+        targetAccessKey: r.target_access_key,
+        rejectReason: r.reject_reason,
+        receivedAt: r.received_at.toISOString(),
+        reprocessCount: r.reprocess_count,
+        sizeBytes: r.size_bytes,
+    }));
+}
+//# sourceMappingURL=reprocess.js.map

package/dist/cjs/fiscal/sync/reprocess.js.map

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

package/dist/cjs/fiscal/sync/retry.js

@@ -0,0 +1,183 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.categorizeProviderError = categorizeProviderError;
+exports.categorizeTransportError = categorizeTransportError;
+exports.categorizeHttpStatus = categorizeHttpStatus;
+exports.decideFiscalRetry = decideFiscalRetry;
+exports.decideFromError = decideFromError;
+const types_js_1 = require("../transport/types.js");
+const provider_js_1 = require("../ingestion/provider.js");
+/**
+ * Perfil de recuo por categoria.
+ *
+ * `base` é a espera da PRIMEIRA tentativa falha; ela dobra a cada tentativa até
+ * `cap`. Os números não são arbitrários:
+ *
+ *   - `PROVIDER_RATE_LIMIT` começa em uma HORA porque é o que a NT 2014.002 §3.5
+ *     exige, e errar para menos custa o CNPJ de um terceiro.
+ *   - `AUTHENTICATION_FAILED` e as duas de certificado não têm recuo: elas não
+ *     retentam. O campo existe como zero explícito, para que ninguém leia a
+ *     ausência como "use o default".
+ *   - `NETWORK_TRANSIENT` começa em 30s: curto o bastante para um soluço de rede
+ *     caber dentro do mesmo ciclo, longo o bastante para não ser um laço.
+ */
+const PROFILE = {
+    NETWORK_TRANSIENT: { retryable: true, baseMs: 30_000, capMs: 900_000, provider: true },
+    PROVIDER_RATE_LIMIT: { retryable: true, baseMs: 3_600_000, capMs: 21_600_000, provider: true },
+    PROVIDER_TEMPORARILY_UNAVAILABLE: {
+        retryable: true,
+        baseMs: 300_000,
+        capMs: 3_600_000,
+        provider: true,
+    },
+    AUTHENTICATION_FAILED: { retryable: false, baseMs: 0, capMs: 0, provider: false },
+    CERTIFICATE_INVALID: { retryable: false, baseMs: 0, capMs: 0, provider: false },
+    CERTIFICATE_EXPIRED: { retryable: false, baseMs: 0, capMs: 0, provider: false },
+    PERMISSION_DENIED: { retryable: false, baseMs: 0, capMs: 0, provider: false },
+    // Resposta que não é o que o contrato promete pode ser um deploy ruim do
+    // provedor — volta sozinho — mas insistir rápido não ajuda em nada.
+    BAD_RESPONSE: { retryable: true, baseMs: 600_000, capMs: 3_600_000, provider: true },
+    // Documento ilegível é determinístico: o MESMO XML vai falhar de novo. Ele já
+    // ficou preservado na caixa de entrada pelo pipeline; retentar o lote não o
+    // conserta e ainda gasta a cota do cliente.
+    MALFORMED_DOCUMENT: { retryable: false, baseMs: 0, capMs: 0, provider: false },
+    // Outro processo mexeu no cursor. Volta sozinho, e rápido: o conflito é nosso.
+    CURSOR_CONFLICT: { retryable: true, baseMs: 60_000, capMs: 600_000, provider: false },
+    INTERNAL_ERROR: { retryable: true, baseMs: 300_000, capMs: 3_600_000, provider: false },
+};
+const INTERVENTION = {
+    AUTHENTICATION_FAILED: 'auth_required',
+    CERTIFICATE_EXPIRED: 'certificate_expired',
+    CERTIFICATE_INVALID: 'certificate_invalid',
+    PERMISSION_DENIED: 'provider_access_denied',
+};
+/** Classe do provedor → categoria de decisão. */
+function categorizeProviderError(cls) {
+    switch (cls) {
+        case 'transient':
+            return 'PROVIDER_TEMPORARILY_UNAVAILABLE';
+        case 'throttled':
+            return 'PROVIDER_RATE_LIMIT';
+        case 'auth':
+            return 'AUTHENTICATION_FAILED';
+        case 'not_allowed':
+            return 'PERMISSION_DENIED';
+        case 'invalid':
+            return 'MALFORMED_DOCUMENT';
+        case 'unknown':
+            // Não classificado é tratado como transitório COM TETO — nunca como
+            // permanente (perderia recuperação) nem como retentável para sempre.
+            return 'NETWORK_TRANSIENT';
+    }
+}
+/** Classe do transporte → categoria de decisão. */
+function categorizeTransportError(cls) {
+    switch (cls) {
+        case 'network':
+            return 'NETWORK_TRANSIENT';
+        case 'timeout':
+            // Timeout NÃO é "não aconteceu": o servidor pode ter processado. Retenta,
+            // e a idempotência da ingestão é quem absorve a repetição.
+            return 'NETWORK_TRANSIENT';
+        case 'tls':
+            return 'PROVIDER_TEMPORARILY_UNAVAILABLE';
+        case 'certificate':
+            return 'CERTIFICATE_INVALID';
+        case 'protocol':
+            return 'BAD_RESPONSE';
+    }
+}
+/** Status HTTP → categoria, para provedores REST (o ADN é um). */
+function categorizeHttpStatus(status) {
+    if (status === 401)
+        return 'AUTHENTICATION_FAILED';
+    if (status === 403)
+        return 'PERMISSION_DENIED';
+    if (status === 429)
+        return 'PROVIDER_RATE_LIMIT';
+    if (status === 408 || status === 504)
+        return 'NETWORK_TRANSIENT';
+    if (status === 503 || status === 502)
+        return 'PROVIDER_TEMPORARILY_UNAVAILABLE';
+    if (status >= 500)
+        return 'PROVIDER_TEMPORARILY_UNAVAILABLE';
+    if (status >= 400)
+        return 'BAD_RESPONSE';
+    return 'INTERNAL_ERROR';
+}
+/**
+ * Decide o que fazer com uma falha.
+ *
+ * ## Jitter é obrigatório, não enfeite
+ *
+ * Sem ele, cem clientes que falharam no mesmo minuto voltam no mesmo minuto —
+ * o rebanho que derruba o provedor de novo assim que ele levanta. O jitter é
+ * "full jitter": um sorteio em `[0, espera]`, e não `espera ± 10%`. A variante
+ * completa é a que realmente espalha; a estreita só desloca o rebanho.
+ *
+ * ## `Retry-After` vence o nosso cálculo — com piso
+ *
+ * Quando o servidor diz quando voltar, ele sabe mais do que nós. Mas um
+ * `Retry-After: 0` num 429 é o servidor se contradizendo; o piso de 60s existe
+ * para que a obediência não vire laço.
+ */
+function decideFiscalRetry(category, input, 
+/** Código curto do provedor/transporte. Sem ele, a categoria serve de rótulo. */
+code = category) {
+    const profile = PROFILE[category];
+    const escalateAfter = input.humanEscalationAfter ?? 5;
+    if (!profile.retryable) {
+        return {
+            category,
+            retryable: false,
+            nextAttemptAt: null,
+            countsAgainstProvider: profile.provider,
+            interventionKind: INTERVENTION[category] ?? null,
+            code,
+        };
+    }
+    let nextAttemptAt;
+    if (input.retryAfter && input.retryAfter > input.now) {
+        const floorMs = category === 'PROVIDER_RATE_LIMIT' ? 60_000 : 0;
+        const asked = input.retryAfter.getTime() - input.now.getTime();
+        nextAttemptAt = new Date(input.now.getTime() + Math.max(asked, floorMs));
+    }
+    else {
+        // Expoente limitado a 6 antes do teto: 2^6 já ultrapassa qualquer `capMs`
+        // desta tabela, e deixar o expoente crescer sem limite produz `Infinity`
+        // depois de mil falhas — uma data inválida em vez de uma espera longa.
+        const exponent = Math.min(input.previousFailures, 6);
+        const ceiling = Math.min(profile.baseMs * 2 ** exponent, profile.capMs);
+        const random = input.random ?? Math.random;
+        // Full jitter com piso na metade do teto seria o "equal jitter"; aqui o
+        // sorteio é em [0, ceiling] e o piso é a base, para que a primeira falha
+        // nunca produza uma retentativa imediata.
+        const jittered = Math.floor(random() * ceiling);
+        nextAttemptAt = new Date(input.now.getTime() + Math.max(jittered, profile.baseMs));
+    }
+    // Retentável não significa retentável para sempre. Depois de N falhas
+    // consecutivas, o caso deixa de ser "o provedor oscilou" e passa a ser algo
+    // que uma pessoa precisa olhar — sem parar de retentar, porque pode voltar.
+    const escalated = input.previousFailures + 1 >= escalateAfter;
+    return {
+        category,
+        retryable: true,
+        nextAttemptAt,
+        countsAgainstProvider: profile.provider,
+        interventionKind: escalated ? 'repeated_failure' : null,
+        code,
+    };
+}
+/** Atalho: recebe o erro e devolve a decisão, sem quem chama classificar antes. */
+function decideFromError(err, input) {
+    if (err instanceof types_js_1.FiscalTransportError) {
+        return decideFiscalRetry(categorizeTransportError(err.errorClass), { ...input, retryAfter: input.retryAfter ?? err.retryAfter }, err.code);
+    }
+    if (err instanceof provider_js_1.FiscalProviderError) {
+        return decideFiscalRetry(categorizeProviderError(err.errorClass), { ...input, retryAfter: input.retryAfter ?? err.retryAfter }, err.providerCode ?? err.errorClass);
+    }
+    // Erro não classificado é NOSSO até prova em contrário: tratá-lo como falha do
+    // provedor esconderia um defeito de código atrás de um recuo educado.
+    return decideFiscalRetry('INTERNAL_ERROR', input, 'UNCLASSIFIED');
+}
+//# sourceMappingURL=retry.js.map

package/dist/cjs/fiscal/sync/retry.js.map

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

package/dist/cjs/fiscal/sync/secret-boundary.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FiscalSecretBoundaryError = void 0;
+exports.grantFiscalSecretAccess = grantFiscalSecretAccess;
+exports.assertFiscalSecretAccess = assertFiscalSecretAccess;
+exports.describeAdapter = describeAdapter;
+/**
+ * A fronteira entre "decidir se devemos sincronizar" e "abrir o cofre".
+ *
+ * ## O defeito que este módulo existe para tornar indizível
+ *
+ * A primeira escrita da Fase 2 tinha UM contrato para a fonte:
+ *
+ *   adapterFactory({ tx, tenantId, clientId, documentType, environment })
+ *     → { adapter, dispose } | null
+ *
+ * Ele devolvia o adapter JÁ com transporte e credencial. Quem o implementasse
+ * para homologação ou produção teria de decifrar o material do certificado ali
+ * dentro — não por descuido, mas porque era isso que o contrato pedia. E o
+ * orquestrador o chamava logo depois da cadência, ANTES da janela do cursor, do
+ * disjuntor, da prontidão da credencial, do CNPJ do ator e do lease.
+ *
+ * O resultado era estrutural, não hipotético: cinco portões que sabem dizer
+ * "não" sem tocar em segredo nenhum ficavam depois do acesso ao cofre. Um
+ * escritório com duzentos clientes cujo disjuntor estivesse aberto decifraria
+ * duzentos certificados para em seguida não fazer requisição alguma.
+ *
+ * ## A separação: descritor primeiro, material depois
+ *
+ * A fonte passa a ser resolvida em duas etapas com custos diferentes:
+ *
+ *   descritor    quem é o provedor, qual ambiente, qual slug de fonte, qual
+ *                teto de lote, qual credencial ele exige. Tudo isto é METADATA:
+ *                sai de configuração e de tabela, e nenhuma parte exige abrir
+ *                material criptográfico.
+ *
+ *   materialize  agora sim: cofre, chave privada, agente de TLS mútuo, adapter.
+ *
+ * O descritor é o que os portões precisam — a fonte (`source`) governa cursor,
+ * disjuntor e prontidão, e ela vem do descritor. `materialize` só é convidado
+ * quando não sobrou nenhum motivo para não sincronizar.
+ *
+ * ## Por que a autorização é um objeto, e não um booleano
+ *
+ * Uma convenção ("chame materialize só depois dos portões") volta a ser violada
+ * no primeiro refactor, em silêncio. Aqui a autorização é um valor que só o
+ * orquestrador consegue emitir, e `loadFiscalTlsMaterial` a exige.
+ *
+ * A marca não é um campo: é um `WeakSet` deste módulo. Um objeto com a forma
+ * certa não passa; uma cópia por spread do objeto certo também não passa. Só
+ * passa a instância que `grantFiscalSecretAccess` devolveu — e essa função não
+ * é reexportada pelo `index` do pacote, de modo que fora de `@baruk/core` não
+ * existe caminho para fabricá-la.
+ *
+ * Isso não é defesa contra um adversário com acesso ao processo: é a defesa
+ * contra a próxima pessoa apressada, que é quem de fato reintroduz este defeito.
+ */
+/** Violação da fronteira. Classe e contexto — nunca material, nunca ponteiro. */
+class FiscalSecretBoundaryError extends Error {
+    stage;
+    constructor(stage) {
+        super(`SECRET_BOUNDARY_VIOLATION: ${stage}`);
+        this.stage = stage;
+        this.name = 'FiscalSecretBoundaryError';
+    }
+}
+exports.FiscalSecretBoundaryError = FiscalSecretBoundaryError;
+/**
+ * As autorizações realmente emitidas.
+ *
+ * `WeakSet` e não um campo `Symbol`: um campo sobrevive a `{...auth}`, a
+ * `structuredClone` e a `JSON.parse(JSON.stringify(auth))`, e qualquer uma
+ * dessas três é como a checagem passaria a aceitar um objeto que os portões
+ * nunca aprovaram.
+ */
+const emitidas = new WeakSet();
+/**
+ * Emite o passe. Chamada em UM lugar: o orquestrador, depois do último portão.
+ *
+ * Deliberadamente ausente do `index.ts` do pacote. Um `grep` por este nome
+ * responde "quem pode autorizar a abertura do cofre fiscal?" — e a resposta tem
+ * de caber em uma tela.
+ */
+function grantFiscalSecretAccess(input) {
+    const auth = Object.freeze({ ...input });
+    emitidas.add(auth);
+    return auth;
+}
+/**
+ * Recusa qualquer coisa que não tenha saído de `grantFiscalSecretAccess`.
+ *
+ * Lança em vez de devolver `false` porque não existe caminho de recuperação:
+ * chegar aqui sem passe significa que a ordem dos portões foi quebrada, e
+ * seguir adiante seria exatamente o dano que a fronteira existe para impedir.
+ */
+function assertFiscalSecretAccess(auth, stage) {
+    if (!auth || typeof auth !== 'object' || !emitidas.has(auth)) {
+        throw new FiscalSecretBoundaryError(stage);
+    }
+}
+/**
+ * Descritor derivado de um adapter JÁ construído.
+ *
+ * Existe para as fontes que não têm segredo a materializar — hoje, o provedor
+ * sintético. Construir o adapter durante a resolução do descritor só é legítimo
+ * porque ali não há cofre a abrir: um adapter que exija material de certificado
+ * NÃO pode nascer nesta etapa, e é para esse caso que `materialize` existe.
+ *
+ * A alternativa seria repetir os cinco campos à mão em cada chamador, e a
+ * primeira divergência entre o descritor e o adapter que ele descreve
+ * apareceria como um teto de lote errado contra o ambiente nacional.
+ */
+function describeAdapter(adapter, credentialKind = 'certificate_a1') {
+    return {
+        source: adapter.source,
+        documentTypes: adapter.documentTypes,
+        environments: adapter.environments,
+        batchLimit: adapter.batchLimit,
+        exhaustedBackoffSeconds: adapter.exhaustedBackoffSeconds,
+        credentialKind,
+    };
+}
+//# sourceMappingURL=secret-boundary.js.map

package/dist/cjs/fiscal/sync/secret-boundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret-boundary.js","sourceRoot":"","sources":["../../../../src/fiscal/sync/secret-boundary.ts"],"names":[],"mappings":";;;AAwGA,0DAMC;AASD,4DAOC;AAiFD,0CAYC;AAnND;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,iFAAiF;AACjF,MAAa,yBAA0B,SAAQ,KAAK;IAC7B;IAArB,YAAqB,KAAa;QAChC,KAAK,CAAC,8BAA8B,KAAK,EAAE,CAAC,CAAC;QAD1B,UAAK,GAAL,KAAK,CAAQ;QAEhC,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AALD,8DAKC;AAqBD;;;;;;;GAOG;AACH,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAU,CAAC;AAEvC;;;;;;GAMG;AACH,SAAgB,uBAAuB,CACrC,KAAgC;IAEhC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IACzC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnB,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,wBAAwB,CACtC,IAAkD,EAClD,KAAa;IAEb,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,yBAAyB,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAqED;;;;;;;;;;;GAWG;AACH,SAAgB,eAAe,CAC7B,OAA8B,EAC9B,iBAAuC,gBAAgB;IAEvD,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,uBAAuB,EAAE,OAAO,CAAC,uBAAuB;QACxD,cAAc;KACf,CAAC;AACJ,CAAC"}