itd-api 0.5.0 → 0.6.0

package/dist/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_multi_storage = require("./multi-storage-mBuCOVZY.cjs");
-const require_storage = require("./storage-dF8Tio5y.cjs");
+const require_multi_storage = require("./multi-storage-Bf84xiO8.cjs");
+const require_storage = require("./storage-DnzZPS_9.cjs");
 //#region src/core/emitter.ts
 /**
 * Минимальный типизированный источник событий.
@@ -435,6 +435,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
@@ -668,6 +676,11 @@ const AUTH_PATHS = {
 * Нужен, чтобы отрисовать виджет капчи и получить токен для `signIn`, `signUp`
 * и `forgotPassword`.
 *
+* Ключ привязан к домену: на чужом origin Cloudflare отказывает виджету с кодом `110200`.
+* Поэтому отрисовать его может только код, выполняемый на самом итд.com. Остальным
+* подходит `@itd-api/turnstile`, готовый токен из другого источника или вовсе вход
+* без капчи — по сохранённой сессии либо по токенам, взятым в браузере.
+*
 * @example
 * ```ts
 * turnstile.render('#captcha', {
@@ -677,8 +690,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;
@@ -1183,10 +1194,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`. */
@@ -1201,8 +1235,6 @@ const BUILT_IN_SERVICES = Object.freeze([Object.freeze({
 	baseUrl: DEFAULT_STATUS_BASE_URL,
 	auth: false
 })]);
-/** Таймаут запроса по умолчанию — 30 секунд. */
-const DEFAULT_TIMEOUT = 3e4;
 /**
 * `User-Agent` по умолчанию.
 *
@@ -1412,6 +1444,7 @@ function resolveConfig(options = {}) {
 	const mode = options.mode ?? RuntimeMode.Auto;
 	if (!Object.values(RuntimeMode).includes(mode)) throw new require_storage.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 require_storage.ItdConfigError("clock должен предоставлять методы now() и schedule()");
 	requireOptionalBoolean(options.autoRefresh, "autoRefresh");
 	requireOptionalBoolean(options.reloginOnRefreshFailure, "reloginOnRefreshFailure");
@@ -1427,6 +1460,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),
@@ -1995,7 +2029,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;
@@ -2069,9 +2107,11 @@ var PluginRegistry = class {
 	* Отключает плагин и вызывает его функцию очистки.
 	*
 	* Новые запросы перестают видеть расширения плагина сразу. Снимок уже начавшейся операции,
-	* включая её будущие retry, остаётся неизменным; очистка дождётся завершения операции.
+	* включая её будущие retry, остаётся неизменным; очистка дождётся завершения операции,
+	* но не дольше отведённого срока.
 	*
 	* @returns `false`, если такого плагина не было
+	* @throws {ItdStateError} если операции плагина не завершились за отведённый срок
 	*/
 	async remove(name) {
 		const entry = this.#entries.get(name);
@@ -2080,21 +2120,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();
@@ -2102,13 +2145,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 {
@@ -2116,6 +2160,11 @@ var PluginRegistry = class {
 			}
 			if (errors.length > 0) throw new AggregateError(errors, "Не удалось освободить ресурсы плагинов");
 		})());
