@baruk/core 0.3.1 → 0.5.0

package/dist/collection/repository.js

@@ -0,0 +1,246 @@
+import { uuidv7 } from '@baruk/shared';
+import { DEFAULT_POLICY, parsePolicySteps } from './policy.js';
+const iso = (d) => (d ? d.toISOString().slice(0, 10) : null);
+function mapAction(r) {
+    return {
+        id: r.id,
+        receivableId: r.receivable_id,
+        clientId: r.client_id,
+        clientName: r.client_name,
+        stepKey: r.step_key,
+        channel: r.channel,
+        template: r.template,
+        status: r.status,
+        scheduledFor: iso(r.scheduled_for),
+        attempts: r.attempts,
+        lastError: r.last_error,
+        sentAt: r.sent_at?.toISOString() ?? null,
+        closedAt: r.closed_at?.toISOString() ?? null,
+        closedReason: r.closed_reason,
+        recipientRef: r.recipient_ref,
+        amountAtSend: r.amount_at_send === null ? null : Number(r.amount_at_send),
+        createdAt: r.created_at.toISOString(),
+    };
+}
+const SELECT_ACTION = `
+  SELECT d.id, d.receivable_id, r.client_id, c.display_name AS client_name, d.step_key,
+         d.channel, d.template, d.status, d.scheduled_for, d.attempts, d.last_error,
+         d.sent_at, d.closed_at, d.closed_reason, d.recipient_ref, d.amount_at_send, d.created_at
+    FROM dunning_event d
+    LEFT JOIN receivable r ON r.id = d.receivable_id
+    LEFT JOIN client c ON c.id = r.client_id AND c.deleted_at IS NULL`;
+// ── Política ────────────────────────────────────────────────────────────────
+/** Política ativa do tenant; cai no padrão do produto quando não há nenhuma. */
+export async function getCollectionPolicy(tx) {
+    const rows = await tx `
+    SELECT id, name, steps, active FROM dunning_rule
+     WHERE active AND is_default
+     ORDER BY created_at LIMIT 1
+  `;
+    const row = rows[0];
+    if (!row)
+        return DEFAULT_POLICY;
+    const steps = parsePolicySteps(row.steps);
+    // Política cadastrada mas ilegível não pode virar "sem cobrança nenhuma"
+    // silenciosamente: melhor cair no padrão e deixar a régua rodando.
+    if (steps.length === 0)
+        return { ...DEFAULT_POLICY, id: row.id, name: row.name };
+    return { id: row.id, name: row.name, steps, active: row.active };
+}
+export async function upsertCollectionPolicy(tx, input) {
+    const steps = parsePolicySteps(input.steps);
+    const existing = await tx `
+    SELECT id FROM dunning_rule WHERE is_default LIMIT 1
+  `;
+    if (existing[0]) {
+        await tx `
+      UPDATE dunning_rule
+         SET name = ${input.name}, steps = ${tx.json(steps)},
+             active = ${input.active ?? true}, updated_at = now()
+       WHERE id = ${existing[0].id}
+    `;
+    }
+    else {
+        await tx `
+      INSERT INTO dunning_rule (id, tenant_id, name, steps, active, is_default)
+      VALUES (${uuidv7()},
+              (NULLIF(current_setting('app.current_tenant', true), ''))::uuid,
+              ${input.name}, ${tx.json(steps)}, ${input.active ?? true}, true)
+    `;
+    }
+    return getCollectionPolicy(tx);
+}
+// ── Ações ───────────────────────────────────────────────────────────────────
+/**
+ * Agenda uma etapa. Idempotente pelo índice único parcial
+ * `(tenant, receivable, step_key)` — o `ON CONFLICT DO NOTHING` é o que
+ * transforma job repetido, retry, restart de worker e webhook duplicado em
+ * uma única ação lógica.
+ */
+export async function scheduleAction(tx, input) {
+    const rows = await tx `
+    INSERT INTO dunning_event (id, tenant_id, receivable_id, step_key, channel, template,
+                               status, scheduled_for)
+    VALUES (${uuidv7()},
+            (NULLIF(current_setting('app.current_tenant', true), ''))::uuid,
+            ${input.receivableId}, ${input.stepKey}, ${input.channel}, ${input.template},
+            'scheduled', ${input.scheduledFor})
+    ON CONFLICT (tenant_id, receivable_id, step_key) WHERE receivable_id IS NOT NULL
+    DO NOTHING
+    RETURNING id
+  `;
+    if (!rows[0])
+        return null;
+    return getAction(tx, rows[0].id);
+}
+export async function getAction(tx, id) {
+    const rows = await tx `${tx.unsafe(SELECT_ACTION)} WHERE d.id = ${id}`;
+    const row = rows[0];
+    if (!row)
+        throw new Error('Ação de cobrança não encontrada');
+    return mapAction(row);
+}
+export async function listActions(tx, filter = {}) {
+    const limit = Math.min(Math.max(filter.limit ?? 100, 1), 500);
+    const rows = await tx `
+    ${tx.unsafe(SELECT_ACTION)}
+     WHERE d.receivable_id IS NOT NULL
+       ${filter.status ? tx `AND d.status = ${filter.status}` : tx ``}
+       ${filter.receivableId ? tx `AND d.receivable_id = ${filter.receivableId}` : tx ``}
+       ${filter.clientId ? tx `AND r.client_id = ${filter.clientId}` : tx ``}
+       ${filter.dueOnly
+        ? tx `AND d.status = 'scheduled' AND d.scheduled_for <= ${filter.dueUntil ?? tx `CURRENT_DATE`}`
+        : tx ``}
+     ORDER BY d.scheduled_for NULLS LAST, d.created_at
+     LIMIT ${limit}
+  `;
+    return rows.map(mapAction);
+}
+/** Etapas já registradas para um recebível — alimenta a idempotência da régua. */
+export async function handledStepKeys(tx, receivableId) {
+    const rows = await tx `
+    SELECT step_key FROM dunning_event WHERE receivable_id = ${receivableId}
+  `;
+    return new Set(rows.map((r) => r.step_key));
+}
+/**
+ * Assenta o envio.
+ *
+ * O identificador do provider vai para `provider_ref` (migration 0038). Antes
+ * ele era espremido em `template` sob COALESCE: como `scheduleAction` sempre
+ * grava o template, o id do provider era descartado em silêncio — e, se o
+ * template estivesse nulo, ocupava o lugar do nome e corrompia o relatório.
+ *
+ * Nunca deu problema porque o adapter de e-mail não devolve identificador.
+ * WhatsApp e SMS devolvem sempre, e o webhook de entrega chega trazendo APENAS
+ * esse id: sem coluna própria e indexada, todo status de entrega se perderia.
+ */
+export async function markSent(tx, id, input) {
+    await tx `
+    UPDATE dunning_event
+       SET status = 'sent', sent_at = now(), attempts = attempts + 1,
+           recipient_ref = ${input.recipientRef}, amount_at_send = ${input.amount},
+           last_error = NULL, closed_at = now(),
+           provider_ref = COALESCE(${input.providerRef ?? null}, provider_ref),
+           idempotency_key = COALESCE(${input.idempotencyKey ?? null}, idempotency_key)
+     WHERE id = ${id}
+  `;
+}
+export async function markFailed(tx, id, input) {
+    await tx `
+    UPDATE dunning_event
+       SET status = ${input.permanent ? 'failed' : 'scheduled'},
+           attempts = attempts + 1,
+           last_error = ${input.error.slice(0, 300)},
+           closed_at = ${input.permanent ? tx `now()` : null},
+           closed_reason = ${input.permanent ? 'permanent_failure' : null}
+     WHERE id = ${id}
+  `;
+}
+export async function markEscalated(tx, id, reason = 'escalated') {
+    await tx `
+    UPDATE dunning_event
+       SET status = 'escalated', closed_at = now(), closed_reason = ${reason}
+     WHERE id = ${id}
+  `;
+}
+/**
+ * Cancela ações ainda não enviadas de um recebível.
+ *
+ * Só toca `scheduled`: o que já saiu é histórico e não se apaga. Retorna quantas
+ * foram canceladas para o job poder relatar honestamente o que aconteceu.
+ */
+export async function cancelPendingActions(tx, receivableId, reason) {
+    const rows = await tx `
+    UPDATE dunning_event
+       SET status = 'canceled', closed_at = now(), closed_reason = ${reason}
+     WHERE receivable_id = ${receivableId} AND status = 'scheduled'
+    RETURNING id
+  `;
+    return rows.length;
+}
+export async function collectionMetrics(tx) {
+    const [m] = await tx `
+    SELECT
+      count(*) FILTER (WHERE status = 'scheduled')::int AS scheduled,
+      count(*) FILTER (WHERE status = 'sent')::int AS sent,
+      count(*) FILTER (WHERE status = 'failed')::int AS failed,
+      count(*) FILTER (WHERE status = 'canceled')::int AS canceled,
+      count(*) FILTER (WHERE status = 'canceled' AND closed_reason = 'paid')::int AS stopped_by_payment,
+      count(*) FILTER (WHERE status = 'escalated')::int AS escalated,
+      count(*) FILTER (WHERE closed_reason = 'no_contact_data')::int AS no_contact_data,
+      count(*) FILTER (WHERE status = 'scheduled' AND scheduled_for <= CURRENT_DATE)::int AS due_today
+      FROM dunning_event WHERE receivable_id IS NOT NULL
+  `;
+    const [p] = await tx `
+    SELECT COALESCE(sum(r.amount), 0) AS amount
+      FROM receivable r
+     WHERE r.status = 'paid'
+       AND EXISTS (SELECT 1 FROM dunning_event d
+                    WHERE d.receivable_id = r.id AND d.status = 'sent')
+  `;
+    return {
+        scheduled: m.scheduled,
+        sent: m.sent,
+        failed: m.failed,
+        canceled: m.canceled,
+        stoppedByPayment: m.stopped_by_payment,
+        escalated: m.escalated,
+        noContactData: m.no_contact_data,
+        dueToday: m.due_today,
+        amountPaidAfterCollection: Number(p.amount),
+    };
+}
+export async function clientTimeline(tx, clientId, limit = 100) {
+    const rows = await tx `
+    SELECT created_at AS at, 'receivable_created' AS kind,
+           COALESCE(competence, 'avulso') AS detail, amount, id AS receivable_id
+      FROM receivable WHERE client_id = ${clientId} AND deleted_at IS NULL
+    UNION ALL
+    SELECT p.paid_at, 'payment', p.method, p.amount, p.receivable_id
+      FROM payment p JOIN receivable r ON r.id = p.receivable_id
+     WHERE r.client_id = ${clientId} AND p.status = 'confirmed'
+    UNION ALL
+    SELECT d.sent_at, 'collection_sent', d.step_key || ' · ' || d.channel, d.amount_at_send, d.receivable_id
+      FROM dunning_event d JOIN receivable r ON r.id = d.receivable_id
+     WHERE r.client_id = ${clientId} AND d.status = 'sent' AND d.sent_at IS NOT NULL
+    UNION ALL
+    SELECT d.closed_at, 'collection_canceled', d.step_key || ' · ' || COALESCE(d.closed_reason, '-'), NULL, d.receivable_id
+      FROM dunning_event d JOIN receivable r ON r.id = d.receivable_id
+     WHERE r.client_id = ${clientId} AND d.status = 'canceled' AND d.closed_at IS NOT NULL
+    UNION ALL
+    SELECT d.closed_at, 'collection_escalated', d.step_key, NULL, d.receivable_id
+      FROM dunning_event d JOIN receivable r ON r.id = d.receivable_id
+     WHERE r.client_id = ${clientId} AND d.status = 'escalated' AND d.closed_at IS NOT NULL
+    ORDER BY at DESC
+    LIMIT ${limit}
+  `;
+    return rows.map((r) => ({
+        at: r.at.toISOString(),
+        kind: r.kind,
+        detail: r.detail,
+        amount: r.amount === null ? null : Number(r.amount),
+        receivableId: r.receivable_id,
+    }));
+}
+//# sourceMappingURL=repository.js.map

