Реалізація Live Chat на сайті

Реалізація Live Chat на веб-сайті

Live chat — це не просто WebSocket з текстом. Повноцінний чат включає історію повідомлень, індикатор друку, статусів прочитання, підтримку файлів та оптимістичного оновлення UI. Кожен з цих елементів вимагає окремих рішень.

Структура даних

interface ChatRoom {
  id:           string;
  type:         'direct' | 'group' | 'support';
  participants: string[];    // userIds
  name?:        string;      // для груп
  lastMessage?: Message;
  unreadCount:  number;
}

interface Message {
  id:           string;
  roomId:       string;
  senderId:     string;
  type:         'text' | 'image' | 'file' | 'system';
  content:      string;
  attachments?: Attachment[];
  replyTo?:     string;       // id батьківського повідомлення
  editedAt?:    Date;
  deletedAt?:   Date;
  status:       'sending' | 'sent' | 'delivered' | 'read';
  createdAt:    Date;
}

interface Attachment {
  id:       string;
  type:     'image' | 'file';
  url:      string;
  name:     string;
  size:     number;
  mimeType: string;
}

Серверна частина: Socket.IO

// server/chat.ts
import { Server, Socket } from 'socket.io';
import { db } from './db';
import { redisAdapter } from '@socket.io/redis-adapter';

export function initChat(io: Server) {
  io.on('connection', async (socket: Socket) => {
    const userId = socket.data.userId;

    // Приєднання до всіх кімнат користувача при підключенні
    const rooms = await db.chatRoom.findMany({
      where: { participants: { has: userId } },
      select: { id: true },
    });
    rooms.forEach(({ id }) => socket.join(`room:${id}`));

    // Надсилання повідомлення
    socket.on('message:send', async (payload: {
      roomId:    string;
      content:   string;
      type:      'text' | 'image' | 'file';
      replyTo?:  string;
      clientId:  string; // тимчасовий id для оптимістичного оновлення
    }, ack) => {
      // Перевіка доступу
      const room = await db.chatRoom.findFirst({
        where: { id: payload.roomId, participants: { has: userId } },
      });
      if (!room) return ack({ error: 'Access denied' });

      const message = await db.message.create({
        data: {
          roomId:    payload.roomId,
          senderId:  userId,
          type:      payload.type,
          content:   payload.content,
          replyToId: payload.replyTo,
          status:    'sent',
        },
      });

      // Broadcast в кімнату
      io.to(`room:${payload.roomId}`).emit('message:new', message);

      // ACK відправнику з серверним id
      ack({ ok: true, message, clientId: payload.clientId });
    });

    // Індикатор друку
    socket.on('typing:start', ({ roomId }) => {
      socket.to(`room:${roomId}`).emit('typing:update', {
        userId,
        roomId,
        isTyping: true,
      });
    });

    socket.on('typing:stop', ({ roomId }) => {
      socket.to(`room:${roomId}`).emit('typing:update', {
        userId,
        roomId,
        isTyping: false,
      });
    });

    // Позначення повідомлень як прочитаних
    socket.on('messages:read', async ({ roomId, upToMessageId }) => {
      await db.messageRead.upsert({
        where:  { userId_roomId: { userId, roomId } },
        update: { lastReadMessageId: upToMessageId, readAt: new Date() },
        create: { userId, roomId, lastReadMessageId: upToMessageId, readAt: new Date() },
      });

      socket.to(`room:${roomId}`).emit('messages:read:update', {
        userId,
        roomId,
        upToMessageId,
      });
    });

    // Історія повідомлень (пагінація курсором)
    socket.on('messages:load', async ({ roomId, before, limit = 50 }, ack) => {
      const messages = await db.message.findMany({
        where: {
          roomId,
          ...(before ? { createdAt: { lt: new Date(before) } } : {}),
          deletedAt: null,
        },
        orderBy: { createdAt: 'desc' },
        take: limit + 1,
        include: { sender: { select: { id: true, name: true, avatar: true } } },
      });

      ack({
        messages:   messages.slice(0, limit).reverse(),
        hasMore:    messages.length > limit,
        nextCursor: messages.length > limit
          ? messages[limit - 1].createdAt.toISOString()
          : null,
      });
    });
  });
}

Оптимістичні оновлення

Повідомлення відображається миттєво, без очікування сервера. При отриманні ACK — замінюється реальним об'єктом:

