Українська
Сховище чатів
Крок 1. Навіщо сховище
Навіщо. Кілька частин екрана показують одні й ті самі чати водночас: панель списку, значок непрочитаних на панелі навігації та панелі вкладок, заголовок вкладки браузера «(3) Chatex», заголовок розмови (тема 19), панель відомостей про чат (тема 21). Якби кожен компонент завантажував власну копію, після першої зміни вони б розходилися. Сховище (store) – це служба, яка володіє цим станом: компоненти читають її сигнали й викликають її методи, а дані більше ніхто не змінює.
Це той самий поділ, що й між кінцевою точкою ASP.NET Core і службою: компонент тонкий, правила тримає сховище. Chatex пише свої сховища вручну на сигналах, а не користується бібліотекою стану на кшталт NgRx: стан невеликий, а прості класи з signal і computed легко читати й тестувати.
Крок 2. ChatsStore
Навіщо. Сховище зберігає список чатів користувача, найактивніші першими, так, як їх повертає GET /api/chats сторінками за ключем (тема 11), а також повні відомості про чати, які вже відкривали. У темі 20 події хаба оновлюватимуть і те, і те; ця тема будує частини, потрібні для HTTP.
Що зробити. Створіть сховище:
ts
import { Injectable, computed, effect, inject, signal } from '@angular/core';
import { Subject, firstValueFrom } from 'rxjs';
import { ChatsApi, avatarUrl } from '../core/api/chatex-api';
import { ChatDto, ChatListItemDto, LastMessageDto, MessageDto } from '../core/api/models';
import { AuthService } from '../core/auth/auth.service';
import { BlobUrlService } from '../core/media/blob-url.service';
/** A chat list row; `lastMessage.deleted` is set locally when the last message gets deleted. */
export type ChatListItem = ChatListItemDto & {
lastMessage?: (LastMessageDto & { deleted?: boolean; hasAttachments?: boolean }) | null;
};
const byActivity = (a: ChatListItem, b: ChatListItem) =>
a.lastActivityAt < b.lastActivityAt ? 1 : a.lastActivityAt > b.lastActivityAt ? -1 : 0;
/** The user's chats (most recently active first), kept current by hub events. */
@Injectable({ providedIn: 'root' })
export class ChatsStore {
private readonly api = inject(ChatsApi);
private readonly auth = inject(AuthService);
private readonly blobs = inject(BlobUrlService);
private nextCursor: string | null = null;
private reloadTimer: ReturnType<typeof setTimeout> | undefined;
readonly items = signal<ChatListItem[]>([]);
readonly loaded = signal(false);
readonly loading = signal(false);
readonly loadingMore = signal(false);
readonly hasMore = signal(false);
/** Full details of chats that were opened, by id. */
readonly details = signal<Readonly<Record<string, ChatDto>>>({});
/** The chat on screen; its new messages don't count as unread. */
readonly activeChatId = signal<string | null>(null);
/** Fires when the user loses access to a chat (deleted, removed, left). */
readonly removed = new Subject<string>();
readonly totalUnread = computed(() =>
this.items().reduce((sum, chat) => sum + (chat.isMuted ? 0 : chat.unreadCount), 0),
);
constructor() {
effect(() => {
this.auth.sessionEpoch();
this.reset();
});
}
async loadFirst(): Promise<void> {
this.loading.set(true);
try {
const page = await firstValueFrom(this.api.list());
this.items.set([...page.items].sort(byActivity));
this.nextCursor = page.nextCursor ?? null;
this.hasMore.set(!!this.nextCursor);
this.loaded.set(true);
} finally {
this.loading.set(false);
}
}
async loadMore(): Promise<void> {
if (!this.nextCursor || this.loadingMore()) {
return;
}
this.loadingMore.set(true);
try {
const page = await firstValueFrom(this.api.list(this.nextCursor));
const known = new Set(this.items().map((c) => c.id));
this.items.update((list) => [...list, ...page.items.filter((c) => !known.has(c.id))]);
this.nextCursor = page.nextCursor ?? null;
this.hasMore.set(!!this.nextCursor);
} finally {
this.loadingMore.set(false);
}
}
/** Loads (or reloads) a chat's details and syncs its list row. */
async loadChat(chatId: string): Promise<ChatDto> {
const chat = await firstValueFrom(this.api.get(chatId));
this.setDetails(chat);
return chat;
}
/** Stores fresh chat details (from any API response) and patches the list row. */
setDetails(chat: ChatDto): void {
const previous = this.details()[chat.id];
if (previous && previous.hasAvatar !== chat.hasAvatar) {
this.blobs.invalidate(avatarUrl.chat(chat.id));
}
this.details.update((all) => ({ ...all, [chat.id]: chat }));
if (!chat.myRole) {
this.items.update((list) => list.filter((c) => c.id !== chat.id));
return;
}
const role = chat.myRole;
const exists = this.items().some((c) => c.id === chat.id);
if (exists) {
this.patch(chat.id, (c) => ({
...c,
title: chat.title,
hasAvatar: chat.hasAvatar,
isMuted: chat.isMuted,
myRole: role,
peer: chat.peer,
}));
} else {
const item: ChatListItem = {
id: chat.id,
type: chat.type,
title: chat.title,
hasAvatar: chat.hasAvatar,
lastActivityAt: new Date().toISOString(),
myRole: role,
isMuted: chat.isMuted,
lastMessage: null,
unreadCount: 0,
peer: chat.peer,
};
this.items.update((list) => [item, ...list]);
}
}
/**
* Forget a chat the user can no longer see. `notify` announces it on `removed` (the open
* conversation then closes with a notice); pass false when the user left or deleted it here.
*/
remove(chatId: string, notify = true): void {
this.items.update((list) => list.filter((c) => c.id !== chatId));
this.details.update((all) => {
const next = { ...all };
delete next[chatId];
return next;
});
if (notify) {
this.removed.next(chatId);
}
}
markReadLocally(chatId: string): void {
this.patch(chatId, (c) => (c.unreadCount ? { ...c, unreadCount: 0 } : c));
}
setMuted(chatId: string, muted: boolean): void {
this.patch(chatId, (c) => ({ ...c, isMuted: muted }));
const chat = this.details()[chatId];
if (chat) {
this.details.update((all) => ({ ...all, [chatId]: { ...chat, isMuted: muted } }));
}
}
/** Keeps the list in step with a message the user just sent. */
noteOwnMessage(message: MessageDto): void {
this.applyMessageCreated(message);
}
private applyMessageCreated(message: MessageDto): void {
const chat = this.items().find((c) => c.id === message.chatId);
if (!chat) {
// A chat we don't have yet (e.g. someone started a direct chat with us).
this.scheduleReload();
return;
}
if (chat.lastMessage && chat.lastMessage.id >= message.id) {
return;
}
const mine = message.sender.id === this.auth.user()?.id;
const visible =
this.activeChatId() === message.chatId && document.visibilityState === 'visible';
this.items.update((list) =>
list
.map((c) =>
c.id === message.chatId
? {
...c,
lastActivityAt: message.createdAt,
lastMessage: {
id: message.id,
senderId: message.sender.id,
body: (message.body ?? '').slice(0, 100),
createdAt: message.createdAt,
hasAttachments: message.attachments.length > 0,
},
unreadCount: mine || visible ? c.unreadCount : c.unreadCount + 1,
}
: c,
)
.sort(byActivity),
);
}
private patch(chatId: string, change: (chat: ChatListItem) => ChatListItem): void {
this.items.update((list) => list.map((c) => (c.id === chatId ? change(c) : c)));
}
private scheduleReload(): void {
clearTimeout(this.reloadTimer);
this.reloadTimer = setTimeout(() => void this.loadFirst().catch(() => undefined), 300);
}
private reset(): void {
clearTimeout(this.reloadTimer);
this.items.set([]);
this.details.set({});
this.loaded.set(false);
this.hasMore.set(false);
this.nextCursor = null;
this.activeChatId.set(null);
}
}ChatListItemрозширює DTO двома клієнтськими прапорцями останнього повідомлення –deletedіhasAttachments– за допомогою типу-перетину (A & B): об’єкта, що має члени обох.- Стан – це набір сигналів:
items(список),loaded,loading,loadingMore,hasMore,details(словник від ідентифікатора чату доChatDto) іactiveChatId– чат на екрані. Це поляreadonly: інший код може викликатиitems()і за домовленістю не викликаєset– стан змінюють лише методи сховища. totalUnread– цеcomputedвідitems: сума лічильників непрочитаних без вимкнених сповіщень чатів. Її читають панель навігації та заголовок вкладки, а перераховується вона лише тоді, коли змінюється список.loadFirst()іloadMore()завантажують першу сторінку й наступні за допомогою непрозорогоnextCursor.loadMoreпропускає чати, які вже відомі, бо чат може переміститися між сторінками, поки користувач прокручує.byActivityсортує заlastActivityAt; часові мітки ISO правильно сортуються як рядки.setDetails(chat)– єдина точка входу для свіжих відомостей про чат із будь-якої відповіді API: створення чату, приєднання, перейменування. Вона зберігає відомості, виправляє рядок списку й додає чат на початок списку, якщо він новий. Якщо користувач більше не учасник (myRoleдорівнює null), рядок видаляється. Якщо змінивсяhasAvatar, вона анулює кешований аватар.remove(chatId, notify)забуває чат і, якщо не сказано інакше, оголошує про це черезremoved–Subjectз RxJS, подію без стану, яку слухає відкрита розмова (тема 19).Subjectтут пасує краще, ніж сигнал: «цей чат видалено» – це те, що відбувається, а не значення, яке існує.markReadLocally,setMuted,noteOwnMessageвикористовує розмова (тема 19).noteOwnMessageпісля надсилання користувачем повідомлення переміщує чат нагору з новим останнім повідомленням; той самий приватний метод застосовуватиме вхідні повідомлення в темі 20.- Ефект на
sessionEpochскидає все, коли користувач виходить (тема 16), тож наступний користувач починає з порожнього списку.
Крок 3. Тестування сховища
Навіщо. Сховище – це проста логіка навколо сигналів, а його залежності – служби, які ми можемо замінити: API – заглушкою, що повертає фіксовані сторінки, AuthService – підробкою з теми 16, BlobUrlService – об’єктом, що має імітацію invalidate.
Що зробити. Створіть специфікацію. Рядок імпорту, виділений жовтим, стане довшим у темі 20, коли до нього приєднаються тести подій хаба.
ts
import { TestBed } from '@angular/core/testing';
import { of } from 'rxjs';
import { fakeAuth } from '../../testing/fakes';
import { ChatsApi } from '../core/api/chatex-api';
import { ChatListItemDto } from '../core/api/models';
import { AuthService } from '../core/auth/auth.service';
import { BlobUrlService } from '../core/media/blob-url.service';
import { ChatsStore } from './chats.store';
function item(
id: string,
lastActivityAt: string,
overrides: Partial<ChatListItemDto> = {},
): ChatListItemDto {
return {
id,
type: 'group',
title: id,
hasAvatar: false,
lastActivityAt,
myRole: 'member',
isMuted: false,
lastMessage: null,
unreadCount: 0,
peer: null,
...overrides,
};
}
describe('ChatsStore', () => {
let store: ChatsStore;
beforeEach(async () => {
Object.defineProperty(document, 'visibilityState', { value: 'visible', configurable: true });
const api = {
list: vi.fn(() =>
of({
items: [
item('chat-old', '2026-11-01T00:00:00Z'),
item('chat-1', '2026-11-05T00:00:00Z'),
item('chat-muted', '2026-11-03T00:00:00Z', { isMuted: true, unreadCount: 4 }),
],
nextCursor: null,
}),
),
};
TestBed.configureTestingModule({
providers: [
{ provide: ChatsApi, useValue: api },
{ provide: AuthService, useValue: fakeAuth() },
{ provide: BlobUrlService, useValue: { invalidate: vi.fn() } },
],
});
store = TestBed.inject(ChatsStore);
TestBed.tick();
await store.loadFirst();
});
const order = () => store.items().map((c) => c.id);
const get = (id: string) => store.items().find((c) => c.id === id)!;
it('lists chats by latest activity', () => {
expect(order()).toEqual(['chat-1', 'chat-muted', 'chat-old']);
});
it('clears unread counts locally', () => {
store.markReadLocally('chat-muted');
expect(get('chat-muted').unreadCount).toBe(0);
});
});{ provide: ChatsApi, useValue: api }замінює службу об’єктом, як реєстрація підробки вIServiceCollection. Структурна типізація TypeScript це полегшує: об’єкту потрібні лише ті члени, які викликає сховище.vi.fn(() => of({ … }))– функція-імітація, що повертає Observable з однією сторінкою;of(value)видає одне значення й завершується, як виконаний виклик HTTP.TestBed.tick()виконує відкладений ефект сховища – скидання – до того, як тест завантажить дані, тож кожен тест починається зі стану, в якому справжній застосунок опиняється після запуску.Object.defineProperty(document, 'visibilityState', …)змушує jsdom повідомляти, що вкладка видима; від цього залежать правила непрочитаних із теми 20.
Перевірка
powershell
npm test -- --watch=false Test Files 5 passed (5)
Tests 21 passed (21)