package/dist/collection/repository.js.map

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

package/dist/collection/subject.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Quem é o ASSUNTO de uma cobrança — e se existe um.
+ *
+ * ## O falso positivo que este módulo existe para matar
+ *
+ * O preflight de envio avulso respondia `eligible: true` medindo seis portas —
+ * identidade, credencial, destinatário, telefone, consentimento, template — e
+ * nenhuma delas pergunta **sobre o quê** a mensagem falaria. Um cliente sem
+ * recebível nenhum passava nas seis, e a rota de envio recusava logo depois por
+ * falta de valor e vencimento.
+ *
+ * Um preflight que aprova o que a execução recusa é pior que não ter preflight:
+ * ele desloca a descoberta do defeito para o momento do disparo, que é
+ * exatamente onde ninguém quer descobrir nada.
+ *
+ * ## Por que aqui, e não no handler
+ *
+ * "Este recebível está devido na etapa D+3 hoje?" é regra da RÉGUA. Ela já vive
+ * em `policy.ts` (`dueSteps`, `scheduledDateFor`) e em `engine.ts`
+ * (`isCollectible`), e é usada pelo ciclo automático. Reimplementar a mesma
+ * conta dentro de uma rota criaria a segunda derivação de sempre — as duas
+ * concordariam no dia da escrita e divergiriam na primeira mudança da régua,
+ * com o avulso mandando o que o ciclo não mandaria.
+ *
+ * Este módulo não decide política nova: ele **lê** a política vigente e responde
+ * quem ela alcança, sem escrever nada.
+ */
+import type { Tx } from '../db/client.js';
+import { type ReceivableWithBalance } from '../billing/ar-repository.js';
+import { type CollectionPolicy } from './policy.js';
+/**
+ * Um recebível ainda merece cobrança?
+ *
+ * Cópia deliberada da regra de `engine.ts`, que era privada. Exportar de lá e
+ * importar aqui criaria ciclo (`engine` já importa deste módulo o suficiente);
+ * a duplicação é de UMA função pequena e está coberta pelo teste de
+ * equivalência em `collection-subject.test.ts`, que exercita as duas contra os
+ * mesmos casos.
+ */
+export declare function isCollectibleSubject(r: ReceivableWithBalance): boolean;
+export interface EligibleSubjectQuery {
+    clientId: string;
+    /** Etapa da régua, como `D+3`. */
+    stepKey: string;
+    /** Data de referência, `YYYY-MM-DD`. Do chamador — o domínio não lê relógio. */
+    today: string;
+    policy?: CollectionPolicy;
+}
+/**
+ * Os recebíveis do cliente que a etapa alcança HOJE.
+ *
+ * Vazio quer dizer "não há sobre o que cobrar nesta etapa", e é um desfecho
+ * legítimo — não um erro. Cabe a quem chama transformar isso em recusa.
+ *
+ * A ordem é a mesma da régua (vencimento mais antigo primeiro), para que o
+ * avulso e o ciclo escolham o mesmo quando houver mais de um.
+ */
+export declare function findEligibleSubjects(tx: Tx, q: EligibleSubjectQuery): Promise<ReceivableWithBalance[]>;
+/**
+ * O assunto que o envio avulso usaria, ou `null`.
+ *
+ * Quando há mais de um, o mais antigo — mesma preferência da régua. Escolher o
+ * mais recente faria a dívida velha envelhecer sem cobrança.
+ */
+export declare function resolveSubjectForStep(tx: Tx, q: EligibleSubjectQuery): Promise<ReceivableWithBalance | null>;
+//# sourceMappingURL=subject.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subject.d.ts","sourceRoot":"","sources":["../../src/collection/subject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAmB,KAAK,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAC1F,OAAO,EAAY,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG9D;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAQtE;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,EAAE,EACN,CAAC,EAAE,oBAAoB,GACtB,OAAO,CAAC,qBAAqB,EAAE,CAAC,CA2BlC;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,EAAE,EACN,CAAC,EAAE,oBAAoB,GACtB,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAGvC"}

