@baruk/core 0.3.1 → 0.5.0

package/dist/collection/engine.d.ts

@@ -0,0 +1,200 @@
+import type { Tx } from '../db/client.js';
+import type { RecipientClearanceStore } from '../communication/clearance.js';
+import { type CollectionPolicy, type CollectionStep } from './policy.js';
+import type { TenantBranding } from './branding.js';
+import type { PaymentBlock } from './payment-block.js';
+import { type ChannelAccountStore, type ChannelPolicy, type ChannelRegistry as CommChannelRegistry, type CommunicationAuditSink, type ConsentPolicy, type ConsentStore, type DispatchClaimStore, type SenderOrigin, type TemplateStore } from '../communication/index.js';
+import { type CollectionActionRecord } from './repository.js';
+export interface PlanReport {
+    examined: number;
+    scheduled: number;
+    skippedAlreadyHandled: number;
+    canceledByPayment: number;
+    canceledByCancellation: number;
+}
+/**
+ * Planeja: cancela o que não deve mais sair e agenda o que a régua manda.
+ *
+ * A ordem importa. Cancelar ANTES de agendar evita a janela em que um recebível
+ * pago recebe uma etapa nova no mesmo ciclo.
+ */
+export declare function planCollections(tx: Tx, today: string, policyOverride?: CollectionPolicy): Promise<PlanReport>;
+export interface ExecuteReport {
+    attempted: number;
+    sent: number;
+    failedTemporary: number;
+    failedPermanent: number;
+    skippedNoLongerDue: number;
+    skippedNoChannel: number;
+    escalated: number;
+}
+export interface ExecuteContext {
+    /** Identidade visual e dados de contato do escritório. */
+    branding: TenantBranding;
+    /** Resolve o destinatário lógico do cliente para o canal. */
+    resolveRecipient: (clientId: string, channel: string) => Promise<string | null>;
+    /** Descrição do recebível, para identificar a dívida sem inventar dado. */
+    describeReceivable?: (receivableId: string) => Promise<string | null>;
+    /**
+     * Como pagar este recebível, se já houver cobrança emitida.
+     *
+     * Opcional, e resolvido no momento do envio — não no agendamento. Entre um e
+     * outro passam dias: a cobrança pode ter sido criada depois, cancelada, ou o
+     * escritório pode ter conectado a conta de pagamento no meio. Congelar o link
+     * no agendamento mandaria o cliente para uma cobrança que não existe mais.
+     */
+    resolvePayment?: (receivableId: string) => Promise<PaymentBlock | null>;
+    /**
+     * Entrega pelo motor compartilhado do ecossistema. **Obrigatória.**
+     *
+     * Era opcional, e o opcional era o defeito. Enquanto este campo pôde faltar,
+     * havia um segundo caminho de envio — `channels` legado, HTML pronto, e-mail
+     * direto pelo Resend — com uma idempotência PRÓPRIA (`receivableId:stepKey`,
+     * que não era gravada em lugar nenhum). O cron usava um caminho, a rota
+     * manual usava o outro, e a proteção de cada um era invisível para o outro: os
+     * dois podiam enviar a mesma etapa no mesmo minuto.
+     *
+     * Sem `?`, o compilador recusa qualquer chamador que tente enviar por fora.
+     * A montagem canônica está em `communication-runtime.ts`, e ela é a única.
+     */
+    communication: CollectionCommunication;
+}
+/**
+ * O que a régua precisa fornecer para falar com o motor compartilhado.
+ *
+ * A SC não monta o `CommunicationIntent` à mão em cada etapa: ela declara uma
+ * vez de onde vêm contas, templates e consentimento, e o adaptador abaixo faz a
+ * tradução — que é o que impede o vocabulário de cobrança de vazar para o motor
+ * e o vocabulário do motor de vazar para a régua.
+ */
+export interface CollectionCommunication {
+    tenantId: string;
+    /** Marca do escritório. Distinta do tenant: um tenant pode operar sob mais de uma. */
+    brand: string;
+    channels: CommChannelRegistry;
+    accounts: ChannelAccountStore;
+    templates: TemplateStore;
+    consent: ConsentStore;
+    consentPolicy?: ConsentPolicy;
+    /**
+     * Liberação do destinatário pelo escritório. **Obrigatória.**
+     *
+     * Distinta de `consent`: aquilo é a vontade do cliente, isto é a conferência
+     * de quem envia. Sem `?` porque a régua é justamente o caminho automático
+     * que dispara sobre a carteira inteira — o consumidor que a esquecesse
+     * ganharia de volta o comportamento que esta barreira existe para impedir.
+     */
+    clearance: RecipientClearanceStore;
+    /**
+     * Canais a tentar, por etapa. Política do ESCRITÓRIO — o motor só executa.
+     *
+     * Recebe a etapa inteira, e não só a chave, para que a régua possa decidir por
+     * tom (uma etapa `reminder` pode preferir WhatsApp; uma `overdue_collection`,
+     * e-mail com trilha). Sem isto, o canal declarado no passo é o único usado.
+     */
+    policyFor?: (step: CollectionStep) => ChannelPolicy;
+    /**
+     * Reserva atômica do direito de enviar. Substitui `alreadySent`.
+     *
+     * A consulta antiga respondia "já enviei?" e devolvia um booleano — e entre a
+     * resposta e o envio havia uma janela em que a resposta continuava valendo
+     * para todo mundo que perguntasse. A reserva não responde: ela DECIDE, uma vez
+     * só, e só um chamador ganha. Ver `communication/claim.ts`.
+     */
+    claims: DispatchClaimStore;
+    /** Trilha estruturada do motor. Ver `communication/audit.ts`. */
+    audit: CommunicationAuditSink;
+    /**
+     * De onde veio o remetente de e-mail resolvido para este tenant.
+     *
+     * Vai para a trilha do ciclo. "Saiu pelo remetente da plataforma" tem de ser
+     * uma coisa que o escritório consegue ver, e não uma linha de código.
+     */
+    emailSenderOrigin?: SenderOrigin | null;
+    /**
+     * De onde veio a CREDENCIAL de e-mail — distinto do remetente.
+     *
+     * `tenant-vault`: o escritório tem conta própria do provedor no cofre.
+     * `platform-fallback`: está mandando pela conta compartilhada da plataforma —
+     * um bloqueio ou uma queda de reputação ali atinge todos os escritórios que
+     * dependem dela ao mesmo tempo.
+     *
+     * A distinção existe para que essa dependência seja MEDÍVEL. Enquanto era só
+     * um `credentialRef` fixo no fallback, "quantos escritórios ainda dividem a
+     * mesma conta?" não tinha resposta sem ler código.
+     */
+    emailCredentialOrigin?: 'tenant-vault' | 'platform-fallback' | null;
+    /** Percorre tudo e relata, sem chamar adapter nenhum e sem reservar chave. */
+    dryRun?: boolean;
+}
+/**
+ * Executa as ações vencidas.
+ *
+ * **Revalida o estado no momento do envio.** O agendamento pode ter dias; entre
+ * ele e agora o cliente pode ter pago, o recebível pode ter sido cancelado, ou
+ * uma baixa parcial pode ter mudado o valor. Confiar no que foi agendado é como
+ * o motor manda cobrança de dívida quitada.
+ */
+export declare function executeCollections(tx: Tx, ctx: ExecuteContext, today: string, policyOverride?: CollectionPolicy): Promise<ExecuteReport>;
+export interface CollectionCycleReport extends PlanReport, ExecuteReport {
+}
+/** Ciclo completo — o que o job roda. */
+export declare function runCollectionCycle(tx: Tx, ctx: ExecuteContext, today: string): Promise<CollectionCycleReport>;
+export type { CollectionActionRecord };
+/**
+ * Desliga a régua de um recebível que acabou de ser quitado.
+ *
+ * Existe porque a baixa passou a ter dois caminhos: o job diário, que varre
+ * todos os recebíveis, e o webhook, que sabe exatamente qual foi pago. Sem esta
+ * função o webhook baixaria o valor e deixaria a comunicação agendada — o
+ * cliente pagaria e receberia a cobrança de atraso mesmo assim, que é a pior
+ * falha possível numa régua automática.
+ *
+ * Só o que ainda não saiu é cancelado. Mensagem enviada é histórico.
+ */
+export declare function cancelDunningForSettled(tx: Tx, receivableId: string): Promise<number>;
+/**
+ * Religa a régua de um recebível cuja liquidação foi anulada.
+ *
+ * Sem isto, corrigir o saldo não bastaria: `planCollections` não reagenda um
+ * passo cujo `step_key` já existe na tabela — a idempotência olha a EXISTÊNCIA
+ * da linha, não o status dela. Os passos desligados pela baixa ficariam
+ * `canceled` para sempre, e o cliente voltaria a dever sem que ninguém jamais o
+ * lembrasse. O saldo estaria certo e a cobrança nunca aconteceria.
+ *
+ * Reabre **somente** o que foi fechado POR PAGAMENTO. Um passo cancelado porque
+ * o recebível foi cancelado, ou já enviado, é história e permanece intocado —
+ * reabrir tudo faria a régua reenviar mensagem que o cliente já recebeu.
+ */
+/**
+ * Religa etapas fechadas por FALHA DE INFRAESTRUTURA, nunca por decisão humana.
+ *
+ * Existe para o resíduo do incidente C1-PROV-R1B-C2: etapas que o motor fechou
+ * como `escalated` porque o canal ficou indisponível (cofre de credenciais fora
+ * do ar). A correção em `sendViaSharedEngine` impede que isso volte a
+ * acontecer, mas não desfaz o que já foi fechado — e nada mais no domínio
+ * consegue, porque `planCollections` não reagenda um `step_key` existente e
+ * `listActions` só enxerga `scheduled`.
+ *
+ * As guardas são deliberadamente estreitas, e cada uma exclui uma classe:
+ *
+ * - `closed_reason = 'escalated'` — deixa de fora `no_contact_data`,
+ *   `opted_out`, `consent_unknown`, `paid`, `canceled`, `rule_disabled` e
+ *   `permanent_failure`. Todas são decisão de negócio e permanecem terminais.
+ * - `attempts = 0` — `markEscalated` NUNCA incrementa `attempts`, enquanto
+ *   `markSent` e `markFailed` sempre incrementam. Zero prova que nenhum adapter
+ *   chegou a tentar.
+ * - `provider_ref IS NULL` e `sent_at IS NULL` — prova que nada saiu. Uma
+ *   mensagem entregue jamais é reaberta, e o cliente nunca recebe duplicata.
+ *
+ * O `step_key` é obrigatório: recuperação é pontual e auditável, nunca
+ * "reabra tudo deste recebível".
+ *
+ * O histórico da falha NÃO é apagado. `communication_event`
+ * (`dispatch_skipped` / `no_credential`) e `communication_dispatch`
+ * (`failed_retryable`) continuam intactos — esta função move apenas o estado da
+ * régua, e `last_error` registra a origem da reabertura.
+ */
+export declare function rearmDunningAfterInfraFailure(tx: Tx, receivableId: string, stepKey: string, incidentRef: string): Promise<number>;
+export declare function rearmDunningAfterReversal(tx: Tx, receivableId: string): Promise<number>;
+//# sourceMappingURL=engine.d.ts.map

