@adatechnology/meta-whatsapp-module 0.2.0-rc.30 → 0.2.0-rc.31

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as drizzle_orm_pg_core from 'drizzle-orm/pg-core';
 import { PgDatabase, PgQueryResultHKT } from 'drizzle-orm/pg-core';
 import * as _adatechnology_meta_whatsapp_contracts from '@adatechnology/meta-whatsapp-contracts';
-import { TranscriptionMode, SessionState, SessionMode, ConversationSummary, MessageDirection, MessageSender, MessageStatus, CacheInterface, FlowGraphData, FlowGraphSummary, LiveFlowPosition, WhatsAppSettings, RealtimeNotifierInterface, ChannelAdapterInterface, ObjectStorageInterface, FlowActionKind, FlowActionHandler, ConversationSession, WhatsAppMessage, WhatsAppStatus, MetaWhatsAppHooks, SubjectResolverInterface, CatalogPort } from '@adatechnology/meta-whatsapp-contracts';
+import { TranscriptionMode, SessionState, SessionMode, ConversationSummary, MessageDirection, MessageSender, MessageStatus, CacheInterface, FlowGraphData, FlowGraphSummary, LiveFlowPosition, WhatsAppSettings, RealtimeNotifierInterface, ChannelAdapterInterface, ObjectStorageInterface, FlowActionKind, FlowActionHandler, ConversationSession, WhatsAppMessage, WhatsAppStatus, MetaWhatsAppHooks, SubjectResolverInterface, CatalogPort, SendChannelMediaParams } from '@adatechnology/meta-whatsapp-contracts';
 export { PREVIEW_MEDIA_ID_PREFIX, TranscriptionMode, resolvePreviewUploadId, toPreviewMediaId } from '@adatechnology/meta-whatsapp-contracts';
 import { WhatsAppMessageProvider } from '@adatechnology/meta-whatsapp-provider';
 export { WEBHOOK_CLAIM_TTL_SECONDS, WEBHOOK_NONCE_TTL_SECONDS } from '@adatechnology/meta-graph-core';