package/dist/collection/subject.js

@@ -0,0 +1,99 @@
+/**
+ * Quem é o ASSUNTO de uma cobrança — e se existe um.
+ *
+ * ## O falso positivo que este módulo existe para matar
+ *
+ * O preflight de envio avulso respondia `eligible: true` medindo seis portas —
+ * identidade, credencial, destinatário, telefone, consentimento, template — e
+ * nenhuma delas pergunta **sobre o quê** a mensagem falaria. Um cliente sem
+ * recebível nenhum passava nas seis, e a rota de envio recusava logo depois por
+ * falta de valor e vencimento.
+ *
+ * Um preflight que aprova o que a execução recusa é pior que não ter preflight:
+ * ele desloca a descoberta do defeito para o momento do disparo, que é
+ * exatamente onde ninguém quer descobrir nada.
+ *
+ * ## Por que aqui, e não no handler
+ *
+ * "Este recebível está devido na etapa D+3 hoje?" é regra da RÉGUA. Ela já vive
+ * em `policy.ts` (`dueSteps`, `scheduledDateFor`) e em `engine.ts`
+ * (`isCollectible`), e é usada pelo ciclo automático. Reimplementar a mesma
+ * conta dentro de uma rota criaria a segunda derivação de sempre — as duas
+ * concordariam no dia da escrita e divergiriam na primeira mudança da régua,
+ * com o avulso mandando o que o ciclo não mandaria.
+ *
+ * Este módulo não decide política nova: ele **lê** a política vigente e responde
+ * quem ela alcança, sem escrever nada.
+ */
+import { listReceivables } from '../billing/ar-repository.js';
+import { dueSteps } from './policy.js';
+import { getCollectionPolicy, handledStepKeys } from './repository.js';
+/**
+ * Um recebível ainda merece cobrança?
+ *
+ * Cópia deliberada da regra de `engine.ts`, que era privada. Exportar de lá e
+ * importar aqui criaria ciclo (`engine` já importa deste módulo o suficiente);
+ * a duplicação é de UMA função pequena e está coberta pelo teste de
+ * equivalência em `collection-subject.test.ts`, que exercita as duas contra os
+ * mesmos casos.
+ */
+export function isCollectibleSubject(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` é quem já pagou e o status não foi reavaliado.
+    // Cobrar aqui é o pior erro operacional deste motor.
+    if (r.outstandingAmount <= 0)
+        return false;
+    if (!r.dueDate)
+        return false;
+    return true;
+}
+/**
+ * Os recebíveis do cliente que a etapa alcança HOJE.
+ *
+ * Vazio quer dizer "não há sobre o que cobrar nesta etapa", e é um desfecho
+ * legítimo — não um erro. Cabe a quem chama transformar isso em recusa.
+ *
+ * A ordem é a mesma da régua (vencimento mais antigo primeiro), para que o
+ * avulso e o ciclo escolham o mesmo quando houver mais de um.
+ */
+export async function findEligibleSubjects(tx, q) {
+    const policy = q.policy ?? (await getCollectionPolicy(tx));
+    /*
+     * Nenhuma checagem própria de política ou de etapa aqui.
+     *
+     * A primeira versão tinha duas — "a régua está ativa" e "a etapa existe e
+     * está ativa" — e o teste de mutação derrubou as duas: removê-las não quebrava
+     * caso nenhum, porque `dueSteps` já decide exatamente isso. Guard que nenhum
+     * teste consegue distinguir não é guard: é uma segunda codificação da mesma
+     * regra, esperando para divergir da primeira.
+     *
+     * O que sobra deste módulo é o que ele de fato acrescenta: recortar por
+     * cliente, aplicar `isCollectibleSubject` e perguntar à régua. `dueSteps`
+     * continua sendo a única autoridade sobre quando uma etapa vence.
+     */
+    const { items } = await listReceivables(tx, { clientId: q.clientId, limit: 200 });
+    const elegiveis = [];
+    for (const r of items) {
+        if (!isCollectibleSubject(r))
+            continue;
+        const handled = await handledStepKeys(tx, r.id);
+        const due = dueSteps(policy, r.dueDate, q.today, handled);
+        if (due.some((d) => d.step.key === q.stepKey))
+            elegiveis.push(r);
+    }
+    return elegiveis;
+}
+/**
+ * O assunto que o envio avulso usaria, ou `null`.
+ *
+ * Quando há mais de um, o mais antigo — mesma preferência da régua. Escolher o
+ * mais recente faria a dívida velha envelhecer sem cobrança.
+ */
+export async function resolveSubjectForStep(tx, q) {
+    const todos = await findEligibleSubjects(tx, q);
+    return todos[0] ?? null;
+}
+//# sourceMappingURL=subject.js.map

package/dist/collection/subject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject.js","sourceRoot":"","sources":["../../src/collection/subject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EAAE,eAAe,EAA8B,MAAM,6BAA6B,CAAC;AAC1F,OAAO,EAAE,QAAQ,EAAyB,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvE;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,CAAwB;IAC3D,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IACjE,IAAI,CAAC,CAAC,MAAM,KAAK,cAAc,IAAI,CAAC,CAAC,MAAM,KAAK,aAAa;QAAE,OAAO,KAAK,CAAC;IAC5E,8EAA8E;IAC9E,qDAAqD;IACrD,IAAI,CAAC,CAAC,iBAAiB,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,CAAC,CAAC,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC7B,OAAO,IAAI,CAAC;AACd,CAAC;AAWD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,EAAM,EACN,CAAuB;IAEvB,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,mBAAmB,CAAC,EAAE,CAAC,CAAC,CAAC;IAE3D;;;;;;;;;;;;OAYG;IAEH,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,eAAe,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAElF,MAAM,SAAS,GAA4B,EAAE,CAAC;IAC9C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC;YAAE,SAAS;QACvC,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,OAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3D,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC;YAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,EAAM,EACN,CAAuB;IAEvB,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAChD,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC1B,CAAC"}

package/dist/collection/template-catalog.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Catálogo de templates da COBRANÇA — do produto, não do motor.
+ *
+ * O motor sabe resolver template (escopo, versão, aprovação); ele não conhece
+ * nenhum. Os textos e os nomes registrados no provider vivem aqui, ao lado da
+ * régua que os usa.
+ *
+ * O corpo dos e-mails continua vindo de `copy.ts`/`email-layout.ts`: este
+ * catálogo declara QUAL template vale para cada etapa e canal, e as variáveis
+ * que ele consome. Duplicar o texto aqui criaria duas fontes para a mesma
+ * mensagem, e a segunda ficaria para trás na primeira correção.
+ */
+import type { Tx } from '../db/client.js';
+import type { TemplateStore } from '../communication/index.js';
+export declare function createCollectionTemplateStore(tx: Tx): TemplateStore;
+//# sourceMappingURL=template-catalog.d.ts.map

package/dist/collection/template-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-catalog.d.ts","sourceRoot":"","sources":["../../src/collection/template-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,KAAK,EAA8B,aAAa,EAAE,MAAM,2BAA2B,CAAC;AA6I3F,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,EAAE,GAAG,aAAa,CAsBnE"}

package/dist/collection/template-catalog.js

@@ -0,0 +1,162 @@
+/**
+ * Catálogo de templates da COBRANÇA — do produto, não do motor.
+ *
+ * O motor sabe resolver template (escopo, versão, aprovação); ele não conhece
+ * nenhum. Os textos e os nomes registrados no provider vivem aqui, ao lado da
+ * régua que os usa.
+ *
+ * O corpo dos e-mails continua vindo de `copy.ts`/`email-layout.ts`: este
+ * catálogo declara QUAL template vale para cada etapa e canal, e as variáveis
+ * que ele consome. Duplicar o texto aqui criaria duas fontes para a mesma
+ * mensagem, e a segunda ficaria para trás na primeira correção.
+ */
+import { SC_PRODUCT } from './communication-bridge.js';
+const LOCALE = 'pt-BR';
+/**
+ * Variáveis da cobrança, na ordem em que os templates de WhatsApp as declaram.
+ *
+ * A ordem é contrato com o template aprovado no provider: `{{1}}` é o nome,
+ * `{{2}}` o valor, `{{3}}` o vencimento. Trocar a ordem aqui sem re-aprovar o
+ * template lá manda o valor no lugar do nome — e a Meta aceita, porque para ela
+ * são três strings.
+ */
+const COLLECTION_VARS = ['clientName', 'amount', 'dueDate'];
+/**
+ * Sufixo do nome REGISTRADO NO PROVIDER.
+ *
+ * Muda **somente** quando um template novo é submetido e aprovado do lado da
+ * Meta. Mexer aqui sem submeter faz o despacho pedir um nome que não existe — e
+ * a Meta responde `132001`, que fala de "translation" e manda quem investiga
+ * procurar no lugar errado.
+ */
+const PROVIDER_TEMPLATE_SUFFIX = 'v1';
+/**
+ * Revisão INTERNA do catálogo de WhatsApp. **Nunca chega ao provider.**
+ *
+ * Entra na chave de idempotência (`buildIdempotencyKey` recebe
+ * `templateVersion`), e é o único jeito legítimo de dizer "esta é outra
+ * tentativa lógica" sem tocar no template aprovado.
+ *
+ * ## Por que os dois existem separados
+ *
+ * Eram dois literais `'v1'` — um em `version`, outro dentro da interpolação de
+ * `providerTemplateName` —, independentes de fato e idênticos na aparência. A
+ * primeira pessoa que precisasse de uma chave nova bumparia o que estivesse
+ * mais à mão, e havia 50% de chance de o despacho passar a pedir
+ * `billing_dunning_dplus3_v2` à Meta, que não tem esse template.
+ *
+ * `v2` aqui porque a revisão `v1` foi consumida: em 2026-09-01 a primeira
+ * tentativa real assentou a chave como `failed_permanent`, e o motor recusa
+ * repetição sobre chave assentada — corretamente. O template aprovado continua
+ * sendo `billing_dunning_dplus3_v1`.
+ *
+ * E-mail e SMS **não** bumpam: os dois têm despacho real em produção, e mudar a
+ * versão deles reabriria chaves já assentadas de 89 avisos que já saíram.
+ */
+const WHATSAPP_CATALOG_REVISION = 'v2';
+/**
+ * E-mail: sempre disponível, porque o corpo é montado pelo produto.
+ *
+ * `approved` aqui não significa "aprovado por um provider" — e-mail não tem
+ * registro prévio. Significa "utilizável", que é o que o motor precisa saber.
+ */
+function emailTemplate(eventType) {
+    return {
+        tenantId: null,
+        product: SC_PRODUCT,
+        brand: null,
+        channel: 'email',
+        eventType,
+        locale: LOCALE,
+        version: 'v1',
+        status: 'approved',
+        variables: [...COLLECTION_VARS],
+    };
+}
+/**
+ * WhatsApp: só existe se o escritório tiver registrado o template no provider.
+ *
+ * O nome segue o evento (`billing.dunning.dplus3` → `billing_dunning_dplus3_v1`)
+ * porque é a única convenção que não exige uma segunda tabela de-para que
+ * alguém precisaria manter sincronizada com o painel da Meta.
+ *
+ * **Não é declarado aprovado por padrão.** Um template que este código afirma
+ * existir e que ninguém registrou vira recusa do provider a cada etapa da régua
+ * — e a recusa chega como falha de entrega, sugerindo problema no cliente.
+ */
+function whatsappTemplate(eventType, approved) {
+    return {
+        tenantId: null,
+        product: SC_PRODUCT,
+        brand: null,
+        channel: 'whatsapp',
+        eventType,
+        locale: LOCALE,
+        // Revisão interna — some antes da fronteira do provider.
+        version: WHATSAPP_CATALOG_REVISION,
+        status: approved ? 'approved' : 'pending_approval',
+        // Nome no provider — o sufixo é o do TEMPLATE APROVADO, não o da revisão.
+        providerTemplateName: `${eventType.replace(/\./g, '_')}_${PROVIDER_TEMPLATE_SUFFIX}`,
+        variables: [...COLLECTION_VARS],
+    };
+}
+function smsTemplate(eventType, approved) {
+    return {
+        tenantId: null,
+        product: SC_PRODUCT,
+        brand: null,
+        channel: 'sms',
+        eventType,
+        locale: LOCALE,
+        version: 'v1',
+        status: approved ? 'approved' : 'pending_approval',
+        variables: [...COLLECTION_VARS],
+        // Curto de propósito: cada segmento é cobrado, e o link é o que faz o
+        // cliente agir. Sem link, a mensagem só informa.
+        body: '{{clientName}}, consta {{amount}} com vencimento {{dueDate}}.',
+    };
+}
+/**
+ * Quais eventos o escritório tem registrados em cada canal.
+ *
+ * Vem de `tenant.settings.channels.<canal>.approvedEvents`. Ausente = nenhum, e
+ * o e-mail segue funcionando: ligar um canal novo nunca pode desligar o que já
+ * funcionava.
+ */
+// `tenant` não tem RLS — é a tabela raiz, define a fronteira em vez de ser
+// protegida por ela. Toda leitura dela exige a amarra explícita na GUC da
+// sessão; sem isso, o `tenantId` do parâmetro é a única coisa que separa um
+// escritório do outro, e um parâmetro não é uma fronteira.
+async function approvedEvents(tx, tenantId, channel) {
+    const rows = await tx `
+    SELECT settings FROM tenant
+     WHERE id = ${tenantId}
+       AND id = NULLIF(current_setting('app.current_tenant', true), '')::uuid
+     LIMIT 1
+  `;
+    const channels = (rows[0]?.settings?.channels ?? {});
+    const list = channels[channel]?.approvedEvents;
+    return new Set(Array.isArray(list) ? list.filter((v) => typeof v === 'string') : []);
+}
+export function createCollectionTemplateStore(tx) {
+    return {
+        async candidates(ctx, channel, eventType, locale) {
+            if (ctx.product !== SC_PRODUCT || locale !== LOCALE)
+                return [];
+            if (channel === 'email')
+                return [emailTemplate(eventType)];
+            if (channel === 'whatsapp') {
+                const approved = await approvedEvents(tx, ctx.tenantId, 'whatsapp');
+                return [whatsappTemplate(eventType, approved.has(eventType))];
+            }
+            if (channel === 'sms') {
+                const approved = await approvedEvents(tx, ctx.tenantId, 'sms');
+                return [smsTemplate(eventType, approved.has(eventType))];
+            }
+            // `notification` é evento interno e não passa pelo motor: a régua o
+            // resolve antes, escalando para a fila humana sem mensagem ao cliente.
+            return [];
+        },
+    };
+}
+//# sourceMappingURL=template-catalog.js.map

package/dist/collection/template-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-catalog.js","sourceRoot":"","sources":["../../src/collection/template-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,MAAM,MAAM,GAAG,OAAO,CAAC;AAEvB;;;;;;;GAOG;AACH,MAAM,eAAe,GAAG,CAAC,YAAY,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,yBAAyB,GAAG,IAAI,CAAC;AAEvC;;;;;GAKG;AACH,SAAS,aAAa,CAAC,SAAiB;IACtC,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,UAAU;QACnB,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,OAAO;QAChB,SAAS;QACT,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,UAAU;QAClB,SAAS,EAAE,CAAC,GAAG,eAAe,CAAC;KAChC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,gBAAgB,CAAC,SAAiB,EAAE,QAAiB;IAC5D,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,UAAU;QACnB,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,UAAU;QACnB,SAAS;QACT,MAAM,EAAE,MAAM;QACd,yDAAyD;QACzD,OAAO,EAAE,yBAAyB;QAClC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,kBAAkB;QAClD,0EAA0E;QAC1E,oBAAoB,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,wBAAwB,EAAE;QACpF,SAAS,EAAE,CAAC,GAAG,eAAe,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,SAAiB,EAAE,QAAiB;IACvD,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,UAAU;QACnB,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,KAAK;QACd,SAAS;QACT,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,kBAAkB;QAClD,SAAS,EAAE,CAAC,GAAG,eAAe,CAAC;QAC/B,sEAAsE;QACtE,iDAAiD;QACjD,IAAI,EAAE,+DAA+D;KACtE,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,2EAA2E;AAC3E,0EAA0E;AAC1E,4EAA4E;AAC5E,2DAA2D;AAC3D,KAAK,UAAU,cAAc,CAAC,EAAM,EAAE,QAAgB,EAAE,OAAmB;IACzE,MAAM,IAAI,GAAG,MAAM,EAAE,CAAgD;;kBAErD,QAAQ;;;GAGvB,CAAC;IACF,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,IAAI,EAAE,CAGlD,CAAC;IACF,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAC/C,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,EAAM;IAClD,OAAO;QACL,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM;YAC9C,IAAI,GAAG,CAAC,OAAO,KAAK,UAAU,IAAI,MAAM,KAAK,MAAM;gBAAE,OAAO,EAAE,CAAC;YAE/D,IAAI,OAAO,KAAK,OAAO;gBAAE,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;YAE3D,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;gBAC3B,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;gBACpE,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YAChE,CAAC;YAED,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;gBACtB,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBAC/D,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YAC3D,CAAC;YAED,oEAAoE;YACpE,uEAAuE;YACvE,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/collection/template.d.ts

@@ -0,0 +1,37 @@
+import type { StepTone } from './policy.js';
+/**
+ * Templates de cobrança.
+ *
+ * Substituição é por ALLOWLIST de variáveis, não por interpolação livre: o
+ * template vem de configuração de tenant, e um `${...}` avaliado seria execução
+ * arbitrária a partir de dado editável pelo usuário. Aqui, `{{x}}` só resolve se
+ * `x` estiver na lista; qualquer outra coisa fica literal e visível — falha à
+ * vista, nunca silenciosa.
+ */
+export interface TemplateVars {
+    clientName: string;
+    officeName: string;
+    dueDate: string;
+    outstandingAmount: string;
+    reference: string;
+}
+export declare const TEMPLATE_VARIABLES: readonly (keyof TemplateVars)[];
+export interface CollectionTemplate {
+    subject: string;
+    body: string;
+}
+/**
+ * Textos padrão por tom.
+ *
+ * Nenhum deles ameaça, cita medida judicial, negativação ou consequência legal.
+ * Cobrança automatizada que produz esse tipo de texto sem revisão humana é risco
+ * jurídico e de relacionamento — a etapa mais dura da régua padrão escala para
+ * uma pessoa em vez de escrever por conta própria.
+ */
+declare const DEFAULT_TEMPLATES: Record<string, CollectionTemplate>;
+/** Resolve o template; cai no padrão do tom quando o tenant não tem o seu. */
+export declare function resolveTemplate(templateKey: string, tone: StepTone, overrides?: Record<string, CollectionTemplate>): CollectionTemplate;
+/** Substitui `{{var}}` pelas variáveis da allowlist. O resto fica literal. */
+export declare function renderTemplate(text: string, vars: TemplateVars): string;
+export { DEFAULT_TEMPLATES };
+//# sourceMappingURL=template.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/collection/template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;;;GAQG;AAEH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,kBAAkB,EAAE,SAAS,CAAC,MAAM,YAAY,CAAC,EAM7D,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,QAAA,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAyCzD,CAAC;AAUF,8EAA8E;AAC9E,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,QAAQ,EACd,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAC7C,kBAAkB,CAMpB;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAMvE;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}