itd-api 0.0.8 → 0.0.10

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

@@ -1,37 +1,3 @@
-/** Метка билдера. Через `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.
  *
@@ -155,6 +121,24 @@ declare const RealtimeStatus: Readonly<{
     readonly Disconnected: "disconnected";
 }>;
 type RealtimeStatus = (typeof RealtimeStatus)[keyof typeof RealtimeStatus];
+/** Состояние сервиса платформы. Тип открытый. */
+declare const ServiceState: Readonly<{
+    /** Работает штатно. */
+    readonly Operational: "operational";
+    /** Работает с деградацией. */
+    readonly Degraded: "degraded";
+    /** Недоступен. */
+    readonly Downtime: "downtime";
+}>;
+type ServiceState = Loose<(typeof ServiceState)[keyof typeof ServiceState]>;
+/** Вид происшествия в истории сервиса. Тип открытый. */
+declare const IncidentKind: Readonly<{
+    /** Недоступен. */
+    readonly Down: "down";
+    /** Деградация. */
+    readonly Degraded: "deg";
+}>;
+type IncidentKind = Loose<(typeof IncidentKind)[keyof typeof IncidentKind]>;
 /**
  * Уровень доступа к разделу профиля.
  *
@@ -361,13 +345,11 @@ type UserId = string;
  */
 type UserRef = string;
 /**
- * Разметка в тексте поста.
+ * Разметка в тексте поста или комментария.
  *
- * Приходит от сервера и отправляется обратно как есть — библиотека разметку не генерирует
- * и не пересчитывает.
- *
- * Единицы `offset` и `length` в документации API не уточнены (UTF-16 или кодовые точки),
- * поэтому при работе с эмодзи проверяйте результат.
+ * `offset` и `length` измеряются в UTF-16 code units: это те же индексы, которые используют
+ * `String#slice`, `substring` и DOM Selection в JavaScript. Эмодзи вне BMP обычно занимают
+ * две единицы.
  */
 interface Span {
     /** Тип фрагмента — см. {@link SpanType}. */
@@ -376,10 +358,14 @@ interface Span {
     offset: number;
     /** Длина фрагмента. */
     length: number;
-    /** Имя хэштега без решётки либо имя пользователя. */
+    /** Имя хэштега без решётки. У старых mention-объектов может содержать username. */
     tag?: string;
     /** Адрес ссылки. Только у `link`: у него вместо `tag` отдельное поле. */
     url?: string;
+    /** Имя пользователя у `mention`. */
+    username?: string;
+    /** Идентификатор пользователя у некоторых ответов API с `mention`. */
+    id?: string;
 }
 /**
  * Значок-«пин» в профиле — награда или отметка платформы.
@@ -628,6 +614,14 @@ interface Comment {
     id: string;
     /** Текст. У голосового комментария пустой. */
     content: string;
+    /**
+     * Разметка текста, включая автоматически найденные сервером хэштеги и упоминания.
+     *
+     * Скачанный клиент читает это поле, но comment endpoints принимают только `content`,
+     * поэтому библиотека не отправляет ручные spans при создании и редактировании комментария.
+     * Поле необязательно: отдельные ответы сервера могут его не содержать.
+     */
+    spans?: Span[];
     author: Author;
     likesCount: number;
     repliesCount: number;
@@ -815,6 +809,61 @@ interface Portal {
     title: string;
     url: string;
 }
+/** Происшествие в истории сервиса. */
+interface StatusIncidentLine {
+    /** Вид происшествия. */
+    t: IncidentKind;
+    /**
+     * Готовая строка для показа: `недоступен 6 мин (12:00–12:06)`. Время московское.
+     * Длительность и границы интервала отдельными полями не приходят.
+     */
+    text: string;
+}
+/** Одни сутки в истории сервиса. */
+interface StatusDay {
+    /** Худшее состояние за сутки. */
+    type: ServiceState;
+    /** Дата суток, `YYYY-MM-DD`. Сутки нарезаны по UTC. */
+    date_key: string;
+    /** Доступность за сутки в процентах. */
+    uptime: number;
+    /** Происшествия за сутки. */
+    lines: StatusIncidentLine[];
+}
+/** Сервис платформы и его история доступности. */
+interface ServiceStatus {
+    /** Идентификатор: `auth`, `main`, `media` и прочие. */
+    id: string;
+    /** Отображаемое название. */
+    name: string;
+    current_status: ServiceState;
+    /** Пояснение к текущему состоянию, например `No downtime`. */
+    current_message: string;
+    /** Задержка последней проверки в миллисекундах. */
+    latency_ms: number;
+    /**
+     * Момент последней проверки. Сервер отдаёт `YYYY-MM-DD HH:mm:ss` в UTC, библиотека
+     * приводит значение к ISO.
+     */
+    last_checked: IsoDate;
+    /** Доступность за 90 суток в процентах. */
+    uptime_90d: number;
+    /**
+     * История по суткам. Ключ — сколько суток назад, `'0'` — сегодня.
+     *
+     * Объект разреженный: сутки без данных сервер пропускает. Ровный массив даёт
+     * {@link statusDays}.
+     */
+    days: Record<string, StatusDay | undefined>;
+}
+/** Состояние платформы — ответ `itd.platform.status()`. */
+interface PlatformStatus {
+    /** Худшее состояние среди сервисов. */
+    overall_status: ServiceState;
+    /** Когда данные последний раз пересчитаны. */
+    updated_at: IsoDate;
+    services: ServiceStatus[];
+}
 /** Статус заявки на верификацию. `none` означает, что заявка не подавалась. */
 interface VerificationStatus {
     status: Loose<'none' | 'pending' | 'approved' | 'rejected'>;
@@ -861,380 +910,137 @@ interface PinsResult {
  * ```
  */
 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;
-}
 /**
- * Начинает сборку опроса.
+ * Разворачивает историю сервиса в массив на 90 суток.
+ * Сутки без данных становятся `null`.
  *
- * @param question вопрос; можно задать позже методом {@link PollBuilder.question}
+ * @returns массив, где индекс — сколько суток назад: `[0]` — сегодня
  *
  * @example
  * ```ts
- * import { poll } from 'itd-api';
- *
- * const q = poll('Какой язык лучше?')
- *   .options('TypeScript', 'JavaScript')
- *   .multipleChoice();
+ * const status = await itd.platform.status();
+ * const days = statusDays(status.services[0]);
  *
- * await itd.posts.create({ content: 'голосуем', poll: q });
+ * days[0]?.uptime;                              // доступность за сегодня
+ * days.filter((day) => day === null).length;    // за сколько суток данных нет
  * ```
  */
-declare function poll(question?: string): PollBuilder;
-/** Что принимает параметр опроса: объект, билдер или функция-настройщик. */
-type PollInput = BuilderInput<CreatePollInput, PollBuilder>;
+declare function statusDays(service: ServiceStatus): (StatusDay | null)[];
 
 /**
- * Файл для загрузки.
+ * Как библиотека обращается с cookie.
  *
- * Строка означает **путь на диске** и работает только в Node, Bun и Deno — для этого
- * подключите `itd-api/node`. В браузере и React Native передавайте `File` или `Blob`.
+ * - `browser` — cookie ведёт браузер, запросы уходят с `credentials: 'include'`;
+ * - `server` — cookie ведёт встроенный jar, заголовок `Cookie` подставляется вручную;
+ * - `auto` — определяется по среде исполнения (значение по умолчанию).
  */
-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[];
+declare const RuntimeMode: Readonly<{
+    /** Определяется по среде исполнения. Значение по умолчанию. */
+    readonly Auto: "auto";
+    /** Cookie ведёт браузер, запросы уходят с `credentials: 'include'`. */
+    readonly Browser: "browser";
+    /** Cookie ведёт встроенный jar, заголовок `Cookie` подставляется вручную. */
+    readonly Server: "server";
+}>;
+type RuntimeMode = (typeof RuntimeMode)[keyof typeof RuntimeMode];
+/** Распознанная среда исполнения. */
+declare const DetectedRuntime: Readonly<{
+    readonly Browser: "browser";
+    /** Есть `window`, но нет `document`; cookie ведёт нативный сетевой слой. */
+    readonly ReactNative: "react-native";
+    readonly Server: "server";
+}>;
+type DetectedRuntime = (typeof DetectedRuntime)[keyof typeof DetectedRuntime];
+
+/** Сервис платформы на отдельном домене. */
+interface ServiceDefinition {
+    /** Имя, по которому запрос выбирает сервис: `{ service: 'status' }`. */
+    name: string;
+    /** Базовый URL сервиса. */
+    baseUrl: string;
+    /** Заголовки, добавляемые к каждому запросу сервиса. Заголовки вызова важнее. */
+    headers?: Record<string, string> | undefined;
     /**
-     * Чья стена, если пост публикуется не у себя.
+     * Слать ли заголовок авторизации.
      *
-     * Требуется **UUID**: имя пользователя здесь не работает, его можно получить
-     * из профиля через `itd.users.get(username)`.
+     * По умолчанию включено для основного хоста и его поддоменов. Для остальных хостов
+     * авторизацию нужно разрешить явно: `auth: true`.
      */
-    wallRecipientId?: UserId | null;
-    /** Идентификаторы заранее загруженных вложений. */
-    attachmentIds?: string[];
-    /** Файлы, которые нужно загрузить перед публикацией. Порядок сохраняется. */
-    files?: FileInput[];
-    /** Опрос: обычный объект, {@link PollBuilder} или функция-настройщик. */
-    poll?: PollInput;
+    auth?: boolean | undefined;
 }
-/** Данные для создания комментария или ответа. */
-interface CreateCommentInput {
-    /** Текст. У голосового комментария должен быть пустым. */
-    content?: string;
-    /** Идентификаторы заранее загруженных вложений. */
-    attachmentIds?: string[];
-    /** Файлы, которые нужно загрузить перед отправкой. */
-    files?: FileInput[];
+/** Именованные сервисы клиента. */
+declare class ServiceRegistry {
+    #private;
+    /** @param primaryBaseUrl базовый URL клиента */
+    constructor(primaryBaseUrl?: string);
     /**
-     * Кому адресован ответ.
+     * Регистрирует сервис. Имя очищается от краевых пробелов, базовый URL приводится
+     * к каноничному виду, а незаданный `auth` выводится из хоста.
      *
-     * Применимо только в `itd.comments.reply()`; в комментарии к посту поле не имеет смысла.
+     * @throws {ItdConfigError} если имя пустое, имя занято или `baseUrl` не абсолютный URL
      */
-    replyToUserId?: UserId;
-}
-/** Данные для создания жалобы. */
-interface CreateReportInput {
-    /** На что жалоба. */
-    targetType: ReportTargetType;
-    /** Идентификатор объекта жалобы. */
-    targetId: string;
-    /** Причина. */
-    reason: ReportReason;
-    /** Пояснение в свободной форме. */
-    description?: string;
+    define(definition: ServiceDefinition): void;
+    /** Определение сервиса либо `undefined`, если такого нет. */
+    get(name: string): ServiceDefinition | undefined;
+    /** Зарегистрирован ли сервис с таким именем. */
+    has(name: string): boolean;
+    /**
+     * Определение сервиса.
+     *
+     * @throws {ItdConfigError} если сервис не зарегистрирован
+     */
+    require(name: string): ServiceDefinition;
+    /**
+     * Базовый URL сервиса.
+     *
+     * @throws {ItdConfigError} если сервис не зарегистрирован
+     */
+    resolveBaseUrl(name: string): string;
+    /**
+     * Принадлежит ли URL основному хосту клиента или его поддомену.
+     *
+     * Используется для безопасного значения по умолчанию у разового `baseUrl`: Bearer-токен
+     * не должен уходить на посторонний хост без явного `skipAuth: false`.
+     *
+     * @internal
+     */
+    isPrimarySite(baseUrl: string): boolean;
 }
 
-/** Внутреннее состояние {@link CommentBuilder}. */
-interface CommentState extends CreateCommentInput {
-    content: string;
-    attachmentIds: string[];
-    files: FileInput[];
-    /** Голосовой комментарий: текста быть не должно, вложение ровно одно. */
-    voice: boolean;
-}
 /**
- * Билдер комментария и ответа на комментарий.
+ * Сохранённая сессия.
  *
- * Неизменяемый: каждый вызов возвращает новый экземпляр. Создаётся функцией {@link comment}.
+ * Кроме токенов сюда попадают cookie: refresh-токен итд.com живёт именно в cookie, и без них
+ * восстановить сессию после перезапуска процесса невозможно.
  */
-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;
+interface ItdSession {
+    /** Токен доступа для заголовка `Authorization: Bearer`. */
+    accessToken?: string | undefined;
     /**
-     * Делает комментарий голосовым.
-     *
-     * Текста у такого комментария быть не должно, а вложение ровно одно — аудио в формате
-     * `audio/ogg`. Так его принимает API.
+     * Refresh-токен, если удалось получить его явным значением.
      *
-     * @example
-     * ```ts
-     * await itd.posts.comment(postId, (c) => c.voice('./answer.ogg'));
-     * ```
+     * Обычно сервер держит его в httpOnly-cookie и наружу не отдаёт — тогда поле останется
+     * пустым, а обновление пойдёт через {@link ItdSession.cookies}.
      */
-    voice(audio: FileInput): CommentBuilder;
+    refreshToken?: string | undefined;
+    /** Сырые cookie в форме `имя=значение`, привязанные к origin API. */
+    cookies?: string[] | undefined;
     /**
-     * Кому адресован ответ.
+     * Идентификатор устройства для заголовка `X-Device-Id`.
      *
-     * Имеет смысл только в `itd.comments.reply()`; при отправке комментария к посту
-     * это поле вызовет ошибку.
+     * Сервер различает по нему записи в списке сессий, поэтому значение должно пережить
+     * перезапуск процесса — иначе каждый старт бота порождает новую сессию. Библиотека
+     * заводит его сама при первом запросе и хранит здесь.
      */
-    replyTo(userId: UserId): CommentBuilder;
-    build(): CreateCommentInput;
-    toJSON(): CreateCommentInput;
+    deviceId?: string | undefined;
+    /** Когда сессия получена, мс с начала эпохи. Нужно для диагностики. */
+    obtainedAt?: number | undefined;
 }
 /**
- * Начинает сборку комментария.
+ * Хранилище сессии.
  *
- * @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
@@ -1274,6 +1080,9 @@ declare class MemoryTokenStorage implements TokenStorage {
  *
  * Помните, что `localStorage` доступен любому скрипту на странице: не используйте его,
  * если для вашего приложения это неприемлемый риск.
+ *
+ * После ошибки записи или удаления хранилище переключается на память до конца
+ * своего жизненного цикла.
  */
 declare class LocalStorageTokenStorage implements TokenStorage {
     #private;
@@ -1455,6 +1264,23 @@ interface ItdClientOptions {
      * источников на итд.com, скорее всего, не настроен.
      */
     baseUrl?: string | undefined;
+    /**
+     * Сервисы платформы на отдельных доменах.
+     *
+     * Ключ — имя сервиса, значение — базовый URL или определение целиком. Имя встроенного
+     * сервиса задаёт его хост. Встроен один: `status` — хост `itd.platform.status()`.
+     *
+     * @example
+     * ```ts
+     * const itd = new ItdClient({
+     *   services: {
+     *     status: 'https://my-proxy.example/status',
+     *     pb: { baseUrl: 'https://pbapi.xn--d1ah4a.com', headers: { Referer: 'https://pixel.xn--d1ah4a.com/' } },
+     *   },
+     * });
+     * ```
+     */
+    services?: Record<string, string | Omit<ServiceDefinition, 'name'>> | undefined;
     /** Авторизация. Без неё доступны только публичные эндпоинты. */
     auth?: AuthInput | undefined;
     /** Где хранить сессию. По умолчанию {@link MemoryTokenStorage}. */
@@ -1516,15 +1342,46 @@ interface RequestOptions {
     /** Повторы только для этого запроса. Переопределяют глобальную настройку `retry`. */
     retry?: RetryOptions | false | undefined;
 }
+/**
+ * Имена полей {@link RequestOptions} — единственный источник истины.
+ *
+ * Ресурсы переносят в описание запроса только эти поля (плюс заявленные плагинами),
+ * потому что параметры методов подмешивают к ним `limit`, `cursor` и прочее, чему
+ * в транспорте делать нечего. Список стоит рядом с интерфейсом, чтобы новое поле нельзя
+ * было забыть.
+ *
+ * `satisfies` гарантирует, что каждое имя в списке — действительно поле `RequestOptions`.
+ * Обратную полноту (не забыто ли новое поле) проверяет тип {@link RequestOptionKeysComplete}
+ * в тесте: здесь её проверять нельзя — плагины расширяют `RequestOptions` своими опциями
+ * (`encrypt`, `decrypt` и подобными), которых в этом списке быть и не должно.
+ */
+declare const REQUEST_OPTION_KEYS: readonly ["signal", "timeout", "headers", "retry"];
 /** Полное описание запроса для низкоуровневого `itd.request()`. */
 interface RawRequestOptions extends RequestOptions {
     method: string;
     /** Путь с ведущим слэшем, например `/api/posts`. Завершающий слэш значим. */
     path: string;
+    /**
+     * Имя сервиса, на хост которого уйдёт запрос. Без него запрос идёт на основной `baseUrl`
+     * клиента. Сервисы задаются опцией {@link ItdClientOptions.services}.
+     */
+    service?: string | undefined;
+    /**
+     * Хост этого запроса. Важнее, чем {@link RawRequestOptions.service}.
+     *
+     * На посторонний основному API хост Bearer-токен по умолчанию не отправляется.
+     * Для осознанного разрешения укажите `skipAuth: false`.
+     */
+    baseUrl?: string | undefined;
     query?: QueryParams | undefined;
     /** Тело: будет отправлено как JSON. Для загрузки файлов передайте `FormData`. */
     body?: unknown;
-    /** Не подставлять заголовок авторизации. */
+    /**
+     * Не подставлять заголовок авторизации.
+     *
+     * Явное `false` разрешает авторизацию и для разового внешнего `baseUrl`; без него
+     * токен автоматически отправляется только основному хосту и его поддоменам.
+     */
     skipAuth?: boolean | undefined;
     /** Не пытаться обновить токен при `401` — используется самими эндпоинтами авторизации. */
     skipAuthRefresh?: boolean | undefined;
@@ -1541,10 +1398,16 @@ interface RawRequestOptions extends RequestOptions {
 }
 
 /** Версия библиотеки. Попадает в `User-Agent`. */
-declare const LIBRARY_VERSION = "0.0.8";
+declare const LIBRARY_VERSION = "0.0.10";
 
 /** Базовый URL API итд.com. Домен записан в punycode: `итд.com`. */
 declare const DEFAULT_BASE_URL = "https://xn--d1ah4a.com";
+/** Базовый URL страницы статуса. Домен записан в punycode: `статус.итд.com`. */
+declare const DEFAULT_STATUS_BASE_URL = "https://xn--80a7abcbg.xn--d1ah4a.com";
+/** Имя встроенного сервиса статуса. */
+declare const STATUS_SERVICE = "status";
+/** Сервисы, зарегистрированные у любого клиента. */
+declare const BUILT_IN_SERVICES: readonly ServiceDefinition[];
 /** Таймаут запроса по умолчанию. Столько же использует официальный клиент итд.com. */
 declare const DEFAULT_TIMEOUT = 30000;
 
@@ -1558,7 +1421,14 @@ declare const DEFAULT_TIMEOUT = 30000;
  * В браузере заголовок не выставляется — `User-Agent` там запрещён к изменению, и среда
  * молча его игнорирует.
  */
-declare const DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; itd-api/0.0.8; +https://github.com/KiowDev/itd-api)";
+declare const DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; itd-api/0.0.10; +https://github.com/KiowDev/itd-api)";
+/** Настройки очереди со всеми значениями по умолчанию. */
+interface ResolvedRateLimitOptions {
+    concurrency: number;
+    rps: number | undefined;
+    retryDelays: readonly number[];
+    respectHeaders: boolean;
+}
 /**
  * Срез конфигурации, нужный слою авторизации.
  *
@@ -1649,7 +1519,7 @@ declare class CookieJar {
 
 /** Обработчик события. */
 type Listener<T> = (payload: T) => void;
-/** Функция отписки, которую возвращает {@link Emitter.on}. */
+/** Функция отписки, которую возвращает подписка на событие. */
 type Unsubscribe = () => void;
 /**
  * Минимальный типизированный источник событий.
@@ -1716,10 +1586,20 @@ interface PipelineRequest extends RawRequestOptions {
 /** Обработчик запроса. Самый внутренний в цепочке — транспорт. */
 type RequestHandler = (request: PipelineRequest) => Promise<unknown>;
 
-/** Пути авторизации. Вынесены, чтобы не расходиться между модулями. */
+/** Пути эндпоинтов авторизации. */
 declare const AUTH_PATHS: {
+    readonly signUp: "/api/v1/auth/sign-up";
     readonly signIn: "/api/v1/auth/sign-in";
+    readonly verifyOtp: "/api/v1/auth/verify-otp";
+    readonly resendOtp: "/api/v1/auth/resend-otp";
     readonly refresh: "/api/v1/auth/refresh";
+    readonly logout: "/api/v1/auth/logout";
+    readonly forgotPassword: "/api/v1/auth/forgot-password";
+    readonly resetPassword: "/api/v1/auth/reset-password";
+    readonly changePassword: "/api/v1/auth/change-password";
+    readonly sessions: "/api/v1/auth/sessions";
+    /** Префикс внешнего входа: к нему дописывается имя провайдера. */
+    readonly oauthLogin: "/api/v1/auth/login";
 };
 /**
  * Публичный ключ Cloudflare Turnstile платформы итд.com.
@@ -1770,6 +1650,8 @@ declare class AuthManager {
     get on(): Emitter<AuthEvents>['on'];
     /** Подписка на одно срабатывание. */
     get once(): Emitter<AuthEvents>['once'];
+    /** Непрозрачная область авторизации; токен и идентификатор пользователя не раскрываются. */
+    getAuthScope(): string;
     /**
      * Есть ли признак живой refresh-сессии.
      *
@@ -1816,7 +1698,14 @@ declare class AuthManager {
     setAccessToken(accessToken: string): Promise<void>;
     /** Текущая сессия целиком. Полезно, чтобы сохранить её самому. */
     getSession(): Promise<ItdSession | null>;
-    /** Заменяет сессию целиком. */
+    /**
+     * Идентификатор владельца сессии.
+     *
+     * Считается непосредственно из текущего токена и отдельно не сохраняется: после замены
+     * токена идентификатор прежнего владельца остаться не может.
+     */
+    getUserId(): Promise<UserId | undefined>;
+    /** Заменяет сессию и связанные с ней cookie целиком. */
     setSession(session: ItdSession): Promise<void>;
     /**
      * Забывает сессию и cookie. Сетевой запрос не выполняется.
@@ -1850,6 +1739,14 @@ interface PluginContext {
     baseUrl: string;
     /** Отладочный вывод клиента, если он включён. */
     logger: Logger | undefined;
+    /**
+     * Непрозрачная область текущей авторизации.
+     *
+     * Значение уникально для клиента и меняется при замене либо очистке его сессии. Плагин может
+     * использовать его только для разделения состояния; идентификатор пользователя и токен в нём
+     * не раскрываются.
+     */
+    getAuthScope?: (() => string) | undefined;
     /** Добавляет обёртку запроса. Подключённые раньше оказываются снаружи. */
     use(transformer: Transformer): void;
 }
@@ -1929,6 +1826,57 @@ declare class PluginRegistry {
     run(request: RawRequestOptions, execute: (request: RawRequestOptions) => Promise<unknown>): Promise<unknown>;
 }
 
+/**
+ * Очередь запросов: ограничивает одновременность и частоту.
+ *
+ * Нужна прежде всего ботам: без неё цикл по сотне постов уходит в API одним залпом
+ * и упирается в `RATE_LIMIT_EXCEEDED`.
+ *
+ * Частота выдерживается равномерным разносом стартов (`1000 / rps` между запросами),
+ * а не окном со счётчиком: так нагрузка ровная, без всплеска в начале каждой секунды.
+ *
+ * @internal
+ */
+declare class RequestQueue {
+    #private;
+    constructor(options: ResolvedRateLimitOptions);
+    /** Сколько задач выполняется прямо сейчас. */
+    get active(): number;
+    /** Сколько задач ждёт очереди. */
+    get pending(): number;
+    /**
+     * Ставит задачу в очередь.
+     *
+     * @returns результат задачи; ошибка задачи пробрасывается без изменений
+     */
+    schedule<T>(task: () => Promise<T>, signal?: AbortSignal): Promise<T>;
+    /**
+     * Останавливает очередь: снимает отложенную паузу и отклоняет ещё не начатые задачи
+     * ошибкой `ItdAbortError`. Уже выполняющиеся задачи доводятся до конца.
+     */
+    stop(): void;
+    /**
+     * Придерживает всю очередь на заданное время.
+     *
+     * Вызывается при получении `429` с заголовком `Retry-After`: тормозить нужно все запросы,
+     * а не только тот, который наткнулся на лимит, — иначе остальные продолжат добивать API.
+     */
+    pause(ms: number): void;
+}
+/**
+ * Очереди по хостам: основная и по одной на каждый сервис платформы.
+ *
+ * @internal
+ */
+declare class RequestQueuePool {
+    #private;
+    constructor(options: ResolvedRateLimitOptions);
+    /** Очередь хоста. */
+    for(service: string | undefined): RequestQueue;
+    /** Останавливает все очереди. */
+    stop(): void;
+}
+
 /** Событие потока уведомлений после разбора. */
 interface NotificationEvent {
     /** Само уведомление в единой форме. */
@@ -2018,6 +1966,11 @@ interface TransportContext {
     baseUrl: string;
     /** Реализация `fetch`. */
     fetch: typeof fetch;
+    /**
+     * Общие заголовки клиента: `User-Agent`, `X-Device-Id`, заголовки конфигурации
+     * и cookie для указанного адреса.
+     */
+    baseHeaders: (url: string) => Promise<Headers>;
     /** Текущий токен доступа. */
     getToken: () => Promise<string | null>;
     /** Отмена подключения. */
@@ -2149,6 +2102,8 @@ interface RealtimeOptions extends ReconnectOptions {
 interface RealtimeDeps {
     baseUrl: string;
     fetch: typeof fetch;
+    /** Общие заголовки клиента для адреса — см. {@link TransportContext.baseHeaders}. */
+    baseHeaders: (url: string) => Promise<Headers>;
     getToken: () => Promise<string | null>;
     /** Обновляет токен после отказа авторизации. Возвращает `true`, если удалось. */
     refresh: () => Promise<boolean>;
@@ -2283,6 +2238,8 @@ declare const PaginationMode: Readonly<{
     readonly Offset: "offset";
 }>;
 type PaginationMode = (typeof PaginationMode)[keyof typeof PaginationMode];
+/** Применяет преобразование к элементам страницы, сохраняя сведения о пагинации. */
+declare function mapPage<T, R>(page: Page<T>, map: (item: T) => R): Page<R>;
 /** Позиция, с которой запрашивается очередная страница. */
 interface PageState {
     cursor?: string | undefined;
@@ -2494,10 +2451,10 @@ type SignInStatus = (typeof SignInStatus)[keyof typeof SignInStatus];
  * объединение делает оба случая явными.
  */
 type SignInResult = {
-    status: typeof SignInStatus.Authenticated;
+    status: 'authenticated';
     accessToken: string;
 } | {
-    status: typeof SignInStatus.OtpRequired;
+    status: 'otp_required';
     flowToken: string | undefined;
 };
 /**
@@ -2636,9 +2593,14 @@ declare class AuthResource extends BaseResource {
      * Меняет пароль. Требует действующей сессии.
      *
      * При неверном текущем пароле сервер отвечает `ACCOUNT_CURRENT_PASSWORD_INCORRECT`.
+     *
+     * @example
+     * ```ts
+     * await itd.auth.changePassword({ currentPassword, newPassword });
+     * ```
      */
     changePassword(input: {
-        oldPassword: string;
+        currentPassword: string;
         newPassword: string;
     }, options?: RequestOptions): Promise<void>;
     /**
@@ -2661,9 +2623,238 @@ declare class AuthResource extends BaseResource {
     revokeOtherSessions(options?: RequestOptions): Promise<void>;
 }
 
-/** Параметры запроса ответов на комментарий. */
-interface RepliesParams extends RequestOptions {
-    limit?: number;
+/** Метка билдера. Через `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>;
+
+/**
+ * Билдер опроса.
+ *
+ * Неизменяемый: каждый вызов возвращает новый экземпляр, поэтому заготовку можно
+ * переиспользовать, не боясь её испортить. Создаётся функцией {@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 проверяются относительно `content`;
+     * для автоматического построения доступны `post().markup()` и `post().autoSpans()`.
+     */
+    spans?: Span[];
+    /**
+     * Чья стена, если пост публикуется не у себя.
+     *
+     * Требуется **UUID**: имя пользователя здесь не работает, его можно получить
+     * из профиля через `itd.users.get(username)`.
+     */
+    wallRecipientId?: UserId | null;
+    /** Идентификаторы заранее загруженных вложений. */
+    attachmentIds?: string[];
+    /** Файлы, которые нужно загрузить перед публикацией. Порядок сохраняется. */
+    files?: FileInput[];
+    /** Опрос: обычный объект, {@link PollBuilder} или функция-настройщик. */
+    poll?: PollInput;
+}
+/** Поля поста, которые принимает `itd.posts.update()`. */
+interface UpdatePostInput {
+    /** Новый текст поста. Обязателен, чтобы обновление одних spans не стёрло текущий текст. */
+    content: string;
+    /** Разметка нового текста. */
+    spans?: Span[];
+}
+/** Данные для создания комментария или ответа. */
+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>;
+
+/** Параметры запроса ответов на комментарий. */
+interface RepliesParams extends RequestOptions {
+    limit?: number;
     page?: number;
     maxPages?: number;
 }
@@ -2728,6 +2919,13 @@ interface UploadOptions extends RequestOptions {
      */
     validateMime?: boolean;
 }
+/**
+ * Таймаут загрузки файла по умолчанию.
+ *
+ * Заметно больше обычного: видео на несколько десятков мегабайт не укладывается
+ * в стандартные 30 секунд, и запрос обрывался бы на середине.
+ */
+declare const DEFAULT_UPLOAD_TIMEOUT = 300000;
 /** Чтение файла по пути — подставляется точкой входа `itd-api/node`. */
 type FileReader = (path: string) => Promise<{
     data: Uint8Array;
@@ -2894,16 +3092,231 @@ declare class NotificationsResource extends BaseResource {
 /**
  * Сведения о платформе: изменения, анонсы, баннер события.
  *
- * Доступна как `itd.platform`.
+ * Доступна как `itd.platform`.
+ */
+declare class PlatformResource extends BaseResource {
+    /** Загружает журнал изменений. */
+    changelog(options?: RequestOptions): Promise<ChangelogEntry[]>;
+    /** Загружает анонсы платформы. */
+    announcements(options?: RequestOptions): Promise<Announcement[]>;
+    /** Загружает баннер текущего события — виджет «портал». */
+    portal(options?: RequestOptions): Promise<Portal>;
+    /**
+     * Загружает состояние сервисов платформы за последние 90 суток.
+     *
+     * Идёт на хост `статус.итд.com` без авторизации. Ответ кэшируется сервером на минуту.
+     * История по суткам приходит разреженной, ровный массив даёт `statusDays`.
+     *
+     * @example
+     * ```ts
+     * const status = await itd.platform.status();
+     *
+     * if (status.overall_status !== 'operational') {
+     *   const broken = status.services.filter((s) => s.current_status !== 'operational');
+     *   console.log('лежит:', broken.map((s) => s.name).join(', '));
+     * }
+     * ```
+     */
+    status(options?: RequestOptions): Promise<PlatformStatus>;
+}
+
+/** Текст вместе с рассчитанной разметкой. */
+interface TextMarkup {
+    content: string;
+    spans: Span[];
+}
+/** Описание фрагмента без смещения: его вычисляет {@link MarkupBuilder}. */
+type MarkupSpan = Omit<Span, 'offset' | 'length'>;
+/** Что принимает метод разметки: результат, билдер или функция-настройщик. */
+type MarkupInput = BuilderInput<TextMarkup, MarkupBuilder>;
+/**
+ * Содержимое форматированного фрагмента.
+ *
+ * Строка создаёт простой фрагмент. Билдер, готовая разметка или функция позволяют вложить
+ * одни spans в другие, как при последовательном форматировании выделения в редакторе сайта.
+ */
+type MarkupContent = string | MarkupInput;
+/** Какие сущности искать в {@link autoSpans}. */
+interface AutoSpansOptions {
+    /** Находить `#хэштеги`. По умолчанию `true`. */
+    hashtags?: boolean;
+    /** Находить `@упоминания`. По умолчанию `true`. */
+    mentions?: boolean;
+    /** Находить абсолютные HTTP(S)-ссылки. По умолчанию `true`. */
+    links?: boolean;
+}
+/**
+ * Неизменяемый билдер текста с разметкой.
+ *
+ * Каждый метод дописывает фрагмент и сам считает `offset` и `length` в единицах UTF-16 —
+ * именно такие индексы использует JavaScript-редактор сайта.
+ */
+declare class MarkupBuilder implements ItdBuilder<TextMarkup> {
+    #private;
+    /** @internal */
+    readonly [BUILDER]: true;
+    /** @internal Создавайте билдер функцией {@link markup}. */
+    constructor(content: string, spans: Span[]);
+    /** Дописывает обычный текст без разметки. */
+    text(value: string): MarkupBuilder;
+    /** Дописывает переводы строк. */
+    newline(count?: number): MarkupBuilder;
+    /**
+     * Дописывает фрагмент с произвольным типом разметки.
+     *
+     * Вложенный билдер позволяет форматировать часть фрагмента дополнительным стилем.
+     * Для нескольких стилей на всём фрагменте используйте {@link styled}.
+     */
+    span(value: MarkupContent, span: MarkupSpan): MarkupBuilder;
+    /**
+     * Дописывает фрагмент с несколькими стилями на одном диапазоне.
+     *
+     * Для `link`, которому нужен `url`, используйте {@link link}; произвольные spans с
+     * метаданными можно объединять через вложенные вызовы {@link span}.
+     */
+    styled(value: MarkupContent, ...types: Span['type'][]): MarkupBuilder;
+    /** Дописывает `#хэштег` и сохраняет имя без решётки в `tag`. */
+    hashtag(tag: string): MarkupBuilder;
+    /** Дописывает `@username` и сохраняет имя пользователя в `username`. */
+    mention(username: string): MarkupBuilder;
+    /**
+     * Дописывает ссылку.
+     *
+     * Для строки адрес по умолчанию становится и текстом ссылки. Вложенному форматированному
+     * фрагменту URL нужно передать явно.
+     */
+    link(content: MarkupContent, url?: string): MarkupBuilder;
+    bold(content: MarkupContent): MarkupBuilder;
+    italic(content: MarkupContent): MarkupBuilder;
+    underline(content: MarkupContent): MarkupBuilder;
+    strike(content: MarkupContent): MarkupBuilder;
+    spoiler(content: MarkupContent): MarkupBuilder;
+    monospace(content: MarkupContent): MarkupBuilder;
+    quote(content: MarkupContent): MarkupBuilder;
+    build(): TextMarkup;
+    toJSON(): TextMarkup;
+}
+/** Начинает сборку текста с автоматически вычисляемыми смещениями. */
+declare function markup(content?: string): MarkupBuilder;
+/**
+ * Находит в тексте те сущности, которые сайт получает после серверного разбора:
+ * HTTP(S)-ссылки, `#хэштеги` и `@упоминания`.
+ *
+ * Смещения выражены в UTF-16 code units, поэтому совпадают с `String#slice`,
+ * `substring`, DOM Selection и wire-форматом сайта даже при наличии эмодзи.
+ */
+declare function autoSpans(text: string, options?: AutoSpansOptions): Span[];
+
+declare const BUILD_UPDATE: unique symbol;
+/** Внутреннее состояние {@link PostBuilder}. */
+interface PostState extends CreatePostInput {
+    content: string;
+    contentSet: boolean;
+    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);
+    /**
+     * Задаёт текст поста, заменяя прежний вместе с его разметкой.
+     *
+     * Spans привязаны к конкретному тексту, поэтому после замены их нужно задать заново
+     * через {@link spans}, {@link markup} или {@link autoSpans}.
+     */
+    content(text: string): PostBuilder;
+    /** Дописывает текст к уже заданному. */
+    append(text: string): PostBuilder;
+    /**
+     * Задаёт готовую разметку текста. Смещения проверяются при {@link build}.
+     *
+     * Для автоматического поиска сущностей есть {@link autoSpans}, а для вычисления смещений
+     * при сборке текста — {@link markup}.
+     */
+    spans(spans: Span[]): PostBuilder;
+    /**
+     * Заменяет текст и разметку результатом {@link MarkupBuilder}.
+     *
+     * @example
+     * ```ts
+     * post().markup((m) => m.text('смотрите ').hashtag('котики').text(' от ').mention('durov'));
+     * ```
+     */
+    markup(input: MarkupInput): PostBuilder;
+    /**
+     * Находит HTTP(S)-ссылки, хэштеги и упоминания в уже заданном тексте.
+     *
+     * Ручные стили сохраняются. Повторный вызов не дублирует уже найденные сущности.
+     */
+    autoSpans(options?: AutoSpansOptions): 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;
+    /** @internal Собирает данные по правилам `posts.update`, не применяя правила создания. */
+    [BUILD_UPDATE](): UpdatePostInput;
+    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 class PlatformResource extends BaseResource {
-    /** Загружает журнал изменений. */
-    changelog(options?: RequestOptions): Promise<ChangelogEntry[]>;
-    /** Загружает анонсы платформы. */
-    announcements(options?: RequestOptions): Promise<Announcement[]>;
-    /** Загружает баннер текущего события — виджет «портал». */
-    portal(options?: RequestOptions): Promise<Portal>;
-}
+declare function post(content?: string): PostBuilder;
+/** Что принимает параметр поста: объект, билдер или функция-настройщик. */
+type PostInput = BuilderInput<CreatePostInput, PostBuilder>;
+/** Что принимает `posts.update`: объект, билдер поста или функция-настройщик. */
+type PostUpdateInput = UpdatePostInput | PostBuilder | ((builder: PostBuilder) => PostBuilder | UpdatePostInput);
 
 /** Параметры запроса ленты. */
 interface FeedParams extends RequestOptions {
@@ -2992,8 +3405,14 @@ declare class PostsResource extends BaseResource {
      * В отличие от списков, здесь у поста заполнено поле `comments`.
      */
     get(postId: string, options?: RequestOptions): Promise<Post>;
-    /** Редактирует текст поста. */
-    update(postId: string, input: Pick<CreatePostInput, 'content' | 'spans'>, options?: RequestOptions): Promise<Post>;
+    /**
+     * Редактирует текст и разметку поста.
+     *
+     * Как и {@link create}, принимает объект, готовый {@link PostBuilder} или
+     * функцию-настройщик. Поля создания поста, которые update endpoint не поддерживает
+     * (вложения, опрос и стена), отвергаются до запроса.
+     */
+    update(postId: string, input: PostUpdateInput, options?: RequestOptions): Promise<Post>;
     /** Удаляет пост. Восстановить его можно через {@link restore}. */
     remove(postId: string, options?: RequestOptions): Promise<void>;
     /** Восстанавливает удалённый пост. */
@@ -3073,6 +3492,50 @@ declare class PostsResource extends BaseResource {
     voiceComment(postId: string, audio: FileInput, options?: RequestOptions): Promise<Comment>;
 }
 
+/**
+ * Билдер жалобы.
+ *
+ * Точка входа задаёт объект жалобы и его тип одновременно, поэтому рассогласовать
+ * `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>;
+
 /**
  * Жалобы на контент и пользователей.
  *
@@ -3188,13 +3651,13 @@ interface InteractionEntry {
     vs: string;
     /** Идентификатор поста. Поле `ai`. */
     postId: string;
-    /** Индекс вложения (с нуля) — для {@link InteractionType.PhotoOpen}. Поле `mi`. */
+    /** Индекс вложения (с нуля) — для `InteractionType.PhotoOpen` ({@link InteractionType}). Поле `mi`. */
     mediaIndex?: number;
     /** Источник показа. Поле `s`. */
     source?: ViewSource;
-    /** Просмотрено мс — для {@link InteractionType.VideoProgress}. Поле `pm`. */
+    /** Просмотрено мс — для `InteractionType.VideoProgress` ({@link InteractionType}). Поле `pm`. */
     positionMs?: number;
-    /** Длительность видео в мс — для {@link InteractionType.VideoProgress}. Поле `dm`. */
+    /** Длительность видео в мс — для `InteractionType.VideoProgress` ({@link InteractionType}). Поле `dm`. */
     durationMs?: number;
 }
 /**
@@ -3394,6 +3857,12 @@ declare global {
  */
 interface ItdClientInternals {
     fileReader?: FileReader | undefined;
+    /**
+     * Готовая очередь запросов — так {@link ItdAccounts} с `rateLimitScope: 'shared'` даёт
+     * нескольким клиентам одну на всех. Свою клиент в этом случае не заводит и, что важнее,
+     * не гасит при `close()`: чужие ожидающие запросы это отменило бы.
+     */
+    queues?: RequestQueuePool | undefined;
 }
 /**
  * Клиент API итд.com.
@@ -3484,13 +3953,43 @@ declare class ItdClient {
      *
      * @example
      * ```ts
-     * import { crypt } from 'itd-api-crypto';
+     * import { crypt } from '@itd-api/crypto';
      *
      * itd.use(crypt());
      * await itd.posts.create({ content: 'секрет' }, { encrypt: 'invis' });
      * ```
      */
     use(plugin: ItdPlugin): this;
+    /**
+     * Регистрирует сервис платформы — домен, отличный от основного.
+     *
+     * Запросы с `{ service: 'имя' }` уходят на его хост с его заголовками. То же самое умеет
+     * опция `services` конструктора. Занятое имя не переопределяется — ни своё, ни встроенное:
+     * разовому запросу хост задаётся полем `baseUrl`.
+     *
+     * Заголовок авторизации по умолчанию уходит только своим — домену клиента и его
+     * поддоменам. Стороннему хосту токен нужно разрешить явно: `auth: true`.
+     *
+     * @throws {ItdConfigError} если определение неверно или имя уже занято
+     *
+     * @example Сервис платформы на поддомене — токен уходит сам
+     * ```ts
+     * itd.defineService({
+     *   name: 'pb',
+     *   baseUrl: 'https://pbapi.xn--d1ah4a.com',
+     *   headers: { Referer: 'https://pixel.xn--d1ah4a.com/' },
+     * });
+     *
+     * await itd.request({ method: 'GET', service: 'pb', path: '/api/pixel-info' });
+     * ```
+     */
+    defineService(definition: ServiceDefinition): this;
+    /**
+     * Базовый URL зарегистрированного сервиса.
+     *
+     * @throws {ItdConfigError} если сервис не зарегистрирован
+     */
+    serviceBaseUrl(name: string): string;
     /**
      * Подписывается на события авторизации.
      *
@@ -3532,6 +4031,9 @@ declare class ItdClient {
      * После вызова клиентом можно пользоваться снова — новые запросы поднимут всё заново,
      * но уже созданные потоки останутся закрытыми.
      *
+     * Общая очередь, полученная от {@link ItdAccounts}, не останавливается: её гасит сам
+     * контейнер, когда закрывает все аккаунты разом.
+     *
      * @example
      * ```ts
      * await using itd = new ItdClient({ auth: token });
@@ -3544,6 +4046,20 @@ declare class ItdClient {
     [Symbol.asyncDispose](): Promise<void>;
     /** Текущая сессия целиком — чтобы сохранить её самостоятельно. */
     getSession(): Promise<ItdSession | null>;
+    /**
+     * Идентификатор аккаунта, под которым работает клиент.
+     *
+     * Читается из токена доступа и не стоит ни одного запроса. `undefined`, когда сессии
+     * ещё нет или токен выдан не в формате JWT. Полезен прежде всего с {@link ItdAccounts}:
+     * показывает, какому профилю соответствует восстановленная из хранилища запись.
+     * Свежий профиль целиком отдаёт `itd.users.me()`.
+     *
+     * @example
+     * ```ts
+     * for (const [name, itd] of accounts) console.log(name, await itd.getUserId());
+     * ```
+     */
+    getUserId(): Promise<UserId | undefined>;
     /** Восстанавливает сохранённую сессию, включая cookie. */
     setSession(session: ItdSession): Promise<void>;
 }
@@ -3559,6 +4075,340 @@ declare class ItdClient {
  */
 declare function createClient(options?: ItdClientOptions): ItdClient;
 
+/**
+ * Хранилище сессий нескольких аккаунтов.
+ *
+ * Отличается от {@link TokenStorage} тем, что каждый метод получает **имя аккаунта**:
+ * так адаптер сам решает, как строить ключ, и Redis, БД или связка ключей получают то,
+ * что им нужно. Имя приходит ровно тем, под которым аккаунт заведён в {@link ItdAccounts}:
+ * библиотека его не нормализует и не экранирует — префиксы, экранирование и ограничения
+ * на длину ключа остаются за адаптером.
+ *
+ * Все методы могут быть как синхронными, так и асинхронными.
+ *
+ * @example Своё хранилище поверх Redis
+ * ```ts
+ * const storage = createMultiTokenStorage({
+ *   get: async (account) => JSON.parse((await redis.get(`itd:session:${account}`)) ?? 'null'),
+ *   set: async (account, session) => {
+ *     await redis.set(`itd:session:${account}`, JSON.stringify(session));
+ *     await redis.sadd('itd:accounts', account);
+ *   },
+ *   clear: async (account) => {
+ *     await redis.del(`itd:session:${account}`);
+ *     await redis.srem('itd:accounts', account);
+ *   },
+ *   accounts: () => redis.smembers('itd:accounts'),
+ * });
+ * ```
+ */
+interface MultiTokenStorage {
+    /** Прочитать сессию аккаунта. `null`, если её нет. */
+    get(account: string): ItdSession | null | Promise<ItdSession | null>;
+    /** Сохранить сессию аккаунта целиком. */
+    set(account: string, session: ItdSession): void | Promise<void>;
+    /** Удалить сессию аккаунта. Вызывается при выходе и при неудачном обновлении токена. */
+    clear(account: string): void | Promise<void>;
+    /**
+     * Имена сохранённых записей — по ним `ItdAccounts.restore()` находит кандидатов
+     * после перезапуска процесса.
+     *
+     * Список ведёт сам адаптер: у файлового и памятного он виден из самой записи,
+     * а хранилищу «ключ — значение» придётся держать множество имён рядом с сессиями.
+     * Перед восстановлением контейнер читает каждую запись и пропускает оставшийся после
+     * выхода одинокий `deviceId`: без токена или refresh-сессии авторизоваться невозможно.
+     * Пустой список означает лишь то, что кандидатов нет, — сами записи при этом могут быть
+     * доступны по имени.
+     */
+    accounts(): readonly string[] | Promise<readonly string[]>;
+}
+/**
+ * Срез мультихранилища как обычное {@link TokenStorage} — в таком виде его получает
+ * отдельный `ItdClient`, который про соседние аккаунты ничего не знает.
+ */
+declare function scopedTokenStorage(storage: MultiTokenStorage, account: string): TokenStorage;
+/**
+ * Мультихранилище в памяти процесса — вариант по умолчанию.
+ *
+ * Сессии теряются при перезапуске. Для долгоживущих ботов возьмите `FileMultiTokenStorage`
+ * из `itd-api/node` либо соберите своё через {@link createMultiTokenStorage}.
+ */
+declare class MemoryMultiTokenStorage implements MultiTokenStorage {
+    #private;
+    constructor(initial?: Readonly<Record<string, ItdSession>> | null);
+    get(account: string): ItdSession | null;
+    set(account: string, session: ItdSession): void;
+    clear(account: string): void;
+    accounts(): string[];
+}
+/**
+ * Собирает {@link MultiTokenStorage} из четырёх функций — когда заводить класс избыточно.
+ * Аналог `createTokenStorage` для нескольких аккаунтов.
+ */
+declare function createMultiTokenStorage(handlers: MultiTokenStorage): MultiTokenStorage;
+/** Источник, который читается и пишется целиком: файл, ключ в `localStorage`, строка в БД. */
+interface RecordStorageSource {
+    /** Прочитать все сессии разом. `null` — записи ещё нет. */
+    read(): Promise<Record<string, ItdSession> | null>;
+    /** Записать все сессии разом. */
+    write(record: Record<string, ItdSession>): Promise<void>;
+    /** Вызывается вместо {@link RecordStorageSource.write}, когда не осталось ни одной сессии. */
+    remove?(): Promise<void>;
+}
+/**
+ * Мультихранилище поверх источника, который читается и пишется целиком.
+ *
+ * Решает главную проблему такого способа хранения — **гонку «прочитать, изменить,
+ * записать»**: десять аккаунтов пишут в одну запись, и наивная реализация теряла бы
+ * чужие сессии. Источник читается один раз, дальше слепок живёт в памяти, а записи
+ * выстраиваются в цепочку и идут по очереди.
+ *
+ * Внутри процесса этого достаточно. Несколько процессов, пишущих в одну запись,
+ * по-прежнему затирают друг друга — как и несколько экземпляров этого адаптера,
+ * направленных на один источник в одном процессе.
+ */
+declare function createRecordMultiStorage(source: RecordStorageSource): MultiTokenStorage;
+
+/** Как аккаунты делят между собой очередь запросов. */
+type RateLimitScope = 'account' | 'shared';
+/**
+ * Опции конструктора {@link ItdAccounts}.
+ *
+ * Всё, что понимает `ItdClient`, кроме `auth` и `deviceId`: они у каждого аккаунта свои
+ * и задаются в {@link ItdAccounts.addAccount}. Обычный `TokenStorage` клиента здесь заменён
+ * общей опцией {@link ItdAccountsOptions.storage} типа {@link MultiTokenStorage}; контейнер
+ * сам выдаёт каждому клиенту изолированный срез по имени. Общий `deviceId` особенно вреден —
+ * сервер различает по нему записи в списке сессий, и один на всех сложил бы все аккаунты
+ * в одну.
+ */
+interface ItdAccountsOptions extends Omit<ItdClientOptions, 'auth' | 'storage' | 'deviceId'> {
+    /** Общее хранилище сессий всех аккаунтов. По умолчанию {@link MemoryMultiTokenStorage}. */
+    storage?: MultiTokenStorage | undefined;
+    /** Плагины, подключаемые каждому аккаунту, в том числе добавленному позже. */
+    plugins?: readonly ItdPlugin[] | undefined;
+    /**
+     * Как делить очередь запросов. По умолчанию `'account'` — своя у каждого.
+     *
+     * Лимиты итд.com считаются по аккаунту, а при работе через разные прокси общая очередь
+     * только мешает. Она нужна в другом случае: когда все аккаунты сидят на одном IP
+     * и упираются в ограничение по адресу, — тогда `'shared'` разводит их запросы во времени
+     * все разом, а не поаккаунтно.
+     *
+     * Настройки самой очереди берутся из общей опции `rateLimit`. Личный объект `rateLimit`
+     * в этом режиме запрещён, потому что не может изменить уже созданную очередь;
+     * `rateLimit: false` у отдельного аккаунта выводит его из неё.
+     */
+    rateLimitScope?: RateLimitScope | undefined;
+}
+/**
+ * Настройки одного аккаунта. Общее мультихранилище задаёт контейнер, а аккаунт получает
+ * свой срез автоматически; остальное — как у `ItdClient`.
+ *
+ * При `rateLimitScope: 'shared'` объект `rateLimit` задаётся только контейнеру; аккаунту
+ * разрешено передать `false`, чтобы не ставить его запросы в общую очередь.
+ */
+type AddAccountOptions = Omit<ItdClientOptions, 'storage'>;
+/** Что можно уточнить при удалении аккаунта. */
+interface RemoveAccountOptions {
+    /**
+     * Удалить и сохранённую сессию. По умолчанию `false` — аккаунт убирается только
+     * из памяти, а его токены остаются в хранилище и переживут перезапуск.
+     */
+    forget?: boolean | undefined;
+}
+/**
+ * События авторизации всех аккаунтов сразу.
+ *
+ * Те же, что у одиночного клиента, плюс имя аккаунта: подписка на контейнер избавляет
+ * от нужды вешать обработчик на каждого.
+ */
+interface AccountEvents {
+    /** Токен получен или обновлён. */
+    tokens: {
+        account: string;
+        accessToken: string;
+    };
+    /** Выполнен вход. */
+    signIn: {
+        account: string;
+        accessToken: string;
+    };
+    /** Сессия очищена — вручную или из-за неудачного обновления. */
+    signOut: {
+        account: string;
+    };
+    /** Обновить сессию не удалось; дальнейшие запросы этого аккаунта будут падать с 401. */
+    authError: {
+        account: string;
+        error: unknown;
+    };
+}
+/**
+ * Скрытые параметры конструктора — не часть публичного API.
+ *
+ * Через них точка входа `itd-api/node` подставляет свою фабрику клиентов, чтобы аккаунты
+ * умели читать файлы с диска.
+ *
+ * @internal
+ */
+interface ItdAccountsInternals {
+    createClient?: ((options: ItdClientOptions, internals: ItdClientInternals) => ItdClient) | undefined;
+}
+/**
+ * Несколько аккаунтов итд.com в одном месте.
+ *
+ * Контейнер именованных `ItdClient`: каждый аккаунт получает собственный токен, cookie
+ * и `deviceId`, а сессии всех складываются в одно хранилище — обычно в один файл, а не
+ * в десяток. Имя аккаунта выбираете вы; сервер о нём ничего не знает.
+ *
+ * @example Бот на нескольких аккаунтах
+ * ```ts
+ * import { ItdAccounts, FileMultiTokenStorage } from 'itd-api/node';
+ *
+ * await using accounts = new ItdAccounts({
+ *   storage: new FileMultiTokenStorage('./.itd-sessions.json'),
+ *   rateLimit: { concurrency: 4 },
+ * });
+ *
+ * // Восстанавливаем тех, кто уже входил раньше: токен возьмётся из хранилища.
+ * await accounts.restore();
+ *
+ * if (!accounts.has('kiow')) {
+ *   accounts.addAccount('kiow', { auth: { email, password, getTurnstileToken } });
+ * }
+ *
+ * await accounts.account('kiow').posts.create({ content: 'привет' });
+ *
+ * for (const [name, itd] of accounts) {
+ *   console.log(name, await itd.getUserId());
+ * }
+ * ```
+ */
+declare class ItdAccounts {
+    #private;
+    constructor(options?: ItdAccountsOptions, internals?: ItdAccountsInternals);
+    /** Общее хранилище сессий — то же, что передано опцией `storage`. */
+    get storage(): MultiTokenStorage;
+    /** Сколько аккаунтов заведено. */
+    get size(): number;
+    /** Имена заведённых аккаунтов в порядке добавления. */
+    names(): string[];
+    /** Заведён ли аккаунт с таким именем. */
+    has(name: string): boolean;
+    /**
+     * Заводит аккаунт.
+     *
+     * Возвращается обычный `ItdClient` — со всеми ресурсами, плагинами и `realtime()`.
+     * Хранилище ему подставляется само: срез общего по имени аккаунта.
+     *
+     * Опция `auth` не обязательна: когда сессия этого аккаунта уже лежит в хранилище,
+     * токен возьмётся оттуда, а истёкший продлится сам.
+     *
+     * @throws {ItdConfigError} если имя пустое или уже занято
+     *
+     * @example
+     * ```ts
+     * accounts.addAccount('bot', { auth: { email, password, getTurnstileToken } });
+     * accounts.addAccount('reader', { auth: '<accessToken>' });
+     * accounts.addAccount('через-прокси', { fetch: proxyFetch('socks5://…') });
+     * ```
+     */
+    addAccount(name: string, options?: AddAccountOptions): ItdClient;
+    /**
+     * Клиент аккаунта.
+     *
+     * @throws {ItdConfigError} если такого аккаунта нет
+     *
+     * @example
+     * ```ts
+     * await accounts.account('kiow').posts.like(postId);
+     * ```
+     */
+    account(name: string): ItdClient;
+    /**
+     * Поднимает аккаунты, сессии которых уже лежат в хранилище.
+     *
+     * То, ради чего мультихранилище знает свой состав: после перезапуска процесса
+     * ни `auth`, ни капча не нужны — токен, `deviceId` и cookie берутся из сохранённого.
+     * Уже заведённые аккаунты не трогаются. Записи, в которых после выхода остался только
+     * `deviceId`, пропускаются: авторизованной сессии в них уже нет.
+     *
+     * @returns имена добавленных аккаунтов
+     *
+     * @example
+     * ```ts
+     * const restored = await accounts.restore();
+     * console.log(`подняли ${restored.length} аккаунтов без единого входа`);
+     * ```
+     */
+    restore(): Promise<string[]>;
+    /**
+     * Убирает аккаунт: закрывает его клиента и, если попросить, забывает сессию.
+     *
+     * Сетевого запроса не выполняет. Чтобы завершить сессию на сервере, вызовите
+     * `itd.auth.logout()` до удаления.
+     *
+     * @returns `false`, если такого аккаунта и не было
+     */
+    removeAccount(name: string, options?: RemoveAccountOptions): Promise<boolean>;
+    /**
+     * Подключает плагин всем аккаунтам — и заведённым, и будущим.
+     *
+     * @throws {ItdConfigError} если плагин задан неверно или уже подключён
+     *
+     * @example
+     * ```ts
+     * accounts.use(crypt());
+     * ```
+     */
+    use(plugin: ItdPlugin): this;
+    /**
+     * Подписывается на события авторизации всех аккаунтов сразу.
+     *
+     * @returns функция отписки
+     *
+     * @example
+     * ```ts
+     * accounts.on('authError', ({ account }) => console.warn(`${account}: сессия потеряна`));
+     * ```
+     */
+    on<K extends keyof AccountEvents>(event: K, listener: Listener<AccountEvents[K]>): Unsubscribe;
+    /**
+     * Перебор аккаунтов парами «имя — клиент».
+     *
+     * @example
+     * ```ts
+     * for (const [name, itd] of accounts) {
+     *   const me = await itd.users.me();
+     *   console.log(name, me.nickname);
+     * }
+     * ```
+     */
+    [Symbol.iterator](): IterableIterator<[string, ItdClient]>;
+    /**
+     * Закрывает все аккаунты и останавливает общую очередь.
+     *
+     * Аккаунты остаются в контейнере и работоспособны: новые запросы поднимут всё заново,
+     * но уже созданные потоки уведомлений останутся закрытыми.
+     *
+     * @example
+     * ```ts
+     * await using accounts = new ItdAccounts({ storage });
+     * // …работа…
+     * // close() вызовется сам на выходе из блока
+     * ```
+     */
+    close(): Promise<void>;
+    /** Позволяет использовать контейнер с `await using`. */
+    [Symbol.asyncDispose](): Promise<void>;
+}
+/**
+ * Создаёт контейнер аккаунтов.
+ *
+ * То же, что `new ItdAccounts(options)`, — для тех, кому привычнее фабрика.
+ */
+declare function createAccounts(options?: ItdAccountsOptions): ItdAccounts;
+
 /** Бренд, по которому ошибки библиотеки распознаются надёжнее, чем через `instanceof`. */
 declare const ITD_ERROR: unique symbol;
 /**
@@ -3846,6 +4696,19 @@ type AudioMimeType = (typeof AUDIO_MIME_TYPES)[number];
 declare const ALLOWED_MIME_TYPES: readonly ["image/jpeg", "image/png", "image/gif", "image/webp", "image/avif", "image/heic", "image/heif", "video/mp4", "video/webm", "video/quicktime", "audio/ogg"];
 type AllowedMimeType = (typeof ALLOWED_MIME_TYPES)[number];
 
+/**
+ * Приводит отметку времени без часового пояса к ISO-8601, считая её временем UTC.
+ *
+ * Строку другого вида возвращает нетронутой.
+ *
+ * @example
+ * ```ts
+ * utcStampToIso('2026-07-23 23:14:25');  // '2026-07-23T23:14:25Z'
+ * utcStampToIso('2026-07-23T23:14:25Z'); // без изменений
+ * ```
+ */
+declare function utcStampToIso(value: string): string;
+
 /**
  * Собирает текст уведомления на русском.
  *
@@ -3930,4 +4793,29 @@ interface SseTransportOptions {
     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 };
+/** Формат результата {@link renderSpans}. */
+type SpanRenderFormat = 'html' | 'markdown' | 'ansi';
+interface RenderSpansOptions {
+    /** Формат результата. По умолчанию `html`. */
+    format?: SpanRenderFormat;
+    /** Строит адрес упоминания. `null` или `undefined` отключает ссылку. */
+    mentionUrl?: (username: string) => string | null | undefined;
+    /** Строит адрес хэштега. `null` или `undefined` отключает ссылку. */
+    hashtagUrl?: (tag: string) => string | null | undefined;
+    /**
+     * Префикс HTML-классов. По умолчанию `itd`; пустая строка или `null` отключает классы.
+     *
+     * Например, `app` создаёт `app-mention`, `app-hashtag`, `app-quote` и `app-spoiler`.
+     */
+    classPrefix?: string | null;
+}
+/**
+ * Преобразует текст и wire-разметку API в безопасный HTML, Markdown или ANSI.
+ *
+ * Некорректные серверные spans игнорируются либо обрезаются по границам строки. Пересекающиеся
+ * spans разбиваются на независимые сегменты, поэтому HTML остаётся корректно вложенным.
+ * Отсутствующий массив считается пустым; формат по умолчанию — HTML.
+ */
+declare function renderSpans(content: string, spans?: readonly Span[] | null | undefined, options?: RenderSpansOptions): string;
+
+export { DetectedRuntime as $, ALLOWED_MIME_TYPES as A, BUILT_IN_SERVICES as B, type CaptchaCredentials as C, type ClientHooks as D, type Comment as E, type FileReader as F, CommentBuilder as G, type CommentInput as H, type ItdSession as I, type CommentReplyTo as J, CommentSort as K, type CommentsParams as L, type MultiTokenStorage as M, CommentsResource as N, type CreateCommentInput as O, type CreatePollInput as P, type CreatePostInput as Q, type CreateReportInput as R, type Credentials as S, type TokenStorage as T, type CredentialsAuth as U, DEFAULT_BASE_URL as V, DEFAULT_STATUS_BASE_URL as W, DEFAULT_TIMEOUT as X, DEFAULT_UPLOAD_TIMEOUT as Y, DEFAULT_USER_AGENT as Z, DEVICE_ID_HEADER as _, ItdAccounts as a, type PageState as a$, type DwellEntry as a0, type ErrorContextHook as a1, type FeedParams as a2, FeedTab as a3, type FileInput as a4, FilesResource as a5, type FollowResult as a6, type ForgotPasswordInput as a7, type Hashtag as a8, type HashtagPostsParams as a9, ItdServerError as aA, ItdTimeoutError as aB, ItdValidationError as aC, LIBRARY_VERSION as aD, type LikeResult as aE, LikesVisibility as aF, type Listener as aG, LocalStorageTokenStorage as aH, type Logger as aI, type Loose as aJ, MAX_RECONNECT_ATTEMPTS as aK, MarkupBuilder as aL, type MarkupContent as aM, type MarkupInput as aN, type MarkupSpan as aO, MemoryMultiTokenStorage as aP, MemoryTokenStorage as aQ, type MyProfile as aR, NOTIFICATION_TYPE_ALIASES as aS, type Notification as aT, type NotificationEvent as aU, type NotificationListParams as aV, type NotificationSettings as aW, NotificationType as aX, NotificationsResource as aY, OAuthProvider as aZ, type Page as a_, HashtagsResource as aa, IMAGE_MIME_TYPES as ab, type ImageMimeType as ac, IncidentKind as ad, type InteractionEntry as ae, InteractionType as af, type IsoDate as ag, ItdAbortError as ah, ItdApiError as ai, type ItdApiErrorInit as aj, ItdApiErrorKind as ak, ItdAuthError as al, type ItdBuilder as am, ItdConfigError as an, ItdConflictError as ao, ItdError as ap, ItdErrorCode as aq, ItdErrorKind as ar, type ItdFieldErrors as as, ItdForbiddenError as at, ItdNetworkError as au, ItdNotFoundError as av, ItdPhoneVerificationError as aw, type ItdPlugin as ax, ItdRateLimitError as ay, ItdRealtime as az, type ItdAccountsOptions as b, type ServiceDefinition as b$, PaginationMode as b0, Paginator as b1, type PaginatorOptions as b2, type PaymentMethod as b3, type Pin as b4, type PinPostResult as b5, type PinsResult as b6, PlatformResource as b7, type PlatformStatus as b8, type PluginContext as b9, type RealtimeEvents as bA, type RealtimeOptions as bB, RealtimeStatus as bC, type RealtimeTransport as bD, RealtimeTransportKind as bE, type ReconnectOptions as bF, type RecordStorageSource as bG, type RemoveAccountOptions as bH, type RenderSpansOptions as bI, type RepliesParams as bJ, type Report as bK, ReportBuilder as bL, type ReportInput as bM, ReportReason as bN, ReportTargetType as bO, ReportsResource as bP, type RequestContext as bQ, type RequestOptions as bR, type ResetPasswordInput as bS, type ResponseContext as bT, type RetryContext as bU, type RetryOptions as bV, RuntimeMode as bW, STATUS_SERVICE as bX, STREAM_PATH as bY, SearchResource as bZ, type SearchResult as b_, type Poll as ba, PollBuilder as bb, type PollInput as bc, type PollOption as bd, type PollTransportOptions as be, type Portal as bf, type Post as bg, PostBuilder as bh, type PostInput as bi, type PostStats as bj, type PostUpdateInput as bk, PostsResource as bl, type PrivacySettings as bm, type Profile as bn, type PublicProfile as bo, type QueryParams as bp, type QueryValue as bq, RECONNECT_BACKOFF as br, RECONNECT_JITTER as bs, REFRESH_COOKIE as bt, REFRESH_COOKIE_PATH as bu, REQUEST_OPTION_KEYS as bv, type RateLimitOptions as bw, type RateLimitScope as bx, type RawRequestOptions as by, type RealtimeDeps as bz, ItdClient as c, mapPage as c$, ServiceRegistry as c0, ServiceState as c1, type ServiceStatus as c2, type Session as c3, type SignInResult as c4, SignInStatus as c5, type Span as c6, type SpanRenderFormat as c7, SpanType as c8, type SseTransportOptions as c9, VIDEO_MIME_TYPES as cA, VerificationResource as cB, type VerificationStatus as cC, type VideoMimeType as cD, ViewReason as cE, ViewSource as cF, WallAccess as cG, autoSpans as cH, canonicalNotificationType as cI, comment as cJ, createMultiTokenStorage as cK, createRecordMultiStorage as cL, createTokenStorage as cM, formatNotificationText as cN, isBuilder as cO, isItdApiError as cP, isItdAuthError as cQ, isItdConflictError as cR, isItdError as cS, isItdForbiddenError as cT, isItdNotFoundError as cU, isItdPhoneVerificationError as cV, isItdRateLimitError as cW, isItdServerError as cX, isItdValidationError as cY, isKnownNotificationType as cZ, isMyProfile as c_, type StatusDay as ca, type StatusIncidentLine as cb, type Subscription as cc, SubscriptionResource as cd, type SubscriptionState as ce, TURNSTILE_SITE_KEY as cf, type TelemetryOptions as cg, TelemetryResource as ch, type TextMarkup as ci, type Transformer as cj, type TransportContext as ck, type TransportEvent as cl, UnauthorizedStreamError as cm, type Unsubscribe as cn, type UpdateNotificationSettingsInput as co, type UpdatePostInput as cp, type UpdatePrivacyInput as cq, type UpdateProfileInput as cr, type UploadOptions as cs, type UploadedFile as ct, type UserId as cu, type UserListParams as cv, type UserPostsParams as cw, type UserRef as cx, type UserSummary as cy, UsersResource as cz, type ItdClientOptions as d, markup as d0, normalizeNotification as d1, poll as d2, post as d3, readNotificationEvent as d4, readUnreadCountEvent as d5, renderSpans as d6, report as d7, resolveNotificationUrl as d8, scopedTokenStorage as d9, statusDays as da, toDate as db, utcStampToIso as dc, createAccounts as dd, createClient as de, type ItdClientInternals as e, AUDIO_MIME_TYPES as f, AUTH_FLAG_COOKIE as g, AUTH_PATHS as h, AccessType as i, type AccountEvents as j, type Actor as k, type AddAccountOptions as l, type AllowedMimeType as m, type Announcement as n, type AnnouncementButton as o, type Attachment as p, AttachmentType as q, type AudioMimeType as r, type AuthEvents as s, type AuthInput as t, AuthResource as u, type Author as v, type AutoSpansOptions as w, type BuilderInput as x, type ChangelogEntry as y, type Clan as z };