@baruk/core 0.3.1 → 0.5.0

package/dist/communication/idempotency.js

@@ -0,0 +1,23 @@
+import { createHash } from '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';
+export function buildIdempotencyKey(input) {
+    const parts = [
+        input.ctx.tenantId,
+        input.ctx.product,
+        input.ctx.brand,
+        input.channel,
+        input.eventType,
+        input.subjectRef,
+        input.templateVersion ?? 'v0',
+    ];
+    return createHash('sha256').update(parts.join(SEP)).digest('hex');
+}
+//# sourceMappingURL=idempotency.js.map

package/dist/communication/idempotency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.js","sourceRoot":"","sources":["../../src/communication/idempotency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAkCzC;;;;;;;GAOG;AACH,MAAM,GAAG,GAAG,QAAQ,CAAC;AAErB,MAAM,UAAU,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,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACpE,CAAC"}

package/dist/communication/identity.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Identidade de envio — de quem é o número, a conta e o remetente.
+ *
+ * **O motor é compartilhado. A identidade de envio não é.**
+ *
+ * Este é o módulo que carrega a regra mais dura do adendo, e ele existe separado
+ * do adapter de propósito: se cada adapter resolvesse a própria credencial,
+ * "usar a chave central quando o tenant não tem a dele" seria uma linha
+ * conveniente dentro de um `??`, escrita por alguém com pressa, num arquivo que
+ * ninguém revisa duas vezes. Foi exatamente assim que aconteceu no Manga Verde
+ * (`email-channel.provider.ts`, "SaaS hotfix"): o tenant sem chave própria envia
+ * com a chave da plataforma.
+ *
+ * Em e-mail o custo disso é reputação de domínio compartilhada. Em WhatsApp o
+ * custo é a WABA de uma marca respondendo pelo comportamento de outra — com
+ * bloqueio que se propaga para todos os tenants do número.
+ *
+ * Aqui não há fallback. Conta ausente resolve para ausente.
+ */
+import type { ChannelKey } from './channel.js';
+import type { CommunicationContext } from './context.js';
+/**
+ * Uma conta de canal de UM tenant, em UM produto.
+ *
+ * Modelada sobre o que o Manga Verde já provou em banco
+ * (`communication_channel_accounts`: modo de conexão, ciclo de vida, segredo
+ * cifrado por conta) — o desenho é reaproveitado, a implementação não.
+ */
+export interface ChannelAccount {
+    channel: ChannelKey;
+    /** Dono. Comparado em `assertOwnership` — é o que faz o isolamento ser verificável. */
+    tenantId: string;
+    product: string;
+    brand: string;
+    /**
+     * Identidade visível ao destinatário: endereço de e-mail, número em E.164,
+     * nome do remetente. Não é segredo — aparece na tela e na trilha.
+     */
+    senderId: string;
+    /** Nome de exibição, quando o canal suporta. WhatsApp/SMS não suportam. */
+    displayName?: string;
+    /**
+     * Referência LÓGICA da credencial no cofre — o nome, jamais o valor.
+     *
+     * O motor nunca vê o segredo: ele passa a referência ao resolvedor de
+     * credencial na borda do adapter. Um segredo que não entra no domínio não
+     * vaza em log, em erro, em serialização de teste ou em screenshot.
+     */
+    credentialRef: string;
+    /**
+     * Só `active` envia. `pending_validation` existe porque uma conta de WhatsApp
+     * cadastrada e não verificada parece pronta na tela e é recusada pelo provider
+     * — e o operador merece ver a diferença antes da primeira cobrança, não
+     * depois.
+     */
+    status: 'not_configured' | 'pending_validation' | 'active' | 'paused' | 'error';
+    /** Metadado por canal, sem segredo (ex.: `phoneNumberId`, `wabaId`). */
+    meta?: Record<string, string>;
+}
+export type IdentityRejection = 
+/** Nenhuma conta cadastrada para este contexto e canal. */
+'no_account'
+/** Existe, mas não está ativa. */
+ | 'not_active'
+/** Existe e pertence a OUTRO tenant/produto/marca — nunca deve ser usada. */
+ | 'foreign_account';
+export type IdentityResolution = {
+    ok: true;
+    account: ChannelAccount;
+} | {
+    ok: false;
+    reason: IdentityRejection;
+    detail: string;
+};
+/**
+ * Fonte de contas. Implementada pelo produto (banco, config), nunca pelo motor —
+ * o motor não sabe onde as contas do consumidor moram.
+ */
+export interface ChannelAccountStore {
+    find(ctx: CommunicationContext, channel: ChannelKey): Promise<ChannelAccount | null>;
+}
+/**
+ * Roteia a busca de conta por CANAL, entre stores distintos.
+ *
+ * ## Por que isto existe
+ *
+ * Os canais não guardam a conta no mesmo lugar, e não é acidente: o telefone
+ * tem registro canônico próprio (`channel_binding`, migração 0041), criado pelo
+ * onboarding e com chave global de roteamento; o e-mail vive na configuração do
+ * tenant e admite remetente de plataforma.
+ *
+ * Antes disto, o consumidor passava UM store para todos os canais — e o canal
+ * criado pelo onboarding ficava invisível para quem despacha: a tela dizia
+ * "ativo" e o motor teria respondido `no_account`. Um `??` entre os dois stores
+ * resolveria o sintoma e esconderia a política; a precedência por canal é
+ * decisão de arquitetura e precisa ficar legível em quem compõe.
+ *
+ * ## Mecanismo, não política
+ *
+ * Este módulo não sabe QUAL store serve QUAL canal — quem sabe é o produto, e a
+ * decisão aparece no mapa que ele monta.
+ *
+ * **Canal sem rota resolve para ausente, e nunca cai em outro store.** Herdar a
+ * rota de um canal vizinho faria um canal novo nascer usando a conta de e-mail
+ * do escritório — configurado por acidente, com a identidade errada. Um canal
+ * que ninguém roteou entra fechado.
+ */
+export declare function routeAccountsByChannel(routes: Partial<Record<ChannelKey, ChannelAccountStore>>): ChannelAccountStore;
+/**
+ * A conta pertence mesmo a este contexto?
+ *
+ * Checagem redundante por desenho. O `store` do produto já deveria filtrar por
+ * tenant — mas "deveria" é a palavra que precede todo vazamento cross-tenant, e
+ * um store com um `WHERE` esquecido devolveria a conta do vizinho sem que nada
+ * reclamasse. Esta função é a segunda tranca, e é a que os testes de isolamento
+ * exercitam diretamente.
+ */
+export declare function assertOwnership(ctx: CommunicationContext, account: ChannelAccount): boolean;
+/**
+ * Resolve a identidade de envio para um contexto e canal.
+ *
+ * Não há caminho neste código que devolva uma conta de outro contexto, nem uma
+ * conta "da plataforma". Ausência resolve para ausência, e quem chama trata
+ * ausência como canal indisponível — nunca como permissão para improvisar.
+ */
+export declare function resolveIdentity(store: ChannelAccountStore, ctx: CommunicationContext, channel: ChannelKey): Promise<IdentityResolution>;
+//# sourceMappingURL=identity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/communication/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,UAAU,CAAC;IACpB,uFAAuF;IACvF,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,MAAM,EAAE,gBAAgB,GAAG,oBAAoB,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IAChF,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,MAAM,iBAAiB;AAC3B,2DAA2D;AACzD,YAAY;AACd,kCAAkC;GAChC,YAAY;AACd,6EAA6E;GAC3E,iBAAiB,CAAC;AAEtB,MAAM,MAAM,kBAAkB,GAC5B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnG;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,GAAG,EAAE,oBAAoB,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CACtF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC,GACvD,mBAAmB,CAQrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,oBAAoB,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAM3F;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,mBAAmB,EAC1B,GAAG,EAAE,oBAAoB,EACzB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,kBAAkB,CAAC,CA+B7B"}

