@baruk/core 0.3.1 → 0.5.0

package/dist/communication/stores/postgres.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Reserva de envio e trilha, sobre PostgreSQL.
+ *
+ * O CONTRATO (`claim.ts`, `audit.ts`) é agnóstico de armazenamento. Esta é uma
+ * implementação — a que qualquer produto sobre o schema do Baruk usa —, e ela
+ * mora ao lado do contrato em vez de dentro do produto porque a atomicidade da
+ * reserva é propriedade do MOTOR: um produto que a reimplementasse por conta
+ * própria reintroduziria a janela que ela existe para fechar, e o defeito
+ * apareceria só sob concorrência real.
+ *
+ * **Cada operação abre a própria transação, curta, e commita.**
+ *
+ * Não é detalhe. A régua de cobrança roda o ciclo inteiro dentro de uma
+ * transação longa; se a reserva vivesse nela, ela só ficaria visível para os
+ * outros workers no COMMIT — ou seja, depois de todos os envios. Um segundo
+ * worker ficaria bloqueado no lock da linha durante o ciclo inteiro do primeiro,
+ * e um `statement_timeout` transformaria a proteção em falha de cobrança.
+ *
+ * Commitar a reserva de imediato tem a consequência certa também no caminho
+ * infeliz: se a transação da régua fizer rollback DEPOIS de a mensagem ter
+ * saído, a reserva permanece `sent` — porque a mensagem realmente saiu, e
+ * ressuscitar a chave junto com o rollback mandaria a cobrança de novo.
+ */
+import type { Db, Tx } from '../../db/client.js';
+import type { DispatchClaimStore } from '../claim.js';
+import type { CommunicationAuditSink, CommunicationEvent } from '../audit.js';
+export interface PostgresClaimStoreOptions {
+    /**
+     * Prazo da reserva. Dez minutos por padrão: muito maior que qualquer timeout
+     * de provider (o mais longo aqui é 10 s) e muito menor que o intervalo entre
+     * ciclos da régua (24 h). Encurtá-lo aumenta o risco de duplicata; alongá-lo
+     * aumenta o tempo em que uma etapa fica calada depois de um crash.
+     */
+    ttlMs?: number;
+}
+/**
+ * Store de reserva do tenant.
+ *
+ * Recebe o `Db` (pool), e não uma `Tx`, exatamente para poder abrir transação
+ * própria. Um store que recebesse `Tx` herdaria o tempo de vida da transação de
+ * quem chama — que é o defeito descrito no cabeçalho.
+ */
+export declare function createPostgresDispatchClaimStore(db: Db, tenantId: string, options?: PostgresClaimStoreOptions): DispatchClaimStore;
+/**
+ * Trilha sobre `communication_event`.
+ *
+ * Recebe `Tx` — e aqui a escolha é OPOSTA à da reserva, de propósito. A trilha
+ * descreve o que a transação de negócio fez; se ela commitasse à parte, um
+ * rollback deixaria eventos narrando um envio que o banco desfez. A reserva
+ * precisa sobreviver ao rollback (a mensagem saiu de verdade); a narrativa, não.
+ */
+export declare function createPostgresAuditSink(tx: Tx, tenantId: string): CommunicationAuditSink;
+export interface CommunicationTrailEntry {
+    id: string;
+    kind: CommunicationEvent['kind'];
+    channel: string | null;
+    eventType: string;
+    subjectRef: string | null;
+    recipientRef: string | null;
+    idempotencyKey: string | null;
+    providerRef: string | null;
+    skipReason: string | null;
+    status: string | null;
+    code: string | null;
+    detail: string | null;
+    attempt: number | null;
+    occurredAt: string;
+}
+export interface CommunicationTrailFilter {
+    subjectRef?: string;
+    recipientRef?: string;
+    idempotencyKey?: string;
+    kind?: CommunicationEvent['kind'];
+    limit?: number;
+}
+/**
+ * Leitura da trilha. É o que torna a auditoria CONSULTÁVEL — sem isto, o
+ * registro estruturado seria só uma tabela que ninguém abre.
+ */
+export declare function listCommunicationTrail(tx: Tx, filter?: CommunicationTrailFilter): Promise<CommunicationTrailEntry[]>;
+//# sourceMappingURL=postgres.d.ts.map