@@ -1357,6 +1357,25 @@ declare const flowMedia: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        metaMediaIds: drizzle_orm_pg_core.PgColumn<{
+            name: "meta_media_ids";
+            tableName: "flow_media";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: Record<string, string>;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: Record<string, string>;
+        }>;
         createdAt: drizzle_orm_pg_core.PgColumn<{
             name: "created_at";
             tableName: "flow_media";
@@ -2444,6 +2463,8 @@ type ReceiveWebhookResult = {
     messagesProcessed: number;
     statusesProcessed: number;
     ignoredForeignNumber: number;
+    accountEventsProcessed: number;
+    unhandledEvents: number;
 };
 declare class ReceiveWebhookUseCase {
     private readonly params;
@@ -2465,6 +2486,7 @@ declare class ReceiveWebhookUseCase {
     });
     private readonly dispatcher;
     execute(input: ReceiveWebhookParams): Promise<ReceiveWebhookResult>;
+    private handleAccountEvent;
     private handleMessage;
     private handleStatus;
     private dispatch;
@@ -2836,14 +2858,9 @@ declare class WhatsAppChannelAdapter implements ChannelAdapterInterface {
     sendText(to: string, body: string): Promise<{
         externalMessageId: string | null;
     }>;
-    sendMedia(params: {
-        to: string;
-        buffer: Buffer;
-        mimeType: string;
-        filename: string;
-        caption?: string;
-    }): Promise<{
+    sendMedia(params: SendChannelMediaParams): Promise<{
         externalMessageId: string | null;
+        mediaId?: string | undefined;
     }>;
     sendTemplate(params: {
         to: string;
@@ -2943,6 +2960,39 @@ declare function redeemSseTicket(store: TicketStoreInterface, ticket: string): P
  * sem gravar o envio numa tabela que o painel dele não lê. O que a action precisa é só de um lugar
  * para registrar o que saiu.
  */
+/**
+ * Onde guardar o `mediaId` que a Meta devolveu para cada arquivo da biblioteca.
+ *
+ * Porta, e não tabela: o módulo não sabe se o host guarda isso numa coluna, no Redis ou em memória.
+ * O que ele precisa é reaproveitar o id em vez de ressubir o mesmo binário para cada cliente que
+ * passa pelo nó — a Meta aceita reusar por 30 dias.
+ */
+type FlowMediaIdStore = {
+    get(params: {
+        flowMediaId: string;
+        senderKey: string;
+    }): Promise<string | undefined>;
+    set(params: {
+        flowMediaId: string;
+        senderKey: string;
+        mediaId: string;
+    }): Promise<void>;
+    clear(params: {
+        flowMediaId: string;
+        senderKey: string;
+    }): Promise<void>;
+};
+/**
+ * O `senderKey` vem junto do store, e não solto, para não existir a forma inválida.
+ *
+ * O `mediaId` é escopado ao número remetente (`phone_number_id`) na Meta: cachear sem separar por
+ * número faz o id de um número ser mandado pelo outro, e o envio falha. Exigi-lo dentro do mesmo
+ * objeto torna "liguei o cache e esqueci o número" impossível de escrever.
+ */
+type FlowMediaIdCache = {
+    readonly store: FlowMediaIdStore;
+    readonly senderKey: string;
+};
 type FlowMediaTranscriptLogger = {
     execute(params: LogMessageParams): Promise<unknown>;
 };
@@ -2952,6 +3002,11 @@ type CreateSendMediaActionParams = {
         getObject: NonNullable<ObjectStorageInterface['getObject']>;
     };
     logMessage: FlowMediaTranscriptLogger;
+    /**
+     * Reaproveitamento do arquivo já subido. Capacidade por ausência: sem o cache, cada envio ressobe
+     * o binário — exatamente o comportamento anterior, sem flag para desligar.
+     */
+    mediaIdCache?: FlowMediaIdCache;
     startState: SessionState;
     onError?: (error: unknown, details: {
         flowKey: string;
@@ -2959,18 +3014,6 @@ type CreateSendMediaActionParams = {
         uploadId: string;
     }) => void;
 };
-/**
- * Action `send_media`: ao passar pelo nó, envia os arquivos que a biblioteca tem anexados a ele.
- *
- * É a única action built-in que o módulo implementa de ponta a ponta — as outras
- * (`handoff`, `send_product_list`) dependem de regra de negócio do produto. Esta não: "mandar
- * estes arquivos ao chegar aqui" é comportamento de canal, e replicá-la em cada host seria
- * copiar o mesmo código com os mesmos bugs.
- *
- * O nó não guarda os arquivos em `actionParams` de propósito. Se guardasse, trocar o material
- * exigiria editar e republicar o grafo — e o ponto todo é o contrário: quem cuida do conteúdo
- * troca o arquivo na biblioteca e o fluxo continua igual.
- */
 declare function createSendMediaAction(params: CreateSendMediaActionParams): FlowActionHandler;
 
 /** Tetos da Meta para `interactive.product_list`. Acima disso a mensagem inteira é recusada. */
@@ -3001,4 +3044,40 @@ type CreateSendProductListActionParams = {
  */
 declare function createSendProductListAction(params: CreateSendProductListActionParams): FlowActionHandler;
 
-export { type AttachFlowMediaParams, type AudioTranscriber, type CompanyDocumentView, type CompanyDocumentsPage, type ConversationDocumentView, type ConversationDocumentsPage, type CreateFlowGraphParams, CreateFlowGraphUseCase, type CreateMetaWhatsAppModuleParams, type CreateSendMediaActionParams, type CreateSendProductListActionParams, DEFAULT_FLOW_GRAPH_CACHE_TTL_SECONDS, type DeleteConversationParams, type DeleteConversationResult, DeleteConversationUseCase, DeleteFlowGraphUseCase, DocumentRepository, type DocumentRow, type DrizzleMigrateFunction, type ExportConversationParams, type ExportConversationResult, ExportConversationUseCase, FlowGraphCache, FlowGraphRepository, type FlowGraphRow, FlowInterpreter, type FlowMediaLocation, FlowMediaRepository, type FlowMediaRow, type FlowMediaTranscriptLogger, type FlowRunResult, type FlowStepInput, type FlowStepResult, GetFlowGraphUseCase, GetLiveFlowPositionsUseCase, type InboundDispatchJob, type InboundDispatchQueueInterface, InboundEffectsDispatcher, type InboundMediaDescriptor, type InboundMessageEffectsJob, type InboundStatusEffectsJob, type IngestInboundMediaParams, type IngestInboundMediaResult, IngestInboundMediaUseCase, type IngestTranscriptionOptions, type InsertMessageParams, InvalidFlowGraphError, type LinkDocumentParams, type ListCompanyDocumentsParams, ListCompanyDocumentsUseCase, type ListConversationDocumentsParams, ListConversationDocumentsUseCase, type ListConversationsFilters, type ListConversationsParams, ListConversationsUseCase, type ListDocumentsParams, type ListDocumentsResult, ListFlowGraphsUseCase, type ListMessagesParams, ListMessagesUseCase, type LogMessageParams, LogMessageUseCase, META_WHATSAPP_MIGRATIONS_TABLE, type MessageModerator, MessageRepository, type MessageRow, type MetaWhatsAppDatabase, type MetaWhatsAppModule, type MetaWhatsAppModuleConfig, type MetaWhatsAppModuleFeatures, type MetaWhatsAppModuleProviders, type MetaWhatsAppTranscriptionConfig, type NewDocumentRow, type NewFlowGraphRow, type NewFlowMediaRow, type NewMessageRow, type NewSessionRow, type NewSettingsRow, type NonceStoreInterface, OptimisticLockError, PRODUCT_LIST_LIMIT, type PreviewMediaSupport, ProcessInboundDispatchUseCase, type PurgeExpiredDocumentsParams, type PurgeExpiredDocumentsResult, PurgeExpiredDocumentsUseCase, type RealtimeRelay, type ReceiveWebhookParams, type ReceiveWebhookResult, ReceiveWebhookUseCase, type ReleaseConversationParams, ReleaseConversationUseCase, type ListMessagesParams$1 as RepositoryListMessagesParams, type ResolveTranscriptionPolicyDependencies, type RunMetaWhatsAppMigrationsParams, type SaveFlowGraphParams, SaveFlowGraphUseCase, type SaveTranscriptionByWaMessageIdParams, type SaveTranscriptionParams, type SendMediaParams, SendMessageUseCase, type SendTemplateParams, type SendTextParams, SessionRepository, type SessionRow, SettingsRepository, type SettingsRow, SseHub, type SseListener, type StorePreviewMediaParams, type StorePreviewMediaResult, StorePreviewMediaUseCase, TRANSCRIPTION_MODE, TRANSCRIPTION_STATUS, type TakeoverConversationParams, TakeoverConversationUseCase, type TicketStoreInterface, type TranscribeAudioDependencies, type TranscribeAudioParams, type TranscribeAudioResult, TranscribeAudioUseCase, type TranscriptionPolicy, type TranscriptionPolicyDefaults, type TranscriptionPolicyResolver, type TranscriptionStatus, type UpdateFlowMediaParams, WhatsAppChannelAdapter, buildInboundJobId, claimWebhookDelivery, confirmWebhookDelivery, createMetaWhatsAppModule, createSendMediaAction, createSendProductListAction, createTranscriptionPolicyResolver, documents, extractMediaDescriptor, flowGraphs, flowMedia, isAudioMimeType, isRetriableTranscriptionError, isUnsupportedTranscriptionError, issueSseTicket, messages, metaWhatsAppMigrationsFolder, metaWhatsAppSchema, redeemSseTicket, resolveFailureStatus, runMetaWhatsAppMigrations, sessions, settings, toSessionContract, transcriptionRetryAfterSeconds, verifyWebhookChallenge, verifyWebhookSignature };
+/**
+ * Store padrão do cache de `mediaId`, na própria linha da biblioteca de mídia.
+ *
+ * A porta `FlowMediaIdStore` existe para o host poder escolher Redis ou memória. Esta é a
+ * implementação que o módulo já traz pronta, para o caso comum não exigir nada de quem instala: a
+ * tabela é do módulo, a coluna é do módulo, e sem isso todo host reescreveria o mesmo repositório.
+ *
+ * Um mapa por `phone_number_id` na mesma linha, e não uma tabela à parte: o id não existe sem o
+ * arquivo, morre com ele, e a linha é lida de qualquer forma no envio.
+ */
+declare class FlowMediaIdRepository implements FlowMediaIdStore {
+    private readonly db;
+    constructor(db: MetaWhatsAppDatabase);
+    get(params: {
+        flowMediaId: string;
+        senderKey: string;
+    }): Promise<string | undefined>;
+    /**
+     * Grava só a chave deste número.
+     *
+     * `jsonb_set` no banco, e não ler-alterar-escrever na aplicação: dois clientes passando pelo nó
+     * ao mesmo tempo com números diferentes leriam o mesmo mapa e o último gravaria por cima,
+     * apagando o id do outro. A escrita atômica não tem essa janela.
+     */
+    set(params: {
+        flowMediaId: string;
+        senderKey: string;
+        mediaId: string;
+    }): Promise<void>;
+    /** Remove só a chave deste número — o id do outro número continua válido. */
+    clear(params: {
+        flowMediaId: string;
+        senderKey: string;
+    }): Promise<void>;
+}
+
+export { type AttachFlowMediaParams, type AudioTranscriber, type CompanyDocumentView, type CompanyDocumentsPage, type ConversationDocumentView, type ConversationDocumentsPage, type CreateFlowGraphParams, CreateFlowGraphUseCase, type CreateMetaWhatsAppModuleParams, type CreateSendMediaActionParams, type CreateSendProductListActionParams, DEFAULT_FLOW_GRAPH_CACHE_TTL_SECONDS, type DeleteConversationParams, type DeleteConversationResult, DeleteConversationUseCase, DeleteFlowGraphUseCase, DocumentRepository, type DocumentRow, type DrizzleMigrateFunction, type ExportConversationParams, type ExportConversationResult, ExportConversationUseCase, FlowGraphCache, FlowGraphRepository, type FlowGraphRow, FlowInterpreter, type FlowMediaIdCache, FlowMediaIdRepository, type FlowMediaIdStore, type FlowMediaLocation, FlowMediaRepository, type FlowMediaRow, type FlowMediaTranscriptLogger, type FlowRunResult, type FlowStepInput, type FlowStepResult, GetFlowGraphUseCase, GetLiveFlowPositionsUseCase, type InboundDispatchJob, type InboundDispatchQueueInterface, InboundEffectsDispatcher, type InboundMediaDescriptor, type InboundMessageEffectsJob, type InboundStatusEffectsJob, type IngestInboundMediaParams, type IngestInboundMediaResult, IngestInboundMediaUseCase, type IngestTranscriptionOptions, type InsertMessageParams, InvalidFlowGraphError, type LinkDocumentParams, type ListCompanyDocumentsParams, ListCompanyDocumentsUseCase, type ListConversationDocumentsParams, ListConversationDocumentsUseCase, type ListConversationsFilters, type ListConversationsParams, ListConversationsUseCase, type ListDocumentsParams, type ListDocumentsResult, ListFlowGraphsUseCase, type ListMessagesParams, ListMessagesUseCase, type LogMessageParams, LogMessageUseCase, META_WHATSAPP_MIGRATIONS_TABLE, type MessageModerator, MessageRepository, type MessageRow, type MetaWhatsAppDatabase, type MetaWhatsAppModule, type MetaWhatsAppModuleConfig, type MetaWhatsAppModuleFeatures, type MetaWhatsAppModuleProviders, type MetaWhatsAppTranscriptionConfig, type NewDocumentRow, type NewFlowGraphRow, type NewFlowMediaRow, type NewMessageRow, type NewSessionRow, type NewSettingsRow, type NonceStoreInterface, OptimisticLockError, PRODUCT_LIST_LIMIT, type PreviewMediaSupport, ProcessInboundDispatchUseCase, type PurgeExpiredDocumentsParams, type PurgeExpiredDocumentsResult, PurgeExpiredDocumentsUseCase, type RealtimeRelay, type ReceiveWebhookParams, type ReceiveWebhookResult, ReceiveWebhookUseCase, type ReleaseConversationParams, ReleaseConversationUseCase, type ListMessagesParams$1 as RepositoryListMessagesParams, type ResolveTranscriptionPolicyDependencies, type RunMetaWhatsAppMigrationsParams, type SaveFlowGraphParams, SaveFlowGraphUseCase, type SaveTranscriptionByWaMessageIdParams, type SaveTranscriptionParams, type SendMediaParams, SendMessageUseCase, type SendTemplateParams, type SendTextParams, SessionRepository, type SessionRow, SettingsRepository, type SettingsRow, SseHub, type SseListener, type StorePreviewMediaParams, type StorePreviewMediaResult, StorePreviewMediaUseCase, TRANSCRIPTION_MODE, TRANSCRIPTION_STATUS, type TakeoverConversationParams, TakeoverConversationUseCase, type TicketStoreInterface, type TranscribeAudioDependencies, type TranscribeAudioParams, type TranscribeAudioResult, TranscribeAudioUseCase, type TranscriptionPolicy, type TranscriptionPolicyDefaults, type TranscriptionPolicyResolver, type TranscriptionStatus, type UpdateFlowMediaParams, WhatsAppChannelAdapter, buildInboundJobId, claimWebhookDelivery, confirmWebhookDelivery, createMetaWhatsAppModule, createSendMediaAction, createSendProductListAction, createTranscriptionPolicyResolver, documents, extractMediaDescriptor, flowGraphs, flowMedia, isAudioMimeType, isRetriableTranscriptionError, isUnsupportedTranscriptionError, issueSseTicket, messages, metaWhatsAppMigrationsFolder, metaWhatsAppSchema, redeemSseTicket, resolveFailureStatus, runMetaWhatsAppMigrations, sessions, settings, toSessionContract, transcriptionRetryAfterSeconds, verifyWebhookChallenge, verifyWebhookSignature };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as drizzle_orm_pg_core from 'drizzle-orm/pg-core';
 import { PgDatabase, PgQueryResultHKT } from 'drizzle-orm/pg-core';
 import * as _adatechnology_meta_whatsapp_contracts from '@adatechnology/meta-whatsapp-contracts';
-import { TranscriptionMode, SessionState, SessionMode, ConversationSummary, MessageDirection, MessageSender, MessageStatus, CacheInterface, FlowGraphData, FlowGraphSummary, LiveFlowPosition, WhatsAppSettings, RealtimeNotifierInterface, ChannelAdapterInterface, ObjectStorageInterface, FlowActionKind, FlowActionHandler, ConversationSession, WhatsAppMessage, WhatsAppStatus, MetaWhatsAppHooks, SubjectResolverInterface, CatalogPort } from '@adatechnology/meta-whatsapp-contracts';
+import { TranscriptionMode, SessionState, SessionMode, ConversationSummary, MessageDirection, MessageSender, MessageStatus, CacheInterface, FlowGraphData, FlowGraphSummary, LiveFlowPosition, WhatsAppSettings, RealtimeNotifierInterface, ChannelAdapterInterface, ObjectStorageInterface, FlowActionKind, FlowActionHandler, ConversationSession, WhatsAppMessage, WhatsAppStatus, MetaWhatsAppHooks, SubjectResolverInterface, CatalogPort, SendChannelMediaParams } from '@adatechnology/meta-whatsapp-contracts';
 export { PREVIEW_MEDIA_ID_PREFIX, TranscriptionMode, resolvePreviewUploadId, toPreviewMediaId } from '@adatechnology/meta-whatsapp-contracts';
 import { WhatsAppMessageProvider } from '@adatechnology/meta-whatsapp-provider';
 export { WEBHOOK_CLAIM_TTL_SECONDS, WEBHOOK_NONCE_TTL_SECONDS } from '@adatechnology/meta-graph-core';
@@ -1357,6 +1357,25 @@ declare const flowMedia: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        metaMediaIds: drizzle_orm_pg_core.PgColumn<{
+            name: "meta_media_ids";
+            tableName: "flow_media";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: Record<string, string>;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: Record<string, string>;
+        }>;
         createdAt: drizzle_orm_pg_core.PgColumn<{
             name: "created_at";
             tableName: "flow_media";
@@ -2444,6 +2463,8 @@ type ReceiveWebhookResult = {
     messagesProcessed: number;
     statusesProcessed: number;
     ignoredForeignNumber: number;
+    accountEventsProcessed: number;
+    unhandledEvents: number;
 };
 declare class ReceiveWebhookUseCase {
     private readonly params;
@@ -2465,6 +2486,7 @@ declare class ReceiveWebhookUseCase {
     });
     private readonly dispatcher;
     execute(input: ReceiveWebhookParams): Promise<ReceiveWebhookResult>;
+    private handleAccountEvent;
     private handleMessage;
     private handleStatus;
     private dispatch;
@@ -2836,14 +2858,9 @@ declare class WhatsAppChannelAdapter implements ChannelAdapterInterface {
     sendText(to: string, body: string): Promise<{
         externalMessageId: string | null;
     }>;
-    sendMedia(params: {
-        to: string;
-        buffer: Buffer;
-        mimeType: string;
-        filename: string;
-        caption?: string;
-    }): Promise<{
+    sendMedia(params: SendChannelMediaParams): Promise<{
         externalMessageId: string | null;
+        mediaId?: string | undefined;
     }>;
     sendTemplate(params: {
         to: string;
@@ -2943,6 +2960,39 @@ declare function redeemSseTicket(store: TicketStoreInterface, ticket: string): P
  * sem gravar o envio numa tabela que o painel dele não lê. O que a action precisa é só de um lugar
  * para registrar o que saiu.
  */
+/**
+ * Onde guardar o `mediaId` que a Meta devolveu para cada arquivo da biblioteca.
+ *
+ * Porta, e não tabela: o módulo não sabe se o host guarda isso numa coluna, no Redis ou em memória.
+ * O que ele precisa é reaproveitar o id em vez de ressubir o mesmo binário para cada cliente que
+ * passa pelo nó — a Meta aceita reusar por 30 dias.
+ */
+type FlowMediaIdStore = {
+    get(params: {
+        flowMediaId: string;
+        senderKey: string;
+    }): Promise<string | undefined>;
+    set(params: {
+        flowMediaId: string;
+        senderKey: string;
+        mediaId: string;
+    }): Promise<void>;
+    clear(params: {
+        flowMediaId: string;
+        senderKey: string;
+    }): Promise<void>;
+};
+/**
+ * O `senderKey` vem junto do store, e não solto, para não existir a forma inválida.
+ *
+ * O `mediaId` é escopado ao número remetente (`phone_number_id`) na Meta: cachear sem separar por
+ * número faz o id de um número ser mandado pelo outro, e o envio falha. Exigi-lo dentro do mesmo
+ * objeto torna "liguei o cache e esqueci o número" impossível de escrever.
+ */
+type FlowMediaIdCache = {
+    readonly store: FlowMediaIdStore;
+    readonly senderKey: string;
+};
 type FlowMediaTranscriptLogger = {
     execute(params: LogMessageParams): Promise<unknown>;
 };
@@ -2952,6 +3002,11 @@ type CreateSendMediaActionParams = {
         getObject: NonNullable<ObjectStorageInterface['getObject']>;
     };
     logMessage: FlowMediaTranscriptLogger;
+    /**
+     * Reaproveitamento do arquivo já subido. Capacidade por ausência: sem o cache, cada envio ressobe
+     * o binário — exatamente o comportamento anterior, sem flag para desligar.
+     */
+    mediaIdCache?: FlowMediaIdCache;
     startState: SessionState;
     onError?: (error: unknown, details: {
         flowKey: string;
@@ -2959,18 +3014,6 @@ type CreateSendMediaActionParams = {
         uploadId: string;
     }) => void;
 };
-/**
- * Action `send_media`: ao passar pelo nó, envia os arquivos que a biblioteca tem anexados a ele.
- *
- * É a única action built-in que o módulo implementa de ponta a ponta — as outras
- * (`handoff`, `send_product_list`) dependem de regra de negócio do produto. Esta não: "mandar
- * estes arquivos ao chegar aqui" é comportamento de canal, e replicá-la em cada host seria
- * copiar o mesmo código com os mesmos bugs.
- *
- * O nó não guarda os arquivos em `actionParams` de propósito. Se guardasse, trocar o material
- * exigiria editar e republicar o grafo — e o ponto todo é o contrário: quem cuida do conteúdo
- * troca o arquivo na biblioteca e o fluxo continua igual.
- */
 declare function createSendMediaAction(params: CreateSendMediaActionParams): FlowActionHandler;
 
 /** Tetos da Meta para `interactive.product_list`. Acima disso a mensagem inteira é recusada. */
@@ -3001,4 +3044,40 @@ type CreateSendProductListActionParams = {
  */
 declare function createSendProductListAction(params: CreateSendProductListActionParams): FlowActionHandler;
 
-export { type AttachFlowMediaParams, type AudioTranscriber, type CompanyDocumentView, type CompanyDocumentsPage, type ConversationDocumentView, type ConversationDocumentsPage, type CreateFlowGraphParams, CreateFlowGraphUseCase, type CreateMetaWhatsAppModuleParams, type CreateSendMediaActionParams, type CreateSendProductListActionParams, DEFAULT_FLOW_GRAPH_CACHE_TTL_SECONDS, type DeleteConversationParams, type DeleteConversationResult, DeleteConversationUseCase, DeleteFlowGraphUseCase, DocumentRepository, type DocumentRow, type DrizzleMigrateFunction, type ExportConversationParams, type ExportConversationResult, ExportConversationUseCase, FlowGraphCache, FlowGraphRepository, type FlowGraphRow, FlowInterpreter, type FlowMediaLocation, FlowMediaRepository, type FlowMediaRow, type FlowMediaTranscriptLogger, type FlowRunResult, type FlowStepInput, type FlowStepResult, GetFlowGraphUseCase, GetLiveFlowPositionsUseCase, type InboundDispatchJob, type InboundDispatchQueueInterface, InboundEffectsDispatcher, type InboundMediaDescriptor, type InboundMessageEffectsJob, type InboundStatusEffectsJob, type IngestInboundMediaParams, type IngestInboundMediaResult, IngestInboundMediaUseCase, type IngestTranscriptionOptions, type InsertMessageParams, InvalidFlowGraphError, type LinkDocumentParams, type ListCompanyDocumentsParams, ListCompanyDocumentsUseCase, type ListConversationDocumentsParams, ListConversationDocumentsUseCase, type ListConversationsFilters, type ListConversationsParams, ListConversationsUseCase, type ListDocumentsParams, type ListDocumentsResult, ListFlowGraphsUseCase, type ListMessagesParams, ListMessagesUseCase, type LogMessageParams, LogMessageUseCase, META_WHATSAPP_MIGRATIONS_TABLE, type MessageModerator, MessageRepository, type MessageRow, type MetaWhatsAppDatabase, type MetaWhatsAppModule, type MetaWhatsAppModuleConfig, type MetaWhatsAppModuleFeatures, type MetaWhatsAppModuleProviders, type MetaWhatsAppTranscriptionConfig, type NewDocumentRow, type NewFlowGraphRow, type NewFlowMediaRow, type NewMessageRow, type NewSessionRow, type NewSettingsRow, type NonceStoreInterface, OptimisticLockError, PRODUCT_LIST_LIMIT, type PreviewMediaSupport, ProcessInboundDispatchUseCase, type PurgeExpiredDocumentsParams, type PurgeExpiredDocumentsResult, PurgeExpiredDocumentsUseCase, type RealtimeRelay, type ReceiveWebhookParams, type ReceiveWebhookResult, ReceiveWebhookUseCase, type ReleaseConversationParams, ReleaseConversationUseCase, type ListMessagesParams$1 as RepositoryListMessagesParams, type ResolveTranscriptionPolicyDependencies, type RunMetaWhatsAppMigrationsParams, type SaveFlowGraphParams, SaveFlowGraphUseCase, type SaveTranscriptionByWaMessageIdParams, type SaveTranscriptionParams, type SendMediaParams, SendMessageUseCase, type SendTemplateParams, type SendTextParams, SessionRepository, type SessionRow, SettingsRepository, type SettingsRow, SseHub, type SseListener, type StorePreviewMediaParams, type StorePreviewMediaResult, StorePreviewMediaUseCase, TRANSCRIPTION_MODE, TRANSCRIPTION_STATUS, type TakeoverConversationParams, TakeoverConversationUseCase, type TicketStoreInterface, type TranscribeAudioDependencies, type TranscribeAudioParams, type TranscribeAudioResult, TranscribeAudioUseCase, type TranscriptionPolicy, type TranscriptionPolicyDefaults, type TranscriptionPolicyResolver, type TranscriptionStatus, type UpdateFlowMediaParams, WhatsAppChannelAdapter, buildInboundJobId, claimWebhookDelivery, confirmWebhookDelivery, createMetaWhatsAppModule, createSendMediaAction, createSendProductListAction, createTranscriptionPolicyResolver, documents, extractMediaDescriptor, flowGraphs, flowMedia, isAudioMimeType, isRetriableTranscriptionError, isUnsupportedTranscriptionError, issueSseTicket, messages, metaWhatsAppMigrationsFolder, metaWhatsAppSchema, redeemSseTicket, resolveFailureStatus, runMetaWhatsAppMigrations, sessions, settings, toSessionContract, transcriptionRetryAfterSeconds, verifyWebhookChallenge, verifyWebhookSignature };
+/**
+ * Store padrão do cache de `mediaId`, na própria linha da biblioteca de mídia.
+ *
+ * A porta `FlowMediaIdStore` existe para o host poder escolher Redis ou memória. Esta é a
+ * implementação que o módulo já traz pronta, para o caso comum não exigir nada de quem instala: a
+ * tabela é do módulo, a coluna é do módulo, e sem isso todo host reescreveria o mesmo repositório.
+ *
+ * Um mapa por `phone_number_id` na mesma linha, e não uma tabela à parte: o id não existe sem o
+ * arquivo, morre com ele, e a linha é lida de qualquer forma no envio.
+ */
+declare class FlowMediaIdRepository implements FlowMediaIdStore {
+    private readonly db;
+    constructor(db: MetaWhatsAppDatabase);
+    get(params: {
+        flowMediaId: string;
+        senderKey: string;
+    }): Promise<string | undefined>;
+    /**
+     * Grava só a chave deste número.
+     *
+     * `jsonb_set` no banco, e não ler-alterar-escrever na aplicação: dois clientes passando pelo nó
+     * ao mesmo tempo com números diferentes leriam o mesmo mapa e o último gravaria por cima,
+     * apagando o id do outro. A escrita atômica não tem essa janela.
+     */
+    set(params: {
+        flowMediaId: string;
+        senderKey: string;
+        mediaId: string;
+    }): Promise<void>;
+    /** Remove só a chave deste número — o id do outro número continua válido. */
+    clear(params: {
+        flowMediaId: string;
+        senderKey: string;
+    }): Promise<void>;
+}
+
+export { type AttachFlowMediaParams, type AudioTranscriber, type CompanyDocumentView, type CompanyDocumentsPage, type ConversationDocumentView, type ConversationDocumentsPage, type CreateFlowGraphParams, CreateFlowGraphUseCase, type CreateMetaWhatsAppModuleParams, type CreateSendMediaActionParams, type CreateSendProductListActionParams, DEFAULT_FLOW_GRAPH_CACHE_TTL_SECONDS, type DeleteConversationParams, type DeleteConversationResult, DeleteConversationUseCase, DeleteFlowGraphUseCase, DocumentRepository, type DocumentRow, type DrizzleMigrateFunction, type ExportConversationParams, type ExportConversationResult, ExportConversationUseCase, FlowGraphCache, FlowGraphRepository, type FlowGraphRow, FlowInterpreter, type FlowMediaIdCache, FlowMediaIdRepository, type FlowMediaIdStore, type FlowMediaLocation, FlowMediaRepository, type FlowMediaRow, type FlowMediaTranscriptLogger, type FlowRunResult, type FlowStepInput, type FlowStepResult, GetFlowGraphUseCase, GetLiveFlowPositionsUseCase, type InboundDispatchJob, type InboundDispatchQueueInterface, InboundEffectsDispatcher, type InboundMediaDescriptor, type InboundMessageEffectsJob, type InboundStatusEffectsJob, type IngestInboundMediaParams, type IngestInboundMediaResult, IngestInboundMediaUseCase, type IngestTranscriptionOptions, type InsertMessageParams, InvalidFlowGraphError, type LinkDocumentParams, type ListCompanyDocumentsParams, ListCompanyDocumentsUseCase, type ListConversationDocumentsParams, ListConversationDocumentsUseCase, type ListConversationsFilters, type ListConversationsParams, ListConversationsUseCase, type ListDocumentsParams, type ListDocumentsResult, ListFlowGraphsUseCase, type ListMessagesParams, ListMessagesUseCase, type LogMessageParams, LogMessageUseCase, META_WHATSAPP_MIGRATIONS_TABLE, type MessageModerator, MessageRepository, type MessageRow, type MetaWhatsAppDatabase, type MetaWhatsAppModule, type MetaWhatsAppModuleConfig, type MetaWhatsAppModuleFeatures, type MetaWhatsAppModuleProviders, type MetaWhatsAppTranscriptionConfig, type NewDocumentRow, type NewFlowGraphRow, type NewFlowMediaRow, type NewMessageRow, type NewSessionRow, type NewSettingsRow, type NonceStoreInterface, OptimisticLockError, PRODUCT_LIST_LIMIT, type PreviewMediaSupport, ProcessInboundDispatchUseCase, type PurgeExpiredDocumentsParams, type PurgeExpiredDocumentsResult, PurgeExpiredDocumentsUseCase, type RealtimeRelay, type ReceiveWebhookParams, type ReceiveWebhookResult, ReceiveWebhookUseCase, type ReleaseConversationParams, ReleaseConversationUseCase, type ListMessagesParams$1 as RepositoryListMessagesParams, type ResolveTranscriptionPolicyDependencies, type RunMetaWhatsAppMigrationsParams, type SaveFlowGraphParams, SaveFlowGraphUseCase, type SaveTranscriptionByWaMessageIdParams, type SaveTranscriptionParams, type SendMediaParams, SendMessageUseCase, type SendTemplateParams, type SendTextParams, SessionRepository, type SessionRow, SettingsRepository, type SettingsRow, SseHub, type SseListener, type StorePreviewMediaParams, type StorePreviewMediaResult, StorePreviewMediaUseCase, TRANSCRIPTION_MODE, TRANSCRIPTION_STATUS, type TakeoverConversationParams, TakeoverConversationUseCase, type TicketStoreInterface, type TranscribeAudioDependencies, type TranscribeAudioParams, type TranscribeAudioResult, TranscribeAudioUseCase, type TranscriptionPolicy, type TranscriptionPolicyDefaults, type TranscriptionPolicyResolver, type TranscriptionStatus, type UpdateFlowMediaParams, WhatsAppChannelAdapter, buildInboundJobId, claimWebhookDelivery, confirmWebhookDelivery, createMetaWhatsAppModule, createSendMediaAction, createSendProductListAction, createTranscriptionPolicyResolver, documents, extractMediaDescriptor, flowGraphs, flowMedia, isAudioMimeType, isRetriableTranscriptionError, isUnsupportedTranscriptionError, issueSseTicket, messages, metaWhatsAppMigrationsFolder, metaWhatsAppSchema, redeemSseTicket, resolveFailureStatus, runMetaWhatsAppMigrations, sessions, settings, toSessionContract, transcriptionRetryAfterSeconds, verifyWebhookChallenge, verifyWebhookSignature };