@baruk/core 0.3.0 → 0.4.2

package/dist/collection/engine.js

@@ -0,0 +1,407 @@
+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,
+        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 };
+    }
+    // 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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"}

package/dist/collection/format.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Apresentação para o cliente final.
+ *
+ * O armazenamento continua canônico — `date` ISO no banco, `numeric(14,2)` no
+ * valor. Isto aqui é só a camada de leitura humana: um contribuinte brasileiro
+ * lê "15/08/2026", não "2026-08-15", e converter no ponto de exibição evita
+ * mexer no dado por causa de idioma.
+ */
+/** `2026-08-15` → `15/08/2026`. Entrada inválida volta como veio. */
+export declare function formatDateBR(iso: string | null | undefined): string;
+/**
+ * Valor monetário em pt-BR.
+ *
+ * `Intl` normalmente devolve espaço não separável entre "R$" e o número, o que
+ * costuma virar caractere estranho em cliente de e-mail antigo. Montamos o
+ * texto à mão para garantir "R$ 1.234,56" em qualquer leitor.
+ */
+export declare function formatBRL(value: number): string;
+/** Dias de atraso em linguagem natural. */
+export declare function formatOverdue(days: number): string;
+/**
+ * Como a dívida é identificada para o cliente.
+ *
+ * "Referência: serviço avulso" não diz nada a quem recebe. Com competência,
+ * dizemos o mês; sem ela, usamos a descrição do que foi contratado. Nada é
+ * inventado — se não houver nem uma nem outra, o campo simplesmente não aparece.
+ */
+export declare function describeReference(input: {
+    competence?: string | null;
+    description?: string | null;
+}): string | null;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/collection/format.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAInE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED,2CAA2C;AAC3C,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,GAAG,MAAM,GAAG,IAAI,CAwBhB"}

package/dist/collection/format.js

@@ -0,0 +1,70 @@
+/**
+ * Apresentação para o cliente final.
+ *
+ * O armazenamento continua canônico — `date` ISO no banco, `numeric(14,2)` no
+ * valor. Isto aqui é só a camada de leitura humana: um contribuinte brasileiro
+ * lê "15/08/2026", não "2026-08-15", e converter no ponto de exibição evita
+ * mexer no dado por causa de idioma.
+ */
+/** `2026-08-15` → `15/08/2026`. Entrada inválida volta como veio. */
+export function formatDateBR(iso) {
+    if (!iso)
+        return '—';
+    const m = /^(\d{4})-(\d{2})-(\d{2})/.exec(iso);
+    return m ? `${m[3]}/${m[2]}/${m[1]}` : iso;
+}
+/**
+ * Valor monetário em pt-BR.
+ *
+ * `Intl` normalmente devolve espaço não separável entre "R$" e o número, o que
+ * costuma virar caractere estranho em cliente de e-mail antigo. Montamos o
+ * texto à mão para garantir "R$ 1.234,56" em qualquer leitor.
+ */
+export function formatBRL(value) {
+    const fixed = Math.abs(value).toFixed(2);
+    const [int, dec] = fixed.split('.');
+    const withThousands = int.replace(/\B(?=(\d{3})+(?!\d))/g, '.');
+    return `${value < 0 ? '-' : ''}R$ ${withThousands},${dec}`;
+}
+/** Dias de atraso em linguagem natural. */
+export function formatOverdue(days) {
+    if (days <= 0)
+        return '';
+    if (days === 1)
+        return 'há 1 dia';
+    return `há ${days} dias`;
+}
+/**
+ * Como a dívida é identificada para o cliente.
+ *
+ * "Referência: serviço avulso" não diz nada a quem recebe. Com competência,
+ * dizemos o mês; sem ela, usamos a descrição do que foi contratado. Nada é
+ * inventado — se não houver nem uma nem outra, o campo simplesmente não aparece.
+ */
+export function describeReference(input) {
+    if (input.competence) {
+        const m = /^(\d{4})-(\d{2})$/.exec(input.competence);
+        if (m) {
+            const meses = [
+                'janeiro',
+                'fevereiro',
+                'março',
+                'abril',
+                'maio',
+                'junho',
+                'julho',
+                'agosto',
+                'setembro',
+                'outubro',
+                'novembro',
+                'dezembro',
+            ];
+            const idx = Number(m[2]) - 1;
+            if (idx >= 0 && idx < 12)
+                return `honorários de ${meses[idx]} de ${m[1]}`;
+        }
+        return `competência ${input.competence}`;
+    }
+    return input.description?.trim() || null;
+}
+//# sourceMappingURL=format.js.map

package/dist/collection/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/collection/format.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qEAAqE;AACrE,MAAM,UAAU,YAAY,CAAC,GAA8B;IACzD,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC;IACrB,MAAM,CAAC,GAAG,0BAA0B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAqB,CAAC;IACxD,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;IAChE,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,aAAa,IAAI,GAAG,EAAE,CAAC;AAC7D,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,IAAI,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACzB,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IAClC,OAAO,MAAM,IAAI,OAAO,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAGjC;IACC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACrD,IAAI,CAAC,EAAE,CAAC;YACN,MAAM,KAAK,GAAG;gBACZ,SAAS;gBACT,WAAW;gBACX,OAAO;gBACP,OAAO;gBACP,MAAM;gBACN,OAAO;gBACP,OAAO;gBACP,QAAQ;gBACR,UAAU;gBACV,SAAS;gBACT,UAAU;gBACV,UAAU;aACX,CAAC;YACF,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,EAAE;gBAAE,OAAO,iBAAiB,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,CAAC;QACD,OAAO,eAAe,KAAK,CAAC,UAAU,EAAE,CAAC;IAC3C,CAAC;IACD,OAAO,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC;AAC3C,CAAC"}

