@baruk/core 0.3.1 → 0.5.0

package/dist/cjs/collection/communication-bridge.js

@@ -0,0 +1,140 @@
+"use strict";
+/**
+ * A régua da SC como CONSUMIDORA do motor compartilhado.
+ *
+ * Esta é a fronteira do adendo §14, e ela cai deste lado: tudo aqui é regra da
+ * SC — quais eventos existem, quais variáveis a cobrança expõe, como o texto do
+ * escritório vira conteúdo de cada canal. Nada disto entra em
+ * `communication/`, porque no dia em que a Dental for o segundo consumidor o
+ * motor não pode ter aprendido contabilidade.
+ *
+ * O caminho inverso também vale: nenhuma linha deste arquivo sabe o que é Meta,
+ * Resend ou Twilio.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SC_PRODUCT = void 0;
+exports.collectionEventType = collectionEventType;
+exports.collectionContext = collectionContext;
+exports.collectionVariables = collectionVariables;
+exports.buildCollectionContent = buildCollectionContent;
+const email_layout_js_1 = require("./email-layout.js");
+const format_js_1 = require("./format.js");
+/** Slug do produto no ecossistema. Estável — entra em toda chave de idempotência. */
+exports.SC_PRODUCT = 'sc-organizacao-contabil';
+/**
+ * Evento de negócio a partir da etapa da régua.
+ *
+ * Deriva de `stepKey` (`D-3`, `D0`, `D+7`), que é o identificador que o tenant
+ * configura e que já garante a idempotência do agendamento. Assim o vocabulário
+ * de evento acompanha a régua do escritório em vez de ser uma segunda lista que
+ * alguém precisa lembrar de atualizar junto.
+ */
+function collectionEventType(stepKey) {
+    const slug = stepKey
+        .toLowerCase()
+        .replace(/\+/g, 'plus')
+        .replace(/-/g, 'minus')
+        .replace(/[^a-z0-9]+/g, '_')
+        .replace(/^_+|_+$/g, '');
+    return `billing.dunning.${slug || 'step'}`;
+}
+/** Contexto da SC para um tenant. A marca é a do próprio escritório. */
+function collectionContext(tenantId, brand) {
+    return { tenantId, product: exports.SC_PRODUCT, brand };
+}
+/**
+ * Variáveis expostas à camada de template, por NOME.
+ *
+ * O motor as reordena conforme o template declara — a ordem posicional que o
+ * WhatsApp exige é resolvida lá, não aqui. Amarrar a ordem neste ponto faria
+ * cada template novo do escritório exigir mudança de código.
+ */
+function collectionVariables(input) {
+    const vars = {
+        clientName: input.clientName,
+        officeName: input.officeName,
+        amount: (0, format_js_1.formatBRL)(input.outstandingAmount),
+        dueDate: (0, format_js_1.formatDateBR)(input.dueDate),
+        reference: input.reference ?? '',
+    };
+    // Só entra quando existe. Uma variável vazia num template de WhatsApp faz a
+    // Meta recusar a mensagem inteira — melhor o template não pedir o campo do que
+    // o campo chegar em branco.
+    if (input.paymentUrl)
+        vars.paymentUrl = input.paymentUrl;
+    return vars;
+}
+/**
+ * Constrói o conteúdo do canal escolhido — **depois** de o canal ser escolhido.
+ *
+ * É aqui que o gap G1 da auditoria se fecha. A abstração anterior
+ * (`collection/channel.ts`) exigia `subject` + `html` no payload: um adapter de
+ * WhatsApp receberia HTML renderizado e teria de desmontá-lo em texto. Agora o
+ * e-mail é renderizado só quando o canal é e-mail, e o WhatsApp recebe o que o
+ * WhatsApp aceita — template aprovado com variáveis posicionais.
+ */
+function buildCollectionContent(input) {
+    return (channel, template, ordered, variables) => {
+        if (channel === 'email') {
+            return {
+                kind: 'email',
+                subject: template.subject ?? input.subject,
+                html: (0, email_layout_js_1.renderCollectionEmail)(input.branding, input.block),
+                text: (0, email_layout_js_1.renderCollectionText)(input.branding, input.block),
+            };
+        }
+        if (channel === 'whatsapp') {
+            // Sem template registrado no provider não há envio ativo possível: fora da
+            // janela de 24h o WhatsApp só aceita template aprovado. Devolver texto
+            // livre aqui produziria uma recusa do provider que pareceria falha do
+            // destinatário.
+            if (!template.providerTemplateName)
+                return null;
+            return {
+                kind: 'whatsapp_template',
+                templateName: template.providerTemplateName,
+                language: template.locale,
+                variables: ordered,
+            };
+        }
+        if (channel === 'sms' || channel === 'notification') {
+            const body = template.body
+                ? renderPlain(template.body, variables)
+                : plainFromBlock(input.block);
+            return { kind: 'text', body };
+        }
+        return null;
+    };
+}
+/**
+ * Substituição por ALLOWLIST das variáveis fornecidas — `{{x}}` só resolve se
+ * `x` existir. Qualquer outra coisa fica literal e visível.
+ *
+ * Mesma regra do `template.ts` da cobrança, e pela mesma razão: o texto vem de
+ * configuração de tenant, e interpolação livre sobre dado editável pelo usuário
+ * é execução arbitrária. Falha à vista é melhor que falha silenciosa.
+ */
+function renderPlain(text, vars) {
+    return text.replace(/\{\{\s*([a-zA-Z][a-zA-Z0-9]*)\s*\}\}/g, (whole, name) => Object.prototype.hasOwnProperty.call(vars, name) ? vars[name] : whole);
+}
+/**
+ * Texto curto a partir do conteúdo estruturado, quando o tenant não configurou
+ * corpo próprio.
+ *
+ * Deliberadamente enxuto: em SMS cada segmento é cobrado, e o corpo de um e-mail
+ * de cobrança inteiro custaria cinco. Leva a saudação, o essencial do valor e o
+ * link de pagamento quando existe — que é o que faz o cliente agir.
+ */
+function plainFromBlock(block) {
+    const parts = [block.greeting];
+    if (block.highlight) {
+        parts.push(`${block.highlight.label}: ${block.highlight.amount} (${block.highlight.dueValue}).`);
+    }
+    else if (block.paragraphs[0]) {
+        parts.push(block.paragraphs[0]);
+    }
+    if (block.payment?.url)
+        parts.push(block.payment.url);
+    return parts.join(' ');
+}
+//# sourceMappingURL=communication-bridge.js.map

