@baruk/core 0.3.1 → 0.4.2

package/dist/cjs/mail/provider.js

@@ -1,251 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createTransactionalEmailProvider = createTransactionalEmailProvider;
-const dedup_store_js_1 = require("./dedup-store.js");
-const resend_client_js_1 = require("./resend-client.js");
-const sanitize_js_1 = require("./sanitize.js");
-const sender_resolver_js_1 = require("./sender-resolver.js");
-const template_renderer_js_1 = require("./template-renderer.js");
-const types_js_1 = require("./types.js");
-/** Validação prática de endereço (RFC §4 — borda do Provider): local@domínio.tld, sem espaços, um único "@". */
-const EMAIL_PATTERN = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-function isValidEmailAddress(address) {
-    return EMAIL_PATTERN.test(address);
-}
-/**
- * Valida os endereços que o Provider efetivamente usará na chamada ao provider externo
- * (Correção 3 — Auditoria Codex). Roda depois de `from` resolvido, para pegar também
- * remetentes vindos do `SenderResolver`/`defaultFrom`, não só o `input.from` explícito.
+exports.createTransactionalEmailProvider = void 0;
+/*
+ * RE-EXPORT — a implementação vive em `@baruk/communication`.
+ *
+ * Este arquivo era uma cópia da capability `cap.communication.transactional-email`. A
+ * mesma implementação existia aqui e no engine canônico, e duas cópias de um provider de
+ * comunicação divergem: uma ganha a correção, a outra não, e ninguém percebe até um
+ * consumidor receber o comportamento antigo.
+ *
+ * O caminho de import é preservado de propósito: nenhum consumidor muda uma linha.
  */
