itd-api 0.7.1 → 0.8.0

package/dist/shared/{url-yjl2c8Ie.cjs → url-CFN1sT9S.cjs}

@@ -1,5 +1,5 @@
-const require_errors = require("./errors-DfU8M5eS.cjs");
-const require_cookies = require("./cookies-DZwFq6kr.cjs");
+const require_errors = require("./errors-BmP3TKoW.cjs");
+const require_redact = require("./redact-DB9EMGJx.cjs");
 //#region src/core/async-dispose.ts
 /**
 * Подставляет метод `await using` там, где `Symbol.asyncDispose` отсутствует.
@@ -51,120 +51,6 @@ function createDeadline(timeout, clock = systemClock) {
 	};
 }
 //#endregion
-//#region src/core/runtime.ts
-/**
-* Как библиотека обращается с cookie.
-*
-* - `browser` — cookie ведёт браузер, запросы уходят с `credentials: 'include'`;
-* - `server` — cookie ведёт встроенный jar, заголовок `Cookie` подставляется вручную;
-* - `auto` — определяется по среде исполнения (значение по умолчанию).
-*/
-const RuntimeMode = Object.freeze({
-	/** Определяется по среде исполнения. Значение по умолчанию. */
-	Auto: "auto",
-	/** Cookie ведёт браузер, запросы уходят с `credentials: 'include'`. */
-	Browser: "browser",
-	/** Cookie ведёт встроенный jar, заголовок `Cookie` подставляется вручную. */
-	Server: "server"
-});
-/** Распознанная среда исполнения. */
-const DetectedRuntime = Object.freeze({
-	Browser: "browser",
-	/** Есть `window`, но нет `document`; cookie ведёт нативный сетевой слой. */
-	ReactNative: "react-native",
-	Server: "server"
-});
-/**
-* Определяет среду исполнения.
-*
-* React Native выделен отдельно намеренно: там есть `window`, но нет `document`, а cookie
-* хранит нативный сетевой слой (`NSHTTPCookieStorage` / `OkHttp`). Свой jar в этой среде
-* привёл бы к отправке cookie дважды.
-*/
-function detectRuntime() {
-	if (globalThis.navigator?.product === "ReactNative") return DetectedRuntime.ReactNative;
-	if (typeof document !== "undefined") return DetectedRuntime.Browser;
-	return DetectedRuntime.Server;
-}
-/**
-* Нужно ли вести собственный cookie-jar.
-*
-* Только в серверных средах: в браузере `Set-Cookie` из JS не читается и не нужен,
-* в React Native cookie ведёт нативный слой.
-*/
-function shouldUseCookieJar(mode) {
-	if (mode === RuntimeMode.Browser) return false;
-	if (mode === RuntimeMode.Server) return true;
-	return detectRuntime() === DetectedRuntime.Server;
-}
-/**
-* Нужно ли отправлять запросы с `credentials: 'include'`.
-*
-* Только в браузере: именно так refresh-cookie попадает в запрос `POST /api/v1/auth/refresh`.
-* Требует настроенного CORS на стороне итд.com — если его нет, укажите свой прокси в `baseUrl`.
-*/
-function shouldSendCredentials(mode) {
-	if (mode === RuntimeMode.Browser) return true;
-	if (mode === RuntimeMode.Server) return false;
-	return detectRuntime() === DetectedRuntime.Browser;
-}
-/**
-* Возвращает реализацию `fetch`.
-*
-* @param custom реализация из конфигурации клиента, если пользователь её передал
-* @throws {ItdConfigError} если `fetch` недоступен — например, на Node ниже 18
-*/
-function resolveFetch(custom) {
-	if (custom !== void 0) {
-		if (typeof custom !== "function") throw new require_errors.ItdConfigError("fetch должен быть функцией");
-		return custom;
-	}
-	if (typeof globalThis.fetch === "function") return globalThis.fetch.bind(globalThis);
-	throw new require_errors.ItdConfigError("В этой среде нет глобального fetch. Обновитесь до Node 18+ либо передайте свою реализацию через опцию fetch.");
-}
-/**
-* Проверки бинарных типов, безопасные в любой среде.
-*
-* Обычный `instanceof` здесь недостаточен: конструктора может не быть вовсе, и тогда
-* проверка падает с `ReferenceError`, а не возвращает `false`. `Blob` есть в Node с 18.0,
-* но `File` стал глобальным только в Node 20 — при заявленной поддержке Node 18 голый
-* `instanceof File` ронял бы любую загрузку.
-*/
-function isBlob(value) {
-	return typeof Blob !== "undefined" && value instanceof Blob;
-}
-/** @see {@link isBlob} */
-function isFile(value) {
-	return typeof File !== "undefined" && value instanceof File;
-}
-/** Доступно ли потоковое чтение тела ответа — от этого зависит, сработает ли SSE. */
-function supportsStreamingBody() {
-	return typeof ReadableStream !== "undefined" && typeof TextDecoder !== "undefined";
-}
-/**
-* Создаёт идентификатор устройства для заголовка `X-Device-Id` — UUID v4.
-*
-* `crypto.randomUUID` есть в Node 19+, браузерах и Deno, но отсутствует в Node 18 вне
-* защищённого контекста, поэтому предусмотрен запасной путь.
-*/
-function createDeviceId() {
-	const webCrypto = globalThis.crypto;
-	if (typeof webCrypto?.randomUUID === "function") return webCrypto.randomUUID();
-	const bytes = /* @__PURE__ */ new Uint8Array(16);
-	if (typeof webCrypto?.getRandomValues === "function") webCrypto.getRandomValues(bytes);
-	else for (let i = 0; i < bytes.length; i++) bytes[i] = Math.floor(Math.random() * 256);
-	bytes[6] = bytes[6] & 15 | 64;
-	bytes[8] = bytes[8] & 63 | 128;
-	const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
-	return [
-		hex.slice(0, 8),
-		hex.slice(8, 12),
-		hex.slice(12, 16),
-		hex.slice(16, 20),
-		hex.slice(20, 32)
-	].join("-");
-}
-//#endregion
 //#region src/core/scheduling/pacing.ts
 /** Реакция на остаток лимита из заголовков ответа. */
 const RateLimitPacing = Object.freeze({
@@ -199,7 +85,7 @@ function requireOptionalBoolean(value, name) {
 //#endregion
 //#region src/core/version.ts
 /** Версия библиотеки. Попадает в `User-Agent`. */
-const LIBRARY_VERSION = "0.7.1";
+const LIBRARY_VERSION = "0.8.0";
 //#endregion
 //#region src/core/config.ts
 /** Базовый URL API итд.com. Домен записан в punycode: `итд.com`. */
@@ -208,12 +94,6 @@ const DEFAULT_BASE_URL = "https://xn--d1ah4a.com";
 const DEFAULT_STATUS_BASE_URL = "https://xn--80a7abcbg.xn--d1ah4a.com";
 /** Имя встроенного сервиса статуса. */
 const STATUS_SERVICE = "status";
-/** Сервисы, зарегистрированные у любого клиента. */
-const BUILT_IN_SERVICES = Object.freeze([Object.freeze({
-	name: STATUS_SERVICE,
-	baseUrl: DEFAULT_STATUS_BASE_URL,
-	auth: false
-})]);
 /**
 * `User-Agent` по умолчанию.
 *
@@ -324,6 +204,10 @@ function requireConcurrency(value, name) {
 	if (!Number.isInteger(value) || value < 1) throw new require_errors.ItdConfigError(`${name} должен быть целым числом от 1, получено: ${value}`);
 	return value;
 }
+function requireRps(value, name) {
+	if (!Number.isFinite(value) || value <= 0) throw new require_errors.ItdConfigError(`${name} должен быть положительным числом, получено: ${value}`);
+	return value;
+}
 function resolvePacing(pacing) {
 	const known = Object.values(RateLimitPacing);
 	if (pacing !== void 0 && !known.includes(pacing)) throw new require_errors.ItdConfigError(`rateLimit.pacing должен быть одним из ${known.join(", ")}, получено: ${pacing}`);
@@ -346,9 +230,11 @@ function resolveBucketOverrides(overrides, bucket, catalog) {
 		assertKnownBucket(name, "rateLimit.bucketOverrides", bucket, catalog);
 		if (override.concurrency !== void 0) requireConcurrency(override.concurrency, `rateLimit.bucketOverrides.${name}.concurrency`);
 		if (override.limit !== void 0 && (!Number.isFinite(override.limit) || override.limit <= 0)) throw new require_errors.ItdConfigError(`rateLimit.bucketOverrides.${name}.limit должен быть положительным числом, получено: ${override.limit}`);
+		if (override.rps !== void 0) requireRps(override.rps, `rateLimit.bucketOverrides.${name}.rps`);
 		const built = builtIn[name];
 		resolved[name] = Object.freeze({
 			concurrency: override.concurrency ?? built?.concurrency,
+			rps: override.rps ?? built?.rps,
 			limit: override.limit ?? built?.limit
 		});
 	}
@@ -381,7 +267,7 @@ function resolveRateLimit(rateLimit, catalog) {
 	};
 	if (!rateLimit) return defaults;
 	const concurrency = requireConcurrency(rateLimit.concurrency ?? 6, "rateLimit.concurrency");
-	if (rateLimit.rps !== void 0 && (!Number.isFinite(rateLimit.rps) || rateLimit.rps <= 0)) throw new require_errors.ItdConfigError(`rateLimit.rps должен быть положительным числом, получено: ${rateLimit.rps}`);
+	if (rateLimit.rps !== void 0) requireRps(rateLimit.rps, "rateLimit.rps");
 	const retryDelays = rateLimit.retryDelays ?? defaults.retryDelays;
 	if (!Array.isArray(retryDelays)) throw new require_errors.ItdConfigError("rateLimit.retryDelays должен быть массивом чисел");
 	for (const delay of retryDelays) requirePositive(delay, "rateLimit.retryDelays");
@@ -430,16 +316,16 @@ function resolveServices(services) {
 */
 function resolveRuntimeConfig(options, catalog) {
 	if (!isRecord$1(options)) throw new require_errors.ItdConfigError("опции клиента должны быть объектом");
-	const mode = options.mode ?? RuntimeMode.Auto;
-	if (!Object.values(RuntimeMode).includes(mode)) throw new require_errors.ItdConfigError(`mode должен быть одним из ${Object.values(RuntimeMode).join(", ")}, получено: ${mode}`);
+	const mode = options.mode ?? require_redact.RuntimeMode.Auto;
+	if (!Object.values(require_redact.RuntimeMode).includes(mode)) throw new require_errors.ItdConfigError(`mode должен быть одним из ${Object.values(require_redact.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_errors.ItdConfigError("clock должен предоставлять методы now() и schedule()");
 	if (options.userAgent !== void 0 && options.userAgent !== false && typeof options.userAgent !== "string") throw new require_errors.ItdConfigError("userAgent должен быть строкой или false");
 	return {
-		baseUrl: require_cookies.normalizeBaseUrl(options.baseUrl ?? "https://xn--d1ah4a.com"),
+		baseUrl: require_redact.normalizeBaseUrl(options.baseUrl ?? "https://xn--d1ah4a.com"),
 		services: resolveServices(options.services),
-		fetch: resolveFetch(options.fetch),
+		fetch: require_redact.resolveFetch(options.fetch),
 		clock: options.clock ?? systemClock,
 		timeout,
 		shutdownTimeout,
@@ -449,8 +335,8 @@ function resolveRuntimeConfig(options, catalog) {
 		headers: resolveHeaders(options.headers),
 		userAgent: options.userAgent === false ? void 0 : options.userAgent ?? DEFAULT_USER_AGENT,
 		mode,
-		useCookieJar: shouldUseCookieJar(mode),
-		sendCredentials: shouldSendCredentials(mode),
+		useCookieJar: require_redact.shouldUseCookieJar(mode),
+		sendCredentials: require_redact.shouldSendCredentials(mode),
 		logger: resolveLogger(options.logger)
 	};
 }
@@ -666,7 +552,10 @@ var PluginRegistry = class {
 		};
 		const installed = plugin.install({
 			...context,
-			operations: { use: (transformer) => register(transformers, transformer, "operations") },
+			operations: {
+				get: this.#options.operationMetadata,
+				use: (transformer) => register(transformers, transformer, "operations")
+			},
 			attempts: { use: (interceptor) => register(interceptors, interceptor, "attempts") }
 		});
 		if (installed !== void 0 && typeof installed !== "function") throw new require_errors.ItdConfigError(`install() плагина «${plugin.name}» должен вернуть функцию или void`);
@@ -705,8 +594,9 @@ var PluginRegistry = class {
 		this.#removing.add(name);
 		const deadline = createDeadline(this.#options.shutdownTimeout, this.#options.clock);
 		const cleanup = this.#trackCleanup((async () => {
-			const expired = await this.#release(entry, deadline);
-			if (expired) throw expired;
+			const expirationErrors = await this.#release(entry, deadline);
+			if (expirationErrors.length === 1) throw expirationErrors[0];
+			if (expirationErrors.length > 1) throw new AggregateError(expirationErrors, `Не удалось отключить плагин «${name}»`);
 		})());
 		try {
 			await cleanup;
@@ -734,8 +624,7 @@ var PluginRegistry = class {
 			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 {
-				const expired = await this.#release(entry, deadline);
-				if (expired) errors.push(expired);
+				errors.push(...await this.#release(entry, deadline));
 			} catch (error) {
 				errors.push(error);
 			} finally {
@@ -761,13 +650,29 @@ var PluginRegistry = class {
 	* @param execute выполнение логической операции, вызываемое самым внутренним transformer
 	*/
 	async run(request, execute) {
-		const entries = [...this.#ordered];
+		const ordered = this.#ordered;
+		if (ordered.length === 0) return execute(request);
+		const entries = [...ordered];
 		for (const entry of entries) entry.activeRequests += 1;
 		const interceptorScope = entries.flatMap((entry) => entry.interceptors.map((interceptor) => ({
 			plugin: entry.plugin.name,
 			interceptor
 		})));
-		const scoped = (current) => withAttemptInterceptorScope(current, interceptorScope);
+		const operationId = request.operationId;
+		const method = request.method.toUpperCase();
+		const retrySafety = request.retrySafety;
+		const scoped = (current) => {
+			const prepared = current.retrySafety === void 0 ? {
+				...current,
+				retrySafety
+			} : current;
+			return interceptorScope.length === 0 ? prepared : withAttemptInterceptorScope(prepared, interceptorScope);
+		};
+		const validateContract = (prepared) => {
+			if (prepared.operationId !== operationId) throw new require_errors.ItdConfigError(`operation transformer не может заменить operationId «${operationId}» на «${prepared.operationId}»`);
+			if (prepared.method.toUpperCase() !== method) throw new require_errors.ItdConfigError(`operation transformer не может заменить метод «${method}» операции «${operationId}» на «${prepared.method}»`);
+			if (prepared.retrySafety !== void 0 && prepared.retrySafety !== retrySafety) throw new require_errors.ItdConfigError(`operation transformer не может заменить retrySafety операции «${operationId}»`);
+		};
 		const chain = entries.flatMap((entry) => entry.transformers.map((transformer) => ({
 			plugin: entry.plugin.name,
 			transformer
@@ -776,9 +681,13 @@ var PluginRegistry = class {
 			return transformer(scoped(current), (prepared) => {
 				if (called) throw new require_errors.ItdConfigError(`operation transformer плагина «${plugin}» вызвал next() больше одного раза`);
 				called = true;
+				validateContract(prepared);
 				return next(scoped(prepared));
 			});
-		}, (current) => execute(scoped(current)));
+		}, (current) => {
+			validateContract(current);
+			return execute(scoped(current));
+		});
 		try {
 			return await chain(scoped(request));
 		} finally {
@@ -795,14 +704,23 @@ var PluginRegistry = class {
 	/**
 	* Дожидается операций плагина и освобождает его ресурсы.
 	*
-	* `teardown` выполняется в любом случае, в том числе после истечения срока.
+	* Функция очистки запускается после ожидания активных операций. Обе стадии ограничены
+	* общим сроком.
 	*
-	* @returns ошибка истёкшего срока, если ждать пришлось дольше отведённого
+	* @returns ошибки истёкшего срока для незавершённых стадий
 	*/
 	async #release(entry, deadline) {
-		const finished = await deadline.wait(this.#waitForDrain(entry));
-		await entry.teardown?.();
-		return finished ? void 0 : new require_errors.ItdStateError(`плагин «${entry.plugin.name}» не завершил операции за ${this.#options.shutdownTimeout} мс; ожидание прекращено, ресурсы плагина освобождены`);
+		const errors = [];
+		if (!await deadline.wait(this.#waitForDrain(entry))) errors.push(new require_errors.ItdStateError(`плагин «${entry.plugin.name}» не завершил операции за ${this.#options.shutdownTimeout} мс`));
+		let teardownFailed = false;
+		let teardownFailure;
+		const teardown = Promise.resolve().then(() => entry.teardown?.()).catch((error) => {
+			teardownFailed = true;
+			teardownFailure = error;
+		});
+		if (!await deadline.wait(teardown)) errors.push(new require_errors.ItdStateError(`плагин «${entry.plugin.name}» не завершил teardown за ${this.#options.shutdownTimeout} мс`));
+		else if (teardownFailed) throw teardownFailure;
+		return errors;
 	}
 	#waitForDrain(entry) {
 		if (entry.activeRequests === 0) return Promise.resolve();
@@ -827,148 +745,118 @@ function queueAbortError() {
 function queueStoppedError() {
 	return new require_errors.ItdAbortError("Клиент закрыт, запрос отменён");
 }
+/** Длина окна лимита на сервере. */
+const RATE_LIMIT_WINDOW = 6e4;
 /**
-* Очередь запросов: ограничивает одновременность и частоту.
-*
-* Нужна прежде всего ботам: без неё цикл по сотне постов уходит в API одним залпом
-* и упирается в `RATE_LIMIT_EXCEEDED`.
+* Пауза при исчерпании бакета неизвестной ёмкости.
 *
-* Частота выдерживается равномерным разносом стартов (`1000 / rps` между запросами),
-* а не окном со счётчиком: так нагрузка ровная, без всплеска в начале каждой секунды.
+* Ёмкость приходит в заголовке вместе с остатком, поэтому случай возможен только у чужого
+* прокси, который прислал `remaining` без `limit`.
+*/
+const UNKNOWN_CAPACITY_PAUSE = 1e3;
+/**
+* Единый планировщик одного направления.
 *
-* @internal
+* Он выбирает готовый бакет и только перед фактическим запуском атомарно занимает общий
+* и локальный слоты. Одно ближайшее пробуждение обслуживает все бакеты направления.
 */
-var RequestQueue = class {
+var DestinationScheduler = class {
 	#concurrency;
-	/** Минимальный промежуток между стартами, мс. `0` — без ограничения частоты. */
 	#minGap;
-	#onDispatch;
-	#waiting = [];
+	#clock;
+	#buckets = [];
 	#active = 0;
-	/** Момент, раньше которого следующий запрос стартовать не должен. */
 	#nextSlot = 0;
-	#clock;
+	#cursor = 0;
 	#cancelTimer;
-	constructor(options, clock = systemClock) {
+	#wakeupAt;
+	constructor(options, clock) {
 		this.#concurrency = options.concurrency;
 		this.#minGap = options.rps ? 1e3 / options.rps : 0;
-		this.#onDispatch = options.onDispatch;
 		this.#clock = clock;
 	}
-	/** Сколько задач выполняется прямо сейчас. */
-	get active() {
-		return this.#active;
+	register(bucket) {
+		this.#buckets.push(bucket);
 	}
-	/** Сколько задач ждёт очереди. */
-	get pending() {
-		return this.#waiting.length;
+	/** Пересчитывает ближайший запуск после изменения очереди или ограничения. */
+	changed() {
+		this.#drain();
 	}
-	/**
-	* Ставит задачу в очередь.
-	*
-	* @returns результат задачи; ошибка задачи пробрасывается без изменений
-	*/
-	schedule(task, signal) {
-		if (signal?.aborted) return Promise.reject(queueAbortError());
-		return new Promise((resolve, reject) => {
-			let queued;
-			const detach = () => signal?.removeEventListener("abort", onAbort);
-			const onAbort = () => {
-				const index = this.#waiting.indexOf(queued);
-				if (index < 0) return;
-				this.#waiting.splice(index, 1);
-				queued.cancel(queueAbortError());
-				this.#drain();
-			};
-			queued = {
-				run: () => {
-					detach();
-					this.#active += 1;
-					this.#onDispatch?.();
-					Promise.resolve().then(task).then(resolve, reject).finally(() => {
-						this.#active -= 1;
-						this.#drain();
-					});
-				},
-				cancel: (reason) => {
-					detach();
-					reject(reason);
-				}
-			};
-			this.#waiting.push(queued);
-			signal?.addEventListener("abort", onAbort, { once: true });
-			if (signal?.aborted) onAbort();
-			else this.#drain();
-		});
+	/** Перепланирует пробуждение после изменения времени готовности бакета. */
+	timingChanged() {
+		this.#cancelWakeup();
+		this.#drain();
 	}
-	/**
-	* Останавливает очередь: снимает отложенную паузу и отклоняет ещё не начатые задачи
-	* ошибкой `ItdAbortError`. Уже выполняющиеся задачи доводятся до конца.
-	*/
+	/** Отклоняет ожидающие задачи, сохраняя паузы и темп для повторного запуска клиента. */
 	stop() {
-		if (this.#cancelTimer) {
-			this.#cancelTimer();
-			this.#cancelTimer = void 0;
-		}
-		const pending = this.#waiting.splice(0, this.#waiting.length);
-		for (const task of pending) task.cancel(queueStoppedError());
+		this.#cancelWakeup();
+		for (const bucket of this.#buckets) bucket.cancelWaiting(queueStoppedError(), false);
 	}
-	/** Придерживает очередь на заданное время: ждут все её задачи, а не только одна. */
-	pause(ms) {
-		if (ms <= 0) return;
-		this.#nextSlot = Math.max(this.#nextSlot, this.#clock.now() + ms);
-	}
-	/** Запускает столько ожидающих задач, сколько позволяют ограничения. */
 	#drain() {
-		if (this.#waiting.length === 0) {
-			if (this.#cancelTimer) {
-				this.#cancelTimer();
-				this.#cancelTimer = void 0;
-			}
-			return;
-		}
 		if (this.#active >= this.#concurrency) return;
-		if (this.#cancelTimer) return;
 		const now = this.#clock.now();
-		if (this.#nextSlot > now) {
-			this.#cancelTimer = this.#clock.schedule(() => {
-				this.#cancelTimer = void 0;
-				this.#drain();
-			}, this.#nextSlot - now);
+		let selected;
+		let selectedIndex = -1;
+		let earliest = Number.POSITIVE_INFINITY;
+		for (let offset = 0; offset < this.#buckets.length; offset += 1) {
+			const index = (this.#cursor + offset) % this.#buckets.length;
+			const bucket = this.#buckets[index];
+			if (!bucket?.canStart) continue;
+			const readyAt = Math.max(this.#nextSlot, bucket.readyAt);
+			if (readyAt < earliest) earliest = readyAt;
+			if (readyAt <= now) {
+				selected = bucket;
+				selectedIndex = index;
+				break;
+			}
+		}
+		if (!selected) {
+			if (Number.isFinite(earliest)) this.#armWakeup(Math.max(0, earliest - now));
+			else this.#cancelWakeup();
 			return;
 		}
-		const next = this.#waiting.shift();
-		if (!next) return;
+		this.#cursor = (selectedIndex + 1) % this.#buckets.length;
+		this.#active += 1;
 		if (this.#minGap > 0) this.#nextSlot = now + this.#minGap;
-		next.run();
+		selected.dispatch(now, () => {
+			this.#active -= 1;
+			this.changed();
+		});
 		this.#drain();
 	}
+	#armWakeup(delay) {
+		const wakeupAt = this.#clock.now() + delay;
+		if (this.#cancelTimer && (this.#wakeupAt ?? Number.POSITIVE_INFINITY) <= wakeupAt) return;
+		this.#cancelWakeup();
+		this.#wakeupAt = wakeupAt;
+		this.#cancelTimer = this.#clock.schedule(() => {
+			this.#cancelTimer = void 0;
+			this.#wakeupAt = void 0;
+			this.#drain();
+		}, delay);
+	}
+	#cancelWakeup() {
+		this.#cancelTimer?.();
+		this.#cancelTimer = void 0;
+		this.#wakeupAt = void 0;
+	}
 };
-/** Длина окна лимита на сервере. */
-const RATE_LIMIT_WINDOW = 6e4;
 /**
-* Пауза при исчерпании бакета неизвестной ёмкости.
+* Состояние и очередь одного серверного бакета.
 *
-* Ёмкость приходит в заголовке вместе с остатком, поэтому случай возможен только у чужого
-* прокси, который прислал `remaining` без `limit`.
-*/
-const UNKNOWN_CAPACITY_PAUSE = 1e3;
-/**
-* Очередь одного бакета поверх общей очереди направления.
-*
-* Задача занимает слот бакета, затем общий слот направления, поэтому суммарная
-* одновременность остаётся равной `concurrency`. Пауза бакета удерживает задачу до
-* захвата общего слота: притормозивший счётчик не занимает общую ёмкость.
+* Класс хранит локальную конкурентность, темп и серверную квоту, а решение о старте
+* делегирует общему планировщику направления.
 *
 * @internal
 */
 var BucketQueue = class {
 	#destination;
 	#bucket;
-	#gate;
-	#shared;
+	#scheduler;
 	#clock;
 	#pacing;
+	#concurrency;
+	#minGap;
 	/** Ровный темп. Требует раздельных бакетов: без них ёмкость счётчика неизвестна. */
 	#smooth;
 	/**
@@ -985,6 +873,9 @@ var BucketQueue = class {
 	/** Последнее, что сказал сервер. Живёт и в режиме `off` — ради `rateLimitState()`. */
 	#limit;
 	#remaining;
+	#active = 0;
+	#nextSlot = 0;
+	#waiting = [];
 	/**
 	* Оценка остатка для режима `smooth`.
 	*
@@ -993,24 +884,19 @@ var BucketQueue = class {
 	*/
 	#tokens = 1;
 	#tokensAt;
-	/**
-	* Номер поколения очереди. `stop()` увеличивает его, отсекая задачи, которые уже взяли
-	* слот бакета, но до общей очереди ещё не дошли.
-	*/
-	#generation = 0;
-	constructor(destination, bucket, shared, options, clock) {
+	constructor(destination, bucket, scheduler, options, clock, featureDefinition) {
 		this.#destination = destination;
 		this.#bucket = bucket;
-		this.#shared = shared;
+		this.#scheduler = scheduler;
 		this.#clock = clock;
 		this.#pacing = options.pacing;
 		this.#smooth = options.buckets && options.pacing === RateLimitPacing.Smooth;
 		this.#flatPause = options.buckets ? void 0 : options.retryDelays[0] ?? 0;
-		this.#seedLimit = options.buckets ? seedLimit(bucket, options) : void 0;
-		this.#gate = new RequestQueue({
-			concurrency: options.buckets ? options.bucketOverrides[bucket]?.concurrency ?? options.bucketConcurrency : options.concurrency,
-			onDispatch: this.#smooth ? () => this.#spend() : void 0
-		}, clock);
+		this.#seedLimit = options.buckets ? featureDefinition?.limit ?? seedLimit(bucket, options) : void 0;
+		this.#concurrency = options.buckets ? featureDefinition?.concurrency ?? options.bucketOverrides[bucket]?.concurrency ?? options.bucketConcurrency : options.concurrency;
+		const rps = options.buckets ? featureDefinition?.rps ?? options.bucketOverrides[bucket]?.rps : void 0;
+		this.#minGap = rps ? 1e3 / rps : 0;
+		scheduler.register(this);
 	}
 	/** Имя счётчика. При `buckets: false` — всегда `default`, каким бы ни был запрос. */
 	get bucket() {
@@ -1018,19 +904,63 @@ var BucketQueue = class {
 	}
 	/** Запросов бакета прошло в общую очередь и ещё не завершилось. */
 	get active() {
-		return this.#gate.active;
+		return this.#active;
 	}
 	/** Запросов бакета ждёт своей очереди. */
 	get pending() {
-		return this.#gate.pending;
+		return this.#waiting.length;
+	}
+	/** Есть ли ожидающая задача, для которой свободен локальный слот. */
+	get canStart() {
+		return this.#waiting.length > 0 && this.#active < this.#concurrency;
 	}
-	/** Ставит запрос в очередь: сначала слот бакета, затем общий слот направления. */
+	/** Момент, раньше которого локальное ограничение не разрешает следующий старт. */
+	get readyAt() {
+		return this.#nextSlot;
+	}
+	/** Ставит запрос в очередь единого планировщика направления. */
 	schedule(task, signal) {
-		const generation = this.#generation;
-		return this.#gate.schedule(() => {
-			if (generation !== this.#generation) return Promise.reject(queueStoppedError());
-			return this.#shared.schedule(task, signal);
-		}, signal);
+		if (signal?.aborted) return Promise.reject(queueAbortError());
+		return new Promise((resolve, reject) => {
+			let queued;
+			const detach = () => signal?.removeEventListener("abort", onAbort);
+			const onAbort = () => {
+				const index = this.#waiting.indexOf(queued);
+				if (index < 0) return;
+				this.#waiting.splice(index, 1);
+				queued.cancel(queueAbortError());
+				this.#scheduler.timingChanged();
+			};
+			queued = {
+				start: (complete) => {
+					detach();
+					Promise.resolve().then(task).then(resolve, reject).finally(complete);
+				},
+				cancel: (reason) => {
+					detach();
+					reject(reason);
+				}
+			};
+			this.#waiting.push(queued);
+			signal?.addEventListener("abort", onAbort, { once: true });
+			if (signal?.aborted) onAbort();
+			else this.#scheduler.changed();
+		});
+	}
+	/** Запускает первую задачу; вызывается только планировщиком направления. */
+	dispatch(now, complete) {
+		const task = this.#waiting.shift();
+		if (!task) {
+			complete();
+			return;
+		}
+		this.#active += 1;
+		if (this.#smooth) this.#spend();
+		if (this.#minGap > 0) this.#nextSlot = Math.max(this.#nextSlot, now + this.#minGap);
+		task.start(() => {
+			this.#active -= 1;
+			complete();
+		});
 	}
 	/**
 	* Учитывает заголовки ответа.
@@ -1046,7 +976,7 @@ var BucketQueue = class {
 		if (this.#pacing === RateLimitPacing.Off || remaining === void 0) return 0;
 		if (this.#flatPause !== void 0) {
 			if (remaining > 0) return 0;
-			this.#gate.pause(this.#flatPause);
+			this.#hold(this.#flatPause);
 			return this.#flatPause;
 		}
 		const capacity = this.#capacity();
@@ -1054,11 +984,13 @@ var BucketQueue = class {
 			if (capacity === void 0) return 0;
 			this.#refill(capacity);
 			if (remaining < this.#tokens) this.#tokens = remaining;
-			return this.#armPause(capacity);
+			const wait = this.#armPause(capacity);
+			this.#scheduler.timingChanged();
+			return wait;
 		}
 		if (remaining > 0) return 0;
 		const wait = capacity === void 0 ? UNKNOWN_CAPACITY_PAUSE : Math.ceil(RATE_LIMIT_WINDOW / Math.max(capacity, 1));
-		this.#gate.pause(wait);
+		this.#hold(wait);
 		return wait;
 	}
 	/** Придерживает бакет на названное время — путь ответа `429`. Оценка остатка обнуляется. */
@@ -1067,7 +999,7 @@ var BucketQueue = class {
 			this.#tokens = 0;
 			this.#tokensAt = this.#clock.now();
 		}
-		this.#gate.pause(ms);
+		this.#hold(ms);
 	}
 	/** Снимок для `rateLimitState()`. */
 	state() {
@@ -1076,17 +1008,19 @@ var BucketQueue = class {
 			bucket: this.#bucket,
 			limit: this.#limit,
 			remaining: this.#remaining,
-			active: this.#gate.active,
-			pending: this.#gate.pending
+			active: this.#active,
+			pending: this.#waiting.length
 		};
 	}
-	/**
-	* Останавливает уровень бакета. Общая очередь направления гасится пулом.
-	*
-	*/
+	/** Отклоняет ещё не начатые задачи этого бакета. */
 	stop() {
-		this.#generation += 1;
-		this.#gate.stop();
+		this.cancelWaiting(queueStoppedError());
+	}
+	/** Отклоняет ожидающие задачи; используется также при остановке всего направления. */
+	cancelWaiting(reason, notify = true) {
+		const pending = this.#waiting.splice(0, this.#waiting.length);
+		for (const task of pending) task.cancel(reason);
+		if (notify) this.#scheduler.timingChanged();
 	}
 	/** Лимит бакета: сказанный сервером, иначе табличный. */
 	#capacity() {
@@ -1113,9 +1047,15 @@ var BucketQueue = class {
 	#armPause(capacity) {
 		if (this.#tokens >= 1) return 0;
 		const wait = Math.ceil((1 - this.#tokens) * RATE_LIMIT_WINDOW / capacity);
-		this.#gate.pause(wait);
+		this.#nextSlot = Math.max(this.#nextSlot, this.#clock.now() + wait);
 		return wait;
 	}
+	/** Отодвигает ближайший допустимый старт и перепланирует общее пробуждение. */
+	#hold(ms) {
+		if (ms <= 0) return;
+		this.#nextSlot = Math.max(this.#nextSlot, this.#clock.now() + ms);
+		this.#scheduler.timingChanged();
+	}
 };
 /** Лимит бакета до первого ответа: поправка пользователя важнее табличного значения. */
 function seedLimit(bucket, options) {
@@ -1137,10 +1077,43 @@ var RequestQueuePool = class {
 	#clock;
 	/** Ключ `undefined` — основная очередь внутренних клиентов без известного направления. */
 	#destinations = /* @__PURE__ */ new Map();
+	/** Динамические определения feature вместе с числом использующих их клиентов. */
+	#featureBuckets = /* @__PURE__ */ new Map();
 	constructor(options, clock = systemClock) {
 		this.#options = options;
 		this.#clock = clock;
 	}
+	/**
+	* Регистрирует бакет подключаемого feature.
+	*
+	* Повтор той же декларации разрешён клиентам, разделяющим один pool через `ItdAccounts`.
+	* Возвращённая функция откатывает регистрацию, пока очередь бакета ещё не создана.
+	*/
+	defineBucket(name, definition) {
+		const normalized = Object.freeze({
+			...definition.limit === void 0 ? {} : { limit: definition.limit },
+			...definition.concurrency === void 0 ? {} : { concurrency: definition.concurrency },
+			...definition.rps === void 0 ? {} : { rps: definition.rps }
+		});
+		const existing = this.#featureBuckets.get(name);
+		if (existing) {
+			if (existing.definition.limit !== normalized.limit || existing.definition.concurrency !== normalized.concurrency || existing.definition.rps !== normalized.rps) throw new require_errors.ItdConfigError(`Бакет feature «${name}» уже зарегистрирован с другими ограничениями`);
+			existing.references += 1;
+		} else this.#featureBuckets.set(name, {
+			definition: normalized,
+			references: 1
+		});
+		let released = false;
+		return () => {
+			if (released) return;
+			released = true;
+			const current = this.#featureBuckets.get(name);
+			if (!current) return;
+			current.references -= 1;
+			if (current.references > 0) return;
+			if (![...this.#destinations.values()].some((entry) => entry.buckets.has(name))) this.#featureBuckets.delete(name);
+		};
+	}
 	/** Очередь бакета на направлении. При `buckets: false` бакет всегда `default`. */
 	for(destination, bucket) {
 		const fallback = this.#options.defaultBucket;
@@ -1148,14 +1121,14 @@ var RequestQueuePool = class {
 		let entry = this.#destinations.get(destination);
 		if (!entry) {
 			entry = {
-				shared: new RequestQueue(this.#options, this.#clock),
+				scheduler: new DestinationScheduler(this.#options, this.#clock),
 				buckets: /* @__PURE__ */ new Map()
 			};
 			this.#destinations.set(destination, entry);
 		}
 		let queue = entry.buckets.get(name);
 		if (!queue) {
-			queue = new BucketQueue(destination, name, entry.shared, this.#options, this.#clock);
+			queue = new BucketQueue(destination, name, entry.scheduler, this.#options, this.#clock, this.#featureBuckets.get(name)?.definition);
 			entry.buckets.set(name, queue);
 		}
 		return queue;
@@ -1167,19 +1140,17 @@ var RequestQueuePool = class {
 		return states;
 	}
 	/**
-	* Останавливает оба уровня всех очередей: ожидающие задачи отклоняются, а состояние
-	* счётчиков и отложенные паузы сохраняются до следующего запуска — путь `close()`.
+	* Останавливает планировщики: ожидающие задачи отклоняются, а состояние счётчиков
+	* и отложенные паузы сохраняются до следующего запуска — путь `close()`.
 	*/
 	stop() {
-		for (const entry of this.#destinations.values()) {
-			for (const queue of entry.buckets.values()) queue.stop();
-			entry.shared.stop();
-		}
+		for (const entry of this.#destinations.values()) entry.scheduler.stop();
 	}
 	/** Останавливает очереди и забывает всё, что известно о счётчиках, — путь `dispose()`. */
 	clear() {
 		this.stop();
 		this.#destinations.clear();
+		this.#featureBuckets.clear();
 	}
 };
 //#endregion
@@ -1213,7 +1184,7 @@ var ServiceRegistry = class {
 	#primaryHost;
 	/** @param primaryBaseUrl базовый URL клиента */
 	constructor(primaryBaseUrl) {
-		this.#primaryHost = primaryBaseUrl ? require_cookies.hostOf(primaryBaseUrl) : "";
+		this.#primaryHost = primaryBaseUrl ? require_redact.hostOf(primaryBaseUrl) : "";
 	}
 	/**
 	* Регистрирует сервис. Имя очищается от краевых пробелов, базовый URL приводится
@@ -1226,7 +1197,7 @@ var ServiceRegistry = class {
 		if (typeof raw !== "string" || raw.trim() === "") throw new require_errors.ItdConfigError("У сервиса должно быть непустое имя");
 		const name = raw.trim();
 		if (this.#services.has(name)) throw new require_errors.ItdConfigError(`Сервис «${name}» уже зарегистрирован и не может быть заменён`);
-		const baseUrl = require_cookies.normalizeBaseUrl(definition.baseUrl);
+		const baseUrl = require_redact.normalizeBaseUrl(definition.baseUrl);
 		if (definition.auth !== void 0 && typeof definition.auth !== "boolean") throw new require_errors.ItdConfigError(`services.${name}.auth должен быть boolean`);
 		let headers;
 		if (definition.headers !== void 0) {
@@ -1238,7 +1209,7 @@ var ServiceRegistry = class {
 			...definition,
 			name,
 			baseUrl,
-			auth: definition.auth ?? require_cookies.isSameSite(this.#primaryHost, require_cookies.hostOf(baseUrl)),
+			auth: definition.auth ?? require_redact.isSameSite(this.#primaryHost, require_redact.hostOf(baseUrl)),
 			...headers ? { headers } : {}
 		};
 		this.#services.set(name, Object.freeze(normalized));
@@ -1251,6 +1222,28 @@ var ServiceRegistry = class {
 	has(name) {
 		return this.#services.has(name);
 	}
+	/** Удаляет сервис при откате атомарной установки feature. @internal */
+	delete(name) {
+		return this.#services.delete(name);
+	}
+	/**
+	* Атомарно заменяет существующее определение и возвращает прежнее.
+	* Используется feature, накладывающим default на сервис из опций клиента.
+	*
+	* @internal
+	*/
+	replace(definition) {
+		const name = definition.name.trim();
+		const previous = this.require(name);
+		this.#services.delete(name);
+		try {
+			this.define(definition);
+		} catch (error) {
+			this.#services.set(name, previous);
+			throw error;
+		}
+		return previous;
+	}
 	/**
 	* Определение сервиса.
 	*
@@ -1281,7 +1274,7 @@ var ServiceRegistry = class {
 	* @internal
 	*/
 	isPrimarySite(baseUrl) {
-		return require_cookies.isSameSite(this.#primaryHost, require_cookies.hostOf(baseUrl));
+		return require_redact.isSameSite(this.#primaryHost, require_redact.hostOf(baseUrl));
 	}
 };
 //#endregion
@@ -1343,14 +1336,14 @@ function markDisposeCleanupRequest(request) {
 		[DISPOSE_CLEANUP_REQUEST]: true
 	};
 }
-/** Разрешено ли запросу завершать внутреннюю очистку после перехода клиента в terminal state. @internal */
+/** Разрешено ли запросу завершать внутреннюю очистку после `dispose()`. @internal */
 function isDisposeCleanupRequest(request) {
 	return request[DISPOSE_CLEANUP_REQUEST] === true;
 }
 /**
 * Собирает слои в один обработчик.
 *
-* Первый слой оказывается самым внешним. Порядок задаётся внутренним client runtime.
+* Первый слой становится внешним.
 *
 * @example
 * ```ts
@@ -1378,24 +1371,17 @@ function withLayerHeaders(request, headers) {
 /**
 * Точка входа ресурсов в конвейер запросов.
 *
-* Принимает готовый обработчик — цепочку слоёв поверх транспорта, собранную
-* во внутреннем runtime клиента, — и отдаёт ресурсам методы `request`/`operation`.
+* Принимает готовую цепочку обработки и предоставляет ресурсам методы `request`/`execute`.
 * О слоях и их порядке ресурсы не знают.
 */
 var HttpClient = class {
 	#handler;
+	#plugins;
 	#baseUrl;
-	#catalog;
 	constructor(deps) {
 		this.#handler = deps.handler;
+		this.#plugins = deps.plugins;
 		this.#baseUrl = deps.baseUrl;
-		this.#catalog = deps.catalog;
-	}
-	/** Метод операции из каталога. Отсутствие описания — ошибка сборки клиента, не запроса. */
-	#methodOf(operationId) {
-		const method = this.#catalog.methodOf(operationId);
-		if (method === void 0) throw new require_errors.ItdConfigError(`каталог операций не знает «${operationId}»`);
-		return method;
 	}
 	/** Базовый URL, к которому обращается клиент. */
 	get baseUrl() {
@@ -1411,23 +1397,34 @@ var HttpClient = class {
 	* @throws {ItdNetworkError} если запрос не дошёл до сервера
 	*/
 	request(options) {
-		return this.#handler(identifyRequest(options));
+		const request = identifyRequest(options);
+		return this.#plugins.run(request, (prepared) => this.#handler(prepared));
 	}
-	/** Выполняет встроенную семантическую операцию, подставляя её HTTP-метод из каталога. */
-	operation(operationId, options) {
-		return this.request({
+	/** Выполняет контракт операции; `next()` плагина возвращает результат после `read`. */
+	execute(operation, options) {
+		return this.#run(operation, options);
+	}
+	#run(operation, options) {
+		const request = identifyRequest({
 			...options,
-			operationId,
-			method: this.#methodOf(operationId)
+			operationId: operation.id,
+			method: operation.method,
+			retrySafety: options.retrySafety ?? operation.retrySafety
 		});
+		return this.#plugins.run(request, async (prepared) => operation.read(await this.#handler(prepared), prepared));
 	}
 	/** Выполняет внутреннюю операцию финализации после начала `ItdClient.dispose()`. @internal */
-	cleanupOperation(operationId, options) {
-		return this.request(markDisposeCleanupRequest({
+	cleanupOperation(operation, options) {
+		const request = identifyRequest({
 			...options,
-			operationId,
-			method: this.#methodOf(operationId)
-		}));
+			operationId: operation.id,
+			method: operation.method,
+			retrySafety: options.retrySafety ?? operation.retrySafety
+		});
+		return this.#plugins.run(request, async (prepared) => {
+			const cleanupRequest = markDisposeCleanupRequest(prepared);
+			return operation.read(await this.#handler(cleanupRequest), prepared);
+		});
 	}
 };
 //#endregion
@@ -1452,6 +1449,50 @@ const RetrySafety = Object.freeze({
 	/** Повтор может создать ещё один побочный эффект. */
 	Unsafe: "unsafe"
 });
+function snapshotAnnotation(value, operationId, copies) {
+	if (value === null || typeof value !== "object" && typeof value !== "function") return value;
+	if (typeof value === "function") throw new require_errors.ItdConfigError(`annotations операции «${operationId}» не должны содержать функции`);
+	const existing = copies.get(value);
+	if (existing !== void 0) return existing;
+	if (Array.isArray(value)) {
+		const copy = [];
+		copies.set(value, copy);
+		for (const item of value) copy.push(snapshotAnnotation(item, operationId, copies));
+		return Object.freeze(copy);
+	}
+	const prototype = Object.getPrototypeOf(value);
+	if (prototype !== Object.prototype && prototype !== null) throw new require_errors.ItdConfigError(`annotations операции «${operationId}» должны состоять из обычных объектов, массивов и примитивов`);
+	const copy = Object.create(prototype);
+	copies.set(value, copy);
+	for (const key of Reflect.ownKeys(value)) {
+		const descriptor = Object.getOwnPropertyDescriptor(value, key);
+		if (!descriptor?.enumerable) continue;
+		if (!("value" in descriptor)) throw new require_errors.ItdConfigError(`annotations операции «${operationId}» не должны содержать getters или setters`);
+		Object.defineProperty(copy, key, {
+			value: snapshotAnnotation(descriptor.value, operationId, copies),
+			enumerable: true,
+			writable: true,
+			configurable: true
+		});
+	}
+	return Object.freeze(copy);
+}
+/** Создаёт неизменяемый контракт результата. @internal */
+function defineOperation(id, metadata, read) {
+	const annotations = metadata.annotations === void 0 ? void 0 : snapshotAnnotation(metadata.annotations, id, /* @__PURE__ */ new Map());
+	return Object.freeze({
+		id,
+		...metadata,
+		...annotations === void 0 ? {} : { annotations },
+		read
+	});
+}
+/** Возвращает разобранное тело без дополнительного преобразования. @internal */
+function identityResult(body) {
+	return body;
+}
+/** Отбрасывает служебное тело операции без результата. @internal */
+function voidResult() {}
 //#endregion
 //#region src/core/scheduling/retry.ts
 /** Методы raw-запроса, безопасность которых гарантирована самим HTTP-контрактом. */
@@ -1561,9 +1602,6 @@ function createQueueMiddleware(schedule) {
 * разу, иначе, например, текст поста зашифруется дважды. Здесь же к операции привязывается
 * snapshot attempt interceptors; сами они выполняются транспортом на каждой попытке.
 */
-function createPluginsMiddleware(plugins) {
-	return (request, next) => plugins.run(request, next);
-}
 /**
 * Слой сервисов.
 *
@@ -1577,7 +1615,7 @@ function createServicesMiddleware(registry) {
 		const service = request.service === void 0 ? void 0 : registry.require(request.service);
 		let prepared = request;
 		if (request.baseUrl !== void 0) {
-			const baseUrl = require_cookies.normalizeBaseUrl(request.baseUrl);
+			const baseUrl = require_redact.normalizeBaseUrl(request.baseUrl);
 			if (baseUrl !== request.baseUrl) prepared = {
 				...prepared,
 				baseUrl
@@ -1721,90 +1759,6 @@ function createRetryMiddleware(deps) {
 	};
 }
 //#endregion
-//#region src/core/redact.ts
-/** Заголовки, значение которых нельзя писать в лог целиком. */
-const SECRET_HEADERS = /* @__PURE__ */ new Set([
-	"authorization",
-	"cookie",
-	"set-cookie",
-	"x-api-key"
-]);
-/** Поля тела запроса, значение которых нельзя писать в лог. */
-const SECRET_FIELDS = /* @__PURE__ */ new Set([
-	"password",
-	"oldpassword",
-	"newpassword",
-	"accesstoken",
-	"refreshtoken",
-	"currentpassword",
-	"flowtoken",
-	"token",
-	"turnstiletoken",
-	"otp"
-]);
-/** Query-параметры, содержащие секреты. */
-const SECRET_QUERY_PARAMS = /* @__PURE__ */ new Set(["token", "access_token"]);
-/**
-* Прячет середину секрета, оставляя концы для сопоставления.
-*
-* @example
-* ```ts
-* maskSecret('eyJhbGciOiJIUzI1NiJ9.abc'); // 'eyJh…(24)…abc'
-* ```
-*/
-function maskSecret(value) {
-	if (value.length <= 8) return "…";
-	return `${value.slice(0, 4)}…(${value.length})…${value.slice(-3)}`;
-}
-/** Маскирует секретные query-параметры URL перед записью в логи и ошибки. */
-function redactUrl(url) {
-	try {
-		const parsed = new URL(url);
-		const entries = [...parsed.searchParams.entries()];
-		parsed.search = "";
-		for (const [name, value] of entries) parsed.searchParams.append(name, SECRET_QUERY_PARAMS.has(name.toLowerCase()) ? maskSecret(value) : value);
-		return parsed.toString();
-	} catch {
-		return url.replace(/([?&](?:token|access_token)=)[^&#]*/gi, "$1[скрыто]");
-	}
-}
-/**
-* Готовит заголовки к записи в лог.
-*
-* `Authorization` и `Cookie` маскируются: логи часто уезжают в системы сбора,
-* и токен доступа в них попадать не должен.
-*/
-function redactHeaders(headers) {
-	const result = {};
-	headers.forEach((value, name) => {
-		if (SECRET_HEADERS.has(name.toLowerCase())) {
-			const spaceAt = value.indexOf(" ");
-			result[name] = spaceAt > 0 ? `${value.slice(0, spaceAt)} ${maskSecret(value.slice(spaceAt + 1))}` : maskSecret(value);
-			return;
-		}
-		result[name] = value;
-	});
-	return result;
-}
-/**
-* Готовит тело запроса к записи в лог: пароли, токены и коды OTP заменяются заглушкой.
-*
-* Обходит вложенные объекты и массивы. `FormData` и бинарные тела не раскрываются вовсе.
-*/
-function redactBody(body) {
-	if (body === null || body === void 0) return body;
-	if (typeof FormData !== "undefined" && body instanceof FormData) return "[FormData]";
-	if (isBlob(body)) return "[Blob]";
-	if (body instanceof ArrayBuffer || ArrayBuffer.isView(body)) return "[binary]";
-	if (Array.isArray(body)) return body.map(redactBody);
-	if (typeof body === "object") {
-		const result = {};
-		for (const [key, value] of Object.entries(body)) result[key] = SECRET_FIELDS.has(key.toLowerCase()) ? "[скрыто]" : redactBody(value);
-		return result;
-	}
-	return body;
-}
-//#endregion
 //#region src/core/unwrap.ts
 /**
 * Снимает внешнюю обёртку `{ data: … }`.
@@ -2053,7 +2007,7 @@ function safeRawBody(body) {
 	if (!isRecord(body) || body.type !== "validation" || !isRecord(body.found)) return body;
 	return {
 		...body,
-		found: redactBody(body.found)
+		found: require_redact.redactBody(body.found)
 	};
 }
 /**
@@ -2100,7 +2054,7 @@ function setHeader(headers, name, value) {
 /** Тело, которое отправляется как есть, без сериализации в JSON. */
 function isRawBody(body) {
 	if (typeof body !== "object" || body === null) return typeof body === "string";
-	return typeof FormData !== "undefined" && body instanceof FormData || isBlob(body) || typeof URLSearchParams !== "undefined" && body instanceof URLSearchParams || typeof ReadableStream !== "undefined" && body instanceof ReadableStream || body instanceof ArrayBuffer || ArrayBuffer.isView(body);
+	return typeof FormData !== "undefined" && body instanceof FormData || require_redact.isBlob(body) || typeof URLSearchParams !== "undefined" && body instanceof URLSearchParams || typeof ReadableStream !== "undefined" && body instanceof ReadableStream || body instanceof ArrayBuffer || ArrayBuffer.isView(body);
 }
 /**
 * Читает тело ответа один раз.
@@ -2246,8 +2200,8 @@ var Transport = class {
 			};
 			await dispatchRequestHook(this.#config.hooks, "onRequest", context);
 			this.#config.logger?.debug(`→ ${method} ${request.path}`, {
-				headers: redactHeaders(headers),
-				body: request.bodyFactory ? "[повторяемое тело]" : redactBody(request.body)
+				headers: require_redact.redactHeaders(headers),
+				body: request.bodyFactory ? "[повторяемое тело]" : require_redact.redactBody(request.body)
 			});
 			let response;
 			try {
@@ -2389,7 +2343,7 @@ var Transport = class {
 	*/
 	buildUrl(request) {
 		const base = request.baseUrl ?? this.#config.baseUrl;
-		return require_cookies.joinUrl(base, request.path) + require_cookies.buildQuery(request.query);
+		return require_redact.joinUrl(base, request.path) + require_redact.buildQuery(request.query);
 	}
 	/**
 	* Собирает общие заголовки клиента: `User-Agent`, идентификатор устройства,
@@ -2440,7 +2394,7 @@ var Transport = class {
 };
 //#endregion
 //#region src/core/execution/client-runtime.ts
-/** Имена стадий основного request pipeline в порядке выполнения. @internal */
+/** Имена стадий обработки запроса в порядке выполнения. @internal */
 const ClientRuntimeStage = Object.freeze({
 	OperationPlugins: "operation_plugins",
 	Services: "services",
@@ -2452,26 +2406,21 @@ const ClientRuntimeStage = Object.freeze({
 	AuthHeaders: "auth_headers",
 	Transport: "transport"
 });
-/** Регистрирует встроенные сервисы и накладывает пользовательские overrides. */
+/** Регистрирует сервисы, заранее объявленные в опциях клиента. */
 function createServiceRegistry(config) {
 	const services = new ServiceRegistry(config.baseUrl);
-	const overrides = new Map(config.services.map((service) => [service.name.trim(), service]));
-	for (const builtIn of BUILT_IN_SERVICES) {
-		const override = overrides.get(builtIn.name);
-		overrides.delete(builtIn.name);
-		services.define(override ? mergeService(builtIn, override) : builtIn);
-	}
-	for (const service of overrides.values()) services.define(service);
+	for (const service of config.services) services.define(service);
 	return services;
 }
-/** Собирает внутренний runtime клиента и единственный request pipeline. @internal */
+/** Собирает внутренние компоненты и цепочку запросов клиента. @internal */
 function createClientRuntime(options, internals) {
 	const catalog = internals.catalog;
 	const config = resolveRuntimeConfig(options, catalog);
-	const jar = new require_cookies.CookieJar();
+	const jar = new require_redact.CookieJar();
 	const plugins = new PluginRegistry({
 		shutdownTimeout: config.shutdownTimeout,
-		clock: config.clock
+		clock: config.clock,
+		operationMetadata: (operationId) => catalog.definitionOf(operationId)
 	});
 	const services = createServiceRegistry(config);
 	const lifetime = new AbortController();
@@ -2495,7 +2444,7 @@ function createClientRuntime(options, internals) {
 		}) ?? catalog.bucketOf(request.operationId);
 	};
 	const queueKeyFor = (request) => requestQueueKey(request, (target) => ({
-		destination: require_cookies.originOf(transport.buildUrl(target)) || void 0,
+		destination: require_redact.originOf(transport.buildUrl(target)) || void 0,
 		bucket: bucketFor(target)
 	}));
 	const queueFor = (request) => {
@@ -2520,10 +2469,6 @@ function createClientRuntime(options, internals) {
 		lifetimeSignal: lifetime.signal
 	});
 	const stages = [
-		{
-			name: ClientRuntimeStage.OperationPlugins,
-			middleware: createPluginsMiddleware(plugins)
-		},
 		{
 			name: ClientRuntimeStage.Services,
 			middleware: createServicesMiddleware(services)
@@ -2575,17 +2520,21 @@ function createClientRuntime(options, internals) {
 		}
 		return handler(request);
 	};
+	const http = new HttpClient({
+		handler: clientHandler,
+		plugins,
+		baseUrl: config.baseUrl
+	});
 	auth = internals.auth({
 		config,
-		handler: clientHandler,
+		http,
 		cookies: jar
 	});
-	const http = new HttpClient({
-		handler: clientHandler,
-		baseUrl: config.baseUrl,
-		catalog
-	});
-	const stageOrder = Object.freeze([...stages.map(({ name }) => name), ClientRuntimeStage.Transport]);
+	const stageOrder = Object.freeze([
+		ClientRuntimeStage.OperationPlugins,
+		...stages.map(({ name }) => name),
+		ClientRuntimeStage.Transport
+	]);
 	return {
 		config,
 		http,
@@ -2594,8 +2543,27 @@ function createClientRuntime(options, internals) {
 		plugins,
 		services,
 		stageOrder,
+		connection: (serviceName) => {
+			const service = serviceName === void 0 ? void 0 : services.require(serviceName);
+			const baseUrl = service?.baseUrl ?? config.baseUrl;
+			return Object.freeze({
+				baseUrl,
+				authorize: service?.auth ?? true,
+				fetch: config.fetch,
+				clock: config.clock,
+				logger: config.logger,
+				baseHeaders: async (url) => {
+					const headers = await transport.platformHeaders(url);
+					for (const [name, value] of Object.entries(service?.headers ?? {})) headers.set(name, value);
+					return headers;
+				},
+				getToken: () => auth.token(),
+				refreshAuth: () => auth.recover()
+			});
+		},
 		platformHeaders: (url) => transport.platformHeaders(url),
 		rateLimitState: () => queues?.states() ?? [],
+		registerRateLimitBucket: (name, definition) => queues?.defineBucket(name, definition),
 		close: () => {
 			if (ownsQueues) queues?.stop();
 		},
@@ -2995,12 +2963,12 @@ const OPERATIONS = freezeOperations({
 		method: "PUT",
 		retrySafety: RetrySafety.Idempotent
 	},
-	"realtime.poll.updates": {
+	"events.notifications.poll.updates": {
 		method: "GET",
 		retrySafety: RetrySafety.Safe,
 		bucket: "notifications"
 	},
-	"realtime.poll.unread": {
+	"events.notifications.poll.unread": {
 		method: "GET",
 		retrySafety: RetrySafety.Safe,
 		bucket: "notifications"
@@ -3084,10 +3052,6 @@ const OPERATIONS = freezeOperations({
 		method: "GET",
 		retrySafety: RetrySafety.Safe
 	},
-	"platform.status": {
-		method: "GET",
-		retrySafety: RetrySafety.Safe
-	},
 	"telemetry.dwell": {
 		method: "POST",
 		retrySafety: RetrySafety.Unsafe
@@ -3097,6 +3061,10 @@ const OPERATIONS = freezeOperations({
 		retrySafety: RetrySafety.Unsafe
 	}
 });
+/** Создаёт контракт результата встроенной операции с проверяемым ID. */
+function defineBuiltInOperation(id, read = identityResult) {
+	return defineOperation(id, OPERATIONS[id], read);
+}
 const BUILT_IN_IDS = new Set(Object.keys(OPERATIONS));
 /** Проверяет принадлежность ID встроенному каталогу. */
 function isBuiltInOperationId(value) {
@@ -3131,6 +3099,7 @@ function operationBucket(id) {
 * @internal
 */
 const ITD_CATALOG = Object.freeze({
+	definitionOf: (id) => isBuiltInOperationId(id) ? OPERATIONS[id] : void 0,
 	retrySafetyOf: (id) => isBuiltInOperationId(id) ? operationRetrySafety(id) : void 0,
 	methodOf: (id) => isBuiltInOperationId(id) ? operationMethod(id) : void 0,
 	bucketOf: (id) => operationBucket(id),
@@ -3217,8 +3186,8 @@ const ReportReason = Object.freeze({
 	Fraud: "fraud",
 	Other: "other"
 });
-/** Состояние realtime-соединения. */
-const RealtimeStatus = Object.freeze({
+/** Состояние соединения событийного канала. */
+const EventChannelStatus = Object.freeze({
 	Connecting: "connecting",
 	Connected: "connected",
 	Error: "error",
@@ -3537,6 +3506,103 @@ function readUnreadCountEvent(data) {
 	return typeof payload.count === "number" ? payload.count : void 0;
 }
 //#endregion
+//#region src/operations/common.ts
+/** Контракт встроенной операции без дополнительного преобразования результата. */
+function passthroughOperation(id) {
+	return defineBuiltInOperation(id);
+}
+/** Контракт встроенной операции без возвращаемого значения. */
+function voidOperation(id) {
+	return defineBuiltInOperation(id, voidResult);
+}
+//#endregion
+//#region src/core/auth-provider.ts
+/**
+* Идентификатор устройства, общий для провайдеров без сессии.
+*
+* Значение своё у каждого провайдера: сервер различает по нему записи в списке сессий,
+* поэтому делить его между клиентами нельзя. Хранилища нет, так что перезапуск процесса
+* значение не переживает — в этом и разница с полноценной сессией.
+*/
+function localDeviceId() {
+	let deviceId;
+	return () => {
+		deviceId ??= require_redact.createDeviceId();
+		return Promise.resolve(deviceId);
+	};
+}
+/**
+* Авторизации нет: заголовок не подставляется, ответ `401` не восстанавливается.
+*
+* @example
+* ```ts
+* const api = createRestClient(); // публичные эндпоинты доступны и без токена
+* ```
+*/
+function anonymousAuth() {
+	return {
+		token: () => Promise.resolve(null),
+		prepare: () => Promise.resolve(),
+		currentHeaders: () => ({}),
+		recover: () => Promise.resolve(false),
+		deviceId: localDeviceId(),
+		dispose: () => {}
+	};
+}
+/**
+* Готовый Bearer-токен: ни хранилища, ни продления.
+*
+* Ответ `401` уходит вызывающему коду как есть — обновить токен провайдеру нечем.
+* Для сессии, которая продлевает себя сама, нужен полный клиент.
+*
+* @example
+* ```ts
+* const api = createRestClient({ auth: bearerToken(process.env.ITD_TOKEN) });
+* ```
+*/
+function bearerToken(accessToken) {
+	const headers = { Authorization: `Bearer ${accessToken}` };
+	return {
+		token: () => Promise.resolve(accessToken),
+		prepare: () => Promise.resolve(),
+		currentHeaders: () => headers,
+		recover: () => Promise.resolve(false),
+		deviceId: localDeviceId(),
+		dispose: () => {}
+	};
+}
+/**
+* Токен из внешнего источника — хранилища секретов, кэша, соседнего сервиса.
+*
+* Источник спрашивается на стадии подготовки, до входа в очередь: там ожидание безопасно,
+* а слот транспорта ещё не занят. Значение держится до следующей подготовки, потому что
+* подстановка заголовков обязана быть синхронной.
+*
+* @example
+* ```ts
+* const api = createRestClient({ auth: tokenProvider(() => vault.read('itd')) });
+* ```
+*/
+function tokenProvider(getToken) {
+	let cached = null;
+	const read = async () => {
+		cached = await getToken();
+		return cached;
+	};
+	return {
+		token: read,
+		prepare: async () => {
+			await read();
+		},
+		currentHeaders: () => cached ? { Authorization: `Bearer ${cached}` } : {},
+		recover: () => Promise.resolve(false),
+		deviceId: localDeviceId(),
+		dispose: () => {
+			cached = null;
+		}
+	};
+}
+//#endregion
 //#region src/notifications/text.ts
 /** Имя, которое подставляется, если участник неизвестен. */
 const UNKNOWN_ACTOR = "Пользователь";
@@ -3704,6 +3770,18 @@ Object.defineProperty(exports, "DEFAULT_RATE_LIMIT_BUCKET", {
 		return DEFAULT_RATE_LIMIT_BUCKET;
 	}
 });
+Object.defineProperty(exports, "DEFAULT_STATUS_BASE_URL", {
+	enumerable: true,
+	get: function() {
+		return DEFAULT_STATUS_BASE_URL;
+	}
+});
+Object.defineProperty(exports, "EventChannelStatus", {
+	enumerable: true,
+	get: function() {
+		return EventChannelStatus;
+	}
+});
 Object.defineProperty(exports, "FeedTab", {
 	enumerable: true,
 	get: function() {
@@ -3764,12 +3842,6 @@ Object.defineProperty(exports, "RateLimitPacing", {
 		return RateLimitPacing;
 	}
 });
-Object.defineProperty(exports, "RealtimeStatus", {
-	enumerable: true,
-	get: function() {
-		return RealtimeStatus;
-	}
-});
 Object.defineProperty(exports, "ReportReason", {
 	enumerable: true,
 	get: function() {
@@ -3794,12 +3866,6 @@ Object.defineProperty(exports, "RetrySafety", {
 		return RetrySafety;
 	}
 });
-Object.defineProperty(exports, "RuntimeMode", {
-	enumerable: true,
-	get: function() {
-		return RuntimeMode;
-	}
-});
 Object.defineProperty(exports, "STATUS_SERVICE", {
 	enumerable: true,
 	get: function() {
@@ -3836,12 +3902,24 @@ Object.defineProperty(exports, "WallAccess", {
 		return WallAccess;
 	}
 });
+Object.defineProperty(exports, "anonymousAuth", {
+	enumerable: true,
+	get: function() {
+		return anonymousAuth;
+	}
+});
 Object.defineProperty(exports, "assertPluginRemovable", {
 	enumerable: true,
 	get: function() {
 		return assertPluginRemovable;
 	}
 });
+Object.defineProperty(exports, "bearerToken", {
+	enumerable: true,
+	get: function() {
+		return bearerToken;
+	}
+});
 Object.defineProperty(exports, "canonicalNotificationType", {
 	enumerable: true,
 	get: function() {
@@ -3860,40 +3938,40 @@ Object.defineProperty(exports, "createDeadline", {
 		return createDeadline;
 	}
 });
-Object.defineProperty(exports, "createDeviceId", {
+Object.defineProperty(exports, "defineBuiltInOperation", {
 	enumerable: true,
 	get: function() {
-		return createDeviceId;
+		return defineBuiltInOperation;
 	}
 });
-Object.defineProperty(exports, "formatNotificationText", {
+Object.defineProperty(exports, "defineOperation", {
 	enumerable: true,
 	get: function() {
-		return formatNotificationText;
+		return defineOperation;
 	}
 });
-Object.defineProperty(exports, "installAsyncDisposeFallback", {
+Object.defineProperty(exports, "formatNotificationText", {
 	enumerable: true,
 	get: function() {
-		return installAsyncDisposeFallback;
+		return formatNotificationText;
 	}
 });
-Object.defineProperty(exports, "isBlob", {
+Object.defineProperty(exports, "identityResult", {
 	enumerable: true,
 	get: function() {
-		return isBlob;
+		return identityResult;
 	}
 });
-Object.defineProperty(exports, "isBuiltInOperationId", {
+Object.defineProperty(exports, "installAsyncDisposeFallback", {
 	enumerable: true,
 	get: function() {
-		return isBuiltInOperationId;
+		return installAsyncDisposeFallback;
 	}
 });
-Object.defineProperty(exports, "isFile", {
+Object.defineProperty(exports, "isBuiltInOperationId", {
 	enumerable: true,
 	get: function() {
-		return isFile;
+		return isBuiltInOperationId;
 	}
 });
 Object.defineProperty(exports, "isKnownNotificationType", {
@@ -3914,10 +3992,10 @@ Object.defineProperty(exports, "isRecord$1", {
 		return isRecord$1;
 	}
 });
-Object.defineProperty(exports, "maskSecret", {
+Object.defineProperty(exports, "mergeService", {
 	enumerable: true,
 	get: function() {
-		return maskSecret;
+		return mergeService;
 	}
 });
 Object.defineProperty(exports, "normalizeNotification", {
@@ -3950,6 +4028,12 @@ Object.defineProperty(exports, "orderPluginDefinitions", {
 		return orderPluginDefinitions;
 	}
 });
+Object.defineProperty(exports, "passthroughOperation", {
+	enumerable: true,
+	get: function() {
+		return passthroughOperation;
+	}
+});
 Object.defineProperty(exports, "pickArray", {
 	enumerable: true,
 	get: function() {
@@ -3992,12 +4076,6 @@ Object.defineProperty(exports, "readUnreadCountEvent", {
 		return readUnreadCountEvent;
 	}
 });
-Object.defineProperty(exports, "redactUrl", {
-	enumerable: true,
-	get: function() {
-		return redactUrl;
-	}
-});
 Object.defineProperty(exports, "requireOptionalBoolean", {
 	enumerable: true,
 	get: function() {
@@ -4016,17 +4094,23 @@ Object.defineProperty(exports, "resolveRateLimit", {
 		return resolveRateLimit;
 	}
 });
-Object.defineProperty(exports, "supportsStreamingBody", {
+Object.defineProperty(exports, "systemClock", {
 	enumerable: true,
 	get: function() {
-		return supportsStreamingBody;
+		return systemClock;
 	}
 });
-Object.defineProperty(exports, "systemClock", {
+Object.defineProperty(exports, "tokenProvider", {
 	enumerable: true,
 	get: function() {
-		return systemClock;
+		return tokenProvider;
+	}
+});
+Object.defineProperty(exports, "voidOperation", {
+	enumerable: true,
+	get: function() {
+		return voidOperation;
 	}
 });
 
-//# sourceMappingURL=url-yjl2c8Ie.cjs.map
+//# sourceMappingURL=url-CFN1sT9S.cjs.map