Overview
The Chat Service manages chat conversations in the CicloVital application. It provides functionality to retrieve user chats, create new conversations, and delete existing chats.
API Configuration
The service uses environment-based API URL configuration:
const isProd = import.meta.env.VITE_PROD === 'true';
const API_URL = isProd
? import.meta.env.VITE_URL_API_CHAT
: import.meta.env.VITE_URL_API_LOCAL_CHAT;
Functions
getChatsById
Retrieves a summary of all chats for a specific user.
export const getChatsById = async (userId) => {
// Implementation
}
The unique identifier of the user whose chats to retrieve
Response object with chat dataSuccess Response:{
ok: true,
data: response.data // Array of chat summaries
}
{
ok: false,
messageError: string // Error message from server or default error
}
GET
Endpoint: {API_URL}/usuario/{userId}/resumen
Example Usage
import { getChatsById } from '@/services/chatService';
const userId = 'user123';
const result = await getChatsById(userId);
if (result.ok) {
console.log('User chats:', result.data);
result.data.forEach(chat => {
console.log(`Chat ID: ${chat.id}, Title: ${chat.title}`);
});
} else {
console.error('Error fetching chats:', result.messageError);
}
creatChat
Creates a new chat conversation.
export const creatChat = async (chat) => {
// Implementation
}
Chat data for the new conversationStructure:
- Chat metadata and initial settings
- User ID and conversation details
Response object with created chat dataSuccess Response:{
ok: true,
data: response.data // Created chat object with ID
}
{
ok: false,
messageError: string // Error message from server or default error
}
POST
Endpoint: {API_URL}
Example Usage
import { creatChat } from '@/services/chatService';
const newChat = {
userId: 'user123',
title: 'New Conversation',
metadata: {
createdAt: new Date().toISOString()
}
};
const result = await creatChat(newChat);
if (result.ok) {
console.log('Chat created:', result.data);
const chatId = result.data.id;
} else {
console.error('Error creating chat:', result.messageError);
}
deletechat
Deletes a specific chat conversation.
export const deletechat = async (id) => {
// Implementation
}
The unique identifier of the chat to delete
Response object with deletion statusSuccess Response:{
ok: true,
data: response.data // Confirmation message
}
{
ok: false,
messageError: string // Error message from server or default error
}
DELETE
Endpoint: {API_URL}/eliminar/{id}
Example Usage
import { deletechat } from '@/services/chatService';
const chatId = 'chat456';
const result = await deletechat(chatId);
if (result.ok) {
console.log('Chat deleted successfully:', result.data);
} else {
console.error('Error deleting chat:', result.messageError);
}
Error Handling
All service methods use a consistent error handling pattern:
- Server Errors: Returns
error.response?.data if available
- Connection Errors: Returns default message:
'Error al conectar con el servidor.'
- Response Format: Always returns
{ ok: boolean, data/messageError }
- Debug Logging: Errors are logged to console for debugging
Source Code
Location: src/services/chatService.js