itd-api 0.0.6 → 0.0.8

package/dist/{index-CDGXKy8r.d.ts → index-Duh31Wnx.d.ts}

@@ -156,22 +156,46 @@ declare const RealtimeStatus: Readonly<{
 }>;
 type RealtimeStatus = (typeof RealtimeStatus)[keyof typeof RealtimeStatus];
 /**
- * Кто может писать на стену профиля.
+ * Уровень доступа к разделу профиля.
  *
- * Документация перечисляет значения не полностью, поэтому тип открытый: объект ниже —
- * справочник известных значений, но сервер может прислать и другое.
+ * Общий набор значений для полей `wallAccess` и `likesVisibility` настроек приватности.
+ * Тип открытый: сервер может прислать значение вне этого перечня.
  */
+declare const AccessType: Readonly<{
+    /** Никто. */
+    readonly Nobody: "nobody";
+    /** Только взаимные подписки. */
+    readonly Mutual: "mutual";
+    /** Подписчики. */
+    readonly Followers: "followers";
+    /** Все. */
+    readonly Everyone: "everyone";
+}>;
+type AccessType = Loose<(typeof AccessType)[keyof typeof AccessType]>;
+/** Кто может писать на стену профиля. Псевдоним {@link AccessType}. */
 declare const WallAccess: Readonly<{
+    /** Никто. */
+    readonly Nobody: "nobody";
+    /** Только взаимные подписки. */
+    readonly Mutual: "mutual";
+    /** Подписчики. */
+    readonly Followers: "followers";
+    /** Все. */
     readonly Everyone: "everyone";
 }>;
-type WallAccess = Loose<(typeof WallAccess)[keyof typeof WallAccess]>;
-/** Кто видит реакции пользователя. Список в документации неполный. */
+type WallAccess = AccessType;
+/** Кто видит реакции пользователя. Псевдоним {@link AccessType}. */
 declare const LikesVisibility: Readonly<{
-    readonly Everyone: "everyone";
+    /** Никто. */
+    readonly Nobody: "nobody";
     /** Только взаимные подписки. */
     readonly Mutual: "mutual";
+    /** Подписчики. */
+    readonly Followers: "followers";
+    /** Все. */
+    readonly Everyone: "everyone";
 }>;
-type LikesVisibility = Loose<(typeof LikesVisibility)[keyof typeof LikesVisibility]>;
+type LikesVisibility = AccessType;
 /**
  * Канонический тип уведомления (новое поколение имён).
  *
@@ -208,6 +232,55 @@ declare const NotificationType: Readonly<{
     readonly VerificationRejected: "verification_rejected";
 }>;
 type NotificationType = Loose<(typeof NotificationType)[keyof typeof NotificationType]>;
+/**
+ * Тип взаимодействия с контентом в телеметрии (`POST /api/v1/x`, поле `t`).
+ *
+ * Кодируется числом.
+ */
+declare const InteractionType: Readonly<{
+    /** Открытие фотографии. */
+    readonly PhotoOpen: 1;
+    /** Прогресс просмотра видео. Несёт поля `pm`/`dm`. */
+    readonly VideoProgress: 2;
+}>;
+type InteractionType = (typeof InteractionType)[keyof typeof InteractionType];
+/**
+ * Источник показа поста в телеметрии (поле `s`).
+ *
+ * Кодируется числом. Поле применимо к источникам `PostPage` и `Link`; для лент источник
+ * передаётся контекстом `sc`.
+ */
+declare const ViewSource: Readonly<{
+    readonly FeedGlobal: 1;
+    readonly FeedFollowing: 2;
+    readonly FeedClan: 3;
+    readonly Profile: 4;
+    readonly Hashtag: 5;
+    readonly PostPage: 6;
+    readonly Link: 7;
+    readonly Search: 8;
+}>;
+type ViewSource = (typeof ViewSource)[keyof typeof ViewSource];
+/**
+ * Причина завершения просмотра поста в телеметрии (`POST /api/v1/i`, поле `r`).
+ *
+ * Кодируется числом.
+ */
+declare const ViewReason: Readonly<{
+    /** Пост ушёл из зоны видимости при обычной прокрутке. */
+    readonly Normal: 0;
+    /** Потеря фокуса окна. */
+    readonly Blur: 1;
+    /** Вкладка скрыта. */
+    readonly Hidden: 2;
+    /** Уход со страницы (`pagehide`). */
+    readonly PageHide: 3;
+    /** Элемент перестал наблюдаться. */
+    readonly Unobserve: 4;
+    /** Достигнут порог времени просмотра. */
+    readonly ThresholdMet: 5;
+}>;
+type ViewReason = (typeof ViewReason)[keyof typeof ViewReason];
 /**
  * Строковые коды ошибок из поля `code`.
  *
@@ -1440,7 +1513,7 @@ interface RequestOptions {
     timeout?: number | undefined;
     /** Дополнительные заголовки. */
     headers?: Record<string, string> | undefined;
-    /** Повторы только для этого запроса. */
+    /** Повторы только для этого запроса. Переопределяют глобальную настройку `retry`. */
     retry?: RetryOptions | false | undefined;
 }
 /** Полное описание запроса для низкоуровневого `itd.request()`. */
@@ -1467,14 +1540,14 @@ interface RawRequestOptions extends RequestOptions {
     raw?: boolean | undefined;
 }
 
+/** Версия библиотеки. Попадает в `User-Agent`. */
+declare const LIBRARY_VERSION = "0.0.8";
+
 /** Базовый URL API итд.com. Домен записан в punycode: `итд.com`. */
 declare const DEFAULT_BASE_URL = "https://xn--d1ah4a.com";
 /** Таймаут запроса по умолчанию. Столько же использует официальный клиент итд.com. */
 declare const DEFAULT_TIMEOUT = 30000;
-/**
- * Версия библиотеки — попадает в `User-Agent`.
- */
-declare const LIBRARY_VERSION = "0.0.6";
+
 /**
  * `User-Agent` по умолчанию.
  *
@@ -1485,51 +1558,22 @@ declare const LIBRARY_VERSION = "0.0.6";
  * В браузере заголовок не выставляется — `User-Agent` там запрещён к изменению, и среда
  * молча его игнорирует.
  */
-declare const DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; itd-api/0.0.6; +https://github.com/KiowDev/itd-api)";
+declare const DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; itd-api/0.0.8; +https://github.com/KiowDev/itd-api)";
 /**
- * Настройки повторов со всеми значениями по умолчанию.
+ * Срез конфигурации, нужный слою авторизации.
  *
- * Поля перечислены явно, а не через `Required<RetryOptions>`: тот снимает необязательность,
- * но оставляет `| undefined` в типе значения, раз оно указано в исходном интерфейсе.
+ * Выделен явно, чтобы {@link AuthManager} не получал целиком `ResolvedConfig` со всеми
+ * настройками транспорта, повторов и очереди, к которым он отношения не имеет.
+ * `ResolvedConfig` содержит все эти поля, поэтому подходит везде, где ждут `AuthConfig`.
  */