package/dist/cjs/collection/communication-bridge.js.map

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

package/dist/cjs/collection/communication-runtime.js

@@ -0,0 +1,256 @@
+"use strict";
+/**
+ * Montagem ÚNICA do consumo do motor compartilhado pela cobrança da SC.
+ *
+ * Este arquivo existe por causa de um defeito de arquitetura, não de código: até
+ * aqui havia dois caminhos capazes de mandar mensagem ao cliente.
+ *
+ *   `collection-cron.ts`      montava o motor compartilhado — mas SÓ quando o
+ *                             escritório tinha conta de WhatsApp ou SMS. Sem
+ *                             elas, caía no adapter legado.
+ *   `routes/collections.ts`   montava o adapter legado SEMPRE. A rota manual
+ *                             nunca passou pelo motor compartilhado.
+ *
+ * Dois caminhos com duas idempotências diferentes: o legado usava
+ * `receivableId:stepKey` e não gravava nada, o compartilhado usava a chave
+ * composta pelo motor. Um cron e um clique no botão "rodar agora", no mesmo
+ * minuto, não se enxergavam — e a proteção de cada um era invisível para o
+ * outro. É o `LEGACY_SHARED_COEXISTENCE=BLOCKING` do certificador.
+ *
+ * A correção é ter UM lugar que monta o consumo, e ambos chamarem este. Não é
+ * organização de código: é o que faz "existe uma única autoridade de envio" ser
+ * uma propriedade verificável em vez de uma intenção.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SC_PRODUCT = exports.SC_SUPPORTED_CHANNELS = exports.TENANT_EMAIL_CREDENTIAL_NAME = void 0;
+exports.brandKeyFor = brandKeyFor;
+exports.resolveTenantEmailCredentialRef = resolveTenantEmailCredentialRef;
+exports.buildCollectionCommunication = buildCollectionCommunication;
+exports.environmentCredentialResolver = environmentCredentialResolver;
+const clearance_store_js_1 = require("./clearance-store.js");
+const index_js_1 = require("../communication/index.js");
+const channel_accounts_js_1 = require("./channel-accounts.js");
+const communication_bridge_js_1 = require("./communication-bridge.js");
+Object.defineProperty(exports, "SC_PRODUCT", { enumerable: true, get: function () { return communication_bridge_js_1.SC_PRODUCT; } });
+const consent_repository_js_1 = require("./consent-repository.js");
+const template_catalog_js_1 = require("./template-catalog.js");
+/**
+ * Slug estável da marca do escritório, para o contexto do motor.
+ *
+ * Vive aqui, e não no cron, porque entra na chave de idempotência: duas
+ * derivações do mesmo nome produziriam duas chaves para o mesmo aviso, e a
+ * proteção contra envio duplo evaporaria entre o cron e a rota manual sem que
+ * nada parecesse errado.
+ */
+function brandKeyFor(branding) {
+    const slug = branding.officeName
+        .toLowerCase()
+        .normalize('NFD')
+        .replace(/[\u0300-\u036f]/g, '')
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 60);
+    // Nome que não produz slug válido cai num valor fixo do produto, em vez de
+    // fazer o motor recusar o contexto e a régua inteira parar por causa de um
+    // nome de escritório com caracteres incomuns.
+    return /^[a-z][a-z0-9-]*[a-z0-9]$/.test(slug) ? slug : 'baruk-office';
+}
+/**
+ * Nome canônico da credencial de e-mail no cofre do escritório.
+ *
+ * Um nome só, igual para todos os tenants — o que muda é DE QUEM é o cofre. Um
+ * nome por tenant faria a resolução depender de convenção, e convenção é o que
+ * ninguém confere no dia do incidente.
+ */
+exports.TENANT_EMAIL_CREDENTIAL_NAME = 'resend-api-key';
+/**
+ * Referência de credencial de e-mail: cofre do tenant quando existe, plataforma
+ * quando não.
+ *
+ * ## O problema que isto resolve (P0-C)
+ *
+ * Nenhum escritório tinha conta de e-mail própria configurada, então todos
+ * caíam no fallback de plataforma — cujo `credentialRef` é o nome de uma
+ * variável de ambiente do processo. Dois escritórios mandavam pela MESMA conta
+ * do provedor: bloqueio e reputação atingem os dois juntos, e o histórico de
+ * envio no provedor mistura clientes de escritórios diferentes.
+ *
+ * Não era vazamento de segredo — o cofre sempre foi isolado por RLS, e nenhum
+ * tenant lê a credencial do outro. Era ausência de isolamento de CONTA.
+ *
+ * ## Por que ler o cofre aqui, e não exigir configuração
+ *
+ * A SC já tem `resend-api-key` no cofre desde a rotação de agosto; o caminho de
+ * e-mail é que não a consumia. Preferir o cofre quando ele existe corrige a SC
+ * hoje, sem pedir nada a ninguém, e faz todo tenant novo nascer isolado assim
+ * que grava a própria chave.
+ *
+ * Só o NOME é consultado — `reveal` não é chamado aqui. O segredo continua
+ * sendo materializado uma única vez, na borda do adapter.
+ */
+async function resolveTenantEmailCredentialRef(tx, platformRef) {
+    const rows = await tx `
+    SELECT count(*)::int AS n
+      FROM vault_credential
+     WHERE lower(name) = ${exports.TENANT_EMAIL_CREDENTIAL_NAME}
+       AND deleted_at IS NULL
+       AND (expires_at IS NULL OR expires_at > now())
+  `;
+    // A consulta roda sob RLS: só enxerga o cofre do tenant do contexto. Não é
+    // preciso filtrar por `tenant_id` aqui, e filtrar daria a impressão errada de
+    // que o isolamento vem do WHERE.
+    return (rows[0]?.n ?? 0) > 0
+        ? { ref: `vault://${exports.TENANT_EMAIL_CREDENTIAL_NAME}`, origin: 'tenant-vault' }
+        : { ref: platformRef, origin: 'platform-fallback' };
+}
+/**
+ * Monta o consumo do motor para UM tenant.
+ *
+ * Devolve sempre — nunca `undefined`. O desenho anterior devolvia `undefined`
+ * quando não havia canal de telefone configurado, e era isso que empurrava o
+ * e-mail de volta para o caminho legado. O e-mail é UM canal entre outros; se
+ * ele fosse o caso especial, todo canal novo teria de imitá-lo.
+ */
+async function buildCollectionCommunication(options) {
+    const { db, tx, tenantId, branding } = options;
+    const brand = brandKeyFor(branding);
+    const ctx = (0, communication_bridge_js_1.collectionContext)(tenantId, brand);
+    const tenantAccounts = (0, channel_accounts_js_1.createTenantChannelAccountStore)(tx);
+    /*
+     * Telefone tem registro CANÔNICO próprio: `channel_binding` (0041), escrito
+     * pelo onboarding do Embedded Signup.
+     *
+     * Antes desta composição, TODO canal era resolvido por
+     * `createTenantChannelAccountStore` — o jsonb `tenant.settings.channels`. O
+     * onboarding gravava numa tabela que ninguém lia: a tela dizia "ativo",
+     * `GET /v1/communication/channels` dizia `not_configured`, e o motor teria
+     * respondido `no_account` no primeiro envio. Canal pronto na Meta e invisível
+     * para quem despacha.
+     *
+     * É o mesmo defeito que `registerChannelBinding` teve na outra ponta — existir
+     * e não ser chamado —, agora do lado do consumo.
+     */
+    const bindingAccounts = (0, index_js_1.createPostgresChannelBindingStore)(tx);
+    // Credencial de e-mail: cofre do tenant quando existe (P0-C). Resolvido antes
+    // do fallback porque é ele que carrega o `credentialRef`.
+    const emailCredential = await resolveTenantEmailCredentialRef(tx, options.platformEmail.credentialRef);
+    const fallback = (0, channel_accounts_js_1.collectionSenderFallback)(branding, {
+        ...options.platformEmail,
+        credentialRef: emailCredential.ref,
+    });
+    /*
+     * Precedência POR CANAL, explícita — e não um `??` entre dois stores.
+     *
+     * Um fallback genérico resolveria o sintoma e esconderia a política: ninguém
+     * conseguiria dizer, lendo o código, de onde vem a conta de WhatsApp de um
+     * escritório. Aqui a resposta é uma linha do mapa.
+     *
+     *   email    → configuração do tenant + remetente de plataforma (contrato
+     *              certificado, intocado)
+     *   whatsapp → SOMENTE `channel_binding`. Sem fallback para o jsonb: aceitar
+     *              as duas fontes criaria a segunda verdade que a 0041 existe
+     *              para eliminar, e o legado sequer satisfaz
+     *              `channel_binding_phone_credential_ref_chk` (telefone exige
+     *              `vault://`).
+     *   sms      → mesma regra do WhatsApp.
+     *
+     * Canal sem rota resolve para ausente. Um canal novo entra fechado.
+     */
+    const accounts = (0, index_js_1.routeAccountsByChannel)({
+        email: (0, index_js_1.withSenderFallback)(tenantAccounts, fallback),
+        whatsapp: bindingAccounts,
+        sms: bindingAccounts,
+    });
+    const channels = {};
+    const email = await (0, index_js_1.resolveSenderProfile)(tenantAccounts, ctx, 'email', fallback);
+    if (email.ok) {
+        channels.email = (0, index_js_1.createEmailChannel)({
+            account: email.profile.account,
+            // Resolvedor preso à conta: nenhuma outra referência de credencial passa
+            // por aqui, nem por engano de código.
+            resolveCredential: (0, index_js_1.credentialResolverFor)(email.profile.account, options.resolveCredential),
+        });
+    }
+    // Telefone NUNCA tem fallback de plataforma — o motor recusa por construção,
+    // e aqui nem se oferece a opção. Sem conta própria do tenant, o canal
+    // simplesmente não existe, e o motor devolve `no_identity`, que é a verdade.
+    // Telefone consulta o store do TENANT, sem decoração: o fallback de plataforma
+    // é proibido nesses canais, e passar pelo decorado só faria o motor recusar
+    // duas vezes.
+    const whatsapp = await bindingAccounts.find(ctx, 'whatsapp');
+    if (whatsapp) {
+        channels.whatsapp = (0, index_js_1.createWhatsAppChannel)({
+            account: whatsapp,
+            resolveCredential: (0, index_js_1.credentialResolverFor)(whatsapp, options.resolveCredential),
+            liveSend: options.whatsappLiveSend === true,
+        });
+    }
+    const sms = await bindingAccounts.find(ctx, 'sms');
+    if (sms && options.smsTransport) {
+        // O SMS resolve a própria credencial DENTRO do transporte, e por isso o
+        // adapter não a recebe: o contrato de transporte é provider-agnostic e
+        // nenhum provider está contratado. Quando houver, a trava de credencial por
+        // conta entra na construção do transporte, não aqui.
+        channels.sms = (0, index_js_1.createSmsChannel)({ account: sms, transport: options.smsTransport });
+    }
+    // Sem transporte contratado, o canal fica FORA do registry. O motor devolve
+    // `channel_not_registered`, que diz a verdade — registrar um adapter sem
+    // transporte trocaria esse motivo por uma falha de entrega inexplicável.
+    return {
+        tenantId,
+        brand,
+        channels,
+        accounts,
+        templates: (0, template_catalog_js_1.createCollectionTemplateStore)(tx),
+        consent: (0, consent_repository_js_1.createConsentStore)(tx),
+        // A conferência do escritório, lida da ficha do cliente. Sem ela, importar
+        // a carteira ligaria a régua para todo mundo no primeiro cron.
+        clearance: (0, clearance_store_js_1.createClientClearanceStore)(tx),
+        // Fail-safe em todo canal de telefone: sem permissão registrada, não sai.
+        // O e-mail transacional de cobrança se apoia na relação contratual, e por
+        // isso é o único cujo indefinido é tratado como permitido.
+        consentPolicy: { onUnknown: { email: 'allow', whatsapp: 'fail_safe', sms: 'fail_safe' } },
+        claims: (0, index_js_1.createPostgresDispatchClaimStore)(db, tenantId),
+        audit: (0, index_js_1.createPostgresAuditSink)(tx, tenantId),
+        emailSenderOrigin: email.ok ? email.profile.origin : null,
+        // De onde veio a CREDENCIAL (não o remetente): `tenant-vault` significa
+        // conta própria do escritório; `platform-fallback` significa conta
+        // compartilhada — a dívida que o P0-C deixa medível em vez de silenciosa.
+        emailCredentialOrigin: emailCredential.origin,
+        dryRun: options.dryRun,
+    };
+}
+/**
+ * Referência lógica → segredo, a partir do ambiente do processo.
+ *
+ * O que o tenant configura é o NOME (`RESEND_API_KEY`, `vault://.../whatsapp`);
+ * o valor vem daqui e não atravessa o domínio. A allowlist por FORMA do nome
+ * (maiúsculas, dígitos e `_`) impede que um `credentialRef` colado no jsonb de
+ * configuração de tenant leia qualquer coisa do ambiente do processo — o jsonb é
+ * editável por quem administra o escritório, e `PATH` ou `DATABASE_URL` também
+ * são variáveis de ambiente.
+ */
+function environmentCredentialResolver() {
+    // `WHATSAPP_ACCESS_TOKEN` e `SMS_API_KEY` SAÍRAM desta lista na Fase L.
+    //
+    // Nenhum tenant os usava — não há canal de telefone configurado em lugar
+    // nenhum do ecossistema —, então a remoção não interrompe nada. O que ela
+    // impede é o desfecho que a lista tornava inevitável no dia em que o SEGUNDO
+    // tenant ligasse WhatsApp: ou os dois apontam para o mesmo nome e compartilham
+    // o token, ou apontam para nomes distintos e nenhum resolve. Num canal em que
+    // o bloqueio se propaga de uma marca para as outras, a primeira opção é a pior
+    // das duas — e era a que "funcionava".
+    //
+    // `RESEND_API_KEY` fica porque a SC entrega e-mail em produção por ela hoje.
+    const ALLOWED = new Set(['RESEND_API_KEY']);
+    return async (ref) => {
+        const name = ref.split('/').pop() ?? '';
+        // Allowlist de NOMES, não de forma. Filtrar por padrão deixaria `DATABASE_URL`
+        // passar inteiro — o defeito que a política de segredos deste repositório
+        // descreve explicitamente.
+        return ALLOWED.has(name) ? process.env[name] : undefined;
+    };
+}
+/** Canais que este produto sabe operar. Consultado por tela e por teste. */
+exports.SC_SUPPORTED_CHANNELS = ['email', 'whatsapp', 'sms'];
+//# sourceMappingURL=communication-runtime.js.map

