itd-api 0.0.7 → 0.0.9

package/dist/index-DNFPX_Z1.d.ts

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