@adatechnology/conversations-ui 0.4.2 → 0.5.0

package/dist/preview/index.d.ts

@@ -1,8 +1,10 @@
-import { M as MessagePayload, C as ConversationSummary, a as ConversationEventSource, b as ConversationsApi, L as ListConversationsParams, c as ConversationPage, S as SSEProvider, d as ConversationDocument, e as SendPreviewMediaParams, P as PreviewUploadedMedia, f as PreviewWebhookClient, R as ResolveMediaUrl } from '../ConversationSimulatorPanel-DnXElfY8.js';
-export { A as AudioRecorderButton, g as AudioRecorderButtonLabels, h as AudioRecorderButtonProps, i as ConversationPreview, j as ConversationPreviewProps, k as ConversationSimulatorClient, l as ConversationSimulatorPanel, m as ConversationSimulatorPanelLabels, n as ConversationSimulatorPanelProps, o as CreatePreviewMediaUploaderParams, p as CreatePreviewWebhookClientParams, D as DEFAULT_AUDIO_RECORDER_BUTTON_LABELS, q as DEFAULT_CONVERSATION_SIMULATOR_PANEL_LABELS, r as DEFAULT_MEDIA_UPLOAD_PATH, s as PreviewInProductionError, t as PreviewMediaUploadRejectedError, u as PreviewMediaUploadRequest, v as PreviewUploadedMedia, w as PreviewWebhookRejectedError, x as SIMULATOR_FILE_MEDIA_KINDS, y as SendSimulatorMediaParams, z as SimulatorMediaKind, T as ToSimulatorClientParams, B as acceptsMediaKind, E as assertPreviewEnvironment, F as createPreviewMediaPoster, G as createPreviewMediaUploader, H as createPreviewWebhookClient, I as isConversationSimulatorClient, J as mediaKindOf, K as mediaTypeOf, N as signPreviewPayload, O as simulatorPanelLabelsOf, Q as toConversationSimulatorClient } from '../ConversationSimulatorPanel-DnXElfY8.js';
+import { M as MessagePayload } from '../quickReply.types-B4gmZsSr.js';
+import { C as ConversationSummary, a as ConversationEventSource, b as ConversationsApi, L as ListConversationsParams, c as ConversationPage, S as SSEProvider, d as ConversationDocument, e as SendPreviewMediaParams, P as PreviewUploadedMedia, f as PreviewWebhookClient, R as ResolveMediaUrl } from '../ConversationSimulatorPanel-CrfFjiWh.js';
+export { A as AudioRecorderButton, g as AudioRecorderButtonLabels, h as AudioRecorderButtonProps, i as ConversationPreview, j as ConversationPreviewProps, k as ConversationSimulatorClient, l as ConversationSimulatorPanel, m as ConversationSimulatorPanelLabels, n as ConversationSimulatorPanelProps, o as CreatePreviewMediaUploaderParams, p as CreatePreviewWebhookClientParams, D as DEFAULT_AUDIO_RECORDER_BUTTON_LABELS, q as DEFAULT_CONVERSATION_SIMULATOR_PANEL_LABELS, r as DEFAULT_MEDIA_UPLOAD_PATH, s as PreviewInProductionError, t as PreviewMediaUploadRejectedError, u as PreviewMediaUploadRequest, v as PreviewUploadedMedia, w as PreviewWebhookRejectedError, x as SIMULATOR_FILE_MEDIA_KINDS, y as SendSimulatorMediaParams, z as SimulatorMediaKind, T as ToSimulatorClientParams, B as acceptsMediaKind, E as assertPreviewEnvironment, F as createPreviewMediaPoster, G as createPreviewMediaUploader, H as createPreviewWebhookClient, I as isConversationSimulatorClient, J as mediaKindOf, K as mediaTypeOf, M as signPreviewPayload, N as simulatorPanelLabelsOf, O as toConversationSimulatorClient } from '../ConversationSimulatorPanel-CrfFjiWh.js';
 import { InteractiveReplyOption } from '@adatechnology/meta-whatsapp-contracts/testing';
 import * as react from 'react';
 export { PREVIEW_MEDIA_ID_PREFIX } from '@adatechnology/meta-whatsapp-contracts';
