WebSocket Message Types

interface ClientMessage {
  type: string;              // Message type
  conversation_id?: string;  // Conversation ID (if applicable)
  payload?: any;             // Optional payload
}

interface ServerMessage {
  type: string;              // Message type
  conversation_id?: string;  // Conversation ID (if applicable)
  payload?: any;             // Response payload
  error?: string;            // Error message (if error)
}

{
  "type": "join",
  "conversation_id": "uuid"
}

{
  "type": "joined",
  "payload": {
    "conversation_id": "uuid"
  }
}

{
  "type": "leave",
  "conversation_id": "uuid"
}

{
  "type": "left",
  "payload": {
    "conversation_id": "uuid"
  }
}

{
  "type": "message",
  "conversation_id": "uuid",
  "payload": {
    "message_id": "uuid",
    "content": "Hello, world!",
    "message_type": "text"
  }
}

{
  "type": "message",
  "conversation_id": "uuid",
  "payload": {
    "message_id": "uuid",
    "sender_id": "user-uuid",
    "sender_type": "sdk",
    "content": "Hello, world!",
    "message_type": "text",
    "sent_at": "2024-01-01T00:00:00Z"
  }
}

{
  "type": "typing_start",
  "conversation_id": "uuid"
}

{
  "type": "typing",
  "conversation_id": "uuid",
  "payload": {
    "user_id": "user-uuid",
    "state": "start"
  }
}

{
  "type": "typing_stop",
  "conversation_id": "uuid"
}

{
  "type": "typing",
  "conversation_id": "uuid",
  "payload": {
    "user_id": "user-uuid",
    "state": "stop"
  }
}

{
  "type": "read",
  "conversation_id": "uuid",
  "message_id": "message-uuid"
}

{
  "type": "joined",
  "payload": {
    "conversation_id": "uuid"
  }
}

{
  "type": "left",
  "payload": {
    "conversation_id": "uuid"
  }
}

{
  "type": "message",
  "conversation_id": "uuid",
  "payload": {
    "message_id": "uuid",
    "sender_id": "user-uuid",
    "sender_type": "sdk",
    "content": "Hello!",
    "message_type": "text",
    "sent_at": "2024-01-01T00:00:00Z",
    "metadata": {}
  }
}

{
  "type": "typing",
  "conversation_id": "uuid",
  "payload": {
    "user_id": "user-uuid",
    "state": "start"
  }
}

{
  "type": "presence",
  "payload": {
    "user_id": "user-uuid",
    "state": "online"
  }
}

{
  "type": "receipt",
  "conversation_id": "uuid",
  "payload": {
    "message_id": "message-uuid",
    "state": "delivered",
    "user_id": "user-uuid"
  }
}

{
  "type": "support",
  "conversation_id": "uuid",
  "payload": {
    "event": "assigned",
    "agent_id": "agent-uuid",
    "agent_name": "John Doe"
  }
}

{
  "type": "error",
  "error": "conversation_id is required"
}

interface MessagePayload {
  message_id: string;          // Client-generated UUID
  content: string;             // Message content
  message_type: 'text' | 'system'; // Message type
}

interface BroadcastMessagePayload {
  message_id: string;          // Message ID
  sender_id: string;           // Sender user ID
  sender_type: string;         // 'sdk' | 'api' | 'bot' | 'agent'
  content: string;             // Message content
  message_type: string;        // 'text' | 'system'
  sent_at: string;             // ISO 8601 timestamp
  metadata?: object;           // Custom metadata
}

interface TypingPayload {
  user_id: string;
  state: 'start' | 'stop';
}

interface PresencePayload {
  user_id: string;
  state: 'online' | 'offline';
}

interface ReceiptPayload {
  message_id: string;
  state: 'delivered' | 'read';
  user_id?: string;
}

interface SupportEventPayload {
  event: 'assigned' | 'bot_takeover' | 'closed';
  agent_id?: string;
  agent_name?: string;
  resolution?: string;
}

const ws = new WebSocket('wss://ws.dev.vocantly.com/ws', {
  headers: { 'Authorization': `Bearer ${token}` }
});

ws.onopen = () => {
  // Join a conversation
  ws.send(JSON.stringify({
    type: 'join',
    conversation_id: 'conv-123'
  }));
};

ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);
  
  switch (msg.type) {
    case 'joined':
      console.log('Joined:', msg.payload.conversation_id);
      
      // Send a message
      ws.send(JSON.stringify({
        type: 'message',
        conversation_id: 'conv-123',
        payload: {
          message_id: crypto.randomUUID(),
          content: 'Hello!',
          message_type: 'text'
        }
      }));
      break;
      
    case 'message':
      console.log('Message:', msg.payload.content);
      break;
      
    case 'typing':
      console.log(`${msg.payload.user_id} is ${msg.payload.state === 'start' ? 'typing' : 'done'}`);
      break;
      
    case 'presence':
      console.log(`${msg.payload.user_id} is ${msg.payload.state}`);
      break;
      
    case 'receipt':
      console.log(`Message ${msg.payload.message_id}: ${msg.payload.state}`);
      break;
      
    case 'error':
      console.error('Error:', msg.error);
      break;
  }
};