package/dist/communication/identity.js

@@ -0,0 +1,105 @@
+/**
+ * Identidade de envio — de quem é o número, a conta e o remetente.
+ *
+ * **O motor é compartilhado. A identidade de envio não é.**
+ *
+ * Este é o módulo que carrega a regra mais dura do adendo, e ele existe separado
+ * do adapter de propósito: se cada adapter resolvesse a própria credencial,
+ * "usar a chave central quando o tenant não tem a dele" seria uma linha
+ * conveniente dentro de um `??`, escrita por alguém com pressa, num arquivo que
+ * ninguém revisa duas vezes. Foi exatamente assim que aconteceu no Manga Verde
+ * (`email-channel.provider.ts`, "SaaS hotfix"): o tenant sem chave própria envia
+ * com a chave da plataforma.
+ *
+ * Em e-mail o custo disso é reputação de domínio compartilhada. Em WhatsApp o
+ * custo é a WABA de uma marca respondendo pelo comportamento de outra — com
+ * bloqueio que se propaga para todos os tenants do número.
+ *
+ * Aqui não há fallback. Conta ausente resolve para ausente.
+ */
+/**
+ * Roteia a busca de conta por CANAL, entre stores distintos.
+ *
+ * ## Por que isto existe
+ *
+ * Os canais não guardam a conta no mesmo lugar, e não é acidente: o telefone
+ * tem registro canônico próprio (`channel_binding`, migração 0041), criado pelo
+ * onboarding e com chave global de roteamento; o e-mail vive na configuração do
+ * tenant e admite remetente de plataforma.
+ *
+ * Antes disto, o consumidor passava UM store para todos os canais — e o canal
+ * criado pelo onboarding ficava invisível para quem despacha: a tela dizia
+ * "ativo" e o motor teria respondido `no_account`. Um `??` entre os dois stores
+ * resolveria o sintoma e esconderia a política; a precedência por canal é
+ * decisão de arquitetura e precisa ficar legível em quem compõe.
+ *
+ * ## Mecanismo, não política
+ *
+ * Este módulo não sabe QUAL store serve QUAL canal — quem sabe é o produto, e a
+ * decisão aparece no mapa que ele monta.
+ *
+ * **Canal sem rota resolve para ausente, e nunca cai em outro store.** Herdar a
+ * rota de um canal vizinho faria um canal novo nascer usando a conta de e-mail
+ * do escritório — configurado por acidente, com a identidade errada. Um canal
+ * que ninguém roteou entra fechado.
+ */
+export function routeAccountsByChannel(routes) {
+    return {
+        async find(ctx, channel) {
+            const store = routes[channel];
+            if (!store)
+                return null;
+            return store.find(ctx, channel);
+        },
+    };
+}
+/**
+ * A conta pertence mesmo a este contexto?
+ *
+ * Checagem redundante por desenho. O `store` do produto já deveria filtrar por
+ * tenant — mas "deveria" é a palavra que precede todo vazamento cross-tenant, e
+ * um store com um `WHERE` esquecido devolveria a conta do vizinho sem que nada
+ * reclamasse. Esta função é a segunda tranca, e é a que os testes de isolamento
+ * exercitam diretamente.
+ */
+export function assertOwnership(ctx, account) {
+    return (account.tenantId === ctx.tenantId &&
+        account.product === ctx.product &&
+        account.brand === ctx.brand);
+}
+/**
+ * Resolve a identidade de envio para um contexto e canal.
+ *
+ * Não há caminho neste código que devolva uma conta de outro contexto, nem uma
+ * conta "da plataforma". Ausência resolve para ausência, e quem chama trata
+ * ausência como canal indisponível — nunca como permissão para improvisar.
+ */
+export async function resolveIdentity(store, ctx, channel) {
+    const account = await store.find(ctx, channel);
+    if (!account) {
+        return {
+            ok: false,
+            reason: 'no_account',
+            detail: `sem conta de ${channel} para este tenant/produto`,
+        };
+    }
+    if (!assertOwnership(ctx, account)) {
+        // Não é só recusar: é recusar ALTO. Um store devolvendo conta alheia é
+        // defeito de isolamento, não configuração faltando, e os dois não podem
+        // aparecer com o mesmo rótulo na trilha.
+        return {
+            ok: false,
+            reason: 'foreign_account',
+            detail: `conta de ${channel} não pertence a este contexto`,
+        };
+    }
+    if (account.status !== 'active') {
+        return {
+            ok: false,
+            reason: 'not_active',
+            detail: `conta de ${channel} em estado ${account.status}`,
+        };
+    }
+    return { ok: true, account };
+}
+//# sourceMappingURL=identity.js.map

