itd-api 0.4.0 → 0.5.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, 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";
+import { _ as withNamespace, a as createTokenStorage, c as KeyValueStore, d as MemoryKeyValueStore, f as RecordKeyValueStoreSource, g as withCodec, h as isEnumerableKeyValueStore, i as TokenStorageAdapterOptions, l as KeyValueStoreKeys, m as createRecordKeyValueStore, n as MemoryTokenStorage, o as EnumerableKeyValueStore, p as createKeyValueStore, r as TokenStorage, s as KeyValueCodec, t as ItdSession, u as KeyValueStoreResult } from "./storage-Doe3lpFQ.cjs";
+import { _ as UrlFile, a as scopedTokenStorage, c as FileContent, d as FileStreamContent, f as FileStreamOptions, g as StreamFile, h as LazyFile, i as createMultiTokenStorage, l as FileContext, m as FromStreamOptions, n as MultiTokenStorage, o as DEFAULT_FILE_STREAM_BUFFER_BYTES, p as FileTransferMode, r as MultiTokenStorageAdapterOptions, s as DEFAULT_URL_FILE_MAX_BYTES, t as MemoryMultiTokenStorage, u as FileInput, v as UrlFileOptions } from "./multi-storage-s_PcWPGH.cjs";
 //#region src/types/enums.d.ts
 /**
  * Перечисления API итд.com.
@@ -388,6 +388,413 @@ interface ItdClock {
 /** Системные часы, используемые клиентом по умолчанию. */
 declare const systemClock: ItdClock;
 //#endregion
+//#region src/core/operations.d.ts
+/** HTTP-метод встроенной операции. */
+type OperationMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+/** Семантическая безопасность автоматического повтора операции. */
+declare const RetrySafety: Readonly<{
+  /** Автоматический повтор не создаёт неприемлемого эффекта; обычно это чтение. */
+  readonly Safe: "safe";
+  /** Повтор операции приводит к тому же состоянию, что и один вызов. */
+  readonly Idempotent: "idempotent";
+  /** Повтор может создать ещё один побочный эффект. */
+  readonly Unsafe: "unsafe";
+}>;
+type RetrySafety = (typeof RetrySafety)[keyof typeof RetrySafety];
+/** Минимальное стабильное описание операции, доступное core и плагинам. */
+interface OperationDefinition {
+  readonly method: OperationMethod;
+  readonly retrySafety: RetrySafety;
+}
+/**
+ * Каталог встроенных операций.
+ *
+ * ID описывает смысл вызова и не меняется при переносе HTTP-пути. Method и retrySafety
+ * хранятся здесь, чтобы resources, retry и плагины не вели независимые таблицы операций.
+ */
+declare const OPERATIONS: Readonly<{
+  readonly 'auth.check': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'auth.signUp': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'auth.signIn': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'auth.verifyOtp': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'auth.resendOtp': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'auth.refresh': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'auth.logout': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'auth.forgotPassword': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'auth.resetPassword': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'auth.changePassword': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'auth.sessions': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'auth.revokeSession': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'auth.revokeOtherSessions': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'users.me': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'users.updateMe': Readonly<{
+    readonly method: "PUT";
+    readonly retrySafety: "idempotent";
+  }>;
+  readonly 'users.deactivate': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'users.restore': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'users.createProfile': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'users.get': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'users.checkUsername': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'users.search': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'users.whoToFollow': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'users.topClans': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'users.follow': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'users.unfollow': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'users.followers': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'users.following': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'users.followStatus': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'users.block': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'users.unblock': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'users.blocked': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'users.getPrivacy': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'users.updatePrivacy': Readonly<{
+    readonly method: "PUT";
+    readonly retrySafety: "idempotent";
+  }>;
+  readonly 'users.pins': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'users.setPin': Readonly<{
+    readonly method: "PUT";
+    readonly retrySafety: "idempotent";
+  }>;
+  readonly 'users.removePin': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'posts.list': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'posts.create': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'posts.get': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'posts.update': Readonly<{
+    readonly method: "PUT";
+    readonly retrySafety: "idempotent";
+  }>;
+  readonly 'posts.remove': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'posts.restore': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'posts.like': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'posts.unlike': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'posts.repost': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'posts.unrepost': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'posts.pin': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'posts.unpin': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'posts.vote': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'posts.stats': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'posts.byUser': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'posts.likedByUser': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'posts.comments': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'posts.comment': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'comments.replies': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'comments.reply': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'comments.update': Readonly<{
+    readonly method: "PATCH";
+    readonly retrySafety: "idempotent";
+  }>;
+  readonly 'comments.remove': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'comments.restore': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'comments.like': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'comments.unlike': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'files.upload': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'files.get': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'files.remove': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'notifications.list': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'notifications.count': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'notifications.markRead': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "idempotent";
+  }>;
+  readonly 'notifications.markReadBatch': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "idempotent";
+  }>;
+  readonly 'notifications.markAllRead': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "idempotent";
+  }>;
+  readonly 'notifications.getSettings': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'notifications.updateSettings': Readonly<{
+    readonly method: "PUT";
+    readonly retrySafety: "idempotent";
+  }>;
+  readonly 'hashtags.search': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'hashtags.trending': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'hashtags.posts': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'search.all': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'reports.create': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'subscription.status': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'subscription.pay': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'subscription.setAutoRenewal': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "idempotent";
+  }>;
+  readonly 'subscription.bindCard': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'subscription.methods': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'subscription.setDefaultMethod': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "idempotent";
+  }>;
+  readonly 'subscription.removeMethod': Readonly<{
+    readonly method: "DELETE";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'verification.status': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'verification.submit': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'platform.version': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'platform.changelog': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'platform.announcements': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'platform.portal': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'platform.status': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'telemetry.dwell': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+  readonly 'telemetry.interaction': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+  }>;
+}>;
+/** Стабильный ID встроенной операции. */
+type BuiltInOperationId = keyof typeof OPERATIONS;
+/** Пользовательская семантическая операция низкоуровневого запроса. */
+type CustomOperationId = `custom:${string}`;
+/** ID любого запроса, видимый transformers и hooks. */
+type OperationId = BuiltInOperationId | CustomOperationId | 'raw';
+/** Проверяет принадлежность ID встроенному каталогу. */
+declare function isBuiltInOperationId(value: string): value is BuiltInOperationId;
+/** HTTP-метод встроенной операции. */
+declare function operationMethod(id: BuiltInOperationId): OperationMethod;
+/** Политика автоматического повтора встроенной операции. */
+declare function operationRetrySafety(id: BuiltInOperationId): RetrySafety;
+//#endregion
 //#region src/core/runtime.d.ts
 /**
  * Как библиотека обращается с cookie.
@@ -538,16 +945,16 @@ interface RetryOptions {
   maxDelay?: number | undefined;
   /** Доля случайного разброса паузы, 0…1. По умолчанию 0.3. */
   jitter?: number | undefined;
