@baruk/core 0.5.0 → 0.6.0

package/dist/cjs/fiscal/collection/authorization.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthorizationConflictError = void 0;
+exports.grantRunAuthorization = grantRunAuthorization;
+exports.consumeRunAuthorization = consumeRunAuthorization;
+exports.revokeRunAuthorization = revokeRunAuthorization;
+exports.listRunAuthorizations = listRunAuthorizations;
+const shared_1 = require("@baruk/shared");
+const competence_js_1 = require("./competence.js");
+class AuthorizationConflictError extends Error {
+    detail;
+    constructor(detail) {
+        super(`autorização recusada: ${detail}`);
+        this.detail = detail;
+        this.name = 'AuthorizationConflictError';
+    }
+}
+exports.AuthorizationConflictError = AuthorizationConflictError;
+const DEFAULT_VALIDITY_HOURS = 48;
+const MAX_VALIDITY_HOURS = 168; // sete dias
+/**
+ * Emite a autorização.
+ *
+ * Recusa por CONFLITO quando já existe uma viva para o mesmo par
+ * (cliente, fonte, ambiente, competência) — não por capricho de unicidade, mas
+ * porque duas autorizações vivas somam duas execuções, e o produto teria
+ * prometido uma.
+ *
+ * A unicidade é do índice parcial da 0060; o `SELECT` prévio existe só para
+ * devolver um erro legível em vez de uma violação de constraint.
+ */
+async function grantRunAuthorization(tx, input) {
+    const competence = (0, competence_js_1.competenceOf)(input.competenceYear, input.competenceMonth);
+    const periodStart = input.periodStart ?? competence.periodStart;
+    const periodEnd = input.periodEnd ?? competence.periodEnd;
+    (0, competence_js_1.validateWindow)(competence, periodStart, periodEnd);
+    const hours = input.validForHours ?? DEFAULT_VALIDITY_HOURS;
+    if (!Number.isInteger(hours) || hours < 1 || hours > MAX_VALIDITY_HOURS) {
+        throw new AuthorizationConflictError(`validade deve estar entre 1 e ${MAX_VALIDITY_HOURS} horas`);
+    }
+    const live = await tx `
+    SELECT id FROM fiscal_run_authorization
+     WHERE client_id = ${input.clientId}
+       AND source = ${input.source}
+       AND environment = ${input.environment}
+       AND competence_year = ${competence.year}
+       AND competence_month = ${competence.month}
+       AND consumed_at IS NULL AND revoked_at IS NULL
+     LIMIT 1
+  `;
+    if (live[0]) {
+        throw new AuthorizationConflictError('já existe uma autorização viva para este cliente, fonte, ambiente e competência');
+    }
+    const rows = await tx `
+    INSERT INTO fiscal_run_authorization (
+      id, tenant_id, client_id, document_type, environment, source, credential_kind,
+      operation, competence_year, competence_month, period_start, period_end,
+      max_runs, runs_consumed, authorized_by, responsible_name, expires_at,
+      first_contact, trigger_kind, credential_fingerprint
+    ) VALUES (
+      ${(0, shared_1.uuidv7)()}, current_setting('app.current_tenant')::uuid, ${input.clientId},
+      ${input.documentType}, ${input.environment}, ${input.source},
+      ${input.credentialKind ?? 'certificate_a1'},
+      'READ_ONLY', ${competence.year}, ${competence.month}, ${periodStart}, ${periodEnd},
+      1, 0, ${input.authorizedBy}, ${input.responsibleName ?? null},
+      now() + (${hours}::int * interval '1 hour'),
+      ${input.firstContact ?? false}, ${input.triggerKind ?? 'manual'},
+      ${input.credentialFingerprint ?? null}
+    )
+    RETURNING ${tx.unsafe(AUTHORIZATION_COLUMNS)}
+  `;
+    return mapAuthorization(rows[0]);
+}
+/**
+ * Consome a autorização — e é AQUI que a unicidade da execução acontece.
+ *
+ * Um `SELECT` seguido de `UPDATE` deixaria a janela em que dois processos leem
+ * "viva" e ambos executam. O `WHERE consumed_at IS NULL` dentro do próprio
+ * `UPDATE` fecha essa janela no banco: o segundo afeta zero linhas e recebe
+ * `null`, que é o sinal de "não execute".
+ *
+ * Devolve `null` — e não lança — para todo desfecho de recusa. Quem chama é o
+ * orquestrador no meio de uma carteira, e uma exceção aqui derrubaria o lote por
+ * causa de um portão fechado, que é estado normal.
+ */
+async function consumeRunAuthorization(tx, input) {
+    const rows = await tx `
+    UPDATE fiscal_run_authorization SET
+      runs_consumed = runs_consumed + 1,
+      consumed_at = now(),
+      consumed_by_run_id = ${input.runId},
+      updated_at = now()
+    WHERE id = ${input.authorizationId}
+      AND consumed_at IS NULL
+      AND revoked_at IS NULL
+      AND expires_at > now()
+      AND runs_consumed < max_runs
+    RETURNING ${tx.unsafe(AUTHORIZATION_COLUMNS)}
+  `;
+    return rows[0] ? mapAuthorization(rows[0]) : null;
+}
+/**
+ * Cancela antes da execução.
+ *
+ * O mecanismo de abortar (C1.34) não precisa de tabela nova: revogar a
+ * autorização é o cancelamento, porque sem ela não há execução real. Revogar uma
+ * já consumida é permitido e não desfaz nada — só registra a decisão, para o
+ * caso em que alguém descobre depois que não deveria ter autorizado.
+ */
+async function revokeRunAuthorization(tx, input) {
+    const rows = await tx `
+    UPDATE fiscal_run_authorization SET
+      revoked_at = now(), revoked_by = ${input.revokedBy},
+      revoke_reason = ${input.reason}, updated_at = now()
+    WHERE id = ${input.authorizationId} AND revoked_at IS NULL
+    RETURNING id
+  `;
+    return rows.count > 0;
+}
+/** As autorizações de um cliente, mais recentes primeiro. Sem segredo por construção. */
+async function listRunAuthorizations(tx, clientId) {
+    const rows = await tx `
+    SELECT ${tx.unsafe(AUTHORIZATION_COLUMNS)}
+      FROM fiscal_run_authorization
+     WHERE client_id = ${clientId}
+     ORDER BY authorized_at DESC
+     LIMIT 50
+  `;
+    return rows.map(mapAuthorization);
+}
+const AUTHORIZATION_COLUMNS = `
+  id, client_id, document_type, environment, source, credential_kind, operation,
+  competence_year, competence_month, period_start, period_end, max_runs, runs_consumed,
+  authorized_by, authorized_at, responsible_name, expires_at, consumed_at,
+  revoked_at, revoke_reason, first_contact, trigger_kind, credential_fingerprint
+`;
+function mapAuthorization(r) {
+    return {
+        id: r.id,
+        clientId: r.client_id,
+        documentType: r.document_type,
+        environment: r.environment,
+        source: r.source,
+        credentialKind: r.credential_kind,
+        operation: 'READ_ONLY',
+        competence: {
+            year: r.competence_year,
+            month: r.competence_month,
+            label: `${r.competence_year}-${String(r.competence_month).padStart(2, '0')}`,
+            periodStart: isoDate(r.period_start),
+            periodEnd: isoDate(r.period_end),
+        },
+        maxRuns: r.max_runs,
+        runsConsumed: r.runs_consumed,
+        authorizedBy: r.authorized_by,
+        authorizedAt: r.authorized_at.toISOString(),
+        responsibleName: r.responsible_name,
+        firstContact: r.first_contact ?? false,
+        triggerKind: r.trigger_kind ?? 'manual',
+        credentialFingerprint: r.credential_fingerprint ?? null,
+        expiresAt: r.expires_at.toISOString(),
+        consumedAt: r.consumed_at?.toISOString() ?? null,
+        revokedAt: r.revoked_at?.toISOString() ?? null,
+        revokeReason: r.revoke_reason,
+        state: stateOf(r),
+    };
+}
+/**
+ * A ordem das perguntas importa: revogada vence consumida, que vence vencida.
+ *
+ * Uma autorização consumida e depois revogada deve aparecer como revogada — é a
+ * decisão mais recente, e é a que alguém precisa ver ao investigar.
+ */
+function stateOf(r) {
+    if (r.revoked_at)
+        return 'revoked';
+    if (r.consumed_at)
+        return 'consumed';
+    if (r.expires_at.getTime() <= Date.now())
+        return 'expired';
+    return 'live';
+}
+function isoDate(d) {
+    return d.toISOString().slice(0, 10);
+}
+//# sourceMappingURL=authorization.js.map