package/dist/cjs/collection/communication-runtime.js.map

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

package/dist/cjs/collection/consent-repository.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * Permissão de contato do cliente — leitura e escrita.
+ *
+ * Sobre `client_channel_consent` (migration 0038). A ausência de linha NÃO é
+ * permissão: é ausência de decisão, e quem decide o que fazer com ela é a
+ * política do tenant, não esta camada.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConsentStore = createConsentStore;
+exports.listClientConsent = listClientConsent;
+exports.recordConsent = recordConsent;
+const shared_1 = require("@baruk/shared");
+function toRecord(row) {
+    return {
+        channel: row.channel,
+        state: row.state,
+        source: row.source,
+        decidedAt: row.decided_at instanceof Date ? row.decided_at.toISOString() : String(row.decided_at),
+    };
+}
+function createConsentStore(tx) {
+    return {
+        async find(recipientRef, channel) {
+            const rows = await tx `
+        SELECT channel, state, source, decided_at
+          FROM client_channel_consent
+         WHERE client_id = ${recipientRef} AND channel = ${channel}
+         LIMIT 1
+      `;
+            const row = rows[0];
+            return row ? toRecord(row) : null;
+        },
+    };
+}
+/** Todas as decisões de um cliente — para a ficha dele na tela. */
+async function listClientConsent(tx, clientId) {
+    const rows = await tx `
+    SELECT channel, state, source, decided_at
+      FROM client_channel_consent
+     WHERE client_id = ${clientId}
+     ORDER BY channel
+  `;
+    return rows.map(toRecord);
+}
+/**
+ * Registra a decisão. Uma linha viva por (cliente, canal).
+ *
+ * **Um opt-out do próprio cliente não é revertido por operador.** Quando a linha
+ * existente veio de `customer_reply` com `denied`, só outra manifestação do
+ * cliente a muda: alguém no escritório desmarcando isso na tela — por engano, ou
+ * porque "o cliente disse que pode" — é exatamente o caminho pelo qual uma
+ * régua automática passa por cima de um pedido de silêncio.
+ */
+async function recordConsent(tx, input) {
+    const existing = await tx `
+    SELECT channel, state, source, decided_at
+      FROM client_channel_consent
+     WHERE client_id = ${input.clientId} AND channel = ${input.channel}
+     LIMIT 1
+  `;
+    const current = existing[0];
+    const lockedByCustomer = current?.state === 'denied' && current.source === 'customer_reply';
+    if (lockedByCustomer && input.source !== 'customer_reply') {
+        return toRecord(current);
+    }
+    const rows = await tx `
+    INSERT INTO client_channel_consent
+      (id, tenant_id, client_id, channel, state, source, note, decided_at, decided_by)
+    VALUES
+      (${(0, shared_1.uuidv7)()}, ${input.tenantId}, ${input.clientId}, ${input.channel},
+       ${input.state}, ${input.source}, ${input.note ?? null}, now(), ${input.decidedBy ?? null})
+    ON CONFLICT (tenant_id, client_id, channel) DO UPDATE
+       SET state = EXCLUDED.state,
+           source = EXCLUDED.source,
+           note = EXCLUDED.note,
+           decided_at = now(),
+           decided_by = EXCLUDED.decided_by,
+           updated_at = now()
+    RETURNING channel, state, source, decided_at
+  `;
+    return toRecord(rows[0]);
+}
+//# sourceMappingURL=consent-repository.js.map