-function validateAddresses(fields) {
-    const invalidFields = [];
-    if (!isValidEmailAddress(fields.to))
-        invalidFields.push('to');
-    if (!isValidEmailAddress(fields.from))
-        invalidFields.push('from');
-    if (fields.replyTo !== undefined && !isValidEmailAddress(fields.replyTo))
-        invalidFields.push('replyTo');
-    if (invalidFields.length === 0)
-        return undefined;
-    return {
-        code: 'invalid-recipient',
-        message: `Endereço(s) de e-mail inválido(s): ${invalidFields.join(', ')}.`,
-    };
-}
-/**
- * Provider canônico de `cap.communication.transactional-email` (RFC-CAPABILITY-TRANSACTIONAL-EMAIL-001 v0.2).
- * Extensões (`templateRenderer`/`senderResolver`/`hooks`/`dedupStore`) são injetadas na construção,
- * nunca descobertas por convenção (RFC §4.7).
- */
-function createTransactionalEmailProvider(config) {
-    const templateRenderer = config.templateRenderer ?? new template_renderer_js_1.PassthroughTemplateRenderer();
-    const senderResolver = config.senderResolver ?? new sender_resolver_js_1.StaticSenderResolver(config.defaultFrom);
-    const hooks = config.hooks ?? [];
-    const dedupStore = config.dedupStore ?? new dedup_store_js_1.InMemoryDedupStore();
-    const timeoutMs = config.timeoutMs ?? types_js_1.DEFAULT_TIMEOUT_MS;
-    const remoteReservationPollIntervalMs = config.remoteReservationPollIntervalMs ?? types_js_1.DEFAULT_REMOTE_RESERVATION_POLL_INTERVAL_MS;
-    const remoteReservationMaxWaitMs = config.remoteReservationMaxWaitMs ?? types_js_1.DEFAULT_REMOTE_RESERVATION_MAX_WAIT_MS;
-    const apiKey = config.apiKey;
-    /**
-     * Nenhuma chamada ao `DedupStore` (`reserve`/`get`/`set`) pode escapar sem tratamento
-     * (Bloqueador 1 — Certification Round 2: sanitização não pode se limitar ao `DeliveryResult`;
-     * uma implementação de store real — Redis/Postgres — pode lançar erros de rede/conexão cuja
-     * mensagem contém credenciais, ex.: uma connection string). Toda chamada passa por aqui:
-     * nunca propaga a exceção, sempre loga sanitizado, sempre devolve um fallback seguro.
-     */
-    async function safeDedupCall(operation, fn, fallback) {
-        try {
-            return await fn();
-        }
-        catch (err) {
-            (0, sanitize_js_1.logSanitized)(`[transactional-email] DedupStore.${operation} falhou (ignorado):`, errorMessage(err), [apiKey]);
-            return fallback;
-        }
-    }
-    function sleep(ms) {
-        return new Promise((resolve) => setTimeout(resolve, ms));
-    }
-    /**
-     * Aguarda, de forma limitada, o resultado de uma reserva mantida por outra instância/réplica
-     * (`DedupStore` `mode: 'shared'`) — é o mecanismo real de coalescência distribuída (Bloqueador 2).
-     * Nunca espera indefinidamente: `maxWaitMs` limita o tempo total, sempre com um valor determinístico
-     * ao final (achou o resultado, ou desistiu — nunca fica pendurado).
-     */
-    async function waitForRemoteResult(dedupKey, pollIntervalMs, maxWaitMs) {
-        const deadline = Date.now() + maxWaitMs;
-        while (Date.now() < deadline) {
-            await sleep(pollIntervalMs);
-            const entry = await safeDedupCall('get', () => dedupStore.get(dedupKey), null);
-            if (entry)
-                return entry;
-        }
-        return null;
-    }
-    /**
-     * Coalescência local de envios em andamento por `dedupKey` (Bloqueador 2 — Auditoria Codex).
-     * A checagem (`get`) e a reserva (criar e guardar a Promise) acontecem no mesmo trecho
-     * síncrono — sem `await` entre elas — então duas chamadas concorrentes (`Promise.all`)
-     * nunca observam um estado intermediário: a segunda sempre encontra a Promise da primeira
-     * já registrada e aguarda o mesmo resultado, em vez de disparar um segundo envio.
-     * Garantia real: só dentro deste processo Node (mesma instância do Provider). Atomicidade
-     * entre processos/réplicas depende do `dedupStore.reserve` fornecido (RFC §4.2).
-     */
-    const localSendsInFlight = new Map();
-    /** Resolve `from` e renderiza o template com segurança (Correção 4) — nunca deixa exceção escapar do contrato. */
-    function prepareSend(input) {
-        let from;
-        try {
-            from = input.from ?? senderResolver.resolveFrom(input.brand);
-        }
-        catch (err) {
-            (0, sanitize_js_1.logSanitized)('[transactional-email] SenderResolver falhou:', errorMessage(err), [apiKey]);
-            return {
-                status: 'failed',
-                error: { code: 'unknown', message: 'Falha ao resolver o remetente do e-mail.' },
-            };
-        }
-        const addressError = validateAddresses({ to: input.to, from, replyTo: input.replyTo });
-        if (addressError) {
-            return { status: 'failed', error: addressError };
-        }
-        let rendered;
-        try {
-            rendered = templateRenderer.render(input.template, input.data);
-        }
-        catch (err) {
-            (0, sanitize_js_1.logSanitized)('[transactional-email] TemplateRenderer falhou:', errorMessage(err), [apiKey]);
-            return {
-                status: 'failed',
-                error: { code: 'unknown', message: 'Falha ao renderizar o template do e-mail.' },
-            };
-        }
-        return { from, rendered };
-    }
-    async function performSend(input) {
-        const prepared = prepareSend(input);
-        if ('status' in prepared) {
-            return prepared;
-        }
-        return (0, resend_client_js_1.sendViaResend)({
-            apiKey: apiKey,
-            from: prepared.from,
-            to: input.to,
-            replyTo: input.replyTo,
-            tag: input.tag,
-            rendered: prepared.rendered,
-            timeoutMs,
-        });
-    }
-    async function sendDeduplicated(input, dedupKey) {
-        const existingInFlight = localSendsInFlight.get(dedupKey);
-        if (existingInFlight) {
-            return existingInFlight;
-        }
-        const sendPromise = (async () => {
-            try {
-                let reservation = await safeDedupCall('reserve', () => dedupStore.reserve(dedupKey, types_js_1.MIN_DEDUP_WINDOW_MS), { acquired: true });
-                if (!reservation.acquired && reservation.entry) {
-                    return reservation.entry.result;
-                }
-                if (!reservation.acquired) {
-                    // Reserva de outra instância/réplica em andamento, sem resultado ainda disponível
-                    // (só ocorre com um DedupStore `mode: 'shared'` real — `InMemoryDedupStore` nunca
-                    // devolve esse caso, ver seu jsdoc). Bloqueador 2 (Certification Round 2): a versão
-                    // anterior caía direto em `performSend` aqui, reenviando às cegas. Agora espera de
-                    // forma limitada pelo resultado real da outra instância antes de decidir qualquer coisa.
-                    const remoteEntry = await waitForRemoteResult(dedupKey, remoteReservationPollIntervalMs, remoteReservationMaxWaitMs);
-                    if (remoteEntry) {
-                        return remoteEntry.result;
-                    }
-                    // Esgotado o tempo de espera: a reserva remota pode estar órfã (a instância que a
-                    // detinha morreu sem liberar) — tenta assumir. Se o TTL da reserva remota já expirou
-                    // no store, esta chamada adquire; caso contrário, ainda pertence a outra instância viva.
-                    reservation = await safeDedupCall('reserve', () => dedupStore.reserve(dedupKey, types_js_1.MIN_DEDUP_WINDOW_MS), { acquired: true });
-                    if (!reservation.acquired) {
-                        if (reservation.entry) {
-                            return reservation.entry.result;
-                        }
-                        // Ainda sem dono claro após a espera + nova tentativa: nunca reenviar às cegas
-                        // (romperia o invariante de dedup). Falha determinística e retryable — o consumidor
-                        // decide se tenta de novo (RFC §5, taxonomia por retryability).
-                        return {
-                            status: 'failed',
-                            error: {
-                                code: 'provider-unavailable',
-                                message: 'Coordenação de deduplicação não respondeu a tempo; tente novamente.',
-                            },
-                        };
-                    }
-                }
-                // `reservation.acquired === true`: este chamador é o dono do envio.
-                const result = await performSend(input);
-                await safeDedupCall('set', () => dedupStore.set(dedupKey, { result, expiresAt: Date.now() + types_js_1.MIN_DEDUP_WINDOW_MS }), undefined);
-                return result;
-            }
-            finally {
-                localSendsInFlight.delete(dedupKey);
-            }
-        })();
-        localSendsInFlight.set(dedupKey, sendPromise);
-        return sendPromise;
-    }
-    async function sendTransactionalEmail(rawInput) {
-        let input = rawInput;
-        for (const hook of hooks) {
-            if (hook.beforeSend) {
-                input = runSafely(() => hook.beforeSend(input), apiKey) ?? input;
-            }
-        }
-        const startedAt = Date.now();
-        if (!apiKey) {
-            const result = { status: 'skipped' };
-            logOutcome(input, result, startedAt, apiKey);
-            notifyAfterSend(hooks, input, result, apiKey);
-            return result;
-        }
-        const dedupKey = input.idempotencyKey
-            ? (0, dedup_store_js_1.buildDedupKey)(input.to, input.template, input.idempotencyKey)
-            : null;
-        const result = dedupKey ? await sendDeduplicated(input, dedupKey) : await performSend(input);
-        logOutcome(input, result, startedAt, apiKey);
-        notifyAfterSend(hooks, input, result, apiKey);
-        return result;
-    }
-    return { sendTransactionalEmail };
-}
-function errorMessage(err) {
-    return err instanceof Error ? err.message : String(err);
-}
-/**
- * Log estruturado mínimo de observabilidade (validação operacional pré-certificação).
- * Sempre sanitizado — nunca inclui a apiKey nem o corpo bruto do provider (Bloqueador 1).
- * Não inclui identificador de correlação porque o contrato atual (`SendTransactionalEmailInput`)
- * não define um — não é inventado aqui (RFC não estende o contrato nesta correção).
- */
-function logOutcome(input, result, startedAt, apiKey) {
-    (0, sanitize_js_1.logSanitizedInfo)('[transactional-email] outcome', {
-        status: result.status,
-        errorCode: result.error?.code,
-        durationMs: Date.now() - startedAt,
-        template: input.template,
-        deduplicated: Boolean(input.idempotencyKey),
-    }, [apiKey]);
-}
-/** Hooks nunca podem quebrar o envio principal — falha de um hook é ignorada (logada), não propagada. */
-function runSafely(fn, apiKey) {
-    try {
-        return fn();
-    }
-    catch (err) {
-        (0, sanitize_js_1.logSanitized)('[transactional-email] hook falhou (ignorado):', errorMessage(err), [apiKey]);
-        return undefined;
-    }
-}
-function notifyAfterSend(hooks, input, result, apiKey) {
-    for (const hook of hooks) {
-        if (hook.afterSend) {
-            runSafely(() => hook.afterSend(input, result), apiKey);
-        }
-    }
-}
+var communication_1 = require("@baruk/communication");
+Object.defineProperty(exports, "createTransactionalEmailProvider", { enumerable: true, get: function () { return communication_1.createTransactionalEmailProvider; } });
 //# sourceMappingURL=provider.js.map

