itd-api 0.7.1 → 0.8.0

package/dist/shared/{url-B6-bXHKt.d.ts → url-Be9jlWRv.d.cts}

@@ -1,97 +1,439 @@
-//#region src/core/operation.d.ts
-/** HTTP-метод операции. */
-type OperationMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
-/** Семантическая безопасность автоматического повтора операции. */
-declare const RetrySafety: Readonly<{
-  /** Автоматический повтор не создаёт неприемлемого эффекта; обычно это чтение. */
-  readonly Safe: "safe";
-  /** Повтор операции приводит к тому же состоянию, что и один вызов. */
-  readonly Idempotent: "idempotent";
-  /** Повтор может создать ещё один побочный эффект. */
-  readonly Unsafe: "unsafe";
+//#region src/types/enums.d.ts
+/**
+ * Enum 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
+ */
+/**
+ * Открытый строковый enum.
+ *
+ * Даёт автодополнение известных значений, но не ломается, если сервер пришлёт новое.
+ * Используется там, где документация 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 RetrySafety = (typeof RetrySafety)[keyof typeof RetrySafety];
+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];
 /**
- * Минимальное стабильное описание операции, доступное core и плагинам.
+ * Тип фрагмента разметки в тексте поста или комментария.
  *
- * Форма описания принадлежит ядру; заполненный ими каталог — доменному слою.
+ * Первые два сервер расставляет сам при разборе текста, остальные приходят от редактора.
+ * Тип открытый: набор может пополниться.
+ *
+ * @example
+ * ```ts
+ * await itd.posts.update(postId, {
+ *   content: 'жирное слово',
+ *   spans: [{ type: SpanType.Bold, offset: 0, length: 6 }],
+ * });
+ * ```
  */
-interface OperationDefinition {
-  readonly method: OperationMethod;
-  readonly retrySafety: RetrySafety;
-  /**
-   * Бакет операции. Опущено — операция списывает из бакета по умолчанию.
-   *
-   * Счётчик определяется парой «путь + метод»: `GET /api/users/me` — 40 запросов
-   * в минуту, `PUT` того же пути — 3, `DELETE` — 150.
-   */
-  readonly bucket?: string;
-}
-//#endregion
-//#region src/domain/buckets.d.ts
+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];
+/** Состояние соединения событийного канала. */
+declare const EventChannelStatus: Readonly<{
+  readonly Connecting: "connecting";
+  readonly Connected: "connected";
+  readonly Error: "error";
+  readonly Disconnected: "disconnected";
+}>;
+type EventChannelStatus = (typeof EventChannelStatus)[keyof typeof EventChannelStatus];
+/** Состояние сервиса платформы. Тип открытый. */
+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]>;
 /**
- * Ёмкость серверных счётчиков частоты, запросов в минуту.
+ * Уровень доступа к разделу профиля.
  *
- * Таблица действует до первого ответа бакета; дальше ёмкость берётся из заголовка
- * `x-ratelimit-limit` и заменяет табличную. `default` — счётчик любого пути без
- * собственного правила на сервере.
+ * Общий набор значений для полей `wallAccess` и `likesVisibility` настроек приватности.
+ * Тип открытый: сервер может прислать значение вне этого перечня.
  */
