itd-api 0.5.0 → 0.6.0

package/dist/index.js

@@ -1,5 +1,5 @@
-import { C as joinUrl, S as isSameSite, T as originOf, _ as REFRESH_COOKIE, a as scopedTokenStorage, b as encodePathSegment, c as isBoundedFileStream, d as optionalBytes, f as DEFAULT_FILE_STREAM_BUFFER_BYTES, g as CookieJar, h as AUTH_FLAG_COOKIE, i as isRestorableSession, l as isReadableByteStream, m as FileTransferMode, n as controlledTokenStorage, o as resolveFileStreamOptions, p as DEFAULT_URL_FILE_MAX_BYTES, r as createMultiTokenStorage, s as boundedFileStream, t as MemoryMultiTokenStorage, u as fileTooLarge, v as REFRESH_COOKIE_PATH, w as normalizeBaseUrl, x as hostOf, y as buildQuery } from "./multi-storage-B0r0AInH.js";
-import { A as isItdApiError, B as isItdStateError, C as ItdNotFoundError, D as ItdStateError, E as ItdServerError, F as isItdForbiddenError, I as isItdNotFoundError, L as isItdPhoneVerificationError, M as isItdConflictError, N as isItdError, O as ItdTimeoutError, P as isItdFileError, R as isItdRateLimitError, S as ItdNetworkError, T as ItdRateLimitError, V as isItdValidationError, _ as ItdError, b as ItdFileErrorReason, c as isEnumerableKeyValueStore, d as ItdAbortError, f as ItdApiError, g as ItdConflictError, h as ItdConfigError, i as MemoryKeyValueStore, j as isItdAuthError, k as ItdValidationError, l as withCodec, m as ItdAuthError, n as copySession, o as createKeyValueStore, p as ItdApiErrorKind, r as createTokenStorage, s as createRecordKeyValueStore, t as MemoryTokenStorage, u as withNamespace, v as ItdErrorKind, w as ItdPhoneVerificationError, x as ItdForbiddenError, y as ItdFileError, z as isItdServerError } from "./storage-DWrK3Z4M.js";
+import { C as normalizeBaseUrl, S as joinUrl, _ as REFRESH_COOKIE_PATH, a as scopedTokenStorage, b as hostOf, c as isBoundedFileStream, d as optionalBytes, f as DEFAULT_URL_FILE_MAX_BYTES, g as REFRESH_COOKIE, h as CookieJar, i as isRestorableSession, l as isReadableByteStream, n as controlledTokenStorage, o as resolveFileStreamOptions, p as FileTransferMode, r as createMultiTokenStorage, s as boundedFileStream, t as MemoryMultiTokenStorage, u as fileTooLarge, v as buildQuery, w as originOf, x as isSameSite, y as encodePathSegment } from "./multi-storage-BUZaLAPO.js";
+import { A as isItdApiError, B as isItdStateError, C as ItdNotFoundError, D as ItdStateError, E as ItdServerError, F as isItdForbiddenError, I as isItdNotFoundError, L as isItdPhoneVerificationError, M as isItdConflictError, N as isItdError, O as ItdTimeoutError, P as isItdFileError, R as isItdRateLimitError, S as ItdNetworkError, T as ItdRateLimitError, V as isItdValidationError, _ as ItdError, b as ItdFileErrorReason, c as isEnumerableKeyValueStore, d as ItdAbortError, f as ItdApiError, g as ItdConflictError, h as ItdConfigError, i as MemoryKeyValueStore, j as isItdAuthError, k as ItdValidationError, l as withCodec, m as ItdAuthError, n as copySession, o as createKeyValueStore, p as ItdApiErrorKind, r as createTokenStorage, s as createRecordKeyValueStore, t as MemoryTokenStorage, u as withNamespace, v as ItdErrorKind, w as ItdPhoneVerificationError, x as ItdForbiddenError, y as ItdFileError, z as isItdServerError } from "./storage-IHdXw52v.js";
 //#region src/core/emitter.ts
 /**
 * Минимальный типизированный источник событий.
@@ -434,6 +434,14 @@ const OPERATIONS = freezeOperations({
 		method: "PUT",
 		retrySafety: RetrySafety.Idempotent
 	},
+	"realtime.poll.updates": {
+		method: "GET",
+		retrySafety: RetrySafety.Safe
+	},
+	"realtime.poll.unread": {
+		method: "GET",
+		retrySafety: RetrySafety.Safe
+	},
 	"hashtags.search": {
 		method: "GET",
 		retrySafety: RetrySafety.Safe
@@ -667,6 +675,11 @@ const AUTH_PATHS = {
 * Нужен, чтобы отрисовать виджет капчи и получить токен для `signIn`, `signUp`
 * и `forgotPassword`.
 *
+* Ключ привязан к домену: на чужом origin Cloudflare отказывает виджету с кодом `110200`.
+* Поэтому отрисовать его может только код, выполняемый на самом итд.com. Остальным
+* подходит `@itd-api/turnstile`, готовый токен из другого источника или вовсе вход
+* без капчи — по сохранённой сессии либо по токенам, взятым в браузере.
+*
 * @example
 * ```ts
 * turnstile.render('#captcha', {
@@ -676,8 +689,6 @@ const AUTH_PATHS = {
 * ```
 */
 const TURNSTILE_SITE_KEY = "0x4AAAAAACHhxczw6fJGwPBg";
