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

package/dist/{chunk-4R6Y43DQ.js → chunk-YWITIIHD.js}

@@ -167,6 +167,15 @@ function AudioPlayer({ src, isMine = false }) {
 
 // src/FileIcon.tsx
 import { FileArchive, FileSpreadsheet, FileText, File as FileGeneric } from "lucide-react";
+
+// src/lib/cn.ts
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
+
+// src/FileIcon.tsx
 import { jsx as jsx4 } from "react/jsx-runtime";
 var EXTENSION_STYLE = {
   pdf: { Icon: FileText, colorClass: "text-red-500" },
@@ -176,16 +185,16 @@ var EXTENSION_STYLE = {
   xlsx: { Icon: FileSpreadsheet, colorClass: "text-green-600" },
   zip: { Icon: FileArchive, colorClass: "text-orange-500" }
 };
-function getExtension(filename, mimeType) {
+function resolveFileIconExtension(filename, mimeType) {
   const fromFilename = filename?.split(".").pop()?.toLowerCase();
   if (fromFilename && EXTENSION_STYLE[fromFilename]) return fromFilename;
   return mimeType?.split("/")[1]?.toLowerCase() ?? "";
 }
-function FileIcon({ filename, mimeType, size = 20, className = "" }) {
-  const extension = getExtension(filename, mimeType);
+function FileIcon({ filename, mimeType, size = 20, className }) {
+  const extension = resolveFileIconExtension(filename, mimeType);
   const style = EXTENSION_STYLE[extension] ?? { Icon: FileGeneric, colorClass: "text-gray-500" };
   const { Icon, colorClass } = style;
-  return /* @__PURE__ */ jsx4(Icon, { size, className: `${colorClass} ${className}`.trim() });
+  return /* @__PURE__ */ jsx4(Icon, { size, className: cn(colorClass, className) });
 }
 
 // src/lib/format.ts
@@ -250,7 +259,7 @@ function useLazyMediaUrl(message, onResolveUrl) {
   };
   return { url, loading, error, load };
 }
-function MediaRenderer({ message, onLightbox, onResolveUrl }) {
+function MediaRenderer({ message, onLightbox, onResolveUrl, className }) {
   const { bubble } = useConversationLocales();
   const eagerSrc = resolveMediaSource(message);
   const lazy = useLazyMediaUrl(message, onResolveUrl);
@@ -287,7 +296,7 @@ function MediaRenderer({ message, onLightbox, onResolveUrl }) {
     case "document": {
       const typeLabel = message.mimeType?.split("/")[1]?.toUpperCase() ?? "FILE";
       const sizeLabel = message.sizeBytes ? formatFileSize(message.sizeBytes) : null;
-      return /* @__PURE__ */ jsxs3("div", { className: "flex items-center gap-3 min-w-[200px]", children: [
+      return /* @__PURE__ */ jsxs3("div", { className: cn("flex items-center gap-3 min-w-[200px]", className), children: [
         /* @__PURE__ */ jsx5("div", { className: "w-10 h-10 bg-gray-200 rounded-lg flex items-center justify-center flex-shrink-0", children: /* @__PURE__ */ jsx5(FileIcon, { filename: message.filename, mimeType: message.mimeType }) }),
         /* @__PURE__ */ jsxs3("div", { className: "flex-1 min-w-0", children: [
           /* @__PURE__ */ jsx5("p", { className: "text-sm font-medium truncate", children: message.filename ?? bubble.untitledDocument }),
@@ -332,15 +341,6 @@ function Lightbox({ imageUrl, caption, onClose }) {
 // src/MessageBubble.tsx
 import { useState as useState3 } from "react";
 import { Check } from "lucide-react";
-
-// src/lib/cn.ts
-import { clsx } from "clsx";
-import { twMerge } from "tailwind-merge";
-function cn(...inputs) {
-  return twMerge(clsx(inputs));
-}
-
-// src/MessageBubble.tsx
 import { Fragment, jsx as jsx7, jsxs as jsxs5 } from "react/jsx-runtime";
 var BUBBLE_COLOR = {
   agent: "bg-[#d9fdd3] dark:bg-[#005c4b]",
@@ -712,12 +712,14 @@ export {
   useConversationLocales,
   StatusTicks,
   AudioPlayer,
+  cn,
   FileIcon,
   formatTimestamp,
+  formatDateTime,
+  isSameDay,
   formatFileSize,
   MediaRenderer,
   Lightbox,
-  cn,
   MessageBubble,
   ConversationWallpaper,
   EmojiPicker,

package/dist/index.d.ts

@@ -1,15 +1,17 @@
 import * as react from 'react';
 import react__default, { ReactNode, FormEvent } from 'react';
-import { M as MessagePayload, k as ConversationsFeatures, i as ConversationSummary, f as ConversationChannel, j as ConversationsApi, S as SSEProvider, g as ConversationDocument } from './types-C0PtaO7S.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 ConversationEventSource, l as ConversationsTheme, m as ConversationsUIConfig, D as DEFAULT_CONVERSATION_CHANNEL, F as FormatContactHandleParams, H as HANDLE_KIND, n as HandleKind, R as REOPEN_MECHANISM, o as ReopenMechanism, p as capabilitiesOf, q as channelFiltersFor, r as contactFlag, s as formatContactHandle } from './types-C0PtaO7S.js';
+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 }: MediaRendererProps): react.JSX.Element | null;
+declare function MediaRenderer({ message, onLightbox, onResolveUrl, className }: MediaRendererProps): react.JSX.Element | null;
 
 interface MessageBubbleProps {
     message: MessagePayload;
@@ -380,37 +382,69 @@ declare function WindowExpiredNotice({ onSendTemplate, disabled, labels: labelsO
  */
 declare function isWindowBlocking(window: ConversationWindow): boolean;
 
-/**
- * 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.
- */
 interface ConversationDocumentsPanelLabels {
     toggle: string;
     title: string;
     searchPlaceholder: string;
     empty: string;
+    /** Distinto de `empty`: sem resultado POR CAUSA do filtro, e não conversa sem anexo nenhum. */
+    noResults: string;
     loading: string;
     failure: string;
     download: string;
+    view: string;
+    sourceFilterAll: string;
+    sourceFilterCustomer: string;
+    sourceFilterTeam: string;
+    sortMostRecent: string;
+    sortOldest: string;
+    clearFilters: string;
+    selectAll: string;
+    downloadSelected: (count: number) => string;
+    archiveFailed: string;
+    total: (count: number) => string;
+    page: (current: number, last: number) => string;
 }
 declare const DEFAULT_CONVERSATION_DOCUMENTS_LABELS: ConversationDocumentsPanelLabels;
+/**
+ * Partes estilizáveis do painel, no mesmo contrato do `ConversationHeader`: `cn` funde por cima da
+ * base e conflito de utilitário (padding, tamanho de fonte, borda) fica com o valor do produto.
+ *
+ * `status` cobre carregando/erro/vazio de uma vez — são a mesma linha de texto auxiliar, e slots
+ * separados só multiplicariam chave para quem quer mudar a cor de aviso.
+ */
 interface ConversationDocumentsPanelClassNames {
     root: string;
     body: string;
+    title: string;
+    filters: string;
+    search: string;
+    sourceSelect: string;
+    sortButton: string;
+    clearButton: string;
+    status: string;
+    list: string;
+    item: string;
+    sourceBadge: string;
+    filename: string;
+    meta: string;
+    viewButton: string;
+    downloadButton: string;
+    pagination: string;
+    selectionBar: string;
+    checkbox: string;
 }
 interface ConversationDocumentsPanelProps {
     conversationId: string;
     /** Controlado de fora porque o gatilho vive no cabeçalho, junto das outras ações da conversa. */
     open: boolean;
+    /** Itens por página. O total vem do servidor; sem paginação no host, a barra não aparece. */
+    perPage?: number;
     labels?: Partial<ConversationDocumentsPanelLabels>;
     className?: string;
     classNames?: Partial<ConversationDocumentsPanelClassNames>;
 }
-declare function ConversationDocumentsPanel({ conversationId, open, labels: labelsOverride, className, classNames, }: ConversationDocumentsPanelProps): react.JSX.Element | null;
+declare function ConversationDocumentsPanel({ conversationId, open, perPage, labels: labelsOverride, className, classNames, }: ConversationDocumentsPanelProps): react.JSX.Element | null;
 
 /**
  * Serialização do transcript para download. Fica no pacote porque o formato de um histórico de
@@ -461,11 +495,35 @@ declare function useDarkMode(): {
 declare const NARROW_MAX_WIDTH_PX = 1023;
 declare function useIsNarrow(): boolean;
 
+interface UseWaitingNotificationsLabels {
+    /** Título da notificação do sistema. Recebe a conversa para o host escolher nome × número. */
+    title: (conversation: ConversationSummary) => string;
+    body: (conversation: ConversationSummary) => string;
+}
+interface UseWaitingNotificationsParams {
+    /**
+     * Repassado cru ao `fetchConversations`. É o que permite filtrar não lidas **no servidor** em
+     * vez de baixar a lista inteira e contar no cliente: um painel com milhares de conversas não
+     * pode paginar 50 por vez atrás de quem tem `unread > 0`.
+     */
+    readonly params?: ListConversationsParams;
+    readonly intervalMs?: number;
+    /** Desliga o polling sem desmontar quem chama — útil com a aba em segundo plano. */
+    readonly enabled?: boolean;
+    readonly icon?: string;
+    readonly labels?: Partial<UseWaitingNotificationsLabels>;
+}
 interface UseWaitingNotificationsResult {
     unreadCount: number;
     conversations: ConversationSummary[];
+    /**
+     * Releitura sob demanda. Existe porque o polling é o piso, não o mecanismo: quem já recebe SSE
+     * ou acabou de marcar tudo como lido sabe da mudança antes do próximo tick, e esperar 10s para
+     * o contador acompanhar faz a interface parecer travada.
+     */
+    refresh: () => Promise<void>;
 }
-declare function useWaitingNotifications(): UseWaitingNotificationsResult;
+declare function useWaitingNotifications(params?: UseWaitingNotificationsParams): UseWaitingNotificationsResult;
 
 interface ConversationsContextValue {
     api: ConversationsApi;
@@ -684,7 +742,7 @@ interface UseConversationMessagesResult {
         caption?: string;
     }) => Promise<MessagePayload>;
     sendTemplate: (data: {
-        templateName: string;
+        templateName?: string;
         languageCode?: string;
         bodyParams?: string[];
     }) => Promise<void>;
@@ -695,14 +753,11 @@ declare function useConversationMessages(conversationId: string, params?: {
     before?: string;
 }): UseConversationMessagesResult;
 
-interface UseConversationListParams {
-    page?: number;
-    limit?: number;
-    waitingHuman?: boolean;
-    search?: string;
-}
+type UseConversationListParams = ListConversationsParams;
 interface UseConversationListResult {
     conversations: ConversationSummary[];
+    /** Total no servidor. Cai para o tamanho da página quando a API devolve só o array. */
+    total: number;
     loading: boolean;
     error: Error | undefined;
     refetch: () => Promise<void>;
@@ -717,12 +772,11 @@ interface UseConversationContextResult {
 }
 declare function useConversationContext(conversationId: string): UseConversationContextResult;
 
-interface UseConversationDocumentsParams {
-    search?: string;
-    page?: number;
-}
+type UseConversationDocumentsParams = ListDocumentsParams;
 interface UseConversationDocumentsResult {
     documents: ConversationDocument[];
+    /** Total no servidor. Cai para o tamanho da página quando a API devolve só o array. */
+    total: number;
     loading: boolean;
     error: Error | undefined;
     refetch: () => Promise<void>;
@@ -733,6 +787,27 @@ type ConversationRealtimeHandler = (event: MessageEvent) => void;
 declare function useConversationRealtime(conversationId: string | undefined, onEvent: ConversationRealtimeHandler): void;
 declare function useGlobalRealtime(onEvent: ConversationRealtimeHandler): void;
 
+interface UseConversationActionsResult {
+    /** `undefined` quando a API do host não implementa a operação — a UI esconde a afordância. */
+    takeover: (() => Promise<void>) | undefined;
+    release: (() => Promise<void>) | undefined;
+    finalize: (() => Promise<void>) | undefined;
+}
+/**
+ * Ações de atendimento de UMA conversa, já ligadas ao id.
+ *
+ * Separado de `useConversationMessages` porque assumir e devolver conversa também acontece a
+ * partir da lista, onde nenhuma thread está aberta — embutir nas mensagens obrigaria a carregar
+ * a thread inteira só para desenhar um botão na linha.
+ */
+declare function useConversationActions(conversationId: string): UseConversationActionsResult;
+interface UseInboxActionsResult {
+    markAllRead: (() => Promise<void>) | undefined;
+    listTemplates: (() => Promise<ConversationTemplate[]>) | undefined;
+}
+/** Ações que valem para a caixa inteira, sem conversa selecionada. */
+declare function useInboxActions(): UseInboxActionsResult;
+
 declare function parseWhatsAppFormatting(text: string): ReactNode[];
 declare function waToHTML(text: string): string;
 declare function htmlToWA(html: string): string;
@@ -742,6 +817,8 @@ declare function formatPhone(number: string): string;
 declare function phoneInitials(number: string): string;
 
 declare function formatTimestamp(timestamp: string): string;
+declare function formatDateTime(iso: string): string;
+declare function isSameDay(a: Date, b: Date): boolean;
 declare function formatFileSize(bytes: number): string;
 
 interface AsyncResourceState<T> {
@@ -751,4 +828,4 @@ 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, 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, 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 UseConversationContextResult, type UseConversationDocumentsParams, type UseConversationDocumentsResult, type UseConversationListParams, type UseConversationListResult, type UseConversationMessagesResult, 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, formatFileSize, formatPhone, formatStalledFor, formatTimestamp, htmlToWA, isWindowBlocking, parseWhatsAppFormatting, phoneInitials, toast, useConversationContext, useConversationDocuments, useConversationList, useConversationLocales, useConversationMessages, useConversationRealtime, useConversations, useDarkMode, useGlobalRealtime, useIsDarkTheme, useIsNarrow, useToast, useWaitingNotifications, waToHTML, waToHTMLInline, windowOf };
+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 };