itd-api 0.10.3 → 0.11.0

package/dist/shared/{render-BT74nC1l.js → render-DRh5_aRe.js}

@@ -1,8 +1,8 @@
-import { $ as identityResult, A as SpanType, D as ReportReason, G as isRecord, I as defineBuiltInOperation, J as pickNumber, K as pickArray, O as ReportTargetType, Q as defineOperation, S as InteractionType, X as pickString, Y as pickObject, Z as RetrySafety, c as normalizeNotification, ct as DEFAULT_STATUS_BASE_URL, et as voidResult, ht as createDeadline, lt as STATUS_SERVICE, o as passthroughOperation, q as pickBoolean, rt as mergeService, s as voidOperation } from "./url-DS0-lrl-.js";
-import { _ as ItdStateError, a as ItdConfigError, b as isItdApiError, l as ItdFileError, s as ItdError, t as ItdAbortError, u as ItdFileErrorReason } from "./errors-GI10kZxk.js";
-import { a as redactUrl, b as isBlob, f as encodePathSegment, r as redactErrorCause, x as isFile, y as createDeviceId } from "./redact-DJV0XM3n.js";
-import { a as fileTooLarge, c as FileTransferMode, i as isReadableByteStream, n as boundedFileStream, o as optionalBytes, r as isBoundedFileStream, s as DEFAULT_URL_FILE_MAX_BYTES, t as resolveFileStreamOptions } from "./options-i4LrKfqx.js";
-import { r as createKeyValueStore } from "./key-value-store-Bt2PSMxY.js";
+import { $ as identityResult, A as SpanType, D as ReportReason, G as pickArray, I as defineBuiltInOperation, J as pickObject, K as pickBoolean, O as ReportTargetType, Q as defineOperation, S as InteractionType, X as OperationMethod, Y as pickString, Z as RetrySafety, c as normalizeNotification, ct as DEFAULT_STATUS_BASE_URL, et as voidResult, lt as STATUS_SERVICE, o as passthroughOperation, pt as createDeadline, q as pickNumber, rt as mergeService, s as voidOperation } from "./url-Bg61sk_Y.js";
+import { T as isItdApiError, a as ItdAbortError, d as ItdError, l as ItdConfigError, m as ItdFileErrorReason, n as isRecord, p as ItdFileError, x as ItdStateError } from "./validate-D7_kq3g5.js";
+import { a as redactUrl, b as isBlob, f as encodePathSegment, r as redactErrorCause, x as isFile, y as createDeviceId } from "./redact-C5oxIvcc.js";
+import { a as fileTooLarge, c as FileTransferMode, i as isReadableByteStream, n as boundedFileStream, o as optionalBytes, r as isBoundedFileStream, s as DEFAULT_URL_FILE_MAX_BYTES, t as resolveFileStreamOptions } from "./options-BerKicCs.js";
+import { r as createKeyValueStore } from "./key-value-store-w1Dn5Pjb.js";
 //#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,32 +33,28 @@ 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 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 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);
 		};
 	}
 	/** Регистрирует операцию и возвращает откат регистрации. */