package/dist/cjs/fiscal/collection/authorization.js.map

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

package/dist/cjs/fiscal/collection/competence.js

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * A janela da coleta — dita por extenso, nunca deduzida.
+ *
+ * ## O relato que originou este módulo
+ *
+ * A equipe do escritório chama de "dar baixa nas notas" o trabalho de, na virada
+ * do mês, entrar nos portais e recolher os documentos do período. Ao descrever
+ * esse trabalho, o relato humano trouxe exemplos de datas que não fechavam entre
+ * si — o que é absolutamente normal em conversa, e absolutamente perigoso como
+ * fonte de regra.
+ *
+ * A tentação é transformar "mês anterior" em constante. O erro que isso produz é
+ * silencioso: uma coleta rodada em 01/11 sobre uma janela que ninguém confirmou
+ * traz documentos de um período que não é o que a pessoa tinha em mente, e a
+ * ausência do que faltava só aparece no fechamento.
+ *
+ * Aqui a competência é um par ano/mês, e o período é um par de DATAS derivado
+ * dele. A sugestão padrão existe — mês calendário anterior —, mas ela é uma
+ * SUGESTÃO exibida, não um valor implícito: a tela mostra "serão consultados
+ * documentos de DD/MM/AAAA a DD/MM/AAAA" antes de qualquer execução, e as duas
+ * datas são gravadas na autorização.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_COMPETENCE_POLICY = exports.InvalidCompetenceError = void 0;
+exports.competenceOf = competenceOf;
+exports.suggestCompetenceFor = suggestCompetenceFor;
+exports.validateWindow = validateWindow;
+class InvalidCompetenceError extends Error {
+    detail;
+    constructor(detail) {
+        super(`competência inválida: ${detail}`);
+        this.detail = detail;
+        this.name = 'InvalidCompetenceError';
+    }
+}
+exports.InvalidCompetenceError = InvalidCompetenceError;
+/** A política padrão desta fase, nomeada para poder ser citada e mudada. */
+exports.DEFAULT_COMPETENCE_POLICY = 'PREVIOUS_CALENDAR_MONTH';
+/**
+ * A competência de um par ano/mês.
+ *
+ * O último dia sai do calendário: `Date.UTC(ano, mês, 0)` — com o mês em base 1
+ * — devolve o último dia daquele mês. Fevereiro bissexto sai de graça, que é o
+ * ponto de não escrever `30`.
+ */
+function competenceOf(year, month) {
+    if (!Number.isInteger(year) || year < 2000 || year > 2100) {
+        throw new InvalidCompetenceError('ano fora de 2000–2100');
+    }
+    if (!Number.isInteger(month) || month < 1 || month > 12) {
+        throw new InvalidCompetenceError('mês fora de 1–12');
+    }
+    const mm = String(month).padStart(2, '0');
+    const lastDay = new Date(Date.UTC(year, month, 0)).getUTCDate();
+    return {
+        year,
+        month,
+        label: `${year}-${mm}`,
+        periodStart: `${year}-${mm}-01`,
+        periodEnd: `${year}-${mm}-${String(lastDay).padStart(2, '0')}`,
+    };
+}
+/**
+ * A SUGESTÃO padrão para uma execução feita em `reference`: o mês calendário
+ * anterior.
+ *
+ * Chama-se `suggest` e não `default` de propósito. Uma função chamada
+ * `defaultCompetence()` acaba sendo usada como valor efetivo por quem não leu;
+ * `suggestCompetenceFor()` obriga quem chama a decidir o que fazer com a
+ * sugestão — que é exibi-la ao lado das duas datas.
+ */
+function suggestCompetenceFor(reference) {
+    const year = reference.getUTCFullYear();
+    const month = reference.getUTCMonth() + 1; // base 1
+    return month === 1 ? competenceOf(year - 1, 12) : competenceOf(year, month - 1);
+}
+/**
+ * Confere uma janela informada à mão contra a competência declarada.
+ *
+ * Permitir janela manual e conferi-la não são opostos: o operador pode querer um
+ * recorte menor dentro do mês — o que é legítimo —, mas uma janela que atravessa
+ * a competência declarada significa que um dos dois campos está errado, e gravar
+ * os dois deixaria a autorização dizendo duas coisas.
+ */
+function validateWindow(competence, periodStart, periodEnd) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(periodStart) || !/^\d{4}-\d{2}-\d{2}$/.test(periodEnd)) {
+        throw new InvalidCompetenceError('datas devem estar em YYYY-MM-DD');
+    }
+    if (periodEnd < periodStart) {
+        throw new InvalidCompetenceError('data final anterior à inicial');
+    }
+    if (periodStart < competence.periodStart || periodEnd > competence.periodEnd) {
+        throw new InvalidCompetenceError(`janela ${periodStart}..${periodEnd} sai da competência ${competence.label}`);
+    }
+}
+//# sourceMappingURL=competence.js.map

