@adatechnology/conversations-ui 0.3.2 → 0.4.0

package/src/conversationChannel.ts

@@ -17,6 +17,7 @@ export const CONVERSATION_CHANNEL = {
   MESSENGER: 'messenger',
   INSTAGRAM: 'instagram',
   WEBCHAT: 'webchat',
+  EMAIL: 'email',
 } as const
 export type ConversationChannel = (typeof CONVERSATION_CHANNEL)[keyof typeof CONVERSATION_CHANNEL]
 
@@ -35,14 +36,21 @@ export const HANDLE_KIND = {
   PHONE: 'phone',
   USERNAME: 'username',
   SESSION: 'session',
+  EMAIL: 'email',
 } as const
 export 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.
+ */
 export type ChannelCapabilities = {
   readonly label: string
   readonly icon: string
-  readonly hasSessionWindow: boolean
-  readonly windowHours: number
   readonly reopenMechanism: ReopenMechanism
   readonly handleKind: HandleKind
 }
@@ -51,8 +59,6 @@ export const CHANNEL_CAPABILITIES: Readonly<Record<ConversationChannel, ChannelC
   [CONVERSATION_CHANNEL.WHATSAPP]: {
     label: 'WhatsApp',
     icon: '💬',
-    hasSessionWindow: true,
-    windowHours: 24,
     reopenMechanism: REOPEN_MECHANISM.TEMPLATE,
     handleKind: HANDLE_KIND.PHONE,
   },
@@ -60,16 +66,12 @@ export const CHANNEL_CAPABILITIES: Readonly<Record<ConversationChannel, ChannelC
     // Messenger também tem 24h, mas reabre com message tag — não com template aprovado.
     label: 'Messenger',
     icon: '📨',
-    hasSessionWindow: true,
-    windowHours: 24,
     reopenMechanism: REOPEN_MECHANISM.TAG,
     handleKind: HANDLE_KIND.USERNAME,
   },
   [CONVERSATION_CHANNEL.INSTAGRAM]: {
     label: 'Instagram',
     icon: '📷',
-    hasSessionWindow: true,
-    windowHours: 24,
     reopenMechanism: REOPEN_MECHANISM.TAG,
     handleKind: HANDLE_KIND.USERNAME,
   },
@@ -77,11 +79,16 @@ export const CHANNEL_CAPABILITIES: Readonly<Record<ConversationChannel, ChannelC
     // Chat próprio: sem intermediário, sem janela. Bloquear o composer aqui seria inventar limite.
     label: 'Chat do site',
     icon: '🌐',
-    hasSessionWindow: false,
-    windowHours: 0,
     reopenMechanism: REOPEN_MECHANISM.NONE,
     handleKind: HANDLE_KIND.SESSION,
   },