@@ -70,7 +63,7 @@ var ExtensibleOperationCatalog = class {
 		if (!id.startsWith(ownerPrefix) || id.length === ownerPrefix.length) throw new ItdConfigError(`feature «${owner}»: операция «${id}» должна находиться в пространстве имён «${owner}»`);
 		const occupiedBy = this.#operationOwners.get(id);
 		if (occupiedBy !== void 0) throw new ItdConfigError(`feature «${owner}»: операция «${id}» уже зарегистрирована feature «${occupiedBy}»`);
-		if (this.#base.methodOf(id) !== void 0) throw new ItdConfigError(`feature «${owner}»: операция «${id}» уже существует в базовом каталоге`);
+		if (this.#base.definitionOf(id) !== void 0) throw new ItdConfigError(`feature «${owner}»: операция «${id}» уже существует в базовом каталоге`);
 		this.#operationOwners.set(id, owner);
 		this.#operations.set(id, Object.freeze({ ...definition }));
 		return () => {
@@ -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 fileTooLarge(url, maxBytes, blob.size);
-		return blob;
+		return blob.type === type ? blob : new Blob([blob], { type });
 	}
 	const chunks = [];
 	const reader = 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 = resolveFileStreamOptions(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 } : {}
 	};
@@ -416,6 +409,92 @@ function validateFeatureInstallation(name, installation) {
 	if (installation.close !== void 0 && typeof installation.close !== "function") throw new ItdConfigError(`feature «${name}»: close должен быть функцией`);
 	if (installation.dispose !== void 0 && typeof installation.dispose !== "function") throw new 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 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 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 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 {
 	#deps;
@@ -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;
@@ -468,13 +545,7 @@ var FeatureRegistry = class {
 		for (const [rawLocalName, definition] of Object.entries(definitions)) {
 			const localName = requireName(rawLocalName, `Операция feature «${featureName}»`);
 			if (typeof definition !== "object" || definition === null) throw new ItdConfigError(`feature «${featureName}»: операция «${localName}» должна быть объектом`);
-			if (![
-				"GET",
-				"POST",
-				"PUT",
-				"PATCH",
-				"DELETE"
-			].includes(definition.method)) throw new ItdConfigError(`feature «${featureName}»: операция «${localName}» содержит неизвестный HTTP-метод`);
+			if (!Object.values(OperationMethod).includes(definition.method)) throw new ItdConfigError(`feature «${featureName}»: операция «${localName}» содержит неизвестный HTTP-метод`);
 			if (!Object.values(RetrySafety).includes(definition.retrySafety)) throw new ItdConfigError(`feature «${featureName}»: операция «${localName}» содержит неизвестную retrySafety`);
 			if (definition.service !== void 0 && typeof definition.service !== "string") throw new ItdConfigError(`feature «${featureName}»: service операции «${localName}» должен быть строкой`);
 			if (definition.bucket !== void 0 && typeof definition.bucket !== "string") throw new ItdConfigError(`feature «${featureName}»: bucket операции «${localName}» должен быть строкой`);
@@ -509,95 +580,18 @@ var FeatureRegistry = class {
 		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 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 ItdStateError(`feature «${name}» не активен`);
-						const resolved = operations.get(operation);
-						if (!resolved) throw new 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 ItdConfigError(`feature «${name}» не объявляет сервис «${serviceName}»`);
-					return this.#deps.services.resolveBaseUrl(serviceName);
-				},
-				connection: (serviceName) => {
-					if (!services.has(serviceName)) throw new ItdConfigError(`feature «${name}» не объявляет сервис «${serviceName}»`);
-					return this.#deps.connection(serviceName);
-				},
-				manage: (resource) => {
-					this.#deps.assertActive(`зарегистрировать ресурс feature «${name}»`);
-					if (controller.signal.aborted) throw new 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 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 ItdAbortError(`Установка feature «${name}» отменена`));
 			transaction.rollback((rollbackError) => {
-				reportRollbackError(`Не удалось полностью откатить feature «${name}»`, rollbackError);
+				reportRollbackError(this.#deps.logger, `Не удалось полностью откатить feature «${name}»`, rollbackError);
 			});
 			throw error;
 		}
@@ -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) {
@@ -5037,4 +5030,4 @@ function renderSpans(content, spans = [], options = {}) {
 //#endregion
 export { utcStampToIso as A, AUDIO_MIME_TYPES as C, isBuilder as D, comment as E, mapPage as F, createFeatureHost as I, ExtensibleOperationCatalog as L, BaseResource as M, PaginationMode as N, createStatusFeature as O, Paginator as P, ALLOWED_MIME_TYPES as S, VIDEO_MIME_TYPES as T, poll as _, createShopOrderAccessStorage as a, parseHtml as b, ShopOrderStatus as c, isMyProfile as d, fromStream as f, post as g, report as h, MemoryShopOrderAccessStorage as i, NotificationsResource as j, toDate as k, ShopProductCategory as l, createResources as m, renderSpans as n, statusDays as o, fromUrl as p, createShopFeature as r, ShopConsentKind as s, SpanRenderFormat as t, ShopProductStatus as u, autoSpans as v, IMAGE_MIME_TYPES as w, parseMarkdown as x, markup as y };
 
-//# sourceMappingURL=render-BT74nC1l.js.map
+//# sourceMappingURL=render-DRh5_aRe.js.map