+		try {
+			await cleanup;
+		} finally {
+			deadline.cancel();
+		}
 	}
 	/**
 	* Прогоняет запрос через operation transformers и прикрепляет attempt interceptors.
@@ -2123,6 +2172,9 @@ var PluginRegistry = class {
 	* Снимки обеих цепочек берутся в начале: `unuse()` влияет на новые операции, но не меняет
 	* уже выполняющуюся и не удаляет interceptors из её последующих retry.
 	*
+	* Каждый `next` одноразовый: transformer может завершить операцию сам, но не может породить
+	* вторую — для `posts.create` это была бы вторая публикация.
+	*
 	* @param execute выполнение логической операции, вызываемое самым внутренним transformer
 	*/
 	async run(request, execute) {
@@ -2133,7 +2185,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 require_storage.ItdConfigError(`operation transformer плагина «${plugin}» вызвал next() больше одного раза`);
+				called = true;
+				return next(scoped(prepared));
+			});
+		}, (current) => execute(scoped(current)));
 		try {
 			return await chain(scoped(request));
 		} finally {
@@ -2147,6 +2209,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 require_storage.ItdStateError(`плагин «${entry.plugin.name}» не завершил операции за ${this.#options.shutdownTimeout} мс; ожидание прекращено, ресурсы плагина освобождены`);
+	}
 	#waitForDrain(entry) {
 		if (entry.activeRequests === 0) return Promise.resolve();
 		entry.drain ??= new Promise((resolve) => {
@@ -2319,6 +2393,7 @@ var RequestQueuePool = class {
 	stop() {
 		this.#main.stop();
 		for (const queue of this.#byDestination.values()) queue.stop();
+		this.#byDestination.clear();
 	}
 };
 //#endregion
@@ -2843,17 +2918,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();
@@ -2863,7 +2946,7 @@ function createAbortBundle(userSignal, timeout, clock) {
 		timedOut: () => timedOut,
 		cleanup: () => {
 			cancelTimer?.();
-			userSignal?.removeEventListener("abort", onUserAbort);
+			for (const detach of unlink) detach?.();
 		}
 	};
 }
@@ -2900,7 +2983,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 {
@@ -3117,7 +3200,7 @@ var Transport = class {
 			path: request.path
 		});
 		if (aborted) {
-			const reason = request.signal?.reason;
+			const reason = abort.signal.reason;
 			return new require_storage.ItdAbortError(`Запрос ${method} ${request.path} отменён`, reason !== void 0 ? { cause: reason } : void 0);
 		}
 		if (error instanceof require_storage.ItdError) return error;
@@ -3158,8 +3241,12 @@ function createServiceRegistry(config) {
 function createClientRuntime(options = {}, internals = {}) {
 	const config = resolveConfig(options);
 	const jar = new require_multi_storage.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;
@@ -3189,7 +3276,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 = [
 		{
@@ -3266,9 +3354,10 @@ function createClientRuntime(options = {}, internals = {}) {
 		close: () => {
 			if (ownsQueues) queues?.stop();
 		},
-		dispose: () => {
+		dispose: async () => {
+			lifetime.abort(new require_storage.ItdAbortError("Клиент освобождён через dispose(), запрос отменён"));
 			auth.dispose();
-			return plugins.dispose();
+			await plugins.dispose();
 		}
 	};
 }
@@ -3626,7 +3715,12 @@ var RealtimeDispatcher = class {
 			if (index >= 0) this.#handlers.splice(index, 1);
 		};
 	}
-	dispatch(context) {
+	/**
+	* Принимает обновление к обработке.
+	*
+	* @param coalesceKey ожидающая работа с тем же ключом заменяется новой
+	*/
+	dispatch(context, coalesceKey) {
 		let keys;
 		let middleware;
 		try {
@@ -3636,12 +3730,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();
 	}
 	/** Отбрасывает обновления, обработка которых ещё не началась. */
@@ -3718,14 +3820,6 @@ const RECONNECT_BACKOFF = Object.freeze([
 	16e3,
 	3e4
 ]);
-/** Доля случайного разброса паузы. */
-const RECONNECT_JITTER = .3;
-/**
-* Сколько раз пытаться переподключиться подряд.
-*
-* После исчерпания поток сообщает `giveup` и ждёт ручного `connect()`.
-*/
-const MAX_RECONNECT_ATTEMPTS = 15;
 /**
 * Вычисляет паузу перед попыткой переподключения.
 *
@@ -4026,7 +4120,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()
 		});
 	}
 	/** Текущее состояние соединения. */
@@ -4107,7 +4202,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) {
@@ -4132,6 +4243,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,
@@ -4230,7 +4342,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;
@@ -4238,6 +4355,7 @@ var RealtimeEngine = class {
 		this.#attempt = 0;
 		this.#detachEnvironment?.();
 		this.#detachEnvironment = void 0;
+		this.#deps.onClose?.();
 		this.#emitEngine("error", {
 			error,
 			willReconnect: false
@@ -4310,26 +4428,15 @@ var PollTransport = class {
 		this.#limit = options.limit ?? 20;
 	}
 	async connect(context) {
+		const request = context.request;
+		if (!request) throw new require_storage.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 = `${require_multi_storage.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;
@@ -4343,7 +4450,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({
@@ -4355,16 +4462,29 @@ var PollTransport = class {
 			await this.#wait(context.signal);
 		}
 	}
-	async #readCount(context, headers) {
+	async #readUpdates(request, signal) {
 		try {
-			const response = await context.fetch(require_multi_storage.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 (require_storage.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;
 		}
@@ -4724,6 +4844,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,
@@ -4734,6 +4855,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,
@@ -6010,10 +6132,6 @@ function createMultipartFileBody(file) {
 		cancel
 	};
 }
-//#endregion
-//#region src/resources/files.ts
-/** Таймаут одной попытки загрузки файла — 5 минут. */
-const DEFAULT_UPLOAD_TIMEOUT = 3e5;
 /** Файлы и медиа. */
 var FilesResource = class extends BaseResource {
 	#fetch;
@@ -9095,6 +9213,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(),
@@ -9114,13 +9237,16 @@ var ItdClient = class ItdClient {
 	* Освобождает ресурсы клиента: закрывает все потоки уведомлений, отправляет открытые
 	* накопители {@link telemetry}, затем останавливает очередь запросов.
 	*
-	* Метод дожидается активных обработчиков потока. После вызова клиентом можно пользоваться
-	* снова; ранее созданный поток можно запустить повторным `connect()`.
+	* Метод дожидается активных обработчиков потока, но не дольше `shutdownTimeout`. После
+	* вызова клиентом можно пользоваться снова; ранее созданный поток можно запустить
+	* повторным `connect()`.
 	*
 	* Общая очередь, полученная от {@link ItdAccounts}, не останавливается: её гасит сам
 	* контейнер, когда закрывает все аккаунты разом.
 	*
 	* Терминальное освобождение — это {@link dispose}.
+	*
+	* @throws {ItdStateError} если обработчики потока не завершились за отведённый срок
 	*/
 	async close() {
 		return this.#close(false);
@@ -9128,22 +9254,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 require_storage.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 });
@@ -10122,10 +10256,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;
@@ -10263,6 +10393,7 @@ var WebSocketTransport = class {
 			let discardMessages = false;
 			let socketError;
 			let messageQueue = Promise.resolve();
+			let pendingFrames = 0;
 			let cancelHandshake;
 			let cancelIdle;
 			let cancelKeepAlive;
@@ -10341,7 +10472,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) {
@@ -10636,21 +10773,10 @@ function renderSpans(content, spans = [], options = {}) {
 //#endregion
 exports.ALLOWED_MIME_TYPES = ALLOWED_MIME_TYPES;
 exports.AUDIO_MIME_TYPES = AUDIO_MIME_TYPES;
-exports.AUTH_FLAG_COOKIE = require_multi_storage.AUTH_FLAG_COOKIE;
-exports.AUTH_PATHS = AUTH_PATHS;
 exports.AccessType = AccessType;
 exports.AttachmentType = AttachmentType;
-exports.BUILT_IN_SERVICES = BUILT_IN_SERVICES;
 exports.CommentSort = CommentSort;
 exports.DEFAULT_BASE_URL = DEFAULT_BASE_URL;
-exports.DEFAULT_FILE_STREAM_BUFFER_BYTES = require_multi_storage.DEFAULT_FILE_STREAM_BUFFER_BYTES;
-exports.DEFAULT_STATUS_BASE_URL = DEFAULT_STATUS_BASE_URL;
-exports.DEFAULT_TIMEOUT = DEFAULT_TIMEOUT;
-exports.DEFAULT_UPLOAD_TIMEOUT = DEFAULT_UPLOAD_TIMEOUT;
-exports.DEFAULT_URL_FILE_MAX_BYTES = require_multi_storage.DEFAULT_URL_FILE_MAX_BYTES;
-exports.DEFAULT_USER_AGENT = DEFAULT_USER_AGENT;
-exports.DEVICE_ID_HEADER = DEVICE_ID_HEADER;
-exports.DetectedRuntime = DetectedRuntime;
 exports.FeedTab = FeedTab;
 exports.FileTransferMode = require_multi_storage.FileTransferMode;
 exports.IMAGE_MIME_TYPES = IMAGE_MIME_TYPES;
@@ -10681,19 +10807,13 @@ exports.ItdTimeoutError = require_storage.ItdTimeoutError;
 exports.ItdValidationError = require_storage.ItdValidationError;
 exports.LIBRARY_VERSION = LIBRARY_VERSION;
 exports.LikesVisibility = LikesVisibility;
-exports.MAX_RECONNECT_ATTEMPTS = MAX_RECONNECT_ATTEMPTS;
 exports.MemoryKeyValueStore = require_storage.MemoryKeyValueStore;
 exports.MemoryMultiTokenStorage = require_multi_storage.MemoryMultiTokenStorage;
 exports.MemoryTokenStorage = require_storage.MemoryTokenStorage;
-exports.NOTIFICATION_TYPE_ALIASES = NOTIFICATION_TYPE_ALIASES;
 exports.NotificationType = NotificationType;
 exports.OPERATIONS = OPERATIONS;
 exports.PaginationMode = PaginationMode;
 exports.Paginator = Paginator;
-exports.RECONNECT_BACKOFF = RECONNECT_BACKOFF;
-exports.RECONNECT_JITTER = RECONNECT_JITTER;
-exports.REFRESH_COOKIE = require_multi_storage.REFRESH_COOKIE;
-exports.REFRESH_COOKIE_PATH = require_multi_storage.REFRESH_COOKIE_PATH;
 exports.RealtimeComposer = RealtimeComposer;
 exports.RealtimeRouter = RealtimeRouter;
 exports.RealtimeStatus = RealtimeStatus;
@@ -10705,8 +10825,6 @@ exports.ReportTargetType = ReportTargetType;
 exports.RetrySafety = RetrySafety;
 exports.RuntimeMode = RuntimeMode;
 exports.STATUS_SERVICE = STATUS_SERVICE;
-exports.STREAM_PATH = STREAM_PATH;
-exports.ServiceRegistry = ServiceRegistry;
 exports.ServiceState = ServiceState;
 exports.SignInStatus = SignInStatus;
 exports.SpanRenderFormat = SpanRenderFormat;
@@ -10716,7 +10834,6 @@ exports.UnauthorizedStreamError = UnauthorizedStreamError;
 exports.VIDEO_MIME_TYPES = VIDEO_MIME_TYPES;
 exports.ViewReason = ViewReason;
 exports.ViewSource = ViewSource;
-exports.WEBSOCKET_PATH = WEBSOCKET_PATH;
 exports.WallAccess = WallAccess;
 exports.WebSocketTransport = WebSocketTransport;
 exports.autoSpans = autoSpans;
@@ -10757,8 +10874,6 @@ exports.parseHtml = parseHtml;
 exports.parseMarkdown = parseMarkdown;
 exports.poll = poll;
 exports.post = post;
-exports.readNotificationEvent = readNotificationEvent;
-exports.readUnreadCountEvent = readUnreadCountEvent;
 exports.renderSpans = renderSpans;
 exports.report = report;
 exports.resolveNotificationUrl = resolveNotificationUrl;