@baruk/core 0.3.1 → 0.5.0

package/dist/collection/template.js

@@ -0,0 +1,73 @@
+export const TEMPLATE_VARIABLES = [
+    'clientName',
+    'officeName',
+    'dueDate',
+    'outstandingAmount',
+    'reference',
+];
+/**
+ * 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.
+ */
+const DEFAULT_TEMPLATES = {
+    'collection.reminder': {
+        subject: 'Lembrete: vencimento em {{dueDate}}',
+        body: 'Olá, {{clientName}}.\n\n' +
+            'Passando para lembrar que o valor de {{outstandingAmount}} vence em {{dueDate}}.\n' +
+            'Referência: {{reference}}.\n\n' +
+            'Se já tiver pago, desconsidere esta mensagem.\n\n{{officeName}}',
+    },
+    'collection.due': {
+        subject: 'Vence hoje: {{outstandingAmount}}',
+        body: 'Olá, {{clientName}}.\n\n' +
+            'O valor de {{outstandingAmount}} vence hoje ({{dueDate}}).\n' +
+            'Referência: {{reference}}.\n\n' +
+            'Se já tiver pago, desconsidere esta mensagem.\n\n{{officeName}}',
+    },
+    'collection.overdue_soft': {
+        subject: 'Pendência em aberto — {{reference}}',
+        body: 'Olá, {{clientName}}.\n\n' +
+            'Consta em aberto o valor de {{outstandingAmount}}, com vencimento em {{dueDate}}.\n' +
+            'Se o pagamento já foi feito, por favor nos avise para darmos baixa.\n\n' +
+            'Qualquer dúvida, estamos à disposição.\n\n{{officeName}}',
+    },
+    'collection.overdue': {
+        subject: 'Pendência em aberto desde {{dueDate}}',
+        body: 'Olá, {{clientName}}.\n\n' +
+            'O valor de {{outstandingAmount}}, vencido em {{dueDate}}, segue em aberto.\n' +
+            'Referência: {{reference}}.\n\n' +
+            'Pedimos que entre em contato para regularizarmos ou combinarmos a melhor forma.\n\n' +
+            '{{officeName}}',
+    },
+    // Interno: nunca vai ao cliente. Ver a nota em `policy.ts`.
+    'collection.escalate': {
+        subject: 'Cobrança escalada para atendimento humano — {{clientName}}',
+        body: 'A régua automática chegou ao fim para {{clientName}} ({{reference}}), com ' +
+            '{{outstandingAmount}} em aberto desde {{dueDate}}. A partir daqui a condução é humana.',
+    },
+};
+const TONE_FALLBACK = {
+    reminder: 'collection.reminder',
+    due_notice: 'collection.due',
+    friendly_collection: 'collection.overdue_soft',
+    overdue_collection: 'collection.overdue',
+    human_escalation: 'collection.escalate',
+};
+/** Resolve o template; cai no padrão do tom quando o tenant não tem o seu. */
+export function resolveTemplate(templateKey, tone, overrides) {
+    return (overrides?.[templateKey] ??
+        DEFAULT_TEMPLATES[templateKey] ??
+        DEFAULT_TEMPLATES[TONE_FALLBACK[tone]]);
+}
+/** Substitui `{{var}}` pelas variáveis da allowlist. O resto fica literal. */
+export function renderTemplate(text, vars) {
+    return text.replace(/\{\{\s*([a-zA-Z]+)\s*\}\}/g, (whole, name) => TEMPLATE_VARIABLES.includes(name)
+        ? String(vars[name] ?? '')
+        : whole);
+}
+export { DEFAULT_TEMPLATES };
+//# sourceMappingURL=template.js.map