-interface ResolvedRetryOptions {
-    attempts: number;
-    baseDelay: number;
-    maxDelay: number;
-    jitter: number;
-    retryWrites: boolean;
-    shouldRetry: ((error: unknown, attempt: number) => boolean) | undefined;
-}
-/** Настройки очереди со всеми значениями по умолчанию. */
-interface ResolvedRateLimitOptions {
-    concurrency: number;
-    rps: number | undefined;
-    retryDelays: readonly number[];
-    respectHeaders: boolean;
-}
-/** Конфигурация клиента после подстановки значений по умолчанию и проверок. */
-interface ResolvedConfig {
+interface AuthConfig {
     baseUrl: string;
     auth: AuthInput | undefined;
     storage: TokenStorage;
-    autoRefresh: boolean;
+    useCookieJar: boolean;
+    deviceId: string | undefined;
     reloginOnRefreshFailure: boolean;
-    fetch: typeof fetch;
-    timeout: number;
-    retry: ResolvedRetryOptions | undefined;
-    rateLimit: ResolvedRateLimitOptions | undefined;
-    hooks: ClientHooks;
     logger: Logger | undefined;
-    headers: Record<string, string>;
-    /** Значение заголовка `X-Device-Id`, если задано вручную. Иначе заводится само. */
-    deviceId: string | undefined;
-    /** Значение заголовка `User-Agent`. `undefined` — заголовок не выставляется. */
-    userAgent: string | undefined;
-    mode: RuntimeMode;
-    /** Вести ли собственный cookie-jar (вне браузера и React Native). */
-    useCookieJar: boolean;
-    /** Отправлять ли `credentials: 'include'` (в браузере). */
-    sendCredentials: boolean;
 }
 
 /** Имя cookie-флага «есть refresh-сессия». Ставится сайтом итд.com рядом с refresh-токеном. */
@@ -1646,190 +1690,31 @@ declare class Emitter<Events> {
 }
 
 /**
- * Обёртка вокруг запроса.
- *
- * Получает описание запроса и продолжение цепочки. Может изменить запрос перед отправкой,
- * посмотреть и подменить разобранный ответ или вовсе не вызывать `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>;
-/** Что плагин получает при подключении. */
-interface PluginContext {
-    /** Базовый URL клиента — например чтобы разобрать абсолютные ссылки из ответа. */
-    baseUrl: string;
-    /** Отладочный вывод клиента, если он включён. */
-    logger: Logger | undefined;
-    /** Добавляет обёртку запроса. Подключённые раньше оказываются снаружи. */
-    use(transformer: Transformer): 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 }
-     * }
-     * ```
-     */
-    optionKeys?: readonly string[];
-    /** Вызывается один раз при подключении. */
-    install(context: PluginContext): void;
-}
-/**
- * Список подключённых плагинов и собранная из них цепочка обёрток.
- *
- * Живёт в клиенте, а работает в транспорте: {@link HttpClient} прогоняет через `run`
- * каждый запрос, если плагины есть.
- */
-declare class PluginRegistry {
-    #private;
-    /** Сколько обёрток подключено. Ноль означает, что запрос идёт прежним путём. */
-    get size(): number;
-    /** Имена опций запроса, заявленные плагинами. */
-    get optionKeys(): ReadonlySet<string>;
-    /**
-     * Подключает плагин.
-     *
-     * @throws {ItdConfigError} если плагин задан неверно, уже подключён или заявил занятое
-     * имя опции
-     */
-    add(plugin: ItdPlugin, context: Omit<PluginContext, 'use'>): void;
-    /**
-     * Прогоняет запрос через цепочку обёрток.
-     *
-     * Цепочка собирается на каждый запрос заново: плагин можно подключить в любой момент,
-     * а обёрток единицы — экономить тут не на чем.
-     *
-     * @param execute настоящий запрос, вызывается самой внутренней обёрткой
-     */
-    run(request: RawRequestOptions, execute: (request: RawRequestOptions) => Promise<unknown>): Promise<unknown>;
-}
-
-/**
- * Подключаемые части конвейера.
- *
- * Авторизация, cookie, очередь и повторы живут в отдельных модулях и подставляются сюда.
- * Благодаря этому транспорт тестируется изолированно, а `HttpClient` ничего не знает
- * о том, как именно добывается токен.
- */
-interface HttpCollaborators {
-    /** Заголовки авторизации для запроса. Вызывается перед каждой попыткой. */
-    getAuthHeaders?(): Promise<Record<string, string>> | Record<string, string>;
-    /**
-     * Реакция на ответ `401`.
-     *
-     * Должна вернуть `true`, если токен обновлён и запрос имеет смысл повторить.
-     * Повтор выполняется ровно один раз.
-     */
-    onUnauthorized?(): Promise<boolean>;
-    /**
-     * Идентификатор устройства для заголовка `X-Device-Id`.
-     *
-     * Отдельно от {@link getAuthHeaders}, потому что нужен и на анонимных запросах —
-     * например на `sign-in`, где заголовка авторизации ещё нет.
-     */
-    getDeviceId?(): Promise<string> | string;
-    /** Значение заголовка `Cookie` для указанного URL. */
-    getCookieHeader?(url: string): string | undefined;
-    /** Приём `Set-Cookie` из ответа. */
-    saveCookies?(url: string, response: Response): void;
-    /** Очередь запросов: ограничение конкурентности и частоты. */
-    schedule?<T>(task: () => Promise<T>): Promise<T>;
-    /**
-     * Сообщает об остатке лимита из заголовков ответа.
-     *
-     * Вызывается после **каждого** ответа, включая ошибочные, — так очередь узнаёт
-     * об исчерпании лимита заранее и успевает притормозить до отказа сервера.
-     */
-    onRateLimit?(limit: number | undefined, remaining: number | undefined): void;
-    /**
-     * Планировщик повторов.
-     *
-     * Возвращает паузу в мс перед следующей попыткой либо `undefined`, если повторять не нужно.
-     */
-    nextRetryDelay?(error: unknown, attempt: number, method: string): number | undefined;
-}
-/**
- * Транспортный слой: единственное место, откуда библиотека ходит в сеть.
+ * Описание запроса внутри конвейера.
  *
- * Отвечает за сборку URL, заголовки, таймауты, разбор ответа и превращение любой неудачи
- * в типизированную ошибку. Авторизация, cookie, очередь и повторы подключаются извне
- * через {@link HttpCollaborators}.
+ * Отличается от публичного {@link RawRequestOptions} одним служебным полем: слои конвейера
+ * должны уметь дописать заголовки так, чтобы пользовательские `headers` всё равно остались
+ * важнее. Смешивать их в одном объекте нельзя — тогда слой авторизации перебивал бы
+ * `Authorization`, заданный вызывающим кодом вручную.
  */
-declare class HttpClient {
-    #private;
-    constructor(config: ResolvedConfig, collaborators?: HttpCollaborators);
-    /** Базовый URL, к которому обращается клиент. */
-    get baseUrl(): string;
+interface PipelineRequest extends RawRequestOptions {
     /**
-     * Имена опций запроса, заявленные плагинами.
+     * Заголовки, добавленные слоями конвейера.
      *
-     * Читается ресурсами: они переносят в транспорт только известные поля, а чужие,
-     * если их никто не заявил, отсеивают.
-     */
-    get pluginOptionKeys(): ReadonlySet<string>;
-    /** Подключает список плагинов. Реестр общий с клиентом и пополняется через `itd.use()`. */
-    usePlugins(plugins: PluginRegistry): void;
-    /**
-     * Подключает недостающие части конвейера.
+     * Ставятся до пользовательских `headers` и потому могут быть ими переопределены.
      *
-     * Нужно из-за кольцевой зависимости: слой авторизации сам выполняет запросы, поэтому
-     * не может быть передан в конструктор до создания транспорта.
+     * @internal
      */
-    setCollaborators(collaborators: HttpCollaborators): void;
+    layerHeaders?: Record<string, string> | undefined;
     /**
-     * Выполняет запрос к API.
+     * Номер попытки, начиная с 1. Проставляет слой повторов, читают хуки.
      *
-     * @typeParam T ожидаемая форма ответа после снятия обёртки `{ data: … }`
-     * @throws {ItdApiError} если сервер ответил статусом ≥ 400
-     * @throws {ItdTimeoutError} если истёк таймаут
-     * @throws {ItdAbortError} если запрос отменён через `signal`
-     * @throws {ItdNetworkError} если запрос не дошёл до сервера
+     * @internal
      */
-    request<T = unknown>(options: RawRequestOptions): Promise<T>;
+    attempt?: number | undefined;
 }
+/** Обработчик запроса. Самый внутренний в цепочке — транспорт. */
+type RequestHandler = (request: PipelineRequest) => Promise<unknown>;
 
 /** Пути авторизации. Вынесены, чтобы не расходиться между модулями. */
 declare const AUTH_PATHS: {
@@ -1880,7 +1765,7 @@ interface AuthEvents {
  */
 declare class AuthManager {
     #private;
-    constructor(config: ResolvedConfig, http: HttpClient, jar: CookieJar);
+    constructor(config: AuthConfig, send: RequestHandler, jar: CookieJar);
     /** Подписка на события авторизации. */
     get on(): Emitter<AuthEvents>['on'];
     /** Подписка на одно срабатывание. */
@@ -1942,76 +1827,178 @@ declare class AuthManager {
     clear(): Promise<void>;
 }
 
-/** Событие потока уведомлений после разбора. */
-interface NotificationEvent {
-    /** Само уведомление в единой форме. */
-    notification: Notification;
-    /**
-     * Актуальное число непрочитанных, если сервер его сообщил.
-     *
-     * Клиент не увеличивает счётчик сам: значение приходит с сервера.
-     */
-    unreadCount: number | undefined;
-    /** Нужно ли проиграть звук. */
-    sound: boolean;
-}
 /**
- * Приводит уведомление к единой форме.
- *
- * Нужна потому, что REST-список и поток событий описывают одно и то же событие по-разному:
- * различаются имена типов (`like` против `post_reaction`), имена полей
- * (`targetId`/`entityId`, `read`/`isRead`, `preview`/`entityPreview`) и число участников
- * (`actor` против массива `actors`). После приведения объекты из обоих источников
- * можно складывать в один список.
+ * Обёртка вокруг запроса.
  *
- * Исходные данные не теряются: имя типа с сервера остаётся в `rawType`,
- * весь объект целиком — в `raw`.
+ * Получает описание запроса и продолжение цепочки. Может изменить запрос перед отправкой,
+ * посмотреть и подменить разобранный ответ или вовсе не вызывать `next` и вернуть своё.
  *
- * @param input уведомление из REST-ответа либо полезная нагрузка события потока
+ * @param request что уходит на сервер; изменять сам объект не нужно — передайте копию в `next`
+ * @param next продолжение: либо следующая обёртка, либо настоящий запрос
+ * @returns тело ответа в том виде, в каком его получит вызывающий код
  *
- * @example
+ * @example Дописать заголовок ко всем запросам
  * ```ts