package/dist/collection/engine.d.ts.map

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

package/dist/collection/engine.js

@@ -0,0 +1,427 @@
+import { getReceivable, listReceivables, } from '../billing/ar-repository.js';
+import { dueSteps } from './policy.js';
+import { renderCopy } from './copy.js';
+import {} from './email-layout.js';
+import { dispatch, } from '../communication/index.js';
+import { buildCollectionContent, collectionContext, collectionEventType, collectionVariables, } from './communication-bridge.js';
+import { cancelPendingActions, getCollectionPolicy, handledStepKeys, listActions, markEscalated, markFailed, markSent, scheduleAction, } from './repository.js';
+/**
+ * Motor de cobrança: RECEIVABLE → EVENT → RULE → ACTION → DELIVERY → STOP.
+ *
+ * Dois passos separados de propósito:
+ *
+ *   `planCollections`  decide o que DEVE acontecer (puro em relação a I/O de
+ *                      provider — só toca o banco)
+ *   `executeCollections` faz acontecer
+ *
+ * Separar permite rodar o planejamento em dry-run e mostrar ao escritório o que
+ * sairia, antes de qualquer mensagem existir. Numa régua de cobrança isso não é
+ * luxo: a primeira execução contra uma carteira real precisa ser inspecionável.
+ */
+const MAX_ATTEMPTS = 3;
+/** Um recebível ainda merece cobrança? */
+function isCollectible(r) {
+    if (r.status === 'paid' || r.status === 'canceled')
+        return false;
+    if (r.status === 'renegotiated' || r.status === 'written_off')
+        return false;
+    // Saldo zero sem status `paid` acontece quando a soma dos pagamentos fecha o
+    // valor mas o status ainda não foi reavaliado. Cobrar aqui seria pedir dinheiro
+    // de quem já pagou — o pior erro operacional deste motor.
+    if (r.outstandingAmount <= 0)
+        return false;
+    if (!r.dueDate)
+        return false;
+    return true;
+}
+/**
+ * Planeja: cancela o que não deve mais sair e agenda o que a régua manda.
+ *
+ * A ordem importa. Cancelar ANTES de agendar evita a janela em que um recebível
+ * pago recebe uma etapa nova no mesmo ciclo.
+ */
+export async function planCollections(tx, today, policyOverride) {
+    const policy = policyOverride ?? (await getCollectionPolicy(tx));
+    const report = {
+        examined: 0,
+        scheduled: 0,
+        skippedAlreadyHandled: 0,
+        canceledByPayment: 0,
+        canceledByCancellation: 0,
+    };
+    // Tudo que não está cancelado — inclusive pago, porque é justamente o pago que
+    // precisa ter a régua interrompida.
+    const { items } = await listReceivables(tx, { limit: 200 });
+    for (const r of items) {
+        report.examined += 1;
+        if (r.status === 'paid' || r.outstandingAmount <= 0) {
+            report.canceledByPayment += await cancelPendingActions(tx, r.id, 'paid');
+            continue;
+        }
+        if (r.status === 'canceled') {
+            report.canceledByCancellation += await cancelPendingActions(tx, r.id, 'canceled');
+            continue;
+        }
+        if (!isCollectible(r))
+            continue;
+        const handled = await handledStepKeys(tx, r.id);
+        const due = dueSteps(policy, r.dueDate, today, handled);
+        // Quantas etapas a régua já cobriu para este recebível — é o que explica
+        // "por que não agendei nada" num ciclo que não criou ação nenhuma.
+        report.skippedAlreadyHandled += handled.size;
+        for (const { step, scheduledFor } of due) {
+            const action = await scheduleAction(tx, {
+                receivableId: r.id,
+                stepKey: step.key,
+                channel: step.channel,
+                template: step.templateKey,
+                scheduledFor,
+            });
+            if (action)
+                report.scheduled += 1;
+        }
+    }
+    return report;
+}
+/**
+ * Monta a cópia da etapa.
+ *
+ * Extraída para que os dois caminhos de entrega — legado e compartilhado — usem
+ * exatamente o mesmo texto. Duas montagens em paralelo divergiriam na primeira
+ * correção feita só de um lado, e o defeito apareceria como "o WhatsApp diz uma
+ * coisa e o e-mail diz outra" para o mesmo cliente, no mesmo dia.
+ */
+async function buildStepCopy(ctx, receivableId, current, step) {
+    const description = ctx.describeReceivable ? await ctx.describeReceivable(receivableId) : null;
+    const payment = (await ctx.resolvePayment?.(receivableId)) ?? undefined;
+    const { subject, block } = renderCopy(step.tone, {
+        clientName: current.clientName ?? 'cliente',
+        branding: ctx.branding,
+        // Saldo de AGORA, não o valor original: depois de uma baixa parcial,
+        // anunciar o valor cheio é cobrar duas vezes o que já entrou.
+        outstandingAmount: current.outstandingAmount,
+        originalAmount: current.amount,
+        hasPartialPayment: current.amountPaid > 0,
+        dueDate: current.dueDate,
+        competence: current.competence,
+        description,
+        daysOverdue: current.daysOverdue,
+        payment,
+    });
+    return { subject, block, payment };
+}
+const NO_ATTEMPT = {
+    sent: 0,
+    escalated: 0,
+    skippedNoChannel: 0,
+    failedPermanent: 0,
+    failedTemporary: 0,
+};
+/**
+ * Traduz uma etapa da régua em intenção de comunicação e assenta o desfecho.
+ *
+ * Tudo que é específico da SC (evento, variáveis, cópia) é montado aqui e
+ * entregue pronto ao motor; tudo que é específico de canal (identidade,
+ * consentimento, template, provider) fica lá. Nenhum dos dois lados precisa
+ * conhecer o vocabulário do outro.
+ */
+async function sendViaSharedEngine(tx, ctx, comm, action, current, step) {
+    const receivableId = action.receivableId;
+    const copy = await buildStepCopy(ctx, receivableId, current, step);
+    const result = await dispatch({
+        ctx: collectionContext(comm.tenantId, comm.brand),
+        eventType: collectionEventType(step.key),
+        subjectRef: receivableId,
+        // A permissão pertence à PESSOA, não ao número: a referência é o cliente.
+        recipientRef: current.clientId,
+        variables: collectionVariables({
+            clientName: current.clientName ?? 'cliente',
+            officeName: ctx.branding.officeName,
+            outstandingAmount: current.outstandingAmount,
+            dueDate: current.dueDate,
+            reference: current.competence ?? null,
+            paymentUrl: copy.payment?.url,
+        }),
+        // Sem política declarada, o canal do passo é o único tentado — que é
+        // exatamente o comportamento da régua hoje. Ligar fallback é decisão do
+        // escritório, nunca default do motor.
+        policy: comm.policyFor?.(step) ?? { order: [step.channel] },
+    }, {
+        channels: comm.channels,
+        accounts: comm.accounts,
+        templates: comm.templates,
+        consent: comm.consent,
+        consentPolicy: comm.consentPolicy,
+        clearance: comm.clearance,
+        resolveRecipient: (ref, channel) => ctx.resolveRecipient(ref, channel),
+        buildContent: buildCollectionContent({
+            branding: ctx.branding,
+            subject: copy.subject,
+            block: copy.block,
+        }),
+        claims: comm.claims,
+        audit: comm.audit,
+    }, { dryRun: comm.dryRun });
+    // Ensaio não escreve. Um dry-run que marca a ação como enviada não é ensaio —
+    // é a execução real com o envio removido, e cala a etapa para sempre.
+    if (comm.dryRun) {
+        return { ...NO_ATTEMPT, sent: result.delivered ? 1 : 0, notAttempted: true };
+    }
+    if (result.invalidContext) {
+        // Defeito de integração, não estado do cliente. Escala para humano em vez de
+        // fechar a etapa: ninguém deve descobrir isso só quando a dívida prescrever.
+        await markEscalated(tx, action.id);
+        return { ...NO_ATTEMPT, escalated: 1, skippedNoChannel: 1, notAttempted: true };
+    }
+    if (result.delivered) {
+        const recipient = await ctx.resolveRecipient(current.clientId, result.delivered);
+        await markSent(tx, action.id, {
+            recipientRef: recipient ?? '',
+            amount: current.outstandingAmount,
+            providerRef: result.providerRef,
+            // A reserva já é a proteção contra reenvio; esta coluna é a JUNÇÃO entre
+            // a etapa da régua e a linha de `communication_dispatch`. Sem ela, ver "o
+            // que aconteceu com esta cobrança" exigiria adivinhar a chave a partir de
+            // sete campos.
+            idempotencyKey: result.idempotencyKey,
+        });
+        return { ...NO_ATTEMPT, sent: 1 };
+    }
+    const permanentAttempt = result.attempts.find((a) => a.outcome === 'permanent');
+    /*
+     * `unavailable` entra aqui junto com `temporary`, e a distinção importa.
+     *
+     * Canal indisponível é falha de INFRAESTRUTURA — cofre fora do ar, credencial
+     * ainda não propagada, canal não registrado. Não é uma decisão sobre o
+     * cliente, e por isso não pode virar `escalated`, que no domínio significa
+     * "sai da automação e vai para a fila humana": a etapa fecharia para sempre,
+     * porque `planCollections` não reagenda um `step_key` que já existe e
+     * `listActions` só enxerga `scheduled`. Foi o que aconteceu no incidente
+     * C1-PROV-R1B-C2 — a infra voltou e as quatro cobranças continuaram mortas.
+     *
+     * Tratado como temporário, `markFailed` devolve a etapa a `scheduled` e o
+     * ciclo seguinte tenta de novo. O teto é o mesmo `MAX_ATTEMPTS` das demais
+     * falhas: uma credencial ausente de forma PERMANENTE consome as três
+     * tentativas e assenta como `permanent_failure`, em vez de reagendar em
+     * silêncio para sempre.
+     */
+    const temporaryAttempt = result.attempts.find((a) => a.outcome === 'temporary' || a.outcome === 'unavailable');
+    if (permanentAttempt || temporaryAttempt) {
+        const permanent = Boolean(permanentAttempt) || action.attempts + 1 >= MAX_ATTEMPTS;
+        await markFailed(tx, action.id, {
+            error: (permanentAttempt ?? temporaryAttempt).detail ?? 'falha de entrega',
+            permanent,
+        });
+        return permanent
+            ? { ...NO_ATTEMPT, failedPermanent: 1 }
+            : { ...NO_ATTEMPT, failedTemporary: 1 };
+    }
+    // Reserva negada: a etapa fica exatamente como está. Não é falha, não é
+    // escalonamento, e não gasta tentativa — outra execução já entregou, ou está
+    // entregando agora, e é ela quem vai assentar o desfecho.
+    if (claimRefusedIn(result.attempts)) {
+        return { ...NO_ATTEMPT, notAttempted: true };
+    }
+    // Aguardando conferência do escritório: a etapa fica INTACTA e volta no
+    // próximo ciclo.
+    //
+    // Escalar aqui seria o defeito, e o teste que o encontrou é
+    // `collection-clearance-gate`: `markEscalated` fecha a etapa, e
+    // `planCollections` não reagenda um `step_key` que já existe. A cobrança
+    // daquele dia morreria, e liberar o cliente depois não a recuperaria — a
+    // barreira teria virado perda silenciosa em vez de espera.
+    //
+    // Tratado como a reserva negada, e pela mesma lógica: nada aconteceu de
+    // errado, só ainda não é hora. Também não gasta tentativa — três dias sem
+    // alguém clicar "conferir" matariam a etapa por decurso de prazo.
+    //
+    // O escritório não fica sem saber: o pulo tem nome na trilha
+    // (`recipient_not_confirmed`), o painel conta os clientes com e-mail
+    // aguardando liberação, e o checklist de go-live tem o gate.
+    if (result.attempts.some((a) => a.skipped === 'recipient_not_confirmed')) {
+        return { ...NO_ATTEMPT, notAttempted: true };
+    }
+    // Nada foi enviado e nenhum adapter falhou: todas as portas recusaram antes.
+    // O motivo é o que diz ao escritório o que fazer — e cada um exige uma ação
+    // diferente, então nenhum deles pode virar um "não enviado" genérico.
+    const reason = closeReasonFor(result.attempts);
+    await markEscalated(tx, action.id, reason);
+    return { ...NO_ATTEMPT, escalated: 1, skippedNoChannel: 1, notAttempted: true };
+}
+function closeReasonFor(attempts) {
+    const skips = attempts.map((a) => a.skipped);
+    // Opt-out é o mais forte: se QUALQUER canal foi recusado por vontade do
+    // cliente, é isso que o escritório precisa ver — não "faltou cadastro".
+    if (skips.includes('opted_out'))
+        return 'opted_out';
+    if (skips.includes('consent_unknown'))
+        return 'consent_unknown';
+    if (skips.includes('no_recipient') || skips.includes('invalid_recipient')) {
+        return 'no_contact_data';
+    }
+    return 'escalated';
+}
+/**
+ * A etapa não saiu porque a RESERVA foi negada — ou seja, o sistema funcionou.
+ *
+ * Precisa de tratamento próprio: `already_sent` e `claim_in_flight` não são
+ * falha, não são cadastro e não são escalonamento. Marcar a ação como escalada
+ * mandaria um humano investigar um envio que ou já aconteceu, ou está
+ * acontecendo — e encheria a fila operacional de ruído justamente quando a
+ * proteção está trabalhando.
+ */
+function claimRefusedIn(attempts) {
+    return attempts.some((a) => a.skipped === 'already_sent' || a.skipped === 'claim_in_flight');
+}
+/**
+ * Executa as ações vencidas.
+ *
+ * **Revalida o estado no momento do envio.** O agendamento pode ter dias; entre
+ * ele e agora o cliente pode ter pago, o recebível pode ter sido cancelado, ou
+ * uma baixa parcial pode ter mudado o valor. Confiar no que foi agendado é como
+ * o motor manda cobrança de dívida quitada.
+ */
+export async function executeCollections(tx, ctx, today, policyOverride) {
+    const policy = policyOverride ?? (await getCollectionPolicy(tx));
+    const report = {
+        attempted: 0,
+        sent: 0,
+        failedTemporary: 0,
+        failedPermanent: 0,
+        skippedNoLongerDue: 0,
+        skippedNoChannel: 0,
+        escalated: 0,
+    };
+    const pending = await listActions(tx, { dueOnly: true, dueUntil: today, limit: 200 });
+    for (const action of pending) {
+        if (!action.receivableId)
+            continue;
+        // Estado atual, não o do agendamento. Busca pelo id — filtrar por cliente e
+        // procurar na página seria correto só enquanto a página coubesse.
+        const current = await getReceivable(tx, action.receivableId).catch(() => null);
+        if (!current || !isCollectible(current)) {
+            const reason = current?.status === 'canceled' ? 'canceled' : 'paid';
+            await cancelPendingActions(tx, action.receivableId, reason);
+            report.skippedNoLongerDue += 1;
+            continue;
+        }
+        const step = policy.steps.find((s) => s.key === action.stepKey);
+        if (!step || step.active === false) {
+            await cancelPendingActions(tx, action.receivableId, 'rule_disabled');
+            report.skippedNoLongerDue += 1;
+            continue;
+        }
+        // Escalonamento é evento interno: fecha a ação e entra na fila humana, sem
+        // mensagem ao cliente.
+        if (step.tone === 'human_escalation') {
+            await markEscalated(tx, action.id);
+            report.escalated += 1;
+            continue;
+        }
+        // Caminho ÚNICO. Não há alternativa: `ctx.communication` é obrigatório, e o
+        // registry legado de canais saiu do contexto. Enquanto existiam dois, o
+        // cron e a rota manual enviavam por vias com idempotências diferentes que
+        // não se enxergavam — `LEGACY_SHARED_COEXISTENCE=BLOCKING` na certificação.
+        report.attempted += 1;
+        const applied = await sendViaSharedEngine(tx, ctx, ctx.communication, action, current, step);
+        report.sent += applied.sent;
+        report.escalated += applied.escalated;
+        report.skippedNoChannel += applied.skippedNoChannel;
+        report.failedPermanent += applied.failedPermanent;
+        report.failedTemporary += applied.failedTemporary;
+        if (applied.notAttempted)
+            report.attempted -= 1;
+    }
+    return report;
+}
+/** Ciclo completo — o que o job roda. */
+export async function runCollectionCycle(tx, ctx, today) {
+    const policy = await getCollectionPolicy(tx);
+    const plan = await planCollections(tx, today, policy);
+    const exec = await executeCollections(tx, ctx, today, policy);
+    return { ...plan, ...exec };
+}
+/**
+ * Desliga a régua de um recebível que acabou de ser quitado.
+ *
+ * Existe porque a baixa passou a ter dois caminhos: o job diário, que varre
+ * todos os recebíveis, e o webhook, que sabe exatamente qual foi pago. Sem esta
+ * função o webhook baixaria o valor e deixaria a comunicação agendada — o
+ * cliente pagaria e receberia a cobrança de atraso mesmo assim, que é a pior
+ * falha possível numa régua automática.
+ *
+ * Só o que ainda não saiu é cancelado. Mensagem enviada é histórico.
+ */
+export async function cancelDunningForSettled(tx, receivableId) {
+    return cancelPendingActions(tx, receivableId, 'paid');
+}
+/**
+ * Religa a régua de um recebível cuja liquidação foi anulada.
+ *
+ * Sem isto, corrigir o saldo não bastaria: `planCollections` não reagenda um
+ * passo cujo `step_key` já existe na tabela — a idempotência olha a EXISTÊNCIA
+ * da linha, não o status dela. Os passos desligados pela baixa ficariam
+ * `canceled` para sempre, e o cliente voltaria a dever sem que ninguém jamais o
+ * lembrasse. O saldo estaria certo e a cobrança nunca aconteceria.
+ *
+ * Reabre **somente** o que foi fechado POR PAGAMENTO. Um passo cancelado porque
+ * o recebível foi cancelado, ou já enviado, é história e permanece intocado —
+ * reabrir tudo faria a régua reenviar mensagem que o cliente já recebeu.
+ */
+/**
+ * Religa etapas fechadas por FALHA DE INFRAESTRUTURA, nunca por decisão humana.
+ *
+ * Existe para o resíduo do incidente C1-PROV-R1B-C2: etapas que o motor fechou
+ * como `escalated` porque o canal ficou indisponível (cofre de credenciais fora
+ * do ar). A correção em `sendViaSharedEngine` impede que isso volte a
+ * acontecer, mas não desfaz o que já foi fechado — e nada mais no domínio
+ * consegue, porque `planCollections` não reagenda um `step_key` existente e
+ * `listActions` só enxerga `scheduled`.
+ *
+ * As guardas são deliberadamente estreitas, e cada uma exclui uma classe:
+ *
+ * - `closed_reason = 'escalated'` — deixa de fora `no_contact_data`,
+ *   `opted_out`, `consent_unknown`, `paid`, `canceled`, `rule_disabled` e
+ *   `permanent_failure`. Todas são decisão de negócio e permanecem terminais.
+ * - `attempts = 0` — `markEscalated` NUNCA incrementa `attempts`, enquanto
+ *   `markSent` e `markFailed` sempre incrementam. Zero prova que nenhum adapter
+ *   chegou a tentar.
+ * - `provider_ref IS NULL` e `sent_at IS NULL` — prova que nada saiu. Uma
+ *   mensagem entregue jamais é reaberta, e o cliente nunca recebe duplicata.
+ *
+ * O `step_key` é obrigatório: recuperação é pontual e auditável, nunca
+ * "reabra tudo deste recebível".
+ *
+ * O histórico da falha NÃO é apagado. `communication_event`
+ * (`dispatch_skipped` / `no_credential`) e `communication_dispatch`
+ * (`failed_retryable`) continuam intactos — esta função move apenas o estado da
+ * régua, e `last_error` registra a origem da reabertura.
+ */
+export async function rearmDunningAfterInfraFailure(tx, receivableId, stepKey, incidentRef) {
+    const rows = await tx `
+    UPDATE dunning_event
+       SET status = 'scheduled', closed_at = NULL, closed_reason = NULL,
+           last_error = ${`infra_failure_recovery:${incidentRef}`.slice(0, 300)}
+     WHERE receivable_id = ${receivableId}
+       AND step_key = ${stepKey}
+       AND status = 'escalated'
+       AND closed_reason = 'escalated'
+       AND attempts = 0
+       AND provider_ref IS NULL
+       AND sent_at IS NULL
+    RETURNING id
+  `;
+    return rows.length;
+}
+export async function rearmDunningAfterReversal(tx, receivableId) {
+    const rows = await tx `
+    UPDATE dunning_event
+       SET status = 'scheduled', closed_at = NULL, closed_reason = NULL
+     WHERE receivable_id = ${receivableId}
+       AND status = 'canceled'
+       AND closed_reason = 'paid'
+    RETURNING id
+  `;
+    return rows.length;
+}
+//# sourceMappingURL=engine.js.map

package/dist/collection/engine.js.map

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