package/dist/collection/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/collection/template.ts"],"names":[],"mappings":"AAoBA,MAAM,CAAC,MAAM,kBAAkB,GAAoC;IACjE,YAAY;IACZ,YAAY;IACZ,SAAS;IACT,mBAAmB;IACnB,WAAW;CACZ,CAAC;AAOF;;;;;;;GAOG;AACH,MAAM,iBAAiB,GAAuC;IAC5D,qBAAqB,EAAE;QACrB,OAAO,EAAE,qCAAqC;QAC9C,IAAI,EACF,0BAA0B;YAC1B,oFAAoF;YACpF,gCAAgC;YAChC,iEAAiE;KACpE;IACD,gBAAgB,EAAE;QAChB,OAAO,EAAE,mCAAmC;QAC5C,IAAI,EACF,0BAA0B;YAC1B,8DAA8D;YAC9D,gCAAgC;YAChC,iEAAiE;KACpE;IACD,yBAAyB,EAAE;QACzB,OAAO,EAAE,qCAAqC;QAC9C,IAAI,EACF,0BAA0B;YAC1B,qFAAqF;YACrF,yEAAyE;YACzE,0DAA0D;KAC7D;IACD,oBAAoB,EAAE;QACpB,OAAO,EAAE,uCAAuC;QAChD,IAAI,EACF,0BAA0B;YAC1B,8EAA8E;YAC9E,gCAAgC;YAChC,qFAAqF;YACrF,gBAAgB;KACnB;IACD,4DAA4D;IAC5D,qBAAqB,EAAE;QACrB,OAAO,EAAE,4DAA4D;QACrE,IAAI,EACF,4EAA4E;YAC5E,wFAAwF;KAC3F;CACF,CAAC;AAEF,MAAM,aAAa,GAA6B;IAC9C,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE,gBAAgB;IAC5B,mBAAmB,EAAE,yBAAyB;IAC9C,kBAAkB,EAAE,oBAAoB;IACxC,gBAAgB,EAAE,qBAAqB;CACxC,CAAC;AAEF,8EAA8E;AAC9E,MAAM,UAAU,eAAe,CAC7B,WAAmB,EACnB,IAAc,EACd,SAA8C;IAE9C,OAAO,CACL,SAAS,EAAE,CAAC,WAAW,CAAC;QACxB,iBAAiB,CAAC,WAAW,CAAC;QAC9B,iBAAiB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAE,CACxC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,IAAkB;IAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,4BAA4B,EAAE,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE,CACvE,kBAAwC,CAAC,QAAQ,CAAC,IAAI,CAAC;QACtD,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAA0B,CAAC,IAAI,EAAE,CAAC;QAChD,CAAC,CAAC,KAAK,CACV,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/communication/adapters/email.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Adapter de e-mail — envelope do envio que o Office já usa.
+ *
+ * **Nenhum motor novo de e-mail.** Convites, ativação, recuperação de senha e a
+ * régua de cobrança já passam por `mail/resend.ts`. Este adapter apenas o expõe
+ * sob o contrato multicanal, para que o e-mail seja UM canal entre outros em vez
+ * de o caminho especial que todos os outros tentam imitar.
+ *
+ * A supressão em teste continua onde estava, no `sendEmail` do core: uma guarda
+ * que mora no adapter é uma guarda que o próximo adapter esquece.
+ */
+import type { CommunicationChannel } from '../channel.js';
+import type { ChannelAccount } from '../identity.js';
+export interface EmailAdapterConfig {
+    /** Conta do tenant, resolvida ANTES pelo motor. Ver `identity.ts`. */
+    account: ChannelAccount;
+    /**
+     * Resolve o valor da credencial a partir da referência lógica.
+     *
+     * Recebe `account.credentialRef` e devolve o segredo. O segredo entra no
+     * adapter e morre nele: nunca é devolvido, logado nem anexado ao desfecho.
+     */
+    resolveCredential: (ref: string) => Promise<string | undefined>;
+    /** Injetável para teste. Nenhum teste deve alcançar a rede real. */
+    fetchImpl?: typeof fetch;
+}
+export declare function createEmailChannel(config: EmailAdapterConfig): CommunicationChannel;
+//# sourceMappingURL=email.d.ts.map

