itd-api 0.0.10 → 0.0.11

package/dist/{index-CSjDNGCE.d.cts → index-CrlTO7sR.d.cts}

@@ -1398,7 +1398,7 @@ interface RawRequestOptions extends RequestOptions {
 }
 
 /** Версия библиотеки. Попадает в `User-Agent`. */
-declare const LIBRARY_VERSION = "0.0.10";
+declare const LIBRARY_VERSION = "0.0.11";
 
 /** Базовый URL API итд.com. Домен записан в punycode: `итд.com`. */
 declare const DEFAULT_BASE_URL = "https://xn--d1ah4a.com";
@@ -1421,7 +1421,7 @@ declare const DEFAULT_TIMEOUT = 30000;
  * В браузере заголовок не выставляется — `User-Agent` там запрещён к изменению, и среда
  * молча его игнорирует.
  */
-declare const DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; itd-api/0.0.10; +https://github.com/KiowDev/itd-api)";
+declare const DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; itd-api/0.0.11; +https://github.com/KiowDev/itd-api)";
 /** Настройки очереди со всеми значениями по умолчанию. */
 interface ResolvedRateLimitOptions {
     concurrency: number;
@@ -1635,6 +1635,17 @@ interface AuthEvents {
         error: unknown;
     };
 }
+/** Области аккаунта и конкретной сессии для локального состояния плагинов. */
+interface AuthIdentity {
+    /** Идентификатор пользователя; отсутствует у непрозрачного или повреждённого токена. */
+    userId?: UserId | undefined;
+    /** Идентификатор серверной сессии; отсутствует у непрозрачного или повреждённого токена. */
+    sessionId?: string | undefined;
+}
+interface AuthManagerHooks {
+    /** Вызывается синхронно перед заменой владельца авторизации. */
+    onAccountChange?: (() => void) | undefined;
+}
 /**
  * Хранит сессию и продлевает её.
  *
@@ -1645,13 +1656,22 @@ interface AuthEvents {
  */
 declare class AuthManager {
     #private;
-    constructor(config: AuthConfig, send: RequestHandler, jar: CookieJar);
+    constructor(config: AuthConfig, send: RequestHandler, jar: CookieJar, hooks?: AuthManagerHooks);
     /** Подписка на события авторизации. */
     get on(): Emitter<AuthEvents>['on'];
     /** Подписка на одно срабатывание. */
     get once(): Emitter<AuthEvents>['once'];
-    /** Непрозрачная область авторизации; токен и идентификатор пользователя не раскрываются. */
+    /**
+     * Непрозрачная fallback-область авторизации.
+     *
+     * Изолирует состояние плагинов, когда идентичность аккаунта из JWT недоступна (непрозрачный
+     * токен): значение уникально для владельца и сменяется при замене или очистке сессии.
+     */
     getAuthScope(): string;
+    /** Загружает сессию и возвращает идентификаторы аккаунта и сессии для плагинов. */
+    getAuthIdentity(): Promise<AuthIdentity>;
+    /** Идентификаторы аккаунта и сессии без чтения хранилища. @internal */
+    getCurrentAuthIdentity(): AuthIdentity;
     /**
      * Есть ли признак живой refresh-сессии.
      *
@@ -1740,13 +1760,19 @@ interface PluginContext {
     /** Отладочный вывод клиента, если он включён. */
     logger: Logger | undefined;
     /**
-     * Непрозрачная область текущей авторизации.
+     * Непрозрачная fallback-область текущей авторизации.
      *
-     * Значение уникально для клиента и меняется при замене либо очистке его сессии. Плагин может
-     * использовать его только для разделения состояния; идентификатор пользователя и токен в нём
-     * не раскрываются.
+     * Нужна плагинам, которые обязаны безопасно изолировать непрозрачный токен. Для объединения
+     * состояния копий одного аккаунта используйте {@link getAuthIdentity}.
      */
     getAuthScope?: (() => string) | undefined;
+    /**
+     * Загружает сессию и возвращает идентификаторы аккаунта и конкретной сессии из JWT.
+     *
+     * Предпочтительнее {@link getAuthScope} для состояния, которое должно объединяться между
+     * несколькими экземплярами клиента одного аккаунта.
+     */
+    getAuthIdentity?: (() => Promise<AuthIdentity>) | undefined;
     /** Добавляет обёртку запроса. Подключённые раньше оказываются снаружи. */
     use(transformer: Transformer): void;
 }