package/dist/communication/stores/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../../src/communication/stores/postgres.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,KAAK,EAIV,kBAAkB,EAMnB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAyC9E,MAAM,WAAW,yBAAyB;IACxC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,EAAE,EAAE,EAAE,EACN,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,yBAA8B,GACtC,kBAAkB,CA0YpB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,sBAAsB,CAuBxF;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,EAAE,EACN,MAAM,GAAE,wBAA6B,GACpC,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAgDpC"}

package/dist/communication/stores/postgres.js

@@ -0,0 +1,453 @@
+/**
+ * Reserva de envio e trilha, sobre PostgreSQL.
+ *
+ * O CONTRATO (`claim.ts`, `audit.ts`) é agnóstico de armazenamento. Esta é uma
+ * implementação — a que qualquer produto sobre o schema do Baruk usa —, e ela
+ * mora ao lado do contrato em vez de dentro do produto porque a atomicidade da
+ * reserva é propriedade do MOTOR: um produto que a reimplementasse por conta
+ * própria reintroduziria a janela que ela existe para fechar, e o defeito
+ * apareceria só sob concorrência real.
+ *
+ * **Cada operação abre a própria transação, curta, e commita.**
+ *
+ * Não é detalhe. A régua de cobrança roda o ciclo inteiro dentro de uma
+ * transação longa; se a reserva vivesse nela, ela só ficaria visível para os
+ * outros workers no COMMIT — ou seja, depois de todos os envios. Um segundo
+ * worker ficaria bloqueado no lock da linha durante o ciclo inteiro do primeiro,
+ * e um `statement_timeout` transformaria a proteção em falha de cobrança.
+ *
+ * Commitar a reserva de imediato tem a consequência certa também no caminho
+ * infeliz: se a transação da régua fizer rollback DEPOIS de a mensagem ter
+ * saído, a reserva permanece `sent` — porque a mensagem realmente saiu, e
+ * ressuscitar a chave junto com o rollback mandaria a cobrança de novo.
+ */
+import { randomUUID } from 'node:crypto';
+import { withContext } from '../../db/context.js';
+import { DEFAULT_CLAIM_TTL_MS } from '../claim.js';
+/** Truncagem única para tudo que é texto livre vindo de provider. */
+const MAX_DETAIL = 300;
+const trim = (v) => v === null || v === undefined ? null : v.slice(0, MAX_DETAIL);
+/**
+ * Store de reserva do tenant.
+ *
+ * Recebe o `Db` (pool), e não uma `Tx`, exatamente para poder abrir transação
+ * própria. Um store que recebesse `Tx` herdaria o tempo de vida da transação de
+ * quem chama — que é o defeito descrito no cabeçalho.
+ */
+export function createPostgresDispatchClaimStore(db, tenantId, options = {}) {
+    const ttlSeconds = Math.max(1, Math.round((options.ttlMs ?? DEFAULT_CLAIM_TTL_MS) / 1000));
+    /**
+     * Grava um evento de ciclo de vida na transação que estiver aberta.
+     *
+     * Recebe a `Tx` de quem chama — sempre a mesma transação curta da reserva.
+     * É isso, e só isso, que dá a garantia que a certificação exigiu: `sent` e
+     * `dispatch_sent` caem ou sobrevivem juntos, porque são uma escrita só.
+     */
+    const writeLifecycle = async (tx, ctx, event) => {
+        await tx `
+      INSERT INTO communication_event (
+        id, tenant_id, product, brand, kind, channel, event_type, subject_ref,
+        recipient_ref, idempotency_key, provider_ref, skip_reason, status,
+        code, detail, attempt
+      ) VALUES (
+        ${randomUUID()}, ${tenantId}, ${ctx.product}, ${ctx.brand},
+        ${event.kind}, ${ctx.channel}, ${ctx.eventType}, ${ctx.subjectRef},
+        ${ctx.recipientRef}, ${ctx.idempotencyKey}, ${event.providerRef ?? null},
+        ${event.skipReason ?? null}, ${event.status ?? null},
+        ${trim(event.code)}, ${trim(event.detail)}, ${ctx.attempt}
+      )
+    `;
+    };
+    /**
+     * Recupera o envelope da trilha a partir da própria linha de reserva.
+     *
+     * `settle` recebe só o handle; produto, marca, canal e destinatário vivem na
+     * linha. Ler dali, na mesma transação, evita ter de carregá-los no handle e
+     * evita que o motor possa passar um envelope divergente do que foi reservado —
+     * a trilha descreve o que o banco tem, não o que o chamador lembra.
+     */
+    const envelopeFor = async (tx, claimId) => {
+        const [row] = await tx `
+      SELECT product, brand, channel, event_type, subject_ref, recipient_ref,
+             idempotency_key, attempts
+        FROM communication_dispatch
+       WHERE id = ${claimId}
+       LIMIT 1
+    `;
+        if (!row)
+            return null;
+        return {
+            product: row.product,
+            brand: row.brand,
+            channel: row.channel,
+            eventType: row.event_type,
+            subjectRef: row.subject_ref,
+            recipientRef: row.recipient_ref,
+            idempotencyKey: row.idempotency_key,
+            attempt: row.attempts,
+        };
+    };
+    return {
+        async claim(req) {
+            if (req.ctx.tenantId !== tenantId) {
+                // O store é de UM tenant. Um pedido de outro contexto não é "não
+                // autorizado": é defeito de integração, e devolver `in_flight` o
+                // esconderia atrás de um motivo plausível.
+                throw new Error('claim pedido para tenant diferente do store');
+            }
+            return withContext(db, { tenantId }, async (tx) => {
+                /*
+                 * A operação inteira em UMA instrução.
+                 *
+                 * `INSERT ... ON CONFLICT DO UPDATE ... WHERE` é atômico por
+                 * construção: o segundo worker a chegar bloqueia no lock da linha em
+                 * conflito até o primeiro commitar, e só então reavalia o `WHERE`. Se o
+                 * primeiro deixou a linha `in_flight` dentro do prazo, o `WHERE` do
+                 * segundo é falso, o UPDATE não acontece e o `RETURNING` volta vazio —
+                 * que é a reserva negada.
+                 *
+                 * Escrever isto como SELECT + UPDATE, mesmo dentro de uma transação,
+                 * reabriria a janela sob READ COMMITTED (o padrão): o SELECT de um não
+                 * enxerga o INSERT não commitado do outro.
+                 *
+                 * No SET, `communication_dispatch.status` ainda é o valor ANTIGO — é
+                 * assim que `recovered_from_expired` sabe que a reserva foi tomada de um
+                 * titular vencido em vez de concedida sobre uma falha retentável.
+                 *
+                 * `unknown_outcome` não aparece no `WHERE`, e a ausência é a regra: uma
+                 * chave cujo desfecho ninguém conhece não volta a ser reservável sozinha.
+                 * Sai de lá por `resolveUnknownOutcome`, que é um ato explícito.
+                 *
+                 * `provider_attempts` e `provider_first_attempt_at` NÃO são tocados aqui.
+                 * Por isso o `RETURNING` os devolve com o valor do titular anterior — que
+                 * é exatamente a pergunta que o motor precisa responder antes de decidir
+                 * se pode reenviar.
+                 */
+                const rows = await tx `
+          INSERT INTO communication_dispatch (
+            id, tenant_id, product, brand, channel, event_type, subject_ref,
+            recipient_ref, idempotency_key, status, claim_id, claimed_at,
+            claim_expires_at, recovered_from_expired, attempts
+          ) VALUES (
+            ${randomUUID()}, ${tenantId}, ${req.ctx.product}, ${req.ctx.brand},
+            ${req.channel}, ${req.eventType}, ${req.subjectRef},
+            ${req.recipientRef}, ${req.idempotencyKey}, 'in_flight', ${randomUUID()},
+            now(), now() + make_interval(secs => ${ttlSeconds}), false, 1
+          )
+          ON CONFLICT (tenant_id, idempotency_key) DO UPDATE
+            SET status = 'in_flight',
+                claim_id = ${randomUUID()},
+                claimed_at = now(),
+                claim_expires_at = now() + make_interval(secs => ${ttlSeconds}),
+                recovered_from_expired = (communication_dispatch.status = 'in_flight'),
+                attempts = communication_dispatch.attempts + 1,
+                recipient_ref = ${req.recipientRef},
+                updated_at = now()
+            WHERE communication_dispatch.status = 'failed_retryable'
+               OR (communication_dispatch.status = 'in_flight'
+                   AND communication_dispatch.claim_expires_at <= now())
+          RETURNING id, claim_id, attempts, recovered_from_expired, provider_attempts,
+                    (EXTRACT(EPOCH FROM (now() - provider_first_attempt_at)) * 1000)::bigint
+                      AS provider_first_attempt_age_ms
+        `;
+                const granted = rows[0];
+                if (granted) {
+                    // Retomada de titular vencido que JÁ tinha falado com o provider é
+                    // desfecho desconhecido. Retomada de quem morreu antes disso não é.
+                    const previousReachedProvider = granted.recovered_from_expired && granted.provider_attempts > 0;
+                    const claim = {
+                        claimId: granted.id,
+                        // A GERAÇÃO da reserva, não a linha. `id` é o mesmo para o titular
+                        // vencido e para quem o substituiu; usá-lo como trava deixaria o
+                        // zumbi assentar por cima de quem está enviando agora.
+                        claimToken: granted.claim_id,
+                        idempotencyKey: req.idempotencyKey,
+                        attempt: granted.attempts,
+                        recoveredFromExpiredClaim: granted.recovered_from_expired,
+                        previousAttemptReachedProvider: previousReachedProvider,
+                        providerFirstAttemptAgeMs: granted.provider_first_attempt_age_ms === null
+                            ? null
+                            : Number(granted.provider_first_attempt_age_ms),
+                    };
+                    await writeLifecycle(tx, {
+                        product: req.ctx.product,
+                        brand: req.ctx.brand,
+                        channel: req.channel,
+                        eventType: req.eventType,
+                        subjectRef: req.subjectRef,
+                        recipientRef: req.recipientRef,
+                        idempotencyKey: req.idempotencyKey,
+                        attempt: granted.attempts,
+                    }, {
+                        kind: 'dispatch_claimed',
+                        code: previousReachedProvider
+                            ? 'recovered_unknown_outcome'
+                            : granted.recovered_from_expired
+                                ? 'recovered_from_expired_claim'
+                                : null,
+                    });
+                    return { granted: true, claim };
+                }
+                // Nada foi reservado. O motivo vem da linha que barrou — e cada motivo
+                // leva a uma leitura operacional diferente, então nenhum deles pode
+                // virar um "não deu" genérico.
+                const [current] = await tx `
+          SELECT status, (claim_expires_at <= now()) AS expired
+            FROM communication_dispatch
+           WHERE idempotency_key = ${req.idempotencyKey}
+           LIMIT 1
+        `;
+                if (!current) {
+                    // Linha some entre o INSERT e o SELECT só se alguém a apagou. Não é
+                    // reserva concedida, e afirmar `in_flight` seria inventar um titular.
+                    return { granted: false, reason: 'in_flight', detail: 'estado da reserva indisponível' };
+                }
+                if (current.status === 'sent')
+                    return { granted: false, reason: 'already_sent' };
+                if (current.status === 'failed_permanent') {
+                    return { granted: false, reason: 'permanently_failed' };
+                }
+                if (current.status === 'unknown_outcome') {
+                    return {
+                        granted: false,
+                        reason: 'unknown_outcome',
+                        detail: 'desfecho da tentativa anterior é desconhecido',
+                    };
+                }
+                return { granted: false, reason: 'in_flight' };
+            });
+        },
+        async markProviderAttempt(claim) {
+            return withContext(db, { tenantId }, async (tx) => {
+                /*
+                 * Transação PRÓPRIA e commitada antes da chamada externa.
+                 *
+                 * Se esta gravação vivesse na transação de quem chama, ela ficaria
+                 * invisível até o commit — e o processo que morre no meio é justamente o
+                 * que nunca commita. A marca precisa sobreviver à morte do processo que
+                 * a escreveu, senão ela não marca nada.
+                 *
+                 * `claim_id` na trava: só o titular da geração corrente marca tentativa.
+                 * `status = 'in_flight'`: uma chave assentada não recebe marca nova nem
+                 * quando a geração por acaso coincide (`settle` preserva o `claim_id`).
+                 *
+                 * **O `RETURNING` é a parte nova, e é o bloqueador inteiro.** A trava já
+                 * estava aqui e já funcionava; o que faltava era o motor SABER que ela
+                 * disparou. Sem `RETURNING`, `UPDATE` que casa zero linhas e `UPDATE` que
+                 * casa uma são indistinguíveis para o chamador — e o chamador seguia
+                 * para `adapter.send()` nos dois casos.
+                 */
+                const fenced = await tx `
+          UPDATE communication_dispatch
+             SET provider_attempts = provider_attempts + 1,
+                 provider_first_attempt_at = COALESCE(provider_first_attempt_at, now()),
+                 provider_last_attempt_at = now(),
+                 updated_at = now()
+           WHERE id = ${claim.claimId}
+             AND claim_id = ${claim.claimToken}
+             AND status = 'in_flight'
+          RETURNING id
+        `;
+                // Uma linha atualizada = a geração corrente é a de quem chamou.
+                if (fenced[0])
+                    return { authority: 'held' };
+                /*
+                 * Zero linhas. A DECISÃO já está tomada — foi o `UPDATE` que a tomou,
+                 * atomicamente — e este `SELECT` serve só para o RÓTULO. Não há TOCTOU
+                 * aqui: o que ele lê depois não pode reautorizar um envio que o `UPDATE`
+                 * já recusou.
+                 */
+                const [current] = await tx `
+          SELECT status, (claim_expires_at <= now()) AS expired
+            FROM communication_dispatch
+           WHERE id = ${claim.claimId}
+           LIMIT 1
+        `;
+                if (!current) {
+                    return { authority: 'lost', detail: 'linha de reserva não existe mais' };
+                }
+                if (current.status !== 'in_flight') {
+                    return {
+                        authority: 'already_final',
+                        state: current.status,
+                        detail: `chave já assentada como ${current.status}`,
+                    };
+                }
+                return { authority: 'lost', detail: 'reserva retomada por outra execução' };
+            });
+        },
+        async settle(claim, outcome, event) {
+            await withContext(db, { tenantId }, async (tx) => {
+                /*
+                 * `WHERE claim_id = ...` é a trava que faz o titular vencido não poder
+                 * assentar por cima de quem está enviando agora.
+                 *
+                 * Até a H2 a comparação era por `id` — o identificador da LINHA, que
+                 * sobrevive intacto à retomada. Ou seja: a trava estava escrita no
+                 * comentário e não no código, e o processo que ressuscitava depois do
+                 * prazo assentava por cima do titular novo sem que nada reclamasse. O
+                 * que desqualifica o zumbi é não ter a GERAÇÃO corrente, e é ela que
+                 * entra no `WHERE`.
+                 */
+                const status = outcome.kind === 'sent'
+                    ? 'sent'
+                    : outcome.kind === 'unknown'
+                        ? 'unknown_outcome'
+                        : outcome.kind === 'failed'
+                            ? outcome.permanent
+                                ? 'failed_permanent'
+                                : 'failed_retryable'
+                            : 'failed_retryable';
+                const code = outcome.kind === 'released'
+                    ? outcome.reason
+                    : outcome.kind === 'sent'
+                        ? null
+                        : (outcome.code ?? null);
+                const detail = outcome.kind === 'sent' || outcome.kind === 'released' ? null : outcome.detail;
+                const updated = await tx `
+          UPDATE communication_dispatch
+             SET status = ${status},
+                 settled_at = now(),
+                 sent_at = ${outcome.kind === 'sent' ? tx `now()` : tx `sent_at`},
+                 provider_ref = ${outcome.kind === 'sent'
+                    ? tx `COALESCE(${outcome.providerRef ?? null}, provider_ref)`
+                    : tx `provider_ref`},
+                 -- Enviado e desconhecido mantêm a reserva encerrada; os demais
+                 -- devolvem a chave imediatamente. Esperar o prazo vencer num
+                 -- motivo já conhecido calaria a etapa por dez minutos à toa.
+                 claim_expires_at = ${outcome.kind === 'sent' ? tx `claim_expires_at` : tx `now()`},
+                 last_code = ${trim(code)},
+                 last_detail = ${trim(detail)},
+                 updated_at = now()
+           WHERE id = ${claim.claimId} AND claim_id = ${claim.claimToken}
+          RETURNING id
+        `;
+                // Zumbi recusado: nenhuma linha mudou, e nenhum evento é gravado. Uma
+                // trilha escrita por quem perdeu o direito de agir descreveria um envio
+                // que o titular atual não fez.
+                if (!updated[0])
+                    return;
+                const envelope = await envelopeFor(tx, claim.claimId);
+                if (envelope)
+                    await writeLifecycle(tx, envelope, event);
+            });
+        },
+        async peek(idempotencyKey) {
+            return withContext(db, { tenantId }, async (tx) => {
+                const [row] = await tx `
+          SELECT status, (claim_expires_at <= now()) AS expired
+            FROM communication_dispatch
+           WHERE idempotency_key = ${idempotencyKey}
+           LIMIT 1
+        `;
+                if (!row)
+                    return 'none';
+                // Reserva vencida não é "em andamento": ninguém está com ela. Relatar
+                // `in_flight` faria o ensaio anunciar um envio que já morreu.
+                if (row.status === 'in_flight')
+                    return row.expired ? 'failed_retryable' : 'in_flight';
+                return row.status;
+            });
+        },
+        async resolveUnknownOutcome(idempotencyKey, resolution, detail) {
+            await withContext(db, { tenantId }, async (tx) => {
+                // Só sai de `unknown_outcome`. Aplicar isto sobre uma chave em outro
+                // estado seria uma via lateral para reabrir um envio já assentado — e a
+                // reserva deixaria de ser a única autoridade sobre o direito de enviar.
+                const [row] = await tx `
+          UPDATE communication_dispatch
+             SET status = ${resolution === 'sent' ? 'sent' : 'failed_retryable'},
+                 sent_at = ${resolution === 'sent' ? tx `COALESCE(sent_at, now())` : tx `sent_at`},
+                 settled_at = now(),
+                 claim_expires_at = now(),
+                 last_code = ${`unknown_resolved_${resolution}`},
+                 last_detail = ${trim(detail)},
+                 updated_at = now()
+           WHERE idempotency_key = ${idempotencyKey}
+             AND status = 'unknown_outcome'
+          RETURNING id
+        `;
+                if (!row)
+                    return;
+                const envelope = await envelopeFor(tx, row.id);
+                if (envelope) {
+                    await writeLifecycle(tx, envelope, {
+                        kind: resolution === 'sent' ? 'dispatch_sent' : 'dispatch_failed',
+                        status: resolution === 'sent' ? 'sent' : null,
+                        code: `unknown_resolved_${resolution}`,
+                        detail: detail ?? null,
+                    });
+                }
+            });
+        },
+    };
+}
+/**
+ * Trilha sobre `communication_event`.
+ *
+ * Recebe `Tx` — e aqui a escolha é OPOSTA à da reserva, de propósito. A trilha
+ * descreve o que a transação de negócio fez; se ela commitasse à parte, um
+ * rollback deixaria eventos narrando um envio que o banco desfez. A reserva
+ * precisa sobreviver ao rollback (a mensagem saiu de verdade); a narrativa, não.
+ */
+export function createPostgresAuditSink(tx, tenantId) {
+    return {
+        async record(event) {
+            // Contexto de outro tenant nunca vira linha deste. Silenciar seria pior
+            // que gravar errado, então a checagem existe e falha alto.
+            if (event.ctx.tenantId !== tenantId) {
+                throw new Error('evento de comunicação de tenant diferente do sink');
+            }
+            await tx `
+        INSERT INTO communication_event (
+          id, tenant_id, product, brand, kind, channel, event_type, subject_ref,
+          recipient_ref, idempotency_key, provider_ref, skip_reason, status,
+          code, detail, attempt
+        ) VALUES (
+          ${randomUUID()}, ${tenantId}, ${event.ctx.product}, ${event.ctx.brand},
+          ${event.kind}, ${event.channel}, ${event.eventType}, ${event.subjectRef},
+          ${event.recipientRef}, ${event.idempotencyKey}, ${event.providerRef ?? null},
+          ${event.skipReason ?? null}, ${event.status ?? null},
+          ${trim(event.code)}, ${trim(event.detail)}, ${event.attempt ?? null}
+        )
+      `;
+        },
+    };
+}
+/**
+ * Leitura da trilha. É o que torna a auditoria CONSULTÁVEL — sem isto, o
+ * registro estruturado seria só uma tabela que ninguém abre.
+ */
+export async function listCommunicationTrail(tx, filter = {}) {
+    const limit = Math.min(Math.max(filter.limit ?? 100, 1), 500);
+    const rows = await tx `
+    SELECT id, kind, channel, event_type, subject_ref, recipient_ref,
+           idempotency_key, provider_ref, skip_reason, status, code, detail,
+           attempt, occurred_at
+      FROM communication_event
+     WHERE true
+       ${filter.subjectRef ? tx `AND subject_ref = ${filter.subjectRef}` : tx ``}
+       ${filter.recipientRef ? tx `AND recipient_ref = ${filter.recipientRef}` : tx ``}
+       ${filter.idempotencyKey ? tx `AND idempotency_key = ${filter.idempotencyKey}` : tx ``}
+       ${filter.kind ? tx `AND kind = ${filter.kind}` : tx ``}
+     ORDER BY occurred_at DESC, created_at DESC
+     LIMIT ${limit}
+  `;
+    return rows.map((r) => ({
+        id: r.id,
+        kind: r.kind,
+        channel: r.channel,
+        eventType: r.event_type,
+        subjectRef: r.subject_ref,
+        recipientRef: r.recipient_ref,
+        idempotencyKey: r.idempotency_key,
+        providerRef: r.provider_ref,
+        skipReason: r.skip_reason,
+        status: r.status,
+        code: r.code,
+        detail: r.detail,
+        attempt: r.attempt,
+        occurredAt: r.occurred_at.toISOString(),
+    }));
+}
+//# sourceMappingURL=postgres.js.map

package/dist/communication/stores/postgres.js.map

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