@adatechnology/conversations-ui 0.1.0-rc.8 → 0.1.0

package/dist/preview/index.d.ts

@@ -1,6 +1,8 @@
-import { y as MessagePayload, m as ConversationSummary, k as ConversationEventSource, o as ConversationsApi, L as ListConversationsParams, l as ConversationPage, S as SSEProvider, i as ConversationDocument, A as ResolveMediaUrl } from '../types-B5C1DLu1.js';
+import { U as MessagePayload, u as ConversationSummary, m as ConversationEventSource, w as ConversationsApi, Q as ListConversationsParams, n as ConversationPage, a5 as SSEProvider, k as ConversationDocument, a6 as SendPreviewMediaParams, Z as PreviewUploadedMedia, $ as PreviewWebhookClient, a3 as ResolveMediaUrl } from '../ConversationSimulatorPanel--5fIzXWY.js';
+export { A as AudioRecorderButton, a as AudioRecorderButtonLabels, b as AudioRecorderButtonProps, o as ConversationPreview, p as ConversationPreviewProps, q as ConversationSimulatorClient, r as ConversationSimulatorPanel, s as ConversationSimulatorPanelLabels, t as ConversationSimulatorPanelProps, B as CreatePreviewMediaUploaderParams, D as CreatePreviewWebhookClientParams, E as DEFAULT_AUDIO_RECORDER_BUTTON_LABELS, G as DEFAULT_CONVERSATION_SIMULATOR_PANEL_LABELS, I as DEFAULT_MEDIA_UPLOAD_PATH, W as PreviewInProductionError, X as PreviewMediaUploadRejectedError, Y as PreviewMediaUploadRequest, _ as PreviewUploadedMedia, a0 as PreviewWebhookRejectedError, a4 as SIMULATOR_FILE_MEDIA_KINDS, a7 as SendSimulatorMediaParams, a8 as SimulatorMediaKind, a9 as ToSimulatorClientParams, ac as acceptsMediaKind, ad as assertPreviewEnvironment, ah as createPreviewMediaPoster, ai as createPreviewMediaUploader, aj as createPreviewWebhookClient, al as isConversationSimulatorClient, am as mediaKindOf, an as mediaTypeOf, ao as signPreviewPayload, ap as simulatorPanelLabelsOf, aq as toConversationSimulatorClient } from '../ConversationSimulatorPanel--5fIzXWY.js';
+import { InteractiveReplyOption } from '@adatechnology/meta-whatsapp-contracts/testing';
 import * as react from 'react';
-import { InteractiveReplyOption, InboundMediaType } from '@adatechnology/meta-whatsapp-contracts/testing';
+export { PREVIEW_MEDIA_ID_PREFIX } from '@adatechnology/meta-whatsapp-contracts';
 
 /**
  * Estado em memória que alimenta o preview de atendimento humano. Mock de API e mock de SSE
@@ -112,122 +114,77 @@ declare const PREVIEW_MESSAGES: Readonly<Record<string, readonly MessagePayload[
 declare const PREVIEW_DOCUMENTS: Readonly<Record<string, readonly ConversationDocument[]>>;
 
 /**
- * Cliente que entrega mensagens do preview no webhook real, assinadas com HMAC — a mesma validação
- * de staging e produção, sem rota alternativa e sem bypass. Do ponto de vista da API, este cliente
- * é indistinguível da Meta; o que muda é apenas quem assina.
+ * Cliente do preview que NÃO carrega segredo: em vez de montar e assinar o payload da Meta no
+ * navegador, manda um comando semântico (`{ kind: 'text', text }`) para uma rota do próprio host,
+ * autenticada pela sessão que o painel já tem. Quem monta o payload e assina é o servidor, com o
+ * app secret que nunca sai de lá.
  *
- * Assina com WebCrypto porque `node:crypto` não existe no navegador. Os builders vêm dos contratos
- * (isomórficos) justamente para que o mesmo payload seja montado nos dois runtimes.
+ * Por que esta fábrica existe ao lado de `createPreviewWebhookClient`: assinar no navegador exige o
+ * app secret dentro do bundle, e bundle é público por definição — em qualquer ambiente com URL
+ * acessível isso é o mesmo que publicar o segredo. Com o segredo vazado, qualquer um forja webhooks
+ * válidos daquele app: injeta mensagens de qualquer número e dispara os fluxos. `createPreviewWebhook
+ * Client` continua servindo para execução puramente local (docker de dev, onde o bundle não é
+ * servido para ninguém); para qualquer ambiente publicado, a ponte é o caminho.
  *
- * ⚠️ Isto carrega o app secret de DESENVOLVIMENTO no bundle. Só existe para o docker local, e
- * `assertPreviewEnvironment` recusa rodar em produção — um segredo de dev vazado é irrelevante,
- * mas o hábito de embarcar segredo em frontend não é.
+ * O pacote não decide autenticação: o host injeta `sendCommand` (ou `headers` + `fetchImplementation`),
+ * porque token, cookie e cabeçalho de sessão são do produto, não da biblioteca.
  */
 