- * const fromRest = normalizeNotification(restItem);
- * const fromStream = normalizeNotification(event.payload);
- * // одинаковая форма — можно объединять
+ * const transformer: Transformer = (request, next) =>
+ *   next({ ...request, headers: { ...request.headers, 'X-Trace': trace() } });
  * ```
  */
-declare function normalizeNotification(input: unknown): Notification;
-/**
- * Разбирает событие `notification` из потока.
- *
- * Кроме самого уведомления событие несёт служебные поля уровня конверта: актуальный
- * счётчик непрочитанных и признак звука.
- */
-declare function readNotificationEvent(data: unknown): NotificationEvent;
+type Transformer = (request: RawRequestOptions, next: (request: RawRequestOptions) => Promise<unknown>) => Promise<unknown>;
+/** Что плагин получает при подключении. */
+interface PluginContext {
+    /** Базовый URL клиента — например чтобы разобрать абсолютные ссылки из ответа. */
+    baseUrl: string;
+    /** Отладочный вывод клиента, если он включён. */
+    logger: Logger | undefined;
+    /** Добавляет обёртку запроса. Подключённые раньше оказываются снаружи. */
+    use(transformer: Transformer): void;
+}
 /**
- * Разбирает событие `unread_count` из потока.
+ * Плагин клиента.
  *
- * Возвращает `undefined`, если сервер прислал событие без вложенного `payload`.
- * Официальный клиент в этом случае **обнуляет** счётчик — это ошибка, из-за которой
- * непрочитанные пропадают из интерфейса.
- */
-declare function readUnreadCountEvent(data: unknown): number | undefined;
-
-/**
- * Паузы перед попытками переподключения, мс.
+ * Подключается через `itd.use(plugin)` и работает на уровне транспорта: видит запрос
+ * до отправки и разобранный ответ. Библиотека не знает, что именно делает плагин, —
+ * ей достаточно списка обёрток и имён опций, которые он читает.
  *
- * Значения совпадают с теми, что использует сайт итд.com, — поведение библиотеки
- * не отличается от привычного пользователю.
- */
-declare const RECONNECT_BACKOFF: readonly number[];
-/** Доля случайного разброса паузы. */
-declare const RECONNECT_JITTER = 0.3;
-/**
- * Сколько раз пытаться переподключиться подряд.
+ * @example
+ * ```ts
+ * const logging: ItdPlugin = {
+ *   name: 'logging',
+ *   install({ use, logger }) {
+ *     use(async (request, next) => {
+ *       logger?.info(`${request.method} ${request.path}`);
+ *       return next(request);
+ *     });
+ *   },
+ * };
  *
