@adatechnology/conversations-ui 0.3.2 → 0.4.1

package/dist/{ConversationSimulatorPanel-DmV8uaFE.d.ts → ConversationSimulatorPanel-DnXElfY8.d.ts}

@@ -119,6 +119,85 @@ interface MessageTranscription {
     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 WEBCHAT: "webchat";
+    readonly EMAIL: "email";
+};
+type ConversationChannel = (typeof CONVERSATION_CHANNEL)[keyof typeof CONVERSATION_CHANNEL];
+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;
+
 type ResolveMediaUrl = (message: MessagePayload) => Promise<string | null>;
 interface MediaRendererProps {
     message: MessagePayload;
@@ -249,6 +328,12 @@ interface AudioRecorderButtonProps {
     maxDurationMilliseconds?: number;
     labels?: Partial<AudioRecorderButtonLabels>;
     disabled?: boolean;
+    /**
+     * Por que o microfone está desabilitado (RF10, D3) — o canal atual não grava áudio. Sai como
+     * `aria-describedby`, não só `data-cv-tooltip`: o tooltip visual não é lido por leitor de tela
+     * sozinho, e uma dica que só aparece no hover falha exatamente para quem mais precisa dela.
+     */
+    disabledHint?: string;
 }
 /**
  * Cinco minutos: com o codec de voz do WhatsApp isso dá menos de 3MB, folgado dentro do teto de
@@ -256,78 +341,7 @@ interface AudioRecorderButtonProps {
  * existe porque gravação esquecida aberta só se descobre no envio, com o arquivo inteiro perdido.
  */
 declare const DEFAULT_MAX_RECORDING_MILLISECONDS: number;
-declare function AudioRecorderButton({ onRecorded, onFailure, onRecordingChange, reviewBeforeSend, maxDurationMilliseconds, labels, disabled, }: AudioRecorderButtonProps): react.JSX.Element;
-
-/**
- * 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 WEBCHAT: "webchat";
-};
-type ConversationChannel = (typeof CONVERSATION_CHANNEL)[keyof typeof CONVERSATION_CHANNEL];
-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";
-};
-type HandleKind = (typeof HANDLE_KIND)[keyof typeof HANDLE_KIND];
-type ChannelCapabilities = {
-    readonly label: string;
-    readonly icon: string;
-    readonly hasSessionWindow: boolean;
-    readonly windowHours: number;
-    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;
+declare function AudioRecorderButton({ onRecorded, onFailure, onRecordingChange, reviewBeforeSend, maxDurationMilliseconds, labels, disabled, disabledHint, }: AudioRecorderButtonProps): react.JSX.Element;
 
 interface ListConversationsParams {
     page?: number;
@@ -903,4 +917,4 @@ type ConversationSimulatorPanelProps = Omit<ConversationPreviewProps, 'placehold
 };
 declare function ConversationSimulatorPanel({ onClose, channel, displayHandle, displayNumber, labels, headerActions, ...previewProps }: ConversationSimulatorPanelProps): react.JSX.Element;
 
-export { type ListDocumentsParams as $, AudioRecorderButton as A, acceptsMediaKind as B, type ConversationSummary as C, DEFAULT_AUDIO_RECORDER_BUTTON_LABELS as D, assertPreviewEnvironment as E, createPreviewMediaPoster as F, createPreviewMediaUploader as G, createPreviewWebhookClient as H, isConversationSimulatorClient as I, mediaKindOf as J, mediaTypeOf as K, type ListConversationsParams as L, type MessagePayload as M, signPreviewPayload as N, simulatorPanelLabelsOf as O, type PreviewUploadedMedia$1 as P, toConversationSimulatorClient as Q, type ResolveMediaUrl as R, type SSEProvider as S, type ToSimulatorClientParams as T, type InteractiveSelection as U, type MessageTranscription as V, type InteractivePayload as W, type ConversationsFeatures as X, type QuickReply as Y, type ConversationChannel as Z, type TranscriptionMode as _, type ConversationEventSource as a, type ConversationTemplate as a0, type QueuedAttachment as a1, type QuickReplyInput as a2, type QuickReplyAttachment as a3, type ConversationVariable as a4, type ChannelFilter as a5, type ChannelFilterOption as a6, CHANNEL_CAPABILITIES as a7, CHANNEL_FILTER_ALL as a8, CONVERSATION_CHANNEL as a9, type ChannelCapabilities as aa, type CompanyDocument as ab, type CompanyDocumentPage as ac, type ConversationDocumentPage as ad, type ConversationsTheme as ae, type ConversationsUIConfig as af, DEFAULT_CONVERSATION_CHANNEL as ag, DEFAULT_MAX_RECORDING_MILLISECONDS as ah, type FormatContactHandleParams as ai, HANDLE_KIND as aj, type HandleKind as ak, type InteractiveOption as al, type InteractiveSection as am, MediaRenderer as an, type MediaRendererProps as ao, QUICK_REPLY_ATTACHMENT_LIMIT as ap, REOPEN_MECHANISM as aq, type ReopenMechanism as ar, type StoredAttachmentSendResult as as, type TranscriptionStatus as at, capabilitiesOf as au, channelFiltersFor as av, contactFlag as aw, formatContactHandle as ax, type ConversationsApi as b, type ConversationPage as c, type ConversationDocument as d, type SendPreviewMediaParams as e, type PreviewWebhookClient as f, type AudioRecorderButtonLabels as g, type AudioRecorderButtonProps as h, ConversationPreview as i, type ConversationPreviewProps as j, type ConversationSimulatorClient as k, ConversationSimulatorPanel as l, type ConversationSimulatorPanelLabels as m, type ConversationSimulatorPanelProps as n, type CreatePreviewMediaUploaderParams as o, type CreatePreviewWebhookClientParams as p, DEFAULT_CONVERSATION_SIMULATOR_PANEL_LABELS as q, DEFAULT_MEDIA_UPLOAD_PATH as r, PreviewInProductionError as s, PreviewMediaUploadRejectedError as t, type PreviewMediaUploadRequest as u, type PreviewUploadedMedia as v, PreviewWebhookRejectedError as w, SIMULATOR_FILE_MEDIA_KINDS as x, type SendSimulatorMediaParams as y, type SimulatorMediaKind as z };
+export { type ListDocumentsParams as $, AudioRecorderButton as A, acceptsMediaKind as B, type ConversationSummary as C, DEFAULT_AUDIO_RECORDER_BUTTON_LABELS as D, assertPreviewEnvironment as E, createPreviewMediaPoster as F, createPreviewMediaUploader as G, createPreviewWebhookClient as H, isConversationSimulatorClient as I, mediaKindOf as J, mediaTypeOf as K, type ListConversationsParams as L, type MessagePayload as M, signPreviewPayload as N, simulatorPanelLabelsOf as O, type PreviewUploadedMedia$1 as P, toConversationSimulatorClient as Q, type ResolveMediaUrl as R, type SSEProvider as S, type ToSimulatorClientParams as T, type InteractiveSelection as U, type MessageTranscription as V, type ConversationChannel as W, type InteractivePayload as X, type ConversationsFeatures as Y, type QuickReply as Z, type TranscriptionMode as _, type ConversationEventSource as a, type ConversationTemplate as a0, type QueuedAttachment as a1, type QuickReplyInput as a2, type QuickReplyAttachment as a3, type ConversationVariable as a4, type ChannelFilter as a5, type ChannelFilterOption as a6, CHANNEL_CAPABILITIES as a7, CHANNEL_FILTER_ALL as a8, CONVERSATION_CHANNEL as a9, type ChannelCapabilities as aa, type CompanyDocument as ab, type CompanyDocumentPage as ac, type ConversationDocumentPage as ad, type ConversationsTheme as ae, type ConversationsUIConfig as af, DEFAULT_CONVERSATION_CHANNEL as ag, DEFAULT_MAX_RECORDING_MILLISECONDS as ah, type FormatContactHandleParams as ai, HANDLE_KIND as aj, type HandleKind as ak, type InteractiveOption as al, type InteractiveSection as am, MediaRenderer as an, type MediaRendererProps as ao, QUICK_REPLY_ATTACHMENT_LIMIT as ap, REOPEN_MECHANISM as aq, type ReopenMechanism as ar, type StoredAttachmentSendResult as as, type TranscriptionStatus as at, capabilitiesOf as au, channelFiltersFor as av, contactFlag as aw, formatContactHandle as ax, type ConversationsApi as b, type ConversationPage as c, type ConversationDocument as d, type SendPreviewMediaParams as e, type PreviewWebhookClient as f, type AudioRecorderButtonLabels as g, type AudioRecorderButtonProps as h, ConversationPreview as i, type ConversationPreviewProps as j, type ConversationSimulatorClient as k, ConversationSimulatorPanel as l, type ConversationSimulatorPanelLabels as m, type ConversationSimulatorPanelProps as n, type CreatePreviewMediaUploaderParams as o, type CreatePreviewWebhookClientParams as p, DEFAULT_CONVERSATION_SIMULATOR_PANEL_LABELS as q, DEFAULT_MEDIA_UPLOAD_PATH as r, PreviewInProductionError as s, PreviewMediaUploadRejectedError as t, type PreviewMediaUploadRequest as u, type PreviewUploadedMedia as v, PreviewWebhookRejectedError as w, SIMULATOR_FILE_MEDIA_KINDS as x, type SendSimulatorMediaParams as y, type SimulatorMediaKind as z };