@baruk/core 0.3.1 → 0.4.2

package/dist/cjs/communication/engine.js

@@ -0,0 +1,483 @@
+"use strict";
+/**
+ * Motor de comunicação compartilhado.
+ *
+ *   INTENT → CONTEXT → POLICY → IDENTITY → CONSENT → RECIPIENT → TEMPLATE
+ *          → CONTENT → CLAIM → [RECOVERY?] → FENCE → ADAPTER → SETTLE
+ *
+ * O consumidor declara a INTENÇÃO de negócio ("avisar este cliente sobre o
+ * recebível X, etapa D+3, preferindo WhatsApp"). O motor decide nada sobre o
+ * negócio e tudo sobre a entrega.
+ *
+ * Cada porta abaixo pode recusar, e **toda recusa tem motivo próprio**. Um motor
+ * que devolve "não enviado" sem dizer qual porta fechou obriga o escritório a
+ * adivinhar entre "o cliente pediu para não receber" e "ninguém cadastrou o
+ * telefone" — que exigem ações opostas de quem opera.
+ *
+ * **CLAIM é a penúltima porta, e é a mais importante.** Ela fica imediatamente
+ * antes do adapter porque é o único lugar onde uma reserva serve para alguma
+ * coisa: a proteção contra envio duplo tem de acontecer antes do efeito externo,
+ * nunca depois. Ver `claim.ts`.
+ *
+ * Entre CLAIM e ADAPTER existem duas etapas que a H2 acrescentou, e nenhuma das
+ * duas é opcional:
+ *
+ *   RECOVERY  quando a reserva foi retomada de um titular que já tinha falado com
+ *             o provider, o desfecho anterior é DESCONHECIDO. O motor só reenvia
+ *             se o adapter declarar idempotência de provider que ainda cubra a
+ *             chave; sem isso, recusa e deixa a chave visível para quem opera.
+ *   FENCE     a marca durável de "vou chamar o provider agora", gravada antes da
+ *             chamada — e, na MESMA operação, a prova de que quem vai chamar
+ *             ainda é o titular da geração corrente. É ela que dá à próxima
+ *             retomada como saber a diferença entre "morreu antes de enviar" e
+ *             "morreu depois", e é ela que impede o titular vencido de alcançar
+ *             o provider. Perdeu a autoridade, não chama: sem exceção.
+ *
+ * A trilha do CICLO DE VIDA do disparo (`dispatch_claimed`, `dispatch_sent`,
+ * `dispatch_failed`) é gravada pelo STORE, junto com a reserva, e não pelo
+ * `audit` daqui. A razão está em `claim.ts`: o `audit` do motor vive na transação
+ * de negócio de quem chamou, e um rollback dela apagava a narrativa de um envio
+ * que tinha acontecido de verdade.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dispatch = dispatch;
+const channel_js_1 = require("./channel.js");
+const audit_js_1 = require("./audit.js");
+const capabilities_js_1 = require("./capabilities.js");
+const context_js_1 = require("./context.js");
+const consent_js_1 = require("./consent.js");
+const idempotency_js_1 = require("./idempotency.js");
+const identity_js_1 = require("./identity.js");
+const policy_js_1 = require("./policy.js");
+const template_js_1 = require("./template.js");
+const phone_js_1 = require("../contacts/phone.js");
+/** Pulo derivado de uma reserva negada. Cada um é um estado distinto do sistema. */
+const SKIP_FOR_REFUSAL = {
+    already_sent: 'already_sent',
+    in_flight: 'claim_in_flight',
+    permanently_failed: 'permanently_failed',
+    unknown_outcome: 'unknown_outcome',
+};
+/**
+ * Como um veredicto de fencing perdido aparece na trilha.
+ *
+ * O rótulo não é decoração: é o que a tela da régua mostra a quem investiga, e
+ * cada um pede uma ação diferente. `claim_lost` é concorrência sendo absorvida
+ * (outro worker está com o disparo agora — nada a fazer). `already_sent` é o
+ * sistema tendo funcionado. `permanently_failed` e `unknown_outcome` são as duas
+ * que pedem humano, e por motivos opostos.
+ *
+ * Colapsar tudo em `claim_lost` mandaria o escritório procurar um worker
+ * concorrente que não existe quando o caso é uma chave já assentada.
+ */
+function skipForLostAuthority(fence) {
+    if (fence.authority === 'lost')
+        return 'claim_lost';
+    if (fence.state === 'sent')
+        return 'already_sent';
+    if (fence.state === 'failed_permanent')
+        return 'permanently_failed';
+    if (fence.state === 'unknown_outcome')
+        return 'unknown_outcome';
+    // `none` / `failed_retryable` com a geração ainda casando não é estado
+    // alcançável pelo motor; se acontecer, é perda de autoridade e não um desfecho.
+    return 'claim_lost';
+}
+async function dispatch(intent, deps, options = {}) {
+    const attempts = [];
+    let providerSendCalls = 0;
+    const contextError = (0, context_js_1.validateContext)(intent.ctx);
+    if (contextError) {
+        // Nenhum envio sem contexto válido. Não há default, não há "assume o tenant
+        // da sessão": é a fronteira de isolamento, e ela falha fechada.
+        //
+        // A trilha também não é escrita: `appendAudit` deriva o tenant da sessão, e
+        // gravar um evento sob um contexto que o motor acabou de recusar seria
+        // registrar a linha no tenant errado.
+        return {
+            delivered: null,
+            attempts,
+            idempotencyKey: '',
+            invalidContext: contextError,
+            providerSendCalls,
+        };
+    }
+    const policy = intent.policy ?? policy_js_1.DEFAULT_POLICY;
+    const locale = intent.locale ?? 'pt-BR';
+    let lastKey = '';
+    const record = (event) => deps.audit.record({
+        ctx: intent.ctx,
+        channel: null,
+        eventType: intent.eventType,
+        subjectRef: intent.subjectRef,
+        recipientRef: intent.recipientRef,
+        idempotencyKey: null,
+        ...event,
+    });
+    await record({ kind: 'intent_created' });
+    for (const channel of policy.order) {
+        const skip = async (reason, detail, key) => {
+            attempts.push({ channel, skipped: reason, detail });
+            await record({
+                kind: (0, audit_js_1.eventKindForSkip)(reason),
+                channel,
+                skipReason: reason,
+                detail: detail ?? null,
+                idempotencyKey: key ?? null,
+            });
+        };
+        const adapter = (0, channel_js_1.resolveChannel)(deps.channels, channel);
+        if (!deps.channels[channel]) {
+            await skip('channel_not_registered', `canal ${channel} não registrado`);
+            continue;
+        }
+        const identity = await (0, identity_js_1.resolveIdentity)(deps.accounts, intent.ctx, channel);
+        if (!identity.ok) {
+            await skip('no_identity', identity.detail);
+            continue;
+        }
+        if (!(await adapter.isConfigured(intent.ctx))) {
+            await skip('no_identity', `adapter de ${channel} sem configuração utilizável`);
+            continue;
+        }
+        // Consentimento ANTES de resolver o destinatário. A ordem é deliberada: quem
+        // pediu para não receber não deve ter o telefone lido, e um opt-out não pode
+        // depender de o cadastro estar completo.
+        const consentRecord = await deps.consent.find(intent.recipientRef, channel);
+        const decision = (0, consent_js_1.evaluateConsent)(channel, consentRecord, deps.consentPolicy);
+        if (!decision.allowed) {
+            await skip(decision.reason, decision.detail);
+            continue;
+        }
+        const to = await deps.resolveRecipient(intent.recipientRef, channel);
+        if (!to) {
+            await skip('no_recipient', `sem contato de ${channel} cadastrado`);
+            continue;
+        }
+        // Validação de FORMA para canais de telefone, feita pelo motor.
+        //
+        // Fica aqui, e não em cada adapter, porque WhatsApp e SMS discordariam no
+        // primeiro caso de borda — e discordar significa uma mensagem chegar e a
+        // outra não, para o mesmo cliente, sem que nada explique por quê.
+        //
+        // "Sem telefone" e "telefone que não serve" são pulos DIFERENTES: o primeiro
+        // é campo em branco, o segundo é campo preenchido com um fixo (que o
+        // provider aceita, cobra e nunca entrega). Um só rótulo mandaria o
+        // escritório procurar o dado que já está lá.
+        if (channel === 'whatsapp' || channel === 'sms') {
+            const parsed = (0, phone_js_1.parseBrazilPhone)(to);
+            if (!(0, phone_js_1.isMessagingCapable)(parsed)) {
+                await skip('invalid_recipient', parsed.ok ? 'telefone não é celular' : `telefone inválido (${parsed.reason})`);
+                continue;
+            }
+        }
+        const tpl = await (0, template_js_1.resolveTemplate)(deps.templates, intent.ctx, channel, intent.eventType, locale);
+        if (!tpl.ok) {
+            await skip('no_template', tpl.detail);
+            continue;
+        }
+        const ordered = (0, template_js_1.orderVariables)(tpl.template, intent.variables);
+        if (!ordered.ok) {
+            await skip('no_template', `variáveis ausentes: ${ordered.missing.join(', ')}`);
+            continue;
+        }
+        const idempotencyKey = (0, idempotency_js_1.buildIdempotencyKey)({
+            ctx: intent.ctx,
+            channel,
+            eventType: intent.eventType,
+            subjectRef: intent.subjectRef,
+            templateVersion: tpl.template.version,
+        });
+        lastKey = idempotencyKey;
+        const content = deps.buildContent(channel, {
+            providerTemplateName: tpl.template.providerTemplateName,
+            body: tpl.template.body,
+            subject: tpl.template.subject,
+            locale,
+        }, ordered.ordered, intent.variables);
+        // Conteúdo montado ANTES da reserva, de propósito. Conteúdo que o canal não
+        // aceita é defeito de integração, e recusá-lo aqui evita reservar uma chave
+        // para um envio que nunca poderia acontecer — reserva tomada e devolvida é
+        // ruído na trilha de quem investiga.
+        if (!content || !(0, channel_js_1.channelAccepts)(channel, content)) {
+            await skip('no_template', `conteúdo incompatível com o canal ${channel}`, idempotencyKey);
+            continue;
+        }
+        if (options.dryRun) {
+            // Ensaio LÊ o estado da chave; nunca o toma. `peek` é a única consulta do
+            // motor que não reserva nada.
+            const state = await deps.claims.peek(idempotencyKey);
+            if (state === 'sent') {
+                await skip('already_sent', 'dry-run: já enviado', idempotencyKey);
+                return { delivered: null, attempts, idempotencyKey, providerSendCalls };
+            }
+            if (state === 'in_flight') {
+                await skip('claim_in_flight', 'dry-run: envio em andamento', idempotencyKey);
+                return { delivered: null, attempts, idempotencyKey, providerSendCalls };
+            }
+            if (state === 'unknown_outcome') {
+                // O ensaio relata o que a execução real faria, e a execução real recusa:
+                // ninguém sabe se a tentativa anterior saiu. Anunciar "enviaria" aqui
+                // faria o ensaio prometer o que a execução nega.
+                await skip('unknown_outcome', 'dry-run: desfecho anterior desconhecido', idempotencyKey);
+                return { delivered: null, attempts, idempotencyKey, providerSendCalls };
+            }
+            attempts.push({ channel, outcome: 'sent', detail: 'dry-run: não enviado' });
+            return { delivered: channel, attempts, idempotencyKey, providerSendCalls };
+        }
+        /* ── A porta que importa ──────────────────────────────────────────────
+         *
+         * Daqui até `settle` existe um e apenas um titular do direito de enviar.
+         * Nenhuma linha entre `claim` e `send` pode conter um `await` a algo que
+         * possa demorar indefinidamente — o prazo da reserva corre a partir daqui.
+         */
+        const claimResult = await deps.claims.claim({
+            ctx: intent.ctx,
+            channel,
+            eventType: intent.eventType,
+            subjectRef: intent.subjectRef,
+            idempotencyKey,
+            recipientRef: intent.recipientRef,
+        });
+        if (!claimResult.granted) {
+            const reason = SKIP_FOR_REFUSAL[claimResult.reason];
+            await skip(reason, claimResult.detail, idempotencyKey);
+            // Reserva negada é DESFECHO, não canal indisponível: seguir para o
+            // próximo canal entregaria por outra via o que já saiu (ou o que outro
+            // worker está entregando agora).
+            return { delivered: null, attempts, idempotencyKey, providerSendCalls };
+        }
+        const claim = claimResult.claim;
+        // `dispatch_claimed` é gravado pelo STORE, na mesma fronteira transacional
+        // da reserva. Gravá-lo aqui, pelo `audit` do motor, era o que permitia a um
+        // rollback da transação de negócio apagar a narrativa de um disparo que
+        // aconteceu de verdade. Ver a nota de durabilidade em `claim.ts`.
+        /* ── Desfecho DESCONHECIDO ────────────────────────────────────────────
+         *
+         * A reserva foi retomada de um titular que já tinha falado com o provider e
+         * morreu antes de assentar. A mensagem pode ter saído. Reenviar sem mais
+         * nada é a duplicata que a certificação apontou; declarar "não enviado" é
+         * inventar um fato.
+         *
+         * A única coisa que torna o reenvio seguro é uma garantia EXTERNA: a mesma
+         * chave, dentro da janela em que o provider ainda a reconhece, produz uma
+         * chamada que ele deduplica. Quem tem essa garantia é o adapter, e ele a
+         * declara — o motor lê a declaração e nunca pergunta qual é o provider.
+         */
+        if (claim.previousAttemptReachedProvider) {
+            const covered = (0, capabilities_js_1.providerIdempotencyCovers)(adapter.capabilities, claim.providerFirstAttemptAgeMs);
+            if (!covered) {
+                await deps.claims.settle(claim, {
+                    kind: 'unknown',
+                    code: 'unknown_outcome',
+                    detail: 'tentativa anterior alcançou o provider e não assentou',
+                }, {
+                    kind: 'dispatch_failed',
+                    code: 'unknown_outcome',
+                    detail: 'sem garantia de idempotência do provider para reenviar',
+                });
+                attempts.push({
+                    channel,
+                    skipped: 'unknown_outcome',
+                    detail: 'desfecho anterior desconhecido e sem cobertura do provider',
+                });
+                // NÃO segue para o próximo canal. A mensagem pode ter saído por este; um
+                // fallback aqui entregaria duas vezes pelo caminho que o motor não
+                // consegue verificar.
+                return { delivered: null, attempts, idempotencyKey, providerSendCalls };
+            }
+            // Coberto: reenvia REUTILIZANDO a mesma `idempotencyKey`. A chave é
+            // derivada da intenção (`idempotency.ts`), não da tentativa — gerar uma
+            // nova aqui destruiria exatamente a proteção que se está invocando.
+        }
+        /* ── FENCING PRÉ-PROVIDER — a última fronteira antes do efeito externo ──
+         *
+         * Uma operação, duas responsabilidades inseparáveis:
+         *
+         *   1. marca DURAVELMENTE que a chamada externa vai acontecer agora — o que
+         *      permite à próxima retomada saber que o desfecho é desconhecido em vez
+         *      de assumir que nada saiu;
+         *   2. PROVA que quem está prestes a chamar o provider ainda é o titular da
+         *      geração corrente da reserva.
+         *
+         * A segunda é o que a terceira certificação exigiu. Até aqui o motor gravava
+         * a marca e seguia para `adapter.send()` sem olhar o resultado. A trava por
+         * geração existia no `WHERE` do store e funcionava — nenhuma linha do zumbi
+         * era atualizada —, mas o motor não sabia disso, e um `UPDATE` cujo efeito o
+         * chamador ignora não protege nada:
+         *
+         *     A perde a reserva por prazo  →  B a retoma e envia
+         *     A acorda, "marca" (zero linhas)  →  A envia também
+         *
+         * Duas cobranças pela mesma intenção. **CLAIM_LOST ⇒ PROVIDER_CALL=false**,
+         * sem exceção — não há caso em que "tentar mesmo assim" seja preferível.
+         *
+         * Verificar aqui, e não com um `peek` antes, é o que fecha o TOCTOU: entre
+         * ler o estado e chamar o provider a reserva pode trocar de mãos. Marcar e
+         * verificar na MESMA instrução não deixa esse intervalo existir.
+         *
+         * FORA do `try` do adapter, de propósito. Se a GRAVAÇÃO falhar (banco fora,
+         * timeout), a exceção sobe: nada foi enviado, porque a marca vem antes da
+         * chamada. Cair no tratamento de exceção do adapter classificaria como "pode
+         * ter saído" um envio que nem começou, travando a chave por uma falha de
+         * banco. Deixando subir, a reserva expira e a retomada seguinte é segura —
+         * porque não há marca nenhuma.
+         */
+        const fence = await deps.claims.markProviderAttempt(claim);
+        if (fence.authority !== 'held') {
+            /*
+             * Perdeu a autoridade. Sai SEM chamar o adapter e SEM assentar.
+             *
+             * Não assentar é deliberado: `settle` recusaria de qualquer forma (a trava
+             * por geração é a mesma), mas pedir o assentamento afirmaria um desfecho
+             * sobre um disparo que pertence a outra execução. Quem tem a reserva agora
+             * é quem a assenta. A trilha desta execução registra o pulo, e só.
+             *
+             * Também NÃO segue para o próximo canal: o titular atual pode estar
+             * entregando por este exato canal neste instante, e um fallback aqui
+             * mandaria a segunda mensagem pela via que o motor não consegue verificar.
+             */
+            await skip(skipForLostAuthority(fence), fence.detail, idempotencyKey);
+            return { delivered: null, attempts, idempotencyKey, providerSendCalls };
+        }
+        let outcome;
+        try {
+            providerSendCalls += 1;
+            outcome = await adapter.send({
+                ctx: intent.ctx,
+                channel,
+                to,
+                content,
+                idempotencyKey,
+                eventType: intent.eventType,
+            });
+        }
+        catch (err) {
+            /*
+             * Adapter que LANÇA é o mesmo problema do titular que morre, sem precisar de
+             * crash nenhum: a chamada externa começou e o desfecho é DESCONHECIDO.
+             *
+             * O desenho anterior assentava falha retentável nos dois casos e explicava,
+             * num comentário, que "o motor escolhe não decidir sozinho". Mas devolver a
+             * chave É uma decisão — é decidir que nada saiu —, e num canal sem garantia
+             * externa a próxima rodada duplica.
+             *
+             * Agora a decisão é a mesma da retomada, e pelo mesmo critério: com
+             * cobertura de idempotência do provider, retentar é seguro (a chave é a
+             * mesma e ele deduplica); sem cobertura, a chave para em desconhecido.
+             *
+             * A marca já foi gravada antes da chamada, então `providerFirstAttemptAgeMs`
+             * responde pela tentativa ATUAL quando esta é a primeira — que é o que se
+             * quer: a janela do provider conta a partir do momento em que ele foi
+             * chamado.
+             */
+            const coveredOnThrow = (0, capabilities_js_1.providerIdempotencyCovers)(adapter.capabilities, claim.providerFirstAttemptAgeMs ?? 0);
+            if (coveredOnThrow) {
+                await deps.claims.settle(claim, {
+                    kind: 'failed',
+                    permanent: false,
+                    code: 'adapter_threw',
+                    detail: 'adapter lançou exceção',
+                }, {
+                    kind: 'dispatch_failed',
+                    code: 'adapter_threw',
+                    detail: err instanceof Error ? err.name : null,
+                });
+                attempts.push({ channel, outcome: 'temporary', detail: 'adapter lançou exceção' });
+            }
+            else {
+                await deps.claims.settle(claim, {
+                    kind: 'unknown',
+                    code: 'adapter_threw',
+                    detail: 'adapter lançou exceção depois de iniciar a chamada externa',
+                }, {
+                    kind: 'dispatch_failed',
+                    code: 'unknown_outcome',
+                    detail: err instanceof Error ? err.name : null,
+                });
+                attempts.push({
+                    channel,
+                    skipped: 'unknown_outcome',
+                    detail: 'adapter lançou exceção e o canal não tem garantia de idempotência',
+                });
+            }
+            return { delivered: null, attempts, idempotencyKey, providerSendCalls };
+        }
+        attempts.push({
+            channel,
+            outcome: outcome.kind,
+            providerRef: outcome.providerRef,
+            detail: outcome.detail,
+        });
+        if (outcome.kind === 'sent') {
+            await deps.claims.settle(claim, { kind: 'sent', providerRef: outcome.providerRef }, {
+                kind: 'dispatch_sent',
+                providerRef: outcome.providerRef ?? null,
+                status: 'sent',
+                code: outcome.code ?? null,
+            });
+            return {
+                delivered: channel,
+                providerRef: outcome.providerRef,
+                attempts,
+                idempotencyKey,
+                providerSendCalls,
+                recoveredFromExpiredClaim: claim.recoveredFromExpiredClaim,
+                providerIdempotentReplay: claim.previousAttemptReachedProvider,
+            };
+        }
+        if (outcome.kind === 'opted_out') {
+            // Opt-out descoberto no provider é terminal para esta chave E encerra
+            // tudo. Tentar outro canal depois de o destinatário ter recusado é
+            // contornar a recusa por outra porta.
+            await deps.claims.settle(claim, {
+                kind: 'failed',
+                permanent: true,
+                code: outcome.code,
+                detail: outcome.detail,
+            }, {
+                kind: 'opt_out',
+                code: outcome.code ?? null,
+                detail: outcome.detail ?? null,
+                status: 'opted_out',
+            });
+            return { delivered: null, attempts, idempotencyKey, providerSendCalls };
+        }
+        if (outcome.kind === 'unavailable') {
+            // Canal indisponível não é tentativa: a chave é DEVOLVIDA, e o próximo
+            // ciclo pode usá-la. Assentar falha aqui gastaria uma tentativa por um
+            // problema de ambiente que nada tem a ver com o destinatário.
+            await deps.claims.settle(claim, {
+                kind: 'released',
+                reason: outcome.code ?? 'channel_unavailable',
+            }, {
+                kind: 'dispatch_skipped',
+                skipReason: 'no_identity',
+                code: outcome.code ?? null,
+                detail: outcome.detail ?? null,
+            });
+            continue;
+        }
+        const permanent = outcome.kind === 'permanent';
+        await deps.claims.settle(claim, {
+            kind: 'failed',
+            permanent,
+            code: outcome.code,
+            detail: outcome.detail,
+        }, {
+            kind: 'dispatch_failed',
+            code: outcome.code ?? null,
+            detail: outcome.detail ?? null,
+            status: permanent ? 'failed' : null,
+        });
+        if (outcome.kind === 'temporary' && !policy.fallbackOnTemporary) {
+            return { delivered: null, attempts, idempotencyKey, providerSendCalls };
+        }
+        // Falha PERMANENTE segue para o próximo canal, e isso é deliberado: "este
+        // número não tem WhatsApp" é definitivo para o WhatsApp e não diz nada sobre
+        // o e-mail. A chave de reserva inclui o canal, então a etapa não corre risco
+        // de sair duas vezes pela mesma via — só de sair pela via que funciona.
+    }
+    return { delivered: null, attempts, idempotencyKey: lastKey, providerSendCalls };
+}
+//# sourceMappingURL=engine.js.map

