@adatechnology/conversations-ui 0.1.0-rc.2 → 0.1.0-rc.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (106) hide show
  1. package/dist/{chunk-ZDURDZTM.js → chunk-2AYDBWNE.js} +14 -0
  2. package/dist/chunk-TV4OQRGH.js +2187 -0
  3. package/dist/flows/index.d.ts +14 -2
  4. package/dist/flows/index.js +117 -39
  5. package/dist/index.d.ts +862 -136
  6. package/dist/index.js +1746 -1124
  7. package/dist/preview/index.d.ts +470 -0
  8. package/dist/preview/index.js +1329 -0
  9. package/dist/styles.css +228 -0
  10. package/dist/types-C6A_9edv.d.ts +456 -0
  11. package/package.json +10 -3
  12. package/src/AudioRecorderButton.test.tsx +30 -0
  13. package/src/AudioRecorderButton.tsx +248 -0
  14. package/src/AudioTranscription.test.tsx +115 -0
  15. package/src/AudioTranscription.tsx +249 -0
  16. package/src/Avatar.tsx +30 -4
  17. package/src/ChannelIcon.tsx +87 -0
  18. package/src/ConversationContextPanel.tsx +280 -0
  19. package/src/ConversationDocumentsPanel.tsx +425 -0
  20. package/src/ConversationHeader.tsx +257 -0
  21. package/src/ConversationListItem.tsx +54 -7
  22. package/src/ConversationLocalesProvider.tsx +44 -0
  23. package/src/ConversationRow.tsx +137 -0
  24. package/src/DateDivider.tsx +16 -3
  25. package/src/DocumentsLibrary.tsx +322 -0
  26. package/src/EmojiPicker.tsx +69 -55
  27. package/src/FileIcon.test.ts +83 -0
  28. package/src/FileIcon.tsx +88 -11
  29. package/src/InteractiveMessage.test.tsx +41 -0
  30. package/src/InteractiveMessage.tsx +143 -0
  31. package/src/Lightbox.tsx +18 -3
  32. package/src/MediaRenderer.tsx +96 -22
  33. package/src/MessageBubble.tsx +77 -5
  34. package/src/MessageComposer.test.tsx +35 -0
  35. package/src/MessageComposer.tsx +165 -19
  36. package/src/RichMessageComposer.test.tsx +83 -0
  37. package/src/RichMessageComposer.tsx +380 -0
  38. package/src/Wallpaper.test.tsx +21 -0
  39. package/src/Wallpaper.tsx +69 -7
  40. package/src/WhatsAppMessageEditor.tsx +28 -4
  41. package/src/WindowExpiredNotice.tsx +57 -0
  42. package/src/audioRecorderFormat.test.ts +67 -0
  43. package/src/conversationChannel.test.ts +53 -0
  44. package/src/conversationChannel.ts +146 -0
  45. package/src/conversationTranscript.test.ts +122 -0
  46. package/src/conversationTranscript.ts +89 -0
  47. package/src/conversationWindow.test.ts +90 -0
  48. package/src/conversationWindow.ts +78 -0
  49. package/src/documentTypeLabel.test.ts +57 -0
  50. package/src/emojiCatalog.test.ts +35 -0
  51. package/src/emojiCatalog.ts +189 -0
  52. package/src/flows/FlowGroupHeader.tsx +12 -2
  53. package/src/flows/FlowMapCanvas.tsx +17 -14
  54. package/src/flows/FlowMapNode.tsx +3 -1
  55. package/src/flows/FlowNodeCard.tsx +22 -4
  56. package/src/flows/FlowNodePanel.tsx +132 -35
  57. package/src/flows/FlowPalette.tsx +6 -2
  58. package/src/flows/FlowWhatsAppPreview.tsx +14 -3
  59. package/src/flows/flowGraph.ts +5 -5
  60. package/src/flows/labels.ts +5 -0
  61. package/src/hooks/useConversationActions.ts +56 -0
  62. package/src/hooks/useConversationDocuments.ts +15 -9
  63. package/src/hooks/useConversationList.ts +15 -9
  64. package/src/hooks/useConversationMessages.ts +2 -2
  65. package/src/hooks/useScrollToLatestMessage.ts +127 -0
  66. package/src/index.ts +140 -16
  67. package/src/lib/cn.test.ts +29 -0
  68. package/src/lib/cn.ts +15 -0
  69. package/src/lib/createMediaUrlResolver.ts +33 -0
  70. package/src/lib/paginated.test.ts +33 -0
  71. package/src/lib/paginated.ts +26 -0
  72. package/src/lib/phone.ts +34 -0
  73. package/src/preview/ConversationPreview.tsx +334 -0
  74. package/src/preview/MediaTypesPreview.tsx +87 -0
  75. package/src/preview/conversationPreviewFailures.test.ts +64 -0
  76. package/src/preview/createMockConversationsApi.ts +271 -0
  77. package/src/preview/createMockSSEProvider.ts +40 -0
  78. package/src/preview/createPreviewBridgeClient.test.ts +92 -0
  79. package/src/preview/createPreviewBridgeClient.ts +124 -0
  80. package/src/preview/createPreviewMediaUploader.ts +82 -0
  81. package/src/preview/createPreviewWebhookClient.test.ts +194 -0
  82. package/src/preview/createPreviewWebhookClient.ts +222 -0
  83. package/src/preview/index.ts +67 -0
  84. package/src/preview/mediaTypeOf.test.ts +15 -0
  85. package/src/preview/mockDocumentsSearch.test.ts +57 -0
  86. package/src/preview/mockEventSource.ts +53 -0
  87. package/src/preview/preview.test.ts +177 -0
  88. package/src/preview/previewFileSamples.test.ts +151 -0
  89. package/src/preview/previewFileSamples.ts +74 -0
  90. package/src/preview/previewFixtures.ts +440 -0
  91. package/src/preview/previewMediaSource.test.ts +62 -0
  92. package/src/preview/previewMediaSource.ts +91 -0
  93. package/src/preview/previewMediaUploader.test.ts +61 -0
  94. package/src/preview/previewStore.ts +193 -0
  95. package/src/preview/startPreviewScript.ts +60 -0
  96. package/src/providers/types.ts +175 -12
  97. package/src/quickReply.test.ts +58 -0
  98. package/src/settings/TranscriptionSettingsForm.test.tsx +81 -0
  99. package/src/settings/TranscriptionSettingsForm.tsx +189 -0
  100. package/src/settings/WhatsAppCreateTemplateForm.tsx +3 -1
  101. package/src/settings/WhatsAppTemplatesSettings.tsx +106 -0
  102. package/src/styles.css +173 -0
  103. package/src/types.ts +72 -1
  104. package/src/useDarkMode.ts +26 -0
  105. package/src/useIsNarrow.ts +29 -0
  106. package/src/useWaitingNotifications.ts +74 -29