+  [CONVERSATION_CHANNEL.EMAIL]: {
+    // RF10: e-mail entra no vocabulário; ele não reabre por template nem por tag — é só resposta.
+    label: 'E-mail',
+    icon: '✉️',
+    reopenMechanism: REOPEN_MECHANISM.NONE,
+    handleKind: HANDLE_KIND.EMAIL,
+  },
 }
 
 export function capabilitiesOf(channel: ConversationChannel | undefined): ChannelCapabilities {
@@ -135,6 +142,8 @@ export function formatContactHandle(params: FormatContactHandleParams): string {
 
   if (handleKind === HANDLE_KIND.PHONE) return formatPhone(params.handle)
   if (handleKind === HANDLE_KIND.USERNAME) return params.handle.startsWith('@') ? params.handle : `@${params.handle}`
+  // Endereço de e-mail já é o identificador exibível — nem telefone, nem "@usuário".
+  if (handleKind === HANDLE_KIND.EMAIL) return params.handle
 
   // Sessão de chat de site é um id opaco: mostrar o hash inteiro não ajuda ninguém.
   return `Visitante ${params.handle.slice(-6)}`

package/src/conversationWindow.ts

@@ -1,13 +1,15 @@
 /**
  * Janela de sessão: o intervalo em que o canal aceita mensagem livre do atendente. No WhatsApp são
  * 24h desde o último contato do cliente; fora dela só template. Cada canal tem a sua regra — e há
- * canal sem janela nenhuma — então a política vem de `capabilitiesOf`, não de constante fixa.
+ * canal sem janela nenhuma — então a política vem de `channelCapabilityFor` (RF10), não de
+ * constante fixa.
  *
  * Mora no SDK porque é regra de plataforma, não de produto: todo projeto que usa este pacote
  * precisa dela para saber o que o atendente ainda consegue fazer.
  */
 
-import { capabilitiesOf, type ConversationChannel } from './conversationChannel'
+import { channelCapabilityFor } from './channelCapability'
+import type { ConversationChannel } from './conversationChannel'
 
 const MINUTE_MS = 60_000
 const HOUR_MS = 60 * MINUTE_MS
@@ -52,12 +54,12 @@ export type WindowOfParams = {
  * bloquearia o composer inventando um limite que a plataforma não impõe.
  */
 export function windowOf(params: WindowOfParams): ConversationWindow {
-  const capabilities = capabilitiesOf(params.channel)
-  if (!capabilities.hasSessionWindow) return CONVERSATION_WINDOW.FRESH
+  const capability = channelCapabilityFor(params.channel)
+  if (capability.sessionWindowHours === null) return CONVERSATION_WINDOW.FRESH
 
   if (!params.lastInboundAt) return CONVERSATION_WINDOW.EXPIRED
 
-  const windowMs = capabilities.windowHours * HOUR_MS
+  const windowMs = capability.sessionWindowHours * HOUR_MS
   const elapsed = params.now - new Date(params.lastInboundAt).getTime()
 
   if (elapsed >= windowMs) return CONVERSATION_WINDOW.EXPIRED

package/src/index.ts

@@ -53,7 +53,7 @@ export {
   isReplyOverdue,
 } from './replyLatency'
 export type { ReplyLatency, ReplyLatencyParams } from './replyLatency'
-// Canal de origem: capacidades por plataforma (janela de sessão, reabertura, tipo de identificador).
+// Canal de origem: exibição por plataforma (rótulo, ícone, reabertura, tipo de identificador).
 export {
   CONVERSATION_CHANNEL,
   DEFAULT_CONVERSATION_CHANNEL,
@@ -75,6 +75,10 @@ export type {
   HandleKind,
   FormatContactHandleParams,
 } from './conversationChannel'
+// Capacidade comportamental do canal (RF10, D3) — confirma leitura, janela, anexo, áudio, resposta
+// rápida, transporte próprio. Vem de `@adatechnology/conversation-contracts`; ver channelCapability.ts.
+export { channelCapabilityFor } from './channelCapability'
+export type { ChannelCapability } from '@adatechnology/conversation-contracts'
 export type { ConversationWindow } from './conversationWindow'
 export { ConversationRow } from './ConversationRow'
 export { ChannelIcon, CHANNEL_BRAND_COLOR } from './ChannelIcon'

package/src/preview/ConversationSimulatorPanel.tsx

@@ -66,6 +66,10 @@ const SIMULATOR_PANEL_CHANNEL_WORDING: Readonly<Record<ConversationChannel, Chan
     destinationHint: 'entrega na API do chat do site',
     placeholder: 'Escreva como o visitante…',
   },
+  [CONVERSATION_CHANNEL.EMAIL]: {
+    destinationHint: 'entrega na caixa de entrada do contratante',
+    placeholder: 'Escreva como quem respondeu o e-mail…',
+  },
 }
 
 /** Rótulos do painel já resolvidos para o canal — útil para o host que monta o cabeçalho por fora. */

package/src/workspace/ConversationPane.tsx

@@ -389,6 +389,7 @@ export function ConversationPane({
               <MessageBubble
                 message={message}
                 isMine={message.direction === 'outbound'}
+                channel={conversation.channel}
                 isFirstInGroup={!previous || previous.sender !== message.sender}
                 {...(messageSelection
                   ? {
@@ -507,6 +508,7 @@ export function ConversationPane({
           value={draft}
           onChange={setDraft}
           onSend={(text) => void handleSend(text)}
+          channel={conversation.channel}
           // Habilita clipe E microfone: o composer desenha o gravador sozinho quando existe um jeito
           // de entregar arquivo, porque áudio gravado é um anexo como qualquer outro.
           {...(onAttach ? { onAttach: (file: File) => void handleAttach(file) } : {})}