package/dist/communication/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/communication/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AA+DH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAwD;IAExD,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,GAAyB,EAAE,OAAmB;YACvD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;YAC9B,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC;YACxB,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,GAAyB,EAAE,OAAuB;IAChF,OAAO,CACL,OAAO,CAAC,QAAQ,KAAK,GAAG,CAAC,QAAQ;QACjC,OAAO,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO;QAC/B,OAAO,CAAC,KAAK,KAAK,GAAG,CAAC,KAAK,CAC5B,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAA0B,EAC1B,GAAyB,EACzB,OAAmB;IAEnB,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAE/C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,YAAY;YACpB,MAAM,EAAE,gBAAgB,OAAO,2BAA2B;SAC3D,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC;QACnC,uEAAuE;QACvE,wEAAwE;QACxE,yCAAyC;QACzC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,iBAAiB;YACzB,MAAM,EAAE,YAAY,OAAO,+BAA+B;SAC3D,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,YAAY;YACpB,MAAM,EAAE,YAAY,OAAO,cAAc,OAAO,CAAC,MAAM,EAAE;SAC1D,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC"}

package/dist/communication/index.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Motor de comunicação compartilhado do ecossistema.
+ *
+ * Consumidores: SC Organização Contábil (primeiro, piloto), e por desenho
+ * Dental Plataforma, Manga Verde, Baruk Connect e o que vier. O motor é um; a
+ * identidade de envio de cada um nunca é compartilhada — ver `identity.ts`.
+ */
+export { CHANNEL_ACCEPTS, CHANNEL_KEYS, channelAccepts, resolveChannel, unavailableChannel, } from './channel.js';
+export type { ChannelKey, ChannelRegistry, CommunicationChannel, DeliveryOutcome, DeliveryOutcomeKind, MessageContent, OutboundMessage, } from './channel.js';
+export { contextRef, validateContext } from './context.js';
+export type { BrandKey, CommunicationContext, ContextRejection, ProductKey } from './context.js';
+export { NO_PROVIDER_GUARANTEES, providerIdempotencyCovers, RESEND_IDEMPOTENCY_WINDOW_MS, } from './capabilities.js';
+export type { ChannelCapabilities } from './capabilities.js';
+export { buildIdempotencyKey } from './idempotency.js';
+export type { IdempotencyInput } from './idempotency.js';
+export { createInMemoryDispatchClaimStore, DEFAULT_CLAIM_TTL_MS } from './claim.js';
+export type { ClaimRefusal, ClaimResult, ClaimSettlement, DispatchClaimHandle, DispatchClaimRequest, DispatchClaimStore, DispatchKeyState, DispatchLifecycleEvent, InMemoryClaimStoreOptions, ProviderAttemptFence, UnknownResolution, } from './claim.js';
+export { createPostgresAuditSink, createPostgresDispatchClaimStore, listCommunicationTrail, } from './stores/postgres.js';
+export type { CommunicationTrailEntry, CommunicationTrailFilter, PostgresClaimStoreOptions, } from './stores/postgres.js';
+export { createNullAuditSink, createRecordingAuditSink, eventKindForSkip } from './audit.js';
+export type { CommunicationAuditSink, CommunicationEvent, CommunicationEventKind, } from './audit.js';
+export { assertOwnership, resolveIdentity, routeAccountsByChannel } from './identity.js';
+export { credentialResolverFor, resolveSenderProfile, withSenderFallback, } from './sender-profile.js';
+export type { PlatformSenderFallback, ResolvedSenderProfile, SenderFallbackPolicy, SenderOrigin, SenderRejection, SenderResolution, } from './sender-profile.js';
+export type { ChannelAccount, ChannelAccountStore, IdentityRejection, IdentityResolution, } from './identity.js';
+export { evaluateConsent } from './consent.js';
+export type { ConsentDecision, ConsentPolicy, ConsentRecord, ConsentSource, ConsentState, ConsentStore, UnknownPolicy, } from './consent.js';
+export { orderVariables, resolveTemplate } from './template.js';
+export type { TemplateKey, TemplateRecord, TemplateRejection, TemplateResolution, TemplateStatus, TemplateStore, } from './template.js';
+export { DEFAULT_POLICY as DEFAULT_CHANNEL_POLICY } from './policy.js';
+export type { ChannelAttempt, ChannelPolicy, SkipReason } from './policy.js';
+export { CHANNEL_REPORTS, advanceStatus, channelReports, isRetryable, statusForOutcome, } from './status.js';
+export type { DeliveryStatus } from './status.js';
+export { dispatch } from './engine.js';
+export type { CommunicationIntent, DispatchDeps, DispatchOptions, DispatchResult, } from './engine.js';
+export { emptyDryRunReport, formatDryRunReport, summarizeDryRun } from './dry-run.js';
+export type { DryRunReport } from './dry-run.js';
+export { applyDeliveryEvent, deliveryEventId, parseMetaDeliveryWebhook, parseMetaInboundOptOut, parseMetaWebhookOrigins, verifyMetaChallenge, verifyMetaSignature, } from './webhook.js';
+export type { DeliveryEvent, InboundOptOut, WebhookApplication } from './webhook.js';
+export { createEmailChannel } from './adapters/email.js';
+export type { EmailAdapterConfig } from './adapters/email.js';
+export { createWhatsAppChannel } from './adapters/whatsapp.js';
+export type { WhatsAppAdapterConfig } from './adapters/whatsapp.js';
+export { countSegments, createRecordingSmsTransport, createSmsChannel, isGsm7, } from './adapters/sms.js';
+export type { SmsAdapterConfig, SmsSendRequest, SmsTransport, SmsTransportResult, } from './adapters/sms.js';
+export { resolveRoute, sameOrigin } from './routing.js';
+export type { ChannelRoute, ChannelRouteStore, RoutedProvider, RouteRejection, RouteResolution, WebhookOrigin, } from './routing.js';
+export { createChannelCredentialResolver, isAcceptableForNewBinding, isVaultRef, noCredentialResolver, } from './credentials.js';
+export type { TenantSecretStore } from './credentials.js';
+export { createPostgresTenantSecretStore, VAULT_DECRYPT_PERMISSION } from './stores/secrets.js';
+export type { SecretAccessGrant, SecretAccessReason, TenantSecretStoreOptions, } from './stores/secrets.js';
+export { ChannelRouteConflictError, CredentialRefNotAcceptableError, completeRoute, createPostgresChannelBindingStore, createPostgresChannelRouteStore, registerChannelBinding, } from './stores/routing.js';
+export type { RegisterBindingInput } from './stores/routing.js';
+export { createWhatsAppTemplateProvider } from './adapters/whatsapp-templates.js';
+export { metaLanguageCode } from './adapters/whatsapp-language.js';
+export { readAppSettings, readAppSubscriptions, readWabaSubscribedApps, sendWebhookTestEvent, } from './webhook-subscription.js';
+export type { AppSettings, AppSubscription, SubscribedApp, SubscriptionProbe, SubscriptionRejection, } from './webhook-subscription.js';
+export type { TemplateCategory, TemplateManagementProvider, TemplateSubmission, TemplateSubmissionRejection, TemplateSubmissionResult, } from './template-provider.js';
+export { DEFAULT_GRAPH_API_VERSION, graphApiVersion, graphUrl } from './graph.js';
+export { createSignupState, exchangeSignupCode, hashSignupState, listWabaTemplates, readPhoneNumber, registerPhoneNumber, sameStateHash, subscribeAppToWaba, } from './onboarding.js';
+export type { BusinessToken, GraphClientOptions, MetaTemplate, PhoneNumberState, RegisterPhoneNumberInput, RegisterRejection, SignupFailure, SignupResult, SignupState, } from './onboarding.js';
+export { consumeOnboardingSession, failOnboardingSession, latestOnboardingSession, ONBOARDING_SESSION_TTL_MS, openOnboardingSession, recordOnboardingAssets, } from './stores/onboarding.js';
+export type { ConsumeResult, OnboardingSession } from './stores/onboarding.js';
+export { claimChannelAccount } from './stores/routing.js';
+export type { ClaimChannelAccountInput, ClaimedChannelAccount } from './stores/routing.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/communication/index.js