@@ -0,0 +1,470 @@
1
+ import { G as MessagePayload, o as ConversationSummary, m as ConversationEventSource, q as ConversationsApi, L as ListConversationsParams, n as ConversationPage, S as SSEProvider, k as ConversationDocument, N as ResolveMediaUrl } from '../types-C6A_9edv.js';
2
+ export { A as AudioRecorderButton, a as AudioRecorderButtonLabels, b as AudioRecorderButtonProps, D as DEFAULT_AUDIO_RECORDER_BUTTON_LABELS } from '../types-C6A_9edv.js';
3
+ import * as react from 'react';
4
+ import { InteractiveReplyOption, InboundMediaType } from '@adatechnology/meta-whatsapp-contracts/testing';
5
+ export { PREVIEW_MEDIA_ID_PREFIX } from '@adatechnology/meta-whatsapp-contracts';
6
+
7
+ /**
8
+ * Estado em memória que alimenta o preview de atendimento humano. Mock de API e mock de SSE
9
+ * compartilham este store de propósito: se cada um tivesse dados próprios, um evento anunciaria
10
+ * mensagem nova e o refetch da lista devolveria o estado antigo — a inbox pareceria funcionar e
11
+ * estaria mentindo, que é exatamente o defeito que o preview deveria expor.
12
+ *
13
+ * Os nomes de canal e de evento espelham o servidor (`conv:<whatsappNumber>`, `global`,
14
+ * `message`/`message-status`/`mode-changed`/`data-changed`). Fidelidade de vocabulário é o que
15
+ * permite trocar mock por servidor real sem tocar na UI.
16
+ */
17
+
18
+ declare const GLOBAL_CHANNEL = "global";
19
+ declare function conversationChannel(conversationId: string): string;
20
+ type PreviewEmission = {
21
+ readonly channel: string;
22
+ readonly event: string;
23
+ readonly payload: Record<string, unknown>;
24
+ };
25
+ type PreviewStoreListener = (emission: PreviewEmission) => void;
26
+ type AppendMessageParams = {
27
+ readonly conversationId: string;
28
+ readonly content: string;
29
+ readonly direction: MessagePayload['direction'];
30
+ readonly sender: MessagePayload['sender'];
31
+ };
32
+ type SetModeParams = {
33
+ readonly conversationId: string;
34
+ readonly mode: ConversationSummary['mode'];
35
+ readonly assignedUserId?: string | undefined;
36
+ };
37
+ type ListConversationsFilters = {
38
+ readonly waitingHuman?: boolean;
39
+ readonly search?: string;
40
+ };
41
+ type PreviewStore = {
42
+ listConversations(filters?: ListConversationsFilters): ConversationSummary[];
43
+ listMessages(conversationId: string): MessagePayload[];
44
+ appendMessage(params: AppendMessageParams): MessagePayload;
45
+ setMode(params: SetModeParams): void;
46
+ requestHuman(conversationId: string): void;
47
+ markRead(conversationId: string): void;
48
+ subscribe(channel: string, listener: PreviewStoreListener): () => void;
49
+ };
50
+ type CreatePreviewStoreParams = {
51
+ readonly conversations: readonly ConversationSummary[];
52
+ readonly messages: Readonly<Record<string, readonly MessagePayload[]>>;
53
+ readonly now?: () => Date;
54
+ };
55
+ declare function createPreviewStore(params: CreatePreviewStoreParams): PreviewStore;
56
+
57
+ /**
58
+ * `EventSource` só existe com um servidor HTTP do outro lado — é justamente o que falta quando se
59
+ * quer a inbox rodando com dados mockados. Este é o objeto mínimo que satisfaz
60
+ * `ConversationEventSource`: assina eventos nomeados, desassina e fecha.
61
+ *
62
+ * Não imita `EventSource` por completo de propósito: um fake "quase real" convida a depender de
63
+ * membros que o pacote não usa, e passa a quebrar a cada mudança de runtime.
64
+ */
65
+
66
+ type MockEventSource = ConversationEventSource & {
67
+ emit(event: string, payload: unknown): void;
68
+ readonly closed: boolean;
69
+ };
70
+ declare function createMockEventSource(): MockEventSource;
71
+
72
+ /**
73
+ * `ConversationsApi` servido pelo store em memória. Como o pacote é headless e recebe a API por
74
+ * injeção, o preview de atendimento humano não precisa de servidor, banco nem Meta: é só outra
75
+ * implementação deste mesmo contrato.
76
+ *
77
+ * Toda resposta é assíncrona e passa por um atraso configurável — API instantânea esconde estados
78
+ * de carregamento, e é neles que a inbox costuma mostrar defeito.
79
+ */
80
+
81
+ type CreateMockConversationsApiParams = {
82
+ readonly store: PreviewStore;
83
+ readonly latencyMs?: number;
84
+ readonly agentName?: string;
85
+ };
86
+ /**
87
+ * O mock satisfaz `ConversationsApi`, mas com o retorno de `fetchConversations` ESTREITADO para a
88
+ * forma paginada. Sem isto o contrato — que aceita array ou página — obrigaria todo consumidor do
89
+ * preview a desempacotar uma união que aqui nunca varia.
90
+ */
91
+ type MockConversationsApi = Omit<ConversationsApi, 'fetchConversations'> & {
92
+ fetchConversations(params?: ListConversationsParams): Promise<ConversationPage>;
93
+ };
94
+ declare function createMockConversationsApi(params: CreateMockConversationsApiParams): MockConversationsApi;
95
+
96
+ /**
97
+ * `SSEProvider` servido pelo store em memória. Mesmo mapeamento de canal do servidor
98
+ * (`conv:<conversationId>` e `global`), para que a UI não perceba a troca.
99
+ */
100
+
101
+ type CreateMockSSEProviderParams = {
102
+ readonly store: PreviewStore;
103
+ };
104
+ declare function createMockSSEProvider(params: CreateMockSSEProviderParams): SSEProvider;
105
+
106
+ /**
107
+ * Conversas de partida do preview. Cobrem o espaço de estados que a inbox precisa saber desenhar —
108
+ * bot em atendimento, cliente esperando humano, conversa já assumida por atendente, conversa com
109
+ * áudio — porque estado que não aparece em fixture é estado que ninguém testa.
110
+ */
111
+
112
+ declare const PREVIEW_CONVERSATIONS: readonly ConversationSummary[];
113
+ declare const PREVIEW_MESSAGES: Readonly<Record<string, readonly MessagePayload[]>>;
114
+ declare const PREVIEW_DOCUMENTS: Readonly<Record<string, readonly ConversationDocument[]>>;
115
+
116
+ /**
117
+ * Entrega ao simulador o `uploadMedia` que ele precisa para desenhar o microfone.
118
+ *
119
+ * O `ConversationPreview` esconde o gravador sem esta função, e com razão: microfone que grava sem
120
+ * ter onde guardar o arquivo faz o operador falar para o vazio. O que faltava era montar isto —
121
+ * lê o `File`, manda para a rota do host, devolve o `mediaId` prefixado que o webhook referencia.
122
+ *
123
+ * Fica no pacote porque a parte que erra é sempre a mesma em todo produto: converter o binário sem
124
+ * estourar a pilha e marcar o id com o prefixo que o backend reconhece. O que muda por produto é só
125
+ * a rota e o cliente HTTP — e é exatamente isso que entra por parâmetro.
126
+ */
127
+ /**
128
+ * Do `contracts`, que este pacote já consome — não uma cópia.
129
+ *
130
+ * A convenção tem duas pontas (o front gera o id, o backend resolve) e a versão anterior disso vivia
131
+ * duplicada em dois pacotes de um produto, cada cópia com um comentário pedindo para não divergir.
132
+ * Contrato compartilhado é o que o `contracts` existe para guardar.
133
+ */
134
+
135
+ type PreviewUploadedMedia$1 = {
136
+ readonly mediaId: string;
137
+ readonly mimeType?: string;
138
+ readonly filename?: string;
139
+ };
140
+ type PreviewMediaUploadRequest = {
141
+ readonly base64: string;
142
+ readonly mimeType: string;
143
+ readonly filename: string;
144
+ };
145
+ type CreatePreviewMediaUploaderParams = {
146
+ /**
147
+ * Envia o arquivo à rota do host e devolve o `uploadId` (sem prefixo) que o backend gerou.
148
+ *
149
+ * Recebe a função inteira, e não uma URL, porque autenticação varia: uma instalação assina com
150
+ * HMAC, outra manda token de admin, outra usa cookie de sessão. Pedir a URL obrigaria o pacote a
151
+ * escolher por elas.
152
+ */
153
+ readonly upload: (request: PreviewMediaUploadRequest) => Promise<{
154
+ uploadId: string;
155
+ }>;
156
+ /** Nome usado quando o gravador entrega o áudio sem nome próprio. */
157
+ readonly fallbackFilename?: string;
158
+ readonly fallbackMimeType?: string;
159
+ };
160
+ declare function createPreviewMediaUploader(params: CreatePreviewMediaUploaderParams): (file: File) => Promise<PreviewUploadedMedia$1>;
161
+
162
+ /**
163
+ * Cliente que entrega mensagens do preview no webhook real, assinadas com HMAC — a mesma validação
164
+ * de staging e produção, sem rota alternativa e sem bypass. Do ponto de vista da API, este cliente
165
+ * é indistinguível da Meta; o que muda é apenas quem assina.
166
+ *
167
+ * Assina com WebCrypto porque `node:crypto` não existe no navegador. Os builders vêm dos contratos
168
+ * (isomórficos) justamente para que o mesmo payload seja montado nos dois runtimes.
169
+ *
170
+ * ⚠️ SOMENTE EXECUÇÃO LOCAL. Isto carrega o app secret no bundle, e bundle é público onde quer que
171
+ * seja servido — em qualquer ambiente com URL acessível (homologação inclusive) usar esta fábrica
172
+ * equivale a publicar o segredo, e quem o tiver forja webhooks válidos daquele app da Meta: injeta
173
+ * mensagem de qualquer número e dispara os fluxos. `assertPreviewEnvironment` barra produção, mas
174
+ * homologação passaria, então a barreira não basta.
175
+ *
176
+ * Para qualquer ambiente publicado use `createPreviewBridgeClient`: o navegador manda a intenção e
177
+ * o servidor assina com o segredo que ele já tem.
178
+ */
179
+
180
+ type PreviewWebhookClient = {
181
+ sendText(text: string): Promise<void>;
182
+ sendButtonReply(reply: InteractiveReplyOption): Promise<void>;
183
+ sendListReply(reply: InteractiveReplyOption): Promise<void>;
184
+ sendAudio(mediaId: string): Promise<void>;
185
+ sendMedia(params: SendPreviewMediaParams): Promise<void>;
186
+ /**
187
+ * Guarda um arquivo gravado e devolve o `mediaId` já prefixado, pronto para `sendMedia`.
188
+ *
189
+ * Existe no cliente, e não como prop de quem monta a tela, porque isto é exatamente o que ele já
190
+ * sabe fazer: falar com ESTE host usando ESTE segredo. Enquanto era responsabilidade do produto,
191
+ * o resultado prático foi um produto com microfone no simulador e outro sem — não por decisão,
192
+ * por esquecimento. Cliente montado, microfone na tela.
193
+ *
194
+ * Opcional porque o cliente-ponte só consegue oferecer isto quando sabe a rota de mídia (ou quando
195
+ * o host injeta a função): sem destino, gravar áudio seria falar para o vazio, e aí a tela
196
+ * corretamente não desenha o gravador.
197
+ */
198
+ uploadMedia?(file: File): Promise<PreviewUploadedMedia$1>;
199
+ };
200
+ type SendPreviewMediaParams = {
201
+ readonly mediaType: InboundMediaType;
202
+ /**
203
+ * Id que o host já usa para buscar o arquivo. Não é bytes: o webhook da Meta entrega mídia por
204
+ * referência, e o consumidor baixa depois — mandar base64 aqui simularia um payload que a Meta
205
+ * nunca produz, e o caminho testado deixaria de ser o de produção.
206
+ */
207
+ readonly mediaId: string;
208
+ readonly mimeType?: string;
209
+ readonly filename?: string;
210
+ readonly caption?: string;
211
+ };
212
+ type CreatePreviewWebhookClientParams = {
213
+ readonly webhookUrl: string;
214
+ readonly appSecret: string;
215
+ readonly from: string;
216
+ readonly phoneNumberId?: string;
217
+ /**
218
+ * Rota que guarda o áudio gravado. Por padrão, `/v1/preview/media` na mesma origem do webhook.
219
+ *
220
+ * O padrão cobre o caso normal — as duas rotas são do mesmo servidor — e a prop existe para quem
221
+ * publica a API em outro host ou versiona o caminho.
222
+ */
223
+ readonly mediaUploadUrl?: string;
224
+ readonly fetchImplementation?: typeof fetch;
225
+ };
226
+ /** Falha da rota de upload, separada da do webhook: os dois lados quebram por motivos diferentes. */
227
+ declare class PreviewMediaUploadRejectedError extends Error {
228
+ readonly status: number;
229
+ constructor(status: number);
230
+ }
231
+ declare class PreviewInProductionError extends Error {
232
+ constructor();
233
+ }
234
+ declare class PreviewWebhookRejectedError extends Error {
235
+ readonly status: number;
236
+ constructor(status: number);
237
+ }
238
+ /**
239
+ * Falha alto em vez de degradar em silêncio: um preview que "quase funciona" em produção é pior
240
+ * que um que se recusa a montar.
241
+ */
242
+ declare function assertPreviewEnvironment(isProduction: boolean): void;
243
+ /**
244
+ * Assina um texto qualquer com o app secret, no mesmo formato do header da Meta.
245
+ *
246
+ * Exportada porque o preview precisa provar identidade em MAIS de um lugar: além de entregar a
247
+ * mensagem no webhook, ele lê o transcript de volta — e ler pela API de admin exigia uma sessão que
248
+ * a aba do simulador não tem. Assinar a leitura com o segredo que ele já carrega resolve sem token
249
+ * de admin e sem rota aberta.
250
+ */
251
+ declare function signPreviewPayload(params: {
252
+ rawBody: string;
253
+ appSecret: string;
254
+ }): Promise<string>;
255
+ declare const DEFAULT_MEDIA_UPLOAD_PATH = "/v1/preview/media";
256
+ /**
257
+ * O POST de mídia, sem a parte de assinatura — para os dois clientes usarem o mesmo caminho.
258
+ *
259
+ * O cliente-ponte autentica por sessão e o de webhook por HMAC; o que não muda é a rota, o formato
260
+ * do corpo e a leitura do `uploadId`. Duas cópias disso é como o prefixo de mídia divergiu antes.
261
+ */
262
+ declare function createPreviewMediaPoster(params: {
263
+ readonly url: string;
264
+ readonly headers?: (mimeType: string) => Promise<Readonly<Record<string, string>>>;
265
+ readonly fetchImplementation?: typeof fetch;
266
+ }): (file: File) => Promise<PreviewUploadedMedia$1>;
267
+ declare function createPreviewWebhookClient(params: CreatePreviewWebhookClientParams): PreviewWebhookClient;
268
+
269
+ type ConversationPreviewProps = {
270
+ client: PreviewWebhookClient;
271
+ sse: SSEProvider;
272
+ conversationId: string;
273
+ loadMessages: (conversationId: string) => Promise<MessagePayload[]>;
274
+ placeholder?: string;
275
+ /**
276
+ * Recarrega o transcript a cada N ms. Serve a host SEM stream: a resposta do bot é assíncrona, e
277
+ * sem SSE nem polling ela só apareceria no próximo envio — o sintoma é "às vezes ele não
278
+ * responde". Ausente, não faz polling (host com SSE não precisa).
279
+ */
280
+ pollIntervalMs?: number;
281
+ /**
282
+ * Como transformar um arquivo do disco (ou o áudio gravado) na referência que o webhook carrega.
283
+ * O caminho da Meta entrega mídia por `id`, e quem sabe hospedar o arquivo é o host — a SDK não
284
+ * inventa um endpoint de upload. Ausente, o compositor não oferece anexo nem gravação: melhor um
285
+ * botão que não existe do que um que falha ao ser tocado.
286
+ */
287
+ /** Destino alternativo do áudio gravado. Sem isto, usa o do próprio `client`. */
288
+ uploadMedia?: (file: File) => Promise<PreviewUploadedMedia>;
289
+ };
290
+ type PreviewUploadedMedia = {
291
+ readonly mediaId: string;
292
+ readonly mimeType?: string;
293
+ readonly filename?: string;
294
+ };
295
+ /** Deriva o tipo de mídia do WhatsApp a partir do MIME do arquivo escolhido. */
296
+ declare function mediaTypeOf(mimeType: string): SendPreviewMediaParams['mediaType'];
297
+ declare function ConversationPreview({ client, sse, conversationId, loadMessages, placeholder, pollIntervalMs, uploadMedia, }: ConversationPreviewProps): react.JSX.Element;
298
+
299
+ /**
300
+ * Cliente do preview que NÃO carrega segredo: em vez de montar e assinar o payload da Meta no
301
+ * navegador, manda um comando semântico (`{ kind: 'text', text }`) para uma rota do próprio host,
302
+ * autenticada pela sessão que o painel já tem. Quem monta o payload e assina é o servidor, com o
303
+ * app secret que nunca sai de lá.
304
+ *
305
+ * Por que esta fábrica existe ao lado de `createPreviewWebhookClient`: assinar no navegador exige o
306
+ * app secret dentro do bundle, e bundle é público por definição — em qualquer ambiente com URL
307
+ * acessível isso é o mesmo que publicar o segredo. Com o segredo vazado, qualquer um forja webhooks
308
+ * válidos daquele app: injeta mensagens de qualquer número e dispara os fluxos. `createPreviewWebhook
309
+ * Client` continua servindo para execução puramente local (docker de dev, onde o bundle não é
310
+ * servido para ninguém); para qualquer ambiente publicado, a ponte é o caminho.
311
+ *
312
+ * O pacote não decide autenticação: o host injeta `sendCommand` (ou `headers` + `fetchImplementation`),
313
+ * porque token, cookie e cabeçalho de sessão são do produto, não da biblioteca.
314
+ */
315
+
316
+ /**
317
+ * Comando semântico entregue ao host. É deliberadamente o QUE o cliente fez, não o payload da Meta:
318
+ * se o navegador mandasse o payload pronto, a rota viraria um injetor de webhook arbitrário para
319
+ * quem tivesse sessão. Mandando a intenção, o servidor é quem escolhe a forma.
320
+ */
321
+ type PreviewInboundCommand = {
322
+ readonly kind: 'text';
323
+ readonly from: string;
324
+ readonly text: string;
325
+ } | {
326
+ readonly kind: 'buttonReply';
327
+ readonly from: string;
328
+ readonly reply: InteractiveReplyOption;
329
+ } | {
330
+ readonly kind: 'listReply';
331
+ readonly from: string;
332
+ readonly reply: InteractiveReplyOption;
333
+ } | {
334
+ readonly kind: 'audio';
335
+ readonly from: string;
336
+ readonly mediaId: string;
337
+ } | ({
338
+ readonly kind: 'media';
339
+ readonly from: string;
340
+ } & SendPreviewMediaParams);
341
+ type SendPreviewInboundCommand = (command: PreviewInboundCommand) => Promise<void>;
342
+ declare class PreviewBridgeRejectedError extends Error {
343
+ readonly status: number;
344
+ constructor(status: number);
345
+ }
346
+ type CreatePreviewBridgeClientParams = {
347
+ readonly from: string;
348
+ /**
349
+ * Entrega o comando. Use quando o host já tem um cliente HTTP com sessão, interceptors e refresh
350
+ * de token — reimplementar isso aqui só duplicaria a autenticação do produto.
351
+ */
352
+ readonly sendCommand?: SendPreviewInboundCommand;
353
+ /** Alternativa a `sendCommand` para hosts sem cliente HTTP próprio. */
354
+ readonly endpointUrl?: string;
355
+ readonly headers?: Readonly<Record<string, string>>;
356
+ readonly fetchImplementation?: typeof fetch;
357
+ /**
358
+ * Rota que guarda o áudio gravado. Por padrão, `/v1/preview/media` na origem do `endpointUrl`.
359
+ *
360
+ * Aqui não há assinatura a calcular: a ponte existe justamente para não ter segredo no navegador,
361
+ * e a rota é protegida pela sessão do painel — os mesmos `headers` do comando valem para o upload.
362
+ */
363
+ readonly mediaUploadUrl?: string;
364
+ /**
365
+ * Substitui o upload embutido. Necessário para host que só passa `sendCommand`: sem `endpointUrl`
366
+ * não há origem a derivar, e sem destino o gravador não é desenhado.
367
+ */
368
+ readonly uploadMedia?: (file: File) => Promise<PreviewUploadedMedia$1>;
369
+ };
370
+ declare function createPreviewBridgeClient(params: CreatePreviewBridgeClientParams): PreviewWebhookClient;
371
+
372
+ /**
373
+ * Roteiro que mantém o preview vivo: sem tráfego chegando, a inbox é uma tela estática e as
374
+ * transições que o atendente precisa testar (fila de espera enchendo, handoff, devolução ao bot)
375
+ * nunca acontecem.
376
+ *
377
+ * O roteiro é cíclico e determinístico — mesma ordem a cada execução. Aleatoriedade tornaria um
378
+ * defeito visto uma vez difícil de reencontrar.
379
+ */
380
+
381
+ type PreviewScriptStep = (store: PreviewStore) => void;
382
+ declare const DEFAULT_PREVIEW_SCRIPT: readonly PreviewScriptStep[];
383
+ type StartPreviewScriptParams = {
384
+ readonly store: PreviewStore;
385
+ readonly intervalMs?: number;
386
+ readonly steps?: readonly PreviewScriptStep[];
387
+ };
388
+ declare function startPreviewScript(params: StartPreviewScriptParams): () => void;
389
+
390
+ /**
391
+ * Bytes de verdade para o preview abrir.
392
+ *
393
+ * O mock antes devolvia a MESMA imagem PNG para qualquer documento, então clicar em "visualizar" num
394
+ * PDF entregava um PNG rotulado `application/pdf` e o leitor dizia que o arquivo era inválido. Cada
395
+ * amostra aqui é um arquivo mínimo porém legítimo do seu tipo: as de mídia foram geradas com ffmpeg
396
+ * e conferidas com ffprobe, o PDF tem xref/startxref/%%EOF, e os pacotes Office são zips com as
397
+ * partes obrigatórias (`[Content_Types].xml`, `_rels/.rels`, o documento).
398
+ *
399
+ * Não há amostra de `audio/amr`, `video/3gp` nem dos formatos binários legados do Office
400
+ * (`application/msword`, `application/vnd.ms-excel`, `application/vnd.ms-powerpoint`): não há
401
+ * encoder para eles nesta máquina e forjar OLE2 à mão daria arquivo corrompido — exatamente o que
402
+ * este módulo existe para evitar. Esses caem no texto explicativo de `resolvePreviewFileSample`,
403
+ * que abre sem erro e diz o que é.
404
+ *
405
+ * GERADO — não editar à mão.
406
+ */
407
+ declare const PREVIEW_FILE_SAMPLES: Readonly<Record<string, string>>;
408
+ /**
409
+ * A data URL que o preview abre para um documento.
410
+ *
411
+ * Ordem: tipo exato → família (`audio/amr` toca como mp3, `video/3gp` como mp4) → nota em texto.
412
+ * A nota fecha o caso dos tipos sem amostra: abre num leitor de texto e explica, em vez de baixar
413
+ * um binário quebrado com extensão de Word.
414
+ */
415
+ declare function resolvePreviewFileSample(mimeType: string | undefined, filename?: string): string;
416
+
417
+ /**
418
+ * Como o preview entrega mídia para a UI abrir.
419
+ *
420
+ * Separado de `previewFileSamples` (que é gerado) porque aqui está a parte que depende do navegador:
421
+ * **blob URL, não data URL**. O Chrome bloqueia navegação de topo para `data:` desde a v60, então
422
+ * `window.open(dataUrl)` — que é o que os botões "visualizar" e "baixar" fazem — abre aba em branco
423
+ * mesmo com bytes perfeitamente válidos. Em `src` de `<img>`/`<video>` a data URL funcionaria; no
424
+ * `window.open` não, e o mesmo `getDocumentUrl` alimenta os dois.
425
+ */
426
+
427
+ /** URL que o preview pode abrir em aba nova. Cai na data URL fora do navegador (teste, SSR). */
428
+ declare function previewFileUrl(mimeType: string | undefined, filename?: string): string;
429
+ /**
430
+ * A mesma amostra em base64 cru, como o proxy de mídia do backend a devolveria.
431
+ *
432
+ * Existe porque `getMediaProxyUrl` é o caminho da mídia AINDA NÃO ingerida (só existe o id na Meta),
433
+ * e o contrato pede `{ mimeType, data }` — não URL. Sem isto o mock devolvia o PNG 1x1 para
434
+ * qualquer id, e vídeo e áudio da thread apareciam quebrados apesar de haver amostra válida.
435
+ */
436
+ declare function previewFileBase64(mimeType: string | undefined, filename?: string): {
437
+ mimeType: string;
438
+ data: string;
439
+ };
440
+ /**
441
+ * O `onResolveMediaUrl` que o `MessageBubble` espera.
442
+ *
443
+ * Sem ele, foto, vídeo e áudio da thread ficam parados no placeholder para sempre — o
444
+ * `MediaRenderer` só resolve `uploadId`/`mediaId` por esta porta, de propósito, para o pacote nunca
445
+ * chamar endpoint fixo. O preview não tinha resolvedor nenhum, então nenhuma mídia carregava.
446
+ */
447
+ declare function createPreviewMediaResolver(): ResolveMediaUrl;
448
+
449
+ /**
450
+ * Bancada de teste manual de mídia — montável em uma linha por qualquer projeto que adote o SDK.
451
+ *
452
+ * Existe porque o defeito que ela pega não é pegável por teste automatizado: "o PDF abre?" depende
453
+ * do leitor do navegador, "o vídeo toca?" do decodificador, e "a aba abre?" da política do Chrome
454
+ * sobre `data:` URL. Teste unitário confere bytes; só o olho confere que o arquivo abre. Sem uma
455
+ * superfície pronta no pacote, cada projeto teria de montar a sua — e, na prática, nenhum montava.
456
+ *
457
+ * Traz o próprio store, o próprio mock e o próprio provider: o host não injeta nada. E não passa
458
+ * `onResolveMediaUrl` em lugar nenhum de propósito — é o `MessageBubble` resolvendo mídia pelo
459
+ * `ConversationsApi` do contexto, então se essa resolução automática quebrar, esta tela mostra.
460
+ */
461
+ /** A conversa do fixture que carrega uma mensagem de cada tipo aceito. */
462
+ declare const MEDIA_TYPES_CONVERSATION_ID = "5511944443333";
463
+ type MediaTypesPreviewProps = {
464
+ /** Outra conversa do fixture, se o projeto tiver acrescentado a sua. */
465
+ conversationId?: string;
466
+ className?: string;
467
+ };
468
+ declare function MediaTypesPreview({ conversationId, className, }: MediaTypesPreviewProps): react.JSX.Element;
469
+
470
+ export { type AppendMessageParams, ConversationPreview, type ConversationPreviewProps, type CreateMockConversationsApiParams, type CreateMockSSEProviderParams, type CreatePreviewBridgeClientParams, type CreatePreviewMediaUploaderParams, type CreatePreviewStoreParams, type CreatePreviewWebhookClientParams, DEFAULT_MEDIA_UPLOAD_PATH, 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, PreviewInProductionError, type PreviewInboundCommand, PreviewMediaUploadRejectedError, type PreviewMediaUploadRequest, type PreviewScriptStep, type PreviewStore, type PreviewStoreListener, type PreviewUploadedMedia, type PreviewWebhookClient, PreviewWebhookRejectedError, type SendPreviewInboundCommand, type SendPreviewMediaParams, type SetModeParams, type StartPreviewScriptParams, assertPreviewEnvironment, conversationChannel, createMockConversationsApi, createMockEventSource, createMockSSEProvider, createPreviewBridgeClient, createPreviewMediaPoster, createPreviewMediaResolver, createPreviewMediaUploader, createPreviewStore, createPreviewWebhookClient, mediaTypeOf, previewFileBase64, previewFileUrl, resolvePreviewFileSample, signPreviewPayload, startPreviewScript };