package/dist/cjs/communication/engine.js.map

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

package/dist/cjs/communication/graph.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Versão da Graph API usada por todo o código que fala com a Meta.
+ *
+ * **Uma constante, um lugar.** Antes disto o adapter de envio carregava a sua
+ * (`v21.0`, escrita em 2026-08) e qualquer caminho novo escreveria a dele. Duas
+ * versões no mesmo runtime não falham no dia em que divergem — falham no dia em
+ * que a mais velha é desativada, e aí o sintoma é meio sistema parado enquanto
+ * a outra metade funciona, que é o pior formato possível para diagnosticar.
+ *
+ * ── Por que a versão importa mais aqui do que em outras integrações ─────────
+ *
+ * A Meta desativa versões da Graph API por calendário, não por uso: cada uma
+ * vive cerca de dois anos e depois passa a responder erro. `v21.0` é de
+ * 2024-10 e está no fim dessa janela — mantê-la seria agendar uma parada de
+ * canal para uma data que ninguém anotou.
+ *
+ * O valor abaixo foi verificado contra a Graph API em 2026-08-30: `v26.0`
+ * responde, `v27.0` ainda não existe.
+ *
+ * ── Override por ambiente ───────────────────────────────────────────────────
+ *
+ * Existe para rollback sem release: se uma versão nova mudar um contrato que
+ * este código lê, voltar uma casa é uma variável de ambiente e um deploy, não
+ * uma correção de emergência no código.
+ *
+ * O formato é validado. Um valor livre entraria direto na URL — e uma env var
+ * mal digitada viraria um caminho arbitrário no host da Meta.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_GRAPH_API_VERSION = void 0;
+exports.graphApiVersion = graphApiVersion;
+exports.graphUrl = graphUrl;
+exports.DEFAULT_GRAPH_API_VERSION = 'v26.0';
+const VERSION_PATTERN = /^v\d{1,3}\.\d{1,2}$/;
+/**
+ * Versão efetiva. Um valor inválido cai no default em vez de derrubar o
+ * processo: a alternativa é um erro de digitação numa env var parar o boot da
+ * API inteira, e a degradação correta aqui é ignorar a configuração ruim.
+ */
+function graphApiVersion(env = process.env) {
+    const raw = env.WHATSAPP_GRAPH_API_VERSION?.trim();
+    return raw && VERSION_PATTERN.test(raw) ? raw : exports.DEFAULT_GRAPH_API_VERSION;
+}
+/** Base de URL da Graph API. Isolada para que nenhum chamador a monte na mão. */
+function graphUrl(path, env) {
+    const clean = path.startsWith('/') ? path.slice(1) : path;
+    return `https://graph.facebook.com/${graphApiVersion(env)}/${clean}`;
+}
+//# sourceMappingURL=graph.js.map