@@ -2104,6 +2130,10 @@ interface RealtimeDeps {
     fetch: typeof fetch;
     /** Общие заголовки клиента для адреса — см. {@link TransportContext.baseHeaders}. */
     baseHeaders: (url: string) => Promise<Headers>;
+    /** Идентификаторы аккаунта и сессии создавшего поток клиента. */
+    getAuthIdentity?: (() => AuthIdentity) | undefined;
+    /** Непрозрачная область авторизации создавшего поток клиента. */
+    getAuthScope?: (() => string) | undefined;
     getToken: () => Promise<string | null>;
     /** Обновляет токен после отказа авторизации. Возвращает `true`, если удалось. */
     refresh: () => Promise<boolean>;
@@ -2140,6 +2170,12 @@ declare class ItdRealtime {
     get status(): RealtimeStatus;
     /** Какой транспорт используется: `sse` или `poll`. */
     get transport(): string;
+    /** Базовый URL клиента, создавшего поток. @internal */
+    get baseUrl(): string;
+    /** Идентификаторы аккаунта и сессии клиента, создавшего поток. @internal */
+    getAuthIdentity(): AuthIdentity | undefined;
+    /** Непрозрачная область авторизации создавшего поток клиента. @internal */
+    getAuthScope(): string | undefined;
     /** Подписывается на событие потока. @returns функция отписки */
     on<K extends keyof RealtimeEvents>(event: K, listener: Listener<RealtimeEvents[K]>): Unsubscribe;
     /** Подписывается на одно срабатывание. */
@@ -4009,7 +4045,8 @@ declare class ItdClient {
      * Создаёт поток уведомлений в реальном времени.
      *
      * Каждый вызов даёт новый независимый поток; обычно он нужен один на приложение.
-     * Соединение поднимается методом `connect()` и держится само.
+     * Соединение поднимается методом `connect()` и держится само. Замена авторизации на токен
+     * другого пользователя завершает все потоки клиента; смена только сессии их не затрагивает.
      *
      * @example
      * ```ts
@@ -4818,4 +4855,4 @@ interface RenderSpansOptions {
  */
 declare function renderSpans(content: string, spans?: readonly Span[] | null | undefined, options?: RenderSpansOptions): string;
 
-export { DetectedRuntime as $, ALLOWED_MIME_TYPES as A, BUILT_IN_SERVICES as B, type CaptchaCredentials as C, type ClientHooks as D, type Comment as E, type FileReader as F, CommentBuilder as G, type CommentInput as H, type ItdSession as I, type CommentReplyTo as J, CommentSort as K, type CommentsParams as L, type MultiTokenStorage as M, CommentsResource as N, type CreateCommentInput as O, type CreatePollInput as P, type CreatePostInput as Q, type CreateReportInput as R, type Credentials as S, type TokenStorage as T, type CredentialsAuth as U, DEFAULT_BASE_URL as V, DEFAULT_STATUS_BASE_URL as W, DEFAULT_TIMEOUT as X, DEFAULT_UPLOAD_TIMEOUT as Y, DEFAULT_USER_AGENT as Z, DEVICE_ID_HEADER as _, ItdAccounts as a, type PageState as a$, type DwellEntry as a0, type ErrorContextHook as a1, type FeedParams as a2, FeedTab as a3, type FileInput as a4, FilesResource as a5, type FollowResult as a6, type ForgotPasswordInput as a7, type Hashtag as a8, type HashtagPostsParams as a9, ItdServerError as aA, ItdTimeoutError as aB, ItdValidationError as aC, LIBRARY_VERSION as aD, type LikeResult as aE, LikesVisibility as aF, type Listener as aG, LocalStorageTokenStorage as aH, type Logger as aI, type Loose as aJ, MAX_RECONNECT_ATTEMPTS as aK, MarkupBuilder as aL, type MarkupContent as aM, type MarkupInput as aN, type MarkupSpan as aO, MemoryMultiTokenStorage as aP, MemoryTokenStorage as aQ, type MyProfile as aR, NOTIFICATION_TYPE_ALIASES as aS, type Notification as aT, type NotificationEvent as aU, type NotificationListParams as aV, type NotificationSettings as aW, NotificationType as aX, NotificationsResource as aY, OAuthProvider as aZ, type Page as a_, HashtagsResource as aa, IMAGE_MIME_TYPES as ab, type ImageMimeType as ac, IncidentKind as ad, type InteractionEntry as ae, InteractionType as af, type IsoDate as ag, ItdAbortError as ah, ItdApiError as ai, type ItdApiErrorInit as aj, ItdApiErrorKind as ak, ItdAuthError as al, type ItdBuilder as am, ItdConfigError as an, ItdConflictError as ao, ItdError as ap, ItdErrorCode as aq, ItdErrorKind as ar, type ItdFieldErrors as as, ItdForbiddenError as at, ItdNetworkError as au, ItdNotFoundError as av, ItdPhoneVerificationError as aw, type ItdPlugin as ax, ItdRateLimitError as ay, ItdRealtime as az, type ItdAccountsOptions as b, type ServiceDefinition as b$, PaginationMode as b0, Paginator as b1, type PaginatorOptions as b2, type PaymentMethod as b3, type Pin as b4, type PinPostResult as b5, type PinsResult as b6, PlatformResource as b7, type PlatformStatus as b8, type PluginContext as b9, type RealtimeEvents as bA, type RealtimeOptions as bB, RealtimeStatus as bC, type RealtimeTransport as bD, RealtimeTransportKind as bE, type ReconnectOptions as bF, type RecordStorageSource as bG, type RemoveAccountOptions as bH, type RenderSpansOptions as bI, type RepliesParams as bJ, type Report as bK, ReportBuilder as bL, type ReportInput as bM, ReportReason as bN, ReportTargetType as bO, ReportsResource as bP, type RequestContext as bQ, type RequestOptions as bR, type ResetPasswordInput as bS, type ResponseContext as bT, type RetryContext as bU, type RetryOptions as bV, RuntimeMode as bW, STATUS_SERVICE as bX, STREAM_PATH as bY, SearchResource as bZ, type SearchResult as b_, type Poll as ba, PollBuilder as bb, type PollInput as bc, type PollOption as bd, type PollTransportOptions as be, type Portal as bf, type Post as bg, PostBuilder as bh, type PostInput as bi, type PostStats as bj, type PostUpdateInput as bk, PostsResource as bl, type PrivacySettings as bm, type Profile as bn, type PublicProfile as bo, type QueryParams as bp, type QueryValue as bq, RECONNECT_BACKOFF as br, RECONNECT_JITTER as bs, REFRESH_COOKIE as bt, REFRESH_COOKIE_PATH as bu, REQUEST_OPTION_KEYS as bv, type RateLimitOptions as bw, type RateLimitScope as bx, type RawRequestOptions as by, type RealtimeDeps as bz, ItdClient as c, mapPage as c$, ServiceRegistry as c0, ServiceState as c1, type ServiceStatus as c2, type Session as c3, type SignInResult as c4, SignInStatus as c5, type Span as c6, type SpanRenderFormat as c7, SpanType as c8, type SseTransportOptions as c9, VIDEO_MIME_TYPES as cA, VerificationResource as cB, type VerificationStatus as cC, type VideoMimeType as cD, ViewReason as cE, ViewSource as cF, WallAccess as cG, autoSpans as cH, canonicalNotificationType as cI, comment as cJ, createMultiTokenStorage as cK, createRecordMultiStorage as cL, createTokenStorage as cM, formatNotificationText as cN, isBuilder as cO, isItdApiError as cP, isItdAuthError as cQ, isItdConflictError as cR, isItdError as cS, isItdForbiddenError as cT, isItdNotFoundError as cU, isItdPhoneVerificationError as cV, isItdRateLimitError as cW, isItdServerError as cX, isItdValidationError as cY, isKnownNotificationType as cZ, isMyProfile as c_, type StatusDay as ca, type StatusIncidentLine as cb, type Subscription as cc, SubscriptionResource as cd, type SubscriptionState as ce, TURNSTILE_SITE_KEY as cf, type TelemetryOptions as cg, TelemetryResource as ch, type TextMarkup as ci, type Transformer as cj, type TransportContext as ck, type TransportEvent as cl, UnauthorizedStreamError as cm, type Unsubscribe as cn, type UpdateNotificationSettingsInput as co, type UpdatePostInput as cp, type UpdatePrivacyInput as cq, type UpdateProfileInput as cr, type UploadOptions as cs, type UploadedFile as ct, type UserId as cu, type UserListParams as cv, type UserPostsParams as cw, type UserRef as cx, type UserSummary as cy, UsersResource as cz, type ItdClientOptions as d, markup as d0, normalizeNotification as d1, poll as d2, post as d3, readNotificationEvent as d4, readUnreadCountEvent as d5, renderSpans as d6, report as d7, resolveNotificationUrl as d8, scopedTokenStorage as d9, statusDays as da, toDate as db, utcStampToIso as dc, createAccounts as dd, createClient as de, type ItdClientInternals as e, AUDIO_MIME_TYPES as f, AUTH_FLAG_COOKIE as g, AUTH_PATHS as h, AccessType as i, type AccountEvents as j, type Actor as k, type AddAccountOptions as l, type AllowedMimeType as m, type Announcement as n, type AnnouncementButton as o, type Attachment as p, AttachmentType as q, type AudioMimeType as r, type AuthEvents as s, type AuthInput as t, AuthResource as u, type Author as v, type AutoSpansOptions as w, type BuilderInput as x, type ChangelogEntry as y, type Clan as z };
+export { DEVICE_ID_HEADER as $, ALLOWED_MIME_TYPES as A, BUILT_IN_SERVICES as B, type CaptchaCredentials as C, type Clan as D, type ClientHooks as E, type FileReader as F, type Comment as G, CommentBuilder as H, type ItdSession as I, type CommentInput as J, type CommentReplyTo as K, CommentSort as L, type MultiTokenStorage as M, type CommentsParams as N, CommentsResource as O, type CreateCommentInput as P, type CreatePollInput as Q, type CreatePostInput as R, type CreateReportInput as S, type TokenStorage as T, type Credentials as U, type CredentialsAuth as V, DEFAULT_BASE_URL as W, DEFAULT_STATUS_BASE_URL as X, DEFAULT_TIMEOUT as Y, DEFAULT_UPLOAD_TIMEOUT as Z, DEFAULT_USER_AGENT as _, ItdAccounts as a, type Page as a$, DetectedRuntime as a0, type DwellEntry as a1, type ErrorContextHook as a2, type FeedParams as a3, FeedTab as a4, type FileInput as a5, FilesResource as a6, type FollowResult as a7, type ForgotPasswordInput as a8, type Hashtag as a9, ItdRealtime as aA, ItdServerError as aB, ItdTimeoutError as aC, ItdValidationError as aD, LIBRARY_VERSION as aE, type LikeResult as aF, LikesVisibility as aG, type Listener as aH, LocalStorageTokenStorage as aI, type Logger as aJ, type Loose as aK, MAX_RECONNECT_ATTEMPTS as aL, MarkupBuilder as aM, type MarkupContent as aN, type MarkupInput as aO, type MarkupSpan as aP, MemoryMultiTokenStorage as aQ, MemoryTokenStorage as aR, type MyProfile as aS, NOTIFICATION_TYPE_ALIASES as aT, type Notification as aU, type NotificationEvent as aV, type NotificationListParams as aW, type NotificationSettings as aX, NotificationType as aY, NotificationsResource as aZ, OAuthProvider as a_, type HashtagPostsParams as aa, HashtagsResource as ab, IMAGE_MIME_TYPES as ac, type ImageMimeType as ad, IncidentKind as ae, type InteractionEntry as af, InteractionType as ag, type IsoDate as ah, ItdAbortError as ai, ItdApiError as aj, type ItdApiErrorInit as ak, ItdApiErrorKind as al, ItdAuthError as am, type ItdBuilder as an, ItdConfigError as ao, ItdConflictError as ap, ItdError as aq, ItdErrorCode as ar, ItdErrorKind as as, type ItdFieldErrors as at, ItdForbiddenError as au, ItdNetworkError as av, ItdNotFoundError as aw, ItdPhoneVerificationError as ax, type ItdPlugin as ay, ItdRateLimitError as az, type ItdAccountsOptions as b, type SearchResult as b$, type PageState as b0, PaginationMode as b1, Paginator as b2, type PaginatorOptions as b3, type PaymentMethod as b4, type Pin as b5, type PinPostResult as b6, type PinsResult as b7, PlatformResource as b8, type PlatformStatus as b9, type RealtimeDeps as bA, type RealtimeEvents as bB, type RealtimeOptions as bC, RealtimeStatus as bD, type RealtimeTransport as bE, RealtimeTransportKind as bF, type ReconnectOptions as bG, type RecordStorageSource as bH, type RemoveAccountOptions as bI, type RenderSpansOptions as bJ, type RepliesParams as bK, type Report as bL, ReportBuilder as bM, type ReportInput as bN, ReportReason as bO, ReportTargetType as bP, ReportsResource as bQ, type RequestContext as bR, type RequestOptions as bS, type ResetPasswordInput as bT, type ResponseContext as bU, type RetryContext as bV, type RetryOptions as bW, RuntimeMode as bX, STATUS_SERVICE as bY, STREAM_PATH as bZ, SearchResource as b_, type PluginContext as ba, type Poll as bb, PollBuilder as bc, type PollInput as bd, type PollOption as be, type PollTransportOptions as bf, type Portal as bg, type Post as bh, PostBuilder as bi, type PostInput as bj, type PostStats as bk, type PostUpdateInput as bl, PostsResource as bm, type PrivacySettings as bn, type Profile as bo, type PublicProfile as bp, type QueryParams as bq, type QueryValue as br, RECONNECT_BACKOFF as bs, RECONNECT_JITTER as bt, REFRESH_COOKIE as bu, REFRESH_COOKIE_PATH as bv, REQUEST_OPTION_KEYS as bw, type RateLimitOptions as bx, type RateLimitScope as by, type RawRequestOptions as bz, ItdClient as c, isMyProfile as c$, type ServiceDefinition as c0, ServiceRegistry as c1, ServiceState as c2, type ServiceStatus as c3, type Session as c4, type SignInResult as c5, SignInStatus as c6, type Span as c7, type SpanRenderFormat as c8, SpanType as c9, UsersResource as cA, VIDEO_MIME_TYPES as cB, VerificationResource as cC, type VerificationStatus as cD, type VideoMimeType as cE, ViewReason as cF, ViewSource as cG, WallAccess as cH, autoSpans as cI, canonicalNotificationType as cJ, comment as cK, createMultiTokenStorage as cL, createRecordMultiStorage as cM, createTokenStorage as cN, formatNotificationText as cO, isBuilder as cP, isItdApiError as cQ, isItdAuthError as cR, isItdConflictError as cS, isItdError as cT, isItdForbiddenError as cU, isItdNotFoundError as cV, isItdPhoneVerificationError as cW, isItdRateLimitError as cX, isItdServerError as cY, isItdValidationError as cZ, isKnownNotificationType as c_, type SseTransportOptions as ca, type StatusDay as cb, type StatusIncidentLine as cc, type Subscription as cd, SubscriptionResource as ce, type SubscriptionState as cf, TURNSTILE_SITE_KEY as cg, type TelemetryOptions as ch, TelemetryResource as ci, type TextMarkup as cj, type Transformer as ck, type TransportContext as cl, type TransportEvent as cm, UnauthorizedStreamError as cn, type Unsubscribe as co, type UpdateNotificationSettingsInput as cp, type UpdatePostInput as cq, type UpdatePrivacyInput as cr, type UpdateProfileInput as cs, type UploadOptions as ct, type UploadedFile as cu, type UserId as cv, type UserListParams as cw, type UserPostsParams as cx, type UserRef as cy, type UserSummary as cz, type ItdClientOptions as d, mapPage as d0, markup as d1, normalizeNotification as d2, poll as d3, post as d4, readNotificationEvent as d5, readUnreadCountEvent as d6, renderSpans as d7, report as d8, resolveNotificationUrl as d9, scopedTokenStorage as da, statusDays as db, toDate as dc, utcStampToIso as dd, createAccounts as de, createClient as df, type ItdClientInternals as e, AUDIO_MIME_TYPES as f, AUTH_FLAG_COOKIE as g, AUTH_PATHS as h, AccessType as i, type AccountEvents as j, type Actor as k, type AddAccountOptions as l, type AllowedMimeType as m, type Announcement as n, type AnnouncementButton as o, type Attachment as p, AttachmentType as q, type AudioMimeType as r, type AuthEvents as s, type AuthIdentity as t, type AuthInput as u, AuthResource as v, type Author as w, type AutoSpansOptions as x, type BuilderInput as y, type ChangelogEntry as z };

package/dist/{index-CSjDNGCE.d.ts → index-CrlTO7sR.d.ts}

@@ -1398,7 +1398,7 @@ interface RawRequestOptions extends RequestOptions {
 }
 
 /** Версия библиотеки. Попадает в `User-Agent`. */
-declare const LIBRARY_VERSION = "0.0.10";
+declare const LIBRARY_VERSION = "0.0.11";
 
 /** Базовый URL API итд.com. Домен записан в punycode: `итд.com`. */
 declare const DEFAULT_BASE_URL = "https://xn--d1ah4a.com";
@@ -1421,7 +1421,7 @@ declare const DEFAULT_TIMEOUT = 30000;
  * В браузере заголовок не выставляется — `User-Agent` там запрещён к изменению, и среда
  * молча его игнорирует.
  */
-declare const DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; itd-api/0.0.10; +https://github.com/KiowDev/itd-api)";
+declare const DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; itd-api/0.0.11; +https://github.com/KiowDev/itd-api)";
 /** Настройки очереди со всеми значениями по умолчанию. */
 interface ResolvedRateLimitOptions {
     concurrency: number;
@@ -1635,6 +1635,17 @@ interface AuthEvents {
         error: unknown;
     };
 }
+/** Области аккаунта и конкретной сессии для локального состояния плагинов. */
+interface AuthIdentity {
+    /** Идентификатор пользователя; отсутствует у непрозрачного или повреждённого токена. */
+    userId?: UserId | undefined;
+    /** Идентификатор серверной сессии; отсутствует у непрозрачного или повреждённого токена. */
+    sessionId?: string | undefined;
+}
+interface AuthManagerHooks {
+    /** Вызывается синхронно перед заменой владельца авторизации. */
+    onAccountChange?: (() => void) | undefined;
+}
 /**
  * Хранит сессию и продлевает её.
  *
@@ -1645,13 +1656,22 @@ interface AuthEvents {
  */
 declare class AuthManager {
     #private;
-    constructor(config: AuthConfig, send: RequestHandler, jar: CookieJar);
+    constructor(config: AuthConfig, send: RequestHandler, jar: CookieJar, hooks?: AuthManagerHooks);
     /** Подписка на события авторизации. */
     get on(): Emitter<AuthEvents>['on'];
     /** Подписка на одно срабатывание. */
     get once(): Emitter<AuthEvents>['once'];
-    /** Непрозрачная область авторизации; токен и идентификатор пользователя не раскрываются. */
+    /**
+     * Непрозрачная fallback-область авторизации.
+     *
+     * Изолирует состояние плагинов, когда идентичность аккаунта из JWT недоступна (непрозрачный
+     * токен): значение уникально для владельца и сменяется при замене или очистке сессии.
+     */
     getAuthScope(): string;
+    /** Загружает сессию и возвращает идентификаторы аккаунта и сессии для плагинов. */
+    getAuthIdentity(): Promise<AuthIdentity>;
+    /** Идентификаторы аккаунта и сессии без чтения хранилища. @internal */
+    getCurrentAuthIdentity(): AuthIdentity;
     /**
      * Есть ли признак живой refresh-сессии.
      *
@@ -1740,13 +1760,19 @@ interface PluginContext {
     /** Отладочный вывод клиента, если он включён. */
     logger: Logger | undefined;
     /**
-     * Непрозрачная область текущей авторизации.
+     * Непрозрачная fallback-область текущей авторизации.
      *
-     * Значение уникально для клиента и меняется при замене либо очистке его сессии. Плагин может
-     * использовать его только для разделения состояния; идентификатор пользователя и токен в нём
-     * не раскрываются.
+     * Нужна плагинам, которые обязаны безопасно изолировать непрозрачный токен. Для объединения
+     * состояния копий одного аккаунта используйте {@link getAuthIdentity}.
      */
     getAuthScope?: (() => string) | undefined;
+    /**
+     * Загружает сессию и возвращает идентификаторы аккаунта и конкретной сессии из JWT.
+     *
+     * Предпочтительнее {@link getAuthScope} для состояния, которое должно объединяться между
+     * несколькими экземплярами клиента одного аккаунта.
+     */
+    getAuthIdentity?: (() => Promise<AuthIdentity>) | undefined;
     /** Добавляет обёртку запроса. Подключённые раньше оказываются снаружи. */
     use(transformer: Transformer): void;
 }
@@ -2104,6 +2130,10 @@ interface RealtimeDeps {
     fetch: typeof fetch;
     /** Общие заголовки клиента для адреса — см. {@link TransportContext.baseHeaders}. */
     baseHeaders: (url: string) => Promise<Headers>;
+    /** Идентификаторы аккаунта и сессии создавшего поток клиента. */
+    getAuthIdentity?: (() => AuthIdentity) | undefined;
+    /** Непрозрачная область авторизации создавшего поток клиента. */
+    getAuthScope?: (() => string) | undefined;
     getToken: () => Promise<string | null>;
     /** Обновляет токен после отказа авторизации. Возвращает `true`, если удалось. */
     refresh: () => Promise<boolean>;
@@ -2140,6 +2170,12 @@ declare class ItdRealtime {
     get status(): RealtimeStatus;
     /** Какой транспорт используется: `sse` или `poll`. */
     get transport(): string;
+    /** Базовый URL клиента, создавшего поток. @internal */
+    get baseUrl(): string;
+    /** Идентификаторы аккаунта и сессии клиента, создавшего поток. @internal */
+    getAuthIdentity(): AuthIdentity | undefined;
+    /** Непрозрачная область авторизации создавшего поток клиента. @internal */
+    getAuthScope(): string | undefined;
     /** Подписывается на событие потока. @returns функция отписки */
     on<K extends keyof RealtimeEvents>(event: K, listener: Listener<RealtimeEvents[K]>): Unsubscribe;
     /** Подписывается на одно срабатывание. */
@@ -4009,7 +4045,8 @@ declare class ItdClient {
      * Создаёт поток уведомлений в реальном времени.
      *
      * Каждый вызов даёт новый независимый поток; обычно он нужен один на приложение.
-     * Соединение поднимается методом `connect()` и держится само.
+     * Соединение поднимается методом `connect()` и держится само. Замена авторизации на токен
+     * другого пользователя завершает все потоки клиента; смена только сессии их не затрагивает.
      *
      * @example
      * ```ts
@@ -4818,4 +4855,4 @@ interface RenderSpansOptions {
  */
 declare function renderSpans(content: string, spans?: readonly Span[] | null | undefined, options?: RenderSpansOptions): string;
 
-export { DetectedRuntime as $, ALLOWED_MIME_TYPES as A, BUILT_IN_SERVICES as B, type CaptchaCredentials as C, type ClientHooks as D, type Comment as E, type FileReader as F, CommentBuilder as G, type CommentInput as H, type ItdSession as I, type CommentReplyTo as J, CommentSort as K, type CommentsParams as L, type MultiTokenStorage as M, CommentsResource as N, type CreateCommentInput as O, type CreatePollInput as P, type CreatePostInput as Q, type CreateReportInput as R, type Credentials as S, type TokenStorage as T, type CredentialsAuth as U, DEFAULT_BASE_URL as V, DEFAULT_STATUS_BASE_URL as W, DEFAULT_TIMEOUT as X, DEFAULT_UPLOAD_TIMEOUT as Y, DEFAULT_USER_AGENT as Z, DEVICE_ID_HEADER as _, ItdAccounts as a, type PageState as a$, type DwellEntry as a0, type ErrorContextHook as a1, type FeedParams as a2, FeedTab as a3, type FileInput as a4, FilesResource as a5, type FollowResult as a6, type ForgotPasswordInput as a7, type Hashtag as a8, type HashtagPostsParams as a9, ItdServerError as aA, ItdTimeoutError as aB, ItdValidationError as aC, LIBRARY_VERSION as aD, type LikeResult as aE, LikesVisibility as aF, type Listener as aG, LocalStorageTokenStorage as aH, type Logger as aI, type Loose as aJ, MAX_RECONNECT_ATTEMPTS as aK, MarkupBuilder as aL, type MarkupContent as aM, type MarkupInput as aN, type MarkupSpan as aO, MemoryMultiTokenStorage as aP, MemoryTokenStorage as aQ, type MyProfile as aR, NOTIFICATION_TYPE_ALIASES as aS, type Notification as aT, type NotificationEvent as aU, type NotificationListParams as aV, type NotificationSettings as aW, NotificationType as aX, NotificationsResource as aY, OAuthProvider as aZ, type Page as a_, HashtagsResource as aa, IMAGE_MIME_TYPES as ab, type ImageMimeType as ac, IncidentKind as ad, type InteractionEntry as ae, InteractionType as af, type IsoDate as ag, ItdAbortError as ah, ItdApiError as ai, type ItdApiErrorInit as aj, ItdApiErrorKind as ak, ItdAuthError as al, type ItdBuilder as am, ItdConfigError as an, ItdConflictError as ao, ItdError as ap, ItdErrorCode as aq, ItdErrorKind as ar, type ItdFieldErrors as as, ItdForbiddenError as at, ItdNetworkError as au, ItdNotFoundError as av, ItdPhoneVerificationError as aw, type ItdPlugin as ax, ItdRateLimitError as ay, ItdRealtime as az, type ItdAccountsOptions as b, type ServiceDefinition as b$, PaginationMode as b0, Paginator as b1, type PaginatorOptions as b2, type PaymentMethod as b3, type Pin as b4, type PinPostResult as b5, type PinsResult as b6, PlatformResource as b7, type PlatformStatus as b8, type PluginContext as b9, type RealtimeEvents as bA, type RealtimeOptions as bB, RealtimeStatus as bC, type RealtimeTransport as bD, RealtimeTransportKind as bE, type ReconnectOptions as bF, type RecordStorageSource as bG, type RemoveAccountOptions as bH, type RenderSpansOptions as bI, type RepliesParams as bJ, type Report as bK, ReportBuilder as bL, type ReportInput as bM, ReportReason as bN, ReportTargetType as bO, ReportsResource as bP, type RequestContext as bQ, type RequestOptions as bR, type ResetPasswordInput as bS, type ResponseContext as bT, type RetryContext as bU, type RetryOptions as bV, RuntimeMode as bW, STATUS_SERVICE as bX, STREAM_PATH as bY, SearchResource as bZ, type SearchResult as b_, type Poll as ba, PollBuilder as bb, type PollInput as bc, type PollOption as bd, type PollTransportOptions as be, type Portal as bf, type Post as bg, PostBuilder as bh, type PostInput as bi, type PostStats as bj, type PostUpdateInput as bk, PostsResource as bl, type PrivacySettings as bm, type Profile as bn, type PublicProfile as bo, type QueryParams as bp, type QueryValue as bq, RECONNECT_BACKOFF as br, RECONNECT_JITTER as bs, REFRESH_COOKIE as bt, REFRESH_COOKIE_PATH as bu, REQUEST_OPTION_KEYS as bv, type RateLimitOptions as bw, type RateLimitScope as bx, type RawRequestOptions as by, type RealtimeDeps as bz, ItdClient as c, mapPage as c$, ServiceRegistry as c0, ServiceState as c1, type ServiceStatus as c2, type Session as c3, type SignInResult as c4, SignInStatus as c5, type Span as c6, type SpanRenderFormat as c7, SpanType as c8, type SseTransportOptions as c9, VIDEO_MIME_TYPES as cA, VerificationResource as cB, type VerificationStatus as cC, type VideoMimeType as cD, ViewReason as cE, ViewSource as cF, WallAccess as cG, autoSpans as cH, canonicalNotificationType as cI, comment as cJ, createMultiTokenStorage as cK, createRecordMultiStorage as cL, createTokenStorage as cM, formatNotificationText as cN, isBuilder as cO, isItdApiError as cP, isItdAuthError as cQ, isItdConflictError as cR, isItdError as cS, isItdForbiddenError as cT, isItdNotFoundError as cU, isItdPhoneVerificationError as cV, isItdRateLimitError as cW, isItdServerError as cX, isItdValidationError as cY, isKnownNotificationType as cZ, isMyProfile as c_, type StatusDay as ca, type StatusIncidentLine as cb, type Subscription as cc, SubscriptionResource as cd, type SubscriptionState as ce, TURNSTILE_SITE_KEY as cf, type TelemetryOptions as cg, TelemetryResource as ch, type TextMarkup as ci, type Transformer as cj, type TransportContext as ck, type TransportEvent as cl, UnauthorizedStreamError as cm, type Unsubscribe as cn, type UpdateNotificationSettingsInput as co, type UpdatePostInput as cp, type UpdatePrivacyInput as cq, type UpdateProfileInput as cr, type UploadOptions as cs, type UploadedFile as ct, type UserId as cu, type UserListParams as cv, type UserPostsParams as cw, type UserRef as cx, type UserSummary as cy, UsersResource as cz, type ItdClientOptions as d, markup as d0, normalizeNotification as d1, poll as d2, post as d3, readNotificationEvent as d4, readUnreadCountEvent as d5, renderSpans as d6, report as d7, resolveNotificationUrl as d8, scopedTokenStorage as d9, statusDays as da, toDate as db, utcStampToIso as dc, createAccounts as dd, createClient as de, type ItdClientInternals as e, AUDIO_MIME_TYPES as f, AUTH_FLAG_COOKIE as g, AUTH_PATHS as h, AccessType as i, type AccountEvents as j, type Actor as k, type AddAccountOptions as l, type AllowedMimeType as m, type Announcement as n, type AnnouncementButton as o, type Attachment as p, AttachmentType as q, type AudioMimeType as r, type AuthEvents as s, type AuthInput as t, AuthResource as u, type Author as v, type AutoSpansOptions as w, type BuilderInput as x, type ChangelogEntry as y, type Clan as z };
+export { DEVICE_ID_HEADER as $, ALLOWED_MIME_TYPES as A, BUILT_IN_SERVICES as B, type CaptchaCredentials as C, type Clan as D, type ClientHooks as E, type FileReader as F, type Comment as G, CommentBuilder as H, type ItdSession as I, type CommentInput as J, type CommentReplyTo as K, CommentSort as L, type MultiTokenStorage as M, type CommentsParams as N, CommentsResource as O, type CreateCommentInput as P, type CreatePollInput as Q, type CreatePostInput as R, type CreateReportInput as S, type TokenStorage as T, type Credentials as U, type CredentialsAuth as V, DEFAULT_BASE_URL as W, DEFAULT_STATUS_BASE_URL as X, DEFAULT_TIMEOUT as Y, DEFAULT_UPLOAD_TIMEOUT as Z, DEFAULT_USER_AGENT as _, ItdAccounts as a, type Page as a$, DetectedRuntime as a0, type DwellEntry as a1, type ErrorContextHook as a2, type FeedParams as a3, FeedTab as a4, type FileInput as a5, FilesResource as a6, type FollowResult as a7, type ForgotPasswordInput as a8, type Hashtag as a9, ItdRealtime as aA, ItdServerError as aB, ItdTimeoutError as aC, ItdValidationError as aD, LIBRARY_VERSION as aE, type LikeResult as aF, LikesVisibility as aG, type Listener as aH, LocalStorageTokenStorage as aI, type Logger as aJ, type Loose as aK, MAX_RECONNECT_ATTEMPTS as aL, MarkupBuilder as aM, type MarkupContent as aN, type MarkupInput as aO, type MarkupSpan as aP, MemoryMultiTokenStorage as aQ, MemoryTokenStorage as aR, type MyProfile as aS, NOTIFICATION_TYPE_ALIASES as aT, type Notification as aU, type NotificationEvent as aV, type NotificationListParams as aW, type NotificationSettings as aX, NotificationType as aY, NotificationsResource as aZ, OAuthProvider as a_, type HashtagPostsParams as aa, HashtagsResource as ab, IMAGE_MIME_TYPES as ac, type ImageMimeType as ad, IncidentKind as ae, type InteractionEntry as af, InteractionType as ag, type IsoDate as ah, ItdAbortError as ai, ItdApiError as aj, type ItdApiErrorInit as ak, ItdApiErrorKind as al, ItdAuthError as am, type ItdBuilder as an, ItdConfigError as ao, ItdConflictError as ap, ItdError as aq, ItdErrorCode as ar, ItdErrorKind as as, type ItdFieldErrors as at, ItdForbiddenError as au, ItdNetworkError as av, ItdNotFoundError as aw, ItdPhoneVerificationError as ax, type ItdPlugin as ay, ItdRateLimitError as az, type ItdAccountsOptions as b, type SearchResult as b$, type PageState as b0, PaginationMode as b1, Paginator as b2, type PaginatorOptions as b3, type PaymentMethod as b4, type Pin as b5, type PinPostResult as b6, type PinsResult as b7, PlatformResource as b8, type PlatformStatus as b9, type RealtimeDeps as bA, type RealtimeEvents as bB, type RealtimeOptions as bC, RealtimeStatus as bD, type RealtimeTransport as bE, RealtimeTransportKind as bF, type ReconnectOptions as bG, type RecordStorageSource as bH, type RemoveAccountOptions as bI, type RenderSpansOptions as bJ, type RepliesParams as bK, type Report as bL, ReportBuilder as bM, type ReportInput as bN, ReportReason as bO, ReportTargetType as bP, ReportsResource as bQ, type RequestContext as bR, type RequestOptions as bS, type ResetPasswordInput as bT, type ResponseContext as bU, type RetryContext as bV, type RetryOptions as bW, RuntimeMode as bX, STATUS_SERVICE as bY, STREAM_PATH as bZ, SearchResource as b_, type PluginContext as ba, type Poll as bb, PollBuilder as bc, type PollInput as bd, type PollOption as be, type PollTransportOptions as bf, type Portal as bg, type Post as bh, PostBuilder as bi, type PostInput as bj, type PostStats as bk, type PostUpdateInput as bl, PostsResource as bm, type PrivacySettings as bn, type Profile as bo, type PublicProfile as bp, type QueryParams as bq, type QueryValue as br, RECONNECT_BACKOFF as bs, RECONNECT_JITTER as bt, REFRESH_COOKIE as bu, REFRESH_COOKIE_PATH as bv, REQUEST_OPTION_KEYS as bw, type RateLimitOptions as bx, type RateLimitScope as by, type RawRequestOptions as bz, ItdClient as c, isMyProfile as c$, type ServiceDefinition as c0, ServiceRegistry as c1, ServiceState as c2, type ServiceStatus as c3, type Session as c4, type SignInResult as c5, SignInStatus as c6, type Span as c7, type SpanRenderFormat as c8, SpanType as c9, UsersResource as cA, VIDEO_MIME_TYPES as cB, VerificationResource as cC, type VerificationStatus as cD, type VideoMimeType as cE, ViewReason as cF, ViewSource as cG, WallAccess as cH, autoSpans as cI, canonicalNotificationType as cJ, comment as cK, createMultiTokenStorage as cL, createRecordMultiStorage as cM, createTokenStorage as cN, formatNotificationText as cO, isBuilder as cP, isItdApiError as cQ, isItdAuthError as cR, isItdConflictError as cS, isItdError as cT, isItdForbiddenError as cU, isItdNotFoundError as cV, isItdPhoneVerificationError as cW, isItdRateLimitError as cX, isItdServerError as cY, isItdValidationError as cZ, isKnownNotificationType as c_, type SseTransportOptions as ca, type StatusDay as cb, type StatusIncidentLine as cc, type Subscription as cd, SubscriptionResource as ce, type SubscriptionState as cf, TURNSTILE_SITE_KEY as cg, type TelemetryOptions as ch, TelemetryResource as ci, type TextMarkup as cj, type Transformer as ck, type TransportContext as cl, type TransportEvent as cm, UnauthorizedStreamError as cn, type Unsubscribe as co, type UpdateNotificationSettingsInput as cp, type UpdatePostInput as cq, type UpdatePrivacyInput as cr, type UpdateProfileInput as cs, type UploadOptions as ct, type UploadedFile as cu, type UserId as cv, type UserListParams as cw, type UserPostsParams as cx, type UserRef as cy, type UserSummary as cz, type ItdClientOptions as d, mapPage as d0, markup as d1, normalizeNotification as d2, poll as d3, post as d4, readNotificationEvent as d5, readUnreadCountEvent as d6, renderSpans as d7, report as d8, resolveNotificationUrl as d9, scopedTokenStorage as da, statusDays as db, toDate as dc, utcStampToIso as dd, createAccounts as de, createClient as df, type ItdClientInternals as e, AUDIO_MIME_TYPES as f, AUTH_FLAG_COOKIE as g, AUTH_PATHS as h, AccessType as i, type AccountEvents as j, type Actor as k, type AddAccountOptions as l, type AllowedMimeType as m, type Announcement as n, type AnnouncementButton as o, type Attachment as p, AttachmentType as q, type AudioMimeType as r, type AuthEvents as s, type AuthIdentity as t, type AuthInput as u, AuthResource as v, type Author as w, type AutoSpansOptions as x, type BuilderInput as y, type ChangelogEntry as z };