e4ffbb05a5
Бэкенд текстовой связи (AGENT.md 7.6, 7.15, 7.16, 8.6):
- POST/GET/PATCH/DELETE /channels/{id}/messages, ответы и упоминания,
окно правки 24 часа, права автора или MANAGE_MESSAGES;
- реакции (PUT/DELETE .../reactions/{emoji}) с агрегацией и отметкой «моя»;
- закрепления (GET/PUT/DELETE .../pins) под MANAGE_MESSAGES;
- typing с лимитом 1/3 с и адресной рассылкой всем, кроме автора;
- read states: POST /channels/{id}/ack, синхронизация READ_STATE_UPDATE между
устройствами пользователя;
- поиск FTS5 по комнате (10/мин) с экранированием запроса;
- лимиты отправки 5/5 с (burst 10) и slowmode комнаты; администратор инстанса
обходит и то, и другое (AGENT.md 7.19);
- Gateway: DispatchToChannel/DispatchToChannelExcept доставляют события комнат
только тем, кто видит комнату (VIEW_CHANNEL), права считает общий движок;
- store: messages, message_reactions, channel_read_states, files (загрузка
файлов появится вместе с вложениями).
Тесты: жизненный цикл сообщения, видимость скрытой комнаты (404 участнику,
200 админу), slowmode, упоминания и ответы, typing и read state, фильтрация
событий комнаты между двумя WS-клиентами.
103 lines
3.6 KiB
TypeScript
103 lines
3.6 KiB
TypeScript
import { request } from './client';
|
|
import type { Channel, ChannelType, Guild, GuildMember, GuildSummary, Role } from './types';
|
|
|
|
export interface CreateChannelInput {
|
|
name: string;
|
|
type: ChannelType;
|
|
parent_id?: string;
|
|
}
|
|
|
|
export interface UpdateGuildInput {
|
|
name?: string;
|
|
description?: string;
|
|
}
|
|
|
|
export const guildQueryKey = (guildId: string) => ['guilds', guildId] as const;
|
|
export const guildChannelsQueryKey = (guildId: string) => ['guilds', guildId, 'channels'] as const;
|
|
export const guildMembersQueryKey = (guildId: string) => ['guilds', guildId, 'members'] as const;
|
|
export const guildRolesQueryKey = (guildId: string) => ['guilds', guildId, 'roles'] as const;
|
|
|
|
export async function createGuild(name: string): Promise<GuildSummary> {
|
|
const payload = await request<{ guild: GuildSummary }>('/guilds', {
|
|
method: 'POST',
|
|
body: { name },
|
|
});
|
|
return payload.guild;
|
|
}
|
|
|
|
export async function fetchGuild(guildId: string, signal?: AbortSignal): Promise<Guild> {
|
|
const payload = await request<{ guild: Guild }>(
|
|
`/guilds/${encodeURIComponent(guildId)}`,
|
|
signal === undefined ? {} : { signal },
|
|
);
|
|
return payload.guild;
|
|
}
|
|
|
|
export async function updateGuild(guildId: string, input: UpdateGuildInput): Promise<Guild> {
|
|
const payload = await request<{ guild: Guild }>(`/guilds/${encodeURIComponent(guildId)}`, {
|
|
method: 'PATCH',
|
|
body: input,
|
|
});
|
|
return payload.guild;
|
|
}
|
|
|
|
export async function fetchChannels(guildId: string, signal?: AbortSignal): Promise<Channel[]> {
|
|
const payload = await request<{ channels: Channel[] }>(
|
|
`/guilds/${encodeURIComponent(guildId)}/channels`,
|
|
signal === undefined ? {} : { signal },
|
|
);
|
|
return payload.channels;
|
|
}
|
|
|
|
export async function createChannel(guildId: string, input: CreateChannelInput): Promise<Channel> {
|
|
const payload = await request<{ channel: Channel }>(
|
|
`/guilds/${encodeURIComponent(guildId)}/channels`,
|
|
{ method: 'POST', body: input },
|
|
);
|
|
return payload.channel;
|
|
}
|
|
|
|
export async function fetchMembers(guildId: string, signal?: AbortSignal): Promise<GuildMember[]> {
|
|
const payload = await request<{ members: GuildMember[] }>(
|
|
`/guilds/${encodeURIComponent(guildId)}/members`,
|
|
signal === undefined ? {} : { signal },
|
|
);
|
|
return payload.members;
|
|
}
|
|
|
|
export async function fetchRoles(guildId: string, signal?: AbortSignal): Promise<Role[]> {
|
|
const payload = await request<{ roles: Role[] }>(
|
|
`/guilds/${encodeURIComponent(guildId)}/roles`,
|
|
signal === undefined ? {} : { signal },
|
|
);
|
|
return payload.roles;
|
|
}
|
|
|
|
export function joinGuild(guildId: string): Promise<{ ok: true }> {
|
|
return request<{ ok: true }>(`/guilds/${encodeURIComponent(guildId)}/join`, { method: 'POST' });
|
|
}
|
|
|
|
export function leaveGuild(guildId: string): Promise<{ ok: true }> {
|
|
return request<{ ok: true }>(`/guilds/${encodeURIComponent(guildId)}/leave`, { method: 'POST' });
|
|
}
|
|
|
|
/**
|
|
* Свой никнейм на сервере: сервер разрешает участнику менять его без прав
|
|
* (пустая строка сбрасывает ник).
|
|
*/
|
|
export async function updateGuildMember(
|
|
guildId: string,
|
|
userId: string,
|
|
input: { nickname: string },
|
|
): Promise<void> {
|
|
await request<{ ok: true }>(
|
|
`/guilds/${encodeURIComponent(guildId)}/members/${encodeURIComponent(userId)}`,
|
|
{ method: 'PATCH', body: input },
|
|
);
|
|
}
|
|
|
|
/** Удаление сервера: доступно владельцу и администратору инстанса. */
|
|
export async function deleteGuild(guildId: string): Promise<void> {
|
|
await request<{ ok: true }>(`/guilds/${encodeURIComponent(guildId)}`, { method: 'DELETE' });
|
|
}
|