-/** Заголовок с идентификатором устройства. Сервер связывает с ним запись в списке сессий. */
-const DEVICE_ID_HEADER = "X-Device-Id";
 function readAccessToken(payload) {
 	if (typeof payload !== "object" || payload === null) return void 0;
 	const token = payload.accessToken;
@@ -1182,10 +1193,33 @@ const systemClock = Object.freeze({
 		return () => clearTimeout(timer);
 	}
 });
+/**
+* Заводит срок, общий на все ожидания: от ожидания к ожиданию он не продлевается.
+*
+* @param timeout срок в миллисекундах; `0` — ждать без ограничения
+* @internal
+*/
+function createDeadline(timeout, clock = systemClock) {
+	if (timeout <= 0) return {
+		wait: async (promise) => {
+			await promise;
+			return true;
+		},
+		cancel: () => {}
+	};
+	let expire;
+	const expired = new Promise((resolve) => {
+		expire = resolve;
+	});
+	return {
+		wait: (promise) => Promise.race([promise.then(() => true), expired.then(() => false)]),
+		cancel: clock.schedule(() => expire(), timeout)
+	};
+}
 //#endregion
 //#region src/core/version.ts
 /** Версия библиотеки. Попадает в `User-Agent`. */
-const LIBRARY_VERSION = "0.5.0";
+const LIBRARY_VERSION = "0.6.0";
 //#endregion
 //#region src/core/config.ts
 /** Базовый URL API итд.com. Домен записан в punycode: `итд.com`. */
@@ -1200,8 +1234,6 @@ const BUILT_IN_SERVICES = Object.freeze([Object.freeze({
 	baseUrl: DEFAULT_STATUS_BASE_URL,
 	auth: false
 })]);
-/** Таймаут запроса по умолчанию — 30 секунд. */
-const DEFAULT_TIMEOUT = 3e4;
 /**
 * `User-Agent` по умолчанию.
 *
@@ -1411,6 +1443,7 @@ function resolveConfig(options = {}) {
 	const mode = options.mode ?? RuntimeMode.Auto;
 	if (!Object.values(RuntimeMode).includes(mode)) throw new ItdConfigError(`mode должен быть одним из ${Object.values(RuntimeMode).join(", ")}, получено: ${mode}`);
 	const timeout = requirePositive(options.timeout ?? 3e4, "timeout");
+	const shutdownTimeout = requirePositive(options.shutdownTimeout ?? 1e4, "shutdownTimeout");
 	if (options.clock !== void 0 && (typeof options.clock !== "object" || options.clock === null || typeof options.clock.now !== "function" || typeof options.clock.schedule !== "function")) throw new ItdConfigError("clock должен предоставлять методы now() и schedule()");
 	requireOptionalBoolean(options.autoRefresh, "autoRefresh");
 	requireOptionalBoolean(options.reloginOnRefreshFailure, "reloginOnRefreshFailure");
@@ -1426,6 +1459,7 @@ function resolveConfig(options = {}) {
 		fetch: resolveFetch(options.fetch),
 		clock: options.clock ?? systemClock,
 		timeout,
+		shutdownTimeout,
 		retry: resolveRetry(options.retry),
 		rateLimit: resolveRateLimit(options.rateLimit),
 		hooks: resolveHooks(options.hooks),
@@ -1994,7 +2028,11 @@ var PluginRegistry = class {
 	#entries = /* @__PURE__ */ new Map();
 	#removing = /* @__PURE__ */ new Set();
 	#cleanups = /* @__PURE__ */ new Set();
+	#options;
 	#ordered = [];
