itd-api 0.7.1 → 0.8.0

package/dist/index.js

@@ -1,11 +1,63 @@
-import { $ as RuntimeMode, A as operationRetrySafety, C as ViewSource, D as isBuiltInOperationId, E as OPERATIONS, F as pickArray, G as orderPluginDefinitions, H as RetrySafety, J as resolveRateLimit, K as DEFAULT_BASE_URL, M as DEFAULT_RATE_LIMIT_BUCKET, N as createClientRuntime, O as operationBucket, Q as RateLimitPacing, S as ViewReason, T as ITD_CATALOG, U as RequestQueuePool, W as assertPluginRemovable, X as isRecord, Y as LIBRARY_VERSION, Z as requireOptionalBoolean, _ as RealtimeStatus, at as systemClock, b as ServiceState, c as AccessType, d as FeedTab, et as createDeviceId, f as IncidentKind, g as NotificationType, h as LikesVisibility, it as createDeadline, j as BUCKET_LIMITS, k as operationMethod, l as AttachmentType, m as ItdErrorCode, n as formatNotificationText, o as canonicalNotificationType, ot as installAsyncDisposeFallback, p as InteractionType, q as STATUS_SERVICE, r as normalizeNotification, s as isKnownNotificationType, t as resolveNotificationUrl, u as CommentSort, v as ReportReason, w as WallAccess, x as SpanType, y as ReportTargetType, z as pickString } from "./shared/url-CYXgxqGx.js";
-import { A as isItdStateError, C as isItdError, D as isItdPhoneVerificationError, E as isItdNotFoundError, O as isItdRateLimitError, S as isItdConflictError, T as isItdForbiddenError, _ as ItdStateError, a as ItdConfigError, b as isItdApiError, c as ItdErrorKind, d as ItdForbiddenError, f as ItdNetworkError, g as ItdServerError, h as ItdRateLimitError, i as ItdAuthError, j as isItdValidationError, k as isItdServerError, l as ItdFileError, m as ItdPhoneVerificationError, n as ItdApiError, o as ItdConflictError, p as ItdNotFoundError, r as ItdApiErrorKind, s as ItdError, t as ItdAbortError, u as ItdFileErrorReason, v as ItdTimeoutError, w as isItdFileError, x as isItdAuthError, y as ItdValidationError } from "./shared/errors-Bhrd2fJd.js";
-import { i as REFRESH_COOKIE_PATH, r as REFRESH_COOKIE } from "./shared/cookies-tX2sNwxb.js";
-import { a as RealtimeTransportKind, c as RealtimeUpdateType, d as Emitter, f as reportListenerError, i as ItdRealtime, l as UnauthorizedStreamError, n as RealtimeComposer, o as setRealtimeConnectGuard, r as RealtimeRouter, s as RealtimeUpdateOrigin, t as WebSocketTransport, u as runRealtimeMiddleware } from "./shared/websocket-CbzB1Leq.js";
-import { c as isEnumerableKeyValueStore, i as MemoryKeyValueStore, l as withCodec, n as copySession, o as createKeyValueStore, r as createTokenStorage, s as createRecordKeyValueStore, t as MemoryTokenStorage, u as withNamespace } from "./shared/storage-D86edNCB.js";
-import { C as BaseResource, E as mapPage, S as isBuilder, T as Paginator, _ as ALLOWED_MIME_TYPES, a as fromStream, b as VIDEO_MIME_TYPES, c as report, d as autoSpans, f as markup, g as utcStampToIso, h as toDate, i as isMyProfile, l as post, m as parseMarkdown, n as renderSpans, o as fromUrl, p as parseHtml, r as statusDays, s as createResources, t as SpanRenderFormat, u as poll, v as AUDIO_MIME_TYPES, w as PaginationMode, x as comment, y as IMAGE_MIME_TYPES } from "./shared/render-vtLixIiU.js";
-import { c as FileTransferMode } from "./shared/options-DtATYdLr.js";
-import { a as scopedTokenStorage, i as isRestorableSession, n as controlledTokenStorage, r as createMultiTokenStorage, t as MemoryMultiTokenStorage } from "./shared/multi-storage-CkvTUC5m.js";
+import { $ as DEFAULT_BASE_URL, A as ITD_CATALOG, C as ReportReason, D as ViewReason, E as SpanType, F as operationMethod, G as pickString, I as operationRetrySafety, K as RetrySafety, L as BUCKET_LIMITS, M as defineBuiltInOperation, N as isBuiltInOperationId, O as ViewSource, P as operationBucket, Q as orderPluginDefinitions, R as DEFAULT_RATE_LIMIT_BUCKET, S as NotificationType, T as ServiceState, V as pickArray, X as RequestQueuePool, Z as assertPluginRemovable, _ as FeedTab, at as requireOptionalBoolean, b as ItdErrorCode, c as normalizeNotification, ct as systemClock, d as canonicalNotificationType, f as isKnownNotificationType, g as EventChannelStatus, h as CommentSort, it as isRecord, j as OPERATIONS, k as WallAccess, lt as installAsyncDisposeFallback, m as AttachmentType, n as formatNotificationText, nt as resolveRateLimit, o as passthroughOperation, ot as RateLimitPacing, p as AccessType, rt as LIBRARY_VERSION, s as voidOperation, t as resolveNotificationUrl, tt as STATUS_SERVICE, v as IncidentKind, w as ReportTargetType, x as LikesVisibility, y as InteractionType, z as createClientRuntime } from "./shared/url-B3ocFlHj.js";
+import { A as isItdStateError, C as isItdError, D as isItdPhoneVerificationError, E as isItdNotFoundError, O as isItdRateLimitError, S as isItdConflictError, T as isItdForbiddenError, _ as ItdStateError, a as ItdConfigError, b as isItdApiError, c as ItdErrorKind, d as ItdForbiddenError, f as ItdNetworkError, g as ItdServerError, h as ItdRateLimitError, i as ItdAuthError, j as isItdValidationError, k as isItdServerError, l as ItdFileError, m as ItdPhoneVerificationError, n as ItdApiError, o as ItdConflictError, p as ItdNotFoundError, r as ItdApiErrorKind, s as ItdError, t as ItdAbortError, u as ItdFileErrorReason, v as ItdTimeoutError, w as isItdFileError, x as isItdAuthError, y as ItdValidationError } from "./shared/errors-GI10kZxk.js";
+import { _ as RuntimeMode, c as REFRESH_COOKIE, l as REFRESH_COOKIE_PATH, v as createDeviceId } from "./shared/redact-FNK29Fv-.js";
+import { A as ExtensibleOperationCatalog, C as utcStampToIso, D as Paginator, E as PaginationMode, O as mapPage, S as toDate, T as BaseResource, _ as IMAGE_MIME_TYPES, a as fromStream, b as isBuilder, c as report, d as autoSpans, f as markup, g as AUDIO_MIME_TYPES, h as ALLOWED_MIME_TYPES, i as isMyProfile, k as createFeatureHost, l as post, m as parseMarkdown, n as renderSpans, o as fromUrl, p as parseHtml, r as statusDays, s as createResources, t as SpanRenderFormat, u as poll, v as VIDEO_MIME_TYPES, w as NotificationsResource, x as createStatusFeature, y as comment } from "./shared/render-CiL1VS0b.js";
+import { c as FileTransferMode } from "./shared/options-BNP633A5.js";
+import { _ as Emitter, a as WebSocketTransport, c as NotificationEventsTransport, d as NotificationUpdateOrigin, f as NotificationUpdateType, g as runEventMiddleware, h as UnauthorizedStreamError, i as createNotificationEventsClient, l as resolveNotificationEventsOptions, n as EventRouter, o as EVENT_OPERATIONS, p as EventChannel, r as NotificationEventsClient, s as NotificationEvents, t as EventComposer, u as setNotificationEventsConnectGuard, v as reportListenerError } from "./shared/events-TfhKh26b.js";
+import { c as isEnumerableKeyValueStore, i as MemoryKeyValueStore, l as withCodec, n as copySession, o as createKeyValueStore, r as createTokenStorage, s as createRecordKeyValueStore, t as MemoryTokenStorage, u as withNamespace } from "./shared/storage-CCxn0Kkv.js";
+import { a as scopedTokenStorage, i as isRestorableSession, n as controlledTokenStorage, r as createMultiTokenStorage, t as MemoryMultiTokenStorage } from "./shared/multi-storage-1AEZTczk.js";
+//#region src/notifications-api.ts
+var ClientNotifications = class extends 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 = pickString(body, key);
+	if (!value) throw new ItdConfigError(message);
+	return value;
+}
+const AUTH_CHECK = passthroughOperation("auth.check");
+const AUTH_SIGN_UP = defineBuiltInOperation("auth.signUp", (body) => requireString(body, "flowToken", "Сервер не вернул flowToken при регистрации"));
+const AUTH_SIGN_IN = defineBuiltInOperation("auth.signIn", (body) => {
+	const accessToken = pickString(body, "accessToken");
+	return accessToken ? {
+		status: SignInStatus.Authenticated,
+		accessToken
+	} : {
+		status: SignInStatus.OtpRequired,
+		flowToken: pickString(body, "flowToken")
+	};
+});
+const AUTH_VERIFY_OTP = defineBuiltInOperation("auth.verifyOtp", (body) => requireString(body, "accessToken", "Сервер не вернул accessToken после подтверждения кода"));
+const AUTH_REFRESH = defineBuiltInOperation("auth.refresh", (body) => pickString(body, "accessToken"));
+const AUTH_RESEND_OTP = voidOperation("auth.resendOtp");
+const AUTH_LOGOUT = voidOperation("auth.logout");
+const AUTH_FORGOT_PASSWORD = defineBuiltInOperation("auth.forgotPassword", (body) => requireString(body, "flowToken", "Сервер не вернул flowToken при запросе сброса пароля"));
+const AUTH_RESET_PASSWORD = voidOperation("auth.resetPassword");
+const AUTH_CHANGE_PASSWORD = voidOperation("auth.changePassword");
+const AUTH_SESSIONS = defineBuiltInOperation("auth.sessions", (body) => pickArray(body, "sessions"));
+const AUTH_REVOKE_SESSION = voidOperation("auth.revokeSession");
+const AUTH_REVOKE_OTHER_SESSIONS = voidOperation("auth.revokeOtherSessions");
+//#endregion
 //#region src/session/jwt.ts
 /**
 * Разбирает строку base64url.
@@ -122,7 +174,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 = {
@@ -157,11 +209,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 };
@@ -183,7 +230,7 @@ function nextAuthScope() {
 */
 var AuthManager = class {
 	#config;
-	#send;
+	#http;
 	#jar;
 	#emitter;
 	#hooks;
@@ -222,9 +269,9 @@ 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 Emitter((error) => reportListenerError(config.logger, "авторизации", error));
@@ -237,7 +284,7 @@ var AuthManager = class {
 	get once() {
 		return this.#emitter.once.bind(this.#emitter);
 	}
-	/** Снимает lifecycle-подписки при терминальном освобождении владельца. @internal */
+	/** Снимает служебные подписки при окончательном освобождении владельца. @internal */
 	dispose() {
 		this.#invalidateInFlight();
 		this.#emitter.removeAllListeners();
@@ -293,7 +340,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);
@@ -565,13 +612,11 @@ var AuthManager = class {
 		if (!this.#hasRefreshSession()) return this.#reloginOrNull();
 		const epoch = this.#authEpoch;
 		try {
-			const accessToken = readAccessToken(await this.#send({
-				operationId: "auth.refresh",
-				method: 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(REFRESH_COOKIE, this.#config.baseUrl + REFRESH_COOKIE_PATH);
@@ -638,9 +683,7 @@ var AuthManager = class {
 	}
 	async #performSignIn(credentials) {
 		const turnstileToken = await this.#resolveTurnstileToken(credentials);
-		const accessToken = readAccessToken(await this.#send({
-			operationId: "auth.signIn",
-			method: operationMethod("auth.signIn"),
+		const result = await this.#http.execute(AUTH_SIGN_IN, {
 			path: AUTH_PATHS.signIn,
 			body: {
 				email: credentials.email,
@@ -649,8 +692,9 @@ var AuthManager = class {
 			},
 			skipAuth: true,
 			skipAuthRefresh: true
-		}));
-		if (!accessToken) throw new ItdConfigError("Вход по email и паролю требует подтверждения кодом из письма. Автоматический вход невозможен: воспользуйтесь itd.auth.signInWithOtp() и передайте полученный accessToken в конфигурацию клиента.");
+		});
+		if (result.status !== SignInStatus.Authenticated) throw new ItdConfigError("Вход по email и паролю требует подтверждения кодом из письма. Автоматический вход невозможен: воспользуйтесь itd.auth.signInWithOtp() и передайте полученный accessToken в конфигурацию клиента.");
+		const accessToken = result.accessToken;
 		this.#invalidateInFlight();
 		this.#transitionAuth(accessToken);
 		await this.#saveSession({
@@ -664,11 +708,12 @@ var AuthManager = class {
 };
 //#endregion
 //#region src/resources/auth.ts
-/** Чем закончился вход: сразу токеном или запросом кода подтверждения. */
-const SignInStatus = Object.freeze({
-	Authenticated: "authenticated",
-	OtpRequired: "otp_required"
-});
+/**
+* Результат входа.
+*
+* Сервер может как сразу выдать токен, так и потребовать код подтверждения — размеченное
+* объединение делает оба случая явными.
+*/
 /**
 * Авторизация, сессии и пароли.
 *
@@ -686,7 +731,7 @@ var AuthResource = class extends BaseResource {
 	* Без авторизации возвращает `authenticated: false` и `user: null`.
 	*/
 	check(options = {}) {
-		return this.http.operation("auth.check", {
+		return this.http.execute(AUTH_CHECK, {
 			path: "/api/profile",
 			...options
 		});
@@ -696,17 +741,14 @@ var AuthResource = class extends 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 = pickString(body, "flowToken");
-		if (!flowToken) throw new ItdConfigError("Сервер не вернул flowToken при регистрации");
-		return flowToken;
 	}
 	/**
 	* Выполняет вход.
@@ -719,25 +761,15 @@ var AuthResource = class extends 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 = pickString(body, "accessToken");
-		if (accessToken) {
-			await this.#auth.setAccessToken(accessToken);
-			return {
-				status: SignInStatus.Authenticated,
-				accessToken
-			};
-		}
-		return {
-			status: SignInStatus.OtpRequired,
-			flowToken: pickString(body, "flowToken")
-		};
+		if (result.status === SignInStatus.Authenticated) await this.#auth.setAccessToken(result.accessToken);
+		return result;
 	}
 	/**
 	* Подтверждает вход кодом из письма.
@@ -745,21 +777,19 @@ var AuthResource = class extends 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 = pickString(body, "accessToken");
-		if (!accessToken) throw new 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,
@@ -828,7 +858,7 @@ var AuthResource = class extends BaseResource {
 	}
 	/** Завершает текущую сессию на сервере и очищает локальную. */
 	async logout(options = {}) {
-		await this.http.operation("auth.logout", {
+		await this.voidOperation(AUTH_LOGOUT, {
 			path: AUTH_PATHS.logout,
 			skipAuthRefresh: true,
 			...options
@@ -856,17 +886,14 @@ var AuthResource = class extends 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 = pickString(body, "flowToken");
-		if (!flowToken) throw new ItdConfigError("Сервер не вернул flowToken при запросе сброса пароля");
-		return flowToken;
 	}
 	/**
 	* Устанавливает новый пароль по коду из письма.
@@ -875,7 +902,7 @@ var AuthResource = class extends 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,
@@ -923,7 +950,7 @@ var AuthResource = class extends BaseResource {
 	* ```
 	*/
 	changePassword(input, options = {}) {
-		return this.http.operation("auth.changePassword", {
+		return this.voidOperation(AUTH_CHANGE_PASSWORD, {
 			path: AUTH_PATHS.changePassword,
 			body: {
 				currentPassword: input.currentPassword,
@@ -933,23 +960,22 @@ var AuthResource = class extends 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 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
 		});
@@ -1012,8 +1038,7 @@ function createManagedClient(options, internals) {
 */
 var ItdClient = class ItdClient {
 	#runtime;
-	/** Порождённые потоки уведомлений — чтобы `close()` мог закрыть их разом. */
-	#streams = /* @__PURE__ */ new Set();
+	#features;
 	/** Общий результат терминальной очистки для идемпотентных повторных вызовов. */
 	#disposePromise;
 	/** Ресурсы конвейера запросов; создаются при первом обращении. */
@@ -1074,19 +1099,71 @@ var ItdClient = class ItdClient {
 		return this.#resources.telemetry;
 	}
 	constructor(options = {}) {
+		const notificationEventsOptions = resolveNotificationEventsOptions(options.events?.notifications);
 		const internals = CLIENT_INTERNALS.get(options) ?? {};
+		const catalog = new ExtensibleOperationCatalog(ITD_CATALOG);
+		let featureHost;
 		this.#runtime = createClientRuntime(options, {
-			catalog: ITD_CATALOG,
+			catalog,
 			queues: internals.queues,
 			assertActive: (action) => assertClientActive(this, action),
 			auth: (deps) => createItdAuth(options, {
 				...deps,
-				onAccountChange: () => this.#disconnectStreams()
+				onAccountChange: () => featureHost?.stop()
 			})
 		});
+		this.#features = featureHost = createFeatureHost(this.#runtime, {
+			catalog,
+			assertActive: (action) => assertClientActive(this, action)
+		});
+		const status = this.#features.install(createStatusFeature());
 		this.#resources = createResources({
 			http: this.#runtime.http,
-			fetch: this.#runtime.config.fetch
+			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 NotificationEvents({
+					connection: this.#runtime.connection(),
+					request: ({ operationId, path, query, signal }) => this.#runtime.http.execute(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);
+				setNotificationEventsConnectGuard(events, () => assertClientActive(this, "подключить канал событий уведомлений"));
+				return events;
+			})
 		});
 		CLIENT_PLUGIN_REGISTRIES.set(this, this.#runtime.plugins);
 	}
@@ -1130,11 +1207,46 @@ var ItdClient = class ItdClient {
 		return this.#runtime.rateLimitState();
 	}
 	/**
+	* Устанавливает предметный модуль с общей сессией и обработкой запросов клиента.
+	*
+	* Сервисы, операции и бакеты регистрируются до синхронного `setup()`. Возвращает
+	* типизированный API модуля.
+	*/
+	install(feature) {
+		return this.#features.install(feature);
+	}
+	/**
+	* Устанавливает модуль и добавляет его API в свойство клиента только для чтения.
+	*
+	* Возвращаемое пересечение сохраняет тип уже подключённых свойств, поэтому вызовы можно
+	* объединять в цепочку: `new ItdClient().withFeature('pixelBattle', pixelBattleFeature)`.
+	*/
+	withFeature(key, feature) {
+		assertClientActive(this, "установить feature");
+		if (typeof key !== "string" || key.trim() === "" || key !== key.trim()) throw new ItdConfigError("Свойство feature должно иметь непустое имя без краевых пробелов");
+		if (key === "then" || key in this) throw new ItdConfigError(`Свойство клиента «${key}» уже занято или зарезервировано`);
+		if (!Object.isExtensible(this)) throw new ItdConfigError("Нельзя опубликовать feature на нерасширяемом клиенте");
+		const api = this.install(feature);
+		Object.defineProperty(this, key, {
+			value: api,
+			enumerable: true,
+			configurable: false,
+			writable: false
+		});
+		return this;
+	}
+	/** Имена установленных модулей в порядке установки. */
+	featureNames() {
+		return this.#features.names();
+	}
+	/** Установлен ли модуль с таким именем. */
+	hasFeature(name) {
+		return this.#features.has(name);
+	}
+	/**
 	* Подключает плагин.
 	*
-	* Плагин может независимо регистрировать transformer логической операции и interceptor
-	* транспортной попытки. Оба контракта охватывают все методы клиента. Подключать плагин
-	* можно в любой момент, но обычно это делают сразу после создания клиента.
+	* Плагин может регистрировать обёртки операций и перехватчики сетевых попыток.
 	*
 	* @throws {ItdConfigError} если плагин задан неверно или уже подключён
 	* @throws {ItdStateError} если клиент уже освобождён через {@link dispose}
@@ -1237,86 +1349,42 @@ 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 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);
-		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 = 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 {
+				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 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}, отменяет незавершённые
@@ -1324,10 +1392,11 @@ var ItdClient = class ItdClient {
 	*
 	* Терминальное состояние устанавливается сразу при первом вызове. После этого новые
 	* запросы, подключение плагинов, регистрация сервисов и создание или повторный запуск
-	* realtime-потоков завершаются с {@link ItdStateError}. Повторные вызовы возвращают
+	* событийных каналов завершаются с {@link ItdStateError}. Повторные вызовы возвращают
 	* тот же результат очистки.
 	*
-	* Ожидание обработчиков потока и операций плагинов ограничено `shutdownTimeout`.
+	* Ожидание остановки событийных соединений и операций плагинов ограничено
+	* `shutdownTimeout`.
 	*
 	* @example
 	* ```ts
@@ -1349,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) {
@@ -1356,13 +1430,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();
@@ -1428,6 +1495,25 @@ function createClient(options = {}) {
 function validateAccountName(name) {
 	if (typeof name !== "string" || name.trim() === "") throw new ItdConfigError("имя аккаунта должно быть непустой строкой");
 }
+/** Проверяет фабрики до создания первого аккаунта. */
+function resolveAccountFeatures(features) {
+	if (features === void 0) return [];
+	if (!Array.isArray(features)) throw new ItdConfigError("features должен быть массивом фабрик подключаемых модулей");
+	const keys = /* @__PURE__ */ new Set();
+	return features.map((feature, index) => {
+		if (typeof feature !== "object" || feature === null || typeof feature.create !== "function") throw new ItdConfigError(`features[${index}] должен предоставлять create()`);
+		if (feature.key !== void 0) {
+			if (typeof feature.key !== "string" || feature.key.trim() === "" || feature.key !== feature.key.trim()) throw new ItdConfigError(`features[${index}].key должен быть непустой строкой без пробелов`);
+			if (keys.has(feature.key)) throw new 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;
@@ -1479,6 +1565,8 @@ var ItdAccounts = class ItdAccounts {
 	#eventUnsubscribers = /* @__PURE__ */ new Map();
 	/** Плагины для всех: и для уже заведённых аккаунтов, и для будущих. */
 	#plugins;
+	/** Фабрики модулей для новых и восстанавливаемых аккаунтов. */
+	#features;
 	/** Имена плагинов, чья асинхронная очистка ещё не завершилась. */
 	#removingPlugins = /* @__PURE__ */ new Set();
 	/** Общая очередь. `undefined`, когда у каждого аккаунта своя. */
@@ -1489,11 +1577,12 @@ 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 ItdConfigError("rateLimitScope должен быть 'account' или 'shared'");
 		this.#base = base;
 		this.#storage = storage ?? new MemoryMultiTokenStorage();
 		this.#plugins = orderPluginDefinitions(plugins ?? []);
+		this.#features = resolveAccountFeatures(features);
 		this.#rateLimitScope = rateLimitScope ?? "shared";
 		const rateLimit = this.#rateLimitScope === "shared" ? resolveRateLimit(base.rateLimit, ITD_CATALOG) : void 0;
 		this.#queues = rateLimit ? new RequestQueuePool(rateLimit, base.clock ?? systemClock) : void 0;
@@ -1520,7 +1609,7 @@ var ItdAccounts = class ItdAccounts {
 	/**
 	* Заводит аккаунт.
 	*
-	* Возвращается обычный `ItdClient` — со всеми ресурсами, плагинами и `realtime()`.
+	* Возвращается обычный `ItdClient` — со всеми ресурсами, плагинами и каналом событий.
 	* Хранилище ему подставляется само: срез общего по имени аккаунта.
 	*
 	* Опция `auth` не обязательна: когда сессия этого аккаунта уже лежит в хранилище,
@@ -1546,10 +1635,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;
 		}
@@ -1673,7 +1767,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;
 		}
@@ -1789,6 +1883,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, "Не удалось освободить аккаунты");
@@ -1798,11 +1893,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;
-		}
+		installAsyncDisposeFallback(ItdAccounts);
 	}
 	/**
 	* Собирает опции клиента: общие, поверх них — аккаунтные, и обязательно свой срез
@@ -1827,9 +1918,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);
 	}
@@ -1861,6 +1952,6 @@ function createAccounts(options = {}) {
 	return new ItdAccounts(options);
 }
 //#endregion
-export { ALLOWED_MIME_TYPES, AUDIO_MIME_TYPES, AccessType, AttachmentType, BUCKET_LIMITS, CommentSort, DEFAULT_BASE_URL, DEFAULT_RATE_LIMIT_BUCKET, FeedTab, FileTransferMode, IMAGE_MIME_TYPES, IncidentKind, InteractionType, ItdAbortError, ItdAccounts, ItdApiError, ItdApiErrorKind, ItdAuthError, ItdClient, ItdConfigError, ItdConflictError, ItdError, ItdErrorCode, ItdErrorKind, ItdFileError, ItdFileErrorReason, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdPhoneVerificationError, ItdRateLimitError, ItdRealtime, ItdServerError, ItdStateError, ItdTimeoutError, ItdValidationError, LIBRARY_VERSION, LikesVisibility, MemoryKeyValueStore, MemoryMultiTokenStorage, MemoryTokenStorage, NotificationType, OPERATIONS, PaginationMode, Paginator, RateLimitPacing, RealtimeComposer, RealtimeRouter, RealtimeStatus, RealtimeTransportKind, RealtimeUpdateOrigin, RealtimeUpdateType, ReportReason, ReportTargetType, RetrySafety, RuntimeMode, STATUS_SERVICE, ServiceState, SignInStatus, SpanRenderFormat, SpanType, TURNSTILE_SITE_KEY, UnauthorizedStreamError, VIDEO_MIME_TYPES, ViewReason, ViewSource, WallAccess, WebSocketTransport, autoSpans, canonicalNotificationType, comment, createAccounts, createClient, createKeyValueStore, createMultiTokenStorage, createRecordKeyValueStore, createTokenStorage, formatNotificationText, fromStream, fromUrl, isBuilder, isBuiltInOperationId, isEnumerableKeyValueStore, isItdApiError, isItdAuthError, isItdConflictError, isItdError, isItdFileError, isItdForbiddenError, isItdNotFoundError, isItdPhoneVerificationError, isItdRateLimitError, isItdServerError, isItdStateError, isItdValidationError, isKnownNotificationType, isMyProfile, mapPage, markup, normalizeNotification, operationBucket, operationMethod, operationRetrySafety, parseHtml, parseMarkdown, poll, post, renderSpans, report, resolveNotificationUrl, runRealtimeMiddleware, scopedTokenStorage, statusDays, systemClock, toDate, utcStampToIso, withCodec, withNamespace };
+export { ALLOWED_MIME_TYPES, AUDIO_MIME_TYPES, AccessType, AttachmentType, BUCKET_LIMITS, CommentSort, DEFAULT_BASE_URL, DEFAULT_RATE_LIMIT_BUCKET, EventChannel, EventChannelStatus, EventComposer, EventRouter, FeedTab, FileTransferMode, IMAGE_MIME_TYPES, IncidentKind, InteractionType, ItdAbortError, ItdAccounts, ItdApiError, ItdApiErrorKind, ItdAuthError, ItdClient, ItdConfigError, ItdConflictError, ItdError, ItdErrorCode, ItdErrorKind, ItdFileError, ItdFileErrorReason, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdPhoneVerificationError, ItdRateLimitError, ItdServerError, ItdStateError, ItdTimeoutError, ItdValidationError, LIBRARY_VERSION, LikesVisibility, MemoryKeyValueStore, MemoryMultiTokenStorage, MemoryTokenStorage, NotificationEvents, NotificationEventsClient, NotificationEventsTransport, NotificationType, NotificationUpdateOrigin, NotificationUpdateType, OPERATIONS, PaginationMode, Paginator, RateLimitPacing, ReportReason, ReportTargetType, RetrySafety, RuntimeMode, STATUS_SERVICE, ServiceState, SignInStatus, SpanRenderFormat, SpanType, TURNSTILE_SITE_KEY, UnauthorizedStreamError, VIDEO_MIME_TYPES, ViewReason, ViewSource, WallAccess, WebSocketTransport, autoSpans, canonicalNotificationType, comment, createAccounts, createClient, createKeyValueStore, createMultiTokenStorage, createNotificationEventsClient, createRecordKeyValueStore, createTokenStorage, formatNotificationText, fromStream, fromUrl, isBuilder, isBuiltInOperationId, isEnumerableKeyValueStore, isItdApiError, isItdAuthError, isItdConflictError, isItdError, isItdFileError, isItdForbiddenError, isItdNotFoundError, isItdPhoneVerificationError, isItdRateLimitError, isItdServerError, isItdStateError, isItdValidationError, isKnownNotificationType, isMyProfile, mapPage, markup, normalizeNotification, operationBucket, operationMethod, operationRetrySafety, parseHtml, parseMarkdown, poll, post, renderSpans, report, resolveNotificationUrl, runEventMiddleware, scopedTokenStorage, statusDays, systemClock, toDate, utcStampToIso, withCodec, withNamespace };
 
 //# sourceMappingURL=index.js.map