- * После исчерпания поток сообщает `giveup` и ждёт ручного `connect()`.
+ * itd.use(logging);
+ * ```
  */
-declare const MAX_RECONNECT_ATTEMPTS = 15;
-/** Настройки переподключения. */
-interface ReconnectOptions {
-    /** Таблица пауз. Последнее значение действует для всех дальнейших попыток. */
-    backoff?: readonly number[];
+interface ItdPlugin {
+    /** Имя плагина. Должно быть уникальным: повторное подключение — ошибка. */
+    name: string;
+    /**
+     * Имена опций запроса, которые плагин читает у методов ресурсов.
+     *
+     * Библиотека этих опций не понимает и ничего с ними не делает — только доносит
+     * от вызова метода до обёртки нетронутыми. Без такого списка чужие поля отсеиваются,
+     * чтобы случайная опечатка в параметрах не уезжала на сервер.
+     *
+     * Имена полей самого запроса (`path`, `body`, `headers`, `signal` и прочие из
+     * `RawRequestOptions`) заявить нельзя: подключение такого плагина завершится ошибкой.
+     *
+     * Типы для них плагин объявляет сам, дополняя `RequestOptions`:
+     * ```ts
+     * declare module 'itd-api' {
+     *   interface RequestOptions { encrypt?: string | undefined }
+     * }
+     * ```
+     */
+    optionKeys?: readonly string[];
+    /** Вызывается один раз при подключении. */
+    install(context: PluginContext): void;
+}
+/**
+ * Список подключённых плагинов и собранная из них цепочка обёрток.
+ *
+ * Живёт в клиенте, а работает в транспорте: {@link HttpClient} прогоняет через `run`
+ * каждый запрос, если плагины есть.
+ */
+declare class PluginRegistry {
+    #private;
+    /** Сколько обёрток подключено. Ноль означает, что запрос идёт прежним путём. */
+    get size(): number;
+    /** Имена опций запроса, заявленные плагинами. */
+    get optionKeys(): ReadonlySet<string>;
+    /**
+     * Подключает плагин.
+     *
+     * @throws {ItdConfigError} если плагин задан неверно, уже подключён или заявил занятое
+     * имя опции
+     */
+    add(plugin: ItdPlugin, context: Omit<PluginContext, 'use'>): void;
+    /**
+     * Прогоняет запрос через цепочку обёрток.
+     *
+     * Цепочка собирается на каждый запрос заново: плагин можно подключить в любой момент,
+     * а обёрток единицы — экономить тут не на чем.
+     *
+     * @param execute настоящий запрос, вызывается самой внутренней обёрткой
+     */
+    run(request: RawRequestOptions, execute: (request: RawRequestOptions) => Promise<unknown>): Promise<unknown>;
+}
+
+/** Событие потока уведомлений после разбора. */
+interface NotificationEvent {
+    /** Само уведомление в единой форме. */
+    notification: Notification;
+    /**
+     * Актуальное число непрочитанных, если сервер его сообщил.
+     *
+     * Клиент не увеличивает счётчик сам: значение приходит с сервера.
+     */
+    unreadCount: number | undefined;
+    /** Нужно ли проиграть звук. */
+    sound: boolean;
+}
+/**
+ * Приводит уведомление к единой форме.
+ *
+ * Нужна потому, что REST-список и поток событий описывают одно и то же событие по-разному:
+ * различаются имена типов (`like` против `post_reaction`), имена полей
+ * (`targetId`/`entityId`, `read`/`isRead`, `preview`/`entityPreview`) и число участников
+ * (`actor` против массива `actors`). После приведения объекты из обоих источников
+ * можно складывать в один список.
+ *
+ * Исходные данные не теряются: имя типа с сервера остаётся в `rawType`,
+ * весь объект целиком — в `raw`.
+ *
+ * @param input уведомление из REST-ответа либо полезная нагрузка события потока
+ *
+ * @example
+ * ```ts
+ * const fromRest = normalizeNotification(restItem);
+ * const fromStream = normalizeNotification(event.payload);
+ * // одинаковая форма — можно объединять
+ * ```
+ */
+declare function normalizeNotification(input: unknown): Notification;
+/**
+ * Разбирает событие `notification` из потока.
+ *
+ * Кроме самого уведомления событие несёт служебные поля уровня конверта: актуальный
+ * счётчик непрочитанных и признак звука.
+ */
+declare function readNotificationEvent(data: unknown): NotificationEvent;
+/**
+ * Разбирает событие `unread_count` из потока.
+ *
+ * Возвращает `undefined`, если сервер прислал событие без вложенного `payload`.
+ * Официальный клиент в этом случае **обнуляет** счётчик — это ошибка, из-за которой
+ * непрочитанные пропадают из интерфейса.
+ */
+declare function readUnreadCountEvent(data: unknown): number | undefined;
+
+/**
+ * Паузы перед попытками переподключения, мс.
+ *
+ * Значения совпадают с теми, что использует сайт итд.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;
     /** Предел числа попыток. */
@@ -2167,6 +2154,8 @@ interface RealtimeDeps {
     refresh: () => Promise<boolean>;
     /** Загружает начальное число непрочитанных. */
     fetchUnreadCount: () => Promise<number>;
+    /** Вызывается при явном закрытии потока. */
+    onClose?: (() => void) | undefined;
     logger?: Logger | undefined;
 }
 /**
@@ -2215,6 +2204,45 @@ declare class ItdRealtime {
     removeAllListeners(): void;
 }
 
+/** Что нужно фасаду для работы. */
+interface HttpClientDeps {
+    /** Готовый обработчик — вся цепочка слоёв поверх транспорта. */
+    handler: RequestHandler;
+    /** Реестр плагинов: у него ресурсы спрашивают имена заявленных опций. */
+    plugins: PluginRegistry;
+    baseUrl: string;
+}
+/**
+ * Точка входа ресурсов в конвейер запросов.
+ *
+ * Принимает готовый обработчик — цепочку слоёв поверх транспорта, собранную
+ * в {@link ItdClient}, — и отдаёт ресурсам метод `request` и имена опций плагинов.
+ * О слоях и их порядке ресурсы не знают.
+ */
+declare class HttpClient {
+    #private;
+    constructor(deps: HttpClientDeps);
+    /** Базовый URL, к которому обращается клиент. */
+    get baseUrl(): string;
+    /**
+     * Имена опций запроса, заявленные плагинами.
+     *
+     * Читается ресурсами: они переносят в транспорт только известные поля, а чужие,
+     * если их никто не заявил, отсеивают.
+     */
+    get pluginOptionKeys(): ReadonlySet<string>;
+    /**
+     * Выполняет запрос к API через собранный конвейер.
+     *
+     * @typeParam T ожидаемая форма ответа после снятия обёртки `{ data: … }`
+     * @throws {ItdApiError} если сервер ответил статусом ≥ 400
+     * @throws {ItdTimeoutError} если истёк таймаут
+     * @throws {ItdAbortError} если запрос отменён через `signal`
+     * @throws {ItdNetworkError} если запрос не дошёл до сервера
+     */
+    request<T = unknown>(options: RawRequestOptions): Promise<T>;
+}
+
 /**
  * Страница списка — единая форма для всех трёх схем пагинации API.
  *
@@ -2337,17 +2365,50 @@ declare class Paginator<T> implements AsyncIterable<T> {
     collect(max?: number): Promise<T[]>;
 }
 
+/** Параметры перебираемого списка: опции запроса плюс предел числа страниц. */
+interface ListParams extends RequestOptions {
+    /** Ограничение числа страниц при переборе. */
+    maxPages?: number | undefined;
+}
+/**
+ * Описание перебираемого эндпоинта.
+ *
+ * Одно место, где заданы путь, параметры запроса, чтение страницы и схема пагинации.
+ * {@link BaseResource.paginated} строит из него и разовую загрузку, и перебор.
+ *
+ * @typeParam T тип элемента списка
+ * @typeParam P тип параметров метода
+ */
+interface ListingSpec<T, P extends ListParams> {
+    /** Путь эндпоинта. */
+    path: (params: P) => string;
+    /** Параметры запроса без полей пагинации — их добавит перебор. */
+    query: (params: P) => QueryParams;
+    /** Читает страницу из ответа. Получает позицию — она нужна схеме со смещением. */
+    read: (body: unknown, state: PageState) => Page<T>;
+    /** Схема пагинации эндпоинта. */
+    mode: PaginationMode;
+    /** Начальная позиция, вычисленная из параметров (курсор, номер или смещение). */
+    start: (params: P) => PageState;
+}
+/** Пара методов, собранная из {@link ListingSpec}: разовая загрузка и перебор. */
+interface Listing<T, P extends ListParams> {
+    /** Загружает одну страницу с позиции, заданной параметрами. */
+    list(params: P): Promise<Page<T>>;
+    /** Перебирает страницы, сама подставляя позиции. */
+    iterate(params: P): Paginator<T>;
+}
 /** Общая основа всех групп методов клиента. */
 declare class BaseResource {
     /** @internal */
     protected readonly http: HttpClient;
     constructor(http: HttpClient);
     /**
-     * Переносит общие поля опций запроса в параметры транспорта.
+     * Переносит опции запроса в описание транспорта.
      *
-     * Поля перечислены поимённо, а не скопированы целиком: параметры методов наследуют
-     * {@link RequestOptions} и приносят с собой `limit`, `cursor` и прочее, чему в описании
-     * запроса делать нечего. Исключение — опции, заявленные плагинами: их библиотека
+     * Копируются только поля {@link REQUEST_OPTION_KEYS} и опции, заявленные плагинами:
+     * параметры методов наследуют {@link RequestOptions} и приносят с собой `limit`, `cursor`
+     * и прочее, чему в описании запроса делать нечего. Чужие опции плагинов библиотека
      * не понимает, но обязана донести до обёрток нетронутыми.
      */
     protected requestOptions(options: RequestOptions | undefined): Partial<RequestOptions>;
@@ -2362,6 +2423,24 @@ declare class BaseResource {
         maxPages?: number;
         start?: PageState;
     }): Paginator<T>;
+    /**
+     * Собирает пару «загрузка страницы + перебор» из одного описания.
+     *
+     * Путь, параметры запроса и разбор ответа задаются один раз; `list` и `iterate`
+     * строятся из них.
+     *
+     * @example
+     * ```ts
+     * #feed = this.paginated<Post, FeedParams>({
+     *   path: () => '/api/posts',
+     *   query: (p) => ({ tab: p.tab, limit: p.limit }),
+     *   start: (p) => (p.cursor ? { cursor: p.cursor } : {}),
+     *   read: (body) => readCursorPage<Post>(body, 'posts'),
+     *   mode: PaginationMode.Cursor,
+     * });
+     * ```
+     */
+    protected paginated<T, P extends ListParams>(spec: ListingSpec<T, P>): Listing<T, P>;
 }
 
 /** Учётные данные для входа. */
@@ -2662,16 +2741,13 @@ type FileReader = (path: string) => Promise<{
  */
 declare class FilesResource extends BaseResource {
     #private;
+    /**
+     * @param deps.readFile чтение файлов с диска. Передаёт точка входа `itd-api/node`;
+     * в основном бандле его нет, чтобы браузерные сборщики не пытались разрешить `node:fs`.
+     */
     constructor(http: HttpClient, deps?: {
         readFile?: FileReader;
     });
-    /**
-     * Подключает чтение файлов с диска.
-     *
-     * Вызывается точкой входа `itd-api/node`; в основном бандле работы с файловой
-     * системой нет, чтобы браузерные сборщики не пытались разрешить `node:fs`.
-     */
-    setFileReader(readFile: FileReader): void;
     /**
      * Загружает файл и возвращает его идентификатор.
      *
@@ -2715,17 +2791,13 @@ interface HashtagPostsParams extends RequestOptions {
     cursor?: string;
     maxPages?: number;
 }
-/** Результат глобального поиска. */
-interface SearchResult {
-    users: UserSummary[];
-    hashtags: Hashtag[];
-}
 /**
  * Хэштеги.
  *
  * Доступна как `itd.hashtags`.
  */
 declare class HashtagsResource extends BaseResource {
+    #private;
     /**
      * Ищет хэштеги.
      *
@@ -2748,139 +2820,6 @@ declare class HashtagsResource extends BaseResource {
     /** Перебирает посты по хэштегу. */
     iteratePosts(tag: string, params?: HashtagPostsParams): Paginator<Post>;
 }
-/**
- * Глобальный поиск.
- *
- * Доступна как `itd.search`.
- */
-declare class SearchResource extends BaseResource {
-    /**
-     * Ищет пользователей и хэштеги одним запросом.
-     *
-     * @example
-     * ```ts
-     * const { users, hashtags } = await itd.search.all('арт');
-     * ```
-     */
-    all(query: string, options?: RequestOptions): Promise<SearchResult>;
-}
-/**
- * Жалобы на контент и пользователей.
- *
- * Доступна как `itd.reports`.
- */
-declare class ReportsResource extends BaseResource {
-    /**
-     * Отправляет жалобу.
-     *
-     * Повторная жалоба на тот же объект отклоняется сервером с сообщением
-     * «Вы уже отправляли жалобу на этот контент».
-     *
-     * @example
-     * ```ts
-     * await itd.reports.create(report.post(postId).reason('spam'));
-     * await itd.reports.create({ targetType: 'user', targetId, reason: 'fraud' });
-     * ```
-     */
-    create(input: ReportInput, options?: RequestOptions): Promise<Report>;
-}
-/**
- * Верификация профиля.
- *
- * Доступна как `itd.verification`.
- */
-declare class VerificationResource extends BaseResource {
-    /** Загружает статус заявки. Значение `none` означает, что заявка не подавалась. */
-    status(options?: RequestOptions): Promise<VerificationStatus>;
-    /** Подаёт заявку на верификацию с видео. */
-    submit(videoUrl: string, options?: RequestOptions): Promise<unknown>;
-}
-/**
- * Подписка и способы оплаты.
- *
- * Доступна как `itd.subscription`.
- */
-declare class SubscriptionResource extends BaseResource {
-    /** Загружает состояние подписки и её цену. */
-    status(options?: RequestOptions): Promise<Subscription>;
-    /**
-     * Запускает оплату подписки.
-     *
-     * Форма ответа в документации API не описана, поэтому тип результата не уточняется.
-     */
-    pay(options?: RequestOptions): Promise<unknown>;
-    /** Включает или отключает автопродление. */
-    setAutoRenewal(enabled: boolean, options?: RequestOptions): Promise<unknown>;
-    /** Запускает привязку карты. */
-    bindCard(options?: RequestOptions): Promise<unknown>;
-    /** Загружает список способов оплаты. Пустой массив, если карт нет. */
-    methods(options?: RequestOptions): Promise<PaymentMethod[]>;
-    /** Делает способ оплаты основным. */
-    setDefaultMethod(methodId: string, options?: RequestOptions): Promise<unknown>;
-    /** Удаляет способ оплаты. */
-    removeMethod(methodId: string, options?: RequestOptions): Promise<void>;
-}
-/**
- * Сведения о платформе: изменения, анонсы, баннер события.
- *
- * Доступна как `itd.platform`.
- */
-declare class PlatformResource extends BaseResource {
-    /** Загружает журнал изменений. */
-    changelog(options?: RequestOptions): Promise<ChangelogEntry[]>;
-    /** Загружает анонсы платформы. */
-    announcements(options?: RequestOptions): Promise<Announcement[]>;
-    /** Загружает баннер текущего события — виджет «портал». */
-    portal(options?: RequestOptions): Promise<Portal>;
-}
-/** Запись о времени просмотра поста. */
-interface DwellEntry {
-    /** Идентификатор поста. */
-    postId: string;
-    /** Сколько миллисекунд пост был виден. */
-    duration: number;
-    /** Служебная метка показа из поля `vs` объекта поста. */
-    vs?: string;
-}
-/** Запись о взаимодействии с контентом. */
-interface InteractionEntry {
-    /** Тип взаимодействия: `photo_open`, `video_progress` и подобные. */
-    type: string;
-    /** Значение, смысл которого зависит от типа: доля просмотра, номер кадра. */
-    value?: number;
-    /** Идентификатор поста. */
-    postId?: string;
-    /** Идентификатор вложения. */
-    attachmentId?: string;
-    /** Служебная метка показа. */
-    vs?: string;
-}
-/**
- * Телеметрия просмотров.
- *
- * @experimental Эндпоинты `/api/v1/i` и `/api/v1/x` нигде не описаны, а схема их полей
- * не проверена на реальных запросах и может измениться без предупреждения.
- *
- * **Библиотека никогда не отправляет телеметрию сама.** Эти методы нужны только тем,
- * кто пишет собственный клиент платформы; всем остальным их вызывать не требуется.
- *
- * Доступна как `itd.telemetry`.
- */
-declare class TelemetryResource extends BaseResource {
-    /**
-     * Отправляет время просмотра постов.
-     *
-     * @experimental Имена полей на проводе сжаты (`ai`, `v`, `s`), и их соответствие
-     * смыслу **не проверено** на реальных запросах. Может измениться без предупреждения.
-     */
-    dwell(entries: DwellEntry[], options?: RequestOptions): Promise<unknown>;
-    /**
-     * Отправляет события взаимодействия с контентом.
-     *
-     * @experimental См. предупреждение у {@link TelemetryResource}.
-     */
-    interaction(entries: InteractionEntry[], options?: RequestOptions): Promise<unknown>;
-}
 
 /** Параметры запроса списка уведомлений. */
 interface NotificationListParams extends RequestOptions {
@@ -2902,8 +2841,7 @@ declare class NotificationsResource extends BaseResource {
     /**
      * Загружает страницу уведомлений.
      *
-     * Пагинация здесь основана на смещении. Сайт итд.com оборачивает смещение в строку
-     * и притворяется, что это курсор; библиотека отдаёт честное число.
+     * Пагинация здесь основана на смещении.
      *
      * @example
      * ```ts
