itd-api 0.0.1

package/dist/index-RzyK1gKg.d.cts

@@ -0,0 +1,3238 @@
+/** Метка билдера. Через `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];
+/** На что подаётся жалоба. */
+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 WallAccess: Readonly<{
+    readonly Everyone: "everyone";
+}>;
+type WallAccess = Loose<(typeof WallAccess)[keyof typeof WallAccess]>;
+/** Кто видит реакции пользователя. Список в документации неполный. */
+declare const LikesVisibility: Readonly<{
+    readonly Everyone: "everyone";
+    /** Только взаимные подписки. */
+    readonly Mutual: "mutual";
+}>;
+type LikesVisibility = Loose<(typeof LikesVisibility)[keyof typeof LikesVisibility]>;
+/**
+ * Канонический тип уведомления (новое поколение имён).
+ *
+ * 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]>;
+/**
+ * Строковые коды ошибок из поля `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";
+    readonly CAPTCHA_FAILED: "CAPTCHA_FAILED";
+    readonly OTP_INVALID: "OTP_INVALID";
+    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";
+    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 {
+    /** Тип фрагмента: `hashtag`, `mention`, `link` и другие. */
+    type: Loose<'hashtag' | 'mention' | 'link'>;
+    /** Смещение от начала текста. */
+    offset: number;
+    /** Длина фрагмента. */
+    length: number;
+    /** Содержимое: имя хэштега без решётки, имя пользователя, адрес ссылки. */
+    tag?: 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;
+}
+/** Статус заявки на верификацию. `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;
+
+/**
+ * Билдер опроса.
+ *
+ * Неизменяемый: каждый вызов возвращает новый экземпляр, поэтому заготовку можно
+ * переиспользовать, не боясь её испортить. Создаётся функцией {@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` — определяется по среде исполнения (значение по умолчанию).
+ */
+type RuntimeMode = 'auto' | 'browser' | 'server';
+
+/**
+ * Сохранённая сессия.
+ *
+ * Кроме токенов сюда попадают 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;
+    /** Когда сессия получена, мс с начала эпохи. Нужно для диагностики. */
+    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>;
+
+/**
+ * Как клиент получает доступ к API.
+ *
+ * Поддерживаются четыре формы — от разового вызова с готовым токеном до полноценной
+ * сессии, которую библиотека заводит и продлевает сама.
+ *
+ * @example
+ * ```ts
+ * new ItdClient({ auth: '<accessToken>' });                    // разовый вызов
+ * new ItdClient({ auth: { accessToken, refreshToken } });      // восстановить сессию
+ * new ItdClient({ auth: { email, password } });                // залогиниться самому
+ * new ItdClient({ auth: { getToken: () => vault.read() } });   // токен из внешнего источника
+ * ```
+ */
+type AuthInput = string | {
+    accessToken: string;
+    refreshToken?: string | undefined;
+} | {
+    email: string;
+    password: string;
+} | {
+    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;
+    /** Авторизация. Без неё доступны только публичные эндпоинты. */
+    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;
+    /** Как обращаться с cookie. По умолчанию определяется по среде исполнения. */
+    mode?: RuntimeMode | undefined;
+}
+/** Опции отдельного запроса. Доступны в каждом методе ресурсов. */
+interface RequestOptions {
+    /** Отмена запроса извне. */
+    signal?: AbortSignal | undefined;
+    /** Таймаут только для этого запроса, мс. */
+    timeout?: number | undefined;
+    /** Дополнительные заголовки. */
+    headers?: Record<string, string> | undefined;
+    /** Повторы только для этого запроса. */
+    retry?: RetryOptions | false | undefined;
+}
+/** Полное описание запроса для низкоуровневого `itd.request()`. */
+interface RawRequestOptions extends RequestOptions {
+    method: string;
+    /** Путь с ведущим слэшем, например `/api/posts`. Завершающий слэш значим. */
+    path: string;
+    query?: QueryParams | undefined;
+    /** Тело: будет отправлено как JSON. Для загрузки файлов передайте `FormData`. */
+    body?: unknown;
+    /** Не подставлять заголовок авторизации. */
+    skipAuth?: boolean | undefined;
+    /** Не пытаться обновить токен при `401` — используется самими эндпоинтами авторизации. */
+    skipAuthRefresh?: boolean | undefined;
+    /** Вернуть тело ответа без снятия обёртки `{ data: … }`. */
+    raw?: boolean | undefined;
+}
+
+/** Базовый URL API итд.com. Домен записан в punycode: `итд.com`. */
+declare const DEFAULT_BASE_URL = "https://xn--d1ah4a.com";
+/** Таймаут запроса по умолчанию. Столько же использует официальный клиент итд.com. */
+declare const DEFAULT_TIMEOUT = 30000;
+/**
+ * Настройки повторов со всеми значениями по умолчанию.
+ *
+ * Поля перечислены явно, а не через `Required<RetryOptions>`: тот снимает необязательность,
+ * но оставляет `| undefined` в типе значения, раз оно указано в исходном интерфейсе.
+ */
+interface ResolvedRetryOptions {
+    attempts: number;
+    baseDelay: number;
+    maxDelay: number;
+    jitter: number;
+    retryWrites: boolean;
+    shouldRetry: ((error: unknown, attempt: number) => boolean) | undefined;
+}
+/** Настройки очереди со всеми значениями по умолчанию. */
+interface ResolvedRateLimitOptions {
+    concurrency: number;
+    rps: number | undefined;
+    retryDelays: readonly number[];
+    respectHeaders: boolean;
+}
+/** Конфигурация клиента после подстановки значений по умолчанию и проверок. */
+interface ResolvedConfig {
+    baseUrl: string;
+    auth: AuthInput | undefined;
+    storage: TokenStorage;
+    autoRefresh: boolean;
+    reloginOnRefreshFailure: boolean;
+    fetch: typeof fetch;
+    timeout: number;
+    retry: ResolvedRetryOptions | undefined;
+    rateLimit: ResolvedRateLimitOptions | undefined;
+    hooks: ClientHooks;
+    logger: Logger | undefined;
+    headers: Record<string, string>;
+    mode: RuntimeMode;
+    /** Вести ли собственный cookie-jar (вне браузера и React Native). */
+    useCookieJar: boolean;
+    /** Отправлять ли `credentials: 'include'` (в браузере). */
+    sendCredentials: boolean;
+}
+
+/**
+ * Минимальное хранилище 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`. */
+    setFromStrings(url: string, setCookieStrings: string[]): void;
+    /**
+     * Собирает значение заголовка `Cookie` для запроса.
+     *
+     * @returns строка вида `a=1; b=2` либо `undefined`, если подходящих cookie нет
+     */
+    getHeader(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;
+/** Функция отписки, которую возвращает {@link Emitter.on}. */
+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;
+}
+
+/**
+ * Подключаемые части конвейера.
+ *
+ * Авторизация, cookie, очередь и повторы живут в отдельных модулях и подставляются сюда.
+ * Благодаря этому транспорт тестируется изолированно, а `HttpClient` ничего не знает
+ * о том, как именно добывается токен.
+ */
+interface HttpCollaborators {
+    /** Заголовки авторизации для запроса. Вызывается перед каждой попыткой. */
+    getAuthHeaders?(): Promise<Record<string, string>> | Record<string, string>;
+    /**
+     * Реакция на ответ `401`.
+     *
+     * Должна вернуть `true`, если токен обновлён и запрос имеет смысл повторить.
+     * Повтор выполняется ровно один раз.
+     */
+    onUnauthorized?(): Promise<boolean>;
+    /** Значение заголовка `Cookie` для указанного URL. */
+    getCookieHeader?(url: string): string | undefined;
+    /** Приём `Set-Cookie` из ответа. */
+    saveCookies?(url: string, response: Response): void;
+    /** Очередь запросов: ограничение конкурентности и частоты. */
+    schedule?<T>(task: () => Promise<T>): Promise<T>;
+    /**
+     * Сообщает об остатке лимита из заголовков ответа.
+     *
+     * Вызывается после **каждого** ответа, включая ошибочные, — так очередь узнаёт
+     * об исчерпании лимита заранее и успевает притормозить до отказа сервера.
+     */
+    onRateLimit?(limit: number | undefined, remaining: number | undefined): void;
+    /**
+     * Планировщик повторов.
+     *
+     * Возвращает паузу в мс перед следующей попыткой либо `undefined`, если повторять не нужно.
+     */
+    nextRetryDelay?(error: unknown, attempt: number, method: string): number | undefined;
+}
+/**
+ * Транспортный слой: единственное место, откуда библиотека ходит в сеть.
+ *
+ * Отвечает за сборку URL, заголовки, таймауты, разбор ответа и превращение любой неудачи
+ * в типизированную ошибку. Авторизация, cookie, очередь и повторы подключаются извне
+ * через {@link HttpCollaborators}.
+ */
+declare class HttpClient {
+    #private;
+    constructor(config: ResolvedConfig, collaborators?: HttpCollaborators);
+    /** Базовый URL, к которому обращается клиент. */
+    get baseUrl(): string;
+    /**
+     * Подключает недостающие части конвейера.
+     *
+     * Нужно из-за кольцевой зависимости: слой авторизации сам выполняет запросы, поэтому
+     * не может быть передан в конструктор до создания транспорта.
+     */
+    setCollaborators(collaborators: HttpCollaborators): void;
+    /**
+     * Выполняет запрос к API.
+     *
+     * @typeParam T ожидаемая форма ответа после снятия обёртки `{ data: … }`
+     * @throws {ItdApiError} если сервер ответил статусом ≥ 400
+     * @throws {ItdTimeoutError} если истёк таймаут
+     * @throws {ItdAbortError} если запрос отменён через `signal`
+     * @throws {ItdNetworkError} если запрос не дошёл до сервера
+     */
+    request<T = unknown>(options: RawRequestOptions): Promise<T>;
+}
+
+/** События слоя авторизации. */
+interface AuthEvents {
+    /** Токен получен или обновлён. */
+    tokens: {
+        accessToken: string;
+    };
+    /** Выполнен вход. */
+    signIn: {
+        accessToken: string;
+    };
+    /** Сессия очищена — вручную или из-за неудачного обновления. */
+    signOut: undefined;
+    /** Обновить сессию не удалось; дальнейшие запросы будут падать с 401. */
+    authError: {
+        error: unknown;
+    };
+}
+/**
+ * Хранит сессию и продлевает её.
+ *
+ * Главное здесь — **дедупликация обновления**. Когда десять параллельных запросов
+ * одновременно получают `401`, обновление должно произойти один раз, а остальные обязаны
+ * дождаться его результата. Иначе сервер увидит десять параллельных `refresh`, и все,
+ * кроме первого, скорее всего получат отказ по уже использованному токену.
+ */
+declare class AuthManager {
+    #private;
+    constructor(config: ResolvedConfig, http: HttpClient, jar: CookieJar);
+    /** Подписка на события авторизации. */
+    get on(): Emitter<AuthEvents>['on'];
+    /** Подписка на одно срабатывание. */
+    get once(): Emitter<AuthEvents>['once'];
+    /**
+     * Есть ли признак живой refresh-сессии.
+     *
+     * Сайт итд.com ставит рядом с refresh-токеном незакрытую cookie `is_auth` — по ней клиент
+     * понимает, что обновление вообще имеет смысл, и не дёргает API у анонимов.
+     * В браузере cookie ведёт сама среда, поэтому там ответ всегда `true`.
+     */
+    hasRefreshSession(): boolean;
+    /** Заголовки авторизации для очередного запроса. Пустой объект, если токена нет. */
+    getAuthHeaders(): Promise<Record<string, 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>;
+    /** Заменяет сессию целиком. */
+    setSession(session: ItdSession): Promise<void>;
+    /** Забывает сессию и cookie. Сетевой запрос не выполняется. */
+    clear(): Promise<void>;
+}
+
+/** Событие потока уведомлений после разбора. */
+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;
+    /** Текущий токен доступа. */
+    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>;
+}
+
+/** События потока уведомлений. */
+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;
+    };
+}
+/** Способ получения событий. */
+type RealtimeTransportKind = 'auto' | 'sse' | 'poll';
+/** Настройки потока уведомлений. */
+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;
+    getToken: () => Promise<string | null>;
+    /** Обновляет токен после отказа авторизации. Возвращает `true`, если удалось. */
+    refresh: () => Promise<boolean>;
+    /** Загружает начальное число непрочитанных. */
+    fetchUnreadCount: () => Promise<number>;
+    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;
+}
+
+/**
+ * Страница списка — единая форма для всех трёх схем пагинации 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;
+}
+/** Схема пагинации эндпоинта. */
+type PaginationMode = 'cursor' | 'page' | 'offset';
+/** Позиция, с которой запрашивается очередная страница. */
+interface PageState {
+    cursor?: string | undefined;
+    page?: number | undefined;
+    offset?: number | undefined;
+}
+/** Настройки перебора страниц. */
+interface PaginatorOptions<T> {
+    mode: PaginationMode;
+    /** Загружает одну страницу для указанной позиции. */
+    load: (state: PageState) => Promise<Page<T>>;
+    /**
+     * Предохранитель от бесконечного перебора. По умолчанию 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[]>;
+}
+
+/** Общая основа всех групп методов клиента. */
+declare class BaseResource {
+    /** @internal */
+    protected readonly http: HttpClient;
+    constructor(http: HttpClient);
+    /** Переносит общие поля опций запроса в параметры транспорта. */
+    protected requestOptions(options: RequestOptions | undefined): Partial<RequestOptions>;
+    /**
+     * Собирает перебор страниц.
+     *
+     * @param mode схема пагинации эндпоинта
+     * @param load загружает одну страницу для указанной позиции
+     */
+    protected paginate<T>(mode: PaginationMode, load: (state: PageState) => Promise<Page<T>>, options?: RequestOptions & {
+        maxPages?: number;
+    }): Paginator<T>;
+}
+
+/** Учётные данные для входа. */
+interface Credentials {
+    email: string;
+    password: string;
+}
+/**
+ * Результат входа.
+ *
+ * Сервер может как сразу выдать токен, так и потребовать код подтверждения — размеченное
+ * объединение делает оба случая явными.
+ */
+type SignInResult = {
+    status: 'authenticated';
+    accessToken: string;
+} | {
+    status: 'otp_required';
+    flowToken: string | undefined;
+};
+/** Провайдер внешнего входа. */
+type OAuthProvider = 'yandex' | 'google';
+/**
+ * Авторизация, сессии и пароли.
+ *
+ * Доступна как `itd.auth`.
+ */
+declare class AuthResource extends BaseResource {
+    #private;
+    constructor(http: HttpClient, deps: {
+        auth: AuthManager;
+    });
+    /**
+     * Регистрирует аккаунт и запускает подтверждение по коду.
+     *
+     * @returns `flowToken`, который нужно передать в {@link verifyOtp}
+     */
+    signUp(credentials: Credentials, options?: RequestOptions): Promise<string>;
+    /**
+     * Выполняет вход.
+     *
+     * Если сервер потребовал код подтверждения, вернётся `status: 'otp_required'` —
+     * тогда продолжайте через {@link verifyOtp} либо воспользуйтесь {@link signInWithOtp}.
+     *
+     * При успешном входе токен сохраняется в клиенте автоматически.
+     */
+    signIn(credentials: Credentials, 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: Credentials & {
+        getOtp: () => string | Promise<string>;
+    }, options?: RequestOptions): Promise<string>;
+    /**
+     * Обновляет токен доступа.
+     *
+     * Параллельные вызовы объединяются в один сетевой запрос. При включённом `autoRefresh`
+     * вызывать вручную обычно не нужно.
+     */
+    refresh(): Promise<string>;
+    /**
+     * Есть ли признак живой сессии обновления.
+     *
+     * Проверяет cookie `is_auth`, которую сервер ставит рядом с refresh-токеном. Позволяет
+     * не дёргать API у неавторизованного пользователя. В браузере всегда `true`:
+     * cookie ведёт сама среда, и прочитать её из JS нельзя.
+     */
+    hasRefreshSession(): boolean;
+    /** Завершает текущую сессию на сервере и очищает локальную. */
+    logout(options?: RequestOptions): Promise<void>;
+    /** Завершает все сессии пользователя и очищает локальную. */
+    logoutAll(options?: RequestOptions): Promise<void>;
+    /** Забывает сессию локально, не обращаясь к серверу. */
+    signOut(): Promise<void>;
+    /** Запрашивает письмо для сброса пароля. */
+    forgotPassword(email: string, options?: RequestOptions): Promise<void>;
+    /** Устанавливает новый пароль по токену из письма. */
+    resetPassword(input: {
+        token: string;
+        newPassword: string;
+    }, options?: RequestOptions): Promise<void>;
+    /** Меняет пароль. Требует действующей сессии обновления. */
+    changePassword(input: {
+        oldPassword: 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;
+}
+/** Чтение файла по пути — подставляется точкой входа `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;
+    constructor(http: HttpClient, deps?: {
+        readFile?: FileReader;
+    });
+    /**
+     * Подключает чтение файлов с диска.
+     *
+     * Вызывается точкой входа `itd-api/node`; в основном бандле работы с файловой
+     * системой нет, чтобы браузерные сборщики не пытались разрешить `node:fs`.
+     */
+    setFileReader(readFile: FileReader): void;
+    /**
+     * Загружает файл и возвращает его идентификатор.
+     *
+     * @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>;
+    /** Приводит любой поддерживаемый вход к `Blob` с именем и проверенным типом. */
+    private prepare;
+}
+
+/** Параметры запроса постов по хэштегу. */
+interface HashtagPostsParams extends RequestOptions {
+    limit?: number;
+    cursor?: string;
+    maxPages?: number;
+}
+/** Результат глобального поиска. */
+interface SearchResult {
+    users: UserSummary[];
+    hashtags: Hashtag[];
+}
+/**
+ * Хэштеги.
+ *
+ * Доступна как `itd.hashtags`.
+ */
+declare class HashtagsResource extends BaseResource {
+    /**
+     * Ищет хэштеги.
+     *
+     * Без строки запроса возвращает общий список.
+     */
+    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>;
+}
+/**
+ * Глобальный поиск.
+ *
+ * Доступна как `itd.search`.
+ */
+declare class SearchResource extends BaseResource {
+    /**
+     * Ищет пользователей и хэштеги одним запросом.
+     *
+     * @example
+     * ```ts
+     * const { users, hashtags } = await itd.search.all('арт');
+     * ```
+     */
+    all(query: string, options?: RequestOptions): Promise<SearchResult>;
+}
+/**
+ * Жалобы на контент и пользователей.
+ *
+ * Доступна как `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>;
+}
+/**
+ * Верификация профиля.
+ *
+ * Доступна как `itd.verification`.
+ */
+declare class VerificationResource extends BaseResource {
+    /** Загружает статус заявки. Значение `none` означает, что заявка не подавалась. */
+    status(options?: RequestOptions): Promise<VerificationStatus>;
+    /** Подаёт заявку на верификацию с видео. */
+    submit(videoUrl: string, options?: RequestOptions): Promise<unknown>;
+}
+/**
+ * Подписка и способы оплаты.
+ *
+ * Доступна как `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>;
+}
+/**
+ * Сведения о платформе: изменения, анонсы, баннер события.
+ *
+ * Доступна как `itd.platform`.
+ */
+declare class PlatformResource extends BaseResource {
+    /** Загружает журнал изменений. */
+    changelog(options?: RequestOptions): Promise<ChangelogEntry[]>;
+    /** Загружает анонсы платформы. */
+    announcements(options?: RequestOptions): Promise<Announcement[]>;
+    /** Загружает баннер текущего события — виджет «портал». */
+    portal(options?: RequestOptions): Promise<Portal>;
+}
+/** Запись о времени просмотра поста. */
+interface DwellEntry {
+    /** Идентификатор поста. */
+    postId: string;
+    /** Сколько миллисекунд пост был виден. */
+    duration: number;
+    /** Служебная метка показа из поля `vs` объекта поста. */
+    vs?: string;
+}
+/** Запись о взаимодействии с контентом. */
+interface InteractionEntry {
+    /** Тип взаимодействия: `photo_open`, `video_progress` и подобные. */
+    type: string;
+    /** Значение, смысл которого зависит от типа: доля просмотра, номер кадра. */
+    value?: number;
+    /** Идентификатор поста. */
+    postId?: string;
+    /** Идентификатор вложения. */
+    attachmentId?: string;
+    /** Служебная метка показа. */
+    vs?: string;
+}
+/**
+ * Телеметрия просмотров.
+ *
+ * @experimental Эндпоинты `/api/v1/i` и `/api/v1/x` нигде не описаны, а схема их полей
+ * не проверена на реальных запросах и может измениться без предупреждения.
+ *
+ * **Библиотека никогда не отправляет телеметрию сама.** Эти методы нужны только тем,
+ * кто пишет собственный клиент платформы; всем остальным их вызывать не требуется.
+ *
+ * Доступна как `itd.telemetry`.
+ */
+declare class TelemetryResource extends BaseResource {
+    /**
+     * Отправляет время просмотра постов.
+     *
+     * @experimental Имена полей на проводе сжаты (`ai`, `v`, `s`), и их соответствие
+     * смыслу **не проверено** на реальных запросах. Может измениться без предупреждения.
+     */
+    dwell(entries: DwellEntry[], options?: RequestOptions): Promise<unknown>;
+    /**
+     * Отправляет события взаимодействия с контентом.
+     *
+     * @experimental См. предупреждение у {@link TelemetryResource}.
+     */
+    interaction(entries: InteractionEntry[], options?: RequestOptions): Promise<unknown>;
+}
+
+/** Параметры запроса списка уведомлений. */
+interface NotificationListParams extends RequestOptions {
+    limit?: number;
+    /** Смещение от начала списка. */
+    offset?: number;
+    maxPages?: number;
+}
+/** Изменяемые настройки уведомлений. */
+type UpdateNotificationSettingsInput = Partial<NotificationSettings>;
+/**
+ * Уведомления: список, счётчик, отметки о прочтении, настройки.
+ *
+ * Доступна как `itd.notifications`. Все уведомления приведены к единой форме, поэтому
+ * объекты отсюда и из потока событий можно складывать в один список.
+ */
+declare class NotificationsResource extends BaseResource {
+    /**
+     * Загружает страницу уведомлений.
+     *
+     * Пагинация здесь основана на смещении. Сайт итд.com оборачивает смещение в строку
+     * и притворяется, что это курсор; библиотека отдаёт честное число.
+     *
+     * @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>;
+}
+
+/** Параметры запроса ленты. */
+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[]>;
+    /** Загружает страницу постов пользователя (его стену). */
+    byUser(user: UserRef, params?: UserPostsParams): Promise<Page<Post>>;
+    /** Перебирает посты пользователя. */
+    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>;
+}
+
+/** Постраничные параметры списков пользователей. */
+interface UserListParams extends RequestOptions {
+    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<{
+        avatar: string;
+        memberCount: number;
+    }[]>;
+    /**
+     * Подписывается на пользователя.
+     *
+     * У закрытого профиля вместо подписки отправляется заявка — это видно по полю `status`.
+     */
+    follow(user: UserRef, options?: RequestOptions): Promise<FollowResult>;
+    /** Отписывается от пользователя. */
+    unfollow(user: UserRef, options?: RequestOptions): Promise<void>;
+    /** Загружает страницу подписчиков. */
+    followers(user: UserRef, params?: UserListParams): Promise<Page<UserSummary>>;
+    /** Перебирает подписчиков. */
+    iterateFollowers(user: UserRef, params?: UserListParams): Paginator<UserSummary>;
+    /** Загружает страницу подписок. */
+    following(user: UserRef, params?: UserListParams): Promise<Page<UserSummary>>;
+    /** Перебирает подписки. */
+    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>;
+    /** Загружает страницу заблокированных пользователей. */
+    blocked(params?: UserListParams): Promise<Page<UserSummary>>;
+    /** Перебирает заблокированных пользователей. */
+    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>;
+}
+
+/**
+ * Клиент 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: { email, password },
+ *   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);
+    /** Базовый 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>;
+    /**
+     * Подписывается на события авторизации.
+     *
+     * Полезно, чтобы сохранять сессию во внешнее хранилище или узнавать, что вход
+     * окончательно потерян.
+     *
+     * @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;
+    /** Текущая сессия целиком — чтобы сохранить её самостоятельно. */
+    getSession(): Promise<ItdSession | null>;
+    /** Восстанавливает сохранённую сессию, включая cookie. */
+    setSession(session: ItdSession): Promise<void>;
+    /**
+     * Подключает чтение файлов с диска.
+     *
+     * Вызывается из `itd-api/node`; напрямую обычно не нужно.
+     *
+     * @internal
+     */
+    setFileReader(readFile: FileReader): 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;
+/** Категория ошибки. Определяет, какие поля у неё есть. */
+type ItdErrorKind = 'api' | 'network' | 'timeout' | 'abort' | 'config';
+/** Ошибки по полям формы: `{ 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 {
+    /** 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;
+    constructor(init: ItdApiErrorInit);
+    /**
+     * Проверяет код ошибки. Удобнее, чем сравнивать строки вручную.
+     *
+     * @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 isItdRateLimitError(value: unknown): value is ItdRateLimitError;
+
+/** Изображения, которые принимает `POST /api/files/upload`. */
+declare const IMAGE_MIME_TYPES: readonly string[];
+/** Видео, которые принимает `POST /api/files/upload`. */
+declare const VIDEO_MIME_TYPES: readonly string[];
+/** Аудио для голосовых комментариев. */
+declare const AUDIO_MIME_TYPES: readonly string[];
+/** Все типы, которые принимает загрузка. */
+declare const ALLOWED_MIME_TYPES: readonly 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 { ItdError as $, ALLOWED_MIME_TYPES as A, type BuilderInput as B, type ChangelogEntry as C, DEFAULT_BASE_URL as D, type DwellEntry as E, type FileReader as F, type ErrorContextHook as G, type FeedParams as H, type ItdSession as I, FeedTab as J, type FileInput as K, FilesResource as L, type FollowResult as M, type Hashtag as N, type HashtagPostsParams as O, HashtagsResource as P, IMAGE_MIME_TYPES as Q, type InteractionEntry as R, type IsoDate as S, type TokenStorage as T, ItdAbortError as U, ItdApiError as V, type ItdApiErrorInit as W, ItdAuthError as X, type ItdBuilder as Y, ItdConfigError as Z, ItdConflictError as _, ItdClient as a, type Report as a$, ItdErrorCode as a0, type ItdErrorKind as a1, type ItdFieldErrors as a2, ItdForbiddenError as a3, ItdNetworkError as a4, ItdNotFoundError as a5, ItdPhoneVerificationError as a6, ItdRateLimitError as a7, ItdRealtime as a8, ItdServerError as a9, type PinsResult as aA, PlatformResource as aB, type Poll as aC, PollBuilder as aD, type PollInput as aE, type PollOption as aF, type PollTransportOptions as aG, type Portal as aH, type Post as aI, PostBuilder as aJ, type PostInput as aK, type PostStats as aL, PostsResource as aM, type PrivacySettings as aN, type Profile as aO, type PublicProfile as aP, RECONNECT_BACKOFF as aQ, RECONNECT_JITTER as aR, type RateLimitOptions as aS, type RawRequestOptions as aT, type RealtimeEvents as aU, type RealtimeOptions as aV, RealtimeStatus as aW, type RealtimeTransport as aX, type RealtimeTransportKind as aY, type ReconnectOptions as aZ, type RepliesParams as a_, ItdTimeoutError as aa, ItdValidationError as ab, type LikeResult as ac, LikesVisibility as ad, type Listener as ae, LocalStorageTokenStorage as af, type Logger as ag, type Loose as ah, MAX_RECONNECT_ATTEMPTS as ai, MemoryTokenStorage as aj, type MyProfile as ak, NOTIFICATION_TYPE_ALIASES as al, type Notification as am, type NotificationEvent as an, type NotificationListParams as ao, type NotificationSettings as ap, NotificationType as aq, NotificationsResource as ar, type OAuthProvider as as, type Page as at, type PageState as au, type PaginationMode as av, Paginator as aw, type PaymentMethod as ax, type Pin as ay, type PinPostResult as az, type ItdClientOptions as b, ReportBuilder as b0, type ReportInput as b1, ReportReason as b2, ReportTargetType as b3, ReportsResource as b4, type RequestContext as b5, type RequestOptions as b6, type ResponseContext as b7, type RetryContext as b8, type RetryOptions as b9, VIDEO_MIME_TYPES as bA, VerificationResource as bB, type VerificationStatus as bC, WallAccess as bD, canonicalNotificationType as bE, comment as bF, createTokenStorage as bG, formatNotificationText as bH, isBuilder as bI, isItdApiError as bJ, isItdAuthError as bK, isItdError as bL, isItdRateLimitError as bM, isItdValidationError as bN, isKnownNotificationType as bO, isMyProfile as bP, normalizeNotification as bQ, poll as bR, post as bS, readNotificationEvent as bT, readUnreadCountEvent as bU, report as bV, resolveNotificationUrl as bW, toDate as bX, createClient as bY, type RuntimeMode as ba, STREAM_PATH as bb, SearchResource as bc, type SearchResult as bd, type Session as be, type SignInResult as bf, type Span as bg, type SseTransportOptions as bh, type Subscription as bi, SubscriptionResource as bj, type SubscriptionState as bk, TelemetryResource as bl, type TransportContext as bm, type TransportEvent as bn, type Unsubscribe as bo, type UpdateNotificationSettingsInput as bp, type UpdatePrivacyInput as bq, type UpdateProfileInput as br, type UploadOptions as bs, type UploadedFile as bt, type UserId as bu, type UserListParams as bv, type UserPostsParams as bw, type UserRef as bx, type UserSummary as by, UsersResource as bz, AUDIO_MIME_TYPES as c, type Actor as d, type Announcement as e, type AnnouncementButton as f, type Attachment as g, AttachmentType as h, type AuthInput as i, AuthResource as j, type Author as k, type Clan as l, type ClientHooks as m, type Comment as n, CommentBuilder as o, type CommentInput as p, type CommentReplyTo as q, CommentSort as r, type CommentsParams as s, CommentsResource as t, type CreateCommentInput as u, type CreatePollInput as v, type CreatePostInput as w, type CreateReportInput as x, type Credentials as y, DEFAULT_TIMEOUT as z };