package/dist/cjs/mail/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/mail/provider.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/mail/provider.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACH,sDAAwE;AAA/D,iIAAA,gCAAgC,OAAA"}

package/dist/cjs/mail/resend.js

@@ -1,21 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sendEmail = sendEmail;
-async function sendEmail(apiKey, msg) {
-    if (!apiKey)
-        return false;
-    try {
-        const res = await fetch('https://api.resend.com/emails', {
-            method: 'POST',
-            headers: { authorization: `Bearer ${apiKey}`, 'content-type': 'application/json' },
-            body: JSON.stringify(msg),
-            // Best-effort com teto: um Resend pendurado não pode segurar o chamador.
-            signal: AbortSignal.timeout(8000),
-        });
-        return res.ok;
-    }
-    catch {
-        return false;
-    }
-}
+exports.sendEmailWithResult = exports.sendEmail = void 0;
+/*
+ * RE-EXPORT — a implementação vive em `@baruk/communication`.
+ *
+ * Este arquivo era uma cópia da capability `cap.communication.transactional-email`. A
+ * mesma implementação existia aqui e no engine canônico, e duas cópias de um provider de
+ * comunicação divergem: uma ganha a correção, a outra não, e ninguém percebe até um
+ * consumidor receber o comportamento antigo.
+ *
+ * O caminho de import é preservado de propósito: nenhum consumidor muda uma linha.
+ */
+var communication_1 = require("@baruk/communication");
+Object.defineProperty(exports, "sendEmail", { enumerable: true, get: function () { return communication_1.sendEmail; } });
+Object.defineProperty(exports, "sendEmailWithResult", { enumerable: true, get: function () { return communication_1.sendEmailWithResult; } });
 //# sourceMappingURL=resend.js.map

