Chat

Descripción

El módulo Chat implementa mensajería en tiempo real usando Stream Chat SDK. Es el módulo más complejo de la aplicación con más de 38 componentes custom.

Ubicación: src/modules/chat/

Este módulo depende del servicio externo Stream Chat. Asegúrate de revisar la configuración del cliente antes de modificar componentes de conexión.

Screens

Screen	Ruta	Descripción
`ChatsListScreen`	`/(tabs)/03_inbox`	Lista de conversaciones
`ChatDetailScreen`	`/chat/[channelType]/[channelId]`	Conversación individual
`ChannelInfoScreen`	`/chat/[channelType]/[channelId]/info`	Información del canal
`ChannelMediaScreen`	`/chat/[channelType]/[channelId]/media`	Galería de medios del canal
`ChatSearchScreen`	`/(tabs)/03_inbox/search`	Búsqueda de mensajes
`ArchivedChatsScreen`	`/(tabs)/03_inbox/archived`	Chats archivados
`ChatOnboardingScreen`	`/chat/invite/onboarding`	Onboarding de chat

API Endpoints

Método	Path	Descripción
`POST`	`/chat/login`	Autenticación con Stream
`POST`	`/chat/refresh`	Renovar token de chat
`PATCH`	`/chat/profile`	Actualizar perfil de chat
`POST`	`/chat/invitations/generate`	Generar invitación de chat
`GET`	`/chat/invitations/info/{token}`	Información de invitación

La autenticación con Stream Chat es independiente del login principal. El token de chat se gestiona a través de chatAuthService.

Hooks

Hook	Descripción
`useStreamClient()`	Gestión del cliente Stream Chat
`useStreamClientEvents()`	Manejo de eventos (mensajes, typing, etc.)
`useUnreadCount()`	Conteo de mensajes no leídos
`useChannelPreviewData()`	Datos de preview de canal
`useChannelMedia()`	Gestión de medios del canal
`useChannelMessageSearch()`	Búsqueda dentro del canal
`useAttachmentHandlers()`	Manejo de archivos/imágenes adjuntas
`useVoiceRecorder()`	Grabación de mensajes de voz
`useAudioPlayer()`	Reproducción de audio
`useChatTheme()`	Personalización de tema
`useKeyboardVisibility()`	Estado del teclado

Tipos principales

Tipos de canal
Tipos de mensaje
Permisos
Delivery status

type ChannelType =
  | "PROPERTY"   // Canal de propiedad
  | "ISSUES"     // Reportes de incidencias
  | "NEWS"       // Noticias y actualizaciones
  | "FEEDBACK"   // Feedback de usuarios
  | "BOOKING";   // Canal asociado a una reserva

type MessageType =
  | "text"
  | "image"
  | "video"
  | "file"
  | "voice"
  | "poll"
  | "private_note"
  | "system"
  | "ai_suggestion";

// Permisos por usuario/canal
interface ChatPermissions {
  userCanWrite: boolean;
  userCanInvite: boolean;
  userCanReact: boolean;
}

type DeliveryStatus =
  | "sending"
  | "sent"
  | "delivered"
  | "read"
  | "failed";

Store

El módulo utiliza chatStore en Zustand para gestionar el estado del chat:

StreamClient — instancia del cliente de Stream Chat
isConnected — estado de conexión
activeChannel — canal actualmente activo
unreadCount — conteo de mensajes no leídos
Token management — almacenamiento y renovación de tokens de chat

Ver Chat Integration para detalles de la integración con Stream.

Componentes destacados

El módulo cuenta con más de 38 componentes custom organizados en tres categorías principales:

message-input/

14+ componentes para entrada de mensajes: InputMicButton, InputSendButton, VoiceRecordingPreview, AttachmentMenu, LocationPicker, ContactPicker, entre otros.

message-attachments/

11 componentes para renderizado de diferentes tipos de adjuntos: imágenes, videos, archivos, notas de voz, ubicaciones, etc. Los PDF se renderizan localmente con pdf.js bundleado (PdfViewerModal, asset src/shared/assets/pdf-viewer.html), sin salir del dispositivo; el resto de documentos previsualizables siguen usando Google Docs Viewer vía WebViewModal. Regenerar el asset con npm run build:pdf-viewer tras actualizar pdfjs-dist.

message/

13 componentes para display de mensajes con diferentes layouts según tipo, estado y permisos.

Services

chatAuthService
channel-name
featureFlagService

Servicio de autenticación específico para Stream Chat: - Token provider: Obtiene y cachea el token de Stream. - Refresh: Renueva el token cuando expira. - Cache: Almacena el token para evitar llamadas innecesarias al backend.

Context

El módulo expone SearchContext para gestionar el estado de búsqueda de mensajes a través de los componentes de la pantalla de búsqueda.

Overview

Architecture

Modules

Shared

Integrations

Guides

Descripción

Screens

API Endpoints

Hooks

Tipos principales

Store

Componentes destacados

message-input/

message-attachments/

message/

Services

Context

​Descripción

​Screens

​API Endpoints

​Hooks

​Tipos principales

​Store

​Componentes destacados

message-input/

message-attachments/

message/

​Services

​Context

Descripción

Screens

API Endpoints

Hooks

Tipos principales

Store

Componentes destacados

Services

Context