package/dist/communication/adapters/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../../src/communication/adapters/email.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAoC,MAAM,eAAe,CAAC;AAE5F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAyBrD,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,OAAO,EAAE,cAAc,CAAC;IACxB;;;;;OAKG;IACH,iBAAiB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAChE,oEAAoE;IACpE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,oBAAoB,CAyGnF"}

package/dist/communication/adapters/email.js

@@ -0,0 +1,129 @@
+/**
+ * Adapter de e-mail — envelope do envio que o Office já usa.
+ *
+ * **Nenhum motor novo de e-mail.** Convites, ativação, recuperação de senha e a
+ * régua de cobrança já passam por `mail/resend.ts`. Este adapter apenas o expõe
+ * sob o contrato multicanal, para que o e-mail seja UM canal entre outros em vez
+ * de o caminho especial que todos os outros tentam imitar.
+ *
+ * A supressão em teste continua onde estava, no `sendEmail` do core: uma guarda
+ * que mora no adapter é uma guarda que o próximo adapter esquece.
+ */
+import { sendEmailWithResult } from '../../mail/resend.js';
+import { RESEND_IDEMPOTENCY_WINDOW_MS } from '../capabilities.js';
+/**
+ * O que o Resend garante, e o que este adapter exerce.
+ *
+ * `supportsProviderIdempotency` é `true` porque o adapter MANDA a chave, não
+ * porque a documentação do fornecedor a menciona: a declaração descreve o código
+ * daqui. Enquanto a chave não era repassada — o estado que a segunda
+ * certificação encontrou —, declarar `true` teria sido documentar uma proteção
+ * inexistente.
+ *
+ * Os outros três são `false` por ausência de integração, não por ausência do
+ * fornecedor. O Resend publica webhooks de entrega e relata abertura; nenhuma
+ * rota daqui os consome hoje (a rota de callback existente é da Meta). Declarar a
+ * capacidade do fornecedor em vez da capacidade do código produziria exatamente
+ * a divergência entre documento e runtime que reprovou a rodada anterior.
+ */
+const RESEND_CAPABILITIES = {
+    supportsProviderIdempotency: true,
+    providerIdempotencyWindowMs: RESEND_IDEMPOTENCY_WINDOW_MS,
+    supportsMessageLookup: false,
+    supportsDeliveryWebhook: false,
+    supportsReadReceipt: false,
+};
+export function createEmailChannel(config) {
+    return {
+        key: 'email',
+        providerName: 'resend',
+        capabilities: RESEND_CAPABILITIES,
+        isConfigured(_ctx) {
+            return config.account.status === 'active' && Boolean(config.account.senderId);
+        },
+        async send(message) {
+            if (message.content.kind !== 'email') {
+                return { kind: 'permanent', code: 'content_mismatch', detail: 'conteúdo não é e-mail' };
+            }
+            const apiKey = await config.resolveCredential(config.account.credentialRef);
+            if (!apiKey) {
+                // Ausência de credencial é canal indisponível, não falha de entrega: não
+                // gasta tentativa e não marca o cliente como problema de cadastro.
+                return { kind: 'unavailable', code: 'no_credential', detail: 'credencial ausente' };
+            }
+            const from = config.account.displayName
+                ? `${config.account.displayName.replace(/["<>\\]/g, '').trim()} <${config.account.senderId}>`
+                : config.account.senderId;
+            const result = await sendEmailWithResult(apiKey, {
+                from,
+                to: message.to,
+                subject: message.content.subject,
+                html: message.content.html,
+                text: message.content.text,
+            }, {
+                /*
+                 * A chave do MOTOR, repassada ao provider.
+                 *
+                 * É a mesma em toda tentativa técnica do mesmo envio, porque é derivada
+                 * da intenção (tenant, produto, marca, canal, evento, assunto, versão
+                 * de template) e não da tentativa. Derivá-la aqui, ou embaralhá-la com
+                 * um contador de retry, teria o mecanismo ligado e proteção nenhuma: o
+                 * provider trataria cada retry como mensagem nova.
+                 *
+                 * Cabe no limite do provider por construção — a chave é um sha256 em
+                 * hexadecimal, 64 caracteres, e o Resend aceita de 1 a 256.
+                 */
+                idempotencyKey: message.idempotencyKey,
+                fetchImpl: config.fetchImpl,
+            });
+            if (result.ok)
+                return { kind: 'sent', providerRef: result.providerRef };
+            /*
+             * `409` é o mecanismo de idempotência falando, e a leitura correta não é
+             * "falhou".
+             *
+             * `invalid_idempotent_request`: esta chave já foi usada nas últimas 24h com
+             * um corpo diferente. Ou seja — houve uma chamada anterior aceita para esta
+             * mesma intenção. A mensagem SAIU. Tratar como falha devolveria a chave e a
+             * próxima rodada mandaria a segunda cobrança, que é precisamente o que a
+             * chave existe para impedir.
+             *
+             * `concurrent_idempotent_requests`: outra chamada com a mesma chave está em
+             * curso agora. Não é nosso caso comum (a reserva interna já barra isso
+             * antes), mas se acontecer, quem está enviando é a outra chamada — e
+             * reenviar por cima é o mesmo erro.
+             */
+            if (result.status === 409) {
+                return {
+                    kind: 'sent',
+                    code: 'provider_idempotent_replay',
+                    detail: 'provider já havia aceito esta chave',
+                };
+            }
+            // Chave fora do formato aceito é defeito de integração nosso, não do
+            // destinatário. `permanent` para não repetir a mesma chamada inválida em
+            // loop; o rótulo diz onde olhar.
+            if (result.errorCode === 'invalid_idempotency_key') {
+                return {
+                    kind: 'permanent',
+                    code: 'invalid_idempotency_key',
+                    detail: 'chave de idempotência recusada pelo provider',
+                };
+            }
+            // Sem credencial o canal está indisponível, não falho: não gasta tentativa
+            // e não acusa o cadastro do cliente.
+            if (result.localReason === 'no_credential') {
+                return { kind: 'unavailable', code: 'no_credential', detail: 'credencial ausente' };
+            }
+            // O resto — recusa do provider, supressão em teste, falha de rede — é
+            // TEMPORÁRIO. Marcar permanente encerraria a cobrança por algo que pode ser
+            // infraestrutura, e desistir cedo demais é pior que tentar de novo.
+            return {
+                kind: 'temporary',
+                code: result.errorCode ?? result.localReason ?? 'not_confirmed',
+                detail: 'provider não confirmou o envio',
+            };
+        },
+    };
+}
+//# sourceMappingURL=email.js.map

