itd-api 0.0.7 → 0.0.9

package/dist/index.d.cts

@@ -1 +1,4206 @@
-export { A as ALLOWED_MIME_TYPES, c as AUDIO_MIME_TYPES, d as AUTH_FLAG_COOKIE, e as AUTH_PATHS, f as AccessType, g as Actor, h as AllowedMimeType, i as Announcement, j as AnnouncementButton, k as Attachment, l as AttachmentType, m as AudioMimeType, n as AuthInput, o as AuthResource, p as Author, B as BuilderInput, C as CaptchaCredentials, q as ChangelogEntry, r as Clan, s as ClientHooks, t as Comment, u as CommentBuilder, v as CommentInput, w as CommentReplyTo, x as CommentSort, y as CommentsParams, z as CommentsResource, D as CreateCommentInput, E as CreatePollInput, G as CreatePostInput, H as CreateReportInput, J as Credentials, K as CredentialsAuth, L as DEFAULT_BASE_URL, M as DEFAULT_TIMEOUT, N as DEFAULT_USER_AGENT, O as DEVICE_ID_HEADER, P as DetectedRuntime, Q as DwellEntry, R as ErrorContextHook, S as FeedParams, U as FeedTab, V as FileInput, W as FilesResource, X as FollowResult, Y as ForgotPasswordInput, Z as Hashtag, _ as HashtagPostsParams, $ as HashtagsResource, a0 as IMAGE_MIME_TYPES, a1 as ImageMimeType, a2 as InteractionEntry, a3 as InteractionType, a4 as IsoDate, a5 as ItdAbortError, a6 as ItdApiError, a7 as ItdApiErrorInit, a8 as ItdApiErrorKind, a9 as ItdAuthError, aa as ItdBuilder, a as ItdClient, b as ItdClientOptions, ab as ItdConfigError, ac as ItdConflictError, ad as ItdError, ae as ItdErrorCode, af as ItdErrorKind, ag as ItdFieldErrors, ah as ItdForbiddenError, ai as ItdNetworkError, aj as ItdNotFoundError, ak as ItdPhoneVerificationError, al as ItdPlugin, am as ItdRateLimitError, an as ItdRealtime, ao as ItdServerError, I as ItdSession, ap as ItdTimeoutError, aq as ItdValidationError, ar as LIBRARY_VERSION, as as LikeResult, at as LikesVisibility, au as Listener, av as LocalStorageTokenStorage, aw as Logger, ax as Loose, ay as MAX_RECONNECT_ATTEMPTS, az as MemoryTokenStorage, aA as MyProfile, aB as NOTIFICATION_TYPE_ALIASES, aC as Notification, aD as NotificationEvent, aE as NotificationListParams, aF as NotificationSettings, aG as NotificationType, aH as NotificationsResource, aI as OAuthProvider, aJ as Page, aK as PageState, aL as PaginationMode, aM as Paginator, aN as PaymentMethod, aO as Pin, aP as PinPostResult, aQ as PinsResult, aR as PlatformResource, aS as PluginContext, aT as Poll, aU as PollBuilder, aV as PollInput, aW as PollOption, aX as PollTransportOptions, aY as Portal, aZ as Post, a_ as PostBuilder, a$ as PostInput, b0 as PostStats, b1 as PostsResource, b2 as PrivacySettings, b3 as Profile, b4 as PublicProfile, b5 as RECONNECT_BACKOFF, b6 as RECONNECT_JITTER, b7 as REFRESH_COOKIE, b8 as REFRESH_COOKIE_PATH, b9 as RateLimitOptions, ba as RawRequestOptions, bb as RealtimeEvents, bc as RealtimeOptions, bd as RealtimeStatus, be as RealtimeTransport, bf as RealtimeTransportKind, bg as ReconnectOptions, bh as RepliesParams, bi as Report, bj as ReportBuilder, bk as ReportInput, bl as ReportReason, bm as ReportTargetType, bn as ReportsResource, bo as RequestContext, bp as RequestOptions, bq as ResetPasswordInput, br as ResponseContext, bs as RetryContext, bt as RetryOptions, bu as RuntimeMode, bv as STREAM_PATH, bw as SearchResource, bx as SearchResult, by as Session, bz as SignInResult, bA as SignInStatus, bB as Span, bC as SpanType, bD as SseTransportOptions, bE as Subscription, bF as SubscriptionResource, bG as SubscriptionState, bH as TURNSTILE_SITE_KEY, bI as TelemetryOptions, bJ as TelemetryResource, T as TokenStorage, bK as Transformer, bL as TransportContext, bM as TransportEvent, bN as UnauthorizedStreamError, bO as Unsubscribe, bP as UpdateNotificationSettingsInput, bQ as UpdatePrivacyInput, bR as UpdateProfileInput, bS as UploadOptions, bT as UploadedFile, bU as UserId, bV as UserListParams, bW as UserPostsParams, bX as UserRef, bY as UserSummary, bZ as UsersResource, b_ as VIDEO_MIME_TYPES, b$ as VerificationResource, c0 as VerificationStatus, c1 as VideoMimeType, c2 as ViewReason, c3 as ViewSource, c4 as WallAccess, c5 as canonicalNotificationType, c6 as comment, cu as createClient, c7 as createTokenStorage, c8 as formatNotificationText, c9 as isBuilder, ca as isItdApiError, cb as isItdAuthError, cc as isItdConflictError, cd as isItdError, ce as isItdForbiddenError, cf as isItdNotFoundError, cg as isItdPhoneVerificationError, ch as isItdRateLimitError, ci as isItdServerError, cj as isItdValidationError, ck as isKnownNotificationType, cl as isMyProfile, cm as normalizeNotification, cn as poll, co as post, cp as readNotificationEvent, cq as readUnreadCountEvent, cr as report, cs as resolveNotificationUrl, ct as toDate } from './index-DNFPX_Z1.cjs';
+/** Метка билдера. Через `Symbol.for` — чтобы распознавание переживало смешивание ESM и CJS. */
+declare const BUILDER: unique symbol;
+/**
+ * Билдер входных данных.
+ *
+ * Билдеры необязательны: любой метод, принимающий билдер, принимает и обычный объект.
+ * Проверки одинаковы в обоих случаях.
+ */
+interface ItdBuilder<T> {
+    /** @internal */
+    readonly [BUILDER]: true;
+    /**
+     * Собирает и проверяет результат.
+     *
+     * @throws {ItdConfigError} если нарушены требования к данным
+     */
+    build(): T;
+    /** Чтобы билдер корректно вёл себя внутри `JSON.stringify`. */
+    toJSON(): T;
+}
+/**
+ * Три равноправные формы входа: обычный объект, готовый билдер или функция-настройщик.
+ *
+ * @example
+ * ```ts
+ * itd.posts.create({ content: 'привет' });                    // объект
+ * itd.posts.create(post().content('привет'));                 // билдер
+ * itd.posts.create((p) => p.content('привет'));               // функция
+ * ```
+ */
+type BuilderInput<T, B extends ItdBuilder<T>> = T | B | ((builder: B) => B | T);
+/** Является ли значение билдером. */
+declare function isBuilder<T>(value: unknown): value is ItdBuilder<T>;
+
+/**
+ * Перечисления API итд.com.
+ *
+ * Здесь намеренно не используется `enum` из TypeScript. Вместо него — пара «замороженный
+ * объект + одноимённый тип». Такой приём даёт всё, ради чего берут `enum`
+ * (`FeedTab.Popular`, перебор значений в рантайме), и при этом:
+ *
+ * - **стирается без остатка** — `enum` порождает рантайм-код и отвергается средами,
+ *   которые просто срезают типы (`node --experimental-strip-types`);
+ * - **не запрещает обычные строки** — `itd.posts.list({ tab: 'popular' })` остаётся валидным,
+ *   тогда как строковый `enum` считает это ошибкой типа и вынуждает всех импортировать себя;
+ * - **позволяет открытые множества** — там, где документация перечисляет значения не полностью,
+ *   тип расширяется через {@link Loose}, а объект остаётся справочником известных значений.
+ *
+ * @example
+ * ```ts
+ * import { FeedTab } from 'itd-api';
+ *
+ * await itd.posts.list({ tab: FeedTab.Popular });  // без магических строк
+ * await itd.posts.list({ tab: 'popular' });        // и так тоже можно
+ *
+ * Object.values(FeedTab);                          // ['popular', 'following', 'clan']
+ * ```
+ *
+ * @packageDocumentation
+ */
+/**
+ * Открытое строковое перечисление.
+ *
+ * Даёт автодополнение известных значений, но не ломается, если сервер пришлёт новое.
+ * Используется там, где документация API перечисляет значения не полностью («`everyone` и др.»).
+ */
+type Loose<T extends string> = T | (string & {});
+/**
+ * Вкладка ленты `GET /api/posts`.
+ *
+ * Множество закрытое: неизвестное значение сервер отвергнет.
+ */
+declare const FeedTab: Readonly<{
+    /** Популярное. Курсор здесь — номер страницы в виде строки (`"2"`, `"6"`…). */
+    readonly Popular: "popular";
+    /** Записи тех, на кого вы подписаны. Курсор — отметка времени последнего поста. */
+    readonly Following: "following";
+    /** Лента клана. Курсор, как и в подписках, — отметка времени. */
+    readonly Clan: "clan";
+}>;
+type FeedTab = (typeof FeedTab)[keyof typeof FeedTab];
+/** Порядок комментариев к посту. */
+declare const CommentSort: Readonly<{
+    /** Сначала новые. */
+    readonly Newest: "newest";
+    /** Сначала старые. */
+    readonly Oldest: "oldest";
+    /** Сначала популярные. */
+    readonly Popular: "popular";
+}>;
+type CommentSort = (typeof CommentSort)[keyof typeof CommentSort];
+/** Тип вложения. */
+declare const AttachmentType: Readonly<{
+    readonly Image: "image";
+    readonly Video: "video";
+    /** Голосовые комментарии: `audio/ogg`, с полем `duration`. */
+    readonly Audio: "audio";
+}>;
+type AttachmentType = (typeof AttachmentType)[keyof typeof AttachmentType];
+/**
+ * Тип фрагмента разметки в тексте поста или комментария.
+ *
+ * Первые два сервер расставляет сам при разборе текста, остальные приходят от редактора.
+ * Тип открытый: набор может пополниться.
+ *
+ * @example
+ * ```ts
+ * await itd.posts.update(postId, {
+ *   content: 'жирное слово',
+ *   spans: [{ type: SpanType.Bold, offset: 0, length: 6 }],
+ * });
+ * ```
+ */
+declare const SpanType: Readonly<{
+    /** Хэштег. Название без решётки лежит в `tag`. */
+    readonly Hashtag: "hashtag";
+    /** Упоминание. Имя пользователя лежит в `tag`. */
+    readonly Mention: "mention";
+    /** Ссылка. Адрес лежит в `url`, а не в `tag`. */
+    readonly Link: "link";
+    readonly Bold: "bold";
+    readonly Italic: "italic";
+    readonly Underline: "underline";
+    /** Зачёркнутый. */
+    readonly Strike: "strike";
+    /** Спойлер: текст скрыт до нажатия. */
+    readonly Spoiler: "spoiler";
+    /** Моноширинный. */
+    readonly Monospace: "monospace";
+    readonly Quote: "quote";
+}>;
+type SpanType = Loose<(typeof SpanType)[keyof typeof SpanType]>;
+/** На что подаётся жалоба. */
+declare const ReportTargetType: Readonly<{
+    readonly Post: "post";
+    readonly Comment: "comment";
+    readonly User: "user";
+}>;
+type ReportTargetType = (typeof ReportTargetType)[keyof typeof ReportTargetType];
+/** Причина жалобы. Множество закрытое. */
+declare const ReportReason: Readonly<{
+    readonly Spam: "spam";
+    readonly Violence: "violence";
+    readonly Hate: "hate";
+    readonly Adult: "adult";
+    readonly Fraud: "fraud";
+    readonly Other: "other";
+}>;
+type ReportReason = (typeof ReportReason)[keyof typeof ReportReason];
+/** Состояние realtime-соединения. */
+declare const RealtimeStatus: Readonly<{
+    readonly Connecting: "connecting";
+    readonly Connected: "connected";
+    readonly Error: "error";
+    readonly Disconnected: "disconnected";
+}>;
+type RealtimeStatus = (typeof RealtimeStatus)[keyof typeof RealtimeStatus];
+/** Состояние сервиса платформы. Тип открытый. */
+declare const ServiceState: Readonly<{
+    /** Работает штатно. */
+    readonly Operational: "operational";
+    /** Работает с деградацией. */
+    readonly Degraded: "degraded";
+    /** Недоступен. */
+    readonly Downtime: "downtime";
+}>;
+type ServiceState = Loose<(typeof ServiceState)[keyof typeof ServiceState]>;
+/** Вид происшествия в истории сервиса. Тип открытый. */
+declare const IncidentKind: Readonly<{
+    /** Недоступен. */
+    readonly Down: "down";
+    /** Деградация. */
+    readonly Degraded: "deg";
+}>;
+type IncidentKind = Loose<(typeof IncidentKind)[keyof typeof IncidentKind]>;
+/**
+ * Уровень доступа к разделу профиля.
+ *
+ * Общий набор значений для полей `wallAccess` и `likesVisibility` настроек приватности.
+ * Тип открытый: сервер может прислать значение вне этого перечня.
+ */
+declare const AccessType: Readonly<{
+    /** Никто. */
+    readonly Nobody: "nobody";
+    /** Только взаимные подписки. */
+    readonly Mutual: "mutual";
+    /** Подписчики. */
+    readonly Followers: "followers";
+    /** Все. */
+    readonly Everyone: "everyone";
+}>;
+type AccessType = Loose<(typeof AccessType)[keyof typeof AccessType]>;
+/** Кто может писать на стену профиля. Псевдоним {@link AccessType}. */
+declare const WallAccess: Readonly<{
+    /** Никто. */
+    readonly Nobody: "nobody";
+    /** Только взаимные подписки. */
+    readonly Mutual: "mutual";
+    /** Подписчики. */
+    readonly Followers: "followers";
+    /** Все. */
+    readonly Everyone: "everyone";
+}>;
+type WallAccess = AccessType;
+/** Кто видит реакции пользователя. Псевдоним {@link AccessType}. */
+declare const LikesVisibility: Readonly<{
+    /** Никто. */
+    readonly Nobody: "nobody";
+    /** Только взаимные подписки. */
+    readonly Mutual: "mutual";
+    /** Подписчики. */
+    readonly Followers: "followers";
+    /** Все. */
+    readonly Everyone: "everyone";
+}>;
+type LikesVisibility = AccessType;
+/**
+ * Канонический тип уведомления (новое поколение имён).
+ *
+ * REST-эндпоинт `/api/notifications/` отдаёт старые имена (`like`, `comment`, `reply`,
+ * `repost`, `mention`), SSE-поток — новые. Библиотека приводит их к этому набору,
+ * сохраняя исходное значение в поле `rawType`.
+ */
+declare const NotificationType: Readonly<{
+    /** Реакция на пост. Старое имя — `like`. */
+    readonly PostReaction: "post_reaction";
+    /** Комментарий к посту. Старое имя — `comment`. */
+    readonly PostComment: "post_comment";
+    /** Ответ на комментарий. Старое имя — `reply`. */
+    readonly CommentReply: "comment_reply";
+    /** Репост. Старое имя — `repost`. */
+    readonly PostRepost: "post_repost";
+    /** Упоминание в посте. Старое имя — `mention`. */
+    readonly PostMention: "post_mention";
+    /** Реакция на комментарий. */
+    readonly CommentReaction: "comment_reaction";
+    /** Упоминание в комментарии. */
+    readonly CommentMention: "comment_mention";
+    /** Запись на вашей стене. */
+    readonly WallPost: "wall_post";
+    /** На вас подписались. */
+    readonly Follow: "follow";
+    /** Заявка на подписку (закрытый профиль). */
+    readonly FollowRequest: "follow_request";
+    /** Заявка на подписку принята. */
+    readonly FollowAccepted: "follow_accepted";
+    /** Верификация одобрена. Приходит только по REST. */
+    readonly VerificationApproved: "verification_approved";
+    /** Верификация отклонена. Приходит только по REST. */
+    readonly VerificationRejected: "verification_rejected";
+}>;
+type NotificationType = Loose<(typeof NotificationType)[keyof typeof NotificationType]>;
+/**
+ * Тип взаимодействия с контентом в телеметрии (`POST /api/v1/x`, поле `t`).
+ *
+ * Кодируется числом.
+ */
+declare const InteractionType: Readonly<{
+    /** Открытие фотографии. */
+    readonly PhotoOpen: 1;
+    /** Прогресс просмотра видео. Несёт поля `pm`/`dm`. */
+    readonly VideoProgress: 2;
+}>;
+type InteractionType = (typeof InteractionType)[keyof typeof InteractionType];
+/**
+ * Источник показа поста в телеметрии (поле `s`).
+ *
+ * Кодируется числом. Поле применимо к источникам `PostPage` и `Link`; для лент источник
+ * передаётся контекстом `sc`.
+ */
+declare const ViewSource: Readonly<{
+    readonly FeedGlobal: 1;
+    readonly FeedFollowing: 2;
+    readonly FeedClan: 3;
+    readonly Profile: 4;
+    readonly Hashtag: 5;
+    readonly PostPage: 6;
+    readonly Link: 7;
+    readonly Search: 8;
+}>;
+type ViewSource = (typeof ViewSource)[keyof typeof ViewSource];
+/**
+ * Причина завершения просмотра поста в телеметрии (`POST /api/v1/i`, поле `r`).
+ *
+ * Кодируется числом.
+ */
+declare const ViewReason: Readonly<{
+    /** Пост ушёл из зоны видимости при обычной прокрутке. */
+    readonly Normal: 0;
+    /** Потеря фокуса окна. */
+    readonly Blur: 1;
+    /** Вкладка скрыта. */
+    readonly Hidden: 2;
+    /** Уход со страницы (`pagehide`). */
+    readonly PageHide: 3;
+    /** Элемент перестал наблюдаться. */
+    readonly Unobserve: 4;
+    /** Достигнут порог времени просмотра. */
+    readonly ThresholdMet: 5;
+}>;
+type ViewReason = (typeof ViewReason)[keyof typeof ViewReason];
+/**
+ * Строковые коды ошибок из поля `code`.
+ *
+ * Ключи намеренно повторяют написание сервера: код из ответа API можно найти здесь
+ * поиском один в один, без мысленного перевода регистра.
+ *
+ * Список открыт — сервер может добавить новый код, и это не должно ломать типизацию.
+ *
+ * @example
+ * ```ts
+ * if (err.hasCode(ItdErrorCode.OTP_INVALID)) await restartOtpFlow();
+ * ```
+ */
+declare const ItdErrorCode: Readonly<{
+    readonly BAD_REQUEST: "BAD_REQUEST";
+    readonly UNAUTHORIZED: "UNAUTHORIZED";
+    readonly ACCESS_DENIED: "ACCESS_DENIED";
+    readonly ENTITY_NOT_FOUND: "ENTITY_NOT_FOUND";
+    readonly ENTITY_ALREADY_EXISTS: "ENTITY_ALREADY_EXISTS";
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    readonly BUSINESS_RULE_VIOLATION: "BUSINESS_RULE_VIOLATION";
+    readonly RATE_LIMIT_EXCEEDED: "RATE_LIMIT_EXCEEDED";
+    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
+    /** Сервер отвечает так на `404`, `ENTITY_NOT_FOUND` в этом случае не приходит. */
+    readonly NOT_FOUND: "NOT_FOUND";
+    /** На практике не приходит: вместо него сервер шлёт `TURNSTILE_VERIFICATION_FAILED`. */
+    readonly CAPTCHA_FAILED: "CAPTCHA_FAILED";
+    /** Капча не пройдена: токен Turnstile недействителен, просрочен или уже использован. */
+    readonly TURNSTILE_VERIFICATION_FAILED: "TURNSTILE_VERIFICATION_FAILED";
+    readonly OTP_INVALID: "OTP_INVALID";
+    /** `flowToken` неизвестен или просрочен — поток подтверждения нужно начинать заново. */
+    readonly INVALID_FLOW_TOKEN: "INVALID_FLOW_TOKEN";
+    readonly ACCOUNT_DEACTIVATED: "ACCOUNT_DEACTIVATED";
+    readonly ACCOUNT_EMAIL_DOMAIN_NOT_ALLOWED: "ACCOUNT_EMAIL_DOMAIN_NOT_ALLOWED";
+    readonly ACCOUNT_INVALID_CREDENTIALS: "ACCOUNT_INVALID_CREDENTIALS";
+    readonly ACCOUNT_TEMPORARILY_LOCKED: "ACCOUNT_TEMPORARILY_LOCKED";
+    readonly ACCOUNT_CURRENT_PASSWORD_INCORRECT: "ACCOUNT_CURRENT_PASSWORD_INCORRECT";
+    readonly SESSION_EXPIRED: "SESSION_EXPIRED";
+    readonly SESSION_REVOKED: "SESSION_REVOKED";
+    readonly SESSION_INVALID_REFRESH_TOKEN: "SESSION_INVALID_REFRESH_TOKEN";
+    /** Запрос обновления пришёл без cookie `refresh_token` — продлевать нечего. */
+    readonly REFRESH_TOKEN_MISSING: "REFRESH_TOKEN_MISSING";
+    /** Cookie `refresh_token` есть, но сессии за ней уже нет: отозвана или истекла. */
+    readonly SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
+    readonly MISSING_FLOW_TOKEN: "MISSING_FLOW_TOKEN";
+    readonly PROFILE_USERNAME_TAKEN: "PROFILE_USERNAME_TAKEN";
+    readonly PROFILE_RESTRICTION_ACTIVE: "PROFILE_RESTRICTION_ACTIVE";
+    readonly PROFILE_MODIFICATION_RESTRICTED: "PROFILE_MODIFICATION_RESTRICTED";
+    readonly CONTENT_MODERATION_FAILED: "CONTENT_MODERATION_FAILED";
+    readonly FILE_TOO_LARGE: "FILE_TOO_LARGE";
+    readonly UNSUPPORTED_FILE_TYPE: "UNSUPPORTED_FILE_TYPE";
+    readonly UPLOAD_FAILED: "UPLOAD_FAILED";
+    readonly VIDEO_REQUIRES_VERIFICATION: "VIDEO_REQUIRES_VERIFICATION";
+    readonly PHONE_VERIFICATION_REQUIRED: "PHONE_VERIFICATION_REQUIRED";
+    readonly WRITE_ACCESS_RESTRICTED: "WRITE_ACCESS_RESTRICTED";
+}>;
+type ItdErrorCode = Loose<(typeof ItdErrorCode)[keyof typeof ItdErrorCode]>;
+
+/**
+ * Дата и время в формате ISO-8601, например `2026-07-21T14:30:00.000Z`.
+ *
+ * Библиотека не превращает такие поля в `Date`: строку проще сравнивать, логировать
+ * и передавать дальше без потерь. Для разбора есть {@link toDate}.
+ */
+type IsoDate = string;
+/**
+ * Идентификатор пользователя — **строго UUID**.
+ *
+ * Отличается от {@link UserRef} тем, что имя пользователя здесь не подойдёт. Так помечены
+ * места, где API принимает только UUID: например `wallRecipientId` при постинге на чужую стену.
+ */
+type UserId = string;
+/**
+ * Ссылка на пользователя: **UUID либо имя пользователя**.
+ *
+ * Пути вида `/api/users/{id}` принимают оба варианта, поэтому `itd.users.get('durov')`
+ * работает так же, как `itd.users.get('9f1c…')`.
+ */
+type UserRef = string;
+/**
+ * Разметка в тексте поста.
+ *
+ * Приходит от сервера и отправляется обратно как есть — библиотека разметку не генерирует
+ * и не пересчитывает.
+ *
+ * Единицы `offset` и `length` в документации API не уточнены (UTF-16 или кодовые точки),
+ * поэтому при работе с эмодзи проверяйте результат.
+ */
+interface Span {
+    /** Тип фрагмента — см. {@link SpanType}. */
+    type: SpanType;
+    /** Смещение от начала текста. */
+    offset: number;
+    /** Длина фрагмента. */
+    length: number;
+    /** Имя хэштега без решётки либо имя пользователя. */
+    tag?: string;
+    /** Адрес ссылки. Только у `link`: у него вместо `tag` отдельное поле. */
+    url?: string;
+}
+/**
+ * Значок-«пин» в профиле — награда или отметка платформы.
+ */
+interface Pin {
+    /** Постоянный идентификатор, например `epepuy_202605_59`. */
+    slug: string;
+    /** Отображаемое название. */
+    name: string;
+    /** Описание, за что выдан. */
+    description: string;
+    /** Адрес изображения. */
+    url: string;
+    /** Когда выдан. Приходит только в списке своих пинов. */
+    grantedAt?: IsoDate;
+}
+/**
+ * Автор поста или комментария.
+ *
+ * Встречается внутри `post.author` и `comment.author`.
+ */
+interface Author {
+    id: UserId;
+    username: string;
+    displayName: string;
+    /**
+     * **Эмодзи, а не картинка.**
+     *
+     * На итд.com аватар — это символ клана (`🩵`, `🦎`), а не адрес изображения.
+     * Отрисовывать его нужно как текст.
+     */
+    avatar: string;
+    /** Пройдена ли верификация. */
+    verified: boolean;
+    /** Активный значок профиля. Может отсутствовать. */
+    pin?: Pin | null;
+    /** Есть ли премиум-подписка (значок NUKSTA). */
+    hasNuksta?: boolean;
+}
+/**
+ * Участник события в уведомлении.
+ *
+ * Отличается от {@link Author} набором полей: вместо значков приходит связь с вами.
+ */
+interface Actor {
+    id: UserId;
+    username: string;
+    displayName: string;
+    /** Эмодзи-аватар, см. {@link Author.avatar}. */
+    avatar: string;
+    /** Подписаны ли вы на этого пользователя. */
+    isFollowing?: boolean;
+    /** Подписан ли он на вас. */
+    isFollowedBy?: boolean;
+}
+/**
+ * Пользователь в списках.
+ *
+ * Набор полей зависит от эндпоинта: подписчики и подписки приносят `isFollowing`,
+ * поиск и рекомендации — `followersCount` и `hasNuksta`. Необязательные поля отражают
+ * это различие.
+ */
+interface UserSummary {
+    id: UserId;
+    username: string;
+    displayName: string;
+    /** Эмодзи-аватар, см. {@link Author.avatar}. */
+    avatar: string;
+    verified: boolean;
+    /** Подписаны ли вы. Приходит в списках подписчиков и подписок. */
+    isFollowing?: boolean;
+    /** Есть ли премиум. Приходит в поиске и рекомендациях. */
+    hasNuksta?: boolean;
+    /** Число подписчиков. Приходит в поиске и рекомендациях. */
+    followersCount?: number;
+}
+/** Поля профиля, общие для своего и чужого. */
+interface ProfileBase {
+    id: UserId;
+    username: string;
+    displayName: string;
+    /** Эмодзи-аватар, см. {@link Author.avatar}. */
+    avatar: string;
+    /** Адрес изображения-шапки либо `null`. В отличие от аватара это настоящий URL. */
+    banner: string | null;
+    /** Описание профиля. */
+    bio: string;
+    verified: boolean;
+    pin?: Pin | null;
+    /** Кто может писать на стену. */
+    wallAccess: WallAccess;
+    /** Кто видит реакции. */
+    likesVisibility: LikesVisibility;
+    followersCount: number;
+    followingCount: number;
+    postsCount: number;
+    createdAt: IsoDate;
+}
+/** Состояние подписки на премиум. */
+interface SubscriptionState {
+    isActive: boolean;
+    expiresAt: IsoDate | null;
+    autoRenewal: boolean;
+}
+/**
+ * Свой профиль — ответ `GET /api/users/me`.
+ *
+ * Отличается от чужого наличием {@link subscription} и {@link isPhoneVerified}
+ * и отсутствием полей связи (`isFollowing`, `online`).
+ */
+interface MyProfile extends ProfileBase {
+    /** Закрыт ли профиль. */
+    isPrivate: boolean;
+    /** Подтверждён ли телефон. Без него часть действий недоступна. */
+    isPhoneVerified: boolean;
+    /** Своя премиум-подписка. */
+    subscription: SubscriptionState;
+}
+/**
+ * Чужой профиль — ответ `GET /api/users/{id|username}`.
+ *
+ * Вместо своей подписки содержит связь с вами и присутствие.
+ */
+interface PublicProfile extends ProfileBase {
+    hasNuksta?: boolean;
+    /** Закреплённый пост, если он есть. */
+    pinnedPostId: string | null;
+    /** Подписаны ли вы на него. */
+    isFollowing: boolean;
+    /** Подписан ли он на вас. */
+    isFollowedBy: boolean;
+    /** Сейчас ли пользователь в сети. */
+    online: boolean;
+    /** Когда был в сети. `null`, если скрыто настройками приватности. */
+    lastSeen: IsoDate | null;
+}
+/** Профиль: свой либо чужой. Различаются функцией {@link isMyProfile}. */
+type Profile = MyProfile | PublicProfile;
+/**
+ * Свой ли это профиль.
+ *
+ * @example
+ * ```ts
+ * if (isMyProfile(profile)) console.log(profile.subscription.isActive);
+ * ```
+ */
+declare function isMyProfile(profile: Profile): profile is MyProfile;
+/** Вложение поста или комментария. */
+interface Attachment {
+    id: string;
+    type: AttachmentType;
+    /** Адрес файла на CDN. */
+    url: string;
+    /** Ширина изображения или видео в пикселях. */
+    width?: number;
+    /** Высота изображения или видео в пикселях. */
+    height?: number;
+    mimeType: string;
+    /** Исходное имя файла. Приходит не всегда. */
+    filename?: string;
+    /** Размер в байтах. Приходит не всегда. */
+    size?: number;
+    /** Длительность аудио или видео в секундах. */
+    duration?: number | null;
+    /** Порядковый номер во вложениях поста. */
+    order?: number;
+}
+/** Вариант ответа в опросе. */
+interface PollOption {
+    id: string;
+    text: string;
+    /** Сколько голосов отдано за этот вариант. */
+    votesCount: number;
+    /** Порядковый номер варианта, начиная с нуля. */
+    position: number;
+}
+/** Опрос внутри поста. */
+interface Poll {
+    id: string;
+    /** Пост, которому принадлежит опрос. */
+    postId: string;
+    question: string;
+    /** Можно ли выбрать несколько вариантов. */
+    multipleChoice: boolean;
+    options: PollOption[];
+    totalVotes: number;
+    /** Голосовали ли вы. */
+    hasVoted: boolean;
+    /** За что проголосовали вы. Пустой массив, если голоса не было. */
+    votedOptionIds: string[];
+    createdAt: IsoDate;
+}
+/** Пост ленты, стены или профиля. */
+interface Post {
+    id: string;
+    content: string;
+    /** Разметка текста. Передаётся без изменений, см. {@link Span}. */
+    spans: Span[];
+    author: Author;
+    attachments: Attachment[];
+    likesCount: number;
+    commentsCount: number;
+    repostsCount: number;
+    viewsCount: number;
+    /** Чья это стена, если пост опубликован не у себя. */
+    wallRecipientId: UserId | null;
+    /** Владелец стены. Приходит не во всех ответах. */
+    wallRecipient?: Author | null;
+    /** Поставили ли вы реакцию. */
+    isLiked: boolean;
+    /** Делали ли вы репост. */
+    isReposted: boolean;
+    /** Засчитан ли просмотр. */
+    isViewed: boolean;
+    /** Ваш ли это пост. */
+    isOwner: boolean;
+    /** Исходный пост, если это репост. */
+    originalPost?: Post | null;
+    poll?: Poll | null;
+    /** Преобладающая реакция — эмодзи либо `null`. */
+    dominantEmoji?: string | null;
+    /** Когда пост отредактировали. `null`, если не редактировали. */
+    editedAt: IsoDate | null;
+    createdAt: IsoDate;
+    /**
+     * Служебная метка показа для телеметрии.
+     *
+     * Нужна только эндпоинтам `itd.telemetry.*`. В остальных случаях игнорируйте.
+     */
+    vs?: string;
+    /**
+     * Топовые комментарии. Приходят только в ответе `GET /api/posts/{id}`.
+     *
+     * В списках постов поле отсутствует.
+     */
+    comments?: Comment[];
+}
+/** На чей комментарий дан ответ. */
+interface CommentReplyTo {
+    id: string;
+    username: string;
+    displayName: string;
+}
+/** Комментарий к посту или ответ на комментарий. */
+interface Comment {
+    id: string;
+    /** Текст. У голосового комментария пустой. */
+    content: string;
+    author: Author;
+    likesCount: number;
+    repliesCount: number;
+    isLiked: boolean;
+    createdAt: IsoDate;
+    /** Вложения. У голосового — одно аудио с `mimeType: 'audio/ogg'`. */
+    attachments?: Attachment[];
+    /** Вложенные ответы. В списках приходит превью, полный список — через `itd.comments.replies()`. */
+    replies?: Comment[];
+    /** Заполнено только у ответов. */
+    replyTo?: CommentReplyTo;
+}
+/**
+ * Уведомление в единой форме.
+ *
+ * REST-список и SSE-поток отдают уведомления по-разному — разные имена типов, разные имена
+ * полей, один участник против массива. Библиотека приводит оба вида к этой структуре,
+ * поэтому объекты из `itd.notifications.list()` и из потока можно складывать в один список.
+ *
+ * Исходные данные не теряются: сервeрное имя типа остаётся в {@link rawType},
+ * а весь необработанный объект — в {@link raw}.
+ */
+interface Notification {
+    id: string;
+    /** Канонический тип. Старые имена (`like`, `comment`) приведены к новым. */
+    type: NotificationType;
+    /** Имя типа в том виде, в каком его прислал сервер. */
+    rawType: string;
+    /** Объект события: пост, комментарий, пользователь. */
+    entityId: string | null;
+    /** Пост, которому принадлежит комментарий, если событие о комментарии. */
+    parentEntityId: string | null;
+    /** Прочитано ли уведомление. */
+    isRead: boolean;
+    /** Кто совершил действие. Для схлопнутых уведомлений — несколько человек. */
+    actors: Actor[];
+    /** Сколько участников схлопнуто в одно уведомление. Минимум 1. */
+    count: number;
+    /** Текст или заголовок объекта события. */
+    preview: string | null;
+    /** Ссылка перехода, предложенная сервером. Обычно точнее её `resolveNotificationUrl()`. */
+    clickUrl?: string;
+    createdAt: IsoDate;
+    /** Когда уведомление изменилось — например было прочитано. */
+    updatedAt: IsoDate;
+    /** Исходный объект как он пришёл от сервера. */
+    raw: unknown;
+}
+/** Настройки приватности профиля. */
+interface PrivacySettings {
+    /** Закрыт ли профиль: подписка требует одобрения. */
+    isPrivate: boolean;
+    wallAccess: WallAccess;
+    likesVisibility: LikesVisibility;
+    /** Показывать ли время последнего посещения. */
+    showLastSeen: boolean;
+}
+/**
+ * Настройки уведомлений.
+ *
+ * Сервер отдаёт плоский объект, но исторически знает два набора имён для одних и тех же
+ * настроек (`likes` и `reactions`, `comments` и `replies`). При сохранении библиотека
+ * отправляет оба, при чтении принимает любой.
+ */
+interface NotificationSettings {
+    /** Общий выключатель доставки. */
+    enabled: boolean;
+    /** Звук уведомления. */
+    sound: boolean;
+    /** Новые подписчики. */
+    follows: boolean;
+    /** Записи на вашей стене. */
+    wallPosts: boolean;
+    /** Реакции на ваши записи. */
+    likes: boolean;
+    /** Комментарии и ответы. */
+    comments: boolean;
+    /** Упоминания. */
+    mentions: boolean;
+}
+/** Активная сессия входа. */
+interface Session {
+    id: string;
+    /** Та ли это сессия, из которой выполнен запрос. */
+    isCurrent: boolean;
+    createdAt: IsoDate;
+    lastUsedAt: IsoDate;
+    expiresAt: IsoDate;
+    ipAddress: string;
+    /** Код страны по IP, например `RU`. */
+    ipCountry: string | null;
+    ipCity: string | null;
+    deviceType: Loose<'desktop' | 'mobile'>;
+    osName: string | null;
+    osVersion: string | null;
+    /** Название браузера или приложения. */
+    clientName: string | null;
+    clientVersion: string | null;
+    deviceModel: string | null;
+}
+/** Состояние платной подписки и её цена. */
+interface Subscription {
+    /** Активна ли подписка сейчас. */
+    active: boolean;
+    /** Включено ли автопродление. */
+    recurringEnabled: boolean;
+    /** Цена в рублях. */
+    price: number;
+}
+/** Сохранённый способ оплаты. */
+interface PaymentMethod {
+    id: string;
+    /** Последние четыре цифры карты. */
+    last4?: string;
+    /** Платёжная система: `visa`, `mastercard`, `mir`. */
+    brand?: string;
+    /** Основной ли это способ оплаты. */
+    isDefault?: boolean;
+    expiresAt?: IsoDate | null;
+}
+/** Хэштег. */
+interface Hashtag {
+    id: string;
+    /** Название без решётки. */
+    name: string;
+    /** Сколько постов с этим хэштегом. */
+    postsCount: number;
+}
+/** Клан в рейтинге. */
+interface Clan {
+    /** Эмодзи клана — оно же аватар его участников. */
+    avatar: string;
+    memberCount: number;
+}
+/**
+ * Результат подписки на пользователя.
+ *
+ * @example
+ * ```ts
+ * const result = await itd.users.follow('durov');
+ * // { following: true, followersCount: 11 }
+ * ```
+ */
+interface FollowResult {
+    /** Подписка оформлена. У закрытого профиля отправляется заявка, и здесь будет `false`. */
+    following: boolean;
+    /** Сколько подписчиков стало у пользователя после действия. */
+    followersCount?: number;
+    /** Статус заявки, если профиль закрыт. */
+    status?: Loose<'following' | 'requested'>;
+}
+/** Запись журнала изменений платформы. */
+interface ChangelogEntry {
+    version: string;
+    date: string;
+    changes: string[];
+}
+/** Кнопка в анонсе платформы. */
+interface AnnouncementButton {
+    title: string;
+    /** Оформление: `primary`, `secondary` и другие. */
+    style: string;
+    action: {
+        type: string;
+        [key: string]: unknown;
+    };
+}
+/** Анонс на главной странице платформы. */
+interface Announcement {
+    id: string;
+    image: {
+        url: string;
+        width: number;
+        height: number;
+    };
+    title: string;
+    description: string;
+    /** Дополнительный текст мелким шрифтом. */
+    additional_text?: string;
+    buttons: AnnouncementButton[];
+}
+/** Баннер текущего события — виджет «портал». */
+interface Portal {
+    active: boolean;
+    title: string;
+    url: string;
+}
+/** Происшествие в истории сервиса. */
+interface StatusIncidentLine {
+    /** Вид происшествия. */
+    t: IncidentKind;
+    /**
+     * Готовая строка для показа: `недоступен 6 мин (12:00–12:06)`. Время московское.
+     * Длительность и границы интервала отдельными полями не приходят.
+     */
+    text: string;
+}
+/** Одни сутки в истории сервиса. */
+interface StatusDay {
+    /** Худшее состояние за сутки. */
+    type: ServiceState;
+    /** Дата суток, `YYYY-MM-DD`. Сутки нарезаны по UTC. */
+    date_key: string;
+    /** Доступность за сутки в процентах. */
+    uptime: number;
+    /** Происшествия за сутки. */
+    lines: StatusIncidentLine[];
+}
+/** Сервис платформы и его история доступности. */
+interface ServiceStatus {
+    /** Идентификатор: `auth`, `main`, `media` и прочие. */
+    id: string;
+    /** Отображаемое название. */
+    name: string;
+    current_status: ServiceState;
+    /** Пояснение к текущему состоянию, например `No downtime`. */
+    current_message: string;
+    /** Задержка последней проверки в миллисекундах. */
+    latency_ms: number;
+    /**
+     * Момент последней проверки. Сервер отдаёт `YYYY-MM-DD HH:mm:ss` в UTC, библиотека
+     * приводит значение к ISO.
+     */
+    last_checked: IsoDate;
+    /** Доступность за 90 суток в процентах. */
+    uptime_90d: number;
+    /**
+     * История по суткам. Ключ — сколько суток назад, `'0'` — сегодня.
+     *
+     * Объект разреженный: сутки без данных сервер пропускает. Ровный массив даёт
+     * {@link statusDays}.
+     */
+    days: Record<string, StatusDay | undefined>;
+}
+/** Состояние платформы — ответ `itd.platform.status()`. */
+interface PlatformStatus {
+    /** Худшее состояние среди сервисов. */
+    overall_status: ServiceState;
+    /** Когда данные последний раз пересчитаны. */
+    updated_at: IsoDate;
+    services: ServiceStatus[];
+}
+/** Статус заявки на верификацию. `none` означает, что заявка не подавалась. */
+interface VerificationStatus {
+    status: Loose<'none' | 'pending' | 'approved' | 'rejected'>;
+}
+/** Созданная жалоба. */
+interface Report {
+    id: string;
+    createdAt: IsoDate;
+}
+/** Счётчики поста из `itd.posts.stats()`. */
+interface PostStats {
+    id: string;
+    likesCount: number;
+    commentsCount: number;
+    repostsCount: number;
+    viewsCount: number;
+    /** Преобладающая реакция — эмодзи либо `null`. */
+    dominantEmoji: string | null;
+}
+/** Результат реакции на пост. */
+interface LikeResult {
+    liked: boolean;
+    likesCount: number;
+}
+/** Результат закрепления поста в профиле. */
+interface PinPostResult {
+    success: boolean;
+    pinnedPostId: string | null;
+}
+/** Закреплённые значки профиля и выбранный из них. */
+interface PinsResult {
+    pins: Pin[];
+    /** Идентификатор активного значка — строка, а не объект. */
+    activePin: string | null;
+}
+/**
+ * Разбирает дату API в объект `Date`.
+ *
+ * @returns `null`, если строки нет или она не разбирается
+ *
+ * @example
+ * ```ts
+ * const created = toDate(post.createdAt);
+ * ```
+ */
+declare function toDate(value: IsoDate | null | undefined): Date | null;
+/**
+ * Разворачивает историю сервиса в массив на 90 суток.
+ * Сутки без данных становятся `null`.
+ *
+ * @returns массив, где индекс — сколько суток назад: `[0]` — сегодня
+ *
+ * @example
+ * ```ts
+ * const status = await itd.platform.status();
+ * const days = statusDays(status.services[0]);
+ *
+ * days[0]?.uptime;                              // доступность за сегодня
+ * days.filter((day) => day === null).length;    // за сколько суток данных нет
+ * ```
+ */
+declare function statusDays(service: ServiceStatus): (StatusDay | null)[];
+
+/**
+ * Билдер опроса.
+ *
+ * Неизменяемый: каждый вызов возвращает новый экземпляр, поэтому заготовку можно
+ * переиспользовать, не боясь её испортить. Создаётся функцией {@link poll}.
+ */
+declare class PollBuilder implements ItdBuilder<CreatePollInput> {
+    #private;
+    /** @internal */
+    readonly [BUILDER]: true;
+    /** @internal Создавайте билдер функцией {@link poll}. */
+    constructor(state: CreatePollInput);
+    /** Задаёт вопрос. */
+    question(text: string): PollBuilder;
+    /** Добавляет один вариант ответа. */
+    option(text: string): PollBuilder;
+    /**
+     * Добавляет несколько вариантов сразу.
+     *
+     * @example
+     * ```ts
+     * poll('ну как?').options('да', 'нет', 'не знаю');
+     * ```
+     */
+    options(...texts: string[]): PollBuilder;
+    /** Разрешает выбор нескольких вариантов. */
+    multipleChoice(enabled?: boolean): PollBuilder;
+    build(): CreatePollInput;
+    toJSON(): CreatePollInput;
+}
+/**
+ * Начинает сборку опроса.
+ *
+ * @param question вопрос; можно задать позже методом {@link PollBuilder.question}
+ *
+ * @example
+ * ```ts
+ * import { poll } from 'itd-api';
+ *
+ * const q = poll('Какой язык лучше?')
+ *   .options('TypeScript', 'JavaScript')
+ *   .multipleChoice();
+ *
+ * await itd.posts.create({ content: 'голосуем', poll: q });
+ * ```
+ */
+declare function poll(question?: string): PollBuilder;
+/** Что принимает параметр опроса: объект, билдер или функция-настройщик. */
+type PollInput = BuilderInput<CreatePollInput, PollBuilder>;
+
+/**
+ * Файл для загрузки.
+ *
+ * Строка означает **путь на диске** и работает только в Node, Bun и Deno — для этого
+ * подключите `itd-api/node`. В браузере и React Native передавайте `File` или `Blob`.
+ */
+type FileInput = Blob | ArrayBuffer | Uint8Array | string | {
+    /** Содержимое файла. */
+    data: Blob | ArrayBuffer | Uint8Array;
+    /** Имя файла. Влияет на определение типа, если `contentType` не задан. */
+    filename?: string;
+    /** MIME-тип. Если не указан, определяется по расширению или по самому `Blob`. */
+    contentType?: string;
+};
+/** Данные для создания опроса. */
+interface CreatePollInput {
+    /** Вопрос. Не может быть пустым. */
+    question: string;
+    /** Варианты ответа. Требуется минимум два. */
+    options: {
+        text: string;
+    }[];
+    /** Разрешить выбор нескольких вариантов. По умолчанию `false`. */
+    multipleChoice?: boolean;
+}
+/** Данные для создания поста. */
+interface CreatePostInput {
+    /** Текст поста. */
+    content?: string;
+    /** Разметка текста. Передаётся серверу без изменений — библиотека её не генерирует. */
+    spans?: Span[];
+    /**
+     * Чья стена, если пост публикуется не у себя.
+     *
+     * Требуется **UUID**: имя пользователя здесь не работает, его можно получить
+     * из профиля через `itd.users.get(username)`.
+     */
+    wallRecipientId?: UserId | null;
+    /** Идентификаторы заранее загруженных вложений. */
+    attachmentIds?: string[];
+    /** Файлы, которые нужно загрузить перед публикацией. Порядок сохраняется. */
+    files?: FileInput[];
+    /** Опрос: обычный объект, {@link PollBuilder} или функция-настройщик. */
+    poll?: PollInput;
+}
+/** Данные для создания комментария или ответа. */
+interface CreateCommentInput {
+    /** Текст. У голосового комментария должен быть пустым. */
+    content?: string;
+    /** Идентификаторы заранее загруженных вложений. */
+    attachmentIds?: string[];
+    /** Файлы, которые нужно загрузить перед отправкой. */
+    files?: FileInput[];
+    /**
+     * Кому адресован ответ.
+     *
+     * Применимо только в `itd.comments.reply()`; в комментарии к посту поле не имеет смысла.
+     */
+    replyToUserId?: UserId;
+}
+/** Данные для создания жалобы. */
+interface CreateReportInput {
+    /** На что жалоба. */
+    targetType: ReportTargetType;
+    /** Идентификатор объекта жалобы. */
+    targetId: string;
+    /** Причина. */
+    reason: ReportReason;
+    /** Пояснение в свободной форме. */
+    description?: string;
+}
+
+/** Внутреннее состояние {@link CommentBuilder}. */
+interface CommentState extends CreateCommentInput {
+    content: string;
+    attachmentIds: string[];
+    files: FileInput[];
+    /** Голосовой комментарий: текста быть не должно, вложение ровно одно. */
+    voice: boolean;
+}
+/**
+ * Билдер комментария и ответа на комментарий.
+ *
+ * Неизменяемый: каждый вызов возвращает новый экземпляр. Создаётся функцией {@link comment}.
+ */
+declare class CommentBuilder implements ItdBuilder<CreateCommentInput> {
+    #private;
+    /** @internal */
+    readonly [BUILDER]: true;
+    /** @internal Создавайте билдер функцией {@link comment}. */
+    constructor(state: CommentState);
+    /** Задаёт текст комментария. */
+    content(text: string): CommentBuilder;
+    /** Прикладывает файл — он будет загружен перед отправкой. */
+    attach(file: FileInput): CommentBuilder;
+    /** Прикладывает уже загруженное вложение. */
+    attachId(attachmentId: string): CommentBuilder;
+    /**
+     * Делает комментарий голосовым.
+     *
+     * Текста у такого комментария быть не должно, а вложение ровно одно — аудио в формате
+     * `audio/ogg`. Так его принимает API.
+     *
+     * @example
+     * ```ts
+     * await itd.posts.comment(postId, (c) => c.voice('./answer.ogg'));
+     * ```
+     */
+    voice(audio: FileInput): CommentBuilder;
+    /**
+     * Кому адресован ответ.
+     *
+     * Имеет смысл только в `itd.comments.reply()`; при отправке комментария к посту
+     * это поле вызовет ошибку.
+     */
+    replyTo(userId: UserId): CommentBuilder;
+    build(): CreateCommentInput;
+    toJSON(): CreateCommentInput;
+}
+/**
+ * Начинает сборку комментария.
+ *
+ * @param content текст; можно задать позже методом {@link CommentBuilder.content}
+ *
+ * @example
+ * ```ts
+ * import { comment } from 'itd-api';
+ *
+ * await itd.posts.comment(postId, comment('согласен').attach('./meme.png'));
+ * ```
+ */
+declare function comment(content?: string): CommentBuilder;
+/** Что принимает параметр комментария: объект, билдер или функция-настройщик. */
+type CommentInput = BuilderInput<CreateCommentInput, CommentBuilder>;
+
+/** Внутреннее состояние {@link PostBuilder}. */
+interface PostState extends CreatePostInput {
+    content: string;
+    attachmentIds: string[];
+    files: FileInput[];
+}
+/**
+ * Билдер поста.
+ *
+ * Неизменяемый: каждый вызов возвращает новый экземпляр, поэтому заготовку можно
+ * переиспользовать. Создаётся функцией {@link post}.
+ *
+ * @example Заготовка для нескольких постов
+ * ```ts
+ * const onWall = post().onWall(userId);
+ *
+ * await itd.posts.create(onWall.content('первый'));
+ * await itd.posts.create(onWall.content('второй'));  // заготовка не испорчена
+ * ```
+ */
+declare class PostBuilder implements ItdBuilder<CreatePostInput> {
+    #private;
+    /** @internal */
+    readonly [BUILDER]: true;
+    /** @internal Создавайте билдер функцией {@link post}. */
+    constructor(state: PostState);
+    /** Задаёт текст поста, заменяя прежний. */
+    content(text: string): PostBuilder;
+    /** Дописывает текст к уже заданному. */
+    append(text: string): PostBuilder;
+    /**
+     * Задаёт разметку текста.
+     *
+     * Библиотека разметку не генерирует: хэштеги и упоминания нужно размечать самостоятельно
+     * либо не размечать вовсе.
+     */
+    spans(spans: Span[]): PostBuilder;
+    /**
+     * Публикует пост на стене другого пользователя.
+     *
+     * @param userId **UUID** пользователя; имя пользователя не подойдёт
+     */
+    onWall(userId: UserId): PostBuilder;
+    /**
+     * Прикладывает файл — он будет загружен перед публикацией.
+     *
+     * Порядок вызовов сохраняется в порядке вложений.
+     */
+    attach(file: FileInput): PostBuilder;
+    /** Прикладывает уже загруженное вложение по его идентификатору. */
+    attachId(attachmentId: string): PostBuilder;
+    /**
+     * Добавляет опрос.
+     *
+     * Принимает объект, {@link PollBuilder} или функцию-настройщик.
+     *
+     * @example
+     * ```ts
+     * post('голосуем').poll((q) => q.question('ну как?').options('да', 'нет'));
+     * ```
+     */
+    poll(input: PollInput): PostBuilder;
+    build(): CreatePostInput;
+    toJSON(): CreatePostInput;
+}
+/**
+ * Начинает сборку поста.
+ *
+ * @param content текст; можно задать позже методом {@link PostBuilder.content}
+ *
+ * @example
+ * ```ts
+ * import { post } from 'itd-api';
+ *
+ * await itd.posts.create(
+ *   post('смотрите что нашёл')
+ *     .attach('./photo.jpg')
+ *     .poll((q) => q.question('нравится?').options('да', 'нет')),
+ * );
+ * ```
+ */
+declare function post(content?: string): PostBuilder;
+/** Что принимает параметр поста: объект, билдер или функция-настройщик. */
+type PostInput = BuilderInput<CreatePostInput, PostBuilder>;
+
+/**
+ * Билдер жалобы.
+ *
+ * Точка входа задаёт объект жалобы и его тип одновременно, поэтому рассогласовать
+ * `targetType` и `targetId` невозможно. Создаётся объектом {@link report}.
+ */
+declare class ReportBuilder implements ItdBuilder<CreateReportInput> {
+    #private;
+    /** @internal */
+    readonly [BUILDER]: true;
+    /** @internal Создавайте билдер через {@link report}. */
+    constructor(state: Partial<CreateReportInput>);
+    /** Указывает причину жалобы. */
+    reason(reason: ReportReason): ReportBuilder;
+    /** Добавляет пояснение в свободной форме. */
+    description(text: string): ReportBuilder;
+    build(): CreateReportInput;
+    toJSON(): CreateReportInput;
+}
+/**
+ * Начинает сборку жалобы.
+ *
+ * Тип объекта выбирается точкой входа, так что указать идентификатор комментария
+ * с типом «пост» нельзя в принципе.
+ *
+ * @example
+ * ```ts
+ * import { report, ReportReason } from 'itd-api';
+ *
+ * await itd.reports.create(report.post(postId).reason(ReportReason.Spam));
+ * await itd.reports.create(report.user(userId).reason('fraud').description('пишет в личку'));
+ * ```
+ */
+declare const report: Readonly<{
+    /** Жалоба на пост. */
+    post: (postId: string) => ReportBuilder;
+    /** Жалоба на комментарий. */
+    comment: (commentId: string) => ReportBuilder;
+    /** Жалоба на пользователя. */
+    user: (userId: string) => ReportBuilder;
+}>;
+/** Что принимает параметр жалобы: объект, билдер или функция-настройщик. */
+type ReportInput = BuilderInput<CreateReportInput, ReportBuilder>;
+
+/**
+ * Как библиотека обращается с cookie.
+ *
+ * - `browser` — cookie ведёт браузер, запросы уходят с `credentials: 'include'`;
+ * - `server` — cookie ведёт встроенный jar, заголовок `Cookie` подставляется вручную;
+ * - `auto` — определяется по среде исполнения (значение по умолчанию).
+ */
+declare const RuntimeMode: Readonly<{
+    /** Определяется по среде исполнения. Значение по умолчанию. */
+    readonly Auto: "auto";
+    /** Cookie ведёт браузер, запросы уходят с `credentials: 'include'`. */
+    readonly Browser: "browser";
+    /** Cookie ведёт встроенный jar, заголовок `Cookie` подставляется вручную. */
+    readonly Server: "server";
+}>;
+type RuntimeMode = (typeof RuntimeMode)[keyof typeof RuntimeMode];
+/** Распознанная среда исполнения. */
+declare const DetectedRuntime: Readonly<{
+    readonly Browser: "browser";
+    /** Есть `window`, но нет `document`; cookie ведёт нативный сетевой слой. */
+    readonly ReactNative: "react-native";
+    readonly Server: "server";
+}>;
+type DetectedRuntime = (typeof DetectedRuntime)[keyof typeof DetectedRuntime];
+
+/** Сервис платформы на отдельном домене. */
+interface ServiceDefinition {
+    /** Имя, по которому запрос выбирает сервис: `{ service: 'status' }`. */
+    name: string;
+    /** Базовый URL сервиса. */
+    baseUrl: string;
+    /** Заголовки, добавляемые к каждому запросу сервиса. Заголовки вызова важнее. */
+    headers?: Record<string, string> | undefined;
+    /**
+     * Слать ли заголовок авторизации.
+     *
+     * По умолчанию включено для основного хоста и его поддоменов. Для остальных хостов
+     * авторизацию нужно разрешить явно: `auth: true`.
+     */
+    auth?: boolean | undefined;
+}
+/** Именованные сервисы клиента. */
+declare class ServiceRegistry {
+    #private;
+    /** @param primaryBaseUrl базовый URL клиента */
+    constructor(primaryBaseUrl?: string);
+    /**
+     * Регистрирует сервис. Имя очищается от краевых пробелов, базовый URL приводится
+     * к каноничному виду, а незаданный `auth` выводится из хоста.
+     *
+     * @throws {ItdConfigError} если имя пустое, имя занято или `baseUrl` не абсолютный URL
+     */
+    define(definition: ServiceDefinition): void;
+    /** Определение сервиса либо `undefined`, если такого нет. */
+    get(name: string): ServiceDefinition | undefined;
+    /** Зарегистрирован ли сервис с таким именем. */
+    has(name: string): boolean;
+    /**
+     * Определение сервиса.
+     *
+     * @throws {ItdConfigError} если сервис не зарегистрирован
+     */
+    require(name: string): ServiceDefinition;
+    /**
+     * Базовый URL сервиса.
+     *
+     * @throws {ItdConfigError} если сервис не зарегистрирован
+     */
+    resolveBaseUrl(name: string): string;
+}
+
+/**
+ * Сохранённая сессия.
+ *
+ * Кроме токенов сюда попадают cookie: refresh-токен итд.com живёт именно в cookie, и без них
+ * восстановить сессию после перезапуска процесса невозможно.
+ */
+interface ItdSession {
+    /** Токен доступа для заголовка `Authorization: Bearer`. */
+    accessToken?: string | undefined;
+    /**
+     * Refresh-токен, если удалось получить его явным значением.
+     *
+     * Обычно сервер держит его в httpOnly-cookie и наружу не отдаёт — тогда поле останется
+     * пустым, а обновление пойдёт через {@link ItdSession.cookies}.
+     */
+    refreshToken?: string | undefined;
+    /** Сырые cookie в форме `имя=значение`, привязанные к origin API. */
+    cookies?: string[] | undefined;
+    /**
+     * Идентификатор устройства для заголовка `X-Device-Id`.
+     *
+     * Сервер различает по нему записи в списке сессий, поэтому значение должно пережить
+     * перезапуск процесса — иначе каждый старт бота порождает новую сессию. Библиотека
+     * заводит его сама при первом запросе и хранит здесь.
+     */
+    deviceId?: string | undefined;
+    /** Когда сессия получена, мс с начала эпохи. Нужно для диагностики. */
+    obtainedAt?: number | undefined;
+}
+/**
+ * Хранилище сессии.
+ *
+ * Подключаемый компонент: библиотека не знает, где вы держите токены, и обращается к ним
+ * только через этот интерфейс. Все методы могут быть как синхронными, так и асинхронными.
+ *
+ * @example Своё хранилище поверх AsyncStorage в React Native
+ * ```ts
+ * const storage = createTokenStorage({
+ *   get: async () => JSON.parse((await AsyncStorage.getItem('itd')) ?? 'null'),
+ *   set: (session) => AsyncStorage.setItem('itd', JSON.stringify(session)),
+ *   clear: () => AsyncStorage.removeItem('itd'),
+ * });
+ * ```
+ */
+interface TokenStorage {
+    /** Прочитать сессию. `null`, если её нет. */
+    get(): ItdSession | null | Promise<ItdSession | null>;
+    /** Сохранить сессию целиком. */
+    set(session: ItdSession): void | Promise<void>;
+    /** Удалить сессию. Вызывается при выходе и при неудачном обновлении токена. */
+    clear(): void | Promise<void>;
+}
+/**
+ * Хранилище в памяти процесса — вариант по умолчанию.
+ *
+ * Сессия теряется при перезапуске. Для долгоживущих ботов возьмите `FileTokenStorage`
+ * из `itd-api/node`, для браузера — {@link LocalStorageTokenStorage}.
+ */
+declare class MemoryTokenStorage implements TokenStorage {
+    #private;
+    constructor(initial?: ItdSession | null);
+    get(): ItdSession | null;
+    set(session: ItdSession): void;
+    clear(): void;
+}
+/**
+ * Хранилище поверх `localStorage` браузера.
+ *
+ * Если `localStorage` недоступен (приватный режим, серверный рендеринг), молча работает
+ * как хранилище в памяти — библиотека не должна падать из-за настроек браузера.
+ *
+ * Помните, что `localStorage` доступен любому скрипту на странице: не используйте его,
+ * если для вашего приложения это неприемлемый риск.
+ *
+ * После ошибки записи или удаления хранилище переключается на память до конца
+ * своего жизненного цикла.
+ */
+declare class LocalStorageTokenStorage implements TokenStorage {
+    #private;
+    /** @param key ключ в `localStorage`. По умолчанию `itd-api:session`. */
+    constructor(key?: string);
+    get(): ItdSession | null;
+    set(session: ItdSession): void;
+    clear(): void;
+}
+/**
+ * Собирает {@link TokenStorage} из трёх функций — когда заводить класс избыточно.
+ *
+ * @example
+ * ```ts
+ * const storage = createTokenStorage({
+ *   get: () => db.getSession(userId),
+ *   set: (session) => db.saveSession(userId, session),
+ *   clear: () => db.deleteSession(userId),
+ * });
+ * ```
+ */
+declare function createTokenStorage(handlers: TokenStorage): TokenStorage;
+
+/** Значение параметра запроса. `undefined` и `null` в строку не попадают. */
+type QueryValue = string | number | boolean | null | undefined | readonly (string | number | boolean)[];
+/** Параметры строки запроса. */
+type QueryParams = Record<string, QueryValue>;
+
+/**
+ * Вход по логину и паролю.
+ *
+ * Вход требует токен капчи Cloudflare Turnstile, поэтому полностью автоматическим он быть
+ * не может: капчу должен решить кто-то снаружи. Токен одноразовый и живёт несколько минут,
+ * так что долгоживущему клиенту нужен `getTurnstileToken` — он спрашивается заново перед
+ * каждой попыткой входа. Одиночный `turnstileToken` годится для разового скрипта.
+ */
+interface CredentialsAuth {
+    email: string;
+    password: string;
+    /** Разовый токен капчи. Для повторного входа после истечения сессии не подойдёт. */
+    turnstileToken?: string | undefined;
+    /** Источник свежего токена капчи. Спрашивается перед каждым входом. */
+    getTurnstileToken?: (() => string | Promise<string>) | undefined;
+}
+/**
+ * Как клиент получает доступ к API.
+ *
+ * Четыре формы — от разового вызова с готовым токеном до полноценной сессии, которую
+ * библиотека заводит и продлевает сама.
+ *
+ * Опция необязательна: если {@link ItdClientOptions.storage} уже содержит сессию, доступ
+ * берётся оттуда. Когда заданы обе, хранилище главнее — оно отражает текущее состояние
+ * сессии, — а недостающие поля берутся отсюда.
+ *
+ * @example
+ * ```ts
+ * new ItdClient({ auth: '<accessToken>' });                    // разовый вызов
+ * new ItdClient({ auth: { accessToken, refreshToken } });      // восстановить сессию
+ * new ItdClient({ auth: { email, password, getTurnstileToken } });  // залогиниться самому
+ * new ItdClient({ auth: { getToken: () => vault.read() } });   // токен из внешнего источника
+ * ```
+ */
+type AuthInput = string | {
+    accessToken: string;
+    refreshToken?: string | undefined;
+} | CredentialsAuth | {
+    getToken: () => string | null | Promise<string | null>;
+};
+/** Куда библиотека пишет отладочные сообщения. Совместим с `console`. */
+interface Logger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+/** Настройки повторных попыток. */
+interface RetryOptions {
+    /** Сколько всего попыток, включая первую. По умолчанию 3. */
+    attempts?: number | undefined;
+    /** Базовая пауза в мс, удваивается с каждой попыткой. По умолчанию 500. */
+    baseDelay?: number | undefined;
+    /** Верхняя граница паузы в мс. По умолчанию 30000. */
+    maxDelay?: number | undefined;
+    /** Доля случайного разброса паузы, 0…1. По умолчанию 0.3. */
+    jitter?: number | undefined;
+    /**
+     * Повторять ли запись (`POST`, `PUT`, `PATCH`, `DELETE`) при сетевых сбоях и `5xx`.
+     *
+     * По умолчанию `false`: сервер мог успеть выполнить операцию до обрыва, и повтор
+     * создаст дубль поста или лишнюю жалобу. Ответ `429` повторяется всегда — он гарантирует,
+     * что запрос не был обработан.
+     */
+    retryWrites?: boolean | undefined;
+    /** Своя логика: вернуть `true`, чтобы повторить. Заменяет правила по умолчанию. */
+    shouldRetry?: ((error: unknown, attempt: number) => boolean) | undefined;
+}
+/** Настройки ограничения нагрузки на API. */
+interface RateLimitOptions {
+    /** Сколько запросов выполняется одновременно. По умолчанию 6. */
+    concurrency?: number | undefined;
+    /** Верхняя граница запросов в секунду. По умолчанию без ограничения. */
+    rps?: number | undefined;
+    /**
+     * Паузы перед повторами при ответе `429`, мс.
+     * По умолчанию `[1000, 5000, 30000, 60000, 90000]`.
+     *
+     * Сервер не сообщает, когда сбросится окно лимита, поэтому паузу приходится подбирать.
+     * Лестница начинается с секунды: если окно почти истекло, работа продолжится почти
+     * сразу, а если лимит исчерпан всерьёз — паузы дорастут до полутора минут.
+     * Когда лестница закончилась, {@link ItdRateLimitError} пробрасывается вызывающему коду.
+     *
+     * Этот список не зависит от `retry.attempts`: тот управляет повторами при обрывах
+     * сети и ошибках сервера, где уместен совсем другой темп.
+     */
+    retryDelays?: readonly number[] | undefined;
+    /**
+     * Тормозить ли очередь по заголовкам ответа. По умолчанию `true`.
+     *
+     * Выключите, если управляете темпом сами.
+     */
+    respectHeaders?: boolean | undefined;
+}
+/** Данные о запросе, доступные хукам. */
+interface RequestContext {
+    method: string;
+    /** Путь без базового URL, например `/api/posts`. */
+    path: string;
+    /** Итоговый URL со строкой запроса. */
+    url: string;
+    headers: Headers;
+    /** Номер попытки, начиная с 1. */
+    attempt: number;
+}
+/** Данные об успешном ответе. */
+interface ResponseContext extends RequestContext {
+    status: number;
+    /** Длительность запроса в мс. */
+    duration: number;
+    response: Response;
+}
+/** Данные об ошибке запроса. */
+interface ErrorContextHook extends RequestContext {
+    duration: number;
+    error: unknown;
+}
+/** Данные о предстоящем повторе. */
+interface RetryContext extends RequestContext {
+    error: unknown;
+    /** Пауза перед следующей попыткой в мс. */
+    delay: number;
+}
+/**
+ * Перехватчики жизненного цикла запроса.
+ *
+ * Вызываются последовательно; исключение внутри хука прервёт запрос, поэтому свою логику
+ * лучше оборачивать в `try`.
+ */
+interface ClientHooks {
+    /** Перед отправкой. Можно дописать заголовки — объект `headers` изменяемый. */
+    onRequest?(context: RequestContext): void | Promise<void>;
+    /** После успешного ответа, до разбора тела. */
+    onResponse?(context: ResponseContext): void | Promise<void>;
+    /** При любой ошибке запроса, включая те, что будут повторены. */
+    onError?(context: ErrorContextHook): void | Promise<void>;
+    /** Перед паузой между попытками. */
+    onRetry?(context: RetryContext): void | Promise<void>;
+}
+/**
+ * Опции конструктора `ItdClient`.
+ *
+ * Все поля допускают явный `undefined`, чтобы можно было передавать значения, которых
+ * может не быть, — например `new ItdClient({ auth: process.env.ITD_TOKEN })`.
+ */
+interface ItdClientOptions {
+    /**
+     * Базовый URL API. По умолчанию `https://xn--d1ah4a.com`.
+     *
+     * Укажите здесь адрес своего прокси, если работаете из браузера: CORS для сторонних
+     * источников на итд.com, скорее всего, не настроен.
+     */
+    baseUrl?: string | undefined;
+    /**
+     * Сервисы платформы на отдельных доменах.
+     *
+     * Ключ — имя сервиса, значение — базовый URL или определение целиком. Имя встроенного
+     * сервиса задаёт его хост. Встроен один: `status` — хост `itd.platform.status()`.
+     *
+     * @example
+     * ```ts
+     * const itd = new ItdClient({
+     *   services: {
+     *     status: 'https://my-proxy.example/status',
+     *     pb: { baseUrl: 'https://pbapi.xn--d1ah4a.com', headers: { Referer: 'https://pixel.xn--d1ah4a.com/' } },
+     *   },
+     * });
+     * ```
+     */
+    services?: Record<string, string | Omit<ServiceDefinition, 'name'>> | undefined;
+    /** Авторизация. Без неё доступны только публичные эндпоинты. */
+    auth?: AuthInput | undefined;
+    /** Где хранить сессию. По умолчанию {@link MemoryTokenStorage}. */
+    storage?: TokenStorage | undefined;
+    /**
+     * Обновлять токен автоматически при ответе `401`. По умолчанию `true`.
+     *
+     * При `false` библиотека просто пробросит {@link ItdAuthError}, а обновлением
+     * вы управляете сами через `itd.auth.refresh()`.
+     */
+    autoRefresh?: boolean | undefined;
+    /**
+     * Пытаться ли войти заново, если обновление токена не удалось.
+     *
+     * Работает, только когда в `auth` переданы email и пароль. По умолчанию `true`.
+     */
+    reloginOnRefreshFailure?: boolean | undefined;
+    /** Своя реализация `fetch`: для Deno, React Native, тестов или прокси. */
+    fetch?: typeof fetch | undefined;
+    /** Таймаут запроса в мс. По умолчанию 30000 — столько же использует сайт итд.com. `0` снимает ограничение. */
+    timeout?: number | undefined;
+    /** Повторные попытки. `false` отключает их полностью. */
+    retry?: RetryOptions | false | undefined;
+    /** Ограничение нагрузки. `false` отключает очередь. */
+    rateLimit?: RateLimitOptions | false | undefined;
+    /** Перехватчики запросов. */
+    hooks?: ClientHooks | undefined;
+    /** Отладочный вывод. `true` — писать в `console`. */
+    logger?: Logger | boolean | undefined;
+    /** Заголовки, добавляемые ко всем запросам, — например `User-Agent` для бота. */
+    headers?: Record<string, string> | undefined;
+    /**
+     * Значение заголовка `X-Device-Id`, который уходит с каждым запросом.
+     *
+     * Сервер различает по нему записи в списке сессий, поэтому значение должно быть стабильным.
+     * Если не задать, библиотека заведёт идентификатор сама и сохранит его в {@link ItdSession},
+     * так что при постоянном хранилище он переживёт перезапуск процесса.
+     */
+    deviceId?: string | undefined;
+    /**
+     * Значение заголовка `User-Agent`. `false` — не отправлять его вовсе.
+     *
+     * По умолчанию `Mozilla/5.0 (compatible; itd-api/<версия>; …)`: `fetch` в Node не шлёт
+     * `User-Agent` сам, а сайт стоит за DDoS-Guard, который такие запросы может не пропустить.
+     * В браузере опция не действует — там заголовок менять запрещено.
+     */
+    userAgent?: string | false | undefined;
+    /** Как обращаться с cookie. По умолчанию определяется по среде исполнения. */
+    mode?: RuntimeMode | undefined;
+}
+/** Опции отдельного запроса. Доступны в каждом методе ресурсов. */
+interface RequestOptions {
+    /** Отмена запроса извне. */
+    signal?: AbortSignal | undefined;
+    /** Таймаут только для этого запроса, мс. */
+    timeout?: number | undefined;
+    /** Дополнительные заголовки. */
+    headers?: Record<string, string> | undefined;
+    /** Повторы только для этого запроса. Переопределяют глобальную настройку `retry`. */
+    retry?: RetryOptions | false | undefined;
+}
+/**
+ * Имена полей {@link RequestOptions} — единственный источник истины.
+ *
+ * Ресурсы переносят в описание запроса только эти поля (плюс заявленные плагинами),
+ * потому что параметры методов подмешивают к ним `limit`, `cursor` и прочее, чему
+ * в транспорте делать нечего. Список стоит рядом с интерфейсом, чтобы новое поле нельзя
+ * было забыть.
+ *
+ * `satisfies` гарантирует, что каждое имя в списке — действительно поле `RequestOptions`.
+ * Обратную полноту (не забыто ли новое поле) проверяет тип {@link RequestOptionKeysComplete}
+ * в тесте: здесь её проверять нельзя — плагины расширяют `RequestOptions` своими опциями
+ * (`encrypt`, `decrypt` и подобными), которых в этом списке быть и не должно.
+ */
+declare const REQUEST_OPTION_KEYS: readonly ["signal", "timeout", "headers", "retry"];
+/** Полное описание запроса для низкоуровневого `itd.request()`. */
+interface RawRequestOptions extends RequestOptions {
+    method: string;
+    /** Путь с ведущим слэшем, например `/api/posts`. Завершающий слэш значим. */
+    path: string;
+    /**
+     * Имя сервиса, на хост которого уйдёт запрос. Без него запрос идёт на основной `baseUrl`
+     * клиента. Сервисы задаются опцией {@link ItdClientOptions.services}.
+     */
+    service?: string | undefined;
+    /** Хост этого запроса. Важнее, чем {@link RawRequestOptions.service}. */
+    baseUrl?: string | undefined;
+    query?: QueryParams | undefined;
+    /** Тело: будет отправлено как JSON. Для загрузки файлов передайте `FormData`. */
+    body?: unknown;
+    /** Не подставлять заголовок авторизации. */
+    skipAuth?: boolean | undefined;
+    /** Не пытаться обновить токен при `401` — используется самими эндпоинтами авторизации. */
+    skipAuthRefresh?: boolean | undefined;
+    /**
+     * Выполнить запрос мимо очереди.
+     *
+     * Нужно запросам, которые слой авторизации делает **изнутри** другого запроса: продление
+     * токена и отложенный вход. Такой запрос обязан стартовать, пока исходный держит место
+     * в очереди и ждёт его результата, — иначе оба ждут друг друга и не завершатся никогда.
+     */
+    skipQueue?: boolean | undefined;
+    /** Вернуть тело ответа без снятия обёртки `{ data: … }`. */
+    raw?: boolean | undefined;
+}
+
+/** Версия библиотеки. Попадает в `User-Agent`. */
+declare const LIBRARY_VERSION = "0.0.9";
+
+/** Базовый URL API итд.com. Домен записан в punycode: `итд.com`. */
+declare const DEFAULT_BASE_URL = "https://xn--d1ah4a.com";
+/** Базовый URL страницы статуса. Домен записан в punycode: `статус.итд.com`. */
+declare const DEFAULT_STATUS_BASE_URL = "https://xn--80a7abcbg.xn--d1ah4a.com";
+/** Имя встроенного сервиса статуса. */
+declare const STATUS_SERVICE = "status";
+/** Сервисы, зарегистрированные у любого клиента. */
+declare const BUILT_IN_SERVICES: readonly ServiceDefinition[];
+/** Таймаут запроса по умолчанию. Столько же использует официальный клиент итд.com. */
+declare const DEFAULT_TIMEOUT = 30000;
+
+/**
+ * `User-Agent` по умолчанию.
+ *
+ * Сайт стоит за DDoS-Guard, и запросы вовсе без `User-Agent` (так делает `fetch` в Node)
+ * имеют шанс не пройти фильтр. Префикс `Mozilla/5.0` — дань традиции таких фильтров,
+ * дальше идёт честное имя библиотеки: подделываться под браузер она не должна.
+ *
+ * В браузере заголовок не выставляется — `User-Agent` там запрещён к изменению, и среда
+ * молча его игнорирует.
+ */
+declare const DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; itd-api/0.0.9; +https://github.com/KiowDev/itd-api)";
+/**
+ * Срез конфигурации, нужный слою авторизации.
+ *
+ * Выделен явно, чтобы {@link AuthManager} не получал целиком `ResolvedConfig` со всеми
+ * настройками транспорта, повторов и очереди, к которым он отношения не имеет.
+ * `ResolvedConfig` содержит все эти поля, поэтому подходит везде, где ждут `AuthConfig`.
+ */
+interface AuthConfig {
+    baseUrl: string;
+    auth: AuthInput | undefined;
+    storage: TokenStorage;
+    useCookieJar: boolean;
+    deviceId: string | undefined;
+    reloginOnRefreshFailure: boolean;
+    logger: Logger | undefined;
+}
+
+/** Имя cookie-флага «есть refresh-сессия». Ставится сайтом итд.com рядом с refresh-токеном. */
+declare const AUTH_FLAG_COOKIE = "is_auth";
+/**
+ * Имя cookie с refresh-токеном.
+ *
+ * `POST /api/v1/auth/refresh` читает токен **только отсюда** — тело запроса сервер игнорирует.
+ * Cookie помечена `HttpOnly`, поэтому в браузере её не прочитать и не выставить; вне браузера
+ * она проходит через jar, и туда же кладётся токен, переданный строкой.
+ */
+declare const REFRESH_COOKIE = "refresh_token";
+/** Путь, которым сервер ограничивает {@link REFRESH_COOKIE}. */
+declare const REFRESH_COOKIE_PATH = "/api/v1/auth";
+/**
+ * Минимальное хранилище cookie для сред без своего.
+ *
+ * Refresh-токен итд.com приходит в `Set-Cookie`, а `fetch` вне браузера cookie не хранит —
+ * без jar сессию не продлить. В браузере и React Native не используется: там cookie ведёт
+ * сама среда.
+ *
+ * Реализована практическая часть RFC 6265: origin, путь, срок жизни, флаг `Secure`.
+ * Доменные cookie для поддоменов намеренно не поддерживаются — API работает с одного хоста.
+ */
+declare class CookieJar {
+    #private;
+    /**
+     * Забирает `Set-Cookie` из ответа.
+     *
+     * Использует `Headers.getSetCookie()`, где он есть (Node 20+, undici). В остальных средах
+     * заголовки склеены в одну строку, и её нельзя резать по запятой напрямую: запятая есть
+     * внутри `Expires=Wed, 09 Jun 2027 …`. Разделением занимается `set-cookie-parser`.
+     */
+    setFromResponse(url: string, response: Response): void;
+    /**
+     * Кладёт cookie напрямую, минуя `Set-Cookie`.
+     *
+     * Нужно ровно в одном случае: пользователь передал refresh-токен строкой, а сервер читает
+     * его только из cookie. Значение не кодируется — оно уходит в заголовок как есть.
+     */
+    set(url: string, name: string, value: string, path?: string): void;
+    /** Сохраняет cookie из готовых строк `Set-Cookie`. */
+    setFromStrings(url: string, setCookieStrings: string[]): void;
+    /**
+     * Собирает значение заголовка `Cookie` для запроса.
+     *
+     * @returns строка вида `a=1; b=2` либо `undefined`, если подходящих cookie нет
+     */
+    getHeader(url: string): string | undefined;
+    /**
+     * Значение действующей cookie.
+     *
+     * Нужно, чтобы забрать обновлённый refresh-токен: сервер ротирует его при каждом
+     * продлении сессии, и сохранять надо именно новое значение.
+     *
+     * @param url если указан, учитываются origin, путь и флаг `Secure`
+     */
+    getValue(name: string, url?: string): string | undefined;
+    /**
+     * Есть ли действующая cookie с таким именем.
+     *
+     * Используется для проверки флага {@link AUTH_FLAG_COOKIE} перед запросом обновления
+     * токена: у анонима refresh-сессии нет, и дёргать API незачем.
+     */
+    has(name: string, url?: string): boolean;
+    /** Сохраняет содержимое jar для записи в {@link TokenStorage}. */
+    serialize(): string[];
+    /** Восстанавливает jar из результата {@link serialize}. Некорректные записи молча пропускаются. */
+    deserialize(entries: readonly string[] | undefined): void;
+    /** Удаляет все cookie. */
+    clear(): void;
+}
+
+/** Обработчик события. */
+type Listener<T> = (payload: T) => void;
+/** Функция отписки, которую возвращает подписка на событие. */
+type Unsubscribe = () => void;
+/**
+ * Минимальный типизированный источник событий.
+ *
+ * Своя реализация вместо `EventTarget` и `EventEmitter`: первый есть не везде и требует
+ * обёрток `CustomEvent`, второй существует только в Node. Нужны ровно подписка и рассылка.
+ *
+ * Исключение в обработчике не прерывает рассылку остальным и не роняет библиотеку.
+ *
+ * @typeParam Events карта «имя события → тип полезной нагрузки». Задаётся интерфейсом,
+ * поэтому ограничение на индексную сигнатуру намеренно не накладывается.
+ */
+declare class Emitter<Events> {
+    #private;
+    constructor(onListenerError?: (error: unknown) => void);
+    /**
+     * Подписывается на событие.
+     *
+     * @returns функция отписки
+     *
+     * @example
+     * ```ts
+     * const off = realtime.on('notification', (event) => console.log(event));
+     * off();
+     * ```
+     */
+    on<K extends keyof Events>(event: K, listener: Listener<Events[K]>): Unsubscribe;
+    /** Подписывается на одно срабатывание. */
+    once<K extends keyof Events>(event: K, listener: Listener<Events[K]>): Unsubscribe;
+    /** Отписывается от события. */
+    off<K extends keyof Events>(event: K, listener: Listener<Events[K]>): void;
+    /** Рассылает событие подписчикам. */
+    emit<K extends keyof Events>(event: K, payload: Events[K]): void;
+    /** Сколько подписчиков у события. */
+    listenerCount(event: keyof Events): number;
+    /** Снимает все подписки. */
+    removeAllListeners(): void;
+}
+
+/**
+ * Описание запроса внутри конвейера.
+ *
+ * Отличается от публичного {@link RawRequestOptions} одним служебным полем: слои конвейера
+ * должны уметь дописать заголовки так, чтобы пользовательские `headers` всё равно остались
+ * важнее. Смешивать их в одном объекте нельзя — тогда слой авторизации перебивал бы
+ * `Authorization`, заданный вызывающим кодом вручную.
+ */
+interface PipelineRequest extends RawRequestOptions {
+    /**
+     * Заголовки, добавленные слоями конвейера.
+     *
+     * Ставятся до пользовательских `headers` и потому могут быть ими переопределены.
+     *
+     * @internal
+     */
+    layerHeaders?: Record<string, string> | undefined;
+    /**
+     * Номер попытки, начиная с 1. Проставляет слой повторов, читают хуки.
+     *
+     * @internal
+     */
+    attempt?: number | undefined;
+}
+/** Обработчик запроса. Самый внутренний в цепочке — транспорт. */
+type RequestHandler = (request: PipelineRequest) => Promise<unknown>;
+
+/** Пути эндпоинтов авторизации. */
+declare const AUTH_PATHS: {
+    readonly signUp: "/api/v1/auth/sign-up";
+    readonly signIn: "/api/v1/auth/sign-in";
+    readonly verifyOtp: "/api/v1/auth/verify-otp";
+    readonly resendOtp: "/api/v1/auth/resend-otp";
+    readonly refresh: "/api/v1/auth/refresh";
+    readonly logout: "/api/v1/auth/logout";
+    readonly forgotPassword: "/api/v1/auth/forgot-password";
+    readonly resetPassword: "/api/v1/auth/reset-password";
+    readonly changePassword: "/api/v1/auth/change-password";
+    readonly sessions: "/api/v1/auth/sessions";
+    /** Префикс внешнего входа: к нему дописывается имя провайдера. */
+    readonly oauthLogin: "/api/v1/auth/login";
+};
+/**
+ * Публичный ключ Cloudflare Turnstile платформы итд.com.
+ *
+ * Нужен, чтобы отрисовать виджет капчи и получить токен для `signIn`, `signUp`
+ * и `forgotPassword`.
+ *
+ * @example
+ * ```ts
+ * turnstile.render('#captcha', {
+ *   sitekey: TURNSTILE_SITE_KEY,
+ *   callback: (turnstileToken) => itd.auth.signIn({ email, password, turnstileToken }),
+ * });
+ * ```
+ */
+declare const TURNSTILE_SITE_KEY = "0x4AAAAAACHhxczw6fJGwPBg";
+/** Заголовок с идентификатором устройства. Сервер связывает с ним запись в списке сессий. */
+declare const DEVICE_ID_HEADER = "X-Device-Id";
+/** События слоя авторизации. */
+interface AuthEvents {
+    /** Токен получен или обновлён. */
+    tokens: {
+        accessToken: string;
+    };
+    /** Выполнен вход. */
+    signIn: {
+        accessToken: string;
+    };
+    /** Сессия очищена — вручную или из-за неудачного обновления. */
+    signOut: undefined;
+    /** Обновить сессию не удалось; дальнейшие запросы будут падать с 401. */
+    authError: {
+        error: unknown;
+    };
+}
+/**
+ * Хранит сессию и продлевает её.
+ *
+ * Главное здесь — **дедупликация обновления**. Когда десять параллельных запросов
+ * одновременно получают `401`, обновление должно произойти один раз, а остальные обязаны
+ * дождаться его результата. Иначе сервер увидит десять параллельных `refresh`, и все,
+ * кроме первого, скорее всего получат отказ по уже использованному токену.
+ */
+declare class AuthManager {
+    #private;
+    constructor(config: AuthConfig, send: RequestHandler, jar: CookieJar);
+    /** Подписка на события авторизации. */
+    get on(): Emitter<AuthEvents>['on'];
+    /** Подписка на одно срабатывание. */
+    get once(): Emitter<AuthEvents>['once'];
+    /**
+     * Есть ли признак живой refresh-сессии.
+     *
+     * Рядом с refresh-токеном сервер ставит незакрытую cookie `is_auth` — по ней видно,
+     * что продлевать сессию вообще есть смысл, и API не дёргается у анонимов.
+     * В браузере cookie ведёт сама среда, поэтому там ответ всегда `true`.
+     *
+     * Асинхронный, потому что признак может лежать в {@link TokenStorage}: до чтения оттуда
+     * ответ был бы `false` даже при полностью рабочей сохранённой сессии.
+     */
+    hasRefreshSession(): Promise<boolean>;
+    /** Заголовки авторизации для очередного запроса. Пустой объект, если токена нет. */
+    getAuthHeaders(): Promise<Record<string, string>>;
+    /**
+     * Идентификатор устройства для заголовка `X-Device-Id`.
+     *
+     * Заводится один раз и сохраняется в сессии, чтобы пережить перезапуск процесса:
+     * сервер связывает с ним запись в списке сессий, и плавающее значение плодило бы
+     * по новой сессии на каждый старт.
+     */
+    getDeviceId(): Promise<string>;
+    /**
+     * Текущий токен доступа.
+     *
+     * При необходимости выполняет отложенный вход: если в конфигурации переданы логин
+     * и пароль, первый же запрос сам заведёт сессию.
+     */
+    getAccessToken(): Promise<string | null>;
+    /**
+     * Реакция транспорта на ответ `401`.
+     *
+     * @returns `true`, если токен обновлён и запрос имеет смысл повторить
+     */
+    onUnauthorized(): Promise<boolean>;
+    /**
+     * Обновляет токен доступа.
+     *
+     * Параллельные вызовы объединяются в один сетевой запрос.
+     *
+     * @throws {ItdAuthError} если обновить сессию не удалось
+     */
+    refresh(): Promise<string>;
+    /** Сохраняет токен, полученный извне, — например после подтверждения OTP. */
+    setAccessToken(accessToken: string): Promise<void>;
+    /** Текущая сессия целиком. Полезно, чтобы сохранить её самому. */
+    getSession(): Promise<ItdSession | null>;
+    /** Заменяет сессию и связанные с ней cookie целиком. */
+    setSession(session: ItdSession): Promise<void>;
+    /**
+     * Забывает сессию и cookie. Сетевой запрос не выполняется.
+     *
+     * Идентификатор устройства выход переживает: иначе каждая пара «выход — вход» плодила бы
+     * новую запись в списке сессий.
+     */
+    clear(): Promise<void>;
+}
+
+/**
+ * Обёртка вокруг запроса.
+ *
+ * Получает описание запроса и продолжение цепочки. Может изменить запрос перед отправкой,
+ * посмотреть и подменить разобранный ответ или вовсе не вызывать `next` и вернуть своё.
+ *
+ * @param request что уходит на сервер; изменять сам объект не нужно — передайте копию в `next`
+ * @param next продолжение: либо следующая обёртка, либо настоящий запрос
+ * @returns тело ответа в том виде, в каком его получит вызывающий код
+ *
+ * @example Дописать заголовок ко всем запросам
+ * ```ts
+ * const transformer: Transformer = (request, next) =>
+ *   next({ ...request, headers: { ...request.headers, 'X-Trace': trace() } });
+ * ```
+ */
+type Transformer = (request: RawRequestOptions, next: (request: RawRequestOptions) => Promise<unknown>) => Promise<unknown>;
+/** Что плагин получает при подключении. */
+interface PluginContext {
+    /** Базовый URL клиента — например чтобы разобрать абсолютные ссылки из ответа. */
+    baseUrl: string;
+    /** Отладочный вывод клиента, если он включён. */
+    logger: Logger | undefined;
+    /** Добавляет обёртку запроса. Подключённые раньше оказываются снаружи. */
+    use(transformer: Transformer): void;
+}
+/**
+ * Плагин клиента.
+ *
+ * Подключается через `itd.use(plugin)` и работает на уровне транспорта: видит запрос
+ * до отправки и разобранный ответ. Библиотека не знает, что именно делает плагин, —
+ * ей достаточно списка обёрток и имён опций, которые он читает.
+ *
+ * @example
+ * ```ts
+ * const logging: ItdPlugin = {
+ *   name: 'logging',
+ *   install({ use, logger }) {
+ *     use(async (request, next) => {
+ *       logger?.info(`${request.method} ${request.path}`);
+ *       return next(request);
+ *     });
+ *   },
+ * };
+ *
+ * itd.use(logging);
+ * ```
+ */
+interface ItdPlugin {
+    /** Имя плагина. Должно быть уникальным: повторное подключение — ошибка. */
+    name: string;
+    /**
+     * Имена опций запроса, которые плагин читает у методов ресурсов.
+     *
+     * Библиотека этих опций не понимает и ничего с ними не делает — только доносит
+     * от вызова метода до обёртки нетронутыми. Без такого списка чужие поля отсеиваются,
+     * чтобы случайная опечатка в параметрах не уезжала на сервер.
+     *
+     * Имена полей самого запроса (`path`, `body`, `headers`, `signal` и прочие из
+     * `RawRequestOptions`) заявить нельзя: подключение такого плагина завершится ошибкой.
+     *
+     * Типы для них плагин объявляет сам, дополняя `RequestOptions`:
+     * ```ts
+     * declare module 'itd-api' {
+     *   interface RequestOptions { encrypt?: string | undefined }
+     * }
+     * ```
+     */
+    optionKeys?: readonly string[];
+    /** Вызывается один раз при подключении. */
+    install(context: PluginContext): void;
+}
+/**
+ * Список подключённых плагинов и собранная из них цепочка обёрток.
+ *
+ * Живёт в клиенте, а работает в транспорте: {@link HttpClient} прогоняет через `run`
+ * каждый запрос, если плагины есть.
+ */
+declare class PluginRegistry {
+    #private;
+    /** Сколько обёрток подключено. Ноль означает, что запрос идёт прежним путём. */
+    get size(): number;
+    /** Имена опций запроса, заявленные плагинами. */
+    get optionKeys(): ReadonlySet<string>;
+    /**
+     * Подключает плагин.
+     *
+     * @throws {ItdConfigError} если плагин задан неверно, уже подключён или заявил занятое
+     * имя опции
+     */
+    add(plugin: ItdPlugin, context: Omit<PluginContext, 'use'>): void;
+    /**
+     * Прогоняет запрос через цепочку обёрток.
+     *
+     * Цепочка собирается на каждый запрос заново: плагин можно подключить в любой момент,
+     * а обёрток единицы — экономить тут не на чем.
+     *
+     * @param execute настоящий запрос, вызывается самой внутренней обёрткой
+     */
+    run(request: RawRequestOptions, execute: (request: RawRequestOptions) => Promise<unknown>): Promise<unknown>;
+}
+
+/** Событие потока уведомлений после разбора. */
+interface NotificationEvent {
+    /** Само уведомление в единой форме. */
+    notification: Notification;
+    /**
+     * Актуальное число непрочитанных, если сервер его сообщил.
+     *
+     * Клиент не увеличивает счётчик сам: значение приходит с сервера.
+     */
+    unreadCount: number | undefined;
+    /** Нужно ли проиграть звук. */
+    sound: boolean;
+}
+/**
+ * Приводит уведомление к единой форме.
+ *
+ * Нужна потому, что REST-список и поток событий описывают одно и то же событие по-разному:
+ * различаются имена типов (`like` против `post_reaction`), имена полей
+ * (`targetId`/`entityId`, `read`/`isRead`, `preview`/`entityPreview`) и число участников
+ * (`actor` против массива `actors`). После приведения объекты из обоих источников
+ * можно складывать в один список.
+ *
+ * Исходные данные не теряются: имя типа с сервера остаётся в `rawType`,
+ * весь объект целиком — в `raw`.
+ *
+ * @param input уведомление из REST-ответа либо полезная нагрузка события потока
+ *
+ * @example
+ * ```ts
+ * const fromRest = normalizeNotification(restItem);
+ * const fromStream = normalizeNotification(event.payload);
+ * // одинаковая форма — можно объединять
+ * ```
+ */
+declare function normalizeNotification(input: unknown): Notification;
+/**
+ * Разбирает событие `notification` из потока.
+ *
+ * Кроме самого уведомления событие несёт служебные поля уровня конверта: актуальный
+ * счётчик непрочитанных и признак звука.
+ */
+declare function readNotificationEvent(data: unknown): NotificationEvent;
+/**
+ * Разбирает событие `unread_count` из потока.
+ *
+ * Возвращает `undefined`, если сервер прислал событие без вложенного `payload`.
+ * Официальный клиент в этом случае **обнуляет** счётчик — это ошибка, из-за которой
+ * непрочитанные пропадают из интерфейса.
+ */
+declare function readUnreadCountEvent(data: unknown): number | undefined;
+
+/**
+ * Паузы перед попытками переподключения, мс.
+ *
+ * Значения совпадают с теми, что использует сайт итд.com, — поведение библиотеки
+ * не отличается от привычного пользователю.
+ */
+declare const RECONNECT_BACKOFF: readonly number[];
+/** Доля случайного разброса паузы. */
+declare const RECONNECT_JITTER = 0.3;
+/**
+ * Сколько раз пытаться переподключиться подряд.
+ *
+ * После исчерпания поток сообщает `giveup` и ждёт ручного `connect()`.
+ */
+declare const MAX_RECONNECT_ATTEMPTS = 15;
+/** Настройки переподключения. */
+interface ReconnectOptions {
+    /** Таблица пауз. Последнее значение действует для всех дальнейших попыток. */
+    backoff?: readonly number[];
+    /** Доля разброса, 0…1. */
+    jitter?: number;
+    /** Предел числа попыток. */
+    maxAttempts?: number;
+}
+
+/** Событие, пришедшее по каналу реального времени. */
+interface TransportEvent {
+    /** Имя события: `notification`, `unread_count` и другие. */
+    name: string;
+    /** Полезная нагрузка, уже разобранная из JSON. */
+    data: unknown;
+}
+/** Что транспорт получает от клиента при подключении. */
+interface TransportContext {
+    /** Базовый URL API. */
+    baseUrl: string;
+    /** Реализация `fetch`. */
+    fetch: typeof fetch;
+    /**
+     * Общие заголовки клиента: `User-Agent`, `X-Device-Id`, заголовки конфигурации
+     * и cookie для указанного адреса.
+     */
+    baseHeaders: (url: string) => Promise<Headers>;
+    /** Текущий токен доступа. */
+    getToken: () => Promise<string | null>;
+    /** Отмена подключения. */
+    signal: AbortSignal;
+    /** Сообщает о полученном событии. */
+    onEvent: (event: TransportEvent) => void;
+    /** Сообщает о разобранном, но некорректном сообщении. Соединение при этом живёт. */
+    onParseError: (error: unknown, raw: string) => void;
+    /** Вызывается, когда соединение установлено. */
+    onOpen: () => void;
+}
+/**
+ * Канал получения событий в реальном времени.
+ *
+ * Сейчас у платформы один такой канал — поток `text/event-stream`. Абстракция нужна
+ * на будущее: политика безопасности сайта уже разрешает `wss://*.xn--d1ah4a.com`,
+ * и когда появится WebSocket, достаточно будет добавить ещё одну реализацию этого
+ * интерфейса. Переподключение, обновление токена и разбор уведомлений от транспорта
+ * не зависят.
+ */
+interface RealtimeTransport {
+    /** Понятное имя для логов и диагностики. */
+    readonly name: string;
+    /**
+     * Держит соединение, пока оно живо.
+     *
+     * Должен завершиться, когда поток закрылся, и бросить исключение при ошибке.
+     * Отмена через `context.signal` должна приводить к `AbortError`.
+     */
+    connect(context: TransportContext): Promise<void>;
+}
+/** Ошибка, по которой видно, что сервер отверг авторизацию потока. */
+declare class UnauthorizedStreamError extends Error {
+    constructor();
+}
+
+/** События потока уведомлений. */
+interface RealtimeEvents {
+    /** Пришло новое уведомление. */
+    notification: NotificationEvent;
+    /**
+     * Сервер подтвердил подключение и назвал получателя событий.
+     *
+     * Приходит первым кадром сразу после установки соединения.
+     */
+    ready: {
+        userId: string | undefined;
+    };
+    /**
+     * Сервер сообщил актуальное число непрочитанных.
+     *
+     * На практике сервер этого не делает: за всё наблюдение он не прислал ни одного
+     * такого кадра, а в уведомлениях нет поля со счётчиком. Держите счётчик сами
+     * либо запрашивайте `itd.notifications.count()`.
+     */
+    unreadCount: number;
+    /** Изменилось состояние соединения. */
+    status: RealtimeStatus;
+    /** Соединение оборвалось; будет предпринята попытка переподключения. */
+    error: {
+        error: unknown;
+        willReconnect: boolean;
+    };
+    /** Сообщение не удалось разобрать. Соединение при этом продолжает работать. */
+    parseError: {
+        error: unknown;
+        raw: string;
+    };
+    /** Запланировано переподключение. */
+    reconnect: {
+        attempt: number;
+        delay: number;
+    };
+    /** Попытки исчерпаны — соединение восстановится только ручным `connect()`. */
+    giveup: undefined;
+    /** Любое событие потока в необработанном виде, включая неизвестные библиотеке. */
+    message: {
+        name: string;
+        data: unknown;
+    };
+}
+/** Способ получения событий. */
+declare const RealtimeTransportKind: Readonly<{
+    /** Поток событий, если среда умеет читать тело по частям, иначе опрос. */
+    readonly Auto: "auto";
+    /** Поток `text/event-stream`. */
+    readonly Sse: "sse";
+    /** Периодический опрос REST. */
+    readonly Poll: "poll";
+}>;
+type RealtimeTransportKind = (typeof RealtimeTransportKind)[keyof typeof RealtimeTransportKind];
+/** Настройки потока уведомлений. */
+interface RealtimeOptions extends ReconnectOptions {
+    /**
+     * Транспорт. По умолчанию `auto`: поток событий, если среда умеет читать тело ответа
+     * по частям, иначе опрос.
+     *
+     * Можно передать и свою реализацию {@link RealtimeTransport} — это пригодится, если
+     * у платформы появится WebSocket либо нужен нестандартный способ доставки.
+     */
+    transport?: RealtimeTransportKind | RealtimeTransport;
+    /**
+     * Молчание сервера, после которого соединение считается мёртвым, мс. По умолчанию 90 000.
+     *
+     * Сервер не присылает keep-alive, поэтому без этой проверки оборванное соединение
+     * может незаметно «зависнуть».
+     */
+    idleTimeout?: number;
+    /** Как часто опрашивать сервер, если используется запасной транспорт. */
+    pollInterval?: number;
+    /**
+     * Запрашивать число непрочитанных при подключении. По умолчанию `true`.
+     *
+     * Так поступает сайт итд.com: поток присылает только новые события, а начальное
+     * значение счётчика нужно получить отдельно.
+     */
+    syncCount?: boolean;
+    /**
+     * Переподключаться, когда вкладка снова становится видимой. По умолчанию `true`.
+     *
+     * Только в браузере. У сайта итд.com такой обработки нет, из-за чего вкладка,
+     * пролежавшая в фоне, может остаться без соединения.
+     */
+    reconnectOnVisible?: boolean;
+    /** Переподключаться при восстановлении сети. По умолчанию `true`. Только в браузере. */
+    reconnectOnOnline?: boolean;
+}
+/** Что поток получает от клиента. */
+interface RealtimeDeps {
+    baseUrl: string;
+    fetch: typeof fetch;
+    /** Общие заголовки клиента для адреса — см. {@link TransportContext.baseHeaders}. */
+    baseHeaders: (url: string) => Promise<Headers>;
+    getToken: () => Promise<string | null>;
+    /** Обновляет токен после отказа авторизации. Возвращает `true`, если удалось. */
+    refresh: () => Promise<boolean>;
+    /** Загружает начальное число непрочитанных. */
+    fetchUnreadCount: () => Promise<number>;
+    /** Вызывается при явном закрытии потока. */
+    onClose?: (() => void) | undefined;
+    logger?: Logger | undefined;
+}
+/**
+ * Поток уведомлений в реальном времени.
+ *
+ * Получается вызовом `itd.realtime()`. Соединение поднимается методом {@link connect}
+ * и держится само: обрывы, обновление токена и повторные попытки библиотека берёт на себя.
+ *
+ * @example
+ * ```ts
+ * const stream = itd.realtime();
+ *
+ * stream.on('notification', ({ notification, unreadCount }) => {
+ *   console.log(formatNotificationText(notification), unreadCount);
+ * });
+ * stream.on('status', (status) => console.log('соединение:', status));
+ *
+ * await stream.connect();
+ * // …позже
+ * stream.disconnect();
+ * ```
+ */
+declare class ItdRealtime {
+    #private;
+    constructor(deps: RealtimeDeps, options?: RealtimeOptions);
+    /** Текущее состояние соединения. */
+    get status(): RealtimeStatus;
+    /** Какой транспорт используется: `sse` или `poll`. */
+    get transport(): string;
+    /** Подписывается на событие потока. @returns функция отписки */
+    on<K extends keyof RealtimeEvents>(event: K, listener: Listener<RealtimeEvents[K]>): Unsubscribe;
+    /** Подписывается на одно срабатывание. */
+    once<K extends keyof RealtimeEvents>(event: K, listener: Listener<RealtimeEvents[K]>): Unsubscribe;
+    /**
+     * Поднимает соединение.
+     *
+     * Повторный вызов при уже живом соединении ничего не делает — это защита от двойного
+     * подключения при перерисовке интерфейса.
+     *
+     * Возвращает управление сразу после запуска: соединение живёт в фоне.
+     */
+    connect(): Promise<void>;
+    /** Закрывает соединение и отменяет запланированные попытки. */
+    disconnect(): void;
+    /** Снимает все подписки. Соединение при этом не закрывается. */
+    removeAllListeners(): void;
+}
+
+/** Что нужно фасаду для работы. */
+interface HttpClientDeps {
+    /** Готовый обработчик — вся цепочка слоёв поверх транспорта. */
+    handler: RequestHandler;
+    /** Реестр плагинов: у него ресурсы спрашивают имена заявленных опций. */
+    plugins: PluginRegistry;
+    baseUrl: string;
+}
+/**
+ * Точка входа ресурсов в конвейер запросов.
+ *
+ * Принимает готовый обработчик — цепочку слоёв поверх транспорта, собранную
+ * в {@link ItdClient}, — и отдаёт ресурсам метод `request` и имена опций плагинов.
+ * О слоях и их порядке ресурсы не знают.
+ */
+declare class HttpClient {
+    #private;
+    constructor(deps: HttpClientDeps);
+    /** Базовый URL, к которому обращается клиент. */
+    get baseUrl(): string;
+    /**
+     * Имена опций запроса, заявленные плагинами.
+     *
+     * Читается ресурсами: они переносят в транспорт только известные поля, а чужие,
+     * если их никто не заявил, отсеивают.
+     */
+    get pluginOptionKeys(): ReadonlySet<string>;
+    /**
+     * Выполняет запрос к API через собранный конвейер.
+     *
+     * @typeParam T ожидаемая форма ответа после снятия обёртки `{ data: … }`
+     * @throws {ItdApiError} если сервер ответил статусом ≥ 400
+     * @throws {ItdTimeoutError} если истёк таймаут
+     * @throws {ItdAbortError} если запрос отменён через `signal`
+     * @throws {ItdNetworkError} если запрос не дошёл до сервера
+     */
+    request<T = unknown>(options: RawRequestOptions): Promise<T>;
+}
+
+/**
+ * Страница списка — единая форма для всех трёх схем пагинации API.
+ *
+ * Какие необязательные поля заполнены, зависит от эндпоинта: у ленты это `nextCursor`,
+ * у подписчиков — `page` и `total`, у уведомлений — `nextOffset`. Обычно они не нужны:
+ * перебор берёт на себя {@link Paginator}.
+ */
+interface Page<T> {
+    /** Элементы страницы. */
+    items: T[];
+    /** Есть ли следующая страница. */
+    hasMore: boolean;
+    /**
+     * Курсор следующей страницы.
+     *
+     * Непрозрачен: у вкладки `popular` это номер страницы, у `following` — отметка времени.
+     * Передавайте его обратно как есть и не пытайтесь разобрать.
+     */
+    nextCursor?: string | null | undefined;
+    /** Номер текущей страницы при постраничной схеме. */
+    page?: number | undefined;
+    /** Запрошенный размер страницы. */
+    limit?: number | undefined;
+    /** Общее число элементов, если сервер его сообщил. */
+    total?: number | undefined;
+    /** Смещение для следующего запроса при схеме со смещением. */
+    nextOffset?: number | undefined;
+    /** Исходный ответ — на случай, если документация разошлась с реальностью. */
+    raw: unknown;
+}
+/** Схема пагинации эндпоинта. */
+declare const PaginationMode: Readonly<{
+    /** Следующая страница запрашивается непрозрачным курсором. */
+    readonly Cursor: "cursor";
+    /** Следующая страница запрашивается номером. */
+    readonly Page: "page";
+    /** Следующая страница запрашивается смещением от начала списка. */
+    readonly Offset: "offset";
+}>;
+type PaginationMode = (typeof PaginationMode)[keyof typeof PaginationMode];
+/** Применяет преобразование к элементам страницы, сохраняя сведения о пагинации. */
+declare function mapPage<T, R>(page: Page<T>, map: (item: T) => R): Page<R>;
+/** Позиция, с которой запрашивается очередная страница. */
+interface PageState {
+    cursor?: string | undefined;
+    page?: number | undefined;
+    offset?: number | undefined;
+}
+/** Настройки перебора страниц. */
+interface PaginatorOptions<T> {
+    mode: PaginationMode;
+    /** Загружает одну страницу для указанной позиции. */
+    load: (state: PageState) => Promise<Page<T>>;
+    /**
+     * С какой позиции начать. По умолчанию с начала списка.
+     *
+     * Нужно, чтобы перебор можно было продолжить с сохранённого курсора, а не только
+     * начать заново.
+     */
+    start?: PageState | undefined;
+    /**
+     * Предохранитель от бесконечного перебора. По умолчанию 1000.
+     *
+     * Сработает, только если сервер бесконечно сообщает `hasMore` — при нормальной работе
+     * перебор останавливается сам.
+     */
+    maxPages?: number | undefined;
+    /** Отмена перебора. */
+    signal?: AbortSignal | undefined;
+}
+/**
+ * Перебор страниц списка.
+ *
+ * Скрывает различия трёх схем пагинации: перебор элементов, страниц и сбор в массив
+ * выглядят одинаково независимо от эндпоинта.
+ *
+ * **Одноразовый.** Позиция хранится внутри, поэтому повторный перебор того же объекта
+ * ничего не вернёт: он продолжится с места, где закончился прошлый. Нужен второй проход —
+ * возьмите новый перебор у того же метода ресурса.
+ *
+ * @example Перебор элементов
+ * ```ts
+ * for await (const post of itd.posts.iterate({ tab: 'following' })) {
+ *   console.log(post.content);
+ * }
+ * ```
+ *
+ * @example Первые сто элементов
+ * ```ts
+ * const posts = await itd.posts.iterate({ tab: 'popular' }).collect(100);
+ * ```
+ *
+ * @example Постранично
+ * ```ts
+ * for await (const page of itd.users.followers('durov').pages()) {
+ *   console.log(page.items.length, 'из', page.total);
+ * }
+ * ```
+ */
+declare class Paginator<T> implements AsyncIterable<T> {
+    #private;
+    constructor(options: PaginatorOptions<T>);
+    /**
+     * Загружает следующую страницу.
+     *
+     * @returns страница либо `null`, если перебор закончен
+     */
+    next(): Promise<Page<T> | null>;
+    /**
+     * Перебирает страницы целиком.
+     *
+     * Полезно, когда нужны сведения о самой странице — например `total`.
+     */
+    pages(): AsyncGenerator<Page<T>, void, undefined>;
+    /** Перебирает элементы всех страниц подряд. */
+    [Symbol.asyncIterator](): AsyncGenerator<T, void, undefined>;
+    /**
+     * Собирает элементы в массив.
+     *
+     * @param max сколько элементов достаточно; без него перебираются все страницы
+     */
+    collect(max?: number): Promise<T[]>;
+}
+
+/** Параметры перебираемого списка: опции запроса плюс предел числа страниц. */
+interface ListParams extends RequestOptions {
+    /** Ограничение числа страниц при переборе. */
+    maxPages?: number | undefined;
+}
+/**
+ * Описание перебираемого эндпоинта.
+ *
+ * Одно место, где заданы путь, параметры запроса, чтение страницы и схема пагинации.
+ * {@link BaseResource.paginated} строит из него и разовую загрузку, и перебор.
+ *
+ * @typeParam T тип элемента списка
+ * @typeParam P тип параметров метода
+ */
+interface ListingSpec<T, P extends ListParams> {
+    /** Путь эндпоинта. */
+    path: (params: P) => string;
+    /** Параметры запроса без полей пагинации — их добавит перебор. */
+    query: (params: P) => QueryParams;
+    /** Читает страницу из ответа. Получает позицию — она нужна схеме со смещением. */
+    read: (body: unknown, state: PageState) => Page<T>;
+    /** Схема пагинации эндпоинта. */
+    mode: PaginationMode;
+    /** Начальная позиция, вычисленная из параметров (курсор, номер или смещение). */
+    start: (params: P) => PageState;
+}
+/** Пара методов, собранная из {@link ListingSpec}: разовая загрузка и перебор. */
+interface Listing<T, P extends ListParams> {
+    /** Загружает одну страницу с позиции, заданной параметрами. */
+    list(params: P): Promise<Page<T>>;
+    /** Перебирает страницы, сама подставляя позиции. */
+    iterate(params: P): Paginator<T>;
+}
+/** Общая основа всех групп методов клиента. */
+declare class BaseResource {
+    /** @internal */
+    protected readonly http: HttpClient;
+    constructor(http: HttpClient);
+    /**
+     * Переносит опции запроса в описание транспорта.
+     *
+     * Копируются только поля {@link REQUEST_OPTION_KEYS} и опции, заявленные плагинами:
+     * параметры методов наследуют {@link RequestOptions} и приносят с собой `limit`, `cursor`
+     * и прочее, чему в описании запроса делать нечего. Чужие опции плагинов библиотека
+     * не понимает, но обязана донести до обёрток нетронутыми.
+     */
+    protected requestOptions(options: RequestOptions | undefined): Partial<RequestOptions>;
+    /**
+     * Собирает перебор страниц.
+     *
+     * @param mode схема пагинации эндпоинта
+     * @param load загружает одну страницу для указанной позиции
+     * @param options `maxPages` и `signal`, а также `start` — позиция, с которой продолжить
+     */
+    protected paginate<T>(mode: PaginationMode, load: (state: PageState) => Promise<Page<T>>, options?: RequestOptions & {
+        maxPages?: number;
+        start?: PageState;
+    }): Paginator<T>;
+    /**
+     * Собирает пару «загрузка страницы + перебор» из одного описания.
+     *
+     * Путь, параметры запроса и разбор ответа задаются один раз; `list` и `iterate`
+     * строятся из них.
+     *
+     * @example
+     * ```ts
+     * #feed = this.paginated<Post, FeedParams>({
+     *   path: () => '/api/posts',
+     *   query: (p) => ({ tab: p.tab, limit: p.limit }),
+     *   start: (p) => (p.cursor ? { cursor: p.cursor } : {}),
+     *   read: (body) => readCursorPage<Post>(body, 'posts'),
+     *   mode: PaginationMode.Cursor,
+     * });
+     * ```
+     */
+    protected paginated<T, P extends ListParams>(spec: ListingSpec<T, P>): Listing<T, P>;
+}
+
+/** Учётные данные для входа. */
+interface Credentials {
+    email: string;
+    password: string;
+}
+/**
+ * Учётные данные вместе с токеном капчи.
+ *
+ * `turnstileToken` обязателен: без него сервер отвечает `VALIDATION_ERROR`, с недействительным —
+ * `TURNSTILE_VERIFICATION_FAILED`. Токен даёт виджет Cloudflare Turnstile с ключом
+ * {@link TURNSTILE_SITE_KEY}; он одноразовый и живёт несколько минут.
+ */
+interface CaptchaCredentials extends Credentials {
+    turnstileToken: string;
+}
+/** Запрос письма для сброса пароля. Капча обязательна, как и при входе. */
+interface ForgotPasswordInput {
+    email: string;
+    turnstileToken: string;
+}
+/**
+ * Установка нового пароля.
+ *
+ * Сброс идёт тем же потоком с кодом, что и вход: {@link AuthResource.forgotPassword} выдаёт
+ * `flowToken`, письмо приносит `otp`, и всё это вместе с новым паролем уходит сюда.
+ */
+interface ResetPasswordInput {
+    email: string;
+    otp: string;
+    flowToken: string;
+    newPassword: string;
+}
+/** Провайдер внешнего входа. */
+declare const OAuthProvider: Readonly<{
+    readonly Yandex: "yandex";
+    readonly Google: "google";
+}>;
+type OAuthProvider = (typeof OAuthProvider)[keyof typeof OAuthProvider];
+/** Чем закончился вход: сразу токеном или запросом кода подтверждения. */
+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;
+};
+/**
+ * Авторизация, сессии и пароли.
+ *
+ * Доступна как `itd.auth`.
+ */
+declare class AuthResource extends BaseResource {
+    #private;
+    constructor(http: HttpClient, deps: {
+        auth: AuthManager;
+    });
+    /**
+     * Регистрирует аккаунт и запускает подтверждение по коду.
+     *
+     * @returns `flowToken`, который нужно передать в {@link verifyOtp}
+     */
+    signUp(credentials: CaptchaCredentials, options?: RequestOptions): Promise<string>;
+    /**
+     * Выполняет вход.
+     *
+     * Если сервер потребовал код подтверждения, вернётся `status: 'otp_required'` —
+     * тогда продолжайте через {@link verifyOtp} либо воспользуйтесь {@link signInWithOtp}.
+     *
+     * При успешном входе токен сохраняется в клиенте автоматически.
+     *
+     * @param credentials email, пароль и обязательный токен капчи — см. {@link CaptchaCredentials}
+     */
+    signIn(credentials: CaptchaCredentials, options?: RequestOptions): Promise<SignInResult>;
+    /**
+     * Подтверждает вход кодом из письма.
+     *
+     * Полученный токен сохраняется в клиенте автоматически.
+     */
+    verifyOtp(input: Credentials & {
+        otp: string;
+        flowToken: string;
+    }, options?: RequestOptions): Promise<string>;
+    /** Отправляет код подтверждения повторно. */
+    resendOtp(input: {
+        email: string;
+        flowToken: string;
+    }, options?: RequestOptions): Promise<void>;
+    /**
+     * Полный вход с подтверждением по коду.
+     *
+     * Удобно для скриптов и ботов: код запрашивается функцией `getOtp`, а всё остальное
+     * библиотека делает сама.
+     *
+     * @example
+     * ```ts
+     * import { createInterface } from 'node:readline/promises';
+     *
+     * const rl = createInterface({ input: process.stdin, output: process.stdout });
+     *
+     * const token = await itd.auth.signInWithOtp({
+     *   email, password,
+     *   getOtp: () => rl.question('Код из письма: '),
+     * });
+     * ```
+     */
+    signInWithOtp(input: CaptchaCredentials & {
+        getOtp: () => string | Promise<string>;
+    }, options?: RequestOptions): Promise<string>;
+    /**
+     * Обновляет токен доступа.
+     *
+     * Параллельные вызовы объединяются в один сетевой запрос. При включённом `autoRefresh`
+     * вызывать вручную обычно не нужно.
+     */
+    refresh(): Promise<string>;
+    /**
+     * Есть ли признак живой сессии обновления.
+     *
+     * Проверяет cookie `is_auth`, которую сервер ставит рядом с refresh-токеном, а также
+     * refresh-токен, переданный строкой. Позволяет не дёргать API у неавторизованного
+     * пользователя. В браузере всегда `true`: cookie ведёт сама среда, и прочитать её
+     * из JS нельзя.
+     *
+     * Читает {@link TokenStorage}, поэтому результат верен и до первого запроса.
+     *
+     * @example
+     * ```ts
+     * if (await itd.auth.hasRefreshSession()) await itd.auth.refresh();
+     * else redirectToLogin();
+     * ```
+     */
+    hasRefreshSession(): Promise<boolean>;
+    /** Завершает текущую сессию на сервере и очищает локальную. */
+    logout(options?: RequestOptions): Promise<void>;
+    /**
+     * Завершает все сессии пользователя и очищает локальную.
+     *
+     * Собран из двух запросов, потому что единого эндпоинта на сервере нет:
+     * `POST /api/v1/auth/logout-all` отвечает `404`. Сначала отзываются все прочие сессии
+     * (`DELETE /api/v1/auth/sessions`), затем завершается текущая — в обратном порядке
+     * отзывать было бы уже нечем.
+     */
+    logoutAll(options?: RequestOptions): Promise<void>;
+    /** Забывает сессию локально, не обращаясь к серверу. */
+    signOut(): Promise<void>;
+    /**
+     * Запрашивает письмо с кодом для сброса пароля.
+     *
+     * @returns `flowToken`, который нужно передать в {@link resetPassword}
+     */
+    forgotPassword(input: ForgotPasswordInput, options?: RequestOptions): Promise<string>;
+    /**
+     * Устанавливает новый пароль по коду из письма.
+     *
+     * Сервер ждёт все четыре поля сразу — `email`, `otp`, `flowToken` и `newPassword`;
+     * при нехватке любого отвечает `422`.
+     */
+    resetPassword(input: ResetPasswordInput, options?: RequestOptions): Promise<void>;
+    /**
+     * Полный сброс пароля с кодом из письма.
+     *
+     * Тот же приём, что и {@link signInWithOtp}: код запрашивается функцией `getOtp`,
+     * остальное библиотека делает сама.
+     *
+     * @example
+     * ```ts
+     * await itd.auth.resetPasswordWithOtp({
+     *   email,
+     *   turnstileToken,
+     *   newPassword,
+     *   getOtp: () => rl.question('Код из письма: '),
+     * });
+     * ```
+     */
+    resetPasswordWithOtp(input: ForgotPasswordInput & {
+        newPassword: string;
+        getOtp: () => string | Promise<string>;
+    }, options?: RequestOptions): Promise<void>;
+    /**
+     * Меняет пароль. Требует действующей сессии.
+     *
+     * При неверном текущем пароле сервер отвечает `ACCOUNT_CURRENT_PASSWORD_INCORRECT`.
+     *
+     * @example
+     * ```ts
+     * await itd.auth.changePassword({ currentPassword, newPassword });
+     * ```
+     */
+    changePassword(input: {
+        currentPassword: string;
+        newPassword: string;
+    }, options?: RequestOptions): Promise<void>;
+    /**
+     * Возвращает адрес для входа через внешнего провайдера.
+     *
+     * Сам переход выполняет приложение: в браузере — редиректом, в приложении — открытием
+     * системного браузера.
+     *
+     * @example
+     * ```ts
+     * window.location.href = itd.auth.oauthUrl('yandex');
+     * ```
+     */
+    oauthUrl(provider: OAuthProvider): string;
+    /** Загружает список активных сессий. У текущей поле `isCurrent` равно `true`. */
+    sessions(options?: RequestOptions): Promise<Session[]>;
+    /** Завершает указанную сессию. */
+    revokeSession(sessionId: string, options?: RequestOptions): Promise<void>;
+    /** Завершает все сессии, кроме текущей. */
+    revokeOtherSessions(options?: RequestOptions): Promise<void>;
+}
+
+/** Параметры запроса ответов на комментарий. */
+interface RepliesParams extends RequestOptions {
+    limit?: number;
+    page?: number;
+    maxPages?: number;
+}
+/**
+ * Комментарии и ответы на них.
+ *
+ * Доступна как `itd.comments`. Комментарии **к посту** живут в `itd.posts`:
+ * `itd.posts.comments()` и `itd.posts.comment()`.
+ */
+declare class CommentsResource extends BaseResource {
+    #private;
+    constructor(http: HttpClient, deps: {
+        uploadFiles: (files: FileInput[], options?: RequestOptions) => Promise<string[]>;
+    });
+    /**
+     * Загружает страницу ответов на комментарий.
+     *
+     * Здесь пагинация **постраничная**, в отличие от комментариев к посту, где курсорная.
+     */
+    replies(commentId: string, params?: RepliesParams): Promise<Page<Comment>>;
+    /** Перебирает ответы на комментарий. */
+    iterateReplies(commentId: string, params?: RepliesParams): Paginator<Comment>;
+    /**
+     * Отвечает на комментарий.
+     *
+     * @example
+     * ```ts
+     * await itd.comments.reply(commentId, 'согласен');
+     * await itd.comments.reply(commentId, (c) => c.content('и вот почему').replyTo(userId));
+     * ```
+     */
+    reply(commentId: string, input: CommentInput | string, options?: RequestOptions): Promise<Comment>;
+    /** Редактирует текст комментария. */
+    update(commentId: string, content: string, options?: RequestOptions): Promise<Comment>;
+    /** Удаляет комментарий. Восстановить его можно через {@link restore}. */
+    remove(commentId: string, options?: RequestOptions): Promise<void>;
+    /** Восстанавливает удалённый комментарий. */
+    restore(commentId: string, options?: RequestOptions): Promise<Comment>;
+    /** Ставит реакцию на комментарий. */
+    like(commentId: string, options?: RequestOptions): Promise<LikeResult>;
+    /** Убирает реакцию с комментария. */
+    unlike(commentId: string, options?: RequestOptions): Promise<LikeResult>;
+}
+
+/** Ответ загрузки файла. */
+interface UploadedFile {
+    /** Идентификатор вложения — его передают в `attachmentIds`. */
+    id: string;
+    /** Адрес файла на CDN. */
+    url: string;
+}
+/** Настройки загрузки. */
+interface UploadOptions extends RequestOptions {
+    /** Имя файла. По нему определяется тип, если он не задан явно. */
+    filename?: string;
+    /** MIME-тип. Если не указан, определяется по имени файла или по самому `Blob`. */
+    contentType?: string;
+    /**
+     * Проверять тип файла до отправки. По умолчанию `true`.
+     *
+     * Отключайте, если API начал принимать формат, которого ещё нет в списке библиотеки.
+     */
+    validateMime?: boolean;
+}
+/**
+ * Таймаут загрузки файла по умолчанию.
+ *
+ * Заметно больше обычного: видео на несколько десятков мегабайт не укладывается
+ * в стандартные 30 секунд, и запрос обрывался бы на середине.
+ */
+declare const DEFAULT_UPLOAD_TIMEOUT = 300000;
+/** Чтение файла по пути — подставляется точкой входа `itd-api/node`. */
+type FileReader = (path: string) => Promise<{
+    data: Uint8Array;
+    filename: string;
+}>;
+/**
+ * Файлы и медиа.
+ *
+ * Доступна как `itd.files`. Обычно вызывать её напрямую не нужно: `itd.posts.create()`
+ * и `itd.posts.comment()` загружают файлы сами.
+ */
+declare class FilesResource extends BaseResource {
+    #private;
+    /**
+     * @param deps.readFile чтение файлов с диска. Передаёт точка входа `itd-api/node`;
+     * в основном бандле его нет, чтобы браузерные сборщики не пытались разрешить `node:fs`.
+     */
+    constructor(http: HttpClient, deps?: {
+        readFile?: FileReader;
+    });
+    /**
+     * Загружает файл и возвращает его идентификатор.
+     *
+     * @remarks
+     * Кроме типа сервер проверяет и само изображение: слишком маленькие картинки
+     * он отклоняет сообщением «Не удалось проверить изображение». Точный порог
+     * неизвестен, но 64×64 проходит.
+     *
+     * @example
+     * ```ts
+     * const file = await itd.files.upload(blob, { filename: 'photo.jpg' });
+     * await itd.posts.create({ content: 'смотрите', attachmentIds: [file.id] });
+     * ```
+     */
+    upload(input: FileInput, options?: UploadOptions): Promise<UploadedFile>;
+    /**
+     * Загружает несколько файлов, сохраняя порядок.
+     *
+     * Файлы отправляются последовательно: параллельная загрузка нескольких видео легко
+     * упирается в ограничение частоты, а порядок вложений в посте важен.
+     *
+     * @returns идентификаторы вложений в том же порядке, что и входные файлы
+     */
+    uploadMany(files: FileInput[], options?: UploadOptions): Promise<string[]>;
+    /**
+     * Загружает сведения о файле.
+     *
+     * @remarks
+     * Сервер отвечает `404` даже на только что загруженный файл, который ещё никуда
+     * не прикреплён, — проверено на боевом API. Практической пользы у метода пока нет,
+     * он оставлен для полноты.
+     */
+    get(fileId: string, options?: RequestOptions): Promise<unknown>;
+    /** Удаляет загруженный файл. */
+    remove(fileId: string, options?: RequestOptions): Promise<void>;
+}
+
+/** Параметры запроса постов по хэштегу. */
+interface HashtagPostsParams extends RequestOptions {
+    limit?: number;
+    cursor?: string;
+    maxPages?: number;
+}
+/**
+ * Хэштеги.
+ *
+ * Доступна как `itd.hashtags`.
+ */
+declare class HashtagsResource extends BaseResource {
+    #private;
+    /**
+     * Ищет хэштеги.
+     *
+     * Без строки запроса возвращает общий список.
+     */
+    search(query?: string, params?: {
+        limit?: number;
+    } & RequestOptions): Promise<Hashtag[]>;
+    /** Загружает трендовые хэштеги. */
+    trending(params?: {
+        limit?: number;
+    } & RequestOptions): Promise<Hashtag[]>;
+    /**
+     * Загружает страницу постов по хэштегу.
+     *
+     * @param tag название без решётки; кодируется автоматически, поэтому кириллица
+     * и пробелы допустимы
+     */
+    posts(tag: string, params?: HashtagPostsParams): Promise<Page<Post>>;
+    /** Перебирает посты по хэштегу. */
+    iteratePosts(tag: string, params?: HashtagPostsParams): Paginator<Post>;
+}
+
+/** Параметры запроса списка уведомлений. */
+interface NotificationListParams extends RequestOptions {
+    limit?: number;
+    /** Смещение от начала списка. */
+    offset?: number;
+    maxPages?: number;
+}
+/** Изменяемые настройки уведомлений. */
+type UpdateNotificationSettingsInput = Partial<NotificationSettings>;
+/**
+ * Уведомления: список, счётчик, отметки о прочтении, настройки.
+ *
+ * Доступна как `itd.notifications`. Все уведомления приведены к единой форме, поэтому
+ * объекты отсюда и из потока событий можно складывать в один список.
+ */
+declare class NotificationsResource extends BaseResource {
+    #private;
+    /**
+     * Загружает страницу уведомлений.
+     *
+     * Пагинация здесь основана на смещении.
+     *
+     * @example
+     * ```ts
+     * const page = await itd.notifications.list({ limit: 20 });
+     * const next = await itd.notifications.list({ limit: 20, offset: page.nextOffset });
+     * ```
+     */
+    list(params?: NotificationListParams): Promise<Page<Notification>>;
+    /**
+     * Перебирает уведомления.
+     *
+     * @example
+     * ```ts
+     * for await (const notification of itd.notifications.iterate()) {
+     *   console.log(formatNotificationText(notification));
+     * }
+     * ```
+     */
+    iterate(params?: NotificationListParams): Paginator<Notification>;
+    /** Загружает число непрочитанных уведомлений. */
+    count(options?: RequestOptions): Promise<number>;
+    /**
+     * Отмечает уведомление прочитанным.
+     *
+     * @returns сколько записей отметил сервер
+     */
+    markRead(notificationId: string, options?: RequestOptions): Promise<number>;
+    /**
+     * Отмечает прочитанными сразу несколько уведомлений.
+     *
+     * Список автоматически режется на части по 20 идентификаторов — столько же отправляет
+     * сайт итд.com, поэтому на сервере вероятен предел. Части уходят последовательно,
+     * результат суммируется.
+     *
+     * @returns сколько записей отметил сервер суммарно
+     */
+    markReadBatch(ids: string[], options?: RequestOptions): Promise<number>;
+    /** Отмечает прочитанными все уведомления. */
+    markAllRead(options?: RequestOptions): Promise<number>;
+    /** Загружает настройки уведомлений. */
+    getSettings(options?: RequestOptions): Promise<NotificationSettings>;
+    /**
+     * Обновляет настройки уведомлений.
+     *
+     * Отправляются только изменяемые поля, в том же виде, в каком сервер их возвращает.
+     */
+    updateSettings(input: UpdateNotificationSettingsInput, options?: RequestOptions): Promise<NotificationSettings>;
+}
+
+/**
+ * Сведения о платформе: изменения, анонсы, баннер события.
+ *
+ * Доступна как `itd.platform`.
+ */
+declare class PlatformResource extends BaseResource {
+    /** Загружает журнал изменений. */
+    changelog(options?: RequestOptions): Promise<ChangelogEntry[]>;
+    /** Загружает анонсы платформы. */
+    announcements(options?: RequestOptions): Promise<Announcement[]>;
+    /** Загружает баннер текущего события — виджет «портал». */
+    portal(options?: RequestOptions): Promise<Portal>;
+    /**
+     * Загружает состояние сервисов платформы за последние 90 суток.
+     *
+     * Идёт на хост `статус.итд.com` без авторизации. Ответ кэшируется сервером на минуту.
+     * История по суткам приходит разреженной, ровный массив даёт `statusDays`.
+     *
+     * @example
+     * ```ts
+     * const status = await itd.platform.status();
+     *
+     * if (status.overall_status !== 'operational') {
+     *   const broken = status.services.filter((s) => s.current_status !== 'operational');
+     *   console.log('лежит:', broken.map((s) => s.name).join(', '));
+     * }
+     * ```
+     */
+    status(options?: RequestOptions): Promise<PlatformStatus>;
+}
+
+/** Параметры запроса ленты. */
+interface FeedParams extends RequestOptions {
+    /** Вкладка ленты. По умолчанию сервер отдаёт популярное. */
+    tab?: FeedTab;
+    /** Сколько постов на страницу. */
+    limit?: number;
+    /**
+     * Курсор следующей страницы из предыдущего ответа.
+     *
+     * Передавайте значение как есть: его формат зависит от вкладки и может измениться.
+     */
+    cursor?: string;
+    /** Ограничение числа страниц при переборе. */
+    maxPages?: number;
+}
+/** Параметры запроса постов пользователя. */
+interface UserPostsParams extends RequestOptions {
+    limit?: number;
+    cursor?: string;
+    /** Порядок сортировки. */
+    sort?: string;
+    /** Закреплённый пост, чтобы сервер поднял его наверх. */
+    pinnedPostId?: string;
+    maxPages?: number;
+}
+/** Параметры запроса комментариев к посту. */
+interface CommentsParams extends RequestOptions {
+    limit?: number;
+    /**
+     * Курсор следующей страницы: идентификатор последнего полученного комментария.
+     *
+     * Передавайте значение из `nextCursor` предыдущего ответа как есть.
+     */
+    cursor?: string;
+    sort?: CommentSort;
+    maxPages?: number;
+}
+/**
+ * Посты: лента, публикация, реакции, репосты, комментарии.
+ *
+ * Доступна как `itd.posts`.
+ */
+declare class PostsResource extends BaseResource {
+    #private;
+    constructor(http: HttpClient, deps: {
+        uploadFiles: (files: FileInput[], options?: RequestOptions) => Promise<string[]>;
+    });
+    /**
+     * Загружает страницу ленты.
+     *
+     * @example
+     * ```ts
+     * const page = await itd.posts.list({ tab: FeedTab.Following, limit: 20 });
+     * const next = await itd.posts.list({ tab: FeedTab.Following, cursor: page.nextCursor ?? undefined });
+     * ```
+     */
+    list(params?: FeedParams): Promise<Page<Post>>;
+    /**
+     * Перебирает ленту, сама подставляя курсоры.
+     *
+     * @example
+     * ```ts
+     * for await (const post of itd.posts.iterate({ tab: 'following' })) {
+     *   console.log(post.author.username, post.content);
+     * }
+     * ```
+     */
+    iterate(params?: FeedParams): Paginator<Post>;
+    /**
+     * Публикует пост.
+     *
+     * Принимает обычный объект, {@link PostBuilder} или функцию-настройщик. Файлы из поля
+     * `files` загружаются автоматически, порядок вложений сохраняется.
+     *
+     * @example
+     * ```ts
+     * await itd.posts.create({ content: 'привет' });
+     * await itd.posts.create((p) => p.content('привет').attach('./photo.jpg'));
+     * ```
+     */
+    create(input: PostInput, options?: RequestOptions): Promise<Post>;
+    /**
+     * Загружает один пост вместе с топовыми комментариями.
+     *
+     * В отличие от списков, здесь у поста заполнено поле `comments`.
+     */
+    get(postId: string, options?: RequestOptions): Promise<Post>;
+    /** Редактирует текст поста. */
+    update(postId: string, input: Pick<CreatePostInput, 'content' | 'spans'>, options?: RequestOptions): Promise<Post>;
+    /** Удаляет пост. Восстановить его можно через {@link restore}. */
+    remove(postId: string, options?: RequestOptions): Promise<void>;
+    /** Восстанавливает удалённый пост. */
+    restore(postId: string, options?: RequestOptions): Promise<Post>;
+    /** Ставит реакцию на пост. */
+    like(postId: string, options?: RequestOptions): Promise<LikeResult>;
+    /** Убирает реакцию с поста. */
+    unlike(postId: string, options?: RequestOptions): Promise<LikeResult>;
+    /**
+     * Делает репост с необязательным комментарием.
+     *
+     * Вложения к репосту не поддерживаются: сервер их игнорирует, поэтому параметров
+     * для файлов здесь нет.
+     */
+    repost(postId: string, content?: string, options?: RequestOptions): Promise<Post>;
+    /** Отменяет репост. */
+    unrepost(postId: string, options?: RequestOptions): Promise<void>;
+    /** Закрепляет пост в профиле. */
+    pin(postId: string, options?: RequestOptions): Promise<PinPostResult>;
+    /** Открепляет пост. */
+    unpin(postId: string, options?: RequestOptions): Promise<PinPostResult>;
+    /**
+     * Голосует в опросе.
+     *
+     * @param optionIds выбранные варианты; несколько допустимы только при `multipleChoice`
+     */
+    vote(postId: string, optionIds: string[], options?: RequestOptions): Promise<Poll>;
+    /** Запрашивает счётчики сразу для нескольких постов. */
+    stats(ids: string[], options?: RequestOptions): Promise<PostStats[]>;
+    /**
+     * Загружает страницу стены пользователя.
+     *
+     * Это **не только его собственные посты**: сюда попадают и записи, которые другие
+     * оставили на его стене — у них `author` чужой, а `wallRecipient` указывает на владельца
+     * стены. Поэтому число записей обычно больше, чем `postsCount` из профиля; чтобы
+     * получить только авторские посты, отфильтруйте по `post.author.id`.
+     *
+     * Принимает и UUID, и имя пользователя.
+     */
+    byUser(user: UserRef, params?: UserPostsParams): Promise<Page<Post>>;
+    /** Перебирает стену пользователя. Что именно в неё входит — см. {@link byUser}. */
+    iterateByUser(user: UserRef, params?: UserPostsParams): Paginator<Post>;
+    /** Загружает страницу постов, которые пользователь отметил реакцией. */
+    likedByUser(user: UserRef, params?: UserPostsParams): Promise<Page<Post>>;
+    /** Перебирает посты, которые пользователь отметил реакцией. */
+    iterateLikedByUser(user: UserRef, params?: UserPostsParams): Paginator<Post>;
+    /**
+     * Загружает страницу комментариев к посту.
+     *
+     * У этого эндпоинта курсор и признак продолжения лежат рядом со списком, а не внутри
+     * объекта `pagination`, как у остальных, — разница скрыта внутри.
+     */
+    comments(postId: string, params?: CommentsParams): Promise<Page<Comment>>;
+    /** Перебирает комментарии к посту. */
+    iterateComments(postId: string, params?: CommentsParams): Paginator<Comment>;
+    /**
+     * Комментирует пост.
+     *
+     * @example
+     * ```ts
+     * await itd.posts.comment(postId, 'согласен');
+     * await itd.posts.comment(postId, (c) => c.content('смотри').attach('./meme.png'));
+     * ```
+     */
+    comment(postId: string, input: CommentInput | string, options?: RequestOptions): Promise<Comment>;
+    /**
+     * Отправляет голосовой комментарий.
+     *
+     * Текста у такого комментария нет: сервер ждёт пустой `content` и одно аудиовложение
+     * в формате `audio/ogg`.
+     *
+     * @example
+     * ```ts
+     * await itd.posts.voiceComment(postId, './answer.ogg');
+     * ```
+     */
+    voiceComment(postId: string, audio: FileInput, options?: RequestOptions): Promise<Comment>;
+}
+
+/**
+ * Жалобы на контент и пользователей.
+ *
+ * Доступна как `itd.reports`.
+ */
+declare class ReportsResource extends BaseResource {
+    /**
+     * Отправляет жалобу.
+     *
+     * Повторная жалоба на тот же объект отклоняется сервером с сообщением
+     * «Вы уже отправляли жалобу на этот контент».
+     *
+     * @example
+     * ```ts
+     * await itd.reports.create(report.post(postId).reason('spam'));
+     * await itd.reports.create({ targetType: 'user', targetId, reason: 'fraud' });
+     * ```
+     */
+    create(input: ReportInput, options?: RequestOptions): Promise<Report>;
+}
+
+/** Результат глобального поиска. */
+interface SearchResult {
+    users: UserSummary[];
+    hashtags: Hashtag[];
+}
+/**
+ * Глобальный поиск.
+ *
+ * Доступна как `itd.search`.
+ */
+declare class SearchResource extends BaseResource {
+    /**
+     * Ищет пользователей и хэштеги одним запросом.
+     *
+     * @example
+     * ```ts
+     * const { users, hashtags } = await itd.search.all('арт');
+     * ```
+     */
+    all(query: string, options?: RequestOptions): Promise<SearchResult>;
+}
+
+/**
+ * Подписка и способы оплаты.
+ *
+ * Доступна как `itd.subscription`.
+ */
+declare class SubscriptionResource extends BaseResource {
+    /** Загружает состояние подписки и её цену. */
+    status(options?: RequestOptions): Promise<Subscription>;
+    /**
+     * Запускает оплату подписки.
+     *
+     * Форма ответа в документации API не описана, поэтому тип результата не уточняется.
+     */
+    pay(options?: RequestOptions): Promise<unknown>;
+    /** Включает или отключает автопродление. */
+    setAutoRenewal(enabled: boolean, options?: RequestOptions): Promise<unknown>;
+    /** Запускает привязку карты. */
+    bindCard(options?: RequestOptions): Promise<unknown>;
+    /** Загружает список способов оплаты. Пустой массив, если карт нет. */
+    methods(options?: RequestOptions): Promise<PaymentMethod[]>;
+    /** Делает способ оплаты основным. */
+    setDefaultMethod(methodId: string, options?: RequestOptions): Promise<unknown>;
+    /** Удаляет способ оплаты. */
+    removeMethod(methodId: string, options?: RequestOptions): Promise<void>;
+}
+
+/**
+ * Общие опции запроса телеметрии.
+ *
+ * Помимо {@link RequestOptions} позволяет задать `sid` — идентификатор сессии телеметрии.
+ * По умолчанию он заводится один на объект {@link TelemetryResource}.
+ */
+interface TelemetryOptions extends RequestOptions {
+    /** Переопределяет идентификатор сессии телеметрии (`sid`) для этого запроса. */
+    sid?: string;
+}
+/**
+ * Событие просмотра поста для {@link TelemetryResource.dwell}.
+ *
+ * Пост определяется меткой показа `vs` и, при наличии, контекстом источника `sc`; поля
+ * `postId` эндпоинт `/api/v1/i` не принимает.
+ */
+interface DwellEntry {
+    /** Метка показа — поле `vs` объекта поста. Уходит в поле `v`. */
+    vs: string;
+    /** Время появления поста в зоне видимости, epoch-мс. Поле `et`. */
+    enterAt: number;
+    /** Время ухода из зоны видимости, epoch-мс. Поле `xt`. */
+    exitAt: number;
+    /** Причина завершения просмотра. Поле `r`. */
+    reason: ViewReason;
+    /**
+     * Длительность просмотра в мс. Поле `md`.
+     *
+     * Если не задано, вычисляется как `exitAt − enterAt`.
+     */
+    durationMs?: number;
+    /** Контекст источника показа. Поле `sc`. */
+    sourceContext?: string;
+    /** Источник показа. Применим к `PostPage`/`Link`. Поле `s`. */
+    source?: ViewSource;
+    /** Повторный просмотр: пост уже встречался в этой сессии. Уходит как `b: 1`. */
+    repeat?: boolean;
+}
+/** Событие взаимодействия с контентом для {@link TelemetryResource.interaction}. */
+interface InteractionEntry {
+    /** Тип взаимодействия. Поле `t`. */
+    type: InteractionType;
+    /** Метка показа — поле `vs` объекта поста. Поле `v`. */
+    vs: string;
+    /** Идентификатор поста. Поле `ai`. */
+    postId: string;
+    /** Индекс вложения (с нуля) — для `InteractionType.PhotoOpen` ({@link InteractionType}). Поле `mi`. */
+    mediaIndex?: number;
+    /** Источник показа. Поле `s`. */
+    source?: ViewSource;
+    /** Просмотрено мс — для `InteractionType.VideoProgress` ({@link InteractionType}). Поле `pm`. */
+    positionMs?: number;
+    /** Длительность видео в мс — для `InteractionType.VideoProgress` ({@link InteractionType}). Поле `dm`. */
+    durationMs?: number;
+}
+/**
+ * Телеметрия просмотров.
+ *
+ * @experimental Недокументированные эндпоинты `/api/v1/i` (просмотры) и `/api/v1/x`
+ * (взаимодействия); формат полей может измениться без предупреждения.
+ *
+ * Методы не вызываются автоматически — телеметрия отправляется только явным вызовом.
+ *
+ * Оба эндпоинта принимают конверт `{ sid, e }`, где `sid` — идентификатор сессии
+ * телеметрии: по умолчанию один на объект, переопределяется опцией `sid`.
+ *
+ * Доступна как `itd.telemetry`.
+ */
+declare class TelemetryResource extends BaseResource {
+    #private;
+    /**
+     * Идентификатор сессии телеметрии (`sid`).
+     *
+     * Создаётся лениво при первом обращении и далее неизменен.
+     */
+    get sessionId(): string;
+    /**
+     * Отправляет события просмотра постов (`POST /api/v1/i`).
+     *
+     * @experimental См. предупреждение у {@link TelemetryResource}.
+     */
+    dwell(entries: DwellEntry[], options?: TelemetryOptions): Promise<unknown>;
+    /**
+     * Отправляет события взаимодействия с контентом (`POST /api/v1/x`).
+     *
+     * @experimental См. предупреждение у {@link TelemetryResource}.
+     */
+    interaction(entries: InteractionEntry[], options?: TelemetryOptions): Promise<unknown>;
+}
+
+/**
+ * Параметры списков пользователей.
+ *
+ * ⚠️ Списки подписчиков, подписок и заблокированных на сервере **не листаются**:
+ * `page` он игнорирует, а `limit` зажимает на 20. Подробности — в {@link UsersResource.followers}.
+ */
+interface UserListParams extends RequestOptions {
+    /** Сколько записей вернуть. Значения больше 20 сервер молча уменьшает до 20. */
+    limit?: number;
+    /** Номер страницы. Сервер его игнорирует — оставлен на случай, если пагинацию починят. */
+    page?: number;
+    maxPages?: number;
+}
+/** Изменяемые поля своего профиля. */
+interface UpdateProfileInput {
+    displayName?: string;
+    username?: string;
+    /** Эмодзи-аватар: символ клана, а не адрес картинки. */
+    avatar?: string;
+    bio?: string;
+    /** Адрес изображения-шапки. */
+    banner?: string;
+}
+/** Изменяемые настройки приватности. */
+type UpdatePrivacyInput = Partial<PrivacySettings>;
+/**
+ * Пользователи: профили, подписки, блокировки, приватность.
+ *
+ * Доступна как `itd.users`.
+ */
+declare class UsersResource extends BaseResource {
+    #private;
+    /** Загружает свой профиль — с подпиской и признаком подтверждённого телефона. */
+    me(options?: RequestOptions): Promise<MyProfile>;
+    /** Обновляет свой профиль. Передавайте только изменяемые поля. */
+    updateMe(input: UpdateProfileInput, options?: RequestOptions): Promise<MyProfile>;
+    /** Деактивирует аккаунт. Вернуть его можно через {@link restore}. */
+    deactivate(options?: RequestOptions): Promise<void>;
+    /** Восстанавливает деактивированный аккаунт. */
+    restore(options?: RequestOptions): Promise<void>;
+    /** Создаёт профиль после регистрации. */
+    createProfile(input: {
+        username: string;
+        displayName: string;
+        avatar?: string;
+    }, options?: RequestOptions): Promise<MyProfile>;
+    /**
+     * Загружает профиль пользователя.
+     *
+     * @param user UUID **или** имя пользователя — подходит и то, и другое
+     *
+     * @example
+     * ```ts
+     * const profile = await itd.users.get('durov');
+     * await itd.posts.create({ content: 'привет', wallRecipientId: profile.id });
+     * ```
+     */
+    get(user: UserRef, options?: RequestOptions): Promise<PublicProfile>;
+    /** Проверяет, свободно ли имя пользователя. */
+    checkUsername(username: string, options?: RequestOptions): Promise<boolean>;
+    /** Ищет пользователей по строке запроса. */
+    search(query: string, params?: {
+        limit?: number;
+    } & RequestOptions): Promise<UserSummary[]>;
+    /** Загружает рекомендации, на кого подписаться. */
+    whoToFollow(options?: RequestOptions): Promise<UserSummary[]>;
+    /** Загружает рейтинг кланов. */
+    topClans(options?: RequestOptions): Promise<Clan[]>;
+    /**
+     * Подписывается на пользователя.
+     *
+     * У закрытого профиля вместо подписки отправляется заявка — это видно по полю `status`.
+     */
+    follow(user: UserRef, options?: RequestOptions): Promise<FollowResult>;
+    /** Отписывается от пользователя. */
+    unfollow(user: UserRef, options?: RequestOptions): Promise<void>;
+    /**
+     * Загружает подписчиков пользователя.
+     *
+     * ⚠️ **Сервер этот список не листает.** Возвращаются первые 20 записей и только они:
+     * параметр `page` игнорируется (любая страница отдаёт те же записи и `pagination.page: 1`),
+     * `limit` больше 20 молча уменьшается, а `hasMore` всегда `false`. Последнее честно —
+     * получить продолжение нечем.
+     *
+     * Числу `total` доверять тоже не стоит: оно расходится с `followersCount` из профиля —
+     * на проверенных аккаунтах занижено примерно на 1–4%.
+     */
+    followers(user: UserRef, params?: UserListParams): Promise<Page<UserSummary>>;
+    /**
+     * Перебирает подписчиков.
+     *
+     * ⚠️ Перебор закончится после первых 20 записей: сервер список не листает —
+     * см. {@link followers}. Метод оставлен на случай, если пагинацию починят.
+     */
+    iterateFollowers(user: UserRef, params?: UserListParams): Paginator<UserSummary>;
+    /** Загружает подписки пользователя. Ограничения те же, что у {@link followers}. */
+    following(user: UserRef, params?: UserListParams): Promise<Page<UserSummary>>;
+    /** Перебирает подписки. Закончится после первых 20 записей — см. {@link followers}. */
+    iterateFollowing(user: UserRef, params?: UserListParams): Paginator<UserSummary>;
+    /**
+     * Проверяет, подписаны ли вы, сразу для нескольких пользователей.
+     *
+     * @returns объект «идентификатор пользователя → подписаны ли вы»
+     *
+     * @example
+     * ```ts
+     * const statuses = await itd.users.followStatus([userA, userB]);
+     * // { 'b89dee4f-…': true, '35ea3059-…': false }
+     * ```
+     */
+    followStatus(userIds: UserId[], options?: RequestOptions): Promise<Record<string, boolean>>;
+    /** Блокирует пользователя. */
+    block(user: UserRef, options?: RequestOptions): Promise<void>;
+    /** Снимает блокировку. */
+    unblock(user: UserRef, options?: RequestOptions): Promise<void>;
+    /** Загружает заблокированных пользователей. Ограничения те же, что у {@link followers}. */
+    blocked(params?: UserListParams): Promise<Page<UserSummary>>;
+    /** Перебирает заблокированных. Закончится после первых 20 записей — см. {@link followers}. */
+    iterateBlocked(params?: UserListParams): Paginator<UserSummary>;
+    /** Загружает настройки приватности. */
+    getPrivacy(options?: RequestOptions): Promise<PrivacySettings>;
+    /** Обновляет настройки приватности. Передавайте только изменяемые поля. */
+    updatePrivacy(input: UpdatePrivacyInput, options?: RequestOptions): Promise<PrivacySettings>;
+    /**
+     * Загружает значки профиля и выбранный из них.
+     *
+     * `activePin` — строка-идентификатор, а не объект.
+     */
+    pins(options?: RequestOptions): Promise<PinsResult>;
+    /** Выбирает активный значок профиля. */
+    setPin(slug: string, options?: RequestOptions): Promise<void>;
+    /** Снимает активный значок. */
+    removePin(options?: RequestOptions): Promise<void>;
+}
+
+/**
+ * Верификация профиля.
+ *
+ * Доступна как `itd.verification`.
+ */
+declare class VerificationResource extends BaseResource {
+    /** Загружает статус заявки. Значение `none` означает, что заявка не подавалась. */
+    status(options?: RequestOptions): Promise<VerificationStatus>;
+    /** Подаёт заявку на верификацию с видео. */
+    submit(videoUrl: string, options?: RequestOptions): Promise<unknown>;
+}
+
+declare global {
+    interface SymbolConstructor {
+        readonly asyncDispose: unique symbol;
+    }
+}
+/**
+ * Скрытые параметры конструктора — не часть публичного API.
+ *
+ * Через них точка входа `itd-api/node` передаёт чтение файлов с диска, не мутируя уже
+ * созданный объект.
+ *
+ * @internal
+ */
+interface ItdClientInternals {
+    fileReader?: FileReader | undefined;
+}
+/**
+ * Клиент API итд.com.
+ *
+ * Методы сгруппированы по разделам: `itd.posts`, `itd.users`, `itd.comments`, `itd.auth`,
+ * `itd.files`. Авторизация, обновление токена, повторы и очередь запросов работают сами.
+ *
+ * @example Готовый токен — для разового вызова
+ * ```ts
+ * const itd = new ItdClient({ auth: '<accessToken>' });
+ * const me = await itd.users.me();
+ * ```
+ *
+ * @example Полноценная сессия для бота
+ * ```ts
+ * import { ItdClient } from 'itd-api';
+ * import { FileTokenStorage } from 'itd-api/node';
+ *
+ * const itd = new ItdClient({
+ *   // `auth` не обязателен: когда хранилище уже содержит сессию, токен берётся оттуда,
+ *   // а истёкший продлевается сам. Здесь он нужен на первый запуск.
+ *   // Вход по паролю требует токена капчи — см. AuthInput и TURNSTILE_SITE_KEY.
+ *   auth: { email, password, getTurnstileToken },
+ *   storage: new FileTokenStorage('./.itd-session.json'),
+ *   rateLimit: { concurrency: 4, rps: 8 },
+ * });
+ *
+ * for await (const post of itd.posts.iterate({ tab: 'following' })) {
+ *   if (!post.isLiked) await itd.posts.like(post.id);
+ * }
+ * ```
+ */
+declare class ItdClient {
+    #private;
+    /** Авторизация, сессии и пароли. */
+    readonly auth: AuthResource;
+    /** Профили, подписки, блокировки, приватность. */
+    readonly users: UsersResource;
+    /** Лента, публикация, реакции, репосты, комментарии к постам. */
+    readonly posts: PostsResource;
+    /** Ответы на комментарии и действия над ними. */
+    readonly comments: CommentsResource;
+    /** Загрузка файлов и медиа. */
+    readonly files: FilesResource;
+    /** Уведомления: список, счётчик, отметки о прочтении, настройки. */
+    readonly notifications: NotificationsResource;
+    /** Хэштеги и посты по ним. */
+    readonly hashtags: HashtagsResource;
+    /** Глобальный поиск по пользователям и хэштегам. */
+    readonly search: SearchResource;
+    /** Жалобы на контент и пользователей. */
+    readonly reports: ReportsResource;
+    /** Верификация профиля. */
+    readonly verification: VerificationResource;
+    /** Подписка и способы оплаты. */
+    readonly subscription: SubscriptionResource;
+    /** Сведения о платформе: изменения, анонсы, баннер события. */
+    readonly platform: PlatformResource;
+    /**
+     * Телеметрия просмотров.
+     *
+     * @experimental Недокументированные эндпоинты. Библиотека никогда не отправляет их сама.
+     */
+    readonly telemetry: TelemetryResource;
+    constructor(options?: ItdClientOptions, internals?: ItdClientInternals);
+    /** Базовый URL, к которому обращается клиент. */
+    get baseUrl(): string;
+    /**
+     * Выполняет произвольный запрос к API.
+     *
+     * Запасной путь для случаев, когда нужного метода ещё нет или ответ сервера разошёлся
+     * с документацией. Проходит через ту же авторизацию, очередь и обработку ошибок.
+     *
+     * @example
+     * ```ts
+     * const raw = await itd.request({ method: 'GET', path: '/api/posts', raw: true });
+     * ```
+     */
+    request<T = unknown>(options: RawRequestOptions): Promise<T>;
+    /**
+     * Подключает плагин.
+     *
+     * Плагин работает на уровне транспорта: видит запрос до отправки и разобранный ответ,
+     * поэтому одна обёртка охватывает сразу все методы клиента. Подключать можно в любой
+     * момент, но обычно это делают сразу после создания клиента.
+     *
+     * @throws {ItdConfigError} если плагин задан неверно или уже подключён
+     *
+     * @example
+     * ```ts
+     * import { crypt } from '@itd-api/crypto';
+     *
+     * itd.use(crypt());
+     * await itd.posts.create({ content: 'секрет' }, { encrypt: 'invis' });
+     * ```
+     */
+    use(plugin: ItdPlugin): this;
+    /**
+     * Регистрирует сервис платформы — домен, отличный от основного.
+     *
+     * Запросы с `{ service: 'имя' }` уходят на его хост с его заголовками. То же самое умеет
+     * опция `services` конструктора. Занятое имя не переопределяется — ни своё, ни встроенное:
+     * разовому запросу хост задаётся полем `baseUrl`.
+     *
+     * Заголовок авторизации по умолчанию уходит только своим — домену клиента и его
+     * поддоменам. Стороннему хосту токен нужно разрешить явно: `auth: true`.
+     *
+     * @throws {ItdConfigError} если определение неверно или имя уже занято
+     *
+     * @example Сервис платформы на поддомене — токен уходит сам
+     * ```ts
+     * itd.defineService({
+     *   name: 'pb',
+     *   baseUrl: 'https://pbapi.xn--d1ah4a.com',
+     *   headers: { Referer: 'https://pixel.xn--d1ah4a.com/' },
+     * });
+     *
+     * await itd.request({ method: 'GET', service: 'pb', path: '/api/pixel-info' });
+     * ```
+     */
+    defineService(definition: ServiceDefinition): this;
+    /**
+     * Базовый URL зарегистрированного сервиса.
+     *
+     * @throws {ItdConfigError} если сервис не зарегистрирован
+     */
+    serviceBaseUrl(name: string): string;
+    /**
+     * Подписывается на события авторизации.
+     *
+     * Полезно, чтобы сохранять сессию во внешнее хранилище или узнавать, что вход
+     * окончательно потерян.
+     *
+     * @returns функция отписки
+     *
+     * @example
+     * ```ts
+     * itd.on('tokens', ({ accessToken }) => cache.set('itd', accessToken));
+     * itd.on('authError', () => notifyUser('Сессия истекла, войдите заново'));
+     * ```
+     */
+    on<K extends keyof AuthEvents>(event: K, listener: Listener<AuthEvents[K]>): Unsubscribe;
+    /**
+     * Создаёт поток уведомлений в реальном времени.
+     *
+     * Каждый вызов даёт новый независимый поток; обычно он нужен один на приложение.
+     * Соединение поднимается методом `connect()` и держится само.
+     *
+     * @example
+     * ```ts
+     * const stream = itd.realtime();
+     *
+     * stream.on('notification', ({ notification }) => {
+     *   console.log(formatNotificationText(notification));
+     * });
+     * stream.on('unreadCount', (count) => setBadge(count));
+     *
+     * await stream.connect();
+     * ```
+     */
+    realtime(options?: RealtimeOptions): ItdRealtime;
+    /**
+     * Освобождает ресурсы клиента: останавливает очередь запросов (снимает отложенные паузы)
+     * и закрывает все потоки уведомлений, созданные через {@link realtime}.
+     *
+     * После вызова клиентом можно пользоваться снова — новые запросы поднимут всё заново,
+     * но уже созданные потоки останутся закрытыми.
+     *
+     * @example
+     * ```ts
+     * await using itd = new ItdClient({ auth: token });
+     * // …работа…
+     * // close() вызовется сам на выходе из блока
+     * ```
+     */
+    close(): Promise<void>;
+    /** Позволяет использовать клиент с `await using`. */
+    [Symbol.asyncDispose](): Promise<void>;
+    /** Текущая сессия целиком — чтобы сохранить её самостоятельно. */
+    getSession(): Promise<ItdSession | null>;
+    /** Восстанавливает сохранённую сессию, включая cookie. */
+    setSession(session: ItdSession): Promise<void>;
+}
+/**
+ * Создаёт клиент API итд.com.
+ *
+ * То же, что `new ItdClient(options)`, — для тех, кому привычнее фабрика.
+ *
+ * @example
+ * ```ts
+ * const itd = createClient({ auth: token });
+ * ```
+ */
+declare function createClient(options?: ItdClientOptions): ItdClient;
+
+/** Бренд, по которому ошибки библиотеки распознаются надёжнее, чем через `instanceof`. */
+declare const ITD_ERROR: unique symbol;
+/**
+ * Категория ошибки. Определяет, какие поля у неё есть.
+ *
+ * Значение, а не только тип: категорию нужно с чем-то сравнивать в рантайме.
+ */
+declare const ItdErrorKind: Readonly<{
+    /** Сервер ответил статусом ≥ 400. */
+    readonly Api: "api";
+    /** Запрос не дошёл до сервера. */
+    readonly Network: "network";
+    /** Истёк таймаут запроса. */
+    readonly Timeout: "timeout";
+    /** Запрос отменён через `AbortSignal`. */
+    readonly Abort: "abort";
+    /** Некорректная конфигурация или аргументы — обнаружено до обращения к сети. */
+    readonly Config: "config";
+}>;
+type ItdErrorKind = (typeof ItdErrorKind)[keyof typeof ItdErrorKind];
+/**
+ * Разновидность ошибки API — то же, что класс ошибки, но в виде данных.
+ *
+ * Существует потому, что `instanceof` подводит, когда в дереве зависимостей оказались
+ * две копии пакета или смешаны сборки ESM и CJS: классы тогда разные, хотя ошибка та же.
+ * Проверки {@link isItdValidationError} и соседние опираются на это поле, а не на класс.
+ */
+declare const ItdApiErrorKind: Readonly<{
+    /** Ни одна из специализаций не подошла. */
+    readonly Generic: "generic";
+    readonly Validation: "validation";
+    readonly Auth: "auth";
+    readonly Forbidden: "forbidden";
+    readonly NotFound: "not_found";
+    readonly Conflict: "conflict";
+    readonly RateLimit: "rate_limit";
+    readonly PhoneVerification: "phone_verification";
+    readonly Server: "server";
+}>;
+type ItdApiErrorKind = (typeof ItdApiErrorKind)[keyof typeof ItdApiErrorKind];
+/** Ошибки по полям формы: `{ email: ['уже занят'] }`. */
+type ItdFieldErrors = Record<string, string[]>;
+/**
+ * Базовый класс всех ошибок библиотеки.
+ *
+ * Ловить его имеет смысл, чтобы отделить проблемы обращения к итд.com от прочих исключений.
+ * Для разбора конкретной причины используйте {@link isItdApiError} и поле {@link ItdApiError.code}.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await itd.posts.like(id);
+ * } catch (e) {
+ *   if (isItdError(e)) console.error('итд.com:', e.message);
+ *   else throw e;
+ * }
+ * ```
+ */
+declare class ItdError extends Error {
+    /** @internal */
+    readonly [ITD_ERROR]: true;
+    /** Категория ошибки. */
+    readonly kind: ItdErrorKind;
+    constructor(kind: ItdErrorKind, message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** Параметры конструктора {@link ItdApiError}. */
+interface ItdApiErrorInit {
+    /** HTTP-статус ответа. */
+    status: number;
+    /** Строковый код ошибки из тела ответа. */
+    code: ItdErrorCode;
+    /** Человекочитаемое сообщение. */
+    message: string;
+    /** Расширенное описание, если сервер его прислал. */
+    detail?: string | undefined;
+    /** Заголовок ошибки, если сервер его прислал. */
+    title?: string | undefined;
+    /** Ошибки по конкретным полям (сведены из `errors` и `violations`). */
+    fieldErrors?: ItdFieldErrors | undefined;
+    /** Идентификатор запроса из заголовков ответа, если есть. */
+    requestId?: string | undefined;
+    /** HTTP-метод запроса. */
+    method: string;
+    /** Путь запроса без базового URL. */
+    path: string;
+    /** Тело ответа как оно пришло — на случай, если документация разошлась с реальностью. */
+    raw: unknown;
+    /** Сам объект ответа. Тело уже прочитано. */
+    response?: Response | undefined;
+    /** Значение `Retry-After` в миллисекундах, если заголовок был. */
+    retryAfter?: number | undefined;
+    /** Сколько запросов разрешено в окне (`x-ratelimit-limit`). */
+    rateLimit?: number | undefined;
+    /** Сколько запросов осталось в окне (`x-ratelimit-remaining`). */
+    rateLimitRemaining?: number | undefined;
+}
+/**
+ * Ошибка, возвращённая сервером итд.com (HTTP-статус ≥ 400).
+ *
+ * API отдаёт ошибки в двух разных формах — `{ error: { … } }` и `{ code, message, violations }`.
+ * Библиотека сводит обе к этому классу, поэтому разбирать форму ответа вручную не нужно.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await itd.users.updateMe({ username: 'занятое_имя' });
+ * } catch (e) {
+ *   if (e instanceof ItdValidationError) {
+ *     console.log(e.fieldErrors.username); // ['Имя уже занято']
+ *   }
+ * }
+ * ```
+ */
+declare class ItdApiError extends ItdError {
+    /**
+     * Разновидность ошибки: та же информация, что и класс, но пригодная для сравнения.
+     *
+     * Позволяет разбирать ошибку через `switch`, а проверкам вроде {@link isItdAuthError} —
+     * работать даже когда в проекте оказались две копии библиотеки.
+     */
+    readonly apiKind: ItdApiErrorKind;
+    /** HTTP-статус ответа. */
+    readonly status: number;
+    /** Строковый код ошибки, например `VALIDATION_ERROR`. */
+    readonly code: ItdErrorCode;
+    /** Расширенное описание, если сервер его прислал. */
+    readonly detail: string | undefined;
+    /** Заголовок ошибки, если сервер его прислал. */
+    readonly title: string | undefined;
+    /** Ошибки по полям. Пустой объект, если сервер их не прислал. */
+    readonly fieldErrors: ItdFieldErrors;
+    /** Идентификатор запроса из заголовков ответа. */
+    readonly requestId: string | undefined;
+    /** HTTP-метод запроса. */
+    readonly method: string;
+    /** Путь запроса без базового URL. */
+    readonly path: string;
+    /** Тело ответа как оно пришло. */
+    readonly raw: unknown;
+    /** Объект ответа. Тело уже прочитано и повторно прочитано быть не может. */
+    readonly response: Response | undefined;
+    /** Пауза из заголовка `Retry-After` в миллисекундах. Сервер итд.com его не присылает. */
+    readonly retryAfter: number | undefined;
+    /**
+     * Сколько запросов разрешено в окне — заголовок `x-ratelimit-limit`.
+     *
+     * Времени сброса окна сервер не сообщает, поэтому точный момент повтора неизвестен.
+     */
+    readonly rateLimit: number | undefined;
+    /** Сколько запросов осталось в окне — заголовок `x-ratelimit-remaining`. */
+    readonly rateLimitRemaining: number | undefined;
+    /**
+     * @param apiKind разновидность; подставляется подклассами, снаружи задавать не нужно
+     */
+    constructor(init: ItdApiErrorInit, apiKind?: ItdApiErrorKind);
+    /**
+     * Проверяет код ошибки. Удобнее, чем сравнивать строки вручную.
+     *
+     * @example
+     * ```ts
+     * if (err.hasCode('OTP_INVALID', 'MISSING_FLOW_TOKEN')) await restartOtpFlow();
+     * ```
+     */
+    hasCode(...codes: ItdErrorCode[]): boolean;
+    /** Имеет ли смысл повторить запрос: `429` и серверные ошибки `5xx`. */
+    get isRetryable(): boolean;
+}
+/** `400` / `422` — данные не прошли валидацию. Подробности в {@link ItdApiError.fieldErrors}. */
+declare class ItdValidationError extends ItdApiError {
+    constructor(init: ItdApiErrorInit);
+}
+/** `401` — токен отсутствует, истёк или отозван. */
+declare class ItdAuthError extends ItdApiError {
+    constructor(init: ItdApiErrorInit);
+}
+/** `403` — доступ запрещён либо действие ограничено настройками приватности. */
+declare class ItdForbiddenError extends ItdApiError {
+    constructor(init: ItdApiErrorInit);
+}
+/** `404` — сущность не найдена. */
+declare class ItdNotFoundError extends ItdApiError {
+    constructor(init: ItdApiErrorInit);
+}
+/** `409` — сущность уже существует. */
+declare class ItdConflictError extends ItdApiError {
+    constructor(init: ItdApiErrorInit);
+}
+/**
+ * `429` — превышен лимит запросов.
+ *
+ * Если сервер прислал `Retry-After`, пауза доступна в {@link ItdApiError.retryAfter}
+ * (в миллисекундах). При включённых ретраях библиотека выдерживает её автоматически.
+ */
+declare class ItdRateLimitError extends ItdApiError {
+    constructor(init: ItdApiErrorInit);
+}
+/**
+ * Действие требует подтверждённого телефона (`PHONE_VERIFICATION_REQUIRED`).
+ *
+ * Подтверждение проходит через Telegram-бота: ссылка лежит в {@link verificationUrl}.
+ */
+declare class ItdPhoneVerificationError extends ItdApiError {
+    /** Ссылка на бота подтверждения, если удалось определить идентификатор пользователя. */
+    readonly verificationUrl: string | undefined;
+    constructor(init: ItdApiErrorInit & {
+        userId?: string | undefined;
+    });
+}
+/** `5xx` — ошибка на стороне сервера. */
+declare class ItdServerError extends ItdApiError {
+    constructor(init: ItdApiErrorInit);
+}
+/** Запрос не дошёл до сервера: DNS, обрыв соединения, отсутствие сети. */
+declare class ItdNetworkError extends ItdError {
+    /** HTTP-метод запроса. */
+    readonly method: string;
+    /** Путь запроса без базового URL. */
+    readonly path: string;
+    constructor(message: string, init: {
+        method: string;
+        path: string;
+        cause?: unknown;
+    });
+}
+/** Истёк таймаут запроса, заданный опцией `timeout`. */
+declare class ItdTimeoutError extends ItdError {
+    /** Значение таймаута в миллисекундах. */
+    readonly timeout: number;
+    /** HTTP-метод запроса. */
+    readonly method: string;
+    /** Путь запроса без базового URL. */
+    readonly path: string;
+    constructor(init: {
+        timeout: number;
+        method: string;
+        path: string;
+    });
+}
+/** Запрос отменён через переданный `AbortSignal`. */
+declare class ItdAbortError extends ItdError {
+    constructor(message?: string);
+}
+/**
+ * Некорректная конфигурация или аргументы — обнаружено до обращения к сети.
+ *
+ * Этим же классом сообщают о нарушенных инвариантах билдеры: например, опрос
+ * с одним вариантом ответа.
+ */
+declare class ItdConfigError extends ItdError {
+    constructor(message: string);
+}
+/** Любая ошибка, порождённая этой библиотекой. */
+declare function isItdError(value: unknown): value is ItdError;
+/** Ошибка, пришедшая от сервера итд.com (статус ≥ 400). */
+declare function isItdApiError(value: unknown): value is ItdApiError;
+/** Ошибка валидации: `VALIDATION_ERROR` либо статус `400`/`422`. */
+declare function isItdValidationError(value: unknown): value is ItdValidationError;
+/** Ошибка авторизации: истёкший или отозванный токен. */
+declare function isItdAuthError(value: unknown): value is ItdAuthError;
+/** Доступ запрещён либо действие ограничено настройками приватности. */
+declare function isItdForbiddenError(value: unknown): value is ItdForbiddenError;
+/** Сущность не найдена. */
+declare function isItdNotFoundError(value: unknown): value is ItdNotFoundError;
+/** Сущность уже существует. */
+declare function isItdConflictError(value: unknown): value is ItdConflictError;
+/** Превышен лимит запросов. */
+declare function isItdRateLimitError(value: unknown): value is ItdRateLimitError;
+/** Действие требует подтверждённого телефона. Ссылка — в `verificationUrl`. */
+declare function isItdPhoneVerificationError(value: unknown): value is ItdPhoneVerificationError;
+/** Ошибка на стороне сервера (`5xx`). */
+declare function isItdServerError(value: unknown): value is ItdServerError;
+
+/** Изображения, которые принимает `POST /api/files/upload`. */
+declare const IMAGE_MIME_TYPES: readonly ["image/jpeg", "image/png", "image/gif", "image/webp", "image/avif", "image/heic", "image/heif"];
+type ImageMimeType = (typeof IMAGE_MIME_TYPES)[number];
+/** Видео, которые принимает `POST /api/files/upload`. */
+declare const VIDEO_MIME_TYPES: readonly ["video/mp4", "video/webm", "video/quicktime"];
+type VideoMimeType = (typeof VIDEO_MIME_TYPES)[number];
+/** Аудио для голосовых комментариев. */
+declare const AUDIO_MIME_TYPES: readonly ["audio/ogg"];
+type AudioMimeType = (typeof AUDIO_MIME_TYPES)[number];
+/** Все типы, которые принимает загрузка. */
+declare const ALLOWED_MIME_TYPES: readonly ["image/jpeg", "image/png", "image/gif", "image/webp", "image/avif", "image/heic", "image/heif", "video/mp4", "video/webm", "video/quicktime", "audio/ogg"];
+type AllowedMimeType = (typeof ALLOWED_MIME_TYPES)[number];
+
+/**
+ * Приводит отметку времени без часового пояса к ISO-8601, считая её временем UTC.
+ *
+ * Строку другого вида возвращает нетронутой.
+ *
+ * @example
+ * ```ts
+ * utcStampToIso('2026-07-23 23:14:25');  // '2026-07-23T23:14:25Z'
+ * utcStampToIso('2026-07-23T23:14:25Z'); // без изменений
+ * ```
+ */
+declare function utcStampToIso(value: string): string;
+
+/**
+ * Собирает текст уведомления на русском.
+ *
+ * Повторяет формулировки сайта итд.com. Для неизвестного типа возвращает
+ * «Новое уведомление» — библиотека не выдумывает текст, которого нет.
+ *
+ * @example
+ * ```ts
+ * formatNotificationText(notification);
+ * // 'Аня и ещё 2 оценили ваш пост'
+ * ```
+ */
+declare function formatNotificationText(notification: Notification): string;
+
+/**
+ * Соответствие коротких имён типов уведомлений развёрнутым.
+ *
+ * Сервер — и в списке, и в потоке событий — присылает короткие имена: `like`, `comment`,
+ * `reply`, `repost`, `comment_like`. Развёрнутые (`post_reaction`, `post_comment`)
+ * встречаются в оформлении интерфейса, поэтому библиотека приводит типы к ним:
+ * они однозначно называют и объект, и действие.
+ *
+ * Пришедшее значение всегда остаётся в поле `rawType`.
+ */
+declare const NOTIFICATION_TYPE_ALIASES: Readonly<Record<string, NotificationType>>;
+/**
+ * Приводит имя типа к каноническому.
+ *
+ * Неизвестное значение возвращается без изменений. Официальный клиент в этом случае
+ * подставляет `follow`, из-за чего новое уведомление выглядит как подписка, — здесь
+ * такого не происходит.
+ *
+ * @example
+ * ```ts
+ * canonicalNotificationType('like');           // 'post_reaction'
+ * canonicalNotificationType('post_reaction');  // 'post_reaction'
+ * canonicalNotificationType('новое_событие');  // 'новое_событие'
+ * ```
+ */
+declare function canonicalNotificationType(rawType: string): NotificationType;
+/**
+ * Известен ли библиотеке этот тип уведомления.
+ *
+ * Полезно, чтобы решить, показывать ли уведомление, для которого нет своего оформления.
+ */
+declare function isKnownNotificationType(type: string): boolean;
+
+/**
+ * Вычисляет адрес, на который ведёт уведомление.
+ *
+ * Возвращает путь внутри сайта — без домена, чтобы его можно было передать роутеру
+ * приложения. Поле `clickUrl` от сервера используется только как запасной вариант:
+ * вычисленный путь точнее, поскольку учитывает родительский пост у комментариев.
+ *
+ * @example
+ * ```ts
+ * const url = resolveNotificationUrl(notification);
+ * // '/@durov/post/9f1c…?comment=2b7e…'
+ * ```
+ */
+declare function resolveNotificationUrl(notification: Notification): string;
+
+/** Настройки опроса. */
+interface PollTransportOptions {
+    /** Как часто опрашивать сервер, мс. По умолчанию 15 000. */
+    interval?: number;
+    /** Сколько уведомлений запрашивать за раз. По умолчанию 20. */
+    limit?: number;
+}
+
+/** Путь потока уведомлений. */
+declare const STREAM_PATH = "/api/notifications/stream";
+/** Настройки SSE-транспорта. */
+interface SseTransportOptions {
+    /**
+     * Сколько миллисекунд ждать данных, прежде чем считать соединение мёртвым.
+     *
+     * Сервер не присылает keep-alive, а оборванное TCP-соединение может не закрыться
+     * само — без этой проверки поток «тихо умирает» и новых уведомлений не приходит.
+     * По умолчанию 90 000. `0` отключает проверку.
+     */
+    idleTimeout?: number;
+}
+
+export { ALLOWED_MIME_TYPES, AUDIO_MIME_TYPES, AUTH_FLAG_COOKIE, AUTH_PATHS, AccessType, type Actor, type AllowedMimeType, type Announcement, type AnnouncementButton, type Attachment, AttachmentType, type AudioMimeType, type AuthEvents, type AuthInput, AuthResource, type Author, BUILT_IN_SERVICES, type BuilderInput, type CaptchaCredentials, type ChangelogEntry, type Clan, type ClientHooks, type Comment, CommentBuilder, type CommentInput, type CommentReplyTo, CommentSort, type CommentsParams, CommentsResource, type CreateCommentInput, type CreatePollInput, type CreatePostInput, type CreateReportInput, type Credentials, type CredentialsAuth, DEFAULT_BASE_URL, DEFAULT_STATUS_BASE_URL, DEFAULT_TIMEOUT, DEFAULT_UPLOAD_TIMEOUT, DEFAULT_USER_AGENT, DEVICE_ID_HEADER, DetectedRuntime, type DwellEntry, type ErrorContextHook, type FeedParams, FeedTab, type FileInput, type FileReader, FilesResource, type FollowResult, type ForgotPasswordInput, type Hashtag, type HashtagPostsParams, HashtagsResource, IMAGE_MIME_TYPES, type ImageMimeType, IncidentKind, type InteractionEntry, InteractionType, type IsoDate, ItdAbortError, ItdApiError, type ItdApiErrorInit, ItdApiErrorKind, ItdAuthError, type ItdBuilder, ItdClient, type ItdClientOptions, ItdConfigError, ItdConflictError, ItdError, ItdErrorCode, ItdErrorKind, type ItdFieldErrors, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdPhoneVerificationError, type ItdPlugin, ItdRateLimitError, ItdRealtime, ItdServerError, type ItdSession, ItdTimeoutError, ItdValidationError, LIBRARY_VERSION, type LikeResult, LikesVisibility, type Listener, LocalStorageTokenStorage, type Logger, type Loose, MAX_RECONNECT_ATTEMPTS, MemoryTokenStorage, type MyProfile, NOTIFICATION_TYPE_ALIASES, type Notification, type NotificationEvent, type NotificationListParams, type NotificationSettings, NotificationType, NotificationsResource, OAuthProvider, type Page, type PageState, PaginationMode, Paginator, type PaginatorOptions, type PaymentMethod, type Pin, type PinPostResult, type PinsResult, PlatformResource, type PlatformStatus, type PluginContext, type Poll, PollBuilder, type PollInput, type PollOption, type PollTransportOptions, type Portal, type Post, PostBuilder, type PostInput, type PostStats, PostsResource, type PrivacySettings, type Profile, type PublicProfile, type QueryParams, type QueryValue, RECONNECT_BACKOFF, RECONNECT_JITTER, REFRESH_COOKIE, REFRESH_COOKIE_PATH, REQUEST_OPTION_KEYS, type RateLimitOptions, type RawRequestOptions, type RealtimeDeps, type RealtimeEvents, type RealtimeOptions, RealtimeStatus, type RealtimeTransport, RealtimeTransportKind, type ReconnectOptions, type RepliesParams, type Report, ReportBuilder, type ReportInput, ReportReason, ReportTargetType, ReportsResource, type RequestContext, type RequestOptions, type ResetPasswordInput, type ResponseContext, type RetryContext, type RetryOptions, RuntimeMode, STATUS_SERVICE, STREAM_PATH, SearchResource, type SearchResult, type ServiceDefinition, ServiceRegistry, ServiceState, type ServiceStatus, type Session, type SignInResult, SignInStatus, type Span, SpanType, type SseTransportOptions, type StatusDay, type StatusIncidentLine, type Subscription, SubscriptionResource, type SubscriptionState, TURNSTILE_SITE_KEY, type TelemetryOptions, TelemetryResource, type TokenStorage, type Transformer, type TransportContext, type TransportEvent, UnauthorizedStreamError, type Unsubscribe, type UpdateNotificationSettingsInput, type UpdatePrivacyInput, type UpdateProfileInput, type UploadOptions, type UploadedFile, type UserId, type UserListParams, type UserPostsParams, type UserRef, type UserSummary, UsersResource, VIDEO_MIME_TYPES, VerificationResource, type VerificationStatus, type VideoMimeType, ViewReason, ViewSource, WallAccess, canonicalNotificationType, comment, createClient, createTokenStorage, formatNotificationText, isBuilder, isItdApiError, isItdAuthError, isItdConflictError, isItdError, isItdForbiddenError, isItdNotFoundError, isItdPhoneVerificationError, isItdRateLimitError, isItdServerError, isItdValidationError, isKnownNotificationType, isMyProfile, mapPage, normalizeNotification, poll, post, readNotificationEvent, readUnreadCountEvent, report, resolveNotificationUrl, statusDays, toDate, utcStampToIso };