@baruk/core 0.3.1 → 0.5.0

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

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

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

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

package/dist/cjs/collection/template.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TEMPLATES = exports.TEMPLATE_VARIABLES = void 0;
+exports.resolveTemplate = resolveTemplate;
+exports.renderTemplate = renderTemplate;
+exports.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.',
+    },
+};
+exports.DEFAULT_TEMPLATES = DEFAULT_TEMPLATES;
+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. */
+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. */
+function renderTemplate(text, vars) {
+    return text.replace(/\{\{\s*([a-zA-Z]+)\s*\}\}/g, (whole, name) => exports.TEMPLATE_VARIABLES.includes(name)
+        ? String(vars[name] ?? '')
+        : whole);
+}
+//# sourceMappingURL=template.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../src/collection/template.ts"],"names":[],"mappings":";;;AA6FA,0CAUC;AAGD,wCAMC;AA5FY,QAAA,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;AAgCO,8CAAiB;AA9B1B,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,SAAgB,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,SAAgB,cAAc,CAAC,IAAY,EAAE,IAAkB;IAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,4BAA4B,EAAE,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE,CACvE,0BAAwC,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"}

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

@@ -0,0 +1,132 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEmailChannel = createEmailChannel;
+const resend_js_1 = require("../../mail/resend.js");
+const capabilities_js_1 = require("../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: capabilities_js_1.RESEND_IDEMPOTENCY_WINDOW_MS,
+    supportsMessageLookup: false,
+    supportsDeliveryWebhook: false,
+    supportsReadReceipt: false,
+};
+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 (0, resend_js_1.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/cjs/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/cjs/communication/adapters/sms.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isGsm7 = isGsm7;
+exports.countSegments = countSegments;
+exports.createSmsChannel = createSmsChannel;
+exports.createRecordingSmsTransport = createRecordingSmsTransport;
+const capabilities_js_1 = require("../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';
+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. */
+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);
+}
+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 ?? capabilities_js_1.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.
+ */
+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/cjs/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/cjs/communication/adapters/whatsapp-language.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.metaLanguageCode = metaLanguageCode;
+/**
+ * `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.
+ */
+function metaLanguageCode(locale) {
+    return locale.replace(/-/g, '_');
+}
+//# sourceMappingURL=whatsapp-language.js.map

package/dist/cjs/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;;AASH,4CAEC;AATD;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,MAAc;IAC7C,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACnC,CAAC"}