itd-api 0.7.1 → 0.8.0

package/dist/shared/{url-CYXgxqGx.js → url-B3ocFlHj.js}

@@ -1,5 +1,5 @@
-import { O as isItdRateLimitError, _ as ItdStateError, a as ItdConfigError, b as isItdApiError, d as ItdForbiddenError, f as ItdNetworkError, g as ItdServerError, h as ItdRateLimitError, i as ItdAuthError, l as ItdFileError, m as ItdPhoneVerificationError, n as ItdApiError, o as ItdConflictError, p as ItdNotFoundError, s as ItdError, t as ItdAbortError, v as ItdTimeoutError, y as ItdValidationError } from "./errors-Bhrd2fJd.js";
-import { a as buildQuery, c as isSameSite, d as originOf, l as joinUrl, n as CookieJar, s as hostOf, u as normalizeBaseUrl } from "./cookies-tX2sNwxb.js";
+import { O as isItdRateLimitError, _ as ItdStateError, a as ItdConfigError, b as isItdApiError, d as ItdForbiddenError, f as ItdNetworkError, g as ItdServerError, h as ItdRateLimitError, i as ItdAuthError, l as ItdFileError, m as ItdPhoneVerificationError, n as ItdApiError, o as ItdConflictError, p as ItdNotFoundError, s as ItdError, t as ItdAbortError, v as ItdTimeoutError, y as ItdValidationError } from "./errors-GI10kZxk.js";
+import { C as shouldUseCookieJar, S as shouldSendCredentials, _ as RuntimeMode, f as hostOf, g as originOf, h as normalizeBaseUrl, i as redactHeaders, m as joinUrl, n as redactBody, p as isSameSite, s as CookieJar, u as buildQuery, v as createDeviceId, x as resolveFetch, y as isBlob } from "./redact-FNK29Fv-.js";
 //#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 ItdConfigError("fetch должен быть функцией");
-		return custom;
-	}
-	if (typeof globalThis.fetch === "function") return globalThis.fetch.bind(globalThis);
-	throw new 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 ItdConfigError(`${name} должен быть целым числом от 1, получено: ${value}`);
 	return value;
 }
+function requireRps(value, name) {
+	if (!Number.isFinite(value) || value <= 0) throw new ItdConfigError(`${name} должен быть положительным числом, получено: ${value}`);
+	return value;
+}
 function resolvePacing(pacing) {
 	const known = Object.values(RateLimitPacing);
 	if (pacing !== void 0 && !known.includes(pacing)) throw new 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 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 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 ItdConfigError("rateLimit.retryDelays должен быть массивом чисел");
 	for (const delay of retryDelays) requirePositive(delay, "rateLimit.retryDelays");
@@ -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 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 ItdConfigError(`operation transformer не может заменить operationId «${operationId}» на «${prepared.operationId}»`);
+			if (prepared.method.toUpperCase() !== method) throw new ItdConfigError(`operation transformer не может заменить метод «${method}» операции «${operationId}» на «${prepared.method}»`);
+			if (prepared.retrySafety !== void 0 && prepared.retrySafety !== retrySafety) throw new 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 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 ItdStateError(`плагин «${entry.plugin.name}» не завершил операции за ${this.#options.shutdownTimeout} мс; ожидание прекращено, ресурсы плагина освобождены`);
+		const errors = [];
+		if (!await deadline.wait(this.#waitForDrain(entry))) errors.push(new 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 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 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 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
@@ -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;
+	}
 	/**
 	* Определение сервиса.
 	*
@@ -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 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));
+	}
+	/** Выполняет контракт операции; `next()` плагина возвращает результат после `read`. */
+	execute(operation, options) {
+		return this.#run(operation, options);
 	}
-	/** Выполняет встроенную семантическую операцию, подставляя её HTTP-метод из каталога. */
-	operation(operationId, options) {
-		return this.request({
+	#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 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 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 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);
-}
 /**
 * Слой сервисов.
 *
@@ -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: … }`.
@@ -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 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();
@@ -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 ??= 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 = "Пользователь";
@@ -3668,6 +3734,6 @@ function resolveNotificationUrl(notification) {
 	return clickUrl || "/notifications";
 }
 //#endregion
-export { RuntimeMode as $, operationRetrySafety as A, maskSecret as B, ViewSource as C, isBuiltInOperationId as D, OPERATIONS as E, pickArray as F, orderPluginDefinitions as G, RetrySafety as H, pickBoolean as I, resolveRateLimit as J, DEFAULT_BASE_URL as K, pickNumber as L, DEFAULT_RATE_LIMIT_BUCKET as M, createClientRuntime as N, operationBucket as O, isRecord as P, RateLimitPacing as Q, pickObject as R, ViewReason as S, ITD_CATALOG as T, RequestQueuePool as U, redactUrl as V, assertPluginRemovable as W, isRecord$1 as X, LIBRARY_VERSION as Y, requireOptionalBoolean as Z, RealtimeStatus as _, readUnreadCountEvent as a, systemClock as at, ServiceState as b, AccessType as c, FeedTab as d, createDeviceId as et, IncidentKind as f, NotificationType as g, LikesVisibility as h, readNotificationEvent as i, createDeadline as it, BUCKET_LIMITS as j, operationMethod as k, AttachmentType as l, ItdErrorCode as m, formatNotificationText as n, isFile as nt, canonicalNotificationType as o, installAsyncDisposeFallback as ot, InteractionType as p, STATUS_SERVICE as q, normalizeNotification as r, supportsStreamingBody as rt, isKnownNotificationType as s, resolveNotificationUrl as t, isBlob as tt, CommentSort as u, ReportReason as v, WallAccess as w, SpanType as x, ReportTargetType as y, pickString as z };
+export { DEFAULT_BASE_URL as $, ITD_CATALOG as A, isRecord as B, ReportReason as C, ViewReason as D, SpanType as E, operationMethod as F, pickString as G, pickBoolean as H, operationRetrySafety as I, identityResult as J, RetrySafety as K, BUCKET_LIMITS as L, defineBuiltInOperation as M, isBuiltInOperationId as N, ViewSource as O, operationBucket as P, orderPluginDefinitions as Q, DEFAULT_RATE_LIMIT_BUCKET as R, NotificationType as S, ServiceState as T, pickNumber as U, pickArray as V, pickObject as W, RequestQueuePool as X, mergeService as Y, assertPluginRemovable as Z, FeedTab as _, tokenProvider as a, requireOptionalBoolean as at, ItdErrorCode as b, normalizeNotification as c, systemClock as ct, canonicalNotificationType as d, DEFAULT_STATUS_BASE_URL as et, isKnownNotificationType as f, EventChannelStatus as g, CommentSort as h, bearerToken as i, isRecord$1 as it, OPERATIONS as j, WallAccess as k, readNotificationEvent as l, installAsyncDisposeFallback as lt, AttachmentType as m, formatNotificationText as n, resolveRateLimit as nt, passthroughOperation as o, RateLimitPacing as ot, AccessType as p, defineOperation as q, anonymousAuth as r, LIBRARY_VERSION as rt, voidOperation as s, createDeadline as st, resolveNotificationUrl as t, STATUS_SERVICE as tt, readUnreadCountEvent as u, IncidentKind as v, ReportTargetType as w, LikesVisibility as x, InteractionType as y, createClientRuntime as z };
 
-//# sourceMappingURL=url-CYXgxqGx.js.map
+//# sourceMappingURL=url-B3ocFlHj.js.map