itd-api 0.7.2 → 0.9.0

package/dist/shared/websocket-DYKBr8HF.d.ts

@@ -1,562 +0,0 @@
-import { B as Notification, Ft as Logger, Mt as Unsubscribe, R as NotificationEvent, St as RealtimeStatus, Xt as QueryParams, et as AuthIdentity, jt as Listener, rn as BuiltInOperationId, tn as ItdClock, xt as NotificationType } from "./url-DTfZ2toq.js";
-//#region src/realtime/transports/transport.d.ts
-/** Запрос транспорта к конвейеру клиента. */
-interface RealtimeRequestInput {
-  operationId: BuiltInOperationId;
-  path: string;
-  query?: QueryParams | undefined;
-  /**
-   * Отмена запроса. Опрос передаёт сигнал своего соединения; разовое чтение счётчика
-   * непрочитанных отменять нечем — оно живёт вне цикла соединения.
-   */
-  signal?: AbortSignal | undefined;
-}
-/**
- * Порт к конвейеру клиента: очередь, авторизация, повторы, плагины и хуки.
- *
- * Ответ приходит уже разобранным и без обёртки `{ data: … }`, а неудача — типизированной
- * ошибкой библиотеки.
- */
-type RealtimeRequest = (input: RealtimeRequestInput) => Promise<unknown>;
-/** Событие, пришедшее по каналу реального времени. */
-interface TransportEvent {
-  /** Имя события: `notification`, `unread_count` и другие. */
-  name: string;
-  /** Полезная нагрузка, уже разобранная из JSON. */
-  data: unknown;
-}
-/** Что транспорт получает от клиента при подключении. */
-interface TransportContext {
-  /** Базовый URL API. */
-  baseUrl: string;
-  /** Разрешено ли передавать токен этому сервису. */
-  authorize: boolean;
-  /** Реализация `fetch`. */
-  fetch: typeof fetch;
-  /**
-   * Выполнение обычных HTTP-запросов транспорта через конвейер клиента.
-   *
-   * Есть только у потока, созданного клиентом: конвейер принадлежит ему.
-   */
-  request?: RealtimeRequest | undefined;
-  /**
-   * Общие заголовки клиента: `User-Agent`, `X-Device-Id`, заголовки конфигурации
-   * и cookie для указанного адреса.
-   */
-  baseHeaders: (url: string) => Promise<Headers>;
-  /** Текущий токен доступа. */
-  getToken: () => Promise<string | null>;
-  /** Отмена подключения. */
-  signal: AbortSignal;
-  /** Сообщает о полученном событии. */
-  onEvent: (event: TransportEvent) => void;
-  /** Сообщает о разобранном, но некорректном сообщении. Соединение при этом живёт. */
-  onParseError: (error: unknown, raw: string) => void;
-  /** Вызывается, когда соединение установлено. */
-  onOpen: () => void;
-}
-/** Канал получения исходных событий в реальном времени. */
-interface RealtimeTransport {
-  /** Понятное имя для логов и диагностики. */
-  readonly name: string;
-  /**
-   * Держит соединение, пока оно живо.
-   *
-   * Должен завершиться, когда поток закрылся, и бросить исключение при ошибке.
-   * Отмена через `context.signal` должна приводить к `AbortError`.
-   */
-  connect(context: TransportContext): Promise<void>;
-}
-/** Ошибка, по которой видно, что сервер отверг авторизацию потока. */
-declare class UnauthorizedStreamError extends Error {
-  constructor();
-}
-//#endregion
-//#region src/realtime/updates.d.ts
-/** Типы нормализованных обновлений потока. */
-declare const RealtimeUpdateType: Readonly<{
-  readonly Notification: "notification";
-  readonly UnreadCount: "unreadCount";
-  readonly Unknown: "unknown";
-}>;
-/** Источники нормализованных обновлений потока. */
-declare const RealtimeUpdateOrigin: Readonly<{
-  readonly Stream: "stream";
-  readonly Sync: "sync";
-}>;
-type RealtimeUpdateOrigin = (typeof RealtimeUpdateOrigin)[keyof typeof RealtimeUpdateOrigin];
-/** Уведомление с типом, суженным фильтром потока. */
-type NotificationOfType<T extends NotificationType> = Omit<Notification, 'type'> & {
-  type: T;
-};
-/** Конверт уведомления с типом, суженным фильтром потока. */
-type NotificationEventOfType<T extends NotificationType> = Omit<NotificationEvent, 'notification'> & {
-  notification: NotificationOfType<T>;
-};
-/** Нормализованное уведомление из потока. */
-interface RealtimeNotificationUpdate<T extends NotificationType = NotificationType> {
-  readonly type: typeof RealtimeUpdateType.Notification;
-  readonly data: NotificationEventOfType<T>;
-}
-/** Актуальное число непрочитанных уведомлений. */
-interface RealtimeUnreadCountUpdate {
-  readonly type: typeof RealtimeUpdateType.UnreadCount;
-  readonly data: number;
-}
-/** Неизвестное библиотеке событие потока. */
-interface RealtimeUnknownUpdate {
-  readonly type: typeof RealtimeUpdateType.Unknown;
-  readonly name: string;
-  readonly data: unknown;
-}
-/** Данные, проходящие через промежуточные обработчики потока. */
-type RealtimeUpdate = RealtimeNotificationUpdate | RealtimeUnreadCountUpdate | RealtimeUnknownUpdate;
-/** Тип нормализованного обновления потока. */
-type RealtimeUpdateType = RealtimeUpdate['type'];
-/** Обновление потока указанного типа. */
-type RealtimeUpdateOfType<T extends RealtimeUpdateType> = Extract<RealtimeUpdate, {
-  type: T;
-}>;
-/**
- * Общая форма контекста обработки: то, что есть у любого потока независимо от домена.
- *
- * Контекст — обычный объектный литерал, а не класс с геттерами и не `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: 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>>;
-/** Условия отбора уведомлений. Все указанные поля объединяются через логическое И. */
-interface RealtimeNotificationFilter<T extends NotificationType = NotificationType> {
-  /** Один или несколько канонических типов уведомления. */
-  type?: T | readonly T[];
-  /** Идентификатор хотя бы одного участника уведомления. */
-  actorId?: string;
-  /** Идентификатор объекта события. */
-  entityId?: string | null;
-  /** Идентификатор родительского объекта. */
-  parentEntityId?: string | null;
-  /** Дополнительная проверка после сопоставления полей. */
-  predicate?: (context: RealtimeNotificationContext<T>) => boolean;
-}
-/** Краткая или объектная форма фильтра уведомлений. */
-type RealtimeNotificationSelector<T extends NotificationType = NotificationType> = T | readonly T[] | RealtimeNotificationFilter<T>;
-//#endregion
-//#region src/realtime/middleware.d.ts
-/** Продолжает цепочку промежуточных обработчиков потока. */
-type RealtimeNext = () => Promise<void>;
-/** Обрабатывает обновление потока до его передачи подписчикам. */
-type RealtimeMiddleware<C extends RealtimeContextBase = RealtimeContext> = (context: C, next: RealtimeNext) => void | Promise<void>;
-/** Объект, предоставляющий снимок промежуточного обработчика потока. */
-interface RealtimeMiddlewareObj<C extends RealtimeContextBase = RealtimeContext> {
-  middleware(): RealtimeMiddleware<C>;
-}
-/** Асинхронный обработчик нормализованного обновления потока. */
-type RealtimeHandler<C extends RealtimeContextBase = RealtimeContext> = (context: C) => unknown | Promise<unknown>;
-/** Условие отбора контекста потока. */
-type RealtimePredicate<C extends RealtimeContextBase = RealtimeContext> = (context: C) => boolean;
-/** Проверка, сужающая тип контекста потока. */
-type RealtimeTypeGuard<C extends B, B extends RealtimeContextBase = RealtimeContext> = (context: B) => context is C;
-/** Ключи, по которым обновления нельзя обрабатывать одновременно. */
-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
-/** Настройки переподключения. */
-interface ReconnectOptions {
-  /** Таблица пауз. Последнее значение действует для всех дальнейших попыток. */
-  backoff?: readonly number[];
-  /** Доля разброса, 0…1. */
-  jitter?: number;
-  /** Предел числа попыток. */
-  maxAttempts?: number;
-}
-//#endregion
-//#region src/realtime/engine.d.ts
-/**
- * События, которые движок рассылает сам.
- *
- * Ни одно из них не зависит от домена, поэтому они одинаковы у любого потока.
- * Домен расширяет эту карту своими событиями.
- */
-interface RealtimeEngineEvents<C extends RealtimeContextBase = RealtimeContextBase> {
-  /** Изменилось состояние соединения. */
-  status: RealtimeStatus;
-  /** Соединение оборвалось; будет предпринята попытка переподключения. */
-  error: {
-    error: unknown;
-    willReconnect: boolean;
-  };
-  /** Сообщение не удалось разобрать. Соединение при этом продолжает работать. */
-  parseError: {
-    error: unknown;
-    raw: string;
-  };
-  /** Запланировано переподключение. */
-  reconnect: {
-    attempt: number;
-    delay: number;
-  };
-  /** Попытки исчерпаны — соединение восстановится только ручным `connect()`. */
-  giveup: undefined;
-  /** Любой исходный кадр транспорта. Отправляется до нормализации и обработчиков. */
-  message: TransportEvent;
-  /** Промежуточный обработчик потока завершился исключением. */
-  middlewareError: {
-    error: unknown;
-    context: C;
-  };
-  /** Обработчик обновления завершился исключением. */
-  handlerError: {
-    error: unknown;
-    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<{
-  /** Поток событий, если среда умеет читать тело по частям, иначе опрос. */
-  readonly Auto: "auto";
-  /** Поток `text/event-stream`. */
-  readonly Sse: "sse";
-  /** Периодический опрос REST. */
-  readonly Poll: "poll";
-}>;
-type RealtimeTransportKind = (typeof RealtimeTransportKind)[keyof typeof RealtimeTransportKind];
-/** Настройки потока уведомлений. */
-interface RealtimeOptions<C extends RealtimeContext = RealtimeContext> extends ReconnectOptions {
-  /**
-   * Транспорт. По умолчанию `auto`: поток событий, если среда умеет читать тело ответа
-   * по частям, иначе опрос.
-   *
-   * Можно передать и свою реализацию {@link RealtimeTransport} — это пригодится, если
-   * у платформы появится WebSocket либо нужен нестандартный способ доставки.
-   */
-  transport?: RealtimeTransportKind | RealtimeTransport;
-  /**
-   * Молчание сервера, после которого соединение считается мёртвым, мс. По умолчанию 90 000.
-   *
-   * Сервер не присылает keep-alive, поэтому без этой проверки оборванное соединение
-   * может незаметно «зависнуть».
-   */
-  idleTimeout?: number;
-  /**
-   * Сколько ждать ответа на запрос потока, прежде чем оборвать попытку, мс. По умолчанию
-   * 20 000. Защищает от зависания на установке соединения, когда {@link idleTimeout} ещё
-   * не действует. `0` отключает проверку. Только для потокового транспорта.
-   */
-  handshakeTimeout?: number;
-  /** Как часто опрашивать сервер, если используется запасной транспорт. */
-  pollInterval?: number;
-  /**
-   * Запрашивать число непрочитанных при подключении. По умолчанию `true`.
-   *
-   * Так поступает сайт итд.com: поток присылает только новые события, а начальное
-   * значение счётчика нужно получить отдельно.
-   */
-  syncCount?: boolean;
-  /**
-   * Переподключаться, когда вкладка снова становится видимой. По умолчанию `true`.
-   *
-   * Только в браузере. У сайта итд.com такой обработки нет, из-за чего вкладка,
-   * пролежавшая в фоне, может остаться без соединения.
-   */
-  reconnectOnVisible?: boolean;
-  /** Переподключаться при восстановлении сети. По умолчанию `true`. Только в браузере. */
-  reconnectOnOnline?: boolean;
-  /** Максимальное число одновременно обрабатываемых обновлений. По умолчанию 1. */
-  concurrency?: number;
-  /** Возвращает ключи обновлений, которые нельзя обрабатывать одновременно. */
-  sequentialize?: RealtimeSequentializer<C>;
-}
-/** Что поток получает от клиента. */
-interface RealtimeDeps {
-  baseUrl: string;
-  /** Разрешено ли транспорту передавать токен этому сервису. */
-  authorize?: boolean | undefined;
-  fetch: typeof fetch;
-  /** Конвейер клиента — см. {@link TransportContext.request}. */
-  request?: RealtimeRequest | undefined;
-  clock?: ItdClock;
-  /** Общие заголовки клиента для адреса — см. {@link TransportContext.baseHeaders}. */
-  baseHeaders: (url: string) => Promise<Headers>;
-  /** Идентификаторы аккаунта и сессии создавшего поток клиента. */
-  getAuthIdentity?: (() => AuthIdentity) | undefined;
-  /** Непрозрачная область авторизации создавшего поток клиента. */
-  getAuthScope?: (() => string) | undefined;
-  getToken: () => Promise<string | null>;
-  /** Обновляет токен после отказа авторизации. Возвращает `true`, если удалось. */
-  refresh: () => Promise<boolean>;
-  /** Загружает начальное число непрочитанных. */
-  fetchUnreadCount: () => Promise<number>;
-  /** Вызывается при явном закрытии потока. */
-  onClose?: (() => void) | undefined;
-  /** Вызывается при запуске ранее закрытого потока. */
-  onConnect?: (() => void) | undefined;
-  logger?: Logger | undefined;
-}
-/**
- * Поток уведомлений в реальном времени.
- *
- * Получается вызовом `itd.realtime()`. Соединение поднимается методом {@link connect}
- * и держится само: обрывы, обновление токена и повторные попытки библиотека берёт на себя.
- *
- * Параметр типа задаёт форму контекста: плагин может расширить её своими полями
- * (`ItdRealtime<RealtimeContext & SessionFlavor<S>>`) и типизировать обработчики.
- *
- * @example
- * ```ts
- * import { NotificationType } from 'itd-api';
- *
- * const stream = itd.realtime();
- *
- * stream.onNotification(NotificationType.PostComment, async ({ update }) => {
- *   await saveCommentNotification(update.data.notification);
- * });
- * stream.on('status', (status) => console.log('соединение:', status));
- *
- * await stream.connect();
- * // …позже
- * stream.disconnect();
- * await stream.drain();
- * ```
- */
-declare class ItdRealtime<C extends RealtimeContext = RealtimeContext> {
-  #private;
-  constructor(deps: RealtimeDeps, options?: RealtimeOptions<C>);
-  /** Текущее состояние соединения. */
-  get status(): RealtimeStatus;
-  /** Имя используемого транспорта. */
-  get transport(): string;
-  /** Базовый URL клиента, создавшего поток. @internal */
-  get baseUrl(): string;
-  /** Идентификаторы аккаунта и сессии клиента, создавшего поток. @internal */
-  getAuthIdentity(): AuthIdentity | undefined;
-  /** Непрозрачная область авторизации создавшего поток клиента. @internal */
-  getAuthScope(): string | undefined;
-  /** Подписывается на событие потока. @returns функция отписки */
-  on<K extends keyof RealtimeEvents<C>>(event: K, listener: Listener<RealtimeEvents<C>[K]>): Unsubscribe;
-  /** Подписывается на одно срабатывание. */
-  once<K extends keyof RealtimeEvents<C>>(event: K, listener: Listener<RealtimeEvents<C>[K]>): Unsubscribe;
-  /**
-   * Добавляет промежуточный обработчик или объект, предоставляющий его через `middleware()`.
-   *
-   * Обработчики выполняются в порядке регистрации. Если `next()` не вызван, обновление не
-   * передаётся дальше по цепочке, асинхронным обработчикам и слушателям событий.
-   *
-   * @returns функция удаления обработчика
-   */
-  use(middleware: RealtimeMiddleware<C> | RealtimeMiddlewareObj<C>): Unsubscribe;
-  /** Подписывает асинхронный обработчик на все нормализованные обновления. */
-  onUpdate(handler: RealtimeHandler<C>): Unsubscribe;
-  /** Подписывает асинхронный обработчик на обновление указанного типа. */
-  onUpdate<T extends RealtimeUpdateType>(type: T, handler: RealtimeHandler<C & RealtimeContext<RealtimeUpdateOfType<T>>>): Unsubscribe;
-  /** Подписывает асинхронный обработчик по функции сужения типа. */
-  onUpdate<N extends C>(guard: RealtimeTypeGuard<N, C>, handler: RealtimeHandler<N>): Unsubscribe;
-  /** Подписывает асинхронный обработчик по пользовательскому условию. */
-  onUpdate(predicate: RealtimePredicate<C>, handler: RealtimeHandler<C>): Unsubscribe;
-  /** Подписывает асинхронный обработчик на уведомления, подходящие под фильтр. */
-  onNotification<T extends NotificationType>(selector: RealtimeNotificationSelector<T>, handler: RealtimeHandler<C & RealtimeNotificationContext<T>>): Unsubscribe;
-  /** Подписывает асинхронный обработчик по функции сужения типа уведомления. */
-  onNotification<N extends C & RealtimeNotificationContext>(guard: (context: C & RealtimeNotificationContext) => context is N, handler: RealtimeHandler<N>): Unsubscribe;
-  /** Подписывает асинхронный обработчик по пользовательскому условию. */
-  onNotification(predicate: (context: C & RealtimeNotificationContext) => boolean, handler: RealtimeHandler<C & RealtimeNotificationContext>): Unsubscribe;
-  /**
-   * Поднимает соединение.
-   *
-   * Повторный вызов при уже живом соединении ничего не делает — это защита от двойного
-   * подключения при перерисовке интерфейса.
-   *
-   * Возвращает управление сразу после запуска: соединение живёт в фоне.
-   *
-   * @throws если создавший поток клиент уже освобождён
-   */
-  connect(): Promise<void>;
-  /** Закрывает соединение и отменяет запланированные попытки. */
-  disconnect(): void;
-  /** Ждёт завершения всех принятых обновлений. */
-  drain(): Promise<void>;
-  /** Снимает подписки `on()` и `once()`. Остальные обработчики остаются. */
-  removeAllListeners(): void;
-}
-//#endregion
-//#region src/realtime/router.d.ts
-/** Выбирает маршрут обновления. `undefined` и `null` означают отсутствие маршрута. */
-type RealtimeRouteSelector<K extends PropertyKey, C extends RealtimeContextBase = RealtimeContext> = (context: C) => K | null | undefined | Promise<K | null | undefined>;
-/**
- * Направляет обновления потока в именованные цепочки промежуточных обработчиков.
- *
- * @example
- * ```ts
- * import { RealtimeRouter, RealtimeUpdateType } from 'itd-api';
- *
- * const router = new RealtimeRouter((context) => context.update.type);
- * router.route(RealtimeUpdateType.Notification, async (context, next) => {
- *   if (context.update.type === RealtimeUpdateType.Notification) {
- *     await handleNotification(context.update.data.notification);
- *   }
- *   await next();
- * });
- * stream.use(router);
- * ```
- */
-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(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/transports/websocket.d.ts
-/** Дополнительные параметры конструктора, поддерживаемые 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
-export { NotificationOfType as A, RealtimeUpdateOfType as B, RealtimeMiddlewareObj as C, RealtimeTypeGuard as D, RealtimeSequentializer as E, RealtimeNotificationSelector as F, RealtimeTransport as G, RealtimeUpdateType as H, RealtimeNotificationUpdate as I, UnauthorizedStreamError as J, TransportContext as K, RealtimeUnknownUpdate as L, RealtimeContextBase as M, RealtimeNotificationContext as N, runRealtimeMiddleware as O, RealtimeNotificationFilter as P, RealtimeUnreadCountUpdate as R, RealtimeMiddleware as S, RealtimePredicate as T, RealtimeRequest as U, RealtimeUpdateOrigin as V, RealtimeRequestInput as W, RealtimeOptions as _, WebSocketTransportOptions as a, ReconnectOptions as b, RealtimeErrorContext as c, RealtimeMiddlewareLike as d, RealtimeRouteTable as f, RealtimeEvents as g, ItdRealtime as h, WebSocketTransport as i, RealtimeContext as j, NotificationEventOfType as k, RealtimeFilter as l, RealtimeRouter as m, WebSocketLike as n, RealtimeComposer as o, RealtimeRouteSelector as p, TransportEvent as q, WebSocketOpenFailureClassifier as r, RealtimeErrorBoundary as s, WebSocketImplementationOptions as t, RealtimeMiddlewareGroup as u, RealtimeTransportKind as v, RealtimeNext as w, RealtimeHandler as x, RealtimeEngineEvents as y, RealtimeUpdate as z };
-//# sourceMappingURL=websocket-DYKBr8HF.d.ts.map