package/dist/collection/payment-block.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Como o cliente paga — a verdade financeira que qualquer canal entrega.
+ *
+ * Mora aqui, e não no layout do e-mail, porque não é assunto do e-mail. O
+ * mesmo bloco alimenta WhatsApp, portal ou qualquer canal futuro: o motor de
+ * cobrança resolve o pagamento uma vez por recebível (`resolvePayment`), e cada
+ * canal decide como apresentar.
+ *
+ * A separação importa na prática: um canal que precisasse importar de
+ * `email-layout.ts` acabaria herdando decisões de renderização de e-mail — e a
+ * primeira regra de negócio duplicada dentro do canal seria a próxima.
+ *
+ * Tudo opcional porque cada gateway (e cada método) entrega um subconjunto
+ * diferente. Quem renderiza mostra o que veio; nada é inventado para preencher.
+ */
+export interface PaymentBlock {
+    /** Destino do CTA. Sem ele não há botão: um "Pagar agora" que não paga é pior que nada. */
+    url?: string;
+    pixPayload?: string;
+    pixQrCodeImage?: string;
+    boletoUrl?: string;
+    identificationField?: string;
+}
+//# sourceMappingURL=payment-block.d.ts.map

package/dist/collection/payment-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-block.d.ts","sourceRoot":"","sources":["../../src/collection/payment-block.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,YAAY;IAC3B,2FAA2F;IAC3F,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B"}

package/dist/collection/payment-block.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=payment-block.js.map

package/dist/collection/payment-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-block.js","sourceRoot":"","sources":["../../src/collection/payment-block.ts"],"names":[],"mappings":""}

package/dist/collection/policy.d.ts

@@ -0,0 +1,53 @@
+import type { CollectionChannelKey } from './channel.js';
+/**
+ * Política de cobrança do escritório.
+ *
+ * Os offsets são RELATIVOS ao vencimento e vivem em `dunning_rule.steps` (jsonb,
+ * por tenant) — nenhum dia está no código. O padrão abaixo é ponto de partida
+ * para quem ainda não configurou nada, jamais política imposta.
+ */
+export type StepTiming = 'before_due' | 'on_due_date' | 'after_due';
+/** Tom da etapa. Governa o template, e serve de guarda contra escalada indevida. */
+export type StepTone = 'reminder' | 'due_notice' | 'friendly_collection' | 'overdue_collection' | 'human_escalation';
+export interface CollectionStep {
+    /** Chave estável — é o que garante idempotência. Mudar isto reexecuta a etapa. */
+    key: string;
+    timing: StepTiming;
+    /** Dias de distância do vencimento. Sempre positivo; `timing` dá o sinal. */
+    offsetDays: number;
+    channel: CollectionChannelKey;
+    tone: StepTone;
+    templateKey: string;
+    active?: boolean;
+}
+export interface CollectionPolicy {
+    id: string | null;
+    name: string;
+    steps: CollectionStep[];
+    active: boolean;
+}
+/**
+ * Régua padrão — sugestão, não regra do produto.
+ *
+ * Para a última etapa o canal é `notification`: escalar para humano é um evento
+ * INTERNO. Mandar ao cliente uma mensagem dizendo que o caso foi escalado seria
+ * transformar procedimento interno em pressão, e é exatamente onde cobrança
+ * automatizada vira problema jurídico e de relacionamento.
+ */
+export declare const DEFAULT_COLLECTION_STEPS: readonly CollectionStep[];
+export declare const DEFAULT_POLICY: CollectionPolicy;
+/** Data em que a etapa deve acontecer, dado o vencimento. */
+export declare function scheduledDateFor(step: CollectionStep, dueDate: string): string;
+/**
+ * Etapas já devidas em `today` e ainda não registradas.
+ *
+ * Pura e determinística: recebe o que já foi executado e devolve o que falta.
+ * Nenhum I/O — é o que permite testar a régua inteira sem banco nem provider.
+ */
+export declare function dueSteps(policy: CollectionPolicy, dueDate: string, today: string, alreadyHandled: ReadonlySet<string>): {
+    step: CollectionStep;
+    scheduledFor: string;
+}[];
+/** Validação de política vinda do banco — protege contra jsonb malformado. */
+export declare function parsePolicySteps(raw: unknown): CollectionStep[];
+//# sourceMappingURL=policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/collection/policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD;;;;;;GAMG;AAEH,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,aAAa,GAAG,WAAW,CAAC;AAEpE,oFAAoF;AACpF,MAAM,MAAM,QAAQ,GAClB,UAAU,GAAG,YAAY,GAAG,qBAAqB,GAAG,oBAAoB,GAAG,kBAAkB,CAAC;AAEhG,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,UAAU,CAAC;IACnB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,cAAc,EAiD7D,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,gBAK5B,CAAC;AAQF,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ9E;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,GAClC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,EAAE,CAQlD;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,EAAE,CAuC/D"}