@adatechnology/conversations-ui 0.1.0-rc.5 → 0.1.0-rc.6

package/dist/index.d.ts

@@ -1,17 +1,7 @@
 import * as react from 'react';
 import react__default, { ReactNode, FormEvent } from 'react';
-import { M as MessagePayload, n as ConversationsFeatures, k as ConversationSummary, f as ConversationChannel, L as ListConversationsParams, m as ConversationsApi, S as SSEProvider, r as ListDocumentsParams, g as ConversationDocument, l as ConversationTemplate } from './types-C2Yexi8A.js';
-export { C as CHANNEL_CAPABILITIES, a as CHANNEL_FILTER_ALL, b as CONVERSATION_CHANNEL, c as ChannelCapabilities, d as ChannelFilter, e as ChannelFilterOption, h as ConversationDocumentPage, i as ConversationEventSource, j as ConversationPage, o as ConversationsTheme, p as ConversationsUIConfig, D as DEFAULT_CONVERSATION_CHANNEL, F as FormatContactHandleParams, H as HANDLE_KIND, q as HandleKind, R as REOPEN_MECHANISM, s as ReopenMechanism, t as capabilitiesOf, u as channelFiltersFor, v as contactFlag, w as formatContactHandle } from './types-C2Yexi8A.js';
-
-type ResolveMediaUrl = (message: MessagePayload) => Promise<string | null>;
-interface MediaRendererProps {
-    message: MessagePayload;
-    onLightbox: (src: string) => void;
-    onResolveUrl?: ResolveMediaUrl;
-    /** Aplicado no wrapper de cada tipo de mídia — imagem, vídeo, áudio e documento. */
-    className?: string;
-}
-declare function MediaRenderer({ message, onLightbox, onResolveUrl, className }: MediaRendererProps): react.JSX.Element | null;
+import { v as MessagePayload, x as ResolveMediaUrl, p as ConversationsFeatures, m as ConversationSummary, h as ConversationChannel, L as ListConversationsParams, o as ConversationsApi, S as SSEProvider, t as ListDocumentsParams, i as ConversationDocument, n as ConversationTemplate } from './types-CeixG2Z9.js';
+export { C as CHANNEL_CAPABILITIES, a as CHANNEL_FILTER_ALL, b as CONVERSATION_CHANNEL, c as ChannelCapabilities, d as ChannelFilter, e as ChannelFilterOption, f as CompanyDocument, g as CompanyDocumentPage, j as ConversationDocumentPage, k as ConversationEventSource, l as ConversationPage, q as ConversationsTheme, r as ConversationsUIConfig, D as DEFAULT_CONVERSATION_CHANNEL, F as FormatContactHandleParams, H as HANDLE_KIND, s as HandleKind, M as MediaRenderer, u as MediaRendererProps, R as REOPEN_MECHANISM, w as ReopenMechanism, y as capabilitiesOf, z as channelFiltersFor, A as contactFlag, B as formatContactHandle } from './types-CeixG2Z9.js';
 
 interface MessageBubbleProps {
     message: MessagePayload;
@@ -21,6 +11,10 @@ interface MessageBubbleProps {
     isSelecting?: boolean;
     isSelected?: boolean;
     onToggleSelect?: () => void;
+    /**
+     * Como buscar a mídia da mensagem. Ausente, o balão usa o `ConversationsApi` do
+     * `ConversationsProvider` — passe apenas para sobrescrever (cache próprio, CDN, proxy do host).
+     */
     onResolveMediaUrl?: ResolveMediaUrl;
     className?: string;
 }
@@ -84,7 +78,14 @@ interface EmojiPickerProps {
 }
 declare const EmojiPicker: ({ onSelect, className }: EmojiPickerProps) => react.JSX.Element;
 
+interface MessageComposerLabels {
+    emoji: string;
+    attach: string;
+    send: string;
+}
+declare const DEFAULT_MESSAGE_COMPOSER_LABELS: MessageComposerLabels;
 interface MessageComposerProps {
+    labels?: Partial<MessageComposerLabels>;
     onSend: (text: string) => void;
     onAttach?: (file: File) => void;
     value?: string;
@@ -101,9 +102,21 @@ interface MessageComposerClassNames {
     root: string;
     field: string;
 }
-declare const MessageComposer: ({ onSend, onAttach, value: externalValue, onChange: externalOnChange, features, placeholder, maxLength, disabled, acceptedFileTypes, className, classNames, }: MessageComposerProps) => react.JSX.Element;
+declare const MessageComposer: ({ onSend, onAttach, value: externalValue, onChange: externalOnChange, features, placeholder, maxLength, disabled, acceptedFileTypes, className, classNames, labels, }: MessageComposerProps) => react.JSX.Element;
 
+interface WhatsAppMessageEditorLabels {
+    bold: string;
+    /** Tooltip da negrito — traz a sintaxe do WhatsApp junto, por isso é separado do `aria-label`. */
+    boldHint: string;
+    italic: string;
+    italicHint: string;
+    strikethrough: string;
+    strikethroughHint: string;
+    insertPlaceholder: (token: string) => string;
+}
+declare const DEFAULT_WHATSAPP_MESSAGE_EDITOR_LABELS: WhatsAppMessageEditorLabels;
 interface WhatsAppMessageEditorProps {
+    labels?: Partial<WhatsAppMessageEditorLabels>;
     value: string;
     onChange: (value: string) => void;
     placeholder?: string;
@@ -112,7 +125,7 @@ interface WhatsAppMessageEditorProps {
     previewLabel?: string;
     emptyPreviewText?: string;
 }
-declare function WhatsAppMessageEditor({ value, onChange, placeholder, placeholders, rows, previewLabel, emptyPreviewText, }: WhatsAppMessageEditorProps): react.JSX.Element;
+declare function WhatsAppMessageEditor({ value, onChange, placeholder, placeholders, rows, previewLabel, emptyPreviewText, labels, }: WhatsAppMessageEditorProps): react.JSX.Element;
 
 interface SimpleEmojiPickerProps {
     onSelect: (emoji: string) => void;
@@ -133,16 +146,30 @@ interface DateDividerProps {
 }
 declare function DateDivider({ iso, className, classNames }: DateDividerProps): react.JSX.Element;
 
+interface AvatarLabels {
+    /** Lido por leitor de tela quando não há nome nem imagem — a silhueta genérica. */
+    unnamedContact: string;
+}
 interface AvatarProps {
     name?: string | null;
     avatarUrl?: string;
     size?: 'sm' | 'md' | 'lg';
     className?: string;
+    labels?: Partial<AvatarLabels>;
 }
-declare function Avatar({ name, avatarUrl, size, className }: AvatarProps): react.JSX.Element;
+declare const DEFAULT_AVATAR_LABELS: AvatarLabels;
+declare function Avatar({ name, avatarUrl, size, className, labels }: AvatarProps): react.JSX.Element;
 
+interface ConversationListItemLabels {
+    /** Tooltip do ponto vermelho: a janela de atendimento de 24h já fechou. */
+    expiredWindow: string;
+    /** Tooltip do ponto laranja: a janela de atendimento está perto de fechar. */
+    warningWindow: string;
+}
+declare const DEFAULT_CONVERSATION_LIST_ITEM_LABELS: ConversationListItemLabels;
 interface ConversationListItemProps {
     conversation: ConversationSummary;
+    labels?: Partial<ConversationListItemLabels>;
     active?: boolean;
     selected?: boolean;
     onClick?: () => void;
@@ -159,7 +186,7 @@ interface ConversationListItemProps {
      */
     highlightActive?: boolean;
 }
-declare const ConversationListItem: ({ conversation, active, selected, onClick, onSelect, showDivider, highlightActive, }: ConversationListItemProps) => react.JSX.Element;
+declare const ConversationListItem: ({ conversation, active, selected, onClick, onSelect, showDivider, highlightActive, labels, }: ConversationListItemProps) => react.JSX.Element;
 
 type ToastType = 'success' | 'error' | 'info';
 interface ToastContextValue {
@@ -179,12 +206,19 @@ interface StatusTicksProps {
 }
 declare function StatusTicks({ status, title }: StatusTicksProps): react.JSX.Element;
 
+interface LightboxLabels {
+    /** Texto alternativo quando a imagem não tem legenda — sem ele o leitor de tela anuncia a URL. */
+    imageAlt: string;
+    close: string;
+}
 interface LightboxProps {
     imageUrl: string;
     caption?: string;
     onClose: () => void;
+    labels?: Partial<LightboxLabels>;
 }
-declare function Lightbox({ imageUrl, caption, onClose }: LightboxProps): react.JSX.Element;
+declare const DEFAULT_LIGHTBOX_LABELS: LightboxLabels;
+declare function Lightbox({ imageUrl, caption, onClose, labels }: LightboxProps): react.JSX.Element;
 
 interface FileIconProps {
     filename?: string;
@@ -382,6 +416,76 @@ declare function WindowExpiredNotice({ onSendTemplate, disabled, labels: labelsO
  */
 declare function isWindowBlocking(window: ConversationWindow): boolean;
 
+/**
+ * Biblioteca de arquivos de TODAS as conversas — a tela de Documentos do painel, fora do
+ * atendimento.
+ *
+ * Distinta do `ConversationDocumentsPanel`: aquele parte de uma conversa aberta e vive dentro dela;
+ * esta varre a empresa e por isso mostra de qual conversa cada arquivo veio, com o número
+ * clicável. Sem essa referência, uma lista global de anexos não responde nenhuma pergunta.
+ */
+interface DocumentsLibraryLabels {
+    title: string;
+    searchPlaceholder: string;
+    empty: string;
+    noResults: string;
+    loading: string;
+    failure: string;
+    view: string;
+    download: string;
+    openConversation: string;
+    sourceFilterAll: string;
+    sourceFilterCustomer: string;
+    sourceFilterTeam: string;
+    sortMostRecent: string;
+    sortOldest: string;
+    clearFilters: string;
+    total: (count: number) => string;
+    page: (current: number, last: number) => string;
+}
+declare const DEFAULT_DOCUMENTS_LIBRARY_LABELS: DocumentsLibraryLabels;
+interface DocumentsLibraryClassNames {
+    root: string;
+    title: string;
+    filters: string;
+    search: string;
+    sourceSelect: string;
+    sortButton: string;
+    clearButton: string;
+    status: string;
+    list: string;
+    item: string;
+    conversationLink: string;
+    filename: string;
+    meta: string;
+    pagination: string;
+}
+interface DocumentsLibraryProps {
+    /** Itens por página. O total vem do servidor. */
+    perPage?: number;
+    /** Abrir a conversa de origem. Ausente, o número aparece como texto e não como link. */
+    onOpenConversation?: (conversationId: string) => void;
+    labels?: Partial<DocumentsLibraryLabels>;
+    className?: string;
+    classNames?: Partial<DocumentsLibraryClassNames>;
+}
+declare function DocumentsLibrary({ perPage, onOpenConversation, labels: labelsOverride, className, classNames, }: DocumentsLibraryProps): react.JSX.Element | null;
+
+/**
+ * Arquivos trocados na conversa. Sai do transcript e vira lista própria porque anexo é o que o
+ * atendente mais precisa reencontrar depois — rolar meses de mensagens para achar um comprovante é
+ * o caso que a busca por documento existe para eliminar.
+ *
+ * Usa `useConversationDocuments`, então funciona com qualquer `ConversationsApi`. Host sem
+ * biblioteca de documentos cai no estado vazio, sem quebrar.
+ */
+/** Origens que o filtro oferece. `all` não é origem — é a ausência de filtro. */
+declare const DOCUMENT_SOURCE_FILTER: {
+    readonly ALL: "all";
+    readonly CUSTOMER: "customer";
+    readonly TEAM: "team";
+};
+type DocumentSourceFilter = (typeof DOCUMENT_SOURCE_FILTER)[keyof typeof DOCUMENT_SOURCE_FILTER];
 interface ConversationDocumentsPanelLabels {
     toggle: string;
     title: string;
@@ -605,6 +709,7 @@ interface WhatsAppCreateTemplateFormLabels {
     sectionDescription: string;
     nameLabel: string;
     nameHint: string;
+    namePlaceholder: string;
     categoryLabel: string;
     languageLabel: string;
     headerLabel: string;
@@ -828,4 +933,16 @@ interface AsyncResourceState<T> {
     refetch: () => Promise<void>;
 }
 
-export { type AsyncResourceState, AudioPlayer, type AudioPlayerProps, Avatar, type AvatarProps, type BuildTranscriptTextParams, CHANNEL_BRAND_COLOR, CONVERSATION_WINDOW, ChannelIcon, type ChannelIconProps, ConversationChannel, type ConversationContextEntry, ConversationContextPanel, type ConversationContextPanelClassNames, type ConversationContextPanelLabels, type ConversationContextPanelProps, ConversationDocument, ConversationDocumentsPanel, type ConversationDocumentsPanelClassNames, type ConversationDocumentsPanelLabels, type ConversationDocumentsPanelProps, ConversationHeader, type ConversationHeaderClassNames, type ConversationHeaderLabels, type ConversationHeaderProps, ConversationListItem, type ConversationListItemProps, type ConversationLocales, ConversationLocalesProvider, type ConversationLocalesProviderProps, type ConversationRealtimeHandler, ConversationRow, type ConversationRowClassNames, type ConversationRowProps, ConversationSummary, ConversationTemplate, ConversationWallpaper, type ConversationWallpaperProps, type ConversationWindow, ConversationsApi, ConversationsFeatures, ConversationsProvider, DEFAULT_CONVERSATION_CONTEXT_LABELS, DEFAULT_CONVERSATION_DOCUMENTS_LABELS, DEFAULT_CONVERSATION_HEADER_LABELS, DEFAULT_TEMPLATES_SETTINGS_LABELS, DEFAULT_WINDOW_EXPIRED_LABELS, DateDivider, type DateDividerClassNames, type DateDividerProps, EmojiPicker, type EmojiPickerProps, FileIcon, type FileIconProps, Lightbox, type LightboxProps, ListConversationsParams, ListDocumentsParams, MediaRenderer, type MediaRendererProps, MessageBubble, type MessageBubbleProps, MessageComposer, type MessageComposerClassNames, type MessageComposerProps, MessagePayload, MessageTail, MessageText, type MessageTextProps, MessageTimestamp, NARROW_MAX_WIDTH_PX, type ResolveMediaUrl, SSEProvider, SimpleEmojiPicker, type SimpleEmojiPickerProps, StatusTicks, type StatusTicksProps, TEMPLATE_SETTINGS_TAB, type TemplateSettingsTab, ToastProvider, type TopicItem, TopicsForm, type TopicsFormLabels, type TopicsFormProps, type UseConversationActionsResult, type UseConversationContextResult, type UseConversationDocumentsParams, type UseConversationDocumentsResult, type UseConversationListParams, type UseConversationListResult, type UseConversationMessagesResult, type UseInboxActionsResult, type UseWaitingNotificationsLabels, type UseWaitingNotificationsParams, type UseWaitingNotificationsResult, WINDOW_FILTERS, WelcomeFarewellForm, type WelcomeFarewellFormLabels, type WelcomeFarewellFormProps, WhatsAppCreateTemplateForm, type WhatsAppCreateTemplateFormLabels, type WhatsAppCreateTemplateFormProps, type WhatsAppCreateTemplateResult, type WhatsAppCreateTemplateState, WhatsAppMessageEditor, type WhatsAppMessageEditorProps, type WhatsAppTemplateHeaderType, WhatsAppTemplateSettingsForm, type WhatsAppTemplateSettingsFormLabels, type WhatsAppTemplateSettingsFormProps, type WhatsAppTemplateSummary, type WhatsAppTemplateVariableSuggestion, WhatsAppTemplatesSettings, type WhatsAppTemplatesSettingsLabels, type WhatsAppTemplatesSettingsProps, WindowExpiredNotice, type WindowExpiredNoticeLabels, type WindowExpiredNoticeProps, type WindowOfParams, buildTranscriptFilename, buildTranscriptText, downloadTextFile, formatDateTime, formatFileSize, formatPhone, formatStalledFor, formatTimestamp, htmlToWA, isSameDay, isWindowBlocking, parseWhatsAppFormatting, phoneInitials, toast, useConversationActions, useConversationContext, useConversationDocuments, useConversationList, useConversationLocales, useConversationMessages, useConversationRealtime, useConversations, useDarkMode, useGlobalRealtime, useInboxActions, useIsDarkTheme, useIsNarrow, useToast, useWaitingNotifications, waToHTML, waToHTMLInline, windowOf };
+/**
+ * Resolve a mídia de uma mensagem numa URL exibível, usando só o `ConversationsApi`.
+ *
+ * Mora no pacote, e não em cada host, porque a regra não tem nada de específico de produto: é a
+ * tradução de `uploadId`/`mediaId` pelos dois métodos que o próprio contrato já declara. Deixá-la no
+ * host significava que todo projeto que adotasse o SDK reescreveria as mesmas oito linhas — e, na
+ * prática, ninguém escrevia: o `MediaRenderer` só busca mídia pela porta `onResolveMediaUrl`, então
+ * onde nada era injetado foto, vídeo e áudio ficavam no placeholder para sempre.
+ */
+
+declare function createMediaUrlResolver(api: Pick<ConversationsApi, 'getDocumentUrl' | 'getMediaProxyUrl'>): ResolveMediaUrl;
+
+export { type AsyncResourceState, AudioPlayer, type AudioPlayerProps, Avatar, type AvatarLabels, type AvatarProps, type BuildTranscriptTextParams, CHANNEL_BRAND_COLOR, CONVERSATION_WINDOW, ChannelIcon, type ChannelIconProps, ConversationChannel, type ConversationContextEntry, ConversationContextPanel, type ConversationContextPanelClassNames, type ConversationContextPanelLabels, type ConversationContextPanelProps, ConversationDocument, ConversationDocumentsPanel, type ConversationDocumentsPanelClassNames, type ConversationDocumentsPanelLabels, type ConversationDocumentsPanelProps, ConversationHeader, type ConversationHeaderClassNames, type ConversationHeaderLabels, type ConversationHeaderProps, ConversationListItem, type ConversationListItemLabels, type ConversationListItemProps, type ConversationLocales, ConversationLocalesProvider, type ConversationLocalesProviderProps, type ConversationRealtimeHandler, ConversationRow, type ConversationRowClassNames, type ConversationRowProps, ConversationSummary, ConversationTemplate, ConversationWallpaper, type ConversationWallpaperProps, type ConversationWindow, ConversationsApi, ConversationsFeatures, ConversationsProvider, DEFAULT_AVATAR_LABELS, DEFAULT_CONVERSATION_CONTEXT_LABELS, DEFAULT_CONVERSATION_DOCUMENTS_LABELS, DEFAULT_CONVERSATION_HEADER_LABELS, DEFAULT_CONVERSATION_LIST_ITEM_LABELS, DEFAULT_DOCUMENTS_LIBRARY_LABELS, DEFAULT_LIGHTBOX_LABELS, DEFAULT_MESSAGE_COMPOSER_LABELS, DEFAULT_TEMPLATES_SETTINGS_LABELS, DEFAULT_WHATSAPP_MESSAGE_EDITOR_LABELS, DEFAULT_WINDOW_EXPIRED_LABELS, DOCUMENT_SOURCE_FILTER, DateDivider, type DateDividerClassNames, type DateDividerProps, type DocumentSourceFilter, DocumentsLibrary, type DocumentsLibraryClassNames, type DocumentsLibraryLabels, type DocumentsLibraryProps, EmojiPicker, type EmojiPickerProps, FileIcon, type FileIconProps, Lightbox, type LightboxLabels, type LightboxProps, ListConversationsParams, ListDocumentsParams, MessageBubble, type MessageBubbleProps, MessageComposer, type MessageComposerClassNames, type MessageComposerLabels, type MessageComposerProps, MessagePayload, MessageTail, MessageText, type MessageTextProps, MessageTimestamp, NARROW_MAX_WIDTH_PX, ResolveMediaUrl, SSEProvider, SimpleEmojiPicker, type SimpleEmojiPickerProps, StatusTicks, type StatusTicksProps, TEMPLATE_SETTINGS_TAB, type TemplateSettingsTab, ToastProvider, type TopicItem, TopicsForm, type TopicsFormLabels, type TopicsFormProps, type UseConversationActionsResult, type UseConversationContextResult, type UseConversationDocumentsParams, type UseConversationDocumentsResult, type UseConversationListParams, type UseConversationListResult, type UseConversationMessagesResult, type UseInboxActionsResult, type UseWaitingNotificationsLabels, type UseWaitingNotificationsParams, type UseWaitingNotificationsResult, WINDOW_FILTERS, WelcomeFarewellForm, type WelcomeFarewellFormLabels, type WelcomeFarewellFormProps, WhatsAppCreateTemplateForm, type WhatsAppCreateTemplateFormLabels, type WhatsAppCreateTemplateFormProps, type WhatsAppCreateTemplateResult, type WhatsAppCreateTemplateState, WhatsAppMessageEditor, type WhatsAppMessageEditorLabels, type WhatsAppMessageEditorProps, type WhatsAppTemplateHeaderType, WhatsAppTemplateSettingsForm, type WhatsAppTemplateSettingsFormLabels, type WhatsAppTemplateSettingsFormProps, type WhatsAppTemplateSummary, type WhatsAppTemplateVariableSuggestion, WhatsAppTemplatesSettings, type WhatsAppTemplatesSettingsLabels, type WhatsAppTemplatesSettingsProps, WindowExpiredNotice, type WindowExpiredNoticeLabels, type WindowExpiredNoticeProps, type WindowOfParams, buildTranscriptFilename, buildTranscriptText, createMediaUrlResolver, downloadTextFile, formatDateTime, formatFileSize, formatPhone, formatStalledFor, formatTimestamp, htmlToWA, isSameDay, isWindowBlocking, parseWhatsAppFormatting, phoneInitials, toast, useConversationActions, useConversationContext, useConversationDocuments, useConversationList, useConversationLocales, useConversationMessages, useConversationRealtime, useConversations, useDarkMode, useGlobalRealtime, useInboxActions, useIsDarkTheme, useIsNarrow, useToast, useWaitingNotifications, waToHTML, waToHTMLInline, windowOf };