Connect (Messaging)

Overview

Connect is the real-time messaging module enabling user-to-user communication. It supports direct messages, group chats, order-related conversations, and system messages.

Module path: src/lib/modules/connect/ Routes: /connect, /connect/[id]

Chat Types

Type	Description
`DIRECT`	One-on-one conversation
`GROUP`	Multi-user chat
`ONE_TO_ONE`	Alternative direct chat
`ORDER`	Order-related communication
`SYSTEM`	System-generated messages

Chat Statuses

Status	Description
`Requested`	Connection request pending
`Accepted`	Active conversation
`Declined`	Request rejected
`Expired`	Request expired

Data Model

interface ChatConversation {
  id: string;
  members: string[];
  messages: ChatMessage[];
  status: ChatStatus;
  archived: boolean;
  pinned: boolean;
  type: ChatType;
  // ...
}

interface ChatMessage {
  id: string;
  text: string;
  senderId: string;
  reactions: Record<string, string[]>;
  mentions: string[];
  readBy: string[];
  createdAt: Timestamp;
  editedAt?: Timestamp;
  deletedFor?: string[];
}

Services

ChatService

File: src/lib/modules/connect/services/chat.service.ts

Method	Description
`createConversation()`	Start new chat
`createMessage()`	Send message
`deleteMessage()`	Delete for all
`deleteMessageForUser()`	Delete for self only
`addReaction()`	Add emoji reaction
`editMessage()`	Edit sent message
`blockUser()` / `unblockUser()`	Block/unblock
`markAsSpam()` / `unmarkAsSpam()`	Spam management
`sendDisputeNotificationMessage()`	System dispute messages

ChatFilterService

File: src/lib/modules/connect/services/chat-filter.service.ts

filterChatsByTab() - Filter by all/spammed/blocked/archive
highlightText() - Highlight search matches
processLastMessage() - Replace @mentions with usernames

State Management

chatManager

chatManager.chats;                    // Active conversations
chatManager.chatsAll;                 // All conversations
chatManager.chatsArchived;            // Archived
chatManager.chatsRequested;           // Connection requests
chatManager.chatsSpammed;             // Spam
chatManager.blockedUsers;             // Blocked users
chatManager.countChatsWithUnreadMessages; // Unread count
chatManager.members;                  // Current chat members

chatManager.setChatId(id);
chatManager.setMessageIdSelected(id);
chatManager.setTypingStatus(status);

Chat Features

Emoji reactions on messages
@mentions with autocomplete
Message editing and deletion
Read receipts
Archive/Pin conversations
Mute/Snooze notifications
Spam reporting with metadata
User blocking
Threaded replies
Shared media panel

Components

Chat List

Component	Purpose
`chats.svelte`	Active chat list
`chat-item-preview.svelte`	Chat preview card
`archive-chats.svelte`	Archived conversations
`request-chats.svelte`	Pending requests
`blocked-chats.svelte`	Blocked conversations
`spammed-chats.svelte`	Spam conversations

Chat Interface

Component	Purpose
`chat-body.svelte`	Message display area
`message-input-area.svelte`	Message composition
`message-item.svelte`	Individual message
`messages-list.svelte`	Message list
`message-menu.svelte`	Right-click actions
`mention-link.svelte`	Clickable @mention

Component	Purpose
`chat-search-input.svelte`	Search messages
`chat-search-results.svelte`	Search results
`chat-tabs.svelte`	Tab navigation
`header.svelte`	Chat header
`snooze-popover.svelte`	Snooze settings

Firestore Collections

chats/{chatId}           # Chat conversation with messages
users/{userId}/
├── blockedUsers/        # Blocked user records
├── spammedChats/        # Spam reports
└── mentions/            # @mention notifications