-  /**
-   * Повторять ли запись (`POST`, `PUT`, `PATCH`, `DELETE`) при сетевых сбоях и `5xx`.
-   *
-   * По умолчанию `false`: сервер мог успеть выполнить операцию до обрыва, и повтор
-   * создаст дубль поста или лишнюю жалобу. Ответ `429` повторяется всегда — он гарантирует,
-   * что запрос не был обработан.
-   */
-  retryWrites?: boolean | undefined;
-  /** Своя логика: вернуть `true`, чтобы повторить. Заменяет правила по умолчанию. */
-  shouldRetry?: ((error: unknown, attempt: number) => boolean) | undefined;
+  /** Своя логика: вернуть `true`, чтобы повторить. Заменяет семантическое правило операции. */
+  shouldRetry?: ((error: unknown, attempt: number, context: RetryDecisionContext) => boolean) | undefined;
+}
+/** Семантика запроса, доступная пользовательской функции `shouldRetry`. */
+interface RetryDecisionContext {
+  operationId: OperationId;
+  retrySafety: RetrySafety;
+  bodyReplayable: boolean;
+  method: string;
+  path: string;
 }
 /** Настройки ограничения нагрузки на API. */
 interface RateLimitOptions {
@@ -577,6 +984,8 @@ interface RateLimitOptions {
 }
 /** Данные о запросе, доступные хукам. */
 interface RequestContext {
+  /** Стабильная семантическая операция; `raw` у низкоуровневого вызова без явного ID. */
+  operationId: OperationId;
   method: string;
   /** Путь без базового URL, например `/api/posts`. */
   path: string;
@@ -591,6 +1000,7 @@ interface ResponseContext extends RequestContext {
   status: number;
   /** Длительность запроса в мс. */
   duration: number;
+  /** Отдельная копия ответа: её тело можно прочитать, не мешая разбору внутри SDK. */
   response: Response;
 }
 /** Данные об ошибке запроса. */
@@ -638,7 +1048,10 @@ interface ItdClientOptions {
    * Сервисы платформы на отдельных доменах.
    *
    * Ключ — имя сервиса, значение — базовый URL или определение целиком. Имя встроенного
-   * сервиса задаёт его хост. Встроен один: `status` — хост `itd.platform.status()`.
+   * сервиса задаёт его хост; встроен один — `status`.
+   *
+   * `auth` у встроенного сервиса наследуется, у нового выводится по хосту: токен уходит
+   * основному хосту и его поддоменам, остальным — по явному `auth: true`.
    *
    * @example
    * ```ts
@@ -703,7 +1116,14 @@ interface ItdClientOptions {
   /** Как обращаться с cookie. По умолчанию определяется по среде исполнения. */
   mode?: RuntimeMode | undefined;
 }
-/** Опции отдельного запроса. Доступны в каждом методе ресурсов. */
+/**
+ * Namespaces расширений отдельной операции.
+ *
+ * Пакеты дополняют интерфейс через declaration merging и владеют только своим полем.
+ * Core передаёт объект operation transformers без знания его содержимого.
+ */
+interface RequestExtensions {}
+/** Опции выполнения отдельного запроса. Передаются последним аргументом методов ресурсов. */
 interface RequestOptions {
   /** Отмена запроса извне. */
   signal?: AbortSignal | undefined;
@@ -713,23 +1133,28 @@ interface RequestOptions {
   headers?: Record<string, string> | undefined;
   /** Повторы только для этого запроса. Переопределяют глобальную настройку `retry`. */
   retry?: RetryOptions | false | undefined;
+  /**
+   * Явно переопределяет безопасность повтора операции.
+   *
+   * Встроенные resources получают значение из каталога. Опция нужна прежде всего custom/raw
+   * интеграциям и осознанному переопределению серверного контракта.
+   */
+  retrySafety?: RetrySafety | undefined;
+  /** Настройки подключённых operation extensions, сгруппированные по владельцу. */
+  extensions?: RequestExtensions | undefined;
+}
+/** Опции перебора страниц, не являющиеся параметрами endpoint. */
+interface PaginationOptions extends RequestOptions {
+  /** Максимальное число страниц; без значения перебор продолжается до конца списка. */
+  maxPages?: number | undefined;
 }
-/**
- * Имена полей {@link RequestOptions} — единственный источник истины.
- *
- * Ресурсы переносят в описание запроса только эти поля (плюс заявленные плагинами),
- * потому что параметры методов подмешивают к ним `limit`, `cursor` и прочее, чему
- * в транспорте делать нечего. Список стоит рядом с интерфейсом, чтобы новое поле нельзя
- * было забыть.
- *
- * `satisfies` гарантирует, что каждое имя в списке — действительно поле `RequestOptions`.
- * Обратную полноту (не забыто ли новое поле) проверяет тип {@link RequestOptionKeysComplete}
- * в тесте: здесь её проверять нельзя — плагины расширяют `RequestOptions` своими опциями
- * (`encrypt`, `decrypt` и подобными), которых в этом списке быть и не должно.
- */
-declare const REQUEST_OPTION_KEYS: readonly ["signal", "timeout", "headers", "retry"];
 /** Полное описание запроса для низкоуровневого `itd.request()`. */
 interface RawRequestOptions extends RequestOptions {
+  /**
+   * Семантическое имя низкоуровневого запроса. Встроенные resources выставляют его сами.
+   * Пользовательские значения следует помещать в namespace `custom:`.
+   */
+  operationId?: OperationId | undefined;
   method: string;
   /** Путь с ведущим слэшем, например `/api/posts`. Завершающий слэш значим. */
   path: string;
@@ -760,18 +1185,21 @@ interface RawRequestOptions extends RequestOptions {
   /**
    * Выполнить запрос мимо очереди.
    *
-   * Нужно запросам, которые слой авторизации делает **изнутри** другого запроса: продление
-   * токена и отложенный вход. Такой запрос обязан стартовать, пока исходный держит место
-   * в очереди и ждёт его результата, — иначе оба ждут друг друга и не завершатся никогда.
+   * Продвинутый escape hatch для служебных интеграций. Встроенные refresh и sign-in проходят
+   * обычную очередь: она охватывает только одну сетевую попытку и не создаёт deadlock.
    */
   skipQueue?: boolean | undefined;
   /** Вернуть тело ответа без снятия обёртки `{ data: … }`. */
   raw?: boolean | undefined;
 }
+/** Запрос внутри pipeline: в отличие от raw input всегда имеет семантический ID. */
+interface OperationRequestOptions extends RawRequestOptions {
+  operationId: OperationId;
+}
 //#endregion
 //#region src/core/version.d.ts
 /** Версия библиотеки. Попадает в `User-Agent`. */
-declare const LIBRARY_VERSION = "0.4.0";
+declare const LIBRARY_VERSION = "0.5.0";
 //#endregion
 //#region src/core/config.d.ts
 /** Базовый URL API итд.com. Домен записан в punycode: `итд.com`. */
@@ -794,14 +1222,7 @@ declare const DEFAULT_TIMEOUT = 30000;
  * В браузере заголовок не выставляется — `User-Agent` там запрещён к изменению, и среда
  * молча его игнорирует.
  */
-declare const DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; itd-api/0.4.0; +https://github.com/KiowDev/itd-api)";
-/** Настройки очереди со всеми значениями по умолчанию. */
-interface ResolvedRateLimitOptions {
-  concurrency: number;
-  rps: number | undefined;
-  retryDelays: readonly number[];
-  respectHeaders: boolean;
-}
+declare const DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; itd-api/0.5.0; +https://github.com/KiowDev/itd-api)";
 /**
  * Срез конфигурации, нужный слою авторизации.
  *
@@ -959,15 +1380,9 @@ type RequestBodyFactory = (context: RequestBodyContext) => PreparedRequestBody |
  * важнее. Смешивать их в одном объекте нельзя — тогда слой авторизации перебивал бы
  * `Authorization`, заданный вызывающим кодом вручную.
  */
-interface PipelineRequest extends RawRequestOptions {
+interface PipelineRequest extends OperationRequestOptions {
   /** Повторяемое тело. Используется внутренними ресурсами вместо `body`. @internal */
   bodyFactory?: RequestBodyFactory | undefined;
-  /**
-   * Разрешает повтор записи после сетевого сбоя. Тело должно быть повторяемым.
-   *
-   * @internal
-   */
-  retryNetworkWrite?: boolean | undefined;
   /**
    * Заголовки, добавленные слоями конвейера.
    *
@@ -977,12 +1392,16 @@ interface PipelineRequest extends RawRequestOptions {
    */
   layerHeaders?: Record<string, string> | undefined;
   /**
-   * Номер попытки, начиная с 1. Проставляет слой повторов, читают хуки.
+   * Номер фактически начатой транспортной попытки, начиная с 1. Проставляет attempt layer.
    *
    * @internal
    */
   attempt?: number | undefined;
 }
+/** Запрос на внешней границе pipeline. Низкоуровневый вызов без ID считается `raw`. */
+type PipelineRequestInput = Omit<PipelineRequest, 'operationId'> & {
+  operationId?: OperationId | undefined;
+};
 /** Обработчик запроса. Самый внутренний в цепочке — транспорт. */
 type RequestHandler = (request: PipelineRequest) => Promise<unknown>;
 //#endregion
@@ -1060,6 +1479,8 @@ declare class AuthManager {
   get on(): Emitter<AuthEvents>['on'];
   /** Подписка на одно срабатывание. */
   get once(): Emitter<AuthEvents>['once'];
+  /** Снимает lifecycle-подписки при терминальном освобождении владельца. @internal */
+  dispose(): void;
   /**
    * Непрозрачная fallback-область авторизации.
    *
@@ -1084,6 +1505,15 @@ declare class AuthManager {
   hasRefreshSession(): Promise<boolean>;
   /** Заголовки авторизации для очередного запроса. Пустой объект, если токена нет. */
   getAuthHeaders(): Promise<Record<string, string>>;
+  /**
+   * Заголовки уже подготовленной авторизации без чтения storage или вызова внешнего источника.
+   *
+   * Используются после ожидания транспортной очереди: к этому моменту `getAccessToken()` уже
+   * был вызван снаружи неё, но token мог успеть смениться из-за refresh или `setSession()`.
+   *
+   * @internal
+   */
+  getCurrentAuthHeaders(): Record<string, string>;
   /**
    * Идентификатор устройства для заголовка `X-Device-Id`.
    *
@@ -1137,30 +1567,102 @@ declare class AuthManager {
 //#endregion
 //#region src/core/plugins/contracts.d.ts
 /**
- * Обёртка вокруг запроса.
+ * Обёртка одной логической операции.
  *
- * Получает описание запроса и продолжение цепочки. Может изменить запрос перед отправкой,
- * посмотреть и подменить разобранный ответ или вовсе не вызывать `next` и вернуть своё.
+ * Вызывается ровно один раз независимо от retry и auth recovery. Может изменить
+ * семантический запрос, обработать разобранный результат или завершить операцию локально.
  *
- * @param request что уходит на сервер; изменять сам объект не нужно — передайте копию в `next`
- * @param next продолжение: либо следующая обёртка, либо настоящий запрос
- * @returns тело ответа в том виде, в каком его получит вызывающий код
+ * @param request описание логической операции; не изменяйте сам объект — передайте копию в `next`
+ * @param next следующая обёртка либо выполнение операции
+ * @returns разобранный результат в том виде, в котором его получит вызывающий код
  *
- * @example Дописать заголовок ко всем запросам
+ * @example Дописать заголовок ко всем операциям
  * ```ts
- * const transformer: Transformer = (request, next) =>
+ * const transformer: OperationTransformer = (request, next) =>
  *   next({ ...request, headers: { ...request.headers, 'X-Trace': trace() } });
  * ```
  */
-type Transformer = (request: RawRequestOptions, next: (request: RawRequestOptions) => Promise<unknown>) => Promise<unknown>;
-/** Освобождение ресурсов, заведённых плагином при установке. */
+type OperationTransformer = (request: OperationRequestOptions, next: (request: OperationRequestOptions) => Promise<unknown>) => Promise<unknown>;
+/** Финальные данные одной транспортной попытки. */
+interface AttemptContext {
+  /** Стабильная семантическая операция. */
+  readonly operationId: OperationId;
+  /** Нормализованный HTTP-метод. */
+  readonly method: string;
+  /** Исходный путь операции до разрешения service/base URL. */
+  readonly path: string;
+  /** Полностью разрешённый URL со строкой query. */
+  readonly url: string;
+  /** Итоговые заголовки. Сам объект mutable для подписи и diagnostic headers. */
+  readonly headers: Headers;
+  /** Номер transport attempt, начиная с 1. */
+  readonly attempt: number;
+  /** Тело после сериализации либо подготовки body factory. Поток нельзя читать заранее. */
+  readonly body: BodyInit | undefined;
+  /** Общий сигнал отмены и таймаута этой попытки. */
+  readonly signal: AbortSignal;
+}
+/**
+ * Продолжение attempt chain.
+ *
+ * В рамках одного interceptor его можно вызвать только один раз. Возвращает сырой ответ:
+ * transport ещё не проверял status и не читал body.
+ */
+type AttemptNext = () => Promise<Response>;
+/**
+ * Обёртка одной транспортной попытки.
+ *
+ * Получает уже разрешённый URL, итоговые заголовки, подготовленное тело и номер попытки.
+ * Может дописать заголовки, измерить wire latency, обработать сырой `Response` или вернуть
+ * синтетический `Response`. Семантический input здесь намеренно недоступен для изменения.
+ *
+ * Вызывается заново для каждого retry и auth recovery. `next()` разрешено вызвать один раз.
+ * Если interceptor читает тело ответа, читать нужно `response.clone()`: исходный body после
+ * цепочки разбирает transport. Исключение interceptor остаётся пользовательской ошибкой и не
+ * классифицируется как сетевой сбой для автоматического retry.
+ *
+ * @param context окончательные данные текущей транспортной попытки
+ * @param next следующий interceptor либо вызов `fetch`
+ * @returns исходный или синтетический сырой `Response`
+ */
+type AttemptInterceptor = (context: AttemptContext, next: AttemptNext) => Promise<Response>;
+/** Регистрация расширений логической операции. */
+interface OperationExtensions {
+  /**
+   * Подключает transformer.
+   *
+   * Зарегистрированные раньше оборачивают зарегистрированные позже. Возвращённая функция
+   * идемпотентна и снимает только эту регистрацию.
+   */
+  use(transformer: OperationTransformer): Unsubscribe;
+}
+/** Регистрация расширений транспортной попытки. */
+interface AttemptExtensions {
+  /**
+   * Подключает interceptor.
+   *
+   * Зарегистрированные раньше оборачивают зарегистрированные позже. Возвращённая функция
+   * идемпотентна и снимает только эту регистрацию.
+   */
+  use(interceptor: AttemptInterceptor): Unsubscribe;
+}
+/**
+ * Освобождение ресурсов, заведённых плагином при установке.
+ *
+ * Вызывается после завершения логических операций, уже вошедших в расширения плагина,
+ * поэтому может безопасно закрывать используемые ими соединения и хранилища.
+ */
 type PluginTeardown = () => void | Promise<void>;
-/** Что плагин получает при подключении. */
-interface PluginContext {
+/** API, доступный плагину при подключении. */
+interface PluginApi {
   /** Базовый URL клиента — например чтобы разобрать абсолютные ссылки из ответа. */
   baseUrl: string;
   /** Отладочный вывод клиента, если он включён. */
   logger: Logger | undefined;
+  /** Расширения логической операции: выполняются один раз и могут short-circuit сеть. */
+  operations: OperationExtensions;
+  /** Расширения wire attempt: выполняются заново после каждого retry/auth recovery. */
+  attempts: AttemptExtensions;
   /**
    * Непрозрачная fallback-область текущей авторизации.
    *
@@ -1175,29 +1677,25 @@ interface PluginContext {
    * несколькими экземплярами клиента одного аккаунта.
    */
   getAuthIdentity?: (() => Promise<AuthIdentity>) | undefined;
-  /** Добавляет обёртку запроса. Подключённые раньше оказываются снаружи. */
-  use(transformer: Transformer): void;
-  /**
-   * Добавляет перехватчики отдельных сетевых попыток.
-   *
-   * В отличие от {@link use}, они видят каждый retry и сырой `Response` до чтения тела.
-   * Несколько наборов хуков одного плагина вызываются в порядке регистрации.
-   */
-  useHooks(hooks: ClientHooks): void;
 }
 /**
  * Плагин клиента.
  *
- * Подключается через `itd.use(plugin)` и работает на уровне транспорта: видит запрос
- * до отправки и разобранный ответ. Библиотека не знает, что именно делает плагин, —
- * ей достаточно списка обёрток и имён опций, которые он читает.
+ * Подключается через `itd.use(plugin)` и регистрирует расширения одного или обоих уровней:
+ * {@link OperationTransformer} для логической операции и {@link AttemptInterceptor} для
+ * отдельной транспортной попытки. Core взаимодействует с плагином только через эти контракты
+ * и его lifecycle, не зная деталей реализации.
  *
- * @example
+ * Настройки отдельного вызова плагин объявляет своим полем в `RequestExtensions` через
+ * declaration merging. Пользователь передаёт их в `RequestOptions.extensions`, а operation
+ * transformer читает только принадлежащий плагину namespace.
+ *
+ * @example Логирование логических операций
  * ```ts
- * const logging: ItdPlugin = {
+ * const logging: ClientPlugin = {
  *   name: 'logging',
- *   install({ use, logger }) {
- *     use(async (request, next) => {
+ *   install({ operations, logger }) {
+ *     operations.use(async (request, next) => {
  *       logger?.info(`${request.method} ${request.path}`);
  *       return next(request);
  *     });
@@ -1207,94 +1705,25 @@ interface PluginContext {
  * itd.use(logging);
  * ```
  */
-interface ItdPlugin {
+interface ClientPlugin {
   /** Имя плагина. Должно быть уникальным: повторное подключение — ошибка. */
   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;
-}
-//#endregion
-//#region src/core/rate-limit.d.ts
-/**
- * Очередь запросов: ограничивает одновременность и частоту.
- *
- * Нужна прежде всего ботам: без неё цикл по сотне постов уходит в API одним залпом
- * и упирается в `RATE_LIMIT_EXCEEDED`.
- *
- * Частота выдерживается равномерным разносом стартов (`1000 / rps` между запросами),
- * а не окном со счётчиком: так нагрузка ровная, без всплеска в начале каждой секунды.
- *
- * @internal
- */
-declare class RequestQueue {
-  #private;
-  constructor(options: ResolvedRateLimitOptions, clock?: ItdClock);
-  /** Сколько задач выполняется прямо сейчас. */
-  get active(): number;
-  /** Сколько задач ждёт очереди. */
-  get pending(): number;
-  /**
-   * Ставит задачу в очередь.
-   *
-   * @returns результат задачи; ошибка задачи пробрасывается без изменений
-   */
-  schedule<T>(task: () => Promise<T>, signal?: AbortSignal): Promise<T>;
-  /**
-   * Останавливает очередь: снимает отложенную паузу и отклоняет ещё не начатые задачи
-   * ошибкой `ItdAbortError`. Уже выполняющиеся задачи доводятся до конца.
+   * окончательном `dispose()` клиента и может быть асинхронной. Сам `install()` синхронный:
+   * регистрация расширений завершается до того, как `use()` вернёт управление.
    */
-  stop(): void;
-  /**
-   * Придерживает всю очередь на заданное время.
-   *
-   * Вызывается при получении `429` с заголовком `Retry-After`: тормозить нужно все запросы,
-   * а не только тот, который наткнулся на лимит, — иначе остальные продолжат добивать API.
-   */
-  pause(ms: number): void;
-}
-/**
- * Очереди по хостам: основная и по одной на каждый сервис платформы.
- *
- * @internal
- */
-declare class RequestQueuePool {
-  #private;
-  constructor(options: ResolvedRateLimitOptions, clock?: ItdClock);
-  /** Очередь хоста. */
-  for(service: string | undefined): RequestQueue;
-  /** Останавливает все очереди. */
-  stop(): void;
+  install(api: PluginApi): void | PluginTeardown;
 }
 //#endregion
 //#region src/models/users.d.ts
@@ -1603,6 +2032,8 @@ interface TransportEvent {
 interface TransportContext {
   /** Базовый URL API. */
   baseUrl: string;
+  /** Разрешено ли передавать токен этому сервису. */
+  authorize: boolean;
   /** Реализация `fetch`. */
   fetch: typeof fetch;
   /**
@@ -1621,15 +2052,7 @@ interface TransportContext {
   /** Вызывается, когда соединение установлено. */
   onOpen: () => void;
 }
-/**
- * Канал получения событий в реальном времени.
- *
- * Сейчас у платформы один такой канал — поток `text/event-stream`. Абстракция нужна
- * на будущее: политика безопасности сайта уже разрешает `wss://*.xn--d1ah4a.com`,
- * и когда появится WebSocket, достаточно будет добавить ещё одну реализацию этого
- * интерфейса. Переподключение, обновление токена и разбор уведомлений от транспорта
- * не зависят.
- */
+/** Канал получения исходных событий в реальном времени. */
 interface RealtimeTransport {
   /** Понятное имя для логов и диагностики. */
   readonly name: string;
@@ -1691,17 +2114,28 @@ type RealtimeUpdateType = RealtimeUpdate['type'];
 type RealtimeUpdateOfType<T extends RealtimeUpdateType> = Extract<RealtimeUpdate, {
   type: T;
 }>;
-/** Контекст обработки одного обновления потока. */
-interface RealtimeContext<U extends RealtimeUpdate = RealtimeUpdate> {
+/**
+ * Общая форма контекста обработки: то, что есть у любого потока независимо от домена.
+ *
+ * Контекст — обычный объектный литерал, а не класс с геттерами и не `Object.freeze`:
+ * плагины-флейворы присваивают в него свои поля (`ctx.session = …`), а `@itd-api/hydrate`
+ * подменяет `update` и `stream` через `Object.defineProperty`.
+ *
+ * @typeParam U нормализованное обновление домена
+ * @typeParam S поток, который его получил
+ */
+interface RealtimeContextBase<U = unknown, S = unknown> {
   /** Нормализованные данные обновления. */
   readonly update: U;
   /** Поток, который получил обновление. */
-  readonly stream: ItdRealtime;
+  readonly stream: S;
   /** Исходный кадр транспорта. Для начальной REST-синхронизации равен `undefined`. */
   readonly raw: TransportEvent | undefined;
   /** Откуда получены данные. */
   readonly origin: RealtimeUpdateOrigin;
 }
+/** Контекст обработки одного обновления потока уведомлений. */
+type RealtimeContext<U extends RealtimeUpdate = RealtimeUpdate> = RealtimeContextBase<U, ItdRealtime>;
 /** Контекст уведомления с типом, суженным фильтром. */
 type RealtimeNotificationContext<T extends NotificationType = NotificationType> = RealtimeContext<RealtimeNotificationUpdate<T>>;
 /** Условия отбора уведомлений. Все указанные поля объединяются через логическое И. */
@@ -1724,15 +2158,21 @@ type RealtimeNotificationSelector<T extends NotificationType = NotificationType>
 /** Продолжает цепочку промежуточных обработчиков потока. */
 type RealtimeNext = () => Promise<void>;
 /** Обрабатывает обновление потока до его передачи подписчикам. */
-type RealtimeMiddleware<C extends RealtimeContext = RealtimeContext> = (context: C, next: RealtimeNext) => void | Promise<void>;
+type RealtimeMiddleware<C extends RealtimeContextBase = RealtimeContext> = (context: C, next: RealtimeNext) => void | Promise<void>;
+/** Объект, предоставляющий снимок промежуточного обработчика потока. */
+interface RealtimeMiddlewareObj<C extends RealtimeContextBase = RealtimeContext> {
+  middleware(): RealtimeMiddleware<C>;
+}
 /** Асинхронный обработчик нормализованного обновления потока. */
-type RealtimeHandler<C extends RealtimeContext = RealtimeContext> = (context: C) => unknown | Promise<unknown>;
+type RealtimeHandler<C extends RealtimeContextBase = RealtimeContext> = (context: C) => unknown | Promise<unknown>;
 /** Условие отбора контекста потока. */
-type RealtimePredicate = (context: RealtimeContext) => boolean;
+type RealtimePredicate<C extends RealtimeContextBase = RealtimeContext> = (context: C) => boolean;
 /** Проверка, сужающая тип контекста потока. */
-type RealtimeTypeGuard<C extends RealtimeContext> = (context: RealtimeContext) => context is C;
+type RealtimeTypeGuard<C extends B, B extends RealtimeContextBase = RealtimeContext> = (context: B) => context is C;
 /** Ключи, по которым обновления нельзя обрабатывать одновременно. */
-type RealtimeSequentializer = (context: RealtimeContext) => PropertyKey | readonly PropertyKey[] | undefined;
+type RealtimeSequentializer<C extends RealtimeContextBase = RealtimeContext> = (context: C) => PropertyKey | readonly PropertyKey[] | undefined;
+/** Выполняет промежуточные обработчики по порядку и запрещает повторный вызов `next()`. */
+declare function runRealtimeMiddleware<C extends RealtimeContextBase>(middleware: readonly RealtimeMiddleware<C>[], context: C, terminal: RealtimeNext): Promise<void>;
 //#endregion
 //#region src/realtime/reconnect.d.ts
 /**
@@ -1760,27 +2200,14 @@ interface ReconnectOptions {
   maxAttempts?: number;
 }
 //#endregion
-//#region src/realtime/stream.d.ts
-/** События потока уведомлений. */
-interface RealtimeEvents {
-  /** Пришло новое уведомление. */
-  notification: NotificationEvent;
-  /**
-   * Сервер подтвердил подключение и назвал получателя событий.
-   *
-   * Приходит первым кадром сразу после установки соединения.
-   */
-  ready: {
-    userId: string | undefined;
-  };
-  /**
-   * Получено актуальное число непрочитанных.
-   *
-   * При подключении клиент может запросить начальное значение через REST. Затем событие
-   * возникает, только если счётчик пришёл в потоке. В остальных случаях обновляйте его
-   * в приложении либо запрашивайте `itd.notifications.count()`.
-   */
-  unreadCount: number;
+//#region src/realtime/engine.d.ts
+/**
+ * События, которые движок рассылает сам.
+ *
+ * Ни одно из них не зависит от домена, поэтому они одинаковы у любого потока.
+ * Домен расширяет эту карту своими событиями.
+ */
+interface RealtimeEngineEvents<C extends RealtimeContextBase = RealtimeContextBase> {
   /** Изменилось состояние соединения. */
   status: RealtimeStatus;
   /** Соединение оборвалось; будет предпринята попытка переподключения. */
@@ -1800,19 +2227,47 @@ interface RealtimeEvents {
   };
   /** Попытки исчерпаны — соединение восстановится только ручным `connect()`. */
   giveup: undefined;
-  /** Любой исходный кадр транспорта. Отправляется до нормализации и промежуточных обработчиков. */
+  /** Любой исходный кадр транспорта. Отправляется до нормализации и обработчиков. */
   message: TransportEvent;
   /** Промежуточный обработчик потока завершился исключением. */
   middlewareError: {
     error: unknown;
-    context: RealtimeContext;
+    context: C;
   };
-  /** Обработчик `onUpdate` завершился исключением. */
+  /** Обработчик обновления завершился исключением. */
   handlerError: {
     error: unknown;
-    context: RealtimeContext;
+    context: C;
   };
 }
+//#endregion
+//#region src/realtime/stream.d.ts
+/**
+ * События потока уведомлений.
+ *
+ * Общая часть — {@link RealtimeEngineEvents}: статусы, ошибки и переподключение одинаковы
+ * у любого потока. Ниже — то, что есть только у уведомлений.
+ */
+interface RealtimeEvents<C extends RealtimeContext = RealtimeContext> extends RealtimeEngineEvents<C> {
+  /** Пришло новое уведомление. */
+  notification: NotificationEvent;
+  /**
+   * Сервер подтвердил подключение и назвал получателя событий.
+   *
+   * Приходит первым кадром сразу после установки соединения.
+   */
+  ready: {
+    userId: string | undefined;
+  };
+  /**
+   * Получено актуальное число непрочитанных.
+   *
+   * При подключении клиент может запросить начальное значение через REST. Затем событие
+   * возникает, только если счётчик пришёл в потоке. В остальных случаях обновляйте его
+   * в приложении либо запрашивайте `itd.notifications.count()`.
+   */
+  unreadCount: number;
+}
 /** Способ получения событий. */
 declare const RealtimeTransportKind: Readonly<{
   /** Поток событий, если среда умеет читать тело по частям, иначе опрос. */
@@ -1824,7 +2279,7 @@ declare const RealtimeTransportKind: Readonly<{
 }>;
 type RealtimeTransportKind = (typeof RealtimeTransportKind)[keyof typeof RealtimeTransportKind];
 /** Настройки потока уведомлений. */
-interface RealtimeOptions extends ReconnectOptions {
+interface RealtimeOptions<C extends RealtimeContext = RealtimeContext> extends ReconnectOptions {
   /**
    * Транспорт. По умолчанию `auto`: поток событий, если среда умеет читать тело ответа
    * по частям, иначе опрос.
@@ -1867,11 +2322,13 @@ interface RealtimeOptions extends ReconnectOptions {
   /** Максимальное число одновременно обрабатываемых обновлений. По умолчанию 1. */
   concurrency?: number;
   /** Возвращает ключи обновлений, которые нельзя обрабатывать одновременно. */
-  sequentialize?: RealtimeSequentializer;
+  sequentialize?: RealtimeSequentializer<C>;
 }
 /** Что поток получает от клиента. */
 interface RealtimeDeps {
   baseUrl: string;
+  /** Разрешено ли транспорту передавать токен этому сервису. */
+  authorize?: boolean | undefined;
   fetch: typeof fetch;
   clock?: ItdClock;
   /** Общие заголовки клиента для адреса — см. {@link TransportContext.baseHeaders}. */
@@ -1897,6 +2354,9 @@ interface RealtimeDeps {
  * Получается вызовом `itd.realtime()`. Соединение поднимается методом {@link connect}
  * и держится само: обрывы, обновление токена и повторные попытки библиотека берёт на себя.
  *
+ * Параметр типа задаёт форму контекста: плагин может расширить её своими полями
+ * (`ItdRealtime<RealtimeContext & SessionFlavor<S>>`) и типизировать обработчики.
+ *
  * @example
  * ```ts
  * import { NotificationType } from 'itd-api';
@@ -1914,12 +2374,12 @@ interface RealtimeDeps {
  * await stream.drain();
  * ```
  */
-declare class ItdRealtime {
+declare class ItdRealtime<C extends RealtimeContext = RealtimeContext> {
   #private;
-  constructor(deps: RealtimeDeps, options?: RealtimeOptions);
+  constructor(deps: RealtimeDeps, options?: RealtimeOptions<C>);
   /** Текущее состояние соединения. */
   get status(): RealtimeStatus;
-  /** Какой транспорт используется: `sse` или `poll`. */
+  /** Имя используемого транспорта. */
   get transport(): string;
   /** Базовый URL клиента, создавшего поток. @internal */
   get baseUrl(): string;
@@ -1928,32 +2388,32 @@ declare class ItdRealtime {
   /** Непрозрачная область авторизации создавшего поток клиента. @internal */
   getAuthScope(): string | undefined;
   /** Подписывается на событие потока. @returns функция отписки */
-  on<K extends keyof RealtimeEvents>(event: K, listener: Listener<RealtimeEvents[K]>): Unsubscribe;
+  on<K extends keyof RealtimeEvents<C>>(event: K, listener: Listener<RealtimeEvents<C>[K]>): Unsubscribe;
   /** Подписывается на одно срабатывание. */
-  once<K extends keyof RealtimeEvents>(event: K, listener: Listener<RealtimeEvents[K]>): Unsubscribe;
+  once<K extends keyof RealtimeEvents<C>>(event: K, listener: Listener<RealtimeEvents<C>[K]>): Unsubscribe;
   /**
-   * Добавляет промежуточный обработчик нормализованных обновлений.
+   * Добавляет промежуточный обработчик или объект, предоставляющий его через `middleware()`.
    *
    * Обработчики выполняются в порядке регистрации. Если `next()` не вызван, обновление не
    * передаётся дальше по цепочке, асинхронным обработчикам и слушателям событий.
    *
    * @returns функция удаления обработчика
    */
-  use(middleware: RealtimeMiddleware): Unsubscribe;
+  use(middleware: RealtimeMiddleware<C> | RealtimeMiddlewareObj<C>): Unsubscribe;
   /** Подписывает асинхронный обработчик на все нормализованные обновления. */
-  onUpdate(handler: RealtimeHandler): Unsubscribe;
+  onUpdate(handler: RealtimeHandler<C>): Unsubscribe;
   /** Подписывает асинхронный обработчик на обновление указанного типа. */
-  onUpdate<T extends RealtimeUpdateType>(type: T, handler: RealtimeHandler<RealtimeContext<RealtimeUpdateOfType<T>>>): Unsubscribe;
+  onUpdate<T extends RealtimeUpdateType>(type: T, handler: RealtimeHandler<C & RealtimeContext<RealtimeUpdateOfType<T>>>): Unsubscribe;
   /** Подписывает асинхронный обработчик по функции сужения типа. */
-  onUpdate<C extends RealtimeContext>(guard: RealtimeTypeGuard<C>, handler: RealtimeHandler<C>): Unsubscribe;
+  onUpdate<N extends C>(guard: RealtimeTypeGuard<N, C>, handler: RealtimeHandler<N>): Unsubscribe;
   /** Подписывает асинхронный обработчик по пользовательскому условию. */
-  onUpdate(predicate: RealtimePredicate, handler: RealtimeHandler): Unsubscribe;
+  onUpdate(predicate: RealtimePredicate<C>, handler: RealtimeHandler<C>): Unsubscribe;
   /** Подписывает асинхронный обработчик на уведомления, подходящие под фильтр. */
-  onNotification<T extends NotificationType>(selector: RealtimeNotificationSelector<T>, handler: RealtimeHandler<RealtimeNotificationContext<T>>): Unsubscribe;
+  onNotification<T extends NotificationType>(selector: RealtimeNotificationSelector<T>, handler: RealtimeHandler<C & RealtimeNotificationContext<T>>): Unsubscribe;
   /** Подписывает асинхронный обработчик по функции сужения типа уведомления. */
-  onNotification<C extends RealtimeNotificationContext>(guard: (context: RealtimeNotificationContext) => context is C, handler: RealtimeHandler<C>): Unsubscribe;
+  onNotification<N extends C & RealtimeNotificationContext>(guard: (context: C & RealtimeNotificationContext) => context is N, handler: RealtimeHandler<N>): Unsubscribe;
   /** Подписывает асинхронный обработчик по пользовательскому условию. */
-  onNotification(predicate: (context: RealtimeNotificationContext) => boolean, handler: RealtimeHandler<RealtimeNotificationContext>): Unsubscribe;
+  onNotification(predicate: (context: C & RealtimeNotificationContext) => boolean, handler: RealtimeHandler<C & RealtimeNotificationContext>): Unsubscribe;
   /**
    * Поднимает соединение.
    *
@@ -1961,6 +2421,8 @@ declare class ItdRealtime {
    * подключения при перерисовке интерфейса.
    *
    * Возвращает управление сразу после запуска: соединение живёт в фоне.
+   *
+   * @throws если создавший поток клиент уже освобождён
    */
   connect(): Promise<void>;
   /** Закрывает соединение и отменяет запланированные попытки. */
@@ -1971,81 +2433,18 @@ declare class ItdRealtime {
   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 {
   /** Готовый обработчик — вся цепочка слоёв поверх транспорта. */
   handler: RequestHandler;
-  /** Реестр плагинов: у него ресурсы спрашивают имена заявленных опций. */
-  plugins: PluginRegistry;
   baseUrl: string;
 }
 /**
  * Точка входа ресурсов в конвейер запросов.
  *
  * Принимает готовый обработчик — цепочку слоёв поверх транспорта, собранную
- * в {@link ItdClient}, — и отдаёт ресурсам метод `request` и имена опций плагинов.
+ * во внутреннем runtime клиента, — и отдаёт ресурсам методы `request`/`operation`.
  * О слоях и их порядке ресурсы не знают.
  */
 declare class HttpClient {
@@ -2053,13 +2452,6 @@ declare class HttpClient {
   constructor(deps: HttpClientDeps);
   /** Базовый URL, к которому обращается клиент. */
   get baseUrl(): string;
-  /**
-   * Имена опций запроса, заявленные плагинами.
-   *
-   * Читается ресурсами: они переносят в транспорт только известные поля, а чужие,
-   * если их никто не заявил, отсеивают.
-   */
-  get pluginOptionKeys(): ReadonlySet<string>;
   /**
    * Выполняет запрос к API через собранный конвейер.
    *
@@ -2069,7 +2461,11 @@ declare class HttpClient {
    * @throws {ItdAbortError} если запрос отменён через `signal`
    * @throws {ItdNetworkError} если запрос не дошёл до сервера
    */
-  request<T = unknown>(options: PipelineRequest): Promise<T>;
+  request<T = unknown>(options: PipelineRequestInput): Promise<T>;
+  /** Выполняет встроенную семантическую операцию, подставляя её HTTP-метод из каталога. */
+  operation<T = unknown>(operationId: BuiltInOperationId, options: Omit<PipelineRequest, 'operationId' | 'method'>): Promise<T>;
+  /** Выполняет внутреннюю операцию финализации после начала `ItdClient.dispose()`. @internal */
+  cleanupOperation<T = unknown>(operationId: BuiltInOperationId, options: Omit<PipelineRequest, 'operationId' | 'method'>): Promise<T>;
 }
 //#endregion
 //#region src/models/account.d.ts
@@ -2240,11 +2636,6 @@ declare class Paginator<T> implements AsyncIterable<T> {
 }
 //#endregion
 //#region src/resources/base.d.ts
-/** Параметры перебираемого списка: опции запроса плюс предел числа страниц. */
-interface ListParams extends RequestOptions {
-  /** Ограничение числа страниц при переборе. */
-  maxPages?: number | undefined;
-}
 /**
  * Описание перебираемого эндпоинта.
  *
@@ -2254,7 +2645,9 @@ interface ListParams extends RequestOptions {
  * @typeParam T тип элемента списка
  * @typeParam P тип параметров метода
  */
-interface ListingSpec<T, P extends ListParams> {
+interface ListingSpec<T, P extends object> {
+  /** Стабильная семантическая операция списка. */
+  operationId: BuiltInOperationId | ((params: P) => BuiltInOperationId);
   /** Путь эндпоинта. */
   path: (params: P) => string;
   /** Параметры запроса без полей пагинации — их добавит перебор. */
@@ -2267,35 +2660,25 @@ interface ListingSpec<T, P extends ListParams> {
   start: (params: P) => PageState;
 }
 /** Пара методов, собранная из {@link ListingSpec}: разовая загрузка и перебор. */
-interface Listing<T, P extends ListParams> {
+interface Listing<T, P extends object> {
   /** Загружает одну страницу с позиции, заданной параметрами. */
-  list(params: P): Promise<Page<T>>;
+  list(params: P, options?: RequestOptions): Promise<Page<T>>;
   /** Перебирает страницы, сама подставляя позиции. */
-  iterate(params: P): Paginator<T>;
+  iterate(params: P, options?: PaginationOptions): Paginator<T>;
 }
 /** Общая основа всех групп методов клиента. */
 declare class BaseResource {
   /** @internal */
   protected readonly http: HttpClient;
   constructor(http: HttpClient);
-  /**
-   * Переносит опции запроса в описание транспорта.
-   *
-   * Копируются только поля {@link REQUEST_OPTION_KEYS} и опции, заявленные плагинами:
-   * параметры методов наследуют {@link RequestOptions} и приносят с собой `limit`, `cursor`
-   * и прочее, чему в описании запроса делать нечего. Чужие опции плагинов библиотека
-   * не понимает, но обязана донести до обёрток нетронутыми.
-   */
-  protected requestOptions(options: RequestOptions | undefined): Partial<RequestOptions>;
   /**
    * Собирает перебор страниц.
    *
    * @param mode схема пагинации эндпоинта
    * @param load загружает одну страницу для указанной позиции
-   * @param options `maxPages` и `signal`, а также `start` — позиция, с которой продолжить
+   * @param options только управление самим перебором: предел, отмена и начальная позиция
    */
-  protected paginate<T>(mode: PaginationMode, load: (state: PageState) => Promise<Page<T>>, options?: RequestOptions & {
-    maxPages?: number;
+  protected paginate<T>(mode: PaginationMode, load: (state: PageState) => Promise<Page<T>>, options?: PaginationOptions & {
     start?: PageState;
   }): Paginator<T>;
   /**
@@ -2307,6 +2690,7 @@ declare class BaseResource {
    * @example
    * ```ts
    * #feed = this.paginated<Post, FeedParams>({
+   *   operationId: 'posts.list',
    *   path: () => '/api/posts',
    *   query: (p) => ({ tab: p.tab, limit: p.limit }),
    *   start: (p) => (p.cursor ? { cursor: p.cursor } : {}),
@@ -2315,7 +2699,7 @@ declare class BaseResource {
    * });
    * ```
    */
-  protected paginated<T, P extends ListParams>(spec: ListingSpec<T, P>): Listing<T, P>;
+  protected paginated<T, P extends object>(spec: ListingSpec<T, P>): Listing<T, P>;
 }
 //#endregion
 //#region src/resources/auth.d.ts
@@ -2858,10 +3242,9 @@ interface PinPostResult {
 //#endregion
 //#region src/resources/comments.d.ts
 /** Параметры запроса ответов на комментарий. */
-interface RepliesParams extends RequestOptions {
+interface RepliesParams {
   limit?: number;
   page?: number;
-  maxPages?: number;
 }
 /**
  * Комментарии и ответы на них.
@@ -2879,9 +3262,9 @@ declare class CommentsResource extends BaseResource {
    *
    * Здесь пагинация **постраничная**, в отличие от комментариев к посту, где курсорная.
    */
-  replies(commentId: string, params?: RepliesParams): Promise<Page<Comment>>;
+  replies(commentId: string, params?: RepliesParams, options?: RequestOptions): Promise<Page<Comment>>;
   /** Перебирает ответы на комментарий. */
-  iterateReplies(commentId: string, params?: RepliesParams): Paginator<Comment>;
+  iterateReplies(commentId: string, params?: RepliesParams, options?: PaginationOptions): Paginator<Comment>;
   /**
    * Отвечает на комментарий.
    *
@@ -2913,7 +3296,7 @@ interface UploadedFile {
   url: string;
 }
 /** Настройки загрузки. */
-interface UploadOptions extends RequestOptions {
+interface UploadOptions {
   /** Имя файла. Используется для определения MIME, если тип не задан. */
   filename?: string;
   /** MIME-тип. По умолчанию определяется по имени или `Blob`. */
@@ -2939,9 +3322,9 @@ declare class FilesResource extends BaseResource {
    * Потоковый источник открывается заново при каждой повторной попытке. Буферный источник
    * после успешного чтения переиспользуется.
    */
-  upload(input: FileInput, options?: UploadOptions): Promise<UploadedFile>;
+  upload(input: FileInput, uploadOptions?: UploadOptions, requestOptions?: RequestOptions): Promise<UploadedFile>;
   /** Загружает несколько файлов последовательно, сохраняя порядок. */
-  uploadMany(files: FileInput[], options?: UploadOptions): Promise<string[]>;
+  uploadMany(files: FileInput[], uploadOptions?: UploadOptions, requestOptions?: RequestOptions): Promise<string[]>;
   /**
    * Загружает сведения о файле.
    *
@@ -2954,10 +3337,9 @@ declare class FilesResource extends BaseResource {
 //#endregion
 //#region src/resources/hashtags.d.ts
 /** Параметры запроса постов по хэштегу. */
-interface HashtagPostsParams extends RequestOptions {
+interface HashtagPostsParams {
   limit?: number;
   cursor?: string;
-  maxPages?: number;
 }
 /**
  * Хэштеги.
@@ -2973,29 +3355,28 @@ declare class HashtagsResource extends BaseResource {
    */
   search(query?: string, params?: {
     limit?: number;
-  } & RequestOptions): Promise<Hashtag[]>;
+  }, options?: RequestOptions): Promise<Hashtag[]>;
   /** Загружает трендовые хэштеги. */
   trending(params?: {
     limit?: number;
-  } & RequestOptions): Promise<Hashtag[]>;
+  }, options?: RequestOptions): Promise<Hashtag[]>;
   /**
    * Загружает страницу постов по хэштегу.
    *
    * @param tag название без решётки; кодируется автоматически, поэтому кириллица
    * и пробелы допустимы
    */
-  posts(tag: string, params?: HashtagPostsParams): Promise<Page<Post>>;
+  posts(tag: string, params?: HashtagPostsParams, options?: RequestOptions): Promise<Page<Post>>;
   /** Перебирает посты по хэштегу. */
-  iteratePosts(tag: string, params?: HashtagPostsParams): Paginator<Post>;
+  iteratePosts(tag: string, params?: HashtagPostsParams, options?: PaginationOptions): Paginator<Post>;
 }
 //#endregion
 //#region src/resources/notifications.d.ts
 /** Параметры запроса списка уведомлений. */
-interface NotificationListParams extends RequestOptions {
+interface NotificationListParams {
   limit?: number;
   /** Смещение от начала списка. */
   offset?: number;
-  maxPages?: number;
 }
 /** Изменяемые настройки уведомлений. */
 type UpdateNotificationSettingsInput = Partial<NotificationSettings>;
@@ -3018,7 +3399,7 @@ declare class NotificationsResource extends BaseResource {
    * const next = await itd.notifications.list({ limit: 20, offset: page.nextOffset });
    * ```
    */
-  list(params?: NotificationListParams): Promise<Page<Notification>>;
+  list(params?: NotificationListParams, options?: RequestOptions): Promise<Page<Notification>>;
   /**
    * Перебирает уведомления.
    *
@@ -3029,7 +3410,7 @@ declare class NotificationsResource extends BaseResource {
    * }
    * ```
    */
-  iterate(params?: NotificationListParams): Paginator<Notification>;
+  iterate(params?: NotificationListParams, options?: PaginationOptions): Paginator<Notification>;
   /** Загружает число непрочитанных уведомлений. */
   count(options?: RequestOptions): Promise<number>;
   /**
@@ -3519,7 +3900,7 @@ type PostUpdateInput = UpdatePostInput | PostBuilder | ((builder: PostBuilder) =
 //#endregion
 //#region src/resources/posts.d.ts
 /** Параметры запроса ленты. */
-interface FeedParams extends RequestOptions {
+interface FeedParams {
   /** Вкладка ленты. По умолчанию сервер отдаёт популярное. */
   tab?: FeedTab;
   /** Сколько постов на страницу. */
@@ -3530,21 +3911,18 @@ interface FeedParams extends RequestOptions {
    * Передавайте значение как есть: его формат зависит от вкладки и может измениться.
    */
   cursor?: string;
-  /** Ограничение числа страниц при переборе. */
-  maxPages?: number;
 }
 /** Параметры запроса постов пользователя. */
-interface UserPostsParams extends RequestOptions {
+interface UserPostsParams {
   limit?: number;
   cursor?: string;
   /** Порядок сортировки. */
   sort?: string;
   /** Закреплённый пост, чтобы сервер поднял его наверх. */
   pinnedPostId?: string;
-  maxPages?: number;
 }
 /** Параметры запроса комментариев к посту. */
-interface CommentsParams extends RequestOptions {
+interface CommentsParams {
   limit?: number;
   /**
    * Курсор следующей страницы: идентификатор последнего полученного комментария.
@@ -3553,7 +3931,6 @@ interface CommentsParams extends RequestOptions {
    */
   cursor?: string;
   sort?: CommentSort;
-  maxPages?: number;
 }
 /**
  * Посты: лента, публикация, реакции, репосты, комментарии.
@@ -3574,7 +3951,7 @@ declare class PostsResource extends BaseResource {
    * const next = await itd.posts.list({ tab: FeedTab.Following, cursor: page.nextCursor ?? undefined });
    * ```
    */
-  list(params?: FeedParams): Promise<Page<Post>>;
+  list(params?: FeedParams, options?: RequestOptions): Promise<Page<Post>>;
   /**
    * Перебирает ленту, сама подставляя курсоры.
    *
@@ -3585,7 +3962,7 @@ declare class PostsResource extends BaseResource {
    * }
    * ```
    */
-  iterate(params?: FeedParams): Paginator<Post>;
+  iterate(params?: FeedParams, options?: PaginationOptions): Paginator<Post>;
   /**
    * Публикует пост.
    *
@@ -3652,22 +4029,22 @@ declare class PostsResource extends BaseResource {
    *
    * Принимает и UUID, и имя пользователя.
    */
-  byUser(user: UserRef, params?: UserPostsParams): Promise<Page<Post>>;
+  byUser(user: UserRef, params?: UserPostsParams, options?: RequestOptions): Promise<Page<Post>>;
   /** Перебирает стену пользователя. Что именно в неё входит — см. {@link byUser}. */
-  iterateByUser(user: UserRef, params?: UserPostsParams): Paginator<Post>;
+  iterateByUser(user: UserRef, params?: UserPostsParams, options?: PaginationOptions): Paginator<Post>;
   /** Загружает страницу постов, которые пользователь отметил реакцией. */
-  likedByUser(user: UserRef, params?: UserPostsParams): Promise<Page<Post>>;
+  likedByUser(user: UserRef, params?: UserPostsParams, options?: RequestOptions): Promise<Page<Post>>;
   /** Перебирает посты, которые пользователь отметил реакцией. */
-  iterateLikedByUser(user: UserRef, params?: UserPostsParams): Paginator<Post>;
+  iterateLikedByUser(user: UserRef, params?: UserPostsParams, options?: PaginationOptions): Paginator<Post>;
   /**
    * Загружает страницу комментариев к посту.
    *
    * У этого эндпоинта курсор и признак продолжения лежат рядом со списком, а не внутри
    * объекта `pagination`, как у остальных, — разница скрыта внутри.
    */
-  comments(postId: string, params?: CommentsParams): Promise<Page<Comment>>;
+  comments(postId: string, params?: CommentsParams, options?: RequestOptions): Promise<Page<Comment>>;
   /** Перебирает комментарии к посту. */
-  iterateComments(postId: string, params?: CommentsParams): Paginator<Comment>;
+  iterateComments(postId: string, params?: CommentsParams, options?: PaginationOptions): Paginator<Comment>;
   /**
    * Комментирует пост.
    *
@@ -3812,8 +4189,8 @@ declare class SubscriptionResource extends BaseResource {
 }
 //#endregion
 //#region src/resources/telemetry.d.ts
-/** Общие опции запроса телеметрии. */
-interface TelemetryOptions extends RequestOptions {
+/** Параметры событий телеметрии. */
+interface TelemetryOptions {
   /** Переопределяет идентификатор сессии телеметрии (`sid`) для этого запроса. */
   sid?: string;
 }
@@ -3945,7 +4322,7 @@ interface TelemetryBatch {
    *
    * Опции позволяют заменить, например, отменённый `signal` при повторной попытке.
    */
-  flush(options?: TelemetryOptions): Promise<void>;
+  flush(options?: RequestOptions): Promise<void>;
   /** Отправляет накопленные события и закрывает накопитель. */
   close(): Promise<void>;
 }
@@ -3957,24 +4334,25 @@ interface TelemetryBatch {
  */
 declare class TelemetryResource extends BaseResource {
   #private;
+  constructor(http: HttpClient);
   /** Идентификатор сессии телеметрии, общий для всех событий этого ресурса. */
   get sessionId(): string;
   /** Отправляет события просмотра постов (`POST /api/v1/i`). */
-  dwell(entries: readonly DwellEntry[], options?: TelemetryOptions): Promise<unknown>;
+  dwell(entries: readonly DwellEntry[], telemetryOptions?: TelemetryOptions, requestOptions?: RequestOptions): Promise<unknown>;
   /** Отправляет события взаимодействия с контентом (`POST /api/v1/x`). */
-  interaction(entries: readonly InteractionEntry[], options?: TelemetryOptions): Promise<unknown>;
+  interaction(entries: readonly InteractionEntry[], telemetryOptions?: TelemetryOptions, requestOptions?: RequestOptions): Promise<unknown>;
   /** Начинает измерять время просмотра и отправляет результат после `finish()`. */
-  startView(input: ViewTrackerInput, options?: ViewTrackerOptions): ViewTracker;
+  startView(input: ViewTrackerInput, options?: ViewTrackerOptions, requestOptions?: RequestOptions): ViewTracker;
   /** Отправляет событие открытия фотографии. */
-  photoOpen(input: PhotoOpenInput, options?: TelemetryOptions): Promise<unknown>;
+  photoOpen(input: PhotoOpenInput, telemetryOptions?: TelemetryOptions, requestOptions?: RequestOptions): Promise<unknown>;
   /** Отправляет событие прогресса просмотра видео. */
-  videoProgress(input: VideoProgressInput, options?: TelemetryOptions): Promise<unknown>;
+  videoProgress(input: VideoProgressInput, telemetryOptions?: TelemetryOptions, requestOptions?: RequestOptions): Promise<unknown>;
   /**
    * Создаёт накопитель с явными `flush()` и `close()`.
    *
    * Создание и добавление записей не выполняют сетевых запросов.
    */
-  batch(options?: TelemetryBatchOptions): TelemetryBatch;
+  batch(options?: TelemetryBatchOptions, requestOptions?: RequestOptions): TelemetryBatch;
   /** Закрывает все созданные накопители, отправляя оставшиеся записи. */
   close(): Promise<void>;
 }
@@ -3986,12 +4364,11 @@ declare class TelemetryResource extends BaseResource {
  * ⚠️ Списки подписчиков, подписок и заблокированных на сервере **не листаются**:
  * `page` он игнорирует, а `limit` зажимает на 20. Подробности — в {@link UsersResource.followers}.
  */
-interface UserListParams extends RequestOptions {
+interface UserListParams {
   /** Сколько записей вернуть. Значения больше 20 сервер молча уменьшает до 20. */
   limit?: number;
   /** Номер страницы. Сервер его игнорирует — оставлен на случай, если пагинацию починят. */
   page?: number;
-  maxPages?: number;
 }
 /** Изменяемые поля своего профиля. */
 interface UpdateProfileInput {
@@ -4013,7 +4390,7 @@ type UpdatePrivacyInput = Partial<PrivacySettings>;
 declare class UsersResource extends BaseResource {
   #private;
   constructor(http: HttpClient, deps: {
-    uploadFile: (file: FileInput, options?: UploadOptions) => Promise<UploadedFile>;
+    uploadFile: (file: FileInput, uploadOptions?: UploadOptions, requestOptions?: RequestOptions) => Promise<UploadedFile>;
   });
   /** Загружает свой профиль — с подпиской и признаком подтверждённого телефона. */
   me(options?: RequestOptions): Promise<MyProfile>;
@@ -4030,7 +4407,7 @@ declare class UsersResource extends BaseResource {
    * await itd.users.setBanner(file, { filename: 'banner.webp' });
    * ```
    */
-  setBanner(file: FileInput, options?: UploadOptions): Promise<MyProfile>;
+  setBanner(file: FileInput, uploadOptions?: UploadOptions, requestOptions?: RequestOptions): Promise<MyProfile>;
   /** Удаляет баннер профиля, устанавливая `bannerId` в `null`. */
   removeBanner(options?: RequestOptions): Promise<MyProfile>;
   /** Деактивирует аккаунт. Вернуть его можно через {@link restore}. */
@@ -4060,7 +4437,7 @@ declare class UsersResource extends BaseResource {
   /** Ищет пользователей по строке запроса. */
   search(query: string, params?: {
     limit?: number;
-  } & RequestOptions): Promise<UserSummary[]>;
+  }, options?: RequestOptions): Promise<UserSummary[]>;
   /** Загружает рекомендации, на кого подписаться. */
   whoToFollow(options?: RequestOptions): Promise<UserSummary[]>;
   /** Загружает рейтинг кланов. */
@@ -4084,18 +4461,18 @@ declare class UsersResource extends BaseResource {
    * Числу `total` доверять тоже не стоит: оно расходится с `followersCount` из профиля —
    * на проверенных аккаунтах занижено примерно на 1–4%.
    */
-  followers(user: UserRef, params?: UserListParams): Promise<Page<UserSummary>>;
+  followers(user: UserRef, params?: UserListParams, options?: RequestOptions): Promise<Page<UserSummary>>;
   /**
    * Перебирает подписчиков.
    *
    * ⚠️ Перебор закончится после первых 20 записей: сервер список не листает —
    * см. {@link followers}. Метод оставлен на случай, если пагинацию починят.
    */
-  iterateFollowers(user: UserRef, params?: UserListParams): Paginator<UserSummary>;
+  iterateFollowers(user: UserRef, params?: UserListParams, options?: PaginationOptions): Paginator<UserSummary>;
   /** Загружает подписки пользователя. Ограничения те же, что у {@link followers}. */
-  following(user: UserRef, params?: UserListParams): Promise<Page<UserSummary>>;
+  following(user: UserRef, params?: UserListParams, options?: RequestOptions): Promise<Page<UserSummary>>;
   /** Перебирает подписки. Закончится после первых 20 записей — см. {@link followers}. */
-  iterateFollowing(user: UserRef, params?: UserListParams): Paginator<UserSummary>;
+  iterateFollowing(user: UserRef, params?: UserListParams, options?: PaginationOptions): Paginator<UserSummary>;
   /**
    * Проверяет, подписаны ли вы, сразу для нескольких пользователей.
    *
@@ -4113,9 +4490,9 @@ declare class UsersResource extends BaseResource {
   /** Снимает блокировку. */
   unblock(user: UserRef, options?: RequestOptions): Promise<void>;
   /** Загружает заблокированных пользователей. Ограничения те же, что у {@link followers}. */
-  blocked(params?: UserListParams): Promise<Page<UserSummary>>;
+  blocked(params?: UserListParams, options?: RequestOptions): Promise<Page<UserSummary>>;
   /** Перебирает заблокированных. Закончится после первых 20 записей — см. {@link followers}. */
-  iterateBlocked(params?: UserListParams): Paginator<UserSummary>;
+  iterateBlocked(params?: UserListParams, options?: PaginationOptions): Paginator<UserSummary>;
   /** Загружает настройки приватности. */
   getPrivacy(options?: RequestOptions): Promise<PrivacySettings>;
   /** Обновляет настройки приватности. Передавайте только изменяемые поля. */
@@ -4151,19 +4528,6 @@ declare global {
     readonly asyncDispose: unique symbol;
   }
 }
-/**
- * Скрытые параметры конструктора — не часть публичного API.
- *
- * @internal
- */
-interface ItdClientInternals {
-  /**
-   * Готовая очередь запросов — так {@link ItdAccounts} с `rateLimitScope: 'shared'` даёт
-   * нескольким клиентам одну на всех. Свою клиент в этом случае не заводит и, что важнее,
-   * не гасит при `close()`: чужие ожидающие запросы это отменило бы.
-   */
-  queues?: RequestQueuePool | undefined;
-}
 /**
  * Клиент API итд.com.
  *
@@ -4198,32 +4562,32 @@ interface ItdClientInternals {
 declare class ItdClient {
   #private;
   /** Авторизация, сессии и пароли. */
-  readonly auth: AuthResource;
+  get auth(): AuthResource;
   /** Профили, подписки, блокировки, приватность. */
-  readonly users: UsersResource;
+  get users(): UsersResource;
   /** Лента, публикация, реакции, репосты, комментарии к постам. */
-  readonly posts: PostsResource;
+  get posts(): PostsResource;
   /** Ответы на комментарии и действия над ними. */
-  readonly comments: CommentsResource;
+  get comments(): CommentsResource;
   /** Загрузка файлов и медиа. */
-  readonly files: FilesResource;
+  get files(): FilesResource;
   /** Уведомления: список, счётчик, отметки о прочтении, настройки. */
-  readonly notifications: NotificationsResource;
+  get notifications(): NotificationsResource;
   /** Хэштеги и посты по ним. */
-  readonly hashtags: HashtagsResource;
+  get hashtags(): HashtagsResource;
   /** Глобальный поиск по пользователям и хэштегам. */
-  readonly search: SearchResource;
+  get search(): SearchResource;
   /** Жалобы на контент и пользователей. */
-  readonly reports: ReportsResource;
+  get reports(): ReportsResource;
   /** Верификация профиля. */
-  readonly verification: VerificationResource;
+  get verification(): VerificationResource;
   /** Подписка и способы оплаты. */
-  readonly subscription: SubscriptionResource;
+  get subscription(): SubscriptionResource;
   /** Сведения о платформе: версии приложений, изменения, анонсы, баннер события. */
-  readonly platform: PlatformResource;
+  get platform(): PlatformResource;
   /** Телеметрия просмотров. */
-  readonly telemetry: TelemetryResource;
-  constructor(options?: ItdClientOptions, internals?: ItdClientInternals);
+  get telemetry(): TelemetryResource;
+  constructor(options?: ItdClientOptions);
   /** Базовый URL, к которому обращается клиент. */
   get baseUrl(): string;
   /**
@@ -4236,26 +4600,33 @@ declare class ItdClient {
    * ```ts
    * const raw = await itd.request({ method: 'GET', path: '/api/posts', raw: true });
    * ```
+   *
+   * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}
    */
   request<T = unknown>(options: RawRequestOptions): Promise<T>;
   /**
    * Подключает плагин.
    *
-   * Плагин работает на уровне транспорта: видит запрос до отправки и разобранный ответ,
-   * поэтому одна обёртка охватывает сразу все методы клиента. Подключать можно в любой
-   * момент, но обычно это делают сразу после создания клиента.
+   * Плагин может независимо регистрировать transformer логической операции и interceptor
+   * транспортной попытки. Оба контракта охватывают все методы клиента. Подключать плагин
+   * можно в любой момент, но обычно это делают сразу после создания клиента.
    *
    * @throws {ItdConfigError} если плагин задан неверно или уже подключён
+   * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}
    *
    * @example
    * ```ts
    * import { crypt } from '@itd-api/crypto';
    *
    * itd.use(crypt());
-   * await itd.posts.create({ content: 'секрет' }, { encrypt: 'invis' });
+   * await itd.posts.create({
+   *   content: 'секрет',
+   * }, {
+   *   extensions: { crypto: { encrypt: 'invisible' } },
+   * });
    * ```
    */
-  use(plugin: ItdPlugin): this;
+  use(plugin: ClientPlugin): this;
   /** Имена подключённых плагинов в фактическом порядке выполнения обёрток. */
   pluginNames(): string[];
   /** Подключён ли плагин с таким именем. */
@@ -4281,6 +4652,7 @@ declare class ItdClient {
    * поддоменам. Стороннему хосту токен нужно разрешить явно: `auth: true`.
    *
    * @throws {ItdConfigError} если определение неверно или имя уже занято
+   * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}
    *
    * @example Сервис платформы на поддомене — токен уходит сам
    * ```ts
@@ -4335,6 +4707,8 @@ declare class ItdClient {
    *
    * await stream.connect();
    * ```
+   *
+   * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}
    */
   realtime(options?: RealtimeOptions): ItdRealtime;
   /**
@@ -4347,6 +4721,17 @@ declare class ItdClient {
    * Общая очередь, полученная от {@link ItdAccounts}, не останавливается: её гасит сам
    * контейнер, когда закрывает все аккаунты разом.
    *
+   * Терминальное освобождение — это {@link dispose}.
+   */
+  close(): Promise<void>;
+  /**
+   * Окончательно освобождает клиент: выполняет {@link close} и отключает все плагины.
+   *
+   * Терминальное состояние устанавливается сразу при первом вызове. После этого новые
+   * запросы, подключение плагинов, регистрация сервисов и создание или повторный запуск
+   * realtime-потоков завершаются с {@link ItdStateError}. Повторные вызовы возвращают
+   * тот же результат очистки.
+   *
    * @example
    * ```ts
    * await using itd = new ItdClient({ auth: token });
@@ -4354,14 +4739,6 @@ declare class ItdClient {
    * // dispose() вызовется сам на выходе из блока
    * ```
    */
-  close(): Promise<void>;
-  /**
-   * Окончательно освобождает клиент: выполняет {@link close} и отключает все плагины.
-   *
-   * В отличие от `close()`, после `dispose()` плагины не восстанавливаются автоматически.
-   * Сам клиент остаётся пригоден для обычных запросов; при необходимости плагины можно
-   * подключить заново через {@link use}.
-   */
   dispose(): Promise<void>;
   /** Позволяет использовать клиент с `await using`. */
   [Symbol.asyncDispose](): Promise<void>;
@@ -4386,7 +4763,11 @@ declare class ItdClient {
    * ```
    */
   getUserId(): Promise<UserId | undefined>;
-  /** Восстанавливает сохранённую сессию, включая cookie. */
+  /**
+   * Восстанавливает сохранённую сессию, включая cookie.
+   *
+   * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}
+   */
   setSession(session: ItdSession): Promise<void>;
 }
 /**
@@ -4418,7 +4799,7 @@ interface ItdAccountsOptions extends Omit<ItdClientOptions, 'auth' | 'storage' |
   /** Общее хранилище сессий всех аккаунтов. По умолчанию {@link MemoryMultiTokenStorage}. */
   storage?: MultiTokenStorage | undefined;
   /** Плагины, подключаемые каждому аккаунту, в том числе добавленному позже. */
-  plugins?: readonly ItdPlugin[] | undefined;
+  plugins?: readonly ClientPlugin[] | undefined;
   /**
    * Как делить очередь запросов. По умолчанию `'account'` — своя у каждого.
    *
@@ -4584,7 +4965,7 @@ declare class ItdAccounts {
    * accounts.use(crypt());
    * ```
    */
-  use(plugin: ItdPlugin): this;
+  use(plugin: ClientPlugin): this;
   /** Имена общих плагинов в фактическом порядке выполнения обёрток. */
   pluginNames(): string[];
   /** Подключён ли общий плагин с таким именем. */
@@ -4637,7 +5018,9 @@ declare class ItdAccounts {
    * Окончательно освобождает контейнер и отключает общие плагины у всех аккаунтов.
    *
    * Для временной остановки потоков и очереди без отключения плагинов используйте
-   * {@link close}.
+   * {@link close}. Терминальное состояние устанавливается сразу: контейнер отзывает
+   * storage-срезы и подписки, а новые аккаунты, запросы его клиентов и плагины после
+   * первого `dispose()` больше не допускаются.
    */
   dispose(): Promise<void>;
   /** Позволяет использовать контейнер с `await using`. */
@@ -4683,6 +5066,8 @@ declare const ItdErrorKind: Readonly<{
   readonly Timeout: "timeout";
   /** Запрос отменён через `AbortSignal`. */
   readonly Abort: "abort";
+  /** Операция невозможна в текущем состоянии объекта. */
+  readonly State: "state";
   /** Не удалось получить или подготовить содержимое вложения. */
   readonly File: "file";
   /** Некорректная конфигурация или аргументы — обнаружено до обращения к сети. */
@@ -4952,6 +5337,17 @@ declare class ItdAbortError extends ItdError {
     cause?: unknown;
   });
 }
+/**
+ * Операция невозможна в текущем состоянии объекта.
+ *
+ * Например, клиент уже окончательно освобождён через `dispose()` и не может выполнять
+ * новые запросы или создавать realtime-потоки.
+ */
+declare class ItdStateError extends ItdError {
+  constructor(message: string, options?: {
+    cause?: unknown;
+  });
+}
 /**
  * Некорректная конфигурация или аргументы — обнаружено до обращения к сети.
  *
@@ -4959,7 +5355,9 @@ declare class ItdAbortError extends ItdError {
  * с одним вариантом ответа.
  */
 declare class ItdConfigError extends ItdError {
-  constructor(message: string);
+  constructor(message: string, options?: {
+    cause?: unknown;
+  });
 }
 /** Любая ошибка, порождённая этой библиотекой. */
 declare function isItdError(value: unknown): value is ItdError;
@@ -4967,6 +5365,8 @@ declare function isItdError(value: unknown): value is ItdError;
 declare function isItdApiError(value: unknown): value is ItdApiError;
 /** Ошибка получения или чтения вложения. */
 declare function isItdFileError(value: unknown): value is ItdFileError;
+/** Операция невозможна в текущем состоянии объекта. */
+declare function isItdStateError(value: unknown): value is ItdStateError;
 /** Ошибка валидации: `VALIDATION_ERROR` либо статус `400`/`422`. */
 declare function isItdValidationError(value: unknown): value is ItdValidationError;
 /** Ошибка авторизации: истёкший или отозванный токен. */
@@ -5116,20 +5516,9 @@ declare function isKnownNotificationType(type: string): boolean;
  */
 declare function resolveNotificationUrl(notification: Notification): string;
 //#endregion
-//#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>;
+type RealtimeRouteSelector<K extends PropertyKey, C extends RealtimeContextBase = RealtimeContext> = (context: C) => K | null | undefined | Promise<K | null | undefined>;
 /**
  * Направляет обновления потока в именованные цепочки промежуточных обработчиков.
  *
@@ -5144,20 +5533,93 @@ type RealtimeRouteSelector<K extends PropertyKey, C extends RealtimeContext = Re
  *   }
  *   await next();
  * });
- * stream.use(router.middleware());
+ * stream.use(router);
  * ```
  */
-declare class RealtimeRouter<K extends PropertyKey = PropertyKey, C extends RealtimeContext = RealtimeContext> {
+declare class RealtimeRouter<K extends PropertyKey = PropertyKey, C extends RealtimeContextBase = RealtimeContext> implements RealtimeMiddlewareObj<C> {
   #private;
   constructor(selector: RealtimeRouteSelector<K, C>);
   /** Добавляет промежуточные обработчики к маршруту и возвращает функцию их удаления. */
   route(key: K, ...middleware: readonly RealtimeMiddleware<C>[]): Unsubscribe;
   /** Добавляет промежуточные обработчики для обновлений без зарегистрированного маршрута. */
   otherwise(...middleware: readonly RealtimeMiddleware<C>[]): Unsubscribe;
-  /** Возвращает промежуточный обработчик для `stream.use()`. */
+  /** Возвращает снимок маршрутов для `stream.use(router)` или ручной композиции. */
   middleware(): RealtimeMiddleware<C>;
 }
 //#endregion
+//#region src/realtime/composer.d.ts
+/** Функция или объектный middleware, который можно добавить в {@link RealtimeComposer}. */
+type RealtimeMiddlewareLike<C extends RealtimeContextBase = RealtimeContext> = RealtimeMiddleware<C> | RealtimeMiddlewareObj<C>;
+/** Один middleware или последовательность middleware для ветки composer. */
+type RealtimeMiddlewareGroup<C extends RealtimeContextBase = RealtimeContext> = RealtimeMiddlewareLike<C> | readonly RealtimeMiddlewareLike<C>[];
+/** Синхронное или асинхронное условие ветвления composer. */
+type RealtimeFilter<C extends RealtimeContextBase = RealtimeContext> = (context: C) => boolean | Promise<boolean>;
+/** Ошибка локальной realtime-ветки вместе с контекстом обрабатываемого обновления. */
+interface RealtimeErrorContext<C extends RealtimeContextBase = RealtimeContext> {
+  /** Исходное исключение middleware. */
+  readonly error: unknown;
+  /** Контекст обновления, на котором завершилась ветка. */
+  readonly context: C;
+}
+/** Обработчик локальной границы ошибок composer. */
+type RealtimeErrorBoundary<C extends RealtimeContextBase = RealtimeContext> = (failure: RealtimeErrorContext<C>, next: RealtimeNext) => unknown | Promise<unknown>;
+/** Именованные ветки для {@link RealtimeComposer.route}. */
+type RealtimeRouteTable<K extends string | symbol, C extends RealtimeContextBase = RealtimeContext> = Partial<Record<K, RealtimeMiddlewareGroup<C>>>;
+/**
+ * Собирает переиспользуемый feature-модуль из realtime middleware.
+ *
+ * Composer не открывает соединение и не планирует конкурентность: готовый объект подключается
+ * через `stream.use(composer)`, а выполнение остаётся обязанностью существующего dispatcher.
+ * Для каждого принятого update используется снимок всей вложенной структуры composer.
+ *
+ * @example
+ * ```ts
+ * const feature = new RealtimeComposer<AppRealtimeContext>();
+ * const safe = feature.errorBoundary(reportFeatureError);
+ * safe.filter(isPostUpdate).use(handlePost);
+ * stream.use(feature);
+ * ```
+ */
+declare class RealtimeComposer<C extends RealtimeContextBase = RealtimeContext> implements RealtimeMiddlewareObj<C> {
+  #private;
+  constructor(...middleware: readonly RealtimeMiddlewareLike<C>[]);
+  /** Добавляет middleware в конец текущей onion-цепочки. */
+  use(...middleware: readonly RealtimeMiddlewareLike<C>[]): this;
+  /** Создаёт дочернюю ветку, выполняемую только когда type guard принимает контекст. */
+  filter<N extends C>(predicate: RealtimeTypeGuard<N, C>, ...middleware: readonly RealtimeMiddlewareLike<N>[]): RealtimeComposer<N>;
+  /** Создаёт дочернюю ветку по синхронному или асинхронному условию. */
+  filter(predicate: RealtimeFilter<C>, ...middleware: readonly RealtimeMiddlewareLike<C>[]): RealtimeComposer<C>;
+  /**
+   * Направляет контекст в одну именованную ветку.
+   *
+   * Неизвестный ключ без fallback пропускает update следующему внешнему middleware. Для
+   * динамической регистрации и числовых ключей используйте {@link RealtimeRouter} напрямую.
+   */
+  route<K extends string | symbol>(selector: RealtimeRouteSelector<K, C>, routes: RealtimeRouteTable<K, C>, fallback?: RealtimeMiddlewareGroup<C>): this;
+  /**
+   * Создаёт дочернюю ветку с локальной границей ошибок.
+   *
+   * Граница защищает только переданные и затем добавленные в возвращённый composer middleware.
+   * Ошибки внешней цепочки намеренно не перехватываются. Обработчик может вызвать `next()`,
+   * чтобы после ошибки продолжить внешнюю цепочку, либо повторно выбросить исключение. Внешняя
+   * цепочка начинается после полного завершения защищённой ветки, а не входит в её onion-вызов.
+   */
+  errorBoundary(handler: RealtimeErrorBoundary<C>, ...middleware: readonly RealtimeMiddlewareLike<C>[]): RealtimeComposer<C>;
+  /** Возвращает snapshot-aware middleware для `stream.use()` или вложенного composer. */
+  middleware(): RealtimeMiddleware<C>;
+}
+//#endregion
+//#region src/realtime/poll.d.ts
+/** Настройки опроса. */
+interface PollTransportOptions {
+  /** Часы опроса. Обычно подменяются только в тестах. */
+  clock?: ItdClock;
+  /** Как часто опрашивать сервер, мс. По умолчанию 15 000. */
+  interval?: number;
+  /** Сколько уведомлений запрашивать за раз. По умолчанию 20. */
+  limit?: number;
+}
+//#endregion
 //#region src/realtime/sse.d.ts
 /** Путь потока уведомлений. */
 declare const STREAM_PATH = "/api/notifications/stream";
@@ -5183,6 +5645,50 @@ interface SseTransportOptions {
   handshakeTimeout?: number;
 }
 //#endregion
+//#region src/realtime/websocket.d.ts
+/** Стандартный путь WebSocket-подключения. */
+declare const WEBSOCKET_PATH = "/api/ws";
+/** Дополнительные параметры конструктора, поддерживаемые Node-реализациями вроде `ws`. */
+interface WebSocketImplementationOptions {
+  headers?: Record<string, string> | undefined;
+  handshakeTimeout?: number | undefined;
+}
+/** Конструктор WebSocket, который можно передать вместо глобальной реализации. */
+interface WebSocketLike {
+  new (url: string | URL, protocols?: string | string[], options?: WebSocketImplementationOptions): unknown;
+}
+/** Определяет, был ли отказ до открытия сокета вызван недействительным токеном. */
+type WebSocketOpenFailureClassifier = (error: unknown, signal: AbortSignal) => boolean | Promise<boolean>;
+/** Настройки WebSocket-транспорта. */
+interface WebSocketTransportOptions {
+  /** Путь апгрейда. По умолчанию `/api/ws`. */
+  path?: string | undefined;
+  /** Реализация WebSocket для сред без глобальной либо для передачи заголовков апгрейда. */
+  webSocketImpl?: WebSocketLike | undefined;
+  /** Способ передачи токена. `auto` выбирает заголовок при инъекции и query иначе. */
+  auth?: 'query' | 'header' | 'auto' | undefined;
+  /** Молчание открытого соединения до переподключения, мс. По умолчанию 90 000. */
+  idleTimeout?: number | undefined;
+  /** Период текстового `ping`, мс. По умолчанию 30 000. */
+  keepAlive?: number | undefined;
+  /** Максимальное время установки соединения, мс. По умолчанию 20 000. */
+  handshakeTimeout?: number | undefined;
+  /**
+   * Проверяет отказ до `open`, когда среда скрыла HTTP-статус WebSocket-upgrade.
+   * `true` преобразует отказ в {@link UnauthorizedStreamError}.
+   */
+  classifyOpenFailure?: WebSocketOpenFailureClassifier | undefined;
+  /** Часы транспорта. Обычно подменяются только в тестах. */
+  clock?: ItdClock | undefined;
+}
+/** Транспорт исходных realtime-событий поверх стандартного WebSocket. */
+declare class WebSocketTransport implements RealtimeTransport {
+  #private;
+  readonly name = "ws";
+  constructor(options?: WebSocketTransportOptions);
+  connect(context: TransportContext): Promise<void>;
+}
+//#endregion
 //#region src/spans/render.d.ts
 /** Формат результата {@link renderSpans}. */
 declare const SpanRenderFormat: Readonly<{
@@ -5214,5 +5720,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 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 };
+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 AttemptContext, type AttemptExtensions, type AttemptInterceptor, type AttemptNext, type AudioMimeType, type AuthEvents, type AuthIdentity, type AuthInput, type AuthResource, type AuthState, type Author, type AutoSpansOptions, BUILT_IN_SERVICES, type BuilderInput, type BuiltInOperationId, type CaptchaCredentials, type ChangelogEntry, type Clan, type ClientHooks, type ClientPlugin, 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, type CustomOperationId, 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 EnumerableKeyValueStore, 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, ItdRateLimitError, ItdRealtime, ItdServerError, type ItdSession, ItdStateError, ItdTimeoutError, ItdValidationError, type KeyValueCodec, type KeyValueStore, type KeyValueStoreKeys, type KeyValueStoreResult, LIBRARY_VERSION, type LazyFile, type LikeResult, LikesVisibility, type Listener, type Logger, type Loose, MAX_RECONNECT_ATTEMPTS, type MarkupBuilder, type MarkupContent, type MarkupInput, type MarkupSpan, MemoryKeyValueStore, MemoryMultiTokenStorage, MemoryTokenStorage, type MultiTokenStorage, type MultiTokenStorageAdapterOptions, type MyProfile, NOTIFICATION_TYPE_ALIASES, type Notification, type NotificationEvent, type NotificationEventOfType, type NotificationListParams, type NotificationOfType, type NotificationSettings, NotificationType, type NotificationsResource, OPERATIONS, type OperationDefinition, type OperationExtensions, type OperationId, type OperationMethod, type OperationRequestOptions, type OperationTransformer, type Page, type PageState, PaginationMode, type PaginationOptions, Paginator, type PaginatorOptions, type ParseMarkupOptions, type PaymentMethod, type PhotoOpenInput, type Pin, type PinPostResult, type PinsResult, type PlatformClientVersion, type PlatformResource, type PlatformStatus, type PlatformVersions, type PluginApi, 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, type RateLimitOptions, type RateLimitScope, type RawRequestOptions, RealtimeComposer, type RealtimeContext, type RealtimeContextBase, type RealtimeDeps, type RealtimeEngineEvents, type RealtimeErrorBoundary, type RealtimeErrorContext, type RealtimeEvents, type RealtimeFilter, type RealtimeHandler, type RealtimeMiddleware, type RealtimeMiddlewareGroup, type RealtimeMiddlewareLike, type RealtimeMiddlewareObj, type RealtimeNext, type RealtimeNotificationContext, type RealtimeNotificationFilter, type RealtimeNotificationSelector, type RealtimeNotificationUpdate, type RealtimeOptions, type RealtimePredicate, type RealtimeRouteSelector, type RealtimeRouteTable, RealtimeRouter, type RealtimeSequentializer, RealtimeStatus, type RealtimeTransport, RealtimeTransportKind, type RealtimeTypeGuard, type RealtimeUnknownUpdate, type RealtimeUnreadCountUpdate, type RealtimeUpdate, type RealtimeUpdateOfType, RealtimeUpdateOrigin, RealtimeUpdateType, type ReconnectOptions, type RecordKeyValueStoreSource, type RemoveAccountOptions, type RenderSpansOptions, type RepliesParams, type Report, type ReportBuilder, type ReportInput, ReportReason, ReportTargetType, type ReportsResource, type RequestContext, type RequestExtensions, type RequestOptions, type ResetPasswordInput, type ResponseContext, type RetryContext, type RetryDecisionContext, type RetryOptions, RetrySafety, 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 TokenStorageAdapterOptions, 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, WEBSOCKET_PATH, WallAccess, type WebSocketImplementationOptions, type WebSocketLike, type WebSocketOpenFailureClassifier, WebSocketTransport, type WebSocketTransportOptions, autoSpans, canonicalNotificationType, comment, createAccounts, createClient, createKeyValueStore, createMultiTokenStorage, createRecordKeyValueStore, createTokenStorage, formatNotificationText, fromStream, fromUrl, isBuilder, isBuiltInOperationId, isEnumerableKeyValueStore, isItdApiError, isItdAuthError, isItdConflictError, isItdError, isItdFileError, isItdForbiddenError, isItdNotFoundError, isItdPhoneVerificationError, isItdRateLimitError, isItdServerError, isItdStateError, isItdValidationError, isKnownNotificationType, isMyProfile, mapPage, markup, normalizeNotification, operationMethod, operationRetrySafety, parseHtml, parseMarkdown, poll, post, readNotificationEvent, readUnreadCountEvent, renderSpans, report, resolveNotificationUrl, runRealtimeMiddleware, scopedTokenStorage, statusDays, systemClock, toDate, utcStampToIso, withCodec, withNamespace };
 //# sourceMappingURL=index.d.cts.map