itd-api 0.10.3 → 0.11.0

package/dist/index.cjs

@@ -1,13 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_url = require("./shared/url-BnO1aWsd.cjs");
-const require_errors = require("./shared/errors-BmP3TKoW.cjs");
-const require_redact = require("./shared/redact-lAmck1Z6.cjs");
-const require_render = require("./shared/render-CYJSDypQ.cjs");
-const require_options = require("./shared/options-DjEtbVaf.cjs");
-const require_events = require("./shared/events-BVfqWyBw.cjs");
-const require_key_value_store = require("./shared/key-value-store-B5GYVEYZ.cjs");
-const require_storage = require("./shared/storage-CZJZoaz9.cjs");
-const require_multi_storage = require("./shared/multi-storage-s-fPtjoy.cjs");
+const require_url = require("./shared/url-DTgkCWv5.cjs");
+const require_validate = require("./shared/validate-CFx2dISs.cjs");
+const require_redact = require("./shared/redact-DoC7lSsp.cjs");
+const require_render = require("./shared/render-Dnc84B4M.cjs");
+const require_options = require("./shared/options-5tywTYId.cjs");
+const require_events = require("./shared/events-C6tmj8aW.cjs");
+const require_key_value_store = require("./shared/key-value-store-DYSPsqwq.cjs");
+const require_storage = require("./shared/storage-CIjejZDt.cjs");
+const require_multi_storage = require("./shared/multi-storage-C7-Gz6Z7.cjs");
 //#region src/notifications-api.ts
 var ClientNotifications = class extends require_render.NotificationsResource {
 	#createEvents;
@@ -58,7 +58,7 @@ const QrLoginStreamStatus = Object.freeze({
 });
 function requireString(body, key, message) {
 	const value = require_url.pickString(body, key);
-	if (!value) throw new require_errors.ItdConfigError(message);
+	if (!value) throw new require_validate.ItdConfigError(message);
 	return value;
 }
 const AUTH_CHECK = require_url.passthroughOperation("auth.check");
@@ -93,7 +93,7 @@ const AUTH_QR_REJECT = require_url.voidOperation("auth.qrReject");
 //#endregion
 //#region src/session/captcha.ts
 function requireCaptchaText(value, field) {
-	if (value !== void 0 && (typeof value !== "string" || value.trim() === "")) throw new require_errors.ItdConfigError(`${field} должен быть непустой строкой`);
+	if (value !== void 0 && (typeof value !== "string" || value.trim() === "")) throw new require_validate.ItdConfigError(`${field} должен быть непустой строкой`);
 }
 /**
 * Проверяет форму источника токена и приводит его к объекту.
@@ -106,9 +106,9 @@ function requireCaptchaText(value, field) {
 function resolveCaptchaSolver(captcha) {
 	if (captcha === void 0) return void 0;
 	if (typeof captcha === "function") return { getToken: captcha };
-	if (!require_url.isRecord$1(captcha)) throw new require_errors.ItdConfigError("captcha должен быть функцией либо объектом с getToken");
+	if (!require_validate.isRecord(captcha)) throw new require_validate.ItdConfigError("captcha должен быть функцией либо объектом с getToken");
 	const { getToken, type, field } = captcha;
-	if (typeof getToken !== "function") throw new require_errors.ItdConfigError("captcha.getToken должен быть функцией");
+	if (typeof getToken !== "function") throw new require_validate.ItdConfigError("captcha.getToken должен быть функцией");
 	requireCaptchaText(type, "captcha.type");
 	requireCaptchaText(field, "captcha.field");
 	return captcha;
@@ -121,18 +121,18 @@ function resolveCaptchaSolver(captcha) {
 */
 function validateCaptchaToken(captcha, path) {
 	if (captcha === void 0) return;
-	if (!require_url.isRecord$1(captcha)) throw new require_errors.ItdConfigError(`${path} должен быть объектом { type, token }`);
+	if (!require_validate.isRecord(captcha)) throw new require_validate.ItdConfigError(`${path} должен быть объектом { type, token }`);
 	const { type, token, field } = captcha;
-	if (typeof token !== "string" || token.trim() === "") throw new require_errors.ItdConfigError(`${path}.token должен быть непустой строкой`);
-	if (typeof type !== "string" || type.trim() === "") throw new require_errors.ItdConfigError(`${path}.type должен быть непустой строкой`);
+	if (typeof token !== "string" || token.trim() === "") throw new require_validate.ItdConfigError(`${path}.token должен быть непустой строкой`);
+	if (typeof type !== "string" || type.trim() === "") throw new require_validate.ItdConfigError(`${path}.type должен быть непустой строкой`);
 	requireCaptchaText(field, `${path}.field`);
 }
 /** Разбирает ответ `GET /api/v1/auth/captcha/provider` для автоматического входа. */
 function readCaptchaProvider(body) {
-	const config = require_url.isRecord$1(body) ? body : void 0;
+	const config = require_validate.isRecord(body) ? body : void 0;
 	const provider = config?.provider;
 	const field = config?.field;
-	if (typeof provider !== "string" || provider.trim() === "" || typeof field !== "string" || field.trim() === "") throw new require_errors.ItdConfigError("Сервер вернул неподдерживаемую конфигурацию капчи");
+	if (typeof provider !== "string" || provider.trim() === "" || typeof field !== "string" || field.trim() === "") throw new require_validate.ItdConfigError("Сервер вернул неподдерживаемую конфигурацию капчи");
 	return {
 		provider,
 		field
@@ -142,13 +142,13 @@ function readCaptchaProvider(body) {
 function resolveField(type, configured) {
 	const field = configured ?? CAPTCHA_FIELDS[type];
 	if (field) return field;
-	throw new require_errors.ItdConfigError(`Неизвестно, в каком поле сервер ждёт токен капчи «${type}». Передайте captcha.field либо оставьте captcha.type = ${require_url.CaptchaChoice.Auto}, чтобы поле назвал сервер.`);
+	throw new require_validate.ItdConfigError(`Неизвестно, в каком поле сервер ждёт токен капчи «${type}». Передайте captcha.field либо оставьте captcha.type = ${require_url.CaptchaChoice.Auto}, чтобы поле назвал сервер.`);
 }
 /** Спрашивает токен у источника и убеждается, что он непустой. */
-async function requireSolvedToken(solver, type) {
-	const token = await solver.getToken(type);
+async function requireSolvedToken(solver, type, context) {
+	const token = await solver.getToken(type, context);
 	if (typeof token === "string" && token.trim() !== "") return token;
-	throw new require_errors.ItdConfigError(`Источник капчи не вернул токен для провайдера «${type}». Проверьте captcha.getToken.`);
+	throw new require_validate.ItdConfigError(`Источник капчи не вернул токен для провайдера «${type}». Проверьте captcha.getToken.`);
 }
 /**
 * Готовит фрагмент тела запроса, взяв токен у источника.
@@ -157,15 +157,16 @@ async function requireSolvedToken(solver, type) {
 * и имя поля приходят оттуда. Явно названный тип обходится без этого запроса.
 *
 * @param askProvider как спросить активного провайдера; вызывается, только если это нужно
+* @param context что источник получает вместе с типом капчи
 * @throws {ItdConfigError} если токен получить не удалось
 */
-async function solveCaptchaBody(solver, askProvider) {
+async function solveCaptchaBody(solver, askProvider, context) {
 	const choice = solver.type ?? require_url.CaptchaChoice.Auto;
 	if (choice === require_url.CaptchaChoice.Auto) {
 		const { provider, field } = await askProvider();
-		return { [field]: await requireSolvedToken(solver, provider) };
+		return { [field]: await requireSolvedToken(solver, provider, context) };
 	}
-	return { [resolveField(choice, solver.field)]: await requireSolvedToken(solver, choice) };
+	return { [resolveField(choice, solver.field)]: await requireSolvedToken(solver, choice, context) };
 }
 /**
 * Готовит фрагмент тела из готового токена.
@@ -231,41 +232,41 @@ const ACCESS_TOKEN_REFRESH_LEEWAY_MS = 3e4;
 function validateAuth(auth) {
 	if (auth === void 0) return void 0;
 	if (typeof auth === "string") {
-		if (auth.trim() === "") throw new require_errors.ItdConfigError("auth: передана пустая строка вместо accessToken");
+		if (auth.trim() === "") throw new require_validate.ItdConfigError("auth: передана пустая строка вместо accessToken");
 		return auth;
 	}
-	if (typeof auth !== "object" || auth === null) throw new require_errors.ItdConfigError(`auth должен быть строкой с токеном или объектом, получено: ${typeof auth}`);
+	if (typeof auth !== "object" || auth === null) throw new require_validate.ItdConfigError(`auth должен быть строкой с токеном или объектом, получено: ${typeof auth}`);
 	if ([
 		"getToken" in auth,
 		"accessToken" in auth || "refreshToken" in auth,
 		"email" in auth || "password" in auth
-	].filter(Boolean).length > 1) throw new require_errors.ItdConfigError("auth должен описывать ровно один способ авторизации: getToken, accessToken или email/password");
+	].filter(Boolean).length > 1) throw new require_validate.ItdConfigError("auth должен описывать ровно один способ авторизации: getToken, accessToken или email/password");
 	if ("getToken" in auth) {
-		if (typeof auth.getToken !== "function") throw new require_errors.ItdConfigError("auth.getToken должен быть функцией");
+		if (typeof auth.getToken !== "function") throw new require_validate.ItdConfigError("auth.getToken должен быть функцией");
 		return { ...auth };
 	}
 	if ("accessToken" in auth) {
-		if (typeof auth.accessToken !== "string" || auth.accessToken.trim() === "") throw new require_errors.ItdConfigError("auth.accessToken должен быть непустой строкой");
-		if (auth.refreshToken !== void 0 && (typeof auth.refreshToken !== "string" || auth.refreshToken.trim() === "")) throw new require_errors.ItdConfigError("auth.refreshToken должен быть непустой строкой");
+		if (typeof auth.accessToken !== "string" || auth.accessToken.trim() === "") throw new require_validate.ItdConfigError("auth.accessToken должен быть непустой строкой");
+		if (auth.refreshToken !== void 0 && (typeof auth.refreshToken !== "string" || auth.refreshToken.trim() === "")) throw new require_validate.ItdConfigError("auth.refreshToken должен быть непустой строкой");
 		return { ...auth };
 	}
 	if ("email" in auth || "password" in auth) {
 		const { email, password, captcha } = auth;
-		if (typeof email !== "string" || email.trim() === "") throw new require_errors.ItdConfigError("auth.email должен быть непустой строкой");
-		if (typeof password !== "string" || password === "") throw new require_errors.ItdConfigError("auth.password должен быть непустой строкой");
+		if (typeof email !== "string" || email.trim() === "") throw new require_validate.ItdConfigError("auth.email должен быть непустой строкой");
+		if (typeof password !== "string" || password === "") throw new require_validate.ItdConfigError("auth.password должен быть непустой строкой");
 		validateCaptchaToken(captcha, "auth.captcha");
 		return { ...auth };
 	}
-	throw new require_errors.ItdConfigError("auth не распознан. Ожидается строка с accessToken либо объект { accessToken }, { email, password } или { getToken }");
+	throw new require_validate.ItdConfigError("auth не распознан. Ожидается строка с accessToken либо объект { accessToken }, { email, password } или { getToken }");
 }
 function resolveStorage(storage) {
 	if (storage === void 0) return new require_storage.MemoryTokenStorage();
-	if (!require_url.isRecord$1(storage)) throw new require_errors.ItdConfigError("storage должен быть объектом TokenStorage");
+	if (!require_validate.isObjectLike(storage)) throw new require_validate.ItdConfigError("storage должен быть объектом TokenStorage");
 	for (const method of [
 		"get",
 		"set",
 		"clear"
-	]) if (typeof storage[method] !== "function") throw new require_errors.ItdConfigError(`storage.${method} должен быть функцией`);
+	]) if (typeof storage[method] !== "function") throw new require_validate.ItdConfigError(`storage.${method} должен быть функцией`);
 	return storage;
 }
 /**
@@ -275,10 +276,10 @@ function resolveStorage(storage) {
 * @throws {ItdConfigError} при некорректных значениях
 */
 function resolveSessionConfig(options, runtime) {
-	if (!require_url.isRecord$1(options)) throw new require_errors.ItdConfigError("опции клиента должны быть объектом");
-	require_url.requireOptionalBoolean(options.autoRefresh, "autoRefresh");
-	require_url.requireOptionalBoolean(options.reloginOnRefreshFailure, "reloginOnRefreshFailure");
-	if (options.deviceId !== void 0 && (typeof options.deviceId !== "string" || options.deviceId.trim() === "")) throw new require_errors.ItdConfigError("deviceId должен быть непустой строкой");
+	if (!require_validate.isObjectLike(options)) throw new require_validate.ItdConfigError("опции клиента должны быть объектом");
+	require_validate.requireOptionalBoolean(options.autoRefresh, "autoRefresh");
+	require_validate.requireOptionalBoolean(options.reloginOnRefreshFailure, "reloginOnRefreshFailure");
+	if (options.deviceId !== void 0 && (typeof options.deviceId !== "string" || options.deviceId.trim() === "")) throw new require_validate.ItdConfigError("deviceId должен быть непустой строкой");
 	return {
 		...runtime,
 		auth: validateAuth(options.auth),
@@ -349,12 +350,12 @@ function withoutLegacyUserId(session) {
 }
 function normalizeSessionValue(value, source, mode = "strict", logger) {
 	const tolerant = mode === "stored";
-	if (!require_url.isRecord$1(value)) {
+	if (!require_validate.isRecord(value)) {
 		if (tolerant) {
 			logger?.warn(`${source} вернула не объект сессии; сохранённая запись пропущена`);
 			return null;
 		}
-		throw new require_errors.ItdConfigError(`${source} должна быть объектом сессии`);
+		throw new require_validate.ItdConfigError(`${source} должна быть объектом сессии`);
 	}
 	const record = value;
 	const normalized = { ...record };
@@ -371,7 +372,7 @@ function normalizeSessionValue(value, source, mode = "strict", logger) {
 				delete normalized[field];
 				return;
 			}
-			throw new require_errors.ItdConfigError(`${source}.${field} должна быть непустой строкой`);
+			throw new require_validate.ItdConfigError(`${source}.${field} должна быть непустой строкой`);
 		}
 		normalized[field] = item;
 	};
@@ -380,7 +381,7 @@ function normalizeSessionValue(value, source, mode = "strict", logger) {
 	normalizeString("deviceId");
 	if (record.obtainedAt === void 0) delete normalized.obtainedAt;
 	else if (typeof record.obtainedAt !== "number" || !Number.isFinite(record.obtainedAt)) {
-		if (!tolerant) throw new require_errors.ItdConfigError(`${source}.obtainedAt должна быть конечным числом`);
+		if (!tolerant) throw new require_validate.ItdConfigError(`${source}.obtainedAt должна быть конечным числом`);
 		else {
 			logger?.warn(`${source}.obtainedAt повреждена; поле сохранённой сессии пропущено`);
 			delete normalized.obtainedAt;
@@ -391,7 +392,7 @@ function normalizeSessionValue(value, source, mode = "strict", logger) {
 		if (tolerant) {
 			logger?.warn(`${source}.cookies повреждена; поле сохранённой сессии пропущено`);
 			delete normalized.cookies;
-		} else throw new require_errors.ItdConfigError(`${source}.cookies должна быть массивом`);
+		} else throw new require_validate.ItdConfigError(`${source}.cookies должна быть массивом`);
 	} else {
 		const valid = record.cookies.filter((cookie) => typeof cookie === "string" && require_redact.isSerializedCookieEntry(cookie));
 		if (valid.length > 0) normalized.cookies = valid;
@@ -401,7 +402,7 @@ function normalizeSessionValue(value, source, mode = "strict", logger) {
 }
 function normalizeSession(value, source) {
 	const normalized = normalizeSessionValue(value, source);
-	if (!normalized) throw new require_errors.ItdConfigError(`${source} должна быть объектом сессии`);
+	if (!normalized) throw new require_validate.ItdConfigError(`${source} должна быть объектом сессии`);
 	return normalized;
 }
 let authScopeSequence = 0;
@@ -544,7 +545,7 @@ var AuthManager = class {
 		return true;
 	}
 	#assertActive() {
-		if (this.#disposed) throw new require_errors.ItdStateError("Менеджер авторизации уже освобождён");
+		if (this.#disposed) throw new require_validate.ItdStateError("Менеджер авторизации уже освобождён");
 	}
 	#currentAccessToken() {
 		return this.#session?.accessToken ?? null;
@@ -732,7 +733,7 @@ var AuthManager = class {
 	* `SESSION_NOT_FOUND`, `SESSION_REVOKED` — разные поводы и разные действия).
 	*/
 	#noRefreshSessionError() {
-		return new require_errors.ItdAuthError({
+		return new require_validate.ItdAuthError({
 			status: 401,
 			code: "SESSION_EXPIRED",
 			message: "Не удалось обновить сессию: нет ни cookie is_auth, ни refresh-токена. Войдите заново либо передайте refreshToken в auth.",
@@ -764,7 +765,7 @@ var AuthManager = class {
 	}
 	async #storeAccessToken(accessToken, expectedRevision, cookies, replaceSession) {
 		this.#assertActive();
-		if (typeof accessToken !== "string" || accessToken.trim() === "") throw new require_errors.ItdConfigError("accessToken должен быть непустой строкой");
+		if (typeof accessToken !== "string" || accessToken.trim() === "") throw new require_validate.ItdConfigError("accessToken должен быть непустой строкой");
 		await this.#loadSession();
 		this.#assertActive();
 		if (this.#authEpoch !== expectedRevision) return false;
@@ -777,6 +778,7 @@ var AuthManager = class {
 			obtainedAt: this.#config.clock.now()
 		});
 		this.#emitter.emit("tokens", { accessToken });
+		this.#config.logger?.info(`${replaceSession ? "вход выполнен" : "принят токен доступа"}${this.#describeUser(accessToken)}`);
 		await saved;
 		return true;
 	}
@@ -828,6 +830,7 @@ var AuthManager = class {
 		const retained = this.#deviceId ? { deviceId: this.#deviceId } : null;
 		this.#session = retained;
 		this.#emitter.emit("signOut", void 0);
+		this.#config.logger?.info("сессия очищена");
 		await this.#enqueuePersistence(async () => {
 			await this.#config.storage.clear();
 			if (retained) await this.#config.storage.set(require_storage.copySession(retained));
@@ -845,6 +848,7 @@ var AuthManager = class {
 		this.#assertActive();
 		const stored = loaded === null ? null : normalizeSessionValue(loaded, "storage.get()", "stored", this.#config.logger);
 		if (stored?.cookies) this.#jar.deserialize(stored.cookies);
+		if (stored?.accessToken) this.#config.logger?.info(`сессия восстановлена из хранилища${this.#describeUser(stored.accessToken)}`);
 		const fromConfig = this.#sessionFromConfig(this.#config.auth);
 		this.#session = stored && fromConfig ? {
 			...stored,
@@ -941,12 +945,14 @@ var AuthManager = class {
 				obtainedAt: this.#config.clock.now()
 			});
 			this.#emitter.emit("tokens", { accessToken });
+			this.#config.logger?.info("токен доступа обновлён");
 			await saved;
 			if (this.#authEpoch !== expectation.epoch) return this.#currentAccessToken();
 			return accessToken;
 		} catch (error) {
 			if (this.#authEpoch !== expectation.epoch) return this.#currentAccessToken();
-			if (error instanceof require_errors.ItdAuthError) {
+			if (error instanceof require_validate.ItdAuthError) {
+				this.#config.logger?.warn(`обновить сессию не удалось (${error.message}); сохранённая сессия удалена`);
 				this.#invalidateInFlight();
 				const clearedRevision = this.#authEpoch;
 				this.#transitionAuth(void 0);
@@ -1002,7 +1008,7 @@ var AuthManager = class {
 		const configured = this.#takeConfiguredCaptcha();
 		if (configured) return captchaBody(configured);
 		const solver = this.#config.captcha;
-		if (solver) return solveCaptchaBody(solver, () => this.#resolveCaptchaProvider());
+		if (solver) return solveCaptchaBody(solver, () => this.#resolveCaptchaProvider(), { logger: this.#config.logger });
 		this.#config.logger?.debug("Запрос уходит без токена капчи: не передан аргумент captcha и не задана опция captcha");
 		return {};
 	}
@@ -1010,7 +1016,7 @@ var AuthManager = class {
 	#takeConfiguredCaptcha() {
 		if (this.#configCaptchaSpent) return void 0;
 		const auth = this.#config.auth;
-		const captcha = require_url.isRecord$1(auth) ? auth.captcha : void 0;
+		const captcha = typeof auth === "object" && auth !== null && "email" in auth ? auth.captcha : void 0;
 		if (!captcha) return void 0;
 		this.#configCaptchaSpent = true;
 		return captcha;
@@ -1024,7 +1030,7 @@ var AuthManager = class {
 				skipAuthRefresh: true
 			}));
 		} catch (error) {
-			if (require_errors.isItdApiError(error) && error.status === 404 && error.code === require_url.ItdErrorCode.NOT_FOUND) {
+			if (require_validate.isItdApiError(error) && error.status === 404 && error.code === require_url.ItdErrorCode.NOT_FOUND) {
 				this.#config.logger?.warn("Сервер отключил определение провайдера капчи; используется Cloudflare Turnstile");
 				return {
 					provider: require_url.CaptchaType.Cloudflare,
@@ -1048,7 +1054,7 @@ var AuthManager = class {
 			skipAuthRefresh: true,
 			cookieJar: flowCookies
 		});
-		if (result.status !== SignInStatus.Authenticated) throw new require_errors.ItdConfigError("Вход по email и паролю требует подтверждения кодом из письма. Автоматический вход невозможен: воспользуйтесь itd.auth.signInWithOtp() и передайте полученный accessToken в конфигурацию клиента.");
+		if (result.status !== SignInStatus.Authenticated) throw new require_validate.ItdConfigError("Вход по email и паролю требует подтверждения кодом из письма. Автоматический вход невозможен: воспользуйтесь itd.auth.signInWithOtp() и передайте полученный accessToken в конфигурацию клиента.");
 		const accessToken = result.accessToken;
 		this.#assertActive();
 		if (this.#authEpoch !== revision) return this.#session?.accessToken ?? null;
@@ -1061,9 +1067,15 @@ var AuthManager = class {
 		});
 		this.#emitter.emit("tokens", { accessToken });
 		this.#emitter.emit("signIn", { accessToken });
+		this.#config.logger?.info(`вход по email и паролю выполнен${this.#describeUser(accessToken)}`);
 		await saved;
 		return accessToken;
 	}
+	/** Хвост сообщения журнала с идентификатором пользователя, если токен его содержит. */
+	#describeUser(accessToken) {
+		const userId = this.#identityForToken(accessToken).userId;
+		return userId ? `: пользователь ${userId}` : "";
+	}
 };
 //#endregion
 //#region src/session/qr-stream.ts
@@ -1075,7 +1087,7 @@ function readQrLoginStreamEvent(data) {
 	} catch {
 		return;
 	}
-	if (!require_url.isRecord$1(value)) return void 0;
+	if (!require_validate.isRecord(value)) return void 0;
 	const event = value;
 	if (typeof event.status !== "string" || !QR_STREAM_STATUSES.has(event.status)) return;
 	return {
@@ -1121,7 +1133,7 @@ async function openQrLoginStream(connection, cookies, input, onEvent, signal) {
 	const path = AUTH_PATHS.qrStream;
 	const method = "POST";
 	const url = require_redact.joinUrl(connection.baseUrl, path);
-	const abort = require_url.createRequestAbortScope(signal, connection.signal, 0, connection.clock);
+	const abort = require_url.createRequestAbortScope(signal, connection.signal, connection.clock);
 	try {
 		const headers = await connection.baseHeaders(url);
 		headers.delete("Authorization");
@@ -1140,13 +1152,12 @@ async function openQrLoginStream(connection, cookies, input, onEvent, signal) {
 				signal: abort.signal
 			});
 		} catch (error) {
-			const failure = new require_errors.ItdNetworkError(`Не удалось открыть QR-поток: ${String(error)}`, {
+			const failure = new require_validate.ItdNetworkError(`Не удалось открыть QR-поток: ${String(error)}`, {
 				method,
 				path,
 				cause: error
 			});
 			throw require_url.requestAbortError(abort, {
-				timeout: 0,
 				method,
 				path
 			}, failure);
@@ -1169,14 +1180,13 @@ async function openQrLoginStream(connection, cookies, input, onEvent, signal) {
 				now: connection.clock.now()
 			});
 		}
-		if (!response.body) throw new require_errors.ItdNetworkError("Сервер не вернул тело QR-потока", {
+		if (!response.body) throw new require_validate.ItdNetworkError("Сервер не вернул тело QR-потока", {
 			method,
 			path
 		});
 		await consumeQrLoginStream(response.body, onEvent, abort.signal);
 	} catch (error) {
 		throw require_url.requestAbortError(abort, {
-			timeout: 0,
 			method,
 			path
 		}, error);
@@ -1228,7 +1238,7 @@ var AuthResource = class extends require_render.BaseResource {
 		flow.expiresAt = flow.expiresAt === void 0 ? expiresAt : Math.min(flow.expiresAt, expiresAt);
 	}
 	#forgetTerminalQrError(qrId, error) {
-		if (require_errors.isItdApiError(error) && error.hasCode("QR_EXPIRED", "QR_ALREADY_USED", "QR_TOKEN_MISMATCH")) this.#qrFlows.delete(qrId);
+		if (require_validate.isItdApiError(error) && error.hasCode("QR_EXPIRED", "QR_ALREADY_USED", "QR_TOKEN_MISMATCH")) this.#qrFlows.delete(qrId);
 	}
 	/**
 	* Проверяет состояние авторизации и возвращает текущего пользователя.
@@ -1334,7 +1344,7 @@ var AuthResource = class extends require_render.BaseResource {
 	* {@link claimQrLogin}, чтобы получить и сохранить access token.
 	*/
 	async streamQrLogin(input, onEvent, options = {}) {
-		if (typeof onEvent !== "function") throw new require_errors.ItdConfigError("onEvent QR-потока должен быть функцией");
+		if (typeof onEvent !== "function") throw new require_validate.ItdConfigError("onEvent QR-потока должен быть функцией");
 		const flow = this.#qrFlow(input.qrId);
 		try {
 			await openQrLoginStream(this.#connection, flow.cookies, input, async (event) => {
@@ -1491,7 +1501,7 @@ var AuthResource = class extends require_render.BaseResource {
 		const { getOtp, ...credentials } = input;
 		const result = await this.signIn(credentials, options);
 		if (result.status === SignInStatus.Authenticated) return result.accessToken;
-		if (!result.flowToken) throw new require_errors.ItdConfigError("Сервер запросил код подтверждения, но не вернул flowToken — продолжить вход невозможно");
+		if (!result.flowToken) throw new require_validate.ItdConfigError("Сервер запросил код подтверждения, но не вернул flowToken — продолжить вход невозможно");
 		const otp = await getOtp();
 		return this.verifyOtp({
 			email: credentials.email,
@@ -1660,7 +1670,7 @@ const CLIENT_PLUGIN_REGISTRIES = /* @__PURE__ */ new WeakMap();
 const DISPOSED_CLIENTS = /* @__PURE__ */ new WeakSet();
 function assertClientActive(client, action) {
 	if (!DISPOSED_CLIENTS.has(client)) return;
-	throw new require_errors.ItdStateError(`ItdClient уже окончательно освобождён через dispose(); нельзя ${action}. Создайте новый клиент`);
+	throw new require_validate.ItdStateError(`ItdClient уже окончательно освобождён через dispose(); нельзя ${action}. Создайте новый клиент`);
 }
 /** Проверяет возможность подключить плагин к клиенту без вызова `install()`. @internal */
 function assertClientCanUsePlugin(client, plugin) {
@@ -1904,9 +1914,9 @@ var ItdClient = class ItdClient {
 	*/
 	withFeature(key, feature) {
 		assertClientActive(this, "установить feature");
-		if (typeof key !== "string" || key.trim() === "" || key !== key.trim()) throw new require_errors.ItdConfigError("Свойство feature должно иметь непустое имя без краевых пробелов");
-		if (key === "then" || key in this) throw new require_errors.ItdConfigError(`Свойство клиента «${key}» уже занято или зарезервировано`);
-		if (!Object.isExtensible(this)) throw new require_errors.ItdConfigError("Нельзя опубликовать feature на нерасширяемом клиенте");
+		if (typeof key !== "string" || key.trim() === "" || key !== key.trim()) throw new require_validate.ItdConfigError("Свойство feature должно иметь непустое имя без краевых пробелов");
+		if (key === "then" || key in this) throw new require_validate.ItdConfigError(`Свойство клиента «${key}» уже занято или зарезервировано`);
+		if (!Object.isExtensible(this)) throw new require_validate.ItdConfigError("Нельзя опубликовать feature на нерасширяемом клиенте");
 		const api = this.install(feature);
 		Object.defineProperty(this, key, {
 			value: api,
@@ -2172,20 +2182,27 @@ function createClient(options = {}) {
 }
 //#endregion
 //#region src/accounts.ts
+/** Как аккаунты делят между собой очередь запросов. */
+const RateLimitScope = Object.freeze({
+	/** У каждого аккаунта своя очередь. */
+	Account: "account",
+	/** Одна очередь на всех — умолчание. */
+	Shared: "shared"
+});
 /** Проверяет имя до создания клиента или частичного восстановления контейнера. */
 function validateAccountName(name) {
-	if (typeof name !== "string" || name.trim() === "") throw new require_errors.ItdConfigError("имя аккаунта должно быть непустой строкой");
+	if (typeof name !== "string" || name.trim() === "") throw new require_validate.ItdConfigError("имя аккаунта должно быть непустой строкой");
 }
 /** Проверяет фабрики до создания первого аккаунта. */
 function resolveAccountFeatures(features) {
 	if (features === void 0) return [];
-	if (!Array.isArray(features)) throw new require_errors.ItdConfigError("features должен быть массивом фабрик подключаемых модулей");
+	if (!Array.isArray(features)) throw new require_validate.ItdConfigError("features должен быть массивом фабрик подключаемых модулей");
 	const keys = /* @__PURE__ */ new Set();
 	return features.map((feature, index) => {
-		if (typeof feature !== "object" || feature === null || typeof feature.create !== "function") throw new require_errors.ItdConfigError(`features[${index}] должен предоставлять create()`);
+		if (typeof feature !== "object" || feature === null || typeof feature.create !== "function") throw new require_validate.ItdConfigError(`features[${index}] должен предоставлять create()`);
 		if (feature.key !== void 0) {
-			if (typeof feature.key !== "string" || feature.key.trim() === "" || feature.key !== feature.key.trim()) throw new require_errors.ItdConfigError(`features[${index}].key должен быть непустой строкой без пробелов`);
-			if (keys.has(feature.key)) throw new require_errors.ItdConfigError(`Свойство подключаемого модуля «${feature.key}» объявлено повторно`);
+			if (typeof feature.key !== "string" || feature.key.trim() === "" || feature.key !== feature.key.trim()) throw new require_validate.ItdConfigError(`features[${index}].key должен быть непустой строкой без пробелов`);
+			if (keys.has(feature.key)) throw new require_validate.ItdConfigError(`Свойство подключаемого модуля «${feature.key}» объявлено повторно`);
 			keys.add(feature.key);
 		}
 		const create = feature.create.bind(feature);
@@ -2198,7 +2215,7 @@ function resolveAccountFeatures(features) {
 const DISPOSED_ACCOUNTS = /* @__PURE__ */ new WeakSet();
 function assertAccountsActive(accounts, action) {
 	if (!DISPOSED_ACCOUNTS.has(accounts)) return;
-	throw new require_errors.ItdStateError(`ItdAccounts уже окончательно освобождён через dispose(); нельзя ${action}. Создайте новый контейнер`);
+	throw new require_validate.ItdStateError(`ItdAccounts уже окончательно освобождён через dispose(); нельзя ${action}. Создайте новый контейнер`);
 }
 /**
 * Несколько аккаунтов итд.com в одном месте.
@@ -2261,15 +2278,16 @@ var ItdAccounts = class ItdAccounts {
 	#disposePromise;
 	constructor(options = {}) {
 		const { storage, plugins, features, rateLimitScope, ...base } = options;
-		if (rateLimitScope !== void 0 && rateLimitScope !== "account" && rateLimitScope !== "shared") throw new require_errors.ItdConfigError("rateLimitScope должен быть 'account' или 'shared'");
+		const scopes = Object.values(RateLimitScope);
+		if (rateLimitScope !== void 0 && !scopes.includes(rateLimitScope)) throw new require_validate.ItdConfigError(`rateLimitScope должен быть одним из ${scopes.join(", ")}`);
 		this.#base = base;
 		this.#storage = storage ?? new require_multi_storage.MemoryMultiTokenStorage();
 		this.#plugins = require_url.orderPluginDefinitions(plugins ?? []);
 		this.#features = resolveAccountFeatures(features);
-		this.#rateLimitScope = rateLimitScope ?? "shared";
-		const rateLimit = this.#rateLimitScope === "shared" ? require_url.resolveRateLimit(base.rateLimit, require_url.ITD_CATALOG) : void 0;
+		this.#rateLimitScope = rateLimitScope ?? RateLimitScope.Shared;
+		const rateLimit = this.#rateLimitScope === RateLimitScope.Shared ? require_url.resolveRateLimit(base.rateLimit, require_url.ITD_CATALOG) : void 0;
 		this.#queues = rateLimit ? new require_url.RequestQueuePool(rateLimit, base.clock ?? require_url.systemClock) : void 0;
-		const logger = typeof base.logger === "object" ? base.logger : void 0;
+		const logger = require_redact.resolveLogger(base.logger);
 		this.#logger = logger;
 		this.#emitter = new require_events.Emitter((error) => require_events.reportListenerError(logger, "аккаунтов", error));
 	}
@@ -2310,9 +2328,9 @@ var ItdAccounts = class ItdAccounts {
 	addAccount(name, options = {}) {
 		assertAccountsActive(this, "добавить аккаунт");
 		validateAccountName(name);
-		if (this.#clients.has(name)) throw new require_errors.ItdConfigError(`аккаунт «${name}» уже добавлен. Возьмите его через accounts.account('${name}')`);
-		if (this.#removing.has(name)) throw new require_errors.ItdConfigError(`аккаунт «${name}» ещё удаляется. Дождитесь завершения removeAccount() перед повторным добавлением`);
-		if (this.#rateLimitScope === "shared" && options.rateLimit !== void 0 && options.rateLimit !== false) throw new require_errors.ItdConfigError("при rateLimitScope: 'shared' настройки rateLimit задаются контейнеру; аккаунту можно передать только rateLimit: false");
+		if (this.#clients.has(name)) throw new require_validate.ItdConfigError(`аккаунт «${name}» уже добавлен. Возьмите его через accounts.account('${name}')`);
+		if (this.#removing.has(name)) throw new require_validate.ItdConfigError(`аккаунт «${name}» ещё удаляется. Дождитесь завершения removeAccount() перед повторным добавлением`);
+		if (this.#rateLimitScope === RateLimitScope.Shared && options.rateLimit !== void 0 && options.rateLimit !== false) throw new require_validate.ItdConfigError("при rateLimitScope: 'shared' настройки rateLimit задаются контейнеру; аккаунту можно передать только rateLimit: false");
 		const storageControl = require_multi_storage.controlledTokenStorage(this.#storage, name);
 		let client;
 		try {
@@ -2351,7 +2369,7 @@ var ItdAccounts = class ItdAccounts {
 		const client = this.#clients.get(name);
 		if (!client) {
 			const known = this.names();
-			throw new require_errors.ItdConfigError(`аккаунт «${name}» не заведён. ` + (known.length > 0 ? `Известны: ${known.join(", ")}` : "Ни одного аккаунта нет — добавьте его через addAccount() или restore()"));
+			throw new require_validate.ItdConfigError(`аккаунт «${name}» не заведён. ` + (known.length > 0 ? `Известны: ${known.join(", ")}` : "Ни одного аккаунта нет — добавьте его через addAccount() или restore()"));
 		}
 		return client;
 	}
@@ -2438,7 +2456,7 @@ var ItdAccounts = class ItdAccounts {
 	*/
 	use(plugin) {
 		assertAccountsActive(this, "подключить плагин");
-		if (this.#removingPlugins.has(plugin?.name)) throw new require_errors.ItdConfigError(`плагин «${plugin.name}» ещё отключается; дождитесь завершения accounts.unuse()`);
+		if (this.#removingPlugins.has(plugin?.name)) throw new require_validate.ItdConfigError(`плагин «${plugin.name}» ещё отключается; дождитесь завершения accounts.unuse()`);
 		const ordered = require_url.orderPluginDefinitions([...this.#plugins, plugin]);
 		const clients = [...this.#clients.values()];
 		for (const client of clients) assertClientCanUsePlugin(client, plugin);
@@ -2603,9 +2621,7 @@ var ItdAccounts = class ItdAccounts {
 	}
 	/** Не теряет ошибку фонового освобождения ресурсов, которого синхронный API не ждёт. */
 	#reportCleanup(scope, error) {
-		const message = `Не удалось освободить ресурсы после ${scope}`;
-		if (this.#logger) this.#logger.error(message, error);
-		else console.error(`[itd-api] ${message}`, error);
+		(this.#logger ?? require_redact.fallbackLogger).error(`Не удалось освободить ресурсы после ${scope}`, error);
 	}
 	/** Ретранслирует события клиента наружу, добавляя к ним имя аккаунта. */
 	#forwardEvents(account, client) {
@@ -2656,30 +2672,31 @@ exports.FileTransferMode = require_options.FileTransferMode;
 exports.IMAGE_MIME_TYPES = require_render.IMAGE_MIME_TYPES;
 exports.IncidentKind = require_url.IncidentKind;
 exports.InteractionType = require_url.InteractionType;
-exports.ItdAbortError = require_errors.ItdAbortError;
+exports.ItdAbortError = require_validate.ItdAbortError;
 exports.ItdAccounts = ItdAccounts;
-exports.ItdApiError = require_errors.ItdApiError;
-exports.ItdApiErrorKind = require_errors.ItdApiErrorKind;
-exports.ItdAuthError = require_errors.ItdAuthError;
+exports.ItdApiError = require_validate.ItdApiError;
+exports.ItdApiErrorKind = require_validate.ItdApiErrorKind;
+exports.ItdAuthError = require_validate.ItdAuthError;
 exports.ItdClient = ItdClient;
-exports.ItdConfigError = require_errors.ItdConfigError;
-exports.ItdConflictError = require_errors.ItdConflictError;
-exports.ItdError = require_errors.ItdError;
+exports.ItdConfigError = require_validate.ItdConfigError;
+exports.ItdConflictError = require_validate.ItdConflictError;
+exports.ItdError = require_validate.ItdError;
 exports.ItdErrorCode = require_url.ItdErrorCode;
-exports.ItdErrorKind = require_errors.ItdErrorKind;
-exports.ItdFileError = require_errors.ItdFileError;
-exports.ItdFileErrorReason = require_errors.ItdFileErrorReason;
-exports.ItdForbiddenError = require_errors.ItdForbiddenError;
-exports.ItdNetworkError = require_errors.ItdNetworkError;
-exports.ItdNotFoundError = require_errors.ItdNotFoundError;
-exports.ItdPhoneVerificationError = require_errors.ItdPhoneVerificationError;
-exports.ItdRateLimitError = require_errors.ItdRateLimitError;
-exports.ItdServerError = require_errors.ItdServerError;
-exports.ItdStateError = require_errors.ItdStateError;
-exports.ItdTimeoutError = require_errors.ItdTimeoutError;
-exports.ItdValidationError = require_errors.ItdValidationError;
+exports.ItdErrorKind = require_validate.ItdErrorKind;
+exports.ItdFileError = require_validate.ItdFileError;
+exports.ItdFileErrorReason = require_validate.ItdFileErrorReason;
+exports.ItdForbiddenError = require_validate.ItdForbiddenError;
+exports.ItdNetworkError = require_validate.ItdNetworkError;
+exports.ItdNotFoundError = require_validate.ItdNotFoundError;
+exports.ItdPhoneVerificationError = require_validate.ItdPhoneVerificationError;
+exports.ItdRateLimitError = require_validate.ItdRateLimitError;
+exports.ItdServerError = require_validate.ItdServerError;
+exports.ItdStateError = require_validate.ItdStateError;
+exports.ItdTimeoutError = require_validate.ItdTimeoutError;
+exports.ItdValidationError = require_validate.ItdValidationError;
 exports.LIBRARY_VERSION = require_url.LIBRARY_VERSION;
 exports.LikesVisibility = require_url.LikesVisibility;
+exports.LogLevel = require_redact.LogLevel;
 exports.MemoryKeyValueStore = require_key_value_store.MemoryKeyValueStore;
 exports.MemoryMultiTokenStorage = require_multi_storage.MemoryMultiTokenStorage;
 exports.MemoryShopOrderAccessStorage = require_render.MemoryShopOrderAccessStorage;
@@ -2691,12 +2708,14 @@ exports.NotificationType = require_url.NotificationType;
 exports.NotificationUpdateOrigin = require_events.NotificationUpdateOrigin;
 exports.NotificationUpdateType = require_events.NotificationUpdateType;
 exports.OPERATIONS = require_url.OPERATIONS;
+exports.OperationMethod = require_url.OperationMethod;
 exports.PaginationMode = require_render.PaginationMode;
 exports.Paginator = require_render.Paginator;
 exports.QrLocationPrecision = require_url.QrLocationPrecision;
 exports.QrLoginStatus = QrLoginStatus;
 exports.QrLoginStreamStatus = QrLoginStreamStatus;
 exports.RateLimitPacing = require_url.RateLimitPacing;
+exports.RateLimitScope = RateLimitScope;
 exports.ReportReason = require_url.ReportReason;
 exports.ReportTargetType = require_url.ReportTargetType;
 exports.RetrySafety = require_url.RetrySafety;
@@ -2711,6 +2730,7 @@ exports.SignInStatus = SignInStatus;
 exports.SpanRenderFormat = require_render.SpanRenderFormat;
 exports.SpanType = require_url.SpanType;
 exports.TURNSTILE_SITE_KEY = TURNSTILE_SITE_KEY;
+exports.TimeoutBudget = require_validate.TimeoutBudget;
 exports.UnauthorizedStreamError = require_events.UnauthorizedStreamError;
 exports.VIDEO_MIME_TYPES = require_render.VIDEO_MIME_TYPES;
 exports.ViewReason = require_url.ViewReason;
@@ -2735,18 +2755,18 @@ exports.fromUrl = require_render.fromUrl;
 exports.isBuilder = require_render.isBuilder;
 exports.isBuiltInOperationId = require_url.isBuiltInOperationId;
 exports.isEnumerableKeyValueStore = require_key_value_store.isEnumerableKeyValueStore;
-exports.isItdApiError = require_errors.isItdApiError;
-exports.isItdAuthError = require_errors.isItdAuthError;
-exports.isItdConflictError = require_errors.isItdConflictError;
-exports.isItdError = require_errors.isItdError;
-exports.isItdFileError = require_errors.isItdFileError;
-exports.isItdForbiddenError = require_errors.isItdForbiddenError;
-exports.isItdNotFoundError = require_errors.isItdNotFoundError;
-exports.isItdPhoneVerificationError = require_errors.isItdPhoneVerificationError;
-exports.isItdRateLimitError = require_errors.isItdRateLimitError;
-exports.isItdServerError = require_errors.isItdServerError;
-exports.isItdStateError = require_errors.isItdStateError;
-exports.isItdValidationError = require_errors.isItdValidationError;
+exports.isItdApiError = require_validate.isItdApiError;
+exports.isItdAuthError = require_validate.isItdAuthError;
+exports.isItdConflictError = require_validate.isItdConflictError;
+exports.isItdError = require_validate.isItdError;
+exports.isItdFileError = require_validate.isItdFileError;
+exports.isItdForbiddenError = require_validate.isItdForbiddenError;
+exports.isItdNotFoundError = require_validate.isItdNotFoundError;
+exports.isItdPhoneVerificationError = require_validate.isItdPhoneVerificationError;
+exports.isItdRateLimitError = require_validate.isItdRateLimitError;
+exports.isItdServerError = require_validate.isItdServerError;
+exports.isItdStateError = require_validate.isItdStateError;
+exports.isItdValidationError = require_validate.isItdValidationError;
 exports.isKnownNotificationType = require_url.isKnownNotificationType;
 exports.isMyProfile = require_render.isMyProfile;
 exports.mapPage = require_render.mapPage;