package/dist/communication/adapters/email.js.map

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

package/dist/communication/adapters/sms.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Adapter de SMS — provider-agnostic por construção.
+ *
+ * Nenhum provider está contratado, e este arquivo não escolhe um. Ele define o
+ * TRANSPORTE que qualquer provider precisa implementar e deixa a escolha para o
+ * dia em que houver decisão comercial — Twilio, Zenvia, Infobip, o que for.
+ *
+ * A separação entre "canal" e "transporte" existe porque SMS tem regras próprias
+ * que valem para TODOS os providers (segmentação por tamanho, remetente
+ * alfanumérico proibido no Brasil, ausência de status `read`) e que não deveriam
+ * ser reimplementadas por cada adapter concreto. O canal cuida disso; o
+ * transporte só entrega bytes.
+ */
+import type { ChannelCapabilities } from '../capabilities.js';
+import type { CommunicationChannel } from '../channel.js';
+import type { ChannelAccount } from '../identity.js';
+export declare function isGsm7(text: string): boolean;
+/** Quantos segmentos este texto custa. É o que vira dinheiro na fatura. */
+export declare function countSegments(text: string): number;
+export interface SmsSendRequest {
+    /** E.164. */
+    to: string;
+    /** Remetente conforme a conta do tenant. */
+    from: string;
+    body: string;
+    /**
+     * Chave do motor, a MESMA em toda tentativa técnica do mesmo envio.
+     *
+     * Repassada quando o provider tem idempotência nativa; ignorada quando não —
+     * e, nesse caso, o transporte deve declarar `capabilities` sem
+     * `supportsProviderIdempotency`, para que o motor não conte com uma proteção
+     * que ninguém está exercendo.
+     */
+    idempotencyKey: string;
+}
+export type SmsTransportResult = {
+    ok: true;
+    providerRef?: string;
+} | {
+    ok: false;
+    /** Rótulo estável, snake_case. Nunca a mensagem crua do provider. */
+    code: string;
+    /**
+     * O transporte classifica, porque só ele conhece a taxonomia do próprio
+     * provider. O canal não tenta adivinhar a partir de string de erro — ler
+     * mensagem de erro para decidir retry quebra na primeira vez que o
+     * provider reescreve o texto.
+     */
+    kind: 'temporary' | 'permanent' | 'unavailable';
+    detail?: string;
+};
+/** O que um provider de SMS precisa implementar. Nada além disto. */
+export interface SmsTransport {
+    readonly name: string;
+    /**
+     * O que ESTE provider garante. Ausente = nenhuma garantia externa.
+     *
+     * Opcional, ao contrário de `CommunicationChannel.capabilities`, e a diferença
+     * é deliberada: o canal é do motor e tem de declarar sempre; o transporte é do
+     * produto, e a omissão dele precisa cair no default seguro em vez de quebrar a
+     * compilação de quem já implementou um transporte.
+     *
+     * Enquanto nenhum provider de SMS estiver contratado, a única declaração
+     * honesta é a ausência — `PROVIDER_IDEMPOTENCY_STRATEGY = UNKNOWN_UNTIL_PROVIDER`.
+     */
+    readonly capabilities?: ChannelCapabilities;
+    send(req: SmsSendRequest): Promise<SmsTransportResult>;
+}
+export interface SmsAdapterConfig {
+    account: ChannelAccount;
+    transport: SmsTransport;
+    /** Mesma trava do WhatsApp: sem autorização explícita, nada sai. */
+    liveSend?: boolean;
+    /**
+     * Teto de segmentos por mensagem. Acima disso, recusa em vez de enviar.
+     *
+     * Não é limite técnico — é limite de CUSTO. Um template mal preenchido (uma
+     * variável que chega com um parágrafo em vez de um nome) vira uma mensagem de
+     * dez segmentos multiplicada pela carteira inteira, e a fatura é o primeiro
+     * lugar onde alguém repara.
+     */
+    maxSegments?: number;
+}
+export declare function createSmsChannel(config: SmsAdapterConfig): CommunicationChannel;
+/**
+ * Transporte de ensaio — registra o que teria enviado e nunca alcança rede.
+ *
+ * Serve ao dry-run e aos testes, e é o que permite exercitar segmentação, custo
+ * e isolamento sem provider contratado. Não simula entrega para o motor: quem
+ * decide se houve envio é a trava `liveSend`, não este objeto.
+ */
+export declare function createRecordingSmsTransport(): SmsTransport & {
+    sent: SmsSendRequest[];
+};
+//# sourceMappingURL=sms.d.ts.map

