itd-api 0.7.1 → 0.8.0

package/dist/index.d.cts

@@ -1,8 +1,8 @@
-import { $ as UserSummary, $t as RateLimitPacing, A as isItdFileError, At as Emitter, B as Notification, Bt as RateLimitOptions, C as ItdStateError, Ct as ReportReason, D as isItdAuthError, Dt as ViewReason, E as isItdApiError, Et as SpanType, F as isItdServerError, Ft as Logger, G as FollowResult, Gt as ResponseContext, H as Actor, Ht as RequestContext, I as isItdStateError, It as OperationRequestOptions, J as PinsResult, Jt as RetryOptions, K as MyProfile, Kt as RetryContext, L as isItdValidationError, Lt as PaginationOptions, M as isItdNotFoundError, Mt as Unsubscribe, N as isItdPhoneVerificationError, Nt as ClientHooks, O as isItdConflictError, Ot as ViewSource, P as isItdRateLimitError, Pt as ErrorContextHook, Q as SubscriptionState, Qt as ServiceDefinition, R as NotificationEvent, Rt as RateLimitBucketContext, S as ItdServerError, St as RealtimeStatus, T as ItdValidationError, Tt as ServiceState, U as AuthState, Ut as RequestExtensions, V as NotificationSettings, Vt as RawRequestOptions, W as Author, Wt as RequestOptions, X as Profile, Xt as QueryParams, Y as PrivacySettings, Yt as RuntimeOptions, Z as PublicProfile, Zt as QueryValue, _ as ItdForbiddenError, _t as InteractionType, a as ItdAbortError, an as ItdOperationDefinition, at as DEFAULT_BASE_URL, b as ItdPhoneVerificationError, bt as Loose, c as ItdApiErrorKind, cn as isBuiltInOperationId, ct as IsoDate, d as ItdConflictError, dn as operationRetrySafety, dt as UserRef, en as RuntimeMode, et as AuthIdentity, f as ItdError, fn as BUCKET_LIMITS, ft as AccessType, g as ItdFileErrorReason, gn as RetrySafety, gt as IncidentKind, h as ItdFileError, hn as OperationMethod, ht as FeedTab, i as formatNotificationText, in as CustomOperationId, j as isItdForbiddenError, jt as Listener, k as isItdError, kt as WallAccess, l as ItdAuthError, ln as operationBucket, lt as Span, m as ItdFieldErrors, mn as RateLimitBucket, mt as CommentSort, n as canonicalNotificationType, nn as systemClock, o as ItdApiError, on as OPERATIONS, ot as STATUS_SERVICE, p as ItdErrorKind, pn as DEFAULT_RATE_LIMIT_BUCKET, pt as AttachmentType, q as Pin, qt as RetryDecisionContext, r as isKnownNotificationType, rn as BuiltInOperationId, s as ItdApiErrorInit, sn as OperationId, st as LIBRARY_VERSION, t as resolveNotificationUrl, tn as ItdClock, tt as AuthProvider, u as ItdConfigError, un as operationMethod, ut as UserId, v as ItdNetworkError, vt as ItdErrorCode, w as ItdTimeoutError, wt as ReportTargetType, x as ItdRateLimitError, xt as NotificationType, y as ItdNotFoundError, yt as LikesVisibility, z as normalizeNotification, zt as RateLimitBucketOverride } from "./shared/url-B6-bXHKt.cjs";
-import { $ as poll, $t as CreatePostData, A as TelemetryResource, At as FilesResource, B as ReportInput, Bt as PinPostResult, C as DwellEntry, Cn as RequestHandler, Ct as Report, D as TelemetryBatchOptions, Dt as UpdateNotificationSettingsInput, E as TelemetryBatch, Et as NotificationsResource, F as SubscriptionResource, Ft as Attachment, G as UserPostsParams, Gt as CommentBuilder, H as CommentsParams, Ht as PollOption, I as SearchResource, It as Comment, J as PostInput, Jt as BuilderInput, K as CreatePostInput, Kt as CommentInput, L as SearchResult, Lt as CommentReplyTo, M as ViewTracker, Mt as UploadedFile, N as ViewTrackerInput, Nt as CommentsResource, O as TelemetryClock, Ot as HashtagPostsParams, P as ViewTrackerOptions, Pt as RepliesParams, Q as PollInput, Qt as CreatePollInput, R as ReportsResource, Rt as Hashtag, S as UsersResource, Sn as PluginTeardown, St as Portal, T as PhotoOpenInput, Tt as NotificationListParams, U as FeedParams, Ut as Post, V as report, Vt as Poll, W as PostsResource, Wt as PostStats, X as post, Xt as isBuilder, Y as PostUpdateInput, Yt as ItdBuilder, Z as PollBuilder, Zt as CreateCommentInput, _ as fromUrl, _n as AttemptNext, _t as StatusIncidentLine, a as isMyProfile, an as PaginationMode, at as MarkupContent, b as UpdateProfileInput, bn as OperationTransformer, bt as ChangelogEntry, c as ALLOWED_MIME_TYPES, cn as mapPage, ct as TextMarkup, d as AudioMimeType, dn as Subscription, dt as PlatformClientVersion, en as CreateReportInput, et as ParseMarkupOptions, f as IMAGE_MIME_TYPES, fn as HttpClient, ft as PlatformResource, g as fromStream, gn as AttemptInterceptor, gt as StatusDay, h as VideoMimeType, hn as AttemptExtensions, ht as ServiceStatus, i as statusDays, in as PageState, it as MarkupBuilder, j as VideoProgressInput, jt as UploadOptions, k as TelemetryOptions, kt as HashtagsResource, l as AUDIO_MIME_TYPES, ln as PaymentMethod, lt as autoSpans, m as VIDEO_MIME_TYPES, mn as AttemptContext, mt as PlatformStatus, n as SpanRenderFormat, nn as BaseResource, nt as parseMarkdown, o as toDate, on as Paginator, ot as MarkupInput, p as ImageMimeType, pn as RateLimitBucketState, pt as PlatformVersions, q as PostBuilder, qt as comment, r as renderSpans, rn as Page, rt as AutoSpansOptions, s as utcStampToIso, sn as PaginatorOptions, st as MarkupSpan, t as RenderSpansOptions, tn as UpdatePostInput, tt as parseHtml, u as AllowedMimeType, un as Session, ut as markup, v as VerificationResource, vn as ClientPlugin, vt as Announcement, w as InteractionEntry, wt as VerificationStatus, x as UserListParams, xn as PluginApi, xt as Clan, y as UpdatePrivacyInput, yn as OperationExtensions, yt as AnnouncementButton, z as ReportBuilder, zt as LikeResult } from "./shared/render-DMp_3Nzk.cjs";
-import { _ as withNamespace, a as createTokenStorage, c as KeyValueStore, d as MemoryKeyValueStore, f as RecordKeyValueStoreSource, g as withCodec, h as isEnumerableKeyValueStore, i as TokenStorageAdapterOptions, l as KeyValueStoreKeys, m as createRecordKeyValueStore, n as MemoryTokenStorage, o as EnumerableKeyValueStore, p as createKeyValueStore, r as TokenStorage, s as KeyValueCodec, t as ItdSession, u as KeyValueStoreResult } from "./shared/storage-C_eICCep.cjs";
-import { A as NotificationOfType, B as RealtimeUpdateOfType, C as RealtimeMiddlewareObj, D as RealtimeTypeGuard, E as RealtimeSequentializer, F as RealtimeNotificationSelector, G as RealtimeTransport, H as RealtimeUpdateType, I as RealtimeNotificationUpdate, J as UnauthorizedStreamError, K as TransportContext, L as RealtimeUnknownUpdate, M as RealtimeContextBase, N as RealtimeNotificationContext, O as runRealtimeMiddleware, P as RealtimeNotificationFilter, R as RealtimeUnreadCountUpdate, S as RealtimeMiddleware, T as RealtimePredicate, U as RealtimeRequest, V as RealtimeUpdateOrigin, W as RealtimeRequestInput, _ as RealtimeOptions, a as WebSocketTransportOptions, b as ReconnectOptions, c as RealtimeErrorContext, d as RealtimeMiddlewareLike, f as RealtimeRouteTable, g as RealtimeEvents, h as ItdRealtime, i as WebSocketTransport, j as RealtimeContext, k as NotificationEventOfType, l as RealtimeFilter, m as RealtimeRouter, n as WebSocketLike, o as RealtimeComposer, p as RealtimeRouteSelector, q as TransportEvent, r as WebSocketOpenFailureClassifier, s as RealtimeErrorBoundary, t as WebSocketImplementationOptions, u as RealtimeMiddlewareGroup, v as RealtimeTransportKind, w as RealtimeNext, x as RealtimeHandler, y as RealtimeEngineEvents, z as RealtimeUpdate } from "./shared/websocket-D1p32SB2.cjs";
+import { $ as isItdValidationError, $t as RateLimitBucket, A as ItdFieldErrors, At as ResponseContext, B as ItdTimeoutError, Bt as ItdClock, C as ItdApiErrorInit, Ct as RateLimitBucketContext, D as ItdConflictError, Dt as RequestContext, E as ItdConfigError, Et as RawRequestOptions, F as ItdNotFoundError, Ft as QueryParams, G as isItdError, Gt as OPERATIONS, H as isItdApiError, Ht as BuiltInOperationId, I as ItdPhoneVerificationError, It as QueryValue, J as isItdNotFoundError, Jt as operationBucket, K as isItdFileError, Kt as OperationId, L as ItdRateLimitError, Lt as ServiceDefinition, M as ItdFileErrorReason, Mt as RetryDecisionContext, N as ItdForbiddenError, Nt as RetryOptions, O as ItdError, Ot as RequestExtensions, P as ItdNetworkError, Pt as RuntimeOptions, Q as isItdStateError, Qt as DEFAULT_RATE_LIMIT_BUCKET, R as ItdServerError, Rt as RateLimitPacing, S as ItdApiError, St as PaginationOptions, T as ItdAuthError, Tt as RateLimitOptions, U as isItdAuthError, Ut as CustomOperationId, V as ItdValidationError, Vt as systemClock, W as isItdConflictError, Wt as ItdOperationDefinition, X as isItdRateLimitError, Xt as operationRetrySafety, Y as isItdPhoneVerificationError, Yt as operationMethod, Z as isItdServerError, Zt as BUCKET_LIMITS, _ as Profile, _n as ServiceState, _t as RetrySafety, a as NotificationEvent, an as AttachmentType, b as UserSummary, bn as ViewSource, bt as Logger, c as NotificationSettings, cn as FeedTab, ct as Unsubscribe, d as Author, dn as ItdErrorCode, dt as LIBRARY_VERSION, en as IsoDate, et as ClientConnection, f as FollowResult, fn as LikesVisibility, ft as FeatureOperationId, g as PrivacySettings, gn as ReportTargetType, gt as OperationMethod, h as PinsResult, hn as ReportReason, ht as OperationMetadata, i as formatNotificationText, in as AccessType, j as ItdFileError, jt as RetryContext, k as ItdErrorKind, kt as RequestOptions, l as Actor, ln as IncidentKind, lt as DEFAULT_BASE_URL, m as Pin, mn as NotificationType, n as canonicalNotificationType, nn as UserId, nt as AuthProvider, o as normalizeNotification, on as CommentSort, ot as Emitter, p as MyProfile, pn as Loose, pt as OperationAnnotations, q as isItdForbiddenError, qt as isBuiltInOperationId, r as isKnownNotificationType, rn as UserRef, s as Notification, sn as EventChannelStatus, st as Listener, t as resolveNotificationUrl, tn as Span, tt as AuthIdentity, u as AuthState, un as InteractionType, ut as STATUS_SERVICE, v as PublicProfile, vn as SpanType, vt as ClientHooks, w as ItdApiErrorKind, wt as RateLimitBucketOverride, x as ItdAbortError, xn as WallAccess, xt as OperationRequestOptions, y as SubscriptionState, yn as ViewReason, yt as ErrorContextHook, z as ItdStateError, zt as RuntimeMode } from "./shared/url-Be9jlWRv.cjs";
+import { $ as poll, $t as PaymentMethod, A as TelemetryResource, An as AttemptNext, At as CommentsResource, B as ReportInput, Bt as Post, C as DwellEntry, Cn as PreparedStreamSource, Ct as Report, D as TelemetryBatchOptions, Dn as AttemptContext, Dt as FilesResource, E as TelemetryBatch, En as HttpClient, Et as HashtagsResource, F as SubscriptionResource, Fn as PluginTeardown, Ft as Hashtag, G as UserPostsParams, Gt as BuilderInput, H as CommentsParams, Ht as CommentBuilder, I as SearchResource, It as LikeResult, J as PostInput, Jt as CreateCommentInput, K as CreatePostInput, Kt as ItdBuilder, L as SearchResult, Lt as PinPostResult, M as ViewTracker, Mn as OperationExtensions, Mt as Attachment, N as ViewTrackerInput, Nn as OperationTransformer, Nt as Comment, O as TelemetryClock, On as AttemptExtensions, Ot as UploadOptions, P as ViewTrackerOptions, Pn as PluginApi, Pt as CommentReplyTo, Q as PollInput, Qt as UpdatePostInput, R as ReportsResource, Rt as Poll, S as UsersResource, Sn as PreparedFileSource, St as Portal, T as PhotoOpenInput, Tn as ResolveFileOptions, Tt as HashtagPostsParams, U as FeedParams, Ut as CommentInput, V as report, Vt as PostStats, W as PostsResource, Wt as comment, X as post, Xt as CreatePostData, Y as PostUpdateInput, Yt as CreatePollInput, Z as PollBuilder, Zt as CreateReportInput, _ as fromUrl, _n as FeatureOperationDefinition, _t as StatusIncidentLine, a as isMyProfile, an as BaseResource, at as MarkupContent, b as UpdateProfileInput, bn as FileResolver, bt as ChangelogEntry, c as ALLOWED_MIME_TYPES, cn as PaginationMode, ct as TextMarkup, d as AudioMimeType, dn as mapPage, dt as PlatformClientVersion, en as Session, et as ParseMarkupOptions, f as IMAGE_MIME_TYPES, fn as RateLimitBucketState, ft as PlatformResource, g as fromStream, gn as FeatureInstallation, gt as StatusDay, h as VideoMimeType, hn as FeatureContext, ht as ServiceStatus, i as statusDays, in as UpdateNotificationSettingsInput, it as MarkupBuilder, j as VideoProgressInput, jn as ClientPlugin, jt as RepliesParams, k as TelemetryOptions, kn as AttemptInterceptor, kt as UploadedFile, l as AUDIO_MIME_TYPES, ln as Paginator, lt as autoSpans, m as VIDEO_MIME_TYPES, mn as FeatureBucketDefinition, mt as PlatformStatus, n as SpanRenderFormat, nn as NotificationListParams, nt as parseMarkdown, o as toDate, on as Page, ot as MarkupInput, p as ImageMimeType, pn as ClientFeature, pt as PlatformVersions, q as PostBuilder, qt as isBuilder, r as renderSpans, rn as NotificationsResource, rt as AutoSpansOptions, s as utcStampToIso, sn as PageState, st as MarkupSpan, t as RenderSpansOptions, tn as Subscription, tt as parseHtml, u as AllowedMimeType, un as PaginatorOptions, ut as markup, v as VerificationResource, vn as FeatureRequestOptions, vt as Announcement, w as InteractionEntry, wn as ResolveFileContext, wt as VerificationStatus, x as UserListParams, xn as PreparedBufferSource, xt as Clan, y as UpdatePrivacyInput, yn as ManagedClientResource, yt as AnnouncementButton, z as ReportBuilder, zt as PollOption } from "./shared/render-BszcKF7S.cjs";
+import { $ as EventTransport, A as ReconnectOptions, B as NotificationContext, C as EventChannelDeps, D as EventSession, E as EventEnqueueOptions, F as EventPredicate, G as NotificationEventsUpdate, H as NotificationEventFilter, I as EventSequentializer, J as NotificationUpdateOfType, K as NotificationOfType, L as EventTypeGuard, M as EventMiddleware, N as EventMiddlewareObject, O as EventSyncReason, P as EventNext, Q as UnreadCountUpdate, R as runEventMiddleware, S as EventChannel, T as EventChannelOptions, U as NotificationEventOfType, V as NotificationEventContext, W as NotificationEventSelector, X as NotificationUpdateType, Y as NotificationUpdateOrigin, Z as UnknownNotificationUpdate, _ as createNotificationEventsClient, a as WebSocketTransportOptions, b as NotificationEventsOptions, c as EventErrorContext, d as EventMiddlewareLike, et as EventTransportContext, f as EventRouteTable, g as NotificationEventsClientOptions, h as NotificationEventsClient, i as WebSocketTransport, j as EventHandler, l as EventFilter, m as EventRouter, n as WebSocketLike, nt as UnauthorizedStreamError, o as EventComposer, p as EventRouteSelector, q as NotificationUpdate, r as WebSocketOpenFailureClassifier, s as EventErrorBoundary, t as WebSocketImplementationOptions, tt as EventTransportFrame, u as EventMiddlewareGroup, v as NotificationEvents, w as EventChannelEvents, x as NotificationEventsTransport, y as NotificationEventsMap, z as EventContext } from "./shared/events-Br2r7coi.cjs";
 import { a as FileStreamOptions, c as LazyFile, d as UrlFileOptions, i as FileStreamContent, l as StreamFile, n as FileContext, o as FileTransferMode, r as FileInput, s as FromStreamOptions, t as FileContent, u as UrlFile } from "./shared/contracts-BoT7msmq.cjs";
