@baruk/core 0.3.1 → 0.5.0

package/dist/cjs/communication/graph.js

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

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

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

package/dist/cjs/communication/idempotency.js

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

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

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

package/dist/cjs/communication/identity.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.routeAccountsByChannel = routeAccountsByChannel;
+exports.assertOwnership = assertOwnership;
+exports.resolveIdentity = resolveIdentity;
+/**
+ * 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.
+ */
+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.
+ */
+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.
+ */
+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/cjs/communication/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../../src/communication/identity.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;AAyFH,wDAUC;AAWD,0CAMC;AASD,0CAmCC;AAjGD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,SAAgB,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,SAAgB,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;AACI,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/cjs/communication/index.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * 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`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSmsChannel = exports.createRecordingSmsTransport = exports.countSegments = exports.createWhatsAppChannel = exports.createEmailChannel = exports.verifyMetaSignature = exports.verifyMetaChallenge = exports.parseMetaWebhookOrigins = exports.parseMetaInboundOptOut = exports.parseMetaDeliveryWebhook = exports.deliveryEventId = exports.applyDeliveryEvent = exports.summarizeDryRun = exports.formatDryRunReport = exports.emptyDryRunReport = exports.dispatch = exports.statusForOutcome = exports.isRetryable = exports.channelReports = exports.advanceStatus = exports.CHANNEL_REPORTS = exports.DEFAULT_CHANNEL_POLICY = exports.resolveTemplate = exports.orderVariables = exports.evaluateConsent = exports.withSenderFallback = exports.resolveSenderProfile = exports.credentialResolverFor = exports.routeAccountsByChannel = exports.resolveIdentity = exports.assertOwnership = exports.eventKindForSkip = exports.createRecordingAuditSink = exports.createNullAuditSink = exports.listCommunicationTrail = exports.createPostgresDispatchClaimStore = exports.createPostgresAuditSink = exports.DEFAULT_CLAIM_TTL_MS = exports.createInMemoryDispatchClaimStore = exports.buildIdempotencyKey = exports.RESEND_IDEMPOTENCY_WINDOW_MS = exports.providerIdempotencyCovers = exports.NO_PROVIDER_GUARANTEES = exports.validateContext = exports.contextRef = exports.unavailableChannel = exports.resolveChannel = exports.channelAccepts = exports.CHANNEL_KEYS = exports.CHANNEL_ACCEPTS = void 0;
+exports.claimChannelAccount = exports.recordOnboardingAssets = exports.openOnboardingSession = exports.ONBOARDING_SESSION_TTL_MS = exports.latestOnboardingSession = exports.failOnboardingSession = exports.consumeOnboardingSession = exports.subscribeAppToWaba = exports.sameStateHash = exports.registerPhoneNumber = exports.readPhoneNumber = exports.listWabaTemplates = exports.hashSignupState = exports.exchangeSignupCode = exports.createSignupState = exports.graphUrl = exports.graphApiVersion = exports.DEFAULT_GRAPH_API_VERSION = exports.sendWebhookTestEvent = exports.readWabaSubscribedApps = exports.readAppSubscriptions = exports.readAppSettings = exports.metaLanguageCode = exports.createWhatsAppTemplateProvider = exports.registerChannelBinding = exports.createPostgresChannelRouteStore = exports.createPostgresChannelBindingStore = exports.completeRoute = exports.CredentialRefNotAcceptableError = exports.ChannelRouteConflictError = exports.VAULT_DECRYPT_PERMISSION = exports.createPostgresTenantSecretStore = exports.noCredentialResolver = exports.isVaultRef = exports.isAcceptableForNewBinding = exports.createChannelCredentialResolver = exports.sameOrigin = exports.resolveRoute = exports.isGsm7 = void 0;
+var channel_js_1 = require("./channel.js");
+Object.defineProperty(exports, "CHANNEL_ACCEPTS", { enumerable: true, get: function () { return channel_js_1.CHANNEL_ACCEPTS; } });
+Object.defineProperty(exports, "CHANNEL_KEYS", { enumerable: true, get: function () { return channel_js_1.CHANNEL_KEYS; } });
+Object.defineProperty(exports, "channelAccepts", { enumerable: true, get: function () { return channel_js_1.channelAccepts; } });
+Object.defineProperty(exports, "resolveChannel", { enumerable: true, get: function () { return channel_js_1.resolveChannel; } });
+Object.defineProperty(exports, "unavailableChannel", { enumerable: true, get: function () { return channel_js_1.unavailableChannel; } });
+var context_js_1 = require("./context.js");
+Object.defineProperty(exports, "contextRef", { enumerable: true, get: function () { return context_js_1.contextRef; } });
+Object.defineProperty(exports, "validateContext", { enumerable: true, get: function () { return context_js_1.validateContext; } });
+var capabilities_js_1 = require("./capabilities.js");
+Object.defineProperty(exports, "NO_PROVIDER_GUARANTEES", { enumerable: true, get: function () { return capabilities_js_1.NO_PROVIDER_GUARANTEES; } });
+Object.defineProperty(exports, "providerIdempotencyCovers", { enumerable: true, get: function () { return capabilities_js_1.providerIdempotencyCovers; } });
+Object.defineProperty(exports, "RESEND_IDEMPOTENCY_WINDOW_MS", { enumerable: true, get: function () { return capabilities_js_1.RESEND_IDEMPOTENCY_WINDOW_MS; } });
+var idempotency_js_1 = require("./idempotency.js");
+Object.defineProperty(exports, "buildIdempotencyKey", { enumerable: true, get: function () { return idempotency_js_1.buildIdempotencyKey; } });
+var claim_js_1 = require("./claim.js");
+Object.defineProperty(exports, "createInMemoryDispatchClaimStore", { enumerable: true, get: function () { return claim_js_1.createInMemoryDispatchClaimStore; } });
+Object.defineProperty(exports, "DEFAULT_CLAIM_TTL_MS", { enumerable: true, get: function () { return claim_js_1.DEFAULT_CLAIM_TTL_MS; } });
+var postgres_js_1 = require("./stores/postgres.js");
+Object.defineProperty(exports, "createPostgresAuditSink", { enumerable: true, get: function () { return postgres_js_1.createPostgresAuditSink; } });
+Object.defineProperty(exports, "createPostgresDispatchClaimStore", { enumerable: true, get: function () { return postgres_js_1.createPostgresDispatchClaimStore; } });
+Object.defineProperty(exports, "listCommunicationTrail", { enumerable: true, get: function () { return postgres_js_1.listCommunicationTrail; } });
+var audit_js_1 = require("./audit.js");
+Object.defineProperty(exports, "createNullAuditSink", { enumerable: true, get: function () { return audit_js_1.createNullAuditSink; } });
+Object.defineProperty(exports, "createRecordingAuditSink", { enumerable: true, get: function () { return audit_js_1.createRecordingAuditSink; } });
+Object.defineProperty(exports, "eventKindForSkip", { enumerable: true, get: function () { return audit_js_1.eventKindForSkip; } });
+var identity_js_1 = require("./identity.js");
+Object.defineProperty(exports, "assertOwnership", { enumerable: true, get: function () { return identity_js_1.assertOwnership; } });
+Object.defineProperty(exports, "resolveIdentity", { enumerable: true, get: function () { return identity_js_1.resolveIdentity; } });
+Object.defineProperty(exports, "routeAccountsByChannel", { enumerable: true, get: function () { return identity_js_1.routeAccountsByChannel; } });
+var sender_profile_js_1 = require("./sender-profile.js");
+Object.defineProperty(exports, "credentialResolverFor", { enumerable: true, get: function () { return sender_profile_js_1.credentialResolverFor; } });
+Object.defineProperty(exports, "resolveSenderProfile", { enumerable: true, get: function () { return sender_profile_js_1.resolveSenderProfile; } });
+Object.defineProperty(exports, "withSenderFallback", { enumerable: true, get: function () { return sender_profile_js_1.withSenderFallback; } });
+var consent_js_1 = require("./consent.js");
+Object.defineProperty(exports, "evaluateConsent", { enumerable: true, get: function () { return consent_js_1.evaluateConsent; } });
+var template_js_1 = require("./template.js");
+Object.defineProperty(exports, "orderVariables", { enumerable: true, get: function () { return template_js_1.orderVariables; } });
+Object.defineProperty(exports, "resolveTemplate", { enumerable: true, get: function () { return template_js_1.resolveTemplate; } });
+var policy_js_1 = require("./policy.js");
+Object.defineProperty(exports, "DEFAULT_CHANNEL_POLICY", { enumerable: true, get: function () { return policy_js_1.DEFAULT_POLICY; } });
+var status_js_1 = require("./status.js");
+Object.defineProperty(exports, "CHANNEL_REPORTS", { enumerable: true, get: function () { return status_js_1.CHANNEL_REPORTS; } });
+Object.defineProperty(exports, "advanceStatus", { enumerable: true, get: function () { return status_js_1.advanceStatus; } });
+Object.defineProperty(exports, "channelReports", { enumerable: true, get: function () { return status_js_1.channelReports; } });
+Object.defineProperty(exports, "isRetryable", { enumerable: true, get: function () { return status_js_1.isRetryable; } });
+Object.defineProperty(exports, "statusForOutcome", { enumerable: true, get: function () { return status_js_1.statusForOutcome; } });
+var engine_js_1 = require("./engine.js");
+Object.defineProperty(exports, "dispatch", { enumerable: true, get: function () { return engine_js_1.dispatch; } });
+var dry_run_js_1 = require("./dry-run.js");
+Object.defineProperty(exports, "emptyDryRunReport", { enumerable: true, get: function () { return dry_run_js_1.emptyDryRunReport; } });
+Object.defineProperty(exports, "formatDryRunReport", { enumerable: true, get: function () { return dry_run_js_1.formatDryRunReport; } });
+Object.defineProperty(exports, "summarizeDryRun", { enumerable: true, get: function () { return dry_run_js_1.summarizeDryRun; } });
+var webhook_js_1 = require("./webhook.js");
+Object.defineProperty(exports, "applyDeliveryEvent", { enumerable: true, get: function () { return webhook_js_1.applyDeliveryEvent; } });
+Object.defineProperty(exports, "deliveryEventId", { enumerable: true, get: function () { return webhook_js_1.deliveryEventId; } });
+Object.defineProperty(exports, "parseMetaDeliveryWebhook", { enumerable: true, get: function () { return webhook_js_1.parseMetaDeliveryWebhook; } });
+Object.defineProperty(exports, "parseMetaInboundOptOut", { enumerable: true, get: function () { return webhook_js_1.parseMetaInboundOptOut; } });
+Object.defineProperty(exports, "parseMetaWebhookOrigins", { enumerable: true, get: function () { return webhook_js_1.parseMetaWebhookOrigins; } });
+Object.defineProperty(exports, "verifyMetaChallenge", { enumerable: true, get: function () { return webhook_js_1.verifyMetaChallenge; } });
+Object.defineProperty(exports, "verifyMetaSignature", { enumerable: true, get: function () { return webhook_js_1.verifyMetaSignature; } });
+var email_js_1 = require("./adapters/email.js");
+Object.defineProperty(exports, "createEmailChannel", { enumerable: true, get: function () { return email_js_1.createEmailChannel; } });
+var whatsapp_js_1 = require("./adapters/whatsapp.js");
+Object.defineProperty(exports, "createWhatsAppChannel", { enumerable: true, get: function () { return whatsapp_js_1.createWhatsAppChannel; } });
+var sms_js_1 = require("./adapters/sms.js");
+Object.defineProperty(exports, "countSegments", { enumerable: true, get: function () { return sms_js_1.countSegments; } });
+Object.defineProperty(exports, "createRecordingSmsTransport", { enumerable: true, get: function () { return sms_js_1.createRecordingSmsTransport; } });
+Object.defineProperty(exports, "createSmsChannel", { enumerable: true, get: function () { return sms_js_1.createSmsChannel; } });
+Object.defineProperty(exports, "isGsm7", { enumerable: true, get: function () { return sms_js_1.isGsm7; } });
+var routing_js_1 = require("./routing.js");
+Object.defineProperty(exports, "resolveRoute", { enumerable: true, get: function () { return routing_js_1.resolveRoute; } });
+Object.defineProperty(exports, "sameOrigin", { enumerable: true, get: function () { return routing_js_1.sameOrigin; } });
+var credentials_js_1 = require("./credentials.js");
+Object.defineProperty(exports, "createChannelCredentialResolver", { enumerable: true, get: function () { return credentials_js_1.createChannelCredentialResolver; } });
+Object.defineProperty(exports, "isAcceptableForNewBinding", { enumerable: true, get: function () { return credentials_js_1.isAcceptableForNewBinding; } });
+Object.defineProperty(exports, "isVaultRef", { enumerable: true, get: function () { return credentials_js_1.isVaultRef; } });
+Object.defineProperty(exports, "noCredentialResolver", { enumerable: true, get: function () { return credentials_js_1.noCredentialResolver; } });
+var secrets_js_1 = require("./stores/secrets.js");
+Object.defineProperty(exports, "createPostgresTenantSecretStore", { enumerable: true, get: function () { return secrets_js_1.createPostgresTenantSecretStore; } });
+Object.defineProperty(exports, "VAULT_DECRYPT_PERMISSION", { enumerable: true, get: function () { return secrets_js_1.VAULT_DECRYPT_PERMISSION; } });
+var routing_js_2 = require("./stores/routing.js");
+Object.defineProperty(exports, "ChannelRouteConflictError", { enumerable: true, get: function () { return routing_js_2.ChannelRouteConflictError; } });
+Object.defineProperty(exports, "CredentialRefNotAcceptableError", { enumerable: true, get: function () { return routing_js_2.CredentialRefNotAcceptableError; } });
+Object.defineProperty(exports, "completeRoute", { enumerable: true, get: function () { return routing_js_2.completeRoute; } });
+Object.defineProperty(exports, "createPostgresChannelBindingStore", { enumerable: true, get: function () { return routing_js_2.createPostgresChannelBindingStore; } });
+Object.defineProperty(exports, "createPostgresChannelRouteStore", { enumerable: true, get: function () { return routing_js_2.createPostgresChannelRouteStore; } });
+Object.defineProperty(exports, "registerChannelBinding", { enumerable: true, get: function () { return routing_js_2.registerChannelBinding; } });
+var whatsapp_templates_js_1 = require("./adapters/whatsapp-templates.js");
+Object.defineProperty(exports, "createWhatsAppTemplateProvider", { enumerable: true, get: function () { return whatsapp_templates_js_1.createWhatsAppTemplateProvider; } });
+// 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.
+var whatsapp_language_js_1 = require("./adapters/whatsapp-language.js");
+Object.defineProperty(exports, "metaLanguageCode", { enumerable: true, get: function () { return whatsapp_language_js_1.metaLanguageCode; } });
+// 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.
+var webhook_subscription_js_1 = require("./webhook-subscription.js");
+Object.defineProperty(exports, "readAppSettings", { enumerable: true, get: function () { return webhook_subscription_js_1.readAppSettings; } });
+Object.defineProperty(exports, "readAppSubscriptions", { enumerable: true, get: function () { return webhook_subscription_js_1.readAppSubscriptions; } });
+Object.defineProperty(exports, "readWabaSubscribedApps", { enumerable: true, get: function () { return webhook_subscription_js_1.readWabaSubscribedApps; } });
+Object.defineProperty(exports, "sendWebhookTestEvent", { enumerable: true, get: function () { return webhook_subscription_js_1.sendWebhookTestEvent; } });
+var graph_js_1 = require("./graph.js");
+Object.defineProperty(exports, "DEFAULT_GRAPH_API_VERSION", { enumerable: true, get: function () { return graph_js_1.DEFAULT_GRAPH_API_VERSION; } });
+Object.defineProperty(exports, "graphApiVersion", { enumerable: true, get: function () { return graph_js_1.graphApiVersion; } });
+Object.defineProperty(exports, "graphUrl", { enumerable: true, get: function () { return graph_js_1.graphUrl; } });
+var onboarding_js_1 = require("./onboarding.js");
+Object.defineProperty(exports, "createSignupState", { enumerable: true, get: function () { return onboarding_js_1.createSignupState; } });
+Object.defineProperty(exports, "exchangeSignupCode", { enumerable: true, get: function () { return onboarding_js_1.exchangeSignupCode; } });
+Object.defineProperty(exports, "hashSignupState", { enumerable: true, get: function () { return onboarding_js_1.hashSignupState; } });
+Object.defineProperty(exports, "listWabaTemplates", { enumerable: true, get: function () { return onboarding_js_1.listWabaTemplates; } });
+Object.defineProperty(exports, "readPhoneNumber", { enumerable: true, get: function () { return onboarding_js_1.readPhoneNumber; } });
+Object.defineProperty(exports, "registerPhoneNumber", { enumerable: true, get: function () { return onboarding_js_1.registerPhoneNumber; } });
+Object.defineProperty(exports, "sameStateHash", { enumerable: true, get: function () { return onboarding_js_1.sameStateHash; } });
+Object.defineProperty(exports, "subscribeAppToWaba", { enumerable: true, get: function () { return onboarding_js_1.subscribeAppToWaba; } });
+var onboarding_js_2 = require("./stores/onboarding.js");
+Object.defineProperty(exports, "consumeOnboardingSession", { enumerable: true, get: function () { return onboarding_js_2.consumeOnboardingSession; } });
+Object.defineProperty(exports, "failOnboardingSession", { enumerable: true, get: function () { return onboarding_js_2.failOnboardingSession; } });
+Object.defineProperty(exports, "latestOnboardingSession", { enumerable: true, get: function () { return onboarding_js_2.latestOnboardingSession; } });
+Object.defineProperty(exports, "ONBOARDING_SESSION_TTL_MS", { enumerable: true, get: function () { return onboarding_js_2.ONBOARDING_SESSION_TTL_MS; } });
+Object.defineProperty(exports, "openOnboardingSession", { enumerable: true, get: function () { return onboarding_js_2.openOnboardingSession; } });
+Object.defineProperty(exports, "recordOnboardingAssets", { enumerable: true, get: function () { return onboarding_js_2.recordOnboardingAssets; } });
+var routing_js_3 = require("./stores/routing.js");
+Object.defineProperty(exports, "claimChannelAccount", { enumerable: true, get: function () { return routing_js_3.claimChannelAccount; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/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/cjs/communication/onboarding.js

@@ -0,0 +1,297 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSignupState = createSignupState;
+exports.hashSignupState = hashSignupState;
+exports.sameStateHash = sameStateHash;
+exports.exchangeSignupCode = exchangeSignupCode;
+exports.subscribeAppToWaba = subscribeAppToWaba;
+exports.readPhoneNumber = readPhoneNumber;
+exports.listWabaTemplates = listWabaTemplates;
+exports.registerPhoneNumber = registerPhoneNumber;
+const node_crypto_1 = require("node:crypto");
+const graph_js_1 = require("./graph.js");
+/**
+ * 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.
+ */
+function createSignupState() {
+    const state = (0, node_crypto_1.randomBytes)(32).toString('base64url');
+    return { state, stateHash: hashSignupState(state) };
+}
+function hashSignupState(state) {
+    return (0, node_crypto_1.createHash)('sha256').update(state, 'utf8').digest('hex');
+}
+/**
+ * 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.
+ */
+function sameStateHash(a, b) {
+    if (typeof a !== 'string' || typeof b !== 'string')
+        return false;
+    const ba = Buffer.from(a, 'utf8');
+    const bb = Buffer.from(b, 'utf8');
+    if (ba.length !== bb.length)
+        return false;
+    return (0, node_crypto_1.timingSafeEqual)(ba, bb);
+}
+const DEFAULT_TIMEOUT_MS = 15_000;
+/**
+ * Traduz o erro da Meta para uma classe nossa.
+ *
+ * `100`/`191` sobre um `code` significam código gasto ou redirect divergente —
+ * os dois são "refaça o fluxo", não "conserte a configuração". `190` e `200`
+ * são credencial/permissão do App: refazer o fluxo não resolve nada, e mostrar
+ * "tente de novo" ao operador o faria repetir para sempre um passo que nunca
+ * vai funcionar.
+ */
+function classifySignupError(status, err) {
+    const code = err?.code;
+    if (code === 190 || code === 200 || code === 10 || code === 3)
+        return 'unauthorized_app';
+    if (code === 100 || code === 191)
+        return 'invalid_code';
+    if (code === 4 || code === 17 || code === 80007 || code === 613)
+        return 'rate_limited';
+    if (status === 429)
+        return 'rate_limited';
+    if (status >= 500)
+        return 'network';
+    return 'provider_error';
+}
+/**
+ * Uma chamada à Graph API, com a resposta já reduzida a `ok`/classe de erro.
+ *
+ * Centraliza três cuidados que, escritos em cada chamada, um dia divergiriam:
+ * o timeout (uma chamada sem teto pendura o request do operador), o descarte
+ * total da exceção de rede (ela pode carregar a URL, e a URL de troca carrega
+ * o `client_secret` na query), e a leitura do corpo de erro sem propagá-lo.
+ */
+async function graphCall(call, opts) {
+    const doFetch = opts.fetchImpl ?? fetch;
+    let res;
+    try {
+        res = await doFetch(call.url, {
+            method: call.method,
+            headers: {
+                ...(call.bearer ? { authorization: `Bearer ${call.bearer}` } : {}),
+                ...(call.body ? { 'content-type': 'application/json' } : {}),
+            },
+            ...(call.body ? { body: JSON.stringify(call.body) } : {}),
+            signal: AbortSignal.timeout(opts.timeoutMs ?? DEFAULT_TIMEOUT_MS),
+        });
+    }
+    catch {
+        // Nada da exceção é propagado. Em algumas implementações de `fetch` a
+        // mensagem inclui a URL — e a URL da troca de código carrega o segredo do
+        // App na query string.
+        return { ok: false, reason: 'network' };
+    }
+    const payload = (await res.json().catch(() => null));
+    if (!res.ok) {
+        const err = (payload?.error ?? null);
+        return { ok: false, reason: classifySignupError(res.status, err) };
+    }
+    return { ok: true, value: (payload ?? {}) };
+}
+/**
+ * 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.
+ */
+async function exchangeSignupCode(input, opts = {}) {
+    const code = input.code?.trim() ?? '';
+    const appId = input.appId?.trim() ?? '';
+    const appSecret = typeof input.appSecret === 'string' ? input.appSecret : '';
+    if (!code || !appId || !appSecret)
+        return { ok: false, reason: 'unauthorized_app' };
+    const url = new URL((0, graph_js_1.graphUrl)('oauth/access_token', opts.env));
+    url.searchParams.set('client_id', appId);
+    url.searchParams.set('client_secret', appSecret);
+    url.searchParams.set('code', code);
+    const res = await graphCall({ url: url.toString(), method: 'GET' }, opts);
+    if (!res.ok)
+        return res;
+    const token = res.value.access_token;
+    // Resposta 200 sem token é resposta inválida, não sucesso vazio. Deixá-la
+    // passar gravaria uma credencial em branco no cofre e o canal falharia
+    // depois, longe daqui.
+    if (typeof token !== 'string' || token.length < 20) {
+        return { ok: false, reason: 'provider_error' };
+    }
+    return {
+        ok: true,
+        value: {
+            accessToken: token,
+            ...(typeof res.value.expires_in === 'number' && res.value.expires_in > 0
+                ? { expiresInSeconds: res.value.expires_in }
+                : {}),
+        },
+    };
+}
+/* ── 2. Assinatura do App na WABA do cliente ────────────────────────────── */
+/**
+ * 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.
+ */
+async function subscribeAppToWaba(input, opts = {}) {
+    const wabaId = input.wabaId?.trim() ?? '';
+    if (!wabaId)
+        return { ok: false, reason: 'provider_error' };
+    const res = await graphCall({
+        url: (0, graph_js_1.graphUrl)(`${encodeURIComponent(wabaId)}/subscribed_apps`, opts.env),
+        method: 'POST',
+        bearer: input.accessToken,
+    }, opts);
+    if (!res.ok)
+        return res;
+    return { ok: true, value: { subscribed: res.value.success !== false } };
+}
+/**
+ * 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ê.
+ */
+async function readPhoneNumber(input, opts = {}) {
+    const id = input.phoneNumberId?.trim() ?? '';
+    if (!id)
+        return { ok: false, reason: 'provider_error' };
+    const url = new URL((0, graph_js_1.graphUrl)(encodeURIComponent(id), opts.env));
+    url.searchParams.set('fields', 'display_phone_number,verified_name,code_verification_status,status,quality_rating,platform_type');
+    const res = await graphCall({ url: url.toString(), method: 'GET', bearer: input.accessToken }, opts);
+    if (!res.ok)
+        return res;
+    const v = res.value;
+    return {
+        ok: true,
+        value: {
+            ...(str(v.display_phone_number) ? { displayPhoneNumber: str(v.display_phone_number) } : {}),
+            ...(str(v.verified_name) ? { verifiedName: str(v.verified_name) } : {}),
+            ...(str(v.code_verification_status)
+                ? { codeVerificationStatus: str(v.code_verification_status) }
+                : {}),
+            ...(str(v.status) ? { status: str(v.status) } : {}),
+            ...(str(v.quality_rating) ? { qualityRating: str(v.quality_rating) } : {}),
+            ...(str(v.platform_type) ? { platformType: str(v.platform_type) } : {}),
+        },
+    };
+}
+/**
+ * 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.
+ */
+async function listWabaTemplates(input, opts = {}) {
+    const wabaId = input.wabaId?.trim() ?? '';
+    if (!wabaId)
+        return { ok: false, reason: 'provider_error' };
+    const url = new URL((0, graph_js_1.graphUrl)(`${encodeURIComponent(wabaId)}/message_templates`, opts.env));
+    url.searchParams.set('fields', 'name,language,status,category');
+    url.searchParams.set('limit', '100');
+    const res = await graphCall({ url: url.toString(), method: 'GET', bearer: input.accessToken }, opts);
+    if (!res.ok)
+        return res;
+    const items = Array.isArray(res.value.data) ? res.value.data : [];
+    return {
+        ok: true,
+        // Só os quatro campos que interessam. O payload da Meta traz `components`
+        // com o TEXTO do template, e o texto de um template de cobrança carrega a
+        // forma como o escritório fala com o cliente — não precisa atravessar o
+        // domínio para responder "está aprovado?".
+        value: items.flatMap((t) => {
+            const name = str(t.name);
+            const language = str(t.language);
+            const status = str(t.status);
+            if (!name || !language || !status)
+                return [];
+            const category = str(t.category);
+            return [{ name, language, status, ...(category ? { category } : {}) }];
+        }),
+    };
+}
+/**
+ * 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.
+ */
+async function registerPhoneNumber(input, opts = {}) {
+    if (input.authorized !== true)
+        return { ok: false, reason: 'not_authorized' };
+    const pin = input.pin?.trim() ?? '';
+    if (!/^\d{6}$/.test(pin))
+        return { ok: false, reason: 'invalid_pin' };
+    const res = await graphCall({
+        url: (0, graph_js_1.graphUrl)(`${encodeURIComponent(input.phoneNumberId)}/register`, opts.env),
+        method: 'POST',
+        bearer: input.accessToken,
+        body: { messaging_product: 'whatsapp', pin },
+    }, opts);
+    if (!res.ok)
+        return { ok: false, reason: res.reason };
+    return { ok: true };
+}
+function str(v) {
+    return typeof v === 'string' && v.trim().length > 0 ? v.trim().slice(0, 120) : undefined;
+}
+//# sourceMappingURL=onboarding.js.map