package/dist/communication/adapters/sms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sms.d.ts","sourceRoot":"","sources":["../../../src/communication/adapters/sms.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,KAAK,EAAE,oBAAoB,EAAoC,MAAM,eAAe,CAAC;AAE5F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAqBrD,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAK5C;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWlD;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa;IACb,EAAE,EAAE,MAAM,CAAC;IACX,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;OAOG;IACH,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAClC;IACE,EAAE,EAAE,KAAK,CAAC;IACV,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,IAAI,EAAE,WAAW,GAAG,WAAW,GAAG,aAAa,CAAC;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAAC;IAC5C,IAAI,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,YAAY,CAAC;IACxB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,oBAAoB,CAyD/E;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,IAAI,YAAY,GAAG;IAAE,IAAI,EAAE,cAAc,EAAE,CAAA;CAAE,CAUvF"}

package/dist/communication/adapters/sms.js

@@ -0,0 +1,121 @@
+/**
+ * Adapter de SMS — provider-agnostic por construção.
+ *
+ * Nenhum provider está contratado, e este arquivo não escolhe um. Ele define o
+ * TRANSPORTE que qualquer provider precisa implementar e deixa a escolha para o
+ * dia em que houver decisão comercial — Twilio, Zenvia, Infobip, o que for.
+ *
+ * A separação entre "canal" e "transporte" existe porque SMS tem regras próprias
+ * que valem para TODOS os providers (segmentação por tamanho, remetente
+ * alfanumérico proibido no Brasil, ausência de status `read`) e que não deveriam
+ * ser reimplementadas por cada adapter concreto. O canal cuida disso; o
+ * transporte só entrega bytes.
+ */
+import { NO_PROVIDER_GUARANTEES } from '../capabilities.js';
+/**
+ * Limite de um segmento GSM-7. Acima disso a mensagem é dividida e **cobrada por
+ * segmento** — cada provider com sua própria contagem.
+ *
+ * Com qualquer caractere fora do alfabeto GSM-7 (o `ç` de "cobrança", o `ã` de
+ * "atenção", qualquer emoji) a codificação inteira vira UCS-2 e o limite cai
+ * para 70. É por isso que a contagem não pode ser um `length > 160` ingênuo: um
+ * texto de 150 caracteres com um acento custa três segmentos, não um.
+ */
+const GSM7_SINGLE = 160;
+const GSM7_MULTI = 153;
+const UCS2_SINGLE = 70;
+const UCS2_MULTI = 67;
+const GSM7_EXTRA = '^{}\\[~]|€';
+const GSM7_BASE = '@£$¥èéùìòÇØøÅåΔ_ΦΓΛΩΠΨΣΘΞÆæßÉ !"#¤%&\'()*+,-./0123456789:;<=>?' +
+    '¡ABCDEFGHIJKLMNOPQRSTUVWXYZÄÖÑܧ¿abcdefghijklmnopqrstuvwxyzäöñüà\n\r';
+export function isGsm7(text) {
+    for (const ch of text) {
+        if (!GSM7_BASE.includes(ch) && !GSM7_EXTRA.includes(ch))
+            return false;
+    }
+    return true;
+}
+/** Quantos segmentos este texto custa. É o que vira dinheiro na fatura. */
+export function countSegments(text) {
+    if (text.length === 0)
+        return 0;
+    const gsm = isGsm7(text);
+    // Caracteres da tabela estendida ocupam DOIS septetos.
+    const units = gsm
+        ? [...text].reduce((n, ch) => n + (GSM7_EXTRA.includes(ch) ? 2 : 1), 0)
+        : [...text].length;
+    const single = gsm ? GSM7_SINGLE : UCS2_SINGLE;
+    const multi = gsm ? GSM7_MULTI : UCS2_MULTI;
+    return units <= single ? 1 : Math.ceil(units / multi);
+}
+export function createSmsChannel(config) {
+    const maxSegments = config.maxSegments ?? 3;
+    return {
+        key: 'sms',
+        providerName: config.transport.name,
+        /*
+         * As garantias vêm do TRANSPORTE, e o default é nenhuma.
+         *
+         * Nenhum provider de SMS está contratado. A garantia de idempotência depende
+         * de qual for escolhido, e o canal não tem como saber antes — por isso ele
+         * não afirma nada por conta própria: quem implementar o transporte declara o
+         * que aquele provider realmente faz, e o silêncio significa ausência.
+         *
+         * Enquanto isso, o efeito no motor é o correto e conservador: uma reserva de
+         * SMS retomada de um titular que já falou com o provider para em
+         * `unknown_outcome` em vez de reenviar às cegas.
+         */
+        capabilities: config.transport.capabilities ?? NO_PROVIDER_GUARANTEES,
+        isConfigured(_ctx) {
+            return config.account.status === 'active' && Boolean(config.account.senderId);
+        },
+        async send(message) {
+            if (!config.liveSend) {
+                return {
+                    kind: 'unavailable',
+                    code: 'live_send_disabled',
+                    detail: 'envio real de SMS não autorizado neste ambiente',
+                };
+            }
+            if (message.content.kind !== 'text') {
+                return { kind: 'permanent', code: 'content_mismatch', detail: 'SMS aceita apenas texto' };
+            }
+            const segments = countSegments(message.content.body);
+            if (segments > maxSegments) {
+                return {
+                    kind: 'permanent',
+                    code: 'too_many_segments',
+                    detail: `mensagem custaria ${segments} segmentos (teto ${maxSegments})`,
+                };
+            }
+            const result = await config.transport.send({
+                to: message.to,
+                from: config.account.senderId,
+                body: message.content.body,
+                idempotencyKey: message.idempotencyKey,
+            });
+            if (result.ok)
+                return { kind: 'sent', providerRef: result.providerRef };
+            return { kind: result.kind, code: result.code, detail: result.detail };
+        },
+    };
+}
+/**
+ * Transporte de ensaio — registra o que teria enviado e nunca alcança rede.
+ *
+ * Serve ao dry-run e aos testes, e é o que permite exercitar segmentação, custo
+ * e isolamento sem provider contratado. Não simula entrega para o motor: quem
+ * decide se houve envio é a trava `liveSend`, não este objeto.
+ */
+export function createRecordingSmsTransport() {
+    const sent = [];
+    return {
+        name: 'recording',
+        sent,
+        async send(req) {
+            sent.push(req);
+            return { ok: true, providerRef: `rec_${sent.length}` };
+        },
+    };
+}
+//# sourceMappingURL=sms.js.map