-declare const BUCKET_LIMITS: Readonly<{
-  readonly 'posts.stats': 180;
-  readonly default: 150;
-  readonly feed: 90;
-  readonly 'posts.like': 85;
-  readonly 'posts.comments': 80;
-  readonly hashtags: 50;
-  readonly users: 40;
-  readonly notifications: 40;
-  readonly 'files.get': 40;
-  readonly auth: 35;
-  readonly 'auth.refresh': 25;
-  readonly search: 25;
-  readonly 'comments.like': 22;
-  readonly 'files.upload': 15;
-  readonly 'files.remove': 15;
-  readonly 'posts.comment': 14;
-  readonly 'hashtags.trending': 13;
-  readonly 'posts.repost': 7;
-  readonly 'users.follow': 7;
-  readonly 'verification.status': 6;
-  readonly 'posts.create': 5;
-  readonly 'users.updateMe': 3;
-  readonly 'reports.create': 3;
-  readonly 'verification.submit': 3;
+declare const AccessType: Readonly<{
+  /** Никто. */
+  readonly Nobody: "nobody";
+  /** Только взаимные подписки. */
+  readonly Mutual: "mutual";
+  /** Подписчики. */
+  readonly Followers: "followers";
+  /** Все. */
+  readonly Everyone: "everyone";
 }>;
-/** Имя встроенного бакета. */
-type RateLimitBucket = keyof typeof BUCKET_LIMITS;
-/** Счётчик, из которого списывается путь без собственного правила на сервере. */
-declare const DEFAULT_RATE_LIMIT_BUCKET: RateLimitBucket;
-//#endregion
-//#region src/domain/operations.d.ts
-/** Описание встроенной операции: та же форма, что знает ядро, но с именем известного бакета. */
-interface ItdOperationDefinition extends OperationDefinition {
-  readonly bucket?: RateLimitBucket;
-}
+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;
 /**
- * Каталог встроенных операций.
+ * Канонический тип уведомления (новое поколение имён).
  *
- * ID описывает смысл вызова и не меняется при переносе HTTP-пути. Method и retrySafety
- * хранятся здесь, чтобы resources, retry и плагины не вели независимые таблицы операций.
+ * REST-эндпоинт `/api/notifications/` отдаёт старые имена (`like`, `comment`, `reply`,
+ * `repost`, `mention`), SSE-поток — новые. Библиотека приводит их к этому набору,
+ * сохраняя исходное значение в поле `rawType`.
  */
-declare const OPERATIONS: Readonly<{
-  readonly 'auth.check': Readonly<{
-    readonly method: "GET";
-    readonly retrySafety: "safe";
-  }>;
-  readonly 'auth.signUp': Readonly<{
-    readonly method: "POST";
-    readonly retrySafety: "unsafe";
-    readonly bucket: "auth";
-  }>;
-  readonly 'auth.signIn': Readonly<{
-    readonly method: "POST";
-    readonly retrySafety: "safe";
-    readonly bucket: "auth";
+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]>;
+//#endregion
+//#region src/models/common.d.ts
+/**
+ * Дата и время в формате ISO-8601, например `2026-07-21T14:30:00.000Z`.
+ *
+ * Библиотека не превращает такие поля в `Date`: строку проще сравнивать, логировать
+ * и передавать дальше без потерь. Для разбора есть `toDate()`.
+ */
+type IsoDate = string;
+/**
+ * Идентификатор пользователя — **строго UUID**.
+ *
+ * Отличается от {@link UserRef} тем, что имя пользователя здесь не подойдёт. Так помечены
+ * места, где API принимает только UUID: например `wallRecipientId` при постинге на чужую стену.
+ */
+type UserId = string;
+/**
+ * Ссылка на пользователя: **UUID либо имя пользователя**.
+ *
+ * Пути вида `/api/users/{id}` принимают оба варианта, поэтому `itd.users.get('nowkie')`
+ * работает так же, как `itd.users.get('9f1c…')`.
+ */
+type UserRef = string;
+/**
+ * Разметка в тексте поста или комментария.
+ *
+ * `offset` и `length` измеряются в UTF-16 code units: это те же индексы, которые используют
+ * `String#slice`, `substring` и DOM Selection в JavaScript. Эмодзи вне BMP обычно занимают
+ * две единицы.
+ */
+interface Span {
+  /** Тип фрагмента — см. {@link SpanType}. */
+  type: SpanType;
+  /** Смещение от начала текста. */
+  offset: number;
+  /** Длина фрагмента. */
+  length: number;
+  /** Имя хэштега без решётки. У старых mention-объектов может содержать username. */
+  tag?: string;
+  /** Адрес ссылки. Только у `link`: у него вместо `tag` отдельное поле. */
+  url?: string;
+  /** Имя пользователя у `mention`. */
+  username?: string;
+  /** Идентификатор пользователя у некоторых ответов API с `mention`. */
+  id?: string;
+}
+//#endregion
+//#region src/domain/buckets.d.ts
+/**
+ * Ёмкость серверных счётчиков частоты, запросов в минуту.
+ *
+ * Таблица действует до первого ответа бакета; дальше ёмкость берётся из заголовка
+ * `x-ratelimit-limit` и заменяет табличную. `default` — счётчик любого пути без
+ * собственного правила на сервере.
+ */
+declare const BUCKET_LIMITS: Readonly<{
+  readonly 'posts.stats': 180;
+  readonly default: 150;
+  readonly feed: 90;
+  readonly 'posts.like': 85;
+  readonly 'posts.comments': 80;
+  readonly hashtags: 50;
+  readonly users: 40;
+  readonly notifications: 40;
+  readonly 'files.get': 40;
+  readonly auth: 35;
+  readonly 'auth.refresh': 25;
+  readonly search: 25;
+  readonly 'comments.like': 22;
+  readonly 'files.upload': 15;
+  readonly 'files.remove': 15;
+  readonly 'posts.comment': 14;
+  readonly 'hashtags.trending': 13;
+  readonly 'posts.repost': 7;
+  readonly 'users.follow': 7;
+  readonly 'verification.status': 6;
+  readonly 'posts.create': 5;
+  readonly 'users.updateMe': 3;
+  readonly 'reports.create': 3;
+  readonly 'verification.submit': 3;
+}>;
+/** Имя встроенного бакета. */
+type RateLimitBucket = keyof typeof BUCKET_LIMITS;
+/** Счётчик, из которого списывается путь без собственного правила на сервере. */
+declare const DEFAULT_RATE_LIMIT_BUCKET: RateLimitBucket;
+//#endregion
+//#region src/domain/operations.d.ts
+/** Описание встроенной операции: та же форма, что знает ядро, но с именем известного бакета. */
+interface ItdOperationDefinition extends OperationDefinition {
+  readonly bucket?: RateLimitBucket;
+}
+/**
+ * Каталог встроенных операций.
+ *
+ * ID описывает смысл вызова и не меняется при переносе HTTP-пути. Method и retrySafety
+ * хранятся здесь, чтобы resources, retry и плагины не вели независимые таблицы операций.
+ */
+declare const OPERATIONS: Readonly<{
+  readonly 'auth.check': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'auth.signUp': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "auth";
+  }>;
+  readonly 'auth.signIn': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "safe";
+    readonly bucket: "auth";
   }>;
   readonly 'auth.verifyOtp': Readonly<{
     readonly method: "POST";
@@ -406,12 +748,12 @@ declare const OPERATIONS: Readonly<{
     readonly method: "PUT";
     readonly retrySafety: "idempotent";
   }>;
-  readonly 'realtime.poll.updates': Readonly<{
+  readonly 'events.notifications.poll.updates': Readonly<{
     readonly method: "GET";
     readonly retrySafety: "safe";
     readonly bucket: "notifications";
   }>;
-  readonly 'realtime.poll.unread': Readonly<{
+  readonly 'events.notifications.poll.unread': Readonly<{
     readonly method: "GET";
     readonly retrySafety: "safe";
     readonly bucket: "notifications";
@@ -495,10 +837,6 @@ declare const OPERATIONS: Readonly<{
     readonly method: "GET";
     readonly retrySafety: "safe";
   }>;
-  readonly 'platform.status': Readonly<{
-    readonly method: "GET";
-    readonly retrySafety: "safe";
-  }>;
   readonly 'telemetry.dwell': Readonly<{
     readonly method: "POST";
     readonly retrySafety: "unsafe";
@@ -513,7 +851,7 @@ type BuiltInOperationId = keyof typeof OPERATIONS;
 /** Пользовательская семантическая операция низкоуровневого запроса. */
 type CustomOperationId = `custom:${string}`;
 /** ID любого запроса, видимый transformers и hooks. */
-type OperationId = BuiltInOperationId | CustomOperationId | 'raw';
+type OperationId = BuiltInOperationId | FeatureOperationId | CustomOperationId | 'raw';
 /** Проверяет принадлежность ID встроенному каталогу. */
 declare function isBuiltInOperationId(value: string): value is BuiltInOperationId;
 /** HTTP-метод встроенной операции. */
@@ -599,7 +937,7 @@ type QueryValue = string | number | boolean | null | undefined | readonly (strin
 type QueryParams = Record<string, QueryValue>;
 //#endregion
 //#region src/core/options.d.ts
-/** Куда библиотека пишет отладочные сообщения. Совместим с `console`. */
+/** Логгер библиотеки. Совместим с `console`. */
 interface Logger {
   debug(message: string, ...args: unknown[]): void;
   info(message: string, ...args: unknown[]): void;
@@ -631,6 +969,8 @@ interface RetryDecisionContext {
 interface RateLimitBucketOverride {
   /** Одновременных запросов внутри бакета. */
   concurrency?: number | undefined;
+  /** Верхняя граница стартов внутри бакета в секунду. */
+  rps?: number | undefined;
   /** Ёмкость бакета до первого ответа, запросов в минуту. */
   limit?: number | undefined;
 }
@@ -651,8 +991,8 @@ interface RateLimitOptions {
    *
    * `false` — одна очередь на направление: её пауза придерживает все запросы разом.
    * В этом режиме ёмкость отдельного счётчика неизвестна, поэтому `bucketConcurrency`,
-   * `bucketOverrides` и режим `pacing: 'smooth'` не действуют, а исчерпанный остаток
-   * встречается первой ступенью `retryDelays`.
+   * все поля `bucketOverrides` и режим `pacing: 'smooth'` не действуют, а исчерпанный
+   * остаток встречается первой ступенью `retryDelays`. Общий `rps` продолжает действовать.
    */
   buckets?: boolean | undefined;
   /**
@@ -666,7 +1006,7 @@ interface RateLimitOptions {
    *
    * @example
    * ```ts
-   * rateLimit: { bucketOverrides: { 'posts.create': { limit: 10 }, feed: { concurrency: 2 } } }
+   * rateLimit: { bucketOverrides: { 'posts.create': { rps: 2 }, feed: { concurrency: 2 } } }
    * ```
    */
   bucketOverrides?: Record<string, RateLimitBucketOverride> | undefined;
@@ -720,7 +1060,7 @@ interface RetryContext extends RequestContext {
   delay: number;
 }
 /**
- * Перехватчики жизненного цикла запроса.
+ * Хуки запроса.
  *
  * Вызываются последовательно; исключение внутри хука прервёт запрос, поэтому свою логику
  * лучше оборачивать в `try`.
@@ -738,8 +1078,8 @@ interface ClientHooks {
 /**
  * Настройки исполнения запросов: куда ходить, как долго ждать и чем представляться.
  *
- * Всё, что нужно generic-ядру и ничего сверх того. Авторизация и сессия описаны отдельно
- * в {@link SessionOptions}, а полный набор опций клиента их объединяет.
+ * Всё, что нужно generic-ядру и ничего сверх того. Авторизация и сессия описаны отдельно,
+ * а полный набор опций клиента их объединяет.
  *
  * Все поля допускают явный `undefined`, чтобы можно было передавать значения, которых
  * может не быть, — например `new ItdClient({ timeout: process.env.TIMEOUT })`.
@@ -775,921 +1115,338 @@ interface RuntimeOptions {
   /** Таймаут запроса в мс. По умолчанию 30000 — столько же использует сайт итд.com. `0` снимает ограничение. */
   timeout?: number | undefined;
   /**
-   * Сколько `close()` и `dispose()` ждут чужой код, мс. По умолчанию 10000.
-   *
-   * Ждут обработчиков realtime-потока и операций, вошедших в обёртки плагинов. По истечении
-   * срока ресурсы всё равно освобождаются, а метод отклоняется `ItdStateError` с указанием
-   * того, что удерживало остановку. `0` снимает ограничение.
-   */
-  shutdownTimeout?: number | undefined;
-  /** Повторные попытки. `false` отключает их полностью. */
-  retry?: RetryOptions | false | undefined;
-  /** Ограничение нагрузки. `false` отключает очередь. */
-  rateLimit?: RateLimitOptions | false | undefined;
-  /** Своя реализация `fetch`: для Deno, React Native, тестов или прокси. */
-  fetch?: typeof fetch | undefined;
-  /** Часы для тайм-аутов, повторов и очередей. Обычно подменяются только в тестах. */
-  clock?: ItdClock | undefined;
-  /** Как обращаться с cookie. По умолчанию определяется по среде исполнения. */
-  mode?: RuntimeMode | undefined;
-  /** Заголовки, добавляемые ко всем запросам, — например `User-Agent` для бота. */
-  headers?: Record<string, string> | undefined;
-  /**
-   * Значение заголовка `User-Agent`. `false` — не отправлять его вовсе.
-   *
-   * По умолчанию `Mozilla/5.0 (compatible; itd-api/<версия>; …)`: `fetch` в Node не шлёт
-   * `User-Agent` сам, а сайт стоит за DDoS-Guard, который такие запросы может не пропустить.
-   * В браузере опция не действует — там заголовок менять запрещено.
-   */
-  userAgent?: string | false | undefined;
-  /** Перехватчики запросов. */
-  hooks?: ClientHooks | undefined;
-  /** Отладочный вывод. `true` — писать в `console`. */
-  logger?: Logger | boolean | undefined;
-}
-/**
- * Namespaces расширений отдельной операции.
- *
- * Пакеты дополняют интерфейс через declaration merging и владеют только своим полем.
- * Core передаёт объект operation transformers без знания его содержимого.
- */
-interface RequestExtensions {}
-/** Опции выполнения отдельного запроса. Передаются последним аргументом методов ресурсов. */
-interface RequestOptions {
-  /** Отмена запроса извне. */
-  signal?: AbortSignal | undefined;
-  /** Таймаут только для этого запроса, мс. */
-  timeout?: number | undefined;
-  /** Дополнительные заголовки. */
-  headers?: Record<string, string> | undefined;
-  /** Повторы только для этого запроса. Переопределяют глобальную настройку `retry`. */
-  retry?: RetryOptions | false | undefined;
-  /**
-   * Явно переопределяет безопасность повтора операции.
-   *
-   * Встроенные resources получают значение из каталога. Опция нужна прежде всего custom/raw
-   * интеграциям и осознанному переопределению серверного контракта.
-   */
-  retrySafety?: RetrySafety | undefined;
-  /**
-   * Имя бакета, из которого списывается запрос.
-   *
-   * Встроенные resources берут его из каталога операций; низкоуровневый вызов без этой
-   * опции попадает в `default`.
-   *
-   * Имя сверяется со встроенной картой — незнакомое отвергается {@link ItdConfigError}
-   * до отправки, независимо от того, включена ли очередь. Своё правило `rateLimit.bucket`
-   * заводит собственное пространство имён и проверку снимает.
-   */
-  rateLimitBucket?: string | undefined;
-  /** Настройки подключённых operation extensions, сгруппированные по владельцу. */
-  extensions?: RequestExtensions | undefined;
-}
-/** Опции перебора страниц, не являющиеся параметрами endpoint. */
-interface PaginationOptions extends RequestOptions {
-  /** Максимальное число страниц; без значения перебор продолжается до конца списка. */
-  maxPages?: number | undefined;
-}
-/** Полное описание запроса для низкоуровневого `itd.request()`. */
-interface RawRequestOptions extends RequestOptions {
-  /**
-   * Семантическое имя низкоуровневого запроса. Встроенные resources выставляют его сами.
-   * Пользовательские значения следует помещать в namespace `custom:`.
-   */
-  operationId?: OperationId | undefined;
-  method: string;
-  /** Путь с ведущим слэшем, например `/api/posts`. Завершающий слэш значим. */
-  path: string;
-  /**
-   * Имя сервиса, на хост которого уйдёт запрос. Без него запрос идёт на основной `baseUrl`
-   * клиента. Сервисы задаются опцией {@link RuntimeOptions.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;
-  /**
-   * Выполнить запрос мимо очереди.
-   *
-   * Продвинутый escape hatch для служебных интеграций. Встроенные refresh и sign-in проходят
-   * обычную очередь: она охватывает только одну сетевую попытку и не создаёт deadlock.
-   */
-  skipQueue?: boolean | undefined;
-  /** Вернуть тело ответа без снятия обёртки `{ data: … }`. */
-  raw?: boolean | undefined;
-}
-/** Запрос внутри pipeline: в отличие от raw input всегда имеет семантический ID. */
-interface OperationRequestOptions extends RawRequestOptions {
-  operationId: OperationId;
-}
-//#endregion
-//#region src/core/emitter.d.ts
-/** Обработчик события. */
-type Listener<T> = (payload: T) => void;
-/** Функция отписки, которую возвращает подписка на событие. */
-type Unsubscribe = () => void;
-/**
- * Минимальный типизированный источник событий.
- *
- * Своя реализация вместо `EventTarget` и `EventEmitter`: первый есть не везде и требует
- * обёрток `CustomEvent`, второй существует только в Node. Нужны ровно подписка и рассылка.
- *
- * Исключение в обработчике не прерывает рассылку остальным и не роняет библиотеку.
- *
- * @typeParam Events карта «имя события → тип полезной нагрузки». Задаётся интерфейсом,
- * поэтому ограничение на индексную сигнатуру намеренно не накладывается.
- */
-declare class Emitter<Events> {
-  #private;
-  constructor(onListenerError?: (error: unknown) => void);
-  /**
-   * Подписывается на событие.
-   *
-   * @returns функция отписки
-   *
-   * @example
-   * ```ts
-   * const off = realtime.on('notification', (event) => console.log(event));
-   * off();
-   * ```
-   */
-  on<K extends keyof Events>(event: K, listener: Listener<Events[K]>): Unsubscribe;
-  /** Подписывается на одно срабатывание. */
-  once<K extends keyof Events>(event: K, listener: Listener<Events[K]>): Unsubscribe;
-  /** Отписывается от события. */
-  off<K extends keyof Events>(event: K, listener: Listener<Events[K]>): void;
-  /** Рассылает событие подписчикам. */
-  emit<K extends keyof Events>(event: K, payload: Events[K]): void;
-  /** Сколько подписчиков у события. */
-  listenerCount(event: keyof Events): number;
-  /** Снимает все подписки. */
-  removeAllListeners(): void;
-}
-//#endregion
-//#region src/types/enums.d.ts
-/**
- * Перечисления API итд.com.
- *
- * Здесь намеренно не используется `enum` из TypeScript. Вместо него — пара «замороженный
- * объект + одноимённый тип». Такой приём даёт всё, ради чего берут `enum`
- * (`FeedTab.Popular`, перебор значений в рантайме), и при этом:
- *
- * - **стирается без остатка** — `enum` порождает рантайм-код и отвергается средами,
- *   которые просто срезают типы (`node --experimental-strip-types`);
- * - **не запрещает обычные строки** — `itd.posts.list({ tab: 'popular' })` остаётся валидным,
- *   тогда как строковый `enum` считает это ошибкой типа и вынуждает всех импортировать себя;
- * - **позволяет открытые множества** — там, где документация перечисляет значения не полностью,
- *   тип расширяется через {@link Loose}, а объект остаётся справочником известных значений.
- *
- * @example
- * ```ts
- * import { FeedTab } from 'itd-api';
- *
- * await itd.posts.list({ tab: FeedTab.Popular });  // без магических строк
- * await itd.posts.list({ tab: 'popular' });        // и так тоже можно
- *
- * Object.values(FeedTab);                          // ['popular', 'following', 'clan']
- * ```
- *
- * @packageDocumentation
- */
-/**
- * Открытое строковое перечисление.
- *
- * Даёт автодополнение известных значений, но не ломается, если сервер пришлёт новое.
- * Используется там, где документация API перечисляет значения не полностью («`everyone` и др.»).
- */
-type Loose<T extends string> = T | (string & {});
-/**
- * Вкладка ленты `GET /api/posts`.
- *
- * Множество закрытое: неизвестное значение сервер отвергнет.
- */
-declare const FeedTab: Readonly<{
-  /** Популярное. Курсор здесь — номер страницы в виде строки (`"2"`, `"6"`…). */
-  readonly Popular: "popular";
-  /** Записи тех, на кого вы подписаны. Курсор — отметка времени последнего поста. */
-  readonly Following: "following";
-  /** Лента клана. Курсор, как и в подписках, — отметка времени. */
-  readonly Clan: "clan";
-}>;
-type FeedTab = (typeof FeedTab)[keyof typeof FeedTab];
-/** Порядок комментариев к посту. */
-declare const CommentSort: Readonly<{
-  /** Сначала новые. */
-  readonly Newest: "newest";
-  /** Сначала старые. */
-  readonly Oldest: "oldest";
-  /** Сначала популярные. */
-  readonly Popular: "popular";
-}>;
-type CommentSort = (typeof CommentSort)[keyof typeof CommentSort];
-/** Тип вложения. */
-declare const AttachmentType: Readonly<{
-  readonly Image: "image";
-  readonly Video: "video";
-  /** Голосовые комментарии: `audio/ogg`, с полем `duration`. */
-  readonly Audio: "audio";
-}>;
-type AttachmentType = (typeof AttachmentType)[keyof typeof AttachmentType];
-/**
- * Тип фрагмента разметки в тексте поста или комментария.
- *
- * Первые два сервер расставляет сам при разборе текста, остальные приходят от редактора.
- * Тип открытый: набор может пополниться.
- *
- * @example
- * ```ts
- * await itd.posts.update(postId, {
- *   content: 'жирное слово',
- *   spans: [{ type: SpanType.Bold, offset: 0, length: 6 }],
- * });
- * ```
- */
-declare const SpanType: Readonly<{
-  /** Хэштег. Название без решётки лежит в `tag`. */
-  readonly Hashtag: "hashtag";
-  /** Упоминание. Имя пользователя лежит в `tag`. */
-  readonly Mention: "mention";
-  /** Ссылка. Адрес лежит в `url`, а не в `tag`. */
-  readonly Link: "link";
-  readonly Bold: "bold";
-  readonly Italic: "italic";
-  readonly Underline: "underline";
-  /** Зачёркнутый. */
-  readonly Strike: "strike";
-  /** Спойлер: текст скрыт до нажатия. */
-  readonly Spoiler: "spoiler";
-  /** Моноширинный. */
-  readonly Monospace: "monospace";
-  readonly Quote: "quote";
-}>;
-type SpanType = Loose<(typeof SpanType)[keyof typeof SpanType]>;
-/** На что подаётся жалоба. */
-declare const ReportTargetType: Readonly<{
-  readonly Post: "post";
-  readonly Comment: "comment";
-  readonly User: "user";
-}>;
-type ReportTargetType = (typeof ReportTargetType)[keyof typeof ReportTargetType];
-/** Причина жалобы. Множество закрытое. */
-declare const ReportReason: Readonly<{
-  readonly Spam: "spam";
-  readonly Violence: "violence";
-  readonly Hate: "hate";
-  readonly Adult: "adult";
-  readonly Fraud: "fraud";
-  readonly Other: "other";
-}>;
-type ReportReason = (typeof ReportReason)[keyof typeof ReportReason];
-/** Состояние realtime-соединения. */
-declare const RealtimeStatus: Readonly<{
-  readonly Connecting: "connecting";
-  readonly Connected: "connected";
-  readonly Error: "error";
-  readonly Disconnected: "disconnected";
-}>;
-type RealtimeStatus = (typeof RealtimeStatus)[keyof typeof RealtimeStatus];
-/** Состояние сервиса платформы. Тип открытый. */
-declare const ServiceState: Readonly<{
-  /** Работает штатно. */
-  readonly Operational: "operational";
-  /** Работает с деградацией. */
-  readonly Degraded: "degraded";
-  /** Недоступен. */
-  readonly Downtime: "downtime";
-}>;
-type ServiceState = Loose<(typeof ServiceState)[keyof typeof ServiceState]>;
-/** Вид происшествия в истории сервиса. Тип открытый. */
-declare const IncidentKind: Readonly<{
-  /** Недоступен. */
-  readonly Down: "down";
-  /** Деградация. */
-  readonly Degraded: "deg";
-}>;
-type IncidentKind = Loose<(typeof IncidentKind)[keyof typeof IncidentKind]>;
-/**
- * Уровень доступа к разделу профиля.
- *
- * Общий набор значений для полей `wallAccess` и `likesVisibility` настроек приватности.
- * Тип открытый: сервер может прислать значение вне этого перечня.
- */
-declare const AccessType: Readonly<{
-  /** Никто. */
-  readonly Nobody: "nobody";
-  /** Только взаимные подписки. */
-  readonly Mutual: "mutual";
-  /** Подписчики. */
-  readonly Followers: "followers";
-  /** Все. */
-  readonly Everyone: "everyone";
-}>;
-type AccessType = Loose<(typeof AccessType)[keyof typeof AccessType]>;
-/** Кто может писать на стену профиля. Псевдоним {@link AccessType}. */
-declare const WallAccess: Readonly<{
-  /** Никто. */
-  readonly Nobody: "nobody";
-  /** Только взаимные подписки. */
-  readonly Mutual: "mutual";
-  /** Подписчики. */
-  readonly Followers: "followers";
-  /** Все. */
-  readonly Everyone: "everyone";
-}>;
-type WallAccess = AccessType;
-/** Кто видит реакции пользователя. Псевдоним {@link AccessType}. */
-declare const LikesVisibility: Readonly<{
-  /** Никто. */
-  readonly Nobody: "nobody";
-  /** Только взаимные подписки. */
-  readonly Mutual: "mutual";
-  /** Подписчики. */
-  readonly Followers: "followers";
-  /** Все. */
-  readonly Everyone: "everyone";
-}>;
-type LikesVisibility = AccessType;
-/**
- * Канонический тип уведомления (новое поколение имён).
- *
- * REST-эндпоинт `/api/notifications/` отдаёт старые имена (`like`, `comment`, `reply`,
- * `repost`, `mention`), SSE-поток — новые. Библиотека приводит их к этому набору,
- * сохраняя исходное значение в поле `rawType`.
- */
-declare const NotificationType: Readonly<{
-  /** Реакция на пост. Старое имя — `like`. */
-  readonly PostReaction: "post_reaction";
-  /** Комментарий к посту. Старое имя — `comment`. */
-  readonly PostComment: "post_comment";
-  /** Ответ на комментарий. Старое имя — `reply`. */
-  readonly CommentReply: "comment_reply";
-  /** Репост. Старое имя — `repost`. */
-  readonly PostRepost: "post_repost";
-  /** Упоминание в посте. Старое имя — `mention`. */
-  readonly PostMention: "post_mention";
-  /** Реакция на комментарий. */
-  readonly CommentReaction: "comment_reaction";
-  /** Упоминание в комментарии. */
-  readonly CommentMention: "comment_mention";
-  /** Запись на вашей стене. */
-  readonly WallPost: "wall_post";
-  /** На вас подписались. */
-  readonly Follow: "follow";
-  /** Заявка на подписку (закрытый профиль). */
-  readonly FollowRequest: "follow_request";
-  /** Заявка на подписку принята. */
-  readonly FollowAccepted: "follow_accepted";
-  /** Верификация одобрена. Приходит только по REST. */
-  readonly VerificationApproved: "verification_approved";
-  /** Верификация отклонена. Приходит только по REST. */
-  readonly VerificationRejected: "verification_rejected";
-}>;
-type NotificationType = Loose<(typeof NotificationType)[keyof typeof NotificationType]>;
-/**
- * Тип взаимодействия с контентом в телеметрии (`POST /api/v1/x`, поле `t`).
- *
- * Кодируется числом.
- */
-declare const InteractionType: Readonly<{
-  /** Открытие фотографии. */
-  readonly PhotoOpen: 1;
-  /** Прогресс просмотра видео. Несёт поля `pm`/`dm`. */
-  readonly VideoProgress: 2;
-}>;
-type InteractionType = (typeof InteractionType)[keyof typeof InteractionType];
-/**
- * Источник показа поста в телеметрии (поле `s`).
- *
- * Кодируется числом. Поле применимо к источникам `PostPage` и `Link`; для лент источник
- * передаётся контекстом `sc`.
- */
-declare const ViewSource: Readonly<{
-  readonly FeedGlobal: 1;
-  readonly FeedFollowing: 2;
-  readonly FeedClan: 3;
-  readonly Profile: 4;
-  readonly Hashtag: 5;
-  readonly PostPage: 6;
-  readonly Link: 7;
-  readonly Search: 8;
-}>;
-type ViewSource = (typeof ViewSource)[keyof typeof ViewSource];
-/**
- * Причина завершения просмотра поста в телеметрии (`POST /api/v1/i`, поле `r`).
- *
- * Кодируется числом.
- */
-declare const ViewReason: Readonly<{
-  /** Пост ушёл из зоны видимости при обычной прокрутке. */
-  readonly Normal: 0;
-  /** Потеря фокуса окна. */
-  readonly Blur: 1;
-  /** Вкладка скрыта. */
-  readonly Hidden: 2;
-  /** Уход со страницы (`pagehide`). */
-  readonly PageHide: 3;
-  /** Элемент перестал наблюдаться. */
-  readonly Unobserve: 4;
-  /** Достигнут порог времени просмотра. */
-  readonly ThresholdMet: 5;
-}>;
-type ViewReason = (typeof ViewReason)[keyof typeof ViewReason];
-/**
- * Строковые коды ошибок из поля `code`.
- *
- * Ключи намеренно повторяют написание сервера: код из ответа API можно найти здесь
- * поиском один в один, без мысленного перевода регистра.
- *
- * Список открыт — сервер может добавить новый код, и это не должно ломать типизацию.
- *
- * @example
- * ```ts
- * if (err.hasCode(ItdErrorCode.OTP_INVALID)) await restartOtpFlow();
- * ```
- */
-declare const ItdErrorCode: Readonly<{
-  readonly BAD_REQUEST: "BAD_REQUEST";
-  readonly UNAUTHORIZED: "UNAUTHORIZED";
-  readonly ACCESS_DENIED: "ACCESS_DENIED";
-  readonly ENTITY_NOT_FOUND: "ENTITY_NOT_FOUND";
-  readonly ENTITY_ALREADY_EXISTS: "ENTITY_ALREADY_EXISTS";
-  readonly VALIDATION_ERROR: "VALIDATION_ERROR";
-  readonly BUSINESS_RULE_VIOLATION: "BUSINESS_RULE_VIOLATION";
-  readonly RATE_LIMIT_EXCEEDED: "RATE_LIMIT_EXCEEDED";
-  readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
-  /** Сервер отвечает так на `404`, `ENTITY_NOT_FOUND` в этом случае не приходит. */
-  readonly NOT_FOUND: "NOT_FOUND";
-  /** На практике не приходит: вместо него сервер шлёт `TURNSTILE_VERIFICATION_FAILED`. */
-  readonly CAPTCHA_FAILED: "CAPTCHA_FAILED";
-  /** Капча не пройдена: токен Turnstile недействителен, просрочен или уже использован. */
-  readonly TURNSTILE_VERIFICATION_FAILED: "TURNSTILE_VERIFICATION_FAILED";
-  readonly OTP_INVALID: "OTP_INVALID";
-  /** `flowToken` неизвестен или просрочен — поток подтверждения нужно начинать заново. */
-  readonly INVALID_FLOW_TOKEN: "INVALID_FLOW_TOKEN";
-  readonly ACCOUNT_DEACTIVATED: "ACCOUNT_DEACTIVATED";
-  readonly ACCOUNT_EMAIL_DOMAIN_NOT_ALLOWED: "ACCOUNT_EMAIL_DOMAIN_NOT_ALLOWED";
-  readonly ACCOUNT_INVALID_CREDENTIALS: "ACCOUNT_INVALID_CREDENTIALS";
-  readonly ACCOUNT_TEMPORARILY_LOCKED: "ACCOUNT_TEMPORARILY_LOCKED";
-  readonly ACCOUNT_CURRENT_PASSWORD_INCORRECT: "ACCOUNT_CURRENT_PASSWORD_INCORRECT";
-  readonly SESSION_EXPIRED: "SESSION_EXPIRED";
-  readonly SESSION_REVOKED: "SESSION_REVOKED";
-  readonly SESSION_INVALID_REFRESH_TOKEN: "SESSION_INVALID_REFRESH_TOKEN";
-  /** Запрос обновления пришёл без cookie `refresh_token` — продлевать нечего. */
-  readonly REFRESH_TOKEN_MISSING: "REFRESH_TOKEN_MISSING";
-  /** Cookie `refresh_token` есть, но сессии за ней уже нет: отозвана или истекла. */
-  readonly SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
-  readonly MISSING_FLOW_TOKEN: "MISSING_FLOW_TOKEN";
-  readonly PROFILE_USERNAME_TAKEN: "PROFILE_USERNAME_TAKEN";
-  readonly PROFILE_RESTRICTION_ACTIVE: "PROFILE_RESTRICTION_ACTIVE";
-  readonly PROFILE_MODIFICATION_RESTRICTED: "PROFILE_MODIFICATION_RESTRICTED";
-  readonly CONTENT_MODERATION_FAILED: "CONTENT_MODERATION_FAILED";
-  readonly FILE_TOO_LARGE: "FILE_TOO_LARGE";
-  readonly UNSUPPORTED_FILE_TYPE: "UNSUPPORTED_FILE_TYPE";
-  readonly UPLOAD_FAILED: "UPLOAD_FAILED";
-  readonly VIDEO_REQUIRES_VERIFICATION: "VIDEO_REQUIRES_VERIFICATION";
-  readonly PHONE_VERIFICATION_REQUIRED: "PHONE_VERIFICATION_REQUIRED";
-  readonly WRITE_ACCESS_RESTRICTED: "WRITE_ACCESS_RESTRICTED";
-}>;
-type ItdErrorCode = Loose<(typeof ItdErrorCode)[keyof typeof ItdErrorCode]>;
-//#endregion
-//#region src/models/common.d.ts
-/**
- * Дата и время в формате ISO-8601, например `2026-07-21T14:30:00.000Z`.
- *
- * Библиотека не превращает такие поля в `Date`: строку проще сравнивать, логировать
- * и передавать дальше без потерь. Для разбора есть `toDate()`.
- */
-type IsoDate = string;
-/**
- * Идентификатор пользователя — **строго UUID**.
- *
- * Отличается от {@link UserRef} тем, что имя пользователя здесь не подойдёт. Так помечены
- * места, где API принимает только UUID: например `wallRecipientId` при постинге на чужую стену.
- */
-type UserId = string;
-/**
- * Ссылка на пользователя: **UUID либо имя пользователя**.
- *
- * Пути вида `/api/users/{id}` принимают оба варианта, поэтому `itd.users.get('nowkie')`
- * работает так же, как `itd.users.get('9f1c…')`.
- */
-type UserRef = string;
-/**
- * Разметка в тексте поста или комментария.
- *
- * `offset` и `length` измеряются в UTF-16 code units: это те же индексы, которые используют
- * `String#slice`, `substring` и DOM Selection в JavaScript. Эмодзи вне BMP обычно занимают
- * две единицы.
- */
-interface Span {
-  /** Тип фрагмента — см. {@link SpanType}. */
-  type: SpanType;
-  /** Смещение от начала текста. */
-  offset: number;
-  /** Длина фрагмента. */
-  length: number;
-  /** Имя хэштега без решётки. У старых mention-объектов может содержать username. */
-  tag?: string;
-  /** Адрес ссылки. Только у `link`: у него вместо `tag` отдельное поле. */
-  url?: string;
-  /** Имя пользователя у `mention`. */
-  username?: string;
-  /** Идентификатор пользователя у некоторых ответов API с `mention`. */
-  id?: string;
-}
-//#endregion
-//#region src/core/version.d.ts
-/** Версия библиотеки. Попадает в `User-Agent`. */
-declare const LIBRARY_VERSION = "0.7.1";
-//#endregion
-//#region src/core/config.d.ts
-/** Базовый URL API итд.com. Домен записан в punycode: `итд.com`. */
-declare const DEFAULT_BASE_URL = "https://xn--d1ah4a.com";
-/** Имя встроенного сервиса статуса. */
-declare const STATUS_SERVICE = "status";
-//#endregion
-//#region src/core/auth-provider.d.ts
-/** Области аккаунта и конкретной сессии для локального состояния плагинов. */
-interface AuthIdentity {
-  /** Идентификатор пользователя; отсутствует у непрозрачного или повреждённого токена. */
-  userId?: UserId | undefined;
-  /** Идентификатор серверной сессии; отсутствует у непрозрачного или повреждённого токена. */
-  sessionId?: string | undefined;
+   * Сколько `close()` и `dispose()` ждут чужой код, мс. По умолчанию 10000.
+   *
+   * Ждут обработчиков событийного канала и операций, вошедших в обёртки плагинов. По истечении
+   * срока ресурсы всё равно освобождаются, а метод отклоняется `ItdStateError` с указанием
+   * того, что удерживало остановку. `0` снимает ограничение.
+   */
+  shutdownTimeout?: number | undefined;
+  /** Повторные попытки. `false` отключает их полностью. */
+  retry?: RetryOptions | false | undefined;
+  /** Ограничение нагрузки. `false` отключает очередь. */
+  rateLimit?: RateLimitOptions | false | undefined;
+  /** Своя реализация `fetch`: для Deno, React Native, тестов или прокси. */
+  fetch?: typeof fetch | undefined;
+  /** Часы для тайм-аутов, повторов и очередей. Обычно подменяются только в тестах. */
+  clock?: ItdClock | undefined;
+  /** Как обращаться с cookie. По умолчанию определяется по среде исполнения. */
+  mode?: RuntimeMode | undefined;
+  /** Заголовки, добавляемые ко всем запросам, — например `User-Agent` для бота. */
+  headers?: Record<string, string> | undefined;
+  /**
+   * Значение заголовка `User-Agent`. `false` — не отправлять его вовсе.
+   *
+   * По умолчанию `Mozilla/5.0 (compatible; itd-api/<версия>; …)`: `fetch` в Node не шлёт
+   * `User-Agent` сам, а сайт стоит за DDoS-Guard, который такие запросы может не пропустить.
+   * В браузере опция не действует — там заголовок менять запрещено.
+   */
+  userAgent?: string | false | undefined;
+  /** Хуки запросов. */
+  hooks?: ClientHooks | undefined;
+  /** Логгер. `true` — использовать `console`. */
+  logger?: Logger | boolean | undefined;
 }
 /**
- * Что конвейер запросов спрашивает у авторизации.
- *
- * Узкий контракт вместо полноценного менеджера сессии: pipeline не должен знать ни про
- * refresh-токены, ни про хранилище, ни про вход по паролю. Благодаря этому клиент с готовым
- * токеном не тянет за собой сессионную машинерию — она подставляется вызывающим кодом.
+ * Настройки плагинов для отдельной операции.
  *
- * Каждый метод соответствует ровно одной стадии конвейера. Готовые реализации —
- * {@link bearerToken}, {@link tokenProvider} и {@link anonymousAuth}.
+ * Пакеты дополняют интерфейс и используют отдельные именованные поля.
  */
-interface AuthProvider {
+interface RequestExtensions {}
+/** Опции выполнения отдельного запроса. Передаются последним аргументом методов ресурсов. */
+interface RequestOptions {
+  /** Отмена запроса извне. */
+  signal?: AbortSignal | undefined;
+  /** Таймаут только для этого запроса, мс. */
+  timeout?: number | undefined;
+  /** Дополнительные заголовки. */
+  headers?: Record<string, string> | undefined;
+  /** Повторы только для этого запроса. Переопределяют глобальную настройку `retry`. */
+  retry?: RetryOptions | false | undefined;
   /**
-   * Текущий токен доступа.
+   * Явно переопределяет безопасность повтора операции.
    *
-   * Нужен там, где заголовок не поставить: SSE в браузере и WebSocket передают токен
-   * параметром адреса. Конвейеру запросов достаточно {@link currentHeaders}.
+   * Встроенные ресурсы получают значение из каталога. Опция предназначена для произвольных
+   * запросов.
    */
-  token(): Promise<string | null>;
+  retrySafety?: RetrySafety | undefined;
   /**
-   * Готовит состояние авторизации до входа транспортной попытки в очередь.
+   * Имя бакета, из которого списывается запрос.
    *
-   * Чтение хранилища, обращение к внешнему источнику токена и отложенный вход асинхронны,
-   * поэтому обязаны завершиться до захвата слота очереди.
+   * Встроенные ресурсы берут его из каталога операций; низкоуровневый вызов без этой
+   * опции попадает в `default`.
+   *
+   * Имя сверяется со встроенной картой — незнакомое отвергается {@link ItdConfigError}
+   * до отправки, независимо от того, включена ли очередь. Своё правило `rateLimit.bucket`
+   * заводит собственное пространство имён и проверку снимает.
    */
-  prepare(): Promise<void>;
+  rateLimitBucket?: string | undefined;
+  /** Настройки подключённых плагинов. */
+  extensions?: RequestExtensions | undefined;
+}
+/** Опции перебора страниц, не являющиеся параметрами метода API. */
+interface PaginationOptions extends RequestOptions {
+  /** Максимальное число страниц; без значения перебор продолжается до конца списка. */
+  maxPages?: number | undefined;
+}
+/** Полное описание запроса для низкоуровневого `itd.request()`. */
+interface RawRequestOptions extends RequestOptions {
   /**
-   * Заголовки уже подготовленной авторизации.
+   * Имя низкоуровневого запроса. Встроенные ресурсы задают его сами.
+   * Пользовательские значения должны начинаться с `custom:`.
+   */
+  operationId?: OperationId | undefined;
+  method: string;
+  /** Путь с ведущим слэшем, например `/api/posts`. Завершающий слэш значим. */
+  path: string;
+  /**
+   * Имя сервиса, на хост которого уйдёт запрос. Без него запрос идёт на основной `baseUrl`
+   * клиента. Сервисы задаются опцией {@link RuntimeOptions.services}.
+   */
+  service?: string | undefined;
+  /**
+   * Хост этого запроса. Важнее, чем {@link RawRequestOptions.service}.
    *
-   * Синхронность существенна: слой стоит внутри очереди, непосредственно перед транспортом,
-   * и не должен запускать I/O. Зато запрос, отстоявший в очереди, получает самый свежий токен.
+   * На посторонний основному API хост Bearer-токен по умолчанию не отправляется.
+   * Для осознанного разрешения укажите `skipAuth: false`.
    */
-  currentHeaders(): Record<string, string>;
+  baseUrl?: string | undefined;
+  query?: QueryParams | undefined;
+  /** Тело: будет отправлено как JSON. Для загрузки файлов передайте `FormData`. */
+  body?: unknown;
   /**
-   * Реакция на ответ `401`.
+   * Не подставлять заголовок авторизации.
    *
-   * @returns `true`, если токен обновлён и повторять попытку имеет смысл
+   * Явное `false` разрешает авторизацию и для разового внешнего `baseUrl`; без него
+   * токен автоматически отправляется только основному хосту и его поддоменам.
    */
-  recover(): Promise<boolean>;
-  /** Значение заголовка `X-Device-Id`. Отправляется и с анонимными запросами. */
-  deviceId(): Promise<string>;
-  /** Снимает подписки при терминальном освобождении владельца. */
-  dispose(): void;
-}
-/**
- * Авторизации нет: заголовок не подставляется, ответ `401` не восстанавливается.
- *
- * @example
- * ```ts
- * const api = createRestClient(); // публичные эндпоинты доступны и без токена
- * ```
- */
-declare function anonymousAuth(): AuthProvider;
-/**
- * Готовый Bearer-токен: ни хранилища, ни продления.
- *
- * Ответ `401` уходит вызывающему коду как есть — обновить токен провайдеру нечем.
- * Для сессии, которая продлевает себя сама, нужен полный клиент.
- *
- * @example
- * ```ts
- * const api = createRestClient({ auth: bearerToken(process.env.ITD_TOKEN) });
- * ```
- */
-declare function bearerToken(accessToken: string): AuthProvider;
-/**
- * Токен из внешнего источника — хранилища секретов, кэша, соседнего сервиса.
- *
- * Источник спрашивается на стадии подготовки, до входа в очередь: там ожидание безопасно,
- * а слот транспорта ещё не занят. Значение держится до следующей подготовки, потому что
- * подстановка заголовков обязана быть синхронной.
- *
- * @example
- * ```ts
- * const api = createRestClient({ auth: tokenProvider(() => vault.read('itd')) });
- * ```
- */
-declare function tokenProvider(getToken: () => string | null | Promise<string | null>): AuthProvider;
-//#endregion
-//#region src/models/users.d.ts
-/** Значок-«пин» в профиле — награда или отметка платформы. */
-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;
+  skipAuth?: boolean | undefined;
+  /** Не пытаться обновить токен при `401` — используется самими эндпоинтами авторизации. */
+  skipAuthRefresh?: boolean | undefined;
   /**
-   * **Эмодзи, а не картинка.**
+   * Выполнить запрос мимо очереди.
    *
-   * На итд.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;
-  /** URL изображения баннера либо `null`. */
-  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;
+  skipQueue?: boolean | undefined;
+  /** Вернуть тело ответа без снятия обёртки `{ data: … }`. */
+  raw?: boolean | undefined;
 }
-/**
- * Состояние авторизации — ответ `GET /api/profile`.
- *
- * Endpoint доступен без сессии: в этом случае `authenticated` равен `false`,
- * а `user` — `null`.
- */
-interface AuthState {
-  /** Есть ли действующая сессия. */
-  authenticated: boolean;
-  /** Заблокирован ли текущий аккаунт. */
-  banned: boolean;
-  /** Текущий пользователь либо `null` без действующей сессии. */
-  user: MyProfile | null;
+/** Подготовленный запрос с обязательным идентификатором операции. */
+interface OperationRequestOptions extends RawRequestOptions {
+  operationId: OperationId;
+}
+//#endregion
+//#region src/core/operation.d.ts
+/** HTTP-метод операции. */
+type OperationMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+/** ID операции подключаемого модуля: `<featureName>.<operationName>`. */
+type FeatureOperationId<TFeatureName extends string = string, TOperationName extends string = string> = `${TFeatureName}.${TOperationName}`;
+/** Семантическая безопасность автоматического повтора операции. */
+declare const RetrySafety: Readonly<{
+  /** Автоматический повтор не создаёт неприемлемого эффекта; обычно это чтение. */
+  readonly Safe: "safe";
+  /** Повтор операции приводит к тому же состоянию, что и один вызов. */
+  readonly Idempotent: "idempotent";
+  /** Повтор может создать ещё один побочный эффект. */
+  readonly Unsafe: "unsafe";
+}>;
+type RetrySafety = (typeof RetrySafety)[keyof typeof RetrySafety];
+/** Расширяемые метаданные операции. Плагины добавляют собственные поля. */
+interface OperationAnnotations {}
+/** Публичные неизменяемые метаданные семантической операции. */
+interface OperationMetadata {
+  readonly method: OperationMethod;
+  readonly retrySafety: RetrySafety;
+  readonly bucket?: string;
+  readonly annotations?: Readonly<OperationAnnotations>;
 }
 /**
- * Чужой профиль — ответ `GET /api/users/{id|username}`.
+ * Контракт результата одного HTTP-запроса.
  *
- * Вместо своей подписки содержит связь с вами и присутствие.
+ * Функция чтения принадлежит исполнителю и не входит в API плагинов. Все вызовы одного `id`
+ * используют один контракт, поэтому форма результата не зависит от места вызова.
  */
-interface PublicProfile extends ProfileBase {
-  hasNuksta?: boolean;
-  /** Закреплённый пост, если он есть. */
-  pinnedPostId: string | null;
-  /** Подписаны ли вы на него. */
-  isFollowing: boolean;
-  /** Подписан ли он на вас. */
-  isFollowedBy: boolean;
-  /** Сейчас ли пользователь в сети. */
-  online: boolean;
-  /** Когда был в сети. `null`, если скрыто настройками приватности. */
-  lastSeen: IsoDate | null;
-}
-/** Профиль: свой либо чужой. Различаются функцией `isMyProfile()`. */
-type Profile = MyProfile | PublicProfile;
-/** Настройки приватности профиля. */
-interface PrivacySettings {
-  /** Закрыт ли профиль: подписка требует одобрения. */
-  isPrivate: boolean;
-  wallAccess: WallAccess;
-  likesVisibility: LikesVisibility;
-  /** Показывать ли время последнего посещения. */
-  showLastSeen: boolean;
+interface OperationContract<T = unknown, TId extends string = string> extends OperationMetadata {
+  readonly id: TId;
+  /** Преобразует разобранное тело HTTP-ответа в результат операции. @internal */
+  readonly read: (body: unknown, request: Readonly<OperationRequestOptions>) => T;
 }
 /**
- * Результат подписки на пользователя.
+ * Минимальное стабильное описание операции, доступное core и плагинам.
  *
- * @example
- * ```ts
- * const result = await itd.users.follow('nowkie');
- * // { following: true, followersCount: 11 }
- * ```
+ * Форма описания принадлежит ядру; заполненный ими каталог — доменному слою.
  */
-interface FollowResult {
-  /** Подписка оформлена. У закрытого профиля отправляется заявка, и здесь будет `false`. */
-  following: boolean;
-  /** Сколько подписчиков стало у пользователя после действия. */
-  followersCount?: number;
-  /** Статус заявки, если профиль закрыт. */
-  status?: Loose<'following' | 'requested'>;
-}
-/** Закреплённые значки профиля и выбранный из них. */
-interface PinsResult {
-  pins: Pin[];
-  /** Идентификатор активного значка — строка, а не объект. */
-  activePin: string | null;
+interface OperationDefinition extends OperationMetadata {
+  /**
+   * Бакет операции. Опущено — операция списывает из бакета по умолчанию.
+   *
+   * Счётчик определяется парой «путь + метод»: `GET /api/users/me` — 40 запросов
+   * в минуту, `PUT` того же пути — 3, `DELETE` — 150.
+   */
+  readonly bucket?: string;
 }
 //#endregion
-//#region src/models/notifications.d.ts
+//#region src/core/version.d.ts
+/** Версия библиотеки. Попадает в `User-Agent`. */
+declare const LIBRARY_VERSION = "0.8.0";
+//#endregion
+//#region src/core/config.d.ts
+/** Базовый URL API итд.com. Домен записан в punycode: `итд.com`. */
+declare const DEFAULT_BASE_URL = "https://xn--d1ah4a.com";
+/** Имя встроенного сервиса статуса. */
+declare const STATUS_SERVICE = "status";
+//#endregion
+//#region src/core/emitter.d.ts
+/** Обработчик события. */
+type Listener<T> = (payload: T) => void;
+/** Функция отписки, которую возвращает подписка на событие. */
+type Unsubscribe = () => void;
 /**
- * Уведомление в единой форме.
+ * Минимальный типизированный источник событий.
  *
- * REST-список и SSE-поток отдают уведомления по-разному — разные имена типов, разные имена
- * полей, один участник против массива. Библиотека приводит оба вида к этой структуре,
- * поэтому объекты из `itd.notifications.list()` и из потока можно складывать в один список.
+ * Своя реализация вместо `EventTarget` и `EventEmitter`: первый есть не везде и требует
+ * обёрток `CustomEvent`, второй существует только в Node. Нужны ровно подписка и рассылка.
  *
- * Исходные данные не теряются: серверное имя типа остаётся в {@link rawType},
- * а весь необработанный объект — в {@link raw}.
+ * Исключение в обработчике не прерывает рассылку остальным и не роняет библиотеку.
+ *
+ * @typeParam Events карта «имя события → тип полезной нагрузки». Задаётся интерфейсом,
+ * поэтому ограничение на индексную сигнатуру намеренно не накладывается.
  */
-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;
+declare class Emitter<Events> {
+  #private;
+  constructor(onListenerError?: (error: unknown) => void);
+  /**
+   * Подписывается на событие.
+   *
+   * @returns функция отписки
+   *
+   * @example
+   * ```ts
+   * const off = events.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;
+}
+//#endregion
+//#region src/core/auth-provider.d.ts
+/** Области аккаунта и конкретной сессии для локального состояния плагинов. */
+interface AuthIdentity {
+  /** Идентификатор пользователя; отсутствует у непрозрачного или повреждённого токена. */
+  userId?: UserId | undefined;
+  /** Идентификатор серверной сессии; отсутствует у непрозрачного или повреждённого токена. */
+  sessionId?: string | undefined;
 }
 /**
- * Настройки уведомлений.
+ * Что конвейер запросов спрашивает у авторизации.
  *
- * Сервер отдаёт плоский объект, но исторически знает два набора имён для одних и тех же
- * настроек (`likes` и `reactions`, `comments` и `replies`). При сохранении библиотека
- * отправляет оба, при чтении принимает любой.
+ * Узкий контракт вместо полноценного менеджера сессии: pipeline не должен знать ни про
+ * refresh-токены, ни про хранилище, ни про вход по паролю. Благодаря этому клиент с готовым
+ * токеном не тянет за собой сессионную машинерию — она подставляется вызывающим кодом.
+ *
+ * Каждый метод соответствует ровно одной стадии конвейера. Готовые реализации —
+ * `bearerToken()`, `tokenProvider()` и `anonymousAuth()`.
  */
-interface NotificationSettings {
-  /** Общий выключатель доставки. */
-  enabled: boolean;
-  /** Звук уведомления. */
-  sound: boolean;
-  /** Новые подписчики. */
-  follows: boolean;
-  /** Записи на вашей стене. */
-  wallPosts: boolean;
-  /** Реакции на ваши записи. */
-  likes: boolean;
-  /** Комментарии и ответы. */
-  comments: boolean;
-  /** Упоминания. */
-  mentions: boolean;
-}
-//#endregion
-//#region src/notifications/normalize.d.ts
-/** Событие потока уведомлений после разбора. */
-interface NotificationEvent {
-  /** Само уведомление в единой форме. */
-  notification: Notification;
+interface AuthProvider {
   /**
-   * Актуальное число непрочитанных, если сервер его сообщил.
+   * Текущий токен доступа.
    *
-   * Клиент не увеличивает счётчик сам: значение приходит с сервера.
+   * Нужен там, где заголовок не поставить: SSE в браузере и WebSocket передают токен
+   * параметром адреса. Конвейеру запросов достаточно {@link currentHeaders}.
    */
-  unreadCount: number | undefined;
-  /** Нужно ли проиграть звук. */
-  sound: boolean;
+  token(): Promise<string | null>;
+  /**
+   * Готовит состояние авторизации до входа транспортной попытки в очередь.
+   *
+   * Чтение хранилища, обращение к внешнему источнику токена и отложенный вход асинхронны,
+   * поэтому обязаны завершиться до захвата слота очереди.
+   */
+  prepare(): Promise<void>;
+  /**
+   * Заголовки уже подготовленной авторизации.
+   *
+   * Синхронность существенна: слой стоит внутри очереди, непосредственно перед транспортом,
+   * и не должен запускать I/O. Зато запрос, отстоявший в очереди, получает самый свежий токен.
+   */
+  currentHeaders(): Record<string, string>;
+  /**
+   * Реакция на ответ `401`.
+   *
+   * @returns `true`, если токен обновлён и повторять попытку имеет смысл
+   */
+  recover(): Promise<boolean>;
+  /** Значение заголовка `X-Device-Id`. Отправляется и с анонимными запросами. */
+  deviceId(): Promise<string>;
+  /** Снимает подписки при терминальном освобождении владельца. */
+  dispose(): void;
 }
 /**
- * Приводит уведомление к единой форме.
+ * Авторизации нет: заголовок не подставляется, ответ `401` не восстанавливается.
  *
- * Нужна потому, что REST-список и поток событий описывают одно и то же событие по-разному:
- * различаются имена типов (`like` против `post_reaction`), имена полей
- * (`targetId`/`entityId`, `read`/`isRead`, `preview`/`entityPreview`) и число участников
- * (`actor` против массива `actors`). После приведения объекты из обоих источников
- * можно складывать в один список.
+ * @example
+ * ```ts
+ * const api = createRestClient(); // публичные эндпоинты доступны и без токена
+ * ```
+ */
+declare function anonymousAuth(): AuthProvider;
+/**
+ * Готовый Bearer-токен: ни хранилища, ни продления.
+ *
+ * Ответ `401` уходит вызывающему коду как есть — обновить токен провайдеру нечем.
+ * Для сессии, которая продлевает себя сама, нужен полный клиент.
  *
- * Исходные данные не теряются: имя типа с сервера остаётся в `rawType`,
- * весь объект целиком — в `raw`.
+ * @example
+ * ```ts
+ * const api = createRestClient({ auth: bearerToken(process.env.ITD_TOKEN) });
+ * ```
+ */
+declare function bearerToken(accessToken: string): AuthProvider;
+/**
+ * Токен из внешнего источника — хранилища секретов, кэша, соседнего сервиса.
  *
- * @param input уведомление из REST-ответа либо полезная нагрузка события потока
+ * Источник спрашивается на стадии подготовки, до входа в очередь: там ожидание безопасно,
+ * а слот транспорта ещё не занят. Значение держится до следующей подготовки, потому что
+ * подстановка заголовков обязана быть синхронной.
  *
  * @example
  * ```ts
- * const fromRest = normalizeNotification(restItem);
- * const fromStream = normalizeNotification(event.payload);
- * // одинаковая форма — можно объединять
+ * const api = createRestClient({ auth: tokenProvider(() => vault.read('itd')) });
  * ```
  */
-declare function normalizeNotification(input: unknown): Notification;
+declare function tokenProvider(getToken: () => string | null | Promise<string | null>): AuthProvider;
+//#endregion
+//#region src/core/connection.d.ts
+/**
+ * Разрешённое окружение одного долговременного соединения клиента.
+ *
+ * Синхронизационные запросы выполняются через адаптер предметного модуля.
+ */
+interface ClientConnection {
+  /** Фактический HTTP(S)-адрес сервиса с учётом настроек клиента. */
+  readonly baseUrl: string;
+  /** Разрешено ли соединению передавать Bearer-токен этому сервису. */
+  readonly authorize: boolean;
+  readonly fetch: typeof fetch;
+  readonly clock: ItdClock;
+  readonly logger: Logger | undefined;
+  /** Заголовки платформы и сервиса без Bearer-токена. */
+  baseHeaders(url: string): Promise<Headers>;
+  /** Текущий токен; способ его передачи выбирает транспорт. */
+  getToken(): Promise<string | null>;
+  /** Пытается восстановить авторизацию после отказа транспорта. */
+  refreshAuth(): Promise<boolean>;
+}
 //#endregion
 //#region src/core/errors.d.ts
 /** Бренд, по которому ошибки библиотеки распознаются надёжнее, чем через `instanceof`. */
@@ -1763,268 +1520,549 @@ declare class ItdError extends Error {
     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;
+/** Параметры конструктора {@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);
+}
+/** Причина ошибки получения вложения. */
+declare const ItdFileErrorReason: Readonly<{
+  /** Сетевой сбой при получении источника. */
+  readonly Network: "network";
+  /** Источник ответил ошибочным HTTP-статусом. */
+  readonly Http: "http";
+  /** Источник превысил разрешённый размер. */
+  readonly TooLarge: "too_large";
+  /** Среда или источник не предоставили поток. */
+  readonly StreamUnavailable: "stream_unavailable";
+  /** Поток источника завершился ошибкой. */
+  readonly Read: "read";
+}>;
+type ItdFileErrorReason = (typeof ItdFileErrorReason)[keyof typeof ItdFileErrorReason];
+/** Не удалось получить или прочитать содержимое вложения. */
+declare class ItdFileError extends ItdError {
+  readonly reason: ItdFileErrorReason;
+  /** Адрес источника без секретных параметров запроса, если файл получался по сети. */
+  readonly url: string | undefined;
+  /** HTTP-статус источника. */
+  readonly status: number | undefined;
+  /** Разрешённый размер в байтах. */
+  readonly limit: number | undefined;
+  /** Обнаруженный размер в байтах. */
+  readonly actual: number | undefined;
+  /** Имеет ли смысл повторить получение источника. */
+  readonly retryable: boolean;
+  constructor(message: string, init: {
+    reason: ItdFileErrorReason;
+    url?: string | undefined;
+    status?: number | undefined;
+    limit?: number | undefined;
+    actual?: number | undefined;
+    retryable?: boolean | undefined;
+    cause?: unknown;
+  });
+}
+/** Запрос не дошёл до сервера: 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, options?: {
+    cause?: unknown;
+  });
+}
+/**
+ * Операция невозможна в текущем состоянии объекта.
+ *
+ * Например, клиент уже окончательно освобождён через `dispose()` и не может выполнять
+ * новые запросы или создавать событийные соединения.
+ */
+declare class ItdStateError extends ItdError {
+  constructor(message: string, options?: {
+    cause?: unknown;
+  });
+}
+/**
+ * Некорректная конфигурация или аргументы — обнаружено до обращения к сети.
+ *
+ * Этим же классом сообщают о нарушенных инвариантах билдеры: например, опрос
+ * с одним вариантом ответа.
+ */
+declare class ItdConfigError extends ItdError {
+  constructor(message: string, options?: {
+    cause?: unknown;
+  });
+}
+/** Любая ошибка, порождённая этой библиотекой. */
+declare function isItdError(value: unknown): value is ItdError;
+/** Ошибка, пришедшая от сервера итд.com (статус ≥ 400). */
+declare function isItdApiError(value: unknown): value is ItdApiError;
+/** Ошибка получения или чтения вложения. */
+declare function isItdFileError(value: unknown): value is ItdFileError;
+/** Операция невозможна в текущем состоянии объекта. */
+declare function isItdStateError(value: unknown): value is ItdStateError;
+/** Ошибка валидации: `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;
+//#endregion
+//#region src/models/users.d.ts
+/** Значок-«пин» в профиле — награда или отметка платформы. */
+interface Pin {
+  /** Постоянный идентификатор, например `epepuy_202605_59`. */
+  slug: string;
+  /** Отображаемое название. */
+  name: string;
+  /** Описание, за что выдан. */
+  description: string;
+  /** Адрес изображения. */
+  url: string;
+  /** Когда выдан. Приходит только в списке своих пинов. */
+  grantedAt?: IsoDate;
 }
 /**
- * Ошибка, возвращённая сервером итд.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); // ['Имя уже занято']
- *   }
- * }
- * ```
+ * Встречается внутри `post.author` и `comment.author`.
  */
-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);
+interface Author {
+  id: UserId;
+  username: string;
+  displayName: string;
   /**
-   * Проверяет код ошибки. Удобнее, чем сравнивать строки вручную.
+   * **Эмодзи, а не картинка.**
    *
-   * @example
-   * ```ts
-   * if (err.hasCode('OTP_INVALID', 'MISSING_FLOW_TOKEN')) await restartOtpFlow();
-   * ```
+   * На итд.com аватар — это символ клана (`🩵`, `🦎`), а не адрес изображения.
+   * Отрисовывать его нужно как текст.
    */
-  hasCode(...codes: ItdErrorCode[]): boolean;
-  /** Имеет ли смысл повторить запрос: `429` и серверные ошибки `5xx`. */
-  get isRetryable(): boolean;
+  avatar: string;
+  /** Пройдена ли верификация. */
+  verified: boolean;
+  /** Активный значок профиля. Может отсутствовать. */
+  pin?: Pin | null;
+  /** Есть ли премиум-подписка (значок NUKSTA). */
+  hasNuksta?: boolean;
 }
-/** `400` / `422` — данные не прошли валидацию. Подробности в {@link ItdApiError.fieldErrors}. */
-declare class ItdValidationError extends ItdApiError {
-  constructor(init: ItdApiErrorInit);
+/**
+ * Участник события в уведомлении.
+ *
+ * Отличается от {@link Author} набором полей: вместо значков приходит связь с вами.
+ */
+interface Actor {
+  id: UserId;
+  username: string;
+  displayName: string;
+  /** Эмодзи-аватар, см. {@link Author.avatar}. */
+  avatar: string;
+  /** Подписаны ли вы на этого пользователя. */
+  isFollowing?: boolean;
+  /** Подписан ли он на вас. */
+  isFollowedBy?: boolean;
 }
-/** `401` — токен отсутствует, истёк или отозван. */
-declare class ItdAuthError extends ItdApiError {
-  constructor(init: ItdApiErrorInit);
+/**
+ * Пользователь в списках.
+ *
+ * Набор полей зависит от эндпоинта: подписчики и подписки приносят `isFollowing`,
+ * поиск и рекомендации — `followersCount` и `hasNuksta`. Необязательные поля отражают
+ * это различие.
+ */
+interface UserSummary {
+  id: UserId;
+  username: string;
+  displayName: string;
+  /** Эмодзи-аватар, см. {@link Author.avatar}. */
+  avatar: string;
+  verified: boolean;
+  /** Подписаны ли вы. Приходит в списках подписчиков и подписок. */
+  isFollowing?: boolean;
+  /** Есть ли премиум. Приходит в поиске и рекомендациях. */
+  hasNuksta?: boolean;
+  /** Число подписчиков. Приходит в поиске и рекомендациях. */
+  followersCount?: number;
 }
-/** `403` — доступ запрещён либо действие ограничено настройками приватности. */
-declare class ItdForbiddenError extends ItdApiError {
-  constructor(init: ItdApiErrorInit);
+/** Поля профиля, общие для своего и чужого. */
+interface ProfileBase {
+  id: UserId;
+  username: string;
+  displayName: string;
+  /** Эмодзи-аватар, см. {@link Author.avatar}. */
+  avatar: string;
+  /** URL изображения баннера либо `null`. */
+  banner: string | null;
+  /** Описание профиля. */
+  bio: string;
+  verified: boolean;
+  pin?: Pin | null;
+  /** Кто может писать на стену. */
+  wallAccess: WallAccess;
+  /** Кто видит реакции. */
+  likesVisibility: LikesVisibility;
+  followersCount: number;
+  followingCount: number;
+  postsCount: number;
+  createdAt: IsoDate;
 }
-/** `404` — сущность не найдена. */
-declare class ItdNotFoundError extends ItdApiError {
-  constructor(init: ItdApiErrorInit);
+/** Состояние подписки на премиум. */
+interface SubscriptionState {
+  isActive: boolean;
+  expiresAt: IsoDate | null;
+  autoRenewal: boolean;
 }
-/** `409` — сущность уже существует. */
-declare class ItdConflictError extends ItdApiError {
-  constructor(init: ItdApiErrorInit);
+/**
+ * Свой профиль — ответ `GET /api/users/me`.
+ *
+ * Отличается от чужого наличием {@link subscription} и {@link isPhoneVerified}
+ * и отсутствием полей связи (`isFollowing`, `online`).
+ */
+interface MyProfile extends ProfileBase {
+  /** Закрыт ли профиль. */
+  isPrivate: boolean;
+  /** Подтверждён ли телефон. Без него часть действий недоступна. */
+  isPhoneVerified: boolean;
+  /** Своя премиум-подписка. */
+  subscription: SubscriptionState;
+}
+/**
+ * Состояние авторизации — ответ `GET /api/profile`.
+ *
+ * Endpoint доступен без сессии: в этом случае `authenticated` равен `false`,
+ * а `user` — `null`.
+ */
+interface AuthState {
+  /** Есть ли действующая сессия. */
+  authenticated: boolean;
+  /** Заблокирован ли текущий аккаунт. */
+  banned: boolean;
+  /** Текущий пользователь либо `null` без действующей сессии. */
+  user: MyProfile | null;
 }
 /**
- * `429` — превышен лимит запросов.
+ * Чужой профиль — ответ `GET /api/users/{id|username}`.
  *
- * Если сервер прислал `Retry-After`, пауза доступна в {@link ItdApiError.retryAfter}
- * (в миллисекундах). При включённых ретраях библиотека выдерживает её автоматически.
+ * Вместо своей подписки содержит связь с вами и присутствие.
  */
-declare class ItdRateLimitError extends ItdApiError {
-  constructor(init: ItdApiErrorInit);
+interface PublicProfile extends ProfileBase {
+  hasNuksta?: boolean;
+  /** Закреплённый пост, если он есть. */
+  pinnedPostId: string | null;
+  /** Подписаны ли вы на него. */
+  isFollowing: boolean;
+  /** Подписан ли он на вас. */
+  isFollowedBy: boolean;
+  /** Сейчас ли пользователь в сети. */
+  online: boolean;
+  /** Когда был в сети. `null`, если скрыто настройками приватности. */
+  lastSeen: IsoDate | null;
+}
+/** Профиль: свой либо чужой. Различаются функцией `isMyProfile()`. */
+type Profile = MyProfile | PublicProfile;
+/** Настройки приватности профиля. */
+interface PrivacySettings {
+  /** Закрыт ли профиль: подписка требует одобрения. */
+  isPrivate: boolean;
+  wallAccess: WallAccess;
+  likesVisibility: LikesVisibility;
+  /** Показывать ли время последнего посещения. */
+  showLastSeen: boolean;
 }
 /**
- * Действие требует подтверждённого телефона (`PHONE_VERIFICATION_REQUIRED`).
+ * Результат подписки на пользователя.
  *
- * Подтверждение проходит через Telegram-бота: ссылка лежит в {@link verificationUrl}.
+ * @example
+ * ```ts
+ * const result = await itd.users.follow('nowkie');
+ * // { following: true, followersCount: 11 }
+ * ```
  */
-declare class ItdPhoneVerificationError extends ItdApiError {
-  /** Ссылка на бота подтверждения, если удалось определить идентификатор пользователя. */
-  readonly verificationUrl: string | undefined;
-  constructor(init: ItdApiErrorInit & {
-    userId?: string | undefined;
-  });
-}
-/** `5xx` — ошибка на стороне сервера. */
-declare class ItdServerError extends ItdApiError {
-  constructor(init: ItdApiErrorInit);
-}
-/** Причина ошибки получения вложения. */
-declare const ItdFileErrorReason: Readonly<{
-  /** Сетевой сбой при получении источника. */
-  readonly Network: "network";
-  /** Источник ответил ошибочным HTTP-статусом. */
-  readonly Http: "http";
-  /** Источник превысил разрешённый размер. */
-  readonly TooLarge: "too_large";
-  /** Среда или источник не предоставили поток. */
-  readonly StreamUnavailable: "stream_unavailable";
-  /** Поток источника завершился ошибкой. */
-  readonly Read: "read";
-}>;
-type ItdFileErrorReason = (typeof ItdFileErrorReason)[keyof typeof ItdFileErrorReason];
-/** Не удалось получить или прочитать содержимое вложения. */
-declare class ItdFileError extends ItdError {
-  readonly reason: ItdFileErrorReason;
-  /** Адрес источника, если файл получался по сети. */
-  readonly url: string | undefined;
-  /** HTTP-статус источника. */
-  readonly status: number | undefined;
-  /** Разрешённый размер в байтах. */
-  readonly limit: number | undefined;
-  /** Обнаруженный размер в байтах. */
-  readonly actual: number | undefined;
-  /** Имеет ли смысл повторить получение источника. */
-  readonly retryable: boolean;
-  constructor(message: string, init: {
-    reason: ItdFileErrorReason;
-    url?: string | undefined;
-    status?: number | undefined;
-    limit?: number | undefined;
-    actual?: number | undefined;
-    retryable?: boolean | undefined;
-    cause?: unknown;
-  });
-}
-/** Запрос не дошёл до сервера: 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;
-  });
+interface FollowResult {
+  /** Подписка оформлена. У закрытого профиля отправляется заявка, и здесь будет `false`. */
+  following: boolean;
+  /** Сколько подписчиков стало у пользователя после действия. */
+  followersCount?: number;
+  /** Статус заявки, если профиль закрыт. */
+  status?: Loose<'following' | 'requested'>;
 }
-/** Запрос отменён через переданный `AbortSignal`. */
-declare class ItdAbortError extends ItdError {
-  constructor(message?: string, options?: {
-    cause?: unknown;
-  });
+/** Закреплённые значки профиля и выбранный из них. */
+interface PinsResult {
+  pins: Pin[];
+  /** Идентификатор активного значка — строка, а не объект. */
+  activePin: string | null;
 }
+//#endregion
+//#region src/models/notifications.d.ts
 /**
- * Операция невозможна в текущем состоянии объекта.
+ * Уведомление в единой форме.
  *
- * Например, клиент уже окончательно освобождён через `dispose()` и не может выполнять
- * новые запросы или создавать realtime-потоки.
+ * REST-список и SSE-поток отдают уведомления по-разному — разные имена типов, разные имена
+ * полей, один участник против массива. Библиотека приводит оба вида к этой структуре,
+ * поэтому объекты из `itd.notifications.list()` и из потока можно складывать в один список.
+ *
+ * Исходные данные не теряются: серверное имя типа остаётся в {@link rawType},
+ * а весь необработанный объект — в {@link raw}.
  */
-declare class ItdStateError extends ItdError {
-  constructor(message: string, options?: {
-    cause?: unknown;
-  });
+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;
 }
 /**
- * Некорректная конфигурация или аргументы — обнаружено до обращения к сети.
+ * Настройки уведомлений.
  *
- * Этим же классом сообщают о нарушенных инвариантах билдеры: например, опрос
- * с одним вариантом ответа.
+ * Сервер отдаёт плоский объект, но исторически знает два набора имён для одних и тех же
+ * настроек (`likes` и `reactions`, `comments` и `replies`). При сохранении библиотека
+ * отправляет оба, при чтении принимает любой.
  */
-declare class ItdConfigError extends ItdError {
-  constructor(message: string, options?: {
-    cause?: unknown;
-  });
+interface NotificationSettings {
+  /** Общий выключатель доставки. */
+  enabled: boolean;
+  /** Звук уведомления. */
+  sound: boolean;
+  /** Новые подписчики. */
+  follows: boolean;
+  /** Записи на вашей стене. */
+  wallPosts: boolean;
+  /** Реакции на ваши записи. */
+  likes: boolean;
+  /** Комментарии и ответы. */
+  comments: boolean;
+  /** Упоминания. */
+  mentions: boolean;
 }
-/** Любая ошибка, порождённая этой библиотекой. */
-declare function isItdError(value: unknown): value is ItdError;
-/** Ошибка, пришедшая от сервера итд.com (статус ≥ 400). */
-declare function isItdApiError(value: unknown): value is ItdApiError;
-/** Ошибка получения или чтения вложения. */
-declare function isItdFileError(value: unknown): value is ItdFileError;
-/** Операция невозможна в текущем состоянии объекта. */
-declare function isItdStateError(value: unknown): value is ItdStateError;
-/** Ошибка валидации: `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;
+//#endregion
+//#region src/notifications/normalize.d.ts
+/** Событие потока уведомлений после разбора. */
+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;
 //#endregion
 //#region src/notifications/text.d.ts
 /**
@@ -2079,5 +2117,5 @@ declare function isKnownNotificationType(type: string): boolean;
  */
 declare function resolveNotificationUrl(notification: Notification): string;
 //#endregion
-export { UserSummary as $, RateLimitPacing as $t, isItdFileError as A, Emitter as At, Notification as B, RateLimitOptions as Bt, ItdStateError as C, ReportReason as Ct, isItdAuthError as D, ViewReason as Dt, isItdApiError as E, SpanType as Et, isItdServerError as F, Logger as Ft, FollowResult as G, ResponseContext as Gt, Actor as H, RequestContext as Ht, isItdStateError as I, OperationRequestOptions as It, PinsResult as J, RetryOptions as Jt, MyProfile as K, RetryContext as Kt, isItdValidationError as L, PaginationOptions as Lt, isItdNotFoundError as M, Unsubscribe as Mt, isItdPhoneVerificationError as N, ClientHooks as Nt, isItdConflictError as O, ViewSource as Ot, isItdRateLimitError as P, ErrorContextHook as Pt, SubscriptionState as Q, ServiceDefinition as Qt, NotificationEvent as R, RateLimitBucketContext as Rt, ItdServerError as S, RealtimeStatus as St, ItdValidationError as T, ServiceState as Tt, AuthState as U, RequestExtensions as Ut, NotificationSettings as V, RawRequestOptions as Vt, Author as W, RequestOptions as Wt, Profile as X, QueryParams as Xt, PrivacySettings as Y, RuntimeOptions as Yt, PublicProfile as Z, QueryValue as Zt, ItdForbiddenError as _, InteractionType as _t, ItdAbortError as a, ItdOperationDefinition as an, DEFAULT_BASE_URL as at, ItdPhoneVerificationError as b, Loose as bt, ItdApiErrorKind as c, isBuiltInOperationId as cn, IsoDate as ct, ItdConflictError as d, operationRetrySafety as dn, UserRef as dt, RuntimeMode as en, AuthIdentity as et, ItdError as f, BUCKET_LIMITS as fn, AccessType as ft, ItdFileErrorReason as g, RetrySafety as gn, IncidentKind as gt, ItdFileError as h, OperationMethod as hn, FeedTab as ht, formatNotificationText as i, CustomOperationId as in, tokenProvider as it, isItdForbiddenError as j, Listener as jt, isItdError as k, WallAccess as kt, ItdAuthError as l, operationBucket as ln, Span as lt, ItdFieldErrors as m, RateLimitBucket as mn, CommentSort as mt, canonicalNotificationType as n, systemClock as nn, anonymousAuth as nt, ItdApiError as o, OPERATIONS as on, STATUS_SERVICE as ot, ItdErrorKind as p, DEFAULT_RATE_LIMIT_BUCKET as pn, AttachmentType as pt, Pin as q, RetryDecisionContext as qt, isKnownNotificationType as r, BuiltInOperationId as rn, bearerToken as rt, ItdApiErrorInit as s, OperationId as sn, LIBRARY_VERSION as st, resolveNotificationUrl as t, ItdClock as tn, AuthProvider as tt, ItdConfigError as u, operationMethod as un, UserId as ut, ItdNetworkError as v, ItdErrorCode as vt, ItdTimeoutError as w, ReportTargetType as wt, ItdRateLimitError as x, NotificationType as xt, ItdNotFoundError as y, LikesVisibility as yt, normalizeNotification as z, RateLimitBucketOverride as zt };
-//# sourceMappingURL=url-B6-bXHKt.d.ts.map
+export { isItdValidationError as $, RateLimitBucket as $t, ItdFieldErrors as A, ResponseContext as At, ItdTimeoutError as B, ItdClock as Bt, ItdApiErrorInit as C, RateLimitBucketContext as Ct, ItdConflictError as D, RequestContext as Dt, ItdConfigError as E, RawRequestOptions as Et, ItdNotFoundError as F, QueryParams as Ft, isItdError as G, OPERATIONS as Gt, isItdApiError as H, BuiltInOperationId as Ht, ItdPhoneVerificationError as I, QueryValue as It, isItdNotFoundError as J, operationBucket as Jt, isItdFileError as K, OperationId as Kt, ItdRateLimitError as L, ServiceDefinition as Lt, ItdFileErrorReason as M, RetryDecisionContext as Mt, ItdForbiddenError as N, RetryOptions as Nt, ItdError as O, RequestExtensions as Ot, ItdNetworkError as P, RuntimeOptions as Pt, isItdStateError as Q, DEFAULT_RATE_LIMIT_BUCKET as Qt, ItdServerError as R, RateLimitPacing as Rt, ItdApiError as S, PaginationOptions as St, ItdAuthError as T, RateLimitOptions as Tt, isItdAuthError as U, CustomOperationId as Ut, ItdValidationError as V, systemClock as Vt, isItdConflictError as W, ItdOperationDefinition as Wt, isItdRateLimitError as X, operationRetrySafety as Xt, isItdPhoneVerificationError as Y, operationMethod as Yt, isItdServerError as Z, BUCKET_LIMITS as Zt, Profile as _, ServiceState as _n, RetrySafety as _t, NotificationEvent as a, AttachmentType as an, tokenProvider as at, UserSummary as b, ViewSource as bn, Logger as bt, NotificationSettings as c, FeedTab as cn, Unsubscribe as ct, Author as d, ItdErrorCode as dn, LIBRARY_VERSION as dt, IsoDate as en, ClientConnection as et, FollowResult as f, LikesVisibility as fn, FeatureOperationId as ft, PrivacySettings as g, ReportTargetType as gn, OperationMethod as gt, PinsResult as h, ReportReason as hn, OperationMetadata as ht, formatNotificationText as i, AccessType as in, bearerToken as it, ItdFileError as j, RetryContext as jt, ItdErrorKind as k, RequestOptions as kt, Actor as l, IncidentKind as ln, DEFAULT_BASE_URL as lt, Pin as m, NotificationType as mn, OperationContract as mt, canonicalNotificationType as n, UserId as nn, AuthProvider as nt, normalizeNotification as o, CommentSort as on, Emitter as ot, MyProfile as p, Loose as pn, OperationAnnotations as pt, isItdForbiddenError as q, isBuiltInOperationId as qt, isKnownNotificationType as r, UserRef as rn, anonymousAuth as rt, Notification as s, EventChannelStatus as sn, Listener as st, resolveNotificationUrl as t, Span as tn, AuthIdentity as tt, AuthState as u, InteractionType as un, STATUS_SERVICE as ut, PublicProfile as v, SpanType as vn, ClientHooks as vt, ItdApiErrorKind as w, RateLimitBucketOverride as wt, ItdAbortError as x, WallAccess as xn, OperationRequestOptions as xt, SubscriptionState as y, ViewReason as yn, ErrorContextHook as yt, ItdStateError as z, RuntimeMode as zt };
+//# sourceMappingURL=url-Be9jlWRv.d.cts.map