+import { _ as withNamespace, a as createTokenStorage, c as KeyValueStore, d as MemoryKeyValueStore, f as RecordKeyValueStoreSource, g as withCodec, h as isEnumerableKeyValueStore, i as TokenStorageAdapterOptions, l as KeyValueStoreKeys, m as createRecordKeyValueStore, n as MemoryTokenStorage, o as EnumerableKeyValueStore, p as createKeyValueStore, r as TokenStorage, s as KeyValueCodec, t as ItdSession, u as KeyValueStoreResult } from "./shared/storage-C_eICCep.cjs";
 import { a as scopedTokenStorage, i as createMultiTokenStorage, n as MultiTokenStorage, r as MultiTokenStorageAdapterOptions, t as MemoryMultiTokenStorage } from "./shared/multi-storage-CjAPB5Kq.cjs";
 //#region src/core/cookies.d.ts
 /**
@@ -64,6 +64,13 @@ declare class CookieJar {
   clear(): void;
 }
 //#endregion
+//#region src/notifications-api.d.ts
+/** Уведомления полного клиента: REST-методы и стабильный канал событий. */
+interface NotificationsApi extends NotificationsResource {
+  /** Один канал событий уведомлений на всё время жизни клиента. */
+  readonly events: NotificationEvents;
+}
+//#endregion
 //#region src/session/options.d.ts
 /**
  * Вход по логину и паролю.
@@ -157,7 +164,29 @@ interface SessionOptions {
  * });
  * ```
  */
