itd-api 0.9.0 → 0.9.2

package/dist/shared/{render-Dqi8Owqk.cjs → render-DqVzx68r.cjs}

@@ -1,7 +1,7 @@
-const require_url = require("./url-Bsb3xE5U.cjs");
+const require_url = require("./url-Doc0XXW_.cjs");
 const require_errors = require("./errors-BmP3TKoW.cjs");
-const require_redact = require("./redact-BP00URmQ.cjs");
-const require_options = require("./options-DOJYtoti.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");
 //#region src/core/feature-catalog.ts
 /**
@@ -370,6 +370,22 @@ function createFileResolver(fetchImplementation) {
 }
 //#endregion
 //#region src/core/features.ts
+var FeatureInstallationTransaction = class {
+	#cleanup = [];
+	add(cleanup) {
+		this.#cleanup.push(cleanup);
+	}
+	snapshot() {
+		return [...this.#cleanup];
+	}
+	rollback(reportError) {
+		for (let index = this.#cleanup.length - 1; index >= 0; index -= 1) try {
+			this.#cleanup[index]?.();
+		} catch (error) {
+			reportError(error);
+		}
+	}
+};
 function requireName(value, kind) {
 	if (typeof value !== "string" || value.trim() === "") throw new require_errors.ItdConfigError(`${kind} должен иметь непустое имя`);
 	return value.trim();
@@ -385,6 +401,21 @@ function validateBucket(owner, localName, bucket) {
 	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}» должен быть положительным числом`);
 }
+function validateFeatureDefinition(feature, isInstalled) {
+	if (typeof feature !== "object" || feature === null) throw new require_errors.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 должен быть объектом`);
+	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 должен быть функцией`);
+}
 /** Реестр подключаемых модулей клиента. @internal */
 var FeatureRegistry = class {
 	#deps;
@@ -394,20 +425,89 @@ var FeatureRegistry = class {
 	constructor(deps) {
 		this.#deps = deps;
 	}
-	install(feature) {
-		this.#deps.assertActive("установить feature");
-		if (this.#disposed) throw new require_errors.ItdStateError("Реестр feature уже освобождён");
-		if (typeof feature !== "object" || feature === null) throw new require_errors.ItdConfigError("feature должен быть объектом");
-		const name = requireFeatureName(feature.name);
-		if (this.#features.has(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 должен быть объектом`);
-		const rollback = [];
+	#registerServices(featureName, definitions, transaction) {
 		const services = /* @__PURE__ */ new Set();
+		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 (!this.#deps.services.has(serviceName)) {
+				this.#deps.services.define(service);
+				transaction.add(() => void this.#deps.services.delete(serviceName));
+			} else {
+				const override = this.#deps.serviceOverrides.find((candidate) => candidate.name.trim() === serviceName);
+				if (override) {
+					const previous = this.#deps.services.replace(require_url.mergeService(service, override));
+					transaction.add(() => void this.#deps.services.replace(previous));
+				}
+			}
+			this.#serviceOwners.set(serviceName, featureName);
+			transaction.add(() => {
+				if (this.#serviceOwners.get(serviceName) === featureName) this.#serviceOwners.delete(serviceName);
+			});
+			services.add(serviceName);
+		}
+		return services;
+	}
+	#registerBuckets(featureName, definitions, transaction) {
 		const bucketNames = /* @__PURE__ */ new Map();
+		for (const [rawLocalName, bucket] of Object.entries(definitions)) {
+			const localName = requireName(rawLocalName, `Бакет feature «${featureName}»`);
+			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;
+	}
+	#registerOperations(featureName, definitions, services, bucketNames, transaction) {
 		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}»`);
+			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}»`);
+			const operationId = `${featureName}.${localName}`;
+			const contract = require_url.defineOperation(operationId, {
+				method: definition.method,
+				retrySafety: definition.retrySafety,
+				bucket,
+				...definition.annotations === void 0 ? {} : { annotations: definition.annotations }
+			}, definition.read ?? require_url.identityResult);
+			transaction.add(this.#deps.catalog.registerOperation(featureName, operationId, {
+				method: contract.method,
+				retrySafety: contract.retrySafety,
+				bucket,
+				...contract.annotations === void 0 ? {} : { annotations: contract.annotations }
+			}));
+			operations.set(localName, {
+				contract,
+				service: definition.service
+			});
+		}
+		return operations;
+	}
+	install(feature) {
+		this.#deps.assertActive("установить feature");
+		if (this.#disposed) throw new require_errors.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) => {
@@ -416,74 +516,9 @@ var FeatureRegistry = class {
 			} catch {}
 		};
 		try {
-			for (const service of feature.services ?? []) {
-				const serviceName = requireName(service?.name, `Сервис feature «${name}»`);
-				const owner = this.#serviceOwners.get(serviceName);
-				if (owner !== void 0) throw new require_errors.ItdConfigError(`feature «${name}»: сервис «${serviceName}» уже принадлежит feature «${owner}»`);
-				if (services.has(serviceName)) throw new require_errors.ItdConfigError(`feature «${name}»: сервис «${serviceName}» объявлен повторно`);
-				if (!this.#deps.services.has(serviceName)) {
-					this.#deps.services.define(service);
-					rollback.push(() => void this.#deps.services.delete(serviceName));
-				} else {
-					const override = this.#deps.serviceOverrides.find((candidate) => candidate.name.trim() === serviceName);
-					if (override) {
-						const previous = this.#deps.services.replace(require_url.mergeService(service, override));
-						rollback.push(() => void this.#deps.services.replace(previous));
-					}
-				}
-				this.#serviceOwners.set(serviceName, name);
-				rollback.push(() => {
-					if (this.#serviceOwners.get(serviceName) === name) this.#serviceOwners.delete(serviceName);
-				});
-				services.add(serviceName);
-			}
-			for (const [rawLocalName, bucket] of Object.entries(feature.buckets ?? {})) {
-				const localName = requireName(rawLocalName, `Бакет feature «${name}»`);
-				validateBucket(name, localName, bucket);
-				const globalName = `feature:${name}/${localName}`;
-				const unregisterCatalog = this.#deps.catalog.registerBucket(name, globalName, bucket);
-				rollback.push(unregisterCatalog);
-				const unregisterQueue = this.#deps.registerBucket(globalName, bucket);
-				if (unregisterQueue) rollback.push(unregisterQueue);
-				bucketNames.set(localName, globalName);
-			}
-			for (const [rawLocalName, definition] of Object.entries(feature.operations)) {
-				const localName = requireName(rawLocalName, `Операция feature «${name}»`);
-				if (typeof definition !== "object" || definition === null) throw new require_errors.ItdConfigError(`feature «${name}»: операция «${localName}» должна быть объектом`);
-				if (![
-					"GET",
-					"POST",
-					"PUT",
-					"PATCH",
-					"DELETE"
-				].includes(definition.method)) throw new require_errors.ItdConfigError(`feature «${name}»: операция «${localName}» содержит неизвестный HTTP-метод`);
-				if (!Object.values(require_url.RetrySafety).includes(definition.retrySafety)) throw new require_errors.ItdConfigError(`feature «${name}»: операция «${localName}» содержит неизвестную retrySafety`);
-				if (definition.service !== void 0 && typeof definition.service !== "string") throw new require_errors.ItdConfigError(`feature «${name}»: service операции «${localName}» должен быть строкой`);
-				if (definition.bucket !== void 0 && typeof definition.bucket !== "string") throw new require_errors.ItdConfigError(`feature «${name}»: bucket операции «${localName}» должен быть строкой`);
-				if (definition.read !== void 0 && typeof definition.read !== "function") throw new require_errors.ItdConfigError(`feature «${name}»: read операции «${localName}» должна быть функцией`);
-				if (definition.annotations !== void 0 && (typeof definition.annotations !== "object" || definition.annotations === null || Array.isArray(definition.annotations))) throw new require_errors.ItdConfigError(`feature «${name}»: annotations операции «${localName}» должны быть объектом`);
-				if (definition.service !== void 0 && !services.has(definition.service)) throw new require_errors.ItdConfigError(`feature «${name}»: операция «${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 «${name}»: операция «${localName}» ссылается на необъявленный бакет «${definition.bucket}»`);
-				const operationId = `${name}.${localName}`;
-				const contract = require_url.defineOperation(operationId, {
-					method: definition.method,
-					retrySafety: definition.retrySafety,
-					bucket,
-					...definition.annotations === void 0 ? {} : { annotations: definition.annotations }
-				}, definition.read ?? require_url.identityResult);
-				const unregister = this.#deps.catalog.registerOperation(name, operationId, {
-					method: contract.method,
-					retrySafety: contract.retrySafety,
-					bucket,
-					...contract.annotations === void 0 ? {} : { annotations: contract.annotations }
-				});
-				rollback.push(unregister);
-				operations.set(localName, {
-					contract,
-					service: definition.service
-				});
-			}
+			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,
@@ -538,7 +573,7 @@ var FeatureRegistry = class {
 						registered = false;
 						unregister();
 					};
-					if (!committed) rollback.push(() => {
+					if (!committed) transaction.add(() => {
 						if (!registered) return;
 						if (committed) {
 							release();
@@ -563,21 +598,21 @@ var FeatureRegistry = class {
 				}
 			});
 			const installation = feature.setup(context);
-			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 должен быть функцией`);
+			validateFeatureInstallation(name, installation);
 			this.#features.set(name, {
 				name,
 				controller,
 				close: installation.close,
 				dispose: installation.dispose,
-				cleanup: [...rollback]
+				cleanup: transaction.snapshot()
 			});
 			committed = true;
 			return installation.api;
 		} catch (error) {
 			controller.abort(new require_errors.ItdAbortError(`Установка feature «${name}» отменена`));
-			for (const undo of rollback.reverse()) undo();
+			transaction.rollback((rollbackError) => {
+				reportRollbackError(`Не удалось полностью откатить feature «${name}»`, rollbackError);
+			});
 			throw error;
 		}
 	}
@@ -1461,7 +1496,7 @@ function resolveComment(input, allowReplyTo = false) {
 const COMMENTS_REPLIES = pageOperation("comments.replies", (body) => readPagedPage(body, "replies"));
 const COMMENTS_REPLY = require_url.passthroughOperation("comments.reply");
 const COMMENTS_UPDATE = require_url.passthroughOperation("comments.update");
-const COMMENTS_RESTORE = require_url.passthroughOperation("comments.restore");
+const COMMENTS_RESTORE = require_url.voidOperation("comments.restore");
 const COMMENTS_LIKE = require_url.passthroughOperation("comments.like");
 const COMMENTS_UNLIKE = require_url.passthroughOperation("comments.unlike");
 const COMMENTS_REMOVE = require_url.voidOperation("comments.remove");
@@ -1544,7 +1579,7 @@ var CommentsResource = class extends BaseResource {
 	}
 	/** Восстанавливает удалённый комментарий. */
 	restore(commentId, options = {}) {
-		return this.http.execute(COMMENTS_RESTORE, {
+		return this.voidOperation(COMMENTS_RESTORE, {
 			path: `/api/comments/${require_redact.encodePathSegment(commentId, "commentId")}/restore`,
 			...options
 		});
@@ -3056,7 +3091,7 @@ const POSTS_STATS = require_url.defineBuiltInOperation("posts.stats", (body) =>
 const POSTS_CREATE = require_url.passthroughOperation("posts.create");
 const POSTS_GET = require_url.passthroughOperation("posts.get");
 const POSTS_UPDATE = require_url.passthroughOperation("posts.update");
-const POSTS_RESTORE = require_url.passthroughOperation("posts.restore");
+const POSTS_RESTORE = require_url.voidOperation("posts.restore");
 const POSTS_LIKE = require_url.passthroughOperation("posts.like");
 const POSTS_UNLIKE = require_url.passthroughOperation("posts.unlike");
 const POSTS_REPOST = require_url.passthroughOperation("posts.repost");
@@ -3213,7 +3248,7 @@ var PostsResource = class extends BaseResource {
 	}
 	/** Восстанавливает удалённый пост. */
 	restore(postId, options = {}) {
-		return this.http.execute(POSTS_RESTORE, {
+		return this.voidOperation(POSTS_RESTORE, {
 			path: `/api/posts/${require_redact.encodePathSegment(postId, "postId")}/restore`,
 			...options
 		});
@@ -4684,10 +4719,6 @@ function createShopOrderAccessStorage(store, options = {}) {
 		clear: () => backend.delete(key)
 	};
 }
-/** Создаёт независимое хранилище доступа к заказам в памяти. */
-function createMemoryShopOrderAccessStorage() {
-	return createShopOrderAccessStorage(new require_key_value_store.MemoryKeyValueStore());
-}
 //#endregion
 //#region src/shop/feature.ts
 const Operation = Object.freeze({
@@ -4742,7 +4773,7 @@ function createShopFeature(options = {}) {
 			}
 		},
 		setup(context) {
-			const storage = options.storage ?? createMemoryShopOrderAccessStorage();
+			const storage = options.storage ?? new MemoryShopOrderAccessStorage();
 			let pendingEmail = null;
 			const readSession = async () => {
 				const session = await storage.get();
@@ -5140,12 +5171,6 @@ Object.defineProperty(exports, "createFeatureHost", {
 		return createFeatureHost;
 	}
 });
-Object.defineProperty(exports, "createMemoryShopOrderAccessStorage", {
-	enumerable: true,
-	get: function() {
-		return createMemoryShopOrderAccessStorage;
-	}
-});
 Object.defineProperty(exports, "createResources", {
 	enumerable: true,
 	get: function() {
@@ -5261,4 +5286,4 @@ Object.defineProperty(exports, "utcStampToIso", {
 	}
 });
 
-//# sourceMappingURL=render-Dqi8Owqk.cjs.map
+//# sourceMappingURL=render-DqVzx68r.cjs.map