@adatechnology/conversations-ui 0.1.1 → 0.2.0

package/dist/{ConversationSimulatorPanel--5fIzXWY.d.ts → ConversationSimulatorPanel-ikgmlciE.d.ts}

@@ -136,6 +136,77 @@ interface MediaRendererProps {
 }
 declare function MediaRenderer({ message, onLightbox, onResolveUrl, onTranscribeAudio, className, }: MediaRendererProps): react.JSX.Element | null;
 
+/**
+ * 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;
+};
+
 /**
  * Gravação de áudio no simulador, pelo microfone do próprio navegador.
  *
@@ -426,6 +497,37 @@ interface ConversationsApi {
     finalize?(conversationId: string): Promise<void>;
     markAllRead?(): Promise<void>;
     listTemplates?(): Promise<ConversationTemplate[]>;
+    /**
+     * Mensagens prontas do produto. Ausente, nada de mensagens prontas aparece; sem `create`,
+     * `update` e `delete` a tela de cadastro fica só leitura — a presença da função é a capacidade.
+     */
+    listQuickReplies?(params?: {
+        search?: string;
+    }): Promise<QuickReply[]>;
+    createQuickReply?(input: QuickReplyInput): Promise<QuickReply>;
+    updateQuickReply?(id: string, input: QuickReplyInput): Promise<QuickReply>;
+    deleteQuickReply?(id: string): Promise<void>;
+    /**
+     * Sobe um anexo de mensagem pronta. O pacote não sabe COMO o host sobe (URL assinada, multipart):
+     * só precisa de progresso e cancelamento. Ausente, a tela de cadastro não oferece anexos.
+     * A miniatura de imagem reusa `getDocumentUrl(uploadId, 'inline')` — não há porta própria.
+     */
+    uploadQuickReplyAttachment?(file: File, options?: {
+        onProgress?: (fraction: number) => void;
+        signal?: AbortSignal;
+    }): Promise<QuickReplyAttachment>;
+    /**
+     * Envia por referência anexos já guardados. A chave de idempotência protege o reenvio depois de
+     * queda de rede; o resultado vem por arquivo porque a falha é parcial. Ausente, mensagem pronta
+     * com anexo insere só o texto.
+     */
+    sendStoredAttachments?(params: {
+        conversationId: string;
+        uploadIds: readonly string[];
+        idempotencyKey: string;
+    }): Promise<{
+        results: readonly StoredAttachmentSendResult[];
+    }>;
     /**
      * Transcrição completa gerada pelo servidor. Existe ao lado de `buildTranscriptText`, que monta
      * a partir das mensagens já em memória: a tela costuma ter só a última página carregada, e
@@ -801,4 +903,4 @@ type ConversationSimulatorPanelProps = Omit<ConversationPreviewProps, 'placehold
 };
 declare function ConversationSimulatorPanel({ onClose, channel, displayHandle, displayNumber, labels, headerActions, ...previewProps }: ConversationSimulatorPanelProps): react.JSX.Element;
 
-export { type PreviewWebhookClient as $, AudioRecorderButton as A, type CreatePreviewMediaUploaderParams as B, CHANNEL_CAPABILITIES as C, type CreatePreviewWebhookClientParams as D, DEFAULT_AUDIO_RECORDER_BUTTON_LABELS as E, DEFAULT_CONVERSATION_CHANNEL as F, DEFAULT_CONVERSATION_SIMULATOR_PANEL_LABELS as G, DEFAULT_MAX_RECORDING_MILLISECONDS as H, DEFAULT_MEDIA_UPLOAD_PATH as I, type FormatContactHandleParams as J, HANDLE_KIND as K, type HandleKind as L, type InteractiveOption as M, type InteractivePayload as N, type InteractiveSection as O, type InteractiveSelection as P, type ListConversationsParams as Q, type ListDocumentsParams as R, MediaRenderer as S, type MediaRendererProps as T, type MessagePayload as U, type MessageTranscription as V, PreviewInProductionError as W, PreviewMediaUploadRejectedError as X, type PreviewMediaUploadRequest as Y, type PreviewUploadedMedia$1 as Z, type PreviewUploadedMedia as _, type AudioRecorderButtonLabels as a, PreviewWebhookRejectedError as a0, REOPEN_MECHANISM as a1, type ReopenMechanism as a2, type ResolveMediaUrl as a3, SIMULATOR_FILE_MEDIA_KINDS as a4, type SSEProvider as a5, type SendPreviewMediaParams as a6, type SendSimulatorMediaParams as a7, type SimulatorMediaKind as a8, type ToSimulatorClientParams as a9, type TranscriptionMode as aa, type TranscriptionStatus as ab, acceptsMediaKind as ac, assertPreviewEnvironment as ad, capabilitiesOf as ae, channelFiltersFor as af, contactFlag as ag, createPreviewMediaPoster as ah, createPreviewMediaUploader as ai, createPreviewWebhookClient as aj, formatContactHandle as ak, isConversationSimulatorClient as al, mediaKindOf as am, mediaTypeOf as an, signPreviewPayload as ao, simulatorPanelLabelsOf as ap, toConversationSimulatorClient as aq, type AudioRecorderButtonProps as b, CHANNEL_FILTER_ALL as c, CONVERSATION_CHANNEL as d, type ChannelCapabilities as e, type ChannelFilter as f, type ChannelFilterOption as g, type CompanyDocument as h, type CompanyDocumentPage as i, type ConversationChannel as j, type ConversationDocument as k, type ConversationDocumentPage as l, type ConversationEventSource as m, type ConversationPage as n, ConversationPreview as o, type ConversationPreviewProps as p, type ConversationSimulatorClient as q, ConversationSimulatorPanel as r, type ConversationSimulatorPanelLabels as s, type ConversationSimulatorPanelProps as t, type ConversationSummary as u, type ConversationTemplate as v, type ConversationsApi as w, type ConversationsFeatures as x, type ConversationsTheme as y, type ConversationsUIConfig as z };
+export { type PreviewUploadedMedia as $, AudioRecorderButton as A, type ConversationsUIConfig as B, CHANNEL_CAPABILITIES as C, type CreatePreviewMediaUploaderParams as D, type CreatePreviewWebhookClientParams as E, DEFAULT_AUDIO_RECORDER_BUTTON_LABELS as F, DEFAULT_CONVERSATION_CHANNEL as G, DEFAULT_CONVERSATION_SIMULATOR_PANEL_LABELS as H, DEFAULT_MAX_RECORDING_MILLISECONDS as I, DEFAULT_MEDIA_UPLOAD_PATH as J, type FormatContactHandleParams as K, HANDLE_KIND as L, type HandleKind as M, type InteractiveOption as N, type InteractivePayload as O, type InteractiveSection as P, type InteractiveSelection as Q, type ListConversationsParams as R, type ListDocumentsParams as S, MediaRenderer as T, type MediaRendererProps as U, type MessagePayload as V, type MessageTranscription as W, PreviewInProductionError as X, PreviewMediaUploadRejectedError as Y, type PreviewMediaUploadRequest as Z, type PreviewUploadedMedia$1 as _, type AudioRecorderButtonLabels as a, type PreviewWebhookClient as a0, PreviewWebhookRejectedError as a1, QUICK_REPLY_ATTACHMENT_LIMIT as a2, type QueuedAttachment as a3, type QuickReply as a4, type QuickReplyAttachment as a5, type QuickReplyInput as a6, REOPEN_MECHANISM as a7, type ReopenMechanism as a8, type ResolveMediaUrl as a9, SIMULATOR_FILE_MEDIA_KINDS as aa, type SSEProvider as ab, type SendPreviewMediaParams as ac, type SendSimulatorMediaParams as ad, type SimulatorMediaKind as ae, type StoredAttachmentSendResult as af, type ToSimulatorClientParams as ag, type TranscriptionMode as ah, type TranscriptionStatus as ai, acceptsMediaKind as aj, assertPreviewEnvironment as ak, capabilitiesOf as al, channelFiltersFor as am, contactFlag as an, createPreviewMediaPoster as ao, createPreviewMediaUploader as ap, createPreviewWebhookClient as aq, formatContactHandle as ar, isConversationSimulatorClient as as, mediaKindOf as at, mediaTypeOf as au, signPreviewPayload as av, simulatorPanelLabelsOf as aw, toConversationSimulatorClient as ax, type AudioRecorderButtonProps as b, CHANNEL_FILTER_ALL as c, CONVERSATION_CHANNEL as d, type ChannelCapabilities as e, type ChannelFilter as f, type ChannelFilterOption as g, type CompanyDocument as h, type CompanyDocumentPage as i, type ConversationChannel as j, type ConversationDocument as k, type ConversationDocumentPage as l, type ConversationEventSource as m, type ConversationPage as n, ConversationPreview as o, type ConversationPreviewProps as p, type ConversationSimulatorClient as q, ConversationSimulatorPanel as r, type ConversationSimulatorPanelLabels as s, type ConversationSimulatorPanelProps as t, type ConversationSummary as u, type ConversationTemplate as v, type ConversationVariable as w, type ConversationsApi as x, type ConversationsFeatures as y, type ConversationsTheme as z };