itd-api 0.7.2 → 0.8.0

package/dist/index.cjs

@@ -1,12 +1,64 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-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_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_options = require("./shared/options-Dg5N3r1V.cjs");
-const require_multi_storage = require("./shared/multi-storage--yTEqiod.cjs");
+const require_url = require("./shared/url-CFN1sT9S.cjs");
+const require_errors = require("./shared/errors-BmP3TKoW.cjs");
+const require_redact = require("./shared/redact-DB9EMGJx.cjs");
+const require_render = require("./shared/render-DNTESBSl.cjs");
+const require_options = require("./shared/options-BUfoHE9G.cjs");
+const require_events = require("./shared/events-iTteVsd_.cjs");
+const require_storage = require("./shared/storage-BLmXmzKF.cjs");
+const require_multi_storage = require("./shared/multi-storage-CCUgkqvI.cjs");
+//#region src/notifications-api.ts
+var ClientNotifications = class extends require_render.NotificationsResource {
+	#createEvents;
+	#events;
+	constructor(http, createEvents) {
+		super(http);
+		this.#createEvents = createEvents;
+	}
+	get events() {
+		this.#events ??= this.#createEvents(this);
+		return this.#events;
+	}
+};
+/** Создаёт API уведомлений полного клиента. @internal */
+function createNotificationsApi(http, createEvents) {
+	return new ClientNotifications(http, createEvents);
+}
+//#endregion
+//#region src/operations/auth.ts
+/** Чем закончился запрос входа. */
+const SignInStatus = Object.freeze({
+	Authenticated: "authenticated",
+	OtpRequired: "otp_required"
+});
+function requireString(body, key, message) {
+	const value = require_url.pickString(body, key);
+	if (!value) throw new require_errors.ItdConfigError(message);
+	return value;
+}
+const AUTH_CHECK = require_url.passthroughOperation("auth.check");
+const AUTH_SIGN_UP = require_url.defineBuiltInOperation("auth.signUp", (body) => requireString(body, "flowToken", "Сервер не вернул flowToken при регистрации"));
+const AUTH_SIGN_IN = require_url.defineBuiltInOperation("auth.signIn", (body) => {
+	const accessToken = require_url.pickString(body, "accessToken");
+	return accessToken ? {
+		status: SignInStatus.Authenticated,
+		accessToken
+	} : {
+		status: SignInStatus.OtpRequired,
+		flowToken: require_url.pickString(body, "flowToken")
+	};
+});
+const AUTH_VERIFY_OTP = require_url.defineBuiltInOperation("auth.verifyOtp", (body) => requireString(body, "accessToken", "Сервер не вернул accessToken после подтверждения кода"));
+const AUTH_REFRESH = require_url.defineBuiltInOperation("auth.refresh", (body) => require_url.pickString(body, "accessToken"));
+const AUTH_RESEND_OTP = require_url.voidOperation("auth.resendOtp");
+const AUTH_LOGOUT = require_url.voidOperation("auth.logout");
+const AUTH_FORGOT_PASSWORD = require_url.defineBuiltInOperation("auth.forgotPassword", (body) => requireString(body, "flowToken", "Сервер не вернул flowToken при запросе сброса пароля"));
+const AUTH_RESET_PASSWORD = require_url.voidOperation("auth.resetPassword");
+const AUTH_CHANGE_PASSWORD = require_url.voidOperation("auth.changePassword");
+const AUTH_SESSIONS = require_url.defineBuiltInOperation("auth.sessions", (body) => require_url.pickArray(body, "sessions"));
+const AUTH_REVOKE_SESSION = require_url.voidOperation("auth.revokeSession");
+const AUTH_REVOKE_OTHER_SESSIONS = require_url.voidOperation("auth.revokeOtherSessions");
+//#endregion
 //#region src/session/jwt.ts
 /**
 * Разбирает строку base64url.
@@ -123,7 +175,7 @@ function resolveSessionConfig(options, runtime) {
 * достижимой из любой сборки, включая анонимную.
 */
 function createItdAuth(options, deps) {
-	return new AuthManager(resolveSessionConfig(options, deps.config), deps.handler, deps.cookies, { onAccountChange: deps.onAccountChange });
+	return new AuthManager(resolveSessionConfig(options, deps.config), deps.http, deps.cookies, { onAccountChange: deps.onAccountChange });
 }
 /** Пути эндпоинтов авторизации. */
 const AUTH_PATHS = {
@@ -158,11 +210,6 @@ const AUTH_PATHS = {
 * ```
 */
 const TURNSTILE_SITE_KEY = "0x4AAAAAACHhxczw6fJGwPBg";
-function readAccessToken(payload) {
-	if (typeof payload !== "object" || payload === null) return void 0;
-	const token = payload.accessToken;
-	return typeof token === "string" && token.length > 0 ? token : void 0;
-}
 /** Убирает поле, которое сохраняли промежуточные версии с поддержкой `getUserId()`. */
 function withoutLegacyUserId(session) {
 	const clean = { ...session };
@@ -184,7 +231,7 @@ function nextAuthScope() {
 */
 var AuthManager = class {
 	#config;
-	#send;
+	#http;
 	#jar;
 	#emitter;
 	#hooks;
@@ -223,12 +270,12 @@ var AuthManager = class {
 	* воскресить уже очищенную сессию поверх `signOut`.
 	*/
 	#authEpoch = 0;
-	constructor(config, send, jar, hooks = {}) {
+	constructor(config, http, jar, hooks = {}) {
 		this.#config = config;
-		this.#send = send;
+		this.#http = http;
 		this.#jar = jar;
 		this.#hooks = hooks;
-		this.#emitter = new require_websocket.Emitter((error) => require_websocket.reportListenerError(config.logger, "авторизации", error));
+		this.#emitter = new require_events.Emitter((error) => require_events.reportListenerError(config.logger, "авторизации", error));
 	}
 	/** Подписка на события авторизации. */
 	get on() {
@@ -238,7 +285,7 @@ var AuthManager = class {
 	get once() {
 		return this.#emitter.once.bind(this.#emitter);
 	}
-	/** Снимает lifecycle-подписки при терминальном освобождении владельца. @internal */
+	/** Снимает служебные подписки при окончательном освобождении владельца. @internal */
 	dispose() {
 		this.#invalidateInFlight();
 		this.#emitter.removeAllListeners();
@@ -294,7 +341,7 @@ var AuthManager = class {
 		this.#externalIdentity = current;
 		return token;
 	}
-	/** Меняет fallback и завершает realtime, только если фактически сменился аккаунт. */
+	/** Обновляет резервный идентификатор и закрывает события при смене аккаунта. */
 	#transitionAuth(accessToken, rotateFallback = true) {
 		const knownPrevious = this.#session !== void 0;
 		const previous = this.#identityForToken(this.#session?.accessToken);
@@ -367,7 +414,7 @@ var AuthManager = class {
 	}
 	async #resolveDeviceId() {
 		const session = await this.#loadSession();
-		const deviceId = this.#config.deviceId ?? session?.deviceId ?? require_url.createDeviceId();
+		const deviceId = this.#config.deviceId ?? session?.deviceId ?? require_redact.createDeviceId();
 		this.#deviceId = deviceId;
 		if (session?.deviceId !== deviceId) await this.#saveSession({
 			...session ?? {},
@@ -522,7 +569,7 @@ var AuthManager = class {
 		const refreshToken = this.#session?.refreshToken;
 		if (!refreshToken) return;
 		if (this.#jar.has("refresh_token")) return;
-		this.#jar.set(this.#config.baseUrl, require_cookies.REFRESH_COOKIE, refreshToken, require_cookies.REFRESH_COOKIE_PATH);
+		this.#jar.set(this.#config.baseUrl, require_redact.REFRESH_COOKIE, refreshToken, require_redact.REFRESH_COOKIE_PATH);
 	}
 	#sessionFromConfig(auth) {
 		if (!auth) return null;
@@ -566,16 +613,14 @@ var AuthManager = class {
 		if (!this.#hasRefreshSession()) return this.#reloginOrNull();
 		const epoch = this.#authEpoch;
 		try {
-			const accessToken = readAccessToken(await this.#send({
-				operationId: "auth.refresh",
-				method: require_url.operationMethod("auth.refresh"),
+			const accessToken = await this.#http.execute(AUTH_REFRESH, {
 				path: AUTH_PATHS.refresh,
 				skipAuth: true,
 				skipAuthRefresh: true
-			}));
+			});
 			if (!accessToken) return this.#reloginOrNull();
 			if (this.#authEpoch !== epoch) return this.#session?.accessToken ?? null;
-			const rotated = this.#jar.getValue(require_cookies.REFRESH_COOKIE, this.#config.baseUrl + require_cookies.REFRESH_COOKIE_PATH);
+			const rotated = this.#jar.getValue(require_redact.REFRESH_COOKIE, this.#config.baseUrl + require_redact.REFRESH_COOKIE_PATH);
 			this.#transitionAuth(accessToken, false);
 			await this.#saveSession({
 				...this.#session ?? {},
@@ -639,9 +684,7 @@ var AuthManager = class {
 	}
 	async #performSignIn(credentials) {
 		const turnstileToken = await this.#resolveTurnstileToken(credentials);
-		const accessToken = readAccessToken(await this.#send({
-			operationId: "auth.signIn",
-			method: require_url.operationMethod("auth.signIn"),
+		const result = await this.#http.execute(AUTH_SIGN_IN, {
 			path: AUTH_PATHS.signIn,
 			body: {
 				email: credentials.email,
@@ -650,8 +693,9 @@ var AuthManager = class {
 			},
 			skipAuth: true,
 			skipAuthRefresh: true
-		}));
-		if (!accessToken) throw new require_errors.ItdConfigError("Вход по email и паролю требует подтверждения кодом из письма. Автоматический вход невозможен: воспользуйтесь itd.auth.signInWithOtp() и передайте полученный accessToken в конфигурацию клиента.");
+		});
+		if (result.status !== SignInStatus.Authenticated) throw new require_errors.ItdConfigError("Вход по email и паролю требует подтверждения кодом из письма. Автоматический вход невозможен: воспользуйтесь itd.auth.signInWithOtp() и передайте полученный accessToken в конфигурацию клиента.");
+		const accessToken = result.accessToken;
 		this.#invalidateInFlight();
 		this.#transitionAuth(accessToken);
 		await this.#saveSession({
@@ -665,11 +709,12 @@ var AuthManager = class {
 };
 //#endregion
 //#region src/resources/auth.ts
-/** Чем закончился вход: сразу токеном или запросом кода подтверждения. */
-const SignInStatus = Object.freeze({
-	Authenticated: "authenticated",
-	OtpRequired: "otp_required"
-});
+/**
+* Результат входа.
+*
+* Сервер может как сразу выдать токен, так и потребовать код подтверждения — размеченное
+* объединение делает оба случая явными.
+*/
 /**
 * Авторизация, сессии и пароли.
 *
@@ -687,7 +732,7 @@ var AuthResource = class extends require_render.BaseResource {
 	* Без авторизации возвращает `authenticated: false` и `user: null`.
 	*/
 	check(options = {}) {
-		return this.http.operation("auth.check", {
+		return this.http.execute(AUTH_CHECK, {
 			path: "/api/profile",
 			...options
 		});
@@ -697,17 +742,14 @@ var AuthResource = class extends require_render.BaseResource {
 	*
 	* @returns `flowToken`, который нужно передать в {@link verifyOtp}
 	*/
-	async signUp(credentials, options = {}) {
-		const body = await this.http.operation("auth.signUp", {
+	signUp(credentials, options = {}) {
+		return this.http.execute(AUTH_SIGN_UP, {
 			path: AUTH_PATHS.signUp,
 			body: credentials,
 			skipAuth: true,
 			skipAuthRefresh: true,
 			...options
 		});
-		const flowToken = require_url.pickString(body, "flowToken");
-		if (!flowToken) throw new require_errors.ItdConfigError("Сервер не вернул flowToken при регистрации");
-		return flowToken;
 	}
 	/**
 	* Выполняет вход.
@@ -720,25 +762,15 @@ var AuthResource = class extends require_render.BaseResource {
 	* @param credentials email, пароль и обязательный токен капчи — см. {@link CaptchaCredentials}
 	*/
 	async signIn(credentials, options = {}) {
-		const body = await this.http.operation("auth.signIn", {
+		const result = await this.http.execute(AUTH_SIGN_IN, {
 			path: AUTH_PATHS.signIn,
 			body: credentials,
 			skipAuth: true,
 			skipAuthRefresh: true,
 			...options
 		});
-		const accessToken = require_url.pickString(body, "accessToken");
-		if (accessToken) {
-			await this.#auth.setAccessToken(accessToken);
-			return {
-				status: SignInStatus.Authenticated,
-				accessToken
-			};
-		}
-		return {
-			status: SignInStatus.OtpRequired,
-			flowToken: require_url.pickString(body, "flowToken")
-		};
+		if (result.status === SignInStatus.Authenticated) await this.#auth.setAccessToken(result.accessToken);
+		return result;
 	}
 	/**
 	* Подтверждает вход кодом из письма.
@@ -746,21 +778,19 @@ var AuthResource = class extends require_render.BaseResource {
 	* Полученный токен сохраняется в клиенте автоматически.
 	*/
 	async verifyOtp(input, options = {}) {
-		const body = await this.http.operation("auth.verifyOtp", {
+		const accessToken = await this.http.execute(AUTH_VERIFY_OTP, {
 			path: AUTH_PATHS.verifyOtp,
 			body: input,
 			skipAuth: true,
 			skipAuthRefresh: true,
 			...options
 		});
-		const accessToken = require_url.pickString(body, "accessToken");
-		if (!accessToken) throw new require_errors.ItdConfigError("Сервер не вернул accessToken после подтверждения кода");
 		await this.#auth.setAccessToken(accessToken);
 		return accessToken;
 	}
 	/** Отправляет код подтверждения повторно. */
 	resendOtp(input, options = {}) {
-		return this.http.operation("auth.resendOtp", {
+		return this.voidOperation(AUTH_RESEND_OTP, {
 			path: AUTH_PATHS.resendOtp,
 			body: input,
 			skipAuth: true,
@@ -829,7 +859,7 @@ var AuthResource = class extends require_render.BaseResource {
 	}
 	/** Завершает текущую сессию на сервере и очищает локальную. */
 	async logout(options = {}) {
-		await this.http.operation("auth.logout", {
+		await this.voidOperation(AUTH_LOGOUT, {
 			path: AUTH_PATHS.logout,
 			skipAuthRefresh: true,
 			...options
@@ -857,17 +887,14 @@ var AuthResource = class extends require_render.BaseResource {
 	*
 	* @returns `flowToken`, который нужно передать в {@link resetPassword}
 	*/
-	async forgotPassword(input, options = {}) {
-		const body = await this.http.operation("auth.forgotPassword", {
+	forgotPassword(input, options = {}) {
+		return this.http.execute(AUTH_FORGOT_PASSWORD, {
 			path: AUTH_PATHS.forgotPassword,
 			body: input,
 			skipAuth: true,
 			skipAuthRefresh: true,
 			...options
 		});
-		const flowToken = require_url.pickString(body, "flowToken");
-		if (!flowToken) throw new require_errors.ItdConfigError("Сервер не вернул flowToken при запросе сброса пароля");
-		return flowToken;
 	}
 	/**
 	* Устанавливает новый пароль по коду из письма.
@@ -876,7 +903,7 @@ var AuthResource = class extends require_render.BaseResource {
 	* при нехватке любого отвечает `422`.
 	*/
 	resetPassword(input, options = {}) {
-		return this.http.operation("auth.resetPassword", {
+		return this.voidOperation(AUTH_RESET_PASSWORD, {
 			path: AUTH_PATHS.resetPassword,
 			body: input,
 			skipAuth: true,
@@ -924,7 +951,7 @@ var AuthResource = class extends require_render.BaseResource {
 	* ```
 	*/
 	changePassword(input, options = {}) {
-		return this.http.operation("auth.changePassword", {
+		return this.voidOperation(AUTH_CHANGE_PASSWORD, {
 			path: AUTH_PATHS.changePassword,
 			body: {
 				currentPassword: input.currentPassword,
@@ -934,23 +961,22 @@ var AuthResource = class extends require_render.BaseResource {
 		});
 	}
 	/** Загружает список активных сессий. У текущей поле `isCurrent` равно `true`. */
-	async sessions(options = {}) {
-		const body = await this.http.operation("auth.sessions", {
+	sessions(options = {}) {
+		return this.http.execute(AUTH_SESSIONS, {
 			path: AUTH_PATHS.sessions,
 			...options
 		});
-		return require_url.pickArray(body, "sessions");
 	}
 	/** Завершает указанную сессию. */
 	revokeSession(sessionId, options = {}) {
-		return this.http.operation("auth.revokeSession", {
+		return this.voidOperation(AUTH_REVOKE_SESSION, {
 			path: `${AUTH_PATHS.sessions}/${encodeURIComponent(sessionId)}`,
 			...options
 		});
 	}
 	/** Завершает все сессии, кроме текущей. */
 	revokeOtherSessions(options = {}) {
-		return this.http.operation("auth.revokeOtherSessions", {
+		return this.voidOperation(AUTH_REVOKE_OTHER_SESSIONS, {
 			path: AUTH_PATHS.sessions,
 			...options
 		});
@@ -1014,8 +1040,6 @@ function createManagedClient(options, internals) {
 var ItdClient = class ItdClient {
 	#runtime;
 	#features;
-	/** Порождённые потоки уведомлений — чтобы `close()` мог закрыть их разом. */
-	#streams = /* @__PURE__ */ new Set();
 	/** Общий результат терминальной очистки для идемпотентных повторных вызовов. */
 	#disposePromise;
 	/** Ресурсы конвейера запросов; создаются при первом обращении. */
@@ -1076,33 +1100,71 @@ var ItdClient = class ItdClient {
 		return this.#resources.telemetry;
 	}
 	constructor(options = {}) {
+		const notificationEventsOptions = require_events.resolveNotificationEventsOptions(options.events?.notifications);
 		const internals = CLIENT_INTERNALS.get(options) ?? {};
 		const catalog = new require_render.ExtensibleOperationCatalog(require_url.ITD_CATALOG);
+		let featureHost;
 		this.#runtime = require_url.createClientRuntime(options, {
 			catalog,
 			queues: internals.queues,
 			assertActive: (action) => assertClientActive(this, action),
 			auth: (deps) => createItdAuth(options, {
 				...deps,
-				onAccountChange: () => this.#disconnectStreams()
+				onAccountChange: () => featureHost?.stop()
 			})
 		});
-		this.#features = new require_render.FeatureRegistry({
-			http: this.#runtime.http,
-			services: this.#runtime.services,
-			serviceOverrides: this.#runtime.config.services,
+		this.#features = featureHost = require_render.createFeatureHost(this.#runtime, {
 			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)
+			assertActive: (action) => assertClientActive(this, action)
 		});
 		const status = this.#features.install(require_render.createStatusFeature());
 		this.#resources = require_render.createResources({
 			http: this.#runtime.http,
-			fetch: this.#runtime.config.fetch,
-			status
+			files: this.#features.files,
+			status,
+			createNotifications: (http) => createNotificationsApi(http, (notifications) => {
+				let events;
+				let lifecycleGeneration = 0;
+				let lifecycleActive = false;
+				let unregister;
+				const releaseAfterDrain = (generation) => {
+					events.drain().then(() => {
+						if (lifecycleActive || generation !== lifecycleGeneration) return;
+						unregister?.();
+						unregister = void 0;
+					});
+				};
+				events = new require_events.NotificationEvents({
+					connection: this.#runtime.connection(),
+					request: ({ operationId, path, query, signal }) => this.#runtime.http.execute(require_events.EVENT_OPERATIONS[operationId], {
+						path,
+						query,
+						signal
+					}),
+					getAuthIdentity: () => this.#runtime.auth.getCurrentAuthIdentity(),
+					getAuthScope: () => this.#runtime.auth.getAuthScope(),
+					fetchUnreadCount: (signal) => notifications.count({ signal }),
+					onConnect: () => {
+						lifecycleGeneration += 1;
+						unregister ??= this.#features.manage({
+							kind: `notifications:${events.transport}`,
+							stop: () => {
+								if (lifecycleActive) events.disconnect();
+							},
+							drain: () => events.drain()
+						});
+						lifecycleActive = true;
+					},
+					onClose: () => {
+						lifecycleActive = false;
+						releaseAfterDrain(++lifecycleGeneration);
+					},
+					logger: this.#runtime.config.logger,
+					clock: this.#runtime.config.clock
+				}, notificationEventsOptions);
+				require_events.setNotificationEventsConnectGuard(events, () => assertClientActive(this, "подключить канал событий уведомлений"));
+				return events;
+			})
 		});
 		CLIENT_PLUGIN_REGISTRIES.set(this, this.#runtime.plugins);
 	}
@@ -1146,19 +1208,19 @@ var ItdClient = class ItdClient {
 		return this.#runtime.rateLimitState();
 	}
 	/**
-	* Устанавливает предметный модуль поверх общей сессии и request pipeline клиента.
+	* Устанавливает предметный модуль с общей сессией и обработкой запросов клиента.
 	*
-	* Сервисы, операции и бакеты feature регистрируются до синхронного `setup()`. Возвращаемое
-	* значение — типизированный API модуля; повторное имя feature отклоняется.
+	* Сервисы, операции и бакеты регистрируются до синхронного `setup()`. Возвращает
+	* типизированный API модуля.
 	*/
 	install(feature) {
 		return this.#features.install(feature);
 	}
 	/**
-	* Устанавливает feature и публикует его API как readonly-свойство этого же клиента.
+	* Устанавливает модуль и добавляет его API в свойство клиента только для чтения.
 	*
 	* Возвращаемое пересечение сохраняет тип уже подключённых свойств, поэтому вызовы можно
-	* объединять в цепочку: `new ItdClient().withFeature('chats', chatsFeature)`.
+	* объединять в цепочку: `new ItdClient().withFeature('pixelBattle', pixelBattleFeature)`.
 	*/
 	withFeature(key, feature) {
 		assertClientActive(this, "установить feature");
@@ -1174,20 +1236,18 @@ var ItdClient = class ItdClient {
 		});
 		return this;
 	}
-	/** Имена установленных feature в порядке установки. */
+	/** Имена установленных модулей в порядке установки. */
 	featureNames() {
 		return this.#features.names();
 	}
-	/** Установлен ли feature с таким именем. */
+	/** Установлен ли модуль с таким именем. */
 	hasFeature(name) {
 		return this.#features.has(name);
 	}
 	/**
 	* Подключает плагин.
 	*
-	* Плагин может независимо регистрировать transformer логической операции и interceptor
-	* транспортной попытки. Оба контракта охватывают все методы клиента. Подключать плагин
-	* можно в любой момент, но обычно это делают сразу после создания клиента.
+	* Плагин может регистрировать обёртки операций и перехватчики сетевых попыток.
 	*
 	* @throws {ItdConfigError} если плагин задан неверно или уже подключён
 	* @throws {ItdStateError} если клиент уже освобождён через {@link dispose}
@@ -1290,85 +1350,27 @@ var ItdClient = class ItdClient {
 		return this.#runtime.auth.on(event, listener);
 	}
 	/**
-	* Создаёт поток уведомлений в реальном времени.
-	*
-	* Каждый вызов даёт новый независимый поток; обычно он нужен один на приложение.
-	* Соединение поднимается методом `connect()` и держится само. Замена авторизации на токен
-	* другого пользователя завершает все потоки клиента; смена только сессии их не затрагивает.
-	*
-	* @example
-	* ```ts
-	* import { NotificationType } from 'itd-api';
-	*
-	* const stream = itd.realtime();
-	*
-	* stream.onNotification(NotificationType.PostComment, async ({ update }) => {
-	*   await handleComment(update.data.notification);
-	* });
-	* stream.on('unreadCount', (count) => setBadge(count));
-	*
-	* await stream.connect();
-	* ```
-	*
-	* @throws {ItdStateError} если клиент уже освобождён через {@link dispose}
-	*/
-	realtime(options = {}) {
-		assertClientActive(this, "создать realtime-поток");
-		let stream;
-		stream = new require_websocket.ItdRealtime({
-			baseUrl: this.#runtime.config.baseUrl,
-			fetch: this.#runtime.config.fetch,
-			request: ({ operationId, path, query, signal }) => this.#runtime.http.operation(operationId, {
-				path,
-				query,
-				signal
-			}),
-			baseHeaders: (url) => this.#runtime.platformHeaders(url),
-			getAuthIdentity: () => this.#runtime.auth.getCurrentAuthIdentity(),
-			getAuthScope: () => this.#runtime.auth.getAuthScope(),
-			getToken: () => this.#runtime.auth.token(),
-			refresh: () => this.#runtime.auth.onUnauthorized(),
-			fetchUnreadCount: () => this.notifications.count(),
-			onConnect: () => this.#streams.add(stream),
-			onClose: () => this.#streams.delete(stream),
-			logger: this.#runtime.config.logger,
-			clock: this.#runtime.config.clock
-		}, options);
-		require_websocket.setRealtimeConnectGuard(stream, () => assertClientActive(this, "подключить realtime-поток"));
-		this.#streams.add(stream);
-		return stream;
-	}
-	/**
 	* Освобождает ресурсы клиента: закрывает все потоки уведомлений, отправляет открытые
 	* накопители {@link telemetry}, затем останавливает очередь запросов.
 	*
-	* Метод дожидается активных обработчиков потока, но не дольше `shutdownTimeout`. После
-	* вызова клиентом можно пользоваться снова; ранее созданный поток можно запустить
-	* повторным `connect()`.
+	* Метод дожидается завершения активных обработчиков и освобождения ресурсов остановленных
+	* событийных соединений, но не дольше `shutdownTimeout`. После вызова клиентом можно
+	* пользоваться снова; ранее созданный поток можно запустить повторным `connect()`.
 	*
 	* Общая очередь, полученная от {@link ItdAccounts}, не останавливается: её гасит сам
 	* контейнер, когда закрывает все аккаунты разом.
 	*
 	* Терминальное освобождение — это {@link dispose}.
 	*
-	* @throws {ItdStateError} если обработчики потока не завершились за отведённый срок
+	* @throws {ItdStateError} если остановка событийного соединения не завершилась за отведённый срок
 	*/
 	async close() {
 		return this.#close(false);
 	}
 	async #close(disposeCleanup) {
-		const streams = this.#disconnectStreams();
 		if (disposeCleanup) this.#resources.prepareTelemetryClose();
-		const { shutdownTimeout, clock } = this.#runtime.config;
-		const deadline = require_url.createDeadline(shutdownTimeout, clock);
-		let stuck = [];
 		const errors = [];
 		try {
-			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) {
@@ -1380,10 +1382,8 @@ var ItdClient = class ItdClient {
 				errors.push(error);
 			}
 		} finally {
-			deadline.cancel();
 			this.#runtime.close();
 		}
-		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, "Не удалось закрыть клиент");
 	}
@@ -1393,10 +1393,11 @@ var ItdClient = class ItdClient {
 	*
 	* Терминальное состояние устанавливается сразу при первом вызове. После этого новые
 	* запросы, подключение плагинов, регистрация сервисов и создание или повторный запуск
-	* realtime-потоков завершаются с {@link ItdStateError}. Повторные вызовы возвращают
+	* событийных каналов завершаются с {@link ItdStateError}. Повторные вызовы возвращают
 	* тот же результат очистки.
 	*
-	* Ожидание обработчиков потока и операций плагинов ограничено `shutdownTimeout`.
+	* Ожидание остановки событийных соединений и операций плагинов ограничено
+	* `shutdownTimeout`.
 	*
 	* @example
 	* ```ts
@@ -1430,13 +1431,6 @@ var ItdClient = class ItdClient {
 		}
 		if (errors.length > 0) throw new AggregateError(errors, "Не удалось освободить клиент");
 	}
-	/** Завершает потоки до того, как запросы начнут использовать другой аккаунт. */
-	#disconnectStreams() {
-		const streams = [...this.#streams];
-		for (const stream of streams) stream.disconnect();
-		this.#streams.clear();
-		return streams;
-	}
 	/** Позволяет использовать клиент с `await using`. */
 	[Symbol.asyncDispose]() {
 		return this.dispose();
@@ -1502,6 +1496,25 @@ function createClient(options = {}) {
 function validateAccountName(name) {
 	if (typeof name !== "string" || name.trim() === "") throw new require_errors.ItdConfigError("имя аккаунта должно быть непустой строкой");
 }
+/** Проверяет фабрики до создания первого аккаунта. */
+function resolveAccountFeatures(features) {
+	if (features === void 0) return [];
+	if (!Array.isArray(features)) throw new require_errors.ItdConfigError("features должен быть массивом фабрик подключаемых модулей");
+	const keys = /* @__PURE__ */ new Set();
+	return features.map((feature, index) => {
+		if (typeof feature !== "object" || feature === null || typeof feature.create !== "function") throw new require_errors.ItdConfigError(`features[${index}] должен предоставлять create()`);
+		if (feature.key !== void 0) {
+			if (typeof feature.key !== "string" || feature.key.trim() === "" || feature.key !== feature.key.trim()) throw new require_errors.ItdConfigError(`features[${index}].key должен быть непустой строкой без пробелов`);
+			if (keys.has(feature.key)) throw new require_errors.ItdConfigError(`Свойство подключаемого модуля «${feature.key}» объявлено повторно`);
+			keys.add(feature.key);
+		}
+		const create = feature.create.bind(feature);
+		return Object.freeze({
+			...feature.key === void 0 ? {} : { key: feature.key },
+			create
+		});
+	});
+}
 const DISPOSED_ACCOUNTS = /* @__PURE__ */ new WeakSet();
 function assertAccountsActive(accounts, action) {
 	if (!DISPOSED_ACCOUNTS.has(accounts)) return;
@@ -1553,6 +1566,8 @@ var ItdAccounts = class ItdAccounts {
 	#eventUnsubscribers = /* @__PURE__ */ new Map();
 	/** Плагины для всех: и для уже заведённых аккаунтов, и для будущих. */
 	#plugins;
+	/** Фабрики модулей для новых и восстанавливаемых аккаунтов. */
+	#features;
 	/** Имена плагинов, чья асинхронная очистка ещё не завершилась. */
 	#removingPlugins = /* @__PURE__ */ new Set();
 	/** Общая очередь. `undefined`, когда у каждого аккаунта своя. */
@@ -1563,17 +1578,18 @@ var ItdAccounts = class ItdAccounts {
 	/** Общий результат терминальной очистки для идемпотентных повторных вызовов. */
 	#disposePromise;
 	constructor(options = {}) {
-		const { storage, plugins, rateLimitScope, ...base } = options;
+		const { storage, plugins, features, rateLimitScope, ...base } = options;
 		if (rateLimitScope !== void 0 && rateLimitScope !== "account" && rateLimitScope !== "shared") throw new require_errors.ItdConfigError("rateLimitScope должен быть 'account' или 'shared'");
 		this.#base = base;
 		this.#storage = storage ?? new require_multi_storage.MemoryMultiTokenStorage();
 		this.#plugins = require_url.orderPluginDefinitions(plugins ?? []);
+		this.#features = resolveAccountFeatures(features);
 		this.#rateLimitScope = rateLimitScope ?? "shared";
 		const rateLimit = this.#rateLimitScope === "shared" ? require_url.resolveRateLimit(base.rateLimit, require_url.ITD_CATALOG) : void 0;
 		this.#queues = rateLimit ? new require_url.RequestQueuePool(rateLimit, base.clock ?? require_url.systemClock) : void 0;
 		const logger = typeof base.logger === "object" ? base.logger : void 0;
 		this.#logger = logger;
-		this.#emitter = new require_websocket.Emitter((error) => require_websocket.reportListenerError(logger, "аккаунтов", error));
+		this.#emitter = new require_events.Emitter((error) => require_events.reportListenerError(logger, "аккаунтов", error));
 	}
 	/** Общее хранилище сессий — то же, что передано опцией `storage`. */
 	get storage() {
@@ -1594,7 +1610,7 @@ var ItdAccounts = class ItdAccounts {
 	/**
 	* Заводит аккаунт.
 	*
-	* Возвращается обычный `ItdClient` — со всеми ресурсами, плагинами и `realtime()`.
+	* Возвращается обычный `ItdClient` — со всеми ресурсами, плагинами и каналом событий.
 	* Хранилище ему подставляется само: срез общего по имени аккаунта.
 	*
 	* Опция `auth` не обязательна: когда сессия этого аккаунта уже лежит в хранилище,
@@ -1620,10 +1636,15 @@ var ItdAccounts = class ItdAccounts {
 		try {
 			client = createManagedClient(this.#mergeOptions(options, storageControl.storage), this.#queues ? { queues: this.#queues } : {});
 			for (const plugin of this.#plugins) client.use(plugin);
+			for (const feature of this.#features) {
+				const manifest = feature.create();
+				if (feature.key === void 0) client.install(manifest);
+				else client.withFeature(feature.key, manifest);
+			}
 		} catch (error) {
 			storageControl.revoke();
 			if (client) client.dispose().catch((cleanupError) => {
-				this.#reportPluginCleanup("неудачного добавления аккаунта", cleanupError);
+				this.#reportCleanup("неудачного добавления аккаунта", cleanupError);
 			});
 			throw error;
 		}
@@ -1747,7 +1768,7 @@ var ItdAccounts = class ItdAccounts {
 			}
 		} catch (error) {
 			for (const client of installed.reverse()) client.unuse(plugin.name).catch((cleanupError) => {
-				this.#reportPluginCleanup(`отката плагина «${plugin.name}»`, cleanupError);
+				this.#reportCleanup(`отката плагина «${plugin.name}»`, cleanupError);
 			});
 			throw error;
 		}
@@ -1863,6 +1884,7 @@ var ItdAccounts = class ItdAccounts {
 			Promise.resolve().then(() => this.#queues?.clear())
 		]);
 		this.#plugins.splice(0);
+		this.#features.splice(0);
 		this.#removingPlugins.clear();
 		const errors = results.filter((result) => result.status === "rejected").map((result) => result.reason);
 		if (errors.length > 0) throw new AggregateError(errors, "Не удалось освободить аккаунты");
@@ -1872,11 +1894,7 @@ var ItdAccounts = class ItdAccounts {
 		return this.dispose();
 	}
 	static {
-		if (typeof Symbol.asyncDispose !== "symbol") {
-			const prototype = ItdAccounts.prototype;
-			prototype[Symbol.for("Symbol.asyncDispose")] = prototype.undefined;
-			delete prototype.undefined;
-		}
+		require_url.installAsyncDisposeFallback(ItdAccounts);
 	}
 	/**
 	* Собирает опции клиента: общие, поверх них — аккаунтные, и обязательно свой срез
@@ -1901,9 +1919,9 @@ var ItdAccounts = class ItdAccounts {
 			storage
 		};
 	}
-	/** Не теряет ошибку фонового teardown, который синхронный API не может await-нуть. */
-	#reportPluginCleanup(scope, error) {
-		const message = `Не удалось завершить teardown после ${scope}`;
+	/** Не теряет ошибку фонового освобождения ресурсов, которого синхронный API не ждёт. */
+	#reportCleanup(scope, error) {
+		const message = `Не удалось освободить ресурсы после ${scope}`;
 		if (this.#logger) this.#logger.error(message, error);
 		else console.error(`[itd-api] ${message}`, error);
 	}
@@ -1943,6 +1961,10 @@ exports.BUCKET_LIMITS = require_url.BUCKET_LIMITS;
 exports.CommentSort = require_url.CommentSort;
 exports.DEFAULT_BASE_URL = require_url.DEFAULT_BASE_URL;
 exports.DEFAULT_RATE_LIMIT_BUCKET = require_url.DEFAULT_RATE_LIMIT_BUCKET;
+exports.EventChannel = require_events.EventChannel;
+exports.EventChannelStatus = require_url.EventChannelStatus;
+exports.EventComposer = require_events.EventComposer;
+exports.EventRouter = require_events.EventRouter;
 exports.FeedTab = require_url.FeedTab;
 exports.FileTransferMode = require_options.FileTransferMode;
 exports.IMAGE_MIME_TYPES = require_render.IMAGE_MIME_TYPES;
@@ -1966,7 +1988,6 @@ exports.ItdNetworkError = require_errors.ItdNetworkError;
 exports.ItdNotFoundError = require_errors.ItdNotFoundError;
 exports.ItdPhoneVerificationError = require_errors.ItdPhoneVerificationError;
 exports.ItdRateLimitError = require_errors.ItdRateLimitError;
-exports.ItdRealtime = require_websocket.ItdRealtime;
 exports.ItdServerError = require_errors.ItdServerError;
 exports.ItdStateError = require_errors.ItdStateError;
 exports.ItdTimeoutError = require_errors.ItdTimeoutError;
@@ -1976,33 +1997,32 @@ exports.LikesVisibility = require_url.LikesVisibility;
 exports.MemoryKeyValueStore = require_storage.MemoryKeyValueStore;
 exports.MemoryMultiTokenStorage = require_multi_storage.MemoryMultiTokenStorage;
 exports.MemoryTokenStorage = require_storage.MemoryTokenStorage;
+exports.NotificationEvents = require_events.NotificationEvents;
+exports.NotificationEventsClient = require_events.NotificationEventsClient;
+exports.NotificationEventsTransport = require_events.NotificationEventsTransport;
 exports.NotificationType = require_url.NotificationType;
+exports.NotificationUpdateOrigin = require_events.NotificationUpdateOrigin;
+exports.NotificationUpdateType = require_events.NotificationUpdateType;
 exports.OPERATIONS = require_url.OPERATIONS;
 exports.PaginationMode = require_render.PaginationMode;
 exports.Paginator = require_render.Paginator;
 exports.RateLimitPacing = require_url.RateLimitPacing;
-exports.RealtimeComposer = require_websocket.RealtimeComposer;
-exports.RealtimeRouter = require_websocket.RealtimeRouter;
-exports.RealtimeStatus = require_url.RealtimeStatus;
-exports.RealtimeTransportKind = require_websocket.RealtimeTransportKind;
-exports.RealtimeUpdateOrigin = require_websocket.RealtimeUpdateOrigin;
-exports.RealtimeUpdateType = require_websocket.RealtimeUpdateType;
 exports.ReportReason = require_url.ReportReason;
 exports.ReportTargetType = require_url.ReportTargetType;
 exports.RetrySafety = require_url.RetrySafety;
-exports.RuntimeMode = require_url.RuntimeMode;
+exports.RuntimeMode = require_redact.RuntimeMode;
 exports.STATUS_SERVICE = require_url.STATUS_SERVICE;
 exports.ServiceState = require_url.ServiceState;
 exports.SignInStatus = SignInStatus;
 exports.SpanRenderFormat = require_render.SpanRenderFormat;
 exports.SpanType = require_url.SpanType;
 exports.TURNSTILE_SITE_KEY = TURNSTILE_SITE_KEY;
-exports.UnauthorizedStreamError = require_websocket.UnauthorizedStreamError;
+exports.UnauthorizedStreamError = require_events.UnauthorizedStreamError;
 exports.VIDEO_MIME_TYPES = require_render.VIDEO_MIME_TYPES;
 exports.ViewReason = require_url.ViewReason;
 exports.ViewSource = require_url.ViewSource;
 exports.WallAccess = require_url.WallAccess;
-exports.WebSocketTransport = require_websocket.WebSocketTransport;
+exports.WebSocketTransport = require_events.WebSocketTransport;
 exports.autoSpans = require_render.autoSpans;
 exports.canonicalNotificationType = require_url.canonicalNotificationType;
 exports.comment = require_render.comment;
@@ -2010,6 +2030,7 @@ exports.createAccounts = createAccounts;
 exports.createClient = createClient;
 exports.createKeyValueStore = require_storage.createKeyValueStore;
 exports.createMultiTokenStorage = require_multi_storage.createMultiTokenStorage;
+exports.createNotificationEventsClient = require_events.createNotificationEventsClient;
 exports.createRecordKeyValueStore = require_storage.createRecordKeyValueStore;
 exports.createTokenStorage = require_storage.createTokenStorage;
 exports.formatNotificationText = require_url.formatNotificationText;
@@ -2045,7 +2066,7 @@ exports.post = require_render.post;
 exports.renderSpans = require_render.renderSpans;
 exports.report = require_render.report;
 exports.resolveNotificationUrl = require_url.resolveNotificationUrl;
-exports.runRealtimeMiddleware = require_websocket.runRealtimeMiddleware;
+exports.runEventMiddleware = require_events.runEventMiddleware;
 exports.scopedTokenStorage = require_multi_storage.scopedTokenStorage;
 exports.statusDays = require_render.statusDays;
 exports.systemClock = require_url.systemClock;