// store/chat.ts (Zustand)
interface ChatStore {
  messages:    Map<string, Message[]>;
  pendingIds:  Map<string, string>; // clientId -> roomId
  addOptimistic: (roomId: string, content: string) => string;
  confirmMessage: (clientId: string, serverMessage: Message) => void;
  failMessage:   (clientId: string) => void;
}

const useChatStore = create<ChatStore>((set, get) => ({
  messages:   new Map(),
  pendingIds: new Map(),

  addOptimistic(roomId, content) {
    const clientId = `pending-${Date.now()}-${Math.random()}`;
    const optimistic: Message = {
      id:        clientId,
      roomId,
      senderId:  currentUserId,
      type:      'text',
      content,
      status:    'sending',
      createdAt: new Date(),
    };

    set((s) => {
      const msgs = [...(s.messages.get(roomId) ?? []), optimistic];
      s.messages.set(roomId, msgs);
      s.pendingIds.set(clientId, roomId);
      return { messages: new Map(s.messages) };
    });

    return clientId;
  },

  confirmMessage(clientId, serverMessage) {
    set((s) => {
      const roomId = s.pendingIds.get(clientId)!;
      const msgs = s.messages.get(roomId) ?? [];
      const idx = msgs.findIndex((m) => m.id === clientId);
      if (idx !== -1) msgs[idx] = { ...serverMessage, status: 'sent' };
      s.pendingIds.delete(clientId);
      return { messages: new Map(s.messages) };
    });
  },
}));

// Надсилання з оптимістичним оновленням
async function sendMessage(roomId: string, content: string) {
  const clientId = useChatStore.getState().addOptimistic(roomId, content);

  socket.emit('message:send', { roomId, content, type: 'text', clientId },
    (response: { ok: boolean; message?: Message; clientId: string }) => {
      if (response.ok) {
        useChatStore.getState().confirmMessage(clientId, response.message!);
      } else {
        useChatStore.getState().failMessage(clientId);
      }
    }
  );
}

Індикатор друку: Debounce

// У компоненті вводу
const typingTimeout = useRef<ReturnType<typeof setTimeout>>();

function handleInput(value: string) {
  setDraft(value);

  socket.emit('typing:start', { roomId });

  clearTimeout(typingTimeout.current);
  typingTimeout.current = setTimeout(() => {
    socket.emit('typing:stop', { roomId });
  }, 2000);
}

// Відображення
const [typingUsers, setTypingUsers] = useState<Set<string>>(new Set());

socket.on('typing:update', ({ userId, isTyping }) => {
  setTypingUsers((prev) => {
    const next = new Set(prev);
    isTyping ? next.add(userId) : next.delete(userId);
    return next;
  });
});

// UI
{typingUsers.size > 0 && (
  <div className="typing-indicator">
    <span>{getUserNames(typingUsers)} друкує...</span>
    <BouncingDots />
  </div>
)}

Завантаження файлів

Файли не йдуть через WebSocket — спочатку завантажуємо на S3/MinIO, потім передаємо URL у повідомленні:

async function sendFile(roomId: string, file: File) {
  // Завантаження через presigned URL
  const { uploadUrl, fileUrl } = await api.post('/chat/upload-url', {
    filename:  file.name,
    mimeType:  file.type,
    size:      file.size,
  });

  await fetch(uploadUrl, {
    method:  'PUT',
    body:    file,
    headers: { 'Content-Type': file.type },
  });

  const clientId = useChatStore.getState().addOptimistic(roomId, file.name);

  socket.emit('message:send', {
    roomId,
    type:    'file',
    content: file.name,
    clientId,
    attachment: { url: fileUrl, name: file.name, size: file.size, mimeType: file.type },
  }, (response) => {
    if (response.ok) {
      useChatStore.getState().confirmMessage(clientId, response.message!);
    }
  });
}

Push-сповіщення для фонових вкладок

Коли користувач не на сторінці чату, нові повідомлення доставляються через Web Push:

// service-worker.ts
self.addEventListener('push', (event: PushEvent) => {
  const data = event.data?.json();
  event.waitUntil(
    self.registration.showNotification(data.senderName, {
      body:  data.content,
      icon:  data.senderAvatar,
      badge: '/badge.png',
      data:  { roomId: data.roomId, url: `/chat/${data.roomId}` },
    })
  );
});

self.addEventListener('notificationclick', (event: NotificationEvent) => {
  event.notification.close();
  event.waitUntil(
    clients.openWindow(event.notification.data.url)
  );
});

Базовий чат (текст, історія, присутність): 5–7 днів. Повна реалізація з файлами, push-сповіщеннями, read receipts та пошуком: 2–3 тижні.