@baruk/core 0.3.1 → 0.5.0

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

package/dist/communication/adapters/whatsapp.js

@@ -0,0 +1,210 @@
+/**
+ * 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 { graphUrl } from '../graph.js';
+import { metaLanguageCode } from './whatsapp-language.js';
+/**
+ * O que a Meta Cloud API garante, e o que este adapter exerce.
+ *
+ * **Sem idempotência de provider.** A referência da Cloud API não documenta
+ * cabeçalho de idempotência nem parâmetro equivalente; o `wamid` é identificador
+ * de mensagem devolvido DEPOIS do aceite, que é outra coisa — ele não impede a
+ * segunda chamada de virar a segunda mensagem.
+ *
+ * A consequência prática está no motor, não aqui: uma reserva de WhatsApp retomada
+ * de um titular que já tinha chamado a Meta **não é reenviada**. Ela para em
+ * `unknown_outcome`, visível para quem opera. Inventar uma chave que a Meta não lê
+ * daria a aparência da proteção sem nada por trás — que é pior que não ter.
+ *
+ * `supportsDeliveryWebhook` é `true` porque a rota de callback da Meta existe e é
+ * exercida (`routes/communication-webhooks.ts`); `supportsReadReceipt` também,
+ * porque `read` é um dos status que ela trata.
+ */
+const META_CLOUD_CAPABILITIES = {
+    supportsProviderIdempotency: false,
+    supportsMessageLookup: false,
+    supportsDeliveryWebhook: true,
+    supportsReadReceipt: true,
+};
+/*
+ * A versão da Graph API mora em `../graph.ts`, e não aqui.
+ *
+ * Este arquivo declarava `v21.0` — de 2024-10, no fim da janela de dois anos em
+ * que a Meta mantém uma versão viva. Duas versões no mesmo runtime não falham
+ * quando divergem: falham quando a mais velha é desativada, e o sintoma é meio
+ * canal parado enquanto o resto funciona.
+ */
+const TIMEOUT_MS = 10_000;
+/**
+ * Classificação dos códigos de erro da Meta.
+ *
+ * A distinção que mais importa não é temporário × permanente — é **problema do
+ * destinatário × problema nosso**. Um token expirado (190) devolvido como
+ * `permanent` marcaria o CLIENTE como contato inválido e o tiraria da régua para
+ * sempre, quando o defeito é uma credencial nossa que alguém precisa renovar.
+ * Por isso erro de configuração vira `unavailable`: não gasta tentativa, não
+ * acusa o cliente, e aparece na tela como pendência do escritório.
+ */
+function classify(code, subcode) {
+    // Credencial/permissão/configuração — nosso problema, não do destinatário.
+    if (code === 190 || code === 200 || code === 10 || code === 3)
+        return 'unavailable';
+    if (code === 100 && subcode === 33)
+        return 'unavailable';
+    // Limites de taxa — sempre vale tentar de novo.
+    if (code === 4 || code === 80007 || code === 130429 || code === 131048 || code === 131056) {
+        return 'temporary';
+    }
+    // Falhas internas da plataforma.
+    if (code === 1 || code === 2 || code === 131000)
+        return 'temporary';
+    // Destinatário: não tem WhatsApp, número inexistente, recusa de entrega.
+    if (code === 131026 || code === 131052 || code === 133010)
+        return 'permanent';
+    // Fora da janela de sessão sem template válido, e problemas de template.
+    if (code === 131047 || (code >= 132000 && code <= 132015))
+        return 'permanent';
+    // Parâmetro inválido é defeito de integração; retry repetiria o mesmo erro.
+    if (code === 100)
+        return 'permanent';
+    // Código desconhecido: `temporary`. Um erro novo da Meta tratado como
+    // permanente removeria o cliente da régua em definitivo por algo que ninguém
+    // ainda entendeu — o dano de tentar de novo é muito menor.
+    return 'temporary';
+}
+export function createWhatsAppChannel(config) {
+    const doFetch = config.fetchImpl ?? fetch;
+    return {
+        key: 'whatsapp',
+        providerName: 'meta_cloud',
+        capabilities: META_CLOUD_CAPABILITIES,
+        isConfigured(_ctx) {
+            return (config.account.status === 'active' &&
+                Boolean(config.account.meta?.phoneNumberId) &&
+                Boolean(config.account.senderId));
+        },
+        async send(message) {
+            if (!config.liveSend) {
+                return {
+                    kind: 'unavailable',
+                    code: 'live_send_disabled',
+                    detail: 'envio real de WhatsApp não autorizado neste ambiente',
+                };
+            }
+            const phoneNumberId = config.account.meta?.phoneNumberId;
+            if (!phoneNumberId) {
+                return {
+                    kind: 'unavailable',
+                    code: 'no_phone_number_id',
+                    detail: 'conta sem phoneNumberId',
+                };
+            }
+            const token = await config.resolveCredential(config.account.credentialRef);
+            if (!token) {
+                return { kind: 'unavailable', code: 'no_credential', detail: 'credencial ausente' };
+            }
+            const body = buildBody(message);
+            if (!body) {
+                return {
+                    kind: 'permanent',
+                    code: 'content_mismatch',
+                    detail: 'conteúdo inválido para WhatsApp',
+                };
+            }
+            let res;
+            try {
+                res = await doFetch(graphUrl(`${encodeURIComponent(phoneNumberId)}/messages`), {
+                    method: 'POST',
+                    headers: {
+                        authorization: `Bearer ${token}`,
+                        'content-type': 'application/json',
+                    },
+                    body: JSON.stringify(body),
+                    signal: AbortSignal.timeout(TIMEOUT_MS),
+                });
+            }
+            catch {
+                // Timeout e falha de rede nunca carregam a causa real do lado do
+                // provider — e a mensagem da exceção pode conter a URL com credencial
+                // embutida em algumas implementações. Não propaga nada dela.
+                return { kind: 'temporary', code: 'network', detail: 'falha de rede ao chamar o provider' };
+            }
+            if (res.ok) {
+                const payload = (await res.json().catch(() => null));
+                const providerRef = payload?.messages?.[0]?.id;
+                // `sent` = a Meta aceitou. NÃO é entrega: quem afirma entrega é o
+                // webhook, depois. Ver `status.ts`.
+                return { kind: 'sent', providerRef };
+            }
+            const err = (await res
+                .json()
+                .then((b) => typeof b === 'object' && b !== null && 'error' in b
+                ? (b.error ?? {})
+                : {})
+                .catch(() => ({})));
+            const code = err.code ?? res.status;
+            const kind = res.status >= 500 ? 'temporary' : classify(code, err.error_subcode);
+            return {
+                kind,
+                code: `meta_${code}`,
+                // Só a mensagem do provider, truncada. Nunca o corpo enviado (carrega as
+                // variáveis do template, que são PII) e nunca os headers.
+                detail: (err.message ?? `HTTP ${res.status}`).slice(0, 200),
+            };
+        },
+    };
+}
+function buildBody(message) {
+    const to = message.to.replace(/^\+/, '');
+    if (message.content.kind === 'whatsapp_template') {
+        const { templateName, language, variables } = message.content;
+        return {
+            messaging_product: 'whatsapp',
+            recipient_type: 'individual',
+            to,
+            type: 'template',
+            template: {
+                name: templateName,
+                // A Meta escreve `pt_BR`; o domínio, `pt-BR`. A tradução é do adapter.
+                language: { code: metaLanguageCode(language) },
+                // `components` só entra quando há variável: um template sem parâmetro
+                // recebendo `parameters: []` é recusado pela Meta.
+                ...(variables.length > 0
+                    ? {
+                        components: [
+                            {
+                                type: 'body',
+                                parameters: variables.map((text) => ({ type: 'text', text })),
+                            },
+                        ],
+                    }
+                    : {}),
+            },
+        };
+    }
+    if (message.content.kind === 'text') {
+        // Texto livre só é aceito DENTRO da janela de 24h aberta pelo cliente. O
+        // motor não tem como saber se a janela está aberta — e por isso este caminho
+        // existe para resposta a conversa iniciada pelo cliente, nunca para
+        // cobrança ativa, que é sempre template.
+        return {
+            messaging_product: 'whatsapp',
+            recipient_type: 'individual',
+            to,
+            type: 'text',
+            text: { preview_url: false, body: message.content.body },
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=whatsapp.js.map

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

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

package/dist/communication/audit.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Trilha de comunicação — o que o motor decidiu, e por quê.
+ *
+ * **Não é log.** Log é texto que alguém talvez leia; isto é registro estruturado
+ * e consultável, com um vocabulário fechado de eventos. A diferença aparece na
+ * pergunta que o escritório faz de verdade: "por que este cliente não recebeu?".
+ * Um `console.warn` responde isso para quem estiver com o terminal aberto no
+ * instante certo; uma trilha responde seis meses depois.
+ *
+ * A trilha financeira (`dunning_event`) continua sendo o estado da ETAPA da
+ * régua. Esta é o histórico da INTENÇÃO de comunicar — que é outra coisa: uma
+ * etapa pode ter uma intenção recusada por consentimento, outra por telefone
+ * inválido e uma terceira entregue, e `dunning_event` só guarda o desfecho final
+ * de uma delas.
+ *
+ * O que NUNCA entra aqui: valor de credencial, corpo de mensagem, telefone,
+ * e-mail. O destinatário aparece como referência lógica (`recipientRef`), que já
+ * é o vocabulário do consumidor.
+ */
+import type { ChannelKey } from './channel.js';
+import type { CommunicationContext } from './context.js';
+import type { SkipReason } from './policy.js';
+import type { DeliveryStatus } from './status.js';
+/**
+ * Vocabulário fechado. União de literais, e não `string`, de propósito: um tipo
+ * aberto vira dez grafias do mesmo evento e nenhuma métrica agregável.
+ */
+export type CommunicationEventKind = 
+/** O consumidor pediu uma comunicação. Uma por `dispatch`, antes de qualquer porta. */
+'intent_created'
+/** A reserva de envio foi concedida a ESTA execução. */
+ | 'dispatch_claimed'
+/** Um canal foi pulado. `skipReason` diz qual porta fechou. */
+ | 'dispatch_skipped'
+/** O provider aceitou. NÃO é entrega — ver `status.ts`. */
+ | 'dispatch_sent'
+/** O provider recusou, ou a rede falhou. */
+ | 'dispatch_failed'
+/** Opt-out registrado barrou o canal. Recorte de `dispatch_skipped` porque tem consequência jurídica. */
+ | 'consent_blocked'
+/** Contato ausente ou inutilizável. Recorte porque a ação é cadastral, não técnica. */
+ | 'invalid_contact'
+/** Callback do provider: chegou ao aparelho. */
+ | 'callback_delivered'
+/** Callback do provider: foi aberta. Só canais que reportam leitura. */
+ | 'callback_read'
+/** Callback do provider: falhou depois de aceita. */
+ | 'callback_failed'
+/** O destinatário pediu para não receber, por qualquer via. */
+ | 'opt_out';
+export interface CommunicationEvent {
+    kind: CommunicationEventKind;
+    ctx: CommunicationContext;
+    channel: ChannelKey | null;
+    eventType: string;
+    /** Assunto no domínio do consumidor (recebível, fatura). Nunca PII. */
+    subjectRef: string | null;
+    /** Destinatário como REFERÊNCIA lógica (id do cliente). Nunca telefone nem e-mail. */
+    recipientRef: string | null;
+    idempotencyKey: string | null;
+    /** Identificador da mensagem no provider, quando existe. Nunca credencial. */
+    providerRef?: string | null;
+    skipReason?: SkipReason | null;
+    status?: DeliveryStatus | null;
+    /** Rótulo curto e estável para métrica. snake_case. */
+    code?: string | null;
+    /** Detalhe legível, truncado pelo sink. Nunca PII, nunca segredo. */
+    detail?: string | null;
+    /** Número da tentativa desta chave, quando a reserva foi concedida. */
+    attempt?: number | null;
+}
+/**
+ * Destino da trilha. Implementado pelo produto.
+ *
+ * `Promise<void>` e nunca lança: uma trilha que derruba o envio troca um
+ * problema de observabilidade por um de entrega. O produto que a implementa é
+ * quem decide o que fazer quando a gravação falha — e a implementação de
+ * referência engole e segue.
+ */
+export interface CommunicationAuditSink {
+    record(event: CommunicationEvent): Promise<void>;
+}
+/**
+ * Sink que não grava nada.
+ *
+ * Existe para consumidores que ainda não têm armazenamento, e é EXPLÍCITO de
+ * propósito: um sink opcional viraria `deps.audit?.record(...)` espalhado pelo
+ * motor, e a diferença entre "não configurou trilha" e "esqueceu de chamar"
+ * deixaria de ser visível.
+ */
+export declare function createNullAuditSink(): CommunicationAuditSink;
+/** Coleta em memória — para teste e para o relatório de dry-run. */
+export declare function createRecordingAuditSink(): CommunicationAuditSink & {
+    readonly events: readonly CommunicationEvent[];
+};
+/**
+ * De qual evento de trilha um pulo é.
+ *
+ * Três motivos ganham nome próprio porque exigem ações operacionais opostas:
+ * opt-out é decisão do cliente (e ninguém no escritório deve "resolver"), falta
+ * de contato é cadastro, e o resto é ambiente. Colapsá-los em `dispatch_skipped`
+ * mandaria o escritório procurar no lugar errado nos dois primeiros casos.
+ */
+export declare function eventKindForSkip(reason: SkipReason): CommunicationEventKind;
+//# sourceMappingURL=audit.d.ts.map

package/dist/communication/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/communication/audit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,sBAAsB;AAChC,uFAAuF;AACrF,gBAAgB;AAClB,wDAAwD;GACtD,kBAAkB;AACpB,+DAA+D;GAC7D,kBAAkB;AACpB,2DAA2D;GACzD,eAAe;AACjB,4CAA4C;GAC1C,iBAAiB;AACnB,yGAAyG;GACvG,iBAAiB;AACnB,uFAAuF;GACrF,iBAAiB;AACnB,gDAAgD;GAC9C,oBAAoB;AACtB,wEAAwE;GACtE,eAAe;AACjB,qDAAqD;GACnD,iBAAiB;AACnB,+DAA+D;GAC7D,SAAS,CAAC;AAEd,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,GAAG,EAAE,oBAAoB,CAAC;IAC1B,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,sFAAsF;IACtF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,sBAAsB,CAE5D;AAED,oEAAoE;AACpE,wBAAgB,wBAAwB,IAAI,sBAAsB,GAAG;IACnE,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAChD,CAQA;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,sBAAsB,CAI3E"}

package/dist/communication/audit.js

@@ -0,0 +1,56 @@
+/**
+ * Trilha de comunicação — o que o motor decidiu, e por quê.
+ *
+ * **Não é log.** Log é texto que alguém talvez leia; isto é registro estruturado
+ * e consultável, com um vocabulário fechado de eventos. A diferença aparece na
+ * pergunta que o escritório faz de verdade: "por que este cliente não recebeu?".
+ * Um `console.warn` responde isso para quem estiver com o terminal aberto no
+ * instante certo; uma trilha responde seis meses depois.
+ *
+ * A trilha financeira (`dunning_event`) continua sendo o estado da ETAPA da
+ * régua. Esta é o histórico da INTENÇÃO de comunicar — que é outra coisa: uma
+ * etapa pode ter uma intenção recusada por consentimento, outra por telefone
+ * inválido e uma terceira entregue, e `dunning_event` só guarda o desfecho final
+ * de uma delas.
+ *
+ * O que NUNCA entra aqui: valor de credencial, corpo de mensagem, telefone,
+ * e-mail. O destinatário aparece como referência lógica (`recipientRef`), que já
+ * é o vocabulário do consumidor.
+ */
+/**
+ * Sink que não grava nada.
+ *
+ * Existe para consumidores que ainda não têm armazenamento, e é EXPLÍCITO de
+ * propósito: um sink opcional viraria `deps.audit?.record(...)` espalhado pelo
+ * motor, e a diferença entre "não configurou trilha" e "esqueceu de chamar"
+ * deixaria de ser visível.
+ */
+export function createNullAuditSink() {
+    return { async record() { } };
+}
+/** Coleta em memória — para teste e para o relatório de dry-run. */
+export function createRecordingAuditSink() {
+    const events = [];
+    return {
+        events,
+        async record(event) {
+            events.push(event);
+        },
+    };
+}
+/**
+ * De qual evento de trilha um pulo é.
+ *
+ * Três motivos ganham nome próprio porque exigem ações operacionais opostas:
+ * opt-out é decisão do cliente (e ninguém no escritório deve "resolver"), falta
+ * de contato é cadastro, e o resto é ambiente. Colapsá-los em `dispatch_skipped`
+ * mandaria o escritório procurar no lugar errado nos dois primeiros casos.
+ */
+export function eventKindForSkip(reason) {
+    if (reason === 'opted_out')
+        return 'consent_blocked';
+    if (reason === 'no_recipient' || reason === 'invalid_recipient')
+        return 'invalid_contact';
+    return 'dispatch_skipped';
+}
+//# sourceMappingURL=audit.js.map

package/dist/communication/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/communication/audit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAqEH;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,EAAE,KAAK,CAAC,MAAM,KAAmB,CAAC,EAAE,CAAC;AAC9C,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,wBAAwB;IAGtC,MAAM,MAAM,GAAyB,EAAE,CAAC;IACxC,OAAO;QACL,MAAM;QACN,KAAK,CAAC,MAAM,CAAC,KAAyB;YACpC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAkB;IACjD,IAAI,MAAM,KAAK,WAAW;QAAE,OAAO,iBAAiB,CAAC;IACrD,IAAI,MAAM,KAAK,cAAc,IAAI,MAAM,KAAK,mBAAmB;QAAE,OAAO,iBAAiB,CAAC;IAC1F,OAAO,kBAAkB,CAAC;AAC5B,CAAC"}

package/dist/communication/capabilities.d.ts

@@ -0,0 +1,88 @@
+/**
+ * O que o PROVIDER por trás de um canal garante — declarado pelo adapter.
+ *
+ * Existe para que o motor possa tomar uma decisão que depende do provider sem
+ * nunca saber qual provider é. A alternativa é a que o certificador proibiu
+ * explicitamente:
+ *
+ *     if (provider === 'resend') { ...reenvia... } else { ...não reenvia... }
+ *
+ * Espalhado pelo núcleo, esse `if` transforma "trocar de provider" em mudança de
+ * regra de negócio, e faz o motor compartilhado carregar o catálogo de fornecedor
+ * de cada produto. Aqui o adapter DECLARA a garantia e o motor lê a declaração.
+ *
+ * **Toda capability nasce `false`.** O default não é conservadorismo estético: um
+ * campo opcional que o adapter esquece de declarar viraria uma garantia
+ * imaginária, e a consequência de imaginar idempotência que não existe é o
+ * cliente recebendo a mesma cobrança duas vezes. Quem tem a garantia declara; o
+ * silêncio significa ausência.
+ *
+ * **A declaração descreve o que ESTE ADAPTER exerce, não o que o provider anuncia
+ * no site.** O Resend publica webhooks de entrega; o adapter de e-mail daqui não
+ * consome nenhum, então `supportsDeliveryWebhook` é `false` para ele. Declarar a
+ * capacidade do fornecedor em vez da capacidade do código seria documentar uma
+ * integração que não existe — que é o defeito `DOCUMENTATION_MATCHES_RUNTIME`.
+ */
+export interface ChannelCapabilities {
+    /**
+     * O provider deduplica chamadas que trazem a MESMA chave de idempotência.
+     *
+     * É a segunda camada, nunca a primeira: a reserva interna (`claim.ts`) continua
+     * obrigatória, porque a idempotência do provider só protege depois que a
+     * chamada externa já saiu daqui.
+     */
+    supportsProviderIdempotency: boolean;
+    /**
+     * Por quanto tempo a chave vale no provider. Obrigatório quando
+     * `supportsProviderIdempotency` é `true` — uma janela desconhecida é
+     * indistinguível de janela nenhuma no instante em que ela importa.
+     */
+    providerIdempotencyWindowMs?: number;
+    /**
+     * Dá para PERGUNTAR ao provider se uma mensagem saiu, a partir do que temos
+     * guardado.
+     *
+     * "A partir do que temos guardado" é a parte que decide: um provider com
+     * consulta por identificador de mensagem não serve aqui, porque o caso em que
+     * a consulta seria útil é justamente aquele em que o processo morreu antes de
+     * guardar o identificador.
+     */
+    supportsMessageLookup: boolean;
+    /** O adapter recebe callback de entrega deste provider por uma rota existente. */
+    supportsDeliveryWebhook: boolean;
+    /** O provider reporta LEITURA, e o adapter consome esse relato. */
+    supportsReadReceipt: boolean;
+}
+/**
+ * Nenhuma garantia externa. É o que vale para todo canal que não declare o
+ * contrário — e é o que faz um adapter novo nascer seguro em vez de nascer
+ * otimista.
+ */
+export declare const NO_PROVIDER_GUARANTEES: ChannelCapabilities;
+/**
+ * Reenviar com a MESMA chave é seguro agora?
+ *
+ * Chamado quando o desfecho da tentativa anterior é desconhecido — o titular da
+ * reserva chamou o provider e morreu antes de assentar. A pergunta não é "o
+ * provider tem idempotência", é "a chave que eu usei ainda está viva lá".
+ *
+ * Fora da janela, a chave já não significa nada para o provider: a segunda
+ * chamada seria uma mensagem nova, e o cliente receberia duas. Por isso a
+ * expiração devolve `false` — e o motor, sem cobertura, não reenvia.
+ *
+ * **Recebe IDADE, não instante.** A diferença não é estética: o instante da
+ * primeira chamada é medido pelo relógio de quem guardou o dado (o `now()` do
+ * banco), e compará-lo com o `Date.now()` do processo mistura dois relógios que
+ * não têm obrigação de concordar. Numa deriva de poucos segundos isso passa
+ * despercebido; num processo com relógio adiantado, "dentro da janela" vira
+ * "fora" e o motor deixa de reenviar o que podia — ou o contrário. Quem guarda o
+ * dado calcula a idade, e a comparação acontece numa escala só.
+ *
+ * `ageMs` ausente significa que nenhuma chamada externa foi registrada, e aí não
+ * há o que cobrir: quem pergunta nesse estado está perguntando a coisa errada,
+ * então a resposta é `false`.
+ */
+export declare function providerIdempotencyCovers(capabilities: ChannelCapabilities, ageMs: number | null): boolean;
+/** Janela de idempotência do Resend: 24 horas. Ver `adapters/email.ts`. */
+export declare const RESEND_IDEMPOTENCY_WINDOW_MS: number;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/communication/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/communication/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,2BAA2B,EAAE,OAAO,CAAC;IACrC;;;;OAIG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC;;;;;;;;OAQG;IACH,qBAAqB,EAAE,OAAO,CAAC;IAC/B,kFAAkF;IAClF,uBAAuB,EAAE,OAAO,CAAC;IACjC,mEAAmE;IACnE,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,mBAKpC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,mBAAmB,EACjC,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB,OAAO,CAMT;AAED,2EAA2E;AAC3E,eAAO,MAAM,4BAA4B,QAAsB,CAAC"}