itd-api 0.9.1 → 0.9.3

package/dist/shared/{render-sb1VJhUA.js → render-CtOpp9Pm.js}

@@ -1,8 +1,8 @@
-import { B as isRecord, C as ReportReason, E as SpanType, G as pickString, H as pickBoolean, J as identityResult, K as RetrySafety, M as defineBuiltInOperation, U as pickNumber, V as pickArray, W as pickObject, X as mergeService, Y as voidResult, c as normalizeNotification, ct as createDeadline, nt as STATUS_SERVICE, o as passthroughOperation, q as defineOperation, s as voidOperation, tt as DEFAULT_STATUS_BASE_URL, w as ReportTargetType, y as InteractionType } from "./url-Dsr4c5r5.js";
+import { B as isRecord, C as ReportReason, E as SpanType, G as pickString, H as pickBoolean, J as identityResult, K as RetrySafety, M as defineBuiltInOperation, U as pickNumber, V as pickArray, W as pickObject, X as mergeService, Y as voidResult, c as normalizeNotification, ct as createDeadline, nt as STATUS_SERVICE, o as passthroughOperation, q as defineOperation, s as voidOperation, tt as DEFAULT_STATUS_BASE_URL, w as ReportTargetType, y as InteractionType } from "./url-3Ts6EEHQ.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 isFile, d as encodePathSegment, r as redactErrorCause, v as createDeviceId, y as isBlob } from "./redact-Ba5iSVYZ.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-DhgGg7Ms.js";
-import { r as createKeyValueStore, t as MemoryKeyValueStore } from "./key-value-store-Bt2PSMxY.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";
 //#region src/core/feature-catalog.ts
 /**
 * Изменяемый слой над каталогом конкретного API.
@@ -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 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 ItdConfigError(`feature «${owner}»: concurrency бакета «${localName}» должен быть целым числом от 1`);
 	if (bucket.rps !== void 0 && (!Number.isFinite(bucket.rps) || bucket.rps <= 0)) throw new ItdConfigError(`feature «${owner}»: rps бакета «${localName}» должен быть положительным числом`);
 }
+function validateFeatureDefinition(feature, isInstalled) {
+	if (typeof feature !== "object" || feature === null) throw new ItdConfigError("feature должен быть объектом");
+	const name = requireFeatureName(feature.name);
+	if (isInstalled(name)) throw new ItdConfigError(`feature «${name}» уже установлен`);
+	if (typeof feature.setup !== "function") throw new ItdConfigError(`feature «${name}» должен предоставлять setup()`);
+	if (typeof feature.operations !== "object" || feature.operations === null || Array.isArray(feature.operations)) throw new ItdConfigError(`feature «${name}» должен объявлять operations`);
+	if (feature.services !== void 0 && !Array.isArray(feature.services)) throw new ItdConfigError(`feature «${name}»: services должен быть массивом`);
+	if (feature.buckets !== void 0 && (typeof feature.buckets !== "object" || feature.buckets === null || Array.isArray(feature.buckets))) throw new ItdConfigError(`feature «${name}»: buckets должен быть объектом`);
+	return name;
+}
+function validateFeatureInstallation(name, installation) {
+	if (typeof installation !== "object" || installation === null || !("api" in installation)) throw new ItdConfigError(`setup() feature «${name}» должен вернуть объект с полем api`);
+	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 должен быть функцией`);
+}
 /** Реестр подключаемых модулей клиента. @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 ItdStateError("Реестр feature уже освобождён");
-		if (typeof feature !== "object" || feature === null) throw new ItdConfigError("feature должен быть объектом");
-		const name = requireFeatureName(feature.name);
-		if (this.#features.has(name)) throw new ItdConfigError(`feature «${name}» уже установлен`);
-		if (typeof feature.setup !== "function") throw new ItdConfigError(`feature «${name}» должен предоставлять setup()`);
-		if (typeof feature.operations !== "object" || feature.operations === null || Array.isArray(feature.operations)) throw new ItdConfigError(`feature «${name}» должен объявлять operations`);
-		if (feature.services !== void 0 && !Array.isArray(feature.services)) throw new ItdConfigError(`feature «${name}»: services должен быть массивом`);
-		if (feature.buckets !== void 0 && (typeof feature.buckets !== "object" || feature.buckets === null || Array.isArray(feature.buckets))) throw new 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 ItdConfigError(`feature «${featureName}»: сервис «${serviceName}» уже принадлежит feature «${owner}»`);
+			if (services.has(serviceName)) throw new 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(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 ItdConfigError(`feature «${featureName}»: операция «${localName}» должна быть объектом`);
+			if (![
+				"GET",
+				"POST",
+				"PUT",
+				"PATCH",
+				"DELETE"
+			].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}» должен быть строкой`);
+			if (definition.read !== void 0 && typeof definition.read !== "function") throw new ItdConfigError(`feature «${featureName}»: read операции «${localName}» должна быть функцией`);
+			if (definition.annotations !== void 0 && (typeof definition.annotations !== "object" || definition.annotations === null || Array.isArray(definition.annotations))) throw new ItdConfigError(`feature «${featureName}»: annotations операции «${localName}» должны быть объектом`);
+			if (definition.service !== void 0 && !services.has(definition.service)) throw new 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 ItdConfigError(`feature «${featureName}»: операция «${localName}» ссылается на необъявленный бакет «${definition.bucket}»`);
+			const operationId = `${featureName}.${localName}`;
+			const contract = defineOperation(operationId, {
+				method: definition.method,
+				retrySafety: definition.retrySafety,
+				bucket,
+				...definition.annotations === void 0 ? {} : { annotations: definition.annotations }
+			}, definition.read ?? 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 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 ItdConfigError(`feature «${name}»: сервис «${serviceName}» уже принадлежит feature «${owner}»`);
-				if (services.has(serviceName)) throw new 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(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 ItdConfigError(`feature «${name}»: операция «${localName}» должна быть объектом`);
-				if (![
-					"GET",
-					"POST",
-					"PUT",
-					"PATCH",
-					"DELETE"
-				].includes(definition.method)) throw new ItdConfigError(`feature «${name}»: операция «${localName}» содержит неизвестный HTTP-метод`);
-				if (!Object.values(RetrySafety).includes(definition.retrySafety)) throw new ItdConfigError(`feature «${name}»: операция «${localName}» содержит неизвестную retrySafety`);
-				if (definition.service !== void 0 && typeof definition.service !== "string") throw new ItdConfigError(`feature «${name}»: service операции «${localName}» должен быть строкой`);
-				if (definition.bucket !== void 0 && typeof definition.bucket !== "string") throw new ItdConfigError(`feature «${name}»: bucket операции «${localName}» должен быть строкой`);
-				if (definition.read !== void 0 && typeof definition.read !== "function") throw new ItdConfigError(`feature «${name}»: read операции «${localName}» должна быть функцией`);
-				if (definition.annotations !== void 0 && (typeof definition.annotations !== "object" || definition.annotations === null || Array.isArray(definition.annotations))) throw new ItdConfigError(`feature «${name}»: annotations операции «${localName}» должны быть объектом`);
-				if (definition.service !== void 0 && !services.has(definition.service)) throw new 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 ItdConfigError(`feature «${name}»: операция «${localName}» ссылается на необъявленный бакет «${definition.bucket}»`);
-				const operationId = `${name}.${localName}`;
-				const contract = defineOperation(operationId, {
-					method: definition.method,
-					retrySafety: definition.retrySafety,
-					bucket,
-					...definition.annotations === void 0 ? {} : { annotations: definition.annotations }
-				}, definition.read ?? 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 ItdConfigError(`setup() feature «${name}» должен вернуть объект с полем api`);
-			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 должен быть функцией`);
+			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 ItdAbortError(`Установка feature «${name}» отменена`));
-			for (const undo of rollback.reverse()) undo();
+			transaction.rollback((rollbackError) => {
+				reportRollbackError(`Не удалось полностью откатить feature «${name}»`, rollbackError);
+			});
 			throw error;
 		}
 	}
@@ -1819,7 +1854,6 @@ var FilesResource = class extends BaseResource {
 //#endregion
 //#region src/resources/hashtags.ts
 const HASHTAG_POSTS = pageOperation("hashtags.posts", (body) => readCursorPage(body, "posts"));
-const HASHTAGS_SEARCH = defineBuiltInOperation("hashtags.search", (body) => pickArray(body, "hashtags"));
 const HASHTAGS_TRENDING = defineBuiltInOperation("hashtags.trending", (body) => pickArray(body, "hashtags"));
 /**
 * Хэштеги.
@@ -1835,21 +1869,6 @@ var HashtagsResource = class extends BaseResource {
 		start: (p) => p.cursor ? { cursor: p.cursor } : {},
 		mode: PaginationMode.Cursor
 	});
-	/**
-	* Ищет хэштеги.
-	*
-	* Без строки запроса возвращает общий список.
-	*/
-	search(query, params = {}, options = {}) {
-		return this.http.execute(HASHTAGS_SEARCH, {
-			path: "/api/hashtags",
-			query: {
-				q: query,
-				limit: params.limit
-			},
-			...options
-		});
-	}
 	/** Загружает трендовые хэштеги. */
 	trending(params = {}, options = {}) {
 		return this.http.execute(HASHTAGS_TRENDING, {
@@ -4121,7 +4140,6 @@ const USER_LIST_OPERATIONS = {
 	"users.blocked": userListOperation("users.blocked")
 };
 const USERS_CHECK_USERNAME = defineBuiltInOperation("users.checkUsername", (body) => pickBoolean(body, "available"));
-const USERS_SEARCH = defineBuiltInOperation("users.search", (body) => pickArray(body, "users"));
 const USERS_WHO_TO_FOLLOW = defineBuiltInOperation("users.whoToFollow", (body) => pickArray(body, "users"));
 const USERS_TOP_CLANS = defineBuiltInOperation("users.topClans", (body) => pickArray(body, "clans"));
 const USERS_PINS = defineBuiltInOperation("users.pins", (body) => ({
@@ -4250,17 +4268,6 @@ var UsersResource = class extends BaseResource {
 			...options
 		});
 	}
-	/** Ищет пользователей по строке запроса. */
-	search(query, params = {}, options = {}) {
-		return this.http.execute(USERS_SEARCH, {
-			path: "/api/users/search",
-			query: {
-				q: query,
-				limit: params.limit
-			},
-			...options
-		});
-	}
 	/** Загружает рекомендации, на кого подписаться. */
 	whoToFollow(options = {}) {
 		return this.http.execute(USERS_WHO_TO_FOLLOW, {
@@ -4684,10 +4691,6 @@ function createShopOrderAccessStorage(store, options = {}) {
 		clear: () => backend.delete(key)
 	};
 }
-/** Создаёт независимое хранилище доступа к заказам в памяти. */
-function createMemoryShopOrderAccessStorage() {
-	return createShopOrderAccessStorage(new MemoryKeyValueStore());
-}
 //#endregion
 //#region src/shop/feature.ts
 const Operation = Object.freeze({
@@ -4742,7 +4745,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();
@@ -5032,6 +5035,6 @@ function renderSpans(content, spans = [], options = {}) {
 	return result;
 }
 //#endregion
-export { toDate as A, ALLOWED_MIME_TYPES as C, comment as D, VIDEO_MIME_TYPES as E, Paginator as F, mapPage as I, createFeatureHost as L, NotificationsResource as M, BaseResource as N, isBuilder as O, PaginationMode as P, ExtensibleOperationCatalog as R, parseMarkdown as S, IMAGE_MIME_TYPES as T, post as _, createMemoryShopOrderAccessStorage as a, markup as b, ShopConsentKind as c, ShopProductStatus as d, isMyProfile as f, report as g, createResources as h, MemoryShopOrderAccessStorage as i, utcStampToIso as j, createStatusFeature as k, ShopOrderStatus as l, fromUrl as m, renderSpans as n, createShopOrderAccessStorage as o, fromStream as p, createShopFeature as r, statusDays as s, SpanRenderFormat as t, ShopProductCategory as u, poll as v, AUDIO_MIME_TYPES as w, parseHtml as x, autoSpans as y };
+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-sb1VJhUA.js.map
+//# sourceMappingURL=render-CtOpp9Pm.js.map