-type PreviewWebhookClient = {
-    sendText(text: string): Promise<void>;
-    sendButtonReply(reply: InteractiveReplyOption): Promise<void>;
-    sendListReply(reply: InteractiveReplyOption): Promise<void>;
-    sendAudio(mediaId: string): Promise<void>;
-    sendMedia(params: SendPreviewMediaParams): Promise<void>;
-};
-type SendPreviewMediaParams = {
-    readonly mediaType: InboundMediaType;
-    /**
-     * Id que o host já usa para buscar o arquivo. Não é bytes: o webhook da Meta entrega mídia por
-     * referência, e o consumidor baixa depois — mandar base64 aqui simularia um payload que a Meta
-     * nunca produz, e o caminho testado deixaria de ser o de produção.
-     */
+/**
+ * Comando semântico entregue ao host. É deliberadamente o QUE o cliente fez, não o payload da Meta:
+ * se o navegador mandasse o payload pronto, a rota viraria um injetor de webhook arbitrário para
+ * quem tivesse sessão. Mandando a intenção, o servidor é quem escolhe a forma.
+ */
+type PreviewInboundCommand = {
+    readonly kind: 'text';
+    readonly from: string;
+    readonly text: string;
+} | {
+    readonly kind: 'buttonReply';
+    readonly from: string;
+    readonly reply: InteractiveReplyOption;
+} | {
+    readonly kind: 'listReply';
+    readonly from: string;
+    readonly reply: InteractiveReplyOption;
+} | {
+    readonly kind: 'audio';
+    readonly from: string;
     readonly mediaId: string;
-    readonly mimeType?: string;
-    readonly filename?: string;
-    readonly caption?: string;
-};
-type CreatePreviewWebhookClientParams = {
-    readonly webhookUrl: string;
-    readonly appSecret: string;
+} | ({
+    readonly kind: 'media';
     readonly from: string;
-    readonly phoneNumberId?: string;
-    readonly fetchImplementation?: typeof fetch;
-};
-declare class PreviewInProductionError extends Error {
-    constructor();
-}
-declare class PreviewWebhookRejectedError extends Error {
+} & SendPreviewMediaParams);
+type SendPreviewInboundCommand = (command: PreviewInboundCommand) => Promise<void>;
+declare class PreviewBridgeRejectedError extends Error {
     readonly status: number;
     constructor(status: number);
 }
-/**
- * Falha alto em vez de degradar em silêncio: um preview que "quase funciona" em produção é pior
- * que um que se recusa a montar.
- */
-declare function assertPreviewEnvironment(isProduction: boolean): void;
-/**
- * Assina um texto qualquer com o app secret, no mesmo formato do header da Meta.
- *
- * Exportada porque o preview precisa provar identidade em MAIS de um lugar: além de entregar a
- * mensagem no webhook, ele lê o transcript de volta — e ler pela API de admin exigia uma sessão que
- * a aba do simulador não tem. Assinar a leitura com o segredo que ele já carrega resolve sem token
- * de admin e sem rota aberta.
- */
-declare function signPreviewPayload(params: {
-    rawBody: string;
-    appSecret: string;
-}): Promise<string>;
-declare function createPreviewWebhookClient(params: CreatePreviewWebhookClientParams): PreviewWebhookClient;
-
-type ConversationPreviewProps = {
-    client: PreviewWebhookClient;
-    sse: SSEProvider;
-    conversationId: string;
-    loadMessages: (conversationId: string) => Promise<MessagePayload[]>;
-    placeholder?: string;
+type CreatePreviewBridgeClientParams = {
+    readonly from: string;
     /**
-     * Recarrega o transcript a cada N ms. Serve a host SEM stream: a resposta do bot é assíncrona, e
-     * sem SSE nem polling ela só apareceria no próximo envio — o sintoma é "às vezes ele não
-     * responde". Ausente, não faz polling (host com SSE não precisa).
+     * Entrega o comando. Use quando o host já tem um cliente HTTP com sessão, interceptors e refresh
+     * de token — reimplementar isso aqui só duplicaria a autenticação do produto.
      */
-    pollIntervalMs?: number;
+    readonly sendCommand?: SendPreviewInboundCommand;
+    /** Alternativa a `sendCommand` para hosts sem cliente HTTP próprio. */
+    readonly endpointUrl?: string;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly fetchImplementation?: typeof fetch;
     /**
-     * Como transformar um arquivo do disco (ou o áudio gravado) na referência que o webhook carrega.
-     * O caminho da Meta entrega mídia por `id`, e quem sabe hospedar o arquivo é o host — a SDK não
-     * inventa um endpoint de upload. Ausente, o compositor não oferece anexo nem gravação: melhor um
-     * botão que não existe do que um que falha ao ser tocado.
+     * Rota que guarda o áudio gravado. Por padrão, `/v1/preview/media` na origem do `endpointUrl`.
+     *
+     * Aqui não há assinatura a calcular: a ponte existe justamente para não ter segredo no navegador,
+     * e a rota é protegida pela sessão do painel — os mesmos `headers` do comando valem para o upload.
      */
-    uploadMedia?: (file: File) => Promise<PreviewUploadedMedia>;
-};
-type PreviewUploadedMedia = {
-    readonly mediaId: string;
-    readonly mimeType?: string;
-    readonly filename?: string;
+    readonly mediaUploadUrl?: string;
+    /**
+     * Substitui o upload embutido. Necessário para host que só passa `sendCommand`: sem `endpointUrl`
+     * não há origem a derivar, e sem destino o gravador não é desenhado.
+     */
+    readonly uploadMedia?: (file: File) => Promise<PreviewUploadedMedia>;
 };
-/** Deriva o tipo de mídia do WhatsApp a partir do MIME do arquivo escolhido. */
-declare function mediaTypeOf(mimeType: string): SendPreviewMediaParams['mediaType'];
-declare function ConversationPreview({ client, sse, conversationId, loadMessages, placeholder, pollIntervalMs, uploadMedia, }: ConversationPreviewProps): react.JSX.Element;
-
-/**
- * Gravação de áudio no simulador, pelo microfone do próprio navegador.
- *
- * Existe porque áudio é o formato que mais chega de cliente real e o que mais quebra fluxo: sem
- * poder gravar aqui, testar o caminho de transcrição exigia mandar mensagem do celular de alguém.
- *
- * O arquivo gravado sai daqui como `File` e segue exatamente o mesmo caminho de um anexo — quem
- * hospeda e devolve o `mediaId` é o host, via `uploadMedia`.
- */
-interface AudioRecorderButtonLabels {
-    start: string;
-    stop: string;
-    unsupported: string;
-    denied: string;
-}
-declare const DEFAULT_AUDIO_RECORDER_BUTTON_LABELS: AudioRecorderButtonLabels;
-interface AudioRecorderButtonProps {
-    onRecorded: (file: File) => void | Promise<void>;
-    onFailure?: (message: string) => void;
-    labels?: Partial<AudioRecorderButtonLabels>;
-    disabled?: boolean;
-}
-declare function AudioRecorderButton({ onRecorded, onFailure, labels, disabled }: AudioRecorderButtonProps): react.JSX.Element;
+declare function createPreviewBridgeClient(params: CreatePreviewBridgeClientParams): PreviewWebhookClient;
 
 /**
  * Roteiro que mantém o preview vivo: sem tráfego chegando, a inbox é uma tela estática e as
@@ -327,4 +284,4 @@ type MediaTypesPreviewProps = {
 };
 declare function MediaTypesPreview({ conversationId, className, }: MediaTypesPreviewProps): react.JSX.Element;
 
-export { type AppendMessageParams, AudioRecorderButton, type AudioRecorderButtonLabels, type AudioRecorderButtonProps, ConversationPreview, type ConversationPreviewProps, type CreateMockConversationsApiParams, type CreateMockSSEProviderParams, type CreatePreviewStoreParams, type CreatePreviewWebhookClientParams, DEFAULT_AUDIO_RECORDER_BUTTON_LABELS, DEFAULT_PREVIEW_SCRIPT, GLOBAL_CHANNEL, type ListConversationsFilters, MEDIA_TYPES_CONVERSATION_ID, MediaTypesPreview, type MediaTypesPreviewProps, type MockEventSource, PREVIEW_CONVERSATIONS, PREVIEW_DOCUMENTS, PREVIEW_FILE_SAMPLES, PREVIEW_MESSAGES, type PreviewEmission, PreviewInProductionError, type PreviewScriptStep, type PreviewStore, type PreviewStoreListener, type PreviewUploadedMedia, type PreviewWebhookClient, PreviewWebhookRejectedError, type SendPreviewMediaParams, type SetModeParams, type StartPreviewScriptParams, assertPreviewEnvironment, conversationChannel, createMockConversationsApi, createMockEventSource, createMockSSEProvider, createPreviewMediaResolver, createPreviewStore, createPreviewWebhookClient, mediaTypeOf, previewFileBase64, previewFileUrl, resolvePreviewFileSample, signPreviewPayload, startPreviewScript };
+export { type AppendMessageParams, type CreateMockConversationsApiParams, type CreateMockSSEProviderParams, type CreatePreviewBridgeClientParams, type CreatePreviewStoreParams, DEFAULT_PREVIEW_SCRIPT, GLOBAL_CHANNEL, type ListConversationsFilters, MEDIA_TYPES_CONVERSATION_ID, MediaTypesPreview, type MediaTypesPreviewProps, type MockEventSource, PREVIEW_CONVERSATIONS, PREVIEW_DOCUMENTS, PREVIEW_FILE_SAMPLES, PREVIEW_MESSAGES, PreviewBridgeRejectedError, type PreviewEmission, type PreviewInboundCommand, type PreviewScriptStep, type PreviewStore, type PreviewStoreListener, PreviewWebhookClient, type SendPreviewInboundCommand, SendPreviewMediaParams, type SetModeParams, type StartPreviewScriptParams, conversationChannel, createMockConversationsApi, createMockEventSource, createMockSSEProvider, createPreviewBridgeClient, createPreviewMediaResolver, createPreviewStore, previewFileBase64, previewFileUrl, resolvePreviewFileSample, startPreviewScript };