Реализация 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 });
    });

    // Typing indicator
    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);
      }
    }
  );
}

Typing indicator: 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 недели.