itd-api 0.1.0 → 0.2.0

package/guides/reference/client.md

@@ -1,184 +0,0 @@
-# Клиент — `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

@@ -1,58 +0,0 @@
-# Комментарии — `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

@@ -1,81 +0,0 @@
-# Поиск и обнаружение — `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

@@ -1,103 +0,0 @@
-# Перечисления
-
-Перечисления заданы парой «замороженный объект + одноимённый тип»: `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

@@ -1,107 +0,0 @@
-# Ошибки
-
-Все ошибки библиотеки — подклассы `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

@@ -1,73 +0,0 @@
-# Файлы — `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 запросов
-в окне.