itd-api 0.0.7 → 0.0.8

package/dist/{index-DNFPX_Z1.d.cts → index-Duh31Wnx.d.cts}

@@ -1513,7 +1513,7 @@ interface RequestOptions {
     timeout?: number | undefined;
     /** Дополнительные заголовки. */
     headers?: Record<string, string> | undefined;
-    /** Повторы только для этого запроса. */
+    /** Повторы только для этого запроса. Переопределяют глобальную настройку `retry`. */
     retry?: RetryOptions | false | undefined;
 }
 /** Полное описание запроса для низкоуровневого `itd.request()`. */
@@ -1540,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.7";
+
 /**
  * `User-Agent` по умолчанию.
  *
@@ -1558,51 +1558,22 @@ declare const LIBRARY_VERSION = "0.0.7";
  * В браузере заголовок не выставляется — `User-Agent` там запрещён к изменению, и среда
  * молча его игнорирует.
  */
-declare const DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; itd-api/0.0.7; +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-токеном. */
@@ -1719,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: {
@@ -1953,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'];
     /** Подписка на одно срабатывание. */
@@ -2015,6 +1827,108 @@ declare class AuthManager {
     clear(): Promise<void>;
 }
 
+/**
+ * Обёртка вокруг запроса.
+ *
+ * Получает описание запроса и продолжение цепочки. Может изменить запрос перед отправкой,
+ * посмотреть и подменить разобранный ответ или вовсе не вызывать `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>;
+}
+
 /** Событие потока уведомлений после разбора. */
 interface NotificationEvent {
     /** Само уведомление в единой форме. */
@@ -2240,6 +2154,8 @@ interface RealtimeDeps {
     refresh: () => Promise<boolean>;
     /** Загружает начальное число непрочитанных. */
     fetchUnreadCount: () => Promise<number>;
+    /** Вызывается при явном закрытии потока. */
+    onClose?: (() => void) | undefined;
     logger?: Logger | undefined;
 }
 /**
@@ -2288,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.
  *
@@ -2410,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>;
@@ -2435,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>;
 }
 
 /** Учётные данные для входа. */
@@ -2735,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;
     /**
      * Загружает файл и возвращает его идентификатор.
      *
@@ -2788,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;
     /**
      * Ищет хэштеги.
      *
@@ -2821,91 +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 NotificationListParams extends RequestOptions {
@@ -2927,8 +2841,7 @@ declare class NotificationsResource extends BaseResource {
     /**
      * Загружает страницу уведомлений.
      *
-     * Пагинация здесь основана на смещении. Сайт итд.com оборачивает смещение в строку
-     * и притворяется, что это курсор; библиотека отдаёт честное число.
+     * Пагинация здесь основана на смещении.
      *
      * @example
      * ```ts
@@ -2978,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 {
     /** Вкладка ленты. По умолчанию сервер отдаёт популярное. */
@@ -3146,6 +3073,75 @@ 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>;
+}
+
 /**
  * Общие опции запроса телеметрии.
  *
@@ -3371,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.
  *
@@ -3434,7 +3458,7 @@ declare class ItdClient {
      * @experimental Недокументированные эндпоинты. Библиотека никогда не отправляет их сама.
      */
     readonly telemetry: TelemetryResource;
-    constructor(options?: ItdClientOptions);
+    constructor(options?: ItdClientOptions, internals?: ItdClientInternals);
     /** Базовый URL, к которому обращается клиент. */
     get baseUrl(): string;
     /**
@@ -3501,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.