package/dist/communication/adapters/sms.js.map

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

package/dist/communication/adapters/whatsapp-language.d.ts

@@ -0,0 +1,34 @@
+/**
+ * O código de idioma como a Meta o escreve.
+ *
+ * ## O defeito que este módulo existe para não repetir
+ *
+ * O domínio fala BCP-47 (`pt-BR`), que é a forma correta para um catálogo de
+ * templates que um dia terá outros providers. A Meta escreve `pt_BR`, com
+ * underscore, e recusa qualquer outra grafia.
+ *
+ * Enquanto não havia um ponto único de tradução, as duas pontas escolheram
+ * convenções diferentes sozinhas: a submissão registrou o template como
+ * `pt_BR` e o despacho pediu `pt-BR`. O primeiro envio real do produto morreu
+ * exatamente aí, em 2026-09-01, com
+ * `(#132001) Template name does not exist in the translation` — uma mensagem
+ * que fala de tradução e parece falar de template inexistente.
+ *
+ * A conversão mora no ADAPTER porque é detalhe de provider, como o
+ * `UTILITY` maiúsculo de `whatsapp-templates.ts`. Colocá-la no catálogo faria o
+ * domínio carregar a grafia da Meta, e o próximo provider herdaria um `pt_BR`
+ * que não significa nada para ele.
+ *
+ * Este arquivo não fala com rede nenhuma — é tradução pura, e o guard de
+ * fronteira em `communication-provider-boundary.test.ts` exige que continue
+ * assim.
+ */
+/**
+ * `pt-BR` → `pt_BR`. Idempotente: o que já está na forma da Meta passa igual.
+ *
+ * Não valida: um idioma que a Meta não conhece é recusado por ela, com o código
+ * dela, e inventar uma lista aqui significaria mantê-la sincronizada com um
+ * catálogo que muda sem avisar.
+ */
+export declare function metaLanguageCode(locale: string): string;
+//# sourceMappingURL=whatsapp-language.d.ts.map

