@baruk/core 0.3.1 → 0.5.0

package/dist/collection/channel-accounts.js

@@ -0,0 +1,133 @@
+/**
+ * Contas de canal do escritório, para o motor compartilhado.
+ *
+ * Moram em `tenant.settings.channels` (jsonb que já existia) — sem tabela nem
+ * migration, pela mesma razão que o branding mora lá: o Office resolve
+ * configuração de tenant por esse caminho, e um segundo mecanismo para a mesma
+ * coisa é uma divergência esperando acontecer.
+ *
+ * **Nenhum valor de credencial passa por aqui.** O que o tenant configura é o
+ * NOME lógico do segredo no cofre (`credentialRef`); quem resolve o valor é a
+ * borda do adapter, com o resolvedor que o processo injeta.
+ */
+import { SC_PRODUCT } from './communication-bridge.js';
+const STATUSES = new Set(['not_configured', 'pending_validation', 'active', 'paused', 'error']);
+function text(v, max = 200) {
+    if (typeof v !== 'string')
+        return undefined;
+    const t = v.trim();
+    return t && t.length <= max ? t : undefined;
+}
+/**
+ * Metadados sem segredo, e a checagem é por ALLOWLIST de chave.
+ *
+ * Filtrar por "o que parece segredo" deixaria passar o que não parece — e o
+ * `meta` de um canal é jsonb editável por quem configura o tenant, então
+ * qualquer coisa pode ter sido colada ali. Só o que o adapter precisa entra.
+ */
+const META_ALLOWED = new Set(['phoneNumberId', 'wabaId', 'businessId', 'region']);
+function meta(v) {
+    if (typeof v !== 'object' || v === null)
+        return undefined;
+    const out = {};
+    for (const [k, raw] of Object.entries(v)) {
+        if (!META_ALLOWED.has(k))
+            continue;
+        const value = text(raw, 120);
+        if (value)
+            out[k] = value;
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+/**
+ * Store de contas do tenant corrente.
+ *
+ * **A amarra é a GUC da sessão, não o parâmetro.**
+ *
+ * A versão anterior consultava `WHERE id = ctx.tenantId` e depois comparava
+ * `row.id !== ctx.tenantId` — uma comparação que nunca pode falhar, porque o
+ * `WHERE` já usou o mesmo valor. Ela parecia ser a tranca contra "pedir o tenant
+ * errado dentro da transação certa" e não era nenhuma tranca: bastava um
+ * chamador passar um contexto alheio para ler a configuração de canal de outro
+ * escritório, `credentialRef` inclusive.
+ *
+ * `tenant` é a tabela RAIZ e não tem RLS — ela define a fronteira, não é
+ * protegida por ela —, então a política que cobre todas as outras tabelas não
+ * cobria esta consulta. A correção é exigir que o tenant PEDIDO seja o mesmo da
+ * sessão: quem quiser ler a configuração de outro escritório precisa abrir a
+ * transação dele, que é justamente o que a fronteira significa.
+ */
+export function createTenantChannelAccountStore(tx) {
+    return {
+        async find(ctx, channel) {
+            if (ctx.product !== SC_PRODUCT)
+                return null;
+            const rows = await tx `
+        SELECT id, settings FROM tenant
+         WHERE id = ${ctx.tenantId}
+           AND id = NULLIF(current_setting('app.current_tenant', true), '')::uuid
+         LIMIT 1
+      `;
+            const row = rows[0];
+            if (!row)
+                return null;
+            const channels = (row.settings?.channels ?? {});
+            const raw = channels[channel];
+            if (!raw)
+                return null;
+            const senderId = text(raw.senderId);
+            const credentialRef = text(raw.credentialRef);
+            // Sem remetente ou sem referência de credencial não há conta utilizável.
+            // Devolver uma conta pela metade faria o motor tentar e o provider recusar,
+            // gastando uma tentativa da régua para descobrir o que já se sabia aqui.
+            if (!senderId || !credentialRef)
+                return null;
+            const status = text(raw.status);
+            return {
+                channel,
+                tenantId: ctx.tenantId,
+                product: ctx.product,
+                brand: ctx.brand,
+                senderId,
+                displayName: text(raw.displayName, 120),
+                credentialRef,
+                // Estado desconhecido nunca vira `active`: configuração que ninguém
+                // reconhece não autoriza envio.
+                status: status && STATUSES.has(status) ? status : 'not_configured',
+                meta: meta(raw.meta),
+            };
+        },
+    };
+}
+/**
+ * Fallback de plataforma da cobrança — **e-mail apenas**.
+ *
+ * Existe porque a SC já entrega e-mail em produção hoje pela chave da
+ * plataforma, e desligar isso para exigir configuração por escritório pararia a
+ * régua de quem está cobrando agora. Removê-lo não é hardening, é interrupção de
+ * serviço.
+ *
+ * O que muda em relação ao que o Codex reprovou é o que sai na mensagem: o NOME
+ * exibido passa a ser o do escritório que está cobrando, sempre. O endereço
+ * continua sendo o do domínio verificado — trocá-lo quebraria a entrega —, mas
+ * quem lê vê "SC Organização Contábil", não uma marca alheia.
+ *
+ * Nada de WhatsApp nem SMS aqui, e a proibição não é por omissão: o motor recusa
+ * fallback nesses canais por construção (`sender-profile.ts`). Um número de
+ * telefone compartilhado entre marcas é o caminho para uma marca ser bloqueada
+ * pelo comportamento de outra.
+ */
+export function collectionSenderFallback(branding, platformEmail) {
+    // O endereço vem do remetente base configurado; `senderFor` já sabe extrair só
+    // o endereço de um `Nome <end@dominio>`.
+    const address = /<([^>]+)>/.exec(platformEmail.senderId)?.[1] ?? platformEmail.senderId;
+    const displayName = branding.officeName.replace(/["<>\\]/g, '').trim() || undefined;
+    return {
+        email: {
+            senderId: address,
+            credentialRef: platformEmail.credentialRef,
+            displayNameFor: () => displayName,
+        },
+    };
+}
+//# sourceMappingURL=channel-accounts.js.map

package/dist/collection/channel-accounts.js.map

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

package/dist/collection/channel.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Vocabulário de canal da régua de cobrança.
+ *
+ * **Só o vocabulário.** Este arquivo já carregou uma abstração de canal inteira
+ * — `CollectionChannel`, `CollectionMessage`, `resolveChannel` e um adapter de
+ * e-mail — e foi por ela que a cobrança tinha um SEGUNDO caminho de envio,
+ * paralelo ao motor compartilhado, com idempotência própria que não era gravada
+ * em lugar nenhum. Cron e rota manual usavam vias diferentes e não se
+ * enxergavam.
+ *
+ * O caminho de entrega agora é um só: `communication/`. O que restou aqui é o
+ * nome do canal que a política do escritório declara por etapa, que é dado de
+ * régua e não tem nada a ver com provider.
+ */
+/**
+ * Canal declarado por etapa da régua.
+ *
+ * Subconjunto de `ChannelKey` do motor. `sms` ainda não aparece porque a régua
+ * não tem como declará-lo hoje — está registrado como dívida não bloqueante, e
+ * alargar o tipo sem alargar a validação da política gravaria passo que o motor
+ * aceita e a tela não sabe exibir.
+ */
+export type CollectionChannelKey = 'email' | 'whatsapp' | 'notification';
+//# sourceMappingURL=channel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../src/collection/channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC"}

package/dist/collection/channel.js

@@ -0,0 +1,16 @@
+/**
+ * Vocabulário de canal da régua de cobrança.
+ *
+ * **Só o vocabulário.** Este arquivo já carregou uma abstração de canal inteira
+ * — `CollectionChannel`, `CollectionMessage`, `resolveChannel` e um adapter de
+ * e-mail — e foi por ela que a cobrança tinha um SEGUNDO caminho de envio,
+ * paralelo ao motor compartilhado, com idempotência própria que não era gravada
+ * em lugar nenhum. Cron e rota manual usavam vias diferentes e não se
+ * enxergavam.
+ *
+ * O caminho de entrega agora é um só: `communication/`. O que restou aqui é o
+ * nome do canal que a política do escritório declara por etapa, que é dado de
+ * régua e não tem nada a ver com provider.
+ */
+export {};
+//# sourceMappingURL=channel.js.map

package/dist/collection/channel.js.map

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

package/dist/collection/clearance-store.d.ts

@@ -0,0 +1,39 @@
+import type { Tx } from '../db/client.js';
+import type { RecipientClearanceStore } from '../communication/clearance.js';
+/**
+ * Liberação lida da ficha do cliente.
+ *
+ * `recipientRef` é o id do cliente — a mesma referência que o consentimento e a
+ * idempotência usam. A liberação é do CLIENTE, não do canal: quem confere o
+ * cadastro confere a pessoa, e um escritório que liberou o e-mail e não o
+ * WhatsApp está descrevendo qual canal quer usar, não quem já foi conferido.
+ * Se um dia a distinção por canal for necessária, ela entra aqui sem mexer no
+ * motor.
+ */
+export declare function createClientClearanceStore(tx: Tx): RecipientClearanceStore;
+export interface ClearanceResult {
+    clientId: string;
+    cleared: boolean;
+    clearedAt: string | null;
+}
+/**
+ * Libera (ou revoga) um cliente para comunicação externa.
+ *
+ * Revogar é possível e deliberado: um endereço que voltou errado precisa poder
+ * sair da régua sem que alguém tenha de apagar o e-mail do cadastro — apagar o
+ * dado para parar o envio destrói a informação de contato junto.
+ */
+export declare function setClientClearance(tx: Tx, input: {
+    clientId: string;
+    cleared: boolean;
+    actorId: string | null;
+}): Promise<ClearanceResult>;
+export interface ClearanceSummary {
+    total: number;
+    cleared: number;
+    pending: number;
+    /** Não liberados que TÊM e-mail — os que a régua alcançaria se fosse liberada. */
+    pendingWithEmail: number;
+}
+export declare function clearanceSummary(tx: Tx): Promise<ClearanceSummary>;
+//# sourceMappingURL=clearance-store.d.ts.map

package/dist/collection/clearance-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clearance-store.d.ts","sourceRoot":"","sources":["../../src/collection/clearance-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAE1C,OAAO,KAAK,EAAsB,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAEjG;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,EAAE,GAAG,uBAAuB,CAc1E;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,EAAE,EACN,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACpE,OAAO,CAAC,eAAe,CAAC,CAgB1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiBxE"}

package/dist/collection/clearance-store.js

@@ -0,0 +1,69 @@
+/**
+ * Liberação lida da ficha do cliente.
+ *
+ * `recipientRef` é o id do cliente — a mesma referência que o consentimento e a
+ * idempotência usam. A liberação é do CLIENTE, não do canal: quem confere o
+ * cadastro confere a pessoa, e um escritório que liberou o e-mail e não o
+ * WhatsApp está descrevendo qual canal quer usar, não quem já foi conferido.
+ * Se um dia a distinção por canal for necessária, ela entra aqui sem mexer no
+ * motor.
+ */
+export function createClientClearanceStore(tx) {
+    return {
+        async find(recipientRef, _channel) {
+            const rows = await tx `
+        SELECT communication_cleared_at
+          FROM client
+         WHERE id = ${recipientRef} AND deleted_at IS NULL
+      `;
+            // Cliente inexistente ou apagado não é "liberado por omissão": é um
+            // destinatário que o sistema não conhece, e o motor deve pular.
+            const at = rows[0]?.communication_cleared_at ?? null;
+            return { cleared: at !== null, clearedAt: at?.toISOString() ?? null };
+        },
+    };
+}
+/**
+ * Libera (ou revoga) um cliente para comunicação externa.
+ *
+ * Revogar é possível e deliberado: um endereço que voltou errado precisa poder
+ * sair da régua sem que alguém tenha de apagar o e-mail do cadastro — apagar o
+ * dado para parar o envio destrói a informação de contato junto.
+ */
+export async function setClientClearance(tx, input) {
+    const rows = await tx `
+    UPDATE client
+       SET communication_cleared_at = ${input.cleared ? new Date() : null},
+           communication_cleared_by = ${input.cleared ? input.actorId : null},
+           updated_at = now()
+     WHERE id = ${input.clientId} AND deleted_at IS NULL
+    RETURNING id, communication_cleared_at
+  `;
+    const row = rows[0];
+    if (!row)
+        throw new Error('Cliente não encontrado neste escritório.');
+    return {
+        clientId: row.id,
+        cleared: row.communication_cleared_at !== null,
+        clearedAt: row.communication_cleared_at?.toISOString() ?? null,
+    };
+}
+export async function clearanceSummary(tx) {
+    const [r] = await tx `
+    SELECT count(*)::int AS total,
+           count(*) FILTER (WHERE communication_cleared_at IS NOT NULL)::int AS cleared,
+           count(*) FILTER (WHERE communication_cleared_at IS NULL
+                              AND email IS NOT NULL)::int AS pending_email
+      FROM client
+     WHERE deleted_at IS NULL AND status = 'active'
+  `;
+    const total = r?.total ?? 0;
+    const cleared = r?.cleared ?? 0;
+    return {
+        total,
+        cleared,
+        pending: total - cleared,
+        pendingWithEmail: r?.pending_email ?? 0,
+    };
+}
+//# sourceMappingURL=clearance-store.js.map

package/dist/collection/clearance-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clearance-store.js","sourceRoot":"","sources":["../../src/collection/clearance-store.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CAAC,EAAM;IAC/C,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,YAAoB,EAAE,QAAoB;YACnD,MAAM,IAAI,GAAG,MAAM,EAAE,CAA6C;;;sBAGlD,YAAY;OAC3B,CAAC;YACF,oEAAoE;YACpE,gEAAgE;YAChE,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,wBAAwB,IAAI,IAAI,CAAC;YACrD,OAAO,EAAE,OAAO,EAAE,EAAE,KAAK,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC;QACxE,CAAC;KACF,CAAC;AACJ,CAAC;AAQD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,EAAM,EACN,KAAqE;IAErE,MAAM,IAAI,GAAG,MAAM,EAAE,CAAyD;;wCAExC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;wCACjC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;;kBAE1D,KAAK,CAAC,QAAQ;;GAE7B,CAAC;IACF,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IACtE,OAAO;QACL,QAAQ,EAAE,GAAG,CAAC,EAAE;QAChB,OAAO,EAAE,GAAG,CAAC,wBAAwB,KAAK,IAAI;QAC9C,SAAS,EAAE,GAAG,CAAC,wBAAwB,EAAE,WAAW,EAAE,IAAI,IAAI;KAC/D,CAAC;AACJ,CAAC;AAUD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EAAM;IAC3C,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,CAA6D;;;;;;;GAOhF,CAAC;IACF,MAAM,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;IAC5B,MAAM,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC;IAChC,OAAO;QACL,KAAK;QACL,OAAO;QACP,OAAO,EAAE,KAAK,GAAG,OAAO;QACxB,gBAAgB,EAAE,CAAC,EAAE,aAAa,IAAI,CAAC;KACxC,CAAC;AACJ,CAAC"}

package/dist/collection/communication-bridge.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 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.
+ */
+import { type ChannelKey, type CommunicationContext, type MessageContent } from '../communication/index.js';
+import type { TenantBranding } from './branding.js';
+import type { EmailBlock } from './email-layout.js';
+/** Slug do produto no ecossistema. Estável — entra em toda chave de idempotência. */
+export declare const 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.
+ */
+export declare function collectionEventType(stepKey: string): string;
+/** Contexto da SC para um tenant. A marca é a do próprio escritório. */
+export declare function collectionContext(tenantId: string, brand: string): CommunicationContext;
+export interface CollectionVariablesInput {
+    clientName: string;
+    officeName: string;
+    outstandingAmount: number;
+    dueDate: string | null;
+    reference: string | null;
+    paymentUrl?: string;
+}
+/**
+ * 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.
+ */
+export declare function collectionVariables(input: CollectionVariablesInput): Record<string, string>;
+export interface ContentBuilderInput {
+    branding: TenantBranding;
+    /** Conteúdo estruturado já produzido por `renderCopy`. */
+    subject: string;
+    block: EmailBlock;
+}
+/**
+ * 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.
+ */
+export declare function buildCollectionContent(input: ContentBuilderInput): (channel: ChannelKey, template: {
+    providerTemplateName?: string;
+    body?: string;
+    subject?: string;
+    locale: string;
+}, ordered: string[], variables: Record<string, string>) => MessageContent | null;
+//# sourceMappingURL=communication-bridge.d.ts.map

package/dist/collection/communication-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"communication-bridge.d.ts","sourceRoot":"","sources":["../../src/collection/communication-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,KAAK,UAAU,EACf,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIpD,qFAAqF;AACrF,eAAO,MAAM,UAAU,4BAA4B,CAAC;AAEpD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ3D;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAEvF;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAa3F;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,cAAc,CAAC;IACzB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,mBAAmB,GACzB,CACD,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE;IAAE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC5F,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC9B,cAAc,GAAG,IAAI,CAkCzB"}

package/dist/collection/communication-bridge.js

@@ -0,0 +1,134 @@
+/**
+ * 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.
+ */
+import {} from '../communication/index.js';
+import { renderCollectionEmail, renderCollectionText } from './email-layout.js';
+import { formatBRL, formatDateBR } from './format.js';
+/** Slug do produto no ecossistema. Estável — entra em toda chave de idempotência. */
+export const 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.
+ */
+export 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. */
+export function collectionContext(tenantId, brand) {
+    return { tenantId, product: 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.
+ */
+export function collectionVariables(input) {
+    const vars = {
+        clientName: input.clientName,
+        officeName: input.officeName,
+        amount: formatBRL(input.outstandingAmount),
+        dueDate: 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.
+ */
+export function buildCollectionContent(input) {
+    return (channel, template, ordered, variables) => {
+        if (channel === 'email') {
+            return {
+                kind: 'email',
+                subject: template.subject ?? input.subject,
+                html: renderCollectionEmail(input.branding, input.block),
+                text: 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/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/collection/communication-runtime.d.ts

@@ -0,0 +1,132 @@
+/**
+ * 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.
+ */
+import type { Db, Tx } from '../db/client.js';
+import { type ChannelKey, type SmsTransport } from '../communication/index.js';
+import type { TenantBranding } from './branding.js';
+import { SC_PRODUCT } from './communication-bridge.js';
+import type { CollectionCommunication } from './engine.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.
+ */
+export declare function brandKeyFor(branding: TenantBranding): string;
+/**
+ * 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.
+ */
+export declare const 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.
+ */
+export declare function resolveTenantEmailCredentialRef(tx: Tx, platformRef: string): Promise<{
+    ref: string;
+    origin: 'tenant-vault' | 'platform-fallback';
+}>;
+export interface CollectionCommunicationOptions {
+    /**
+     * Pool. Usado SÓ pela reserva de envio, que precisa de transação própria e
+     * curta para ficar visível a outros workers antes do fim do ciclo.
+     */
+    db: Db;
+    /** Transação do ciclo. Templates, consentimento e trilha vivem nela. */
+    tx: Tx;
+    tenantId: string;
+    branding: TenantBranding;
+    /**
+     * Remetente de e-mail da plataforma — o fallback governado.
+     *
+     * Explícito no chamador de propósito: enquanto era `process.env.RESEND_*` lido
+     * lá dentro, o fallback global era invisível para quem lia a montagem.
+     */
+    platformEmail: {
+        senderId: string;
+        credentialRef: string;
+    };
+    /**
+     * Traduz referência lógica de credencial em segredo. O valor nunca volta ao
+     * domínio; morre dentro do adapter.
+     */
+    resolveCredential: (ref: string) => Promise<string | undefined>;
+    /**
+     * Trava de envio real de WhatsApp. **Desligada por omissão** e ligada só por
+     * ato humano com autorização. Ver `adapters/whatsapp.ts`.
+     */
+    whatsappLiveSend?: boolean;
+    /** Transporte de SMS. Ausente = canal não registrado, que é a verdade hoje. */
+    smsTransport?: SmsTransport;
+    /** Percorre tudo e relata, sem chamar adapter nenhum e sem reservar chave. */
+    dryRun?: boolean;
+}
+/**
+ * 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.
+ */
+export declare function buildCollectionCommunication(options: CollectionCommunicationOptions): Promise<CollectionCommunication>;
+/**
+ * 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.
+ */
+export declare function environmentCredentialResolver(): (ref: string) => Promise<string | undefined>;
+/** Canais que este produto sabe operar. Consultado por tela e por teste. */
+export declare const SC_SUPPORTED_CHANNELS: readonly ChannelKey[];
+export { SC_PRODUCT };
+//# sourceMappingURL=communication-runtime.d.ts.map

package/dist/collection/communication-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"communication-runtime.d.ts","sourceRoot":"","sources":["../../src/collection/communication-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAWL,KAAK,UAAU,EAEf,KAAK,YAAY,EAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,EAAqB,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG1E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE3D;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAY5D;AAED;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,mBAAmB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,+BAA+B,CACnD,EAAE,EAAE,EAAE,EACN,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,GAAG,mBAAmB,CAAA;CAAE,CAAC,CAcxE;AAED,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,EAAE,EAAE,EAAE,CAAC;IACP,wEAAwE;IACxE,EAAE,EAAE,EAAE,CAAC;IACP,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,cAAc,CAAC;IACzB;;;;;OAKG;IACH,aAAa,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D;;;OAGG;IACH,iBAAiB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAChE;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,+EAA+E;IAC/E,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,8EAA8E;IAC9E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,uBAAuB,CAAC,CAoHlC;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,IAAI,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAoB5F;AAED,4EAA4E;AAC5E,eAAO,MAAM,qBAAqB,EAAE,SAAS,UAAU,EAAiC,CAAC;AAEzF,OAAO,EAAE,UAAU,EAAE,CAAC"}