@baruk/core 0.3.0 → 0.4.2

package/dist/cjs/collection/engine.js

@@ -0,0 +1,414 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.planCollections = planCollections;
+exports.executeCollections = executeCollections;
+exports.runCollectionCycle = runCollectionCycle;
+exports.cancelDunningForSettled = cancelDunningForSettled;
+exports.rearmDunningAfterInfraFailure = rearmDunningAfterInfraFailure;
+exports.rearmDunningAfterReversal = rearmDunningAfterReversal;
+const ar_repository_js_1 = require("../billing/ar-repository.js");
+const policy_js_1 = require("./policy.js");
+const copy_js_1 = require("./copy.js");
+const index_js_1 = require("../communication/index.js");
+const communication_bridge_js_1 = require("./communication-bridge.js");
+const repository_js_1 = require("./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.
+ */
+async function planCollections(tx, today, policyOverride) {
+    const policy = policyOverride ?? (await (0, repository_js_1.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 (0, ar_repository_js_1.listReceivables)(tx, { limit: 200 });
+    for (const r of items) {
+        report.examined += 1;
+        if (r.status === 'paid' || r.outstandingAmount <= 0) {
+            report.canceledByPayment += await (0, repository_js_1.cancelPendingActions)(tx, r.id, 'paid');
+            continue;
+        }
+        if (r.status === 'canceled') {
+            report.canceledByCancellation += await (0, repository_js_1.cancelPendingActions)(tx, r.id, 'canceled');
+            continue;
+        }
+        if (!isCollectible(r))
+            continue;
+        const handled = await (0, repository_js_1.handledStepKeys)(tx, r.id);
+        const due = (0, policy_js_1.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 (0, repository_js_1.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 } = (0, copy_js_1.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 (0, index_js_1.dispatch)({
+        ctx: (0, communication_bridge_js_1.collectionContext)(comm.tenantId, comm.brand),
+        eventType: (0, communication_bridge_js_1.collectionEventType)(step.key),
+        subjectRef: receivableId,
+        // A permissão pertence à PESSOA, não ao número: a referência é o cliente.
+        recipientRef: current.clientId,
+        variables: (0, communication_bridge_js_1.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: (0, communication_bridge_js_1.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 (0, repository_js_1.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 (0, repository_js_1.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 (0, repository_js_1.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 (0, repository_js_1.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.
+ */
+async function executeCollections(tx, ctx, today, policyOverride) {
+    const policy = policyOverride ?? (await (0, repository_js_1.getCollectionPolicy)(tx));
+    const report = {
+        attempted: 0,
+        sent: 0,
+        failedTemporary: 0,
+        failedPermanent: 0,
+        skippedNoLongerDue: 0,
+        skippedNoChannel: 0,
+        escalated: 0,
+    };
+    const pending = await (0, repository_js_1.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 (0, ar_repository_js_1.getReceivable)(tx, action.receivableId).catch(() => null);
+        if (!current || !isCollectible(current)) {
+            const reason = current?.status === 'canceled' ? 'canceled' : 'paid';
+            await (0, repository_js_1.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 (0, repository_js_1.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 (0, repository_js_1.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. */
+async function runCollectionCycle(tx, ctx, today) {
+    const policy = await (0, repository_js_1.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.
+ */
+async function cancelDunningForSettled(tx, receivableId) {
+    return (0, repository_js_1.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.
+ */
+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;
+}
+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/cjs/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/cjs/collection/format.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDateBR = formatDateBR;
+exports.formatBRL = formatBRL;
+exports.formatOverdue = formatOverdue;
+exports.describeReference = describeReference;
+/** `2026-08-15` → `15/08/2026`. Entrada inválida volta como veio. */
+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.
+ */
+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. */
+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.
+ */
+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/cjs/collection/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/collection/format.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAGH,oCAIC;AASD,8BAKC;AAGD,sCAIC;AASD,8CA2BC;AA9DD,qEAAqE;AACrE,SAAgB,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,SAAgB,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,SAAgB,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,SAAgB,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/cjs/collection/payment-block.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=payment-block.js.map

package/dist/cjs/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/cjs/collection/policy.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_POLICY = exports.DEFAULT_COLLECTION_STEPS = void 0;
+exports.scheduledDateFor = scheduledDateFor;
+exports.dueSteps = dueSteps;
+exports.parsePolicySteps = parsePolicySteps;
+/**
+ * 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.
+ */
+exports.DEFAULT_COLLECTION_STEPS = [
+    {
+        key: 'D-3',
+        timing: 'before_due',
+        offsetDays: 3,
+        channel: 'email',
+        tone: 'reminder',
+        templateKey: 'collection.reminder',
+    },
+    {
+        key: 'D0',
+        timing: 'on_due_date',
+        offsetDays: 0,
+        channel: 'email',
+        tone: 'due_notice',
+        templateKey: 'collection.due',
+    },
+    {
+        key: 'D+3',
+        timing: 'after_due',
+        offsetDays: 3,
+        channel: 'email',
+        tone: 'friendly_collection',
+        templateKey: 'collection.overdue_soft',
+    },
+    {
+        key: 'D+7',
+        timing: 'after_due',
+        offsetDays: 7,
+        channel: 'email',
+        tone: 'friendly_collection',
+        templateKey: 'collection.overdue_soft',
+    },
+    {
+        key: 'D+15',
+        timing: 'after_due',
+        offsetDays: 15,
+        channel: 'email',
+        tone: 'overdue_collection',
+        templateKey: 'collection.overdue',
+    },
+    {
+        key: 'D+30',
+        timing: 'after_due',
+        offsetDays: 30,
+        channel: 'notification',
+        tone: 'human_escalation',
+        templateKey: 'collection.escalate',
+    },
+];
+exports.DEFAULT_POLICY = {
+    id: null,
+    name: 'Régua padrão',
+    steps: [...exports.DEFAULT_COLLECTION_STEPS],
+    active: true,
+};
+function addDays(isoDate, days) {
+    const d = new Date(`${isoDate}T00:00:00Z`);
+    d.setUTCDate(d.getUTCDate() + days);
+    return d.toISOString().slice(0, 10);
+}
+/** Data em que a etapa deve acontecer, dado o vencimento. */
+function scheduledDateFor(step, dueDate) {
+    const offset = step.timing === 'before_due'
+        ? -Math.abs(step.offsetDays)
+        : step.timing === 'after_due'
+            ? Math.abs(step.offsetDays)
+            : 0;
+    return addDays(dueDate, offset);
+}
+/**
+ * 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.
+ */
+function dueSteps(policy, dueDate, today, alreadyHandled) {
+    if (!policy.active)
+        return [];
+    return policy.steps
+        .filter((s) => s.active !== false)
+        .filter((s) => !alreadyHandled.has(s.key))
+        .map((step) => ({ step, scheduledFor: scheduledDateFor(step, dueDate) }))
+        .filter((s) => s.scheduledFor <= today)
+        .sort((a, b) => a.scheduledFor.localeCompare(b.scheduledFor));
+}
+/** Validação de política vinda do banco — protege contra jsonb malformado. */
+function parsePolicySteps(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const timings = ['before_due', 'on_due_date', 'after_due'];
+    const channels = ['email', 'whatsapp', 'notification'];
+    const tones = [
+        'reminder',
+        'due_notice',
+        'friendly_collection',
+        'overdue_collection',
+        'human_escalation',
+    ];
+    const seen = new Set();
+    const steps = [];
+    for (const item of raw) {
+        if (!item || typeof item !== 'object')
+            continue;
+        const s = item;
+        const key = typeof s.key === 'string' ? s.key : null;
+        // Chave duplicada arruinaria a idempotência: duas etapas com a mesma chave
+        // se anulam no `alreadyHandled` e uma delas nunca rodaria.
+        if (!key || seen.has(key))
+            continue;
+        if (!timings.includes(s.timing))
+            continue;
+        if (!channels.includes(s.channel))
+            continue;
+        if (!tones.includes(s.tone))
+            continue;
+        const offset = Number(s.offsetDays);
+        if (!Number.isInteger(offset) || offset < 0 || offset > 365)
+            continue;
+        seen.add(key);
+        steps.push({
+            key,
+            timing: s.timing,
+            offsetDays: offset,
+            channel: s.channel,
+            tone: s.tone,
+            templateKey: typeof s.templateKey === 'string' ? s.templateKey : 'collection.reminder',
+            active: s.active !== false,
+        });
+    }
+    return steps;
+}
+//# sourceMappingURL=policy.js.map