package/dist/cjs/collection/consent-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent-repository.js","sourceRoot":"","sources":["../../../src/collection/consent-repository.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AA6BH,gDAaC;AAGD,8CAQC;AAqBD,sCAgCC;AAhGD,0CAAuC;AASvC,SAAS,QAAQ,CAAC,GAAQ;IACxB,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,OAAqB;QAClC,KAAK,EAAE,GAAG,CAAC,KAAqB;QAChC,MAAM,EAAE,GAAG,CAAC,MAAuB;QACnC,SAAS,EACP,GAAG,CAAC,UAAU,YAAY,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;KACzF,CAAC;AACJ,CAAC;AAED,SAAgB,kBAAkB,CAAC,EAAM;IACvC,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,YAAoB,EAAE,OAAmB;YAClD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAO;;;6BAGL,YAAY,kBAAkB,OAAO;;OAE3D,CAAC;YACF,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,OAAO,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,mEAAmE;AAC5D,KAAK,UAAU,iBAAiB,CAAC,EAAM,EAAE,QAAgB;IAC9D,MAAM,IAAI,GAAG,MAAM,EAAE,CAAO;;;yBAGL,QAAQ;;GAE9B,CAAC;IACF,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC5B,CAAC;AAYD;;;;;;;;GAQG;AACI,KAAK,UAAU,aAAa,CAAC,EAAM,EAAE,KAAyB;IACnE,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAO;;;yBAGT,KAAK,CAAC,QAAQ,kBAAkB,KAAK,CAAC,OAAO;;GAEnE,CAAC;IAEF,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC5B,MAAM,gBAAgB,GAAG,OAAO,EAAE,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,gBAAgB,CAAC;IAE5F,IAAI,gBAAgB,IAAI,KAAK,CAAC,MAAM,KAAK,gBAAgB,EAAE,CAAC;QAC1D,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,EAAE,CAAO;;;;SAIrB,IAAA,eAAM,GAAE,KAAK,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,OAAO;SAChE,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,IAAI,IAAI,YAAY,KAAK,CAAC,SAAS,IAAI,IAAI;;;;;;;;;GAS5F,CAAC;IAEF,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;AAC5B,CAAC"}