package/dist/communication/adapters/whatsapp-language.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-language.d.ts","sourceRoot":"","sources":["../../../src/communication/adapters/whatsapp-language.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/communication/adapters/whatsapp-language.js

@@ -0,0 +1,36 @@
+/**
+ * O código de idioma como a Meta o escreve.
+ *
+ * ## O defeito que este módulo existe para não repetir
+ *
+ * O domínio fala BCP-47 (`pt-BR`), que é a forma correta para um catálogo de
+ * templates que um dia terá outros providers. A Meta escreve `pt_BR`, com
+ * underscore, e recusa qualquer outra grafia.
+ *
+ * Enquanto não havia um ponto único de tradução, as duas pontas escolheram
+ * convenções diferentes sozinhas: a submissão registrou o template como
+ * `pt_BR` e o despacho pediu `pt-BR`. O primeiro envio real do produto morreu
+ * exatamente aí, em 2026-09-01, com
+ * `(#132001) Template name does not exist in the translation` — uma mensagem
+ * que fala de tradução e parece falar de template inexistente.
+ *
+ * A conversão mora no ADAPTER porque é detalhe de provider, como o
+ * `UTILITY` maiúsculo de `whatsapp-templates.ts`. Colocá-la no catálogo faria o
+ * domínio carregar a grafia da Meta, e o próximo provider herdaria um `pt_BR`
+ * que não significa nada para ele.
+ *
+ * Este arquivo não fala com rede nenhuma — é tradução pura, e o guard de
+ * fronteira em `communication-provider-boundary.test.ts` exige que continue
+ * assim.
+ */
+/**
+ * `pt-BR` → `pt_BR`. Idempotente: o que já está na forma da Meta passa igual.
+ *
+ * Não valida: um idioma que a Meta não conhece é recusado por ela, com o código
+ * dela, e inventar uma lista aqui significaria mantê-la sincronizada com um
+ * catálogo que muda sem avisar.
+ */
+export function metaLanguageCode(locale) {
+    return locale.replace(/-/g, '_');
+}
+//# sourceMappingURL=whatsapp-language.js.map