@@ -2953,6 +2891,20 @@ declare class NotificationsResource extends BaseResource {
     updateSettings(input: UpdateNotificationSettingsInput, options?: RequestOptions): Promise<NotificationSettings>;
 }
 
+/**
+ * Сведения о платформе: изменения, анонсы, баннер события.
+ *
+ * Доступна как `itd.platform`.
+ */
+declare class PlatformResource extends BaseResource {
+    /** Загружает журнал изменений. */
+    changelog(options?: RequestOptions): Promise<ChangelogEntry[]>;
+    /** Загружает анонсы платформы. */
+    announcements(options?: RequestOptions): Promise<Announcement[]>;
+    /** Загружает баннер текущего события — виджет «портал». */
+    portal(options?: RequestOptions): Promise<Portal>;
+}
+
 /** Параметры запроса ленты. */
 interface FeedParams extends RequestOptions {
     /** Вкладка ленты. По умолчанию сервер отдаёт популярное. */
@@ -3121,6 +3073,165 @@ declare class PostsResource extends BaseResource {
     voiceComment(postId: string, audio: FileInput, options?: RequestOptions): Promise<Comment>;
 }
 
+/**
+ * Жалобы на контент и пользователей.
+ *
+ * Доступна как `itd.reports`.
+ */
+declare class ReportsResource extends BaseResource {
+    /**
+     * Отправляет жалобу.
+     *
+     * Повторная жалоба на тот же объект отклоняется сервером с сообщением
+     * «Вы уже отправляли жалобу на этот контент».
+     *
+     * @example
+     * ```ts
+     * await itd.reports.create(report.post(postId).reason('spam'));
+     * await itd.reports.create({ targetType: 'user', targetId, reason: 'fraud' });
+     * ```
+     */
+    create(input: ReportInput, options?: RequestOptions): Promise<Report>;
+}
+
+/** Результат глобального поиска. */
+interface SearchResult {
+    users: UserSummary[];
+    hashtags: Hashtag[];
+}
+/**
+ * Глобальный поиск.
+ *
+ * Доступна как `itd.search`.
+ */
+declare class SearchResource extends BaseResource {
+    /**
+     * Ищет пользователей и хэштеги одним запросом.
+     *
+     * @example
+     * ```ts
+     * const { users, hashtags } = await itd.search.all('арт');
+     * ```
+     */
+    all(query: string, options?: RequestOptions): Promise<SearchResult>;
+}
+
+/**
+ * Подписка и способы оплаты.
+ *
+ * Доступна как `itd.subscription`.
+ */
+declare class SubscriptionResource extends BaseResource {
+    /** Загружает состояние подписки и её цену. */
+    status(options?: RequestOptions): Promise<Subscription>;
+    /**
+     * Запускает оплату подписки.
+     *
+     * Форма ответа в документации API не описана, поэтому тип результата не уточняется.
+     */
+    pay(options?: RequestOptions): Promise<unknown>;
+    /** Включает или отключает автопродление. */
+    setAutoRenewal(enabled: boolean, options?: RequestOptions): Promise<unknown>;
+    /** Запускает привязку карты. */
+    bindCard(options?: RequestOptions): Promise<unknown>;
+    /** Загружает список способов оплаты. Пустой массив, если карт нет. */
+    methods(options?: RequestOptions): Promise<PaymentMethod[]>;
+    /** Делает способ оплаты основным. */
+    setDefaultMethod(methodId: string, options?: RequestOptions): Promise<unknown>;
+    /** Удаляет способ оплаты. */
+    removeMethod(methodId: string, options?: RequestOptions): Promise<void>;
+}
+
+/**
+ * Общие опции запроса телеметрии.
+ *
+ * Помимо {@link RequestOptions} позволяет задать `sid` — идентификатор сессии телеметрии.
+ * По умолчанию он заводится один на объект {@link TelemetryResource}.
+ */
+interface TelemetryOptions extends RequestOptions {
+    /** Переопределяет идентификатор сессии телеметрии (`sid`) для этого запроса. */
+    sid?: string;
+}
+/**
+ * Событие просмотра поста для {@link TelemetryResource.dwell}.
+ *
+ * Пост определяется меткой показа `vs` и, при наличии, контекстом источника `sc`; поля
+ * `postId` эндпоинт `/api/v1/i` не принимает.
+ */
+interface DwellEntry {
+    /** Метка показа — поле `vs` объекта поста. Уходит в поле `v`. */
+    vs: string;
+    /** Время появления поста в зоне видимости, epoch-мс. Поле `et`. */
+    enterAt: number;
+    /** Время ухода из зоны видимости, epoch-мс. Поле `xt`. */
+    exitAt: number;
+    /** Причина завершения просмотра. Поле `r`. */
+    reason: ViewReason;
+    /**
+     * Длительность просмотра в мс. Поле `md`.
+     *
+     * Если не задано, вычисляется как `exitAt − enterAt`.
+     */
+    durationMs?: number;
+    /** Контекст источника показа. Поле `sc`. */
+    sourceContext?: string;
+    /** Источник показа. Применим к `PostPage`/`Link`. Поле `s`. */
+    source?: ViewSource;
+    /** Повторный просмотр: пост уже встречался в этой сессии. Уходит как `b: 1`. */
+    repeat?: boolean;
+}
+/** Событие взаимодействия с контентом для {@link TelemetryResource.interaction}. */
+interface InteractionEntry {
+    /** Тип взаимодействия. Поле `t`. */
+    type: InteractionType;
+    /** Метка показа — поле `vs` объекта поста. Поле `v`. */
+    vs: string;
+    /** Идентификатор поста. Поле `ai`. */
+    postId: string;
+    /** Индекс вложения (с нуля) — для {@link InteractionType.PhotoOpen}. Поле `mi`. */
+    mediaIndex?: number;
+    /** Источник показа. Поле `s`. */
+    source?: ViewSource;
+    /** Просмотрено мс — для {@link InteractionType.VideoProgress}. Поле `pm`. */
+    positionMs?: number;
+    /** Длительность видео в мс — для {@link InteractionType.VideoProgress}. Поле `dm`. */
+    durationMs?: number;
+}
+/**
+ * Телеметрия просмотров.
+ *
+ * @experimental Недокументированные эндпоинты `/api/v1/i` (просмотры) и `/api/v1/x`
+ * (взаимодействия); формат полей может измениться без предупреждения.
+ *
+ * Методы не вызываются автоматически — телеметрия отправляется только явным вызовом.
+ *
+ * Оба эндпоинта принимают конверт `{ sid, e }`, где `sid` — идентификатор сессии
+ * телеметрии: по умолчанию один на объект, переопределяется опцией `sid`.
+ *
+ * Доступна как `itd.telemetry`.
+ */
+declare class TelemetryResource extends BaseResource {
+    #private;
+    /**
+     * Идентификатор сессии телеметрии (`sid`).
+     *
+     * Создаётся лениво при первом обращении и далее неизменен.
+     */
+    get sessionId(): string;
+    /**
+     * Отправляет события просмотра постов (`POST /api/v1/i`).
+     *
+     * @experimental См. предупреждение у {@link TelemetryResource}.
+     */
+    dwell(entries: DwellEntry[], options?: TelemetryOptions): Promise<unknown>;
+    /**
+     * Отправляет события взаимодействия с контентом (`POST /api/v1/x`).
+     *
+     * @experimental См. предупреждение у {@link TelemetryResource}.
+     */
+    interaction(entries: InteractionEntry[], options?: TelemetryOptions): Promise<unknown>;
+}
+
 /**
  * Параметры списков пользователей.
  *
@@ -3256,6 +3367,34 @@ declare class UsersResource extends BaseResource {
     removePin(options?: RequestOptions): Promise<void>;
 }
 
+/**
+ * Верификация профиля.
+ *
+ * Доступна как `itd.verification`.
+ */
+declare class VerificationResource extends BaseResource {
+    /** Загружает статус заявки. Значение `none` означает, что заявка не подавалась. */
+    status(options?: RequestOptions): Promise<VerificationStatus>;
+    /** Подаёт заявку на верификацию с видео. */
+    submit(videoUrl: string, options?: RequestOptions): Promise<unknown>;
+}
+
+declare global {
+    interface SymbolConstructor {
+        readonly asyncDispose: unique symbol;
+    }
+}
+/**
+ * Скрытые параметры конструктора — не часть публичного API.
+ *
+ * Через них точка входа `itd-api/node` передаёт чтение файлов с диска, не мутируя уже
+ * созданный объект.
+ *
+ * @internal
+ */
+interface ItdClientInternals {
+    fileReader?: FileReader | undefined;
+}
 /**
  * Клиент API итд.com.
  *
@@ -3319,7 +3458,7 @@ declare class ItdClient {
      * @experimental Недокументированные эндпоинты. Библиотека никогда не отправляет их сама.
      */
     readonly telemetry: TelemetryResource;
-    constructor(options?: ItdClientOptions);
+    constructor(options?: ItdClientOptions, internals?: ItdClientInternals);
     /** Базовый URL, к которому обращается клиент. */
     get baseUrl(): string;
     /**
@@ -3386,18 +3525,27 @@ declare class ItdClient {
      * ```
      */
     realtime(options?: RealtimeOptions): ItdRealtime;
-    /** Текущая сессия целиком — чтобы сохранить её самостоятельно. */
-    getSession(): Promise<ItdSession | null>;
-    /** Восстанавливает сохранённую сессию, включая cookie. */
-    setSession(session: ItdSession): Promise<void>;
     /**
-     * Подключает чтение файлов с диска.
+     * Освобождает ресурсы клиента: останавливает очередь запросов (снимает отложенные паузы)
+     * и закрывает все потоки уведомлений, созданные через {@link realtime}.
      *
-     * Вызывается из `itd-api/node`; напрямую обычно не нужно.
+     * После вызова клиентом можно пользоваться снова — новые запросы поднимут всё заново,
+     * но уже созданные потоки останутся закрытыми.
      *
-     * @internal
+     * @example
+     * ```ts
+     * await using itd = new ItdClient({ auth: token });
+     * // …работа…
+     * // close() вызовется сам на выходе из блока
+     * ```
      */
-    setFileReader(readFile: FileReader): void;
+    close(): Promise<void>;
+    /** Позволяет использовать клиент с `await using`. */
+    [Symbol.asyncDispose](): Promise<void>;
+    /** Текущая сессия целиком — чтобы сохранить её самостоятельно. */
+    getSession(): Promise<ItdSession | null>;
+    /** Восстанавливает сохранённую сессию, включая cookie. */
+    setSession(session: ItdSession): Promise<void>;
 }
 /**
  * Создаёт клиент API итд.com.
@@ -3782,4 +3930,4 @@ interface SseTransportOptions {
     idleTimeout?: number;
 }
 
-export { IMAGE_MIME_TYPES as $, ALLOWED_MIME_TYPES as A, type BuilderInput as B, type CaptchaCredentials as C, type CreatePollInput as D, type CreatePostInput as E, type FileReader as F, type CreateReportInput as G, type Credentials as H, type ItdSession as I, type CredentialsAuth as J, DEFAULT_BASE_URL as K, DEFAULT_TIMEOUT as L, DEFAULT_USER_AGENT as M, DEVICE_ID_HEADER as N, DetectedRuntime as O, type DwellEntry as P, type ErrorContextHook as Q, type FeedParams as R, FeedTab as S, type TokenStorage as T, type FileInput as U, FilesResource as V, type FollowResult as W, type ForgotPasswordInput as X, type Hashtag as Y, type HashtagPostsParams as Z, HashtagsResource as _, ItdClient as a, PostsResource as a$, type ImageMimeType as a0, type InteractionEntry as a1, type IsoDate as a2, ItdAbortError as a3, ItdApiError as a4, type ItdApiErrorInit as a5, ItdApiErrorKind as a6, ItdAuthError as a7, type ItdBuilder as a8, ItdConfigError as a9, type Notification as aA, type NotificationEvent as aB, type NotificationListParams as aC, type NotificationSettings as aD, NotificationType as aE, NotificationsResource as aF, OAuthProvider as aG, type Page as aH, type PageState as aI, PaginationMode as aJ, Paginator as aK, type PaymentMethod as aL, type Pin as aM, type PinPostResult as aN, type PinsResult as aO, PlatformResource as aP, type PluginContext as aQ, type Poll as aR, PollBuilder as aS, type PollInput as aT, type PollOption as aU, type PollTransportOptions as aV, type Portal as aW, type Post as aX, PostBuilder as aY, type PostInput as aZ, type PostStats as a_, ItdConflictError as aa, ItdError as ab, ItdErrorCode as ac, ItdErrorKind as ad, type ItdFieldErrors as ae, ItdForbiddenError as af, ItdNetworkError as ag, ItdNotFoundError as ah, ItdPhoneVerificationError as ai, type ItdPlugin as aj, ItdRateLimitError as ak, ItdRealtime as al, ItdServerError as am, ItdTimeoutError as an, ItdValidationError as ao, LIBRARY_VERSION as ap, type LikeResult as aq, LikesVisibility as ar, type Listener as as, LocalStorageTokenStorage as at, type Logger as au, type Loose as av, MAX_RECONNECT_ATTEMPTS as aw, MemoryTokenStorage as ax, type MyProfile as ay, NOTIFICATION_TYPE_ALIASES as az, type ItdClientOptions as b, WallAccess as b$, type PrivacySettings as b0, type Profile as b1, type PublicProfile as b2, RECONNECT_BACKOFF as b3, RECONNECT_JITTER as b4, REFRESH_COOKIE as b5, REFRESH_COOKIE_PATH as b6, type RateLimitOptions as b7, type RawRequestOptions as b8, type RealtimeEvents as b9, SpanType as bA, type SseTransportOptions as bB, type Subscription as bC, SubscriptionResource as bD, type SubscriptionState as bE, TURNSTILE_SITE_KEY as bF, TelemetryResource as bG, type Transformer as bH, type TransportContext as bI, type TransportEvent as bJ, UnauthorizedStreamError as bK, type Unsubscribe as bL, type UpdateNotificationSettingsInput as bM, type UpdatePrivacyInput as bN, type UpdateProfileInput as bO, type UploadOptions as bP, type UploadedFile as bQ, type UserId as bR, type UserListParams as bS, type UserPostsParams as bT, type UserRef as bU, type UserSummary as bV, UsersResource as bW, VIDEO_MIME_TYPES as bX, VerificationResource as bY, type VerificationStatus as bZ, type VideoMimeType as b_, type RealtimeOptions as ba, RealtimeStatus as bb, type RealtimeTransport as bc, RealtimeTransportKind as bd, type ReconnectOptions as be, type RepliesParams as bf, type Report as bg, ReportBuilder as bh, type ReportInput as bi, ReportReason as bj, ReportTargetType as bk, ReportsResource as bl, type RequestContext as bm, type RequestOptions as bn, type ResetPasswordInput as bo, type ResponseContext as bp, type RetryContext as bq, type RetryOptions as br, RuntimeMode as bs, STREAM_PATH as bt, SearchResource as bu, type SearchResult as bv, type Session as bw, type SignInResult as bx, SignInStatus as by, type Span as bz, AUDIO_MIME_TYPES as c, canonicalNotificationType as c0, comment as c1, createTokenStorage as c2, formatNotificationText as c3, isBuilder as c4, isItdApiError as c5, isItdAuthError as c6, isItdConflictError as c7, isItdError as c8, isItdForbiddenError as c9, isItdNotFoundError as ca, isItdPhoneVerificationError as cb, isItdRateLimitError as cc, isItdServerError as cd, isItdValidationError as ce, isKnownNotificationType as cf, isMyProfile as cg, normalizeNotification as ch, poll as ci, post as cj, readNotificationEvent as ck, readUnreadCountEvent as cl, report as cm, resolveNotificationUrl as cn, toDate as co, createClient as cp, AUTH_FLAG_COOKIE as d, AUTH_PATHS as e, type Actor as f, type AllowedMimeType as g, type Announcement as h, type AnnouncementButton as i, type Attachment as j, AttachmentType as k, type AudioMimeType as l, type AuthInput as m, AuthResource as n, type Author as o, type ChangelogEntry as p, type Clan as q, type ClientHooks as r, type Comment as s, CommentBuilder as t, type CommentInput as u, type CommentReplyTo as v, CommentSort as w, type CommentsParams as x, CommentsResource as y, type CreateCommentInput as z };
+export { HashtagsResource as $, ALLOWED_MIME_TYPES as A, type BuilderInput as B, type CaptchaCredentials as C, type CreateCommentInput as D, type CreatePollInput as E, type FileReader as F, type CreatePostInput as G, type CreateReportInput as H, type ItdSession as I, type Credentials as J, type CredentialsAuth as K, DEFAULT_BASE_URL as L, DEFAULT_TIMEOUT as M, DEFAULT_USER_AGENT as N, DEVICE_ID_HEADER as O, DetectedRuntime as P, type DwellEntry as Q, type ErrorContextHook as R, type FeedParams as S, type TokenStorage as T, FeedTab as U, type FileInput as V, FilesResource as W, type FollowResult as X, type ForgotPasswordInput as Y, type Hashtag as Z, type HashtagPostsParams as _, ItdClient as a, type PostInput as a$, IMAGE_MIME_TYPES as a0, type ImageMimeType as a1, type InteractionEntry as a2, InteractionType as a3, type IsoDate as a4, ItdAbortError as a5, ItdApiError as a6, type ItdApiErrorInit as a7, ItdApiErrorKind as a8, ItdAuthError as a9, type MyProfile as aA, NOTIFICATION_TYPE_ALIASES as aB, type Notification as aC, type NotificationEvent as aD, type NotificationListParams as aE, type NotificationSettings as aF, NotificationType as aG, NotificationsResource as aH, OAuthProvider as aI, type Page as aJ, type PageState as aK, PaginationMode as aL, Paginator as aM, type PaymentMethod as aN, type Pin as aO, type PinPostResult as aP, type PinsResult as aQ, PlatformResource as aR, type PluginContext as aS, type Poll as aT, PollBuilder as aU, type PollInput as aV, type PollOption as aW, type PollTransportOptions as aX, type Portal as aY, type Post as aZ, PostBuilder as a_, type ItdBuilder as aa, ItdConfigError as ab, ItdConflictError as ac, ItdError as ad, ItdErrorCode as ae, ItdErrorKind as af, type ItdFieldErrors as ag, ItdForbiddenError as ah, ItdNetworkError as ai, ItdNotFoundError as aj, ItdPhoneVerificationError as ak, type ItdPlugin as al, ItdRateLimitError as am, ItdRealtime as an, ItdServerError as ao, ItdTimeoutError as ap, ItdValidationError as aq, LIBRARY_VERSION as ar, type LikeResult as as, LikesVisibility as at, type Listener as au, LocalStorageTokenStorage as av, type Logger as aw, type Loose as ax, MAX_RECONNECT_ATTEMPTS as ay, MemoryTokenStorage as az, type ItdClientOptions as b, VerificationResource as b$, type PostStats as b0, PostsResource as b1, type PrivacySettings as b2, type Profile as b3, type PublicProfile as b4, RECONNECT_BACKOFF as b5, RECONNECT_JITTER as b6, REFRESH_COOKIE as b7, REFRESH_COOKIE_PATH as b8, type RateLimitOptions as b9, SignInStatus as bA, type Span as bB, SpanType as bC, type SseTransportOptions as bD, type Subscription as bE, SubscriptionResource as bF, type SubscriptionState as bG, TURNSTILE_SITE_KEY as bH, type TelemetryOptions as bI, TelemetryResource as bJ, type Transformer as bK, type TransportContext as bL, type TransportEvent as bM, UnauthorizedStreamError as bN, type Unsubscribe as bO, type UpdateNotificationSettingsInput as bP, type UpdatePrivacyInput as bQ, type UpdateProfileInput as bR, type UploadOptions as bS, type UploadedFile as bT, type UserId as bU, type UserListParams as bV, type UserPostsParams as bW, type UserRef as bX, type UserSummary as bY, UsersResource as bZ, VIDEO_MIME_TYPES as b_, type RawRequestOptions as ba, type RealtimeEvents as bb, type RealtimeOptions as bc, RealtimeStatus as bd, type RealtimeTransport as be, RealtimeTransportKind as bf, type ReconnectOptions as bg, type RepliesParams as bh, type Report as bi, ReportBuilder as bj, type ReportInput as bk, ReportReason as bl, ReportTargetType as bm, ReportsResource as bn, type RequestContext as bo, type RequestOptions as bp, type ResetPasswordInput as bq, type ResponseContext as br, type RetryContext as bs, type RetryOptions as bt, RuntimeMode as bu, STREAM_PATH as bv, SearchResource as bw, type SearchResult as bx, type Session as by, type SignInResult as bz, AUDIO_MIME_TYPES as c, type VerificationStatus as c0, type VideoMimeType as c1, ViewReason as c2, ViewSource as c3, WallAccess as c4, canonicalNotificationType as c5, comment as c6, createTokenStorage as c7, formatNotificationText as c8, isBuilder as c9, isItdApiError as ca, isItdAuthError as cb, isItdConflictError as cc, isItdError as cd, isItdForbiddenError as ce, isItdNotFoundError as cf, isItdPhoneVerificationError as cg, isItdRateLimitError as ch, isItdServerError as ci, isItdValidationError as cj, isKnownNotificationType as ck, isMyProfile as cl, normalizeNotification as cm, poll as cn, post as co, readNotificationEvent as cp, readUnreadCountEvent as cq, report as cr, resolveNotificationUrl as cs, toDate as ct, createClient as cu, AUTH_FLAG_COOKIE as d, AUTH_PATHS as e, AccessType as f, type Actor as g, type AllowedMimeType as h, type Announcement as i, type AnnouncementButton as j, type Attachment as k, AttachmentType as l, type AudioMimeType as m, type AuthInput as n, AuthResource as o, type Author as p, type ChangelogEntry as q, type Clan as r, type ClientHooks as s, type Comment as t, CommentBuilder as u, type CommentInput as v, type CommentReplyTo as w, CommentSort as x, type CommentsParams as y, CommentsResource as z };