itd-api 0.7.1 → 0.7.2

package/README.md

@@ -14,6 +14,7 @@
 [![Node.js](https://img.shields.io/node/v/itd-api.svg)](https://www.npmjs.com/package/itd-api)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.0%2B-3178c6.svg)](./tsconfig.json)
 [![license](https://img.shields.io/npm/l/itd-api.svg)](./LICENSE)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/KiowDev/itd-api)
 
 Независимый TypeScript-клиент REST и realtime API социальной сети **итд.com**.
 Проект не является официальным SDK и не аффилирован с итд.com.
@@ -145,8 +146,7 @@ TypeScript 5.0+. Пакет проверяется в Node.js 18, 20, 22, 24 и
 
 ## Проект
 
-- [DeepWiki по исходному коду](https://deepwiki.com/KiowDev/itd-api) — автоматический разбор
-  репозитория с ответами на вопросы про внутреннее устройство
+- [DeepWiki по исходному коду](https://deepwiki.com/KiowDev/itd-api) — можно задать любые вопросы нейронке
 - [CI](https://github.com/KiowDev/itd-api/actions/workflows/ci.yml)
 - [История релизов](https://github.com/KiowDev/itd-api/releases)
 - [Как внести вклад](./.github/CONTRIBUTING.md)

package/dist/index.cjs

@@ -1,10 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_url = require("./shared/url-yjl2c8Ie.cjs");
+const require_url = require("./shared/url-BaMCQpYH.cjs");
 const require_errors = require("./shared/errors-DfU8M5eS.cjs");
 const require_cookies = require("./shared/cookies-DZwFq6kr.cjs");
-const require_websocket = require("./shared/websocket-sYlynrr0.cjs");
+const require_render = require("./shared/render-mcuELiYi.cjs");
+const require_websocket = require("./shared/websocket-C_eI4H2o.cjs");
 const require_storage = require("./shared/storage-BPJR_k4-.cjs");
-const require_render = require("./shared/render-DyeHJNBw.cjs");
 const require_options = require("./shared/options-Dg5N3r1V.cjs");
 const require_multi_storage = require("./shared/multi-storage--yTEqiod.cjs");
 //#region src/session/jwt.ts
@@ -1013,6 +1013,7 @@ function createManagedClient(options, internals) {
 */
 var ItdClient = class ItdClient {
 	#runtime;
+	#features;
 	/** Порождённые потоки уведомлений — чтобы `close()` мог закрыть их разом. */
 	#streams = /* @__PURE__ */ new Set();
 	/** Общий результат терминальной очистки для идемпотентных повторных вызовов. */
@@ -1076,8 +1077,9 @@ var ItdClient = class ItdClient {
 	}
 	constructor(options = {}) {
 		const internals = CLIENT_INTERNALS.get(options) ?? {};
+		const catalog = new require_render.ExtensibleOperationCatalog(require_url.ITD_CATALOG);
 		this.#runtime = require_url.createClientRuntime(options, {
-			catalog: require_url.ITD_CATALOG,
+			catalog,
 			queues: internals.queues,
 			assertActive: (action) => assertClientActive(this, action),
 			auth: (deps) => createItdAuth(options, {
@@ -1085,9 +1087,22 @@ var ItdClient = class ItdClient {
 				onAccountChange: () => this.#disconnectStreams()
 			})
 		});
+		this.#features = new require_render.FeatureRegistry({
+			http: this.#runtime.http,
+			services: this.#runtime.services,
+			serviceOverrides: this.#runtime.config.services,
+			catalog,
+			baseUrl: this.#runtime.config.baseUrl,
+			clock: this.#runtime.config.clock,
+			logger: this.#runtime.config.logger,
+			assertActive: (action) => assertClientActive(this, action),
+			registerBucket: (name, definition) => this.#runtime.registerRateLimitBucket(name, definition)
+		});
+		const status = this.#features.install(require_render.createStatusFeature());
 		this.#resources = require_render.createResources({
 			http: this.#runtime.http,
-			fetch: this.#runtime.config.fetch
+			fetch: this.#runtime.config.fetch,
+			status
 		});
 		CLIENT_PLUGIN_REGISTRIES.set(this, this.#runtime.plugins);
 	}
@@ -1131,6 +1146,43 @@ var ItdClient = class ItdClient {
 		return this.#runtime.rateLimitState();
 	}
 	/**
+	* Устанавливает предметный модуль поверх общей сессии и request pipeline клиента.
+	*
+	* Сервисы, операции и бакеты feature регистрируются до синхронного `setup()`. Возвращаемое
+	* значение — типизированный API модуля; повторное имя feature отклоняется.
+	*/
+	install(feature) {
+		return this.#features.install(feature);
+	}
+	/**
+	* Устанавливает feature и публикует его API как readonly-свойство этого же клиента.
+	*
+	* Возвращаемое пересечение сохраняет тип уже подключённых свойств, поэтому вызовы можно
+	* объединять в цепочку: `new ItdClient().withFeature('chats', chatsFeature)`.
+	*/
+	withFeature(key, feature) {
+		assertClientActive(this, "установить feature");
+		if (typeof key !== "string" || key.trim() === "" || key !== key.trim()) throw new require_errors.ItdConfigError("Свойство feature должно иметь непустое имя без краевых пробелов");
+		if (key === "then" || key in this) throw new require_errors.ItdConfigError(`Свойство клиента «${key}» уже занято или зарезервировано`);
+		if (!Object.isExtensible(this)) throw new require_errors.ItdConfigError("Нельзя опубликовать feature на нерасширяемом клиенте");
+		const api = this.install(feature);
+		Object.defineProperty(this, key, {
+			value: api,
+			enumerable: true,
+			configurable: false,
+			writable: false
+		});
+		return this;
+	}
+	/** Имена установленных feature в порядке установки. */
+	featureNames() {
+		return this.#features.names();
+	}
+	/** Установлен ли feature с таким именем. */
+	hasFeature(name) {
+		return this.#features.has(name);
+	}
+	/**
 	* Подключает плагин.
 	*
 	* Плагин может независимо регистрировать transformer логической операции и interceptor
@@ -1310,14 +1362,30 @@ var ItdClient = class ItdClient {
 		const { shutdownTimeout, clock } = this.#runtime.config;
 		const deadline = require_url.createDeadline(shutdownTimeout, clock);
 		let stuck = [];
+		const errors = [];
 		try {
-			stuck = (await Promise.all(streams.map(async (stream) => await deadline.wait(stream.drain()) ? void 0 : stream))).filter((stream) => stream !== void 0);
-			await this.#resources.closeTelemetry(disposeCleanup);
+			try {
+				stuck = (await Promise.all(streams.map(async (stream) => await deadline.wait(stream.drain()) ? void 0 : stream))).filter((stream) => stream !== void 0);
+			} catch (error) {
+				errors.push(error);
+			}
+			try {
+				await this.#features.close();
+			} catch (error) {
+				errors.push(error);
+			}
+			try {
+				await this.#resources.closeTelemetry(disposeCleanup);
+			} catch (error) {
+				errors.push(error);
+			}
 		} finally {
 			deadline.cancel();
 			this.#runtime.close();
 		}
-		if (stuck.length > 0) throw new require_errors.ItdStateError(`обработчики потоков (${stuck.map((stream) => stream.transport).join(", ")}) не завершились за ${shutdownTimeout} мс; ожидание прекращено`);
+		if (stuck.length > 0) errors.push(new require_errors.ItdStateError(`обработчики потоков (${stuck.map((stream) => stream.transport).join(", ")}) не завершились за ${shutdownTimeout} мс; ожидание прекращено`));
+		if (errors.length === 1) throw errors[0];
+		if (errors.length > 1) throw new AggregateError(errors, "Не удалось закрыть клиент");
 	}
 	/**
 	* Окончательно освобождает клиент: выполняет {@link close}, отменяет незавершённые
@@ -1350,6 +1418,11 @@ var ItdClient = class ItdClient {
 		} catch (error) {
 			errors.push(error);
 		}
+		try {
+			await this.#features.dispose();
+		} catch (error) {
+			errors.push(error);
+		}
 		try {
 			await this.#runtime.dispose();
 		} catch (error) {