itd-api 0.10.3 → 0.11.0

package/dist/shared/{render-CYJSDypQ.cjs → render-Dnc84B4M.cjs}

@@ -1,8 +1,8 @@
-const require_url = require("./url-BnO1aWsd.cjs");
-const require_errors = require("./errors-BmP3TKoW.cjs");
-const require_redact = require("./redact-lAmck1Z6.cjs");
-const require_options = require("./options-DjEtbVaf.cjs");
-const require_key_value_store = require("./key-value-store-B5GYVEYZ.cjs");
+const require_url = require("./url-DTgkCWv5.cjs");
+const require_validate = require("./validate-CFx2dISs.cjs");
+const require_redact = require("./redact-DoC7lSsp.cjs");
+const require_options = require("./options-5tywTYId.cjs");
+const require_key_value_store = require("./key-value-store-DYSPsqwq.cjs");
 //#region src/core/feature-catalog.ts
 /**
 * Изменяемый слой над каталогом конкретного API.
@@ -16,19 +16,16 @@ var ExtensibleOperationCatalog = class {
 	#base;
 	#operations = /* @__PURE__ */ new Map();
 	#operationOwners = /* @__PURE__ */ new Map();
-	#bucketOwners = /* @__PURE__ */ new Map();
-	#bucketLimits;
-	#bucketOverrides;
+	/** Бакеты feature: владелец и ограничения. Таблицы базового каталога не изменяются. */
+	#buckets = /* @__PURE__ */ new Map();
 	constructor(base) {
 		this.#base = base;
-		this.#bucketLimits = { ...base.bucketLimits };
-		this.#bucketOverrides = { ...base.bucketOverrides };
 	}
 	get bucketLimits() {
-		return this.#bucketLimits;
+		return this.#base.bucketLimits;
 	}
 	get bucketOverrides() {
-		return this.#bucketOverrides;
+		return this.#base.bucketOverrides;
 	}
 	get defaultBucket() {
 		return this.#base.defaultBucket;
@@ -36,41 +33,37 @@ var ExtensibleOperationCatalog = class {
 	definitionOf(id) {
 		return this.#operations.get(id) ?? this.#base.definitionOf(id);
 	}
-	retrySafetyOf(id) {
-		return this.#operations.get(id)?.retrySafety ?? this.#base.retrySafetyOf(id);
-	}
-	methodOf(id) {
-		return this.#operations.get(id)?.method ?? this.#base.methodOf(id);
-	}
 	bucketOf(id) {
 		return this.#operations.get(id)?.bucket ?? this.#base.bucketOf(id);
 	}
 	isKnownBucket(name) {
-		return this.#bucketOwners.has(name) || this.#base.isKnownBucket(name);
+		return this.#buckets.has(name) || this.#base.isKnownBucket(name);
+	}
+	bucketDefinitionOf(name) {
+		return this.#buckets.get(name)?.definition ?? this.#base.bucketDefinitionOf(name);
 	}
 	/** Регистрирует принадлежащий feature бакет и возвращает откат регистрации. */
 	registerBucket(owner, name, definition) {
-		if (this.#base.isKnownBucket(name) || this.#bucketOwners.has(name)) throw new require_errors.ItdConfigError(`feature «${owner}»: бакет «${name}» уже зарегистрирован`);
-		this.#bucketOwners.set(name, owner);
-		if (definition.limit !== void 0) this.#bucketLimits[name] = definition.limit;
-		if (definition.concurrency !== void 0 || definition.rps !== void 0) this.#bucketOverrides[name] = Object.freeze({
-			...definition.concurrency === void 0 ? {} : { concurrency: definition.concurrency },
-			...definition.rps === void 0 ? {} : { rps: definition.rps }
+		if (this.#base.isKnownBucket(name) || this.#buckets.has(name)) throw new require_validate.ItdConfigError(`feature «${owner}»: бакет «${name}» уже зарегистрирован`);
+		this.#buckets.set(name, {
+			owner,
+			definition: Object.freeze({
+				...definition.limit === void 0 ? {} : { limit: definition.limit },
+				...definition.concurrency === void 0 ? {} : { concurrency: definition.concurrency },
+				...definition.rps === void 0 ? {} : { rps: definition.rps }
+			})
 		});
 		return () => {
-			if (this.#bucketOwners.get(name) !== owner) return;
-			this.#bucketOwners.delete(name);
-			delete this.#bucketLimits[name];
-			delete this.#bucketOverrides[name];
+			if (this.#buckets.get(name)?.owner === owner) this.#buckets.delete(name);
 		};
 	}
 	/** Регистрирует операцию и возвращает откат регистрации. */
 	registerOperation(owner, id, definition) {
 		const ownerPrefix = `${owner}.`;
-		if (!id.startsWith(ownerPrefix) || id.length === ownerPrefix.length) throw new require_errors.ItdConfigError(`feature «${owner}»: операция «${id}» должна находиться в пространстве имён «${owner}»`);
+		if (!id.startsWith(ownerPrefix) || id.length === ownerPrefix.length) throw new require_validate.ItdConfigError(`feature «${owner}»: операция «${id}» должна находиться в пространстве имён «${owner}»`);
 		const occupiedBy = this.#operationOwners.get(id);
-		if (occupiedBy !== void 0) throw new require_errors.ItdConfigError(`feature «${owner}»: операция «${id}» уже зарегистрирована feature «${occupiedBy}»`);
-		if (this.#base.methodOf(id) !== void 0) throw new require_errors.ItdConfigError(`feature «${owner}»: операция «${id}» уже существует в базовом каталоге`);
+		if (occupiedBy !== void 0) throw new require_validate.ItdConfigError(`feature «${owner}»: операция «${id}» уже зарегистрирована feature «${occupiedBy}»`);
+		if (this.#base.definitionOf(id) !== void 0) throw new require_validate.ItdConfigError(`feature «${owner}»: операция «${id}» уже существует в базовом каталоге`);
 		this.#operationOwners.set(id, owner);
 		this.#operations.set(id, Object.freeze({ ...definition }));
 		return () => {
@@ -111,17 +104,17 @@ async function fetchFile(target, options, context) {
 	try {
 		requested = new URL(target);
 	} catch {
-		throw new require_errors.ItdConfigError(`«${require_redact.redactUrl(target)}» не разбирается как адрес`);
+		throw new require_validate.ItdConfigError(`«${require_redact.redactUrl(target)}» не разбирается как адрес`);
 	}
-	if (requested.protocol !== "http:" && requested.protocol !== "https:") throw new require_errors.ItdConfigError(`вложение по адресу поддерживает только http и https, получено: ${requested.protocol}`);
+	if (requested.protocol !== "http:" && requested.protocol !== "https:") throw new require_validate.ItdConfigError(`вложение по адресу поддерживает только http и https, получено: ${requested.protocol}`);
 	let response;
 	try {
 		response = await context.fetch(requested, { ...context.signal ? { signal: context.signal } : {} });
 	} catch (error) {
 		if (context.signal?.aborted || error instanceof Error && error.name === "AbortError") throw error;
 		const safeUrl = require_redact.redactUrl(requested.href);
-		throw new require_errors.ItdFileError(`не удалось получить файл по адресу ${safeUrl}`, {
-			reason: require_errors.ItdFileErrorReason.Network,
+		throw new require_validate.ItdFileError(`не удалось получить файл по адресу ${safeUrl}`, {
+			reason: require_validate.ItdFileErrorReason.Network,
 			url: safeUrl,
 			retryable: true,
 			cause: require_redact.redactErrorCause(error)
@@ -131,8 +124,8 @@ async function fetchFile(target, options, context) {
 	if (!response.ok) {
 		await response.body?.cancel().catch(() => {});
 		const safeUrl = require_redact.redactUrl(finalUrl.href);
-		throw new require_errors.ItdFileError(`источник ${safeUrl} ответил статусом ${response.status}`, {
-			reason: require_errors.ItdFileErrorReason.Http,
+		throw new require_validate.ItdFileError(`источник ${safeUrl} ответил статусом ${response.status}`, {
+			reason: require_validate.ItdFileErrorReason.Http,
 			url: safeUrl,
 			status: response.status,
 			retryable: response.status === 408 || response.status === 429 || response.status >= 500
@@ -153,11 +146,11 @@ async function fetchFile(target, options, context) {
 	};
 }
 /** Читает ответ с контролем размера до создания итогового `Blob`. */
-async function responseBlob(response, url, maxBytes, streamBufferBytes, signal) {
+async function responseBlob(response, url, maxBytes, streamBufferBytes, signal, type) {
 	if (!response.body) {
 		const blob = await response.blob();
 		if (maxBytes !== void 0 && blob.size > maxBytes) throw require_options.fileTooLarge(url, maxBytes, blob.size);
-		return blob;
+		return blob.type === type ? blob : new Blob([blob], { type });
 	}
 	const chunks = [];
 	const reader = require_options.boundedFileStream(response.body, {
@@ -176,17 +169,17 @@ async function responseBlob(response, url, maxBytes, streamBufferBytes, signal)
 	} finally {
 		reader.releaseLock();
 	}
-	return new Blob(chunks.map((chunk) => Uint8Array.from(chunk).buffer));
+	return new Blob(chunks, { type });
 }
 /** Скачивает файл целиком с ограничением размера. @internal */
 async function downloadFile(target, options, context) {
 	const resolved = require_options.resolveFileStreamOptions(options, require_options.DEFAULT_URL_FILE_MAX_BYTES);
 	const { response, url } = await fetchFile(target, options, context);
-	const blob = await responseBlob(response, url.href, resolved.maxBytes, resolved.streamBufferBytes, context.signal);
 	const contentType = normalizeMimeType(options.contentType ?? response.headers.get("content-type") ?? void 0);
+	const file = await responseBlob(response, url.href, resolved.maxBytes, resolved.streamBufferBytes, context.signal, contentType ?? "");
 	const filename = options.filename ?? filenameFromUrl(url);
 	return {
-		file: new Blob([blob], { type: contentType ?? "" }),
+		file,
 		...filename ? { filename } : {},
 		...contentType ? { contentType } : {}
 	};
@@ -197,8 +190,8 @@ async function openUrlFile(target, options, context) {
 	const { response, url, size } = await fetchFile(target, options, context);
 	if (!response.body) {
 		const safeUrl = require_redact.redactUrl(url.href);
-		throw new require_errors.ItdFileError(`источник ${safeUrl} не предоставил потоковое тело`, {
-			reason: require_errors.ItdFileErrorReason.StreamUnavailable,
+		throw new require_validate.ItdFileError(`источник ${safeUrl} не предоставил потоковое тело`, {
+			reason: require_validate.ItdFileErrorReason.StreamUnavailable,
 			url: safeUrl
 		});
 	}
@@ -245,7 +238,7 @@ var DefaultFileResolver = class {
 	}
 	async resolve(input, options = {}, context = {}) {
 		const attempt = context.attempt ?? 1;
-		if (!Number.isInteger(attempt) || attempt < 1) throw new require_errors.ItdConfigError(`attempt должен быть целым числом от 1, получено: ${attempt}`);
+		if (!Number.isInteger(attempt) || attempt < 1) throw new require_validate.ItdConfigError(`attempt должен быть целым числом от 1, получено: ${attempt}`);
 		const maxBytes = require_options.optionalBytes(options.maxBytes, "maxBytes");
 		if (context.signal?.aborted) throw context.signal.reason ?? new DOMException("Aborted", "AbortError");
 		const fileContext = {
@@ -261,9 +254,9 @@ var DefaultFileResolver = class {
 			}
 			return source;
 		} catch (error) {
-			if (error instanceof require_errors.ItdError || context.signal?.aborted) throw error;
-			throw new require_errors.ItdFileError("не удалось получить содержимое вложения", {
-				reason: require_errors.ItdFileErrorReason.Read,
+			if (error instanceof require_validate.ItdError || context.signal?.aborted) throw error;
+			throw new require_validate.ItdFileError("не удалось получить содержимое вложения", {
+				reason: require_validate.ItdFileErrorReason.Read,
 				retryable: true,
 				cause: require_redact.redactErrorCause(error)
 			});
@@ -271,8 +264,8 @@ var DefaultFileResolver = class {
 	}
 	async #loadBuffer(input, options, context, maxBytes) {
 		const content = await this.#resolveBuffer(input, context);
-		if (typeof content !== "object" || content === null || !("file" in content)) throw new require_errors.ItdConfigError("буферный источник должен вернуть объект с полем file");
-		if (!require_redact.isBlob(content.file) && !(content.file instanceof ArrayBuffer) && !ArrayBuffer.isView(content.file)) throw new require_errors.ItdConfigError("поле file должно содержать Blob, ArrayBuffer или Uint8Array");
+		if (typeof content !== "object" || content === null || !("file" in content)) throw new require_validate.ItdConfigError("буферный источник должен вернуть объект с полем file");
+		if (!require_redact.isBlob(content.file) && !(content.file instanceof ArrayBuffer) && !ArrayBuffer.isView(content.file)) throw new require_validate.ItdConfigError("поле file должно содержать Blob, ArrayBuffer или Uint8Array");
 		const contentType = normalizeMimeType(options.contentType ?? content.contentType) ?? normalizeMimeType(require_redact.isBlob(content.file) ? content.file.type : void 0);
 		const blob = require_redact.isBlob(content.file) && (!contentType || content.file.type === contentType) ? content.file : new Blob([content.file], { type: contentType ?? "" });
 		if (maxBytes !== void 0 && blob.size > maxBytes) throw require_options.fileTooLarge(void 0, maxBytes, blob.size);
@@ -288,7 +281,7 @@ var DefaultFileResolver = class {
 		const opened = await this.#resolveStream(input, context);
 		if (!opened || !require_options.isReadableByteStream(opened.stream)) {
 			await opened?.close?.();
-			throw new require_errors.ItdConfigError("потоковый источник должен вернуть { stream: ReadableStream }");
+			throw new require_validate.ItdConfigError("потоковый источник должен вернуть { stream: ReadableStream }");
 		}
 		let handedOff = false;
 		const closeOpened = closeOnce(async () => {
@@ -297,7 +290,7 @@ var DefaultFileResolver = class {
 		try {
 			require_options.optionalBytes(opened.size, "size");
 			if (maxBytes !== void 0 && opened.size !== void 0 && opened.size > maxBytes) throw require_options.fileTooLarge(void 0, maxBytes, opened.size);
-			if (options.requireKnownSize === true && opened.size === void 0) throw new require_errors.ItdConfigError("размер потокового вложения должен быть известен до чтения");
+			if (options.requireKnownSize === true && opened.size === void 0) throw new require_validate.ItdConfigError("размер потокового вложения должен быть известен до чтения");
 			const limits = require_options.resolveFileStreamOptions({
 				mode: require_options.FileTransferMode.Stream,
 				...maxBytes !== void 0 ? { maxBytes } : {},
@@ -345,15 +338,15 @@ var DefaultFileResolver = class {
 			file: input,
 			...require_redact.isFile(input) ? { filename: input.name } : {}
 		};
-		if (typeof input !== "object" || input === null) throw new require_errors.ItdConfigError(`вложение задано значением типа ${typeof input}; ожидается бинарное значение или объект { file }, { url }, { load }, { open }. Для файла на диске используйте fromPath('./photo.jpg') из itd-api/node`);
+		if (typeof input !== "object" || input === null) throw new require_validate.ItdConfigError(`вложение задано значением типа ${typeof input}; ожидается бинарное значение или объект { file }, { url }, { load }, { open }. Для файла на диске используйте fromPath('./photo.jpg') из itd-api/node`);
 		if ("load" in input) return input.load(context);
 		if ("url" in input) {
 			const { url, ...urlOptions } = input;
 			return downloadFile(url, urlOptions, context);
 		}
 		if ("file" in input) return input;
-		if ("open" in input) throw new require_errors.ItdConfigError("потоковый источник нельзя использовать как буферный");
-		throw new require_errors.ItdConfigError("вложение не распознано: ожидается { file }, { url }, { load } или { open }");
+		if ("open" in input) throw new require_validate.ItdConfigError("потоковый источник нельзя использовать как буферный");
+		throw new require_validate.ItdConfigError("вложение не распознано: ожидается { file }, { url }, { load } или { open }");
 	}
 	#resolveStream(input, context) {
 		if (typeof input === "object" && input !== null && "open" in input) return input.open(context);
@@ -361,7 +354,7 @@ var DefaultFileResolver = class {
 			const { url, ...urlOptions } = input;
 			return openUrlFile(url, urlOptions, context);
 		}
-		throw new require_errors.ItdConfigError("потоковое вложение должно иметь форму { open } или { url, mode }");
+		throw new require_validate.ItdConfigError("потоковое вложение должно иметь форму { open } или { url, mode }");
 	}
 };
 /** Создаёт механизм подготовки файлов, привязанный к настроенному `fetch` клиента. @internal */
@@ -387,34 +380,120 @@ var FeatureInstallationTransaction = class {
 	}
 };
 function requireName(value, kind) {
-	if (typeof value !== "string" || value.trim() === "") throw new require_errors.ItdConfigError(`${kind} должен иметь непустое имя`);
+	if (typeof value !== "string" || value.trim() === "") throw new require_validate.ItdConfigError(`${kind} должен иметь непустое имя`);
 	return value.trim();
 }
 function requireFeatureName(value) {
 	const name = requireName(value, "Feature");
-	if (!/^[a-z][a-z0-9-]*$/.test(name)) throw new require_errors.ItdConfigError(`имя feature «${name}» должно соответствовать [a-z][a-z0-9-]*`);
+	if (!/^[a-z][a-z0-9-]*$/.test(name)) throw new require_validate.ItdConfigError(`имя feature «${name}» должно соответствовать [a-z][a-z0-9-]*`);
 	return name;
 }
 function validateBucket(owner, localName, bucket) {
-	if (typeof bucket !== "object" || bucket === null || Array.isArray(bucket)) throw new require_errors.ItdConfigError(`feature «${owner}»: бакет «${localName}» должен быть объектом`);
-	if (bucket.limit !== void 0 && (!Number.isFinite(bucket.limit) || bucket.limit <= 0)) throw new require_errors.ItdConfigError(`feature «${owner}»: limit бакета «${localName}» должен быть положительным числом`);
-	if (bucket.concurrency !== void 0 && (!Number.isInteger(bucket.concurrency) || bucket.concurrency < 1)) throw new require_errors.ItdConfigError(`feature «${owner}»: concurrency бакета «${localName}» должен быть целым числом от 1`);
-	if (bucket.rps !== void 0 && (!Number.isFinite(bucket.rps) || bucket.rps <= 0)) throw new require_errors.ItdConfigError(`feature «${owner}»: rps бакета «${localName}» должен быть положительным числом`);
+	if (typeof bucket !== "object" || bucket === null || Array.isArray(bucket)) throw new require_validate.ItdConfigError(`feature «${owner}»: бакет «${localName}» должен быть объектом`);
+	if (bucket.limit !== void 0 && (!Number.isFinite(bucket.limit) || bucket.limit <= 0)) throw new require_validate.ItdConfigError(`feature «${owner}»: limit бакета «${localName}» должен быть положительным числом`);
+	if (bucket.concurrency !== void 0 && (!Number.isInteger(bucket.concurrency) || bucket.concurrency < 1)) throw new require_validate.ItdConfigError(`feature «${owner}»: concurrency бакета «${localName}» должен быть целым числом от 1`);
+	if (bucket.rps !== void 0 && (!Number.isFinite(bucket.rps) || bucket.rps <= 0)) throw new require_validate.ItdConfigError(`feature «${owner}»: rps бакета «${localName}» должен быть положительным числом`);
 }
 function validateFeatureDefinition(feature, isInstalled) {
-	if (typeof feature !== "object" || feature === null) throw new require_errors.ItdConfigError("feature должен быть объектом");
+	if (typeof feature !== "object" || feature === null) throw new require_validate.ItdConfigError("feature должен быть объектом");
 	const name = requireFeatureName(feature.name);
-	if (isInstalled(name)) throw new require_errors.ItdConfigError(`feature «${name}» уже установлен`);
-	if (typeof feature.setup !== "function") throw new require_errors.ItdConfigError(`feature «${name}» должен предоставлять setup()`);
-	if (typeof feature.operations !== "object" || feature.operations === null || Array.isArray(feature.operations)) throw new require_errors.ItdConfigError(`feature «${name}» должен объявлять operations`);
-	if (feature.services !== void 0 && !Array.isArray(feature.services)) throw new require_errors.ItdConfigError(`feature «${name}»: services должен быть массивом`);
-	if (feature.buckets !== void 0 && (typeof feature.buckets !== "object" || feature.buckets === null || Array.isArray(feature.buckets))) throw new require_errors.ItdConfigError(`feature «${name}»: buckets должен быть объектом`);
+	if (isInstalled(name)) throw new require_validate.ItdConfigError(`feature «${name}» уже установлен`);
+	if (typeof feature.setup !== "function") throw new require_validate.ItdConfigError(`feature «${name}» должен предоставлять setup()`);
+	if (typeof feature.operations !== "object" || feature.operations === null || Array.isArray(feature.operations)) throw new require_validate.ItdConfigError(`feature «${name}» должен объявлять operations`);
+	if (feature.services !== void 0 && !Array.isArray(feature.services)) throw new require_validate.ItdConfigError(`feature «${name}»: services должен быть массивом`);
+	if (feature.buckets !== void 0 && (typeof feature.buckets !== "object" || feature.buckets === null || Array.isArray(feature.buckets))) throw new require_validate.ItdConfigError(`feature «${name}»: buckets должен быть объектом`);
 	return name;
 }
 function validateFeatureInstallation(name, installation) {
-	if (typeof installation !== "object" || installation === null || !("api" in installation)) throw new require_errors.ItdConfigError(`setup() feature «${name}» должен вернуть объект с полем api`);
-	if (installation.close !== void 0 && typeof installation.close !== "function") throw new require_errors.ItdConfigError(`feature «${name}»: close должен быть функцией`);
-	if (installation.dispose !== void 0 && typeof installation.dispose !== "function") throw new require_errors.ItdConfigError(`feature «${name}»: dispose должен быть функцией`);
+	if (typeof installation !== "object" || installation === null || !("api" in installation)) throw new require_validate.ItdConfigError(`setup() feature «${name}» должен вернуть объект с полем api`);
+	if (installation.close !== void 0 && typeof installation.close !== "function") throw new require_validate.ItdConfigError(`feature «${name}»: close должен быть функцией`);
+	if (installation.dispose !== void 0 && typeof installation.dispose !== "function") throw new require_validate.ItdConfigError(`feature «${name}»: dispose должен быть функцией`);
+}
+/** Пишет ошибку отката в журнал; сбой самого журнала не заменяет ошибку установки. */
+function reportRollbackError(logger, message, error) {
+	try {
+		logger?.error(message, error);
+	} catch {}
+}
+/** Останавливает ресурс, зарегистрированный до публикации модуля, при откате установки. */
+function stopUnpublishedResource(resource, release, featureName, logger) {
+	try {
+		resource.stop();
+	} catch (error) {
+		reportRollbackError(logger, `Не удалось остановить ресурс «${resource.kind}» при откате feature «${featureName}»`, error);
+	} finally {
+		release();
+	}
+	Promise.resolve().then(() => resource.drain()).catch((error) => {
+		reportRollbackError(logger, `Не удалось освободить ресурс «${resource.kind}» при откате feature «${featureName}»`, error);
+	});
+}
+/** Собирает {@link FeatureContext} модуля: доступ к клиенту с проверкой, что модуль активен. */
+function createFeatureContext(deps, activation) {
+	const { name, controller, services, operations, transaction } = activation;
+	const inactive = () => new require_validate.ItdStateError(`feature «${name}» не активен`);
+	const assertActive = (action) => {
+		deps.assertActive(action);
+		if (!activation.committed || controller.signal.aborted) throw inactive();
+	};
+	const requireService = (serviceName) => {
+		if (!services.has(serviceName)) throw new require_validate.ItdConfigError(`feature «${name}» не объявляет сервис «${serviceName}»`);
+	};
+	return Object.freeze({
+		featureName: name,
+		baseUrl: deps.baseUrl,
+		signal: controller.signal,
+		clock: deps.clock,
+		logger: deps.logger,
+		files: Object.freeze({ resolve: (input, options, context) => {
+			try {
+				assertActive(`открыть файловый источник feature «${name}»`);
+				return deps.files.resolve(input, options, context);
+			} catch (error) {
+				return Promise.reject(error);
+			}
+		} }),
+		request: (operation, options) => {
+			try {
+				assertActive(`выполнить операцию feature «${name}»`);
+				const resolved = operations.get(operation);
+				if (!resolved) throw new require_validate.ItdConfigError(`feature «${name}» не объявляет операцию «${operation}»`);
+				const { operationId: _operationId, method: _method, service: _service, baseUrl: _baseUrl, retrySafety: _retrySafety, rateLimitBucket: _rateLimitBucket, ...scoped } = options;
+				return deps.http.execute(resolved.contract, {
+					...scoped,
+					...resolved.service === void 0 ? {} : { service: resolved.service }
+				});
+			} catch (error) {
+				return Promise.reject(error);
+			}
+		},
+		serviceBaseUrl: (serviceName) => {
+			requireService(serviceName);
+			return deps.services.resolveBaseUrl(serviceName);
+		},
+		connection: (serviceName) => {
+			requireService(serviceName);
+			return deps.connection(serviceName);
+		},
+		manage: (resource) => {
+			deps.assertActive(`зарегистрировать ресурс feature «${name}»`);
+			if (controller.signal.aborted) throw inactive();
+			const unregister = deps.manage(resource);
+			let registered = true;
+			const release = () => {
+				if (!registered) return;
+				registered = false;
+				unregister();
+			};
+			if (!activation.committed) transaction.add(() => {
+				if (!registered) return;
+				if (activation.committed) release();
+				else stopUnpublishedResource(resource, release, name, deps.logger);
+			});
+			return release;
+		},
+		assertActive
+	});
 }
 /** Реестр подключаемых модулей клиента. @internal */
 var FeatureRegistry = class {
@@ -430,8 +509,8 @@ var FeatureRegistry = class {
 		for (const service of definitions) {
 			const serviceName = requireName(service?.name, `Сервис feature «${featureName}»`);
 			const owner = this.#serviceOwners.get(serviceName);
-			if (owner !== void 0) throw new require_errors.ItdConfigError(`feature «${featureName}»: сервис «${serviceName}» уже принадлежит feature «${owner}»`);
-			if (services.has(serviceName)) throw new require_errors.ItdConfigError(`feature «${featureName}»: сервис «${serviceName}» объявлен повторно`);
+			if (owner !== void 0) throw new require_validate.ItdConfigError(`feature «${featureName}»: сервис «${serviceName}» уже принадлежит feature «${owner}»`);
+			if (services.has(serviceName)) throw new require_validate.ItdConfigError(`feature «${featureName}»: сервис «${serviceName}» объявлен повторно`);
 			if (!this.#deps.services.has(serviceName)) {
 				this.#deps.services.define(service);
 				transaction.add(() => void this.#deps.services.delete(serviceName));
@@ -457,8 +536,6 @@ var FeatureRegistry = class {
 			validateBucket(featureName, localName, bucket);
 			const globalName = `feature:${featureName}/${localName}`;
 			transaction.add(this.#deps.catalog.registerBucket(featureName, globalName, bucket));
-			const unregisterQueue = this.#deps.registerBucket(globalName, bucket);
-			if (unregisterQueue) transaction.add(unregisterQueue);
 			bucketNames.set(localName, globalName);
 		}
 		return bucketNames;
@@ -467,22 +544,16 @@ var FeatureRegistry = class {
 		const operations = /* @__PURE__ */ new Map();
 		for (const [rawLocalName, definition] of Object.entries(definitions)) {
 			const localName = requireName(rawLocalName, `Операция feature «${featureName}»`);
-			if (typeof definition !== "object" || definition === null) throw new require_errors.ItdConfigError(`feature «${featureName}»: операция «${localName}» должна быть объектом`);
-			if (![
-				"GET",
-				"POST",
-				"PUT",
-				"PATCH",
-				"DELETE"
-			].includes(definition.method)) throw new require_errors.ItdConfigError(`feature «${featureName}»: операция «${localName}» содержит неизвестный HTTP-метод`);
-			if (!Object.values(require_url.RetrySafety).includes(definition.retrySafety)) throw new require_errors.ItdConfigError(`feature «${featureName}»: операция «${localName}» содержит неизвестную retrySafety`);
-			if (definition.service !== void 0 && typeof definition.service !== "string") throw new require_errors.ItdConfigError(`feature «${featureName}»: service операции «${localName}» должен быть строкой`);
-			if (definition.bucket !== void 0 && typeof definition.bucket !== "string") throw new require_errors.ItdConfigError(`feature «${featureName}»: bucket операции «${localName}» должен быть строкой`);
-			if (definition.read !== void 0 && typeof definition.read !== "function") throw new require_errors.ItdConfigError(`feature «${featureName}»: read операции «${localName}» должна быть функцией`);
-			if (definition.annotations !== void 0 && (typeof definition.annotations !== "object" || definition.annotations === null || Array.isArray(definition.annotations))) throw new require_errors.ItdConfigError(`feature «${featureName}»: annotations операции «${localName}» должны быть объектом`);
-			if (definition.service !== void 0 && !services.has(definition.service)) throw new require_errors.ItdConfigError(`feature «${featureName}»: операция «${localName}» ссылается на необъявленный сервис «${definition.service}»`);
+			if (typeof definition !== "object" || definition === null) throw new require_validate.ItdConfigError(`feature «${featureName}»: операция «${localName}» должна быть объектом`);
+			if (!Object.values(require_url.OperationMethod).includes(definition.method)) throw new require_validate.ItdConfigError(`feature «${featureName}»: операция «${localName}» содержит неизвестный HTTP-метод`);
+			if (!Object.values(require_url.RetrySafety).includes(definition.retrySafety)) throw new require_validate.ItdConfigError(`feature «${featureName}»: операция «${localName}» содержит неизвестную retrySafety`);
+			if (definition.service !== void 0 && typeof definition.service !== "string") throw new require_validate.ItdConfigError(`feature «${featureName}»: service операции «${localName}» должен быть строкой`);
+			if (definition.bucket !== void 0 && typeof definition.bucket !== "string") throw new require_validate.ItdConfigError(`feature «${featureName}»: bucket операции «${localName}» должен быть строкой`);
+			if (definition.read !== void 0 && typeof definition.read !== "function") throw new require_validate.ItdConfigError(`feature «${featureName}»: read операции «${localName}» должна быть функцией`);
+			if (definition.annotations !== void 0 && (typeof definition.annotations !== "object" || definition.annotations === null || Array.isArray(definition.annotations))) throw new require_validate.ItdConfigError(`feature «${featureName}»: annotations операции «${localName}» должны быть объектом`);
+			if (definition.service !== void 0 && !services.has(definition.service)) throw new require_validate.ItdConfigError(`feature «${featureName}»: операция «${localName}» ссылается на необъявленный сервис «${definition.service}»`);
 			const bucket = definition.bucket === void 0 ? this.#deps.catalog.defaultBucket : bucketNames.get(definition.bucket);
-			if (bucket === void 0) throw new require_errors.ItdConfigError(`feature «${featureName}»: операция «${localName}» ссылается на необъявленный бакет «${definition.bucket}»`);
+			if (bucket === void 0) throw new require_validate.ItdConfigError(`feature «${featureName}»: операция «${localName}» ссылается на необъявленный бакет «${definition.bucket}»`);
 			const operationId = `${featureName}.${localName}`;
 			const contract = require_url.defineOperation(operationId, {
 				method: definition.method,
@@ -505,99 +576,22 @@ var FeatureRegistry = class {
 	}
 	install(feature) {
 		this.#deps.assertActive("установить feature");
-		if (this.#disposed) throw new require_errors.ItdStateError("Реестр feature уже освобождён");
+		if (this.#disposed) throw new require_validate.ItdStateError("Реестр feature уже освобождён");
 		const name = validateFeatureDefinition(feature, (candidate) => this.#features.has(candidate));
 		const transaction = new FeatureInstallationTransaction();
 		const controller = new AbortController();
-		let committed = false;
-		const reportRollbackError = (message, error) => {
-			try {
-				this.#deps.logger?.error(message, error);
-			} catch {}
-		};
 		try {
 			const services = this.#registerServices(name, feature.services ?? [], transaction);
 			const bucketNames = this.#registerBuckets(name, feature.buckets ?? {}, transaction);
-			const operations = this.#registerOperations(name, feature.operations, services, bucketNames, transaction);
-			const context = Object.freeze({
-				featureName: name,
-				baseUrl: this.#deps.baseUrl,
-				signal: controller.signal,
-				clock: this.#deps.clock,
-				logger: this.#deps.logger,
-				files: Object.freeze({ resolve: (input, options, context) => {
-					try {
-						this.#deps.assertActive(`открыть файловый источник feature «${name}»`);
-						if (!committed || controller.signal.aborted) throw new require_errors.ItdStateError(`feature «${name}» не активен`);
-						return this.#deps.files.resolve(input, options, context);
-					} catch (error) {
-						return Promise.reject(error);
-					}
-				} }),
-				request: (operation, options) => {
-					try {
-						this.#deps.assertActive(`выполнить операцию feature «${name}»`);
-						if (!committed || controller.signal.aborted) throw new require_errors.ItdStateError(`feature «${name}» не активен`);
-						const resolved = operations.get(operation);
-						if (!resolved) throw new require_errors.ItdConfigError(`feature «${name}» не объявляет операцию «${operation}»`);
-						const scoped = { ...options };
-						delete scoped.operationId;
-						delete scoped.method;
-						delete scoped.service;
-						delete scoped.baseUrl;
-						delete scoped.retrySafety;
-						delete scoped.rateLimitBucket;
-						return this.#deps.http.execute(resolved.contract, {
-							...scoped,
-							...resolved.service === void 0 ? {} : { service: resolved.service }
-						});
-					} catch (error) {
-						return Promise.reject(error);
-					}
-				},
-				serviceBaseUrl: (serviceName) => {
-					if (!services.has(serviceName)) throw new require_errors.ItdConfigError(`feature «${name}» не объявляет сервис «${serviceName}»`);
-					return this.#deps.services.resolveBaseUrl(serviceName);
-				},
-				connection: (serviceName) => {
-					if (!services.has(serviceName)) throw new require_errors.ItdConfigError(`feature «${name}» не объявляет сервис «${serviceName}»`);
-					return this.#deps.connection(serviceName);
-				},
-				manage: (resource) => {
-					this.#deps.assertActive(`зарегистрировать ресурс feature «${name}»`);
-					if (controller.signal.aborted) throw new require_errors.ItdStateError(`feature «${name}» не активен`);
-					const unregister = this.#deps.manage(resource);
-					let registered = true;
-					const release = () => {
-						if (!registered) return;
-						registered = false;
-						unregister();
-					};
-					if (!committed) transaction.add(() => {
-						if (!registered) return;
-						if (committed) {
-							release();
-							return;
-						}
-						try {
-							resource.stop();
-						} catch (error) {
-							reportRollbackError(`Не удалось остановить ресурс «${resource.kind}» при откате feature «${name}»`, error);
-						} finally {
-							release();
-						}
-						Promise.resolve().then(() => resource.drain()).catch((error) => {
-							reportRollbackError(`Не удалось освободить ресурс «${resource.kind}» при откате feature «${name}»`, error);
-						});
-					});
-					return release;
-				},
-				assertActive: (action) => {
-					this.#deps.assertActive(action);
-					if (!committed || controller.signal.aborted) throw new require_errors.ItdStateError(`feature «${name}» не активен`);
-				}
-			});
-			const installation = feature.setup(context);
+			const activation = {
+				name,
+				controller,
+				services,
+				operations: this.#registerOperations(name, feature.operations, services, bucketNames, transaction),
+				transaction,
+				committed: false
+			};
+			const installation = feature.setup(createFeatureContext(this.#deps, activation));
 			validateFeatureInstallation(name, installation);
 			this.#features.set(name, {
 				name,
@@ -606,12 +600,12 @@ var FeatureRegistry = class {
 				dispose: installation.dispose,
 				cleanup: transaction.snapshot()
 			});
-			committed = true;
+			activation.committed = true;
 			return installation.api;
 		} catch (error) {
-			controller.abort(new require_errors.ItdAbortError(`Установка feature «${name}» отменена`));
+			controller.abort(new require_validate.ItdAbortError(`Установка feature «${name}» отменена`));
 			transaction.rollback((rollbackError) => {
-				reportRollbackError(`Не удалось полностью откатить feature «${name}»`, rollbackError);
+				reportRollbackError(this.#deps.logger, `Не удалось полностью откатить feature «${name}»`, rollbackError);
 			});
 			throw error;
 		}
@@ -633,7 +627,7 @@ var FeatureRegistry = class {
 		const disposals = [];
 		const features = [...this.#features.values()].reverse();
 		for (const feature of features) {
-			feature.controller.abort(new require_errors.ItdAbortError(`Feature «${feature.name}» освобождён`));
+			feature.controller.abort(new require_validate.ItdAbortError(`Feature «${feature.name}» освобождён`));
 			try {
 				disposals.push(Promise.resolve(feature.dispose?.()).then(() => void 0));
 			} catch (error) {
@@ -658,8 +652,8 @@ var ManagedResourceRegistry = class {
 	#resources = /* @__PURE__ */ new Set();
 	#disposed = false;
 	register(resource) {
-		if (this.#disposed) throw new require_errors.ItdStateError("Lifecycle клиента уже освобождён");
-		if (typeof resource !== "object" || resource === null || typeof resource.kind !== "string" || resource.kind.trim() === "" || typeof resource.stop !== "function" || typeof resource.drain !== "function") throw new require_errors.ItdConfigError("Managed resource должен предоставлять kind, stop() и drain()");
+		if (this.#disposed) throw new require_validate.ItdStateError("Lifecycle клиента уже освобождён");
+		if (typeof resource !== "object" || resource === null || typeof resource.kind !== "string" || resource.kind.trim() === "" || typeof resource.stop !== "function" || typeof resource.drain !== "function") throw new require_validate.ItdConfigError("Managed resource должен предоставлять kind, stop() и drain()");
 		this.#resources.add(resource);
 		let registered = true;
 		return () => {
@@ -714,8 +708,7 @@ var ClientFeatureHost = class {
 			files: this.files,
 			assertActive: options.assertActive,
 			connection: (serviceName) => runtime.connection(serviceName),
-			manage: (resource) => this.#resources.register(resource),
-			registerBucket: (name, definition) => runtime.registerRateLimitBucket(name, definition)
+			manage: (resource) => this.#resources.register(resource)
 		});
 	}
 	install(feature) {
@@ -755,7 +748,7 @@ var ClientFeatureHost = class {
 				});
 				return await deadline.wait(result) ? void 0 : kind;
 			}))).filter((kind) => kind !== void 0);
-			if (stuck.length > 0) errors.push(new require_errors.ItdStateError(`ресурсы (${stuck.join(", ")}) не завершились за ${this.#runtime.config.shutdownTimeout} мс`));
+			if (stuck.length > 0) errors.push(new require_validate.ItdStateError(`ресурсы (${stuck.join(", ")}) не завершились за ${this.#runtime.config.shutdownTimeout} мс`));
 		} finally {
 			deadline.cancel();
 		}
@@ -772,7 +765,7 @@ var ClientFeatureHost = class {
 			failure = error;
 		});
 		try {
-			if (!await deadline.wait(settled)) throw new require_errors.ItdStateError(`освобождение подключаемых модулей не завершилось за ${this.#runtime.config.shutdownTimeout} мс`);
+			if (!await deadline.wait(settled)) throw new require_validate.ItdStateError(`освобождение подключаемых модулей не завершилось за ${this.#runtime.config.shutdownTimeout} мс`);
 		} finally {
 			deadline.cancel();
 		}
@@ -940,7 +933,7 @@ var Paginator = class {
 	#finished = false;
 	#pagesLoaded = 0;
 	constructor(options) {
-		if (options.maxPages !== void 0 && (!Number.isInteger(options.maxPages) || options.maxPages < 1)) throw new require_errors.ItdConfigError(`maxPages должен быть целым числом не меньше 1, получено: ${options.maxPages}`);
+		if (options.maxPages !== void 0 && (!Number.isInteger(options.maxPages) || options.maxPages < 1)) throw new require_validate.ItdConfigError(`maxPages должен быть целым числом не меньше 1, получено: ${options.maxPages}`);
 		this.#options = options;
 		this.#maxPages = options.maxPages ?? 1e3;
 		this.#state = options.start ?? {};
@@ -1293,7 +1286,7 @@ function toDate(value) {
 //#region src/resources/status.ts
 /** Приводит `last_checked` каждого сервиса к ISO. Остальное остаётся как прислал сервер. */
 function normalizeStatus(body) {
-	if (!require_url.isRecord(body) || !Array.isArray(body.services)) return body;
+	if (!require_validate.isRecord(body) || !Array.isArray(body.services)) return body;
 	return {
 		...body,
 		services: body.services.map((service) => typeof service?.last_checked === "string" ? {
@@ -1372,14 +1365,14 @@ function validateComment(input) {
 	const files = input?.files ?? [];
 	const hasContent = content.trim() !== "";
 	const hasAttachments = attachmentIds.length > 0 || files.length > 0;
-	if (!hasContent && !hasAttachments) throw new require_errors.ItdConfigError("Комментарий пуст: нужен текст или вложение");
+	if (!hasContent && !hasAttachments) throw new require_validate.ItdConfigError("Комментарий пуст: нужен текст или вложение");
 	return input;
 }
 /** Дополнительная проверка голосового комментария. */
 function validateVoice(state) {
-	if (state.content.trim() !== "") throw new require_errors.ItdConfigError("У голосового комментария не может быть текста: API принимает либо текст, либо аудио");
+	if (state.content.trim() !== "") throw new require_validate.ItdConfigError("У голосового комментария не может быть текста: API принимает либо текст, либо аудио");
 	const total = state.files.length + state.attachmentIds.length;
-	if (total !== 1) throw new require_errors.ItdConfigError(`Голосовой комментарий требует ровно одно аудиовложение, передано: ${total}`);
+	if (total !== 1) throw new require_validate.ItdConfigError(`Голосовой комментарий требует ровно одно аудиовложение, передано: ${total}`);
 }
 /**
 * Билдер комментария и ответа на комментарий.
@@ -1488,7 +1481,7 @@ function comment(content = "") {
 */
 function resolveComment(input, allowReplyTo = false) {
 	const resolved = resolveInput(input, () => comment(), validateComment);
-	if (!allowReplyTo && resolved.replyToUserId !== void 0) throw new require_errors.ItdConfigError("replyTo применим только к ответу на комментарий (itd.comments.reply). В комментарии к посту адресат не указывается.");
+	if (!allowReplyTo && resolved.replyToUserId !== void 0) throw new require_validate.ItdConfigError("replyTo применим только к ответу на комментарий (itd.comments.reply). В комментарии к посту адресат не указывается.");
 	return resolved;
 }
 //#endregion
@@ -1733,8 +1726,8 @@ function isAllowedMime(mimeType) {
 * @throws {ItdConfigError} если тип не поддерживается
 */
 function assertAllowedMime(mimeType, filename) {
-	if (!mimeType) throw new require_errors.ItdConfigError(`Не удалось определить тип файла${filename ? ` «${filename}»` : ""}. Укажите его явно: { file, filename, contentType }.`);
-	if (!isAllowedMime(mimeType)) throw new require_errors.ItdConfigError(`Тип «${mimeType}» не поддерживается загрузкой. Допустимые: ${ALLOWED_MIME_TYPES.join(", ")}.`);
+	if (!mimeType) throw new require_validate.ItdConfigError(`Не удалось определить тип файла${filename ? ` «${filename}»` : ""}. Укажите его явно: { file, filename, contentType }.`);
+	if (!isAllowedMime(mimeType)) throw new require_validate.ItdConfigError(`Тип «${mimeType}» не поддерживается загрузкой. Допустимые: ${ALLOWED_MIME_TYPES.join(", ")}.`);
 }
 //#endregion
 //#region src/resources/files.ts
@@ -1982,12 +1975,12 @@ var PlatformResource = class extends BaseResource {
 * Возвращает копии, чтобы последующая мутация входного массива не меняла уже собранные данные.
 */
 function validateSpans(content, spans) {
-	if (!Array.isArray(spans)) throw new require_errors.ItdConfigError("spans должен быть массивом");
-	if (content.length === 0 && spans.length > 0) throw new require_errors.ItdConfigError("Нельзя задать spans без текста: сначала укажите непустой content");
+	if (!Array.isArray(spans)) throw new require_validate.ItdConfigError("spans должен быть массивом");
+	if (content.length === 0 && spans.length > 0) throw new require_validate.ItdConfigError("Нельзя задать spans без текста: сначала укажите непустой content");
 	return spans.map((span, index) => {
-		if (!span || typeof span !== "object") throw new require_errors.ItdConfigError(`Некорректный span №${index + 1}: ожидался объект`);
+		if (!span || typeof span !== "object") throw new require_validate.ItdConfigError(`Некорректный span №${index + 1}: ожидался объект`);
 		const candidate = span;
-		if (typeof candidate.type !== "string" || !Number.isInteger(candidate.offset) || !Number.isInteger(candidate.length) || (candidate.offset ?? -1) < 0 || (candidate.length ?? 0) <= 0 || (candidate.offset ?? 0) + (candidate.length ?? 0) > content.length) throw new require_errors.ItdConfigError(`Некорректный span №${index + 1}: offset и length должны указывать на непустой фрагмент content`);
+		if (typeof candidate.type !== "string" || !Number.isInteger(candidate.offset) || !Number.isInteger(candidate.length) || (candidate.offset ?? -1) < 0 || (candidate.length ?? 0) <= 0 || (candidate.offset ?? 0) + (candidate.length ?? 0) > content.length) throw new require_validate.ItdConfigError(`Некорректный span №${index + 1}: offset и length должны указывать на непустой фрагмент content`);
 		return { ...candidate };
 	});
 }
@@ -2459,7 +2452,7 @@ function parseHtml(source, options = {}) {
 //#endregion
 //#region src/builders/markup.ts
 function validateMarkup(value) {
-	if (!value || typeof value.content !== "string" || !Array.isArray(value.spans)) throw new require_errors.ItdConfigError("Разметка должна содержать строку content и массив spans");
+	if (!value || typeof value.content !== "string" || !Array.isArray(value.spans)) throw new require_validate.ItdConfigError("Разметка должна содержать строку content и массив spans");
 	return {
 		content: value.content,
 		spans: validateSpans(value.content, value.spans).sort((left, right) => left.offset - right.offset || right.length - left.length)
@@ -2467,7 +2460,7 @@ function validateMarkup(value) {
 }
 function entityName(value, prefix, label) {
 	const name = value.startsWith(prefix) ? value.slice(prefix.length) : value;
-	if (name === "" || /\s/u.test(name)) throw new require_errors.ItdConfigError(`${label} должен быть непустым и не содержать пробелов`);
+	if (name === "" || /\s/u.test(name)) throw new require_validate.ItdConfigError(`${label} должен быть непустым и не содержать пробелов`);
 	return name;
 }
 /**
@@ -2492,7 +2485,7 @@ var MarkupBuilder = class MarkupBuilder {
 	}
 	/** Дописывает переводы строк. */
 	newline(count = 1) {
-		if (!Number.isInteger(count) || count < 0) throw new require_errors.ItdConfigError("Количество переводов строк должно быть целым неотрицательным");
+		if (!Number.isInteger(count) || count < 0) throw new require_validate.ItdConfigError("Количество переводов строк должно быть целым неотрицательным");
 		return this.text("\n".repeat(count));
 	}
 	/** @internal Добавляет готовый фрагмент и сдвигает его spans к текущему концу текста. */
@@ -2501,7 +2494,7 @@ var MarkupBuilder = class MarkupBuilder {
 			content: value,
 			spans: []
 		} : resolveMarkup(value);
-		if (fragment.content.length === 0) throw new require_errors.ItdConfigError("Размечаемый фрагмент не может быть пустым");
+		if (fragment.content.length === 0) throw new require_validate.ItdConfigError("Размечаемый фрагмент не может быть пустым");
 		const offset = this.#content.length;
 		const shifted = fragment.spans.map((span) => ({
 			...span,
@@ -2561,7 +2554,7 @@ var MarkupBuilder = class MarkupBuilder {
 	*/
 	link(content, url) {
 		const resolvedUrl = url ?? (typeof content === "string" ? content : void 0);
-		if (resolvedUrl === void 0) throw new require_errors.ItdConfigError("Для форматированного текста ссылки нужно явно передать URL");
+		if (resolvedUrl === void 0) throw new require_validate.ItdConfigError("Для форматированного текста ссылки нужно явно передать URL");
 		return this.span(content, {
 			type: require_url.SpanType.Link,
 			url: resolvedUrl
@@ -2707,19 +2700,19 @@ const MAX_OPTION_LENGTH = 100;
 */
 function validatePoll(input) {
 	const question = input?.question;
-	if (typeof question !== "string" || question.trim() === "") throw new require_errors.ItdConfigError("Опрос требует непустого вопроса");
-	if (question.trim().length > MAX_QUESTION_LENGTH) throw new require_errors.ItdConfigError(`Вопрос длиннее ${MAX_QUESTION_LENGTH} символов (передано ${question.trim().length})`);
+	if (typeof question !== "string" || question.trim() === "") throw new require_validate.ItdConfigError("Опрос требует непустого вопроса");
+	if (question.trim().length > MAX_QUESTION_LENGTH) throw new require_validate.ItdConfigError(`Вопрос длиннее ${MAX_QUESTION_LENGTH} символов (передано ${question.trim().length})`);
 	const texts = (Array.isArray(input.options) ? input.options : []).map((option, index) => {
 		const text = typeof option?.text === "string" ? option.text.trim() : "";
-		if (text === "") throw new require_errors.ItdConfigError(`Вариант ответа №${index + 1} пуст — у каждого должен быть текст`);
-		if (text.length > MAX_OPTION_LENGTH) throw new require_errors.ItdConfigError(`Вариант ответа №${index + 1} длиннее ${MAX_OPTION_LENGTH} символов (передано ${text.length})`);
+		if (text === "") throw new require_validate.ItdConfigError(`Вариант ответа №${index + 1} пуст — у каждого должен быть текст`);
+		if (text.length > MAX_OPTION_LENGTH) throw new require_validate.ItdConfigError(`Вариант ответа №${index + 1} длиннее ${MAX_OPTION_LENGTH} символов (передано ${text.length})`);
 		return text;
 	});
-	if (texts.length < MIN_OPTIONS) throw new require_errors.ItdConfigError(`Опрос требует минимум ${MIN_OPTIONS} варианта, передано: ${texts.length}`);
-	if (texts.length > MAX_OPTIONS) throw new require_errors.ItdConfigError(`Опрос допускает не больше ${MAX_OPTIONS} вариантов, передано: ${texts.length}`);
+	if (texts.length < MIN_OPTIONS) throw new require_validate.ItdConfigError(`Опрос требует минимум ${MIN_OPTIONS} варианта, передано: ${texts.length}`);
+	if (texts.length > MAX_OPTIONS) throw new require_validate.ItdConfigError(`Опрос допускает не больше ${MAX_OPTIONS} вариантов, передано: ${texts.length}`);
 	const seen = /* @__PURE__ */ new Set();
 	for (const text of texts) {
-		if (seen.has(text)) throw new require_errors.ItdConfigError(`Вариант «${text}» повторяется — варианты должны различаться`);
+		if (seen.has(text)) throw new require_validate.ItdConfigError(`Вариант «${text}» повторяется — варианты должны различаться`);
 		seen.add(text);
 	}
 	return {
@@ -2831,10 +2824,10 @@ function validatePost(input) {
 	const hasContent = content.trim() !== "";
 	const hasAttachments = attachmentIds.length > 0 || files.length > 0;
 	const hasPoll = Boolean(input?.poll);
-	if (!hasContent && !hasAttachments && !hasPoll) throw new require_errors.ItdConfigError("Пост пуст: нужен текст, вложение или опрос");
+	if (!hasContent && !hasAttachments && !hasPoll) throw new require_validate.ItdConfigError("Пост пуст: нужен текст, вложение или опрос");
 	const wallRecipientId = input.wallRecipientId;
 	if (wallRecipientId !== void 0 && wallRecipientId !== null) {
-		if (!UUID_PATTERN.test(wallRecipientId)) throw new require_errors.ItdConfigError(`wallRecipientId должен быть UUID, а не именем пользователя (получено: «${wallRecipientId}»). Идентификатор можно взять из профиля: (await itd.users.get(username)).id`);
+		if (!UUID_PATTERN.test(wallRecipientId)) throw new require_validate.ItdConfigError(`wallRecipientId должен быть UUID, а не именем пользователя (получено: «${wallRecipientId}»). Идентификатор можно взять из профиля: (await itd.users.get(username)).id`);
 	}
 	const { poll: inputPoll, ...data } = input;
 	return {
@@ -3041,17 +3034,17 @@ function resolvePost(input) {
 	return isBuilder(resolved) ? validatePost(resolved.build()) : validatePost(resolved);
 }
 function validatePostUpdate(input) {
-	if (!input || typeof input !== "object") throw new require_errors.ItdConfigError("Для обновления поста нужен объект с явно заданным content");
+	if (!input || typeof input !== "object") throw new require_validate.ItdConfigError("Для обновления поста нужен объект с явно заданным content");
 	const unsupported = [
 		"wallRecipientId",
 		"attachmentIds",
 		"files",
 		"poll"
 	].filter((key) => input[key] !== void 0);
-	if (unsupported.length > 0) throw new require_errors.ItdConfigError(`posts.update изменяет только content и spans; не поддерживаются: ${unsupported.join(", ")}`);
-	if (input.content === void 0) throw new require_errors.ItdConfigError("posts.update требует явно заданный content; обновление одних spans могло бы стереть текст поста");
-	if (typeof input.content !== "string") throw new require_errors.ItdConfigError("content обновляемого поста должен быть строкой");
-	if (input.spans !== void 0 && !Array.isArray(input.spans)) throw new require_errors.ItdConfigError("spans обновляемого поста должен быть массивом");
+	if (unsupported.length > 0) throw new require_validate.ItdConfigError(`posts.update изменяет только content и spans; не поддерживаются: ${unsupported.join(", ")}`);
+	if (input.content === void 0) throw new require_validate.ItdConfigError("posts.update требует явно заданный content; обновление одних spans могло бы стереть текст поста");
+	if (typeof input.content !== "string") throw new require_validate.ItdConfigError("content обновляемого поста должен быть строкой");
+	if (input.spans !== void 0 && !Array.isArray(input.spans)) throw new require_validate.ItdConfigError("spans обновляемого поста должен быть массивом");
 	return {
 		content: input.content,
 		...input.spans !== void 0 ? { spans: validateSpans(input.content, input.spans) } : {}
@@ -3420,9 +3413,9 @@ const TARGET_TYPES = new Set(Object.values(require_url.ReportTargetType));
 * @throws {ItdConfigError} если объект жалобы или причина заданы неверно
 */
 function validateReport(input) {
-	if (!input?.targetId || typeof input.targetId !== "string") throw new require_errors.ItdConfigError("Жалоба требует идентификатор объекта (targetId)");
-	if (!TARGET_TYPES.has(input.targetType)) throw new require_errors.ItdConfigError(`targetType должен быть одним из ${[...TARGET_TYPES].join(", ")}, получено: ${String(input.targetType)}`);
-	if (!REASONS.has(input.reason)) throw new require_errors.ItdConfigError(`Неизвестная причина жалобы «${String(input.reason)}». Допустимые: ${[...REASONS].join(", ")}`);
+	if (!input?.targetId || typeof input.targetId !== "string") throw new require_validate.ItdConfigError("Жалоба требует идентификатор объекта (targetId)");
+	if (!TARGET_TYPES.has(input.targetType)) throw new require_validate.ItdConfigError(`targetType должен быть одним из ${[...TARGET_TYPES].join(", ")}, получено: ${String(input.targetType)}`);
+	if (!REASONS.has(input.reason)) throw new require_validate.ItdConfigError(`Неизвестная причина жалобы «${String(input.reason)}». Допустимые: ${[...REASONS].join(", ")}`);
 	return input;
 }
 /**
@@ -3595,7 +3588,7 @@ var ShopProductsResource = class extends BaseResource {
 				...options
 			});
 		} catch (error) {
-			if (require_errors.isItdApiError(error) && error.status === 404) return null;
+			if (require_validate.isItdApiError(error) && error.status === 404) return null;
 			throw error;
 		}
 	}
@@ -3814,20 +3807,20 @@ var SubscriptionResource = class extends BaseResource {
 const DEFAULT_BATCH_SIZE = 50;
 const SYSTEM_CLOCK = Object.freeze({ now: () => Date.now() });
 function assertNonEmpty(value, name) {
-	if (value.trim().length === 0) throw new require_errors.ItdConfigError(`${name} должен быть непустой строкой`);
+	if (value.trim().length === 0) throw new require_validate.ItdConfigError(`${name} должен быть непустой строкой`);
 }
 function assertFinite(value, name) {
-	if (!Number.isFinite(value)) throw new require_errors.ItdConfigError(`${name} должен быть конечным числом`);
+	if (!Number.isFinite(value)) throw new require_validate.ItdConfigError(`${name} должен быть конечным числом`);
 }
 function assertNonNegative(value, name) {
 	assertFinite(value, name);
-	if (value < 0) throw new require_errors.ItdConfigError(`${name} должен быть неотрицательным числом`);
+	if (value < 0) throw new require_validate.ItdConfigError(`${name} должен быть неотрицательным числом`);
 }
 function validateDwell(entry) {
 	assertNonEmpty(entry.vs, "vs");
 	assertFinite(entry.enterAt, "enterAt");
 	assertFinite(entry.exitAt, "exitAt");
-	if (entry.exitAt < entry.enterAt) throw new require_errors.ItdConfigError("exitAt не может быть раньше enterAt");
+	if (entry.exitAt < entry.enterAt) throw new require_validate.ItdConfigError("exitAt не может быть раньше enterAt");
 	if (entry.durationMs !== void 0) assertNonNegative(entry.durationMs, "durationMs");
 	return { ...entry };
 }
@@ -3836,7 +3829,7 @@ function validateInteraction(entry) {
 	assertNonEmpty(entry.postId, "postId");
 	if (entry.mediaIndex !== void 0) {
 		assertNonNegative(entry.mediaIndex, "mediaIndex");
-		if (!Number.isInteger(entry.mediaIndex)) throw new require_errors.ItdConfigError("mediaIndex должен быть целым числом");
+		if (!Number.isInteger(entry.mediaIndex)) throw new require_validate.ItdConfigError("mediaIndex должен быть целым числом");
 	}
 	if (entry.positionMs !== void 0) assertNonNegative(entry.positionMs, "positionMs");
 	if (entry.durationMs !== void 0) assertNonNegative(entry.durationMs, "durationMs");
@@ -3876,7 +3869,7 @@ var ViewTrackerImpl = class {
 		try {
 			const exitAt = this.#clock.now();
 			assertFinite(exitAt, "clock.now()");
-			if (exitAt < this.enteredAt) throw new require_errors.ItdConfigError("часы не могут вернуться назад во время измерения просмотра");
+			if (exitAt < this.enteredAt) throw new require_validate.ItdConfigError("часы не могут вернуться назад во время измерения просмотра");
 			this.#result = Promise.resolve(this.#submit({
 				...this.#input,
 				enterAt: this.enteredAt,
@@ -3905,7 +3898,7 @@ var TelemetryBatchImpl = class {
 	#disposeCleanup = false;
 	constructor(sendDwell, sendInteraction, options, requestOptions, onClose) {
 		const { maxBatchSize = DEFAULT_BATCH_SIZE, clock = SYSTEM_CLOCK, ...telemetryOptions } = options;
-		if (!Number.isInteger(maxBatchSize) || maxBatchSize < 1) throw new require_errors.ItdConfigError("maxBatchSize должен быть целым числом от 1");
+		if (!Number.isInteger(maxBatchSize) || maxBatchSize < 1) throw new require_validate.ItdConfigError("maxBatchSize должен быть целым числом от 1");
 		this.#sendDwell = sendDwell;
 		this.#sendInteraction = sendInteraction;
 		this.#telemetryOptions = telemetryOptions;
@@ -4009,7 +4002,7 @@ var TelemetryBatchImpl = class {
 		}
 	}
 	#assertOpen() {
-		if (this.#state !== "open") throw new require_errors.ItdConfigError("накопитель телеметрии уже закрывается или закрыт");
+		if (this.#state !== "open") throw new require_validate.ItdConfigError("накопитель телеметрии уже закрывается или закрыт");
 	}
 };
 const TELEMETRY_DISPOSE_CLOSERS = /* @__PURE__ */ new WeakMap();
@@ -4562,15 +4555,15 @@ function fromStream(factory, options = {}) {
 		try {
 			opened = await factory(context);
 		} catch (error) {
-			if (error instanceof require_errors.ItdFileError || error instanceof require_errors.ItdConfigError || context.signal?.aborted) throw error;
-			throw new require_errors.ItdFileError("не удалось открыть поток вложения", {
-				reason: require_errors.ItdFileErrorReason.Read,
+			if (error instanceof require_validate.ItdFileError || error instanceof require_validate.ItdConfigError || context.signal?.aborted) throw error;
+			throw new require_validate.ItdFileError("не удалось открыть поток вложения", {
+				reason: require_validate.ItdFileErrorReason.Read,
 				retryable: true,
 				cause: require_redact.redactErrorCause(error)
 			});
 		}
 		const content = require_options.isReadableByteStream(opened) ? { stream: opened } : opened;
-		if (!content || !require_options.isReadableByteStream(content.stream)) throw new require_errors.ItdConfigError("fromStream должен вернуть ReadableStream или { stream }");
+		if (!content || !require_options.isReadableByteStream(content.stream)) throw new require_validate.ItdConfigError("fromStream должен вернуть ReadableStream или { stream }");
 		const size = options.size ?? content.size;
 		require_options.optionalBytes(size, "size");
 		if (resolved.maxBytes !== void 0 && size !== void 0 && size > resolved.maxBytes) {
@@ -4680,7 +4673,7 @@ var MemoryShopOrderAccessStorage = class {
 /** Создаёт хранилище доступа к заказам поверх `KeyValueStore`. */
 function createShopOrderAccessStorage(store, options = {}) {
 	const key = options.key ?? "shop-order-access";
-	if (typeof key !== "string" || key.length === 0) throw new require_errors.ItdConfigError("ключ хранилища доступа к заказам должен быть непустой строкой");
+	if (typeof key !== "string" || key.length === 0) throw new require_validate.ItdConfigError("ключ хранилища доступа к заказам должен быть непустой строкой");
 	const backend = require_key_value_store.createKeyValueStore(store);
 	return {
 		async get() {
@@ -4702,7 +4695,7 @@ const Operation = Object.freeze({
 });
 function requireEmail(value) {
 	const email = value.trim();
-	if (!email?.includes("@")) throw new require_errors.ItdConfigError("укажите адрес почты");
+	if (!email?.includes("@")) throw new require_validate.ItdConfigError("укажите адрес почты");
 	return email;
 }
 /** Создаёт подключаемый модуль для доступа к заказам по коду из письма. */
@@ -4756,7 +4749,7 @@ function createShopFeature(options = {}) {
 			};
 			const requireSession = async () => {
 				const session = await readSession();
-				if (!session) throw new require_errors.ItdConfigError("доступ к заказам отсутствует или истёк; запросите новый код");
+				if (!session) throw new require_validate.ItdConfigError("доступ к заказам отсутствует или истёк; запросите новый код");
 				return session;
 			};
 			const withAccess = async (run) => {
@@ -4764,7 +4757,7 @@ function createShopFeature(options = {}) {
 				try {
 					return await run(session.token);
 				} catch (error) {
-					if (require_errors.isItdApiError(error) && error.status === 401) await storage.clear();
+					if (require_validate.isItdApiError(error) && error.status === 401) await storage.clear();
 					throw error;
 				}
 			};
@@ -4790,7 +4783,7 @@ function createShopFeature(options = {}) {
 					pendingEmail = normalized;
 				},
 				async verifyCode(code, requestOptions = {}) {
-					if (!pendingEmail) throw new require_errors.ItdConfigError("сначала запросите код для адреса почты");
+					if (!pendingEmail) throw new require_validate.ItdConfigError("сначала запросите код для адреса почты");
 					const verified = await context.request(Operation.VerifyCode, {
 						path: "/api/v1/shop/orders/lookup/verify",
 						body: {
@@ -5258,4 +5251,4 @@ Object.defineProperty(exports, "utcStampToIso", {
 	}
 });
 
-//# sourceMappingURL=render-CYJSDypQ.cjs.map
+//# sourceMappingURL=render-Dnc84B4M.cjs.map