package/dist/cjs/fiscal/collection/competence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"competence.js","sourceRoot":"","sources":["../../../../src/fiscal/collection/competence.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AA8BH,oCAgBC;AAWD,oDAIC;AAUD,wCAgBC;AA1ED,MAAa,sBAAuB,SAAQ,KAAK;IAC1B;IAArB,YAAqB,MAAc;QACjC,KAAK,CAAC,yBAAyB,MAAM,EAAE,CAAC,CAAC;QADtB,WAAM,GAAN,MAAM,CAAQ;QAEjC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AALD,wDAKC;AAED,4EAA4E;AAC/D,QAAA,yBAAyB,GAAG,yBAAkC,CAAC;AAE5E;;;;;;GAMG;AACH,SAAgB,YAAY,CAAC,IAAY,EAAE,KAAa;IACtD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;QAC1D,MAAM,IAAI,sBAAsB,CAAC,uBAAuB,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QACxD,MAAM,IAAI,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;IAChE,OAAO;QACL,IAAI;QACJ,KAAK;QACL,KAAK,EAAE,GAAG,IAAI,IAAI,EAAE,EAAE;QACtB,WAAW,EAAE,GAAG,IAAI,IAAI,EAAE,KAAK;QAC/B,SAAS,EAAE,GAAG,IAAI,IAAI,EAAE,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;KAC/D,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,oBAAoB,CAAC,SAAe;IAClD,MAAM,IAAI,GAAG,SAAS,CAAC,cAAc,EAAE,CAAC;IACxC,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,SAAS;IACpD,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;AAClF,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,cAAc,CAC5B,UAA4B,EAC5B,WAAmB,EACnB,SAAiB;IAEjB,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACvF,MAAM,IAAI,sBAAsB,CAAC,iCAAiC,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,SAAS,GAAG,WAAW,EAAE,CAAC;QAC5B,MAAM,IAAI,sBAAsB,CAAC,+BAA+B,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,WAAW,GAAG,UAAU,CAAC,WAAW,IAAI,SAAS,GAAG,UAAU,CAAC,SAAS,EAAE,CAAC;QAC7E,MAAM,IAAI,sBAAsB,CAC9B,UAAU,WAAW,KAAK,SAAS,uBAAuB,UAAU,CAAC,KAAK,EAAE,CAC7E,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/cjs/fiscal/collection/first-contact.js

@@ -0,0 +1,204 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runFirstContact = runFirstContact;
+const shared_1 = require("@baruk/shared");
+const audit_js_1 = require("../../audit/audit.js");
+const model_js_1 = require("../coverage/model.js");
+const readiness_js_1 = require("../credentials/readiness.js");
+const eligibility_js_1 = require("../eligibility.js");
+const authorization_js_1 = require("./authorization.js");
+const recusa = (reason, detail) => ({
+    status: 'refused',
+    reason,
+    detail,
+});
+/**
+ * Executa o primeiro contato — ou recusa, dizendo exatamente por quê.
+ *
+ * A ordem dos portões é deliberada e vai do mais barato ao mais caro, com uma
+ * regra acima de tudo: **nada que toque credencial ou rede acontece antes de
+ * todos os portões de papel terem passado**. Um portão que fechasse depois de o
+ * cofre ter sido aberto já teria custado o que se queria evitar.
+ */
+async function runFirstContact(tx, input) {
+    const now = input.now ?? new Date();
+    // ═══ 1 · A autorização existe, e é DESTE escopo ═════════════════════════
+    const [auth] = await tx `
+    SELECT id, tenant_id, client_id, source, environment, competence_year, competence_month,
+           operation, first_contact, trigger_kind, credential_fingerprint,
+           expires_at, consumed_at, revoked_at
+      FROM fiscal_run_authorization
+     WHERE id = ${input.authorizationId}
+  `;
+    if (!auth)
+        return recusa('authorization_not_found', 'autorização inexistente');
+    // Cada binding é conferido em separado, e a recusa NOMEIA qual falhou. Um
+    // "não autorizado" genérico faria toda investigação começar do zero.
+    if (auth.tenant_id !== input.tenantId) {
+        return recusa('tenant_mismatch', 'autorização é de outra organização');
+    }
+    if (auth.client_id !== input.clientId) {
+        return recusa('client_mismatch', 'autorização é de outro cliente');
+    }
+    if (auth.source !== input.connector) {
+        return recusa('connector_mismatch', `autorização é do conector ${auth.source}`);
+    }
+    if (auth.competence_year !== input.competenceYear ||
+        auth.competence_month !== input.competenceMonth) {
+        return recusa('competence_mismatch', 'autorização é de outra competência');
+    }
+    if (!auth.first_contact) {
+        return recusa('authorization_not_first_contact', 'esta autorização não declara primeiro contato');
+    }
+    if (auth.trigger_kind !== 'manual') {
+        return recusa('authorization_scheduled_trigger', 'primeiro contato não aceita agendamento');
+    }
+    if (auth.revoked_at)
+        return recusa('authorization_revoked', 'autorização revogada');
+    if (auth.consumed_at)
+        return recusa('authorization_already_consumed', 'autorização já consumida');
+    if (auth.expires_at <= now)
+        return recusa('authorization_expired', 'autorização expirada');
+    // ═══ 2 · O escritório e o cliente disseram sim ══════════════════════════
+    //
+    // A elegibilidade é default-deny e cobre habilitação do tenant e matrícula do
+    // cliente. Ela é consultada AQUI, e não confiada à tela: a tela é uma
+    // conveniência, o portão é isto.
+    const eligibility = await (0, eligibility_js_1.evaluateFiscalEligibility)(tx, {
+        clientId: input.clientId,
+        documentType: documentTypeOf(input.connector),
+        environment: input.environment,
+    });
+    if (!eligibility.eligible) {
+        const razoes = new Set(eligibility.reasons);
+        if (razoes.has('client_not_enrolled')) {
+            return recusa('client_not_enrolled', 'cliente sem matrícula fiscal para este documento');
+        }
+        if (razoes.has('tenant_automation_disabled') || razoes.has('environment_mismatch')) {
+            return recusa('tenant_automation_disabled', 'organização sem automação fiscal habilitada');
+        }
+        // `credential_not_ready` é ESPERADO aqui — o primeiro contato existe
+        // justamente para o caso em que a credencial ainda não foi aceita. Só ele
+        // é tolerado; qualquer outro motivo continua fechando.
+        const outros = [...razoes].filter((r) => r !== 'credential_not_ready' && r !== 'real_operation_not_declared');
+        if (outros.length > 0) {
+            return recusa('client_not_enrolled', `inelegível: ${outros.join(', ')}`);
+        }
+    }
+    // ═══ 3 · O conector existe DE VERDADE ══════════════════════════════════
+    //
+    // Aqui mora a correção da leitura que a C2 encontrou: cobertura oficial é
+    // fato do mundo; adaptador implementado é fato do repositório. Autorizar
+    // contra um conector inexistente falharia adiante com um erro de sistema, e a
+    // tela culparia o certificado.
+    const coverage = await (0, model_js_1.coverageForClient)(tx, {
+        clientId: input.clientId,
+        documentType: documentTypeOf(input.connector),
+    });
+    if (!coverage.connectorImplemented) {
+        return recusa('connector_not_implemented', 'este conector ainda não existe no produto');
+    }
+    if (!coverage.protocolVerified) {
+        return recusa('protocol_not_verified', 'o contrato do provedor não foi conferido');
+    }
+    if (!input.realTransportEnabled) {
+        return recusa('real_transport_disabled', 'transporte real desabilitado para este conector');
+    }
+    // ═══ 4 · A credencial: local válida, e ainda não aceita ═════════════════
+    const credential = await (0, readiness_js_1.readFiscalCredentialReadiness)(tx, {
+        clientId: input.clientId,
+        environment: input.environment,
+        source: input.connector,
+    });
+    if (credential.state === 'READY') {
+        // Já aceita: não há primeiro contato a fazer, e insistir gastaria uma
+        // requisição autenticada para descobrir o que já se sabe.
+        return recusa('credential_already_verified', 'esta credencial já foi aceita pelo ambiente');
+    }
+    if (!credential.eligibleForFirstContact) {
+        return recusa('credential_not_local_valid', `credencial em estado ${credential.state}`);
+    }
+    // O material aprovado é o material que vai. Trocar o certificado depois de
+    // autorizar invalida a autorização — quem assinou aprovou UM arquivo.
+    if (auth.credential_fingerprint && auth.credential_fingerprint !== credential.fingerprint) {
+        return recusa('credential_fingerprint_mismatch', 'o certificado mudou depois desta autorização');
+    }
+    // ═══ 5 · A reivindicação — e o banco decide quem ganha ══════════════════
+    //
+    // O `UPDATE ... WHERE consumed_at IS NULL` de `consumeRunAuthorization` é o
+    // que torna a execução única sob concorrência. Dois processos chegando juntos
+    // aqui: um recebe a linha, o outro recebe `null`. Nenhum `if` em TypeScript
+    // consegue essa garantia.
+    const runId = (0, shared_1.uuidv7)();
+    const claimed = await (0, authorization_js_1.consumeRunAuthorization)(tx, {
+        authorizationId: input.authorizationId,
+        runId,
+    });
+    if (!claimed) {
+        return recusa('claim_lost', 'outra execução reivindicou esta autorização primeiro');
+    }
+    // ═══ 6 · Só agora se fala com o provedor ═══════════════════════════════
+    let probe;
+    try {
+        probe = await input.probe();
+    }
+    catch {
+        // Exceção do transporte não atravessa: a mensagem de um cliente HTTP cita a
+        // URL, e URL de provedor carrega credencial.
+        probe = { accepted: false, failureCode: 'transport' };
+    }
+    // O registro do desfecho.
+    //
+    // `CASE` em vez de montar SQL condicional: um fragmento interpolado no meio
+    // de um `SET` é o tipo de construção que funciona no teste e produz sintaxe
+    // inválida no primeiro campo a mais.
+    //
+    // E a tentativa é registrada nos DOIS desfechos — "tentou e o ambiente
+    // recusou" e "nunca tentou" pedem coisas opostas de quem opera, e sem esta
+    // coluna eram indistinguíveis.
+    const falha = probe.accepted ? null : (probe.failureCode ?? 'unknown');
+    await tx `
+    UPDATE digital_certificate
+       SET remote_verification_last_attempt_at = ${now},
+           last_verification_error = ${falha},
+           verified_at = CASE WHEN ${probe.accepted} THEN ${now} ELSE verified_at END,
+           verified_by = CASE WHEN ${probe.accepted} THEN ${input.actorId}::uuid ELSE verified_by END,
+           remote_verification_provider =
+             CASE WHEN ${probe.accepted} THEN ${input.connector} ELSE remote_verification_provider END,
+           updated_at = now()
+     WHERE client_id = ${input.clientId}
+       AND deleted_at IS NULL
+       AND local_validated_at IS NOT NULL
+       -- O certificado EXATO que foi aprovado. Sem isto, um cliente com dois
+       -- certificados teria os dois marcados por uma execução que usou um só.
+       AND (${credential.fingerprint}::text IS NULL OR fingerprint_sha256 = ${credential.fingerprint})
+  `;
+    await (0, audit_js_1.appendAudit)(tx, {
+        actorId: input.actorId,
+        action: probe.accepted ? 'fiscal_first_contact_accepted' : 'fiscal_first_contact_refused',
+        resourceType: 'fiscal_run_authorization',
+        resourceId: input.authorizationId,
+        metadata: {
+            runId,
+            connector: input.connector,
+            environment: input.environment,
+            competence: `${input.competenceYear}-${String(input.competenceMonth).padStart(2, '0')}`,
+            documentCount: probe.documentCount ?? 0,
+            // Classe, nunca mensagem. E nenhum conteúdo fiscal.
+            failureCode: probe.accepted ? null : (probe.failureCode ?? 'unknown'),
+            cursor: probe.cursor ?? null,
+        },
+    });
+    return {
+        status: 'executed',
+        runId,
+        authorization: claimed,
+        remoteVerified: probe.accepted,
+        documentCount: probe.documentCount ?? 0,
+    };
+}
+/** O tipo de documento que um conector atende. */
+function documentTypeOf(connector) {
+    return connector === 'nfse_adn' ? 'nfse' : 'nfe';
+}
+//# sourceMappingURL=first-contact.js.map

package/dist/cjs/fiscal/collection/first-contact.js.map

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

package/dist/cjs/fiscal/collection/plan.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCollectionPlan = buildCollectionPlan;
+const model_js_1 = require("../coverage/model.js");
+const readiness_js_1 = require("../credentials/readiness.js");
+const eligibility_js_1 = require("../eligibility.js");
+const competence_js_1 = require("./competence.js");
+const authorization_js_1 = require("./authorization.js");
+/**
+ * O conector de cada tipo de documento.
+ *
+ * Municipal e estadual são conectores SEPARADOS — foi o que o discovery desta
+ * fase confirmou, e é o que impede o erro de tratar "dar baixa nas notas" como
+ * uma coisa só. A NFS-e do município vem pelo ADN nacional (que é quem recebe o
+ * compartilhamento das prefeituras); a NF-e de entrada vem pela distribuição da
+ * SEFAZ. Mesmo certificado, protocolos distintos, cursores distintos.
+ */
+const CONNECTOR_BY_TYPE = {
+    nfse: 'nfse_adn',
+    nfe: 'sefaz_dfe',
+    cte: 'sefaz_dfe',
+    nfce: 'sefaz_dfe',
+};
+async function buildCollectionPlan(tx, input) {
+    const now = input.now ?? new Date();
+    const suggested = (0, competence_js_1.suggestCompetenceFor)(now);
+    const competence = input.competenceYear !== undefined && input.competenceMonth !== undefined
+        ? (0, competence_js_1.competenceOf)(input.competenceYear, input.competenceMonth)
+        : suggested;
+    const types = input.documentTypes ?? ['nfse', 'nfe'];
+    const authorizations = await (0, authorization_js_1.listRunAuthorizations)(tx, input.clientId);
+    const entries = [];
+    for (const documentType of types) {
+        const connector = CONNECTOR_BY_TYPE[documentType];
+        const coverage = await (0, model_js_1.coverageForClient)(tx, { clientId: input.clientId, documentType });
+        const credential = await (0, readiness_js_1.readFiscalCredentialReadiness)(tx, {
+            clientId: input.clientId,
+            environment: input.environment,
+            source: connector,
+        });
+        const eligibility = await (0, eligibility_js_1.evaluateFiscalEligibility)(tx, {
+            clientId: input.clientId,
+            documentType,
+            environment: input.environment,
+        });
+        const blockers = [];
+        if (!coverage.jurisdictionKnown)
+            blockers.push('jurisdiction_unknown');
+        if (coverage.coverageStatus === 'UNKNOWN')
+            blockers.push('coverage_unknown');
+        if (coverage.coverageStatus === 'UNSUPPORTED')
+            blockers.push('coverage_unsupported');
+        // A cobertura diz que o CAMINHO existe. Que ele já tenha respondido a este
+        // produto é outra afirmação, e ela mora em `verified_at` — vazio aqui
+        // significa que o conector nunca foi exercido, e o plano tem de dizer isso
+        // em vez de mostrar "conectado" por causa de um certificado salvo.
+        if (coverage.officialApiAvailable !== 'yes')
+            blockers.push('connector_not_verified');
+        // Cada camada com o seu nome. Fundir as três num "não está pronto" foi o que
+        // mandou o operador procurar no certificado um defeito de implementação.
+        if (!coverage.connectorImplemented)
+            blockers.push('connector_not_implemented');
+        else if (!coverage.protocolVerified)
+            blockers.push('protocol_not_verified');
+        // A credencial válida SÓ localmente não é mais um bloqueio absoluto: ela é
+        // exatamente o estado que o primeiro contato existe para atravessar. O que
+        // continua bloqueando é o cron — e este plano descreve a prova controlada,
+        // que é manual por definição.
+        if (!credential.usableByWorker && !credential.eligibleForFirstContact) {
+            blockers.push('credential_not_ready');
+        }
+        const motivos = new Set(eligibility.reasons);
+        if (motivos.has('client_not_enrolled'))
+            blockers.push('client_not_enrolled');
+        if (motivos.has('tenant_automation_disabled') || motivos.has('environment_mismatch')) {
+            blockers.push('tenant_automation_disabled');
+        }
+        // `credential_not_ready` da elegibilidade é esperado enquanto o aceite
+        // remoto não existir, e já está representado acima com a distinção certa.
+        const outros = [...motivos].filter((r) => r !== 'client_not_enrolled' &&
+            r !== 'tenant_automation_disabled' &&
+            r !== 'environment_mismatch' &&
+            r !== 'credential_not_ready' &&
+            r !== 'real_operation_not_declared');
+        if (outros.length > 0)
+            blockers.push('not_eligible');
+        const live = authorizations.find((a) => a.state === 'live' &&
+            a.source === connector &&
+            a.environment === input.environment &&
+            a.competence.year === competence.year &&
+            a.competence.month === competence.month);
+        entries.push({
+            documentType,
+            connector,
+            jurisdictionScope: coverage.jurisdictionScope,
+            jurisdictionCode: coverage.jurisdictionCode,
+            coverage,
+            credentialState: credential.state,
+            credentialKind: credential.kind,
+            /** O material abre aqui? Independente de algum ambiente já tê-lo aceito. */
+            credentialLocalValid: credential.localValid,
+            /** Esta prova, se autorizada, seria o primeiro contato com o ambiente. */
+            firstContact: credential.eligibleForFirstContact,
+            connectorImplemented: coverage.connectorImplemented,
+            protocolVerified: coverage.protocolVerified,
+            operation: 'READ_ONLY',
+            executionMode: 'manual',
+            blockers,
+            readyForControlledTest: blockers.length === 0,
+            authorization: live ?? null,
+        });
+    }
+    return {
+        clientId: input.clientId,
+        competence,
+        suggestedCompetence: suggested,
+        environment: input.environment,
+        entries,
+        readyForControlledTest: entries.length > 0 && entries.every((e) => e.readyForControlledTest),
+    };
+}
+//# sourceMappingURL=plan.js.map

package/dist/cjs/fiscal/collection/plan.js.map

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