package/dist/cjs/communication/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../../src/communication/graph.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;AAWH,0CAGC;AAGD,4BAGC;AAlBY,QAAA,yBAAyB,GAAG,OAAO,CAAC;AAEjD,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAE9C;;;;GAIG;AACH,SAAgB,eAAe,CAAC,MAAyB,OAAO,CAAC,GAAG;IAClE,MAAM,GAAG,GAAG,GAAG,CAAC,0BAA0B,EAAE,IAAI,EAAE,CAAC;IACnD,OAAO,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,iCAAyB,CAAC;AAC5E,CAAC;AAED,iFAAiF;AACjF,SAAgB,QAAQ,CAAC,IAAY,EAAE,GAAuB;IAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1D,OAAO,8BAA8B,eAAe,CAAC,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC;AACvE,CAAC"}

package/dist/cjs/communication/idempotency.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildIdempotencyKey = buildIdempotencyKey;
+const node_crypto_1 = require("node:crypto");
+/**
+ * Separador de campos: `US` (unit separator, `0x1F`).
+ *
+ * Escolhido por não ser digitável — com `:` ou `|`, um `subjectRef` que contenha
+ * o separador consegue forjar a chave de outro evento, e isso é colisão por
+ * construção, não por azar. Um id vindo de outro sistema pode conter qualquer
+ * pontuação; nenhum contém um caractere de controle.
+ */
+const SEP = '\u001f';
+function buildIdempotencyKey(input) {
+    const parts = [
+        input.ctx.tenantId,
+        input.ctx.product,
+        input.ctx.brand,
+        input.channel,
+        input.eventType,
+        input.subjectRef,
+        input.templateVersion ?? 'v0',
+    ];
+    return (0, node_crypto_1.createHash)('sha256').update(parts.join(SEP)).digest('hex');
+}
+//# sourceMappingURL=idempotency.js.map

package/dist/cjs/communication/idempotency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.js","sourceRoot":"","sources":["../../../src/communication/idempotency.ts"],"names":[],"mappings":";;AA4CA,kDAWC;AAvDD,6CAAyC;AAkCzC;;;;;;;GAOG;AACH,MAAM,GAAG,GAAG,QAAQ,CAAC;AAErB,SAAgB,mBAAmB,CAAC,KAAuB;IACzD,MAAM,KAAK,GAAG;QACZ,KAAK,CAAC,GAAG,CAAC,QAAQ;QAClB,KAAK,CAAC,GAAG,CAAC,OAAO;QACjB,KAAK,CAAC,GAAG,CAAC,KAAK;QACf,KAAK,CAAC,OAAO;QACb,KAAK,CAAC,SAAS;QACf,KAAK,CAAC,UAAU;QAChB,KAAK,CAAC,eAAe,IAAI,IAAI;KAC9B,CAAC;IACF,OAAO,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACpE,CAAC"}