package/dist/communication/adapters/whatsapp-language.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-language.js","sourceRoot":"","sources":["../../../src/communication/adapters/whatsapp-language.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACnC,CAAC"}

package/dist/communication/adapters/whatsapp-templates.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Gestão de template no WhatsApp — adapter da Meta Cloud API.
+ *
+ * Implementa `TemplateManagementProvider`. Todo o vocabulário da Meta mora
+ * aqui: `components`, `BODY`, `example.body_text`, categorias em maiúsculas,
+ * `POST /{waba-id}/message_templates`. O domínio não conhece nenhum deles.
+ */
+import type { TemplateManagementProvider } from '../template-provider.js';
+export interface WhatsAppTemplateAdapterConfig {
+    /** WABA do tenant. Identificador público, nunca segredo. */
+    wabaId: string;
+    accessToken: string;
+    /** Injetável para teste. **Nenhum teste deve alcançar a rede real.** */
+    fetchImpl?: typeof fetch;
+    env?: NodeJS.ProcessEnv;
+}
+export declare function createWhatsAppTemplateProvider(config: WhatsAppTemplateAdapterConfig): TemplateManagementProvider;
+//# sourceMappingURL=whatsapp-templates.d.ts.map

package/dist/communication/adapters/whatsapp-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-templates.d.ts","sourceRoot":"","sources":["../../../src/communication/adapters/whatsapp-templates.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAEV,0BAA0B,EAI3B,MAAM,yBAAyB,CAAC;AAIjC,MAAM,WAAW,6BAA6B;IAC5C,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AA0BD,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,6BAA6B,GACpC,0BAA0B,CAqE5B"}