+import '@adatechnology/conversation-contracts';
 
 /**
  * Estado em memória que alimenta o preview de atendimento humano. Mock de API e mock de SSE

package/dist/preview/index.js

@@ -16,8 +16,10 @@ import {
   mediaTypeOf,
   simulatorPanelLabelsOf,
   toConversationSimulatorClient
-} from "../chunk-4P5KMWOI.js";
-import "../chunk-PJNR6UMN.js";
+} from "../chunk-JXJCPN34.js";
+import "../chunk-MRVFFJEH.js";
+import "../chunk-RJMSM3YA.js";
+import "../chunk-CBYEHPX6.js";
 
 // src/preview/previewStore.ts
 var GLOBAL_CHANNEL = "global";

package/dist/quickReply.types-B4gmZsSr.d.ts

@@ -0,0 +1,274 @@
+import { MessageDeliveryStatus, ConversationChannel as ConversationChannel$1 } from '@adatechnology/conversation-contracts';
+
+interface ConversationsUIConfig {
+    apiBaseUrl: string;
+    theme?: ConversationsTheme;
+    features?: ConversationsFeatures;
+}
+interface ConversationsTheme {
+    primaryColor?: string;
+    backgroundColor?: string;
+    bubbleSent?: string;
+    bubbleReceived?: string;
+    textPrimary?: string;
+    textSecondary?: string;
+}
+interface ConversationsFeatures {
+    audio?: boolean;
+    documents?: boolean;
+    emoji?: boolean;
+    darkMode?: boolean;
+}
+/**
+ * Recorte do bloco `interactive` da Meta que a UI precisa para desenhar o menu. Fica solto (e não
+ * espelhando o contrato inteiro) porque o que chega do banco é o payload cru já enviado ao
+ * WhatsApp: qualquer campo que a UI não conheça é ignorado, nunca causa erro de render.
+ */
+interface InteractiveOption {
+    id: string;
+    title: string;
+    description?: string;
+}
+interface InteractiveSection {
+    title?: string;
+    rows?: InteractiveOption[];
+}
+interface InteractivePayload {
+    type?: 'button' | 'list' | string;
+    header?: {
+        text?: string;
+    };
+    body?: {
+        text?: string;
+    };
+    footer?: {
+        text?: string;
+    };
+    action?: {
+        /** Rótulo do botão que abre a lista — só existe em `type: 'list'`. */
+        button?: string;
+        sections?: InteractiveSection[];
+        buttons?: {
+            reply?: InteractiveOption;
+        }[];
+    };
+}
+/** Como o cliente respondeu a um menu: por botão ou por item de lista. */
+type InteractiveSelection = {
+    readonly kind: 'button' | 'list';
+    readonly option: InteractiveOption;
+};
+interface MessagePayload {
+    id: string;
+    type: 'text' | 'image' | 'video' | 'audio' | 'document' | 'sticker' | 'template' | 'interactive';
+    /** Payload cru da mensagem. Em `type: 'interactive'`, carrega o menu que o cliente vê. */
+    payload?: InteractivePayload | null;
+    content?: string;
+    caption?: string;
+    mediaUrl?: string;
+    base64?: string;
+    uploadId?: string;
+    mediaId?: string;
+    mimeType?: string;
+    filename?: string;
+    sizeBytes?: number;
+    direction: 'inbound' | 'outbound';
+    sender: 'bot' | 'customer' | 'agent';
+    timestamp: string;
+    status?: MessageDeliveryStatus;
+    readAt?: string;
+    agentName?: string | null;
+    templateName?: string;
+    /**
+     * Veredito de moderação vindo do backend — a UI só exibe, nunca calcula. Dicionário no browser
+     * seria peso morto e daria veredito diferente por versão de cliente.
+     *
+     * `null`/ausente = não avaliado (moderação desligada, ou mensagem anterior ao recurso), que é
+     * diferente de avaliado e limpo.
+     */
+    moderation?: {
+        isOffensive: boolean;
+        terms: string[];
+    } | null;
+    /**
+     * Transcrição do áudio, vinda do backend — a UI só exibe, nunca transcreve. Rodar STT no browser
+     * exigiria baixar modelo por aba e daria resultado diferente por versão de cliente.
+     *
+     * `null`/ausente = não avaliado, que é diferente de `'done'` com texto vazio (áudio em silêncio,
+     * já processado). É essa distinção que decide se o balão oferece "transcrever" ou "sem fala
+     * detectada".
+     */
+    transcription?: MessageTranscription | null;
+    isFirstInGroup?: boolean;
+    isLastInGroup?: boolean;
+}
+type TranscriptionStatus = 'pending' | 'done' | 'failed' | 'unsupported';
+/**
+ * Quando transcrever, escolhido nas configurações da empresa. Espelha o
+ * `TranscriptionMode` de `@adatechnology/meta-whatsapp-contracts`; declarado aqui para o pacote de
+ * UI não obrigar quem só desenha telas a instalar os contratos do backend.
+ */
+type TranscriptionMode = 'auto' | 'onDemand';
+interface MessageTranscription {
+    status: TranscriptionStatus;
+    text?: string | null;
+    /** ISO 639-1 ou nome do idioma, conforme o engine. Exibido como dica, não interpretado. */
+    language?: string | null;
+    engine?: string | null;
+}
+
+/**
+ * Canal de origem da conversa e o que cada um permite.
+ *
+ * Existe porque as regras que a inbox precisa respeitar não são do WhatsApp, são **de cada canal**:
+ * a janela de sessão, o jeito de reabrir a conversa e o formato do identificador do contato mudam
+ * entre WhatsApp, Messenger, Instagram e chat de site. Tratar a regra do WhatsApp como universal
+ * faria a UI bloquear o composer num chat de site, onde janela nenhuma existe.
+ *
+ * `whatsapp` é o padrão em todo lugar: instalações que ainda não informam canal continuam
+ * funcionando exatamente como antes.
+ */
+
+declare const CONVERSATION_CHANNEL: {
+    readonly WHATSAPP: "whatsapp";
+    readonly MESSENGER: "messenger";
+    readonly INSTAGRAM: "instagram";
+    readonly APP: "app";
+    readonly PORTAL: "portal";
+    readonly WEBCHAT: "webchat";
+    readonly EMAIL: "email";
+};
+/** O que o contrato conhece, mais os dois canais da Meta que a UI já servia antes dele. */
+type ConversationChannel = ConversationChannel$1 | 'messenger' | 'instagram';
+declare const DEFAULT_CONVERSATION_CHANNEL: ConversationChannel;
+/** Como o canal reabre uma conversa fora da janela de sessão. */
+declare const REOPEN_MECHANISM: {
+    readonly TEMPLATE: "template";
+    readonly TAG: "tag";
+    readonly NONE: "none";
+};
+type ReopenMechanism = (typeof REOPEN_MECHANISM)[keyof typeof REOPEN_MECHANISM];
+/** Natureza do identificador do contato — decide como exibi-lo. */
+declare const HANDLE_KIND: {
+    readonly PHONE: "phone";
+    readonly USERNAME: "username";
+    readonly SESSION: "session";
+    readonly EMAIL: "email";
+};
+type HandleKind = (typeof HANDLE_KIND)[keyof typeof HANDLE_KIND];
+/**
+ * Só o que é **exibição** do canal — rótulo, ícone, como reabrir, como mostrar o identificador.
+ * Capacidade de **comportamento** (confirma leitura, tem janela e de quantas horas, aceita anexo e
+ * áudio, precisa de transporte próprio) não mora mais aqui: para canal que
+ * `@adatechnology/conversation-contracts` conhece, ela vem de `channelCapabilityFor` (RF10). Manter
+ * os dois tipos de capacidade juntos foi o que criou a "janela" duplicada (`windowHours`) que a
+ * spec 211 mandou apagar — a mesma verdade não pode morar em dois lugares.
+ */
+type ChannelCapabilities = {
+    readonly label: string;
+    readonly icon: string;
+    readonly reopenMechanism: ReopenMechanism;
+    readonly handleKind: HandleKind;
+};
+declare const CHANNEL_CAPABILITIES: Readonly<Record<ConversationChannel, ChannelCapabilities>>;
+declare function capabilitiesOf(channel: ConversationChannel | undefined): ChannelCapabilities;
+declare const CHANNEL_FILTER_ALL = "all";
+type ChannelFilter = ConversationChannel | typeof CHANNEL_FILTER_ALL;
+type ChannelFilterOption = {
+    readonly value: ChannelFilter;
+    readonly label: string;
+};
+/**
+ * Opções derivadas do que existe na lista, não do catálogo inteiro: oferecer Instagram numa conta
+ * que só tem WhatsApp promete um recorte que nunca traz resultado.
+ *
+ * Devolve vazio com menos de dois canais — um filtro de opção única não filtra nada, e a barra só
+ * ocuparia espaço. O host usa isso para esconder a seção.
+ */
+declare function channelFiltersFor(conversations: readonly {
+    readonly channel?: ConversationChannel | undefined;
+}[]): ChannelFilterOption[];
+type FormatContactHandleParams = {
+    readonly handle: string;
+    readonly channel?: ConversationChannel | undefined;
+};
+/**
+ * Exibição do identificador conforme a natureza dele. Formatar tudo como telefone — o que a UI
+ * fazia — transforma um `@perfil` do Instagram em dígitos sem sentido.
+ */
+declare function formatContactHandle(params: FormatContactHandleParams): string;
+/** Bandeira só faz sentido quando o identificador é telefone. */
+declare function contactFlag(params: FormatContactHandleParams): string;
+
+/**
+ * Mensagem pronta cadastrada pelo produto e oferecida no composer.
+ *
+ * Difere do `QuickReply` dos chips (`MessageComposer`): aquela vive em código no host; esta vem da
+ * API, tem atalho para o `/` e é editada pela tela de cadastro.
+ */
+type QuickReply = {
+    readonly id: string;
+    /** Até 40 caracteres — é o que o atendente lê na lista. */
+    readonly title: string;
+    /** Casa `^[a-z0-9-]{1,20}$`: é digitado depois do `/`, sem acento nem espaço. */
+    readonly shortcut: string;
+    /** Até 1000 caracteres, com `{{marcador}}` onde entra o dado da conversa. */
+    readonly body: string;
+    /** Ausente em host sem anexos: o contrato continua o mesmo para quem não os oferece. */
+    readonly attachments?: readonly QuickReplyAttachment[];
+};
+/** Teto de anexos por mensagem pronta — o mesmo que a API aplica, para a tela recusar antes. */
+declare const QUICK_REPLY_ATTACHMENT_LIMIT = 10;
+/** Arquivo já guardado pelo host; o `uploadId` é a única chave que o pacote devolve ao servidor. */
+type QuickReplyAttachment = {
+    readonly uploadId: string;
+    readonly filename: string;
+    readonly mimeType: string;
+    readonly sizeBytes: number;
+};
+/**
+ * Item da fila do composer. `local` ainda não subiu (veio do clipe); `stored` já está no servidor
+ * (veio de uma mensagem pronta) e é enviado por referência, sem baixar e subir de novo.
+ */
+type QueuedAttachment = {
+    readonly kind: 'local';
+    readonly localId: string;
+    readonly file: File;
+} | {
+    readonly kind: 'stored';
+    readonly uploadId: string;
+    readonly filename: string;
+    readonly mimeType: string;
+    readonly sizeBytes: number;
+    /** Carregada sob demanda só para imagem — a lista não pode abrir N URLs assinadas de uma vez. */
+    readonly previewUrl?: string;
+};
+/** Resultado por arquivo: o envio em lote falha parcialmente, e só o que falhou fica na fila. */
+type StoredAttachmentSendResult = {
+    readonly uploadId: string;
+    readonly status: 'sent' | 'failed' | 'skipped';
+    readonly errorCode?: string;
+};
+/** O que a tela de cadastro manda para criar ou atualizar; o `id` é do servidor. */
+type QuickReplyInput = {
+    readonly title: string;
+    readonly shortcut: string;
+    readonly body: string;
+    /** Ordem do cadastro é a ordem de envio; ausente não mexe nos anexos já gravados. */
+    readonly attachmentUploadIds?: readonly string[];
+};
+/**
+ * Dado da conversa que um texto pode citar. Uma lista só alimenta a prévia, a inserção e o botão de
+ * variáveis — antes eram duas props de formato diferente, e as telas divergiam por isso.
+ */
+type ConversationVariable = {
+    readonly id: string;
+    /** Rótulo do botão "Inserir variável" (ex.: "Nome do cliente"). */
+    readonly label: string;
+    /** Como aparece no texto: `{{nome}}`. */
+    readonly marker: string;
+    /** Vazio quando a conversa não tem o dado: a variável não é oferecida. */
+    readonly value: string;
+};
+
+export { type ConversationChannel as C, DEFAULT_CONVERSATION_CHANNEL as D, type FormatContactHandleParams as F, HANDLE_KIND as H, type InteractiveSelection as I, type MessagePayload as M, type QuickReply as Q, REOPEN_MECHANISM as R, type StoredAttachmentSendResult as S, type TranscriptionMode as T, type ConversationsTheme as a, type MessageTranscription as b, type QuickReplyInput as c, type QuickReplyAttachment as d, type InteractivePayload as e, type ConversationsFeatures as f, type QueuedAttachment as g, type ConversationVariable as h, type ChannelFilter as i, type ChannelFilterOption as j, CHANNEL_CAPABILITIES as k, CHANNEL_FILTER_ALL as l, CONVERSATION_CHANNEL as m, type ChannelCapabilities as n, type ConversationsUIConfig as o, type HandleKind as p, type InteractiveOption as q, type InteractiveSection as r, QUICK_REPLY_ATTACHMENT_LIMIT as s, type ReopenMechanism as t, type TranscriptionStatus as u, capabilitiesOf as v, channelFiltersFor as w, contactFlag as x, formatContactHandle as y };