-interface ItdClientOptions extends RuntimeOptions, SessionOptions {}
+interface ItdClientOptions extends RuntimeOptions, SessionOptions {
+  /** Неизменяемые настройки предметных каналов событий клиента. */
+  events?: {
+    /** Настройки канала уведомлений на всё время жизни клиента. */
+    notifications?: NotificationEventsOptions | undefined;
+  } | undefined;
+}
+//#endregion
+//#region src/operations/auth.d.ts
+/** Чем закончился запрос входа. */
+declare const SignInStatus: Readonly<{
+  readonly Authenticated: "authenticated";
+  readonly OtpRequired: "otp_required";
+}>;
+type SignInStatus = (typeof SignInStatus)[keyof typeof SignInStatus];
+/** Результат входа: готовый токен либо продолжение через код подтверждения. */
+type SignInResult = {
+  status: 'authenticated';
+  accessToken: string;
+} | {
+  status: 'otp_required';
+  flowToken: string | undefined;
+};
 //#endregion
 //#region src/session/auth.d.ts
 /**
@@ -228,12 +257,12 @@ interface AuthManagerHooks {
  */
 declare class AuthManager implements AuthProvider {
   #private;
-  constructor(config: SessionConfig, send: RequestHandler, jar: CookieJar, hooks?: AuthManagerHooks);
+  constructor(config: SessionConfig, http: HttpClient, jar: CookieJar, hooks?: AuthManagerHooks);
   /** Подписка на события авторизации. */
   get on(): Emitter<AuthEvents>['on'];
   /** Подписка на одно срабатывание. */
   get once(): Emitter<AuthEvents>['once'];
-  /** Снимает lifecycle-подписки при терминальном освобождении владельца. @internal */
+  /** Снимает служебные подписки при окончательном освобождении владельца. @internal */
   dispose(): void;
   /**
    * Непрозрачная fallback-область авторизации.
@@ -362,25 +391,12 @@ interface ResetPasswordInput {
   flowToken: string;
   newPassword: string;
 }
-/** Чем закончился вход: сразу токеном или запросом кода подтверждения. */
-declare const SignInStatus: Readonly<{
-  readonly Authenticated: "authenticated";
-  readonly OtpRequired: "otp_required";
-}>;
-type SignInStatus = (typeof SignInStatus)[keyof typeof SignInStatus];
 /**
  * Результат входа.
  *
  * Сервер может как сразу выдать токен, так и потребовать код подтверждения — размеченное
  * объединение делает оба случая явными.
  */
-type SignInResult = {
-  status: 'authenticated';
-  accessToken: string;
-} | {
-  status: 'otp_required';
-  flowToken: string | undefined;
-};
 /**
  * Авторизация, сессии и пароли.
  *
@@ -586,7 +602,7 @@ declare class ItdClient {
   /** Загрузка файлов и медиа. */
   get files(): FilesResource;
   /** Уведомления: список, счётчик, отметки о прочтении, настройки. */
-  get notifications(): NotificationsResource;
+  get notifications(): NotificationsApi;
   /** Хэштеги и посты по ним. */
   get hashtags(): HashtagsResource;
   /** Глобальный поиск по пользователям и хэштегам. */
@@ -632,12 +648,28 @@ declare class ItdClient {
    * ```
    */
   rateLimitState(): RateLimitBucketState[];
+  /**
+   * Устанавливает предметный модуль с общей сессией и обработкой запросов клиента.
+   *
+   * Сервисы, операции и бакеты регистрируются до синхронного `setup()`. Возвращает
+   * типизированный API модуля.
+   */
+  install<TApi>(feature: ClientFeature<TApi>): TApi;
+  /**
+   * Устанавливает модуль и добавляет его API в свойство клиента только для чтения.
+   *
+   * Возвращаемое пересечение сохраняет тип уже подключённых свойств, поэтому вызовы можно
+   * объединять в цепочку: `new ItdClient().withFeature('pixelBattle', pixelBattleFeature)`.
+   */
+  withFeature<const K extends string, TApi>(key: K, feature: ClientFeature<TApi>): this & { readonly [P in K]: TApi; };
+  /** Имена установленных модулей в порядке установки. */
+  featureNames(): string[];
+  /** Установлен ли модуль с таким именем. */
+  hasFeature(name: string): boolean;
   /**
    * Подключает плагин.
    *
-   * Плагин может независимо регистрировать transformer логической операции и interceptor
-   * транспортной попытки. Оба контракта охватывают все методы клиента. Подключать плагин
-   * можно в любой момент, но обычно это делают сразу после создания клиента.
+   * Плагин может регистрировать обёртки операций и перехватчики сетевых попыток.
    *
    * @throws {ItdConfigError} если плагин задан неверно или уже подключён
    * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}
@@ -715,44 +747,20 @@ declare class ItdClient {
    * ```
    */
   on<K extends keyof AuthEvents>(event: K, listener: Listener<AuthEvents[K]>): Unsubscribe;
-  /**
-   * Создаёт поток уведомлений в реальном времени.
-   *
-   * Каждый вызов даёт новый независимый поток; обычно он нужен один на приложение.
-   * Соединение поднимается методом `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?: RealtimeOptions): ItdRealtime;
   /**
    * Освобождает ресурсы клиента: закрывает все потоки уведомлений, отправляет открытые
    * накопители {@link telemetry}, затем останавливает очередь запросов.
    *
-   * Метод дожидается активных обработчиков потока, но не дольше `shutdownTimeout`. После
-   * вызова клиентом можно пользоваться снова; ранее созданный поток можно запустить
-   * повторным `connect()`.
+   * Метод дожидается завершения активных обработчиков и освобождения ресурсов остановленных
+   * событийных соединений, но не дольше `shutdownTimeout`. После вызова клиентом можно
+   * пользоваться снова; ранее созданный поток можно запустить повторным `connect()`.
    *
    * Общая очередь, полученная от {@link ItdAccounts}, не останавливается: её гасит сам
    * контейнер, когда закрывает все аккаунты разом.
    *
    * Терминальное освобождение — это {@link dispose}.
    *
-   * @throws {ItdStateError} если обработчики потока не завершились за отведённый срок
+   * @throws {ItdStateError} если остановка событийного соединения не завершилась за отведённый срок
    */
   close(): Promise<void>;
   /**
@@ -761,10 +769,11 @@ declare class ItdClient {
    *
    * Терминальное состояние устанавливается сразу при первом вызове. После этого новые
    * запросы, подключение плагинов, регистрация сервисов и создание или повторный запуск
-   * realtime-потоков завершаются с {@link ItdStateError}. Повторные вызовы возвращают
+   * событийных каналов завершаются с {@link ItdStateError}. Повторные вызовы возвращают
    * тот же результат очистки.
    *
-   * Ожидание обработчиков потока и операций плагинов ограничено `shutdownTimeout`.
+   * Ожидание остановки событийных соединений и операций плагинов ограничено
+   * `shutdownTimeout`.
    *
    * @example
    * ```ts
@@ -819,6 +828,16 @@ declare function createClient(options?: ItdClientOptions): ItdClient;
 //#region src/accounts.d.ts
 /** Как аккаунты делят между собой очередь запросов. */
 type RateLimitScope = 'account' | 'shared';
+/**
+ * Фабрика подключаемого модуля для клиентов {@link ItdAccounts}.
+ *
+ * `create()` вызывается отдельно для каждого аккаунта, поэтому описание модуля и его API
+ * между клиентами не разделяется. `key` публикует API как readonly-свойство клиента.
+ */
+interface AccountFeature<TApi = unknown> {
+  readonly key?: string | undefined;
+  create(): ClientFeature<TApi>;
+}
 /**
  * Опции конструктора {@link ItdAccounts}.
  *
@@ -834,6 +853,8 @@ interface ItdAccountsOptions extends Omit<ItdClientOptions, 'auth' | 'storage' |
   storage?: MultiTokenStorage | undefined;
   /** Плагины, подключаемые каждому аккаунту, в том числе добавленному позже. */
   plugins?: readonly ClientPlugin[] | undefined;
+  /** Модули, создаваемые и устанавливаемые отдельно для каждого аккаунта. */
+  features?: readonly AccountFeature[] | undefined;
   /**
    * Как делить очередь запросов. По умолчанию `'shared'` — одна на всех.
    *
@@ -935,7 +956,7 @@ declare class ItdAccounts {
   /**
    * Заводит аккаунт.
    *
-   * Возвращается обычный `ItdClient` — со всеми ресурсами, плагинами и `realtime()`.
+   * Возвращается обычный `ItdClient` — со всеми ресурсами, плагинами и каналом событий.
    * Хранилище ему подставляется само: срез общего по имени аккаунта.
    *
    * Опция `auth` не обязательна: когда сессия этого аккаунта уже лежит в хранилище,
@@ -1066,5 +1087,5 @@ declare class ItdAccounts {
  */
 declare function createAccounts(options?: ItdAccountsOptions): ItdAccounts;
 //#endregion
-export { ALLOWED_MIME_TYPES, AUDIO_MIME_TYPES, AccessType, type AccountEvents, type Actor, type AddAccountOptions, type AllowedMimeType, type Announcement, type AnnouncementButton, type Attachment, AttachmentType, type AttemptContext, type AttemptExtensions, type AttemptInterceptor, type AttemptNext, type AudioMimeType, type AuthEvents, type AuthIdentity, type AuthInput, type AuthResource, type AuthState, type Author, type AutoSpansOptions, BUCKET_LIMITS, type BuilderInput, type BuiltInOperationId, type CaptchaCredentials, type ChangelogEntry, type Clan, type ClientHooks, type ClientPlugin, type Comment, type CommentBuilder, type CommentInput, type CommentReplyTo, CommentSort, type CommentsParams, type CommentsResource, type CreateCommentInput, type CreatePollInput, type CreatePostData, type CreatePostInput, type CreateReportInput, type Credentials, type CredentialsAuth, type CustomOperationId, DEFAULT_BASE_URL, DEFAULT_RATE_LIMIT_BUCKET, type DwellEntry, type EnumerableKeyValueStore, type ErrorContextHook, type FeedParams, FeedTab, type FileContent, type FileContext, type FileInput, type FileStreamContent, type FileStreamOptions, FileTransferMode, type FilesResource, type FollowResult, type ForgotPasswordInput, type FromStreamOptions, type Hashtag, type HashtagPostsParams, type HashtagsResource, IMAGE_MIME_TYPES, type ImageMimeType, IncidentKind, type InteractionEntry, InteractionType, type IsoDate, ItdAbortError, ItdAccounts, type ItdAccountsOptions, ItdApiError, type ItdApiErrorInit, ItdApiErrorKind, ItdAuthError, type ItdBuilder, ItdClient, type ItdClientOptions, type ItdClock, ItdConfigError, ItdConflictError, ItdError, ItdErrorCode, ItdErrorKind, type ItdFieldErrors, ItdFileError, ItdFileErrorReason, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdPhoneVerificationError, ItdRateLimitError, ItdRealtime, ItdServerError, type ItdSession, ItdStateError, ItdTimeoutError, ItdValidationError, type KeyValueCodec, type KeyValueStore, type KeyValueStoreKeys, type KeyValueStoreResult, LIBRARY_VERSION, type LazyFile, type LikeResult, LikesVisibility, type Listener, type Logger, type Loose, type MarkupBuilder, type MarkupContent, type MarkupInput, type MarkupSpan, MemoryKeyValueStore, MemoryMultiTokenStorage, MemoryTokenStorage, type MultiTokenStorage, type MultiTokenStorageAdapterOptions, type MyProfile, type Notification, type NotificationEvent, type NotificationEventOfType, type NotificationListParams, type NotificationOfType, type NotificationSettings, NotificationType, type NotificationsResource, OPERATIONS, type ItdOperationDefinition as OperationDefinition, type OperationExtensions, type OperationId, type OperationMethod, type OperationRequestOptions, type OperationTransformer, type Page, type PageState, PaginationMode, type PaginationOptions, Paginator, type PaginatorOptions, type ParseMarkupOptions, type PaymentMethod, type PhotoOpenInput, type Pin, type PinPostResult, type PinsResult, type PlatformClientVersion, type PlatformResource, type PlatformStatus, type PlatformVersions, type PluginApi, type PluginTeardown, type Poll, type PollBuilder, type PollInput, type PollOption, type Portal, type Post, type PostBuilder, type PostInput, type PostStats, type PostUpdateInput, type PostsResource, type PrivacySettings, type Profile, type PublicProfile, type QueryParams, type QueryValue, type RateLimitBucket, type RateLimitBucketContext, type RateLimitBucketOverride, type RateLimitBucketState, type RateLimitOptions, RateLimitPacing, type RateLimitScope, type RawRequestOptions, RealtimeComposer, type RealtimeContext, type RealtimeContextBase, type RealtimeEngineEvents, type RealtimeErrorBoundary, type RealtimeErrorContext, type RealtimeEvents, type RealtimeFilter, type RealtimeHandler, type RealtimeMiddleware, type RealtimeMiddlewareGroup, type RealtimeMiddlewareLike, type RealtimeMiddlewareObj, type RealtimeNext, type RealtimeNotificationContext, type RealtimeNotificationFilter, type RealtimeNotificationSelector, type RealtimeNotificationUpdate, type RealtimeOptions, type RealtimePredicate, type RealtimeRequest, type RealtimeRequestInput, type RealtimeRouteSelector, type RealtimeRouteTable, RealtimeRouter, type RealtimeSequentializer, RealtimeStatus, type RealtimeTransport, RealtimeTransportKind, type RealtimeTypeGuard, type RealtimeUnknownUpdate, type RealtimeUnreadCountUpdate, type RealtimeUpdate, type RealtimeUpdateOfType, RealtimeUpdateOrigin, RealtimeUpdateType, type ReconnectOptions, type RecordKeyValueStoreSource, type RemoveAccountOptions, type RenderSpansOptions, type RepliesParams, type Report, type ReportBuilder, type ReportInput, ReportReason, ReportTargetType, type ReportsResource, type RequestContext, type RequestExtensions, type RequestOptions, type ResetPasswordInput, type ResponseContext, type RetryContext, type RetryDecisionContext, type RetryOptions, RetrySafety, RuntimeMode, type RuntimeOptions, STATUS_SERVICE, type SearchResource, type SearchResult, type ServiceDefinition, ServiceState, type ServiceStatus, type Session, type SessionOptions, type SignInResult, SignInStatus, type Span, SpanRenderFormat, SpanType, type StatusDay, type StatusIncidentLine, type StreamFile, type Subscription, type SubscriptionResource, type SubscriptionState, TURNSTILE_SITE_KEY, type TelemetryBatch, type TelemetryBatchOptions, type TelemetryClock, type TelemetryOptions, type TelemetryResource, type TextMarkup, type TokenStorage, type TokenStorageAdapterOptions, type TransportContext, type TransportEvent, UnauthorizedStreamError, type Unsubscribe, type UpdateNotificationSettingsInput, type UpdatePostInput, type UpdatePrivacyInput, type UpdateProfileInput, type UploadOptions, type UploadedFile, type UrlFile, type UrlFileOptions, type UserId, type UserListParams, type UserPostsParams, type UserRef, type UserSummary, type UsersResource, VIDEO_MIME_TYPES, type VerificationResource, type VerificationStatus, type VideoMimeType, type VideoProgressInput, ViewReason, ViewSource, type ViewTracker, type ViewTrackerInput, type ViewTrackerOptions, WallAccess, type WebSocketImplementationOptions, type WebSocketLike, type WebSocketOpenFailureClassifier, WebSocketTransport, type WebSocketTransportOptions, 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, type AccountEvents, type AccountFeature, type Actor, type AddAccountOptions, type AllowedMimeType, type Announcement, type AnnouncementButton, type Attachment, AttachmentType, type AttemptContext, type AttemptExtensions, type AttemptInterceptor, type AttemptNext, type AudioMimeType, type AuthEvents, type AuthIdentity, type AuthInput, type AuthProvider, type AuthResource, type AuthState, type Author, type AutoSpansOptions, BUCKET_LIMITS, type BuilderInput, type BuiltInOperationId, type CaptchaCredentials, type ChangelogEntry, type Clan, type ClientConnection, type ClientFeature, type ClientHooks, type ClientPlugin, type Comment, type CommentBuilder, type CommentInput, type CommentReplyTo, CommentSort, type CommentsParams, type CommentsResource, type CreateCommentInput, type CreatePollInput, type CreatePostData, type CreatePostInput, type CreateReportInput, type Credentials, type CredentialsAuth, type CustomOperationId, DEFAULT_BASE_URL, DEFAULT_RATE_LIMIT_BUCKET, type DwellEntry, type EnumerableKeyValueStore, type ErrorContextHook, EventChannel, type EventChannelDeps, type EventChannelEvents, type EventChannelOptions, EventChannelStatus, EventComposer, type EventContext, type EventEnqueueOptions, type EventErrorBoundary, type EventErrorContext, type EventFilter, type EventHandler, type EventMiddleware, type EventMiddlewareGroup, type EventMiddlewareLike, type EventMiddlewareObject, type EventNext, type EventPredicate, type EventRouteSelector, type EventRouteTable, EventRouter, type EventSequentializer, type EventSession, type EventSyncReason, type EventTransport, type EventTransportContext, type EventTransportFrame, type EventTypeGuard, type FeatureBucketDefinition, type FeatureContext, type FeatureInstallation, type FeatureOperationDefinition, type FeatureOperationId, type FeatureRequestOptions, type FeedParams, FeedTab, type FileContent, type FileContext, type FileInput, type FileResolver, type FileStreamContent, type FileStreamOptions, FileTransferMode, type FilesResource, type FollowResult, type ForgotPasswordInput, type FromStreamOptions, type Hashtag, type HashtagPostsParams, type HashtagsResource, IMAGE_MIME_TYPES, type ImageMimeType, IncidentKind, type InteractionEntry, InteractionType, type IsoDate, ItdAbortError, ItdAccounts, type ItdAccountsOptions, ItdApiError, type ItdApiErrorInit, ItdApiErrorKind, ItdAuthError, type ItdBuilder, ItdClient, type ItdClientOptions, type ItdClock, ItdConfigError, ItdConflictError, ItdError, ItdErrorCode, ItdErrorKind, type ItdFieldErrors, ItdFileError, ItdFileErrorReason, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdPhoneVerificationError, ItdRateLimitError, ItdServerError, type ItdSession, ItdStateError, ItdTimeoutError, ItdValidationError, type KeyValueCodec, type KeyValueStore, type KeyValueStoreKeys, type KeyValueStoreResult, LIBRARY_VERSION, type LazyFile, type LikeResult, LikesVisibility, type Listener, type Logger, type Loose, type ManagedClientResource, type MarkupBuilder, type MarkupContent, type MarkupInput, type MarkupSpan, MemoryKeyValueStore, MemoryMultiTokenStorage, MemoryTokenStorage, type MultiTokenStorage, type MultiTokenStorageAdapterOptions, type MyProfile, type Notification, type NotificationContext, type NotificationEvent, type NotificationEventContext, type NotificationEventFilter, type NotificationEventOfType, type NotificationEventSelector, NotificationEvents, NotificationEventsClient, type NotificationEventsClientOptions, type NotificationEventsMap, type NotificationEventsOptions, NotificationEventsTransport, type NotificationEventsUpdate, type NotificationListParams, type NotificationOfType, type NotificationSettings, NotificationType, type NotificationUpdate, type NotificationUpdateOfType, NotificationUpdateOrigin, NotificationUpdateType, type NotificationsApi, type NotificationsResource, OPERATIONS, type OperationAnnotations, type ItdOperationDefinition as OperationDefinition, type OperationExtensions, type OperationId, type OperationMetadata, type OperationMethod, type OperationRequestOptions, type OperationTransformer, type Page, type PageState, PaginationMode, type PaginationOptions, Paginator, type PaginatorOptions, type ParseMarkupOptions, type PaymentMethod, type PhotoOpenInput, type Pin, type PinPostResult, type PinsResult, type PlatformClientVersion, type PlatformResource, type PlatformStatus, type PlatformVersions, type PluginApi, type PluginTeardown, type Poll, type PollBuilder, type PollInput, type PollOption, type Portal, type Post, type PostBuilder, type PostInput, type PostStats, type PostUpdateInput, type PostsResource, type PreparedBufferSource, type PreparedFileSource, type PreparedStreamSource, type PrivacySettings, type Profile, type PublicProfile, type QueryParams, type QueryValue, type RateLimitBucket, type RateLimitBucketContext, type RateLimitBucketOverride, type RateLimitBucketState, type RateLimitOptions, RateLimitPacing, type RateLimitScope, type RawRequestOptions, type ReconnectOptions, type RecordKeyValueStoreSource, type RemoveAccountOptions, type RenderSpansOptions, type RepliesParams, type Report, type ReportBuilder, type ReportInput, ReportReason, ReportTargetType, type ReportsResource, type RequestContext, type RequestExtensions, type RequestOptions, type ResetPasswordInput, type ResolveFileContext, type ResolveFileOptions, type ResponseContext, type RetryContext, type RetryDecisionContext, type RetryOptions, RetrySafety, RuntimeMode, type RuntimeOptions, STATUS_SERVICE, type SearchResource, type SearchResult, type ServiceDefinition, ServiceState, type ServiceStatus, type Session, type SessionOptions, type SignInResult, SignInStatus, type Span, SpanRenderFormat, SpanType, type StatusDay, type StatusIncidentLine, type StreamFile, type Subscription, type SubscriptionResource, type SubscriptionState, TURNSTILE_SITE_KEY, type TelemetryBatch, type TelemetryBatchOptions, type TelemetryClock, type TelemetryOptions, type TelemetryResource, type TextMarkup, type TokenStorage, type TokenStorageAdapterOptions, UnauthorizedStreamError, type UnknownNotificationUpdate, type UnreadCountUpdate, type Unsubscribe, type UpdateNotificationSettingsInput, type UpdatePostInput, type UpdatePrivacyInput, type UpdateProfileInput, type UploadOptions, type UploadedFile, type UrlFile, type UrlFileOptions, type UserId, type UserListParams, type UserPostsParams, type UserRef, type UserSummary, type UsersResource, VIDEO_MIME_TYPES, type VerificationResource, type VerificationStatus, type VideoMimeType, type VideoProgressInput, ViewReason, ViewSource, type ViewTracker, type ViewTrackerInput, type ViewTrackerOptions, WallAccess, type WebSocketImplementationOptions, type WebSocketLike, type WebSocketOpenFailureClassifier, WebSocketTransport, type WebSocketTransportOptions, 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.d.cts.map