itd-api 0.2.0 → 0.4.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { i as createTokenStorage, n as MemoryTokenStorage, r as TokenStorage, t as ItdSession } from "./storage-BjNRlkbE.cjs";
-import { _ as StreamFile, a as createRecordMultiStorage, b as fromStream, c as DEFAULT_URL_FILE_MAX_BYTES, d as FileInput, f as FileStreamContent, g as LazyFile, h as FromStreamOptions, i as createMultiTokenStorage, l as FileContent, m as FileTransferMode, n as MultiTokenStorage, o as scopedTokenStorage, p as FileStreamOptions, r as RecordStorageSource, s as DEFAULT_FILE_STREAM_BUFFER_BYTES, t as MemoryMultiTokenStorage, u as FileContext, v as UrlFile, x as fromUrl, y as UrlFileOptions } from "./multi-storage-NDqzRQcD.cjs";
+import { _ as StreamFile, a as createRecordMultiStorage, c as DEFAULT_URL_FILE_MAX_BYTES, d as FileInput, f as FileStreamContent, g as LazyFile, h as FromStreamOptions, i as createMultiTokenStorage, l as FileContent, m as FileTransferMode, n as MultiTokenStorage, o as scopedTokenStorage, p as FileStreamOptions, r as RecordStorageSource, s as DEFAULT_FILE_STREAM_BUFFER_BYTES, t as MemoryMultiTokenStorage, u as FileContext, v as UrlFile, y as UrlFileOptions } from "./multi-storage-DP_ujJw1.cjs";
 //#region src/types/enums.d.ts
 /**
  * Перечисления API итд.com.
@@ -326,12 +326,12 @@ declare const ItdErrorCode: Readonly<{
 }>;
 type ItdErrorCode = Loose<(typeof ItdErrorCode)[keyof typeof ItdErrorCode]>;
 //#endregion
-//#region src/types/models.d.ts
+//#region src/models/common.d.ts
 /**
  * Дата и время в формате ISO-8601, например `2026-07-21T14:30:00.000Z`.
  *
  * Библиотека не превращает такие поля в `Date`: строку проще сравнивать, логировать
- * и передавать дальше без потерь. Для разбора есть {@link toDate}.
+ * и передавать дальше без потерь. Для разбора есть `toDate()`.
  */
 type IsoDate = string;
 /**
@@ -371,705 +371,148 @@ interface Span {
   /** Идентификатор пользователя у некоторых ответов API с `mention`. */
   id?: string;
 }
+//#endregion
+//#region src/core/clock.d.ts
 /**
- * Значок-«пин» в профиле — награда или отметка платформы.
+ * Часы, которыми клиент измеряет время и планирует отложенную работу.
+ *
+ * Своя реализация нужна прежде всего в тестах: она позволяет проверять тайм-ауты,
+ * повторы и переподключение без ожидания в реальном времени.
  */