@@ -0,0 +1,42 @@
+/**
+ * Motor de comunicação compartilhado do ecossistema.
+ *
+ * Consumidores: SC Organização Contábil (primeiro, piloto), e por desenho
+ * Dental Plataforma, Manga Verde, Baruk Connect e o que vier. O motor é um; a
+ * identidade de envio de cada um nunca é compartilhada — ver `identity.ts`.
+ */
+export { CHANNEL_ACCEPTS, CHANNEL_KEYS, channelAccepts, resolveChannel, unavailableChannel, } from './channel.js';
+export { contextRef, validateContext } from './context.js';
+export { NO_PROVIDER_GUARANTEES, providerIdempotencyCovers, RESEND_IDEMPOTENCY_WINDOW_MS, } from './capabilities.js';
+export { buildIdempotencyKey } from './idempotency.js';
+export { createInMemoryDispatchClaimStore, DEFAULT_CLAIM_TTL_MS } from './claim.js';
+export { createPostgresAuditSink, createPostgresDispatchClaimStore, listCommunicationTrail, } from './stores/postgres.js';
+export { createNullAuditSink, createRecordingAuditSink, eventKindForSkip } from './audit.js';
+export { assertOwnership, resolveIdentity, routeAccountsByChannel } from './identity.js';
+export { credentialResolverFor, resolveSenderProfile, withSenderFallback, } from './sender-profile.js';
+export { evaluateConsent } from './consent.js';
+export { orderVariables, resolveTemplate } from './template.js';
+export { DEFAULT_POLICY as DEFAULT_CHANNEL_POLICY } from './policy.js';
+export { CHANNEL_REPORTS, advanceStatus, channelReports, isRetryable, statusForOutcome, } from './status.js';
+export { dispatch } from './engine.js';
+export { emptyDryRunReport, formatDryRunReport, summarizeDryRun } from './dry-run.js';
+export { applyDeliveryEvent, deliveryEventId, parseMetaDeliveryWebhook, parseMetaInboundOptOut, parseMetaWebhookOrigins, verifyMetaChallenge, verifyMetaSignature, } from './webhook.js';
+export { createEmailChannel } from './adapters/email.js';
+export { createWhatsAppChannel } from './adapters/whatsapp.js';
+export { countSegments, createRecordingSmsTransport, createSmsChannel, isGsm7, } from './adapters/sms.js';
+export { resolveRoute, sameOrigin } from './routing.js';
+export { createChannelCredentialResolver, isAcceptableForNewBinding, isVaultRef, noCredentialResolver, } from './credentials.js';
+export { createPostgresTenantSecretStore, VAULT_DECRYPT_PERMISSION } from './stores/secrets.js';
+export { ChannelRouteConflictError, CredentialRefNotAcceptableError, completeRoute, createPostgresChannelBindingStore, createPostgresChannelRouteStore, registerChannelBinding, } from './stores/routing.js';
+export { createWhatsAppTemplateProvider } from './adapters/whatsapp-templates.js';
+// Tradução do código de idioma para a grafia da Meta. Ponto ÚNICO: submissão e
+// despacho divergiram uma vez, e o primeiro envio real morreu nisso.
+export { metaLanguageCode } from './adapters/whatsapp-language.js';
+// Diagnóstico da assinatura de webhooks. LEITURA PURA — a correção da
+// assinatura do app é mutação externa e não mora numa rota de diagnóstico.
+export { readAppSettings, readAppSubscriptions, readWabaSubscribedApps, sendWebhookTestEvent, } from './webhook-subscription.js';
+export { DEFAULT_GRAPH_API_VERSION, graphApiVersion, graphUrl } from './graph.js';
+export { createSignupState, exchangeSignupCode, hashSignupState, listWabaTemplates, readPhoneNumber, registerPhoneNumber, sameStateHash, subscribeAppToWaba, } from './onboarding.js';
+export { consumeOnboardingSession, failOnboardingSession, latestOnboardingSession, ONBOARDING_SESSION_TTL_MS, openOnboardingSession, recordOnboardingAssets, } from './stores/onboarding.js';
+export { claimChannelAccount } from './stores/routing.js';
+//# sourceMappingURL=index.js.map

