itd-api 0.0.11 → 0.1.0

package/guides/reference/client.md

@@ -0,0 +1,184 @@
+# Клиент — `ItdClient`
+
+Точка входа. Группирует ресурсы (`itd.posts`, `itd.users`, …) и берёт на себя авторизацию,
+обновление токена, повторы и очередь запросов. Достаточно **одного экземпляра на приложение**.
+
+```ts
+new ItdClient(options?: ItdClientOptions)
+createClient(options?: ItdClientOptions): ItdClient   // то же самое, фабрика
+```
+
+Точка входа `itd-api/node` дополнительно даёт загрузку файлов по пути и файловые хранилища
+(`FileTokenStorage`, `FileMultiTokenStorage`).
+
+## Ресурсы
+
+| Свойство | Ресурс |
+|---|---|
+| `itd.auth` | [Авторизация](./auth.md) |
+| `itd.users` | [Пользователи](./users.md) |
+| `itd.posts` | [Посты](./posts.md) |
+| `itd.comments` | [Комментарии](./comments.md) |
+| `itd.files` | [Файлы](./files.md) |
+| `itd.notifications` | [Уведомления](./notifications.md) |
+| `itd.hashtags`, `itd.search` | [Поиск и обнаружение](./discovery.md) |
+| `itd.reports` | [Жалобы](./reports.md) |
+| `itd.verification` | [Верификация](./verification.md) |
+| `itd.subscription` | [Подписка](./subscription.md) |
+| `itd.platform` | [Платформа](./platform.md) |
+| `itd.telemetry` | телеметрия просмотров |
+
+## Методы
+
+```ts
+get baseUrl: string
+```
+Базовый URL, к которому обращается клиент.
+
+```ts
+request<T = unknown>(options: RawRequestOptions): Promise<T>
+```
+Произвольный запрос к API — запасной путь, когда нужного метода нет. Проходит через ту же
+авторизацию, очередь и обработку ошибок. С `raw: true` возвращает тело без снятия обёртки
+`{ data: … }`.
+
+```ts
+use(plugin: ItdPlugin): this
+pluginNames(): string[]
+hasPlugin(name: string): boolean
+unuse(name: string): Promise<boolean>
+```
+Подключает плагин — обёртку вокруг запроса и разобранного ответа сразу для всех ресурсов.
+Официальные плагины: [`@itd-api/cache`](../plugins/README.md),
+[`@itd-api/crypto`](../plugins/README.md). Остальные методы показывают фактический порядок
+плагинов, проверяют наличие и отключают плагин с вызовом его teardown.
+
+```ts
+defineService(definition: ServiceDefinition): this
+serviceBaseUrl(name: string): string
+```
+Регистрирует / читает домен платформы, отличный от основного (запросы с `{ service: 'имя' }`).
+Bearer-токен по умолчанию уходит только на основной хост и его поддомены.
+
+```ts
+realtime(options?: RealtimeOptions): ItdRealtime
+```
+Создаёт поток уведомлений. Каждый вызов — новый независимый поток. См. [Realtime](./realtime.md).
+
+```ts
+on<K>(event: K, listener): Unsubscribe
+```
+Подписывается на [события авторизации](#события). Возвращает функцию отписки.
+
+```ts
+close(): Promise<void>
+dispose(): Promise<void>
+```
+`close()` временно останавливает очередь и закрывает потоки уведомлений; после него клиентом
+можно пользоваться снова. `dispose()` дополнительно отключает плагины и освобождает их
+ресурсы. `await using` вызывает `dispose()`.
+
+```ts
+getSession(): Promise<ItdSession | null>
+setSession(session: ItdSession): Promise<void>
+getUserId(): Promise<UserId | undefined>
+```
+Читает / восстанавливает текущую сессию целиком и идентификатор аккаунта из токена (без запроса).
+
+## События
+
+Метод `itd.on(event, listener)` — ключи `AuthEvents`:
+
+| Событие | Данные | Когда |
+|---|---|---|
+| `tokens` | `{ accessToken }` | токен получен или обновлён |
+| `signIn` | `{ accessToken }` | выполнен вход |
+| `signOut` | — | сессия очищена |
+| `authError` | `{ error }` | обновить сессию не удалось; запросы будут падать с 401 |
+
+## Опции конструктора
+
+```ts
+interface ItdClientOptions {
+  baseUrl?: string;                      // по умолчанию https://xn--d1ah4a.com
+  services?: Record<string, string | Omit<ServiceDefinition, 'name'>>;
+  auth?: AuthInput;                      // см. ниже
+  storage?: TokenStorage;                // по умолчанию MemoryTokenStorage
+  autoRefresh?: boolean;                 // обновлять токен при 401; по умолчанию true
+  reloginOnRefreshFailure?: boolean;     // войти заново при неудаче refresh (нужны email+пароль)
+  fetch?: typeof fetch;                  // своя реализация: Deno, RN, тесты, прокси
+  timeout?: number;                      // по умолчанию 30000; 0 — без ограничения
+  retry?: RetryOptions | false;
+  rateLimit?: RateLimitOptions | false;
+  hooks?: ClientHooks;
+  logger?: Logger | boolean;             // true — писать в console (токены маскируются)
+  headers?: Record<string, string>;
+  deviceId?: string;                     // X-Device-Id; стабильный; иначе заведётся сам
+  userAgent?: string | false;            // false — не слать; в браузере не действует
+  mode?: RuntimeMode;                    // как обращаться с cookie
+}
+```
+
+### Авторизация (`AuthInput`)
+
+```ts
+type AuthInput =
+  | string                                              // готовый accessToken
+  | { accessToken: string; refreshToken?: string }      // восстановить сессию
+  | { email: string; password: string;                  // залогиниться самому
+      turnstileToken?: string;
+      getTurnstileToken?: () => string | Promise<string> }
+  | { getToken: () => string | null | Promise<string | null> };  // токен извне
+```
+
+### Повторы (`RetryOptions`)
+
+```ts
+interface RetryOptions {
+  attempts?: number;                     // всего попыток, включая первую; по умолчанию 3
+  baseDelay?: number;                    // базовая пауза, удваивается; по умолчанию 500
+  maxDelay?: number;                     // верхняя граница; по умолчанию 30000
+  jitter?: number;                       // разброс 0…1; по умолчанию 0.3
+  retryWrites?: boolean;                 // повторять запись при сбоях; по умолчанию false
+  shouldRetry?: (error: unknown, attempt: number) => boolean;
+}
+```
+
+### Очередь и лимиты (`RateLimitOptions`)
+
+```ts
+interface RateLimitOptions {
+  concurrency?: number;                  // одновременных запросов; по умолчанию 6
+  rps?: number;                          // верхняя граница запросов в секунду
+  retryDelays?: readonly number[];       // паузы при 429; [1000, 5000, 30000, 60000, 90000]
+  respectHeaders?: boolean;              // тормозить по x-ratelimit-*; по умолчанию true
+}
+```
+
+### Хуки (`ClientHooks`)
+
+```ts
+interface ClientHooks {
+  onRequest?(ctx: RequestContext): void | Promise<void>;    // до отправки, headers изменяемы
+  onResponse?(ctx: ResponseContext): void | Promise<void>;  // после успеха, до разбора тела
+  onError?(ctx: ErrorContextHook): void | Promise<void>;    // при любой ошибке запроса
+  onRetry?(ctx: RetryContext): void | Promise<void>;        // перед паузой между попытками
+}
+```
+
+### Произвольный запрос (`RawRequestOptions`)
+
+```ts
+interface RawRequestOptions extends RequestOptions {
+  method: string;
+  path: string;                          // с ведущим слэшем; завершающий слэш значим
+  service?: string;                      // хост зарегистрированного сервиса
+  baseUrl?: string;                      // хост этого запроса; важнее service
+  query?: QueryParams;
+  body?: unknown;                        // JSON; для файлов — FormData
+  skipAuth?: boolean;                    // не подставлять токен; false — разрешить внешнему хосту
+  skipAuthRefresh?: boolean;             // не обновлять токен при 401
+  skipQueue?: boolean;                   // мимо очереди
+  raw?: boolean;                         // вернуть тело без снятия обёртки { data }
+}
+```

package/guides/reference/comments.md

@@ -0,0 +1,58 @@
+# Комментарии — `itd.comments`
+
+Ответы на комментарии и действия над ними. Комментарии **к посту** живут в
+[`itd.posts`](./posts.md#комментарии-к-посту): `itd.posts.comments()` и `itd.posts.comment()`.
+
+## Ответы
+
+```ts
+replies(commentId: string, params?: RepliesParams): Promise<Page<Comment>>
+iterateReplies(commentId: string, params?: RepliesParams): Paginator<Comment>
+```
+Ответы на комментарий. Здесь пагинация **постраничная** (у комментариев к посту — курсорная).
+См. [`Comment`](./models.md#comment).
+
+```ts
+reply(commentId: string, input: CommentInput | string): Promise<Comment>
+```
+Отвечает на комментарий. Поддерживает `replyTo(userId)` в билдере — адресат ответа.
+
+## Действия
+
+```ts
+update(commentId: string, content: string): Promise<Comment>
+```
+Редактирует текст комментария.
+
+```ts
+remove(commentId: string): Promise<void>
+restore(commentId: string): Promise<Comment>
+```
+Удаляет / восстанавливает комментарий.
+
+```ts
+like(commentId: string): Promise<LikeResult>
+unlike(commentId: string): Promise<LikeResult>
+```
+Ставит / убирает реакцию. См. [`LikeResult`](./models.md#likeresult).
+
+## Типы
+
+```ts
+type CommentInput = CreateCommentInput | CommentBuilder | ((b: CommentBuilder) => CommentBuilder | CreateCommentInput);
+
+interface CreateCommentInput {
+  content?: string;                      // у голосового пустой
+  attachmentIds?: string[];
+  files?: FileInput[];
+  replyToUserId?: UserId;                // только в reply(), не в комментарии к посту
+}
+
+interface RepliesParams extends RequestOptions {
+  limit?: number;
+  page?: number;
+  maxPages?: number;
+}
+```
+
+См. также [Билдеры](./builders.md) (`comment()`).

package/guides/reference/discovery.md

@@ -0,0 +1,81 @@
+# Поиск и обнаружение — `itd.search`, `itd.hashtags`
+
+Глобальный поиск, хэштеги и тренды, а также рекомендации, кланы и баннер события. Часть
+методов физически принадлежит другим ресурсам (`itd.users`, `itd.platform`) — здесь они
+собраны по смыслу.
+
+## Глобальный поиск — `itd.search`
+
+```ts
+all(query: string): Promise<SearchResult>
+```
+Ищет пользователей и хэштеги одним запросом.
+
+```ts
+interface SearchResult {
+  users: UserSummary[];                  // см. models.md#usersummary
+  hashtags: Hashtag[];                   // см. models.md#hashtag
+}
+```
+
+## Хэштеги — `itd.hashtags`
+
+```ts
+search(query?: string, params?: { limit?: number }): Promise<Hashtag[]>
+```
+Ищет хэштеги. Без строки запроса возвращает общий список.
+
+```ts
+trending(params?: { limit?: number }): Promise<Hashtag[]>
+```
+Трендовые хэштеги.
+
+```ts
+posts(tag: string, params?: HashtagPostsParams): Promise<Page<Post>>
+iteratePosts(tag: string, params?: HashtagPostsParams): Paginator<Post>
+```
+Посты по хэштегу. Курсорная пагинация. `tag` — без решётки; кодируется автоматически,
+кириллица и пробелы допустимы. См. [`Post`](./models.md#post).
+
+```ts
+interface HashtagPostsParams extends RequestOptions {
+  limit?: number;
+  cursor?: string;
+  maxPages?: number;
+}
+```
+
+## Пользователи — `itd.users`
+
+Полное описание — в [Пользователи](./users.md#поиск-и-рекомендации).
+
+```ts
+itd.users.search(query: string, params?: { limit?: number }): Promise<UserSummary[]>
+```
+Поиск пользователей по строке.
+
+```ts
+itd.users.whoToFollow(): Promise<UserSummary[]>
+```
+Рекомендации, на кого подписаться.
+
+```ts
+itd.users.topClans(): Promise<Clan[]>
+```
+Рейтинг кланов. См. [`Clan`](./models.md#clan).
+
+## Портал — `itd.platform`
+
+```ts
+itd.platform.portal(): Promise<Portal>
+```
+Баннер текущего события — виджет «портал». См. [`Portal`](./models.md#portal) и
+[Платформа](./platform.md).
+
+```ts
+interface Portal {
+  active: boolean;
+  title: string;
+  url: string;
+}
+```

package/guides/reference/enums.md

@@ -0,0 +1,103 @@
+# Перечисления
+
+Перечисления заданы парой «замороженный объект + одноимённый тип»: `FeedTab.Popular` работает
+как константа, `FeedTab` — как тип. Обычные строки тоже принимаются
+(`itd.posts.list({ tab: 'popular' })`).
+
+**Открытые** множества (помечены `Loose`) не ломаются, если сервер пришлёт значение вне перечня;
+**закрытые** — сервер отвергнет неизвестное. Перебрать значения в рантайме: `Object.values(FeedTab)`.
+
+## FeedTab
+
+Вкладка ленты. Закрытое.
+
+| Значение | Курсор | Описание |
+|---|---|---|
+| `Popular` = `'popular'` | номер страницы (`"2"`) | популярное |
+| `Following` = `'following'` | отметка времени | записи тех, на кого вы подписаны |
+| `Clan` = `'clan'` | отметка времени | лента клана |
+
+## CommentSort
+
+Порядок комментариев к посту.
+
+`Newest` `'newest'` · `Oldest` `'oldest'` · `Popular` `'popular'`.
+
+## AttachmentType
+
+Тип вложения.
+
+`Image` `'image'` · `Video` `'video'` · `Audio` `'audio'` (голосовые: `audio/ogg`, с `duration`).
+
+## SpanType
+
+Тип фрагмента разметки. Открытое.
+
+`Hashtag` (имя в `tag`) · `Mention` (имя в `tag`/`username`) · `Link` (адрес в `url`) ·
+`Bold` · `Italic` · `Underline` · `Strike` · `Spoiler` · `Monospace` · `Quote`.
+
+## ReportTargetType
+
+На что подаётся жалоба. `Post` `'post'` · `Comment` `'comment'` · `User` `'user'`.
+
+## ReportReason
+
+Причина жалобы. Закрытое.
+
+`Spam` · `Violence` · `Hate` · `Adult` · `Fraud` · `Other`.
+
+## NotificationType
+
+Канонический тип уведомления. Открытое. REST отдаёт старые имена, поток — новые; библиотека
+приводит их к этому набору, сохраняя исходное в `rawType`.
+
+| Значение | Старое имя | Событие |
+|---|---|---|
+| `PostReaction` `'post_reaction'` | `like` | реакция на пост |
+| `PostComment` `'post_comment'` | `comment` | комментарий к посту |
+| `CommentReply` `'comment_reply'` | `reply` | ответ на комментарий |
+| `PostRepost` `'post_repost'` | `repost` | репост |
+| `PostMention` `'post_mention'` | `mention` | упоминание в посте |
+| `CommentReaction` `'comment_reaction'` | — | реакция на комментарий |
+| `CommentMention` `'comment_mention'` | — | упоминание в комментарии |
+| `WallPost` `'wall_post'` | — | запись на вашей стене |
+| `Follow` `'follow'` | — | на вас подписались |
+| `FollowRequest` `'follow_request'` | — | заявка на подписку |
+| `FollowAccepted` `'follow_accepted'` | — | заявка принята |
+| `VerificationApproved` / `VerificationRejected` | — | верификация (только REST) |
+
+## AccessType, WallAccess, LikesVisibility
+
+Уровень доступа к разделу профиля. Открытое. `WallAccess` и `LikesVisibility` — псевдонимы
+`AccessType`.
+
+`Nobody` `'nobody'` · `Mutual` `'mutual'` (взаимные) · `Followers` `'followers'` · `Everyone` `'everyone'`.
+
+## RealtimeStatus
+
+Состояние realtime-соединения.
+
+`Connecting` · `Connected` · `Error` · `Disconnected`.
+
+## ServiceState
+
+Состояние сервиса платформы. Открытое.
+
+`Operational` `'operational'` · `Degraded` `'degraded'` · `Downtime` `'downtime'`.
+
+## IncidentKind
+
+Вид происшествия в истории сервиса. Открытое. `Down` `'down'` · `Degraded` `'deg'`.
+
+## OAuthProvider
+
+Провайдер внешнего входа. `Yandex` `'yandex'` · `Google` `'google'`.
+
+## SignInStatus
+
+Чем закончился вход. `Authenticated` `'authenticated'` · `OtpRequired` `'otp_required'`.
+
+## Телеметрия (экспериментально)
+
+`InteractionType`, `ViewSource`, `ViewReason` — числовые коды для недокументированных
+эндпоинтов `itd.telemetry.*`. Библиотека сама их не отправляет.

package/guides/reference/errors.md

@@ -0,0 +1,107 @@
+# Ошибки
+
+Все ошибки библиотеки — подклассы `ItdError`. Ошибки сервера (HTTP ≥ 400) сведены к одной
+иерархии `ItdApiError` независимо от формы ответа.
+
+```ts
+try {
+  await itd.users.updateMe({ username: 'занятое_имя' });
+} catch (error) {
+  if (error instanceof ItdValidationError) error.fieldErrors.username;  // ['Имя уже занято']
+  else if (error instanceof ItdRateLimitError) error.rateLimitRemaining;
+  else if (isItdApiError(error)) console.log(error.status, error.code);
+  else throw error;
+}
+```
+
+## Иерархия
+
+```
+ItdError
+├─ ItdApiError            сервер ответил статусом ≥ 400
+│  ├─ ItdValidationError        400 / 422 — данные не прошли валидацию
+│  ├─ ItdAuthError              401 — токен отсутствует, истёк или отозван
+│  ├─ ItdForbiddenError         403 — доступ запрещён или ограничен приватностью
+│  ├─ ItdNotFoundError          404 — сущность не найдена
+│  ├─ ItdConflictError          409 — сущность уже существует
+│  ├─ ItdRateLimitError         429 — превышен лимит запросов
+│  ├─ ItdPhoneVerificationError PHONE_VERIFICATION_REQUIRED
+│  └─ ItdServerError            5xx — ошибка на стороне сервера
+├─ ItdNetworkError        запрос не дошёл до сервера
+├─ ItdTimeoutError        истёк таймаут
+├─ ItdAbortError          отменён через AbortSignal
+└─ ItdConfigError         неверная конфигурация или аргументы (до обращения к сети; бросают билдеры)
+```
+
+Категория ошибки — в поле `kind` (`ItdErrorKind`): `'api'` | `'network'` | `'timeout'` |
+`'abort'` | `'config'`.
+
+## `ItdApiError`
+
+```ts
+class ItdApiError extends ItdError {
+  status: number;                        // HTTP-статус
+  code: ItdErrorCode;                    // строковый код, например 'VALIDATION_ERROR'
+  detail: string | undefined;
+  title: string | undefined;
+  fieldErrors: ItdFieldErrors;           // { поле: ['ошибка'] }; {} если нет
+  requestId: string | undefined;
+  method: string;
+  path: string;
+  raw: unknown;                          // тело ответа как пришло
+  response: Response | undefined;
+  retryAfter: number | undefined;        // мс; итд.com его не присылает
+  rateLimit: number | undefined;         // x-ratelimit-limit
+  rateLimitRemaining: number | undefined;// x-ratelimit-remaining
+  apiKind: ItdApiErrorKind;              // разновидность для сравнения
+
+  hasCode(...codes: ItdErrorCode[]): boolean;   // проверить код
+  get isRetryable: boolean;                     // 429 или ≥ 500
+}
+```
+
+`ItdPhoneVerificationError` дополнительно даёт `verificationUrl` — ссылку на Telegram-бота
+подтверждения.
+
+`ItdNetworkError` / `ItdTimeoutError` содержат `method` и `path`; `ItdTimeoutError` — ещё
+и `timeout`.
+
+## Функции-предикаты
+
+Определяют ошибку **по данным**, а не через `instanceof` (надёжнее при двух копиях пакета
+или смешении ESM/CJS):
+
+```ts
+isItdError(v)              // любая ошибка библиотеки
+isItdApiError(v)           // ответ сервера ≥ 400
+isItdValidationError(v)
+isItdAuthError(v)
+isItdForbiddenError(v)
+isItdNotFoundError(v)
+isItdConflictError(v)
+isItdRateLimitError(v)
+isItdPhoneVerificationError(v)
+isItdServerError(v)
+```
+
+## Коды ошибок — `ItdErrorCode`
+
+Строковые коды из поля `code`. Список открыт. Ключи повторяют написание сервера — код из
+ответа можно найти поиском один в один. Проверять удобно через `error.hasCode(…)`.
+
+Основные группы:
+
+- **Общие:** `BAD_REQUEST`, `UNAUTHORIZED`, `ACCESS_DENIED`, `ENTITY_NOT_FOUND`, `NOT_FOUND`,
+  `ENTITY_ALREADY_EXISTS`, `VALIDATION_ERROR`, `BUSINESS_RULE_VIOLATION`, `RATE_LIMIT_EXCEEDED`,
+  `UNKNOWN_ERROR`.
+- **Капча/OTP:** `TURNSTILE_VERIFICATION_FAILED`, `CAPTCHA_FAILED`, `OTP_INVALID`,
+  `INVALID_FLOW_TOKEN`, `MISSING_FLOW_TOKEN`.
+- **Аккаунт:** `ACCOUNT_DEACTIVATED`, `ACCOUNT_INVALID_CREDENTIALS`, `ACCOUNT_TEMPORARILY_LOCKED`,
+  `ACCOUNT_CURRENT_PASSWORD_INCORRECT`, `ACCOUNT_EMAIL_DOMAIN_NOT_ALLOWED`.
+- **Сессия:** `SESSION_EXPIRED`, `SESSION_REVOKED`, `SESSION_INVALID_REFRESH_TOKEN`,
+  `SESSION_NOT_FOUND`, `REFRESH_TOKEN_MISSING`.
+- **Профиль/контент:** `PROFILE_USERNAME_TAKEN`, `PROFILE_RESTRICTION_ACTIVE`,
+  `PROFILE_MODIFICATION_RESTRICTED`, `CONTENT_MODERATION_FAILED`, `WRITE_ACCESS_RESTRICTED`.
+- **Файлы:** `FILE_TOO_LARGE`, `UNSUPPORTED_FILE_TYPE`, `UPLOAD_FAILED`,
+  `VIDEO_REQUIRES_VERIFICATION`.
+- **Телефон:** `PHONE_VERIFICATION_REQUIRED`.

package/guides/reference/files.md

@@ -0,0 +1,73 @@
+# Файлы — `itd.files`
+
+Загрузка и удаление медиа. Обычно вызывать напрямую не нужно: [`itd.posts.create()`](./posts.md)
+и `itd.posts.comment()` загружают файлы сами через поле `files`.
+
+Загрузка файла **по пути** (строка) работает только в Node, Bun и Deno — подключите точку
+входа `itd-api/node`. В браузере и React Native передавайте `File` или `Blob`.
+
+## Методы
+
+```ts
+upload(input: FileInput, options?: UploadOptions): Promise<UploadedFile>
+```
+Загружает файл и возвращает его идентификатор и CDN-адрес. Таймаут по умолчанию —
+`DEFAULT_UPLOAD_TIMEOUT` (300 000 мс): видео не укладывается в обычные 30 секунд.
+
+```ts
+uploadMany(files: FileInput[], options?: UploadOptions): Promise<string[]>
+```
+Загружает несколько файлов **последовательно**, сохраняя порядок. Возвращает идентификаторы
+вложений в порядке входных файлов.
+
+```ts
+remove(fileId: string): Promise<void>
+```
+Удаляет загруженный файл.
+
+```ts
+get(fileId: string): Promise<unknown>
+```
+Сведения о файле. На практике сервер отвечает `404` даже на только что загруженный,
+ещё не прикреплённый файл, — метод оставлен для полноты.
+
+## Типы
+
+```ts
+type FileInput =
+  | Blob
+  | ArrayBuffer
+  | Uint8Array
+  | string                               // путь на диске (только Node/Bun/Deno)
+  | { data: Blob | ArrayBuffer | Uint8Array; filename?: string; contentType?: string };
+
+interface UploadedFile {
+  id: string;                            // передаётся в attachmentIds
+  url: string;                           // адрес на CDN
+}
+
+interface UploadOptions extends RequestOptions {
+  filename?: string;                     // по нему определяется тип, если не задан
+  contentType?: string;                  // MIME; иначе по имени файла или самому Blob
+  validateMime?: boolean;                // проверять тип до отправки; по умолчанию true
+}
+
+const DEFAULT_UPLOAD_TIMEOUT = 300_000;
+```
+
+## Допустимые типы
+
+Наборы MIME экспортируются из корня пакета — по ним библиотека проверяет вложения до отправки
+(`validateMime`):
+
+```ts
+ALLOWED_MIME_TYPES     // весь список
+IMAGE_MIME_TYPES       // изображения
+VIDEO_MIME_TYPES       // видео
+AUDIO_MIME_TYPES       // аудио (голосовые: audio/ogg)
+```
+
+Кроме типа сервер проверяет и само изображение: слишком маленькие картинки он отклоняет
+(«Не удалось проверить изображение»); 64×64 проходит. Загрузка видео может требовать
+верификации (`VIDEO_REQUIRES_VERIFICATION`), лимит частоты у `/api/files/upload` — 15 запросов
+в окне.