package/dist/cjs/collection/copy.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderCopy = renderCopy;
+const format_js_1 = require("./format.js");
+/** Frase que identifica a dívida sem inventar dado que não existe. */
+function referenceSentence(ctx) {
+    const ref = (0, format_js_1.describeReference)({ competence: ctx.competence, description: ctx.description });
+    return ref ? `Referente a ${ref}.` : null;
+}
+/**
+ * Quando houve pagamento parcial, o texto precisa dizer isso.
+ *
+ * Mandar "o valor de X está em aberto" para quem já pagou metade soa como se o
+ * pagamento não tivesse sido registrado — e é a mensagem que mais gera ligação
+ * irritada para o escritório.
+ */
+function partialSentence(ctx) {
+    if (!ctx.hasPartialPayment)
+        return null;
+    return (`Registramos o pagamento parcial de ${(0, format_js_1.formatBRL)(ctx.originalAmount - ctx.outstandingAmount)}. ` +
+        `O saldo restante é de ${(0, format_js_1.formatBRL)(ctx.outstandingAmount)}.`);
+}
+/**
+ * Anexa o pagamento a qualquer etapa da régua.
+ *
+ * Fica fora do `switch` de propósito: o bloco de pagamento é o mesmo em D-3, D0
+ * e D+3, e cada etapa tendo a própria cópia da regra é a forma garantida de uma
+ * delas ficar para trás — foi assim que a etapa de atraso ficaria sem botão.
+ */
+function renderCopy(tone, ctx) {
+    const rendered = renderCopyBody(tone, ctx);
+    if (!ctx.payment)
+        return rendered;
+    return { ...rendered, block: { ...rendered.block, payment: ctx.payment } };
+}
+function renderCopyBody(tone, ctx) {
+    const office = ctx.branding.officeName;
+    const amount = (0, format_js_1.formatBRL)(ctx.outstandingAmount);
+    const due = (0, format_js_1.formatDateBR)(ctx.dueDate);
+    // Razão social brasileira termina em ponto com frequência ("Ltda.", "S.A.",
+    // "ME."). Somar o nosso produziria "Olá, Padaria Exemplo Ltda.." — pequeno,
+    // mas é a primeira linha que o cliente lê.
+    const greeting = `Olá, ${ctx.clientName}${/[.!?…]$/.test(ctx.clientName.trim()) ? '' : '.'}`;
+    const ref = referenceSentence(ctx);
+    const partial = partialSentence(ctx);
+    const highlight = {
+        label: ctx.hasPartialPayment ? 'Saldo em aberto' : 'Valor',
+        amount,
+        dueLabel: tone === 'reminder' ? 'Vencimento em' : 'Vencimento:',
+        dueValue: due,
+    };
+    switch (tone) {
+        case 'reminder':
+            return {
+                subject: `Lembrete de vencimento — ${office}`,
+                block: {
+                    greeting,
+                    paragraphs: [
+                        `Passando para lembrar que você tem um valor a vencer em ${due}.`,
+                        ...(ref ? [ref] : []),
+                        ...(partial ? [partial] : []),
+                    ],
+                    highlight,
+                    closing: 'Se o pagamento já foi feito, é só desconsiderar.',
+                },
+            };
+        case 'due_notice':
+            return {
+                subject: `Seu honorário vence hoje — ${office}`,
+                block: {
+                    greeting,
+                    paragraphs: [
+                        'O valor abaixo vence hoje.',
+                        ...(ref ? [ref] : []),
+                        ...(partial ? [partial] : []),
+                    ],
+                    highlight: { ...highlight, dueLabel: 'Vence hoje,' },
+                    closing: 'Se o pagamento já foi feito, é só desconsiderar.',
+                },
+            };
+        case 'friendly_collection':
+            return {
+                subject: `Pendência em aberto — ${office}`,
+                block: {
+                    greeting,
+                    paragraphs: [
+                        `Identificamos um valor em aberto, com vencimento em ${due}${ctx.daysOverdue > 0 ? ` — ${(0, format_js_1.formatOverdue)(ctx.daysOverdue)}` : ''}.`,
+                        ...(ref ? [ref] : []),
+                        ...(partial ? [partial] : []),
+                        'Se já tiver pago, avise-nos para darmos baixa. Se preferir, estamos à disposição para combinar a melhor forma.',
+                    ],
+                    highlight,
+                },
+            };
+        case 'overdue_collection':
+            return {
+                subject: `Regularização de pendência — ${office}`,
+                block: {
+                    greeting,
+                    paragraphs: [
+                        `O valor abaixo segue em aberto desde ${due}${ctx.daysOverdue > 0 ? ` (${(0, format_js_1.formatOverdue)(ctx.daysOverdue)})` : ''}.`,
+                        ...(ref ? [ref] : []),
+                        ...(partial ? [partial] : []),
+                        'Pedimos que entre em contato para regularizarmos. Se houver qualquer dificuldade, fale conosco — encontramos a melhor alternativa juntos.',
+                    ],
+                    highlight,
+                },
+            };
+        // Interno: nunca chega ao cliente. Ver a nota em `policy.ts`.
+        case 'human_escalation':
+        default:
+            return {
+                subject: `Cobrança para acompanhamento manual — ${ctx.clientName}`,
+                block: {
+                    greeting: 'Aviso interno.',
+                    paragraphs: [
+                        `A régua automática chegou ao fim para ${ctx.clientName}, com ${amount} em aberto desde ${due}.`,
+                        'A condução a partir daqui é humana.',
+                    ],
+                    highlight,
+                },
+            };
+    }
+}
+//# sourceMappingURL=copy.js.map

package/dist/cjs/collection/copy.js.map

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