+	constructor(options) {
+		this.#options = options;
+	}
 	/** Сколько плагинов подключено. */
 	get size() {
 		return this.#entries.size;
@@ -2068,9 +2106,11 @@ var PluginRegistry = class {
 	* Отключает плагин и вызывает его функцию очистки.
 	*
 	* Новые запросы перестают видеть расширения плагина сразу. Снимок уже начавшейся операции,
-	* включая её будущие retry, остаётся неизменным; очистка дождётся завершения операции.
+	* включая её будущие retry, остаётся неизменным; очистка дождётся завершения операции,
+	* но не дольше отведённого срока.
 	*
 	* @returns `false`, если такого плагина не было
+	* @throws {ItdStateError} если операции плагина не завершились за отведённый срок
 	*/
 	async remove(name) {
 		const entry = this.#entries.get(name);
@@ -2079,21 +2119,24 @@ var PluginRegistry = class {
 		this.#entries.delete(name);
 		this.#ordered = this.#ordered.filter((current) => current !== entry);
 		this.#removing.add(name);
+		const deadline = createDeadline(this.#options.shutdownTimeout, this.#options.clock);
 		const cleanup = this.#trackCleanup((async () => {
-			await this.#waitForDrain(entry);
-			await entry.teardown?.();
+			const expired = await this.#release(entry, deadline);
+			if (expired) throw expired;
 		})());
 		try {
 			await cleanup;
 			return true;
 		} finally {
+			deadline.cancel();
 			this.#removing.delete(name);
 		}
 	}
 	/**
 	* Отключает все плагины окончательно.
 	*
-	* Очистка идёт изнутри наружу — в порядке, обратном выполнению расширений.
+	* Очистка идёт изнутри наружу — в порядке, обратном выполнению расширений. Срок ожидания
+	* общий на все плагины.
 	*/
 	async dispose() {
 		const entries = [...this.#ordered].reverse();
@@ -2101,13 +2144,14 @@ var PluginRegistry = class {
 		this.#entries.clear();
 		this.#ordered = [];
 		for (const { plugin } of entries) this.#removing.add(plugin.name);
-		await this.#trackCleanup((async () => {
+		const deadline = createDeadline(this.#options.shutdownTimeout, this.#options.clock);
+		const cleanup = this.#trackCleanup((async () => {
 			const errors = [];
 			const previous = await Promise.allSettled(previousCleanups);
 			for (const result of previous) if (result.status === "rejected") errors.push(result.reason);
 			for (const entry of entries) try {
-				await this.#waitForDrain(entry);
-				await entry.teardown?.();
+				const expired = await this.#release(entry, deadline);
+				if (expired) errors.push(expired);
 			} catch (error) {
 				errors.push(error);
 			} finally {
@@ -2115,6 +2159,11 @@ var PluginRegistry = class {
 			}
 			if (errors.length > 0) throw new AggregateError(errors, "Не удалось освободить ресурсы плагинов");
 		})());
+		try {
+			await cleanup;
+		} finally {
+			deadline.cancel();
+		}
 	}
 	/**
 	* Прогоняет запрос через operation transformers и прикрепляет attempt interceptors.
@@ -2122,6 +2171,9 @@ var PluginRegistry = class {
 	* Снимки обеих цепочек берутся в начале: `unuse()` влияет на новые операции, но не меняет
 	* уже выполняющуюся и не удаляет interceptors из её последующих retry.
 	*
+	* Каждый `next` одноразовый: transformer может завершить операцию сам, но не может породить
+	* вторую — для `posts.create` это была бы вторая публикация.
+	*
 	* @param execute выполнение логической операции, вызываемое самым внутренним transformer
 	*/
 	async run(request, execute) {
@@ -2132,7 +2184,17 @@ var PluginRegistry = class {
 			interceptor
 		})));
 		const scoped = (current) => withAttemptInterceptorScope(current, interceptorScope);
-		const chain = entries.flatMap((entry) => entry.transformers).reduceRight((next, transformer) => (current) => transformer(scoped(current), (prepared) => next(scoped(prepared))), (current) => execute(scoped(current)));
+		const chain = entries.flatMap((entry) => entry.transformers.map((transformer) => ({
+			plugin: entry.plugin.name,
+			transformer
+		}))).reduceRight((next, { plugin, transformer }) => (current) => {
+			let called = false;
+			return transformer(scoped(current), (prepared) => {
+				if (called) throw new ItdConfigError(`operation transformer плагина «${plugin}» вызвал next() больше одного раза`);
+				called = true;
+				return next(scoped(prepared));
+			});
+		}, (current) => execute(scoped(current)));
 		try {
 			return await chain(scoped(request));
 		} finally {
@@ -2146,6 +2208,18 @@ var PluginRegistry = class {
 			}
 		}
 	}
