@baruk/core 0.3.1 → 0.4.2

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"}

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

@@ -0,0 +1,97 @@
+/**
+ * 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 { graphUrl } from '../graph.js';
+import { metaLanguageCode } from './whatsapp-language.js';
+const TIMEOUT_MS = 20_000;
+/** O domínio fala minúsculo; a Meta espera maiúsculo. A tradução mora aqui. */
+const CATEGORY = {
+    utility: 'UTILITY',
+    marketing: 'MARKETING',
+    authentication: 'AUTHENTICATION',
+};
+/**
+ * Classificação do erro da Meta.
+ *
+ * `duplicate_name` merece classe própria porque é o desfecho ESPERADO de uma
+ * resubmissão — quem chama trata como "já existe", relê e segue, em vez de
+ * tratar como falha e tentar de novo.
+ */
+function classify(status, code, subcode) {
+    if (code === 190 || code === 200 || code === 10 || code === 3)
+        return 'unauthorized';
+    // 2388023 / subcode 2388024: nome de template já em uso na conta.
+    if (code === 2388023 || subcode === 2388024)
+        return 'duplicate_name';
+    if (code === 4 || code === 80007 || status === 429)
+        return 'rate_limited';
+    if (status >= 500)
+        return 'network';
+    if (code === 100 || code === 132000)
+        return 'invalid_content';
+    return 'provider_error';
+}
+export function createWhatsAppTemplateProvider(config) {
+    const doFetch = config.fetchImpl ?? fetch;
+    return {
+        channel: 'whatsapp',
+        async submit(submission) {
+            const body = {
+                name: submission.name,
+                language: metaLanguageCode(submission.language),
+                category: CATEGORY[submission.category],
+                components: [
+                    {
+                        type: 'BODY',
+                        text: submission.bodyText,
+                        // `body_text` é uma lista de listas: uma linha de exemplos por
+                        // conjunto de variáveis do corpo. Omitido quando não há variável —
+                        // um `example` vazio é recusado.
+                        ...(submission.bodyExample && submission.bodyExample.length > 0
+                            ? { example: { body_text: [submission.bodyExample] } }
+                            : {}),
+                    },
+                ],
+            };
+            let res;
+            try {
+                res = await doFetch(graphUrl(`${encodeURIComponent(config.wabaId)}/message_templates`, config.env), {
+                    method: 'POST',
+                    headers: {
+                        authorization: `Bearer ${config.accessToken}`,
+                        'content-type': 'application/json',
+                    },
+                    body: JSON.stringify(body),
+                    signal: AbortSignal.timeout(TIMEOUT_MS),
+                });
+            }
+            catch {
+                // Nada da exceção é propagado: em algumas implementações de `fetch` a
+                // mensagem inclui a URL, e a URL leva o token no header — mas o corpo
+                // do erro também pode ecoar cabeçalhos em proxies.
+                return { ok: false, reason: 'network' };
+            }
+            const payload = (await res.json().catch(() => null));
+            if (!res.ok) {
+                const err = (payload?.error ?? {});
+                return { ok: false, reason: classify(res.status, err.code, err.error_subcode) };
+            }
+            const id = payload?.id;
+            const status = payload?.status;
+            const category = payload?.category;
+            return {
+                ok: true,
+                ...(typeof id === 'string' ? { providerRef: id } : {}),
+                // Sem `status` no corpo, o desfecho honesto é "submetido, revisão
+                // pendente" — e não inventar `APPROVED`.
+                status: typeof status === 'string' ? status : 'PENDING',
+                ...(typeof category === 'string' ? { category } : {}),
+            };
+        },
+    };
+}
+//# sourceMappingURL=whatsapp-templates.js.map

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

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

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

@@ -0,0 +1,29 @@
+/**
+ * Adapter de WhatsApp — Meta Cloud API.
+ *
+ * O provider é escolha desta implementação, não do domínio: o consumidor pede
+ * `channel: 'whatsapp'` e nunca vê `wamid`, `phoneNumberId` nem código de erro
+ * da Meta. Trocar por Twilio ou Zenvia é escrever outro arquivo deste tamanho e
+ * registrar outro adapter — nenhuma linha de régua muda.
+ *
+ * **Trava de envio real.** Enquanto `liveSend` não for explicitamente ligado, o
+ * adapter recusa com `unavailable` ANTES de qualquer rede. A trava é do código,
+ * não do processo: uma frente que promete "não enviar mensagem real" e depende
+ * de ninguém chamar a função errada não prometeu nada.
+ */
+import type { CommunicationChannel } from '../channel.js';
+import type { ChannelAccount } from '../identity.js';
+export interface WhatsAppAdapterConfig {
+    account: ChannelAccount;
+    resolveCredential: (ref: string) => Promise<string | undefined>;
+    /**
+     * Sem isto, nada sai. Ligar é um ato deliberado, feito uma vez, com
+     * autorização humana — e o padrão `false` significa que esquecer de ligar
+     * falha fechado, que é a direção certa para falhar.
+     */
+    liveSend?: boolean;
+    /** Injetável para teste. Nenhum teste deve alcançar a rede real. */
+    fetchImpl?: typeof fetch;
+}
+export declare function createWhatsAppChannel(config: WhatsAppAdapterConfig): CommunicationChannel;
+//# sourceMappingURL=whatsapp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp.d.ts","sourceRoot":"","sources":["../../../src/communication/adapters/whatsapp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAoC,MAAM,eAAe,CAAC;AAE5F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAoCrD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,cAAc,CAAC;IACxB,iBAAiB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAChE;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oEAAoE;IACpE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AA6CD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,oBAAoB,CAkGzF"}