package/dist/cjs/mail/resend.js.map

@@ -1 +1 @@
-{"version":3,"file":"resend.js","sourceRoot":"","sources":["../../../src/mail/resend.ts"],"names":[],"mappings":";;AAYA,8BAcC;AAdM,KAAK,UAAU,SAAS,CAAC,MAA0B,EAAE,GAAiB;IAC3E,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,+BAA+B,EAAE;YACvD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAClF,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;YACzB,yEAAyE;YACzE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;SAClC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,EAAE,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"resend.js","sourceRoot":"","sources":["../../../src/mail/resend.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACH,sDAAsE;AAA7D,0GAAA,SAAS,OAAA;AAAE,oHAAA,mBAAmB,OAAA"}

package/dist/cjs/mail/sender-resolver.js

@@ -1,15 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StaticSenderResolver = void 0;
-/** Default — sempre retorna o `from` configurado no Provider, ignorando `brand` (RFC §4.5, precedência 3). */
-class StaticSenderResolver {
-    defaultFrom;
-    constructor(defaultFrom) {
-        this.defaultFrom = defaultFrom;
-    }
-    resolveFrom() {
-        return this.defaultFrom;
-    }
-}
-exports.StaticSenderResolver = StaticSenderResolver;
+/*
+ * RE-EXPORT — a implementação vive em `@baruk/communication`.
+ *
+ * Este arquivo era uma cópia da capability `cap.communication.transactional-email`. A
+ * mesma implementação existia aqui e no engine canônico, e duas cópias de um provider de
+ * comunicação divergem: uma ganha a correção, a outra não, e ninguém percebe até um
+ * consumidor receber o comportamento antigo.
+ *
+ * O caminho de import é preservado de propósito: nenhum consumidor muda uma linha.
+ */
+var communication_1 = require("@baruk/communication");
+Object.defineProperty(exports, "StaticSenderResolver", { enumerable: true, get: function () { return communication_1.StaticSenderResolver; } });
 //# sourceMappingURL=sender-resolver.js.map

package/dist/cjs/mail/sender-resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"sender-resolver.js","sourceRoot":"","sources":["../../../src/mail/sender-resolver.ts"],"names":[],"mappings":";;;AAEA,8GAA8G;AAC9G,MAAa,oBAAoB;IACF;IAA7B,YAA6B,WAAyB;QAAzB,gBAAW,GAAX,WAAW,CAAc;IAAG,CAAC;IAE1D,WAAW;QACT,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;CACF;AAND,oDAMC"}
+{"version":3,"file":"sender-resolver.js","sourceRoot":"","sources":["../../../src/mail/sender-resolver.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACH,sDAA4D;AAAnD,qHAAA,oBAAoB,OAAA"}

package/dist/cjs/mail/template-renderer.js

@@ -1,21 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PassthroughTemplateRenderer = void 0;
-/**
- * Default — escape hatch para consumidores sem motor de template (RFC §4.3, melhoria recomendada).
- * `data` já deve chegar como `{ subject, html, text? }` pronto; `template` é usado só como
- * rótulo opaco (logging/tag), nunca resolvido.
+/*
+ * RE-EXPORT — a implementação vive em `@baruk/communication`.
+ *
+ * Este arquivo era uma cópia da capability `cap.communication.transactional-email`. A
+ * mesma implementação existia aqui e no engine canônico, e duas cópias de um provider de
+ * comunicação divergem: uma ganha a correção, a outra não, e ninguém percebe até um
+ * consumidor receber o comportamento antigo.
+ *
+ * O caminho de import é preservado de propósito: nenhum consumidor muda uma linha.
  */
-class PassthroughTemplateRenderer {
-    render(template, data) {
-        const subject = data['subject'];
-        const html = data['html'];
-        const text = data['text'];
-        if (typeof subject !== 'string' || typeof html !== 'string') {
-            throw new Error(`PassthroughTemplateRenderer: template "${template}" exige data.subject e data.html como string`);
-        }
-        return { subject, html, text: typeof text === 'string' ? text : undefined };
-    }
-}
-exports.PassthroughTemplateRenderer = PassthroughTemplateRenderer;
+var communication_1 = require("@baruk/communication");
+Object.defineProperty(exports, "PassthroughTemplateRenderer", { enumerable: true, get: function () { return communication_1.PassthroughTemplateRenderer; } });
 //# sourceMappingURL=template-renderer.js.map

package/dist/cjs/mail/template-renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"template-renderer.js","sourceRoot":"","sources":["../../../src/mail/template-renderer.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,MAAa,2BAA2B;IACtC,MAAM,CAAC,QAAgB,EAAE,IAA6B;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAE1B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CACb,0CAA0C,QAAQ,8CAA8C,CACjG,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;IAC9E,CAAC;CACF;AAdD,kEAcC"}
+{"version":3,"file":"template-renderer.js","sourceRoot":"","sources":["../../../src/mail/template-renderer.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACH,sDAAmE;AAA1D,4HAAA,2BAA2B,OAAA"}

package/dist/cjs/mail/transactional-outbound.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * A porta ÚNICA de e-mail para os fluxos que não passam pelo motor multicanal.
+ *
+ * ## O bloqueador que este arquivo fecha
+ *
+ * `SINGLE_DISPATCH_AUTHORITY=FAIL`. O guard da rodada anterior varria só
+ * `packages/core/src` e não enxergava o que estava do lado de fora:
+ *
+ *     apps/api/src/routes/admin.ts      → sendEmail(process.env.RESEND_API_KEY, …)
+ *     apps/api/src/routes/documents.ts  → sendEmail(process.env.RESEND_API_KEY, …)
+ *     apps/api/src/routes/auth.ts       → sendEmail(process.env.RESEND_API_KEY, …)
+ *     packages/core/src/subscription-billing/service.ts → sendEmail(cfg.resendApiKey, …)
+ *
+ * Quatro caminhos de APLICAÇÃO chamando o transporte direto, cada um lendo a
+ * credencial e o remetente por conta própria. Não é um cliente provider paralelo
+ * — é o mesmo transporte —, mas é código de domínio alcançando a borda de envio
+ * sem passar por autoridade nenhuma, que é o que o adendo §12 proíbe.
+ *
+ * ## O que ela NÃO é
+ *
+ * **Não é o motor multicanal, e não finge ser.** Convite, reconvite, acesso ao
+ * Portal e recuperação de senha são comunicação de IDENTIDADE: acontecem antes de
+ * existir cliente, antes de existir consentimento de contribuinte, e — no caso do
+ * `forgot-password` — antes de existir sessão de onde tirar um tenant. Passá-los
+ * pelo `dispatch` exigiria inventar `recipientRef`, `subjectRef`, template
+ * aprovado e conta de canal para cada um; a fase que fizer isso é própria, e
+ * `AUTH_EMAIL_NOT_ON_SHARED_ENGINE` fica registrada como dívida.
+ *
+ * O que ela é: um **adapter de entrada** (§13). Fluxo legado sem cliente provider
+ * próprio, com uma porta só, nominal e vigiada.
+ *
+ * ## O que ela acrescenta de verdade
+ *
+ * Uma barreira que só renomeia o caminho não é correção. Estes fluxos ganham,
+ * aqui, três coisas que nenhum deles tinha:
+ *
+ *  1. **Idempotência de provider.** Nenhum dos quatro mandava `Idempotency-Key`.
+ *     Duplo-clique em "convidar" ou retry de cron produzia duas mensagens
+ *     idênticas na caixa de quem recebe. A chave é derivada do CONTEÚDO (ver
+ *     `identityFor`), então retry idêntico dedupe e reconvite legítimo — que
+ *     carrega um token novo — passa.
+ *  2. **Um lugar só para a credencial.** `process.env.RESEND_API_KEY` deixa de
+ *     ser lido em quatro arquivos. Quatro leituras é onde uma delas fica para
+ *     trás no dia da rotação.
+ *  3. **Um alvo só para o guard.** O guard de fronteira global proíbe `sendEmail*`
+ *     em todo o repositório exceto no transporte, nos adapters do motor e aqui.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendTransactionalOutboundWithResult = sendTransactionalOutboundWithResult;
+exports.sendTransactionalOutbound = sendTransactionalOutbound;
+const node_crypto_1 = require("node:crypto");
+const resend_js_1 = require("./resend.js");
+/**
+ * A chave que o provider vai deduplicar.
+ *
+ * Derivada do CONTEÚDO — destinatário, assunto, remetente e corpo — e não de um
+ * identificador de negócio. A escolha decide o comportamento em produção:
+ *
+ *   • retry idêntico (duplo-clique, reexecução de cron) produz a MESMA chave, e o
+ *     Resend devolve a resposta original sem mandar a segunda mensagem;
+ *   • reconvite legítimo carrega um token novo no corpo, logo uma chave nova, e
+ *     sai normalmente.
+ *
+ * Derivar de `kind + destinatário` faria o oposto e seria pior que não ter chave:
+ * o reconvite legítimo seria silenciosamente descartado pelo provider dentro da
+ * janela de 24 h, e ninguém veria — a resposta de um replay é `200`.
+ *
+ * `sha256` hexadecimal, 64 caracteres, dentro do limite de 1 a 256 do provider.
+ */
+function identityFor(req) {
+    /*
+     * Serializado como ARRAY, e não concatenado com um separador.
+     *
+     * Concatenar campos com um caractere qualquer é ambíguo: `to='a b'` com
+     * `from='c'` produz a mesma cadeia que `to='a'` com `from='b c'`, e duas
+     * mensagens diferentes ganhariam a mesma chave — o provider descartaria a
+     * segunda como replay. `JSON.stringify` de um array escapa os campos e o
+     * comprimento fica implícito na estrutura, então nenhum conteúdo consegue
+     * imitar a fronteira entre dois campos.
+     */
+    const material = JSON.stringify([
+        req.kind,
+        req.message.to,
+        req.message.from,
+        req.message.subject,
+        req.message.html,
+        req.message.text ?? null,
+    ]);
+    return (0, node_crypto_1.createHash)('sha256').update(material, 'utf8').digest('hex');
+}
+/**
+ * Envia, com o desfecho detalhado.
+ *
+ * Best-effort como sempre foi: devolve o resultado, nunca lança. Quem chama
+ * decide o que fazer — e continua podendo distinguir "o provider recusou" de "a
+ * mensagem saiu", que é a distinção que fez o Portal ficar meses sem acesso
+ * ativo quando ela não existia.
+ */
+async function sendTransactionalOutboundWithResult(req) {
+    return (0, resend_js_1.sendEmailWithResult)(req.apiKey ?? process.env.RESEND_API_KEY, req.message, {
+        idempotencyKey: identityFor(req),
+        fetchImpl: req.fetchImpl,
+    });
+}
+/**
+ * Envia e devolve só se saiu.
+ *
+ * A forma que os quatro chamadores legados já usavam (`boolean`), preservada para
+ * que a consolidação não mude a resposta de nenhuma rota — nem o `201` do
+ * convite, nem o campo `invitationEmailSent` que a tela lê.
+ */
+async function sendTransactionalOutbound(req) {
+    const result = await sendTransactionalOutboundWithResult(req);
+    return result.ok;
+}
+//# sourceMappingURL=transactional-outbound.js.map

package/dist/cjs/mail/transactional-outbound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional-outbound.js","sourceRoot":"","sources":["../../../src/mail/transactional-outbound.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;;AAuGH,kFAOC;AASD,8DAGC;AAxHD,6CAAyC;AACzC,2CAA2F;AAqD3F;;;;;;;;;;;;;;;;GAgBG;AACH,SAAS,WAAW,CAAC,GAA8B;IACjD;;;;;;;;;OASG;IACH,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAC9B,GAAG,CAAC,IAAI;QACR,GAAG,CAAC,OAAO,CAAC,EAAE;QACd,GAAG,CAAC,OAAO,CAAC,IAAI;QAChB,GAAG,CAAC,OAAO,CAAC,OAAO;QACnB,GAAG,CAAC,OAAO,CAAC,IAAI;QAChB,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI;KACzB,CAAC,CAAC;IACH,OAAO,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACrE,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,mCAAmC,CACvD,GAA8B;IAE9B,OAAO,IAAA,+BAAmB,EAAC,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC,OAAO,EAAE;QAChF,cAAc,EAAE,WAAW,CAAC,GAAG,CAAC;QAChC,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,yBAAyB,CAAC,GAA8B;IAC5E,MAAM,MAAM,GAAG,MAAM,mCAAmC,CAAC,GAAG,CAAC,CAAC;IAC9D,OAAO,MAAM,CAAC,EAAE,CAAC;AACnB,CAAC"}

package/dist/cjs/mail/types.js

@@ -1,38 +1,11 @@
 "use strict";
-// cap.communication.transactional-email — contrato canônico (RFC-CAPABILITY-TRANSACTIONAL-EMAIL-001 v0.2).
-// Ver docs/governance/RFC-CAPABILITY-TRANSACTIONAL-EMAIL-001.md no repo baruk-ecosystem.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_REMOTE_RESERVATION_MAX_WAIT_MS = exports.DEFAULT_REMOTE_RESERVATION_POLL_INTERVAL_MS = exports.DEFAULT_TIMEOUT_MS = exports.MIN_DEDUP_WINDOW_MS = exports.TRANSACTIONAL_EMAIL_CONTRACT_VERSION = void 0;
-exports.isRetryableError = isRetryableError;
-/**
- * Versão do contrato público desta capability (RFC-CAPABILITY-TRANSACTIONAL-EMAIL-001 §12, SemVer próprio
- * de capability — independente da versão do pacote `@baruk/core`, que versiona o motor inteiro, não uma
- * capability isolada). `0.2.1`: hardening pré-certificação (Capability Certification 001, Auditoria Codex)
- * — sanitização de segredos, dedup atômica, validação de endereço, exceções internas contidas. `0.2.2`:
- * hardening pós-Certification Round 2 — sanitização genérica estendida (URI-embedded credentials, token
- * estruturado, alta entropia) e coalescência distribuída real (espera limitada por reserva remota em
- * andamento, nunca reenvio às cegas). Nenhuma das duas mudou assinatura pública (patch, não minor/major).
- */
-exports.TRANSACTIONAL_EMAIL_CONTRACT_VERSION = '0.2.2';
-/** Janela mínima de deduplicação exigida pela RFC §4.2 (24h) — implementações podem manter por mais tempo, nunca menos. */
-exports.MIN_DEDUP_WINDOW_MS = 24 * 60 * 60 * 1000;
-/** Timeout padrão do Provider (RFC §5 — herdado empiricamente da implementação mais madura do inventário). */
-exports.DEFAULT_TIMEOUT_MS = 12_000;
-/**
- * Default de poll ao aguardar uma reserva remota em andamento num `DedupStore` `mode: 'shared'`
- * (Bloqueador 2 — Certification Round 2). Baixo o suficiente para não atrasar percebivelmente
- * o caso comum (reserva local, sem espera nenhuma).
- */
-exports.DEFAULT_REMOTE_RESERVATION_POLL_INTERVAL_MS = 200;
-/**
- * Default de tempo máximo de espera por uma reserva remota antes de tentar assumi-la e,
- * falhando isso, devolver falha determinística retryable (Bloqueador 2 — Certification Round 2).
- * Maior que `DEFAULT_TIMEOUT_MS` — dá à instância dona tempo de terminar o próprio envio
- * (que pode levar até `DEFAULT_TIMEOUT_MS`) antes desta instância desistir de esperar.
- */
-exports.DEFAULT_REMOTE_RESERVATION_MAX_WAIT_MS = 15_000;
-/** Utilitário de conveniência para o consumidor decidir retry — não usado internamente pelo core (RFC §5). */
-function isRetryableError(code) {
-    return code === 'timeout' || code === 'provider-unavailable';
-}
+exports.isRetryableError = exports.DEFAULT_REMOTE_RESERVATION_MAX_WAIT_MS = exports.DEFAULT_REMOTE_RESERVATION_POLL_INTERVAL_MS = exports.TRANSACTIONAL_EMAIL_CONTRACT_VERSION = exports.MIN_DEDUP_WINDOW_MS = exports.DEFAULT_TIMEOUT_MS = void 0;
+var communication_1 = require("@baruk/communication");
+Object.defineProperty(exports, "DEFAULT_TIMEOUT_MS", { enumerable: true, get: function () { return communication_1.DEFAULT_TIMEOUT_MS; } });
+Object.defineProperty(exports, "MIN_DEDUP_WINDOW_MS", { enumerable: true, get: function () { return communication_1.MIN_DEDUP_WINDOW_MS; } });
+Object.defineProperty(exports, "TRANSACTIONAL_EMAIL_CONTRACT_VERSION", { enumerable: true, get: function () { return communication_1.TRANSACTIONAL_EMAIL_CONTRACT_VERSION; } });
+Object.defineProperty(exports, "DEFAULT_REMOTE_RESERVATION_POLL_INTERVAL_MS", { enumerable: true, get: function () { return communication_1.DEFAULT_REMOTE_RESERVATION_POLL_INTERVAL_MS; } });
+Object.defineProperty(exports, "DEFAULT_REMOTE_RESERVATION_MAX_WAIT_MS", { enumerable: true, get: function () { return communication_1.DEFAULT_REMOTE_RESERVATION_MAX_WAIT_MS; } });
+Object.defineProperty(exports, "isRetryableError", { enumerable: true, get: function () { return communication_1.isRetryableError; } });
 //# sourceMappingURL=types.js.map

package/dist/cjs/mail/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/mail/types.ts"],"names":[],"mappings":";AAAA,2GAA2G;AAC3G,yFAAyF;;;AA8JzF,4CAEC;AAnCD;;;;;;;;GAQG;AACU,QAAA,oCAAoC,GAAG,OAAO,CAAC;AAE5D,2HAA2H;AAC9G,QAAA,mBAAmB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEvD,8GAA8G;AACjG,QAAA,kBAAkB,GAAG,MAAM,CAAC;AAEzC;;;;GAIG;AACU,QAAA,2CAA2C,GAAG,GAAG,CAAC;AAE/D;;;;;GAKG;AACU,QAAA,sCAAsC,GAAG,MAAM,CAAC;AAE7D,8GAA8G;AAC9G,SAAgB,gBAAgB,CAAC,IAAuB;IACtD,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,sBAAsB,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/mail/types.ts"],"names":[],"mappings":";;;AA0BA,sDAO8B;AAN5B,mHAAA,kBAAkB,OAAA;AAClB,oHAAA,mBAAmB,OAAA;AACnB,qIAAA,oCAAoC,OAAA;AACpC,4IAAA,2CAA2C,OAAA;AAC3C,uIAAA,sCAAsC,OAAA;AACtC,iHAAA,gBAAgB,OAAA"}