package/dist/communication/index.js.map

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

package/dist/communication/onboarding.d.ts

@@ -0,0 +1,223 @@
+/**
+ * Onboarding de conta de canal — Embedded Signup da Meta.
+ *
+ * Este módulo é a fronteira entre "o operador clicou em Conectar" e "existe um
+ * vínculo de canal com credencial no cofre". Ele não escreve no banco e não lê
+ * configuração: recebe o que precisa e devolve o que descobriu, para que o
+ * produto decida o que persistir.
+ *
+ * ── A regra que este arquivo existe para cumprir ────────────────────────────
+ *
+ * **Nenhum token é digitado por humano.** O caminho anterior — e o que ainda
+ * está no cofre desta casa, sob `PROPOSAL_COMM_WA_ACCESS_TOKEN` — é um token de
+ * USUÁRIO gerado no painel da Meta e colado numa variável de ambiente. Ele
+ * expirou em 2026-07-21 e derrubou o canal sem que nada avisasse, porque um
+ * token colado não tem dono, não tem renovação e não tem trilha: ninguém sabe
+ * quem o gerou nem quando ele morre.
+ *
+ * **Aquela credencial é de OUTRO app** — "Baruk Communication Sandbox", do motor
+ * de propostas — e **não deve ser reutilizada aqui em hipótese nenhuma**. O app
+ * canônico deste caminho é o "Baruk Comunicação". A distinção está escrita
+ * porque os dois têm nome parecido e a mesma cara no cofre, e reaproveitar o
+ * errado é a regressão mais barata de cometer nesta frente.
+ *
+ * O Embedded Signup devolve, para o servidor, um `code` trocável por um
+ * **business integration system user access token** — escopado ao cliente que
+ * autorizou, de vida longa, revogável por ele, e que nunca passa pelo teclado
+ * de ninguém.
+ *
+ * ── O que NÃO está aqui ─────────────────────────────────────────────────────
+ *
+ * O `client_secret` do App. Ele entra por parâmetro, vindo do ambiente do
+ * processo, e nunca é logado, devolvido nem embutido em mensagem de erro. Pelo
+ * mesmo motivo, nenhuma função deste arquivo devolve a mensagem de erro da
+ * Meta: ela carrega, com frequência, o nome e o identificador do negócio do
+ * cliente — que é PII de terceiro dentro de um log nosso.
+ */
+/**
+ * State de uma sessão de onboarding.
+ *
+ * `state` vai para o navegador; `stateHash` vai para o banco. A separação é o
+ * que impede a tabela de virar uma lista de chaves válidas — ver a migração
+ * 0044.
+ */
+export interface SignupState {
+    state: string;
+    stateHash: string;
+}
+/**
+ * 32 bytes de aleatoriedade criptográfica.
+ *
+ * Não é um uuid de propósito: um uuidv7 carrega o instante de criação e é
+ * parcialmente previsível, e a única função deste valor é ser impossível de
+ * adivinhar.
+ */
+export declare function createSignupState(): SignupState;
+export declare function hashSignupState(state: string): string;
+/**
+ * Comparação de hashes em tempo constante.
+ *
+ * A busca no banco é por igualdade de índice e já vaza tempo por natureza; esta
+ * função existe para o segundo confronto, feito em memória depois da leitura,
+ * onde a comparação ingênua compara byte a byte e para no primeiro que difere.
+ */
+export declare function sameStateHash(a: string, b: string): boolean;
+/**
+ * Falhas possíveis. **Classes, nunca a mensagem da Meta.**
+ *
+ * A distinção que importa para quem opera é a mesma do adapter de envio:
+ * problema de configuração NOSSA (`unauthorized_app`), problema do fluxo do
+ * cliente (`invalid_code`), ou infraestrutura (`network`, `rate_limited`) — e
+ * cada uma leva a uma ação diferente na tela.
+ */
+export type SignupFailure = 
+/** O `code` não serve: já foi trocado, expirou, ou não é deste App. */
+'invalid_code'
+/** App id/secret errados ou App sem permissão. Pendência do escritório-mãe. */
+ | 'unauthorized_app'
+/** Limite de taxa da Meta. Vale tentar de novo. */
+ | 'rate_limited'
+/** Timeout, DNS, TLS. Não diz nada sobre o `code`. */
+ | 'network'
+/** Qualquer outra recusa do provider. */
+ | 'provider_error';
+export type SignupResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    reason: SignupFailure;
+};
+export interface GraphClientOptions {
+    /** Injetável para teste. **Nenhum teste deve alcançar a rede real.** */
+    fetchImpl?: typeof fetch;
+    env?: NodeJS.ProcessEnv;
+    timeoutMs?: number;
+}
+export interface ExchangeSignupCodeInput {
+    code: string;
+    appId: string;
+    appSecret: string;
+}
+export interface BusinessToken {
+    /** O segredo. Vai direto para o cofre — nunca para log, resposta HTTP ou tela. */
+    accessToken: string;
+    /**
+     * Segundos até expirar, quando a Meta informa.
+     *
+     * **A vida do token é decidida pela CONFIGURAÇÃO de Embedded Signup, não pelo
+     * código.** A configuração canônica desta casa — "Configuração do cadastro
+     * incorporado do WhatsApp com token de expiração em 60 dias" — emite token de
+     * usuário do sistema com **60 dias** de validade. Existe variação sem
+     * expiração; não é a que está em uso, e supor a errada aqui significaria não
+     * gravar `expires_at` no cofre e descobrir o vencimento por uma cobrança que
+     * não saiu.
+     *
+     * `undefined` significa que a Meta não informou — e aí o cofre guarda a
+     * credencial sem vencimento, que é o comportamento correto para "não sei",
+     * não para "não expira".
+     */
+    expiresInSeconds?: number;
+}
+/**
+ * Troca o `code` do Embedded Signup pelo token de negócio do cliente.
+ *
+ * **Server-to-server, sempre.** O `client_secret` do App não pode existir no
+ * navegador: quem o tiver consegue trocar códigos de qualquer cliente e falar
+ * pela conta dele. É por isso que o front devolve `code` e não token, e é por
+ * isso que esta função vive no servidor.
+ */
+export declare function exchangeSignupCode(input: ExchangeSignupCodeInput, opts?: GraphClientOptions): Promise<SignupResult<BusinessToken>>;
+/**
+ * Assina o App do motor nos webhooks da WABA do cliente.
+ *
+ * Sem isto o vínculo existe, o envio funciona e **nenhum status volta**: a
+ * mensagem fica presa em `sent` para sempre e a tela do escritório não sabe
+ * dizer se o cliente recebeu. É a diferença entre um canal que funciona e um
+ * canal que parece funcionar.
+ *
+ * Idempotente do lado da Meta — assinar duas vezes não é erro.
+ */
+export declare function subscribeAppToWaba(input: {
+    wabaId: string;
+    accessToken: string;
+}, opts?: GraphClientOptions): Promise<SignupResult<{
+    subscribed: boolean;
+}>>;
+export interface PhoneNumberState {
+    /** E.164 como a Meta o mostra. Identidade visível, não segredo. */
+    displayPhoneNumber?: string;
+    verifiedName?: string;
+    /** `VERIFIED` | `NOT_VERIFIED` | `EXPIRED` — verificação do NÚMERO. */
+    codeVerificationStatus?: string;
+    /** `CONNECTED` | `PENDING` | `FLAGGED` | `RESTRICTED` etc. */
+    status?: string;
+    qualityRating?: string;
+    /** A conta já está registrada na Cloud API? */
+    platformType?: string;
+}
+/**
+ * Estado do número, do ponto de vista da Meta.
+ *
+ * Leitura pura. É o que permite à tela dizer `attention_required` com um motivo
+ * — "número não verificado", "conta restrita" — em vez do genérico "erro", que
+ * obriga o escritório a abrir o painel da Meta para descobrir o quê.
+ */
+export declare function readPhoneNumber(input: {
+    phoneNumberId: string;
+    accessToken: string;
+}, opts?: GraphClientOptions): Promise<SignupResult<PhoneNumberState>>;
+export interface MetaTemplate {
+    name: string;
+    language: string;
+    /** APPROVED | PENDING | REJECTED | PAUSED | DISABLED, conforme a Meta. */
+    status: string;
+    category?: string;
+}
+/**
+ * Lista os templates da WABA do cliente. **Somente leitura.**
+ *
+ * Existe porque `approvedEvents` é uma lista mantida à mão em
+ * `tenant.settings`, e uma lista declarada por humano diverge da realidade da
+ * Meta no dia em que alguém aprova, pausa ou reprova um template lá. Um template
+ * marcado "aprovado" aqui e reprovado lá gasta a tentativa de envio e volta erro
+ * permanente — que a régua interpreta como problema do destinatário.
+ *
+ * Devolver a lista permite que a decisão de configurar `approvedEvents` seja
+ * tomada contra o que a Meta diz, e não contra o que alguém lembrou.
+ */
+export declare function listWabaTemplates(input: {
+    wabaId: string;
+    accessToken: string;
+}, opts?: GraphClientOptions): Promise<SignupResult<MetaTemplate[]>>;
+export interface RegisterPhoneNumberInput {
+    phoneNumberId: string;
+    accessToken: string;
+    /** PIN de verificação em duas etapas, 6 dígitos. Segredo do cliente. */
+    pin: string;
+    /**
+     * Sem isto, nada acontece.
+     *
+     * Registrar um número o move para a Cloud API e o **desconecta do aplicativo
+     * WhatsApp Business** que o cliente talvez esteja usando para atender. É uma
+     * alteração no negócio de outra pessoa, e ela não pode ser efeito colateral
+     * de um passo de configuração. O padrão `false` faz esquecer de autorizar
+     * falhar fechado.
+     */
+    authorized?: boolean;
+}
+export type RegisterRejection = SignupFailure | 'not_authorized' | 'invalid_pin';
+/**
+ * Registra o número do cliente na Cloud API.
+ *
+ * Implementado e **não chamado** por nenhum caminho automático desta fase. O
+ * gate de autorização humana está no parâmetro, e não numa convenção de
+ * chamada: uma trava que depende de ninguém chamar a função errada não é trava.
+ */
+export declare function registerPhoneNumber(input: RegisterPhoneNumberInput, opts?: GraphClientOptions): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    reason: RegisterRejection;
+}>;
+//# sourceMappingURL=onboarding.d.ts.map

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

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