-interface Pin {
-  /** Постоянный идентификатор, например `epepuy_202605_59`. */
-  slug: string;
-  /** Отображаемое название. */
-  name: string;
-  /** Описание, за что выдан. */
-  description: string;
-  /** Адрес изображения. */
-  url: string;
-  /** Когда выдан. Приходит только в списке своих пинов. */
-  grantedAt?: IsoDate;
+interface ItdClock {
+  /** Текущее время в миллисекундах с начала эпохи Unix. */
+  now(): number;
+  /** Планирует вызов после завершения текущего стека и возвращает функцию отмены. */
+  schedule(callback: () => void, delay: number): () => void;
 }
+/** Системные часы, используемые клиентом по умолчанию. */
+declare const systemClock: ItdClock;
+//#endregion
+//#region src/core/runtime.d.ts
 /**
- * Автор поста или комментария.
+ * Как библиотека обращается с cookie.
  *
- * Встречается внутри `post.author` и `comment.author`.
+ * - `browser` — cookie ведёт браузер, запросы уходят с `credentials: 'include'`;
+ * - `server` — cookie ведёт встроенный jar, заголовок `Cookie` подставляется вручную;
+ * - `auto` — определяется по среде исполнения (значение по умолчанию).
  */
-interface Author {
-  id: UserId;
-  username: string;
-  displayName: string;
+declare const RuntimeMode: Readonly<{
+  /** Определяется по среде исполнения. Значение по умолчанию. */
+  readonly Auto: "auto";
+  /** Cookie ведёт браузер, запросы уходят с `credentials: 'include'`. */
+  readonly Browser: "browser";
+  /** Cookie ведёт встроенный jar, заголовок `Cookie` подставляется вручную. */
+  readonly Server: "server";
+}>;
+type RuntimeMode = (typeof RuntimeMode)[keyof typeof RuntimeMode];
+/** Распознанная среда исполнения. */
+declare const DetectedRuntime: Readonly<{
+  readonly Browser: "browser";
+  /** Есть `window`, но нет `document`; cookie ведёт нативный сетевой слой. */
+  readonly ReactNative: "react-native";
+  readonly Server: "server";
+}>;
+type DetectedRuntime = (typeof DetectedRuntime)[keyof typeof DetectedRuntime];
+//#endregion
+//#region src/core/services.d.ts
+/** Сервис платформы на отдельном домене. */
+interface ServiceDefinition {
+  /** Имя, по которому запрос выбирает сервис: `{ service: 'status' }`. */
+  name: string;
+  /** Базовый URL сервиса. */
+  baseUrl: string;
+  /** Заголовки, добавляемые к каждому запросу сервиса. Заголовки вызова важнее. */
+  headers?: Record<string, string> | undefined;
   /**
-   * **Эмодзи, а не картинка.**
+   * Слать ли заголовок авторизации.
    *
-   * На итд.com аватар — это символ клана (`🩵`, `🦎`), а не адрес изображения.
-   * Отрисовывать его нужно как текст.
+   * По умолчанию включено для основного хоста и его поддоменов. Для остальных хостов
+   * авторизацию нужно разрешить явно: `auth: true`.
    */
-  avatar: string;
-  /** Пройдена ли верификация. */
-  verified: boolean;
-  /** Активный значок профиля. Может отсутствовать. */
-  pin?: Pin | null;
-  /** Есть ли премиум-подписка (значок NUKSTA). */
-  hasNuksta?: boolean;
-}
-/**
- * Участник события в уведомлении.
- *
- * Отличается от {@link Author} набором полей: вместо значков приходит связь с вами.
- */
-interface Actor {
-  id: UserId;
-  username: string;
-  displayName: string;
-  /** Эмодзи-аватар, см. {@link Author.avatar}. */
-  avatar: string;
-  /** Подписаны ли вы на этого пользователя. */
-  isFollowing?: boolean;
-  /** Подписан ли он на вас. */
-  isFollowedBy?: boolean;
+  auth?: boolean | undefined;
 }
 /**
- * Пользователь в списках.
+ * Именованные сервисы клиента.
  *
- * Набор полей зависит от эндпоинта: подписчики и подписки приносят `isFollowing`,
- * поиск и рекомендации — `followersCount` и `hasNuksta`. Необязательные поля отражают
- * это различие.
+ * @internal
  */
-interface UserSummary {
-  id: UserId;
-  username: string;
-  displayName: string;
-  /** Эмодзи-аватар, см. {@link Author.avatar}. */
-  avatar: string;
-  verified: boolean;
-  /** Подписаны ли вы. Приходит в списках подписчиков и подписок. */
-  isFollowing?: boolean;
-  /** Есть ли премиум. Приходит в поиске и рекомендациях. */
-  hasNuksta?: boolean;
-  /** Число подписчиков. Приходит в поиске и рекомендациях. */
-  followersCount?: number;
-}
-/** Поля профиля, общие для своего и чужого. */
-interface ProfileBase {
-  id: UserId;
-  username: string;
-  displayName: string;
-  /** Эмодзи-аватар, см. {@link Author.avatar}. */
-  avatar: string;
-  /** URL изображения баннера либо `null`. */
-  banner: string | null;
-  /** Описание профиля. */
-  bio: string;
-  verified: boolean;
-  pin?: Pin | null;
-  /** Кто может писать на стену. */
-  wallAccess: WallAccess;
-  /** Кто видит реакции. */
-  likesVisibility: LikesVisibility;
-  followersCount: number;
-  followingCount: number;
-  postsCount: number;
-  createdAt: IsoDate;
-}
-/** Состояние подписки на премиум. */
-interface SubscriptionState {
-  isActive: boolean;
-  expiresAt: IsoDate | null;
-  autoRenewal: boolean;
+declare class ServiceRegistry {
+  #private;
+  /** @param primaryBaseUrl базовый URL клиента */
+  constructor(primaryBaseUrl?: string);
+  /**
+   * Регистрирует сервис. Имя очищается от краевых пробелов, базовый URL приводится
+   * к каноничному виду, а незаданный `auth` выводится из хоста.
+   *
+   * @throws {ItdConfigError} если имя пустое, имя занято или `baseUrl` не абсолютный URL
+   */
+  define(definition: ServiceDefinition): void;
+  /** Определение сервиса либо `undefined`, если такого нет. */
+  get(name: string): ServiceDefinition | undefined;
+  /** Зарегистрирован ли сервис с таким именем. */
+  has(name: string): boolean;
+  /**
+   * Определение сервиса.
+   *
+   * @throws {ItdConfigError} если сервис не зарегистрирован
+   */
+  require(name: string): ServiceDefinition;
+  /**
+   * Базовый URL сервиса.
+   *
+   * @throws {ItdConfigError} если сервис не зарегистрирован
+   */
+  resolveBaseUrl(name: string): string;
+  /**
+   * Принадлежит ли URL основному хосту клиента или его поддомену.
+   *
+   * Используется для безопасного значения по умолчанию у разового `baseUrl`: Bearer-токен
+   * не должен уходить на посторонний хост без явного `skipAuth: false`.
+   *
+   * @internal
+   */
+  isPrimarySite(baseUrl: string): boolean;
 }
+//#endregion
+//#region src/core/url.d.ts
+/** Значение параметра запроса. `undefined` и `null` в строку не попадают. */
+type QueryValue = string | number | boolean | null | undefined | readonly (string | number | boolean)[];
+/** Параметры строки запроса. */
+type QueryParams = Record<string, QueryValue>;
+//#endregion
+//#region src/types/options.d.ts
 /**
- * Свой профиль — ответ `GET /api/users/me`.
+ * Вход по логину и паролю.
  *
- * Отличается от чужого наличием {@link subscription} и {@link isPhoneVerified}
- * и отсутствием полей связи (`isFollowing`, `online`).
+ * Вход требует токен капчи Cloudflare Turnstile, поэтому полностью автоматическим он быть
+ * не может: капчу должен решить кто-то снаружи. Токен одноразовый и живёт несколько минут,
+ * так что долгоживущему клиенту нужен `getTurnstileToken` — он спрашивается заново перед
+ * каждой попыткой входа. Одиночный `turnstileToken` годится для разового скрипта.
  */
-interface MyProfile extends ProfileBase {
-  /** Закрыт ли профиль. */
-  isPrivate: boolean;
-  /** Подтверждён ли телефон. Без него часть действий недоступна. */
-  isPhoneVerified: boolean;
-  /** Своя премиум-подписка. */
-  subscription: SubscriptionState;
+interface CredentialsAuth {
+  email: string;
+  password: string;
+  /** Разовый токен капчи. Для повторного входа после истечения сессии не подойдёт. */
+  turnstileToken?: string | undefined;
+  /** Источник свежего токена капчи. Спрашивается перед каждым входом. */
+  getTurnstileToken?: (() => string | Promise<string>) | undefined;
 }
 /**
- * Состояние авторизации — ответ `GET /api/profile`.
+ * Как клиент получает доступ к API.
  *
- * Endpoint доступен без сессии: в этом случае `authenticated` равен `false`,
- * а `user` — `null`.
- */
-interface AuthState {
-  /** Есть ли действующая сессия. */
-  authenticated: boolean;
-  /** Заблокирован ли текущий аккаунт. */
-  banned: boolean;
-  /** Текущий пользователь либо `null` без действующей сессии. */
-  user: MyProfile | null;
-}
-/**
- * Чужой профиль — ответ `GET /api/users/{id|username}`.
+ * Четыре формы — от разового вызова с готовым токеном до полноценной сессии, которую
+ * библиотека заводит и продлевает сама.
  *
- * Вместо своей подписки содержит связь с вами и присутствие.
- */
-interface PublicProfile extends ProfileBase {
-  hasNuksta?: boolean;
-  /** Закреплённый пост, если он есть. */
-  pinnedPostId: string | null;
-  /** Подписаны ли вы на него. */
-  isFollowing: boolean;
-  /** Подписан ли он на вас. */
-  isFollowedBy: boolean;
-  /** Сейчас ли пользователь в сети. */
-  online: boolean;
-  /** Когда был в сети. `null`, если скрыто настройками приватности. */
-  lastSeen: IsoDate | null;
-}
-/** Профиль: свой либо чужой. Различаются функцией {@link isMyProfile}. */
-type Profile = MyProfile | PublicProfile;
-/**
- * Свой ли это профиль.
+ * Опция необязательна: если {@link ItdClientOptions.storage} уже содержит сессию, доступ
+ * берётся оттуда. Когда заданы обе, хранилище главнее — оно отражает текущее состояние
+ * сессии, — а недостающие поля берутся отсюда.
  *
  * @example
  * ```ts
- * if (isMyProfile(profile)) console.log(profile.subscription.isActive);
- * ```
- */
-declare function isMyProfile(profile: Profile): profile is MyProfile;
-/** Вложение поста или комментария. */
-interface Attachment {
-  id: string;
-  type: AttachmentType;
-  /** Адрес файла на CDN. */
-  url: string;
-  /** Ширина изображения или видео в пикселях. */
-  width?: number;
-  /** Высота изображения или видео в пикселях. */
-  height?: number;
-  mimeType: string;
-  /** Исходное имя файла. Приходит не всегда. */
-  filename?: string;
-  /** Размер в байтах. Приходит не всегда. */
-  size?: number;
-  /** Длительность аудио или видео в секундах. */
-  duration?: number | null;
-  /** Порядковый номер во вложениях поста. */
-  order?: number;
-}
-/** Вариант ответа в опросе. */
-interface PollOption {
-  id: string;
-  text: string;
-  /** Сколько голосов отдано за этот вариант. */
-  votesCount: number;
-  /** Порядковый номер варианта, начиная с нуля. */
-  position: number;
-}
-/** Опрос внутри поста. */
-interface Poll {
-  id: string;
-  /** Пост, которому принадлежит опрос. */
-  postId: string;
-  question: string;
-  /** Можно ли выбрать несколько вариантов. */
-  multipleChoice: boolean;
-  options: PollOption[];
-  totalVotes: number;
-  /** Голосовали ли вы. */
-  hasVoted: boolean;
-  /** За что проголосовали вы. Пустой массив, если голоса не было. */
-  votedOptionIds: string[];
-  createdAt: IsoDate;
-}
-/** Пост ленты, стены или профиля. */
-interface Post {
-  id: string;
-  content: string;
-  /** Разметка текста. Передаётся без изменений, см. {@link Span}. */
-  spans: Span[];
-  author: Author;
-  attachments: Attachment[];
-  likesCount: number;
-  commentsCount: number;
-  repostsCount: number;
-  viewsCount: number;
-  /** Чья это стена, если пост опубликован не у себя. */
-  wallRecipientId: UserId | null;
-  /** Владелец стены. Приходит не во всех ответах. */
-  wallRecipient?: Author | null;
-  /** Поставили ли вы реакцию. */
-  isLiked: boolean;
-  /** Делали ли вы репост. */
-  isReposted: boolean;
-  /** Засчитан ли просмотр. */
-  isViewed: boolean;
-  /** Ваш ли это пост. */
-  isOwner: boolean;
-  /** Исходный пост, если это репост. */
-  originalPost?: Post | null;
-  poll?: Poll | null;
-  /** Преобладающая реакция — эмодзи либо `null`. */
-  dominantEmoji?: string | null;
-  /** Когда пост отредактировали. `null`, если не редактировали. */
-  editedAt: IsoDate | null;
-  createdAt: IsoDate;
-  /**
-   * Служебная метка показа для телеметрии.
-   *
-   * Нужна только эндпоинтам `itd.telemetry.*`. В остальных случаях игнорируйте.
-   */
-  vs?: string;
-  /**
-   * Топовые комментарии. Приходят только в ответе `GET /api/posts/{id}`.
-   *
-   * В списках постов поле отсутствует.
-   */
-  comments?: Comment[];
-}
-/** На чей комментарий дан ответ. */
-interface CommentReplyTo {
-  id: string;
-  username: string;
-  displayName: string;
-}
-/** Комментарий к посту или ответ на комментарий. */
-interface Comment {
-  id: string;
-  /** Текст. У голосового комментария пустой. */
-  content: string;
-  /**
-   * Разметка текста, включая автоматически найденные сервером хэштеги и упоминания.
-   *
-   * Методы создания и редактирования комментария принимают только `content`, поэтому
-   * библиотека не отправляет ручные spans в этих операциях.
-   * Поле необязательно: отдельные ответы сервера могут его не содержать.
-   */
-  spans?: Span[];
-  author: Author;
-  likesCount: number;
-  repliesCount: number;
-  isLiked: boolean;
-  createdAt: IsoDate;
-  /** Вложения. У голосового — одно аудио с `mimeType: 'audio/ogg'`. */
-  attachments?: Attachment[];
-  /** Вложенные ответы. В списках приходит превью, полный список — через `itd.comments.replies()`. */
-  replies?: Comment[];
-  /** Заполнено только у ответов. */
-  replyTo?: CommentReplyTo;
-}
-/**
- * Уведомление в единой форме.
- *
- * REST-список и SSE-поток отдают уведомления по-разному — разные имена типов, разные имена
- * полей, один участник против массива. Библиотека приводит оба вида к этой структуре,
- * поэтому объекты из `itd.notifications.list()` и из потока можно складывать в один список.
- *
- * Исходные данные не теряются: сервeрное имя типа остаётся в {@link rawType},
- * а весь необработанный объект — в {@link raw}.
- */
-interface Notification {
-  id: string;
-  /** Канонический тип. Старые имена (`like`, `comment`) приведены к новым. */
-  type: NotificationType;
-  /** Имя типа в том виде, в каком его прислал сервер. */
-  rawType: string;
-  /** Объект события: пост, комментарий, пользователь. */
-  entityId: string | null;
-  /** Пост, которому принадлежит комментарий, если событие о комментарии. */
-  parentEntityId: string | null;
-  /** Прочитано ли уведомление. */
-  isRead: boolean;
-  /** Кто совершил действие. Для схлопнутых уведомлений — несколько человек. */
-  actors: Actor[];
-  /** Сколько участников схлопнуто в одно уведомление. Минимум 1. */
-  count: number;
-  /** Текст или заголовок объекта события. */
-  preview: string | null;
-  /** Ссылка перехода, предложенная сервером. Обычно точнее её `resolveNotificationUrl()`. */
-  clickUrl?: string;
-  createdAt: IsoDate;
-  /** Когда уведомление изменилось — например было прочитано. */
-  updatedAt: IsoDate;
-  /** Исходный объект как он пришёл от сервера. */
-  raw: unknown;
-}
-/** Настройки приватности профиля. */
-interface PrivacySettings {
-  /** Закрыт ли профиль: подписка требует одобрения. */
-  isPrivate: boolean;
-  wallAccess: WallAccess;
-  likesVisibility: LikesVisibility;
-  /** Показывать ли время последнего посещения. */
-  showLastSeen: boolean;
-}
-/**
- * Настройки уведомлений.
- *
- * Сервер отдаёт плоский объект, но исторически знает два набора имён для одних и тех же
- * настроек (`likes` и `reactions`, `comments` и `replies`). При сохранении библиотека
- * отправляет оба, при чтении принимает любой.
- */
-interface NotificationSettings {
-  /** Общий выключатель доставки. */
-  enabled: boolean;
-  /** Звук уведомления. */
-  sound: boolean;
-  /** Новые подписчики. */
-  follows: boolean;
-  /** Записи на вашей стене. */
-  wallPosts: boolean;
-  /** Реакции на ваши записи. */
-  likes: boolean;
-  /** Комментарии и ответы. */
-  comments: boolean;
-  /** Упоминания. */
-  mentions: boolean;
-}
-/** Активная сессия входа. */
-interface Session {
-  id: string;
-  /** Та ли это сессия, из которой выполнен запрос. */
-  isCurrent: boolean;
-  createdAt: IsoDate;
-  lastUsedAt: IsoDate;
-  expiresAt: IsoDate;
-  ipAddress: string;
-  /** Код страны по IP, например `RU`. */
-  ipCountry: string | null;
-  ipCity: string | null;
-  deviceType: Loose<'desktop' | 'mobile'>;
-  osName: string | null;
-  osVersion: string | null;
-  /** Название браузера или приложения. */
-  clientName: string | null;
-  clientVersion: string | null;
-  deviceModel: string | null;
-}
-/** Состояние платной подписки и её цена. */
-interface Subscription {
-  /** Активна ли подписка сейчас. */
-  active: boolean;
-  /** Включено ли автопродление. */
-  recurringEnabled: boolean;
-  /** Цена в рублях. */
-  price: number;
-}
-/** Сохранённый способ оплаты. */
-interface PaymentMethod {
-  id: string;
-  /** Последние четыре цифры карты. */
-  last4?: string;
-  /** Платёжная система: `visa`, `mastercard`, `mir`. */
-  brand?: string;
-  /** Основной ли это способ оплаты. */
-  isDefault?: boolean;
-  expiresAt?: IsoDate | null;
-}
-/** Хэштег. */
-interface Hashtag {
-  id: string;
-  /** Название без решётки. */
-  name: string;
-  /** Сколько постов с этим хэштегом. */
-  postsCount: number;
-}
-/** Клан в рейтинге. */
-interface Clan {
-  /** Эмодзи клана — оно же аватар его участников. */
-  avatar: string;
-  memberCount: number;
-}
-/**
- * Результат подписки на пользователя.
- *
- * @example
- * ```ts
- * const result = await itd.users.follow('nowkie');
- * // { following: true, followersCount: 11 }
- * ```
- */
-interface FollowResult {
-  /** Подписка оформлена. У закрытого профиля отправляется заявка, и здесь будет `false`. */
-  following: boolean;
-  /** Сколько подписчиков стало у пользователя после действия. */
-  followersCount?: number;
-  /** Статус заявки, если профиль закрыт. */
-  status?: Loose<'following' | 'requested'>;
-}
-/** Запись журнала изменений платформы. */
-interface ChangelogEntry {
-  version: string;
-  date: string;
-  changes: string[];
-}
-/** Кнопка в анонсе платформы. */
-interface AnnouncementButton {
-  title: string;
-  /** Оформление: `primary`, `secondary` и другие. */
-  style: string;
-  action: {
-    type: string;
-    [key: string]: unknown;
-  };
-}
-/** Анонс на главной странице платформы. */
-interface Announcement {
-  id: string;
-  image: {
-    url: string;
-    width: number;
-    height: number;
-  };
-  title: string;
-  description: string;
-  /** Дополнительный текст мелким шрифтом. */
-  additional_text?: string;
-  buttons: AnnouncementButton[];
-}
-/** Баннер текущего события — виджет «портал». */
-interface Portal {
-  active: boolean;
-  title: string;
-  url: string;
-}
-/** Происшествие в истории сервиса. */
-interface StatusIncidentLine {
-  /** Вид происшествия. */
-  t: IncidentKind;
-  /**
-   * Готовая строка для показа: `недоступен 6 мин (12:00–12:06)`. Время московское.
-   * Длительность и границы интервала отдельными полями не приходят.
-   */
-  text: string;
-}
-/** Одни сутки в истории сервиса. */
-interface StatusDay {
-  /** Худшее состояние за сутки. */
-  type: ServiceState;
-  /** Дата суток, `YYYY-MM-DD`. Сутки нарезаны по UTC. */
-  date_key: string;
-  /** Доступность за сутки в процентах. */
-  uptime: number;
-  /** Происшествия за сутки. */
-  lines: StatusIncidentLine[];
-}
-/** Сервис платформы и его история доступности. */
-interface ServiceStatus {
-  /** Идентификатор: `auth`, `main`, `media` и прочие. */
-  id: string;
-  /** Отображаемое название. */
-  name: string;
-  current_status: ServiceState;
-  /** Пояснение к текущему состоянию, например `No downtime`. */
-  current_message: string;
-  /** Задержка последней проверки в миллисекундах. */
-  latency_ms: number;
-  /**
-   * Момент последней проверки. Сервер отдаёт `YYYY-MM-DD HH:mm:ss` в UTC, библиотека
-   * приводит значение к ISO.
-   */
-  last_checked: IsoDate;
-  /** Доступность за 90 суток в процентах. */
-  uptime_90d: number;
-  /**
-   * История по суткам. Ключ — сколько суток назад, `'0'` — сегодня.
-   *
-   * Объект разреженный: сутки без данных сервер пропускает. Ровный массив даёт
-   * {@link statusDays}.
-   */
-  days: Record<string, StatusDay | undefined>;
-}
-/** Состояние платформы — ответ `itd.platform.status()`. */
-interface PlatformStatus {
-  /** Худшее состояние среди сервисов. */
-  overall_status: ServiceState;
-  /** Когда данные последний раз пересчитаны. */
-  updated_at: IsoDate;
-  services: ServiceStatus[];
-}
-/** Статус заявки на верификацию. `none` означает, что заявка не подавалась. */
-interface VerificationStatus {
-  status: Loose<'none' | 'pending' | 'approved' | 'rejected'>;
-}
-/** Созданная жалоба. */
-interface Report {
-  id: string;
-  createdAt: IsoDate;
-}
-/** Счётчики поста из `itd.posts.stats()`. */
-interface PostStats {
-  id: string;
-  likesCount: number;
-  commentsCount: number;
-  repostsCount: number;
-  viewsCount: number;
-  /** Преобладающая реакция — эмодзи либо `null`. */
-  dominantEmoji: string | null;
-}
-/** Результат реакции на пост. */
-interface LikeResult {
-  liked: boolean;
-  likesCount: number;
-}
-/** Результат закрепления поста в профиле. */
-interface PinPostResult {
-  success: boolean;
-  pinnedPostId: string | null;
-}
-/** Закреплённые значки профиля и выбранный из них. */
-interface PinsResult {
-  pins: Pin[];
-  /** Идентификатор активного значка — строка, а не объект. */
-  activePin: string | null;
-}
-/**
- * Разбирает дату API в объект `Date`.
- *
- * @returns `null`, если строки нет или она не разбирается
- *
- * @example
- * ```ts
- * const created = toDate(post.createdAt);
- * ```
- */
-declare function toDate(value: IsoDate | null | undefined): Date | null;
-/**
- * Разворачивает историю сервиса в массив на 90 суток.
- * Сутки без данных становятся `null`.
- *
- * @returns массив, где индекс — сколько суток назад: `[0]` — сегодня
- *
- * @example
- * ```ts
- * const status = await itd.platform.status();
- * const days = statusDays(status.services[0]);
- *
- * days[0]?.uptime;                              // доступность за сегодня
- * days.filter((day) => day === null).length;    // за сколько суток данных нет
- * ```
- */
-declare function statusDays(service: ServiceStatus): (StatusDay | null)[];
-//#endregion
-//#region src/core/runtime.d.ts
-/**
- * Как библиотека обращается с cookie.
- *
- * - `browser` — cookie ведёт браузер, запросы уходят с `credentials: 'include'`;
- * - `server` — cookie ведёт встроенный jar, заголовок `Cookie` подставляется вручную;
- * - `auto` — определяется по среде исполнения (значение по умолчанию).
- */
-declare const RuntimeMode: Readonly<{
-  /** Определяется по среде исполнения. Значение по умолчанию. */
-  readonly Auto: "auto";
-  /** Cookie ведёт браузер, запросы уходят с `credentials: 'include'`. */
-  readonly Browser: "browser";
-  /** Cookie ведёт встроенный jar, заголовок `Cookie` подставляется вручную. */
-  readonly Server: "server";
-}>;
-type RuntimeMode = (typeof RuntimeMode)[keyof typeof RuntimeMode];
-/** Распознанная среда исполнения. */
-declare const DetectedRuntime: Readonly<{
-  readonly Browser: "browser";
-  /** Есть `window`, но нет `document`; cookie ведёт нативный сетевой слой. */
-  readonly ReactNative: "react-native";
-  readonly Server: "server";
-}>;
-type DetectedRuntime = (typeof DetectedRuntime)[keyof typeof DetectedRuntime];
-//#endregion
-//#region src/core/services.d.ts
-/** Сервис платформы на отдельном домене. */
-interface ServiceDefinition {
-  /** Имя, по которому запрос выбирает сервис: `{ service: 'status' }`. */
-  name: string;
-  /** Базовый URL сервиса. */
-  baseUrl: string;
-  /** Заголовки, добавляемые к каждому запросу сервиса. Заголовки вызова важнее. */
-  headers?: Record<string, string> | undefined;
-  /**
-   * Слать ли заголовок авторизации.
-   *
-   * По умолчанию включено для основного хоста и его поддоменов. Для остальных хостов
-   * авторизацию нужно разрешить явно: `auth: true`.
-   */
-  auth?: boolean | undefined;
-}
-/**
- * Именованные сервисы клиента.
- *
- * @internal
- */
-declare class ServiceRegistry {
-  #private;
-  /** @param primaryBaseUrl базовый URL клиента */
-  constructor(primaryBaseUrl?: string);
-  /**
-   * Регистрирует сервис. Имя очищается от краевых пробелов, базовый URL приводится
-   * к каноничному виду, а незаданный `auth` выводится из хоста.
-   *
-   * @throws {ItdConfigError} если имя пустое, имя занято или `baseUrl` не абсолютный URL
-   */
-  define(definition: ServiceDefinition): void;
-  /** Определение сервиса либо `undefined`, если такого нет. */
-  get(name: string): ServiceDefinition | undefined;
-  /** Зарегистрирован ли сервис с таким именем. */
-  has(name: string): boolean;
-  /**
-   * Определение сервиса.
-   *
-   * @throws {ItdConfigError} если сервис не зарегистрирован
-   */
-  require(name: string): ServiceDefinition;
-  /**
-   * Базовый URL сервиса.
-   *
-   * @throws {ItdConfigError} если сервис не зарегистрирован
-   */
-  resolveBaseUrl(name: string): string;
-  /**
-   * Принадлежит ли URL основному хосту клиента или его поддомену.
-   *
-   * Используется для безопасного значения по умолчанию у разового `baseUrl`: Bearer-токен
-   * не должен уходить на посторонний хост без явного `skipAuth: false`.
-   *
-   * @internal
-   */
-  isPrimarySite(baseUrl: string): boolean;
-}
-//#endregion
-//#region src/core/url.d.ts
-/** Значение параметра запроса. `undefined` и `null` в строку не попадают. */
-type QueryValue = string | number | boolean | null | undefined | readonly (string | number | boolean)[];
-/** Параметры строки запроса. */
-type QueryParams = Record<string, QueryValue>;
-//#endregion
-//#region src/types/options.d.ts
-/**
- * Вход по логину и паролю.
- *
- * Вход требует токен капчи Cloudflare Turnstile, поэтому полностью автоматическим он быть
- * не может: капчу должен решить кто-то снаружи. Токен одноразовый и живёт несколько минут,
- * так что долгоживущему клиенту нужен `getTurnstileToken` — он спрашивается заново перед
- * каждой попыткой входа. Одиночный `turnstileToken` годится для разового скрипта.
- */
-interface CredentialsAuth {
-  email: string;
-  password: string;
-  /** Разовый токен капчи. Для повторного входа после истечения сессии не подойдёт. */
-  turnstileToken?: string | undefined;
-  /** Источник свежего токена капчи. Спрашивается перед каждым входом. */
-  getTurnstileToken?: (() => string | Promise<string>) | undefined;
-}
-/**
- * Как клиент получает доступ к API.
- *
- * Четыре формы — от разового вызова с готовым токеном до полноценной сессии, которую
- * библиотека заводит и продлевает сама.
- *
- * Опция необязательна: если {@link ItdClientOptions.storage} уже содержит сессию, доступ
- * берётся оттуда. Когда заданы обе, хранилище главнее — оно отражает текущее состояние
- * сессии, — а недостающие поля берутся отсюда.
- *
- * @example
- * ```ts
- * new ItdClient({ auth: '<accessToken>' });                    // разовый вызов
- * new ItdClient({ auth: { accessToken, refreshToken } });      // восстановить сессию
- * new ItdClient({ auth: { email, password, getTurnstileToken } });  // залогиниться самому
- * new ItdClient({ auth: { getToken: () => vault.read() } });   // токен из внешнего источника
+ * new ItdClient({ auth: '<accessToken>' });                    // разовый вызов
+ * new ItdClient({ auth: { accessToken, refreshToken } });      // восстановить сессию
+ * new ItdClient({ auth: { email, password, getTurnstileToken } });  // залогиниться самому
+ * new ItdClient({ auth: { getToken: () => vault.read() } });   // токен из внешнего источника
  * ```
  */
 type AuthInput = string | {
@@ -1227,6 +670,8 @@ interface ItdClientOptions {
   reloginOnRefreshFailure?: boolean | undefined;
   /** Своя реализация `fetch`: для Deno, React Native, тестов или прокси. */
   fetch?: typeof fetch | undefined;
+  /** Часы для тайм-аутов, повторов и очередей. Обычно подменяются только в тестах. */
+  clock?: ItdClock | undefined;
   /** Таймаут запроса в мс. По умолчанию 30000 — столько же использует сайт итд.com. `0` снимает ограничение. */
   timeout?: number | undefined;
   /** Повторные попытки. `false` отключает их полностью. */
@@ -1326,7 +771,7 @@ interface RawRequestOptions extends RequestOptions {
 //#endregion
 //#region src/core/version.d.ts
 /** Версия библиотеки. Попадает в `User-Agent`. */
-declare const LIBRARY_VERSION = "0.2.0";
+declare const LIBRARY_VERSION = "0.4.0";
 //#endregion
 //#region src/core/config.d.ts
 /** Базовый URL API итд.com. Домен записан в punycode: `итд.com`. */
@@ -1349,7 +794,7 @@ declare const DEFAULT_TIMEOUT = 30000;
  * В браузере заголовок не выставляется — `User-Agent` там запрещён к изменению, и среда
  * молча его игнорирует.
  */
-declare const DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; itd-api/0.2.0; +https://github.com/KiowDev/itd-api)";
+declare const DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; itd-api/0.4.0; +https://github.com/KiowDev/itd-api)";
 /** Настройки очереди со всеми значениями по умолчанию. */
 interface ResolvedRateLimitOptions {
   concurrency: number;
@@ -1366,6 +811,7 @@ interface ResolvedRateLimitOptions {
  */
 interface AuthConfig {
   baseUrl: string;
+  clock: ItdClock;
   auth: AuthInput | undefined;
   storage: TokenStorage;
   useCookieJar: boolean;
@@ -1672,242 +1118,427 @@ declare class AuthManager {
   /** Текущая сессия целиком. Полезно, чтобы сохранить её самому. */
   getSession(): Promise<ItdSession | null>;
   /**
-   * Идентификатор владельца сессии.
+   * Идентификатор владельца сессии.
+   *
+   * Считается непосредственно из текущего токена и отдельно не сохраняется: после замены
+   * токена идентификатор прежнего владельца остаться не может.
+   */
+  getUserId(): Promise<UserId | undefined>;
+  /** Заменяет сессию и связанные с ней cookie целиком. */
+  setSession(session: ItdSession): Promise<void>;
+  /**
+   * Забывает сессию и cookie. Сетевой запрос не выполняется.
+   *
+   * Идентификатор устройства выход переживает: иначе каждая пара «выход — вход» плодила бы
+   * новую запись в списке сессий.
+   */
+  clear(): Promise<void>;
+}
+//#endregion
+//#region src/core/plugins/contracts.d.ts
+/**
+ * Обёртка вокруг запроса.
+ *
+ * Получает описание запроса и продолжение цепочки. Может изменить запрос перед отправкой,
+ * посмотреть и подменить разобранный ответ или вовсе не вызывать `next` и вернуть своё.
+ *
+ * @param request что уходит на сервер; изменять сам объект не нужно — передайте копию в `next`
+ * @param next продолжение: либо следующая обёртка, либо настоящий запрос
+ * @returns тело ответа в том виде, в каком его получит вызывающий код
+ *
+ * @example Дописать заголовок ко всем запросам
+ * ```ts
+ * const transformer: Transformer = (request, next) =>
+ *   next({ ...request, headers: { ...request.headers, 'X-Trace': trace() } });
+ * ```
+ */
+type Transformer = (request: RawRequestOptions, next: (request: RawRequestOptions) => Promise<unknown>) => Promise<unknown>;
+/** Освобождение ресурсов, заведённых плагином при установке. */
+type PluginTeardown = () => void | Promise<void>;
+/** Что плагин получает при подключении. */
+interface PluginContext {
+  /** Базовый URL клиента — например чтобы разобрать абсолютные ссылки из ответа. */
+  baseUrl: string;
+  /** Отладочный вывод клиента, если он включён. */
+  logger: Logger | undefined;
+  /**
+   * Непрозрачная fallback-область текущей авторизации.
+   *
+   * Нужна плагинам, которые обязаны безопасно изолировать непрозрачный токен. Для объединения
+   * состояния копий одного аккаунта используйте {@link getAuthIdentity}.
+   */
+  getAuthScope?: (() => string) | undefined;
+  /**
+   * Загружает сессию и возвращает идентификаторы аккаунта и конкретной сессии из JWT.
+   *
+   * Предпочтительнее {@link getAuthScope} для состояния, которое должно объединяться между
+   * несколькими экземплярами клиента одного аккаунта.
+   */
+  getAuthIdentity?: (() => Promise<AuthIdentity>) | undefined;
+  /** Добавляет обёртку запроса. Подключённые раньше оказываются снаружи. */
+  use(transformer: Transformer): void;
+  /**
+   * Добавляет перехватчики отдельных сетевых попыток.
+   *
+   * В отличие от {@link use}, они видят каждый retry и сырой `Response` до чтения тела.
+   * Несколько наборов хуков одного плагина вызываются в порядке регистрации.
+   */
+  useHooks(hooks: ClientHooks): void;
+}
+/**
+ * Плагин клиента.
+ *
+ * Подключается через `itd.use(plugin)` и работает на уровне транспорта: видит запрос
+ * до отправки и разобранный ответ. Библиотека не знает, что именно делает плагин, —
+ * ей достаточно списка обёрток и имён опций, которые он читает.
+ *
+ * @example
+ * ```ts
+ * const logging: ItdPlugin = {
+ *   name: 'logging',
+ *   install({ use, logger }) {
+ *     use(async (request, next) => {
+ *       logger?.info(`${request.method} ${request.path}`);
+ *       return next(request);
+ *     });
+ *   },
+ * };
+ *
+ * itd.use(logging);
+ * ```
+ */
+interface ItdPlugin {
+  /** Имя плагина. Должно быть уникальным: повторное подключение — ошибка. */
+  name: string;
+  /**
+   * Имена опций запроса, которые плагин читает у методов ресурсов.
    *
-   * Считается непосредственно из текущего токена и отдельно не сохраняется: после замены
-   * токена идентификатор прежнего владельца остаться не может.
+   * Библиотека этих опций не понимает и ничего с ними не делает — только доносит
+   * от вызова метода до обёртки нетронутыми. Без такого списка чужие поля отсеиваются,
+   * чтобы случайная опечатка в параметрах не уезжала на сервер.
+   *
+   * Имена полей самого запроса (`path`, `body`, `headers`, `signal` и прочие из
+   * `RawRequestOptions`) заявить нельзя: подключение такого плагина завершится ошибкой.
+   *
+   * Типы для них плагин объявляет сам, дополняя `RequestOptions`:
+   * ```ts
+   * declare module 'itd-api' {
+   *   interface RequestOptions { encrypt?: string | undefined }
+   * }
+   * ```
    */
-  getUserId(): Promise<UserId | undefined>;
-  /** Заменяет сессию и связанные с ней cookie целиком. */
-  setSession(session: ItdSession): Promise<void>;
+  optionKeys?: readonly string[];
+  /** Плагины, которые обязаны быть подключены раньше этого. */
+  requires?: readonly string[];
+  /** Несовместимые плагины. Достаточно объявить конфликт с одной стороны. */
+  conflicts?: readonly string[];
+  /** Имена плагинов, снаружи которых должна стоять эта обёртка. */
+  before?: readonly string[];
+  /** Имена плагинов, внутри которых должна стоять эта обёртка. */
+  after?: readonly string[];
   /**
-   * Забывает сессию и cookie. Сетевой запрос не выполняется.
+   * Устанавливает плагин.
    *
-   * Идентификатор устройства выход переживает: иначе каждая пара «выход — вход» плодила бы
-   * новую запись в списке сессий.
+   * Может вернуть функцию освобождения ресурсов. Она вызывается при `unuse()` или
+   * окончательном `dispose()` клиента и может быть асинхронной.
    */
-  clear(): Promise<void>;
+  install(context: PluginContext): unknown;
 }
 //#endregion
-//#region src/core/plugins.d.ts
+//#region src/core/rate-limit.d.ts
 /**
- * Обёртка вокруг запроса.
+ * Очередь запросов: ограничивает одновременность и частоту.
  *
- * Получает описание запроса и продолжение цепочки. Может изменить запрос перед отправкой,
- * посмотреть и подменить разобранный ответ или вовсе не вызывать `next` и вернуть своё.
+ * Нужна прежде всего ботам: без неё цикл по сотне постов уходит в API одним залпом
+ * и упирается в `RATE_LIMIT_EXCEEDED`.
  *
- * @param request что уходит на сервер; изменять сам объект не нужно — передайте копию в `next`
- * @param next продолжение: либо следующая обёртка, либо настоящий запрос
- * @returns тело ответа в том виде, в каком его получит вызывающий код
+ * Частота выдерживается равномерным разносом стартов (`1000 / rps` между запросами),
+ * а не окном со счётчиком: так нагрузка ровная, без всплеска в начале каждой секунды.
  *
- * @example Дописать заголовок ко всем запросам
- * ```ts
- * const transformer: Transformer = (request, next) =>
- *   next({ ...request, headers: { ...request.headers, 'X-Trace': trace() } });
- * ```
+ * @internal
  */
-type Transformer = (request: RawRequestOptions, next: (request: RawRequestOptions) => Promise<unknown>) => Promise<unknown>;
-/** Освобождение ресурсов, заведённых плагином при установке. */
-type PluginTeardown = () => void | Promise<void>;
-/** Что плагин получает при подключении. */
-interface PluginContext {
-  /** Базовый URL клиента — например чтобы разобрать абсолютные ссылки из ответа. */
-  baseUrl: string;
-  /** Отладочный вывод клиента, если он включён. */
-  logger: Logger | undefined;
+declare class RequestQueue {
+  #private;
+  constructor(options: ResolvedRateLimitOptions, clock?: ItdClock);
+  /** Сколько задач выполняется прямо сейчас. */
+  get active(): number;
+  /** Сколько задач ждёт очереди. */
+  get pending(): number;
   /**
-   * Непрозрачная fallback-область текущей авторизации.
+   * Ставит задачу в очередь.
    *
-   * Нужна плагинам, которые обязаны безопасно изолировать непрозрачный токен. Для объединения
-   * состояния копий одного аккаунта используйте {@link getAuthIdentity}.
+   * @returns результат задачи; ошибка задачи пробрасывается без изменений
    */
-  getAuthScope?: (() => string) | undefined;
+  schedule<T>(task: () => Promise<T>, signal?: AbortSignal): Promise<T>;
   /**
-   * Загружает сессию и возвращает идентификаторы аккаунта и конкретной сессии из JWT.
+   * Останавливает очередь: снимает отложенную паузу и отклоняет ещё не начатые задачи
+   * ошибкой `ItdAbortError`. Уже выполняющиеся задачи доводятся до конца.
+   */
+  stop(): void;
+  /**
+   * Придерживает всю очередь на заданное время.
    *
-   * Предпочтительнее {@link getAuthScope} для состояния, которое должно объединяться между
-   * несколькими экземплярами клиента одного аккаунта.
+   * Вызывается при получении `429` с заголовком `Retry-After`: тормозить нужно все запросы,
+   * а не только тот, который наткнулся на лимит, — иначе остальные продолжат добивать API.
    */
-  getAuthIdentity?: (() => Promise<AuthIdentity>) | undefined;
-  /** Добавляет обёртку запроса. Подключённые раньше оказываются снаружи. */
-  use(transformer: Transformer): void;
+  pause(ms: number): void;
+}
+/**
+ * Очереди по хостам: основная и по одной на каждый сервис платформы.
+ *
+ * @internal
+ */
+declare class RequestQueuePool {
+  #private;
+  constructor(options: ResolvedRateLimitOptions, clock?: ItdClock);
+  /** Очередь хоста. */
+  for(service: string | undefined): RequestQueue;
+  /** Останавливает все очереди. */
+  stop(): void;
+}
+//#endregion
+//#region src/models/users.d.ts
+/** Значок-«пин» в профиле — награда или отметка платформы. */
+interface Pin {
+  /** Постоянный идентификатор, например `epepuy_202605_59`. */
+  slug: string;
+  /** Отображаемое название. */
+  name: string;
+  /** Описание, за что выдан. */
+  description: string;
+  /** Адрес изображения. */
+  url: string;
+  /** Когда выдан. Приходит только в списке своих пинов. */
+  grantedAt?: IsoDate;
+}
+/**
+ * Автор поста или комментария.
+ *
+ * Встречается внутри `post.author` и `comment.author`.
+ */
+interface Author {
+  id: UserId;
+  username: string;
+  displayName: string;
   /**
-   * Добавляет перехватчики отдельных сетевых попыток.
+   * **Эмодзи, а не картинка.**
    *
-   * В отличие от {@link use}, они видят каждый retry и сырой `Response` до чтения тела.
-   * Несколько наборов хуков одного плагина вызываются в порядке регистрации.
+   * На итд.com аватар — это символ клана (`🩵`, `🦎`), а не адрес изображения.
+   * Отрисовывать его нужно как текст.
    */
-  useHooks(hooks: ClientHooks): void;
+  avatar: string;
+  /** Пройдена ли верификация. */
+  verified: boolean;
+  /** Активный значок профиля. Может отсутствовать. */
+  pin?: Pin | null;
+  /** Есть ли премиум-подписка (значок NUKSTA). */
+  hasNuksta?: boolean;
+}
+/**
+ * Участник события в уведомлении.
+ *
+ * Отличается от {@link Author} набором полей: вместо значков приходит связь с вами.
+ */
+interface Actor {
+  id: UserId;
+  username: string;
+  displayName: string;
+  /** Эмодзи-аватар, см. {@link Author.avatar}. */
+  avatar: string;
+  /** Подписаны ли вы на этого пользователя. */
+  isFollowing?: boolean;
+  /** Подписан ли он на вас. */
+  isFollowedBy?: boolean;
+}
+/**
+ * Пользователь в списках.
+ *
+ * Набор полей зависит от эндпоинта: подписчики и подписки приносят `isFollowing`,
+ * поиск и рекомендации — `followersCount` и `hasNuksta`. Необязательные поля отражают
+ * это различие.
+ */
+interface UserSummary {
+  id: UserId;
+  username: string;
+  displayName: string;
+  /** Эмодзи-аватар, см. {@link Author.avatar}. */
+  avatar: string;
+  verified: boolean;
+  /** Подписаны ли вы. Приходит в списках подписчиков и подписок. */
+  isFollowing?: boolean;
+  /** Есть ли премиум. Приходит в поиске и рекомендациях. */
+  hasNuksta?: boolean;
+  /** Число подписчиков. Приходит в поиске и рекомендациях. */
+  followersCount?: number;
+}
+/** Поля профиля, общие для своего и чужого. */
+interface ProfileBase {
+  id: UserId;
+  username: string;
+  displayName: string;
+  /** Эмодзи-аватар, см. {@link Author.avatar}. */
+  avatar: string;
+  /** URL изображения баннера либо `null`. */
+  banner: string | null;
+  /** Описание профиля. */
+  bio: string;
+  verified: boolean;
+  pin?: Pin | null;
+  /** Кто может писать на стену. */
+  wallAccess: WallAccess;
+  /** Кто видит реакции. */
+  likesVisibility: LikesVisibility;
+  followersCount: number;
+  followingCount: number;
+  postsCount: number;
+  createdAt: IsoDate;
+}
+/** Состояние подписки на премиум. */
+interface SubscriptionState {
+  isActive: boolean;
+  expiresAt: IsoDate | null;
+  autoRenewal: boolean;
+}
+/**
+ * Свой профиль — ответ `GET /api/users/me`.
+ *
+ * Отличается от чужого наличием {@link subscription} и {@link isPhoneVerified}
+ * и отсутствием полей связи (`isFollowing`, `online`).
+ */
+interface MyProfile extends ProfileBase {
+  /** Закрыт ли профиль. */
+  isPrivate: boolean;
+  /** Подтверждён ли телефон. Без него часть действий недоступна. */
+  isPhoneVerified: boolean;
+  /** Своя премиум-подписка. */
+  subscription: SubscriptionState;
+}
+/**
+ * Состояние авторизации — ответ `GET /api/profile`.
+ *
+ * Endpoint доступен без сессии: в этом случае `authenticated` равен `false`,
+ * а `user` — `null`.
+ */
+interface AuthState {
+  /** Есть ли действующая сессия. */
+  authenticated: boolean;
+  /** Заблокирован ли текущий аккаунт. */
+  banned: boolean;
+  /** Текущий пользователь либо `null` без действующей сессии. */
+  user: MyProfile | null;
+}
+/**
+ * Чужой профиль — ответ `GET /api/users/{id|username}`.
+ *
+ * Вместо своей подписки содержит связь с вами и присутствие.
+ */
+interface PublicProfile extends ProfileBase {
+  hasNuksta?: boolean;
+  /** Закреплённый пост, если он есть. */
+  pinnedPostId: string | null;
+  /** Подписаны ли вы на него. */
+  isFollowing: boolean;
+  /** Подписан ли он на вас. */
+  isFollowedBy: boolean;
+  /** Сейчас ли пользователь в сети. */
+  online: boolean;
+  /** Когда был в сети. `null`, если скрыто настройками приватности. */
+  lastSeen: IsoDate | null;
+}
+/** Профиль: свой либо чужой. Различаются функцией `isMyProfile()`. */
+type Profile = MyProfile | PublicProfile;
+/** Настройки приватности профиля. */
+interface PrivacySettings {
+  /** Закрыт ли профиль: подписка требует одобрения. */
+  isPrivate: boolean;
+  wallAccess: WallAccess;
+  likesVisibility: LikesVisibility;
+  /** Показывать ли время последнего посещения. */
+  showLastSeen: boolean;
 }
 /**
- * Плагин клиента.
- *
- * Подключается через `itd.use(plugin)` и работает на уровне транспорта: видит запрос
- * до отправки и разобранный ответ. Библиотека не знает, что именно делает плагин, —
- * ей достаточно списка обёрток и имён опций, которые он читает.
+ * Результат подписки на пользователя.
  *
  * @example
  * ```ts
- * const logging: ItdPlugin = {
- *   name: 'logging',
- *   install({ use, logger }) {
- *     use(async (request, next) => {
- *       logger?.info(`${request.method} ${request.path}`);
- *       return next(request);
- *     });
- *   },
- * };
- *
- * itd.use(logging);
+ * const result = await itd.users.follow('nowkie');
+ * // { following: true, followersCount: 11 }
  * ```
  */
-interface ItdPlugin {
-  /** Имя плагина. Должно быть уникальным: повторное подключение — ошибка. */
-  name: string;
-  /**
-   * Имена опций запроса, которые плагин читает у методов ресурсов.
-   *
-   * Библиотека этих опций не понимает и ничего с ними не делает — только доносит
-   * от вызова метода до обёртки нетронутыми. Без такого списка чужие поля отсеиваются,
-   * чтобы случайная опечатка в параметрах не уезжала на сервер.
-   *
-   * Имена полей самого запроса (`path`, `body`, `headers`, `signal` и прочие из
-   * `RawRequestOptions`) заявить нельзя: подключение такого плагина завершится ошибкой.
-   *
-   * Типы для них плагин объявляет сам, дополняя `RequestOptions`:
-   * ```ts
-   * declare module 'itd-api' {
-   *   interface RequestOptions { encrypt?: string | undefined }
-   * }
-   * ```
-   */
-  optionKeys?: readonly string[];
-  /** Плагины, которые обязаны быть подключены раньше этого. */
-  requires?: readonly string[];
-  /** Несовместимые плагины. Достаточно объявить конфликт с одной стороны. */
-  conflicts?: readonly string[];
-  /** Имена плагинов, снаружи которых должна стоять эта обёртка. */
-  before?: readonly string[];
-  /** Имена плагинов, внутри которых должна стоять эта обёртка. */
-  after?: readonly string[];
-  /**
-   * Устанавливает плагин.
-   *
-   * Может вернуть функцию освобождения ресурсов. Она вызывается при `unuse()` или
-   * окончательном `dispose()` клиента и может быть асинхронной.
-   */
-  install(context: PluginContext): unknown;
+interface FollowResult {
+  /** Подписка оформлена. У закрытого профиля отправляется заявка, и здесь будет `false`. */
+  following: boolean;
+  /** Сколько подписчиков стало у пользователя после действия. */
+  followersCount?: number;
+  /** Статус заявки, если профиль закрыт. */
+  status?: Loose<'following' | 'requested'>;
 }
-/**
- * Список подключённых плагинов и собранная из них цепочка обёрток.
- *
- * Живёт в клиенте, а работает в транспорте: {@link HttpClient} прогоняет через `run`
- * каждый запрос, если плагины есть.
- */
-declare class PluginRegistry {
-  #private;
-  /** Сколько плагинов подключено. */
-  get size(): number;
-  /** Имена опций активных плагинов. */
-  get optionKeys(): ReadonlySet<string>;
-  /** Имена плагинов в фактическом порядке выполнения. */
-  names(): string[];
-  /** Подключён ли плагин с таким именем. */
-  has(name: string): boolean;
-  /** Проверяет добавление без вызова `install()`. @internal */
-  assertCanAdd(plugin: ItdPlugin): void;
-  /** Проверяет удаление без изменения реестра. @internal */
-  assertCanRemove(name: string): void;
-  /**
-   * Подключает плагин.
-   *
-   * @throws {ItdConfigError} если плагин задан неверно, уже подключён, нарушает зависимости
-   * или заявил занятое имя опции
-   */
-  add(plugin: ItdPlugin, context: Omit<PluginContext, 'use' | 'useHooks'>): void;
-  /**
-   * Отключает плагин и вызывает его функцию очистки.
-   *
-   * Новые запросы перестают видеть плагин сразу. Если его обёртка уже выполняется,
-   * очистка дождётся завершения этого логического запроса.
-   *
-   * @returns `false`, если такого плагина не было
-   */
-  remove(name: string): Promise<boolean>;
-  /**
-   * Отключает все плагины окончательно.
-   *
-   * Очистка идёт изнутри наружу — в порядке, обратном выполнению обёрток.
-   */
-  dispose(): Promise<void>;
-  /**
-   * Объединяет конструкторские хуки с хуками подключаемых плагинов.
-   *
-   * Возвращённый объект динамический: подключение и отключение плагина начинает действовать
-   * со следующего логического запроса без пересоздания транспорта.
-   */
-  hooks(base: ClientHooks): ClientHooks;
-  /**
-   * Прогоняет запрос через цепочку обёрток.
-   *
-   * Снимок цепочки берётся в начале: `unuse()` влияет на новые запросы, но не обрывает
-   * уже выполняющийся посередине.
-   *
-   * @param execute настоящий запрос, вызывается самой внутренней обёрткой
-   */
-  run(request: RawRequestOptions, execute: (request: RawRequestOptions) => Promise<unknown>): Promise<unknown>;
+/** Закреплённые значки профиля и выбранный из них. */
+interface PinsResult {
+  pins: Pin[];
+  /** Идентификатор активного значка — строка, а не объект. */
+  activePin: string | null;
 }
 //#endregion
-//#region src/core/rate-limit.d.ts
+//#region src/models/notifications.d.ts
 /**
- * Очередь запросов: ограничивает одновременность и частоту.
- *
- * Нужна прежде всего ботам: без неё цикл по сотне постов уходит в API одним залпом
- * и упирается в `RATE_LIMIT_EXCEEDED`.
+ * Уведомление в единой форме.
  *
- * Частота выдерживается равномерным разносом стартов (`1000 / rps` между запросами),
- * а не окном со счётчиком: так нагрузка ровная, без всплеска в начале каждой секунды.
+ * REST-список и SSE-поток отдают уведомления по-разному — разные имена типов, разные имена
+ * полей, один участник против массива. Библиотека приводит оба вида к этой структуре,
+ * поэтому объекты из `itd.notifications.list()` и из потока можно складывать в один список.
  *
- * @internal
+ * Исходные данные не теряются: серверное имя типа остаётся в {@link rawType},
+ * а весь необработанный объект — в {@link raw}.
  */
-declare class RequestQueue {
-  #private;
-  constructor(options: ResolvedRateLimitOptions);
-  /** Сколько задач выполняется прямо сейчас. */
-  get active(): number;
-  /** Сколько задач ждёт очереди. */
-  get pending(): number;
-  /**
-   * Ставит задачу в очередь.
-   *
-   * @returns результат задачи; ошибка задачи пробрасывается без изменений
-   */
-  schedule<T>(task: () => Promise<T>, signal?: AbortSignal): Promise<T>;
-  /**
-   * Останавливает очередь: снимает отложенную паузу и отклоняет ещё не начатые задачи
-   * ошибкой `ItdAbortError`. Уже выполняющиеся задачи доводятся до конца.
-   */
-  stop(): void;
-  /**
-   * Придерживает всю очередь на заданное время.
-   *
-   * Вызывается при получении `429` с заголовком `Retry-After`: тормозить нужно все запросы,
-   * а не только тот, который наткнулся на лимит, — иначе остальные продолжат добивать API.
-   */
-  pause(ms: number): void;
+interface Notification {
+  id: string;
+  /** Канонический тип. Старые имена (`like`, `comment`) приведены к новым. */
+  type: NotificationType;
+  /** Имя типа в том виде, в каком его прислал сервер. */
+  rawType: string;
+  /** Объект события: пост, комментарий, пользователь. */
+  entityId: string | null;
+  /** Пост, которому принадлежит комментарий, если событие о комментарии. */
+  parentEntityId: string | null;
+  /** Прочитано ли уведомление. */
+  isRead: boolean;
+  /** Кто совершил действие. Для схлопнутых уведомлений — несколько человек. */
+  actors: Actor[];
+  /** Сколько участников схлопнуто в одно уведомление. Минимум 1. */
+  count: number;
+  /** Текст или заголовок объекта события. */
+  preview: string | null;
+  /** Ссылка перехода, предложенная сервером. Обычно точнее её `resolveNotificationUrl()`. */
+  clickUrl?: string;
+  createdAt: IsoDate;
+  /** Когда уведомление изменилось — например было прочитано. */
+  updatedAt: IsoDate;
+  /** Исходный объект как он пришёл от сервера. */
+  raw: unknown;
 }
 /**
- * Очереди по хостам: основная и по одной на каждый сервис платформы.
+ * Настройки уведомлений.
  *
- * @internal
+ * Сервер отдаёт плоский объект, но исторически знает два набора имён для одних и тех же
+ * настроек (`likes` и `reactions`, `comments` и `replies`). При сохранении библиотека
+ * отправляет оба, при чтении принимает любой.
  */
-declare class RequestQueuePool {
-  #private;
-  constructor(options: ResolvedRateLimitOptions);
-  /** Очередь хоста. */
-  for(service: string | undefined): RequestQueue;
-  /** Останавливает все очереди. */
-  stop(): void;
+interface NotificationSettings {
+  /** Общий выключатель доставки. */
+  enabled: boolean;
+  /** Звук уведомления. */
+  sound: boolean;
+  /** Новые подписчики. */
+  follows: boolean;
+  /** Записи на вашей стене. */
+  wallPosts: boolean;
+  /** Реакции на ваши записи. */
+  likes: boolean;
+  /** Комментарии и ответы. */
+  comments: boolean;
+  /** Упоминания. */
+  mentions: boolean;
 }
 //#endregion
 //#region src/notifications/normalize.d.ts
@@ -1952,39 +1583,13 @@ declare function normalizeNotification(input: unknown): Notification;
  * Кроме самого уведомления событие несёт служебные поля уровня конверта: актуальный
  * счётчик непрочитанных и признак звука.
  */
-declare function readNotificationEvent(data: unknown): NotificationEvent;
-/**
- * Разбирает событие `unread_count` из потока.
- *
- * Возвращает `undefined`, если сервер прислал событие без вложенного `payload`.
- */
-declare function readUnreadCountEvent(data: unknown): number | undefined;
-//#endregion
-//#region src/realtime/reconnect.d.ts
-/**
- * Паузы перед попытками переподключения, мс.
- *
- * Значения совпадают с теми, что использует сайт итд.com, — поведение библиотеки
- * не отличается от привычного пользователю.
- */
-declare const RECONNECT_BACKOFF: readonly number[];
-/** Доля случайного разброса паузы. */
-declare const RECONNECT_JITTER = 0.3;
-/**
- * Сколько раз пытаться переподключиться подряд.
- *
- * После исчерпания поток сообщает `giveup` и ждёт ручного `connect()`.
- */
-declare const MAX_RECONNECT_ATTEMPTS = 15;
-/** Настройки переподключения. */
-interface ReconnectOptions {
-  /** Таблица пауз. Последнее значение действует для всех дальнейших попыток. */
-  backoff?: readonly number[];
-  /** Доля разброса, 0…1. */
-  jitter?: number;
-  /** Предел числа попыток. */
-  maxAttempts?: number;
-}
+declare function readNotificationEvent(data: unknown): NotificationEvent;
+/**
+ * Разбирает событие `unread_count` из потока.
+ *
+ * Возвращает `undefined`, если сервер прислал событие без вложенного `payload`.
+ */
+declare function readUnreadCountEvent(data: unknown): number | undefined;
 //#endregion
 //#region src/realtime/transport.d.ts
 /** Событие, пришедшее по каналу реального времени. */
@@ -2041,6 +1646,120 @@ declare class UnauthorizedStreamError extends Error {
   constructor();
 }
 //#endregion
+//#region src/realtime/updates.d.ts
+/** Типы нормализованных обновлений потока. */
+declare const RealtimeUpdateType: Readonly<{
+  readonly Notification: "notification";
+  readonly UnreadCount: "unreadCount";
+  readonly Unknown: "unknown";
+}>;
+/** Источники нормализованных обновлений потока. */
+declare const RealtimeUpdateOrigin: Readonly<{
+  readonly Stream: "stream";
+  readonly Sync: "sync";
+}>;
+type RealtimeUpdateOrigin = (typeof RealtimeUpdateOrigin)[keyof typeof RealtimeUpdateOrigin];
+/** Уведомление с типом, суженным фильтром потока. */
+type NotificationOfType<T extends NotificationType> = Omit<Notification, 'type'> & {
+  type: T;
+};
+/** Конверт уведомления с типом, суженным фильтром потока. */
+type NotificationEventOfType<T extends NotificationType> = Omit<NotificationEvent, 'notification'> & {
+  notification: NotificationOfType<T>;
+};
+/** Нормализованное уведомление из потока. */
+interface RealtimeNotificationUpdate<T extends NotificationType = NotificationType> {
+  readonly type: typeof RealtimeUpdateType.Notification;
+  readonly data: NotificationEventOfType<T>;
+}
+/** Актуальное число непрочитанных уведомлений. */
+interface RealtimeUnreadCountUpdate {
+  readonly type: typeof RealtimeUpdateType.UnreadCount;
+  readonly data: number;
+}
+/** Неизвестное библиотеке событие потока. */
+interface RealtimeUnknownUpdate {
+  readonly type: typeof RealtimeUpdateType.Unknown;
+  readonly name: string;
+  readonly data: unknown;
+}
+/** Данные, проходящие через промежуточные обработчики потока. */
+type RealtimeUpdate = RealtimeNotificationUpdate | RealtimeUnreadCountUpdate | RealtimeUnknownUpdate;
+/** Тип нормализованного обновления потока. */
+type RealtimeUpdateType = RealtimeUpdate['type'];
+/** Обновление потока указанного типа. */
+type RealtimeUpdateOfType<T extends RealtimeUpdateType> = Extract<RealtimeUpdate, {
+  type: T;
+}>;
+/** Контекст обработки одного обновления потока. */
+interface RealtimeContext<U extends RealtimeUpdate = RealtimeUpdate> {
+  /** Нормализованные данные обновления. */
+  readonly update: U;
+  /** Поток, который получил обновление. */
+  readonly stream: ItdRealtime;
+  /** Исходный кадр транспорта. Для начальной REST-синхронизации равен `undefined`. */
+  readonly raw: TransportEvent | undefined;
+  /** Откуда получены данные. */
+  readonly origin: RealtimeUpdateOrigin;
+}
+/** Контекст уведомления с типом, суженным фильтром. */
+type RealtimeNotificationContext<T extends NotificationType = NotificationType> = RealtimeContext<RealtimeNotificationUpdate<T>>;
+/** Условия отбора уведомлений. Все указанные поля объединяются через логическое И. */
+interface RealtimeNotificationFilter<T extends NotificationType = NotificationType> {
+  /** Один или несколько канонических типов уведомления. */
+  type?: T | readonly T[];
+  /** Идентификатор хотя бы одного участника уведомления. */
+  actorId?: string;
+  /** Идентификатор объекта события. */
+  entityId?: string | null;
+  /** Идентификатор родительского объекта. */
+  parentEntityId?: string | null;
+  /** Дополнительная проверка после сопоставления полей. */
+  predicate?: (context: RealtimeNotificationContext<T>) => boolean;
+}
+/** Краткая или объектная форма фильтра уведомлений. */
+type RealtimeNotificationSelector<T extends NotificationType = NotificationType> = T | readonly T[] | RealtimeNotificationFilter<T>;
+//#endregion
+//#region src/realtime/middleware.d.ts
+/** Продолжает цепочку промежуточных обработчиков потока. */
+type RealtimeNext = () => Promise<void>;
+/** Обрабатывает обновление потока до его передачи подписчикам. */
+type RealtimeMiddleware<C extends RealtimeContext = RealtimeContext> = (context: C, next: RealtimeNext) => void | Promise<void>;
+/** Асинхронный обработчик нормализованного обновления потока. */
+type RealtimeHandler<C extends RealtimeContext = RealtimeContext> = (context: C) => unknown | Promise<unknown>;
+/** Условие отбора контекста потока. */
+type RealtimePredicate = (context: RealtimeContext) => boolean;
+/** Проверка, сужающая тип контекста потока. */
+type RealtimeTypeGuard<C extends RealtimeContext> = (context: RealtimeContext) => context is C;
+/** Ключи, по которым обновления нельзя обрабатывать одновременно. */
+type RealtimeSequentializer = (context: RealtimeContext) => PropertyKey | readonly PropertyKey[] | undefined;
+//#endregion
+//#region src/realtime/reconnect.d.ts
+/**
+ * Паузы перед попытками переподключения, мс.
+ *
+ * Значения совпадают с теми, что использует сайт итд.com, — поведение библиотеки
+ * не отличается от привычного пользователю.
+ */
+declare const RECONNECT_BACKOFF: readonly number[];
+/** Доля случайного разброса паузы. */
+declare const RECONNECT_JITTER = 0.3;
+/**
+ * Сколько раз пытаться переподключиться подряд.
+ *
+ * После исчерпания поток сообщает `giveup` и ждёт ручного `connect()`.
+ */
+declare const MAX_RECONNECT_ATTEMPTS = 15;
+/** Настройки переподключения. */
+interface ReconnectOptions {
+  /** Таблица пауз. Последнее значение действует для всех дальнейших попыток. */
+  backoff?: readonly number[];
+  /** Доля разброса, 0…1. */
+  jitter?: number;
+  /** Предел числа попыток. */
+  maxAttempts?: number;
+}
+//#endregion
 //#region src/realtime/stream.d.ts
 /** События потока уведомлений. */
 interface RealtimeEvents {
@@ -2081,10 +1800,17 @@ interface RealtimeEvents {
   };
   /** Попытки исчерпаны — соединение восстановится только ручным `connect()`. */
   giveup: undefined;
-  /** Любое событие потока в необработанном виде, включая неизвестные библиотеке. */
-  message: {
-    name: string;
-    data: unknown;
+  /** Любой исходный кадр транспорта. Отправляется до нормализации и промежуточных обработчиков. */
+  message: TransportEvent;
+  /** Промежуточный обработчик потока завершился исключением. */
+  middlewareError: {
+    error: unknown;
+    context: RealtimeContext;
+  };
+  /** Обработчик `onUpdate` завершился исключением. */
+  handlerError: {
+    error: unknown;
+    context: RealtimeContext;
   };
 }
 /** Способ получения событий. */
@@ -2138,11 +1864,16 @@ interface RealtimeOptions extends ReconnectOptions {
   reconnectOnVisible?: boolean;
   /** Переподключаться при восстановлении сети. По умолчанию `true`. Только в браузере. */
   reconnectOnOnline?: boolean;
+  /** Максимальное число одновременно обрабатываемых обновлений. По умолчанию 1. */
+  concurrency?: number;
+  /** Возвращает ключи обновлений, которые нельзя обрабатывать одновременно. */
+  sequentialize?: RealtimeSequentializer;
 }
 /** Что поток получает от клиента. */
 interface RealtimeDeps {
   baseUrl: string;
   fetch: typeof fetch;
+  clock?: ItdClock;
   /** Общие заголовки клиента для адреса — см. {@link TransportContext.baseHeaders}. */
   baseHeaders: (url: string) => Promise<Headers>;
   /** Идентификаторы аккаунта и сессии создавшего поток клиента. */
@@ -2156,6 +1887,8 @@ interface RealtimeDeps {
   fetchUnreadCount: () => Promise<number>;
   /** Вызывается при явном закрытии потока. */
   onClose?: (() => void) | undefined;
+  /** Вызывается при запуске ранее закрытого потока. */
+  onConnect?: (() => void) | undefined;
   logger?: Logger | undefined;
 }
 /**
@@ -2166,16 +1899,19 @@ interface RealtimeDeps {
  *
  * @example
  * ```ts
+ * import { NotificationType } from 'itd-api';
+ *
  * const stream = itd.realtime();
  *
- * stream.on('notification', ({ notification, unreadCount }) => {
- *   console.log(formatNotificationText(notification), unreadCount);
+ * stream.onNotification(NotificationType.PostComment, async ({ update }) => {
+ *   await saveCommentNotification(update.data.notification);
  * });
  * stream.on('status', (status) => console.log('соединение:', status));
  *
  * await stream.connect();
  * // …позже
  * stream.disconnect();
+ * await stream.drain();
  * ```
  */
 declare class ItdRealtime {
@@ -2195,6 +1931,29 @@ declare class ItdRealtime {
   on<K extends keyof RealtimeEvents>(event: K, listener: Listener<RealtimeEvents[K]>): Unsubscribe;
   /** Подписывается на одно срабатывание. */
   once<K extends keyof RealtimeEvents>(event: K, listener: Listener<RealtimeEvents[K]>): Unsubscribe;
+  /**
+   * Добавляет промежуточный обработчик нормализованных обновлений.
+   *
+   * Обработчики выполняются в порядке регистрации. Если `next()` не вызван, обновление не
+   * передаётся дальше по цепочке, асинхронным обработчикам и слушателям событий.
+   *
+   * @returns функция удаления обработчика
+   */
+  use(middleware: RealtimeMiddleware): Unsubscribe;
+  /** Подписывает асинхронный обработчик на все нормализованные обновления. */
+  onUpdate(handler: RealtimeHandler): Unsubscribe;
+  /** Подписывает асинхронный обработчик на обновление указанного типа. */
+  onUpdate<T extends RealtimeUpdateType>(type: T, handler: RealtimeHandler<RealtimeContext<RealtimeUpdateOfType<T>>>): Unsubscribe;
+  /** Подписывает асинхронный обработчик по функции сужения типа. */
+  onUpdate<C extends RealtimeContext>(guard: RealtimeTypeGuard<C>, handler: RealtimeHandler<C>): Unsubscribe;
+  /** Подписывает асинхронный обработчик по пользовательскому условию. */
+  onUpdate(predicate: RealtimePredicate, handler: RealtimeHandler): Unsubscribe;
+  /** Подписывает асинхронный обработчик на уведомления, подходящие под фильтр. */
+  onNotification<T extends NotificationType>(selector: RealtimeNotificationSelector<T>, handler: RealtimeHandler<RealtimeNotificationContext<T>>): Unsubscribe;
+  /** Подписывает асинхронный обработчик по функции сужения типа уведомления. */
+  onNotification<C extends RealtimeNotificationContext>(guard: (context: RealtimeNotificationContext) => context is C, handler: RealtimeHandler<C>): Unsubscribe;
+  /** Подписывает асинхронный обработчик по пользовательскому условию. */
+  onNotification(predicate: (context: RealtimeNotificationContext) => boolean, handler: RealtimeHandler<RealtimeNotificationContext>): Unsubscribe;
   /**
    * Поднимает соединение.
    *
@@ -2206,10 +1965,73 @@ declare class ItdRealtime {
   connect(): Promise<void>;
   /** Закрывает соединение и отменяет запланированные попытки. */
   disconnect(): void;
-  /** Снимает все подписки. Соединение при этом не закрывается. */
+  /** Ждёт завершения всех принятых обновлений. */
+  drain(): Promise<void>;
+  /** Снимает подписки `on()` и `once()`. Остальные обработчики остаются. */
   removeAllListeners(): void;
 }
 //#endregion
+//#region src/core/plugins/registry.d.ts
+/**
+ * Список подключённых плагинов и собранная из них цепочка обёрток.
+ *
+ * Живёт в клиенте, а работает в транспорте: {@link HttpClient} прогоняет через `run`
+ * каждый запрос, если плагины есть.
+ */
+declare class PluginRegistry {
+  #private;
+  /** Сколько плагинов подключено. */
+  get size(): number;
+  /** Имена опций активных плагинов. */
+  get optionKeys(): ReadonlySet<string>;
+  /** Имена плагинов в фактическом порядке выполнения. */
+  names(): string[];
+  /** Подключён ли плагин с таким именем. */
+  has(name: string): boolean;
+  /** Проверяет добавление без вызова `install()`. @internal */
+  assertCanAdd(plugin: ItdPlugin): void;
+  /** Проверяет удаление без изменения реестра. @internal */
+  assertCanRemove(name: string): void;
+  /**
+   * Подключает плагин.
+   *
+   * @throws {ItdConfigError} если плагин задан неверно, уже подключён, нарушает зависимости
+   * или заявил занятое имя опции
+   */
+  add(plugin: ItdPlugin, context: Omit<PluginContext, 'use' | 'useHooks'>): void;
+  /**
+   * Отключает плагин и вызывает его функцию очистки.
+   *
+   * Новые запросы перестают видеть плагин сразу. Если его обёртка уже выполняется,
+   * очистка дождётся завершения этого логического запроса.
+   *
+   * @returns `false`, если такого плагина не было
+   */
+  remove(name: string): Promise<boolean>;
+  /**
+   * Отключает все плагины окончательно.
+   *
+   * Очистка идёт изнутри наружу — в порядке, обратном выполнению обёрток.
+   */
+  dispose(): Promise<void>;
+  /**
+   * Объединяет конструкторские хуки с хуками подключаемых плагинов.
+   *
+   * Возвращённый объект динамический: подключение и отключение плагина начинает действовать
+   * со следующего логического запроса без пересоздания транспорта.
+   */
+  hooks(base: ClientHooks): ClientHooks;
+  /**
+   * Прогоняет запрос через цепочку обёрток.
+   *
+   * Снимок цепочки берётся в начале: `unuse()` влияет на новые запросы, но не обрывает
+   * уже выполняющийся посередине.
+   *
+   * @param execute настоящий запрос, вызывается самой внутренней обёрткой
+   */
+  run(request: RawRequestOptions, execute: (request: RawRequestOptions) => Promise<unknown>): Promise<unknown>;
+}
+//#endregion
 //#region src/core/http.d.ts
 /** Что нужно фасаду для работы. */
 interface HttpClientDeps {
@@ -2250,6 +2072,48 @@ declare class HttpClient {
   request<T = unknown>(options: PipelineRequest): Promise<T>;
 }
 //#endregion
+//#region src/models/account.d.ts
+/** Активная сессия входа. */
+interface Session {
+  id: string;
+  /** Та ли это сессия, из которой выполнен запрос. */
+  isCurrent: boolean;
+  createdAt: IsoDate;
+  lastUsedAt: IsoDate;
+  expiresAt: IsoDate;
+  ipAddress: string;
+  /** Код страны по IP, например `RU`. */
+  ipCountry: string | null;
+  ipCity: string | null;
+  deviceType: Loose<'desktop' | 'mobile'>;
+  osName: string | null;
+  osVersion: string | null;
+  /** Название браузера или приложения. */
+  clientName: string | null;
+  clientVersion: string | null;
+  deviceModel: string | null;
+}
+/** Состояние платной подписки и её цена. */
+interface Subscription {
+  /** Активна ли подписка сейчас. */
+  active: boolean;
+  /** Включено ли автопродление. */
+  recurringEnabled: boolean;
+  /** Цена в рублях. */
+  price: number;
+}
+/** Сохранённый способ оплаты. */
+interface PaymentMethod {
+  id: string;
+  /** Последние четыре цифры карты. */
+  last4?: string;
+  /** Платёжная система: `visa`, `mastercard`, `mir`. */
+  brand?: string;
+  /** Основной ли это способ оплаты. */
+  isDefault?: boolean;
+  expiresAt?: IsoDate | null;
+}
+//#endregion
 //#region src/core/pagination.d.ts
 /**
  * Страница списка — единая форма для всех трёх схем пагинации API.
@@ -2609,148 +2473,62 @@ declare class AuthResource extends BaseResource {
    * отзывать было бы уже нечем.
    */
   logoutAll(options?: RequestOptions): Promise<void>;
-  /** Забывает сессию локально, не обращаясь к серверу. */
-  signOut(): Promise<void>;
-  /**
-   * Запрашивает письмо с кодом для сброса пароля.
-   *
-   * @returns `flowToken`, который нужно передать в {@link resetPassword}
-   */
-  forgotPassword(input: ForgotPasswordInput, options?: RequestOptions): Promise<string>;
-  /**
-   * Устанавливает новый пароль по коду из письма.
-   *
-   * Сервер ждёт все четыре поля сразу — `email`, `otp`, `flowToken` и `newPassword`;
-   * при нехватке любого отвечает `422`.
-   */
-  resetPassword(input: ResetPasswordInput, options?: RequestOptions): Promise<void>;
-  /**
-   * Полный сброс пароля с кодом из письма.
-   *
-   * Тот же приём, что и {@link signInWithOtp}: код запрашивается функцией `getOtp`,
-   * остальное библиотека делает сама.
-   *
-   * @example
-   * ```ts
-   * await itd.auth.resetPasswordWithOtp({
-   *   email,
-   *   turnstileToken,
-   *   newPassword,
-   *   getOtp: () => rl.question('Код из письма: '),
-   * });
-   * ```
-   */
-  resetPasswordWithOtp(input: ForgotPasswordInput & {
-    newPassword: string;
-    getOtp: () => string | Promise<string>;
-  }, options?: RequestOptions): Promise<void>;
-  /**
-   * Меняет пароль. Требует действующей сессии.
-   *
-   * При неверном текущем пароле сервер отвечает `ACCOUNT_CURRENT_PASSWORD_INCORRECT`.
-   *
-   * @example
-   * ```ts
-   * await itd.auth.changePassword({ currentPassword, newPassword });
-   * ```
-   */
-  changePassword(input: {
-    currentPassword: string;
-    newPassword: string;
-  }, options?: RequestOptions): Promise<void>;
-  /** Загружает список активных сессий. У текущей поле `isCurrent` равно `true`. */
-  sessions(options?: RequestOptions): Promise<Session[]>;
-  /** Завершает указанную сессию. */
-  revokeSession(sessionId: string, options?: RequestOptions): Promise<void>;
-  /** Завершает все сессии, кроме текущей. */
-  revokeOtherSessions(options?: RequestOptions): Promise<void>;
-}
-//#endregion
-//#region src/builders/base.d.ts
-/** Метка билдера. Через `Symbol.for` — чтобы распознавание переживало смешивание ESM и CJS. */
-declare const BUILDER: unique symbol;
-/**
- * Билдер входных данных.
- *
- * Билдеры необязательны: любой метод, принимающий билдер, принимает и обычный объект.
- * Проверки одинаковы в обоих случаях.
- */
-interface ItdBuilder<T> {
-  /** @internal */
-  readonly [BUILDER]: true;
-  /**
-   * Собирает и проверяет результат.
-   *
-   * @throws {ItdConfigError} если нарушены требования к данным
-   */
-  build(): T;
-  /** Чтобы билдер корректно вёл себя внутри `JSON.stringify`. */
-  toJSON(): T;
-}
-/**
- * Три равноправные формы входа: обычный объект, готовый билдер или функция-настройщик.
- *
- * @example
- * ```ts
- * itd.posts.create({ content: 'привет' });                    // объект
- * itd.posts.create(post().content('привет'));                 // билдер
- * itd.posts.create((p) => p.content('привет'));               // функция
- * ```
- */
-type BuilderInput<T, B extends ItdBuilder<T>> = T | B | ((builder: B) => B | T);
-/** Является ли значение билдером. */
-declare function isBuilder<T>(value: unknown): value is ItdBuilder<T>;
-//#endregion
-//#region src/builders/poll.d.ts
-/**
- * Билдер опроса.
- *
- * Неизменяемый: каждый вызов возвращает новый экземпляр, поэтому заготовку можно
- * переиспользовать, не боясь её испортить. Создаётся функцией {@link poll}.
- */
-declare class PollBuilder implements ItdBuilder<CreatePollInput> {
-  #private;
-  /** @internal */
-  readonly [BUILDER]: true;
-  /** @internal Создавайте билдер функцией {@link poll}. */
-  constructor(state: CreatePollInput);
-  /** Задаёт вопрос. */
-  question(text: string): PollBuilder;
-  /** Добавляет один вариант ответа. */
-  option(text: string): PollBuilder;
+  /** Забывает сессию локально, не обращаясь к серверу. */
+  signOut(): Promise<void>;
   /**
-   * Добавляет несколько вариантов сразу.
+   * Запрашивает письмо с кодом для сброса пароля.
+   *
+   * @returns `flowToken`, который нужно передать в {@link resetPassword}
+   */
+  forgotPassword(input: ForgotPasswordInput, options?: RequestOptions): Promise<string>;
+  /**
+   * Устанавливает новый пароль по коду из письма.
+   *
+   * Сервер ждёт все четыре поля сразу — `email`, `otp`, `flowToken` и `newPassword`;
+   * при нехватке любого отвечает `422`.
+   */
+  resetPassword(input: ResetPasswordInput, options?: RequestOptions): Promise<void>;
+  /**
+   * Полный сброс пароля с кодом из письма.
+   *
+   * Тот же приём, что и {@link signInWithOtp}: код запрашивается функцией `getOtp`,
+   * остальное библиотека делает сама.
    *
    * @example
    * ```ts
-   * poll('ну как?').options('да', 'нет', 'не знаю');
+   * await itd.auth.resetPasswordWithOtp({
+   *   email,
+   *   turnstileToken,
+   *   newPassword,
+   *   getOtp: () => rl.question('Код из письма: '),
+   * });
    * ```
    */
-  options(...texts: string[]): PollBuilder;
-  /** Разрешает выбор нескольких вариантов. */
-  multipleChoice(enabled?: boolean): PollBuilder;
-  build(): CreatePollInput;
-  toJSON(): CreatePollInput;
+  resetPasswordWithOtp(input: ForgotPasswordInput & {
+    newPassword: string;
+    getOtp: () => string | Promise<string>;
+  }, options?: RequestOptions): Promise<void>;
+  /**
+   * Меняет пароль. Требует действующей сессии.
+   *
+   * При неверном текущем пароле сервер отвечает `ACCOUNT_CURRENT_PASSWORD_INCORRECT`.
+   *
+   * @example
+   * ```ts
+   * await itd.auth.changePassword({ currentPassword, newPassword });
+   * ```
+   */
+  changePassword(input: {
+    currentPassword: string;
+    newPassword: string;
+  }, options?: RequestOptions): Promise<void>;
+  /** Загружает список активных сессий. У текущей поле `isCurrent` равно `true`. */
+  sessions(options?: RequestOptions): Promise<Session[]>;
+  /** Завершает указанную сессию. */
+  revokeSession(sessionId: string, options?: RequestOptions): Promise<void>;
+  /** Завершает все сессии, кроме текущей. */
+  revokeOtherSessions(options?: RequestOptions): Promise<void>;
 }
-/**
- * Начинает сборку опроса.
- *
- * @param question вопрос; можно задать позже методом {@link PollBuilder.question}
- *
- * @example
- * ```ts
- * import { poll } from 'itd-api';
- *
- * const q = poll('Какой язык лучше?')
- *   .options('TypeScript', 'JavaScript')
- *   .multipleChoice();
- *
- * await itd.posts.create({ content: 'голосуем', poll: q });
- * ```
- */
-declare function poll(question?: string): PollBuilder;
-/** Что принимает параметр опроса: объект, билдер или функция-настройщик. */
-type PollInput = BuilderInput<CreatePollInput, PollBuilder>;
 //#endregion
 //#region src/types/params.d.ts
 /** Данные для создания опроса. */
@@ -2764,8 +2542,13 @@ interface CreatePollInput {
   /** Разрешить выбор нескольких вариантов. По умолчанию `false`. */
   multipleChoice?: boolean;
 }
-/** Данные для создания поста. */
-interface CreatePostInput {
+/**
+ * Нормализованные данные для создания поста.
+ *
+ * Это форма, которую возвращают `PostBuilder.build()` и `resolvePost()` после
+ * преобразования вложенных builders. Для входа `itd.posts.create()` см. {@link CreatePostInput}.
+ */
+interface CreatePostData {
   /** Текст поста. */
   content?: string;
   /**
@@ -2784,8 +2567,8 @@ interface CreatePostInput {
   attachmentIds?: string[];
   /** Файлы, которые нужно загрузить перед публикацией. Порядок сохраняется. */
   files?: FileInput[];
-  /** Опрос: обычный объект, {@link PollBuilder} или функция-настройщик. */
-  poll?: PollInput;
+  /** Готовые данные опроса. */
+  poll?: CreatePollInput;
 }
 /** Поля поста, которые принимает `itd.posts.update()`. */
 interface UpdatePostInput {
@@ -2821,6 +2604,41 @@ interface CreateReportInput {
   description?: string;
 }
 //#endregion
+//#region src/builders/base.d.ts
+/** Метка билдера. Через `Symbol.for` — чтобы распознавание переживало смешивание ESM и CJS. */
+declare const BUILDER: unique symbol;
+/**
+ * Билдер входных данных.
+ *
+ * Билдеры необязательны: любой метод, принимающий билдер, принимает и обычный объект.
+ * Проверки одинаковы в обоих случаях.
+ */
+interface ItdBuilder<T> {
+  /** @internal */
+  readonly [BUILDER]: true;
+  /**
+   * Собирает и проверяет результат.
+   *
+   * @throws {ItdConfigError} если нарушены требования к данным
+   */
+  build(): T;
+  /** Чтобы билдер корректно вёл себя внутри `JSON.stringify`. */
+  toJSON(): T;
+}
+/**
+ * Три равноправные формы входа: обычный объект, готовый билдер или функция-настройщик.
+ *
+ * @example
+ * ```ts
+ * itd.posts.create({ content: 'привет' });                    // объект
+ * itd.posts.create(post().content('привет'));                 // билдер
+ * itd.posts.create((p) => p.content('привет'));               // функция
+ * ```
+ */
+type BuilderInput<T, B extends ItdBuilder<T>> = T | B | ((builder: B) => B | T);
+/** Является ли значение билдером. */
+declare function isBuilder<T>(value: unknown): value is ItdBuilder<T>;
+//#endregion
 //#region src/builders/comment.d.ts
 /** Внутреннее состояние {@link CommentBuilder}. */
 interface CommentState extends CreateCommentInput {
@@ -2871,21 +2689,172 @@ declare class CommentBuilder implements ItdBuilder<CreateCommentInput> {
   build(): CreateCommentInput;
   toJSON(): CreateCommentInput;
 }
-/**
- * Начинает сборку комментария.
- *
- * @param content текст; можно задать позже методом {@link CommentBuilder.content}
- *
- * @example
- * ```ts
- * import { comment } from 'itd-api';
- *
- * await itd.posts.comment(postId, comment('согласен').attach({ url: memeUrl }));
- * ```
- */
-declare function comment(content?: string): CommentBuilder;
-/** Что принимает параметр комментария: объект, билдер или функция-настройщик. */
-type CommentInput = BuilderInput<CreateCommentInput, CommentBuilder>;
+/**
+ * Начинает сборку комментария.
+ *
+ * @param content текст; можно задать позже методом {@link CommentBuilder.content}
+ *
+ * @example
+ * ```ts
+ * import { comment } from 'itd-api';
+ *
+ * await itd.posts.comment(postId, comment('согласен').attach({ url: memeUrl }));
+ * ```
+ */
+declare function comment(content?: string): CommentBuilder;
+/** Что принимает параметр комментария: объект, билдер или функция-настройщик. */
+type CommentInput = BuilderInput<CreateCommentInput, CommentBuilder>;
+//#endregion
+//#region src/models/content.d.ts
+/** Вложение поста или комментария. */
+interface Attachment {
+  id: string;
+  type: AttachmentType;
+  /** Адрес файла на CDN. */
+  url: string;
+  /** Ширина изображения или видео в пикселях. */
+  width?: number;
+  /** Высота изображения или видео в пикселях. */
+  height?: number;
+  mimeType: string;
+  /** Исходное имя файла. Приходит не всегда. */
+  filename?: string;
+  /** Размер в байтах. Приходит не всегда. */
+  size?: number;
+  /** Длительность аудио или видео в секундах. */
+  duration?: number | null;
+  /** Порядковый номер во вложениях поста. */
+  order?: number;
+}
+/** Вариант ответа в опросе. */
+interface PollOption {
+  id: string;
+  text: string;
+  /** Сколько голосов отдано за этот вариант. */
+  votesCount: number;
+  /** Порядковый номер варианта, начиная с нуля. */
+  position: number;
+}
+/** Опрос внутри поста. */
+interface Poll {
+  id: string;
+  /** Пост, которому принадлежит опрос. */
+  postId: string;
+  question: string;
+  /** Можно ли выбрать несколько вариантов. */
+  multipleChoice: boolean;
+  options: PollOption[];
+  totalVotes: number;
+  /** Голосовали ли вы. */
+  hasVoted: boolean;
+  /** За что проголосовали вы. Пустой массив, если голоса не было. */
+  votedOptionIds: string[];
+  createdAt: IsoDate;
+}
+/** Пост ленты, стены или профиля. */
+interface Post {
+  id: string;
+  content: string;
+  /** Разметка текста. Передаётся без изменений, см. {@link Span}. */
+  spans: Span[];
+  author: Author;
+  attachments: Attachment[];
+  likesCount: number;
+  commentsCount: number;
+  repostsCount: number;
+  viewsCount: number;
+  /** Чья это стена, если пост опубликован не у себя. */
+  wallRecipientId: UserId | null;
+  /** Владелец стены. Приходит не во всех ответах. */
+  wallRecipient?: Author | null;
+  /** Поставили ли вы реакцию. */
+  isLiked: boolean;
+  /** Делали ли вы репост. */
+  isReposted: boolean;
+  /** Засчитан ли просмотр. */
+  isViewed: boolean;
+  /** Ваш ли это пост. */
+  isOwner: boolean;
+  /** Исходный пост, если это репост. */
+  originalPost?: Post | null;
+  poll?: Poll | null;
+  /** Преобладающая реакция — эмодзи либо `null`. */
+  dominantEmoji?: string | null;
+  /** Когда пост отредактировали. `null`, если не редактировали. */
+  editedAt: IsoDate | null;
+  createdAt: IsoDate;
+  /**
+   * Служебная метка показа для телеметрии.
+   *
+   * Нужна только эндпоинтам `itd.telemetry.*`. В остальных случаях игнорируйте.
+   */
+  vs?: string;
+  /**
+   * Топовые комментарии. Приходят только в ответе `GET /api/posts/{id}`.
+   *
+   * В списках постов поле отсутствует.
+   */
+  comments?: Comment[];
+}
+/** На чей комментарий дан ответ. */
+interface CommentReplyTo {
+  id: string;
+  username: string;
+  displayName: string;
+}
+/** Комментарий к посту или ответ на комментарий. */
+interface Comment {
+  id: string;
+  /** Текст. У голосового комментария пустой. */
+  content: string;
+  /**
+   * Разметка текста, включая автоматически найденные сервером хэштеги и упоминания.
+   *
+   * Методы создания и редактирования комментария принимают только `content`, поэтому
+   * библиотека не отправляет ручные spans в этих операциях.
+   * Поле необязательно: отдельные ответы сервера могут его не содержать.
+   */
+  spans?: Span[];
+  author: Author;
+  likesCount: number;
+  repliesCount: number;
+  isLiked: boolean;
+  createdAt: IsoDate;
+  /** Вложения. У голосового — одно аудио с `mimeType: 'audio/ogg'`. */
+  attachments?: Attachment[];
+  /** Вложенные ответы. В списках приходит превью, полный список — через `itd.comments.replies()`. */
+  replies?: Comment[];
+  /** Заполнено только у ответов. */
+  replyTo?: CommentReplyTo;
+}
+/** Хэштег. */
+interface Hashtag {
+  id: string;
+  /** Название без решётки. */
+  name: string;
+  /** Сколько постов с этим хэштегом. */
+  postsCount: number;
+}
+/** Счётчики поста из `itd.posts.stats()`. */
+interface PostStats {
+  id: string;
+  likesCount: number;
+  commentsCount: number;
+  repostsCount: number;
+  viewsCount: number;
+  /** Преобладающая реакция — эмодзи либо `null`. */
+  dominantEmoji: string | null;
+}
+/** Результат реакции на пост. */
+interface LikeResult {
+  liked: boolean;
+  likesCount: number;
+}
+/** Результат закрепления поста в профиле. */
+interface PinPostResult {
+  success: boolean;
+  pinnedPostId: string | null;
+}
 //#endregion
 //#region src/resources/comments.d.ts
 /** Параметры запроса ответов на комментарий. */
@@ -3091,6 +3060,116 @@ declare class NotificationsResource extends BaseResource {
   updateSettings(input: UpdateNotificationSettingsInput, options?: RequestOptions): Promise<NotificationSettings>;
 }
 //#endregion
+//#region src/models/platform.d.ts
+/** Клан в рейтинге. */
+interface Clan {
+  /** Эмодзи клана — оно же аватар его участников. */
+  avatar: string;
+  memberCount: number;
+}
+/** Запись журнала изменений платформы. */
+interface ChangelogEntry {
+  version: string;
+  date: string;
+  changes: string[];
+}
+/** Кнопка в анонсе платформы. */
+interface AnnouncementButton {
+  title: string;
+  /** Оформление: `primary`, `secondary` и другие. */
+  style: string;
+  action: {
+    type: string;
+    [key: string]: unknown;
+  };
+}
+/** Анонс на главной странице платформы. */
+interface Announcement {
+  id: string;
+  image: {
+    url: string;
+    width: number;
+    height: number;
+  };
+  title: string;
+  description: string;
+  /** Дополнительный текст мелким шрифтом. */
+  additional_text?: string;
+  buttons: AnnouncementButton[];
+}
+/** Баннер текущего события — виджет «портал». */
+interface Portal {
+  active: boolean;
+  title: string;
+  url: string;
+}
+/** Статус заявки на верификацию. `none` означает, что заявка не подавалась. */
+interface VerificationStatus {
+  status: Loose<'none' | 'pending' | 'approved' | 'rejected'>;
+}
+/** Созданная жалоба. */
+interface Report {
+  id: string;
+  createdAt: IsoDate;
+}
+//#endregion
+//#region src/models/status.d.ts
+/** Происшествие в истории сервиса. */
+interface StatusIncidentLine {
+  /** Вид происшествия. */
+  t: IncidentKind;
+  /**
+   * Готовая строка для показа: `недоступен 6 мин (12:00–12:06)`. Время московское.
+   * Длительность и границы интервала отдельными полями не приходят.
+   */
+  text: string;
+}
+/** Одни сутки в истории сервиса. */
+interface StatusDay {
+  /** Худшее состояние за сутки. */
+  type: ServiceState;
+  /** Дата суток, `YYYY-MM-DD`. Сутки нарезаны по UTC. */
+  date_key: string;
+  /** Доступность за сутки в процентах. */
+  uptime: number;
+  /** Происшествия за сутки. */
+  lines: StatusIncidentLine[];
+}
+/** Сервис платформы и его история доступности. */
+interface ServiceStatus {
+  /** Идентификатор: `auth`, `main`, `media` и прочие. */
+  id: string;
+  /** Отображаемое название. */
+  name: string;
+  current_status: ServiceState;
+  /** Пояснение к текущему состоянию, например `No downtime`. */
+  current_message: string;
+  /** Задержка последней проверки в миллисекундах. */
+  latency_ms: number;
+  /**
+   * Момент последней проверки. Сервер отдаёт `YYYY-MM-DD HH:mm:ss` в UTC, библиотека
+   * приводит значение к ISO.
+   */
+  last_checked: IsoDate;
+  /** Доступность за 90 суток в процентах. */
+  uptime_90d: number;
+  /**
+   * История по суткам. Ключ — сколько суток назад, `'0'` — сегодня.
+   *
+   * Объект разреженный: сутки без данных сервер пропускает. Ровный массив даёт
+   * `statusDays()`.
+   */
+  days: Record<string, StatusDay | undefined>;
+}
+/** Состояние платформы — ответ `itd.platform.status()`. */
+interface PlatformStatus {
+  /** Худшее состояние среди сервисов. */
+  overall_status: ServiceState;
+  /** Когда данные последний раз пересчитаны. */
+  updated_at: IsoDate;
+  services: ServiceStatus[];
+}
+//#endregion
 //#region src/resources/platform.d.ts
 /** Требования к версии одного приложения платформы. */
 interface PlatformClientVersion {
@@ -3266,8 +3345,64 @@ declare function parseMarkdown(source: string, options?: ParseMarkupOptions): Te
  */
 declare function parseHtml(source: string, options?: ParseMarkupOptions): TextMarkup;
 //#endregion
+//#region src/builders/poll.d.ts
+/**
+ * Билдер опроса.
+ *
+ * Неизменяемый: каждый вызов возвращает новый экземпляр, поэтому заготовку можно
+ * переиспользовать, не боясь её испортить. Создаётся функцией {@link poll}.
+ */
+declare class PollBuilder implements ItdBuilder<CreatePollInput> {
+  #private;
+  /** @internal */
+  readonly [BUILDER]: true;
+  /** @internal Создавайте билдер функцией {@link poll}. */
+  constructor(state: CreatePollInput);
+  /** Задаёт вопрос. */
+  question(text: string): PollBuilder;
+  /** Добавляет один вариант ответа. */
+  option(text: string): PollBuilder;
+  /**
+   * Добавляет несколько вариантов сразу.
+   *
+   * @example
+   * ```ts
+   * poll('ну как?').options('да', 'нет', 'не знаю');
+   * ```
+   */
+  options(...texts: string[]): PollBuilder;
+  /** Разрешает выбор нескольких вариантов. */
+  multipleChoice(enabled?: boolean): PollBuilder;
+  build(): CreatePollInput;
+  toJSON(): CreatePollInput;
+}
+/**
+ * Начинает сборку опроса.
+ *
+ * @param question вопрос; можно задать позже методом {@link PollBuilder.question}
+ *
+ * @example
+ * ```ts
+ * import { poll } from 'itd-api';
+ *
+ * const q = poll('Какой язык лучше?')
+ *   .options('TypeScript', 'JavaScript')
+ *   .multipleChoice();
+ *
+ * await itd.posts.create({ content: 'голосуем', poll: q });
+ * ```
+ */
+declare function poll(question?: string): PollBuilder;
+/** Что принимает параметр опроса: объект, билдер или функция-настройщик. */
+type PollInput = BuilderInput<CreatePollInput, PollBuilder>;
+//#endregion
 //#region src/builders/post.d.ts
 declare const BUILD_UPDATE: unique symbol;
+/** Данные для создания поста, включая поддерживаемые builder-формы вложенного опроса. */
+interface CreatePostInput extends Omit<CreatePostData, 'poll'> {
+  /** Опрос: обычный объект, {@link PollBuilder} или функция-настройщик. */
+  poll?: PollInput;
+}
 /** Внутреннее состояние {@link PostBuilder}. */
 interface PostState extends CreatePostInput {
   content: string;
@@ -3289,7 +3424,7 @@ interface PostState extends CreatePostInput {
  * await itd.posts.create(onWall.content('второй'));  // заготовка не испорчена
  * ```
  */
-declare class PostBuilder implements ItdBuilder<CreatePostInput> {
+declare class PostBuilder implements ItdBuilder<CreatePostData> {
   #private;
   /** @internal */
   readonly [BUILDER]: true;
@@ -3355,10 +3490,10 @@ declare class PostBuilder implements ItdBuilder<CreatePostInput> {
    * ```
    */
   poll(input: PollInput): PostBuilder;
-  build(): CreatePostInput;
+  build(): CreatePostData;
   /** @internal Собирает данные по правилам `posts.update`, не применяя правила создания. */
   [BUILD_UPDATE](): UpdatePostInput;
-  toJSON(): CreatePostInput;
+  toJSON(): CreatePostData;
 }
 /**
  * Начинает сборку поста.
@@ -4189,10 +4324,12 @@ declare class ItdClient {
    *
    * @example
    * ```ts
+   * import { NotificationType } from 'itd-api';
+   *
    * const stream = itd.realtime();
    *
-   * stream.on('notification', ({ notification }) => {
-   *   console.log(formatNotificationText(notification));
+   * stream.onNotification(NotificationType.PostComment, async ({ update }) => {
+   *   await handleComment(update.data.notification);
    * });
    * stream.on('unreadCount', (count) => setBadge(count));
    *
@@ -4204,8 +4341,8 @@ declare class ItdClient {
    * Освобождает ресурсы клиента: закрывает все потоки уведомлений, отправляет открытые
    * накопители {@link telemetry}, затем останавливает очередь запросов.
    *
-   * После вызова клиентом можно пользоваться снова — новые запросы поднимут всё заново,
-   * но уже созданные потоки и успешно закрытые накопители останутся закрытыми.
+   * Метод дожидается активных обработчиков потока. После вызова клиентом можно пользоваться
+   * снова; ранее созданный поток можно запустить повторным `connect()`.
    *
    * Общая очередь, полученная от {@link ItdAccounts}, не останавливается: её гасит сам
    * контейнер, когда закрывает все аккаунты разом.
@@ -4513,6 +4650,22 @@ declare class ItdAccounts {
  */
 declare function createAccounts(options?: ItdAccountsOptions): ItdAccounts;
 //#endregion
+//#region src/core/attachments/factories.d.ts
+/** Создаёт URL-источник в выбранном режиме. */
+declare function fromUrl(url: string, options: UrlFileOptions & {
+  mode: typeof FileTransferMode.Stream;
+}): StreamFile;
+declare function fromUrl(url: string, options?: UrlFileOptions & {
+  mode?: typeof FileTransferMode.Buffer;
+}): LazyFile;
+declare function fromUrl(url: string, options: UrlFileOptions): LazyFile | StreamFile;
+/**
+ * Создаёт повторяемый пользовательский поток.
+ *
+ * Фабрика вызывается заново для каждой попытки; возвращать один и тот же поток нельзя.
+ */
+declare function fromStream(factory: (context: FileContext) => ReadableStream<Uint8Array> | FileStreamContent | Promise<ReadableStream<Uint8Array> | FileStreamContent>, options?: FromStreamOptions): StreamFile;
+//#endregion
 //#region src/core/errors.d.ts
 /** Бренд, по которому ошибки библиотеки распознаются надёжнее, чем через `instanceof`. */
 declare const ITD_ERROR: unique symbol;
@@ -4858,6 +5011,46 @@ type AllowedMimeType = (typeof ALLOWED_MIME_TYPES)[number];
  * ```
  */
 declare function utcStampToIso(value: string): string;
+/**
+ * Разбирает дату API в объект `Date`.
+ *
+ * @returns `null`, если строки нет или она не разбирается
+ *
+ * @example
+ * ```ts
+ * const created = toDate(post.createdAt);
+ * ```
+ */
+declare function toDate(value: IsoDate | null | undefined): Date | null;
+//#endregion
+//#region src/models/guards.d.ts
+/**
+ * Свой ли это профиль.
+ *
+ * @example
+ * ```ts
+ * if (isMyProfile(profile)) console.log(profile.subscription.isActive);
+ * ```
+ */
+declare function isMyProfile(profile: Profile): profile is MyProfile;
+//#endregion
+//#region src/models/status-helpers.d.ts
+/**
+ * Разворачивает историю сервиса в массив на 90 суток.
+ * Сутки без данных становятся `null`.
+ *
+ * @returns массив, где индекс — сколько суток назад: `[0]` — сегодня
+ *
+ * @example
+ * ```ts
+ * const status = await itd.platform.status();
+ * const days = statusDays(status.services[0]);
+ *
+ * days[0]?.uptime;                              // доступность за сегодня
+ * days.filter((day) => day === null).length;    // за сколько суток данных нет
+ * ```
+ */
+declare function statusDays(service: ServiceStatus): (StatusDay | null)[];
 //#endregion
 //#region src/notifications/text.d.ts
 /**
@@ -4926,17 +5119,52 @@ declare function resolveNotificationUrl(notification: Notification): string;
 //#region src/realtime/poll.d.ts
 /** Настройки опроса. */
 interface PollTransportOptions {
+  /** Часы опроса. Обычно подменяются только в тестах. */
+  clock?: ItdClock;
   /** Как часто опрашивать сервер, мс. По умолчанию 15 000. */
   interval?: number;
   /** Сколько уведомлений запрашивать за раз. По умолчанию 20. */
   limit?: number;
 }
 //#endregion
+//#region src/realtime/router.d.ts
+/** Выбирает маршрут обновления. `undefined` и `null` означают отсутствие маршрута. */
+type RealtimeRouteSelector<K extends PropertyKey, C extends RealtimeContext = RealtimeContext> = (context: C) => K | null | undefined | Promise<K | null | undefined>;
+/**
+ * Направляет обновления потока в именованные цепочки промежуточных обработчиков.
+ *
+ * @example
+ * ```ts
+ * import { RealtimeRouter, RealtimeUpdateType } from 'itd-api';
+ *
+ * const router = new RealtimeRouter((context) => context.update.type);
+ * router.route(RealtimeUpdateType.Notification, async (context, next) => {
+ *   if (context.update.type === RealtimeUpdateType.Notification) {
+ *     await handleNotification(context.update.data.notification);
+ *   }
+ *   await next();
+ * });
+ * stream.use(router.middleware());
+ * ```
+ */
+declare class RealtimeRouter<K extends PropertyKey = PropertyKey, C extends RealtimeContext = RealtimeContext> {
+  #private;
+  constructor(selector: RealtimeRouteSelector<K, C>);
+  /** Добавляет промежуточные обработчики к маршруту и возвращает функцию их удаления. */
+  route(key: K, ...middleware: readonly RealtimeMiddleware<C>[]): Unsubscribe;
+  /** Добавляет промежуточные обработчики для обновлений без зарегистрированного маршрута. */
+  otherwise(...middleware: readonly RealtimeMiddleware<C>[]): Unsubscribe;
+  /** Возвращает промежуточный обработчик для `stream.use()`. */
+  middleware(): RealtimeMiddleware<C>;
+}
+//#endregion
 //#region src/realtime/sse.d.ts
 /** Путь потока уведомлений. */
 declare const STREAM_PATH = "/api/notifications/stream";
 /** Настройки SSE-транспорта. */
 interface SseTransportOptions {
+  /** Часы потока. Обычно подменяются только в тестах. */
+  clock?: ItdClock;
   /**
    * Сколько миллисекунд ждать данных, прежде чем считать соединение мёртвым.
    *
@@ -4986,5 +5214,5 @@ interface RenderSpansOptions {
  */
 declare function renderSpans(content: string, spans?: readonly Span[] | null | undefined, options?: RenderSpansOptions): string;
 //#endregion
-export { ALLOWED_MIME_TYPES, AUDIO_MIME_TYPES, AUTH_FLAG_COOKIE, AUTH_PATHS, AccessType, type AccountEvents, type Actor, type AddAccountOptions, type AllowedMimeType, type Announcement, type AnnouncementButton, type Attachment, AttachmentType, type AudioMimeType, type AuthEvents, type AuthIdentity, type AuthInput, type AuthResource, type AuthState, type Author, type AutoSpansOptions, BUILT_IN_SERVICES, type BuilderInput, type CaptchaCredentials, type ChangelogEntry, type Clan, type ClientHooks, type Comment, type CommentBuilder, type CommentInput, type CommentReplyTo, CommentSort, type CommentsParams, type CommentsResource, type CreateCommentInput, type CreatePollInput, type CreatePostInput, type CreateReportInput, type Credentials, type CredentialsAuth, DEFAULT_BASE_URL, DEFAULT_FILE_STREAM_BUFFER_BYTES, DEFAULT_STATUS_BASE_URL, DEFAULT_TIMEOUT, DEFAULT_UPLOAD_TIMEOUT, DEFAULT_URL_FILE_MAX_BYTES, DEFAULT_USER_AGENT, DEVICE_ID_HEADER, DetectedRuntime, type DwellEntry, type ErrorContextHook, type FeedParams, FeedTab, type FileContent, type FileContext, type FileInput, type FileStreamContent, type FileStreamOptions, FileTransferMode, type FilesResource, type FollowResult, type ForgotPasswordInput, type FromStreamOptions, type Hashtag, type HashtagPostsParams, type HashtagsResource, IMAGE_MIME_TYPES, type ImageMimeType, IncidentKind, type InteractionEntry, InteractionType, type IsoDate, ItdAbortError, ItdAccounts, type ItdAccountsOptions, ItdApiError, type ItdApiErrorInit, ItdApiErrorKind, ItdAuthError, type ItdBuilder, ItdClient, type ItdClientOptions, ItdConfigError, ItdConflictError, ItdError, ItdErrorCode, ItdErrorKind, type ItdFieldErrors, ItdFileError, ItdFileErrorReason, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdPhoneVerificationError, type ItdPlugin, ItdRateLimitError, ItdRealtime, ItdServerError, type ItdSession, ItdTimeoutError, ItdValidationError, LIBRARY_VERSION, type LazyFile, type LikeResult, LikesVisibility, type Listener, type Logger, type Loose, MAX_RECONNECT_ATTEMPTS, type MarkupBuilder, type MarkupContent, type MarkupInput, type MarkupSpan, MemoryMultiTokenStorage, MemoryTokenStorage, type MultiTokenStorage, type MyProfile, NOTIFICATION_TYPE_ALIASES, type Notification, type NotificationEvent, type NotificationListParams, type NotificationSettings, NotificationType, type NotificationsResource, type Page, type PageState, PaginationMode, Paginator, type PaginatorOptions, type ParseMarkupOptions, type PaymentMethod, type PhotoOpenInput, type Pin, type PinPostResult, type PinsResult, type PlatformClientVersion, type PlatformResource, type PlatformStatus, type PlatformVersions, type PluginContext, type PluginTeardown, type Poll, type PollBuilder, type PollInput, type PollOption, type PollTransportOptions, type Portal, type Post, type PostBuilder, type PostInput, type PostStats, type PostUpdateInput, type PostsResource, type PrivacySettings, type Profile, type PublicProfile, type QueryParams, type QueryValue, RECONNECT_BACKOFF, RECONNECT_JITTER, REFRESH_COOKIE, REFRESH_COOKIE_PATH, REQUEST_OPTION_KEYS, type RateLimitOptions, type RateLimitScope, type RawRequestOptions, type RealtimeDeps, type RealtimeEvents, type RealtimeOptions, RealtimeStatus, type RealtimeTransport, RealtimeTransportKind, type ReconnectOptions, type RecordStorageSource, type RemoveAccountOptions, type RenderSpansOptions, type RepliesParams, type Report, type ReportBuilder, type ReportInput, ReportReason, ReportTargetType, type ReportsResource, type RequestContext, type RequestOptions, type ResetPasswordInput, type ResponseContext, type RetryContext, type RetryOptions, RuntimeMode, STATUS_SERVICE, STREAM_PATH, type SearchResource, type SearchResult, type ServiceDefinition, ServiceRegistry, ServiceState, type ServiceStatus, type Session, type SignInResult, SignInStatus, type Span, SpanRenderFormat, SpanType, type SseTransportOptions, type StatusDay, type StatusIncidentLine, type StreamFile, type Subscription, type SubscriptionResource, type SubscriptionState, TURNSTILE_SITE_KEY, type TelemetryBatch, type TelemetryBatchOptions, type TelemetryClock, type TelemetryOptions, type TelemetryResource, type TextMarkup, type TokenStorage, type Transformer, type TransportContext, type TransportEvent, UnauthorizedStreamError, type Unsubscribe, type UpdateNotificationSettingsInput, type UpdatePostInput, type UpdatePrivacyInput, type UpdateProfileInput, type UploadOptions, type UploadedFile, type UrlFile, type UrlFileOptions, type UserId, type UserListParams, type UserPostsParams, type UserRef, type UserSummary, type UsersResource, VIDEO_MIME_TYPES, type VerificationResource, type VerificationStatus, type VideoMimeType, type VideoProgressInput, ViewReason, ViewSource, type ViewTracker, type ViewTrackerInput, type ViewTrackerOptions, WallAccess, autoSpans, canonicalNotificationType, comment, createAccounts, createClient, createMultiTokenStorage, createRecordMultiStorage, createTokenStorage, formatNotificationText, fromStream, fromUrl, isBuilder, isItdApiError, isItdAuthError, isItdConflictError, isItdError, isItdFileError, isItdForbiddenError, isItdNotFoundError, isItdPhoneVerificationError, isItdRateLimitError, isItdServerError, isItdValidationError, isKnownNotificationType, isMyProfile, mapPage, markup, normalizeNotification, parseHtml, parseMarkdown, poll, post, readNotificationEvent, readUnreadCountEvent, renderSpans, report, resolveNotificationUrl, scopedTokenStorage, statusDays, toDate, utcStampToIso };
+export { ALLOWED_MIME_TYPES, AUDIO_MIME_TYPES, AUTH_FLAG_COOKIE, AUTH_PATHS, AccessType, type AccountEvents, type Actor, type AddAccountOptions, type AllowedMimeType, type Announcement, type AnnouncementButton, type Attachment, AttachmentType, type AudioMimeType, type AuthEvents, type AuthIdentity, type AuthInput, type AuthResource, type AuthState, type Author, type AutoSpansOptions, BUILT_IN_SERVICES, type BuilderInput, type CaptchaCredentials, type ChangelogEntry, type Clan, type ClientHooks, type Comment, type CommentBuilder, type CommentInput, type CommentReplyTo, CommentSort, type CommentsParams, type CommentsResource, type CreateCommentInput, type CreatePollInput, type CreatePostData, type CreatePostInput, type CreateReportInput, type Credentials, type CredentialsAuth, DEFAULT_BASE_URL, DEFAULT_FILE_STREAM_BUFFER_BYTES, DEFAULT_STATUS_BASE_URL, DEFAULT_TIMEOUT, DEFAULT_UPLOAD_TIMEOUT, DEFAULT_URL_FILE_MAX_BYTES, DEFAULT_USER_AGENT, DEVICE_ID_HEADER, DetectedRuntime, type DwellEntry, type ErrorContextHook, type FeedParams, FeedTab, type FileContent, type FileContext, type FileInput, type FileStreamContent, type FileStreamOptions, FileTransferMode, type FilesResource, type FollowResult, type ForgotPasswordInput, type FromStreamOptions, type Hashtag, type HashtagPostsParams, type HashtagsResource, IMAGE_MIME_TYPES, type ImageMimeType, IncidentKind, type InteractionEntry, InteractionType, type IsoDate, ItdAbortError, ItdAccounts, type ItdAccountsOptions, ItdApiError, type ItdApiErrorInit, ItdApiErrorKind, ItdAuthError, type ItdBuilder, ItdClient, type ItdClientOptions, type ItdClock, ItdConfigError, ItdConflictError, ItdError, ItdErrorCode, ItdErrorKind, type ItdFieldErrors, ItdFileError, ItdFileErrorReason, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdPhoneVerificationError, type ItdPlugin, ItdRateLimitError, ItdRealtime, ItdServerError, type ItdSession, ItdTimeoutError, ItdValidationError, LIBRARY_VERSION, type LazyFile, type LikeResult, LikesVisibility, type Listener, type Logger, type Loose, MAX_RECONNECT_ATTEMPTS, type MarkupBuilder, type MarkupContent, type MarkupInput, type MarkupSpan, MemoryMultiTokenStorage, MemoryTokenStorage, type MultiTokenStorage, type MyProfile, NOTIFICATION_TYPE_ALIASES, type Notification, type NotificationEvent, type NotificationEventOfType, type NotificationListParams, type NotificationOfType, type NotificationSettings, NotificationType, type NotificationsResource, type Page, type PageState, PaginationMode, Paginator, type PaginatorOptions, type ParseMarkupOptions, type PaymentMethod, type PhotoOpenInput, type Pin, type PinPostResult, type PinsResult, type PlatformClientVersion, type PlatformResource, type PlatformStatus, type PlatformVersions, type PluginContext, type PluginTeardown, type Poll, type PollBuilder, type PollInput, type PollOption, type PollTransportOptions, type Portal, type Post, type PostBuilder, type PostInput, type PostStats, type PostUpdateInput, type PostsResource, type PrivacySettings, type Profile, type PublicProfile, type QueryParams, type QueryValue, RECONNECT_BACKOFF, RECONNECT_JITTER, REFRESH_COOKIE, REFRESH_COOKIE_PATH, REQUEST_OPTION_KEYS, type RateLimitOptions, type RateLimitScope, type RawRequestOptions, type RealtimeContext, type RealtimeDeps, type RealtimeEvents, type RealtimeHandler, type RealtimeMiddleware, type RealtimeNext, type RealtimeNotificationContext, type RealtimeNotificationFilter, type RealtimeNotificationSelector, type RealtimeNotificationUpdate, type RealtimeOptions, type RealtimePredicate, type RealtimeRouteSelector, RealtimeRouter, type RealtimeSequentializer, RealtimeStatus, type RealtimeTransport, RealtimeTransportKind, type RealtimeTypeGuard, type RealtimeUnknownUpdate, type RealtimeUnreadCountUpdate, type RealtimeUpdate, type RealtimeUpdateOfType, RealtimeUpdateOrigin, RealtimeUpdateType, type ReconnectOptions, type RecordStorageSource, type RemoveAccountOptions, type RenderSpansOptions, type RepliesParams, type Report, type ReportBuilder, type ReportInput, ReportReason, ReportTargetType, type ReportsResource, type RequestContext, type RequestOptions, type ResetPasswordInput, type ResponseContext, type RetryContext, type RetryOptions, RuntimeMode, STATUS_SERVICE, STREAM_PATH, type SearchResource, type SearchResult, type ServiceDefinition, ServiceRegistry, ServiceState, type ServiceStatus, type Session, type SignInResult, SignInStatus, type Span, SpanRenderFormat, SpanType, type SseTransportOptions, type StatusDay, type StatusIncidentLine, type StreamFile, type Subscription, type SubscriptionResource, type SubscriptionState, TURNSTILE_SITE_KEY, type TelemetryBatch, type TelemetryBatchOptions, type TelemetryClock, type TelemetryOptions, type TelemetryResource, type TextMarkup, type TokenStorage, type Transformer, type TransportContext, type TransportEvent, UnauthorizedStreamError, type Unsubscribe, type UpdateNotificationSettingsInput, type UpdatePostInput, type UpdatePrivacyInput, type UpdateProfileInput, type UploadOptions, type UploadedFile, type UrlFile, type UrlFileOptions, type UserId, type UserListParams, type UserPostsParams, type UserRef, type UserSummary, type UsersResource, VIDEO_MIME_TYPES, type VerificationResource, type VerificationStatus, type VideoMimeType, type VideoProgressInput, ViewReason, ViewSource, type ViewTracker, type ViewTrackerInput, type ViewTrackerOptions, WallAccess, autoSpans, canonicalNotificationType, comment, createAccounts, createClient, createMultiTokenStorage, createRecordMultiStorage, createTokenStorage, formatNotificationText, fromStream, fromUrl, isBuilder, isItdApiError, isItdAuthError, isItdConflictError, isItdError, isItdFileError, isItdForbiddenError, isItdNotFoundError, isItdPhoneVerificationError, isItdRateLimitError, isItdServerError, isItdValidationError, isKnownNotificationType, isMyProfile, mapPage, markup, normalizeNotification, parseHtml, parseMarkdown, poll, post, readNotificationEvent, readUnreadCountEvent, renderSpans, report, resolveNotificationUrl, scopedTokenStorage, statusDays, systemClock, toDate, utcStampToIso };
 //# sourceMappingURL=index.d.cts.map