+	/**
+	* Дожидается операций плагина и освобождает его ресурсы.
+	*
+	* `teardown` выполняется в любом случае, в том числе после истечения срока.
+	*
+	* @returns ошибка истёкшего срока, если ждать пришлось дольше отведённого
+	*/
+	async #release(entry, deadline) {
+		const finished = await deadline.wait(this.#waitForDrain(entry));
+		await entry.teardown?.();
+		return finished ? void 0 : new ItdStateError(`плагин «${entry.plugin.name}» не завершил операции за ${this.#options.shutdownTimeout} мс; ожидание прекращено, ресурсы плагина освобождены`);
+	}
 	#waitForDrain(entry) {
 		if (entry.activeRequests === 0) return Promise.resolve();
 		entry.drain ??= new Promise((resolve) => {
@@ -2318,6 +2392,7 @@ var RequestQueuePool = class {
 	stop() {
 		this.#main.stop();
 		for (const queue of this.#byDestination.values()) queue.stop();
+		this.#byDestination.clear();
 	}
 };
 //#endregion
@@ -2842,17 +2917,25 @@ function abortable(promise, signal) {
 	});
 }
 /**
-* Объединяет пользовательский `AbortSignal` с таймаутом.
+* Объединяет пользовательский `AbortSignal`, сигнал жизни клиента и таймаут.
 *
 * Реализовано вручную, а не через `AbortSignal.any`: последний появился только в Node 20,
-* а библиотека поддерживает Node 18.
+* а библиотека поддерживает Node 18. Причина отмены переносится от источника как есть.
 */
-function createAbortBundle(userSignal, timeout, clock) {
+function createAbortBundle(userSignal, lifetimeSignal, timeout, clock) {
 	const controller = new AbortController();
 	let timedOut = false;
-	const onUserAbort = () => controller.abort(userSignal?.reason);
-	if (userSignal) if (userSignal.aborted) controller.abort(userSignal.reason);
-	else userSignal.addEventListener("abort", onUserAbort, { once: true });
+	const link = (source) => {
+		if (!source) return void 0;
+		if (source.aborted) {
+			controller.abort(source.reason);
+			return;
+		}
+		const onAbort = () => controller.abort(source.reason);
+		source.addEventListener("abort", onAbort, { once: true });
+		return () => source.removeEventListener("abort", onAbort);
+	};
+	const unlink = [link(userSignal), link(lifetimeSignal)];
 	const cancelTimer = timeout > 0 ? clock.schedule(() => {
 		timedOut = true;
 		controller.abort();
@@ -2862,7 +2945,7 @@ function createAbortBundle(userSignal, timeout, clock) {
 		timedOut: () => timedOut,
 		cleanup: () => {
 			cancelTimer?.();
-			userSignal?.removeEventListener("abort", onUserAbort);
+			for (const detach of unlink) detach?.();
 		}
 	};
 }
@@ -2899,7 +2982,7 @@ var Transport = class {
 		const headers = await this.#buildHeaders(request, url);
 		const attempt = request.attempt ?? 1;
 		const timeout = request.timeout ?? this.#config.timeout;
-		const abort = createAbortBundle(request.signal, timeout, this.#config.clock);
+		const abort = createAbortBundle(request.signal, this.#deps.lifetimeSignal, timeout, this.#config.clock);
 		const startedAt = this.#config.clock.now();
 		let cleanupBody;
 		try {
@@ -3116,7 +3199,7 @@ var Transport = class {
 			path: request.path
 		});
 		if (aborted) {
-			const reason = request.signal?.reason;
+			const reason = abort.signal.reason;
 			return new ItdAbortError(`Запрос ${method} ${request.path} отменён`, reason !== void 0 ? { cause: reason } : void 0);
 		}
 		if (error instanceof ItdError) return error;
@@ -3157,8 +3240,12 @@ function createServiceRegistry(config) {
 function createClientRuntime(options = {}, internals = {}) {
 	const config = resolveConfig(options);
 	const jar = new CookieJar();
-	const plugins = new PluginRegistry();
+	const plugins = new PluginRegistry({
+		shutdownTimeout: config.shutdownTimeout,
+		clock: config.clock
+	});
 	const services = createServiceRegistry(config);
+	const lifetime = new AbortController();
 	const sharedQueues = config.rateLimit ? internals.queues : void 0;
 	const queues = sharedQueues ?? (config.rateLimit ? new RequestQueuePool(config.rateLimit, config.clock) : void 0);
 	const ownsQueues = sharedQueues === void 0;
@@ -3188,7 +3275,8 @@ function createClientRuntime(options = {}, internals = {}) {
 	}, {
 		cookies: config.useCookieJar ? jar : void 0,
 		getDeviceId: () => auth.getDeviceId(),
-		onRateLimit: queues && config.rateLimit?.respectHeaders ? throttleByHeaders : void 0
+		onRateLimit: queues && config.rateLimit?.respectHeaders ? throttleByHeaders : void 0,
+		lifetimeSignal: lifetime.signal
 	});
 	const stages = [
 		{
@@ -3265,9 +3353,10 @@ function createClientRuntime(options = {}, internals = {}) {
 		close: () => {
 			if (ownsQueues) queues?.stop();
 		},
-		dispose: () => {
+		dispose: async () => {
+			lifetime.abort(new ItdAbortError("Клиент освобождён через dispose(), запрос отменён"));
 			auth.dispose();
-			return plugins.dispose();
+			await plugins.dispose();
 		}
 	};
 }
@@ -3625,7 +3714,12 @@ var RealtimeDispatcher = class {
 			if (index >= 0) this.#handlers.splice(index, 1);
 		};
 	}
-	dispatch(context) {
+	/**
+	* Принимает обновление к обработке.
+	*
+	* @param coalesceKey ожидающая работа с тем же ключом заменяется новой
+	*/
+	dispatch(context, coalesceKey) {
 		let keys;
 		let middleware;
 		try {
@@ -3635,12 +3729,20 @@ var RealtimeDispatcher = class {
 			this.#hooks.middlewareError(error, context);
 			return;
 		}
-		this.#queue.push({
+		const replaced = coalesceKey === void 0 ? -1 : this.#queue.findIndex((pending) => pending.coalesceKey === coalesceKey);
+		if (replaced < 0 && this.#queue.length >= 256) {
+			this.#hooks.overflow();
+			return;
+		}
+		const work = {
 			context,
 			middleware,
 			handlers: [...this.#handlers],
-			keys
-		});
+			keys,
+			coalesceKey
+		};
+		if (replaced >= 0) this.#queue[replaced] = work;
+		else this.#queue.push(work);
 		this.#pump();
 	}
 	/** Отбрасывает обновления, обработка которых ещё не началась. */
@@ -3717,14 +3819,6 @@ const RECONNECT_BACKOFF = Object.freeze([
 	16e3,
 	3e4
 ]);
-/** Доля случайного разброса паузы. */
-const RECONNECT_JITTER = .3;
-/**
-* Сколько раз пытаться переподключиться подряд.
-*
-* После исчерпания поток сообщает `giveup` и ждёт ручного `connect()`.
-*/
-const MAX_RECONNECT_ATTEMPTS = 15;
 /**
 * Вычисляет паузу перед попыткой переподключения.
 *
@@ -4025,7 +4119,8 @@ var RealtimeEngine = class {
 		}, {
 			deliver: (context) => this.#deps.deliver(context.update),
 			middlewareError: (error, context) => this.#reportDispatchError("middlewareError", error, context),
-			handlerError: (error, context) => this.#reportDispatchError("handlerError", error, context)
+			handlerError: (error, context) => this.#reportDispatchError("handlerError", error, context),
+			overflow: () => this.#handleOverflow()
 		});
 	}
 	/** Текущее состояние соединения. */
@@ -4106,7 +4201,23 @@ var RealtimeEngine = class {
 	/** Пропускает актуальное обновление через цепочку обработчиков. */
 	#dispatch(update, raw, origin) {
 		if (!this.#wanted) return;
-		this.#dispatcher.dispatch(this.#deps.createContext(update, raw, origin));
+		this.#dispatcher.dispatch(this.#deps.createContext(update, raw, origin), this.#deps.coalesceKey?.(update));
+	}
+	/**
+	* Очередь обновлений достигла предела: закрывает соединение и переподключается,
+	* когда обработчики разберут очередь.
+	*/
+	#handleOverflow() {
+		const controller = this.#controller;
+		if (!this.#wanted || !controller) return;
+		const generation = this.#generation;
+		controller.abort();
+		this.#controller = void 0;
+		this.#setStatus(RealtimeStatus.Error);
+		const error = /* @__PURE__ */ new Error("Обработчики не успевают за потоком: очередь обновлений переполнена");
+		this.#dispatcher.drain().then(() => {
+			if (this.#isCurrentGeneration(generation) && !this.#controller) this.#scheduleReconnect(error);
+		});
 	}
 	/** Выполняет доменную синхронизацию, не роняя подключение из-за её ошибки. */
 	async #sync(reason, generation, starting) {
@@ -4131,6 +4242,7 @@ var RealtimeEngine = class {
 			baseUrl: this.#deps.baseUrl,
 			authorize: this.#deps.authorize,
 			fetch: this.#deps.fetch,
+			request: this.#deps.request,
 			baseHeaders: this.#deps.baseHeaders,
 			getToken: this.#deps.getToken,
 			signal: controller.signal,
@@ -4229,7 +4341,12 @@ var RealtimeEngine = class {
 		this.#starting = void 0;
 		if (this.#isCurrentGeneration(generation)) this.#run(generation);
 	}
-	/** Завершает автоматические попытки переподключения. */
+	/**
+	* Завершает автоматические попытки переподключения.
+	*
+	* Владелец узнаёт об этом так же, как при {@link disconnect}. `onClose` вызывается
+	* до событий: обработчик `giveup` может тут же вызвать `connect()`.
+	*/
 	#giveUp(error) {
 		this.#wanted = false;
 		this.#generation += 1;
@@ -4237,6 +4354,7 @@ var RealtimeEngine = class {
 		this.#attempt = 0;
 		this.#detachEnvironment?.();
 		this.#detachEnvironment = void 0;
+		this.#deps.onClose?.();
 		this.#emitEngine("error", {
 			error,
 			willReconnect: false
@@ -4309,26 +4427,15 @@ var PollTransport = class {
 		this.#limit = options.limit ?? 20;
 	}
 	async connect(context) {
+		const request = context.request;
+		if (!request) throw new ItdConfigError("опрос уведомлений выполняется через конвейер клиента; создайте поток вызовом itd.realtime()");
 		const seen = /* @__PURE__ */ new Set();
 		let firstRun = true;
 		let lastUnreadCount;
 		while (!context.signal.aborted) {
-			const token = context.authorize ? await context.getToken() : null;
-			if (context.authorize && !token) throw new UnauthorizedStreamError();
-			const url = `${joinUrl(context.baseUrl, "/api/notifications/")}?limit=${this.#limit}&offset=0`;
-			const headers = await context.baseHeaders(url);
-			headers.set("Accept", "application/json");
-			if (token) headers.set("Authorization", `Bearer ${token}`);
-			const response = await context.fetch(url, {
-				method: "GET",
-				headers,
-				signal: context.signal
-			});
-			if (context.authorize && response.status === 401) throw new UnauthorizedStreamError();
-			if (!response.ok) throw new Error(`Опрос уведомлений вернул статус ${response.status}`);
+			const payload = await this.#readUpdates(request, context.signal);
 			context.onOpen();
-			const body = await response.json();
-			const items = pickArray(typeof body === "object" && body !== null && "data" in body ? body.data : body, "notifications");
+			const items = pickArray(payload, "notifications");
 			for (const item of [...items].reverse()) {
 				const id = typeof item.id === "string" ? item.id : void 0;
 				if (!id || seen.has(id)) continue;
@@ -4342,7 +4449,7 @@ var PollTransport = class {
 				const excess = [...seen].slice(0, seen.size - this.#limit * 2);
 				for (const id of excess) seen.delete(id);
 			}
-			const count = await this.#readCount(context, headers);
+			const count = await this.#readCount(request, context.signal);
 			if (count !== void 0 && count !== lastUnreadCount) {
 				lastUnreadCount = count;
 				context.onEvent({
@@ -4354,16 +4461,29 @@ var PollTransport = class {
 			await this.#wait(context.signal);
 		}
 	}
-	async #readCount(context, headers) {
+	async #readUpdates(request, signal) {
 		try {
-			const response = await context.fetch(joinUrl(context.baseUrl, "/api/notifications/count"), {
-				method: "GET",
-				headers,
-				signal: context.signal
+			return await request({
+				operationId: "realtime.poll.updates",
+				path: "/api/notifications/",
+				query: {
+					limit: this.#limit,
+					offset: 0
+				},
+				signal
 			});
-			if (!response.ok) return void 0;
-			const body = await response.json();
-			return pickNumber(typeof body === "object" && body !== null && "data" in body ? body.data : body, "count", 0);
+		} catch (error) {
+			if (isItdAuthError(error)) throw new UnauthorizedStreamError();
+			throw error;
+		}
+	}
+	async #readCount(request, signal) {
+		try {
+			return pickNumber(await request({
+				operationId: "realtime.poll.unread",
+				path: "/api/notifications/count",
+				signal
+			}), "count", 0);
 		} catch {
 			return;
 		}
@@ -4723,6 +4843,7 @@ var ItdRealtime = class {
 			baseUrl: deps.baseUrl,
 			authorize: deps.authorize ?? true,
 			fetch: deps.fetch,
+			request: deps.request,
 			clock: deps.clock,
 			baseHeaders: deps.baseHeaders,
 			getToken: deps.getToken,
@@ -4733,6 +4854,7 @@ var ItdRealtime = class {
 			transport: createTransport(deps, options),
 			handleFrame: (event) => this.#handleFrame(event),
 			readUpdate: readRealtimeUpdate,
+			coalesceKey: (update) => update.type === RealtimeUpdateType.UnreadCount ? update.type : void 0,
 			createContext: (update, raw, origin) => ({
 				update,
 				stream: this,
@@ -6009,10 +6131,6 @@ function createMultipartFileBody(file) {
 		cancel
 	};
 }
-//#endregion
-//#region src/resources/files.ts
-/** Таймаут одной попытки загрузки файла — 5 минут. */
-const DEFAULT_UPLOAD_TIMEOUT = 3e5;
 /** Файлы и медиа. */
 var FilesResource = class extends BaseResource {
 	#fetch;
@@ -9094,6 +9212,11 @@ var ItdClient = class ItdClient {
 		stream = new ItdRealtime({
 			baseUrl: this.#runtime.config.baseUrl,
 			fetch: this.#runtime.config.fetch,
+			request: ({ operationId, path, query, signal }) => this.#runtime.http.operation(operationId, {
+				path,
+				query,
+				signal
+			}),
 			baseHeaders: (url) => this.#runtime.platformHeaders(url),
 			getAuthIdentity: () => this.#runtime.auth.getCurrentAuthIdentity(),
 			getAuthScope: () => this.#runtime.auth.getAuthScope(),
@@ -9113,13 +9236,16 @@ var ItdClient = class ItdClient {
 	* Освобождает ресурсы клиента: закрывает все потоки уведомлений, отправляет открытые
 	* накопители {@link telemetry}, затем останавливает очередь запросов.
 	*
-	* Метод дожидается активных обработчиков потока. После вызова клиентом можно пользоваться
-	* снова; ранее созданный поток можно запустить повторным `connect()`.
+	* Метод дожидается активных обработчиков потока, но не дольше `shutdownTimeout`. После
+	* вызова клиентом можно пользоваться снова; ранее созданный поток можно запустить
+	* повторным `connect()`.
 	*
 	* Общая очередь, полученная от {@link ItdAccounts}, не останавливается: её гасит сам
 	* контейнер, когда закрывает все аккаунты разом.
 	*
 	* Терминальное освобождение — это {@link dispose}.
+	*
+	* @throws {ItdStateError} если обработчики потока не завершились за отведённый срок
 	*/
 	async close() {
 		return this.#close(false);
@@ -9127,22 +9253,30 @@ var ItdClient = class ItdClient {
 	async #close(disposeCleanup) {
 		const streams = this.#disconnectStreams();
 		if (disposeCleanup) prepareTelemetryForDispose(this.#telemetry);
+		const { shutdownTimeout, clock } = this.#runtime.config;
+		const deadline = createDeadline(shutdownTimeout, clock);
+		let stuck = [];
 		try {
-			await Promise.all(streams.map((stream) => stream.drain()));
+			stuck = (await Promise.all(streams.map(async (stream) => await deadline.wait(stream.drain()) ? void 0 : stream))).filter((stream) => stream !== void 0);
 			if (disposeCleanup) await closeTelemetryForDispose(this.#telemetry);
 			else await this.#telemetry?.close();
 		} finally {
+			deadline.cancel();
 			this.#runtime.close();
 		}
+		if (stuck.length > 0) throw new ItdStateError(`обработчики потоков (${stuck.map((stream) => stream.transport).join(", ")}) не завершились за ${shutdownTimeout} мс; ожидание прекращено`);
 	}
 	/**
-	* Окончательно освобождает клиент: выполняет {@link close} и отключает все плагины.
+	* Окончательно освобождает клиент: выполняет {@link close}, отменяет незавершённые
+	* запросы и отключает все плагины.
 	*
 	* Терминальное состояние устанавливается сразу при первом вызове. После этого новые
 	* запросы, подключение плагинов, регистрация сервисов и создание или повторный запуск
 	* realtime-потоков завершаются с {@link ItdStateError}. Повторные вызовы возвращают
 	* тот же результат очистки.
 	*
+	* Ожидание обработчиков потока и операций плагинов ограничено `shutdownTimeout`.
+	*
 	* @example
 	* ```ts
 	* await using itd = new ItdClient({ auth: token });
@@ -10121,10 +10255,6 @@ var RealtimeComposer = class RealtimeComposer {
 		return (context, next) => runRealtimeMiddleware(snapshot, context, next);
 	}
 };
-//#endregion
-//#region src/realtime/websocket.ts
-/** Стандартный путь WebSocket-подключения. */
-const WEBSOCKET_PATH = "/api/ws";
 const CONNECTING = 0;
 const OPEN = 1;
 const NORMAL_CLOSURE = 1e3;
@@ -10262,6 +10392,7 @@ var WebSocketTransport = class {
 			let discardMessages = false;
 			let socketError;
 			let messageQueue = Promise.resolve();
+			let pendingFrames = 0;
 			let cancelHandshake;
 			let cancelIdle;
 			let cancelKeepAlive;
@@ -10340,7 +10471,13 @@ var WebSocketTransport = class {
 					pending = Promise.resolve({ error });
 				}
 				if (pending === void 0) return;
+				if (pendingFrames >= 256) {
+					closeWithError(/* @__PURE__ */ new Error(`WebSocket ${redactUrl(url)}: очередь кадров переполнена`), 4e3, "queue overflow");
+					return;
+				}
+				pendingFrames += 1;
 				messageQueue = messageQueue.then(async () => {
+					pendingFrames -= 1;
 					if (settled || discardMessages) return;
 					const decoded = await pending;
 					if ("error" in decoded) {
@@ -10633,6 +10770,6 @@ function renderSpans(content, spans = [], options = {}) {
 	return result;
 }
 //#endregion
-export { ALLOWED_MIME_TYPES, AUDIO_MIME_TYPES, AUTH_FLAG_COOKIE, AUTH_PATHS, AccessType, AttachmentType, BUILT_IN_SERVICES, CommentSort, 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, FeedTab, FileTransferMode, IMAGE_MIME_TYPES, IncidentKind, InteractionType, ItdAbortError, ItdAccounts, ItdApiError, ItdApiErrorKind, ItdAuthError, ItdClient, ItdConfigError, ItdConflictError, ItdError, ItdErrorCode, ItdErrorKind, ItdFileError, ItdFileErrorReason, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdPhoneVerificationError, ItdRateLimitError, ItdRealtime, ItdServerError, ItdStateError, ItdTimeoutError, ItdValidationError, LIBRARY_VERSION, LikesVisibility, MAX_RECONNECT_ATTEMPTS, MemoryKeyValueStore, MemoryMultiTokenStorage, MemoryTokenStorage, NOTIFICATION_TYPE_ALIASES, NotificationType, OPERATIONS, PaginationMode, Paginator, RECONNECT_BACKOFF, RECONNECT_JITTER, REFRESH_COOKIE, REFRESH_COOKIE_PATH, RealtimeComposer, RealtimeRouter, RealtimeStatus, RealtimeTransportKind, RealtimeUpdateOrigin, RealtimeUpdateType, ReportReason, ReportTargetType, RetrySafety, RuntimeMode, STATUS_SERVICE, STREAM_PATH, ServiceRegistry, ServiceState, SignInStatus, SpanRenderFormat, SpanType, TURNSTILE_SITE_KEY, UnauthorizedStreamError, VIDEO_MIME_TYPES, ViewReason, ViewSource, WEBSOCKET_PATH, WallAccess, WebSocketTransport, 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 };
+export { ALLOWED_MIME_TYPES, AUDIO_MIME_TYPES, AccessType, AttachmentType, CommentSort, DEFAULT_BASE_URL, FeedTab, FileTransferMode, IMAGE_MIME_TYPES, IncidentKind, InteractionType, ItdAbortError, ItdAccounts, ItdApiError, ItdApiErrorKind, ItdAuthError, ItdClient, ItdConfigError, ItdConflictError, ItdError, ItdErrorCode, ItdErrorKind, ItdFileError, ItdFileErrorReason, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdPhoneVerificationError, ItdRateLimitError, ItdRealtime, ItdServerError, ItdStateError, ItdTimeoutError, ItdValidationError, LIBRARY_VERSION, LikesVisibility, MemoryKeyValueStore, MemoryMultiTokenStorage, MemoryTokenStorage, NotificationType, OPERATIONS, PaginationMode, Paginator, RealtimeComposer, RealtimeRouter, RealtimeStatus, RealtimeTransportKind, RealtimeUpdateOrigin, RealtimeUpdateType, ReportReason, ReportTargetType, RetrySafety, RuntimeMode, STATUS_SERVICE, ServiceState, SignInStatus, SpanRenderFormat, SpanType, TURNSTILE_SITE_KEY, UnauthorizedStreamError, VIDEO_MIME_TYPES, ViewReason, ViewSource, WallAccess, WebSocketTransport, 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, renderSpans, report, resolveNotificationUrl, runRealtimeMiddleware, scopedTokenStorage, statusDays, systemClock, toDate, utcStampToIso, withCodec, withNamespace };
 
 //# sourceMappingURL=index.js.map